Erweiterte Einrichtung - Claude Code Docs

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. Native Windows-Setups erfordern Git für Windows. WSL-Setups 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:

Native Install (Recommended)
Homebrew
WinGet

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.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.Native Windows setups require Git for Windows. Install it first if you don’t have it. WSL setups do not need it.

Native installations automatically update in the background to keep you on the latest version.

brew install --cask claude-code

Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.

Homebrew installations do not auto-update. Run brew upgrade claude-code or brew upgrade claude-code@latest, depending on which cask you installed, to get the latest features and security fixes.

winget install Anthropic.ClaudeCode

WinGet installations do not auto-update. Run winget upgrade Anthropic.ClaudeCode periodically to get the latest features and security fixes.

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 Fehlerbehebungsanleitung.

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	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

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. Claude Code verwendet Git Bash 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 als Opt-in-Vorschau ausführen. 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

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- und WinGet-Installationen erfordern 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- und WinGet-Installationen werden nicht automatisch aktualisiert. Für Homebrew 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.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 /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.

Auto-Updates deaktivieren

Setzen Sie DISABLE_AUTOUPDATER auf "1" im env-Schlüssel Ihrer settings.json-Datei:

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

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, Migration von 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

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:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

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:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

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

Veraltete npm-Installation

Die npm-Installation ist veraltet. Das native Installationsprogramm ist schneller, erfordert keine Abhängigkeiten und wird automatisch im Hintergrund aktualisiert. Verwenden Sie die native Installationsmethode, wenn möglich.

Von npm zu nativ migrieren

Wenn Sie Claude Code zuvor mit npm installiert haben, wechseln Sie zum nativen Installationsprogramm:

# Installieren Sie die native Binärdatei
curl -fsSL https://claude.ai/install.sh | bash

# Entfernen Sie die alte npm-Installation
npm uninstall -g @anthropic-ai/claude-code

Sie können auch claude install aus einer bestehenden npm-Installation ausführen, um die native Binärdatei neben ihr zu installieren, und dann die npm-Version entfernen.

Mit npm installieren

Wenn Sie die npm-Installation aus Kompatibilitätsgründen benötigen, müssen Sie Node.js 18+ installiert haben. Installieren Sie das Paket global:

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

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.

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

Laden Sie das Manifest und die Signatur herunter

Setzen Sie VERSION auf die Veröffentlichung, die Sie überprüfen möchten.

REPO=https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

Ü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.

Ü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.

Linux
macOS
Windows PowerShell

sha256sum claude

shasum -a 256 claude

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

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: verwenden Sie die Manifest-Signatur oben, um die Integrität zu überprüfen. Linux-Binärdateien sind nicht einzeln code-signiert.

Claude Code deinstallieren

Um Claude Code zu entfernen, folgen Sie den Anweisungen für Ihre Installationsmethode.

Native Installation

Entfernen Sie die Claude Code-Binärdatei und Versionsdateien:

macOS, Linux, WSL
Windows PowerShell

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

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:

macOS, Linux, WSL
Windows PowerShell

# 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

Verwaltung

​Systemanforderungen

​Zusätzliche Abhängigkeiten

​Claude Code installieren

​Einrichtung unter Windows

​Alpine Linux und musl-basierte Distributionen

​Installation überprüfen

​Authentifizierung

​Claude Code aktualisieren

​Auto-Updates

​Release-Kanal konfigurieren

​Auto-Updates deaktivieren

​Manuell aktualisieren

​Erweiterte Installationsoptionen

​Eine bestimmte Version installieren

​Veraltete npm-Installation

​Von npm zu nativ migrieren

​Mit npm installieren

​Binärintegrität und Code-Signierung

​Manifest-Signatur überprüfen

​Plattform-Code-Signaturen

​Claude Code deinstallieren

​Native Installation

​Homebrew-Installation

​WinGet-Installation

​npm

​Konfigurationsdateien entfernen

Systemanforderungen

Zusätzliche Abhängigkeiten

Claude Code installieren

Einrichtung unter Windows

Alpine Linux und musl-basierte Distributionen

Installation überprüfen

Authentifizierung

Claude Code aktualisieren

Auto-Updates

Release-Kanal konfigurieren

Auto-Updates deaktivieren

Manuell aktualisieren

Erweiterte Installationsoptionen

Eine bestimmte Version installieren

Veraltete npm-Installation

Von npm zu nativ migrieren

Mit npm installieren

Binärintegrität und Code-Signierung

Manifest-Signatur überprüfen

Plattform-Code-Signaturen

Claude Code deinstallieren

Native Installation

Homebrew-Installation

WinGet-Installation

npm

Konfigurationsdateien entfernen