> ## 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.

# Code Review

> 設定自動化 PR 審查，使用多代理分析您的完整程式碼庫來捕捉邏輯錯誤、安全漏洞和迴歸

<Note>
  Code Review 處於研究預覽階段，適用於 [Team 和 Enterprise](https://claude.ai/admin-settings/claude-code) 訂閱。對於啟用了 [Zero Data Retention](/zh-TW/zero-data-retention) 的組織，此功能不可用。
</Note>

Code Review 分析您的 GitHub pull request，並在發現問題的程式碼行上發佈內聯評論。一群專門的代理在您完整程式碼庫的背景下檢查程式碼變更，尋找邏輯錯誤、安全漏洞、破損的邊界情況和細微的迴歸。

發現結果按嚴重程度標記，不會批准或阻止您的 PR，因此現有的審查工作流程保持不變。您可以通過在存儲庫中添加 `CLAUDE.md` 或 `REVIEW.md` 文件來調整 Claude 標記的內容。

要在您自己的 CI 基礎設施中運行 Claude 而不是此託管服務，請參閱 [GitHub Actions](/zh-TW/github-actions) 或 [GitLab CI/CD](/zh-TW/gitlab-ci-cd)。對於自託管 GitHub 實例上的存儲庫，請參閱 [GitHub Enterprise Server](/zh-TW/github-enterprise-server)。

本頁涵蓋：

* [審查如何運作](#how-reviews-work)
* [設定](#set-up-code-review)
* [手動觸發審查](#manually-trigger-reviews)，使用 `@claude review` 和 `@claude review once`
* [自訂審查](#customize-reviews)，使用 `CLAUDE.md` 和 `REVIEW.md`
* [定價](#pricing)
* [故障排除](#troubleshooting)失敗的運行和缺失的評論
* [在本地審查差異](#review-a-diff-locally)，使用 `/code-review` 命令

<Note>
  要在本地終端中審查差異而無需安裝 GitHub App，請在任何 Claude Code 工作階段中運行 `/code-review` 命令。請參閱[在本地審查差異](#review-a-diff-locally)。
</Note>

<h2 id="how-reviews-work">
  審查如何運作
</h2>

一旦管理員為您的組織[啟用 Code Review](#set-up-code-review)，審查將在 PR 開啟時、每次推送時或手動請求時觸發，具體取決於存儲庫的配置行為。在任何模式下，評論 `@claude review` [在 PR 上啟動審查](#manually-trigger-reviews)。

當審查運行時，多個代理在 Anthropic 基礎設施上並行分析差異和周圍程式碼。每個代理尋找不同類別的問題，然後驗證步驟檢查候選項目是否符合實際程式碼行為，以過濾掉誤報。結果被去重、按嚴重程度排名，並作為內聯評論發佈在發現問題的特定行上，並在審查正文中提供摘要。如果未發現問題，Code Review 會更新 GitHub 檢查運行以顯示未檢測到任何問題。Claude 也可能在 PR 上發佈簡短的確認評論。

審查成本隨著 PR 大小和複雜性而擴展，平均在 20 分鐘內完成。管理員可以通過[分析儀表板](#view-usage)監控審查活動和支出。

<h3 id="severity-levels">
  嚴重程度級別
</h3>

每個發現都標記有嚴重程度級別：

| 標記 | 嚴重程度 | 含義                   |
| :- | :--- | :------------------- |
| 🔴 | 重要   | 應在合併前修復的錯誤           |
| 🟡 | 細節   | 輕微問題，值得修復但不阻止        |
| 🟣 | 預先存在 | 程式碼庫中存在但未由此 PR 引入的錯誤 |

發現包括可折疊的擴展推理部分，您可以展開以了解 Claude 為什麼標記該問題以及它如何驗證問題。

<h3 id="rate-and-reply-to-findings">
  對發現進行評分和回覆
</h3>

每個來自 Claude 的審查評論都已附加 👍 和 👎，因此兩個按鈕都會在 GitHub UI 中出現，以便一鍵評分。如果發現有用，請點擊 👍；如果發現錯誤或嘈雜，請點擊 👎。Anthropic 在 PR 合併後收集反應計數，並使用它們來調整審查者。反應不會觸發重新審查或更改 PR 上的任何內容。

回覆內聯評論不會提示 Claude 回應或更新 PR。要對發現採取行動，請修復程式碼並推送。如果 PR 訂閱了推送觸發的審查，下一次運行將在問題修復時解決線程。要在不推送的情況下請求新審查，請作為[頂級 PR 評論](#manually-trigger-reviews)評論 `@claude review once`。

<h3 id="check-run-output">
  檢查運行輸出
</h3>

除了內聯審查評論外，每次審查都會填充 **Claude Code Review** 檢查運行，該運行與您的 CI 檢查一起出現。展開其 **Details** 連結以在一個地方查看每個發現的摘要，按嚴重程度排序：

| 嚴重程度  | 文件:行                      | 問題                             |
| ----- | ------------------------- | ------------------------------ |
| 🔴 重要 | `src/auth/session.ts:142` | 令牌刷新與登出競爭，留下過時的會話活躍            |
| 🟡 細節 | `src/auth/session.ts:88`  | `parseExpiry` 在格式錯誤的輸入上無聲地返回 0 |

每個發現也作為 **Files changed** 標籤中的註釋出現，直接標記在相關的差異行上。重要發現用紅色標記呈現，細節用黃色警告，預先存在的錯誤用灰色通知。註釋和嚴重程度表獨立於內聯審查評論寫入檢查運行，因此即使 GitHub 拒絕在移動的行上的內聯評論，它們仍然可用。

檢查運行始終以中立結論完成，因此它永遠不會通過分支保護規則阻止合併。如果您想根據 Code Review 發現來限制合併，請在您自己的 CI 中讀取檢查運行輸出中的嚴重程度細分。Details 文本的最後一行是機器可讀的評論，您的工作流可以使用 `gh` 和 jq 解析：

```bash theme={null}
gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
```

這返回一個 JSON 對象，其中包含每個嚴重程度的計數，例如 `{"normal": 2, "nit": 1, "pre_existing": 0}`。`normal` 鍵保存重要發現的計數；非零值意味著 Claude 發現至少一個值得在合併前修復的錯誤。

<h3 id="what-code-review-checks">
  Code Review 檢查的內容
</h3>

默認情況下，Code Review 專注於正確性：會破壞生產的錯誤，而不是格式設置偏好或缺失的測試覆蓋。您可以通過[添加指導文件](#customize-reviews)到您的存儲庫來擴展它檢查的內容。

<h2 id="set-up-code-review">
  設定 Code Review
</h2>

管理員為組織啟用 Code Review 一次，並選擇要包含的存儲庫。

<Steps>
  <Step title="開啟 Claude Code 管理員設定">
    前往 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 並找到 Code Review 部分。您需要對 Claude 組織的管理員或主要管理員角色，以及在 GitHub 組織中安裝 GitHub Apps 的權限。
  </Step>

  <Step title="開始設定">
    點擊 **Setup**。這開始 GitHub App 安裝流程。
  </Step>

  <Step title="安裝 Claude GitHub App">
    按照提示將 Claude GitHub App 安裝到您的 GitHub 組織。該應用請求這些存儲庫權限：

    * **Contents**：讀取和寫入
    * **Issues**：讀取和寫入
    * **Pull requests**：讀取和寫入

    Code Review 使用對內容的讀取存取權限和對 pull request 的寫入存取權限。更廣泛的權限集也支持 [GitHub Actions](/zh-TW/github-actions)，如果您稍後啟用它。
  </Step>

  <Step title="選擇存儲庫">
    選擇要為 Code Review 啟用的存儲庫。如果您看不到存儲庫，請確保您在安裝期間給予 Claude GitHub App 存取權限。您可以稍後添加更多存儲庫。
  </Step>

  <Step title="設定每個存儲庫的審查觸發器">
    設定完成後，Code Review 部分在表格中顯示您的存儲庫。對於每個存儲庫，使用 **Review Behavior** 下拉菜單選擇何時運行審查：

    * **Once after PR creation**：當 PR 開啟或標記為準備審查時，審查運行一次
    * **After every push**：在每次推送到 PR 分支時運行審查，在 PR 演變時捕捉新問題，並在您修復標記的問題時自動解決線程
    * **Manual**：審查僅在有人 [在 PR 上評論 `@claude review` 或 `@claude review once`](#manually-trigger-reviews) 時開始；`@claude review` 也會訂閱 PR 以進行後續推送的審查

    每次推送時審查運行最多的審查並花費最多。手動模式對於高流量存儲庫很有用，您想選擇特定 PR 進行審查，或者只在 PR 準備好時才開始審查您的 PR。
  </Step>
</Steps>

存儲庫表還顯示每個存儲庫基於最近活動的平均審查成本。使用行操作菜單按存儲庫打開或關閉 Code Review，或完全移除存儲庫。

要驗證設定，請開啟測試 PR。如果您選擇了自動觸發器，名為 **Claude Code Review** 的檢查運行會在幾分鐘內出現。如果您選擇了手動，在 PR 上評論 `@claude review` 以開始第一次審查。如果沒有檢查運行出現，請確認存儲庫列在您的管理員設定中，並且 Claude GitHub App 有權存取它。

<h2 id="manually-trigger-reviews">
  手動觸發審查
</h2>

兩個評論命令按需啟動審查。無論存儲庫的配置觸發器如何，兩者都有效，因此您可以使用它們在手動模式下選擇特定 PR 進行審查，或在其他模式下獲得立即重新審查。

| 命令                    | 它做什麼                    |
| :-------------------- | :---------------------- |
| `@claude review`      | 啟動審查並訂閱 PR 以進行今後的推送觸發審查 |
| `@claude review once` | 啟動單次審查，不訂閱未來推送          |

當您想要對 PR 的當前狀態獲得反饋但不想每次後續推送都產生審查時，使用 `@claude review once`。這對於具有頻繁推送的長期運行 PR 很有用，或者當您想要一次性第二意見而不改變 PR 的審查行為時。

對於任一命令觸發審查：

* 將其發佈為頂級 PR 評論，而不是差異行上的內聯評論
* 在評論開始時放置命令，如果您使用一次性形式，將 `once` 放在同一行
* 您必須對存儲庫具有所有者、成員或協作者存取權限
* PR 必須開啟

與自動觸發不同，手動觸發在草稿 PR 上運行，因為明確的請求表示您想要現在的審查，無論草稿狀態如何。

如果該 PR 上已有審查正在運行，請求將排隊直到進行中的審查完成。您可以通過 PR 上的檢查運行監控進度。

<h2 id="customize-reviews">
  自訂審查
</h2>

Code Review 從您的存儲庫讀取兩個文件來指導它標記的內容。它們在強度上有所不同：

* **`CLAUDE.md`**：Claude Code 用於所有任務的共享項目指令，不僅僅是審查。Code Review 將其讀取為項目背景，並將新引入的違規標記為細節。
* **`REVIEW.md`**：僅審查指導，直接注入到審查管道中每個代理的系統提示中作為最高優先級。使用它來改變標記的內容、嚴重程度以及發現的報告方式。

<h3 id="claude-md">
  CLAUDE.md
</h3>

Code Review 讀取您存儲庫的 `CLAUDE.md` 文件，並將新引入的違規視為 [細節級別](#severity-levels) 的發現。這是雙向工作的：如果您的 PR 以使 `CLAUDE.md` 陳述過時的方式更改程式碼，Claude 會標記文件需要更新。

Claude 在目錄層次結構的每個級別讀取 `CLAUDE.md` 文件，因此子目錄的 `CLAUDE.md` 中的規則僅適用於該路徑下的文件。有關 `CLAUDE.md` 如何運作的更多信息，請參閱 [memory 文檔](/zh-TW/memory)。

對於您不想應用於一般 Claude Code 會話的審查特定指導，請改用 [`REVIEW.md`](#review-md)。

<h3 id="review-md">
  REVIEW\.md
</h3>

`REVIEW.md` 是位於您存儲庫根目錄的文件，它覆蓋 Code Review 在您的存儲庫上的行為方式。其內容被注入到審查管道中每個代理的系統提示中作為最高優先級指令塊，優先於默認審查指導。

因為它是逐字粘貼的，`REVIEW.md` 是純指令：[`@` 導入語法](/zh-TW/memory#import-additional-files) 不會展開，引用的文件不會讀入提示中。將您想要強制執行的規則直接放在文件中。

<h4 id="what-you-can-tune">
  您可以調整什麼
</h4>

`REVIEW.md` 是自由格式的 markdown，因此任何您可以表達為審查指令的內容都在範圍內。下面的模式在實踐中影響最大。

**嚴重程度**：重新定義 🔴 重要對您的存儲庫意味著什麼。默認校準針對生產程式碼；文檔存儲庫、配置存儲庫或原型可能想要更窄的定義。明確說明哪些類別的發現是重要的，哪些最多是細節。您也可以向另一個方向升級，例如將任何 `CLAUDE.md` 違規視為重要而不是默認細節。

**細節量**：限制單次審查發佈的 🟡 細節評論數量。散文和配置文件可以永遠被打磨。像「最多報告五個細節，在摘要中提及其餘的計數」這樣的上限使審查可操作。

**跳過規則**：列出 Claude 應該不發佈任何發現的路徑、分支模式和發現類別。常見候選是生成的程式碼、lockfiles、供應商依賴和機器編寫的分支，以及您的 CI 已經強制執行的任何內容，如 linting 或拼寫檢查。對於值得進行某些審查但不完全審查的路徑，設定更高的標準而不是完全跳過：「在 `scripts/` 中，僅在接近確定且嚴重時報告。」

**存儲庫特定檢查**：添加您想在每個 PR 上標記的規則，例如「新 API 路由必須有集成測試。」因為 `REVIEW.md` 被注入為最高優先級，這些比長 `CLAUDE.md` 中的相同規則更可靠地著陸。

**驗證標準**：在發佈發現類別之前需要證據。例如，「行為聲明需要源中的 `file:line` 引用，而不是從命名推斷」減少了否則會花費作者往返的誤報。

**重新審查收斂**：告訴 Claude 當 PR 已經被審查時如何表現。像「在第一次審查後，抑制新細節並僅發佈重要發現」這樣的規則阻止一行修復從僅風格達到第七輪。

**摘要形狀**：要求審查正文以一行計數開頭，例如 `2 factual, 4 style`，並在這種情況下以「沒有事實問題」開頭。作者想在詳細信息之前知道工作的形狀。

<h4 id="example">
  示例
</h4>

此 `REVIEW.md` 為後端服務重新校準嚴重程度，限制細節，跳過生成的文件，並添加存儲庫特定檢查。

```markdown theme={null}
# 審查指令

## 重要在這裡意味著什麼

保留重要用於會破壞行為、洩露數據或阻止回滾的發現：不正確的邏輯、無範圍的數據庫查詢、日誌或錯誤消息中的 PII，以及不向後兼容的遷移。風格、命名和重構建議最多是細節。

## 限制細節

每次審查最多報告五個細節。如果您發現更多，請在摘要中說「加上 N 個類似項目」而不是內聯發佈它們。如果您發現的一切都是細節，請以「沒有阻止問題」開頭摘要。

## 不要報告

- CI 已經強制執行的任何內容：lint、格式化、類型錯誤
- `src/gen/` 下的生成文件和任何 `*.lock` 文件
- 故意違反生產規則的僅測試程式碼

## 始終檢查

- 新 API 路由有集成測試
- 日誌行不包括電子郵件地址、用戶 ID 或請求正文
- 數據庫查詢的範圍限於調用者的租戶
```

<h4 id="keep-it-focused">
  保持專注
</h4>

長度有成本：長 `REVIEW.md` 會稀釋最重要的規則。將其保留為改變審查行為的指令，並將一般項目背景留在 `CLAUDE.md` 中。

<h2 id="view-usage">
  查看使用情況
</h2>

前往 [claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) 查看整個組織的 Code Review 活動。儀表板顯示：

| 部分                   | 它顯示什麼                          |
| :------------------- | :----------------------------- |
| PRs reviewed         | 在選定時間範圍內審查的 pull request 的每日計數 |
| Cost weekly          | Code Review 的每週支出              |
| Feedback             | 因開發人員解決問題而自動解決的審查評論計數          |
| Repository breakdown | 每個存儲庫審查的 PR 計數和解決的評論           |

管理員設定中的存儲庫表也顯示每個存儲庫的平均審查成本。儀表板成本數字是用於監控活動的估計；對於發票準確的支出，請參閱您的 Anthropic 帳單。

<h2 id="pricing">
  定價
</h2>

Code Review 根據令牌使用情況計費。每次審查平均花費 \$15-25，隨著 PR 大小、程式碼庫複雜性和需要驗證的問題數量而擴展。Code Review 使用通過 [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) 單獨計費，不計入您計劃的包含使用情況。

您選擇的審查觸發器影響總成本：

* **Once after PR creation**：每個 PR 運行一次
* **After every push**：在每次推送時運行，將成本乘以推送次數
* **Manual**：在有人在 PR 上評論 `@claude review` 之前沒有審查

在任何模式下，評論 `@claude review` [選擇 PR 進入推送觸發的審查](#manually-trigger-reviews)，因此在該評論之後每次推送都會產生額外成本。要運行單次審查而不訂閱未來推送，請改為評論 `@claude review once`。

成本出現在您的 Anthropic 帳單上，無論您的組織是否為其他 Claude Code 功能使用 Amazon Bedrock 或 Google Vertex AI。要為 Code Review 設定月度支出上限，請前往 [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) 並為 Claude Code Review 服務配置限制。

通過 [analytics](#view-usage) 中的每週成本圖表或管理員設定中的每個存儲庫平均成本列監控支出。

<h2 id="troubleshooting">
  故障排除
</h2>

審查運行是盡力而為的。失敗的運行永遠不會阻止您的 PR，但它也不會自動重試。本部分涵蓋如何從失敗的運行中恢復，以及在檢查運行報告您找不到的問題時在哪裡查看。

<h3 id="retrigger-a-failed-or-timed-out-review">
  重新觸發失敗或超時的審查
</h3>

當審查基礎設施遇到內部錯誤或超過其時間限制時，檢查運行完成，標題為 **Code review encountered an error** 或 **Code review timed out**。結論仍然是中立的，因此沒有任何東西阻止您的合併，但沒有發現被發佈。

要再次運行審查，在 PR 上評論 `@claude review once`。這啟動一個新的審查，不訂閱 PR 以進行未來推送。如果 PR 已訂閱推送觸發的審查，推送新提交也會啟動新審查。

GitHub 的 Checks 標籤中的 **Re-run** 按鈕不會重新觸發 Code Review。改用評論命令或新推送。

<h3 id="review-didn’t-run-and-the-pr-shows-a-spend-cap-message">
  審查未運行，PR 顯示支出上限消息
</h3>

當您的組織的月度支出上限達到時，Code Review 在 PR 上發佈單個評論，解釋審查被跳過。審查在下一個計費期開始時自動恢復，或當管理員在 [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) 提高上限時立即恢復。

<h3 id="find-issues-that-aren’t-showing-as-inline-comments">
  查找未顯示為內聯評論的問題
</h3>

如果檢查運行標題說發現了問題，但您在差異上看不到內聯審查評論，請在這些其他位置查看發現的位置：

* **Check run Details**：在 Checks 標籤中的 Claude Code Review 檢查旁邊點擊 **Details**。嚴重程度表列出每個發現及其文件、行和摘要，無論內聯評論是否被接受。
* **Files changed annotations**：在 PR 上打開 **Files changed** 標籤。發現呈現為直接附加到差異行的註釋，與審查評論分開。
* **Review body**：如果您在審查運行時推送到 PR，某些發現可能引用當前差異中不再存在的行。這些出現在審查正文文本中的 **Additional findings** 標題下，而不是作為內聯評論。

<h2 id="review-a-diff-locally">
  在本地審查差異
</h2>

[`/code-review` 命令](/zh-TW/commands)在您的終端中審查差異，無需安裝 GitHub App。在任何 Claude Code 工作階段中運行它：它報告正確性錯誤和 {/* min-version: 2.1.151 */}重用、簡化和效率清理。預設情況下，本地審查涵蓋您分支相對於其上游的提交，加上工作樹中的任何未提交變更。傳遞 `--comment` 以將發現結果作為內聯 PR 評論發佈，或傳遞 `--fix` 以在審查後將發現結果應用到您的工作樹。

較低的[努力級別](/zh-TW/model-config#adjust-effort-level)返回較少、更高信心的發現，而 `high` 到 `max` 提供更廣泛的覆蓋範圍，可能包括不確定的發現。沒有努力參數時，審查使用工作階段的當前努力。若要審查預設差異以外的內容，請傳遞目標：檔案路徑、PR 編號、分支名稱或參考範圍，例如 `main...my-feature`。參考範圍形式審查從 `my-feature` 到 `main` 的提取請求將包含的已提交差異，無論分支的上游如何配置。

`/code-review ultra --fix` 在雲中運行更深入的 [ultrareview](/zh-TW/ultrareview)，然後在它們到達您的工作階段時將其發現結果應用到您的工作樹。Ultrareview 使用其自己的範圍：您的當前分支相對於儲存庫的預設分支，加上工作樹中的任何未提交和已暫存變更。

該命令在 v2.1.147 之前被命名為 `/simplify`，當時它預設應用修復。{/* min-version: 2.1.154 */}從 v2.1.154 開始，`/simplify` 運行單獨的僅清理審查，該審查應用修復而不尋找錯誤。如果您編寫了 `/simplify` 用於尋找錯誤，請切換到 `/code-review --fix`，它保持不變。

<h2 id="related-resources">
  相關資源
</h2>

Code Review 設計用於與 Claude Code 的其餘部分一起工作。如果您想在開啟 PR 之前在本地運行審查、需要自託管設定，或想深入了解 `CLAUDE.md` 如何在工具中塑造 Claude 的行為，這些頁面是很好的下一步：

* [Commands](/zh-TW/commands)：在本地 Claude Code 工作階段中運行 `/code-review` 以在推送前檢查差異
* [GitHub Actions](/zh-TW/github-actions)：在您自己的 GitHub Actions 工作流中運行 Claude，以實現超越程式碼審查的自訂自動化
* [GitLab CI/CD](/zh-TW/gitlab-ci-cd)：GitLab 管道的自託管 Claude 集成
* [Memory](/zh-TW/memory)：`CLAUDE.md` 文件如何在 Claude Code 中工作
* [Analytics](/zh-TW/analytics)：追蹤超越程式碼審查的 Claude Code 使用情況