Skip to main content
Codex CLI — официальный консольный ассистент для написания кода от OpenAI, аналог Claude Code. Он общается с моделью через OpenAI Responses API, поэтому для подключения к RuAPI достаточно описать провайдера в ~/.codex/config.toml.
В Codex работают модели GPT: gpt-5.4, gpt-5.5, серия gpt-5.6, gpt-6-astra. Codex отправляет запросы только в формате Responses API, а на RuAPI он доступен для моделей GPT. Для Claude используйте Claude Code, для DeepSeek — Claude Code на DeepSeek.

​
Предварительные требования

1

Аккаунт RuAPI и API-ключ

Консоль → API-ключи → Создать ключ. См. API-ключи и безопасность.
2

Node.js с npm

Установите с nodejs.org, если требуется.

​
Установка Codex CLI

Проверка:

​
Настройка RuAPI

Откройте ~/.codex/config.toml (или %USERPROFILE%\.codex\config.toml на Windows). Если файла нет — создайте:
Затем задайте ключ в переменной окружения (или сохраните в ~/.zshrc / ~/.bashrc):
base_url обязан заканчиваться на /v1 — в отличие от настройки для Anthropic. А wire_api должен быть "responses": вариант "chat" удалили из Codex в феврале 2026 года, и с ним Codex не запустится.

​
Первый запрос

В интерактивном режиме:
Нормальный ответ и запись в Консоли RuAPI → Журнал запросов = успех.

​
Переключение моделей

Внутри сессии:
Или измените значение model = "..." в начале config.toml. Подойдёт любая модель GPT со страницы цен.

​
Решение проблем

  • RUAPI_API_KEY должен быть ключом RuAPI (sk-...), а не официальным sk-proj-... от OpenAI.
  • Переменная должна быть задана в том терминале, где вы запускаете codex (после export в ~/.zshrc откройте новый терминал).
  • В Консоли → API-ключи проверьте, что ключ активен и что нужная модель входит в «Доступные модели» ключа (если список задан).
  • Опечатка в ID. Имена моделей GPT на RuAPI совпадают с официальными — точные имена возьмите со страницы цен.
  • base_url должен заканчиваться на /v1.
У вас старый конфиг. Замените в config.toml строку wire_api = "chat" на wire_api = "responses".
Так и должно быть: Codex работает только через Responses API, а он на RuAPI доступен для моделей GPT. Для Claude и DeepSeek используйте Claude Code — там подходят все модели.
RuAPI передаёт вызовы инструментов без изменений. Если Codex ругается — попробуйте тот же промпт напрямую через OpenAI, чтобы исключить проблему в самом промпте.
Удобнее всего переключаться через CC Switch. Вручную — меняйте значение model_provider в начале config.toml.

​
Продвинутое: вместе с Claude Code

Многие используют Codex (для задач, где сильнее модели GPT) и Claude Code (для длинного контекста и анализа кода) одновременно. Они не мешают друг другу: настройте Claude Code по его инструкции, а Codex — по этой странице — один и тот же ключ RuAPI подходит обоим.