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 条评论

登录 后参与评论

还没有评论,来抢沙发~