Перед настройкой Claude Code с Microsoft Foundry убедитесь, что у вас есть:
* Подписка Azure с доступом к Microsoft Foundry
* Разрешения RBAC для создания ресурсов и развертываний Microsoft Foundry
* Azure CLI установлен и настроен (опционально - требуется только если у вас нет другого механизма для получения учетных данных)
Если вы развертываете Claude Code для нескольких пользователей, [закрепите версии вашей модели](#4-pin-model-versions) перед развертыванием.
Установка
1. Подготовка ресурса Microsoft Foundry
Сначала создайте ресурс Claude в Azure:
1. Перейдите на [портал Microsoft Foundry](https://ai.azure.com/)
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. Установите переменную окружения:
```bash theme={null}
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
```
**Вариант B: Аутентификация Microsoft Entra ID**
Когда `ANTHROPIC_FOUNDRY_API_KEY` не установлен, Claude Code автоматически использует Azure SDK [цепочку учетных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).
Это поддерживает различные методы аутентификации локальных и удаленных рабочих нагрузок.
В локальных средах вы обычно можете использовать Azure CLI:
```bash theme={null}
az login
```
При использовании Microsoft Foundry команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Azure.
3. Настройка Claude Code
Установите следующие переменные окружения для включения интеграции Microsoft Foundry:
```bash theme={null}
# 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. Pin model versions
Закрепите конкретные версии моделей для каждого развертывания. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в встроенное значение Claude Code по умолчанию для Foundry, которое может отставать от последнего выпуска и может быть недоступно в вашей учетной записи. Foundry не имеет проверки модели при запуске, поэтому запросы завершаются ошибкой, когда значение по умолчанию недоступно. При создании развертываний Azure выберите конкретную версию модели вместо "автоматического обновления до последней версии".
Установите переменные модели в соответствии с именами развертываний, которые вы создали на шаге 1.
Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Foundry разрешается в Opus 4.6. Установите его на идентификатор Opus 4.8, чтобы использовать последнюю модель:
```bash theme={null}
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'
```
Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на развертывание Haiku, доступное в вашей учетной записи, как показано выше.
Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments).
[Prompt caching](/ru/prompt-caching) включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу:
```bash theme={null}
export ENABLE_PROMPT_CACHING_1H=1
```
5. Запуск Claude Code
С установленными переменными окружения запустите Claude Code из каталога вашего проекта:
```bash theme={null}
claude
```
Claude Code читает `CLAUDE_CODE_USE_FOUNDRY` и другие переменные Foundry из окружения и подключается к вашему ресурсу Azure при первом запросе. В отличие от Bedrock и Vertex AI, Foundry не имеет интерактивного мастера установки, поэтому переменные окружения на шагах 3 и 4 являются единственным путем конфигурации.
Конфигурация Azure RBAC
Роли по умолчанию `Azure AI User` и `Cognitive Services User` включают все необходимые разрешения для вызова моделей Claude.
Для более ограничительных разрешений создайте пользовательскую роль со следующим содержимым:
```json theme={null}
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}
```
Для получения дополнительной информации см. [документацию Microsoft Foundry RBAC](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).
Устранение неполадок
Если вы получаете ошибку "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":
* Настройте Entra ID в среде или установите `ANTHROPIC_FOUNDRY_API_KEY`.
Дополнительные ресурсы
* [Документация Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)
* [Модели Microsoft Foundry](https://ai.azure.com/explore/models)
* [Цены Microsoft Foundry](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)