autoCompactWindow

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

Claude Code が自動的にコンパクションを実行する前に、コンテキストウィンドウがどの程度まで満たされるかを設定する。

既定値未設定であるため、Claude Code がモデルに合わせて調整されたウィンドウを選ぶ。

記述例

{
  "autoCompactWindow": 500000
}

使い方・用途

  • 長いログファイルを読み込むサブエージェントがメイン会話より早く自動コンパクトするようにしたいときに使う。
  • サブエージェントごとに自動コンパクトのタイミングを調整し、コンテキストウィンドウが埋まる前にコンパクトさせたいときに使う。
英語原文

Set how full the context window gets before Claude Code compacts automatically.

関連ドキュメント

関連する変更履歴

v2.1.312(1件)

サブエージェントの autoCompactWindow が CLAUDE_CODE_AUTO_COMPACT_WINDOW で設定されたウィンドウを下回る値を持つように変更した。以前は効果がなかった。なお、そのウィンドウを引き上げることは決してない
英語原文を表示
Changed a subagent's autoCompactWindow to lower the window set by CLAUDE_CODE_AUTO_COMPACT_WINDOW, where it had no effect before; it still never raises that window

変更後

サブエージェント単位で設定した autoCompactWindow が CLAUDE_CODE_AUTO_COMPACT_WINDOW より優先されないまま無視される問題が解消され、環境変数が設定されていてもサブエージェントごとに小さい圧縮タイミングを指定できるようになる

関連ドキュメント

v2.1.296(1件)

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

変更後

サブエージェントごとにオートコンパクトのタイミングを個別に制御できるようになり、メイン会話より早くコンテキストを圧縮できる。これにより、大きなコンテキストを消費するタスクをサブエージェントに任せる際、コンテキスト上限に達して途中で失敗するのを避けやすくなる。

関連ドキュメント