AI-translated from English; not yet reviewed by a fluent editor.

# 在一个分支上运行 Claude Code Ultrareview，并核实发现的问题

> 本指南依据官方文档，说明如何在一次 Claude Code 云端审查前检查仓库上传范围和用量额度，再根据分支代码核实问题，由人决定是否合并。

By BIG CHANGE Editorial

Published: 2026-10-20T11:00:41.997Z
Updated: 2026-10-20T11:00:41.997Z
Canonical: https://bigchange.ai/blog/claude-code-ultrareview-branch-findings-guide

![Conceptual charcoal illustration of an orange network cable connecting a desktop computer tower to a wall port.](https://bigchange.ai/api/media/file/ultrareview-repository-upload-boundary-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 的 Ultrareview 可以在 Anthropic 云端检查现有 Git 分支，再由人决定是否合并。要考虑的不只是能否找出错误：哪些仓库内容会离开电脑、运行费用是多少、能否对照代码核实每一项发现？本指南面向有权审查较大分支，并可按组织规定上传仓库的读者。内容依据[Anthropic 当前的研究预览版手册](https://code.claude.com/docs/en/ultrareview)；BIG CHANGE 没有运行该命令，也未测试其发现的问题。

## 关键变化

- **发生了什么变化：** `/code-review ultra`可在云端将当前分支与默认分支或指定基准比较，审查内容包括已暂存和未提交的修改。
- **为何重要：**审查可针对现有修改给出具体文件中的问题，但分支方式也会上传仓库状态。仅凭眼前的 diff，无法判断哪些内容会离开电脑。
- **需要注意：**可用性、上传范围、一次性免费运行次数及用量额度估算可能变化。每项发现仍须在本地核实；没有发现问题，并不证明分支不存在错误。

### 1. 确认分支及原有检查

从包含该修改的仓库开始。记录当前分支、预期基准、验收条件及项目已有的测试或构建命令。检查完整 diff，包括受 Git 跟踪文件中已暂存和未提交的修改。不指定基准时，命令会将当前分支与默认分支比较；更换基准会改变比较范围。保留初次检查结果，以便修复问题后再次运行同一检查。

确认这就是要审查的分支。空比较会被拒绝。首次提交或没有共同合并基点的分支，可能使所有受跟踪文件成为目标，具体须遵守手册中的确认步骤和限制。如果这不是预期审查范围，请先修正分支或基准再启动。目前文档记载的默认上限为 500 个修改文件和 8,000 行修改；实际拒绝信息会报告当时生效的上限。

### 2. 决定仓库能否上传云端

[Anthropic 的上传规则](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github)说明，完整克隆包包含**所有分支**的仓库历史，以及受跟踪文件中未提交的修改。未跟踪文件不会上传，除非主动加入跟踪。在原生 Windows 上，即使文件名看似包含凭据，受跟踪文件的未提交修改仍会上传。在 macOS、Linux 和 WSL 上，某些敏感的未提交修改会被省略，但已提交内容仍在历史中。按照组织代码政策检查仓库历史及受跟踪修改；其中如有无权上传的内容，请保留原内容并停止。审查 diff 很小，并不能替代这项判断。

文档要求上传包小于 100 MB。包更大时，Claude Code 可能退回只使用当前分支，再退回压缩历史后的工作树快照，也可能失败。接受降级方案前，检查真实范围。审查 `github.com` 上的 pull request 是另一条路径：云端沙箱通过已连接的 GitHub 账号克隆 PR，而不是上传本地工作树。

还要检查账号资格。Ultrareview 需要登录 `claude.ai`，不能只用 API key 认证。当前手册排除 Bedrock、Google Cloud Agent Platform、Microsoft Foundry、Zero Data Retention 和 HIPAA 配置；客户自管加密密钥也会阻止使用。在某些不符合条件的情况下，命令会改为进行**本地**审查。云端不可用时，应准确标注结果类型。独立的[本地 `/code-review`工作流](https://code.claude.com/docs/en/code-review-local)可用于获得授权的本地审查。

### 3. 阅读启动对话框，再批准一次运行

在待审查分支的交互式 Claude Code 会话中，输入：

```text
/code-review ultra
```

若要使用已确认的其他基准，例如 `develop`，输入：

```text
/code-review ultra develop
```

命令针对的是分支比较，而不是文件路径。阅读对话框中的分支、基准、修改文件数和行数、剩余免费次数及预计用量额度，并结合第 2 步确认的仓库上传范围检查。比较、上传权限或费用估算不符时，应停止。只有在你调用并确认后，命令才会开始。

Anthropic 目前为 Pro 和 Max 账号列出三次**一次性**免费运行。根据手册，之后每次通常消耗价值 5–25 美元的用量额度；应以账号启动界面中的估算决定是否运行。付费审查须先启用用量额度。云端会话启动后就会计入一次运行。停止免费运行仍会消耗该次数；付费运行可能按已执行部分收费。功能、价格和可用性均属于研究预览版条件，应核对当前对话框，不要仅按本指南中的固定金额编预算。

### 4. 跟踪同一次运行，逐项检查问题

手册称，一次审查通常耗时 15–25 分钟，并在后台运行。使用 `/tasks`查看运行中或已完成的审查，并通过会话通知查看问题。终端没有动静，不代表应启动第二次审查。停止审查不会返回部分发现。若似乎找不到会话，先检查它是否已停止、归档或删除，以及登录账号是否变化。非交互命令超时后，云端运行可能仍然活跃；考虑另一次付费或免费运行前，先确认原运行的状态。

对每项发现，打开引用的文件和位置。把结论与预期行为比较，能够复现时运行针对性检查。记录修复、误报、可接受的取舍或待解问题，并附上支持判断的代码及检查结果。如果 Claude 提出修复，接受前先检查其 diff。Anthropic 表示审查代理会验证报告的问题，但这项厂商说明不能代替你的检查。审查完成且没有发现问题，只是一次审查结果，不是无错误的证明。

### 5. 根据最终分支决定是否合并

修改后，对照预期基准检查完整的最终 diff。重新运行原验收命令，以及评估问题时用过的针对性检查；如实记录结果，包括失败。未解决问题或检查失败的分支应保持未合并，直到所有者决定下一步。是否合并由人工审查者或所有者决定。另一次 Ultrareview 是独立运行，会另外消耗免费次数或额度，只有修改后的代码确有需要时才应启动。

这是对已开发分支进行云端审查的一步。若需要更完整的设计、实施和分支审查流程，请参阅 BIG CHANGE 的[Superpowers 指南](https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide)。

## 资料来源与延伸阅读

- [Anthropic：《使用 ultrareview 查找错误》](https://code.claude.com/docs/en/ultrareview)记载命令、分支与基准范围、账号限制、对话框、价格、任务跟踪、上限及问题发现。这是研究预览产品手册，不能证明 BIG CHANGE 运行过审查，也不能证明某个分支安全。
- [Anthropic：《在云端使用 Claude Code》](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github)说明上传包、历史、不同平台对受跟踪文件的处理、未跟踪文件及大小超限时的降级方案。上传前，读者仍须检查真实仓库和政策。
- [Anthropic：《使用 /code-review 进行本地审查》](https://code.claude.com/docs/en/code-review-local)介绍云端不可用或无须使用时的独立本地审查路径。其结果不能称为 Ultrareview 发现。

## Sources

- [使用 ultrareview 查找错误 — Claude Code Docs](https://code.claude.com/docs/en/ultrareview) — 云端命令、范围、账号排除条件、对话框、上限、额度、任务跟踪及发现的第一手手册。它不能证明某次审查已运行或找到了错误。
- [在云端使用 Claude Code — Claude Code Docs](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github) — 完整克隆历史、受跟踪及未跟踪修改、不同平台对敏感文件的处理，以及上传包大小与降级规则的第一手手册。它不能确定读者是否有上传权限。
- [使用 /code-review 进行本地审查 — Claude Code Docs](https://code.claude.com/docs/en/code-review-local) — 独立本地工作流的第一手手册；不得将该流程描述为已完成的云端 Ultrareview。