Claude Code est un agent de développement orienté exécution réelle : exploration de codebase, planification, modifications et validations. Cette page pivot vous donne une carte claire pour progresser sans dispersion avec une approche CLI-first sur un fil rouge unique : ~/Projets/lab-claude. Vous allez apprendre à cadrer vos sessions, poser vos règles persistantes dans CLAUDE.md, relire vos diffs, exécuter vos validations techniques, puis transposer les mêmes réflexes dans VS Code.
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
Dans quel contexte ?
Section intitulée « Dans quel contexte ? »Vous avez commencé à utiliser des agents IA pour coder, mais les sessions deviennent vite longues, floues, difficiles à relire et parfois non vérifiées. C'est exactement le problème que cette série résout : installer une méthode reproductible avant de chercher la vitesse.
Situations réelles où ce parcours est utile :
- Vous voulez éviter les changements larges et non relus
- Vous devez livrer des modifications traçables avec diff et tests
- Vous avez besoin d'un cadre d'équipe avec des règles persistantes
- Vous voulez passer du terminal à l'IDE sans perdre la discipline
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
Par où commencer ?
Section intitulée « Par où commencer ? » Installation CLI Installer Claude Code et vérifier l'environnement
Projet fil rouge lab-claude Créer le dépôt commun de pratique
Prise en main CLI Commandes, raccourcis et configuration de base
Prompting de base CLI Passer d'une demande vague à une demande testable
Workflow réel CLI Exécuter une tâche complète en mode contrôlé
Erreurs et recadrage Corriger rapidement les dérives de session
Configurer CLAUDE.md Poser des règles persistantes concrètes
Mode plan, diff et validations Sécuriser chaque exécution avant acceptation
Claude Code dans VS Code Appliquer la même méthode dans l'éditeur
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 |
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 |
Et après : sujets avancés à explorer ensuite
Section intitulée « Et après : 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).
A retenir
Section intitulée « A retenir »- Claude Code est vraiment utile quand le cadre est explicite
- Le parcours CLI-first accélère l'apprentissage et réduit la confusion
- Le fil rouge
lab-claudeévite la dispersion - Le triptyque plan, diff, validation est votre filet de sécurité
- Les mêmes réflexes se transposent ensuite dans VS Code
Prochaines étapes
Section intitulée « Prochaines étapes » Installer Claude Code CLI Mettre en place l'environnement local
Créer le projet fil rouge lab-claude Poser la base de pratique commune
Prise en main CLI Maîtriser commandes, raccourcis et settings.json
Prompting de base CLI Transformer une demande vague en prompt borné
Premier workflow réel CLI Dérouler exploration, plan, exécution et validation
Configurer CLAUDE.md Installer des garde-fous persistants dès le deuxième projet
Mode plan, diff et validations Sécuriser l'exécution de chaque tâche
Erreurs courantes et recadrage Reprendre le contrôle quand une session dérive
settings.json avancé Partager permissions, env et attribution au niveau projet
Rules ciblées par dossier Sortir les règles spécifiques de CLAUDE.md avec .claude/rules/
Skills Claude Code Transformer les procédures répétitives en routines invocables par /nom
Hooks Claude Code Automatiser lint, tests et garde-fous autour des événements
Workflows concrets Enchaîner rules, skills et hooks sur debug, refactor, test, doc, PR
Briques Claude Code : quand utiliser quoi Choisir entre CLAUDE.md, rules, settings, hooks, skills sans doublons
Dépannage avancé Claude Code Diagnostiquer permissions, config, diff et sessions qui dérivent
Serveurs MCP Étendre Claude vers des ressources hors du dépôt (fetch, GitHub, bases locales)
Subagents Claude Code Isoler le contexte et déléguer exploration, revue ou audit à un agent spécialisé
Mode headless et CI Piloter Claude en non-interactif : scripts locaux, pré-commit, GitHub Actions
Claude Code dans VS Code Transposer la méthode CLI dans l'éditeur