團隊怎麼用 Claude Code 做代碼審查:託管 PR 審查、REVIEW.md 與共享子代理

搜「claude code 團隊如何進行代碼審查」?區別於單人本地 /code-review,本文按官方文檔整理團隊三層審查落地法:Team/Enterprise 託管 GitHub PR 審查與 REVIEW.md 寫法、GitHub Actions 替代方案、以及倉庫共享只讀審查子代理。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Team / 企業 帳號

結論先說

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

團隊使用 Claude Code 審代碼三種方式

圖:本站根據 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 自動審 + 倉庫共享審查子代理

搭建團隊 PR 自動加本地雙層審查流程

圖:本站根據 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 — 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

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~