Перейти к основному содержанию
Codex CLI — официальный консольный ассистент для написания кода от OpenAI, аналог Claude Code. Он общается с моделью через OpenAI Responses API, поэтому для подключения к RuAPI достаточно описать провайдера в ~/.codex/config.toml. Аккаунт ChatGPT и вход в OpenAI при этом не нужны. Обновлено: 05.11.2026 Почему в России Codex удобнее подключать через RuAPI, чем через аккаунт ChatGPT, и как платить без зарубежной карты, — коротко на странице www.ruapi.ai/codex-v-rossii; ниже — как всё настроить.
В Codex работают не только модели GPT (например, gpt-5.4, gpt-5.5), но и модели других производителей: Claude, DeepSeek, Gemini, Kimi, GLM, Qwen, MiniMax и Grok. Codex отправляет запросы в формате Responses API, а RuAPI сам переводит их в формат, который понимает модель. Мы проверили каждое семейство запросами в формате Codex (вызов инструмента, следующий шаг с результатом инструмента, обычный и потоковый ответ) — например, claude-sonnet-5-5, deepseek-flash, gemini-3.8-flash, kimi-k3.1-pro, glm-5.3, qwen3.8-max, MiniMax-M3.1-Flash, grok-4.7. Меню /model само показывает все эти модели, доступные вашему ключу; модели GPT — первыми.

Быстрее всего: одной командой

1

Откройте окно подключения

Зарегистрируйтесь на www.ruapi.ai (пополнять баланс для первой проверки не обязательно), откройте Консоль → API-ключи, нажмите Подключить Claude Code, Cline и др. и выберите Codex.
2

Скопируйте команду

Нажмите Скопировать команду. Ваш ключ и адрес RuAPI подставятся сами. Команда одноразовая и действует 30 минут; если не успели — нажмите Новая команда. Если в окне сразу показаны готовые настройки, сначала выберите вверху окна Способ → Одной командой (рекомендуем).
3

Вставьте её в терминал

macOS: ⌘ + пробел → «Терминал». Linux: Ctrl + Alt + T. Windows: Win + X → «Терминал» или «Windows PowerShell» (не «Командная строка»). Вставьте команду и нажмите Enter — дальше скрипт всё сделает сам.
4

Дождитесь, пока Codex откроется

Обычно 1–5 минут. Если Codex ещё не установлен, скрипт ставит его через npm (и Node.js, если его нет; всё — в отдельную папку, без прав администратора), делает копию config.toml, дописывает в него настройки RuAPI, не трогая остальные, проверяет связь и открывает Codex. В следующий раз запускайте командой codex (на Windows, если запуск скриптов PowerShell запрещён (по умолчанию так и есть), — codex.cmd; скрипт покажет нужную команду в конце).
Страница API-ключей RuAPI: адрес https://www.ruapi.ai и кнопка «Подключить Claude Code, Cline и др.»

Консоль → API-ключи: кнопка «Подключить Claude Code, Cline и др.»

Если что-то пойдёт не так, скрипт напишет строку с [!] и что делать. Если ваш config.toml устроен необычно, скрипт не будет его менять, а покажет, что добавить вручную (см. ниже).

Настройка вручную

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

1

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

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

Node.js с npm

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

Установка Codex CLI

Проверка:
Нужна версия 0.161 или новее: с неё Codex сам загружает список моделей с RuAPI. Обновить Codex — тем же способом, каким ставили: npm install -g @openai/codex@latest или brew upgrade codex.

Файл config.toml

Откройте ~/.codex/config.toml (на Windows — %USERPROFILE%\.codex\config.toml; если вы задали переменную CODEX_HOME — config.toml в этой папке). Если файла нет — создайте и вставьте целиком, заменив sk-ваш-ключ на свой ключ:
Если в файле уже есть настройки:
  • две первые строки (model и model_provider) должны стоять в самом начале файла, до первого заголовка в квадратных скобках [ … ]; если такие строки уже есть — замените их;
  • блок [model_providers.ruapi] допишите в конец файла; если такой блок уже есть — замените его целиком: с двумя одинаковыми блоками Codex не запустится.
Сохраните файл и запустите codex заново.
Ключ записан прямо в файл: не кладите config.toml в папку проекта и не добавляйте его в git. base_url обязан заканчиваться на /v1, а wire_api должен быть "responses": вариант "chat" удалили из Codex в феврале 2026 года, и с ним Codex не запустится.
Строка model_catalog_url даёт меню /model со списком моделей, который обновляется сам. Версии Codex 0.156–0.160 эту строку уже знают, но сами список не загружают — меню у них пустое. Обновите Codex или уберите эту строку. Совсем старые версии строку просто не замечают.

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

При первом запуске в новой папке Codex спросит, доверяете ли вы ей, — нажмите Enter. Затем в интерактивном режиме:
Нормальный ответ и запись в Консоли RuAPI → Журнал запросов = успех.

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

Внутри сессии введите /model — откроется меню с моделями, доступными вашему ключу: сначала GPT, затем Claude, DeepSeek, Gemini, Kimi, GLM, Qwen, MiniMax и Grok. Список Codex загружает с RuAPI при запуске и сам обновляется, когда у нас появляются новые модели. На пробном балансе возле моделей написано «✓ Доступна в пробном периоде» или «🔒 Откроется после пополнения баланса». Можно и вручную изменить model = "..." в начале config.toml. Подойдёт любая модель из меню /model или со страницы цен. Экономный вариант. Самая дешёвая модель GPT у нас — gpt-6-luna: она стоит во много раз меньше gpt-5.4. В начале config.toml (до первого раздела в квадратных скобках) замените строку model = "..." на model = "gpt-6-luna". Для действительно сложной задачи переключитесь через /model на gpt-5.4, а после неё верните gpt-6-luna: модель, выбранная в /model, может сохраниться и для следующих запусков.

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

  • В experimental_bearer_token должен быть ключ RuAPI целиком, вместе с sk-, а не официальный sk-proj-... от OpenAI.
  • В Консоли → API-ключи проверьте, что ключ активен и что нужная модель входит в «Доступные модели» ключа (если список задан).
  • Проверьте версию: codex --version. Нужна 0.161 или новее (см. выше про 0.156–0.160).
  • В [model_providers.ruapi] должна быть строка model_catalog_url, а model_provider = "ruapi" — в начале файла.
  • Если для ключа задан список «Доступные модели», в меню попадут только модели из этого списка.
  • Если вы выбрали профиль (строка profile = ... в начале config.toml), его model и model_provider перекрывают настройки RuAPI.
Если Codex ставила команда из Консоли, он лежит в отдельной папке, и кнопка обновления внутри Codex ставит новую версию в другое место. Обновляйте так:
  • Опечатка в ID. Выберите модель в меню /model или возьмите точное имя со страницы цен.
  • base_url должен заканчиваться на /v1.
У вас старый конфиг. Замените в config.toml строку wire_api = "chat" на wire_api = "responses".
Старый вариант с env_key = "RUAPI_API_KEY" и переменной окружения продолжает работать, но меню /model в нём не обновляется само. Чтобы список обновлялся сам, замените блок [model_providers.ruapi] целиком на блок со страницы выше.
  • Встроенный веб-поиск Codex работает только с моделями GPT. С другими моделями этот инструмент просто не передаётся; ваши обычные инструменты (команды, правка файлов, MCP) работают со всеми.
  • DeepSeek в Codex принимает только текст — картинки в запросе он не видит.
  • Продолжение прошлого ответа через previous_response_id не поддерживается ни для каких моделей — Codex его и не использует (см. ошибки).
Для моделей GPT RuAPI передаёт вызовы инструментов без изменений; для других моделей переводит их в формат, который понимает модель. Если Codex ругается — пришлите в поддержку текст ошибки и время запроса из Консоли → Журнал запросов.
Удобнее всего переключаться через CC Switch. Вручную — меняйте значение model_provider в начале config.toml.

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

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