Tutoriels Claude Code

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

• 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

​

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 /path/to/project

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é 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 pratiques modernes.

> trouve les utilisations 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 quand 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 faire une PR pour vous
• Relisez 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 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.

# 1. Glisser-déposer une image dans la fenêtre Claude Code
# 2. Copier une image et la coller dans le CLI avec ctrl+v
# 3. Fournir un chemin d'image
claude "Analyse cette image : /chemin/vers/votre/image.png"

> Que montre cette image ?
> Décris les éléments UI 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. Qu'est-ce qui la cause ?
> Ceci est 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
> 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 UI ou de diagrammes pour un meilleur contexte
• Vous pouvez travailler avec plusieurs images dans une conversation
• L’analyse d’images fonctionne avec les diagrammes, captures d’écran, 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.

> 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 plus 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
• 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 les modèles architecturaux importants spécifiques à votre projet
• Vous pouvez ajouter des fichiers CLAUDE.md à n’importe lequel de ces emplacements :
  • Le dossier où vous exécutez Claude : Automatiquement ajouté aux conversations que vous démarrez dans ce dossier
  • Les répertoires enfants : Claude les récupère à la demande
  • ~/.claude/CLAUDE.md : Préférences spécifiques à l’utilisateur que vous ne voulez pas versionner

​

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 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 : Ajout d'un serveur local
claude mcp add mon-serveur -e API_KEY=123 -- /chemin/vers/serveur arg1 arg2

# 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 les variables d’environnement avec les flags -e ou --env (ex : -e CLE=valeur)
• Configurez le délai de démarrage du serveur MCP en utilisant la variable d’environnement MCP_TIMEOUT (ex : MCP_TIMEOUT=10000 claude définit un délai de 10 secondes)
• Vérifiez le statut 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 aux mêmes outils MCP pour toute l’équipe
• 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/postgres-mcp-server --connection-string "postgresql://utilisateur:mdp@localhost:5432/madb"

# 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 l’utiliser 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 voulez ajouter à Claude Code.

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

# Exemple : Ajout d'un serveur stdio avec 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 portant les mêmes noms existent déjà, ils recevront un suffixe numérique (ex : serveur_1)

​

Utiliser Claude Code comme serveur MCP

Quand l’utiliser : Vous voulez utiliser Claude Code lui-même comme un 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 fournit l’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, 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 et récupérer des données dans un format structuré.

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

​

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 "Analysez les performances de ce code et suggérez trois optimisations spécifiques :" > .claude/commands/optimize.md

claude
> /project:optimize

Conseils :

• Les noms des commandes sont dérivés du nom du fichier (ex : optimize.md devient /project:optimize)
• Vous pouvez organiser les commandes dans des sous-répertoires (ex : .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 "Trouvez et corrigez le problème #$ARGUMENTS. Suivez 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 la 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 le 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 "Examinez ce code pour les vulnérabilités de sécurité, en vous 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

​

Prochaines étapes