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.

Una domanda di controllo

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.

Cosa non fa la compressione

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.

SituazioneAzione e motivo
L'agente non ha ricevuto la regola per assegnare la ricompensaFornisca la regola e il file: la compressione non colma la lacuna
La risposta si basa su un file che nel frattempo è cambiatoChieda di rileggere la versione aggiornata; non serve comprimere
In chat si è concordato un requisito, ma in TASK_SPEC.md ne è scritto un altroDecida quale requisito è valido e corregga la fonte
La stessa attività, molte alternative scartate, poco spazio utileNota, /compact con un focus e domanda di controllo
Dopo la compressione è scomparso il divieto di modificare il modulo vicinoRilegga la fonte dei vincoli e verifichi di averla capita prima di modificare
Inizia un'attività indipendente sull'aspetto graficoSalvi 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.