Codex CLI

Настройте провайдера Responses и API-ключ оболочки для Codex CLI.

Установка и подготовка

  1. Установите Node.js, затем официальную Codex CLI командой ниже. Выполните codex --version в новом терминале.
  2. Создайте ключ в routerra.ai → API-ключи. Выберите в списке моделей точный ID с поддержкой Responses API и инструментов; модель только для Chat Completions здесь не подходит.
npm install -g @openai/codex
codex --version

Провайдер в TOML

  1. Отредактируйте ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) и добавьте TOML без дублирования таблиц провайдера. model_provider должен совпадать с routerra; env_key содержит имя переменной, а не секрет. Замените YOUR_MODEL_ID.
  2. Задайте ROUTERRA_API_KEY в оболочке, из которой запускаете codex. Переменная действует только в ней; при необходимости сохраните в профиле оболочки. Провайдер использует свой ключ вместо входа ChatGPT. После изменения TOML перезапустите Codex.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

Запуск с ключом провайдера

Ошибка отсутствующей переменной означает, что Codex не получил ROUTERRA_API_KEY; запустите его из нужного терминала. При 404 на /responses проверьте URL и протокол: один /v1 и wire_api = "responses". Если текст работает, а список файлов нет, выберите модель с инструментами. Проверьте запрос в расходах routerra.ai: запуск CLI ещё не подтверждает маршрут.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Для Windows PowerShell:

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex