Claude Code aktualisieren: Version prüfen und Update ausführen

Claude Code ändert sich fast jeden Tag. Sie öffnen das neueste Changelog und finden neue Befehle, behobene Fehler und Geschwindigkeitsverbesserungen. Währenddessen läuft in Ihrem Terminal ein Build von vor zwei Wochen, und die Hälfte dieser Verbesserungen funktioniert einfach nicht. Claude sagt es Ihnen auch nicht: Es startet wie gewohnt, und Sie fragen sich, warum andere eine Funktion haben, die Ihnen fehlt.

Ich zeige Ihnen, wie Sie Ihre Version prüfen, auf die neueste aktualisieren und vorgehen, wenn sich das Update nicht installieren lässt. Die Befehle sind wörtlich aus der offiziellen Claude-Code-Dokumentation übernommen und wurden Anfang September 2026 geprüft. Zu diesem Zeitpunkt war Version 2.1.261 die neueste veröffentlichte Version, aber Ihre Nummer wird anders sein. Es bringt nichts, einer bestimmten Nummer hinterherzujagen – wichtig ist nur, eine aktuelle Version zu verwenden.

Informationen zur Arbeit mit Ailoot finden Sie in der Dokumentation.

Wie aktualisiert man Claude Code schnell auf die neueste Version?#

Im Folgenden erläutere ich jeden Fall ausführlich. Wenn Sie wenig Zeit haben, decken diese drei Befehle fast alle Situationen ab.

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

Der erste zeigt Ihre Version an, der zweite aktualisiert sie und der dritte diagnostiziert Probleme, falls etwas schiefgeht. Im Folgenden erkläre ich, wann Sie welchen Befehl verwenden und warum claude update bei manchen nicht funktioniert.

Wie prüft man, welche Claude-Code-Version derzeit installiert ist?#

Bevor Sie aktualisieren, sollten Sie wissen, von welcher Version aus Sie aktualisieren. Der Befehl ist einfach:

claude --version

Sie erhalten eine Zeile wie 2.1.211 (Claude Code). Das ist Ihre aktuelle Version. Vergleichen Sie die ersten beiden Zahlen mit der neuesten Zahl im Changelog – wenn Ihre deutlich niedriger ist, ist es Zeit für ein Update.

Wenn Sie einen umfassenderen Überblick möchten, führen Sie claude doctor aus. Der Befehl prüft nur und ändert nichts: Er startet keine Sitzung, zeigt aber den Installationsstatus, Fehler in der Einstellungsdatei und Warnungen mit direkt umsetzbaren Vorschlägen zur Behebung an. Außerdem zeigt er das Ergebnis des letzten automatischen Updateversuchs – nützlich, wenn Sie vermuten, dass das Update im Hintergrund unbemerkt nicht installiert wurde.

Aktualisiert sich Claude Code selbst?#

Es kommt ganz darauf an, wie Sie Claude Code installiert haben. Die native Installation – die Anthropic empfiehlt und die das Skript auf der Website installiert – kann sich selbst aktualisieren, und die Dokumentation sagt das ausdrücklich.

So funktioniert es: Claude Code sucht beim Start und in regelmäßigen Abständen während des Betriebs nach Updates. Wenn es eine neue Version findet, lädt es sie herunter und installiert sie im Hintergrund. Beim nächsten Start wird sie dann angewendet. Schließen und öffnen Sie Ihre Sitzung einfach alle paar Tage, dann sind Sie wieder auf dem neuesten Stand.

Mit demselben Befehl claude doctor können Sie prüfen, wie der letzte Hintergrundversuch verlaufen ist. Er zeigt Ihnen, ob das Update aus irgendeinem Grund nicht installiert werden konnte.

Wenn Sie Claude Code jedoch über einen Paketmanager installiert haben – Homebrew auf einem MacBook, WinGet unter Windows, apt oder dnf unter Linux –, gibt es keine Hintergrundaktualisierung. Diese Installationen werden mit dem üblichen Upgrade-Befehl aktualisiert; weiter unten finden Sie dazu einen eigenen Abschnitt.

Eine aktuelle Version von Claude Code ist eine Grundlage, aber sie allein bringt Sie nicht ans Ziel. Verlässliche Ergebnisse hängen nicht von der Version des Tools ab, sondern davon, wie Sie damit arbeiten.

Wie aktualisiert man Claude Code manuell mit einem einzigen Befehl?#

Sie müssen nicht auf die Hintergrundprüfung warten, um eine neue Version zu erhalten. Es gibt einen Befehl, der sofort aktualisiert:

claude update

Es gibt zwei mögliche Ergebnisse. Wird ein Update gefunden und installiert, meldet Claude Code eine Zeile wie Successfully updated from <old version> to version <new version>. Wenn Sie bereits den neuesten Build haben, erscheint Claude Code is up to date (<version>) – das bedeutet, dass es nichts zu aktualisieren gibt.

Bei Paketmanagern gibt es einen Haken. Wurde Claude Code über Homebrew, WinGet oder apk installiert, gibt claude update eine kürzere Antwort aus – Claude is up to date! – und lädt den neuen Build nicht immer selbst herunter. Bei diesen Installationen ist es zuverlässiger, den eigenen Upgrade-Befehl des Paketmanagers zu verwenden, der weiter unten beschrieben wird.

Wie aktualisiert man Claude Code, wenn es über Homebrew oder WinGet installiert wurde?#

Wenn Sie Claude Code über einen Paketmanager statt über das Skript der Website installiert haben, sind Sie für die Aktualisierung selbst verantwortlich. Hier sind die Befehle für die jeweiligen Systeme.

Unter macOS mit Homebrew:

brew upgrade claude-code

Bei Homebrew gibt es zwei Optionen. Claude Code wird in zwei Varianten angeboten. Die Variante claude-code folgt dem Stable-Kanal – einer etwa eine Woche alten Version, bei der Releases mit größeren Problemen übersprungen werden. Die Variante claude-code@latest erhält die neueste Version, sobald sie veröffentlicht wurde. Aktualisieren Sie die von Ihnen installierte Variante: Wenn Sie claude-code@latest haben, lautet der Befehl brew upgrade claude-code@latest.

Unter Windows mit WinGet:

winget upgrade Anthropic.ClaudeCode

Bei WinGet schlägt das Upgrade manchmal fehl, während Claude Code läuft, weil Windows die ausführbare Datei gerade verwendet. Claude Code zeigt Ihnen dann einfach den manuellen Befehl an. Schließen Sie das Programm und führen Sie das Upgrade erneut aus.

Unter Linux mit apt, dnf oder apk müssen Sie keinen separaten Befehl lernen – die neueste Version kommt mit der regulären Systemaktualisierung, da Claude Code signierte Paketquellen veröffentlicht.

Wenn Sie sich das nicht merken möchten, gibt es die Umgebungsvariable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Setzen Sie sie auf 1, und Claude Code führt das Upgrade im Hintergrund mit Homebrew und WinGet aus und empfiehlt nach erfolgreicher Aktualisierung einen Neustart. Die Dokumentation enthält einen Vorbehalt: Manchmal weist Claude Code Sie auf eine neue Version hin, bevor sie tatsächlich im Paketmanager verfügbar ist. Wenn das Upgrade kein Update findet, warten Sie kurz und versuchen Sie es erneut.

Übrigens: Wenn Sie noch entscheiden, wie Sie Claude Code installieren möchten, finden Sie in einem separaten Artikel eine ausführliche Anleitung zur Installation von Claude Code – einschließlich der Gründe, warum der native Installer bequemer ist als Paketmanager.

Warum lässt sich Claude Code nicht aktualisieren, und was sollte man tun?#

Manchmal aktualisieren Sie immer wieder, aber claude --version zeigt hartnäckig weiterhin die alte Nummer an. Ich gehe die wichtigsten Ursachen durch, angefangen bei der häufigsten.

Prüfen Sie zuerst, ob mehrere Claude-Code-Installationen gleichzeitig vorhanden sind. Das kann passieren, wenn Sie das Programm zunächst über npm installiert und später nativ neu installiert haben. Der Befehl aktualisiert eine Kopie, aber das Terminal startet eine andere, sodass sich die Versionsanzeige scheinbar nicht ändert. Prüfen Sie, wie viele Kopien vorhanden sind:

which -a claude

Claude Code kann sich an drei Orten befinden: ~/.local/bin/claude ist der native Installer, ~/.claude/local/ ist die alte lokale npm-Installation aus frühen Versionen, und das globale npm-Paket wird mit dem Befehl npm -g ls @anthropic-ai/claude-code angezeigt. Wenn Sie mehr als eine finden, behalten Sie nur eine – vorzugsweise die native Installation. Entfernen Sie die übrigen so:

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

Die zweite häufige Ursache ist ein globaler npm-Ordner, der nicht beschreibbar ist. Wenn Sie Claude Code global über npm installiert haben und keine Berechtigung zum Schreiben in diesen Ordner besteht, wird das Update im Hintergrund nicht installiert. Claude Code zeigt beim Start einmalig eine Benachrichtigung an, und claude doctor führt genau auf, was behoben werden muss. Das ist ein weiterer Grund, die native Installation zu bevorzugen: Sie schreibt in Ihren Home-Ordner und benötigt diese Berechtigungen nicht.

Der dritte Fall: Sie haben den Launcher ~/.local/bin/claude irgendwann durch ein eigenes Skript oder einen symbolischen Link ersetzt. Seit Version 2.1.207 lassen automatische Updates einen solchen Launcher unverändert: Neue Versionen werden weiterhin in ~/.local/share/claude/versions/ installiert, aber Ihr Skript bestimmt den Start. Löschen Sie nicht den einzigen Launcher, um danach claude update aufzurufen. Sichern Sie zuerst den eigenen Launcher und bei einem Symlink auch sein Ziel an einem separaten, noch unbenutzten Sicherungsort. Verschieben Sie ihn erst nach Prüfung der Kopie aus dem ursprünglichen Pfad. Stellen Sie den nativen Launcher mit dem offiziellen Installer wieder her; dieser benötigt keinen vorhandenen claude-Befehl:

# macOS, Linux oder WSL: offizieller nativer Installer
curl -fsSL https://claude.ai/install.sh | bash

Öffnen Sie nach dem Installer ein neues Terminal und prüfen Sie:

claude --version
claude doctor

Der erste Befehl muss eine Versionsnummer ausgeben. Prüfen Sie die doctor-Ausgabe auf Launcher- oder PATH-Warnungen. Entfernen Sie den gesicherten Launcher erst, wenn der Ersatz funktioniert.

Ein weiteres Symptom ist, dass claude update oder claude doctor direkt nach der Zeile Checking for updates hängen bleibt. Bei älteren Versionen (vor 2.1.214) trat das manchmal auf, wenn eine der Shell-Konfigurationsdateien, etwa ~/.zshrc, ein Verzeichnis statt einer Datei war. Neuere Builds überspringen diesen Fall, sodass das Update auf die neueste Version den Fehler ebenfalls behebt.

Wie wählt man einen Update-Kanal: latest oder stable?#

Ein Update auf die neueste Version bedeutet nicht immer, dass Sie am ersten Tag den neuesten Build erhalten. Claude Code lässt Sie zwischen zwei Kanälen wählen, was sich genau darauf auswirkt, was Sie beim Aktualisieren erhalten.

Der Kanal latest ist der Standard. Neue Funktionen erscheinen, sobald sie veröffentlicht werden – praktisch, wenn Sie sie als Erste ausprobieren möchten. Der Kanal stable bietet eine etwa eine Woche alte Version: Sie hatte Zeit, sich zu bewähren, und Releases mit größeren Problemen werden übersprungen. Diese Option eignet sich für alle, denen Sicherheit wichtiger ist als Geschwindigkeit.

Am einfachsten wechseln Sie innerhalb von Claude Code mit dem Befehl /config unter Auto-update channel. Oder tragen Sie die Einstellung manuell in die Datei settings.json ein:

{
  "autoUpdatesChannel": "stable"
}

Wenn Sie Claude Code an Ihre Gewohnheiten anpassen möchten, finden Sie in einer separaten Anleitung zum Anpassen von Claude Code weitere Informationen – sie behandelt die Einstellungsdatei insgesamt und nicht nur den Update-Kanal.

Wie installiert man eine bestimmte Version oder legt eine Mindestversion fest?#

Manchmal benötigen Sie statt der neuesten Version eine bestimmte Version – zum Beispiel, um zu einem Build zurückzukehren, mit dem Ihr Workflow nachweislich funktioniert hat. Der native Installer unterstützt dies: Er akzeptiert sowohl einen Kanalnamen als auch eine genaue Versionsnummer. So installieren Sie einen bestimmten Build:

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

Unter Windows sieht das entsprechende PowerShell-Kommando etwas anders aus:

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

Den Stable-Kanal können Sie auf dieselbe Weise installieren – schreiben Sie statt einer Nummer stable. Der bei der Installation gewählte Kanal wird zum Standardkanal für künftige automatische Updates.

Wenn Sie sich vor einer Rückkehr zu einer älteren Version schützen möchten, legen Sie in settings.json eine Mindestversion fest:

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

Das ist die Untergrenze. Weder ein Hintergrundupdate noch claude update installiert eine Version unterhalb der angegebenen. Das ist nützlich, wenn Sie zu stable wechseln, aber nicht von einem bereits verwendeten neueren Build zurückgehen möchten.

Wie deaktiviert man automatische Updates, wenn sie stören?#

Manchmal stören Hintergrundupdates – zum Beispiel, wenn Ihr Team genau eine Version verwenden soll. Sie können sie über die Einstellungsdatei deaktivieren:

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

Ein wichtiger Hinweis: DISABLE_AUTOUPDATER deaktiviert nur die Hintergrundprüfung. Der Befehl claude update funktioniert weiterhin, sodass Sie manuell aktualisieren können. Wenn Sie alle Updatewege einschließlich manueller Updates auf einmal blockieren müssen, gibt es die strengere Variable DISABLE_UPDATES. Sie wird verwendet, wenn Sie Claude Code über einen eigenen Kanal verteilen und alle exakt bei dem von Ihnen bereitgestellten Build bleiben sollen.

Für den normalen persönlichen Gebrauch sollten Sie diese Variablen besser nicht ändern: Eine aktuelle Claude-Code-Version ist fast immer besser als eine alte, und mit einem Update kann eine Sicherheitskorrektur eintreffen. Das Tool auf dem neuesten Stand zu halten gehört dazu, den Zugriff aufrechtzuerhalten und ungewöhnliche Fehler zu vermeiden; ein separater Artikel behandelt, wie Sie den Verlust Ihres Claude-Kontos vermeiden.

Wo sollte man anfangen?#

Hier ist ein kurzer Plan.

1. Prüfen Sie Ihre aktuelle Version: claude --version. Vergleichen Sie sie mit der neuesten Nummer im Changelog.
2. Aktualisieren Sie. Native Installation – claude update. Homebrew – brew upgrade claude-code. WinGet – winget upgrade Anthropic.ClaudeCode.
3. Starten Sie die Claude-Code-Sitzung neu, damit die neue Version wirksam wird.
4. Wenn sich die Version nicht geändert hat, führen Sie claude doctor und which -a claude aus. Wahrscheinlich haben Sie mehrere Installationen oder einen nicht beschreibbaren npm-Ordner.
5. Wählen Sie den passenden Kanal: latest, wenn Sie neue Funktionen sofort nutzen möchten, oder stable, wenn Vorhersehbarkeit wichtiger ist. Ändern Sie ihn über /config.

Eine aktuelle Version behebt Fehler und fügt neue Befehle hinzu, aber das aktualisierte Tool baut Ihr Projekt nicht für Sie. Die Anleitung zu Alternativen zu Claude Code erklärt, worin sich Claude Code von anderen Terminal-Agenten unterscheidet und wann Alternativen sinnvoll sind.

Lernen Sie Ailoot kennen.