Le Guide Complet de Claude Code : Tout Ce Que Tu Dois Savoir

L'abonnement

Pour utiliser Claude Code, tu as besoin d'un abonnement Anthropic. Deux options :

• Claude Pro (20$/mois) : accès à Claude Code avec des limites d'utilisation raisonnables
• Claude Max (100$ ou 200$/mois) : utilisation beaucoup plus intensive, idéal si tu codes plusieurs heures par jour

Pour débuter, le plan Pro suffit largement.

Deux façons d'utiliser Claude Code

Il y a deux manières d'utiliser Claude Code, et elles font exactement la même chose :

Option 1 : Dans le terminal (pour les plus à l'aise)

C'est la version "originale". Tu ouvres un terminal dans VS Code et tu tapes tes instructions. C'est rapide et efficace.

Pour l'installer :

1. Ouvre VS Code
2. Ouvre le terminal intégré (Menu → Terminal → New Terminal)
3. Tape cette commande :

npm install -g @anthropic-ai/claude-code

4. Une fois installé, tape claude dans le terminal pour lancer une session
5. Suis les instructions pour te connecter à ton compte Anthropic

Option 2 : L'extension VS Code (recommandé pour les débutants)

Si le terminal te fait peur, bonne nouvelle : il existe une extension officielle Claude Code pour VS Code. Tu as une interface visuelle plus accueillante, avec un panneau de chat intégré. C'est exactement les mêmes fonctionnalités, mais présenté de manière plus "user-friendly".

Pour l'installer :

1. Ouvre VS Code
2. Va dans les extensions (icône carrée dans la barre latérale gauche, ou Ctrl+Shift+X)
3. Cherche "Claude Code"
4. Installe l'extension officielle d'Anthropic
5. Connecte-toi à ton compte Anthropic

Les deux options sont équivalentes. Choisis celle avec laquelle tu te sens le plus à l'aise.

Vérifier que tout fonctionne

Une fois installé, ouvre ton projet dans VS Code et lance Claude Code. Tape quelque chose de simple comme :

Décris-moi la structure de ce projet

Si Claude te répond en analysant tes fichiers, c'est que tout est bien configuré.

C'est quoi le CLAUDE.md ?

Le fichier CLAUDE.md est le fichier le plus important quand tu utilises Claude Code. C'est un simple fichier texte que tu places à la racine de ton projet et que Claude lit automatiquement à chaque nouvelle conversation.

C'est comme si tu donnais un briefing à un nouveau collaborateur avant chaque session de travail. Il contient tout ce que Claude doit savoir sur ton projet.

Pourquoi c'est si important ?

Sans CLAUDE.md, Claude découvre ton projet à chaque conversation comme si c'était la première fois. Il doit tout re-comprendre, et il peut faire des choix qui ne correspondent pas à ton projet.

Avec un bon CLAUDE.md, Claude sait immédiatement :

• Comment ton projet est structuré
• Quelles technologies tu utilises
• Quelles sont tes préférences et conventions
• Les commandes importantes (comment lancer le projet, comment le builder, etc.)

Comment le créer

Tu peux simplement demander à Claude de le faire :

Analyse ce projet et crée un fichier CLAUDE.md à la racine avec :
- La description du projet
- La stack technique utilisée
- La structure des dossiers importants
- Les commandes utiles (dev, build, etc.)
- Les conventions de code du projet

Claude va scanner ton projet et créer un CLAUDE.md adapté.

Exemple simplifié

Voici à quoi peut ressembler un CLAUDE.md basique :

# Mon Projet

## Description
Application de gestion de tâches pour freelances.

## Stack technique
- Frontend : React + TypeScript + Tailwind CSS
- Backend : Supabase (base de données + auth)
- Hébergement : Cloudflare Pages

## Commandes
- `npm run dev` : lancer en local
- `npm run build` : construire pour la production

## Conventions
- Utiliser le français pour les textes affichés
- Les composants sont dans /src/components
- Les pages sont dans /src/pages

Le mettre à jour régulièrement

C'est LE conseil le plus important : mets à jour ton CLAUDE.md au fur et à mesure que ton projet évolue. C'est un document vivant.

Quand tu ajoutes une nouvelle fonctionnalité, une nouvelle intégration, ou que tu changes quelque chose d'important, mets-le à jour. Tu peux même le faire via Claude :

Mets à jour le CLAUDE.md pour ajouter que j'utilise maintenant
Clerk pour l'authentification au lieu de Supabase Auth

Astuce : Quand tu te retrouves à corriger Claude sur la même chose deux fois, c'est un signal que cette info devrait être dans ton CLAUDE.md.

CLAUDE.md global vs projet

Tu peux aussi avoir un CLAUDE.md global (dans ~/.claude/CLAUDE.md) qui s'applique à tous tes projets. C'est utile pour tes préférences générales :

- Je préfère les messages en français
- Utilise toujours TypeScript plutôt que JavaScript
- Ne fais pas de modifications que je n'ai pas demandées

Le CLAUDE.md à la racine de ton projet, lui, contient les infos spécifiques au projet.

La règle d'or : réfléchis avant de taper

La plus grosse erreur que font les débutants, c'est de taper directement leur demande sans réfléchir. Avec Claude Code, 5 minutes de réflexion avant de taper peuvent te faire économiser des heures de debugging.

Avant de demander quoi que ce soit :

• Qu'est-ce que je veux exactement ? Sois le plus précis possible
• Qu'est-ce que Claude a besoin de savoir ? Donne-lui le contexte
• Qu'est-ce que je ne veux PAS ? Dis-lui ce qu'il doit éviter

Mauvais prompt vs Bon prompt

Mauvais : "Ajoute une page de pricing"

Bon : "Ajoute une page /pricing avec 3 cartes de tarifs (Free, Pro, Business). Chaque carte doit afficher le nom du plan, le prix mensuel, une liste de fonctionnalités, et un bouton CTA qui redirige vers Stripe Checkout. Utilise le même style que les autres pages du projet. La page doit être responsive."

La différence est énorme. Avec le premier prompt, Claude va devoir deviner beaucoup de choses et risque de partir dans une direction que tu ne veux pas.

Donne du contexte

Claude est très fort quand il a du contexte. Plus tu lui en donnes, meilleur sera le résultat. Le contexte, c'est simplement expliquer en détail ce que tu veux, et rappeler ce qui existe déjà :

Sur la page /dashboard, on a déjà une liste de projets avec un
bouton "Voir le projet" qui redirige vers la page du projet.

J'aimerais ajouter la même chose mais pour les tâches : une section
sous les projets qui affiche les 5 dernières tâches de l'utilisateur
avec le nom de la tâche, le projet associé, et un badge de statut
(en cours, terminé, en attente). Le design doit être le même style
que la liste de projets qui existe déjà. N'oublie pas de gérer le
cas où l'utilisateur n'a aucune tâche.

Avance étape par étape

Ne demande pas 10 choses en même temps. Claude travaille mieux quand il se concentre sur une tâche à la fois.

Au lieu de : "Crée le dashboard avec les stats, les graphiques, la liste des utilisateurs, les filtres et l'export PDF"

Fais plutôt :

1. "Crée la structure de base du dashboard avec un layout propre"
2. "Ajoute les cartes de statistiques en haut du dashboard"
3. "Ajoute un graphique d'activité avec Recharts"
4. ... et ainsi de suite

Dis-lui ce qu'il ne doit PAS faire

Claude a parfois tendance à en faire trop. N'hésite pas à le cadrer :

Ajoute un bouton "Supprimer" sur chaque carte de tâche.
- Garde le design simple, pas d'animation
- Ne touche pas aux autres composants
- Ne crée pas de fichier supplémentaire si ce n'est pas nécessaire

C'est quoi le Mode Plan ?

Le Mode Plan, c'est une fonctionnalité de Claude Code qui lui dit : "Réfléchis d'abord, code ensuite." Au lieu de se jeter directement dans le code, Claude va d'abord analyser ton projet, réfléchir à la meilleure approche, et te présenter un plan détaillé. Tu valides le plan (ou tu l'ajustes), et seulement ensuite il commence à coder.

C'est ultra simple à utiliser : tu appuies deux fois sur Shift+Tab pour activer le Mode Plan, ou tu ajoutes simplement "mets-toi en mode plan" dans ton message.

Quand utiliser le Mode Plan ?

La règle est simple : dès que c'est plus qu'un petit changement rapide, utilise le Mode Plan.

Utilise le Mode Plan pour :

• Ajouter une nouvelle fonctionnalité (ex : "Ajoute un système de notifications")
• Modifier quelque chose de complexe (ex : "Refais le design du dashboard")
• Créer un nouveau composant ou une nouvelle page
• Tout ce qui touche à plusieurs fichiers en même temps
• Quand tu n'es pas sûr de la meilleure approche

Tu n'en as PAS besoin pour :

• Changer une couleur, un texte, un petit style
• Corriger un bug simple et identifié
• Ajouter un console.log pour débugger

Pourquoi c'est mieux ?

Sans Mode Plan, Claude se lance directement dans les modifications. Il peut partir dans une direction que tu ne voulais pas, créer des fichiers inutiles, ou faire des choix d'architecture qui ne te conviennent pas. Et une fois que c'est fait, c'est plus difficile de revenir en arrière.

Avec le Mode Plan, tu vois exactement ce que Claude va faire avant qu'il le fasse. Tu peux lui dire "non, plutôt comme ça" ou "oui mais sans toucher à ce fichier". C'est comme valider les plans d'un architecte avant de construire la maison.

En pratique

Voici un exemple concret. Tu veux ajouter un système de tags sur les tâches de ton app :

Mets-toi en mode plan. Je veux ajouter un système de tags pour
les tâches. L'utilisateur doit pouvoir :
- Créer des tags avec une couleur
- Assigner plusieurs tags à une tâche
- Filtrer les tâches par tag

Crée le plan détaillé de comment tu ferais ça.

Claude va te répondre avec un plan structuré : les tables à créer dans Supabase, les composants à modifier, les fichiers à créer, dans quel ordre... Tu relis, tu valides (ou tu ajustes), et il se met au travail.

C'est 5 minutes de planification qui peuvent te faire économiser des heures de corrections.

Les commandes slash (/)

Claude Code a des commandes intégrées que tu lances en tapant /. Voici les plus utiles :

Le compactage : ton meilleur ami

C'est le concept le plus important à comprendre. Claude a une fenêtre de contexte limitée. Pense à ça comme sa mémoire de travail. Plus la conversation est longue, plus il utilise de mémoire, et plus il risque de "perdre le fil" ou de faire des erreurs.

Concrètement :

• Claude peut gérer environ 200 000 tokens (environ 150 000 mots) par conversation
• Mais sa qualité commence à baisser bien avant d'atteindre cette limite
• Chaque message, chaque fichier lu, chaque modification faite prend de la place

Ce que tu dois faire :

• Tape /context régulièrement pour voir où tu en es
• Quand tu arrives à environ 50-60% d'utilisation, tape /compact pour résumer la conversation
• Pour les tâches complexes, n'hésite pas à faire /clear et repartir de zéro (Claude a toujours ton CLAUDE.md, donc il ne perd pas le contexte de ton projet)

L'astuce du "copier-coller reset"

Quand ta conversation est devenue trop longue et que Claude commence à faire n'importe quoi :

1. Copie les informations importantes de la conversation actuelle
2. Tape /clear pour tout effacer
3. Colle les infos importantes dans un nouveau message
4. Continue sur une base propre

C'est souvent bien plus efficace que de laisser Claude patauger dans une conversation trop longue.

Les raccourcis clavier utiles

Créer ses propres commandes

Si tu te retrouves à taper souvent la même chose, tu peux créer des commandes personnalisées. Par exemple, une commande /check qui vérifie que tout fonctionne :

Demande simplement à Claude :

Crée une commande personnalisée /check qui lance le build du projet,
vérifie qu'il n'y a pas d'erreurs TypeScript, et me fait un résumé
de ce qui a changé depuis le dernier commit Git.

Claude créera un fichier dans .claude/commands/ avec les instructions.

Pourquoi c'est crucial

C'est peut-être la partie la moins "sexy" de ce guide, mais c'est celle qui fait la différence entre quelqu'un qui galère avec Claude Code et quelqu'un qui est productif.

Claude est sans mémoire permanente entre les conversations. Chaque fois que tu commences une nouvelle conversation, il repart de zéro (sauf le CLAUDE.md qu'il lit automatiquement). Et dans une même conversation, sa mémoire se remplit au fur et à mesure.

Le scratchpad : ta note de travail

Le scratchpad, c'est un fichier (souvent appelé SCRATCHPAD.md ou plan.md) dans lequel Claude écrit ses notes de travail. C'est comme un post-it géant qui survit entre les conversations.

Tu peux demander à Claude :

Avant de terminer, écris un résumé de ce qu'on a fait aujourd'hui
et ce qui reste à faire dans le fichier SCRATCHPAD.md

La prochaine fois que tu lances Claude, tu lui dis :

Lis le SCRATCHPAD.md pour te remettre dans le contexte
de ce qu'on faisait hier

Une conversation = une tâche

C'est la règle la plus simple et la plus efficace : garde une conversation par fonctionnalité ou tâche. Ne mélange pas tout dans la même conversation.

• Conversation 1 : "Ajouter la page de profil utilisateur"
• Conversation 2 : "Corriger le bug sur la page d'accueil"
• Conversation 3 : "Améliorer le design du dashboard"

Quand tu as fini une tâche, /clear et passe à la suivante.

Quand Claude commence à dérailler

Si Claude commence à :

• Oublier des choses que tu lui as dites plus tôt
• Faire des modifications que tu n'as pas demandées
• Tourner en rond sur un même problème
• Produire du code de moins bonne qualité

C'est souvent un signe que le contexte est trop rempli. La solution : /compact ou /clear et recommencer avec des instructions fraîches.

Ne te bats pas contre le mur

Si Claude est bloqué sur un problème après 2-3 tentatives, ne continue pas à insister. Fais plutôt :

1. /clear pour repartir à zéro
2. Reformule ton problème différemment
3. Ou simplifie la tâche en la découpant en étapes plus petites

C'est contre-intuitif, mais recommencer à zéro est souvent plus rapide que de forcer Claude à corriger ses erreurs.

C'est quoi un MCP ?

MCP, ça veut dire Model Context Protocol. En termes simples, c'est un moyen de connecter Claude à des services externes pour qu'il puisse interagir avec eux directement, sans quitter ton éditeur.

Par exemple, dans ton workflow avec Supabase, tu utilises déjà le CLI Supabase pour gérer tes migrations et ta base de données. Le MCP Supabase ne remplace pas ça. C'est un complément. Son vrai intérêt, c'est de permettre à Claude d'aller chercher des informations rapidement dans ta base de données.

Personnellement, je mets souvent le MCP Supabase en lecture seule (read-only). Comme ça, Claude peut consulter la structure de mes tables, vérifier les données, comprendre les relations entre les tables... sans risquer de modifier quoi que ce soit. C'est super pratique quand tu travailles sur une fonctionnalité et que Claude a besoin de connaître la structure exacte de ta base de données pour écrire le bon code.

Installer un MCP : l'exemple de Supabase

Le MCP Supabase est probablement le premier (et peut-être le seul) que tu vas installer. Voici comment faire :

1. Dans Claude Code (dans le terminal), tape :

claude mcp add supabase -- npx -y @supabase/mcp-server-supabase@latest --project-ref=TON_PROJECT_REF

Remplace TON_PROJECT_REF par la référence de ton projet Supabase (tu la trouves dans les Settings de ton projet sur supabase.com).

2. Claude va te demander de t'authentifier avec Supabase
3. Une fois connecté, Claude peut directement consulter ta base de données

Ce que ça change concrètement

Avec le MCP Supabase installé, tu peux dire à Claude des choses comme :

Regarde la structure de ma table "users" dans Supabase,
j'ai besoin que tu comprennes les champs existants avant
de coder la page de profil

Montre-moi les tables qui existent dans ma base de données
et leurs relations

Vérifie les politiques RLS sur la table "tasks" pour voir
si un utilisateur peut bien accéder uniquement à ses propres tâches

Au lieu de devoir aller sur le dashboard Supabase, copier les infos et les coller à Claude, il va directement chercher ce dont il a besoin. C'est un gain de temps au quotidien.

Autres MCP (optionnels)

Le MCP Supabase est celui que j'utilise principalement. Les autres sont vraiment des petits plus optionnels, mais si tu veux aller plus loin :

Personnellement, j'utilise principalement le MCP Supabase. Les autres, c'est du bonus si tu en ressens le besoin.

Attention au contexte

Chaque MCP installé prend un peu de place dans la mémoire de Claude (parce qu'il doit connaître les outils disponibles). Si tu en installes trop, ça peut réduire la mémoire disponible pour ton travail.

Ma recommandation : installe seulement les MCP que tu utilises réellement. Pour la plupart des projets, le MCP Supabase suffit largement. Tu peux en désactiver certains quand tu ne les utilises pas.

Pour voir tes MCP installés, tape /mcp dans Claude Code.

Utilise Git régulièrement

Claude Code peut gérer Git pour toi. Demande-lui de faire des commits réguliers :

Fais un commit avec un message décrivant les changements qu'on vient de faire

L'avantage, c'est que si Claude fait une bêtise, tu peux toujours revenir en arrière grâce à l'historique Git.

Astuce : Fais un commit après chaque fonctionnalité qui marche. Comme ça, si la fonctionnalité suivante casse quelque chose, tu peux revenir à un état stable.

Le checkpoint : ton filet de sécurité

Claude Code a un système de checkpoints. Si Claude fait des modifications qui cassent quelque chose, tu peux annuler :

• Appuie deux fois sur Echap rapidement, et tu auras l'option de revenir en arrière sur les dernières modifications
• Tu peux aussi utiliser /rewind pour revenir à un point précis de la conversation

Vérifie toujours ce que Claude fait

Ne fais pas confiance aveuglément. Claude est très bon, mais il fait des erreurs. Après chaque modification :

1. Regarde les fichiers modifiés (Claude te les montre)
2. Lance ton app en local pour vérifier que ça marche
3. Teste la fonctionnalité manuellement

C'est tentant de laisser Claude tout faire sans regarder, mais les petites erreurs s'accumulent et deviennent des gros problèmes plus tard.

Quand Claude a du mal avec un bug

Si Claude tourne en rond sur un problème :

1. Copie le message d'erreur et donne-le-lui clairement
2. Donne-lui le contexte : "Ce bug apparaît quand je clique sur le bouton X de la page Y"
3. Demande-lui d'analyser avant d'agir : "Analyse d'abord le problème sans faire de changements. Dis-moi ce que tu penses être la cause."
4. Si après 2-3 tentatives ça ne marche toujours pas, /clear et recommence avec une description fraîche du problème

Switcher entre Sonnet et Opus

Claude Code te permet de choisir entre deux modèles :

• Sonnet : plus rapide, idéal pour les tâches simples (modifier un style, ajouter un bouton, du code assez standard)
• Opus : plus lent mais plus intelligent, idéal pour les tâches complexes (architecture, debugging difficile, nouvelles fonctionnalités complexes)

Tu peux basculer entre les deux avec Shift + Tab dans le terminal. En général, Opus est le meilleur choix par défaut. Utilise Sonnet quand tu veux aller vite sur des tâches simples.

Le workflow complet

Si tu as suivi le guide Lovable et que tu veux maintenant continuer ton projet avec Claude Code, voici les étapes :

1. Exporte ton projet de Lovable vers GitHub

• Dans Lovable, connecte ton projet à GitHub (si ce n'est pas déjà fait)
• Assure-toi que tout est synchronisé

2. Clone le projet sur ton ordinateur

• Ouvre VS Code
• Ouvre le terminal (Menu → Terminal → New Terminal)
• Tape :

git clone https://github.com/ton-username/ton-projet.git

• Ouvre le dossier du projet dans VS Code

3. Installe les dépendances

npm install

4. Lance le projet en local

npm run dev

Vérifie que tout fonctionne dans ton navigateur à l'adresse indiquée (généralement http://localhost:5173 ou http://localhost:3000).

5. Lance Claude Code et crée ton CLAUDE.md

Analyse ce projet qui a été créé avec Lovable et crée un fichier
CLAUDE.md complet à la racine. Inclus la stack technique, la structure
du projet, les commandes importantes, et les intégrations existantes
(Supabase, Clerk, etc.).

6. Tu es prêt !

A partir de maintenant, tu peux continuer ton projet avec Claude Code. Tu bénéficies de toute la puissance de l'IA sans les limitations et le coût des crédits Lovable.

Ce qui change par rapport à Lovable

Le piège à éviter

Ne demande pas à Claude Code de "refaire" ce que Lovable a fait. Ton code existe déjà et il fonctionne. Pars de ce qui existe et améliore-le progressivement. Claude Code est excellent pour comprendre du code existant et le faire évoluer.

C'est quoi un Skill ?

Les Skills, c'est une fonctionnalité ajoutée assez récemment par Anthropic. En résumé, un Skill c'est un prompt pré-configuré dans un fichier que Claude peut utiliser automatiquement quand c'est pertinent.

Imagine que tu fais la même tâche tous les mois (créer un email, générer un rapport, mettre à jour une doc...). Au lieu de réécrire à chaque fois un long prompt avec toutes les instructions, tu crées un Skill une seule fois, et ensuite tu dis juste à Claude "utilise le skill X" et il sait exactement quoi faire.

C'est un peu comme une recette de cuisine que tu écris une fois et que tu réutilises à l'infini.

C'est vraiment optionnel

Soyons clairs : tu n'as pas besoin de Skills pour bien utiliser Claude Code. C'est un petit plus pour ceux qui veulent gagner encore plus de temps sur des tâches répétitives. Si tu débutes, tu peux très bien ignorer cette section et y revenir plus tard.

Un exemple concret

Pour te donner une idée, voici comment je l'utilise personnellement. Sur ma plateforme DupliqMe (plateforme de génération d'images par IA), j'ai créé un Skill qui me génère automatiquement l'email de newsletter mensuel.

Dans ce Skill, j'ai mis toutes les instructions :

• Le design HTML à utiliser (qui reprend les couleurs et le style de DupliqMe)
• Mon ton de voix et ma façon de m'adresser à mes utilisateurs
• Le fait qu'il doit aller chercher toutes les nouvelles fonctionnalités et modifications du mois dans l'historique Git
• Le format de l'email avec les sections (intro, nouveautés, conclusion)
• Qu'il doit produire un code HTML prêt à copier-coller

Du coup, en fin de mois, je dis simplement à Claude :

Utilise le skill newsletter pour créer l'email du mois

Et en quelques minutes, j'ai un email HTML complet, avec le bon design, le bon ton, et toutes les nouveautés du mois. Je n'ai plus qu'à le copier-coller dans mon service d'emailing (j'utilise Brevo pour DupliqMe).

Comment créer un Skill

C'est très simple. Un Skill, c'est juste un dossier avec un fichier SKILL.md dedans :

1. Crée un dossier dans .claude/skills/nom-du-skill/
2. Crée un fichier SKILL.md à l'intérieur
3. Écris les instructions en Markdown

Ou encore plus simple, demande à Claude :

Crée un skill appelé "newsletter" qui génère un email HTML
mensuel pour ma newsletter. Voici les instructions :
[décris ce que tu veux en détail]

Claude créera le Skill pour toi dans le bon dossier.

Quand créer un Skill ?

Crée un Skill quand tu te retrouves à :

• Écrire le même genre de prompt plus de 2-3 fois
• Avoir une tâche récurrente (hebdomadaire, mensuelle...)
• Vouloir un résultat très spécifique et toujours dans le même format

Avant de commencer ta session

• Ouvre ton projet dans VS Code
• Vérifie que ton CLAUDE.md est à jour
• Lance ton projet en local (npm run dev)
• Lance Claude Code
• Définis clairement ce que tu veux accomplir dans cette session

Pendant que tu travailles

• Une tâche par conversation
• Sois précis dans tes demandes
• Vérifie le contexte avec /context régulièrement
• Fais /compact quand tu approches de 50-60% de contexte
• Fais des commits Git après chaque fonctionnalité qui marche
• Teste dans ton navigateur après chaque modification importante

Quand ça coince

• Ne force pas : si Claude est bloqué après 2-3 tentatives, /clear et recommence
• Reformule ton problème différemment
• Découpe en étapes plus petites
• Donne le message d'erreur exact à Claude
• Demande-lui d'analyser avant de modifier

En fin de session

• Fais un commit Git final
• Demande à Claude de mettre à jour le SCRATCHPAD.md avec l'état actuel
• Mets à jour le CLAUDE.md si nécessaire