"构建完成了就告诉我。""CI 变红了就修好它。""每 5 分钟盯一下部署。"如果能把这些需要一直盯着的杂活整个交给 AI,会怎样?2026 年加入 Claude Code/loop 命令做的正是这件事。它会按你设定的间隔——或由 AI 自己决定的间隔——反复运行一段提示词或斜杠命令,相当于会话内的"监视者"和"重复者"。

先把结论摆出来。/loop 填补了"我现在就想查一下"和"我想要全天候 24 小时自动化"之间的空白。输入 /loop 5m check the deploy status,它就会每五分钟自动运行一次。省略间隔,Claude 会观察情况,自己挑选最合适的等待时间(自适应节奏)。本文面向初学者讲解四种用法、自适应节奏的原理、实用配方、如何停止以及需要注意什么,还有它与相关功能(Desktop 任务、云端 Routines)的区别。请注意,/loop 是新功能,行为可能会变化,最新信息请查阅官方文档(本文基于 2026 年的信息)。

Claude Code · /loop 命令

按你设定的间隔,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 用于"即使你不在也想运行的周期性任务"。