Claude Code en pratique

Claude Code n’est pas seulement un générateur de code : il accompagne toutes les étapes d’un projet, de la prise en main d’un dépôt à la livraison. Cette leçon montre comment lui donner le contexte du projet, puis les façons de travailler qui donnent les meilleurs résultats.

La commande /init

Sur un nouveau projet, le premier geste est /init. Claude analyse la base de code, puis résume ce qu’il a appris dans un fichier CLAUDE.md : commandes de build et de test, organisation des dossiers, conventions de code. Ce fichier est chargé au début de chaque session : Claude n’a plus à redécouvrir le projet. Relisez-le et corrigez-le : c’est un texte que vous maintenez, pas une vérité.

Plusieurs fichiers CLAUDE.md peuvent coexister, selon leur portée :

Claude tient aussi une mémoire automatique : il note de lui-même ce qui lui servira plus tard, dans un dossier par projet. Quand vous dites « retiens que les tests demandent un Redis local », c’est là que la remarque va ; pour l’inscrire dans CLAUDE.md, demandez-le explicitement. La commande /memory ouvre ces fichiers. Le raccourci # que présente le cours officiel pour écrire dans CLAUDE.md n’existe plus.

Contexte, plan, puis code

Claude Code donne le meilleur de lui-même quand on le traite comme un multiplicateur d’effort : plus vous lui donnez de contexte et de structure, meilleur est le résultat. Le cours officiel recommande trois étapes :

1. Donner le contexte. Repérez les fichiers liés à la fonctionnalité visée et demandez à Claude de les lire d’abord : il y trouvera vos conventions et le code qu’il peut réutiliser.
2. Demander un plan. Avant d’écrire, faites-lui proposer une démarche, en précisant de ne pas coder. Le mode plan le garantit : Claude lit et propose, mais ne modifie rien avant votre accord. On l’active avec Shift+Tab en cours de session, ou avec claude --permission-mode plan.
3. Implémenter. Une fois le plan validé, demandez l’implémentation.

La variante par les tests

Pour un code plus solide, le cours propose de passer par les tests :

1. donner le contexte, comme précédemment ;
2. demander à Claude d’imaginer les cas de test de la fonctionnalité ;
3. lui faire écrire les tests les plus pertinents ;
4. lui demander le code qui les fait passer ; il itère jusqu’à ce qu’ils passent.

Des tests écrits avant le code donnent à Claude un critère de réussite clair, qu’il peut vérifier lui-même.

Un exemple

L’exemple du cours officiel ajoute un outil de conversion de documents à un projet existant :

> Lis les fichiers math.py et document.py

> Prépare un plan pour un outil document_path_to_markdown :
  1. une fonction qui reçoit un chemin de fichier, vérifie qu'il existe,
     déduit le type du fichier de son extension, lit les données binaires
     et réutilise la fonction existante binary_document_to_markdown ;
  2. la documentation ;
  3. l'enregistrement de l'outil dans le serveur MCP ;
  4. des tests.

> Implémente le plan

Claude crée la fonction, met à jour les fichiers, écrit les tests, puis lance la suite de tests pour vérifier son travail.

Quelques commandes utiles

• /init : analyse le projet et produit CLAUDE.md.
• /memory : ouvre les fichiers de mémoire et CLAUDE.md.
• /clear : efface la conversation pour repartir d’un contexte propre.
• /compact : résume la conversation pour libérer du contexte sans tout perdre.

Claude prend aussi en charge les tâches de routine : préparer et créer un commit Git, lancer les tests, gérer les dépendances. Vous restez sur la vue d’ensemble pendant qu’il s’occupe du détail.

À vous de jouer

Contexte, plan, code. Sur un petit projet à vous, lancez /init et corrigez le CLAUDE.md produit. Choisissez ensuite une petite fonctionnalité : faites lire les fichiers concernés, demandez un plan en mode plan, relisez-le, puis faites implémenter et tester.

Sources officielles : Claude Code in action (Claude Academy) · How Claude remembers your project (documentation Claude Code : CLAUDE.md, mémoire automatique) · Common workflows (documentation Claude Code : mode plan)

Points clés à retenir

• /init produit un CLAUDE.md chargé à chaque session ; relisez-le et maintenez-le.
• CLAUDE.md de projet, CLAUDE.local.md personnel, ~/.claude/CLAUDE.md pour tous vos projets ; la mémoire automatique s’y ajoute.
• Contexte, plan, puis code : le mode plan empêche toute modification avant votre accord.
• Écrire les tests d’abord donne à Claude un critère de réussite qu’il vérifie seul.
• Le raccourci # du cours officiel n’existe plus : demandez explicitement d’écrire dans CLAUDE.md, ou passez par /memory.