メインコンテンツへスキップ
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 サービスページ にアクセスし、「Acquire」ボタンをクリックして、リクエストに必要な資格情報を取得します: まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、Claude Code サービスを無料で体験できます。

機能特徴

  • 即時 PR 作成:要件を説明すると、Claude が自動的に完全な Pull Request を作成します
  • 自動コード実装:Issue 内で @claude と入力すると、Issue を実行可能なコードに変換します
  • プロジェクト規範の遵守:自動的に CLAUDE.md を読み取り、あなたのコードスタイルとプロジェクト規範に従います
  • 安全で信頼性が高い:コードは GitHub の Runner 上で実行され、データの安全が保証されます

設定手順

ステップ1:Claude GitHub App のインストール

https://github.com/apps/claude にアクセスし、Claude GitHub App をあなたのリポジトリにインストールします。 GitHub Claude App インストールページ この App には以下のリポジトリ権限が必要です:
権限レベル説明
ContentsRead & Writeリポジトリファイルの変更
IssuesRead & WriteIssue に応答
Pull requestsRead & WritePR の作成と変更のプッシュ

ステップ2:API キーの追加

AceData Cloud の API キーをリポジトリの Secret として追加します:
  1. リポジトリの SettingsSecrets and variablesActions に移動します
  2. New repository secret をクリックします
  3. Name に ANTHROPIC_API_KEY と入力し、Value に AceData Cloud で取得した API トークンを入力します
  4. Add secret をクリックして保存します
ヒント:API トークンは AceData Cloud コンソール で確認できます。

ステップ3: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 キーはい
promptClaude への指示(テキストまたは Skill 例:/reviewいいえ
claude_argsClaude Code CLI に渡すパラメータいいえ
github_tokenGitHub トークンいいえ
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コンソールにログインすると、現在のアカウントの残高と使用状況を確認できます。

詳しく知る