Code Review（代码审查）

自动审查 GitHub PR，多 agent 分析全代码库并以行内评论给出问题。

是什么

Code Review 是 Anthropic 托管的自动化 PR 审查服务（research preview，仅 Team 与 Enterprise 订阅可用，开启 Zero Data Retention 的组织不可用）。它分析 GitHub pull request，并在发现问题的代码行上以行内评论的形式给出结论。一支由多个专门 agent 组成的队伍会在完整代码库的上下文中审查代码改动，查找逻辑错误、安全漏洞、被破坏的边界情况以及隐蔽的回归。

所有结论按严重程度打标签，既不批准也不阻塞 PR，因此不影响既有的审查流程。可通过在仓库中添加 CLAUDE.md 或 REVIEW.md 来调整 Claude 标记问题的方式。若想在自己的 CI 基础设施中运行，可改用 GitHub Actions 或 GitLab CI/CD。

怎么工作

管理员为组织开启 Code Review 并选择纳入的仓库后，审查会在 PR 打开时、每次推送时或手动请求时触发，取决于仓库配置的行为；在任意模式下评论 @claude review 都可发起审查。
审查运行时，多个 agent 在 Anthropic 基础设施上并行分析 diff 及周边代码，每个 agent 负责一类问题；随后有一个验证步骤将候选问题与真实代码行为核对以过滤误报。
结果经去重、按严重程度排序后，作为行内评论发布在具体出问题的代码行上，并在审查正文给出摘要；若未发现问题则更新 GitHub check run 显示无问题，Claude 也可能发一条简短确认评论。
每条结论标注严重程度：🔴 Important（合并前应修复的 bug）、🟡 Nit（值得修但不阻塞的小问题）、🟣 Pre-existing（代码库中已存在、非本 PR 引入的 bug）；每条结论含可展开的扩展推理说明。
每条评论自带 👍/👎 供一键评价；点赞/点踩仅在 PR 合并后被收集用于调优审查器，不会触发重新审查；回复行内评论不会让 Claude 响应或更新 PR，需修复代码并推送。
每次审查会写入名为 Claude Code Review 的 check run，其 Details 含按严重程度排序的全部结论汇总；Files changed 标签页中结论以注解形式直接标在 diff 行上。
check run 始终以 neutral 结论完成，从不阻塞合并；若想据此卡合并，可用 gh 和 jq 解析 Details 末行的机器可读注释读取各严重程度计数。
平均每次审查约 20 分钟完成，成本随 PR 规模与复杂度增长。

怎么配置 / 用法

本地审查 diff（无需安装 GitHub App），在任意 Claude Code 会话运行：

/code-review              # 审查当前 diff，报告正确性 bug 及复用/简化/效率清理项
/code-review --comment    # 将结论作为行内 PR 评论发布
/code-review --fix        # 审查后将结论应用到工作区
/code-review ultra --fix  # 在云端运行更深的 ultrareview 并应用结论

手动触发（顶层 PR 评论，命令需放在评论开头）：

@claude review        # 发起审查，并订阅后续每次 push 的审查
@claude review once    # 仅发起单次审查，不订阅未来 push

REVIEW.md 示例（仓库根目录，逐字注入每个 agent 系统提示，最高优先级）：

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
- Database queries are scoped to the caller's tenant

什么时候用

希望对 GitHub PR 自动检查逻辑错误、安全漏洞、边界情况与隐蔽回归，且不影响既有审查流程时。
高流量仓库中只想对特定（如 ready 的）PR 选择性开启审查时，用 Manual 模式 + @claude review。
想在推送前于本地终端检查 diff、无需安装 GitHub App 时，用 /code-review。
想对长跑且频繁推送的 PR 获取一次性第二意见而不订阅后续 push 时，用 @claude review once。

限制 / 坑

仅 Team 与 Enterprise 订阅可用，且处于 research preview；开启 Zero Data Retention 的组织不可用。
结论不批准也不阻塞 PR，check run 始终为 neutral 结论，不会阻挡合并。
审查为 best-effort：失败或超时的运行不会自动重试，GitHub Checks 的 Re-run 按钮也无法重触发，需用 @claude review once 或新推送。
回复行内评论不会触发 Claude 响应或更新 PR；要处理结论需修复代码并推送。
达到组织月度支出上限时审查会被跳过，下个计费周期或管理员提高上限后才恢复。

硬事实速查（12 条）

严重程度三级：🔴 Important、🟡 Nit、🟣 Pre-existing。
check run 名为 Claude Code Review，以 neutral 结论完成，不阻塞分支保护。
Details 末行机器可读注释可用 gh api ... --jq 解析，返回如 {"normal":2,"nit":1,"pre_existing":0}，normal 即 Important 计数。
CLAUDE.md：项目通用指令，新引入的违规作为 nit 级标记，按目录层级生效；REVIEW.md：仅审查用，逐字注入每个 agent 系统提示作最高优先级，@ import 语法不展开。
REVIEW.md 位于仓库根目录，可调 severity、nit volume、skip rules、repo-specific checks、verification bar、re-review convergence、summary shape。
本地命令 /code-review 在 v2.1.147 前名为 /simplify；自 v2.1.154 起 /simplify 改为仅做清理（不找 bug）；reuse/simplification/efficiency 清理项需 v2.1.151+。
设置入口：claude.ai/admin-settings/claude-code（开启与触发器）、claude.ai/analytics/code-review（用量）、claude.ai/admin-settings/usage（月度支出上限）。
Claude GitHub App 申请权限：Contents 读写、Issues 读写、Pull requests 读写。
三种 Review Behavior：Once after PR creation、After every push、Manual；@claude review 会订阅后续 push 审查，@claude review once 不订阅。
触发手动审查需 owner/member/collaborator 权限、PR 为 open、命令置于顶层 PR 评论开头；手动触发可在 draft PR 上运行。
计费按 token 用量，平均每次约 $15-25，通过 usage credits 单独计费，不计入套餐已含用量；费用始终出现在 Anthropic 账单，与是否用 Bedrock/Vertex 无关。
默认聚焦正确性（会导致生产故障的 bug），不查格式偏好或测试覆盖缺失。

官方出处：https://code.claude.com/docs/en/code-review

Code Review（代码审查） ​

是什么 ​

怎么工作 ​

怎么配置 / 用法 ​

什么时候用 ​

限制 / 坑 ​