Claude CodeをGitHub Actionsで動かす方法｜CI/CD自動化

Q: @claude以外のトリガーフレーズに変更できますか

可能です。trigger_phraseパラメータでカスタムのトリガーフレーズを指定できます。

公開: 2026年8月3日 / 更新: 2026年8月11日・読了目安7分

#GitHubActions #自動化

Claude CodeをGitHub Actionsで動かす方法｜CI/CD自動化

先に結論: Claude CodeはGitHub Actionsに公式のclaude-code-actionを組み込むと、PRやIssueで@claudeとメンションするだけでコード対応やレビューをCI上で自動化できます。セットアップは/install-github-appのクイック設定か手動設定の2通りです。

Claude CodeはローカルのCLIだけでなく、GitHub Actionsに組み込むことでPRレビューやIssueへの実装対応をCI上で自動化できます。

この記事では公式のclaude-code-actionを使ったセットアップ手順から、ワークフローYAMLの実例、料金・セキュリティ上の注意点までを解説します。

この記事の要点

Claude Code GitHub Actionsはanthropics/claude-code-actionとして提供され、PRやIssueのコメントで@claudeとメンションするだけで動作します。

セットアップは/install-github-appコマンドによるクイックセットアップ(リポジトリのadmin権限が必要)か、手動セットアップの2通りです。

claude_argsにClaude CodeのCLIオプションを渡せ、暴走を防ぐには—max-turnsで会話ターン数の上限を設定するとよいです。

コストはGitHub Actionsの実行時間とClaude APIのトークン従量課金の2種類が発生します。

APIキーはANTHROPIC_API_KEYという名前でリポジトリのシークレットに登録する必要があります。

前提・動作環境

Claude Code GitHub Actionsを使うには、以下が必要です。

対象リポジトリの管理者(admin)権限(GitHub Appのインストールとシークレット登録に必要)
Claude APIキー(Anthropic Consoleで発行。取得方法はClaude CodeをAPIキーで従量課金利用する方法を参照)
/install-github-appコマンドを使う場合はローカルで実行できるClaude Code CLI
GitHub Actionsが有効なリポジトリ

Claude Code GitHub Actionsはanthropics/claude-code-actionというGitHub Actionとして提供されており、PRやIssueのコメントで@claudeとメンションするだけでコード分析・実装・PR作成までを自動で行ってくれます。

セットアップ手順

セットアップには「クイックセットアップ」と「手動セットアップ」の2通りがあります。2026年8月時点でもこの2通りの構成は変わっていません。

Claude Code GitHub Actionsのセットアップ2通り: admin権限で対話形式で完了するクイックセットアップと、GitHub Appのインストールからワークフロー配置までを自分で行う手動セットアップ3ステップを比較する図

クイックセットアップ(/install-github-appコマンド)

Claude Codeのターミナルで以下のコマンドを実行すると、対話形式でセットアップが進みます。

/install-github-app

このコマンドは、GitHub Appのインストールとワークフロー・APIキーシークレットの追加までをまとめて案内してくれます。そのまま進めれば、ワークフローファイルとシークレットが自動で設定されます。

この方法はリポジトリのadmin権限を持つユーザーでなければ実行できません。

手動セットアップ

/install-github-appが使えない場合や、より細かく制御したい場合は以下の手順で行います。

https://github.com/apps/claude からClaude GitHub Appをリポジトリにインストールする(Contents・Issues・Pull requestsへの読み書き権限が付与されます)
リポジトリの Settings → Secrets and variables → Actions で ANTHROPIC_API_KEY という名前のシークレットを追加する
examples/claude.yml を参考に、.github/workflows/ 配下にワークフローファイルを配置する

完了したら、IssueやPRのコメントで@claudeとメンションして動作確認しましょう。

ワークフローYAMLの実例

もっとも基本的な構成は、IssueやPRコメントへの@claudeメンションに反応するワークフローです。

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 メンションに応答する

PRが作成・更新されるたびに自動レビューを走らせたい場合は、トリガーをpull_requestイベントにし、promptで「このPRの差分をレビューしてください」のように指示を明示すれば実現できます。

claude_argsにはClaude CodeのCLIオプションをそのまま渡せます。--max-turnsで会話ターン数の上限を、--modelで使用モデルを指定できるため、暴走を防ぎたい場合は必ず--max-turnsを設定しておくとよいでしょう。

使い方の実例

PRコメントで修正を依頼する

PRのコメント欄に以下のように書き込むと、Claudeがコードを分析して対応します。

@claude ユーザーダッシュボードコンポーネントのTypeErrorを修正してください

Claudeはコメントの文脈とリポジトリのコードを読み取り、修正内容をコミットまたは提案として反映します。

ブランチ作成やコミットもClaude Codeが自動で行うため、Claude CodeでのGit操作自動化もあわせて確認しておくと理解が深まります。

Issueから実装を依頼する

Issueの説明文や本文中に@claudeを含めておくと、Issueをトリガーに実装を開始させることもできます。

@claude issueの説明に基づいてこの機能を実装してください

ClaudeはCLAUDE.mdに書かれたコーディング規約を踏まえて実装を進めるため、リポジトリルートにCLAUDE.mdを用意しておくと出力の質が安定します。

Claude Codeの基本的な操作についてはClaude Codeの使い方完全ガイドでも解説しています。

料金・実行環境の注意

Claude Code GitHub Actionsには2種類のコストが発生します。

Claude Code GitHub Actionsで発生する2種類のコストの図。GitHub Actionsの実行時間はランナー上で動作し無料枠を超えると課金され、Claude APIのトークン従量課金はプロンプトや応答の長さ・タスクの規模に応じて変動することを示す。

GitHub Actionsの実行時間: GitHub提供のランナー上で動作するため、実行時間(分単位)を消費します。無料枠を超えると課金対象になります。
Claude APIのトークン従量課金: プロンプトや応答の長さに応じてAPIトークンが消費され、タスクの複雑さやリポジトリの規模で変動します。

料金は変動する可能性があるため、最新の金額は必ずAnthropicとGitHubの公式サイトで確認してください。コストを抑えるには、--max-turnsで会話ターン数の上限を設ける、ワークフローにタイムアウトを設定する、GitHubの同時実行制御(concurrency)で並列実行を制限する、といった方法が有効です。

つまずきポイント/よくあるエラー

バグイヌ

PRのコメントに、ぼくが/claudeって書いたのに全然反応してくれません…なぜでしょう?

ハブネコ

トリガーになるのは/claudeではなく@claudeというメンションです。GitHub Appの導入とワークフローの有効化もあわせて確認してみてください。

@claudeとメンションしても反応しない: GitHub Appが正しくインストールされているか、ワークフローが有効化されているか、ANTHROPIC_API_KEYがシークレットに設定されているかを確認してください。コメントは/claudeではなく@claudeと書く必要があります。
ClaudeのコミットでCIが起動しない: GitHub App経由でコミットしているか(Actionsユーザー名義になっていないか)を確認し、トリガーにCIをキックすべきイベントが含まれているかを見直してください。
認証エラーが出る: APIキーが有効か、シークレット名がANTHROPIC_API_KEYと一致しているかを確認します。

よくある質問

無料で使えますか

GitHub Actionsの実行自体は無料枠がありますが、Claude APIの利用にはトークン従量課金が発生します。料金体系は変更される可能性があるため、公式サイトで最新情報を確認してください。

`@claude`以外のトリガーフレーズに変更できますか

可能です。trigger_phraseパラメータでカスタムのトリガーフレーズを指定できます。

実行のたびにコンテキストは読み直されますか

はい。各実行はGitHub Actionsの新しいジョブとして起動するため、Claudeはリポジトリをチェックアウトし直し、都度コンテキストを読み込んで応答します。

ハブネコのひとこと

CI上で自動実行させる以上、暴走を防ぐ--max-turnsの設定は最初から入れておいた方が安心だと感じました。実行時間とAPIコストの両方が積み上がる点も意識しておきたいところです。

まとめ

Claude Code GitHub Actionsを使えば、@claudeメンション一つでPRレビューやIssueからの実装をCI上で自動化できます。

セットアップは/install-github-appコマンドか手動設定で完結し、ワークフローYAMLにanthropic_api_keyと必要なclaude_argsを指定するだけで運用を始められます。

GitHub Actionsの実行時間とClaude APIのトークン課金という2種類のコストが発生する点、そしてシークレットの取り扱いには十分注意しましょう。

同様の自動化は他ツールにも広がっており、CodexのPRレビュー自動化はGitHub上のコードレビューを担う仕組みとして、CopilotのCoding AgentはIssueからプルリクエストを自動生成する機能として、それぞれ異なるアプローチでCI/CD連携を進めています。

GitLabで同じことをやりたい場合は、GitLab CI/CDで@claudeを動かす手順をまとめた「Claude Code GitLab連携の使い方」をご覧ください。CI/CDではなくSlackのチャンネル上でチームと一緒にエージェントを動かしたい場合は「Slack Codeとは?」が参考になります。

より基本的な使い方はClaude Codeの使い方完全ガイド、Git操作の自動化はClaude CodeでのGit操作自動化、APIキーの発行や従量課金の詳細はClaude CodeをAPIキーで従量課金利用する方法もあわせてご覧ください。