GitHub Actions × Claude Code クラウド連携

1. @claude メンション — GitHub Actions 上での Claude 起動

GitHub Issue または PR のコメントで @claude とメンションすると、 GitHub Actions ワークフローが起動し、コメントの指示に応じて Claude が自動実行される。 できることの例:

• コード実装・バグ修正（コミット・PR 作成まで自動）
• PR のコードレビュー・改善提案
• 質問応答（コードベースを参照した説明）

公式 Action は anthropics/claude-code-action@v1。 旧 @beta からの破壊的変更点: direct_prompt → prompt にリネーム、 mode パラメータ廃止、max_turns / model 等は claude_args に統合された。

基本ワークフロー例（ANTHROPIC_API_KEY 方式）

name: Claude PR Assistant

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      pull-requests: write

    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # デフォルトモデルは Sonnet。Opus 4.8 を使う場合:
          claude_args: --model claude-opus-4-8 --max-turns 10

2. 認証3系統

Claude Code Action の認証方式は3系統ある。用途・コスト・セキュリティ要件で選択する。

3. クラウドプロバイダ連携 — 鍵レス OIDC 認証（核心）

静的な API キーを GitHub Secrets に保存せず、 GitHub OIDC トークン（一時的・短命）でクラウドロール/サービスアカウントに成りすます方式。 キー漏洩リスクをゼロにできる。

Amazon Bedrock — IAM OIDC + AssumeRole

🟢 公式ドキュメント確認済み

1. IAM で GitHub OIDC Provider を追加
   • URL: https://token.actions.githubusercontent.com
   • Audience: sts.amazonaws.com
2. IAM ロールを作成（AmazonBedrockFullAccess をアタッチ）し、GitHub リポジトリからの AssumeRole を信頼ポリシーに追加
3. ロール ARN を GitHub Secret AWS_ROLE_TO_ASSUME に保存
4. ワークフローに id-token: write 権限と aws-actions/configure-aws-credentials@v4 を追加

name: Claude on Bedrock

on:
  issue_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      id-token: write          # OIDC に必須
      contents: write
      issues: write
      pull-requests: write

    steps:
      - uses: actions/checkout@v4

      - name: Configure AWS credentials (OIDC)
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          aws-region: us-east-1

      - uses: anthropics/claude-code-action@v1
        with:
          use_bedrock: "true"
          claude_args: --model us.anthropic.claude-sonnet-4-6

Google Vertex AI — Workload Identity Federation

🟢 公式ドキュメント確認済み

1. GCP で Workload Identity Pool と Provider（GitHub OIDC）を作成
2. サービスアカウントに roles/aiplatform.user（Vertex AI User）を付与し、Workload Identity バインディングを追加
3. GitHub Secrets に GCP_WORKLOAD_IDENTITY_PROVIDER（Provider のリソース名）と GCP_SERVICE_ACCOUNT を登録

name: Claude on Vertex

on:
  issue_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: write
      issues: write
      pull-requests: write

    steps:
      - uses: actions/checkout@v4

      - name: Authenticate to GCP (OIDC)
        uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

      - uses: anthropics/claude-code-action@v1
        with:
          use_vertex: "true"
          claude_args: --model claude-sonnet-4-6

4. GitHub Actions 版 vs. Routines（比較）

Claude Code には GitHub Actions 版のほかに Routines（クラウド実行）がある。 どちらを選ぶかはインフラ管理の範囲と実行環境の要件で決まる。

5. コストと注意点

コスト構造

• API キー方式: GitHub Actions 実行分（分数）+ Anthropic API トークン従量課金の二重コスト
• OAuth トークン方式（Pro/Max サブスク）: GitHub Actions 分数のみ。API 従量課金なし
• Bedrock / Vertex: GitHub Actions 分数 + クラウドプロバイダの推論コスト

コスト最適化

• @claude 指示を具体的に書く（余計な往復を減らす）
• claude_args: --max-turns 10 で最大ターン数を制限
• ワークフローに timeout-minutes: 15 を設定して暴走を防ぐ
• concurrency 設定で同時実行数を制御

セキュリティ

関連項目

• [GHA-002] Claude 自動化の全体像 — GitHub Actions はイベント駆動型自動化の一形態。ヘッドレスモード・Routines・Agent SDK・hooks との比較全体像。
• [PY-001] Python の async/await — 非同期処理の基礎（GitHub Actions の並列ジョブと対比）
• Rust トピック — CI/CD 連携で利用する場合の参考
• claude-html-project — 本サイト構築プロジェクトの構成図解