Die Geschichte, wie es angenehmer wurde, nachdem ich Claude Code von Homebrew auf eine native Installation umgestellt habe
Inhaltsverzeichnis
Ich habe brew upgrade claude-code auf zwei Macs ausgeführt und dabei wurden unterschiedliche Versionen installiert. Auf dem Mac mini 2.1.73, auf dem MacBook Pro 2.1.74. Derselbe Befehl - warum?
Dieses „Hm?" war der Anlass, die Installationsmethode von Claude Code von Homebrew auf Native Install umzustellen. Um das Ergebnis vorwegzunehmen: Die Umstellung hat sich gelohnt. In diesem Artikel beantworte ich alle Fragen auf einmal - warum es zu Versionsabweichungen kommt, wie man umstellt und ob Einstellungen und Daten dabei verloren gehen.
Warum kommt es bei Homebrew zu Versionsabweichungen?
Nach meiner Recherche scheinen mehrere Faktoren zusammenzuspielen.
Zunächst ist der Homebrew-Cask von Claude Code offenbar so konzipiert, dass er dem Stable-Release-Kanal folgt. Da der Stable-Kanal etwa eine Woche später als Latest bereitgestellt wird, gibt es eine Zeitverzögerung, bis eine neue Version von Anthropic in der Cask-Definition von Homebrew erscheint. Außerdem hat Homebrew ab Version 4.0 auf ein System umgestellt, bei dem Cask-Definitionen über eine JSON-API via CDN abgerufen werden - auch Unterschiede in der Aktualität von CDN-Edge-Nodes und lokalem Cache sollen dabei eine Rolle spielen. Daher kann es vorkommen, dass zwei Macs, die fast gleichzeitig brew upgrade ausführen, unterschiedliche Cask-Definitionen erhalten.
Darüber hinaus steht in der offiziellen Dokumentation Folgendes:
Homebrew installations do not auto-update. Run
brew upgrade claude-codeperiodically to get the latest features and security fixes. Known issue: Claude Code may notify you of updates before the new version is available in these package managers. If an upgrade fails, wait and try again later.
Das bedeutet: Die Homebrew-Version aktualisiert sich nicht automatisch - man muss brew upgrade manuell ausführen. Und selbst wenn Claude Code selbst meldet, dass eine neue Version verfügbar ist, kann es sein, dass diese auf der Homebrew-Seite noch nicht angekommen ist. Wer mehrere Macs verwendet, empfindet diese Abweichungen auf Dauer als stillen Stressfaktor.
Native Install wird empfohlen
In der offiziellen Dokumentation ist die Installationsmethode Native Install mit dem Label „Recommended" versehen. Der Grund, warum Native Install gegenüber Homebrew oder WinGet empfohlen wird, ist die automatische Aktualisierung.
Die Native-Install-Version prüft beim Start und während der Ausführung regelmäßig im Hintergrund auf Updates und führt Download und Installation automatisch durch. Beim nächsten Start ist die neue Version bereits aktiv.
Auch wenn man auf mehreren Macs arbeitet, folgt jeder Rechner selbstständig der neuesten Version - die Situation „der eine ist aktuell, der andere veraltet" tritt dadurch kaum noch auf.
Umstellungsschritte
Die Umstellung ist denkbar einfach. Man deinstalliert die Homebrew-Version und führt anschließend den Native Install aus.
1. Homebrew-Version entfernen
brew uninstall --cask claude-code
2. Globale npm-Version entfernen, falls vorhanden
Falls Claude Code in der Vergangenheit über npm installiert wurde, sollte auch diese Version entfernt werden.
npm uninstall -g @anthropic-ai/claude-code
3. Native Install ausführen
curl -fsSL https://claude.ai/install.sh | bash
4. Überprüfen
claude --version
Wenn eine Versionsnummer angezeigt wird, war die Installation erfolgreich. Zur Sicherheit empfiehlt es sich, auch which -a claude auszuführen und zu prüfen, ob keine überflüssigen claude-Instanzen aus anderen Quellen übrig geblieben sind.
which -a claude
Wenn die Ausgabe nur ~/.local/bin/claude enthält, ist die Umstellung abgeschlossen.
Falls „command not found" erscheint
Wenn claude --version den Fehler command not found liefert, ist ~/.local/bin möglicherweise nicht in der PATH-Variable enthalten. Das lässt sich mit folgendem Befehl prüfen:
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
Wenn keine Ausgabe erscheint, muss der PATH in .zshrc ergänzt werden.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Wenn claude --version nun eine Versionsnummer anzeigt, ist alles in Ordnung.
Gehen Einstellungen und Daten verloren?
Das ist wohl die wichtigste Frage. Die kurze Antwort: Normalerweise nicht.
Einstellungen und Zustand von Claude Code werden an einem anderen Ort gespeichert als die ausführbare Datei.
~/.claude/settings.json-- Benutzereinstellungen~/.claude.json-- Globaler Zustand: OAuth, Theme, MCP-Server usw.- Projektspezifische
.claude/und.mcp.json-- Projektbezogene Einstellungen
Weder brew uninstall --cask claude-code noch der Native Install berühren diese Dateien. Login-Status, Berechtigungseinstellungen und MCP-Server-Konfigurationen bleiben vollständig erhalten.
Auch in der offiziellen Dokumentation wird darauf hingewiesen, dass zum Zurücksetzen der Einstellungen ~/.claude und ~/.claude.json explizit gelöscht werden müssen. Umgekehrt bedeutet das: Wer sie nicht löscht, verliert nichts.
Backup zur Sicherheit
Wer auf Nummer sicher gehen möchte, kann vor der Umstellung ein Backup erstellen.
# Backup der globalen Einstellungen
mkdir -p ~/claude-backup-$(date +%Y%m%d)
cp -R ~/.claude ~/.claude.json ~/claude-backup-$(date +%Y%m%d) 2>/dev/null
# Backup der projektspezifischen Einstellungen (im Projektverzeichnis ausführen)
cp -R .claude .mcp.json ~/claude-backup-$(date +%Y%m%d)/ 2>/dev/null
Aktualisierung der Native-Install-Version
Die Native-Install-Version aktualisiert sich grundsätzlich automatisch. Beim Start und während der Ausführung wird regelmäßig auf Updates geprüft, Download und Installation erfolgen im Hintergrund. Da die Aktualisierung beim nächsten Start wirksam wird, ist im Normalfall kein manuelles Eingreifen erforderlich.
Manuelles Update bei Bedarf
claude update
Release-Kanal wechseln
Durch die Einstellung des Release-Kanals lässt sich steuern, wie Updates empfangen werden.
"latest"(Standard) -- Neue Funktionen direkt nach dem Release erhalten"stable"-- Stabile Version erhalten, die in der Regel etwa eine Woche später erscheint
Die Einstellung erfolgt entweder über /config → Auto-update channel innerhalb von Claude Code oder direkt in der settings.json.
{
"autoUpdatesChannel": "stable"
}
Wer Stabilität bevorzugt, sollte "stable" wählen.
Automatische Updates deaktivieren
In der settings.json unter env folgendes eintragen:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
Überprüfung nach dem Update
claude --version
claude doctor
claude doctor ist ein Befehl zur detaillierten Überprüfung von Einstellungen und Zustand. Er ist auch nützlich, wenn sich etwas seltsam verhält.
Zusammenfassung
Die Homebrew-Version von Claude Code lässt sich zwar einfach installieren, aktualisiert sich jedoch nicht automatisch. Bei der Verwendung auf mehreren Rechnern kann es je nach Zeitpunkt der manuellen Aktualisierung zu Versionsabweichungen kommen.
Mit dem Wechsel zu Native Install werden Updates automatisch im Hintergrund eingespielt, sodass dieses Problem kaum noch auftritt (da Updates erst beim nächsten Start wirksam werden, können durch unterschiedliche Neustartzeitpunkte vorübergehend Abweichungen entstehen).
- Umstellung ist einfach --
brew uninstall→ Neuinstallation percurl→ Überprüfung: 3 Schritte - Einstellungen und Daten bleiben erhalten -- Konfigurationsdateien werden separat von der ausführbaren Datei gespeichert
- Automatische Updates -- Updates erfolgen im Hintergrund, sodass stets die neueste Version verfügbar ist
- Update-Häufigkeit über Release-Kanal steuerbar -- Wer Stabilität bevorzugt, wählt
"stable"
Da auch die offizielle Dokumentation Native Install empfiehlt, ist jetzt ein guter Zeitpunkt für alle, die noch Homebrew verwenden, über einen Wechsel nachzudenken.