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

Claude Code GPT: протоколы и границы подключения

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, не обращается к рабочим файлам и не проверяет инструменты агента.

Демонстрационный секрет нужно заменить своим в окружении сервера. Не вставляйте реальный ключ в публичный пример.

bash
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 модели
Текст работает, инструмент нетФормат вызова и ответа инструмента в клиенте
Поток обрываетсяСобытия завершения и ошибку соединения
429Retry-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.

Создать аккаунт

Модели из статьи

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