---
title: "anthropics/claude-code-action@v1の設定リファレンス｜入力一覧・claude_args・betaからの移行"
url: "https://www.issoh.co.jp/tech/details/8654/"
published: 2025-09-04
updated: 2026-09-28
categories: ["Claude"]
publisher: "株式会社一創"
---

# anthropics/claude-code-action@v1の設定リファレンス｜入力一覧・claude\_args・betaからの移行

`anthropics/claude-code-action@v1`は、GitHubのイシューやプルリクエストの上でClaude Codeを動かす公式のGitHub Actionです。v1は2025年8月26日に公開され、`v1`タグは2026年9月25日にv1.0.235へ付け替えられています。この記事では、[v1.0.235のaction.yml](https://github.com/anthropics/claude-code-action/blob/v1.0.235/action.yml)に定義された入力39項目を用途別に整理し、`claude_args`で渡すCLIフラグ、`@beta`からの移行表、権限チェックの既定動作までを公式リポジトリの記述とソースコードに沿って説明します。

導入手順（GitHub Appのインストールとシークレット登録）と料金の内訳は[Claude Code GitHub Actionsの導入と料金｜@claude連携の設定・分単価とトークン課金](/tech/details/7094/)で扱っています。本記事はワークフローを書く段階で引くリファレンスです。

## まとめ：claude-code-action@v1の要点

- **モードは`prompt`の有無で決まる**：`prompt`なしは`@claude`に応答する対話モード、ありはメンションを待たずに走る自動化モード。v1で`mode`入力は廃止されました。
- **モデル・ターン数・許可ツールは`claude_args`に書く**：`model`・`max_turns`・`allowed_tools`などの旧入力は`action.yml`から消えており、残しても効きません。
- **Bashは既定で使えない**：テストやビルドを走らせるなら`--allowedTools`で`Bash(npm run test:*)`のようにコマンド単位で許可します。
- **起動者は2段で検査される**：書き込み権限のある人間だけが起動でき、botは`allowed_bots`に載せない限り拒否されます。
- **`github_token`にGITHUB\_TOKENを渡すと後続CIが止まる**：GITHUB\_TOKENで作られたコミットは次のワークフローを起動しません。独自GitHub Appのトークンを渡す構成なら起動します。

## claude-code-action@v1の実体と現行版

このアクションはcomposite actionで、最初のステップが`oven-sh/setup-bun`でBun 1.3.14を入れ、その上でアクション本体（TypeScript）とClaude Codeを実行します。`package.json`は`@anthropic-ai/claude-agent-sdk`の`^0.3.283`に依存しています。Bunをすでに持つ環境（NixOSや独自コンテナ）では`path_to_bun_executable`で自前のバイナリを渡すとインストールを飛ばせます。

`v1`は付け替え式のタグで、2026年9月23日から25日の3日間だけでv1.0.232〜v1.0.235の4回リリースされています。`@v1`と書けば修正が自動で入る一方、挙動も予告なく変わります。`@v1.0.235`のようなバージョンタグも技術的には付け替えられるため、改変まで防ぎたい本番リポジトリではコミットの完全なSHAで固定し、更新はDependabotのプルリクエストで受けるのが安全です。

同じリポジトリには下位部品の`claude-code-base-action`もあります。公式の`security.md`によると、base-actionは起動者の権限チェックもベースブランチからの設定復元も行いません。イシューやプルリクエストを起点に動かすなら、チェックを備えた`claude-code-action`を使ってください。

## promptの有無で決まる2つの実行モード

| 条件                                | モード      | 結果の出力先       |
| --------------------------------- | -------- | ------------ |
| `prompt`なし＋`@claude`あり            | 対話モード    | トリガー元の進捗コメント |
| `prompt`あり                        | 自動化モード   | ワークフローの実行ログ  |
| `prompt`あり＋`track_progress: true` | 対話モードを強制 | 進捗コメント       |
| `prompt`なし＋担当者・ラベル条件が成立           | 対話モード    | トリガー元の進捗コメント |
| 上記のどれも成立しない                       | 何もしない    | なし           |

対話モードは、イシューやプルリクエストのコメント、プルリクエストのレビュー、新しく開いたイシューの本文かタイトルに含まれるトリガー文字列（既定`@claude`）に反応します。`assignee_trigger`で指定したユーザーへの割り当てや、`label_trigger`のラベル付与（イシューの`labeled`イベント）でも起動します。v1.0.235の`trigger.ts`では、トリガー文字列の直前が行頭か空白、直後が空白・行末・`.,!?;:`のいずれかのときに一致と判定します。`@claude!`や`@claude,`は起動し、`@claude-bot`や`claude@mention`は起動しません。公式FAQは`@claude!`を起動しない例に挙げていますが、実装とは食い違っています。

自動化モードは既定ではコメントを残しません。v0のagentモードのように進捗コメントが欲しい場合は`track_progress: true`を付けます。ただし対応イベントは、`pull_request`の`opened`・`synchronize`・`ready_for_review`・`reopened`・`labeled`と、`issues`の`opened`・`edited`・`labeled`・`assigned`に限られます。それ以外のイベントで指定するとエラーになります。

## @claudeに応答する最小ワークフロー

公式リポジトリの`examples/claude.yml`をもとに、4種類のイベントで`@claude`を拾う構成です。

```
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
    timeout-minutes: 30
    concurrency:
      group: claude-${{ github.event.issue.number || github.event.pull_request.number }}
      cancel-in-progress: false
    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 }}
          additional_permissions: |
            actions: read
```

公式例との違いは`timeout-minutes`・`concurrency`・`additional_permissions`を足した点です。`jobs.<id>.if`はランナーを起動する前に評価されるので、メンションのないコメントで課金時間を消費しません。`id-token: write`は既定のGitHub App認証に必要で、外すとOIDC関連のエラーになります。プルリクエスト上のCI結果をClaudeに読ませるには、ジョブの`permissions`の`actions: read`と、アクションの`additional_permissions`の`actions: read`が両方必要です。そろうと`mcp__github_ci__download_job_log`などCI用のツールが使えるようになります。

`concurrency.group`に`github.event.issue.number`だけを使うと、`pull_request_review_comment`と`pull_request_review`ではこの値が空になり、別々のプルリクエストの実行が同じグループに入って待たされます。プルリクエスト番号へのフォールバックを必ず書いてください。`cancel-in-progress`を`true`にすると、Claudeがコミットを積んでいる途中のジョブが後続のメンションで打ち切られます。groupとキャンセルの設計は[GitHub Actionsのconcurrency｜groupの設計とcancel-in-progress・queueの選び方](/tech/details/16945/)で詳しく扱っています。

## 入力パラメータ一覧（v1.0.235の39項目）

`action.yml`の入力はすべて任意です。認証だけは、`anthropic_api_key`・`claude_code_oauth_token`・ワークロードID連携・クラウドプロバイダ指定のどれか1系統を必ず与えます。

### 認証とプロバイダの入力

| 入力                             | 既定値               | 用途                               |
| ------------------------------ | ----------------- | -------------------------------- |
| `anthropic_api_key`            | なし                | Claude APIキー                     |
| `claude_code_oauth_token`      | なし                | サブスクリプションのOAuthトークン              |
| `anthropic_federation_rule_id` | なし                | ワークロードID連携のルールID（fdrl\_）         |
| `anthropic_organization_id`    | なし                | ワークロードID連携の組織UUID                |
| `anthropic_service_account_id` | なし                | サービスアカウントID（svac\_・任意）           |
| `anthropic_workspace_id`       | なし                | ワークスペースID（wrkspc\_・任意）           |
| `anthropic_oidc_audience`      | api.anthropic.com | OIDCトークンのaudience                |
| `use_bedrock`                  | false             | Amazon Bedrock経由で実行              |
| `use_vertex`                   | false             | Google CloudのAgent Platform経由で実行 |
| `use_foundry`                  | false             | Microsoft Foundry経由で実行           |
| `github_token`                 | なし                | GitHub操作用トークン（省略時はApp認証）         |

`claude_code_oauth_token`はPro・Max・Team・Enterpriseプランで`claude setup-token`を実行して発行します。トークンは発行した個人のサブスクリプションに結び付くため、組織で共有するシークレットにはAPIキーかワークロードID連携を使うよう公式ドキュメントは勧めています。ワークロードID連携の入力と同時に`anthropic_api_key`などの静的な認証情報を渡すと、静的な方が優先されて連携は使われません。APIキーを置かない構成の手順は[Claude Code GitHub Actionsの導入と料金](/tech/details/7094/)にまとめています。

### 起動条件とアクセス制御の入力

| 入力                          | 既定値       | 用途                  |
| --------------------------- | --------- | ------------------- |
| `trigger_phrase`            | @claude   | 反応する文字列             |
| `assignee_trigger`          | なし        | イシューの担当者割り当てで起動     |
| `label_trigger`             | claude    | イシューへのラベル付与で起動      |
| `allowed_bots`              | 空（全bot拒否） | 起動を許すbot名           |
| `allowed_non_write_users`   | 空         | 書き込み権限なしで許すユーザー     |
| `include_comments_by_actor` | 空（全員）     | Claudeに渡すコメントの投稿者   |
| `exclude_comments_by_actor` | 空         | Claudeに渡さないコメントの投稿者 |

`include_comments_by_actor`と`exclude_comments_by_actor`は`*[bot]`のようなワイルドカードを受け付け、両方に該当した場合は除外が優先されます。公開リポジトリでは、信頼できる投稿者のコメントだけをClaudeに読ませる用途に使えます。

### ブランチとコミットの入力

| 入力                     | 既定値           | 用途                    |
| ---------------------- | ------------- | --------------------- |
| `base_branch`          | 既定ブランチ        | 新規ブランチの分岐元            |
| `branch_prefix`        | claude/       | 作成するブランチ名の接頭辞         |
| `branch_name_template` | 空             | ブランチ名のテンプレート          |
| `use_commit_signing`   | false         | GitHub API経由の署名付きコミット |
| `ssh_signing_key`      | 空             | SSH鍵での署名（こちらが優先）      |
| `bot_id`               | Claudeのbot ID | コミットに使うユーザーID         |
| `bot_name`             | claude\[bot\] | コミットに使うユーザー名          |

`branch_name_template`では`{{prefix}}`・`{{entityType}}`・`{{entityNumber}}`・`{{timestamp}}`・`{{sha}}`・`{{label}}`・`{{description}}`の7変数が使えます。独自のGitHub Appで動かす場合は`bot_id`と`bot_name`を両方そのAppの値に変えます。片方だけだとコミットの作成者表示が食い違います。

### コメントとログ出力の入力

| 入力                         | 既定値   | 用途                   |
| -------------------------- | ----- | -------------------- |
| `use_sticky_comment`       | false | コメントを1件にまとめる         |
| `track_progress`           | false | 自動化モードで進捗コメントを出す     |
| `classify_inline_comments` | true  | 未確定のインラインコメントを選別     |
| `include_fix_links`        | true  | レビュー指摘に「Fix this」リンク |
| `display_report`           | false | Step Summaryにレポートを表示 |
| `show_full_output`         | false | 全メッセージをログに出す         |

`classify_inline_comments`は、確定フラグの付いていないインラインコメントをセッション終了まで保留し、本物の指摘か試し書きかを判定してから投稿します。この判定は`anthropic_api_key`が前提で、ワークロードID連携では判定が省かれて全件そのまま投稿されます。`show_full_output`はツールの実行結果まで出力し、公開リポジトリならそのログを誰でも読めます。シークレット`ACTIONS_STEP_DEBUG`を`true`にしたデバッグモードでは自動で有効になる点にも注意が必要です。

### 実行環境と拡張の入力

| 入力                               | 既定値 | 用途                 |
| -------------------------------- | --- | ------------------ |
| `prompt`                         | 空   | 指示文またはスキル呼び出し      |
| `claude_args`                    | 空   | Claude CLIへ渡す引数    |
| `settings`                       | 空   | 設定JSON（文字列かファイルパス） |
| `additional_permissions`         | 空   | 追加で要求するGitHub権限    |
| `plugins`                        | 空   | インストールするプラグイン      |
| `plugin_marketplaces`            | 空   | マーケットプレイスのGit URL  |
| `path_to_claude_code_executable` | 空   | 自前のClaude Codeバイナリ |
| `path_to_bun_executable`         | 空   | 自前のBunバイナリ         |

`prompt`にはリポジトリの`.claude/skills/`にあるスキルを`/skill-name`の形で渡せます。プラグイン内のスキルなら`plugins`で`code-review@claude-code-plugins`のように「プラグイン名@マーケットプレイス名」を指定し、`/code-review:code-review`のように名前空間付きで呼びます。プラグインを自作して社内で配る手順は[Claude Codeプラグインの作り方と社内配布](/tech/details/17849/)を参照してください。

### 後続ステップで使える出力

| 出力                  | 中身                  |
| ------------------- | ------------------- |
| `conclusion`        | success または failure |
| `execution_file`    | 実行結果ファイルのパス         |
| `branch_name`       | Claudeが作ったブランチ名     |
| `github_token`      | アクションが使ったトークン       |
| `structured_output` | JSONスキーマに沿った結果      |
| `session_id`        | `--resume`で再開できるID  |

## claude\_argsで渡すモデル・ツール・プロンプト指定

`claude_args`はClaude CodeのCLI引数をそのまま受け取ります。複数行のブロックで書くと読みやすくなります。

```
- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --model claude-sonnet-5
      --max-turns 10
      --allowedTools "Bash(npm run test:*),Bash(npm run lint:*)"
      --append-system-prompt "テストが無い変更には必ずテストを追加すること"
```

### `--model`の指定と省略時の既定モデル

`--model`を省くと、Claude Codeの既定モデルが使われます。[Claude Codeのモデル設定ドキュメント](https://code.claude.com/docs/en/model-config)では、Anthropic API・Pro・Max・Team・Enterprise、およびBedrockとAgent Platformの既定がOpus 5.5、Microsoft FoundryだけがSonnet 4.5です。[Claude APIの料金表](https://platform.claude.com/docs/en/about-claude/pricing)によると、100万トークンあたりの単価はOpus 5.5が入力$4・出力$20、Sonnet 5が入力$2・出力$10で、入出力ともちょうど2倍の差があります。レビューや定型の要約のように判断の難度が低いジョブは`--model claude-sonnet-5`を明示すると、既定のままより安く済みます。

公式の`migration-guide.md`や`configuration.md`の例には`claude-4-0-sonnet-20250805`のような古い形式のモデルIDが残っています。そのまま写さず、`claude-sonnet-5`や`claude-opus-5-5`のような現行のIDに置き換えてください。

### `--allowedTools`で開けるBashとMCPツール

既定でClaudeが使えるのは、ファイルの読み書き・コミット・読み取り専用のgitコマンド、コメントの作成と更新、基本的なGitHub操作です。任意のBashは実行できません。`npm test`を走らせたいなら`Bash(npm run test:*)`のようにコマンドの接頭辞で許可します。`Bash`を丸ごと許可すると、プロンプトインジェクションで任意コマンドを実行される経路が開きます。

アクションはGitHub MCPサーバーとファイル操作用のサーバーを自動で起動しますが、そのツールも`--allowedTools`に名前を書くまで使えません。コードレビューの行コメントを投稿させるなら`mcp__github_inline_comment__create_inline_comment`を明示します。リポジトリ直下の`.mcp.json`に定義したサーバーも同じ扱いです。

### `--append-system-prompt`と`--system-prompt`の違い

`--append-system-prompt`はClaude Code組み込みのシステムプロンプトの後ろに指示を足し、`--system-prompt`は組み込みのプロンプトを丸ごと置き換えます。v0の`custom_instructions`に相当するのは前者です。置き換えるとブランチの扱いやコメント更新の手順まで消えるため、アクション上では`--append-system-prompt`を使い、恒常的なルールはリポジトリの`CLAUDE.md`に書くのが扱いやすい分担です。

### settings入力で渡す環境変数・権限・フック

CLI引数にない設定は`settings`にJSONで渡します。v0の`claude_env`は`env`オブジェクトに移りました。

```
- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    settings: |
      {
        "env": { "NODE_ENV": "test", "CI": "true" },
        "permissions": { "deny": ["WebFetch"] }
      }
```

`settings`には`hooks`も書けます。フックの書式とイベントの一覧は[Claude Code Hooksの設定方法｜全33イベント一覧とsettings.jsonの書き方](/tech/details/9864/)を参照してください。

## @betaからv1への移行：廃止された入力の置き換え表

`@beta`から`@v1`へタグだけ替えると、廃止された入力は`action.yml`に定義がないため効かなくなります。GitHubは未定義の入力に警告を出しますが、ジョブは失敗しません。モデル指定やターン数の上限が黙って外れた状態で動き続けるので、次の表に沿って書き換えてください。

| v0の入力                 | v1での書き方                  |
| --------------------- | ------------------------ |
| `mode`                | 削除（自動判定）                 |
| `direct_prompt`       | `prompt`                 |
| `override_prompt`     | `prompt`＋GitHubコンテキスト変数  |
| `custom_instructions` | `--append-system-prompt` |
| `max_turns`           | `--max-turns`            |
| `model`               | `--model`                |
| `allowed_tools`       | `--allowedTools`         |
| `disallowed_tools`    | `--disallowedTools`      |
| `claude_env`          | `settings`の`env`         |
| `mcp_config`          | `--mcp-config`           |
| `timeout_minutes`     | ジョブの`timeout-minutes`    |

自動化モードでプルリクエストを扱うとき、v0の`override_prompt`で使えた`$PR_NUMBER`のような置換変数はありません。移行ガイドは`prompt`の先頭に`REPO: ${{ github.repository }}`と`PR NUMBER: ${{ github.event.pull_request.number }}`を書く形を推奨しています。これが無いと、Claudeはどのプルリクエストを見ればよいか分かりません。

## structured\_outputによる後続ステップの条件分岐

`claude_args`に`--json-schema`でスキーマを渡すと、結果が検証済みのJSONとして`structured_output`に入ります。composite actionは動的な出力を定義できない制約があるため、全フィールドが1つのJSON文字列にまとまり、`fromJSON()`で取り出します。次の例は、CIワークフローが失敗したときにClaudeが失敗ログを読んで不安定なテスト（flaky test）かどうかを判定し、確度が高ければ失敗したジョブだけを再実行します。公式の`examples/test-failure-analysis.yml`をもとに、ログ取得を前段のステップへ移し、再実行を`gh run rerun`に替えています。

```
name: Flaky test check
on:
  workflow_run:
    workflows: ["CI"]
    types: [completed]

jobs:
  detect-flaky:
    if: github.event.workflow_run.conclusion == 'failure' && github.event.workflow_run.run_attempt == 1
    runs-on: ubuntu-latest
    permissions:
      contents: read
      actions: write
      id-token: write
    env:
      GH_TOKEN: ${{ github.token }}
      GH_REPO: ${{ github.repository }}
      RUN_ID: ${{ github.event.workflow_run.id }}
    steps:
      - uses: actions/checkout@v6
      - name: Save failed logs
        run: gh run view "$RUN_ID" --log-failed | tail -n 400 > failed.log
      - name: Detect flaky tests
        id: analyze
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            REPO: ${{ github.repository }}
            RUN ID: ${{ github.event.workflow_run.id }}
            Read failed.log and determine if this failure is a flaky test.
            Return: is_flaky (boolean), confidence (0-1), summary (string)
          claude_args: |
            --json-schema '{"type":"object","properties":{"is_flaky":{"type":"boolean"},"confidence":{"type":"number","minimum":0,"maximum":1},"summary":{"type":"string"}},"required":["is_flaky","confidence","summary"]}'
      - name: Rerun failed jobs
        if: |
          steps.analyze.outputs.structured_output != '' &&
          fromJSON(steps.analyze.outputs.structured_output).is_flaky &&
          fromJSON(steps.analyze.outputs.structured_output).confidence >= 0.8
        run: gh run rerun "$RUN_ID" --failed
```

ログは前段のステップでファイルに落としているので、Claudeには既定のファイル読み取りだけを使わせ、Bashを許可せずに済みます。`run_attempt == 1`の条件は、再実行した回がまた失敗したときに判定と再実行が繰り返されるのを止めるためのものです。しきい値の0.8は設定例で、誤判定を防ぐ保証になる値ではありません。`workflow_run`では上流の実行を始めた人の書き込み権限も検査されるため、書き込み権限のない外部貢献者のフォークPRが起点の失敗では、アクションはClaudeを起動せずに止まります。

## 起動者チェックと緩める入力のリスク

アクションはClaudeを起動する前に、トリガーした相手を2段で検査します。イシュー・プルリクエスト・コメント・レビューのイベントでは起動者に書き込み権限が必要で、`workflow_run`では上流の実行を始めた人の権限も確かめます。加えて、すべてのイベントでbotを拒否します。`schedule`の実行はcronを最後に変更したユーザーに帰属するため、その人がbotなら`allowed_bots`に載せないと定期実行が落ちます。

### allowed\_botsとallowed\_non\_write\_usersを使う判断

`allowed_bots`に載せたbotは、リポジトリへのインストールも書き込み権限も確認されません。公開リポジトリで`'*'`を指定すると、誰かが作ったGitHub Appがイシューを開くだけで、そのAppが用意したプロンプトでClaudeが動きます。Dependabotのように名前が決まっている相手だけを列挙し、`'*'`は使わないでください。

`allowed_non_write_users`は書き込み権限の検査そのものを外す入力で、`github_token`を渡した場合だけ機能します。使ってよいのは、ラベル付けのように`issues: write`しか持たないジョブに限られます。その場合も渡すトークンは`${{ secrets.GITHUB_TOKEN }}`にし、個人アクセストークンは使いません。ジョブ終了で失効しない静的なトークンは、プロンプトインジェクションで少しずつ抜き出されるおそれがあると公式が注意しています。ワークフローの権限を絞る考え方は[GitHub Actionsのpermissions｜GITHUB\_TOKENの既定権限と最小権限の設計](/tech/details/16937/)で扱っています。

### pull\_request\_targetとworkflow\_runでのチェックアウト

`pull_request_target`と`workflow_run`はベースリポジトリのシークレットで動きます。フォークのプルリクエストの先頭コミットをワークスペース直下にチェックアウトしてからアクションを呼ぶと、Claudeは外部の人が書いたファイル群の上で、自社のAPIキーを持って動くことになります。ベースブランチを直下に置き、プルリクエスト側は`path: pr-head`のように別ディレクトリへ取り出して`claude_args: "--add-dir pr-head"`で渡すのが公式の推奨です。

プルリクエストに対して動くとき、アクションは`.claude/`・`.mcp.json`・`.claude.json`・`.gitmodules`・`.ripgreprc`・`CLAUDE.md`・`CLAUDE.local.md`・`.husky/`の8つをベースブランチの内容に戻します。`package.json`やロックファイル、`Makefile`はプルリクエスト側のままです。ベースの`settings.json`に書いたフックが`npm run`や`make`を呼んでいると、その中身はプルリクエストの作者が決められます。フックからは`bunx prettier@3.5.3 --no-config --write .`のように版と設定を固定して直接ツールを呼んでください。シークレットの置き場所と漏えい経路の整理は[GitHub ActionsのSecrets管理](/tech/details/16939/)にあります。

## Claudeがやらない操作と詰まりやすい挙動

Claudeはコミットを積んでプッシュするだけで、マージ・リベース・強制プッシュはしません。この制限はシステムプロンプトで課されているため、`Bash(git rebase:*)`を許可しても断ります。プルリクエストも既定では作らず、ブランチにプッシュしたうえで作成画面へのリンクを返します。ワークフローファイル（`.github/workflows/`）の書き換えもできません。

| 症状                                         | 原因と対処                                       |
| ------------------------------------------ | ------------------------------------------- |
| Claudeのコミットで後続CIが動かない                      | GITHUB\_TOKENを渡していないか確認                     |
| 別ワークフローからの@claudeが無視される                    | GITHUB\_TOKENの投稿は後続を起動しない。PATか独自Appで投稿      |
| 403 Resource not accessible by integration | 独自Appなら`bot_id`と`bot_name`を指定               |
| OIDCの認証エラー                                 | permissionsに`id-token: write`を追加            |
| コミット履歴が浅い                                  | checkoutで`fetch-depth: 0`を指定                |
| CI結果を読めない                                  | `actions: read`と`additional_permissions`の両方 |

コミット履歴について補足すると、アクションはプルリクエストでは直近20コミット、新しいブランチでは1コミットだけを取得します。クローズ済みやマージ済みのプルリクエストでメンションすると、既存のブランチには積めないので新しいブランチが作られます。

`github_token`に`${{ secrets.GITHUB_TOKEN }}`を渡す構成は避けるべきです。GitHubはGITHUB\_TOKENで作られたコミットを契機にワークフローを起動しないため、Claudeが直したブランチでテストが一度も走らないままマージ判断を迫られます。コメントの投稿者も`claude[bot]`ではなくなり、`use_sticky_comment`も正しく更新されません。`github_token`を使うのは、`actions/create-github-app-token`で発行した独自GitHub Appのトークンを渡す場合（この場合は後続CIも起動します）と、`allowed_non_write_users`のためにGITHUB\_TOKENを渡す場合の2つに限り、それ以外は空のままにしてください。

## よくある質問

### anthropics/claude-code-action@v1とは何ですか？

Anthropicが公開しているGitHub Actionで、イシューやプルリクエストのコメント、または`prompt`で渡した指示を受けてClaude Codeをランナー上で動かします。v1は2025年8月26日に公開された正式版で、それ以前の`@beta`とは入力の構成が異なります。

### claude-code-actionで使うモデルはどう指定しますか？

`claude_args`に`--model claude-sonnet-5`のように書きます。v0の`model`入力は廃止されています。省略するとClaude Codeの既定モデルになり、Anthropic APIではOpus 5.5、Microsoft FoundryではSonnet 4.5です。

### ANTHROPIC\_API\_KEYなしで動かせますか？

動かせます。`claude_code_oauth_token`でPro・Max・Team・Enterpriseのサブスクリプションを使う方法、`anthropic_federation_rule_id`と`anthropic_organization_id`でOIDCのワークロードID連携を使う方法、`use_bedrock`・`use_vertex`・`use_foundry`でクラウド経由にする方法があります。

### 料金はどこでかかりますか？

GitHub Actionsのランナー時間と、Claude側のトークン利用の2か所です。サブスクリプションのOAuthトークンで認証した場合、トークン分はAPI課金ではなくサブスクリプションの利用枠から消費されます。金額の見積もりは[導入と料金の記事](/tech/details/7094/)と[GitHub Actionsの料金](/tech/details/16698/)で扱っています。

### @claudeにメンションしても反応しないのはなぜですか？

多いのは、コメントした人にリポジトリの書き込み権限がない、`@claude`が単語として独立していない、ジョブの`if`条件がそのイベントを拾っていない、の3つです。GitHub App未インストールやシークレット未設定でも同じ症状になります。

## 関連記事

- [Claude Code GitHub Actionsの導入と料金｜@claude連携の設定・分単価とトークン課金](/tech/details/7094/)
- [GitHub Actionsの料金｜2026年改定後の分単価・無料枠とコスト削減の判断基準](/tech/details/16698/)
- [GitHub Actionsのpermissions｜GITHUB\_TOKENの既定権限と最小権限の設計](/tech/details/16937/)
- [pr-review-toolkitとは｜Claude Codeプラグインの導入とreview-prの使い方](/tech/details/10760/)
- [Claude Codeとは？できること・使い方・料金とコード解析の実力【2026年版】](/tech/details/5571/)

---

出典: [anthropics/claude-code-action@v1の設定リファレンス｜入力一覧・claude\_args・betaからの移行](<https://www.issoh.co.jp/tech/details/8654/>)（株式会社一創）