Installer Claude Code sur macOS, Windows, Linux et VS Code

Pour apprendre à vous servir de Claude Code sur un vrai projet, la formation Claude Code de Dyma reprend tout en vidéo, de l’installation aux agents. Ce guide couvre toutes les façons d’installer Claude Code : installateur natif, Homebrew, WinGet, dépôts apt, dnf et apk, npm, l’extension VS Code et le plugin JetBrains. Il explique aussi le choix entre Windows natif et WSL, les mises à jour, le proxy d’entreprise, les erreurs fréquentes et la désinstallation. Chaque commande a été vérifiée le 2 novembre 2026 sur la documentation officielle d’Anthropic (version 2.1.316 de Claude Code).

Avant d’installer : système et compte

Claude Code tourne sur un processeur x64 ou ARM64, avec au moins 4 Go de RAM, une connexion internet et l’un de ces shells : Bash, Zsh, PowerShell ou CMD.

Côté compte, la documentation est claire : Claude Code demande un abonnement Pro, Max, Ultra, Team ou Enterprise, ou un compte Console (facturation à l’usage de l’API). Il fonctionne aussi avec Amazon Bedrock, Google Cloud et Microsoft Foundry pour les entreprises qui passent par leur fournisseur cloud. Le détail des prix et du coût réel est dans notre article Claude Code : prix, plans et coût réel.

Quelle méthode d’installation choisir ?

Toutes les méthodes installent le même programme. Elles diffèrent surtout par la façon dont il se met à jour.

Installer Claude Code sur macOS

Ouvrez le Terminal et lancez l’installateur natif :

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

Avec Homebrew, deux casks existent. claude-code suit le canal stable, en général une semaine derrière la dernière version ; claude-code@latest suit les sorties au fil de l’eau :

brew install --cask claude-code

Le lanceur est placé dans ~/.local/bin/claude et les versions dans ~/.local/share/claude/. Vos identifiants sont rangés dans le trousseau macOS, chiffré.

Installer Claude Code sur Linux

La même commande que sur macOS fonctionne sur les distributions prises en charge, sans sudo. Sur Alpine et les autres distributions basées sur musl, installez d’abord bash, curl, libgcc, libstdc++ et ripgrep, puis réglez la variable USE_BUILTIN_RIPGREP à 0.

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

Sur un poste ou un serveur que vous administrez par paquets, Anthropic publie des dépôts signés pour apt (Debian, Ubuntu), dnf (Fedora, RHEL) et apk (Alpine). Pour apt, canal stable :

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

Ces paquets ne se mettent pas à jour seuls : sudo apt update && sudo apt upgrade claude-code, sudo dnf upgrade claude-code ou apk update && apk upgrade claude-code s’en chargent, avec le reste du système. Les commandes dnf et apk sont sur la page d’installation de la documentation.

Sur un petit serveur, l’installation demande environ 512 Mo de mémoire libre. Si elle s’arrête sur Killed, ajoutez 2 Go de swap avant de relancer.

Installer Claude Code sur Windows : natif ou WSL ?

Claude Code fonctionne directement sous Windows, sans droits administrateur. Dans PowerShell (l’invite commence par PS C:\) :

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

Dans l’invite de commandes CMD :

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

Ou avec WinGet : winget install Anthropic.ClaudeCode. Git for Windows est facultatif mais recommandé : avec lui, Claude Code exécute ses commandes dans Git Bash ; sans lui, dans PowerShell.

Si vous travaillez déjà dans WSL, installez plutôt Claude Code dans votre distribution Linux, avec la commande Linux, et lancez-le depuis le terminal WSL, pas depuis PowerShell. La documentation compare les trois options :

Sous WSL 1, le binaire peut échouer avec cannot execute binary file: Exec format error. Le correctif recommandé est de passer la distribution en WSL 2, depuis PowerShell : wsl --set-version <nom-de-la-distribution> 2.

Installer Claude Code avec npm

La méthode npm reste proposée. Elle demande Node.js 22 ou plus récent :

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

N’utilisez jamais sudo npm install -g. Le paquet télécharge le même binaire natif que l’installateur. Avec npm 12, qui saute les scripts d’installation, l’erreur claude native binary not installed apparaît : passez à l’installateur natif. Pour quitter npm, lancez l’installateur natif puis npm uninstall -g @anthropic-ai/claude-code.

Vérifier l’installation et se connecter

1. Ouvrez un nouveau terminal pour qu’il tienne compte du PATH mis à jour.
2. Vérifiez la version avec claude --version, puis l’installation avec claude doctor.
3. Lancez Claude Code dans le dossier d’un projet, avec claude.
4. Connectez-vous dans le navigateur qui s’ouvre ; sinon, la touche c copie l’adresse.
5. C’est prêt quand le terminal affiche Login successful.

Pour changer de compte, tapez /login dans Claude Code ; pour vous déconnecter, /logout. Hors session, claude auth status indique le compte utilisé. Sur macOS les identifiants sont dans le trousseau ; sur Linux et Windows, dans ~/.claude/.credentials.json.

Attention à une clé ANTHROPIC_API_KEY oubliée dans votre environnement : une fois acceptée, elle passe avant votre abonnement, et vos requêtes sont alors facturées à l’usage sur la Console.

Claude Code dans VS Code, Cursor et JetBrains

VS Code. Cherchez « Claude Code » (éditeur Anthropic) dans les extensions ; il faut VS Code 1.94 ou plus récent. L’extension ajoute un panneau graphique : relecture des plans, comparaison des modifications, mentions de fichiers avec plages de lignes, plusieurs conversations en onglets. Elle embarque son propre moteur, mais n’ajoute pas la commande claude au terminal : installez aussi la version en ligne de commande si vous voulez les deux.

Cursor et autres éditeurs dérivés de VS Code. La même extension s’installe dans Cursor, et dans les éditeurs qui passent par le registre Open VSX. Le 29 octobre 2026, la place de marché de Cursor a distribué des versions piégées (2.1.312 et 2.1.313) de l’extension, sous Windows et macOS : si vous l’avez installée ou mise à jour ce jour-là dans Cursor, suivez la procédure de vérification publiée par Cursor.

JetBrains. Le plugin « Claude Code [Beta] » fonctionne dans la plupart des IDE JetBrains : IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand, Android Studio. Il n’embarque pas Claude Code : installez d’abord la ligne de commande. Il s’ouvre avec Cmd+Esc sur Mac et Ctrl+Esc sous Windows et Linux ; depuis un terminal externe, la commande /ide le relie à votre IDE.

Sans la ligne de commande. L’application de bureau Claude (macOS, Windows, Linux en bêta) contient Claude Code dans son onglet Code. Claude Code existe aussi sur le web, à l’adresse claude.ai/code, sur un dépôt GitHub. Les deux demandent aussi un abonnement Claude payant.

Mettre à jour, choisir son canal, installer une version précise

Homebrew et WinGet ne se mettent pas à jour seuls, sauf si vous définissez la variable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1. Les réglages se placent dans le fichier settings.json de Claude Code, ou passent par la commande /config. Le canal latest est celui par défaut.

Pour installer une version précise, passez son numéro (ou stable) à l’installateur. Sur macOS, Linux et WSL :

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

Dans PowerShell :

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

Dans CMD :

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

Le canal choisi à l’installation devient celui des mises à jour. Une version précise ne bloque pas les mises à jour automatiques : pour la garder, coupez-les avec DISABLE_AUTOUPDATER.

Installer derrière un proxy d’entreprise

Exportez HTTPS_PROXY (et HTTP_PROXY) avant de lancer l’installateur : Claude Code les respecte aussi ensuite. Les proxys SOCKS ne sont pas pris en charge. Si votre proxy inspecte le trafic TLS et que son certificat n’est pas dans le magasin du système, passez-le à curl pendant l’installation (curl --cacert /chemin/vers/ca.pem -fsSL https://claude.ai/install.sh | bash), puis à Claude Code avec NODE_EXTRA_CA_CERTS=/chemin/vers/ca.pem. Les domaines à autoriser au minimum : api.anthropic.com, claude.ai, claude.com, platform.claude.com et downloads.claude.ai (plus registry.npmjs.org pour une installation npm).

Les erreurs d’installation les plus fréquentes

Pour ajouter le dossier au PATH avec Zsh, la documentation donne :

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

Avec Bash, remplacez ~/.zshrc par ~/.bashrc sous Linux et par ~/.bash_profile sous macOS.

Désinstaller Claude Code

Pour l’installation native, sur macOS, Linux et WSL :

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

Sous Windows, dans PowerShell :

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

Avec un gestionnaire de paquets : brew uninstall --cask claude-code (ou claude-code@latest), winget uninstall Anthropic.ClaudeCode, sudo apt remove claude-code ou npm uninstall -g @anthropic-ai/claude-code. Vos réglages, serveurs MCP et historique restent dans ~/.claude et ~/.claude.json : supprimez-les seulement si vous voulez repartir de zéro. Désinstallez d’abord l’extension VS Code, le plugin JetBrains et l’application de bureau, qui recréeraient ce dossier.

Et maintenant ?

Claude Code est installé : notre tutoriel Claude Code vous guide dans votre première session, de l’exploration du projet au premier changement vérifié. Pour le configurer à votre façon, chaque module a son guide : le fichier CLAUDE.md, les skills, les hooks et les serveurs MCP. Vous hésitez encore avec un autre assistant ? Lisez notre comparatif Claude Code, Cursor, Copilot ou Codex.

Pour apprendre de façon structurée, la formation Claude Code suit un projet fil rouge du début à la fin. Si vous voulez aller au-delà de Claude Code et intégrer des modèles dans vos propres applications, la formation IA pour développeurs couvre les API, les agents et MCP. Et pour utiliser Claude au quotidien hors du code, il y a la formation Claude.

Questions fréquentes