Claude Code 平台集成
Claude Code 平台集成
Ultrareview 深度审查
2 分钟阅读
使用 Ultrareview 发现缺陷
在云端使用
/code-review ultra运行深度多代理代码审查,在合并前发现并验证缺陷。
Ultrareview 是 Claude Code v2.1.86 及更高版本中可用的研究预览功能。功能、定价和可用性可能会根据反馈发生变化。该命令现在通过 /code-review ultra 调用,/ultrareview 仍作为别名保留。
Ultrareview 是在 Claude Code 网页版基础设施上运行的深度代码审查。当你运行 /code-review ultra 时,Claude Code 会在远程沙箱中启动一组审查代理,以在你的分支或 Pull Request 中查找缺陷。
与本地 /code-review 或 /review 相比,Ultrareview 提供:
- 更高信噪比:每个报告的发现都经过独立复现和验证,因此结果专注于真实缺陷而非风格建议
- 更广覆盖范围:更大规模的审查代理并行探索变更,能够发现本地审查可能遗漏的问题
- 不占用本地资源:审查完全在远程沙箱中运行,因此你的终端在运行期间保持空闲以进行其他工作
Ultrareview 需要使用 Claude.ai 账户进行身份验证,因为它在 Claude Code 网页版基础设施上运行。如果你仅使用 API 密钥登录,请先运行 /login 并使用 Claude.ai 进行身份验证。使用 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 时,Ultrareview 不可用,并且对于启用了 Zero Data Retention 的组织也不可用。
从 CLI 运行 Ultrareview
从 Claude Code CLI 中的任何 Git 仓库开始审查。
不带参数时,Ultrareview 会审查当前分支与默认分支之间的差异,包括工作树中任何未提交和已暂存的变更。Claude Code 将仓库状态打包并上传到远程沙箱进行审查。
要审查 GitHub Pull Request,请传递 PR 编号。
在 PR 模式下,远程沙箱直接从主机克隆 Pull Request,而不是打包你的本地工作树。PR 模式适用于 github.com 上的仓库以及所有者已连接到 Claude Code 的 GitHub Enterprise Server 实例。
启动前,Claude Code 会显示一个确认对话框,其中包含审查范围(审查分支时包括文件和行数)、你剩余的免费运行次数和预估成本。确认后,审查会在后台继续,你可以继续使用你的会话。该命令仅在你使用 /code-review ultra 调用时运行;Claude 不会自行启动 Ultrareview。
定价和免费运行
Ultrareview 是一项高级功能,按使用额度计费,而不是你套餐的包含使用量。
| 套餐 | 包含的免费运行次数 | 免费运行次数用完之后 |
|---|---|---|
| Pro | 3 次免费运行 | 按 使用额度 计费 |
| Max | 3 次免费运行 | 按 使用额度 计费 |
| Team 和 Enterprise | 无 | 按 使用额度 计费 |
Pro 和 Max 订阅者获得三次免费 Ultrareview 运行以试用该功能。这三次运行是每个账户的一次性分配,不会刷新。使用完全部三次后,或在免费运行期结束后,每次审查将按使用额度计费,通常根据变更大小花费 5 到 20 美元。运行一旦云会话启动即计入,因此提前停止或未能完成的审查仍会使用一次免费运行。对于付费审查,使用额度仅按实际运行的部分计费。
由于 Ultrareview 在免费运行之外始终按使用额度计费,你的账户或组织必须在使用额度开启后才能启动付费审查。如果使用额度未开启,Claude Code 会阻止启动并链接你到可以开启它的账单设置。你也可以运行 /usage-credits 来检查或更改你当前的设置。
跟踪正在运行的审查
审查通常需要 5 到 10 分钟。审查作为后台任务运行,因此你可以继续在会话中工作、启动其他命令或完全关闭终端。
使用 /tasks 查看正在运行和已完成的审查、打开审查的详情视图,或停止正在进行的审查。停止审查会归档云会话,且不会返回部分发现。审查完成后,经过验证的发现会作为通知出现在你的会话中。每个发现都包含文件位置和对问题的解释,以便你可以直接要求 Claude 修复它。
非交互式运行 Ultrareview
使用 claude ultrareview 子命令从 CI 或脚本中启动 Ultrareview,无需交互式会话。该子命令启动的审查与 /code-review ultra 相同,会阻塞直到远程审查完成,将发现打印到 stdout,并在成功时以代码 0 退出,失败时以代码 1 退出。
不带参数时,该子命令审查当前分支与默认分支之间的差异。传递 PR 编号以审查 Pull Request,或传递基础分支以审查与该分支的差异。调用该子命令即视为同意交互式命令显示的账单和条款提示。
进度消息和实时会话 URL 输出到 stderr,以便 stdout 保持可解析。使用以下标志控制输出和超时:
| 标志 | 说明 |
|---|---|
--json | 打印原始 bugs.json 载荷,而不是格式化的发现 |
--timeout <minutes> | 等待审查完成的最大分钟数。默认为 30 |
运行 claude ultrareview 需要与 /code-review ultra 相同的身份验证和使用额度配置。当审查完成(无论是否有发现)时,子命令以代码 0 退出;当审查启动失败、云会话出错或超时时,以代码 1 退出;当使用 Ctrl-C 中断时,以代码 130 退出。如果你中断子命令,远程审查会继续运行;按照打印到 stderr 的会话 URL 在浏览器中查看它。
对于 GitHub Pull Request 的自动审查,代码审查 直接与你的仓库集成,并将发现作为行内 PR 评论发布,无需 CLI 步骤。
Ultrareview 与 /code-review 和 /review 的比较
这三个命令都审查代码,但它们针对你工作流的不同阶段。
/code-review | /review <pr> | /code-review ultra | |
|---|---|---|---|
| 目标 | 你的工作差异 | GitHub Pull Request | 你的工作差异或 Pull Request |
| 运行位置 | 本地会话中 | 本地会话中 | 远程云沙箱中 |
| 深度 | 随 effort 参数扩展 | 会话 effort 级别的单次审查 | 多代理集群,独立验证 |
| 持续时间 | 几秒到几分钟 | 几秒到几分钟 | 大约 5 到 10 分钟 |
| 成本 | 计入正常使用量 | 计入正常使用量 | 免费运行,之后每次审查约 5 到 20 美元的使用额度 |
| 适用场景 | 迭代时快速反馈 | 批准前审查队友的 PR | 对重大变更进行合并前确认 |
在工作时使用 /code-review 获取快速反馈。使用 /review <pr> 像批准前一样审查 Pull Request。在合并重大变更之前使用 /code-review ultra,当你需要更深入的审查来捕获本地审查可能遗漏的问题时。
相关资源
- Claude Code 网页版:了解云会话和云沙箱的工作原理
- 使用 Ultraplan 规划复杂变更:Ultrareview 的规划对应功能,用于前期设计工作
- 有效管理成本:跟踪使用量并设置支出限制