是什么
Microsoft Foundry（Azure AI Foundry）是 Claude Code 的云提供商认证选项，通过 Azure 凭证访问 Claude 模型，继承 Azure 合规控制和计费体系。适合已有 Azure 基础设施的企业。
核心机制
前置条件
- Azure 订阅，开启 Microsoft Foundry 访问
- RBAC 权限（创建 Foundry 资源和部署）
- 可选：Azure CLI
配置步骤
- 在 Azure AI Foundry 门户（ai.azure.com）创建资源，记录资源名
- 为 Claude Opus、Sonnet、Haiku 分别创建部署，选择具体版本（不要选”auto-update”）
- 配置认证和环境变量
认证方式
# 方式 A：API key
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
# 方式 B：Microsoft Entra ID（未设置 API key 时自动使用）
az login # 本地环境
# 远程/CI 环境使用 Azure SDK 默认凭证链环境变量配置
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# 或使用完整 URL：
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
# 固定模型版本（必须与 Foundry 中的部署名匹配）
export ANTHROPIC_DEFAULT_SONNET_MODEL=your-sonnet-deployment-name
export ANTHROPIC_DEFAULT_OPUS_MODEL=your-opus-deployment-name关键细节
- 使用 Foundry 时
/login和/logout命令被禁用，认证通过 Azure 凭证处理 - 必须固定模型版本：如果使用 alias（sonnet/opus/haiku）而不固定，Anthropic 发布新模型时会导致现有用户报错
- Foundry 不发送 metrics 到 Anthropic，成本追踪通过 Azure Cost Management 或 LiteLLM
- Foundry 不支持 server-managed settings，需使用 file-based 方式
与其他概念的关联
- authentication - 认证方式总览
- llm-gateway - 通过 gateway 统一管理 Foundry 访问
- costs - Foundry 的成本追踪方案
实践要点
- 创建 Azure 部署时选择具体模型版本，不要选”auto-update to latest”
- 部署名称需与
ANTHROPIC_DEFAULT_*_MODEL环境变量完全匹配 - Entra ID 认证适合企业 SSO 场景，API key 适合 CI/CD 自动化