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 進行身份驗證。使用 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 的 Claude Code 時,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 執行以試用該功能。這三次執行是每個帳戶的一次性配額,不會刷新。使用完全部三次後,或在免費執行期結束後,每次審查都會計入額外使用量,通常成本為 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 分鐘 |
| 成本 | 計入正常使用量 | 免費執行次數,然後大約 20 每次審查作為額外使用量 |
| 最適合 | 迭代時的快速反饋 | 在實質性變更前合併時的信心 |
/review 在工作時獲得快速反饋。在合併實質性變更前使用 /code-review ultra,當您想要更深入的審查以捕捉單次審查可能遺漏的問題時。
相關資源
- Claude Code 網路版:了解遠端工作階段和雲端沙箱的工作原理
- 使用 ultraplan 規劃複雜變更:ultrareview 的規劃對應項,用於前期設計工作
- 有效管理成本:追蹤使用量並設定支出限制