Installer Claude Code sur Windows, macOS & Linux (mai 2026)

Claude Code est passé de zéro à plus d’un million de recherches mensuelles en moins d’un an. Si tu débarques ici parce que “tout le monde en parle” et que tu veux tester par toi-même, voilà ton guide setup en 5 minutes pour n’importe quel OS.

Quatre trucs à savoir avant de commencer :

1. Il te faut un plan payant. Claude Pro (20$/mois), Max, Team, Enterprise ou un compte Claude Console débloquent Claude Code. Le plan gratuit Claude.ai n’inclut pas Claude Code.
2. Claude Code vit dans ton terminal — la fenêtre texte où tu tapes des commandes. (Anthropic propose aussi une app desktop si tu préfères zapper le terminal.)
3. L’installeur natif est la méthode officielle en 2026. Anthropic a aussi ajouté Homebrew, WinGet et des dépôts de paquets Linux signés début 2026. Si tu travailles déjà avec un gestionnaire de paquets, tu as maintenant des options de premier choix. La voie legacy npm marche encore mais n’est plus recommandée.
4. Heads-up bug de tokens : Les versions depuis v2.1.100 gonflent la conso de tokens d’environ 40 %. La dernière au 4 mai est v2.1.126 — workaround plus bas.

Choisis ton OS — chaque chemin d’install est une seule commande :

C’est parti.

Configuration requise

Avant d’installer, vérifie que tu es sur un OS supporté :

Si t’es sur Windows 11, tranquille. Si t’es sur macOS Monterey (12) ou plus vieux, mets à jour avant.

Installer sur Windows

T’as trois chemins sur Windows. Choisis selon que tu as besoin d’un toolchain style Linux (WSL) ou que tu veux rester en natif (PowerShell + Git Bash).

Windows natif : PowerShell (le chemin le plus simple)

Ouvre PowerShell (pas besoin d’Administrateur) et lance :

irm https://claude.ai/install.ps1 | iex

Si irm te renvoie “is not recognized as an internal or external command”, t’es dans CMD, pas PowerShell. Le prompt affiche PS C:\ en PowerShell vs C:\ en CMD. Pour utiliser CMD :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Après l’install, ferme et rouvre ton terminal pour rafraîchir le PATH, puis vérifie :

claude --version
claude doctor

Recommandé : Installe Git for Windows avant de lancer claude. Anthropic le recommande parce que Claude Code utilise Git Bash en interne pour ses outils shell. Sans lui, Claude Code se rabat sur PowerShell comme outil shell, qui a moins de fonctionnalités.

Si claude doctor râle qu’il ne trouve pas Git Bash, indique-lui le chemin dans ~/.claude/settings.json :

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Windows natif : WinGet (installation gérée)

Anthropic publie Claude Code via le gestionnaire de paquets officiel de Microsoft :

winget install Anthropic.ClaudeCode

Les installations WinGet ne se mettent pas à jour toutes seules — fais winget upgrade Anthropic.ClaudeCode régulièrement.

Installer sur Windows avec WSL

WSL 2 (Windows Subsystem for Linux) te donne un vrai environnement Linux dans Windows. Anthropic recommande WSL quand tu veux de l’exécution de commandes en sandbox ou que tu travailles déjà avec des toolchains Linux.

Étape 1 — Installer WSL. Ouvre PowerShell en Administrateur et lance :

wsl --install

Redémarre quand on te le demande. Après le reboot, ouvre le terminal Ubuntu depuis le menu Démarrer.

Étape 2 — Installer Claude Code dans WSL. Au prompt Ubuntu :

curl -fsSL https://claude.ai/install.sh | bash

Étape 3 — Vérifier et bosser sur un projet :

claude --version
claude doctor
cd /mnt/c/Users/TON_NOM/chemin/vers/projet
claude

Le chemin /mnt/c/ est la façon dont WSL accède à tes disques Windows. Ton C: est sous /mnt/c/, D: sous /mnt/d/, etc.

Installer sur macOS ou Linux

Ouvre Terminal. Colle ça. Appuie sur Entrée.

curl -fsSL https://claude.ai/install.sh | bash

Voilà toute l’installation. L’installeur natif télécharge le binaire, le pose dans ~/.local/bin et configure l’auto-update. Pas besoin de Node.js, zéro dépendance, pas de drama de gestionnaire de paquets.

Vérifie que ça marche :

claude --version
claude doctor

claude doctor lance des diagnostics : statut auth, PATH, config, serveurs MCP. Lance-le toujours après l’install pour choper les problèmes tôt.

Maintenant, va dans un projet :

cd /chemin/vers/ton/projet
claude

C’est tout. T’es dans Claude Code.

Installer avec Homebrew (macOS)

Si tu gères déjà tes outils avec Homebrew, Anthropic publie un cask officiel :

brew install --cask claude-code

Y’a en fait deux casks :

• claude-code — suit le canal stable (environ une semaine derrière latest, saute les releases avec grosses régressions). Le plus safe.
• claude-code@latest — suit le canal latest (versions neuves dès leur sortie).

# Pour le canal bleeding-edge :
brew install --cask claude-code@latest

Heads-up : les installations Homebrew ne s’auto-updatent pas. Lance brew upgrade claude-code (ou claude-code@latest) pour avoir les versions neuves et les patches de sécu.

Installer sur Linux avec les gestionnaires de paquets

Anthropic publie des dépôts apt, dnf et apk signés. C’est la voie la plus propre sur Debian/Ubuntu, Fedora/RHEL et Alpine parce que les updates passent par ton workflow normal d’upgrade système.

Debian / Ubuntu (apt) :

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Vérifie le fingerprint de la clé GPG avant de la trust : gpg --show-keys /etc/apt/keyrings/claude-code.asc doit afficher 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

Fedora / RHEL (dnf) :

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Alpine (apk) :

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Pour le canal rolling, change stable en latest dans l’URL et le nom de suite. Mets à jour ensuite avec ta commande gestionnaire de paquets normale (sudo apt upgrade claude-code, sudo dnf upgrade claude-code, apk upgrade claude-code).

Installer via npm (la voie legacy)

Si t’as déjà Node.js 18+ installé et que tu préfères npm :

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

Ça installe le même binaire natif que l’installeur standalone, via une dépendance optionnelle par plateforme. Trois raisons que la plupart des gens évitent maintenant :

1. Pas d’auto-update. Tu fais npm update à la main quand de nouvelles versions sortent.
2. Demande Node.js 18+. L’installeur natif a zéro dépendance.
3. Erreurs de permissions. Surtout avec sudo npm install -g — ne fais pas ça.

Si t’as déjà installé via npm et tu veux migrer vers natif :

curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

Authentification (la danse du login)

La première fois que tu lances claude, ça ouvre ton navigateur pour le login OAuth. Connecte-toi avec le compte Anthropic que tu utilises :

• Abonnement perso Claude Pro/Max — login claude.ai
• Claude Team ou Enterprise — login de ton workspace
• Claude Console — si ta boîte t’a invité

Si ton navigateur ne s’ouvre pas tout seul, appuie sur c dans le terminal pour copier l’URL de login, colle-la dans ton navigateur, finis le login, puis colle le code dans le terminal quand on te le demande.

Pour changer de compte plus tard :

/logout

(Cette commande va dans Claude Code, pas dans ton shell.)

Tes premières commandes

Une fois que claude t’a déposé dans une session interactive, teste :

/help          # Affiche toutes les commandes
/status        # Voir auth, abo, rate limits
/config        # Voir la config actuelle
/logout        # Se déconnecter

Depuis ton shell (en dehors de la session interactive) :

claude doctor    # Rapport diagnostic
claude --version # Version installée
claude mcp list  # Lister les serveurs MCP configurés

Une vraie première tâche

Ouvre un projet que t’as déjà. N’importe quoi — une app Next.js, un script Python, un repo de configs. Lance Claude Code :

cd /chemin/vers/projet
claude

Ensuite tape une vraie tâche en français ou en anglais. Du genre :

“Lis le README et explique-moi comment ce projet est organisé.”

Ou :

“Ajoute une fonction qui valide les adresses email. Mets-la là où ça colle le mieux dans le codebase.”

Ou :

“Trouve tous les commentaires TODO et liste-les avec les chemins de fichiers.”

Claude regarde tes fichiers, réfléchit, et propose des changements. Il te demande d’approuver chaque édit avant de le faire. Tu gardes le contrôle.

Problèmes typiques de setup (et fixes)

“command not found: claude”

L’installeur a posé le binaire dans ~/.local/bin, mais ton shell ne connaît pas ce répertoire. Ajoute-le au PATH :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Remplace .bashrc par .zshrc si t’es sur zsh (le default macOS depuis Catalina).

“The token ‘&&’ is not a valid statement separator”

T’as collé une commande style CMD dans PowerShell. Soit tu passes en CMD, soit tu utilises la version PowerShell :

irm https://claude.ai/install.ps1 | iex

“Permission denied” pendant npm install

T’as essayé sudo npm install -g et t’as cassé les permissions. N’utilise pas sudo avec npm. À la place :

• Utilise l’installeur natif (pas besoin de sudo) : curl -fsSL https://claude.ai/install.sh | bash
• Utilise nvm (Node Version Manager) pour installer Node dans ton home

WSL ne capte pas internet

Teste avec curl https://claude.ai. Si ça échoue, ton firewall Windows ou ton VPN bloque WSL. La plupart des VPN ont une option “exclude local traffic” — active-la.

Rate limited dès l’install

T’es sur Pro et tu touches les limites en moins d’une heure ? C’est un vrai problème qu’Anthropic a reconnu le 31 mars 2026. Vérifie ta version Claude Code :

claude --version

La dernière build au 4 mai est v2.1.126 (sortie le 1er mai), qui a ajouté la commande utile claude project purge [path] et fixé un bug du pourcentage /context d’Opus 4.7 — mais le problème d’inflation de tokens introduit en v2.1.100 n’a toujours pas de patch public. Workaround d’après les retours communauté : redescendre en v2.1.34, ou réinstaller via npm plutôt que le binaire natif.

Tu peux pinner une version spécifique avec l’installeur natif :

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.34

Ou pinner un plancher minimum dans ~/.claude/settings.json pour que les futurs updates ne te renvoient pas par erreur sur une mauvaise version :

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.34"
}

Étendre Claude Code avec MCP

Une fois que les bases tournent, le vrai pouvoir est de connecter Claude Code à d’autres outils via MCP (Model Context Protocol). MCP transforme Claude Code d’“assistant de codage” en “assistant avec accès direct à tes bases de données, APIs et outils d’équipe”.

Lister les serveurs MCP actuels :

claude mcp list

Ajouter un nouveau (exemple — connecter une base de données) :

claude mcp add my-db --command "docker run --rm my-db-mcp:latest"

Chaque projet peut avoir son propre fichier .claude/.mcp.json listant les serveurs MCP que ce projet utilise. Les codebases partagés peuvent commit ce fichier pour que toute l’équipe ait le même setup d’outils.

Antisèche par OS

Ce que ça signifie pour toi

Si t’as jamais utilisé un terminal : Reste sur macOS ou WSL sur Windows. Le terminal fait partie de l’identité de Claude Code — tu peux pas vraiment l’utiliser sans au moins un confort de base avec le terminal. Passe un peu de temps à apprendre cd, ls, pwd et les bases de git si c’est pas déjà fait.

Si t’es dev en train d’évaluer Claude Code : Installe-le en 5 minutes, pointe-le sur un side project, donne-lui une vraie tâche. Cursor c’est plus style IDE, Copilot c’est plus style autocomplete — Claude Code est genuinement différent, et faut le sentir pour comprendre.

Si tu setup ça pour ton équipe : Crée un dossier .claude/ dans tes repos partagés avec la config MCP de l’équipe. Commit-le. Les nouveaux membres lancent l’installeur, s’authentifient, et héritent du setup d’outils de l’équipe automatiquement.

Si t’as déjà installé Claude Code : L’écosystème de plugins et MCP, c’est là que tu passes de “user” à “power user”. Notre cours Maîtrise de Claude Code creuse en profondeur skills, hooks et MCP.

En résumé

Installer Claude Code prend entre 30 secondes et 5 minutes selon ton OS. L’installeur natif (default depuis avril 2026) est fiable, rapide et sans dépendances.

La vraie courbe d’apprentissage, c’est pas l’installation — c’est de découvrir comment utiliser Claude Code de façon productive une fois installé. Commence par des tâches petites, grandis vers des workflows plus gros, ajoute des outils MCP quand tu trouves de vrais besoins. N’essaie pas de tout configurer le jour un.

Et budgète l’abonnement. Le plan gratuit ne te mènera pas où tu veux. Pro à 20$/mois est le vrai point d’entrée.

Étape suivante : Notre cours Maîtrise de Claude Code couvre tout le workflow — de la première install aux patterns agentic avancés avec skills, hooks et MCP. Si t’es déjà installé, Outils MCP pour l’IA est le complément parfait pour connecter Claude Code à tes bases de données et APIs.

Sources (vérifiées le 4 mai 2026) :

• Claude Code Setup — Documentation officielle (vérifié en direct pour la syntaxe des commandes)
• Claude Code Changelog — Officiel
• Release Claude Code v2.1.126 — 1er mai 2026
• Install Claude Code — Anthropic