SpyBara
Go Premium

microsoft-foundry.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

3 added, 3 removed.

2026
Fri 7 15:00 Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

Claude Code на Microsoft Foundry

Узнайте о настройке Claude Code через Microsoft Foundry, включая установку, конфигурацию и устранение неполадок.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

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

Перед настройкой Claude Code с Microsoft Foundry убедитесь, что у вас есть:

Установка

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

Сначала создайте ресурс Claude в Azure:

  1. Перейдите на портал Microsoft Foundry
  2. Создайте новый ресурс, отметив имя вашего ресурса
  3. Создайте развертывания для моделей Claude, отметив имя развертывания, которое вы даете каждому; вы установите эти имена как переменные модели на шаге 4:
    • 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. Установите переменную окружения, заменив your-azure-api-key на скопированный ключ:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Вариант B: Аутентификация Microsoft Entra ID

Когда ни ANTHROPIC_FOUNDRY_API_KEY, ни ANTHROPIC_FOUNDRY_AUTH_TOKEN не установлены, Claude Code автоматически использует Azure SDK цепочку учетных данных по умолчанию. Это поддерживает различные методы аутентификации локальных и удаленных рабочих нагрузок.

В локальных средах вы обычно можете использовать Azure CLI:

az login

Вариант C: Аутентификация с использованием токена Bearer

Claude Code отправляет значение ANTHROPIC_FOUNDRY_AUTH_TOKEN в каждом запросе в качестве заголовка Authorization: Bearer. Используйте этот вариант, когда другой процесс, такой как хост-приложение или скрипт входа, уже получил для вас токен доступа. Требуется Claude Code версии 2.1.203 или позже.

Установите переменную на токен Bearer, выданный Microsoft Entra ID для вашего ресурса:

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

ANTHROPIC_FOUNDRY_AUTH_TOKEN имеет приоритет над ANTHROPIC_FOUNDRY_API_KEY и над цепочкой учетных данных по умолчанию.

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

Установите следующие переменные окружения для включения интеграции Microsoft Foundry:

# 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

Установите переменные модели в соответствии с именами развертываний, которые вы создали на шаге 1.

Без ANTHROPIC_DEFAULT_OPUS_MODEL псевдоним opus на Microsoft Foundry разрешается в Opus 4.6. Установите его на идентификатор Opus 4.8, чтобы использовать последнюю модель:

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. На Microsoft Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите ANTHROPIC_DEFAULT_HAIKU_MODEL на развертывание Haiku, доступное в вашей учетной записи, как показано выше.

Для получения текущих и устаревших идентификаторов моделей см. Обзор моделей. Полный список переменных окружения см. в разделе Конфигурация модели.

Prompt caching включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу:

export ENABLE_PROMPT_CACHING_1H=1

5. Запуск Claude Code

С установленными переменными окружения запустите Claude Code из каталога вашего проекта:

claude

Claude Code читает CLAUDE_CODE_USE_FOUNDRY и другие переменные Microsoft Foundry из окружения и подключается к вашему ресурсу Azure при первом запросе. В отличие от Amazon Bedrock и Google Cloud's Agent Platform, Microsoft Foundry не имеет интерактивного мастера установки, поэтому переменные окружения на шагах 3 и 4 являются единственным путем конфигурации.

Чтобы проверить вашу установку, запустите /status внутри Claude Code. Строка поставщика API показывает Microsoft Foundry вместе с именем ресурса или базовым URL-адресом, который вы настроили.

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

Если запросы завершаются с ошибками повторного подключения на первом запросе:

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