← 記事一覧
Ecosystem

6月15日からの Claude Agent SDK クレジット:claude -p、GitHub Actions、サードパーティ製エージェントツールは何が変わるのか

A cream-background editorial illustration of a developer workflow split into two lanes: interactive Claude Code on one s

2026年6月15日、Anthropic はヘッドレスな Claude の経済設計を変える。claude -p、Claude Agent SDK の呼び出し、Claude Code GitHub Actions、そして Agent SDK 上に構築されたサードパーティ製アプリは、通常の Claude サブスクリプション上限を消費しなくなり、代わりに別枠の月次 Agent SDK クレジットを消費するようになる(Anthropic Help Center)。

請求まわりの脚注に聞こえるかもしれない。だが違う。cron ジョブ、CI レビュー、ローカルスクリプト、Zed 風のエージェント連携、claude -p を包んだラッパー CLI があるなら、ここが「プランに含まれている」から「ドル建てクレジットでメーターされる」への境界線になる。

私の見方はこうだ。これは正しいプロダクト境界だが、Anthropic の展開の仕方では、多くの開発者が壊れた理解や Reddit スレッド経由で気づくことになる。対話的なコーディングと自動エージェントは別のワークロードだ。同じクォータを共有すべきではない。ただし、チームがサブスクリプション認証された Claude Code の周りにこっそり自動化を組んできたなら、6月15日は料金発表ではなく移行期限だ。

6月15日以前の利用では対話型 Claude Code、claude -p、Agent SDK、GitHu がどう流れていたかを示すビフォーアフターのフロー図

新しいクレジットに実際に移るもの

Anthropic のヘルプ記事は、この境界をはっきり書いている。6月15日以降、Claude サブスクリプションプラン上の Agent SDK と claude -p の利用は、対話型利用の上限とは別の新しい月次 Agent SDK クレジットから差し引かれる(Anthropic Help Center)。Agent SDK ドキュメントも、概要ページの冒頭で同じ警告を繰り返している(Claude Docs)。

新しいクレジットの対象になるもの:

ワークフローAgent SDK クレジットを消費する?メモ
claude -p "..."はいprint モード、非対話型
Python または TypeScript Claude Agent SDKはいサブスクリプションプランの Agent SDK クレジットで使う場合
Claude Code GitHub ActionsはいAnthropic はこの連携が Agent SDK 上に構築されているとしている
Agent SDK 上に構築され、あなたの Claude サブスクリプションで認証されるサードパーティ製アプリはいツール連携で一番燃えやすい場所
ターミナルまたは IDE の対話型 Claude Codeいいえ通常のサブスクリプション上限を引き続き使用
Claude web、desktop、mobile chatいいえ通常のサブスクリプション上限を引き続き使用
Claude Coworkいいえこのクレジットの対象外
Claude Platform API キーで使う Agent SDK変更なし従来どおり従量課金

プランごとのクレジットはドル建てだ:

プラン月次 Agent SDK クレジット
Pro$20
Max 5x$100
Max 20x$200
Team Standard seats$20
Team Premium seats$100
Enterprise usage-based$20
Enterprise seat-based Premium seats$200

Anthropic はさらに、クレジットはユーザー単位であり、プールされないこと、請求サイクルごとに更新されること、未使用分は繰り越されないこと、そしてクレジットは一度請求すれば以後は自動更新されることも説明している(Anthropic Help Center)。

この最後の点はチームにとって重要だ。対象となるエンジニアが20人いる Team アカウントでも、共有の自動化バケットが1つ手に入るわけではない。各人がそれぞれ自分のクレジットを持つ。共有の GitHub Action が1人のユーザーとして認証されているなら、その1人のクレジットがボトルネックになる。

実務上の断絶:claude -p はもう「ただの CLI 利用」ではない

人々を驚かせるコマンドは claude -p だ。

Anthropic の CLI リファレンスは、--print / -p を「対話モードなしでレスポンスを出力する」と説明し、--output-format json--output-format stream-json--max-turns--json-schema--max-budget-usd といった自動化向けのフラグも用意している(Claude Code CLI reference)。だからスクリプトの糊として完璧だった:

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

6月15日以降、これはサブスクリプション認証されたアカウント上では Agent SDK クレジットの利用になる。対話型 Claude Code の利用ではない。通常のチャット利用でもない。あなたのプランのクォータへ無料で抜ける裏口でもない。

コミュニティの反応が鋭いのはこのためだ。現在の r/ClaudeCode スレッドでは、開発者たちが、このクレジットはトークンやモデルベースなのか、$200 で現実的にどこまで行けるのか、オプトインが必要なのか、プロンプトキャッシュはどう計上されるのか、GitHub Actions も含まれるのかを尋ねている(Reddit)。あるコメントの「えっ…GH actions もそうだとは気づかなかった」は、まさにリスクそのものだ。人々はこの変更を SDK ライブラリの話だと捉え、すべてのヘッドレスな Claude Code ワークフローの話だとは捉えていなかった。

トークンの質問への答えは、実質的にはイエスだ。Anthropic は、クレジットを超えた利用は、usage credits が有効であれば標準 API レートの usage credits に流れるとしている。現在の Claude API pricing ページでは、Fable 5 が100万トークンあたり入力 $10 / 出力 $50、Opus 4.8 が $5 / $25、Sonnet 4.6 が $3 / $15、Haiku 4.5 が $1 / $5 とされている(Claude API pricing)。実際の燃え方は、モデル、ターン数、ツール利用、キャッシュ読み取り、キャッシュ書き込み、そしてエージェントが読み込むリポジトリコンテキストの量に左右される。

$20 や $200 を「時間」に換算してはいけない。それは単位が間違っている。実際のジョブをトークンとコストのトレースに変換すべきだ。

GitHub Actions:同じ YAML、違う予算

Claude Code GitHub Actions は明確に対象範囲に入る。Anthropic の GitHub Actions ドキュメントは、この action が Claude Agent SDK の上に構築されており、@claude メンションへの応答、PR 作成、機能実装、バグ修正、カスタム自動化を実行できると説明している(Claude Code GitHub Actions docs)。同ドキュメントはまた、各 Claude インタラクションが API トークンを消費することを警告し、コスト管理のために --max-turns、タイムアウト、同時実行制御を推奨している。

その助言はいま、さらに重要になった。

たとえば、こんな日次レポートのスケジュール実行:

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

これには2つの請求ストーリーがあり得る:

  1. Claude Platform API キーを使っているなら、Anthropic は何も変わらないとしている。通常の従量課金 API 請求のままだ。
  2. サブスクリプション認証された Agent SDK クレジットを使っているなら、まずユーザー単位の Agent SDK クレジットを消費し、その後、usage credits が有効ならそこへ流れる。

action のセットアップドキュメントは、直接 API 利用では引き続き ANTHROPIC_API_KEY を重視し、Bedrock と Vertex AI 向けのクラウドプロバイダー選択肢も示している(Claude Code GitHub Actions docs)。本番 CI では、リポジトリの自動化を1人の人間のサブスクリプションに紐づけるより、そのほうがきれいだ。Anthropic も管理者向けガイダンスで同じことを言っている。大規模な本番自動化では、予測可能な従量課金のために API キー付きの Claude Platform を使うべきだ(Anthropic Help Center)。

私の推奨はこうだ。コードをマージできる、PR にコメントできる、またはスケジュールで無人実行されるワークフローなら、明示的な予算付きの API キーに乗せる。サブスクリプションの Agent SDK クレジットは、個人の自動化、実験、ローカルツール用に残しておく。

GitHub issue コメント、pull request、スケジュール済みワークフローが Claude Code に流れ込む CI アーキテクチャのスケッチ

サードパーティ製エージェントツール:Zed 風ツールの問題

ややこしいのはサードパーティ製ツールだ。開発者はこう尋ねている。エディタ、ローカルハーネス、コーディングアシスタントが Agent SDK 経由で連携し、私の Claude サブスクリプションで認証できるなら、それは新しいクレジットを使うのか?

Anthropic のヘルプ記事は、このクレジットが「Agent SDK を通じてあなたの Claude サブスクリプションで認証するサードパーティ製アプリ」を対象にすると書いている(Anthropic Help Center)。Agent SDK の概要も、Anthropic は一般に、事前承認なしにサードパーティ開発者が claude.ai ログインやレート制限を提供することを認めておらず、代わりに API キー認証方式を使うよう開発者に伝えている(Claude Docs)。

そこから実務上のルールが見える:

  • ツールがあなたの Claude Platform API キーを使うなら、この変更で無料の月次クレジットが付くわけではない。引き続き API 請求だ。
  • ツールが承認済みのサブスクリプション認証 Agent SDK アプリなら、Agent SDK クレジットを消費する。
  • ツールが Claude Code ログイン、OAuth トークン、隠れた PTY、または Anthropic が承認していない形のサブスクリプション上限をトンネルしようとしているなら、壊れやすいものとして扱うべきだ。

コミュニティはすでに、その曖昧さの周りにいろいろ作り始めている。ある r/ClaudeCode の投稿は、対話型 Claude Code の内部に作業を留め、SDK クレジットを回避すると主張する hook ベースの「ドロップイン -p 代替」を説明している(Reddit)。別の r/ClaudeAI 投稿では、内部で対話型 Claude Code を起動して claude -p の出力を模倣するローカル CLI、clarp が紹介されている(Reddit)。作者はローカル互換性として位置づけているが、コメント欄ではすぐにアカウントリスクの話が出ている。

本当の論点はそこだ。これは正当なローカルワークフローの温存なのか、それともツールの形をしたクォータ回避なのか。私は、こうしたラッパーの上に会社のインフラを作らない。今日動いたとしても、Anthropic がまさに取り除こうとしている請求上の前提をコード化しているからだ。

今日、自分のワークフローを監査する方法

ジョブが失敗してから待つのではなく、その前にやる。

まず、claude -p と Agent SDK の import を探す:

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

次に CI を探す:

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

見つかったものを分類する:

分類推奨アクション
個人の単発利用ローカルの claude -p ヘルパー維持しつつ、--max-budget-usd とログを追加
個人の定期実行cron ジョブ、launchd、systemd timerAPI キーへ移すか、厳しく上限設定
チーム CIPR レビュー、issue triageClaude Platform API キー、リポジトリ secrets、同時実行制御を使う
サードパーティ製エディタ/ツールAgent SDK 連携認証方式と請求経路を確認
ラッパーまたは回避策hidden PTY、hook loop、OAuth relay本番では避ける。ポリシーリスクを確認

SDK ユーザーは、結果ストリームにコスト追跡を組み込む。Anthropic のコスト追跡ドキュメントは、total_cost_usdcostUSD はクライアント側の推定であり、正式な請求データではないが、開発時の把握には有用だとしている(Claude Docs)。同じページでは、SDK がステップごとのトークン使用量、モデルごとの使用量、キャッシュ読み取りトークン、キャッシュ作成トークン、累積合計を公開すると説明している。

それを使って消費プロファイルを作る:

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

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

クライアント側のコスト推定を、自分のユーザーへの請求に使ってはいけない。Anthropic は、正式な請求には Usage and Cost API または Claude Console を使うよう明示している(Claude Docs)。

ハードストップも追加する。claude -p では --max-turns--max-budget-usd を使う。GitHub Actions ではワークフローのタイムアウト、GitHub の concurrency controls、絞ったプロンプトを使う。SDK エージェントではツールを制限する。読み取り専用レビューアに、デフォルトで BashEditWrite を持たせるべきではない。

ローカルスクリプト、SDK import、CI ワークフロー、サードパーティ製ツール、share の5行からなるコンパクトな監査チェックリスト画像

オプトインと超過利用の疑問

運用上もっとも重要な未解決の疑問はオプトインだ。Anthropic は、このクレジットは一度だけのオプトインで、Claude アカウントから一度請求すれば、その後は自動的に更新されるとしている。Team と Enterprise の管理者については、対象ユーザーに2026年6月15日より前に詳細と手順を記したメールが届く予定だった(Anthropic Help Center)。

現在の r/Anthropic スレッドでは、当然の追問が出ている。オプトインしなかったら何が起きるのか。claude -p は通常のサブスクリプション上限で動き続けるのか、請求するまで停止するのか、それとも usage credits に流れるのか。記事はそのフォールバックを明確に書いていない(Reddit)。

だから、推測したフォールバックを前提に設計してはいけない。対象者ならクレジットを請求する。管理者なら、ユーザーに請求場所と、そのクレジットを使ってよい自動化を伝える。共有ワークフローを動かしているなら、API キーに移す。

超過利用については、Anthropic の説明はより明確だ。Agent SDK の利用はまず月次クレジットを消費する。その後、usage credits が有効な場合に限り、標準 API レートで usage credits に移る。usage credits が有効でなければ、Agent SDK リクエストはクレジットが更新されるまで停止する(Anthropic Help Center)。

支出管理の観点では良いことだ。ただし、自動化が fail closed する可能性もある。そこに備えるべきだ。CI は「Agent SDK クレジット枯渇」を、ふらついたモデルエラーではなく、請求または設定の失敗として表面化させるべきだ。ローカルスクリプトは明確なメッセージを出し、非ゼロで終了すべきだ。長時間走るエージェントは、高価な各ターンの前に作業をチェックポイントすべきだ。

開発者にとっての結論

この変更は claude -p の死ではない。ヘッドレスなエージェントループが、IDE に座っている人間と同じコスト構造を持つふりを終わらせるものだ。

個人開発者にとって、新しいクレジットは有用だ。Pro ユーザーには月 $20 分のスクリプト余地がある。Max 20x ユーザーには $200 がある。これはよく考えた自動化には十分だが、無制限の常時稼働エージェントには足りない。

チームにとっての答えは退屈で、そして正しい。本番自動化には API キーを使う。サブスクリプションの Agent SDK クレジットは個人用に留める。コストログを追加する。ターン数に上限をかける。最前線モデルが不要なタスクでは Haiku や Sonnet を選ぶ。新しい境界を迂回するラッパーツールは、インフラではなく実験として扱う。

6月15日の分離は、ひとつの本物の問題を解く。夜間スクリプトが、対話的なコーディングに必要なクォータをこっそり食いつぶすべきではない、という問題だ。一方で、新しい問題も生む。Claude が人間のループなしで走るとき、開発者は API ユーザーとして考える必要がある。

それは妥当なトレードオフだ。ただし、メーターが噛みつき始める前に監査する場合に限る。

アイコンだけで視覚的に「interactive」「headless local」「CI」「third-party too」と題された小さな意思決定ツリー図

Claude Fable 5 を自分で試したい読者は、OneHop 経由で使える。ドロップインのエンドポイントで、定価より約30%安く、新規アカウントには $10 分が無料、カードも不要だ。Claude Fable 5 on OneHop または start with $10 free を参照。

さらに読む:Getting started with Claude Fable 5.