Claude Code aktualisieren 2026: neueste Version, Changelog & Deinstallation

Wenn Sie Claude Code mit dem nativen Installer installiert haben, aktualisiert es sich im Hintergrund selbst, und der integrierte Update-Befehl von Claude Code spielt eine neue Version sofort ein. Installationen über Homebrew, WinGet, apt, dnf und apk aktualisieren sich standardmäßig nicht automatisch, Sie aktualisieren sie also mit Ihrem Paketmanager. npm-Installationen aktualisieren Sie, indem Sie das Paket mit dem Tag @latest neu installieren. Alle Befehle finden Sie unten, nach Installationsmethode gruppiert.

Dieser Guide behandelt außerdem Release-Kanäle (latest oder stable), das Festlegen oder Zurückrollen einer Version, das Abschalten von Updates, das Lesen des Changelogs, die Behebung fehlgeschlagener Updates und die Deinstallation. Er wurde am 17. Oktober 2026 mit der Claude-Code-Dokumentation und dem Changelog von Anthropic abgeglichen.

Schritt 1: Aktuelle Version prüfen

claude --version

Die Ausgabe sieht aus wie 2.1.302 (Claude Code). In einer laufenden Sitzung zeigt dieser Befehl Ihre Version, Ihr Modell, Ihr Konto und die Verbindung:

/status

Um zu lesen, was sich in jedem Release geändert hat, ohne Claude Code zu verlassen, öffnen Sie die interaktive Versionsauswahl:

/release-notes

Nicht sicher, wie Sie installiert haben?

Der Update-Befehl hängt von der Installationsmethode ab, prüfen Sie diese also zuerst. Der native Installer legt unter macOS und Linux einen Launcher unter ~/.local/bin/claude ab (ein Symlink nach ~/.local/share/claude/versions/) bzw. unter Windows claude.exe in %USERPROFILE%\.local\bin. Unter macOS oder Linux listet dieser Befehl jedes claude in Ihrem PATH auf und deckt damit auch doppelte Installationen auf:

which -a claude

In Windows PowerShell:

where.exe claude

So sehen Sie, ob Homebrew es installiert hat und welchen Cask:

brew list --cask | grep claude-code

Für einen vollständigen, rein lesenden Bericht inklusive Zustand der Installation und Ergebnis des letzten Update-Versuchs führen Sie aus:

claude doctor

Schritt 2: Mit dem Befehl für Ihre Installationsmethode aktualisieren

Nativer Installer (macOS, Linux, WSL, Windows)

claude update

Wird ein Update installiert, meldet der Befehl Successfully updated von der alten auf die neue Version. Sind Sie aktuell, meldet er, dass Claude Code auf dem neuesten Stand ist. Von Homebrew, WinGet oder apk verwaltete Installationen geben stattdessen Claude is up to date! aus, weil dort der Paketmanager zuständig ist.

Homebrew

Für den Stable-Cask:

brew upgrade claude-code

Für den Latest-Cask:

brew upgrade claude-code@latest

Homebrew behält nach Upgrades alte Versionen auf der Festplatte. Führen Sie ab und zu den Cleanup-Befehl aus, um Platz freizugeben:

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

Verwenden Sie bei npm-Installationen nicht den globalen Update-Befehl von npm. Er hält sich an den Versionsbereich Ihrer ursprünglichen Installation und bringt Sie womöglich nicht auf das neueste Release. Nutzen Sie stattdessen den @latest-Befehl oben und installieren Sie nie mit sudo.

Öffnen Sie nach jedem Update eine neue Sitzung (oder starten Sie Claude Code neu) und prüfen Sie die Version erneut. Updates werden beim nächsten Start von Claude Code wirksam.

So funktionieren automatische Updates

Claude Code sucht beim Start und regelmäßig während der Laufzeit nach Updates. Updates werden im Hintergrund heruntergeladen und installiert und beim nächsten Start von Claude Code wirksam. Der Doctor-Bericht aus Schritt 1 zeigt das Ergebnis des letzten Update-Versuchs.

• Native Installationen aktualisieren sich standardmäßig automatisch.
• npm-Installationen aktualisieren sich automatisch, wenn das globale npm-Verzeichnis beschreibbar ist. Ist es das nicht, zeigt Claude Code beim Start einmalig einen Hinweis, und der Doctor-Bericht listet die Lösungen.
• Installationen über Homebrew, WinGet, apt, dnf und apk aktualisieren sich standardmäßig nicht automatisch. apt, dnf und apk erfordern immer ein manuelles Upgrade, weil diese Befehle erhöhte Rechte brauchen.
• Eigene Launcher: Ersetzen Sie ~/.local/bin/claude durch ein eigenes Skript oder einen eigenen Symlink, installieren Updates neue Versionen weiterhin im Verzeichnis versions/, lassen Ihren Launcher aber unangetastet, und Claude Code behält jede installierte Version auf der Festplatte. Entfernen Sie Ihren Launcher und führen Sie den Update-Befehl aus, um die Kontrolle wieder an Claude Code zu übergeben.

Bei nativen Installationen löscht Claude Code alte Versionen selbst: Neben der verwendeten Version behält es die zwei neuesten und entfernt den Rest.

Homebrew- oder WinGet-Upgrades von Claude Code ausführen lassen

Setzen Sie die Umgebungsvariable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE auf 1, zum Beispiel im env-Block von settings.json. Claude Code führt dann das Upgrade des Paketmanagers im Hintergrund aus, sobald eine neue Version verfügbar ist, und zeigt bei Erfolg eine Aufforderung zum Neustart. Das Upgrade betrifft nur das Claude-Code-Paket.

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

Bei WinGet kann das Upgrade fehlschlagen, während Claude Code läuft, weil Windows die ausführbare Datei sperrt; Claude Code zeigt dann den manuellen Befehl an. Anthropic nennt außerdem ein bekanntes Problem: Claude Code kann ein Update ankündigen, bevor Ihr Paketmanager es hat – schlägt ein Upgrade fehl, warten Sie und versuchen Sie es später erneut.

Release-Kanal wählen: latest oder stable

Die Einstellung autoUpdatesChannel steuert, welche Builds native und npm-Installationen erhalten, sowohl bei Hintergrund-Updates als auch beim manuellen Update-Befehl. Ändern Sie sie unter Auto-update channel im Einstellungsbildschirm, den Sie mit diesem Befehl in Claude Code öffnen:

/config

Oder setzen Sie sie in settings.json:

{
  "autoUpdatesChannel": "stable"
}

Ein neu veröffentlichtes Modell kann eine neuere Claude-Code-Version erfordern, als stable anbietet. Wenn Sie dieses Modell sofort nutzen möchten, wechseln Sie zu latest. Organisationen können über verwaltete Einstellungen einen Kanal für alle vorschreiben.

Kanäle für Homebrew und Linux-Pakete

Homebrew wählt den Kanal über den Cask-Namen statt über die Einstellung: claude-code folgt stable, claude-code@latest folgt latest. Die apt-, dnf- und apk-Repositorys wählen den Kanal über die Repository-URL. Bei apt ändert der Wechsel zu latest sowohl den URL-Pfad als auch den Suite-Namen:

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

Bei dnf setzen Sie baseurl in /etc/yum.repos.d/claude-code.repo auf das Latest-Repository:

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

Bei apk entfernen Sie die Stable-Zeile und fügen das Latest-Repository hinzu:

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

Beim Wechsel zu stable eine Mindestversion beibehalten

Ein Wechsel von latest zu stable könnte Sie sonst auf einen älteren Build zurückwerfen. Wenn Sie im Einstellungsbildschirm wechseln, fragt Claude Code, ob Sie bei Ihrer aktuellen Version bleiben oder das Downgrade zulassen möchten; Bleiben setzt minimumVersion für Sie. Sie können die Untergrenze auch selbst setzen, und Updates lehnen dann alles darunter ab:

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

Eine bestimmte Version installieren oder zurückrollen

Der native Installer akzeptiert eine Versionsnummer oder einen Kanalnamen. Wenn ein neues Release bei Ihnen etwas kaputt macht, ist die Neuinstallation einer früheren Version der offizielle Weg zurück. Um zum Beispiel Version 2.1.89 unter macOS, Linux oder WSL zu installieren:

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

In Windows PowerShell:

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

In Windows CMD:

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

Ist Claude Code bereits installiert, erledigt sein eigener install-Unterbefehl dasselbe und akzeptiert auch stable oder latest:

claude install 2.1.89

Der Versionsbefehl gibt dann genau die gewünschte Version aus. Sofern Sie nicht auch die automatischen Updates abschalten (nächster Abschnitt), bringt Sie das nächste Hintergrund-Update wieder nach vorn.

Automatische Updates abschalten

Um Hintergrund-Updates zu stoppen, fügen Sie im env-Block von settings.json DISABLE_AUTOUPDATER mit dem Wert "1" hinzu. Manuelle Updates und der install-Unterbefehl funktionieren weiterhin.

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

Prüfen Sie bei einer nativen oder npm-Installation im Doctor-Bericht aus Schritt 1, ob die Einstellung greift: Die Zeile Auto-updates sollte disabled (set by env: DISABLE_AUTOUPDATER) statt enabled anzeigen. Um jeden Update-Weg einschließlich manueller Updates zu blockieren, setzen Sie stattdessen DISABLE_UPDATES. Anthropic empfiehlt das für Organisationen, die Claude Code über eigene Kanäle verteilen und alle auf der bereitgestellten Version halten müssen.

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

Mit einer alten Version verpassen Sie Sicherheitsfixes und die Unterstützung neuer Modelle. Wenn Sie eine Version festlegen, stellen Sie sich eine Erinnerung, den Changelog zu prüfen und nach eigenem Zeitplan zu aktualisieren.

Wo Sie den Changelog von Claude Code finden

• In Claude Code öffnet der in Schritt 1 gezeigte Release-Notes-Befehl eine Versionsauswahl; die Notizen erscheinen in Ihrem Verlauf, ohne an Claude gesendet zu werden.
• Der Changelog in der Dokumentation unter code.claude.com/docs/en/changelog wird aus der CHANGELOG.md im GitHub-Repository anthropics/claude-code erzeugt.
• Bei unserer Prüfung am 17. Oktober 2026 war der neueste Eintrag Version 2.1.302 vom 16. Oktober 2026. Releases erscheinen häufig, manchmal mehrmals täglich, prüfen Sie die aktuelle Nummer also im Changelog.

Im Changelog dokumentiert Anthropic auch Fixes am Updater selbst, was hilft, wenn ein Update Probleme macht. So vermerkt die Troubleshooting-Dokumentation zum Beispiel, dass ein Hänger bei den Befehlen update und doctor in v2.1.214 behoben wurde und ein Windows-Update-Fehler, durch den die Sicherung von claude.exe verloren gehen konnte, in v2.1.281.

Probleme bei Updates beheben

„The connection dropped while downloading the update“

Claude Code wiederholt einen abgebrochenen, hängenden oder beschädigten Download bis zu insgesamt drei Versuche. Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten fertig wird, schlägt mit Download timed out: exceeded the total deadline fehl und wird nicht wiederholt. Führen Sie das Update erneut aus, idealerweise in einem schnelleren Netzwerk. Braucht Ihr Netzwerk einen Proxy, setzen Sie zuerst HTTPS_PROXY; bricht ein Unternehmensproxy die Übertragung immer wieder ab, bitten Sie Ihr Netzwerkteam, Downloads von downloads.claude.ai zuzulassen.

Der Update-Befehl hängt nach „Checking for updates“

Vor v2.1.214 führte ein Verzeichnis an einem Shell-Konfigurationspfad wie ~/.zshrc oder ~/.bashrc dazu, dass sowohl der update- als auch der doctor-Befehl hingen. Finden Sie es mit:

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

Eine Zeile, die mit d beginnt, markiert den Verursacher. Verschieben Sie es, oder aktualisieren Sie stattdessen, indem Sie das Installationsskript erneut ausführen, da der Update-Befehl bei betroffenen Versionen selbst hängt:

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

'claude' is not recognized direkt nach einem Update unter Windows

Windows-Updates benennen die alte claude.exe in eine Sicherung namens claude.exe.old. gefolgt von einem Zeitstempel um und verschieben dann die neue Version an ihren Platz. Ist das fehlgeschlagen, stellen Sie in PowerShell die neueste Sicherung wieder her:

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

Gibt es keine Sicherung, installieren Sie neu:

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

npm-Fehlercode ENOTEMPTY während eines Updates

npm konnte das alte Paketverzeichnis nicht beiseiteschieben. Löschen Sie es unter macOS oder Linux samt übrig gebliebener temporärer Kopien und installieren Sie neu:

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“

Sie aktualisieren den anderen Cask. Prüfen Sie mit dem brew-list-Befehl aus Schritt 1, welchen Sie haben, und aktualisieren Sie diesen. Bietet Homebrew eine ältere Version an, als der Changelog zeigt, denken Sie daran, dass der Cask claude-code dem Stable-Kanal folgt, der etwa eine Woche hinterherhinkt; aktualisieren Sie den Homebrew-Index oder wechseln Sie zum Latest-Cask.

Die Version hat sich nach dem Update nicht geändert

• Die neue Version wird beim nächsten Start wirksam, beenden Sie Claude Code also und starten Sie es erneut.
• Möglicherweise haben Sie zwei Installationen (zum Beispiel npm und nativ), und die alte steht in Ihrem PATH an erster Stelle. Nutzen Sie die PATH-Prüfung aus Schritt 1, behalten Sie eine Installation und entfernen Sie den Rest.
• Ein eigener Launcher unter ~/.local/bin/claude bestimmt, welche Version läuft; Updates ersetzen ihn nicht.
• Ihre Einstellungen setzen eventuell den Stable-Kanal, eine minimumVersion oder DISABLE_AUTOUPDATER bzw. DISABLE_UPDATES, oder Ihre Organisation schreibt über verwaltete Einstellungen eine Version vor. Der Doctor-Bericht zeigt, was zutrifft.

So deinstallieren Sie Claude Code

Verwenden Sie die Schritte zum Entfernen, die zu Ihrer Installationsmethode passen. Läuft claude danach noch, haben Sie vermutlich eine zweite Installation oder einen übrig gebliebenen Shell-Alias.

Native Installation: macOS, Linux, WSL

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

Native Installation: 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

Oder für den Latest-Cask:

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

Einstellungen und Verlauf entfernen (optional)

Dadurch werden alle Ihre Einstellungen, erlaubten Tools, MCP-Server-Konfigurationen und der Sitzungsverlauf gelöscht. Die VS-Code-Erweiterung, das JetBrains-Plugin und die Desktop-App schreiben ebenfalls nach ~/.claude, deinstallieren Sie diese also zuerst, sonst taucht der Ordner wieder auf.

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

Um auch die projekteigenen Claude-Code-Einstellungen zu entfernen, führen Sie dies im Projektordner aus:

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

Das Deinstallieren der App kündigt kein Abo. Verwalten Sie Ihren Plan in den Kontoeinstellungen auf claude.ai. Planoptionen finden Sie unter Claude-Code-Preise und Claude-Preise, und mit unserem Guide zur Installation von Claude Code können Sie jederzeit neu installieren.

Claude Code aktuell halten: was Sie sonst noch prüfen sollten

• Plan und Abrechnung: Neue Funktionen erfordern manchmal einen höheren Plan oder Modellzugang. Prüfen Sie Claude-Code-Preise, wenn eine Funktion aus dem Changelog bei Ihnen nicht erscheint.
• Nutzer mit API-Key: Wenn Sie Claude Code mit einem API-Key betreiben, ändern Updates nichts an der Abrechnung. Unser Guide zum Anthropic-API-Key behandelt Guthaben und Ausgabenlimits.
• Geänderte Workflows: Große Releases können Befehle und Modi ändern. Unser Guide zum Plan Mode von Claude Code wird an die aktuelle Version angepasst.
• Kostenloser Zugang: Open-Source-Maintainer können Claude for Open Source prüfen, Studierende die Claude-Angebote für Studierende.