Skip to main content
La finestra di contesto di Claude Code contiene tutto ciò che Claude sa della tua sessione: le tue istruzioni, i file che legge, le sue stesse risposte e i contenuti che non appaiono mai nel tuo terminale. La timeline sottostante illustra una sessione completa dall’avvio alla compattazione: cosa si carica prima che tu digiti, cosa aggiunge ogni lettura di file, regola e hook mentre Claude lavora, e come un subagent mantiene le letture di grandi dimensioni fuori dal tuo contesto. Vedi la spiegazione scritta per lo stesso contenuto come elenco.

​
Cosa mostra la timeline

La sessione illustra un flusso realistico con conteggi di token rappresentativi:
  • Prima di digitare qualcosa: CLAUDE.md, memoria automatica, nomi degli strumenti MCP e descrizioni delle skill si caricano tutti nel contesto. I file AGENTS.md possono caricarsi anche loro, da soli o insieme a CLAUDE.md. La tua configurazione personale potrebbe aggiungere altro qui, come uno stile di output o testo da --append-system-prompt.
  • Mentre Claude lavora: ogni lettura di file si aggiunge al contesto, le regole con ambito di percorso si caricano automaticamente insieme ai file corrispondenti e un hook PostToolUse si attiva dopo ogni modifica.
  • Il prompt di follow-up: un subagent gestisce la ricerca nella sua propria finestra di contesto separata, quindi le letture di file di grandi dimensioni rimangono fuori dalla tua. Solo il riepilogo e un piccolo trailer di metadati tornano indietro.
  • Alla fine della procedura dettagliata: esegui /compact, che sostituisce la conversazione con un riepilogo strutturato. La maggior parte del contenuto di avvio si ricarica automaticamente; la tabella sottostante mostra cosa accade a ogni meccanismo.

​
Cosa sopravvive alla compattazione

Quando una sessione lunga si compatta, Claude Code riassume la cronologia della conversazione per adattarsi alla finestra di contesto. A partire dalla v2.1.198, la richiesta di riepilogo eredita la configurazione del extended thinking della tua sessione, quindi ragiona con il thinking abilitato quando la tua sessione lo ha abilitato e rimane disattivato altrimenti. Il thinking influisce solo su come viene prodotto il riepilogo; le impostazioni della tua sessione rimangono invariate in seguito. Cosa accade a ogni tipo di contenuto dipende da come è stato caricato: Subito dopo la compattazione, Claude Code rilegge fino a cinque dei file che Claude ha letto o modificato nella sessione, scegliendo quelli modificati più recentemente. Un file di oltre 5.000 token ritorna come riferimento di percorso senza il suo contenuto, mostrato come Referenced file invece di Read. Le regole con ambito di percorso e i file CLAUDE.md annidati si caricano nella cronologia dei messaggi quando il loro file trigger viene letto, quindi la compattazione li riassume insieme a tutto il resto. Se una regola deve persistere attraverso la compattazione, rimuovi il frontmatter paths: o spostalo nel CLAUDE.md della radice del progetto. I corpi delle skill vengono reinizializzati dopo la compattazione, ma le skill di grandi dimensioni vengono troncate per adattarsi al limite per skill, e le skill invocate più vecchie vengono eliminate una volta superato il budget totale. Il troncamento mantiene l’inizio del file, quindi metti le istruzioni più importanti vicino alla parte superiore di SKILL.md.

​
Quando la tua finestra di contesto si riempie

Claude Code si compatta automaticamente mentre ti avvicini al limite, quindi una finestra di contesto piena non termina la tua sessione. Il passaggio automatico funziona allo stesso modo del passaggio /compact nella timeline. Vedi Quando il contesto si riempie per quello che preserva. Puoi anche agire prima che il passaggio automatico venga eseguito:
  • Compatta con un focus: esegui /compact con istruzioni, come /compact focus on the auth bug fix, prima di iniziare un nuovo compito lungo. Il riepilogo mantiene quello che scegli invece di quello che il passaggio automatico indovina sia importante.
  • Compatta parte della conversazione: esegui /rewind, seleziona un messaggio e scegli Summarize from here o Summarize up to here. Vedi Rewind and summarize per quello che ogni opzione mantiene e come guidare il riepilogo.
  • Compatta prima: esegui /autocompact con un conteggio di token, come /autocompact 500k, per impostare quanto piena la finestra di contesto diventa prima che il passaggio automatico venga eseguito. Vedi Set the auto-compact window per i valori accettati e gli override.
  • Cancella tra i compiti: esegui /clear quando passi a un lavoro non correlato. La vecchia conversazione esclude i file di cui hai bisogno dopo e costa token su ogni messaggio.
  • Delega letture di grandi dimensioni: invia la ricerca a un subagent in modo che i contenuti del file rimangono nella sua finestra di contesto, non nella tua.
Se hai bisogno di una finestra più grande piuttosto che di una conversazione più piccola, i modelli Fable, Sonnet 5 e versioni successive, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano una finestra di contesto di 1 milione di token. Vedi Extended context per la disponibilità per piano e come selezionare una variante di modello [1m]. La compattazione funziona allo stesso modo al limite più grande. Sonnet 5.5 e Sonnet 5 funzionano con la finestra di contesto 1M e non hanno alcuna variante [1m] da selezionare. Vedi Sonnet 5.5 and Sonnet 5 context window per le loro soglie di auto-compattazione e l’eccezione del gateway LLM. Il punto in cui viene eseguita la compattazione automatica dipende dal tuo modello e dalla configurazione. Vedi Default auto-compact thresholds per i confini per modello, e Correct the window for a gateway or custom model ID se Claude Code assume la finestra sbagliata per il tuo ID modello, come un alias LLM gateway.

​
Controlla la tua sessione

La visualizzazione utilizza numeri rappresentativi. Per vedere il tuo utilizzo effettivo del contesto in qualsiasi momento, esegui /context per una suddivisione in tempo reale per categoria con suggerimenti di ottimizzazione, incluso quali file CLAUDE.md e memoria automatica sono stati caricati. Esegui /memory per aprire e modificare questi file. Per una copertura più approfondita delle funzionalità mostrate nella timeline, vedi queste pagine: