在 GitHub 上 @一下 claude：它自己把 issue 改成 PR

你在一个 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 一下有没有安全问题」，它逐行看改动，给评论。
• 按你的 review 意见改：你回复它 PR 里的某条建议，它理解上下文，直接改。
• 回答代码库问题：「@claude 这块鉴权应该怎么加」，它读你的代码再答，不是空对空。

有一点要先说清楚：它遵守你仓库里的 CLAUDE.md。你把编码规范、目录约定、别碰哪些文件写进去，它干活时会照着来。这也是它比「让一个不了解你项目的 AI 写代码」靠谱的地方。

二、装它其实就三步

最省事的路子：在本地 Claude Code 里跑一条命令。

/install-github-app

它会自动做三件事：把 Claude 的 GitHub App 装到你选的仓库、引导你添加 ANTHROPIC_API_KEY 这个 secret、把 workflow 文件放进去。前提是你得是这个仓库的管理员。

如果那条命令没跑通，手动装也就三步：

1. 装 GitHub App：打开 github.com/apps/claude，点 Install，授权 Contents、Issues、Pull requests 的读写。
2. 加密钥：仓库 Settings → Secrets and variables → Actions，新建一个 ANTHROPIC_API_KEY，值填你从控制台拿的 API key。
3. 放 workflow：在仓库里建 .github/workflows/claude.yml。

我给 cc-statistics 用的 workflow，核心就这么点（照官方 v1 示例）：

name: Claude Codeon: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-latestpermissions:contents: writepull-requests: writeissues: writeid-token: writeactions: read # 让它能读 CI 结果steps:- uses: actions/checkout@v6- uses: anthropics/claude-code-action@v1with:anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

装完提交这个文件就生效了。之后你在任意 issue / PR 评论里 @claude，GitHub Actions 就会拉起一个任务去跑。

三、我会怎么用它

放到 cc-statistics 这种项目上，几个真实场景：

• 有人提 issue 说「希望能把统计结果导出成 CSV」。我不用马上动手，直接在 issue 里 @claude「按这个需求加一个导出 CSV 的命令，跟着现有输出格式走」，让它先出一版 PR，我再审。
• 收到一个社区 PR，我懒得逐行看，先 @claude「review 这个 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。

对一个人维护的开源项目，这几个能把不少重复的社区维护动作自动化。挑你烦的那个先上。

收尾

@claude 这套东西的价值，不在于「让 AI 替你写代码」，而在于把开源维护里最枯燥的那段——从 issue 到一版初稿 PR、给每个 PR 过一遍眼——交出去，而最后拍板的还是你。

一个人维护项目尤其划算：你扛不住一堆 issue，但你扛得住「审一版」。把启动成本交给它，把判断留给自己。

想上手就一条命令：本地 Claude Code 里 /install-github-app。

项目地址：github.com/androidZzT/cc-statistics ｜ 官方文档：code.claude.com/docs/en/github-actions