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).¹ {.answer-block}

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, mais WSL 2 offre l’expérience identique à Linux, et l’installateur natif s’y exécute exactement de la même manière.¹

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.

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+ natif est pris en charge sur x64 et ARM64, mais WSL 2 reste la voie recommandée pour une parité complète avec Linux – exécutez-y la commande d’installation 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.