Claude Code GitHub Actions 怎么配置?@claude 自动改代码与 PR 审查教程(2026)
Claude Code GitHub Actions 怎么配置?本文讲清 /install-github-app 快速安装与手动配置步骤,给出 claude-code-action@v1 工作流示例,演示在 Issue 和 PR 中 @claude 自动改代码、自动 PR 审查与定时任务,并附 claude_args 参数、费用控制与安全设置。
SupaStore 开发者体验组 ·

Claude Code GitHub Actions 能让 Claude 直接在你的 GitHub 仓库里干活:在 Issue 或 PR 评论里写一句 @claude 修复这个 bug,它就会读代码、改文件、提交分支并回复结果。它基于官方的 anthropics/claude-code-action,一个工作流文件就能配好。
本文讲清 Claude Code GitHub Actions 的两种安装方式、工作流写法、常用参数,以及自动 PR 审查、定时任务、费用控制和安全设置。本地 Claude Code 的用法见《Claude Code 教程:2026 Claude Code 安装与使用指南》。
Claude Code GitHub Actions 能做什么
- @claude 改代码:在 Issue 里描述需求,@claude 后它会创建分支、实现功能并开 PR;
- 修 bug、回答问题:在 PR 评论里 @claude,让它解释代码、修复评审意见指出的问题;
- 自动 PR 审查:每次有新 PR 时自动审查代码,把意见写成评论;
- 定时任务:按 cron 定时运行,例如每天汇总新 Issue、检查依赖更新。
Claude 会读取仓库里的 CLAUDE.md,按你的项目规范写代码,写法见《CLAUDE.md 怎么写?》。
方法一:/install-github-app 快速安装
在仓库目录下启动 Claude Code,输入:
/install-github-app
它会一步步完成:安装 Claude GitHub App、把 API Key 保存为仓库的 Secret、推送一个包含工作流文件的分支,并开一个 PR 等你合并。
使用前提:
- 你需要是该仓库的管理员;
- 仓库必须托管在 github.com;
- 本机已安装并登录 GitHub CLI(
gh auth login)。
方法二:手动配置
第一步:安装 Claude GitHub App
打开 github.com/apps/claude,把 App 安装到目标仓库。它需要 Contents、Issues、Pull requests 的读写权限。
第二步:添加 API Key Secret
在仓库的 Settings → Secrets and variables → Actions 中新建 Secret:
- 名称:
ANTHROPIC_API_KEY - 值:你的 Claude API Key(获取方法见《Claude API Key 怎么获取?》)
不要把 Key 直接写进工作流文件,否则会随代码一起公开。
第三步:添加工作流文件
新建 .github/workflows/claude.yml:
name: Claude Code
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
jobs:
claude:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
issues: write
id-token: write
actions: read
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 1
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
提交后,在任意 Issue 或 PR 里评论 @claude 你好,几十秒后 Claude 就会回复。permissions 里的 actions: read 让 Claude 能读取 CI 结果,排查失败的测试。
claude-code-action 常用参数
| 参数 | 作用 |
|---|---|
anthropic_api_key |
API Key,从 Secret 读取 |
prompt |
固定的任务指令;不填时等待评论里的 @claude |
claude_args |
传给 Claude Code 的命令行参数,如模型、最大轮数 |
trigger_phrase |
触发词,默认 @claude |
label_trigger |
给 Issue 打上该标签时触发,默认 claude |
settings |
Claude Code 的配置(JSON 字符串或文件路径) |
模型和最大轮数不是单独的参数,要写在 claude_args 里:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
claude_args: "--max-turns 10 --model claude-sonnet-5-5"
从旧版 @beta 升级时注意:direct_prompt 改名为 prompt,model、max_turns 移到了 claude_args 里。模型别名和 ID 的说明见《Claude Code 怎么切换模型?》。
自动 PR 审查与定时任务
每个新 PR 自动审查
把触发事件改成 pull_request,并给出固定的 prompt,Claude 就会在每次有新 PR 时自动运行,不需要 @:
on:
pull_request:
types: [opened, synchronize]
prompt 里写清审查重点,例如"检查这个 PR 的正确性、安全问题和缺失的测试,用中文写评论"。
定时任务
on:
schedule:
- cron: "0 9 * * *"
配合 prompt,可以每天自动整理新 Issue、生成周报等。注意:定时工作流只在默认分支上运行,公开仓库 60 天没有活动时,GitHub 会自动停用定时任务。
通过中转站使用 Claude Code GitHub Actions
官方文档没有专门说明自定义接口地址。从 claude-code-action 的 action.yml 源码看,它会把工作流 env 中的 ANTHROPIC_BASE_URL 传给 Claude Code,并建议写在 job 级别的 env 里:
jobs:
claude:
runs-on: ubuntu-latest
env:
ANTHROPIC_BASE_URL: ${{ secrets.ANTHROPIC_BASE_URL }}
steps:
# ...同上
ANTHROPIC_BASE_URL 填写与本地 Claude Code 相同的中转地址(配置方法见《Claude API 中转怎么用?国内 Claude Code 中转站配置教程》),ANTHROPIC_API_KEY 换成中转站的 Key。这属于源码中的行为而不是文档承诺,升级 action 版本后建议先在测试仓库验证一次。
费用控制与安全设置
费用:每次运行会同时消耗 GitHub Actions 的运行时长和 API 的 Token 费用。控制方法:
- 用
--max-turns限制每次任务的最大轮数; - 给工作流设置
timeout-minutes和并发限制; - 保持
CLAUDE.md精简,它每次运行都会被读取; - 中转站的 Key 设置额度上限,在使用日志里按 Key 查看消耗。
更多省 Token 的方法见《Claude Code Token 消耗太快?10 个省 Token 技巧》。
安全:
- API Key 只放在 GitHub Secrets 中;
- 工作流的
permissions只给需要的权限; - 只有对仓库有写权限的用户才能触发 Claude,机器人账号默认被拒绝;
- Claude 提交的代码和人写的一样,合并前务必审查。
常见问题 (FAQ)
Q: Claude Code GitHub Actions 收费吗?
答: action 本身免费开源,但每次运行会消耗 API 的 Token 费用,以及 GitHub Actions 的运行时长(私有仓库超出免费额度后按分钟计费)。
Q: 可以用 Claude 订阅代替 API Key 吗?
答: 可以。官方文档支持用 claude setup-token 生成的 CLAUDE_CODE_OAUTH_TOKEN 代替 API Key,此时消耗的是订阅额度。
Q: @claude 没有反应怎么办?
答: 依次检查:Claude GitHub App 是否安装到了该仓库、ANTHROPIC_API_KEY Secret 是否存在、工作流文件是否已合并到默认分支、评论者是否有仓库写权限,以及 Actions 页面里的运行日志。
Q: 如何让 Claude 只审查不改代码?
答: 在 prompt 中明确要求只写评论,并通过 claude_args 限制可用工具,例如只允许读取文件和发表评论的工具,不授予编辑和执行命令的权限。