Installer Claude Code en 2026 : guide pour macOS, Windows, Linux et npm

Pour installer Claude Code, lancez l'installateur natif d'Anthropic dans un terminal (une commande pour macOS, Linux et WSL, une pour Windows PowerShell et une pour Windows CMD ; les trois figurent ci-dessous), puis démarrez Claude Code dans le dossier de votre projet et connectez-vous dans le navigateur. Il vous faut un plan Claude Pro, Max, Team ou Enterprise, un compte Claude Console (API), ou un accès via Amazon Bedrock, l'Agent Platform de Google Cloud ou Microsoft Foundry, car le plan Claude gratuit n'inclut pas Claude Code. Node.js n'est nécessaire que si vous choisissez la méthode npm.

Ce guide couvre toutes les méthodes d'installation officielles, la vérification de l'installation, la première connexion, les particularités de Windows et d'Alpine, et les solutions aux erreurs les plus souvent citées sur la page de dépannage d'Anthropic. Toutes les commandes ont été vérifiées dans la documentation Claude Code d'Anthropic le 17 octobre 2026.

Avant d'installer : compte et configuration requise

Quel compte vous faut-il

Si vous ne savez pas si un plan gratuit suffit, notre guide Claude est-il gratuit ? explique ce que couvre l'offre gratuite. Les étudiants et les mainteneurs open source ont intérêt à consulter les pages offres étudiantes Claude et Claude for Open Source avant de payer.

Configuration requise

• Système d'exploitation : macOS 13.0+, Windows 10 1809+ ou Windows Server 2019+, Ubuntu 20.04+, Debian 10+, ou Alpine Linux 3.19+
• Matériel : 4 Go de RAM ou plus, processeur x64 ou ARM64 (Windows 32 bits n'est pas pris en charge)
• Shell : Bash, Zsh, PowerShell ou CMD
• Réseau et localisation : une connexion internet, dans un pays pris en charge par Anthropic
• ripgrep : généralement inclus avec Claude Code ; sur Alpine, il doit être installé séparément (voir plus bas)

Étape 1 : choisir une méthode d'installation

La plupart des utilisateurs devraient choisir l'installateur natif. C'est la méthode recommandée par Anthropic, il se met à jour tout seul et ne nécessite aucun autre logiciel. Les gestionnaires de paquets sont pertinents si votre équipe gère déjà ses outils ainsi ou si vous voulez faire les mises à jour à votre rythme.

Étape 2 : lancer l'installateur natif

Ouvrez un terminal et lancez la commande correspondant à votre système.

macOS, Linux et WSL

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

Windows PowerShell

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

Windows CMD

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

Sous Windows, l'invite affiche PS C:\ dans PowerShell et C:\ sans PS dans CMD. Si vous voyez « The token '&&' is not a valid statement separator », vous êtes dans PowerShell : utilisez la commande PowerShell. Si vous voyez « 'irm' is not recognized », vous êtes dans CMD.

L'installateur n'affiche aucune progression pendant le téléchargement : attendez qu'il se termine. Sur macOS et Linux, il place le lanceur claude dans ~/.local/bin/claude et conserve les versions dans ~/.local/share/claude/versions/. Sous Windows, le programme est installé dans %USERPROFILE%\.local\bin\claude.exe. Aucun droit administrateur n'est nécessaire.

Installer plutôt le canal stable

Par défaut, vous obtenez le canal latest, qui livre les nouvelles versions immédiatement. Le canal stable fournit une version généralement vieille d'environ une semaine et ignore les versions présentant des régressions importantes. Le canal choisi à l'installation devient votre canal par défaut pour les mises à jour automatiques. macOS, Linux et WSL :

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

Windows PowerShell :

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Windows CMD :

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

Vous pouvez aussi indiquer un numéro de version précis à la place de stable. Notre guide de mise à jour explique comment figer une version, changer de canal plus tard et revenir en arrière.

Autres méthodes d'installation officielles

Homebrew (macOS et Linux)

brew install --cask claude-code

Le cask claude-code suit le canal stable. Pour recevoir les nouvelles versions dès leur sortie, installez plutôt le cask latest :

brew install --cask claude-code@latest

WinGet (Windows)

winget install Anthropic.ClaudeCode

apt (Debian et Ubuntu)

Anthropic publie des dépôts apt, dnf et apk signés. Ces commandes configurent le canal stable. D'abord, si curl ou gpg manquent sur un système neuf :

sudo apt install curl gnupg

Téléchargez la clé de signature :

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

Vérifiez la clé avant de lui faire confiance. L'empreinte doit être 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE :

gpg --show-keys /etc/apt/keyrings/claude-code.asc

Enregistrez le dépôt et installez :

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

dnf (Fedora et RHEL)

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

dnf vous demande de confirmer l'empreinte de la clé lors de la première installation. Elle doit correspondre à 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

apk (Alpine Linux)

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

npm

Le paquet npm nécessite Node.js 22 ou plus récent. Avec une version plus ancienne de Node.js, npm affiche un avertissement EBADENGINE mais l'installation se termine quand même :

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

Le paquet npm installe le même binaire natif que l'installateur autonome, récupéré via une dépendance optionnelle propre à chaque plateforme, et la commande claude installée n'utilise pas Node à l'exécution. Les plateformes npm prises en charge sont darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 et win32-arm64, et votre gestionnaire de paquets doit autoriser les dépendances optionnelles.

N'utilisez pas sudo pour une installation npm globale. Anthropic avertit que cela peut provoquer des problèmes de permissions et des risques de sécurité. En cas d'erreurs de permissions, passez à l'installateur natif ou suivez la page de dépannage officielle.

Étape 3 : vérifier l'installation

Ouvrez une nouvelle fenêtre de terminal (l'ancienne garde son ancien PATH) et lancez :

claude --version

Une installation fonctionnelle affiche un numéro de version suivi de (Claude Code). Si votre shell indique que claude est introuvable, le dossier d'installation n'est pas encore dans votre PATH ; la section de dépannage ci-dessous donne la solution. Pour un diagnostic plus complet en lecture seule sans démarrer de session, qui signale aussi les erreurs et avertissements des fichiers de paramètres avec des corrections suggérées, lancez :

claude doctor

Étape 4 : démarrer Claude Code et se connecter

Allez dans le dossier de votre projet et démarrez une session :

cd /path/to/your/project
claude

Au premier lancement, Claude Code ouvre une fenêtre de navigateur pour la connexion. Si le navigateur ne s'ouvre pas, appuyez sur c pour copier l'URL de connexion et collez-la dans un navigateur. Une fois connecté, le terminal affiche Login successful et vous demande d'appuyer sur Entrée. Ces comptes fonctionnent :

• Claude Pro, Max, Team ou Enterprise : connectez-vous avec votre compte claude.ai. L'usage est décompté des limites de votre plan.
• Claude Console : facturation API à l'usage. Si vous rejoignez l'organisation Console de quelqu'un d'autre, un administrateur doit d'abord vous inviter. À la première connexion, Claude Code crée un workspace « Claude Code » dans la Console pour le suivi des coûts.
• Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry : définissez les variables d'environnement du fournisseur, ou choisissez 3rd-party platform à l'invite de connexion. Aucune connexion via le navigateur n'est nécessaire.

Si ANTHROPIC_API_KEY est définie et que vous l'acceptez quand on vous le demande, Claude Code saute la connexion via le navigateur et facture vos crédits API ; notre guide de la clé API Anthropic explique comment en créer une et l'approvisionner. Pour changer de compte plus tard, tapez ceci dans une session :

/login

Se connecter via SSH, dans WSL2 ou dans un conteneur

Dans ces cas, le navigateur s'ouvre généralement sur une autre machine et ne peut pas rediriger vers Claude Code. Après la connexion, le navigateur affiche à la place un code de connexion ; collez-le à l'invite Paste code here if prompted. Si le collage dans l'invite ne fonctionne pas, connectez-vous avec cette commande, qui lit le code collé depuis l'entrée standard :

claude auth login

Si le navigateur ne s'ouvre pas du tout depuis WSL2, faites pointer la variable BROWSER vers votre navigateur Windows, par exemple :

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Essayer une première tâche

Le guide de démarrage d'Anthropic suggère de commencer par des questions en langage courant sur votre code. Tapez des prompts comme ceux-ci à l'invite de Claude Code :

what does this project do?
where is the main entry point?
add a hello world function to the main file

Claude Code lit les fichiers selon les besoins et demande avant d'effectuer des modifications, selon le mode de permission de la session (appuyez sur Shift+Tab pour changer de mode). Pour des modifications plus importantes, consultez notre guide du mode plan de Claude Code.

Installer Claude Code sous Windows

Vous pouvez exécuter Claude Code nativement sous Windows ou dans WSL :

• Vous n'avez pas besoin d'exécuter l'installateur en tant qu'administrateur.
• Sans Git for Windows, Claude Code exécute les commandes shell via son outil PowerShell. S'il est installé, Claude Code peut aussi utiliser Git Bash pour son outil Bash.
• Pour WSL, ouvrez votre distribution WSL et lancez-y l'installateur Linux. Installez et lancez claude dans WSL, pas depuis PowerShell ou CMD.
• Si une ancienne installation de Claude Desktop fait que la commande claude ouvre l'application Desktop au lieu de la CLI, mettez Claude Desktop à jour vers la dernière version.

Si Claude Code ne trouve pas Git Bash, indiquez son chemin dans votre fichier settings.json :

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

Installer sur Alpine et d'autres Linux basés sur musl

La commande d'installation nécessite bash et curl, et Claude Code a besoin de libgcc, libstdc++ et ripgrep à l'exécution. Alpine n'inclut ni bash ni curl par défaut : installez donc d'abord les paquets :

apk add bash curl libgcc libstdc++ ripgrep

ripgrep se trouve dans le dépôt community d'Alpine ; ajoutez-le à /etc/apk/repositories si apk ne trouve pas le paquet. Indiquez ensuite à Claude Code d'utiliser le ripgrep du système dans settings.json :

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Dépannage de l'installation

Voici les problèmes les plus souvent traités sur la page de dépannage de l'installation d'Anthropic, avec les solutions officielles.

« command not found: claude » ou « 'claude' is not recognized »

L'installation a fonctionné mais son dossier n'est pas dans votre PATH. Ouvrez d'abord un nouveau terminal. Si cela échoue toujours sur macOS ou Linux, vérifiez que le fichier existe :

ls -la ~/.local/bin/claude

Si c'est le cas, ajoutez le dossier à votre PATH. Pour Zsh, le shell par défaut de macOS :

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

Pour Bash sous Linux :

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

Pour Bash sous macOS, utilisez ~/.bash_profile au lieu de ~/.bashrc, car Terminal démarre Bash comme shell de connexion. Sous Windows PowerShell, ajoutez le dossier d'installation à votre PATH utilisateur, puis redémarrez le terminal :

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Un terminal intégré à un éditeur comme VS Code récupère son PATH depuis l'éditeur : quittez et rouvrez donc aussi l'éditeur. Notez que l'extension VS Code embarque sa propre copie privée de Claude Code et n'ajoute pas claude à votre PATH ; lancez l'installateur autonome si vous voulez la commande dans un terminal.

« syntax error near unexpected token '<' » ou une erreur 403 de l'installateur

L'URL d'installation a renvoyé une page web ou une erreur au lieu du script. Si la sortie mentionne App unavailable in region, Claude Code n'est pas disponible dans votre pays. Sinon, il s'agit souvent d'un problème temporaire, d'un proxy ou pare-feu, ou d'un routage régional. Réessayez après quelques minutes, vérifiez que vous pouvez joindre le serveur de téléchargement, ou utilisez plutôt Homebrew ou WinGet. Pour tester la connectivité sur macOS ou Linux :

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Une première ligne avec un statut 200 signifie que vous avez atteint le serveur. Derrière un proxy d'entreprise, définissez HTTP_PROXY et HTTPS_PROXY avec l'adresse de votre proxy avant de lancer l'installateur.

« Killed » pendant l'installation sur un petit serveur Linux

Le gestionnaire de mémoire insuffisante (OOM killer) a interrompu l'installation. Anthropic indique que l'installation nécessite environ 512 Mo de mémoire libre, et que Claude Code requiert au moins 4 Go de RAM pour fonctionner. Fermez d'autres processus, utilisez une instance plus grande, ou ajoutez de l'espace swap et réessayez :

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

L'installation se bloque dans Docker

Lancer l'installateur en root depuis / lui fait analyser tout le système de fichiers. Définissez d'abord un répertoire de travail :

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

Erreurs TLS ou SSL

Des erreurs comme curl: (35) TLS connect error ou Could not create SSL/TLS secure channel dans PowerShell signifient que la connexion sécurisée a échoué. Sous Ubuntu ou Debian, mettez à jour vos certificats CA :

sudo apt-get update && sudo apt-get install ca-certificates

Dans Windows PowerShell 5.1, activez TLS 1.2 dans la même fenêtre avant de lancer l'installateur :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Derrière un proxy d'entreprise qui inspecte le TLS, demandez au service informatique le certificat CA du proxy et faites pointer NODE_EXTRA_CA_CERTS vers celui-ci une fois Claude Code installé.

Homebrew indique que le cask n'est pas disponible

Votre index Homebrew local est plus ancien que le cask. Actualisez-le et réessayez :

brew update
brew install --cask claude-code

npm : « claude native binary not installed » ou scripts désactivés

Le paquet npm fournit le vrai binaire sous forme de dépendance optionnelle et le relie via une étape postinstall. Si vous avez installé avec --omit=optional ou --ignore-scripts (ou une configuration pnpm qui les ignore), réinstallez sans ces options. Sous Windows, « running scripts is disabled on this system » vient de la stratégie d'exécution de PowerShell qui bloque les scripts .ps1 de npm ; autorisez les scripts créés localement pour votre utilisateur, ou utilisez plutôt l'installateur natif :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Une ancienne version continue de se lancer après l'installation

Vous avez probablement deux installations, par exemple une ancienne installation npm et une nouvelle installation native. Sur macOS ou Linux, listez toutes les commandes claude présentes dans votre PATH :

which -a claude

Gardez-en une seule (Anthropic recommande l'installation native) et supprimez les autres, par exemple la copie npm :

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

Problèmes de connexion

• API Error: 403 Request not allowed après la connexion : pour Pro ou Max, vérifiez que votre abonnement est actif dans les paramètres de claude.ai. Pour les comptes Console, un administrateur doit vous attribuer le rôle Claude Code ou Developer sur la page Members.
• OAuth error: Invalid code : le code a expiré ou a été tronqué. Réessayez et allez vite, ou appuyez sur c pour copier l'URL complète.
• « This organization has been disabled » malgré un abonnement actif : une ancienne ANTHROPIC_API_KEY dans votre profil shell prend le pas sur votre connexion. Retirez-la de votre profil et supprimez-la de la session (la commande figure dans notre guide de la clé API).
• Déconnexions répétées : vérifiez que l'horloge de votre système est exacte, car la validation des jetons en dépend, puis reconnectez-vous.

Pour repartir de zéro côté connexion, tapez ceci dans Claude Code, fermez-le, puis relancez claude et connectez-vous :

/logout

Vous préférez ne pas utiliser de terminal ?

Anthropic propose aussi Claude Code dans une application Desktop pour macOS, Windows et Linux, sur le web à l'adresse claude.ai/code, et sous forme d'extensions pour VS Code et les IDE JetBrains. Il vous faut toujours un plan payant éligible ou un compte Console. Pour garder la version en ligne de commande à jour par la suite, consultez comment mettre à jour Claude Code.