> For the complete documentation index, see [llms.txt](https://yeasy.gitbook.io/claude_guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yeasy.gitbook.io/claude_guide/di-san-bu-fen-jin-jie-pian/07_coding/7.7_routines.md).

# 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 流水线集成：

```bash
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` 更难驯服