Claude Code : le cours complet pour débutants

Installation et premier lancement

Pour utiliser Claude Code, il faut au minimum le plan Pro d'Anthropic (17$/mois). L'installation se fait via une simple commande dans le terminal :

curl -fsSL https://claude.ai/install | sh

Une fois installe, tapez claude dans votre terminal. Lors de la première utilisation, authentifiez-vous avec /login. L'interface affiche le modele utilise (ex: Opus 4.6), votre plan, le répertoire de travail courant, et un compteur de tokens.

L'interface terminal

L'écran terminal peut paraitre intimidant, mais il affiche l'essentiel : le modele, le contexte utilise (de 0 a 100%), les tokens consommes, et une status line personnalisable. Le contexte est comprime automatiquement par Claude Code quand il approche de la limite.

Les IDE : VS Code et Antigravity

Un IDE (Integrated Development Environment) combine trois choses : un explorateur de fichiers, un éditeur de texte, et un chat IA. Deux IDE dominent le marche :

• VS Code - Le classique de Microsoft, très extensible. Installez l'extension "Claude Code" par Anthropic (vérifiez le badge officiel).
• Antigravity - Une version modernisée de VS Code, orientée IA. C'est un produit Google, mais Claude Code s'y intégré parfaitement.

Dans les deux cas, Claude Code apparaît dans un panneau latéral avec les mêmes fonctionnalités que le terminal : chat, modes de permissions, et accès aux fichiers du projet.

CLAUDE.md : le cerveau du projet

Le fichier CLAUDE.md est injecte au tout début de chaque conversation, avant même votre premier message. C'est la trajectoire initiale du bateau - une légère déviation au départ se traduit par un énorme écart à l'arrivée.

L'analogie du navire

Imaginez un navire traversant l'Atlantique. Si l'angle de départ est imprécis, même d'un degré, après 10 000 km vous ratez complètement votre destination. Le CLAUDE.md réduit l'espace des possibles pour que Claude reste sur la bonne trajectoire.

Bonnes pratiques

• Lancez /init dans tout nouveau dossier - Claude analyse le codebase et génère un CLAUDE.md
• Utilisez des bullet points et des titres courts, haute densité d'information
• Mettez les règles critiques en haut (biais de primauté : Claude retient mieux le début et la fin)
• Limitez a 200-500 lignes max
• Élaguez régulièrement - traitez-le comme de la dette technique

Ce qu'il ne faut PAS faire

• Ne collez pas des docs API entières (10 000 tokens inutiles à chaque session)
• Évitez les instructions vagues ("sois intelligent", "fais pas d'erreurs")
• N'oubliez pas d'ajouter des règles quand Claude répète la même erreur

Les trois niveaux de CLAUDE.md

1. Global (~/.claude/CLAUDE.md) - S'applique à tous les workspaces
2. Projet (.claude/CLAUDE.md) - Spécifique au dossier courant
3. Enterprise - Pour les licences entreprise (rare)

Les trois se fusionnent automatiquement au lancement de chaque session.

Construire un site web avec Claude Code

Trois méthodes pour designer avec Claude Code :

1. Screenshot + boucle de vérification

Prenez un screenshot complet d'un site d'inspiration (via DevTools : Cmd+Shift+P > "Capture full size screenshot"), redimensionnez-le a <5 Mo, puis collez-le dans Claude Code avec les styles CSS copies. Claude reproduit le design, se screenshote, compare, et itere jusqu'a ~99% de fidélité.

2. Voice transcript dump

On parle 3x plus vite qu'on tapé (~200 mots/min vs 60). Utilisez la dictée vocale pour décrire tout ce que vous voulez sur le site, puis laissez Claude iterer.

3. Composants (21st.dev, etc.)

Des services comme 21st.dev proposent des composants avec un bouton "Copy prompt". Collez le prompt dans Claude Code et il reproduit le composant.

La philosophie : Task > Do > Verify

La boucle fondamentale de Claude Code : donner une tâche, le laisser exécuter, puis lui permettre de vérifier le résultat (via screenshot, tests automatisés, etc.). Sans cette boucle de vérification, vous perdez la majeure partie de la valeur de l'IA.

L'IA ne réussit pas du premier coup a 100%, mais elle atteint 80% en quelques secondes, puis 95%, puis 99% - la où un humain mettrait des heures pour un seul passage de haute qualité.

Le dossier .claude : fonctionnalités avancées

Le dossier .claude/ est cache (convention Unix : préfixe point). Il contient la configuration avancée de Claude Code :

• settings.json - Permissions d'équipe et hooks
• settings.local.json - Settings locaux (non pushes sur GitHub)
• CLAUDE.md / CLAUDE.local.md - Instructions du projet
• agents/ - Définitions de sub-agents
• skills/ - Skills personnalises (ex-slash commands)
• rules/ - Règles segmentées (workflow, design, technique...)
• .mcp.json - Configuration MCP

Rules : segmenter le CLAUDE.md

Au lieu d'un seul gros fichier CLAUDE.md, découpez-le en fichiers de règles dans .claude/rules/ : workflow.md, design-rules.md, tech-defaults.md. Chaque fichier géré un aspect spécifique, ce qui facilite la maintenance et le travail en équipe.

Memory : la mémoire persistante

En plus du CLAUDE.md, un fichier MEMORY.md est injecte au début de chaque session. Dites "remember that..." et Claude sauvegarde l'info. Utile pour les préférences personnelles, mais distinct du CLAUDE.md (c'est le bloc-notes de Claude, pas vos instructions).

Sub-agents : déléguer intelligemment

Les sub-agents sont des agents enfants lances par l'agent principal, avec leur propre contexte isolé. Ils exécutent une tâche et ne renvoient qu'un résumé au parent - énormes économies de tokens.

Les 3 sub-agents recommandes

• Research agent - Fait toute la recherche (web, APIs, analytics) dans son propre contexte. Peut consommer 100K tokens mais ne renvoie que ~2K de synthèse au parent. Utilisez un modele moins cher comme Sonnet.
• Reviewer agent - Lit le code sans aucun contexte préalable, donc sans biais. Détecte les problèmes que l'agent principal, biaise par son propre raisonnement, ne voit pas. Équivalent d'un code review humain.
• QA / Testing agent - Exécute les tests automatisés dans un contexte séparé. Évite de polluer le parent avec les logs de tests.

Comment créer un agent

Créez un fichier dans .claude/agents/ avec : le nom, la description, les outils autorises, le modele, le nombre max de tours, et les instructions.

Les modes de permission

Quatre modes principaux, accessibles via le bouton en bas de l'interface ou avec Shift+Tab :

1. Ask before édits - Claude demande confirmation avant chaque modification. Safe mais lent.
2. Édit automatically - Auto-accepte les édits sur les fichiers existants, mais demande pour les nouveaux fichiers.
3. Plan mode - Lecture seule. Claude peut rechercher, lire les fichiers, raisonner, mais ne peut rien modifier. Produit un plan détaille avant l'exécution.
4. Bypass permissions - Carte blanche totale. A activer dans les settings de l'extension (Allowed dangerously skip permissions).

Avertissement bypass

Un cas célèbre : quelqu'un en bypass permissions a vu Claude exécuter sudo rm -rf, effaçant tout le disque dur. C'est extrêmement rare, mais possible. À utiliser en connaissance de cause.

Plan mode : planifier avant de construire

Le plan mode est le mode le plus stratégique. Claude peut uniquement rechercher (web, fichiers) et raisonner, sans modifier aucun fichier. Il produit un plan détaille que vous validez avant de passer en mode exécution.

Pourquoi planifier ?

Une minute de planification économise dix minutes de construction :

• Sans plan : build (15 min) + test + découverte d'un problème + rebuild = 35+ minutes
• Avec plan : plan (5 min) + détection du problème en théorie + replan (5 min) + build (5 min) = 15 minutes

Le plan réduit aussi les tokens consommes, car Claude ne part pas en exploration pendant le build.

Exemple pratique : app de propositions commerciales

Construction d'un clone de PandaDoc en ~20 minutes :

1. Voice dump des specs en plan mode
2. Claude pose des questions (framework, base de données, paiement...)
3. Génération d'un plan détaille avec schéma de DB, routes API, user flow
4. Passage en bypass permissions pour le build
5. Configuration Supabase + Stripe + Anthropic API pendant que Claude code
6. Tests itératifs : login, génération AI, signature, paiement
7. Déploiement sur Netlify

Résultat : une app full-stack avec authentification, génération AI de propositions, signature electronique et paiement Stripe.

Gestion du contexte

Le contexte est le nerf de la guerre. Utilisez /context pour voir exactement ce qui consomme vos tokens :

• System prompt (~5-10K) - CLAUDE.md global + local + rules
• System tools (~17K) - Outils natifs de Claude Code (bash, read, édit, web search...)
• MCP tools (variable) - Peut exploser si les MCP sont mal écrits
• Memory (~100 tokens) - Fichier MEMORY.md
• Skills (~60 tokens chacun) - Seul le front matter est charge, pas le contenu
• Messages - Votre conversation
• Buffer auto-compact (~33K) - Réserve pour la compression automatique

Stratégies pour économiser les tokens

• /compact - Compresse manuellement l'historique en un résumé haute densité
• /clear - Repart de zéro (utile quand on change de sujet)
• Parlez en haute densité d'information (ou passez votre voice dump dans un modele moins cher pour le condenser)
• Utilisez des modèles moins chers (Sonnet, Haïku) pour les sub-agents
• Réduisez les MCP inutiles - un seul outil MCP peut consommer plus que tous vos skills combines
• Activez le thinking (raisonnement) - les tokens de réflexion ne polluent pas le contexte
• Écrivez des prompts spécifiques plutôt que vagues ("fix this bug in auth.ts" > "improve the codebase")
• Utilisez le plan mode pour les builds complexes

Skills : automatiser le travail intellectuel

Les skills sont la fonctionnalité la plus économiquement puissante de Claude Code. Ce sont des checklists orchestrées : un fichier Markdown qui définit une procédure, associe à des scripts Python/JS qui exécutent les étapes techniques.

Anatomie d'un skill

• .claude/skills/nom-skill/skill.md - L'orchestrateur (checklist + instructions)
• .claude/skills/nom-skill/scripts/ - Les scripts d'exécution (Python, JS...)

Le front matter du skill.md (nom, description, outils autorises) est le seul élément charge en contexte (~60 tokens). Le contenu complet n'est charge que lorsque Claude décide d'utiliser le skill.

Exemples concrets

• Scrape Leads - Scrape 1000 dentistes en 87 secondes, classe par LLM, uploade sur Google Sheets, enrichit les emails. Processus qui prenait 30+ minutes manuellement.
• Literature Research - Recherche académique sur PubMed avec review automatisée
• Shop Amazon - Browse et compare des produits via Chrome DevTools MCP
• Website Generator - Génère un site personnalise par prospect en 30 secondes à partir d'un template et d'un Google Sheet

Créer un skill

Procédure simple : décrivez ce que vous voulez en bullet points, laissez Claude structurer le skill.md et créer les scripts. Testez avec une instance fraiche de Claude, ajustez, et répétez jusqu'a ~98-99% de fiabilité.

Model Context Protocol (MCP)

Les MCP sont comme des skills, mais faits par d'autres développeurs. Vous branchez un "serveur MCP" et Claude obtient de nouveaux outils (Gmail, ClickUp, Chrome DevTools...).

Ou trouver des MCP

• mcpservers.org
• modelcontextprotocol/servers (GitHub)
• MCP Market

Installation

Copiez le snippet JSON de configuration du MCP, collez-le dans Claude Code en disant "installe ce MCP dans mon workspace local". Pour les MCP authentifies (Gmail, ClickUp...), il faudra fournir une clé API.

MCP vs Skills : le piège des tokens

Attention : un seul outil MCP (ex: ClickUp "update task" = 1600 tokens) peut consommer plus que tous vos skills combines (~60 tokens chacun). La stratégie recommandée :

1. Testez rapidement avec le MCP (rapide à installer)
2. Si ça marche, convertissez en skill (utilisez les endpoints API directement)
3. Ne gardez que les MCP essentiels (Chrome DevTools est incontournable)

Sécurité : les précautions essentielles

Avant de déployer une app vibe-codée sur internet :

• N'utilisez pas d'URLs évidentes - les scanners parcourent constamment le web
• Ne facturez jamais sans audit de sécurité - faites relire l'authentification par un développeur
• Préférez les apps internes (équipe, clients directs) plutôt que publiques
• Claude Code n'est pas encore capable de patcher 100% des failles frontend et backend

Aussi dans la vidéo

Ce cours de +3 heures couvre aussi les sujets suivants, non détaillés dans cet article :

• Slash commands - /compact, /clear, /context, /cost, /model, /thinking, /status-line, /init
• Hooks - Scripts personnalises qui se déclenchent avant/après chaque tool call (ex: chime sonore quand Claude a fini)
• Agent teams - Feature où un agent leader délégué du travail à plusieurs sub-agents (7x plus de tokens qu'une session standard)
• Git worktrees - Sessions parallèles sur différentes branches sans les conflits de contexte
• Fast mode - Mode 2.5x plus rapide pour ~3x le prix, utile pour les workflows intensifs
• Déploiement - Netlify, Vercel, Modal pour mettre en production vos apps et automatisations
• GitHub Actions - Lancer Claude Code en CI/CD via webhooks

Vidéo originale : Nick Saraev - The Définitive Claude Code Course for Beginners