~/.codex/config.toml. Аккаунт ChatGPT и вход в OpenAI при этом не нужны.
Обновлено: 05.11.2026
Почему в России Codex удобнее подключать через RuAPI, чем через аккаунт ChatGPT, и как платить без зарубежной карты, — коротко на странице www.ruapi.ai/codex-v-rossii; ниже — как всё настроить.
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 — первыми.Быстрее всего: одной командой
Откройте окно подключения
Скопируйте команду
Вставьте её в терминал
Дождитесь, пока Codex откроется
config.toml, дописывает в него настройки RuAPI, не трогая остальные, проверяет связь и открывает Codex. В следующий раз запускайте командой codex (на Windows, если запуск скриптов PowerShell запрещён (по умолчанию так и есть), — codex.cmd; скрипт покажет нужную команду в конце).
Консоль → API-ключи: кнопка «Подключить Claude Code, Cline и др.»
[!] и что делать. Если ваш config.toml устроен необычно, скрипт не будет его менять, а покажет, что добавить вручную (см. ниже).
Настройка вручную
Предварительные требования
Аккаунт RuAPI и API-ключ
Node.js с npm
Установка Codex CLI
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 заново.
model_catalog_url даёт меню /model со списком моделей, который обновляется сам. Версии Codex 0.156–0.160 эту строку уже знают, но сами список не загружают — меню у них пустое. Обновите Codex или уберите эту строку. Совсем старые версии строку просто не замечают.Первый запрос
Переключение моделей
Внутри сессии введите/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, может сохраниться и для следующих запусков.
Решение проблем
Меню /model пустое или в нём не те модели
Меню /model пустое или в нём не те модели
- Проверьте версию:
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 версия осталась старой
- macOS / Linux
- Windows (PowerShell)
Модель не найдена (503) или 404
Модель не найдена (503) или 404
- Опечатка в ID. Выберите модель в меню
/modelили возьмите точное имя со страницы цен. base_urlдолжен заканчиваться на/v1.
Ошибка: wire_api = 'chat' is no longer supported
Ошибка: wire_api = 'chat' is no longer supported
config.toml строку wire_api = "chat" на wire_api = "responses".Я настраивал Codex по старой версии этой страницы (env_key)
Я настраивал Codex по старой версии этой страницы (env_key)
env_key = "RUAPI_API_KEY" и переменной окружения продолжает работать, но меню /model в нём не обновляется само. Чтобы список обновлялся сам, замените блок [model_providers.ruapi] целиком на блок со страницы выше.Что работает не со всеми моделями
Что работает не со всеми моделями
- Встроенный веб-поиск Codex работает только с моделями GPT. С другими моделями этот инструмент просто не передаётся; ваши обычные инструменты (команды, правка файлов, MCP) работают со всеми.
- DeepSeek в Codex принимает только текст — картинки в запросе он не видит.
- Продолжение прошлого ответа через
previous_response_idне поддерживается ни для каких моделей — Codex его и не использует (см. ошибки).
Ошибки при tool calling / function calling
Ошибки при tool calling / function calling
Держать одновременно официальный аккаунт и RuAPI
Держать одновременно официальный аккаунт и RuAPI
model_provider в начале config.toml.