它到底是什么

/schedule 是 Claude Code CLI 中创建**云端例程(Routine)**的会话内命令。

Routine 是一份保存到 Anthropic 云基础设施的 Claude Code 配置——包含 prompt、一个或多个 GitHub 仓库、连接器——一旦创建便可在无需本机开机、无需开启会话的情况下自动执行。每个 Routine 可绑定一个或多个触发器：定时(Schedule)、HTTP API 调用、GitHub Webhook 事件。

计划要求: Pro、Max、Team、Enterprise,且须开启 Claude Code on the web。
CLI 最低版本: v2.1.81(低于此版本时 /schedule 不可见)。
研究预览状态: 行为、限额、API 外形面均可能变更。

怎么触发 / 怎么使用

1. 会话内自然语言创建

/schedule daily PR review at 9am

/schedule clean up feature flag in one week

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Claude 会话中输入后,Claude 会引导你补全 prompt、仓库、触发时间等信息,然后将 Routine 保存到 claude.ai 账号。一次性(one-off)运行使用自然语言描述时间,Claude 解析后会在保存前确认绝对时间戳。

/schedule 仅能创建定时触发的 Routine。若要添加 API 触发或 GitHub 事件触发,需在 claude.ai/code/routines 网页侧编辑。

2. 管理现有 Routine

/schedule list          # 列出所有 Routine
/schedule update        # 修改某个 Routine(含设置自定义 cron 表达式)
/schedule run           # 立即触发一次,不等待下次计划时间

3. 网页端创建(功能最全)

访问 claude.ai/code/routines → New routine,可同时配置三类触发器并管理连接器与环境。

4. API 触发(需先在网页端添加 API trigger)

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"
}

text 字段是可选的纯文本上下文,传入后 Claude 会将其与 Routine 的保存 prompt 一并处理。

保存 / 配置 / 集成

触发器类型

单个 Routine 可同时绑定多个触发器。

自定义 cron 表达式

预设频率不满足时,先在网页选最近的预设,再用 CLI 精调:

/schedule update

CLI 支持设置具体 cron 表达式。最小间隔:1 小时,低于 1 小时的表达式会被拒绝。

仓库与分支权限

• 每次运行时从仓库默认分支全量 clone
• 默认只能推送 claude/ 前缀的分支
• 在创建/编辑 Routine 时为某个仓库开启 Allow unrestricted branch pushes 后,可推送任意分支

环境与网络

每个 Routine 运行在一个**云端环境(Cloud Environment)**中:

• 默认环境为 Trusted 网络访问:包含常见包仓库、云服务商 API、容器注册表,拒绝其他域名
• 访问额外域名需在环境设置中切换为 Custom 并手动添加 Allowed domains
• 环境变量、Setup script(结果会缓存)均在环境中配置

连接器(MCP)

• 创建 Routine 时,账号下所有 claude.ai MCP 连接器默认全部包含;按需移除不需要的
• CLI 本地 claude mcp add 添加的 MCP server 不可用于 Routine(仅存本地)
• 需要在 Routine 中使用本地 MCP server,须在 claude.ai/customize/connectors 添加为连接器,或将其提交到仓库的 .mcp.json

企业/团队管理员

管理员可在 claude.ai/admin-settings/claude-code 用 Routines 开关全局禁用;禁用后存量 Routine 停止运行,成员无法新建。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 夜间积压清理:每晚用 Schedule trigger 扫描 issue tracker,自动打标签、分配负责人、发 Slack 摘要
• 告警自动分诊:监控系统调用 API trigger,传入告警体,Routine 关联近期提交并提出 draft PR
• 定制化 PR Review:GitHub trigger 监听 pull_request.opened,按团队 checklist 留 inline comment
• 部署后冒烟验证:CD 流水线在每次上线后调用 API trigger,Routine 跑 smoke test 并发 go/no-go 到发布频道
• SDK 双语同步:GitHub trigger 监听一个 SDK 仓库的 merged PR,自动将变更移植到另一语言 SDK 并开 PR

常见坑

1. /schedule 返回 "Unknown command":最常见原因是 shell 中设置了 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN,或 settings.json 中有 apiKeyHelper——这些优先级高于 claude.ai 登录。另一原因是设置了 DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK,导致 feature flag 拉取失败。CLI 版本低于 v2.1.81 同样不显示此命令。

2. "Routines are disabled by your organization's policy":Team/Enterprise 管理员在后台全局关闭了 Routines 开关,属于服务端策略,本地配置无法覆盖,须联系管理员开启。

3. API trigger token 丢失无法找回:token 生成后只显示一次。丢失后只能在网页端 Regenerate,原 token 立即失效。

4. Routine 状态 "green" ≠ 任务成功:绿色状态只表示会话启动且无基础设施级报错,网络请求被拒绝、连接器工具缺失、任务逻辑失败等均不影响状态色。需打开 run 查看完整 transcript。

5. 本地 MCP server 在 Routine 中不可用:通过 claude mcp add 仅在本机注册的 MCP server 不会出现在 Routine 连接器列表中;须通过 claude.ai 网页端添加为连接器或在仓库中提交 .mcp.json。

关闭 / 退出 / 卸载

Routine 是持久状态,退出 CLI 会话不影响其继续运行。管理方式:

• 暂停:在网页端 Routine 详情页 Repeats 区域使用开关;暂停后保留配置但停止触发
• 立即触发:详情页点 Run now,不等待下次计划时间
• 删除:详情页点删除图标;已产生的 session 保留在会话列表中
• 轮换/吊销 API token:编辑 Routine → Select a trigger → API 模态框 → Regenerate 或 Revoke

来源

• Automate work with routines — Claude Code Docs
• Run prompts on a schedule — Claude Code Docs
• Introducing routines in Claude Code — Claude Blog