资料来源:Claude Code 官方文档 — Keep Claude working toward a goal + v2.1.139 Release Notes(2026-05-11)
你用 Claude Code 修 bug,最烦的是哪一步?
不是写代码。是 每改完一小段,你还得敲回车、看 diff、再催它「继续」。
它说「测试过了」,你还得自己跑一遍。它说「搞定了」,你打开 git status 发现还有三处没动。你人卡在终端里,像 babysitter(保姆)一样盯着 Agent 干活。
Claude Code v2.1.139(2026-05-11 发布)加了一个命令:/goal。
讲人话就是:你写一句「什么叫做完」,Claude 会 一轮接一轮自己干,直到有个小模型确认「条件满足了」才停。中间你不用每步都按回车。
这篇只讲 怎么用、怎么写 goal、什么时候别用。不堆发布会通稿。
1)/goal 到底是什么?30 秒讲清楚
官方定义:/goal 给当前会话设一个 可验证的完成条件(completion condition)。每轮对话结束,系统用 小快模型(默认 Haiku)看一眼:条件达成了吗?
- 没达成 → 自动开下一轮,把评估理由塞给 Claude 当指引
- 达成了 → goal 自动清掉,会话回到正常模式
界面上会出现 ◎ /goal active 指示器,还能看到已跑多久、多少轮、花了多少 token。overlay 面板里也有 live 的 elapsed / turns / tokens。
版本要求:Claude Code v2.1.139 或更高。低版本没有这个命令。
底层实现(知道一下有助于避坑):/goal 本质是 会话级 Stop hook + 小模型评估。评估器 不会自己跑命令、读文件,只能根据 Claude 已经在对话里展示过的结果 来判断。所以你的 goal 必须写成「Claude 能在 transcript 里证明的事」。
2)和 /loop、Auto Mode、Stop Hook 怎么选?
很多人搞混。官方给了一张对照表,我翻译成「该什么时候用谁」:
| 方式 | 下一轮什么时候启动 | 什么时候停 |
|---|---|---|
/goal |
上一轮结束立刻 | 小模型确认 你写的条件 满足 |
/loop |
到点(时间间隔) | 你手动停,或 Claude 自己觉得做完了 |
| Stop Hook | 上一轮结束 | 你自己的脚本或 prompt 决定 |
| Auto Mode | 不启动新轮 | 单轮内自动批准工具;轮结束就停 |
我的用法口诀:
- 有 明确验收标准(测试绿、lint 过、队列为空)→
/goal - 只是 定时巡检(每 30 分钟看一眼 CI)→
/loop - 公司级 统一门禁(每次必须跑某脚本)→ Stop Hook
- 单轮里不想老点「允许编辑文件」→ Auto Mode(常和
/goal一起开)
Auto Mode 和 /goal 是互补的:前者省 工具确认 的点击,后者省 「继续啊」 的点击。
3)上手:三条命令就够
设 goal(会立刻开干)
/goal test/auth 目录下所有测试通过,且 npm run lint 退出码为 0
注意:设 goal 的同时就会开始第一轮,不用你再发一句「开始吧」。条件本身当指令用。
看状态
/goal
会显示:当前条件、跑了多久、评估了几轮、token 花费、评估器上一句理由(为什么还没过 / 为什么过了)。
提前叫停
/goal clear
stop、off、reset、none、cancel 都能当 clear 用。/clear 开新对话也会清掉 active goal。
非交互模式(CI、脚本里一次性跑完):
claude -p "/goal CHANGELOG.md 里已有本周每个合并 PR 的条目"
Remote Control、桌面端也支持。跑太久就 Ctrl+C。
4)怎么写「写得对」的 goal?(核心)
官方说评估器 最多 4000 字符,但别写小作文。好的 goal 通常有三块:
- 一个可度量的终态:测试全绿、构建 exit 0、某目录文件数 ≤ N、issue 队列空
- 怎么证明:写清楚 Claude 该跑什么、把结果留在对话里,例如「运行
npm test且输出 0 failures」 - 边界约束(可选):「不要改 test/ 以外的文件」「不要升级依赖」
✅ 能用的例子(可直接改)
/goal 把 src/auth 里所有 fetch 调用迁到新的 apiClient,直到 npm test 全绿且 git diff 只涉及 src/auth 和 test/auth
/goal 按 docs/refactor-plan.md 拆完 utils.ts,每个新文件不超过 200 行,直到 npm run build 成功
/goal 处理完 GitHub label 为 bug 且 assignee 是我的 open issue,直到 gh issue list 对该筛选为空,或已满 15 轮则停止并汇报剩余
第三条里 「或满 N 轮停止」 很重要——官方支持在条件里写 turn/time 上限,避免无限烧 token。
❌ 容易翻车的写法
| 写法 | 为什么不行 |
|---|---|
| 「把代码写好」 | 无法验证 |
| 「重构得更优雅」 | 主观,评估器没法判 |
| 「你去读一下 README 再决定」 | 评估器不独立读文件,全靠 transcript |
| 「修完所有 bug」 | 范围不明,容易跑偏 |
关键认知:评估器像 阅卷老师,只能根据 Claude 交上来的答卷(终端输出、diff 摘要)打分。所以 goal 里要写 「交什么卷算及格」。
5)三个我推荐立刻试的场景
场景 A:修测试到全绿
最适合入门。终态清晰,Claude 自然会反复跑 npm test,评估器也好判。
/goal packages/core 下 jest 全通过,且没有新增 .only 或跳过的测试
场景 B:按设计文档落地
你已经有 design.md 或 issue 描述。让 Claude 对照 acceptance criteria 干活,goal 直接抄验收项。
/goal 实现 design/oauth-migration.md 里列出的全部 Must 条目,并用文档里的检查清单自证每一项
场景 C:清 backlog / 贴标签 / 生成 CHANGELOG
偏运维向,适合 -p 非交互跑一轮。
/goal 根据本周 git log 更新 CHANGELOG.md,每个 merge commit 一条,且 npm run lint 通过
6)配套功能:Agent View(顺便提一句)
同版本还上了 Agent View(研究预览):终端跑 claude agents,能在 一个列表里看所有会话——跑着、等你输入、已完成。
和 /goal 搭配很顺:你开两个 goal(比如一个修测试、一个写文档),不用切 tab 猜哪个还在跑。
文档:Agent View
7)前提与限制(别装完发现用不了)
官方写的硬条件,踩过坑的人懂:
- 工作区要过信任对话框(trusted workspace)。评估器走 hooks 体系,不信任的工作区不让用。
disableAllHooks或allowManagedHooksOnly开着 →/goal不可用,命令会告诉你原因,不会静默失败。- 评估要花钱,但通常很少:走你配置的小快模型(默认 Haiku),比主模型每轮便宜一个数量级。
- resume 会话:
--resume/--continue时,未完成的 goal 会恢复;已达成或 clear 过的不会。计时和 token 统计会重置。 - 一个会话只能有一个 active goal。新的会覆盖旧的。
8)我的判断:/goal 改变的是「谁握着循环」
以前:你是 外循环——Claude 跑一轮,你决定继不继续。
现在:你是 定终点的人——写好验收条件,内循环交给 Claude + 评估器。
这和 Cursor 并行 Build、Codex 的 goal 能力、行业都在推的 「后台长任务 Agent」 是同一波。差别在于 Anthropic 把 「怎么算做完」 做成了第一公民,还拆了个 独立评估模型,减轻「干活的那个模型自己说自己做完了」的自欺。
但 /goal 替代不了 Superpowers 那类流程 skill。它不管 brainstorming、不管 worktree 隔离。最稳的组合是:
Superpowers(或你自己的 CLAUDE.md 流程)定规矩 +
/goal盯终态 + Auto Mode 少点确认
如果你只记一件事:goal 写清楚「怎样算交卷」,比催它「继续」有用十倍。