← Retour au blog

7 règles pour écrire des prompts qui marchent vraiment avec Claude Code

7 règles pour écrire des prompts qui marchent vraiment avec Claude Code

Même outil, deux prompts, deux résultats. Voilà ce qui m'a frappé en passant cette présentation d'Anthropic en revue, avant d'en faire une formation pour mes clients.

Le premier prompt :

> Corrige le bug de connexion.

Claude doit deviner la cause. Il te sort un seul correctif, sans alternative, et tu découvres le résultat après coup.

Le second :

> Trouve la cause racine de l'issue #983, puis propose quelques corrections. Laisse-moi choisir une approche avant de coder. ultrathink

Cette fois, tu valides le diagnostic, tu choisis entre plusieurs correctifs, et le code n'arrive qu'après ton accord. Tout le reste de l'article tient dans cet écart.

J'ai résumé le tout en 7 règles, 4 modules, 26 slides. Tu peux les lire ici, ou récupérer le PDF complet juste en dessous.

Le PDF de la formation (26 slides) : Les 7 règles, tous les prompts à copier, le tableau « où ranger quoi » et le plan d'action en 7 jours. Laisse ton email, il s'ouvre tout de suite.

Module 1 : démarre avec des questions sur ton code

Règle 1 : utilise les questions sur ton code pour faire tes premiers pas. Pas besoin de modifier quoi que ce soit, tu apprends à parler à l'outil. Chaque prompt nomme un fichier avec @ ou une référence (#issue, PR), et Claude sait où chercher :

> Comment @RoutingController.py est-il utilisé ?

> Pourquoi recoverFromException prend autant d'arguments ? Cherche dans l'historique git

> Lis la PR #9383, puis vérifie avec soin quelles versions de l'app sont touchées

> Qu'est-ce que j'ai livré la semaine dernière ?

Règle 2 : entraîne-toi à prompter. Repère ce que Claude Code comprend tout de suite et ce qui demande des consignes plus précises.

Exercice de 10 minutes : pose 5 questions sur un projet. Note celles qui reçoivent une bonne réponse du premier coup, et celles où tu as dû préciser. C'est là que tu apprends le plus.

Côté installation, six réglages valent le détour :

  • /allowed-tools : personnalise les permissions des outils
  • /terminal-setup : active Maj+Entrée pour insérer des retours à la ligne
  • /install-github-app : tague @claude dans tes issues et tes PR
  • /theme : mode clair ou sombre
  • /config : active les notifications
  • Dictée macOS : dicte tes prompts au lieu de les taper

Module 2 : laisse Claude utiliser ses outils

Claude Code embarque une dizaine d'outils : Bash (lint, tests, git), recherche et liste de fichiers, lecture et écriture, web fetch, recherche web, TODOs pour suivre les étapes d'une tâche, et sous-agents pour déléguer en parallèle. C'est eux qui font sa puissance, et tu les diriges avec ton prompt :

> Propose quelques corrections pour l'issue #8732, puis implémente celle que je choisis.

> Identifie les cas limites non couverts dans @app/tests/signupTest.ts, puis mets à jour les tests. think hard

> commit, push, pr

> Utilise 3 agents en parallèle pour proposer des idées de nettoyage de @services/aggregator/feed_service.cpp

Règle 3 : apprends à Claude à utiliser tes outils. Pour un outil en ligne de commande, dis-lui qu'il existe et laisse-le lire l'aide :

> Utilise la CLI barley pour chercher les erreurs dans le dernier entraînement. Utilise -h pour voir comment l'utiliser.

Pour un serveur MCP, tu le déclares une fois, puis tu demandes à Claude de s'en servir :

> $ claude mcp add barley_server -- node myserver

> Utilise le serveur MCP barley pour chercher les erreurs dans le dernier entraînement.

Règle 4 : adapte le workflow à la tâche. Trois workflows à copier :

  • Explorer, planifier, valider, coder, commit : le premier prompt de cet article, avec l'issue #983.
  • Tests d'abord, puis code : écris les tests, vérifie qu'ils échouent, commit, puis mets à jour le code pour les faire passer.
  • Code, capture d'écran, itération : implémente une maquette, fais une capture avec Puppeteer, et itère jusqu'à ce que ça ressemble.

Exercice de 15 minutes : pour ta prochaine tâche, choisis l'un des trois workflows avant d'écrire le prompt. Branche aussi un outil de ton équipe.

Module 3 : donne plus de contexte à Claude

Règle 5 : plus tu donnes de contexte à Claude, plus il est intelligent. Il y a quatre façons de le faire : le fichier CLAUDE.md (les consignes lues au démarrage), les commandes slash (des prompts réutilisables que tu appelles à la demande), les mentions @ (tu désignes le fichier ou le dossier à lire), et les ressources MCP, qui étaient annoncées « bientôt » dans la présentation.

Règle 6 : prends le temps de régler ton contexte. Pose-toi deux questions : c'est pour toi ou pour ton équipe ? Automatique ou à la demande ?

  • Pour toi, automatique : ~/.claude/CLAUDE.md
  • Pour toi, à la demande : ~/.claude/commands/
  • Équipe, automatique : CLAUDE.md dans git
  • Équipe, à la demande : .claude/commands/ dans git

Un raccourci utile : tape # pour ajouter une consigne à la mémoire pendant une session.

Module 4 : partage ta configuration avec ton équipe

Règle 7 : configure CLAUDE.md, les serveurs MCP, les permissions et les commandes slash pour ton équipe, puis mets-les dans git. Tu construis une fois, tout le monde en profite.

> $ git add CLAUDE.md .mcp.json .claude/

> $ git commit -m "Configuration Claude Code partagée"

Le tableau « où ranger quoi » (entreprise, global, projet partagé, projet local) est dans le PDF.

Ce qui a changé depuis cette présentation

Les slides viennent d'une version 0.2.x de Claude Code. Depuis, la documentation a ajouté plusieurs choses :

  • /init génère un CLAUDE.md pour ton projet
  • /memory ouvre tes fichiers de mémoire pour les modifier
  • Un CLAUDE.md peut en importer d'autres avec @chemin/fichier
  • .claude/CLAUDE.md est un autre emplacement possible pour la mémoire du projet
  • Claude lit les CLAUDE.md depuis le dossier courant vers le haut

Avant d'enseigner ou de copier une commande, vérifie son nom exact dans la doc, notamment /allowed-tools, /user: et /project:.

Ton plan d'action en 7 jours

  • Jour 1 : règle ton installation (/config, /terminal-setup, /theme)
  • Jour 2 : pose 5 questions sur un projet avec des mentions @
  • Jour 3 : teste un prompt « propose, puis implémente celle que je choisis »
  • Jour 4 : branche un outil de ton équipe, en CLI ou en MCP
  • Jour 5 : lance un workflow tests d'abord sur une petite tâche
  • Jour 6 : génère ton CLAUDE.md avec /init, puis corrige-le à la main
  • Jour 7 : mets la configuration dans git et partage-la

Un prompt précis, du contexte et tes outils. Chaque jour ajoute l'un des trois.

Ouvre ton terminal et pose ta première question avec @. Note ce que Claude comprend du premier coup : c'est là que commence la règle 2.