把 Claude 代码审查接入 GitHub 工作流

dev.to · AI#Claude#代码审查#自动化

Editor brief · 编辑速览

Claude Code Action 可在 GitHub runner 上执行 PR 审查、响应提及并实现简单修复，支持多个模型服务渠道。快捷安装需要仓库管理员权限，且仅适用于直接使用 Anthropic API 的用户。

文章思维导图

Knowledge map

拖拽缩放

AI deep read

AI 深度解读

想让 Claude 自动审查每个 PR，不必先搭一套常驻服务。anthropics/claude-code-action 可以直接在 GitHub runner 上运行，也能响应 issue 中的 @claude。原文给出的路径是：安装 GitHub app，配置 workflow，再逐步收窄审查范围。

但这是一份基于 README 整理的接入指南。作者没有在真实仓库运行 Action，也没有提供审查准确率、费用或耗时数据。它值得参考的，是接入方式和权限边界，实际效果还需要团队自己验证。

不运行服务器，Claude 怎么参与 PR？

anthropics/claude-code-action 是面向 GitHub PR 和 issue 的通用 Claude Code Action。它根据 workflow 上下文选择工作模式，可以响应 @claude、处理 issue 指派，也可以执行 workflow 中明确给出的 prompt，不需要另外配置模式。

它能回答代码问题、审查 PR，以及实现简单修复。这里要区分两件事：Action 在 GitHub runner 上执行，模型 API 请求则发往你选择的提供商。

原文列出的提供商包括 Anthropic direct、Amazon Bedrock、Google Vertex AI 和 Microsoft Foundry。因此，「不用运行服务器」指的是不必维护额外的常驻服务，模型调用和凭据配置仍然存在。

安装入口是在仓库终端打开 Claude Code，再执行 GitHub app 安装命令：

claude
/install-github-app

第二行是进入 Claude Code 后执行的命令。它会引导安装 GitHub app，并添加所需 secrets。前提是你拥有仓库管理员权限，而且这个快速安装流程只适用于直接使用 Anthropic API 的用户。Bedrock、Vertex 或 Foundry 用户需要按仓库中的 docs/cloud-providers.md 配置。

自动审查怎么落地，为什么还要收窄范围？

原文建议从 docs/solutions.md 的自动 PR 审查示例开始，把 workflow 复制到 .github/workflows/，然后创建一个测试 PR。

文章没有贴出完整 workflow，所以仅凭这篇内容，还不能直接拼出可靠的 YAML 配置。特别是已有旧配置的团队，需要核对版本：v1.0 的输入参数是 prompt 和 claude_args，从 v0.x 升级应参考 README 的 Migration Guide。

跑通之后，作者建议做两件事：把审查限定到出错代价较高的目录，并在 prompt 中加入团队自己的检查清单。

这样调整的价值，是让审查目标更明确。例如，团队已有明确约束时，就可以要求 Claude 按清单检查，而不只是泛泛地评价代码。不过，原文没有提供数据证明，收窄目录一定能提高准确率或降低多少成本。

Solutions Guide 还列出了按关键文件路径触发审查、对外部贡献者进行特殊处理、按团队标准检查、面向 OWASP 的安全审查，以及 issue 分类与标签、定期仓库健康检查等模式。这些是可参考的配置方向，不能理解成安装后就会全部启用。

我的判断

我认可它把 AI 审查定位成第一轮检查。PR 是一个自然的介入点：代码变更已经集中到一起，团队也正准备讨论和批准合并。但这只能说明接入位置合理，不能证明 Claude 能稳定发现关键缺陷。

作者明确没有在真实仓库验证这套配置，因此文章提供的是接入依据，不是效果证据。 它也没有给出与人工审查、现有静态检查工具或其他 AI 审查工具的对照数据。

权限边界比安装步骤更需要认真处理。原文说明，默认工具访问受限，额外工具需要通过配置启用。只做审查时，就应按审查需要配置工具；准备允许它推送代码时，再阅读 docs/security.md 中的访问控制、权限和 commit signing 要求。

对一般团队而言，先保留人工批准合并更合适。自动评论能否减少审查工作，还取决于它能发现多少有效问题，以及会制造多少需要人工排查的误报，这些原文都没有回答。

能拿来做什么

先在一个仓库接入 docs/solutions.md 中的自动审查示例，用测试 PR 确认触发和评论流程，再扩大使用范围。
对前端或 Node 仓库，优先选择团队已认定的高风险目录，并把现有审查要求写进 prompt，让输出有明确的检查依据。
如果已经使用旧版 workflow，先核对 v0.x 到 v1.0 的迁移要求，重点检查 prompt、claude_args 和当前文档中的语法。
将自动审查作为人工合并前的补充，记录有效发现和误报；需要自动修复、推送代码时，再按安全文档配置相应权限。