結論先說
- 團隊用 Claude Code 審代碼分三條路:提 PR 前的成員本地預審、基於 API 的 GitHub Actions 工作流審查、以及面向 Team/Enterprise 組織的 官方託管 GitHub Code Review 服務。
- 分清
REVIEW.md和CLAUDE.md的管轄範圍:本地/code-review讀的是CLAUDE.md(不讀REVIEW.md);只有 GitHub 上的官方託管 Code Review 服務才會專門讀取倉庫根目錄的REVIEW.md。 - 官方託管 Code Review 採用多代理「查找→驗證→排序→回帖」四步流水線,自動過濾誤報並在具體代碼行下留行內評論,但絕不替人類點 Approve 或攔截合併。
- 沒有開 Team 組織版的小團隊,直接用官方 GitHub Action(
@claude或自動觸發)+ 倉庫共享.claude/agents/審查員,同樣能實現標準統一的 PR 審查。 - 全組統一審查口徑的第一條鐵律是「跳過純代碼風格挑刺」,只抓錯誤邏輯、越權漏洞和漏測邊界,否則每次 PR 都會被瑣碎意見淹沒。

圖:本站根據 Claude Code 官方文檔:Code Review 整理的示意圖
本文根據 Claude Code 官方文檔《Code Review》《Claude Code GitHub Actions》《Review locally with /code-review》與《Subagents》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。單人本地運行/code-review與/security-review的參數詳解請看 Claude Code 本地代碼審查命令指南,本文聚焦團隊協作與 PR 自動化落地。
適用於誰
- 搜「claude code 團隊如何進行代碼審查」,想讓組裏每個 GitHub PR 提交上來就自動過一遍邏輯與安全檢查的團隊負責人;
- 聽說過
REVIEW.md,但不清楚它和CLAUDE.md有什麼區別、為什麼在本機敲/code-review沒讀它的人; - 沒有開 Team 或 Enterprise 組織版,想知道小團隊怎麼靠 GitHub Actions 加共享子代理搭出同等審查流水線的人。
一、方案 A(Team / Enterprise 組織):官方託管 Code Review 與 REVIEW.md
如果你們公司使用的是 Claude Team 或 Claude Enterprise,組織所有者在後台關聯官方 Claude GitHub App 後,就能給指定倉庫開啟全託管的多代理 PR 審查(支持 Quick、Standard、Deep 不同深度檔位):
- 四步降噪機制:每次 PR 打開或推送新提交時,雲端會並行派出多個代理檢查 diff 與上下文(Find),再由獨立驗證步驟核對源碼剔除幻覺誤報(Verify),去重按嚴重度排序(Rank),最後往 PR 寫入總覽與行內評論,並掛上名為
Claude Code Review的檢查狀態(Post)。 - 用
REVIEW.md定製團隊專屬標尺:在倉庫根目錄新建REVIEW.md提交進 Git。託管服務會同時結合CLAUDE.md的架構背景與REVIEW.md的審查細則幹活。一份實用的團隊REVIEW.md骨架如下:
markdown
# Team PR Review Rules
## 重點必查項(高嚴重度)
- 多租戶接口必須校驗當前登入用戶的 `tenant_id`,防止水平越權
- 涉及訂單金額與庫存扣減的數據庫操作必須位於同一事務內
- 新增外部 HTTP 調用必須顯式設定超時時間
## 明確忽略項(不要評論)
- 跳過 `src/generated/**`、`*.lock` 與快照文件
- 不要對變量命名偏好、空行縮進等已被 ESLint/Prettier 覆蓋的純風格問題發表評論
注意官方列出的合規邊界:託管 Code Review 目前不兼容開啟了零數據保留(ZDR)、嚴格 HIPAA 或客戶自管加密密鑰(CMEK)的組織環境。
二、方案 B(中小團隊通用):GitHub Actions 自動審 + 倉庫共享審查子代理

圖:本站根據 Claude Code 官方文檔:Best practices 與《GitHub Actions》整理的示意圖
對於沒有采購企業託管版、成員各自用訂閱或團隊共用 API 密鑰的小組,把「本地門禁 + CI 門禁」兩步結合起來性價比最高:
1. 在倉庫 .claude/agents/ 放一份共享只讀審查員
把審查角色提交進倉庫(子代理編寫規範見 自定義 subagent 實例),例如 .claude/agents/pr-reviewer.md,在 frontmatter 限定只給 Read、Grep、Glob、Bash 等讀查工具而不給 Edit/Write。要求每位同事在 push 分支前先跑一次本地 /code-review(或加 --comment 直接把行內意見推上 GitHub PR),先把低級漏測消滅在本機。
2. 在倉庫配置官方 GitHub Actions 自動兜底
在 .github/workflows/ 裏接入官方 Action(完整 YAML 與控費寫法見 Claude Code GitHub Actions 配置教學 與 在 CI 裏跑無頭模式與自動審 PR):既可以設成每個 PR 打開時自動按統一提示詞審一遍,也可以在疑難 PR 評論區手動敲 @claude 重點檢查這段並發鎖邏輯 按需呼叫。
團隊成員在本地高頻運行 /code-review、/security-review 與修復驗證會持續消耗個人會話額度;需要開通或升級個人訂閱可查看本站 Claude Code 訂閱充值說明 或大額度的 Claude Max 充值說明。
常見問題
問:我在本地倉庫根目錄寫了 REVIEW.md,為什麼在終端跑 /code-review 根本沒按裏面寫的做?
答:這是官方文檔專門提醒過的易混點:終端裏的本地 /code-review 只遵守你的 CLAUDE.md,不會讀取 REVIEW.md。想讓一套審查關注點在本地和雲端同時生效,可以把核心紅線寫在 CLAUDE.md(或由 REVIEW.md 引用對齊)。
問:審查跑出一堆意見後,能讓組員直接無腦跑 /code-review --fix 一鍵全改掉嗎?
答:不建議直接全盤照改。官方最佳實踐提醒,審查代理難免混入邊際意見;正確流程是先提交手頭乾淨的 Git 記錄(因為後台審查的 --fix 修改超出普通會話檢查點,/rewind 可能撤不全),再讓作者甄別真缺陷逐個修復並跑通單測。
問:團隊其他共享配置(比如禁止讀 .env、統一提交鉤子)放在哪配合代碼審查最好?
答:統一放進倉庫 .claude/settings.json 提交共享,完整目錄分工見 Claude Code 團隊協作怎麼配。
相關教學
- Claude Code 本地代碼審查:/code-review 與 /security-review 詳解
- Claude Code GitHub Actions 配置教學:@claude 自動審 PR
- Claude Code 在 CI 裏跑:從 claude -p 到自動審 PR 控成本
- Claude Code 自定義 subagent 實例
- Claude Code 團隊協作怎麼配:共享 settings 與插件
參考資料
- Claude Code 官方文檔:Code Review — https://code.claude.com/docs/en/code-review
- Claude Code 官方文檔:Review locally with /code-review — https://code.claude.com/docs/en/code-review-local
- Claude Code 官方文檔:Claude Code GitHub Actions — https://code.claude.com/docs/en/github-actions
- Claude Code 官方文檔:Subagents — https://code.claude.com/docs/en/sub-agents
0 條評論
還沒有評論,來搶沙發~