こんにちは。ダタク @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 クレジットとは
月額 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 クレジットの対象は起動元と認証で決まる
Claude を自動で動かすときは、何から起動したかとどの認証で動かしたかの 2 点を見ます。
- 公式 Action から実行: クレジットの対象外 (OAuth トークンなら プランの利用枠を使う )
- claude.ai アカウントでログインして
claude -pか Agent SDK を実行: プランの利用枠を使う - リンクした組織の API キーで
claude -pか Agent SDK を直接実行: クレジットの対象
このうちクレジットで払えるのは最後のパターンだけです。
FAQ 上は claude -p も対象とされていますが、この記事ではスクリプトとして組み込みやすい Agent SDK の構成に絞って紹介します。
GitHub Actions から Agent SDK を呼ぶワークフロー
使わないのは公式 Action という部品だけで、GitHub Actions のジョブ自体はそのまま使います。
公式ヘルプに CI の具体例までは出ていません。
ただ、自作のジョブからリンクした組織の API キーで Agent SDK を呼ぶ形は FAQ の「自分のアプリやエージェントを作る」用途に当たると僕は読んでいます。
事前の準備は 2 ステップです。
- プランにリンクした Console の組織で API キーを作る
- リポジトリの 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 クレジットでワークフローを動かす前に知っておきたい仕様
動かす前に押さえておきたい仕様が 2 つあります。
- 使わなかった月額分は請求サイクルの終わりに失効する
- 使い切っても Claude プラン側への課金は発生せず、組織に別のクレジットがなければ次の付与まで API リクエストが止まる
クレジット切れでプランに追加請求が来ないのは安心です (別のクレジットが入っている組織では残高に注意)。
一方で繰り越せないので、余らせるくらいなら GitHub の自動化を使い道の候補にしてもよさそうです。
よかったら参考にしてみてください。
まだコメントはありません