Claude Code
Où Claude Code range tes sessions, et comment les relire
Chaque conversation est un fichier sur ton Mac. Où il se trouve, comment reprendre une session d'il y a trois semaines, et comment l'exporter en texte lisible.
Publié le 29 septembre 2026 · 6 min de lecture
Claude Code enregistre chaque conversation au fil de l'eau, en local. C'est ce qui te permet de fermer le terminal et de reprendre le lendemain. Encore faut-il savoir où chercher.
Le dossier : ~/.claude/projects
Par défaut, chaque session est un fichier JSONL rangé ici :
~/.claude/projects/<projet>/<id-de-session>.jsonl
<projet> est le chemin de ton dossier de travail, où chaque caractère qui n'est ni une lettre ni un chiffre devient un tiret. Une session lancée dans /Users/moi/Code/facturette atterrit donc dans ~/.claude/projects/-Users-moi-Code-facturette/. Si ce nom dépasse 200 caractères, Claude Code le tronque et ajoute une empreinte du chemin complet.
À côté de chaque fichier, un dossier du même nom peut contenir les conversations des sous-agents (subagents/) et les sorties d'outils trop longues (tool-results/).
Chaque ligne du fichier est un objet JSON : un message, un appel d'outil ou une métadonnée. Ce format est interne et change d'une version à l'autre. Pour lire une session, mieux vaut passer par les commandes ci-dessous que par un script maison qui cassera à la prochaine mise à jour.
Reprendre une session
| Commande | Ce qu'elle fait |
|---|---|
claude --continue | Rouvre la conversation la plus récente du dossier courant |
claude --resume | Ouvre le sélecteur de sessions |
claude --resume <nom> | Reprend directement la session qui porte ce nom |
claude --resume <chemin> | Reprend la conversation stockée dans ce fichier .jsonl (chemin absolu) |
/resume | Passe à une autre conversation depuis une session ouverte |
Une session reprise retrouve tout son historique, appels d'outils compris, ainsi que son modèle, sauf si ce modèle a été retiré ou si tu en imposes un autre au lancement.
Retrouver une vieille session
Le sélecteur (/resume ou claude --resume sans argument) montre par défaut les sessions du dossier courant. Quelques raccourcis changent tout :
- Ctrl+A élargit la liste à tous les projets du Mac. Appuie à nouveau pour revenir.
- Tape n'importe quel caractère pour chercher. Colle l'adresse d'une pull request GitHub ou GitLab pour retrouver la session qui l'a créée.
- Espace affiche un aperçu de la session sans la rouvrir.
- Ctrl+B filtre sur la branche git courante.
- Ctrl+R renomme la session sélectionnée.
Le plus simple reste de nommer tes sessions : claude -n refonte-paiement au lancement, ou /rename refonte-paiement en cours de route. Tu la reprends ensuite avec claude --resume refonte-paiement. Sans nom, Claude Code génère un titre à partir de ta première demande, et ce titre marche aussi avec --resume.
Tu as l'identifiant d'une session ? claude --resume <id> fonctionne depuis n'importe quel dossier : Claude Code la cherche dans le projet courant, puis dans tous les autres projets du Mac.
L'exporter en texte lisible
Dans une session, /export ouvre un menu pour copier la conversation dans le presse-papiers ou l'enregistrer en fichier texte, avec les messages et les sorties d'outils rendus lisiblement. Donne un nom de fichier pour sauter le menu :
/export refonte-paiement.txt
Pour un script, l'interface prévue est claude -p. Par exemple, pour demander un résumé à une session existante et lire la réponse :
claude -p --resume <id-de-session> --output-format json "résume ce qu'on a changé" | jq -r '.result'
Et pour réagir à la fin de chaque session, les hooks reçoivent le chemin de la conversation dans le champ transcript_path : c'est ce qu'utilise notre hook d'archivage.
Déplacer ou supprimer ses sessions
- La variable d'environnement
CLAUDE_CONFIG_DIRdéplace tout le stockage hors de~/.claude. claude project purgesupprime tout de suite les conversations et l'état d'un projet, sans attendre le nettoyage automatique.
Sources
- Documentation Claude Code : gérer les sessions (reprise, sélecteur, noms,
/export, emplacement des conversations) - Documentation Claude Code : le dossier
~/.claude
Vérifié sur Claude Code 2.1.285, le 29 septembre 2026.