Code Review：自动化 PR 代码审查

Code Review 功能目前是研究预览版，仅面向 Team 和 Enterprise 订阅。启用了零数据保留的组织不支持此功能。

Code Review 分析你的 GitHub Pull Request，以内联注释形式把发现的问题精确标注在对应代码行上。一组专业化 Agent 会在整个代码库上下文中检查代码变更，寻找逻辑错误、安全漏洞、边界情况和潜在回归问题。

审查发现会按严重程度标注，不会自动批准或阻止 PR，不影响现有的 review 流程。

如果要在自己的 CI 基础设施上运行 Claude，参见 GitHub Actions 或 GitLab CI/CD。

工作原理

触发方式（管理员配置）：

PR 创建时自动触发
每次 push 时触发
手动触发（评论 @claude review）

审查流程：

多个 Agent 在 Anthropic 基础设施上并行分析 diff 和周围代码
每个 Agent 负责一类问题（逻辑错误、安全、边界情况等）
验证步骤过滤误报
结果去重、按严重程度排序，以内联注释形式发布

没有发现问题时，Claude 会在 PR 上发短确认注释。平均完成时间 20 分钟，随 PR 大小和复杂度扩展。

严重程度标注

标记	严重程度	含义
🔴	Normal	合并前应修复的 bug
🟡	Nit	小问题，值得修复但不阻塞
🟣	Pre-existing	代码库中已存在的 bug，非本次 PR 引入

每个发现都有可折叠的扩展推理区，点开可以看到 Claude 为什么标记这个问题以及如何验证的。

默认审查焦点：正确性问题（会影响生产的 bug），不包括格式偏好或测试覆盖率。可以通过自定义规则文件扩展。

设置 Code Review

管理员一次性为组织设置，选择需要包含的仓库。

第一步：打开管理员设置

进入 claude.ai/admin-settings/claude-code，找到 Code Review 区域。需要有 Claude 组织管理员权限和 GitHub 组织的 GitHub App 安装权限。

第二步：安装 Claude GitHub App

点击 Setup，按提示在 GitHub 组织中安装 Claude GitHub App。App 需要的仓库权限：

Contents：读写
Issues：读写
Pull requests：读写

第三步：选择仓库

选择要启用 Code Review 的仓库。可以随时添加更多仓库。

第四步：为每个仓库设置触发方式

触发模式	说明	成本
PR 创建后一次	PR 开启或标记为 Ready 时运行一次	低
每次 push 后	每次推送都运行，自动解决已修复的问题	高
手动	只在有人评论 `@claude review` 后运行	可控

高流量仓库推荐用手动模式，只对需要的 PR 发起审查。

验证设置：开一个测试 PR。自动模式下，几分钟内会出现名为 Claude Code Review 的 check run；手动模式下，评论 @claude review 触发。

手动触发审查

在任何 PR 上评论 @claude review（必须是顶级评论，不能是 diff 内联注释）可以立即触发审查，并让该 PR 从此接受 push 触发。

触发条件：

评论以 @claude review 开头
你有仓库的 owner、member 或 collaborator 权限
PR 是 open 且非草稿状态

自定义审查规则

Code Review 读取仓库中两个文件来指导审查内容：

CLAUDE.md

Code Review 会读取仓库的 CLAUDE.md 文件，并把新引入的违规标注为 nit 级别发现。如果 PR 修改了代码使得某条 CLAUDE.md 规则过时，Claude 也会提醒更新文档。

CLAUDE.md 按目录层级读取，子目录中的规则只对该路径下的文件生效。参见记忆文档了解更多。

REVIEW.md

在仓库根目录创建 REVIEW.md，专门用于 code review 规则（不影响普通 Claude Code 会话）。

可以用来定义：

公司/团队风格指南
语言/框架约定（linter 未覆盖的）
必须标记的内容
应该跳过的内容

示例：

markdown

# Code Review Guidelines

## Always check
- New API endpoints have corresponding integration tests
- Database migrations are backward-compatible
- Error messages don't leak internal details to users

## Style
- Prefer `match` statements over chained `isinstance` checks
- Use structured logging, not f-string interpolation in log calls

## Skip
- Generated files under `src/gen/`
- Formatting-only changes in `*.lock` files

Claude 自动发现仓库根目录的 REVIEW.md，无需任何额外配置。

查看使用量

进入 claude.ai/analytics/code-review 查看组织的 Code Review 活动：

区域	显示内容
PRs reviewed	所选时间范围内每日审查的 PR 数
Cost weekly	Code Review 每周费用
Feedback	开发者修复后被自动解决的审查评论数
Repository breakdown	每个仓库的审查 PR 数和已解决评论数

定价

按 token 用量计费。每次审查平均 $15-25，随 PR 大小、代码库复杂度扩展。

Code Review 用量通过 Extra Usage 单独计费，不占用套餐内包含的用量。

触发方式对成本的影响：

每次 push 后触发 = 每个 push 一次费用
手动触发后会自动接受后续 push 触发

在 claude.ai/admin-settings/usage 可以为 Code Review 设置月度消费上限。

Code Review：自动化 PR 代码审查 ​

工作原理 ​

严重程度标注 ​

设置 Code Review ​

手动触发审查 ​

自定义审查规则 ​

CLAUDE.md ​

REVIEW.md ​

查看使用量 ​

定价 ​

相关文档 ​