ClaudeプランでClaude Agent SDKを使う方法

Anthropicは、2026年6月15日より、既存のClaudeサブスクリプションでClaude Agent SDKを実行できるようにします。これまでは、Agent SDKで何かを構築するには、Claude ProまたはMaxに対してすでに支払っている料金とは別に、従量課金制のAPIキーが必要でした。6月15日以降、毎月のClaudeプランには、Agent SDKの使用に特化したクレジット残高が含まれます。APIキーは不要です。

カスタムエージェント（デプロイボット、リサーチアシスタント、トリアージツールなど）を構築したいと思ったことはあるものの、プロトタイプ作成のためだけにAnthropicに別途請求カードを登録したくなかった場合、この変更は重要です。あなたのProサブスクリプションには、月額20ドルのAgent SDK使用クレジットが含まれるようになりました。Max 20xには200ドル、Team Premiumシートには100ドルが含まれます。

button

2026年6月15日に何が変わったのか

要するに、Agent SDKの利用は、Claudeプランに紐づいた月額クレジットから消費されるようになりました。以前は、Anthropic APIを介して、別途コンソール残高で請求されていました。

以下は、Anthropicの発表から直接引用したプラン別のクレジットです。

プラン	月額Agent SDKクレジット
Pro	20ドル
Max 5x	100ドル
Max 20x	200ドル
チームスタンダード（1シートあたり）	20ドル
チームプレミアム（1シートあたり）	100ドル
エンタープライズ（使用量ベース）	20ドル
エンタープライズプレミアムシート	200ドル

いくつかの重要なルール：

エンタープライズスタンダードシートのメンバーはクレジットを受け取れません。 APIキーを使用するか、プレミアムシートにアップグレードする必要があります。
クレジットはユーザーごとに付与され、譲渡できません。 あなたのシートのクレジットをチームメイトと共有することはできません。
未使用のクレジットは繰り越されません。 請求サイクルの終わりに残った分はリセットされます。
1回限りのオプトインが必要です。 クレジットは一度申請するまでアカウントで有効になりません。その後は毎月自動的に更新されます。
APIキーユーザーはクレジットを受け取りません。 これはプラン固有のものです。ANTHROPIC_API_KEYを介して認証している場合、以前の請求モデルのままです。

クレジットでカバーされるものと、カバーされないもの

Anthropicはこれを慎重に区別しています。よく読んでください。「カバーされるもの」と「カバーされないもの」の境界線が、実際の請求額が変わるかどうかを決定します。

Agent SDKクレジットでカバーされるもの：

独自のPythonまたはTypeScriptプロジェクトからのClaude Agent SDK呼び出し
Claude Codeのclaude -pコマンド（非対話モード、スクリプト化されたエージェント実行に使用）
Claude CodeのGitHub Actions連携
Agent SDKを使用して認証するサードパーティアプリケーション

カバーされないもの（これらは引き続き通常のClaudeプランから、または別途請求されます）：

対話型のClaude Codeセッション（日常的に使用する通常のCLI）
Claudeウェブアプリまたはモバイルアプリでの会話
Claude Coworkセッション

言い換えれば、Agent SDKクレジットは、プログラムによる自動化された非対話型のワークロード専用です。通常のClaude Code作業は、プランの既存の利用制限の範囲内で、Anthropicが最近7月13日まで50%引き上げたものです。2つの別々の予算、2つの別々の目的です。

これは意義深い設計上の選択です。つまり、Claude Codeを介した日常的なコーディングに使う予算を食い潰すことなく、SDK上に構築されたカスタムエージェントを試すことができるということです。

クレジットがなくなった場合

クレジットは毎月固定額をカバーします。それを超えた場合に何が起こるかは、1つの設定によって異なります。

追加使用を有効にする：超過分は、プランの支払い方法に対して標準APIレートで従量課金されます。
追加使用を無効にする：サイクルがリセットされるまで、リクエストはクレジット上限で停止します。

プロトタイプ作成作業では、追加使用を無効にしておいてください。これにより、明確な停止シグナルが得られ、予期せぬ請求を回避できます。実行し続ける必要がある本番環境レベルの自動化では、これを有効にしてください。

クレジットは常に最初に消費されます。月額上限を使い切るまで、超過料金は発生しません。

オプトインの方法

クレジットはデフォルトでは有効になっていません。オプトインは1回限りで、請求サイクルを越えて有効ですが、一度は実行する必要があります。

サブスクリプションを所有するClaudeアカウント（Pro/Maxのユーザーアカウント、またはTeam/Enterpriseのシートアカウント）にログインします。
Claude Agent SDKのプラン設定ページにアクセスします（Anthropicの公式サポート記事からリンクされています）。
クレジットを申請します。これ以降、クレジットは毎月自動的に更新されます。

チームプランで複数のシートがある場合、すべてのユーザーが個別に申請する必要があります。管理者はシートメンバーに代わって申請することはできません。

PythonまたはTypeScriptでSDKを設定する

Agent SDKはPythonとTypeScriptの両方で提供されています。両方とも、生APIキーではなくClaude Code CLIを介して、あなたのプランに対して同じ方法で認証します。

Python

インストール：

pip install claude-agent-sdk

まずClaude Codeにサインインして認証します：

claude login

これにより、プランに紐づいた認証情報がローカルに保存されます。Python SDKはそれらを自動的に取得します。プランベースの使用の場合、ANTHROPIC_API_KEYを設定する必要はありません。

最小限のエージェントは次のようになります：

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run("Review the diff in /tmp/patch.diff and flag concerns.")
print(response.text)

以前は、同じ呼び出しでANTHROPIC_API_KEYと従量課金制のAPI請求が必要でした。今では、代わりにプランのクレジットから消費されます。

TypeScript

インストール：

npm install @anthropic-ai/claude-agent-sdk

同じClaude Codeログインを介して認証します：

claude login

TypeScriptでの最小限のエージェント：

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

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);
console.log(response.text);

SDKがClaude Codeの認証情報を自動的に見つけられない環境（CIランナー、Dockerコンテナ、リモート開発ボックスなど）では、それらを環境変数として設定できます。AnthropicはAgent SDKドキュメントで正確な変数名を公開しています。

SDKのセットアップにたどり着く前にClaude Codeログインで設定エラーが発生する場合は、無効なcustom3pエンタープライズ設定の修正が最も一般的な原因をカバーしています。

`claude -p`ワークフロー

Agent SDKクレジットを使用する、コードを書く必要のない2つ目の方法があります。それはClaude Codeのclaude -pコマンドです。

-pはClaude Codeを非対話モードにします。プロンプトを与えると、リポジトリに対して実行され、終了します。やり取りのセッションはありません。これは、CIパイプライン、cronジョブ、GitフックにClaude Codeをスクリプトとして組み込む方法です。

簡単な例：Claudeに危険な変更を指摘させるプリコミットフック。

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)
claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:\n\n$DIFF"

6月15日以降のclaude -pのすべての呼び出しは、対話型Claude Codeの予算ではなく、Agent SDKクレジットから消費されます。つまり、日常的なコーディングに必要な制限を使い果たすことを心配することなく、自動化されたワークフローに組み込むことができます。

これは、自律的なループのための/goalコマンドや、実行間でエージェントを確実に操縦するためのAGENTS.mdコンテキストファイルと相性が良いです。

GitHub Actions連携

Claude CodeのGitHub Actions連携は、SDKクレジットでカバーされる3番目のワークロードです。ClaudeをPRレビュー、Issueトリアージ、またはリリースノート生成に組み込んでいる場合、それらのワークフロー実行は、GitHub AppをインストールしたユーザーのAgent SDKクレジットに対して請求されるようになりました。

これは、Claude Code上に構築されたGitHubトリアージボットであるClawsweeperのようなプロジェクトで役立ちます。このようなプロジェクトでは、自動化が常に実行され、以前はAppにアタッチされたAPIキーに請求されていました。

実用的なエージェントを構築する：SDKとApidogの組み合わせ

Agent SDKの真価は、テキストに返信する以上のことを行うエージェント、つまり実際のAPIを呼び出し、データベースをクエリし、コードをデプロイするエージェントにあります。それを確実に機能させるためには、エージェントが触れるすべての外部APIに対して明確な契約が必要です。契約がないと、エージェントはリクエストの形状を推測し、デバッグ時間のほとんどが幻覚ペイロードの修正に費やされます。

ここでApidogがワークフローに適合します。

まずApidogでAPI契約を定義します。 エンドポイント、リクエスト/レスポンススキーマ、サンプルペイロードを仕様化します。これが信頼できる情報源となります。
OpenAPIをエクスポートし、 エージェントにコンテキストとして渡します。
SDKを使用してエージェントを実際のエンドポイントに接続します。 エージェントは、正しいと認識しているスキーマを使用してAPIを呼び出します。
Apidog CLIで検証します。 すべてのエージェント実行で、APIが契約通りに返されることを確認できます。

MCPサーバーを介して他のツールをオーケストレートするエージェントの場合、Apidogを使用したMCPサーバーテストワークフローが対応するガイドです。これにより、エージェントが呼び出すツールに対するエンドツーエンドのテストカバレッジが得られます。

より大きな全体像は、デザインファーストのAPIワークフローガイドにあります。エージェントが検証すべき契約を持っている場合、開発者としてのあなたの時間は、エージェントの出力におけるJSONスキーマのバグを追いかけるのではなく、より良い契約と制約を書くことに費やされることになります。

Agent SDKプロジェクトを裏付ける契約層が必要な場合は、無料でApidogをダウンロードしてください。

それでも別のAPIキーが必要な場合

プランベースのクレジットは、ほとんどの構築者にとって適切なデフォルトです。ただし、スタンドアロンのAPIキーが理にかなっているケースもまだあります。

予測可能な予算が必要な本番環境エージェント。 プランクレジットは固定額で上限があります。無制限のスケーリングが必要なエージェントを実行している場合、使用量ベースのAPIキーは、財務および運用チームに明確な請求ラインを提供します。
複数組織アクセス。 APIキーは単一のユーザーに紐づいていません。チームが単一の請求元への共有アクセスを望む場合、それは依然としてAPIキーの役割です。
エンタープライズスタンダードシート。 これらはAgent SDKクレジットを受け取りません。エンタープライズスタンダードシートにいてSDKアクセスが必要な場合は、APIキーがその手段となります。

無料のClaude APIアクセスガイドでは、Proプランも有料APIキーも必要としないClaudeの使用方法をカバーしています。

開始前の簡単なチェックリスト

[ ] プランが対象リスト（Pro、Max 5x、Max 20x、チームスタンダード、チームプレミアム、エンタープライズ使用量ベース、エンタープライズプレミアムシート）に含まれていることを確認する
[ ] Agent SDKクレジットの1回限りのオプトインを申請する
[ ] 追加使用を有効にするかどうかを決定する（プロトタイプ作成にはオフ、本番環境にはオン）
[ ] claude loginを実行して、プランに対してSDKを認証する
[ ] PythonまたはTypeScript SDKパッケージをインストールする
[ ] 最小限のエージェントを構築し、ANTHROPIC_API_KEYが設定されていない状態で実行されることを確認する
[ ] 最初数回の実行後に、アカウント設定でクレジット残高を確認する

よくある質問

プランクレジットを機能させるために、古いANTHROPIC_API_KEYを削除する必要がありますか？ SDKはClaude Codeのローカル認証情報が存在する場合にそれを使用します。つまり、claude loginを実行すればSDKはプランベースの請求に切り替わります。他のツール用に環境変数としてANTHROPIC_API_KEYが設定されている場合は、そのままにしておいてください。SDKはプラン認証が存在する場合にそちらを優先します。

クレジットに対する1つの「リクエスト」とは何ですか？ クレジットはリクエスト数ではなくドル建てです。各SDK呼び出しは、Anthropicが公開しているAPI使用料と同じレートで請求されます。ツール使用やコンテキストトークンを含む、すべてのモデル呼び出しのコストに応じてクレジット残高が減っていきます。追加のリクエストごとの料金はありません。

チームメイトとクレジットを共有できますか？ いいえ、できません。クレジットはユーザーごとに付与され、譲渡できません。各チームまたはエンタープライズシートには、独自のクレジットプールがあります。

古いAnthropic APIコンソールの残高はどうなりますか？ そのまま残ります。プランクレジットは別の請求メカニズムです。APIコンソールに前払い残高があった場合、それは引き続きAPIキーを使用するワークロードに適用されます。

Agent SDKはClaude Codeと同じですか？ いいえ、異なります。Claude CodeはAnthropicが提供する公式のCLIおよびIDE拡張機能です。Agent SDKはカスタムエージェントを構築するためのプログラミングライブラリ（PythonまたはTypeScript）です。クレジットはSDKとClaude Codeの非対話型claude -pコマンドをカバーします。対話型Claude Codeは通常のプラン利用のままです。

GitHub Actionsの請求は変わりますか？ あなたのActionが公式のClaude Code GitHub Actions連携を使用し、かつクレジットがインストールユーザーのアカウントで申請されている場合、それらの実行はAPIキー請求ではなくSDKクレジットから消費されるようになります。

クレジットはAgent SDKやclaude -p以外でも機能しますか？ カバーされる4つの対象（Python/TSのSDK、claude -p、GitHub Actions、サードパーティのAgent SDKアプリ）以外では機能しません。その他のClaudeの使用は、リクエストの発生元に応じて、プランの通常の制限またはAPIキーにフォールバックされます。