5 techniques de prompts pour obtenir de meilleurs resultats avec Claude Code [avec exemples]

Introduction

La qualite des resultats de Claude Code est directement liee a la facon dont vous redigez vos prompts. Avec la bonne technique, la meme tache peut passer d’un “code inutilisable” a un “code pret pour la production”.

Dans cet article, nous detaillons cinq techniques pratiques de prompts avec des exemples Before/After que vous pouvez utiliser immediatement. Si vous decouvrez Claude Code, consultez d’abord le guide de demarrage.

1. Fournissez un contexte precis

La technique la plus efficace consiste a communiquer clairement le contexte et l’objectif de votre tache. Claude Code peut lire les fichiers de votre projet, mais il ne peut pas lire dans vos pensees. Indiquez non seulement ce que vous voulez, mais aussi pourquoi, et la precision des resultats s’ameliorera considerablement.

Before (prompt faible) :

Fais une fonctionnalite de connexion

After (prompt fort) :

Ajoute une authentification par email/mot de passe a ce projet Next.js 14 App Router.
Les routes API existent deja dans src/app/api/, et la table utilisateurs est definie
via Prisma + PostgreSQL. Utilise NextAuth.js v5 comme bibliotheque d'authentification.

Before (prompt faible) :

Corrige le bug

After (prompt fort) :

Corrige le bug dans src/components/UserList.tsx ou setState est appele
apres le demontage du composant lors de la recuperation de la liste
des utilisateurs dans useEffect.
Ajoute une logique de nettoyage avec AbortController.

2. Decomposez les taches en etapes

Quand vous confiez une tache massive a Claude Code d’un seul coup, il peut perdre la vue d’ensemble. Divisez intentionnellement le travail complexe en etapes et confirmez que chaque etape est terminee avant de passer a la suivante.

Before (prompt faible) :

Construis un systeme complet de gestion de produits. Il me faut listing, detail,
creation, edition, suppression, upload d'images, gestion des categories,
gestion des stocks et filtres de recherche.

After (prompt fort) :

Construisons la gestion de produits par etapes. Pour l'etape 1,
cree l'API CRUD des produits :

- POST /api/products (creation)
- GET /api/products (liste avec pagination)
- GET /api/products/:id (detail)
- PUT /api/products/:id (mise a jour)
- DELETE /api/products/:id (suppression)

Utilise zod pour la validation et le client Prisma existant dans src/lib/db.ts.

Before (prompt faible) :

Ecris tous les tests

After (prompt fort) :

Ecris des tests unitaires pour src/utils/calculatePrice.ts.
Commence par les cas nominaux couvrant :
- Calcul du prix de base
- Application des taux de remise (10%, 20%, 50%)
- Calcul TTC (taux de taxe 10%)
Utilise Vitest et suis les patterns existants dans le repertoire tests/.

3. Specifiez le format de sortie attendu

Indiquer explicitement le langage de programmation, le framework, le style de code et les autres attentes de format reduit considerablement les reprises. Soyez particulierement clair sur les definitions de types TypeScript et les patterns de gestion d’erreurs.

Before (prompt faible) :

Cree un client API

After (prompt fort) :

Cree une classe client pour une API de paiement externe dans src/lib/api-client.ts.

Exigences :
- Definitions de types TypeScript compatibles strict mode
- Base sur fetch (pas d'axios)
- Classe d'erreur personnalisee (PaymentApiError) pour la gestion des erreurs
- Logique de retry (3 tentatives max, exponential backoff)
- Types de reponse generiques
- Commentaires JSDoc sur toutes les methodes publiques

Before (prompt faible) :

Fais un composant React

After (prompt fort) :

Cree un composant de table reutilisable dans src/components/DataTable.tsx.

- Composant client ("use client"), pas un React Server Component
- Props types avec des generiques pour accepter les definitions de colonnes
- Support du tri et de la pagination
- Style avec Tailwind CSS, en respectant les design tokens de src/components/Button.tsx
- Accessibilite : roles WAI-ARIA table correctement configures

4. Referencez le code existant

L’une des plus grandes forces de Claude Code est sa capacite a comprendre l’ensemble de votre projet. Maximisez cela en lui demandant explicitement de suivre le code existant. Indiquer des chemins de fichiers precis rend cela encore plus efficace.

Before (prompt faible) :

Ajoute un nouvel endpoint API

After (prompt fort) :

En suivant le meme pattern que src/app/api/users/route.ts,
cree un endpoint API de gestion de commandes dans src/app/api/orders/route.ts.

Reproduis l'API users existante pour :
- Validation par schema Zod
- Pattern de gestion d'erreurs try-catch
- Style de retour NextResponse
- Approche des requetes Prisma

Before (prompt faible) :

Fais une page de parametres

After (prompt fort) :

En utilisant src/app/dashboard/profile/page.tsx comme reference,
cree src/app/dashboard/settings/page.tsx.

Conserve la meme structure de layout (composant DashboardLayout, Breadcrumb,
utilisation de PageHeader) tout en ajoutant des formulaires de parametres
de notification et de securite.
Utilise react-hook-form + zod pour la gestion des formulaires, comme la page profil.

5. Iterez avec une boucle de retroaction

N’attendez pas la perfection du premier coup. Utilisez la conversation avec Claude Code pour ameliorer la qualite de maniere incrementale. Traitez le resultat initial comme une base et fournissez un feedback specifique et actionnable.

Before (prompt faible) :

C'est pas ca, refais

After (prompt fort) :

Merci. Deux modifications s'il te plait :
1. Dans la fonction handleSubmit, differencie les erreurs reseau
   des erreurs de validation lors de l'affichage des messages a l'utilisateur
2. Remplace le spinner simple de l'etat de chargement par le skeleton UI
   de src/components/Skeleton.tsx

Before (prompt faible) :

Fais mieux

After (prompt fort) :

J'aimerais des ameliorations de performance. Precisement :
1. Applique React.memo au rendu de la liste de produits pour empecher les re-renders inutiles
2. Ajoute un debounce (300ms) sur l'input de recherche
3. Implemente le lazy loading pour les images
Ajoute des commentaires a chaque point de modification pour que je puisse
evaluer l'impact sur le score Lighthouse.

Conclusion

Recapitulons les cinq techniques :

Fournissez un contexte precis pour que Claude Code comprenne votre intention avec exactitude
Decomposez les taches en etapes pour garder le perimetre de chaque interaction gerable
Specifiez le format de sortie pour minimiser les reprises
Referencez le code existant pour maintenir la coherence du projet
Iterez avec du feedback pour elever la qualite de maniere incrementale

Chaque technique est efficace seule, mais elles brillent vraiment combinees. Ecrire les regles du projet dans un fichier CLAUDE.md reduit la quantite de contexte a inclure dans chaque prompt, augmentant encore l’efficacite.

Pour des usages plus avances, consultez nos astuces de productivite avec Claude Code.

Pour les concepts fondamentaux du prompt engineering, lisez aussi le guide officiel de prompt engineering d’Anthropic.