https://hdknr.github.io/blogs/tags/%E3%83%97%E3%83%AD%E3%83%B3%E3%83%97%E3%83%88%E3%82%AD%E3%83%A3%E3%83%83%E3%82%B7%E3%83%A5/Recent content in プロンプトキャッシュ on hdknr blogHugo -- 0.157.0jaFri, 17 Apr 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/04/claude-code-%E3%81%AE%E3%83%87%E3%83%95%E3%82%A9%E3%83%AB%E3%83%88%E8%A8%AD%E5%AE%9A%E3%81%A7%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%82%92%E7%84%A1%E9%A7%84%E3%81%AB%E3%81%97%E3%81%A6%E3%81%84%E3%81%9F%E8%A9%B1/Mon, 06 Apr 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/04/claude-code-%E3%81%AE%E3%83%87%E3%83%95%E3%82%A9%E3%83%AB%E3%83%88%E8%A8%AD%E5%AE%9A%E3%81%A7%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%82%92%E7%84%A1%E9%A7%84%E3%81%AB%E3%81%97%E3%81%A6%E3%81%84%E3%81%9F%E8%A9%B1/<p>Claude Code を使っていて「なんかコストかかるな…」と思ったことはないでしょうか。以前、デフォルト設定のまま使い続けると推定 2 億 6,400 万トークンもの無駄が発生するという事例が話題になりました。</p> <p>その後 Claude Code 自体が大幅に改善されましたが、トークン消費を意識した使い方は今でも重要です。本記事では、現在のバージョン（2026年4月時点）で有効な最適化ポイントを整理します。</p> <h2 id="ツール検索の遅延ロードdeferred-tools">ツール検索の遅延ロード（Deferred Tools）</h2> <p>以前の Claude Code では、すべてのツール定義がセッション開始時にコンテキストに読み込まれ、大量のトークンを消費していました。<code>ENABLE_TOOL_SEARCH</code> を明示設定することで改善できるという報告もありました。</p> <p><strong>現在のバージョンでは、この問題はビルトインで解決されています。</strong> ツール定義は「遅延ロード（Deferred Tools）」方式に変わり、ツール名だけがコンテキストに載り、実際のスキーマは必要になった時点で初めてロードされます。<code>ENABLE_TOOL_SEARCH</code> を手動で設定する必要はありません。</p> <h2 id="プロンプトキャッシュの-5-分-ttl--今も最大の落とし穴">プロンプトキャッシュの 5 分 TTL — 今も最大の落とし穴</h2> <p>Claude のプロンプトキャッシュは <strong>5 分</strong>で期限切れになる。これは現在も変わっておらず、トークンコストに最も影響する要素だ。</p> <p>5 分休憩しただけで、会話全体が再処理され、コストが <strong>10 倍以上</strong>に跳ね上がることがある。</p> <p>つまり:</p> <ul> <li>長時間セッションの途中で離席する</li> <li>ちょっと休憩してから作業再開する</li> <li>別の作業をしてから Claude Code に戻ってくる</li> </ul> <p>といった行動がすべて、想定外のコスト増につながる。「休憩明けの最初のメッセージが一番高い」というのは、このキャッシュ再処理が原因だ。</p> <h3 id="キャッシュを意識した作業フロー">キャッシュを意識した作業フロー</h3> <ul> <li><strong>5 分以内に次の操作を行う</strong> — キャッシュが維持される</li> <li><strong>長い離席の前にセッションを終了する</strong> — 戻ってきたら <code>/resume</code> で再開した方が、コンテキストが圧縮されて効率的</li> <li><strong>タスクの区切りで <code>/compact</code> を実行する</strong> — 手動でコンテキストを圧縮し、次のキャッシュミス時のコストを下げる</li> </ul> <h2 id="コンテキスト自動圧縮を活かす">コンテキスト自動圧縮を活かす</h2> <p>Claude Code はコンテキストウィンドウの上限に近づくと、過去の会話を自動的に圧縮する。この仕組みのおかげで、長時間セッションでも会話が途切れることはない。</p> <p>ただし、圧縮時にはトークンが消費される。不要にコンテキストを膨らませないことが、結果的にコスト削減になる。</p> <h3 id="コンテキストを膨らませない工夫">コンテキストを膨らませない工夫</h3> <table> <thead> <tr> <th>やりがちなこと</th> <th>改善策</th> </tr> </thead> <tbody> <tr> <td>大きなファイルを全行読む</td> <td>必要な範囲だけ <code>offset</code> / <code>limit</code> 指定で読む</td> </tr> <tr> <td>ビルドログをそのまま流す</td> <td>エラー時だけ出力を確認する</td> </tr> <tr> <td>試行錯誤を同一セッションで続ける</td> <td>方針が変わったら新しいセッションで仕切り直す</td> </tr> <tr> <td>CLAUDE.md に大量の指示を詰め込む</td> <td>必要最小限に保つ（毎ターンのコンテキストに載る）</td> </tr> </tbody> </table> <h2 id="現在のビルトイン最適化機能">現在のビルトイン最適化機能</h2> <p>2026年4月時点で Claude Code に組み込まれている主なトークン最適化機能:</p>