Claude Code GitHub Action は月額 API クレジットの対象外で、リンクした組織の API キーで Agent SDK を自分で呼ぶ形は対象であることを示すアイキャッチ

【Claude】GitHub 自動化に月額 API クレジットを使う

今回は Claude の月額 API クレジットの話です。Claude Code GitHub Action は対象外ですが、Agent SDK を直接呼ぶ形なら公式ヘルプ上は対象と読めます。条件と代替構成を解説します。

Claude Code GitHub Action は月額 API クレジットの対象外で、リンクした組織の API キーで Agent SDK を自分で呼ぶ形は対象であることを示すアイキャッチ

こんにちは。ダタク @iQeeeda です。

Claude の一部の有料プランには 2026 年 10 月から月額 API クレジットが付いています。
「これ、GitHub の自動化に回せないかな?」と考えている人もいると思います。

GitHub Actions のワークフローで Claude Code を動かすなら、公式の Claude Code GitHub Action があります (以下、公式 Action)。
ところが、公式 Action の実行にはこのクレジットを使えません。
代わりに候補になるのが、Claude のエージェント機能をコードから直接呼び出せる Agent SDK です。

結論: GitHub 自動化で月額 API クレジットの対象と読めるのは Agent SDK 経由

先に結論です。

  • 月額 API クレジットは自作のアプリやエージェント向け
  • Claude Code GitHub Action からの実行は認証方法にかかわらず対象外
  • プラン連携した組織の API キーで Agent SDK を直接動かす形は対象
  • GitHub Actions のジョブから Agent SDK を呼ぶのが代替構成の候補

※ 2026 年 11 月時点の公式ヘルプに基づく整理です。GitHub Actions 上での消費は未確認のため、最初は小さく試して API 管理画面で残高の減り方を確認してください。

今回は、GitHub の自動化で月額 API クレジットの対象になる条件と代替構成を整理します。
それでは解説していきます。

Claude の月額 API クレジットとは

Max、Ultra、Team のプランから API 管理画面 (Console) の組織へクレジットが付き、その組織の API キーで使う流れを示す図

月額 API クレジットは対象プランに毎月付く Claude API 用のクレジット です。
金額はプランごとに違います。

  • Max: 月 100 ドル
  • Ultra: 月 200 ドル
  • Team: シートの種類ごとの額を合算 (上限は月 500 ドル)

受け取るには、claude.ai の Billing 設定でプランに Console の組織をリンクします。
Console は API の管理画面です。リンクできる組織は 1 つだけです。

月額 API クレジットの対象

クレジットで払える主なものは次のとおりです。

  • Claude API
  • Console の Playground
  • Claude Managed Agents
  • Agent SDK

一方で、次の利用は対象外です。

  • 対話で使う Claude Code
  • プランの上限を超えたあとの追加利用
  • Amazon Bedrock などのクラウド経由の利用

Claude Code GitHub Action は月額 API クレジットの対象外

月額 API クレジットの対象外の一覧には「対話で使う Claude Code」とあるだけで、公式 Action は載っていません。
ただ、公式 Action からの実行は 公式ヘルプの FAQ で Claude Code の利用に分類されています。
そのため Claude Code の非対話モード (-p) の有無に関係なく、クレジットは使えません。

ここが紛らわしいところで、公式 Action は内部で Agent SDK を使って作られています。
リンクした Console 組織の API キーを使い、Agent SDK 単体を自分で動かす場合は対象です。
それなのに、公式 Action 経由の実行は対象外になります。

FAQ ではクレジットの用途を「自分のアプリやエージェントを作るため」としています。
公式 Action からの実行はその用途に含まれない扱いです。

API キーを渡しても Claude Code GitHub Action は対象外

公式 Action の anthropic_api_key には Console の API キーを渡せます。
なので「リンクした組織のキーを渡せばいいのでは」と考えたくなります。

しかし FAQ では認証方法による区別を設けず、公式 Action からの実行を一律で対象外としています。
キーを差し替えても対象外という扱いは変わりません。

月額 API クレジットの対象は起動元と認証で決まる

起動元と認証の組み合わせごとに、月額 API クレジットの対象か対象外か、プランの利用枠を使うかを示す図

Claude を自動で動かすときは、何から起動したかとどの認証で動かしたかの 2 点を見ます。

  • 公式 Action から実行: クレジットの対象外 (OAuth トークンなら プランの利用枠を使う )
  • claude.ai アカウントでログインして claude -p か Agent SDK を実行: プランの利用枠を使う
  • リンクした組織の API キーで claude -p か Agent SDK を直接実行: クレジットの対象

このうちクレジットで払えるのは最後のパターンだけです。

FAQ 上は claude -p も対象とされていますが、この記事ではスクリプトとして組み込みやすい Agent SDK の構成に絞って紹介します。

GitHub Actions から Agent SDK を呼ぶワークフロー

プルリクエストの差分をファイルに書き出し、Agent SDK のスクリプトが読んで、結果をコメントに投稿する流れを示す図

使わないのは公式 Action という部品だけで、GitHub Actions のジョブ自体はそのまま使います。
公式ヘルプに CI の具体例までは出ていません。
ただ、自作のジョブからリンクした組織の API キーで Agent SDK を呼ぶ形は FAQ の「自分のアプリやエージェントを作る」用途に当たると僕は読んでいます。

事前の準備は 2 ステップです。

  1. プランにリンクした Console の組織で API キーを作る
  2. リポジトリの Secrets に ANTHROPIC_API_KEY として登録する

例として、プルリクエストの差分をレビューさせる最小構成を置いておきます。
まずワークフローです。

.github/workflows/review.yml

name: Agent SDK Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0
      - run: npm install @anthropic-ai/claude-agent-sdk tsx
      - run: git diff "origin/$BASE_REF...HEAD" > pr.diff
        env:
          BASE_REF: ${{ github.base_ref }}
      - run: npx tsx .github/scripts/review.mts > review.md
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
      - run: gh pr comment "$PR_NUMBER" --body-file review.md
        env:
          GH_TOKEN: ${{ github.token }}
          PR_NUMBER: ${{ github.event.pull_request.number }}

次に、ワークフローから呼ぶスクリプトです。

.github/scripts/review.mts

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "pr.diff を読んで、バグになりそうな箇所を日本語で指摘してください",
  options: {
    allowedTools: ["Read", "Grep", "Glob"],
    permissionMode: "dontAsk",
    maxTurns: 10,
  },
})) {
  if (message.type === "result" && message.subtype === "success") {
    console.log(message.result);
  }
}

スクリプト側で特に気をつけたい設定は次の 2 つです。

  • permissionMode: "dontAsk": 許可していないツールは確認せずに拒否する
  • maxTurns: エージェントが動くターン数の上限

Agent SDK のセッションには 自動のタイムアウトがありません 。
なので maxTurns は付けておくと安心です。

※ 上のサンプルは API キーでの実行、GitHub Actions 上での動作、クレジットの減り方までは未確認です。本番リポジトリに入れる前に検証用リポジトリで試すのが安全です。

fork からのプルリクエストでは既定で動かない

fork したリポジトリから出されたプルリクエストには Secrets が渡らない仕様 になっています。
この構成は同じリポジトリのブランチから出したプルリクエスト向けです。

Claude Code GitHub Action を使わない場合に足りなくなる機能

正直、Agent SDK を自前で呼ぶのは少し面倒だと感じています。
公式 Action なら標準で付いてくる次のような機能も、自分で用意する必要があります。

  • @claude のメンションで呼び出す仕組み
  • 作業の進み具合をコメントに出す仕組み

ただ、プルリクエストの自動レビューだけなら上の最小構成が出発点になると思います。

月額 API クレジットでワークフローを動かす前に知っておきたい仕様

使わなかったクレジットは請求サイクルの終わりに失効し、他のクレジットがなければ使い切った時点で API リクエストが止まることを示す図

動かす前に押さえておきたい仕様が 2 つあります。

  • 使わなかった月額分は請求サイクルの終わりに失効する
  • 使い切っても Claude プラン側への課金は発生せず、組織に別のクレジットがなければ次の付与まで API リクエストが止まる

クレジット切れでプランに追加請求が来ないのは安心です (別のクレジットが入っている組織では残高に注意)。
一方で繰り越せないので、余らせるくらいなら GitHub の自動化を使い道の候補にしてもよさそうです。
よかったら参考にしてみてください。

関連記事

まだコメントはありません