Claude Code特集2026年10月更新

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

公開日: 2026/04/03
更新日: 2026/10/16
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公式ドキュメントの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

新しいブランチ(既定の接頭辞は claude/)

開いている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のみ

/code-review

セッションの中で自分のブランチをレビューするコマンド

手元のClaude Code

全プラン

Ultrareview

Claude Codeから起動するクラウドレビュー

クラウドのサンドボックス

claude.aiアカウントが必要

Claude Code on the web

クラウドで動くセッション。PRの自動修正もある

Anthropicのクラウド

—

セットアップ手順(3つの方法)

Anthropic公式のGitHubリポジトリ anthropics/claude-code-action

出典:GitHub「anthropics/claude-code-action」

個人や小さなチームなら、まずはクイックセットアップで十分です。設定を一行ずつ確かめたい場合は手動で、組織の複数リポジトリに広げる場合や権限を最小限に絞りたい場合は3つ目の方法を選びます。

方法

向いているケース

対応する認証

クイックセットアップ(/install-github-app)

個人・小規模チーム。まず動かしたい

Claude APIキー、サブスク

手動セットアップ

設定内容を確かめながら入れたい

6方式すべて

組織展開・独自GitHub App

複数リポジトリへの展開、最小権限にしたい組織

6方式すべて

方法1: クイックセットアップ(個人・小規模チーム向け)

ローカルのClaude Codeから、対話形式で一通り設定できます。前提はリポジトリの管理者権限と、GitHub CLIのログイン(gh auth login)です。GitHub CLIが入っていないと警告が出ます。

  1. 対象リポジトリのディレクトリで claude を起動する
  2. セッション内で /install-github-app を実行する
  3. Claude GitHub Appをインストールする(「Skip for now」でAppだけ入れて止めることもできる)
  4. 認証用のシークレットを選ぶ。APIキーがすでにあれば再利用でき、無ければ「サブスクで長期トークンを作る」か「APIキーを貼り付ける」を選ぶ
  5. ワークフローファイル(claude.yml、レビュー用を選べば claude-code-review.yml も)がブランチにプッシュされ、ブラウザでPR作成画面が開く
  6. その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(エンタープライズ向け)

組織の複数リポジトリに広げる場合は、次の順で進めると管理が楽になります。

  1. Claude GitHub Appを組織に1回インストールする
  2. 組織のActionsシークレットに認証情報を登録する。共有するならAPIキーを使う(サブスクのOAuthトークンは発行した人のサブスクに紐づくため、組織での共有には向かない)
  3. 各リポジトリにワークフローを置くか、reusable workflow(再利用可能なワークフロー)にまとめて呼び出す

権限を最小限にしたい場合は、独自のGitHub Appを作ります。公式のClaude GitHub Appは、Code Reviewやweb版の自動修正と共用のため多くの権限を求め、一部だけを承認することはできません。いっぽう、Actionが実際に使うのは「Contents」「Issues」「Pull requests」の読み書きだけです。

  1. GitHubで独自のGitHub Appを作る(webhookは無効、権限はContents・Issues・Pull requestsの読み書きだけ)
  2. App IDと秘密鍵をSecretsに登録する
  3. ワークフローで 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キー

ANTHROPIC_API_KEY(入力 anthropic_api_key)

Claude APIの従量課金

もっとも手軽。チームで共有する場合の基本

サブスクのOAuthトークン

CLAUDE_CODE_OAUTH_TOKEN(入力 claude_code_oauth_token)

Pro/Max/Team/Enterpriseの利用枠

個人でサブスクを契約済み。発行者のサブスクに紐づくので組織共有には不向き

ワークロードIDフェデレーション(OIDC)

anthropic_federation_rule_id・anthropic_organization_id など。長期シークレット不要

Claude APIの従量課金

APIキーをSecretsに置きたくない組織

Amazon Bedrock

use_bedrock: "true"+AWS_ROLE_TO_ASSUME

AWS

AWSに請求を集約したい企業

Google Cloud の Agent Platform(旧 Vertex AI)

use_vertex: "true"+GCP_WORKLOAD_IDENTITY_PROVIDER・GCP_SERVICE_ACCOUNT

Google Cloud

Google Cloudに請求を集約したい企業

Microsoft Foundry

use_foundry: "true"+AZURE_CLIENT_ID・AZURE_TENANT_ID・AZURE_SUBSCRIPTION_ID

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設定

GitHub Actionsでビルドからデプロイまでのワークフローを自動化するイメージ

出典:GitHub「GitHub Actions」

@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 }} --failed

workflow_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 にもとづいて整理しました。

入力

内容

既定値

prompt

Claudeへの指示(文章またはスキル呼び出し)。省略するとトリガーフレーズに反応する

—

claude_args

Claude CodeのCLI引数をそのまま渡す

空

anthropic_api_key / claude_code_oauth_token

認証情報

—

github_token

独自GitHub Appを使うときだけ指定

—

trigger_phrase

反応する呼び出し語

@claude

assignee_trigger

Issueにアサインされると起動するユーザー名

—

label_trigger

Issueに付くと起動するラベル名

—

base_branch / branch_prefix

ブランチの起点と接頭辞

— / claude/

settings

Claude Codeの設定(JSON文字列またはファイルパス)

空

track_progress

進捗コメントを付けるモードを強制する

false

use_sticky_comment

PRへのコメントを1件にまとめる

false

include_fix_links

レビューの指摘に「Fix this」リンクを付ける

true

classify_inline_comments

確定前のインラインコメントをHaikuで分類してから投稿する

true

allowed_bots

起動を許すbot(名前を列挙)

空(許可なし)

allowed_non_write_users

書き込み権限のないユーザーにも起動を許す(危険)

空

include_comments_by_actor / exclude_comments_by_actor

読み込むコメントの投稿者を絞る(除外が優先)

空

use_commit_signing / ssh_signing_key

コミット署名

false / 空

additional_permissions

actions: read などの追加権限

空

plugin_marketplaces / plugins

プラグインの読み込み

空

use_bedrock / use_vertex / use_foundry

クラウド経由で使う

false

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

--model claude-sonnet-5-5

Issueからの実装、込み入ったバグ修正

Claude Opus 5.5

--model claude-opus-5-5

ラベル付けや仕分けなど大量で単純な処理

Claude Haiku 5.5

--model claude-haiku-5-5

大規模なリファクタリングの設計など難しい推論

Claude Fable 5.1

--model 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

claude-fable-5-1

$10

$50

Claude Opus 5.5(Claude Codeの既定)

claude-opus-5-5

$4

$20

Claude Sonnet 5.5

claude-sonnet-5-5

$2

$10

Claude Haiku 5.5

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版にもそのまま使えます。

  1. 2〜3個のリポジトリで1〜2週間試す
  2. Claude Consoleで、1回あたりの平均費用を確認する
  3. 「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キー+--model claude-sonnet-5-5+--max-turns

費用をさらに抑える工夫は、Claude Codeのコスト最適化にまとめています。

ベータ版(@beta)からv1.0への移行

@beta のまま動かしている場合は、v1の書き方に直しておきましょう。v1.0では入力の多くが claude_args と settings にまとめられています。

旧(ベータ)

新(v1)

@beta

@v1

mode: "tag" / mode: "agent"

削除(自動で判定)

direct_prompt / override_prompt

prompt

custom_instructions

claude_args: --append-system-prompt

max_turns

claude_args: --max-turns

model / fallback_model

claude_args: --model

allowed_tools / disallowed_tools

claude_args: --allowedTools など

mcp_config

claude_args: --mcp-config

claude_env

settings(JSON形式)

移行の手順は次のとおりです。

  1. ワークフローの @beta を @v1 に変える
  2. 廃止された入力を、v1の書き方(claude_args または settings)に直す
  3. mode の指定を消す
  4. ついでに permissions・actions/checkout@v6・if: の条件を、公式の基本ワークフローに合わせて見直す

セキュリティ対策:導入前に確認すべきポイント

GitHub DocsのActionsドキュメント(セキュリティ強化ガイド)

出典:GitHub Docs「Security hardening for GitHub Actions」

既定の設定のままでも、起動できるのは「リポジトリに書き込み権限を持つ人間」に限られています。危ないのは、起動できる範囲を広げる設定を入れたときと、パブリックリポジトリで外部の入力を読ませるときです。

既定で有効な2つのチェック

  • 書き込み権限:Issue/PR系のイベントでは、起動したユーザーにリポジトリへの書き込み権限が必要。workflow_run では、実行者と元のワークフローの実行者の両方が確かめられる
  • 人間かどうか:botは allowed_bots に載っていない限り拒否される(無限ループの防止)

パブリックリポジトリのチェックリスト

確認項目

理由

allowed_non_write_users を使っていないか

公式が「大きなセキュリティリスク」と明記する設定。使うならIssueのラベル付けのような権限の小さいワークフローに限り、github_token: ${{ secrets.GITHUB_TOKEN }} と組み合わせ、ツールも Bash(gh issue view:*) のように絞る

個人アクセストークン(PAT)を渡していないか

プロンプトインジェクションで少しずつ外に持ち出されるおそれがある

allowed_bots: '*' にしていないか

許可したbotは権限確認を受けない。パブリックでは誰が作ったAppでも起動できてしまうので、名前を列挙する

pull_request_target / workflow_run でPR側のコードを直下にcheckoutしていないか

ベースリポジトリのシークレットで動くため。PRのファイルが要るなら別ディレクトリにcheckoutして --add-dir で渡す

hooksなどからPR側の package.json のスクリプトを呼んでいないか

.claude/ や CLAUDE.md はベースブランチに戻されるが、package.json・lockfile・Makefileなどは戻らない。バージョンを固定したツールを直接呼ぶ

読み込むコメントの投稿者を絞っているか

include_comments_by_actor / exclude_comments_by_actor で、信頼できない人の書き込みを入れない

show_full_output をオンにしていないか

ツールの出力やファイルの中身がログに出て、パブリックでは誰でも読める。ACTIONS_STEP_DEBUG=true にすると自動でオンになる点にも注意

クラウド経由の場合、最初に書き込み権限を確かめるステップを置いたか

パブリックでは誰のコメントでもワークフロー自体は起動し、権限チェックの前にクラウドへのログインが走る(監査ログと実行時間を消費する)

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 にメンションしても反応しない

  1. Claude GitHub Appが入っているか:リポジトリの Settings > GitHub Apps で確認する
  2. コメントした人に書き込み権限があるか:権限のない人やbotのコメントには反応しない
  3. @claude が単語として書かれているか:@claude-bot のように前後がつながっていると反応しないことがある
  4. 認証情報のSecretsが正しいか:名前のつづりと、値の前後の空白を確認する
  5. ワークフローのトリガーと if: 条件:issue_comment と pull_request_review_comment が入っているか。ワークフローがデフォルトブランチにマージ済みか
  6. 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

@claude、ラベル、イベント、cron

設定

CLAUDE.md+settings.json

CLAUDE.md+ワークフローYAML(settings 入力も可)

ツールの権限

実行時に都度確認できる

事前に許可したものだけ

ローカルでの基本操作はClaude Codeの使い方ガイドを見てください。GitHubのイベントをきっかけにClaudeを動かす方法は、Anthropicのクラウドで動くClaude Code Routinesという選択肢もあります。

Code Review・/code-reviewとの使い分け

PRのレビューだけが目的で、Team/Enterpriseプランを契約しているなら、Code Reviewのほうが手間は少なく済みます。ワークフローの管理が要らず、Anthropicのインフラで動くからです。いっぽう、レビュー以外の自動化もしたい、モデルや実行条件を細かく決めたい、個人プランで使いたい、という場合はGitHub Actions版が向いています。

比較項目

GitHub Actions版

Code Review

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

AI・システム開発は、開始価格を公開しています

既存システムの改修 100万円〜・PoC 300万円〜(税別)。相談内容を送っていただくと、2営業日以内に担当者からご返信します