Claude Code GitHub Actions

• Code Review：ワークフローを記述せずに、すべてのプルリクエストで自動レビュー
• Claude Code in the cloud：クラウドインフラストラクチャで実行される Claude Code セッション（マシンではなく）
• Claude Agent SDK：GitHub Actions 外のカスタム自動化。Claude Code GitHub Action は SDK の上に構築されています
• GitHub Enterprise Server：自己ホスト型 GitHub での Claude Code

​

セットアップ

• クイックセットアップ：Claude Code から /install-github-app を実行します。Claude Code は GitHub App をインストールし、認証シークレットを追加し、ワークフロープルリクエストを準備します
• 手動セットアップ：アプリをインストールし、シークレットを追加し、ワークフローファイルをリポジトリにコピーします。Claude Code をローカルで実行しない場合、コマンドが失敗した場合、またはワークフローファイルを完全に制御したい場合は、このパスを使用します

​

クイックセットアップ

• Claude Code に既に API キーがある場合、そのキーを再利用し、リポジトリに既に設定されている既存の ANTHROPIC_API_KEY シークレットを保持することを提案します
• それ以外の場合は、Claude サブスクリプションで長期トークンを作成するか、API キーを貼り付けるかを選択します

• /install-github-app を再度実行します。リポジトリに既に claude.yml がある場合は、Update workflow file with latest version を選択します。Claude Code は新しいブランチにワークフローファイルの新しいコピーをプッシュし、最初のインストールと同じようにプルリクエストを開きます。
• レビューワークフロー例から --comment 引数と claude_args 行をチェックインファイルに自分で追加します。これにより、他の編集は保持されます。

​

手動セットアップ

​

組織向けセットアップ

• Claude GitHub App を組織レベルで 1 回インストールし、すべてのリポジトリまたは選択したリストを選択します
• 認証シークレットを組織レベルの Actions シークレットとして保存し、各リポジトリが独自のコピーを必要としないようにします
• Claude Code GitHub Action を実行する各リポジトリにワークフローファイルを追加するか、ジョブを 再利用可能なワークフロー として 1 回定義し、各リポジトリが呼び出すようにします

• anthropic_federation_rule_id：フェデレーションルール ID、fdrl_...
• anthropic_organization_id：Anthropic 組織 ID
• anthropic_service_account_id：サービスアカウント ID、svac_...。オプション。Console で作成するフェデレーションルールが既にサービスアカウントをターゲットしているため
• anthropic_workspace_id：ワークスペース ID、wrkspc_...。フェデレーションルールが単一のワークスペースをターゲットしている場合はオプション

​

アンインストール

• ワークフローファイル：.github/workflows/ から anthropics/claude-code-action を使用するワークフローを削除します。クイックセットアップを使用した場合は、claude.yml を探し、レビューワークフローを選択した場合は claude-code-review.yml を探します。ワークフローが削除されると、Claude Code GitHub Action は実行されなくなります
• シークレット：リポジトリから ANTHROPIC_API_KEY または CLAUDE_CODE_OAUTH_TOKEN シークレットを削除し、リポジトリ間で共有 した場合は組織レベルの Actions シークレットから削除します。シークレットを削除しても、それが保持していた認証情報は有効なままです。API キーを完全に廃止するには、Claude Console でキーも削除します
• GitHub App：リポジトリまたは組織設定の GitHub Apps で Claude GitHub App をアンインストールします。ただし、Code Review や web auto-fix などの別の Claude 機能に使用しない場合のみです

​

GitHub App 権限

​

インタラクティブモードと自動化モード

• インタラクティブモード：ワークフローが prompt 入力を提供しない場合、Claude はトリガーフレーズ（デフォルトは @claude）をイシューまたはプルリクエストコメント、プルリクエストレビュー、または新しく開かれたイシューの本文またはタイトルで待機し、そのリクエストに応答します。進捗と結果は、トリガーするイシューまたは PR のコメントとして表示されます。
• 自動化モード：ワークフローが prompt 入力を提供する場合、Claude は 実行をトリガーできるユーザーのチェック のみに従って、待機せずに実行します。デフォルトでは、結果はコメントではなくワークフロー実行ログに表示されます。Claude は、プロンプトが指示し、コード レビュー例 のようにツールがある場合、イシューまたはプルリクエストに投稿できます。

​

実行をトリガーできるユーザー

• 書き込みアクセス：イシューおよびプルリクエストイベントで、トリガーするユーザーはリポジトリへの書き込みアクセスを持つ必要があります。書き込みアクセスのない特定のユーザーを許可するには、allowed_non_write_users を設定し、独自の github_token 入力を渡します。schedule トリガーなど、ユーザーが作成しないイベントはこのチェックをスキップします。
• 人間のアクター：すべてのイベントで、Claude Code GitHub Action は allowed_bots にリストされていない限り、ボットアクターを拒否します。これにより、ボットが Claude をループでトリガーするのを防ぎます。このチェックはスケジュール実行にも適用されます。GitHub はこれらを、通常はワークフローの cron スケジュールを最後に変更したリポジトリユーザーに属性付けします。そのユーザーがボットの場合は、allowed_bots にリストします。

​

使用例

​

@claude メンションに応答

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

• id-token: write：Claude Code GitHub Action のデフォルト GitHub App 認証に必要
• actions: read：Claude が PR の CI 結果を読み取ることができるようにします
• actions/checkout：Claude がリポジトリのローカルコピーで作業できるようにします
• if：@claude とメンションしないコメントでランナーが開始されるのを防ぎます。Claude Code GitHub Action はトリガーフレーズ自体をチェックしてから応答します

@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/skills/ ディレクトリ内のスキルの場合、anthropics/claude-code-action ステップの前に actions/checkout を実行してスキルファイルをランナーで利用可能にし、/skill-name を prompt として渡します。
• plugin にパッケージされたスキルの場合、plugin_marketplaces と plugins 入力でプラグインをインストールし、名前空間付きの /plugin-name:skill-name を prompt として渡します。plugins 入力は plugin-name@marketplace-name を取ります。マーケットプレイス名はマーケットプレイスのリポジトリ URL ではなく、マーケットプレイス自体のマニフェストから取得されます。

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - 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 --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

• --comment：Claude はプルリクエストにレビューを投稿します。見つかった各イシューのインラインコメントとして、または見つからない場合は 1 つの概要コメントとして投稿します。これがないと、Claude は何も投稿せず、ワークフロー実行ログで結果を読みます。
• claude_args：スキル自体の allowed-tools frontmatter が同じツールを名前付けしていても、この行を保持します。Claude Code GitHub Action はインラインコメントを投稿する MCP サーバーを開始するのは、claude_args の --allowedTools がそれを名前付けしている場合のみです。

​

スケジュールで実行

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    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 claude-opus-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

​

ベストプラクティス

​

CLAUDE.md でプロジェクト標準を定義

​

認証情報を保護

​

コストを管理

• GitHub Actions 分：Claude Code GitHub Action は GitHub ホストランナーで実行され、GitHub Actions 分を消費します。価格と分の制限については、GitHub の請求ドキュメント を参照してください。
• API トークン：各インタラクションはプロンプトと応答の長さ、タスクの複雑さ、コードベースのサイズに基づいてトークンを消費します。現在のトークンレートについては、Claude の価格ページ を参照してください。OAuth トークンで認証する場合、実行は API 請求ではなく Claude サブスクリプションを使用します。

• 特定の @claude リクエストを記述して、Claude が完了するのに必要なターン数を減らします
• イシューテンプレートを使用して事前にコンテキストを提供します
• CLAUDE.md を簡潔に保ちます。Claude は実行ごとにそれを読み取るため
• claude_args で --max-turns を設定して反復を制限します
• ワークフローレベルのタイムアウトを設定して暴走ジョブを回避します
• GitHub の並行制御を使用して並列実行を制限します

​

クラウドプロバイダーを使用

• Amazon Bedrock：use_bedrock: "true"
• Google Cloud の Agent Platform：use_vertex: "true"
• Microsoft Foundry：use_foundry: "true"

​

トラブルシューティング

​

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

• GitHub App がリポジトリにインストールされていることを確認します
• リポジトリでワークフローが有効になっていることを確認します
• API キーまたは OAuth トークンがリポジトリシークレットに設定されていることを確認します
• コメントに @claude が完全な単語として含まれていることを確認します。/claude または @claude-bot ではなく
• コメントするユーザーがリポジトリへの書き込みアクセスを持つことを確認します。実行をトリガーできるユーザー の例外を参照してください

​

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

• GitHub はデフォルトの GITHUB_TOKEN で作成されたコミットでワークフローをトリガーしません。Claude Code GitHub Action に github_token: ${{ secrets.GITHUB_TOKEN }} を渡す場合は、Claude GitHub App として認証するようにそれを削除するか、代わりにカスタムアプリトークンを渡します
• CI ワークフローのトリガーに Claude のプッシュが生成するイベント（push または pull_request など）が含まれていることを確認します

​

認証エラー

• API キーまたは OAuth トークンが有効であることを確認します。ワークフローをデバッグする前に claude でローカルでテストします
• Bedrock、Agent Platform、Foundry の場合は、クラウドプロバイダーページの トラブルシューティングセクション を参照してください

​

高度な設定

​

アクション パラメータ

​

CLI 引数を渡す

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

• --max-turns: 会話ターン数を制限します
• --model: 使用するモデル。例えば claude-sonnet-5。この引数がない場合、Claude Code GitHub Action は Claude Code のデフォルト モデルを使用します
• --mcp-config: MCP 設定へのパス
• --allowedTools: 許可されたツールのカンマ区切りリスト。--allowed-tools エイリアスも機能します
• --debug: デバッグ出力を有効にします

​

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

1. uses 行の @beta を @v1 に変更します
2. mode 入力を削除します。Claude Code GitHub Action は モードを自動的に検出 するようになったため
3. direct_prompt を prompt に置き換えます
4. max_turns や model などの CLI オプションを claude_args に移動します。custom_instructions は同じ名前のフラグを持たず、--append-system-prompt になります

​

次のステップ

• クラウドプロバイダーで Claude Code GitHub Actions を使用する：Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 経由で推論をルーティング
• 設定リファレンス：アクション入力の完全なリスト
• Examples ディレクトリ：より多くのシナリオ用の使用可能なワークフロー
• Code Review：ワークフローファイルを維持せずに自動プルリクエストレビュー