Как подключить Claude Code к своему API

Для Claude Code нужен API, совместимый с Anthropic Messages и функциями агента. Возьмите адрес этого API из документации провайдера.

  1. Получите у провайдера адрес API, ID модели и API-ключ.
  2. Добавьте шаблон ниже в ~/.claude/settings.json. В Windows — %USERPROFILE%\.claude\settings.json. Если файл уже есть, объедините поля env с текущими настройками.
{
  "env": {
    "ANTHROPIC_BASE_URL": "API_BASE_URL",
    "ANTHROPIC_AUTH_TOKEN": "ваш-ключ",
    "ANTHROPIC_MODEL": "MODEL_ID"
  }
}

Если в инструкции провайдера ключ указан в ANTHROPIC_API_KEY, замените в шаблоне название ANTHROPIC_AUTH_TOKEN на ANTHROPIC_API_KEY. Оставьте только один из этих двух параметров.

  1. Замените API_BASE_URL адресом API, MODEL_ID точным ID модели, а ваш-ключ своим API-ключом. Сохраните файл, перезапустите Claude Code и проверьте подключение командой /status.

Если не работает

401, Invalid API key или Auth conflict

Проверьте ключ и требуемый шлюзом заголовок: ANTHROPIC_AUTH_TOKEN передаёт Bearer-токен, ANTHROPIC_API_KEY — ключ в x-api-key. Проверьте источник авторизации в /status и устраните конфликтующие настройки.

404 или Not Found на каждый запрос

Сверьте базовый адрес именно для Claude Code с документацией своего шлюза и проверьте совместимость с Anthropic Messages API. Не добавляйте суффикс наугад.

model not found для основной модели

Имя модели пишется так, как у провайдера: у одних с префиксом anthropic/, у других с дефисами вместо точек. Точный ID возьмите в каталоге или документации провайдера.

402 или insufficient balance

Закончился баланс у провайдера. Пополните его в личном кабинете провайдера.

429 или rate limit

Провайдер ограничил число запросов. Подождите минуту или запускайте меньше задач параллельно; у части провайдеров лимит растёт с суммой пополнений.

Агент не вызывает инструменты или падает на редактировании файлов

Модель или адрес провайдера не поддерживают вызов инструментов в формате Anthropic. Выберите модель с поддержкой инструментов в Anthropic-совместимом API.

Долгие задачи обрываются по таймауту

Увеличьте API_TIMEOUT_MS в том же блоке env, например 600000 (10 минут).

Ошибка про модель для фоновых задач (Haiku)

Для фоновых задач Claude Code берёт быструю модель. Задайте ANTHROPIC_DEFAULT_HAIKU_MODEL моделью, которая есть у провайдера.

Документация: настройка Claude Code. Проверено 14.11.2026.