Claude Code est l’outil CLI agentique d’Anthropic. Il permet de programmer en langage naturel (vibe coding) avec un assistant capable de lire votre repo, d’éditer plusieurs fichiers, d’exécuter des tests et d’itérer jusqu’à un résultat fonctionnel. Ce tutoriel détaille l’installation et les premières heures d’utilisation.

Prérequis

• Node.js 20 ou supérieur (vérifier avec node --version)
• Un compte Anthropic actif (Claude Pro, Max, Team ou Enterprise — ou crédits API)
• Un terminal (Terminal sur macOS, Windows Terminal, n’importe quelle distrib Linux)
• Git installé pour cloner / suivre des repos

Installation

macOS

1. Ouvrir Terminal
2. Installer Homebrew si absent : /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. Installer Node : brew install node
4. Installer Claude Code : npm install -g @anthropic-ai/claude-code
5. Vérifier : claude --version

Windows

1. Installer Node.js depuis nodejs.org (LTS)
2. Ouvrir Windows Terminal ou PowerShell
3. Installer Claude Code : npm install -g @anthropic-ai/claude-code
4. Vérifier : claude --version
5. Sur Windows, lancer Claude Code depuis WSL2 (Ubuntu) est généralement plus stable pour les workflows scripts.

Linux

1. Installer Node 20+ via nvm ou le package manager de votre distrib
2. Installer Claude Code : npm install -g @anthropic-ai/claude-code
3. Vérifier : claude --version

Première connexion

1. Lancer claude dans n’importe quel dossier
2. Au premier lancement, Claude Code ouvre une page web pour s’authentifier
3. Choisir : se connecter avec son plan Claude (Pro / Max / Team) ou avec une clé API Console
4. Une fois authentifié, retour au terminal — vous êtes prêt

Premier projet : modifier un repo existant

Pour ressentir la puissance de Claude Code, le mieux est de le lancer sur un repo existant et de lui demander une modification réaliste.

1. cd ~/projets/mon-projet
2. claude
3. Tapez : « Lis le README et résume le projet en 3 phrases »
4. Claude lit, propose son résumé. Vous validez ou redirigez.
5. Tapez : « Ajoute un endpoint /api/health qui renvoie {ok: true}. Écris un test associé. »
6. Claude planifie, édite les fichiers concernés, lance le test. Vous regardez les diffs proposés et acceptez.

L’expérience clé : vous décrivez l’intention en français, Claude exécute. Vous gardez le contrôle via les diffs, les revues et les commits.

Les slash commands utiles à connaître

Les slash commands sont des raccourcis tapés dans l’interface Claude Code (/ au début d’une ligne).

• /help — la liste des commandes disponibles
• /clear — réinitialiser le contexte de la conversation
• /init — générer un fichier CLAUDE.md qui décrit le projet pour orienter les futures sessions
• /review — lancer une revue automatique du code modifié
• /cost — voir le coût en tokens et en € de la session
• /agents — lister et gérer les sub-agents disponibles
• /mcp — lister et configurer les serveurs MCP

Vous pouvez aussi créer vos propres slash commands custom dans ~/.claude/commands/ ou par projet dans .claude/commands/.

MCP servers : étendre Claude Code

MCP (Model Context Protocol) est un protocole d’intégration qui permet à Claude Code de se connecter à des outils externes : Sentry, Linear, GitHub, Slack, Filesystem, base de données, navigateur… L’écosystème compte plusieurs centaines de serveurs MCP officiels et communautaires.

Exemple : ajouter un MCP filesystem pour permettre à Claude d’accéder à un dossier hors du repo courant :

1. claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents
2. Relancer Claude Code
3. Claude peut désormais lire et écrire dans ~/Documents

Pour aller plus loin, voir la doc officielle Anthropic et tester progressivement les MCP les plus populaires (GitHub, Linear, Sentry).

Sub-agents : spécialiser Claude pour des tâches récurrentes

Les sub-agents sont des assistants Claude spécialisés que vous configurez avec un prompt système, des outils restreints et un domaine d’expertise. Exemples typiques :

• code-reviewer — revue critique avant commit
• test-writer — génération de tests unitaires/intégration
• docs-writer — rédaction de docstrings et README
• migration-helper — assistance migration framework / langage

Un sub-agent se définit dans .claude/agents/<nom>.md avec une frontmatter qui précise son nom, sa description, ses outils autorisés et son modèle. La documentation interne du projet (CLAUDE.md) lui sert de contexte par défaut.

Bonnes pratiques pour démarrer

• Toujours commencer par un /init sur un nouveau projet pour générer un CLAUDE.md descriptif
• Faire des sessions courtes (15-30 min) plutôt qu’une session marathon — le contexte reste plus propre
• Reviewer chaque diff avant d’accepter, surtout les premiers temps
• Documenter dans CLAUDE.md les conventions importantes du projet (style, sécurité, libs interdites…)
• Utiliser /cost régulièrement pour calibrer la consommation
• Versionner CLAUDE.md et .claude/ dans git pour partager la conf en équipe

Pour aller plus loin

• Qu’est-ce que le vibe coding — pour comprendre la méthode globale
• Comparatif des outils de vibe coding 2026 — pour situer Claude Code dans l’écosystème
• Claude vs ChatGPT vs Gemini — pour choisir le bon modèle selon le cas d’usage
• Formation Claude Code Mill-Forma — pour une montée en compétence accompagnée

FAQ — Claude Code

Claude Code est-il gratuit ?

Le binaire CLI est gratuit. L’usage requiert un plan Anthropic (Claude Pro 20€/mois, Max 100€-200€/mois) ou des crédits API. Le plan Pro absorbe la majorité des usages personnels ; les Max sont conçus pour les sessions intensives.

Quelle différence entre Claude Code et Cursor ?

Claude Code est un CLI agentique pur (pas d’IDE intégré), focalisé sur les sessions terminal et la scriptabilité. Cursor est un IDE forké de VS Code avec une intégration IA. Beaucoup de développeurs utilisent les deux : Cursor pour le confort visuel, Claude Code pour les grosses sessions agentiques. Détail dans notre comparatif outils 2026.

Mon code est-il envoyé à Anthropic ?

Oui, Claude Code envoie le contexte (fichiers, commandes, sortie) aux serveurs Anthropic pour permettre à Claude de raisonner. Sur les plans Pro / Max / Team, ce contenu n’est pas utilisé pour entraîner les modèles. Les plans Enterprise offrent des garanties supplémentaires (résidence des données, audit logs).

Peut-on utiliser Claude Code sans connexion internet ?

Non, l’outil dépend de l’API Anthropic. Pour un usage 100% local, des alternatives open source comme Aider (avec Ollama) sont plus adaptées.

Combien de temps pour être autonome avec Claude Code ?

Quelques heures pour les bases, deux à trois jours pour intégrer la pratique dans un workflow quotidien, deux à quatre semaines pour maîtriser MCP, sub-agents et slash commands custom. Une formation Mill-Forma condense cette montée en compétence sur 3 à 5 jours.