Вайб-кодинг в Codex: Настройка через RouterAI (Claude, GPT-6, DeepSeek, Glm, Qwen)

Содержание статьи

Требования
Установка Codex
Подключение к RouterAI
Выбор модели
Проверка подключения
Что доступно
Решение проблем
Что дальше

Подключение Codex к RouterAI — агент OpenAI для разработки: работает в терминале (Codex CLI) и в редакторе (расширение для VS Code, Cursor, Windsurf). Читает и редактирует файлы, запускает команды, работает с git и решает многошаговые задачи.

RouterAI предоставляет совместимый с OpenAI эндпоинт POST /api/v1/responses и каталог моделей в формате Codex, поэтому Codex подключается штатным способом — через собственного провайдера в config.toml. В списке моделей Codex появляются все модели RouterAI: GPT, Claude, Gemini, DeepSeek, GLM, Kimi, Qwen и другие.

Требования

macOS, Linux, Windows (WSL) или Windows (нативно)
Node.js 18 или новее (для установки через npm)
API-ключ из личного кабинета

Установка Codex

Codex CLI

npm install -g @openai/codex

Или через Homebrew (macOS):

brew install --cask codex

Расширение для VS Code

Установите расширение Codex – OpenAI’s coding agent (идентификатор openai.chatgpt) из маркетплейса расширений. Расширение использует тот же файл настроек, что и CLI, — ~/.codex/config.toml, поэтому настройка ниже подходит для обоих вариантов.

Подключение к RouterAI

Подключение состоит из двух шагов: сохранить API-ключ в переменной окружения и описать RouterAI как провайдера в config.toml.

Шаг 1. API-ключ

macOS / Linux / WSL

Откройте профиль оболочки:

nano ~/.zshrc   # zsh (macOS по умолчанию)
# или
nano ~/.bashrc  # bash

Добавьте строку:

export ROUTERAI_API_KEY="ваш-api-ключ"

Замените ваш-api-ключ на ключ из личного кабинета и примените изменения:

source ~/.zshrc

Windows

setx ROUTERAI_API_KEY "ваш-api-ключ"

⚠ setx записывает переменную постоянно, но она появляется только в новых окнах cmd.exe / PowerShell. Перезапустите терминал, а если используете расширение — полностью перезапустите VS Code.

Шаг 2. config.toml

Платформа	Путь к файлу
macOS / Linux / WSL	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`

macOS / Linux / WSL

model_provider = "routerai"
model = "openai/gpt-6-sol"
model_reasoning_effort = "medium"

[model_providers.routerai]
name = "RouterAI"
base_url = "https://routerai.ru/api/v1"
wire_api = "responses"
supports_websockets = false

[model_providers.routerai.auth]
command = "sh"
args = ["-c", "echo $ROUTERAI_API_KEY"]

Windows

model_provider = "routerai"
model = "openai/gpt-6-sol"
model_reasoning_effort = "medium"

[model_providers.routerai]
name = "RouterAI"
base_url = "https://routerai.ru/api/v1"
wire_api = "responses"
supports_websockets = false

[model_providers.routerai.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:ROUTERAI_API_KEY"]

⚠ Ключ передаётся через секцию [model_providers.routerai.auth], а не через env_key. Только в этом режиме Codex загружает каталог моделей RouterAI — с env_key запросы работают, но в списке выбора будут лишь встроенные модели OpenAI, которые через RouterAI недоступны (см. Решение проблем).

Строки model_provider и model должны стоять в начале файла — до первой секции в квадратных скобках.

Запуск

cd /path/to/your/project
codex

В VS Code откройте панель Codex после перезапуска редактора.

Выбор модели

Codex при запуске загружает каталог моделей RouterAI, и они появляются в списке выбора с префиксом автора: OpenAI: GPT-6 Sol, Anthropic: Claude Sonnet 5.5, Z.ai: GLM 5.3 и т. д. Для каждой модели Codex знает размер контекста и поддерживаемые уровни рассуждений.

CLI: команда /model внутри сессии или флаг при запуске — codex -m anthropic/claude-sonnet-5.5
VS Code: переключатель модели внизу панели Codex
По умолчанию: параметр model в config.toml

⚠ Рядом с моделями RouterAI в списке остаются встроенные модели Codex без префикса — например, GPT-5.6-Terra (gpt-5.6-terra). Через RouterAI они не работают: выбирайте модели с префиксом, например OpenAI: GPT-5.6 Terra (openai/gpt-5.6-terra).

Модель	Для чего
`openai/gpt-6-sol`	Основная модель для кода и агентных задач
`openai/gpt-5.6-terra`	Сбалансированная модель для повседневной работы
`anthropic/claude-sonnet-5.5`	Claude в Codex — код, рефакторинг, анализ
`~z-ai/glm-latest`	Актуальная GLM — недорогая альтернатива для агентной работы
`~deepseek/deepseek-v4-pro-latest`	Актуальная DeepSeek Pro

Идентификаторы с ~ — «вечные» алиасы: они всегда указывают на актуальную версию семейства. Полный список моделей — в каталоге RouterAI.

Уровень рассуждений

Параметр model_reasoning_effort задаёт глубину рассуждений по умолчанию: minimal, low, medium, high, xhigh, max. Набор доступных уровней зависит от модели — Codex показывает его при выборе модели, а переключить уровень можно там же.

Проверка подключения

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

codex exec "Ответь одним словом: готово"

В заголовке вывода должны быть provider: routerai и модель с префиксом автора, а в конце — ответ модели:

model: openai/gpt-6-sol
provider: routerai
...
codex
готово

Внутри интерактивной сессии текущие модель и настройки показывает команда /status.

Дополнительно можно убедиться в работе эндпоинта обычным curl:

curl https://routerai.ru/api/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ROUTERAI_API_KEY" \
  -d '{
    "model": "openai/gpt-6-sol",
    "input": "Привет!"
  }'

Что доступно

RouterAI поддерживает OpenAI Responses API, поэтому в Codex работают:

Стриминг ответов (SSE)
Вызовы инструментов: команды в терминале, правка файлов, планирование
Изображения в сообщениях — для моделей, которые принимают картинки
Уровни рассуждений (model_reasoning_effort) для совместимых моделей
Кэширование промптов для моделей, которые его поддерживают

Модели других авторов — Claude, Gemini, GLM, DeepSeek и т. д. — тоже работают через Responses API: RouterAI сам переводит запрос в формат провайдера и обратно.

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

Model 'gpt-5.6-terra' not found (400)

Выбрана встроенная модель Codex без префикса автора. В RouterAI идентификаторы моделей включают автора: openai/gpt-5.6-terra, а не gpt-5.6-terra.

Выберите в списке модель с префиксом — например, OpenAI: GPT-5.6 Terra
Если моделей с префиксом в списке нет — проверьте, что ключ передаётся через секцию [model_providers.routerai.auth], а не через env_key, и перезапустите Codex / VS Code
Выбор модели в интерфейсе имеет приоритет над model из config.toml — поэтому важно, что именно выбрано в списке

Ошибка аутентификации (401)

Проверьте, что переменная задана: echo $ROUTERAI_API_KEY (macOS / Linux) или echo %ROUTERAI_API_KEY% (cmd.exe)
Убедитесь, что ключ взят из личного кабинета и активен
VS Code: расширение видит переменные окружения, которые были на момент запуска редактора — после изменения ключа полностью закройте и откройте VS Code
Если переменная окружения не подхватывается, ключ можно указать прямо в команде: args = ["-c", "echo ваш-api-ключ"]. Учтите, что тогда ключ хранится в config.toml открытым текстом

Codex игнорирует настройки

Ключи пишутся через подчёркивание: model_provider, model_reasoning_effort, base_url, wire_api. Варианты вроде modelreasoningeffort Codex не распознаёт
model_provider, model и model_reasoning_effort должны стоять до первой секции [...] — иначе они попадают внутрь секции и не действуют
Проверьте путь к файлу: ~/.codex/config.toml или %USERPROFILE%\.codex\config.toml

402 Payment Required

Недостаточно средств на балансе. Пополните баланс в разделе Биллинг.

Что дальше

Каталог моделей — выберите подходящую модель под задачу
Claude Code — настройка Claude Code через RouterAI
Аутентификация — управление API-ключами и безопасность