Dans le chapitre précédent, nous avons réparti les outils de codage par IA en trois catégories, et choisi Claude Code — celui auquel on peut confier une large part de l'implémentation — comme fil conducteur de ce cours. Dans ce chapitre, on passe enfin à la pratique. Nous allons suivre pas à pas l'enchaînement installation → lancement → connexion → première instruction → validation des modifications, en nous attardant sur chaque point où l'on risque de trébucher, jusqu'à voir Claude Code s'animer dans votre propre terminal.
L'objectif : « confier une première tâche à Claude Code dans votre propre environnement »
Qu'est-ce que Claude Code (rappel du chapitre précédent)
Pour le redire en une phrase : Claude Code est un « agent en ligne de commande » signé Anthropic. Plutôt que de copier-coller du code dans un chat de navigateur, il lit directement les fichiers de votre projet, les modifie, exécute des commandes et lance les tests, le tout au sein de votre terminal. Il vous suffit de dire « voici ce que je veux » en langage naturel : l'IA établit elle-même un plan et mène le travail à bien à travers plusieurs fichiers. C'est, au sens propre, un coéquipier assis à côté de vous qui met la main à la pâte.
📖 Deux sources officielles à lire en premier. Les étapes de ce chapitre sont un repère pour débuter. Pour les prérequis système exacts, la méthode d'installation à jour et les formules tarifaires, vérifiez toujours à la source — mettez en favori la documentation officielle code.claude.com/docs et la page produit anthropic.com/claude-code : ces deux liens vous serviront durablement.
L'installer — Installation
Claude Code s'installe et fonctionne dans un environnement Node.js. Rien de compliqué à préparer. Réunissons d'abord les deux prérequis.
Le socle qui fait tourner Claude Code. Si vous ne l'avez pas encore, installez la version LTS depuis le site officiel nodejs.org. Pour vérifier qu'il est déjà présent, node -v doit afficher un numéro de version.
L'écran où l'on tape des commandes. Sur macOS, l'app « Terminal » ; sur Windows, « PowerShell » ou WSL ; sur Linux, le terminal standard. Savoir faire les manipulations de base vues au chapitre précédent suffit largement.
Une fois prêt, tapez la commande suivante en une ligne dans le terminal. Il s'agit simplement d'installer Claude Code de façon accessible sur tout le système, à l'aide de npm (le gestionnaire de paquets fourni avec Node.js).
npm install -g @anthropic-ai/claude-code
-g signifie « installer globalement (c'est-à-dire de manière appelable depuis n'importe quel dossier) ». Une fois l'installation terminée, lancez-le avec la commande suivante.
claude
⚠️ Si le message claude: command not found apparaît. L'installation a réussi, mais la commande n'est pas reconnue — c'est l'un des premiers écueils classiques pour les débutants. C'est le plus souvent un problème de configuration du PATH de Node.js/npm, et la solution est connue. L'article « command not found / erreur d'installation » rassemble les correctifs par système d'exploitation.
Les prérequis système détaillés, les procédures recommandées par OS et les méthodes d'installation alternatives varient selon l'environnement. Pour l'information exacte et la plus récente, consultez impérativement la documentation officielle code.claude.com/docs.
Premier lancement et connexion
Au tout premier lancement avec claude, on vous demande de vous connecter (vous authentifier) avec un compte Anthropic. Il suffit de suivre les indications à l'écran : le plus souvent, un navigateur s'ouvre, vous vous y connectez, l'authentification se termine et vous revenez au terminal.
Tapez claude dans le terminal. La première fois, un écran de choix de la méthode de connexion s'affiche.
Suivez les indications pour vous connecter à votre compte Anthropic dans le navigateur. Une fois l'accès autorisé, l'authentification passe.
De retour dans le terminal, un écran vous invite à saisir votre demande. C'est le point d'entrée du dialogue. Vient ensuite la première instruction.
Pour la connexion, il existe la méthode via un abonnement Claude couvrant la formule concernée, et la méthode via une clé API. Comme ce qui est utilisable et la façon dont les coûts s'appliquent dépendent de la formule, nous n'affirmons rien de définitif ici. Vérifiez dans la documentation officielle la méthode adaptée à votre contrat.
🔑 Si vous n'arrivez pas à vous connecter ou qu'une erreur d'authentification apparaît. Le navigateur ne s'ouvre pas, le code collé est rejeté, la procédure se bloque en cours de route — l'authentification fait aussi partie des écueils classiques. L'article « erreur de connexion / d'authentification » rassemble les solutions selon la cause. Si cela ne résout toujours rien, voyez aussi le chapitre 5 « Se sortir des blocages », qui traite les blocages de façon méthodique.
Donner sa première instruction — La boucle de base
L'authentification faite, on passe aux choses sérieuses. Le point crucial d'abord : lancez Claude Code depuis l'intérieur du dossier du projet sur lequel vous voulez travailler. Claude Code prend « le dossier courant » pour cible de travail ; se tromper ici reviendrait à modifier un autre endroit.
cd my-project
claude
Ensuite, il suffit de dire directement, en langage naturel, ce que vous voulez. « Lis le README et explique-moi ce que fait ce projet », « Ajoute un formulaire de contact sur la page d'accueil » : vous demandez avec des mots ordinaires. À partir de là, les quatre étapes suivantes forment une boucle de base que l'on répète encore et encore.
Exprimez ce que vous voulez en langage naturel. Plus c'est précis que vague, plus le résultat colle à votre intention.
L'IA lit les fichiers concernés, prévoit quoi changer et comment, puis se met à l'œuvre.
Les lignes à modifier et leur nouvelle version s'affichent sous forme de diff (modifications). En vert les ajouts, en rouge les suppressions.
Si le contenu vous convient, validez pour l'appliquer. Sinon, refusez, expliquez la correction avec des mots et relancez.
Le point clé, c'est la « vérification des modifications » de la BOUCLE 3. Avant de réécrire un fichier, Claude Code vous montre d'abord un diff du type « voici ce que je vais changer ici » et attend votre validation avant d'appliquer. C'est là que le rôle de l'humain intervient : lire le contenu et juger s'il correspond à l'intention. Comme évoqué au chapitre précédent, votre travail consiste à lire le code produit et à en apprécier la qualité.
✅ Commencez par « petit et vérifiable ». Ne demandez pas d'emblée une refonte massive ; habituez-vous avec de petites demandes dont vous pouvez constater le résultat de vos yeux : « explique-moi ce fichier », « ajoute une petite fonction »… Une fois que ça marche, élargissez peu à peu ce que vous déléguez — c'est l'astuce pour ne pas faire de détours.
La manière de formuler elle-même (choisir entre le « vibe coding », où l'on délègue grosso modo, et le « développement piloté par les spécifications », où l'on fige d'abord le cahier des charges) est approfondie en détail au chapitre 4 « Bien formuler ses demandes ». Pour l'instant, savoir faire tourner cette boucle en quatre étapes suffit amplement.
Les bases des modes de permission — Déléguer en toute sécurité
« Et si l'IA supprimait des fichiers de son propre chef ou exécutait des commandes dangereuses ? » — l'inquiétude est légitime. Claude Code est justement conçu pour cela : il intercale systématiquement une confirmation avant toute opération à impact, comme l'édition d'un fichier ou l'exécution d'une commande. C'est ce qu'on appelle les modes de permission.
Le comportement se décline en plusieurs niveaux. Contentons-nous ici d'en saisir l'idée générale.
Demande une confirmation à chaque édition ou exécution de commande. On valide une opération à la fois : c'est le plus sûr. Commencez par là pour prendre vos marques.
Sans rien modifier réellement, il fait établir uniquement le plan de « ce qui va être fait ». Pratique quand on veut fixer une approche avant un gros chantier.
Il supprime les confirmations à répétition et fait avancer automatiquement un certain périmètre d'opérations. C'est rapide, mais comme on regarde le contenu moins souvent, restez prudent.
Un mode puissant qui saute toutes les confirmations avant d'exécuter. Mieux vaut l'éviter quand on débute. Voir la mise en garde ci-dessous pour ses cas d'usage et ses dangers.
💡 « Les confirmations me lassent, je contourne tout » : à proscrire. Le mode qui saute toutes les confirmations est puissant, mais en contrepartie il ne peut plus empêcher une suppression ou une commande non désirée. Si vous voulez de la vitesse sans sacrifier la sécurité, la bonne méthode n'est pas de basculer d'emblée en contournement, mais de mettre d'abord en place des règles de permission n'autorisant que les opérations de confiance. Il existe aussi l'option du « bac à sable » (sandbox), qui isole le travail pour l'exécuter sans risque.
Ici, il suffit de retenir que « Claude Code ne dérape pas de lui-même : il intercale des confirmations » et que « ce comportement s'ajuste via les modes ». Pour aller plus loin, des articles et guides dédiés approfondissent le sujet.
Les différences entre modes et la façon de basculer, dans Les modes de permission expliqués en détail.
Comment écrire les règles d'autorisation et de refus, dans Règles de permission et configuration.
Le principe du bac à sable, dans Introduction au sandboxing.
Les bases de CLAUDE.md et de la configuration
À force d'utiliser Claude Code, on finit par trouver fastidieux de « répéter les mêmes consignes à chaque fois ». « Indente avec deux espaces », « Ne touche pas à ce dossier », « Réponds en français » — redemander ces règles communes au projet à chaque coup est inefficace.
C'est là qu'entre en scène CLAUDE.md. Placez un fichier de ce nom à la racine du projet : Claude Code le charge automatiquement au démarrage et travaille en tenant compte des règles qui y figurent. C'est en quelque sorte le « mode d'emploi de ce projet » que vous remettez à votre coéquipier.
# À propos de ce projet
- Langage : TypeScript / Framework : Next.js
- Rédiger les réponses et les commentaires en français
- Indenter avec deux espaces
- Ne pas toucher à src/legacy/ ni à son contenu
- Passer npm run lint avant chaque commit
L'important est d'écrire « court, concret, et seulement ce que vous tenez vraiment à faire respecter ». Trop long ou trop vague, et les règles sont paradoxalement moins suivies. Commencez par quelques lignes, puis ajoutez au fil de l'eau ce que vous vous surprenez à « répéter à chaque fois » : c'est la bonne façon de le faire mûrir.
💡 Vous l'avez écrit dans CLAUDE.md, mais il ne le respecte pas ? Les cas fréquents : trop de règles, des règles trop abstraites, ou contradictoires. Les causes et les remèdes sont réunis dans l'article « Quand les règles de CLAUDE.md restent lettre morte ». Connaître « les astuces pour les rendre efficaces » stabilise nettement la précision de l'IA.
La configuration ne se limite pas à CLAUDE.md. Les règles de permission évoquées plus haut, le choix du modèle et divers comportements se règlent finement dans des fichiers de configuration — mais cela viendra en son temps. Rien que « quelques lignes de règles de projet dans CLAUDE.md » et le ressenti change déjà.
- Claude Code est un agent en ligne de commande signé Anthropic. On l'installe dans un environnement Node.js avec
npm install -g @anthropic-ai/claude-code, et on le lance avecclaude. - La première fois, connexion (authentification) avec un compte Anthropic. En cas de blocage, direction les articles command not found / erreur d'authentification.
- Le principe : la boucle demander → planifier → vérifier les modifications (diff) → valider. Lire le diff et en juger la qualité, c'est le travail de l'humain.
- Les modes de permission empêchent les dérapages. Quand on débute, éviter le contournement et élargir le périmètre délégué en gardant l'œil.
- Écrire quelques lignes de règles de projet dans CLAUDE.md aide l'IA à mieux s'y conformer.
Voilà : Claude Code tourne désormais dans votre terminal et vous pouvez lui confier une première tâche. Au chapitre 3 « Comparer les outils et les utiliser à bon escient », nous ferons le point sur ses différences avec des compagnons comme Cursor, GitHub Copilot et Codex, et apprendrons à choisir selon la situation.