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

3. 编辑 ~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml），合并下方 TOML，避免重复已有 provider 表。model_provider 必须对应 routerra；env_key 填环境变量名而非密钥本身。替换 YOUR_MODEL_ID。
4. 在启动 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