Codex CLI
Codex CLI 是 OpenAI 的命令行编程助手,使用 Responses 接口。
准备
- 安装 Codex:
npm install -g @openai/codex - 在控制台创建一个分组为
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_key | Codex 从这个环境变量读取令牌 |
wire_api | 固定为 responses |
然后设置令牌并启动:
bash
export CODINGROUTER_KEY="sk-你的令牌"
codexpowershell
$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。
常见问题
| 现象 | 处理 |
|---|---|
| 401 | CODINGROUTER_KEY 没有在启动 codex 的终端里设置 |
| 404 或返回 HTML | base_url 必须带 /v1 |
| 503 | 模型名写错,或令牌分组里没有这个模型 |
| 仍然要求登录 ChatGPT | model_provider 没有指向 codingrouter,检查 config.toml 位置和拼写 |
