Mettre à jour Claude Code en 2026 : dernière version, changelog et désinstallation

Si vous avez installé Claude Code avec l'installateur natif, il se met à jour tout seul en arrière-plan, et la commande de mise à jour intégrée de Claude Code applique immédiatement une nouvelle version. Les installations Homebrew, WinGet, apt, dnf et apk ne se mettent pas à jour automatiquement par défaut : vous les mettez donc à niveau avec votre gestionnaire de paquets. Les installations npm se mettent à jour en réinstallant le paquet avec le tag @latest. Toutes les commandes figurent ci-dessous, regroupées par méthode d'installation.

Ce guide couvre aussi les canaux de publication (latest ou stable), le blocage d'une version ou le retour à une version antérieure, la désactivation des mises à jour, la lecture du changelog, la correction des mises à jour échouées et la désinstallation. Il a été vérifié dans la documentation et le changelog de Claude Code d'Anthropic le 17 octobre 2026.

Étape 1 : vérifier votre version actuelle

claude --version

La sortie ressemble à 2.1.302 (Claude Code). Dans une session en cours, cette commande affiche votre version, votre modèle, votre compte et l'état de la connexion :

/status

Pour lire les nouveautés de chaque version sans quitter Claude Code, ouvrez le sélecteur de versions interactif :

/release-notes

Vous ne savez plus comment vous l'avez installé ?

La commande de mise à jour dépend de la méthode d'installation : vérifiez-la d'abord. L'installateur natif place un lanceur dans ~/.local/bin/claude sur macOS et Linux (un lien symbolique vers ~/.local/share/claude/versions/) ou claude.exe dans %USERPROFILE%\.local\bin sous Windows. Sur macOS ou Linux, cette commande liste toutes les commandes claude présentes dans votre PATH, ce qui révèle aussi les installations en double :

which -a claude

Sous Windows PowerShell :

where.exe claude

Pour savoir si Homebrew l'a installé, et avec quel cask :

brew list --cask | grep claude-code

Pour un rapport complet en lecture seule, incluant l'état de l'installation et le résultat de la dernière tentative de mise à jour, lancez :

claude doctor

Étape 2 : mettre à jour avec la commande adaptée à votre installation

Installateur natif (macOS, Linux, WSL, Windows)

claude update

Quand une mise à jour s'installe, la commande affiche Successfully updated, de l'ancienne version vers la nouvelle. Si vous êtes à jour, elle indique que Claude Code est à jour. Les installations gérées par Homebrew, WinGet ou apk affichent plutôt Claude is up to date!, car c'est le gestionnaire de paquets qui les contrôle.

Homebrew

Pour le cask stable :

brew upgrade claude-code

Pour le cask latest :

brew upgrade claude-code@latest

Homebrew conserve les anciennes versions sur le disque après les mises à niveau. Lancez de temps en temps la commande de nettoyage pour libérer de l'espace :

brew cleanup

WinGet

winget upgrade Anthropic.ClaudeCode

apt (Debian, Ubuntu)

sudo apt update && sudo apt upgrade claude-code

dnf (Fedora, RHEL)

sudo dnf upgrade claude-code

apk (Alpine)

apk update && apk upgrade claude-code

npm

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

Pour les installations npm, évitez la commande de mise à jour globale de npm. Elle respecte la plage de versions de votre installation d'origine et peut ne pas vous faire passer à la dernière version. Utilisez plutôt la commande @latest ci-dessus, et n'installez jamais avec sudo.

Après toute mise à jour, ouvrez une nouvelle session (ou redémarrez Claude Code) et vérifiez à nouveau la version. Les mises à jour prennent effet au prochain démarrage de Claude Code.

Comment fonctionnent les mises à jour automatiques

Claude Code vérifie les mises à jour au démarrage et régulièrement pendant son exécution. Les mises à jour se téléchargent et s'installent en arrière-plan, puis prennent effet au prochain démarrage de Claude Code. Le rapport doctor de l'étape 1 affiche le résultat de la dernière tentative de mise à jour.

• Les installations natives se mettent à jour automatiquement par défaut.
• Les installations npm se mettent à jour automatiquement lorsque le répertoire global de npm est accessible en écriture. Sinon, Claude Code affiche un avis unique au démarrage, et le rapport doctor liste les corrections possibles.
• Les installations Homebrew, WinGet, apt, dnf et apk ne se mettent pas à jour automatiquement par défaut. apt, dnf et apk nécessitent toujours une mise à niveau manuelle, car ces commandes exigent des privilèges élevés.
• Lanceurs personnalisés : si vous remplacez ~/.local/bin/claude par votre propre script ou lien symbolique, les mises à jour installent toujours les nouvelles versions dans le répertoire versions/ mais ne touchent pas à votre lanceur, et Claude Code conserve toutes les versions installées sur le disque. Supprimez votre lanceur et lancez la commande de mise à jour pour rendre la main à Claude Code.

Sur les installations natives, Claude Code supprime lui-même les anciennes versions : en plus de la version utilisée, il conserve les deux versions les plus récentes et supprime le reste.

Laisser Claude Code lancer les mises à niveau Homebrew ou WinGet

Définissez la variable d'environnement CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE à 1, par exemple dans le bloc env de settings.json. Claude Code lance alors la mise à niveau du gestionnaire de paquets en arrière-plan lorsqu'une nouvelle version est disponible et vous invite à redémarrer en cas de succès. La mise à niveau ne concerne que le paquet Claude Code.

{
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
  }
}

Avec WinGet, la mise à niveau peut échouer pendant l'exécution de Claude Code, car Windows verrouille l'exécutable ; Claude Code affiche alors la commande manuelle. Anthropic signale aussi un problème connu : Claude Code peut annoncer une mise à jour avant que votre gestionnaire de paquets ne la propose. Si une mise à niveau échoue, patientez et réessayez plus tard.

Choisir un canal de publication : latest ou stable

Le paramètre autoUpdatesChannel détermine les versions que reçoivent les installations natives et npm, pour les mises à jour en arrière-plan comme pour la commande de mise à jour manuelle. Modifiez-le sous Auto-update channel dans l'écran des paramètres, que vous ouvrez avec cette commande dans Claude Code :

/config

Ou définissez-le dans settings.json :

{
  "autoUpdatesChannel": "stable"
}

Un modèle tout juste lancé peut nécessiter une version de Claude Code plus récente que celle du canal stable. Si vous voulez ce modèle immédiatement, passez à latest. Les organisations peuvent imposer un canal à tous via les paramètres gérés.

Canaux pour Homebrew et les paquets Linux

Homebrew choisit le canal selon le nom du cask, et non via le paramètre : claude-code suit stable et claude-code@latest suit latest. Les dépôts apt, dnf et apk choisissent le canal selon l'URL du dépôt. Pour apt, passer à latest modifie à la fois le chemin de l'URL et le nom de la suite :

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list

Pour dnf, faites pointer baseurl dans /etc/yum.repos.d/claude-code.repo vers le dépôt latest :

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

Pour apk, supprimez la ligne stable et ajoutez le dépôt latest :

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

Conserver une version minimale en passant à stable

Passer de latest à stable pourrait sinon vous ramener à une version plus ancienne. Lorsque vous changez de canal dans l'écran des paramètres, Claude Code vous demande s'il faut rester sur votre version actuelle ou autoriser le retour en arrière ; rester définit minimumVersion pour vous. Vous pouvez aussi fixer ce plancher vous-même, et les mises à jour refuseront toute version inférieure :

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Installer une version précise ou revenir en arrière

L'installateur natif accepte un numéro de version ou un nom de canal. Si une nouvelle version vous pose problème, réinstaller une version antérieure est la méthode officielle pour revenir en arrière. Par exemple, pour installer la version 2.1.89 sur macOS, Linux ou WSL :

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

Dans Windows PowerShell :

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

Dans Windows CMD :

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

Si Claude Code est déjà installé, sa propre sous-commande install fait la même chose et accepte aussi stable ou latest :

claude install 2.1.89

La commande de version affiche alors exactement la version demandée. Sauf si vous désactivez aussi les mises à jour automatiques (section suivante), la prochaine mise à jour en arrière-plan vous fera de nouveau avancer.

Désactiver les mises à jour automatiques

Pour arrêter les mises à jour en arrière-plan, ajoutez DISABLE_AUTOUPDATER avec la valeur "1" dans le bloc env de settings.json. Les mises à jour manuelles et la sous-commande install continuent de fonctionner.

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Sur une installation native ou npm, vérifiez que le réglage a pris effet dans le rapport doctor de l'étape 1 : la ligne Auto-updates doit indiquer disabled (set by env: DISABLE_AUTOUPDATER) au lieu de enabled. Pour bloquer toutes les voies de mise à jour, y compris les mises à jour manuelles, définissez plutôt DISABLE_UPDATES. Anthropic le recommande aux organisations qui distribuent Claude Code par leurs propres canaux et ont besoin que tout le monde utilise la version qu'elles fournissent.

{
  "env": {
    "DISABLE_UPDATES": "1"
  }
}

Utiliser une ancienne version, c'est passer à côté des correctifs de sécurité et de la prise en charge des nouveaux modèles. Si vous bloquez une version, programmez un rappel pour consulter le changelog et avancer à votre rythme.

Où trouver le changelog de Claude Code

• Dans Claude Code, la commande de notes de version présentée à l'étape 1 ouvre un sélecteur de versions ; les notes s'affichent dans votre transcription sans être envoyées à Claude.
• Le changelog de la documentation, sur code.claude.com/docs/en/changelog, est généré à partir du fichier CHANGELOG.md du dépôt GitHub anthropics/claude-code.
• Lors de notre vérification le 17 octobre 2026, l'entrée la plus récente était la version 2.1.302, datée du 16 octobre 2026. Les versions sortent souvent, parfois plusieurs fois par jour : consultez le changelog pour connaître le numéro actuel.

Le changelog est aussi l'endroit où Anthropic consigne les correctifs du système de mise à jour lui-même, ce qui est utile quand une mise à jour se comporte mal. Par exemple, la documentation de dépannage indique qu'un blocage des commandes update et doctor a été corrigé dans la v2.1.214, et qu'un bug de mise à jour sous Windows pouvant faire perdre la sauvegarde de claude.exe a été corrigé dans la v2.1.281.

Dépannage des mises à jour

« The connection dropped while downloading the update »

Claude Code relance un téléchargement interrompu, bloqué ou corrompu, jusqu'à trois tentatives au total. Un téléchargement qui reste connecté mais ne se termine pas en 10 minutes échoue avec Download timed out: exceeded the total deadline et n'est pas relancé. Relancez la mise à jour, idéalement sur un réseau plus rapide. Si votre réseau nécessite un proxy, définissez d'abord HTTPS_PROXY ; si un proxy d'entreprise interrompt sans cesse le transfert, demandez à votre équipe réseau d'autoriser downloads.claude.ai.

La commande de mise à jour se bloque après « Checking for updates »

Avant la v2.1.214, un répertoire situé à l'emplacement d'un fichier de configuration shell comme ~/.zshrc ou ~/.bashrc bloquait les commandes update et doctor. Trouvez-le avec :

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Une ligne commençant par d désigne le coupable. Déplacez-le, ou mettez à jour en relançant le script d'installation, puisque la commande de mise à jour elle-même se bloque sur les versions concernées :

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

'claude' n'est pas reconnu juste après une mise à jour sous Windows

Les mises à jour sous Windows renomment l'ancien claude.exe en une sauvegarde nommée claude.exe.old. suivi d'un horodatage, puis mettent la nouvelle version en place. Si cela a échoué, restaurez la sauvegarde la plus récente dans PowerShell :

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

S'il n'y a pas de sauvegarde, réinstallez :

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

Erreur npm ENOTEMPTY pendant une mise à jour

npm n'a pas pu déplacer l'ancien répertoire du paquet. Sur macOS ou Linux, supprimez-le ainsi que les copies temporaires restantes, puis réinstallez :

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*
npm install -g @anthropic-ai/claude-code

Homebrew : « Cask 'claude-code@latest' is not installed »

Vous mettez à niveau l'autre cask. Vérifiez lequel vous avez avec la commande brew list de l'étape 1 et mettez celui-ci à niveau. Si Homebrew propose une version plus ancienne que celle du changelog, rappelez-vous que le cask claude-code suit le canal stable, en retard d'environ une semaine ; actualisez l'index de Homebrew ou passez au cask latest.

La version n'a pas changé après la mise à jour

• La nouvelle version prend effet au prochain démarrage : quittez Claude Code et relancez-le.
• Vous avez peut-être deux installations (par exemple npm et native) et l'ancienne apparaît en premier dans votre PATH. Utilisez la vérification du PATH de l'étape 1, gardez une seule installation et supprimez les autres.
• Un lanceur personnalisé dans ~/.local/bin/claude détermine la version exécutée ; les mises à jour ne le remplacent pas.
• Vos paramètres définissent peut-être le canal stable, une minimumVersion, ou DISABLE_AUTOUPDATER ou DISABLE_UPDATES, ou votre organisation impose une version via les paramètres gérés. Le rapport doctor indique ce qui s'applique.

Comment désinstaller Claude Code

Suivez les étapes de suppression correspondant à votre méthode d'installation. Si claude se lance encore ensuite, vous avez probablement une seconde installation ou un alias shell restant.

Installation native : macOS, Linux, WSL

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

Installation native : Windows PowerShell

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

Homebrew

brew uninstall --cask claude-code

Ou, pour le cask latest :

brew uninstall --cask claude-code@latest

WinGet

winget uninstall Anthropic.ClaudeCode

apt

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

dnf

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

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

Supprimer les paramètres et l'historique (facultatif)

Cette opération supprime tous vos paramètres, outils autorisés, configurations de serveurs MCP et l'historique des sessions. L'extension VS Code, le plugin JetBrains et l'application Desktop écrivent aussi dans ~/.claude : désinstallez-les d'abord, sinon le dossier réapparaîtra.

rm -rf ~/.claude
rm ~/.claude.json

Pour supprimer aussi les paramètres Claude Code propres à un projet, lancez ceci depuis le dossier du projet :

rm -rf .claude
rm -f .mcp.json

Désinstaller l'application n'annule pas votre abonnement. Gérez votre plan dans les paramètres de votre compte claude.ai. Consultez les prix de Claude Code et les prix de Claude pour les options de plan, ou réinstallez à tout moment avec notre guide d'installation de Claude Code.

Garder Claude Code à jour : autres points à vérifier

• Plan et facturation : certaines nouvelles fonctions nécessitent un plan plus récent ou l'accès à un modèle. Consultez les prix de Claude Code si une fonction du changelog n'apparaît pas chez vous.
• Utilisateurs avec clé API : si vous utilisez Claude Code avec une clé API, les mises à jour ne changent pas la facturation. Notre guide de la clé API Anthropic couvre les crédits et les limites de dépenses.
• Flux de travail modifiés : les versions majeures peuvent changer des commandes et des modes. Notre guide du mode plan de Claude Code est tenu à jour avec la version actuelle.
• Accès gratuit : les mainteneurs open source peuvent consulter Claude for Open Source et les étudiants les offres étudiantes Claude.