结论先说
- 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 条评论
还没有评论,来抢沙发~