借助 Code Review,Claude 会审查您 GitHub 仓库中的 Pull Request。多个 Agent 会结合周围代码阅读每项更改,查找逻辑错误、安全漏洞或破损的边界情况等问题。验证步骤会在报告发现之前对照代码检查这些发现。

发现以内联评论的形式出现在相关代码行上,按严重程度排序,并在 Pull Request 上附带摘要和检查运行。审查永远不会批准或阻止 Pull Request,因此合并的决定权仍在您的团队手中。

审查分为四个阶段的示意图。GitHub 上的 Pull Request 被交给多个 Agent,它们在 Anthropic 基础设施上并行搜索。验证步骤剔除误报,剩余的发现经过去重并按严重程度排序,然后审查将内联评论、摘要和检查运行发布回 GitHub。

注意

Code Review 使用 AI 审查代码,可能会遗漏错误、安全漏洞或其他问题。没有发现的审查并不意味着您的代码没有错误或是安全的。

要启用 Code Review,需由您 Claude 组织的 Owner 按照设置 Code Review进行操作。Claude 也可以在不使用此服务的情况下审查代码。在任何套餐上,都可以在 Claude Code 会话中运行 /code-review,或比较所有选项。

可用性

在设置 Code Review 之前,请确认您的组织符合条件:

  • 套餐:Team 和 Enterprise
  • 代码托管平台:托管在 GitHub 上的仓库,包括 GitHub Enterprise Server 和启用数据驻留的 GitHub Enterprise Cloud。对于数据驻留,请让 Owner 按照 GitHub Enterprise Server 管理员设置操作,并输入您企业的 ghe.com 主机名。
  • 数据保留:对于启用了 Zero Data Retention 或应用了 HIPAA 配置的组织,Code Review 不可用,且不在 Anthropic 的业务伙伴协议(BAA)涵盖范围内。
  • 加密密钥:对于使用客户管理加密密钥(CMEK)的组织,Code Review 暂不可用。
  • 云提供商:即使您的开发人员通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用 Claude Code,您也需要一个使用上述套餐之一的 Claude 组织

设置和使用 Code Review

根据您需要完成的操作选择相应页面:

[card] 设置 Code Review

检查要求、安装 Claude GitHub App,并选择仓库、审查级别以及审查的运行时机

[card] 自定义 Code Review

通过仓库中的 REVIEW.md 和 CLAUDE.md 文件调整标记的内容

[card] 在 Pull Request 上阅读和请求审查

阅读发现及其严重程度,并通过评论请求再次审查

[card] Code Review 故障排除

修复未启动、失败或因预算而被跳过的审查

[card] Code Review 成本和使用情况

了解审查的计费方式、估算支出、设置每月支出上限并跟踪审查活动

审查工作原理

默认情况下,Code Review 专注于正确性:会破坏生产的错误,而不是格式偏好或缺失的测试覆盖。要更改其标记的内容,请向仓库添加指导文件。

审查在 Anthropic 基础设施上分四个阶段运行:

  1. 查找:多个 Agent 并行检查 diff 和周围代码。
  2. 验证:验证步骤对照代码检查候选发现,并过滤掉误报。
  3. 排序:剩余的发现经过去重并按严重程度排序。
  4. 发布:审查将其结果发布到 Pull Request 上。

每次审查都会在 Pull Request 上留下以下内容:

  • 发现:相关代码行上的内联评论,并在审查正文中附带摘要
  • 检查运行:名为 Claude Code Review,其详细信息中列出了各项发现。检查运行不会以失败结束。
  • 代替发现的说明:当检查运行的标题显示 Code review found no issues 时发布

Code Review 会选择运行审查所用的 Claude 模型,其管理设置中不提供模型选择。要让审查更深入或更轻量,请更改审查级别。

Owner 启用 Code Review 后,每个仓库都有一个设置,用于指定审查的运行时机:在 Pull Request 打开时运行一次、每次推送后运行,或仅在请求时运行。无论选择哪一项,对仓库具有写入权限的人员都可以在 Pull Request 上评论 @claude review 来启动审查。

审查级别

审查级别决定每次审查的深入程度,审查越深入,成本越高:

  • Quick:较轻量的检查。速度最快,成本最低。
  • Standard:在深度、速度和成本之间取得平衡。默认级别。
  • Deep:最深入的检查。耗时最长,成本最高。

Owner 可以为组织选择一个级别,也可以为单个仓库指定其自己的级别,例如为常规代码库使用 Quick,为关键代码库使用 Deep。有关影响每次审查成本的其他因素,请参阅 Code Review 成本和使用情况。

审查可以访问的内容

审查通过 Owner 在设置期间安装的 Claude GitHub App 访问您的仓库:

  • 运行位置:在 Anthropic 基础设施上的托管环境中运行。审查不会在自托管环境中运行。
  • 读取和写入的内容:在审查过程中,对仓库的访问是只读的,审查不会推送提交。在 Pull Request 上,它会发布评论和检查运行,解决自己之前的评论线程,并可以用 👀 回应评论命令。该应用本身拥有由其他 Claude 功能共享的更广泛的权限集。
  • 检查代码的方式:审查通过阅读 diff 和周围代码进行,不会构建或运行您的代码。

谁可以控制审查

比较获取审查的方式

要找出您可以使用的选项,请根据您的套餐和代码托管平台查看 谁可以使用 一列:

选项 启动审查的方式 运行位置 谁可以使用
Code Review 按各仓库设置的 Pull Request 活动,或 @claude review 评论 Anthropic 基础设施 拥有 GitHub 仓库、使用 Team 或 Enterprise 套餐的组织,在 Owner 启用后即可使用
/code-review 您在自己的分支上运行该命令 您的 Claude Code 会话 任何人,任何套餐
Ultrareview 您从 Claude Code 启动 云沙箱 需要使用 claude.ai 账户登录。有关不可用的情况,请参阅 Ultrareview
在您自己的 CI 中运行 Claude,使用 GitHub Actions 或 GitLab CI/CD 您的流水线事件,例如每个 Pull Request 或 merge request 您自己的 CI 运行器 在 GitHub 或 GitLab 上拥有 Claude API 密钥或云提供商凭据的任何人
您自己的审查器,作为子代理或 skill 您或 Claude 在会话中调用它 您运行 Claude Code 的任何位置 任何编写了审查器的人

相关资源