Spegnere l’auto-compaction in Claude Code

Controlla la versione

Serve la 2.1.311 o una successiva. Apri il terminale e lancia:

claude --version

Se il numero è più basso, aggiorna prima Claude Code.

Apri il file delle impostazioni

Le impostazioni di Claude Code stanno in ~/.claude/settings.json. Aprilo con l’editor che preferisci; se non esiste, crealo.

Aggiungi le due chiavi

{
  "autoCompactEnabled": false,
  "idleCompaction": false
}

Con "autoCompactEnabled": false Claude Code non compatta più da solo quando il contesto supera la soglia. Con "idleCompaction": false non compatta nemmeno una sessione lunga lasciata ferma, cosa che altrimenti può fare poco prima che scada la cache da un’ora.

Se il file ha già altre impostazioni, aggiungi solo queste due righe dentro le graffe, separate dalle altre da una virgola.

Compatta tu, quando serve

Senza auto-compaction, a finestra piena la sessione si ferma, quindi la compaction la lanci tu, a fine task. Con /compact puoi anche indicargli su cosa concentrarsi:

/compact concentrati sul bug di autenticazione

Se preferisci tenere l’auto-compaction accesa e lavori con la finestra da 1 milione di token, abbassa la soglia con /autocompact: di default sta a circa 967.000 token, e l’analisi di LangWatch (873 compaction di un solo sviluppatore) indica una soglia tra 250.000 e 450.000 token.

/autocompact 450k

Io, a fine task, aggiorno il mio HANDOFF.md e chiudo la sessione con un /clear.