想换一个终端 agent 而不是换一种给 Codex 付费的方式?看 Claude Code vs Codex CLI;候选里还有 OpenCode 的话,看三方横评 OpenCode vs Claude Code vs Codex CLI。国内接入步骤在 Codex CLI 国内接入,「要不要 ChatGPT Plus」在不用 ChatGPT Plus 也能用 Codex CLI。本文只算账:按 token 钱包计费 vs 订阅。
OpenAI 的 Codex CLI 是最好用的终端编程 agent 之一。它把 OpenAI 推理模型的能力直接搬进了终端——自主代码生成、多文件编辑、测试编写,一条命令搞定。用过的人都知道它有多提效。
但问题来了:要用 Codex CLI,你需要一个有余额的 OpenAI 账户或 ChatGPT 套餐。这意味着你得绑定月付计划、搞定国际信用卡支付——对国内开发者来说这本身就是个门槛——还得忍受速率限制在你写代码写到一半时把你卡住。如果 OpenAI API 出了故障?那你只能干等着,没有任何故障转移。
有没有可能用同样的 Codex CLI、同样的模型,但不用绑定订阅?Router One 就是这么干的。
如果你在纠结的正是要不要为此续 ChatGPT Plus,不用 ChatGPT Plus 也能用 Codex CLI 这篇把这条路径单独讲透了。
Router One 改变了什么
Router One 是一个位于 Codex CLI 和模型供应商之间的网关。你不再把 Codex 直接指向 OpenAI 的 API,而是指向 Router One 的 OpenAI 兼容端点。对 Codex 来说,什么都没变——它发同样的请求,收同样的响应。但在背后,你获得了直连所没有的能力:
- 灵活计费——钱包按 token 计费或使用已上线订阅套餐;套餐外用量按实际 token 计量。
- 支持国内支付——用支付宝充值余额(和银行卡在同一个托管收银台),不需要国际信用卡。
- 自动故障转移——遇到符合条件的上游错误(5xx、超时、429 或 529)时,Router One 可以把请求重试到另一条提供同一模型的健康线路;不会换成别的模型,也不是零停机保证(判定规则)。
- 预算管控——为每把 API Key 设置 maxSpend 消费硬上限;请求频率与每分钟 token 限额按平台默认值逐 Key 生效,可申请调高;用独立 Key 隔离项目或开发者。
- 按请求的用量记录——网关发往模型的每个请求的 token 与费用都记入控制台 → 日志。
这一切不需要对 Codex CLI 本身做任何修改。只是在它的配置文件里多注册一个 model provider。
工作原理
Codex CLI 从 ~/.codex/config.toml 读取配置。Router One 提供完全兼容 OpenAI、原生支持 Responses API 的端点,把它注册为 model provider 即可(base_url = "https://api.router.one/v1"、wire_api = "responses"、env_key = "ROUTER_ONE_API_KEY"),并在顶层保留 model = "gpt-5.6-sol"(与一键安装一致)。Codex 说的是 Responses API,这也是只支持 Chat Completions 的中转会对它 404 的原因——见 Codex 与 Responses API。或者直接用一键命令写好配置:
curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-router-one-key
配置就这些。Codex CLI 把请求发给 Router One,Router One 转发到服务你所指定模型的上游线路,响应通过同样的路径返回。可用的模型——包括 openai/gpt-6-astra、openai/gpt-5.6-sol——以实时目录为准,不代表包含厂商直连的全部型号。
详细的配置教程请看 Codex CLI 国内落地页。
成本对比:订阅制 vs 按量付费
来算一笔账。
直接用 OpenAI API(自己充值的 API 账户):
这笔钱是按 token 从一个有余额的 OpenAI 账户里扣的,于是三件事同时成立:你需要国际信用卡去充值、你得一直让账户里躺着余额、每月的数字跟着"每次会话装了多少上下文"走,而不是跟着你跑了多少条命令走。这里不转载各厂商的价目表——它们一直在变,一张过期的表比没有表更糟。
Router One(从钱包按量付费):
- 同样的模型走一个 OpenAI 兼容端点,包含 Codex CLI 默认用的那个推理模型
- 用的是 Router One 自己的挂牌单价——部分模型最低官方价 1 折;实时价格见模型目录
- 用托管收银台里的支付宝或银行卡充值任意金额;FX 与支付通道费用在你确认前单独展示,和 token 费用分开
- 没有最低余额要求,没有月付承诺
- 未使用的余额永久有效
对于每周跑几次 Codex 的轻度用户来说,钱包按量意味着你只为真正跑起来的会话付费,而不是养着一个预充值账户和一份月付承诺。对于重度用户,已上线的订阅套餐提供可预测的月度支出;两种方式你都额外获得了故障转移、预算管控和用量可视化——这些直连 API 是没有的。
简单说:你永远不为没用到的容量付费,还无需额外付费获得了一套否则需要自建代理基础设施才能实现的运维能力。
2 分钟完成配置
配置时间比你读这段文字还短:
第一步——在 router.one 注册并创建 API key。
第二步——用你喜欢的支付方式充值(托管收银台里的支付宝或银行卡,也支持稳定币)。
第三步——用你的 Key 运行一键接入命令:
curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-router-one-key
安装脚本已经把 export ROUTER_ONE_API_KEY=… 追加到你的 shell 配置文件(~/.zshrc、~/.bashrc 或 ~/.profile),新开的终端会自动读取;在当前终端里,先运行 source ~/.zshrc(或对应的配置文件)或新开一个终端,再进行第四步。
第四步——照常运行 Codex:
codex "把这个函数重构成 async/await 写法"
验证方法:跑一条 Codex 命令后去 Router One 控制台 → 日志看看——你应该能看到这条请求的模型、token 数和费用。
无需额外付费的进阶能力
除了基本的代理功能,通过 Router One 路由还给你带来了自己搭建需要几周时间的能力:
自动故障转移。 上游线路返回符合条件的错误(5xx、超时、429 或 529)时,Router One 可以把请求重试到另一条提供同一请求模型的健康线路。有这样的线路时,一次重试只是多花一点时间,而不是一次失败的调用;但并非每种错误都可重试,这也不是零停机保证,所以长时间运行的 Codex 任务仍要能承受偶尔失败的调用。规则见 LLM 故障转移。
预算护栏。 给 API Key 设置 maxSpend 硬上限。Key 达到上限后,请求会被拒绝,而不是继续累积费用。多个开发者或工作负载共享同一钱包时尤其有用。
用独立 Key 隔离项目。 为每个项目创建独立 API Key,分别设置 maxSpend 上限。需要核对项目成本时,在应用日志中保存项目名称与请求 ID 的对应关系。
按请求的可观测性。 网关发往模型的每个 Codex 请求都会出现在 Router One 控制台 → 日志里,附带完整详情——使用的模型、输入输出 token 数、延迟、费用和状态。日积月累,这些数据能揭示使用模式,帮你优化和 Codex 的协作方式。
模型灵活性。 Codex CLI 自带默认模型;经 Router One 使用时,在 config.toml 的 model 里填目录中支持 /v1/responses 的当前在售的 GPT 系 ID——全能选 openai/gpt-5.5,小改动想压低单价选 openai/gpt-5.6-terra。想拿不同模型跑 Codex 做对比?基础设施已经支持,不需要额外配置;如果是在 GPT-5.6 Sol 和 Terra 之间选,GPT-5.6 Sol vs GPT-5.6 Terra 会从实时目录渲染两张规格表。
完整的模型列表和定价请查看模型广场。
适合谁用
通过 Router One 使用 Codex 最适合这些场景:
- 国内开发者——无法方便地使用 OpenAI 的支付系统,或者直连 API 网络不稳定。
- 个人开发者——想要按量付费,不想绑定订阅或维护一个预充值的 API 账户。
- 团队用户——为项目或开发者分配独立 Key,并需要按 Key 的消费控制与 Codex 集中用量视图。
- 被 API 故障坑过的人——希望遇到符合条件的上游错误时自动做同模型故障转移,让编码会话少因临时故障而停下。
常见问题
不订阅 OpenAI API 也能用 Codex CLI 吗? 可以。把 Codex CLI 指向 Router One 的 OpenAI 兼容端点,按实际消耗的 token 付费即可——不需要国际信用卡,也没有月费承诺。
如何把 Codex CLI 接入 Router One?
在 ~/.codex/config.toml 里把 Router One 注册为 model provider(base_url = "https://api.router.one/v1"、wire_api = "responses"、env_key = "ROUTER_ONE_API_KEY"),并在顶层保留 model = "gpt-5.6-sol"(与一键安装一致),或直接运行一键接入命令 curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-router-one-key。详细教程见 Codex CLI 国内落地页。
通过 Router One 能用哪些 Codex 模型?
目录中支持 /v1/responses 的当前在售 GPT 系列、DeepSeek 与 Grok 对话模型 id,包括 openai/gpt-6-astra、openai/gpt-5.6-sol。Codex CLI 自带默认模型;在 config.toml 的 model 里填 openai/gpt-5.5(全能)或 openai/gpt-5.6-terra(小改动、单价更低)——完整列表和定价见模型广场。
上游供应商出故障时,我的 Codex 会话会中断吗? 取决于错误类型。遇到符合条件的上游错误(5xx、超时、429 或 529)时,Router One 可以把请求重试到另一条提供同一请求模型的健康线路;它不会换成别的模型,并非每种错误都可重试,也不是零停机保证,所以长时间的 Codex 会话仍要能承受偶尔失败的调用。见 LLM 故障转移。
没有国际信用卡怎么给 Router One 充值? 用支付宝充值即可,和银行卡在同一个托管收银台,也支持稳定币。未使用的余额永久有效。
开始使用
在 router.one 注册,创建 API key,跑一条一键接入命令,就能开始用按量付费、支持国内支付、自动故障转移的 Codex CLI 了。
详细配置步骤请看 Codex CLI 国内落地页。想了解 Router One 如何全面降低你的 LLM 成本,请阅读我们的降低 LLM API 成本指南。