settings.json

autoCompactWindow

型number記述場所どの設定ファイルでも可

コンテキスト ウィンドウが満杯になる前に、Claude Code が自動的にコンパクト化(圧縮)するタイミングを設定します。

既定値: unset, so Claude Code picks a window tuned for your model

記述例

{
  "autoCompactWindow": 500000
}

使い方・用途

  • デフォルト値は未設定(モデルに最適化されたウィンドウが選択されます)
  • 200K トークン制限を強制するには、autoCompactWindow を 200000 に設定します
  • /autocompact コマンド、--autocompact フラグ、または環境変数 CLAUDE_CODE_AUTO_COMPACT_WINDOW で設定できます
英語原文(公式ドキュメントより)

Set how full the context window gets before Claude Code [compacts automatically](/docs/en/context-window#when-your-context-fills-up).

関連ドキュメント

関連する変更履歴

v2.1.296(1件)

Added
サブエージェントのフロントマターと --agents 定義に autoCompactWindow を追加し、サブエージェントがメイン会話より早いタイミングでオートコンパクトできるようにした
英語原文を表示
Added autoCompactWindow to subagent frontmatter and --agents definitions, so a subagent can auto-compact earlier than the main conversation's window

変更前

サブエージェントはオートコンパクトのタイミングをメイン会話のウィンドウ設定に依存しており、個別に調整できなかった。

変更後

サブエージェント定義のフロントマターや --agents の JSON に autoCompactWindow を指定でき、サブエージェントがメイン会話より早いタイミングでオートコンパクトするようにできる。

ユーザーへの恩恵

コンテキストを大量に消費するサブエージェントを、メイン会話に影響を与えずに早めに圧縮できるようになる。