4 4
5# Gérer les sessions5# Gérer les sessions
6 6
7> Nommez, reprenez, créez des branches et basculez entre les conversations Claude Code. Couvre `--continue`, `--resume`, `--from-pr`, le sélecteur `/resume`, la dénomination des sessions et l'emplacement des transcriptions.7> Nommez, reprenez, créez des branches et basculez entre les conversations Claude Code. Couvre `--continue`, `--resume`, `--from-pr`, le sélecteur `/resume`, la dénomination des sessions, l'export des transcriptions et l'emplacement des transcriptions.
8 8
9Une 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.9Une 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.
10 10
11L'[application de bureau](/fr/desktop#work-in-parallel-with-sessions), [Claude Code sur le web](/fr/claude-code-on-the-web) et l'[extension VS Code](/fr/vs-code#resume-past-conversations) maintiennent chacun leur propre historique de sessions. Cette page couvre l'interface CLI :11L'[application de bureau](/fr/desktop#work-in-parallel-with-sessions), [Claude Code sur le web](/fr/claude-code-on-the-web) et l'[extension VS Code](/fr/vs-code#resume-past-conversations) maintiennent chacun leur propre historique de sessions. Cette page couvre l'interface CLI.
12
13* [Reprendre](#resume-a-session) une conversation précédente par drapeau, nom ou PR
14* [Nommer](#name-your-sessions) les sessions pour pouvoir les retrouver plus tard
15* [Parcourir](#use-the-session-picker) les sessions avec le sélecteur `/resume`
16* [Créer une branche](#branch-a-session) d'une conversation pour essayer une approche différente
17* [Exporter](#export-and-locate-session-data) les transcriptions et les localiser sur le disque
18 12
19<h2 id="resume-a-session">13<h2 id="resume-a-session">
20 Reprendre une session14 Reprendre une session
125 119
126Exé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.120Exé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.
127 121
128Les 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`](/fr/env-vars). Ces fichiers locaux sont supprimés après 30 jours par défaut ; modifiez cela avec [`cleanupPeriodDays`](/fr/settings#available-settings).122<h3 id="access-conversations-from-scripts">
123 Accéder aux conversations à partir de scripts
124</h3>
125
126`/export` produit une transcription rendue pour qu'une personne la lise. Les interfaces ci-dessous produisent des données structurées pour qu'un script les analyse : un résultat JSON d'une exécution, le chemin vers le fichier de transcription d'une session, ou un flux en direct d'événements. Choisissez en fonction de ce qui déclenche le script :
127
128* **Exécuter Claude une fois et capturer le résultat** : invoquez `claude -p` avec [`--output-format json` ou `stream-json`](/fr/headless#get-structured-output) pour capturer le résultat, l'ID de session, l'utilisation et le coût d'une exécution non interactive sous forme de JSON structuré.
129* **Poser une question à une session existante** : passez un ID de session à [`claude -p --resume`](/fr/headless#continue-conversations) pour envoyer une invite de suivi, comme une demande de résumé, et capturer la réponse structurée.
130* **Réagir aux événements de session** : lisez le champ `transcript_path` que les [hooks](/fr/hooks#common-input-fields) et les [commandes de ligne d'état](/fr/statusline#available-data) reçoivent en entrée. Un hook `SessionEnd` peut archiver la transcription lorsqu'une session se termine.
131* **Intégrer Claude dans une application TypeScript ou Python** : utilisez le [Agent SDK](/fr/agent-sdk/overview) pour recevoir chaque message par programmation.
132
133L'exemple ci-dessous utilise la deuxième interface. Il envoie une invite de suivi à une session existante et lit la réponse avec `jq` :
134
135```bash theme={null}
136claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'
137```
138
139<h3 id="where-transcripts-are-stored">
140 Où les transcriptions sont stockées
141</h3>
142
143Par défaut, les transcriptions sont stockées en JSONL à `~/.claude/projects/<project>/<session-id>.jsonl`, où `<project>` est votre chemin de répertoire de travail avec les caractères non alphanumériques remplacés par `-`. Chaque ligne est un objet JSON pour un message, une utilisation d'outil ou une entrée de métadonnées. Le format d'entrée est interne à Claude Code et change entre les versions, donc les scripts qui analysent directement ces fichiers peuvent se casser à chaque version. Pour construire sur les données de session, utilisez `/export` ou les [interfaces de script](#access-conversations-from-scripts) à la place.
144
145L'emplacement, la rétention et le comportement d'écriture sont configurables :
129 146
130Pour supprimer entièrement les écritures de transcription, définissez [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars), ou en mode non interactif utilisez `--no-session-persistence`.147| Pour | Définir | Où |
148| ------------------------------------------------------------ | ------------------------------------------------------ | ---------------------------- |
149| Déplacer le stockage hors de `~/.claude` | [`CLAUDE_CONFIG_DIR`](/fr/env-vars) | Variable d'environnement |
150| Modifier la rétention de 30 jours | [`cleanupPeriodDays`](/fr/settings#available-settings) | `settings.json` |
151| Supprimer les écritures de transcription dans tous les modes | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars) | Variable d'environnement |
152| Supprimer les écritures pour une exécution non interactive | [`--no-session-persistence`](/fr/cli-reference) | Drapeau CLI avec `claude -p` |
131 153
132<h2 id="see-also">154<h2 id="see-also">
133 Voir aussi155 Voir aussi
