Comment Installer Claude Code : Guide Pas à Pas (2026)

Mis à jour le 27 mars 2026

Claude Code s'installe en une commande : npm install -g @anthropic-ai/claude-code. Il nécessite Node.js 18+ et un abonnement Claude Pro (20$/mois), Max (100$/mois) ou Team. En mars 2026, plus de 500 000 développeurs l'utilisent quotidiennement. C'est l'agent de développement IA le plus puissant du marché, et son installation est étonnamment simple. Que tu sois sur Mac, Windows ou Linux, ce guide te montre exactement comment faire, étape par étape, avec la résolution de chaque erreur courante.

Ce guide couvre l'installation complète de Claude Code, de la vérification des prérequis jusqu'à ta première session de travail. Si tu veux comprendre ce que Claude Code peut faire avant de l'installer, consulte d'abord le guide complet de Claude Code.

Qu'est-ce que Claude Code ?

Claude Code est l'agent de développement en ligne de commande d'Anthropic. Contrairement à un simple chatbot, il vit dans ton terminal, comprend ton projet dans sa globalité, et peut lire, écrire et exécuter du code directement dans ton environnement de développement. Il ne se contente pas de suggérer du code dans une fenêtre séparée — il agit dans ton projet, avec ton architecture, tes fichiers, tes conventions.

Concrètement, Claude Code peut créer des fichiers, modifier du code existant, lancer des commandes shell, gérer ton git, débugger des erreurs, et orchestrer des tâches complexes en plusieurs étapes. Le tout depuis un terminal. C'est un développeur IA qui travaille avec toi, pas à côté de toi.

Pour une exploration complète de ses capacités — le fichier CLAUDE.md, les permissions, les hooks, le MCP, les skills — consulte le guide complet de Claude Code. Ici, on se concentre sur l'installation.

Quels sont les prérequis pour installer Claude Code ?

Avant de lancer l'installation, tu as besoin de trois choses. Pas une de plus.

1. Node.js version 18 ou supérieure

Claude Code est distribué comme un package npm. Tu as donc besoin de Node.js et de npm (qui est inclus avec Node.js). La version minimale est Node.js 18. Pour vérifier ta version actuelle :

node --version

Si tu obtiens v18.x.x ou plus, tu es bon. Si la commande n'est pas reconnue ou que ta version est inférieure à 18, tu dois installer ou mettre à jour Node.js. On voit comment faire sur chaque OS dans les sections suivantes.

2. Un terminal

Claude Code fonctionne dans le terminal. Sur Mac, c'est Terminal ou iTerm2. Sur Linux, n'importe quel émulateur de terminal. Sur Windows, tu utiliseras le terminal WSL (on en parle plus bas). Si tu utilises VS Code, le terminal intégré fonctionne parfaitement.

3. Un abonnement Claude

Claude Code n'est pas gratuit. Tu as besoin d'un abonnement Anthropic actif :

• Claude Pro — 20$/mois : usage standard, suffisant pour commencer et pour la majorité des projets personnels.
• Claude Max — 100$/mois : 5x plus de requêtes, idéal pour un usage quotidien intensif et les projets professionnels.
• Claude Team — 30$/utilisateur/mois : pour les équipes, avec gestion centralisée et partage de configurations.

Pas d'abonnement = pas de Claude Code. C'est la seule barrière à l'entrée. Si tu hésites entre les plans, consulte notre comparatif détaillé des prix et plans Claude Code.

Comment installer Claude Code sur Mac ?

Le Mac est l'environnement le plus fluide pour Claude Code. La majorité des développeurs qui l'utilisent sont sur macOS.

Étape 1 : Installer ou mettre à jour Node.js

Si Node.js n'est pas installé, la méthode la plus propre est d'utiliser Homebrew :

# Installer Homebrew si tu ne l'as pas
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Installer Node.js
brew install node

Alternative : télécharge l'installeur depuis nodejs.org (choisis la version LTS).

Vérifie que tout est en place :

node --version   # Doit afficher v18.x.x ou plus
npm --version    # Doit afficher 9.x.x ou plus

Étape 2 : Installer Claude Code

Une seule commande :

npm install -g @anthropic-ai/claude-code

Le flag -g installe Claude Code globalement, ce qui rend la commande claude disponible dans n'importe quel dossier de ton terminal.

L'installation prend généralement 30 à 60 secondes selon ta connexion. Tu verras une série de messages npm, et à la fin, un message de succès.

Étape 3 : Vérifier et se connecter

claude --version    # Vérifie l'installation
claude auth login   # Connecte ton compte Anthropic

La commande auth login ouvre ton navigateur pour l'authentification OAuth. Connecte-toi avec ton compte Anthropic (celui de ton abonnement Pro, Max ou Team), autorise l'accès, et c'est fait.

Étape 4 : Lancer ta première session

cd ~/mon-projet
claude

Claude Code scanne ton projet, lit les fichiers de configuration (package.json, CLAUDE.md, etc.) et tu peux commencer à travailler. Pour un guide sur les premières commandes, consulte le guide du Vibe Coding pour débutants.

Comment installer Claude Code sur Windows ?

Sur Windows, Claude Code nécessite WSL (Windows Subsystem for Linux). C'est une couche de compatibilité qui fait tourner un vrai environnement Linux directement dans Windows. Ce n'est pas une machine virtuelle — c'est intégré au système.

Étape 1 : Installer WSL

Ouvre PowerShell en administrateur (clic droit > "Exécuter en tant qu'administrateur") et lance :

wsl --install

Cette commande installe WSL 2 avec Ubuntu par défaut. Redémarre ton PC quand demandé. Au redémarrage, une fenêtre Ubuntu s'ouvre pour créer ton nom d'utilisateur et mot de passe Linux.

Étape 2 : Installer Node.js dans WSL

Dans le terminal Ubuntu (WSL), installe Node.js avec nvm (Node Version Manager) — c'est la méthode la plus propre :

# Installer nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Recharger le terminal
source ~/.bashrc

# Installer Node.js LTS
nvm install --lts

# Vérifier
node --version
npm --version

Étape 3 : Installer Claude Code

Toujours dans le terminal WSL :

npm install -g @anthropic-ai/claude-code

Étape 4 : Se connecter et lancer

claude --version
claude auth login
cd ~/mon-projet
claude

Le navigateur Windows s'ouvre automatiquement pour l'authentification OAuth depuis WSL. Si ça ne fonctionne pas, copie l'URL affichée dans le terminal et colle-la manuellement dans ton navigateur.

Astuce VS Code + WSL

Si tu utilises VS Code, installe l'extension "WSL" de Microsoft. Elle te permet d'ouvrir VS Code directement dans l'environnement WSL. Ton terminal intégré sera automatiquement un terminal Linux, et Claude Code fonctionnera parfaitement. Pour aller plus loin avec l'intégration VS Code, consulte notre guide VS Code avec Claude Code vs Cursor.

Comment installer Claude Code sur Linux ?

Linux est l'environnement natif de Claude Code. L'installation est directe.

Étape 1 : Installer Node.js

Sur Ubuntu/Debian :

# Via nvm (recommandé)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

# Ou via le gestionnaire de paquets
sudo apt update
sudo apt install nodejs npm

Sur Fedora/CentOS :

sudo dnf install nodejs npm

Sur Arch Linux :

sudo pacman -S nodejs npm

Vérifie toujours la version après installation :

node --version   # Doit être 18+

Étape 2 : Installer Claude Code

npm install -g @anthropic-ai/claude-code

Si tu obtiens une erreur de permissions (EACCES), deux solutions :

# Solution 1 : Utiliser nvm (recommandé, pas besoin de sudo)
# Si tu as installé Node via nvm, pas de problème de permissions

# Solution 2 : Changer le préfixe npm
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Étape 3 : Se connecter et tester

claude --version
claude auth login
cd ~/mon-projet
claude

Comment vérifier que l'installation a fonctionné ?

Trois vérifications rapides pour confirmer que tout est en place.

Vérification 1 : La commande existe

which claude    # Doit afficher le chemin de l'exécutable
claude --version  # Doit afficher le numéro de version

Si which claude ne retourne rien, le binaire n'est pas dans ton PATH. C'est souvent un problème de permissions npm ou de configuration PATH. Consulte la section erreurs plus bas.

Vérification 2 : L'authentification fonctionne

claude auth status

Cette commande vérifie que ton compte est connecté et que ton abonnement est actif. Si tu vois "Authenticated", tout est bon.

Vérification 3 : Claude Code répond

claude "Dis bonjour en français"

Si Claude Code te répond, l'installation est complète et fonctionnelle. Tu peux maintenant naviguer dans n'importe quel dossier projet et lancer claude pour démarrer une session interactive.

Comment installer Claude Code dans VS Code ?

Claude Code fonctionne dans n'importe quel terminal, y compris le terminal intégré de VS Code. Mais il existe aussi une extension dédiée pour une intégration plus poussée.

Tu préfères JetBrains ? Consulte notre guide Claude Code pour JetBrains (IntelliJ, WebStorm, PHPStorm).

Option 1 : Terminal intégré (aucune config)

Ouvre le terminal dans VS Code (Ctrl+` ou Cmd+`) et lance claude. Ça fonctionne immédiatement si Claude Code est installé globalement. C'est la méthode la plus simple et celle que la majorité des utilisateurs préfèrent.

Option 2 : Extension Claude Code pour VS Code

Anthropic propose une extension officielle sur le marketplace VS Code :

1. Ouvre VS Code
2. Va dans Extensions (Ctrl+Shift+X ou Cmd+Shift+X)
3. Cherche "Claude Code"
4. Installe l'extension officielle d'Anthropic
5. L'extension ajoute un panneau latéral dédié et des raccourcis

L'extension offre une interface graphique au-dessus du CLI. Elle détecte automatiquement ton installation de Claude Code et utilise la même authentification. Pour un comparatif détaillé entre VS Code + Claude Code et Cursor, consulte notre article VS Code avec Claude Code vs Cursor.

Quelles sont les erreurs courantes à l'installation ?

Même avec une installation simple, certaines erreurs reviennent fréquemment. Voici les plus courantes et comment les résoudre.

Erreur : "node: command not found"

Node.js n'est pas installé ou pas dans ton PATH. Solution : installe Node.js avec les commandes de la section correspondant à ton OS. Si tu l'as installé via nvm, assure-toi d'avoir lancé source ~/.bashrc (ou ~/.zshrc sur Mac avec zsh).

Erreur : "npm ERR! EACCES permission denied"

npm essaie d'écrire dans un dossier système sans les permissions nécessaires. Ne pas utiliser sudo npm install — ça crée des problèmes de permissions en cascade. Utilise plutôt nvm, ou change le préfixe npm comme montré dans la section Linux.

Erreur : "Your Node.js version is not supported"

Ta version de Node.js est inférieure à 18. Mets à jour :

# Avec nvm
nvm install --lts
nvm use --lts

# Avec Homebrew (Mac)
brew upgrade node

Erreur : "claude: command not found" après installation

Le binaire est installé mais pas dans ton PATH. Vérifie où npm installe les packages globaux :

npm config get prefix

Ajoute le dossier bin de ce chemin à ton PATH dans ~/.bashrc ou ~/.zshrc.

Erreur de réseau ou timeout

Si tu es derrière un proxy ou un firewall d'entreprise, npm peut ne pas pouvoir télécharger les packages. Configure le proxy npm :

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

Pour une liste complète des erreurs et leurs solutions, consulte notre guide erreurs Claude Code pour débutants.

Comment mettre à jour Claude Code ?

Claude Code évolue rapidement. Anthropic publie des mises à jour régulières avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performance. Mettre à jour est aussi simple que l'installation.

# Mettre à jour Claude Code
npm update -g @anthropic-ai/claude-code

# Vérifier la nouvelle version
claude --version

Tu peux aussi forcer la réinstallation de la dernière version :

npm install -g @anthropic-ai/claude-code@latest

Conseil : mets à jour au moins une fois par semaine. Les nouvelles versions apportent souvent des améliorations significatives du modèle, de nouvelles capacités (comme les hooks ou le MCP), et des corrections de bugs importants. Claude Code t'avertira dans le terminal quand une nouvelle version est disponible.

La mise à jour ne touche pas à tes fichiers de configuration (~/.claude/, CLAUDE.md, settings.json). Tes paramètres, tes permissions et tes hooks restent intacts.

Quelle est la prochaine étape après l'installation ?

Claude Code est installé, connecté, et prêt à l'emploi. Voici comment commencer efficacement.

Si tu débutes complètement

Commence par le guide du Vibe Coding pour débutants. Il t'explique les commandes de base, comment formuler tes demandes, et comment Claude Code gère les fichiers de ton projet. C'est le point de départ idéal pour quelqu'un qui n'a jamais utilisé un agent IA de développement.

Si tu veux comprendre tout l'écosystème

Le guide complet de Claude Code couvre l'ensemble : le fichier CLAUDE.md, les permissions, les hooks, le MCP, les skills, les commandes personnalisées. C'est la référence complète pour maîtriser l'outil en profondeur.

Si tu veux sécuriser ton installation

Consulte le guide permissions et sécurité de Claude Code pour configurer exactement ce que Claude Code peut et ne peut pas faire. C'est particulièrement important si tu travailles sur des projets sensibles ou en entreprise.

Si tu veux aller plus loin avec la formation

Le programme Le Labo IA t'accompagne de l'installation à la maîtrise complète de Claude Code, combiné avec n8n pour l'automatisation. Plus de 110 entrepreneurs ont déjà été formés.

Meydeey — Architecte IA & Automatisation

+110 entrepreneurs formés au Vibe Coding et à l'automatisation IA. Fondateur du Labo IA, +28K abonnés YouTube.

YouTube LinkedIn Communauté