7.7 Routines：Claude Code 自动化任务

Routine 是 Claude Code 的自动化能力扩展——你只需配置一次（提示词、仓库、连接器），此后 Claude 就可以按计划自动执行、响应 API 调用或在 GitHub 事件发生时触发运行。

💡 Routines 于 2026 年 4 月 14 日推出（研究预览），适用于 Pro、Max、Team 和 Enterprise 计划。

7.7.1 三种触发模式

Scheduled Routine（定时触发）

按 Cron 表达式周期性运行。典型场景：

• “每晚 2 点：从 Linear 拉取优先级最高的 Bug，尝试修复并开 Draft PR”

• “每周一早上：检查文档是否与代码同步，偏差超过阈值则发 Slack 通知”

API Routine（HTTP 触发）

通过 HTTP POST 请求触发，支持自定义 Payload。适合与告警系统、部署钩子、CI/CD 流水线集成：

export ROUTINE_FIRE_URL="https://api.anthropic.com/v1/claude_code/routines/trig_.../fire"
export ROUTINE_TOKEN="<per-routine-token>"

curl -X POST "$ROUTINE_FIRE_URL" \
  -H "Authorization: Bearer $ROUTINE_TOKEN" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text":"High Error Rate in payment-api. Dashboard: https://..."}'

ROUTINE_TOKEN 是每个 Routine 单独生成的 Bearer token，应通过本地 secret 管理或 CI secret 注入，不要写入脚本、仓库或日志。

Claude 接收到 Payload 后启动独立会话，分析问题并执行预设的修复流程。

Webhook Routine（GitHub 事件触发）

自动响应 GitHub 仓库事件。官方目前支持两类事件：Pull request（PR 创建/关闭/指派/打标签/同步等）与 Release（创建/发布/编辑/删除）。Claude 为每个匹配的事件创建独立会话，并能处理后续更新：

• PR 创建时自动进行代码审查

• Release 发布时自动生成变更摘要

• 其他事件（如 CI 失败、Issue 评论）可由 CI/监控系统经 API 触发 间接接入

7.7.2 执行限额

Routines 有账号级每日运行上限；当前消耗和剩余额度以 claude.ai/code/routines 或 claude.ai/settings/usage 显示为准。一次性运行不计入每日 routine run cap。

7.7.3 常见使用模式

模式	触发方式	描述
夜间积压分诊	Scheduled	每晚扫描 Backlog，按优先级整理并发 Slack 摘要
文档漂移检测	Scheduled（每周）	对比代码与文档，标记不一致之处
部署后验证	API（部署钩子）	部署完成后自动运行冒烟测试
告警关联分析	API（监控系统）	收到告警后关联近期变更，定位根因
PR 自动审查	Webhook（PR 创建）	对新 PR 执行安全/性能/风格审查
CI 失败修复	API（CI 系统回调）	分析失败日志，尝试修复并推送

7.7.4 最佳实践

• 提示词设计：Routine 的提示词应明确定义“完成”标准，避免 Agent 陷入无限循环

• 幂等性：确保 Routine 多次执行不会产生副作用（如重复创建 PR）

• 结果通知：将执行结果推送到 Slack、GitHub Discussion 或邮件，便于团队追踪

• 资源限制：为 Routine 设置合理的执行时长和 Token 上限

• 监控告警：对连续失败的 Routine 设置告警，避免“沉默失败”

7.7.5 本地 /goal//loop vs 云端 /schedule

Claude Code 同时提供本地自动化原语（见 7.6.11）和云端 Routines（/schedule），两者面向不同场景：

维度	本地 /goal + /loop	云端 /schedule（Routine）
触发方式	当前会话内驱动	Cron / HTTP / GitHub Webhook
持续时间	终端关闭即结束（除非配合 claude --bg 后台会话）	笔记本关机仍继续，云端运行
状态可见性	当前 TUI 直接看到	claude.ai/code/routines 后台
适合场景	“今天下午我想离开半小时让它跑完测试”	“每晚 2 点扫积压、PR 创建时自动审”
计入额度	你的会话 Token 用量	Routine 每日运行上限

实操建议：

1. 可验证的短任务用 /goal——比如让 Claude 把 lint 修干净、把测试跑绿

2. 定时/事件触发用 /schedule——比如每周文档漂移检测、PR 自动审查

3. 跨设备协作用 claude --bg + claude agents——后台会话比 Routine 灵活，但比 /goal 更难驯服