Section 2 — Claude Code et l'écosystème

Introduction Claude MD

Capsule 9 min Type pratique Modalité e-learning Niveau perfectionnement

Objectif opérationnel

À l'issue de cette leçon, le stagiaire comprend le rôle d'un fichier CLAUDE.md pour donner à Claude Code le contexte d'un projet, et sait rédiger son premier CLAUDE.md selon une structure en six rubriques.

§ 01

Bienvenue en section 2

Cette leçon marque la bascule de la formation. La section 1 (leçons 1 à 10) a couvert claude.ai — l'interface conversationnelle web qui couvre 90 % des usages bureautiques. La section 2 (leçons 11 à 20) couvre Claude Code et l'écosystème agentique — l'outil en ligne de commande qui donne à Claude l'accès au système de fichiers, à votre terminal, et à votre environnement de développement.

Ne soyez pas effrayé par le changement de surface. Claude Code n'est pas réservé aux développeurs. Toute personne qui travaille avec des fichiers locaux (documents, dossiers de projet, exports comptables, archives) peut en tirer profit. La logique reste la même que sur claude.ai : on parle à Claude, il agit. La différence : il agit sur votre système, pas uniquement dans une conversation isolée.

§ 02

Le fichier CLAUDE.md — onboarding de l'agent

CLAUDE.md est un fichier texte simple, placé à la racine d'un projet, qui donne à Claude Code le contexte de ce projet. C'est l'équivalent fonctionnel de ce que sont les Instructions dans un Project de claude.ai : un brief permanent que Claude lit à chaque session.

La différence : sur claude.ai, les Instructions sont stockées par Anthropic dans votre compte. Sur Claude Code, le CLAUDE.md vit dans votre projet (sur votre disque, dans votre dépôt Git si vous en avez un). Il est versionnable, partageable avec une équipe, modifiable comme n'importe quel fichier.

Convention de nommage

Le fichier doit s'appeler exactement CLAUDE.md — en majuscules, extension .md (Markdown). Claude Code le détecte automatiquement à chaque démarrage dans le dossier courant. Pas de paramétrage à faire.

§ 03

Six rubriques pour un CLAUDE.md utile

Comme pour les Instructions d'un Project (leçon 4 bis), la qualité du CLAUDE.md fait la qualité de l'usage. Une rédaction soignée transforme l'expérience ; une rédaction bâclée explique 80 % des déceptions sur Claude Code.

1. Vue d'ensemble (3 lignes)

Que fait ce projet, pour qui, dans quel contexte. Trois lignes suffisent. Sans cela, Claude ne peut pas se projeter dans le projet.

2. Stack technique

Langages, frameworks, outils. Exemples : Python 3.12 + FastAPI, Next.js 14, Excel + macros VBA, dossier Markdown. Permet à Claude d'écrire dans le bon style.

3. Commandes utiles

Comment lancer les tests (npm test), démarrer le serveur, déployer. Format : commande + une ligne d'explication. Évite que Claude réinvente à chaque fois.

4. Conventions de code

Naming, formatage, patterns à respecter. Si vous avez un style guide ou un linter, mentionnez-le. Permet à Claude de produire du code qui s'intègre dans l'existant.

5. Pièges connus

Les choses contre-intuitives sur le projet : « ce dossier est généré automatiquement », « cette fonction est dépréciée », « ce test est instable ». Évite les erreurs récurrentes.

6. Ne pas faire

Comme pour les Instructions de Project, les « ne fais pas » sont souvent plus efficaces que les « fais ». Listez ce qui doit absolument être évité dans le projet.

§ 04

Exemple — CLAUDE.md d'un projet réel

# Projet — Cabinet PEDETTI · Formation Claude 7 h

## Vue d'ensemble
Cabinet de conseil en formation IA. Production de modules de
formation Claude pour cadres et dirigeants. Public : non-techniques.

## Stack
- HTML/CSS statique pour les leçons éditoriales
- Node.js pour le builder de leçons
- Polices : Fraunces, Manrope, JetBrains Mono (Google Fonts)
- Charte : ivoire / encre / terracotta / sage / gold

## Commandes
- node generate.js : génère une leçon depuis sa définition
- npm run validate : valide les balises HTML

## Conventions
- Toujours adresser le stagiaire en vouvoyant
- Signature : « Cabinet PEDETTI »
- Ton : sobre, factuel, sans emojis

## Pièges connus
- Les fichiers dans /distribution sont générés — ne pas éditer
- Le builder ne supporte pas les caractères Unicode emojis

## Ne pas faire
- Ne pas utiliser de tournures commerciales (« optimisez », « boostez »)
- Ne pas mentionner « YOAT Academy » (nom obsolète, c'est YOAT Lab)

Cet exemple fait 25 lignes. C'est l'ordre de grandeur cible : une à deux pages maximum. Un CLAUDE.md de 5 pages que personne ne maintient est moins utile qu'un d'une page tenu à jour.

§ 05

Hiérarchie de CLAUDE.md

Claude Code lit plusieurs CLAUDE.md selon une hiérarchie qu'il faut connaître. Cela permet d'avoir des conventions globales et des spécificités par sous-projet, sans répétition.

Trois niveaux possibles

Niveau utilisateur : ~/.claude/CLAUDE.md — vos préférences personnelles, lu sur tous vos projets (votre style, vos signatures, votre langue).
Niveau projet (racine) : ./CLAUDE.md — le contexte du projet, lu pour toutes les opérations dans ce dossier.
Niveau sous-projet : ./module-frontend/CLAUDE.md — spécificités d'un module, lu pour les opérations dans ce sous-dossier.

Claude lit du plus spécifique au plus général. Les conventions d'un sous-CLAUDE.md écrasent celles du projet, qui écrasent celles de l'utilisateur. Pratique pour avoir des règles communes et des exceptions ciblées.

§ 06

Versionner et partager

Pour les projets travaillés à plusieurs ou simplement archivés, le CLAUDE.md doit être versionné dans Git comme tout autre fichier du projet. Le fichier vit avec le code. Toute modification passe par la même revue que le code.

C'est ce qui en fait un asset d'équipe et pas seulement un fichier personnel. Quand un nouveau collègue rejoint un projet, il lit le CLAUDE.md pour comprendre les conventions et les pièges. Quand vous reprenez un projet six mois plus tard, le CLAUDE.md vous rafraîchit la mémoire.

Exercice — appropriation

Rédiger un premier CLAUDE.md

Choisissez un dossier de votre disque dur sur lequel vous travaillez actuellement — code, documents projet, dossier client. Rédigez son CLAUDE.md avec les six rubriques (vue d'ensemble, stack, commandes, conventions, pièges, ne pas faire). Si vous travaillez en équipe, faites-le relire par un collègue qui connaît ce dossier ; sinon, relisez-le vous-même à 24 h d'intervalle. Notez ce qui manquait ou ce qui était mal formulé.

Cet exercice est à conserver dans votre dossier de stagiaire. Il n'est pas évalué mais il est tracé.

Sources officielles consultées

docs.claude.com/claude-code documentation Claude Code complète
docs.claude.com — Claude Code Memory documentation du fichier CLAUDE.md et hiérarchie

Vous comprenez le rôle de CLAUDE.md et savez rédiger un premier brief en six rubriques ?