Claude Code est l'agent CLI d'Anthropic pour coder en profondeur : il explore votre codebase, propose un plan, modifie les fichiers, lance vos tests, et vous présente chaque changement en diff que vous validez ou rejetez. Ce n'est ni de l'autocomplétion comme GitHub Copilot, ni un IDE-cocoon comme Cursor : c'est un assistant agentique qui vit dans votre terminal et que vous pilotez avec discipline. Ce hub vous emmène d'installation à industrialisation, avec un fil rouge unique, ~/Projets/lab-claude, et une méthode CLI-first assumée.
Aller droit au but
Section intitulée « Aller droit au but »Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »- Comprendre la logique CLI-first et pourquoi elle accélère l'apprentissage
- Distinguer les blocs de compétences : démarrer, produire, contrôler, industrialiser
- Utiliser le fil rouge lab-claude pour pratiquer sans changer de contexte
- Poser vos conventions et garde-fous dans
CLAUDE.mddès que le projet a du sens - Appliquer la boucle opérationnelle : cadrer, exécuter, valider, corriger
- Transposer la méthode CLI vers VS Code sans perdre la discipline
- Repérer les sujets avancés à explorer ensuite : rules, skills, hooks, MCP, subagents
Qu'est-ce que Claude Code ?
Section intitulée « Qu'est-ce que Claude Code ? »Claude Code est un agent de développement lancé en CLI par Anthropic. Il s'installe en une commande npm, se lance via claude dans un dossier de projet, et démarre une session interactive qui peut lire vos fichiers, exécuter des commandes shell, modifier votre code, lancer vos tests et vous présenter chaque changement en diff pour validation.
Trois caractéristiques qui le distinguent
Section intitulée « Trois caractéristiques qui le distinguent »- Agentique plutôt que complétion : il explore votre projet avant d'écrire la première ligne. C'est ce qui change tout face à l'autocomplétion classique.
- CLI-first par design : la version CLI est la référence, l'extension VS Code reprend les mêmes concepts. Pas l'inverse.
- Modèles Anthropic sous le capot : Claude Opus 4.8 pour la capacité maximale, Sonnet 4.6 pour l'équilibre coût/qualité (défaut), Haiku 4.5 pour les opérations rapides. Pour le détail (capacités, prix, cas d'usage par modèle et arbre de décision), voir le guide dédié Modèles Claude Code : Opus, Sonnet, Haiku, quand choisir quoi.
Ce n'est pas (ou plus exactement « pas seulement »)
Section intitulée « Ce n'est pas (ou plus exactement « pas seulement ») »- Pas une autocomplétion type GitHub Copilot, pas de suggestion inline pendant que vous tapez.
- Pas un chat assistant type ChatGPT, il agit sur votre filesystem, pas seulement dans une fenêtre.
- Pas un IDE type Cursor, il vit dans votre terminal et s'intègre à votre éditeur existant.
C'est cette nature agentique CLI qui demande la méthode décrite dans ce parcours : plan, diff, validation. Sans ces réflexes, Claude Code part en sucette comme n'importe quel agent IA mal cadré.
Votre parcours en 1 minute
Section intitulée « Votre parcours en 1 minute »Cette série suit une progression stable sur le même dépôt d'entraînement : ~/Projets/lab-claude.
-
Démarrer proprement Fondations
- Installer la CLI
- Créer le fil rouge
- Vérifier l'environnement
-
Produire des changements fiables Pratique
- Prompting de base
- Workflow réel CLI
- Validation systématique
-
Installer la gouvernance Contrôle
CLAUDE.md- Mode plan
- Relecture diff et recadrage
-
Étendre vers l'IDE Industrialisation
- Extension VS Code
- @-mentions et contexte ciblé
- Permissions et checkpoints
Les 8 leviers Claude Code à connaître
Section intitulée « Les 8 leviers Claude Code à connaître »| Levier | Rôle | Quand l'utiliser |
|---|---|---|
| Prompt ponctuel | Demande immédiate sur une tâche | Besoin local et court |
CLAUDE.md | Conventions persistantes du projet | Travailler en équipe avec cadre stable |
.claude/rules/*.md | Règles ciblées par zone de code | API, tests, infra avec contraintes distinctes |
skills/*/SKILL.md | Procédures réutilisables | Tâches répétitives et standardisées |
| Hooks | Automatisation déterministe | Vérifications obligatoires systématiques |
| MCP | Connexion à des outils externes | Issues, docs, données hors repo |
| Subagents | Délégation en contexte isolé | Audit, exploration, revue parallèle |
| Auto memory | Mémoire de session structurée | Capitaliser les apprentissages |
Par où commencer ?
Section intitulée « Par où commencer ? »Validation minimale sur le fil rouge
Section intitulée « Validation minimale sur le fil rouge »Sur lab-claude, gardez ce rituel simple après chaque changement significatif :
uv run ruff check .uv run pytest -qVérification : corrigez les erreurs de lint avant de relancer les tests. Cette discipline limite les régressions et rend les sessions plus courtes.
Erreurs fréquentes
Section intitulée « Erreurs fréquentes »| Symptôme | Cause probable | Correction |
|---|---|---|
| Session trop longue et floue | Objectif mal borné | Réduire le périmètre à une amélioration unique |
| Changements difficiles à relire | Pas de plan ni diff cadré | Imposer plan court puis relecture diff |
| Résultat non fiable | Validation oubliée | Lancer uv run ruff check . puis uv run pytest -q |
| Règles non appliquées | Gouvernance implicite | Ajouter un CLAUDE.md minimal et concret |
Mon retour d'expérience, pourquoi CLI-first et pas autre chose
Section intitulée « Mon retour d'expérience, pourquoi CLI-first et pas autre chose »J'utilise des assistants IA pour coder depuis le premier accès grand public à GitHub Copilot en 2021. J'ai essayé Cursor sérieusement pendant 4 mois en 2024, Aider sur trois projets perso, Cody brièvement en équipe, et Claude Code depuis sa sortie publique. Mon constat après ces itérations : la qualité du résultat dépend moins du modèle que du cadre que vous imposez à l'outil.
Claude Code en mode CLI est celui qui m'a permis de poser le cadre le plus strictement, pour quatre raisons concrètes :
- Le terminal force la discipline. Pas de complétion qui tire votre attention pendant que vous tapez. Vous formulez votre demande en entier avant qu'il ne réponde. Cette friction est un atout, pas un défaut.
- Le
CLAUDE.mdest de la doc, pas du code. Vous l'éditez avec un éditeur normal, vous le commitez, vous le diffusez à l'équipe. Pas un système opaque baked-in dans un IDE propriétaire. - Le triptyque plan → diff → validation est explicite. Vous voyez exactement ce qui va changer avant d'accepter. Pas de modification silencieuse dans l'arborescence pendant que vous regardez l'écran de chargement.
- Le mode headless permet d'industrialiser : pre-commit hook, GitHub Actions, scripts CI. C'est ce qui transforme l'outil de gadget personnel en composant d'équipe.
Je suis revenu au CLI après avoir testé Cursor non pas parce que Cursor est mauvais, il est très bon, mais parce que j'avais besoin de cette discipline et d'une transposabilité vers la CI que l'approche IDE-only ne donne pas.
Ce que ce parcours défend
Section intitulée « Ce que ce parcours défend »J'assume cinq opinions qui structurent tout le contenu suivant :
- Le plan vient avant le diff, toujours. Une session sans plan explicite produit du code qu'on relit deux fois plus longtemps. Trente secondes de cadrage économisent vingt minutes de relecture.
CLAUDE.mdminimal et concret batCLAUDE.mdexhaustif et flou. Un fichier de 50 lignes ciblées qui dit « voici comment je teste, voici comment je commit, voici ce que je n'autorise pas » fait plus que 500 lignes d'opinions générales.- Sessions courtes plutôt que mégasessions. Une tâche = une session. Dès qu'on dépasse trois sujets dans la même conversation, la qualité s'effondre, pour Claude comme pour n'importe quel autre agent. Ce n'est pas un défaut du modèle, c'est une limite du contexte.
- Validation automatisée plutôt que validation à la main. Tout ce que vous demandez à Claude doit pouvoir être validé par
ruff,pytest,mypy,actionlintou équivalent. Si vous ne pouvez pas l'automatiser, vous n'avez pas spécifié. - CLI avant IDE pour démarrer. L'extension VS Code est excellente, mais elle masque les concepts. Apprenez d'abord en CLI où vous voyez exactement ce qui se passe, puis transposez.
Ce que je vous interdis
Section intitulée « Ce que je vous interdis »Cinq anti-patterns que j'ai vus tuer la productivité dans les équipes :
- Lancer Claude sans plan. « Refactor cette classe » sur un fichier de 500 lignes = catastrophe garantie. Toujours demander un plan avant l'exécution, et le relire.
- Accepter un diff sans le relire ligne par ligne. L'IA est rapide, vous ne devez pas l'être. Cinq minutes de relecture évitent une régression silencieuse en production.
- Empiler les règles dans
CLAUDE.mdparce que « ça pourrait servir ». Une règle ajoutée = un signal cognitif de plus pour Claude. Les bonsCLAUDE.mdsont maigres et opérationnels, pas des bibles. - Mélanger trois objectifs dans la même session. « Corrige ce bug + ajoute des tests + refactor cette autre fonction » → vous obtenez trois résultats moyens au lieu d'un bon. Sortez et recommencez.
- Croire que l'IA remplace les tests. Aucun agent, pas même Opus 4.7, ne peut garantir qu'une modification ne casse rien sans tests qui couvrent le comportement. Pas de tests = pas de filet, peu importe la qualité du diff.
Claude Code vs alternatives, positionnement honnête
Section intitulée « Claude Code vs alternatives, positionnement honnête »Aucun de ces outils n'est mauvais. Ils ont des angles différents qui correspondent à des contextes différents.
| Outil | Forces réelles | Limites réelles | Quand le choisir |
|---|---|---|---|
| Claude Code | Agentique CLI, cycle plan/diff/validate explicite, mode headless industrialisable, CLAUDE.md versionnable | Pas d'autocomplétion inline, courbe d'apprentissage si vous venez de Copilot pur | Vous voulez de la discipline et transposer en CI |
| Cursor | UX intégrée polissée, multi-modèles (Claude, GPT, Gemini), bonne intégration Composer | IDE-only (cocoon), abonnement par utilisateur qui grimpe vite, dépendance à un fork de VS Code | Vous voulez tout-en-un dans un IDE et vous acceptez le lock-in |
| GitHub Copilot | Autocomplétion mature, intégration native VS Code/JetBrains, Copilot Chat correct | Mode agentique encore en retrait (sauf Workspace en preview), pas de cycle plan/diff structuré, modèle moins capable que Claude Opus en raisonnement | Vous voulez accélérer la frappe sans changer vos workflows |
| Aider | Open source, support multi-modèles (OpenAI, Anthropic, Ollama local), commit Git automatique | UX terminal brute, courbe d'apprentissage, moins fluide que Claude Code pour les non-bash users | Vous voulez du CLI agentique open source et la portabilité multi-fournisseurs |
| Cody (Sourcegraph) | Indexation code-search avancée, bon sur les très gros monorepos | Moins agentique que Claude Code, focus historique sur le search assistance | Vous travaillez sur des monorepos massifs avec recherche cross-repo |
Mon choix personnel, assumé, est Claude Code en CLI plus un peu de Copilot pour l'autocomplétion ponctuelle quand je tape vite. Les deux outils ne se font pas concurrence : l'un cadre des sessions, l'autre accélère la frappe.
Sujets avancés à explorer ensuite
Section intitulée « Sujets avancés à explorer ensuite »La phase intermédiaire/avancée prolonge la série débutant. Les guides suivants sont publiés et s'enchaînent dans cet ordre :
| Sujet | Valeur ajoutée | Guide |
|---|---|---|
settings.json avancé | Permissions, env et attribution au niveau projet | Lire |
Rules ciblées (.claude/rules/*.md) | Règles locales par zone (API, tests, infra) | Lire |
Skills (.claude/skills/<nom>/SKILL.md) | Procédures réutilisables invocables par /nom | Lire |
| Hooks | Automatiser ruff + pytest et bloquer les commandes destructives | Lire |
| Workflows concrets | Enchaîner les briques sur debug, refactor, test, doc, PR | Lire |
| Briques Claude Code : quand utiliser quoi | Orientation entre CLAUDE.md, rules, settings, hooks, skills | Lire |
| Dépannage avancé | Diagnostiquer permissions, config, diff et sessions qui dérivent | Lire |
| Serveurs MCP | Étendre Claude vers des ressources hors du dépôt (fetch, GitHub, bases) | Lire |
| Subagents | Isoler le contexte, déléguer exploration, revue ou audit à un agent spécialisé | Lire |
| Mode headless et CI | Piloter Claude en non-interactif : scripts locaux, pré-commit, GitHub Actions | Lire |
La série couvre à présent l'ensemble du parcours CLI. Pour construire un agent hors session, explorez l'Agent SDK d'Anthropic (voir le guide subagents).
Questions fréquentes
Section intitulée « Questions fréquentes »Qu'est-ce que Claude Code exactement ?
Section intitulée « Qu'est-ce que Claude Code exactement ? »Un agent de développement en ligne de commande publié par Anthropic. Vous l'installez via npm, vous le lancez dans un projet, vous lui demandez des modifications, et il les exécute en vous montrant chaque diff pour validation. Pas une autocomplétion, pas un chat, un agent qui agit sur votre filesystem.
Quels modèles Claude utilise-t-il ?
Section intitulée « Quels modèles Claude utilise-t-il ? »À jour 2026 : Opus 4.7 (capacité maximale, idéal pour raisonnement complexe), Sonnet 4.6 (équilibre coût/qualité, défaut pour la plupart des sessions), Haiku 4.5 (rapide et économique pour les opérations courtes). Les versions évoluent, vérifiez la doc Anthropic avant de citer un modèle.
Combien coûte Claude Code ?
Section intitulée « Combien coûte Claude Code ? »Claude Code est gratuit à installer. La facturation se fait à l'usage via votre compte Anthropic (Claude.ai Pro/Max ou Anthropic API). Compter quelques dollars/mois pour un usage personnel régulier, plus pour des sessions intensives. Voir pricing Anthropic pour les tarifs à jour.
Claude Code fonctionne-t-il offline ?
Section intitulée « Claude Code fonctionne-t-il offline ? »Non. Il dépend de l'API Anthropic pour les modèles. Si vous voulez du local, regardez plutôt Aider avec Ollama : au prix d'une qualité de modèle bien moindre que Claude Opus.
Quelle différence avec ChatGPT ou Cursor ?
Section intitulée « Quelle différence avec ChatGPT ou Cursor ? »ChatGPT vit dans un navigateur et ne touche pas à votre code directement. Cursor est un IDE complet (fork de VS Code) qui intègre l'IA. Claude Code est un agent CLI qui s'intègre dans votre terminal existant et votre éditeur existant, vous gardez votre stack actuelle.
Faut-il connaître Bash pour utiliser Claude Code ?
Section intitulée « Faut-il connaître Bash pour utiliser Claude Code ? »Niveau basique suffit. Si vous savez cd, ls, git, vous pouvez démarrer. Pour aller plus loin (hooks, mode headless, CI), un peu plus de Bash aide. Le guide d'installation couvre les bases.
Claude Code remplace-t-il GitHub Copilot ?
Section intitulée « Claude Code remplace-t-il GitHub Copilot ? »Pas nécessairement. Ils servent des usages différents : Copilot accélère la frappe ligne par ligne, Claude Code structure des sessions complètes. Beaucoup d'utilisateurs (moi inclus) les combinent.
Comment l'utiliser en équipe sans dérives ?
Section intitulée « Comment l'utiliser en équipe sans dérives ? »Le CLAUDE.md partagé en racine de projet pose les règles communes. Les hooks imposent les vérifications obligatoires (lint, tests). Le mode headless permet l'industrialisation en CI. Voir le guide briques Claude Code : quand utiliser quoi pour la carte mentale.
À retenir
Section intitulée « À retenir »- Claude Code est un agent CLI, pas une autocomplétion. Cette nature change tout : il explore, planifie, modifie, valide, vous pilotez.
- Le cadre explicite (plan → diff → validation) est ce qui fait passer l'outil de gadget à composant fiable.
- Le parcours CLI-first accélère l'apprentissage et réduit la confusion. La transposition VS Code vient ensuite.
- Le fil rouge
lab-claudeévite la dispersion en gardant un seul terrain de pratique. - Le
CLAUDE.mdminimal et opérationnel bat leCLAUDE.mdexhaustif. Maigre et concret > gros et flou. - Sessions courtes plutôt que mégasessions. Une tâche = une session.
- Mon choix personnel assumé : Claude Code en CLI pour le cadrage + Copilot pour l'accélération. Les deux outils se complètent au lieu de se concurrencer.