Reprendre une session Claude Code et trouver l’historique
Utilisez resume ou le sélecteur Claude Code pour retrouver une conversation, puis localisez les transcriptions en texte brut laissées sur la machine.
Comment reprendre une session Claude Code
Pour reprendre une session Claude Code, exécutez claude --continue pour ouvrir la conversation la plus récente dans le répertoire courant, ou claude --resume pour sélectionner une conversation plus ancienne dans une liste. Depuis une session déjà en cours, la commande /resume vous permet de passer à une autre conversation sans quitter la session. Les formes courtes sont -c et -r.
claude --continue
claude --resume
claude --resume auth-refactorSi vous connaissez déjà le nom ou l’identifiant de la session, transmettez-le en argument. Claude Code ouvre directement cette session sans afficher le sélecteur.
Tout ce qui suit correspond à la documentation officielle sur les sessions au mois de novembre 2026. Claude Code publie fréquemment de nouvelles versions, et les noms des options ainsi que les raccourcis clavier peuvent changer. Considérez donc claude --help et cette page comme les références à utiliser si le comportement observé dans votre terminal diffère.
Ce qu’est réellement une session
Une session est une conversation enregistrée associée à un répertoire de projet. Elle contient tout l’historique des messages, y compris les appels d’outils effectués par Claude et les résultats renvoyés par ces appels. Claude Code l’écrit en continu sur le disque pendant que vous travaillez, et non une seule fois à la fin. La conversation survit donc à la fermeture du terminal ou à la perte de la connexion SSH.
La reprise restaure davantage que le texte. L’historique complet de la conversation est restauré, ainsi que le modèle utilisé par la session et le sous-agent avec lequel elle a été démarrée, si vous avez utilisé --agent. Le mode d’autorisation est également restauré lorsque vous reprenez la session depuis le shell avec --continue ou un ID de session, à une exception de sécurité près : le mode bypass-permissions n’est jamais restauré. Une session qui s’est terminée dans ce mode reprend donc dans le mode utilisé au démarrage d’une nouvelle session. Le plan mode est restauré, y compris lorsque vous sélectionnez la session dans le sélecteur ou que vous basculez vers celle-ci avec /resume. Ces deux méthodes ne transmettent normalement pas le mode enregistré. Les reprises depuis le terminal le restaurent depuis la version v2.1.290, et le sélecteur ainsi que /resume depuis la version v2.1.292. Les versions antérieures perdaient également le plan mode lors de la reprise. Depuis le shell, --permission-mode remplace le mode restauré.
Certains éléments ne sont pas restaurés, car ce sont des options de lancement et non un état enregistré. Les répertoires ajoutés avec --add-dir, ainsi que les options telles que --mcp-config, --settings et --plugin-dir, doivent être indiqués à nouveau lors de la reprise. Les fichiers de configuration tels que settings.json sont relus au lancement. Il n’est donc pas nécessaire de répéter les éléments qui y sont définis. Les identifiants d’authentification suivent la même logique : Claude Code détermine le mode d’authentification au lancement, à partir de votre connexion et de votre environnement, au lieu de le restaurer avec la conversation. Ainsi, une session reprise sur un VPS où un ANTHROPIC_API_KEY indésirable s’est glissé dans le shell affichera l’erreur de clé API invalide, même si elle fonctionnait correctement la dernière fois.
Pourquoi l’historique des sessions compte davantage sur un VPS
Voici le point qui surprend beaucoup de personnes. La transcription est écrite sur la machine où l’agent s’est exécuté. Elle n’est pas stockée dans votre compte et n’est pas synchronisée avec un cloud. Il s’agit d’un fichier enregistré sur le disque de cette machine.
Ainsi, une session laissée dans une fenêtre tmux sur votre VPS n’apparaît pas dans le sélecteur sur votre ordinateur portable. De même, une session ouverte depuis votre ordinateur portable n’apparaît pas sur le VPS. Rien ne circule entre les deux. Si vous travaillez comme la plupart des personnes qui exécutent Claude Code dans tmux sur un VPS, le serveur est l’endroit où s’accumule votre véritable historique de conversation. Le sélecteur affiché localement présente un ensemble différent et beaucoup plus limité.
La même séparation s’applique entre les interfaces. L’application de bureau et l’extension VS Code conservent chacune leur propre historique de sessions. Aucune des deux ne correspond à l’historique de la CLI, même si l’application de bureau peut également reprendre une session de la CLI. Claude Code sur le web possède lui aussi son propre historique. Cowork est encore plus distinct : ses sessions s’exécutent par défaut dans le cloud d’Anthropic et sont enregistrées dans votre compte Claude, plutôt que sur du matériel qui vous appartient. L’exécution locale reste uniquement disponible pour les déploiements de bureau existants. Ainsi, si vous comparez Cowork à Claude Code, l’endroit où la transcription est enregistrée fait partie des critères de décision.
Sur une même machine, la recherche couvre davantage d’emplacements que prévu. claude --resume <session-id> recherche d’abord dans le répertoire du projet courant et dans ses git worktrees, puis dans tous les autres projets présents sur cette machine. Retenez surtout l’expression « sur cette machine ». Un ID de session provenant d’un autre hôte ne renvoie aucun résultat, et Claude Code vous l’indique avec No conversation found with session ID: <session-id>.
Où Claude Code stocke l’historique des sessions
Par défaut, les transcriptions sont enregistrées dans votre répertoire de configuration Claude Code, à un emplacement de la forme ~/.claude/projects/<project>/<session-id>.jsonl.
<project> correspond au chemin de votre répertoire de travail, dans lequel chaque caractère non alphanumérique est remplacé par un tiret. Ainsi, une session démarrée dans /home/deploy/apps/api est enregistrée dans un répertoire nommé -home-deploy-apps-api. Si le nom ainsi obtenu dépasse 200 caractères, Claude Code le tronque et ajoute un hash du chemin complet. Le nom du répertoire reste ainsi compatible avec les limites du système de fichiers.
Le fichier est au format JSONL : il contient un objet JSON par ligne. Chaque ligne correspond à un message, à l’utilisation d’un outil ou à son résultat, à une requête envoyée par Claude Code au modèle, ou à une entrée de métadonnées. Il s’agit de texte lisible, et sa lecture ne pose pas de problème.
En revanche, il ne faut pas écrire de parseur qui s’appuie dessus. Le format des entrées est interne à Claude Code et change d’une version à l’autre. Un script qui lit directement ces fichiers peut donc cesser de fonctionner après n’importe quelle mise à jour. La documentation d’Anthropic recommande elle-même d’utiliser /export ou les interfaces de script documentées. C’est un bon conseil pour cette raison précise.
Deux paramètres modifient cet emplacement et cette durée de conservation. CLAUDE_CONFIG_DIR déplace l’ensemble du répertoire de configuration. Vous pouvez ainsi stocker les transcriptions sur un volume distinct ou chiffré. cleanupPeriodDays dans settings.json contrôle leur durée de conservation. La valeur par défaut est de 30 jours, avec un minimum de 1.
Contenu réel de ces fichiers de transcript
Chaque résultat d’outil est enregistré. Un transcript contient donc le contenu des fichiers lus par Claude et la sortie des commandes exécutées par Claude. La page d’Anthropic sur l’utilisation des données l’indique clairement : Claude Code stocke les transcripts de session localement, en texte brut, sous ~/.claude/projects/. Comme le transcript enregistre également ce que Claude Code envoie au modèle, il peut contenir le prompt système, les définitions des outils, les paramètres des requêtes et les fichiers CLAUDE.md chargés.
Réfléchissez à ce que cela implique sur un serveur. Si Claude a lu un fichier .env pour déterminer pourquoi un service ne démarrait pas, le contenu de ce fichier se trouve désormais dans un fichier JSONL de votre répertoire personnel. Si une commande a affiché une chaîne de connexion, cette chaîne s’y trouve également. Rien n’a fuité. Le transcript a enregistré ce qui s’est passé, ce qui est précisément son rôle. C’est pourquoi il doit être pris en compte dans votre modèle de menace.
- Sauvegardes : une sauvegarde brute de
/homeou/rootcopie vos transcripts à l’emplacement où les sauvegardes sont stockées. Ajoutez une exclusion, ou acceptez que des copies de vos prompts et du contenu de vos fichiers se trouvent désormais dans votre espace de sauvegarde. - Snapshots et images : un snapshot VPS créé pour quelque raison que ce soit contient l’intégralité du répertoire. Il en va de même pour une image clonée afin de créer un second serveur.
- Autres comptes sur la machine : vérifiez vous-même les modes avec
ls -ld ~/.claude ~/.claude/projectsau lieu de supposer qu’ils sont suffisamment restrictifs. - Téléversements volontaires : la commande
/feedbackenvoie volontairement l’historique des conversations à Anthropic, et/buget/sharetransmettent également des données par ce même chemin. La boîte de dialogue de feedback peut aussi inclure d’autres sessions du même projet au cours des dernières 24 heures ou des 7 derniers jours, et pas uniquement la session actuelle. Ce sont des actions que vous choisissez d’effectuer. Vous devez donc savoir ce que vous acceptez avant de confirmer.
Si vous préférez qu’aucun transcript ne soit créé, CLAUDE_CODE_SKIP_PROMPT_HISTORY désactive l’écriture des transcripts, et --no-session-persistence la désactive pour une seule exécution non interactive de claude -p. Évaluez clairement le compromis avant d’utiliser l’une ou l’autre option. La reprise d’une session lit les transcripts. Sans transcript, il n’y a donc pas de reprise.
Comment retrouver une ancienne conversation
Ouvrez le sélecteur avec claude --resume, ou avec /resume depuis une session en cours. Chaque ligne affiche le nom de la session si vous en avez défini un, ou un titre généré dans le cas contraire, ainsi que le temps écoulé depuis la dernière activité, la branche git et la taille du fichier.
Le sélecteur permet d’effectuer une recherche. Appuyez sur /, ou commencez simplement à saisir du texte, pour filtrer la liste. Les raccourcis les plus utiles sont ceux qui élargissent la recherche : Ctrl+A affiche les sessions de tous les projets présents sur cette machine, Ctrl+W affiche tous les worktrees du dépôt courant et Ctrl+B limite la liste à la branche git courante. Appuyez sur Space pour prévisualiser le contenu d’une session avant de la sélectionner, et sur Ctrl+R pour renommer celle qui est en surbrillance.
Nommer les sessions simplifie fortement toutes ces opérations. Démarrez-en une avec claude -n auth-refactor, ou exécutez /rename auth-refactor en cours de route, dès que vous constatez que la conversation est devenue un véritable travail. Vous pouvez ensuite reprendre une session nommée directement depuis le shell en indiquant son nom.
Une session sans nom reçoit tout de même un titre généré. Celui-ci est produit par une requête en arrière-plan vers un petit modèle rapide qui résume votre premier prompt. Ce titre vous aide à reconnaître la ligne dans le sélecteur et sert également d’identifiant pour reprendre la session : claude --resume le résout de la même manière qu’un nom que vous avez défini. En revanche, le nom d’affichage par défaut, comme my-app-3f, qu’une session interactive sans nom utilise dans la liste des sessions en cours, ne fonctionne pas. Si vous le transmettez à claude --resume, Claude Code ne trouve pas la session.
Rechercher dans les transcriptions pour trouver la bonne session
Parfois, vous vous souvenez d’une phrase, mais de rien d’autre. Les transcriptions sont des fichiers texte : vous pouvez donc les rechercher.
grep -rl "nftables" ~/.claude/projects/Cette commande affiche les chemins des transcriptions correspondantes. Le nom de fichier sans l’extension .jsonl correspond à l’ID de session, que claude --resume <session-id> accepte. claude --resume accepte également directement le chemin absolu de la transcription. Utilisez grep pour déterminer la session voulue, puis reprenez-la ou exportez-la pour la lire réellement.
Deux réserves importantes. Le contenu est échappé au format JSON. Une phrase contenant des guillemets, ou coupée par un retour à la ligne, peut donc ne pas correspondre à une chaîne littérale. De plus, une correspondance dans le résultat d’un outil signifie que Claude a vu ce texte, et non que quelqu’un l’a saisi.
Lire et exporter une conversation
/export affiche la conversation actuelle en texte brut. Les messages et la sortie des outils sont rendus dans un format lisible plutôt qu’au format JSON. Sans argument, la commande ouvre un menu qui propose le presse-papiers ou un fichier. Avec un nom de fichier, /export handover.txt écrit directement dans ce chemin. C’est la méthode à utiliser pour transférer une conversation d’un serveur vers votre ordinateur portable ou pour la joindre à un ticket.
Pour les tâches automatisées, utilisez les interfaces conçues pour rester stables. Les hooks et les commandes de la status line reçoivent un champ transcript_path en entrée. Un hook SessionEnd peut donc archiver une transcription à la fin d’une session. Vous pouvez également poser une question à une session enregistrée sans l’ouvrir :
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'Cette commande envoie un prompt de suivi dans l’ancienne conversation et renvoie du JSON structuré. C’est une bien meilleure base que l’analyse d’un format JSONL susceptible d’être modifié dans la prochaine release.
Commencer une nouvelle conversation est parfois préférable à la reprendre
Reprendre une conversation restaure tout son historique, et chaque requête suivante transporte cet historique complet. Poursuivre aujourd’hui une conversation qui a duré quatre heures hier coûte cher. L’accumulation de l’utilisation des tokens dans une longue session explique d’où vient exactement ce coût.
Claude Code peut parfois choisir une solution intermédiaire. Si vous laissez une longue conversation inactive dans une session de terminal interactive et qu’elle utilise le prompt cache d’une heure, qu’un abonnement Claude fournit par défaut à la conversation principale dans le cadre de votre forfait, la compaction automatique la compacte après environ 54 minutes, peu avant l’expiration du cache. Cette fonction s’applique lorsque le contexte de la conversation atteint un seuil de tokens, fixé par défaut à 200,000, si l’auto-compaction est activée et que la machine est active à ce moment-là. Avant la version v2.1.314, Claude Code devait également récupérer les feature flags auprès d’Anthropic. Les abonnés qui avaient désactivé la télémétrie n’en bénéficiaient donc jamais. Depuis la version v2.1.314, la fonction s’exécute aussi pour eux, ainsi que dans le panneau de chat de l’extension VS Code et dans l’onglet Code de l’application desktop. Aucun dialogue ne demande votre confirmation. À votre retour, la conversation affiche une ligne qui commence par Compacted while idle, before the prompt cache expired, et votre message suivant envoie un résumé au lieu de l’historique complet.
- Laissez cette fonction activée pour réduire le coût des requêtes suivantes, mais les éléments supprimés du résumé ne sont plus disponibles. Vous pouvez réduire le seuil avec
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, mais les valeurs inférieures à 100,000 sont relevées à 100,000. - Désactivez-la en définissant
idleCompactionsurfalsedanssettings.json, ou depuis la ligne Idle compaction de/configavec la version v2.1.302 ou ultérieure. La conversation reste alors complète, avec un coût par requête qui augmente selon sa taille. Si le cache a expiré lorsque vous envoyez votre message suivant, cette requête retraite une fois l’historique complet.
Avec les forfaits Pro et Max, la version v2.1.304 a ajouté une vérification supplémentaire. La documentation actuelle mentionne également les forfaits Ultra. Lorsque la reprise d’une longue conversation après une longue interruption, ou avec un autre modèle, utiliserait une part importante de votre limite d’utilisation de 5 heures, un dialogue Resume this conversation? affiche cette part estimée et vous permet de reprendre la conversation ou d’en commencer une nouvelle. Lorsque l’option de nouvelle conversation l’indique, Claude peut consulter la conversation précédente si vous y faites référence.
La décision est plus simple qu’il n’y paraît. Reprenez la conversation lorsque ce que vous allez écrire dépend de ce qui a déjà été dit. Commencez-en une nouvelle lorsque ce n’est pas le cas. La dérive est facile à repérer si vous y prêtez attention : Claude fait référence à un fichier que vous avez supprimé une heure plus tôt, ou reprend une décision déjà réglée au début de la session. Il s’agit d’un contexte obsolète. Le conserver augmente à la fois la consommation de tokens et le risque d’erreur.
Si l’élément utile d’une ancienne conversation est une décision ou une information dont vous aurez à nouveau besoin, ne comptez pas sur la reprise pour la conserver. Écrivez-la à un emplacement visible par toutes les sessions. C’est le rôle des fichiers de mémoire de Claude Code.
/branch est également utile dans ce cas. Cette commande copie la conversation jusqu’au point actuel et vous bascule dans la copie. L’original reste intact et disponible dans le sélecteur. Utilisez-la pour essayer une autre approche sans perdre la première.
Différences entre la reprise, la compaction et la mémoire
Ces notions sont souvent confondues, alors qu’elles répondent à des problèmes différents.
La reprise consiste à retrouver une conversation après l’avoir quittée, après un redémarrage ou après être passé à une autre tâche. La compaction concerne la fenêtre de contexte d’une conversation active : /compact remplace le contexte que Claude conserve par un résumé, afin que les requêtes suivantes envoient moins de tokens. Si le problème vient d’une fenêtre de contexte pleine, utilisez la compaction. La gestion de la fenêtre de contexte de Claude Code présente cette fonctionnalité en détail.
La mémoire est encore différente. Les fichiers CLAUDE.md et la mémoire automatique contiennent des instructions et des informations chargées au début de chaque session. Ils ne représentent donc pas une conversation à laquelle vous revenez. Vous y consignez les éléments auxquels vous ne voulez jamais avoir à revenir.
Si vous voulez faire fonctionner deux conversations en même temps et les faire communiquer, il s’agit d’un mécanisme distinct. Les sessions Claude Code peuvent s’envoyer des messages tant qu’elles sont actives. Ce mécanisme ne sert pas à récupérer depuis le disque la session d’hier.
FAQ
Où Claude Code stocke-t-il l’historique de mes sessions ?
Par défaut, dans votre répertoire de configuration, à l’emplacement ~/.claude/projects/<project>/<session-id>.jsonl, où <project> correspond au chemin du répertoire de travail, avec les caractères non alphanumériques remplacés par des tirets. Chaque fichier est au format JSONL : une ligne contient un objet JSON correspondant à un message, à l’utilisation d’un outil ou à son résultat, à une requête envoyée au modèle ou à une entrée de métadonnées. CLAUDE_CONFIG_DIR déplace le répertoire de configuration ailleurs, et cleanupPeriodDays dans settings.json définit la durée de conservation des transcriptions. La valeur par défaut est de 30 jours, avec un minimum de 1.
Pourquoi ma session VPS n’apparaît-elle pas dans le sélecteur sur mon ordinateur portable ?
Parce que les transcriptions sont écrites sur le disque de la machine où l’agent s’est exécuté, et qu’aucune synchronisation ne les transfère entre les machines. Une conversation ouverte dans tmux sur votre VPS existe uniquement sur le VPS. Reprenez-la sur celui-ci via SSH, ou exécutez /export dans la session et copiez le fichier texte si vous voulez en conserver une copie locale.
Puis-je reprendre une session démarrée dans un autre répertoire ?
Oui, si vous disposez de son ID de session. claude --resume <session-id> recherche d’abord dans le répertoire du projet courant et dans ses worktrees Git, puis dans tous les autres projets de la même machine. Dans le sélecteur, Ctrl+A étend la liste à tous les projets de la machine et Ctrl+W l’étend à tous les worktrees du dépôt courant. Si aucune correspondance n’est trouvée, Claude Code affiche No conversation found with session ID: <session-id>.
Dois-je reprendre une ancienne session ou en démarrer une nouvelle ?
Reprenez une session lorsque votre prochain message dépend de ce qui a déjà été dit dans cette conversation. Démarrez une nouvelle session dans le cas contraire, car la reprise recharge l’intégralité de l’historique et chaque requête suivante le transmet. Surveillez la dérive du contexte : une session qui continue de faire référence à des fichiers que vous avez déjà supprimés conserve un contexte obsolète, ce qui consomme des tokens et réduit la précision à chaque échange.
Puis-je empêcher Claude Code d’écrire les transcriptions sur le disque ?
Oui. CLAUDE_CODE_SKIP_PROMPT_HISTORY désactive l’écriture des transcriptions, et --no-session-persistence la désactive pour une seule exécution non interactive de claude -p. Tenez compte de cette conséquence : la reprise lit les transcriptions, donc leur désactivation signifie que --continue et --resume n’ont rien à charger. Si votre problème concerne l’emplacement des fichiers plutôt que leur existence, faites pointer CLAUDE_CONFIG_DIR vers un volume chiffré et réduisez plutôt cleanupPeriodDays.