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

圖:本站根據 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 管理員或開發者先在雲端完成兩步操作:
- 創建支持 Anthropic 模型的 Foundry 資源:打開 Azure 門戶或 Microsoft Foundry 門戶(原 Azure AI Foundry),在支持 Claude 模型的受支持區域創建資源,記下頁面的 資源名稱(Resource name)。
- 部署主模型與輕量模型:在模型目錄(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)獲取令牌:
- 在本機安裝 Azure CLI 並登入企業帳號:
bash
az login
- 在
~/.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"
}
}
- 啟動
claude並在會話內輸入/status,看到 API provider 顯示為 Microsoft Foundry 即代表鏈路正常;需要切換已綁定的部署型號時用/model即可(詳見 Claude Code 切換模型)。
若你是個人開發者,沒有企業 Azure 訂閱或相關區域未開放 Anthropic 模型配額,直接開通官方個人訂閱更省事,可查看本站 Claude Code 充值方案 或 Claude Pro 訂閱。
三、常見報錯與避坑排查

圖:本站根據 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 settings.json 配置詳解:文件位置、優先級與常用示例
- Claude Code 切換模型:/model 命令、模型別名、effort 與 fast 模式
- Claude Code 不登入直接用 API Key:憑據優先級與配置說明
參考資料
- 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
0 條評論
還沒有評論,來搶沙發~