English ← MyDocs

文档索引

获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

Microsoft Foundry 上的 Claude Code

了解如何通过 Microsoft Foundry 配置 Claude Code，包括设置、配置和故障排除。

<ContactSalesCard surface="foundry">

前提条件

在使用 Microsoft Foundry 配置 Claude Code 之前，请确保您拥有：

  • 具有 Microsoft Foundry 访问权限的 Azure 订阅
  • 创建 Microsoft Foundry 资源和部署的 RBAC 权限
  • 已安装并配置 Azure CLI（可选 - 仅在没有其他获取凭据的机制时需要）
Note

如果您要为多个用户部署 Claude Code，请固定您的模型版本以防止 Anthropic 发布新模型时出现问题。

设置

1. 配置 Microsoft Foundry 资源

首先，在 Azure 中创建 Claude 资源：

  1. 导航到 Microsoft Foundry 门户
  2. 创建新资源，记下您的资源名称
  3. 为 Claude 模型创建部署：
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

2. 配置 Azure 凭据

Claude Code 支持两种 Microsoft Foundry 身份验证方法。选择最适合您安全要求的方法。

选项 A：API 密钥身份验证

  1. 在 Microsoft Foundry 门户中导航到您的资源
  2. 前往 Endpoints and keys 部分
  3. 复制 API Key
  4. 设置环境变量：
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

选项 B：Microsoft Entra ID 身份验证

当未设置 ANTHROPIC_FOUNDRY_API_KEY 时，Claude Code 自动使用 Azure SDK 默认凭据链。 这支持各种本地和远程工作负载的身份验证方法。

在本地环境中，您通常可以使用 Azure CLI：

az login
Note

使用 Microsoft Foundry 时，/logout 命令不可用，因为身份验证通过 Azure 凭据处理。

3. 配置 Claude Code

设置以下环境变量以启用 Microsoft Foundry：

# 启用 Microsoft Foundry 集成
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure 资源名称（将 {resource} 替换为您的资源名称）
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# 或提供完整的基础 URL：
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. 固定模型版本

Warning

为每个部署固定特定的模型版本。如果您使用模型别名（sonnet、opus、haiku）而不进行固定，Claude Code 可能会尝试使用您的 Foundry 账户中不可用的较新模型版本，在 Anthropic 发布更新时导致现有用户出现问题。创建 Azure 部署时，请选择特定的模型版本，而不是"auto-update to latest"。

设置模型变量以匹配您在步骤 1 中创建的部署名称。

如果不设置 ANTHROPIC_DEFAULT_OPUS_MODEL，Foundry 上的 opus 别名将解析为 Opus 4.6。将其设置为 Opus 4.7 ID 以使用最新模型：

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

会话标题生成等后台任务使用小型/快速模型，通常是 Haiku 级模型。在 Foundry 上，Claude Code 默认将其设为主模型，因为不是每个账户都有 Haiku 部署。要将 Haiku 用于后台任务，请将 ANTHROPIC_DEFAULT_HAIKU_MODEL 设置为您账户中可用的 Haiku 部署，如上所示。

有关当前和旧版模型 ID，请参阅模型概述。有关完整的环境变量列表，请参阅模型配置。

提示缓存自动启用。要请求 1 小时缓存 TTL 而不是默认的 5 分钟，请设置以下变量；1 小时 TTL 的缓存写入按更高费率计费：

export ENABLE_PROMPT_CACHING_1H=1

5. 运行 Claude Code

设置环境变量后，从项目目录启动 Claude Code：

claude

Claude Code 从环境中读取 CLAUDE_CODE_USE_FOUNDRY 和其他 Foundry 变量，并在第一个提示时连接到您的 Azure 资源。与 Bedrock 和 Vertex AI 不同，Foundry 没有交互式设置向导，因此步骤 3 和 4 中的环境变量是唯一的配置路径。

Azure RBAC 配置

Azure AI User 和 Cognitive Services User 默认角色包含调用 Claude 模型所需的所有权限。

对于更严格的权限，请创建包含以下内容的自定义角色：

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

详情请参阅 Microsoft Foundry RBAC 文档。

故障排除

如果您收到错误"Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed"：

  • 在环境中配置 Entra ID，或设置 ANTHROPIC_FOUNDRY_API_KEY。

其他资源