/loop — Claude Code 循环唤醒机制深度解析#

你设好一条 /loop，然后去开会——Claude 每隔一段时间自己醒来检查状态，自己决定下次什么时候再跑。这不是 cron，不是 bash while，它是一个会 reason 的 agent 在 self-pace。

0. 一句话先讲明白#

/loop 让 Claude 在当前 session 里反复执行一个 prompt 或 slash 命令——可以按固定 interval（/loop 5m <prompt>），也可以让 agent 自己决定节奏（/loop <prompt>，不带 interval）。

三件先搞清楚的事：

1. 不是 /goal。/goal 是 condition-driven——满足条件才停。/loop 是 periodic——按节奏反复跑，直到 7 天过期或人为取消。两者目的不同，不可互换。
2. 不是 OS cron。cron 是 OS 级调度，没有 context，没有 reason 能力。/loop 是 agent-level 调度，每次唤醒 Claude 可以根据上一轮结果决策。
3. 不是 ralph-loop plugin。ralph-loop 是把同一个 prompt 反复喂回同一个 session（迭代改稿）；built-in /loop 是按 cron 触发新唤醒（每次是独立的 agent turn，但 prompt 固定）。两个完全不同的机制。

看完这节，你能区分三种模式、配好 ScheduleWakeup 参数、知道 token 成本陷阱、不会把 /loop 跟 ralph-loop 混淆。