Claude Code 定时任务(原 Routines)怎么用:/schedule、API 触发、GitHub 触发与每小时限制(2026)
一句话结论
定时任务(scheduled tasks,以前叫 routines)是一份保存好的 Claude Code 配置:提示词 + 一个或多个仓库 + 连接器,按设定自动在云端运行,电脑关着也会执行。可以按时间(每小时、每天、每周或某个时间点跑一次)、按 API 调用、或按 GitHub 事件(如新 PR、新 release)触发。Pro、Max、Team、Enterprise 可用,在 claude.ai/code/routines 或命令行 /schedule 创建。目前是研究预览,行为和限制可能变化。
阅读说明
官方信息查阅日期:2026-10-24,来源:Claude Code 官方文档「Automate work with scheduled tasks」。
适合做什么
官方给的用法都是「无人值守、可重复、结果明确」的工作,例如:每晚汇总当天合并的 PR、每个新 PR 自动做一遍审查、部署脚本跑完后触发检查、某个功能开关上线两周后自动开清理 PR。
创建方式
网页:打开 claude.ai/code/routines,新建任务,填提示词、选仓库、选连接器和触发方式。
命令行:在任意会话里运行 /schedule,用自然语言描述即可,例如:
/schedule daily PR review at 9am
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
Claude 会把时间换算成具体时间点并让你确认后保存。/routines 是 /schedule 的别名。
定时任务以你的身份执行
任务属于你个人的 claude.ai 账号,不和同事共享;它通过 GitHub 或连接器做的事都显示为你本人,提交和 PR 用你的 GitHub 身份。创建时默认带上你已连接的所有连接器,不需要的建议移除。
三种触发方式
| 触发 | 说明 |
|---|---|
| 时间表 | 预设每小时 / 每天 / 每周,或一次性定时;自定义间隔在编辑框里选 Custom 填 cron(如 0 */2 * * *)。官方提示整点任务可能晚几分钟开始,想准时可以设成 9:07 这类非整点 |
| API | 每个任务有自己的接口,带 bearer token 发 HTTP POST 即可触发(/fire 接口,目前带 beta 请求头) |
| GitHub | 仓库事件(如 PR、release)发生时自动运行;webhook 事件有按任务和按账号的每小时上限,超出的事件会被丢弃 |
一个任务可以同时挂多个触发器,比如每晚跑一次、部署后跑一次、每个新 PR 也跑一次。
用量与限制
- 定时任务和交互式会话一样消耗订阅用量,可在
claude.ai/settings/usage查看; - 另有按小时的启动次数上限(均不能超额购买):
| 动作 | 上限 | 计算范围 |
|---|---|---|
| 按时间表运行(含一次性) | 每小时 100 次 | 你的账号;超出后排队等下一个窗口 |
| 立即运行 + API 触发 + 重跑一次性任务 | 每小时 30 次 | 每个任务,三者共用 |
| 立即运行 + 重跑一次性任务 | 每小时 100 次 | 你的账号 |
| API 触发 | 每小时 100 次 | 你的账号,与「立即运行」分开算 |
- 用完订阅额度后:开了 usage credits 的可以按量继续跑,否则在额度重置前新的运行会被拒绝;
- 订阅暂停期间任务会挂起,恢复订阅后要手动重新打开。
常见问题与报错
/schedule 显示 Unknown command 或搜不到
常见原因:用 Console API key、Bedrock / Google Cloud / Foundry 等方式登录(/schedule 需要 claude.ai 订阅登录);完全没登录;在云端会话里面运行;组织关闭了云端会话或定时任务;Enterprise 自定义角色里没有定时任务权限。前两种情况仍可以在 claude.ai/code/routines 网页上创建。
Routines are disabled by your organization's policy
Team / Enterprise 的 Owner 在组织设置 → Capabilities → Remote sessions 关掉了 Scheduled tasks (Was Routines)。这是服务器端设置,本地改不了,只能请 Owner 打开。
和桌面版定时任务、/loop 有什么区别?
那两种在你自己的电脑上跑,电脑要开着;云端定时任务在 Anthropic 托管环境里跑。云端会话本身的用法见 Claude Code 网页版与云端会话。
相关阅读
- Claude Code Remote Control:手机远程接管电脑上的会话
- Claude Code 代码审查:/code-review、ultrareview 与 Code Review
- Claude Code 用量限制
参考来源(官方)
- Claude Code Docs · Automate work with scheduled tasks:https://code.claude.com/docs/en/routines(查阅日期:2026-10-24)