Chapter 3 · Chapitre 3 · Créer son premier CLAUDE.md
3.2 Utiliser /init et comprendre le fichier généré
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeCe que fait /init
Dans Claude Code, ouvert dans ton dossier mes-videos-ia, tape :
/init
Claude analyse ton projet et crée un premier CLAUDE.md avec ce qu'il découvre : l'organisation des dossiers, les commandes utiles, les conventions qu'il repère. Si un CLAUDE.md existe déjà, /init propose des améliorations au lieu de l'écraser.
S'il trouve des fichiers de règles d'autres outils, il peut reprendre les parties utiles. La documentation cite les règles Cursor (.cursor/rules/ ou .cursorrules) et Copilot (.github/copilot-instructions.md).
Comme toujours, Claude Code te demande l'autorisation avant de créer le fichier : lis ce qu'il propose, c'est ton premier contrôle.
Ce que tu obtiens (exemple pour un projet de vidéos)
# CLAUDE.md
## Vue d'ensemble
Projet de production de vidéos courtes. Chaque vidéo a son dossier video-XX/.
## Structure
- marque/ : logo, mascottes, couleurs
- video-XX/phrases.json : le script
- video-XX/index.html : l'animation
## Commandes
- node rendu.mjs : rend la vidéo finale
Comment le lire
/initdécrit ce qu'il voit : la technique, l'organisation.- Il ne peut pas deviner ce que tu veux : ton public, ton ton, tes règles. C'est à toi de les ajouter (leçon suivante).
- Si un projet est vide, le fichier sera très court : c'est normal.
La relecture, ligne par ligne
Pour chaque ligne générée, pose trois questions :
- Est-ce vrai ? Une commande qui n'existe pas ou un dossier mal décrit induira Claude en erreur à chaque session.
- Est-ce utile à chaque session ? Sinon, retire-le ou déplace-le ailleurs.
- Claude pourrait-il le découvrir seul ? La liste détaillée de tous tes fichiers, par exemple, il peut la lire lui-même. Garde plutôt ce qui n'est pas évident : les pièges, les conventions, le pourquoi.
Tu peux te faire aider pour cette relecture :
Relis le CLAUDE.md que tu viens de créer. Pour chaque ligne, dis-moi si elle est vraie, utile à chaque session, ou découvrable en lisant le projet. Propose les suppressions, mais ne modifie rien sans mon accord.
Exemple de tri dans mes-videos-ia
- « Chaque vidéo a son dossier video-XX/ » → vrai et utile : on garde.
- « node rendu.mjs : rend la vidéo finale » → utile si c'est bien la bonne commande : vérifie-la.
- « Le dossier marque/ contient logo.png, logo-blanc.png, fond1.jpg… » → découvrable seul : on peut raccourcir en « marque/ : logo, mascottes, couleurs ».
Bon réflexe
Relis chaque ligne. Supprime ce qui est faux ou inutile. Un CLAUDE.md doit contenir des choses vraies et utiles à chaque session. Puis vérifie que le fichier est bien chargé : /context, partie Memory files.
Si ça coince
/initcrée un fichier presque vide : ton projet contient peu de fichiers. Ce n'est pas grave, tu vas le compléter à la main à la leçon suivante.- Le fichier contient des commandes inventées ou fausses : supprime-les. Mieux vaut une section « Commandes » vide qu'une commande erronée.
- Tu as déjà un CLAUDE.md et tu as peur de l'écraser :
/initpropose des améliorations au lieu d'écraser. Lis-les et accepte seulement ce qui te convient.
À retenir
/initanalyse le projet et crée un premier CLAUDE.md.- Il décrit ce qu'il voit, pas ce que tu veux.
- Relis chaque ligne : vraie, utile, non découvrable seul.
- Termine toujours par une vérification avec
/context.