跳到主要内容
注册

OpenAI Codex CLI 国内稳定接入,按 Token 付费

Router One 让 OpenAI Codex CLI 在国内免翻墙、不订 ChatGPT Plus 也能用:在 ~/.codex/config.toml 里加一个 model provider(base_url https://api.router.one/v1、wire_api = "responses",顶层保留 model = "gpt-5.6-sol"),支付宝或银行卡充值钱包后按 Token 计费,每次请求的花费都能在控制台看到。每把 Key 可单独设消费上限,并支持同模型故障转移。

国内直连稳定

基于 2026-05-15 更新的中国延迟基准测试,Router One 在北京、上海、深圳的 p50 延迟为 110-130ms;实际表现会随网络和地区变化。

按 Token 从钱包付费

不用订 ChatGPT Plus。支付宝或银行卡在同一个托管收银台充值,也支持 6 条链上的 USDT/USDC;另可使用 Router One 已上线订阅套餐,套餐外调用按 Codex 实际消耗计费。

同模型故障转移

请求由你指定的模型处理;某条线路出现 429、5xx 或超时时,会换到同一模型的另一条线路重试;持续报上游错误的线路会被自动排到最后,恢复后再回到正常顺序。请求日志展示模型、请求 ID、用量、结算费用、已记录延迟与状态,不公开内部线路。

配置 Codex CLI

运行一键接入命令,或在 ~/.codex/config.toml 里把 Router One 注册为 model provider。

  1. 1创建 Router One API Key在 router.one 注册并创建 API Key。在托管收银台里用支付宝或银行卡充值,也可以用 USDT/USDC,无需 ChatGPT Plus 或境外信用卡。
  2. 2把 Codex CLI 指向 Router One带上你的 Key 运行一键接入命令——自动安装 Codex CLI(如未装)、写入带 Router One provider 的 ~/.codex/config.toml(env_key = ROUTER_ONE_API_KEY)、把 Key 持久化到 shell 配置并验证连通。
  3. 3启动 Codex CLI照常运行 Codex CLI,请求即通过 Router One 国内可直连的 OpenAI 兼容端点路由,按 Token 从钱包计费;用套餐时,套餐档位列出的模型先扣套餐额度。
terminal
# 通过 Router One 使用 Codex CLI
curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-router-one-key
查看 Codex CLI 平替完整指南查看中国延迟基准测试

常见问题

还需要 ChatGPT Plus 订阅吗?

不需要。Codex CLI 用 Router One 的 Key 接入,按 Token 从钱包扣费;用 Pro、Max、Ultra 套餐时先扣套餐额度:按 2026-10-15 的套餐接口,一键安装写入的 gpt-5.6-sol 与 Codex 0.159.1 起在 config.toml 没写 model 时自选的 gpt-6.1-sol,连同 gpt-6-sol,都在三个套餐的「高级模型」档。超出某一档额度的调用以及套餐覆盖范围外的用量,按公示单价从钱包扣费;各套餐的额度见 /pricing。

现有 Codex 配置还能用吗?

可以。Router One 只是 ~/.codex/config.toml 里新增的一个标准 model provider(base_url 为 https://api.router.one/v1、wire_api = "responses"、Key 走 ROUTER_ONE_API_KEY 环境变量)。Codex 走 Responses API,请选择详情页列出 POST /v1/responses 的模型——GPT、DeepSeek V4 与 Grok 对话模型;Claude 的 ID 会返回 400,请改用 Claude Code。哪些 Responses 特性可用、哪些会被拒,见 Codex Responses API 页(/codex-responses-api)。

config.toml 里写 gpt-5.6-sol、gpt-6-sol 还是 gpt-6.1-sol?

一键安装写入的是 model = "gpt-5.6-sol"。三个 ID 都在 /v1/responses 上原生服务(Codex 从 0.159.1 起才在内置模型列表里收录 gpt-6.1-sol),而且按 2026-10-15 的套餐接口,三者都在 Pro、Max、Ultra 三个套餐的「高级模型」档:用套餐时,Codex 发给其中任何一个的请求都从这一档共用的额度里扣,超出额度后按公示单价从钱包扣费。所以选哪个看模型本身,与套餐无关,可以在 /models 对比。按 0.159.1 的发布说明与 rust-v0.160.1 的内置模型列表(2026-10-06 核对),Codex 0.159.1 及以后把 gpt-6.1-sol 设为内置模型列表的默认模型;按 Codex 的模型文档,这个默认只在 config.toml 没写 model 时生效。仍建议写上 model 行,免得 Codex 以后改默认模型时把会话换到别的档位——按这些版本的内置模型列表(2026-10-06 核对),0.153.4 至 0.159.0 的默认就是只有 Max 与 Ultra 才覆盖的 GPT-6 Astra。

Codex 启动时提示「Meet GPT-6 Sol」,要切换吗?

按 Codex 源码(内置 models.json 的 upgrade 字段,0.156.1 及以后;2026-10-15 按 rust-v0.162.1 复核),模型为 gpt-5.6-sol 或 gpt-5.6-terra 时,Codex 可能在启动时弹出「Meet GPT-6 Sol」提示,建议换成 gpt-6-sol(不是 gpt-6.1-sol);源码并未把这个提示限定在内置的 OpenAI provider 上,接 Router One 时也可能出现。接受后模型就变成 gpt-6-sol,Router One 提供这个模型。按 2026-10-15 的套餐接口,gpt-6-sol 与 gpt-5.6-sol 都在 Pro、Max、Ultra 三个套餐的「高级模型」档,gpt-5.6-terra 在「中级模型」档:用套餐时,从 gpt-5.6-sol 切过去扣的仍是同一份额度,从 gpt-5.6-terra 切过去则改扣「高级模型」额度,而每个套餐的「高级模型」额度都比「中级模型」少。想保留当前模型,在提示里选「Use existing model」;接受的话,gpt-6-sol 会被存为默认模型。按同一份源码,Codex 0.159.1 及以后还可能在启动时提示试用 GPT-6.1 Sol;这条提示不会改动你的模型。

Codex 里还能用 GPT-5.5 吗?

截至 2026-10-15 的模型目录,Router One 已不再列出 GPT-5.5(openai/gpt-5.5),config.toml 里仍写着 gpt-5.5 的话,需要换成 /models 里列出的模型;怎么选,见上面关于 config.toml 该写哪个模型的那一问。

Codex 提示 The '…' model is not supported when using Codex with a ChatGPT account,是 Router One 的报错吗?

不是。这句话本身说明请求走的是 Codex 的 ChatGPT 账号登录,而这种登录不支持报错里点名的模型:Codex 源码自带的测试(rust-v0.162.1,2026-10-15 核对)把它用作服务端对 ChatGPT 账号登录会话的回复,测试以 gpt-5.5 为例模拟已退役的模型;按 OpenAI 的 Codex 定价页(2026-10-15 核对),GPT-5.5 已于 2026 年 10 月 14 日 19:00(UTC)起在用 ChatGPT 账号登录的 Codex 中退役,OpenAI API 以及用 API Key 认证的 Codex 会话不受影响。按 Codex 的认证文档(2026-10-15 核对),自定义 model provider 配了 env_key 时,使用该环境变量里的 API Key;所以把 Router One 配成 Codex CLI 的 model provider(env_key = "ROUTER_ONE_API_KEY",并写顶层 model = "gpt-5.6-sol",与一键安装写入的一致)后,请求用你的 Router One Key 发往 https://api.router.one/v1,不经过 ChatGPT 登录。依赖某个模型之前,先到 /models 查看它的套餐覆盖。这条报错的完整排查步骤见 Codex 模型不支持报错排查页(https://router.one/zh/codex-model-not-supported)。

国内延迟怎么样?

基于 2026-05-15 更新的中国延迟基准测试,Router One 在北京、上海、深圳的 p50 延迟为 110-130ms;实际表现会随网络和地区变化。

可以设置预算上限吗?

可以。为每个项目或工具创建独立 API Key,再在控制台为这把 Key 设置 maxSpend 上限;控制台 → 日志里每个请求的 Trace 会显示 Token 与费用。

按 Codex 工作流选择下一步

Codex CLI 配好之后,你可能还需要:多工具统一管控、Responses API 兼容说明、充值,以及 Claude Code 配置。

工作流总页给每种编程工具独立设置预算Codex、Claude Code、Cursor 或其他客户端可各用一把 Key,钱包与成本视图仍统一。故障排查理解 Codex Responses API 错误当中转仅兼容 Chat Completions、而 Codex 需要原生 Responses API 时,从这里排查。故障排查排查 Codex「model is not supported」报错Codex 的 ChatGPT 登录拒绝某个模型时:先确认登录方式,再让本地会话走带 env_key 的自定义 provider。配置指南一键配置 Codex CLI运行 sh 或 PowerShell 一键脚本,或手动在 ~/.codex/config.toml 里写 provider 配置(env_key)。桌面应用用 CC Switch 图形化配置(免环境变量)用免费的桌面应用图形化配置 Codex 接入,不用手动改 config.toml。成本降低 GPT 调用单价部分 GPT 模型最低官方价 1 折——看 Codex 流量如何套用上限与 trace。套餐对比订阅套餐与按量付费选 Codex 模型前先看各套餐档位覆盖哪些模型;不在套餐覆盖范围内的调用按量从钱包扣费。接口参考确认 Responses API 请求字段Codex CLI 发送的 /v1/responses 字段、原生支持范围与会返回 400 的项。充值用支付宝给 Codex 钱包充值支付宝入账到 Codex 按 Token 调用使用的同一个 Router One 钱包。另一种 CLI改用 Claude CodeClaude Code 有独立的 Anthropic 兼容环境变量配置路径。对比Claude Code vs Codex CLI 如实对比还没决定用哪个 CLI?按工作流拆解两者各自真正擅长的场景。横评OpenCode vs Claude Code vs Codex CLI三个终端编程 agent 用同一把 Key,按工作流选。
更多 Codex CLI 指南(4)

开始在国内使用 Codex CLI

立即接入