Vai al contenuto principale
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. La tua configurazione personale potrebbe aggiungere altro qui, come uno stile di output o testo da --append-system-prompt, che entrambi vanno nel prompt di sistema allo stesso modo.
  • 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: /compact 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. Cosa accade alle tue istruzioni dipende da come sono state caricate:
MeccanismoDopo la compattazione
Prompt di sistema e stile di outputInvariato; non fa parte della cronologia dei messaggi
CLAUDE.md nella radice del progetto e regole senza ambitoReinizializzato dal disco
Memoria automaticaReinizializzato dal disco
Regole con frontmatter paths:Perse fino a quando un file corrispondente non viene letto di nuovo
CLAUDE.md annidato nelle sottodirectoryPerso fino a quando un file in quella sottodirectory non viene letto di nuovo
Corpi di skill invocatiReinizializzati, limitati a 5.000 token per skill e 25.000 token totali; i più vecchi vengono eliminati per primi
HookNon applicabile; gli hook vengono eseguiti come codice, non come contesto
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. Si ricaricano la prossima volta che Claude legge un file corrispondente. 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.
  • 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, Fable 5, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano una finestra di contesto di 1 milione di token. Vedi Contesto esteso per la disponibilità per piano e come selezionare una variante di modello [1m]. La compattazione funziona allo stesso modo al limite più grande.

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. Esegui /memory per verificare quali file CLAUDE.md e memoria automatica si sono caricati all’avvio. Per una copertura più approfondita delle funzionalità mostrate nella timeline, vedi queste pagine: