Flux de travail courants
Guides étape par étape pour explorer les bases de code, corriger les bogues, refactoriser, tester et autres tâches quotidiennes avec Claude Code.
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 pour explorer le code, corriger les bogues, refactoriser, tester, les PR et la documentation
- Reprendre les conversations précédentes pour qu'une tâche puisse s'étendre sur plusieurs sessions
- Exécuter des sessions parallèles avec worktrees pour que les modifications concurrentes ne se heurtent pas
- Planifier avant de modifier pour examiner les modifications avant qu'elles ne touchent le disque
- Déléguer la recherche à des subagents pour garder votre contexte principal propre
- Canaliser Claude dans des scripts pour CI et le traitement par lot
Recettes de prompts
Ce sont des modèles de prompts pour les tâches quotidiennes comme explorer du code inconnu, déboguer, refactoriser, écrire des tests et créer des PR. Chacun fonctionne sur n'importe quelle surface Claude Code ; adaptez la formulation à votre projet.
Comprendre les nouvelles bases de code
Pour configurer Claude Code dans un monorepo ou une grande base de code, consultez Monorepos et grands référentiels.
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édez au répertoire racine du projet
cd /path/to/project
Remplacez /path/to/project par le chemin d'accès à votre projet.
2. Démarrez Claude Code
claude
3. Demandez un aperçu de haut niveau
give me an overview of this codebase
4. Approfondissez les composants spécifiques
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
[!TIP]
Conseils :
- Commencez par des questions larges, puis réduisez à des domaines spécifiques
- Posez des questions sur les conventions de codage et les modèles utilisés dans le projet
- Demandez un glossaire des termes spécifiques au projet
Trouver du code pertinent
Supposons que vous ayez besoin de localiser du code lié à une fonctionnalité ou une capacité spécifique.
1. Demandez à Claude de trouver les fichiers pertinents
find the files that handle user authentication
2. Obtenez du contexte sur la façon dont les composants interagissent
how do these authentication files work together?
3. Comprenez le flux d'exécution
trace the login process from front-end to database
[!TIP]
Conseils :
- Soyez spécifique sur ce que vous recherchez
- Utilisez le langage du domaine du projet
- Installez un plugin d'intelligence de code pour votre langage afin de donner à Claude une navigation précise « aller à la définition » et « trouver les références »
Corriger les bogues efficacement
Supposons que vous ayez rencontré un message d'erreur et que vous ayez besoin de trouver et de corriger sa source.
1. Partagez l'erreur avec Claude
I'm seeing an error when I run npm test
2. Demandez des recommandations de correction
suggest a few ways to fix the @ts-ignore in user.ts
3. Appliquez la correction
update user.ts to add the null check you suggested
[!TIP]
Conseils :
- Dites à Claude la commande pour reproduire le problème et obtenir une trace de pile
- Mentionnez les étapes pour reproduire l'erreur
- Faites savoir à Claude si l'erreur est intermittente ou cohérente
Refactoriser le code
Supposons que vous ayez besoin de mettre à jour du code ancien pour utiliser des modèles et des pratiques modernes.
Pour porter une base de code entière vers un nouveau langage, consultez comment Anthropic exécute les migrations de code à grande échelle avec Claude Code sur le blog.
1. Identifiez le code hérité pour la refactorisation
find deprecated API usage in our codebase
2. Obtenez des recommandations de refactorisation
suggest how to refactor utils.js to use modern JavaScript features
3. Appliquez les modifications en toute sécurité
refactor utils.js to use ES2024 features while maintaining the same behavior
4. Vérifiez la refactorisation
run tests for the refactored code
[!TIP]
Conseils :
- Demandez à Claude d'expliquer les avantages de l'approche moderne
- Demandez que les modifications maintiennent la compatibilité rétroactive si nécessaire
- Effectuez la refactorisation par petits incréments testables
Travailler avec les tests
Supposons que vous ayez besoin d'ajouter des tests pour du code non couvert.
1. Identifiez le code non testé
find functions in NotificationsService.swift that are not covered by tests
2. Générez l'échafaudage des tests
add tests for the notification service
3. Ajoutez des cas de test significatifs
add test cases for edge conditions in the notification service
4. Exécutez et vérifiez les tests
run the new tests and fix any failures
Claude peut générer des tests qui suivent les modèles et conventions existants de votre projet. Lorsque vous demandez des tests, soyez spécifique sur le comportement que vous souhaitez vérifier. Claude examine vos fichiers de test existants pour correspondre au style, aux frameworks et aux modèles d'assertion déjà en usage.
Pour améliorer la couverture, demandez à Claude d'identifier les cas limites que vous auriez pu manquer. Claude peut analyser vos chemins de code et suggérer des tests pour les conditions d'erreur, les valeurs limites et les entrées inattendues qui sont souvent négligées.
Créer des demandes de tirage
Vous pouvez créer des demandes de tirage en demandant directement à Claude (« créer une pr pour mes modifications »), ou guider Claude à travers cela étape par étape :
1. Résumez vos modifications
summarize the changes I've made to the authentication module
2. Générez une demande de tirage
create a pr
3. Examinez et affinez
enhance the PR description with more context about the security improvements
Pour trouver la session plus tard, exécutez claude --from-pr 1234 avec votre propre numéro de PR, qui ouvre le sélecteur de session filtré pour les sessions liées à cette PR, ou collez l'URL de la PR dans le sélecteur /resume. Claude Code lie la session à la PR quand Claude la crée avec gh pr create ou glab mr create, et quand Claude travaille sur une PR existante.
[!TIP]
Examinez la PR générée par Claude avant de la soumettre et demandez à Claude de mettre en évidence les risques ou considérations potentiels.
Gérer la documentation
Supposons que vous ayez besoin d'ajouter ou de mettre à jour la documentation de votre code.
1. Identifiez le code non documenté
find functions without proper JSDoc comments in the auth module
2. Générez la documentation
add JSDoc comments to the undocumented functions in auth.js
3. Examinez et améliorez
improve the generated documentation with more context and examples
4. Vérifiez la documentation
check if the documentation follows our project standards
[!TIP]
Conseils :
- Spécifiez le style de documentation que vous souhaitez (JSDoc, docstrings, etc.)
- Demandez des exemples dans la documentation
- Demandez la documentation pour les API publiques, les interfaces et la logique complexe
Travailler dans les notes et les dossiers non-code
Claude Code fonctionne dans n'importe quel répertoire. Exécutez-le à l'intérieur d'un coffre-fort de notes, d'un dossier de documentation ou de toute collection de fichiers markdown pour rechercher, modifier et réorganiser le contenu de la même manière que vous le feriez pour du code.
Le répertoire .claude/ et CLAUDE.md se trouvent aux côtés des répertoires de configuration d'autres outils sans conflit. Claude lit les fichiers à nouveau à 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 les images
Supposons que vous ayez besoin de travailler avec des images dans votre base de code et que vous souhaitiez l'aide de Claude pour analyser le contenu des images.
1. Ajoutez une image à la conversation
Vous pouvez utiliser l'une de ces méthodes :
- Glissez-déposez une image dans la fenêtre Claude Code
- Copiez une image et collez-la dans l'interface CLI avec
Ctrl+V, ou avecAlt+Vsur Windows et WSL - Fournissez un chemin d'image à Claude. Par exemple, « Analyser cette image : /path/to/your/image.png »
2. Demandez à Claude d'analyser l'image
What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
3. Utilisez les images pour le contexte
Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
4. Obtenez des suggestions de code à partir du contenu visuel
Generate CSS to match this design mockup
What HTML structure would recreate this component?
[!TIP]
Conseils :
- Utilisez les images quand les descriptions textuelles seraient peu claires ou fastidieuses
- Incluez des captures d'écran d'erreurs, de conceptions d'interface utilisateur ou de diagrammes pour un meilleur contexte
- Vous pouvez travailler avec plusieurs images dans une conversation
- L'analyse d'images fonctionne avec les diagrammes, les captures d'écran, les maquettes et bien d'autres
- Quand Claude référence des images (par exemple,
[Image #1]),Cmd+Click(Mac) ouCtrl+Click(Windows/Linux) le lien pour ouvrir l'image dans votre visionneuse par défaut
Référencer les fichiers et répertoires
Utilisez @ pour inclure rapidement des fichiers ou des répertoires sans attendre que Claude les lise.
1. Référencez un seul fichier
Explain the logic in @src/utils/auth.js
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érencez un répertoire
What's the structure of @src/components?
3. Référencez les ressources MCP
Show me the data from @github:repos/owner/repo/issues
Cela récupère les données des serveurs MCP connectés en utilisant le format @server:resource. Consultez Ressources MCP pour plus de détails.
[!TIP]
Conseils :
- Les chemins de fichiers peuvent être relatifs ou absolus
- Tapez
@pour ouvrir un menu de suggestion de chemin, puis appuyez sur Entrée ou Tab pour accepter le chemin en surbrillance et Entrée à nouveau pour envoyer le message- Les références de fichiers @ ajoutent
CLAUDE.mddans le répertoire du fichier et les répertoires parents au contexte- Les références de répertoires affichent les listes de fichiers, pas les contenus
- Vous pouvez référencer plusieurs fichiers dans un seul message (par exemple, « @file1.js et @file2.js »)
Pour empêcher les références @ d'inclure le contenu des fichiers et les listes de 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. La 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 locaux.
Vos hooks PreToolUse ne s'exécutent pas lorsque Claude Code inclut un fichier que vous référencez avec @, car il n'effectue aucun appel d'outil. 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
Readpour ces chemins. Claude Code n'inclut pas un fichier auquel la règle correspond. - Empêcher les références
@d'inclure des fichiers : définissezCLAUDE_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 queRead.
Exécuter Claude selon un calendrier
Supposons que vous souhaitiez que Claude gère 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 CI pendant la nuit.
Choisissez une option de planification en fonction de l'endroit où vous souhaitez que la tâche s'exécute :
| Option | Où elle s'exécute | Idéale pour |
|---|---|---|
| Tâches planifiées dans le cloud | Cloud, géré par Anthropic par défaut | Les tâches qui doivent s'exécuter même quand votre ordinateur est éteint. Peuvent également se déclencher sur les appels API ou les événements GitHub en plus d'un calendrier. Configurez sur claude.ai/code/routines. |
| Tâches planifiées sur le bureau | Votre machine, via l'application de bureau | Les tâches qui ont besoin d'un accès direct aux fichiers locaux, aux outils ou aux modifications non validées. |
| GitHub Actions | Votre pipeline CI | Les tâches liées aux événements du référentiel comme les PR ouvertes, ou les calendriers cron qui doivent vivre aux côtés de votre configuration de flux de travail. |
/loop |
La session CLI actuelle | L'interrogation rapide pendant qu'une session est ouverte. --resume et --continue restaurent les boucles non expirées à intervalle fixe. |
[!TIP]
Lors de la rédaction de prompts pour les tâches planifiées, soyez explicite sur ce que signifie le succès et ce qu'il faut faire avec les résultats. La tâche s'exécute de manière autonome, elle ne peut donc pas poser de questions de clarification. Par exemple : « Examinez les PR ouvertes étiquetées
needs-review, laissez des commentaires en ligne sur les problèmes et publiez un résumé dans le canal Slack#eng-reviews. »
Demandez à Claude ses capacités
Claude peut répondre à des questions sur ses propres fonctionnalités et limitations. Il recherche les réponses dans la documentation actuelle de Claude Code, elles ne sont donc pas limitées à la version que vous utilisez.
Exemples de questions
can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?
[!NOTE]
Claude fournit des réponses basées sur la documentation à ces questions. Pour des démonstrations pratiques, exécutez
/poweruppour des leçons interactives avec des démos animées, ou consultez les sections de flux de travail spécifiques ci-dessus.
[!TIP]
Conseils :
- Posez des questions spécifiques pour obtenir des réponses détaillées
- Claude peut expliquer les fonctionnalités complexes comme l'intégration MCP, les configurations d'entreprise et les flux de travail 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.
claude --continue
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.
claude --worktree feature-auth
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.
claude --permission-mode plan
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.
use a subagent to investigate how our auth system handles token refresh
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.
git log --oneline -20 | claude -p "summarize these recent commits"
Consultez Mode non-interactif pour les formats de sortie, les drapeaux de permission et les modèles de fan-out.
Étapes suivantes
Modèles pour tirer le meilleur parti de Claude Code
Reprendre, nommer et créer des branches de conversations
Exécuter des sessions parallèles isolées
Ajouter des skills, des hooks, MCP, des subagents et des plugins