Claude Code Routines:定时云端智能体、子例程与协同例程
按计划、通过 API 调用或在 GitHub 事件发生时运行 Claude Code,无需笔记本电脑,也无需服务器。五分钟快速指南。
Claude Code 不再需要你守在键盘前。Routines(例程)会按计划、通过 API 调用或在 GitHub 上发生特定事件时,在 Anthropic 的云端运行已保存的智能体任务。本文介绍它是什么、如何设置,以及我们称之为“子例程”(sub-routines)和“协同例程”(co-routines)的两种模式。完整指南请阅读这篇长文。
核心结论。Routine 是一项只需配置一次(提示词、代码仓库、云环境、连接器)即可自动触发的 Claude Code 任务。它在云端以完整的自主会话运行,因此你的笔记本电脑可以一直合着。Routines 目前处于研究预览阶段(自 2026 年 4 月 14 日起),面向 Pro、Max、Team 和 Enterprise 套餐开放。
启动 routine 的三种方式
- 定时:每小时、每天、每个工作日、每周或某个一次性时间点,按你的本地时区填写。可通过
/schedule update使用自定义 cron,最小间隔为一小时。 - API:每个 routine 都有独立的 HTTPS 端点和专属 bearer 令牌。你的告警工具或部署流水线向它发送 POST 请求,并可附带上下文文本。这段文本会被标记为不可信数据,因此即使令牌泄露,也无法改写 routine 的指令。
- GitHub:拉取请求或发布(release)事件,可按分支、标签、作者、草稿状态或合并状态过滤。
两分钟完成设置
- 打开
claude.ai/code/routines并选择 New routine,或在 Claude Code CLI 中输入/schedule。 - 编写一个自成一体的提示词:说明范围、允许的操作、输出目标,以及无事可做时该怎么办。
- 选择代码仓库和环境。移除任务用不到的连接器,因为默认会包含全部连接器。
- 添加触发器,选择 Run now 进行测试,然后阅读运行记录。绿色徽标只表示会话已运行,并不代表任务成功完成。
子例程:一次运行,多个助手
这是我们为一种模式起的名字,并非 Anthropic 的正式功能。由 routine 的提示词负责编排,把每个步骤交给提交在仓库中的子智能体(.claude/agents/)或技能(skill)。每个助手拥有独立的上下文窗口,且只获得所需的工具,从而让长时间无人值守的运行更专注、更省成本、也更安全。
协同例程:相互交接工作的 routines
Routines 之间无法直接调用,但可以通过持久化的产物协作。例如:一个夜间 routine 创建草稿 PR,一个由 GitHub 触发的 routine 对其进行评审,由人工合并,再由合并事件触发的 routine 更新文档,最后你的部署流水线调用一个验证 routine。请使用过滤条件,避免任何 routine 被自己的产出触发,并在链路中保留人工合并这道关卡。
值得了解的限制
- 上线时的每日运行上限为:Pro 5 次,Max 15 次,Team 和 Enterprise 25 次,且在正常订阅用量之外另行计算。一次性运行不计入上限。
- Routines 以你本人的身份执行操作。提交、PR 和 Slack 消息都带有你的身份。除非另有指示,Claude 只会推送到
claude/分支,并且绝不会推送到受保护分支。 - 需要分钟级轮询或访问本地文件?请改用
/loop或桌面端定时任务。
延伸阅读:完整指南涵盖 API 载荷安全、提示词模板、子智能体示例、与 GitHub Actions、n8n 和 Trigger.dev 的对比,以及一份治理检查清单。资料来源:Anthropic 官方公告 · Claude Code 文档。