外观
代码审查工作流
可用性:研究预览阶段——仅限 Teams 和 Enterprise 计划。Free/Pro 账户不可用,启用了零数据保留(ZDR)的组织也不可用。发布时间:2026 年 3 月 9 日
Claude Code 的代码审查功能对每个 GitHub pull request 运行多智能体审查。一组专业智能体在完整代码库的上下文中检查 diff,每个智能体针对不同类别的问题(逻辑错误、安全漏洞、边缘情况、回退),然后经过验证步骤过滤误报。
发现的问题以内联 PR 评论的形式发布在具体的问题行上,并按严重程度标记。审查不批准或阻止 PR,因此现有的审查工作流保持不变。
工作原理
- 触发器触发(PR 创建、推送或手动
@claude review评论) - 多个智能体在 Anthropic 基础设施上并行分析 diff 和周围代码
- 每个智能体针对不同类别的问题
- 验证步骤对照实际代码行为检查候选问题,以去除误报
- 结果去重、按严重程度排序,并作为内联 PR 评论发布
- 如果未发现任何问题,Claude 发布一条简短的确认评论
审查平均在 20 分钟内完成,随 PR 大小和复杂度扩展。
严重程度级别
| 标记 | 严重程度 | 含义 |
|---|---|---|
| 🔴 | 普通 | 合并前应修复的 bug |
| 🟡 | 小问题 | 次要问题,值得修复但不阻塞 |
| 🟣 | 预先存在 | 代码库中的 bug,非本 PR 引入 |
每个发现都包含一个可折叠的扩展推理部分,解释 Claude 为何标记该问题以及如何验证该问题。
配置
管理员为组织一次性启用代码审查,并选择要包含哪些仓库。
1. 打开管理员设置
前往 claude.ai/admin-settings/claude-code,找到代码审查部分。需要对你的 Claude 组织的管理员访问权限,以及在你的 GitHub 组织中安装 GitHub App 的权限。
2. 点击配置
这将开始 GitHub App 安装流程。
3. 安装 Claude GitHub App
按照提示在你的 GitHub 组织上安装 Claude GitHub App。该 App 请求以下权限:
- 内容:读取和写入
- Issues:读取和写入
- Pull requests:读取和写入
代码审查使用对内容的读取权限和对 pull requests 的写入权限。如果你以后启用该功能,此权限集也支持 「GitHub Actions」。
4. 选择仓库
选择要启用的仓库。如果缺少某个仓库,请确保你在安装时授予了 GitHub App 访问权限。之后可以在管理员设置表格中添加更多仓库。
5. 为每个仓库设置审查触发器
对于每个仓库,选择何时运行审查:
| 触发器 | 运行时机 | 成本概况 |
|---|---|---|
| PR 创建后一次 | PR 创建或标记为就绪时运行一次 | 最低 |
| 每次推送后 | 每次推送到 PR 分支时 | 最高(按推送次数倍增) |
| 手动 | 仅当有人评论 @claude review 时 | 可控 |
@claude review 评论后,无论配置的触发器如何,后续对该 PR 的推送都会自动触发审查。
手动模式适用于高流量仓库,你希望将特定 PR 纳入审查,或仅在 PR 准备好审查时才开始审查。
手动触发
在任何开放的、非草稿的 PR 上评论 @claude review 即可立即开始审查。要求:
- 顶级 PR 评论(非内联 diff 评论)
@claude review在评论开头- 仓库的 Owner、Member 或 Collaborator 访问权限
如果审查正在进行中,请求会排队等待,直到进行中的审查完成。
配置审查
两个文件控制 Claude 标记的内容。两者都是在默认正确性检查之上的叠加。
CLAUDE.md
Claude 读取你目录层级中的所有 CLAUDE.md 文件。新引入的违规将被标记为小问题级别的发现。双向的:如果 PR 使 CLAUDE.md 中的某条声明过时,Claude 也会标记该文档需要更新。
CLAUDE.md 适用于同样适用于交互式 Claude Code 会话的指导方针。
REVIEW.md
将 REVIEW.md 添加到你的仓库根目录以设置仅用于审查的规则。自动发现,无需额外配置。
Markdown
# 代码审查指南
## 始终检查
- 新 API 端点有对应的集成测试
- 数据库迁移向后兼容
- 错误消息不向用户泄露内部详情
## 风格
- 优先使用提前返回而非嵌套条件
- 使用结构化日志,而非日志调用中的 f-string 插值
## 跳过
- `src/gen/` 下的生成文件
- `*.lock` 文件中的仅格式化变更
- `db/migrations/` 中的迁移文件REVIEW.md 适用于会使 CLAUDE.md 在普通会话中显得杂乱的规则(代码检查约定、跳过列表、团队特定模式)。
定价
代码审查按 Token 使用量计费,独立于你计划包含的用量(通过额外用量)。
- 平均成本:每次审查 $15-25,随 PR 大小、代码库复杂度和需要验证的问题数量扩展
- 「每次推送后」按推送次数倍增成本
- 设置月度支出上限:claude.ai/admin-settings/usage → 为「Claude Code Review」服务配置限额
- 监控支出:claude.ai/analytics/code-review(每日 PR 数量、每周支出、按仓库分类)
交叉参考
手动代码审查工作流(CLI,无需 Teams/Enterprise):
- 多智能体代码审查工作流 — 通过 CLI 自建智能体团队
- 「GitHub Actions 集成」 — 自定义 CI/CD 自动化(此托管服务的自托管替代方案)
- GitLab CI/CD — GitLab 流水线的自托管 Claude 集成
- 代码审查插件 — 推送前的按需本地审查(在插件市场中提供)
已知限制(研究预览阶段)
- 仅限 Teams 和 Enterprise——Free/Pro 无法访问
- 启用了零数据保留(ZDR)的组织不可用
- 托管服务仅支持 GitHub(GitLab 通过 CI/CD 集成支持,但非此功能)
- 大型仓库首次激活时全仓库索引存在延迟
- Anthropic 内部数据:超过 1,000 行的 PR 平均发现约 7.5 个问题,误报率 <1%——系自报告数据,未经独立验证
来源:飞书 · AI Spark 知识库 | 原文(最新版):https://lcnniolukk80.feishu.cn/wiki/JXwNwtlUoiF0n4kXJtWcgfgDnDc | 归档:2026-06-04