在使用 Microsoft Foundry 配置 Claude Code 之前,请确保您拥有:
可访问 Microsoft Foundry 的 Azure 订阅 创建 Microsoft Foundry 资源和部署的 RBAC 权限 安装并配置 Azure CLI(可选 - 仅当您没有其他获取凭据的机制时才需要)
首先,在 Azure 中创建 Claude 资源:
Claude Code 支持 Microsoft Foundry 的两种身份验证方法。选择最适合您的安全要求的方法。选项 A:API 密钥身份验证
导出 ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
选项 B:Microsoft Entra ID 身份验证当未设置“ANTHROPIC_FOUNDRY_API_KEY”时,Claude Code 会自动使用 Azure SDK 默认凭据链。这支持多种对本地和远程工作负载进行身份验证的方法。在本地环境中,您通常可以使用 Azure CLI:
设置以下环境变量以启用 Microsoft Foundry:
导出 CLAUDE_CODE_USE_FOUNDRY=1
导出 ANTHROPIC_FOUNDRY_RESOURCE={资源}
设置模型变量以匹配您在步骤 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 AI 用户”和“认知服务用户”默认角色包括调用 Claude 模型所需的所有权限。要获得更多限制性权限,请使用以下内容创建自定义角色:
“权限”:[ “数据操作”:[ “Microsoft.CognitiveServices/帐户/提供商/*”
有关详细信息,请参阅 Microsoft Foundry RBAC 文档。
如果收到错误“无法从 azureADTokenProvider 获取令牌:ChainedTokenCredential 身份验证失败”:
在环境中配置Entra ID,或设置ANTHROPIC_FOUNDRY_API_KEY。
Microsoft Foundry 文档 Microsoft Foundry 模型 Microsoft Foundry 定价