開発中に Claude Code のキャッシュミスで大量トークン消費を踏んだ — セッション共有と fork の備忘録

Claude Codeを外部アプリから利用する際、デスクトップアプリとのセッション共有がキャッシュミスによる大量トークン消費の原因となっていたことへの対処法を解説。

• Claude Codeを外部アプリから利用する際、デスクトップアプリとのセッション共有によりキャッシュミスが発生し、意図せず大量のトークンが消費された。
• セッション共有によるキャッシュミスは、会話の切り替えや割り込み時に発生し、会話が二重化して片方の履歴が失われる問題も確認された。
• セッション共有の代わりに `--fork-session` オプションを使用することで、元のセッションに影響を与えずに新しいセッションを開始できる。
• Claude Codeのキャッシュ周りの挙動は複雑であり、自作ツールからの利用には注意が必要である。