Installer Claude Code sur Windows, Mac et Linux

Pour installer Claude Code, ouvre un terminal et colle une seule commande : curl -fsSL https://claude.ai/install.sh | bash sur Mac, Linux ou WSL, ou irm https://claude.ai/install.ps1 | iex dans PowerShell sur Windows. Ouvre ensuite une nouvelle fenêtre, tape claude --version pour vérifier, puis claude pour te connecter. Il te faut un abonnement Claude payant ou un compte Claude Console : le plan gratuit ne donne pas accès à Claude Code.

Pas de fichier à télécharger à la main : la commande s’en charge. Ce guide reprend chaque système pas à pas, puis les erreurs courantes. Les commandes viennent de la documentation officielle d’Anthropic, relue le 12 octobre 2026. Les méthodes ont changé plusieurs fois : en cas de doute, c’est elle qui fait foi.

Ce qu’il te faut avant d’installer

• Un système récent : macOS 13.0, Windows 10 version 1809 (ou Windows Server 2019), Ubuntu 20.04, Debian 10 ou Alpine Linux 3.19 au minimum.
• 4 Go de mémoire vive et un processeur x64 ou ARM64. Windows 32 bits n’est pas pris en charge.
• Une connexion internet, depuis un pays où Anthropic propose ses services.
• Un compte payant : abonnement Claude Pro, Max, Team ou Enterprise, ou compte Claude Console (l’accès par API, avec des crédits prépayés). Je compare les formules dans mon article sur le prix de Claude Code.
• Un terminal, c’est-à-dire la fenêtre où l’on tape des commandes : Terminal sur Mac, PowerShell ou l’invite de commandes (CMD) sur Windows.

L’installeur natif ne demande pas Node.js. Et si tu préfères éviter le terminal, Anthropic propose aussi une application de bureau pour Mac, Windows et Linux. Ce guide couvre la version terminal.

Le récapitulatif par système

L’installeur natif se met à jour tout seul. Avec Homebrew, WinGet ou les dépôts Linux, c’est à toi de lancer les mises à jour.

Installer Claude Code sur Mac

1. Ouvre le Terminal : appuie sur Cmd + Espace, tape « Terminal », puis Entrée.
2. Colle cette commande et valide avec Entrée :

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

3. Attends sans fermer la fenêtre : la commande n’affiche aucune progression pendant le téléchargement. À la fin, tu lis Claude Code successfully installed!.
4. Ouvre une nouvelle fenêtre de terminal et tape claude --version. Si un numéro de version suivi de (Claude Code) s’affiche, c’est installé.

Avec Homebrew

Si tu utilises déjà Homebrew, le gestionnaire de paquets courant sur Mac :

brew install --cask claude-code

Ce paquet suit le canal stable, en retard d’environ une semaine. claude-code@latest reçoit chaque version dès sa sortie. Pense à lancer brew upgrade claude-code de temps en temps.

Installer Claude Code sur Linux

1. Ouvre un terminal : Ctrl + Alt + T sur la plupart des distributions, ou cherche « Terminal » dans le menu.
2. Colle la commande avec Ctrl + Maj + V, puis Entrée :

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

3. Ouvre un nouveau terminal et vérifie avec claude --version.

Anthropic publie aussi des dépôts signés pour apt (Debian, Ubuntu), dnf (Fedora, RHEL) et apk (Alpine). Les commandes complètes, avec la vérification de la clé de signature, sont sur la page d’installation avancée d’Anthropic. Sur Alpine, installe d’abord quelques paquets absents par défaut : bash, curl, libgcc, libstdc++ et ripgrep.

Installer Claude Code sur Windows

Windows natif ou WSL : lequel choisir ?

Claude Code tourne directement sous Windows ou dans WSL, le sous-système qui fait tourner un vrai Linux dans Windows. Le choix dépend surtout de l’endroit où vivent tes projets.

Le bac à sable isole les commandes que Claude lance sur ta machine. Si tes fichiers sont dans Windows, l’installation native est la plus directe.

Installation native, pas à pas

1. Installe Git for Windows (facultatif). Il fournit Git Bash, que Claude Code utilise pour lancer ses commandes. Sans lui, Claude Code passe par PowerShell. Télécharge-le sur git-scm.com et garde les options par défaut.
2. Ouvre PowerShell. Appuie sur Win + X et choisis Windows PowerShell ou Terminal : ta ligne commence par PS C:\Users\TonNom>. Pas besoin des droits administrateur. Évite l’entrée « Windows PowerShell (x86) », une version 32 bits refusée par l’installeur.
3. Colle la commande (Ctrl + V ou clic droit), puis Entrée. irm télécharge le script, iex l’exécute :

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

4. Ouvre une nouvelle fenêtre et tape claude --version.

Si tu es dans l’invite de commandes (CMD), dont la ligne commence par C:\ sans le PS, utilise plutôt :

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

Avec WinGet, le gestionnaire de paquets de Windows, la commande est winget install Anthropic.ClaudeCode, puis winget upgrade Anthropic.ClaudeCode pour chaque mise à jour.

Installation dans WSL

1. Si WSL n’est pas encore installé, ouvre PowerShell en administrateur, lance wsl --install, puis redémarre. Microsoft installe Ubuntu par défaut, à partir de Windows 10 version 2004.
2. Ouvre ta distribution Linux, par exemple « Ubuntu » dans le menu Démarrer.
3. Lance la commande Linux dans ce terminal, pas dans PowerShell :

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

WSL n’a pas besoin de Git for Windows. Tu lanceras toujours claude depuis le terminal WSL.

Le premier lancement et la connexion

1. Place-toi dans le dossier de ton projet avec cd (pour « change directory »), puis lance Claude Code :

cd /chemin/vers/ton/projet
claude

2. Au premier lancement, ton navigateur s’ouvre. Connecte-toi avec ton compte Claude habituel ou ton compte Console. S’il ne s’ouvre pas, appuie sur c pour copier l’adresse de connexion et colle-la dans ton navigateur.
3. Le terminal affiche Login successful. Appuie sur Entrée. Tes identifiants sont enregistrés : pas besoin de te reconnecter à chaque session.

Ensuite, /login change de compte et /status affiche le compte actif. Un piège à connaître : si une variable ANTHROPIC_API_KEY traîne sur ta machine et que tu acceptes de l’utiliser, Claude Code passe par cette clé d’API au lieu de ton abonnement, et tu paies à l’usage.

Pour ta première demande, reste simple, par exemple : « explique-moi ce que fait ce projet ». Puis lance /init : Claude Code génère un premier fichier CLAUDE.md, les instructions qu’il relit à chaque session. C’est le moment d’écrire ton CLAUDE.md pour de bon.

Vérifier que l’installation fonctionne

Trois commandes couvrent l’essentiel :

• claude --version affiche le numéro de version.
• claude doctor, tapé dans le terminal, affiche un diagnostic sans ouvrir de session : état de l’installation, erreurs de réglages, avertissements avec la correction suggérée.
• /doctor, tapé dans une session, fait le bilan de ta configuration et propose des corrections que Claude applique après ton accord.

Mettre à jour Claude Code

Avec l’installeur natif, rien à faire. Claude Code cherche les mises à jour au démarrage et pendant qu’il tourne, les télécharge en arrière-plan et les applique au lancement suivant. Pour forcer une mise à jour :

claude update

Par défaut, tu suis le canal « latest » : chaque nouveauté dès sa sortie. Le canal « stable », en retard d’environ une semaine, saute les versions qui ont connu de grosses régressions. Le choix se fait dans /config.

Selon la méthode d’installation :

• Homebrew : brew upgrade claude-code (ou brew upgrade claude-code@latest).
• WinGet : winget upgrade Anthropic.ClaudeCode.
• npm : npm install -g @anthropic-ai/claude-code@latest, et non npm update -g, qui peut te laisser sur une ancienne version.
• apt, dnf, apk : avec les mises à jour habituelles de ton système.

Et npm, ça marche encore ?

Oui. L’installation par npm, le gestionnaire de paquets de Node.js, reste documentée parmi les options avancées. Elle demande Node.js 22 ou plus et installe le même programme que l’installeur natif :

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

N’ajoute jamais sudo devant : Anthropic le déconseille, pour des raisons de permissions et de sécurité. Sous Windows, si PowerShell répond running scripts is disabled on this system, lance Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ou passe à l’installeur natif, qui reste la voie recommandée.

Claude Code dans VS Code et JetBrains

VS Code (version 1.94.0 ou plus) : ouvre les extensions avec Ctrl + Maj + X (Cmd + Maj + X sur Mac), cherche « Claude Code » et clique sur Install. L’extension s’installe aussi dans Cursor. Elle embarque sa propre copie de Claude Code pour son panneau de discussion, mais n’ajoute pas la commande claude à ton terminal : pour la taper dans le terminal intégré, fais aussi l’installation décrite plus haut.

JetBrains (IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand, Android Studio) : le plugin n’embarque pas Claude Code. Installe d’abord Claude Code, puis le plugin (affiché en bêta) depuis la JetBrains Marketplace, et redémarre l’IDE. Lance ensuite claude dans son terminal intégré, ou /ide depuis un terminal externe.

Les erreurs fréquentes et leurs solutions

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

Ton terminal ne trouve pas le programme (sous Windows en français, le message est traduit). Le dossier ~/.local/bin (Mac, Linux) ou %USERPROFILE%\.local\bin (Windows) manque dans ton PATH, la liste des dossiers où le terminal cherche les programmes.

Ouvre d’abord une nouvelle fenêtre : celle de l’installation garde l’ancien PATH. Si l’erreur persiste, ajoute le dossier toi-même.

Sur Mac, avec Zsh (le shell par défaut, c’est-à-dire le programme qui interprète tes commandes) :

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

Sur Linux, avec Bash, remplace ~/.zshrc par ~/.bashrc.

Sur Windows, dans PowerShell :

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

Ferme et rouvre ensuite le terminal. S’il est intégré à VS Code, redémarre VS Code.

'irm' is not recognized ou The token '&&' is not a valid statement separator

Tu as collé la commande prévue pour un autre terminal. Si irm est inconnu, tu es dans CMD. Si l’erreur porte sur &&, tu es dans PowerShell avec la commande CMD. Si elle cite fsSL ou bash, tu as collé la commande Mac et Linux. Reprends la bonne commande de la section Windows.

syntax error near unexpected token '<' ou erreur 403

L’adresse d’installation a renvoyé une page web au lieu du script. Si le texte mentionne « App unavailable in region », Claude Code n’est pas disponible dans ton pays. Sinon, réessaie un peu plus tard, vérifie qu’un proxy ou un pare-feu d’entreprise ne bloque pas downloads.claude.ai, ou passe par Homebrew ou WinGet.

Erreur SSL/TLS sur un ancien Windows 10

Lance la première ligne avant l’installeur :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Killed pendant l’installation sur un petit serveur

L’installation demande environ 512 Mo de mémoire libre. Sur un petit serveur Linux (VPS), libère de la mémoire ou ajoute de l’espace d’échange (swap), puis relance l’installeur. Pour l’utiliser ensuite, il faut quand même 4 Go de mémoire vive.

La connexion bloque dans WSL ou en SSH

Le navigateur ne peut pas renvoyer la connexion vers le terminal. Il affiche alors un code : colle-le à l’invite Paste code here if prompted. Si la connexion échoue sans raison claire, tape /logout, ferme Claude Code, relance claude et reconnecte-toi.

Pour tout autre message, la page de dépannage d’Anthropic liste chaque erreur avec sa solution.

Désinstaller Claude Code

Pour une installation native sur Mac, Linux ou WSL :

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Sur Windows, dans PowerShell :

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Avec les autres méthodes : brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode ou npm uninstall -g @anthropic-ai/claude-code.

Tes réglages restent dans le dossier ~/.claude et le fichier ~/.claude.json. Les supprimer efface définitivement tes préférences, tes serveurs MCP et l’historique de tes sessions.

Et maintenant ?

Claude Code installé, le plus utile est de lui donner tes règles de travail dès le premier projet. Pour partir d’un exemple concret, mon CLAUDE.md commenté, 7 règles à copier, est offert à l’inscription à la newsletter « La Ligne de commande ».