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

​

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

​

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

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

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

​

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

​

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

​

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

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

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

​

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

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

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

​

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

curl -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": "."}]}'

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": "."}]}'

​

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

​

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

​

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

​

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

​

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

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

​

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

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

​

GitHub Actions

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

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_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 }}

​

Agent SDK

• 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

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

​

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

​

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

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

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

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

​

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

​

Ротация учетных данных с apiKeyHelper

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

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

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

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

​

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

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

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

​

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

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

​

Amazon Bedrock

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

$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

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

$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"

• Регионы для каждой модели: если ваш шлюз обслуживает некоторые модели из региона, отличного от 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 также перемещает фоновые задачи, такие как заголовки сеансов, на эту модель, и этот раздел объясняет, какая модель их запускает в противном случае.
• Возможности модели: если вы закрепляете ID модели, который ваша версия Claude Code не распознает, функции, такие как уровни усилий или расширенное мышление, могут оставаться отключенными на нем. Объявите, что поддерживает модель, с помощью ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES и его аналогов для Sonnet и Haiku.

​

Microsoft Foundry

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

$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 на AWS

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

$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"

​

Подтверждение маршрута поставщика

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

​

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

​

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

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