Codex CLI

為 Codex CLI 設定 Responses provider 與終端 API 金鑰。

安裝與準備

  1. 安裝 Node.js，再執行下方命令安裝官方 Codex CLI。在新終端執行 codex --version。
  2. 在 routerra.ai → API 金鑰建立金鑰，從模型列表選擇支援 Responses API 和工具呼叫的完整模型 ID。僅支援 Chat Completions 的模型無法使用此設定。
npm install -g @openai/codex
codex --version

定義 TOML provider

  1. 編輯 ~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml），合併下方 TOML，避免重複既有 provider 表。model_provider 必須對應 routerra；env_key 填環境變數名稱而非金鑰。替換 YOUR_MODEL_ID。
  2. 在啟動 codex 的同一終端匯出 ROUTERRA_API_KEY。命令僅對目前終端有效，需要保留時寫入 shell 設定。此自訂 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 時檢查位址與協定：僅保留一個 /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