【要約】Claude Code のキャッシュ、ツールを使ったターンだけ乗るようになった [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
開発者がClaude Codeを利用する際、プロンプトキャッシュが期待通りに機能せず、APIコストが増大する懸念があった。筆者は以前のバージョンにおいて、以下の問題に直面していた。
- ・2ターン目のキャッシュヒット率が極端に低い現象が発生。
- ・キャッシュが外れると、1ターンにつき約5万トークンの再送が発生。
- ・API利用時、1ターンあたり約$1.02の追加コストが生じる計算となる。
// Approach
筆者はClaude Codeのアップデート(v2.1.260)を受け、リリースノートの修正条件に基づいた厳密な再検証を実施した。
- ・リリースノートの「ツール結果の後に付いたコンテキスト」という限定条件を精査。
- ・
--resumeオプションを用い、同一セッションでの継続利用を前提に検証。 - ・「ツールを使う場合」と「ツールを使わない場合」の2パターンに分けてヒット率を測定。
- ・条件を揃えることで、修正がどの範囲に及んでいるかを定量的に特定した。
// Result
検証の結果、修正はツール実行を伴うワークフローに限定して適用されていることが判明した。
- ・ツールを使用するターン（ファイルの読み込み等）: キャッシュヒット率が99.7%に向上し、安定した挙動を確認。
- ・ツールを使用しないターン（単純な質問等）: ヒット率が約38.6%のままであり、修正の対象外であることが判明。
- ・開発作業のようにツールを多用する用途では恩恵を受けるが、文章相談等の用途ではコスト削減効果が得られない。
Senior Engineer Insight
> キャッシュの挙動はワークフローに強く依存する。ツール実行を伴うエージェント的な利用ではコスト効率が高いが、単純なチャット利用では依然として高コストだ。リリースノートの「条件」を精査せず、一律に「修正された」と判断するのは危険である。実運用への導入に際しては、自社のプロンプト構成に基づいたベンチマークが不可欠だ。