Claude Code Routines:工作流自动化新框架
Claude Code 发布 Routines 功能,支持预定和自动执行重复任务,直接革新开发者日常工作流。
完整中文译文
触发方式
定时运行:按小时、每夜、每周等周期运行,或在指定的未来时间运行一次
API:通过向每个 routine 专属的端点发送 HTTP POST 请求(带 bearer token)随时触发
GitHub:自动响应代码库事件(如 pull request 或 release)而运行
打开创建表单
给 routine 命名并编写提示词
选择环境
网络访问:设置每次运行时可用的网络访问级别
环境变量:提供 Claude 在每次运行时可用的值。这些值对使用该环境的任何人都可见,因此添加凭证时要考虑这一点
设置脚本:安装 routine 需要的依赖和工具。结果会被缓存,因此脚本不会在每次会话时重新运行
添加计划触发器
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
打开 routine 进行编辑
复制 URL 并生成令牌
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
-H "Authorization: Bearer sk-ant-oat01-xxxxx" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
{
"type": "routine_fire",
"claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
"claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
添加 GitHub 触发器
打开 routine 进行编辑
添加 GitHub 事件触发器
安装 Claude GitHub App
配置触发器
身份验证模块审查
base branch 为 main,head branch 包含 auth-provider。将任何涉及身份验证的 PR 发送给专门的审查者。
仅准备就绪的 PR
is draft 为 false。跳过草稿,使 routine 仅在 PR 准备好进行审查时运行。
标签门控反向移植
标签包含 needs-backport。仅当维护者标记 PR 时才触发反向移植到另一分支的 routine。
查看并与运行交互
编辑和控制 routine
点击"立即运行"可立即开始运行,无需等待下一个计划时间。你可以选择提供特定运行的文本,该文本以与 API 触发器的文本字段相同的方式到达 routine。
使用"重复"部分中的切换开关暂停或恢复计划。暂停的 routine 保留其配置,但在重新启用之前不会运行。
点击铅笔图标打开"编辑 routine",可以更改名称、提示词、代码库、环境、连接器或任何 routine 的触发器。"选择触发器"部分是添加或移除计划、API 令牌和 GitHub 事件触发器的地方。
点击删除图标移除 routine。由 routine 创建的过去会话仍保留在你的会话列表中。
代码库和分支权限
- 分支在 GitHub 上受保护
- 其他人有来自该分支的开放 pull request
- 分支包含由非你的其他人创作的提交
环境和网络访问
打开 routine 进行编辑
打开环境选择器
打开环境设置
更改网络访问级别
/schedule 返回"未知命令"
你使用控制台 API 密钥或云提供商(如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry)进行身份验证。/schedule 需要 claude.ai 订阅登录。如果在你的 shell 中设置了 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN,或在 settings.json 中设置了 apiKeyHelper,请先将其移除,因为这些设置优先于 claude.ai 登录
在你的 shell 环境中或 settings.json 文件的 env 块中设置了 DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK。这些设置会禁用功能标志获取,而 /schedule 依赖于此
你在 Claude Code 网页会话中。改为从网页 UI 管理 routine。
/schedule 要求你进行身份验证
"组织策略已禁用 Routine"
相关文档
/loop 和会话内调度:在开放的 CLI 会话中调度本地任务
桌面计划任务:在你的机器上运行并可访问本地文件的本地计划任务
云环境:为云会话配置网络访问、环境变量和设置脚本
MCP 连接器:连接外部服务,如 Slack、Linear 和 Google Drive
GitHub Actions:在代码库事件上在你的 CI 流水线中运行 Claude
此页面有帮助吗?