Claude Code特集2026年10月更新

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

公開日: 2026/04/22
更新日: 2026/10/16
Claude Code コスト最適化完全ガイド|プロンプトキャッシュ・Max vs API・トークン節約術

この記事のポイント

Claude Codeのコストを下げる方法を2026年10月時点の公式情報で整理。既定のOpus 5.5とSonnet 5.5の使い分け、プロンプトキャッシュを壊す操作・壊さない操作、MaxとAPI従量課金の損益分岐、/usageを使った節約術まで解説します。

Claude Code のコストを下げるには、次の3つが有効です。既定の Opus 5.5 を日常作業では Sonnet 5.5 に替えること、キャッシュを作り直させる操作(途中のモデル切替・fast mode の ON・長く放置したあとの /compact)を減らすこと、API 換算で月$100を超えたら Max プランに移ることです。 2026年10月時点では、キャッシュ読み込みの単価が入力の1/20まで下がりました。そのため費用の大半は出力(思考トークンを含む)が占めます。

公式ドキュメントによると、企業導入での平均は稼働日1日あたり約$13、開発者1人あたり月$150〜250です。90%のユーザーは稼働日1日あたり$30未満に収まっています(Manage costs effectively)。

この記事では、次の内容を解説します。

  • 2026年10月時点で変わったこと(6月15日の課金変更は一時停止、10月7日から Max・Team に毎月の API クレジット)
  • サブスクリプション(Pro / Max 5x / Max 20x / Team / Enterprise)と API 従量課金の料金
  • Claude Code のプロンプトキャッシュの仕組みと、キャッシュを壊す操作・壊さない操作
  • Max と API のどちらが得かの判断ライン(3パターンの試算つき)
  • /usage・/clear・/effort・モデル選択などのトークン節約術
  • 使用量が急に増えたときの確認手順と、チーム導入時の上限設計

次のような人に向けた記事です。

  • Claude Code の月額が読めず不安な個人開発者
  • 定額プランと従量課金のどちらが安いか判断したいテックリード
  • チーム導入時の支出上限やレート制限を決めたい責任者
  • claude -p や Agent SDK を使った自動化のコストを見積もりたいエンジニア

Claude Code そのものの概要は Claude Codeとは で解説しています。

Claude Code の課金体系:サブスクリプションとAPI従量課金

出典: Anthropic 公式サイト


2026年10月時点で変わったこと|6月の課金変更は停止、Max・TeamにAPIクレジット

2026年5月に予告された「6月15日から Agent SDK などをサブスク枠から切り離す」変更は、6月15日に一時停止されました。現時点では実施されていません。 その代わり、10月7日から Max と Team プランに毎月の API クレジットが付くようになりました。

Anthropic Claude Code GitHubリポジトリの公式ページ

出典: anthropics/claude-code GitHub 公式

5月〜10月の主な変更

時期

変更内容

コストへの影響

2026年5月

Agent SDK・claude -p・GitHub Actions などを別のドル建てクレジットに移す方針を予告(6/15から)

予告のみ

2026年6月15日

5月に予告した変更を一時停止。Agent SDK・claude -p・サードパーティアプリは引き続きサブスクの上限から消費

変化なし

2026年7月24日

Opus 4.7 の fast mode を廃止

fast mode は新しいモデルへ

2026年9月1日

Sonnet 5 の $2 / $10 を標準価格に確定(予定されていた値上げは中止)

据え置き

2026年9〜10月

Opus 5.5・Sonnet 5.5・Haiku 5.5 が登場。Claude Code の既定モデルは全プランで Opus 5.5

単価とキャッシュ倍率が変わった

2026年10月7日

Max・Team に毎月の API クレジット(Pro・Enterprise は対象外)

API 側の自動化費用に充てられる

出典: Help Center: Use the Claude Agent SDK with your Claude plan、Pricing、Fast mode

6月の変更を「実施された」前提で書いた記事がまだ残っています。Pro に$20のクレジットが付く、6月8日のメールで有効化が必要、といった記述は現時点では当てはまりません。

Max・Team の毎月の API クレジット

プラン

毎月の API クレジット

Max 5x

$100

Max 20x

$200

Team Standard

$20/席(組織で合算、上限$500)

Team Premium

$100/席(組織で合算、上限$500)

Free・Pro・Enterprise

なし

公式の説明(API credits for Max and Team plans)で押さえておきたい点は次のとおりです。

  • 受け取り方: claude.ai の Settings > Billing(Team は Organization settings > Billing)で、Claude Console の組織を1つ紐付けます。Console 側に支払い方法を登録する必要はありません。紐付け先は自分では変更できません
  • 使える先: Claude API、Claude Managed Agents、Claude Agent SDK、Playground
  • 使えない先: 対話で使う Claude Code、Claude アプリの利用クレジット、Amazon Bedrock などの他社クラウド
  • 繰り越しなし: 請求サイクルの終わりで失効します。使い切ると API 呼び出しが止まり、Claude プランに請求されることはありません
  • Claude プランの使用量上限は変わりません

公式のプラットフォーム文書は「Claude Code は対象外」と書いています。一方で Help Center は「claude -p も対象」と書いています。両方を合わせると、Console の API キーで動かす claude -p や Agent SDK はクレジットから払え、対話の Claude Code はこれまでどおりサブスクの枠を使うと読めます。ただし公式の明記はないため、導入前に Console の Usage ページで実際の引き落とし先を確認してください。詳しくは Claude Max・TeamのAPIクレジット にまとめています。


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

Claude Platform Docs の料金(Pricing)ページ

出典: Claude Platform Docs(Pricing)

Claude Code の支払いは、claude.ai で払うサブスクリプション(Pro / Max / Team / Enterprise)と、Claude Console で払う API 従量課金の2系統です。 これに加えて、Amazon Bedrock や Google Cloud、Microsoft Foundry 経由で使う方法もあります。どれでログインしたかによって、課金のされ方と上限の効き方が変わります。

使い方

支出の確認先

支出の上限

ユーザー別の集計

Pro / Max(個人)

Claude Code の /usage、利用クレジットの支出

利用クレジットの月の上限(自分で設定)

—

Team / Enterprise(席課金)

組織の analytics の支出レポート

管理画面の支出上限

支出レポートCSV、Enterprise Analytics API

Claude Console(API キー・従量)

Console の Usage ページ

Workspace の支出上限

Console ダッシュボード、Claude Code Analytics API

Bedrock / Google Cloud / Foundry

各クラウドの請求画面

各クラウドの予算機能

OpenTelemetry、LLM ゲートウェイ

出典: Manage costs effectively

注意点: 環境変数 ANTHROPIC_API_KEY が設定されていると、サブスクでログインしているつもりでも API キー認証になり、従量課金で請求されることがあります。いまのログイン方法は /status の Login method で確認できます。

サブスクリプション料金(2026年10月時点)

プラン

月額

Claude Code

使用量の目安

毎月の API クレジット

使えるモデル

Free

$0

×

基準

なし

Sonnet・Haiku

Pro

$20(年払いは$200=月$17相当)

○

Free の5倍以上

なし

Opus・Sonnet・Haiku(Fable は利用クレジットで)

Max 5x

$100

○

Pro の5倍

$100

Fable(週の上限の50%まで)・Opus・Sonnet・Haiku

Max 20x

$200

○

Pro の20倍

$200

同上

Team Standard

$25/席(年払い$20)

○

Pro より多い

$20/席

Opus・Sonnet・Haiku

Team Premium

$125/席(年払い$100)

○

Standard の5倍

$100/席

Fable(週の上限の50%まで)・Opus・Sonnet・Haiku

Enterprise

$20/席(年払い・20席から)+API単価の従量

○

API 単価で課金

なし

Fable・Opus・Sonnet・Haiku

出典: claude.com/pricing、Help Center: What is the Max plan

  • Pro / Max の上限は5時間ごとのセッション枠と、全モデル共通の週の上限の2段です。Claude(Web・デスクトップ・モバイル)と Claude Code で共有されます
  • 具体的な上限値は公式に公開されていません。週の上限の最近の変更は Claude Codeの週の上限の変更 を参照してください
  • 円換算の料金は Claude Code料金【日本円換算】 で確認できます

上限を超えたら「利用クレジット」(旧 Extra Usage)

プランの上限を超えても作業を続けたいときは、利用クレジット(usage credits、旧称 Extra Usage)を使います。API 単価で支払う仕組みで、Claude Code では /usage-credits から設定画面を開けます。Pro / Max は月の支出上限を自分で決められます。Team / Enterprise では、組織・グループ・個人の単位で上限を設定できます。API キー認証では使えません。

利用クレジットで払っている間は、会話本体のキャッシュの寿命が1時間から5分に短くなります。休憩をはさむと作り直しが増えるため、利用クレジットで長時間作業する日は特に注意が必要です。

API従量課金の単価(2026年10月時点・公式確認済み)

モデル

入力

5分キャッシュ書込

1時間キャッシュ書込

キャッシュ読込

出力

Fable 5.1

$10

$12.50

$20

$0.25

$50

Opus 5.5

$4

$5

$8

$0.20

$20

Opus 5

$5

$6.25

$10

$0.50

$25

Sonnet 5.5

$2

$2.50

$4

$0.10

$10

Sonnet 5

$2

$2.50

$4

$0.20

$10

Haiku 5.5(プロンプト10万トークン以下)

$0.10

$0.125

$0.20

$0.01

$0.50

Haiku 5.5(10万トークン超)

$0.50

$0.625

$1

$0.05

$2.50

旧モデル: Opus 4.8 / 4.7 / 4.6 / 4.5

$5

$6.25

$10

$0.50

$25

旧モデル: Sonnet 4.6 / 4.5

$3

$3.75

$6

$0.30

$15

旧モデル: Haiku 4.5

$1

$1.25

$2

$0.10

$5

※ 単位は USD / 100万トークン。出典: Claude Platform: Pricing

※ Opus 4.1・Opus 4・Sonnet 4・Haiku 3.5 は Claude API では提供を終了しています(Bedrock・Google Cloud では一部残っています)

料金で押さえておきたい公式の注記は次のとおりです。

  • トークナイザー: Claude 4.7 以降のモデルは新しいトークナイザーを使います。同じテキストでも約30%多くトークンが数えられます。Sonnet 4.6 以前と単価を比べるときは、この差を加味してください
  • 1M コンテキスト: Claude 4.6 以降(Haiku 5.5 を除く)は、100万トークンまで標準単価です。20万トークンを超えたときの割増はありません。Haiku 5.5 だけは、プロンプトが10万トークンを超えると単価が上がります(キャッシュ読込もこの数に含まれます)
  • 思考トークンは出力として課金されます

プロンプトキャッシュの仕組み|トークンの9割はキャッシュ読込

Claude Code は毎ターン会話の全文を送り直し、前回と先頭から一致している部分をキャッシュ単価で読み込みます。 長いセッションでは、送るトークンの9割前後がキャッシュ読込になることが多くあります。そのため、キャッシュを壊して作り直させる回数が、そのまま費用の増減につながります。

プロンプトキャッシュの書き込みと読み込みの価格倍率

出典: Anthropic 公式ドキュメント(Prompt Caching)

Claude Code がキャッシュする順番は、システムプロンプト(中核の指示とツール定義)→ プロジェクトの文脈(CLAUDE.md・auto memory・パス指定のない rules)→ 会話です。上の層が変わると、その下はすべて作り直しになります。ファイル単位や部分単位のキャッシュはありません(How Claude Code uses prompt caching)。

価格倍率(入力単価に対して)

操作

倍率

補足

5分キャッシュ書込

×1.25

読み込まれるたびに寿命が延びる

1時間キャッシュ書込

×2

5分以上あく作業向け

キャッシュ読込

×0.1

Opus 5.5・Sonnet 5.5 は×0.05、Fable 5.1 は×0.025

公式の説明では、5分キャッシュは1回読み込めば元が取れ、1時間キャッシュは2回読み込めば元が取れます(読込が×0.1のモデルの場合)。

Opus 5.5 と Sonnet 5.5 はキャッシュ読込が入力の1/20になりました。この結果、長い会話でもキャッシュ読込の費用は小さく、請求額の大部分は出力とキャッシュの作り直し(書込)になります。節約の重点は「出力を減らすこと」と「作り直しの回数を減らすこと」の2つです。

キャッシュの寿命(TTL)はプランで違う

リクエストの種類

サブスク(プランの枠内)

利用クレジット・API キー・他社クラウド

会話本体(対話・claude -p・Agent SDK)

1時間

5分

それ以外(サブエージェント・compaction など)

5分(一部は1時間)

5分

出典: How Claude Code uses prompt caching

サブスクで使っている場合、会話本体は既定で1時間キャッシュです。 以前の ENABLE_PROMPT_CACHING_1H=1 を設定しなくても、昼休み程度の中断ならキャッシュが残っています。

API キーで使っていて1時間にしたい場合は、v2.1.242 以降で設定 promptCacheTtl(環境変数なら CLAUDE_CODE_PROMPT_CACHE_TTL)に 1h を指定します。サブエージェント側は subagentPromptCacheTtl で別に指定できます。5分以上あかない短い作業が続く場合は、書込単価が高いぶん1時間キャッシュのほうが損になります。

いまどちらの寿命で書き込まれているかは、claude -p "hello" --output-format json の usage.cache_creation で確認できます。ephemeral_1h_input_tokens と ephemeral_5m_input_tokens のどちらに数字が入っているかを見てください。

最小キャッシュ長(モデル別)

プロンプトがこの長さに満たないとキャッシュされません。エラーは出ず、通常の入力単価で課金されます。

最小トークン数

モデル

512

Fable 5.1・Opus 5.5・Opus 5・Sonnet 5.5・Haiku 5.5 など5.x世代

1,024

Opus 4.8・Sonnet 5・Sonnet 4.6・Sonnet 4.5

2,048

Opus 4.7・Mythos Preview

4,096

Opus 4.6・Opus 4.5・Haiku 4.5

出典: Prompt caching。Bedrock には独自の最小値があります。

5.x世代では最小長が512トークンに下がったため、API を直接使う場合でも短いシステムプロンプトがキャッシュに乗りやすくなりました。

キャッシュを壊す操作・壊さない操作(Claude Code)

キャッシュを壊すと、次の1ターンは全文を書き込み単価で送るため、応答が遅くなり費用も増えます。 Claude Code の公式ドキュメントでは、次のように分けられています。

キャッシュを壊す操作

キャッシュを壊さない操作

/model でモデルを切り替える(モデルごとに別のキャッシュ。opusplan のプランモード出入りも含む)

リポジトリのファイル編集

fast mode を ON にする(1会話につき最初の1回だけ)

セッション中の CLAUDE.md の編集(反映されるのは /clear・/compact・再起動の後)

MCP サーバーの接続・削除(ツールが最初から読み込まれる構成の場合)

権限モードの切替、プランモード(Shift+Tab)

MCP を含むプラグインの有効化・無効化

スキル・コマンドの呼び出し

ツール名そのものを deny ルールに追加(ツールサーチが無効な場合)

/rewind、/recap、サブエージェントの起動

/compact(会話の層を作り直す)

effort の変更(5.5世代と Fable 5.1 を API キーかサブスクで使う場合)

画像・PDF が増えて古いものが間引かれたとき

出力スタイルの切替

Claude Code をアップグレードした後の最初の会話

出典: How Claude Code uses prompt caching

運用のポイントは次のとおりです。

  • モデルの切替は作業の区切りで行う。キャッシュが温かいうちに /model を使うと確認が表示されます
  • MCP は基本的に気にしなくてよい。対応モデルでは MCP のツール定義が既定で遅延読込になるため、接続・削除でキャッシュは壊れません。カスタムの ANTHROPIC_BASE_URL などでツールが最初から読み込まれる構成の場合だけ注意してください
  • /compact は長く放置する前に行う。キャッシュが温かいうちなら要約のリクエスト自体が安く済みます。長時間放置した後の /compact が最も高くつきます
  • ゲートウェイ経由の場合は要確認。ANTHROPIC_BASE_URL 経由のゲートウェイで cache_control が知らないうちに削除されると、毎ターン全履歴が非キャッシュで課金されます

キャッシュの範囲は、実質的に「1台のマシン×1ディレクトリ」です。同じディレクトリで並列に動かしたセッションは互いのキャッシュを読めますが、別ディレクトリとは共有されません。サブエージェントは親のキャッシュを読まずに自分でキャッシュを作ります。/fork で分けた会話は親のキャッシュを読みます。

API を直接使う場合のブレークポイント設計

Agent SDK や API を自分で呼ぶ場合は、cache_control の置き方によってキャッシュの効果が変わります。

  • 1リクエストあたり最大4か所(自動キャッシュを使うと1枠を消費します)
  • 最後のブレークポイントから遡って20ブロック以内でヒットを探します
  • 1時間のエントリは5分のエントリより前に置きます
  • リクエストの最上位に cache_control を1つ置くと、最後のキャッシュ可能なブロックに自動で移動します(自動キャッシュ)
  • ツール定義の変更は全層を、tool_choice や画像の変更は messages 層を無効にします

使用量フィールドの cache_creation_input_tokens と cache_read_input_tokens がどちらも0なら、最小キャッシュ長に届いていない可能性が高いです。

キャッシュの事前ウォーミング

max_tokens: 0 でリクエストを送ると、出力0トークンでキャッシュだけを書き込めます。作業を始める前にキャッシュを温めておきたい場合に使います。

{
  "model": "claude-opus-5-5",
  "max_tokens": 0,
  "cache_control": {"type": "ephemeral"},
  "system": "...大きな共通コンテキスト...",
  "messages": [{"role": "user", "content": "warmup"}]
}

ストリーミング、拡張思考、構造化出力、tool_choice の any / tool 指定、Batch API とは併用できません。

Workspace 単位のキャッシュ分離(2026年2月5日〜)

Claude API・Claude Platform on AWS・Microsoft Foundry では、キャッシュが Workspace 単位で分離されています。Bedrock と Google Cloud は組織単位のままです。複数の Workspace で同じコンテキストを使うと、それぞれで書込費用がかかります。


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

Claude Code 公式ドキュメントのコスト管理ページ

出典: Claude Code Docs(Manage costs effectively)

判断の基準は、API で払った場合の月額です。月$100を超えるなら Max 5x、月$200を超えるなら Max 20x が割安になります。 ただし Claude Code の既定は単価の高い Opus 5.5 なので、同じ使い方でもモデル設定によって API 換算額は2倍変わります。

自分の API 換算額は、/usage の Session に表示されるコストや、ローカルログを集計する ccusage(ccusage の使い方)で確認できます。Pro / Max の Session コストは API 単価で計算した参考値で、実際の請求とは関係ありません。

判断の目安

月の API 換算額(目安)

おすすめ

理由

〜$20

Pro($20)か API 従量

Pro の枠に収まりやすい。使う日が少ないなら API 従量でも安い

$20〜$100

Pro + 必要な月だけ利用クレジット、または API 従量

Max 5x では余りやすい

$100〜$200

Max 5x($100)

定額のほうが安く、API クレジット$100も付く

$200超

Max 20x($200)

対話の枠に加えて API クレジット$200が付く

定常的に$500超・チームで管理したい

Team / Enterprise か API 従量(Workspace で上限管理)

ユーザー別の集計や支出上限が必要になる

この表は公式単価から計算した目安です。Max でも上限はあるため、24時間エージェントを並列で動かし続けるような使い方では上限に当たります。

Max の実質的な価値は「対話の枠+API クレジット」

10月7日以降、Max 20x は$200で「Pro の20倍の対話枠」と「$200分の API クレジット」がセットになっています。CI の自動レビューや Agent SDK のバッチ処理を API で動かしている人なら、その費用の一部をクレジットでまかなえます。ただし、クレジットは繰り越せず、対話の Claude Code には使えません。

Pro / Max の上限に当たったとき

  • 「session limit」「weekly limit」は全モデル共通の枠です。/model で切り替えても回避できません
  • 「Opus limit」「Sonnet limit」と表示された場合は、別のモデルファミリーに切り替えれば続けられます
  • v2.1.234 以降は、リセット後に中断したタスクを自動で再開する待機を設定できます(/rate-limit-options)
  • 「spend limit」系の表示は、利用クレジットの上限に達したという意味です

Max プランの中身は Claude Maxプランとは、Claude 全体のプラン比較は Claude料金を日本円で比較 で詳しく解説しています。


スラッシュコマンドと設定でできるトークン節約術

効果が大きいのは、モデルを Sonnet 5.5 にすること、作業の区切りで /clear すること、/effort で思考の量を抑えることの3つです。 公式ドキュメント「Reduce token usage」の施策を、編集部の判断で効果の大きい順に並べています。

ターミナルでコマンドを使ってトークン消費を抑えるイメージ

節約効果が大きい順のアクション一覧

優先度

アクション

理由

★★★

日常作業のモデルを Sonnet 5.5 にする

既定の Opus 5.5 に比べて入力・出力とも単価が半分

★★★

無関係な作業に移るときは /clear

不要な履歴を毎ターン読み込まずに済む。/clear 自体の費用はゼロ

★★★

/effort で思考の量を下げる

思考トークンは出力として課金される。5.5世代の既定は medium

★★

指示を具体的に書く(「改善して」で終わらせない)

あいまいな指示は広い範囲の読み込みを招く

★★

ログ解析・テスト実行・ドキュメント取得はサブエージェントに任せ、model: haiku を指定

大量の出力を親の会話に持ち込まない。Haiku 5.5 の単価は Sonnet 5.5 の1/20

★★

CLAUDE.md を200行未満にし、専門手順はスキルへ移す

毎回読み込まれる固定費を小さくする

★★

プランモード(Shift+Tab)で方針を固め、ずれたら Esc で止めて /rewind

やり直しを減らす。/rewind はキャッシュ済みの地点に戻るので /compact より安い

★

MCP より CLI(gh・aws・gcloud・sentry-cli など)を使う。使わないサーバーは /mcp で無効化

ツール定義は遅延読込が既定だが、CLI のほうがさらに軽い

★

フックで前処理する(テスト出力を失敗行だけに絞るなど)

長いログをそのまま会話に入れない

★

型付き言語では code intelligence プラグインを使う

定義ジャンプで grep と複数ファイルの読み込みを減らす

★

/compact <残したい内容> で圧縮する

/clear できないときに、重要な内容を残して縮める

出典: Manage costs effectively

以前よく紹介されていた MAX_THINKING_TOKENS=8000 は、5.5世代では効きません。 Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable は適応推論のモデルで、MAX_THINKING_TOKENS は無視されます。思考をオフにすることもできません。思考の量を調整するときは /effort を使ってください。

CLAUDE.md の整理方法は CLAUDE.md 書き方ベストプラクティス、フックで出力を絞る方法は Claude Code Hooks の使い方、MCP の扱いは Claude Code MCP連携ガイド で解説しています。

読ませたくないファイルの除外

node_modules や dist などの大きなディレクトリを読ませないようにするには、permissions の deny ルールを使うのが公式の方法です。書式は公式の permissions ドキュメントで確認してください。.claudeignore というファイルを紹介している記事もありますが、現時点の公式ドキュメントでは記載を確認できませんでした。

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

コマンド

役割

コスト面での使いどころ

/usage

セッションの API 換算コスト、キャッシュの状況、5時間・週の使用量、内訳

毎日の確認。急に増えたときの原因探し

/usage-credits

利用クレジットの設定画面を開く

上限超過時の支払い上限を決める

/context

コンテキストを何が占めているかを表示

肥大化の原因を特定する

/insights

使い方の傾向レポート(HTML)

癖をつかむ(実行自体もトークンを使う)

/clear

会話履歴をリセット

タスクの区切りで使う

/compact [指示]

履歴を要約して圧縮

長く放置する前に行う

/rename + /resume

セッションに名前を付けて保存し、後で再開

/clear の前に退避する

/model

モデルの切替

作業の区切りで切り替える(キャッシュが壊れるため)

/effort

思考の量を調整

単純な作業では下げる

/rewind

会話を巻き戻す

方向がずれたときのやり直し

/mcp

MCP サーバーの一覧と有効・無効

使わないサーバーを止める

/fast

fast mode の切替

サブスクでは利用クレジットから課金される点に注意

/rate-limit-options

上限に当たったときの動きを設定

リセット後の自動再開

旧来の /cost が現在どう扱われているかは、現時点の公式コストページでは確認できません。コストの確認には /usage を使ってください。API の正確な請求額は Claude Console の Usage ページで確認できます。

設定ファイル(settings.json)の例

日常のモデルを Sonnet にし、API キー利用時に会話本体を1時間キャッシュにする例です。

{
  "model": "sonnet",
  "promptCacheTtl": "1h"
}
  • "model": "sonnet" で起動時のモデルを Sonnet にします。その場だけ変えるなら /model sonnet や claude --model sonnet も使えます
  • promptCacheTtl は v2.1.242 以降で使えます。サブスクの枠内で使う場合、会話本体は既定で1時間なので設定は不要です
  • 1時間キャッシュで長い会話を放置すると、期限の直前に自動で compact されることがあります。止めたい場合は idleCompaction: false(v2.1.290〜)を設定します
  • goal 機能の定期チェックインを止めるには CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0 を設定します

ほかの解説記事でよく見かける outputStyle: "Concise"、DISABLE_NON_ESSENTIAL_MODEL_CALLS、ENABLE_TOOL_SEARCH="auto:5" は、現時点の公式コストページでは確認できなかったため例から外しています。


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

Claude Platform Docs のモデル一覧(Models overview)ページ

出典: Claude Platform Docs(Models overview)

Claude Code の既定モデルは、全プランで Opus 5.5 です(Model configuration)。 既定のまま使うと、すべての作業が Sonnet 5.5 の2倍の単価になります。公式も、コーディングの大半は Sonnet で、Opus は設計判断や多段の推論に使う形を勧めています。

モデル

単価(入力 / 出力)

Sonnet 5.5 比

向いている作業

Opus 5.5(既定)

$4 / $20

2倍

アーキテクチャの決定、大規模なリファクタリング、難しいデバッグ

Sonnet 5.5

$2 / $10

基準

実装・テスト・レビュー・ドキュメントなど日常の作業全般

Haiku 5.5

$0.10 / $0.50(10万トークン以下)

1/20

サブエージェントでのログ解析・ファイル分類・要約

Fable 5.1

$10 / $50

5倍

最難関の課題に限定(プランによっては利用クレジット課金)

各モデルの詳細は Claude Opus 5.5とは と Claude Sonnet 5.5とは で解説しています。

新しいトークナイザーに注意

Claude 4.7 以降のモデルは、同じテキストでも Sonnet 4.6 以前より約30%多くトークンが数えられます。Sonnet 5.5 の入力単価は Sonnet 4.6 の$3から$2に下がりましたが、トークン数の増加を加味すると、実際の値下がり幅は単価の差ほど大きくありません。旧モデルの実績から見積もるときは、トークン数を3割ほど多めに見ておくと安全です。

モデル切替とキャッシュの関係

キャッシュはモデルごとに別なので、モデルを切り替えた最初のターンは全文を書き込むことになります。

  • 起動時から Sonnet 5.5 にしておき、難しい作業に入るときだけ一度 Opus 5.5 に切り替える
  • 切替は作業の区切り(/clear の直後など)にまとめる
  • 大量の定型処理はサブエージェントに model: haiku を指定して任せる
  • opusplan はプランモードの出入りのたびにモデルが替わるため、キャッシュが作り直されます

Fable は自動化での使い方に注意

Fable 5.1 は、プランや席種によっては利用クレジットで課金されます。claude -p(非対話)で --model fable を指定すると、確認なしで課金されます。 CI やスクリプトで Fable を使う場合は、利用クレジットの月の上限を先に設定しておきましょう。詳しくは Claude Fable 5の利用クレジット制 を参照してください。


使用量の可視化・追跡ツール

まずは公式の /usage を使います。 2026年10月時点の /usage では、API 換算コストに加えて、キャッシュのヒット率やミスの推定原因、スキル・MCP・サブエージェント別の内訳まで確認できます。

Claude Codeの使用量を集計するccusageの公式サイト画面

出典: ccusage 公式サイト

方法

わかること

向いている人

/usage(公式)

Session の API 換算コスト、Prompt cache (main) 行(キャッシュから読んだ割合・ミス回数・寿命)、5時間・週のバー、スキル・サブエージェント・プラグイン・MCP 別の内訳

すべての利用者

/context(公式)

いまのコンテキストの内訳

会話が重くなったと感じたとき

ステータスライン(公式)

prompt_cache の状態やコストを常時表示

毎日長時間使う人

--max-budget-usd(公式 CLI フラグ)

1回の実行に予算の上限を設ける

claude -p の自動化

ccusage(サードパーティ)

ローカルログから日別・週別・月別・5時間ブロック別に集計

API 換算額を月単位で追いたい人

OpenTelemetry(公式)

ユーザー別・チーム別のリアルタイム指標

組織の管理者

/usage の内訳はその端末のローカル履歴だけを対象にしています。別の PC や claude.ai での利用は含まれません。ccusage の使い方は ccusage 使い方ガイド にまとめています。

# インストールせずに実行
npx ccusage
# 5時間ブロック別に見る
npx ccusage blocks

使用量が急に増えたときの確認手順

  1. /usage の Prompt cache (main) 行を見る。キャッシュから読んだ割合が下がり、ミス回数が多ければキャッシュの作り直しが原因です。v2.1.260 以降は likely cause: tool definitions changed のように推定原因も表示されます
  2. 内訳を見る。特定のスキル・MCP サーバー・サブエージェントの割合が大きくないか確認します。長いコンテキストやキャッシュミスが10%以上の場合は警告が表示されます。/loop などの定期タスクの消費もここで確認できます
  3. /context で中身を見る。大きなファイルや長いツール出力が残っていれば、/clear か /compact で減らします
  4. 見落としやすい消費を確認する。休憩後のキャッシュ切れ、定期タスク、goal のチェックイン、他セッションからのメッセージ、Agent Teams などが原因になります

要約などのバックグラウンド処理は、通常1セッションあたり$0.04未満です。気になるほどの増加なら、ほかに原因があると考えてよいでしょう。

Bedrock / Google Cloud / Foundry 経由の場合

Anthropic のダッシュボードや Analytics API には表示されません。各クラウドの請求画面と、OpenTelemetry や LLM ゲートウェイで集計します。Anthropic が提供する Claude apps gateway(自社ホスト)を使うと、Bedrock などでもユーザー別の支出上限をかけられます。LiteLLM で集計する方法もありますが、公式は「Anthropic とは無関係で、セキュリティ監査を受けていない」と明記しています。採用するならリスク評価が必要です。


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

API 従量課金をチームで使う場合は、Claude Console の Workspace で支出上限とレート制限を決めておきます。 Console で初めて認証すると「Claude Code」Workspace が自動で作られます。この Workspace では API キーを発行できませんが、レート制限をかけて Claude Code の取り分を抑え、本番のワークロードを守ることができます。

公式推奨:チームの人数別レート制限(1人あたり)

チームの人数

TPM(トークン/分)

RPM(リクエスト/分)

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

出典: Manage costs effectively

チーム全体の月の上限に加えて、個人ごとにも上限を設けておくと、1人の使いすぎでチーム全体が止まる事態を防げます。

managed settings で組織のルールを配る

管理者は managed settings を使って、全員に同じコスト設定を配布できます。

  • availableModels: 使えるモデルを制限する(Fable を外すなど)
  • fastModePerSessionOptIn: true / fastMode: false: fast mode をセッションごとの明示的な有効化に限る、または無効にする
  • キャッシュの寿命(promptCacheTtl など)
  • modelPricing(v2.1.242〜): 契約単価に合わせて /usage・ステータスライン・OpenTelemetry の表示を揃える(請求額そのものは変わりません)
  • autoContinueAtUsageLimit: 上限に当たった後の自動再開

チームでの導入手順は Claude Code チーム導入ガイド、権限や統制の考え方は Claude Codeのセキュリティと安全な使い方 で解説しています。

Claude Code で作った社内ツールの試作を、社内の実データや既存システムにつないで業務で使う段階になると、権限管理・保守・障害対応を誰が担うかを決める必要があります。進め方は AIで作ったアプリを開発会社へ引き継ぐには で整理しています。

Agent Teams は「約7倍」のトークンを消費する

Claude Code のプレビュー機能 Agent Teams は、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効になります(既定は無効)。公式によると、プランモードの teammates では標準セッションの約7倍のトークンを消費します。使う場合は、Sonnet を使う、人数を絞る、起動時の指示を短くする、終わったらすぐ止める、の4点を守ってください。


バッチ API・Fast mode・修飾子係数まとめ

基本単価に掛かる割引・割増は、Batch API(×0.5)、米国内推論(×1.1)、fast mode(Opus 5.5 で×2)の3つです。 API 従量課金のチームは、この3つで請求額が大きく変わります。

修飾子

係数

特徴

併用・制約

Batch API

×0.5

入出力とも半額。非同期で結果を待てるジョブ向け

キャッシュの倍率とは併用可。fast mode とは併用不可

fast mode(研究プレビュー)

Opus 5.5 で×2($8 / $40)

応答を速くする。Opus 5・Opus 4.8 は$10 / $50

サブスクでは利用クレジットからのみ課金。Bedrock・Google Cloud などでは使えない

米国内推論(inference_geo: "us")

×1.1

推論を米国内に限定

Claude 4.6 以降。/usage もこの倍率を反映

キャッシュ読込

×0.1(Opus / Sonnet 5.5 は×0.05)

最大の節約要素

自動で適用される

出典: Pricing、Fast mode

以前は「fast mode は6倍($30 / $150)」と紹介されていましたが、これは Opus 4.6 / 4.7 時代の話です。Opus 4.7 の fast mode は7月24日に廃止されました。現在の Opus 5.5 では通常の2倍です。

fast mode を ON にした最初のターンはキャッシュが作り直されます。また、サブスクではプランの枠が残っていても利用クレジットから課金されます。Team / Enterprise では Owner が有効化しないと使えません。

Batch API の料金早見表

モデル

バッチ入力

バッチ出力

Opus 5.5

$2

$10

Sonnet 5.5

$1

$5

Haiku 5.5(10万トークン以下)

$0.05

$0.25

※ USD / 100万トークン

リアルタイムで返事が要らない作業(ログの分類、テストケースの生成、ドキュメントの翻訳など)は、Batch API に回すだけで費用が半分になります。


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

単価の高い Opus 5.5 を既定のまま使うと、同じ作業量でも Sonnet 5.5 の2倍かかります。 以下は API キー(5分キャッシュ)で使い、キャッシュ読込が入力の9割という前提で、2026年10月の公式単価から計算した概算です。

パターン

月のトークン量

Sonnet 5.5

Opus 5.5(既定)

おすすめ

1. 個人開発者(週10時間)

読込45M / 書込5M / 出力10M

約$117

約$234

Max 5x($100)。Opus 中心なら Max 20x も候補

2. テックリード(週30時間・2リポジトリ並行)

読込270M / 書込30M / 出力40M

約$502

約$1,004

Max 20x($200)

3. 軽い利用(週3時間・Web と併用)

読込8M / 書込2M / 出力2M

約$26

約$52

Pro($20)

※ M = 100万トークン。計算式(パターン1・Sonnet 5.5): 45M×$0.10 + 5M×$2.50 + 10M×$10 ≒ $117

パターン1:個人開発者(週10時間)

Sonnet 5.5 に切り替えても約$117で、Max 5x の$100を上回ります。Sonnet 5.5 中心なら Max 5x が最も割安で、余った API クレジット$100を自動化に回すこともできます。既定の Opus 5.5 のままだと約$234で Max 20x の$200も超えるため、Opus を日常的に使い続けるなら Max 20x も検討に入ります。

パターン2:テックリード(週30時間)

Sonnet 5.5 でも約$502、Opus 5.5 なら約$1,004です。Max 20x($200)が有力ですが、並列で長時間動かす日が多いと週の上限に当たる可能性があります。上限に当たる日だけ利用クレジットや API で補うのが現実的です。

パターン3:軽い利用(週3時間)

Sonnet 5.5 なら約$26、Opus 5.5 なら約$52です。Pro($20)で収まる可能性が高く、上限に当たるようなら Max 5x を検討します。

試算からわかること

  • 費用の8割前後は出力です。キャッシュ読込はすでに安いため、思考の量(/effort)と出力の量を抑える施策が有効です
  • モデルを Sonnet 5.5 にするだけで半額になります
  • サブスクの枠内で使う場合は会話本体が1時間キャッシュになるため、休憩後の作り直しはこの試算より少なくなります

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

API 換算で月$100を超える人は Max、使う日が少ない人やチームで細かく管理したい人は API 従量課金が向いています。

Max 5x($100)がおすすめ

  • 週10時間前後 Claude Code を使う個人開発者
  • 月額を固定して予算を読みやすくしたい人
  • claude -p や Agent SDK での小さな自動化もしていて、API クレジット$100を活かせる人
  • Pro で何度か上限に当たったことがある人

Max 20x($200)がおすすめ

  • 毎日長時間 Claude Code を使う専業の開発者
  • 複数のセッションやサブエージェントを並列で動かす日が多い人
  • Opus 5.5 や Fable を日常的に使いたい人
  • CI の自動レビューなど API 側の処理が月$100を超える人

Pro($20)がおすすめ

  • Claude Code は週に数時間で、ほかはチャット中心の人
  • まず試してみて、使用量を把握してから判断したい人

API 従量課金がおすすめ

  • チームでユーザー別の支出を見える化したい人
  • Workspace ごとにプロジェクト別の費用を分けたい人
  • Batch API で非対話のジョブを大量に流したい人
  • 使う月と使わない月の差が大きい人

Max も API もおすすめしない人

  • 24時間エージェントを並列で動かし続けたい人: どのプランでも上限に当たります。Enterprise の契約や API の専用設計が前提です
  • Bedrock / Google Cloud / Foundry 経由が必須の組織: Anthropic の /usage の内訳やダッシュボードが使えないため、各クラウドの予算機能と OpenTelemetry で管理する必要があります
  • 使用量を確認する時間が取れない人: 少なくとも /usage と /clear を習慣にしないと、費用が読めないままになります

よくある質問(FAQ)

Q1. 6月15日に予告されていた課金変更は、結局どうなりましたか?

6月15日に一時停止され、現時点では実施されていません。Agent SDK・claude -p・サードパーティアプリは、引き続きサブスクの上限から消費されます。その後、10月7日から Max と Team に毎月の API クレジットが付くようになりました。

Q2. Max の API クレジットは Claude Code に使えますか?

対話で使う Claude Code には使えません。対話はこれまでどおりプランの枠から消費されます。クレジットが使えるのは Claude API・Agent SDK・Managed Agents・Playground です。Console の API キーで動かす claude -p はクレジットから払えると読めますが、公式に明記されていないため、Console の Usage ページで確認してください。

Q3. 既定モデルを Sonnet にするにはどうすればいいですか?

settings.json に "model": "sonnet" を書くと、起動時から Sonnet になります。その場だけ切り替えるなら /model sonnet、起動時に指定するなら claude --model sonnet を使います。切り替えた直後の1ターンはキャッシュが作り直されるため、作業の区切りで切り替えましょう。

Q4. 休憩後の最初の返答が遅く、使用量も増えるのはなぜですか?

キャッシュの寿命が切れて、全文を書き込み単価で送り直しているためです。サブスクの枠内なら会話本体は1時間、API キーや利用クレジットでは5分で切れます。API キーで長い休憩をはさむことが多いなら、promptCacheTtl を 1h にすると改善します。長く離れる前に /compact しておく方法もあります。

Q5. CLAUDE.md を直したのに反映されません。

セッション中に CLAUDE.md を編集してもキャッシュは壊れませんが、内容が反映されるのは /clear・/compact・再起動の後です。キャッシュを守るための仕様なので、まとめて直してから区切りで反映させると無駄がありません。

Q6. fast mode はサブスクの枠内で使えますか?

使えません。サブスクでは、プランの枠が残っていても fast mode は利用クレジットから課金されます。Opus 5.5 の fast mode は入力$8・出力$40で、通常の2倍です。組織では managed settings で無効にしたり、セッションごとの明示的な有効化に限ったりできます。

Q7. /usage と /cost はどう違いますか?

現在の公式コストページで案内されているのは /usage です。/cost の現状は公式ページでは確認できませんでした。/usage に表示される Session のコストは API 単価で計算した参考値で、Pro / Max の請求とは関係ありません。API の正確な請求額は Claude Console の Usage ページで確認します。

Q8. キャッシュのヒット率は確認できますか?

確認できます。v2.1.251 以降の /usage には Prompt cache (main) 行があり、キャッシュから読んだ入力の割合、ミスの回数、キャッシュの寿命が表示されます。API を直接使う場合は、レスポンスの cache_creation_input_tokens と cache_read_input_tokens から計算できます。

Q9. MCP サーバーをたくさん入れると費用は増えますか?

対応モデルでは MCP のツール定義が既定で遅延読込になるため、起動時に入るのはツール名とサーバーの指示だけです。それでも、使わないサーバーは /mcp で止め、gh などの CLI で済む作業は CLI に任せたほうが軽くなります。/usage の内訳で MCP サーバー別の割合を確認できます。


まとめ:Claude Codeのコストは「モデル×キャッシュ×プラン選択」で決まる

Claude Code のコストは、モデルの選び方、キャッシュを壊さない運用、API 換算額に合ったプラン選択の3つでほぼ決まります。

  • 6月15日の課金変更は停止済み。10月7日から Max($100 / $200)と Team に毎月の API クレジットが付くが、対話の Claude Code には使えない
  • 既定は Opus 5.5。日常作業を Sonnet 5.5 にすると単価は半分になる
  • キャッシュ読込は Opus 5.5・Sonnet 5.5 で入力の1/20。費用の中心は出力に移ったため、/effort と出力量の管理が効く
  • キャッシュを壊すのは、途中のモデル切替、fast mode の ON、/compact、アップグレード直後など。CLAUDE.md の編集やプランモードは壊さない
  • サブスクの会話本体は1時間キャッシュ。API キーで1時間にしたい場合は promptCacheTtl: "1h"
  • API 換算で月$100超なら Max 5x、$200超なら Max 20x が目安
  • MAX_THINKING_TOKENS は5.5世代では効かない。思考の量は /effort で調整する
  • fast mode は Opus 5.5 で2倍。サブスクでは利用クレジットからのみ課金される
  • 使用量が増えたら /usage の Prompt cache 行と内訳から原因を探す
  • チームでは Workspace の支出上限・レート制限と managed settings で上限を決めておく

Claude Code の料金や機能は頻繁に更新されます。導入を判断する前に、公式ドキュメント(Manage costs effectively) で最新の情報を確認してください。

関連記事

このツールを自社のシステムや業務にどう組み込むか、ご提案します

この記事の著者

AI革命

AI革命

編集部

AI革命株式会社の編集部です。最新のAI技術動向から実践的な導入事例まで、企業のデジタル変革に役立つ情報をお届けしています。豊富な経験と専門知識を活かし、読者の皆様にとって価値のあるコンテンツを制作しています。

AI・システム開発は、開始価格を公開しています

既存システムの改修 100万円〜・PoC 300万円〜(税別)。相談内容を送っていただくと、2営業日以内に担当者からご返信します