OpenAI 在 2026 年 4 月底通过 Codex CLI 0.128.0 推出了一项被开发者圈热议的新功能——Codex Goal 模式 (/goal)。它不是普通的"一次问答一次响应"，而是一个真正的自主智能体循环：你下达一个目标 (例如"把这个 Python 项目从 Pydantic v1 迁移到 v2 并跑通所有测试")，Codex 会自动进入 plan → act → test → review → iterate 的不间断循环，不达目的不罢休，直到目标验证完成或耗尽 Token 预算。
但很多国内开发者上手后会遇到三个共同问题：Goal 模式必须在 ChatGPT 订阅鉴权下才能用？$100/月的 Pro 是不是值？API 中转站能不能跑 Goal 模式？ 这三个问题的答案直接决定了你是不是真的能用上这个新功能。
本文将从工作原理、订阅方案、国内使用路径三个维度，把 Codex Goal 模式讲彻底，给出一套可落地的最佳实践方案。
一、Codex Goal 模式是什么：真正的自主任务智能体
要理解 Codex Goal 模式的价值，先要把它和普通 Codex 模式的差别说清楚。
1.1 Goal 模式与普通 Codex 模式的核心区别
普通 Codex 模式是"单回合任务"：你给 prompt，Codex 给响应，做完就停。如果任务没做完，你要手动追问、手动指出问题、手动让它继续。
Goal 模式是"持久化目标驱动"：你定义一个可验证完成的目标，Codex 自动循环执行，直到它自己评估目标已达成 (或预算耗尽)。整个过程中你不需要再敲一次键盘。
| 对比维度 | 普通 Codex 模式 | Codex Goal 模式 |
|---|---|---|
| 任务粒度 | 单回合 prompt | 长跨度目标 (Long-horizon) |
| 中断恢复 | 中断即结束 | 中断后可 resume，目标状态持久化 |
| 失败处理 | 失败就停 | 自动 plan → act → test → review → iterate |
| 终止条件 | 单次响应完成 | 目标验证完成 / Token 预算耗尽 / 手动 clear |
| 适用场景 | 写一个函数、改一个 bug | 重构、迁移、多文件 feature 开发 |
| 鉴权要求 | API Key 或 ChatGPT 订阅 | 必须 ChatGPT 订阅鉴权 |
| 上手命令 | codex "你的需求" |
codex 进入 TUI 后输入 /goal |
可以看到 Goal 模式不是参数变化，而是Codex 智能体范式的升级：从"工具型助手"进化成"自主代理人"。
💡 关键提醒：Goal 模式的 ChatGPT 订阅鉴权要求是后续讨论的核心。这意味着用 OpenAI 官方 API Key 或者第三方 API 中转站，都无法启用 /goal 命令。本文第六章会详细解释为什么。
1.2 Goal 模式的 5 大核心特性
基于 Codex CLI 0.128.0 的 release notes，Goal 模式具备以下 5 个工程级特性：
- 持久化目标 (Persistent Goal): 目标状态保存在 app-server 中，跨会话、跨终端都能 resume
- 预算感知 (Budget Aware): Token 预算耗尽时是 "soft stop"，会被标记为
budget_limited，并触发 wrap-up steering 而不是粗暴中断 - TUI 控制台: TUI 中可直接 create / pause / resume / clear 当前目标
- 运行时延续 (Runtime Continuation): 不需要每个回合敲键盘，CLI 会自动延续工作
- 中断友好: 你可以 Ctrl+C 中断，Goal 状态自动保留，重新进 TUI 后会自动恢复
这 5 个特性合起来，让 Goal 模式真正具备了"跑一夜也能继续跑"的工程可用性，而不是 demo 级别的概念演示。
二、Codex Goal 模式的工作原理：Ralph Loop 落地
OpenAI 内部把 Goal 模式的循环叫做 Ralph Loop。它不是简单的"失败重试"，而是一个带评估、带规划、带测试的闭环。
2.1 Goal 模式的 5 阶段循环
每一轮循环 Codex 都会走完以下 5 个阶段：
每个阶段的具体工作如下：
- Plan (规划): Codex 把高层目标拆成可执行的子任务列表，并标注成功判定标准
- Act (执行): 按照计划修改代码、安装依赖、调用 shell 命令
- Test (测试): 运行单元测试、lint、构建命令，收集失败信息
- Review (评审): 评估当前进展是否接近目标，识别新出现的阻塞
- Iterate (迭代): 基于 Review 结果生成下一轮 Plan，回到第一步
2.2 Goal 模式的终止条件
不是所有循环都会无限跑下去。Goal 模式有 3 个明确的终止条件：
- 目标达成: Codex 自评 success criteria 全部通过 → 输出最终总结后退出
- Token 预算耗尽: 触发
budget_limitedsoft stop，Codex 会用剩余 Token 做 wrap-up，写一个进度报告再退出 - 手动 clear: TUI 中输入
/goal clear或Ctrl+C后选择终止
⚠️ 预算控制小贴士：默认 Token 预算可能在大型项目下很快耗尽。建议通过
/goal budget <tokens>显式设置预算上限，避免某个错误判断导致 Codex 在错误方向上消耗大量 Token。
三、Codex Goal 模式快速上手：5 步开启自主任务
光说原理没用，下面给出可以立刻照做的上手流程。前提是你已经有 ChatGPT Pro 或更高级别的订阅 (具体方案见第五章)。
3.1 第 1 步：升级 Codex CLI 到 0.128.0+
Goal 模式从 Codex CLI 0.128.0 开始引入，老版本不可用。先确认版本：
codex --version
# 如果低于 0.128.0，升级：
npm install -g @openai/codex@latest
# 或者通过 brew
brew upgrade codex
3.2 第 2 步：使用 ChatGPT 订阅鉴权登录
Goal 模式必须使用 ChatGPT 订阅鉴权 (而不是 API Key)：
codex login
# 选择 "Sign in with ChatGPT"
# 浏览器会打开授权页面，用 ChatGPT Pro 账号登录
登录成功后，Codex 会从你的订阅 plan 限额中扣减用量，不会按 API Token 单独计费。
3.3 第 3 步：进入 TUI 并定义目标
cd /your/project
codex
# 进入 TUI 后输入：
/goal Migrate this codebase from Pydantic v1 to v2, fix all type errors, and ensure all tests pass.
写好 Goal 的 3 个原则：
- 目标必须可验证: 例如"所有测试通过"、"无 lint 错误"，而不是"代码更优雅"
- 明确边界: 例如"只动 src/ 目录，不动 tests/"，避免 Codex 自由发挥过度
- 给出退出条件: 如果有时间限制，可以加上"如果某步失败超过 3 次则停止"
3.4 第 4 步：监控 Codex 自主执行
设定 Goal 后，Codex 会自动开始 Ralph Loop。TUI 中你能看到：
- 当前步骤 (Plan / Act / Test / Review / Iterate)
- 已消耗的 Token 数
- 当前迭代轮数
- 阶段输出 (代码 diff、测试结果)
你可以暂时离开，Codex 会自己跑下去。需要插手时随时可以：
/goal pause # 暂停当前 Goal
/goal resume # 恢复
/goal status # 查看当前进度
/goal clear # 清除当前 Goal
3.5 第 5 步：完成后的成果验收
当 Goal 完成或被预算限制中止后，Codex 会输出一份最终报告，包括：
- 所有修改的文件列表
- 实际跑过的测试与结果
- 自评的目标达成度
- 剩余可优化项 (用于下一轮 Goal)
💡 第一次试用建议：先用一个 30 分钟以内能完成的小目标试水，例如"给项目加上 ruff 配置并修复所有 lint 警告"。熟悉流程后再交给 Codex 跑长跨度任务。如果你只是想小量体验下 Codex 系列的非 Goal 能力，可以先通过 API易 apiyi.com 调用 Codex 模型 API 做一些原型验证，正式跑 Goal 模式再升级到 ChatGPT Pro 订阅。
四、Codex Goal 模式实战场景：5 类最适合的任务
不是所有任务都适合用 Goal 模式。基于早期社区反馈，以下 5 类任务是 Goal 模式的高 ROI 场景。
4.1 大版本迁移类任务
典型例子: Pydantic v1 → v2、Vue 2 → Vue 3、Webpack 4 → 5
这类任务的特点是：改动多文件、有明确的成功判定 (测试通过)、单点容易但全面繁琐。Goal 模式的迭代循环非常适合这种"改一处出一个错改下一处再出错"的任务。
4.2 测试覆盖率提升任务
典型 Goal: "把 src/services/ 目录的测试覆盖率从 45% 提升到 85%，所有测试用例必须真实有效不能空测"
Codex 会循环：写测试 → 跑覆盖率 → 看哪个文件还没覆盖 → 写下一批测试，直到达标。
4.3 大规模重构任务
典型 Goal: "把这个 monorepo 中所有用 axios 的地方改成 fetch + 自定义 wrapper，保持错误处理逻辑等价"
这种任务有明确成功判定 (跑通测试)，但需要修改几十甚至上百个文件，人工做完全不现实。
4.4 Bug 排查与修复
典型 Goal: "Issue #1234 中描述的并发死锁问题：复现、定位、修复，并新增至少 1 个回归测试"
Codex 会自己写复现脚本、加日志、定位、修复、写测试，整个流程闭环。
4.5 文档生成与同步
典型 Goal: "为 src/api/ 下所有公开导出的函数补全 JSDoc 注释，并基于注释生成 docs/api.md"
Goal 模式可以把"扫文件 → 写注释 → 跑文档生成器 → 检查输出"整个流程自动化。
五、ChatGPT 订阅方案选择：为什么 $100 Pro 是最佳解
Goal 模式必须用 ChatGPT 订阅鉴权，那订哪一档最划算？这是落地 Goal 模式的核心决策。
5.1 ChatGPT 各档位的 Codex 用量对比
| 订阅档位 | 月费 (美元) | Codex 用量限额 | Goal 模式 | 模型版本 | 性价比评分 |
|---|---|---|---|---|---|
| Free | 0 | 极少 | ❌ | 基础版 | ⭐ |
| Plus | 20 | 1× (基准) | ✅ | GPT-5.4 | ⭐⭐⭐ |
| Pro $100 | 100 | 10× Plus (5/31 前促销 / 之后 5×) | ✅ | GPT-5.4 / 5.5 | ⭐⭐⭐⭐⭐ |
| Pro $200 | 200 | 20× Plus | ✅ | GPT-5.5 Pro | ⭐⭐⭐⭐ |
| Business | 25/seat | 10× Plus | ✅ | 团队版 | ⭐⭐⭐ (团队场景) |
| Enterprise | 谈 | 自定义 | ✅ | 全套 | ⭐⭐⭐ (大企业) |
5.2 为什么 Pro $100/月是单人开发者的最佳选择
把上表的关键数据展开看：
Pro $100 vs Plus $20:
- 价格 5×，用量 10× (促销期) → 等效单位 Token 价格便宜 50%
- Goal 模式跑长任务很容易把 Plus 限额吃光，Pro 更扛造
- 对于每天用 Codex 4 小时以上的开发者，Plus 配额几乎一定不够
Pro $100 vs Pro $200:
- 价格 1/2，用量 1/2 (促销期) → 单位 Token 价格相同
- 大多数个人开发者一个月也用不完 Pro $100 的限额
- 除非你长期跑多个并行 Goal 模式，否则不需要 $200 档
Pro $100 vs API 模式 (按 Token 计费):
- Codex 平均消耗 $100-$200/月每开发者 (按 API 价格估算)
- 订阅是固定费用，用得越多越省
- API 模式没有 Goal 加持，长任务还得自己写循环
🎯 核心结论：对所有想认真用 Codex 的个人开发者，$100/月的 ChatGPT Pro 是无可争议的最佳方案。它同时具备：①Goal 模式权限、②10× Plus 的 Codex 用量、③固定费用可预期、④省去自行实现长任务循环的工程成本。比按量计费的 API 调用方式实际成本更低，比 $200 Pro 价格更友好。
5.3 不同身份开发者的订阅决策树
是否要用 Goal 模式？
├─ 是 → 必须 ChatGPT 订阅鉴权
│ ├─ 每天用 Codex < 1 小时 → Plus $20 起步
│ ├─ 每天用 Codex 1-4 小时 → ⭐ Pro $100 (推荐)
│ └─ 每天跑多个并行 Goal → Pro $200
└─ 否 (只用单回合 Codex)
├─ 临时试用 / 探索 → API 中转站按量付费
└─ 长期重度使用 → Plus $20 起步
六、为什么 API 中转站做不了 Codex Goal 模式
很多读者会问：我已经在用某个 API 中转站调用 GPT-5，为什么不能也用它跑 Goal 模式？这里把原因讲透。
6.1 Goal 模式的鉴权架构限制
Codex CLI 提供两种鉴权模式：
| 鉴权模式 | 计费方式 | 支持 Goal 模式 | 中转站可代理吗 |
|---|---|---|---|
| ChatGPT auth (订阅) | 走订阅 plan 限额 | ✅ | ❌ 不行 |
| API key (按量) | 按 Token 计费 | ❌ | ✅ 可代理 |
/goal 命令在 Codex CLI 中仅在 ChatGPT auth 模式下激活。这是因为 Goal 模式的 app-server 持久化逻辑挂在 ChatGPT 账号体系下，不是简单的 OpenAI Chat Completions API 接口。
6.2 中转站为什么无法代理 ChatGPT 订阅
API 中转站本质上是把 OpenAI 的 /v1/chat/completions 等 RESTful 接口做了一层透明代理。它能做的：
- 转发标准 OpenAI API 请求
- 把多家厂商的 API 统一封装成 OpenAI 协议
- 自动负载均衡、故障切换
它做不到的：
- 模拟 ChatGPT.com 的 web 鉴权 (需要真实订阅 cookie/session)
- 接入 Codex app-server 的持久化目标存储
- 代理订阅 plan 的限额体系
简而言之，Goal 模式不是一个 API endpoint，它是 ChatGPT 订阅生态内的一个产品功能。中转站对此无能为力。
6.3 那 API 中转站什么场景下还有用？
API 中转站不是"做不了 Goal 模式"就一无是处，它在以下场景仍然是最优解：
- 小量试用 / 原型验证: 临时调用 GPT-5、Claude 4.7 等模型测试一下
- 构建 AI 产品: 后端集成多家模型 API，需要统一接口和稳定通道
- CI/CD 集成: 自动化代码审查、文档生成等流水线任务
- 不需要 Goal 模式的纯 API 调用: 例如只用 Codex API 做一次性代码生成
💡 使用建议：如果你只是少量试用 Codex 系列模型，或者构建产品需要 API 接入，可以通过 API易 apiyi.com 这类中转平台快速接入。但如果要正式用 Goal 模式跑长任务，必须订阅 ChatGPT Pro，没有第三方替代方案。
七、国内开发者使用 Codex Goal 模式的完整方案
国内开发者要用上 Goal 模式，需要解决两个外部问题：①如何买到 ChatGPT Pro 订阅、②如何让 Codex CLI 联网鉴权。下面给出完整路径。
7.1 ChatGPT Pro 订阅的获取渠道
OpenAI 官网的 ChatGPT Pro 不直接对国内信用卡开放支付。社区中已经成熟的代购方案有以下几类：
| 渠道类型 | 优势 | 劣势 | 适用人群 |
|---|---|---|---|
| 海外朋友代付 | 价格最透明 | 依赖人情、长期续费麻烦 | 偶尔用 |
| 虚拟信用卡 (Wise / OneKey 等) | 自主性强 | 开卡门槛、国家限制 | 技术型开发者 |
| 国内代购账号网站 | 开箱即用、有售后 | 需要选择靠谱平台 | 大多数开发者 |
国内推荐的代购网站：
- 代购网站 1:
ai.daishengji.com— 提供 ChatGPT Pro / Plus 账号代购，支持人民币支付，售后较稳定 - 代购网站 2:
www.gpt516.com— 同样提供 ChatGPT Pro 订阅渠道，价格区间多档可选
📌 代购选择建议：选代购时重点关注 ① 是否提供 30 天以上的稳定保障、② 是否支持密码自助修改、③ 是否独享账号 (避免共享账号被多人挤掉)。两家推荐站都支持 ChatGPT Pro $100 档位的代购，开发者可以自行对比价格和售后条款。
7.2 网络代理的准备
ChatGPT Pro 账号买到后，Codex CLI 联网鉴权和后续 API 调用都需要稳定的网络代理。这部分需要开发者自备，常见的合规方案包括：
- 海外 VPS + Clash / Sing-box 自建
- 商业机场服务 (注意挑长期稳定的)
- 公司海外办公网络 (有海外分部的可走 SSO 出口)
代理配置后，Codex CLI 通常会自动从环境变量读取 HTTP_PROXY 和 HTTPS_PROXY：
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
codex login # 此时浏览器授权流程才能正常完成
⚠️ 代理稳定性是 Goal 模式可用的前提：Goal 模式可能跑数十分钟到数小时，期间任何一次代理掉线都可能让 Codex 误判任务进度。建议选择全局开启 + IP 不频繁切换的代理方案。
7.3 国内开发者的混合使用策略
把上面所有信息合并成一个最优方案：
- 正式跑 Goal 模式 / 长任务 → ChatGPT Pro $100 订阅 + 自备代理
- 小量试用 Codex 系列 / 验证模型能力 → 通过 API易 apiyi.com 调用 Codex API，省去翻墙和注册环节
- 生产环境集成 API → API 中转站 + 自动化监控
- 高频闭环开发 → Pro $100 + Codex CLI 0.128.0+ 组合
🎯 决策建议：如果你已经决定深度使用 Codex Goal 模式，直接订阅 Pro $100/月，是性价比最高的方案。代购可以选择
ai.daishengji.com或www.gpt516.com等成熟平台，配合自备代理使用。如果只是探索 Codex 模型本身的能力，先用 API易 apiyi.com 这类中转站做小量调用更经济。
八、Codex Goal 模式与同类产品对比
把 Codex Goal 模式放到行业坐标系里看一下，便于做技术选型。
| 产品 | 厂商 | 长任务模式 | 鉴权方式 | 中转支持 | 综合体验 |
|---|---|---|---|---|---|
| Codex /goal | OpenAI | ✅ Ralph Loop | ChatGPT 订阅 | ❌ 不可代理 | ⭐⭐⭐⭐⭐ (最完整) |
| Claude Code 长任务 | Anthropic | ✅ Managed Outcomes | API Key 或 Pro | ✅ 部分支持 | ⭐⭐⭐⭐ |
| Aider auto mode | 开源 | ✅ 自循环 | 任意 API | ✅ 完全支持 | ⭐⭐⭐ (需自调) |
| Cursor Composer | Cursor | ✅ Background Agents | 订阅 | ❌ | ⭐⭐⭐⭐ |
| GitHub Copilot Workspace | 微软 | ✅ Workspace 自动模式 | GitHub 订阅 | ❌ | ⭐⭐⭐ |
| Devin | Cognition | ✅ ACE 智能体 | 订阅 | ❌ | ⭐⭐⭐⭐ |
可以看到，Codex Goal 模式是当前主流闭源 AI 编程产品中工程化最成熟的长任务方案之一，配合 ChatGPT Pro $100 的订阅价格，性价比极具竞争力。
九、Codex Goal 模式常见问题 FAQ
Q1: Codex Goal 模式必须有 ChatGPT Pro 才能用吗？
理论上 ChatGPT Plus ($20/月) 也支持 Goal 模式。但 Plus 的 Codex 用量限额 (1× 基准) 在长任务下很容易吃光，Goal 跑到一半被预算限制中断的体验非常糟糕。实战建议至少 Pro $100/月起步。
Q2: 用 OpenAI API Key 能跑 Goal 模式吗？
不能。Goal 模式仅在 ChatGPT auth 模式 (订阅鉴权) 下激活，API Key 模式无法启用 /goal 命令。即使你愿意按 Token 付费也不行——这不是计费问题，是产品功能边界问题。
Q3: 通过 API易这类中转站能跑 Goal 模式吗？
不能。Goal 模式依赖 ChatGPT app-server 的持久化目标存储和 ChatGPT 订阅鉴权体系，API 中转站只能代理 OpenAI 标准 RESTful 接口，无法代理订阅鉴权流程。如果只是做小量 API 调用试用 Codex 模型，可以用 API易 apiyi.com 等中转站，但 Goal 模式必须订阅 Pro。
Q4: Pro $100 还是 Pro $200 适合 Goal 模式？
对绝大多数个人开发者，Pro $100 完全够用。Pro $100 的 Codex 用量是 Plus 的 10× (促销期，2026/05/31 前)，之后稳定在 5×。除非你长期同时跑 3 个以上的 Goal 任务，否则用不完 Pro $100 的额度，不需要花 $200。
Q5: 国内能直接订阅 ChatGPT Pro 吗？
不能。OpenAI 不接受国内信用卡支付，且账号注册有地区限制。国内开发者通常通过代购网站获取账号，例如 ai.daishengji.com 或 www.gpt516.com，这些平台支持人民币支付并提供基础售后。订阅成功后还需要自备网络代理才能正常使用 Codex CLI。
Q6: Goal 模式跑到一半 Token 不够了怎么办？
Codex 会触发 budget_limited soft stop，用剩余 Token 写一份 wrap-up 进度报告。下次开 TUI 时可以 /goal resume 继续，前提是订阅额度已恢复。如果你长期遇到额度不够，可以考虑升级到 Pro $200 或拆分目标。
Q7: 我能同时跑多个 Goal 吗？
Codex CLI 当前实现下，单个项目目录单次只能有一个 active goal。但你可以在不同目录开多个 Codex 实例，每个跑各自的 Goal。如果是同一个 monorepo，建议把 Goal 拆解成可串行的子目标。
Q8: Goal 模式跑长任务安全吗？会不会乱改代码？
Goal 模式遵循 Codex CLI 的标准沙箱策略：可以读写当前工作目录、可以执行允许列表中的命令、不能访问系统外部资源。强烈建议在 Goal 模式开启前先做一次 git commit，让改动可回滚。也可以在 Goal 描述中加上"只动 src/ 目录，不动 tests/ 和 docs/"这样的约束。
Q9: 自备代理有什么具体要求？
最低要求：① 支持 HTTPS 全局代理、② 至少 5Mbps 稳定带宽、③ IP 不要频繁切换 (可能触发 OpenAI 风控)。Goal 模式跑长任务时代理掉线就可能毁掉一次完整循环，稳定性比速度重要。
Q10: Codex Goal 模式会取代 Cursor 这类 IDE Agent 吗？
短期不会。两者定位不同：Codex Goal 模式擅长完全无人值守的长跨度任务 (跑一夜回来收成果)；Cursor / Copilot 这类 IDE Agent 擅长人机协同的实时编辑。最佳实践是同时用：日常开发用 Cursor，重活脏活交给 Codex Goal。
十、总结：Codex Goal 模式落地核心要点
回顾全文，关于 Codex Goal 模式，最核心的几个要点：
- Goal 模式是 Codex CLI 0.128.0 引入的长跨度自主任务模式，能让 Codex 自动循环 plan→act→test→review→iterate，不达目的不罢休
- 5 类任务最适合 Goal 模式：大版本迁移、测试覆盖率提升、大规模重构、Bug 排查修复、文档生成
- Goal 模式必须使用 ChatGPT 订阅鉴权，OpenAI API Key 和第三方 API 中转站均不可用
- Pro $100/月 是单人开发者的最佳订阅档，10× Plus 用量、Goal 模式权限、固定费用可预期，对长期使用者比按量计费 API 更省钱
- 国内开发者使用路径：通过
ai.daishengji.com或www.gpt516.com等平台代购 Pro 账号，并自备稳定网络代理 - API 中转站仍有价值：小量试用 Codex 模型能力 / 构建 AI 产品 / CI/CD 集成场景，可以选择 API易 这类统一接入平台
- 混合使用策略：长任务用 Pro 订阅 + Goal 模式；模型试用和产品集成用 API 中转站
- 第一次试用建议：先用 30 分钟以内的小目标熟悉流程，再放手让 Codex 跑大型任务
🎯 最终建议：如果你是认真在做编程工作的开发者，并且每天会用 AI 辅助开发超过 1 小时，直接订阅 ChatGPT Pro $100/月 是当前最佳选择。它解锁了 Goal 模式这个真正能跑长任务的杀手特性，比按量计费 API 实际更省钱、比手搓循环更省心。代购渠道可以参考
ai.daishengji.com或www.gpt516.com，再配合自备代理，就能完整体验到这个 2026 年最值得关注的 AI Coding 新形态。
Codex Goal 模式正在重新定义"AI 帮我写代码"的工程化天花板。从工具到自主代理人的范式跃迁，已经在你的终端里发生。
作者：APIYI 技术团队 | 关注 AI 大模型落地实战，更多技术内容欢迎访问 API易 apiyi.com
