注册
Claude

Claude Code 定时任务、循环执行：/loop 怎么写，云端、桌面、会话内三种定时方式怎么选

Claude Code 有三种定时执行：会话内的 /loop 和 cron 工具、桌面应用的本地定时任务、云端定时任务。本文按官方文档讲 /loop 的三种写法、一次性提醒、7 天过期、停止方法、cron 写法，以及什么时候该换成桌面或云端任务。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-05 · 依据官方文档与公开资料整理 Pro 账号
本文根据 Claude Code 官方文档《Run prompts on a schedule》《Automate work with scheduled tasks》《Schedule recurring tasks in Claude Code Desktop》整理，资料核对于 2026-11-05。配图为本站整理的示意图，不是界面截图。本站（bigolab.com）不是 Anthropic 官方网站。

适用于谁

  • 想让 Claude Code 每隔几分钟检查一次部署、PR 或构建的人；
  • 想设一个「45 分钟后提醒我」的人；
  • 想让它每天早上自动跑代码评审、不想一直开着终端的人。

结论先说

  1. 官方有三种定时方式：会话内的 /loop（只在会话开着时有效）、桌面应用的本地定时任务（电脑开着即可，不需要会话开着）、云端定时任务（不需要你的电脑）。
  2. /loop 最快：例如 /loop 5m check the deploy。间隔和提示词都可以省略，省略的内容决定行为。
  3. 会话内的循环不是永久的：循环任务创建 7 天后自动过期（最后触发一次后删除），要更久得用桌面或云端任务。
  4. 关了终端就不再触发：会话内任务只在 Claude Code 运行且空闲时触发，关闭终端或会话退出就停了。
  5. 停止方法因类型而异：自定间隔的循环可以按 Esc；固定间隔的要让 Claude 取消。

三种定时方式对照

图：本站根据 Claude Code 官方文档：Run prompts on a schedule 整理的示意图

一、/loop 的三种写法

按官方表格：

| 你提供什么 | 示例 | 效果 |

| :- | :- | :- |

| 间隔和提示 | /loop 5m check the deploy | 按固定间隔运行 |

| 只有提示 | /loop check the deploy | 每轮由 Claude 选下一次的间隔 |

| 只有间隔或什么都不写 | /loop | 运行内置的维护提示，或你的 loop.md |

固定间隔：间隔可以放在提示前面（如 30m），也可以写成后面的子句（如 every 2 hours）；单位支持 s、m、h、d。因为 cron 最小粒度是一分钟，秒会向上取整；7m、90m 这类不能整除的间隔会被取成最近的合适值，Claude 会告诉你它选了什么。

让 Claude 选间隔：不写间隔时，每轮结束后 Claude 根据观察到的情况在 1 分钟到 1 小时之间选下一次的延迟：构建快完成或 PR 活跃时短，没有待办时长，并在每轮末尾打印所选延迟和理由。官方示例：

text
/loop check whether CI passed and address any review comments

内置维护提示：只输入 /loop 时，Claude 依次做：继续对话中未完成的工作；处理当前分支 PR 的评审意见、失败的 CI、合并冲突；没有其他事时做清理（找 bug、简化）。官方说它不会开启范围之外的新事项，推送、删除这类不可逆操作只在对话里已经授权的前提下才继续。

也可以把技能当提示，例如 /loop 20m /review-pr 1234。但内置命令（如 /model、/clear）、标了 disable-model-invocation: true 的技能等，会被当作普通文本而不执行。

二、用 loop.md 自定义默认提示

建一个 Markdown 文件替换内置维护提示：项目级 .claude/loop.md（优先），用户级 ~/.claude/loop.md。官方示例：

markdown
Check the `release/next` PR. If CI is red, pull the failing job log,
diagnose, and push a minimal fix. If new review comments have arrived,
address each one and resolve the thread. If everything is green and
quiet, say so in one line.

要点：它只定义裸 /loop 的默认提示，你在命令行里给了提示就会被忽略；修改在下一轮生效；超过 25,000 字节的内容会被截断。

三、一次性提醒

不用 /loop，直接用自然语言说，Claude 会建一个单次触发、执行后自动删除的任务：

text
remind me at 3pm to push the release branch
text
in 45 minutes, check whether the integration tests passed

四、查看、取消、停止

/loop 怎么写、怎么停

图：本站根据 Claude Code 官方文档：Run prompts on a schedule 整理的示意图

  • 用自然语言：what scheduled tasks do I have?、cancel the deploy check job；
  • 背后的工具：CronCreate（建任务，接受 5 段式 cron 表达式）、CronList（列出，含 ID、计划、下次运行时间）、CronDelete（按 ID 取消）；一个会话最多同时有 50 个任务；
  • 停止自定间隔的循环：等待下一轮时按 Esc，或 Claude 空闲时按 Ctrl+C，会看到 Pending wakeup cancelled；
  • 停止固定间隔的循环：让 Claude 取消，例如 cancel the deploy check loop，Esc 和 Ctrl+C 对它无效；
  • 不取消的话，7 天后自动结束。

五、cron 写法与时间偏移

CronCreate 接受标准 5 段 cron：分 时 日 月 星期，支持 、单值、步长（/15）、范围（1-5）、列表（1,15,30）。官方示例：/5 每 5 分钟，0 9 * 1-5 工作日早 9 点（本地时间）。不支持 L、W、? 和 MON 这类别名。

触发时间可能有偏差：官方说为避免大量会话同一时刻访问 API，Claude Code 会错开运行时间——周期任务会晚一点（每 5 分钟一次的 /5 * 除外），最多晚到间隔的一半且不超过 30 分钟；整点或半点的一次性任务会稍早运行。

六、限制：什么时候该换别的方式

  • 任务只在 Claude Code 运行且空闲时触发；
  • 错过的触发不补：Claude 忙于长请求期间错过的，空闲后只触发一次；
  • --resume 或 --continue 恢复会话时会恢复未过期的任务，已过期的周期任务和已过时间的一次性任务除外；
  • 需要独立于会话的定时：用云端定时任务（原名 routines，官方标注研究预览，最短间隔 1 小时，在 Anthropic 管理的云端运行，每次是全新克隆，不能读本地文件）、桌面定时任务（本机运行，能访问本地文件和工具，但只在应用开着且电脑未休眠时触发），或 GitHub Actions。云端任务还可以用 API 请求或 GitHub 事件触发，见 /guides/claude-code-web、/guides/claude-code-github-actions 和 /guides/claude-code-desktop；
  • 想完全关闭：设环境变量 CLAUDE_CODE_DISABLE_CRON=1，/loop 和 cron 工具都不可用，已建任务也不再触发。

事件驱动（不用轮询）的场景官方指向 Channels；想让会话朝一个条件持续工作而不是按间隔，指向 /goal。

七、费用提醒

每一轮循环都是一次完整的模型调用，会消耗额度；间隔越短、提示越复杂，用得越快。额度与限额说明见 /guides/claude-usage-limits，需要更多额度可了解 /chongzhi/claude-code。无人值守地跑时，权限提示的处理见 /guides/claude-code-permission-modes，也可以看 /guides/claude-code-headless-mode 里的非交互用法。

常见问题

Q：关掉电脑，/loop 还会跑吗？

不会。会话内任务要求 Claude Code 在运行。要不依赖电脑，用云端定时任务。

Q：/loop 能一直跑下去吗？

不能，周期任务 7 天后过期；需要长期运行的，用桌面或云端任务，或到期前重新创建。

Q：怎么知道下次什么时候跑？

让 Claude 列出任务，CronList 的行里有 next run 时间（官方说需要 Claude Code v2.1.299 或更高）。

相关教程

参考资料

  • Claude Code 官方文档：Run prompts on a schedule — https://code.claude.com/docs/en/scheduled-tasks
  • Claude Code 官方文档：Automate work with scheduled tasks — https://code.claude.com/docs/en/routines
  • Claude Code 官方文档：Schedule recurring tasks in Claude Code Desktop — https://code.claude.com/docs/en/desktop-scheduled-tasks

Nathaniel 的更多内容

  1. 01

    Claude Code 在 Windows 上的常见坑：Git Bash 还是 PowerShell、路径反斜杠、假报错、WSL 怎么选

    Windows 上用 Claude Code，装好之后最容易踩的是：用哪个 shell、路径写法不一致、grep 没匹配就报错、钩子没生效、WSL 和原生怎么选。本文逐条按官方文档整理原因和处理办法，附三段提示词和一张对照表。

    Claude0
  2. 02

    Claude Code Hooks 实战「提交前自动跑测试」：PreToolUse 拦住 git commit，测试不过就退出码 2，附 Windows 注意点

    只写一个完整例子：让 Claude Code 每次要执行 git commit 之前，先自动跑项目测试，没通过就拦下并把输出交给它修。本文按官方 Hooks 文档给出脚本、settings.json 配置、测试方法、排错和 Windows 的两处坑。

    Claude0
  3. 03

    Claude Code 自定义斜杠命令与 Skill 实战：从零写一个「生成更新日志」的 /release-notes，含传参、预执行命令和调试

    概念看过了，还是不知道从哪下手？本文按 Claude Code 官方「Extend Claude with skills」写一个完整可用的例子：用 /release-notes 根据 git 记录生成更新日志，覆盖目录、frontmatter、传参、预执行命令、预授权和调试。

    Claude0
  4. 04

    Claude Code 部署网站：先写 Dockerfile 和 compose 在本机跑通，再按清单上云服务器，别让它直接改线上

    想让 Claude Code 帮你把网站部署到云服务器。本文只写通用做法，按 Docker 官方文档讲：让它写 Dockerfile、.dockerignore 和 compose，在本机跑通，端口和数据卷怎么设，再给出上线清单，并说明为什么不要让它直接动线上机器。

    Claude0
  5. 05

    Claude Code 写爬虫与数据清洗：先查 robots.txt 和网站条款，控制频率，原始数据留一份再清洗

    想让 Claude Code 写爬虫抓数据再清洗。本文先讲合规：robots.txt 不是授权也不是安全措施、网站条款要自己读；再讲怎么用 Python 标准库检查规则、小样本先试、保存原始数据，以及用 pandas 清洗，附四段提示词。

    Claude0
  6. 06

    Claude Code 写 Chrome 扩展：按 Manifest V3 起步，加载未打包的扩展，改了哪些文件要重新加载

    想让 Claude Code 帮你写一个 Chrome 扩展。本文按 Chrome 官方扩展文档讲：manifest.json 的最小写法、在 chrome://extensions 加载未打包的扩展、哪些改动要刷新、怎么看控制台和报错，再给四段提示词，以及权限要尽量少。

    Claude0

同产品的其他教程

  1. 01

    Claude Code 写安卓 App：Android Studio 建项目、让它用 gradlew 编译安装，报错和日志怎么喂给它

    想让 Claude Code 帮你写安卓 App。官方文档没有专门的安卓教程，本文把 Claude Code 官方工作流和安卓官方命令行文档拼在一起：Android Studio 建项目、gradlew 编译安装、模拟器和真机、测试与日志，附四段提示词。

    Claude0
  2. 02

    Claude Code 用数据库 MCP 查数据、出报表：只读账号、先看口径再看数字，结果别一次拉太多行

    想用自然语言让 Claude Code 查数据库、出统计报表，而不是写后端接口。本文按官方 MCP 页面和 DBHub 说明讲：怎么连 PostgreSQL、MySQL、SQLite、输出太大怎么办、怎么让它先说明口径、怎么核对数字，附三段提示词。

    Claude0
  3. 03

    Claude Code 配 Figma MCP 还原设计稿：插件或一条命令安装，复制图层链接，小块小块地让它出代码

    想让 Claude Code 照 Figma 设计稿写前端代码。本文按 Figma 官方开发者文档讲：远程服务器地址、插件和手动两种安装、怎么复制图层链接、为什么要选小块、座位类型与调用次数限制，并给三段还原设计稿的提示词。

    Claude0
  4. 04

    Claude Code 管理 GitHub issue：用 gh 命令还是 GitHub MCP，怎么装、怎么限权、怎么让它分拣和回复 issue

    让 Claude Code 读 issue、分拣标签、起草回复、关联 PR，有两条路：装好 gh 命令行直接用，或连 GitHub 官方 MCP 服务器。本文按两边官方文档讲安装命令、令牌权限、只读模式，并给出三段分拣提示词和限权设置。

    Claude0
  5. 05

    Claude Code 配 Playwright MCP 做浏览器测试：一条命令安装，让它打开页面、点按钮、读控制台，再把流程写成测试

    想让 Claude Code 自己打开浏览器测试你的网页。本文按微软 Playwright MCP 官方仓库和 Claude Code 官方 MCP 文档讲：安装命令、怎么确认连上、有头无头与隔离参数、一次测试的提示词，以及它不是安全边界这件事。

    Claude0
  6. 06

    Claude Code 写文档、README 和代码注释：先让它读代码再动笔，指定风格，写完逐条核对命令能不能跑

    想让 Claude Code 给项目补 README、接口文档和注释，又怕它编造不存在的命令和参数。本文按官方「Handle documentation」工作流讲：先找没有文档的代码、指定风格、写完核对，附四段可复制提示词和验证办法。

    Claude0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～