Claude Code のプロンプトキャッシュ:席を立つ前に一言、途中でモデルや MCP を変えない ※モデル・料金
Claude Code は毎ターン、システムプロンプト・ツール定義・CLAUDE.md・会話履歴を丸ごと送り、前回と同じ前半をキャッシュで安く読んでいる。キャッシュには寿命があり、切れると次の1回で全体を書き直す(読み取りの12.5倍の料金)。使用量が急に溶けるときは、たいていこれが原因。
どんな場面で使う?
- 「少し席を外して戻ったら、1回の指示で使用量が大きく減った」とき
- Pro プランで5時間枠がすぐ尽きるとき
仕組み(記事執筆時点 2026-04)
- 料金倍率: 書き込み 1.25倍(5分)/2倍(1時間)、読み取り 0.1倍
- 寿命: コミュニティの解析では Max は1時間、Pro と従量 API キーは5分(公式に明記はない実装の挙動)
- キャッシュは使われるたびに無料で寿命が延びる
手順
- 離席前に軽いメッセージを1つ送る: 「次に入る前に、今どこまでやったか整理して」など。寿命がリセットされる
- 長く離れるなら、いったん終えて戻ってから新しいセッションで再開する方が安いこともある。
--continue・--resumeで再開するときは、ほぼ確実にキャッシュが切れている前提で - キャッシュを壊す操作を避ける
- セッション途中で
/modelを切り替えない(キャッシュはモデルごと。安いモデルに替えたつもりが全体の書き直しで高くつく) CLAUDE.mdに日時やランダムな値など毎回変わるものを書かない- セッション途中で MCP サーバーを足し引きしない(ツール定義が変わる)
- セッション途中で
- ヒット率を測る:
/costや/usageで内訳を見る。健全ならcache_read_input_tokensが大半で、新規の書き込みは末尾の追加分だけになる
注意点
- 寿命や扱いは変わりうる。2026-10 時点の Claude Code 2.1.304 では、Pro・Max で放置した会話を再開すると5時間枠を大きく使う場合に警告が出て、新しい会話で前の会話を参照させる選択肢も選べる(AIコーディング ツール・モデル動向(2026-10-19〜2026-10-20))
- 軽い作業を安いモデルに回したいなら、
/modelではなくサブエージェント(Explore など)に任せる - 関連: OpenAI API: 1日中使う指示は12時間キャッシュ、会話は30分キャッシュに分ける ※モデル・料金、Claude API: キャッシュ診断で「どこが変わってキャッシュが外れたか」を特定する、ガイド: モデルと料金プランの選び方(AIコーディング)
出典
- いいね: @oga_aiichiro · 2026-04-21
- Zenn「Claude Codeユーザーのためのプロンプトキャッシュ入門」: zenn.dev