本文へスキップ

本ページはプロモーションが含まれています

AI

Claude Code GitHub Actions|認証とレビュー

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約30分
SHEETS
12枚
Claude CodeGitHub Actions(認証とPR自動レビュー)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

PRに @claude とコメントすると、Claudeが同じスレッドで返事を書き、必要なら修正をコミットする。Claude Code GitHub Actionsを入れると、GitHubがこう動きます。

導入は2通りです。手元の Claude Code で /install-github-app を打つか、Claude GitHub Appを入れてシークレットとワークフローのファイルを自分で置くか。どちらもリポジトリの管理者権限が要ります。

認証はAPIキー(ANTHROPIC_API_KEY)か、Pro・Maxなどのサブスクで claude setup-token を打って作るトークン(CLAUDE_CODE_OAUTH_TOKEN)です。会社のAWSやGoogle Cloudがあれば、Bedrock・Vertex AIにも回せます。

迷いやすいのは、費用が2か所から出ることと、外部からのPRで何が起きるかです。ワークフローのYAMLを1行ずつ読みながら、そこまで順に片づけます。

この記事でわかること

  • Claude Code GitHub Actionsが @claude で動く仕組みと、2つのモード
  • /install-github-app と手動、2通りの導入手順
  • APIキー・サブスクのトークン・Bedrock/Vertex AI、認証方式の選び方
  • PRを自動でレビューさせるワークフロー例2本(YAMLつき)
  • 費用の内訳、外部からのPR・プロンプトインジェクションへの備え

PARTS LIST /目次

Claude Code GitHub Actionsとは?@claudeで動く仕組み

Claude Code GitHub Actionsとは、GitHubのワークフローの中でClaude Codeを動かす公式のアクション(anthropics/claude-code-action)です。IssueやPRのコメントで @claude と呼べば、Claudeがコードを読み、質問に答え、修正をコミットします。

動く場所はGitHubのランナー(Actionsの実行用マシン)です。自分のMacは閉じていてもかまいません。この点が、手元のターミナルで使うClaude Codeとの一番の違いです。

中身は、ランナーにClaude Codeを入れて、イベントの内容と一緒に起動する仕組みです。action.yml を読むと、Bunを入れて依存を入れ、本体のスクリプトを走らせる複合アクション(composite)になっています。

flowchart TD
    A["PRやIssueに<br>@claude とコメント"] --> B["GitHubがワークフローを起動"]
    B --> C{"コメントした人に<br>書き込み権限がある?"}
    C -->|"ない"| X["実行を止める"]
    C -->|"ある"| D["ランナーで<br>Claude Codeが起動"]
    D --> E["コードを読む・直す<br>テストを見る"]
    E --> F["同じスレッドの<br>コメントを更新"]
    E --> G["変更は claude/ の<br>ブランチへコミット"]

上の図のとおり、Claudeは勝手にPRを作りません。コミットしたあと「PRを作る」リンクをコメントに出し、押すのは人間です。

対話モードと自動モードの違い

アクションは、ワークフローに prompt があるかどうかで動き方を変えます。モードを指定する入力はありません(ベータ版にあった mode は v1 で消えました)。

モード切り替わる条件動き結果の出先
対話モードprompt を書かない@claude を含むコメント・レビュー・新しいIssueを待って応えるIssue・PRのコメント
自動モードprompt を書くメンションを待たず、PRが開いた・毎朝9時などのイベントで走る既定はワークフローのログ。指示すればPRにも書く

対話モードは「呼んだら来る同僚」、自動モードは「決まった時間に回る見回り」です。PRの自動レビューは後者で作ります。

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

「Claude CodeでPRをレビューさせたい」だけなら、ワークフローを書かない道もあります。公式が並べているレビューの手段は5つです。

手段始まり方動く場所使える人
Code ReviewPRの作成・push、または @claude reviewAnthropic側の環境Team・Enterpriseプランの組織(Ownerが有効化)
/code-review自分のセッションで打つ手元のClaude Code全プラン
UltrareviewClaude Codeから開始クラウドのサンドボックスclaude.aiアカウントでログインした人
GitHub Actionsワークフローのイベント自分のリポジトリのランナーAPIキーかクラウドの認証情報を持つ人(サブスクのトークンも可)
自作のサブエージェント・スキルセッション中に呼ぶClaude Codeを動かす場所作った人

Team・Enterpriseで「全部のPRを見てほしい」だけなら、Code Reviewが一番手間がかかりません。GitHub Actionsが向くのは、トリガー・モデル・プロンプトを自分で決めたいときです。個人のProやMaxで回したいときや、レビュー以外(Issueから実装、毎朝のまとめ)もさせたいときも、こちらを選びます。

Claude Code自体の始め方は、別の記事にまとめています。

あわせて読む

手元で使うときの設定は おすすめ設定の記事 にあります。/install-github-app を含む / のコマンドは スラッシュコマンド一覧、計画を立ててから動かす使い方は Planモードの記事 です。ここから先は、GitHubの上で動かすときにだけ要る話に絞ります。

導入方法は2通り|/install-github-appと手動

導入は「早いが手元のClaude Codeが要る」方法と、「手間はかかるが全部見える」方法の2択です。どちらもリポジトリの管理者権限が前提で、他人のリポジトリには入れられません。

/install-github-app は github.com のリポジトリ専用です。リモートが gitlab.com や bitbucket.org だと、案内を出して終わります(GitLabはGitLab CI/CD用の手順が別にあります)。手元で Claude Code を動かしていない、コマンドが失敗した、ワークフローを1行ずつ自分で決めたい。こういうときは手動を選びます。

/install-github-appで入れる7ステップ

前提はGitHub CLI(gh)が入っていて、gh auth login を済ませていることです。あとは画面の質問に答えていけば、最後にPRが1本できあがります。

step
1
GitHub CLIにログインする

ターミナルで gh auth login を実行します。権限が足りないと途中で言われたら、表示されたコマンドを打ってやり直します。

step
2
リポジトリで claude を起動して /install-github-app を打つ

つなぎたいリポジトリのフォルダで claude を起動し、プロンプトに /install-github-app と入力します。

step
3
Claude GitHub Appをインストールする

ブラウザに Claude GitHub App のページが開きます。インストールして対象リポジトリへのアクセスを許可し、ターミナルに戻ってEnterを押します。

step
4
入れるワークフローを選ぶ

「Set up GitHub Actions workflows」を選びます。@claude メンション用とPRレビュー用の2本が並ぶので、要らないほうは外します。すでに claude.yml があると更新の確認が出ます。

step
5
認証情報を選ぶ

サブスクで長期トークンを作るか、APIキーを貼るかを選びます。手元の Claude Code がAPIキーで動いていれば、この質問は飛ばされてそのキーが使われます。

step
6
変更内容を確かめて承認する

リポジトリに加える変更の一覧が出ます。読んでから「Yes, make these changes」を選びます。

step
7
できたPRをマージする

ワークフローのブランチがpushされ、PR作成画面が開きます。PRを作ってマージすれば有効になります。Issueに @claude と書いて試せます。

途中でやめたいときはEscです。書きかけの変更だけ終えて止まり、ブランチのpushやシークレットの保存など、済んだことを最後に一覧で出します。

手動で入れる3ステップ

手動の手順は3つだけです。/install-github-app が裏でやっていることを、自分の手で順に行います。

  1. Claude GitHub App をリポジトリにインストールする
  2. リポジトリの Settings → Secrets and variables → Actions で、ANTHROPIC_API_KEY か CLAUDE_CODE_OAUTH_TOKEN を登録する
  3. 公式リポジトリの examples/claude.yml を .github/workflows/ にコピーする

examples/claude.yml は見本ではなく、そのまま動くファイルです。置いた時点で @claude に反応し、ANTHROPIC_API_KEY で認証します。サブスクのトークンを使うなら、anthropic_api_key の行を claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }} に置き換えます。

組織の全リポジトリに広げるなら、Appを組織単位で1回入れ、シークレットも組織の Actions secrets に置きます。ワークフローは各リポジトリに置くか、再利用可能なワークフロー(reusable workflow)を1本作って呼び出します。

Claude GitHub Appが求める権限

インストールで一番引っかかるのは、Appが求める権限の多さです。Appは Code Review や Webのauto-fix など、GitHubとつながるClaudeの機能すべてで共有されています。そのため、GitHub Actionsだけなら使わない権限も含まれます。

権限アクセスGitHub Actionsで使うか
Contents読み書き◎ ファイルの変更
Issues読み書き◎ Issueへの返信
Pull requests読み書き◎ PRへのコメント・push
Actions・Checks・Workflows読み書き△ 他の機能用
Discussions・Repository hooks・Repository creation読み書き△ 他の機能用
Administration・Members・Metadata・Statuses など読み取り△ 他の機能用

GitHubのAppは、権限を一部だけ受け入れられません。会社の決まりで3つの権限しか許されないなら、Contents・Issues・Pull requestsだけの自作Appを作り、そのトークンを github_token に渡します。その場合、Code Reviewなど他の機能は公式Appのままです。

アクションが実行中に使うトークンは短命で、動いているリポジトリだけに限られます。別のリポジトリには届きません。

認証の設定|APIキー・サブスクのトークン・Bedrock/Vertex

Claudeを呼ぶための認証は、大きく3系統です。どれを選んでもワークフローの骨格は同じで、with: の1〜2行が変わるだけです。

選ぶ基準は「誰のお金で動かすか」です。APIキーはClaude Consoleの従量課金、サブスクのトークンは定額プランの枠を使います。Bedrock・Vertex AI・Foundryなら、自社のクラウドの請求に乗ります。

APIキーをシークレットに入れる

一番標準的なのがAPIキーです。Claude Console でキーを作り、リポジトリのシークレット ANTHROPIC_API_KEY に入れます。ワークフローでは次の1行で渡します。

anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

キーをワークフローのファイルに直接書くのは厳禁です。公開リポジトリなら、その瞬間に世界中へ公開されます。

シークレットを消してもキー自体は有効なままです。使うのをやめるときは、Console側でもキーを削除します。

LOG私のリポジトリ秘密のファイルは、置き場所ごとコミットしない決まりにしている

私が普段使う自動化のリポジトリでは、.env や認証情報の JSON を .gitignore に入れています。そのうえで、Claude Code 向けのルールファイルにも「絶対にコミットしない」ファイルを一覧で書いています。

設定ファイルを足したらダミー値の .example を必ず作る決まりもあり、作り忘れは pre-commit のチェックで止まります。GitHub Actions のシークレットも考え方は同じで、値はリポジトリの外、ファイルには名前だけです。

Pro・Maxのサブスクで動かす(claude setup-token)

個人のProやMaxでも動かせます。手元で claude setup-token を打ち、出てきたトークンをシークレット CLAUDE_CODE_OAUTH_TOKEN に入れます。手元の Claude Code v2.1.310 でヘルプを出すと、サブスクが要ると明記されていました。

claude setup-token --help
Usage: claude setup-token [options]

Set up a long-lived authentication token (requires Claude subscription)

Options:
  -h, --help  Display help for command

トークンの有効期限は1年です。/login と同じブラウザの承認画面が開き、承認するとトークンがターミナルに表示されます。どこにも保存されないので、その場でコピーします。使えるのはPro・Max・Ultra・Team・Enterpriseのプランです。

ワークフローでは、APIキーの行を次の1行に替えます。

claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

このトークンは、claude setup-token を打った人のサブスクに結びつきます。組織のシークレットで複数のリポジトリに配るなら、APIキーにするよう公式も勧めています。

LOG2026年10月Maxの週の上限ぎりぎりまで使っている身としては

私はプライベートでMaxプランを契約していて、週の利用上限の近くまで使っています。サブスクのトークンでCIを回すと、APIの請求は増えない代わりに、その実行分も同じ枠から引かれます。

手元の作業で上限に届く週があるなら、CIのレビューも同じ枠を分け合うことになります。サブスクのトークンを選ぶときは、月の請求額のほかに、この枠の残りも見ておく必要があります。

Bedrock・Vertex AI・Foundryを使う場合(OIDC)

会社のAWSやGoogle Cloudに Claude のモデルの利用許可があるなら、そちらに推論を回せます。with: に use_bedrock: "true"(Vertex AIは use_vertex、Microsoft Foundryは use_foundry)を書きます。

3つとも、認証はOIDC(GitHubがワークフローごとに発行する身分証のようなトークン)の連携です。クラウド側で「このリポジトリのワークフローなら信用する」と設定するので、長く使える鍵をリポジトリに置かずに済みます。

項目Amazon BedrockVertex AI(Google Cloud)
クラウド側で作るものGitHubのOIDCプロバイダーとIAMロールWorkload Identity Poolとサービスアカウント
シークレットAWS_ROLE_TO_ASSUMEGCP_WORKLOAD_IDENTITY_PROVIDER・GCP_SERVICE_ACCOUNT
ワークフローに足すステップaws-actions/configure-aws-credentials@v4google-github-actions/auth@v2
モデルの指定例--model us.anthropic.claude-sonnet-4-6--model claude-sonnet-5

どちらも permissions: に id-token: write が必須です。書き忘れるとOIDCのトークンが出ず、認証で落ちます。

公式の例は、GitHub側の身元に自作のAppを使っています(シークレット APP_ID・APP_PRIVATE_KEY)。公式のClaude GitHub Appを使うなら、トークンを作るステップと github_token の行を消します。

公開リポジトリでは、誰のコメントでもワークフロー自体は起動します。クラウドへのログインは書き込み権限の確認より先に走るので、権限のない人のコメントでも監査ログとActionsの時間が残ります。気になるなら、認証のステップより前に、コメントした人の権限を確かめるステップを置きます。

認証方式の選び方

ここまでの4つを、誰が・どのお金で回すかで並べます。

状況向く認証理由
個人の趣味のリポジトリ、Pro・Maxを契約済み○ CLAUDE_CODE_OAUTH_TOKEN追加の請求なしで試せる。期限は1年
チーム・組織で共有◎ ANTHROPIC_API_KEY個人のサブスクに結びつかない。Consoleで利用額を追える
長期の鍵を置きたくない◎ Workload identity federationGitHubのOIDCをClaude Consoleのサービスアカウントと交換
社内のAWS・Google Cloudに寄せたい◎ Bedrock・Vertex AI請求も権限管理も自社のクラウドで完結

鍵を置かない方式は、Consoleで連携のルールを作り、anthropic_federation_rule_id・anthropic_organization_id などの入力を渡します。ここでも id-token: write が要ります。

@claudeメンションのワークフローを1行ずつ読む

まずは対話モードの1本です。公式の例に、実行時間の上限(timeout-minutes)と往復回数の上限(--max-turns)だけを足しました。

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
    timeout-minutes: 30
    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 }}
          claude_args: "--max-turns 10"

if: の行が地味に効きます。if: を省くと、@claude を含まないコメントのたびにランナーが立ち上がって、すぐ終わります。アクション側でも呼び出しの言葉は確かめますが、起動した時点でActionsの時間は使っています。

この記事に載せたYAMLは、PyYAMLで読み込めることと、with: の入力名が公式の action.yml にあることを確かめています。GitHubに上げて動かしたものではありません。手元で読むと、on: が True というキーに化けていました。

OK: claude.yml
  name: Claude Code
  on: ['issue_comment', 'pull_request_review_comment']
  job claude: permissions={'contents': 'write', 'pull-requests': 'write', 'issues': 'write', 'id-token': 'write', 'actions': 'read'}
    uses: actions/checkout@v6 with=['fetch-depth']
    uses: anthropics/claude-code-action@v1 with=['anthropic_api_key', 'claude_args']

PyYAMLは古いYAML 1.1の規則で読むので、on を真偽値の「真」と解釈します。GitHub側は正しく読むので実害はありません。ただ、自分でワークフローを検査するスクリプトを書くと、ここで一度つまずきます。

permissionsの各行が要る理由

permissions: は、ワークフローに渡る GITHUB_TOKEN の権限と、OIDCトークンを出すかどうかを決めます。行ごとの役割は次のとおりです。

行役割外すと
contents: writeファイルを変えてpushする修正のコミットができない
pull-requests: writePRへのコメント・更新PRで返事を書けない
issues: writeIssueへのコメントIssueで返事を書けない
id-token: writeOIDCトークンを出す。既定のGitHub App認証に使うAppのトークンが取れず失敗する
actions: readCIの結果を読む「テストが落ちた理由を見て」に答えにくくなる

id-token: write はクラウドを使わなくても要ります。アクションはOIDCのトークンと引き換えに、Claude GitHub Appのトークンを受け取ってGitHubを操作するからです。

レビューだけさせるワークフローなら、contents も pull-requests も read で足ります。コメントはAppのトークンで書くので、ワークフロー側の書き込み権限は要りません。

@claudeを呼べる人は誰か

公開リポジトリだと、知らない人が @claude と書いたらどうなるのか。ここは心配しなくて大丈夫です。アクションは、Claudeを起動する前に2つの確認をします。

  • 書き込み権限:IssueやPRのイベントでは、呼んだ人にリポジトリへの書き込み権限が要る
  • 人間かどうか:botからの起動は、allowed_bots に名前を書かない限り断る(bot同士で呼び合う無限ループを防ぐ)

書き込み権限のない人にも使わせたいときは allowed_non_write_users がありますが、公式は「大きなセキュリティ上のリスク」と書いています。使うなら github_token: ${{ secrets.GITHUB_TOKEN }} と組み合わせ、許可するツールも絞ります。

schedule(cron)のように人が書いていないイベントは、書き込み権限の確認を飛ばします。botの確認だけは残ります。

ハマりポイント
github_token に GITHUB_TOKEN を渡すと、Claudeのコミットで CI が動かない

GitHub は、既定の GITHUB_TOKEN で作られたコミットではワークフローを起動しません。github_token: ${{ secrets.GITHUB_TOKEN }} を渡すと、Claude が直したコミットにテストが走らず、「通ったのか分からない PR」が残ります。

特に理由がなければ github_token は書かずに Claude GitHub App で認証させるか、自作 App のトークンを渡します。

@claudeへの頼み方と呼び出し方の変え方

ワークフローが入ったら、IssueかPRのコメントに用件を書くだけです。公式が挙げている頼み方は、実装・相談・修正の3種類です。

@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は同じIssueやPRにコメントを1件書き、作業の進み具合に合わせてそのコメントを書き換えていきます。Issueから実装を頼んだ場合は、変更を claude/ で始まるブランチにコミットし、PRを作るリンクをコメントに添えます。

呼び出し方は @claude 以外にも変えられます。

入力既定使いどころ
trigger_phrase@claude別の言葉で呼びたい(他のbotと名前がぶつかる等)
label_triggerclaudeIssueにラベルを付けたら動かす
assignee_triggerなし指定したユーザーが担当になったら動かす
use_sticky_commentfalseコメントを1件にまとめ、毎回そこを書き換える
branch_prefixclaude/Claudeが作るブランチの頭を変える

ラベルや担当者で起動させるなら、ワークフローの on: に issues の labeled・assigned を足し、if: の条件も合わせて直します。公式の examples/claude.yml は、Issueの作成・担当者の設定・レビューの投稿も拾う形になっているので、広げたいときの下敷きに使えます。

PRレビューを自動化するワークフロー例2つ

PRが開くたびにレビューさせるのは、自動モードの代表的な使い方です。作り方は2つあります。公式のプラグインに任せるか、プロンプトを自分で書くかです。

前者は /install-github-app で選べるレビュー用ワークフローと同じ中身で、手を入れる場所がほとんどありません。後者は観点や対象ファイルを絞れる代わりに、許可するツールを自分で並べる必要があります。

公式プラグインcode-reviewで回す

公式の例は、code-review プラグインを入れて、そのスキルを prompt で呼びます。ここでは連続pushで実行が重ならないよう、concurrency と timeout-minutes を足しました。

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
concurrency:
  group: claude-review-${{ github.event.pull_request.number }}
  cancel-in-progress: true
jobs:
  review:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    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-plugins-official.git"
          plugins: "code-review@claude-plugins-official"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

効いているのは2か所です。--comment を付けると、指摘は問題の行へのインラインコメントとして、何も無ければ要約コメント1件として、PRに書かれます。付けないと何も書かず、結果はワークフローのログにしか残りません。

claude_args の --allowedTools も消せません。インラインコメントを書く道具(MCPサーバー)は、ここで名前を挙げたときだけ起動するからです。スキル側の設定に同じ道具が書いてあっても、この行は要ります。

Claudeは下書きのPR、閉じたPR、自動生成や小さすぎてレビュー不要と判断したPR、すでにClaudeのコメントがあるPRを飛ばします。

対象パスと観点を絞った自作レビュー

プラグインに任せると、何を指摘するかは向こうの基準です。「Javaのファイルだけ、バグと例外処理だけ見てほしい」なら、prompt を自分で書きます。公式の pr-review-filtered-paths.yml を下敷きに、Javaのリポジトリ向けに直した例です。サブスクのトークンで動く形にしています。

name: Claude Review (Java only)
on:
  pull_request:
    types: [opened, synchronize]
    paths:
      - "src/**/*.java"
      - "pom.xml"
jobs:
  review:
    runs-on: ubuntu-latest
    timeout-minutes: 15
    permissions:
      contents: read
      pull-requests: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          prompt: |
            REPO: ${{ github.repository }}
            PR NUMBER: ${{ github.event.pull_request.number }}

            このPRの差分を日本語でレビューしてください。
            見るのはバグ・nullの扱い・例外処理・SQLの組み立ての4点だけです。
            書式や命名の好みは指摘しないでください。
            指摘は該当行へのインラインコメントで書き、最後に gh pr comment で要約を1件だけ残してください。
          claude_args: |
            --max-turns 8
            --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"

paths: に書いたファイルが変わったPRでしか起動しないので、READMEの誤字直しで時間を使いません。--allowedTools には、差分を読む gh pr diff・gh pr view と、書き込む gh pr comment・インラインコメントの道具だけを並べています。

プロンプトは「見ない観点」まで書くのがコツです。書かないと、命名やインデントの好みの指摘が混ざってきます。レビューの基準を毎回書くのが面倒なら、リポジトリ直下の CLAUDE.md に書いておけば、実行のたびに読まれます。たとえば次のような数行です。

## レビューの基準
- null を返すメソッドには Optional を使う
- 例外を握りつぶす catch(空の catch や printStackTrace だけ)は指摘する
- SQL は文字列連結で組み立てず、PreparedStatement を使う
- 命名・インデント・import の順番は指摘しない(フォーマッターに任せる)

CLAUDE.md は手元の Claude Code とCIの両方で読まれるので、手元で守らせている決まりが、そのままレビューの基準にもなります。毎回読まれるぶん、長くするとトークンも毎回増えます。書き方は CLAUDE.mdの記事 にまとめています。

読み込み確認の結果は、3本とも同じ形で通りました。

OK: claude-code-review.yml
  name: Code Review
  on: ['pull_request']
  job review: permissions={'contents': 'read', 'pull-requests': 'read', 'issues': 'read', 'id-token': 'write'}
    uses: actions/checkout@v6 with=['fetch-depth']
    uses: anthropics/claude-code-action@v1 with=['anthropic_api_key', 'claude_args', 'plugin_marketplaces', 'plugins', 'prompt']
OK: claude-review-paths.yml
  name: Claude Review (Java only)
  on: ['pull_request']
  job review: permissions={'contents': 'read', 'pull-requests': 'read', 'id-token': 'write'}
    uses: actions/checkout@v6 with=['fetch-depth']
    uses: anthropics/claude-code-action@v1 with=['claude_args', 'claude_code_oauth_token', 'prompt']

毎朝のまとめなど、レビュー以外の自動化

prompt があれば、イベントはPRでなくてもかまいません。公式の例には、毎朝9時(UTC)に前日のコミットと未解決のIssueをまとめる schedule のワークフローがあります。

注意点は2つあります。素の文章の prompt では、Claudeはシェルも GitHub API も使えません。要る道具を --allowedTools か settings の permissions.allow で許可します。もう1つはGitHub側の仕様で、schedule はデフォルトブランチでしか動かず、公開リポジトリでは60日間動きがないと止まります。

ほかにも公式の examples/ には、CIの失敗を自動で直す例、Issueの振り分け、重複Issueの検出、テスト失敗の分析など、そのまま使えるワークフローが並んでいます。

費用は2種類|Actionsの分とClaudeの分

費用は2か所から出ます。GitHub Actionsのランナーの時間と、Claudeのトークンです。片方だけ見て「安い」と判断すると、もう片方で驚きます。

請求先も別々です。ランナーの時間はGitHubの請求に、トークンはClaude Consoleかサブスク、クラウドを使うならAWSやGoogle Cloudの請求に乗ります。

GitHub Actionsの実行時間

アクションはGitHubのランナーで動くので、Actionsの時間を使います。GitHubの料金ページでは、非公開リポジトリの無料枠が分数ではなく金額で書かれています。

プラン標準ランナーの扱い
公開リポジトリ標準のGitHubホストランナーは無料
GitHub Free(非公開)毎月12ドル分まで含まれる
GitHub Pro・Team(非公開)毎月18ドル分まで含まれる
GitHub Enterprise Cloud(非公開)毎月300ドル分まで含まれる

標準のLinuxランナー(2コア)は1分0.006ドルです。12ドルを0.006ドルで割ると、Freeの枠は標準Linuxでおよそ2,000分にあたります。最新の金額は GitHub Actionsの課金のページ で確かめてください。

Claudeのトークン料金とサブスク枠

もう1つがClaudeの分です。APIキーなら、プロンプトと応答の長さ、作業の複雑さ、コードベースの大きさに応じて、トークンの従量課金がかかります。単価は Claudeの料金ページ にあります。

サブスクのトークンなら、APIの請求の代わりにサブスクの利用枠を使います。請求額は増えませんが、手元の作業と同じ枠を分け合います。

トム
トム

レビュー1回でいくらかかるかは、PRの大きさとモデルで変わるので一概に言えないんですよね。最初の1〜2週間は、Consoleの利用額かサブスクの残り枠を毎日見るのが確実です。

手元で Claude Code の料金を確かめる方法は、別記事にまとめています。Claude Code料金確認と日本円換算 を見ると、どこで数字を見ればいいかが分かります。

費用を抑える設定5つ

2つの費用は、どちらも「1回の実行でどれだけ働かせるか」で決まります。公式の勧めとGitHubの機能から、効くものを5つ並べます。

  • claude_args に --max-turns を書いて、往復の回数に上限を付ける
  • ジョブに timeout-minutes を書いて、止まらない実行を切る
  • concurrency と cancel-in-progress: true で、連続pushの古い実行を止める
  • paths: と if: で、関係ないPRやコメントで起動させない
  • CLAUDE.md を短く保つ(毎回読まれるので、長いほど毎回トークンを使う)

@claude への頼み方も効きます。「直して」より「user_dashboard.ts の TypeError を直して」のほうが、Claudeが探し回る往復が減ります。Issueのテンプレートで前提を先に書かせるのも同じ理由です。大きめの変更なら、手元のPlanモードで計画を詰めてから、その計画をIssueに貼って @claude を呼ぶ手もあります。

セキュリティで押さえる5点

Claudeにリポジトリの書き込み権限を渡す以上、事故の形を先に知っておきたいところです。公式の docs/security.md が挙げる注意のうち、個人や小さなチームで効くものを5つに絞りました。

設定の多くは、既定で安全側に倒れています。何もしなくても守られている部分と、自分で決める部分を分けて読むと、触る場所が少ないことが分かります。

外部からのPR(fork)とシークレット

公開リポジトリでは、forkから来たPRで動くワークフローに、GitHubがシークレットを渡しません。そのため公式のレビュー例は、forkのPRでは認証できず、同じリポジトリのブランチから来たPRでしか動きません。

アクション側にも2つの備えがあります。allow_fork_prs を "false" にすると、forkのPRを最初から無視します(既定は true)。restrict_untrusted_prs(既定 true)は、書き込み権限のない人のPRで働きます。Claudeの設定ファイルはベースブランチから読み、パッケージマネージャー・テスト・シェルなど、リポジトリのコードを動かすコマンドは止めます。

プロンプトインジェクション

プロンプトインジェクションとは、Claudeが読む文章の中に「この指示を無視して〜しろ」と仕込む攻撃です。IssueやPRの本文、コードのコメントは、誰でも書けます。

アクションは、読み込む前にHTMLコメント、見えない文字、画像の代替テキスト、隠しHTML属性、HTMLエンティティを取り除きます。ただし公式も「新しい回避手口は出てくる」と書いていて、外部の人が書いた内容は人が見るよう勧めています。コメントを読む相手を include_comments_by_actor・exclude_comments_by_actor で絞ることもできます。

既定の権限モードは auto mode です。公式は「auto mode は審査であって境界ではない」としていて、厳しく縛りたいなら --permission-mode acceptEdits か default を使います。auto mode の中身は別記事で書いています。

あわせて読む

allowedToolsで道具を絞る

Claudeが使える道具は、claude_args の --allowedTools で決まります。レビューだけなら、差分を読む道具とコメントを書く道具があれば足ります。

Bash を丸ごと許すと、curl で外に送る、環境変数を読むといった道具まで渡ります。Bash(gh pr diff:*) のように、コマンドの頭で区切って許すのが基本です。書き方は手元の Claude Code の権限設定と同じなので、おすすめ設定の記事 の permissions の節がそのまま使えます。

Claudeのpushは自分のブランチにしか届かず、他のブランチは更新できません。PRを作るのも人間のクリックです。マージ前に人が見る流れは、設定を変えても崩さないほうが安全です。

ログに秘密を出さない(show_full_output)

show_full_output を true にすると、道具の出力・環境の情報・ファイルの中身・APIの応答まで、全部ログに出ます。公開リポジトリのログは誰でも読めます。既定は false で、公式も切ったままにするよう勧めています。

見落としやすいのは、デバッグ用の ACTIONS_STEP_DEBUG を true にすると、show_full_output が自動でオンになる点です。調べものが終わったら、デバッグの設定も戻します。

pull_request_targetを使うとき

pull_request_target と workflow_run は、ベースリポジトリのシークレット付きで動くイベントです。forkのPRでもシークレットが渡るぶん、扱いを間違えると危険です。

公式の注意は、アクションが動く前に信頼できないコード(PRの先頭)を作業フォルダの直下にチェックアウトしないことです。ベースブランチを既定でチェックアウトし、PRのコードはサブフォルダに置いて --add-dir で渡す形を勧めています。迷うなら、まずは pull_request で組みます。

動かないときの確認ポイント

@claude と書いても何も起きない。入れた直後のつまずきは、たいていこの形です。症状ごとに確かめる場所を並べます。

症状よくある原因確かめること
@claude に反応しないAppが入っていない・シークレットが無いAppのインストール先、Settings の Secrets、Actionsが有効か
反応しない(Appは入っている)書き方が違う@claude が単語として書かれているか(/claude や @claude-bot は不可)
反応しない(他の人のコメント)書き込み権限が無いコメントした人の権限。botなら allowed_bots
Claudeのコミットで CI が動かないgithub_token に GITHUB_TOKEN を渡している行を消してAppで認証させる
認証エラーキーやトークンが無効・期限切れ手元の claude で同じ認証が通るか
Bedrock・Vertexで認証エラーOIDCの設定ずれid-token: write、信頼設定のリポジトリ名、シークレット名
レビューがログにしか出ない--comment が無い・古いワークフローprompt の --comment と claude_args の行

最後の行は、古い /install-github-app で作ったレビュー用ワークフローで起きます。v2.1.229 より前に作ったファイルは、レビューをログにしか書きません。prompt に --comment を、claude_args に先ほどの --allowedTools の行を足せば、PRに書くようになります。

ベータ版の記事を見て書いたときの直し方

検索で出てくる記事には、@beta の時代の書き方がまだ残っています。v1 では入力が整理されたので、そのままでは動きません。

ベータ版v1
anthropics/claude-code-action@betaanthropics/claude-code-action@v1
mode: tag など削除(自動で判定)
direct_promptprompt
max_turns・modelclaude_args に --max-turns・--model
custom_instructionsclaude_args に --append-system-prompt

手元の自動実行とGitHub Actionsの分け方

Claude Codeを人の手を離れて動かす方法は、GitHub Actionsだけではありません。手元のMacで claude -p(対話せずに1回で実行するモード)をスケジューラーから呼ぶ方法もあります。

LOGいまの運用私の自動実行は、全部Macのlaunchdの側にある

私はブログの文章の手直しなどを、毎朝 Mac の launchd から claude -p で回しています。このブログのリポジトリにも、自動化のスクリプトを置いたリポジトリにも、.github/workflows は1本もありません。

回している作業の相手は、手元の記事ファイルと、Mac に置いたデータです。PR や Issue を相手にする作業は、まだ自動化の中にありません。

どちらに置くかは、「何を相手にする作業か」で決まります。

比べる点手元で claude -pGitHub Actions
動く場所自分のMac(電源とスリープ次第)GitHubのランナー
得意な相手手元のファイル・ローカルのデータ・個人の作業PR・Issue・CI・チームの共有物
認証手元のログインをそのまま使えるシークレットかOIDCを用意する
結果の出先ファイル・通知など自由PR・Issueのコメント、ワークフローのログ
費用Claudeの分だけClaudeの分+Actionsの時間

PRやIssueが相手ならGitHub Actions、手元のデータが相手なら claude -p が素直です。claude -p の使い方とlaunchdでの実例は、こちらにあります。

あわせて読む

よくある質問

Q1. Claude Code GitHub Actionsは無料で使えますか?

アクション自体は無料で、MITライセンスで公開されています。費用はGitHub Actionsの実行時間とClaudeのトークンの2つです。公開リポジトリなら標準ランナーは無料なので、サブスクのトークンで動かせば追加の請求なしで試せます。

Q2. MaxプランやProプランで使えますか?

使えます。手元で claude setup-token を打ち、表示されたトークンをシークレット CLAUDE_CODE_OAUTH_TOKEN に入れて、claude_code_oauth_token の入力で渡します。トークンの期限は1年で、使った分はサブスクの利用枠から引かれます。

Q3. /install-github-app と手動、どちらで入れるべきですか?

手元でClaude Codeを使っているなら /install-github-app が早く、Appの導入からシークレットの保存、ワークフローのPRまで進みます。中身を1行ずつ決めたい、手元にClaude Codeがない、GitLabやBitbucketを使っている場合は手動です(GitLabは別の手順があります)。

Q4. PRの自動レビューを入れるには、何を書けばいいですか?

pull_request をトリガーにして、prompt でレビューを指示するワークフローを置きます。一番手軽なのは、公式の code-review プラグインを plugins で入れて /code-review:code-review --comment を呼ぶ形です。--comment を付けないと、結果はログにしか出ません。

Q5. forkから来たPRでも動きますか?

公開リポジトリでは、forkのPRで動くワークフローにGitHubがシークレットを渡しません。そのためAPIキーやトークンで認証する例は、forkのPRでは動きません。pull_request_target で無理に動かす場合は、PRのコードを作業フォルダ直下にチェックアウトしないなど、公式の注意を守ります。

Q6. Bedrockで動かすには何が要りますか?

AWS側にGitHubのOIDCプロバイダーと、Bedrockの呼び出しを許したIAMロールを作り、ロールのARNをシークレット AWS_ROLE_TO_ASSUME に入れます。ワークフローは aws-actions/configure-aws-credentials でログインし、アクションに use_bedrock: "true" を渡します。id-token: write の権限が必須です。

Q7. Claudeが勝手にmainへpushしたりしませんか?

しません。Claudeのコミットは claude/ で始まる自分のブランチに入り、他のブランチは更新できません。PRもClaudeは作らず、コメントに出したリンクを人が押して作ります。マージするかどうかは、最後まで人が決めます。

Q8. Code Reviewとの違いは何ですか?

Code Reviewは、Team・Enterpriseプラン向けのサービスです。Anthropic側の環境でPRをレビューし、ワークフローのファイルが要りません。GitHub Actionsは自分のリポジトリのランナーで動き、トリガーやプロンプト、モデルを自分で決められます。個人のProやMaxで回せるのはGitHub Actionsのほうです。

まとめ|まず@claudeの1本から入れる

Claude Code GitHub Actionsは、@claude で呼ぶ対話モードと、prompt で決まった時に回す自動モードの2つで動きます。導入は /install-github-app か手動、認証はAPIキー・サブスクのトークン・クラウドのOIDCから選びます。

押さえる3点

  • 認証は「誰のお金で回すか」で選ぶ。個人ならサブスクのトークン、共有ならAPIキー
  • 費用はActionsの時間とClaudeのトークンの2つ。--max-turns・timeout-minutes・paths: で上限を付ける
  • forkのPR・プロンプトインジェクション・--allowedTools・ログの4点は、既定値を崩さない

いきなり自動レビューを全PRに入れるより、@claude のワークフローを1本入れて、自分のIssueで何度か呼んでみるほうが、費用の感覚と癖がつかめます。そのうえで、レビューの観点を CLAUDE.md に書き、自動レビューに広げる順番が無理がありません。

NEXT STEP
自分の練習用リポジトリで claude を起動し、/install-github-app を最後まで進めてみる。

ワークフローのPRができたらマージして、Issueに「@claude このリポジトリの構成を説明して」と書けば、動いているか確かめられます。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

AI

TOC