Claude プラン（Pro/Max）で Claude Agent SDK を使う方法｜月次クレジット制度を読み解く

2026年6月15日、Anthropicは公式サポート記事で Claude のサブスクリプションプランから Claude Agent SDK を使うときの課金の扱い を明確にした。要点はひとつ——Pro / Max / Team / Enterprise の各プランで、Agent SDK と claude -p（Claude Code の非対話モード）の使用が、新設の月次「Agent SDK クレジット」から引き落とされる別枠 になる、という変更だ。

これまでサブスクリプションでこうした自動化を回そうとすると、対話利用と同じ使用制限を食い合う構造だった。今回の変更で、SDK 経由の自動実行はプランの対話枠とは独立した予算で動く。本記事は推測を交えず、公式サポート記事と公式 Agent SDK ドキュメントに書かれている事実だけ を引用・整理し、対応プラン・クレジット額・認証・除外範囲・APIキーとの違いを読み解く。

Claude Code とエージェント基盤の全体像は Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き を先に押さえておくと理解が早い。

1. Claude Agent SDK とは何か——Claude Code をライブラリ化したもの

まず土台を短く確認しておく。Claude Agent SDK は、Claude Code を動かしているのと同じ仕組みを、自分のプログラムから呼び出せるライブラリだ。公式 Agent SDK ドキュメントは次のように説明している。

The Agent SDK gives you the same tools, agent loop, and context management that power Claude Code, programmable in Python and TypeScript.

つまり、ファイル読み書き・コマンド実行・Web 検索・コード編集といった Claude Code の機能一式が、そのまま Python / TypeScript のコードから使える。ツール実行のループを自分で書く必要はなく、Claude が自律的にツールを呼ぶ。導入は次の1行だけだ。

# Python（Python 3.10 以降が必要）
pip install claude-agent-sdk

# TypeScript（プラットフォーム向けの Claude Code バイナリを同梱）
npm install @anthropic-ai/claude-agent-sdk

最小のエージェントはこう書ける。auth.py のバグを見つけて直す、という指示を渡すだけで、Claude が Read → Edit → Bash を自分で選んで実行する。

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
    ):
        print(message)  # Claude reads the file, finds the bug, edits it


asyncio.run(main())

公式ドキュメントは、Agent SDK を他の Claude 開発手段とも対比している。直接 API を叩く Anthropic Client SDK は「プロンプトを送り、ツール実行は自分で実装する」方式で、ツールのループを自前で書く。対して Agent SDK は「Claude が組み込みのツール実行を自律的に回す」方式だ。さらに Anthropic がエージェントとサンドボックスをホストする Managed Agents もあり、公式は次のように位置づけを示している。

公式は「Agent SDK でローカルに試作し、本番では Managed Agents へ移すのが一般的な道筋」とも述べている。Managed Agents の仕組みは Claude Managed Agents入門——Anthropic製エージェント実行基盤の仕組みと始め方 で扱っている。

このライブラリ自体の詳しい使い方は本記事の主題ではない。ここで押さえるべきは、「SDK 経由の実行は Claude Code を自動で動かしているのと同じ」 という点だ。だからこそ、その実行コストをプランの中でどう扱うかが今回の論点になる。エージェントの基礎概念から確認したい場合は AIエージェントとは？仕組み・種類・代表的OSSフレームワークを初心者向けに解説【2026年版】 も参照されたい。

2. なぜプランから使えるように整理されたのか——別枠化の意義

今回の公式記載の核心は、SDK の自動実行を「プランの対話枠とは別の予算」に切り出した ことにある。公式サポート記事は次のように述べる。

Claude Agent SDK と claude -p の使用は Claude プランの使用制限にカウントされなくなります。

この一文の意味は大きい。従来、SDK や claude -p でバッチ処理や CI を回すと、その消費は対話で使う使用制限と同じ枠を削っていた。自動化を増やすほど、手元での対話利用が早く頭打ちになる構造だ。今回はそこに 専用の月次クレジット を充て、対話とは独立した予算で自動実行を回せるようにした。これが「プランから Agent SDK を使う」という今回の公式整理の実体である。

3. 対応プランと月次クレジット額——Pro / Max / Team / Enterprise

公式記載では、有効になるのは次のプランだ。日本語版は発効とプランをこう記している。

2026 年 6 月 15 日から Pro、Max、Team、および Enterprise プランで利用可能です。

プランごとの月次 Agent SDK クレジット額は、公式表で次のように定められている。金額・条件は原文ママを優先して整理した。

注意したいのは末尾の行だ。公式英語版は Enterprise の標準シートメンバーはクレジットを請求できない（Enterprise Standard seat members cannot claim the credit）と明記している。Enterprise でも、シートの種別によって扱いが分かれる点は見落としやすい。料金全体の比較や API 側の費用感を確認したい場合は Claude Code 料金まとめ2026｜API・Fable 5・Opus 4.8を計算ツールで比較 が参考になる。

4. 認証フロー——サブスクリプションログイン方式と API キー方式

ここが実務でいちばん混同しやすい。クレジット対象になるかどうかは、どの認証で SDK を動かしているか で決まる。公式 Agent SDK の Python ドキュメントは、認証手段を次のように整理している。

The SDK uses your Claude API credentials. Set your API key via environment variable. Alternatively, the SDK can use Claude Code CLI authentication if installed.

整理すると、認証には大きく2系統がある。

・API キー方式：export ANTHROPIC_API_KEY=... を設定して動かす。これは Claude Platform の従量課金で、今回のサブスクリプションクレジットの対象外
・サブスクリプションログイン方式：Claude Code CLI でプランにログインした認証状態を SDK が利用する。この経路で動かした SDK / claude -p の使用が、今回の月次クレジットから引き落とされる

つまり「同じ SDK でも、認証経路によって課金の置き場所が変わる」。流れを図にすると次のとおりだ。

APIキー方式とサブスクリプションログイン方式の違いを、もう少し並べて比較しておく。

5. セットアップ手順——インストールからプランでの実行まで

ここでは公式記載の範囲で、サブスクリプションのクレジットを使って SDK を動かすまでの流れを示す。手順は「Claude Code CLI でプランにログイン → SDK を導入 → 実行」という順序になる。

# 1) Claude Code をインストールし、プランのアカウントでログインしておく
#    （SDK は Claude Code CLI の認証情報を利用できる）

# 2) SDK を導入（Python か TypeScript のどちらか）
pip install claude-agent-sdk
# または
npm install @anthropic-ai/claude-agent-sdk

# 3) 最小のエージェントを実行
python your_agent.py

非対話で1タスクだけ回したいなら、claude -p でも同じクレジットの対象になる。CI やスクリプトから呼ぶ用途はこちらが手軽だ。

# 非対話モード（このプラン使用も月次 Agent SDK クレジット対象）
claude -p "Summarize the open TODOs in this repo"

6. 使用量・上限の扱い——消費順序と繰り越し

クレジットの消費ルールも公式に明記がある。重要なのは「他のソースより先に Agent SDK クレジットから引かれる」という順序だ。英語版は次のように述べる。

Agent SDK usage draws from your monthly credit before any other source.

そして月次クレジットは使い切り型で、繰り越しはできない。日本語版の記載は明快だ。

未使用のクレジットは次の請求サイクルに繰り越されません。

整理すると、使用量まわりの公式記載は次の3点に集約される。

・消費順序：Agent SDK の使用は、他のどのソースよりも先に月次クレジットから引かれる
・繰り越しなし：未使用分は翌請求サイクルに持ち越せず、毎月リフレッシュされる
・共有・プール不可：クレジットはアカウント単位で、チーム内での共有・合算はできない

クレジットを使い切ったあとの具体的な挙動（従量課金へ自動で切り替わるのか、停止するのか等）について、本記事が参照した公式記載の範囲では明示の手順は確認できなかった。ここは 公式には詳細な記載なし とし、推測で補わない。最新の挙動は必ず公式サポート記事と請求画面で確認してほしい。

7. Claude Code との関係——同じ基盤、扱いが分かれるのは「経路」

SDK と Claude Code は別物ではない。第1章のとおり、SDK は Claude Code をライブラリ化したものだ。だからクレジットの線引きは「ツールが違うから」ではなく「実行経路が対話か自動か」で引かれている。公式記載を経路で並べると、対象・対象外がきれいに分かれる。

線引きをひとことで言えば、「人が画面の前で対話しているもの」は使用制限側、「コードや CI が自動で回しているもの」は Agent SDK クレジット側 という整理になる。claude -p は同じ Claude Code のコマンドでありながら非対話なのでクレジット側、通常の対話起動は使用制限側、という分かれ方が象徴的だ。

この対象/対象外の判定を図にすると次のとおり。

Claude Code を使った大規模オーケストレーションの具体例は Claude Code Dynamic Workflows解説：1,000サブエージェント並列とOpus 4.8 で扱っている。SDK で自動化を組む発想の延長として読むと位置づけが掴みやすい。

8. 既知の制限・注意点——プラットフォームと利用規約

公式記載から、運用前に押さえておきたい制限を整理する。まずプラットフォーム面では、Python パッケージは Python 3.10 以降が必要だと明記されている。

The Python package requires Python 3.10 or later. ... Run python3 --version on macOS or Linux, or py --version on Windows, to check.

この記載から、macOS / Linux / Windows いずれでも動作する ことが読み取れる（バージョン確認コマンドが各 OS 向けに示されている）。TypeScript SDK については、プラットフォーム向けの Claude Code バイナリをオプション依存として同梱するため、Claude Code を別途インストールする必要はない、と公式が述べている。

次に利用規約・認証面の重要な注意がある。サードパーティ開発者が 自社プロダクトに claude.ai ログインを組み込むこと は、事前承認がない限り認められていない。

Unless previously approved, Anthropic does not allow third party developers to offer claude.ai login or rate limits for their products, including agents built on the Claude Agent SDK. Please use the API key authentication methods described in this document instead.

ここは混同しやすいので補足する。サポート記事がクレジット対象に挙げる「サードパーティアプリ」は、利用者自身が自分のサブスクリプションで認証して使う ケースを指す。一方、上の規約は 開発者が他者向けプロダクトに claude.ai ログインを実装する ことを原則禁じている。自分のプランで動かすのか、他者に提供するプロダクトを作るのかで、取るべき認証方式が変わる点に注意したい。商用利用は Anthropic の Commercial Terms of Service に従う、とも公式は明記している。

その他の制限として、アカウント単位・共有不可・繰り越しなしは第6章のとおり。なお、クレジット制度が「アカウントごとの一度きりのオプトインで、以後は毎月自動リフレッシュ」と読める記載もあるが、オプトインの具体的な操作手順までは本記事の参照範囲では確認できなかったため、手順の詳細は公式に直接あたること を勧める。

9. よくある詰まりポイントとトラブルシューティング

公式記載から導ける範囲で、つまずきやすい点と確認方法を整理する。いずれも「推測での対処」ではなく、まず公式の線引きに照らして原因を切り分けるのが近道だ。

・「プランで使っているのに従量課金される」：ANTHROPIC_API_KEY が環境変数に残っていないか確認する。設定されていると API キー認証として扱われ、サブスクリプションクレジットではなく従量課金になる
・「対話で使った分までクレジットから引かれている気がする」：対話型 Claude Code・Web/アプリ会話・Claude Cowork は公式に対象外。クレジットから引かれるのは SDK・claude -p・GitHub Actions・サブスク認証のサードパーティアプリのみ
・「チームでクレジットを合算したい」：公式に共有・プール不可と明記されている。アカウント単位での運用が前提
・「先月の未使用分が消えた」：仕様どおり。未使用クレジットは翌サイクルに繰り越されない
・「Enterprise なのにクレジットが付かない」：Enterprise 標準シートは対象外。シート種別（使用量ベース / シートベースのプレミアム）を確認する
・「pip install が失敗する」：公式は Python 3.10 未満が原因のケースを挙げている。python3 --version（Windows は py --version）で確認する

10. まとめ——「経路と認証」で課金先が決まる

今回の公式変更を一文に圧縮すると、「2026年6月15日から、サブスクリプションで動かす Agent SDK と claude -p は、対話の使用制限とは別の月次クレジットで回る」 となる。重要なのは、SDK か Claude Code かというツールの違いではなく、対話か自動実行かという経路と、サブスクリプションか API キーかという認証で課金先が決まる点だ。

・対応プラン：Pro / Max / Team / Enterprise（Enterprise 標準シートは対象外）
・クレジット額：Pro $20 / Max 5x $100 / Max 20x $200 / Team標準 $20 / Teamプレミアム $100 / Enterprise(使用量) $20 / Enterprise(シート・プレミアム) $200
・対象：SDK・claude -p・GitHub Actions・サブスク認証のサードパーティアプリ／対象外：対話型 Claude Code・Web/アプリ会話・Claude Cowork
・ルール：他ソースより先に消費・繰り越しなし・共有/プール不可
・API キー：「何も変わりません」。従来どおりの従量課金

金額・条件・挙動は今後変わりうるため、実運用の前には必ず一次ソース（下記公式サポート記事）と自分の請求画面で最新の記載を確認してほしい。本記事は公式記載の範囲のみを整理しており、記載がない点は「公式には記載なし」と明示した。

参照ソース

・Use the Claude Agent SDK with your Claude plan（Anthropic 公式サポート・英語版）
・Claude プランで Claude Agent SDK を使用する（Anthropic 公式サポート・日本語版）
・Agent SDK overview（Anthropic 公式ドキュメント）
・Agent SDK Python（Anthropic 公式ドキュメント）