Comment voir l’historique complet d’une session Claude Code ?
Claude Code enregistre chaque session intégralement sur votre disque local. Il existe donc trois grandes façons de consulter l’historique, classées ici par facilité d’utilisation.
Méthode 1 : la rejouer visuellement dans le navigateur avec CCViewer (recommandé)
CCViewer est un visualiseur de sessions Claude Code gratuit et open source. Ouvrez la page, déposez un fichier de session (vous pouvez aussi importer tout le dossier ~/.claude/projects/) et rejouez la session comme une conversation :
- Rendu Markdown complet — blocs de code, tableaux, listes et liens affichés tel quel, fini les murs de JSON ;
- Blocs de réflexion — le raisonnement étendu du modèle, repliable en un clic ;
- Appels d’outils — paramètres et résultats de chaque appel Read / Edit / Bash, dépliables pour inspection ;
- Statistiques d’usage et de coût — tokens entrée/sortie/cache, durée de session, lignes ajoutées/supprimées, coût total en un coup d’œil ;
- Export Markdown — transformez n’importe quelle session en document
.mdpartageable en un clic.
Point crucial : l’analyse et le rendu se font à 100 % dans votre navigateur — rien n’est téléversé. Cela compte : les fichiers de session contiennent votre code source, des chemins de fichiers et parfois des secrets.
Méthode 2 : reprendre la session dans le terminal
Claude Code intègre la reprise de session. Exécutez ceci dans le répertoire d’origine du projet :
# Lister les sessions du projet et en choisir une interactivement
claude --resume # raccourci : claude -r
# Reprendre directement la session la plus récente
claude --continue # raccourci : claude -c
# Reprendre une session précise par ID
claude --resume <sessionId>
Parfait pour « continuer à travailler », mais peu pratique pour lire ou chercher dans l’historique : dépiler une longue session pour retrouver un appel d’outil est pénible, et il n’y a aucune statistique de coût.
Méthode 3 : lire le fichier JSONL brut
Les sessions sont stockées en JSONL dans ~/.claude/projects/<projet>/<sessionId>.jsonl — un objet JSON par ligne. Vous pouvez les inspecter avec n’importe quel éditeur ou en ligne de commande :
# Extraire tous les prompts utilisateur avec jq
cat ~/.claude/projects/-Users-you-myproject/<sessionId>.jsonl \\
| jq -r 'select(.type=="user") | .message.content'
Le fichier brut est la source la plus complète (usage des tokens, branche git, horodatages et autres métadonnées), mais sa lisibilité est mauvaise — c’est exactement pour cela que les visualiseurs graphiques existent.
Comparatif
| CCViewer | claude --resume | JSONL brut | |
|---|---|---|---|
| Lecture graphique | ✅ | Partielle (continuer le chat) | ❌ |
| Rendu Markdown | ✅ | ✅ | ❌ |
| Réflexion / outils | ✅ repliable | Résumé replié | JSON brut |
| Stats tokens / coût | ✅ | ❌ | jq manuel |
| Gestion multi-sessions | ✅ import dossier | Projet courant seulement | ❌ |
Ouvrez la page et déposez un fichier
.jsonl — ou tout le dossier ~/.claude/projects/. Rendu Markdown, blocs de réflexion, appels d’outils, statistiques de tokens et de coûts : tout se passe localement dans votre navigateur, rien n’est envoyé.