你能想象这样的场景吗？在 GitHub issue 中留下一条评论——「@claude 把这个功能实现了」，几分钟后，一个包含完整代码和说明文档的 PR 就已经躺在仓库里。整个过程你甚至无需打开编辑器。这听起来像极客的幻想，但它正是 Anthropic 官方推出的 Claude Code GitHub Actions 所实现的功能。
我自己的开源项目 cc-statistics——一个专门统计 Claude Code 使用量的轻量级小工具，目前大概有 100 多个 star——已经部署了这套机制。本文就来拆解：它到底能为你完成什么、如何安装、开销多少、存在哪些问题。教程部分我会尽量提供可以直接拿来用的内容。
一、它能帮你处理的，可以归纳为以下几类
配置完成后，触发方式非常简单：在 issue、PR 或 code review 的评论里 @claude，接着写一句话说明你的需求。它会自动读取上下文、完成任务、把结果推送回来，全程你几乎不需要离开 GitHub 的网页界面。
具体来说：
- 把 issue 变成 PR：在 issue 中写「@claude 按这个需求实现一版」，它就会分析代码库，编写代码，然后创建一个完整的 PR。
- 审查 PR：在 PR 里写「@claude 审查一下有没有安全问题」，它能逐行查看改动，给出评论。
- 根据你的 review 意见修改：你回复它 PR 中的某条建议，它能理解上下文，然后直接修改代码。
- 回答代码库相关问题：提问「@claude 这块鉴权应该怎么加」，它会读取你的代码后再作答，而不是凭空猜测。
有一点需要提前说明：它完全遵循你仓库里的 CLAUDE.md。只要你在里面写清编码规范、目录约定、哪些文件不能碰，它执行任务时就会严格参照。这也正是它比那种「让一个完全不了解你项目的 AI 去写代码」更可靠的原因。
二、安装它，其实只要三步
最省事的路径：在你的本地 Claude Code 终端中执行一条命令。
/install-github-app
这条命令会自动帮你完成三件事：把 Claude 的 GitHub App 安装到指定仓库、引导你添加 ANTHROPIC_API_KEY 这个 secret、把 workflow 文件放进项目中。前提是你拥有这个仓库的管理员权限。
如果这条命令执行不成功，手动安装也只需要三步：
- 安装 GitHub App：打开 github.com/apps/claude，点击 Install，授权 Contents、Issues、Pull requests 的读写权限。
- 加密钥：进入仓库的 Settings → Secrets and variables → Actions，新建一个
ANTHROPIC_API_KEY，值填入你从控制台获取的 API key。 - 放置 workflow：在仓库中创建
.github/workflows/claude.yml文件。
我给我的 cc-statistics 使用的 workflow，核心部分其实很简单（参考官方 v1 示例）：
name: Claude
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]
jobs:
claude:
if: contains(github.event.comment.body, '@claude') || contains(github.event.issue.body, '@claude')
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
issues: write
id-token: write
actions: read
steps:
- uses: actions/checkout@v6
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
安装完成后，只要提交这个文件就会生效。之后你在任意 issue 或 PR 的评论里 @claude，GitHub Actions 就会自动拉起一个任务去执行。
三、我打算如何用它
具体到 cc-statistics 这个项目，有几个特别实用的场景：
- 有人提 issue 说「希望能把统计结果导出成 CSV」。我不用立刻动手写代码，直接在 issue 里 @claude「按这个需求加一个导出 CSV 的命令，跟着现有的输出格式走」，让它先出一版 PR，然后我来审查。
- 收到一个社区提交的 PR，我懒得逐行细看，就先 @claude「审查这个 PR，重点看看有没有破坏现有命令的行为」，让它把明显的隐患挑出来，我再做最终判断。
- 自己发现了一个小 bug，比如某个统计口径算错了，直接开一个 issue，然后 @claude「定位并修复这个计算错误，再加个测试」。
必须强调的是，它并不是让你当甩手掌柜。它最擅长做的，是把「从 issue 到一版能看的 PR」这段最消耗启动成本的工作接过去，让你从「从零写代码」变为「审一版代码」。
四、钱和权限，先算清楚再动手
这套机制不是免费的魔法，有两笔账需要心里有数：
- GitHub Actions 分钟：它运行在你的 Actions runner 上，消耗的是你的 Actions 配额。免费账户每月有 2000 分钟，对于个人项目来说通常够用。
- API token：每次 @claude 都意味着一份真实的模型调用，按 token 计费到你的 Anthropic 账户。任务越复杂、迭代次数越多，花费自然就越大。
权限方面，它需要 Contents、Issues、Pull requests 的读写权限。还有一个关键点：它不会自动 merge。它只负责把 PR 开好，最后合不合并、什么时候合并，由你和你的分支保护规则决定。这一点让我用得比较安心——AI 做初版，人做决策。
五、几个必须了解的边界
- 安装 App 和添加 secret 都需要仓库管理员权限，普通协作者是无法完成的。
- API key 必须走 GitHub Secrets，绝对不要硬编码进代码或 workflow 文件中。
- 如果想控制成本，可以在
claude_args里加--max-turns，限制它来回折腾的次数，同时给 workflow 设置一个超时时间。 - 它运行在你的 CI 环境里，能够读取该环境中的内容。不要把不该给的密钥塞进这个 workflow 的环境变量中。
- 目前还没有「零配置、纯托管」的版本，标准部署方式就是自建 Actions workflow 加自己的 key。官方 GA 的 v1.0 版本是 2025 年 8 月发布的，能够自动识别你是要它评论还是要它写代码，无需手动配置模式。
六、进阶玩法：官方提供了很多现成的 workflow
如果你觉得基础版的 @claude 不够用，别急，官方仓库 anthropics/claude-code-action 的 examples 目录里还有好几个即插即用的模板：
ci-failure-auto-fix.yml：CI 挂掉后自动让 Claude 去修复。issue-triage.yml：新 issue 进来自动打标签、归类。pr-review-comprehensive.yml：每个 PR 自动过一轮 review。issue-deduplication.yml：自动查找重复的 issue。
对于一个人维护的开源项目来说，这几个 workflow 能把不少重复的社区维护工作自动化。建议从你最头疼的那件事开始尝试。
收尾
@claude 这套机制的核心价值，并不在于「让 AI 替你写代码」，而在于把开源维护中最枯燥的那个环节——从 issue 到一版初稿 PR、逐一过每个 PR——交出去，而最终拍板的始终是你。
当一个人维护项目时，这套方案尤其划算：你扛不住一大堆 issue，但你完全扛得住「审一版」。把启动成本交给它，把判断留给自己。
想上手？本地 Claude Code 里执行一条命令就搞定了：/install-github-app。
项目地址：github.com/androidZzT/cc-statistics ｜ 官方文档：code.claude.com/docs/en/github-actions
