Claude Code コスト最適化完全ガイド｜プロンプトキャッシュ・Max vs API・トークン節約術

結論から言うと、Claude Codeのコストを下げる最短ルートは「プロンプトキャッシュを壊さない運用」「月間トークン量に合わせたプラン選択」「/clear と CLAUDE.md の最適化を中心としたトークン節約術」の3点です。 公式は開発者1人あたり1日約6ドル、90%のユーザーが12ドル以下で収まると公表していますが、実運用ではセッション全トークンの90%以上を占めるキャッシュ読み込みを活かせるかどうかで数倍の差が出ます。

この記事でわかること:

Claude Codeのサブスクリプション（Pro/Max 5x/20x/Team）と API 従量課金の現行料金
プロンプトキャッシュの価格倍率・最小トークン数・キャッシュを壊す操作
月間トークン量別に見た Max と API の損益分岐
/clear /compact /cost などスラッシュコマンドと設定ファイルによる節約テクニック
Opus 4.7・Sonnet 4.6・Haiku 4.5 のモデル別コスト感と選び分け
「サブスクで済ませる人／API に移るべき人」の判定ポイント

誰向けの記事か:

Claude Code の月額が読めず不安な個人開発者
定額プランと従量課金のどちらが安いか判断したいテックリード
チーム導入時のレート制限・Workspace 支出上限を設計したい責任者

Claude Code の課金は「サブスクリプション」と「API 従量課金」の2系統

Claude Code の料金は、(1) claude.com 側で支払う サブスクリプション（Pro/Max/Team/Enterprise）、(2) Claude Console で支払う API 従量課金 の2系統に分かれます。どちらを選んでも Claude Code 本体は同じですが、コストの読み方と上限の設計が大きく違います。

サブスクリプション：月額定額、ただし「Usage limits apply（使用量の上限あり）」が全プランに明記
API 従量課金：使った分だけ入力・キャッシュ・出力トークン単価で加算。Workspace で支出上限を設定可能

公式ドキュメント（code.claude.com/docs/ja/costs）では、開発者1人あたり1日約6ドル、90%のユーザーは日次12ドル以下、チーム利用（Sonnet 4.6 中心・API 経由）は1人あたり月額100〜200ドルが平均値として公表されています。つまりヘビーユーザーでなければ Pro または Max 5x で収まることが多く、逆に複数リポジトリで長時間並列実行するチームでは API 従量課金のほうが可視性と上限制御の点で優位です。

サブスクリプション料金（claude.com/pricing）

プラン	月額	年額払い	Claude Code 利用	使用量（Pro 比）
Free	0ドル	—	×	限定
Pro	20ドル/月	17ドル/月（年額200ドル）	◯	基準
Max 5x	100ドル/月	—	◯	5倍
Max 20x	200ドル/月	—	◯	20倍
Team（標準席）	20ドル/席/月	—	◯	Pro より多い
Team（プレミアム席）	100ドル/席/月	—	◯	Max 5x 相当
Enterprise	20ドル/席 + API 従量	カスタム	◯	カスタム

すべてのプランに使用量上限がある点は要注意です。Max 20x であっても24時間100%並列でエージェントを回すような使い方ではレート制限・フェアユース警告に到達します。

API 従量課金の単価（platform.claude.com/docs/en/about-claude/pricing）

モデル	入力	5分キャッシュ書き込み	1時間キャッシュ書き込み	キャッシュ読み込み	出力
Claude Opus 4.7	5ドル/MTok	6.25ドル	10ドル	0.50ドル	25ドル
Claude Opus 4.6	5ドル	6.25ドル	10ドル	0.50ドル	25ドル
Claude Opus 4.5	5ドル	6.25ドル	10ドル	0.50ドル	25ドル
Claude Opus 4.1	15ドル	18.75ドル	30ドル	1.50ドル	75ドル
Claude Sonnet 4.6	3ドル	3.75ドル	6ドル	0.30ドル	15ドル
Claude Sonnet 4.5	3ドル	3.75ドル	6ドル	0.30ドル	15ドル
Claude Haiku 4.5	1ドル	1.25ドル	2ドル	0.10ドル	5ドル
Claude Haiku 3.5	0.80ドル	1ドル	1.60ドル	0.08ドル	4ドル

※ すべて 1M トークンあたりの価格（MTok）。

公式注記として以下が付いています。

Opus 4.7 は新トークナイザーを採用しており、同じテキストに対し最大35%多くのトークンを消費する可能性あり
バッチ API 利用時は入出力ともに50%オフ（例: Sonnet 4.6 バッチ入力 1.50ドル、出力 7.50ドル）
US 限定推論（inference_geo 指定）は1.1倍（Opus 4.7/4.6 以降）
Fast mode（Opus 4.6 ベータ）は6倍（入力30ドル、出力150ドル）

「Opus 4.1 時代の入力15ドル/出力75ドル」という旧単価を紹介している日本語記事がまだ残っていますが、現行 Opus 4.7 は 1/3 の単価です。見積もりの前提が古いまま導入判断しないよう注意してください。

プロンプトキャッシュの仕組みが、コストの9割を決める

Claude Code のセッションでは、長時間使うほどキャッシュ読み込みがトークン全体の90%以上を占めます。つまり「キャッシュを壊さない運用」こそが最大のコスト削減策です。

価格倍率（基本入力単価に対して）

操作	価格倍率	有効期間
5分キャッシュ書き込み	×1.25	5分（ヒットごとに自動リフレッシュ）
1時間キャッシュ書き込み	×2	1時間
キャッシュ読み込み（ヒット）	×0.1	直前の書き込みと同じ

この倍率から、損益分岐はシンプルに計算できます。

5分キャッシュは「1回でも再利用すれば元が取れる」（1.25 < 1.0 + 0.1）
1時間キャッシュは「2回以上再利用してはじめて元が取れる」（2.0 < 1.0 + 0.1 × 2 ≒ 1.2）

日常のコーディングセッションでは5分キャッシュで十分にヒットします。1時間キャッシュは「長時間同じコンテキストを維持するエージェントワークフロー」などで使うと効きます。

最小キャッシュトークン数（モデル別）

プロンプトが小さすぎるとキャッシュされず、しかもエラーは返らず静かに通常課金されます。公式の最小値は以下です。

モデル	最小トークン数
Claude Opus 4.7 / 4.6 / 4.5	4,096
Claude Opus 4.1 / 4	1,024
Claude Sonnet 4.6	2,048
Claude Sonnet 4.5 / 4	1,024
Claude Haiku 4.5	4,096
Claude Haiku 3.5	2,048

最新世代（Opus 4.7・Sonnet 4.6・Haiku 4.5）は閾値が引き上げられているため、短いプロンプトではキャッシュ恩恵を受けられない点に注意してください。

ブレイクポイントの設計

1リクエストあたり最大4個まで cache_control を設置可能
階層は tools → system → messages の順で評価される
最後のキャッシュブロックから逆方向20ブロック以内でヒット検索される

Claude Code は内部で自動的にシステムプロンプト・CLAUDE.md・ツール定義をキャッシュブロックに分けています。ユーザー側は「キャッシュを壊さない運用」を意識するだけで良いケースがほとんどです。

キャッシュを壊す操作（最も重要な一覧）

以下の変更は、同じ階層以上のキャッシュを全て無効化します。セッション中にこれらを変えると、次のメッセージから5〜10倍の入力コストが発生します。

変更内容	tools 無効化	system 無効化	messages 無効化
ツール定義の変更	◯	◯	◯
tool_choice の変更	◯	◯	—
画像の追加／削除	◯	◯	—
Extended thinking 設定変更	◯	◯	—
Web 検索トグル切替	◯	—	—
引用（citations）トグル切替	◯	—	—
Fast mode 切替	◯	—	—

セッション中に MCP サーバーを追加する・モデルを切り替える・system prompt にタイムスタンプを差し込む、といった操作はキャッシュ全ミスを引き起こす典型です。どうしても途中で切り替えたいときは、一度 /clear で完全リセットしてから変更した方が結果的に安く済みます。

Max プランと API 従量課金の損益分岐

「Max と API はどちらが安いのか？」は、月間トークン消費量で機械的に判断できます。複数の実測レポート（Verdent / SSD Nodes / NxCode / ProductCompass など）を集約すると、おおよそ以下のラインになります。

月間トークン消費	推奨プラン	月額目安
〜50M トークン	API 従量課金	0〜80ドル程度
50M〜200M	Max 5x（100ドル）	100ドル定額
200M〜1B	Max 20x（200ドル）	200ドル定額
1B〜	Max 20x または Enterprise	200ドル〜

実測レポートの代表例では、8か月で100億トークンを消費した開発者が、API 換算で15,000ドル超になるところを Max で約800ドル（約93%節約）というケースが報告されています。ただし24時間フル並列運用はレート制限・フェアユース警告に引っかかるため、「現実的な業務時間で使い切る」前提での試算です。

判断基準

API が有利なケース: 利用時間が日中3〜5時間、週5日。チームで支出上限をかっちり設計したい。複数 Workspace でコストを分離したい。
Max が有利なケース: 1日8時間以上常にエージェントを動かす。長時間キャッシュを温めながらリファクタや仕様策定をする。金額を予測可能にしたい。
Pro（20ドル）で十分なケース: Claude Code は週数時間、残りは Web UI でチャット中心。試用中で使用量が読めない。

判断に迷ったら、まず Pro で1〜2週間運用し、サブスクリプション利用者向けの /stats で利用パターンを可視化してから Max か API に移行するのが確実です。

Max プランでも「無制限」ではない

Max 20x であっても公式は「Usage limits apply」と明記しています。具体的な上限（週あたりのメッセージ数等）は公式非公開ですが、実測レポートによれば以下が目安です。

平均的な業務利用では Max 20x の上限にはまず到達しない
24時間連続のエージェント並列実行ではブロックされる
「フェアユース」違反時は警告 → 一時制限の順で通知される

上限に達した場合は、当月分のプランに追加課金は不可（翌週のリセットを待つ）になるため、ミッションクリティカルな使い方では API 併用が安全です。

スラッシュコマンドで効くトークン節約術

Claude Code のトークン節約は、効果の大きい順にやるのが鉄則です。以下は複数の日本語実践記事の集約と公式ドキュメントから整理した優先順位です。

節約効果が大きい順に並べたアクション

優先度	アクション	推定効果	理由
★★★	`/clear` をタスク区切りで習慣化	30〜70%削減	関係ない履歴を引きずらず、次タスクのキャッシュを温め直せる
★★★	CLAUDE.md を500行以下に収める	10〜30%削減	毎セッションの固定コスト。肥大化はキャッシュ前の基礎代謝を上げる
★★★	専門指示をスキル化（オンデマンド読込）	10〜25%削減	使わないスキルはロードされずコンテキストを食わない
★★	MCP は使う時だけ ON、普段は CLI 代替	10〜20%削減	ツール定義は常時コンテキスト占有。`gh`・`aws`・`gcloud` 等で代替可
★★	Sonnet 4.6 をデフォルト、複雑タスクのみ Opus	5〜60%削減	Opus は入出力とも Sonnet の1.66倍。設計・難解デバッグのみ使う
★★	サブエージェントに高ボリューム操作を委譲	5〜30%削減	ログ解析・ドキュメント取得は子で吸収、親には要約のみ返す
★	`/compact [残したい情報]` で履歴を圧縮	5〜15%削減	`/clear` が使えないとき、指示付きで重要コードを残す
★	Extended thinking 予算を調整	5〜15%削減	単純タスクは `MAX_THINKING_TOKENS=8000`（デフォルト31,999）に
★	プランモード（Shift+Tab）で先に方向性確定	再作業コスト回避	間違った方向に進む前に合意形成
★	前処理フックで入力を圧縮	条件次第	10,000行ログを grep で100行に絞ってから渡す

主要スラッシュコマンド一覧

コマンド	役割	コスト最適化での使いどころ
`/cost`	現セッションのトークン・ドル換算表示	API ユーザーが毎セッション確認
`/stats`	サブスク利用者の使用パターン表示	Pro/Max で利用ペース把握
`/clear`	会話履歴を完全リセット	タスク完了ごとに習慣化
`/compact [指示]`	履歴要約で圧縮	文脈維持したまま縮めたいとき
`/rename` + `/resume`	セッションを名前保存 → 後で再開	クリア前の退避
`/context`	コンテキストの内訳可視化（MCP・履歴等）	肥大の原因特定
`/mcp`	MCP サーバーの一覧・有効切替	不要な MCP を即オフ
`/model`	モデル切替（Opus↔Sonnet 等）	難易度に応じて途中変更（※キャッシュは壊れる）
`/effort`	Extended thinking の努力レベル調整	単純作業では低めに
`/rewind`	間違った方向の会話を巻き戻す	再作業コストの予防

/cost はサブスク利用者では参考値にならない（定額のため実課金には直結しない）点に注意してください。API ユーザーにとっては最重要コマンドです。

設定ファイル（settings.json）での抑制例

{
  "outputStyle": "Concise",
  "env": {
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "MAX_THINKING_TOKENS": "8000"
  }
}

outputStyle: "Concise" で出力の冗長さを抑制
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1 で補助的なモデル呼び出し（要約バックグラウンドジョブ等）を抑制
MAX_THINKING_TOKENS=8000 で拡張思考予算を下げる（デフォルト31,999）

ツール検索（tool search）の閾値調整

MCP ツール定義がコンテキストの10%を超えると、Claude Code は自動で遅延読込（tool search）に切り替わります。閾値は環境変数で変更できます。

export ENABLE_TOOL_SEARCH="auto:5"

auto:5 は「ツール定義がコンテキストの5%を超えたら遅延読込」の意味。MCP を多数接続している環境では閾値を下げることで普段のコンテキストを軽量化できます。

モデル選択とコスト感｜Opus・Sonnet・Haiku の使い分け

Claude Code はセッション中に /model で切り替えられるため、タスクの難易度に応じたモデル選択がコストに直結します。

モデル	得意領域	単価感（Sonnet 比）	目安用途
Opus 4.7	複雑な設計・大規模リファクタ・難解デバッグ	1.66倍（入力5ドル/出力25ドル）	アーキテクチャ決定・難しい数学・マルチステップ推論
Sonnet 4.6	日常コーディング全般	基準（入力3ドル/出力15ドル）	デフォルト推奨。実装・テスト・レビュー・ドキュメント
Haiku 4.5	大量の定型処理・高速応答	0.33倍（入力1ドル/出力5ドル）	ログ解析・ファイル分類・簡単な置換・要約

Opus 4.7 の新トークナイザーに要注意

Opus 4.7 は新しいトークナイザーを採用したため、同じテキストでも最大35%多くトークンを消費する可能性があります。単価自体は旧 Opus 4.1（入力15ドル/出力75ドル）の1/3まで下がっていますが、トークナイザー差分を加味すると実効コストでは1/3よりやや高い点を見積もりに織り込んでください。

モデル切替時のキャッシュ注意

セッション中に /model でモデルを切り替えると、tools と system のキャッシュが無効化されます（上記のキャッシュ破壊表を参照）。頻繁な切替は逆効果です。以下の運用がおすすめです。

Sonnet をデフォルト起動、難タスクに入るタイミングで一度だけ Opus に切替
切替前には /clear で履歴をリセットしておく
Haiku は独立したセッションで並行起動し、大量処理専用として切り分ける

Workspace 支出上限とチームレート制限の設計

API 従量課金を企業で使うときは、Claude Console の Workspace 機能で支出上限とレート制限を必ず設計してください。Claude Console で認証すると「Claude Code」専用 Workspace が自動作成されますが、このワークスペースは認証専用で API キーを発行できません。運用用に別 Workspace を分けて作るのが実務上の定石です。

公式推奨：チームサイズ別レート制限（ユーザーあたり）

チームサイズ	TPM（Tokens/min）	RPM（Requests/min）
1〜5ユーザー	200k〜300k	5〜7
5〜20	100k〜150k	2.5〜3.5
20〜50	50k〜75k	1.25〜1.75
50〜100	25k〜35k	0.62〜0.87
100〜500	15k〜20k	0.37〜0.47
500+	10k〜15k	0.25〜0.35

上位にはチーム共通の月間上限、個人には1日あたり上限を別途かけると「一人の暴走で全社止まる」事故を防げます。

エージェントチーム機能は「約7倍」のトークンを消費する

Claude Code にはプレビュー機能の エージェントチーム（Agent Teams） があり、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効化できます。標準セッションに比べプランモード時で約7倍のトークンを消費すると公式が明記しているため、チームで開放する際は事前にコストシミュレーションを必ずしてください。

バッチ API・Fast mode・US 限定推論の係数まとめ

Claude Code の基本単価に追加でかかる、または割引される修飾子系の一覧です。API 従量課金を使うチームは必ず把握しておきましょう。

修飾子	係数	特徴	併用可否
バッチ API	×0.5（50%オフ）	入出力とも半額。非同期で数時間以内の完了を許容できるジョブ向け	Fast mode と併用不可
Fast mode（Opus 4.6 ベータ）	×6	応答速度優先。対話の体感速度が上がる	バッチ API と併用不可
US 限定推論（`inference_geo`）	×1.1	データレジデンシー要件がある場合	Opus 4.7/4.6 以降で利用可能
プロンプトキャッシュ読み込み	×0.1	最大の節約効果	全プランで有効

リアルタイム対話が必要ないバックエンドのログ分類・テスト生成・ドキュメント翻訳は、バッチ API を選ぶだけで即座に50%コスト削減できます。

月額シミュレーション：3パターンの実例

以下は Sonnet 4.6 を中心に使った場合の概算です。キャッシュ読み込み比率90%を前提にしています。

パターン1：個人開発者（週10時間・Claude Code メイン）

月間入力トークン：50M（うちキャッシュ読み込み45M、書き込み5M）
月間出力トークン：10M
概算コスト: (45M × 0.30ドル) + (5M × 3.75ドル) + (10M × 15ドル) = 約184ドル
おすすめ：Max 5x（100ドル）で大幅に安い

パターン2：スタートアップのテックリード（週30時間・2リポジトリ並行）

月間入力トークン：300M（キャッシュ読み込み270M、書き込み30M）
月間出力トークン：40M
概算コスト: (270M × 0.30ドル) + (30M × 3.75ドル) + (40M × 15ドル) = 約794ドル
おすすめ：Max 20x（200ドル）＋ピーク時のみ API 補完

パターン3：軽い利用（週3時間・主に Web UI と併用）

月間入力トークン：10M（キャッシュ読み込み8M、書き込み2M）
月間出力トークン：2M
概算コスト: (8M × 0.30ドル) + (2M × 3.75ドル) + (2M × 15ドル) = 約40ドル
おすすめ：Pro（20ドル）でやや上限超過リスクあり、超えたら Max 5x へ

トリガーは「月100ドル超え」と覚えておくと簡単です。100ドルを超えるなら Max 5x、200ドルを超えるなら Max 20x、500ドル超えが定常化したら API 従量課金で細かく制御する、というしきい値が実務的な判断軸になります。

こんな人におすすめ / おすすめしない人

Max 5x（100ドル）がおすすめ

1日3〜5時間 Claude Code を使う個人開発者
月額の予測可能性を最優先したい
複数プロジェクトを横断するが1日の総時間は8時間以内
キャッシュを温めたまま長時間リファクタを進めたい

Max 20x（200ドル）がおすすめ

毎日8時間以上 Claude Code を回す専業開発者
複数エージェントを並列で走らせる日が多い
Web UI と Claude Code を両方ヘビーに使う
過去に Pro や Max 5x で使用量上限に到達したことがある

API 従量課金がおすすめ

チーム導入でユーザーごとの支出・使用量を可視化したい
Workspace ごとにコストを分離しプロジェクト別に請求したい
バッチ API で非対話ジョブを大量に流したい
月間トークン消費が50M以下で、Pro では上限に引っかかりそうな人

サブスクリプション・API どちらもおすすめしない／向かない人

Bedrock / Vertex AI / Azure Foundry 経由の必須要件がある：/cost やメトリクスが Anthropic に送信されないため、LiteLLM 等の外部ツール前提になる
24時間フル並列の自動化エージェント運用：どのプランでもフェアユース警告に引っかかる可能性が高い。Enterprise の個別契約が前提
コストの読み方を学ぶ時間が取れない：キャッシュの概念抜きでは Claude Code のコストは予測不能。最低限 /cost と /clear を覚えられる人向け

よくある質問（FAQ）

Q1. `/cost` の金額はサブスクでも見えますか？

見えますが、Pro/Max では参考値です。定額のため実際の支払いには直結しません。使用量のペース把握には /stats のほうが適しています。API ユーザーにとっては /cost が最重要コマンドです。

Q2. プロンプトキャッシュは自動で効きますか？

Claude Code は自動でシステムプロンプト・CLAUDE.md・ツール定義をキャッシュします。API を直接叩く場合は cache_control を明示的に設定する必要があります。Claude Code 経由で使う限り、ユーザーが気にすべきは「キャッシュを壊す操作をしない」という運用のほうです。

Q3. Opus 4.7 は旧 Opus 4.1 より本当に安いですか？

単価は1/3ですが、新トークナイザーで最大35%トークン増が発生します。実効コストでは旧単価の約45%程度になる計算で、それでも大幅に安いです。ただし見積もりで「1/3」と単純計算すると誤差が出ます。

Q4. Max プランは本当に無制限ですか？

無制限ではありません。全プランに「Usage limits apply」が明記されています。実測レポートでは平均的な業務利用で Max 20x の上限到達は稀ですが、24時間フル並列運用では警告が出ます。

Q5. Bedrock / Vertex / Foundry 経由でもコスト最適化の方法は同じですか？

キャッシュの概念は共通ですが、/cost や Anthropic 側のメトリクスは使えません。Azure AI Foundry はプロンプトキャッシュがプレビュー提供中、Bedrock / Vertex は近日対応ステータスです。LiteLLM などの外部プロキシでコスト計測するのが現時点の定石です。

Q6. エージェントチーム機能を使うといくらくらい増えますか？

公式によると標準セッションの約7倍のトークン（プランモード時）を消費します。デフォルト無効で、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効化できます。導入前に必ずコストシミュレーションを実施してください。

Q7. キャッシュヒット率を可視化できますか？

API レスポンスには cache_creation_input_tokens と cache_read_input_tokens が含まれるため、ログ集約すればヒット率を計算できます。Claude Code 単体で可視化する機能はまだなく、API ユーザーは /cost と請求明細の組み合わせで確認するのが現実的です。

Q8. 1時間キャッシュはいつ使いますか？

同じ大きなコンテキストを2回以上、1時間以内に再利用するシーンで使います。たとえば大規模なシステム設計ドキュメントをプランニング → 実装 → レビューで参照するようなワークフローです。1回しか使わないなら5分キャッシュの方が安くつきます。

まとめ：Claude Code のコストは「キャッシュ × プラン選択 × 運用習慣」で決まる

Claude Code のコスト最適化で押さえるべきポイントを最後にまとめます。

キャッシュ読み込みはセッション全体の90%以上を占める。キャッシュを壊さない運用（MCP追加・モデル切替・tool_choice変更を避ける）が最大の節約
月間50M以下は API、50〜200Mは Max 5x、200M以上は Max 20x が損益分岐のおおまかな目安
/clear の習慣化・CLAUDE.md の500行以内維持・Sonnet デフォルト化 が節約効果の大きい三種の神器
Opus 4.7 は旧単価の1/3に下がっているが、新トークナイザーで最大35%トークン増を加味
バッチ API は50%オフ、Fast mode は6倍、US 限定推論は1.1倍 などの修飾子係数を把握
Max でも使用量上限あり。24時間並列運用は API または Enterprise を検討
企業導入時は Workspace 支出上限とチームレート制限を必ず設計

Claude Code は更新頻度が高いため、導入判断前に必ず公式ページで最新をご確認ください。