Context window

Capire il limite più importante di Claude — e come gestirlo

⏱ Stima ~5 min

01 · Leggi

La context window di Claude è come un tavolo. Tutto ciò a cui Claude sta pensando deve stare su quel tavolo — la tua conversazione, il contenuto dei file che ha letto, l'output dei comandi, CLAUDE.md, le skill caricate, le descrizioni degli strumenti MCP, le istruzioni di sistema.

Quando il tavolo è pieno, Claude deve togliere le cose vecchie per fare spazio a quelle nuove. Quando succede, Claude potrebbe dimenticare istruzioni che hai dato prima, o perdere traccia di quali file ha letto.

Questo è il concetto più importante per usare Claude Code in modo efficace.

💡 Immagina cosìImmagina di lavorare con un collega super brillante che ha un tavolo che può contenere solo 50 pagine. Ogni volta che gli dai un nuovo documento, uno vecchio cade. Se continui a dargli nuovi file, alla fine le istruzioni originali scivolano fuori dal tavolo. Capire questo limite è la chiave per sessioni produttive.

Punti chiave

La context window contiene tutto ciò a cui Claude sta "pensando"
Include conversazione, file, output comandi, CLAUDE.md, skill, strumenti MCP
Quando è piena, i contenuti vecchi vengono rimossi automaticamente
Per questo CLAUDE.md è importante — viene ricaricato sempre, anche dopo la compressione

02 · Leggi

Non tutto usa la stessa quantità di contesto. Leggere un file grande versa l'intero contenuto nella finestra. L'output lungo dei comandi consuma token. Ogni descrizione di strumenti MCP occupa spazio (ed è per questo che esiste Tool Search).

Una guida approssimativa — CLAUDE.md usa 2-5k token a seconda delle dimensioni. Ogni file letto usa token proporzionali alla dimensione del file. L'output dei comandi (come risultati di test o errori di build) può essere inaspettatamente grande. Le Skill vengono caricate on demand, consumano token solo quando attivate. Gli strumenti MCP consumano token per le loro descrizioni.

L'intuizione chiave — tieni il contesto iniziale snello, lascia che Claude carichi ciò di cui ha bisogno.

Punti chiave

CLAUDE.md: 2-5k token (rimani sotto le 200 righe)
File letti: proporzionali alla dimensione del file
Output comandi: possono essere molto grandi (test suite, build log)
Skill: on demand — zero costo finché non attivate
Strumenti MCP: le descrizioni consumano token (Tool Search aiuta)

03 · Esempio di codice

Claude Code ti dà strumenti per monitorare l'uso del contesto e liberare spazio quando serve.

Vedi l'uso del contesto

/context

Comprimi con un'istruzione focus

/compact Focus on the API changes and test failures

Azzera tra task non correlati

/clear

Usa /context per vedere quanto è piena la finestra. Quando è stretta, /compact riassume la conversazione mantenendo l'essenziale — aggiungi un'istruzione focus per dire a Claude cosa tenere. Usa /clear per un reset completo tra task completamente non correlati (ma CLAUDE.md viene ricaricato automaticamente).

04 · Leggi

Quando il contesto è troppo pieno, Claude Code comprime automaticamente. Riassume la conversazione, conservando il lavoro recente e le decisioni chiave, condensando gli scambi più vecchi.

Dopo la compressione — automatica o manuale — Claude rilegge CLAUDE.md dal disco. Significa che ciò che è in CLAUDE.md sopravvive alla compressione. Ciò che è solo nella storia della conversazione potrebbe non farcela.

Questo è il motivo fondamentale per mettere le regole importanti in CLAUDE.md invece di dirle solo in chat.

Punti chiave

Claude comprime automaticamente quando si avvicina al limite
La compressione riassume le conversazioni vecchie, conservando il lavoro recente
CLAUDE.md viene sempre riletto dopo la compressione
Le regole in CLAUDE.md sopravvivono; le istruzioni verbali potrebbero non farcela
Usa /compact in modo proattivo prima che scatti la compressione automatica

05 · Quiz

All'inizio di una lunga session dici a Claude "usa sempre Bun, non npm". Dopo una compressione automatica, Claude inizia a usare npm. Perché?

Claude ignora intenzionalmente le tue istruzioni
Bun non è compatibile con Claude Code
Devi riavviare Claude Code perché le istruzioni abbiano effetto
Le istruzioni verbali vengono perse durante la compressione — mettile in CLAUDE.md

06 · Trascina per ordinare

Pensa a come ogni tipo di contenuto influisce sulla context window. Ordina dal più efficiente al meno efficiente.

(Questa sezione è interattiva — attiva JavaScript per usarla.)

Altre lezioni di questo capitolo

⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.

※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.