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.
Accédez au répertoire racine du projet
cd /path/to/project
Démarrez Claude Code
claude
Demandez un aperçu de haut niveau
give me an overview of this codebase
Approfondissez les composants spécifiques
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
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.
Demandez à Claude de trouver les fichiers pertinents
find the files that handle user authentication
Obtenez du contexte sur la façon dont les composants interagissent
how do these authentication files work together?
Comprenez le flux d'exécution
trace the login process from front-end to database
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.
Partagez l'erreur avec Claude
I'm seeing an error when I run npm test
Demandez des recommandations de correction
suggest a few ways to fix the @ts-ignore in user.ts
Appliquez la correction
update user.ts to add the null check you suggested
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.
Identifiez le code hérité pour la refactorisation
find deprecated API usage in our codebase
Obtenez des recommandations de refactorisation
suggest how to refactor utils.js to use modern JavaScript features
Appliquez les modifications en toute sécurité
refactor utils.js to use ES2024 features while maintaining the same behavior
Vérifiez la refactorisation
run tests for the refactored code
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.
Identifiez le code non testé
find functions in NotificationsService.swift that are not covered by tests
Générez l'échafaudage des tests
add tests for the notification service
Ajoutez des cas de test significatifs
add test cases for edge conditions in the notification service
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 une couverture complète, 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 faciles à oublier.
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 :
Résumez vos modifications
summarize the changes I've made to the authentication module
Générez une demande de tirage
create a pr
Examinez et affinez
enhance the PR description with more context about the security improvements
Lorsque vous créez une PR en utilisant gh pr create, la session est automatiquement liée à cette PR. Pour la reprendre plus tard, exécutez claude --from-pr <number> ou collez l'URL de la PR dans le sélecteur /resume.
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.
Identifiez le code non documenté
find functions without proper JSDoc comments in the auth module
Générez la documentation
add JSDoc comments to the undocumented functions in auth.js
Examinez et améliorez
improve the generated documentation with more context and examples
Vérifiez la documentation
check if the documentation follows our project standards
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.
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 (N'utilisez pas cmd+v)
- Fournissez un chemin d'image à Claude. Par exemple, « Analyser cette image : /path/to/your/image.png »
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?
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?
Obtenez des suggestions de code à partir du contenu visuel
Generate CSS to match this design mockup
What HTML structure would recreate this component?
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.
Référencez un seul fichier
Explain the logic in @src/utils/auth.js
Cela inclut le contenu complet du fichier dans la conversation.
Référencez un répertoire
What's the structure of @src/components?
Cela fournit une liste de répertoires avec les informations de fichier.
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.
Conseils :
- Les chemins de fichiers peuvent être relatifs ou absolus
- 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 »)
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 |
|---|---|---|
| Routines | Infrastructure gérée par Anthropic | 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. Les tâches s'arrêtent quand vous commencez une nouvelle conversation ; --resume et --continue restaurent les tâches non expirées. |
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 a un accès intégré à sa documentation et peut répondre à des questions sur ses propres fonctionnalités et limitations.
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?
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 consultez les sections de flux de travail spécifiques ci-dessus.
Conseils :
- Claude a toujours accès à la dernière documentation de Claude Code, quelle que soit la version que vous utilisez
- 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 worktree est un checkout séparé sur sa propre branche.
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. 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.
claude --permission-mode plan
Vous pouvez également appuyer sur Shift+Tab pendant une session pour basculer en mode plan. 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.