Comment fonctionne Claude Code
Sur cette page
Comprendre le mécanisme de Claude Code vous évitera bien des surprises. Quand il prend une direction inattendue, quand il relit un fichier qu’il a déjà vu, quand il « oublie » une consigne donnée une heure plus tôt, il y a presque toujours une explication dans les quelques notions de cette leçon : la boucle agentique, les outils, le contexte et les sessions.
La boucle agentique
Quand vous confiez une tâche à Claude Code, il la traite en trois phases : recueillir le contexte, agir, vérifier le résultat. Ces phases se mêlent : Claude utilise ses outils tout du long, pour chercher dans les fichiers, modifier le code ou lancer les tests qui contrôlent son travail.
La boucle s’adapte à la demande. Une question sur le code ne demande parfois que la première phase. La correction d’un bug passe plusieurs fois par les trois. Une refonte peut exiger une longue vérification. Claude décide de chaque étape d’après ce qu’il a appris à l’étape précédente, enchaîne des dizaines d’actions et corrige sa trajectoire en chemin.
Vous faites partie de cette boucle. Vous pouvez interrompre Claude à tout moment pour le réorienter, lui donner un élément de contexte ou lui demander une autre approche : il travaille seul, mais reste attentif à ce que vous lui dites.
Le modèle raisonne, les outils agissent
Deux composants font tourner la boucle : le modèle, qui raisonne, et les outils, qui agissent. Claude Code est la couche qui entoure le modèle, lui fournit les outils et gère le contexte qu’il voit. La documentation appelle cette couche le harnais (en anglais, agentic harness).
Sans outils, Claude ne peut que répondre par du texte. Avec eux, il agit, et chaque résultat d’outil nourrit sa décision suivante. Les outils intégrés se répartissent en cinq catégories :
| Catégorie | Ce que Claude peut faire |
|---|---|
| Opérations sur les fichiers | Lire des fichiers, modifier du code, créer des fichiers, renommer et réorganiser |
| Recherche | Trouver des fichiers par motif, chercher dans le contenu avec des expressions régulières, explorer une base de code |
| Exécution | Lancer des commandes shell, démarrer des serveurs, exécuter des tests, utiliser git |
| Web | Chercher sur le web, récupérer une documentation, rechercher un message d’erreur |
| Intelligence de code | Voir les erreurs de type après une modification, aller à une définition, trouver les références (avec un plugin d’intelligence de code) |
Claude dispose aussi d’outils pour lancer des sous-agents, vous poser des questions et orchestrer son travail. Prenons la demande « corrige les tests qui échouent ». Claude peut lancer la suite de tests pour voir ce qui échoue, lire la sortie d’erreur, chercher les fichiers sources concernés, les lire, les modifier, puis relancer les tests pour vérifier. Chaque outil apporte une information qui décide de l’étape suivante : c’est la boucle agentique en action.
Ce à quoi Claude a accès
Quand vous lancez claude dans un dossier, Claude Code accède à :
- votre projet : les fichiers du dossier et de ses sous-dossiers, et des fichiers ailleurs avec votre permission ;
- votre terminal : toute commande que vous pourriez lancer vous-même, outils de build, git, gestionnaires de paquets, scripts ;
- l’état git : la branche courante, les modifications non commitées, l’historique récent ;
- votre
CLAUDE.md, le fichier d’instructions du projet (ou unAGENTS.mdsi le dépôt en a un pour d’autres agents de code) ; - la mémoire automatique, les notes que Claude garde lui-même d’une session à l’autre ;
- les extensions que vous configurez : serveurs MCP, skills, sous-agents, Claude in Chrome.
Les modèles
Claude Code fonctionne avec les modèles Claude. Sur les offres Pro, Max, Ultra, Team et Enterprise comme sur l’API Anthropic, le modèle par défaut est Claude Opus 5.5, réglé sur un effort moyen (medium). L’effort est le réglage qui décide combien Claude réfléchit ; vous le changez avec /effort, par exemple /effort high pour un bug délicat dans du code que vous n’avez pas écrit.
Vous changez de modèle avec /model pendant une session, ou au lancement avec claude --model <nom>. Les alias évitent de retenir les numéros de version : opus pour le raisonnement complexe, sonnet pour le code du quotidien à moindre coût, haiku pour les tâches simples et rapides. Claude Fable 5.1, le modèle le plus capable pour les longues tâches autonomes, n’est le modèle par défaut d’aucune offre : on le choisit explicitement avec /model fable.
Où le code s’exécute
La boucle, les outils et les capacités sont les mêmes partout. Ce qui change, c’est l’endroit où le code s’exécute :
| Environnement | Où le code s’exécute | Usage |
|---|---|---|
| Local | Votre machine | Par défaut : accès complet à vos fichiers, outils et environnement |
| Cloud | Des machines virtuelles gérées par Anthropic, ou des environnements hébergés par votre organisation | Déléguer des tâches, travailler sur des dépôts absents de votre machine |
| Remote Control | Votre machine, pilotée depuis un navigateur | L’interface web, avec l’exécution et les fichiers qui restent chez vous |
Les sessions
Claude Code enregistre votre conversation au fur et à mesure, en local : chaque message, chaque appel d’outil et chaque résultat est écrit dans un fichier JSONL sous ~/.claude/projects/. C’est ce qui permet de reprendre une session (claude --continue pour la plus récente du dossier, claude --resume pour choisir dans une liste) ou d’en créer une copie avec --fork-session ou /branch, l’original restant intact.
Chaque nouvelle session démarre avec une fenêtre de contexte vierge, sans l’historique des précédentes. Ce qui doit traverser les sessions passe par CLAUDE.md, que vous écrivez, et par la mémoire automatique, que Claude tient. Quand vous changez de branche git, Claude voit les fichiers de la nouvelle branche mais garde le fil de la conversation.
Deux filets de sécurité
Claude Code a deux mécanismes de sécurité, que vous retrouverez dans les leçons suivantes. Les points de contrôle (checkpoints) : avant de modifier un fichier, Claude en garde une copie, et deux pressions sur Échap ouvrent le menu qui permet de revenir en arrière. Les modes de permission décident de ce que Claude peut faire sans vous demander ; vous passez de l’un à l’autre avec Maj+Tab. Les points de contrôle ne couvrent que les fichiers : une action sur un système distant, comme une base de données, une API ou un déploiement, ne s’annule pas ainsi. Ce sont vos permissions qui la contrôlent.
À vous de jouer
Suivre la boucle. Ouvrez Claude Code dans un projet et demandez : « explique-moi comment ce projet gère ses erreurs ». Pendant qu’il travaille, notez chaque outil qu’il utilise et rangez-le dans une phase : recueillir le contexte, agir, vérifier. Lancez ensuite /model et /effort pour voir le modèle et l’effort de la session.
Sources officielles : How Claude Code works (Claude Academy) · How Claude Code works · Model configuration · Manage sessions
Points clés à retenir
- Claude Code travaille en boucle : recueillir le contexte, agir, vérifier, et recommencer jusqu’à la fin de la tâche ; vous pouvez l’interrompre à tout moment
- Le modèle raisonne, les outils agissent ; Claude Code est le harnais qui fournit les outils et gère le contexte
- Par défaut : Claude Opus 5.5 à effort moyen ;
/modelchange de modèle,/effortchange l’effort - Les sessions sont enregistrées en local et se reprennent, mais chaque nouvelle session part d’un contexte vierge
- Points de contrôle pour les fichiers, modes de permission pour le reste