跳转到主要内容
Codex CLI（@openai/codex）是 OpenAI 的 终端编码 agent。较新版本使用 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 菜单选择。