Claude Code on Microsoft Foundry
- 分组：一、官方文档
- 原始链接：https://code.claude.com/docs/en/azure-ai-foundry
- 抓取来源：http://code.claude.com/docs/en/azure-ai-foundry
- 原始文件：/Users/yuanruiqin/Desktop/知识库/ClaudeCode-系统化知识库/01-官方文档/20-claude-code-on-microsoft-foundry.md
- 精读版生成时间：2026-04-05 13:50:44
中文精读版（去噪）
在使用 Microsoft Foundry 配置 Claude Code 之前，请确保您拥有：
可访问 Microsoft Foundry 的 Azure 订阅 创建 Microsoft Foundry 资源和部署的 RBAC 权限 安装并配置 Azure CLI（可选 - 仅当您没有其他获取凭据的机制时才需要）
设置
1. 配置 Microsoft Foundry 资源
首先，在 Azure 中创建 Claude 资源：
- 创建一个新资源，记下您的资源名称
- 为 Claude 模型创建部署： 克劳德·奥普斯 克劳德十四行诗 *克劳德俳句
2.配置Azure凭据
Claude Code 支持 Microsoft Foundry 的两种身份验证方法。选择最适合您的安全要求的方法。选项 A：API 密钥身份验证
- 转到 端点和键 部分 3.复制API密钥 4.设置环境变量：
导出 ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
选项 B：Microsoft Entra ID 身份验证当未设置“ANTHROPIC_FOUNDRY_API_KEY”时，Claude Code 会自动使用 Azure SDK 默认凭据链。这支持多种对本地和远程工作负载进行身份验证的方法。在本地环境中，您通常可以使用 Azure CLI：
3.配置克劳德代码
设置以下环境变量以启用 Microsoft Foundry：
启用 Microsoft Foundry 集成
导出 CLAUDE_CODE_USE_FOUNDRY=1
Azure 资源名称（将 {resource} 替换为您的资源名称）
导出 ANTHROPIC_FOUNDRY_RESOURCE={资源}
或者提供完整的基本 URL：
导出ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
4. 引脚型号版本
设置模型变量以匹配您在步骤 1 中创建的部署名称：
导出 ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6' 导出 ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6' 导出 ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
有关当前和旧模型 ID，请参阅模型概述。有关环境变量的完整列表，请参阅模型配置。
Azure RBAC 配置
“Azure AI 用户”和“认知服务用户”默认角色包括调用 Claude 模型所需的所有权限。要获得更多限制性权限，请使用以下内容创建自定义角色：
“权限”：[ “数据操作”：[ “Microsoft.CognitiveServices/帐户/提供商/*”
有关详细信息，请参阅 Microsoft Foundry RBAC 文档。
故障排除
如果收到错误“无法从 azureADTokenProvider 获取令牌：ChainedTokenCredential 身份验证失败”：
在环境中配置Entra ID，或设置ANTHROPIC_FOUNDRY_API_KEY。
其他资源
Microsoft Foundry 文档 Microsoft Foundry 模型 Microsoft Foundry 定价