📌 项目地址:anthropics/claude-code-action | ⭐ 9,038 颗星 | 🔧 TypeScript | 📜 未标注
这个 Action 做什么
仓库:anthropics/claude-code-action,Anthropic 官方维护,TypeScript 写的,9,038 个 star。
一句话说清:它把 Claude Code 接进 GitHub 的 PR 和 Issue,能干两类活。一是回答问题,你在评论里 @claude 问代码逻辑、架构设计,它直接回复。二是改代码,简单的 bug 修复、重构、新功能,它都能动手实现。
它跑在你自己的 GitHub runner 上,API 请求发给你自己选的 provider。Anthropic 官方看不到你的代码。
执行过程中 Claude 能访问 GitHub API 和文件操作,其他工具可以通过配置打开。任务列表用 checkbox 展示,做完一项勾一项,你能看到它的进度。对复杂自动化任务,它还能输出经过校验的 JSON,自动变成 GitHub Action 的 outputs,下游 workflow 直接引用。
怎么装
最快的路径走 Claude Code CLI。终端里打开 claude,输入:
/install-github-app
这个命令会引导你装好 GitHub App、配好 secrets。两个前提条件:
- 你得是仓库 admin,不然装不了 App、加不了 secrets
- 这条快捷路径只支持直连 Anthropic API。用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 的,去看 docs/cloud-providers.md
认证方面,除了 API key,还支持 workload identity federation。
触发逻辑
这是我觉得设计得比较省心的地方:Action 会根据 workflow 上下文自动判断什么时候该激活,不用你手动切模式。三种典型触发:评论里 @claude、Issue 被指派给 Claude、定时任务这类带明确 prompt 的自动化。
v1.0 把配置简化成两个输入:prompt 和 claude_args,对齐 Claude Code SDK 的用法。还在用 v0.x 的,官方有迁移指南(docs/migration-guide.md),说大部分现有配置是兼容的。
官方给的六个玩法
docs/solutions.md 里有完整可运行的示例,我挑几个说一下:
自动 PR review:每个 PR 进来自动过一遍审查,不用人盯着。
按路径触发:只有关键目录的文件变了才触发 review。省 token,也少噪音。我觉得这是实际团队最该先用的一个,把审查范围限定在支付、鉴权这类出不起错的地方。
外部贡献者特殊处理:对新贡献者的 PR 检查得更细。
自定义审查清单:把团队规范写成 checklist,让 Claude 逐条核对。代码风格、测试覆盖要求这类硬规矩,机器查比人查稳定。
定时维护:定期跑仓库健康检查。
Issue 分诊:自动打标签、归类。
我的建议
起步别急着让 AI 写代码。它的权限从 review 类场景开始最稳:只读、只评论,出了问题也就是一条不太准的建议。跑一段时间,确认 review 质量稳定,再逐步放开实现类任务。权限放开的节奏,取决于你对仓库的保护需求。
另外一个细节:定时任务这类自动化场景没有 @claude mention 可依赖,必须在 prompt 里把任务说清楚,别指望它猜。
云厂商配置和迁移细节都散在 docs/ 目录里,README 只给了入口,装之前值得把这个目录翻一遍。