Claude Code GitHub Actions

Claude Code を開発ワークフローに統合する Claude Code GitHub Actions について学びます

Claude Code GitHub Actions は、GitHub ワークフローに AI を活用した自動化をもたらします。任意の PR またはイシューで @claude とメンションするだけで、Claude はコードを分析し、プルリクエストを作成し、機能を実装し、バグを修正できます。すべてプロジェクトの標準に従いながら実行されます。すべての PR に自動的に投稿されるレビューについては、GitHub Code Review を参照してください。

Claude Code GitHub Actions を使用する理由

• 即座の PR 作成: 必要なことを説明すると、Claude は必要なすべての変更を含む完全な PR を作成します
• 自動コード実装: イシューを 1 つのコマンドで動作するコードに変換します
• 標準に従う: Claude は CLAUDE.md ガイドラインと既存のコードパターンを尊重します
• シンプルなセットアップ: インストーラーと API キーで数分で開始できます
• デフォルトで安全: コードは Github のランナーに留まります

Claude は何ができますか？

Claude Code は、コードの操作方法を変える強力な GitHub Action を提供します。

Claude Code Action

この GitHub Action により、GitHub Actions ワークフロー内で Claude Code を実行できます。Claude Code の上に任意のカスタムワークフローを構築するために使用できます。

リポジトリを表示 →

セットアップ

クイックセットアップ

Claude Code ターミナルで /install-github-app を実行して、統合をインタラクティブにセットアップします。このコマンドは Claude GitHub App をリポジトリにインストールし、GitHub Actions ワークフローと API キーシークレットの追加をガイドします。

GitHub App がインストールされた後、コマンドは GitHub Actions セットアップを続行するかどうかを尋ねます。Claude Code v2.1.187 以降では、Skip for now を選択して App のインストールのみで停止し、後で /install-github-app を再度実行してワークフローとシークレットのステップに戻ることができます。以前のバージョンではワークフロー選択に直接進みます。

手動セットアップ

/install-github-app コマンドが失敗した場合、または手動セットアップを希望する場合は、以下の手動セットアップ手順に従ってください。

1. Claude GitHub アプリをリポジトリにインストール: https://github.com/apps/claude

   Claude GitHub アプリには、以下のリポジトリアクセス許可が必要です。

   • Contents: 読み取りと書き込み（リポジトリファイルを変更するため）
   • Issues: 読み取りと書き込み（イシューに応答するため）
   • Pull requests: 読み取りと書き込み（PR を作成して変更をプッシュするため）

   セキュリティとアクセス許可の詳細については、セキュリティドキュメント を参照してください。

2. ANTHROPIC_API_KEY をリポジトリシークレットに追加 (GitHub Actions でシークレットを使用する方法を学ぶ)

3. ワークフローファイルをコピー examples/claude.yml からリポジトリの .github/workflows/ にコピーします

ベータ版からのアップグレード

現在 Claude Code GitHub Actions のベータ版を使用している場合は、ワークフローを GA バージョンを使用するように更新することをお勧めします。新しいバージョンは、自動モード検出などの強力な新機能を追加しながら、設定を簡素化します。

重要な変更

すべてのベータユーザーは、アップグレードするためにワークフローファイルで以下の変更を行う必要があります。

1. アクションバージョンを更新: @beta を @v1 に変更します
2. モード設定を削除: mode: "tag" または mode: "agent" を削除します（現在は自動検出）
3. プロンプト入力を更新: direct_prompt を prompt に置き換えます
4. CLI オプションを移動: max_turns、model、custom_instructions などを claude_args に変換します

破壊的な変更リファレンス

前後の例

ベータ版:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Follow our coding standards"
    max_turns: "10"
    model: "claude-sonnet-5"

GA バージョン（v1.0）:

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-5

使用例

Claude Code GitHub Actions は、さまざまなタスクに役立ちます。examples ディレクトリ には、さまざまなシナリオ用の使用可能なワークフローが含まれています。

基本的なワークフロー

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 }}
          # Responds to @claude mentions in comments

skills を使用する

prompt 入力は、skill の呼び出しだけでなく、プレーンテキストも受け入れます。

• リポジトリの .claude/skills/ ディレクトリ内のスキルの場合、アクションステップの前に actions/checkout を実行し、/skill-name を渡します。
• プラグインにパッケージされたスキルの場合、plugin_marketplaces および plugins 入力でプラグインをインストールし、名前空間付きの /plugin-name:skill-name を渡します。

次のワークフローは、code-review プラグインをインストールし、新規または更新されたプルリクエストごとにそのスキルを実行します。

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 }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

プロンプトを使用したカスタム自動化

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: "Generate a summary of yesterday's commits and open issues"
          claude_args: "--model opus"

一般的な使用例

イシューまたは PR コメント内：

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component

Claude は自動的にコンテキストを分析し、適切に応答します。

ベストプラクティス

CLAUDE.md 設定

リポジトリルートに CLAUDE.md ファイルを作成して、コードスタイルガイドライン、レビュー基準、プロジェクト固有のルール、および推奨パターンを定義します。このファイルは、Claude のプロジェクト標準の理解をガイドします。

セキュリティに関する考慮事項

アクセス許可、認証、ベストプラクティスを含む包括的なセキュリティガイダンスについては、Claude Code Action セキュリティドキュメント を参照してください。

常に GitHub Secrets を API キーに使用します。

• API キーを ANTHROPIC_API_KEY という名前のリポジトリシークレットとして追加します
• ワークフローで参照します: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
• アクションのアクセス許可を必要なものだけに制限します
• マージする前に Claude の提案を確認します

常に GitHub Secrets（例えば、${{ secrets.ANTHROPIC_API_KEY }}）を使用し、API キーをワークフローファイルに直接ハードコードしないでください。

パフォーマンスの最適化

イシューテンプレートを使用してコンテキストを提供し、CLAUDE.md を簡潔で焦点を絞ったものに保ち、ワークフローに適切なタイムアウトを設定します。

CI コスト

Claude Code GitHub Actions を使用する場合、関連するコストに注意してください。

GitHub Actions コスト:

• Claude Code は GitHub ホストランナーで実行され、GitHub Actions の分を消費します
• 詳細な価格設定と分の制限については、GitHub の請求ドキュメント を参照してください

API コスト:

• 各 Claude インタラクションは、プロンプトと応答の長さに基づいて API トークンを消費します
• トークン使用量は、タスクの複雑さとコードベースのサイズによって異なります
• 現在のトークンレートについては、Claude の価格ページ を参照してください

コスト最適化のヒント:

• 特定の @claude コマンドを使用して、不要な API 呼び出しを減らします
• claude_args で適切な --max-turns を設定して、過度な反復を防ぎます
• ワークフローレベルのタイムアウトを設定して、暴走ジョブを回避します
• GitHub の並行制御を使用して、並列実行を制限することを検討します

設定例

Claude Code Action v1 は、統一されたパラメータで設定を簡素化します。

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: "Your instructions here" # Optional
    claude_args: "--max-turns 5" # Optional CLI arguments

主な機能：

• 統一されたプロンプトインターフェース - すべての指示に prompt を使用します
• Skills - インストール済みの skills をプロンプトから直接呼び出します
• CLI パススルー - claude_args 経由の任意の Claude Code CLI 引数
• 柔軟なトリガー - 任意の GitHub イベントで動作します

完全なワークフローファイルについては、examples ディレクトリ を参照してください。

Amazon Bedrock と Google Cloud での使用

エンタープライズ環境では、Claude Code GitHub Actions を独自のクラウドインフラストラクチャで使用できます。このアプローチにより、データレジデンシーと請求を制御しながら、同じ機能を維持できます。

前提条件

クラウドプロバイダーで Claude Code GitHub Actions をセットアップする前に、以下が必要です。

Google Cloud の Agent Platform の場合：

1. Google Cloud の Agent Platform が有効な Google Cloud プロジェクト
2. GitHub Actions 用に設定された Workload Identity Federation
3. 必要なアクセス許可を持つサービスアカウント
4. GitHub App（推奨）または デフォルトの GITHUB_TOKEN を使用

Amazon Bedrock の場合：

1. Amazon Bedrock が有効な AWS アカウント
2. AWS で設定された GitHub OIDC Identity Provider
3. Amazon Bedrock アクセス許可を持つ IAM ロール
4. GitHub App（推奨）または デフォルトの GITHUB_TOKEN を使用

name: Claude PR Action

permissions:
contents: write
pull-requests: write
issues: write
id-token: write

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]

jobs:
claude-pr:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
runs-on: ubuntu-latest
env:
AWS_REGION: us-west-2
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Generate GitHub App token
id: app-token
uses: actions/create-github-app-token@v2
with:
app-id: ${{ secrets.APP_ID }}
private-key: ${{ secrets.APP_PRIVATE_KEY }}

- name: Configure AWS Credentials (OIDC)
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
aws-region: us-west-2

- uses: anthropics/claude-code-action@v1
with:
github_token: ${{ steps.app-token.outputs.token }}
use_bedrock: "true"
claude_args: '--model us.anthropic.claude-sonnet-4-6 --max-turns 10'

name: Claude PR Action

permissions:
contents: write
pull-requests: write
issues: write
id-token: write

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]

jobs:
claude-pr:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Generate GitHub App token
id: app-token
uses: actions/create-github-app-token@v2
with:
app-id: ${{ secrets.APP_ID }}
private-key: ${{ secrets.APP_PRIVATE_KEY }}

- name: Authenticate to Google Cloud
id: auth
uses: google-github-actions/auth@v2
with:
workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

- uses: anthropics/claude-code-action@v1
with:
github_token: ${{ steps.app-token.outputs.token }}
trigger_phrase: "@claude"
use_vertex: "true"
claude_args: '--model claude-sonnet-4-5@20250929 --max-turns 10'
env:
ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
CLOUD_ML_REGION: us-east5
VERTEX_REGION_CLAUDE_4_5_SONNET: us-east5

トラブルシューティング

Claude が @claude コマンドに応答しない

GitHub App が正しくインストールされていることを確認し、ワークフローが有効になっていることを確認し、API キーがリポジトリシークレットに設定されていることを確認し、コメントに @claude が含まれていることを確認します（/claude ではなく）。

CI が Claude のコミットで実行されない

GitHub App またはカスタムアプリを使用していることを確認します（Actions ユーザーではなく）、ワークフロートリガーに必要なイベントが含まれていることを確認し、アプリのアクセス許可に CI トリガーが含まれていることを確認します。

認証エラー

API キーが有効で十分なアクセス許可があることを確認します。Amazon Bedrock または Google Cloud の Agent Platform の場合、認証情報の設定を確認し、シークレットがワークフロー内で正しく名前付けされていることを確認します。

高度な設定

アクションパラメータ

Claude Code Action v1 は、簡素化された設定を使用します。

*プロンプトはオプションです。イシュー/PR コメントで省略された場合、Claude はトリガーフレーズに応答します
**直接 Claude API に必要です。Amazon Bedrock または Google Cloud の Agent Platform には不要です

CLI 引数を渡す

claude_args パラメータは、任意の Claude Code CLI 引数を受け入れます。

claude_args: "--max-turns 5 --model claude-sonnet-5 --mcp-config /path/to/config.json"

一般的な引数：

• --max-turns: 最大会話ターン数（デフォルト：10）
• --model: 使用するモデル（例：claude-sonnet-5）
• --mcp-config: MCP 設定へのパス
• --allowedTools: 許可されたツールのカンマ区切りリスト。--allowed-tools エイリアスも機能します。
• --debug: デバッグ出力を有効にします

代替統合方法

/install-github-app コマンドは推奨されるアプローチですが、以下も実行できます。

• カスタム GitHub App: ブランド化されたユーザー名またはカスタム認証フローが必要な組織向け。必要なアクセス許可（contents、issues、pull requests）を持つ独自の GitHub App を作成し、actions/create-github-app-token アクションを使用してワークフロー内でトークンを生成します。
• 手動 GitHub Actions: 最大の柔軟性のための直接ワークフロー設定
• MCP 設定: Model Context Protocol サーバーの動的読み込み

詳細なガイドについては、Claude Code Action ドキュメント を参照してください。認証、セキュリティ、高度な設定に関する詳細なガイドがあります。

Claude の動作をカスタマイズ

Claude の動作は 2 つの方法で設定できます。

1. CLAUDE.md: リポジトリのルートに CLAUDE.md ファイルを作成して、コーディング標準、レビュー基準、プロジェクト固有のルールを定義します。Claude は PR を作成し、リクエストに応答するときにこれらのガイドラインに従います。詳細については、Memory ドキュメント を確認してください。
2. カスタムプロンプト: ワークフローファイルの prompt パラメータを使用して、ワークフロー固有の指示を提供します。これにより、異なるワークフローまたはタスク用に Claude の動作をカスタマイズできます。

Claude は PR を作成し、リクエストに応答するときにこれらのガイドラインに従います。