Passer au contenu principal
Chaque tâche dans ce document inclut des instructions claires, des exemples de commandes et les meilleures pratiques pour vous aider à tirer le meilleur parti de Claude Code.

​
Comprendre les nouvelles bases de code

​
Obtenir un aperçu rapide de la base de code

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

Accédez au répertoire racine du projet

cd /path/to/project
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?
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 le code pertinent

Supposons que vous ayez besoin de localiser du code lié à une fonctionnalité ou une fonctionnalité 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
Conseils :
  • Soyez précis sur ce que vous recherchez
  • Utilisez le langage du domaine du projet

​
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
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 constante

​
Refactoriser le code

Supposons que vous ayez besoin de mettre à jour l’ancien code pour utiliser des modèles et des pratiques modernes.
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
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

​
Utiliser des sous-agents spécialisés

Supposons que vous souhaitiez utiliser des sous-agents IA spécialisés pour gérer des tâches spécifiques plus efficacement.
1

Afficher les sous-agents disponibles

> /agents
Cela affiche tous les sous-agents disponibles et vous permet d’en créer de nouveaux.
2

Utiliser les sous-agents automatiquement

Claude Code délèguera automatiquement les tâches appropriées aux sous-agents spécialisés :
> review my recent code changes for security issues

> run all tests and fix any failures
3

Demander explicitement des sous-agents spécifiques

> use the code-reviewer subagent to check the auth module

> have the debugger subagent investigate why users can't log in
4

Créer des sous-agents personnalisés pour votre flux de travail

> /agents
Sélectionnez ensuite « Créer un nouveau sous-agent » et suivez les invites pour définir :
  • Type de sous-agent (par exemple, api-designer, performance-optimizer)
  • Quand l’utiliser
  • Quels outils il peut accéder
  • Son invite système spécialisée
Conseils :
  • Créez des sous-agents spécifiques au projet dans .claude/agents/ pour le partage en équipe
  • Utilisez des champs description descriptifs pour activer la délégation automatique
  • Limitez l’accès aux outils à ce dont chaque sous-agent a réellement besoin
  • Consultez la documentation des sous-agents pour des exemples détaillés

​
Utiliser le mode Plan pour une analyse de code sûre

Le mode Plan demande à Claude de créer un plan en analysant la base de code avec des opérations en lecture seule, parfait pour explorer les bases de code, planifier des modifications complexes ou examiner le code en toute sécurité.

​
Quand utiliser le mode Plan

  • Implémentation multi-étapes : Lorsque votre fonctionnalité nécessite d’apporter des modifications à de nombreux fichiers
  • Exploration du code : Lorsque vous souhaitez rechercher la base de code en profondeur avant de modifier quoi que ce soit
  • Développement interactif : Lorsque vous souhaitez itérer sur la direction avec Claude

​
Comment utiliser le mode Plan

Activez le mode Plan pendant une session Vous pouvez basculer en mode Plan pendant une session en utilisant Maj+Tab pour parcourir les modes d’autorisation. Si vous êtes en mode Normal, Maj+Tab basculera d’abord en mode Auto-Accept, indiqué par ⏵⏵ accept edits on en bas du terminal. Un Maj+Tab ultérieur basculera en mode Plan, indiqué par ⏸ plan mode on. Démarrez une nouvelle session en mode Plan Pour démarrer une nouvelle session en mode Plan, utilisez l’indicateur --permission-mode plan : 
claude --permission-mode plan
Exécutez des requêtes « headless » en mode Plan Vous pouvez également exécuter une requête en mode Plan directement avec -p (c’est-à-dire en « mode headless ») : 
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

​
Exemple : Planifier une refactorisation complexe

claude --permission-mode plan

> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
Claude analysera l’implémentation actuelle et créera un plan complet. Affinez avec des suites : 
> What about backward compatibility?
> How should we handle database migration?

​
Configurer le mode Plan par défaut

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
Consultez la documentation des paramètres pour plus d’options de configuration.

​
Travailler avec les tests

Supposons que vous ayez besoin d’ajouter des tests pour le code non couvert.
1

Identifier le code non testé

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

Générer l'échafaudage de test

> add tests for the notification service
3

Ajouter 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
Conseils :
  • Demandez des tests qui couvrent les cas limites et les conditions d’erreur
  • Demandez des tests unitaires et d’intégration le cas échéant
  • Demandez à Claude d’expliquer la stratégie de test

​
Créer des demandes de tirage

Supposons que vous ayez besoin de créer une demande de tirage bien documentée pour vos modifications.
1

Résumez vos modifications

> summarize the changes I've made to the authentication module
2

Générer une PR avec Claude

> create a pr
3

Examinez et affinez

> enhance the PR description with more context about the security improvements
4

Ajouter des détails de test

> add information about how these changes were tested
Conseils :
  • Demandez à Claude de créer directement une PR pour vous
  • Examinez la PR générée par Claude avant de la soumettre
  • 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

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

Examinez et améliorez

> improve the generated documentation with more context and examples
4

Vérifier 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 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

Ajouter une image à la conversation

Vous pouvez utiliser l’une de ces méthodes :
  1. Glissez-déposez une image dans la fenêtre Claude Code
  2. Copiez une image et collez-la dans l’interface de ligne de commande avec ctrl+v (N’utilisez pas cmd+v)
  3. Fournissez un chemin d’image à Claude. Par exemple, « Analysez 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

Utiliser 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

Obtenir des suggestions de code à partir du contenu visuel

> Generate CSS to match this design mockup

> What HTML structure would recreate this component?
Conseils :
  • Utilisez des images lorsque 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 des diagrammes, des captures d’écran, des maquettes, etc.

​
Fichiers et répertoires de référence

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 complet du fichier dans la conversation.
2

Référencer un répertoire

> What's the structure of @src/components?
Cela fournit une liste de répertoires avec des informations sur les fichiers.
3

Ressources MCP de référence

> 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.md dans 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 le contenu
  • Vous pouvez référencer plusieurs fichiers dans un seul message (par exemple, « @file1.js et @file2.js »)

​
Utiliser la réflexion étendue

Supposons que vous travailliez sur des décisions architecturales complexes, des bogues difficiles ou la planification d’implémentations multi-étapes qui nécessitent un raisonnement approfondi.
La réflexion étendue est désactivée par défaut dans Claude Code. Vous pouvez l’activer à la demande en utilisant Tab pour activer la réflexion, ou en utilisant des invites comme « think » ou « think hard ». Vous pouvez également l’activer de manière permanente en définissant la variable d’environnement MAX_THINKING_TOKENS dans vos paramètres.
1

Fournir du contexte et demander à Claude de réfléchir

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase.
Claude rassemblera les informations pertinentes de votre base de code et utilisera la réflexion étendue, qui sera visible dans l’interface.
2

Affinez la réflexion avec des invites de suivi

> think about potential security vulnerabilities in this approach 

> think hard about edge cases we should handle
Conseils pour tirer le meilleur parti de la réflexion étendue :La réflexion étendue est la plus précieuse pour les tâches complexes telles que :
  • Planifier des modifications architecturales complexes
  • Déboguer des problèmes complexes
  • Créer des plans de mise en œuvre pour les nouvelles fonctionnalités
  • Comprendre les bases de code complexes
  • Évaluer les compromis entre différentes approches
Utilisez Tab pour activer et désactiver la réflexion pendant une session.La façon dont vous demandez les résultats de la réflexion entraîne des niveaux de profondeur de réflexion variables :
  • « think » déclenche une réflexion étendue de base
  • l’intensification des phrases telles que « keep hard », « think more », « think a lot » ou « think longer » déclenche une réflexion plus profonde
Pour plus de conseils sur les invites de réflexion étendue, consultez Conseils de réflexion étendue.
Claude affichera son processus de réflexion sous forme de texte gris italique au-dessus de la réponse.

​
Reprendre les conversations précédentes

Supposons que vous ayez travaillé sur une tâche avec Claude Code et que vous ayez besoin de continuer où vous vous étiez arrêté dans une session ultérieure. Claude Code propose deux options pour reprendre les conversations précédentes :
  • --continue pour continuer automatiquement la conversation la plus récente
  • --resume pour afficher un sélecteur de conversation
1

Continuer la conversation la plus récente

claude --continue
Cela reprend immédiatement votre conversation la plus récente sans aucune invite.
2

Continuer en mode non interactif

claude --continue --print "Continue with my task"
Utilisez --print avec --continue pour reprendre la conversation la plus récente en mode non interactif, parfait pour les scripts ou l’automatisation.
3

Afficher le sélecteur de conversation

claude --resume
Cela affiche un sélecteur de conversation interactif avec une vue de liste propre affichant :
  • Résumé de la session (ou invite initiale)
  • Métadonnées : temps écoulé, nombre de messages et branche git
Utilisez les touches fléchées pour naviguer et appuyez sur Entrée pour sélectionner une conversation. Appuyez sur Échap pour quitter.
Conseils :
  • L’historique des conversations est stocké localement sur votre machine
  • Utilisez --continue pour un accès rapide à votre conversation la plus récente
  • Utilisez --resume lorsque vous devez sélectionner une conversation passée spécifique
  • Lors de la reprise, vous verrez l’historique complet de la conversation avant de continuer
  • La conversation reprise commence avec le même modèle et la même configuration que l’original
Comment ça marche :
  1. Stockage des conversations : Toutes les conversations sont automatiquement enregistrées localement avec leur historique complet des messages
  2. Désérialisation des messages : Lors de la reprise, l’historique complet des messages est restauré pour maintenir le contexte
  3. État des outils : L’utilisation des outils et les résultats de la conversation précédente sont conservés
  4. Restauration du contexte : La conversation reprend avec tout le contexte précédent intact
Exemples :
# Continuer la conversation la plus récente
claude --continue

# Continuer la conversation la plus récente avec une invite spécifique
claude --continue --print "Show me our progress"

# Afficher le sélecteur de conversation
claude --resume

# Continuer la conversation la plus récente en mode non interactif
claude --continue --print "Run the tests again"

​
Exécuter des sessions Claude Code parallèles avec des worktrees Git

Supposons que vous ayez besoin de travailler sur plusieurs tâches simultanément avec un isolement complet du code entre les instances Claude Code.
1

Comprendre les worktrees Git

Les worktrees Git vous permettent d’extraire plusieurs branches du même référentiel dans des répertoires séparés. Chaque worktree a son propre répertoire de travail avec des fichiers isolés, tout en partageant le même historique Git. En savoir plus dans la documentation officielle des worktrees Git.
2

Créer un nouveau worktree

# Créer un nouveau worktree avec une nouvelle branche 
git worktree add ../project-feature-a -b feature-a

# Ou créer un worktree avec une branche existante
git worktree add ../project-bugfix bugfix-123
Cela crée un nouveau répertoire avec une copie de travail séparée de votre référentiel.
3

Exécuter Claude Code dans chaque worktree

# Accédez à votre worktree 
cd ../project-feature-a

# Exécutez Claude Code dans cet environnement isolé
claude
4

Exécuter Claude dans un autre worktree

cd ../project-bugfix
claude
5

Gérer vos worktrees

# Lister tous les worktrees
git worktree list

# Supprimer un worktree une fois terminé
git worktree remove ../project-feature-a
Conseils :
  • Chaque worktree a son propre état de fichier indépendant, ce qui le rend parfait pour les sessions Claude Code parallèles
  • Les modifications apportées dans un worktree n’affecteront pas les autres, empêchant les instances Claude d’interférer les unes avec les autres
  • Tous les worktrees partagent le même historique Git et les mêmes connexions distantes
  • Pour les tâches longues, vous pouvez avoir Claude travaillant dans un worktree pendant que vous continuez le développement dans un autre
  • Utilisez des noms de répertoires descriptifs pour identifier facilement la tâche pour laquelle chaque worktree est destiné
  • N’oubliez pas d’initialiser votre environnement de développement dans chaque nouveau worktree selon la configuration de votre projet. Selon votre pile, cela peut inclure :
    • Projets JavaScript : Exécution de l’installation des dépendances (npm install, yarn)
    • Projets Python : Configuration des environnements virtuels ou installation avec des gestionnaires de paquets
    • Autres langages : Suivi du processus de configuration standard de votre projet

​
Utiliser Claude comme un utilitaire de style Unix

​
Ajouter Claude à votre processus de vérification

Supposons que vous souhaitiez utiliser Claude Code comme linter ou examinateur de code. Ajouter Claude à votre script de compilation : 
// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}
Conseils :
  • Utilisez Claude pour l’examen automatisé du code dans votre pipeline CI/CD
  • Personnalisez l’invite pour vérifier les problèmes spécifiques pertinents pour votre projet
  • Envisagez de créer plusieurs scripts pour différents types de vérification

​
Tuyauter, tuyauter

Supposons que vous souhaitiez canaliser les données dans Claude et récupérer les données dans un format structuré. Canaliser les données via Claude : 
cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt
Conseils :
  • Utilisez les tuyaux pour intégrer Claude dans les scripts shell existants
  • Combinez avec d’autres outils Unix pour des flux de travail puissants
  • Envisagez d’utiliser —output-format pour une sortie structurée

​
Contrôler le format de sortie

Supposons que vous ayez besoin de la sortie de Claude dans un format spécifique, en particulier lors de l’intégration de Claude Code dans des scripts ou d’autres outils.
1

Utiliser le format texte (par défaut)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
Cela génère uniquement la réponse en texte brut de Claude (comportement par défaut).
2

Utiliser le format JSON

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
Cela génère un tableau JSON de messages avec des métadonnées incluant le coût et la durée.
3

Utiliser le format JSON en streaming

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
Cela génère une série d’objets JSON en temps réel au fur et à mesure que Claude traite la demande. Chaque message est un objet JSON valide, mais la sortie entière n’est pas un JSON valide s’il est concaténé.
Conseils :
  • Utilisez --output-format text pour les intégrations simples où vous avez juste besoin de la réponse de Claude
  • Utilisez --output-format json lorsque vous avez besoin du journal de conversation complet
  • Utilisez --output-format stream-json pour la sortie en temps réel de chaque tour de conversation

​
Créer des commandes slash personnalisées

Claude Code prend en charge les commandes slash personnalisées que vous pouvez créer pour exécuter rapidement des invites ou des tâches spécifiques. Pour plus de détails, consultez la page de référence Commandes slash.

​
Créer des commandes spécifiques au projet

Supposons que vous souhaitiez créer des commandes slash réutilisables pour votre projet que tous les membres de l’équipe peuvent utiliser.
1

Créer un répertoire de commandes dans votre projet

mkdir -p .claude/commands
2

Créer un fichier Markdown pour chaque commande

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md
3

Utiliser votre commande personnalisée dans Claude Code

> /optimize
Conseils :
  • Les noms de commande sont dérivés du nom de fichier (par exemple, optimize.md devient /optimize)
  • Vous pouvez organiser les commandes dans des sous-répertoires (par exemple, .claude/commands/frontend/component.md crée /component avec « (project:frontend) » affiché dans la description)
  • Les commandes de projet sont disponibles pour tous ceux qui clonent le référentiel
  • Le contenu du fichier Markdown devient l’invite envoyée à Claude lorsque la commande est appelée

​
Ajouter des arguments de commande avec $ARGUMENTS

Supposons que vous souhaitiez créer des commandes slash flexibles qui peuvent accepter des entrées supplémentaires des utilisateurs.
1

Créer un fichier de commande avec l'espace réservé $ARGUMENTS

echo 'Find and fix issue #$ARGUMENTS. Follow these steps: 1.
Understand the issue described in the ticket 2. Locate the relevant code in
our codebase 3. Implement a solution that addresses the root cause 4. Add
appropriate tests 5. Prepare a concise PR description' >
.claude/commands/fix-issue.md
2

Utiliser la commande avec un numéro de problème

Dans votre session Claude, utilisez la commande avec des arguments.
> /fix-issue 123
Cela remplacera $ARGUMENTS par « 123 » dans l’invite.
Conseils :
  • L’espace réservé $ARGUMENTS est remplacé par tout texte qui suit la commande
  • Vous pouvez positionner $ARGUMENTS n’importe où dans votre modèle de commande
  • Autres applications utiles : générer des cas de test pour des fonctions spécifiques, créer de la documentation pour les composants, examiner le code dans des fichiers particuliers ou traduire le contenu dans les langues spécifiées

​
Créer des commandes slash personnelles

Supposons que vous souhaitiez créer des commandes slash personnelles qui fonctionnent sur tous vos projets.
1

Créer un répertoire de commandes dans votre dossier personnel

mkdir -p ~/.claude/commands
2

Créer un fichier Markdown pour chaque commande

echo "Review this code for security vulnerabilities, focusing on:" >
~/.claude/commands/security-review.md
3

Utiliser votre commande slash personnelle personnalisée

> /security-review
Conseils :
  • Les commandes personnelles affichent « (user) » dans leur description lorsqu’elles sont listées avec /help
  • Les commandes personnelles ne sont disponibles que pour vous et ne sont pas partagées avec votre équipe
  • Les commandes personnelles fonctionnent sur tous vos projets
  • Vous pouvez les utiliser pour des flux de travail cohérents sur différentes bases de code

​
Demander à 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 slash commands 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 exemples exécutables et des démonstrations pratiques, 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

​
Prochaines étapes

Implémentation de référence Claude Code

Clonez notre implémentation de conteneur de développement de référence.