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
• Utiliser les flux de travail git avancés
• Travailler avec les images
• Configurer la mémoire du projet
• Utiliser Claude comme un utilitaire unix
• Configurer le Model Context Protocol (MCP)

​

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 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 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 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 faire 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

​

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 pour les API publiques, les interfaces et 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 : /path/to/your/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. Quelle en est 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’image fonctionne avec les diagrammes, captures d’écran, maquettes et plus encore

​

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 dans le dossier où vous exécutez Claude, les répertoires parents (Claude les lit automatiquement), ou les répertoires enfants (Claude les récupère à la demande)

​

Utiliser Claude comme un utilitaire unix

​

Ajouter Claude à votre processus de vérification

Quand l’utiliser : Vous voulez utiliser Claude Code comme linter ou 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.'"
    }
}

​

Entrée et sortie par tube

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 'explique de manière concise la cause principale de cette erreur de build' > output.txt

​

Configurer le Model Context Protocol (MCP)

Le 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 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 -- /path/to/server 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 avec project (par défaut) ou global pour spécifier où la configuration est stockée
• Définissez les variables d’environnement avec les flags -e ou --env (par exemple, -e CLE=valeur)
• MCP suit une architecture client-serveur où Claude Code (le client) peut se connecter à plusieurs serveurs spécialisés

​

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 postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# Dans votre session Claude, vous pouvez poser des questions sur votre base de données
$ claude
> décris le schéma de notre table users
> 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

​

Prochaines étapes