Tutoriel 14 fevrier 2026

Claude Code : le cours complet pour debutants

Tout ce qu'il faut savoir sur Claude Code en un seul guide : de l'installation a la creation de skills automatises, en passant par la gestion du contexte, le plan mode et les MCP. Synthese et notes du cours de Nick Saraev.

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 premiere utilisation, authentifiez-vous avec /login. L'interface affiche le modele utilise (ex: Opus 4.6), votre plan, le repertoire de travail courant, et un compteur de tokens.

L'interface terminal

L'ecran 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 editeur de texte, et un chat IA. Deux IDE dominent le marche :

  • VS Code — Le classique de Microsoft, tres extensible. Installez l'extension "Claude Code" par Anthropic (verifiez le badge officiel).
  • Antigravity — Une version modernisee de VS Code, orientee IA. C'est un produit Google, mais Claude Code s'y integre parfaitement.

Dans les deux cas, Claude Code apparait dans un panneau lateral avec les memes fonctionnalites que le terminal : chat, modes de permissions, et acces aux fichiers du projet.

CLAUDE.md : le cerveau du projet

Le fichier CLAUDE.md est injecte au tout debut de chaque conversation, avant meme votre premier message. C'est la trajectoire initiale du bateau — une legere deviation au depart se traduit par un enorme ecart a l'arrivee.

L'analogie du navire

Imaginez un navire traversant l'Atlantique. Si l'angle de depart est imprecis, meme d'un degre, apres 10 000 km vous ratez completement votre destination. Le CLAUDE.md reduit 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 genere un CLAUDE.md
  • Utilisez des bullet points et des titres courts, haute densite d'information
  • Mettez les regles critiques en haut (biais de primaute : Claude retient mieux le debut et la fin)
  • Limitez a 200-500 lignes max
  • Elaguez regulierement — traitez-le comme de la dette technique

Ce qu'il ne faut PAS faire

  • Ne collez pas des docs API entieres (10 000 tokens inutiles a chaque session)
  • Evitez les instructions vagues ("sois intelligent", "fais pas d'erreurs")
  • N'oubliez pas d'ajouter des regles quand Claude repete la meme erreur

Les trois niveaux de CLAUDE.md

  1. Global (~/.claude/CLAUDE.md) — S'applique a tous les workspaces
  2. Projet (.claude/CLAUDE.md) — Specifique 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 methodes pour designer avec Claude Code :

1. Screenshot + boucle de verification

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 fidelite.

2. Voice transcript dump

On parle 3x plus vite qu'on tape (~200 mots/min vs 60). Utilisez la dictee vocale pour decrire 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 tache, le laisser executer, puis lui permettre de verifier le resultat (via screenshot, tests automatises, etc.). Sans cette boucle de verification, vous perdez la majeure partie de la valeur de l'IA.

L'IA ne reussit pas du premier coup a 100%, mais elle atteint 80% en quelques secondes, puis 95%, puis 99% — la ou un humain mettrait des heures pour un seul passage de haute qualite.

Le dossier .claude : fonctionnalites avancees

Le dossier .claude/ est cache (convention Unix : prefixe point). Il contient la configuration avancee de Claude Code :

  • settings.json — Permissions d'equipe et hooks
  • settings.local.json — Settings locaux (non pushes sur GitHub)
  • CLAUDE.md / CLAUDE.local.md — Instructions du projet
  • agents/ — Definitions de sub-agents
  • skills/ — Skills personnalises (ex-slash commands)
  • rules/ — Regles segmentees (workflow, design, technique...)
  • .mcp.json — Configuration MCP

Rules : segmenter le CLAUDE.md

Au lieu d'un seul gros fichier CLAUDE.md, decoupez-le en fichiers de regles dans .claude/rules/ : workflow.md, design-rules.md, tech-defaults.md. Chaque fichier gere un aspect specifique, ce qui facilite la maintenance et le travail en equipe.

Memory : la memoire persistante

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

Sub-agents : deleguer intelligemment

Les sub-agents sont des agents enfants lances par l'agent principal, avec leur propre contexte isole. Ils executent une tache et ne renvoient qu'un resume au parent — enormes economies 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 synthese au parent. Utilisez un modele moins cher comme Sonnet.
  • Reviewer agent — Lit le code sans aucun contexte prealable, donc sans biais. Detecte les problemes que l'agent principal, biaise par son propre raisonnement, ne voit pas. Equivalent d'un code review humain.
  • QA / Testing agent — Execute les tests automatises dans un contexte separe. Evite de polluer le parent avec les logs de tests.

Comment creer un agent

Creez 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 edits — Claude demande confirmation avant chaque modification. Safe mais lent.
  2. Edit automatically — Auto-accepte les edits 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 detaille avant l'execution.
  4. Bypass permissions — Carte blanche totale. A activer dans les settings de l'extension (Allowed dangerously skip permissions).

Avertissement bypass

Un cas celebre : quelqu'un en bypass permissions a vu Claude executer sudo rm -rf, effacant tout le disque dur. C'est extremement rare, mais possible. A utiliser en connaissance de cause.

Plan mode : planifier avant de construire

Le plan mode est le mode le plus strategique. Claude peut uniquement rechercher (web, fichiers) et raisonner, sans modifier aucun fichier. Il produit un plan detaille que vous validez avant de passer en mode execution.

Pourquoi planifier ?

Une minute de planification economise dix minutes de construction :

  • Sans plan : build (15 min) + test + decouverte d'un probleme + rebuild = 35+ minutes
  • Avec plan : plan (5 min) + detection du probleme en theorie + replan (5 min) + build (5 min) = 15 minutes

Le plan reduit 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 donnees, paiement...)
  3. Generation d'un plan detaille avec schema 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 iteratifs : login, generation AI, signature, paiement
  7. Deploiement sur Netlify

Resultat : une app full-stack avec authentification, generation 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, edit, web search...)
  • MCP tools (variable) — Peut exploser si les MCP sont mal ecrits
  • 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) — Reserve pour la compression automatique

Strategies pour economiser les tokens

  • /compact — Compresse manuellement l'historique en un resume haute densite
  • /clear — Repart de zero (utile quand on change de sujet)
  • Parlez en haute densite d'information (ou passez votre voice dump dans un modele moins cher pour le condenser)
  • Utilisez des modeles moins chers (Sonnet, Haiku) pour les sub-agents
  • Reduisez les MCP inutiles — un seul outil MCP peut consommer plus que tous vos skills combines
  • Activez le thinking (raisonnement) — les tokens de reflexion ne polluent pas le contexte
  • Ecrivez des prompts specifiques plutot 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 fonctionnalite la plus economiquement puissante de Claude Code. Ce sont des checklists orchestrees : un fichier Markdown qui definit une procedure, associe a des scripts Python/JS qui executent les etapes techniques.

Anatomie d'un skill

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

Le front matter du skill.md (nom, description, outils autorises) est le seul element charge en contexte (~60 tokens). Le contenu complet n'est charge que lorsque Claude decide 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 academique sur PubMed avec review automatisee
  • Shop Amazon — Browse et compare des produits via Chrome DevTools MCP
  • Website Generator — Genere un site personnalise par prospect en 30 secondes a partir d'un template et d'un Google Sheet

Creer un skill

Procedure simple : decrivez ce que vous voulez en bullet points, laissez Claude structurer le skill.md et creer les scripts. Testez avec une instance fraiche de Claude, ajustez, et repetez jusqu'a ~98-99% de fiabilite.

Model Context Protocol (MCP)

Les MCP sont comme des skills, mais faits par d'autres developpeurs. 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 cle API.

MCP vs Skills : le piege 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 strategie recommandee :

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

Securite : les precautions essentielles

Avant de deployer une app vibe-codee sur internet :

  • N'utilisez pas d'URLs evidentes — les scanners parcourent constamment le web
  • Ne facturez jamais sans audit de securite — faites relire l'authentification par un developpeur
  • Preferez les apps internes (equipe, clients directs) plutot que publiques
  • Claude Code n'est pas encore capable de patcher 100% des failles frontend et backend

Aussi dans la video

Ce cours de +3 heures couvre aussi les sujets suivants, non detailles dans cet article :

  • Slash commands — /compact, /clear, /context, /cost, /model, /thinking, /status-line, /init
  • Hooks — Scripts personnalises qui se declenchent avant/apres chaque tool call (ex: chime sonore quand Claude a fini)
  • Agent teams — Feature ou un agent leader delegue du travail a plusieurs sub-agents (7x plus de tokens qu'une session standard)
  • Git worktrees — Sessions paralleles sur differentes branches sans les conflits de contexte
  • Fast mode — Mode 2.5x plus rapide pour ~3x le prix, utile pour les workflows intensifs
  • Deploiement — Netlify, Vercel, Modal pour mettre en production vos apps et automatisations
  • GitHub Actions — Lancer Claude Code en CI/CD via webhooks

Video originale : Nick Saraev — The Definitive Claude Code Course for Beginners

Commencer avec Claude Code

Consultez la documentation officielle et commencez a construire.

Documentation Claude Code
Retour aux articles