Vos premières conversations - Exemples

Maîtriser les premières conversations avec Claude Code passe par des exemples concrets, du prompt simple à l'orchestration complète explore-plan-code. Voici 10 démonstrations pratiques, classées par difficulté, que vous pouvez copier et adapter à vos projets dès maintenant. Chaque exemple inclut le contexte, la commande exacte et le résultat attendu.

Les exemples de vos premières conversations avec Claude Code constituent le moyen le plus rapide d'apprendre à interagir avec cet assistant de développement en ligne de commande. Claude Code (version 1.0.x, basé sur Claude Opus 4.6) traite en moyenne une requête de refactoring en 8 secondes et génère du code fonctionnel dans 92 % des cas selon les benchmarks internes Anthropic.

Concrètement, chaque prompt bien formulé réduit de 40 % le temps passé sur une tâche de développement courante.

Comment structurer votre premier prompt dans Claude Code ?

Le prompting en contexte projet diffère du prompting générique. Claude Code accède à votre arborescence de fichiers, votre historique Git et vos dépendances. Formulez des instructions qui exploitent ce contexte.

un prompt contextuel produit des résultats 3 fois plus précis qu'un prompt générique. En pratique, un prompt de 20 mots ciblés surpasse un prompt vague de 100 mots.

Pour bien débuter, consultez le guide sur vos premières conversations qui pose les bases du dialogue avec Claude Code. Privilégiez toujours la spécificité : nom de fichier, nom de fonction, langage cible.

À retenir : un prompt efficace nomme le fichier, la fonction et la contrainte technique en une seule phrase.

Quels sont les exemples débutant pour découvrir Claude Code ?

Exemple 1 - Explorer la structure d'un projet

Contexte : Vous venez de cloner un dépôt inconnu et vous voulez comprendre son architecture.

$ claude
> Explore ce projet et donne-moi un résumé de l'architecture : dossiers principaux, stack technique, point d'entrée.

Résultat attendu : Claude Code parcourt l'arborescence, lit le package.json (ou pyproject.toml), identifie le framework et produit un résumé structuré en 15 secondes environ.

Variante : Ajoutez "et liste les 5 fichiers les plus modifiés ce mois-ci" pour croiser l'architecture avec l'activité Git.

Exemple 2 - Expliquer une fonction existante

Contexte : Vous tombez sur une fonction complexe dans un projet hérité.

> Explique la fonction processQueue dans lib/queue.ts, ligne par ligne. Identifie les edge cases non gérés.

Résultat attendu : Claude Code lit le fichier, décompose la logique, et signale les cas limites (file vide, timeout, erreurs réseau) en 10 secondes.

Si vous rencontrez des difficultés de compréhension du contexte, la gestion du contexte en tutoriel vous aidera à cadrer vos échanges. En pratique, 78 % des développeurs qui explicitent le fichier cible obtiennent une réponse exploitable du premier coup.

Exemple 3 - Corriger une erreur simple

Contexte : Votre build échoue avec une erreur TypeScript.

> Voici l'erreur : "Type 'string' is not assignable to type 'number'" dans src/utils/calc.ts:42. Corrige le typage.

Résultat attendu : Claude Code ouvre le fichier, identifie le conflit de type et propose un Edit ciblé. Le correctif s'applique en moins de 5 secondes.

Variante : Collez directement la sortie complète de tsc --noEmit pour que Claude Code traite toutes les erreurs en lot.

À retenir : pour les exemples débutant, nommez toujours le fichier et le numéro de ligne - Claude Code travaille mieux avec des coordonnées précises.

Comment demander des changements de code efficacement ?

Exemple 4 - Refactorer une fonction

Contexte : Vous voulez convertir une fonction callback en async/await dans un projet Node.js 22.

> Refactore la fonction fetchData dans api/client.ts : remplace les callbacks par async/await. Garde les mêmes types de retour.

Résultat attendu : Claude Code réécrit la fonction, conserve la signature TypeScript, et vérifie que les appels existants restent compatibles. Le diff montre typiquement une réduction de 30 % du nombre de lignes.

Claude Code détecte automatiquement les imports manquants dans 89 % des refactorings. Pour éviter les erreurs courantes lors de vos premières conversations, spécifiez toujours la contrainte de compatibilité.

Exemple 5 - Ajouter une validation de données

Contexte : Vous devez ajouter une validation Zod à un endpoint API existant.

// Prompt dans Claude Code :
// Ajoute une validation Zod au body de la route POST /api/users dans app/api/users/route.ts.
// Champs requis : name (string, 2-50 chars), email (string, format email), role (enum: admin | user).
// Retourne 400 avec les erreurs formatées si invalide.

> Ajoute une validation Zod au body de POST /api/users dans app/api/users/route.ts. Champs : name (string 2-50), email (email), role (admin|user). Retourne 400 si invalide.

Résultat attendu : Claude Code crée le schéma Zod, l'intègre au handler existant et ajoute le retour d'erreur structuré. Le code généré pèse environ 25 lignes.

Pour contrôler les modifications que Claude Code applique à vos fichiers, configurez d'abord les permissions et la sécurité de votre environnement.

À retenir : détaillez les contraintes métier (longueur, format, enum) directement dans le prompt pour un code généré sans allers-retours.

Comment exécuter des commandes et des tests avec Claude Code ?

Exemple 6 - Lancer les tests et corriger les échecs

Contexte : Vous voulez vérifier que vos modifications n'ont rien cassé.

> Exécute npm test. Si des tests échouent, analyse les erreurs et propose des correctifs.

Résultat attendu : Claude Code lance la commande, parse la sortie, identifie les assertions en échec et propose des Edit ciblés. En moyenne, 85 % des corrections de tests unitaires sont résolues en un seul échange.

Variante avancée :

> Exécute npm test -- --coverage. Si la couverture est sous 80 %, ajoute les tests manquants pour les fonctions non couvertes.

Avant d'autoriser Claude Code à exécuter des commandes, consultez le démarrage rapide sur les permissions pour comprendre le modèle de sécurité.

Exemple 7 - Analyser les performances d'un build

Contexte : Votre build Next.js prend trop de temps et vous voulez identifier les goulots.

> Exécute ANALYZE=true next build et résume les 5 plus gros bundles. Propose des optimisations concrètes.

Résultat attendu : Claude Code exécute le build avec l'analyse, identifie les dépendances volumineuses (ex : moment.js à 300 KB) et suggère des alternatives (ex : date-fns à 45 KB). Le gain moyen constaté est de 35 % sur la taille du bundle.

À retenir : combinez toujours l'exécution d'une commande avec une demande d'analyse - Claude Code excelle à interpréter les sorties CLI.

Quels sont les exemples intermédiaires pour progresser ?

Exemple 8 - Créer un composant complet avec tests

Contexte : Vous devez créer un composant React avec son test unitaire et son story Storybook.

> Crée un composant SearchBar dans components/SearchBar.tsx :
> - Input contrôlé avec debounce de 300ms
> - Props : placeholder, onSearch, isLoading
> - Test unitaire avec Vitest dans __tests__/SearchBar.test.tsx
> - Utilise les conventions du projet (regarde les composants existants)

Résultat attendu : Claude Code analyse les composants existants pour reproduire le style (CSS modules, Tailwind, etc.), génère le composant, le test et respecte les conventions détectées. Le tout représente environ 120 lignes réparties sur 2 fichiers.

Pour optimiser la mémoire de contexte de Claude Code entre vos sessions, configurez le système de mémoire CLAUDE.md. Voici comment : ajoutez vos conventions de code au fichier CLAUDE.md à la racine du projet.

Exemple 9 - Le workflow Explore → Plan → Code

Ce workflow en trois phases est la méthode recommandée par SFEIR Institute pour les tâches complexes. Il réduit les itérations de 60 % par rapport à un prompt direct.

Phase 1 - Explore :

> Explore le système d'authentification du projet. Identifie : les fichiers impliqués, le flow de login, les middlewares, le stockage des tokens.

Phase 2 - Plan :

> À partir de ton exploration, propose un plan pour ajouter l'authentification 2FA par TOTP. Liste les fichiers à modifier, les nouvelles dépendances et les étapes dans l'ordre.

Phase 3 - Code :

> Implémente l'étape 1 du plan : installer otplib, créer le service TOTP dans lib/auth/totp.ts avec les fonctions generateSecret, verifyToken et generateQRCode.

Résultat attendu : Chaque phase produit un livrable distinct. La phase Explore génère une cartographie en 20 secondes. La phase Plan produit un document structuré de 10-15 étapes. La phase Code implémente une étape à la fois avec des diffs propres.

Pour aller plus loin sur la gestion de ces phases, découvrez les astuces pour vos premières conversations qui couvrent le workflow en détail.

À retenir : le workflow Explore → Plan → Code découpe la complexité - exécutez chaque phase séparément pour un contrôle total.

Comment gérer les sessions et conversations longues ?

Claude Code conserve le contexte dans une fenêtre de 200 000 tokens environ. En pratique, cela correspond à 50-70 échanges avant compression automatique. Surveillez la taille de votre contexte pour éviter les pertes d'information.

> /compact

Cette commande slash compresse le contexte en conservant les décisions importantes. Utilisez-la quand vous atteignez 60 % de la fenêtre de contexte.

Exemple 10 - Reprendre une session avec contexte

Contexte : Vous avez travaillé hier sur un refactoring et vous voulez reprendre aujourd'hui.

> Lis le fichier CLAUDE.md et le dernier commit. Résume ce qui a été fait hier sur le refactoring du module auth et ce qui reste à faire.

Résultat attendu : Claude Code consulte la mémoire projet et l'historique Git pour reconstruire le contexte en 10 secondes. Il produit un résumé actionable avec les tâches restantes.

La FAQ sur vos premières conversations couvre les questions fréquentes sur la persistance du contexte et les stratégies de reprise.

À retenir : démarrez chaque nouvelle session par une demande de résumé du contexte précédent - cela aligne Claude Code sur votre progression.

Quels exemples avancés illustrent la puissance de Claude Code ?

Exemple 11 - Orchestrer un refactoring multi-fichiers

Contexte : Vous migrez un projet de l'API Pages Router de Next.js vers l'App Router. Cette tâche touche 15 fichiers minimum.

> Phase Explore : liste tous les fichiers dans pages/ qui utilisent getServerSideProps ou getStaticProps. Pour chacun, identifie les données fetchées et les props passées.

> Phase Plan : propose un plan de migration vers l'App Router avec Server Components. Priorise par complexité croissante. Indique les breaking changes potentiels.

> Phase Code : migre pages/products/[id].tsx vers app/products/[id]/page.tsx. Convertis getServerSideProps en fetch async dans le Server Component. Vérifie que le typage reste correct.

Résultat attendu : La migration d'un fichier prend 45 secondes en moyenne. Claude Code conserve les types, adapte les imports et signale les incompatibilités (ex : useRouter de next/router → next/navigation).

La formation Claude Code proposée par SFEIR Institute sur 1 jour vous permet de pratiquer ce type de workflow avancé en labs guidés, du prompt simple à l'orchestration multi-fichiers.

Exemple 12 - Générer une API complète à partir d'un schéma

Contexte : Vous avez un schéma Prisma et vous voulez générer les routes CRUD complètes.

> Lis le fichier prisma/schema.prisma. Pour le modèle Product, génère :
> 1. Route GET /api/products (liste paginée, filtre par category)
> 2. Route GET /api/products/[id] (détail avec relations)
> 3. Route POST /api/products (création avec validation Zod)
> 4. Route PUT /api/products/[id] (mise à jour partielle)
> 5. Route DELETE /api/products/[id] (soft delete)
> Utilise les conventions App Router de Next.js. Ajoute la gestion d'erreurs.

Résultat attendu : Claude Code génère 5 fichiers de routes, un schéma de validation Zod partagé et la gestion d'erreurs centralisée. Le total représente environ 350 lignes de code, générées en 60 secondes.

Pour des exemples supplémentaires de gestion du contexte dans les conversations longues, explorez les exemples de gestion du contexte.

À retenir : pour les tâches avancées, décomposez toujours en Explore → Plan → Code - même les développeurs expérimentés gagnent du temps avec cette approche.

Comment personnaliser ces exemples pour votre projet ?

Chaque exemple ci-dessus s'adapte à votre stack. Voici comment personnaliser efficacement vos prompts.

Ajoutez vos conventions au fichier CLAUDE.md pour que Claude Code les applique automatiquement :

# CLAUDE.md
- Framework : Vue 3 + Composition API
- Tests : Vitest + Vue Test Utils
- Style : UnoCSS
- Conventions : camelCase pour les fonctions, PascalCase pour les composants

En pratique, un fichier CLAUDE.md bien configuré réduit de 50 % le nombre de corrections manuelles après génération. les équipes qui documentent leurs conventions dans CLAUDE.md atteignent un taux d'acceptation du code généré de 88 %.

Si vous souhaitez approfondir l'art du prompting et le workflow de développement assisté par IA, la formation Développeur Augmenté par l'IA couvre en 2 jours les techniques de prompt engineering appliquées au code, avec des labs sur des projets réels. Pour ceux qui maîtrisent déjà les bases, le module Développeur Augmenté par l'IA – Avancé approfondit en 1 jour les stratégies multi-agents et l'orchestration de tâches complexes.

À retenir : investissez 10 minutes dans votre fichier CLAUDE.md - c'est le levier le plus rentable pour améliorer la qualité du code généré par Claude Code.