為 Claude Code 設定程式碼審查

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

本文涵蓋如何啟用程式碼審查、設定審查觸發器、自訂標記內容，以及排除常見設定問題。

注意：程式碼審查處於研究預覽階段，可在 Team 和 Enterprise 方案上使用。啟用零資料保留的組織無法使用。程式碼審查使用量會單獨計費，透過額外使用量計費，不計入您方案的包含使用量。

程式碼審查的運作方式

組織啟用程式碼審查後，可在 pull request 開啟時、每次推送時或僅在有人手動要求審查時自動觸發。審查執行時，多個代理會並行分析差異和周圍程式碼。每個代理尋找不同類別的問題，然後驗證步驟會根據實際程式碼行為檢查結果，以篩選出誤判。

發現結果會去重、按嚴重程度排名，並作為內嵌評論發佈在發現問題的特定行上。如果未發現問題，Claude 會在 PR 上發佈簡短的確認評論。審查不會批准或阻止您的 PR，因此現有的審查工作流程保持不變。

審查成本隨 PR 大小和複雜性而增加，平均完成時間為 20 分鐘。

嚴重程度等級

每項發現都標記有嚴重程度等級：

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

發現結果包括可摺疊的擴展推理部分，您可以展開以查看 Claude 為何標記問題以及如何驗證問題。

程式碼審查檢查的內容

預設情況下，程式碼審查著重於正確性：會破壞生產的錯誤，而不是格式設定偏好或缺少的測試涵蓋範圍。您可以透過將指導檔案新增到您的儲存庫來擴展其檢查內容。

設定程式碼審查

Team 和 Enterprise 方案的擁有者和主要擁有者可以為組織啟用程式碼審查一次，並選擇要包含的儲存庫。除了在 Claude 組織內擁有擁有者角色外，您還需要在 GitHub 組織中安裝 GitHub App 的權限。

前往 組織設定 > Claude Code 並找到 程式碼審查 部分。
按一下「設定」以開始 GitHub App 安裝流程。
按照提示將 Claude GitHub App 安裝到您的 GitHub 組織。該應用程式要求內容、問題和 pull request 的讀取和寫入權限。
選擇要為程式碼審查啟用的儲存庫。如果您看不到儲存庫，請確認您在安裝期間授予 Claude GitHub App 存取權限。
使用 審查行為 下拉式選單為每個儲存庫設定審查觸發器（請參閱下一部分以了解每個選項的詳細資訊）。

若要驗證設定，請開啟測試 PR。如果您選擇了自動觸發器，名為 Claude Code Review 的檢查執行應在幾分鐘內出現。如果您選擇了「手動」，請在 PR 上評論「@claude review」以開始第一次審查。

選擇審查觸發器

設定後，程式碼審查 部分會在表格中顯示您的儲存庫。對於每個儲存庫，選擇何時執行審查：

PR 建立後一次：當 PR 開啟或標記為準備好審查時，審查執行一次。
每次推送後：審查在每次推送到 PR 分支時執行，在 PR 演變時捕捉新問題。Claude 會在您修復先前標記的問題時自動解決執行緒。這會執行最多的審查並花費最多。
手動：審查僅在有人在 PR 上評論「@claude review」時開始。適用於高流量儲存庫，您可以在其中選擇要審查的 PR。

儲存庫表格也會根據最近的活動顯示每個儲存庫的平均審查成本。

手動觸發審查

在 pull request 上評論「@claude review」以開始審查，並選擇該 PR 進行未來的推送觸發審查。無論儲存庫的設定觸發器如何，這都有效。

若要讓評論觸發審查：

將其發佈為頂級 PR 評論，而不是差異行上的內嵌評論。
在評論開始時放置「@claude review」。
您必須具有儲存庫的擁有者、成員或協作者存取權限。
PR 必須開啟且不是草稿。

如果審查已在執行，請求會排隊等待進行中的審查完成。

自訂審查

程式碼審查會讀取儲存庫中的兩個檔案來指導其標記的內容。兩者都是在預設正確性檢查之上的附加項目。

CLAUDE.md

程式碼審查會讀取您儲存庫的 CLAUDE.md 檔案，並將新引入的違規視為小問題級別的發現。如果您的 PR 以使 CLAUDE.md 陳述過時的方式變更程式碼，Claude 會標記文件也需要更新。

Claude 會在目錄階層的每個層級讀取 CLAUDE.md 檔案，因此子目錄的 CLAUDE.md 中的規則僅適用於該路徑下的檔案。

REVIEW.md

將 REVIEW.md 檔案新增到您的儲存庫根目錄以取得審查特定規則。使用它來編碼：

公司或團隊風格指南
語言或框架特定的慣例，不受 linter 涵蓋
Claude 應始終標記的事項（例如，「任何新 API 路由必須有整合測試」）
Claude 應跳過的事項（例如，「不要評論生成的程式碼」）

Claude 會自動發現儲存庫根目錄中的 REVIEW.md。不需要設定。

定價和使用量

程式碼審查根據權杖使用量計費。每次審查的平均成本為 $15–25，隨著 PR 大小、程式碼庫複雜性以及需要驗證的問題數量而增加。

程式碼審查使用量會單獨計費，透過額外使用量計費，不計入您方案的包含使用量。您選擇的審查觸發器會影響總成本：

PR 建立後一次每個 PR 執行一次。
每次推送後在每次推送時執行，將成本乘以推送次數。
手動在有人評論「@claude review」之前不會產生成本。在該評論之後，對 PR 的其他推送會自動觸發審查。

無論您的組織是否為其他 Claude Code 功能使用 AWS Bedrock 或 Google Vertex AI，成本都會出現在您的 Anthropic 帳單上。

若要設定每月支出上限，請前往 組織設定 > 使用量 並為 Claude Code Review 服務設定限制。

透過分析儀表板中的每週成本圖表或管理設定中的每個儲存庫平均成本欄來監控支出。

檢視使用量

前往 程式碼審查分析儀表板 以查看整個組織的活動。儀表板顯示：

已審查的 PR：在選定時間範圍內每日審查的 pull request 計數。
每週成本：程式碼審查的每週支出。
回饋：因有人解決問題而自動解決的審查評論計數。
儲存庫細目：每個儲存庫已審查的 PR 計數和已解決的評論。

疑難排解

安裝 GitHub App 後儲存庫未出現

如果您已安裝 Claude GitHub App，但您的儲存庫未出現在管理面板中：

確認 Claude GitHub App 可以存取您期望的儲存庫。前往您的 GitHub 組織設定，在 已安裝的 GitHub App 下找到 Claude GitHub App，並檢查它是否可以存取所有儲存庫或僅選定的儲存庫。
如果您的組織使用具有企業受管使用者 (EMU) 的 GitHub Enterprise Cloud，請確保 Claude GitHub OAuth App 在企業層級獲得授權。EMU 企業可以限制批准的 OAuth 應用程式，Claude 應用程式必須明確允許。
嘗試斷開並重新連接 GitHub 整合。前往 組織設定 > Claude Code，移除儲存庫設定，然後再次執行設定。
如果問題仍然存在，請 聯絡我們的支援團隊，提供您的組織名稱和 GitHub 組織名稱，以便我們進行調查。

程式碼審查不會在新 PR 上開始

如果在開啟 PR 後未出現檢查執行：

確認儲存庫已列出並在您的管理設定中啟用。
檢查審查觸發器設定。如果設定為「手動」，您需要在 PR 上評論「@claude review」以開始審查。
確保 PR 不是草稿。程式碼審查不會在草稿 PR 上執行。
驗證 Claude GitHub App 在您的 GitHub 組織設定中仍然可以存取儲存庫。

具有 IP 限制的 GitHub Enterprise Cloud

如果您的 GitHub Enterprise Cloud 組織按 IP 位址限制存取，Claude GitHub App 可能無法存取您的儲存庫。若要修復此問題，請在您的 GitHub 企業設定中 啟用已安裝 GitHub App 的 IP 允許清單繼承。Claude GitHub App 會註冊其 IP 範圍，因此啟用此設定可允許存取而無需手動設定。若要 改為手動將範圍新增到您的允許清單，或設定其他防火牆，請參閱 Anthropic API IP 位址。

GitHub Enterprise Server（自託管）

程式碼審查目前需要託管在 github.com 上的儲存庫，因此尚不支援自託管 GitHub Enterprise Server。

常見問題

建立自訂角色時，程式碼審查是否可用作功能？

否，程式碼審查目前無法新增到 自訂角色。