Claude Code : un agent de code dans votre terminal

Claude Code lit votre projet, planifie une modification, édite plusieurs fichiers et exécute des commandes pour vous, depuis votre terminal ou votre IDE. Ce n'est pas une fenêtre de chat où vous collez des extraits de code. C'est un agent qui vit dans votre dépôt, voit votre véritable arborescence de fichiers et agit dessus avec votre autorisation.

Vous comprenez déjà la boucle agentique dans l'abstrait : observer, planifier, agir, vérifier le résultat, recommencer. Cette leçon vous montre cette boucle à l'œuvre sur du code réel, où les « outils » consistent à lire des fichiers, écrire des fichiers et exécuter des commandes shell. Nous allons dérouler une tâche concrète (corriger un test qui échoue et expliquer la modification) et regarder de près les demandes d'autorisation qui vous gardent aux commandes.

Ce qu'est réellement Claude Code

Claude Code est un outil en ligne de commande d'Anthropic qui place Claude dans un harnais d'agent avec accès aux fichiers et au shell. Vous le lancez dans un répertoire de projet. Il construit une compréhension de votre code, propose un plan et exécute les étapes, en s'arrêtant pour demander avant toute action conséquente.

Le changement mental clé : dans les applications Claude, c'est vous qui apportez le contexte au modèle. Avec Claude Code, le modèle va chercher son propre contexte. Il fait un grep dans vos fichiers, ouvre ceux qui comptent, lit votre package.json ou pyproject.toml et lance votre suite de tests pour voir ce qui est réellement cassé. Vous ne curez plus la fenêtre de contexte à la main.

Il fonctionne directement dans votre terminal, et s'intègre aussi à des IDE comme VS Code et JetBrains. Le point de départ officiel est la documentation Claude Code.

L'installer

Claude Code s'installe avec une seule commande. Il vous faut d'abord Node.js.

npm install -g @anthropic-ai/claude-code

Placez-vous ensuite dans n'importe quel projet et lancez-le :

cd my-project
claude

Au premier lancement, il vous guide dans l'authentification. Vous pouvez vous connecter avec un compte Claude (les plans Pro ou Max incluent l'usage de Claude Code) ou utiliser une clé APIAPIApplication Programming Interface : une interface standardisée qui permet aux applications de communiquer et d'échanger des données sans connaître leur fonctionnement interne respectif.Voir la définition complète → Anthropic facturée via la Console. Une fois authentifié, vous arrivez dans une session interactive à l'intérieur de votre projet.

La boucle agentique, rendue concrète

Rendons cela réel. Imaginez un petit projet Python avec un test qui échoue. Votre suite signale :

FAILED tests/test_cart.py::test_apply_discount - AssertionError: assert 90.0 == 95.0

Vous ne savez pas encore si le bug est dans le test ou dans le code. Vous tapez une seule instruction :

Corrige le test qui échoue dans tests/test_cart.py et explique la modification que tu as faite.

Voici ce qui se passe, étape par étape, et pourquoi chaque étape compte.

Étape 1 : il explore avant d'agir

Claude Code ne commence pas par éditer. Il exécute d'abord des commandes en lecture seule pour s'orienter. Il peut lancer votre commande de test pour reproduire l'échec, puis ouvrir tests/test_cart.py et le fichier source qu'il importe, probablement cart.py.

C'est la phase « observer » de la boucle, et il la mène sur vos vrais fichiers, pas sur une description que vous avez tapée. Lire des fichiers et lister des répertoires sont des actions à faible risque, donc selon vos réglages elles peuvent se faire sans vous interrompre.

Étape 2 : il élabore un plan

Claude Code raisonne sur ce qu'il a trouvé. Peut-être que apply_discount multiplie par le taux de remise au lieu de le soustraire, si bien qu'une remise de 10 pour cent sur un panier de 100 dollars renvoie 10.0 au lieu de 90.0, et l'attente du test à 90.0 est correcte. Le bug est dans le code source, pas dans le test.

Pour un travail en plusieurs étapes, il rédige souvent un plan court, parfois sous forme de checklist qu'il suit au fil de l'eau. Vous pouvez lire le plan avant toute modification de code, ce qui est votre première occasion de le réorienter s'il a mal compris l'objectif.

Étape 3 : il propose une modification, et demande l'autorisation

Il veut maintenant modifier cart.py. C'est là qu'apparaît la première vraie demande d'autorisation. Claude Code vous montre un diff : les lignes exactes qu'il veut retirer et ajouter. Rien n'est écrit sur disque avant votre approbation.

cart.py
-     return price * discount_rate
+     return price * (1 - discount_rate)

Do you want to make this edit?
  > Yes
    Yes, and don't ask again for this session
    No, tell Claude what to do differently

Vous voyez précisément ce qui va changer. Vous pouvez accepter, refuser ou orienter. Ce schémamaUtiliser un logiciel pour automatiser les tâches et campagnes marketing répétitives, afin de personnaliser à grande échelle sur des canaux comme l'email, le web et le social.Voir la définition complète → diff-puis-approbation est au cœur de ce qui rend l'outil sûr sur du code réel : aucune modification silencieuse.

Étape 4 : il exécute la commande, et demande à nouveau

Après avoir appliqué la modification, Claude Code veut vérifier son travail en relançant les tests. Exécuter une commande shell est une action distincte et plus sensible que modifier un fichier, il redemande donc :

Claude wants to run:
  pytest tests/test_cart.py

  > Yes
    Yes, and don't ask again for pytest commands
    No

Vous approuvez. Les tests s'exécutent. Claude Code lit la sortie, voit du vert et vous rend compte.

Étape 5 : il boucle et explique

Comme vous lui avez demandé d'expliquer, il résume : la fonction de remise multipliait le prix par le taux au lieu d'appliquer le taux comme une réduction, le correctif soustrait la remise du prix plein, et l'assertion qui échouait passe désormais. La phase « vérifier le résultat » de la boucle agentique a eu lieu en exécutant réellement vos tests, pas en laissant Claude deviner si sa modification fonctionnait.

Voilà toute la boucle : explorer, planifier, éditer (avec approbation), exécuter (avec approbation), vérifier, expliquer.

Les autorisations sont le modèle de sécurité

Si un agent avec accès au shell n'est pas terrifiant, c'est grâce au système d'autorisations. Comprenez-le et vous utiliserez Claude Code en confiance.

Par défaut, Claude Code traite les actions selon leur niveau de risque. Lire et chercher dans les fichiers est permissif. Écrire des fichiers déclenche une demande avec un diff. Exécuter des commandes shell déclenche une demande avec la commande exacte. Tout ce qui touche au réseau ou lance quelque chose de destructeur déclenche une demande chaque fois.

Vous pouvez ajuster cela. Les options « Yes, and don't ask again » vous permettent d'accorder une autorisation permanente pour un outil ou un motif de commande spécifique dans la session, pour ne pas approuver vingt fois le même appel anodin à pytest. Vous pouvez aussi configurer une allowlist et une denylist de commandes dans les réglages du projet pour que les règles persistent d'une session à l'autre.

Pour plus d'autonomie, vous pouvez accorder délibérément des autorisations plus larges, et pour un travail non fiable vous pouvez lancer Claude Code en mode sandboxé ou restreint. Le principe est que *vous* choisissez la longueur de la laisse. La valeur par défaut est conservatrice à dessein.

Sa place dans le reste de l'écosystème Claude

Claude Code n'est pas une intelligence à part. C'est Claude (la même famille de modèles que vous utilisez dans les applications et l'API Messages) câblé dans un harnais d'agent de code. Savoir comment il se relie aux autres briques aide à choisir le bon outil.

CLAUDE.md : mémoire de projet persistante

Déposez un fichier nommé CLAUDE.md à la racine de votre projet et Claude Code le lit automatiquement au début de chaque session. C'est là que vous mettez les conventions du projet, la commande pour lancer les tests, des notes d'architecture et les avertissements « ne touche pas à ce répertoire ». Ce sont des instructions durables qui survivent aux sessions, pour ne pas réexpliquer votre projet chaque fois.

# Project: checkout-service

## Commands
- Test: `pytest -q`
- Lint: `ruff check .`

## Conventions
- All prices are in integer cents, never floats.
- Do not edit files in `legacy/` without asking.

MCPMCPUn standard ouvert qui permet aux assistants IA de se connecter aux outils et données de l'entreprise de façon cohérente et gouvernée, sans intégration sur mesure à chaque fois.Voir la définition complète → : donner de nouveaux outils à Claude Code

Vous avez rencontré plus tôt le Model Context Protocol, le standard ouvert qui permet à Claude de dialoguer avec des outils et sources de données externes. Claude Code est un client MCP. Vous pouvez y connecter des serveurs MCP pour lui donner des capacités au-delà des fichiers et du shell : interroger votre base de données, lire votre issue tracker, appeler une API interne. Le site du Model Context Protocol est la référence, et les mêmes connecteurs que vous utilisez dans les applications Claude s'appliquent largement ici aussi.

Intégration GitHub

Claude Code s'intègre naturellement à votre workflow Git. Il peut crcrLe pourcentage de visiteurs ou de prospects qui réalisent une action attendue (achat, inscription, formulaire de contact), calculé en divisant les conversions par le nombre total d'opportunités.Voir la définition complète →éererLe rapport entre les interactions (likes, commentaires, partages) et le reach d'un contenu, utilisé pour mesurer la réaction de l'audience au regard du nombre de personnes touchées.Voir la définition complète → des branches, écrire des commits avec des messages sensés et ouvrir des pull requests. Anthropic propose aussi une intégration GitHub pour mentionner Claude sur une issue ou une pull request et le laisser proposer des modifications directement dans le dépôt, de façon asynchrone, sans votre terminal ouvert. Explorez les outils officiels sur github.com/anthropics.

Le Claude Agent SDK : quand vous voulez construire, pas seulement utiliser

Claude Code est un produit fini. Le harnais d'agent qui le sous-tend est disponible sous forme de Claude Agent SDK, pour construire vos propres agents avec accès aux fichiers, utilisation d'outils et les schémas d'autorisation que vous venez de voir. Si vous vous surprenez à vouloir un agent interne sur mesure pour, disons, trier des logs ou maintenir de la documentation, c'est le rôle du SDK. Claude Code est l'agent de code prêt à l'emploi ; l'Agent SDK est le kit pour construire le vôtre.

Des habitudes pratiques qui font la différence

Quelques schémas séparent les sessions frustrantes des sessions productives.

Donnez-lui un moyen de se vérifier. La chose la plus utile est une commande de test qui fonctionne. Quand Claude Code peut lancer les tests, il se corrige tout seul. L'exemple de la remise a fonctionné proprement parce que pytest lui donnait un signal de vérité terrain. Sans tests, il édite en partie à l'aveugle.

Cadrez vos demandes. « Corrige ce test qui échoue » est une excellente instruction parce qu'elle est vérifiable et bornée. « Refactorise tout le système de paiement » invite à un diff tentaculaire et difficile à relire. Découpez les gros chantiers en étapes que vous pouvez approuver une par une.

Lisez le plan, puis les diffs. Votre relecture fait partie de la boucle. Les demandes d'autorisation ne sont pas de la bureaucratie ; ce sont les moments où votre jugement intervient. Parcourir un diff avant d'approuver rattrape tôt le mauvais virage occasionnel.

Utilisez CLAUDE.md plutôt que de vous répéter. Toute contrainte que vous énoncez à voix haute plus d'une fois a sa place dans ce fichier.

À retenir

• Installez avec npm install -g @anthropic-ai/claude-code, lancez claude dans un projet et authentifiez-vous avec un plan Claude ou une clé API.
• Claude Code exécute une vraie boucle agentique sur votre code : il explore les fichiers, planifie, édite avec un diff que vous approuvez, exécute des commandes que vous approuvez, et vérifie en lançant vos tests.
• Le système d'autorisations est le modèle de sécurité. Les modifications de fichiers affichent un diff avant écriture ; les commandes shell demandent avec la commande exacte. Vous contrôlez la longueur de la laisse avec des allowlists et des autorisations « don't ask again ».
• Ajoutez un CLAUDE.md avec votre commande de test, vos conventions et les répertoires interdits pour que l'agent conserve un contexte durable d'une session à l'autre.
• Tournez-vous vers les serveurs MCP et l'intégration GitHub pour l'étendre, et vers le Claude Agent SDK quand vous voulez construire votre propre agent sur le même harnais.