Claude Agent SDKはプランの利用上限を消費するか

Claude Agent SDKの利用はプランの利用上限を消費する

Claude Agent SDKを自分のClaudeサブスクリプション(Pro・Max・Team・Enterprise)で認証して使う場合、その消費は対話的なClaude CodeやClaude、Coworkと同じプラン利用上限から差し引かれます。Agent SDK専用の別枠は存在しません。claude -p(Claude Codeの非対話モード)やAgent SDKで認証するサードパーティ製アプリも同じ扱いです。

一方、Claude Platform(旧Claude Console)のAPIキーでAgent SDKを使う場合は最初から従量課金(pay-as-you-go)で、この話はそもそも関係ありません。サブスクリプションで認証しているかAPIキーで認証しているかが、消費の扱いを分ける唯一の分岐点です。

専用クレジット化は撤回された

この現状には経緯があります。Anthropicは2026年6月15日から、Agent SDKとclaude -pの消費をサブスクリプションの利用上限から切り離し、代わりに月次の専用クレジットを付与する変更を予告していました。ところが同じ2026年6月15日付で、この変更自体を一旦停止すると発表しています。公式サポート記事は「現時点では何も変わっていません。Claude Agent SDK、claude -p、サードパーティアプリの利用は引き続きサブスクリプションの利用上限から消費されます」と明記し、予告されていた月次クレジットは「対象になり得たユーザーにも提供されない」としています。予定されていたページ本体の内容は参考情報として残されていますが、2026年6月15日時点で発効しない、という位置づけです。

Anthropicは「サブスクリプションでの開発をより良く支える形にアップデートを検討している」とし、次の発表があれば発効前に周知するとしています。SDK自体の使い方やセットアップはClaude Agent SDK入門にまとめています。撤回後に新しい発表が出ていないかは、公式サポートページで確認してください。

撤回されたクレジット案の中身

発効しなかった案がどういう設計だったかを知っておくと、今後同種の変更が出たときに理解が早くなります。予告されていたのは、プランごとに異なる月次クレジットをAgent SDK専用に付与する仕組みでした。

座席制Enterpriseの標準シートはこのクレジットの対象外とされていました。設計上の特徴は、クレジットがユーザー単位でチーム内でプールや共有ができないこと、請求サイクルごとにリセットされ未使用分は繰り越されないこと、クレジットを使い切った後は使用量クレジットが有効なら標準APIレートでの課金に切り替わり、無効なら次のサイクルまでAgent SDKのリクエストが止まる設計だったことです。この案は対話的なClaude Code・Cowork・チャットの利用には影響しない設計でした。

Agent SDKが返すコスト推定値は目安であって請求額そのものではない

Agent SDKは各query()呼び出しの結果メッセージにtotal_cost_usd(Pythonではtotal_cost_usd、TypeScriptではcostUSD)というコスト推定値を返します。ただし公式ドキュメントはこの値を「クライアント側の見積もりであり、正式な請求データではない」と明確に位置づけています。SDKはビルド時に組み込まれた価格表(またはmodelPricing設定)からローカルで計算しているだけなので、価格改定・SDKが未対応の新モデル・クライアント側では再現できない請求ルールがあると実際の請求額とずれます。

SDKが唯一モデル化している請求ルールはデータレジデンシー価格で、レスポンスのusageがinference_geo: "us"を返す場合、そのレスポンスのトークンの定価に1.1倍を掛けて計算します(TypeScript Agent SDK v0.3.239以降、Python Agent SDK v0.2.144以降が対象)。Web検索のようなリクエスト単位の追加料金はこの倍率の対象外です。開発時の目安や大まかな予算感覚としては使えますが、正式な請求額の確認はUsage and Cost APIまたはConsoleのUsageページで行うのが確実で、この推定値だけを根拠にエンドユーザーへの課金や財務判断をしてはいけない、と公式ドキュメントは注意しています。total_cost_usdとサブエージェント分の重複計算を避けて正確に集計する実装はAgent SDK Cost Trackingにまとめています。

max_budget_usdで使いすぎを事前に防ぐ

サブスクリプション経由でAgent SDKを使う以上、共有の利用上限を圧迫しすぎないようにする実践的な手段がmax_budget_usd(Pythonではmax_budget_usd)です。query()に渡しておくと、推定コストが指定額に達した時点で実行が止まり、結果メッセージのResultMessage.subtypeがerror_max_budget_usdになります。この推定値は前段で触れたとおり厳密な請求額ではありませんが、暴走したループや意図しない大量リクエストが利用上限を一気に食いつぶす事態を防ぐ簡易的な安全弁として機能します。上限到達後に予算を引き上げてresumeで続きから再開できるかどうかは、公式ドキュメントには記載がなく未文書化です。

サブエージェントの消費は見えにくい

Agent SDKでサブエージェントを組み合わせると、消費の見え方に注意が必要です。結果メッセージが返すusageフィールドは最上位のエージェントループだけを対象にしており、サブエージェント内で消費されたトークンは含みません。一方、total_cost_usdとmodelUsage(Pythonはmodel_usage)はサブエージェントのリクエストも合算します。usageだけを見て消費を把握していると、サブエージェントを多用する構成ほど実際の消費を過小評価しやすく、共有のプラン利用上限を想定より早く食いつぶす原因になります。

ツリー全体の消費を正確に把握したい場合はmodelUsageないしtotal_cost_usdを基準にする方が実態に近く、usageはあくまで最上位ループの参考値と考えておくのが安全です。サブエージェントの深さ・並行数・使う予算そのものに上限を設けられる設定もあり、共有プールを消費する構成ではmax_budget_usdとあわせて先に絞っておくと、想定外の消費増を後から発見するより手間が少なく済みます。

Team・Enterprise管理者が確認しておきたいこと

組織でAgent SDKの利用を検討している場合、次の2点を押さえておくと判断しやすくなります。

• 共有プールへの影響: サブスクリプション経由のAgent SDK利用は、対話的な利用と同じ組織の消費プールを消費します。本番運用で常時Agent SDKを回す設計なら、対話利用を圧迫しないよう組織の消費プールとは別にAPIキー課金で見積もる方が、コストの予測がしやすくなります
• 本番の自動化はAPIキー前提が無難: 撤回前の案自体が「月次クレジットは個人の実験・自動化向けのサイズで、共有の本番自動化にはAPIキー課金が向く」という位置づけでした。この考え方は撤回後も変わらず有効な整理です

組織の消費プール全体をどう管理するかはClaude Enterpriseの消費管理、Team・座席制Enterpriseで含まれる利用量を使い切った後の使用量クレジットの仕組みはClaude Teamの使用量クレジットにまとめています。

よくある質問

Claude Code GitHub Actions連携もプランの利用上限を消費しますか

サブスクリプション経由で認証している場合は消費します。撤回された専用クレジット案では対象に含まれる予定でしたが、案自体が発効していないため、通常のAgent SDK利用と同じくサブスクリプションの利用上限から消費されます。

対話的なClaude CodeとAgent SDKは同じ上限を共有しますか

はい。サブスクリプション経由であれば、対話的なClaude CodeのCLI・IDE利用とAgent SDK・claude -pの利用は同じプラン利用上限を共有します。利用上限そのものの仕組みはClaude Codeの利用上限で解説しています。

APIキーとサブスクリプションのどちらでAgent SDKを使うのが適切ですか

個人の検証や小規模な自動化ならサブスクリプション認証でも動きますが、共有プールを消費する点は変わりません。継続的に動かす本番の自動化では、消費が他のメンバーの利用に影響しないAPIキー課金の方が予測しやすい構成です。

撤回前のクレジット案のページはまだ参照してよいですか

公式サポートページ自体は「参考情報として残す」という位置づけで削除されていませんが、記載されている内容は2026年6月15日時点で発効していません。ページ内に「クレジットを申請する」といった手順が残っていても、それに従って操作しても専用クレジットは付与されない状態です。今の状態を確認する目的でページの記述を読む分には問題ありませんが、手順として実行する対象ではないと理解しておく必要があります。

まとめ

サブスクリプション経由のClaude Agent SDKとclaude -pは、現状も対話的なClaude Code・Cowork・チャットと同じプラン利用上限を消費します。2026年6月15日に予告されていた専用クレジットへの分離は、同日付で撤回され発効しませんでした。APIキー経由の利用だけは最初から別会計で、この話の対象外です。組織で本番運用の自動化を計画しているなら、共有プールを圧迫しないAPIキー課金での見積もりを検討する価値があります。撤回の経緯自体が示すとおり、この領域は今後も方針が動く可能性があるため、大きな自動化を組む前には公式サポートページの最新版を確認しておくのが無難です。