Gaëtan Wittebolle.
UmamiContactEN
EN
← guides
Claude Code, le guide
Chapitre 1 / 19
  • 01Qu'est-ce que Claude Code ?
  • 02Installation pas à pas
  • 03CLAUDE.md, le cerveau de ton projet

Partie 1 · Les fondations

Qu'est-ce que Claude Code ?

Chapitre 1 · 5 min de lecture

Ce chapitre t'explique ce qu'est Claude Code, en quoi il diffère des autres outils IA, et comment se répartissent les rôles entre toi et lui. Temps de lecture : 5 minutes.

L'idée en une phrase

Claude Code est un agent de développement autonome qui tourne sur ton ordinateur. Tu lui donnes une direction, il écrit le code, crée les fichiers, lance les vérifications, et corrige ses propres erreurs.

En quoi c'est différent de ChatGPT ou du chat Claude ?

Quand tu utilises ChatGPT ou le chat sur claude.ai, tu copies-colles du code entre la conversation et ton projet. C'est lent, source d'erreurs, et tu perds le contexte à chaque message.

Claude Code fonctionne directement sur ton ordinateur. Il voit tous tes fichiers, comprend l'architecture complète de ton projet, et agit dessus en temps réel. La différence entre demander des directions à quelqu'un par téléphone, et avoir un copilote assis à côté de toi dans la voiture.

CritèreChat IA classique (ChatGPT, claude.ai)Claude Code
Accès aux fichiersAucun, tu copies-collesLit et écrit directement
Exécution de commandesNon, tu fais toi-mêmeOui, lance les tests, le build, installe les packages
Contexte du projetLimité à ce que tu collesVoit l'intégralité du code source
Continuité entre sessionsRepart de zéro à chaque conversationRecharge automatiquement les conventions du projet
Auto-correctionNon, tu vérifies manuellementOui, détecte et corrige ses erreurs en boucle

Les 5 super-pouvoirs concrets

1. Lire et écrire des fichiers

Claude Code navigue dans ton projet comme un développeur. Il ouvre les fichiers, comprend les imports, suit les dépendances. Quand il crée un composant src/components/user-card.tsx, il connaît déjà src/components/ui/button.tsx existant et l'importe proprement au lieu de recréer un bouton.

2. Exécuter des commandes

Il lance l'app, les tests, les vérifications de types, les migrations de base de données. Si npm run typecheck renvoie une erreur sur un type manquant, il lit le message et corrige le fichier fautif avant de passer à la suite.

3. Comprendre le contexte global

Il ne travaille pas sur un fichier isolé. Il comprend comment les pages appellent les Server Actions, qui interrogent Supabase, qui renvoient des types générés. Quand tu ajoutes une colonne published_at à une table, il met à jour les types, les actions, les composants et les filtres en une seule passe.

4. Planifier et exécuter des plans

Tu lui donnes un plan en plusieurs étapes, il l'exécute tâche par tâche avec des points de vérification entre chaque étape. Si une étape casse le build, il s'arrête et répare avant de continuer.

5. Maintenir la cohérence

Grâce au fichier CLAUDE.md (qu'on verra au chapitre 3), Claude Code respecte tes conventions d'un bout à l'autre du projet : mêmes noms, mêmes patterns, mêmes couleurs, même langue.

L'analogie : toi = chef de projet, Claude = développeur senior

Imagine que tu embauches un développeur senior ultra-rapide, disponible 24h/24, qui ne se fatigue jamais. Il est techniquement excellent, mais il a besoin de trois choses de ta part :

Toi, le chef de projet - Tu décris ce que tu veux construire et pourquoi - Tu choisis entre les options que Claude propose (il te laisse toujours le choix) - Tu testes visuellement l'app dans ton navigateur (Claude ne voit pas l'écran) - Tu valides les sauvegardes (commits) et les mises en production - Tu apportes ta connaissance métier, tu sais ce dont tes utilisateurs ont besoin

Claude Code, le développeur - Il propose l'architecture technique et les choix de design - Il écrit 100% du code, pas une seule ligne de ta part - Il lance les vérifications automatiques (types, lint, tests) et corrige en boucle - Il gère Git (l'historique des modifications) avec des messages de commit clairs - Il documente ce qu'il fait et pourquoi

Les 3 modes de travail

Mode conversation

Tu discutes avec Claude comme avec un collègue. Tu poses des questions, tu demandes des explications, tu explores des idées. Rien n'est modifié.

"Comment fonctionne le système d'authentification dans le projet ?"

"Quelles options j'ai pour ajouter un système de notifications ?"

Mode exécution directe

Tu demandes une action précise, Claude l'exécute immédiatement.

"Ajoute un bouton 'Dupliquer' sur la card de contenu, qui crée une copie en brouillon."

"Le formulaire d'inscription affiche une erreur 500 quand l'email existe déjà. Corrige."

Mode planification

Pour les features complexes, tu brainstormes d'abord, tu planifies, puis tu exécutes le plan. Le mode le plus puissant, détaillé au chapitre 5.

"Planifie l'implémentation d'un système de streak de publication."

À retenir : Claude Code n'est pas un chatbot qui te donne du code à copier-coller. Un agent autonome qui agit directement sur ton projet. Ton rôle : la vision et les décisions. Son rôle : l'exécution technique.

Chapitre 2 →

Installation pas à pas