Chapter 1 · Poser les bases
Les trois réflexes de base : CLAUDE.md, mode plan, sauvegarde
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freePourquoi ces trois réflexes changent tout
Prends Sophie, coach sportive. Le premier jour, Claude Code lui écrit une belle page d'accueil. Le lendemain, elle ouvre une nouvelle conversation : Claude ne sait plus qu'elle tutoie ses clientes, ni qu'elle ne veut jamais afficher de prix. Le surlendemain, une modification casse sa page et elle ne sait pas revenir en arrière.
Trois réflexes règlent ces trois problèmes :
- CLAUDE.md : Claude se souvient de tes règles.
- Le mode plan : Claude propose avant d'agir.
- Git : tu peux toujours revenir en arrière.
Réflexe 1 : le fichier CLAUDE.md
CLAUDE.md est un fichier texte que Claude lit au début de chaque conversation. Tu y écris ce qu'il doit savoir à chaque fois : l'objectif du projet, ton public, ton ton, tes règles, ce qui est interdit.
Où il se range :
CLAUDE.mdà la racine de ton projet : les règles de ce projet.~/.claude/CLAUDE.mddans ton dossier personnel : tes préférences pour tous tes projets (le signe~désigne ton dossier personnel).
Pour démarrer vite, tape /init : Claude analyse ton dossier et rédige un premier CLAUDE.md. Complète ensuite avec ce qu'il ne peut pas deviner : ton public, ton ton, tes interdits.
La documentation conseille un fichier court (moins de 200 lignes), utile (« si j'enlève cette ligne, Claude fera-t-il une erreur ? ») et concret (« phrases de 15 mots maximum » plutôt que « écris bien »).
Voici un modèle à adapter :
# Projet : [nom du projet]
## Objectif
[Ce que doit produire ce projet, en une phrase.]
## Pour qui
[Tes clients : qui ils sont, ce qu'ils cherchent.]
## Ton
- Tutoiement (ou vouvoiement).
- Phrases courtes, vocabulaire simple.
## Règles
- N'invente jamais de prix, de chiffres ou d'avis clients : mets [à compléter].
- Propose un plan avant toute modification de plusieurs fichiers.
## Sécurité
- Les clés et mots de passe vivent dans un fichier .env qui n'est jamais envoyé sur Git.
- Demande-moi toujours avant de publier, d'envoyer ou de supprimer quoi que ce soit.
Tape ensuite /memory pour l'ouvrir et le modifier, et /context pour vérifier qu'il est bien chargé.
Réflexe 2 : le mode plan
En mode plan, Claude lit tes fichiers et propose un plan, mais ne modifie rien tant que tu n'as pas approuvé. Pour l'activer : appuie sur Shift+Tab (chaque appui change de mode) jusqu'à voir l'indication du mode plan en bas de l'écran, ou tape /plan suivi de ta demande.
Quand l'utiliser ? Pour corriger une faute, pas besoin. Pour une tâche qui touche plusieurs fichiers, une refonte, ou la première fois sur un projet, toujours.
Exemple de prompt en mode plan :
/plan
Contexte : mon site est dans ce dossier. Je veux ajouter une page [nom de la page] pour [objectif de la page], destinée à [ton public].
Objectif : obtenir un plan clair avant toute modification.
Contraintes : lis d'abord les pages existantes pour reprendre le même style. Mets entre crochets tout texte que tu ne peux pas savoir (adresse, horaires, prix).
Format attendu : les fichiers créés ou modifiés, ce qui change dans chacun.
Validation : explique comment je pourrai vérifier le résultat dans mon navigateur, et attends mon approbation avant d'écrire.
Réflexe 3 : la sauvegarde avec Git
Git est un outil qui garde l'historique de ton projet. Chaque enregistrement (un commit) est une photo de tes fichiers à un instant donné. Tu peux revenir à n'importe quelle photo.
Pas besoin d'apprendre les commandes : Claude Code les connaît. Tu demandes « fais un commit » ou « reviens à la version d'hier ». La méthode : une demande, une vérification, un commit si c'est bon, sinon /rewind ou retour au dernier commit.
Avant le tout premier commit, il faut un fichier .gitignore (la liste des fichiers que Git ne doit jamais enregistrer), qui contient .env (le fichier où tu ranges tes clés secrètes).
Contexte : ce dossier contient mon projet [nom du projet]. Je n'ai jamais utilisé Git.
Objectif : mettre ce dossier sous Git pour pouvoir revenir en arrière.
Contraintes : une phrase simple par étape. Crée un .gitignore qui exclut au minimum .env, les dépendances et les fichiers système. Ne mets rien en ligne.
Format attendu : la liste des commandes que tu vas lancer, avec une phrase d'explication pour chacune.
Validation : attends mon "go" avant de lancer quoi que ce soit. Après le premier commit, montre-moi l'historique et vérifie qu'aucun fichier .env n'a été enregistré.
Attention : /rewind ne remplace pas Git. D'après la documentation, il ne suit que les modifications faites par les outils d'édition de Claude ; un fichier supprimé par une commande n'est pas récupérable avec lui.
Les erreurs à éviter
- Un CLAUDE.md de trois pages. Plus il est long, moins chaque règle compte. Garde l'essentiel.
- Laisser Claude écrire ses règles tout seul. Une règle importante, écris-la toi-même ou valide-la.
- Travailler une journée sans commit. Demande un commit après chaque étape réussie.
- Oublier
.envdans le .gitignore. C'est comme ça que des clés secrètes finissent en ligne.
À toi de jouer
Dans ton dossier mon-premier-projet, tape /init, puis complète le CLAUDE.md avec le modèle ci-dessus (au minimum : objectif, public, ton, et les deux règles de sécurité). Ensuite, colle le prompt Git et fais ton premier commit. Note dans ton carnet : « CLAUDE.md fait, premier commit fait ».