Initialiser un projet Claude Code
Un dossier propre, un fichier CLAUDE.md de démarrage,
et la première vraie session de travail avec l'agent.
Le projet est l'unité de travail de Claude Code
Claude Code travaille à l'échelle du dossier. Quand vous lancez la commande claude depuis un répertoire, ce dossier devient son périmètre de lecture et d'action. Pas de mémoire entre projets, pas de croisement entre dossiers. Tout commence par bien définir cet espace.
Ne lancez jamais Claude Code depuis votre racine utilisateur ou votre Bureau. Toujours depuis un dossier projet dédié, avec un nom clair, dans un emplacement stable. C'est ce qui distingue un usage propre d'une cuisine qui devient vite ingérable.
Un dossier Projects centralisé
Tous vos projets Claude Code dans un seul dossier parent. Une convention simple qui vous évitera de chercher où vous avez mis quoi dans six mois.
~/Projects/
Dans votre dossier home. Chaque projet en sous-dossier : ~/Projects/mon-app/, ~/Projects/dashboard-client/, etc.
%USERPROFILE%\Projects\
Dans votre profil utilisateur. Chaque projet en sous-dossier. Évitez les espaces et caractères accentués dans les noms.
Cette convention n'est pas obligatoire mais elle s'impose dès qu'on dépasse deux ou trois projets. Adoptez-la tout de suite, c'est gratuit.
Du mkdir à Claude qui comprend
Créer la structure
mkdir mon-app && cd mon-app puis git init. La base est posée.
Écrire CLAUDE.md
Stack, conventions, architecture, à ne pas faire. Le contrat avec Claude pour ce projet.
Vérifier l'arborescence
tree -L 2 pour visualiser. CLAUDE.md, src/, tests/, .gitignore, .env.example.
Lancer claude
Première commande claude dans le dossier. CLAUDE.md détecté, contexte chargé.
Quatre commandes pour tout poser
mkdir -p ~/Projects/mon-projet && cd ~/Projects/mon-projet. Vous êtes maintenant dans un dossier vide, prêt à recevoir vos premiers fichiers.git init. C'est facultatif au tout début, mais devient indispensable dès qu'on touche à du code sérieux. Avec Git, chaque modification de Claude peut être inspectée et annulée.touch CLAUDE.md (macOS/Linux) ou New-Item CLAUDE.md (Windows). Ce fichier est l'équivalent des Instructions des Projects sur claude.ai : Claude le lit au démarrage de chaque session.claude. Claude détecte le CLAUDE.md s'il existe, le lit, et démarre la session avec ce contexte. Vous êtes prêt à travailler.Le contexte permanent de votre projet
CLAUDE.md est l'équivalent technique des Instructions de Projects sur claude.ai. Claude Code le lit au début de chaque session et le garde présent à l'esprit tout au long du travail. Bien rédigé, il évite de réexpliquer le contexte à chaque interaction.
Contexte du projet
Une à trois phrases sur ce que le projet fait et pour qui. Évite les hallucinations sur la finalité.
Stack technique
Langages, frameworks, bibliothèques principales. Versions si elles comptent (Node 20, Python 3.12).
Conventions de code
Style préféré, nommage des fichiers, organisation des dossiers. Préciser ce qui vous tient à cœur.
Contraintes et préférences
Choses à ne pas faire (ne pas créer de tests inutiles, ne pas ajouter de bibliothèques sans demander, etc.)
Un modèle de départ
# Projet — Dashboard client X ## Contexte Tableau de bord interne pour suivre les missions en cours et les indicateurs financiers du cabinet. Utilisateurs : équipe de 5 personnes, profil gestionnaire. ## Stack - React 18 + Vite 5 - Supabase (Postgres + Auth) - Tailwind CSS + shadcn-ui - Node 20 LTS ## Conventions - Composants en PascalCase, hooks en camelCase - Un composant par fichier - Pas de fichier index.js dans les dossiers ## Contraintes - Pas d'ajout de bibliothèques sans demander d'abord - Pas de console.log laissés en production - Toujours expliquer le pourquoi avant le code
Commencez avec un CLAUDE.md court (10 à 20 lignes). Enrichissez-le au fil des sessions quand vous remarquez que Claude oublie systématiquement la même chose. C'est un document vivant, pas une charte définitive.
Trois réflexes dès maintenant
Activer le mode plan d'emblée
Shift+Tab à l'entrée de session. Cela évite que Claude commence à créer des fichiers avant que vous ayez validé sa compréhension.
Premier commit immédiat
Dès qu'un état fonctionne, faire un git commit. Cela crée un point de retour si une étape suivante casse quelque chose.
Une session = un objectif
Ne pas mélanger ajout de fonctionnalité, correction de bug et refactoring dans la même session. Ouvrir une nouvelle session par objectif.
Quiz · Initialisation d'un projet
8 questions · une seule bonne réponse par question · vous pouvez recommencer autant de fois que nécessaire.