La conversazione va avanti da un po'. Lei ha già scartato una soluzione e ne ha spiegato il motivo, ma una decina di messaggi dopo l'agente propone proprio quella. La prima tentazione è comprensibile: cancellare tutto e ricominciare.
La ripetizione di una soluzione scartata è un segnale evidente, ma non ancora una diagnosi. Da una sola risposta non si può concludere che la causa sia la conversazione accumulata: lo stesso può succedere se le istruzioni si contraddicono o se l'agente sta guardando una versione del file vecchia di mezz'ora.
Vediamo tre comandi che agiscono sulla conversazione stessa: /context mostra cosa occupa la finestra di contesto, /compact riduce la cronologia a un riepilogo, /clear avvia una nuova conversazione. Più interessante della loro sintassi è scegliere quale usare: cosa salvare prima, cosa verificare dopo e come capire se il problema non dipende affatto dalla lunghezza della conversazione.
Individui prima il problema
Prima di comprimere o azzerare qualcosa, distingua quattro situazioni. Da fuori sembrano simili: in tutti e quattro i casi l'agente "non ascolta", ma servono interventi diversi.
- Mancano informazioni di partenza. Nessuno ha indicato la regola per assegnare la ricompensa e non è presente nemmeno nei file letti. Ridurre la conversazione non inventerà ciò che non c'era: dovrà fornire l'informazione mancante.
- Informazioni non aggiornate. Nella conversazione c'è il contenuto di un file letto mezz'ora fa, ma sul disco il file è già cambiato. Serve rileggerlo, non comprimere la conversazione.
- Istruzioni contraddittorie. In chat è stato detto qualcosa, ma il documento dei requisiti salvato dice altro. Decida Lei quale requisito è valido e corregga la fonte. Un file non ha automaticamente ragione solo perché è un file.
- Rumore accumulato. Molte alternative scartate, output lunghi dei comandi e discussioni su file non pertinenti all'attività. È qui che intervenire sul contesto ha davvero senso.
Il livello di riempimento della finestra non è un quinto punto dell'elenco né la spiegazione di ogni errore. Una percentuale alta non dimostra da sola che l'agente abbia sbagliato per quel motivo; una percentuale bassa non dimostra che la conversazione sia a posto. L'ordine è semplice: controlli le istruzioni, poi se i file e gli output dei comandi sono aggiornati, e solo dopo lo stato della conversazione.
Chieda a Claude Code di indicare l'obiettivo attuale dell'attività, i suoi vincoli e i file su cui si basa la soluzione proposta. Confronti la risposta con ciò che vede. Se salta fuori un file estraneo all'attività o l'obiettivo non corrisponde a quello che aveva indicato, sa già cosa correggere, e potrebbe benissimo non trattarsi della lunghezza della conversazione. La stessa domanda è utile dopo la compressione e all'inizio di una nuova conversazione.
Controlli quanto è piena la finestra
Se alla fine il sospetto ricade proprio sulla conversazione, usi /context. Il comando mostra come viene occupata la finestra, suddividendo il contenuto per categorie: parte di sistema, istruzioni del progetto, file letti e output dei comandi, conversazione e spazio libero. Sarà Lei a decidere quali informazioni non servono più all'attività. Il comando non valuta il significato di ciò che è stato letto e la riga complessiva dei messaggi non indica quale file preciso sia superfluo.
Non esiste una soglia universale del tipo "oltre questa percentuale bisogna comprimere"; anche la dimensione della finestra dipende dal modello e dalle impostazioni. Guardi cosa la occupa, non la percentuale. Tenga presente che chiudere una scheda dell'editor non rimuove dalla conversazione ciò che è già stato letto.
Prosegua l'attività dopo la compressione
Il comando /compact riduce la cronologia a un breve riepilogo, mentre Lei continua la stessa attività. Claude Code lo fa anche automaticamente quando la finestra si riempie; lo si avvia manualmente quando si vuole scegliere il momento (per esempio, prima di una nuova parte impegnativa del lavoro) e indicare il punto su cui concentrarsi.
Il limite principale è che viene conservato il riepilogo, non la conversazione. Non può contare sul fatto che i dettagli assenti dal riepilogo restino nella finestra. E dire "conserva queste condizioni" non garantisce un riepilogo completo: è una richiesta, non un meccanismo.
Cosa salvare
Prima del comando, prepari una breve nota sull'attività: obiettivo, limiti, decisioni prese, fatti verificati e passo successivo. Ci vogliono un paio di minuti. In compenso, può confrontare la nota con i file e con l'output dei controlli, invece di affidarsi ai ricordi della conversazione. Non serve creare un file apposito: basta il documento dell'attività che esiste già.
Ecco lo stato di un'attività didattica sulla doppia assegnazione di una ricompensa. È un esempio, non il resoconto di un controllo realmente eseguito:
Obiettivo: in una partita completata la ricompensa viene assegnata una sola volta; una nuova partita consente di assegnarla di nuovo.
Limiti: src/reward-flow.js e il test esistente della ricompensa; non modificare l'aspetto grafico.
Confermato: dopo la prima assegnazione, un altro clic nella stessa partita aumenta di nuovo il punteggio.
Fonte: la registrazione della riproduzione e lo stato iniziale sono indicati in TASK_SPEC.md.
Scartato: nascondere il pulsante senza correggere la gestione del clic ripetuto.
Prossimo passo: controllare il gestore e proporre una modifica; correzione e test non sono ancora stati eseguiti.Faccia attenzione all'ultima riga. Aver riprodotto e confermato un problema non equivale ad averlo corretto, e la nota deve dirlo chiaramente: altrimenti, dopo la compressione, "verificato" può facilmente diventare "risolto". Qui il documento dell'attività è didattico; sostituisca il percorso con il Suo.
Dopo aver verificato la nota, può comprimere indicando su cosa concentrarsi:
/compact Concentrati sulla correzione della doppia assegnazione della ricompensa. Conserva l'obiettivo, i limiti indicati in TASK_SPEC.md, la riproduzione confermata, la soluzione scartata e il prossimo passo. Indica che la correzione e i test non sono ancora stati eseguiti.Cosa verificare dopo
Dopo la compressione, non riprenda a metà frase. Prima riporti nella conversazione ciò che deve essere preciso e faccia una domanda di controllo:
Leggi TASK_SPEC.md e la versione aggiornata di src/reward-flow.js. Indica brevemente il vincolo e il prossimo passo. Se il riepilogo non coincide con i file, segnala la differenza. Per ora non modificare il codice.Confronti la risposta con la nota, riga per riga, e non in base all'impressione generale. Nel nostro esempio ci sono tre controlli:
- nella riga "Prossimo passo" non si dichiara che correzione e test siano stati eseguiti;
- in "Limiti" è rimasto il divieto di modificare l'aspetto grafico;
- non è andata persa la condizione sulla nuova partita indicata in "Obiettivo".
È normale che l'agente usi parole diverse. Se manca una condizione, la recuperi dalla fonte prima di modificare il codice. Così sta controllando lo stato della conversazione, non il codice: questo confronto non dimostra che la modifica successiva sarà corretta.
La compressione agisce solo sulla cronologia della conversazione. Non annulla le modifiche ai file e non sostituisce Git. Il file CLAUDE.md nella radice viene caricato di nuovo, quindi le regole del progetto sopravvivono alla compressione. Non è invece il posto giusto per lo stato temporaneo dell'attività: la frase "sto correggendo l'assegnazione" resterà anche dopo aver concluso il lavoro. Le informazioni riportate dall'agente dopo la compressione non diventano automaticamente attendibili. Ne verifichi la fonte: il riepilogo, un file appena riletto o una nuova esecuzione.
Avvii una nuova attività
Il comando /clear avvia una nuova conversazione senza i messaggi precedenti. I file sul disco e le istruzioni del progetto restano; può essere usata anche la memoria automatica, se è attiva. Qui "da zero" si riferisce quindi alla conversazione. Quella precedente non viene eliminata e può riprenderla con /resume.
È facile confonderlo con claude --continue, anche se servono a scopi opposti. Si digita /clear all'interno della sessione per abbandonare la cronologia accumulata. claude --continue si digita nel terminale all'avvio per riprendere l'ultima conversazione di quella cartella, con tutta la sua cronologia. Se il problema era proprio la conversazione, --continue La riporterà esattamente lì.
Prima di azzerare la conversazione, salvi ciò che Le servirà dopo: una nota, i percorsi utili, l'output dei controlli. Alla nuova conversazione servono istruzioni precise, non un accenno: obiettivo, vincoli e percorsi. Per fornire un file specifico può usare @file; tenga però presente che la menzione orienta la lettura, ma non limita l'accesso agli altri file.
Scelga cosa fare
La sequenza è breve: si fermi, faccia una domanda di controllo, controlli quanto è piena la finestra se non è chiaro cosa la occupa, scelga un'azione e ne verifichi il risultato. Contare i messaggi non serve: guardi cosa contiene la conversazione e cosa intende fare dopo.
| Situazione | Azione e motivo |
|---|---|
| L'agente non ha ricevuto la regola per assegnare la ricompensa | Fornisca la regola e il file: la compressione non colma la lacuna |
| La risposta si basa su un file che nel frattempo è cambiato | Chieda di rileggere la versione aggiornata; non serve comprimere |
In chat si è concordato un requisito, ma in TASK_SPEC.md ne è scritto un altro | Decida quale requisito è valido e corregga la fonte |
| La stessa attività, molte alternative scartate, poco spazio utile | Nota, /compact con un focus e domanda di controllo |
| Dopo la compressione è scomparso il divieto di modificare il modulo vicino | Rilegga la fonte dei vincoli e verifichi di averla capita prima di modificare |
| Inizia un'attività indipendente sull'aspetto grafico | Salvi il risultato utile, usi /clear e prepari nuove istruzioni |
Cosa cambia nel lavoro
I tre comandi, da soli, non correggono nulla. Cambia il modo in cui gestisce un'attività lunga:
- di fronte a una risposta strana, controlla prima le istruzioni e se i file sono aggiornati, e solo dopo la conversazione;
- prima di comprimere o azzerare la conversazione prepara una nota confrontata con i file; dopo la compressione verifica la risposta riga per riga;
- la nuova attività riceve istruzioni proprie, non i resti della conversazione precedente.
La differenza si vede in una richiesta. Prima:
Ti sei confuso, ricominciamo da capo.Dopo:
L'attività attuale è correggere la doppia assegnazione della ricompensa in src/reward-flow.js.
Leggi TASK_SPEC.md, indica il vincolo e il prossimo passo. Per ora non modificare il codice.La seconda formulazione porta a una risposta verificabile: può confrontare il vincolo e il passo indicati con i file e notare subito le differenze. La prima non offre nulla con cui fare il confronto.
GO TO FULL VERSION