Подключение Claude Code к шлюзу LLM

Направьте Claude Code на шлюз LLM вашей организации. Проверьте, уже ли администратор его настроил, или установите базовый URL и учетные данные самостоятельно, затем проверьте соединение и исправьте ошибки шлюза.

Шлюз LLM — это прокси, который ваша организация запускает между Claude Code и поставщиком модели. Когда ваша организация использует его, Claude Code аутентифицируется на шлюзе с учетными данными, которые выдает ваша организация, вместо вашего личного входа claude.ai.

Эта страница предназначена для разработчиков, запускающих Claude Code через шлюз, который управляет их организация. Она охватывает два пути: проверка того, уже ли администратор его настроил для вас, и самостоятельная настройка, если он этого не сделал.

[!NOTE]

• Чтобы развернуть шлюз для вашей организации, см. Развертывание шлюза LLM
• Для информации о том, что Claude Code отправляет на шлюз, см. справочник протокола шлюза

Проверка существующей конфигурации

Администраторы могут распространять адрес шлюза и учетные данные через управляемые параметры, управление устройствами или apiKeyHelper, чтобы Claude Code подхватил их при запуске без каких-либо действий с вашей стороны. Чтобы проверить, уже ли ваша организация это сделала:

1. Запустите Claude Code

Запустите claude. Если он открывается на экран входа вместо сеанса, учетные данные шлюза не были распространены; настройте его самостоятельно ниже.

2. Проверьте вкладку Status

Если Claude Code запустил сеанс без отображения экрана входа, запустите /status, откройте вкладку Status и проверьте две строки:

• Anthropic base URL: эта строка появляется только при установке адреса шлюза. Если ее нет, Claude Code не указан на шлюз; настройте его самостоятельно ниже.
• Auth token или API key: строка, называющая ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY или apiKeyHelper, подтверждает, что учетные данные шлюза активны. Строка Login method, называющая учетную запись claude.ai, означает, что учетные данные не были распространены; установите их самостоятельно.

3. Отправьте тестовое сообщение

Закройте меню /status и отправьте любой запрос в Claude Code. Обычный ответ от Claude без ошибок подтверждает, что соединение с шлюзом работает.

Если обе строки в меню /status выглядят правильно, но сообщение Claude не проходит, см. таблицу устранения неполадок.

Самостоятельная настройка Claude Code

Чтобы самостоятельно настроить Claude Code для шлюза, вам нужны от команды шлюза:

• Базовый URL шлюза
• Учетные данные: строка ключа или токена, или команда, которая их получает
  • Если команда шлюза не указала, какой тип учетных данных это, раздел переменная учетных данных ниже охватывает, что попробовать

Разделы ниже охватывают конфигурацию по порядку:

• Установка переменной учетных данных и установка базового URL: две переменные, которые нужны каждому соединению с шлюзом
• Проверка соединения: подтвердите, что оно работает, прежде чем что-либо сохранять
• Настройка каждой поверхности: если вы используете поверхность, отличную от CLI Claude Code, такую как VS Code, см., как настроить ее с учетными данными шлюза
• Дополнительная конфигурация: переменные, которые некоторым шлюзам нужны помимо базового URL и учетных данных, такие как пользовательский заголовок, помощник учетных данных, обнаружение модели, базовый URL в формате поставщика или отключение трафика вне пути шлюза. Устанавливайте их только если администратор их назвал или ваша сеть ограничивает исходящий трафик

Установка переменной учетных данных

Чтобы аутентифицировать Claude Code на шлюзе, установите ваши учетные данные в переменную окружения. Какая переменная зависит от того, что вам сказала команда шлюза:

Если вам не сказали, какой тип, используйте ANTHROPIC_AUTH_TOKEN; запрос проверки ниже показывает, как определить, нужно ли переключиться.

Установка базового URL и учетных данных

Установите базовый URL шлюза и переменную учетных данных, которую вы выбрали выше, как переменные окружения. Примеры используют ANTHROPIC_AUTH_TOKEN; замените его на ANTHROPIC_API_KEY, если это переменная, которую вы выбрали. Вы можете установить их в вашей оболочке, что длится один сеанс терминала, или в файле параметров Claude Code, что сохраняется везде, где работает Claude Code.

Для вашего первого соединения начните с экспорта оболочки и запустите запрос проверки перед перемещением значений в файл параметров.

Установка как переменные окружения оболочки

Замените значения на те, которые вам дала команда шлюза:

[tab] Bash или Zsh

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

[tab] PowerShell

$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"

Экспорты оболочки применяются только к этому сеансу терминала и программам, запущенным из него. Редактор, запущенный с док-станции или меню "Пуск", их не увидит. Чтобы они сохранялись в новых терминалах, добавьте те же строки в профиль вашей оболочки, такой как ~/.zshrc, ~/.bashrc или ваш PowerShell $PROFILE.

Если вы экспортируете шлюз только в вашей оболочке, он не надежно достигает фоновых агентов, размещенных супервизором; см. как каждый фоновый сеанс получает свой шлюз. Используйте файл параметров для любого шлюза, через который фоновые агенты должны всегда маршрутизироваться.

Установка в файле параметров

Чтобы конфигурация применялась везде, где работает Claude Code, включая фоновых агентов, установите переменные в блоке env файла параметров вместо того, чтобы полагаться на вашу оболочку. Файлы параметров имеют разные области:

• ~/.claude/settings.json применяется ко всем вашим проектам. На Windows путь — %USERPROFILE%\.claude\settings.json
• .claude/settings.local.json применяется к одному проекту. Claude Code добавляет его в ваш глобальный gitignore при сохранении параметра там; если вы создаете его вручную или позволяете Claude написать его, сначала добавьте его в gitignore самостоятельно, чтобы случайно не зафиксировать ваши учетные данные

[!WARNING]

Не помещайте учетные данные в .claude/settings.json проекта. Этот файл фиксируется и совместно используется со всеми, кто клонирует репозиторий.

Блок env выглядит одинаково в любом файле:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-gateway-key"
  }
}

Когда и экспорт оболочки, и блок env файла параметров устанавливают одну и ту же переменную, применяется значение файла параметров. Запустите /status, чтобы увидеть, какой базовый URL и источник учетных данных использует Claude Code.

Проверка соединения

С переменными, экспортированными в вашей оболочке, отправьте однотокенный запрос на шлюз напрямую. Это подтверждает, что URL и учетные данные работают, прежде чем вы откроете Claude Code, поэтому сбой указывает на шлюз, а не на вашу конфигурацию. Команды ниже читают переменные оболочки, поэтому им нужны экспорты оболочки даже если вы также поместили значения в файл параметров.

[tab] Bash или Zsh

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

[tab] PowerShell

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Если ваш шлюз ожидает ключи в заголовке x-api-key, замените заголовок Authorization на x-api-key: $ANTHROPIC_API_KEY в команде Bash или запись таблицы хеша "Authorization" на "x-api-key" = "$env:ANTHROPIC_API_KEY" в команде PowerShell.

Ответ JSON, начинающийся с {"id":"msg_ и включающий поле "content":[...], означает, что шлюз доступен и учетные данные работают. Ошибка, называющая неизвестную модель, все еще доказывает, что URL и учетные данные работают, так как шлюз аутентифицировал запрос перед отклонением имени модели; вам не нужно находить модель, которую обслуживает ваш шлюз, для этого теста. 401 означает, что учетные данные были отклонены: если вы угадали переменную, переключитесь на другую и переэкспортируйте.

Подтверждение в Claude Code

Запустите claude из той же оболочки, чтобы он унаследовал экспорты, отправьте сообщение и запустите /status.

На вкладке Status строка Anthropic base URL должна показывать адрес вашего шлюза, что подтверждает маршрутизацию запросов туда; если строки нет, переменная не достигла сеанса. Строка Auth token или API key, называющая переменную, которую вы установили, подтверждает, что учетные данные шлюза активны, а не сохраненный вход claude.ai.

Если сообщение не проходит или /status не показывает URL шлюза, см. таблицу устранения неполадок ниже.

Как переменная учетных данных отображается на заголовок

Каждая переменная отправляет учетные данные в другом HTTP-заголовке: ANTHROPIC_AUTH_TOKEN в Authorization: Bearer, ANTHROPIC_API_KEY в x-api-key и apiKeyHelper в обоих. Учетные данные в неправильной переменной достигают шлюза в заголовке, который он не читает, и запрос не проходит с 401. Если запрос проверки вернул 401, переключитесь на другую переменную и попробуйте снова.

Конфликты с существующим входом

Переменная учётных данных шлюза имеет приоритет над сохранённым входом claude.ai или ключом Console. С ANTHROPIC_AUTH_TOKEN переменная имеет приоритет немедленно. С ANTHROPIC_API_KEY вам один раз в интерактивном режиме предлагается одобрить ключ, прежде чем он вступит в силу.

Запустите /status, чтобы подтвердить, какой источник учетных данных активен. Если при запуске показывается предупреждение о конфликте аутентификации, называющее два источника, см. первую строку таблицы устранения неполадок, чтобы узнать, какой из них отбросить. Чтобы очистить сохраненный вход, чтобы остались только учетные данные шлюза, запустите /logout.

Настройка каждой поверхности

CLI читает переменные окружения и файлы параметров выше. Другие поверхности — это расширение VS Code, настольное приложение, GitHub Actions, Agent SDK и облачные поверхности, такие как Slack и веб; разделы ниже охватывают, достигают ли эти параметры каждую.

Расширение VS Code

Установите переменные шлюза для расширения VS Code в claudeCode.environmentVariables в собственных параметрах пользователя VS Code, открытых командой Preferences: Open User Settings (JSON). Расширение проверяет учетные данные из этого параметра перед запуском, поэтому это надежное место для учетных данных шлюза; значения в ~/.claude/settings.json достигают порожденного процесса, но не проверку входа самого расширения.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://llm-gateway.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-gateway-key" }
  ]
}

Настольное приложение

Настольное приложение читает маршрутизацию шлюза из конфигурации сторонних поставщиков, а не из ANTHROPIC_BASE_URL или settings.json. Эта конфигурация может поступить от вашей организации или из формы в самом приложении:

• Распределено администратором: если ваша организация развернула конфигурацию, настольное приложение маршрутизирует через шлюз без каких-либо действий с вашей стороны
• Настроено локально: для устройств без распределенной администратором конфигурации откройте Help → Troubleshooting → Включить режим разработчика, который перезагружает приложение с меню Developer. Затем откройте Developer → Configure Third-Party Inference и введите базовый URL вашего шлюза. Распределенная администратором конфигурация имеет приоритет и делает эту форму доступной только для чтения

При активной конфигурации шлюза средство выбора окружения не предлагает размещённые в облаке окружения Anthropic, и Remote Control недоступен.

Сессии SSH с конфигурацией шлюза находятся в бета-версии и требуют Claude Desktop v1.40609.0 или новее. Перед подключением проверьте список разрешённых хостов и адрес шлюза:

• Разрешённые хосты: сессии SSH по умолчанию отключены. Чтобы включить их, вы или ваш администратор указываете разрешённые хосты в ключе sshHostAllowlist конфигурации сторонних поставщиков
• Адрес шлюза: удалённый компьютер подключается к шлюзу самостоятельно, поэтому шлюз по адресу localhost на вашем компьютере не работает для сессий SSH

См. Удалённые сессии SSH в Claude Desktop со сторонними поставщиками. Вы также можете запустить CLI на удалённом хосте, установив там ANTHROPIC_BASE_URL и учётные данные шлюза.

Если настольное приложение показывает Gateway was unreachable, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью теста curl выше.

GitHub Actions

Claude Code GitHub Actions читает ANTHROPIC_BASE_URL и ANTHROPIC_CUSTOM_HEADERS из блока env рабочего процесса. Передайте учетные данные как вход anthropic_api_key действия; действие устанавливает его как ANTHROPIC_API_KEY, поэтому он достигает шлюза в заголовке x-api-key.

Для шлюза x-api-key установите базовый URL в env и передайте ключ шлюза как вход:

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

Для шлюза bearer-token передайте один и тот же секрет как вход anthropic_api_key и ANTHROPIC_AUTH_TOKEN в блоке env рабочего процесса. Действие требует anthropic_api_key, CLAUDE_CODE_OAUTH_TOKEN или федерацию рабочей нагрузки перед запуском Claude Code, и оно не читает ANTHROPIC_AUTH_TOKEN, поэтому вход удовлетворяет эту проверку запуска. Переменная окружения помещает ключ в заголовок Authorization, который читает шлюз; копия в x-api-key игнорируется:

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.GATEWAY_API_KEY }}

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

Для других вариантов аутентификации действия, включая CLAUDE_CODE_OAUTH_TOKEN и федерацию рабочей нагрузки, см. Claude Code GitHub Actions и README действия.

Agent SDK

Agent SDK не имеет опций, специфичных для шлюза; он передает переменные окружения процессу Claude Code, который он порождает. Каждый SDK принимает опцию env, которая устанавливает окружение порожденного процесса, и SDK TypeScript и Python обрабатывают это по-разному:

• TypeScript: порожденный процесс по умолчанию наследует родительское окружение, но установка options.env полностью заменяет окружение. Распределите process.env в него, чтобы сохранить переменные шлюза.
• Python: ClaudeAgentOptions(env=...) объединяется поверх унаследованного окружения, поэтому переменные шлюза, установленные в родительском процессе, проходят без распределения.

const result = query({
  prompt: "...",
  options: {
    env: {
      ...process.env,
      ANTHROPIC_BASE_URL: "https://llm-gateway.example.com",
      ANTHROPIC_AUTH_TOKEN: process.env.GATEWAY_KEY,
    },
  },
})

options = ClaudeAgentOptions(
    env={
        "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
        "ANTHROPIC_AUTH_TOKEN": os.environ["GATEWAY_KEY"],
    }
)

Slack, облачные сеансы и Remote Control

Claude Code в Slack и облачные сессии не являются частью развёртывания шлюза. Переменные шлюза, установленные в конфигурации окружения облачной сессии, не применяются. Если ваш трафик должен оставаться на шлюзе, не включайте эти интерфейсы для таких пользователей.

Remote Control и голосовая диктовка полагаются на идентичность claude.ai: Remote Control — для связи активной сессии с вашей учётной записью, а голосовая диктовка — для доступа к эндпоинту транскрипции claude.ai. Они недоступны, пока активны ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper. Remote Control также отключён, пока ANTHROPIC_BASE_URL указывает на хост, не принадлежащий Anthropic, поэтому входа с claude.ai самого по себе недостаточно.

Чтобы восстановить любую из этих функций, войдите с claude.ai и отмените установку переменных шлюза, которые проверяет эта функция. Раздел Remote Control в claude doctor называет то, что в настоящее время блокирует Remote Control.

• Голосовая диктовка: отмените установку учетных данных шлюза
• Remote Control: отмените установку учетных данных шлюза и ANTHROPIC_BASE_URL

Дополнительная конфигурация

Эти настройки охватывают случаи, выходящие за рамки базового URL и учётных данных. Задавайте их, только если этого требуют инструкции вашего администратора, правила исходящего трафика вашей сети или таблица устранения неполадок.

Отправка дополнительных заголовков

Некоторые шлюзы маршрутизируют или помечают запросы с помощью пользовательского заголовка в дополнение к учётным данным, например идентификатора арендатора или ключа маршрутизации. Чтобы отправить такой заголовок, задайте ANTHROPIC_CUSTOM_HEADERS, указав по одной паре Name: Value на строку. В примере ниже добавляется заголовок маршрутизации с именем X-Org-Route:

[tab] Bash or Zsh

export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"

[tab] PowerShell

$env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"

Вы также можете задать ANTHROPIC_CUSTOM_HEADERS в блоке env файла настроек. Используйте там \n между парами, поскольку строки JSON не могут занимать несколько строк:

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Org-Route: prod\nX-Tenant: example"
  }
}

Подобные имена заголовков маршрутизации и арендатора относятся к заголовкам, требующим подтверждения. Если заголовки берутся из файла настроек проекта, Claude Code применяет их согласно правилам применения значений env.

Добавление моделей шлюза в меню выбора модели

При включённом обнаружении моделей Claude Code при запуске запрашивает у шлюза список его моделей и добавляет эти имена в меню выбора /model наряду со встроенными вариантами. Если вы или ваш администратор задали replaceBuiltInOptions в наборе modelPicker, Claude Code скрывает и обнаруженные имена. При этом сохраняется строка для модели, которая уже используется в сессии.

Включите обнаружение, если ваш шлюз предоставляет имена моделей, которых нет во встроенном списке Claude Code, и вы хотите выбирать их в меню. Если вы используете встроенные модели, обнаружение вам не нужно; кроме того, ваш администратор мог уже включить его через управляемые настройки.

Чтобы включить его, задайте CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 в своей оболочке или в блоке env файла ~/.claude/settings.json.

Обнаруженные модели отображаются как дополнительные пункты /model. Для каждого пункта показывается описание, которое ваш шлюз предоставляет для модели, или From gateway, если шлюз его не предоставляет.

Чтобы убедиться, что обнаружение выполнилось, запустите claude --debug и найдите строки [gatewayDiscovery] в отладочном логе ~/.claude/debug/<session-id>.txt. При первом успешном обнаружении Claude Code записывает в лог, сколько моделей он кэшировал, и повторно делает запись только при изменении списка шлюза. Там же отображаются 404, таймаут или перенаправление. О том, когда выполняется обнаружение, что оно отфильтровывает и в каком формате шлюзы должны отдавать ответ, см. справочник по обнаружению моделей.

Ротация учётных данных с помощью apiKeyHelper

apiKeyHelper — это команда, которую Claude Code запускает для получения учётных данных шлюза вместо их чтения из статической переменной окружения.

Используйте вспомогательную команду, если срок действия учётных данных истекает по расписанию, они поступают из хранилища секретов или команды SSO либо если администратор велел вам её настроить. Если ваши учётные данные — это фиксированная строка, которую вы задаёте один раз, вам достаточно переменной учётных данных, и этот раздел можно пропустить.

Вспомогательная команда — это любая shell-команда, которая выводит текущие учётные данные в stdout. Claude Code запускает её через системную оболочку, поэтому в Windows это может быть исполняемый файл или вызов PowerShell. Команда должна выводить только учётные данные и ничего больше. В Claude Code v2.1.227 и более поздних версиях баннер или строка лога, выведенные вместе с ключом, приводят к сбою вспомогательной команды. Напишите скрипт, сделайте его исполняемым и укажите его в apiKeyHelper в вашем файле настроек:

[tab] Bash or Zsh

Например, скрипт, читающий из хранилища секретов:

#!/bin/bash
vault kv get -field=api_key secret/llm-gateway/claude-code

Укажите путь к нему в ~/.claude/settings.json:

{
  "apiKeyHelper": "~/bin/get-gateway-key.sh"
}

[tab] PowerShell

Например, скрипт, читающий из хранилища секретов:

vault kv get -field=api_key secret/llm-gateway/claude-code

Укажите вызов PowerShell в %USERPROFILE%\.claude\settings.json, экранировав обратные косые черты в строке JSON:

{
  "apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"
}

По умолчанию Claude Code кэширует вывод вспомогательной команды на пять минут и снова запускает её по истечении срока жизни кэша. Чтобы изменить срок жизни, задайте CLAUDE_CODE_API_KEY_HELPER_TTL_MS в миллисекундах, например CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000 для 15 минут.

Другие случаи, в которых Claude Code повторно запускает вспомогательную команду, описаны в разделе apiKeyHelper.

Значение вспомогательной команды отправляется в заголовках Authorization и x-api-key, поэтому оно работает независимо от того, какой заголовок читает ваш шлюз.

Отключение трафика вне шлюза

Шлюз передаёт запросы к модели, но Claude Code также отправляет необязательный фоновый трафик в обход шлюза — в Anthropic и сторонние сервисы, такие как GitHub: проверки версий, телеметрию, заметки о выпусках и аналогичные запросы. В сети, где исходящий трафик разрешён только к шлюзу, эти запросы завершаются неудачей и могут отображаться как заблокированные подключения в мониторинге исходящего трафика.

Чтобы отключить этот трафик, задайте CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 вместе с переменными шлюза — в тех же экспортах оболочки или в блоке env файла настроек:

[tab] Bash or Zsh

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

[tab] PowerShell

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

У этой переменной следующие эффекты и ограничения:

• Она отключает автообновления, поэтому предусмотрите другой способ обновления, например через менеджер пакетов или управляемое распространение.
• Она подавляет проверку доступности быстрого режима. Если при использовании Anthropic API команда /fast после этого сообщает, что быстрый режим недоступен, см. раздел использование быстрого режима за прокси и LLM-шлюзами, чтобы восстановить быстрый режим.
• Она не влияет на обнаружение моделей шлюза, которое обращается только к вашему шлюзу. До v2.1.257 эта переменная также останавливала обновление результатов обнаружения, поэтому в меню выбора оставался ранее кэшированный список.
• Проверка безопасности доменов инструмента WebFetch не затрагивается и по-прежнему обращается к api.anthropic.com. Отключите её отдельно с помощью skipWebFetchPreflight: true в настройках, если ваша сеть блокирует этот хост.
• Каждый поток телеметрии и управляющая им переменная описаны в разделе сервисы телеметрии.

Маршрутизация к облачному провайдеру через шлюз

Эти конфигурации направляют Claude Code на шлюз через специфичную для провайдера переменную базового URL вместо ANTHROPIC_BASE_URL. Шлюзы Amazon Bedrock и Google Cloud's Agent Platform принимают нативные форматы запросов этих провайдеров; шлюзы Microsoft Foundry и Claude Platform on AWS принимают формат Anthropic Messages. На маршрутах Amazon Bedrock и Google Cloud's Agent Platform Claude Code также ограничивает отправляемые бета-заголовки и поля запроса набором, который принимает данный провайдер. О том, что получает ваш шлюз на каждом маршруте, см. руководство по совместимости шлюзов.

Используйте их, только если команда, отвечающая за шлюз, явно назвала Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS. Если проверочный запрос выше вернул JSON, этот раздел можно пропустить.

Задайте блок для провайдера, названного командой, отвечающей за шлюз. Переменные пропуска аутентификации в блоках Amazon Bedrock, Google Cloud's Agent Platform и Claude Platform on AWS указывают Claude Code не подписывать запросы учётными данными облачного провайдера, поскольку они хранятся на шлюзе. Если шлюзу также нужен собственный токен, место, куда его указать, зависит от провайдера:

• Amazon Bedrock, Google Cloud's Agent Platform или Claude Platform on AWS: добавьте ANTHROPIC_AUTH_TOKEN после блока. Claude Code отправляет его на шлюз в заголовке Authorization: Bearer. Для учётных данных с другой схемой или в другом заголовке используйте вместо этого ANTHROPIC_CUSTOM_HEADERS. В любом случае оставьте переменную пропуска аутентификации заданной, поскольку без неё Claude Code удаляет любой заголовок Authorization, который добавили бы ANTHROPIC_AUTH_TOKEN, apiKeyHelper или ANTHROPIC_CUSTOM_HEADERS.
• Microsoft Foundry: используйте ANTHROPIC_FOUNDRY_API_KEY, как показано в его блоке

Amazon Bedrock

Не задавайте AWS_BEARER_TOKEN_BEDROCK, если шлюз выдаёт собственные учётные данные. Если вы её зададите, Claude Code отправит этот API-ключ Amazon Bedrock в заголовке Authorization вместо токена вашего шлюза, даже если задана CLAUDE_CODE_SKIP_BEDROCK_AUTH.

[tab] Bash or Zsh

export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

[tab] PowerShell

$env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"
$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"
$env:CLAUDE_CODE_USE_BEDROCK = "1"

Google Cloud's Agent Platform

Замените идентификатор проекта и регион своими значениями. Claude Code включает оба значения в путь каждого запроса, который отправляет на шлюз:

[tab] Bash or Zsh

export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

[tab] PowerShell

$env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"
$env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"
$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"
$env:CLAUDE_CODE_USE_VERTEX = "1"
$env:CLOUD_ML_REGION = "us-east5"

Этот блок охватывает маршрутизацию и аутентификацию. Переопределения регионов и закрепление моделей из настройки Agent Platform действуют и через шлюз:

• Регионы для отдельных моделей: если ваш шлюз обслуживает некоторые модели из региона, отличного от CLOUD_ML_REGION, задайте для каждой соответствующую переменную VERTEX_REGION_CLAUDE_*, например VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1. Точные имена приведены в справочнике по переменным окружения.
• Версии моделей: закрепите ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL, как описано в разделе Закрепление версий моделей. Задание ANTHROPIC_DEFAULT_HAIKU_MODEL также переводит на эту модель фоновые задачи, например генерацию названий сессий; в том же разделе объясняется, какая модель выполняет их в противном случае.
• Возможности моделей: если вы закрепляете идентификатор модели, который ваша версия Claude Code не распознаёт, такие функции, как уровни effort или расширенное мышление, могут остаться для неё отключёнными. Объявите, что поддерживает модель, с помощью ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES и её аналогов для Sonnet и Haiku.

Microsoft Foundry

Укажите учётные данные шлюза в ANTHROPIC_FOUNDRY_API_KEY; они отправляются на шлюз в заголовке x-api-key. Шлюзу, ожидающему Bearer-токен, можно вместо этого передать ANTHROPIC_FOUNDRY_AUTH_TOKEN. Claude Code отправляет это значение в заголовке Authorization: Bearer, и оно имеет приоритет над ANTHROPIC_FOUNDRY_API_KEY, если заданы обе переменные. Требуется Claude Code v2.1.203 или более поздней версии.

Для шлюза, который подставляет собственный заголовок Authorization, задайте CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1 и оставьте обе переменные учётных данных незаданными. Тогда Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок Authorization, который вы передаёте, например через ANTHROPIC_CUSTOM_HEADERS.

[tab] Bash or Zsh

export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry
export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key
export CLAUDE_CODE_USE_FOUNDRY=1

[tab] PowerShell

$env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"
$env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"
$env:CLAUDE_CODE_USE_FOUNDRY = "1"

Claude Platform on AWS

Об идентификаторе рабочего пространства см. Claude Platform on AWS.

[tab] Bash or Zsh

export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

[tab] PowerShell

$env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"
$env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"
$env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"
$env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"

Проверка маршрута провайдера

Запустите claude из оболочки, в которой вы задали блок, и выполните /status. С блоком Amazon Bedrock на вкладке Status отображаются строки такого вида:

API provider: Amazon Bedrock
Bedrock base URL: https://llm-gateway.example.com/bedrock
AWS auth skipped

Остальные блоки выводят такие же строки под названиями своих провайдеров, например Vertex base URL и GCP auth skipped для Google Cloud's Agent Platform; блок Microsoft Foundry показывает строку о пропуске аутентификации, только если вы задали CLAUDE_CODE_SKIP_FOUNDRY_AUTH. Если вы также выполняете маршрутизацию через корпоративный прокси, строка Proxy показывает URL прокси. Если строка базового URL отсутствует, переменная не попала в сессию.

Устранение неполадок с ошибками шлюза

Это наиболее распространенные ошибки при запуске Claude Code через шлюз, с причиной на стороне шлюза и исправлением:

Если Claude Code повторно просит вас войти после удаления конфигурации шлюза, причина обычно в хранилище учетных данных, а не в шлюзе; см. ошибки аутентификации.

Связанные ресурсы

• Обзор шлюзов LLM: что такое шлюз и как он взаимодействует с подписками claude.ai
• Развертывание шлюза LLM для вашей организации: контрольный список, обращенный к администратору, для развертывания и распределения конфигурации шлюза
• Справочник протокола шлюза: что Claude Code отправляет на шлюз, включая заголовки и поля, которые шлюз должен пересылать
• Параметры: где находятся файлы параметров и как читается блок env
• Аутентификация: как переменные учетных данных, apiKeyHelper и вход OAuth взаимодействуют