Skip to main content
Codex CLI — официальный консольный ассистент для написания кода от OpenAI, аналог Claude Code. Он работает по OpenAI-совместимому протоколу, поэтому для подключения к RuAPI достаточно OPENAI_BASE_URL и OPENAI_API_KEY.

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

1

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

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

Node.js ≥ 18

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

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

Проверка:

​
Настройка RuAPI

Codex CLI поддерживает два пути: переменные окружения или ~/.codex/config.toml. Второй вариант надёжнее.

​
Способ 1: config.toml (рекомендуется)

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

​
Способ 2: только переменные окружения

Если не хочется править файл конфигурации:
В OpenAI-совместимом протоколе base_url / OPENAI_BASE_URL обязан заканчиваться на /v1. Это отличается от Anthropic.

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

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

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

Внутри сессии:
Или измените значение model = "..." в начале config.toml. Полный список — на странице цен.

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

  • OPENAI_API_KEY (или RUAPI_API_KEY) должен быть токеном RuAPI (sk-...), а не официальным sk-proj-... от OpenAI.
  • В Консоли → Токены проверьте, что ключ активен и нужная модель не исключена из allowlist.
  • Опечатка. Имена моделей OpenAI на RuAPI совпадают с официальными — точные имена возьмите со страницы цен (семейства GPT-5 и GPT-5 mini).
  • OPENAI_BASE_URL должен заканчиваться на /v1.
Замените wire_api на "chat" в config.toml. Протокол "responses" поддерживается только частью новых моделей.
RuAPI передаёт вызовы инструментов без изменений. Если Codex ругается — попробуйте тот же промпт напрямую через OpenAI, чтобы исключить проблему в самом промпте.
Опишите два провайдера в config.toml и используйте /provider <name> для переключения внутри сессии, или поставьте CC Switch.

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

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