使用 Ultrareview 尋找錯誤

使用 /code-review ultra 在雲端執行深度多代理程式碼審查，在合併前尋找並驗證錯誤。

Ultrareview 是在 雲端工作階段上執行的深度程式碼審查，運行於 Anthropic 的基礎設施上。當您執行 /code-review ultra 時，Claude Code 會在雲端沙箱中啟動一群審查代理程式，以尋找您分支或拉取請求中的錯誤。

與本地 /code-review 相比，ultrareview 提供：

• 更高的信號品質：每個報告的發現都經過獨立重現和驗證，因此結果專注於真實錯誤而非風格建議
• 更廣泛的覆蓋範圍：許多審查代理程式並行探索變更，這會發現本地審查可能遺漏的問題
• 無本地資源使用：審查完全在雲端沙箱中執行，因此您的終端在執行期間保持空閒，可用於其他工作

Ultrareview 需要使用 claude.ai 帳戶進行身份驗證，因為它在 Anthropic 的基礎設施上作為雲端工作階段執行。如果您僅使用 API 金鑰登入，請先執行 /login 並使用 claude.ai 進行身份驗證。使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 的 Claude Code 時，Ultrareview 不可用，對於已啟用零資料保留的組織也不可用。當 ultrareview 不可用時，/code-review ultra 會改為在您的工作階段中執行本地審查。

從 CLI 執行 ultrareview

從任何 git 儲存庫啟動審查：

/code-review ultra

不帶引數時，ultrareview 會審查您目前分支與預設分支之間的差異，包括未提交和已暫存的變更。對於名稱類似認證或金鑰的檔案（例如 .env 和 *.tfvars 檔案）的未提交變更，Claude Code 遵循將本機儲存庫上傳到雲端工作階段的規則。

對於分支審查，Claude Code 會組合儲存庫狀態並將其上傳到雲端沙箱；當您審查提取請求時，Claude Code 不會從您的機器上傳任何內容。

啟動前，Claude Code 會顯示確認對話方塊，其中包含審查範圍、您剩餘的免費執行次數和估計成本；對於分支審查，範圍包括檔案和行數。確認後，審查會在背景中繼續進行，同時您可以繼續使用您的工作階段。

該命令僅在您使用 /code-review ultra 叫用時執行；Claude 不會自行啟動 ultrareview。

針對不同的基礎進行審查

若要與預設分支以外的基礎進行比較，請傳遞分支名稱。此範例會針對 develop 而不是預設分支審查您的目前分支：

/code-review ultra develop

基礎分支不需要存在於您的本機複製中；Claude Code 會從 origin 擷取它。如果名稱有拼寫錯誤，Claude Code 會在錯誤中建議最接近的分支名稱。

提交 ID 或標籤也可以作為基礎，審查則涵蓋您的分支自該提交以來的變更。

審查提取請求

若要審查 GitHub 提取請求而不是本機分支，請傳遞 PR 編號：

/code-review ultra 1234

該命令也接受 #1234、PR 1234 和貼上的 PR URL；貼上的 URL 必須指向您目前目錄中的儲存庫。

在 PR 模式中，雲端沙箱直接從主機複製提取請求，而不是組合您的本機工作樹。PR 模式適用於 github.com 上的儲存庫和GitHub Enterprise Server 執行個體上的儲存庫，這些執行個體已由擁有者連接到 Claude Code。

對於 github.com 上的儲存庫，沙箱使用連接到您 Claude 帳戶的 GitHub 帳戶進行複製，因此該帳戶必須能夠讀取 PR 的儲存庫。Claude Code 在建立雲端工作階段前檢查此項，除非您已設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC，並在未連接帳戶或帳戶無法看到儲存庫時拒絕啟動；拒絕會命名修正方式。在 v2.1.248 之前，Claude Code 在啟動前不檢查此項。

執行 /web-setup 以將您的 GitHub CLI 登入連接到您的 Claude 帳戶。

將發現結果發佈到提取請求

在 Claude Code v2.1.227 或更新版本上，當您在 github.com 上審查提取請求時，您可以讓 Claude 將完成的發現結果作為來自您自己 GitHub 帳戶的單一純文字評論發佈到 PR。該評論不是審查或核准，並以「由 Claude Code 生成」的備註結尾。當您審查分支或 GitHub Enterprise Server 提取請求時，Claude Code 只會在您的工作階段中顯示發現結果。

Claude Code 絕不會發佈，除非您在該執行中選擇發佈，且 --no-post 是預設值。發佈是您為每次執行所做的選擇：

• 互動式：在啟動對話方塊中，選取執行並將發現結果作為我發佈到 PR。如果您將 --post 新增到命令中，如 /code-review ultra 1234 --post，Claude Code 會預先選取該選擇，但仍會在啟動前詢問。
• 非互動式：使用 --post 執行 claude ultrareview 子命令。您透過使用該旗標執行子命令來同意發佈，因此 Claude Code 會發佈而不詢問。在 claude -p '/code-review ultra' 執行中，Claude Code 在發現結果到達前退出，因此不會發佈任何內容；請改用子命令。

Claude Code 不會從您的機器發佈。它會將審查的工作階段 ID 傳送到 Anthropic API，該 API 會透過您連接到 Claude 的 GitHub 帳戶將審查的儲存發現結果作為評論發佈。發佈需要與審查本身相同的 claude.ai 登入，且在第三方提供者上或當您設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 時不可用。

在互動式工作階段中，Claude Code 會在發現結果到達時啟動發佈，因此請保持工作階段開啟，直到審查完成。Claude Code 只在該工作階段中保留發佈選擇。如果工作階段在審查完成前結束，Claude Code 不會發佈任何內容，即使您稍後繼續對話。

發佈完成後，Claude 會告訴您結果：

• 已發佈：Claude 會提供評論的連結。
• 已發佈：同一審查的較早發佈已將評論放在 PR 上，因此 Claude 會連結您到提取請求，而不是再次發佈。
• 失敗：Claude 會告訴您原因，發現結果會保留在您的終端中，以便您可以手動發佈。

用純文字傳遞請求

在 Claude Code v2.1.218 或更新版本上，您也可以用純文字描述您正在進行的工作：

/code-review ultra check my auth changes

審查仍涵蓋您的目前分支，與不帶引數執行的範圍相同。Claude 會將您的文字保留為備註，在啟動對話方塊中顯示，並在發現結果到達時將其與發現結果相關聯。

Claude Code 只有在文字超過一個單字且不是分支名稱或 PR 參考時，才會將其視為備註。它將單一單字讀取為分支名稱或 PR 參考，因此拼寫錯誤的分支名稱會從針對不同的基礎進行審查獲得最接近分支的錯誤，而不是使用備註啟動。如果您的文字結合 PR 參考與其他單字（例如 check PR 123 again），Claude Code 也不會啟動；它會要求您重新執行，僅使用 PR 編號來審查該 PR，或不使用參考來審查您的目前分支。

差異限制和備用方案

Ultrareview 在任何審查工作執行前檢查差異，並在無法按原樣審查時告訴您：

• 差異過大：分支審查預設最多可包含 500 個變更檔案和 8,000 個變更行。確切值可能會變更，拒絕會命名生效的值、您的差異大小和變更行數最多的檔案。Claude Code 以相同方式拒絕過大的提取請求，命名其檔案和行數，但不命名每個檔案的明細

• 沒有要審查的內容：當針對基礎的差異為空時，ultrareview 會拒絕並命名它比較的分支或提交，以及您所在的情況，例如在基礎分支本身上且沒有未提交的內容，或其提交全部已是基礎一部分的分支。它也會為該情況建議解決方式，例如切換到您有工作的分支、暫存或提交本機編輯，或傳遞不同的基礎

• 首次提交：儲存庫的首次提交沒有更早的內容可比較，因此在您在啟動對話方塊中確認後，ultrareview 會審查其中的每個檔案。如果您有未追蹤的檔案，它會改為拒絕並告訴您 git add 您想審查的檔案。相同的大小限制適用。

  首次提交只有在該確認後才會整體審查，因此 claude ultrareview 子命令和 claude -p 會拒絕它並指向互動式工作階段。需要 Claude Code v2.1.277 或更新版本

• 沒有合併基礎：當您的分支與基礎分支沒有共享歷史記錄時，或儲存庫沒有基礎分支可比較時，ultrareview 會改為審查儲存庫中的每個追蹤檔案。備用方案需要完整複製並套用相同的大小限制。它只有在您在啟動對話方塊中確認或自行執行 claude ultrareview 子命令時才會啟動。在 claude -p 和任何其他都不會發生的地方，ultrareview 會拒絕，說審查會涵蓋每個檔案，並指向互動式工作階段。

  在沒有分支或其他參考的簽出上（例如透過在擷取 URL 後簽出 FETCH_HEAD 建立的分離 HEAD），Claude Code 拒絕審查並建議先建立分支

定價和免費執行次數

Ultrareview 是一項高級功能，按額外使用量而非您計畫的包含使用量計費。

• 免費執行次數：Pro 和 Max 的三次執行是每個帳戶的一次性配額，不會刷新。
• 每次審查的成本：使用完免費執行次數後，通常需要 $5 至 $25 的使用量額度，具體取決於變更的大小，與啟動對話框在每次執行前顯示的估計相符。
• 何時計算執行次數：一旦雲端工作階段開始。您提前停止或未能完成的審查仍會使用一次免費執行；付費審查僅針對執行的部分計費。

由於 ultrareview 在免費執行次數外始終按使用量額度計費，您的帳戶或組織必須在啟動付費審查前啟用使用量額度。如果未啟用使用量額度，Claude Code 會阻止啟動，啟用方式取決於您的計費存取權限：

• 如果您可以管理帳戶的計費，Claude Code 會將您連結到計費設定，您可以在那裡開啟使用量額度。
• 在 Team 和 Enterprise 計畫上，沒有計費存取權限的成員可以從 CLI 傳送請求，要求其管理員開啟使用量額度。

您也可以執行 /usage-credits 來檢查或變更您的使用量額度設定。

Claude Code 在每次對話中要求您確認一次使用量額度計費：例如當您使用 /clear 啟動新對話時，Claude Code 會在下一次付費審查時再次顯示確認。

追蹤執行中的審查

審查通常需要 5 到 10 分鐘。審查作為背景工作執行，因此您可以繼續在工作階段中工作、啟動其他命令或完全關閉終端。如果您選擇將發現結果發佈到提取請求，請保持工作階段開啟，直到審查完成；如果工作階段先結束，Claude Code 將不會發佈任何內容。

使用 /tasks 查看執行中和已完成的審查、開啟審查的詳細檢視，或停止進行中的審查。如果您停止審查，Claude Code 會封存雲端工作階段，且不會返回部分發現。

Claude 也可以告訴您審查已停止或其工作階段未找到：

• 如果審查的雲端工作階段在審查完成前在 claude.ai 上停止或封存，Claude 會告訴您它已停止。
• 如果審查的雲端工作階段已刪除，或您自啟動它以來已登入不同的 Claude 帳戶或組織，Claude 會告訴您工作階段未找到。
• 如果您切換帳戶，審查可能仍會在啟動它的帳戶下完成。如果審查仍在執行中，請以該帳戶重新登入，並使用 claude --resume 繼續對話以重新附加它。

審查完成後，Claude Code 會在您的工作階段中將已驗證的發現顯示為通知。每個發現都包括檔案位置和問題說明，以便您可以直接要求 Claude 修復它。

非互動方式執行 ultrareview

使用 claude ultrareview 子命令從 CI 或指令碼啟動 ultrareview，無需互動工作階段。該子命令會啟動與 /code-review ultra 相同的審查，阻塞直到遠端審查完成，並將發現結果列印到 stdout。

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

不帶引數的情況下，該子命令會審查您目前分支與預設分支之間的差異，當不存在合併基礎時，使用與 /code-review ultra 相同的整個儲存庫回退。傳遞 PR 編號以審查提取請求，或傳遞基礎分支以針對它進行審查；基礎分支處理與互動命令相符。

當您執行該子命令時，您同意整個儲存庫回退以及帳單和條款提示，因此執行會在不等待輸入的情況下開始。您自己執行它才算是同意。當 Claude 改為為您執行該子命令時（例如透過 Bash 工具），Claude Code 會拒絕整個儲存庫審查。

在 Claude Code v2.1.218 或更新版本上，您也可以透過在非互動工作階段中執行 /code-review ultra 來啟動雲端審查，例如 claude -p '/code-review ultra'。Claude Code 會啟動審查並列印追蹤連結，無需等待發現結果，這與 claude ultrareview 不同，後者會阻塞直到發現結果到達。當審查會計費使用額度時，Claude Code 會在啟動前停止並指向 claude ultrareview，因為帳單確認需要互動工作階段。在 v2.1.218 之前，非互動工作階段中的 /code-review ultra 執行本機審查。

進度訊息和即時工作階段 URL 會進入 stderr，以便 stdout 保持可解析。使用這些旗標來控制輸出、逾時和是否發佈發現結果：

執行 claude ultrareview 需要與 /code-review ultra 相同的驗證和使用額度設定。

該子命令會以以下三個代碼之一結束：

• 0：審查已完成，無論是否有發現結果
• 1：審查未能啟動或在完成前被停止、雲端工作階段出錯，或逾時已過
• 130：您使用 Ctrl-C 中斷了該子命令

如果您中斷該子命令，遠端審查會繼續執行；請遵循列印到 stderr 的工作階段 URL 在瀏覽器中觀看它。

使用 --post 時，該子命令會在列印發現結果後立即開始發佈，並將連結列印到 stderr。

• 如果執行失敗、被停止、逾時，或如果您中斷它，該子命令不會發佈任何內容。
• 如果審查完成但評論未被發佈，Claude Code 會將原因列印到 stderr，發現結果會保留在 stdout 上，以便您可以手動發佈它們。

對於 GitHub 提取請求上的自動審查，Code Review 直接與您的儲存庫整合，並將發現結果作為內嵌 PR 評論發佈，無需 CLI 步驟。

ultrareview 與 `/code-review` 的比較

兩個審查都檢查程式碼，但您在工作流程的不同階段使用它們。

使用 /code-review 在工作時獲得快速反饋，或傳遞 PR 編號以在批准前審查隊友的拉取請求。在合併實質性變更前使用 /code-review ultra，當您想要更深入的審查以捕捉本地審查可能遺漏的問題時。

相關資源

• 在雲端使用 Claude Code：了解雲端工作階段和雲端沙箱的工作原理
• 有效管理成本：追蹤使用量並設定支出限制