Idle compaction（アイドル時の自動圧縮）— Claude Code で放置した長い会話を圧縮

ターミナルでは、20万トークン以上の会話が約54分間放置されると、1時間のプロンプトキャッシュが切れる前に圧縮されます。このため、次のメッセージで会話全体を再処理せずに済みます。長いセッションを中断し、時間をおいて再開する場面に関わる機能です。

Idle compaction は、放置された長い会話を自動で圧縮・要約しておく機能です。

ターミナルでは、20万トークン以上の会話が約54分間放置されると、1時間のプロンプトキャッシュが切れる前に圧縮され、次のメッセージで全体を再処理せずに済みます。

VS Code と Claude デスクトップアプリの Code タブでは、放置された20万トークン以上の会話が要約され、プロンプトキャッシュが切れていた場合に、次のメッセージでその要約が使われます。

動作は次の設定で変更できます。

• 圧縮の閾値: 環境変数 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS で、最小20万トークンの閾値を変更できます。
• 無効化: settings.json に次のように指定すると無効になります。

"idleCompaction": false

• 切り替え: /config に Idle compaction の項目があり、オフにしたり、再びオンにしたりできます。

閾値の変更と settings.json による無効化は、いずれも v2.1.290 以降が必要です。また、圧縮が行われた後に表示される通知には、無効にする方法が示されます。

• テレメトリーをオフにしているサブスクライバーでも動作します。
• Bedrock・Vertex・Foundry および LLM ゲートウェイ経由で使う場合は、1時間のプロンプトキャッシュが有効になっていることが動作の条件です。
• 閾値の変更と無効化の設定には v2.1.290 以降が必要です。

対象となるプランについては、公式のリリースノートには記載がありません。