Aller au contenu
Floskool

Chapitre 3 · Chapitre 3 · Créer son premier CLAUDE.md

3.2 Utiliser /init et comprendre le fichier généré

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Ce 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

  • /init dé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 :

  1. Est-ce vrai ? Une commande qui n'existe pas ou un dossier mal décrit induira Claude en erreur à chaque session.
  2. Est-ce utile à chaque session ? Sinon, retire-le ou déplace-le ailleurs.
  3. 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

  • /init cré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 : /init propose des améliorations au lieu d'écraser. Lis-les et accepte seulement ce qui te convient.

À retenir

  • /init analyse 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.