OpenAI Codex 的 /goal 功能正在改变开发者的工作方式：你只需给出一句高层意图，Codex 就能自动拆解任务、派生子智能体、自主完成从规划到交付的全流程。有开发者实测让它独立运行 18 小时，自主完成了 BACKLOG.md 中的 14 个功能开发，花费仅约 4.20 美元。

本指南将带你从零开始配置和使用 /goal，并避开社区已知的坑。

开始前的准备

• Codex CLI 0.128.0+：/goal 功能从这个版本开始内置
• OpenAI API 账户：需要有效的 API Key，余额充足（建议至少 10 美元）
• 一个已有项目仓库：官方建议先让项目跑出雏形再用 /goal，不要在空项目上直接启动
• 预计成本：简单任务约 0.5-2 美元，长时间自主运行可达 5-10 美元

第一步：开启 /goal 功能

/goal 默认关闭，需要手动修改配置文件。

在你的项目根目录下找到或创建 config.toml，添加以下内容：

[features]
goals = true

提示: 如果你使用的是全局配置（通常在 ~/.codex/config.toml），也可以在那里开启，但建议按项目级别配置，方便管理。

第二步：理解 /goal 的工作机制

/goal 和普通对话提示词有本质区别。它同时充当两个角色：

1. 起始指令：告诉 Codex 要做什么
2. 完成审计标准：Codex 每跑完一轮，回头对照目标自问"还该做什么，是否已经做完了"

这个循环被称为"Ralph 循环"：规划、执行、测试、复查、迭代，一轮接一轮，直到任务完成、你手动叫停、或 token 预算耗尽。

关键原则：目标必须可验证。Codex 需要能判断"做完没有"。

第三步：写好你的第一个 /goal

一个好的 goal 应该具备这些特征：具体、可验证、有边界。

反例（避免这样写）：

/goal 优化一下代码质量
/goal 完善用户体验

这些"虚词"会导致 Codex 无法判断完成状态，陷入无限循环。

正例（推荐这样写）：

/goal 将 src/utils/date.ts 中的所有 moment.js 调用替换为 dayjs，
确保所有测试通过（npm test），删除 moment.js 依赖（package.json 中不再包含 moment），
完成后输出变更文件列表。

注意这个 goal 的三个要素：明确的任务边界、可验证的完成条件（测试通过 + 依赖移除）、清晰的输出要求。

第四步：让 Codex 自己写 /goal（进阶）

这是目前社区最火的玩法，由前 Anthropic 成员、现 MagicPath CEO Pietro Schirano 展示。

你不再手写 goal，而是给 Codex 一句高层意图，让它自己生成 goal 并派生子智能体：

帮我构建一个 [THING]，需要包含 [功能列表]，
风格参考 [描述]。
让 Codex 自己规划任务和派生 agent。

Codex 会自动完成以下工作：

1. 为自己写一份详细的 /goal
2. 拆分出需要并行的子任务
3. 为每个子智能体（subagent）各写一份专属 goal
4. 创建并调度这些子智能体
5. 汇总各子智能体的产出

子智能体 Gibbs 正在执行自己的专属 /goal，设计一条数学化的过山车轨道。各自一份 goal 正是这套打法的核心。

第五步：控制 Token 消耗

自主运行最大的风险是 token 账单失控。a16z 的 Andrew Chen 在一个真实 eGPU 驱动项目上跑了一整夜（14 小时），他直言这会让 token 用量翻一万倍。

官方推荐的控费方法：

在 goal 末尾添加 token 预算限制：

/goal [你的任务描述]
Token 预算：不超过 500K tokens。
如果接近预算，停止并汇报当前进度。

其他控费建议：

• 不要在空项目上直接启动 /goal，先手动搭建基础框架
• 从小任务开始测试，确认行为符合预期后再放给长任务
• 定期检查运行日志，发现偏离立即叫停

验证结果

运行完成后，检查以下几点确认任务成功：

1. 测试是否通过：Codex 应在 goal 中自包含测试验证
2. CI 是否绿灯：所有改动应能在 CI 中合并
3. 变更日志：Codex 应输出完整的变更文件列表
4. 代码自审：可让 GPT 子智能体做一轮 code review

一位开发者的实测记录：给 Codex 一句目标"把 BACKLOG.md 里的 18 个功能全部交付"，18 小时后回来，Codex 自主完成了 14 个，每处改动都过了测试并在 CI 里合并，全程无需人工点头，总花费约 4.20 美元。

常见问题

Q: 目标漂移怎么办？

Codex 可能在长时间运行后偏离原始目标。社区建议：将大任务拆成多个小 goal 分批执行，每个 goal 限制在 2-4 小时内完成，而不是一个 goal 跑 18 小时。

Q: 智能体会不会偷懒走捷径？

存在这个风险。OpenAI 官方建议在 goal 中明确写出验收标准，例如"所有边界情况必须有对应测试用例"。

Q: 和 Claude Code 的多智能体编排有什么区别？

Claude 的 coordinator 最多派 20 个 subagent，且刻意限制只派一层（深度超过 1 直接忽略）。Codex 的 /goal 则允许更自由的并行派生，适合复杂的多层级任务。

Q: 有现成的工具帮我把目标写得更好吗？

开发者 RTK 发布了开源项目 Infinite Skills，其中包含一个 goal skill。它会在你正式发起 /goal 之前，先反过来"面试"你，把含糊的目标盘问成具体、可验证的契约。

GitHub 地址：https://github.com/Infinite-Labs-AI/infinite-skills