Introduction

Claude Code est un agent de codage qui s'exécute dans le terminal — il lit votre prompt, raisonne sur le contexte, puis exécute une séquence d'actions sur votre base de code réelle. Par conséquent, la qualité du prompt直接影响 la qualité du résultat : un prompt vague conduit à du code incorrect, à du code inutile, ou à un agent qui ne cesse de poser des questions de clarification. Cette leçon se concentre sur des techniques concrètes de prompting pour aider Claude Code à comprendre votre intention correctement dès la première tentative.

Principe fondamental : la clarté plutôt que la brièveté

Une erreur courante consiste à essayer de rédiger le prompt le plus court possible, en supposant que l'IA « va comprendre ». Avec Claude Code, c'est l'inverse qui est vrai : un contexte suffisant produit systématiquement de meilleurs résultats que des prompts trop succincts.

Comparez ces deux prompts :

Prompt faible : « Corrige le bug dans le fichier auth »

Prompt fort : « Dans src/auth/login.ts, la fonction validateToken renvoie true pour les tokens expirés. Corrige-la pour vérifier le champ exp dans la charge utile du JWT et lever une AuthError si le token a expiré. »

Le second prompt spécifie le fichier exact, le nom de la fonction, le symptôme du bug, le comportement attendu et le type d'erreur à lever. Claude Code n'a rien à deviner.

Structure d'un prompt efficace

Un prompt bien conçu pour Claude Code comprend généralement quatre composantes : le contexte, l'exigence, les contraintes et le résultat attendu. Il n'est pas nécessaire de les rédiger sous forme de quatre sections distinctes — tant que ces informations sont présentes dans le prompt, c'est suffisant.

Un exemple concret pour une tâche d'ajout de fonctionnalité :

Context: Project dùng Express.js + TypeScript, database là PostgreSQL qua Prisma ORM.
Yêu cầu: Thêm endpoint POST /api/users/:id/deactivate để soft-delete user (set trường isActive = false, không xóa record).
Ràng buộc: Chỉ admin mới gọi được endpoint này — dùng middleware isAdmin đã có ở src/middleware/auth.ts. Không thay đổi schema Prisma.
Kết quả: Tạo handler trong src/routes/users.ts, thêm route vào src/app.ts, viết 1 integration test cơ bản.

Ce style de prompt ne nécessite aucune syntaxe particulière — du texte brut ou des puces fonctionnent très bien, à condition que les informations soient complètes.

Technique avancée : guider par l'exemple

Lorsque vous souhaitez que Claude Code écrive du code dans un style spécifique — par exemple, en respectant les conventions de votre base de code existante — l'approche la plus efficace consiste à le renvoyer directement vers un fichier de référence.

Viết unit test cho hàm calculateDiscount trong src/pricing/discount.ts.
Dùng cùng cấu trúc test như trong src/pricing/tax.test.ts: describe block theo tên hàm, test case dùng it(), mock bằng jest.fn().

Cette méthode est bien plus efficace qu'une longue description du style souhaité, car Claude Code lira le fichier de référence et en déduira lui-même le pattern.

Une autre technique consiste à décomposer les grandes tâches en prompts séquentiels plutôt que de tout combiner en un seul :

Bước 1: Chỉ phân tích file src/payment/processor.ts và liệt kê các hàm hiện có, đừng sửa gì.

Une fois que Claude Code a rapporté son analyse, fournissez le prompt pour l'étape 2. Cette approche vous permet de valider chaque étape et empêche l'agent de s'éloigner trop de votre intention initiale.

Erreurs courantes

Erreur 1 : Utiliser des termes vagues comme « optimiser », « améliorer » ou « nettoyer » sans préciser les critères. Remplacez par : « réduire le nombre d'appels à la base de données à l'intérieur de la boucle dans fetchUserOrders » ou « renommer les variables du fichier X pour suivre la convention camelCase ».

Erreur 2 : Omettre les contraintes techniques. Si vous ne voulez pas que Claude Code installe de nouveaux paquets, indiquez-le explicitement : « N'utilise pas de bibliothèques externes — utilise uniquement ce qui est déjà dans package.json ». L'agent ne peut pas inférer ces limites de lui-même.

Erreur 3 : Demander trop de choses dans un seul prompt. Lorsqu'un seul prompt inclut à la fois du refactoring, l'ajout d'une fonctionnalité et l'écriture de tests, Claude Code peut mal prioriser ou oublier quelque chose. Séparez le travail en sessions distinctes.

Erreur 4 : Ne pas définir le périmètre. Si la tâche ne concerne qu'un seul module, précisez-le clairement : « Effectue uniquement les modifications dans src/billing/ — ne touche aucune autre partie de la base de code. »

Résumé

Rédiger des prompts efficaces pour Claude Code ne nécessite aucune technique complexe — il suffit de fournir un contexte suffisant, d'énoncer clairement les contraintes et de décomposer les tâches si nécessaire. La règle la plus simple à retenir : si un développeur qui vient d'arriver dans l'équipe lit votre prompt et ne sait pas quoi faire, Claude Code ne le saura pas non plus. Rédigez comme si vous déléguiez à un collègue — soyez précis, fournissez du contexte, et indiquez clairement à quoi ressemble « terminé ».