Markdown 版本

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。