跳到正文

代码审查工作流

可用性:研究预览阶段——仅限 Teams 和 Enterprise 计划。Free/Pro 账户不可用,启用了零数据保留(ZDR)的组织也不可用。发布时间:2026 年 3 月 9 日

Claude Code 的代码审查功能对每个 GitHub pull request 运行多智能体审查。一组专业智能体在完整代码库的上下文中检查 diff,每个智能体针对不同类别的问题(逻辑错误、安全漏洞、边缘情况、回退),然后经过验证步骤过滤误报。

发现的问题以内联 PR 评论的形式发布在具体的问题行上,并按严重程度标记。审查不批准或阻止 PR,因此现有的审查工作流保持不变。


工作原理

  1. 触发器触发(PR 创建、推送或手动 @claude review 评论)
  2. 多个智能体在 Anthropic 基础设施上并行分析 diff 和周围代码
  3. 每个智能体针对不同类别的问题
  4. 验证步骤对照实际代码行为检查候选问题,以去除误报
  5. 结果去重、按严重程度排序,并作为内联 PR 评论发布
  6. 如果未发现任何问题,Claude 发布一条简短的确认评论

审查平均在 20 分钟内完成,随 PR 大小和复杂度扩展。

严重程度级别

标记严重程度含义
🔴普通合并前应修复的 bug
🟡小问题次要问题,值得修复但不阻塞
🟣预先存在代码库中的 bug,非本 PR 引入

每个发现都包含一个可折叠的扩展推理部分,解释 Claude 为何标记该问题以及如何验证该问题。


配置

管理员为组织一次性启用代码审查,并选择要包含哪些仓库。

1. 打开管理员设置

前往 claude.ai/admin-settings/claude-code,找到代码审查部分。需要对你的 Claude 组织的管理员访问权限,以及在你的 GitHub 组织中安装 GitHub App 的权限。

2. 点击配置

这将开始 GitHub App 安装流程。

3. 安装 Claude GitHub App

按照提示在你的 GitHub 组织上安装 Claude GitHub App。该 App 请求以下权限:

  • 内容:读取和写入
  • Issues:读取和写入
  • Pull requests:读取和写入

代码审查使用对内容的读取权限和对 pull requests 的写入权限。如果你以后启用该功能,此权限集也支持 「GitHub Actions」。

4. 选择仓库

选择要启用的仓库。如果缺少某个仓库,请确保你在安装时授予了 GitHub App 访问权限。之后可以在管理员设置表格中添加更多仓库。

5. 为每个仓库设置审查触发器

对于每个仓库,选择何时运行审查:

触发器运行时机成本概况
PR 创建后一次PR 创建或标记为就绪时运行一次最低
每次推送后每次推送到 PR 分支时最高(按推送次数倍增)
手动仅当有人评论 @claude review可控

@claude review 评论后,无论配置的触发器如何,后续对该 PR 的推送都会自动触发审查。

手动模式适用于高流量仓库,你希望将特定 PR 纳入审查,或仅在 PR 准备好审查时才开始审查。


手动触发

在任何开放的、非草稿的 PR 上评论 @claude review 即可立即开始审查。要求:

  • 顶级 PR 评论(非内联 diff 评论)
  • @claude review 在评论开头
  • 仓库的 Owner、Member 或 Collaborator 访问权限

如果审查正在进行中,请求会排队等待,直到进行中的审查完成。


配置审查

两个文件控制 Claude 标记的内容。两者都是在默认正确性检查之上的叠加。

CLAUDE.md

Claude 读取你目录层级中的所有 CLAUDE.md 文件。新引入的违规将被标记为小问题级别的发现。双向的:如果 PR 使 CLAUDE.md 中的某条声明过时,Claude 也会标记该文档需要更新。

CLAUDE.md 适用于同样适用于交互式 Claude Code 会话的指导方针。

REVIEW.md

REVIEW.md 添加到你的仓库根目录以设置仅用于审查的规则。自动发现,无需额外配置。

Markdown
# 代码审查指南

## 始终检查
- 新 API 端点有对应的集成测试
- 数据库迁移向后兼容
- 错误消息不向用户泄露内部详情

## 风格
- 优先使用提前返回而非嵌套条件
- 使用结构化日志,而非日志调用中的 f-string 插值

## 跳过
- `src/gen/` 下的生成文件
- `*.lock` 文件中的仅格式化变更
- `db/migrations/` 中的迁移文件

REVIEW.md 适用于会使 CLAUDE.md 在普通会话中显得杂乱的规则(代码检查约定、跳过列表、团队特定模式)。


定价

代码审查按 Token 使用量计费,独立于你计划包含的用量(通过额外用量)。

  • 平均成本:每次审查 $15-25,随 PR 大小、代码库复杂度和需要验证的问题数量扩展
  • 「每次推送后」按推送次数倍增成本
  • 设置月度支出上限:claude.ai/admin-settings/usage → 为「Claude Code Review」服务配置限额
  • 监控支出:claude.ai/analytics/code-review(每日 PR 数量、每周支出、按仓库分类)

交叉参考

手动代码审查工作流(CLI,无需 Teams/Enterprise):

  • 多智能体代码审查工作流 — 通过 CLI 自建智能体团队
  • 「GitHub Actions 集成」 — 自定义 CI/CD 自动化(此托管服务的自托管替代方案)
  • GitLab CI/CD — GitLab 流水线的自托管 Claude 集成
  • 代码审查插件 — 推送前的按需本地审查(在插件市场中提供)

已知限制(研究预览阶段)

  • 仅限 Teams 和 Enterprise——Free/Pro 无法访问
  • 启用了零数据保留(ZDR)的组织不可用
  • 托管服务仅支持 GitHub(GitLab 通过 CI/CD 集成支持,但非此功能)
  • 大型仓库首次激活时全仓库索引存在延迟
  • Anthropic 内部数据:超过 1,000 行的 PR 平均发现约 7.5 个问题,误报率 <1%——系自报告数据,未经独立验证

来源:飞书 · AI Spark 知识库 | 原文(最新版):https://lcnniolukk80.feishu.cn/wiki/JXwNwtlUoiF0n4kXJtWcgfgDnDc | 归档:2026-06-04