ClaudeCode /loop 命令是什么?
ClaudeCode 的 /loop 让 AI 自动定时执行任务,不用人盯着等结果。
- 基础用法:
/loop <interval> <prompt>,支持自然语言描述间隔 - 底层实现:cron 表达式,最小粒度 1 分钟,秒级向上取整
- 默认间隔:未指定 interval 时默认每 10 分钟执行一次
- 取消方式:用自然语言 "Cancel the job for X" 即可停止
- 自动过期:循环任务 3 天后自动删除,防忘记取消
- 触发条件:只在 ClaudeCode 空闲时跑,与对话并行不打断
- 失效场景:关闭会话即终止,不持久化、不可恢复
- 持久化方案: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 回填到 issue | PR 创建成功后 |
关键观察:整个流程无需人工介入,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
- Claude Code Scheduled Tasks —— Anthropic, 2026
- Claude Code /loop:自动任务调度实现 GitHub 项目开发自由 —— 五里墩茶社, 2026