您的位置: 首页> 开发工具

Claude Code GitHub Actions 使用教程

匿名上传

发布时间:2026-03-04 14:18:01

Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具，也被称为世界最强编程 Agent 之一。Claude Code GitHub Actions 可以将 AI 编程能力集成到你的 GitHub 工作流中，只需在 PR 或 Issue 中 @claude，即可让 Claude 自动分析代码、创建 PR、实现功能、修复 Bug。

本文档主要介绍如何通过 AceData Cloud 的代理服务，配置和使用 Claude Code GitHub Actions。

申请流程

要使用 Claude Code，首先可以到 Claude Messages 服务页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 Claude Code 服务。

功能特点

即时创建 PR：描述需求，Claude 自动创建完整的 Pull Request
自动实现代码：在 Issue 中 @claude，将 Issue 转化为可运行代码
遵循项目规范：自动读取 CLAUDE.md，遵循你的代码风格和项目规范
安全可靠：代码运行在 GitHub 的 Runner 上，数据安全有保障

配置步骤

步驤一：安装 Claude GitHub App

前往 github.com/apps/claude 将 Claude GitHub App 安装到你的仓库。

该 App 需要以下仓库权限：

权限	级别	说明
Contents	Read & Write	修改仓库文件
Issues	Read & Write	响应 Issue
Pull requests	Read & Write	创建 PR 和推送变更

步骤二：添加 API 密钥

将 AceData Cloud 的 API 密钥添加为仓库 Secret：

进入仓库 Settings → Secrets and variables → Actions
点击 New repository secret
Name 填写 ANTHROPIC_API_KEY，Value 填入你在 AceData Cloud 获取的 API 令牌
点击 Add secret 保存

步骤三：创建 Workflow 文件

在仓库中创建 .github/workflows/claude.yml 文件：

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

如果需要使用 AceData Cloud 的代理 API 端点，还需要在 Workflow 中设置环境变量：

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 }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

使用方式

在 Issue 或 PR 评论中使用

配置完成后，在任何 Issue 或 PR 的评论中 @claude，Claude 就会自动响应：

@claude 根据这个 Issue 的描述实现功能
@claude 审查这个 PR 的代码安全性
@claude 修复 user dashboard 组件中的 TypeError
@claude 这个端点的用户认证应该怎么实现？

自动代码审查

创建一个在 PR 打开时自动执行代码审查的 Workflow：

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

定时任务自动化

创建定时执行的自动化任务：

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "生成昨天的提交摘要和未关闭 Issue 的报告"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Action 参数说明

参数	说明	必填
`anthropic_api_key`	API 密钥	是
`prompt`	给 Claude 的指令（文本或 Skill 如 `/review`）	否
`claude_args`	传递给 Claude Code CLI 的参数	否
`github_token`	GitHub Token	否
`trigger_phrase`	自定义触发短语（默认 `@claude`）	否

claude_args 常用参数

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

参数	说明
`--max-turns`	最大对话轮次（默认 10）
`--model`	使用的模型
`--mcp-config`	MCP 配置文件路径
`--allowed-tools`	允许的工具（逗号分隔）
`--debug`	启用调试输出