テック技報最新号へ →
AIコーディング

Claude Code のプロンプトキャッシュ:席を立つ前に一言、途中でモデルや MCP を変えない ※モデル・料金

Claude Code は毎ターン、システムプロンプト・ツール定義・CLAUDE.md・会話履歴を丸ごと送り、前回と同じ前半をキャッシュで安く読んでいる。キャッシュには寿命があり、切れると次の1回で全体を書き直す(読み取りの12.5倍の料金)。使用量が急に溶けるときは、たいていこれが原因。

@oga_aiichiro · 投稿 2026-04-21
#claude-code#prompt-caching#料金#使用量#モデル・料金

どんな場面で使う?

  • 「少し席を外して戻ったら、1回の指示で使用量が大きく減った」とき
  • Pro プランで5時間枠がすぐ尽きるとき

仕組み(記事執筆時点 2026-04)

  • 料金倍率: 書き込み 1.25倍(5分)/2倍(1時間)、読み取り 0.1倍
  • 寿命: コミュニティの解析では Max は1時間、Pro と従量 API キーは5分(公式に明記はない実装の挙動)
  • キャッシュは使われるたびに無料で寿命が延びる

手順

  1. 離席前に軽いメッセージを1つ送る: 「次に入る前に、今どこまでやったか整理して」など。寿命がリセットされる
  2. 長く離れるなら、いったん終えて戻ってから新しいセッションで再開する方が安いこともある。--continue・--resume で再開するときは、ほぼ確実にキャッシュが切れている前提で
  3. キャッシュを壊す操作を避ける
    • セッション途中で /model を切り替えない(キャッシュはモデルごと。安いモデルに替えたつもりが全体の書き直しで高くつく)
    • CLAUDE.md に日時やランダムな値など毎回変わるものを書かない
    • セッション途中で MCP サーバーを足し引きしない(ツール定義が変わる)
  4. ヒット率を測る: /cost や /usage で内訳を見る。健全なら cache_read_input_tokens が大半で、新規の書き込みは末尾の追加分だけになる

注意点

出典

X の元の投稿を開く