Code Review：自动化 PR 代码审查

Claude Code Review 是 Anthropic 托管的 GitHub PR 审查服务，由多个专业化 Agent 并行分析代码变更，在代码行级别发布内联注释。支持 PR 创建、每次 push 或手动触发（@claude review）。通过仓库根目录的 REVIEW.md 自定义审查规则和严重程度。按 token 计费，每次审查平均 $15-25，独立于订阅用量额度。适合 Team/Enterprise 用户；如需在自有 CI 运行则参见 GitHub Actions 文档。

Code Review 功能面向 Team 和 Enterprise 订阅。如需在自己的 CI 基础设施运行，参见 GitHub Actions 或 GitLab CI/CD。

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

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

工作原理

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

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

审查流程：

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

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

严重程度标注

标记	严重程度	含义
🔴	Important	合并前应修复的 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 触发。

手动触发审查

两个评论命令可按需启动审查，无论仓库配置的触发方式是什么：

命令	说明
`@claude review`	启动审查并订阅该 PR 的后续 push 触发
`@claude review once`	启动一次性审查，不订阅后续 push

@claude review once 适合长期开发且频繁 push 的 PR，或只需一次额外审查而不想改变 PR 触发行为的场景。

触发条件：

评论以命令开头，为顶级 PR 评论（不能是 diff 内联注释）
你有仓库的 owner、member 或 collaborator 权限
PR 是 open 状态（手动触发支持草稿 PR）

Check Run 输出

每次审查会填充 Claude Code Review check run，出现在 CI 检查旁边。点击 Details 链接查看按严重程度排序的所有发现汇总。发现同时在 Files changed 标签页以 diff 行注释形式呈现。

check run 的机器可读结果（最后一行）可以用 gh 命令解析：

bash

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
# 返回：{"normal": 2, "nit": 1, "pre_existing": 0}
# normal 键表示 Important 级别的发现数

check run 结论始终为中立（neutral），不会通过分支保护规则阻止合并。

自定义审查规则

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

CLAUDE.md

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

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

REVIEW.md

在仓库根目录创建 REVIEW.md，专门用于 Code Review 规则（不影响普通 Claude Code 会话）。其内容作为最高优先级指令注入审查流水线的每个 Agent 系统提示中，优先于默认审查指导。

可以调整的内容：

严重程度定义：重新定义 🔴 Important 对你的仓库意味着什么
Nit 数量上限：如 "每次审查最多发布 5 条 Nit"，超出部分在摘要中统计数量
跳过规则：指定路径、分支模式或 CI 已覆盖的内容（如 lint、格式化）
仓库特定检查：每个 PR 都应检查的规则（如"新 API 路由必须有集成测试"）
验证门槛：要求特定类型发现需要引用 file:line 证据
复审收敛：重复审查时抑制新的 Nit，只报告 Important

示例：

markdown

# Review instructions

## What Important means here

Reserve Important for findings that would break behavior, leak data,
or block a rollback. Style, naming, and refactoring suggestions are Nit at most.

## Cap the nits

Report at most five Nits per review.

## Do not report

- Anything CI already enforces: lint, formatting, type errors
- Generated files under `src/gen/` and any `*.lock` file

## Always check

- New API routes have an integration test
- Log lines don't include email addresses or user IDs

REVIEW.md 是普通 Markdown 指令，@ import 语法不会展开。保持简洁——过长会稀释关键规则的优先级。

查看使用量

进入 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 设置月度消费上限。

故障排查

审查失败或超时

check run 显示 Code review encountered an error 或 Code review timed out 时，评论 @claude review once 重新触发。GitHub Checks 标签页的 Re-run 按钮对 Code Review 无效。

审查未运行（消费上限）

组织达到月度消费上限时，Code Review 会在 PR 上发说明评论跳过审查。可在 claude.ai/admin-settings/usage 提高上限或等待下个计费周期。

有发现但看不到内联注释

在以下位置查找：

check run Details：点击 Checks 标签中 Claude Code Review 旁的 Details 链接
Files changed 注释：在 PR Files changed 标签页查看 diff 行级注释
审查正文：push 期间运行的审查若遇到行已移动，发现会出现在审查正文的 Additional findings 段落

常见问题

Q: Claude Code Review 是什么？

这是 Anthropic 提供的托管 GitHub PR 审查服务，通过多个专业化 Agent 并行分析代码变更，在具体代码行发布内联注释。不同于手动触发的 Claude Code 会话，它是自动化的持续集成功能，面向 Team 和 Enterprise 用户。

Q: Code Review 的触发方式有哪些？

三种：PR 创建时一次、每次 push 后、仅手动触发（管理员配置）。任何 PR 上也可以评论 @claude review 立即触发一次，或用 @claude review once 仅触发一次而不订阅后续推送。

Q: 如何自定义 Claude Code Review 的审查规则？

在仓库根目录创建 REVIEW.md 文件，写入审查指令即可。该文件内容作为最高优先级注入审查 Agent，可以重定义严重程度、设置 Nit 数量上限、跳过特定路径，以及添加仓库特定的必检项目。

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

工作原理 ​

严重程度标注 ​

设置 Code Review ​

手动触发审查 ​

Check Run 输出 ​

自定义审查规则 ​

CLAUDE.md ​

REVIEW.md ​

查看使用量 ​

定价 ​

相关文档 ​

故障排查 ​

审查失败或超时 ​

审查未运行（消费上限） ​

有发现但看不到内联注释 ​

常见问题 ​