SpyBara
Go Premium

how-claude-code-works.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 39 additions and 77 deletions.

2026
Wed 9 22:58 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Comment fonctionne Claude Code

Comprenez la boucle agentive, les outils intégrés et comment Claude Code interagit avec votre projet.

Claude Code est un assistant agentif qui s'exécute dans votre terminal. Bien qu'il excelle dans la programmation, il peut vous aider pour tout ce que vous pouvez faire à partir de la ligne de commande : rédiger de la documentation, exécuter des builds, rechercher des fichiers, faire des recherches sur des sujets, et bien plus.

Ce guide couvre l'architecture centrale, les capacités intégrées, et des conseils pour travailler efficacement avec Claude Code. Pour des procédures pas à pas, consultez Workflows courants. Pour les fonctionnalités d'extensibilité comme les skills, MCP et hooks, consultez Étendre Claude Code.

La boucle agentive

Lorsque vous donnez une tâche à Claude, il travaille à travers trois phases : rassembler le contexte, agir, et vérifier les résultats. Ces phases se mélangent ensemble. Claude utilise des outils tout au long du processus, qu'il s'agisse de rechercher des fichiers pour comprendre votre code, d'éditer pour apporter des modifications, ou d'exécuter des tests pour vérifier son travail.

Diagramme de la boucle agentive : Votre prompt conduit Claude à rassembler le contexte, agir, vérifier les résultats, et répéter jusqu'à ce que la tâche soit terminée. Vous pouvez interrompre à tout moment. Diagramme de la boucle agentive : Votre prompt conduit Claude à rassembler le contexte, agir, vérifier les résultats, et répéter jusqu'à ce que la tâche soit terminée. Vous pouvez interrompre à tout moment.

La boucle s'adapte à ce que vous demandez. Une question sur votre base de code pourrait nécessiter uniquement la collecte de contexte. Une correction de bug parcourt les trois phases à plusieurs reprises. Une refactorisation pourrait impliquer une vérification extensive. Claude décide ce que chaque étape nécessite en fonction de ce qu'il a appris à l'étape précédente, en enchaînant des dizaines d'actions ensemble et en se corrigeant en cours de route.

Vous faites également partie de cette boucle. Vous pouvez interrompre à tout moment pour orienter Claude dans une direction différente, fournir un contexte supplémentaire, ou lui demander d'essayer une approche différente. Claude fonctionne de manière autonome mais reste réactif à votre contribution.

La boucle agentive est alimentée par deux composants : les modèles qui raisonnent et les outils qui agissent. Claude Code sert de harnais agentif autour de Claude : il fournit les outils, la gestion du contexte, et l'environnement d'exécution qui transforment un modèle de langage en un agent de codage capable.

Modèles

Claude Code utilise les modèles Claude pour comprendre votre code et raisonner sur les tâches. Claude peut lire du code dans n'importe quel langage, comprendre comment les composants se connectent, et déterminer ce qui doit changer pour accomplir votre objectif. Pour les tâches complexes, il divise le travail en étapes, les exécute, et s'ajuste en fonction de ce qu'il apprend.

Plusieurs modèles sont disponibles avec des compromis différents. Sonnet gère bien la plupart des tâches de codage. Opus fournit un raisonnement plus fort pour les décisions architecturales complexes. Basculez avec /model pendant une session ou commencez avec claude --model <name>.

Lorsque ce guide dit « Claude choisit » ou « Claude décide », c'est le modèle qui effectue le raisonnement.

Outils

Les outils sont ce qui rend Claude Code agentif. Sans outils, Claude ne peut que répondre avec du texte. Avec les outils, Claude peut agir : lire votre code, éditer des fichiers, exécuter des commandes, rechercher sur le web, et interagir avec des services externes. Chaque utilisation d'outil retourne des informations qui se réintègrent dans la boucle, informant la décision suivante de Claude.

Les outils intégrés se divisent généralement en cinq catégories, chacune représentant un type d'agentivité différent.

Catégorie Ce que Claude peut faire
Opérations sur les fichiers Lire des fichiers, éditer du code, créer de nouveaux fichiers, renommer et réorganiser
Recherche Trouver des fichiers par motif, rechercher du contenu avec regex, explorer les bases de code
Exécution Exécuter des commandes shell, démarrer des serveurs, exécuter des tests, utiliser git
Web Rechercher sur le web, récupérer de la documentation, rechercher des messages d'erreur
Intelligence du code Voir les erreurs de type et les avertissements après les éditions, accéder aux définitions, trouver les références (nécessite les plugins d'intelligence du code)

Ce sont les capacités principales. Claude dispose également d'outils pour générer des subagents, vous poser des questions, et d'autres tâches d'orchestration. Consultez Outils disponibles pour Claude pour la liste complète.

Claude choisit les outils à utiliser en fonction de votre prompt et de ce qu'il apprend en cours de route. Lorsque vous dites « corriger les tests qui échouent », Claude pourrait :

  1. Exécuter la suite de tests pour voir ce qui échoue
  2. Lire la sortie d'erreur
  3. Rechercher les fichiers source pertinents
  4. Lire ces fichiers pour comprendre le code
  5. Éditer les fichiers pour corriger le problème
  6. Exécuter les tests à nouveau pour vérifier

Chaque utilisation d'outil donne à Claude de nouvelles informations qui informent l'étape suivante. C'est la boucle agentive en action.

Étendre les capacités de base : Les outils intégrés sont la fondation. Vous pouvez étendre ce que Claude sait avec les skills, vous connecter à des services externes avec MCP, automatiser les workflows avec hooks, et déléguer des tâches à des subagents. Ces extensions forment une couche au-dessus de la boucle agentive principale. Consultez Étendre Claude Code pour des conseils sur le choix de la bonne extension pour vos besoins.

Ce que Claude peut accéder

Lorsque vous exécutez claude dans un répertoire, Claude Code accède à :

  • Votre projet. Les fichiers de votre répertoire et sous-répertoires, plus les fichiers ailleurs avec votre permission.
  • Votre terminal. N'importe quelle commande que vous pourriez exécuter : outils de build, git, gestionnaires de paquets, utilitaires système, scripts. Si vous pouvez le faire à partir de la ligne de commande, Claude aussi.
  • Votre état git. La branche actuelle, les modifications non validées, et l'historique récent des commits.
  • Votre CLAUDE.md. Un fichier markdown où vous stockez les instructions spécifiques au projet, les conventions, et le contexte que Claude devrait connaître à chaque session.
  • Mémoire automatique. Les apprentissages que Claude sauvegarde automatiquement au fur et à mesure que vous travaillez, comme vos préférences. Les 200 premières lignes ou 25 KB de MEMORY.md, selon ce qui vient en premier, se chargent au début de chaque session.
  • Les extensions que vous configurez. Les serveurs MCP pour les services externes, les skills pour les workflows, les subagents pour le travail délégué, et Claude dans Chrome pour l'interaction avec le navigateur.

Parce que Claude voit votre projet entier, il peut travailler à travers celui-ci. Lorsque vous demandez à Claude de « corriger le bug d'authentification », il recherche les fichiers pertinents, lit plusieurs fichiers pour comprendre le contexte, effectue des éditions coordonnées à travers eux, exécute des tests pour vérifier la correction, et valide les modifications si vous le demandez. C'est différent des assistants de code en ligne qui ne voient que le fichier actuel.

Environnements et interfaces

La boucle agentive, les outils, et les capacités décrites ci-dessus sont les mêmes partout où vous utilisez Claude Code. Ce qui change, c'est où le code s'exécute et comment vous interagissez avec lui.

Environnements d'exécution

Claude Code s'exécute dans trois environnements, chacun avec des compromis différents pour l'endroit où votre code s'exécute.

Environnement Où le code s'exécute Cas d'usage
Local Votre machine Par défaut. Accès complet à vos fichiers, outils, et environnement
Cloud VMs gérées par Anthropic, ou environnements auto-hébergés que votre organisation exploite Déléguer des tâches, travailler sur des repos que vous n'avez pas localement
Contrôle à distance Votre machine, contrôlée à partir d'un navigateur Utiliser l'interface web tout en gardant l'exécution et vos fichiers locaux

Interfaces

Vous pouvez accéder à Claude Code via le terminal, l'application de bureau, les extensions IDE, claude.ai/code, Contrôle à distance, Slack, et les pipelines CI/CD. L'interface détermine comment vous voyez et interagissez avec Claude, mais la boucle agentive sous-jacente est identique. Consultez Utiliser Claude Code partout pour la liste complète.

Travailler avec les sessions

Claude Code sauvegarde votre conversation localement au fur et à mesure que vous travaillez. Chaque message, utilisation d'outil, et résultat est écrit dans un fichier JSONL en texte brut sous ~/.claude/projects/, ce qui permet de revenir en arrière, de reprendre et de forker les sessions. Avant que Claude ne fasse des modifications de code, il prend également un snapshot des fichiers affectés afin que vous puissiez revenir en arrière si nécessaire. Pour les chemins, la rétention, et comment effacer ces données, consultez les données d'application dans ~/.claude.

Les sessions sont indépendantes. Chaque nouvelle session commence avec une fenêtre de contexte fraîche, sans l'historique de conversation des sessions précédentes. Claude peut persister les apprentissages à travers les sessions en utilisant la mémoire automatique, et vous pouvez ajouter vos propres instructions persistantes dans CLAUDE.md.

Travailler à travers les branches

Chaque conversation Claude Code est une session liée à votre répertoire actuel. Le sélecteur /resume affiche les sessions du worktree actuel par défaut, avec des raccourcis clavier pour élargir la liste à d'autres worktrees ou projets. Consultez Gérer les sessions pour la liste complète des raccourcis du sélecteur et comment fonctionne la résolution des noms.

Claude voit les fichiers de votre branche actuelle. Lorsque vous changez de branche, Claude voit les fichiers de la nouvelle branche, mais votre historique de conversation reste le même. Claude se souvient de ce que vous avez discuté même après avoir changé de branche.

Puisque les sessions sont liées aux répertoires, vous pouvez exécuter des sessions Claude parallèles en utilisant git worktrees, qui créent des répertoires séparés pour les branches individuelles.

Reprendre ou forker les sessions

Reprendre une session avec claude --continue ou claude --resume la rouvre sous le même ID de session et ajoute de nouveaux messages à la conversation existante. Forker avec --fork-session ou /branch copie l'historique dans un nouvel ID de session, laissant l'original inchangé.

Diagram of session continuity: resume continues the same session, fork creates a new branch with a new ID. Diagram of session continuity: resume continues the same session, fork creates a new branch with a new ID.

Pour les flags de reprise, le sélecteur /resume, le nommage, et ce qui se passe lorsque la même session est ouverte dans deux terminaux, consultez Gérer les sessions.

La fenêtre de contexte

La fenêtre de contexte de Claude contient votre historique de conversation, le contenu des fichiers, les sorties de commande, CLAUDE.md, la mémoire automatique, les skills chargés, et les instructions système. Au fur et à mesure que vous travaillez, le contexte se remplit. Claude compacte automatiquement, mais les instructions du début de la conversation peuvent être perdues. Mettez les règles persistantes dans CLAUDE.md, et exécutez /context pour voir ce qui utilise l'espace.

Pour une procédure interactive d'exploration de ce qui se charge et quand, consultez Explorer la fenêtre de contexte.

Lorsque le contexte se remplit

Claude Code gère le contexte automatiquement à mesure que vous approchez de la limite. Il efface d'abord les sorties d'outils plus anciennes, puis résume la conversation si nécessaire. Vos demandes et les extraits de code clés sont préservés ; les instructions détaillées du début de la conversation peuvent être perdues. Mettez les règles persistantes dans CLAUDE.md plutôt que de compter sur l'historique de conversation.

Pour contrôler ce qui est préservé pendant la compaction, ajoutez une section « Compact Instructions » à CLAUDE.md ou exécutez /compact avec un focus (comme /compact focus on the API changes).

Si un seul fichier ou une sortie d'outil est si volumineux que le contexte se remplit immédiatement après chaque résumé, Claude Code arrête la compaction automatique après quelques tentatives et affiche une erreur à la place de boucler. Consultez La compaction automatique s'arrête avec une erreur de thrashing pour les étapes de récupération.

Exécutez /context pour voir ce qui utilise l'espace. Les définitions d'outils MCP sont différées par défaut et chargées à la demande via la recherche d'outils, donc seuls les noms d'outils et les instructions du serveur consomment du contexte jusqu'à ce que Claude utilise un outil spécifique.

Gérer le contexte avec les skills et les subagents

Au-delà de la compaction, vous pouvez utiliser d'autres fonctionnalités pour contrôler ce qui se charge dans le contexte.

Les skills se chargent à la demande. Claude voit les descriptions des skills au démarrage de la session, mais le contenu complet ne se charge que lorsqu'un skill est utilisé. Pour les skills que vous invoquez manuellement, définissez disable-model-invocation: true pour garder les descriptions hors du contexte jusqu'à ce que vous en ayez besoin. Pour les skills que vous n'avez pas écrits, utilisez skillOverrides pour faire la même chose à partir des paramètres.

Les subagents travaillent dans leur propre fenêtre de contexte. Un subagent commence de zéro sauf s'il s'agit d'un fork, qui commence avec une copie de votre conversation jusqu'à présent. De toute façon, les appels d'outils du subagent restent hors de votre contexte, et Claude récupère un résumé lorsque le subagent termine.

Consultez les coûts de contexte pour ce que chaque fonctionnalité coûte, et réduire l'utilisation des tokens pour des conseils sur la gestion du contexte.

Rester en sécurité avec les checkpoints et les permissions

Claude dispose de deux mécanismes de sécurité : les checkpoints vous permettent d'annuler les modifications de fichiers, et les permissions contrôlent ce que Claude peut faire sans demander.

Annuler les modifications avec les checkpoints

Chaque édition de fichier est réversible. Avant que Claude n'édite un fichier, il prend un snapshot du contenu actuel. Si quelque chose se passe mal, appuyez deux fois sur Esc pour revenir à un état précédent, ou demandez à Claude d'annuler.

Les checkpoints sont séparés de git et restent disponibles lorsque vous reprenez une conversation. Ils ne couvrent que les modifications de fichiers, et une restauration ignore les fichiers avec liens symboliques et liens physiques. Les actions qui affectent les systèmes distants (bases de données, APIs, déploiements) ne peuvent pas être checkpointées. Vous les contrôlez avec votre mode de permission et vos règles de permission.

Contrôler ce que Claude peut faire

Choisissez un mode de permission pour définir ce que Claude peut faire sans vous demander. Appuyez sur Shift+Tab pour parcourir les modes de permission :

  • Auto : un classificateur examine la plupart des actions en arrière-plan et bloque les actions risquées au lieu de vous demander. Sur les plans Pro, Max et Team, c'est le mode de permission de démarrage intégré pour les sessions de terminal interactif et VS Code
  • Manual : Claude demande avant les éditions de fichiers et les commandes shell
  • Accept edits : Claude édite les fichiers et exécute les commandes courantes du système de fichiers comme mkdir et mv sans demander, demande toujours pour les autres commandes
  • Plan : Claude explore et propose un plan sans éditer vos fichiers source

Vous pouvez également autoriser des commandes spécifiques dans .claude/settings.json afin que Claude ne demande pas à chaque fois. C'est utile pour les commandes de confiance comme npm test ou git status. Les paramètres peuvent être scoped à partir des politiques à l'échelle de l'organisation jusqu'aux préférences personnelles. Consultez Permissions pour plus de détails.

Travailler efficacement avec Claude Code

Ces conseils vous aident à obtenir de meilleurs résultats avec Claude Code. Pour plus d'informations sur les prompts spécifiques, la vérification et la planification, consultez Bonnes pratiques.

Demander de l'aide à Claude Code

Claude Code peut vous enseigner comment l'utiliser. Posez des questions comme « comment configurer les hooks ? » ou « quelle est la meilleure façon de structurer mon CLAUDE.md ? » et Claude expliquera.

Les commandes intégrées vous guident également à travers la configuration :

  • /init vous guide à travers la création d'un CLAUDE.md pour votre projet
  • /doctor exécute une vérification de configuration qui diagnostique les problèmes d'installation et de configuration et peut les corriger

C'est une conversation

Claude Code est conversationnel. Vous n'avez pas besoin de prompts parfaits. Commencez par ce que vous voulez, puis affinez :

Corriger le bug de connexion

[Claude enquête, essaie quelque chose]

Ce n'est pas tout à fait correct. Le problème est dans la gestion de session.

[Claude ajuste son approche]

Lorsque la première tentative n'est pas correcte, vous ne recommencez pas. Vous itérez.

Interrompre et orienter

Vous pouvez rediriger Claude à tout moment sans attendre que le tour se termine ou recommencer :

  • Appuyez sur Esc pour arrêter Claude immédiatement. L'appel d'outil en cours est annulé et Claude attend votre prochaine instruction. Si vous avez des messages en attente, Claude Code les envoie ensuite.
  • Tapez une correction et appuyez sur Entrée pour l'envoyer sans arrêter l'outil en cours. Claude la lit dès que l'action actuelle se termine et s'ajuste avant de décider de son prochain pas.

Déléguer, ne pas dicter

Pensez à déléguer à un collègue capable. Donnez le contexte et la direction, puis faites confiance à Claude pour déterminer les détails :

Le flux de paiement est cassé pour les utilisateurs avec des cartes expirées.
Le code pertinent est dans src/payments/. Pouvez-vous enquêter et corriger ?

Vous n'avez pas besoin de spécifier quels fichiers lire ou quelles commandes exécuter. Claude le détermine.

Prochaines étapes

puzzle-piece Étendre avec des fonctionnalités

Ajouter des Skills et des connexions MCP
graduation-cap Workflows courants

Guides pas à pas pour les tâches typiques