Installer et mettre à jour Claude Code CLI : Mac, Linux, Windows

Installer Claude Code tient en une seule commande par plateforme – curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, ou irm https://claude.ai/install.ps1 | iex dans Windows PowerShell – et la mise à jour est soit automatique (le comportement par défaut), soit un simple claude update. Ce que la plupart des pages passent sous silence, c’est tout ce qui vient après cette première commande : quelle méthode d’installation choisir quand il y en a quatre, comment se comporte l’autoupdater et comment le désactiver, comment épingler une version précise, et comment désinstaller proprement chaque méthode. Cette page est cette référence, un tableau par tâche, à jour à la v2.1.224 (août 2026).¹

TL;DR

• Utilisez l’installateur natif. Il n’a aucune dépendance à Node.js, livre le binaire testé pour chaque plateforme et constitue la méthode par défaut depuis la v2.1.113. Le paquet npm appartient au passé – déprécié depuis la v2.1.15, il réclame désormais Node.js 22 ou plus.¹
• Les mises à jour sont automatiques par défaut : Claude Code vérifie au démarrage puis périodiquement pendant les sessions, télécharge en arrière-plan et applique au lancement suivant. claude update en force une immédiatement.²
• Désactiver les mises à jour passe par deux interrupteurs distincts : DISABLE_AUTOUPDATER=1 arrête les mises à jour en arrière-plan ; DISABLE_UPDATES=1 (v2.1.118+) bloque toutes les voies de mise à jour, y compris un claude update manuel.²
• Épinglez une version en la passant à l’installateur : curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58. Vérifiez ce que vous exécutez avec claude --version ; parcourez les changements avec /release-notes.¹²
• Au moindre comportement suspect, lancez claude doctor – il indique le type d’installation, la version et les problèmes détectés ; depuis la v2.1.205, la commande /doctor en session diagnostique et corrige les défauts de configuration.²

Comment installer Claude Code CLI ?

Une commande, par plateforme :

# macOS, Linux, 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

Vous préférez un gestionnaire de paquets ? Les deux sont pleinement pris en charge :

brew install --cask claude-code          # macOS / Linux (stable channel)
winget install Anthropic.ClaudeCode      # Windows

Lancez ensuite claude dans un répertoire de projet et authentifiez-vous avec un abonnement Claude Pro/Max/Team ou un compte API Anthropic.¹ L’installateur natif n’exige ni Node.js, ni sudo, ni quoi que ce soit de préinstallé. Si vous devez passer par l’ancienne voie npm (npm install -g @anthropic-ai/claude-code), elle réclame Node.js 22 ou plus et ne doit jamais être exécutée avec sudo – des modules globaux appartenant à root créent des problèmes de permissions qui survivent à l’installation.¹ Déjà sur npm ? claude install vous fait migrer sur place vers le binaire natif.

Pour la configuration de la première session – choix d’authentification, premier prompt, modes de permission –, le guide de démarrage rapide couvre le trajet de zéro au premier résultat.

Quelles plateformes Claude Code prend-il en charge ?

La question qui revient sans cesse à propos de Windows : le Windows natif fonctionne et ne demande aucun droit administrateur ; la recommandation d’Anthropic elle-même est de choisir selon l’emplacement de vos projets et vos besoins, avec WSL 2 quand vous voulez des chaînes d’outils Linux ou l’exécution de commandes en sandbox, et le même installateur Linux s’y exécute.³ Le mode auto de Claude Code n’est pas une frontière de sécurité soutient que la véritable frontière est l’isolation au niveau du système d’exploitation, et non le mode auto.

Comment mettre à jour Claude Code ?

En général, vous n’avez rien à faire. Claude Code se met à jour tout seul par défaut – il cherche une nouvelle version au démarrage puis périodiquement pendant les sessions, télécharge en arrière-plan et applique la mise à jour au lancement suivant.² Pour forcer une mise à jour immédiate, ou si vous avez désactivé l’autoupdater :

claude update

Les installations par gestionnaire de paquets se mettent à jour par leur propre canal – brew upgrade --cask claude-code, winget upgrade Anthropic.ClaudeCode – et depuis la v2.1.129, définir CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 permet à ces installations de lancer la mise à niveau du gestionnaire de paquets en arrière-plan et de proposer un redémarrage.²

Le contrôle des mises à jour repose sur deux interrupteurs distincts, et la différence compte dans les environnements verrouillés :

Définissez l’un ou l’autre comme variable d’environnement ou sous "env" dans settings.json.²

Comment installer une version précise ?

Passez la version à l’installateur – pratique pour reproduire un bug, maintenir une équipe sur une version réputée saine, ou revenir en arrière :

# Specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Latest, explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell, specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Confirmez avec claude --version, et lisez ce que chaque version a changé grâce au sélecteur /release-notes disponible en session.² Si vous épinglez, associez cela à DISABLE_AUTOUPDATER=1 – sinon l’autoupdater vous désépinglera poliment au lancement suivant. (Utilisez plutôt DISABLE_UPDATES=1 si vous voulez aussi verrouiller le claude update manuel.)

Comment désinstaller Claude Code ?

Faites correspondre la désinstallation à la méthode d’installation :

Votre configuration vit à part dans ~/.claude/ : supprimer le binaire n’efface donc ni les paramètres, ni les skills, ni l’historique – ne supprimez ce dossier que si vous voulez vraiment repartir d’une page blanche.¹

Tout le cycle de vie dans un seul tableau

Et quand quelque chose cloche – mauvaise version signalée, commande introuvable après une mise à jour, installation appliquée à moitié –, claude doctor depuis le shell indique le type d’installation, la version et les problèmes détectés, tandis que /doctor en session (v2.1.205+) effectue un bilan complet capable de corriger ce qu’il trouve.² Le guide complet de Claude Code couvre tout ce qui vient après l’installation : configuration, permissions, hooks, MCP et subagents.

Dépannage sous Windows : claude non reconnu, mauvais shell, scripts bloqués

La plupart des échecs sous Windows relèvent de l’un de ces neuf cas, chacun avec un message d’erreur reconnaissable. Chaque correctif ci-dessous provient de la page de dépannage de l’installation et de la page de configuration d’Anthropic, dans leur état du 7 septembre 2026.³⁴

1. 'claude' is not recognized as an internal or external command (CMD) ou The term 'claude' is not recognized as the name of a cmdlet (PowerShell). L’installateur a placé claude.exe dans %USERPROFILE%\.local\bin\claude.exe ; ce répertoire n’est pas dans votre PATH, ou vous êtes encore dans le terminal depuis lequel vous avez installé, qui conserve son ancien PATH. Vérifiez, ajoutez, puis ouvrez un nouveau terminal :⁴

$env:PATH -split ';' | Select-String '\.local\\bin'      # no output = not on PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Dans CMD, la vérification se fait avec echo %PATH% | findstr /i "local\bin", et le correctif consiste à ajouter %USERPROFILE%\.local\bin au PATH utilisateur dans les variables d’environnement.⁴

2. 'irm' is not recognized, The token '&&' is not a valid statement separator ou A parameter cannot be found that matches parameter name 'fsSL'. Vous avez lancé la ligne d’installation prévue pour un autre shell. Si irm est introuvable, vous êtes dans CMD (l’invite affiche C:\) : utilisez l’installateur CMD présenté plus haut, ou ouvrez PowerShell (PS C:\). Si && est refusé, vous êtes dans PowerShell en train d’exécuter la ligne CMD : utilisez irm https://claude.ai/install.ps1 | iex. La plainte au sujet de fsSL signifie que vous avez collé la ligne macOS/Linux curl -fsSL ... | bash dans PowerShell, où curl est un alias d’Invoke-WebRequest. Si la commande affiche le texte du script sans rien installer, vous avez exécuté la moitié qui télécharge sans la partie qui l’exécute.⁴

3. running scripts is disabled on this system / PSSecurityException. La stratégie d’exécution de PowerShell bloque les shims de lancement .ps1 que crée npm (npm.ps1, claude.ps1). Elle n’affecte pas l’installateur natif, qui fait passer le texte téléchargé par iex plutôt que par un fichier enregistré, et un ClaudeInstall.ps1 enregistré puis lancé avec -ExecutionPolicy Bypass -File ne fait pas partie des voies d’installation documentées par Anthropic (la page de configuration ne liste que la ligne irm, l’installateur CMD, WinGet et npm). Les correctifs, dans l’ordre : Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ; ou bien appelez claude.cmd (la stratégie ne couvre pas .cmd) ; ou encore remplacez l’installation npm par l’installateur natif.⁴

4. Erreurs d’analyse d’iex qui citent des balises HTML ou du CSS, ou curl: (22) The requested URL returned error: 403. L’URL d’installation a renvoyé une page web au lieu du script. Si la page indique « App unavailable in region », Claude Code n’est pas proposé dans votre pays ; sinon, un proxy ou un filtre fait obstacle. Testez l’accessibilité avec curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest (appelez curl.exe explicitement ; l’alias curl de PowerShell refuse -sI) : une première ligne 200 signifie que l’hôte est joignable et que l’échec était passager. winget install Anthropic.ClaudeCode est l’alternative documentée.⁴

5. Could not establish trust relationship for the SSL/TLS secure channel ou CRYPT_E_NO_REVOCATION_CHECK (0x80092012). Pour la première, forcez TLS 1.2 avant de lancer l’installateur : [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12. Les erreurs de révocation signifient que votre réseau bloque les vérifications de révocation des certificats ; ajoutez --ssl-revoke-best-effort à la ligne curl de CMD, ou utilisez l’installateur PowerShell, qui télécharge via .NET et tolère un serveur de révocation injoignable.⁴

6. The process cannot access the file ... because it is being used by another process. Un installateur précédent tourne encore, ou un antivirus analyse un téléchargement partiel dans %USERPROFILE%\.claude\downloads. Fermez les autres fenêtres PowerShell, attendez la fin de l’analyse, puis :⁴

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

7. La mauvaise version s’exécute, ou deux installations se contredisent. where.exe claude liste chaque claude présent dans votre PATH ; Test-Path "$env:USERPROFILE\.local\bin\claude.exe" indique si l’installateur natif a placé son binaire. Gardez l’installation native et supprimez les autres (winget uninstall Anthropic.ClaudeCode, npm uninstall -g @anthropic-ai/claude-code, Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local" pour une ancienne installation npm locale). claude doctor affiche le type d’installation et la version qu’il exécute réellement.⁴

8. Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. Aucun des deux shells n’a été trouvé. Git for Windows est facultatif : sans lui, Claude Code exécute les commandes via son outil PowerShell ; avec lui, l’outil Bash utilise Git Bash. Si Git Bash est installé mais introuvable, indiquez son emplacement dans settings.json :³

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

9. Claude Code does not support 32-bit Windows. Vous avez ouvert l’entrée PowerShell x86 sur une machine 64 bits. Ouvrez « Windows PowerShell », et non l’entrée « (x86) ».⁴

Si aucun de ces cas ne correspond, claude doctor (en lecture seule, sans démarrer de session) indique l’état de l’installation, les erreurs dans les fichiers de paramètres et le résultat de la dernière tentative de mise à jour, et la page de dépannage d’Anthropic tient à jour le tableau complet des erreurs et de leurs correctifs.³⁴

Questions fréquentes

Comment mettre à jour Claude Code CLI vers la dernière version ?

Lancez claude update, ou redémarrez simplement : par défaut, Claude Code cherche des mises à jour au démarrage et pendant les sessions, télécharge en arrière-plan et applique au lancement suivant. Les installations Homebrew et winget se mettent à jour via brew upgrade --cask claude-code et winget upgrade Anthropic.ClaudeCode.

Claude Code se met-il à jour automatiquement ?

Oui, par défaut : il vérifie au démarrage et périodiquement en cours d’exécution, puis applique la mise à jour téléchargée au lancement suivant. DISABLE_AUTOUPDATER=1 coupe les mises à jour en arrière-plan tout en conservant le claude update manuel ; DISABLE_UPDATES=1 bloque toutes les voies de mise à jour.

Comment installer Claude Code sur Windows ?

Lancez irm https://claude.ai/install.ps1 | iex dans PowerShell (ou winget install Anthropic.ClaudeCode). Windows 10 (1809+) natif est pris en charge sur x64 et ARM64 sans droits administrateur ; choisissez WSL 2 quand vous avez besoin de chaînes d’outils Linux ou de l’exécution de commandes en sandbox, et exécutez-y la commande d’installation Linux pour une parité complète avec Linux.

Ai-je besoin de Node.js pour installer Claude Code ?

Non – l’installateur natif recommandé n’a aucune dépendance à Node.js. Seul l’ancien paquet npm (npm install -g @anthropic-ai/claude-code, déprécié depuis la v2.1.15) réclame Node, et il exige Node.js 22 ou plus. Si vous êtes sur l’installation npm, claude install vous fait migrer vers le binaire natif.

Comment vérifier quelle version de Claude Code j’utilise ?

claude --version depuis le shell, ou /release-notes en session pour un sélecteur de changelog interactif. claude doctor indique en plus le type d’installation et les éventuels problèmes de configuration détectés.