Aller au contenu
Floskool

Chapitre 2 · Installation et configuration

Installer Claude Code sur Windows, Mac ou Linux

Leçon gratuite 9 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Le 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.
  • claude est « introuvable » ou « non reconnu » : ouvre un nouveau terminal. Si ça persiste, la leçon 6 t'explique quoi faire.
  • Tu as un message avec && ou irm : 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, puis claude doctor.
  • Homebrew, WinGet et npm existent aussi, sans mise à jour automatique par défaut ; jamais de sudo npm install -g.