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.
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.
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 :
- Exécuter la suite de tests pour voir ce qui échoue
- Lire la sortie d’erreur
- Rechercher les fichiers source pertinents
- Lire ces fichiers pour comprendre le code
- Éditer les fichiers pour corriger le problème
- Exécuter les tests à nouveau pour vérifier
Ce que Claude peut accéder
Lorsque vous exécutezclaude 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. Si votre référentiel dispose d’un AGENTS.md pour d’autres agents de codage, Claude peut le lire seul ou aux côtés de CLAUDE.md.
- 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.
Environnements et interfaces
La boucle agentive, les outils, et les capacités 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.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 avecclaude --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é.
/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.
Contexte que Claude Code ajoute de lui-même
Si Claude suit une règle que vous n’avez pas écrite, comme l’ajout d’une ligneCo-Authored-By à un commit, la règle peut provenir d’un rappel système. Au fur et à mesure que vous travaillez, Claude Code ajoute son propre contexte à la conversation aux côtés de vos messages :
- Vos fichiers CLAUDE.md
- Les instructions de votre style de sortie
- Une note lorsqu’un fichier que Claude a lu précédemment change sur le disque
- Les lignes d’attribution de commit et de pull request
attribution. Pour supprimer les instructions intégrées de Claude Code pour les commits et les pull requests, définissez includeGitInstructions sur false. Pour les autres commutateurs, consultez Désactiver le contexte que votre agent remplace.
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éfinissezdisable-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 surEsc 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 surShift+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. Avec Claude Code v2.1.283 ou version ultérieure, c’est le mode de permission de démarrage intégré pour les sessions de terminal interactif et VS Code, et sur les versions antérieures uniquement sur les plans Pro, Max et Team
- 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
mkdiretmvsans demander, demande toujours pour les autres commandes - Plan : Claude explore et propose un plan sans éditer vos fichiers source
.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 :/initgénère un CLAUDE.md de démarrage pour votre projet/doctorexé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 :Interrompre et orienter
Vous pouvez rediriger Claude à tout moment sans recommencer. Faites l’une de ces deux choses :- Appuyez sur
Escpour 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éesans arrêter Claude. Le message s’affiche en attente dans la conversation. Si Claude exécute des appels d’outil, il lit le message dès que ces appels se terminent, dans le même tour, et s’ajuste avant son étape suivante. Mettre en file d’attente des messages pendant que Claude travaille couvre le moment où les autres entrées en attente sont envoyées.
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 :Prochaines étapes
Étendre avec des fonctionnalités
Ajouter des Skills et des connexions MCP
Workflows courants
Guides pas à pas pour les tâches typiques