この記事は、Claude-codeにおけるプロンプトキャッシュの不具合について、その原因と回避策を解説しています。

現在のClaude-codeでは、クエリは3つのキャッシュ可能なブロック（{tools | claude-version}、{system-prompt | ~/.claude/claude.md | git-status}、{skills | ./claude.md | user-prompt}）で構成されています。
しかし、`git-status`がキャッシュを無効にしてしまうため、最初の質問だけでなく、その後のフォローアップ質問でもキャッシュがヒットしないという問題が発生していました。

この問題を解決するための回避策として、環境変数 `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1` を設定してClaude-codeを起動する方法が提案されています。これにより、`git-status`によるキャッシュの無効化を防ぎ、キャッシュの読み書き効率を改善できます。

また、設定ファイル `settings.json` で `includeGitInstructions=false` を設定することも、より根本的な解決策として推奨されています。これは、`git-status`の情報が通常はノイズにしかならないためです。

記事では、この回避策を適用する前と後でのキャッシュの読み書きトークン数の変化を具体的に示し、回避策の効果を実証しています。

なお、この回避策は、キャッシュTTL（有効期限）に関する以前の議論（5分 vs 1時間）とは直接関係なく、それらの議論の前提となる根本的なキャッシュ問題の修正を目的としています。