Esplora la finestra di contesto

Una simulazione interattiva di come la finestra di contesto di Claude Code si riempie durante una sessione. Vedi cosa si carica automaticamente, quanto costa ogni lettura di file e quando si attivano le regole e gli hook.

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 al posto di 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 ragionamento esteso della tua sessione, quindi usa il ragionamento quando la tua sessione lo ha abilitato e lo lascia disattivato altrimenti. Il ragionamento 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 Claude legge, scrive o modifica il loro file trigger, quindi la compattazione li riassume insieme a tutto il resto. Se una regola deve persistere attraverso la compattazione, rimuovi il frontmatter paths: o spostala 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. Per sapere quando Claude Code compatta anche una conversazione che lasci inattiva, vedi compattazione per inattività.

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, Haiku 5.5, 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.

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.

Risorse correlate

Per una copertura più approfondita delle funzionalità mostrate nella timeline, vedi queste pagine:

• Estendi Claude Code: quando usare CLAUDE.md rispetto a skill rispetto a regole rispetto a hook rispetto a MCP
• Archivia istruzioni e memorie: gerarchia CLAUDE.md e memoria automatica
• Subagent: delega la ricerca a una finestra di contesto separata
• Best practice: mantieni le sessioni focalizzate e i costi bassi
• Prompt caching: quali azioni invalidano il prefisso memorizzato nella cache
• Riduci l'utilizzo dei token: strategie per mantenere basso l'utilizzo del contesto