Claude Code Routines详解：定时、API与GitHub事件触发的云端自动化开发

Claude Code 近期上线了一项面向 Pro、Max、Team 和 Enterprise 用户的新功能：Routines。

简单来说，它允许你将一段 Prompt、一个代码仓库以及一组连接器（如 Slack、Linear、Google Drive 等）打包成一个可复用的“任务流”。设定好触发条件后，Claude 便会依托 Anthropic 的云端基础设施自动执行这些任务。

这意味着，即便你关闭了本地笔记本或不在电脑前，Claude 也能在云端持续为你处理开发工作，真正实现 7x24 小时的自动化值守。

Routines 的工作流程：一次配置，即可在云端自动执行。

三种触发方式详解

Routines 支持三种触发方式，并且可以叠加使用。这意味着同一个 Routine 可以同时被定时任务、API 调用和 GitHub 事件触发。

定时触发

你可以设置一个固定的执行频率（例如每小时、每天、工作日或每周），Claude 会按照这个节奏自动运行任务。时间会根据你的本地时区进行设置，云端会自动完成时区换算。

官方给出的一个典型场景是：每天凌晨 2 点，自动从 Linear 项目中拉取最高优先级的 Bug，尝试修复，并创建一个草稿 PR。

如果你之前在 CLI 中使用 /schedule 命令创建过定时任务，它们现在会自动升级为 Routines，无需手动迁移。

API 触发

每个 Routine 都会生成一个专属的 HTTP 端点和 Bearer Token。向这个端点发送一条 POST 请求，即可触发一次执行，并会收到一个包含 session URL 的响应。

请求体中包含一个 text 字段，可以用来传递运行时的上下文信息，例如一段告警日志或一个部署结果。

curl -X POST \
  https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDE.../fire \
  -H "Authorization: Bearer sk-ant-..." \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -d '{"text": "Sentry alert fired."}'

返回值中包含 session_id 和 session_url，打开这个 URL 就能实时查看 Claude 正在执行什么操作。

需要注意的是，目前该 API 端点需要携带 experimental-cc-routine-2026-04-01 这个 Beta 请求头。接口形态在预览阶段仍可能发生变化，但 Anthropic 承诺最近两个版本的 header 会保持向下兼容。

GitHub 事件触发

你可以将 Routine 订阅到指定 GitHub 仓库的特定事件上。每一个匹配的事件都会启动一个独立的 Claude Code 会话。

支持的事件类型非常全面，包括：Pull Request 全生命周期事件（opened, closed, synchronized, labeled）、PR Review、Push、Release、Issues、Issue Comment、Discussion、Check Run、Workflow Run 等十几种。

针对 PR 触发，还支持精细化的过滤条件：可按作者、标题、正文、目标分支、来源分支、标签、是否为草稿、是否已合并、是否来自 Fork 仓库等进行筛选。

一个实用的例子是：订阅 pull_request.opened 事件，让 Claude 自动按照你团队的 Code Review 清单检查代码的安全性、性能和风格问题，并留下行内评论。这样，当人类 Reviewer 开始审查时，许多基础性的机械检查工作已经完成了。

特别值得注意的是，Claude 会持续跟踪同一个 PR 的后续事件（例如新的评论或 CI 失败），并在同一个会话中继续处理。

要使用 GitHub 触发功能，需要安装 Claude GitHub App。请注意，在 CLI 中运行 /web-setup 仅授权了仓库的克隆权限，要接收 Webhook 事件投递，需要单独安装此 App。

实际应用场景参考

官方列举了几个早期用户的典型用法，或许能给你带来启发：

定时类场景

• Backlog 管理：每晚自动对新的 Issue 进行分类、打标签、分配负责人，并向 Slack 频道发送每日摘要。
• 文档漂移检测：每周扫描已合并的 PR，标识出引用了已变更 API 的文档，并自动创建 PR 来更新文档。

API 触发类场景

• 部署验证：在 CI/CD 流水线完成部署后，调用 Routine 端点。Claude 会自动运行冒烟测试、扫描错误日志，并向发布频道发送“通过/不通过”的判断。
• 告警分流：将 Datadog 等监控工具的告警指向 Routine 端点。Claude 会拉取相关堆栈信息，关联最近的代码提交，在值班工程师收到告警通知之前，就准备好初步的修复草案。
• 反馈闭环：文档页面上的用户反馈组件可以直接将报告发送到 Routine 端点，Claude 随即打开对应仓库的会话，草拟修改内容。

GitHub 事件触发类场景

• 多语言 SDK 同步：当 Python SDK 仓库合并一个 PR 后，Routine 自动将改动移植到 Go SDK 仓库，并创建一个对应的 PR。
• 定制化 Code Review：在 PR 打开时，按照团队内部的定制化检查清单进行审查，并留下行内评论。这本身就是一项典型的 人工智能 增强开发工作流实践。

用量与限制

Routines 任务执行所消耗的额度与交互式会话相同，均从你的订阅用量中扣除。除此之外，每个账号每天还有运行次数的上限：

• Pro：每天 5 次
• Max：每天 15 次
• Team / Enterprise：每天 25 次

如果超出了每日上限，并且你开启了额外用量（extra usage）功能，超出的部分将按量计费。如果未开启，则超出后需等待次日重置。

与现有工具的核心区别

需要明确的是，Routines 既不是传统的 cron job，也不是 GitHub Actions，更不是一个完整的长周期 AI Agent。

Cron job 和 GitHub Actions 执行的是预先写好的固定脚本，不涉及 AI 模型的动态推理和判断。而一个完整的 AI Agent 通常是一个持续运行、维护内部状态的长进程。

Routines 更像是一个“按需触发的、短生命周期的 AI 值班员”。每次触发都会从一个全新的 Claude Code 会话开始，任务执行完毕后会话即结束。

每次执行时，Claude 会克隆你选定的代码仓库（默认从 default branch 开始），加载你配置好的连接器和环境变量，运行 setup script 安装依赖，然后根据你预设的 Prompt 执行任务。在此过程中，它可以运行 shell 命令、调用仓库内定义的 Skills，以及访问外部服务。

默认情况下，Claude 只能向以 claude/ 为前缀的分支推送代码。如果需要推送到其他分支，需要在创建 Routine 时为对应仓库开启 “Allow unrestricted branch pushes” 权限。

每次执行完毕后，相应的会话都会出现在你的会话历史列表中。你可以随时查看 Claude 具体做了什么、审查代码变更、创建 PR，或者继续与该会话进行对话。这意味着，一个由 Routine 自动跑完的任务，等你上班后可以在本地轻松接续处理。

需要注意的关键细节

1. 权限与归属：Routines 绑定在个人的 claude.ai 账户上，不与团队共享。Claude 在执行任务时会使用你的 GitHub 身份和连接器授权，因此产生的 commit、PR、Slack 消息等都会以你的名义出现。
2. 自主运行：Routine 在执行过程中没有权限确认弹窗，全程自主运行。因此，编写清晰、明确且自包含的 Prompt 至关重要，需要把成功标准、失败处理逻辑以及期望的输出格式都交代清楚。
3. 创建入口：目前有三个入口可以创建 Routine：Web 端 (claude.ai/code/routines)、CLI 中的 /schedule 命令，以及 Desktop App 中的 “New remote task” 选项。这三个入口创建的 Routine 是互通的。
4. 预览期限制：GitHub 事件触发在预览阶段存在每小时调用上限（包括 per-routine 和 per-account 两层限制），超出上限的事件将被丢弃。

功能背后的趋势信号

Routines 解决的是一个很具体的问题：将那些“无需人工值守、可重复、目标清晰”的开发任务，从本地环境迁移到云端自动执行。

纵观 Anthropic 近期的动作——Managed Agents、Cowork 的正式发布、Advisor Tool，再到现在的 Routines——可以看出 Claude Code 正在从一个“你与它对话”的辅助工具，演变为一个“由你部署”的自动化服务。其战略思路似乎是：本地环境优先处理需要人类介入的复杂决策，而将基础的、重复性的任务交由云端自动化接管。

随着模型能力的持续提升，所谓“基础性任务”的范畴必然会不断扩大。这种将 AI 能力作为 智能 & 数据 & 云 基础设施来部署的趋势，值得开发者关注。

目前该功能仍处于研究预览阶段，存在较多限制，接口也可能发生变化。Anthropic 表示后续计划将 Webhook 触发机制扩展到 GitHub 之外更多的事件源。

对于独立开发者而言，这个功能可能用处有限（例如 Pro 版每天仅 5 次），但对于拥有活跃代码仓库和成熟协作流程的团队来说，Routines 很可能会迅速融入日常的开发运维工作流中。

参考材料

• Introducing routines in Claude Code（官方博客）: https://claude.com/blog/introducing-routines-in-claude-code
• Automate work with routines（官方文档）: https://code.claude.com/docs/en/routines