Перейти к основному содержанию

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

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

​
Установка

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

Сначала создайте ресурс Claude в Azure:
  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
При использовании Microsoft Foundry команды /login и /logout отключены, так как аутентификация обрабатывается через учетные данные Azure.

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

Установите следующие переменные окружения для включения интеграции Microsoft Foundry. Обратите внимание, что имена ваших развертываний устанавливаются как идентификаторы моделей в 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

# Set models to your resource's deployment names
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-1'
Для получения дополнительной информации о параметрах конфигурации модели см. Конфигурация модели.

​
Конфигурация 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.

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