在 Codex CLI 中接入

改 ~/.codex/config.toml，新增一个指向本平台的 provider。

本文介绍如何把 Codex CLI 接到本平台，用同一个令牌调用 Claude、GPT、Gemini 等模型。全程只需要三个值：接入地址、令牌、模型名。

开始之前请先在控制台创建一个令牌（sk- 开头），并确认账户里有余额。还没有令牌的话，先看 5 分钟发出第一个请求。

配置

编辑 ~/.codex/config.toml，加一个自定义 provider 并把它设为默认；密钥从环境变量读，不要写进配置文件。

填哪里	填什么
base_url	`https://api.router.ai/v1`
env_key	`ROUTER_API_KEY`
model	`gpt-5.5`

model = "gpt-5.5"
model_provider = "router"

[model_providers.router]
name = "Router AI"
base_url = "https://api.router.ai/v1"
env_key = "ROUTER_API_KEY"
wire_api = "chat"

# 然后: export ROUTER_API_KEY=sk-你的令牌

验证

配置完先别急着跑复杂任务。让它回答一句「你好」，能正常回话就说明链路通了。想单独确认令牌本身有没有问题，可以在终端直接调一次接口：

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"你好"}]}'

返回 JSON 里有 choices 就是正常的。之后在控制台的计费流水里能看到这笔调用。

常见问题

wire_api 填 chat 或 responses 都能用，本平台两条协议都支持。遇到「不支持 tools + reasoning_effort」这类报错时，优先试 responses。

报 401

令牌填错、多了空格，或者复制时漏了开头的 sk-。重新复制一次完整令牌。

报 404

九成是地址结尾对不上：OpenAI 兼容格式要 /v1 结尾，Anthropic 和 Gemini 原生格式则不要带 /v1。对照上面表格再核一次。

报 402 / 提示余额不足

账户余额不够。见充值方式与到账时间。

模型不存在

模型名必须和平台目录里完全一致（大小写、连字符都算）。在模型广场页可以直接复制准确的名字。

博客