Claude Code 深度学习手册

主题

Ultrareview 云端找 Bug ​

在云端启动多智能体并行深度代码审查，合并前找出并验证真实 Bug。

是什么 ​

Ultrareview 是运行在 Claude Code on the web 基础设施上的深度代码审查功能（v2.1.86 及以上的 research preview）。运行 /code-review ultra 时，Claude Code 会在远程沙箱中启动一批 reviewer 智能体，针对你的分支或 Pull Request 查找 Bug。

相比本地 /review，它的特点是高信噪比（每条发现都被独立复现和验证，聚焦真实 Bug 而非风格建议）、覆盖更广（多个智能体并行探索改动）、不占用本地资源（完全在远程沙箱运行，终端可继续其他工作）。命令现以 /code-review ultra 调用，/ultrareview 保留为别名。

怎么工作 ​

  • 运行 /code-review ultra；无参数时审查当前分支与默认分支之间的 diff，含工作区未提交和已暂存的改动，Claude Code 会打包仓库状态上传到远程沙箱。
  • 传入 PR 编号（如 /code-review ultra 1234）则进入 PR 模式，远程沙箱直接从托管端 clone 该 Pull Request，而非打包本地工作区。
  • 启动前弹出确认框，显示审查范围（分支审查时含文件与行数）、剩余免费次数和预计费用；确认后在后台运行，可继续使用会话。
  • 远程沙箱中一批 reviewer 智能体并行探索改动，每条发现都被独立复现和验证后才返回。
  • 审查通常耗时 5 到 10 分钟，作为后台任务运行，可继续工作、运行其他命令或关闭终端。
  • 完成后已验证的发现以通知形式出现在会话中，每条含文件位置和问题说明，可直接让 Claude 修复。

怎么配置 / 用法 ​

CLI 交互式：

text
/code-review ultra
/code-review ultra 1234

无参数审查当前分支与默认分支的 diff；传 PR 编号审查该 Pull Request。

非交互式（用于 CI 或脚本，阻塞直到完成，发现打印到 stdout，成功退出码 0、失败 1）：

bash
claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

可传 PR 编号或基准分支。常用 flag：--json（打印原始 bugs.json）、--timeout <minutes>（最长等待分钟数，默认 30）。

用 /tasks 查看运行中和已完成的审查、打开详情或停止；用 /usage-credits 检查或修改 usage credits 设置。

什么时候用 ​

  • 合并前对较大改动想要更深一层、能发现单次审查易遗漏问题的高置信度审查时。
  • 需要每条发现都被独立验证、聚焦真实 Bug 的预合并审查。
  • 希望审查在云端运行、不占用本地终端资源时。
  • 在 CI 或脚本中以非交互方式（claude ultrareview）触发审查。

限制 / 坑 ​

  • 需用 Claude.ai 账号认证；仅用 API key 时须先 /login 用 Claude.ai 认证。
  • 在 Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry 下不可用；对启用 Zero Data Retention 的组织不可用。
  • 付费审查需账户或组织已开启 usage credits，否则 Claude Code 会拦截启动并跳转账单设置。
  • 审查一旦远程会话启动即计入一次免费次数；提前停止或未完成也算用掉一次。停止会归档云会话且不返回部分发现。
  • 若仓库过大无法打包，需改用 PR 模式（推送分支、开 draft PR 后用 /code-review ultra <PR-number>）。

硬事实速查（12 条） ​

  • Research preview 功能，自 Claude Code v2.1.86 起可用。
  • 命令为 /code-review ultra，/ultrareview 为保留别名。
  • 运行在 Claude Code on the web 基础设施的远程沙箱中。
  • 审查通常耗时 5 到 10 分钟，以后台任务运行。
  • Pro 和 Max 各含 3 次一次性免费运行（不刷新）；Team 和 Enterprise 无免费次数。
  • 免费次数用尽后按 usage credits 计费，单次约 $5 到 $20，取决于改动大小；付费审查仅按实际运行部分计费。
  • PR 模式支持 github.com 及管理员已接入的 GitHub Enterprise Server 实例。
  • 非交互子命令 claude ultrareview 可传 PR 编号或基准分支，进度与会话 URL 输出到 stderr，stdout 保持可解析。
  • 退出码：完成（无论有无发现）为 0，启动失败/远程会话出错/超时为 1，Ctrl-C 中断为 130；中断子命令后远程审查仍继续。
  • flag：--json 打印原始 bugs.json，--timeout <minutes> 默认 30。
  • 用 /tasks 跟踪审查，/usage-credits 管理用量额度。
  • GitHub PR 的自动审查由 Code Review 集成直接以内联 PR 评论形式发布，无需 CLI。

官方出处：https://code.claude.com/docs/en/ultrareview