Comment Installer Claude Code sur Mac, Windows et Linux ?

Comment installer Claude Code sur Mac, Windows et Linux ?

Installer Claude Code prend environ 3 à 5 minutes sur un système correctement configuré, mais la moitié des développeurs qui débutent tombent sur un blocage : Node.js manquant, droits administrateur insuffisants, conflit de version npm, problème PATH. Ce guide couvre l'installation complète sur les trois OS principaux (macOS, Windows, Linux), les prérequis exacts, les commandes à lancer, et — surtout — la résolution des erreurs courantes qu'on rencontre en 2026.

À la fin de ce tutoriel, vous aurez un claude fonctionnel dans votre terminal, authentifié à votre compte Anthropic, prêt à lancer votre première session. Le guide est aligné sur la version Claude Code v2.30+ de mai 2026 et tient compte des changements récents (binaire natif Windows, support ARM Linux, package manager bun supporté).

Sommaire

Prérequis communs avant l'installation {#prerequis}

Avant de lancer la moindre commande, vérifiez que votre machine remplit ces conditions de base. Sauter cette étape est la première cause d'échec d'installation Claude Code.

Node.js 20+ (obligatoire)

Claude Code est distribué sous forme de package npm. La version minimum supportée est Node.js 20 LTS. Pour vérifier :

node --version
# attendu : v20.x.x ou plus récent

Si vous avez une version plus ancienne (ou aucune installation), utilisez nvm (Node Version Manager) plutôt que l'installateur direct — ça évite les conflits de version entre projets.

Un compte Anthropic actif

Vous aurez besoin d'un compte sur [console.anthropic.com](https://console.anthropic.com) avec soit un plan d'abonnement (Pro, Max, Teams), soit une clé API avec des crédits chargés. Pour le détail des formules, voir notre guide complet [Claude Code prix et tarif 2026](/blog/claude-code-prix-tarif-abonnement-2026).

Un terminal moderne

Git installé

Pas indispensable pour démarrer Claude Code, mais l'outil l'utilise dès qu'il modifie des fichiers dans un repo. git --version doit renvoyer 2.30 ou plus.

Installer Claude Code sur macOS {#macos}

L'installation sur macOS (Apple Silicon ou Intel) est la plus directe. Voici les trois méthodes, classées par fiabilité.

Méthode 1 : npm global (recommandée)

# 1. Installer nvm si Node n'est pas présent
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc  # ou ~/.bash_profile selon votre shell

# 2. Installer Node.js LTS
nvm install --lts
nvm use --lts

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

# 4. Vérifier
claude --version

Sur Apple Silicon (M1/M2/M3/M4), aucune étape supplémentaire n'est nécessaire — Claude Code est natif ARM64. Sur Intel, l'installation passe par les binaires x86_64 sans intervention.

Méthode 2 : Homebrew

Si vous utilisez déjà Homebrew :

brew install claude-code

Cette formule est maintenue par la communauté et reste alignée sur la version stable npm, avec un délai de 24 à 48h en général.

Méthode 3 : bun (pour les développeurs avancés)

Pour ceux qui utilisent [bun](https://bun.sh) :

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

C'est l'option la plus rapide (3-5x plus rapide qu'npm), mais demande que bun soit déjà installé.

Vérifier l'installation macOS

claude --version
# v2.30.x ou plus récent

which claude
# /Users/votre-nom/.nvm/versions/node/v20.x/bin/claude

Si claude n'est pas trouvé, c'est un problème de PATH (voir la section [Erreurs courantes](#erreurs)).

Installer Claude Code sur Windows {#windows}

L'installation Claude Code Windows a deux variantes : (1) Windows natif avec PowerShell, (2) WSL2 (Windows Subsystem for Linux). En 2026, 80 % des développeurs Windows utilisent WSL2 car la majorité des outils CLI fonctionnent mieux dans un environnement Linux.

Variante 1 : Windows natif (PowerShell 7+)

# 1. Installer Node.js via winget (gestionnaire officiel Windows)
winget install OpenJS.NodeJS.LTS

# 2. Redémarrer le terminal
# 3. Installer Claude Code
npm install -g @anthropic-ai/claude-code

# 4. Vérifier
claude --version

Attention : sur Windows natif, certaines fonctionnalités avancées (symlinks pour worktrees, certains hooks bash) peuvent demander l'activation du Developer Mode dans Paramètres > Confidentialité et sécurité > Pour les développeurs.

Variante 2 : WSL2 (recommandée)

WSL2 vous donne un véritable environnement Linux dans Windows. C'est le setup utilisé par la plupart des équipes en 2026.

# 1. Activer WSL2 (PowerShell admin)
wsl --install

# 2. Redémarrer la machine
# 3. Lancer Ubuntu, créer son utilisateur, puis :
sudo apt update && sudo apt upgrade -y

# 4. Installer Node.js via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

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

# 6. Vérifier
claude --version

Pour l'intégration avec VS Code, installez l'extension WSL côté Windows — vous pourrez ouvrir vos projets WSL directement depuis Windows.

Variante 3 : Installer Claude Code Desktop (Windows)

Depuis avril 2026, Anthropic propose Claude Code Desktop pour Windows en .exe natif. Téléchargez-le depuis [claude.com/code](https://claude.com/code). L'installateur configure tout automatiquement, mais vous perdez le contrôle CLI. Voir notre guide [Claude Code Desktop redesign sessions parallèles](/blog/claude-code-desktop-redesign-sessions-paralleles-2026) pour comparer avec la version CLI.

Installer Claude Code sur Linux {#linux}

Linux est la plateforme la mieux supportée par Claude Code (c'est sur Linux qu'Anthropic développe l'outil en interne). L'installation prend 2 minutes sur les distributions courantes.

Ubuntu / Debian

# 1. Installer Node.js via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

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

# 3. Vérifier
claude --version

Fedora / RHEL / Arch

Même commandes après installation de Node.js via votre gestionnaire de paquets :

# Fedora
sudo dnf install nodejs npm

# Arch
sudo pacman -S nodejs npm

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

Linux ARM (Raspberry Pi 5, serveurs ARM64)

Claude Code v2.20+ supporte nativement ARM64. Aucune étape spécifique n'est requise — l'installation npm classique fonctionne. C'est ce qui a permis à la communauté de tourner Claude Code sur des Raspberry Pi 5 pour des tâches d'agents autonomes longue durée.

Permissions et droits

Important : ne lancez jamais sudo npm install -g. Utilisez plutôt nvm qui installe Node dans votre home, donc sans avoir besoin de root. Si vous avez déjà fait sudo npm install -g, corrigez avec :

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Première authentification et test {#auth}

Une fois claude installé, il faut s'authentifier auprès d'Anthropic.

Méthode 1 : authentification interactive (recommandée)

claude
# Au premier lancement, le CLI ouvre votre navigateur
# Vous vous connectez à votre compte Anthropic
# Une clé est stockée dans ~/.claude/credentials.json

C'est la méthode la plus simple et la plus sûre. Aucune clé n'est exposée dans vos fichiers de config.

Méthode 2 : clé API (pour CI/CD)

Pour les pipelines automatisés ou les scripts headless :

export ANTHROPIC_API_KEY="sk-ant-..."
claude --print "Hello Claude"

Ne committez jamais votre clé API dans un repo Git. Utilisez des secrets manager (GitHub Secrets, GitLab CI variables, etc.).

Premier test : "Hello Claude"

cd ~/projects/test-claude
claude

À l'intérieur de la session :

> Bonjour Claude, crée un fichier hello.js qui affiche "Hello World"

Si Claude crée le fichier et le contenu est correct, votre installation Claude Code est opérationnelle. Pour vos premiers pas guidés, suivez notre [guide débutant Claude Code](/blog/comment-utiliser-claude-code-guide-debutant-2026).

Erreurs courantes et solutions {#erreurs}

Voici les erreurs d'installation Claude Code les plus rencontrées en 2026, et leurs corrections rapides.

Erreur 1 : "command not found: claude"

C'est de loin l'erreur la plus fréquente. Cause : le binaire claude n'est pas dans votre PATH.

# Trouver où npm installe les binaires
npm config get prefix

# Ajouter au PATH (zsh)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Erreur 2 : "EACCES: permission denied"

Vous avez utilisé sudo npm install et les permissions sont cassées :

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.config/claude

Erreur 3 : "ECONNREFUSED" ou "fetch failed"

Problème réseau ou proxy d'entreprise qui bloque les appels API Anthropic.

# Configurer un proxy si nécessaire
npm config set proxy http://proxy.entreprise.local:8080
npm config set https-proxy http://proxy.entreprise.local:8080

Sur les réseaux d'entreprise, vérifiez que les domaines api.anthropic.com et console.anthropic.com sont autorisés.

Erreur 4 : "Node.js version not supported"

Vous tournez sur Node 18 ou plus ancien. Mettez à jour :

nvm install 20
nvm use 20
nvm alias default 20

Erreur 5 : "Cannot find module 'better-sqlite3'"

Erreur classique sur Windows natif quand les outils de build C++ manquent. Solution :

npm install --global windows-build-tools
# Ou installer Visual Studio Build Tools manuellement

Sur WSL2, cette erreur n'apparaît jamais — encore une raison de préférer WSL2.

Erreur 6 : "Rate limit exceeded" dès la première session

Votre compte Anthropic n'a pas de plan actif. Vérifiez sur [console.anthropic.com](https://console.anthropic.com) que votre abonnement est bien provisionné, ou que votre clé API a des crédits.

Erreur 7 : Authentification qui boucle

Cookies corrompus côté navigateur. Solution :

rm -rf ~/.claude/credentials.json
claude  # relance l'authentification proprement

Pour aller plus loin sur la sécurité de l'authentification, voir notre guide [Sécurité des assistants IA code 2026](/blog/securite-assistants-ia-code-2026).

Configurer Claude Code après l'installation {#config}

Une fois Claude Code installé, quatre étapes de configuration valent la peine d'être faites immédiatement.

1. Créer le fichier global ~/.claude/CLAUDE.md

Ce fichier contient vos préférences globales (toujours utiliser TypeScript, conventions de tests, etc.). Claude le lit à chaque démarrage de session.

2. Configurer le modèle par défaut

Dans ~/.claude/settings.json :

{
  "defaultModel": "claude-sonnet-4-6",
  "thinkingMode": "auto"
}

Pour la majorité des tâches, Sonnet 4.6 est suffisant et 3x moins cher qu'Opus.

3. Activer les hooks essentiels

Les hooks Claude Code lancent des commandes automatiquement (lint, format, tests). Voir notre guide [Claude Code hooks pour automatiser](/blog/claude-code-hooks-automatiser-workflow) pour le détail.

4. Lier vos serveurs MCP préférés

Le Model Context Protocol (MCP) étend les capacités de Claude Code (accès GitHub, bases de données, etc.). Voir notre guide [MCP Claude Code](/blog/mcp-model-context-protocol-claude-code) pour la configuration.

Pour une démo vidéo complète de l'installation et de la première session, regardez cette vidéo récente.

Aller plus loin avec une formation structurée

Une installation propre est la première étape — mais elle ne fait pas de vous un expert Claude Code. Pour passer du débutant qui galère à l'utilisateur qui automatise des journées entières de travail, une formation structurée est l'investissement le plus rentable.

La [formation Claude Code complète](https://go.saas-ia.io/se-faire-remplacer-par-lia) couvre installation avancée, hooks, MCP, sous-agents, et projets pratiques de A à Z. C'est la formation la plus complète en français en 2026.

FAQ installation Claude Code {#faq}

Faut-il payer pour installer Claude Code ?

Non, l'installation est gratuite. En revanche, l'utilisation nécessite un compte Anthropic actif avec soit un abonnement Pro/Max/Teams (à partir de 20 USD/mois), soit une clé API avec crédits chargés. Anthropic offre parfois 5 USD de crédits gratuits aux nouveaux comptes pour tester avant de souscrire.

Claude Code fonctionne-t-il offline ?

Non, Claude Code est un client qui communique avec les modèles Anthropic via API. Une connexion internet stable est obligatoire pour chaque session. Aucun modèle local n'est inclus dans le binaire CLI.

Puis-je installer Claude Code sur plusieurs machines avec le même compte ?

Oui, vous pouvez installer le CLI sur autant de machines que vous voulez. L'authentification se fait par compte Anthropic, et les limites de votre abonnement (Pro/Max) s'appliquent globalement à toutes vos sessions actives, peu importe la machine.

Comment mettre à jour Claude Code ?

Selon votre méthode d'installation : npm update -g @anthropic-ai/claude-code (méthode npm), brew upgrade claude-code (méthode Homebrew), ou bun update -g @anthropic-ai/claude-code (méthode bun). Claude Code vérifie automatiquement les mises à jour au démarrage et vous prévient si une nouvelle version est disponible.

Puis-je désinstaller Claude Code complètement ?

Oui : npm uninstall -g @anthropic-ai/claude-code (ou équivalent selon votre installation), puis supprimez le dossier ~/.claude/ qui contient configuration, credentials, et historique de sessions. Sur Windows, le dossier équivalent est %USERPROFILE%\.claude\.

L'installation fonctionne-t-elle sans droits administrateur ?

Oui, si vous utilisez nvm (recommandé). nvm installe Node.js dans votre dossier home, et npm install -g installe ensuite Claude Code dans ce même dossier — aucun sudo nécessaire. C'est la méthode recommandée par Anthropic. Évitez sudo npm install qui casse les permissions et peut bloquer les mises à jour futures.

Y a-t-il un Docker officiel pour Claude Code ?

Anthropic publie une image Docker officielle depuis février 2026 : ghcr.io/anthropics/claude-code:latest. Pratique pour les pipelines CI/CD et les environnements isolés. La majorité des équipes qui automatisent l'IA en CI/CD utilisent désormais cette image, notamment chez [smartbtp.ai](https://smartbtp.ai) qui orchestre des pipelines de génération de devis BTP avec Claude Code en mode headless.

Conclusion

Installer Claude Code est aujourd'hui une opération de 5 minutes sur n'importe quel OS — à condition de respecter les prérequis (Node.js 20+, compte Anthropic actif, terminal moderne) et d'utiliser nvm plutôt que sudo. Sur macOS, la méthode npm globale est la plus simple ; sur Windows, WSL2 est devenu le standard 2026 ; sur Linux, l'installation est triviale et c'est même la plateforme la mieux supportée.

Une fois Claude Code installé, l'authentification interactive prend 30 secondes et vous êtes prêt à coder. Le vrai travail commence ensuite : maîtriser les commandes, configurer les hooks, exploiter MCP, et écrire des prompts efficaces. C'est tout l'objet de la [formation Claude Code complète](https://go.saas-ia.io/se-faire-remplacer-par-lia).

Articles connexes