Как подключить Claude Code к своему API
Для Claude Code нужен API, совместимый с Anthropic Messages и функциями агента. Возьмите адрес этого API из документации провайдера.
- Получите у провайдера адрес API, ID модели и API-ключ.
- Добавьте шаблон ниже в
~/.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. Оставьте только один из этих двух параметров.
- Замените
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.