К содержимому
Блог

Claude Code через Gateway: диагностика подключения

Claude Code через Gateway: диагностика подключения

Для диагностики Claude Code через Relay начните с адреса, способа авторизации и выбранной модели. Затем проверьте обычный запрос отдельно от фоновой работы и инструментов. Ошибка в одной из этих частей не требует смены всей конфигурации.

Проверьте адрес Messages

В ANTHROPIC_BASE_URL нужен https://relay-llm.ru, без /v1. Клиент обращается к маршруту Messages самостоятельно. OpenAI-совместимый адрес https://relay-llm.ru/v1 применяется в других клиентах.

Идентификатор модели Claude возьмите из каталога. Затем в ответе GET https://relay-llm.ru/api/public/models найдите запись с соответствующим public_id и проверьте наличие anthropic_messages в protocols. Если поле отсутствует, поддержка протокола этим ответом не подтверждена. Требования текущего клиента сверяйте со страницей Claude Code.

Проверьте, откуда приходит ключ

Для конфигурации Relay используется ANTHROPIC_AUTH_TOKEN. Настройки процесса, пользовательский файл и настройки управляемой организации могут влиять на итоговую конфигурацию. Найдите источник значения, не выводя сам секрет в терминал.

Наличие только Base URL не доказывает, что клиент использует ключ Relay. Проверьте и адрес, и авторизацию. После изменения окружения откройте новый процесс клиента. Не вставляйте ключ в файл проекта, который уедет в Git.

Разделите основной вызов и фоновые задачи

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

Если основной запрос работает, а более длинная задача получает отказ, проверьте идентификаторы моделей для фоновой работы и субагентов в актуальной инструкции Relay. Клиент может выбирать их отдельно. Старый идентификатор одной из таких моделей способен проявиться только после успешного начала сеанса.

Сохраните признаки ошибки

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

Код отказа разберите по документации ошибок. Сетевой обрыв после начала ответа не доказывает отсутствие расхода, поэтому не запускайте одинаковую большую задачу подряд в цикле.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.