Claude Code GitHub Actions — @claude で動く最小型

Claude Code GitHub Actions とは — @claude で PR が動く Anthropic 公式 Action

Claude Code を GitHub Actions ワークフローから呼び出すための Anthropic 公式 Action(anthropics/claude-code-action@v1)です。PR や Issue のコメントに @claude とメンションするだけで、Claude がコードを分析・実装・修正・PR を作成します。

CLAUDE.md に記載したコーディング規約を Claude が尊重して動くため、リポジトリ文脈に沿った自動化を最短で組めます。GitHub のホストランナー上で動くため、ソースコードがリポジトリ外に出ることはありません。

最短セットアップ — /install-github-app で 5 分

本セクションの要点を以下に整理します。

# Claude Code CLI で 1 コマンド実行(リポジトリ管理者権限必須)
/install-github-app

このコマンドが GitHub App インストール・ANTHROPIC_API_KEY 登録・サンプル Workflow ファイル配置までを対話形式でガイドします。完了後、Issue や PR コメントに @claude と書いて動作確認できれば導入完了です。

/install-github-app が失敗する場合・カスタマイズが必要な場合は手動で組みます。手順は次の 3 ステップ:

1. Claude GitHub App をインストール: https://github.com/apps/claude から対象リポジトリへ
2. ANTHROPIC_API_KEY をリポジトリシークレットに登録: Settings → Secrets and variables → Actions
3. Workflow ファイル配置: anthropics/claude-code-action の examples/claude.yml を .github/workflows/ にコピー

最小 Workflow — 10 行で @claude 自動応答が有効

出典が提示する最小構成は次の通り:

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

これで「コメント内 @claude メンションへの自動応答」が有効になります。v1 では mode: tag / mode: agent の指定が不要になり、Action が自動でモード判定 する仕様です。

詳細な挙動制御は claude_args パラメータに Claude Code CLI のオプションをそのまま渡せます。

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: "Review this PR for security issues"
    claude_args: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-6

4 つの定番ワークフロー — PR レビュー / 定期実行 / Issue 実装 / 設計相談

本セクションの要点を以下に整理します。

①②は Workflow YAML で prompt を明示する自動実行型(オートメーションモード)、③④は @claude メンションに応答する対話型(インタラクティブモード)で、v1 ではモード自動判定です。コメント例は次の 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

モデル指定 — デフォルト Sonnet、Opus 4.7 は明示指定

v1 のデフォルトモデルは Sonnet です。Opus 4.7 を使う場合は明示指定 が必要で、claude_args: --model claude-opus-4-7 を渡します。

コーディング系タスクの精度を重視するなら Opus 4.7、コスト最適化を重視するなら Sonnet が出発点になります。トークン消費はタスクの複雑さとリポジトリサイズ次第のため、--max-turns N で会話ターン上限を設定するのが定石です。

beta → v1 の破壊的変更チェックリスト

beta 版を使っている場合、v1 に上げるには Workflow ファイルを書き換える必要があります。

要点は CLI オプションは全て claude_args に集約 と prompt という単一インターフェースに統一 の 2 点です。

コスト管理 — GitHub Actions 分課金 + Claude API トークンの二重課金

本セクションの要点を以下に整理します。

• GitHub Actions 課金: ホストランナーの実行分(分単位)を消費
• Claude API 課金: トークン数(入力 + 出力)で従量課金
• 暴走防止: claude_args: --max-turns N 必須(デフォルト 10、複雑タスクは 10〜15、レビュー用途は 3〜5)
• Job レベル: timeout-minutes: を併設
• 並列制限: GitHub Actions の concurrency 制御

シンプルなレビューに --max-turns を設定しないとトークンが嵩むのが定番の落とし穴です。

@claude が反応しない時の確認 5 項目

ボットが反応しない原因の大半は次のいずれかです。上から順に確認してください。

1. GitHub App が対象リポジトリに正しくインストールされているか
2. リポジトリの Actions が有効になっているか
3. ANTHROPIC_API_KEY がシークレットに登録されているか
4. コメントに @claude(/claude ではない)が含まれているか
5. Claude のコミットで CI が走らない場合、GitHub App か独自 App を使っているか(Actions ユーザーでは CI トリガーが起きない仕様)

AWS Bedrock / Google Vertex AI への切替

エンタープライズ用途で データの居住地・課金経路を自社の Cloud アカウントに揃えたい 場合、use_bedrock: "true" または use_vertex: "true" を指定して切り替えられます。前者は OIDC で IAM Role を引き受け、後者は Workload Identity Federation でサービスアカウントを引き受ける構成が推奨されます。

前提として Bedrock / Vertex AI で Claude モデルへのアクセスを有効化しておく必要があります。詳細セットアップは公式ドキュメントを参照してください。

関連記事

• Claude Code スケジュール — 4 方式と落とし穴 — /schedule / Routines / Desktop Schedule / 外部 cron の使い分け
• Claude Code 入門 — 非エンジニアでも動く 9 機能 — Claude Code 全体像
• Claude Skills 自作入門 — SKILL.md で動く最小型 — Skills と組み合わせた自動化
• Claude Code Mac 入門 — brew + Apple Silicon + 通知設定 — ローカル環境構築

出典(一次情報)

本記事の作成に直接参照した一次情報源は以下の通りです。最新の正確な情報は各リンク先で必ずご確認ください。

• Claude Code GitHub Actions(公式ドキュメント)
• GitHub: anthropics/claude-code-action — 公式 Action リポジトリ
• examples/claude.yml(公式サンプル Workflow)
• Claude Code Action security documentation