> ## 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** ツールであり、世界最強のプログラミングエージェントの一つとも言われています。Claude Code GitHub Actions は、AI プログラミング機能をあなたの GitHub ワークフローに統合することができ、PR または Issue で `@claude` と入力するだけで、Claude が自動的にコードを分析し、PR を作成し、機能を実装し、バグを修正します。

この文書では、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 上で実行され、データの安全が保証されます

## 設定手順

### ステップ1：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 の作成と変更のプッシュ |

### ステップ2：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) で確認できます。

### ステップ3：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 トークン                            | いいえ |
| `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)
* 📋 [ワークフローの例](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [AceData Cloud Claude Codeサービス](https://platform.acedata.cloud/documents/claude-messages)
* 💬 何か質問がある場合は、プラットフォームのカスタマーサポートにお問い合わせください