Claude Code : le guide de démarrage honnête, en français

Claude Code est l'agent en ligne de commande d'Anthropic : un outil qui lit votre code, écrit des modifications et exécute des commandes, directement dans votre terminal. Nous l'utilisons quotidiennement à l'agence ; voici le tutoriel de démarrage honnête, en français, que nous aurions aimé lire avant de nous lancer.

Il y a les outils qui suggèrent la fin de votre ligne de code, et il y a Claude Code. La différence mérite d'être posée d'emblée, parce qu'elle conditionne tout le reste : la façon de l'installer, de lui parler, de le surveiller. Ce guide s'adresse aux développeurs et aux équipes qui veulent l'essayer sérieusement, sans se raconter d'histoires, ni sur ses capacités, ni sur ses limites.

Claude Code est un agent de développement en ligne de commande : un programme qui tourne dans votre terminal, auquel vous confiez une tâche en langage naturel, et qui travaille. Il explore votre projet, lit les fichiers pertinents, propose des modifications, lance vos tests, exécute des commandes. Vous décrivez l'intention, il mène l'enquête et produit un diff. Rien à voir avec une extension qui complète vos phrases pendant que vous tapez : c'est ce qu'on appelle un agent, et le mot n'a rien d'un artifice marketing.

Conséquence appréciable : comme il vit dans le terminal, il fonctionne avec n'importe quel éditeur (une extension VS Code existe aussi depuis la version 2.0 de septembre, mais elle reste optionnelle). Sous le capot, il s'appuie sur les modèles d'Anthropic : Claude Sonnet 4.5 par défaut depuis sa sortie fin septembre, Haiku 4.5 plus rapide et moins coûteux pour les tâches simples, et Opus 4.1 accessible sur les formules supérieures.

Pour installer Claude Code, le chemin le plus courant passe par npm (Node.js 18 ou plus récent) ; un installeur natif sans dépendance Node existe également. Trois lignes suffisent :

Au premier lancement, l'outil vous demande de vous authentifier : soit avec votre compte Claude si vous avez un abonnement, soit avec une clé API créée sur la console d'Anthropic. Vous voilà face à une invite de commande conversationnelle, dans votre projet. Résistez à l'envie de lui demander tout de suite une refonte complète : les trois réflexes qui suivent feront la différence entre un essai concluant et un abandon agacé.

Tapez /init dès la première session. Claude Code explore alors votre dépôt et génère un fichier CLAUDE.md à la racine : architecture du projet, commandes de build et de test, conventions de code. Ce fichier est relu au début de chaque session ; c'est la mémoire de l'outil, et le meilleur levier pour améliorer ses réponses. Relisez ce qu'il a généré, corrigez, ajoutez vos règles maison (« ne jamais commiter sans demande explicite » est un bon début), puis versionnez-le : toute l'équipe en profite, et le fichier s'enrichit au fil des semaines comme n'importe quelle documentation vivante.

Une session, une tâche. La tentation est grande de garder la même conversation ouverte toute la journée ; c'est la recette de la dérive. Plus le contexte accumulé est long, plus le modèle se disperse et mélange les sujets. Formulez une mission précise (« corrige le bug d'affichage du panier décrit dans ce ticket », plutôt que « améliore le panier »), laissez-le la terminer, relisez, puis repartez de zéro avec /clear. Ce découpage paraît contraignant ; il est en réalité la même hygiène que des commits atomiques, et il produit le même effet : un travail traçable et réversible.

Traitez Claude Code comme un développeur talentueux, rapide et étourdi qui viendrait d'arriver dans l'équipe : rien de ce qu'il produit n'entre dans la base de code sans relecture. L'outil vous montre chaque modification sous forme de diff avant de l'appliquer : lisez-les vraiment. Git reste votre filet de sécurité principal, complété depuis la version 2.0 par des points de restauration internes (la commande /rewind permet de revenir en arrière sur les modifications d'une session). Un filet n'a jamais dispensé de regarder où l'on met les pieds.

Par défaut, Claude Code lit librement mais demande votre accord avant de modifier un fichier ou d'exécuter une commande. Cette friction est volontaire : un agent qui peut lancer rm ou git push n'est pas un jouet, et Anthropic a choisi de vous laisser la main à chaque action qui engage. Au fil des sessions, vous pouvez assouplir ce cadre intelligemment : autoriser durablement les commandes inoffensives que vous approuvez dix fois par jour (via la commande /permissions ou le fichier de configuration du projet), activer l'acceptation automatique des éditions de fichiers quand la tâche est bien bornée, ou au contraire passer en mode plan, où l'agent propose une stratégie sans rien toucher.

Il existe aussi une option qui désactive tous les garde-fous. Son nom commence par --dangerously, et ce préfixe dit tout : elle n'a de sens que dans un environnement isolé et jetable (un conteneur sans accès à vos secrets), jamais sur votre machine de travail. La bonne trajectoire est progressive : tout valider la première semaine, puis n'automatiser que ce que vous avez vu faire correctement, commande par commande.

Deux voies, à l'heure où nous écrivons. La première : les abonnements Claude, qui incluent l'accès à Claude Code. La formule Pro (environ 20 dollars par mois) suffit pour découvrir l'outil et couvrir un usage régulier mais mesuré ; les formules Max (100 ou 200 dollars par mois) s'adressent à ceux qui codent avec toute la journée. Les quotas fonctionnent par fenêtres glissantes de cinq heures, complétées par des plafonds hebdomadaires : un usage intensif sur Pro atteint la limite, c'est le signal qu'il faut monter de formule. La seconde voie : la facturation API à la consommation, sans abonnement, adaptée aux essais ponctuels et à l'intégration en entreprise ; comptez alors quelques dollars pour une journée de travail soutenue, davantage sur de gros dépôts. Notre conseil pour débuter : l'abonnement Pro, qui borne la dépense et enlève l'angoisse du compteur.

Un mot sur la suite, sans vous y précipiter : l'outil s'étend via des commandes slash personnalisées, des hooks (scripts déclenchés automatiquement avant ou après ses actions), le protocole MCP pour le connecter à vos services, des sous-agents spécialisés, et des « skills », tout juste lancées à la mi-octobre. Rien de tout cela n'est nécessaire le premier mois.

• Il se trompe avec assurance. Claude Code produit du code faux avec le même aplomb que du code juste : une API inventée, un cas limite oublié, un test qui passe pour de mauvaises raisons. Aucun signal ne distingue ses réussites de ses erreurs ; seule votre relecture le fait.
• Le contexte n'est pas infini. La fenêtre de travail se compte en centaines de milliers de tokens, ce qui est beaucoup et pourtant vite rempli sur un vrai projet. Passé un certain seuil, la qualité se dégrade avant que l'outil ne s'arrête : c'est une raison de plus de travailler en sessions courtes.
• La relecture reste votre métier. L'agent déplace l'effort, il ne le supprime pas : vous écrivez moins, vous relisez plus. Ce qui part en production sous votre nom reste sous votre responsabilité, et aucune formule d'abonnement ne change cela.

Choisissez un vrai ticket de votre backlog, ni trivial ni critique : un bug reproductible, une petite fonctionnalité bien décrite. Installez l'outil, lancez /init, confiez-lui la tâche, relisez le diff comme vous relireriez celui d'un collègue. Recommencez pendant une semaine. Au bout de ce délai, vous saurez deux choses : ce que l'agent fait mieux et plus vite que vous, et ce que vous ne lui confierez pas encore. Ces deux listes bougeront dans les mois qui viennent, probablement plus vite qu'on ne le croit ; l'important est d'avoir commencé à les tenir. C'est exactement ce que nous faisons de notre côté, et nous reviendrons ici, chiffres en main, raconter ce que cela change dans une agence comme la nôtre.