让 Claude Code 在你不在时自动运行：定时任务、API 触发、GitHub 集成，三种方式把重复性开发工作交给 AI 代理完成。
Routines 是 Claude Code 中的研究预览功能，它允许你创建能够在特定条件下自主运行的 Claude Code 会话。
Routines 让你把日常、重复或需要及时响应的开发任务自动化—— backlog 维护、告警处理、代码审查、文档更新，都可以交给 Claude Code 在后台完成。
Routines 不是简单的定时脚本，而是完整的 Claude Code 会话。它们可以读取代码库、运行命令、打开 PR、发送通知，像真人开发者一样工作。
支持三种触发器：按计划执行（Scheduled）、通过 API 调用触发（API）、以及 GitHub 事件触发（GitHub）。
在云端沙箱环境中运行，与你的本地机器隔离。支持分支权限、审批规则、使用配额和详细日志审计。
根据任务的性质选择合适的触发方式，是设计 Routines 的第一步。
像 cron 一样按时间表运行，适合周期性维护任务。
通过 HTTP 请求触发，适合外部系统集成和事件驱动工作流。
响应 GitHub 事件，把 CI/CD 与 AI 审查深度结合。
| 触发器类型 | 最佳场景 | 配置关键字段 | 执行延迟 |
|---|---|---|---|
| Scheduled | 每日构建检查、周报生成、依赖扫描 | cron 表达式、时区、是否允许并发 | 按调度时间 |
| API | 外部告警、Webhook、手动触发 | token、endpoint、请求体 schema | 通常秒级 |
| GitHub | PR 自动审查、Issue 分类、合并前检查 | 事件类型、仓库、分支过滤 | 事件驱动 |
以下是 Anthropic 官方推荐的高效使用模式，覆盖了开发流程中的常见痛点。
自动清理过时的 issue、标记重复项、更新优先级、补充缺失标签，让项目管理保持整洁。
接收监控告警，自动判断严重程度、查找相关代码、收集上下文，并创建或更新 ticket。
在 PR 创建时自动检查代码风格、潜在 bug、安全风险和测试覆盖，并给出评论建议。
部署后自动运行健康检查、回归测试、日志分析，确认服务状态并报告结果。
定期比对代码与文档，发现 API 变更未同步、README 过期、注释不一致等问题。
自动执行依赖升级、API 迁移、测试运行，并在通过后将改动提交为 PR。
你可以通过 Web 界面图形化创建，也可以在 Claude Code CLI 中使用 /schedule 命令。
用自然语言描述你希望 Routine 完成什么。例如："每天早上 9 点检查未分配的 P0 issue，并根据影响范围分配给对应团队。"
根据任务性质选择 Scheduled、API 或 GitHub 触发，并填写对应的配置（cron、endpoint、GitHub 事件等）。
指定目标仓库、分支、MCP 连接器、环境变量和权限范围。Routines 在隔离的云环境中运行。
先手动触发测试运行，查看执行日志和结果。确认无误后启用自动触发。
# 在 Claude Code 会话中输入 /schedule "每天早上 9 点运行依赖安全扫描，并创建 PR 修复已知漏洞" --cron "0 9 * * *" --branch main --name daily-security-scan
不同触发器的核心配置字段和最佳实践。
| 字段 | 说明 | 示例 |
|---|---|---|
| cron | 标准 5 字段 cron 表达式 | 0 9 * * 1-5（工作日早 9 点） |
| timezone | 执行时区 | America/Los_Angeles |
| concurrency | 是否允许重叠执行 | skip / allow / replace |
curl -X POST "https://api.claude.com/v1/routines/{ROUTINE_ID}/fire" \ -H "Authorization: Bearer {YOUR_TOKEN}" \ -H "Content-Type: application/json" \ -d '{"alert_id": "INC-12345", "severity": "high"}'
| 事件 | 用途 | 常用过滤 |
|---|---|---|
pull_request |
PR 创建/更新时自动审查 | branches: [main], types: [opened, synchronize] |
issues |
Issue 分类与标签 | types: [opened] |
push |
提交后运行检查 | branches: [main] |
Routines 提供完整的生命周期管理和执行可见性。
研究预览阶段的使用限制和常见问题。
Routines 共享你的 Claude Code 使用额度。Scheduled 和 GitHub 触发会按实际消耗的 token 和计算时间计费。建议为高频任务设置合理的执行间隔。
单次 Routine 执行有最大运行时间限制。长时间任务应拆分为多个步骤，或使用状态持久化避免重复工作。
常见问题包括：token 权限不足、分支保护阻止推送、环境变量缺失、MCP 连接失败。检查执行日志中的具体错误信息。
设计 Routine 时，从最小可行的任务开始，先手动运行验证，再开启自动触发。给你的 prompt 足够明确的上下文和边界条件，结果会更稳定可靠。
把重复性工作交给 Claude Code，让你专注于真正重要的创造性工作。
阅读官方文档 →