是什么

Code Review 是 Claude Code 的托管 PR 审查服务(Research Preview),通过多个专用 Agent 并行分析 PR 变更,在完整代码库上下文中查找逻辑错误、安全漏洞和潜在回归,以内联评论形式标注到具体代码行。适用于 Team 和 Enterprise 订阅。

核心机制

多 Agent 并行分析:多个 Agent 各自关注不同类型问题(安全、性能、逻辑等),独立验证候选发现后去重排序,平均 20 分钟完成。

严重程度分级:

  • 🔴 Important:应在合并前修复的 Bug
  • 🟡 Nit:轻微问题,不阻塞合并
  • 🟣 Pre-existing:已存在于代码库但非本 PR 引入的 Bug

触发方式:

  • 每次 PR 创建后自动触发
  • 每次 push 后自动触发
  • 手动:@claude review(订阅后续 push)或 @claude review once(单次)

自定义审查规则:

  • CLAUDE.md:通用项目规范,违规作为 Nit 级别报告
  • REVIEW.md:审查专用指令,注入为最高优先级,可重定义严重程度、限制 Nit 数量、跳过特定路径、添加仓库特定检查

Check Run 输出:机器可读的严重程度统计,可供 CI 解析实现质量门控:

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

关键细节

  • 管理员设置入口:claude.ai/admin-settings/claude-code
  • 用量分析:claude.ai/analytics/code-review
  • 平均费用:每次审查 $15-25,按 token 用量计费
  • 不计入计划包含用量,通过 extra usage 单独计费
  • 不适用于启用了 Zero Data Retention 的组织

关联

实践要点

  • Check Run 结论始终为 neutral,不会阻塞合并,需自行解析 JSON 实现质量门控
  • REVIEW.md 内容直接注入 prompt,不支持 @ 导入语法
  • 重新触发失败的审查:评论 @claude review once(不要用 GitHub 的 Re-run 按钮)
  • 内联评论未显示时,检查 Check Run Details 和 Files changed 标注
  • 每次 push 触发模式成本最高,高频 push 的仓库建议用 Manual 模式