Claude Code Routines:把 AI 编程助手变成定时任务

Claude Code Routines 是 Anthropic 推出的云端自动化功能(研究预览阶段):把一个提示词 + 代码仓库 + 连接器打包成一条例行任务,支持定时触发、API 触发和 GitHub 事件触发,在 Anthropic 管理的云基础设施上无人值守地运行。本文介绍它的核心概念、三种触发方式、典型用例和使用限制。

阅读时长: 4 分钟
共 1755字
作者: longlikun

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。

创建方式

三个入口,写入同一个云端账号,随时互通:

  • Webclaude.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,内容以官方文档为准。

关于

关注我获取更多资讯

月球基地博客公众号二维码,扫码关注获取更多 AI 与编程资讯
📢 公众号
月球基地博客作者个人微信二维码,扫码交流 AI 与编程话题
💬 个人号
使用 Hugo 构建
主题 StackJimmy 设计