> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Code Review

> 设置自动化 PR 审查，通过对完整代码库的多代理分析来捕获逻辑错误、安全漏洞和回归问题

<Note>
  Code Review 处于研究预览阶段，仅适用于 [Team 和 Enterprise](https://claude.ai/admin-settings/claude-code) 订阅。对于启用了 [Zero Data Retention](/zh-CN/zero-data-retention) 的组织，此功能不可用。
</Note>

Code Review 分析您的 GitHub pull request，并在发现问题的代码行上发布内联评论。一支由专业代理组成的团队在完整代码库的上下文中检查代码更改，寻找逻辑错误、安全漏洞、破损的边界情况和微妙的回归问题。

发现结果按严重程度标记，不会批准或阻止您的 PR，因此现有的审查工作流保持不变。您可以通过向存储库添加 `CLAUDE.md` 或 `REVIEW.md` 文件来调整 Claude 标记的内容。

要在您自己的 CI 基础设施中运行 Claude 而不是使用此托管服务，请参阅 [GitHub Actions](/zh-CN/github-actions) 或 [GitLab CI/CD](/zh-CN/gitlab-ci-cd)。对于自托管 GitHub 实例上的存储库，请参阅 [GitHub Enterprise Server](/zh-CN/github-enterprise-server)。

本页涵盖：

* [审查工作原理](#how-reviews-work)
* [设置](#set-up-code-review)
* [手动触发审查](#manually-trigger-reviews)，使用 `@claude review` 和 `@claude review once`
* [自定义审查](#customize-reviews)，使用 `CLAUDE.md` 和 `REVIEW.md`
* [定价](#pricing)
* [故障排除](#troubleshooting)失败的运行和缺失的评论
* [在本地审查差异](#review-a-diff-locally)，使用 `/code-review` 命令

<Note>
  要在本地终端中审查差异而无需安装 GitHub App，请在任何 Claude Code 会话中运行 `/code-review` 命令。请参阅[在本地审查差异](#review-a-diff-locally)。
</Note>

<h2 id="how-reviews-work">
  审查工作原理
</h2>

一旦管理员为您的组织[启用 Code Review](#set-up-code-review)，审查将在 PR 打开时、每次推送时或手动请求时触发，具体取决于存储库的配置行为。在任何模式下，注释 `@claude review` 可以[在 PR 上启动审查](#manually-trigger-reviews)。

当审查运行时，多个代理在 Anthropic 基础设施上并行分析差异和周围代码。每个代理寻找不同类别的问题，然后验证步骤检查候选项是否与实际代码行为相符，以过滤掉误报。结果被去重、按严重程度排序，并作为内联评论发布在发现问题的特定行上，并在审查正文中包含摘要。如果未发现问题，Code Review 会更新 GitHub 检查运行以显示未检测到问题。Claude 也可能在 PR 上发布简短的确认评论。

审查成本随 PR 大小和复杂性而扩展，平均在 20 分钟内完成。管理员可以通过[分析仪表板](#view-usage)监控审查活动和支出。

<h3 id="severity-levels">
  严重程度级别
</h3>

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

| 标记 | 严重程度 | 含义                   |
| :- | :--- | :------------------- |
| 🔴 | 重要   | 应在合并前修复的错误           |
| 🟡 | 小问题  | 轻微问题，值得修复但不阻止        |
| 🟣 | 预先存在 | 代码库中存在但不是由此 PR 引入的错误 |

发现包括可折叠的扩展推理部分，您可以展开以了解 Claude 为什么标记该问题以及它如何验证问题。

<h3 id="rate-and-reply-to-findings">
  对发现进行评分和回复
</h3>

Claude 的每条审查评论都已附加 👍 和 👎，因此两个按钮都会在 GitHub UI 中出现，以便一键评分。如果发现有用，请点击 👍；如果发现错误或嘈杂，请点击 👎。Anthropic 在 PR 合并后收集反应计数，并使用它们来调整审查者。反应不会触发重新审查或更改 PR 上的任何内容。

回复内联评论不会提示 Claude 响应或更新 PR。要对发现采取行动，请修复代码并推送。如果 PR 订阅了推送触发的审查，下一次运行将在问题修复时解决线程。要请求新审查而不推送，请作为[顶级 PR 评论](#manually-trigger-reviews)注释 `@claude review once`。

<h3 id="check-run-output">
  检查运行输出
</h3>

除了内联审查评论外，每次审查都会填充 **Claude Code Review** 检查运行，该运行与您的 CI 检查一起出现。展开其 **Details** 链接以在一个地方查看每个发现的摘要，按严重程度排序：

| 严重程度   | 文件:行                      | 问题                            |
| ------ | ------------------------- | ----------------------------- |
| 🔴 重要  | `src/auth/session.ts:142` | 令牌刷新与登出竞争，导致过期会话保持活跃          |
| 🟡 小问题 | `src/auth/session.ts:88`  | `parseExpiry` 在格式错误的输入上静默返回 0 |

每个发现也作为 **Files changed** 选项卡中的注释出现，直接标记在相关的差异行上。重要发现用红色标记呈现，小问题用黄色警告，预先存在的错误用灰色通知。注释和严重程度表独立于内联审查评论写入检查运行，因此即使 GitHub 拒绝在移动的行上的内联评论，它们仍然可用。

检查运行始终以中立结论完成，因此它永远不会通过分支保护规则阻止合并。如果您想根据 Code Review 发现来限制合并，请在您自己的 CI 中读取检查运行输出中的严重程度分解。Details 文本的最后一行是一个机器可读的评论，您的工作流可以使用 `gh` 和 jq 解析：

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

这返回一个 JSON 对象，其中包含每个严重程度的计数，例如 `{"normal": 2, "nit": 1, "pre_existing": 0}`。`normal` 键保存重要发现的计数；非零值意味着 Claude 发现了至少一个在合并前值得修复的错误。

<h3 id="what-code-review-checks">
  Code Review 检查的内容
</h3>

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

<h2 id="set-up-code-review">
  设置 Code Review
</h2>

管理员为组织启用一次 Code Review，并选择要包含的存储库。

<Steps>
  <Step title="打开 Claude Code 管理员设置">
    转到 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 并找到 Code Review 部分。您需要对 Claude 组织具有 Owner 或 Primary Owner 角色，并有权在 GitHub 组织中安装 GitHub Apps。
  </Step>

  <Step title="开始设置">
    点击**设置**。这将开始 GitHub App 安装流程。
  </Step>

  <Step title="安装 Claude GitHub App">
    按照提示将 Claude GitHub App 安装到您的 GitHub 组织。该应用请求这些存储库权限：

    * **Contents**：读写
    * **Issues**：读写
    * **Pull requests**：读写

    Code Review 使用对内容的读取访问权限和对 pull request 的写入访问权限。更广泛的权限集也支持 [GitHub Actions](/zh-CN/github-actions)，如果您稍后启用的话。
  </Step>

  <Step title="选择存储库">
    选择要为 Code Review 启用的存储库。如果您看不到存储库，请确保在安装期间为 Claude GitHub App 提供了对其的访问权限。您可以稍后添加更多存储库。
  </Step>

  <Step title="为每个存储库设置审查触发器">
    设置完成后，Code Review 部分在表格中显示您的存储库。对于每个存储库，使用**审查行为**下拉菜单选择何时运行审查：

    * **PR 创建后一次**：当 PR 打开或标记为准备审查时运行一次审查
    * **每次推送后**：在每次推送到 PR 分支时运行审查，在 PR 演变时捕获新问题，并在您修复标记的问题时自动解决线程
    * **手动**：仅当有人[在 PR 上注释 `@claude review` 或 `@claude review once`](#manually-trigger-reviews) 时才启动审查；`@claude review` 也会将 PR 订阅到后续推送的审查

    每次推送时审查会运行最多审查并花费最多。手动模式对于高流量存储库很有用，您可以选择特定 PR 进行审查，或仅在 PR 准备好后才开始审查。
  </Step>
</Steps>

存储库表还显示每个存储库基于最近活动的平均审查成本。使用行操作菜单为每个存储库打开或关闭 Code Review，或完全删除存储库。

要验证设置，请打开测试 PR。如果您选择了自动触发器，在几分钟内会出现名为 **Claude Code Review** 的检查运行。如果您选择了手动，在 PR 上注释 `@claude review` 以启动第一次审查。如果没有出现检查运行，请确认存储库在您的管理员设置中列出，并且 Claude GitHub App 有权访问它。

<h2 id="manually-trigger-reviews">
  手动触发审查
</h2>

两个注释命令按需启动审查。无论存储库的配置触发器如何，两者都有效，因此您可以使用它们在手动模式下选择特定 PR 进行审查，或在其他模式下获得立即重新审查。

| 命令                    | 作用                     |
| :-------------------- | :--------------------- |
| `@claude review`      | 启动审查并将 PR 订阅到今后的推送触发审查 |
| `@claude review once` | 启动单次审查，不订阅未来推送         |

当您想要对 PR 的当前状态获得反馈但不希望每次后续推送都产生审查时，使用 `@claude review once`。这对于具有频繁推送的长期运行 PR 很有用，或者当您想要一次性第二意见而不改变 PR 的审查行为时。

对于任一命令触发审查：

* 将其作为顶级 PR 评论发布，而不是差异行上的内联评论
* 在注释开头放置命令，如果您使用一次性形式，则在同一行上放置 `once`
* 您必须对存储库具有所有者、成员或协作者访问权限
* PR 必须打开

与自动触发不同，手动触发在草稿 PR 上运行，因为显式请求表示您想要现在的审查，无论草稿状态如何。

如果该 PR 上已有审查正在运行，请求将排队等待进行中的审查完成。您可以通过 PR 上的检查运行监控进度。

<h2 id="customize-reviews">
  自定义审查
</h2>

Code Review 从您的存储库读取两个文件来指导它标记的内容。它们在如何强烈影响审查方面有所不同：

* **`CLAUDE.md`**：共享项目说明，Claude Code 用于所有任务，不仅仅是审查。Code Review 将其作为项目上下文读取，并将新引入的违规标记为小问题。
* **`REVIEW.md`**：仅审查说明，直接注入到审查管道中的每个代理中作为最高优先级。使用它来改变标记的内容、严重程度以及如何报告发现。

<h3 id="claude-md">
  CLAUDE.md
</h3>

Code Review 读取您的存储库的 `CLAUDE.md` 文件，并将新引入的违规视为[小问题级别](#severity-levels)的发现。这是双向工作的：如果您的 PR 以使 `CLAUDE.md` 语句过时的方式更改代码，Claude 会标记文档需要更新。

Claude 在目录层次结构的每个级别读取 `CLAUDE.md` 文件，因此子目录的 `CLAUDE.md` 中的规则仅适用于该路径下的文件。有关 `CLAUDE.md` 如何工作的更多信息，请参阅[内存文档](/zh-CN/memory)。

对于您不想应用于常规 Claude Code 会话的仅审查指导，请改用 [`REVIEW.md`](#review-md)。

<h3 id="review-md">
  REVIEW\.md
</h3>

`REVIEW.md` 是位于您的存储库根目录的文件，它覆盖 Code Review 在您的存储库上的行为方式。其内容被注入到审查管道中每个代理的系统提示中，作为最高优先级指令块，优先于默认审查指导。

因为它是逐字粘贴的，`REVIEW.md` 是纯说明：[`@` 导入语法](/zh-CN/memory#import-additional-files)不会展开，引用的文件不会读入提示。将您想要强制执行的规则直接放在文件中。

<h4 id="what-you-can-tune">
  您可以调整的内容
</h4>

`REVIEW.md` 是自由格式的 markdown，因此任何您可以表达为审查说明的内容都在范围内。下面的模式在实践中影响最大。

**严重程度**：为您的存储库重新定义 🔴 重要的含义。默认校准针对生产代码；文档存储库、配置存储库或原型可能想要更窄的定义。明确说明哪些类别的发现是重要的，哪些最多是小问题。您也可以向另一个方向升级，例如将任何 `CLAUDE.md` 违规视为重要而不是默认小问题。

**小问题数量**：限制单次审查发布的 🟡 小问题评论数量。散文和配置文件可以永远被打磨。像"最多报告五个小问题，在摘要中提及其余的计数"这样的上限使审查可操作。

**跳过规则**：列出 Claude 应该不发布任何发现的路径、分支模式和发现类别。常见候选是生成的代码、lockfiles、供应商依赖和机器创作的分支，以及您的 CI 已经强制执行的任何内容，如 linting 或拼写检查。对于值得一些审查但不需要完全审查的路径，设置更高的标准而不是完全跳过："在 `scripts/` 中，仅在接近确定且严重时报告。"

**存储库特定检查**：添加您想在每个 PR 上标记的规则，如"新 API 路由必须有集成测试。"因为 `REVIEW.md` 被注入为最高优先级，这些比长 `CLAUDE.md` 中的相同规则更可靠地着陆。

**验证标准**：在发布发现类别之前需要证据。例如，"行为声明需要源中的 `file:line` 引用，而不是从命名推断"会减少否则会花费作者往返的误报。

**重新审查收敛**：告诉 Claude 当 PR 已经被审查时如何表现。像"在第一次审查后，抑制新的小问题并仅发布重要发现"这样的规则会阻止单行修复仅因风格而达到第七轮。

**摘要形状**：要求审查正文以一行计数开头，如 `2 factual, 4 style`，并在这种情况下以"没有事实问题"开头。作者想在详细信息之前知道工作的形状。

<h4 id="example">
  示例
</h4>

这个 `REVIEW.md` 为后端服务重新校准严重程度，限制小问题，跳过生成的文件，并添加存储库特定检查。

```markdown theme={null}
# 审查说明

## 重要在这里的含义

保留重要用于会破坏行为、泄露数据或阻止回滚的发现：不正确的逻辑、无范围的数据库查询、日志或错误消息中的 PII，以及不向后兼容的迁移。风格、命名和重构建议最多是小问题。

## 限制小问题

每次审查最多报告五个小问题。如果您发现了更多，请在摘要中说"加上 N 个类似项目"而不是内联发布它们。如果您发现的一切都是小问题，请以"没有阻止问题"开头摘要。

## 不要报告

- CI 已经强制执行的任何内容：lint、格式化、类型错误
- `src/gen/` 下生成的文件和任何 `*.lock` 文件
- 故意违反生产规则的仅测试代码

## 始终检查

- 新 API 路由有集成测试
- 日志行不包括电子邮件地址、用户 ID 或请求正文
- 数据库查询的范围限定为调用者的租户
```

<h4 id="keep-it-focused">
  保持专注
</h4>

长度有成本：长 `REVIEW.md` 会稀释最重要的规则。将其保持为改变审查行为的说明，并将常规项目上下文留在 `CLAUDE.md` 中。

<h2 id="view-usage">
  查看使用情况
</h2>

转到 [claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) 以查看整个组织的 Code Review 活动。仪表板显示：

| 部分     | 显示内容                         |
| :----- | :--------------------------- |
| 审查的 PR | 所选时间范围内每日审查的 pull request 计数 |
| 每周成本   | Code Review 的每周支出            |
| 反馈     | 因开发人员解决问题而自动解决的审查评论计数        |
| 存储库分解  | 每个存储库的审查 PR 计数和已解决评论         |

管理员设置中的存储库表也显示每个存储库的平均审查成本。仪表板成本数字是用于监控活动的估计；对于发票准确的支出，请参考您的 Anthropic 账单。

<h2 id="pricing">
  定价
</h2>

Code Review 根据令牌使用情况计费。每次审查平均花费 \$15-25，随 PR 大小、代码库复杂性和需要验证的问题数量而扩展。Code Review 使用通过[使用额度](https://support.claude.com/zh-CN/articles/12429409-extra-usage-for-paid-claude-plans)单独计费，不计入您的计划包含的使用。

您选择的审查触发器影响总成本：

* **PR 创建后一次**：每个 PR 运行一次
* **每次推送后**：在每次推送时运行，将成本乘以推送次数
* **手动**：在有人在 PR 上注释 `@claude review` 之前没有审查

在任何模式下，注释 `@claude review` [选择 PR 进入推送触发审查](#manually-trigger-reviews)，因此在该注释后每次推送都会产生额外成本。要运行单次审查而不订阅未来推送，请改为注释 `@claude review once`。

无论您的组织是否为其他 Claude Code 功能使用 Amazon Bedrock 或 Google Vertex AI，成本都会出现在您的 Anthropic 账单上。要为 Code Review 设置每月支出上限，请转到 [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) 并为 Claude Code Review 服务配置限制。

通过[分析](#view-usage)中的每周成本图表或管理员设置中的每个存储库平均成本列监控支出。

<h2 id="troubleshooting">
  故障排除
</h2>

审查运行是尽力而为的。失败的运行永远不会阻止您的 PR，但它也不会自动重试。本部分介绍如何从失败的运行中恢复，以及当检查运行报告您找不到的问题时在哪里查看。

<h3 id="retrigger-a-failed-or-timed-out-review">
  重新触发失败或超时的审查
</h3>

当审查基础设施遇到内部错误或超过时间限制时，检查运行完成，标题为 **Code review encountered an error** 或 **Code review timed out**。结论仍然是中立的，因此没有任何东西阻止您的合并，但没有发现被发布。

要再次运行审查，在 PR 上注释 `@claude review once`。这启动一个新的审查，不订阅 PR 到未来推送。如果 PR 已订阅推送触发审查，推送新提交也会启动新审查。

GitHub 检查选项卡中的**重新运行**按钮不会重新触发 Code Review。改用注释命令或新推送。

<h3 id="review-didn’t-run-and-the-pr-shows-a-spend-cap-message">
  审查未运行，PR 显示支出上限消息
</h3>

当您的组织的每月支出上限达到时，Code Review 在 PR 上发布单条评论，解释审查被跳过。审查在下一个计费周期开始时自动恢复，或当管理员在 [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) 提高上限时立即恢复。

<h3 id="find-issues-that-aren’t-showing-as-inline-comments">
  查找未显示为内联评论的问题
</h3>

如果检查运行标题说发现了问题但您在差异上看不到内联审查评论，请在这些其他位置查看发现的位置：

* **检查运行 Details**：在检查选项卡中的 Claude Code Review 检查旁边点击 **Details**。严重程度表列出每个发现及其文件、行和摘要，无论内联评论是否被接受。
* **Files changed 注释**：在 PR 上打开 **Files changed** 选项卡。发现呈现为直接附加到差异行的注释，与审查评论分开。
* **审查正文**：如果您在审查运行时推送到 PR，某些发现可能引用当前差异中不再存在的行。这些出现在审查正文文本中的 **Additional findings** 标题下，而不是作为内联评论。

<h2 id="review-a-diff-locally">
  在本地审查差异
</h2>

[`/code-review` 命令](/zh-CN/commands)在您的终端中审查差异，无需安装 GitHub App。在任何 Claude Code 会话中运行它：它报告正确性错误和{/* min-version: 2.1.151 */}重用、简化和效率清理。默认情况下，本地审查涵盖您分支相对于其上游的提前提交加上工作树中的任何未提交更改。传递 `--comment` 以将发现作为内联 PR 评论发布，或传递 `--fix` 以在审查后将发现应用到您的工作树。

较低的[工作量级别](/zh-CN/model-config#adjust-effort-level)返回较少、更高置信度的发现，而 `high` 到 `max` 提供更广泛的覆盖范围，可能包括不确定的发现。没有工作量参数，审查使用会话的当前工作量。要审查默认差异以外的内容，请传递一个目标：文件路径、PR 编号、分支名称或引用范围，例如 `main...my-feature`。引用范围形式审查从 `my-feature` 到 `main` 的拉取请求将包含的已提交差异，无论分支的上游如何配置。

`/code-review ultra --fix` 在云中运行更深入的 [ultrareview](/zh-CN/ultrareview)，然后在发现到达您的会话时将其应用到您的工作树。Ultrareview 使用其自己的范围：您当前的分支与存储库的默认分支，加上工作树中的任何未提交和暂存的更改。

该命令在 v2.1.147 之前被命名为 `/simplify`，当时它默认应用修复。{/* min-version: 2.1.154 */}从 v2.1.154 开始，`/simplify` 运行单独的仅清理审查，应用修复而不寻找错误。如果您为错误查找编写了 `/simplify` 脚本，请切换到 `/code-review --fix`，它保持不变。

<h2 id="related-resources">
  相关资源
</h2>

Code Review 旨在与 Claude Code 的其余部分一起工作。如果您想在打开 PR 之前在本地运行审查、需要自托管设置或想深入了解 `CLAUDE.md` 如何在工具中塑造 Claude 的行为，这些页面是很好的下一步：

* [Commands](/zh-CN/commands)：在本地 Claude Code 会话中运行 `/code-review` 以在推送前检查差异
* [GitHub Actions](/zh-CN/github-actions)：在您自己的 GitHub Actions 工作流中运行 Claude，以实现超越代码审查的自定义自动化
* [GitLab CI/CD](/zh-CN/gitlab-ci-cd)：GitLab 管道的自托管 Claude 集成
* [Memory](/zh-CN/memory)：`CLAUDE.md` 文件如何在 Claude Code 中工作
* [Analytics](/zh-CN/analytics)：跟踪超越代码审查的 Claude Code 使用情况