Diese Seite behandelt Systemanforderungen, plattformspezifische Installationsdetails, Updates und Deinstallation. Eine geführte Anleitung für Ihre erste Sitzung finden Sie im Schnellstart. Wenn Sie noch nie ein Terminal verwendet haben, siehe Terminalanleitung.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Systemanforderungen
Claude Code läuft auf den folgenden Plattformen und Konfigurationen:- Betriebssystem:
- macOS 13.0+
- Windows 10 1809+ oder Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
- Hardware: 4 GB+ RAM, x64 oder ARM64 Prozessor
- Netzwerk: Internetverbindung erforderlich. Siehe Netzwerkkonfiguration.
- Shell: Bash, Zsh, PowerShell oder CMD. Auf nativem Windows wird Git für Windows empfohlen; Claude Code fällt auf PowerShell zurück, wenn Git Bash nicht vorhanden ist. WSL-Setups benötigen Git für Windows nicht.
- Standort: Von Anthropic unterstützte Länder
Zusätzliche Abhängigkeiten
- ripgrep: normalerweise in Claude Code enthalten. Falls die Suche fehlschlägt, siehe Suche-Fehlerbehebung.
Claude Code installieren
To install Claude Code, use one of the following methods:- Native Install (Recommended)
- Homebrew
- WinGet
macOS, Linux, WSL:Windows PowerShell:Windows CMD:If you see
The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you’re in CMD, not PowerShell. Your prompt shows PS C:\ when you’re in PowerShell and C:\ without the PS when you’re in CMD.Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.Native installations automatically update in the background to keep you on the latest version.
Einrichtung unter Windows
Sie können Claude Code nativ unter Windows oder in WSL ausführen. Wählen Sie basierend darauf, wo sich Ihre Projekte befinden und welche Funktionen Sie benötigen:| Option | Erfordert | Sandboxing | Wann zu verwenden |
|---|---|---|---|
| Natives Windows | Git für Windows empfohlen; PowerShell wird verwendet, falls nicht vorhanden | Nicht unterstützt | Windows-native Projekte und Tools |
| WSL 2 | WSL 2 aktiviert | Unterstützt | Linux-Toolchains oder Sandbox-Befehlsausführung |
| WSL 1 | WSL 1 aktiviert | Nicht unterstützt | Wenn WSL 2 nicht verfügbar ist |
PS C:\Users\YourName> in PowerShell und C:\Users\YourName> ohne das PS in CMD. Wenn Sie neu im Terminal sind, führt die Terminalanleitung Sie durch jeden Schritt.
Nach der Installation starten Sie claude von PowerShell, CMD oder Git Bash. Wenn Git Bash installiert ist, verwendet Claude Code es intern, um Befehle auszuführen, unabhängig davon, von wo aus Sie es gestartet haben. Wenn Claude Code Ihre Git Bash-Installation nicht finden kann, legen Sie den Pfad in Ihrer settings.json-Datei fest:
CLAUDE_CODE_USE_POWERSHELL_TOOL=1, um sich anzumelden, oder 0, um sich abzumelden. Siehe PowerShell-Tool für Einrichtung und Einschränkungen.
Option 2: WSL
Öffnen Sie Ihre WSL-Distribution und führen Sie das Linux-Installationsprogramm aus den Installationsanweisungen oben aus. Sie installieren und starten claude im WSL-Terminal, nicht von PowerShell oder CMD.
Alpine Linux und musl-basierte Distributionen
Das native Installationsprogramm auf Alpine und anderen musl/uClibc-basierten Distributionen erfordertlibgcc, libstdc++ und ripgrep. Installieren Sie diese mit dem Paketmanager Ihrer Distribution, und setzen Sie dann USE_BUILTIN_RIPGREP=0.
Dieses Beispiel installiert die erforderlichen Pakete auf Alpine:
USE_BUILTIN_RIPGREP auf 0 in Ihrer settings.json-Datei:
Installation überprüfen
Nach der Installation bestätigen Sie, dass Claude Code funktioniert:command not found oder einem anderen Fehler fehlschlägt, siehe Installation und Anmeldung beheben.
Für eine detailliertere Überprüfung Ihrer Installation und Konfiguration führen Sie claude doctor aus:
Authentifizierung
Claude Code erfordert ein Pro-, Max-, Team-, Enterprise- oder Console-Konto. Der kostenlose Claude.ai-Plan beinhaltet keinen Claude Code-Zugriff. Sie können Claude Code auch mit einem Drittanbieter-API-Provider wie Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verwenden. Nach der Installation melden Sie sich an, indem Sieclaude ausführen und den Browser-Aufforderungen folgen. Siehe Authentifizierung für alle Kontotypen und Team-Setup-Optionen.
Claude Code aktualisieren
Native Installationen werden automatisch im Hintergrund aktualisiert. Sie können den Release-Kanal konfigurieren, um zu steuern, ob Sie Updates sofort oder nach einem verzögerten stabilen Zeitplan erhalten, oder Auto-Updates vollständig deaktivieren. Homebrew-, WinGet- und Linux-Paketmanager-Installationen erfordern standardmäßig manuelle Updates.Auto-Updates
Claude Code prüft beim Start und regelmäßig während der Ausführung auf Updates. Updates werden im Hintergrund heruntergeladen und installiert und treten beim nächsten Start von Claude Code in Kraft.Homebrew-, WinGet-, apt-, dnf- und apk-Installationen werden standardmäßig nicht automatisch aktualisiert. Weitere Informationen finden Sie unten, um sich für Homebrew und WinGet anzumelden. Um Homebrew manuell zu aktualisieren, führen Sie
brew upgrade claude-code oder brew upgrade claude-code@latest aus, je nachdem, welches Cask Sie installiert haben. Für WinGet führen Sie winget upgrade Anthropic.ClaudeCode aus. Für Linux-Paketmanager siehe die Upgrade-Befehle in Mit Linux-Paketmanagern installieren.Um Claude Code den Upgrade-Befehl für Sie auf Homebrew oder WinGet ausführen zu lassen, setzen Sie CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE auf 1. Claude Code führt dann das Upgrade im Hintergrund aus, wenn eine neue Version verfügbar ist, und zeigt bei Erfolg eine Neustartaufforderung an. Das Upgrade zielt nur auf das Claude Code-Paket ab und beeinträchtigt keine andere Software, die Sie installiert haben.Unter WinGet kann das Upgrade fehlschlagen, während Claude Code ausgeführt wird, da Windows die ausführbare Datei sperrt. In diesem Fall zeigt Claude Code stattdessen den manuellen Befehl an. apt, dnf und apk erfordern weiterhin ein manuelles Upgrade, da diese Befehle erhöhte Berechtigungen benötigen.Bekanntes Problem: Claude Code kann Sie über Updates benachrichtigen, bevor die neue Version in diesen Paketmanagern verfügbar ist. Wenn ein Upgrade fehlschlägt, warten Sie und versuchen Sie es später erneut.Homebrew behält alte Versionen nach Upgrades auf der Festplatte. Führen Sie regelmäßig brew cleanup aus, um Speicherplatz freizugeben.Release-Kanal konfigurieren
Steuern Sie, welchem Release-Kanal Claude Code für Auto-Updates undclaude update folgt, mit der Einstellung autoUpdatesChannel:
"latest", die Standardeinstellung: Erhalten Sie neue Funktionen, sobald sie veröffentlicht werden"stable": Verwenden Sie eine Version, die normalerweise etwa eine Woche alt ist und überspringen Sie Releases mit großen Regressionen
/config → Auto-update channel, oder fügen Sie es zu Ihrer settings.json-Datei hinzu:
claude-code verfolgt stabil und claude-code@latest verfolgt neueste.
Mindestversion festlegen
Die EinstellungminimumVersion etabliert eine Untergrenze. Hintergrund-Auto-Updates und claude update weigern sich, eine Version unter diesem Wert zu installieren, daher führt ein Wechsel zum Kanal "stable" nicht zu einem Downgrade, wenn Sie bereits auf einem neueren "latest"-Build sind.
Ein Wechsel von "latest" zu "stable" über /config fordert Sie auf, entweder bei der aktuellen Version zu bleiben oder das Downgrade zuzulassen. Wenn Sie sich entscheiden zu bleiben, wird minimumVersion auf diese Version gesetzt. Ein Wechsel zurück zu "latest" löscht es.
Fügen Sie es zu Ihrer settings.json-Datei hinzu, um eine Untergrenze explizit festzulegen:
Auto-Updates deaktivieren
Setzen SieDISABLE_AUTOUPDATER auf "1" im env-Schlüssel Ihrer settings.json-Datei:
DISABLE_AUTOUPDATER stoppt nur die Hintergrundprüfung; claude update und claude install funktionieren weiterhin. Um alle Update-Pfade, einschließlich manueller Updates, zu blockieren, setzen Sie stattdessen DISABLE_UPDATES. Verwenden Sie dies, wenn Sie Claude Code über Ihre eigenen Kanäle verteilen und Benutzer auf der Version bleiben müssen, die Sie bereitstellen.
Manuell aktualisieren
Um ein Update sofort anzuwenden, ohne auf die nächste Hintergrundprüfung zu warten, führen Sie aus:Erweiterte Installationsoptionen
Diese Optionen sind für Versions-Pinning, Linux-Paketmanager, npm und Überprüfung der Binärintegrität.Eine bestimmte Version installieren
Das native Installationsprogramm akzeptiert entweder eine bestimmte Versionsnummer oder einen Release-Kanal (latest oder stable). Der Kanal, den Sie bei der Installation wählen, wird zu Ihrem Standard für Auto-Updates. Siehe Release-Kanal konfigurieren für weitere Informationen.
So installieren Sie die neueste Version (Standard):
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
Mit Linux-Paketmanagern installieren
Claude Code veröffentlicht signierte apt-, dnf- und apk-Repositories. Ersetzen Siestable durch latest für den Rolling-Kanal. Paketmanager-Installationen werden nicht automatisch durch Claude Code aktualisiert; Updates erfolgen durch Ihren normalen System-Upgrade-Workflow.
Alle Repositories sind mit dem Claude Code Release-Signaturschlüssel signiert. Bevor Sie dem Schlüssel vertrauen, überprüfen Sie ihn wie in jedem Tab beschrieben.
- apt
- dnf
- apk
Für Debian und Ubuntu. Um den Rolling-Kanal zu verwenden, ändern Sie beide Überprüfen Sie den GPG-Schlüssel-Fingerabdruck, bevor Sie ihm vertrauen:
stable-Vorkommen in der deb-Zeile: den URL-Pfad und den Suite-Namen.gpg --show-keys /etc/apt/keyrings/claude-code.asc sollte 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE melden.Um später zu aktualisieren, führen Sie sudo apt update && sudo apt upgrade claude-code aus.Mit npm installieren
Sie können Claude Code auch als globales npm-Paket installieren. Das Paket erfordert Node.js 18 oder später.@anthropic-ai/claude-code-darwin-arm64 ein, und ein Postinstall-Schritt verknüpft sie. Die installierte claude-Binärdatei ruft selbst nicht Node auf.
Unterstützte npm-Installationsplattformen sind darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 und win32-arm64. Ihr Paketmanager muss optionale Abhängigkeiten zulassen. Siehe Fehlerbehebung, wenn die Binärdatei nach der Installation fehlt.
Um eine npm-Installation zu aktualisieren, führen Sie npm install -g @anthropic-ai/claude-code@latest aus. Vermeiden Sie npm update -g, das den Semver-Bereich aus der ursprünglichen Installation respektiert und Sie möglicherweise nicht zur neuesten Version führt.
Binärintegrität und Code-Signierung
Jede Veröffentlichung veröffentlicht einemanifest.json, die SHA256-Checksummen für jede Plattform-Binärdatei enthält. Das Manifest ist mit einem Anthropic GPG-Schlüssel signiert, daher überprüft die Überprüfung der Signatur auf dem Manifest transitiv jede Binärdatei, die es auflistet.
Manifest-Signatur überprüfen
Die Schritte 1-3 erfordern eine POSIX-Shell mitgpg und curl. Unter Windows führen Sie sie in Git Bash oder WSL aus. Schritt 4 enthält eine PowerShell-Option.
Laden Sie den öffentlichen Schlüssel herunter und importieren Sie ihn
Der Release-Signaturschlüssel wird unter einer festen URL veröffentlicht.Zeigen Sie den Fingerabdruck des importierten Schlüssels an.Bestätigen Sie, dass die Ausgabe diesen Fingerabdruck enthält:
Laden Sie das Manifest und die Signatur herunter
Setzen Sie
VERSION auf die Veröffentlichung, die Sie überprüfen möchten.Überprüfen Sie die Signatur
Überprüfen Sie die abgelöste Signatur gegen das Manifest.Ein gültiges Ergebnis meldet
Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".gpg druckt auch WARNING: This key is not certified with a trusted signature! für jeden neu importierten Schlüssel. Dies ist zu erwarten. Die Zeile Good signature bestätigt, dass die kryptografische Überprüfung bestanden wurde. Der Fingerabdruckvergleich in Schritt 1 bestätigt, dass der Schlüssel selbst authentisch ist.Manifest-Signaturen sind für Veröffentlichungen ab
2.1.89 verfügbar. Frühere Veröffentlichungen veröffentlichen Checksummen in manifest.json ohne abgelöste Signatur.Plattform-Code-Signaturen
Zusätzlich zum signierten Manifest tragen einzelne Binärdateien plattformspezifische Code-Signaturen, wo unterstützt.- macOS: signiert von „Anthropic PBC” und beglaubigt von Apple. Überprüfen Sie mit
codesign --verify --verbose ./claude. - Windows: signiert von „Anthropic, PBC”. Überprüfen Sie mit
Get-AuthenticodeSignature .\claude.exe. - Linux: Binärdateien sind nicht einzeln code-signiert. Wenn Sie direkt aus dem
claude-code-releases-Bucket herunterladen oder das native Installationsprogramm verwenden, überprüfen Sie die Integrität mit der Manifest-Signatur oben. Wenn Sie mit apt, dnf oder apk installieren, überprüft Ihr Paketmanager Signaturen automatisch mit dem Repository-Signaturschlüssel.
Claude Code deinstallieren
Um Claude Code zu entfernen, folgen Sie den Anweisungen für Ihre Installationsmethode. Wennclaude danach immer noch ausgeführt wird, haben Sie wahrscheinlich eine zweite Installation oder einen verbleibenden Shell-Alias von einem älteren Installer. Siehe Nach konfliktierenden Installationen prüfen, um diese zu finden und zu entfernen.
Native Installation
Entfernen Sie die Claude Code-Binärdatei und Versionsdateien:- macOS, Linux, WSL
- Windows PowerShell
Homebrew-Installation
Entfernen Sie das Homebrew-Cask, das Sie installiert haben. Wenn Sie das stabile Cask installiert haben:WinGet-Installation
Entfernen Sie das WinGet-Paket:apt / dnf / apk
Entfernen Sie das Paket und die Repository-Konfiguration:- apt
- dnf
- apk
npm
Entfernen Sie das globale npm-Paket:Konfigurationsdateien entfernen
Die VS Code-Erweiterung, das JetBrains-Plugin und die Desktop-App schreiben auch in~/.claude/. Wenn eines davon noch installiert ist, wird das Verzeichnis beim nächsten Ausführen neu erstellt. Um Claude Code vollständig zu entfernen, deinstallieren Sie die VS Code-Erweiterung, das JetBrains-Plugin und die Desktop-App, bevor Sie diese Dateien löschen.
So entfernen Sie Claude Code-Einstellungen und zwischengespeicherte Daten:
- macOS, Linux, WSL
- Windows PowerShell