Claude Code GitHub Actions 使用教程

崔庆才丨静觅
0 阅读4分钟

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 安装到你的仓库。

GitHub Claude App 安装页面

该 App 需要以下仓库权限：

权限级别说明
ContentsRead & Write修改仓库文件
IssuesRead & Write响应 Issue
Pull requestsRead & Write创建 PR 和推送变更

步骤二：添加 API 密钥

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

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

提示：API 令牌可在 AceData Cloud 控制台 中查看。

步骤三：创建 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_keyAPI 密钥是
prompt给 Claude 的指令（文本或 Skill 如 /review）否
claude_args传递给 Claude Code CLI 的参数否
github_tokenGitHub Token否
trigger_phrase自定义触发短语（默认 @claude）否

claude_args 常用参数

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
参数说明
--max-turns最大对话轮次（默认 10）
--model使用的模型
--mcp-configMCP 配置文件路径
--allowed-tools允许的工具（逗号分隔）
--debug启用调试输出

最佳实践

配置 CLAUDE.md

在仓库根目录创建 CLAUDE.md 文件，定义代码风格指南、审查标准和项目规范，Claude 会自动遵循这些规则。

安全注意事项

  • 永远不要 将 API 密钥直接写在 Workflow 文件中
  • 始终使用 GitHub Secrets（如 ${{ secrets.ANTHROPIC_API_KEY }}）
  • 限制 Action 权限为最小必要范围
  • 在合并前人工审查 Claude 的建议

成本控制

  • 使用明确的 @claude 指令减少不必要的 API 调用
  • 配置合理的 --max-turns 限制对话轮次
  • 设置 Workflow 级别的超时时间
  • 使用 GitHub 的并发控制限制并行运行数

常见问题

Claude 没有响应 @claude 命令？

  1. 确认 Claude GitHub App 已正确安装
  2. 检查 Workflow 是否启用
  3. 确认 API 密钥已设置为仓库 Secret
  4. 确保评论中使用的是 @claude（非 /claude）

认证错误？

  1. 确认 API 密钥有效且有足够权限
  2. 检查 Secret 名称是否正确（ANTHROPIC_API_KEY）
  3. 如果使用了 ANTHROPIC_BASE_URL，确认 URL 正确

如何查看剩余额度？

登录 AceData Cloud 控制台，即可查看当前账户的剩余额度和使用情况。

了解更多

avatar
文章
阅读
粉丝