计划任务需要 Claude Code v2.1.72 或更高版本。使用 claude --version 检查您的版本。
比较调度选项
Claude Code offers three ways to schedule recurring work:
| Cloud | Desktop | /loop |
|---|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | No (session-scoped) |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | Config files and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via /schedule in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.
使用 /loop 计划重复提示词
/loop 捆绑技能是计划重复提示词的最快方式。传递可选的间隔和提示词，Claude 会设置一个在后台运行的 cron 作业，同时会话保持打开。
/loop 5m check if the deployment finished and tell me what happened
间隔语法
间隔是可选的。您可以在开头使用它们、在末尾使用它们，或完全省略它们。
| 形式 | 示例 | 解析的间隔 |
|---|
| 前导令牌 | /loop 30m check the build | 每 30 分钟 |
尾部 every 子句 | /loop check the build every 2 hours | 每 2 小时 |
| 无间隔 | /loop check the build | 默认为每 10 分钟 |
s 表示秒、m 表示分钟、h 表示小时、d 表示天。秒数向上舍入到最近的分钟，因为 cron 的粒度为一分钟。不能均匀分割其单位的间隔，例如 7m 或 90m，会舍入到最近的整数间隔，Claude 会告诉您它选择了什么。
循环另一个命令
计划的提示词本身可以是命令或技能调用。这对于重新运行您已经打包的工作流很有用。
/loop 20m /review-pr 1234
/review-pr 1234，就像您输入了它一样。
设置一次性提醒
对于一次性提醒，用自然语言描述您想要的内容，而不是使用 /loop。Claude 计划一个单次触发的任务，该任务在运行后删除自己。
remind me at 3pm to push the release branch
in 45 minutes, check whether the integration tests passed
管理计划任务
用自然语言要求 Claude 列出或取消任务，或直接引用底层工具。
what scheduled tasks do I have?
cancel the deploy check job
| 工具 | 目的 |
|---|
CronCreate | 计划新任务。接受 5 字段 cron 表达式、要运行的提示词以及是否重复或仅触发一次。 |
CronList | 列出所有计划任务及其 ID、计划和提示词。 |
CronDelete | 按 ID 取消任务。 |
CronDelete。一个会话最多可以同时保存 50 个计划任务。
计划任务如何运行
调度程序每秒检查一次到期的任务，并以低优先级将其加入队列。计划的提示词在您的回合之间触发，而不是在 Claude 正在响应时。如果 Claude 在任务到期时忙碌，提示词会等到当前回合结束。
所有时间都在您的本地时区中解释。像 0 9 * * * 这样的 cron 表达式意味着 9am 在您运行 Claude Code 的任何地方，而不是 UTC。
为了避免每个会话在同一个挂钟时刻击中 API，调度程序会向触发时间添加一个小的确定性偏移：
- 重复任务最多晚触发其周期的 10%，上限为 15 分钟。每小时的作业可能在
:00 到 :06 之间的任何时间触发。
- 为小时顶部或底部计划的一次性任务最多提前 90 秒触发。
偏移是从任务 ID 派生的，所以相同的任务总是获得相同的偏移。如果精确的时间很重要，选择不是 :00 或 :30 的分钟，例如 3 9 * * * 而不是 0 9 * * *，一次性抖动将不适用。
三天过期
重复任务在创建后 3 天自动过期。任务最后触发一次，然后删除自己。这限制了被遗忘的循环可以运行多长时间。如果您需要重复任务持续更长时间，请在过期前取消并重新创建它，或使用 Cloud 计划任务 或 Desktop 计划任务 进行持久调度。
Cron 表达式参考
CronCreate 接受标准 5 字段 cron 表达式：minute hour day-of-month month day-of-week。所有字段都支持通配符 (*)、单个值 (5)、步长 (*/15)、范围 (1-5) 和逗号分隔的列表 (1,15,30)。
| 示例 | 含义 |
|---|
*/5 * * * * | 每 5 分钟 |
0 * * * * | 每小时整点 |
7 * * * * | 每小时的第 7 分钟 |
0 9 * * * | 每天本地时间 9am |
0 9 * * 1-5 | 工作日本地时间 9am |
30 14 15 3 * | 3 月 15 日本地时间下午 2:30 |
0 或 7 表示星期日，6 表示星期六。不支持扩展语法如 L、W、? 和名称别名如 MON 或 JAN。
当月份日期和星期几都受到限制时，如果任一字段匹配，日期就匹配。这遵循标准的 vixie-cron 语义。
禁用计划任务
在您的环境中设置 CLAUDE_CODE_DISABLE_CRON=1 以完全禁用调度程序。cron 工具和 /loop 变得不可用，任何已计划的任务都停止触发。有关禁用标志的完整列表，请参阅环境变量。
会话范围的调度有固有的限制：
- 任务仅在 Claude Code 运行且空闲时触发。关闭终端或让会话退出会取消所有内容。
- 没有错过触发的追赶。如果任务的计划时间在 Claude 忙于长时间运行的请求时经过，它会在 Claude 变为空闲时触发一次，而不是每个错过的间隔触发一次。
- 没有跨重启的持久性。重启 Claude Code 会清除所有会话范围的任务。
对于需要无人值守运行的 cron 驱动自动化：
