是什么
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 的组织
关联
- github-actions — 在自己的 CI 基础设施中运行 Claude
- gitlab-ci-cd — GitLab 的类似集成
- github-enterprise-server — 自托管 GitHub 实例的 Code Review
实践要点
- Check Run 结论始终为 neutral,不会阻塞合并,需自行解析 JSON 实现质量门控
REVIEW.md内容直接注入 prompt,不支持@导入语法- 重新触发失败的审查:评论
@claude review once(不要用 GitHub 的 Re-run 按钮) - 内联评论未显示时,检查 Check Run Details 和 Files changed 标注
- 每次 push 触发模式成本最高,高频 push 的仓库建议用 Manual 模式