Come evitare che la finestra di contesto del tuo agente di coding IA si riempia

Ogni agente di coding IA lavora all'interno di una finestra di contesto — la quantità finita di testo che può "vedere" in una sola volta: i tuoi messaggi, le sue risposte, i file che legge, l'output dei comandi che esegue. Quando quella finestra si riempie, la qualità cala in modi che sembrano misteriosi. L'agente dimentica una decisione che hai preso venti minuti prima, rilegge un file che ha già modificato, oppure si contraddice silenziosamente. Su qualsiasi attività più lunga di pochi minuti, gestire il contesto è la singola leva più importante che hai sulla qualità dell'output. Ecco come farlo in modo consapevole.

Perché una finestra piena fa male

I modelli non degradano in modo controllato quando la finestra si affolla. Succedono due cose. Primo, i messaggi più vecchi vengono spinti verso i bordi, dove il modello li considera in modo meno affidabile — il classico problema del "perso nel mezzo". Secondo, la maggior parte degli agenti riassume automaticamente quando lo spazio scarseggia, e un riassunto automatico prodotto sotto pressione perde informazioni: potrebbe scartare proprio il vincolo che ti stava a cuore. La soluzione è mantenere il controllo su ciò che l'agente sta tenendo in memoria, invece di lasciarlo riempire e improvvisare.

Tieni d'occhio quanto è piena la finestra

Non puoi gestire ciò che non puoi vedere. In Claude Code, esegui /context per stampare l'utilizzo attuale in percentuale. Una buona regola pratica seguita dagli esperti è intervenire intorno al 60% di utilizzo in un'attività complessa — ben prima della soglia dell'~80% a cui scatta la compattazione automatica. Cursor e Codex mostrano un indicatore simile nelle loro interfacce. Dare un'occhiata a quel numero di tanto in tanto trasforma la gestione del contesto da vaga preoccupazione in un segnale concreto.

Compatta ai checkpoint — non limitarti a proseguire

Quando raggiungi un checkpoint naturale (una funzionalità funziona, i test passano, un bug è risolto), comprimi la cronologia invece di lasciarla crescere. In Claude Code, /compact sostituisce l'intera trascrizione con un riassunto generato dal modello — una conversazione da 70.000 token può scendere a circa 4.000 token. Aspetto cruciale: puoi guidare ciò che sopravvive:

/compact "Keep the API contract and the DB schema we agreed on. Summarize the debugging session — I only need the root cause, not every step."

Compattare in modo proattivo, mentre c'è ancora margine, produce un riassunto migliore di uno automatico attivato all'ultimo secondo, perché il modello ha ancora un ricordo chiaro dell'intera conversazione quando scrive il riassunto.

Azzera quando cambi attività

/compact serve per proseguire lo stesso filone di lavoro. /clear serve per abbandonarlo. Quando passi a qualcosa di non correlato — finisci una correzione sul backend e passi a una funzionalità frontend — riparti da zero. Trascinare avanti il vecchio contesto non aiuta; spreca soltanto token e rischia di far agganciare l'agente per analogia all'attività precedente. Azzerare è anche la cura quando il contesto è "avvelenato": il modello si è aggrappato a un'ipotesi sbagliata e continua a tornarci sopra per quanto tu lo corregga.

Metti le conoscenze stabili in un file, non nella chat

Se ti ritrovi a rispiegare le stesse cose — il tuo comando di test, le tue convenzioni di denominazione, in quale directory risiede l'API — quelle informazioni non dovrebbero affatto stare nella conversazione. Mettile in un file di progetto che l'agente legge automaticamente: CLAUDE.md per Claude Code, AGENTS.md per Codex e altri, .cursorrules per Cursor. Viene caricato all'inizio di ogni sessione, così l'agente lo ha fin dal primo messaggio, e sopravvive a ogni /clear e /compact. Tienilo però snello: costa token a ogni singola richiesta, quindi un CLAUDE.md gonfio è a sua volta una forma di spreco di contesto.

Dai all'agente meno, non di più

L'istinto di scaricare dieci file "così ha tutto" si ritorce contro. Ogni file che incolli o menzioni con @ consuma budget e diluisce l'attenzione del modello. Un solo file ben scelto è di solito meglio di dieci. Parti dal minimo e aggiungi contesto solo quando l'agente ne ha effettivamente bisogno. Se non sei sicuro di quale file conti, chiedi prima all'agente di trovarlo, invece di precaricare l'intera directory.

Delega l'esplorazione disordinata a un subagente

Alcune attività sono intrinsecamente prolisse — "cerca nel codebase ogni punto in cui chiamiamo l'API dei pagamenti". Se la esegui nella tua sessione principale, l'output grezzo della ricerca inonda la tua finestra. Delegala invece a un subagente (lo strumento Task di Claude Code, o un agente Cursor separato). Il subagente svolge l'esplorazione rumorosa nella propria finestra isolata e restituisce solo la conclusione — i tre file che contano — mantenendo pulito il tuo contesto principale.

Un ritmo di lavoro efficace

Messo tutto insieme, una sana sessione lunga si presenta così:

1. Inizia con un CLAUDE.md conciso, così l'agente conosce il tuo progetto.
2. Definisci l'ambito di ciascuna attività in modo ristretto; fai riferimento solo ai file che tocca.
3. Dai un'occhiata a /context ogni 30–45 minuti o dopo ogni traguardo.
4. /compact con un'istruzione personalizzata a ogni checkpoint.
5. /clear nell'istante in cui passi a un lavoro non correlato.

Nulla di tutto questo è esotico. È la differenza tra un agente che resta lucido lungo una sessione di due ore e uno che parte forte e via via perde il filo — e ti costa qualche secondo di attenzione anziché un misterioso pomeriggio a fare debug della sua confusione.