Reprendre une session Claude Code

Un terminal fermé par erreur, une machine qui redémarre, une pause déjeuner qui coupe le fil d’une session de plusieurs heures : la perte apparente d’une conversation Claude Code est une situation fréquente. Bonne nouvelle, deux commandes suffisent dans la grande majorité des cas pour retrouver l’historique complet et repartir exactement là où le travail s’est arrêté, sans tout réexpliquer.

Pourquoi et quand reprendre une session Claude Code

Une session Claude Code contient l’historique des messages, les fichiers consultés et les décisions prises au fil de la conversation. Fermer le terminal, changer de réseau ou redémarrer la machine ne supprime pas cette session : elle reste enregistrée localement dans le répertoire du projet. Reprendre une session est utile dès qu’un travail interrompu doit continuer sans perdre le contexte déjà construit, par exemple lors d’un développement long, d’une revue de code étalée sur plusieurs jours ou d’un changement d’environnement de travail.

Utiliser claude –continue pour reprendre la dernière conversation

La commande la plus simple est claude –continue, aussi accessible via le raccourci -c. Elle charge automatiquement la conversation la plus récente associée au répertoire courant, sans avoir à connaître d’identifiant de session.

Exemple concret : après avoir travaillé dans un dossier de projet, il suffit de revenir dans ce même dossier et de lancer la commande suivante.

claude –continue

Cette méthode convient parfaitement lorsqu’un seul fil de travail est actif par projet. Si plusieurs sessions coexistent dans le même répertoire, –continue choisit uniquement la plus récente, ce qui peut ne pas correspondre à la session recherchée.

Utiliser claude –resume et le sélecteur de sessions interactif

Quand plusieurs sessions existent pour un même projet, claude –resume, ou son raccourci -r, est la commande adaptée. Utilisée sans argument, elle ouvre un sélecteur interactif listant les sessions disponibles pour le dépôt git courant, y compris celles issues de copies de travail liées.

Exemple avec sélecteur interactif :

claude –resume

Exemple avec un identifiant de session connu :

claude –resume 7fe87110-1039-456c-8009-9f5720ee0886

Le sélecteur affiche généralement un aperçu de chaque conversation, ce qui permet d’identifier visuellement la bonne session avant de la relancer.

Reprendre une session via la commande /resume à l’intérieur de Claude Code

Il n’est pas nécessaire de quitter Claude Code pour changer de conversation. Depuis une session déjà active, la commande slash /resume ouvre le même sélecteur que l’option en ligne de commande, ce qui permet de basculer vers une autre conversation sans fermer le terminal.

Cette approche est pratique lorsqu’un développeur jongle entre plusieurs tâches dans la même journée sans vouloir multiplier les fenêtres de terminal.

Reprendre une session liée à une pull request avec –from-pr

Pour un flux de travail centré sur la revue de code, l’option –from-pr permet de reprendre la session associée à une pull request précise en indiquant son numéro.

Exemple :

claude –from-pr 123

Cette commande est particulièrement utile dans un contexte d’équipe où plusieurs pull requests sont suivies en parallèle et où chacune mérite son propre fil de conversation.

Ce qui est conservé et ce qui ne l’est pas lors d’une reprise

Lors d’une reprise avec –continue ou –resume, l’intégralité de l’historique des messages est restaurée, y compris les résultats d’outils utilisés précédemment. En revanche, les permissions accordées spécifiquement pendant la session d’origine ne sont pas conservées : elles doivent être revalidées si un outil sensible est de nouveau sollicité.

Il est également signalé par des retours d’utilisateurs que, dans certains cas, le contexte d’une session précédente peut sembler incomplet après une reprise. Il s’agit d’un point de vigilance plutôt que d’un comportement garanti : mieux vaut vérifier rapidement, après reprise, que les éléments essentiels du travail précédent sont bien présents avant de continuer.

Critère	claude –continue	claude –resume
Usage principal	Reprise rapide sans sélection	Reprise ciblée avec choix explicite
Sélection de la session	Automatique, la plus récente	Manuelle, via identifiant ou sélecteur
Contexte requis	Aucun identifiant à connaître	Identifiant ou nom utile pour cibler une session précise
Cas d’usage typique	Un seul fil de travail actif par projet	Plusieurs sessions ou projets à sessions multiples

Cas particulier des sessions headless avec claude -p

En mode headless, utilisé notamment pour l’automatisation ou l’intégration continue, la reprise suit une logique légèrement différente. La commande claude -p –continue poursuit la conversation la plus récente en mode programmatique, tandis que claude -p –resume avec un identifiant précis reprend une session ciblée.

Un point technique à connaître : le sélecteur interactif de –resume n’affiche pas les sessions créées en mode headless ou via une intégration programmatique. Ces sessions restent néanmoins accessibles, mais uniquement par leur identifiant, en ligne de commande.

Erreurs fréquentes et solutions

Trois situations reviennent régulièrement. Premièrement, claude –continue démarre une nouvelle session au lieu de reprendre la précédente : cela peut se produire lorsque la session a été rouverte via le sélecteur interactif, ce qui, dans certaines versions, ne met pas à jour le fichier d’historique local utilisé par –continue. Dans ce cas, privilégier –resume avec l’identifiant exact de la session résout le problème.

Deuxièmement, le sélecteur –resume n’affiche pas une session pourtant existante : vérifier que la commande est bien lancée depuis le même répertoire de projet et le même dépôt git que la session recherchée.

Troisièmement, un outil demande une nouvelle autorisation après reprise alors qu’elle avait déjà été accordée : ce comportement est normal, les permissions ne sont pas conservées d’une session à l’autre.

Bonnes pratiques pour gérer plusieurs sessions de projet

Quelques réflexes simples évitent la majorité des confusions lors de la gestion de sessions multiples.

• Vérifier le répertoire de travail courant avant de lancer une commande de reprise.
• Utiliser le sélecteur interactif dès qu’un projet comporte plusieurs sessions actives.
• Noter l’identifiant de session pour toute tâche destinée à durer plusieurs jours.
• Contrôler les permissions immédiatement après une reprise, avant de relancer une action sensible.
• Éviter de mélanger reprise interactive et reprise en mode headless sur une même session, pour ne pas perdre le suivi de l’historique.

Questions fréquentes

Que se passe-t-il si aucune session récente n’existe ? Claude Code démarre simplement une nouvelle conversation, aucune erreur bloquante ne se produit.

Pourquoi l’historique semble parfois incomplet après une reprise ? Des retours d’utilisateurs signalent ce comportement dans certains scénarios ; il est recommandé de vérifier l’état de la session juste après la reprise plutôt que de considérer ce résultat comme garanti dans toutes les situations.

Pourquoi claude –continue peut démarrer une nouvelle session après une reprise via le sélecteur interactif ? Un rapport de bogue documenté indique que certaines sessions reprises via le sélecteur interactif ne mettent pas à jour le fichier d’historique local utilisé par –continue, ce qui empêche ensuite cette commande de retrouver la session. Utiliser –resume avec l’identifiant exact contourne ce problème.

Comment reprendre une session liée à une pull request ? La commande claude –from-pr suivie du numéro de la pull request rouvre la session associée à cette révision de code.

Rejoignez notre communauté