> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code GitHub Actions 使用教程

> Claude Code 集成指南 - Ace Data Cloud

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 服务页面](https://platform.acedata.cloud/documents/claude-messages) 点击「Acquire」按钮，获取请求所需要的凭证：

![](https://cdn.acedata.cloud/nyq0xz.png)

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

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

## 功能特点

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

## 配置步骤

### 步驟一：安装 Claude GitHub App

前往 [https://github.com/apps/claude](https://github.com/apps/claude) 将 Claude GitHub App 安装到你的仓库。

![GitHub Claude App 安装页面](https://cdn.acedata.cloud/ba4b8df66d.png)

该 App 需要以下仓库权限：

| 权限                | 级别           | 说明          |
| ----------------- | ------------ | ----------- |
| **Contents**      | Read & Write | 修改仓库文件      |
| **Issues**        | Read & Write | 响应 Issue    |
| **Pull requests** | Read & 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 控制台](https://platform.acedata.cloud/console) 中查看。

### 步驟三：创建 Workflow 文件

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

```yaml theme={null}
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 中设置环境变量：

```yaml theme={null}
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：

```yaml theme={null}
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"
```

### 定时任务自动化

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

```yaml theme={null}
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 常用参数

```yaml theme={null}
claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
```

| 参数                | 说明            |
| ----------------- | ------------- |
| `--max-turns`     | 最大对话轮次（默认 10） |
| `--model`         | 使用的模型         |
| `--mcp-config`    | MCP 配置文件路径    |
| `--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 控制台](https://platform.acedata.cloud/console)，即可查看當前帳戶的剩餘額度和使用情況。

## 了解更多

* 📖 [Claude Code GitHub Actions 官方文檔](https://code.claude.com/docs/en/github-actions)
* 📂 [claude-code-action 倉庫](https://github.com/anthropics/claude-code-action)
* 📋 [Workflow 示例](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [AceData Cloud Claude Code 服務](https://platform.acedata.cloud/documents/claude-messages)
* 💬 如有任何問題，歡迎透過平台客服聯繫我們