Comment installer Claude Code en 2026 : une seule commande suffit une fois Node.js 18 ou supérieur présent sur votre machine.

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

Lancez ensuite claude dans votre terminal, connectez-vous avec votre compte Anthropic (ou renseignez une clé API), et l’agent est prêt. L’installation complète prend moins de 5 minutes sur Windows via WSL2, macOS via Homebrew, et Ubuntu via NodeSource. Ce guide couvre chaque environnement en détail, avec les commandes exactes, les pièges fréquents à éviter et l’intégration dans VS Code.

Qu’est-ce que Claude Code et pourquoi l’installer ?

Claude Code est l’agent de codage en ligne de commande d’Anthropic, basé sur les modèles Claude Sonnet 5 et Claude Opus 4.8. Il lit votre codebase, exécute des commandes shell, lit et modifie des fichiers, lance des tests et gère des dépôts Git, le tout depuis une simple interface de terminal. Contrairement à un plugin d’éditeur, il est agnostique : il fonctionne dans VS Code, JetBrains, Zed, ou n’importe quel terminal.

Depuis sa sortie publique en 2025 et sa montée en version 2.x en 2026, Claude Code s’est imposé comme une référence parmi les agents de codage. Sur SWE-Bench Verified, il atteint 92,4 % avec Claude Sonnet 5, ce qui en fait l’un des outils les plus efficaces pour automatiser des tâches de développement réelles. Si vous souhaitez comparer ses capacités avec d’autres agents, lisez notre article sur OpenCode, l’alternative open source.

Prérequis : Node.js 18+ et un compte Anthropic

Avant d’installer Claude Code, vérifiez que Node.js version 18 ou supérieure est installé. C’est la seule dépendance système obligatoire.

# Vérifier la version de Node.js
node --version
# Doit afficher v18.x.x ou supérieur

# Vérifier npm
npm --version
# Doit afficher 8.x ou supérieur

Si la commande node n’est pas trouvée ou si la version est inférieure à 18, vous devez d’abord installer ou mettre à jour Node.js (les sections ci-dessous couvrent chaque système). Pour le compte Anthropic, deux options existent :

  • Abonnement Claude.ai Pro ou Max (20 ou 100 dollars par mois) : authentification OAuth directe, sans facturation à l’usage de l’API.
  • Clé API Anthropic : à créer sur console.anthropic.com, facturation à l’usage (de l’ordre de 3 dollars par million de tokens en entrée pour Sonnet 5).

L’abonnement Pro est souvent plus économique pour un usage quotidien intensif. La clé API convient aux équipes qui veulent contrôler finement les coûts par projet.

Comment installer Claude Code sur Windows

Sur Windows, l’approche recommandée est WSL2 (Windows Subsystem for Linux), car Claude Code manipule des chemins Unix et interagit avec des shells Bash. L’installation native sous PowerShell fonctionne, mais vous rencontrerez davantage de frictions avec les scripts shell.

Méthode 1 : WSL2 (recommandée)

# Dans PowerShell en tant qu'administrateur
wsl --install
# Redémarrez, puis ouvrez Ubuntu depuis le menu Démarrer

# Dans le terminal Ubuntu (WSL2)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Installer Claude Code
npm install -g @anthropic-ai/claude-code

# Lancer
claude

Méthode 2 : PowerShell natif

Téléchargez l’installeur LTS depuis nodejs.org et suivez l’assistant. Ouvrez ensuite PowerShell et exécutez :

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

Si vous obtenez une erreur de politique d’exécution, ajoutez d’abord :

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Comment installer Claude Code sur macOS

Sur macOS, deux approches populaires : Homebrew (recommandée pour les développeurs) ou le gestionnaire de versions nvm.

# Option A : via Homebrew
brew install node
npm install -g @anthropic-ai/claude-code

# Option B : via nvm (meilleure gestion multi-versions)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc  # ou ~/.bashrc si vous utilisez bash
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

# Vérifier l'installation
claude --version

Avec nvm, l’avantage est de pouvoir basculer entre les versions de Node.js selon les projets, sans toucher à l’installation système. Sur les Mac Apple Silicon (M1/M2/M3/M4), les deux méthodes fonctionnent nativement, aucun Rosetta n’est nécessaire.

Note importante : n’utilisez jamais sudo npm install -g. Cela crée des problèmes de permissions qui compliquent les mises à jour ultérieures. Préférez toujours nvm ou Homebrew pour gérer Node.js sans droits root.

Comment installer Claude Code sur Ubuntu et Debian

Sur Ubuntu 20.04, 22.04, 24.04 et les distributions Debian dérivées, la méthode la plus propre passe par les dépôts NodeSource, qui maintiennent des packages Node.js LTS à jour.

# Ajouter le dépôt NodeSource pour Node.js 20 LTS
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Vérifier
node --version  # v20.x.x
npm --version   # 10.x

# Installer Claude Code sans sudo (important)
npm install -g @anthropic-ai/claude-code

# Premier lancement
claude

Si vous préférez nvm sur Linux (recommandé pour les développeurs qui gèrent plusieurs projets avec des versions Node.js différentes) :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20
npm install -g @anthropic-ai/claude-code

Sur les serveurs Ubuntu sans interface graphique, Claude Code fonctionne en mode non interactif, idéal pour les pipelines CI/CD ou les scripts d’automatisation.

Intégrer Claude Code à VS Code

Claude Code ne s’installe pas comme une extension VS Code classique depuis le marketplace : c’est un outil CLI qui s’utilise depuis le terminal intégré de VS Code. Cette approche est intentionnelle : l’agent a accès à l’ensemble de votre projet via le système de fichiers, sans être limité par les API d’extension de l’éditeur.

# Ouvrir VS Code depuis le terminal
code /chemin/vers/votre/projet

# Dans le terminal intégré VS Code (Ctrl+` ou Cmd+`)
claude

# Claude Code détecte automatiquement la racine du projet
# et peut lire, modifier et créer des fichiers dans le workspace

Claude Code s’intègre également avec les extensions GitHub Copilot et les outils MCP (Model Context Protocol). Si vous avez un serveur MCP configuré dans votre projet (via .mcp.json), Claude Code le détecte et l’utilise automatiquement, permettant par exemple d’interroger une base de données ou d’appeler des APIs tierces directement depuis l’agent.

Pour les utilisateurs de JetBrains (PhpStorm, WebStorm, IntelliJ), le workflow est identique : ouvrez le terminal intégré et lancez claude. Vous pouvez aussi utiliser la commande claude --dangerously-skip-permissions dans des environnements CI où vous voulez supprimer les confirmations interactives, mais cette option est à réserver aux pipelines contrôlés.

Authentification et premier lancement

Au premier lancement, Claude Code ouvre un navigateur pour vous connecter à votre compte Anthropic via OAuth. Si vous êtes en environnement headless (serveur sans interface graphique), utilisez la clé API à la place.

# Méthode 1 : connexion OAuth (navigateur, recommandée)
claude
# Un lien s'affiche, ouvrez-le dans votre navigateur
# et connectez-vous avec votre compte Anthropic

# Méthode 2 : clé API (serveur, CI/CD)
export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude

# Rendre la clé persistante dans ~/.bashrc ou ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.bashrc
source ~/.bashrc

# Vérifier que tout fonctionne
claude --version
claude -p "Dis bonjour en français"

Une fois connecté, Claude Code mémorise vos identifiants de façon sécurisée dans ~/.claude/. Vous n’aurez plus à vous reconnecter sauf si vous révoquez l’accès depuis la console Anthropic ou si vous changez de machine.

Pour découvrir toutes les fonctionnalités de Claude Code et comprendre ce que l’agent peut accomplir dans un contexte réel, lisez notre analyse de Claude Sonnet 5 et ses benchmarks développeur.

Mettre à jour Claude Code et gérer les versions

Claude Code reçoit des mises à jour fréquentes (parfois plusieurs fois par semaine). La mise à jour se fait avec npm, de la même façon que l’installation initiale.

# Mettre à jour Claude Code vers la dernière version
npm update -g @anthropic-ai/claude-code

# Ou installer une version spécifique
npm install -g @anthropic-ai/claude-code@2.1.0

# Vérifier la version installée
claude --version

# Voir les versions disponibles
npm view @anthropic-ai/claude-code versions --json | tail -20

# Désinstaller Claude Code
npm uninstall -g @anthropic-ai/claude-code

Claude Code affiche un avertissement au lancement si une version plus récente est disponible. Il est conseillé de mettre à jour régulièrement : chaque nouvelle version apporte des corrections de comportement, des améliorations de performance et parfois de nouveaux modes (comme le mode /plan ou /build introduits courant 2026).

Pour comprendre l’évolution de l’outil et les controverses récentes autour de son développement, notamment la découverte d’un code de détection caché en avril 2026, consultez notre article sur l’affaire du tracking stéganographique dans Claude Code.

Résoudre les erreurs courantes à l’installation

Voici les problèmes les plus fréquents rencontrés lors de l’installation de Claude Code, avec leurs solutions.

# Erreur : EACCES permission denied
# Cause : Node.js installé en root (via apt sans nvm)
# Solution : réinstaller Node.js via nvm

# 1. Désinstaller npm global pollué
sudo npm cache clean --force

# 2. Installer nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 3. Réinstaller Node.js et Claude Code proprement
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

# Erreur : claude: command not found (après installation réussie)
# Cause : le binaire npm global n'est pas dans le PATH
npm bin -g
# Ajoute ce chemin à ton PATH dans ~/.bashrc
export PATH="$(npm bin -g):$PATH"

# Erreur : Node.js version too old (< 18)
nvm install 20 && nvm use 20 && nvm alias default 20

# Erreur : API key invalid
# Vérifiez que la clé commence par sk-ant-api03-
# et qu'elle est bien exportée dans le shell courant
echo $ANTHROPIC_API_KEY

Sur Windows sans WSL2, une erreur fréquente est l’absence de Python dans le PATH (nécessaire pour certains modules natifs npm). La solution la plus simple reste de passer à WSL2, où l’environnement Linux est complet.

Si vous cherchez une alternative entièrement open source à Claude Code, sans dépendance à un compte propriétaire, notre guide sur OpenCode (160 000 étoiles GitHub) présente une solution comparable utilisable avec n’importe quel fournisseur LLM.

Sources

FAQ : installer Claude Code

Est-ce que Claude Code est gratuit ?

Claude Code n’est pas gratuit : il nécessite soit un abonnement Claude.ai (Pro à 20 dollars par mois ou Max à 100 dollars par mois), soit une clé API Anthropic avec facturation à l’usage. Avec l’abonnement Pro, la consommation de Claude Code est incluse dans le quota mensuel. Avec la clé API, chaque token consommé est facturé selon le tarif du modèle utilisé (environ 3 dollars par million de tokens en entrée pour Sonnet 5 en juillet 2026).

Quelle version de Node.js faut-il pour installer Claude Code ?

Claude Code requiert Node.js version 18.0.0 ou supérieure. La version LTS recommandée est Node.js 20 (Active LTS) ou Node.js 22 (Current). Node.js 16 et les versions antérieures ne sont plus supportées. Vérifiez votre version avec node --version et mettez à jour si nécessaire via nvm ou le gestionnaire de paquets de votre système.

Comment mettre à jour Claude Code vers la dernière version ?

La mise à jour de Claude Code se fait avec la commande npm update -g @anthropic-ai/claude-code. Claude Code affiche un message au démarrage lorsqu’une nouvelle version est disponible. Pour automatiser les mises à jour, vous pouvez ajouter un alias dans votre ~/.bashrc : alias update-claude='npm update -g @anthropic-ai/claude-code'.

Claude Code fonctionne-t-il sans connexion internet ?

Non, Claude Code nécessite une connexion internet active pour fonctionner : chaque requête est envoyée aux serveurs Anthropic pour être traitée par le modèle Claude. Il n’existe pas de mode hors ligne. Si vous avez besoin d’un agent de codage fonctionnant entièrement en local, des alternatives comme Ollama avec des modèles open source (CodeLlama, Qwen2.5-Coder) permettent de s’affranchir du cloud, au prix de performances moindres.

Comment désinstaller complètement Claude Code ?

Pour désinstaller Claude Code, exécutez npm uninstall -g @anthropic-ai/claude-code. Cela supprime le binaire global. Les fichiers de configuration et de session sont stockés dans ~/.claude/ : supprimez ce dossier manuellement si vous voulez une désinstallation complète (rm -rf ~/.claude/). Vos conversations et l’historique des sessions sont également dans ce dossier.

G
WP Admin Lab

Architecte web full-stack. WordPress, performance, data et sécurité. Notes de terrain, tests reproductibles et retours d'expérience.