+180 XP

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, le tout depuis votre terminal ou votre IDE. Vous ne collez pas d'extraits de code dans une fenêtre de chat. 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 connaissez déjà la boucle agentique dans l'abstrait : observer, planifier, agir, vérifier le résultat, recommencer. Cette leçon montre cette boucle à l'œuvre sur du vrai code. Les « outils » sont la lecture de fichiers, l'écriture de fichiers et l'exécution de commandes shell. Nous allons dérouler une tâche concrète (corriger un test en échec et expliquer la modification) et examiner 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 le répertoire d'un projet. Il construit une compréhension de votre codebase, propose un plan et exécute les étapes, en s'arrêtant pour demander avant toute action lourde de conséquences.

Le changement de perspective essentiel : 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 des grep dans vos fichiers, ouvre ceux qui comptent, lit votre package.json ou votre pyproject.toml et lance votre suite de tests pour voir ce qui est réellement cassé. Vous n'avez plus à composer la fenêtre de contexte à la main.

Il fonctionne directement dans votre terminal. Il s'intègre aussi aux IDE comme VS Code et JetBrains, et tourne dans le navigateur via Claude Code on the web. Le point de départ officiel est la documentation de Claude Code.

L'installer

L'installation recommandée passe par l'installateur natif, qui ne nécessite pas Node.js. Sur macOS, Linux ou WSL :

bash
curl -fsSL https://claude.ai/install.sh | bash

Sous Windows PowerShell :

powershell
irm https://claude.ai/install.ps1 | iex

Vous verrez peut-être encore npm install -g @anthropic-ai/claude-code dans d'anciens guides. Cette méthode est dépréciée : utilisez l'installateur natif pour toute nouvelle installation.

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

bash
cd my-project
claude

Au premier lancement, il vous guide dans l'authentification. Vous pouvez vous connecter avec un compte Claude (les offres Pro, Max, Team et Enterprise incluent l'usage de Claude Code). Vous pouvez aussi utiliser une clé API Anthropic facturée via la Claude Console. Une fois authentifié, vous arrivez dans une session interactive au sein de votre projet.

La boucle agentique, en concret

Imaginez un petit projet Python avec un test en échec. Votre suite affiche :

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

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

Corrige le test en échec 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 lance d'abord des commandes en lecture seule pour s'orienter. Il peut exécuter 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, menée sur vos vrais fichiers et non sur une description que vous auriez tapée. Lire des fichiers et lister des répertoires présente peu de risque : selon vos réglages, ces actions peuvent se faire sans vous interrompre.

Étape 2 : il établit un plan

Claude Code raisonne sur ce qu'il a trouvé. apply_discount multiplie le prix par le taux de remise au lieu de réduire le prix de ce taux. Une remise de 10 % sur un panier de 100 dollars renvoie 10.0 au lieu de 90.0. L'attente du test, 90.0, est correcte : le bug est donc dans le code source.

Pour un travail en plusieurs étapes, il rédige souvent un plan court, parfois sous forme de checklist qu'il coche au fur et à mesure. Vous pouvez lire le plan avant toute modification du code : c'est votre première occasion de le réorienter. Pour les tâches plus importantes, appuyez sur Shift+Tab pour passer en mode plan, où il fait ses recherches et propose un plan sans toucher à aucun fichier.

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

Il veut maintenant modifier cart.py, et la première vraie demande d'autorisation apparaît. Claude Code vous montre un diff avec les lignes exactes qu'il veut supprimer et ajouter. Rien n'est écrit sur le disque tant que vous n'avez pas validé.

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 pouvez accepter, refuser ou réorienter. Ce schéma diff puis validation est ce qui rend l'outil sûr sur du vrai code : aucune modification silencieuse.

Étape 4 : il lance la commande et redemande

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, donc il redemande :

Claude wants to run:
  pytest tests/test_cart.py

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

Vous validez. Les tests tournent. Claude Code lit la sortie, voit que tout est au vert et vous rend compte.

Étape 5 : il boucle et explique

Comme vous l'avez demandé, il résume la correction. La fonction multipliait le prix par le taux au lieu d'appliquer le taux comme une réduction. La correction facture price * (1 - discount_rate), et l'assertion en échec passe désormais. La phase « vérifier le résultat » s'est faite en lançant vos tests, pas sur une supposition de Claude.

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

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

Un agent avec accès au shell reste maîtrisable grâce au système d'autorisations. Comprenez-le et vous utiliserez Claude Code en confiance.

Par défaut, Claude Code classe les actions par niveau de risque. Lire et rechercher 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, et tout ce qui touche au réseau ou qui est destructeur fait l'objet d'une demande à chaque fois.

Vous pouvez ajuster ce comportement. Les options « Yes, and don't ask again » accordent une autorisation permanente pour un outil ou un motif de commande précis, pour ne pas valider vingt fois le même appel inoffensif à pytest. Vous pouvez aussi définir des règles allow et deny dans .claude/settings.json pour qu'elles persistent d'une session à l'autre, et la commande /permissions affiche ce qui est actuellement autorisé.

Pour plus d'autonomie, vous pouvez passer volontairement en mode d'acceptation automatique des modifications. Pour du travail non fiable, lancez Claude Code dans une sandbox ou un conteneur. C'est vous qui réglez la longueur de la laisse, et le réglage par défaut est prudent à dessein.

Claude Code in 20 minutes

Watch on YouTube

Vérification des acquis

1. Quelle est la distinction fondamentale entre l'utilisation de Claude Code et celle des applications de chat Claude ?

2. Comment la leçon décrit-elle la boucle agentique appliquée au développement avec Claude Code ?

3. Pourquoi Claude Code s'arrête-t-il pour demander l'autorisation avant certaines actions ?

CHOIX MULTIPLES

4. Sélectionnez TOUTES les affirmations correctes sur ce qu'est Claude Code et sur son fonctionnement.

Sélectionnez toutes les réponses correctes.

CHOIX MULTIPLES

5. Sélectionnez TOUTES les affirmations correctes sur l'installation et le lancement de Claude Code.

Sélectionnez toutes les réponses correctes.

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 celle des applications et de la Messages API, branchée sur un harnais d'agent de développement. Savoir comment il s'articule avec les autres briques vous aide à choisir le bon outil.

CLAUDE.md : la mémoire persistante du projet

Déposez un fichier nommé CLAUDE.md à la racine de votre projet et Claude Code le lira au début de chaque session. Mettez-y les conventions du projet, la commande de test, des notes d'architecture et les avertissements du type « ne touchez pas à ce répertoire ». Lancez /init et Claude Code en rédigera une première version à partir de votre codebase.

markdown
# 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.

MCP : donner de nouveaux outils à Claude Code

Vous avez déjà rencontré le Model Context Protocol, le standard ouvert qui permet à Claude de dialoguer avec des outils et des sources de données externes. Claude Code est un client MCP. Connectez des serveurs MCP pour lui donner des capacités au-delà des fichiers et du shell : interroger votre base de données, lire votre outil de suivi des tickets ou appeler une API interne. Le site du Model Context Protocol fait référence. Au-delà de MCP, Claude Code prend aussi en charge les subagents, les hooks et les plugins pour packager des workflows sur mesure.

Intégration GitHub

Claude Code s'insère dans votre workflow Git. Il peut créer des branches, rédiger des commits avec des messages pertinents et ouvrir des pull requests. Anthropic propose aussi une intégration GitHub (lancez /install-github-app pour la configurer) : vous pouvez mentionner @claude sur une issue ou une pull request et le laisser proposer des modifications en asynchrone, sans que votre terminal soit ouvert. Découvrez 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 sur lequel il repose est disponible sous le nom 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 voulez un agent interne sur mesure pour trier des logs ou maintenir de la documentation, utilisez le SDK. Claude Code est l'agent de développement prêt à l'emploi ; l'Agent SDK est le kit pour construire le vôtre.

Les bonnes habitudes qui font la différence

Quelques pratiques distinguent les sessions frustrantes des sessions productives.

Donnez-lui un moyen de se vérifier. Une commande de test fonctionnelle compte plus que tout le reste. Quand Claude Code peut lancer des tests, il se corrige lui-même. L'exemple de la remise a fonctionné proprement parce que pytest lui a fourni un signal de vérité terrain. Sans tests, il édite en partie à l'aveugle.

Cadrez vos demandes. « Corrige ce test en échec » est vérifiable et borné. « Refactore tout le système de paiement » appelle un diff tentaculaire que personne ne peut relire. Découpez les gros chantiers en étapes que vous validez une par une, ou commencez en mode plan.

Lisez le plan, puis les diffs. Les demandes d'autorisation sont le moment où votre jugement entre dans la boucle, et parcourir un diff avant de le valider permet de repérer tôt les fausses pistes.

Toute contrainte que vous énoncez à voix haute plus d'une fois a sa place dans CLAUDE.md.

Points clés

  • Installez avec l'installateur natif (curl -fsSL https://claude.ai/install.sh | bash), lancez claude dans un projet et connectez-vous avec une offre Claude ou une clé API. L'installation via npm est dépréciée.
  • Claude Code exécute une vraie boucle agentique sur votre codebase : il explore les fichiers, planifie, édite avec un diff que vous validez, lance des commandes que vous validez et vérifie en exécutant vos tests.
  • Le système d'autorisations est le modèle de sécurité. Vous réglez la longueur de la laisse avec les règles allow et deny, les autorisations « don't ask again » et des modes comme le mode plan.
  • Un CLAUDE.md contenant votre commande de test, vos conventions et les répertoires interdits donne à l'agent un contexte durable d'une session à l'autre.
  • Étendez-le avec des serveurs MCP et l'intégration GitHub, et utilisez le Claude Agent SDK quand vous voulez construire votre propre agent sur le même harnais.

À faire, tiré de cette leçon

Ces actions sont compilées dans le plan d'action du rôle.

  • Ajoutez un CLAUDE.md avec la commande de test, les conventions et les répertoires interdits
Voir le plan d'action complet →

Articles liés

Les articles récents du blog qui s'appuient sur cette leçon.