团队怎么用 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 条评论

登录 后参与评论

还没有评论,来抢沙发~