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 账号后通常会获得一定试用额度。
Codex CLI 工具本身永久免费开源:github.com/openai/codex。你付费的是背后的 AI 模型调用,而不是软件本身。
ChatGPT Plus / Pro 权益
如果你已经是 ChatGPT Plus 或 Pro 订阅用户,配置 Codex CLI 只需以下几步,无需单独充值:
- 登录 platform.openai.com/api-keys,点击「Create new secret key」生成 API Key。
- 在终端运行
codex login,按提示选择「API Key」方式。 - 粘贴刚才生成的 API Key,按回车确认。
- 运行
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 为例:
# 切换到更便宜的模型
[model]
name = "gpt-4.1-mini" # 更便宜的替代方案
也可以在单次命令中临时指定模型,无需修改配置文件:
$ codex --model gpt-4.1-mini "解释这段代码"
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 费用:
-
按任务选模型:简单任务用
--model gpt-4.1-mini,节省 60% 以上费用;复杂推理再切回 o4-mini 或 o3。 -
配置
max_tokens限制单次输出:避免模型生成过多不必要的内容,减少输出 token 消耗。[model] max_tokens = 2048 # 根据需要调整 -
用
/clear清空上下文:对话越长,下一次请求携带的输入 token 越多。用/clear开始新话题,避免无效上下文堆积。 -
开启
approval_policy = "untrusted-only":减少 Codex 自动调用工具的频率,每次工具调用都会产生额外 token 消耗。approval_policy = "untrusted-only" - 监控实时用量:定期登录 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。