為 Claude Code 設定程式碼審查

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

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

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

程式碼審查的運作方式

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

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

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

嚴重程度等級

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

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

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

程式碼審查檢查的內容

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

設定程式碼審查

下面的步驟涵蓋 github.com 上儲存庫的設定。如果您的儲存庫位於自託管的 GitHub Enterprise Server (GHES) 執行個體上，請參閱 Claude Code 與 GitHub Enterprise Server 以取得完整的設定指南。

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 必須開啟且不是草稿。

如果審查已在執行，要求會排隊直到進行中的審查完成。

自訂審查

Code Review 從您的儲存庫讀取兩個檔案來指導其標記內容。兩者都是在預設正確性檢查之上的附加項目。

CLAUDE.md

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

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

REVIEW.md

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

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

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

定價和使用情況

Code Review 根據代幣使用情況計費。每次審查平均成本為 $15–25，根據 PR 大小、程式碼庫複雜性和需要驗證的問題數量而變化。

Code Review 使用情況通過使用額度單獨計費，不計入您計畫的包含使用情況。您選擇的審查觸發器會影響總成本：

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

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

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

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

檢視使用情況

前往 Code Review 分析儀表板查看您組織的活動。儀表板顯示：

已審查的 PR：在選定時間範圍內審查的拉取請求的每日計數。
每週成本：Code Review 的每週支出。
回饋：因有人解決問題而自動解決的審查評論計數。
儲存庫細目：每個儲存庫已審查的 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 組織名稱，以便我們進行調查。

Code Review 不會在新 PR 上啟動

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

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

GitHub Enterprise Cloud 與 IP 限制

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

GitHub Enterprise Server（自託管）

自託管 GitHub Enterprise Server (GHES) 通過單獨的設定流程獲得支援。有關完整說明，請參閱 Claude Code 與 GitHub Enterprise Server。

常見 GHES 設定問題：

「公開不能是私人」設定期間出現錯誤：您的 GHES 主機名稱必須解析為可公開路由的 IP 位址。Code Review 通過網際網路到達您的伺服器，因此內部或私人網路位址無法運作。更新 DNS 或您的網路配置，使主機名稱解析為公開 IP，然後重試。
GitHub Enterprise Cloud 與資料駐留是不同的產品。資料駐留租戶（主機名稱符合 *.ghe.com）不受 Code Review 支援。僅支援自託管 GitHub Enterprise Server 和標準 github.com 儲存庫。

常見問題

建立自訂角色時，Code Review 是否可用作功能？

否，Code Review 目前無法新增至 自訂角色。