Comment mettre Claude Code à jour vers la dernière version en 2026

Claude Code change presque tous les jours. Vous ouvrez le dernier changelog et découvrez de nouvelles commandes, des bogues corrigés et des améliorations de vitesse. Pendant ce temps, votre terminal exécute une version datant de deux semaines, et la moitié de ces améliorations ne fonctionne tout simplement pas. Claude ne vous le dit pas non plus : il démarre comme d’habitude, et vous vous demandez pourquoi les autres disposent d’une fonctionnalité que vous n’avez pas.

Je vais vous expliquer comment vérifier votre version, installer la dernière et procéder si la mise à jour ne s’installe pas. Les commandes sont reprises mot pour mot de la documentation officielle de Claude Code et ont été vérifiées début septembre 2026. À ce moment-là, la dernière version publiée était la 2.1.261, mais votre numéro sera différent. Inutile de courir après un numéro précis : l’important est simplement d’utiliser une version récente.

Les informations sur l’utilisation d’Ailoot sont disponibles dans la documentation.

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

Je détaillerai chaque cas ci-dessous, mais si vous manquez de temps, ces trois commandes couvrent presque toutes les situations.

claude --version   # which version is installed now
claude update      # update immediately (native installation)
claude doctor      # check the installation and updates

La première affiche votre version, la deuxième la met à jour et la troisième diagnostique les problèmes si quelque chose ne va pas. Ci-dessous, j’explique quand utiliser chacune et pourquoi claude update ne fonctionne pas chez certaines personnes.

Comment vérifier quelle version de Claude Code est actuellement installée ?#

Avant de procéder à la mise à jour, il est utile de savoir de quelle version vous partez. La commande est simple :

claude --version

Vous obtiendrez une ligne comme 2.1.211 (Claude Code). C’est votre version actuelle. Comparez les deux premiers nombres au dernier numéro indiqué dans le changelog : si le vôtre est nettement inférieur, il est temps de mettre à jour.

Pour avoir une vue d’ensemble, exécutez claude doctor. Cette commande ne fait que vérifier et ne modifie rien : elle ne démarre pas de session, mais affiche l’état de l’installation, les erreurs dans le fichier de paramètres ainsi que des avertissements accompagnés de suggestions prêtes à l’emploi pour les corriger. Elle indique également le résultat de la dernière tentative de mise à jour automatique — pratique si vous soupçonnez que la mise à jour en arrière-plan a échoué sans que vous le sachiez.

Claude Code se met-il à jour tout seul ?#

Tout dépend de la manière dont vous avez installé Claude Code. L’installation native — celle recommandée par Anthropic et effectuée par le script du site — peut se mettre à jour automatiquement, comme la documentation l’indique explicitement.

Voici comment cela fonctionne : Claude Code recherche des mises à jour au démarrage et périodiquement pendant son exécution. S’il trouve une nouvelle version, il la télécharge et l’installe en arrière-plan, puis l’applique au prochain lancement. Fermez et rouvrez simplement votre session tous les deux ou trois jours pour être de nouveau à jour.

Vous pouvez vérifier le résultat de la dernière tentative en arrière-plan avec la même commande claude doctor. Elle vous indiquera si la mise à jour n’a pas pu s’installer pour une raison quelconque.

Mais si vous avez installé Claude Code avec un gestionnaire de paquets — Homebrew sur un MacBook, WinGet sous Windows, apt ou dnf sous Linux — il n’y a pas de mise à jour en arrière-plan. Ces installations se mettent à jour à l’aide de la commande de mise à niveau habituelle ; une section distincte est consacrée à ce sujet plus bas.

Une version récente de Claude Code constitue une bonne base, mais elle ne suffit pas à elle seule. Des résultats constants dépendent moins de la version de l’outil que de la façon dont vous l’utilisez.

Comment mettre manuellement Claude Code à jour avec une seule commande ?#

Vous n’avez pas à attendre la vérification en arrière-plan pour installer une nouvelle version. Une commande permet de lancer la mise à jour immédiatement :

claude update

Deux résultats sont possibles. Si une mise à jour est trouvée et installée, Claude Code affiche une ligne comme Successfully updated from <old version> to version <new version>. Si vous utilisez déjà la dernière version, vous obtiendrez Claude Code is up to date (<version>) — cela signifie qu’il n’y a rien à mettre à jour.

Cette commande présente une particularité avec les gestionnaires de paquets. Si Claude Code a été installé via Homebrew, WinGet ou apk, claude update affiche une réponse plus courte — Claude is up to date! — et ne récupère pas toujours lui-même la nouvelle version. Pour ces installations, il est plus fiable d’utiliser la commande de mise à niveau propre au gestionnaire de paquets, décrite ci-dessous.

Comment mettre à jour Claude Code installé via Homebrew ou WinGet ?#

Si vous avez installé Claude Code via un gestionnaire de paquets plutôt qu’avec le script du site, c’est à vous de le mettre à jour. Voici les commandes pour chaque système.

Sous macOS avec Homebrew :

brew upgrade claude-code

Homebrew propose deux options. Il installe Claude Code sous deux variantes. La variante claude-code suit le canal stable : elle propose une version datant d’environ une semaine et ignore les versions présentant des problèmes majeurs. La variante claude-code@latest reçoit la toute dernière version dès sa publication. Mettez à jour celle que vous avez installée : si vous avez claude-code@latest, la commande sera brew upgrade claude-code@latest.

Sous Windows avec WinGet :

winget upgrade Anthropic.ClaudeCode

Avec WinGet, la mise à niveau échoue parfois lorsque Claude Code est en cours d’exécution, car Windows utilise alors le fichier exécutable. Claude Code affiche simplement la commande à lancer manuellement ; fermez-le et relancez la mise à niveau.

Sous Linux avec apt, dnf ou apk, il n’y a pas de commande distincte à retenir : la dernière version arrive avec la mise à jour habituelle du système, car Claude Code publie des dépôts signés.

Si vous ne voulez pas avoir à vous en souvenir, vous pouvez utiliser la variable d’environnement CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Définissez-la sur 1 et Claude Code lancera la mise à niveau en arrière-plan avec Homebrew et WinGet, puis suggérera un redémarrage après une mise à jour réussie. La documentation précise toutefois que Claude Code vous signale parfois une nouvelle version avant qu’elle soit effectivement disponible dans le gestionnaire de paquets. Si la mise à niveau ne trouve aucune mise à jour, attendez un peu puis réessayez.

Au fait, si vous n’avez pas encore choisi comment installer Claude Code, un article distinct propose un guide détaillé sur l’installation de Claude Code, avec notamment les raisons pour lesquelles l’installateur natif est plus pratique que les gestionnaires de paquets.

Pourquoi Claude Code ne se met-il pas à jour et que faire ?#

Il arrive que vous lanciez plusieurs mises à jour, mais que claude --version continue obstinément d’afficher l’ancien numéro. Je vais passer en revue les principales causes, en commençant par la plus fréquente.

Commencez par vérifier si plusieurs installations de Claude Code sont présentes en même temps. Cela peut arriver si vous l’avez d’abord installé via npm, puis réinstallé en version native. La commande met une copie à jour, mais le terminal en lance une autre : la version semble donc ne pas changer. Vérifiez combien de copies sont présentes :

which -a claude

Claude Code peut se trouver à trois endroits : ~/.local/bin/claude correspond à l’installateur natif, ~/.claude/local/ à l’ancienne installation npm locale des premières versions, et le paquet npm global est indiqué par la commande npm -g ls @anthropic-ai/claude-code. Si vous en trouvez plusieurs, n’en gardez qu’une, de préférence l’installation native. Supprimez les autres ainsi :

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

La deuxième cause fréquente est un dossier npm global qui n’est pas accessible en écriture. Si vous avez installé Claude Code globalement avec npm et que le programme n’a pas l’autorisation d’écrire dans son dossier, la mise à jour en arrière-plan ne s’installera pas. Claude Code affiche une notification unique au démarrage, et claude doctor indique exactement ce qu’il faut corriger. C’est une autre raison de préférer l’installation native : elle écrit dans votre dossier personnel et ne nécessite pas ces autorisations.

Troisième situation : vous avez remplacé ~/.local/bin/claude par un script ou lien symbolique. Depuis 2.1.207, les mises à jour laissent ce lanceur intact ; les versions s’installent dans ~/.local/share/claude/versions/, mais votre script choisit celle lancée. Ne supprimez pas votre seule commande avant d’appeler claude update. Copiez d’abord le lanceur et, pour un lien, sa cible vers une sauvegarde distincte inutilisée. Ne déplacez l’original qu’après vérification de la copie. Restaurez le lanceur natif avec l’installateur officiel, indépendant d’une commande claude existante :

# macOS, Linux ou WSL : installateur natif officiel
curl -fsSL https://claude.ai/install.sh | bash

Une fois terminé, ouvrez un nouveau terminal et vérifiez :

claude --version
claude doctor

La première commande doit afficher une version. Inspectez les avertissements de lanceur ou de PATH dans doctor avant de continuer ; conservez l’ancien lanceur jusqu’au bon fonctionnement du remplacement.

Autre symptôme : claude update ou claude doctor reste bloqué juste après la ligne Checking for updates. Cela arrivait parfois avec les anciennes versions (antérieures à 2.1.214) lorsqu’un fichier de configuration du shell, comme ~/.zshrc, était en réalité un dossier. Les versions récentes ignorent désormais ce cas ; la mise à jour vers la dernière version corrige donc aussi ce bogue.

Comment choisir un canal de mise à jour : latest ou stable ?#

Mettre à jour vers la dernière version ne signifie pas toujours récupérer dès le premier jour la version la plus récente. Claude Code vous permet de choisir entre deux canaux, ce qui détermine précisément ce que vous recevez lors d’une mise à jour.

Le canal latest est celui par défaut. Les nouvelles fonctionnalités sont disponibles dès leur publication, ce qui est pratique si vous voulez les essayer en premier. Le canal stable fournit une version datant d’environ une semaine : elle a eu le temps de se stabiliser et les versions présentant des problèmes majeurs sont ignorées. C’est le choix des personnes qui privilégient la tranquillité d’esprit à la rapidité.

Le moyen le plus simple de changer de canal consiste à utiliser la commande /config dans Claude Code, sous Auto-update channel. Vous pouvez aussi le définir manuellement dans le fichier de paramètres settings.json :

{
  "autoUpdatesChannel": "stable"
}

Si vous souhaitez configurer Claude Code selon vos habitudes, consultez le guide distinct sur la personnalisation de Claude Code : il traite du fichier de paramètres dans son ensemble, et pas seulement du canal de mise à jour.

Comment installer une version précise ou définir une version minimale ?#

Parfois, vous avez besoin d’une version précise plutôt que de la dernière — par exemple, pour revenir à une version avec laquelle votre flux de travail fonctionnait à coup sûr. L’installateur natif le permet : il accepte aussi bien un nom de canal qu’un numéro de version précis. Pour installer une version particulière, procédez ainsi :

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

Sous Windows, l’équivalent dans PowerShell est légèrement différent :

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

Vous pouvez installer le canal stable de la même manière : écrivez stable au lieu d’un numéro. Le canal choisi lors de l’installation devient le canal par défaut des prochaines mises à jour automatiques.

Pour éviter de revenir à une version plus ancienne, définissez une version minimale dans settings.json :

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

C’est la limite inférieure. Ni une mise à jour en arrière-plan ni claude update n’installera une version inférieure à celle indiquée. Cela peut être utile lorsque vous passez à stable et que vous ne voulez pas revenir à une version plus ancienne que celle que vous utilisez déjà.

Comment désactiver les mises à jour automatiques si elles vous gênent ?#

Parfois, les mises à jour en arrière-plan vous gênent — par exemple, lorsque vous voulez que votre équipe utilise exactement une seule version. Vous pouvez les désactiver dans le fichier de paramètres :

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

Un détail important : DISABLE_AUTOUPDATER désactive uniquement la vérification en arrière-plan. La commande claude update continuera de fonctionner ; vous pourrez donc toujours mettre à jour manuellement. Si vous devez bloquer toutes les voies de mise à jour en même temps, y compris les mises à jour manuelles, il existe une variable plus stricte, DISABLE_UPDATES. Elle est utilisée lorsque vous distribuez Claude Code via votre propre canal et que vous voulez que les utilisateurs restent exactement sur la version que vous leur avez fournie.

Pour un usage personnel courant, mieux vaut ne pas modifier ces variables : une version récente de Claude Code est presque toujours préférable à une ancienne, et une mise à jour peut apporter un correctif de sécurité. Garder l’outil à jour permet de conserver l’accès et d’éviter des bogues étranges ; un article distinct explique comment éviter de perdre votre compte Claude.

Par où commencer ?#

Voici un plan succinct.

1. Vérifiez votre version actuelle : claude --version. Comparez-la au dernier numéro du changelog.
2. Mettez à jour. Installation native — claude update. Homebrew — brew upgrade claude-code. WinGet — winget upgrade Anthropic.ClaudeCode.
3. Redémarrez la session Claude Code pour que la nouvelle version soit prise en compte.
4. Si la version n’a pas changé, exécutez claude doctor et which -a claude. Vous avez probablement plusieurs installations ou un dossier npm qui n’est pas accessible en écriture.
5. Choisissez le canal qui vous convient : latest pour recevoir les nouvelles fonctionnalités dès leur arrivée ou stable si vous privilégiez la prévisibilité. Modifiez-le avec /config.

Une version récente corrige des bogues et ajoute de nouvelles commandes, mais un outil à jour ne construira pas votre projet à votre place. Le guide sur les alternatives à Claude Code explique en quoi Claude Code diffère des autres agents de terminal et dans quels cas envisager des alternatives.

Découvrez Ailoot.