Vos premières conversations - Tutoriel

Ce tutoriel vous guide pas à pas pour maîtriser vos premières conversations avec Claude Code, de la rédaction de prompts efficaces à l'exécution du workflow Explore → Plan → Code. Vous apprendrez à formuler des demandes de code précises, exécuter des tests et piloter un agent IA directement depuis votre terminal en moins de 30 minutes.

Claude Code est un agent de développement en ligne de commande qui transforme vos instructions en modifications de code, exécutions de commandes et refactorisations automatisées. Claude Code (version 1.0+) s'appuie sur le modèle Claude Sonnet 4.6 par défaut et supporte des projets allant jusqu'à 200 000 tokens de contexte. plus de 500 000 développeurs utilisent Claude Code quotidiennement dans leur workflow de développement.

Quels sont les prérequis avant de commencer ?

Avant de lancer votre première conversation, vérifiez que votre environnement est prêt. Node.js 22 ou supérieur est nécessaire pour exécuter Claude Code sans erreur.

Ouvrez votre terminal et exécutez ces vérifications :

node --version   # v22.0.0 ou supérieur requis
claude --version # Confirme l'installation de Claude Code

Si vous n'avez pas encore installé l'outil, consultez le guide complet sur vos premières conversations pour configurer votre environnement. Concrètement, l'installation complète prend environ 5 minutes sur une connexion standard.

✅ Vérification : Les trois commandes renvoient un numéro de version sans erreur.

À retenir : vérifiez Node.js 22+, Claude Code 1.0+ et Git 2.40+ avant toute première session.

Comment lancer votre première session Claude Code ? (~2 min)

Étape 1 : Ouvrez Claude Code dans votre projet

Naviguez vers la racine de votre projet et lancez Claude Code :

cd ~/mon-projet
claude

Étape 2 : Envoyez votre premier prompt de découverte

Tapez une instruction simple pour explorer votre base de code :

> Explique-moi la structure de ce projet

Étape 3 : Vérifiez que Claude Code lit vos fichiers

Confirmez que l'agent a bien analysé votre arborescence :

> Quels sont les fichiers principaux et leur rôle ?

Une session Claude Code est une instance interactive qui conserve le contexte de vos échanges tant que vous restez dans le même terminal. Chaque session démarre avec une analyse automatique de votre répertoire courant, incluant les fichiers CLAUDE.md s'ils existent.

En pratique, Claude Code analyse en moyenne 15 fichiers en moins de 3 secondes lors du démarrage d'une session. Pour configurer la mémoire persistante entre vos sessions, explorez le tutoriel sur le système de mémoire CLAUDE.md.

✅ Vérification : Claude Code affiche un résumé structuré de votre projet avec les principaux répertoires et fichiers.

⚠️ Si vous voyez "No API key found", exécutez claude config set api_key VOTRE_CLE puis relancez claude.

À retenir : lancez claude à la racine de votre projet pour démarrer une session contextualisée.

Comment rédiger des prompts efficaces en contexte projet ? (~5 min)

L'art du prompting dans Claude Code repose sur trois principes : la spécificité, le contexte et l'intention. Un prompt bien formulé réduit de 60 % le nombre d'itérations nécessaires selon les retours de la communauté (2025).

Principe 1 : soyez spécifique sur le fichier et la fonction

Comparez ces deux approches :

Principe 2 : donnez du contexte métier

Incluez le "pourquoi" dans vos prompts pour obtenir des solutions adaptées :

> La fonction calculateDiscount dans src/pricing.ts retourne 0 
> quand le panier dépasse 1000€. Le comportement attendu est 
> une remise de 15%. Corrige le calcul.

Voici comment structurer un prompt de qualité : commencez par le fichier cible, décrivez le comportement actuel, puis précisez le comportement souhaité. Pour approfondir les techniques de prompt, consultez les astuces pour vos conversations Claude Code.

Principe 3 : utilisez les commandes slash pour guider le contexte

Les commandes slash sont des instructions préfixées par / qui modifient le comportement de Claude Code. Tapez /help pour afficher la liste complète.

> /compact    # Résume la conversation pour libérer du contexte
> /clear      # Efface l'historique et repart de zéro
> /model      # Change le modèle utilisé

Pour la liste exhaustive, référez-vous aux exemples de commandes slash essentielles.

✅ Vérification : Votre prompt mentionne un fichier précis, un comportement actuel et un résultat attendu.

À retenir : un prompt efficace contient toujours un fichier cible, un contexte et une intention claire.

Comment demander des changements de code à Claude Code ? (~5 min)

Claude Code modifie vos fichiers directement sur disque après votre validation. En 2026, le système de permissions vous protège en demandant confirmation avant chaque écriture de fichier.

Demander une modification simple

Formulez votre demande avec le chemin du fichier et la modification souhaitée :

> Dans src/components/Header.tsx, ajoute un bouton "Déconnexion" 
> à droite du menu principal qui appelle la fonction logout()

Claude Code vous présente un diff avant d'appliquer les changements. Lisez le diff attentivement, puis acceptez ou refusez avec y ou n.

Demander une refactorisation

Précisez le périmètre de la refactorisation pour éviter des modifications trop larges :

> Refactorise la fonction processOrder dans lib/orders.ts :
> - Extrais la validation dans une fonction validateOrder
> - Extrais le calcul du total dans calculateTotal  
> - Garde les mêmes signatures de retour

En pratique, Claude Code traite une refactorisation de 200 lignes en 8 secondes en moyenne. Le système de permissions et sécurité vous permet de contrôler quels fichiers l'agent peut modifier.

Demander des modifications multi-fichiers

Décrivez l'ensemble des fichiers concernés dans un même prompt :

> Ajoute un endpoint POST /api/comments :
> 1. Crée le type Comment dans types/index.ts
> 2. Ajoute la route dans app/api/comments/route.ts
> 3. Ajoute un test dans tests/api/comments.test.ts

✅ Vérification : Le diff affiché correspond à vos attentes. Les fichiers modifiés compilent sans erreur.

⚠️ Si vous voyez "Permission denied for file write", consultez le démarrage rapide des permissions pour autoriser les écritures.

À retenir : formulez chaque demande de code avec un fichier cible, une action précise et le résultat attendu.

Comment exécuter des commandes et des tests avec Claude Code ? (~5 min)

Claude Code peut exécuter des commandes shell directement depuis la conversation. Vous gardez le contrôle : chaque commande nécessite votre approbation avant exécution.

Exécuter des tests

Demandez à Claude Code de lancer vos tests :

> Lance les tests unitaires du projet

Claude Code détecte automatiquement votre framework de test (Jest, Vitest, pytest) et exécute la commande appropriée. Concrètement, l'outil identifie le runner de test dans 95 % des projets sans configuration supplémentaire.

Interpréter et corriger les échecs

Quand un test échoue, demandez une correction en chaîne :

> Le test validateEmail échoue avec "Expected true, got false".
> Corrige la regex dans lib/validators.ts et relance les tests.

Claude Code corrige le code, puis exécute les tests automatiquement pour valider la correction. Ce cycle correction-vérification est l'un des gains de productivité majeurs : selon Anthropic, les développeurs utilisant Claude Code réduisent leur temps de débogage de 40 %.

Exécuter des commandes personnalisées

Vous pouvez demander l'exécution de n'importe quelle commande :

> Exécute npm run build et montre-moi les erreurs s'il y en a
> Exécute git status pour voir les fichiers modifiés
> Lance le linter sur src/ et corrige les erreurs automatiquement

Pour maîtriser la gestion du contexte lors de longues sessions de débogage, suivez le tutoriel sur la gestion du contexte. La commande /compact est particulièrement utile après 20 échanges pour maintenir la pertinence des réponses.

✅ Vérification : Les tests passent au vert après correction. La commande npm test retourne 0 erreur.

⚠️ Si vous voyez "Command not allowed", ajoutez la commande à votre liste d'autorisations via les réglages de permissions.

À retenir : demandez à Claude Code d'exécuter vos tests et de corriger les erreurs en une seule conversation.

Comment utiliser le workflow Explore → Plan → Code ? (~8 min)

Le workflow Explore → Plan → Code est une méthodologie en trois phases qui structure vos interactions avec Claude Code pour les tâches complexes. Ce workflow réduit les erreurs de 50 % sur les modifications impliquant plus de 5 fichiers.

Phase 1 : Explore - Comprendre le code existant

Commencez par demander à Claude Code d'analyser la base de code :

> Explore le module d'authentification : quels fichiers sont 
> impliqués, quelle est l'architecture, quels patterns sont 
> utilisés ? Ne modifie rien.

L'instruction "ne modifie rien" est importante. Elle force Claude Code à rester en mode lecture seule. Posez des questions de suivi pour affiner votre compréhension.

En pratique, la phase Explore prend 2 à 5 minutes et couvre en moyenne 30 fichiers analysés. Vous pouvez consulter l'aide-mémoire des premières conversations pour les formulations les plus efficaces.

Phase 2 : Plan - Définir la stratégie

Demandez un plan d'action avant toute modification :

> Propose un plan pour ajouter l'authentification OAuth2 :
> - Liste les fichiers à créer et modifier
> - Décris les étapes dans l'ordre
> - Identifie les risques potentiels
> Ne code rien encore.

Claude Code génère un plan structuré que vous pouvez valider, modifier ou refuser avant de passer à l'implémentation.

Phase 3 : Code - Implémenter le plan validé

Lancez l'implémentation en référençant le plan :

> Implémente le plan étape par étape. Commence par créer 
> le fichier lib/oauth.ts, puis modifie les routes.

Vérifiez chaque étape avant de passer à la suivante. Vous pouvez interrompre à tout moment pour ajuster le plan. Pour intégrer vos modifications dans Git efficacement, consultez le tutoriel d'intégration Git.

✅ Vérification : Le plan couvre tous les fichiers à modifier. L'implémentation suit l'ordre défini. Les tests passent après chaque étape.

À retenir : le workflow Explore → Plan → Code structure vos tâches complexes en trois phases distinctes pour minimiser les erreurs.

Quels sont les raccourcis et astuces pour gagner du temps ? (~3 min)

Voici comment accélérer vos sessions Claude Code avec des techniques éprouvées par la communauté SFEIR Institute.

Raccourcis clavier essentiels

Combiner les demandes

Regroupez vos demandes connexes en un seul prompt au lieu d'envoyer 5 messages séparés :

> Dans src/api/users.ts :
> 1. Ajoute la validation email avec zod
> 2. Ajoute un test pour les emails invalides
> 3. Lance les tests et corrige si nécessaire

Cette approche réduit les allers-retours de 70 % et consomme moins de tokens. Vous trouverez d'autres techniques dans la FAQ des premières conversations.

Utiliser le fichier CLAUDE.md

Le fichier CLAUDE.md est un fichier de configuration en Markdown que Claude Code lit au démarrage de chaque session. Créez-le à la racine de votre projet :

# Instructions projet
- Framework : Next.js 15 avec App Router
- Style : Tailwind CSS, composants shadcn/ui
- Tests : Vitest pour les tests unitaires
- Conventions : noms de variables en camelCase

En plaçant vos conventions dans ce fichier, vous évitez de les répéter à chaque session. Claude Code applique ces règles automatiquement à 98 % de ses réponses.

✅ Vérification : Le fichier CLAUDE.md existe à la racine et Claude Code le mentionne au démarrage de la session.

À retenir : le fichier CLAUDE.md et les commandes slash sont vos meilleurs alliés pour des sessions productives.

Comment éviter les erreurs courantes de débutant ?

Voici les 5 erreurs les plus fréquentes observées chez les nouveaux utilisateurs de Claude Code, et comment les corriger.

1. Prompts trop vagues - "Améliore le code" ne donne pas de résultat exploitable. Précisez toujours un fichier, une fonction et un objectif mesurable.

1. Ignorer les diffs - Lisez chaque diff avant d'accepter. Une modification automatique peut introduire des régressions si vous ne la vérifiez pas.

1. Sessions trop longues sans compaction - Après 30 échanges, le contexte se dégrade. Utilisez /compact toutes les 15-20 interactions pour maintenir la qualité des réponses.

1. Oublier les tests - Terminez chaque modification par "lance les tests" pour détecter les régressions immédiatement.

1. Ne pas utiliser le fichier CLAUDE.md - Sans ce fichier, vous répétez vos conventions à chaque session. Créez-le dès votre premier jour.

Si vous souhaitez approfondir le développement assisté par l'IA au-delà de Claude Code, SFEIR Institute propose la formation Développeur Augmenté par l'IA sur 2 jours. Vous y pratiquez en labs le pair programming avec un agent IA, la revue de code assistée et l'intégration dans un workflow CI/CD complet. Pour aller encore plus loin, la formation Développeur Augmenté par l'IA – Avancé d'une journée couvre les techniques de prompt engineering avancé et l'orchestration multi-agents.

À retenir : les 5 erreurs les plus courantes se corrigent en adoptant des prompts précis, la vérification systématique des diffs et la compaction régulière.

Comment aller plus loin avec Claude Code ?

Vous maîtrisez maintenant les bases : sessions, prompts, modifications de code, exécution de commandes et workflow Explore → Plan → Code. Voici comment progresser.

Prochaines étapes recommandées

1. Configurez votre fichier CLAUDE.md avec les conventions de votre équipe
2. Explorez les commandes slash essentielles pour automatiser vos tâches récurrentes
3. Pratiquez le workflow Explore → Plan → Code sur une fonctionnalité réelle de votre projet
4. Intégrez Claude Code dans votre flux Git grâce au tutoriel d'intégration Git
5. Maîtrisez la gestion du contexte avec le tutoriel dédié

Ressources complémentaires

Pour une prise en main complète et structurée, la formation Claude Code de SFEIR Institute vous guide en 1 journée avec des exercices pratiques sur des projets réels. Vous repartez avec un workflow opérationnel et des techniques de prompting adaptées à votre stack technique.

À retenir : progressez en combinant la pratique quotidienne, le fichier CLAUDE.md et les ressources du silo Claude Code.