掲載済み (2026-09-05号)
159 158文字 • 1分

Claude Codeでモデルを切り替えると、そのターンだけ書き直しが287倍になる挙動の検証

日本語

掲載情報

概要

Claude Code 2.1.251で可視化されたプロンプトキャッシュ機能を使い、モデル切り替えやTTL設定変更がトークン消費コストに与える影響を実測データで詳細に解説しています。

詳細内容

Claude Codeのアップデート(v2.1.251)により、`/usage`コマンドでプロンプトキャッシュの統計(ヒット率や書き直し数)が確認可能になりました。この記事では、同一セッション内でモデルを切り替えた際の挙動を検証しており、切り替え直後のターンではキャッシュの再構築が必要になるため、書き直しトークンが約287倍に急増することを実証しています。一方で、元のモデルに戻す際はキャッシュが有効なため低コストで済むことや、環境変数(FORCE_PROMPT_CACHING_5M)でTTLを変更するとキャッシュが別バケットとして扱われる仕様も明らかにされています。また、`claude -p`による単発実行に比べ、セッションを継続(`--resume`)することで書き直しトークンを約400分の1にまで削減できる効率性が示されており、開発者がLLMコストを最適化するための具体的な指針を提供しています。