Max Nardit
← 記事
17 mindev

Claude Code GitHub Actions: PR の作者にシークレットを渡さずに、リポジトリで @claude を設定する

インストールはコマンド 1 つで終わり、アクションのデフォルトはワークフローファイルに書かれている以上のことをします。それでも、3 つの制御は名前が示すほどには止めてくれません。書き込み権限のチェック、permissions ブロック、外部からのプルリクエストに対するコマンド制限です。

目次

Claude Code GitHub Actions は、Claude Code を GitHub のランナー上で動かします。誰かが Issue やプルリクエストに @claude と書くか、PR やスケジュールでワークフローが起動すると、Claude はコンテキストを読み、ファイルを編集し、ブランチにプッシュし、コメントで返信できます。設定はコマンド 1 つ、またはシークレット 1 つとワークフローファイル 1 つです。

これを実行するジョブは、Anthropic の認証情報と書き込み権限を持つ GitHub トークンを抱えています。そして入力はテキストで、多くは知らない人が書いたものです。アクションにはそのための本物のガードが付いています。ただし 3 つは、名前が示すほどには止めてくれません。書き込み権限のチェックが決めるのは誰が実行を始められるかで、Claude が誰の言葉を読むかではありません。ジョブの permissions: ブロックが絞るのは、関わる 2 つの GitHub トークンのうち 1 つだけです。そして外部からのプルリクエストに対するコマンド制限は、ただのリストです。以下の内容は、Anthropic のドキュメント、アクション自身のセキュリティドキュメント、GitHub のガイダンスを 2026 年 11 月 22 日に読んだものに基づきます。v1 タグは GitHub API で解決し、claude setup-token --help も実行しました。アクション自体は動かしていません。

Claude Code GitHub Actions を始める前に何が必要か

リポジトリの管理者権限と、認証情報が 1 つです。ドキュメントによると、どちらの設定方法でも管理者権限が必要で、/install-github-app は github.com のリモートでしか動きません。gitlab.com や bitbucket.org では通知を表示して終了します。Organization では、アプリのインストールにオーナーの承認が要る場合もあります。

Claude API の認証方法は 3 つあります。

  • ANTHROPIC_API_KEY。Claude Console で発行するキーで、anthropic_api_key 入力に渡します。
  • CLAUDE_CODE_OAUTH_TOKEN。ローカルで claude setup-token を実行して作り、claude_code_oauth_token に渡します。ドキュメントでは Pro、Max、Ultra、Team、Enterprise プラン向けとされています。Claude Code 2.1.330 のヘルプには「Set up a long-lived authentication token (requires Claude subscription).」とあります。
  • ワークロード ID フェデレーション。静的なシークレットを OIDC の交換に置き換えます(anthropic_federation_rule_id、anthropic_organization_id、ジョブに id-token: write)。

複数のリポジトリで共有するシークレットには、ドキュメントは API キーを勧めています。「OAuth トークンは claude setup-token を実行した人のサブスクリプションに紐づくため」です。私の見方では、OAuth トークンは個人リポジトリ向けの手軽な手段で、チームが頼るものはキーかフェデレーションで動かすべきです。Bedrock、Google Cloud、Microsoft Foundry にはそれぞれ専用の入力があります(use_bedrock、use_vertex、use_foundry)。

Claude の実行ごとに API トークンかサブスクリプションの利用枠を消費し、リポジトリとランナーの種類が課金対象であれば、ランナーは Actions の利用時間も消費します。

/install-github-app は Claude Code GitHub Actions をどう設定するか

Claude GitHub App をインストールし、認証情報をリポジトリのシークレットとして保存し、ワークフローファイルを含むブランチをプッシュします。ドキュメントの手順はこうです。gh auth login でサインインし、リポジトリで claude を起動して /install-github-app を実行し、ブラウザでアプリをインストールし、Set up GitHub Actions workflows を選び、サブスクリプションのトークンか API キーを選んで確定します。そのあと、プッシュされたブランチからプルリクエストを作ってマージします。ワークフローはマージした時点で有効になります。

クリックする前に、アプリが求める権限を読んでください。ドキュメントには、Actions、Checks、Contents、Discussions、Issues、Pull requests、Repository creation、Repository hooks、Workflows の読み書きと、Administration、Dependabot alerts、Members、Merge queues、Metadata、Statuses の読み取りが並んでいます。アクションが「頼っているのはアプリの権限のうち 3 つ」で、Contents、Issues、Pull requests です。残りは Code Review、Web での自動修正、予定中の機能のためのもので、「GitHub では一部だけを承認することはできません」。手動の方法でも同じアプリをインストールするので、このリストは短くなりません。変えられるのは、自分のアプリか自分のトークンだけです。

Claude Code アクションを手動で設定するには

アプリをインストールし、シークレットを追加し、アクションのリポジトリにある examples/claude.yml を .github/workflows/ にコピーします。ドキュメントがこの方法を勧めるのは、Claude Code をローカルで使っていない場合、コマンドが失敗した場合、すべてを自分で管理したい場合です。コミットされている例から、コメントアウトされたオプションを除いたものがこちらです。

yaml
name: Claude Code
 
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]
 
jobs:
  claude:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read # Required for Claude to read CI results on PRs
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6
        with:
          fetch-depth: 1
 
      - name: Run Claude Code
        id: claude
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

サブスクリプションのトークンを使う場合、最後の行はこうなります。

yaml
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

prompt がなければ、アクションはトリガーフレーズに応答します。ドキュメントはこれをタグモードと呼びます。prompt を設定すると代わりにそれを実行し、自動 PR レビューや cron のレポートはこの方法で作られています。2 つの変更は、半分だけやると何も起きないジョブが残ります。trigger_phrase を変えても、ジョブの if: にある @claude の文字列は変わらないので、両方を直してください。自動レビュー用に prompt を足すなら、新しい on:(たとえば pull_request)も必要で、メンションのチェックも外す必要があります。claude_args は CLI フラグをそのまま渡します。--max-turns、--model、--allowedTools、--mcp-config などです。まだ @beta を使っているワークフローは移行ガイドを読む必要があります。よくある変更は、@v1 への切り替え、mode の削除、direct_prompt から prompt への変更、max_turns と model の claude_args への移動です。

Claude Code アクションを起動できるのは誰か、それでも入り込むのは誰のテキストか

実行を始められるのは書き込み権限を持つ人だけですが、誰のテキストでも実行の中に入り得ます。セキュリティドキュメントによると、アクションは Issue、プルリクエスト、コメント、レビューのイベントでリポジトリへのアクセスを確認し、コメントの場合は「コメント投稿者の書き込み権限」を確認します。ボットは allowed_bots に載っていない限り拒否され、ドキュメントは、公開リポジトリで '*' を指定すると「誰が作った GitHub App でも」「自分が制御するプロンプトで」アクションを呼び出せると警告しています。スケジュール実行と手動実行はこのチェックを飛ばします。なお、手動実行にはもともと GitHub 側で書き込み権限が必要です。

このチェックが決めるのはボタンを押す人で、Claude が読むものではありません。メンテナーが知らない人の Issue の下に @claude fix this と書けば、その人のテキストを含むコンテキストで実行が始まります。ドキュメントいわく「それでも Claude はタスクを理解するために本文を読むので、先に確認してください」。アクションはその内容から HTML コメント、不可視文字、画像の代替テキスト、隠し属性を取り除き、「新しい回避手法が現れる可能性がある」と警告しています。ですから外部の Issue は、HTML コメントが隠れてしまうレンダリング後のページではなく、生の Markdown で読んでください。公開リポジトリでは、include_comments_by_actor でスレッド内のどのユーザーのコメントをコンテキストとして渡すかを絞れます。これが絞るのは議論で、実行を始めた依頼ではありません。

フォークのプルリクエストで Claude Code アクションが動くと何が起きるか

メンテナーが PR の会話欄に @claude と書くと、トークンを持つジョブの中で、コントリビューターのコードを対象に Claude が動きます。allow_fork_prs のデフォルトは "true" で、ドキュメントによればタグモードは「プルリクエストの head をチェックアウトするので、外部コントリビューターからのプルリクエストでは、メンテナーが実行を起動した場合でも、そのコードはコントリビューターのものです」。アクションはまず自分の設定を復元しますが(後述)、チェックアウトの残りはフォークのものです。

PR の作者が書き込み権限を持たない場合、アクションは 3 つの保護をかけます。

  1. restrict_untrusted_prs(デフォルト "true")は、claude_args で許可されていても「パッケージマネージャー、テストランナー、インタプリタ、シェル」を拒否します。Claude は読み取り、編集、コミット、プッシュは引き続きできます。
  2. Claude の設定は PR ではなくデフォルトブランチから取られます。対象は .claude/、.mcp.json、.claude.json、.gitmodules、.ripgreprc、CLAUDE.md、CLAUDE.local.md、AGENTS.md、.husky/ で、PR 側のバージョンは読み取り用に .claude-pr/ に置かれます。.npmrc、bunfig.toml、追跡されている node_modules/ のファイルも置き換えられ、PR の node_modules/ は残りません。
  3. ボットは、allowed_bots に載っていても、書き込み権限のない作者として扱われます。

そしてドキュメントは、どこで止まるかをはっきり書いています。

これはよく使われるコマンドのリストであって、サンドボックスではありません。

Bash(./scripts/test.sh) のようなルールは許可されたままで、scripts/ は復元対象のリストに入っていません。ですから私の読みでは、このルールはコントリビューター版のファイルを実行することになります。「信頼はプルリクエストの作者に従う」ので、メンテナーが知らない人のブランチから PR を開けば、そのコードはメンテナーのものとして扱われます。

いちばん見落としやすいのはプッシュです。開いているフォーク PR では、Claude はあなたのリポジトリの pr-N ブランチにプッシュします。このブランチには「フォークのコミットと Claude のコミットの両方が入り、フォークからの実行に対する GitHub の制限は適用されません」。このブランチをビルドする push トリガーの CI があれば、コントリビューターのコードがあなたのシークレット付きで実行されます。ドキュメントの対策は、シークレットを持つ CI から pr-* を外し(push トリガーで branches-ignore)、そこからは決してデプロイせず、作業が終わったら削除することです。

フォークで Claude が不要なら、allow_fork_prs: "false" を設定してください。するとアクションは、ブランチが別リポジトリにある PR を、どのイベントでも、何かをチェックアウトする前にスキップします。スキップは Claude の出力なしで成功したステップになるので、アクションを動かすだけの必須チェックは緑になります。フォークのコードを先にチェックアウトする自分のステップ、Issue、テキストには効きません。「外部コントリビューターからの Issue やコメントは引き続き Claude に届きます」。

GitHub Actions の permissions ブロックは Claude GitHub App のトークンを制限するか

ドキュメントの記述を見る限り、しません。絞られるのは GITHUB_TOKEN です。github_token 入力がない場合、「Claude Code GitHub Action は Claude GitHub App として認証」し、OIDC トークンをアプリのトークンと交換します。ブロックにある id-token: write はそのためのものです。セキュリティドキュメントは、アプリのトークンを短命で「動作しているリポジトリに限定されたもの」と説明しており、そのリポジトリの中で何ができるかはアプリに与えた権限で決まります。ジョブのブロックがこれを絞るとは、ドキュメントにも FAQ にも書かれていません。一方、ワークフロー自身のトークンは「ジョブで宣言した権限に限定され、ジョブの終了とともに失効します」。

つまり、例のブロックを削ると削られるのは GITHUB_TOKEN です。それでもブロックは明示的に書き、アプリを使っている間は id-token: write を残してください。消すと交換が失敗します。actions: read を外すと、ワークフローのトークンから CI の結果へのアクセスが制限されますが、あなたが許可した別の経路で Claude がログにたどり着くことは止められません。contents: read と issues: read の cron レポートは、ワークフローのトークンにとっては読み取り専用でも、その隣にあるアプリのトークンにとってはそうではありません。

Claude が GitHub を通じてできることを絞るには、トークンを替えます。

  • 自分の GitHub App。 docs/setup.md は最低限として Contents、Issues、Pull requests の読み書きを挙げ、「アプリのトークンは、設定したとおりの権限を持ち、それ以上は持ちません」と書いています。actions/create-github-app-token で発行し、github_token として渡します。
  • ワークフロー自身のトークン、つまり組み込みの GITHUB_TOKEN を github_token として渡す方法。この場合はジョブのブロックが上限になります。コメントは別のユーザー名で表示され、FAQ によると use_sticky_comment が正しく更新されなくなり、GitHub はこのトークンで行われたプッシュから通常のワークフローを起動しません。

Claude Code アクションの auto モードはセキュリティ境界か

違います。セキュリティドキュメントはその節に「Auto mode is a review, not a boundary」、つまり境界ではなくレビューだという見出しを付けています。アクションは現在、デフォルトで Claude を auto モードで動かします。読み取りとワークスペース内の編集は確認なしで実行され、「許可ルールでカバーされていないそれ以外のツール呼び出しは、安全性レビューが判断します」。Bash(npm test) のような狭いルールはレビューを飛ばし、Bash(*) のような広いルールは無視されます。「多くの危険な操作を捕まえますが、レビューが通せば呼び出しは実行されます」。

ワークフローが --allowedTools を Claude が実行できるものの上限と見なしているなら、これは重要です。auto モードでは、レビューがそれ以上を承認できます。ドキュメントは、オプトアウトとして以前のデフォルトを挙げています。

yaml
# @claude mentions: workspace edits allowed, anything no rule covers denied
claude_args: --permission-mode acceptEdits
 
# workflows with a prompt: anything no rule covers denied
# claude_args: --permission-mode default

これでレビューが追加の呼び出しを承認する余地はなくなります。ただし、あなたのリストが唯一のツールになるわけではありません。acceptEdits は引き続き編集を許可し、タグモードは独自の git ツールを追加します。allowed_non_write_users や allowed_bots を設定した場合も、自分でモードを指定しない限り、デフォルトは以前のモードに戻ります。「他人のテキストが書き込み権限のチェックなしにこれらの実行に届くため」です。ランナー上のセッションが分類器のどの経路を通るかは確認していません。ローカルの Claude Code については、auto モードの分類器とそのモデルを確認するで扱っています。

pull_request_target は Claude Code GitHub Actions の設定をどこで壊すか

特権を持つトリガーが、信頼できないコードのチェックアウトと出会う場所です。GitHub Security Lab の pwn request の記事は、それを 1 行でまとめています。「pull_request_target ワークフロートリガーと、信頼できない PR の明示的なチェックアウトを組み合わせるのは危険な行為で、リポジトリの侵害につながる可能性があります」。このトリガーのワークフローは「対象リポジトリへの書き込み権限」と「対象リポジトリのシークレットへのアクセス」を持ちます。フォークからの通常の pull_request はどちらも持ちません。Anthropic のページも同じことを自分の側から書いています。公開リポジトリでは「GitHub はフォークのプルリクエストで起動された実行にシークレットを渡しません」。そのため、同社のレビュー例は同じリポジトリ内のブランチだけを対象にしています。

アクションのドキュメントは、このルールを太字にしています。「Do not check out an untrusted ref into the workspace root before this action.」、つまりこのアクションの前に、信頼できない ref をワークスペースのルートにチェックアウトしないこと、です。推奨パターンは ref: なしの素の actions/checkout で、pull_request_target ではベースが取得されます。PR の head をサブディレクトリにチェックアウトし、--add-dir で渡す方法も示されています。これで Claude は読むためのファイルを得ます。ジョブ内の何かがそれを実行すれば、何も隔離されません。実行が必要なフォークのコードは、シークレットのない pull_request ジョブに置き、特権が要る後続処理は workflow_run に回すべきです。Security Lab が勧めるのもこの分け方です。

allowed_non_write_users が Claude Code アクションでいちばん危険な入力である理由

ここまでのすべてが頼っているチェックを無効にするからです。ドキュメントはこれに「RISKY」と付け、「このアクションの主要なセキュリティ機構を迂回する」もので、Issue のラベル付けのようにごく限られた権限のワークフローでだけ使うべきだとしています。動くのは自分の github_token を渡した場合だけで、ドキュメントは GITHUB_TOKEN を渡し、個人アクセストークンは決して渡さないよう求めています。静的なトークンは「プロンプトインジェクションによって、時間をかけて一部または全部が復元される可能性がある」からです。ジョブのブロックと許可するツールは、その 1 つのタスクに絞ってください。

これが Clinejection の背後にあった設定で、私が集めたコーディングエージェントに対する実際のプロンプトインジェクション事例の 1 つです。Issue のトリアージ用ワークフローが、issues イベントで allowed_non_write_users: "*" を指定し、ツールに Bash を含めてアクションを動かしていて、Issue のタイトルが Claude にパッケージのインストールを指示しました。

Claude Code アクションはコミット SHA に固定すべきか

はい。GitHub の secure use リファレンスは、サードパーティのアクションを完全なコミット SHA に固定するよう求めており、いまではワークフロー依存関係のロックファイルをそれより上に位置づけています。「これは利用できる最も強力な保護で、採用したリポジトリでは SHA の固定に取って代わります」。リポジトリでこのロックファイルを使っているなら、このワークフローも対象に含めてください。使っていないなら固定します。2026 年 11 月 22 日の時点で、@v1 は v1.0.286 と同じコミットを指していました。

yaml
- uses: anthropics/claude-code-action@acfe7992852970efb4fee683d63d628e3e52df67 # v1.0.286

v1 はパッチ 286 まで進んでおり、デフォルトの auto モードはメジャーバージョンを上げずにその中で入りました。アクションを固定し、actions/checkout も固定し、固定先を動かすたびに変更履歴を読んでください。

Claude Code GitHub Actions: 短いチェックリスト

例のワークフローを貼り付ける前に、次を確認します。

  • 共有するものには API キーかフェデレーションを使い、OAuth トークンは個人リポジトリにとどめる。
  • permissions: ブロックは自分で書き、それが絞るのは GITHUB_TOKEN だと覚えておく。Claude の GitHub アクセスを絞るには、自分のアプリのトークンか GITHUB_TOKEN を github_token として渡す。
  • フォークについて決める。外部の PR で Claude を使いたいのでなければ allow_fork_prs: "false"。残すなら restrict_untrusted_prs は有効のままにし、シークレットを持つ CI から pr-* を外す。
  • 権限モードは意図して選ぶ。--allowedTools を上限にしたいなら、--permission-mode acceptEdits か default を追加する。
  • pull_request_target のもとで PR の head をワークスペースのルートにチェックアウトしない。allowed_non_write_users は、権限が最小限で GITHUB_TOKEN を使うジョブにだけ与える。
  • アクションを固定する。
  • 外部の Issue の下に @claude と書く前に、その生の Markdown を読む。

書き込み権限のチェックが教えてくれるのは、誰が頼んだかです。Claude が読んだものを誰が書いたのか、Claude がプッシュするブランチに誰のコードがあるのかは、何も教えてくれません。事後にもう 1 層の自動チェックがほしいなら、Claude Code Review とその周りのレイヤーで、マネージドのレビュアーが何を加えるか、どのプランでも作り直せるのは何かを扱っています。

01 / ディスカッション

コメント欄はありません。議論は X で行っています。

Max Nardit@mnardit

02 / ほかの記事

  1. Codex のサンドボックス権限プロファイルと Claude Code のサンドボックス: それぞれが遮断するもの

    Ubuntu で、許可ホストを 1 つだけにした Codex のプロファイルは、リストにないサイトを 403 で拒否しました。無関係な機能スイッチに見える 2 行を削除すると、同じサイトが警告なしに 200 を返します。Claude Code のネットワークフィルターがそのような形で効かなくなることはありません。その代わり、フィルターはオンにするまでオフのままで、しかも 1 つの権限モードがそれを素通りします。

  2. Windows 11 のコーディングエージェント テレメトリ: オプションの診断データのスイッチが MissionControlAggregator で止めるもの、そして Microsoft が必須に挙げる開発者フラグ

    エージェントごとのビットマップはオプション扱いなので、いつものスイッチで PC の外に出なくなるはずです。ところが同じ DLL から出る、より粗い IsDeveloper コホートは Microsoft の必須イベント一覧に載っており、Home と Pro ではオプトアウトできません。スイッチをオフにした状態での検証結果は、まだ誰も公開していません。

  3. Claude Code の「Don't ask again」と settings.local.json: allow ルールに残ったパスワードの見つけ方と、変えるべきこと

    現在の Claude Code では、確認ダイアログがルールを保存する前にコマンドの大半をワイルドカードに置き換えます。それでも、プログラム名の前に書いたパスワードは残ります。セッションのトランスクリプトにはコマンド全体が記録されるので、いちばん確実な対策は、そもそも秘密情報を含まないコマンドラインにすることです。