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

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

今すぐApidogを試す

デプロイボット、リサーチアシスタント、トリアージツールなどのカスタムエージェントを試したいが、プロトタイプのためだけにAnthropicへ別の請求カードを登録したくなかった場合、この変更は実装のハードルを下げます。Proサブスクリプションには月額20ドルのAgent SDK使用クレジット、Max 20xには200ドル、Team Premiumシートには100ドルが含まれます。

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で認証している場合は、従来のAPI請求モデルのままです。

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

Agent SDKクレジットでカバーされるのは、プログラムによる自動化・非対話型ワークロードです。

対象になるもの：

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

対象外のもの：

• 対話型のClaude Codeセッション
• Claudeウェブアプリまたはモバイルアプリでの会話
• Claude Coworkセッション

通常のClaude Code作業は、プランの既存の利用制限の範囲内です。Anthropicはこの制限を最近7月13日まで50%引き上げました。

つまり、次の2つは別の予算として扱われます。

• 日常的な対話型Claude Code利用
• Agent SDKやclaude -pによる自動化

この分離により、通常のコーディング用のClaude Code利用枠を消費せずに、SDKベースのカスタムエージェントを試せます。

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

クレジットを使い切った後の挙動は、追加使用の設定で決まります。

• 追加使用を有効にする
  
  超過分は、プランの支払い方法に対して標準APIレートで従量課金されます。

• 追加使用を無効にする
  
  請求サイクルがリセットされるまで、リクエストはクレジット上限で停止します。

プロトタイプでは、追加使用を無効にしておくのが安全です。予期しない請求を避けられます。

本番環境の自動化で停止が許容できない場合は、追加使用を有効にします。いずれの場合も、クレジットが先に消費され、上限を超えるまで超過料金は発生しません。

オプトインの方法

クレジットはデフォルトでは有効になっていません。最初に1回だけ申請が必要です。

手順：

1. サブスクリプションを所有するClaudeアカウントにログインします。
   
   Pro/Maxの個人アカウント、またはTeam/Enterpriseのシートアカウントです。

2. Claude Agent SDKのプラン設定ページにアクセスします。
   
   Anthropicの公式サポート記事からリンクされています。

3. クレジットを申請します。
   
   申請後は、毎月自動的に更新されます。

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

PythonでAgent 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請求が必要でした。現在は、プランのAgent SDKクレジットから消費されます。

TypeScriptでAgent SDKを設定する

TypeScript版をインストールします。

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

Claude Codeにログインします。

claude login

最小構成のエージェントは次のとおりです。

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);

CIランナー、Dockerコンテナ、リモート開発環境など、SDKがClaude Codeの認証情報を自動検出できない環境では、認証情報を環境変数として設定できます。正確な変数名はAnthropicのAgent SDKドキュメントを確認してください。

SDKの前段でClaude Codeログインに失敗する場合は、無効なcustom3pエンタープライズ設定の修正を確認すると、よくある原因を切り分けられます。

claude -pを自動化に組み込む

Agent SDKクレジットを使うもう1つの方法が、Claude Codeのclaude -pです。

-pはClaude Codeを非対話モードにします。プロンプトを渡すと、リポジトリに対して実行して終了します。対話セッションはありません。

用途は次のような自動化です。

• CIパイプライン
• cronジョブ
• Gitフック
• リリース前チェック
• 差分レビュー

例：危険な変更を検出するプリコミットフック。

#!/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クレジットから消費されます。日常的なClaude Code利用枠を消費せずに、自動化ワークフローへ組み込めます。

この使い方は、自律的なループのための/goalコマンドや、実行間でエージェントを安定して制御するためのAGENTS.mdコンテキストファイルと相性が良いです。

GitHub Actions連携で使う

Claude CodeのGitHub Actions連携も、SDKクレジットでカバーされます。

たとえば、次のようなワークフローにClaudeを組み込んでいる場合です。

• PRレビュー
• Issueトリアージ
• リリースノート生成
• 変更内容の要約

これらのワークフロー実行は、GitHub AppをインストールしたユーザーのAgent SDKクレジットに対して請求されるようになりました。

これは、Claude Code上に構築されたGitHubトリアージボットであるClawsweeperのようなプロジェクトで特に有用です。継続的に実行される自動化で、以前はAppにアタッチされたAPIキーに請求されていたためです。

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

Agent SDKの価値は、単にテキストを返すことではありません。実際のAPIを呼び出し、データベースをクエリし、デプロイや検証を実行するエージェントを作れる点にあります。

ただし、エージェントが外部APIを扱う場合は、API契約が必要です。契約がないと、エージェントはリクエスト形式を推測し、デバッグの多くが誤ったペイロードの修正に費やされます。

ここでApidogを使います。

実装フローは次のとおりです。

1. ApidogでAPI契約を定義する
   
   エンドポイント、リクエストスキーマ、レスポンススキーマ、サンプルペイロードを仕様化します。

2. OpenAPIをエクスポートする
   
   エージェントにコンテキストとして渡せる形式にします。

3. Agent SDKで実エンドポイントへ接続する
   
   エージェントは、正しいスキーマを前提にAPIを呼び出します。

4. 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ライブラリです。

クレジットは、Agent SDKとClaude Codeの非対話型claude -pコマンドをカバーします。対話型Claude Codeは通常のプラン利用のままです。

GitHub Actionsの請求は変わりますか？

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

クレジットはAgent SDKやclaude -p以外でも使えますか？

対象は次の4つです。

• Python/TypeScriptのAgent SDK
• claude -p
• Claude Code GitHub Actions連携
• Agent SDKを使用するサードパーティアプリ

それ以外のClaude利用は、リクエストの発生元に応じて、通常のプラン制限またはAPIキー請求にフォールバックされます。