Chapter 2 · Installation et configuration
Installer Claude Code sur Windows, Mac ou Linux
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLe pourquoi : une commande, et c'est installé
Léa redoutait cette étape : « installer un outil en ligne de commande », ça sonnait comme un truc de développeur. En réalité, l'installation officielle tient en une seule ligne à copier dans un terminal. Le plus dur, c'est de choisir la bonne ligne pour ton système. Cette leçon te guide.
Toutes les commandes ci-dessous viennent de la documentation officielle d'Anthropic (https://code.claude.com/docs/en/setup), lue le 29 octobre 2026. Elles peuvent évoluer : en cas de doute, vérifie sur cette page.
Le comment : la méthode recommandée (installation native)
La documentation recommande l'installation native. Son avantage : elle se met à jour automatiquement en arrière-plan.
Étape 1 : ouvre le bon terminal
- Mac : ouvre l'application Terminal.
- Linux : ouvre ton terminal habituel.
- Windows : ouvre PowerShell (recommandé) ou CMD.
Sur Windows, regarde l'invite (le texte avant le curseur) : dans PowerShell elle affiche PS C:\, dans CMD elle affiche C:\ sans PS. Ce détail compte, car la commande n'est pas la même.
Étape 2 : colle la commande de ton système
macOS, Linux ou WSL (WSL : un Linux qui tourne dans Windows) :
curl -fsSL https://claude.ai/install.sh | bash
Windows, dans PowerShell :
irm https://claude.ai/install.ps1 | iex
Windows, dans CMD :
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Appuie sur Entrée. L'installeur n'affiche pas de barre de progression pendant le téléchargement : c'est normal, patiente sans fermer la fenêtre.
Étape 3 : ferme et rouvre ton terminal
Une fois l'installation terminée, ouvre une nouvelle fenêtre de terminal. Cela permet à l'ordinateur de trouver la commande claude.
Étape 4 : vérifie l'installation
claude --version
Une installation correcte affiche un numéro de version. L'exemple de la documentation ressemble à 2.1.211 (Claude Code) ; ton numéro sera probablement différent, c'est normal.
Pour un diagnostic plus complet :
claude doctor
claude doctor vérifie la santé de l'installation et signale les erreurs dans les fichiers de réglages, avec des corrections suggérées. Il ne fait que lire : il ne modifie rien et n'ouvre pas de session.
Les autres méthodes officielles
Si tu utilises déjà un gestionnaire de logiciels, la documentation propose aussi :
Homebrew (Mac) :
brew install --cask claude-code
WinGet (Windows) :
winget install Anthropic.ClaudeCode
npm (gestionnaire de paquets de Node.js) :
npm install -g @anthropic-ai/claude-code
Attention à trois points. Homebrew et WinGet ne se mettent pas à jour automatiquement par défaut. npm nécessite Node.js 22 ou plus. Et la documentation est claire : n'utilise jamais sudo npm install -g. Des dépôts apt, dnf et apk existent aussi pour Linux : vérifie la documentation officielle pour leur mode d'emploi.
Si tu débutes, reste sur l'installation native : une seule ligne, et les mises à jour se font seules.
Mettre à jour plus tard
Avec l'installation native, c'est automatique. Tu peux aussi forcer une mise à jour :
claude update
Tu verras soit « Successfully updated from ... to version ... », soit « Claude Code is up to date ». Pour les autres méthodes : brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode ou npm install -g @anthropic-ai/claude-code@latest.
Si ça coince
- Rien ne s'affiche pendant l'installation : normal, l'installeur n'a pas de progression visible. Attends.
claudeest « introuvable » ou « non reconnu » : ouvre un nouveau terminal. Si ça persiste, la leçon 6 t'explique quoi faire.- Tu as un message avec
&&ouirm: tu as collé la commande du mauvais terminal (PowerShell au lieu de CMD, ou l'inverse). Détails en leçon 6. - Tu préfères ne pas toucher au terminal : l'application Desktop existe pour macOS, Windows et Linux. Vérifie son installation dans la documentation officielle.
À toi de jouer
Installe Claude Code avec la commande native de ton système. Puis lance claude --version et claude doctor, et note dans ta fiche de départ le numéro de version obtenu et les éventuels avertissements. Léa, sur son Mac, a collé la ligne curl, attendu, rouvert Terminal, et vu un numéro de version s'afficher. Étape franchie.
En bref
- La méthode recommandée est l'installation native, qui se met à jour seule.
- Choisis la commande de ton terminal : macOS/Linux/WSL, PowerShell ou CMD.
- L'installeur n'affiche pas de progression : patiente, puis ouvre un nouveau terminal.
- Vérifie avec
claude --version, puisclaude doctor. - Homebrew, WinGet et npm existent aussi, sans mise à jour automatique par défaut ; jamais de
sudo npm install -g.