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 で消えました)。
対話モードは「呼んだら来る同僚」、自動モードは「決まった時間に回る見回り」です。PRの自動レビューは後者で作ります。
Code Review・/code-review・GitHub Actionsの使い分け
「Claude CodeでPRをレビューさせたい」だけなら、ワークフローを書かない道もあります。公式が並べているレビューの手段は5つです。
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
1GitHub CLIにログインする
ターミナルで gh auth login を実行します。権限が足りないと途中で言われたら、表示されたコマンドを打ってやり直します。
step
2リポジトリで claude を起動して /install-github-app を打つ
つなぎたいリポジトリのフォルダで claude を起動し、プロンプトに /install-github-app と入力します。
step
3Claude 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 が裏でやっていることを、自分の手で順に行います。
- Claude GitHub App をリポジトリにインストールする
- リポジトリの Settings → Secrets and variables → Actions で、
ANTHROPIC_API_KEYかCLAUDE_CODE_OAUTH_TOKENを登録する - 公式リポジトリの
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の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側でもキーを削除します。
私が普段使う自動化のリポジトリでは、.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キーにするよう公式も勧めています。
私はプライベートで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がワークフローごとに発行する身分証のようなトークン)の連携です。クラウド側で「このリポジトリのワークフローなら信用する」と設定するので、長く使える鍵をリポジトリに置かずに済みます。
どちらも permissions: に id-token: write が必須です。書き忘れるとOIDCのトークンが出ず、認証で落ちます。
公式の例は、GitHub側の身元に自作のAppを使っています(シークレット APP_ID・APP_PRIVATE_KEY)。公式のClaude GitHub Appを使うなら、トークンを作るステップと github_token の行を消します。
公開リポジトリでは、誰のコメントでもワークフロー自体は起動します。クラウドへのログインは書き込み権限の確認より先に走るので、権限のない人のコメントでも監査ログとActionsの時間が残ります。気になるなら、認証のステップより前に、コメントした人の権限を確かめるステップを置きます。
認証方式の選び方
ここまでの4つを、誰が・どのお金で回すかで並べます。
鍵を置かない方式は、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トークンを出すかどうかを決めます。行ごとの役割は次のとおりです。
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 は、既定の 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 以外にも変えられます。
ラベルや担当者で起動させるなら、ワークフローの 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の料金ページでは、非公開リポジトリの無料枠が分数ではなく金額で書かれています。
標準の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 と書いても何も起きない。入れた直後のつまずきは、たいていこの形です。症状ごとに確かめる場所を並べます。
最後の行は、古い /install-github-app で作ったレビュー用ワークフローで起きます。v2.1.229 より前に作ったファイルは、レビューをログにしか書きません。prompt に --comment を、claude_args に先ほどの --allowedTools の行を足せば、PRに書くようになります。
ベータ版の記事を見て書いたときの直し方
検索で出てくる記事には、@beta の時代の書き方がまだ残っています。v1 では入力が整理されたので、そのままでは動きません。
手元の自動実行とGitHub Actionsの分け方
Claude Codeを人の手を離れて動かす方法は、GitHub Actionsだけではありません。手元のMacで claude -p(対話せずに1回で実行するモード)をスケジューラーから呼ぶ方法もあります。
私はブログの文章の手直しなどを、毎朝 Mac の launchd から claude -p で回しています。このブログのリポジトリにも、自動化のスクリプトを置いたリポジトリにも、.github/workflows は1本もありません。
回している作業の相手は、手元の記事ファイルと、Mac に置いたデータです。PR や Issue を相手にする作業は、まだ自動化の中にありません。
どちらに置くかは、「何を相手にする作業か」で決まります。
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 に書き、自動レビューに広げる順番が無理がありません。
ワークフローのPRができたらマージして、Issueに「@claude このリポジトリの構成を説明して」と書けば、動いているか確かめられます。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

