Claude Code : démarrer en 15 minutes (tutoriel)
Guide complet pour installer et utiliser Claude Code, l'outil CLI d'Anthropic pour développeurs. Installation, premières commandes, cas d'usage.
Claude Code, c’est l’assistant de code d’Anthropic qui tourne directement dans ton terminal. Pas de plugin VS Code obligatoire, pas d’interface web à ouvrir dans un énième onglet — juste une commande, claude, et ton projet qu’il comprend vraiment. Lancé en février 2025 en research preview, puis passé GA en mai 2025 au moment de la sortie de Claude 4, il est devenu en quelques mois l’outil préféré d’une bonne partie des devs qui bossent avec l’IA. Ce guide te fait passer de zéro à productif en un quart d’heure.
Avant d’entrer dans le dur : Claude Code n’est pas un simple autocomplete. C’est un agent qui lit ton code, exécute des commandes, édite plusieurs fichiers en parallèle, lance tes tests et itère jusqu’à ce que ça passe. Si tu viens de Copilot ou Cursor, le changement mental est réel.
Qu’est-ce que Claude Code, concrètement ?
Claude Code est un CLI agentique propulsé par les modèles Claude. Depuis les sorties de février 2026 (Opus 4.6 le 5 février, Sonnet 4.6 le 17 février), Sonnet 4.6 est le modèle par défaut sur les plans Pro et Team Standard, tandis que Max et Team Premium démarrent sur Opus 4.6. Il lit ton repo, édite tes fichiers, exécute du bash, commit, push, ouvre des PRs. Tu lui parles en langage naturel, il fait le boulot.
La différence avec Cursor ou Copilot ? Cursor est un fork de VS Code qui bundle un chat IA dans l’éditeur. Copilot est un autocomplete sur stéroïdes intégré à ton IDE. Claude Code vit dans ton terminal et fonctionne comme un vrai collaborateur junior-senior : tu lui confies une tâche, il disparaît quelques minutes, il revient avec un diff.
Côté adoption, Anthropic a communiqué en début 2026 sur une forte traction de Claude Code, avec un run-rate produit estimé à plusieurs milliards de dollars — signe que l’outil est bien au-delà de la phase expérimentale.
Installation en 2 minutes
Un seul prérequis : Node.js 18+. Pour tout le reste, une ligne suffit.
Via npm (la méthode universelle)
npm install -g @anthropic-ai/claude-codePuis tu lances :
cd mon-projet
claudeAu premier lancement, Claude te demande de t’authentifier. Tu choisis entre ton compte Claude.ai (si tu as un plan Pro ou Max) ou une clé API Anthropic. Un navigateur s’ouvre, tu valides, c’est réglé.
Via Homebrew (macOS / Linux)
brew install --cask claude-codeMise à jour
claude updateOu, si tu l’as installé via npm :
npm update -g @anthropic-ai/claude-codeVérifier que tout roule
claude --version
claude doctorclaude doctor vérifie ta config, ta connexion, tes permissions fichiers. À faire dès qu’un truc paraît cassé.
Les premières commandes à connaître
Une fois dans une session claude, tu tapes en langage naturel. Mais il y a aussi des slash commands très utiles.
Slash commands essentiels
| Commande | Usage |
|---|---|
/init | Crée un fichier CLAUDE.md avec le contexte de ton projet |
/clear | Vide le contexte de la session (utile entre deux tâches) |
/compact | Compresse la conversation pour gagner du contexte |
/model | Change de modèle (Opus, Sonnet, Haiku) |
/cost | Affiche ce que tu as consommé dans la session |
/review | Lance une review de code sur les changements en cours |
/pr | Crée une pull request GitHub |
/resume | Reprend une session précédente |
Le fichier CLAUDE.md
C’est la feature que tout le monde sous-estime au début. Tu lances /init à la racine de ton projet, Claude scanne ton code et génère un CLAUDE.md qui résume ta stack, tes conventions, tes commandes. Ce fichier est lu à chaque session — plus besoin de réexpliquer à chaque fois que tu utilises Astro 6 ou que tes tests tournent avec pnpm test:unit.
Tu peux aussi ajouter à la main des règles perso : conventions de nommage, fichiers à ne pas toucher, outils à préférer.
Modes d’exécution
Par défaut, Claude demande confirmation avant d’écrire un fichier ou de lancer une commande. Si tu veux le laisser galoper tout seul :
claude --dangerously-skip-permissionsNom volontairement flippant. À réserver à des sandboxes (Docker, VM, devcontainers). Pour un usage semi-auto plus raisonnable, il y a aussi le flag --auto-accept-edits qui valide les edits mais bloque toujours les commandes shell.
Trois cas d’usage concrets
Cas 1 : refactoring multi-fichiers
C’est là que Claude Code écrase Copilot. Exemple classique : tu veux renommer une prop variant en type partout dans ton app React.
> Renomme la prop "variant" en "type" dans tous les composants Button,
> ainsi que dans les appelants. Lance les tests après pour vérifier.Claude va :
- Faire un
grepsur ton codebase pour trouver toutes les occurrences - Éditer les fichiers concernés (parfois 30 ou 40 d’un coup)
- Lancer
npm test - Si un test casse, lire l’erreur, corriger, relancer
Temps gagné sur un refactor de 2000 lignes : facilement 2 à 3 heures.
Cas 2 : debugging d’une erreur obscure
Tu as un stack trace imbitable, un bug de prod qui ne se reproduit qu’en staging. Tu colles l’erreur dans Claude :
> J'ai cette erreur en prod : "Cannot read properties of undefined (reading 'map')"
> dans OrderList.tsx:47. Investigue et propose un fix.Claude ouvre OrderList.tsx, remonte la chaîne d’appels, identifie que l’API peut renvoyer null au lieu d’un tableau vide, ajoute un guard, et te propose un test qui reproduit le cas.
Cas 3 : générer des tests
Les tests, personne n’aime en écrire. Claude, si.
> Écris des tests Vitest pour la fonction formatPrice dans utils/currency.ts.
> Couvre les cas : nombres négatifs, zéro, très grandes valeurs, devises
> différentes, et les inputs invalides (null, undefined, string).Tu obtiens un fichier de tests complet, avec les edge cases auxquels tu n’aurais pas pensé. Selon GitHub Octoverse (octobre 2025), la vélocité de développement explose avec l’IA — 43,2 millions de pull requests fusionnées en moyenne par mois (+23 % sur un an) et près d’un milliard de commits en 2025 — et les pratiques de test automatisées deviennent indispensables pour tenir ce rythme.
Tips et raccourcis utiles
Enchaîner plusieurs prompts d’un coup
Tu peux passer une instruction directe sans entrer en mode interactif :
claude -p "Ajoute un endpoint GET /api/health qui renvoie {status: 'ok'}"Parfait pour les scripts, les hooks git ou les CI.
Reprendre une session
claude --resumeListe tes sessions précédentes, tu choisis, tu repars là où tu t’étais arrêté avec tout le contexte.
Connecter des MCP servers
Claude Code supporte le Model Context Protocol (MCP), le standard ouvert qu’Anthropic a introduit en novembre 2024 et donné en décembre 2025 à l’Agentic AI Foundation (hébergée par la Linux Foundation). Tu peux lui brancher GitHub, Linear, Notion, Sentry, ta base Postgres — il interagit avec eux nativement.
claude mcp add github
claude mcp add postgres --connection-string "postgres://..."Une fois branché, tu peux dire : “Regarde les 5 derniers issues GitHub ouverts et propose un plan d’action.” Et ça marche.
Hooks et automation
Tu peux configurer des hooks dans .claude/settings.json qui s’exécutent avant/après certaines actions (par exemple, lancer prettier après chaque édition de fichier). Combiné avec --auto-accept-edits, ça transforme Claude Code en vraie chaîne d’assemblage.
Le mode “plan”
Tape Shift+Tab pendant une session pour entrer en plan mode : Claude réfléchit, détaille sa stratégie, mais n’exécute rien tant que tu n’as pas validé. Indispensable sur les tâches sensibles.
Prix et plans
Claude Code est inclus dans les abonnements Claude grand public, sans surcoût :
- Claude Pro (20 $/mois) — usage modéré, suffisant pour un dev solo qui code quelques heures par jour
- Claude Max 5× (100 $/mois) — 5x les limites du Pro, pour un usage intensif
- Claude Max 20× (200 $/mois) — pour les devs qui vivent dans leur terminal
- API Anthropic — facturation au token, utile pour l’équipe ou la CI
Dans la pratique, une grande partie des devs solo préfèrent passer par un plan Pro ou Max plutôt que par l’API directe : la prédictibilité mensuelle l’emporte sur le pay-as-you-go, surtout quand les sessions agentiques consomment beaucoup de tokens.
Côté équipe, il existe un plan Team (30 $/utilisateur/mois en annuel) avec gestion centralisée des accès, et un plan Enterprise avec SSO, audit logs et contrôle des données.
Limites et alternatives
Claude Code n’est pas magique. Quelques points d’attention :
- Long contexte, long coût : sur un gros repo, une session peut brûler vite. Utilise
/compactrégulièrement. - Pas infaillible : il hallucine parfois des APIs, surtout sur des libs très récentes. Relis toujours les diffs critiques.
- Lock-in modéré : tes
CLAUDE.mdet hooks sont portables, mais l’intégration MCP crée quand même un attachement. - Pas d’UI visuelle native : pour les devs front qui veulent voir le rendu live, Cursor garde un avantage.
Les alternatives sérieuses en 2026
| Outil | Force | Faiblesse |
|---|---|---|
| Cursor | IDE complet, UI soignée, multi-modèles | Moins puissant en mode agent long |
| GitHub Copilot Workspace | Intégration GitHub native | Moins autonome, plus centré autocomplete |
| Aider | Open source, multi-modèles, gratuit (BYO key) | Moins poli, plus brut |
| Codex CLI (OpenAI) | Similaire à Claude Code, propulsé par GPT-5 | Jeune, écosystème MCP plus limité |
Pour un dev solo qui veut le setup le plus rapide et les meilleurs résultats sur un repo existant, Claude Code reste le choix par défaut début 2026. Pour une équipe qui vit dans VS Code, Cursor + Claude Code en complément est une combinaison gagnante : Cursor pour la navigation et l’autocomplete, Claude Code pour les grosses tâches agentiques.
En résumé
Installe, tape /init, commence à parler en langage naturel. En 15 minutes, tu as un agent qui connaît ton projet, qui respecte tes conventions, et qui fait le sale boulot pendant que tu réfléchis au problème suivant. Le plus dur, au début, c’est d’accepter de lâcher le clavier et de laisser l’outil bosser.
Un dernier conseil : commence par des tâches bien cadrées (une fonction, un bug, un refactor localisé) avant de lui confier des features entières. Tu apprendras vite où il brille et où il faut garder la main.
Sources : documentation officielle Claude Code (code.claude.com/docs, 2026) ; page npm @anthropic-ai/claude-code (npmjs.com) ; Anthropic, « Introducing the Model Context Protocol » (anthropic.com/news/model-context-protocol, novembre 2024) et « Donating the Model Context Protocol » (anthropic.com, décembre 2025) ; Claude API Docs, « What’s new in Claude 4.6 » (platform.claude.com, février 2026) ; GitHub Blog, « What 986 million code pushes say about the developer workflow in 2025 » (Octoverse, octobre 2025) ; page officielle Claude Pricing (claude.com/pricing).