Claude Code GitHub Actionsの使い方|セットアップ・活用例・料金・セキュリティまで解説

この記事のポイント
Claude Code GitHub Actionsの使い方を、2026年10月時点の公式情報で整理しました。/install-github-appでのセットアップ、用途別のワークフローYAML、認証方式と料金の選び方、パブリックリポジトリで必要なセキュリティ設定までまとめています。
Claude Code GitHub Actionsは、自分のリポジトリのワークフロー内でClaude Codeを動かす、Anthropic公式のGitHub Actionです。PRやIssueのコメントで @claude と呼べば、Claudeがコードを読んで回答・修正し、コミットをプッシュします。prompt を書いておけば、PRの作成時や毎朝の定時など、好きなイベントで自動実行もできます。
いちばん手早い導入方法は、ローカルのClaude Codeで /install-github-app を実行することです。Action自体は無料(OSS)ですが、Claude側の利用料(API従量課金またはサブスクの利用枠)と、GitHub Actionsの実行時間は別にかかります。
この記事でわかること
- Claude Code GitHub Actionsでできること・できないこと(2つの動作モード)
- 3つのセットアップ方法(クイック/手動/組織・独自GitHub App)
- 6つの認証方式の違いと選び方
- そのまま使えるワークフローYAML(@claude応答・PR自動レビュー・Issue着手・定期レポート・構造化出力)
- 2026年10月時点のモデル別API料金と、GitHub Actions側の料金
- パブリックリポジトリで特に注意すべきセキュリティ設定
- Code Review(Team/Enterprise向け)との使い分け
想定読者: GitHub Actionsの基本はわかっていて、PRレビューやIssue対応にClaudeを組み込みたいエンジニア・テックリード
Claude Code自体をまだ使ったことがない場合は、先にClaude Codeとは?機能・料金・使い方で全体像をつかんでおくと、この先の手順が読みやすくなります。
Claude Code GitHub Actionsとは? 何ができるのか

出典:Claude Code Docs「Claude Code GitHub Actions」
Claude Code GitHub Actionsは、Anthropicが開発・メンテナンスしている anthropics/claude-code-action(MIT License)のことです。公式ドキュメントによると、Claude Agent SDKの上に作られています。処理は利用者自身のGitHubランナー上で動き、外に出ていくのは選んだプロバイダー(Claude API、Amazon Bedrockなど)への推論リクエストだけです。
現行のメジャーバージョンは @v1 で、パッチ版が頻繁に出ています(2026年10月15日時点の最新は v1.0.251)。ワークフローに @v1 と書いておけば、パッチ版には自動で追従します。
公式ドキュメントは日本語版(code.claude.com/docs/ja/github-actions)もあるので、細かい仕様は日本語で確認できます。
インタラクティブモード(@claude メンション)
ワークフローに prompt を書かなければ、このモードで動きます。Issue/PRのコメント、PRレビュー、新しいIssueの本文やタイトルに @claude(トリガーフレーズ。変更可)が含まれると、Claudeが反応します。
- コードについての質問に答える
- バグを直してコミットをプッシュする
- 小さな機能を実装する
- PRの変更点を読んで改善点をコメントする
進み具合は、呼び出し元のコメントにチェックボックス付きで書き込まれていきます。PRで「この関数にエラーハンドリングを足して」と書けば、修正コミットがそのPRのブランチに積まれます。
自動化モード(prompt を指定した実行)
ワークフローに prompt を書くと、メンションを待たずにすぐ実行されます。PRが開かれたとき、Issueにラベルが付いたとき、cronの定時など、GitHubのイベントなら何でもきっかけにできます。
注意したいのは、このモードの結果は既定ではワークフローの実行ログにしか出ないことです。PRやIssueにコメントさせたいなら、プロンプトで投稿を指示したうえで、投稿用のツールを許可しておきます。
v1ではモードは自動で判定されます。以前の mode: "tag" / mode: "agent" のような指定は要りません。なお、公式の区分はこの2つだけです。「PRの自動レビュー」は、自動化モードの使い方のひとつと考えてください。
ブランチとPRの扱い
呼び出し元 | Claudeがコミットする先 |
|---|---|
Issue | 新しいブランチ(既定の接頭辞は |
開いているPR | そのPRのブランチに直接プッシュ |
閉じたPR | 新しいブランチ |
既定では、ClaudeがPRを自動で作ることはありません。ブランチにコミットしたあと、タイトルや本文が入力済みの「PR作成ページ」へのリンクを返します。実際にPRを作るのは人です。人の確認を一度はさむための設計だと、公式のセキュリティ文書に書かれています。
名前が似ている別の製品との違い
公式ドキュメントの冒頭でも区別されているとおり、Claudeには「PRをレビューする」機能がいくつかあります。この記事で扱うのは、表の1行目のGitHub Actions版です。
名前 | 中身 | どこで動くか | 使える人 |
|---|---|---|---|
Claude Code GitHub Actions | ワークフローYAMLで設定するAction | 自分のGitHubランナー | APIキー・サブスク・クラウド経由のどれでも |
Code Review | ワークフロー不要のPR自動レビュー(Anthropicが運用) | Anthropicのインフラ | Team/Enterpriseのみ |
| セッションの中で自分のブランチをレビューするコマンド | 手元のClaude Code | 全プラン |
Ultrareview | Claude Codeから起動するクラウドレビュー | クラウドのサンドボックス | claude.aiアカウントが必要 |
Claude Code on the web | クラウドで動くセッション。PRの自動修正もある | Anthropicのクラウド | — |
セットアップ手順(3つの方法)

出典:GitHub「anthropics/claude-code-action」
個人や小さなチームなら、まずはクイックセットアップで十分です。設定を一行ずつ確かめたい場合は手動で、組織の複数リポジトリに広げる場合や権限を最小限に絞りたい場合は3つ目の方法を選びます。
方法 | 向いているケース | 対応する認証 |
|---|---|---|
クイックセットアップ( | 個人・小規模チーム。まず動かしたい | Claude APIキー、サブスク |
手動セットアップ | 設定内容を確かめながら入れたい | 6方式すべて |
組織展開・独自GitHub App | 複数リポジトリへの展開、最小権限にしたい組織 | 6方式すべて |
方法1: クイックセットアップ(個人・小規模チーム向け)
ローカルのClaude Codeから、対話形式で一通り設定できます。前提はリポジトリの管理者権限と、GitHub CLIのログイン(gh auth login)です。GitHub CLIが入っていないと警告が出ます。
- 対象リポジトリのディレクトリで
claudeを起動する - セッション内で
/install-github-appを実行する - Claude GitHub Appをインストールする(「Skip for now」でAppだけ入れて止めることもできる)
- 認証用のシークレットを選ぶ。APIキーがすでにあれば再利用でき、無ければ「サブスクで長期トークンを作る」か「APIキーを貼り付ける」を選ぶ
- ワークフローファイル(
claude.yml、レビュー用を選べばclaude-code-review.ymlも)がブランチにプッシュされ、ブラウザでPR作成画面が開く - そのPRを作ってマージすれば、
@claudeが使えるようになる
途中で止めたいときはEscで中断できます。終了時のメッセージに、そこまでに済んだ作業(プッシュしたブランチ、保存したシークレット)が表示されます。
なお、クイックセットアップが対応しているのはClaude APIとサブスクの認証だけです。Bedrock/Google Cloud/Microsoft Foundry経由で使う場合は手動セットアップになります。スラッシュコマンドの基本はClaude Codeのスラッシュコマンド一覧にまとめています。
方法2: 手動セットアップ(標準的な方法)
ステップ1:Claude GitHub Appをインストール
https://github.com/apps/claude から、対象のリポジトリ(または組織)にインストールします。
ステップ2:認証情報をSecretsに追加
リポジトリの Settings > Secrets and variables > Actions で、次のどちらかを追加します。
- APIキーを使う場合:
ANTHROPIC_API_KEY(Claude Console=platform.claude.com で発行) - サブスクを使う場合:
CLAUDE_CODE_OAUTH_TOKEN(ローカルでclaude setup-tokenを実行して発行)
ステップ3:ワークフローYAMLを置く
.github/workflows/claude.yml を作り、次の内容を書きます。公式の基本ワークフローと同じ構成で、@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 }}この設定のうち、次の3つの行には理由があります。
permissionsのid-token: writeは、既定のGitHub App認証で必要になるif:の行があると、@claudeを含まないコメントではランナーが起動しない(実行時間の節約になる)actions: readを付けると、ClaudeがPRのCI結果を読めるようになる
サブスクで使う場合は、anthropic_api_key の行を claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }} に置き換えます。公式リポジトリの examples/claude.yml も「そのまま動くワークフロー」として公開されているので、写して使ってもかまいません。
マージしたら、IssueかPRに「@claude このファイルの役割を教えて」とコメントして、返信が付けば完了です。
方法3: 組織への展開・独自GitHub App(エンタープライズ向け)
組織の複数リポジトリに広げる場合は、次の順で進めると管理が楽になります。
- Claude GitHub Appを組織に1回インストールする
- 組織のActionsシークレットに認証情報を登録する。共有するならAPIキーを使う(サブスクのOAuthトークンは発行した人のサブスクに紐づくため、組織での共有には向かない)
- 各リポジトリにワークフローを置くか、reusable workflow(再利用可能なワークフロー)にまとめて呼び出す
権限を最小限にしたい場合は、独自のGitHub Appを作ります。公式のClaude GitHub Appは、Code Reviewやweb版の自動修正と共用のため多くの権限を求め、一部だけを承認することはできません。いっぽう、Actionが実際に使うのは「Contents」「Issues」「Pull requests」の読み書きだけです。
- GitHubで独自のGitHub Appを作る(webhookは無効、権限はContents・Issues・Pull requestsの読み書きだけ)
- App IDと秘密鍵をSecretsに登録する
- ワークフローで
actions/create-github-app-token@v2を使ってトークンを発行し、Actionのgithub_tokenに渡す
ただし独自Appにすると、Code Reviewとweb版の自動修正は使えなくなります。チームでの導入の進め方全体は、Claude Codeのチーム導入ガイドで整理しています。
認証方法の選び方
現在の認証方式は6つです。迷ったら、個人ならサブスクのOAuthトークンかAPIキー、チームならAPIキー、AWS・Google Cloud・Azureに請求をまとめたい企業はクラウド経由を選べば、まず外しません。
認証方式 | 設定するもの | 請求先 | 向いているケース |
|---|---|---|---|
Claude APIキー |
| Claude APIの従量課金 | もっとも手軽。チームで共有する場合の基本 |
サブスクのOAuthトークン |
| Pro/Max/Team/Enterpriseの利用枠 | 個人でサブスクを契約済み。発行者のサブスクに紐づくので組織共有には不向き |
ワークロードIDフェデレーション(OIDC) |
| Claude APIの従量課金 | APIキーをSecretsに置きたくない組織 |
Amazon Bedrock |
| AWS | AWSに請求を集約したい企業 |
Google Cloud の Agent Platform(旧 Vertex AI) |
| Google Cloud | Google Cloudに請求を集約したい企業 |
Microsoft Foundry |
| Azure | Azureに請求を集約したい企業 |
- サブスクのOAuthトークンは、現在の公式ドキュメントではPro/Max/Team/Enterpriseで使えます(Maxプラン専用ではありません)。サブスクの利用枠はclaude.aiとClaude Codeで共有され、5時間ごとの上限と週ごとの上限があります。GitHub Actionsでの消費がこの枠にどう数えられるかは公式に細かく書かれていないので、使いすぎるとローカルでの作業にも響く可能性がある、と考えておくのが無難です
- ワークロードIDフェデレーションは、GitHubのOIDCトークンをAnthropic側で検証する方式です。ワークフローに
id-token: writeが必要で、任意でanthropic_service_account_id・anthropic_workspace_idも指定できます - クラウド経由の3方式はどれもOIDCで認証するので、静的なクラウド認証情報をSecretsに置かずに済みます。Google Cloudの名称は「Agent Platform」に変わりましたが、入力名は
use_vertexのままです。設定手順は公式のクラウドプロバイダー向けページにまとまっています
実践ワークフロー:ユースケース別YAML設定

@claude に応答させるだけなら基本の claude.yml で足ります。それ以外によく使われる4つのパターンを、公式の例をもとに整理しました。どの例もAPIキー認証で書いているので、サブスクの場合は認証の行を置き換えてください。
ユースケース | モード | きっかけ | 結果が出る場所 |
|---|---|---|---|
1. PR自動レビュー | 自動化(スキル実行) | PRの作成・更新 | PRのインラインコメント |
2. ラベルでIssueに着手 | インタラクティブ | Issueへのラベル付け | Issueのコメント+新ブランチ |
3. 定期レポート | 自動化 | cron | ワークフローのログ |
4. 結果で後続ステップを分岐 | 自動化(構造化出力) | CIの失敗など | 後続ステップの条件 |
ユースケース1:PR自動コードレビュー
PRが開かれたり更新されたりするたびに、Claudeがレビューしてインラインコメントを付けます。/install-github-app でレビューを選んだときに入るものと同じ、公式のプラグインを使う構成です。
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を付けると、指摘ごとにインラインコメントを投稿する(指摘が無ければ要約コメントが1件)。付けないと、結果はログにしか出ない--allowedToolsでインラインコメント用のツールを明示しないと、投稿用のサーバーが起動しない- 下書きのPR、閉じたPR、自動生成や軽微と判断されたPR、すでにClaudeのコメントがあるPRはスキップされる
- パブリックリポジトリでは、forkからのPRにシークレットが渡らないため、同じリポジトリのブランチから出たPRでしか動かない
Claude Code v2.1.229より前の /install-github-app で作ったレビュー用ワークフローは、結果をログに書くだけでPRにはコメントしませんでした。古い設定のまま「コメントが付かない」場合は、/install-github-app を実行し直して「Update workflow file with latest version」を選ぶか、--comment と claude_args の行を手で追記します。
ユースケース2:ラベルを付けたIssueにClaudeを着手させる
Issueに claude ラベルを付けると、Claudeが本文を読んで実装を始めます。label_trigger で起動用のラベルを指定し、prompt は書かずにインタラクティブモードで動かす形です。
name: Claude Issue Worker
on:
issues:
types: [labeled]
jobs:
implement:
if: github.event.label.name == 'claude'
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: write
pull-requests: write
issues: write
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 }}
label_trigger: "claude"
claude_args: |
--max-turns 15
--allowedTools "Bash(npm test:*)"Claudeは claude/ で始まる新しいブランチにコミットし、PR作成ページへのリンクをIssueに返します。PRそのものは人がリンクを開いて作るので、「ラベルを付けたらPRまで自動でできあがる」わけではありません。
既定ではBashを実行できないため、テストを走らせたい場合はこの例のように、使うコマンドだけを --allowedTools で許可します。Issueのテンプレートに「目的・対象ファイル・完了条件」の欄を用意しておくと、Claudeが迷う回数が減り、費用も下がります。
アサインで起動したい場合は、assignee_trigger に起動用のユーザー名を指定します。
ユースケース3:定期レポート(スケジュール実行)
毎日決まった時刻に、前日のコミットや未対応のIssueをまとめさせる例です(公式の例を日本語に置き換えたもの)。
name: Daily Report
on:
schedule:
- cron: "0 0 * * *" # 毎日 9:00 JST(0:00 UTC)
workflow_dispatch:
jobs:
report:
runs-on: ubuntu-latest
timeout-minutes: 15
permissions:
contents: 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 }}
prompt: "昨日のコミットと未対応のIssueを日本語で要約してください"
claude_args: |
--model claude-sonnet-5-5
--allowedTools "mcp__github__list_commits,mcp__github__list_issues"prompt に普通の文章を書いた場合、--allowedTools(または settings の permissions.allow)で許可するまで、シェルもGitHub APIも使えません。この例では、コミットとIssueの一覧取得だけを許可しています。結果はワークフローのログに出るので、Issueやコメントに投稿させたいときは、プロンプトで指示したうえで投稿用のツールも許可します。
スケジュール実行まわりには、GitHub側の仕様による注意点がいくつかあります。
scheduleはデフォルトブランチのワークフローからしか実行されない- パブリックリポジトリは、60日間動きがないと
scheduleが無効になる - cronは「最後にcronを書き換えたユーザー」の名義で実行される。それがbotなら
allowed_botsに入れておく必要がある
ユースケース4:結果をJSONで受け取って後続ステップを分岐させる
claude_args に --json-schema を渡すと、Claudeの判断を決まった形のJSONで受け取れます。結果は structured_output という出力(JSON文字列)になり、後続のステップで条件に使えます。CIが失敗したときに「不安定なテストのせいか」を判定させ、そうなら失敗したジョブだけを再実行する例です。
name: CI Failure Triage
on:
workflow_run:
workflows: ["CI"]
types: [completed]
jobs:
triage:
if: github.event.workflow_run.conclusion == 'failure'
runs-on: ubuntu-latest
timeout-minutes: 15
permissions:
contents: read
actions: write
id-token: write
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 1
- uses: anthropics/claude-code-action@v1
id: analyze
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: |
CIの実行 ${{ github.event.workflow_run.id }} が失敗しました。
失敗の原因が、実行のたびに結果が変わる不安定なテストかどうかを判定してください。
claude_args: |
--allowedTools "Bash(gh run view:*)"
--json-schema '{"type":"object","properties":{"is_flaky":{"type":"boolean"},"reason":{"type":"string"}},"required":["is_flaky","reason"]}'
- name: 不安定なテストなら失敗したジョブだけ再実行
if: fromJSON(steps.analyze.outputs.structured_output).is_flaky == true
env:
GH_TOKEN: ${{ github.token }}
run: gh run rerun ${{ github.event.workflow_run.id }} --failedworkflow_run はベースリポジトリのシークレットで動くトリガーです。PR側のコードを作業ディレクトリ直下にcheckoutすると、シークレットを持ったまま信頼できないコードを動かすことになるので避けてください。gh コマンドの認証の渡し方など細かい部分は、公式ドキュメントの例と照らし合わせて調整してください。
補足:スキルやプラグインを呼び出す
prompt には文章の代わりに、/skill-name の形でリポジトリの .claude/skills/ にあるスキルを書くこともできます(actions/checkout が必要)。プラグインのスキルは /plugin-name:skill-name の形で、plugin_marketplaces と plugins の入力で読み込みます。PR自動レビューも、この仕組みで動いています。スキルの作り方はClaude Code Skillsの使い方を参考にしてください。
主要パラメータとカスタマイズ
よく使う入力(with: に書く項目)を、2026年10月時点の公式 usage.md にもとづいて整理しました。
入力 | 内容 | 既定値 |
|---|---|---|
| Claudeへの指示(文章またはスキル呼び出し)。省略するとトリガーフレーズに反応する | — |
| Claude CodeのCLI引数をそのまま渡す | 空 |
| 認証情報 | — |
| 独自GitHub Appを使うときだけ指定 | — |
| 反応する呼び出し語 |
|
| Issueにアサインされると起動するユーザー名 | — |
| Issueに付くと起動するラベル名 | — |
| ブランチの起点と接頭辞 | — / |
| Claude Codeの設定(JSON文字列またはファイルパス) | 空 |
| 進捗コメントを付けるモードを強制する |
|
| PRへのコメントを1件にまとめる |
|
| レビューの指摘に「Fix this」リンクを付ける |
|
| 確定前のインラインコメントをHaikuで分類してから投稿する |
|
| 起動を許すbot(名前を列挙) | 空(許可なし) |
| 書き込み権限のないユーザーにも起動を許す(危険) | 空 |
| 読み込むコメントの投稿者を絞る(除外が優先) | 空 |
| コミット署名 |
|
|
| 空 |
| プラグインの読み込み | 空 |
| クラウド経由で使う |
|
claude_args でよく使うオプション
claude_args には、ローカルのClaude Codeと同じCLI引数を渡します。複数行で書く場合は | を使います。
--model:使うモデル(例:claude-sonnet-5-5)--max-turns:やり取りの回数の上限。費用と実行時間の上限として使う--allowedTools:許可するツール。Bashはコマンド単位で許可する(例:"Bash(npm test:*)")--append-system-prompt:追加の指示(v0のcustom_instructionsの代わり)--mcp-config:MCPサーバーの設定ファイル--json-schema:結果を決まった形のJSONで返させる--add-dir:作業ディレクトリ以外のフォルダを読めるようにする--debug:デバッグ出力
--max-turns の既定値は公式ドキュメントに明記がないので、上限を決めたいときは必ず自分で指定しておきましょう。MCPサーバーとの連携はClaude CodeのMCP連携ガイドで詳しく解説しています。
モデルの選び方
--model を指定しないと、Claude Codeの既定モデルが使われます。2026年10月時点の既定は、Claude APIやサブスク、Bedrock、Google Cloud経由ならClaude Opus 5.5です(Microsoft FoundryだけはSonnet 4.5)。以前の「既定はSonnet」のつもりで何も指定しないと、想定より高いモデルで動くことになります。
用途 | おすすめのモデル | 指定例 |
|---|---|---|
定型のPRレビュー、日次の要約 | Claude Sonnet 5.5 |
|
Issueからの実装、込み入ったバグ修正 | Claude Opus 5.5 |
|
ラベル付けや仕分けなど大量で単純な処理 | Claude Haiku 5.5 |
|
大規模なリファクタリングの設計など難しい推論 | Claude Fable 5.1 |
|
別名(opus・sonnet・haiku)も使えますが、BedrockやGoogle Cloud経由では sonnet がSonnet 4.5を指すなど、指す先がずれます。クラウド経由で使う場合はモデルIDをそのまま書き、自分のリージョンで提供されているかも確かめてください。
CLAUDE.mdによるプロジェクトルール定義
リポジトリのルートに CLAUDE.md を置くと、Claudeはプロジェクトのルールやコーディング規約を読んだうえで作業します。GitHub Actionsでも毎回読み込まれます。
# CLAUDE.md
## コーディング規約
- TypeScriptを使い、anyは使わない
- 関数にはJSDocコメントを付ける
- テストはVitestで書く
## レビュー基準
- パフォーマンスに影響する変更は、ベンチマーク結果を添える
- 認証・決済まわりの変更は、人のレビューを必須とする旨をコメントする公式は、CLAUDE.mdを短く保つことを費用を抑える方法のひとつに挙げています。毎回読み込まれる分、長いほど入力トークンが増えるからです。レビューの観点のように用途が限られる長い指示は、スキルに分けたほうが無駄がありません。
なおPRから起動した場合、.claude/・.mcp.json・CLAUDE.md などはベースブランチの内容に戻されます。PRの中でCLAUDE.mdを書き換えても、そのPRのレビューには反映されません。
料金:API課金 vs サブスクプラン、どちらを選ぶべきか
Action自体は無料です。かかる費用は、Claude側の利用料とGitHub Actionsの実行時間の2つです。
Claude側の費用(API従量課金の場合)
Claude APIの料金は、2026年10月16日時点で次のとおりです(100万トークンあたり)。
モデル | API ID | 入力 | 出力 |
|---|---|---|---|
Claude Fable 5.1 |
| $10 | $50 |
Claude Opus 5.5(Claude Codeの既定) |
| $4 | $20 |
Claude Sonnet 5.5 |
| $2 | $10 |
Claude Haiku 5.5 |
| $0.10〜 | $0.50〜 |
キャッシュから読み込んだ入力は割安になります(Opus 5.5・Sonnet 5.5は基本入力価格の5%)。4.x系やOpus 5・Sonnet 5などの旧モデルも「Legacy」として引き続き使えますが、新しく設定するなら現行モデルを選ぶのが基本です。
1回の実行でどれくらいかかるかは、リポジトリの大きさや指示の内容で大きく変わります。公式がCode Reviewの費用について勧めている見積もり方は、GitHub Actions版にもそのまま使えます。
- 2〜3個のリポジトリで1〜2週間試す
- Claude Consoleで、1回あたりの平均費用を確認する
- 「1回あたりの平均 × 月のPR数(または実行回数)」で月額を見積もる
サブスクのOAuthトークンを使う場合
プラン | 月額(2026年10月時点) | GitHub Actionsでの利用 |
|---|---|---|
Free | $0 | Claude Codeが含まれないため不可 |
Pro | $20(年払いなら月あたり$17) | OAuthトークンで利用できる |
Max 5x/20x | $100〜(20xの価格は公式料金ページで確認) | OAuthトークンで利用できる |
Team 標準席 | 1席$25(年払いなら$20)、2〜150人 | OAuthトークンで利用できる |
Team プレミアム席 | 1席$125(年払いなら$100) | OAuthトークンで利用できる |
Enterprise | 1席$20(年払い・20席から)+API料金での利用料 | OAuthトークンで利用できる |
サブスクなら月額の範囲で使えますが、利用枠には5時間ごと・週ごとの上限があり、claude.aiやローカルのClaude Codeと共有です。プランごとの違いはClaudeの料金プラン比較とClaude Codeの料金で詳しく比べています。
GitHub Actions側の費用
項目 | 内容(2026年10月時点) |
|---|---|
パブリックリポジトリ | 標準のGitHubホストランナーは無料 |
プライベートリポジトリの月間無料枠 | GitHub Free 2,000分/Pro 3,000分/Team 3,000分/Enterprise Cloud 50,000分 |
無料枠を超えた分(1分あたり) | Linux 2コア $0.006/Windows 2コア $0.010/macOS $0.062 |
セルフホストランナー | 無料 |
GitHubは2026年1月にホストランナーの料金を最大39%引き下げました。セルフホストランナーへの課金(1分$0.002)も2026年3月から始まる予定と発表されましたが、その後延期され、現時点では無料のままです。将来また導入される可能性はあります。
どちらを選ぶべきか
条件 | おすすめ |
|---|---|
個人で使い、すでにPro/Maxを契約している | サブスクのOAuthトークン |
チームで使う、費用を1か所で管理したい | Claude APIキー(組織シークレット) |
APIキーをSecretsに置きたくない | ワークロードIDフェデレーション |
AWS/Google Cloud/Azureに請求をまとめたい | Bedrock/Agent Platform/Foundry |
まず少しだけ試したい | APIキー+ |
費用をさらに抑える工夫は、Claude Codeのコスト最適化にまとめています。
ベータ版(@beta)からv1.0への移行
@beta のまま動かしている場合は、v1の書き方に直しておきましょう。v1.0では入力の多くが claude_args と settings にまとめられています。
旧(ベータ) | 新(v1) |
|---|---|
|
|
| 削除(自動で判定) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
移行の手順は次のとおりです。
- ワークフローの
@betaを@v1に変える - 廃止された入力を、v1の書き方(
claude_argsまたはsettings)に直す modeの指定を消す- ついでに
permissions・actions/checkout@v6・if:の条件を、公式の基本ワークフローに合わせて見直す
セキュリティ対策:導入前に確認すべきポイント

出典:GitHub Docs「Security hardening for GitHub Actions」
既定の設定のままでも、起動できるのは「リポジトリに書き込み権限を持つ人間」に限られています。危ないのは、起動できる範囲を広げる設定を入れたときと、パブリックリポジトリで外部の入力を読ませるときです。
既定で有効な2つのチェック
- 書き込み権限:Issue/PR系のイベントでは、起動したユーザーにリポジトリへの書き込み権限が必要。
workflow_runでは、実行者と元のワークフローの実行者の両方が確かめられる - 人間かどうか:botは
allowed_botsに載っていない限り拒否される(無限ループの防止)
パブリックリポジトリのチェックリスト
確認項目 | 理由 |
|---|---|
| 公式が「大きなセキュリティリスク」と明記する設定。使うならIssueのラベル付けのような権限の小さいワークフローに限り、 |
個人アクセストークン(PAT)を渡していないか | プロンプトインジェクションで少しずつ外に持ち出されるおそれがある |
| 許可したbotは権限確認を受けない。パブリックでは誰が作ったAppでも起動できてしまうので、名前を列挙する |
| ベースリポジトリのシークレットで動くため。PRのファイルが要るなら別ディレクトリにcheckoutして |
hooksなどからPR側の |
|
読み込むコメントの投稿者を絞っているか |
|
| ツールの出力やファイルの中身がログに出て、パブリックでは誰でも読める。 |
クラウド経由の場合、最初に書き込み権限を確かめるステップを置いたか | パブリックでは誰のコメントでもワークフロー自体は起動し、権限チェックの前にクラウドへのログインが走る(監査ログと実行時間を消費する) |
Issueの本文やコメントには、見えない形で指示が仕込まれることがあります。HTMLコメントや不可視文字、画像のaltなどは取り除かれますが、公式も「新しい回避方法は出てくる」としています。AIエージェントがこうした間接的な指示に引っかかる仕組みは、Claude CodeのAuto Modeとプロンプトインジェクションで具体的に解説しています。
認証情報の管理
- APIキーやOAuthトークンは、ワークフローに直接書かず、必ずSecretsに入れる(公式が最重要として挙げている項目)
- 使わなくなった鍵は、SecretsだけでなくClaude Consoleでも削除する。Secretsから消しただけでは鍵自体はまだ有効
- 長期の鍵を置きたくない場合は、ワークロードIDフェデレーションかクラウド経由のOIDCを選ぶ
GitHub Appの権限
公式のClaude GitHub Appは、Code Reviewなどと共用のため、Contents・Issues・Pull requests・Actions・Checks・Workflowsなど多くの権限をまとめて求めます。一部だけを承認することはできません。Appが受け取るトークンは、対象リポジトリに限られた短命のもので、他のリポジトリには触れません。
それでも権限を絞りたい組織は、Contents・Issues・Pull requestsの3つだけを持つ独自のGitHub Appを作り、そのトークンを github_token に渡します。この場合、Code Reviewとweb版の自動修正は使えなくなります。
コストと暴走の防止
想定外の実行で費用が膨らまないよう、ジョブに上限を設けておきます。
jobs:
claude:
timeout-minutes: 30 # ジョブ全体の上限時間
concurrency:
group: claude-${{ github.event.issue.number || github.event.pull_request.number }}
cancel-in-progress: false # 同じIssue/PRでの同時実行を1つに絞る
runs-on: ubuntu-latest
steps:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
claude_args: "--max-turns 10"あわせて、依頼を具体的にする、Issueテンプレートで前提を渡す、CLAUDE.mdを短く保つ、といった工夫も公式は勧めています。
ツールは「許可したものだけ」が基本
既定ではClaudeはBashを実行できず、許可したツールだけを使います。「危ないコマンドを禁止する」より、必要なコマンドだけを --allowedTools で許可するほうが、公式の考え方にも合っていて安全です。
claude_args: |
--allowedTools "Bash(npm test:*),Bash(npm run lint:*)"コミットに署名したい場合は use_commit_signing: true(手軽だがリベースなどは不可)か ssh_signing_key(すべてのgit操作に対応)を使います。Claude Code全体のセキュリティ設定は、Claude Codeのセキュリティガイドも参考にしてください。
できないこと・制約事項
公式の「できること・できないこと」の文書などから、導入前に知っておきたい制約をまとめます。
- PRの承認(Approve/Request changes)はできない。セキュリティ上の理由で、正式なレビューは送れない
- @claudeへの応答は、最初のコメント1件を更新していく形。複数のコメントには分かれない(ただしPRレビュー用のプラグイン構成では、インラインコメントを複数付けられる)
- マージやリベースはできない。git操作はコミットのプッシュまで
- PRは自動で作らない。PR作成ページへのリンクを返す
- 既定ではBashを実行できない。必要なコマンドは許可が要る
- 起動したリポジトリとIssue/PRの範囲外では動かない
- リアルタイムの対話には向かない。1回のコメントで目的と条件をはっきり伝える必要がある
- GitHubの実行時間の上限に従う。GitHubホストランナーのジョブは最大6時間
トラブルシューティング
導入直後によくある「動かない」「思ったとおりにならない」原因と対処です。
@claude にメンションしても反応しない
- Claude GitHub Appが入っているか:リポジトリの
Settings > GitHub Appsで確認する - コメントした人に書き込み権限があるか:権限のない人やbotのコメントには反応しない
@claudeが単語として書かれているか:@claude-botのように前後がつながっていると反応しないことがある- 認証情報のSecretsが正しいか:名前のつづりと、値の前後の空白を確認する
- ワークフローのトリガーと
if:条件:issue_commentとpull_request_review_commentが入っているか。ワークフローがデフォルトブランチにマージ済みか - Actionsタブの実行履歴:起動していないのか、起動して失敗しているのかを切り分ける
Claudeのコミットで CI が走らない
github_token: ${{ secrets.GITHUB_TOKEN }} を渡していると、そのトークンで作ったコミットではGitHubの仕様上ワークフローが起動しません。github_token の行を外してClaude GitHub Appとして認証させるか、独自GitHub Appのトークンを使います。
PR自動レビューのコメントが付かない
promptに--commentが入っているか、claude_argsでインラインコメント用のツールを許可しているか- forkからのPRではないか(パブリックではシークレットが渡らない)
- 下書きPRや、すでにClaudeのコメントがあるPRではないか
自動化モードで結果が見当たらない
prompt を書いた実行の結果は、既定ではワークフローのログに出ます。Actionsタブで該当の実行を開いて確認してください。
ワークフローがタイムアウトする・コストが想定より高い
--modelを指定しているか。未指定だとOpus 5.5で動く--max-turnsとtimeout-minutesを設定しているか- 依頼が曖昧すぎないか(目的・対象・完了条件を書く)
concurrencyで同じIssue/PRへの同時実行を抑えているか- 長すぎるCLAUDE.mdが毎回読み込まれていないか
ローカルのClaude Codeとの違い
GitHub Actions版は、ローカルのClaude Codeを「チームの共有の場で、非同期に動かすもの」と考えるとわかりやすくなります。
比較項目 | ローカルの Claude Code | GitHub Actions版 |
|---|---|---|
動く場所 | 自分のPC | GitHubランナー |
やり取り | その場で対話 | コメントやイベントで非同期 |
向いている作業 | 個人の開発、試行錯誤しながらのコーディング | チームのPRレビュー、Issue対応、定期処理 |
読める範囲 | 手元のファイル全体 | checkoutしたリポジトリ+Issue/PRの内容 |
起動方法 | ターミナルで |
|
設定 |
|
|
ツールの権限 | 実行時に都度確認できる | 事前に許可したものだけ |
ローカルでの基本操作はClaude Codeの使い方ガイドを見てください。GitHubのイベントをきっかけにClaudeを動かす方法は、Anthropicのクラウドで動くClaude Code Routinesという選択肢もあります。
Code Review・/code-reviewとの使い分け
PRのレビューだけが目的で、Team/Enterpriseプランを契約しているなら、Code Reviewのほうが手間は少なく済みます。ワークフローの管理が要らず、Anthropicのインフラで動くからです。いっぽう、レビュー以外の自動化もしたい、モデルや実行条件を細かく決めたい、個人プランで使いたい、という場合はGitHub Actions版が向いています。
比較項目 | GitHub Actions版 | Code Review |
|
|---|---|---|---|
設定 | ワークフローYAMLを書く | 管理画面でリポジトリを追加 | 不要 |
動く場所 | 自分のGitHubランナー | Anthropicのインフラ | 手元のClaude Code |
対象プラン | APIキー・全サブスク・クラウド経由 | Team/Enterpriseのみ | 全プラン |
費用 | API従量またはサブスク枠+GitHubの実行時間 | 使用量クレジットからの従量課金(プランの込み枠とは別) | サブスク枠またはAPI |
モデルの指定 | できる | できない | できる |
レビュー以外の自動化 | できる(実装・定期処理など) | できない | できない |
利用条件の制約 | 特になし | ZDR有効組織などでは使えない | 特になし |
Code Reviewの費用は「レビューの深さ(Quick/Standard/Deep)×変更の大きさ×実行回数」で決まり、リポジトリを追加したときの既定は「プッシュのたびに実行」です。月の上限額を管理画面で決めておけます。自前のレビュアーをサブエージェントで作る方法はClaude Codeのサブエージェントで解説しています。GitHub Copilotのコーディングエージェントとの比較はClaude CodeとGitHub Copilotの比較を参考にしてください。
こんなチームにおすすめ / おすすめしないチーム
導入をおすすめするチーム
- PRレビューが滞りがちなチーム:最初の指摘をClaudeが返すので、人のレビューは設計や仕様の判断に集中できる
- コーディング規約をそろえたいチーム:CLAUDE.mdに書いたルールで毎回チェックできる
- Issue駆動で開発しているチーム:ラベルやアサインでClaudeに着手させ、ブランチ作成までを任せられる
- 少人数で多くのリポジトリを見ているチーム:組織シークレットとreusable workflowで、同じ設定を横に広げられる
- AWS・Google Cloud・Azureで請求を一本化したい企業:クラウド経由の認証で既存の請求にまとめられる
おすすめしないチーム
- GitHub ActionsのYAMLやログの読み方に慣れていないチーム:動かないときの切り分けに時間がかかる。まずはローカルのClaude Codeから始めたほうが早い
- 外部へのコード送信が社内規程で認められていない組織:Bedrockなどのクラウド経由でも推論はプロバイダー側で行われる。データの扱いは公式のデータ利用・セキュリティのページで事前に確認が必要
- 外部からの投稿が多いパブリックリポジトリで、セキュリティ設定を見直す余裕がないチーム:権限を広げる設定をうっかり入れると、プロンプトインジェクションの影響を受けやすい
- AIのレビューだけでマージしたいチーム:Claudeは承認できず、指摘も補助にとどまる。ブランチ保護で人のレビューを必須にしておく前提で使う
Claudeに作らせた社内ツールや試作を、社内の実データや既存システムにつないで業務で使う段階では、権限の設計やテスト、運用を誰が引き受けるかを決める必要があります。その進め方はAIで作ったアプリを開発会社へ引き継ぐにはで整理しています。
よくある質問(FAQ)
Q1. 無料で使えますか?
Action自体は無料ですが、Claudeを動かす費用は必要です。Claude APIの従量課金か、Pro以上のサブスクの利用枠を使います。GitHub側は、パブリックリポジトリなら標準ランナーの実行時間は無料です。Claude側まで含めて完全に無料で使う方法はありません。
Q2. 日本語で指示できますか?
できます。コメントやプロンプトを日本語で書けば、日本語で返ってきます。CLAUDE.mdも日本語で問題ありません。公式ドキュメントにも日本語版があります。
Q3. Proプランでも使えますか?
使えます。claude setup-token で発行したOAuthトークンを CLAUDE_CODE_OAUTH_TOKEN に設定します。Proは利用枠が小さめなので、自動レビューを頻繁に回すとローカルでの作業に使える分が減る点に注意してください。
Q4. GitLabやGitHub Enterprise Serverでも使えますか?
このActionはgithub.com向けです。/install-github-app は、リモートがGitLabやBitbucketだと案内を出して終了します。GitLabには「Claude Code GitLab CI/CD」、GitHub Enterprise Serverには別の手順が公式に用意されています。
Q5. Claudeが変なコードをコミットしたらどうなりますか?
通常のコミットと同じ扱いなので、revertで戻せます。Issueからの作業は新しいブランチに入り、PRも人が作るため、デフォルトブランチへ直接入ることはありません。ただし開いているPRから呼んだ場合は、そのPRのブランチに直接プッシュされます。ブランチ保護で人の承認を必須にしておけば、マージ前に必ず人の目が入ります。
Q6. DependabotやRenovateのPRにもClaudeを反応させられますか?
allowed_bots に対象のbotを名前で列挙すれば反応します。* ですべてのbotを許可するのは、パブリックリポジトリでは避けてください。
with:
allowed_bots: "dependabot[bot],renovate[bot]"Q7. forkから来たPRもレビューできますか?
パブリックリポジトリでは、GitHubの仕様でforkからのPRにシークレットが渡らないため、そのままでは動きません。pull_request_target を使えば動かせますが、ベースリポジトリのシークレットで動くトリガーなので、PR側のコードを作業ディレクトリ直下にcheckoutしないなど、慎重な設定が必要です。
Q8. 使わなくなったときはどう外せばいいですか?
公式の手順は3段階です。まずワークフローファイル(claude.yml、レビューを入れていれば claude-code-review.yml)を削除し、次にSecretsを削除します。このときClaude Console側でもAPIキーを削除してください。最後に、Code Reviewなど他の機能で使っていなければ、Claude GitHub Appをアンインストールします。
まとめ
Claude Code GitHub Actionsは、@claude のメンションやGitHubのイベントをきっかけに、Claude Codeを自分のランナーで動かす公式のActionです。/install-github-app を使えば数分で導入でき、prompt を書けばPRの自動レビューや定期処理にも広げられます。
導入するときに押さえておきたいことは次のとおりです。
- 最初は
@claudeへの応答だけを入れる。慣れてからPR自動レビューやラベル起動を足す --modelを必ず指定する。未指定だとOpus 5.5で動く。定型の処理はSonnet 5.5で十分なことが多い--max-turns・timeout-minutes・concurrencyで上限を決める- ツールは必要なものだけ許可する。パブリックリポジトリでは
allowed_non_write_users・PAT・allowed_bots: '*'を避ける - 人のレビューは残す。Claudeは承認もマージもしないので、最終判断は人が行う
あわせて読みたい記事
このツールを自社のシステムや業務にどう組み込むか、ご提案します
この記事の著者

AI革命
編集部
AI革命株式会社の編集部です。最新のAI技術動向から実践的な導入事例まで、企業のデジタル変革に役立つ情報をお届けしています。豊富な経験と専門知識を活かし、読者の皆様にとって価値のあるコンテンツを制作しています。
最新記事

Siri AIの回数制限は何回?1日の上限・リセット時刻・iCloud+で最大20倍になる条件【iOS 27.3ベータ】
2026/11/17

Apple HomeViewとは?11月13日発売・299ドル・日本発売は未定|Siri AI搭載スマートホームハブの機能と評判
2026/10/14

SynthID Detectorとは?GoogleのAI生成判定サイトの使い方・OpenAI/NVIDIA製への対応・判定の限界
2026/10/10

ChatGPTの電子透かし(textGrain)とは?EU限定の仕組み・日本への影響・検出と回避の限界【2026年11月】
2026/10/12

MAI-Realtimeとは?Microsoft初の全二重音声モデル|MAI-Voice-2との違い・日本語対応・GPT-Live/Gemini Live比較【2026年11月最新】
2026/10/07

GPT-4o APIは2027年1月14日に廃止|4o mini・GPT-4.1も対象、移行先GPT-6 Lunaの料金と手順【2026年11月】
2026/10/15


