Claude Code peut sembler intimidant au premier abord.
Des termes comme Terminal, MCP, hooks, Skills et API arrivent tous en même temps, ce qui rend facile de se perdre dès la première heure.
Dans cet article, je vais organiser Claude Code comme une « leçon où un professeur enseigne à deux élèves de collège. »
À la fin, vous comprendrez l’ordre dans lequel apprendre les opérations de base, les intégrations externes, les Skills, la mémoire, les hooks, le MCP et l’API.
L’image d’en-tête a été générée par l’IA. Le prompt est disponible dans cet article.
Claude Code est une « IA qui agit », pas seulement une « IA qui répond »
Claude Code ne se contente pas de répondre aux questions ; c’est une IA qui effectue des tâches sur votre ordinateur.
Dans la documentation officielle, il est décrit comme un outil de développement de type agent capable de modifier des fichiers, d’exécuter des commandes, de faire des opérations git et de s’intégrer à MCP.
Une fois que vous avez saisi cela, toutes les fonctions se connectent.
Le professeur a écrit ceci au tableau :
« L’IA de chat est un professeur qui donne des conseils. Claude Code est un délégué de classe qui travaille avec vous dans la salle de classe. »
Mina demande :
« Alors, Claude Code est réservé aux personnes qui savent programmer ? »
Le professeur secoue la tête.
« Il est d’abord devenu célèbre en tant qu’outil pour écrire du code. Mais son essence est une IA qui lit les dossiers, corrige les fichiers et exécute des procédures. On peut l’utiliser pour écrire, pour des documents, des pages web, des notes de recherche et la création de supports pédagogiques. »
Ren dit :
« Donc au lieu de dire à ChatGPT “écris une rédaction”, je peux dire à Claude Code “regarde ce dossier, corrige-le et vérifie-le”. »
Exactement.
Pour enseigner Claude Code, ces trois catégories suffisent pour commencer :
- Lire
- Corriger
- Vérifier
Par exemple, si le professeur donne une leçon sur la création d’une page web pour une fête de l’école, il demanderait à Claude Code comme ceci.
Ce qui est important ici, ce n’est pas de demander à l’IA juste une « réponse ». Vous donnez à Claude Code une séquence de tâches.
Table des matières
- Claude Code est une « IA qui agit », pas seulement une « IA qui répond »
- Opérations de base : « Demander, Confirmer, Corriger »
- Mémoire : La note de transmission du professeur
- Skills : Les cartes de techniques spéciales
- Hooks : La sonnerie et l’agent de surveillance
- MCP : Le bus de voyage scolaire
- API et SDK : Comment utiliser Claude Code comme un composant
- Un menu d’entraînement de 30 minutes pour commencer
Opérations de base : « Demander, Confirmer, Corriger »
Les bases de Claude Code impliquent un flux de demande, confirmation et correction.
Plutôt que de mémoriser des commandes difficiles, vous progresserez plus vite en apprenant ce modèle de conversation.
Au début, utilisez-le avec l’idée de « corriger ensemble » plutôt que de « terminer en une seule fois ».
Le professeur a donné le premier modèle aux deux élèves.
Mina dit avec un soulagement :
« J’avais peur que tout change d’un coup. Il suffit de lui faire proposer d’abord. »
Le professeur répond :
« Oui. Il est plus sûr de créer des points de confirmation que de laisser Claude Code travailler tout seul. »
L’utilisation de base comprend ces cinq étapes :
claudepour lancer le dialogueclaude "contenu de la demande"pour passer la demande initialeclaude -p "contenu de la demande"pour une exécution unique non interactive/helppour vérifier les commandes disponibles/statuspour vérifier l’état
Cependant, il n’est pas nécessaire d’enseigner tout aux collégiens dès le début. Dans la première leçon, il suffit d’ouvrir claude et de dire une phrase.
Ren dit :
« Si c’est tout ce qu’il faut dire pour commencer, ce n’est pas effrayant. »
Le professeur continue :
« C’est ça. Vous pouvez utiliser Claude Code tout en lui demandant comment l’utiliser. Si vous ne comprenez pas, demandez-lui comment l’utiliser. »
Le but des opérations de base n’est pas la mémorisation des commandes. C’est que l’humain décide du périmètre de ce qu’il confie à l’IA.
Mémoire : La note de transmission du professeur
La mémoire est un endroit pour écrire les prérequis que vous voulez que Claude Code lise à chaque fois.
Dans la documentation officielle, cela est expliqué comme un système permettant d’utiliser différents fichiers d’instructions pour les utilisateurs ou les projets. En classe, c’est comme une note de transmission entre professeurs.
Le professeur a écrit CLAUDE.md au tableau.
Mina demande :
« Qu’est-ce que c’est ? »
Le professeur répond :
« C’est le règlement de la classe que Claude Code lit avant de commencer le travail. »
Pour un projet de fête de l’école, vous pourriez l’écrire comme ceci.
Ren dit :
« Donc je n’ai pas besoin de le dire à chaque fois. »
Le professeur hoche la tête.
« Exactement. Si vous expliquez la même chose à chaque fois, mettez-la dans la Mémoire. »
Les informations adaptées à la Mémoire incluent :
- Les objectifs du projet
- Les règles de style d’écriture ou de conception
- Les commandes fréquemment utilisées
- Les fichiers à ne pas toucher
À l’inverse, certaines informations ne conviennent pas à la Mémoire :
- Les demandes pour aujourd’hui uniquement
- Les idées non confirmées
- Les mots de passe ou clés API
- Les informations personnelles
Si vous enseignez à un collégien, voici comment le formuler :
« La mémoire n’est pas une magie pour rendre l’IA plus intelligente. C’est un carnet pour les règles que vous ne voulez pas qu’elle oublie à chaque fois. »
Cette explication suffit.
Skills : Les cartes de techniques spéciales
Les Skills sont des procédures de travail fréquemment utilisées, transformées en un format appelable.
Dans la documentation officielle, cela est expliqué comme un système centré sur SKILL.md qui organise les modèles, exemples, scripts et documents de référence. En classe, ce sont comme des cartes de techniques spéciales que l’on sort uniquement en cas de besoin.
Le professeur a dessiné trois cartes :
- Vérification de fiche de lecture
- Création de page pour la fête de l’école
- Création de test de vocabulaire anglais
Mina demande :
« En quoi est-ce différent d’une collection de prompts ? »
Le professeur répond :
« Une collection de prompts est une feuille que vous collez à chaque fois. Les Skills sont des cartes que vous gardez dans la boîte à outils de Claude Code. »
La structure de base d’un Skill est la suivante :
Dans SKILL.md, vous écrivez quand l’utiliser, quoi faire et quoi lire. Claude Code peut utiliser automatiquement un Skill qui correspond à la conversation, ou l’utilisateur peut l’appeler en utilisant /nom-du-skill.
Ren dit :
« Donc je peux transformer les règles de correction que le professeur utilise toujours en un Skill. »
Exactement.
Pour un Skill de fiche de lecture, vous le concevriez comme ceci.
Ce qui est important ici, c’est de ne pas tout transformer en Skill. Pour une demande ponctuelle, il suffit de demander sur le moment.
Les tâches qui devraient être transformées en Skills répondent à ces critères :
- Répétées de nombreuses fois
- Ont une procédure fixe
- Ont des critères de jugement
- Ont des documents de référence ou des modèles
- La qualité a tendance à varier selon la personne
Le professeur a finalement dit :
« Les Skills n’ajoutent pas de talent à l’IA. Ils transforment les procédures humaines en un format réutilisable. »
N’hésitez pas à consulter le site du dictionnaire Claude Code.
Hooks : La sonnerie et l’agent de surveillance
Les hooks sont des mécanismes qui s’exécutent automatiquement avant ou après le travail de Claude Code.
Dans la documentation officielle, ils sont expliqués comme des paramètres permettant d’exécuter des commandes ou des processus en fonction d’événements spécifiques comme PreToolUse ou PostToolUse. En classe, ce sont la sonnerie et l’agent de surveillance.
Mina demande :
« Une sonnerie ? »
Le professeur répond :
« Oui. Elle sonne avant le début du cours. Elle sonne avant la remise. Elle vous arrête si vous essayez d’aller dans un endroit dangereux. C’est ce que font les hooks. »
Par exemple, avant que Claude Code ne réécrive un fichier, il peut effectuer une surveillance comme celle-ci :
- Essaie-t-il de toucher au fichier
.env? - Essaie-t-il de casser des fichiers de configuration importants ?
- Doit-il exécuter des tests après la réécriture ?
- Doit-il formater le texte ?
- Doit-il laisser un journal ?
Les yeux de Ren s’illuminent :
« Donc on peut arrêter l’IA quand elle est sur le point de faire une erreur ! »
Le professeur dit d’un ton un peu sévère :
« Cependant, les hooks sont des outils puissants. Comme ils peuvent exécuter automatiquement des commandes shell, ils sont dangereux si on les ajoute sans comprendre. »
Quand on explique les hooks à des collégiens, il n’est pas nécessaire qu’ils écrivent les paramètres au début. Il suffit d’enseigner les rôles :
Avant le travail : Arrêter les opérations dangereuses. Après le travail : Exécuter des tests ou des vérifications. À la fin : Vérifier les tâches inachevées.
En pratique, introduisez-les dans cet ordre :
- D’abord, vérifier manuellement.
- Si la même vérification apparaît plusieurs fois, en faire une liste de contrôle.
- Une fois la liste de contrôle stable, la transformer en hook.
Ne pas automatiser soudainement. Si vous automatisez une vérification que l’humain ne comprend pas, l’échec sera aussi automatisé.
Le professeur a écrit au tableau :
« Les hooks ne sont pas des robots pratiques ; ce sont des agents de surveillance qui suivent les règles que vous avez établies. »
MCP : Le bus de voyage scolaire
MCP (Model Context Protocol) est un mécanisme permettant de connecter Claude Code à des services et données externes.
Dans la documentation officielle, MCP est expliqué comme un standard ouvert pour connecter les outils d’IA avec des sources de données externes. En classe, c’est le bus de voyage scolaire pour sortir de la salle de classe.
Le professeur a dessiné une image de la classe. À l’extérieur, il a dessiné une bibliothèque, la salle des professeurs, la mairie et un musée.
Ren dit :
« Claude Code peut sortir de la classe ? »
Le professeur répond :
« C’est l’image. Quand vous connectez MCP, Claude Code peut accéder à des informations externes comme GitHub, Sentry, PostgreSQL, Slack, Google Drive et Figma. »
Bien sûr, on ne le laisse pas voir tout librement. Vous décidez du serveur de connexion, de l’authentification et des autorisations.
Dans les paramètres MCP de Claude Code, vous pouvez ajouter des serveurs HTTP ou des serveurs stdio exécutés localement.
Mina dit avec inquiétude :
« Se connecter à l’extérieur fait un peu peur. »
Le professeur répond :
« Ce sentiment est correct. MCP est pratique, mais plus vous vous connectez, plus il peut toucher d’informations. Alors, commencez en lecture seule. »
L’ordre pour enseigner MCP est le suivant :
- D’abord, utiliser uniquement les fichiers locaux.
- Ensuite, se connecter à des données sécurisées en lecture seule.
- Après cela, se connecter à GitHub ou à la gestion de tickets.
- Enfin, envisager l’écriture ou les données de production.
La valeur de MCP n’est pas que l’IA devienne plus intelligente. C’est que l’IA peut aller chercher elle-même les documents dont elle a besoin pour le travail.
Le professeur résume :
« MCP est le bus qui montre le monde extérieur à l’IA. Cependant, c’est le professeur qui décide où il est autorisé à aller. »
API et SDK : Comment utiliser Claude Code comme un composant
L’API (Interface de Programmation Applicative) et le SDK (Kit de Développement Logiciel) sont des moyens d’intégrer Claude Code dans des applications ou des processus automatisés.
Dans la documentation officielle, le SDK Claude Code est expliqué comme un système utilisable depuis CLI, TypeScript et Python. En classe, c’est une façon de faire participer le délégué de classe à un travail en dehors de la classe.
Ren demande :
« Qu’est-ce qu’une API, au juste ? »
Le professeur répond :
« Au lieu qu’un humain parle sur un écran, c’est l’entrée pour demander à Claude Code d’effectuer un travail depuis un programme. »
Par exemple, une utilisation normale ressemble à ceci. C’est un humain qui demande une fois depuis le terminal.
En utilisant le SDK, vous pouvez appeler Claude Code depuis une application ou un traitement par lots. Le SDK Python est fourni sous le nom claude-code-sdk, et un SDK TypeScript est également disponible.
Mina demande :
« Est-ce quelque chose que les débutants devraient faire en premier ? »
Le professeur répond :
« Non. Ce n’est pas quelque chose à faire en premier. »
Les API et SDK sont utilisés aux stades suivants :
- Quand vous voulez exécuter automatiquement la même tâche chaque jour.
- Quand vous voulez assister aux révisions ou aux tests dans CI.
- Quand vous voulez appeler Claude Code depuis des outils internes.
- Quand vous voulez exécuter plusieurs processus en parallèle.
- Quand vous voulez recevoir les résultats en JSON.
Pour les collégiens, c’est comme ceci :
« Demander au délégué de classe à la main est la base de Claude Code. Envoyer des requêtes automatiquement depuis la salle de diffusion, c’est l’API et le SDK. »
C’est pratique, mais l’utiliser dès le début crée de la confusion. L’ordre est : Les bases, la Mémoire, les Skills, MCP, les hooks, puis l’API.
Un menu d’entraînement de 30 minutes pour commencer
Vous n’avez pas besoin d’apprendre tout Claude Code d’un coup.
Si vous réduisez ce que vous devez faire dans les 30 premières minutes, la peur disparaît. Lorsque vous enseignez à des collégiens, créez d’abord de petites expériences de réussite.
Le professeur a finalement présenté un menu de leçon de 30 minutes.
Mina dit :
« Je pense pouvoir le faire en cours ! »
Ren dit :
« Donc MCP et les hooks peuvent venir plus tard. »
Le professeur répond :
« Oui. L’ordre est important. Si vous allez directement à l’intégration externe ou à l’exécution automatique, vous ne saurez pas ce qui se passe. »
Les trois premiers objectifs sont :
- Faire expliquer un dossier par Claude Code.
- Lui faire corriger un petit fichier.
- Lui faire expliquer la raison de la correction.
Si vous pouvez faire cela, vous avez saisi l’essence de Claude Code. Ensuite, progressez selon vos besoins :
- Si vous avez la flemme d’expliquer la même chose à chaque fois : La Mémoire.
- Si vous faites la même tâche à chaque fois : Les Skills.
- Si vous voulez montrer des documents externes : MCP.
- Si vous voulez automatiser les vérifications : Les hooks.
- Si vous voulez l’intégrer dans un système : L’API et le SDK.
Claude Code n’est pas un outil pour mémoriser des fonctions. C’est un outil pour développer la façon dont vous déléguez le travail.
Le professeur a finalement dit :
« Les personnes qui savent utiliser l’IA ne sont pas des experts de l’IA. Ce sont des personnes capables de diviser le travail, de transmettre les règles et d’effectuer des vérifications. »
C’est la conclusion la plus importante lorsqu’on enseigne Claude Code à des collégiens.
Articles connexes
[Débutants acceptés] Accompagnement individuel Claude Code
*Les places early-bird pour les 10 premiers sont épuisées.
Modèles de conception Claude Code
~Structure des dossiers, Skills, base de données, et flux de génération de contenu entièrement révélés~
Demandes de renseignements, consultations individuelles et formations en entreprise :
