Как подключить 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 на идентификатор модели из каталога.
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
- Подготовьте ключ
Создайте отдельный ключ в кабинете и передайте его в
RELAY_API_KEYчерез окружение, не через репозиторий. - Выберите модель
Скопируйте точный идентификатор из каталога. Имя в
config.tomlдолжно совпадать с каталогом символ в символ. - Добавьте провайдер
Вставьте конфиг с
base_url = "https://relay-llm.ru/v1"иwire_api = "responses"в пользовательскийconfig.toml. - Сделайте один короткий вызов
В каталоге проекта выполните
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 | если нужна модель предыдущего поколения |
Не выбирайте модель по старому снимку каталога. Сначала проверьте выбранную модель на одной небольшой задаче в отдельной папке, затем переносите её в рабочий репозиторий. Вне 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 на ту же дату.