Claude Code поддерживает два метода аутентификации для Microsoft Foundry. Выберите метод, который лучше всего соответствует вашим требованиям безопасности.
Вариант A: Аутентификация по ключу API
Перейдите к вашему ресурсу на портале Microsoft Foundry
Когда ANTHROPIC_FOUNDRY_API_KEY не установлен, Claude Code автоматически использует Azure SDK цепочку учетных данных по умолчанию.
Это поддерживает различные методы аутентификации локальных и удаленных рабочих нагрузок.
В локальных средах вы обычно можете использовать Azure CLI:
az login
3. Настройка Claude Code
Установите следующие переменные окружения для включения интеграции Microsoft Foundry:
# Enable Microsoft Foundry integrationexport 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
Установите переменные модели в соответствии с именами развертываний, которые вы создали на шаге 1.
Без ANTHROPIC_DEFAULT_OPUS_MODEL псевдоним opus на Foundry разрешается в Opus 4.6. Установите его на идентификатор Opus 4.7, чтобы использовать последнюю модель:
Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите ANTHROPIC_DEFAULT_HAIKU_MODEL на развертывание Haiku, доступное в вашей учетной записи, как показано выше.
Для получения текущих и устаревших идентификаторов моделей см. Обзор моделей. Полный список переменных окружения см. в разделе Конфигурация модели.
Prompt caching включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу:
export ENABLE_PROMPT_CACHING_1H=1
Конфигурация Azure RBAC
Роли по умолчанию Azure AI User и Cognitive Services User включают все необходимые разрешения для вызова моделей Claude.
Для более ограничительных разрешений создайте пользовательскую роль со следующим содержимым:
166Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на развертывание Haiku, доступное в вашей учетной записи, как показано выше.
167
166Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments).168Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments).
167169
168[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу:170[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу: