Claude Code GitHub Actions 完全接入指南（v1.0 GA 版）：自动 PR 与 CI/CD 集成

Claude Code GitHub Actions 已从 Beta 升级为 v1.0 正式版，把 AI 驱动的自动化能力带入你的 GitHub 工作流。只需在 PR 或 Issue 中 @claude 一下，Claude 就能分析代码、创建 PR、实现功能、修复 Bug——全程遵循你项目的编码规范。本文提供完整的接入和迁移指南。

核心能力#

• 即时创建 PR：描述需求，Claude 创建包含所有必要改动的完整 PR
• 自动化代码实现：一条命令把 Issue 转化为可运行的代码
• 遵循项目规范：Claude 尊重你的 CLAUDE.md 指引和现有代码模式
• 快速搭建：用官方安装器和 API Key，几分钟即可上手
• 默认安全：代码始终留在 GitHub 的 Runner 上运行

快速搭建（推荐方式）#

在 Claude Code 终端中运行以下命令，交互式完成集成设置：

/install-github-app

该命令会安装 Claude GitHub App 到你的仓库，然后引导你添加 GitHub Actions 工作流和 API Key Secret。

v2.1.187 及以上版本：GitHub App 安装完成后，命令会询问是否继续设置 GitHub Actions，此时可以选择「Skip for now」（稍后跳过），之后再次运行 /install-github-app 可以回到工作流和 Secret 设置步骤。早期版本会直接进入工作流选择环节。

手动搭建方式#

如果 /install-github-app 命令失败，或者你更倾向于手动配置，按以下步骤操作：

1. 安装 Claude GitHub App 到你的仓库：https://github.com/apps/claude

需要以下仓库权限：

• Contents：读写（修改仓库文件）
• Issues：读写（响应 Issue）
• Pull requests：读写（创建 PR 并推送改动）

2. 添加 ANTHROPIC_API_KEY 到仓库 Secrets 中

3. 复制工作流文件 examples/claude.yml 到你仓库的 .github/workflows/ 目录

从 Beta 升级到 v1.0（重要变更）#

如果你之前使用的是 Beta 版本，强烈建议升级到 GA 版本，新版本简化了配置，并增加了自动模式检测等强大新功能。

必须做的迁移改动#

迁移前后对比#

Beta 版本写法：

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Follow our coding standards"
    max_turns: "10"
    model: "claude-sonnet-5"

GA 版本（v1.0）写法：

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-5

实战示例#

基础工作流：响应 @claude 提及#

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # 响应评论中的 @claude 提及

结合 Skills 使用#

prompt 输入既可以是纯文本，也可以是 Skill 调用：

• 仓库中 .claude/skills/ 目录里的 Skill：需要在动作步骤前运行 actions/checkout，然后传入 /skill-name
• 插件中打包的 Skill：通过 plugin_marketplaces 和 plugins 输入安装插件，传入带命名空间的 /plugin-name:skill-name

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          plugin_marketplaces: anthropics/claude-plugins-official
          plugins: code-review
          prompt: "/code-review"
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

总结#

Claude Code GitHub Actions v1.0 大幅简化了 CI/CD 中集成 AI 编程助手的方式：自动模式检测、统一的 claude_args 参数、可复用的 Skill 调用体系。如果还在用 Beta 版本，按上表逐项迁移即可，整个过程通常只需几分钟。

来源：Claude Code GitHub Actions — Anthropic 官方文档