Codex CLI 价格完整指南:免费额度、API 计费与省钱技巧

Codex CLI 到底要不要收钱?一次性说清楚:订阅额度、API 按量计费、各模型价格对比,以及让成本降到最低的实用技巧。

TL;DR

Codex CLI 目前免费使用,通过 ChatGPT Plus/Pro 订阅附带的 API 额度驱动;独立 API 用户按 token 计费,o4-mini 约 $1.10 / 百万输入 token。普通开发者月均花费通常不超过 $5。

概览:Codex CLI 免费吗?

Codex CLI 本身是开源免费的工具,但运行它需要调用 OpenAI 的模型 API,而这个调用是有成本的。根据你的账号类型,有两种完全不同的使用模式:

  • 模式 ①:ChatGPT Plus / Pro 订阅 — 订阅附赠 API 额度,每月固定,在额度范围内不额外付费,超额后请求会被限速(不会悄悄扣钱)。
  • 模式 ②:独立 API Key — 在 platform.openai.com 充值,按实际消耗的 token 数量付费,弹性灵活,适合用量不稳定的开发者。

截至 2025 年,ChatGPT Plus($20/月)已包含 Codex CLI 的使用额度,Pro 订阅($200/月)额度更高,可支持重度使用场景。如果想完全免费体验,注册新 OpenAI 账号后通常会获得一定试用额度。

i

Codex CLI 工具本身永久免费开源:github.com/openai/codex。你付费的是背后的 AI 模型调用,而不是软件本身。

ChatGPT Plus / Pro 权益

如果你已经是 ChatGPT Plus 或 Pro 订阅用户,配置 Codex CLI 只需以下几步,无需单独充值:

  1. 登录 platform.openai.com/api-keys,点击「Create new secret key」生成 API Key。
  2. 在终端运行 codex login,按提示选择「API Key」方式。
  3. 粘贴刚才生成的 API Key,按回车确认。
  4. 运行 codex 启动,发送一条测试消息确认可以正常使用。
注意

Plus 订阅的附带额度用尽后,请求会被限速(返回 429 错误),而不会额外从你的信用卡扣费。遇到 429 时,可以等额度重置(通常按月),或切换到独立充值的 API Key 继续使用。

套餐 月费 Codex CLI 额度 最适合
Free $0 新账号试用额度(有限) 体验尝鲜
Plus $20 / 月 适中(满足日常开发使用) 个人开发者
Pro $200 / 月 高(支持重度使用) 专业团队 / 重度用户
独立 API 按用量 无上限(按 token 付费) 灵活按需付费

独立 API 计费详情

如果使用独立 API Key(非订阅附带),Codex CLI 会按实际消耗的 token 数量计费。默认模型为 o4-mini(推理优化,性价比最高),以下是 2025 年各主要模型的价格(以 OpenAI 官网为准,随时可能调整):

模型 输入价格 输出价格 适用场景
o4-mini(默认) $1.10 / 1M tokens $4.40 / 1M tokens 日常编码、调试
o3 $10.00 / 1M tokens $40.00 / 1M tokens 复杂架构、深度推理
gpt-4.1-mini $0.40 / 1M tokens $1.60 / 1M tokens 简单任务、省钱优先

可以在 ~/.codex/config.toml 中切换默认模型,以 gpt-4.1-mini 为例:

~/.codex/config.toml
# 切换到更便宜的模型
[model]
name = "gpt-4.1-mini"   # 更便宜的替代方案

也可以在单次命令中临时指定模型,无需修改配置文件:

终端
$ codex --model gpt-4.1-mini "解释这段代码"
i

Token 换算参考:1000 token ≈ 750 个英文单词 ≈ 约 500 个汉字。一次普通的代码问答(包含上下文)通常消耗 500 ~ 3000 tokens。

实际使用成本估算

以 o4-mini($1.10/1M 输入 + $4.40/1M 输出)为基准,以下是常见使用场景的成本参考:

使用场景 每次 token 消耗(估算) 单次 o4-mini 成本
解释一个函数 ~500 tokens ~$0.0006
修复一个 bug ~1,500 tokens ~$0.002
生成完整功能模块 ~5,000 tokens ~$0.006
一个工作日(50 次请求) ~75,000 tokens ~$0.09
一个月(工作日 × 22) ~1,650,000 tokens ~$2.00

普通个人开发者使用 o4-mini 模型,月花费通常低于 $5。如果切换到 gpt-4.1-mini,成本可再降低约 65%,适合日常代码任务。

省钱技巧

通过合理配置,可以在保证使用体验的前提下大幅降低 API 费用:

  1. 按任务选模型:简单任务用 --model gpt-4.1-mini,节省 60% 以上费用;复杂推理再切回 o4-mini 或 o3。
  2. 配置 max_tokens 限制单次输出:避免模型生成过多不必要的内容,减少输出 token 消耗。
    ~/.codex/config.toml
    [model]
    max_tokens = 2048   # 根据需要调整
  3. /clear 清空上下文:对话越长,下一次请求携带的输入 token 越多。用 /clear 开始新话题,避免无效上下文堆积。
  4. 开启 approval_policy = "untrusted-only":减少 Codex 自动调用工具的频率,每次工具调用都会产生额外 token 消耗。
    ~/.codex/config.toml
    approval_policy = "untrusted-only"
  5. 监控实时用量:定期登录 platform.openai.com/usage 查看费用明细,并设置用量上限(Hard limit)防止意外超支。

免费试用方案

如果你还没有 OpenAI 账号,或者想在付费前先体验,可以利用以下方案:

  • 新账号试用额度:注册 OpenAI 账号后通常会获得 $5 ~ $18 的免费额度(具体金额见官网,随时变化,不定期发放)。这笔额度可以支持数百次 Codex CLI 请求。
  • 学生 / 教育计划:OpenAI 不定期开放学生认证或教育机构合作计划,可获得额外额度,具体以官网公告为准。
  • ChatGPT Plus 14 天内体验:Plus 订阅首月可退款(部分地区),可以在此期间充分体验后决定是否继续。
警告

永久「完全免费」的 Codex CLI 方案不存在。请警惕声称能「破解免费」或「无限免费调用」的第三方工具——这类工具存在泄漏你的 API Key、滥用你账号额度的风险,请不要轻信。

常见问题

Codex CLI 完全免费吗?

不完全免费。Codex CLI 工具本身是开源免费的,但运行需要调用 OpenAI 模型 API。ChatGPT Plus/Pro 订阅者有附带额度,在额度范围内不额外付费;独立 API 用户按 token 计费;新账号有一次性试用额度。

ChatGPT Plus 的 Codex CLI 额度够用吗?

对于普通个人开发者(每天几十次请求)通常够用。重度使用者(每天数百次请求、大量代码生成)可能在月末遭遇限速,需要 Pro 订阅或独立充值 API 用量。

怎么知道我用了多少额度?

登录 platform.openai.com/usage 即可查看实时用量和每日费用明细。建议同时在「Billing → Usage limits」里设置 Hard limit 上限,防止意外超支。

能用 ChatGPT 免费账号使用 Codex CLI 吗?

不能直接使用。Codex CLI 需要 API Key,而不是 ChatGPT 网页账号密码。免费账号可以在 platform.openai.com 申请试用额度,但额度有限,用完后需付费充值才能继续。

切换到 gpt-4.1-mini 会影响 Codex CLI 质量吗?

对于简单代码任务(解释函数、修复小 bug、格式化代码),gpt-4.1-mini 的质量与 o4-mini 非常接近,且价格低 2-3 倍,性价比很高。对于复杂推理任务(架构设计、多步骤规划、难度较高的算法)会有明显下降,这类场景建议坚持使用 o4-mini 或 o3。