Les conseils pratiques d’utilisation révélés par le créateur de Claude Code

1. Tirer au maximum parti du travail en parallèle

• Faire tourner simultanément 3 à 5 git worktrees et gérer en parallèle une session Claude distincte pour chacune est, au sein même de l’équipe Claude Code, le meilleur conseil pour gagner en productivité
• Certains préfèrent la méthode git checkout, mais la plupart des membres de l’équipe Claude Code préfèrent les worktrees
  • Cela a conduit à l’ajout d’un support natif des worktrees dans l’application Claude Desktop
• Certains utilisent aussi une convention consistant à nommer les worktrees et à configurer des aliases shell (za, zb, zc) pour basculer d’une simple frappe
• Certains membres de l’équipe maintiennent également un worktree « analysis » dédié à la consultation des logs et à l’exécution de BigQuery

2. Toujours commencer les tâches complexes en Plan Mode

• Les tâches complexes commencent en mode plan, en consacrant de l’énergie à la planification afin d’amener Claude à terminer l’implémentation d’un seul coup
• Une méthode consiste à faire rédiger le plan par un premier Claude, puis à lancer un second Claude pour le relire dans le rôle d’un staff engineer
• Dès qu’une tâche commence à dévier, il est important de revenir immédiatement en mode plan pour replannifier, sans forcer
• Même à l’étape de validation, il est efficace de demander explicitement d’entrer en mode plan

3. Investir en continu dans CLAUDE.md

• À chaque modification, donner l’instruction : « Mets à jour CLAUDE.md pour éviter de répéter la même erreur »
• Claude a tendance à très bien documenter les règles qu’il doit lui-même respecter
• Avec le temps, il faut continuer à faire évoluer CLAUDE.md et répéter jusqu’à ce que le taux d’erreur de Claude baisse de manière mesurable
• Un ingénieur maintient un répertoire notes pour toutes les tâches et tous les projets, demande à Claude de le mettre à jour à chaque PR, et configure CLAUDE.md pour s’y référer

4. Créer ses propres Skills et les commit dans git

Conseils de l’équipe Claude Code :

• Toute tâche répétée au moins une fois par jour doit être transformée en Skill ou en Slash Command
• Créer une slash command /techdebt pour repérer et supprimer le code dupliqué à la fin d’une session
• Mettre en place un ensemble de slash commands qui synchronise 7 jours de Slack, GDrive, Asana et GitHub en un seul dump de contexte
• Créer un agent au style analytics engineer pour écrire des modèles dbt, faire de la revue de code et tester l’environnement de dev
• Pour en savoir plus : Extend Claude with skills

5. Confier les corrections de bugs à Claude

• Activer Slack MCP, coller un thread Slack de bug dans Claude puis taper simplement « fix » permet de corriger sans changer de contexte
• Ou bien se contenter de dire : « Go fix the failing CI tests », et laisser Claude décider de la méthode
• Transmettre les docker logs à Claude pour l’utiliser en troubleshooting de systèmes distribués — il s’en sort de façon étonnamment efficace

6. Monter le niveau des prompts

• Donner l’instruction : « Passe cette modification en revue de manière stricte, et ne crée pas de PR tant que je n’ai pas validé les tests » pour utiliser Claude comme relecteur
• Dire : « Prouve-moi que ça fonctionne » et demander un diff du comportement entre la branche main et la branche feature
• Quand le résultat d’une correction reste moyen, dire : « À partir de tout ce que tu as appris jusque-là, jette ça et implémente une solution élégante »
• Avant de déléguer une tâche, rédiger une spécification détaillée et supprimer toute ambiguïté est essentiel pour améliorer la qualité du résultat

7. Terminal et configuration d’environnement

• L’équipe Claude Code préfère le terminal Ghostty
  • Ses avantages : rendu synchronisé, couleurs 24 bits et prise en charge correcte d’Unicode
• Personnaliser la barre d’état avec /statusline pour toujours afficher l’utilisation du contexte et la branche git courante
• Attribuer des codes couleur et des noms aux onglets du terminal, et utiliser tmux — un onglet par tâche/worktree
• L’usage de la dictée vocale est recommandé
  • On peut parler trois fois plus vite qu’on ne tape, et les prompts deviennent bien plus détaillés
  • Sur macOS, elle s’active en appuyant deux fois sur la touche fn
• Astuce supplémentaire : Optimize your terminal setup

8. Utiliser les sous-agents

• Si vous voulez que Claude mobilise davantage de calcul, ajoutez « use subagents » à votre demande
• Déléguer les tâches individuelles à des sous-agents permet de garder la fenêtre de contexte de l’agent principal propre et concentrée
• Mettre en place un hook qui route les demandes d’autorisation vers Opus 4.5 — après un scan d’attaque, les demandes sûres sont approuvées automatiquement

9. Utiliser Claude pour les tâches de données et d’analyse

• Demander à Claude Code d’utiliser le CLI bq pour récupérer et analyser des métriques à la volée
• Versionner dans le codebase un skill BigQuery pour que toute l’équipe puisse exécuter directement des requêtes d’analyse dans Claude Code
• Certains n’ont pas écrit de SQL eux-mêmes depuis plus de six mois
• Cela s’applique de la même manière à toute base de données disposant d’un CLI, d’un MCP ou d’une API

10. Apprendre avec Claude

• Dans /config, activer le style de sortie « Explanatory » ou « Learning » pour que Claude explique le pourquoi des changements
• Demander la création d’une présentation HTML visuelle pour expliquer du code peu familier — il produit des slides étonnamment bonnes
• Demander des diagrammes ASCII pour comprendre de nouveaux protocoles et codebases
• Mettre en place un skill de spaced repetition
  • L’utilisateur explique ce qu’il a compris, puis Claude pose des questions complémentaires pour combler les lacunes et enregistre le résultat