Claude Code 定时任务(原 Routines)怎么用:/schedule、API 触发、GitHub 触发与每小时限制(2026)

推荐链接(推广):数字严选大约 4 分钟ClaudeClaude CodeClaude Code 定时任务Routines/schedule

一句话结论

定时任务(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 网页版与云端会话。

相关阅读

参考来源(官方)

上次编辑于:
贡献者: Masoooon