目录
"构建完成了就告诉我。""CI 变红了就修好它。""每 5 分钟盯一下部署。"如果能把这些需要一直盯着的杂活整个交给 AI,会怎样?2026 年加入 Claude Code 的 /loop 命令做的正是这件事。它会按你设定的间隔——或由 AI 自己决定的间隔——反复运行一段提示词或斜杠命令,相当于会话内的"监视者"和"重复者"。
先把结论摆出来。/loop 填补了"我现在就想查一下"和"我想要全天候 24 小时自动化"之间的空白。输入 /loop 5m check the deploy status,它就会每五分钟自动运行一次。省略间隔,Claude 会观察情况,自己挑选最合适的等待时间(自适应节奏)。本文面向初学者讲解四种用法、自适应节奏的原理、实用配方、如何停止以及需要注意什么,还有它与相关功能(Desktop 任务、云端 Routines)的区别。请注意,/loop 是新功能,行为可能会变化,最新信息请查阅官方文档(本文基于 2026 年的信息)。
按你设定的间隔,AI 一次又一次地运行
—— 把需要一直盯着的监视活交给一个循环
提示词/命令
设定间隔或 AI 选择
完成后自动停止
"运行 → 等待 → 再次运行",由 AI 驱动。在自适应节奏模式下,一旦 AI 判断任务完成,循环就会停止。
* 本文中的 /loop 行为基于 Claude Code 官方文档(截至 2026 年)。作为新功能,它可能随版本变化。使用前请用 `claude --version` 与官方文档确认最新情况。
1. /loop 是什么?——一句话说清
/loop 是 Claude Code 内置的功能,可以"按一定间隔反复运行一段提示词或斜杠命令"。从技术上讲,它是一个"作用于会话范围的任务调度器",底层使用 cron(时间调度器)。
/loop = 一个让"同一条指令按你设定的间隔(或由 AI 选择的间隔)自动、反复运行"的命令。你可以在保持会话开启的同时,把需要一直盯着的杂活交出去——监视 CI/部署、照看 PR、检查耗时较长的构建等。
用通俗的话说,/loop 就是 "一个你可以拜托它每五分钟去看一眼的贴心助手"。当你忙别的事情时,AI 会在后台定期查看,一旦有变化就作出响应。而如果你省略间隔,AI 会自己拿捏时机——"事情在动,那就一分钟;现在很安静,那就三十分钟"。这正是它与单纯 cron 的决定性区别。底层 AI 智能体"自己判断、自己行动"的特性,在这里发挥得淋漓尽致。
2. 四种用法(间隔 × 提示词)
基本形式是 /loop [interval] [prompt]。间隔和提示词都是可选的,你传入什么会改变它的行为。一共有四种组合。
| 输入示例 | 行为 |
|---|---|
/loop 5m check the deploy status | 固定间隔:每 5 分钟自动运行这段提示词(基于 cron) |
/loop check the deploy status | 自适应节奏:Claude 每次根据情况判断间隔 |
/loop 15m | 仅指定间隔:每 15 分钟运行内置的"维护提示词" |
/loop | 两者都省略:按 AI 选择的间隔进行维护(继续未完成的工作 → PR/CI → 清理) |
间隔写作 数字 + 单位(s=秒,m=分,h=时,d=天)。最小为一分钟,秒数会向上取整以匹配 cron 的粒度。你也可以用自然语言书写,比如 every 2 hours。还有关键的一点——你可以传入一段斜杠命令来代替提示词。例如,下面这条会每 20 分钟循环审查某个特定的 PR:
# 循环运行斜杠命令的示例
/loop 20m /review-pr 1234
# 用自然语言指定间隔的示例
/loop check the test results every 30m
换句话说,只要加上一个间隔,你就能把"过去要手动敲的命令"自动化。如果你在意 AI 编程的成本,诀窍就是避免无意义的循环,只在需要时才运行。
3. 自适应节奏(由 AI 决定间隔)的厉害之处
四种用法中,真正让 /loop 超越"单纯 cron"的,是 自适应节奏(自动判断间隔)。省略间隔后,Claude 在每次运行结束时,会自己决定"下一次什么时候回来?"
固定间隔(cron)
- 机械地按同一间隔运行
- 即使什么都没变也照样运行
- 持续到你停止它(或满 7 天)
- 需要精确时间时最合适
自适应节奏(AI 判断)
- 活跃时等得短,安静时等得长
- AI 在 1 分钟到 1 小时之间挑选等待时长
- 每次都会显示所选间隔及其理由
- 判断任务完成后自动结束循环
这正是它的闪光点。在自适应节奏模式下让它"盯到测试通过为止",它会 在测试运行时以短间隔查看,临近结束时提高频率,一旦通过就停止循环并报告——行为很像一个人类监视者。固定间隔会出现"明明已经完成却还在白白运行",或者反过来"间隔太长以致漏掉变化";自适应节奏能避免这些。就我个人而言,我会 把自适应节奏用于不需要精确时间的监视,把固定间隔用于像定时报告这类对时间有要求的任务。
4. 实用配方集
具体例子胜过抽象描述。下面是 /loop 真正派上用场的地方,都是拿来即用的形式。
监视 CI/部署
用自适应节奏模式下达"如果 CI 变红,读日志并修复原因"。它会自动照看,直到变绿为止。
照看 PR
/loop 20m 来定期处理 PR 审查评论、解决冲突并修复 CI。
检查耗时构建
把"检查构建是否完成,若完成就进入下一步"交出去。
提醒和定时检查
也适用于一次性的预约,比如"45 分钟后,检查集成测试是否通过"。
自动维护分支
不带提示词的 /loop 会定期继续未完成的工作并执行清理。
关键在于 瞄准"过去由人定期查看的工作"。尤其是像 CI 和部署这类反复"等待 → 查看 → 响应"的活,正是 /loop 的主场。把像 PR 状态检查这样的常规监视循环起来,就能把你从一直盯着的状态中解放出来。
5. 停止方法与注意事项
尽管 /loop 很方便,但它有源于"在会话内运行"的限制。不了解这些就会出现"咦,怎么没运行?"的情况。
- 用 Esc 停止:在它等待下一次运行时按 Esc,待执行的唤醒会被清除,循环随之停止。在自适应节奏下,Claude 判断任务"完成"时也可能自行停止。
- 仅在会话开启时运行:/loop 与该会话(对话)绑定。开始新对话会清除这些任务。关闭终端同样会让它停止(7 天内可用 `claude --resume` 恢复)。
- 固定间隔最长持续 7 天:在你停止它或满 7 天之前,会一直运行。
- 每个会话最多 50 个任务:超出后无法再注册。
- 在回合(响应)之间触发:它不会在动作进行到一半时打断,而是在回合之间的间隙触发。繁忙时可能略有偏移(同时也有刻意的抖动以避免猛烈冲击 API)。时间以你的本地时区为准。
说实话,最大的坑就是 忘了"关闭会话它就停了"。/loop 并不适合 24 小时无人值守地运行。要做那件事,请用另一个功能,接下来就讲。
6. 三种调度功能如何取舍
Claude Code 其实有 三层调度。/loop 负责"会话内"这一层。它们容易混淆,我们来理一理。
| 功能 | 运行于 | 常驻 | 最适合 |
|---|---|---|---|
| /loop | 你的电脑(会话内) | ✗(仅在开启时) | 工作期间的监视/轮询(监视 CI、照看 PR) |
| Desktop scheduled tasks | 你的电脑(独立) | ✅(常驻) | 超出单次会话的本地周期性工作(审计、同步) |
| Routines(云端) | Anthropic 的云端 | ✅(无人值守运行) | 夜间构建、定时报告等全自动运维 |
* 功能名称与规格截至 2026 年。它们可能随版本或可用性变化,请以官方来源为准。
选择很简单。只想在工作期间稍微盯一下?用 /loop。想在你关闭会话后仍然继续?用 Desktop 任务。想在你电脑关着时也无人值守地运行?用云端 Routines。到底是"作为手头工作的延伸去监视",还是"即使我不在也要运行"?这一个问题就能决定。如果你认真地运行 AI 智能体,理解这三层会很有回报。
7. 自定义(loop.md)与禁用
最后再讲两个进阶用法。
- 用 loop.md 让"默认行为"成为你自己的:不带提示词的
/loop的默认动作,可以通过在 `.claude/loop.md`(项目级)或 `~/.claude/loop.md`(用户级)中写入你自己的 Markdown 来替换。例如,你可以把"你自己的监视套路"设为默认——比如"检查 release/next PR;若 CI 红了就推一个最小修复,若绿了就用一行报告"。修改会在下次运行时生效。 - 完全禁用:要停掉调度器本身,设置环境变量
CLAUDE_CODE_DISABLE_CRON=1。
loop.md 与 CLAUDE.md 这类引导文件遵循同样的思路。把"你想要定期完成的事"写下来一次,你专属的监视循环就能在不必每次敲提示词的情况下运行。
总结
下面把 Claude Code 的 /loop 理一理。
- /loop 是什么:一个作用于会话范围的调度器,按你设定的(或 AI 设定的)间隔反复运行一段提示词/斜杠命令。
- 四种用法:固定间隔 / 自适应节奏 / 仅间隔(维护)/ 两者都省略(自动维护)。
- 自适应节奏是关键:它根据活跃程度变化间隔,并在完成后自动停止。这是它与单纯 cron 的区别。
- 实战用途是监视:监视 CI/部署、照看 PR、检查构建、提醒。
- 限制:仅在会话内、最多 50 个任务、固定间隔最长 7 天、用 Esc 停止。
- 取舍:工作期间用 /loop,常驻用 Desktop 任务,无人值守用云端 Routines。
归根结底,/loop 改变的是你能交给 AI 的工作的"时间轴"。在此之前,你只能拜托它做那些在一次对话里就能完成的活;/loop 首次让你能够把 "持续性的工作——等待、再看一眼、作出响应"交给 AI。当你专注于别的事情时,循环会安静地不停转动。把你一直盯着的时间,从 AI 手里拿回来。
FAQ
Q. /loop 是什么?
A. 它是 Claude Code 内置的功能,可以按一定间隔反复运行一段提示词或斜杠命令。像 /loop 5m do X 那样指定间隔,它就会每 5 分钟自动运行一次;省略间隔,Claude 会根据情况自己决定最合适的间隔(自适应节奏)。你可以把监视 CI 和部署这类需要一直盯着的杂活交出去。
Q. 间隔怎么指定?最小是多少?
A. 用数字 + 单位(s=秒,m=分,h=时,d=天)。例如 /loop 30m 表示每 30 分钟一次。由于底层使用 cron,最小为一分钟,秒数会向上取整为分钟。你也可以用自然语言书写,比如 every 2 hours。
Q. 省略间隔会怎样?
A. 每次运行结束后,Claude 会自己决定"下一次什么时候查看"(自适应节奏)。等待时间大致在 1 分钟到 1 小时之间——活跃时短,安静时长。而当 Claude 判断任务完成时,会自动结束循环。
Q. 怎么停止正在运行的循环?
A. 在它等待下一次运行时按 Esc,待执行的唤醒会被清除,循环随之停止。此外,开始新对话会清除该会话的任务。固定间隔的循环会持续到你停止它或满 7 天为止。
Q. 关闭电脑或终端后它还会继续运行吗?
A. 不会。/loop 与会话(对话)绑定,所以关闭终端它就会停止(7 天内可用 `claude --resume` 恢复)。如果你想在电脑关着时也无人值守地运行,请使用本地常驻的 Desktop scheduled tasks,或基于云端的 Routines。
Q. 斜杠命令也能循环吗?
A. 可以。传入一段斜杠命令来代替提示词,它就会按计划运行。例如,/loop 20m /review-pr 1234 会每 20 分钟循环审查某个特定的 PR。
Q. /loop 和 Routines(云端)有什么区别?
A. /loop 在你的电脑上运行,且仅在 Claude Code 会话开启时运行——轻量,用于监视。Routines 在 Anthropic 的云端运行,即使你电脑关着也会无人值守地持续运行——用于正式的自动化运维。把 /loop 用于"工作期间的监视",把 Routines 用于"即使你不在也想运行的周期性任务"。