Claude Code Routines 是把 Claude Code 放到自动驾驶模式的一项能力。它把 prompt、仓库、connectors 和触发器打包成一个可自动运行的配置,并在 Anthropic 管理的云端基础设施上执行。
Routine 是什么?
一个 routine 包含:
- 一段自包含 prompt
- 一个或多个 GitHub repositories
- 一个 cloud environment
- 一组 connectors
- 一个或多个 triggers
它可以在你电脑关机后继续运行,因为执行发生在云端,而不是本地终端。
三类触发器
Schedule
按计划运行,例如 hourly、nightly、weekly,或某个未来时间点的一次性运行。
适合:
- 每晚 backlog grooming
- 每周 docs drift 检查
- 定期依赖升级审查
API
routine 会生成一个 HTTP POST endpoint 和 bearer token。你的系统可以在需要时调用它。
适合:
- 监控告警触发 bug triage
- CD pipeline 触发 deploy verification
- 内部工具触发代码检查
GitHub Events
对 GitHub 事件自动响应,例如 PR opened、release 等。
适合:
- PR 自定义 review
- merged PR 后同步 SDK
- release 后更新文档
一个 routine 可以组合多个 trigger。
创建 Routine 的关键配置
在创建表单中,你需要配置:
- 名称和 prompt
- 目标 repositories
- cloud environment
- triggers
- connectors 和 permissions
Prompt 最重要,因为 routine 是无人值守运行。它必须写清楚:
- 输入来自哪里
- 要做什么
- 成功标准是什么
- 什么情况只汇报不修改
- 输出到哪里
云端环境和权限
Routine 运行在 Claude Code cloud sessions 中,没有 permission-mode picker,也不会在运行中弹出 approval prompt。
它能访问什么,取决于:
- 选中的 repositories
- branch push 设置
- environment 的网络访问
- environment variables
- setup script
- connectors 列表
因此要遵循最小权限原则。不要默认带上所有 connectors,尤其是有写权限的 Slack、Linear、GitHub、数据库工具。
典型场景
官方给出的例子很实用:
- Backlog maintenance:自动读 issue、打标签、分配 owner
- Alert triage:监控告警触发,分析 stack trace 并开 draft PR
- Bespoke code review:对每个 PR 执行团队自定义 checklist
- Deploy verification:部署后跑 smoke checks 和日志扫描
- Docs drift:扫描合并 PR,找出需要更新的文档
- Library port:一个 SDK 变更后自动 port 到另一个语言 SDK
安全提醒
Routine 做出的动作会使用你的账号身份。比如:
- GitHub commits 和 PR 以你的 GitHub 用户出现
- Slack / Linear 等 connector 行为也使用你的 linked accounts
- Team/Enterprise 管理员可以在 admin settings 中关闭 routines
因此 routine 不是“无责任机器人”,而是自动化地代表你行动。越自动化,越需要清晰边界。
最佳实践
- Prompt 写成 runbook,而不是一句话需求
- 每个 routine 只做一个清晰目标
- connectors 按需最小化
- 对写操作优先开 draft PR,而不是直接改主分支
- 初期先手动 Run now 验证
- 对 API trigger 的 bearer token 当作密钥管理
来源:Claude Code 官方文档 - Routines | 整理:ClaudeEagle