命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
启动远程会话自动修复 PR 中的 CI 失败
/autofix-pr [prompt]/autofix-pr 是 Claude Code CLI 的内置 slash 命令,在当前分支上执行后,它会自动推断该分支对应的 open PR,并在 Claude Code on the web 上为该 PR 一键开启 auto-fix——整个操作不需要打开浏览器。
Cloud session 启动后,Claude 持续监听 GitHub 事件:CI 检查失败时自动分析错误日志、修复代码并推送;reviewer 留下 comment 时自动回应——直到所有检查通过为止。
版本与订阅要求(均来自官方 What's New 页面):
| 事项 | 详情 |
|---|---|
| CLI 命令首次发布 | Week 15(2026-04-06–10),版本 v2.1.92–v2.1.101 |
| Web 端 auto-fix 开关首次发布 | Week 13(2026-03-23–27),版本 v2.1.83–v2.1.85 |
| 订阅要求 | Claude Code on the web 目前为 research preview,支持 Pro、Max、Team 用户,以及拥有 premium seats 或 Chat + Claude Code seats 的 Enterprise 用户 |
| GitHub 前置条件 | 需在 repository 上安装 Claude GitHub App |
切到 PR 所属分支,直接运行:
/autofix-pr
Claude 推断当前分支对应的 open PR,并在 Claude Code on the web 上为其开启 auto-fix。推送的修复全部由 cloud session 完成,本地终端立即释放。
官方 auto-fix 文档只展示裸命令 /autofix-pr,未给出任何带参数的写法,也未承诺「传入文本可约束修复范围」。commands 页面有一条对所有命令通用的说明——「命令名之后的文本会作为 arguments 传给命令」,因此理论上 /autofix-pr only fix lint and type errors 这样的文本会被透传,但官方从未说明它会被远程 session 当作修复范围约束来执行,实际效果以你自己测试为准,不要把它当成已记录的功能。
官方列出了多条触发路径,效果都是为该 PR 打开同一个 per-PR 的 auto-fix 开关:
/autofix-pr(Claude Code 用 gh 探测 open PR、拉起 web session 并开启 auto-fix);| 约束 | 说明 |
|---|---|
| 必须在 PR 所属分支上执行 | 命令通过当前分支名推断 PR,切错分支会找不到目标 PR |
| PR 必须处于 open 状态 | 已关闭或已合并的 PR 无法开启 auto-fix |
| 需要安装 Claude GitHub App | 官方文档明确列为前置条件,缺失时无法监听 CI 事件或推送 fix |
| 仅限 research preview 订阅计划 | Free 计划不支持 Claude Code on the web |
/autofix-pr | Web UI Auto fix 开关 | /loop check CI on my PR | |
|---|---|---|---|
| 触发位置 | 本地终端 | claude.ai/code 浏览器 | 本地终端 |
| 执行位置 | 云端(Claude Code on the web) | 云端 | 本地 session |
| 自定义修复范围 | 无官方文档(args 仅理论透传) | 无官方文档 | 支持(prompt 完全自由) |
| 持续监听直到 PR 通过 | 是 | 是 | 视 /loop 节奏配置而定 |
| 需要 research preview 席位 | 是 | 是 | 否 |
git push 之后执行 /autofix-pr,可以关掉 laptop 去做别的事,cloud session 持续工作直到 PR 变绿。/autofix-pr 把监听+修复全推到 cloud session,关掉 laptop 也不影响。/autofix-pr 把任务推上云端,需要深入介入时把 remote session 拉回本地终端继续。teleport 有两种合法入口:会话内 slash 命令 /teleport(别名 /tp,commands 页记载「Pull a Claude Code on the web session into this terminal」),以及启动时的 CLI 标志 claude --teleport(web 页记载,与 --remote 配对)。两者均有效,按你所处场景选用。未安装 Claude GitHub App:命令提交成功但 cloud session 无法订阅 CI 事件,auto-fix 实际上不会触发任何修复。需先在 repository settings 中安装 Claude GitHub App。
当前分支没有 open PR:/autofix-pr 依赖 branch → PR 的自动推断,若 PR 尚未创建、已关闭或已 merge,命令会找不到目标。需先确保 PR 处于 open 状态。
订阅计划不满足 research preview 要求:Free 计划用户执行后会收到权限提示,需升级至 Pro / Max / Team 或对应 Enterprise 席位。
修复在 git worktree 中错误报告无法在默认分支运行的问题