Claude のモードを使えば、キャッシュ率をリアルタイムで確認できます。

Claude Code を使っていると、「以前より速度が落ちたのはなぜか」「使用量の減りが予想より早いのはなぜか」といった疑問が生じることがよくあります。こうした現象の主な原因はプロンプトキャッシュにありますが、その情報が標準のインターフェースで直感的に確認できないという制約がありました。これを改善するため、ステータスラインにキャッシュ情報を直接表示する機能を実装しました。

キャッシュってなんだろう？

Claude Codeは、メッセージを送信するたびに会話の履歴全体をモデルへ再送信します。このときキャッシュを活用すると、以前に処理済みの部分が省略されるため、応答速度が上がり、利用制限の負担も軽くなります。

ただし、キャッシュには有効期間があり、期限が切れた後の最初のメッセージ送信では、会話の内容全体を再び処理する必要があります。会話が長くなるほど関連コストは増えますが、通常は残りの有効時間を確認できないという制約があります。

どのように適用するのでしょうか？

自分でコードを書く必要はありません。Claude Codeに以下のように依頼すれば大丈夫です。

내 Claude Code 상태줄에 캐시 세그먼트를 추가해 줘.
이미 상태줄이 있으면 바꾸지 말고 아래 줄에 덧붙여 줘.
입력의 prompt_cache에서 warm, ttl, expires_at, hit_ratio, misses, last_miss_cause, recache_tokens_if_cold를 읽어 줘. 값이 없으면 표시하지 마.
캐시가 살아 있으면 녹색으로 cache ● 1h ████░░ 38m left · hit 91% · misses 0처럼 보여 주고, 남은 시간이 20% 미만이면 노란색으로 바꿔 줘.
만료됐으면 빨간색으로 cache ○ cold · next message re-caches 82k tokens처럼 보여 줘. 원인이 있으면 끝에 붙여 줘.
카운트다운이 움직이도록 statusLine 설정에 refreshInterval을 넣어 줘.
첫 줄에는 모델 이름, 추론 강도, 컨텍스트 토큰 수도 보여 줘.
끝나면 warm, 만료 직전, cold 샘플로 실행해서 결과를 보여 줘.

prompt_cacheの情報を確認するには、Claude Code 2.1.251以上のバージョンが必要です。バージョンの確認は claude --version コマンドで行えます。