Tutoriels

Ce guide fournit des tutoriels étape par étape pour les flux de travail courants avec Claude Code. Chaque tutoriel comprend des instructions claires, des exemples de commandes et des bonnes pratiques pour vous aider à tirer le meilleur parti de Claude Code.

​

Table des matières

• Reprendre les conversations précédentes
• Comprendre de nouvelles bases de code
• Corriger les bugs efficacement
• Refactoriser le code
• Travailler avec les tests
• Créer des pull requests
• Gérer la documentation
• Travailler avec des images
• Utiliser la réflexion approfondie
• Configurer la mémoire du projet
• Configurer le Model Context Protocol (MCP)
• Utiliser Claude comme un utilitaire unix
• Créer des commandes slash personnalisées
• Exécuter des sessions Claude Code parallèles avec Git worktrees

​

Reprendre les conversations précédentes

​

Poursuivre votre travail sans interruption

Quand l’utiliser : Vous avez travaillé sur une tâche avec Claude Code et vous devez continuer là où vous vous êtes arrêté lors d’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

claude --continue

claude --continue --print "Continuer avec ma tâche"

claude --resume

Comment ça fonctionne :

1. Stockage des conversations : Toutes les conversations sont automatiquement sauvegardées localement avec leur historique complet de 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 préservés
4. Restauration du contexte : La conversation reprend avec tout le contexte précédent intact

Conseils :

• L’historique des conversations est stocké localement sur votre machine
• Utilisez --continue pour accéder rapidement à 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

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 "Montre-moi notre progression"

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

# Continuer la conversation la plus récente en mode non interactif
claude --continue --print "Exécuter à nouveau les tests"

​

Comprendre de nouvelles bases de code

​

Obtenir un aperçu rapide de la base de code

Quand l’utiliser : Vous venez de rejoindre un nouveau projet et vous devez comprendre rapidement sa structure.

cd /chemin/vers/projet 

claude 

> donne-moi un aperçu de cette base de code 

> explique les principaux modèles d'architecture utilisés ici 

> quels sont les modèles de données clés ?

> comment l'authentification est-elle gérée ?

Conseils :

• Commencez par des questions générales, puis concentrez-vous sur des domaines spécifiques
• Demandez des informations 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

Quand l’utiliser : Vous devez localiser du code lié à une fonctionnalité spécifique.

> trouve les fichiers qui gèrent l'authentification des utilisateurs 

> comment ces fichiers d'authentification fonctionnent-ils ensemble ? 

> trace le processus de connexion du front-end à la base de données 

Conseils :

• Soyez précis sur ce que vous recherchez
• Utilisez le langage du domaine du projet

​

Corriger les bugs efficacement

​

Diagnostiquer les messages d’erreur

Quand l’utiliser : Vous avez rencontré un message d’erreur et vous devez trouver et corriger sa source.

> Je vois une erreur quand j'exécute npm test 

> suggère quelques façons de corriger le @ts-ignore dans user.ts 

> mets à jour user.ts pour ajouter la vérification de null que tu as suggérée 

Conseils :

• Indiquez à Claude la commande pour reproduire le problème et obtenir une trace de la pile
• Mentionnez les étapes pour reproduire l’erreur
• Faites savoir à Claude si l’erreur est intermittente ou constante

​

Refactoriser le code

​

Moderniser le code legacy

Quand l’utiliser : Vous devez mettre à jour du code ancien pour utiliser des modèles et des pratiques modernes.

> trouve les utilisations d'API obsolètes dans notre base de code 

> suggère comment refactoriser utils.js pour utiliser les fonctionnalités modernes de JavaScript 

> refactorise utils.js pour utiliser les fonctionnalités ES2024 tout en maintenant le même comportement 

> exécute les tests pour le code refactorisé 

Conseils :

• Demandez à Claude d’expliquer les avantages de l’approche moderne
• Demandez que les changements maintiennent la compatibilité ascendante si nécessaire
• Effectuez la refactorisation par petits incréments testables

​

Travailler avec les tests

​

Ajouter de la couverture de test

Quand l’utiliser : Vous devez ajouter des tests pour du code non couvert.

> trouve les fonctions dans NotificationsService.swift qui ne sont pas couvertes par des tests 

> ajoute des tests pour le service de notification 

> ajoute des cas de test pour les conditions limites dans le service de notification 

> exécute les nouveaux tests et corrige les échecs éventuels 

Conseils :

• Demandez des tests qui couvrent les cas limites et les conditions d’erreur
• Demandez à la fois des tests unitaires et d’intégration lorsque c’est approprié
• Demandez à Claude d’expliquer la stratégie de test

​

Créer des pull requests

​

Générer des PR complètes

Quand l’utiliser : Vous devez créer une pull request bien documentée pour vos modifications.

> résume les modifications que j'ai apportées au module d'authentification 

> crée une pr 

> améliore la description de la PR avec plus de contexte sur les améliorations de sécurité 

> ajoute des informations sur la façon dont ces modifications ont été testées 

Conseils :

• Demandez directement à Claude de créer une PR pour vous
• Révisez la PR générée par Claude avant de la soumettre
• Demandez à Claude de mettre en évidence les risques potentiels ou les considérations

​

Gérer la documentation

​

Générer de la documentation de code

Quand l’utiliser : Vous devez ajouter ou mettre à jour la documentation de votre code.

> trouve les fonctions sans commentaires JSDoc appropriés dans le module auth 

> ajoute des commentaires JSDoc aux fonctions non documentées dans auth.js 

> améliore la documentation générée avec plus de contexte et d'exemples 

> vérifie si la documentation suit les normes de notre projet 

Conseils :

• Spécifiez le style de documentation que vous souhaitez (JSDoc, docstrings, etc.)
• Demandez des exemples dans la documentation
• Demandez de la documentation pour les API publiques, les interfaces et la logique complexe

​

Travailler avec des images

​

Analyser des images et des captures d’écran

Quand l’utiliser : Vous devez travailler avec des images dans votre base de code ou obtenir l’aide de Claude pour analyser le contenu des images.

> Que montre cette image ? 
> Décris les éléments d'interface utilisateur dans cette capture d'écran 
> Y a-t-il des éléments problématiques dans ce diagramme ? 

> Voici une capture d'écran de l'erreur. Quelle en est la cause ? 
> Voici notre schéma de base de données actuel. Comment devrions-nous le modifier pour la nouvelle fonctionnalité ? 

> Génère du CSS pour correspondre à cette maquette de design 
> Quelle structure HTML recréerait ce composant ? 

Conseils :

• Utilisez des images lorsque les descriptions textuelles seraient peu claires ou encombrantes
• 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’image fonctionne avec des diagrammes, des captures d’écran, des maquettes, et plus encore

​

Utiliser la réflexion approfondie

​

Exploiter la réflexion approfondie de Claude pour des tâches complexes

Quand l’utiliser : Lorsque vous travaillez sur des décisions architecturales complexes, des bugs difficiles ou la planification d’implémentations en plusieurs étapes qui nécessitent un raisonnement approfondi.

> J'ai besoin d'implémenter un nouveau système d'authentification utilisant OAuth2 pour notre API. Réfléchis en profondeur à la meilleure approche pour l'implémenter dans notre base de code. 

> réfléchis aux vulnérabilités de sécurité potentielles dans cette approche 
> réfléchis davantage aux cas limites que nous devrions gérer 

Conseils pour tirer le meilleur parti de la réflexion approfondie :

La réflexion approfondie est particulièrement utile pour les tâches complexes telles que :

• Planifier des changements architecturaux complexes
• Déboguer des problèmes complexes
• Créer des plans d’implémentation pour de nouvelles fonctionnalités
• Comprendre des bases de code complexes
• Évaluer les compromis entre différentes approches

La façon dont vous demandez la réflexion entraîne différents niveaux de profondeur de réflexion :

• “réfléchis” déclenche une réflexion approfondie de base
• des phrases d’intensification comme “réfléchis plus”, “réfléchis beaucoup”, “réfléchis davantage” ou “réfléchis plus longtemps” déclenchent une réflexion plus profonde

Pour plus de conseils sur les invites de réflexion approfondie, voir Conseils pour la réflexion approfondie.

​

Configurer la mémoire du projet

​

Créer un fichier CLAUDE.md efficace

Quand l’utiliser : Vous souhaitez configurer un fichier CLAUDE.md pour stocker des informations importantes sur le projet, des conventions et des commandes fréquemment utilisées.

> /init 

Conseils :

• Incluez les commandes fréquemment utilisées (build, test, lint) pour éviter des recherches répétées
• Documentez les préférences de style de code et les conventions de nommage
• Ajoutez des modèles architecturaux importants spécifiques à votre projet
• Les mémoires CLAUDE.md peuvent être utilisées à la fois pour des instructions partagées avec votre équipe et pour vos préférences individuelles. Pour plus de détails, voir Gérer la mémoire de Claude.

​

Configurer le Model Context Protocol (MCP)

Model Context Protocol (MCP) est un protocole ouvert qui permet aux LLM d’accéder à des outils externes et à des sources de données. Pour plus de détails, consultez la documentation MCP.

​

Configurer les serveurs MCP

Quand l’utiliser : Vous souhaitez améliorer les capacités de Claude en le connectant à des outils spécialisés et à des serveurs externes à l’aide du Model Context Protocol.

# Syntaxe de base
claude mcp add <nom> <commande> [args...]

# Exemple : Ajouter un serveur local
claude mcp add mon-serveur -e API_KEY=123 -- /chemin/vers/serveur arg1 arg2

# Syntaxe de base
claude mcp add --transport sse <nom> <url>

# Exemple : Ajouter un serveur SSE
claude mcp add --transport sse serveur-sse https://exemple.com/point-terminaison-sse

# Lister tous les serveurs configurés
claude mcp list

# Obtenir les détails d'un serveur spécifique
claude mcp get mon-serveur

# Supprimer un serveur
claude mcp remove mon-serveur

Conseils :

• Utilisez l’option -s ou --scope pour spécifier où la configuration est stockée :
  • local (par défaut) : Disponible uniquement pour vous dans le projet actuel (s’appelait project dans les versions plus anciennes)
  • project : Partagé avec tout le monde dans le projet via le fichier .mcp.json
  • user : Disponible pour vous dans tous les projets (s’appelait global dans les versions plus anciennes)
• Définissez des variables d’environnement avec les options -e ou --env (par exemple, -e CLE=valeur)
• Configurez le délai de démarrage du serveur MCP à l’aide de la variable d’environnement MCP_TIMEOUT (par exemple, MCP_TIMEOUT=10000 claude définit un délai de 10 secondes)
• Vérifiez l’état du serveur MCP à tout moment à l’aide de la commande /mcp dans Claude Code
• MCP suit une architecture client-serveur où Claude Code (le client) peut se connecter à plusieurs serveurs spécialisés

​

Comprendre les portées des serveurs MCP

Quand l’utiliser : Vous voulez comprendre comment fonctionnent les différentes portées MCP et comment partager des serveurs avec votre équipe.

# Ajouter un serveur à portée locale (par défaut)
claude mcp add mon-serveur-prive /chemin/vers/serveur

# Spécifier explicitement la portée locale
claude mcp add mon-serveur-prive -s local /chemin/vers/serveur

# Ajouter un serveur à portée de projet
claude mcp add serveur-partage -s project /chemin/vers/serveur

{
  "mcpServers": {
    "serveur-partage": {
      "command": "/chemin/vers/serveur",
      "args": [],
      "env": {}
    }
  }
}

# Ajouter un serveur utilisateur
claude mcp add mon-serveur-utilisateur -s user /chemin/vers/serveur

Conseils :

• Les serveurs à portée locale ont priorité sur les serveurs à portée de projet et à portée utilisateur portant le même nom
• Les serveurs à portée de projet (dans .mcp.json) ont priorité sur les serveurs à portée utilisateur portant le même nom
• Avant d’utiliser les serveurs à portée de projet depuis .mcp.json, Claude Code vous demandera de les approuver pour des raisons de sécurité
• Le fichier .mcp.json est destiné à être enregistré dans le contrôle de version pour partager les serveurs MCP avec votre équipe
• Les serveurs à portée de projet facilitent l’accès de tous les membres de votre équipe aux mêmes outils MCP
• Si vous devez réinitialiser vos choix concernant les serveurs à portée de projet activés ou désactivés, utilisez la commande claude mcp reset-project-choices

​

Se connecter à un serveur MCP Postgres

Quand l’utiliser : Vous souhaitez donner à Claude un accès en lecture seule à une base de données PostgreSQL pour des requêtes et l’inspection du schéma.

claude mcp add serveur-postgres /chemin/vers/serveur-mcp-postgres --connection-string "postgresql://utilisateur:mot_de_passe@localhost:5432/mabd"

# Dans votre session Claude, vous pouvez poser des questions sur votre base de données

> décris le schéma de notre table utilisateurs
> quelles sont les commandes les plus récentes dans le système ?
> montre-moi la relation entre les clients et les factures

Conseils :

• Le serveur MCP Postgres fournit un accès en lecture seule pour des raisons de sécurité
• Claude peut vous aider à explorer la structure de la base de données et à exécuter des requêtes analytiques
• Vous pouvez l’utiliser pour comprendre rapidement les schémas de base de données dans des projets peu familiers
• Assurez-vous que votre chaîne de connexion utilise des identifiants appropriés avec les autorisations minimales requises

​

Ajouter des serveurs MCP à partir d’une configuration JSON

Quand l’utiliser : Vous avez une configuration JSON pour un seul serveur MCP que vous souhaitez ajouter à Claude Code.

# Syntaxe de base
claude mcp add-json <nom> '<json>'

# Exemple : Ajouter un serveur stdio avec une configuration JSON
claude mcp add-json api-meteo '{"type":"stdio","command":"/chemin/vers/cli-meteo","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get api-meteo

Conseils :

• Assurez-vous que le JSON est correctement échappé dans votre shell
• Le JSON doit être conforme au schéma de configuration du serveur MCP
• Vous pouvez utiliser -s global pour ajouter le serveur à votre configuration globale au lieu de celle spécifique au projet

​

Importer des serveurs MCP depuis Claude Desktop

Quand l’utiliser : Vous avez déjà configuré des serveurs MCP dans Claude Desktop et vous souhaitez utiliser les mêmes serveurs dans Claude Code sans les reconfigurer manuellement.

# Syntaxe de base 
claude mcp add-from-claude-desktop 

claude mcp list 

Conseils :

• Cette fonctionnalité ne fonctionne que sur macOS et Windows Subsystem for Linux (WSL)
• Elle lit le fichier de configuration de Claude Desktop depuis son emplacement standard sur ces plateformes
• Utilisez l’option -s global pour ajouter des serveurs à votre configuration globale
• Les serveurs importés auront les mêmes noms que dans Claude Desktop
• Si des serveurs portant les mêmes noms existent déjà, ils recevront un suffixe numérique (par exemple, serveur_1)

​

Utiliser Claude Code comme serveur MCP

Quand l’utiliser : Vous souhaitez utiliser Claude Code lui-même comme serveur MCP auquel d’autres applications peuvent se connecter, leur fournissant les outils et capacités de Claude.

# Syntaxe de base
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Conseils :

• Le serveur donne accès aux outils de Claude comme View, Edit, LS, etc.
• Dans Claude Desktop, essayez de demander à Claude de lire des fichiers dans un répertoire, de faire des modifications, et plus encore.
• Notez que ce serveur MCP expose simplement les outils de Claude Code à votre client MCP, donc votre propre client est responsable de l’implémentation de la confirmation utilisateur pour les appels d’outils individuels.

​

Utiliser Claude comme un utilitaire unix

​

Ajouter Claude à votre processus de vérification

Quand l’utiliser : Vous souhaitez utiliser Claude Code comme un linter ou un réviseur de code.

Étapes :

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'tu es un linter. examine les changements par rapport à main et signale tous les problèmes liés aux fautes de frappe. indique le nom du fichier et le numéro de ligne sur une ligne, et une description du problème sur la deuxième ligne. ne renvoie aucun autre texte.'"
    }
}

​

Entrée et sortie par tube (pipe)

Quand l’utiliser : Vous souhaitez envoyer des données à Claude par tube, et récupérer des données dans un format structuré.

cat build-error.txt | claude -p 'explique de manière concise la cause principale de cette erreur de build' > output.txt

​

Contrôler le format de sortie

Quand l’utiliser : Vous avez 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.

cat data.txt | claude -p 'résume ces données' --output-format text > resume.txt

cat code.py | claude -p 'analyse ce code pour trouver des bugs' --output-format json > analyse.json

cat log.txt | claude -p 'analyse ce fichier journal pour trouver des erreurs' --output-format stream-json

Conseils :

• Utilisez --output-format text pour des intégrations simples où vous avez juste besoin de la réponse de Claude
• Utilisez --output-format json lorsque vous avez besoin du journal complet de la conversation
• Utilisez --output-format stream-json pour une 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.

​

Créer des commandes spécifiques au projet

Quand l’utiliser : Vous souhaitez créer des commandes slash réutilisables pour votre projet que tous les membres de l’équipe peuvent utiliser.

mkdir -p .claude/commands

echo "Analyse les performances de ce code et suggère trois optimisations spécifiques :" > .claude/commands/optimize.md 

claude > /project:optimize 

Conseils :

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

​

Ajouter des arguments de commande avec $ARGUMENTS

Quand l’utiliser : Vous souhaitez créer des commandes slash flexibles qui peuvent accepter des entrées supplémentaires des utilisateurs.

echo "Trouve et corrige le problème #$ARGUMENTS. Suis ces étapes : 1.
Comprendre le problème décrit dans le ticket 2. Localiser le code pertinent dans
notre base de code 3. Implémenter une solution qui traite la cause profonde 4. Ajouter
des tests appropriés 5. Préparer une description de PR concise" >
.claude/commands/fix-issue.md 

claude > /project:fix-issue 123 

Conseils :

• Le placeholder $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 des composants, réviser du code dans des fichiers particuliers, ou traduire du contenu vers des langues spécifiées

​

Créer des commandes slash personnelles

Quand l’utiliser : Vous souhaitez créer des commandes slash personnelles qui fonctionnent dans tous vos projets.

mkdir -p ~/.claude/commands 

echo "Examine ce code pour détecter des vulnérabilités de sécurité, en te concentrant sur :" >
~/.claude/commands/security-review.md 

claude > /user:security-review 

Conseils :

• Les commandes personnelles sont préfixées par /user: au lieu de /project:
• Les commandes personnelles ne sont disponibles que pour vous et ne sont pas partagées avec votre équipe
• Les commandes personnelles fonctionnent dans tous vos projets
• Vous pouvez les utiliser pour des flux de travail cohérents à travers différentes bases de code

​

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

​

Utiliser les worktrees pour des environnements de codage isolés

Quand l’utiliser : Vous devez travailler sur plusieurs tâches simultanément avec une isolation complète du code entre les instances de Claude Code.

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

# Ou créer un worktree avec une branche existante
git worktree add ../projet-correctif correctif-123

# Naviguer vers votre worktree 
cd ../projet-fonctionnalite-a

# Exécuter Claude Code dans cet environnement isolé
claude

cd ../projet-correctif
claude

# Lister tous les worktrees
git worktree list

# Supprimer un worktree lorsque vous avez terminé
git worktree remove ../projet-fonctionnalite-a

Conseils :

• Chaque worktree a son propre état de fichier indépendant, ce qui est parfait pour les sessions Claude Code parallèles
• Les modifications apportées dans un worktree n’affecteront pas les autres, empêchant les instances de Claude d’interférer entre elles
• Tous les worktrees partagent le même historique Git et les mêmes connexions distantes
• Pour les tâches de longue durée, vous pouvez avoir Claude travaillant dans un worktree pendant que vous continuez le développement dans un autre
• Utilisez des noms de répertoire descriptifs pour identifier facilement la tâche à 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 stack, cela peut inclure :
  • Projets JavaScript : Exécution de l’installation des dépendances (npm install, yarn)
  • Projets Python : Configuration d’environnements virtuels ou installation avec des gestionnaires de paquets
  • Autres langages : Suivre le processus de configuration standard de votre projet

​

Prochaines étapes