Claude Code : tutoriel d’installation et premiers pas (2026)

Claude Code est l’outil CLI agentique d’Anthropic. Vous décrivez ce que vous voulez en français (vibe coding), et l’assistant lit votre repo, édite plusieurs fichiers, lance vos tests et itère jusqu’à un résultat qui passe. Pas d’IDE à apprendre, tout se joue dans le terminal. Ce tutoriel couvre l’installation sur les trois OS et les premières heures de pratique, de l’authentification au premier endpoint généré.

Prérequis

Quatre choses à avoir sous la main avant de lancer la moindre commande :

• 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 et suivre des repos

Installation

L’installation passe partout par npm (npm install -g @anthropic-ai/claude-code). La seule variable, c’est la façon d’obtenir Node sur votre machine.

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

Pour les workflows à base de scripts, lancer Claude Code depuis WSL2 (Ubuntu) est généralement plus stable que depuis PowerShell natif.

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

Vous voulez aller plus vite avec Claude Code en équipe ? Découvrez la formation Claude Code

Premier projet : modifier un repo existant

Pour ressentir ce que change Claude Code, lancez-le sur un repo que vous connaissez déjà et demandez-lui 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.

Le point à retenir : vous décrivez l’intention en français, Claude exécute. Le contrôle reste de votre côté, via les diffs proposés, les revues et les commits.

Les slash commands utiles à connaître

Les slash commands sont des raccourcis tapés dans l’interface Claude Code, avec un / en début de ligne.

Vous pouvez aussi créer vos propres slash commands custom, dans ~/.claude/commands/ pour un usage global ou dans .claude/commands/ au niveau d’un projet.

MCP servers : étendre Claude Code

MCP (Model Context Protocol) est un protocole d’intégration qui branche Claude Code sur 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 concret : ajouter un MCP filesystem pour donner à Claude l’accès à un dossier situé 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, partez de la doc officielle Anthropic et testez progressivement les MCP les plus populaires (GitHub, Linear, Sentry) avant d’en empiler trop d’un coup.

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. Les profils qui reviennent le plus souvent :

Comment se définit un sub-agent

Un sub-agent vit dans .claude/agents/<nom>.md. Sa frontmatter précise son nom, sa description, ses outils autorisés et son modèle. Le CLAUDE.md du projet lui sert de contexte par défaut, ce qui lui évite de redécouvrir les conventions à chaque appel.

Bonnes pratiques pour démarrer

• Commencer chaque nouveau projet par un /init pour générer un CLAUDE.md descriptif
• Préférer des sessions courtes (15 à 30 min) à une session marathon : le contexte reste plus propre
• Reviewer chaque diff avant de l’accepter, surtout les premiers jours
• Documenter dans CLAUDE.md les conventions du projet (style, sécurité, libs interdites)
• Lancer /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