Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Ultrareview 是 Claude Code v2.1.86 及更高版本中提供的研究预览功能。该功能、定价和可用性可能会根据反馈而改变。该命令现在通过
/code-review ultra 调用,/ultrareview 仍然作为别名保留。/code-review ultra 时,Claude Code 在远程沙箱中启动一队审查代理来查找您的分支或拉取请求中的错误。
与本地 /review 相比,ultrareview 提供:
- 更高的信号质量:每个报告的发现都经过独立复现和验证,因此结果专注于真实的错误而不是风格建议
- 更广泛的覆盖范围:许多审查代理并行探索更改,这会发现单次审查可能遗漏的问题
- 无本地资源使用:审查完全在远程沙箱中运行,因此您的终端在运行时保持空闲,可用于其他工作
/login 并使用 Claude.ai 进行身份验证。当使用 Claude Code 与 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时,Ultrareview 不可用,对于已启用零数据保留的组织也不可用。
从 CLI 运行 ultrareview
从 Claude Code CLI 中的任何 git 存储库启动审查。github.com 上的存储库以及管理员已连接到 Claude Code 的 GitHub Enterprise Server 实例。
启动前,Claude Code 显示一个确认对话框,其中包含审查范围(包括审查分支时的文件和行数)、您剩余的免费运行次数和估计成本。确认后,审查在后台继续进行,您可以继续使用您的会话。该命令仅在您使用 /code-review ultra 调用时运行;Claude 不会自动启动 ultrareview。
定价和免费运行
Ultrareview 是一项高级功能,按额外使用量而不是您计划的包含使用量计费。 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 退出。
| 标志 | 描述 |
|---|---|
--json | 打印原始 bugs.json 有效负载而不是格式化的发现 |
--timeout <minutes> | 等待审查完成的最大分钟数。默认为 30 |
claude ultrareview 需要与 /code-review ultra 相同的身份验证和使用额度配置。当审查完成时(无论是否有发现)子命令以代码 0 退出,当审查无法启动、远程会话出错或超时时以代码 1 退出,当使用 Ctrl-C 中断时以代码 130 退出。如果您中断子命令,远程审查会继续运行;按照打印到 stderr 的会话 URL 在浏览器中观看它。
对于 GitHub 拉取请求上的自动审查,Code Review 直接与您的存储库集成,并将发现作为内联 PR 注释发布,无需 CLI 步骤。
ultrareview 与 /review 的比较
两个命令都审查代码,但它们针对工作流的不同阶段。/review | /code-review ultra | |
|---|---|---|
| 运行位置 | 在您的会话中本地运行 | 在云沙箱中远程运行 |
| 深度 | 单次审查 | 具有独立验证的多代理队列 |
| 持续时间 | 几秒到几分钟 | 大约 5 到 10 分钟 |
| 成本 | 计入正常使用量 | 免费运行,然后大约 $5 到 $20 每次审查作为使用额度 |
| 最适合 | 迭代时的快速反馈 | 合并前对重大更改的信心 |
/review 在工作时获得快速反馈。在合并重大更改前使用 /code-review ultra,当您想要更深入的审查来捕捉单次审查可能遗漏的问题时。
相关资源
- Claude Code 网络版:了解远程会话和云沙箱如何工作
- 使用 ultraplan 规划复杂更改:ultrareview 的规划对应物,用于前期设计工作
- 有效管理成本:跟踪使用情况并设置支出限制