Codex CLI

Codex CLI — open-source агент OpenAI для работы с кодом в терминале. Codex поддерживает собственных провайдеров Responses API, поэтому запросы можно направить в OdiRouter через единый Base URL и API key.

Быстрый старт

Шаг 1: Установите Codex CLI

Нативная установка
npm

macOS, Linux или WSL:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell:

irm https://chatgpt.com/codex/install.ps1 | iex

npm install --global @openai/codex

Проверьте установку:

codex --version

Шаг 2: Получите API key OdiRouter

Создайте API key и пополните баланс OdiRouter. Подробнее — в быстром старте.

Шаг 3: Настройте провайдер OdiRouter

Отредактируйте пользовательский файл ~/.codex/config.toml:

model = "gpt-5.6-sol"
model_provider = "odirouter"
model_reasoning_effort = "high"

[model_providers.odirouter]
name = "OdiRouter"
base_url = "https://api.odirouter.ai/v1"
env_key = "ODIROUTER_API_KEY"
wire_api = "responses"

Параметр	Назначение
`model`	ID модели OdiRouter по умолчанию
`model_provider`	Выбирает собственного провайдера из блока ниже
`model_reasoning_effort`	Задает уровень рассуждения, если модель его поддерживает
`base_url`	Base URL Responses API OdiRouter
`env_key`	Имя переменной окружения с API key
`wire_api`	Использует протокол Responses API

export ODIROUTER_API_KEY="YOUR_API_KEY"

Для постоянной настройки добавьте строку в ~/.zshrc, ~/.bashrc или профиль shell.

Для текущей сессии:

$env:ODIROUTER_API_KEY="YOUR_API_KEY"

Для текущего пользователя Windows:

setx ODIROUTER_API_KEY "YOUR_API_KEY"

После setx перезапустите Codex и приложение Codex, если оно открыто.

Шаг 5: Запустите Codex

cd /path/to/your/project
codex

Теперь запросы используют провайдер OdiRouter из config.toml.

Справочник конфигурации

Смена модели

Укажите точный ID из GET https://api.odirouter.ai/v1/models:

model = "gpt-5.6-sol"

Для одного запуска модель можно переопределить:

codex --model gpt-5.6-sol

Уровни доверия проекта

Codex поддерживает настройки доверия для отдельных проектов:

[projects."/path/to/trusted/project"]
trust_level = "trusted"

[projects."/path/to/untrusted/project"]
trust_level = "untrusted"

trusted: Codex загружает доверенную проектную конфигурацию и использует одобренные разрешения.
untrusted: Codex игнорирует проектные слои конфигурации и применяет более строгий режим.

Диагностика

Симптом	Решение
`401 Unauthorized`	Проверьте, что `ODIROUTER_API_KEY` задан и содержит действительный ключ OdiRouter
`403 Forbidden`	Проверьте статус ключа, баланс и доступ к модели
Codex использует другого провайдера	Убедитесь, что `model_provider = "odirouter"` указан в `~/.codex/config.toml`
Model not found	Скопируйте точный ID из `GET https://api.odirouter.ai/v1/models`
Ошибка Responses API	Убедитесь, что `base_url` заканчивается на `/v1`, а `wire_api = "responses"`
Конфигурация игнорируется	Проверьте, что блок провайдера находится в пользовательском файле, и перезапустите Codex