什么是 /goal
命令参考用一句话描述了它:“Claude 会跨轮次持续工作,直到满足条件或目标因其他原因清除。”
目标文档解释了其机制:“/goal 是一个围绕会话范围(session-scoped)的基于提示词的 Stop 钩子的封装。每当 Claude 完成一个轮次,Claude Code 就会将条件和截至目前的对话发送给你配置的小型快速模型。”
那个模型就是评估器。在每一轮之后,它会返回三种裁定之一:
- 尚未达成 (Not yet met)。 “Claude 继续工作,并将原因作为下一轮的指导。”
- 已达成 (Met)。 “Claude Code 清除目标并在记录中记入一条已实现的条目。”
- 不可能实现 (Impossible)。 评估器“判断该条件永远无法满足”。Claude Code 清除目标并记录原因。
文档解释了为什么这与让 Claude 自行决定何时完成不同:自动模式“在单次轮次内批准工具调用,但不会开启新轮次”,而 /goal “增加了一个独立的评估器,在每一轮之后检查你的条件”。
如何设置、检查和清除目标
设置目标。 运行 /goal 后跟条件。“设置目标会立即开始一个轮次,条件本身就是指令。你不需要发送单独的提示词。”每个会话只能有一个活动目标,新目标会替换旧目标。
检查目标。 运行不带参数的 /goal。状态会显示条件、运行时间、已评估的轮次、当前的 token 消耗以及评估器的最新原因。
清除目标。 运行 /goal clear。文档列出了 stop、off、reset、none 和 cancel 作为别名。运行 /clear 开始新对话也会移除任何活动目标。
目标不会改变你的权限模式。文档称:“要让目标轮次在无人值守的情况下运行,请在自动模式下运行 /goal。”在手动模式下,Claude 在进行设置尚未允许的工具调用前仍会询问。
评估器能看到什么
这是开头示例中第一个意外的原因。评估器读取的是对话内容。它不会自行查看你的终端、文件或测试运行器。
文档明确指出:它“不会独立运行命令或读取文件”。因此,在另一个终端窗口中通过的测试,或者在会话之外更改的文件,都不是评估器可以使用的证据。起作用的是 Claude 在对话中运行并报告的内容。
记录显示了每次裁定,文档提到你可以按 Ctrl+O 查看背后的原因。如果评估器一直说目标未达成,该原因可以告诉你缺失了什么证据。
如何编写有效的条件
文档提供了一个简短的清单。文档指出,一个能经受多轮考验的条件通常具有:
- “一个可衡量的最终状态”,例如测试结果、构建退出代码、文件数量或空队列。
- “明确的检查方式”,即 Claude 应该如何证明它,例如退出代码为 0 的测试命令。
- “重要的约束条件”,即过程中绝不能改变的任何事项。
因为评估器只看对话,所以“明确的检查方式”是最重要的部分。关于通过集成测试的条件,如果指明了命令,就更容易判断,这样 Claude 运行它后结果就会出现在记录中。
条件最多可达 4,000 个字符。为了限制目标的运行时间,文档建议加入轮次或时间条款,例如在设定轮次后停止。“Claude 每一轮都会报告针对该条款的进度,评估器会根据对话进行判断。”
为什么恢复会话会带回目标
这是开头示例中的第二个行为。目标属于会话,恢复会话会还原它。
文档称 Claude Code 在“每种恢复路径”上都会还原活动目标,包括 continue、使用会话 ID 或名称 resume,以及使用记录文件路径 resume。
有些内容会重置:“Claude Code 会保留条件,但会重置轮次计数、计时器和 token 消耗基准。它不会还原已经实现或已清除的目标。”
因此,如果你带着活动目标结束一天的工作,当你恢复时它依然会在。如果你不想要它,请在关闭会话前清除它,或者在恢复后清除。
目标随会话持久化,而不是跨会话。全新的会话开始时没有目标,/clear 会移除活动目标。目标文档称其为会话范围的快捷方式,“仅对当前会话有效”。
后台工作如何影响目标
长目标可能涉及子代理或后台命令,文档对此有特定规则。
评估等待。 “如果轮次结束时子代理或后台 shell 命令仍在运行,Claude Code 会跳过该轮次的评估。”它会在下一个没有任何后台工作运行的轮次结束时进行评估。
签到 (Check-ins)。 一旦后台工作让目标等待了 30 分钟,就需要进行签到。Claude Code 会列出正在运行的任务,并要求 Claude 读取它们的输出,如果它们正在进展则继续等待,并修复或停止任何卡住的任务。
停滞会停止循环。 “如果 Claude 一直在回答评估器但没有取得进展(连续几轮没有使用工具),Claude Code 会停止循环,打印警告,并将控制权交还给你,此时目标仍处于设置状态。”
当轮次失败时会发生什么
文档将错误分为两类。
必须由你修复的错误会清除目标。 这些包括 Claude Code 管理自身凭据时的身份验证失败、余额耗尽、“自动压缩无法清除的上下文溢出”以及模型不可用。Claude Code 会打印命名原因的警告,你在修复后重新设置目标。
其他错误则保留设置。 “发生任何其他错误后,目标保持设置状态。”
上下文溢出的情况对于长目标值得注意。运行多轮的目标会填满上下文窗口,自动压缩通常能让它继续。如果压缩无法清理出足够的空间,目标就会结束。
何时 /loop 或 Stop 钩子更合适
文档比较了三种在提示词之间保持会话运行的方法。区别在于是什么启动了下一轮。
/goal在前一轮结束时启动下一轮,并在模型确认条件或判断为不可能时停止。/loop在“时间间隔流逝”时启动下一轮,并在你停止它或 Claude 认为工作完成时停止。- Stop 钩子 在前一轮结束时启动下一轮,并在“你自己的脚本或提示词决定”时停止。
因此,/loop 适合由时间驱动的工作,例如每隔几分钟检查一次部署。计划任务文档称其为“在会话保持开启时重复运行提示词的最快方式”。
Stop 钩子适合应该每次都应用的规则。文档解释道:“/goal 是一个会话范围的快捷方式:你输入一个条件,它仅对当前会话有效。Stop 钩子存在于你的配置文件中,适用于其范围内的每个会话,并且可以运行脚本进行确定性检查”。
最后这句话很重要。因为 /goal 评估器是根据对话判断的,所以当你需要检查具有确定性时,运行脚本的 Stop 钩子是首选。
对于应该在没有任何开启会话的情况下运行的工作(如每晚测试),文档建议改用调度选项。我们在 Claude Code routines 指南中介绍了调度运行之间保留的内容。
人们首先会尝试的做法
编写评估器看不到的条件。 它判断的是对话,而不是你的文件或终端。
期望目标在会话结束时结束。 恢复会话会还原活动目标。
设置第二个目标。 每个会话只能有一个活动目标。新目标会替换旧目标。
使用 /goal 进行计划检查。 /loop 按间隔运行。
期望 /goal 批准工具调用。 它不会改变你的权限模式。
解决方案:编写评估器可以判断的目标
第 1 步:在条件中指明检查方式
包含其结果能证明目标达成的命令。
第 2 步:添加约束和限制
说明什么不能改变以及何时停止。
第 3 步:清除你不希望恢复的目标
在关闭你不会继续的会话前运行 /goal clear。
第 4 步:记录每个长目标的产出
写下结果、有效的方法以及任何未完成的事项。
在 MemoryLake 中设置
当满足条件时,目标结束。你在达成目标过程中学到的东西(例如哪个测试不稳定、哪个修复有效、你推迟了什么)是下一个会话开始时所缺失的上下文,除非你把它记下来。记录保留了轮次,但结论分散在其中。
MemoryLake 是此类项目上下文(如结果、有效方法和待办事项)的记忆层,保存在一个由你维护的地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。
你用自己的语言亲自编写条目。不会从你的 Claude Code 会话、记录、目标、配置文件或任何供应商的存储中读取、写入或删除任何内容。/goal 的工作方式与 Anthropic 描述的一致。
第 1 步:创建 API 密钥
登录并从控制面板生成密钥。像对待其他凭据一样,将其存储在代码库之外。

第 2 步:上传你的第一条记忆
从你在解决方案第 4 步中写下的内容开始:每个目标的产出。每个条目对应一个目标。

第 3 步:连接你的 AI 和代理
连接 Claude Code、Codex 和你使用的其他助手。下一个会话可以从相同的结果开始。

这在实践中改变了什么
第一个区别是更好的下一个目标。你可以编写一个基于上一个目标发现的条件。
第二个区别是更少的重复失败。不稳定的测试或死胡同都有记录在案。
第三个区别是工具间的一致性。相同的结果在 Claude Code 和其他助手中均可使用。
Claude Code 中 /goal 的最佳实践
使检查可见。 评估器只能看到对话。
保持单一终态。 可衡量的条件效果最好。
限制长目标。 添加轮次或时间条款。
无人值守运行时使用自动模式。 目标不会改变权限。
有意识地清除目标。 恢复会话会带回活动目标。
选择正确的工具。 间隔任务用 /loop,确定性检查用 Stop 钩子。
结论
/goal 让 Claude Code 跨轮次持续工作,直到满足条件。它是一个会话范围的基于提示词的 Stop 钩子:在每一轮之后,一个小型快速模型会读取条件和对话,并决定目标是已达成、尚未达成还是不可能实现。评估器不会运行命令或读取文件,因此条件应指明一个其结果会出现在对话中的检查方式。
会话结束时仍处于活动状态的目标会在每次恢复路径上回来,其轮次计数、计时器和 token 基准会重置。后台工作会推迟评估,必须修复的错误会清除目标,其他错误则保留设置。对于间隔驱动的工作使用 /loop,对于应应用于每个会话的确定性检查使用 Stop 钩子。