Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

1

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

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

Node.js ≥ 18

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

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

npm install -g @openai/codex
Проверка: 
codex --version

​
Настройка RuAPI

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

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

Откройте ~/.codex/config.toml (или %USERPROFILE%\.codex\config.toml на Windows). Если файла нет — создайте: 
model_provider = "ruapi"
model = "gpt-5"

[model_providers.ruapi]
name = "RuAPI"
base_url = "https://www.ruapi.ai/v1"
wire_api = "chat"
env_key = "RUAPI_API_KEY"
Затем экспортируйте ключ (или сохраните в ~/.zshrc / ~/.bashrc): 
export RUAPI_API_KEY="sk-ваш-ключ"
wire_api = "chat" означает классический /v1/chat/completions — самый надёжный вариант. Можно попробовать "responses" для новой Responses API, но не все модели на RuAPI её поддерживают.

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

Если не хочется править файл конфигурации: 
export OPENAI_BASE_URL="https://www.ruapi.ai/v1"
export OPENAI_API_KEY="sk-ваш-ключ"
codex
В OpenAI-совместимом протоколе base_url / OPENAI_BASE_URL обязан заканчиваться на /v1. Это отличается от Anthropic.

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

cd ~/some-project
codex
В интерактивном режиме: 
> Расскажи о себе в одном предложении.
Нормальный ответ и запись в Консоли RuAPI → Логи = успех.

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

Внутри сессии: 
/model gpt-5
/model gpt-5-mini
/model o4-mini
Или измените значение model = "..." в начале config.toml. Полный список — в галерее моделей.

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

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

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

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