YOAT Lab
Cabinet PEDETTI · Formation Claude · Maîtrise
Module 1 · 3 leçons
Environnement de développement
Module 1 — Environnement de développement

Initialisation d'un projet

Capsule 5 min Type pratique Modalité e-learning Niveau maîtrise
Objectif opérationnel

À l'issue de cette leçon, le stagiaire sait démarrer un vrai projet Claude Code : créer un dossier de travail à un emplacement structuré, y initialiser un fichier CLAUDE.md de démarrage, et lancer une première session opérationnelle.

§ 01

Le dossier de travail — où vivent les projets

Un projet Claude Code vit dans un dossier de votre disque. Ce dossier contient les fichiers du projet — code, documentation, ressources — et un fichier CLAUDE.md à sa racine. Quand vous lancez la commande claude depuis ce dossier, l'agent reçoit automatiquement le contexte qui s'y trouve.

L'organisation des projets sur votre disque conditionne durablement votre confort de travail. Bonne pratique éprouvée : un dossier Projects à la racine de votre dossier utilisateur, qui regroupe tous vos projets en sous-dossiers nommés explicitement. Pas de projets éparpillés sur le bureau, dans Téléchargements, ou dans des sous-dossiers obscurs.

Discipline d'organisation

Cette discipline simple vous épargne, dans six mois, de chercher où vous aviez rangé tel ou tel projet. Elle facilite aussi les sauvegardes ciblées (un seul dossier à inclure) et le passage d'une machine à l'autre. Adoptez-la dès le premier projet, même si vous n'en avez qu'un seul aujourd'hui.

§ 02

Créer le dossier et s'y déplacer

Le geste se fait en une commande qui combine création et déplacement. Adaptez le chemin à votre OS.

  1. Créer le dossier projet et s'y déplacer immédiatement. La syntaxe enchaîne mkdir (création) et cd (déplacement) en une seule ligne.

    macOSmkdir -p ~/Projects/mon-projet && cd ~/Projects/mon-projet. Le flag -p crée aussi les dossiers parents si nécessaire.
    Windowsmkdir $env:USERPROFILE\Projects\mon-projet ; cd $env:USERPROFILE\Projects\mon-projet. Le point-virgule sépare deux commandes PowerShell.
  2. Créer un CLAUDE.md minimal. Pour l'instant, juste un titre — on l'enrichira dans la leçon suivante consacrée à ce fichier. La redirection > crée le fichier avec le contenu spécifié.

    macOSecho "# Mon projet" > CLAUDE.md
    Windowsecho "# Mon projet" > CLAUDE.md (identique en PowerShell moderne)
§ 03

Premier lancement de Claude Code

Le dossier est prêt, le CLAUDE.md est en place. On lance la session. Claude lit automatiquement le CLAUDE.md, indexe rapidement les fichiers du dossier sans tout lire (juste pour avoir une carte de l'organisation), et attend votre première instruction.

$ claude

# Claude démarre la session
# Détecte CLAUDE.md, indexe l'arborescence

Claude > Bonjour, j'ai lu votre CLAUDE.md. Comment puis-je vous aider ?

# Test de bon fonctionnement :
> Quel est l'objectif de ce projet selon le CLAUDE.md ?

# Claude répond en se basant sur votre fichier
# → confirme que le contexte est bien chargé

Pour quitter la session, vous tapez /exit. Vous pouvez relancer la session plus tard depuis le même dossier — la conversation sera nouvelle (Claude Code ne garde pas l'historique d'une session à l'autre par défaut), mais le contexte du CLAUDE.md sera rechargé automatiquement.

§ 04

Structurer son arborescence

Au fur et à mesure que le projet grandit, son arborescence doit rester lisible. Trois patterns d'organisation qui fonctionnent bien selon le type de projet :

Projet web simple

~/Projects/mon-site/ contient CLAUDE.md, README.md, index.html, style.css, script.js, et un sous-dossier assets/ pour les images et fichiers statiques.

Projet applicatif (Next.js, etc.)

~/Projects/mon-app/ avec la structure standard du framework. CLAUDE.md à la racine. Les sous-dossiers src/, public/, tests/ sont créés par les outils.

Projet d'écriture ou de documentation

~/Projects/mon-livre/ avec CLAUDE.md, chapitres/ pour les fichiers Markdown, ressources/ pour les images et références, exports/ pour les versions PDF générées.

Multi-projets

Si plusieurs projets se ressemblent, créez un sous-niveau : ~/Projects/clients/cabinet-pedetti/, ~/Projects/clients/autre-client/. Chacun avec son propre CLAUDE.md.

Exercice — appropriation

Démarrer un projet réel cette semaine

Choisissez un projet réel à démarrer cette semaine, ou un dossier d'organisation personnelle (notes, archives, suivi). Suivez la procédure complète : création du dossier dans ~/Projects/, rédaction d'un CLAUDE.md initial (même minimal), premier lancement de Claude Code, première interaction de test. Notez ce que vous avez écrit dans le CLAUDE.md de départ — vous y reviendrez quand le projet grossira.

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

Sources officielles consultées

Vous savez créer un dossier projet structuré, y placer un CLAUDE.md initial, et lancer une première session Claude Code dedans ?