{"version":"2.1.290","anchor":"idle-compaction-gets-a-user-setting-and-a-min-token-env-over","canonical_anchor":"idle-compaction-gets-a-user-setting-and-a-min-token-env-over","heading":"Idle compaction gets an idleCompaction off switch and a minimum-token override","tier":"use","area":"Compaction","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.290\/e\/idle-compaction-gets-a-user-setting-and-a-min-token-env-over","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.290","markdown":"### Idle compaction gets an idleCompaction off switch and a minimum-token override\n\nNew idleCompaction setting can stop idle compaction, and CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS overrides its minimum token threshold\n\n**What**\n\nCompaction is when Claude Code summarises a long conversation to make room. Idle compaction does this while the session (your open conversation with Claude Code) is sitting idle. There are two new controls:\n\n- `idleCompaction` is a new setting. Set it to false to stop Claude Code compacting a long conversation while the session is idle. It defaults to true. Setting it to true does not turn idle compaction on. When it is false, the eligibility check stops early with `idle_compaction_off`.\n\n- `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` is a new environment variable (a setting passed to Claude Code from your shell). It replaces the `minTokens` value from the `tengu_sunny_locket` remote config, cannot go below a minimum, and is listed among the compaction-related environment variables.\n\nWhether idle compaction runs at all still comes only from `tengu_sunny_locket`. Its mode must be \"log\" or \"compact\", and without a value from the server the mode is \"off\".\n\n**Why**\n\nYou can now refuse background compaction of an idle conversation, or change how large a conversation must be before idle compaction is considered. Neither control can turn idle compaction on where the server has not enabled it.\n\n- Flag `tengu_sunny_locket`: Not enough to say (read for one account on one subscription tier against v2.1.290; this account: no value returned, anonymous baseline: no value returned, compiled default: not a boolean we can read) These values were read against a different version of Claude Code, so treat them as the nearest reading available instead of one taken on this release.\n- Area: Compaction\n- Tier: Use it now\n- Useful: 5\/5\n- Signal: 4\/5\n- Scope: individual\n- Heads-up: no"}