Vai al contenuto principale
Claude Code traccia automaticamente le modifiche ai file di Claude mentre lavori, permettendoti di annullare rapidamente le modifiche e tornare a stati precedenti se qualcosa non va come previsto.

​
Come funziona il checkpointing

Mentre lavori con Claude, il checkpointing cattura automaticamente lo stato del tuo codice prima di ogni modifica. Questa rete di sicurezza ti permette di affrontare compiti ambiziosi e su larga scala sapendo che puoi sempre tornare a uno stato di codice precedente.

​
Tracciamento automatico

Claude Code traccia tutti i cambiamenti effettuati dai suoi strumenti di modifica dei file:
  • Ogni prompt dell’utente crea un nuovo checkpoint
  • I checkpoint persistono tra le sessioni, quindi puoi accedervi nelle conversazioni riprese
  • Puliti automaticamente insieme alle sessioni dopo 30 giorni (configurabile)

​
Riavvolgi e riassumi

Premi Esc due volte (Esc + Esc) o usa il comando /rewind per aprire il menu di riavvolgimento. Un elenco scorrevole mostra ciascuno dei tuoi prompt dalla sessione. Seleziona il punto su cui desideri agire, quindi scegli un’azione:
  • Ripristina codice e conversazione: ripristina sia il codice che la conversazione a quel punto
  • Ripristina conversazione: riavvolgi al messaggio mantenendo il codice attuale
  • Ripristina codice: ripristina le modifiche ai file mantenendo la conversazione
  • Riassumi da qui: comprimi la conversazione da questo punto in avanti in un riassunto, liberando spazio nella context window
  • Annulla: torna all’elenco dei messaggi senza apportare modifiche
Dopo aver ripristinato la conversazione o aver riassunto, il prompt originale dal messaggio selezionato viene ripristinato nel campo di input in modo che tu possa reinviarlo o modificarlo.

​
Ripristina vs. riassumi

Le tre opzioni di ripristino ripristinano lo stato: annullano le modifiche al codice, la cronologia della conversazione o entrambi. “Riassumi da qui” funziona diversamente:
  • I messaggi prima del messaggio selezionato rimangono intatti
  • Il messaggio selezionato e tutti i messaggi successivi vengono sostituiti con un riassunto compatto generato dall’IA
  • Nessun file su disco viene modificato
  • I messaggi originali vengono conservati nella trascrizione della sessione, quindi Claude può fare riferimento ai dettagli se necessario
Questo è simile a /compact, ma mirato: invece di riassumere l’intera conversazione, mantieni il contesto iniziale in dettaglio completo e comprimi solo le parti che stanno usando spazio. Puoi digitare istruzioni facoltative per guidare su cosa si concentra il riassunto.
Riassumi ti mantiene nella stessa sessione e comprime il contesto. Se desideri creare un ramo e provare un approccio diverso preservando la sessione originale intatta, usa fork invece (claude --continue --fork-session).

​
Casi d’uso comuni

I checkpoint sono particolarmente utili quando:
  • Esplorare alternative: prova diversi approcci di implementazione senza perdere il tuo punto di partenza
  • Recuperare da errori: annulla rapidamente le modifiche che hanno introdotto bug o rotto la funzionalità
  • Iterare sulle funzionalità: sperimenta variazioni sapendo che puoi tornare a stati funzionanti
  • Liberare spazio di contesto: riassumi una sessione di debug dettagliata dal punto intermedio in avanti, mantenendo le tue istruzioni iniziali intatte

​
Limitazioni

​
Le modifiche dei comandi Bash non vengono tracciate

Il checkpointing non traccia i file modificati dai comandi bash. Ad esempio, se Claude Code esegue: 
rm file.txt
mv old.txt new.txt
cp source.txt dest.txt
Queste modifiche ai file non possono essere annullate tramite riavvolgimento. Solo le modifiche dirette ai file effettuate attraverso gli strumenti di modifica dei file di Claude vengono tracciate.

​
Le modifiche esterne non vengono tracciate

Il checkpointing traccia solo i file che sono stati modificati nella sessione corrente. Le modifiche manuali che effettui ai file al di fuori di Claude Code e le modifiche da altre sessioni concorrenti normalmente non vengono acquisite, a meno che non modifichino gli stessi file della sessione corrente.

​
Non è un sostituto del controllo della versione

I checkpoint sono progettati per il recupero rapido a livello di sessione. Per la cronologia permanente della versione e la collaborazione:
  • Continua a utilizzare il controllo della versione (ad es. Git) per commit, rami e cronologia a lungo termine
  • I checkpoint completano ma non sostituiscono il controllo della versione appropriato
  • Pensa ai checkpoint come “annulla locale” e Git come “cronologia permanente”

​
Vedi anche