Passer au contenu principal
Cette page rassemble de courtes recettes pour le développement quotidien. Pour des conseils de plus haut niveau sur les prompts et la gestion du contexte, consultez Bonnes pratiques. Cette page couvre :

Recettes de prompts

Voici des modèles de prompts pour les tâches quotidiennes comme l’exploration de code inconnu, le débogage, la refactorisation, l’écriture de tests et la création de PR. Chacun fonctionne sur n’importe quelle surface de Claude Code ; adaptez la formulation à votre projet.

Comprendre de nouvelles bases de code

Pour configurer Claude Code dans un monorepo ou une grande base de code, consultez Monorepos et grands dépôts.

Obtenir un aperçu rapide de la base de code

Supposons que vous venez de rejoindre un nouveau projet et que vous devez comprendre rapidement sa structure.
1

Accéder au répertoire racine du projet

Remplacez /path/to/project par le chemin de votre projet.
2

Démarrer Claude Code

3

Demander un aperçu général

4

Approfondir des composants spécifiques

Conseils :
  • Commencez par des questions générales, puis concentrez-vous sur des zones spécifiques
  • Renseignez-vous sur les conventions de code et les modèles utilisés dans le projet
  • Demandez un glossaire des termes propres au projet

Trouver le code pertinent

Supposons que vous devez localiser le code lié à une fonctionnalité spécifique.
1

Demander à Claude de trouver les fichiers pertinents

2

Obtenir du contexte sur l'interaction des composants

3

Comprendre le flux d'exécution

Conseils :
  • Soyez précis sur ce que vous recherchez
  • Utilisez le vocabulaire métier du projet
  • Installez un plugin d’intelligence de code pour votre langage afin de fournir à Claude une navigation précise de type « aller à la définition » et « trouver les références »

Corriger les bugs efficacement

Supposons que vous avez rencontré un message d’erreur et que vous devez en trouver et corriger la source.
1

Partager l'erreur avec Claude

2

Demander des recommandations de correction

3

Appliquer la correction

Conseils :
  • Indiquez à Claude la commande permettant de reproduire le problème et d’obtenir une stack trace
  • Mentionnez les étapes permettant de reproduire l’erreur
  • Précisez à Claude si l’erreur est intermittente ou systématique

Refactoriser le code

Supposons que vous devez mettre à jour du code ancien pour utiliser des modèles et pratiques modernes. Pour porter une base de code entière vers un nouveau langage, consultez comment Anthropic mène des migrations de code à grande échelle avec Claude Code sur le blog.
1

Identifier le code hérité à refactoriser

2

Obtenir des recommandations de refactorisation

3

Appliquer les modifications en toute sécurité

4

Vérifier la refactorisation

Conseils :
  • Demandez à Claude d’expliquer les avantages de l’approche moderne
  • Demandez que les modifications préservent la rétrocompatibilité si nécessaire
  • Refactorisez par petits incréments testables

Travailler avec les tests

Supposons que vous devez ajouter des tests pour du code non couvert.
1

Identifier le code non testé

2

Générer la structure des tests

3

Ajouter des cas de test pertinents

4

Exécuter et vérifier les tests

Claude peut générer des tests qui suivent les modèles et conventions existants de votre projet. Lorsque vous demandez des tests, précisez le comportement que vous souhaitez vérifier. Claude examine vos fichiers de test existants pour reproduire le style, les frameworks et les modèles d’assertion déjà utilisés. Pour améliorer la couverture, demandez à Claude d’identifier les cas limites que vous auriez pu manquer. Claude peut analyser les chemins de votre code et suggérer des tests pour les conditions d’erreur, les valeurs limites et les entrées inattendues souvent négligées.

Créer des pull requests

Vous pouvez créer des pull requests en le demandant directement à Claude (« create a pr for my changes »), ou guider Claude étape par étape :
1

Résumer vos modifications

2

Générer une pull request

3

Réviser et affiner

Pour retrouver la session plus tard, exécutez claude --from-pr 1234 avec votre propre numéro de PR, ce qui ouvre le sélecteur de sessions filtré sur les sessions liées à cette PR, ou collez l’URL de la PR dans la recherche du sélecteur /resume. Claude Code lie la session à la PR lorsque Claude la crée avec gh pr create ou glab mr create, et lorsque Claude travaille sur une PR existante.
Relisez la PR générée par Claude avant de la soumettre et demandez à Claude de mettre en évidence les risques ou points d’attention potentiels.

Gérer la documentation

Supposons que vous devez ajouter ou mettre à jour la documentation de votre code.
1

Identifier le code non documenté

2

Générer la documentation

3

Réviser et enrichir

4

Vérifier la documentation

Conseils :
  • Précisez le style de documentation souhaité (JSDoc, docstrings, etc.)
  • Demandez des exemples dans la documentation
  • Demandez de la documentation pour les API publiques, les interfaces et la logique complexe

Travailler dans des dossiers de notes et des dossiers sans code

Claude Code fonctionne dans n’importe quel répertoire. Exécutez-le dans un coffre de notes, un dossier de documentation ou toute collection de fichiers markdown pour rechercher, modifier et réorganiser le contenu comme vous le feriez avec du code. Le répertoire .claude/ et CLAUDE.md coexistent avec les répertoires de configuration d’autres outils sans conflit. Claude relit les fichiers à chaque appel d’outil ; il voit donc les modifications que vous apportez dans une autre application la prochaine fois qu’il lit ce fichier.

Travailler avec des images

Supposons que vous devez travailler avec des images dans votre base de code et que vous souhaitez l’aide de Claude pour analyser leur contenu.
1

Ajouter une image à la conversation

Vous pouvez utiliser l’une de ces méthodes :
  1. Glissez-déposez une image dans la fenêtre de Claude Code
  2. Copiez une image et collez-la dans la CLI avec Ctrl+V, ou avec Alt+V sous Windows et WSL
  3. Fournissez un chemin d’image à Claude, par exemple « Analyze this image: /path/to/your/image.png »
2

Demander à Claude d'analyser l'image

3

Utiliser des images comme contexte

4

Obtenir des suggestions de code à partir de contenu visuel

Conseils :
  • Utilisez des images lorsque des descriptions textuelles seraient peu claires ou fastidieuses
  • Incluez des captures d’écran d’erreurs, des maquettes d’interface ou des diagrammes pour un meilleur contexte
  • Vous pouvez travailler avec plusieurs images dans une même conversation
  • L’analyse d’images fonctionne avec les diagrammes, les captures d’écran, les maquettes, et plus encore
  • Lorsque Claude fait référence à des images (par exemple, [Image #1]), faites Cmd+Click (Mac) ou Ctrl+Click (Windows/Linux) sur le lien pour ouvrir l’image dans votre visionneuse par défaut

Référencer des fichiers et des répertoires

Utilisez @ pour inclure rapidement des fichiers ou des répertoires sans attendre que Claude les lise.
1

Référencer un seul fichier

Cela inclut le contenu du fichier dans la conversation lorsqu’il respecte la limite de tokens de l’outil Read, soit 25 000 tokens par défaut. Un fichier texte de plus de 256 Ko n’est pas inclus.
2

Référencer un répertoire

3

Référencer des ressources MCP

Cela récupère des données depuis les serveurs MCP connectés en utilisant le format @server:resource. Consultez Ressources MCP pour plus de détails.
Conseils :
  • Les chemins de fichiers peuvent être relatifs ou absolus
  • Tapez @ pour ouvrir un menu de suggestions de chemins, puis appuyez sur Enter ou Tab pour accepter le chemin en surbrillance, et de nouveau sur Enter pour envoyer le message
  • Les références de fichiers @ ajoutent au contexte les fichiers CLAUDE.md du répertoire du fichier et de ses répertoires parents
  • Les références de répertoires affichent la liste des fichiers, pas leur contenu
  • Vous pouvez référencer plusieurs fichiers dans un seul message (par exemple, « @file1.js and @file2.js »)
Pour empêcher les références @ d’inclure le contenu des fichiers et la liste des répertoires, définissez CLAUDE_CODE_DISABLE_FILE_MENTIONS sur 1 dans votre shell ou dans le bloc env des paramètres utilisateur ou des paramètres gérés. Claude reçoit alors les chemins que vous avez référencés, accompagnés d’une note lui indiquant de les lire à l’aide de ses outils de fichiers. Cette variable nécessite Claude Code v2.1.299 ou une version ultérieure, et Claude Code l’ignore dans les paramètres de projet et les paramètres locaux. Vos hooks PreToolUse ne s’exécutent pas lorsque Claude Code inclut un fichier que vous référencez avec @, car aucun appel d’outil n’est effectué. Si vous comptez sur ces hooks pour contrôler ce que Claude lit, bloquez des chemins spécifiques ou empêchez les références @ d’inclure des fichiers :
  • Bloquer des chemins spécifiques : ajoutez une règle de refus Read pour ces chemins. Claude Code n’inclut pas un fichier correspondant à la règle.
  • Empêcher les références @ d’inclure des fichiers : définissez CLAUDE_CODE_DISABLE_FILE_MENTIONS=1, ce qui empêche les références de fichiers et de répertoires @ dans vos messages d’inclure du contenu, même pour les chemins que vos hooks ne vérifient pas. Vos hooks correspondants s’exécutent alors avant que Claude n’ouvre un chemin référencé avec un outil tel que Read.

Exécuter Claude de façon planifiée

Supposons que vous souhaitez que Claude prenne en charge une tâche automatiquement de manière récurrente, comme examiner les PR ouvertes chaque matin, auditer les dépendances chaque semaine ou vérifier les échecs de CI pendant la nuit. Choisissez une option de planification selon l’endroit où vous souhaitez que la tâche s’exécute :
Lorsque vous rédigez des prompts pour des tâches planifiées, précisez explicitement à quoi ressemble la réussite et que faire des résultats. La tâche s’exécute de manière autonome, elle ne peut donc pas poser de questions de clarification. Par exemple : « Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel. »

Interroger Claude sur ses capacités

Claude peut répondre aux questions sur ses propres fonctionnalités et limites. Il recherche les réponses dans la documentation actuelle de Claude Code ; elles ne se limitent donc pas à la version que vous exécutez.

Exemples de questions

Claude fournit des réponses basées sur la documentation à ces questions. Pour des démonstrations pratiques, exécutez /powerup pour des leçons interactives avec des démos animées, ou reportez-vous aux sections de workflow spécifiques ci-dessus.
Conseils :
  • Posez des questions précises pour obtenir des réponses détaillées
  • Claude peut expliquer des fonctionnalités complexes comme l’intégration MCP, les configurations d’entreprise et les workflows avancés

Reprendre les conversations précédentes

Quand une tâche s’étend sur plusieurs sessions, reprenez là où vous avez laissé au lieu de réexpliquer le contexte. Claude Code enregistre chaque conversation localement.
Cela reprend la session la plus récente dans le répertoire actuel ; s’il n’y en a pas encore, il affiche No conversation found to continue et se termine. Utilisez claude --resume pour choisir dans une liste, ou /resume depuis une session en cours. Consultez Gérer les sessions pour nommer, créer des branches et la référence complète du sélecteur.

Exécuter des sessions parallèles avec worktrees

Travaillez sur une fonctionnalité dans un terminal tandis que Claude corrige un bogue dans un autre, sans que les modifications ne se heurtent. Chaque git worktree est un checkout séparé sur sa propre branche, créé à partir d’un commit existant, donc le référentiel doit d’abord avoir au moins un commit.
Exécutez la même commande avec un nom différent dans un deuxième terminal pour démarrer une session parallèle isolée. Dans un référentiel sans commits, la commande échoue avec Failed to resolve base branch "HEAD": git rev-parse failed. Consultez Worktrees pour le nettoyage, .worktreeinclude et le support VCS non-git. Pour surveiller les sessions parallèles à partir d’un seul écran au lieu de terminaux séparés, consultez agents en arrière-plan.

Planifier avant de modifier

Pour les modifications que vous souhaitez examiner avant qu’elles ne touchent le disque, basculez en mode plan. Claude lit les fichiers et propose un plan mais ne fait aucune modification jusqu’à ce que vous approuviez. La barre d’état affiche ⏸ plan mode on tandis que le mode plan est actif.
Vous pouvez également appuyer sur Shift+Tab pendant une session jusqu’à ce que la barre d’état affiche ⏸ plan mode on. Consultez Mode plan pour le flux d’approbation et la modification du plan dans votre éditeur de texte.

Déléguer la recherche à des subagents

Explorer une grande base de code remplit votre contexte avec des lectures de fichiers. Déléguez l’exploration pour que seules les conclusions reviennent.
Le subagent lit les fichiers dans sa propre fenêtre de contexte et rapporte un résumé. Consultez Subagents pour définir des agents personnalisés avec leurs propres outils et prompts.

Canaliser Claude dans des scripts

Exécutez Claude de manière non-interactive pour CI, les hooks de pré-commit ou le traitement par lot. Stdin et stdout fonctionnent comme n’importe quel outil Unix.
Consultez Mode non-interactif pour les formats de sortie, les drapeaux de permission et les modèles de fan-out.

Étapes suivantes

Bonnes pratiques

Modèles pour tirer le meilleur parti de Claude Code

Gérer les sessions

Reprendre, nommer et créer des branches de conversations

Worktrees

Exécuter des sessions parallèles isolées

Étendre Claude Code

Ajouter des skills, des hooks, MCP, des subagents et des plugins