Claude Code ultrareview 会在云端远程沙箱里启动多代理代码审查,适合在合并前找出并验证真实 bug。默认审查当前分支与默认分支的差异,也可以传入 GitHub PR 编号;开始前会显示范围、免费次数和预估费用,运行后可用 /tasks 追踪或停止。
Claude Code ultrareview 怎么用
用 /ultrareview 在合并前做深度代码审查,找出并验证真实 bug。它在 Claude Code on the web 基础设施上运行,适合需要比本地 /review 更高置信度的变更。
Ultrareview 是 Claude Code v2.1.86 及之后版本中的研究预览功能。功能本身、价格和可用性都可能根据反馈调整。
Ultrareview 的特点:
- 更高信号:每个问题都会独立复现并验证,结果更偏向真实 bug,而不是风格建议
- 覆盖更广:多个 reviewer agent 并行探索改动,能发现单次审查容易漏掉的问题
- 不占本地资源:审查完全在远程沙箱运行,终端可以继续做别的事
Ultrareview 需要 Claude.ai 账号认证,因为它运行在 Claude Code on the web 基础设施上。如果你当前只用 API key 登录,请先运行 /login 并使用 Claude.ai 完成认证。
Ultrareview 不能在使用 Claude Code + Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时使用,也不适用于已启用 Zero Data Retention 的组织。
从 CLI 运行 ultrareview
在 Claude Code CLI 中,进入任意 git 仓库后直接启动审查。
/ultrareview
不带参数时,ultrareview 会审查当前分支与默认分支之间的 diff,包括工作区里未提交和已暂存的改动。Claude Code 会把仓库状态打包并上传到远程沙箱进行审查。
如果要审查 GitHub pull request,可以传入 PR 编号。
/ultrareview 1234
在 PR 模式下,远程沙箱会直接从 GitHub 克隆该 pull request,而不是打包本地工作区。PR 模式要求仓库里有 github.com remote。
如果仓库太大,无法打包,Claude Code 会提示你改用 PR 模式。先 push 分支并创建 draft PR,然后运行
/ultrareview <PR-number>。
启动前,Claude Code 会显示确认对话框,内容包括审查范围(审查分支时还会显示文件数和行数)、剩余免费次数以及预估费用。确认后,审查会在后台继续运行,你可以继续使用当前会话。只有你显式执行 /ultrareview 时才会启动,Claude 不会自己发起 ultrareview。
价格和免费次数
Ultrareview 是高级功能,计费方式是 usage credits,不走套餐内包含的常规用量。
| Plan | Included free runs | After free runs |
|---|---|---|
| Pro | 3 free runs | billed as usage credits |
| Max | 3 free runs | billed as usage credits |
| Team and Enterprise | none | billed as usage credits |
Pro 和 Max 订阅用户各自有 3 次免费的 ultrareview 运行次数,用来体验功能。这 3 次是按账号一次性发放,不会刷新。用完之后,或者免费期结束后,每次审查都会按 usage credits 计费,通常每次约 $5 到 $20,具体取决于改动规模。一次运行会在远程会话启动后计数,所以即使你提前停止,或者审查没有完整结束,也会消耗一次免费次数。付费审查时,usage credits 只会按实际运行的部分计费。
因为 ultrareview 在免费次数之外始终按 usage credits 计费,所以在启动付费审查前,你的账号或组织必须先开启 usage credits。如果没有开启,Claude Code 会阻止启动,并带你跳转到账单设置页面开启。你也可以运行 /usage-credits 查看或修改当前设置。
追踪正在运行的审查
一次审查通常需要 5 到 10 分钟。审查会作为后台任务运行,所以你可以继续在当前会话里工作、执行其他命令,甚至直接关闭终端。
使用 /tasks 可以查看正在运行和已完成的审查,打开某次审查的详情,或者停止一个进行中的审查。停止后会归档云端会话,未完成的中间结果不会返回。审查结束时,已验证的问题会作为通知出现在你的会话里。每个问题都会包含文件位置和问题说明,方便你直接让 Claude 修复。
非交互式运行 ultrareview
如果你要在 CI 或脚本里启动 ultrareview,可以使用 claude ultrareview 子命令,而不需要交互式会话。这个子命令会发起与 /ultrareview 相同的审查,阻塞直到远程审查完成,随后把发现结果打印到 stdout,并在成功时退出码为 0,失败时退出码为 1。
claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main
不带参数时,子命令审查当前分支与默认分支之间的 diff。传入 PR 编号可审查 pull request;传入基准分支名则审查当前分支与该分支之间的 diff。调用该子命令,就等于同意交互式命令里显示的计费和条款提示。
进度消息和实时会话 URL 会输出到 stderr,这样 stdout 仍然可以被解析。可以用下面这些参数控制输出和超时时间:
| Flag | Description |
|---|---|
--json |
Print the raw bugs.json payload instead of the formatted findings |
--timeout <minutes> |
Maximum minutes to wait for the review to finish. Defaults to 30 |
运行 claude ultrareview 需要和 /ultrareview 相同的认证与 usage credits 配置。审查完成且无论是否有发现,子命令都会以 0 退出;如果审查无法启动、远程会话报错,或者超时,则以 1 退出;如果你用 Ctrl-C 中断,则以 130 退出。即使你中断子命令,远程审查也会继续运行;跟随 stderr 打印的会话 URL,可以在浏览器里继续查看。
如果你要在 GitHub pull request 上自动执行审查,Code Review 可以直接集成到仓库,并把发现结果作为 PR 内联评论发布,不需要 CLI 步骤。
ultrareview 和 /review 有什么区别
这两个命令都会审查代码,但适用阶段不同。
/review |
/ultrareview |
|
|---|---|---|
| Runs | locally in your session | remotely in a cloud sandbox |
| Depth | single-pass review | multi-agent fleet with independent verification |
| Duration | seconds to a few minutes | roughly 5 to 10 minutes |
| Cost | counts toward normal usage | free runs, then roughly $5 to $20 per review as usage credits |
| Best for | quick feedback while iterating | pre-merge confidence on substantial changes |
在你边改边看反馈时,用 /review 更快。要在合并前对较大的改动做更深入的检查,优先用 /ultrareview。
相关资源
- Claude Code on the web: 了解远程会话和云端沙箱如何工作
- Plan complex changes with ultraplan: ultrareview 的规划对应功能,用于前期设计
- Manage costs effectively: 跟踪用量并设置消费上限
常见问题
ultrareview 为什么不能启动
先检查你是否已经用 Claude.ai 账号登录。ultrareview 不能只靠 API key 使用,也不支持 Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry,或者启用了 Zero Data Retention 的组织。
ultrareview 运行到一半停掉了,还会计入免费次数吗
会。一次运行在远程会话启动后就开始计数,所以即使你提前停止,或者审查没有完成,也会消耗一次免费运行次数。
claude ultrareview 的输出为什么分成 stdout 和 stderr
stdout 会输出可解析的结果,stderr 会输出进度消息和实时会话 URL。这样你可以把 stdout 接到脚本里处理,同时还能在浏览器里继续查看远程审查。