CLAUDE_CODE_AUTO_COMPACT_WINDOW

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_AUTO_COMPACT_WINDOW is a Claude Code environment variable: Controls the token window threshold at which automatic context compaction kicks in. Works alongside the existing CLAUDE_AUTOCOMPACT_PCT_OVERRIDE variable but likely provides a fixed token count rather than a percentage — giving more precise control over when the conversation is summarized and trimmed. Added between v2.1.77 and v2.1.79 and still present in v2.1.294. It is listed in the official reference.

Status	Present in v2.1.294
Added	Added between v2.1.77 and v2.1.79
Category	Context and compaction
Official docs	Listed

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_AUTO_COMPACT_WINDOW=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "<value>"
  }
}

Release notes that mention it

Claude Code v2.1.75 — 2 New Environment Variables: Auto-Compact Window & Plugin Options

Related variables

DISABLE_AUTO_COMPACT: Disable automatic compaction only (manual /compact still works).
CLAUDE_AFTER_LAST_COMPACT: Request only conversation logs after last compaction.
CLAUDE_CODE_AUTO_MODE_PRIOR_ASSISTANT_CONTEXT: Feeds prior assistant turns into the decision, so the classifier can see the reasoning behind an edit.
CLAUDE_CODE_AUTO_MODE_SIBLING_CONTEXT: Includes sibling files (or sessions) when classifying.
DISABLE_CLAUDE_CODE_SM_COMPACT: Disable session memory compaction.
DISABLE_COMPACT: Disable all compaction (manual + auto).
ENABLE_CLAUDE_CODE_SM_COMPACT: Force enable session memory compaction.
CLAUDE_CODE_COLD_COMPACT

Frequently asked questions

What does CLAUDE_CODE_AUTO_COMPACT_WINDOW do?

Controls the token window threshold at which automatic context compaction kicks in. Works alongside the existing CLAUDE_AUTOCOMPACT_PCT_OVERRIDE variable but likely provides a fixed token count rather than a percentage — giving more precise control over when the conversation is summarized and trimmed.

Which Claude Code version has CLAUDE_CODE_AUTO_COMPACT_WINDOW?

Added between v2.1.77 and v2.1.79 and still present in v2.1.294.

How do I set CLAUDE_CODE_AUTO_COMPACT_WINDOW?

Export it before starting Claude Code (export CLAUDE_CODE_AUTO_COMPACT_WINDOW=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.

All variables, searchable: Claude Code environment variables.