Skip to content

Codex CLI ​

Codex CLI 是 OpenAI 的命令行编程助手,使用 Responses 接口。

准备 ​

  1. 安装 Codex:npm install -g @openai/codex
  2. 在控制台创建一个分组为 codex_gpt(价格最低)或 gpt 的令牌。

配置 ​

编辑 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml),没有就新建:

toml
model = "gpt-6.1-sol"
model_provider = "codingrouter"
model_reasoning_effort = "high"

[model_providers.codingrouter]
name = "CodingRouter"
base_url = "https://api.codingrouter.ai/v1"
env_key = "CODINGROUTER_KEY"
wire_api = "responses"
配置项说明
model默认模型,如 gpt-6.1-sol、gpt-5.5
model_reasoning_effort推理强度:low、medium、high
base_url必须带 /v1
env_keyCodex 从这个环境变量读取令牌
wire_api固定为 responses

然后设置令牌并启动:

bash
export CODINGROUTER_KEY="sk-你的令牌"
codex
powershell
$env:CODINGROUTER_KEY = "sk-你的令牌"
codex

要长期生效,把 export 加到 ~/.zshrc 或 ~/.bashrc。

验证 ​

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

输出里出现 provider: codingrouter 和 CODINGROUTER OK 即配置成功。

切换模型 ​

启动后输入 /model,或启动时指定:codex -m gpt-5.5。

常见问题 ​

现象处理
401CODINGROUTER_KEY 没有在启动 codex 的终端里设置
404 或返回 HTMLbase_url 必须带 /v1
503模型名写错,或令牌分组里没有这个模型
仍然要求登录 ChatGPTmodel_provider 没有指向 codingrouter,检查 config.toml 位置和拼写