Skip to main content

ClaudeCode /loop 命令是什么?

· 5 min read

ClaudeCode 的 /loop 让 AI 自动定时执行任务,不用人盯着等结果。

  1. 基础用法/loop <interval> <prompt>,支持自然语言描述间隔
  2. 底层实现:cron 表达式,最小粒度 1 分钟,秒级向上取整
  3. 默认间隔:未指定 interval 时默认每 10 分钟执行一次
  4. 取消方式:用自然语言 "Cancel the job for X" 即可停止
  5. 自动过期:循环任务 3 天后自动删除,防忘记取消
  6. 触发条件:只在 ClaudeCode 空闲时跑,与对话并行不打断
  7. 失效场景关闭会话即终止,不持久化、不可恢复
  8. 持久化方案:Actions Workflow、Desktop Schedule Tasks

核心定位/loop 是短周期、轻量级、可中断的自动值守,不是生产级调度。


解决什么痛点

跑部署、等 CI、等长任务完成——这些场景的共同特征是:人盯着等结果,纯属浪费时间

/loop 把「人等结果」换成「AI 等结果」。给定一个任务 + 间隔,ClaudeCode 后台周期性执行,到点就把结果直接贴到对话里。

适用场景的判断标准:

  • 间隔短(分钟级、小时级,不是天级)
  • 任务轻量(不需要重型基础设施)
  • 可容忍偶尔错过(错过的调度不补跑)

基础用法

三种写法都合法:

/loop 5m check the build status
/loop every 30 minutes check for new issues
/loop 每两小时检查一次部署进度

Claude 会把 5m 解析成 cron 表达式 */5 * * * *,把 every 30 minutes 解析成 */30 * * * *,中文描述也一样。

粒度限制:最小粒度是 1 分钟。输入「每 5 秒」会被向上取整成「每 1 分钟」——这不是 bug,是 cron 的能力上限。秒级调度本来也不适合用 /loop 这种 AI 驱动的方式做。

未指定间隔时默认 10 分钟。

自然语言取消

不需要记停止命令,直接说就行:

Cancel the job for saying hello

Claude 会识别意图并停掉对应的调度。这条体验是 /loop 最大的友好点——你完全不用关心它叫什么命令、什么语法。

实战演示:自动处理 GitHub Issue

最有价值的场景是 GitHub Issue 自动 triage

配置示例:

/loop 1m 检查是否有新的 issue,如果有:
1. 标记为 in progress
2. 创建开发分支
3. 修复问题
4. 提交代码并推送
5. 创建 PR
6. 把 PR 链接关联到 issue

跑起来后整个流程全自动:

步骤AI 行为触发时机
1扫描 GitHub Issues每分钟一次
2给新 issue 打 in progress 标签发现新 issue
3创建分支、改代码、推 PR拿到 issue 详情后
4把 PR URL 回填到 issuePR 创建成功后

关键观察:整个流程无需人工介入,PR diff 干净可合并,issue 状态自动流转。AI 完成的升级、bug fix、依赖更新都能直接进 review 队列。

三个最容易被忽略的限制

这是 /loop 最容易踩坑的地方——文档写得很清楚,但实战里很容易忽略。

限制 1:会话关闭即终止

致命限制:关闭终端、退出会话、退出 ClaudeCode——所有调度全部终止,不会持久化、不自动恢复。

/loop 不是后台 daemon,它依赖 ClaudeCode 进程存活。想要跨会话、跨机器持续运行,必须用:

  • GitHub Actions Workflow
  • Desktop Schedule Tasks
  • 系统级 cron + 脚本

限制 2:与 Claude 对话时排队不补跑

如果当前正和 Claude 聊天,/loop 的任务会排队等待,不会打断当前对话

更严格地说:错过的调度不会补跑。空闲后只执行一次,下一个周期才继续轮询。

实际场景举例:

  • 你和 Claude 聊了 10 分钟,这 10 分钟里 /loop 没运行
  • 你发完消息后,/loop 跑一次,下个周期再跑
  • 不会「追着跑」10 次来弥补错过的轮询

这意味着 /loop 不适合强实时性场景(轮询 Webhook、监控告警),适合「结果出来人能接受晚几分钟看」的协作场景。

限制 3:3 天自动过期

循环任务 3 天后自动删除。

这个设计的本意是兜底——防止你忘了取消一个会反复执行的任务(比如每分钟部署一次)。但副作用是:长周期任务不能依赖 /loop,必须自己用 Actions 或 systemd。

持久化替代方案

需要长期稳定运行时,/loop 不是合适工具:

场景方案优势
GitHub 仓库自动化Actions Workflow免费、与 repo 集成、可观测
桌面端定时任务Desktop Schedule Tasks侧边栏可回看每次完整记录
服务器后台任务systemd / cron跨会话稳定、跨机器可靠

决策原则

  • 分钟级、轻量级、可中断、人在场 → /loop
  • 小时级、生产环境、需要持久化、人不在场 → Actions / cron

References

  1. Claude Code Scheduled Tasks —— Anthropic, 2026
  2. Claude Code /loop:自动任务调度实现 GitHub 项目开发自由 —— 五里墩茶社, 2026