Codex CLI 到底花多少钱
套餐登录 vs API Key、自动缓存、agent 会话的 token 数学——OpenAI 编程代理的成本全景,不靠猜。
Codex CLI 用户分两派:用 ChatGPT 套餐登录的从来没见过 token 计数,用 API Key 的满眼都是 token 计数。两派都在猜——套餐派看不见表,API 派看不懂模型行为。这篇讲清 Codex CLI 的成本全景:两种模式各计什么费、token 实际花在哪、以及为什么 agent 会话和聊天的账单形状完全不同。
先说明:我运营 Teapot Router,一个同时服务 Codex CLI 与 Claude Code 的网关(OpenAI 兼容 + Anthropic 双协议)。下面的机制适用于任何 OpenAI 兼容端点——不依赖你用不用我们的。
两种模式,两种计量现实
Codex CLI 有两种计费底层完全不同的运行模式。套餐登录:用量包含在 ChatGPT 订阅里直到限额,你看到的是配额指示而不是账单——便宜直到撞墙,然后被限流。API Key 模式:每个 token 按模型计价,成本问题真正活在这里。需要看清工作成本的团队跑 API Key 模式;只需要把活干完的团队用套餐直到限额咬人。搞清自己在哪一派,是所有 Codex 成本对话的第一步。
agent 会话的 token 去哪了
Codex 会话不是聊天,是工具调用、读文件、改代码的循环,每一轮都重发工作上下文。所以账单由和所有编码 agent 相同的三个变量驱动:
- 每任务轮次——agent 是迭代式的,一次重构是几十次计费往返,不是一个 prompt。
- 上下文增长——每次读文件和工具结果都会跟着后面的轮次走;第 20 条消息要为第 1-19 条再付一遍钱。
- 缓存行为——OpenAI 对重复的稳定前缀自动打折;你不用调它,但会话形状决定账单里多大比例享受折扣。
自动缓存做的那笔交易
OpenAI 的 prompt 缓存零配置:稳定的重复前缀命中即折扣。代价是控制权——折扣在会话形状碰巧缓存友好时才有,你没法像 Anthropic 式缓存那样打标引导。实际推论:会话纪律(任务切边界、开新会话、保持前缀无聊稳定)对有效费率的影响超过模型选择,而且上下文乱起来没有任何旋钮能补救。
让 Codex 走网关
API Key 模式也是可路由的模式:改一个 base_url,Codex 就指向任何 OpenAI 兼容端点。团队正是在这里放网关——共享额度池替代每人一把 Key,逐请求计量(模型/tokens/缓存命中/精确费用)替代月度谜题,组织级费用汇总。计费就是意义所在:套餐模式藏起工作的成本,计量的网关把成本按任务、按 Key、按项目摆出来。
刻意选模式:套餐=含量但黑盒,API Key=计量可审计。然后管好决定 API 账单的三个变量——轮次、上下文增长、缓存友好的会话形状——在 agent 编程里它们压倒一切。
常见问题
ChatGPT 套餐用 Codex CLI 免费吗?
用量包含在套餐里直到限额——你付订阅费不按 token 付,超限是限流不是账单。重负载最后基本都会进 API Key 模式。
Codex 会话有 prompt 缓存吗?
有——OpenAI 端点对重复的稳定前缀自动折扣。无需配置;会话形状(任务切边界、上下文稳定)决定账单多大比例被折扣。
Codex CLI 能指向自己的端点吗?
能——把 base URL 设成任何 OpenAI 兼容端点。网关在此之上加逐请求计量和团队共享池;协议不变。