SupaStore

返回博客列表

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 自动改代码与 PR 审查教程(2026)

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:

不要把 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 费用。控制方法:

  1. 用 --max-turns 限制每次任务的最大轮数;
  2. 给工作流设置 timeout-minutes 和并发限制;
  3. 保持 CLAUDE.md 精简,它每次运行都会被读取;
  4. 中转站的 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 限制可用工具,例如只允许读取文件和发表评论的工具,不授予编辑和执行命令的权限。