为 Claude Code 设置代码审查

代码审查分析您的 GitHub 拉取请求，并在发现问题的代码行上发布内联注释。一组专业的代理在完整代码库的上下文中检查代码更改，查找逻辑错误、安全漏洞、损坏的边界情况和回归问题。

本文介绍如何启用代码审查、配置审查触发器、自定义标记内容以及排查常见设置问题。

注意：代码审查处于研究预览阶段，仅在 Team 和 Enterprise 计划中可用。对于启用了零数据保留的组织，该功能不可用。代码审查使用费单独计费，通过额外使用费计费，不计入您计划的包含使用量。

代码审查的工作原理

组织启用代码审查后，可以在拉取请求打开时、每次推送时或仅在有人手动请求审查时自动触发。审查运行时，多个代理并行分析差异和周围代码。每个代理查找不同类别的问题，然后验证步骤根据实际代码行为检查结果，以过滤掉误报。

发现的问题会被去重、按严重程度排序，并作为内联注释发布在发现问题的特定行上。如果未发现问题，Claude 会在拉取请求上发布简短的确认注释。审查不会批准或阻止您的拉取请求，因此现有的审查工作流保持不变。

审查成本随拉取请求的大小和复杂性而增加，平均完成时间为 20 分钟。

严重程度级别

每个发现都标记有严重程度级别：

标记	严重程度	含义
🔴	正常	合并前应修复的错误
🟡	小问题	值得修复但不阻止的小问题
🟣	已存在	代码库中存在但不是由此拉取请求引入的错误

发现包含可折叠的扩展推理部分，您可以展开以查看 Claude 标记问题的原因以及如何验证问题。

代码审查检查的内容

默认情况下，代码审查专注于正确性：会破坏生产的错误，而不是格式偏好或缺失的测试覆盖。您可以通过向存储库添加指导文件来扩展其检查范围。

设置代码审查

Team 和 Enterprise 计划的所有者和主要所有者可以为组织启用一次代码审查，并选择要包含的存储库。除了在 Claude 组织内拥有所有者角色外，您还需要在 GitHub 组织中安装 GitHub 应用的权限。

转到 组织设置 > Claude Code 并找到 代码审查 部分。
点击"配置"开始 GitHub 应用安装流程。
按照提示将 Claude GitHub 应用安装到您的 GitHub 组织。该应用请求对内容、问题和拉取请求的读写权限。
选择要为代码审查启用的存储库。如果您看不到存储库，请确认您在安装期间为 Claude GitHub 应用授予了访问权限。
使用 审查行为 下拉菜单为每个存储库设置审查触发器（请参阅下一部分了解每个选项的详细信息）。

要验证设置，请打开测试拉取请求。如果您选择了自动触发器，名为 Claude Code Review 的检查运行应在几分钟内出现。如果您选择了手动，请在拉取请求上评论"@claude review"以启动第一次审查。

选择审查触发器

设置后，代码审查 部分在表格中显示您的存储库。对于每个存储库，选择审查运行的时间：

拉取请求创建后一次：当拉取请求打开或标记为准备审查时，审查运行一次。
每次推送后：审查在每次推送到拉取请求分支时运行，在拉取请求演变时捕获新问题。当您修复之前标记的问题时，Claude 会自动解决线程。这会运行最多的审查并花费最多。
手动：仅当有人在拉取请求上评论"@claude review"时才开始审查。适用于高流量存储库，您可以选择审查哪些拉取请求。

存储库表还显示每个存储库基于最近活动的平均审查成本。

手动触发审查

在拉取请求上评论"@claude review"以启动审查，并将该拉取请求选择加入后续推送触发的审查。无论存储库的配置触发器如何，这都有效。

要使注释触发审查：

将其作为顶级拉取请求注释发布，而不是差异行上的内联注释。
在注释的开头放置"@claude review"。
您必须对存储库具有所有者、成员或协作者访问权限。
拉取请求必须打开且不是草稿。

如果审查已在运行，请求将排队等待进行中的审查完成。

自定义审查

代码审查从您的存储库读取两个文件来指导其标记的内容。两者都是在默认正确性检查的基础上添加的。

CLAUDE.md

代码审查读取您存储库的 CLAUDE.md 文件，并将新引入的违规视为小问题级别的发现。如果您的拉取请求以使 CLAUDE.md 语句过时的方式更改代码，Claude 会标记文档也需要更新。

Claude 在目录层次结构的每个级别读取 CLAUDE.md 文件，因此子目录的 CLAUDE.md 中的规则仅适用于该路径下的文件。

REVIEW.md

将 REVIEW.md 文件添加到存储库根目录以获取审查特定规则。使用它来编码：

公司或团队风格指南
语言或框架特定的约定，不被 linter 覆盖
Claude 应始终标记的内容（例如，"任何新的 API 路由必须有集成测试"）
Claude 应跳过的内容（例如，"不要对生成的代码进行注释"）

Claude 在存储库根目录自动发现 REVIEW.md。无需配置。

定价和使用

代码审查根据令牌使用情况计费。每次审查的平均成本为 $15–25，随拉取请求大小、代码库复杂性以及需要验证的问题数量而增加。

代码审查使用费单独计费，通过额外使用费计费，不计入您计划的包含使用量。您选择的审查触发器会影响总成本：

拉取请求创建后一次每个拉取请求运行一次。
每次推送后在每次推送时运行，将成本乘以推送次数。
手动在有人评论"@claude review"之前不产生成本。在该注释之后，对拉取请求的其他推送会自动触发审查。

成本显示在您的 Anthropic 账单上，无论您的组织是否为其他 Claude Code 功能使用 AWS Bedrock 或 Google Vertex AI。

要设置每月支出上限，请转到 组织设置 > 使用 并为 Claude Code Review 服务配置限制。

通过分析仪表板中的每周成本图表或管理员设置中的每个存储库平均成本列监控支出。

查看使用情况

转到 代码审查分析仪表板 查看您的组织中的活动。仪表板显示：

审查的拉取请求：所选时间范围内每天审查的拉取请求数。
每周成本：代码审查的每周支出。
反馈：因有人解决问题而自动解决的审查注释数。
存储库细分：每个存储库审查的拉取请求数和已解决注释数。

故障排除

安装 GitHub 应用后存储库未出现

如果您已安装 Claude GitHub 应用但您的存储库未出现在管理面板中：

确认 Claude GitHub 应用可以访问您期望的存储库。转到您的 GitHub 组织设置，在 已安装的 GitHub 应用 下找到 Claude GitHub 应用，并检查它是否可以访问所有存储库或仅选定的存储库。
如果您的组织使用带有企业托管用户 (EMU) 的 GitHub Enterprise Cloud，请确保 Claude GitHub OAuth 应用在企业级别获得授权。EMU 企业可以限制哪些 OAuth 应用被批准，Claude 应用必须被明确允许。
尝试断开并重新连接 GitHub 集成。转到 组织设置 > Claude Code，删除存储库配置，然后重新运行设置。
如果问题仍然存在，请 联系我们的支持团队，提供您的组织名称和 GitHub 组织名称，以便我们进行调查。

代码审查不在新拉取请求上启动

如果打开拉取请求后未出现检查运行：

确认存储库已列出并在您的管理员设置中启用。
检查审查触发器设置。如果设置为手动，您需要在拉取请求上评论"@claude review"以启动审查。
确保拉取请求不是草稿。代码审查不在草稿拉取请求上运行。
验证 Claude GitHub 应用在您的 GitHub 组织设置中仍然可以访问存储库。

GitHub Enterprise Cloud 与 IP 限制

如果您的 GitHub Enterprise Cloud 组织按 IP 地址限制访问，Claude GitHub 应用可能无法访问您的存储库。要解决此问题，请在您的 GitHub 企业设置中 为已安装的 GitHub 应用启用 IP 允许列表继承。Claude GitHub 应用注册其 IP 范围，因此启用此设置允许访问而无需手动配置。要 手动将范围添加到您的允许列表，或配置其他防火墙，请参阅 Anthropic API IP 地址。

GitHub Enterprise Server（自托管）

代码审查目前需要托管在 github.com 上的存储库，因此尚不支持自托管的 GitHub Enterprise Server。

常见问题

创建自定义角色时，代码审查是否可用作功能？

否，代码审查目前不可添加到 自定义角色。