Prerequis systeme detailles
Claude Code est une CLI Node.js qui tourne sur les trois grandes familles d'OS. Avant installation, verifiez que votre environnement est pret :
- Node.js : version 18 LTS minimum, version 20 LTS recommandee en 2026. Verification :
node --version
- npm : 9.x ou superieur (installe avec Node). Verification :
npm --version
- RAM : 4 Go minimum, 8 Go recommandes pour travailler sur des repos larges
- Espace disque : 500 Mo pour l'outil et le cache
- Git : 2.30+ (indispensable pour les operations de worktree)
- Acces reseau : sortie HTTPS vers api.anthropic.com et les serveurs MCP configures
- Compte Anthropic : avec une cle API active sur console.anthropic.com
Les modeles 2026 supportes par Claude Code sont Claude Haiku 4.5 (rapide, economique), Claude Sonnet 4.6 (equilibre, modele par defaut) et Claude Opus 4.7 (reflexion avancee, fenetre de contexte 1M tokens).
Installation par OS
macOS
# Via Homebrew (recommande)
brew install node
npm install -g @anthropic-ai/claude-code
# Ou via nvm
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code
Linux (Ubuntu / Debian)
# Via NodeSource
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Installation Claude Code
sudo npm install -g @anthropic-ai/claude-code
# Alternative : nvm (sans sudo)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20
npm install -g @anthropic-ai/claude-code
Windows (WSL2 recommande)
# Installer WSL2 (PowerShell admin)
wsl --install -d Ubuntu-22.04
# Dans le shell WSL Ubuntu
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs git
npm install -g @anthropic-ai/claude-code
# Verification
claude --version
Note Windows : Claude Code natif Windows (PowerShell / cmd) a des limitations connues sur certaines operations (symlinks, permissions). WSL2 est la voie recommandee pour un confort equivalent a macOS/Linux.
Troubleshooting des problemes frequents
EACCES : permission denied
Erreur classique sur macOS/Linux quand npm tente d'installer en global sans les droits.
# Solution 1 : utiliser nvm (preferable, evite sudo)
# Solution 2 : changer le repertoire npm global
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code
Conflit de versions npm
Si une ancienne installation reside dans /usr/local, desinstaller proprement d'abord :
npm uninstall -g @anthropic-ai/claude-code
npm cache clean --force
which claude # doit etre vide
npm install -g @anthropic-ai/claude-code
Cle API non reconnue
Apres claude config set api-key sk-ant-..., si l'erreur persiste, verifier :
- Presence de la variable d'environnement conflictuelle :
echo $ANTHROPIC_API_KEY
- Lecture du fichier :
cat ~/.config/claude/config.json
- Quota API sur console.anthropic.com (credits restants, plan actif)
Mise a jour et desinstallation propre
# Mise a jour
npm update -g @anthropic-ai/claude-code
# Verifier la version installee vs derniere
npm outdated -g @anthropic-ai/claude-code
# Desinstallation complete
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.config/claude
rm -rf ~/.claude
FAQ Installation Claude Code
Faut-il obligatoirement Node.js 20 ?
Non, Node.js 18 LTS reste supporte mais Node.js 20 LTS est recommande en 2026 pour les performances et la compatibilite avec les derniers serveurs MCP. Node.js 22 fonctionne mais n'est pas encore officiellement valide.
Claude Code fonctionne-t-il sans abonnement Claude.ai ?
Claude Code utilise votre cle API Anthropic et est facture a l'usage (tokens consommes). Un abonnement Claude Pro/Max permet un usage plus economique via certaines integrations, mais n'est pas strictement requis.
Peut-on installer Claude Code sur un serveur distant ?
Oui. Sur un VPS Linux, l'installation est identique. L'authentification se fait via cle API. Pour les environnements headless, prevoir ANTHROPIC_API_KEY en variable d'environnement.
Claude Code natif Windows est-il stable en 2026 ?
Il fonctionne pour un usage basique mais presente encore des limitations sur les worktrees Git, symlinks et hooks shell. WSL2 reste la voie recommandee pour les usages avances (agents, MCP, automation).
Comment verifier que l'installation fonctionne ?
Lancer claude --version puis claude dans un repertoire de projet : une session interactive doit demarrer. Tester avec une requete simple (ex : "liste les fichiers du repo"). Si la reponse arrive, l'installation et la cle API sont fonctionnelles.
Quel modele Claude choisir par defaut ?
Claude Sonnet 4.6 pour un bon equilibre qualite/cout (modele par defaut). Haiku 4.5 pour les taches simples, repetitives et economiques. Opus 4.7 pour les refactors complexes ou l'analyse de larges codebases (contexte 1M tokens).
