14.1 — Initialisation du projet
Tout commence par un dossier vide et trois décisions fondamentales : la structure du repository, le contenu du CLAUDE.md, et les permissions dans settings.json. Ces trois éléments déterminent la qualité de tout ce que Claude Code produira ensuite.
Lance /init dans un nouveau dossier. Claude analyse le repo (vide pour l'instant) et génère un CLAUDE.md de base. Ce squelette est un point de départ, pas un livrable. Enrichis-le immédiatement avec ta stack technique (Node.js + TypeScript + Express + Prisma pour le backend, React + Vite pour le frontend), tes commandes de build et de test, tes conventions de code (TypeScript strict, validation Zod, pas de any), et l'architecture ciblé (routes, services, prisma).
Ensuite, crée .claude/settings.json pour définir la zone de confiance. Autorise les commandes courantes (npm, npx, node, git) et bloque les commandes destructives (rm -rf /, sudo). Depuis la version actuelle de Claude Code, tu peux aussi configurer le fichier à .claude/CLAUDE.md, les deux emplacements sont reconnus.
mkdir todo-fullstack && cd todo-fullstack && git init
claude
# dans Claude Code :
/init
Le CLAUDE.md est lu à chaque nouvelle conversation. Chaque instruction que tu y places est un investissement : elle évite de répéter les mêmes consignes, réduit les erreurs, et oriente Claude vers les bonnes décisions architecturales. Cinq minutes d'initialisation valent des heures de corrections.
À retenir
• Le CLAUDE.md est le levier le plus puissant du projet, il guide chaque interaction future.
• /init donne une base, mais le vrai travail c'est l'enrichissement manuel avec tes conventions.
• Les settings définissent ce que Claude peut faire sans demander : c'est ton périmètre de sécurité.