启用 Code Review 所需的条件
首先确认您的组织符合 Code Review 的使用条件。然后确保您拥有以下访问权限,或有拥有这些权限的人员协助:启用 Code Review
1
点击 Allow code review 开关
前往 Admin settings > Claude Code 的 Code review 部分,点击 Allow code review 开关。如果 Code Review 立即启用且没有弹出对话框,说明您的组织已经关联了 Claude GitHub App 或已添加了仓库。请前往添加更多仓库,然后再返回完成最后一步。
2
连接您的 GitHub 账户
如果打开了 Connect GitHub 对话框,请点击 Connect。如果您的组织使用 GitHub Enterprise Server,请先在对话框中选择您的实例。GitHub 会要求您授权 Claude,然后将您带回管理页面,并打开 Add a repository 对话框。如果直接打开了 Add a repository,说明您的账户已经连接,请继续下一步。
3
安装 Claude GitHub App
如果所需的仓库已列在 Add a repository 对话框中,或者您可以在其中搜索到它们,请继续下一步。只有 Claude GitHub App 能够访问的仓库才会出现在该对话框中,因此如果找不到这些仓库,请安装该应用:
- 点击 Install GitHub App。当没有列出任何仓库时,它是对话框中的一个按钮;否则,它位于对话框中 GitHub 组织筛选菜单的底部。GitHub 的安装页面会在新标签页中打开。
- 选择拥有这些仓库的 GitHub 组织。
- 选择该应用可以访问的仓库。
- 批准所请求的权限。这组权限比审查实际使用的范围更广,并由其他 Claude 功能共享,例如 GitHub Actions。请参阅审查可以访问的内容以及完整权限列表。
- 安装完成后,该标签页会返回 Claude。如果显示 Finish connecting GitHub 按钮,请点击它,将此次安装关联到您的 Claude 组织。
- 返回管理页面所在的标签页,对话框中的列表会随之刷新。
4
选择仓库
选择需要审查的仓库,然后点击 Continue。添加仓库需要您连接的 GitHub 账户对该仓库拥有写入权限。您可以稍后添加更多仓库。
5
点击 Finish
随后会出现 Code review is set up 对话框。点击 Finish 以启用 Code Review。如果您以其他方式关闭该对话框,仓库仍会保持已添加状态,但 Allow code review 会保持关闭,您需要通过该开关将其启用。每个仓库初始设置为每次推送后都进行审查,这会运行最多的审查。如需减少审查次数,请设置审查的运行时机。
6
通过测试 Pull Request 进行验证
在您添加的某个仓库中打开一个测试 Pull Request,且不要将其标为草稿。几分钟内会出现一个名为 Claude Code Review 的检查运行。如果您已将该仓库设置为 Manual (@claude review),请在 Pull Request 上评论
@claude review 以启动首次审查。如果没有出现检查运行,请参阅测试 Pull Request 上没有出现检查运行。审查结果出现后,请将在 Pull Request 上阅读和请求审查发送给您的开发人员,其中介绍了严重级别、评论命令以及如何处理审查发现的问题。为组织设置默认值
作为 Owner,您可以决定审查的细致程度和运行频率。这两项都位于 Admin settings > Claude Code 的 Code review 部分。设置默认审查级别
审查级别决定每次审查的细致程度,审查越细致,费用越高。您可以为组织设置一个默认值,并为单个仓库覆盖该值。- 组织默认值:在 Review level 下选择一个级别,然后点击 Change level 确认。除非为某个仓库单独设置级别,否则所有仓库都使用该默认值。
- 单个仓库:点击该仓库所在行的 Edit,然后在其中选择 Review level。第一个选项 Default 遵循组织设置。选择后级别会立即保存。
设置审查的运行时机
每个仓库都有各自的 Review runs 设置,用于决定何时审查该仓库的 Pull Request。- Once after PR creation:在 Pull Request 被打开、重新打开或标记为可供审查时运行一次审查
- After every push:在向 Pull Request 分支推送时运行审查,随着 Pull Request 的演进捕获新问题,并在您修复所指出的问题后自动解决相应讨论串
- Manual (@claude review):打开 Pull Request 或向其推送不会启动审查。评论
@claude review以请求审查,或评论@claude review always以同时让该 Pull Request 在后续推送时也接受审查。
- 草稿以及来自复刻的 Pull Request:无论您选择哪个选项,自动审查都会跳过这两类
- 新仓库:从 Add a repository 对话框添加的仓库初始设置为 After every push。如果其所属 GitHub 组织已整体覆盖,则改为采用该组织行的设置。
开启或关闭提示评论
提示评论是在未启动审查时 Claude 在 Pull Request 上发布的简短评论,用于说明原因以及下一步该怎么做。Show tips on pull requests 默认开启。开启后,Claude 会在以下每种情况下发布提示,说明:- 仓库设置为 Manual:如何通过评论请求审查
- Pull Request 来自复刻:维护者可以请求审查
- 机器人或没有写入权限的人评论了
@claude review:未启动审查,以及谁可以请求审查 - GitHub 组织未关联到您的 Claude 组织:审查已暂停,以及如何进行关联
开发人员可以更改的内容
开发人员如需更改审查级别、Review runs 设置或接受审查的仓库,需要联系您。在没有 Owner 角色的情况下,他们可以在 GitHub 上执行以下操作:- 请求审查:在 Pull Request 上评论
@claude review。这需要对仓库拥有写入权限,并且适用于自动审查会跳过的草稿以及来自复刻的 Pull Request。 - 让单个 Pull Request 在每次推送时接受审查:在非草稿或非复刻来源的 Pull Request 上评论
@claude review always,例如在设置为 Manual 的仓库中 - 更改审查所指出的内容:向仓库提交
REVIEW.md和CLAUDE.md文件,例如添加一项检查
管理仓库
您可以逐个添加仓库,也可以一次性覆盖整个 GitHub 组织,并在不需要的地方停止审查。添加更多仓库
要在设置完成后添加仓库,请点击 Code review 部分中 Repositories 表上方的 Add。Add a repository 对话框随即打开。选择仓库并点击 Continue。- 某个仓库未列出:请参阅某个仓库未在 Add a repository 中列出。
- 您希望包含某个 GitHub 组织中的所有仓库:请覆盖整个组织,而不是逐个选择仓库
覆盖整个 GitHub 组织
要为某个 GitHub 组织中的所有仓库启用 Code Review,请在 Repositories 表中该组织所在行设置 Review runs。这会覆盖该组织中 Claude GitHub App 可以访问的所有仓库,包括之后添加的仓库。这可能会显著增加花费。需要同时满足以下所有条件:- 您连接到 Claude 的 GitHub 账户是该 GitHub 组织的所有者。
- 该组织位于 github.com 上。GitHub Enterprise Server 实例和个人 GitHub 账户不符合条件。
- 已为您的 Claude 组织或 Code Review 设置了每月花费上限。
- 覆盖范围:每个仓库从下一个 Pull Request 开始被覆盖。如果 Claude GitHub App 安装时只选择了部分仓库而非全部仓库,Claude 会审查这些仓库;要覆盖其余仓库,请在 GitHub 上更改该应用的仓库访问权限。
- 现有设置:该 GitHub 组织中的每个仓库都会采用您选择的选项,包括您单独设置过的仓库。再次设置该行也会产生相同效果。在各自行中被关闭的仓库会保持关闭。
- 之后的单独更改:之后设置得与其所属组织不同的仓库,会在表中标注为 Custom。
- 审查级别:组织行本身没有审查级别。
关闭 Code Review 或移除仓库
在 Admin settings > Claude Code 的 Code review 部分,根据您要停止的内容选择相应的控件:- 单个仓库,保留在列表中:点击其所在行的 Edit,然后关闭 Code review。表中会将该仓库显示为 Off。
- 单个仓库,将其移除:点击其所在行的 Edit,然后点击对话框底部的 Remove repository。该仓库的审查将停止,之后其他 Claude 组织就可以设置该仓库。当该仓库所属的 GitHub 组织被整体覆盖时,无法将其移除;请改为关闭其 Code review 开关。
- 整个 GitHub 组织:点击该组织所在行的 Edit,然后选择 Off。这也会关闭该组织中您逐个添加的仓库。
- 全部:关闭 Allow code review。所有仓库都不会再启动新的审查,您的仓库列表会被保留,以便日后重新启用。
相关资源
- Code Review 费用和用量:审查级别和审查运行时机如何影响花费、如何设置花费上限,以及在哪里查看用量
- 在 Pull Request 上阅读和请求审查:开发人员在 Pull Request 上看到的内容以及评论命令
- 自定义 Code Review:使用
REVIEW.md和CLAUDE.md调整 Claude 指出的内容 - GitHub Enterprise Server:在设置前连接自托管的 GitHub 实例