Claude Code : Le Setup de l'Expert
Comment je code avec l'IA au quotidien
Sommaire
Un outil vs un écosystème : le vrai pouvoir de Claude Code
La plupart des gens utilisent Claude comme un chatbot : ils posent une question, obtiennent une réponse, copient-collent. C'est comme utiliser une Ferrari pour aller chercher le pain. Claude Code n'est pas un chatbot -- c'est un agent autonome qui vit dans votre terminal, lit votre codebase, exécute des commandes, modifie des fichiers, lance des tests, et peut mener a bien des tâches complexes de bout en bout. La différence entre utiliser Claude.ai et Claude Code, c'est la différence entre envoyer un SMS à un architecte et l'avoir physiquement dans votre bureau avec accès à tous vos plans. Ce chapitre vous montre comment configurer cet écosystème pour en tirer le maximum, pas comme un débutant qui découvre, mais comme un expert qui piloté.
Claude Code n'est pas un meilleur ChatGPT. C'est une catégorie d'outil complètement differente. Un agent qui agit dans votre environnement, pas un chatbot qui répond dans une bulle.
Installation : terminal, npm et clé API
L'installation de Claude Code se fait en quelques minutes via npm. La commande `npm install -g @anthropic-ai/claude-code` installe l'outil globalement. Ensuite, vous lancez `claude` dans n'importe quel répertoire de projet et vous êtes pret. La première fois, Claude Code vous demandera de vous authentifier -- soit via votre compte Anthropic (abonnement Max), soit via une clé API. Pour un usage professionnel sérieux, je recommande la clé API : elle offre plus de contrôle sur les coûts et la consommation. Une fois installe, Claude Code a accès à votre système de fichiers, peut exécuter des commandes shell, et comprend le contexte de votre projet. C'est cette intégration profonde avec l'environnement local qui le rend si puissant.
Prérequis : Node.js 18+, npm, un terminal (iTerm2, Warp, ou le terminal VS Code)
Installation : npm install -g @anthropic-ai/claude-code
Authentification : clé API Anthropic ou abonnement Claude Max
Lancement : taper `claude` dans le répertoire de votre projet
Mise a jour : npm update -g @anthropic-ai/claude-code
Architecture de Claude Code
CLAUDE.md : le fichier le plus important de votre projet
Le CLAUDE.md est le fichier de configuration qui transforme Claude Code d'un assistant générique en un expert de votre projet. C'est un fichier Markdown place à la racine de votre repository qui contient toutes les instructions, conventions, et connaissances que Claude doit avoir pour travailler efficacement sur votre codebase. Pensez-y comme le README ultime, non pas pour les humains, mais pour l'IA. Un bon CLAUDE.md contient les commandes de build/test/lint, l'architecture du projet, les conventions de code, les patterns a suivre, les erreurs a éviter, et les décisions architecturales clés. C'est le fichier qui fait la différence entre un agent qui tâtonne et un agent qui exécute avec précision. Si vous ne retenez qu'une seule chose de ce chapitre, que ce soit celle-ci : investissez du temps dans votre CLAUDE.md.
Le CLAUDE.md est votre ROI le plus élevé en IA. 30 minutes investies dans un bon CLAUDE.md vous font gagner des heures sur chaque interaction avec Claude Code. C'est du context engineering applique.
Anatomie d'un CLAUDE.md efficace
Un CLAUDE.md efficace suit une structure précise. Il commence par les commandes essentielles : comment lancer le serveur de dev, builder le projet, lancer les tests, et linter le code. Ensuite vient l'architecture : structure des répertoires, patterns utilises, technologies et leurs versions. Puis les conventions : style de code, conventions de nommage, patterns obligatoires, anti-patterns a éviter. Enfin, les spécificités du projet : décisions architecturales, workarounds connus, APIs externes, variables d'environnement. L'erreur classique est d'écrire un CLAUDE.md trop générique ou trop exhaustif. Le fichier doit être actionnable : chaque information doit aider Claude a prendre de meilleures décisions. Testez votre CLAUDE.md en donnant une tâche a Claude Code -- si le résultat est mauvais, c'est votre CLAUDE.md qui est insuffisant.
Section 1 - Commands : dev, build, test, lint (les commandes que Claude exécutera)
Section 2 - Architecture : structure des dossiers, patterns, stack technique
Section 3 - Conventions : nommage, style, imports, formatage
Section 4 - Key Patterns : patterns recurrents avec exemples de code
Section 5 - Specifics : variables d'env, APIs, workarounds, décisions architecturales
Anatomie d'un fichier CLAUDE.md
CLAUDE.md d'équipe vs CLAUDE.md de projet
Claude Code supporte plusieurs niveaux de CLAUDE.md, et comprendre cette hierarchie est crucial pour une utilisation en équipe. Le CLAUDE.md à la racine du projet (commite dans le repo) contient les instructions partagees par toute l'équipe : architecture, conventions, commandes. Mais chaque développeur peut aussi avoir un CLAUDE.md personnel dans ~/.claude/ qui contient ses préférences individuelles : style de commit, raccourcis personnels, workflows spécifiques. Il existe aussi des CLAUDE.md au niveau des sous-répertoires pour des instructions spécifiques à un module. Cette hierarchie permet de séparer ce qui est collectif (architecture, conventions) de ce qui est personnel (préférences, workflow). En équipe, le CLAUDE.md du projet devient un artefact de documentation vivante que tout le monde maintient -- c'est souvent mieux maintenu que le README classique parce que son impact est immédiat et mesurable.
Le CLAUDE.md de projet est commite et partage. Le CLAUDE.md personnel (~/.claude/) contient vos préférences. Les CLAUDE.md de sous-dossiers ajoutent du contexte spécifique à chaque module. Utilisez les trois.
Mémoire persistante : comment Claude se souvient
L'un des problèmes fondamentaux des chatbots IA est l'absence de mémoire entre les conversations. Claude Code resout ce problème avec un système de mémoire persistante sophistique. Il existe quatre types de mémoire. Premièrement, le CLAUDE.md qui est charge automatiquement à chaque session. Deuxièmement, la mémoire automatique : quand vous dites a Claude 'souviens-toi de ca', il l'écrit dans un fichier de mémoire persistant (~/.claude/projects/). Troisièmement, les fichiers du projet eux-mêmes qui servent de mémoire contextuelle. Quatrièmement, les conversations passees accessibles via l'historique. Cette mémoire multicouche signifie que Claude Code apprend et s'améliore au fil du temps sur votre projet. Plus vous travaillez avec lui, plus il comprend vos préférences, votre architecture, et vos patterns. C'est un cercle vertueux que les simples chatbots ne peuvent pas reproduire.
CLAUDE.md : instructions statiques, chargees à chaque session
Auto-memory (~/.claude/projects/) : notes dynamiques, ajoutees via 'souviens-toi'
Fichiers projet : le code et la documentation comme mémoire contextuelle
Historique : conversations passees accessibles et reutilisables
Skills et slash commands : etendre Claude Code
Les skills et slash commands sont le système d'extension de Claude Code. Les slash commands natifs (/commit, /review-pr, /init) offrent des workflows pre-construits pour les tâches courantes. Mais le vrai pouvoir vient des skills custom : des prompts paramètres que vous pouvez créer et partager. Un skill est essentiellement un prompt template avec des instructions spécifiques que Claude exécute quand vous l'invoquez. Par exemple, vous pouvez créer un skill /audit-perf qui analyse systématiquement la performance d'un composant React selon vos criteres, ou un skill /create-component qui génère un nouveau composant selon vos conventions exactes. Les skills sont stockes dans des fichiers Markdown et peuvent être partages avec votre équipe via le repository. C'est le moyen le plus puissant de standardiser les workflows IA dans une équipe de développement.
/commit : génère un message de commit structure à partir des changements
/review-pr : analyse une pull request avec des suggestions détaillées
/init : génère un CLAUDE.md initial pour un nouveau projet
Skills custom : vos propres workflows paramètres, partageables en équipe
Combinaison : chainez plusieurs skills pour des workflows complexes
Hooks : automatiser avant et après chaque action
Les hooks de Claude Code sont un mécanisme d'automatisation qui exécute des actions avant ou après certains événements. Pensez-y comme les git hooks, mais pour l'agent IA. Un hook PreToolUse peut valider ou modifier une commande avant son exécution -- par exemple, empecher Claude de modifier certains fichiers sensibles ou forcer un format de commit spécifique. Un hook PostToolUse peut déclencher des actions après une modification -- lancer automatiquement les tests après chaque édition de fichier, ou notifier l'équipe via Slack quand un fichier critique est touche. Les hooks se configurent dans le fichier settings.json de Claude Code et s'exécutent dans le contexte du projet. C'est le mécanisme qui permet de passer d'un agent autonome à un agent supervise avec des garde-fous automatiques. Pour un usage professionnel, les hooks sont non-négociables.
Les hooks sont les garde-fous de votre agent IA. Sans eux, vous donnez les clés de votre codebase à un agent autonome sans supervision. Avec eux, vous avez un agent puissant ET contrôle.
Context engineering : le vrai game changer de 2026
Si le prompt engineering est l'art de poser la bonne question, le context engineering est l'art de créer l'environnement dans lequel la question est posee. Avec Claude Code, le context engineering prend une dimension complètement nouvelle. Votre CLAUDE.md, votre mémoire persistante, vos skills, vos hooks -- tout cela constitue le contexte dans lequel Claude opère. Un expert en context engineering ne se contente pas d'écrire de bons prompts : il configure un écosystème entier ou même un prompt médiocre produit d'excellents résultats. C'est la différence entre donner des instructions à un stagiaire (prompt engineering) et créer un environnement de travail ou même un stagiaire moyen performe bien (context engineering). En 2026, le context engineering est devenu la compétence numéro un pour tirer parti de l'IA, surpassant largement le simple prompt engineering.
Le prompt engineering optimise une question. Le context engineering optimise tout l'environnement. C'est la différence entre améliorer une recette et construire une cuisine professionnelle.
Du prompt engineering au context engineering : le changement de paradigme
Le prompt engineering vous dit 'écrivez de meilleurs prompts'. Le context engineering vous dit 'construisez un meilleur environnement pour que n'importe quel prompt fonctionne bien'. Ce changement de paradigme est fondamental. Avec Claude Code, vous n'écrivez plus des prompts isoles -- vous construisez un système. Votre CLAUDE.md définit les règles du jeu. Vos fichiers de mémoire stockent les leçons apprises. Vos skills encapsulent les workflows repetes. Vos hooks assurent la qualité et la sécurité. Quand tout cela est en place, vous pouvez donner des instructions simples et obtenir des résultats exceptionnels, parce que le contexte fait le travail lourd. C'est comme la différence entre crier des ordres à un étranger dans la rue et parler à un collegue qui connait votre entreprise, vos processus et vos préférences depuis 5 ans.
Prompt engineering : optimiser chaque interaction individuellement
Context engineering : optimiser l'environnement pour que toutes les interactions soient meilleures
CLAUDE.md = les règles du jeu permanentes
Mémoire persistante = les leçons apprises accumulees
Skills + hooks = les workflows automatises et les garde-fous
Workflow expert pour chaque nouveau projet
Voici le workflow que j'applique systématiquement quand je démarre un nouveau projet avec Claude Code. Étape 1 : créer le CLAUDE.md avec les commandes, l'architecture, les conventions et les patterns clés. Étape 2 : configurer la mémoire persistante avec les préférences récurrentes (style de code, format de commit, stack technique). Étape 3 : installer les skills pertinents pour le type de projet (web, mobile, API). Étape 4 : configurer les hooks de sécurité (protection des fichiers sensibles, tests automatiques). Étape 5 : faire une première tâche simple pour vérifier que tout fonctionne. Étape 6 : itérer sur le CLAUDE.md en fonction des résultats. Ce workflow prend environ 30 minutes a mettre en place, mais il change fondamentalement la qualité de chaque interaction qui suit. C'est un investissement initial qui se rembourse des la première heure de travail avec Claude Code.
Étape 1 : CLAUDE.md -- commandes, architecture, conventions (15 min)
Étape 2 : Mémoire persistante -- préférences, stack, patterns (5 min)
Étape 3 : Skills -- installer/créer les skills pertinents (5 min)
Étape 4 : Hooks -- sécurité, tests auto, garde-fous (5 min)
Étape 5 : Test -- une tâche simple pour valider le setup
Étape 6 : Iteration -- affiner le CLAUDE.md en continu
Exemple concret : ce portfolio
Ce portfolio que vous consultez en ce moment a été développé en grande partie avec Claude Code. Le CLAUDE.md à la racine du projet contient toute l'architecture Next.js 16, les conventions de code, les commandes de build et de test, les patterns de composants, et les spécificités de l'intégration Vercel Blob. Quand je demande a Claude Code 'crée un nouveau chapitre de cours UX', il sait exactement quelle structure de fichiers créer, quel format de données utiliser, quels composants reutiliser, et comment intégrer le tout dans le système de navigation existant. Ce n'est pas de la magie -- c'est un CLAUDE.md bien écrit. Le résultat : chaque nouveau chapitre prend 10 minutes de setup technique au lieu de 2 heures. Le temps economise est reinvesti dans la qualité du contenu, pas dans la plomberie technique.
Ce portfolio est la preuve vivante de l'approche context engineering. Chaque page de cours que vous lisez a été scaffoldee par Claude Code en quelques minutes grace à un CLAUDE.md de 50 lignes.
Astuces avancées : devenir un power user
Quelques techniques avancées qui séparent les utilisateurs réguliers des power users de Claude Code. Premièrement, utilisez le mode headless (`claude -p 'votre prompt'`) pour intégrer Claude Code dans des scripts et des pipelines CI/CD -- vous pouvez automatiser des code reviews, des générations de documentation, ou des migrations de code. Deuxièmement, utilisez les conversations longues stratégiquement : au lieu de démarrer une nouvelle conversation pour chaque tâche, gardez le contexte d'une session de travail complète pour que Claude comprenne l'evolution du projet. Troisièmement, exploitez le multi-turn : décomposez les tâches complexes en étapes et validez chaque étape avant de passer à la suivante. Quatrièmement, connectez Claude Code à vos outils externes via MCP (le chapitre suivant). Cinquièmement, créez des templates de CLAUDE.md par type de projet pour bootstrapper encore plus vite.
Mode headless : `claude -p` pour l'intégration dans des scripts et CI/CD
Conversations longues : garder le contexte d'une session de travail complète
Multi-turn : décomposer, valider, itérer étape par étape
MCP : connecter Claude Code a GitHub, Figma, Slack, bases de données
Templates CLAUDE.md : un template par type de projet (web, API, mobile)
Conclusion : Claude Code comme cockpit de développement
Claude Code n'est pas un outil de plus dans votre boite a outils -- c'est un changement de paradigme dans la façon de développer. Avec un CLAUDE.md bien écrit, une mémoire persistante configurée, des skills custom et des hooks de sécurité, vous transformez un chatbot générique en cockpit de piloté sur mesure pour votre projet. L'investissement initial de 30 minutes de configuration se rembourse exponentiellement : chaque interaction est plus rapide, plus précise, plus alignee avec vos standards. Le prochain chapitre explore MCP, le protocole qui permet de connecter Claude Code à l'ensemble de votre stack technique -- GitHub, Figma, Slack, bases de données -- et de le transformer en orchestrateur central de votre workflow de développement.