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

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

cd /path/to/project 

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

2. Démarrer Claude Code

claude 

3. Demander un aperçu général

give me an overview of this codebase

4. Approfondir des 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 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

find the files that handle user authentication

2. Obtenir du contexte sur l'interaction des composants

how do these authentication files work together?

3. Comprendre le flux d'exécution

trace the login process from front-end to database

[!TIP]

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

I'm seeing an error when I run npm test

2. Demander des recommandations de correction

suggest a few ways to fix the @ts-ignore in user.ts

3. Appliquer la correction

update user.ts to add the null check you suggested

[!TIP]

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

find deprecated API usage in our codebase

2. Obtenir des recommandations de refactorisation

suggest how to refactor utils.js to use modern JavaScript features

3. Appliquer les modifications en toute sécurité

refactor utils.js to use ES2024 features while maintaining the same behavior

4. Vérifier la refactorisation

run tests for the refactored code

[!TIP]

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é

find functions in NotificationsService.swift that are not covered by tests

2. Générer la structure des tests

add tests for the notification service

3. Ajouter des cas de test pertinents

add test cases for edge conditions in the notification service

4. Exécuter et vérifier 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, 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

summarize the changes I've made to the authentication module

2. Générer une pull request

create a pr

3. Réviser et affiner

enhance the PR description with more context about the security improvements

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.

[!TIP]

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é

find functions without proper JSDoc comments in the auth module

2. Générer la documentation

add JSDoc comments to the undocumented functions in auth.js

3. Réviser et enrichir

improve the generated documentation with more context and examples

4. Vérifier la documentation

check if the documentation follows our project standards

[!TIP]

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

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

3. Utiliser des images comme 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. Obtenir des suggestions de code à partir de contenu visuel

Generate CSS to match this design mockup

What HTML structure would recreate this component?

[!TIP]

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

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érencer un répertoire

What's the structure of @src/components?

3. Référencer des ressources MCP

Show me the data from @github:repos/owner/repo/issues

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.

[!TIP]

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 :

[!TIP]

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

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 /powerup pour des leçons interactives avec des démos animées, ou reportez-vous aux sections de workflow spécifiques ci-dessus.

[!TIP]

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.

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

[card] Bonnes pratiques

Modèles pour tirer le meilleur parti de Claude Code

[card] Gérer les sessions

Reprendre, nommer et créer des branches de conversations

[card] Worktrees

Exécuter des sessions parallèles isolées

[card] Étendre Claude Code

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