Introduction
Claude Code (Anthropic) n’est pas “juste un chatbot dans un terminal” : c’est un outil agentique capable de lire votre codebase,
exécuter des commandes, modifier des fichiers et enchaîner des actions. Pour obtenir des résultats fiables, il faut le piloter
avec une méthode : planification, contexte, standards et automatisation.
1) La règle d’or : planifier avant d’exécuter (Plan Mode)
Le piège classique : demander une fonctionnalité et laisser l’outil partir coder immédiatement. La pratique la plus robuste consiste à
séparer exploration / architecture et implémentation.
- Activez Plan Mode (Shift+Tab pour cycler les modes) : Claude analyse et propose un plan sans modifier le repo.
- Demandez un plan explicite (architecture, fichiers impactés, étapes, risques, stratégie de tests).
- Validez le plan, puis seulement ensuite basculez en exécution.
👉 Référence : workflows et Plan Mode dans la doc officielle Claude Code.
Voir la doc “Common workflows”
2) CLAUDE.md : votre “contrat” de projet
Le fichier CLAUDE.md est automatiquement injecté en contexte au démarrage d’une session : c’est l’endroit idéal pour fixer
les règles de jeu (stack, conventions, commandes, tests, pièges connus). L’objectif : réduire les aller-retours et éviter les écarts.
- Concis et actionnable : commandes essentielles, conventions de code, règles de contribution.
- Expliquez le “pourquoi” (ex. “mode strict TS pour éviter les régressions”).
- Mettez à jour dès qu’une correction revient deux fois : elle doit devenir une règle.
# CLAUDE.md (exemple minimal)
## Stack & contraintes
- TypeScript strict, ESLint, Prettier
- API: /api/* ; routes protégées sous /api/protected
## Commandes
- pnpm test:unit
- pnpm lint
- pnpm typecheck
## Règles
- PR petites, commits descriptifs
- Toujours proposer un plan avant refactor multi-fichiers
- Ne pas introduire de nouvelle lib sans justification
👉 Référence : bonnes pratiques officielles Anthropic.
Lire “Claude Code: Best practices”
3) Contexte : éviter l’effet “conversation qui s’enlise”
Même un excellent modèle se dégrade quand le contexte devient bruité (trop de branches, détails obsolètes, logs, digressions).
La solution n’est pas “parler plus”, c’est structurer.
- 1 conversation = 1 objectif (feature, bug, refacto). Stop au multi-sujets.
- Sous-agents pour la recherche/exploration afin de limiter la pollution du fil principal.
- /compact pour résumer et réduire le contexte quand ça devient lourd.
- /clear pour repartir sur une base propre en recopiant uniquement l’essentiel (plan, contraintes, checklist).
👉 Références : slash commands (dont /compact) et bonnes pratiques (workflows + subagents).
Doc “Slash commands”
4) Industrialiser la qualité : Hooks (formatage, tests, garde-fous)
Les hooks transforment des “rappels” en règles exécutées automatiquement à des moments clés du cycle agentique.
Exemples : lancer Prettier après chaque édition, déclencher des tests, bloquer certains répertoires, ajouter des validations.
- Automatic formatting : Prettier/gofmt après chaque Write/Edit.
- Feedback : alerter si le code ne respecte pas les conventions.
- Custom permissions : empêcher des modifications sensibles (prod, secrets, etc.).
👉 Référence : guide Hooks + sécurité.
Get started with hooks
5) Skills & commandes : standardiser sans gonfler le contexte
Pour les workflows répétables, stockez vos “routines” dans .claude/commands (slash commands) et vos capacités structurées
dans .claude/skills (Skills). L’outil Skill peut ensuite les invoquer automatiquement quand c’est pertinent,
avec un budget de contexte limité (pratique pour rester léger).
- Slash commands : templates rapides (review, explain, optimize…).
- Skills : workflows multi-étapes + scripts + checklists + docs projet.
- Permissions : gardez un contrôle fin sur ce que Claude peut faire automatiquement.
👉 Référence : Skill tool, budget, et “Skills vs slash commands”.
Doc “Slash commands / Skill tool”
6) Aller plus loin : connecter vos outils avec MCP
Le Model Context Protocol (MCP) permet de connecter Claude Code à des outils et sources (GitHub, Jira, DB, Notion, etc.)
via des serveurs MCP, pour éviter le “copier-coller” et travailler sur des données vivantes.
- Centralisez l’accès à vos outils (tickets, PR, docs, observabilité).
- Réduisez les erreurs : la source de vérité est interrogée directement.
- Accélérez les boucles : recherche + action + validation.
👉 Références :
Connect Claude Code via MCP
|
Annonce MCP (Anthropic)
Vidéo à intégrer
Démo / explications : Plan Mode, contexte, workflow et bonnes pratiques.
Checklist rapide (setup robuste en 15 minutes)
- Créer/mettre à jour CLAUDE.md (commandes, style, tests, règles).
- Travailler en Plan Mode par défaut sur tout sujet non-trivial.
- Découper : 1 thread = 1 objectif. Utiliser /compact quand ça s’alourdit.
- Ajouter des hooks (formatage + tests) pour rendre la qualité déterministe.
- Standardiser avec slash commands + skills.
- Connecter l’essentiel via MCP (GitHub/Jira/Docs) si vous passez en prod.
Conclusion
Claude Code devient vraiment puissant quand vous le traitez comme un système : un cadre (CLAUDE.md), une méthode (Plan Mode),
un contexte maîtrisé (/compact, /clear, sous-agents), et de l’automatisation (hooks, skills, MCP).
Résultat : moins d’aléatoire, plus de vitesse, et surtout des livrables robustes.
