AI NEWS

AIニュース

2026.06.15

黒山結音

【警告】6月15日、あなたのClaude代が跳ね上がるかも？ APIコストを丸裸にする最強プロンプトと料金変更の全貌

「えっ、私のClaude代、高すぎ…？」

2026年6月15日、Anthropic社はClaudeの料金体系に大きなメスを入れました。もしあなたが「Claude Code」や「Agent SDK」を使って業務の自動化や開発を行っているなら、この変更を知らないと「気づいたら数万円の請求が来ていた」という事態になりかねません。

「APIとかよくわからないし、プロンプトを打つだけだから関係ないでしょ？」と思っているAI初心者のあなた。実は、裏側で動いている自動化エージェント（Subagents）やバックグラウンド処理が、あなたの知らないうちに大量のトークンを消費している可能性があるのです。

本記事では、6月15日からの料金変更の真実を徹底解剖し、あなたの現在の利用状況から「来月以降、一体いくら請求されるのか？」を1円単位で正確に予測する最強のプロンプトを公開します。コピペして実行するだけで、あなたの本当のコストが丸裸になります。現場で使える実践的なマニュアルとして、ぜひ最後までお読みください。

1. 2026年6月15日からのClaude Code料金変更の真実

何が変わったのか？

これまで、Claude Codeの利用は基本的にサブスクリプションの利用枠内に収まっていました。しかし、2026年6月15日以降、対話型の利用と、自動化・プログラムによる利用（非対話モード）が明確に分離されました [1]。

公式ヘルプセンターには以下のように記載されています。

Starting June 15, 2026, Claude Agent SDK and claude -p usage no longer counts toward your Claude plan’s usage limits. Your subscription usage limits stay the same and stay reserved for interactive use of Claude Code, Claude Cowork, and Claude.

— Anthropic Support [1]

つまり、これまでサブスク枠で「タダ」だと思って使っていた自動化処理が、今後は別枠のクレジットから消費されるということです。

対象となる機能

具体的には、以下の機能を利用した場合、通常のサブスクリプション枠ではなく、新たに設けられる「Agent SDK月額クレジット」から消費されます [1]。

対象となる機能	説明
Claude Agent SDK	Python / TypeScript で自作プロジェクトから呼び出す利用
`claude -p` コマンド	Claude Codeの非対話モード（ヘッドレス実行）
Claude Code GitHub Actions	CI/CDパイプラインでの自動実行
サードパーティ製アプリ	Agent SDKを通じてClaude認証を使うアプリ

一方、以下はこれまで通りサブスクリプション枠で利用可能です。

対象外（従来通り）	説明
対話型Claude Code	ターミナルやIDEで直接やり取り
Web/デスクトップ/モバイルのClaude	チャットUI
Claude Cowork	協調作業機能

クレジットの仕組みと上限

この変更に伴い、対象プランのユーザーには毎月「Agent SDKクレジット」が付与されます。このクレジットはアカウントごとに個別に付与され、チームで共有することはできません [1]。

プラン名	毎月の付与クレジット
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

注：EnterpriseプランのStandardシートは対象外です。

以下は、Anthropic公式ヘルプセンターの「Monthly credit by plan」セクションのスクリーンショットです。

Agent SDK Credit Plans - Anthropic公式ヘルプセンターより

クレジットを超過した場合

クレジットの動作は以下の通りです [1]。

まずクレジットから消費：Agent SDKの利用は、毎月のクレジットから優先的に差し引かれます。
クレジット枯渇後は従量課金：クレジットを使い切ると、追加の利用分は「Usage Credits（従量課金）」として標準APIレートで請求されます。ただし、事前にUsage Creditsを有効化している場合のみです。
未有効化の場合は停止：Usage Creditsを有効化していない場合、クレジットが尽きた時点でAgent SDKリクエストは停止し、翌月のリフレッシュまで使えなくなります。

つまり、自分が毎月どれくらい自動化機能を使っているかを把握していないと、無料枠の$20をあっという間に超過し、青天井で課金されるリスクがあるのです。

2. なぜ「コスト推定」が今すぐ必要なのか？

Prompt Caching（プロンプトキャッシュ）の複雑さ

コストを計算する上で最も厄介なのが、Prompt Caching（プロンプトキャッシュ）の存在です。Claudeは、過去の文脈をキャッシュして再利用することで、処理速度を上げ、コストを削減する仕組みを持っています [2]。

公式ドキュメントには以下のように説明されています。

Prompt caching optimizes your API usage by allowing resuming from specific prefixes in your prompts. This significantly reduces processing time and costs for repetitive tasks or prompts with consistent elements.

— Anthropic API Docs [2]

しかし、このキャッシュの料金体系は非常に複雑で、3種類の課金パターンが存在します。

Prompt Cachingの料金体系（2026年6月時点）

以下は公式APIドキュメントの料金テーブルのスクリーンショットです。

Prompt Caching Pricing - Anthropic API Docs公式より

主要モデルの料金をまとめると以下の通りです [2]。

モデル	基本入力 ($/MTok)	5分キャッシュ書込 ($/MTok)	1時間キャッシュ書込 ($/MTok)	キャッシュ読込 ($/MTok)	出力 ($/MTok)
Claude Opus 4.8 / 4.7 / 4.6 / 4.5	$5.00	$6.25	$10.00	$0.50	$25.00
Claude Sonnet 4.6 / 4.5	$3.00	$3.75	$6.00	$0.30	$15.00
Claude Haiku 4.5	$1.00	$1.25	$2.00	$0.10	$5.00

キャッシュ料金の倍率ルール

公式ドキュメントでは、以下の倍率が明記されています [2]。

種類	倍率	意味
5分キャッシュ書き込み	基本入力の 1.25倍	初回のキャッシュ作成時に発生。5分間有効。
1時間キャッシュ書き込み	基本入力の 2倍	より長い1時間のキャッシュ。追加コストで持続時間を延長。
キャッシュ読み取り	基本入力の 0.1倍（10%）	キャッシュヒット時。大幅なコスト削減。

Claude Codeの非対話モード（claude -p）や自動化スクリプトは、バックグラウンドで大量のファイルを読み込み、何度もAPIを叩きます。キャッシュがうまく効いていれば安く済みますが、キャッシュの書き込み（通常の1.25倍〜2倍のコスト）が頻発していると、あっという間にクレジットを食いつぶします [3]。

だからこそ、実際のログから正確な消費トークンとキャッシュの内訳を割り出し、月額コストを予測する必要があるのです。

3. Claude Codeのログ構造を理解する

プロンプトの仕組みを理解するために、まずClaude Codeがどのようにログを保存しているかを知る必要があります。

ログファイルの保存場所

Claude Codeは、すべてのセッション履歴を以下のディレクトリ構造で保存しています [4]。

~/.claude/
├── projects/
│   └── <URLエンコードされたプロジェクトパス>/
│       └── sessions/
│           ├── <session-uuid>.jsonl    ← セッションの会話記録
│           └── ...

プロジェクトパスはURLエンコードされます。例えば /home/user/myapp というプロジェクトは -home-user-myapp というディレクトリ名になります。各セッションはUUIDで命名されたJSONLファイルとして保存され、1行が1メッセージに対応します [4]。

JSONLファイルの構造

各行は以下のようなJSON構造を持ちます [4]。

{
  "type": "assistant",
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "parentUuid": "1a2b3c4d-...",
  "timestamp": "2025-02-20T09:14:32.441Z",
  "sessionId": "abc123",
  "cwd": "/home/user/myapp",
  "message": { ... }
}

コスト計算に使う「usage」フィールド

最も重要なのは、assistant タイプのメッセージに含まれる usage フィールドです。ここに、そのターンで消費されたトークン数の詳細が記録されています [4]。

"usage": {
  "input_tokens": 12840,
  "output_tokens": 631,
  "cache_read_input_tokens": 8200,
  "cache_creation": {
    "ephemeral_5m_input_tokens": 3600,
    "ephemeral_1h_input_tokens": 0
  }
}

フィールド名	意味	課金レート（Sonnet 4.5の場合）
`input_tokens`	通常の入力トークン	$3.00 / MTok
`output_tokens`	出力トークン	$15.00 / MTok
`cache_read_input_tokens`	キャッシュから読み込んだトークン	$0.30 / MTok
`cache_creation.ephemeral_5m_input_tokens`	5分キャッシュに書き込んだトークン	$3.75 / MTok
`cache_creation.ephemeral_1h_input_tokens`	1時間キャッシュに書き込んだトークン	$6.00 / MTok

非対話セッション（Headless）の判別方法

ログから「自動化による実行」と「人間の対話」を区別するために、以下の情報が使われます [3] [4]。

判別手段	説明
`entrypoint` フィールド	`"sdk-cli"` または `"cli"` と記録される（環境により異なる）
`userType` フィールド	`"external"` の場合は外部からの呼び出し
セッションのパス	`subagents/` や `workflows/` 配下のセッション
タイムスタンプのパターン	人間の入力は不規則な間隔、自動化は規則的

4. 最強の「コスト推定プロンプト」とその仕組み

実行するプロンプト（全文）

以下のテキストをコピーして、Claude Code（対話モード）にそのまま貼り付けてください。

Claude Codeの非対話利用コストを、直近7日分のローカルJSONLから読み取り専用で推定してください。

対象は ~/.claude/projects 配下の全プロジェクトです。Agent SDK / claude -p / cron / hook / GitHub Actions / subagent 由来らしき実行を、公式Claude APIレートでモデル別に集計し、30.44/7倍で月額予測してください。

注意:
- 公式の最新API単価を確認して使うこと。
- prompt cacheは cache_read / cache_creation_5m / cache_creation_1h を分けること。
- entrypoint は環境によって sdk-cli ではなく cli と記録される場合があるため、entrypointだけで0件扱いにしないこと。
- subagents/workflows 配下を保守的なheadless候補として別集計すること。
- 人間の対話セッションらしきものは除外候補として(D)に分け、誤判定確認用に出すこと。ただしプロンプト本文や顧客情報は公開向けに伏せること。
- ファイルは変更しないこと。

出力:
(A) モデル別コスト
(B) 自動実行グループ別コスト 7日 / 月額予測
(C) 生入力・出力・cache読込・cache書込の費目内訳
(D) 除外した対話候補の合計
(E) $20 / $100 / $200 のAgent SDKクレジットを差し引いた月額超過見込み

プロンプトの各行を徹底解説

このプロンプトは一見シンプルに見えますが、各行に深い意図が込められています。以下、1行ずつ解説します。

「直近7日分のローカルJSONLから読み取り専用で推定」

安全性の担保です。~/.claude/projects 配下のJSONLファイルを「読み取り専用」で解析するよう明示しているため、あなたの設定や履歴を壊す心配がありません。また「直近7日分」に限定することで、処理時間を現実的な範囲に抑えつつ、直近の利用傾向を正確に反映します。

「30.44/7倍で月額予測」

7日間のデータから月額を推定する計算式です。1ヶ月の平均日数は 365.25 / 12 = 30.44日であり、これを7で割ることで正確な月額換算係数（約4.35倍）を得ています。単純に「4倍」や「30/7倍」とするよりも統計的に正確です。

「prompt cacheは cache_read / cache_creation_5m / cache_creation_1h を分けること」

前述の通り、Prompt Cachingには3つの異なる料金レートがあります。これらを混同すると正確なコスト計算ができないため、明示的に分離を指示しています。

「entrypoint は環境によって sdk-cli ではなく cli と記録される場合がある」

これは実務上の重要な落とし穴への対策です。Claude Codeのバージョンや実行環境によって、非対話モードのログに記録される entrypoint の値が "sdk-cli" だったり "cli" だったりします。この指示がないと、一部の環境で「自動実行が0件」と誤判定されてしまいます。

「subagents/workflows 配下を保守的なheadless候補として別集計」

Claude Codeは複雑なタスクを処理する際、メインのセッションから「サブエージェント」を生成します [4]。これらは subagents/ や workflows/ ディレクトリに保存されることがあり、人間が直接操作していなくても大量のトークンを消費します。「保守的に」とは、疑わしいものは自動実行側にカウントするという意味で、コスト見積もりを安全側（高め）に寄せる指示です。

「人間の対話セッションらしきものは除外候補として(D)に分け」

自動化コストだけを正確に測るために、人間が対話的に使ったセッション（ターミナルで直接質問したもの等）は除外する必要があります。ただし、完全に除外するのではなく「(D)に分けて表示」することで、誤判定がないか人間が確認できるようにしています。

「プロンプト本文や顧客情報は公開向けに伏せること」

動画撮影や社内共有を前提としたプライバシー保護の指示です。ログには実際のプロンプト内容（顧客名や機密情報を含む可能性）が記録されているため、出力時にはマスキングされます。

5. 実践：プロンプトの使い方と結果の見方

実行手順

ターミナルを開く：macOSなら「ターミナル」アプリ、Windowsなら「PowerShell」や「WSL」を開きます。
Claude Codeを起動：普段お使いのプロジェクトディレクトリで claude コマンドを実行します。
プロンプトを貼り付け：上記のプロンプト全文をコピーして、そのまま入力（ペースト）してEnterを押します。
結果を待つ：Claude Codeが自動的にあなたのPC内の ~/.claude/projects フォルダを探索し、直近7日間のログを集計し始めます。プロジェクト数やセッション数によりますが、通常1〜3分程度で完了します。

以下は、Claude Code公式ドキュメントの「Run Claude Code programmatically」ページです。claude -p がどのように動作するかの参考になります。

出力結果の見方と判断基準

出力結果は、(A)〜(E)の5つのセクションに分かれて表示されます。それぞれの見方と、結果に基づく判断基準を解説します。

(A) モデル別コスト

Opus、Sonnet、Haikuなど、どのモデルが最もコストを食っているかがわかります。もしOpus（$5/MTok入力、$25/MTok出力）のコストが異常に高い場合は、自動化スクリプトのモデル指定をSonnet（$3/MTok入力、$15/MTok出力）やHaiku（$1/MTok入力、$5/MTok出力）に落とす最適化が有効です。

(B) 自動実行グループ別コスト 7日 / 月額予測

cronジョブ、GitHub Actions、Agent SDK呼び出しなど、どの仕組みがコストの元凶になっているかが一目でわかります。7日間の実績値と、それを30.44/7倍した月額予測が並記されるため、「このまま使い続けたら月いくら？」が即座に判断できます。

(C) 生入力・出力・cache読込・cache書込の費目内訳

最も技術的に重要なセクションです。cache_creation（キャッシュ書込）の割合が高い場合、キャッシュが有効に機能しておらず、毎回割高な初期読み込みが発生しています。理想的には cache_read の比率が高く、cache_creation が低い状態です。

理想的な状態	問題のある状態
cache_read が全体の70%以上	cache_creation が全体の50%以上
cache_creation_5m が少量	cache_creation_1h が大量（2倍コスト）
output_tokens が入力に対して適切	output_tokens が異常に多い

(D) 除外した対話候補の合計

人間が対話的に使ったセッションの合計コストです。これは6月15日以降も従来通りサブスクリプション枠で消費されるため、Agent SDKクレジットとは別枠です。ただし、ここに自動化セッションが誤って含まれていないか確認してください。

(E) 月額超過見込み

ここが最も重要です。 あなたのプランのクレジット（Proなら$20、Max 5xなら$100、Max 20xなら$200）を差し引いて、「来月、いくら追加で自腹を切ることになるか」が提示されます。

(E)の結果	判断
$0以下（クレジット内に収まる）	現状維持でOK。追加費用なし。
$1〜$50の超過	軽微。スクリプトの頻度を少し減らすか、モデルをダウングレード。
$50〜$200の超過	要注意。利用パターンの見直しが必要。
$200以上の超過	危険。APIキー運用への切り替えを検討すべき。

6. 結果を踏まえた対策

対策1：プランのアップグレード

現在Proプラン（$20クレジット）で超過が発生している場合、Max 5x（$100クレジット）やMax 20x（$200クレジット）へのアップグレードが最もシンプルな解決策です。

対策2：APIキー運用への切り替え

チームで大規模な自動化を回している場合は、個人のクレジットに依存せず、Claude Platform（API Console）のAPIキーを使った従量課金に移行することが推奨されています [1]。

Production automation at scale. The Agent SDK monthly credit is sized for individual experimentation and automation. Teams running shared production automation should use Claude Platform with an API key for predictable pay-as-you-go billing.

— Anthropic Support [1]

対策3：スクリプトの最適化

以下のポイントでコストを削減できます。

最適化ポイント	効果
モデルのダウングレード（Opus → Sonnet → Haiku）	入力コスト最大5分の1に
`--bare` モードの活用	不要なコンテキスト読み込みを省略
キャッシュ効率の改善（同じプレフィックスを維持）	cache_readの比率向上
実行頻度の見直し（cronの間隔を広げる）	総トークン消費量の削減

7. まとめ：現場でAIを使いこなすために

「生成AIを導入して業務を自動化した」と喜んでいても、その裏で莫大なAPIコストが垂れ流しになっていては、実務改善としては失格です。本当のDXとは、単にAIツールを連携させるだけでなく、運用コスト・仕組み・KPIまでを完全にコントロール下に置くことです。

6月15日の料金変更は、Anthropic社からの「AIリテラシーのテスト」とも言えます。薄い一般論ではなく、このプロンプトという「具体・再現性のあるテンプレ」を使って、まずは自社の現状を正確に把握してください。

やるべきことリスト：

Agent SDKクレジットのオプトイン申請を完了する（一度だけの手続き）
本記事のプロンプトを実行し、現在のコストを把握する
(E)の結果に基づき、プランの見直しまたはスクリプトの最適化を行う
月1回、同じプロンプトを実行してコストの推移をモニタリングする

現場で使えなきゃ、そして利益が出なきゃ、AIの意味はありません。今すぐターミナルを開いて、あなたのコストを丸裸にしましょう。

References

[1]: Anthropic Support. “Use the Claude Agent SDK with your Claude plan”. https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan

[2]: Anthropic API Docs. “Prompt caching”. https://platform.claude.com/docs/en/build-with-claude/prompt-caching

[3]: Claude Code Docs. “Run Claude Code programmatically”. https://code.claude.com/docs/en/headless

[4]: Yi Huang. “Inside Claude Code: The Session File Format and How to Inspect It”. https://databunny.medium.com/inside-claude-code-the-session-file-format-and-how-to-inspect-it-b9998e66d56b

WRITERライター紹介

黒山結音

NEXT INNOVAITION　代表取締役

「AIは現場で使えなきゃ意味がない」を掲げ、30社以上にAI顧問として導入から定着までサポート。OpenClaw・Claude・ChatGPTなどAIツールを実務でフル活用し、AI駆動経営を実践。本メディアでは、実際の現場で効果が出た事例や、AI初心者がつまずく「最初の一歩」を、専門用語を極力使わずに解説します。

OpenClaw / Claude Code / Codex / Cursor / Manus