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 :
curl -fsSL https://claude.ai/install.sh | bashSous Windows PowerShell :
irm https://claude.ai/install.ps1 | iexVous 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 :
cd my-project
claudeAu 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é 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 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.0Vous 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 differentlyVous pouvez accepter, refuser ou ré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 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
NoVous 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
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 ?
4. Sélectionnez TOUTES les affirmations correctes sur ce qu'est Claude Code et sur son fonctionnement.
Sélectionnez toutes les réponses correctes.
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.
# 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 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 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, 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), lancezclaudedans 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.mdcontenant 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
Articles liés
Les articles récents du blog qui s'appuient sur cette leçon.
- IA600 millions de raisons de comprendre d'où vient le vibe codingLovable dépasse 600 millions de dollars de revenus annualisés et ses applications totalisent près d'un milliard de vues mensuelles. Pour comprendre ce que cela signifie vraiment, il faut remonter à l'époque où écrire du code était le seul moyen de construire un logiciel.
- IALe vibe coding pour non-développeurs : ce que la tendance cache vraimentLes assistants de code comme GitHub Copilot, Cursor ou Claude permettent aujourd'hui à des professionnels sans formation technique de produire des scripts, des applications légères et des automatisations fonctionnelles. Mais l'enthousiasme autour du "vibe coding" masque des limites structurelles que tout manager devrait comprendre avant de réorganiser son équipe en conséquence.