Claude Code GitHub Actions

Claude Code GitHub ActionsはAIを活用した自動化をGitHubワークフローにもたらします。PRやissueで簡単に@claudeとメンションするだけで、Claudeがコードを分析し、プルリクエストを作成し、機能を実装し、バグを修正します - すべてプロジェクトの基準に従って。

Claude Code GitHub ActionsはClaude Code SDKの上に構築されており、これによりClaudeCodeをアプリケーションにプログラム的に統合できます。SDKを使用してGitHub Actionsを超えたカスタム自動化ワークフローを構築できます。

なぜClaude Code GitHub Actionsを使うのか？

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

Claudeは何ができるか？

Claude Codeはコードでの作業方法を変革する強力なGitHub Actionを提供します：

Claude Code Action

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

リポジトリを表示 →

セットアップ

クイックセットアップ

このアクションをセットアップする最も簡単な方法は、ターミナルでClaude Codeを使用することです。claudeを開いて/install-github-appを実行するだけです。

このコマンドはGitHubアプリと必要なシークレットのセットアップをガイドします。

GitHubアプリをインストールしてシークレットを追加するには、リポジトリ管理者である必要があります
このクイックスタート方法は、直接のAnthropic APIユーザーのみが利用できます。AWS BedrockやGoogle Vertex AIを使用している場合は、AWS Bedrock & Google Vertex AIでの使用セクションをご覧ください。

手動セットアップ

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

Claude GitHubアプリをインストールしてリポジトリに：https://github.com/apps/claude
ANTHROPIC_API_KEYをリポジトリシークレットに追加（GitHub Actionsでシークレットを使用する方法を学ぶ）
ワークフローファイルをコピーexamples/claude.ymlからリポジトリの.github/workflows/に

クイックスタートまたは手動セットアップのいずれかを完了した後、issueまたはPRコメントで@claudeをタグ付けしてアクションをテストしてください！

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

Claude Code GitHub Actions v1.0はベータ版からv1.0にアップグレードするためにワークフローファイルの更新が必要な破壊的変更を導入します。

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

必須の変更

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

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

破壊的変更リファレンス

旧ベータ入力	新v1.0入力
`mode`	（削除 - 自動検出）
`direct_prompt`	`prompt`
`override_prompt`	GitHub変数付きの`prompt`
`custom_instructions`	`claude_args: --system-prompt`
`max_turns`	`claude_args: --max-turns`
`model`	`claude_args: --model`
`allowed_tools`	`claude_args: --allowedTools`
`disallowed_tools`	`claude_args: --disallowedTools`
`claude_env`	`settings` JSON形式

変更前後の例

ベータ版:

- 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-3-5-sonnet-20241022"

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: |
      --system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-20250514

アクションは設定に基づいて、インタラクティブモード（@claudeメンションに応答）または自動化モード（プロンプトで即座に実行）のどちらで実行するかを自動的に検出するようになりました。

使用例

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 }}
          # コメントの@claudeメンションに応答

スラッシュコマンドの使用

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"

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

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 claude-opus-4-1-20250805"

一般的な使用例

issueまたは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のプロジェクト基準の理解をガイドします。

セキュリティ考慮事項

APIキーを直接リポジトリにコミットしないでください！

APIキーには常にGitHub Secretsを使用してください：

APIキーをANTHROPIC_API_KEYという名前のリポジトリシークレットとして追加
ワークフローで参照：anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
アクションの権限を必要最小限に制限
マージ前にClaudeの提案をレビュー

ワークフローファイルにAPIキーを直接ハードコーディングするのではなく、常にGitHub Secrets（例：${{ secrets.ANTHROPIC_API_KEY }}）を使用してください。

パフォーマンスの最適化

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

CI費用

Claude Code GitHub Actionsを使用する際は、関連する費用に注意してください：

GitHub Actions費用:

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

API費用:

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

費用最適化のヒント:

不要なAPI呼び出しを減らすために具体的な@claudeコマンドを使用
過度な反復を防ぐために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" # オプション
    claude_args: "--max-turns 5" # オプションのCLI引数

主な機能：

統一されたプロンプトインターフェース - すべての指示にpromptを使用
スラッシュコマンド - /reviewや/fixなどの事前構築されたプロンプト
CLIパススルー - claude_argsを介した任意のClaude Code CLI引数
柔軟なトリガー - 任意のGitHubイベントで動作

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

issueまたはPRコメントに応答する際、Claudeは自動的に@claudeメンションに応答します。他のイベントの場合は、promptパラメータを使用して指示を提供してください。

AWS Bedrock & Google Vertex AIでの使用

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

前提条件

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

Google Cloud Vertex AI用：

Vertex AIが有効になったGoogle Cloudプロジェクト
GitHub Actions用に設定されたWorkload Identity Federation
必要な権限を持つサービスアカウント
GitHubアプリ（推奨）またはデフォルトのGITHUB_TOKENを使用

AWS Bedrock用：

Amazon Bedrockが有効になったAWSアカウント
AWSで設定されたGitHub OIDC Identity Provider
Bedrock権限を持つIAMロール
GitHubアプリ（推奨）またはデフォルトのGITHUB_TOKENを使用

カスタムGitHubアプリを作成（3Pプロバイダーに推奨）

Vertex AIやBedrockなどの3Pプロバイダーを使用する際の最適な制御とセキュリティのために、独自のGitHubアプリを作成することをお勧めします：

https://github.com/settings/apps/new にアクセス
基本情報を入力：
- GitHub App name: 一意の名前を選択（例：「YourOrg Claude Assistant」）
- Homepage URL: 組織のウェブサイトまたはリポジトリURL
アプリ設定を構成：
- Webhooks: 「Active」のチェックを外す（この統合には不要）
必要な権限を設定：
- Repository permissions:
  - Contents: Read & Write
  - Issues: Read & Write
  - Pull requests: Read & Write
「Create GitHub App」をクリック
作成後、「Generate a private key」をクリックしてダウンロードした.pemファイルを保存
アプリ設定ページからApp IDをメモ
アプリをリポジトリにインストール：
- アプリの設定ページから、左サイドバーの「Install App」をクリック
- アカウントまたは組織を選択
- 「Only select repositories」を選択し、特定のリポジトリを選択
- 「Install」をクリック
秘密鍵をリポジトリのシークレットとして追加：
- リポジトリのSettings → Secrets and variables → Actionsに移動
- .pemファイルの内容でAPP_PRIVATE_KEYという名前の新しいシークレットを作成
App IDをシークレットとして追加：

GitHub AppのIDでAPP_IDという名前の新しいシークレットを作成

このアプリはactions/create-github-app-tokenアクションと一緒に使用して、ワークフローで認証トークンを生成します。

Anthropic APIの代替または独自のGithubアプリをセットアップしたくない場合: 公式Anthropicアプリを使用：

https://github.com/apps/claude からインストール
認証のための追加設定は不要

クラウドプロバイダー認証を設定

クラウドプロバイダーを選択し、資格情報を保存せずに安全な認証をセットアップ：

AWS Bedrock

Google Vertex AI

必要なシークレットを追加

リポジトリに以下のシークレットを追加（Settings → Secrets and variables → Actions）：

Anthropic API（直接）用：

API認証用:
- ANTHROPIC_API_KEY: console.anthropic.comからのAnthropic APIキー
GitHubアプリ用（独自のアプリを使用する場合）:
- APP_ID: GitHubアプリのID
- APP_PRIVATE_KEY: 秘密鍵（.pem）の内容

Google Cloud Vertex AI用

GCP認証用:
- GCP_WORKLOAD_IDENTITY_PROVIDER
- GCP_SERVICE_ACCOUNT
GitHubアプリ用（独自のアプリを使用する場合）:
- APP_ID: GitHubアプリのID
- APP_PRIVATE_KEY: 秘密鍵（.pem）の内容

AWS Bedrock用

AWS認証用:
- AWS_ROLE_TO_ASSUME
GitHubアプリ用（独自のアプリを使用する場合）:
- APP_ID: GitHubアプリのID
- APP_PRIVATE_KEY: 秘密鍵（.pem）の内容

ワークフローファイルを作成

クラウドプロバイダーと統合するGitHub Actionsワークフローファイルを作成します。以下の例は、AWS BedrockとGoogle Vertex AIの両方の完全な設定を示しています：

AWS Bedrockワークフロー

前提条件:

Claudeモデル権限でAWS Bedrockアクセスが有効
AWSでOIDC identity providerとして設定されたGitHub
GitHub Actionsを信頼するBedrock権限を持つIAMロール

必要なGitHubシークレット:

シークレット名	説明
`AWS_ROLE_TO_ASSUME`	Bedrockアクセス用のIAMロールのARN
`APP_ID`	GitHubアプリID（アプリ設定から）
`APP_PRIVATE_KEY`	GitHubアプリ用に生成した秘密鍵

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-20250514-v1:0 --max-turns 10'

BedrockのモデルID形式にはリージョンプレフィックス（例：us.anthropic.claude...）とバージョンサフィックスが含まれます。

Google Vertex AIワークフロー

前提条件:

GCPプロジェクトでVertex AI APIが有効
GitHub用に設定されたWorkload Identity Federation
Vertex AI権限を持つサービスアカウント

必要なGitHubシークレット:

シークレット名	説明
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Workload identity providerリソース名
`GCP_SERVICE_ACCOUNT`	Vertex AIアクセス権限を持つサービスアカウントメール
`APP_ID`	GitHubアプリID（アプリ設定から）
`APP_PRIVATE_KEY`	GitHubアプリ用に生成した秘密鍵

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@20250514 --max-turns 10'
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5
          VERTEX_REGION_CLAUDE_3_7_SONNET: us-east5

プロジェクトIDはGoogle Cloud認証ステップから自動的に取得されるため、ハードコーディングする必要はありません。

トラブルシューティング

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

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

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

GitHubアプリまたはカスタムアプリ（Actionsユーザーではない）を使用していることを確認し、ワークフロートリガーに必要なイベントが含まれていることをチェックし、アプリ権限にCIトリガーが含まれていることを確認してください。

認証エラー

APIキーが有効で十分な権限を持っていることを確認してください。Bedrock/Vertexの場合は、資格情報設定をチェックし、ワークフローでシークレットが正しく命名されていることを確認してください。

高度な設定

アクションパラメータ

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

パラメータ	説明	必須
`prompt`	Claudeへの指示（テキストまたはスラッシュコマンド）	いいえ*
`claude_args`	Claude Codeに渡されるCLI引数	いいえ
`anthropic_api_key`	Anthropic APIキー	はい**
`github_token`	API アクセス用のGitHubトークン	いいえ
`trigger_phrase`	カスタムトリガーフレーズ（デフォルト：「@claude」）	いいえ
`use_bedrock`	Anthropic APIの代わりにAWS Bedrockを使用	いいえ
`use_vertex`	Anthropic APIの代わりにGoogle Vertex AIを使用	いいえ

*プロンプトはオプション - issue/PRコメントで省略された場合、Claudeはトリガーフレーズに応答
**直接Anthropic APIには必須、Bedrock/Vertexには不要

claude_argsの使用

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

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

一般的な引数：

--max-turns: 最大会話ターン数（デフォルト：10）
--model: 使用するモデル（例：claude-sonnet-4-20250514）
--mcp-config: MCP設定へのパス
--allowed-tools: 許可されたツールのカンマ区切りリスト
--debug: デバッグ出力を有効化

代替統合方法

/install-github-appコマンドが推奨アプローチですが、以下も可能です：

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

詳細なドキュメントについてはClaude Code Actionリポジトリをご覧ください。

Claudeの動作のカスタマイズ

Claudeの動作を2つの方法で設定できます：

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

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

フック GitLab CI/CD

On this page

なぜClaude Code GitHub Actionsを使うのか？
Claudeは何ができるか？
Claude Code Action
セットアップ
クイックセットアップ
手動セットアップ
ベータからのアップグレード
必須の変更
破壊的変更リファレンス
変更前後の例
使用例
基本ワークフロー
スラッシュコマンドの使用
プロンプトを使用したカスタム自動化
一般的な使用例
ベストプラクティス
CLAUDE.md設定
セキュリティ考慮事項
パフォーマンスの最適化
CI費用
設定例
AWS Bedrock & Google Vertex AIでの使用
前提条件
Google Cloud Vertex AI用：
AWS Bedrock用：
トラブルシューティング
Claudeが@claudeコマンドに応答しない
ClaudeのコミットでCIが実行されない
認証エラー
高度な設定
アクションパラメータ
claude_argsの使用
代替統合方法
Claudeの動作のカスタマイズ

はじめに

Claude Codeで構築

Claude Code SDK

デプロイメント

管理

設定

リファレンス

リソース

​なぜClaude Code GitHub Actionsを使うのか？

​Claudeは何ができるか？

​Claude Code Action

​セットアップ

​クイックセットアップ

​手動セットアップ

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

​必須の変更

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

​変更前後の例

​使用例

​基本ワークフロー

​スラッシュコマンドの使用

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

​一般的な使用例

​ベストプラクティス

​CLAUDE.md設定

​セキュリティ考慮事項

​パフォーマンスの最適化

​CI費用

​設定例

​AWS Bedrock & Google Vertex AIでの使用

​前提条件

​Google Cloud Vertex AI用：

​AWS Bedrock用：

​Anthropic API（直接）用：

​Google Cloud Vertex AI用

​AWS Bedrock用

​トラブルシューティング

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

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

​認証エラー

​高度な設定

​アクションパラメータ

​claude_argsの使用

​代替統合方法

​Claudeの動作のカスタマイズ

なぜClaude Code GitHub Actionsを使うのか？

Claudeは何ができるか？

Claude Code Action

セットアップ

クイックセットアップ

手動セットアップ

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

必須の変更

破壊的変更リファレンス

変更前後の例

使用例

基本ワークフロー

スラッシュコマンドの使用

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

一般的な使用例

ベストプラクティス

CLAUDE.md設定

セキュリティ考慮事項

パフォーマンスの最適化

CI費用

設定例

AWS Bedrock & Google Vertex AIでの使用

前提条件

Google Cloud Vertex AI用：

AWS Bedrock用：

Anthropic API（直接）用：

Google Cloud Vertex AI用

AWS Bedrock用

トラブルシューティング

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

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

認証エラー

高度な設定

アクションパラメータ

claude_argsの使用

代替統合方法

Claudeの動作のカスタマイズ