Glossaire (accessible aux débutants) : traduire le jargon technique en termes simples
📚 Navigation de la série : Le chapitre précédent 51 Résolution des problèmes courants (FAQ / Troubleshooting) a listé les erreurs et dysfonctionnements les plus fréquents. Ce chapitre aborde un aspect fondamental — traduire un à un les termes techniques rencontrés tout au long du tutoriel en termes simples. Cycle d'agent (agentic loop), fenêtre de contexte (context window), MCP, subagent, skill, hook, checkpoint, modes de permissions, headless, transport... Après plus de cinquante chapitres, de nombreux termes se sont accumulés ; ce chapitre fait office de fiche de consultation rapide pour dissiper vos doutes.
On conseille souvent de lire un glossaire de bout en bout pour acquérir des bases. Disons-le franchement : c'est l'approche la moins efficace.
Apprendre un outil en mémorisant un glossaire de A à Z est inutile — vous oublierez tout rapidement, car ces notions ne correspondent alors à aucune expérience pratique. Un terme technique ne s'assimile réellement que lorsque vous y êtes confronté en situation réelle.
Ce chapitre n'est donc pas conçu pour être « lu » linéairement, mais pour être « consulté ». C'est une fiche de référence, pas un cours. Poursuivez votre apprentissage et votre pratique ; le jour où vous butez sur une notion comme « qu'est-ce que le transport » ou « à quoi sert l'auto-compact », revenez ici, lisez la description d'une phrase accompagnée de son analogie, et reprenez votre travail — c'est le meilleur usage que vous puissiez en faire.
Analogie : La liste des matériaux affichée sur un chantier. Aucun artisan ne s'amuse à mémoriser cette liste par cœur. En revanche, à la livraison d'un tuyau ou d'une plaque, il la consulte rapidement — « d'accord, c'est la poutre porteuse, et ça le raccord de plomberie », puis reprend sa tâche. Ce tableau fonctionne de la même manière : il n'est pas fait pour être lu en entier, mais pour y retrouver une notion face à un cas concret. J'ai regroupé les notions par thématiques (les concepts associés étant plus faciles à mémoriser ensemble qu'un classement alphabétique), sous la forme d'un triptyque « concept → description en une phrase → analogie ».
À la fin de ce chapitre (ou lors de vos consultations ultérieures), vous disposerez de :
- L'ensemble des termes techniques clés du tutoriel explicités simplement et illustrés par des analogies
- Un regroupement thématique facilitant la mémorisation et la compréhension des relations entre concepts
- Des références renvoyant aux chapitres correspondants pour approfondir chaque notion
- Un comparatif des concepts proches souvent confondus pour lever toute ambiguïté
- Un exercice pratique pour utiliser le serveur de documentation officiel et interroger Claude sur les définitions en temps réel
01 Le cycle d'agent (Agentic loop) : le moteur d'exécution de Claude
Cette thématique constitue le socle fondamental. Elle répond à une question essentielle : en quoi Claude Code diffère-t-il d'un agent conversationnel classique, et comment peut-il agir de manière autonome. Tous les autres concepts découlent de ce cycle d'exécution.
Analogie : Une chaîne de production automatisée. Un IA de chat classique fonctionne sur le modèle « question-réponse », à la manière d'un guichet de prise de commande. Claude Code est une chaîne de production autonome — face à une tâche, il rassemble les ressources, procède à l'implémentation, valide la qualité et réitère le cycle si nécessaire. Les concepts suivants décrivent les composants de cette chaîne.
Agentic loop（代理循环）
En bref : Le cycle récurrent exécuté par Claude pour traiter une tâche — collecte du contexte → action → validation du résultat → itération si nécessaire, jusqu'à finalisation.
Analogie : Le geste du cuisinier. Il ne se contente pas de verser tous les ingrédients dans la casserole d'un coup, il procède par étapes : « ajouter les ingrédients → mélanger → goûter → rectifier l'assaisonnement », itérant jusqu'à obtenir le plat parfait. Chaque dégustation (le retour d'un outil) oriente l'étape suivante. Vous gardez le contrôle pour interrompre ou réorienter à tout moment (voir chapitre 03).
Agentic coding（代理式编程）
En bref : Une méthode de travail où l'IA accède de manière autonome aux fichiers, lance des commandes et modifie le code sous votre supervision (avec la possibilité d'intervenir ou de la laisser travailler en autonomie), par opposition à un modèle qui génère du texte que vous devez copier-coller manuellement.
Analogie : Collaborer avec un artisan plutôt que de lire un manuel. Un manuel décrit la marche à suivre, l'artisan réalise le travail pour vous. Claude Code s'inscrit dans cette seconde catégorie grâce aux outils dont il dispose (voir chapitre 01).
Agentic harness（代理外壳）
En bref : L'ensemble des composants logiciels entourant le modèle de langage pour en faire un agent d'exécution — accès aux fichiers, exécution shell, gestion des permissions, chargement de l'historique et orchestrateur de cycles. Claude Code est le harnais (le véhicule), Claude est le modèle sous-jacent (le moteur).
Analogie : Le moteur et le châssis d'un véhicule. Le même moteur (modèle de langage) installé dans des châssis différents produira des expériences de conduite très distinctes. Le harnais est le châssis de Claude Code, définissant ses capacités d'accès et ses règles d'action (voir chapitre 03).
Tool（工具）
En bref : Les actions exécutables par Claude — lecture de fichiers, édition de code, commandes shell, requêtes web ou délégation à un subagent ; sans outils, il se limiterait à générer du texte.
Analogie : Les outils d'un poste de travail. Disposer de connaissances ne suffit pas, il faut des bras robotisés, des convoyeurs et des capteurs pour matérialiser le travail. Les outils sont les mains de Claude, chaque exécution retournant un résultat qui oriente la suite de son cycle (voir chapitre 03).
Turn（回合）
En bref : L'échange complet démarrant avec votre consigne et se terminant lorsque Claude a finalisé sa réponse ; ce cycle peut comporter de multiples appels d'outils en arrière-plan.
Analogie : La commande et le service du plat. Votre consigne est la commande. Le travail de préparation en cuisine (appels d'outils) se déroule en arrière-plan, et la livraison du plat finalise le tour de parole. Une session se compose d'une suite de tours de parole (voir chapitre 03).
Verification loop（验证循环）
En bref : Le processus permettant de garantir que la tâche est réellement finalisée et non simplement plausible — en lui fournissant une vérification exécutable (tests, builds ou comparaisons visuelles), il itère ses corrections jusqu'à réussite.
Analogie : Autocorriger ses exercices. Sans barème ou solutions, on estime avoir fini de manière subjective. Lui fournir un moyen de validation lui permet d'itérer jusqu'à obtenir le résultat correct plutôt que de livrer le premier jet. C'est un élément crucial pour l'exécution autonome (voir chapitre 49).
Extended thinking（扩展思考）
En bref : Le processus de raisonnement visible du modèle précédant sa réponse, affiché en italique gris dans la console ; sa longueur peut être configurée avec MAX_THINKING_TOKENS ou via le niveau d'effort (effort level).
Analogie : Élaborer un brouillon de résolution. Plutôt que de répondre d'emblée, le modèle formalise son cheminement pas à pas, ce qui vous permet de suivre sa logique et d'identifier l'étape d'une éventuelle déviation (voir chapitre 35).
Effort level（努力级别）
En bref : Un paramètre définissant le budget de raisonnement alloué à chaque tour de parole — un niveau élevé permet une analyse approfondie mais s'avère plus lent et plus coûteux, tandis qu'un niveau bas privilégie la rapidité et l'économie.
Analogie : Le temps alloué à chaque question lors d'un examen. Répondre rapidement à un QCM simple (bas effort) ou consacrer dix minutes à un problème complexe (haut effort). Réduisez le niveau pour les tâches simples pour économiser vos crédits, élevez-le pour les tâches d'envergure (voir chapitre 35).
💡 En résumé : Cette thématique décrit le fonctionnement de Claude en tant qu'agent — le cycle d'agent (« concevoir → agir → vérifier ») en est le moteur, les outils sont ses mains, le harnais est le châssis de l'application, le raisonnement étendu est son brouillon de calcul, le niveau d'effort définit le temps consacré et la boucle de validation fait office de contrôle qualité.
02 Contexte : la capacité de mémoire et l'espace de travail de Claude
Après le cycle d'exécution vient la gestion de la mémoire — Claude ne dispose pas d'une mémoire infinie. Ces concepts décrivent sa capacité de rétention, les mécanismes de saturation et les outils de réinitialisation. C'est ici que se trouvent les réponses aux oublis de consignes en cours de session.
Analogie : Un plan de travail aux dimensions limitées. Si vous dessinez sur une table, l'espace disponible finit par manquer à mesure que vous y accumulez plans, documentations et brouillons ; vous devez alors faire du tri. La mémoire de Claude is ce plan de travail, les notions suivantes décrivant sa gestion.
Context window（上下文窗口）
En bref : La mémoire de travail de la session active — elle contient l'historique des échanges, le contenu des fichiers ouverts, les retours de commandes, CLAUDE.md, les skills chargés et les instructions système. Sa taille est limitée.
Analogie : La surface du plan de travail. Plus elle est grande, plus vous pouvez y consulter de documents simultanément ; une fois pleine, l'arrivée d'une nouvelle pièce exige d'en retirer une ancienne. Lancez /context pour analyser l'occupation de cet espace (voir chapitre 19).
Token
En bref : L'unité lexicale de traitement de texte des modèles — équivalant à une syllabe ou une fraction de mot ; la taille de la fenêtre de contexte et la facturation sont indexées sur le nombre de tokens.
Analogie : Le poids des données. Les transporteurs facturent au poids, les modèles de langage comptabilisent l'usage en tokens — le volume de texte fourni en entrée et généré en sortie est converti en tokens pour évaluer l'occupation du contexte et la facturation (les aspects techniques des tokens relevant du fonctionnement des LLM ne sont pas détaillés ici).
Compaction（压缩）
En bref : Le processus de synthèse des échanges lorsque la fenêtre de contexte approche de la saturation, consistant à nettoyer les retours d'outils obsolètes puis à résumer la conversation ; peut être déclenché manuellement avec /compact.
Analogie : Synthétiser ses brouillons. Pour libérer de l'espace, vous notez les conclusions importantes sur une feuille unique et archivez le reste — l'essentiel est conservé dans un volume réduit. Note : le fichier CLAUDE.md et la mémoire automatique (auto memory) sont préservés lors de la compression, seuls les détails des échanges informels du chat risquent d'être résumés ou omis (voir chapitre 19).
Auto-compact（自动压缩）
En bref : La compression du contexte déclenchée automatiquement par le système lorsque la limite de la fenêtre est presque atteinte.
Analogie : Le trop-plein automatique d'un réservoir. Lorsque le niveau approche de la limite, une vanne s'ouvre pour évacuer le surplus sans intervention de votre part. C'est le même processus que le /compact manuel, seule l'initiative du déclenchement différant (voir chapitre 19).
Session（会话）
En bref : La conversation active associée à votre dossier de travail, disposant de sa propre fenêtre de contexte ; /clear permet d'ouvrir une session vierge, et les anciennes sessions restent accessibles via /resume.
Analogie : Faire table rase avant d'entamer un nouveau projet. Conserver les brouillons de la tâche précédente encombre l'esprit ; vider le bureau (ouvrir une nouvelle session) permet de travailler proprement. L'historique des sessions étant conservé dans ~/.claude/projects/, vous pouvez y revenir avec claude -c même après avoir fermé votre terminal (voir chapitre 19).
CLAUDE.md
En bref : Le guide d'accueil permanent rédigé à l'attention de Claude, chargé automatiquement au démarrage de chaque session, contenant les règles constantes (conventions du projet, commandes de build, contraintes strictes).
Analogie : Le livret d'accueil du nouveau collaborateur. Le collaborateur temporaire démarre chaque journée sans antériorité, mais la feuille de consignes affichée à son poste lui permet de prendre connaissance des règles du lieu dès son arrivée. Conservez ce fichier sous la barre des 200 lignes, et déplacez les détails dans un Skill (voir chapitre 18).
Auto memory（自动记忆）
En bref : Les notes personnelles rédigées par Claude à son propre usage, basées sur vos corrections et préférences, enregistrées sous forme de dépôt git dans ~/.claude/projects/ et chargées partiellement au début de chaque session.
Analogie : Les notes personnelles sur un post-it. CLAUDE.md contient les règles que vous lui imposez, l'auto memory regroupe ses propres notes de rappel — comme « la dernière fois, il m'a demandé de ne pas utiliser npm » pour éviter de répéter l'erreur. Ces deux outils sont complémentaires (voir chapitre 25).
Rules（规则文件）
En bref : Fichiers de consignes modulaires stockés dans .claude/rules/ et chargés avec CLAUDE.md, pouvant être restreints via paths: pour n'être chargés que lorsque Claude accède à un dossier ou un fichier spécifique, optimisant ainsi l'espace de contexte.
Analogie : Des manuels de normes spécialisés consultés selon les besoins. CLAUDE.md constitue les consignes générales lues par tous ; les règles spécifiques sont des manuels dédiés aux électriciens ou plombiers consultés uniquement pour les tâches correspondantes — évitant d'encombrer le bureau avec des informations hors de propos (voir chapitre 13).
Output style（输出样式）
En bref : Un paramètre modifiant le prompt système de Claude pour ajuster son ton, son comportement et le format de ses réponses ; propose par défaut les modes Default, Proactive, Explanatory et Learning.
Analogie : Un présentateur adoptant un ton différent selon l'émission. La même personne s'exprimera différemment s'il s'agit d'un journal télévisé ou d'un divertissement. L'output style configure ce format de restitution, indépendamment des consignes de CLAUDE.md transmises au sein des messages utilisateur (voir chapitre 32).
💡 En résumé : Cette thématique concerne la gestion de la mémoire et de l'expression — la fenêtre de contexte est la surface de travail, le token est l'unité de mesure, la compression est l'action de rangement, la session est une tâche indépendante, CLAUDE.md, l'auto memory et les règles sont des notes de rappel sur le bureau, et l'output style définit le ton de restitution.
03 Extensibilité : équiper Claude avec des fonctionnalités supplémentaires
Cette thématique est cruciale — comment adapter Claude à vos besoins spécifiques. Le chapitre 30 détaille le choix de ces outils, nous en proposons ici une synthèse rapide. Leur point commun : ils se greffent à différentes étapes du cycle d'agent.
Analogie : Fournir différentes sacoches d'outils à un artisan. Disposer d'un artisan qualifié est une chose — mais l'équiper d'un manuel (CLAUDE.md), de fiches techniques (skills), d'un adaptateur universel (MCP), d'assistants (subagents) et de jalons automatisés (hooks) démultiplie ses capacités d'intervention. Passons-les en revue.
Skill（技能）
En bref : Un fichier SKILL.md regroupant des connaissances, des processus ou des flux de travail spécifiques ; Claude l'importe automatiquement s'il est pertinent pour la tâche, et vous pouvez également l'appeler manuellement avec /<nom>.
Analogie : Les raccourcis sur un smartphone. Activer le raccourci « mode retour » éteint les lumières, allume la climatisation et lance la musique en une seule action — vous n'avez pas à configurer chaque étape à chaque fois. Un skill est un raccourci pour Claude : il encapsule un processus réutilisable appelable en un clic. Il ne consomme qu'une ligne de description en veille, le contenu complet n'étant chargé dans le contexte qu'à son exécution (ce que la documentation qualifie de divulgation progressive) (voir chapitre 26).
Subagent（子代理）
En bref : Un assistant dédié disposant de sa propre fenêtre de contexte, configuré avec des consignes système et des permissions d'outils spécifiques. Vous lui confiez une tâche et il ne renvoie qu'une synthèse des résultats dans la session principale.
Analogie : Déléguer des recherches à un assistant. Vous lui demandez de parcourir trente dossiers d'archives pour y trouver une information ; il effectue les recherches en dehors de votre bureau, préservant ainsi votre espace de travail, et revient simplement vous donner le résultat. L'intérêt réside dans l'isolation du contexte — les étapes intermédiaires n'encombrent pas votre session principale. Il existe trois sous-agents intégrés : Explore, Plan et la version générique (voir chapitre 23).
Hook（钩子）
En bref : Une action exécutée automatiquement à une étape clé du cycle de vie de Claude Code (avant l'appel d'un outil, après édition d'un fichier, au démarrage de la session...), sous forme de commande shell, de script ou de notification.
Analogie : Un tamponnage automatique sur une chaîne d'assemblage. À chaque passage d'une pièce, un mécanisme applique automatiquement un marquage — sans surveillance humaine ni décision de l'IA, l'action se déclenche systématiquement lors de l'événement. C'est la différence fondamentale avec CLAUDE.md : déclarer une consigne dans CLAUDE.md relève de l'incitation, un hook apporte une garantie d'exécution (voir chapitre 33).
Command / slash command（命令 / 斜杠命令）
En bref : Des instructions réutilisables appelables en saisissant /nom dans la console ; les commandes intégrées (/clear, /model, /compact) pilotent la session, tandis que les versions personnalisées s'apparentent à des skills déclenchés par un /nom.
Analogie : Les touches de raccourci d'une télécommande. La commande /clear correspond au bouton de réinitialisation ; un /deploy personnalisé équivaut à un bouton d'envoi en production — un appui déclenche le processus configuré. La documentation recommande désormais d'utiliser des skills pour encapsuler des suites d'actions (voir chapitre 36).
Plugin（插件）
En bref : Un conteneur logiciel regroupant skills, hooks, sous-agents et serveurs MCP en une seule unité d'installation ; l'installer active l'ensemble des composants associés.
Analogie : Une valise de voyage. Plutôt que de transporter individuellement vêtements, accessoires et chargeurs dans vos bras, vous les rassemblez dans une valise. Un plugin est cette valise — pour réutiliser vos configurations sur un autre projet, il suffit d'installer le plugin correspondant. Les compétences incluses intègrent un espace de nommage (ex. /my-plugin:review), ce qui évite les conflits entre extensions (voir chapitre 24).
Plugin marketplace（插件市场）
En bref : Un service de distribution et de téléchargement de plugins, permettant de configurer une ou plusieurs sources et d'y sélectionner des plugins à installer.
Analogie : Un magasin d'applications (App Store). Le magasin propose une suite d'applications (plugins) que vous installez selon vos besoins. Vérifiez la provenance — installer un plugin d'origine inconnue comporte les mêmes risques de sécurité que d'exécuter un fichier .exe inconnu (voir chapitre 38).
💡 En résumé : Cette thématique regroupe les fonctionnalités d'extensibilité — un skill est un raccourci, un subagent est un assistant dédié, un hook est un jalon automatisé, une commande est une touche de raccourci, un plugin est une valise d'outils et le marketplace est le magasin d'applications ; chacun s'intercale à une étape du cycle d'agent.
04 Protocole MCP (Model Context Protocol) : connecter Claude aux ressources externes
Au sein des extensions, le protocole MCP mérite une attention particulière car il s'accompagne d'un vocabulaire spécifique (transport, serveurs, portées...) propice aux erreurs de syntaxe. Le chapitre 22 y est entièrement consacré, nous présentons ici ses différents composants.
Analogie : Un hub d'extension multi-ports. Un ordinateur portable récent ne dispose souvent que d'un ou deux ports physiques, empêchant d'y connecter écran HDMI, câble réseau ou clé USB. Utiliser un hub connecté sur un port unique résout le problème. MCP est ce hub d'extension pour Claude — une seule connexion lui donne accès à une suite d'outils issus de services externes.
MCP（Model Context Protocol，模型上下文协议）
En bref : Un protocole ouvert définissant la manière dont les outils d'IA accèdent aux données et services externes ; les serveurs MCP connectent Claude à des centaines d'applications comme Slack, Jira, des bases de données ou des navigateurs.
Analogie : Le standard de connexion USB. Autrefois, chaque périphérique disposait d'un format de prise propriétaire, ce qui compliquait l'usage. La généralisation de l'USB permet de connecter n'importe quel périphérique sur un port universel. Le protocole MCP est ce « standard USB » pour l'accès aux outils externes par les IA (voir chapitre 22).
MCP server（MCP 服务器）
En bref : Une implémentation concrète conforme au protocole MCP, exposant une suite d'outils (par exemple, un serveur GitHub exposera des outils pour « lire une PR » ou « ouvrir une issue ») utilisables par Claude dès sa connexion.
Analogie : Un périphérique connecté sur le hub. Le hub définit la norme (MCP), l'imprimante ou le disque externe connectés sont des périphériques (serveurs MCP) — chaque serveur ouvrant l'accès à un service spécifique (voir chapitre 22).
Transport（传输方式）
En bref : La méthode de communication physique établie entre Claude Code et le serveur MCP ; elle se décline principalement sous deux formes — stdio (exécution d'un processus local) et http (accès à un service distant hébergé), complétées par l'ancienne implémentation sse.
Analogie : L'emplacement du périphérique connecté. Une connexion stdio correspond à un utilitaire exécuté en arrière-plan directement sur votre machine (à portée de main), tandis qu'une connexion http cible un service réseau hébergé à une adresse distante (de l'autre côté de la cloison). C'est une cause fréquente d'erreur de syntaxe : le mode stdio ne nécessite pas de déclarer de transport, tandis que le mode http exige l'option --transport http (voir chapitre 22).
Scope（作用域）
En bref : Le périmètre de validité d'un serveur MCP — local (limité au projet actif, privé), project (enregistré dans .mcp.json pour être partagé via git) ou user (disponible pour l'ensemble de vos projets).
Analogie : L'accès à une imprimante partagée. Connectée uniquement sur votre poste (local), enregistrée sur le réseau de l'équipe pour être accessible à tous (project), ou configurée sur votre ordinateur portable pour vous suivre lors de vos déplacements (user) (voir chapitre 22).
MCP Tool Search（MCP 工具搜索）
En bref : Un mécanisme d'optimisation de contexte consistant à ne charger que les noms des outils au démarrage, et à ne récupérer leurs spécifications complètes qu'à leur exécution effective.
Analogie : Consulter les intitulés de la carte avant de lire les recettes. Face à un menu volumineux, vous ne lisez pas la recette détaillée de chaque plat d'emblée — vous parcourez les titres, faites votre choix, puis consultez les ingrédients correspondants. Cela évite d'encombrer l'espace de contexte avec des outils inactifs (voir chapitre 22).
💡 En résumé : Le protocole MCP est la norme USB pour connecter les IA aux services externes — le serveur est le périphérique d'accès, le transport définit la connexion (processus stdio local ou lien http distant) et la portée (scope) détermine son accessibilité ; vérifiez la fiabilité des serveurs tiers avant de les connecter.
05 Sécurité et permissions : les contrôles avant l'action
Dès que Claude dispose d'outils d'action et d'accès externes, la gestion des risques de dérive devient un sujet crucial. Ces concepts décrivent les garde-fous encadrant son exécution — de la simple notification à l'interdiction stricte. Les chapitres 20 et 21 détaillent ces aspects.
Analogie : Les niveaux de sécurité d'un véhicule. La ceinture de sécurité, l'airbag, les panneaux de signalisation — certains guident votre comportement, d'autres limitent les conséquences d'un incident, et d'autres encore imposent des limites strictes. Les garde-fous de Claude sont structurés de la même manière.
Permission mode（权限模式）
En bref : Le niveau d'autonomie accordé à Claude lors d'une session, décliné en six modes officiels — validation systématique (default), acceptation automatique des modifications (acceptEdits), analyse en lecture seule (plan), exécution directe sans confirmation (bypassPermissions), audit automatisé (auto) et acceptation silencieuse (dontAsk) ; voir chapitre 35 pour les détails.
Analogie : Le niveau d'autonomie accordé à votre stagiaire. Pour un même collaborateur, vous pouvez exiger une validation systématique avant chaque tâche, ou l'autoriser à prendre des décisions sur les tâches courantes. C'est ce paramètre de délégation que vous basculez avec la combinaison Shift+Tab dans la CLI (voir chapitre 35).
Plan mode（计划模式）
En bref : Un mode de délégation en lecture seule où Claude explore le code, effectue des recherches et élabore des solutions sans modifier les fichiers sources, vous soumettant sa proposition avant de démarrer l'implémentation.
Analogie : Valider le plan de masse avant d'entamer les travaux. L'artisan ne commence pas par casser les murs, il élabore un plan d'intervention (« abattre cette cloison, déplacer ce tuyau ») qu'il vous soumet. C'est l'approche la plus sûre pour les modifications d'envergure (voir chapitre 35).
Auto mode（自动模式）
En bref : Un mode de permissions s'appuyant sur un classificateur en arrière-plan pour auditer chaque action et bloquer les anomalies, contournements de droits ou injections de requêtes, évitant les demandes de confirmation manuelles répétées ; disponible en version expérimentale.
Analogie : Un agent de sécurité qui contrôle les badges sans analyser les marchandises. Il se concentre sur la légitimité des accès. N'ayant pas accès au contenu retourné par les outils, il est protégé contre les consignes malveillantes dissimulées dans les flux de données (voir chapitre 35).
Permission rule（权限规则）
En bref : Consignes d'autorisation précises (allow / ask / deny) ciblant un outil et des arguments spécifiques, évaluées dans l'ordre strict deny → ask → allow.
Analogie : Les règles d'accès d'un badge. « Ce profil accède au 3e étage mais se voit refuser l'entrée de la salle des serveurs » — ces consignes sont plus précises que le mode de délégation global et viennent le surcharger localement (voir chapitre 20).
Sandboxing（沙箱）
En bref : Un dispositif d'isolation réseau et système appliqué aux commandes shell, permettant à Claude d'exécuter des actions dans un périmètre sécurisé sans solliciter de confirmation manuelle.
Analogie : Tester un véhicule sur un circuit fermé ceinturé de murs. Le pilote peut rouler à grande vitesse car l'enceinte physique l'empêche de dévier. La sandbox constitue cette enceinte d'isolation, indépendante des règles de configuration logiques (voir chapitre 21).
Prompt injection（提示注入）
En bref : Des directives malveillantes dissimulées dans les documents, pages web ou retours d'outils, visant à détourner Claude de ses consignes initiales.
Analogie : Un appel téléphonique malveillant suivant un scénario d'ingénierie sociale. L'interlocuteur s'exprime normalement, mais vous intime l'ordre de réaliser un virement bancaire. L'injection de requêtes est cette consigne masquée dans les données lues par le modèle, risquant de le détourner de ses consignes. Le risque est particulièrement élevé lors de l'usage de serveurs MCP accédant à des ressources externes (voir chapitre 21).
Checkpoint（检查点）
En bref : Un point de restauration généré automatiquement à chaque envoi de consigne, avant modification des fichiers par Claude ; un double appui sur Esc ou la commande /rewind ouvre un menu permettant de restaurer le code, la conversation ou les deux. C'est un outil local à la session, indépendant de git.
Analogie : La sauvegarde rapide dans un jeu vidéo (Quick Save / Quick Load). En cas d'erreur, vous restaurez la sauvegarde précédente pour reprendre le jeu, sans avoir à tout recommencer. Attention : ce mécanisme ne suit pas les modifications opérées via les outils shell (Bash) — ces dernières devant être sécurisées par git (voir chapitre 37).
💡 En résumé : Cette thématique concerne les contrôles d'exécution — le mode de permissions constitue le cadre général, les règles de permissions en sont les détails, la sandbox apporte une isolation physique, le mode auto fait office d'audit automatisé et le checkpoint sert à sauvegarder/restaurer ; l'injection de requêtes est le risque de détournement à surveiller.
06 Interfaces et exécution : modalités d'accès et modes de fonctionnement
Cette dernière thématique regroupe les différentes manières de communiquer avec Claude Code. Que ce soit via un terminal, VS Code, un navigateur ou un script automatisé — le moteur sous-jacent reste identique.
Analogie : Les différentes modalités de présence d'un collaborateur. Il peut travailler dans vos bureaux (terminal ou éditeur), intervenir à distance (navigateur) ou simplement traiter des bons de commande transmis en asynchrone (scripts). Ses compétences restent identiques, seules les modalités d'interaction diffèrent.
Surface（交互入口）
En bref : Le point d'accès utilisé pour communiquer avec Claude Code — CLI, VS Code, JetBrains, application de bureau ou claude.ai ; toutes ces interfaces s'appuient sur le même moteur, partageant vos fichiers CLAUDE.md, paramètres et skills.
Analogie : Le même système d'exploitation partagé par différents modèles de voitures. Qu'il s'agit d'une citadine ou d'un utilitaire, l'interface et les fonctionnalités restent identiques, évitant tout effort d'adaptation. C'est le principe du partage de moteur entre interfaces (voir chapitre 08).
Non-interactive mode（非交互模式 / 旧称 headless）
En bref : L'exécution avec l'option -p (ou --print) — le prompt est traité et l'application s'arrête d'emblée après affichage du résultat, sans ouvrir de session interactive ; particulièrement adapté aux intégrations CI ou aux scripts. Anciennement qualifié de mode headless.
Analogie : Transmettre un bon de commande. Il n'y a pas d'échange ou de discussion, la consigne est exécutée et le résultat livré. C'est l'équivalent programmatique de l'Agent SDK (voir chapitre 45).
Agent SDK（代理 SDK）
En bref : La bibliothèque de développement (disponible en Python et TypeScript) permettant d'integrer le moteur d'exécution de Claude Code au sein de vos propres applications afin de le piloter par code.
Analogie : Intégrer le mécanisme d'un automate à café dans un distributeur personnalisé. Plutôt que d'acheter la machine entière, vous récupérez le bloc de chauffe pour concevoir votre propre produit. Le mode non interactif est la déclinaison console, l'Agent SDK en est la déclinaison programmatique (voir chapitre 45).
Claude Code on the web（网页版）
En bref : L'exécution de Claude Code dans votre navigateur, les commandes s'exécutant dans un environnement isolé hébergé sur le cloud (à distinguer de Remote Control, où le code reste sur votre machine locale, seule l'affichage étant déporté).
Analogie : Louer un ordinateur virtuel éphémère détruit après usage. Les calculs et exécutions se déroulent sur des serveurs distants, préservant ainsi les ressources de votre machine locale (voir chapitre 11).
Bare mode（精简模式）
En bref : Le démarrage avec l'option --bare, désactivant le chargement automatique des hooks, skills, plugins, serveurs MCP, mémoires ou fichiers CLAUDE.md — seuls les paramètres déclarés explicitement sont pris en compte ; idéal pour garantir la reproductibilité dans les CI.
Analogie : Voyager avec un bagage cabine strict. Vous faites abstraction de vos personnalisations locales pour ne conserver que la consigne initiale, assurant une exécution identique quelle que soit la machine cible (voir chapitre 34).
Worktree isolation（工作树隔离）
En bref : Une méthode d'isolation s'appuyant sur l'option -w (ou la directive isolation: worktree d'un sous-agent) pour exécuter les tâches dans un worktree git distinct et une branche dédiée au sein du dossier .claude/worktrees/, évitant les conflits d'écriture entre agents parallèles.
Analogie : Ouvrir des chantiers physiques distincts pour chaque équipe d'artisans travaillant sur le même plan. Les différentes équipes travaillent simultanément sans risque d'interférences ou de modifications conflictuelles. C'est la base de la parallélisation de sessions (voir chapitre 41).
Remote Control（远程控制）/ Teleport（传送）
En bref : Remote Control permet de reprendre le contrôle d'une session en cours d'exécution sur votre machine locale depuis un navigateur ou un smartphone (le code restant sur votre machine locale, seul l'affichage étant déporté) ; Teleport (/teleport) réalise l'opération inverse en transférant une session cloud vers votre terminal local.
Analogie : Prendre le contrôle à distance d'une machine de bureau. Remote Control s'apparente à l'usage d'un outil de télécommande depuis votre smartphone pour piloter un calcul s'exécutant chez vous ; teleport revient à importer un travail initié sur le cloud pour le finaliser localement (voir chapitre 11).
💡 En résumé : Cette thématique regroupe les interfaces et modes d'exécution — surface est l'accès physique, le mode non interactif (ancien headless) est une exécution sur commande, l'Agent SDK en est la déclinaison code, la version web s'exécute dans un conteneur cloud, le bare mode est une initialisation épurée, le worktree évite les conflits d'écritures parallèles, et Remote Control/teleport gèrent les transferts d'affichages ou de sessions.
07 Les concepts proches fréquemment confondus
L'accumulation de concepts peut engendrer des confusions. Voici un tableau comparatif des notions les plus proches pour vous aider à les distinguer rapidement. Ce tableau sert également de synthèse transversale pour l'ensemble du glossaire.
| Concepts proches | Différence fondamentale | Distinction en une phrase |
|---|---|---|
| Skill vs Subagent | Destination du contexte chargé | Le skill charge les données dans votre session principale ; le subagent utilise sa propre session et ne renvoie qu'une synthèse (voir chapitre 30) |
| CLAUDE.md vs Skill | Modalité de chargement | CLAUDE.md est chargé au démarrage de chaque session ; le skill n'est chargé qu'à son exécution (voir chapitre 30) |
| Hook vs Règle de permissions | Nature de l'action | Le hook est une automatisation déclenchée par un événement ; la règle de permissions est un contrôle d'autorisation logique d'un outil (voir chapitre 30) |
| Subagent vs Équipe d'agents | Modalité d'interaction directe | Le subagent est asynchrone et ne communique qu'avec la session principale ; l'équipe d'agents regroupe plusieurs sessions interactives avec lesquelles vous pouvez échanger directement (voir chapitre 29) |
| Session vs Turn | Périmètre et granularité | La session est l'historique complet des échanges (contexte partagé) ; le turn (tour de parole) est le cycle unique « consigne utilisateur → réponse finalisée » (voir chapitre 03) |
Compaction vs /clear | Persistance de l'historique | La compaction synthétise l'historique des échanges sous forme réduite ; /clear vide le contexte pour ouvrir une session propre (voir chapitre 19) |
| Permission mode vs Règle de permissions | Granularité du contrôle | Le mode de permissions définit la délégation générale de la session ; la règle de permissions est une surcharge ciblant un outil précis (voir chapitre 20) |
| stdio vs http (transport) | Emplacement d'exécution | stdio utilise un processus local exécuté en arrière-plan ; http connecte un service distant via son URL (voir chapitre 22) |
| CLAUDE.md vs Auto memory | Auteur de la directive | CLAUDE.md contient les règles que vous lui imposez ; l'auto memory regroupe ses propres notes d'auto-apprentissage (voir chapitre 25) |
Plusieurs de ces notions sont propices aux confusions lors de la phase d'apprentissage. L'exemple le plus classique est le choix entre skill et subagent — au début, on a tendance à concevoir un skill pour des tâches de recherche globales, constatant ensuite que l'ouverture de nombreux fichiers s'effectue dans la session principale et sature le contexte. Retenez cette règle : les tâches d'exploration volumineuses dont seul le résultat vous intéresse doivent être déléguées à un subagent, pas à un skill.
💡 En résumé : Pour distinguer les notions proches, retenez la variable clé — destination du contexte pour skill/subagent, modalité de chargement pour CLAUDE.md/skill, granularité pour mode/règle et emplacement d'exécution pour stdio/http.
08 Pratique : interroger Claude pour obtenir des définitions en temps réel
Ce glossaire papier est statique, alors que les concepts évoluent et la documentation officielle reste à jour. Le moyen le plus fiable consiste à demander à Claude d'interroger la documentation. Nous réutilisons pour cela le serveur MCP de documentation officielle configuré au chapitre 22 : gratuit et sans configuration, il permet d'effectuer des recherches en direct.
这个 server 是远程托管的 HTTP 服务，加它需要联网；国内访问
code.claude.com如果不通，先开「魔法上网」再试。
Étape 1 : Connecter le serveur de documentation (dans le terminal, pas dans la session claude)
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcpRésultat attendu : Affichage de la ligne de confirmation Added HTTP MCP server claude-code-docs ..., validant l'enregistrement.
Étape 2 : Confirmer la connexion
claude mcp listRésultat attendu : Le serveur claude-code-docs apparaît dans la liste avec la mention ✓ Connected. Le coche vert confirme le bon fonctionnement ; si la connexion échoue, vérifiez l'état de votre réseau.
Étape 3 : Lancer la session et lui demander de chercher la définition d'un concept
claudeSaisissez ensuite (en ciblant le serveur pour forcer l'usage du protocole MCP plutôt que sa propre mémoire) :
用 claude-code-docs server 查一下官方术语表里 compaction 和 context window 的定义，各用一句话告诉我Résultat attendu : Claude interrompt l'exécution au premier appel pour demander votre approbation (le contrôle de permission décrit à la section 05, indépendant des checkpoints) — validez l'action. Il affiche ensuite les définitions officielles des deux concepts, le nom du serveur claude-code-docs figurant à côté de l'appel d'outil. Cette mention garantit l'origine des données.
Étape 4 : Déconnexion (optionnelle)
claude mcp remove claude-code-docsRésultat attendu : Confirmation du retrait, claude mcp list n'affichant plus le serveur.
Cette manipulation vous dote d'un outil de recherche de concepts toujours à jour : utilisez ce glossaire comme repère rapide, et interrogez directement la documentation officielle en cas de doute.
09 Résumé
Ce chapitre est conçu comme une fiche de consultation rapide — les concepts du tutoriel y sont classés en six thématiques pour y faire référence facilement.
Synthèse des thématiques :
| Thématique | Description | Concepts clés |
|---|---|---|
| Cycle d'agent | Le moteur d'action autonome de Claude | agentic loop, tool, harness, turn, extended thinking, effort level, verification loop |
| Contexte | La gestion de la mémoire et de la restitution | context window, token, compaction, session, CLAUDE.md, auto memory, rules, output style |
| Extensibilité | Équiper l'application d'outils supplémentaires | skill, subagent, hook, command, plugin, marketplace |
| Protocole MCP | Le standard USB de connexion aux services tiers | MCP, server, transport, scope, tool search |
| Sécurité et permissions | Les différents niveaux de contrôle avant l'action | permission mode, plan mode, auto mode, règles de permissions, sandbox, prompt injection, checkpoint |
| Interfaces et exécution | Modalités d'accès et modes de fonctionnement | surface, non-interactive (headless), Agent SDK, version web, bare mode, worktree isolation, Remote Control |
Vous devriez maintenant être en mesure de : appréhender sereinement les concepts techniques de Claude Code — les catégoriser, en donner la définition synthétique et utiliser les analogies correspondantes ; distinguer les notions proches à l'aide du tableau comparatif de la section 07 ; et utiliser le serveur MCP officiel pour interroger la documentation en direct. Cette fiche constitue un point de repère précieux pour stabiliser vos connaissances.
Ce chapitre clôt la présentation des concepts théoriques et pratiques de ce tutoriel — vous disposez désormais de l'ensemble du vocabulaire requis.
Le chapitre suivant 53 « Production vidéo (Remotion) [Optionnel] » — c'est le chapitre bonus de ce tutoriel, qui dépasse le strict cadre du développement logiciel pour illustrer les capacités créatives de Claude Code : utiliser Remotion (un framework permettant de générer des vidéos en code React) pour faire concevoir une animation vidéo par Claude. Ce chapitre est facultatif et n'influe pas sur le reste de la série ; il intéressera ceux qui souhaitent mesurer la portée de la programmation assistée par IA. Réfléchissez-y : si une vidéo s'écrit sous forme de code, charger Claude d'écrire ce code s'apparente à nouveau à un flux « expression du besoin → livraison du livrable ».