教程

Claude Code Routines 指南:定时、API 和 GitHub 事件触发的云端自动化

Claude Code Routines 让 Claude Code 在 Anthropic 管理的云端基础设施上自动运行:可按计划执行、由 HTTP API 触发,或响应 GitHub PR/release 等事件。

2026/6/83分钟 阅读ClaudeEagle

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 的关键配置

在创建表单中,你需要配置:

  1. 名称和 prompt
  2. 目标 repositories
  3. cloud environment
  4. triggers
  5. 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

相关文章推荐

教程Claude Code Routines 官方完整指南:定时任务、API 触发、GitHub 事件自动化Claude Code Routines 官方文档完整中文整理:Routines 是什么(Prompt + Repository + Connectors);三种触发方式(Schedule 定时/API HTTP 触发/GitHub 事件);7 步创建流程(Web 界面);CLI 的 /schedule 命令;GitHub 触发器 PR 过滤器(8 个字段、正则注意事项);API 触发请求格式和响应;一次性运行;运行管理(绿色状态不等于任务成功);分支权限控制;网络访问配置;用量和限制说明;以及 Routines vs Desktop Tasks vs /loop vs GitHub Actions 的对比。2026/5/12教程Claude Code 定时任务完整指南:/schedule、Routines 三种触发方式和 /loop 监控/schedule 命令和 Routines 完整指南:/schedule 创建/查看/运行/编辑/删除定时任务;Routines 三种触发方式(Cron 定时/GitHub 事件/Webhook API /fire 端点);4 个实战 Routine 配置(每日健康检查/PR 自动质量门/每周技术债扫描/CI 失败分析);/loop 会话内定期重复(vs /schedule 的区别对比);Routines 访问权限配置(GitHub/Slack/数据库);以及 Routines + ultrareview/Hooks/Subagents 的组合用法。2026/5/8教程Claude Code Routines 完全使用指南:定时 Agent、GitHub 事件触发、Webhook API 全解析Claude Code Routines 功能完整指南:三种触发方式详解(Cron 时间表/GitHub 事件/API Webhook);网页 UI 和 CLI 两种创建方式;每日健康检查/PR 自动审查/CI 失败分析/周报生成/依赖安全扫描/Issue 分类 6 个完整模板;以及运行监控和常见问题排查。2026/5/1教程Claude Code Routines 完全指南:10 个开箱即用的 AI 自动化开发任务模板Claude Code Routines 实战指南:定时触发和事件触发配置语法,10 个开箱即用模板(依赖漏洞扫描/技术债追踪/夜间重构/PR 初审/周报生成等),以及幂等性、错误处理最佳实践。2026/4/16教程Claude Code 自动代码审查:多 Agent 分析 PR,捕捉逻辑错误和安全漏洞Claude Code 自动代码审查功能详解:多 Agent 并行分析 GitHub PR,自动发现逻辑错误、安全漏洞和回归 Bug。含配置步骤、自定义审查和 CI 集成。2026/4/7教程Claude Code in Slack:@Claude 触发编码任务、智能路由与 GitHub 仓库自动 PR 完整指南Claude Code in Slack 完整指南:@Claude 触发编码任务的完整会话流程(检测意图→创建会话→进度更新→@提及完成→View Session/Create PR)、两种路由模式(Code only vs Code+Chat)、/invite @Claude 频道邀请、四个操作按钮说明、用户/工作区/频道三级访问控制、Enterprise 会话可见性设置,以及当前限制(仅 GitHub/每会话一个 PR)和常见问题排查。2026/3/5