Codex CLI

Codex CLI に Responses provider とシェルの API キーを設定します。

導入と準備

  1. Node.js を導入し、下のコマンドで公式 Codex CLI をインストールします。新しいターミナルで codex --version を実行します。
  2. routerra.ai → API Keysでキーを作成します。モデル一覧から Responses API とツール呼び出しに対応する正確な ID を選びます。Chat Completions 専用モデルはこの設定では動きません。
npm install -g @openai/codex
codex --version

TOML provider を定義

  1. ~/.codex/config.toml（Windows: %USERPROFILE%\.codex\config.toml）を編集し、既存の provider テーブルを重複させずに下の TOML をマージします。model_provider は routerra と一致させ、env_key には秘密値でなく環境変数名を指定します。YOUR_MODEL_ID を置き換えます。
  2. codex を起動するシェルで ROUTERRA_API_KEY を設定します。この設定はそのシェル限りです。永続化する場合はシェル設定に保存します。この provider は 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"

provider キーで起動

変数不足エラーなら Codex が ROUTERRA_API_KEY を継承していません。設定したターミナルから起動します。/responses の 404 は 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