Claude Code на Microsoft Foundry

​

Предварительные требования

• Подписка Azure с доступом к Microsoft Foundry
• Разрешения RBAC для создания ресурсов и развертываний Microsoft Foundry
• Azure CLI установлен и настроен (опционально - требуется только если у вас нет другого механизма для получения учетных данных)

​

Установка

​

1. Подготовка ресурса Microsoft Foundry

1. Перейдите на портал Microsoft Foundry
2. Создайте новый ресурс, отметив имя вашего ресурса
3. Создайте развёртывания для моделей Claude, отметив имя развёртывания, которое вы даёте каждому; вы установите эти имена как переменные модели на шаге 4:
   • Claude Opus
   • Claude Sonnet
   • Claude Haiku
   При настройке развёртывания вы также выбираете его вариант размещения, который определяет, выполняется ли вывод на Azure или на инфраструктуре Anthropic.

​

2. Настройка учётных данных Azure

• API-ключ: вы копируете ключ на портале Microsoft Foundry и устанавливаете его как ANTHROPIC_FOUNDRY_API_KEY
• Microsoft Entra ID: Claude Code получает токены через цепочку учётных данных по умолчанию Azure SDK, например из сессии az login, поэтому хранить API-ключ не нужно
• Bearer-токен: другой процесс получает токен доступа Microsoft Entra ID, и вы передаёте его в ANTHROPIC_FOUNDRY_AUTH_TOKEN

​

Использование API-ключа

1. Перейдите к вашему ресурсу на портале Microsoft Foundry
2. Откройте раздел Endpoints and keys
3. Скопируйте API Key
4. Установите переменную окружения, заменив your-azure-api-key на скопированный ключ:

export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

​

Использование Microsoft Entra ID

az login

​

Использование Bearer-токена

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

​

3. Настройка Claude Code

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

​

4. Закрепление версий моделей

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

export ENABLE_PROMPT_CACHING_1H=1

​

5. Запуск Claude Code

claude

​

Конфигурация Azure RBAC

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

​

Контекстное окно на 1M токенов

{
  "modelOverrides": {
    "claude-opus-4-8": "team-opus-prod"
  }
}

​

Устранение неполадок

• Настройте Entra ID в среде или установите ANTHROPIC_FOUNDRY_API_KEY.

• Проверьте, что ANTHROPIC_FOUNDRY_RESOURCE установлен на ваше фактическое имя ресурса, а не на заполнитель. Claude Code создает URL конечной точки из этого значения, поэтому неправильное имя указывает на хост, который не существует.

​

Дополнительные ресурсы

• Документация Microsoft Foundry
• Модели Microsoft Foundry
• Цены Microsoft Foundry