Claude Code memory : /init, CLAUDE.md et le raccourci #, illustrés
Sans mémoire, Claude Code repart de zéro à chaque session. Ce pas-à-pas lance /init sur un vrai projet Next.js, lit le CLAUDE.md généré, ajoute une règle depuis le chat avec le raccourci # et vérifie que Claude la respecte réellement — chaque étape contrôlée par screenshot.
TL;DR — la mémoire de Claude Code en quatre lignes
- Lancez /init une fois par projet : Claude scanne le dépôt — arborescence, scripts, gestion d'état — et écrit un CLAUDE.md structuré à la racine.
- Ce fichier entre automatiquement dans le contexte de chaque session, si bien que ce que vous y écrivez façonne toute la génération de code à venir.
- Tapez # suivi d'une règle dans le chat pour la mémoriser sur le champ, puis choisissez sa destination : mémoire projet (committée), mémoire projet locale ou mémoire utilisateur (~/.claude/CLAUDE.md).
- Tenez le fichier à jour quand votre structure ou votre stack évolue — une mémoire périmée désoriente Claude — et rouvrez n'importe quel fichier mémoire avec /memory.
Claude Code Tutorial #2 - CLAUDE.md Files & /init
Chaîne:Net Ninja12:18
The CLAUDE.md file
Chaîne:Claude (official Anthropic channel)3:01
Claude Code's Memory System: The Full Guide
Chaîne:DIY Smart Code5:05
Manage Claude's memory — Claude Code documentation
Doc:code.claude.com
Les images viennent de la leçon CLAUDE.md de Net Ninja (une capture VS Code toute propre) ; le texte du pas-à-pas a été rédigé indépendamment et confronté à la documentation mémoire d'Anthropic et à l'explication officielle de CLAUDE.md.
Les captures d'écran restent la propriété de leurs auteurs et servent ici de documentation visuelle avec attribution. Chaque étape renvoie par lien profond à l'instant exact de la vidéo source.
De zéro mémoire à un projet que Claude connaît
1 · Générer CLAUDE.md avec /init
- 1
Commencer par /init
Quand vous amenez Claude Code dans un projet pour la première fois, lancez /init avant de demander le moindre code. L'infobulle le dit exactement : initialiser un nouveau fichier CLAUDE.md avec la documentation de la base de code. Claude lit votre projet d'avance pour que les sessions suivantes n'aient pas à le faire.
/init — la seule commande à lancer avant tout le reste dans un nouveau dépôt.Regarder à 0:30 - 2
Voir Claude explorer avant d'écrire
/init ne devine pas : il bâtit sa propre liste de todos — explorer l'arborescence du dépôt, analyser package.json et le code source, vérifier la documentation existante, puis créer CLAUDE.md avec ses découvertes. Chaque item se coche en direct : le fichier résume ce qui a été réellement lu, ce n'est pas un template rempli.
La liste Update Todos pendant l'initialisation — explorer, analyser, puis écrire.Regarder à 1:42 - 3
Lire l'en-tête de consignes et les commandes écrits
Le fichier généré s'ouvre sur un en-tête de consignes pour Claude Code, puis Development Commands tirées telles quelles de package.json — dev, build, lint, start. C'est cette section qui empêche Claude d'inventer son propre workflow : les vrais scripts sont dans son contexte.
Le début du fichier : consignes pour Claude Code plus les vrais scripts npm du projet.Regarder à 2:56 - 4
Vérifier les sections architecture et structure
Faites défiler : le fichier documente l'aperçu de l'architecture (ce projet : un blog Next.js 15 avec React 19 et Tailwind), une carte Project Structure qui montre où placer les nouveaux fichiers, et des notes de persistance des données pour la couche Hygraph CMS. Les nouvelles sessions héritent de tout cela sans relire votre dépôt.
Project Structure avec les chemins sélectionnés, plus la note de persistance Hygraph.Regarder à 2:30
2 · Ajouter des souvenirs et prouver qu'ils tiennent
- 5
Prouver que la mémoire change le comportement
Le test : après avoir ajouté « tous les hooks réutilisables vont dans ce dossier hooks » au fichier, on demande un hook de préférence de thème — en précisant de ne l'utiliser nulle part pour l'instant. Les todos de Claude montrent la création du hook dans src/hooks/use-theme, et il conclut : « le hook est prêt à l'emploi mais n'a été intégré nulle part, comme demandé ». La mémoire entre, le comportement sort.
Le hook atterrit dans le dossier nommé par le fichier mémoire — et respecte la consigne « ne pas brancher ».Regarder à 6:40 - 6
Mémoriser une règle avec # depuis le chat
Pas besoin d'éditer le fichier à la main. Commencez un message par # — par exemple « # quand tu crées de nouveaux composants de page, ajoute toujours un lien vers cette page dans le header » — Claude Code y reconnaît un souvenir à conserver et demande où le ranger : mémoire projet, mémoire projet locale ou mémoire utilisateur.
Le raccourci # et le sélecteur à trois destinations qu'il ouvre.Regarder à 7:30 - 7
Distinguer les quatre types de mémoire
La table de la documentation Anthropic sert de carte : mémoire de stratégie d'entreprise pour les organisations, mémoire projet (./CLAUDE.md, committée et partagée avec l'équipe), mémoire utilisateur (~/.claude/CLAUDE.md, vos préférences globales) et mémoire projet locale (./CLAUDE.local.md, personnelle et hors suivi) — que la doc signale comme dépréciée au profit de l'import de fichiers non suivis depuis la mémoire projet, même si l'option apparaît encore dans le sélecteur.
La table officielle des types de mémoire : emplacement, rôle et niveau de partage de chaque fichier.Regarder à 10:50 - 8
Confirmer que la règle a bien atterri dans le fichier
Choisir la mémoire projet ajoute la règle au CLAUDE.md du projet — la voilà en bas du fichier : « quand tu crées de nouveaux composants de page, ajoute toujours un lien vers cette page dans le header ». À partir de la session suivante, cette ligne voyage dans le contexte automatiquement.
La nouvelle règle, enregistrée en bas du CLAUDE.md committé.Regarder à 11:48
3 · Gérer les fichiers mémoire au quotidien
- 9
Vérifier la mémoire sur une tâche fraîche
Demandez maintenant une page About et observez le plan : « Je vais créer la page About et ajouter un lien vers elle dans le header, conformément à ton instruction en mémoire », avec « Add About page link to header navigation » comme todo dédié. La règle enregistrée par # deux étapes plus tôt pilote une tâche où elle n'a jamais été répétée. (Avertissement honnête de la vidéo : Claude peut aussi ajouter des liens pour des pages que vous n'avez pas mentionnées — un débordement qu'une ligne dans le même fichier maîtrise.)
« …conformément à ton instruction en mémoire » — la liste de todos prouve que la règle est active.Regarder à 9:37 - 10
Rouvrir n'importe quel fichier mémoire avec /memory
La commande /memory liste tous les fichiers mémoire avec leur emplacement : la mémoire projet committée dans ./.CLAUDE.md, la mémoire locale gitignorée dans ./.CLAUDE.local.md et votre fichier utilisateur global dans ~/.claude/CLAUDE.md. Choisissez-en un et il s'ouvre dans votre éditeur — 11 souvenirs comptés dans le fichier de ce projet.
Select memory to edit — trois périmètres, un seul sélecteur.Regarder à 11:22 - 11
L'éditer comme n'importe quel fichier
Claude Code confirme « Opened project memory at ./.CLAUDE.md » et l'ouvre dans VS Code, avec une astuce : définissez les variables d'environnement $EDITOR ou $VISUAL pour choisir un autre éditeur. De /init à l'entretien quotidien, la mémoire n'est qu'un fichier markdown que vous gardez honnête.
« Opened project memory at ./.CLAUDE.md » — éditez-le et gardez-le à jour.Regarder à 12:06
Les couches de mémoire, et où vit chaque fichier
Quatre fichiers, quatre périmètres — choisissez le bon et la mémoire de Claude Code cesse d'être une loterie :
- 1Mémoire projet — ./CLAUDE.md à la racine du dépôt. Suivie dans git, partagée avec tous les développeurs du projet. Restez sur le projet : structure, conventions, commandes, frameworks.
- 2Mémoire projet locale — ./CLAUDE.local.md. Vos notes personnelles pour ce dépôt (vos outils, vos raccourcis), hors suivi. Dépréciée selon la doc — le modèle recommandé est l'import de fichiers non suivis depuis la mémoire projet — mais l'option apparaissait encore dans le sélecteur # au moment de l'enregistrement.
- 3Mémoire utilisateur — ~/.claude/CLAUDE.md dans votre home. Vos préférences globales pour tous les projets de la machine : style de code, langue des réponses, workflows personnels.
- 4Au-delà de CLAUDE.md — les builds récents de Claude Code ajoutent un système de mémoire automatique (MEMORY.md et des fichiers thématiques sous ~/.claude/projects/) que Claude entretient lui-même, séparé du fichier d'instructions, plus des imports @ pour tirer d'autres documents dans le contexte. Désactivez avec CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 si vous ne voulez que des fichiers d'instructions.
Quelle que soit la couche, l'habitude de la vidéo reste la même : la mémoire, ce n'est pas créer puis oublier. Quand votre structure, vos paquets ou vos conventions changent, mettez le fichier à jour — une mémoire périmée vaut pire qu'aucune, parce que Claude la suivra en toute confiance.