Claude Code GPT: протоколы и границы подключения
Claude Code GPT: можно ли подключить GPT вместо Claude? Наличие модели gpt-6-sol в Relay не подтверждает работу всей сессии Claude Code с этой моделью. Каталог Relay указывает для неё Anthropic Messages, но клиенту нужны также корректный поток, инструменты и служебные запросы. Для рабочего подключения Claude Code используйте инструкцию Relay; для прямого вызова GPT начните с OpenAI-совместимого API.
Claude Code GPT: что подтверждает протокол
Claude Code работает с шлюзом через Anthropic Messages. Поле anthropic_messages в каталоге означает доступность этого протокола у модели. Оно не доказывает совместимость каждой функции клиента с каждой моделью: агентная сессия может включать выбор модели для фоновой задачи, вызов инструмента и обработку потока.
Руководство Anthropic по шлюзам прямо указывает, что Anthropic не поддерживает маршрутизацию Claude Code на модели других разработчиков через шлюз. Поэтому обещать готовую интеграцию GPT с Claude Code по одной записи каталога нельзя.
Если вам нужен именно GPT для программирования, начните с клиента, у которого документирован OpenAI-совместимый API и пользовательский адрес сервера. Инструкции клиентов собраны в разделе интеграций Relay. Сверьте руководство установленной версии перед переносом настроек.
Как подключить Claude Code по инструкции Relay
Выберите Claude-модель из каталога, например claude-sonnet-5, и создайте отдельный ключ. Anthropic Messages использует базовый адрес https://relay-llm.ru без /v1. Полный маршрут сообщения будет /v1/messages; добавление ещё одного /v1 в базовый адрес способно испортить путь, который строит клиент.
Инструкция Relay использует ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN. В ней также заданы переменные для основной модели и моделей отдельных ролей. Перенесите весь блок из актуального руководства, а не одну строку с ID: иначе часть вызовов может остаться на прежней модели.
Не храните секрет в настройках, которые попадут в репозиторий. Передайте ключ процессу через защищённое окружение. Если программа уже работала, начните новую сессию с обновлёнными переменными: старый процесс не обязан подхватить изменения оболочки.
Как отдельно проверить GPT через Chat Completions
Для OpenAI-совместимого запроса базовый адрес https://relay-llm.ru/v1. Вызов ниже проверяет только текстовый ответ GPT. Он не запускает Claude Code, не обращается к рабочим файлам и не проверяет инструменты агента.
Демонстрационный секрет нужно заменить своим в окружении сервера. Не вставляйте реальный ключ в публичный пример.
export RELAY_API_KEY="sk-demo-not-a-real-key"
curl --silent --show-error --fail-with-body \
-D /tmp/relay-gpt-check.headers \
https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [{"role": "user", "content": "Ответь одним словом: готово"}],
"max_tokens": 32
}'Успешный ответ подтверждает доступ этого ключа к модели через Chat Completions. После него проверьте те же настройки в выбранном клиенте. Формат тела описан в документации API.
Как проверить агентный сценарий по отдельным действиям
Начните с временного каталога без рабочих документов. Попросите объяснить содержимое одного тестового файла. Затем отдельно проверьте предложенную правку и её применение. Так видно, какой этап сломался: получение текста, вызов инструмента или запись файла.
Поток тоже проверьте отдельно. Клиент должен прочитать ответ до завершения и показать ошибку при обрыве. Обычный ответ без потока не подтверждает обработку потоковых событий и результатов инструментов.
Перед каждым расширением сценария запишите ожидаемый результат. Например: агент прочитал только указанный файл, предложил изменение одной строки, после разрешения изменил её и показал разницу. Если вместо этого он просто написал «готово», проверьте сам файл: текст модели не доказывает выполнение команды.
Как найти причину отказа
| Симптом | Что проверить первым |
|---|---|
| 401 | Как клиент передаёт секрет и не отозван ли ключ |
403 model_not_allowed | Список моделей, разрешённых ключу |
| 404 | Итоговый маршрут и точный ID модели |
| Текст работает, инструмент нет | Формат вызова и ответа инструмента в клиенте |
| Поток обрывается | События завершения и ошибку соединения |
| 429 | Retry-After и частоту запросов клиента |
Сохраните HTTP-статус, код ошибки и x-request-id. Не отправляйте в поддержку полный снимок окружения с секретами. Действия по коду ответа описаны в справочнике ошибок.
Отдельный ключ позволит ограничить расход экспериментальной сессии и отозвать её доступ. Но лимит API не ограничивает права Claude Code на диск или shell: эти разрешения проверяйте в самом клиенте и окружении.
FAQ
Claude Code GPT работает после одной замены model?
Одной замены недостаточно для подтверждения интеграции. Нужно проверить протокол, поток, инструменты и вспомогательные запросы; Anthropic не поддерживает маршрутизацию Claude Code на сторонние модели.
Почему GPT указан с Anthropic Messages в каталоге Relay?
Это свойство API модели. Полная совместимость агентного клиента требует отдельной проверки всех используемых им функций.
Какой адрес указать для Claude Code?
Используйте адрес без /v1 и полный блок настроек из инструкции Relay. Для OpenAI SDK базовый адрес другой: он заканчивается на /v1.