SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

Claude Code: riprendere sessioni e trovare la cronologia

Scopri come usare claude --continue, claude --resume e /resume, e dove Claude Code salva le trascrizioni in testo semplice sulla macchina.

Come si riprende una sessione di Claude Code

Per riprendere una sessione di Claude Code, esegui claude --continue per aprire la conversazione più recente nella directory corrente oppure claude --resume per scegliere una sessione precedente da un elenco. Da una sessione già in esecuzione, il comando /resume consente di passare a un'altra conversazione senza uscire. Le forme brevi sono -c e -r.

claude --continue
claude --resume
claude --resume auth-refactor

Se conosci già il nome o l'ID della sessione, passalo come argomento. Claude Code aprirà direttamente quella sessione senza visualizzare il selettore.

Tutto ciò che segue è conforme alla documentazione ufficiale delle sessioni aggiornata a novembre 2026. Claude Code viene rilasciato frequentemente e i nomi dei flag e le scorciatoie da tastiera possono cambiare tra una versione e l'altra. Considera quindi claude --help e quella pagina come riferimenti autorevoli se le indicazioni non corrispondono a ciò che mostra il terminale.

Che cos’è realmente una sessione

Una sessione è una conversazione salvata associata a una directory di progetto. Contiene l’intera cronologia dei messaggi, incluse le chiamate agli strumenti eseguite da Claude e i risultati restituiti da tali chiamate. Claude Code la scrive continuamente su disco mentre lavori, non una sola volta al termine. Per questo la conversazione sopravvive alla chiusura del terminale o alla perdita della connessione SSH.

La ripresa ripristina più del solo testo. Torna l’intera cronologia della conversazione, insieme al modello usato dalla sessione e al subagent con cui è stata avviata, se hai usato --agent. Viene ripristinata anche la modalità dei permessi quando riprendi dalla shell con --continue o con un ID di sessione, con un’eccezione prevista per motivi di sicurezza: la modalità bypass-permissions non viene mai ripristinata. Una sessione terminata in quella modalità riprende quindi nella modalità con cui verrebbe avviata una nuova sessione. La modalità plan viene ripristinata anche quando selezioni la sessione dal selettore o passi a essa con /resume, due percorsi che altrimenti non trasferiscono la modalità salvata. La ripresa dal terminale la ripristina dalla v2.1.290, mentre il selettore e /resume la ripristinano dalla v2.1.292; nelle release precedenti, anche la modalità plan veniva persa durante la ripresa. Dalla shell, --permission-mode sostituisce la modalità ripristinata.

Alcuni elementi non vengono ripristinati perché erano flag di avvio, non stato salvato. Le directory aggiunte con --add-dir e opzioni come --mcp-config, --settings e --plugin-dir devono essere specificate di nuovo quando riprendi la sessione. I file di configurazione come settings.json vengono riletti all’avvio, quindi non devi ripetere le impostazioni che contengono. Le credenziali seguono lo stesso criterio: Claude Code determina come autenticarsi all’avvio, usando il tuo login e l’ambiente, invece di ripristinare l’autenticazione insieme alla conversazione. Di conseguenza, una sessione ripresa su un VPS in cui una voce ANTHROPIC_API_KEY residua è entrata nella shell produrrà l’errore di chiave API non valida, anche se l’ultima esecuzione era riuscita.

Perché la cronologia delle sessioni è più importante su un VPS

Ecco il fatto che sorprende molti utenti. La trascrizione viene scritta sul computer su cui è stato eseguito l'agente. Non viene archiviata nel tuo account e non viene sincronizzata con un cloud. È un file sul disco di quella macchina.

Di conseguenza, una sessione lasciata in una finestra tmux sul tuo VPS non compare nel selettore del laptop, e una sessione del laptop non compare sul VPS. Non viene trasferito nulla tra i due sistemi. Se lavori come la maggior parte degli utenti quando esegue Claude Code in tmux su un VPS, il server è il punto in cui si accumula la cronologia effettiva delle conversazioni, mentre il selettore visualizzato localmente mostra un insieme diverso e molto più limitato.

La stessa separazione si applica alle diverse interfacce. L'app desktop e l'estensione per VS Code mantengono ciascuna la propria cronologia delle sessioni, che non coincide con quella della CLI, anche se l'app desktop può riprendere anche una sessione della CLI. Claude Code sul web mantiene a sua volta una cronologia separata. Cowork è ancora più separato: per impostazione predefinita, le sue sessioni vengono eseguite nel cloud di Anthropic e salvate nel tuo account Claude, non sull'hardware che possiedi; l'esecuzione locale resta disponibile soltanto per le installazioni desktop esistenti. Quindi, se stai valutando Cowork rispetto a Claude Code, la destinazione finale della trascrizione è un elemento della decisione.

All'interno di una singola macchina, la ricerca è più ampia di quanto potresti aspettarti. claude --resume <session-id> cerca prima nella directory del progetto corrente e nei relativi worktree git, quindi in tutti gli altri progetti presenti su quella macchina. Il concetto da ricordare è "su quella macchina". Un ID di sessione proveniente da un altro host non restituisce alcun risultato e Claude Code lo segnala con No conversation found with session ID: <session-id>.

Dove archivia Claude Code la cronologia delle sessioni

Per impostazione predefinita, le trascrizioni si trovano nella directory di configurazione di Claude Code, in un percorso del tipo ~/.claude/projects/<project>/<session-id>.jsonl.

<project> è il percorso della directory di lavoro, con ogni carattere non alfanumerico sostituito da un trattino. Di conseguenza, una sessione avviata in /home/deploy/apps/api viene archiviata in una directory denominata -home-deploy-apps-api. Se il nome così convertito supererebbe i 200 caratteri, Claude Code lo tronca e aggiunge un hash del percorso completo, così il nome della directory resta entro i limiti del file system.

Il file è in formato JSONL: contiene un oggetto JSON per riga. Ogni riga rappresenta un messaggio, l'uso di uno strumento o il relativo risultato, una richiesta inviata da Claude Code al modello oppure una voce di metadati. È testo leggibile e leggerlo non comporta problemi.

Non è invece consigliabile scrivere un parser che lo elabori. Il formato delle voci è interno a Claude Code e cambia tra le versioni. Di conseguenza, uno script che legge direttamente questi file può smettere di funzionare dopo un aggiornamento. La documentazione di Anthropic indica di usare /export o le interfacce di scripting documentate. È un consiglio appropriato proprio per questo motivo.

Due impostazioni modificano questo comportamento. CLAUDE_CONFIG_DIR sposta l'intera directory di configurazione, permettendo di archiviare le trascrizioni su un volume separato o crittografato. cleanupPeriodDays in settings.json controlla per quanto tempo vengono conservate. Il valore predefinito è di 30 giorni e il valore minimo è 1.

Cosa contiene realmente un file di trascrizione

Ogni risultato degli strumenti viene registrato. Di conseguenza, una trascrizione contiene il contenuto dei file letti da Claude e l'output dei comandi eseguiti da Claude. La pagina sull'utilizzo dei dati di Anthropic lo dichiara esplicitamente: Claude Code archivia localmente le trascrizioni delle sessioni in formato testo semplice, in ~/.claude/projects/. Poiché la trascrizione registra anche ciò che Claude Code invia al modello, può contenere il prompt di sistema, le definizioni degli strumenti, i parametri delle richieste e i file CLAUDE.md caricati.

Considerate cosa comporta su un server. Se Claude ha letto un file .env per capire perché un servizio non si avviava, il contenuto di quel file si trova ora in un file JSONL nella home directory. Se un comando ha stampato una stringa di connessione, anche quella stringa è presente nel file. Non si è verificata alcuna fuga di dati. La trascrizione ha registrato ciò che è accaduto, che è esattamente il suo scopo, e proprio per questo deve rientrare nel threat model.

  • Backup: un backup non filtrato di /home o /root copia le trascrizioni nella destinazione dei backup. Aggiungete un'esclusione oppure accettate che copie dei prompt e del contenuto dei file siano ora presenti nel repository di backup.
  • Snapshot e immagini: uno snapshot di una VPS creato per qualsiasi motivo contiene l'intera directory. Lo stesso vale per un'immagine clonata per creare un secondo server.
  • Altri account sul server: verificate autonomamente i permessi con ls -ld ~/.claude ~/.claude/projects invece di presumere che siano adeguati.
  • Upload intenzionali: il comando /feedback invia deliberatamente la cronologia delle conversazioni ad Anthropic, mentre /bug e /share inviano dati attraverso lo stesso percorso. La finestra di feedback può includere anche altre sessioni dello stesso progetto delle ultime 24 ore o degli ultimi 7 giorni, non soltanto quella corrente. Sono operazioni che scegliete di eseguire. Prima di confermare, verificate di comprendere cosa state autorizzando.

Se preferite non creare alcuna trascrizione, CLAUDE_CODE_SKIP_PROMPT_HISTORY disabilita la scrittura delle trascrizioni, mentre --no-session-persistence la disabilita per una singola esecuzione non interattiva di claude -p. Valutate chiaramente il compromesso prima di impostare una delle due opzioni. La ripresa delle sessioni utilizza le trascrizioni, quindi senza trascrizione non è possibile riprendere una sessione.

Come trovare una conversazione precedente

Apri il selettore con claude --resume oppure con /resume dall'interno di una sessione in esecuzione. Ogni riga mostra il nome della sessione, se ne hai impostato uno, oppure un titolo generato automaticamente, oltre al tempo trascorso dall'ultima attività, al branch git e alle dimensioni del file.

Il selettore supporta la ricerca. Premi / oppure inizia semplicemente a digitare per filtrare l'elenco. Le scorciatoie più utili sono quelle che lo ampliano: Ctrl+A mostra le sessioni di tutti i progetti presenti su questa macchina, Ctrl+W mostra tutti i worktree del repository corrente e Ctrl+B limita l'elenco al branch git corrente. Premi Space per visualizzare in anteprima il contenuto di una sessione prima di selezionarla e Ctrl+R per rinominare quella evidenziata.

Dare un nome alle sessioni semplifica notevolmente queste operazioni. Avvia una sessione con claude -n auth-refactor oppure esegui /rename auth-refactor durante una sessione, quando ti accorgi che la conversazione è diventata un'attività vera e propria. In seguito puoi riprendere una sessione con nome direttamente dalla shell.

Anche una sessione senza nome riceve un titolo generato automaticamente. Il titolo viene scritto da una richiesta in background a un modello piccolo e veloce che riassume il primo prompt. Questo titolo ti aiuta a riconoscere la riga nel selettore e può essere usato anche per riprendere la sessione: claude --resume lo risolve nello stesso modo di un nome impostato manualmente. Non funziona invece il nome visualizzato predefinito, ad esempio my-app-3f, che una sessione interattiva senza nome usa negli elenchi delle sessioni in esecuzione. Se lo passi a claude --resume, Claude Code non trova la sessione.

Ricerca nei transcript per trovare la sessione corretta

A volte si ricorda una frase e nient'altro. I transcript sono file di testo, quindi è possibile cercarli.

grep -rl "nftables" ~/.claude/projects/

Il comando stampa i percorsi dei transcript corrispondenti. Il nome del file senza l'estensione .jsonl è l'ID della sessione e claude --resume <session-id> lo accetta. Anche claude --resume accetta direttamente il percorso assoluto del transcript. Usare grep per determinare quale sessione serve, quindi riprenderla oppure esportarla per leggerne effettivamente il contenuto.

Ci sono due limitazioni da considerare. Il contenuto usa l'escape JSON, quindi una frase che contiene virgolette, oppure che è stata divisa da un'interruzione di riga, potrebbe non corrispondere a una stringa letterale. Inoltre, una corrispondenza all'interno del risultato di uno strumento indica che Claude ha visualizzato quel testo, non che qualcuno lo abbia digitato.

Lettura ed esportazione di una conversazione

/export visualizza la conversazione corrente come testo semplice, riportando in modo leggibile i messaggi e l’output degli strumenti invece di usare JSON. Senza argomenti, apre un menu che consente di scegliere gli appunti o un file. Con un nome file, /export handover.txt scrive direttamente in quel percorso. Questo è il metodo corretto per trasferire una conversazione da un server al laptop o per allegarla a un ticket.

Per le attività automatizzate, usa le interfacce progettate per rimanere stabili. Gli hook e i comandi della riga di stato ricevono un campo transcript_path come input, quindi un hook SessionEnd può archiviare una trascrizione al termine di una sessione. Puoi anche inviare una domanda a una sessione salvata senza aprirla:

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

Questo invia un prompt di follow-up nella conversazione precedente e restituisce JSON strutturato. È una base molto più affidabile rispetto all’analisi di un formato JSONL, che potrebbe cambiare nella prossima release.

Quando iniziare da zero è meglio che riprendere

Riprendere una conversazione ripristina tutta la cronologia, che viene poi inclusa in ogni richiesta successiva. Continuare oggi una conversazione durata quattro ore ieri è costoso; come si accumula l’uso dei token in una sessione lunga spiega da dove deriva esattamente questo costo.

A volte Claude Code adotta una soluzione intermedia. Se lasci inattiva una conversazione lunga in una sessione interattiva del terminale e questa usa la cache dei prompt di un’ora, che un abbonamento Claude mette a disposizione per impostazione predefinita della conversazione principale entro i limiti del piano, la compattazione automatica la compatta dopo circa 54 minuti, poco prima della scadenza della cache. Viene applicata quando il contesto della conversazione raggiunge una soglia di token, pari a 200,000 per impostazione predefinita, se la compattazione automatica è attiva e il computer è acceso in quel momento. Prima della v2.1.314 era inoltre necessario che Claude Code recuperasse gli indicatori delle funzionalità da Anthropic; gli abbonati con la telemetria disattivata non la ricevevano quindi mai. Dalla v2.1.314 funziona anche per loro, oltre che nel pannello della chat dell’estensione VS Code e nella scheda Code dell’app desktop. Non viene visualizzata alcuna richiesta di conferma. Quando torni, la conversazione mostra una riga che inizia con Compacted while idle, before the prompt cache expired e il messaggio successivo invia un riepilogo invece dell’intera cronologia.

  • Se la lasci attiva, le richieste successive costano meno, ma ciò che il riepilogo ha eliminato non è più disponibile. Puoi ridurre la soglia con CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, ma i valori inferiori a 100,000 vengono portati a 100,000.
  • Disattivala impostando idleCompaction su false in settings.json, oppure dalla riga Idle compaction in /config su v2.1.302 o versioni successive. La conversazione rimane completa, con un costo per richiesta che cresce in base alle sue dimensioni. Se la cache è scaduta quando invii il messaggio successivo, quella richiesta rielabora una volta l’intera cronologia.

Nei piani Pro e Max, la v2.1.304 ha aggiunto un ulteriore controllo; la documentazione attuale include anche i piani Ultra. Quando riprendere una conversazione lunga dopo una pausa prolungata, oppure con un modello diverso, consumerebbe una parte significativa del limite di utilizzo di 5 ore, una finestra Resume this conversation? mostra la quota stimata e consente di riprendere comunque oppure di iniziare una nuova conversazione. Quando l’opzione per la nuova conversazione lo indica, Claude può cercare quella precedente se fai riferimento a essa.

La scelta è più semplice di quanto sembri. Riprendi la conversazione quando ciò che stai per scrivere dipende da quanto è già stato detto. Inizia da zero quando non dipende da questo. Il contesto obsoleto è facile da riconoscere se presti attenzione: Claude fa riferimento a un file che hai eliminato un’ora prima oppure ridiscute una decisione presa all’inizio della sessione. Questo è contesto obsoleto e conservarlo aumenta contemporaneamente il consumo di token e il rischio di risposte meno accurate.

Se la parte utile di una vecchia conversazione è una decisione o un fatto che ti servirà di nuovo, non affidarti alla ripresa della conversazione per conservarla. Scrivila in un luogo visibile a tutte le sessioni: è proprio questo lo scopo dei file di memoria di Claude Code.

Anche /branch è utile da conoscere. Copia la conversazione fino al punto corrente e passa alla copia, lasciando intatta la conversazione originale, che rimane disponibile nel selettore. Usala per provare un secondo approccio senza perdere il primo.

In che modo resume differisce da compaction e dalla memoria

Questi concetti vengono confusi continuamente, ma risolvono problemi diversi.

Resume serve a recuperare una conversazione dopo l'uscita, il riavvio o il passaggio a un'altra attività. Compaction riguarda invece la finestra di contesto all'interno di una conversazione attiva: /compact sostituisce il contesto che Claude sta mantenendo con un riepilogo, così le richieste successive inviano meno token. Se il problema è che la finestra di contesto è piena, lo strumento da usare è compaction. La sezione gestione della finestra di contesto di Claude Code descrive questo aspetto in modo completo.

La memoria è ancora diversa. I file CLAUDE.md e la memoria automatica contengono istruzioni e informazioni che vengono caricati all'inizio di ogni sessione. Non rappresentano quindi una conversazione a cui tornare. Contengono ciò che si annota per non dover tornare a una conversazione.

Se invece vuoi eseguire due conversazioni contemporaneamente e coordinarle, si tratta di un meccanismo distinto. Le sessioni di Claude Code possono scambiarsi messaggi mentre sono entrambe attive. Questo è un problema diverso dal recuperare dal disco la sessione del giorno precedente.

FAQ

Dove memorizza Claude Code la cronologia delle sessioni?

Per impostazione predefinita, nella directory di configurazione, in ~/.claude/projects/<project>/<session-id>.jsonl, dove <project> è il percorso della directory di lavoro con i caratteri non alfanumerici sostituiti da trattini. Ogni file è in formato JSONL: contiene un oggetto JSON per riga relativo a un messaggio, all'uso di uno strumento o al relativo risultato, a una richiesta inviata al modello oppure a una voce di metadati. CLAUDE_CONFIG_DIR sposta la directory di configurazione in un'altra posizione, mentre cleanupPeriodDays in settings.json imposta per quanto tempo vengono conservate le trascrizioni, con un valore predefinito di 30 giorni e un minimo di 1.

Perché non vedo la sessione del mio VPS nel selettore sul laptop?

Perché le trascrizioni vengono scritte sul disco della macchina su cui è stato eseguito l'agente e non vengono sincronizzate tra le macchine. Una conversazione avviata dentro tmux sul VPS esiste soltanto sul VPS. Riprendila lì tramite SSH oppure esegui /export al suo interno e copia il file di testo sul computer locale se vuoi conservarne una copia.

Posso riprendere una sessione avviata in una directory diversa?

Sì, se disponi del relativo ID di sessione. claude --resume <session-id> cerca prima nella directory del progetto corrente e nei relativi worktree Git, quindi in tutti gli altri progetti presenti sulla stessa macchina. Nel selettore, Ctrl+A estende l'elenco a tutti i progetti della macchina e Ctrl+W lo estende a tutti i worktree del repository corrente. Se non trova corrispondenze, Claude Code segnala No conversation found with session ID: <session-id>.

Devo riprendere una sessione precedente o avviarne una nuova?

Riprendi la sessione quando il messaggio successivo dipende da quanto è già stato detto in quella conversazione. Avviane una nuova quando non dipende dal contesto precedente, perché la ripresa ricarica l'intera cronologia e ogni richiesta successiva la include. Verifica il contesto obsoleto: se una sessione continua a fare riferimento a file che hai già eliminato, sta mantenendo un contesto non più valido, che consuma token e riduce la precisione a ogni turno.

Posso impedire a Claude Code di scrivere le trascrizioni su disco?

Sì. CLAUDE_CODE_SKIP_PROMPT_HISTORY impedisce la scrittura delle trascrizioni, mentre --no-session-persistence la impedisce per una singola esecuzione non interattiva di claude -p. Valuta prima la conseguenza, perché resume legge le trascrizioni: disattivandole, --continue e --resume non avranno nulla da caricare. Se il problema riguarda la posizione dei file e non la loro esistenza, configura CLAUDE_CONFIG_DIR in modo che punti a un volume crittografato e riduci invece cleanupPeriodDays.

Questo articolo ti è stato utile?