命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
运行深层多agent代码审查
/ultrareview [PR]/ultrareview 是 Claude Code 中一条作为别名保留的命令,当前规范写法为 /code-review ultra。官方文档原话为 "The command is now invoked as /code-review ultra, and /ultrareview remains as an alias."——两者功能完全相同,/ultrareview 仍可使用,只是不再是主推写法。
该命令在 Anthropic 云端沙箱中启动一批审查 agent(reviewer fleet),对当前分支或指定 GitHub PR 进行深度代码审查。与本地 /review 的单次扫描不同,每条上报的问题都经过独立 agent 二次复现验证后才会出现在报告中。
| 属性 | 值 |
|---|---|
| 规范命令 | /code-review ultra |
| 保留别名 | /ultrareview |
| 最低版本 | Claude Code v2.1.86+ |
| 发布状态 | Research preview(2026 年 4 月 20–24 日,Week 17) |
| 所需账户 | Claude.ai 账户(不能仅凭 API Key 使用) |
不可用的情况:Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry,以及启用了 Zero Data Retention 的组织账户。
/code-review ultra
无参数时,审查当前分支与默认分支(如 main)之间的 diff,包含工作树中已暂存但未提交的变更。Claude Code 会将仓库状态打包上传至远程沙箱,不需要已推送到远程,也不需要 GitHub remote。
/code-review ultra 1234
PR 模式下,远程沙箱直接从 GitHub 克隆 PR,不打包本地工作树。支持 github.com 和已接入 Claude Code 的 GitHub Enterprise Server 实例。
仓库过大无法打包时,Claude Code 会提示切换到 PR 模式——先推送分支、开一个 Draft PR,再运行上述命令。
命令执行前会显示确认对话框,内含:审查范围(文件数与行数)、剩余免费次数、预估费用。确认后审查在后台运行,终端可继续使用。
使用 /tasks 查看进行中或已完成的审查,亦可在此终止审查。
/tasks
claude ultrareview 子命令适合在 CI 中使用,阻塞直到远端审查完成,结果输出至 stdout,成功退出码 0,失败退出码 1,Ctrl-C 中断为 130(远端审查仍继续运行)。
# 审查当前分支 vs 默认分支
claude ultrareview
# 审查指定 PR
claude ultrareview 1234
# 审查相对于指定 base 的 diff
claude ultrareview origin/main
# 输出原始 JSON
claude ultrareview --json
# 设置最长等待时间(分钟,默认 30)
claude ultrareview --timeout 15
认证前提:必须以 Claude.ai 账户登录,仅持有 API Key 时先执行:
/login
Usage Credits:免费次数用完后,每次审查以 Usage Credits 计费。若未开启,Claude Code 会拦截启动并指引到账单设置页。也可在会话中检查:
/usage-credits
GitHub PR 自动审查集成(不需要 CLI 步骤):可使用独立的 Code Review 功能直接接入仓库,以 inline PR comment 形式上报结果。参见官方文档 /en/code-review。
| 约束 | 说明 |
|---|---|
| 需 git 仓库 | 非 git 目录下无法运行 |
| 需 Claude.ai 账户 | 纯 API Key 用户须先 /login |
| 不支持 Bedrock / Vertex / Foundry | 云端沙箱依赖 Anthropic 自有基础设施 |
| 不支持 Zero Data Retention 组织 | 该政策与云端上传不相容 |
| 运行时长约 5–10 分钟 | 后台运行,不占用终端 |
| 中途终止不返回部分结果 | 停止审查后 cloud session 归档,已找到的问题丢弃 |
| 提前终止仍消耗一次免费次数 | 计数在 cloud session 启动时触发 |
| 仓库过大时须改用 PR 模式 | CLI 会提示,需先推送分支并开 PR |
/review | /code-review ultra(/ultrareview) | |
|---|---|---|
| 运行位置 | 本地会话内 | Anthropic 远程云端沙箱 |
| 审查深度 | 单次扫描 | 多 agent 并行 + 独立复现验证 |
| 耗时 | 数秒至数分钟 | 约 5–10 分钟 |
| 费用 | 计入正常用量 | 3 次免费后约 $5–$20 / 次(Usage Credits) |
| 适用场景 | 迭代中快速反馈 | 合并前对重要变更的深度把关 |
| 需要 Claude.ai 账户 | 否 | 是 |
/code-review ultra 在合并前跑一遍。/review 漏了问题之后:对同一分支再发起一次云端多视角审查,覆盖单次扫描难以发现的竞态条件、边界情况。claude ultrareview --json 拿到机器可读结果,让流水线决策是否阻断合并。提前终止仍消耗免费次数:点确认、cloud session 启动后即计数。操作前务必在确认弹窗检查剩余次数和预估费用。
中途 Ctrl-C 不会返回已找到的结果:claude ultrareview 的 --timeout 到期或被中断后,远端审查继续运行,但当前进程看不到任何结果。可以跟随 stderr 输出的 session URL 在浏览器里继续观察。
纯 API Key 用户触发失败:错误提示不够直观,实际原因是未登录 Claude.ai 账户。先跑 /login 再重试。
Usage Credits 未开启时被静默阻断:免费次数耗尽后,若账户未启用 Usage Credits,命令会被拦截。需要到账单设置页手动开启,或运行 /usage-credits 进行检查。