Finestra di contesto di Claude Code piena? Compatta, svuota o ricomincia

Quando la finestra di contesto di Claude Code è quasi piena, l’agente interviene da solo: prima elimina l’output degli strumenti più vecchio, poi, se serve, riassume la conversazione. Le istruzioni iniziali possono andare perse, quindi conviene scegliere prima tu. Se stai ancora lavorando allo stesso compito, esegui /compact con una nota su cosa conservare. Se passi a un lavoro diverso, esegui /clear. Se l’agente continua a dimenticare le decisioni, scrivi un breve passaggio di consegne e avvia una nuova sessione a partire da quello.

Altri agenti di programmazione possono usare comandi diversi, ma le scelte sono le stesse. Mono può mostrare quanto è pieno il contesto quando l’agente lo comunica, ma è l’agente a compattare e a svuotare il contesto.

1. Scopri cosa riempie la finestra di contesto

Il contesto contiene tutto ciò su cui lavora l’agente: i tuoi messaggi e le sue risposte, i file che ha letto, l’output di comandi e test, gli elenchi di strumenti dei server MCP collegati e i file di istruzioni caricati all’inizio. Un solo log di test lungo può pesare più di tutto quello che hai scritto.

Segnali che si sta riempiendo:

• L’agente infrange una regola che gli avevi dato in precedenza.
• Fa una domanda a cui hai già risposto.
• Un avviso dice che il contesto sta per esaurirsi.

In Claude Code, /context mostra cosa occupa spazio. La panoramica su come funziona Claude Code spiega cosa succede vicino al limite.

Un esempio inventato: dopo due ore passate a spostare 30 file di «tidy-recipes» da un vecchio helper per le date, oldDate(), al nuovo formatDate(), l’agente chiede di nuovo quale libreria usare. /context mostra la finestra quasi piena.

2. Scegli tra compattare, svuotare e una nuova sessione

Compattare sostituisce la conversazione con un riassunto nella stessa sessione. Svuotare o avviare una nuova sessione elimina la conversazione, ma i file di istruzioni vengono caricati di nuovo. Ogni scelta fa perdere qualcosa:

La nota indica al riassunto cosa conservare: /compact Focus on date decisions and failing tests. La guida di Claude Code alla gestione dei costi mostra questo esempio e suggerisce /rename prima di /clear, così puoi riaprire la sessione con /resume.

Nell’esempio l’agente ha già dimenticato una decisione, quindi scrivi un passaggio di consegne.

3. Scrivi un passaggio di consegne prima di ripartire

Un passaggio di consegne è una breve nota per la nuova sessione. Scrivila tu o correggi la bozza dell’agente:

Goal: Replace oldDate() with formatDate() in recipes/ (30 files).
Done: 18 files, on branch tidy-dates.
Decisions: formatDate() uses Intl.DateTimeFormat, so no new library.
  Keep oldDate() for importing v1 files, which use the old format.
Open problem: The recipes/print.ts test has failed since the change.
Next step: Fix print.ts, then move the remaining 12 files.

Indica il motivo di ogni decisione, altrimenti la sessione successiva potrebbe annullarla. Salva la nota nel progetto o tra i tuoi appunti, ed esporta la conversazione nel caso ti servano i dettagli.

Poi esegui /clear o avvia una nuova sessione nello stesso progetto e incolla solo il passaggio di consegne, non la trascrizione.

4. Sposta le regole permanenti fuori dalla chat

Alcune correzioni valgono oltre il singolo compito. Se continui a ripetere «usa l’helper per le date del progetto» o «esegui i test con lo script del progetto», metti la regola nel file di istruzioni del progetto, come AGENTS.md o il CLAUDE.md di Claude Code. Le nuove sessioni leggono quel file, quindi un reset non la fa perdere.

Tieni il file breve, perché viene caricato in ogni sessione. La guida ai costi suggerisce di tenere CLAUDE.md sotto le 200 righe. I progressi come «18 file su 30» restano nel passaggio di consegne. La guida ad AGENTS.md spiega cosa includere.

Anche la regola sui file v1 dell’esempio va lì: vale finché esistono file v1.

5. Riduci quello che ogni turno aggiunge

Un contesto più piccolo dura di più. Prima di ogni richiesta:

• Indica il file e la funzione, non «sistema le date».
• Incolla le righe di errore pertinenti, non tutto il log.
• Esegui solo i test che ti servono e mostra solo quelli falliti.
• Scollega i server MCP che il progetto non usa.
• Affida le ricerche ampie a un subagente, se l’agente lo supporta.
• Tieni un compito per sessione.

La guida ai costi tratta la maggior parte di questi punti, compreso un hook che filtra l’output dei test.

6. Controlla l’agente dopo un reset

Prima che la nuova sessione modifichi qualcosa, chiedile di riformulare obiettivo, decisioni e prossimo passo, e confronta la risposta con il passaggio di consegne. Nell’esempio dovrebbe citare la regola sui file v1 senza che tu gliela ricordi. Se manca qualcosa, correggi subito la risposta. Poi esamina il suo primo diff, la correzione di print.ts, prima che vada avanti. La guida alla revisione del codice contiene una checklist.

In Mono, quando l’agente comunica l’utilizzo, un piccolo anello sopra la casella del messaggio mostra il contesto usato. Passa dal verde all’arancione a metà e al rosso all’80 per cento, e se lo premi vedi «Contesto: usato / totale». Digitando «/» compaiono i comandi slash offerti dall’agente. Secondo l’Agent Client Protocol, l’agente non è obbligato a dichiararli. Per ripartire da zero, salva la vecchia conversazione con Esporta conversazione, poi scegli Nuova sessione nella scheda del progetto (anche dal telefono, quando il computer è collegato). Mono non è ancora disponibile, ma puoi iscriverti alla lista d’attesa.