Claude Code 接入 Microsoft Foundry(Azure Anthropic)怎麼配:環境變量、認證方式與常見報錯

想用企業 Azure 額度跑 Claude Code?本文按官方文檔講清 Microsoft Foundry 接入步驟:CLAUDE_CODE_USE_FOUNDRY 環境變量、API Key 與 Entra ID 認證、部署名映射及 404/403 排查。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 其他 帳號

結論先說

  1. Microsoft Foundry 沒有交互式嚮導:與 Bedrock 和 Vertex AI 不同,接入微軟雲必須手動在 Shell 或 settings.json 的 env 裏配置環境變量。
  2. 端點配置二選一,不能同時設:標準場景填資源名 ANTHROPIC_FOUNDRY_RESOURCE;走自定義域名或企業網關時才改填完整地址 ANTHROPIC_FOUNDRY_BASE_URL。
  3. 支持兩種官方認證:個人或測試環境直接設 ANTHROPIC_FOUNDRY_API_KEY;企業內控環境不設密鑰變量,改用 az login 走 Microsoft Entra ID(原 Azure AD)身份認證。
  4. 務必對齊門戶裏的模型部署名:用 ANTHROPIC_DEFAULT_SONNET_MODEL 等變量綁定你在 Foundry 門戶實際創建的部署名稱,否則預設型號名對不上會報 404。
  5. Claude Code 訂閱與高配額開通入口:國內無境外卡可通過本站 iOS 免上號自助卡密開通 Claude Pro 會員 或 5 倍以上額度的 Claude Max 會員,完整檔位選型見 Claude Code 訂閱說明頁。

Foundry 兩種官方認證方式對比

圖:本站根據 Claude Code 官方文檔:Claude Code on Microsoft Foundry 整理的示意圖

本文根據 Claude Code 官方文檔《Claude Code on Microsoft Foundry》《Enterprise deployment overview》《Model configuration》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 或微軟官方網站。

適用於誰

  • 搜「claude code microsoft foundry」「claude code 配置 azure」,所在公司採購了微軟雲額度,想讓 Claude Code 走 Azure 帳單結算的研發人員;
  • 照着 Bedrock 或 Vertex 經驗找配置嚮導沒找到,不知道該填哪些環境變量的人;
  • 配置後遇到 URL 拼接報錯、404 DeploymentNotFound 或 az login 權限被拒的人。

如果你還在對比 AWS、GCP、Azure 三種企業雲接入方案的差異,可先看 Claude Code 可以使用其他模型嗎。

一、前置準備:在 Microsoft Foundry 創建資源與部署模型

在修改本地終端配置前,需要有權限的 Azure 管理員或開發者先在雲端完成兩步操作:

  1. 創建支持 Anthropic 模型的 Foundry 資源:打開 Azure 門戶或 Microsoft Foundry 門戶(原 Azure AI Foundry),在支持 Claude 模型的受支持區域創建資源,記下頁面的 資源名稱(Resource name)。
  2. 部署主模型與輕量模型:在模型目錄(Model catalog)中搜索 Anthropic Claude,分別創建你日常編碼用的主模型部署(如 Sonnet 或 Opus)以及供後台輕量任務使用的 Haiku 部署,並記下每個部署對應的 部署名稱(Deployment name)。

若團隊打算禁用靜態密鑰、統一使用員工域帳號登入,管理員還需在目標 Foundry 資源的 訪問控制(IAM) 頁面,為對應研發人員或安全組分配 Azure AI User(部分新門戶顯示為 Foundry User)或 Cognitive Services User 角色。

二、配置環境變量與選擇認證方式

你可以把變量寫進終端配置文件,但更推薦寫入 ~/.claude/settings.json 的 env 字段統一管理(文件位置與優先級見 Claude Code settings.json 配置詳解)。

方案 A:使用 Foundry API Key 認證(適合快速打通)

在 Foundry 門戶複製項目的 API Key 後(與官方 Console 密鑰的區別見 Claude Code 不登入直接用 API Key),按如下結構寫入 ~/.claude/settings.json:

json
{
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_RESOURCE": "my-company-foundry",
    "ANTHROPIC_FOUNDRY_API_KEY": "你的Foundry項目密鑰",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

注意 ANTHROPIC_FOUNDRY_RESOURCE 只需填寫純資源名稱(例如 my-company-foundry),Claude Code 會自動將請求拼裝為 https://my-company-foundry.services.ai.azure.com/anthropic。如果你的企業通過內聯網關暴露自定義地址,則刪掉 ANTHROPIC_FOUNDRY_RESOURCE,改設:

bash
export ANTHROPIC_FOUNDRY_BASE_URL="https://my-company-foundry.services.ai.azure.com/anthropic"

方案 B:使用 Microsoft Entra ID 認證(適合企業零靜態密鑰)

當環境中未設定 ANTHROPIC_FOUNDRY_API_KEY 時,Claude Code 會自動調用 Azure 預設憑據鏈(DefaultAzureCredential)獲取令牌:

  1. 在本機安裝 Azure CLI 並登入企業帳號:
bash
az login
  1. 在 ~/.claude/settings.json 裏只保留開關、資源名和模型映射,不寫 API Key:
json
{
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_RESOURCE": "my-company-foundry",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}
  1. 啟動 claude 並在會話內輸入 /status,看到 API provider 顯示為 Microsoft Foundry 即代表鏈路正常;需要切換已綁定的部署型號時用 /model 即可(詳見 Claude Code 切換模型)。

若你是個人開發者,沒有企業 Azure 訂閱或相關區域未開放 Anthropic 模型配額,直接開通官方個人訂閱更省事,可查看本站 Claude Code 充值方案 或 Claude Pro 訂閱。

三、常見報錯與避坑排查

Foundry 接入常見報錯排查對照

圖:本站根據 Claude Code 官方文檔:Claude Code on Microsoft Foundry 整理的示意圖

  • 同時設了 RESOURCE 和 BASE_URL 導致報錯:官方文檔明確這兩個端點變量互斥,保留其中一個並徹底清除另一個即可。
  • 把完整 https://... 填進了 ANTHROPIC_FOUNDRY_RESOURCE:這會導致域名被重複拼接從而無法解析,填整串地址請改用 ANTHROPIC_FOUNDRY_BASE_URL。
  • 主對話能聊,但一跑工具或標題總結就報 404 DeploymentNotFound:這是因為 Claude Code 後台輕量請求預設調用 Haiku,如果門戶裏只部署了 Sonnet 沒部署 Haiku,或者部署時起了自定義名字(如 corp-sonnet-prod),必須把 ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 都顯式指向已存在的部署名。
  • Entra ID 登入用着用着報 401 鑑權失敗:本地 Azure CLI 刷新的訪問令牌已過期,退出會話重跑一次 az login 即可恢復。
  • 報 429 速率受限或請求超時:檢查 Foundry 門戶裏對應模型部署的每分鐘 Token 配額(TPM)是否設得過低,多子代理並發場景建議適當調高部署配額。

常見問題

問:在 Azure 虛擬機或容器裏跑自動化任務,不想手動敲 az login 怎麼辦?

答:由於 Entra ID 模式底層走標準 Azure 預設憑據鏈,給目標 Azure VM 或容器實例開啟託管標識(Managed Identity)並授予 Foundry 資源的 Azure AI User 角色,不設 API Key 即可免密直連。

問:Microsoft Foundry 模式支持 /logout 退出帳號嗎?

答:不支持。雲平台模式下身份由環境變量密鑰或 Azure CLI 管理;想切回個人 Claude 訂閱,需刪掉 CLAUDE_CODE_USE_FOUNDRY=1 相關配置後重開終端運行 claude。

問:Windows 電腦走 Microsoft Foundry 時能用 PowerShell 工具嗎?

答:官方文檔說明,通過三大雲平台接入時 Windows 原生 PowerShell 工具預設關閉;如項目腳本依賴 PowerShell,可在 env 中補充 "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"。

問:國內沒有海外銀行卡,怎麼給 Claude Code 開通 Pro 或 Max 訂閱?

答:可在 Claude Code 訂閱頁 選擇走 iOS 訂閱鏈路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付寶、微信支付與 AlipayHK,無需交出帳號密碼;若帳號彈出身份核驗也可查看 Claude KYC 認證人工協助(失敗不收費,封號不在質保範圍)。

相關教學

參考資料

  • Claude Code 官方文檔:Claude Code on Microsoft Foundry — https://code.claude.com/docs/en/microsoft-foundry
  • Claude Code 官方文檔:Enterprise deployment overview — https://code.claude.com/docs/en/third-party-integrations
  • Claude Code 官方文檔:Model configuration — https://code.claude.com/docs/en/model-config

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~