Claude Code est un agent en ligne de commande qui s'exécute dans votre terminal, lit votre référentiel, modifie les fichiers, exécute des commandes et demande une confirmation avant d'effectuer des actions potentiellement destructrices. Il est conçu pour vous assister à chaque étape du cycle de vie du développement logiciel, de l'exploration d'une base de code inconnue à la mise en production et à la maintenance du code.
Le tableau ci-dessous résume la place de Claude Code dans le cycle de vie du développement. Le reste de cet article présente les dix tâches pour lesquelles les développeurs l'utilisent le plus fréquemment, avec un exemple de prompt et le résultat attendu pour chacune.
1. Découvrir | 2. Concevoir | 3. Construire | 4. Déployer | 5. Support et mise à l'échelle |
Explorer la base de code et l'historique | Planifier le projet | Implémenter le code | Automatiser CI/CD | Déboguer les erreurs |
Rechercher la documentation | Développer les spécifications techniques | Écrire et exécuter des tests | Configurer les environnements | Refactorisation à grande échelle |
Intégrer et apprendre | Définir l'architecture | Créer des commits et des PRs | Gérer les déploiements | Surveiller l'utilisation et les performances |
Comment utiliser ce guide
Chaque cas d'usage ci-dessous inclut quand l'utiliser, un exemple de prompt et le résultat attendu. Aucune configuration n'est requise pour l'un d'eux, sauf §9 (intégration du suivi des problèmes), qui nécessite une configuration MCP connector unique.
Les cas d'usage sont ordonnés à peu près selon le moment où la plupart des développeurs les rencontrent. Sélectionnez celui qui correspond à votre tâche actuelle.
Cas d'usage
1. Corriger un test défaillant
Quand l'utiliser : Un test échoue et la cause n'est pas immédiatement évidente. Utilisez ceci pour que Claude Code localise la cause racine et propose une correction sans que vous ayez besoin d'identifier d'abord le fichier source.
Exemple de prompt :
> the tests in tests/auth.test.ts are failing, can you figure out why and fix them
Résultat attendu : Claude Code lit le fichier de test, trace le chemin du code à travers les modules testés, identifie l'incohérence et propose une modification. Après votre approbation, il réexécute la suite de tests pour confirmer la correction.
2. Comprendre du code inconnu
Quand l'utiliser : Vous devez comprendre comment un module, une fonction ou un sous-système fonctionne avant d'apporter des modifications, par exemple lors de l'héritage de code ou de l'examen d'une zone inconnue.
Exemple de prompt :
> walk me through how the payment retry logic works
Résultat attendu : Claude Code localise les fichiers pertinents, lit l'implémentation et explique le flux de contrôle en langage clair : points d'entrée, branches de décision, cas limites et comment le code se connecte au reste du système. Posez des questions de suivi (par exemple, « où X est-il défini ») pour approfondir.
3. Trouver où quelque chose se produit
Quand l'utiliser : Vous savez qu'un comportement existe dans la base de code mais ne pouvez pas le localiser par nom de fichier ou recherche textuelle simple.
Exemple de prompt :
> where do we validate email addresses in this codebase? I want to add a new rule
Résultat attendu : Claude Code recherche dans le référentiel, ouvre les fichiers candidats et retourne les chemins de fichiers et les numéros de ligne avec suffisamment de contexte environnant pour identifier la correspondance correcte. S'il existe plusieurs emplacements, il indique lequel est la source de vérité.
4. Trier une erreur ou une trace de pile
Quand l'utiliser : Vous avez une erreur d'exécution, une trace de pile ou une sortie de journal et devez la mapper au code responsable.
Exemple de prompt :
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>
Résultat attendu : Claude Code lit les fichiers référencés dans la trace, explique ce qui n'est pas défini et pourquoi, et propose une correction. Pour les erreurs sans trace de pile claire, collez toute sortie de journal disponible et Claude Code reconstruira l'échec à partir du contexte.
5. Refactoriser avec un plan
Quand l'utiliser : Une modification s'étend sur plusieurs fichiers et vous souhaitez examiner l'étendue complète avant d'apporter des modifications.
Prérequis : Appuyez sur Maj+Tab jusqu'à ce que l'indicateur de mode affiche « plan. »
Exemple de prompt :
> refactor the auth module to use the new session store instead of SessionCache
Résultat attendu : Claude Code analyse le code et produit un plan numéroté listant chaque fichier qu'il modifiera et la modification dans chacun. Vous pouvez approuver le plan tel quel ou l'amender (par exemple, « ne touchez pas à la route de déconnexion »). Aucun fichier n'est modifié jusqu'à votre approbation.
Référence : Permissions
6. Écrire des tests pour le code existant
Quand l'utiliser : Un fichier source manque de couverture, ou vous avez besoin de tests de cas limites supplémentaires qui correspondent aux conventions de test existantes de votre projet.
Exemple d'invite :
> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/
Résultat attendu : Claude Code lit le fichier source et le répertoire de tests de référence, génère un nouveau fichier de test dans le style existant et l'exécute pour confirmer que les tests réussissent. S'il reste des lacunes de couverture évidentes, il les signale et demande s'il faut les traiter.
7. Examiner une demande de fusion
Quand l'utiliser : Vous devez examiner ou résumer une PR, particulièrement dans une zone de la base de code que vous ne connaissez pas bien.
Prérequis : GitHub CLI authentifié (exécutez gh auth login une fois).
Exemple d'invite :
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /pr-comments
https://github.com/acme/api/pull/4471<br /> > is the error handling
solid?</td> </tr> </tbody> </table>
Résultat attendu : Claude Code récupère le diff, les commentaires d'examen et l'état de l'IC, puis lit les fichiers modifiés dans leur contexte complet du référentiel. Il peut produire un examen ciblé, rédiger des commentaires d'examen, vérifier une préoccupation spécifique ou résumer la PR.
8. Intégration à un nouveau référentiel
Quand l'utiliser : Vous travaillez dans un référentiel pour la première fois et avez besoin d'un aperçu structuré de son architecture, ses commandes de compilation et ses conventions.
Exemple d'invite :
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /init<br /> > give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>
Résultat attendu : /init analyse le projet et écrit un fichier CLAUDE.md résumant les commandes de compilation, l'architecture et les conventions. L'invite de visite de suivi produit une visite guidée de la structure du projet. Le contexte du projet reste chargé pour le reste de la session.
Référence : Mémoire et CLAUDE.md
9. Traiter un problème de bout en bout
Quand l'utiliser : Vous voulez lire un ticket, implémenter le correctif et le valider dans une seule conversation sans changer d'outil.
Prérequis : Suivi des problèmes connecté via MCP (configuration .mcp.json unique).
Exemple d'invite :
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> what's the top-priority issue assigned
to me?<br /> > go ahead and fix it</td> </tr> </tbody> </table>
Résultat attendu : Claude Code interroge le suivi des problèmes, lit le ticket, localise le code pertinent, propose un correctif et exécute les tests. La session se termine par un diff vérifiable et le contexte nécessaire pour fermer le ticket.
Référence : MCP
10. Transformer une tâche récurrente en commande slash
Quand l'utiliser : Vous répétez régulièrement la même invite multi-étapes (vérifications pré-commit, résumés de standup, descriptions de PR, notes de version) et souhaitez la rendre réutilisable pour toute l'équipe.
Exemple d'invite :
> make me a /ship command that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing
Résultat attendu : Claude Code écrit un fichier markdown dans .claude/commands/. La commande /ship est disponible immédiatement, sans redémarrage requis, et est partagée avec quiconque clone le référentiel.
Référence : Commandes slash
Annexe : Référence rapide
# | Cas d'usage | Exemple d'invite |
1 | Corriger un test défaillant |
|
2 | Comprendre du code inconnu |
|
3 | Trouver où quelque chose se produit |
|
4 | Trier une erreur | Collez la trace de pile, puis demandez : |
5 | Refactoriser avec un plan | Maj+Tab → mode plan → décrivez la refactorisation |
6 | Écrire des tests |
|
7 | Examiner une PR |
|
8 | Intégrer un dépôt |
|
9 | Traiter un problème de bout en bout |
|
10 | Créer une commande slash |
|
Annexe : Répertoire des ressources
Ressource | Lien |
Guide de démarrage | |
Flux de travail courants | |
Autorisations | |
Mémoire et | |
Connecteurs MCP | |
Commandes slash |
Pour plus de détails sur /init, les références @, les modes de permission, les compétences, MCP et les hooks, consultez code.claude.com/docs. Claude Code se met à jour fréquemment—vérifiez les détails spécifiques à la version sur code.claude.com/docs avant de distribuer en interne.