アイドル時コンパクションの閾値設定
CHANGELOG 原文(英語)
Added CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS to change idle compaction's 200K-token minimum; "idleCompaction": false in settings.json turns it off. Both need v2.1.290 or later 公式の変更履歴を開く ↗ 日本語での補足
アイドル時コンパクションの最小トークン数(200K)を変更するCLAUDE_CODE_IDLE_COMPACT_MIN_TOKENSを追加。settings.jsonで"idleCompaction": falseを設定すると無効化できる。いずれもv2.1.290以降が必要。
ドキュメント
ドキュメントの抜粋(参考訳)
idleCompaction
アイドル時のコンパクト化は、席を外している間の長い会話をコンパクト化します。これにより、次のメッセージでは会話全体ではなく要約が送信されます。コンパクト化されると、会話に次の通知が表示されます。
- ターミナル:
Compacted while idle, before the prompt cache expiredで始まる行 - VS Code チャットパネル:
a summary written while you were awayを含む通知 - デスクトップアプリ: 同じ通知が、ラベルに
Claude Code noticeを含む行の中に表示されます。その行やテキストが見当たらない場合は、Verbose 表示モードに切り替えてください。
アイドル時のコンパクト化は、次の条件をすべて満たす会話に対して既定で有効です。
- セッション:対話型のターミナルセッション、VS Code 拡張機能のチャットパネル、またはデスクトップアプリの Code タブを使用していて、セッションが自分のマシン上、または SSH 経由で実行されている
- 自動コンパクト化:
autoCompactEnabledがオンになっている - プロンプトキャッシュ:会話が1 時間のプロンプトキャッシュ TTL を使用している
- サイズ:会話のコンテキストがトークンのしきい値に達している。しきい値は既定の 200,000 から変更できます
- アイドル時間:最後のリクエストから約 1 時間が経過しており、その時点までコンピューターがスリープしていない
アイドル時のコンパクト化をオフにするには、このキーを false に設定します。
- 適用範囲:
Any file - 型:真偽値
true:条件を満たすアイドル状態の会話を Claude Code がコンパクト化しますfalse:セッションがアイドル状態の間、Claude Code はコンパクト化しません
- 既定値:
true - セッション単位の上書き:
DISABLE_AUTO_COMPACTは、自動コンパクト化とあわせてアイドル時のコンパクト化もオフにします
{
"idleCompaction": false
}
ターミナルセッション内からアイドル時のコンパクト化をオン・オフするには、/config を実行して Idle compaction の行を変更します。選択内容はユーザー設定に保存され、すぐに適用されます。この行には Claude Code v2.1.302 以降が必要です。該当するバージョンを実行しているにもかかわらず /config にこの行が表示されない場合は、次の原因を確認してください。
- 別の設定ソースがこのキーを設定している:管理設定、
--settingsフラグ、またはプロジェクトやローカルの設定ファイルの値が、ユーザー設定を上書きしています。その場合は、そのソース側でキーを変更してください - フィーチャーフラグが利用できない:Claude Code が Anthropic からフィーチャーフラグを取得できない環境では、アイドル時のコンパクト化自体が実行されないため、オフにする対象がありません
このキーには Claude Code v2.1.290 以降が必要です。このキーを無視する以前のバージョンでアイドル時のコンパクト化を止めるには、autoCompactEnabled をオフにしてください。
アイドル時のコンパクト化のしきい値を変更する
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS に、アイドル時のコンパクト化の対象となるために会話のコンテキストが達する必要のあるトークン数を設定します。正の整数を指定してください。100000 未満の値は、最小のしきい値である 100000 に引き上げられます。
既定値のままでは、200K のコンテキストウィンドウの会話は 200,000 トークンに達する前に自動コンパクト化されます。次の例では、しきい値を 150,000 に下げて、そうした会話も対象になるようにしています。
{
"env": {
"CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
}
}
VS Code とデスクトップアプリでのアイドル時のコンパクト化
このような通知が表示された場合、Claude Code がこれまでの会話を要約に置き換え、Claude は今後その要約を元に動作することを意味します。
Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json
特に何かする必要はありません。アイドル時のコンパクト化をオフにするには、セッションが実行されているマシンまたは WSL ディストリビューション上の ~/.claude/settings.json、または他の設定ファイルで idleCompaction を false に設定してください。
取得日 · 2026-11-20