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.
Une session est une conversation enregistrée liée à un répertoire de projet. Claude Code la stocke localement au fur et à mesure que vous travaillez, ce qui vous permet de reprendre là où vous vous êtes arrêté, de créer une branche pour essayer une approche différente ou de basculer entre les tâches.
L’application de bureau, Claude Code sur le web et l’extension VS Code maintiennent chacun leur propre historique de sessions. Cette page couvre l’interface CLI :
- Reprendre une conversation précédente par drapeau, nom ou PR
- Nommer les sessions pour pouvoir les retrouver plus tard
- Parcourir les sessions avec le sélecteur
/resume
- Créer une branche d’une conversation pour essayer une approche différente
- Exporter les transcriptions et les localiser sur le disque
Reprendre une session
Les sessions sont enregistrées en continu dans les fichiers de transcription locaux au fur et à mesure que vous travaillez, ce qui vous permet de revenir à l’une d’elles après avoir quitté ou exécuté /clear. Utilisez ces points d’entrée :
| Commande | Ce qu’elle fait |
|---|
claude --continue | Reprend la session la plus récente dans le répertoire courant |
claude --resume | Ouvre le sélecteur de sessions |
claude --resume <name> | Reprend directement la session nommée |
claude --from-pr <number> | Reprend la session liée à cette demande de tirage |
/resume | Bascule vers une conversation différente depuis une session active |
claude -p ou le SDK Agent n’apparaissent pas dans le sélecteur de sessions, mais vous pouvez toujours en reprendre une en passant son ID de session à claude --resume <session-id>.
Où le sélecteur de sessions cherche
Les sessions sont stockées par répertoire de projet. Par défaut, le sélecteur de sessions affiche les sessions interactives du worktree courant, ainsi que les sessions démarrées ailleurs qui ont ajouté le répertoire courant avec /add-dir. Utilisez Ctrl+W pour élargir à tous les worktrees du référentiel ou Ctrl+A pour élargir à chaque projet sur cette machine.
La sélection d’une session d’un autre worktree du même référentiel la reprend sur place. La sélection d’une session d’un projet non lié copie une commande cd et de reprise dans votre presse-papiers à la place.
La reprise par nom se résout dans le référentiel courant et ses worktrees. Les deux formes recherchent une correspondance exacte et la reprennent directement même si elle se trouve dans un worktree différent :
| Commande | Correspondance exacte | Nom ambigu |
|---|
claude --resume <name> | Reprend directement | Ouvre le sélecteur de sessions avec le nom pré-rempli comme terme de recherche |
/resume <name> | Reprend directement | Signale une erreur ; exécutez /resume sans argument pour ouvrir le sélecteur de sessions |
Nommer vos sessions
Donnez aux sessions des noms descriptifs pour qu’elles soient trouvables dans le sélecteur de sessions et reprises par nom. Cela est particulièrement important lorsque vous travaillez sur plusieurs tâches en parallèle.
| Quand | Comment définir le nom |
|---|
| Au démarrage | claude -n auth-refactor |
| Pendant une session | /rename auth-refactor. Le nom apparaît également dans la barre d’invite |
| À partir du sélecteur de sessions | Mettez en surbrillance une session et appuyez sur Ctrl+R |
| À l’acceptation du plan | L’acceptation d’un plan en mode plan nomme la session à partir du contenu du plan sauf si vous en avez déjà défini un |
claude --resume <name> ou /resume <name>. Voir Reprendre une session pour savoir comment la résolution des noms se comporte entre les worktrees.
Utiliser le sélecteur de sessions
Exécutez /resume à l’intérieur d’une session, ou claude --resume sans arguments, pour ouvrir le sélecteur de sessions interactif. Utilisez ces raccourcis clavier pour naviguer, rechercher et élargir la liste :
| Raccourci | Action |
|---|
↑ / ↓ | Naviguer entre les sessions |
→ / ← | Développer ou réduire les sessions groupées |
Enter | Reprendre la session mise en surbrillance |
Space | Prévisualiser le contenu de la session. Ctrl+V fonctionne également sur les terminaux qui ne le capturent pas comme collage |
Ctrl+R | Renommer la session mise en surbrillance |
/ ou tout caractère imprimable autre que Space | Entrer en mode recherche et filtrer les sessions. Collez une URL de demande de tirage ou de fusion GitHub, GitHub Enterprise, GitLab ou Bitbucket pour trouver la session qui l’a créée |
Ctrl+A | Afficher les sessions de tous les projets sur cette machine. Appuyez à nouveau pour revenir au référentiel courant |
Ctrl+W | Afficher les sessions de tous les worktrees du référentiel courant. Appuyez à nouveau pour revenir au worktree courant. Affiché uniquement dans les référentiels multi-worktrees |
Ctrl+B | Filtrer les sessions de la branche git courante. Appuyez à nouveau pour afficher toutes les branches |
Esc | Quitter le sélecteur de sessions ou le mode recherche |
Ctrl+A.
Les sessions créées avec /branch, /rewind ou --fork-session sont groupées sous leur session racine. Appuyez sur → pour développer un groupe.
Créer une branche d’une session
La création d’une branche crée une copie de la conversation jusqu’à présent et vous y bascule, laissant l’original intact. Utilisez-la pour essayer une approche différente sans perdre le chemin sur lequel vous étiez.
À partir d’une session, exécutez /branch avec un nom optionnel :
/branch try-streaming-approach
--continue ou --resume avec --fork-session :
claude --continue --fork-session
/branch imprime deux ID de session : la nouvelle branche dans laquelle vous êtes maintenant et l’original. Pour revenir à l’original, passez son ID à /resume, utilisez le sélecteur de sessions ou exécutez /resume <original-name>. Les autorisations que vous avez approuvées avec « autoriser pour cette session » ne sont pas reportées à la nouvelle branche. Si vous reprenez la même session dans deux terminaux sans créer de branche, les messages des deux s’entrelacent dans une seule transcription.
Pour la rembobinage basé sur les points de contrôle au sein d’une seule session, voir Points de contrôle.
Gérer le contexte au sein d’une session
Ces commandes contrôlent ce qui se trouve dans la fenêtre de contexte sans quitter la session :
/clear : recommencer avec un contexte vide. La conversation précédente est enregistrée et reprendre/compact [instructions] : remplacer l’historique par un résumé, optionnellement axé sur ce que vous spécifiez/context : afficher ce qui consomme actuellement le contexte
Pour savoir comment la compaction interagit avec CLAUDE.md, les compétences et les règles, voir le guide de la fenêtre de contexte. Pour les stratégies sur quand effacer par rapport à compacter, voir Meilleures pratiques.
Exporter et localiser les données de session
Exécutez /export pour copier la conversation courante dans votre presse-papiers ou l’enregistrer en tant que fichier texte brut, avec les messages et les sorties d’outils rendus sous forme de texte lisible. Passez un nom de fichier pour écrire directement dans ce fichier.
Les transcriptions sont stockées en JSONL à ~/.claude/projects/<project>/<session-id>.jsonl, où <project> est dérivé du chemin de votre répertoire de travail. Chaque ligne est un objet JSON pour un message, une utilisation d’outil ou une entrée de métadonnées. Pour stocker les sessions ailleurs que ~/.claude, définissez CLAUDE_CONFIG_DIR. Ces fichiers locaux sont supprimés après 30 jours par défaut ; modifiez cela avec cleanupPeriodDays.
Pour supprimer entièrement les écritures de transcription, définissez CLAUDE_CODE_SKIP_PROMPT_HISTORY, ou en mode non interactif utilisez --no-session-persistence.
Voir aussi
Ces pages couvrent les mécaniques de session et de parallélisme connexes :
