Claude Code Routines 是 Anthropic 在 2026 年推出的一项研究预览功能,思路很直接:把 Claude Code 变成一个能自动跑、不用你盯着的"定时任务"。
配好提示词、关掉笔记本,它在云端跑完、推 PR、发 Slack 通知——你睡醒后审阅就行。
什么是 Routine
一条 Routine 由三部分组成:
- Prompt(提示词):告诉 Claude 每次运行要干什么,必须写得足够具体,因为运行是无人值守的
- Repositories(代码仓库):Claude 每次运行时会克隆的 GitHub 仓库
- Connectors(连接器):你挂在 claude.ai 上的 MCP 集成(Slack、Linear、Notion 等)
Routine 运行在 Anthropic 管理的云基础设施上,不依赖你的本地机器——你的笔记本关掉、网络断掉,它照样跑。
每条 Routine 可以绑定一个或多个触发器,同一条 Routine 可以同时响应定时、API 调用和 GitHub 事件。
三种触发方式
1. 定时触发(Schedule)
和 cron 一样,支持按小时、每天、工作日、每周触发,也支持指定一个未来的具体时间点一次性触发。
时间以你的本地时区输入,自动换算成 UTC,云端按你预期的墙钟时间运行。最小间隔是 1 小时,更频繁的 cron 表达式会被拒绝。
一次性触发不占每日 Routine 运行配额,按普通会话计费。
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
2. API 触发
每条 Routine 生成一个专属 HTTP 端点,对它 POST 就能立刻启动一次运行。适合接入告警系统、部署流水线或内部工具。
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
-H "Authorization: Bearer sk-ant-oat01-xxxxx" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
text 字段是可选的运行时上下文,比如把告警正文、失败日志传进去,Claude 会把它和 Prompt 一起用。
请求成功后返回一个 session_url,可以在浏览器里实时查看运行过程。
3. GitHub 事件触发
绑定一个 GitHub 仓库,在指定事件(PR 打开/关闭/更新、Release 发布等)触发时自动启动。每个匹配的事件启动一次独立会话。
支持过滤:PR 作者、标题、正文、目标分支、来源分支、标签、是否草稿、是否已合并。多个条件之间是 AND 关系。
实际用法举例:
| 过滤条件 | 效果 |
|---|---|
目标分支 = main,来源分支包含 auth-provider |
只针对触碰认证模块的 PR 启动专项 review |
| is draft = false | 跳过草稿 PR,只在准备好 review 时触发 |
labels 包含 needs-backport |
只有维护者打上标签后才触发回合并操作 |
典型用例
官方文档给出的几个场景,值得直接借鉴:
Backlog 维护:每晚定时跑,读取 Issue Tracker(通过 connector),自动打标签、分配负责人,然后把摘要发到 Slack。团队早上上班就有整理好的队列。
告警分诊:监控系统触发 API 调用,把 stack trace 传进来,Claude 关联最近的 commit,自动开一个包含修复建议的草稿 PR。On-call 工程师 review PR 而不是从空白终端开始排查。
定制化 Code Review:每个新 PR 打开时触发 GitHub 事件,Claude 按你团队的 checklist 做检查——安全、性能、代码风格——留下行内注释,人工 review 专注架构决策而不是机械检查。
上线后验证:CD 流水线部署完成后调 API,Claude 跑 smoke test、扫错误日志,在部署窗口关闭前给出 go/no-go 结论。
文档漂移修复:每周扫一遍合并的 PR,找到引用了已变更 API 的文档,自动对 docs 仓库开 update PR。
SDK 同步:一个 SDK 的 PR 合并后,自动把改动移植到另一个语言版本的 SDK,并开同名 PR。
创建方式
三个入口,写入同一个云端账号,随时互通:
- Web:
claude.ai/code/routines→ New routine - Desktop 应用:侧边栏 → Routines → New routine → 选 Remote(选 Local 会创建本地定时任务,只在你的机器上跑)
- CLI:在任意会话里输入
/schedule,用自然语言描述任务和时间
API 和 GitHub 触发器目前只能在 Web 上配置;CLI 的 /schedule 只能创建定时类型的 Routine。
权限与网络
Routine 运行时没有权限确认弹窗,完全自主执行。控制它能做什么的是:
- 仓库设置:默认只能推
claude/前缀的分支;如需推到现有分支,手动开启 “Allow unrestricted branch pushes” - 云端环境(Environment):控制网络访问级别(Trusted / Custom / Full)和环境变量
- Connectors:只保留 Routine 实际需要的,删掉多余的
Routine 的任何操作以你的身份出现:commit、PR、Slack 消息都是你的账号。
使用限制
- 计划:Pro、Max、Team、Enterprise,且需要开启 Claude Code on the web
- 每日运行上限:Pro 5 次 / Max 15 次 / Team & Enterprise 25 次(一次性触发不占配额)
- 最小定时间隔:1 小时
- 状态:研究预览阶段,接口和行为可能变更
本文改写自 Claude Code 官方文档 Automate work with routines,内容以官方文档为准。
关于
关注我获取更多资讯