Codex CLI

OpenAI Codex CLI 是 OpenAI 官方的終端程式設計代理，基於 OpenAI Responses API。通過 WRouter 接入後，可以用同一把金鑰同時排程 GPT-5.5 與 Claude、Gemini 等非 OpenAI 模型。

前置要求

項	要求
Codex CLI	≥ 0.5（命令為 codex）
Node.js	≥ 20（如通過 npm 安裝）
WRouter	一把可用 Token

安裝

npm i -g @openai/codex

# 驗證
codex --version

配置

1. 編輯 ~/.codex/config.toml

model_provider = "wrouter"
model = "gpt-5.5"

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

欄位說明：

欄位	含義
base_url	WRouter OpenAI 相容端點，必須帶 /v1
wire_api	"responses"（推薦，OpenAI Agentic 協議）或 "chat"（Chat Completions）
env_key	從該環境變數讀取 API key

2. 設定環境變數

# macOS / Linux
export WROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Windows (PowerShell)
[Environment]::SetEnvironmentVariable("WROUTER_API_KEY", "sk-xxxx...", "User")

驗證

codex

啟動後輸入 /status，應看到：

Provider:    wrouter
Model:       gpt-5.5
Endpoint:    https://wrouter.ai/v1
Wire API:    responses

發起測試呼叫：

> What files are in the current directory?

期望：Codex 呼叫 shell 工具並展示結果。

推薦模型

模型	wire_api	適用
gpt-5.5	responses	主力，原生 Agentic 支援最佳
o3	responses	推理密集
gpt-5.4	responses 或 chat	通用日常
claude-sonnet-4-6	chat ⚠️	Claude 用 chat 協議更穩
gemini-2.5-pro	chat ⚠️	同上

會話中臨時切換模型：

/model claude-sonnet-4-6

⚠️ 重要：切到非 OpenAI 模型時，建議在 config.toml 裡同時改 wire_api = "chat"，否則部分 Agentic 行為（多步工具迴圈）可能降級。最佳實踐是按 provider 複製多組配置：

[model_providers.wrouter-chat]
name = "wrouter (chat)"
base_url = "https://wrouter.ai/v1"
wire_api = "chat"
env_key = "WROUTER_API_KEY"

# 然後用 codex --provider wrouter-chat 切換

故障排查

現象	可能原因	處理
401 Unauthorized	WROUTER_API_KEY 沒設 / 錯誤	echo $WROUTER_API_KEY，並確認 toml 裡 env_key 與之一致
404 或 unsupported wire_api	模型不支援 Responses 協議	改 wire_api = "chat"，或換支援 Responses 的模型
響應空白 / 卡住	wire_api 與模型不匹配	同上
亂碼 / 工具呼叫失敗	Codex 版本過舊	npm i -g @openai/codex@latest
Status: rate_limit_exceeded	觸發 WRouter 限流	控制台調整 RPM 上限

已知限制

• Codex 部分高階特性（如 web_search 內建工具）依賴 OpenAI 官方專屬上游；通過 WRouter 呼叫非 OpenAI 模型時這些工具不可用。
• wire_api = "responses" 僅在模型本身支援 Responses 協議時生效，目前主要是 OpenAI 自家 GPT-5.x / o-series 系列。