Erweiterte Einrichtung

Systemanforderungen, plattformspezifische Installation, Versionsverwaltung und Deinstallation für Claude Code.

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

To install Claude Code, use one of the following methods:

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

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

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

brew install --cask claude-code

winget install Anthropic.ClaudeCode

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:

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.

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 /config → Auto-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

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

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

So installieren Sie die stabile Version:

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

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

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

So installieren Sie eine bestimmte Versionsnummer:

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

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

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

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.

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

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

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.

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.

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

gpg --fingerprint security@anthropic.com

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

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"

gpg --verify manifest.json.sig manifest.json

sha256sum claude

shasum -a 256 claude

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

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

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

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

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

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

Entfernen Sie das globale npm-Paket:

npm uninstall -g @anthropic-ai/claude-code

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:

# 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

# Entfernen Sie Benutzereinstellungen und Status
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Entfernen Sie projektspezifische Einstellungen (führen Sie dies aus Ihrem Projektverzeichnis aus)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force