它到底是什么

/proactive 是 /loop 命令的别名（alias）。官方文档在 /loop 词条末尾原文写明：

/loop [interval] [prompt] — Skill。 Run a prompt repeatedly while the session stays open. Omit the interval and Claude self-paces between iterations. Omit the prompt and Claude runs the built-in maintenance prompt or your loop.md. Example: /loop 5m check if the deploy finished. Alias: /proactive

也就是说，官方文档本身没有为 /proactive 单独开设条目或写不同的行为说明——它触发的功能、参数格式、内部机制都与 /loop 完全一致，只是命令名不同。本篇下文以 /loop 的官方文档（"Run prompts on a schedule"）为准，示例中把命令替换写作 /proactive。

/loop（进而 /proactive）被归类为 Claude Code 的内置 Skill（bundled skill），依托 CLI 内部的定时调度器工作。

怎么触发 / 怎么使用

/proactive 支持"间隔"和"prompt"两个都可省略的参数，组合不同决定行为：

也可以把 skill 作为 prompt 传入，例如 /proactive 20m /review-pr 1234，每轮重新执行该 skill。

1. 固定间隔运行

/proactive 5m check if the deployment finished and tell me what happened

Claude 会把间隔换算成 cron 表达式并确认执行频率与任务 ID。间隔可以是前置的裸 token（如 30m），也可以是尾随的从句（如 every 2 hours），支持单位 s/m/h/d。由于 cron 最小粒度是一分钟，秒会被向上取整；像 7m、90m 这种凑不出整齐 cron 步长的间隔，会被四舍五入到最接近的可行步长，Claude 会告知实际采用的值。

2. 让 Claude 自行选择间隔（动态模式）

/proactive check whether CI passed and address any review comments

省略间隔时，Claude 每轮结束后会根据观察到的情况，在 1 分钟到 1 小时之间动态选一个等待时长（例如构建还没跑完就等短一点，PR 安静下来就等长一点），并在每轮结束时打印所选延迟和理由。

3. 运行内置维护 prompt / 自定义 loop.md

/proactive

裸调用时，若项目或用户目录下存在 loop.md，则使用其内容作为默认 prompt；否则运行内置维护 prompt，按顺序：继续会话中未完成的工作 → 处理当前分支 PR 的评论 / CI 失败 / 合并冲突 → 在没有其他待办时做清理性质的 bug 排查或简化。Claude 不会在此范围外主动发起新任务，push、删除等不可逆操作只有在会话上下文已经授权的延续动作里才会执行。

保存 / 配置 / 集成

• 自定义默认 prompt：在 .claude/loop.md（项目级，优先）或 ~/.claude/loop.md（用户级）中写纯 Markdown 指令，替换内置维护 prompt。内容超过 25,000 字节会被截断，修改后下一轮迭代即生效。
• 只在提供裸调用（不带 prompt）时才会读取 loop.md；命令行显式给了 prompt 时会忽略它。
• 环境变量 CLAUDE_CODE_DISABLE_CRON=1 可整体禁用调度器，届时 cron 相关工具和 /loop//proactive 都不可用，已排期的任务也会停止触发。

运行约束 / 限制

跟同类原语对比

官方文档给出了三种调度方式的对比，/loop（/proactive）是其中"会话内快速轮询"的选项：

官方建议：需要脱离本机稳定运行用 Cloud Routines，需要本地文件与工具用 Desktop 定时任务，会话内的快速轮询用 /loop（即 /proactive）。

经典使用场景

以上均直接来自官方文档给出的用例：

• 轮询一次部署是否完成，并汇报结果
• 盯着一个 PR：检查 CI 是否变红、是否有新的 review 评论
• 定期查看一个长时间运行的构建状态
• 设置一次性提醒（用自然语言描述，如"45 分钟后检查集成测试是否通过"，Claude 会自动建一次性任务并在触发后自我删除）
• 用自定义 loop.md 让循环持续维护某个发布分支：CI 变红就拉日志诊断修复，有新评论就逐条处理

常见坑

1. 只有"被允许自主调用"的 skill 才会在定时触发时真正执行。像 /permissions、/model、/clear 这类内置命令，标记了 disable-model-invocation: true 的 skill（包括内置的 /verify），被 skillOverrides 设置或 Skill 拒绝规则限制的 skill，以及 MCP prompts（如 /mcp__github__list_prs），到点触发时只会作为纯文本进入对话，不会被执行。
2. Esc 只能停掉"动态自定速"的循环，清除的是下一次唤醒；如果任务是你直接让 Claude 用自然语言创建的固定间隔任务，Esc 不影响它，得显式要求取消（对应 CronDelete）。
3. 秒级和不规整间隔会被悄悄取整：7m、90m 这类值会被换算成最接近的可行 cron 步长，实际生效频率可能与输入不完全一致。
4. loop.md 只定义裸调用时的单一默认 prompt，不是多任务列表；命令行一旦显式带了 prompt，loop.md 会被忽略；文件超过 25,000 字节的部分会被截断。
5. 在部分 provider（Bedrock / AWS Claude Platform / GCP Agent Platform / Microsoft Foundry）或关闭 feature-flag fetching 时，低于 v2.1.248 的 Claude Code 上裸 /proactive（无 prompt）不会真正进入动态循环，只会打印用法信息；无间隔的 prompt 也不会动态调间隔，而是固定按 10 分钟跑。

关闭 / 退出 / 卸载

• 停止动态自定速循环：在它等待下一轮触发时按 Esc，清除待触发的唤醒即可，循环不会再次触发。
• 取消固定间隔任务：用自然语言让 Claude 取消（如"cancel the deploy check job"），或直接对底层 CronDelete 工具按任务 ID 操作；不主动取消的话，任务会在创建后 7 天自动过期并做最后一次触发后自删除。
• 彻底关闭调度能力：设置环境变量 CLAUDE_CODE_DISABLE_CRON=1，会禁用整个 cron 调度器，/loop 与 /proactive 均不可用，已排期任务全部停止触发。

来源

• Commands（code.claude.com 官方文档） — 确认 /proactive 是 /loop 的 Alias，并给出 /loop 的原始语法与说明
• Run prompts on a schedule（code.claude.com 官方文档） — /loop 的完整行为、限制、对比表、loop.md、停止方式等细节来源