Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Una sessione è una conversazione salvata legata a una directory di progetto. Claude Code la archivia localmente mentre lavori, così puoi riprendere da dove hai lasciato, creare un ramo per provare un approccio diverso, o passare tra attività.
L’app desktop, Claude Code sul web e l’estensione VS Code mantengono ciascuno la propria cronologia delle sessioni. Questa pagina copre la CLI:
- Riprendere una conversazione precedente per flag, nome o PR
- Assegnare nomi alle sessioni in modo da poterle trovare in seguito
- Sfogliare le sessioni con il selezionatore
/resume
- Creare un ramo di una conversazione per provare un approccio diverso
- Esportare i trascritti e trovarli su disco
Riprendere una sessione
Le sessioni vengono salvate continuamente in file di trascritto locali mentre lavori, quindi puoi tornare a una dopo aver chiuso o eseguito /clear. Usa questi punti di ingresso:
| Comando | Cosa fa |
|---|
claude --continue | Riprende la sessione più recente nella directory corrente |
claude --resume | Apre il selezionatore di sessioni |
claude --resume <name> | Riprende direttamente la sessione denominata |
claude --from-pr <number> | Riprende la sessione collegata a quella pull request |
/resume | Passa a una conversazione diversa da una sessione attiva |
claude -p o l’Agent SDK non vengono visualizzate nel selezionatore di sessioni, ma puoi comunque riprenderne una passando il suo ID di sessione a claude --resume <session-id>.
Dove il selezionatore di sessioni cerca
Le sessioni vengono archiviate per directory di progetto. Per impostazione predefinita, il selezionatore di sessioni mostra le sessioni interattive dal worktree corrente, più le sessioni avviate altrove che hanno aggiunto la directory corrente con /add-dir. Usa Ctrl+W per ampliare a tutti i worktree del repository o Ctrl+A per ampliare a ogni progetto su questa macchina.
Selezionare una sessione da un altro worktree dello stesso repository la riprende sul posto. Selezionare una sessione da un progetto non correlato copia un comando cd e resume negli appunti.
La ripresa per nome si risolve nel repository corrente e nei suoi worktree. Entrambi i moduli cercano una corrispondenza esatta e la riprendono direttamente anche se si trova in un worktree diverso:
| Comando | Corrispondenza esatta | Nome ambiguo |
|---|
claude --resume <name> | Riprende direttamente | Apre il selezionatore di sessioni con il nome pre-compilato come termine di ricerca |
/resume <name> | Riprende direttamente | Segnala un errore; esegui /resume senza argomenti per aprire il selezionatore di sessioni |
Assegnare nomi alle sessioni
Dai alle sessioni nomi descrittivi in modo che siano trovabili nel selezionatore di sessioni e riprendibili per nome. Questo è particolarmente importante quando stai lavorando su più attività in parallelo.
| Quando | Come impostare il nome |
|---|
| All’avvio | claude -n auth-refactor |
| Durante una sessione | /rename auth-refactor. Il nome appare anche sulla barra del prompt |
| Dal selezionatore di sessioni | Evidenzia una sessione e premi Ctrl+R |
| Sull’accettazione del piano | Accettare un piano in plan mode assegna un nome alla sessione dal contenuto del piano a meno che non ne abbia già impostato uno |
claude --resume <name> o /resume <name>. Vedi Riprendere una sessione per come il comportamento della risoluzione dei nomi funziona nei worktree.
Usare il selezionatore di sessioni
Esegui /resume all’interno di una sessione, o claude --resume senza argomenti, per aprire il selezionatore di sessioni interattivo. Usa queste scorciatoie da tastiera per navigare, cercare e ampliare l’elenco:
| Scorciatoia | Azione |
|---|
↑ / ↓ | Naviga tra le sessioni |
→ / ← | Espandi o comprimi le sessioni raggruppate |
Enter | Riprendi la sessione evidenziata |
Space | Anteprima del contenuto della sessione. Ctrl+V funziona anche su terminali che non lo catturano come incolla |
Ctrl+R | Rinomina la sessione evidenziata |
/ o qualsiasi carattere stampabile diverso da Space | Entra in modalità di ricerca e filtra le sessioni. Incolla un URL di pull o merge request di GitHub, GitHub Enterprise, GitLab o Bitbucket per trovare la sessione che l’ha creato |
Ctrl+A | Mostra le sessioni da tutti i progetti su questa macchina. Premi di nuovo per tornare al repository corrente |
Ctrl+W | Mostra le sessioni da tutti i worktree del repository corrente. Premi di nuovo per tornare al worktree corrente. Mostrato solo nei repository multi-worktree |
Ctrl+B | Filtra le sessioni dal ramo git corrente. Premi di nuovo per mostrare tutti i rami |
Esc | Esci dal selezionatore di sessioni o dalla modalità di ricerca |
Ctrl+A.
Le sessioni con rami create con /branch, /rewind o --fork-session sono raggruppate sotto la loro sessione radice. Premi → per espandere un gruppo.
Creare un ramo di una sessione
La creazione di un ramo crea una copia della conversazione finora e ti passa in essa, lasciando l’originale intatto. Usalo per provare un approccio diverso senza perdere il percorso su cui eri.
Da dentro una sessione, esegui /branch con un nome opzionale:
/branch try-streaming-approach
--continue o --resume con --fork-session:
claude --continue --fork-session
/branch stampa due ID di sessione: il nuovo ramo in cui sei ora e l’originale. Per tornare all’originale, passa il suo ID a /resume, usa il selezionatore di sessioni, o esegui /resume <original-name>. I permessi che hai approvato con “allow for this session” non vengono trasferiti al nuovo ramo. Se riprendi la stessa sessione in due terminali senza creare un fork, i messaggi di entrambi si intercalano in un unico trascritto.
Per il rewind basato su checkpoint all’interno di una singola sessione, vedi Checkpointing.
Gestire il contesto all’interno di una sessione
Questi comandi controllano cosa c’è nella finestra di contesto senza lasciare la sessione:
/clear: ricomincia da capo con un contesto vuoto. La conversazione precedente viene salvata e riprendibile/compact [instructions]: sostituisci la cronologia con un riassunto, facoltativamente focalizzato su ciò che specifichi/context: mostra cosa sta attualmente consumando contesto
Per come la compattazione interagisce con CLAUDE.md, skills e regole, vedi la guida della finestra di contesto. Per strategie su quando cancellare rispetto a compattare, vedi Best practices.
Esportare e individuare i dati della sessione
Esegui /export per copiare la conversazione corrente negli appunti o salvarla come file di testo semplice, con messaggi e output degli strumenti renderizzati come testo leggibile. Passa un nome file per scrivere direttamente in quel file.
I trascritti vengono archiviati come JSONL in ~/.claude/projects/<project>/<session-id>.jsonl, dove <project> è derivato dal percorso della directory di lavoro. Ogni riga è un oggetto JSON per un messaggio, uso dello strumento o voce di metadati. Per archiviare le sessioni in un luogo diverso da ~/.claude, imposta CLAUDE_CONFIG_DIR. Questi file locali vengono rimossi dopo 30 giorni per impostazione predefinita; cambia questo con cleanupPeriodDays.
Per sopprimere completamente le scritture di trascritto, imposta CLAUDE_CODE_SKIP_PROMPT_HISTORY, o in modalità non interattiva usa --no-session-persistence.
Vedi anche
Queste pagine coprono la meccanica correlata delle sessioni e del parallelismo:
