跳轉到主要內容
Codex CLI（@openai/codex）是 OpenAI 的 終端編碼代理。較新版本使用 OpenAI Responses API。
協定：OpenAI Responses API
  • base URL： https://api.orcarouter.ai/v1（包含 /v1）
  • wire_api： 必須為 "responses"——目前的 Codex 版本已移除較舊的 "chat" 值
  • OrcaRouter 已實作 /v1/responses，因此開箱即用

​
安裝

npm install -g @openai/codex

​
設定

編輯 ~/.codex/config.toml： 
model = "orcarouter/auto"
model_provider = "orcarouter"

[model_providers.orcarouter]
name = "OrcaRouter"
base_url = "https://api.orcarouter.ai/v1"
wire_api = "responses"
env_key = "ORCA_KEY"
接著匯出設定所引用的密鑰： 
export ORCA_KEY="sk-orca-..."

​
執行

codex exec --skip-git-repo-check "Reply with exactly: OK"

​
注意事項

  • 模型名稱使用 vendor/model 格式；orcarouter/auto 最簡單。
  • 在 Windows 上，Codex 在 WSL2 下執行。
VS Code 擴充功能： OpenAI 官方的 Codex 擴充功能會在編輯器內執行 CLI， 並共用同一份 ~/.codex/config.toml——沒有獨立的編輯器內端點設定。（GitHub Copilot 內的 Codex 是另一項不同的產品，它使用 Copilot 自己的帳戶，無法以 BYOK 方式接入 OrcaRouter。）

​
啟用思考／推理

在 config.toml 中設定 model_reasoning_effort（minimal ／ low ／ medium ／ high ／ xhigh；預設 medium），或在互動式工作階段的 /model 選單中 選擇。