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

Как подключить Codex CLI к API Relay

Как подключить Codex CLI к API Relay

Codex CLI подключается к Relay через OpenAI Responses API. В конфиге укажите собственный провайдер, адрес https://relay-llm.ru/v1 и ключ из RELAY_API_KEY. Одноходовый запрос можно проверить сразу. Длинный многоходовый сеанс требует отдельной проверки.

Коротко

  • Используйте wire_api = "responses".

  • Не переопределяйте встроенный провайдер OpenAI переменной OPENAI_BASE_URL.

  • В Relay не поддержаны previous_response_id и background: true.

Как Codex CLI выбирает между подпиской и ключом

Codex CLI знает два способа доступа: вход через ChatGPT и ключ API. Решает конфигурация. Пока model_provider не задан, Codex использует встроенного провайдера openai и ждёт вход. Когда выбран свой провайдер, запросы идут на его base_url, а ключ читается из переменной, названной в env_key. Параметр requires_openai_auth = true у провайдера включает вход OpenAI и заставляет Codex игнорировать env_key, поэтому для Relay его не задают.

Облачные возможности Codex требуют входа через ChatGPT, как сказано в документации OpenAI. Через Relay вы получаете локальную работу в терминале: чтение и правку файлов, запуск команд и тестов. Режим входа покажет codex login status.

Конфиг Codex CLI

Создайте ключ в кабинете и экспортируйте его как RELAY_API_KEY в своей оболочке. Откройте пользовательский файл ~/.codex/config.toml на macOS и Linux либо %USERPROFILE%\.codex\config.toml в Windows. Проектный .codex/config.toml не задаёт провайдеры.

Добавьте блок, заменив MODEL_ID на идентификатор модели из каталога.

toml
model = "MODEL_ID"
model_provider = "relay"

[model_providers.relay]
name = "Relay"
base_url = "https://relay-llm.ru/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"

wire_api принимает значение responses. Старое значение chat ломает запуск клиента. Codex читает все блоки model_providers при старте, поэтому удалите или исправьте старые блоки с устаревшими полями.

Проверка Codex CLI через Relay

  1. Подготовьте ключ

    Создайте отдельный ключ в кабинете и передайте его в RELAY_API_KEY через окружение, не через репозиторий.

  2. Выберите модель

    Скопируйте точный идентификатор из каталога. Имя в config.toml должно совпадать с каталогом символ в символ.

  3. Добавьте провайдер

    Вставьте конфиг с base_url = "https://relay-llm.ru/v1" и wire_api = "responses" в пользовательский config.toml.

  4. Сделайте один короткий вызов

    В каталоге проекта выполните codex exec "ping". Затем проверьте запись в журнале запросов.

Какую модель выбрать

Модель для Codex CLI должна принимать протокол Responses: другая в нём не заработает. Проверка занимает минуту. Откройте карточку модели в каталоге и сверяйте протокол с документацией интеграции. На 18 октября 2026 для такой пробы можно начать с этих моделей OpenAI:

МодельКогда пробовать
gpt-6.1-solобычная работа в репозитории: это модель из примеров справочника OpenAI
gpt-6-lunaкороткие частые правки: сравните с gpt-6.1-sol по цене на карточке и по результату на своих задачах
gpt-5.6-terraесли нужна модель предыдущего поколения
GPT-6.1 Sol0,12 $ за 1 млн входных токенов
GPT-6 Luna0,08 $ за 1 млн входных токенов

Не выбирайте модель по старому снимку каталога. Сначала проверьте выбранную модель на одной небольшой задаче в отдельной папке, затем переносите её в рабочий репозиторий. Вне Git-репозитория codex exec запускают с флагом --skip-git-repo-check. Если на втором ходу диалога приходит 400, причина описана в разделе об ограничениях Responses ниже.

Ограничения Responses API

Relay принимает /v1/responses, включая потоковый ответ. Но previous_response_id и background: true получают 400. Историю для следующего хода передавайте целиком в input, если клиент даёт такой выбор. Идентификаторы элементов ответа Relay заменяет своими.

Из-за этого многоходовые сеансы Codex CLI и сценарии с инструментами нельзя обещать как полностью проверенные. Настройка провайдера сверена с документацией клиента, а одноходовый запуск остаётся базовой проверкой. Перед работой над репозиторием с важными изменениями выполните короткую пробу в отдельной папке.

Не называйте провайдер openai, ollama или lmstudio: эти имена заняты Codex CLI. Свой идентификатор relay избегает конфликта. Подробности маршрута и ошибки доступны в документации Responses API и справочнике ошибок.

Нужен ли /v1 в base_url?

Да. Codex CLI использует OpenAI Responses API, поэтому адрес должен быть https://relay-llm.ru/v1.

Можно ли использовать OPENAI_BASE_URL вместо config.toml?

Не используйте этот путь для Relay. Он переопределяет встроенного провайдера, а работа со сторонним шлюзом так не подтверждена.

Как убедиться, что запрос пошёл через Relay?

Выполните codex exec "ping" и найдите ответ в журнале запросов.

Источники

Способы входа и поля model_providers сверены с документацией OpenAI о входе в Codex и справочником конфигурации на 14 октября 2026. Протоколы моделей взяты из каталога Relay на ту же дату.

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

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