> ## 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.
# 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](/docs/de/quickstart). Wenn Sie noch nie ein Terminal verwendet haben, siehe [Terminalanleitung](/docs/de/terminal-guide).
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](/docs/de/network-config#network-access-requirements).
* **Shell**: Bash, Zsh, PowerShell oder CMD.
* **Standort**: [Von Anthropic unterstützte Länder](https://www.anthropic.com/supported-countries)
Zusätzliche Abhängigkeiten
* **ripgrep**: normalerweise in Claude Code enthalten. Falls die Suche fehlschlägt, siehe [Suche-Fehlerbehebung](/docs/de/troubleshooting#search-and-discovery-issues).
Claude Code installieren
Bevorzugen Sie eine grafische Benutzeroberfläche? Die [Desktop-App](/docs/de/desktop-quickstart) ermöglicht es Ihnen, Claude Code ohne das Terminal zu verwenden. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) oder [Linux](/docs/de/desktop-linux) herunter.
Um Claude Code zu installieren, öffnen Sie ein Terminal und führen Sie den Befehl für Ihr System aus. Wenn Sie noch nie ein Terminal verwendet haben, zeigt der [Terminal-Leitfaden](/docs/de/terminal-guide), wie Sie eines öffnen und den Befehl einfügen.
**macOS, Linux, WSL:**
```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```
Unter Windows zeigt Ihre Eingabeaufforderung `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.
**Windows PowerShell:**
```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```
**Windows CMD:**
```batch theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
Der Installationsbefehl zeigt keinen Fortschritt an, während er Claude Code herunterlädt. Wenn das Installationsprogramm fertig ist, öffnen Sie ein neues Terminal-Fenster und führen Sie `claude --version` aus. Eine funktionierende Installation gibt eine Versionsnummer aus. Wenn Ihre Shell sagt, dass `claude` nicht gefunden wird oder nicht erkannt wird, ist das Installationsverzeichnis noch nicht in Ihrem PATH: siehe [Beheben Sie Ihren PATH](/docs/de/troubleshoot-install#command-not-found-claude-after-installation).
Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell.
Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.
[Git für Windows](https://git-scm.com/downloads/win) wird auf nativem Windows empfohlen, damit Claude Code das Bash-Tool verwenden kann. Wenn Git für Windows nicht installiert ist, verwendet Claude Code stattdessen PowerShell als Shell-Tool. WSL-Setups benötigen Git für Windows nicht.
Native Installationen werden automatisch im Hintergrund aktualisiert, um Sie auf der neuesten Version zu halten.
```bash theme={null}
brew install --cask claude-code
```
Homebrew bietet zwei Casks. `claude-code` verfolgt den stabilen Release-Kanal, der normalerweise etwa eine Woche hinter dem aktuellen Stand liegt und Releases mit großen Regressionen überspringt. `claude-code@latest` verfolgt den neuesten Kanal und erhält neue Versionen, sobald sie verfügbar sind.
Homebrew-Installationen werden nicht automatisch aktualisiert. Führen Sie `brew upgrade claude-code` oder `brew upgrade claude-code@latest` aus, je nachdem welches Cask Sie installiert haben, um die neuesten Funktionen und Sicherheitspatches zu erhalten.
```powershell theme={null}
winget install Anthropic.ClaudeCode
```
WinGet-Installationen werden nicht automatisch aktualisiert. Führen Sie regelmäßig `winget upgrade Anthropic.ClaudeCode` aus, um die neuesten Funktionen und Sicherheitspatches zu erhalten.
Sie können auch mit [apt, dnf oder apk](/docs/de/setup#install-with-linux-package-managers) auf Debian, Fedora, RHEL und Alpine installieren.
Nach Abschluss der Installation öffnen Sie ein Terminal in dem Projekt, an dem Sie arbeiten möchten, und starten Sie Claude Code:
```bash theme={null}
claude
```
Claude Code öffnet eine interaktive Sitzung in Ihrem Terminal.
Wenn während der Installation Probleme auftreten, siehe [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install).
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](/docs/de/sandboxing) | Wann zu verwenden |
| - | - | - | - |
| [Natives Windows](#install-on-native-windows) | Keine; [Git für Windows](https://git-scm.com/downloads/win) ist optional | Nicht unterstützt | Windows-native Projekte und Tools |
| [WSL 2](#install-in-wsl) | WSL 2 aktiviert | Unterstützt | Linux-Toolchains oder Sandbox-Befehlsausführung |
| [WSL 1](#install-in-wsl) | WSL 1 aktiviert | Nicht unterstützt | Wenn WSL 2 nicht verfügbar ist |
Installation unter nativem Windows
Führen Sie den [Installationsbefehl](#install-claude-code) von PowerShell oder CMD aus. Sie müssen nicht als Administrator ausführen. Die Installation von [Git für Windows](https://git-scm.com/downloads/win) ist optional. Es stellt Git Bash bereit, das vom [Bash-Tool](/docs/de/tools-reference#bash-tool-behavior) und vom [Monitor-Tool](/docs/de/tools-reference#monitor-tool) benötigt wird.
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](/docs/de/terminal-guide#windows) Sie durch jeden Schritt.
Nach der Installation starten Sie `claude` von jedem Terminal aus.
* **Ohne Git für Windows** führt Claude Code Shell-Befehle über das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aus.
* **Mit Git für Windows** verwendet Claude Code Git Bash für das [Bash-Tool](/docs/de/tools-reference#bash-tool-behavior). Wenn Claude Code Git Bash nicht finden kann, legen Sie den Pfad in Ihrer [settings.json-Datei](/docs/de/settings) fest:
```json theme={null}
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
```
Wenn Git für Windows installiert ist, wird das PowerShell-Tool neben Bash verfügbar: standardmäßig aktiviert für claude.ai und Console-Konten, und aktiviert mit `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` in Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Sitzungen. Setzen Sie es auf `0`, um das Tool auszuschalten. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) für Einrichtung und Einschränkungen.
Installation in WSL
Öffnen Sie Ihre WSL-Distribution und führen Sie das Linux-Installationsprogramm aus den [Installationsanweisungen](#install-claude-code) aus. Sie installieren und starten `claude` im WSL-Terminal, nicht von PowerShell oder CMD.
Alpine Linux und musl-basierte Distributionen
Die Installation von Claude Code auf Alpine und anderen musl/uClibc-basierten Distributionen erfordert `bash` und `curl` für den Installationsbefehl sowie `libgcc`, `libstdc++` und `ripgrep` zur Laufzeit. Alpine enthält `bash` und `curl` nicht standardmäßig, daher schlägt der dokumentierte Installationsbefehl mit einem `not found`-Fehler fehl, bis Sie diese installieren. Installieren Sie diese Pakete mit dem Paketmanager Ihrer Distribution, und setzen Sie dann `USE_BUILTIN_RIPGREP=0`.
Dieses Beispiel installiert die erforderlichen Pakete auf Alpine:
```bash theme={null}
apk add bash curl libgcc libstdc++ ripgrep
```
Auf Alpine befindet sich `ripgrep` im Community-Repository. Wenn `apk` meldet, dass das Paket fehlt, fügen Sie das Community-Repository zu `/etc/apk/repositories` hinzu, wobei Sie Ihre Alpine-Version verwenden:
```bash theme={null}
echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories
```
Führen Sie `apk update` aus, um den Paketindex zu aktualisieren, und versuchen Sie den `apk add`-Befehl erneut.
Setzen Sie dann `USE_BUILTIN_RIPGREP` auf `0` in Ihrer [`settings.json`](/docs/de/settings-reference#all-settings)-Datei:
```json theme={null}
{
"env": {
"USE_BUILTIN_RIPGREP": "0"
}
}
```
Installation überprüfen
Nach der Installation bestätigen Sie, dass Claude Code funktioniert:
```bash theme={null}
claude --version
```
Eine funktionierende Installation gibt eine Versionsnummer wie `2.1.211 (Claude Code)` aus.
Wenn dies mit `command not found` oder einem anderen Fehler fehlschlägt, siehe [Installation und Anmeldung beheben](/docs/de/troubleshoot-install).
Für eine detailliertere Überprüfung Ihrer Installation und Konfiguration führen Sie [`claude doctor`](/docs/de/troubleshooting#get-more-help) aus:
```bash theme={null}
claude doctor
```
`claude doctor` gibt schreibgeschützte Diagnosen zu Installation und Einstellungen aus, ohne eine Sitzung zu starten, einschließlich Installationsstatus, Validierungsfehlern der Einstellungsdatei und allen Warnungen mit vorgeschlagenen Fixes.
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](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) oder [Microsoft Foundry](/docs/de/microsoft-foundry) verwenden.
Nach der Installation melden Sie sich an, indem Sie `claude` ausführen und den Anweisungen im Browser folgen. Wenn Sie die Umgebungsvariable `ANTHROPIC_API_KEY` gesetzt haben und den Schlüssel genehmigen, wenn Claude Code fragt, ob er verwendet werden soll, überspringt Claude Code die Anmeldeabfrage. Siehe [Authentifizierung](/docs/de/authentication) 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](#configure-release-channel), um zu steuern, ob Sie Updates sofort oder nach einem verzögerten stabilen Zeitplan erhalten, oder [Auto-Updates vollständig deaktivieren](#disable-auto-updates). Homebrew-, WinGet- und [Linux-Paketmanager](#install-with-linux-package-managers)-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.
Führen Sie `claude doctor` aus, um das Ergebnis des letzten Aktualisierungsversuchs anzuzeigen.
Unter macOS und Linux verwaltet das native Installationsprogramm das Startprogramm unter `~/.local/bin/claude` als Symlink in `~/.local/share/claude/versions/`. Wenn Sie dieses Startprogramm durch Ihr eigenes Skript oder Symlink ersetzen, lassen Auto-Update und `claude update` es an Ort und Stelle: neue Versionen werden weiterhin im Verzeichnis `versions/` installiert, und Ihr Startprogramm entscheidet, welche Version ausgeführt wird.
Mit einem benutzerdefinierten Startprogramm behält Claude Code auch jede installierte Version auf der Festplatte, da es nicht erkennen kann, welche Version das Startprogramm benötigt. `claude doctor` meldet ein Startprogramm, das das native Installationsprogramm nicht erstellt hat.
Um Claude Code das Startprogramm wieder verwalten zu lassen, entfernen Sie `~/.local/bin/claude` und führen Sie `claude update` aus.
Wenn eine npm-Globalinstallation nicht automatisch aktualisiert werden kann, weil das npm-Globalverzeichnis nicht beschreibbar ist, zeigt Claude Code beim Start eine einmalige Benachrichtigung an, und `claude doctor` listet die verfügbaren Fixes auf. Weitere Informationen finden Sie unter [Berechtigungsfehler während der Installation](/docs/de/troubleshoot-install#permission-errors-during-installation).
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](#install-with-linux-package-managers).
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`](/docs/de/env-vars) 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.
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](/docs/de/settings) hinzu:
```json theme={null}
{
"autoUpdatesChannel": "stable"
}
```
Ein neu veröffentlichtes Modell kann eine Claude Code-Version erfordern, die neuer ist als die Version, die der stabile Kanal bereitstellt. Um das Modell sofort zu verwenden, wechseln Sie zum Kanal latest.
Für Enterprise-Bereitstellungen können Sie einen konsistenten Release-Kanal in Ihrer Organisation mit [verwalteten Einstellungen](/docs/de/managed-settings) erzwingen.
Homebrew-Installationen wählen einen Kanal nach Cask-Name statt dieser Einstellung: `claude-code` verfolgt stabil und `claude-code@latest` verfolgt neueste.
Installationen aus den apt-, dnf- und apk-Repositorys wählen einen Kanal nach Repository statt über diese Einstellung. Um den Kanal zu wechseln, folgen Sie [Mit Linux-Paketmanagern installieren](#install-with-linux-package-managers).
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](/docs/de/settings) hinzu, um eine Untergrenze explizit festzulegen:
```json theme={null}
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}
```
In [verwalteten Einstellungen](/docs/de/managed-settings) erzwingt dies ein organisationsweites Minimum, das Benutzer- und Projekteinstellungen nicht überschreiben können.
Die `minimumVersion`-Festlegung beschränkt nur Updates. Um Claude Code zu zwingen, außerhalb eines Versionsbereichs nicht zu starten, verwenden Sie stattdessen die verwalteten Einstellungen `requiredMinimumVersion` und `requiredMaximumVersion`. Updates respektieren auch die `requiredMaximumVersion`-Obergrenze. Siehe [`requiredMinimumVersion`](/docs/de/settings-reference#requiredminimumversion) und [`requiredMaximumVersion`](/docs/de/settings-reference#requiredmaximumversion).
Auto-Updates deaktivieren
Setzen Sie `DISABLE_AUTOUPDATER` auf `"1"` im `env`-Schlüssel Ihrer [`settings.json`](/docs/de/settings-reference#all-settings)-Datei:
```json theme={null}
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
```
Auf einer nativen oder npm-Installation bestätigen Sie, dass die Änderung wirksam wurde, indem Sie `claude doctor` ausführen und überprüfen, dass die Zeile `Auto-updates` `disabled (set by env: DISABLE_AUTOUPDATER)` statt `enabled` anzeigt.
`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`](/docs/de/env-vars). 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:
```bash theme={null}
claude update
```
Wenn ein Update installiert wird, meldet der Befehl `Successfully updated from to version `. Wenn Sie bereits die neueste Version haben, meldet er `Claude Code is up to date ()`. Installationen, die von Homebrew, WinGet oder apk verwaltet werden, melden stattdessen `Claude is up to date!`.
Erweiterte Installationsoptionen
Diese Optionen sind für Versions-Pinning, Linux-Paketmanager, npm, Netzwerkspeicher 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](#configure-release-channel) für weitere Informationen.
So installieren Sie die neueste Version (Standard):
```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```
```batch theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
So installieren Sie die stabile Version:
```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash -s stable
```
```powershell theme={null}
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
```
```batch theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd
```
So installieren Sie eine bestimmte Versionsnummer:
```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
```
```powershell theme={null}
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
```
```batch theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd
```
Um zu bestätigen, welche Version installiert wurde, führen Sie `claude --version` aus: Der Befehl gibt die genaue Version aus, die Sie übergeben haben, z. B. `2.1.89 (Claude Code)`.
Mit Linux-Paketmanagern installieren
Claude Code veröffentlicht signierte apt-, dnf- und apk-Repositories. Jedes Repository bietet zwei Kanäle: `stable` stellt eine Version bereit, die typischerweise etwa eine Woche alt ist und Releases mit großen Regressionen überspringt, und `latest` stellt jeden Release bereit, sobald er veröffentlicht wird. Die folgenden Befehle konfigurieren den `stable`-Kanal, der für die meisten Benutzer geeignet ist; jeder Tab zeigt auch die `latest`-Repository-URL. 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](#binary-integrity-and-code-signing) signiert. Bevor Sie dem Schlüssel vertrauen, überprüfen Sie ihn wie in jedem Tab beschrieben.
Für Debian und Ubuntu. Die Installationsbefehle unten laden den Signaturschlüssel mit `curl` herunter und überprüfen ihn mit `gpg`, was frische Debian- und Ubuntu-Installationen möglicherweise nicht enthalten. Wenn einer der Befehle `command not found` meldet, installieren Sie zuerst beide:
```bash theme={null}
sudo apt install curl gnupg
```
Laden Sie den Signaturschlüssel herunter:
```bash theme={null}
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
```
Wenn dieser Download fehlschlägt, schlägt `apt update` später mit `NO_PUBKEY BAA929FF1A7ECACE` fehl. Bestätigen Sie, dass der Schlüssel heruntergeladen wurde und zu Anthropic gehört, bevor Sie fortfahren:
```bash theme={null}
gpg --show-keys /etc/apt/keyrings/claude-code.asc
```
Der Fingerabdruck, den gpg ausgibt, sollte `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE` sein. Wenn gpg meldet, dass die Datei nicht geöffnet werden kann oder keine gültigen OpenPGP-Daten enthält, ist der Download fehlgeschlagen oder hat falschen Inhalt zurückgegeben: Bestätigen Sie, dass Ihr Netzwerk `downloads.claude.ai` erreichen kann, und führen Sie dann den Download-Befehl erneut aus.
Registrieren Sie das Repository im `stable`-Kanal und installieren Sie:
```bash theme={null}
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
```
Um stattdessen den `latest`-Kanal zu verwenden, ändern sich sowohl der URL-Pfad als auch der Suite-Name. Verwenden Sie diese `deb`-Zeile:
```bash theme={null}
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
```
Um später zu aktualisieren, führen Sie `sudo apt update && sudo apt upgrade claude-code` aus.
Für Fedora und RHEL. Die folgenden Befehle konfigurieren den `stable`-Kanal:
```bash theme={null}
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
```
Um stattdessen den `latest`-Kanal zu verwenden, setzen Sie `baseurl` auf das `latest`-Repository:
```ini theme={null}
baseurl=https://downloads.claude.ai/claude-code/rpm/latest
```
dnf lädt den Schlüssel bei der ersten Installation herunter und fordert Sie auf, den Fingerabdruck zu bestätigen. Überprüfen Sie, ob er `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` entspricht, bevor Sie akzeptieren.
Um später zu aktualisieren, führen Sie `sudo dnf upgrade claude-code` aus.
Für Alpine Linux. Die folgenden Befehle konfigurieren den `stable`-Kanal:
```sh theme={null}
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
```
Um zum `latest`-Kanal zu wechseln, entfernen Sie die `stable`-Repository-Zeile und fügen Sie das `latest`-Repository hinzu:
```sh theme={null}
sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories
```
Überprüfen Sie den heruntergeladenen Schlüssel mit `sha256sum /etc/apk/keys/claude-code.rsa.pub`, was `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6` melden sollte.
Um später zu aktualisieren, führen Sie `apk update && apk upgrade claude-code` aus.
Mit npm installieren
Sie können Claude Code auch als globales npm-Paket installieren. Das npm-Paket erfordert [Node.js 22 oder später](https://nodejs.org/en/download). Bei einer älteren Node.js-Version gibt npm während der Installation eine `EBADENGINE`-Warnung aus, anstatt fehlzuschlagen; die Installation wird abgeschlossen und `claude` läuft weiterhin, da das Paket eine native Binärdatei herunterlädt, die Ihr Node.js zur Laufzeit nicht verwendet.
```bash theme={null}
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](/docs/de/troubleshoot-install#native-binary-not-found-after-npm-install), 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](/docs/de/troubleshoot-install#permission-errors-during-installation).
Auf Netzwerkspeicher installieren
Eine laufende Sitzung liest während der Arbeit Teile der ausführbaren Datei von Claude Code von der Festplatte, nicht nur beim Start. Wenn die Datei während der Sitzung unlesbar wird, zum Beispiel weil sie auf dem Netzwerkspeicher gekürzt oder gelöscht wurde, stürzt die Sitzung ab. Unter Linux meldet Ihre Shell dies als `Bus error`.
Wenn Home-Verzeichnisse auf Netzwerkspeicher liegen, etwa ein NFS-Home-Verzeichnis, das auf mehreren Rechnern eingebunden ist, richten Sie Installationen so ein, dass die ausführbare Datei jeder Sitzung bis zum Ende der Sitzung lesbar bleibt:
* **Auf lokaler Festplatte installieren**: Legen Sie die Binärdatei auf das lokale Dateisystem jedes Rechners, zum Beispiel mit einem [Linux-Paketmanager](#install-with-linux-package-managers) oder Ihren eigenen Deployment-Tools. Ein benutzerspezifisches npm-Präfix und das Standardverzeichnis `~/.local/share/claude/versions/` des nativen Installationsprogramms liegen beide im Home-Verzeichnis.
* **Jede Version in einem eigenen Verzeichnis halten**: Wenn Sie eine npm-Installation direkt mit `npm install -g` aktualisieren, wird die vorherige Binärdatei gelöscht. Auf Speicher, den mehrere Rechner gemeinsam nutzen, entfernt das die Datei, die Sitzungen auf den anderen Rechnern noch ausführen. Installieren Sie jede neue Version neben den alten und stellen Sie Benutzer darauf um.
* **Eine alte Version erst löschen, wenn kein Rechner sie mehr ausführen kann**: Ein Rechner kann keine Prozesse sehen, die auf anderen Rechnern laufen, daher reicht es nicht aus, vor dem Löschen nach laufenden Prozessen zu suchen.
* **Die eigenen Updates von Claude Code ausschalten**: Setzen Sie [`DISABLE_UPDATES`](/docs/de/env-vars) und installieren Sie neue Versionen mit Ihren eigenen Tools. Andernfalls führt ein Auto-Update einer npm-Installation auf einem Rechner dasselbe direkte Upgrade aus und entfernt die Binärdatei, die Sitzungen auf anderen Rechnern ausführen. Nur `DISABLE_AUTOUPDATER` zu setzen reicht nicht aus, da Benutzer weiterhin `claude update` und `claude install` ausführen können. Siehe [Auto-Updates deaktivieren](#disable-auto-updates).
Das native Installationsprogramm löscht alte Versionen aus `~/.local/share/claude/versions/` selbstständig, was relevant ist, wenn dieses Verzeichnis auf gemeinsam genutztem Speicher liegt. Neben der Version, auf die der Launcher verweist, und jeder Version, die eine Sitzung auf demselben Rechner ausführt, behält es die zwei neuesten Versionen und löscht den Rest. Eine Sitzung auf einem anderen Rechner, die eine gelöschte Version ausführt, verliert ihre Binärdatei. Mit einem [benutzerdefinierten Launcher](#auto-updates) behält Claude Code jede installierte Version und überlässt die Bereinigung Ihnen.
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.
Der Release-Signaturschlüssel wird unter einer festen URL veröffentlicht.
```bash theme={null}
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
```
Zeigen Sie den Fingerabdruck des importierten Schlüssels an.
```bash theme={null}
gpg --fingerprint security@anthropic.com
```
Bestätigen Sie, dass die Ausgabe diesen Fingerabdruck enthält:
```text theme={null}
31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE
```
Setzen Sie `VERSION` auf die Veröffentlichung, die Sie überprüfen möchten.
```bash theme={null}
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"
```
Überprüfen Sie die abgelöste Signatur gegen das Manifest.
```bash theme={null}
gpg --verify manifest.json.sig manifest.json
```
Ein gültiges Ergebnis meldet `Good signature from "Anthropic Claude Code Release Signing "`.
`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.
Vergleichen Sie die SHA256-Prüfsumme der Binärdatei mit dem Wert, der unter `platforms..checksum` in `manifest.json` aufgelistet ist. Die folgenden Befehle gehen davon aus, dass sich eine `claude`-Binärdatei im aktuellen Verzeichnis befindet. Um stattdessen eine installierte native Binärdatei zu überprüfen, führen Sie den Befehl gegen `~/.local/share/claude/versions/VERSION` aus und ersetzen Sie VERSION durch die Veröffentlichung, die Sie in Schritt 2 festgelegt haben.
```bash theme={null}
sha256sum claude
```
```bash theme={null}
shasum -a 256 claude
```
```powershell theme={null}
(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.
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](#install-with-linux-package-managers) 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](/docs/de/troubleshoot-install#check-for-conflicting-installations), um diese zu finden und zu entfernen.
Native Installation deinstallieren
Entfernen Sie die Claude Code-Binärdatei und Versionsdateien:
```bash theme={null}
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
```
```powershell theme={null}
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
```
Mit Homebrew deinstallieren
Entfernen Sie das Homebrew-Cask, das Sie installiert haben. Wenn Sie das stabile Cask installiert haben:
```bash theme={null}
brew uninstall --cask claude-code
```
Wenn Sie das neueste Cask installiert haben:
```bash theme={null}
brew uninstall --cask claude-code@latest
```
Mit WinGet deinstallieren
Entfernen Sie das WinGet-Paket:
```powershell theme={null}
winget uninstall Anthropic.ClaudeCode
```
Mit apt, dnf oder apk deinstallieren
Entfernen Sie das Paket und die Repository-Konfiguration:
```bash theme={null}
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
```
```bash theme={null}
sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo
```
```sh theme={null}
apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub
```
Mit npm deinstallieren
Entfernen Sie das globale npm-Paket:
```bash theme={null}
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](/docs/de/vs-code#uninstall-the-extension), das JetBrains-Plugin und die Desktop-App, bevor Sie diese Dateien löschen.
So entfernen Sie Claude Code-Einstellungen und zwischengespeicherte Daten:
```bash theme={null}
# 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
```
```powershell theme={null}
# 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
```