Claude Code 101 :
Obtenez le diplôme officiel
pour être embauché !
De zéro à expert : agent IA, boucle agentique, gestion du contexte, architecture multi-agents et hooks déterministes — tout ce qu’il faut pour passer l’examen officiel Claude Code 101.
🤖Agent IA vs Chatbot classique — Quelle différence ?
Avant de plonger dans Claude Code, il faut comprendre ce qui distingue fondamentalement un agent IA d’un chatbot ordinaire. C’est la première révélation de cette formation — et elle change tout.
💬 Chatbot classique
- Reçoit un prompt
- Calcule des probabilités de mots
- Retourne une réponse
- Aucune vérification des résultats
- Pas de prise de décision réelle
🧠 Agent IA (Claude Code)
- Collecte de l’information contextuelle
- Pose des questions à l’utilisateur
- Prend des décisions actives
- Vérifie ses propres résultats
- Exécute des boucles d’action
Un agent IA est conçu pour prendre des décisions. Pour cela, il doit pouvoir collecter de l’information (RAG, recherche internet, fichiers, images), interrompre l’utilisateur pour poser des questions, prendre des mesures concrètes et vérifier si les résultats correspondent aux critères définis.
⚠️ La limite de l’agent IA : si l’action et la collecte d’information sont bien maîtrisées par les modèles actuels, la vérification des résultats reste votre responsabilité. Une IA ne sait pas à l’avance si une information est juste ou fausse. Elle n’a comme référence que ses données d’entraînement. C’est vous qui devez coder les méthodes de vérification pour que le modèle exécute un vrai travail.
« La conception du système agentique, c’est être capable de construire chacun des blocs pour faire exécuter du travail. Ce n’est pas simplement demander un prompt magique. »
🧩 Les 3 piliers à coder pour chaque tâche
La sélection des données contextuelles
Quel type de data le modèle doit-il utiliser ? RAG, fichiers, web, images ? Le contexte pertinent n’est pas le nom de votre entreprise ni votre SIRET — c’est le type de résultat que vous voulez obtenir.
Le type d’action à prendre
Comment le modèle va-t-il organiser la data ? Quelles décisions doit-il prendre ? Ces instructions doivent être codées précisément, pas juste évoquées dans un prompt.
La matrice de vérification
Comment le modèle sait-il que ce qu’il a produit est correct ? Faut-il relancer une boucle ou valider ? Sans ce mécanisme, vous obtenez des tokens sans fond, pas un travail réel.
🔄La boucle agentique — Le cœur du système
La boucle agentique est le mécanisme fondamental qui distingue Claude Code d’un simple assistant. Comprendre son fonctionnement, c’est comprendre pourquoi les « prompts magiques » des influenceurs sont une absurdité.
1. Entrée
Votre prompt est envoyé. Le modèle extrait les éléments contextuels pertinents selon ce que vous lui avez défini.
2. Décision
Que faire de cette data ? Comment l’organiser ? De quoi a-t-il besoin ? Ce ne sont plus de simples probabilités, mais des décisions orientées.
3. Action
Exécution selon les outils autorisés. Connexion internet, lancement de code, lecture de fichiers… le modèle sait quand agir.
4. Vérification
Le modèle contrôle si les résultats répondent aux critères définis. Si non : relance de boucle. Si oui : validation et sortie.
Le mode Advisor : Claude Code dispose d’un système supervisé unique où
un modèle chapote un autre modèle. Haiku est supervisé par Sonnet (et réciproquement).
Quand un modèle se bloque, l’autre propose des solutions via la fonction tool_advisor —
créant un ping-pong de raisonnement qui évite l’effondrement.
💻Terminal vs Desktop — Pourquoi le terminal gagne
Pourquoi utiliser la version terminal de Claude Code plutôt que l’interface desktop ou web ? La réponse est simple : c’est la seule interface qui offre un contrôle total sur le système agentique.
- Dernières fonctionnalités en premier : les nouveautés sont déployées sur le CLI avant les autres interfaces.
- Systèmes agentiques avancés : accès aux configurations d’orchestrateurs, de sous-agents et de hooks.
- Édition précise des séquences : quand le modèle ne trouve pas de solution, vous pouvez coder exactement les instructions manquantes.
- Mode plan intégré : basculez instantanément entre Haiku (exécution légère) et Sonnet (planification puissante) avec
Maj+Tab. - Contrôle des permissions : choisissez précisément ce que le modèle peut ou ne peut pas faire sur votre système.
- Visualisation du contexte : la commande
/contextvous montre exactement comment votre mémoire est occupée.
⚙️ Les 3 modes de permission
| Mode | Raccourci | Comportement | Conseil |
|---|---|---|---|
| Standard (défaut) | plan accept default | Demande confirmation avant de modifier/créer/effacer | ✓ Recommandé |
| Accept Edit | Maj+Tab ×1 | Accepte automatiquement les modifications pour la session | ⚠️ Avec précaution |
| Plan Mode | Maj+Tab ×2 | Bascule en Sonnet pour planifier sans exécuter | ✓ Avant tout projet |
| Bypass Permission | Maj+Tab ×3 | Auto-accept total — aucune confirmation | ✗ Risqué |
Danger du mode auto-accept : le modèle peut accéder à votre Slack, Gmail, Jira, vos CRM, vos clés API… et dans le pire cas effacer des fichiers critiques. Cadrez toujours les permissions avant de lancer une session.
🎯 Le workflow optimal : Explorer → Planifier → Coder → Valider
Ce cycle en 4 phases est la colonne vertébrale d’un travail professionnel avec Claude Code.
Commencez toujours par activer le plan mode pour explorer et planifier
avant d’exécuter. Ajustez le niveau d’effort (effort=medium ou effort=high)
selon la complexité du raisonnement requis.
🧠Gestion du contexte — Les 200 000 tokens
La fenêtre contextuelle est votre ressource la plus précieuse — et la plus mal gérée. Comprendre comment elle se remplit est indispensable pour travailler efficacement.
La fenêtre contextuelle de Claude : limitée à 200 000 tokens en plan standard. Au-delà, vous basculez sur la version 1 million de tokens — 3 fois plus chère, disponible uniquement sur les plans Max. Travailler dans une zone optimisée n’est pas un luxe, c’est une nécessité.
📊 Ce qui occupe votre contexte (visualisation /context)
Étude Chroma : au-delà d’un certain seuil de tokens, on observe une perte de qualité de compréhension du contexte. Cette dégradation s’accentue avec le nombre de questions posées, la qualité des prompts et la présence de « distracteurs » (informations parasites) dans vos documents.
« 10 serveurs MCP, c’est 800 tokens de fenêtre contextuelle. Vous comprenez ce qui va se passer : le MCP est l’un des plus gros consommateurs d’espace mémoire. »
🧹Clear vs Compact — Les deux commandes essentielles
Savoir quand utiliser /clear et quand utiliser /compact est
l’une des compétences les plus sous-estimées — et les plus impactantes — de Claude Code.
🗑️ /clear — Effacement total
- Supprime tout le contexte
- Recharge toutes les données
- Coût : repaie tous les tokens
- Repart de zéro
- Aucune compression
🗜️ /compact — Compression intelligente
- Compresse l’historique en mémoire
- Conserve la cohérence
- 15–22% alloué à la zone compacte
- Économise le rechargement
- Personnalisable avec options
🎯 Quand utiliser lequel ?
| Situation | Commande | Pourquoi |
|---|---|---|
| Hallucinations, comportement erratique | /clear | Nettoyer le cache pollué |
| Session longue mais cohérente | /compact | Préserver la cohérence, gagner de l’espace |
| Résultats aléatoires inexpliqués | /clear | Repartir proprement |
| Contexte proche de la saturation | /compact | Libérer ~30% de tokens |
| Nouveau projet dans la même session | /clear | Isolation propre des contextes |
Astuce pro : après un /compact, il reste en réalité ~150 000 tokens
utiles (prompt système + outils + 20% mémoire). Certains experts désactivent l’auto-compact
et gèrent manuellement en échangeant des fichiers memory — gagnant ainsi 20% de zone de travail.
📄Le fichier CLAUDE.md — Le vrai système prompt
Oubliez les « prompts parfaits » des influenceurs YouTube. Un vrai fichier CLAUDE.md ne ressemble pas à ce que vous imaginez. C’est compact, précis, et strictement technique.
❌ Mauvais CLAUDE.md
- « Tu es un expert avec 15 ans d’XP »
- « Tu sais tout sur le marketing digital »
- « Tu vas m’aider à gagner 10 000€/mois »
- 30 pages de contexte
- Descriptions floues du rôle
✅ Bon CLAUDE.md
- « Projet NextJS, router Tailwind »
- Commandes autorisées listées
- Règles de protection des fichiers
- Max 200 lignes (500 absolus)
- Renvois vers fichiers secondaires
# CLAUDE.md — Exemple de fichier racine ## Projet Application NextJS 14, App Router, Tailwind CSS 3.4 ## Commandes autorisées npm run dev # démarrer le serveur npm run test # lancer les tests npm run lint # vérifier le code ## Fichiers protégés Ne jamais modifier : .env, /config/secrets.ts ## En cas d'ambiguïté Demander confirmation avant toute action destructive ## Documentation détaillée → /agents/orchestrator.md pour l'architecture multi-agents
Pourquoi si court ? Les fichiers CLAUDE.md sont lus intégralement à chaque démarrage de conversation — ils consomment votre contexte précieux. Plus c’est compact, mieux l’IA fonctionne. La documentation détaillée va dans des fichiers secondaires référencés par renvois, exactement comme des post-its : « Va lire tel document pour telle situation. »
🏗️Architecture multi-agents — Diviser pour régner
C’est la grande rupture de 2026 : fini l’agent unique qui fait tout. L’avenir, c’est l’hyperspécialisation — une armée de mini-Claude, chacun expert dans son domaine, coordonnés par un orchestrateur.
L’Orchestrateur
Le « header » qui coordonne les autres agents. Il leur délègue des tâches et récupère leurs résultats sans polluer son propre contexte.
Les Sous-Agents
Des mini-Claude spécialisés : outils autorisés spécifiques, restrictions précises, fenêtre contextuelle indépendante. Identifiables par leur fichier .md.
Les Fichiers de Routage
Chaque agent expose ses schémas d’entrée/sortie. L’orchestrateur sait quoi envoyer et quoi récupérer de chacun.
La Mémoire Partagée
Un agent centralise l’écriture, tous peuvent lire. Ou chaque partie du projet a sa propre mémoire. Architecture flexible.
# Structure d'un agent spécialisé (agent/aggregator.md) name: Aggregator version: 1.0 description: Agrège les données des sources externes model: claude-haiku-4-5 max_turns: 12 effort: low tools_allowed: - web_search - file_read - mcp_notion tools_forbidden: - file_delete - bash_execute input_schema: { query: string, sources: string[] } output_schema: { results: object[], summary: string }
L’intérêt clé : quand un agent travaille dans sa fenêtre contextuelle séparée, votre contexte principal ne grossit pas. Vous récupérez seulement le résultat final. Cela résout le problème n°1 des systèmes agentiques : la saturation du contexte. Et en prime, ça isole les injections de prompts et les comportements désalignés.
Identifiez vos domaines d’hyperspécialisation
Recherche web, analyse de données, génération de code, rédaction, vérification de qualité… Chaque domaine = un agent potentiel.
Créez le fichier .md de chaque agent
Outils autorisés/interdits, schéma d’entrée/sortie, modèle, nombre de tours max, niveau d’effort.
Architecturez l’orchestrateur
Il gère la coordination, appelle les agents en séquence ou en parallèle, et réinjecte les résultats dans la conversation principale.
Définissez les fichiers de mémoire persistante
Architecturez les échanges selon comment les agents communiquent entre eux. Un agent centralisé en écriture, tous en lecture.
🔒Les Hooks — Contrôle déterministe à 100 %
Le fichier CLAUDE.md est basé sur la reconnaissance sémantique — des mots que le modèle interprète. Les hooks, c’est tout le contraire : ce sont des instructions code qui s’exécutent de manière déterministe, sans probabilité.
26 déclencheurs disponibles : avant/après l’utilisation d’un outil, au nom d’une commande, avant/après un résultat… Chaque déclencheur peut lancer un script JavaScript qui bloque, active ou conditionne le comportement du modèle.
// settings.json — Exemple de hook de sécurité { "hooks": { "PreToolUse": [ { "matcher": "bash", "hooks": [ { "type": "command", "command": "node /hooks/check-dangerous-commands.js" } ] } ] } }
🎯 Quand utiliser les hooks ?
- Fichiers critiques : bloquer toute tentative de modification des fichiers
.env, des clés API ou des configurations sensibles. - Commandes destructives : intercepter « efface tous les fichiers », « lis les clés API de mon répertoire » avant exécution.
- Les 5% de désalignement : quand le modèle ne suit pas les instructions sémantiques, le hook impose le comportement en code pur.
- Contrôle qualité automatique : vérifier qu’un fichier généré respecte bien les standards avant de le sauvegarder.
Ne pas en abuser : les hooks ne sont pas à utiliser tout le temps. Réservez-les pour les cas où vous avez des fichiers critiques à protéger ou des comportements déterministes absolument nécessaires. Trop de hooks = complexité inutile.
🗂️Memory vs Skills — Chargement intelligent
Comprendre la différence entre les fichiers Memory et les Skills est essentiel pour optimiser votre fenêtre contextuelle. Ces deux systèmes fonctionnent selon des logiques radicalement différentes.
📁 Memory Files
- Chargés intégralement au démarrage
- Toujours présents dans le contexte
- Système cumulatif (plusieurs memory)
- Consomme beaucoup de tokens
- Idéal pour les données permanentes
🧩 Skill Files
- Seuls les 200 premiers caractères chargés
- Contenu complet chargé si conditions remplies
- Chargement progressif et conditionnel
- Impact minimal sur le contexte
- Idéal pour les compétences spécialisées
La règle d’or : utilisez les Memory pour ce que le modèle doit toujours savoir (architecture du projet, règles fondamentales). Utilisez les Skills pour ce qu’il doit savoir seulement dans certaines conditions (comment générer un rapport PDF, comment interagir avec une API spécifique). Plus vos Skills sont petits, plus votre contexte utile est grand.
# Structure recommandée d'un répertoire agent project/ ├── CLAUDE.md # Système prompt racine (max 200 lignes) ├── agents/ │ ├── orchestrator.md # Agent coordinateur │ ├── researcher.md # Agent recherche web │ └── coder.md # Agent génération de code ├── memory/ │ ├── project-state.md # État du projet (toujours chargé) │ └── decisions.md # Décisions prises (toujours chargé) └── skills/ ├── generate-pdf.md # Chargé si besoin PDF ├── api-stripe.md # Chargé si besoin Stripe └── deploy-vercel.md # Chargé si déploiement
🎓Passer l’examen Claude Code 101
Vous avez maintenant toutes les informations pour passer l’examen officiel Claude Code 101 de l’Anthropic Academy. Voici ce que vous devez maîtriser pour réussir :
La boucle agentique
Comprendre les 4 phases : extraction de contexte, décision, action, vérification. Savoir pourquoi les « prompts magiques » ne fonctionnent pas.
Gestion du contexte
Maîtriser /clear vs /compact, comprendre la fenêtre 200k tokens, savoir visualiser l’occupation avec /context.
CLAUDE.md efficace
Rédiger un système prompt compact et fonctionnel. Utiliser les renvois vers fichiers secondaires. Maximum 200 lignes.
Architecture multi-agents
Créer des sous-agents spécialisés avec outils autorisés/interdits. Architecturer l’orchestrateur. Définir les schémas d’échange.
Hooks de sécurité
Configurer des déclencheurs déterministes dans settings.json. Savoir quand les utiliser (protection fichiers critiques, désalignement).
Memory vs Skills
Distinguer les fichiers à chargement permanent des fichiers à chargement progressif. Optimiser l’occupation du contexte.
🏅 Prêt à passer l’examen officiel ?
Rendez-vous sur l’Anthropic Academy pour passer le test Claude Code 101 et obtenir votre certification officielle à ajouter sur votre CV.
🎓 Accéder à l’Anthropic Academy →🎬Regarder la masterclass complète
Toutes les démonstrations en direct, les captures d’écran du terminal, les configurations en temps réel et les exemples concrets sont dans la vidéo originale :

- 0:00 🎯 Introduction — Pourquoi Claude Code est la compétence n°1 en 2026
- 2:30 🤖 Agent IA vs Chatbot classique — Comprendre la différence fondamentale
- 5:00 🔄 La boucle agentique — Contexte, décision, action, vérification
- 8:30 💻 Terminal vs Desktop — Pourquoi le CLI est l’interface ultime
- 12:00 🧠 Gestion du contexte — Les 200 000 tokens et la commande /context
- 16:00 🧹 /clear vs /compact — La décision qui optimise vos coûts
- 20:00 📄 Le fichier CLAUDE.md — Le vrai système prompt vs les prompts magiques
- 24:00 🏗️ Architecture multi-agents — Orchestrateur, sous-agents et mémoire persistante
- 28:00 🔒 Les Hooks — Contrôle déterministe et sécurité avancée
- 32:00 🗂️ Memory vs Skills — Chargement progressif et optimisation du contexte
- 36:00 🎓 Passer l’examen Claude Code 101 — Anthropic Academy
