Claude Code /insights : un bilan de santé de vos habitudes de code
Une seule commande slash lit vos sessions récentes et produit un rapport HTML : sur quoi vous travaillez, où se situe le frottement, et quelles corrections livrer en premier. Douze étapes illustrées issues de deux vrais terminaux.
L'essentiel
- Tapez /insights dans n’importe quelle session Claude Code — la commande analyse jusqu’à 200 sessions sur cette machine et ignore les très courtes.
- Environ une minute plus tard, le rapport HTML atterrit dans ~/.claude/usage-data/report.html ; chaque exécution enregistre aussi une copie horodatée.
- Le rapport couvre vos projets, votre façon d’utiliser Claude Code, les points de friction et les fonctionnalités à essayer — avec liens ou prompts prêts à coller.
- Demandez à la même session de condenser le rapport (« top 3 des conseils actionnables »), puis laissez Claude écrire les correctifs dans votre CLAUDE.md et vos hooks.
Claude Code Course 15 - The /insights Report
Chaîne : Code Playbook5:09
Claude Code: 5 New "Minor" Features You May Have Missed
Chaîne : AI Coding Daily6:31
Analyze your usage patterns (official docs)
Docs : code.claude.com
Les faits de cette page sont vérifiés auprès du changelog et de la documentation officielle de Claude Code : /insights analyse jusqu’à 200 sessions jamais vues sur votre machine, ignore les très courtes, et écrit report.html ainsi qu’une copie horodatée dans ~/.claude/usage-data/ (nettoyage après cleanupPeriodDays — 30 jours par défaut).
Les captures d’écran proviennent des deux enregistrements des créateurs ci-dessus, avec leur incrustation caméra recadrée ; chaque étape renvoie à la seconde exacte de la vidéo.
Lancer /insights, lire le rapport, appliquer les correctifs
Lancer la commande (étapes 1–3)
- 1
Comprendre /insights avant de le lancer
Anthropic présente /insights comme une commande qui lit votre historique de messages du dernier mois, résume vos projets et votre usage de Claude Code, et suggère des améliorations de flux de travail. Elle rend compte de votre façon de travailler — pas du nombre de tokens consommés.
Le post d’annonce officiel, tiré de la vidéo d’AI Coding Daily.Voir à 0:35 - 2
Taper /insights dans n’importe quel projet
Ouvrez Claude Code dans n’importe quel dossier et lancez /insights. L’analyse couvre toutes vos sessions récentes sur cette machine, pas seulement le projet en cours. Un spinner tourne pendant que Claude lit votre historique — comptez environ une minute.
/insights en cours d’exécution dans la vidéo de Code Playbook ; le spinner compte pendant l’analyse.Voir à 0:50 - 3
Attendre le message « report is ready »
À la fin, Claude Code affiche le chemin du rapport : ~/.claude/usage-data/report.html, et demande si vous voulez approfondir une section ou essayer une suggestion — répondez directement dans la session.
Le message de fin avec le chemin report.html, issu de la seconde vidéo.Voir à 0:45
Lire le rapport (étapes 4–8)
- 4
Ouvrir report.html et commencer par l’en-tête
Le rapport est un fichier HTML local unique. L’en-tête affiche vos totaux — messages, lignes ajoutées et supprimées, fichiers touchés, jours actifs, messages par jour — et huit pastilles de sections, de What You Work On à Team Feedback.
Statistiques d’en-tête d’une analyse de 176 sessions : 936 messages sur 14 jours actifs.Voir à 2:10 - 5
Lire d’abord la carte At a Glance
La carte d’ouverture résume tout le rapport en quatre paragraphes : ce qui fonctionne, ce qui vous freine, les victoires rapides à tenter et les flux de travail ambitieux. Ici, Claude relève une friction syntaxique récurrente et suggère des conventions CLAUDE.md plus un hook de vérification de build.
Le résumé At a Glance — le moyen le plus rapide de décider quoi traiter.Voir à 1:48 - 6
Voir comment vous utilisez vraiment Claude Code
La section How You Use CC trace vos demandes, les outils utilisés par Claude (Read, Edit, Bash…), vos langages et vos types de session (tâche unique, raffinement itératif…). Le créateur ci-dessus y a appris que son flux « plan puis exécution » était sa plus grande force.
Graphiques d’usage du rapport : outils les plus utilisés, langages et types de sessions.Voir à 2:18 - 7
Consulter le détail par projet
What You Work On liste vos projets récents avec une description de ce que vous y avez construit et le nombre de sessions nécessaires — idéal pour repérer le projet qui a généré le plus d’allers-retours.
Cartes de projet avec compteurs de sessions, issues de la seconde vidéo.Voir à 1:25 - 8
Affronter la section friction
Le rapport quantifie ce qui a mal tourné : types de friction principaux comme le code bogué ou la mauvaise approche, et un score de satisfaction estimé par le modèle. En dessous, Existing CC Features to Try propose des ajouts concrets — règles CLAUDE.md, hooks, voire un skill /plan personnalisé.
Types de friction, estimation de satisfaction et suggestions de fonctionnalités.Voir à 1:40
Transformer les constats en correctifs (étapes 9–11)
- 9
Utiliser les blocs PASTE INTO CLAUDE CODE
Beaucoup de suggestions sont fournies en prompts prêts à l’emploi. Celui-ci définit un cycle build-vérification-correction : après chaque édition, lancer le typecheck, analyser les erreurs, toutes les corriger, reconstruire et grep chaque usage du type modifié. Cliquez sur Copy et collez dans une session.
Un prompt copiable généré par le rapport — zéro prompt engineering.Voir à 2:35 - 10
Faire condenser le rapport par la même session
Le rapport est long. Demandez à Claude dans la même session : « give me the top 3 actionable pieces of advice, summarized in less than 200 words ». Vous obtenez une liste courte tirée du rapport — et pouvez continuer à demander.
La demande du top trois juste après la génération du rapport.Voir à 2:55 - 11
Laisser Claude appliquer les correctifs
Sortie type du top trois : ajouter des fichiers de conventions CLAUDE.md dans chaque dépôt, configurer un hook de build post-édition dans .claude/settings.json, et ajouter une règle « tracer tous les usages avant de committer ». Dites oui et Claude rédige les entrées CLAUDE.md et la config du hook pour vous.
Les trois correctifs suggérés — chacun peut être appliqué par Claude.Voir à 3:45
Conserver et partager le rapport (étape 12)
- 12
Conserver ou partager le fichier HTML
report.html est un fichier local autonome — rouvrez-le dans votre navigateur à tout moment ou envoyez-le à un collègue. Chaque exécution enregistre une nouvelle copie horodatée, et le nettoyage supprime ce qui dépasse cleanupPeriodDays (30 jours par défaut).
Le rapport vivant à une simple URL file:/// — il fonctionne hors ligne.Voir à 2:06
Nouveau dans v2.1.281 : la recommandation auto mode
Le changelog de Claude Code v2.1.281 ajoute une recommandation auto mode à /insights : le rapport estime désormais combien de demandes de permission auto mode aurait pu traiter dans vos sessions récentes. Si vous passez vos journées à approuver, mettez à jour, relancez /insights et voyez combien de demandes auto mode aurait absorbées.
Lire l’entrée du changelog v2.1.281