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 les meilleures pratiques pour tirer le meilleur parti de Claude Code.

​

Table des matières

• Reprendre les conversations précédentes
• Comprendre les 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 les 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 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 ma tâche"

claude --resume

Comment ça marche :

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 démarre 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 "Relancer les tests"

​

Comprendre les 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 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
• Renseignez-vous 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

Quand l’utiliser : Vous devez localiser le code lié à une fonctionnalité ou une fonction 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 devez en trouver et corriger la 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 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 l’ancien code pour utiliser des modèles et des pratiques modernes.

> trouve l'utilisation d'API dépréciées dans notre base de code 

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

> 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
• Faites la refactorisation par petits incréments testables

​

Travailler avec les tests

​

Ajouter la couverture de tests

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 

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é
• Faites expliquer la stratégie de test par Claude

​

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 changements.

> résume les changements que j'ai apportés 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 changements ont été testés 

Conseils :

• Demandez directement à Claude de créer 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 potentiels ou les considérations

​

Gérer la documentation

​

Générer la documentation du 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 nos standards de projet 

Conseils :

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

​

Travailler avec les images

​

Analyser les images et les 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 de l'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 fastidieuses
• Incluez des captures d’écran d’erreurs, de designs 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 les diagrammes, les captures d’écran, les maquettes et plus encore

​

Utiliser la réflexion approfondie

​

Exploiter la réflexion approfondie de Claude pour les 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.

> Je dois implémenter un nouveau système d'authentification utilisant OAuth2 pour notre API. Réfléchis en profondeur à la meilleure approche pour implémenter cela 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 plus précieuse 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
• les phrases d’intensification comme “réfléchis plus”, “réfléchis beaucoup”, “réfléchis plus fort” ou “réfléchis plus longtemps” déclenchent une réflexion plus profonde

Pour plus de conseils sur la 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 voulez 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 les 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 les 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)

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

​

Configurer les serveurs MCP

Quand l’utiliser : Vous voulez améliorer les capacités de Claude en le connectant à des outils spécialisés et des serveurs externes utilisant le 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://example.com/sse-endpoint

# 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 le flag -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 flags -e ou --env (par exemple, -e CLE=valeur)
• Configurez le délai de démarrage du serveur MCP en utilisant 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 en utilisant 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 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 la priorité sur les serveurs à portée projet et utilisateur portant le même nom
• Les serveurs à portée projet (dans .mcp.json) ont la priorité sur les serveurs à portée utilisateur portant le même nom
• Avant d’utiliser les serveurs à portée projet depuis .mcp.json, Claude Code vous demandera de les approuver pour des raisons de sécurité
• Le fichier .mcp.json est destiné à être versionné pour partager les serveurs MCP avec votre équipe
• Les serveurs à portée 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 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 voulez donner à Claude un accès en lecture seule à une base de données PostgreSQL pour les requêtes et l’inspection du schéma.

claude mcp add serveur-postgres /chemin/vers/serveur-mcp-postgres --connection-string "postgresql://utilisateur:mdp@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 la sécurité
• Claude peut vous aider à explorer la structure de la base de données et à exécuter des requêtes analytiques
• Vous pouvez utiliser cela pour comprendre rapidement les schémas de base de données dans des projets non familiers
• Assurez-vous que votre chaîne de connexion utilise des identifiants appropriés avec les permissions minimales requises

​

Ajouter des serveurs MCP depuis 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 plutôt qu’à 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 voulez 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 le flag -s global pour ajouter les serveurs à votre configuration globale
• Les serveurs importés auront les mêmes noms que dans Claude Desktop
• Si des serveurs avec 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 voulez 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 voulez utiliser Claude Code comme un linter ou un relecteur de code.

Étapes :

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'vous êtes un linter. veuillez examiner les changements par rapport à main et signaler tout problème lié aux fautes de frappe. indiquez 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 retournez aucun autre texte.'"
    }
}

​

Pipe in, pipe out

Quand l’utiliser : Vous voulez envoyer des données à Claude via un pipe, 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 les intégrations simples où vous avez juste besoin de la réponse de Claude
• Utilisez --output-format json quand 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 prompts ou des tâches spécifiques.

​

Créer des commandes spécifiques au projet

Quand l’utiliser : Vous voulez 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 la performance de ce code et suggère trois optimisations spécifiques :" > .claude/commands/optimize.md 

claude > /project:optimize 

Conseils :

• Les noms des commandes sont dérivés du nom du 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 le prompt envoyé à Claude lorsque la commande est invoquée

​

Ajouter des arguments de commande avec $ARGUMENTS

Quand l’utiliser : Vous voulez 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 racine 4. Ajouter
les tests appropriés 5. Préparer une description concise de PR" >
.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, revoir du code dans des fichiers particuliers, ou traduire du contenu dans des langues spécifiées

​

Créer des commandes slash personnelles

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

mkdir -p ~/.claude/commands 

echo "Examine ce code pour les vulnérabilités de sécurité, en se 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 fonctionnalite-a # Ou créer un worktree avec une branche existante git worktree add ../projet-bugfix bugfix-123 

# Naviguer vers votre worktree 
cd ../projet-fonctionnalite-a # Exécuter Claude Code dans cet environnement isolé claude 

cd ../projet-bugfix claude

# Lister tous les worktrees git worktree list # Supprimer un worktree quand terminé
git worktree remove ../projet-fonctionnalite-a 

Conseils :

• Chaque worktree a son propre état de fichiers indépendant, ce qui est parfait pour les sessions Claude Code parallèles
• Les modifications apportées dans un worktree n’affectent 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 qui travaille 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 de chaque worktree
• N’oubliez pas d’initialiser votre environnement de développement dans chaque nouveau worktree selon la configuration de votre projet. Selon votre pile technologique, 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 : Suivre le processus de configuration standard de votre projet

​

Prochaines étapes