説明： Anthropicから届く「Your prompt cache hit rate is low」は何を意味するのか。API料金、Claude Codeとの違い、キャッシュ設定、実際の節約額の確かめ方を解説。
1. 「命中率が低い」って、AIに説教されてる？
突然、Claude Consoleから届くメール。件名も本文も、何だか成績表っぽい。「Your prompt cache hit rate is low」。翻訳すると「プロンプトのキャッシュ命中率が低い」。さらに「直接のAPI支出を最大45%程度節約できる可能性」と続く。
一瞬、Claudeがこっちの質問の仕方にダメ出ししてきたのかと思う。しかし話はもっと現実的。AIの頭脳ではなく、同じ文章を毎回読み直させる料金の問題だ。エラー通知でも、45%の追加請求でもない。[1]
2. 毎回「会社の就業規則を最初から読め」はそりゃ高い
例えば業務用AIに、毎回2万文字の長い共通指示を渡しているとする。今日の質問は「この表をまとめて」、次は「このメールを分類して」。質問だけ変わるのに、共通指示は同じだ。
キャッシュを使わない場合、AIはその共通部分を毎回通常の入力として処理する。キャッシュを利用すると、一度処理した同じ先頭部分を短時間再利用できる。長い説明を何度も新人に渡して、毎回初出勤のオリエンテーションをしていたような状態から抜けられる。
ただし同じ内容が同じ順序で並んでいることが重要。共通指示の先頭に毎回違う日時や注文番号を差し込むと、再利用できる範囲が小さくなり得る。[1]
3. 「最大45%」は何の45%？
メールの45%は、その送信先に対する直接のAPI利用料金の削減余地の推定。全員の請求額を必ず45%引くキャンペーンではない。仮に月100ドルの直接API料金があり、総額が45%減れば55ドルになる、という計算例にすぎない。
2026年11月13日に確認したAnthropic公式料金では、5分キャッシュへの初回書き込みは通常入力の1.25倍、1時間キャッシュへの書き込みは2倍。一方、キャッシュからの読み取りは通常入力の0.1倍が標準で、一部モデルでは0.05倍または0.025倍だ。出力トークンの料金まで同じ割合で減るわけではない。[2]
つまり「一度書いて、何度も読む」なら強い。「一度書いて、二度と使わない」なら、キャッシュ作成の割増料金だけが目立つ。激安の回数券を買って一度しか店に行かない人と同じだ。
4. Claude Codeしか使っていないなら？
通知自体が「Claude Codeはキャッシュを自動管理するため、今回の推定対象から除外」と説明している。Claude Codeだけを使っている人が、このメールを見て慌てて設定画面を掘り始める必要は通常ない。
気にしたいのは、自作アプリ、社内ツール、独自の自動化などからClaude APIを直接呼ぶ処理。そこに長い固定指示、繰り返し使う文書、大量の共通ツール定義があるなら節約余地がある。Claudeの通常のチャット利用とAPI従量課金は分けて考えよう。
5. まず何を変える？ 3つの確認
①本当に直接APIの請求があるか。 管理画面で料金内訳を確認。通知だけで金額は分からない。
②同じ文章を繰り返しているか。 変わらない指示を前、毎回違う質問や日時を後ろへ。キャッシュを有効にするにはリクエスト最上位に "cache_control": {"type": "ephemeral"} を指定する自動方式がある。毎回違う末尾まで自動でキャッシュしてしまう場合は、共通部分の終わりに明示的な区切りを置く方式が向く。[1]
③効果は数字で確認。 APIレスポンスの cache_read_input_tokens は再利用できた量、cache_creation_input_tokens は新規書き込み量、input_tokens はそれ以外の入力だ。読み取り量が伸び、実際の総請求額が下がっているかを見る。通常5分の有効期間で足りなければ1時間設定も検討するが、書き込み単価との兼ね合いがある。[1][2]
6. 結局、これは何のメール？
AIからの「お前、記憶力ないぞ」通知ではない。「毎回同じ資料を読ませるなら、使い回せますよ」という請求最適化の案内だ。
まずAPIを使っているか確かめる。使っているなら共通部分を安定させて、読み取り・書き込み・総額を比較する。使っていなければ、その45%はそもそも自分の請求書に存在しない。AI時代の怖いところは、忘れっぽいのが人間でなく請求設計のほうだった、というオチ。
出典
- 仕様・料金の確認日：2026-11-13。メールの45%は送信元の推定であり、実測削減額ではない。
参考資料（2件）
- Anthropic公式：プロンプトキャッシング platform.claude.com
- Anthropic公式：料金 platform.claude.com
