Zum Hauptinhalt springen

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.

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.

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

Bevorzugen Sie eine grafische Benutzeroberfläche? Die Desktop-App ermöglicht es Ihnen, Claude Code ohne das Terminal zu verwenden. Laden Sie sie für macOS oder Windows herunter.Neu im Terminal? Siehe die Terminalanleitung für Schritt-für-Schritt-Anweisungen.
To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine. Nach Abschluss der Installation öffnen Sie ein Terminal in dem Projekt, an dem Sie arbeiten möchten, und starten Sie Claude Code:
claude
Wenn während der Installation Probleme auftreten, siehe Fehlerbehebung bei Installation und Anmeldung.

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:
OptionErfordertSandboxingWann zu verwenden
Natives WindowsGit für Windows empfohlen; PowerShell wird verwendet, falls nicht vorhandenNicht unterstütztWindows-native Projekte und Tools
WSL 2WSL 2 aktiviertUnterstütztLinux-Toolchains oder Sandbox-Befehlsausführung
WSL 1WSL 1 aktiviertNicht unterstütztWenn WSL 2 nicht verfügbar ist
Option 1: Natives Windows mit Git Bash Installieren Sie Git für Windows, und führen Sie dann den Installationsbefehl von PowerShell oder CMD aus. Sie müssen nicht als Administrator ausführen. Ob Sie von PowerShell oder CMD installieren, wirkt sich nur auf den Installationsbefehl aus, den Sie ausführen. Ihre Eingabeaufforderung zeigt 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:
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Claude Code kann auch PowerShell nativ unter Windows ausführen. Wenn Git Bash installiert ist, wird das PowerShell-Tool schrittweise als zusätzliche Option eingeführt: Setzen Sie 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 erfordert libgcc, 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:
apk add libgcc libstdc++ ripgrep
Setzen Sie dann USE_BUILTIN_RIPGREP auf 0 in Ihrer settings.json-Datei:
{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Installation überprüfen

Nach der Installation bestätigen Sie, dass Claude Code funktioniert:
claude --version
Wenn dies mit 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:
claude doctor

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 Sie claude 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 und claude 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
Konfigurieren Sie dies über /configAuto-update channel, oder fügen Sie es zu Ihrer settings.json-Datei hinzu:
{
  "autoUpdatesChannel": "stable"
}
Für Enterprise-Bereitstellungen können Sie einen konsistenten Release-Kanal in Ihrer Organisation mit verwalteten Einstellungen erzwingen. Homebrew-Installationen wählen einen Kanal nach Cask-Name statt dieser Einstellung: claude-code verfolgt stabil und claude-code@latest verfolgt neueste.

Mindestversion festlegen

Die Einstellung minimumVersion 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:
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}
In verwalteten Einstellungen erzwingt dies ein organisationsweites Minimum, das Benutzer- und Projekteinstellungen nicht überschreiben können.

Auto-Updates deaktivieren

Setzen Sie DISABLE_AUTOUPDATER auf "1" im env-Schlüssel Ihrer settings.json-Datei:
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}
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:
claude update

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):
curl -fsSL https://claude.ai/install.sh | bash
So installieren Sie die stabile Version:
curl -fsSL https://claude.ai/install.sh | bash -s stable
So installieren Sie eine bestimmte Versionsnummer:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Mit Linux-Paketmanagern installieren

Claude Code veröffentlicht signierte apt-, dnf- und apk-Repositories. Ersetzen Sie stable 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.
Für Debian und Ubuntu. Um den Rolling-Kanal zu verwenden, ändern Sie beide stable-Vorkommen in der deb-Zeile: den URL-Pfad und den Suite-Namen.
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code
Überprüfen Sie den GPG-Schlüssel-Fingerabdruck, bevor Sie ihm vertrauen: 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.
npm install -g @anthropic-ai/claude-code
Das npm-Paket installiert die gleiche native Binärdatei wie das eigenständige Installationsprogramm. npm zieht die Binärdatei durch eine plattformspezifische optionale Abhängigkeit wie @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.
Verwenden Sie NICHT sudo npm install -g, da dies zu Berechtigungsproblemen und Sicherheitsrisiken führen kann. Wenn Sie auf Berechtigungsfehler stoßen, siehe Fehlerbehebung bei Berechtigungsfehlern.

Binärintegrität und Code-Signierung

Jede Veröffentlichung veröffentlicht eine manifest.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 mit gpg und curl. Unter Windows führen Sie sie in Git Bash oder WSL aus. Schritt 4 enthält eine PowerShell-Option.
1

Laden Sie den öffentlichen Schlüssel herunter und importieren Sie ihn

Der Release-Signaturschlüssel wird unter einer festen URL veröffentlicht.
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
Zeigen Sie den Fingerabdruck des importierten Schlüssels an.
gpg --fingerprint security@anthropic.com
Bestätigen Sie, dass die Ausgabe diesen Fingerabdruck enthält:
31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
2

Laden Sie das Manifest und die Signatur herunter

Setzen Sie VERSION auf die Veröffentlichung, die Sie überprüfen möchten.
REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
3

Überprüfen Sie die Signatur

Überprüfen Sie die abgelöste Signatur gegen das Manifest.
gpg --verify manifest.json.sig manifest.json
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.
4

Überprüfen Sie die Binärdatei gegen das Manifest

Vergleichen Sie die SHA256-Prüfsumme Ihrer heruntergeladenen Binärdatei mit dem Wert, der unter platforms.<platform>.checksum in manifest.json aufgelistet ist.
sha256sum claude
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. Wenn claude 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:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Homebrew-Installation

Entfernen Sie das Homebrew-Cask, das Sie installiert haben. Wenn Sie das stabile Cask installiert haben:
brew uninstall --cask claude-code
Wenn Sie das neueste Cask installiert haben:
brew uninstall --cask claude-code@latest

WinGet-Installation

Entfernen Sie das WinGet-Paket:
winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

Entfernen Sie das Paket und die Repository-Konfiguration:
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

npm

Entfernen Sie das globale npm-Paket:
npm uninstall -g @anthropic-ai/claude-code

Konfigurationsdateien entfernen

Das Entfernen von Konfigurationsdateien löscht alle Ihre Einstellungen, zulässigen Tools, MCP-Serverkonfigurationen und Sitzungsverlauf.
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:
# Entfernen Sie Benutzereinstellungen und Status
rm -rf ~/.claude
rm ~/.claude.json

# Entfernen Sie projektspezifische Einstellungen (führen Sie dies aus Ihrem Projektverzeichnis aus)
rm -rf .claude
rm -f .mcp.json