388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source
389> ```389> ```
390 390
391Prüfen Sie unter Linux auf fehlende gemeinsam genutzte Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Unter Alpine Linux und anderen musl-basierten Distributionen siehe [Einrichtung unter Alpine Linux](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions).391Prüfen Sie unter Linux auf fehlende gemeinsam genutzte Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Unter Alpine Linux und anderen musl-basierten Distributionen siehe [Nicht passende musl- oder glibc-Binärdatei unter Linux](#linux-musl-or-glibc-binary-mismatch).
392 392
393```bash theme={null}393```bash theme={null}
394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"
402 402
403## Häufige Installationsprobleme403## Häufige Installationsprobleme
404 404
405Dies sind die am häufigsten auftretenden Installationsprobleme und deren Lösungen.405Dies sind die am häufigsten auftretenden Installationsprobleme und ihre Lösungen.
406 406
407### Installationsskript gibt HTML statt eines Shell-Skripts zurück407### Installationsskript gibt HTML statt eines Shell-Skripts zurück
408 408
415bash: line 1: `<!DOCTYPE html>'415bash: line 1: `<!DOCTYPE html>'
416```416```
417 417
418**PowerShell, Parse-Fehler**: Die Fehler verweisen auf die zurückgegebene Seite, wobei `iex` versucht, HTML und CSS als PowerShell auszuführen.418**PowerShell, Parse-Fehler**: Die Fehler verweisen auf Stellen in der zurückgegebenen Seite, wobei `iex` versucht, HTML und CSS als PowerShell auszuführen.
419 419
420```text theme={null}420```text theme={null}
421iex : At line:1 char:2310421iex : At line:1 char:2310
424...424...
425```425```
426 426
427Die Formulierung variiert je nach PowerShell-Version und Systemsprache: Sie können `Missing expression after unary operator '--'` oder einen `ParserError` mit `ParseException` sehen. HTML-Tags oder CSS im angeführten Text identifizieren diesen Fehler. Wenn Sie stattdessen mit `-OutFile install.ps1` herunterladen, ist die gespeicherte Datei die gleiche Webseite, daher hilft das auch nicht.427Der Wortlaut variiert je nach PowerShell-Version und Systemsprache: Möglicherweise sehen Sie stattdessen `Missing expression after unary operator '--'` oder einen `ParserError` mit `ParseException`. HTML-Tags oder CSS im zitierten Text kennzeichnen diesen Fehler. Wenn Sie stattdessen mit `-OutFile install.ps1` herunterladen, ist die gespeicherte Datei dieselbe Webseite, das hilft also ebenfalls nicht.
428 428
429**PowerShell, `System.Xml.XmlDocument`**: Der Fehler nennt diesen Typ, statt die Seite zu zitieren.429**PowerShell, `System.Xml.XmlDocument`**: Der Fehler nennt diesen Typ, anstatt die Seite zu zitieren.
430 430
431```text theme={null}431```text theme={null}
432System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script432System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script
433file, or operable program.433file, or operable program.
434```434```
435 435
436Wenn `irm` die Antwort als XML parsen kann, gibt es statt Text ein XML-Objekt zurück, und `iex` versucht dann, den Typnamen dieses Objekts als Befehl auszuführen. Das Installationsskript ist PowerShell-Code und lässt sich nicht als XML parsen, daher bedeutet auch dieser Fehler, dass die Antwort etwas anderes als das Skript war. Die Formulierung rund um den Typnamen variiert je nach PowerShell-Version und Systemsprache, aber `System.Xml.XmlDocument` selbst bleibt gleich, also orientieren Sie sich am Typnamen.436Wenn `irm` die Antwort als XML parsen kann, gibt es ein XML-Objekt statt Text zurück, und `iex` versucht dann, den Typnamen dieses Objekts als Befehl auszuführen. Das Installationsskript ist PowerShell-Code und lässt sich nicht als XML parsen, daher bedeutet auch dieser Fehler, dass die Antwort etwas anderes als das Skript war. Der Wortlaut um den Typnamen herum variiert je nach PowerShell-Version und Systemsprache, aber `System.Xml.XmlDocument` selbst bleibt gleich, orientieren Sie sich also am Typnamen.
437 437
438**CMD**: Sie sehen diesen Fehler, gefolgt vom HTML der zurückgegebenen Seite.438**CMD**: Sie sehen diesen Fehler, gefolgt vom HTML der zurückgegebenen Seite.
439 439
443C:\Users\you><!DOCTYPE html>...443C:\Users\you><!DOCTYPE html>...
444```444```
445 445
446Die erste Zeile erscheint in Ihrer Systemsprache, achten Sie daher auf das HTML, das darauf folgt.446Die erste Zeile erscheint in Ihrer Systemsprache, achten Sie also auf das darauf folgende HTML.
447 447
448**Ein 403 ohne Seite**: Je nachdem, wie die Anfrage weitergeleitet wurde, meldet curl einen 403-Status ohne HTML-Text.448**Ein 403 ohne Seite**: Je nachdem, wie die Anfrage geroutet wurde, meldet curl einen 403-Status ohne HTML-Body.
449 449
450```text theme={null}450```text theme={null}
451curl: (22) The requested URL returned error: 403451curl: (22) The requested URL returned error: 403
452```452```
453 453
454Dies alles bedeutet, dass die Installations-URL eine Webseite, ein XML-Dokument oder einen Fehlerstatus statt des Installationsskripts zurückgegeben hat. Wenn die Fehlerausgabe „App unavailable in region“ zitiert, ist Claude Code in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries).454All dies bedeutet, dass die Installations-URL eine Webseite, ein XML-Dokument oder einen Fehlerstatus statt des Installationsskripts zurückgegeben hat. Wenn die Fehlerausgabe „App unavailable in region“ zitiert, ist Claude Code in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries).
455 455
456Ein bloßer 403 ohne Text hat oft die gleiche Ursache, kann aber auch von einem Unternehmens-Proxy oder einer Firewall stammen, die den Download blockiert. Wenn Sie sich in einem unterstützten Land befinden und immer noch den 403-Fehler sehen, arbeiten Sie sich durch [Überprüfen Sie die Netzwerkverbindung](#check-network-connectivity) durch, bevor Sie die alternativen Installationsprogramme unten versuchen, da diese die gleichen Hosts erreichen.456Ein bloßer 403 ohne Body hat oft dieselbe Ursache, kann aber auch von einem Unternehmens-Proxy oder einer Firewall stammen, die den Download blockiert. Wenn Sie sich in einem unterstützten Land befinden und dennoch den 403 sehen, arbeiten Sie [Netzwerkkonnektivität prüfen](#check-network-connectivity) durch, bevor Sie die unten aufgeführten alternativen Installationsprogramme ausprobieren, da diese dieselben Hosts erreichen.
457 457
458Andernfalls kann dies aufgrund von Netzwerkproblemen, regionalen Routing-Problemen oder einer vorübergehenden Dienstunterbrechung geschehen.458Andernfalls kann dies durch Netzwerkprobleme, regionales Routing oder eine vorübergehende Dienststörung verursacht werden.
459 459
460**Lösungen:**460**Lösungen:**
461 461
4621. **Versuchen Sie es nach einigen Minuten erneut**: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.4621. **Nach einigen Minuten erneut versuchen**: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.
463 463
4642. **Verwenden Sie eine alternative Installationsmethode**: Anders als eine native Installation [aktualisiert sich eine Installation über Homebrew oder WinGet standardmäßig nicht selbst](https://code.claude.com/docs/de/setup.md#auto-updates).4642. **Eine alternative Installationsmethode verwenden**: Anders als eine native Installation [aktualisiert sich eine Homebrew- oder WinGet-Installation standardmäßig nicht selbst](https://code.claude.com/docs/de/setup.md#auto-updates).
465 465
466 Auf macOS installieren Sie über Homebrew:466 Installieren Sie unter macOS über Homebrew:
467 467
468 ```bash theme={null}468 ```bash theme={null}
469 brew install --cask claude-code469 brew install --cask claude-code
470 ```470 ```
471 471
472 Unter Windows installieren Sie über WinGet:472 Installieren Sie unter Windows über WinGet:
473 473
474 ```powershell theme={null}474 ```powershell theme={null}
475 winget install Anthropic.ClaudeCode475 winget install Anthropic.ClaudeCode
476 ```476 ```
477 477
478 Führen Sie dann `claude --version` aus, um zu bestätigen: Der Befehl gibt eine Versionsnummer wie `2.1.211 (Claude Code)` aus. Wenn die Shell meldet, dass `claude` nicht gefunden wird, öffnen Sie ein neues Terminal-Fenster und versuchen Sie es erneut: Die Sitzung, von der aus Sie installiert haben, behält ihren alten `PATH`.478 Führen Sie dann zur Bestätigung `claude --version` aus: Der Befehl gibt eine Versionsnummer wie `2.1.211 (Claude Code)` aus. Wenn die Shell meldet, dass `claude` nicht gefunden wird, öffnen Sie ein neues Terminalfenster und versuchen Sie es erneut: Die Sitzung, aus der Sie installiert haben, behält ihren alten `PATH`.
479 479
480### `command not found: claude` nach der Installation480### `command not found: claude` nach der Installation
481 481
482Die Installation ist abgeschlossen, aber `claude` funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform:482Die Installation wurde abgeschlossen, aber `claude` funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform:
483 483
484| Plattform | Fehlermeldung |484| Plattform | Fehlermeldung |
485| :- | :- |485| :- | :- |
488| Windows CMD | `'claude' is not recognized as an internal or external command` |488| Windows CMD | `'claude' is not recognized as an internal or external command` |
489| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |489| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |
490 490
491Wenn der Fehler unter Windows direkt nach einem Update von Claude Code aufgetreten ist, siehe [`claude.exe` aus der Sicherung wiederherstellen](#claude-exe-missing-after-an-update-on-windows).491Wenn der Fehler unter Windows direkt nach einem Update von Claude Code auftrat, siehe [`claude.exe` aus seiner Sicherung wiederherstellen](#claude-exe-missing-after-an-update-on-windows).
492 492
493Andernfalls siehe [Überprüfen Sie Ihren PATH](#verify-your-path) für die Behebung auf jeder Plattform.493Andernfalls finden Sie unter [Ihren PATH überprüfen](#verify-your-path) die Lösung für jede Plattform.
494 494
495### `permission denied` beim Hinzufügen zu Ihrem PATH495### `permission denied` beim Hinzufügen zu Ihrem PATH
496 496
497Wenn der `echo`-Befehl, der `~/.local/bin` zu Ihrem PATH hinzufügt, `zsh: permission denied: /Users/you/.zshrc` oder `bash: /home/you/.bashrc: Permission denied` ausgibt, kann Ihr Benutzer nicht in diese Datei schreiben, und es wurde nichts gespeichert. Prüfen Sie in Ihrem Terminal, wem die Datei gehört, und verwenden Sie dabei anstelle von `~/.zshrc` den Dateinamen Ihrer Shell:497Wenn der `echo`-Befehl, der `~/.local/bin` zu Ihrem PATH hinzufügt, `zsh: permission denied: /Users/you/.zshrc` oder `bash: /home/you/.bashrc: Permission denied` ausgibt, kann Ihr Benutzer nicht in diese Datei schreiben, und es wurde nichts gespeichert. Prüfen Sie in Ihrem Terminal, wem die Datei gehört, und verwenden Sie dabei den Dateinamen Ihrer Shell anstelle von `~/.zshrc`:
498 498
499```bash theme={null}499```bash theme={null}
500ls -l ~/.zshrc500ls -l ~/.zshrc
502 502
503Das dritte Feld der Ausgabe ist der Eigentümer.503Das dritte Feld der Ausgabe ist der Eigentümer.
504 504
505* **Der Eigentümer ist ein anderer Benutzer, etwa `root`**: Übernehmen Sie den Besitz mit `sudo chown $(whoami) ~/.zshrc`, was Administratorrechte erfordert.505* **Der Eigentümer ist ein anderer Benutzer, etwa `root`**: Übernehmen Sie die Eigentümerschaft mit `sudo chown $(whoami) ~/.zshrc`, wofür Administratorrechte erforderlich sind.
506* **Der Eigentümer sind Sie**: Die Datei ist schreibgeschützt. Machen Sie sie mit `chmod u+w ~/.zshrc` beschreibbar.506* **Der Eigentümer sind Sie**: Die Datei ist schreibgeschützt. Machen Sie sie mit `chmod u+w ~/.zshrc` beschreibbar.
507 507
508Führen Sie dann die beiden PATH-Befehle für Ihre Shell in [Überprüfen Sie Ihren PATH](#verify-your-path) erneut aus.508Führen Sie dann die beiden PATH-Befehle für Ihre Shell unter [Ihren PATH überprüfen](#verify-your-path) erneut aus.
509 509
510### `curl: (56) Failure writing output to destination`510### `curl: (56) Failure writing output to destination`
511 511
512Der Befehl `curl ... | bash` lädt das Skript herunter und leitet es an Bash zur Ausführung weiter. Dieser Fehler und der verwandte `curl: (23) Failure writing output to destination` bedeuten, dass Bash das vollständige Skript nicht erhalten hat. Exit-Code 56 zeigt an, dass der Download selbst unterbrochen wurde, und Exit-Code 23 zeigt an, dass curl nicht schreiben konnte, was es erhielt, in die Pipe, normalerweise weil Bash vorzeitig beendet wurde.512Der Befehl `curl ... | bash` lädt das Skript herunter und leitet es zur Ausführung per Pipe an Bash weiter. Dieser Fehler und der verwandte `curl: (23) Failure writing output to destination` bedeuten, dass Bash das vollständige Skript nicht erhalten hat. Exit-Code 56 gibt an, dass der Download selbst unterbrochen wurde, und Exit-Code 23 gibt an, dass curl das Empfangene nicht in die Pipe schreiben konnte, meist weil Bash vorzeitig beendet wurde.
513 513
514Testen Sie, dass Sie `downloads.claude.ai` mit der Überprüfung in [Überprüfen Sie die Netzwerkverbindung](#check-network-connectivity) erreichen können. Wenn Sie den Server erreicht haben, war der ursprüngliche Fehler wahrscheinlich vorübergehend; versuchen Sie den Installationsbefehl erneut. Sie können auch [eine alternative Installationsmethode versuchen](https://code.claude.com/docs/de/setup.md#install-claude-code).514Testen Sie mit der Prüfung unter [Netzwerkkonnektivität prüfen](#check-network-connectivity), ob Sie `downloads.claude.ai` erreichen können. Wenn Sie den Server erreicht haben, war der ursprüngliche Fehler wahrscheinlich sporadisch; führen Sie den Installationsbefehl erneut aus. Sie können auch [eine alternative Installationsmethode ausprobieren](https://code.claude.com/docs/de/setup.md#install-claude-code).
515 515
516### Homebrew Cask nicht verfügbar oder veraltet516### Homebrew-Cask nicht verfügbar oder veraltet
517 517
518Homebrew meldet `Error: Cask 'claude-code' is unavailable: No Cask with this name exists`, wenn Ihre lokale Kopie des Homebrew Cask-Index älter ist als die Veröffentlichung des Cask. Aktualisieren Sie den Index und versuchen Sie es erneut:518Homebrew meldet `Error: Cask 'claude-code' is unavailable: No Cask with this name exists`, wenn Ihre lokale Kopie des Homebrew-Cask-Index älter ist als die Veröffentlichung des Casks. Aktualisieren Sie den Index und versuchen Sie es erneut:
519 519
520```bash theme={null}520```bash theme={null}
521brew update521brew update
522brew install --cask claude-code522brew install --cask claude-code
523```523```
524 524
525Wenn Homebrew eine ältere Claude Code-Version installiert als erwartet, ist normalerweise der gleiche veraltete Index die Ursache. Der `claude-code` Cask verfolgt den stabilen Kanal und liegt normalerweise etwa eine Woche hinter der neuesten Version; für die neueste Version führen Sie stattdessen `brew install --cask claude-code@latest` aus. Siehe [Konfigurieren Sie den Release-Kanal](https://code.claude.com/docs/de/setup.md#configure-release-channel) für den Unterschied zwischen den beiden Casks.525Wenn Homebrew eine ältere Claude Code-Version installiert als erwartet, ist meist derselbe veraltete Index die Ursache. Der Cask `claude-code` folgt dem stabilen Kanal und liegt typischerweise etwa eine Woche hinter dem neuesten Release; für die neueste Version führen Sie stattdessen `brew install --cask claude-code@latest` aus. Siehe [Release-Kanal konfigurieren](https://code.claude.com/docs/de/setup.md#configure-release-channel) für den Unterschied zwischen den beiden Casks.
526 526
527### `Cask 'claude-code@latest' is not installed`527### `Cask 'claude-code@latest' is not installed`
528 528
536 536
537### TLS- oder SSL-Verbindungsfehler537### TLS- oder SSL-Verbindungsfehler
538 538
539Fehler wie diese deuten auf TLS-Handshake-Fehler hin:539Fehler wie diese bedeuten, dass der TLS-Handshake fehlgeschlagen ist:
540 540
541* `curl: (35) TLS connect error`541* `curl: (35) TLS connect error`
542* `schannel: next InitializeSecurityContext failed`542* `schannel: next InitializeSecurityContext failed`
547 547
548**Lösungen:**548**Lösungen:**
549 549
5501. **Aktualisieren Sie Ihre System-CA-Zertifikate**:5501. **Aktualisieren Sie die CA-Zertifikate Ihres Systems**:
551 551
552 Auf Ubuntu/Debian:552 Unter Ubuntu/Debian:
553 553
554 ```bash theme={null}554 ```bash theme={null}
555 sudo apt-get update && sudo apt-get install ca-certificates555 sudo apt-get update && sudo apt-get install ca-certificates
556 ```556 ```
557 557
558 Auf macOS verwendet das System-curl den Keychain-Vertrauensspeicher; das Aktualisieren von macOS selbst aktualisiert die Root-Zertifikate.558 Unter macOS verwendet das System-curl den Vertrauensspeicher des Schlüsselbunds; ein Update von macOS selbst aktualisiert die Stammzertifikate.
559 559
5602. **Aktivieren Sie in Windows PowerShell 5.1 TLS 1.2**:5602. **Aktivieren Sie in Windows PowerShell 5.1 TLS 1.2**:
561 ```powershell theme={null}561 ```powershell theme={null}
566 irm https://claude.ai/install.ps1 | iex566 irm https://claude.ai/install.ps1 | iex
567 ```567 ```
568 568
5693. **Überprüfen Sie auf Proxy- oder Firewall-Interferenz**: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich `unable to get local issuer certificate`, `unable to verify the first certificate` und `SELF_SIGNED_CERT_IN_CHAIN`. Sorgen Sie dafür, dass der Installations-Download der CA Ihres Unternehmens-Proxys vertraut:5693. **Prüfen Sie auf Störungen durch Proxy oder Firewall**: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich `unable to get local issuer certificate`, `unable to verify the first certificate` und `SELF_SIGNED_CERT_IN_CHAIN`. Sorgen Sie dafür, dass der Installations-Download der CA Ihres Unternehmens-Proxys vertraut:
570 570
571 > [tab] macOS/Linux571 > [tab] macOS/Linux
572 >572 >
573 > Setzen Sie `CURL_CA_BUNDLE` für die `curl`-Downloads des Installationsskripts und [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/de/network-config#custom-ca-certificates) für den Befehl `claude install`, den das Skript anschließend ausführt. Bitten Sie Ihr IT-Team um eine PEM-Datei mit dem Root-CA-Zertifikat Ihres Proxys, falls Sie diese nicht haben. Dieses Beispiel setzt beide Variablen auf die CA-Datei Ihres Proxys und führt das Skript im selben Terminal aus:573 > Setzen Sie `CURL_CA_BUNDLE` für die `curl`-Downloads des Installationsskripts und [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/de/network-config#custom-ca-certificates) für den Befehl `claude install`, den das Skript anschließend ausführt. Bitten Sie Ihr IT-Team um eine PEM-Datei mit dem Stamm-CA-Zertifikat Ihres Proxys, falls Sie diese nicht haben. Dieses Beispiel setzt beide auf die CA-Datei Ihres Proxys und führt das Skript im selben Terminal aus:
574 >574 >
575 > ```bash theme={null}575 > ```bash theme={null}
576 > export CURL_CA_BUNDLE=/path/to/corporate-ca.pem576 > export CURL_CA_BUNDLE=/path/to/corporate-ca.pem
578 > curl -fsSL https://claude.ai/install.sh | bash578 > curl -fsSL https://claude.ai/install.sh | bash
579 > ```579 > ```
580 >580 >
581 > Wenn die Installation weiterhin mit einem dieser Zertifikatsfehler fehlschlägt, bitten Sie Ihr IT-Team um eine Datei, die sowohl die öffentlichen Root-Zertifikate als auch die vollständige CA-Kette Ihres Proxys enthält. Setzen Sie dann beide Variablen auf diese Datei.581 > Wenn die Installation weiterhin mit einem dieser Zertifikatsfehler fehlschlägt, bitten Sie Ihr IT-Team um eine Datei, die sowohl die öffentlichen Stammzertifikate als auch die vollständige CA-Kette Ihres Proxys enthält. Setzen Sie dann beide Variablen auf diese Datei.
582 582
583 > [tab] Windows PowerShell583 > [tab] Windows PowerShell
584 >584 >
585 > Das PowerShell-Installationsprogramm lädt über .NET herunter, das TLS gegen den Windows-Zertifikatsspeicher validiert. Bitten Sie Ihr IT-Team, das CA-Zertifikat des Proxys zum Windows-Speicher hinzuzufügen, falls es nicht bereits vorhanden ist, und führen Sie dann das Installationsprogramm aus:585 > Das PowerShell-Installationsprogramm lädt über .NET herunter, das TLS gegen den Windows-Zertifikatspeicher validiert. Bitten Sie Ihr IT-Team, das CA-Zertifikat des Proxys zum Windows-Speicher hinzuzufügen, falls es dort noch nicht vorhanden ist, und führen Sie dann das Installationsprogramm aus:
586 >586 >
587 > ```powershell theme={null}587 > ```powershell theme={null}
588 > irm https://claude.ai/install.ps1 | iex588 > irm https://claude.ai/install.ps1 | iex
589 > ```589 > ```
590 590
591 Für Claude Code selbst nach der Installation setzen Sie `NODE_EXTRA_CA_CERTS`, damit API-Anfragen dem gleichen Bundle vertrauen:591 Für Claude Code selbst setzen Sie nach der Installation `NODE_EXTRA_CA_CERTS`, damit API-Anfragen demselben Bundle vertrauen:
592 592
593 > [tab] macOS/Linux593 > [tab] macOS/Linux
594 >594 >
602 > $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'602 > $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
603 > ```603 > ```
604 604
6054. **Unter Windows, Umgehung blockierter Sperrprüfungen**. Die Fehler `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` und `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` bedeuten, dass curl den Server erreicht hat, aber Ihr Netzwerk die Zertifikatssperrprüfung blockiert, was hinter Unternehmens-Firewalls häufig vorkommt. Wenn der fehlgeschlagene Befehl der `curl` ist, der `install.cmd` herunterlädt, führen Sie ihn von einer Eingabeaufforderung mit `--ssl-revoke-best-effort` hinzugefügt erneut aus:6054. **Umgehen Sie unter Windows blockierte Sperrprüfungen**. Die Fehler `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` und `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` bedeuten, dass curl den Server erreicht hat, Ihr Netzwerk aber die Abfrage der Zertifikatssperrung blockiert, was hinter Unternehmens-Firewalls häufig vorkommt. Wenn der fehlschlagende Befehl das `curl` ist, das `install.cmd` herunterlädt, führen Sie ihn in einer Eingabeaufforderung mit hinzugefügtem `--ssl-revoke-best-effort` erneut aus:
606 ```batch theme={null}606 ```batch theme={null}
607 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd607 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
608 ```608 ```
609 Wenn die eigenen Downloads des Skripts auf die gleichen Fehler treffen, versucht es sie automatisch mit Best-Effort-Sperrprüfung erneut, daher ist das Flag nur für den Befehl erforderlich, den Sie selbst ausführen. Best-Effort-Prüfung toleriert einen nicht erreichbaren Sperrserver, lehnt aber immer noch ein Zertifikat ab, das bekanntermaßen widerrufen ist, was dem Umgang von Browsern mit Sperrung entspricht. Sie können auch curls Sperrprüfung ganz vermeiden, indem Sie das PowerShell-Installationsprogramm von PowerShell aus ausführen, das über .NET herunterlädt und nicht fehlschlägt, wenn der Sperrserver nicht erreichbar ist:609 Wenn die eigenen Downloads des Skripts auf dieselben Fehler stoßen, versucht es diese automatisch erneut mit Best-Effort-Sperrprüfung, sodass das Flag nur bei dem Befehl nötig ist, den Sie selbst ausführen. Die Best-Effort-Prüfung toleriert einen nicht erreichbaren Sperrserver, lehnt aber weiterhin ein Zertifikat ab, das bekanntermaßen gesperrt ist, so wie Browser mit Sperrungen umgehen. Sie können die Sperrprüfung von curl auch vollständig vermeiden, indem Sie das PowerShell-Installationsprogramm in PowerShell ausführen, das über .NET herunterlädt und nicht fehlschlägt, wenn der Sperrserver nicht erreichbar ist:
610 ```powershell theme={null}610 ```powershell theme={null}
611 irm https://claude.ai/install.ps1 | iex611 irm https://claude.ai/install.ps1 | iex
612 ```612 ```
613 Sie können auch mit `winget install Anthropic.ClaudeCode` installieren, was curl ganz vermeidet.613 Sie können auch mit `winget install Anthropic.ClaudeCode` installieren, was curl vollständig umgeht.
614 614
615### `Failed to fetch version from downloads.claude.ai`615### `Failed to fetch version from downloads.claude.ai`
616 616
617Das Ende der Meldung nennt den Grund. Handelt es sich um einen Zertifikatsfehler wie `unable to verify the first certificate`, siehe [TLS- oder SSL-Verbindungsfehler](#tls-or-ssl-connection-errors). Bei jedem anderen Grund siehe [Überprüfen Sie die Netzwerkverbindung](#check-network-connectivity).617Das Ende der Meldung nennt den Grund. Wenn es sich um einen Zertifikatsfehler wie `unable to verify the first certificate` handelt, siehe [TLS- oder SSL-Verbindungsfehler](#tls-or-ssl-connection-errors). Bei jedem anderen Grund siehe [Netzwerkkonnektivität prüfen](#check-network-connectivity).
618 618
619### The connection dropped while downloading the update619### Die Verbindung brach beim Herunterladen des Updates ab
620 620
621Die Verbindung zum Download-Server wurde geschlossen, während `claude install` oder `claude update` die Claude Code-Binärdatei abrief, und die Wiederholungsversuche haben das Problem nicht behoben. Claude Code versucht den Download erneut, wenn die Verbindung abbricht, die Übertragung stockt oder die heruntergeladene Datei die Prüfsummenprüfung nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, etwa ein 404, wird nicht erneut versucht, da der Server bereits geantwortet hat. Vor v2.1.202 ließ eine einzige abgebrochene Verbindung den Download sofort mit dem bloßen Fehler `aborted` fehlschlagen, statt ihn erneut zu versuchen.621Die Verbindung zum Download-Server wurde geschlossen, während `claude install` oder `claude update` die Claude Code-Binärdatei abrief, und die Wiederholungsversuche konnten das nicht beheben. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung stockt oder die heruntergeladene Datei die Prüfsummenkontrolle nicht besteht, bis zu insgesamt drei Versuche. Ein abgeschlossener HTTP-Fehler wie ein 404 wird nicht wiederholt, da der Server bereits geantwortet hat. Vor v2.1.202 ließ eine einzige abgebrochene Verbindung den Download sofort mit dem bloßen Fehler `aborted` fehlschlagen, statt es erneut zu versuchen.
622 622
623```text theme={null}623```text theme={null}
624The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.624The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
625```625```
626 626
627Der Text in Klammern nennt, welcher Versuch fehlgeschlagen ist, und den zugrunde liegenden Netzwerkfehler. `claude update` stellt der Meldung auf stderr `Error: Failed to install native update` voran.627Der Text in Klammern nennt den fehlgeschlagenen Versuch und den zugrunde liegenden Netzwerkfehler. `claude update` stellt der Meldung auf stderr `Error: Failed to install native update` voran.
628 628
629Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten abgeschlossen wird, schlägt stattdessen mit `Download timed out: exceeded the total deadline` fehl. Claude Code versucht einen Download mit Zeitüberschreitung nicht erneut, da eine Verbindung, die zu langsam ist, um innerhalb der Frist fertig zu werden, auch bei einem sofortigen erneuten Versuch nicht fertig würde. Die folgenden Schritte gelten für beide Meldungen.629Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten abgeschlossen wird, schlägt stattdessen mit `Download timed out: exceeded the total deadline` fehl. Claude Code wiederholt einen Download nach Zeitüberschreitung nicht, da eine Verbindung, die zu langsam ist, um innerhalb der Frist fertig zu werden, auch bei einem sofortigen erneuten Versuch nicht fertig würde. Die folgenden Schritte gelten für beide Meldungen.
630 630
631Ein Proxy oder Gateway kann eine lange Übertragung schließen, bevor sie abgeschlossen ist, und die Claude Code-Binärdatei ist ein großer Download.631Ein Proxy oder Gateway kann eine lange Übertragung schließen, bevor sie abgeschlossen ist, und die Claude Code-Binärdatei ist ein großer Download.
632 632
633**Vorgehensweise:**633**Vorgehensweise:**
634 634
635* Führen Sie `claude update` erneut aus. In einem ansonsten funktionierenden Netzwerk gelingt der Download beim nächsten Durchlauf in der Regel. Bei der Zeitüberschreitungsmeldung führen Sie den Befehl erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.635* Führen Sie `claude update` erneut aus. In einem ansonsten funktionierenden Netzwerk gelingt der Download beim nächsten Durchlauf meist. Bei der Zeitüberschreitungsmeldung führen Sie den Befehl erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.
636* Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie `HTTPS_PROXY`, bevor Sie das Installationsprogramm oder `claude update` ausführen. Siehe [Überprüfen Sie die Netzwerkverbindung](#check-network-connectivity).636* Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie `HTTPS_PROXY`, bevor Sie das Installationsprogramm oder `claude update` ausführen. Siehe [Netzwerkkonnektivität prüfen](#check-network-connectivity).
637* Wenn ein Unternehmens-Proxy die Übertragung immer wieder schließt, bitten Sie Ihr Netzwerkteam, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Anforderungen an den Netzwerkzugriff](https://code.claude.com/docs/de/network-config.md#network-access-requirements).637* Wenn ein Unternehmens-Proxy die Übertragung immer wieder schließt, bitten Sie Ihr Netzwerkteam, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Anforderungen an den Netzwerkzugriff](https://code.claude.com/docs/de/network-config.md#network-access-requirements).
638* Führen Sie `claude doctor` in Ihrer Shell aus, um Installationsdiagnosen zu erhalten638* Führen Sie `claude doctor` in Ihrer Shell aus, um Installationsdiagnosen zu erhalten
639 639
640### Release verification failed for Claude Code640### Release-Verifizierung für Claude Code fehlgeschlagen
641 641
642Diese Meldung von `claude update` oder `claude install` bedeutet, dass Claude Code nicht bestätigen konnte, dass das Release, das installiert werden sollte, echt ist, und daher nichts installiert hat. Eine bereits vorhandene Version funktioniert weiterhin.642Diese Meldung von `claude update` oder `claude install` bedeutet, dass Claude Code nicht bestätigen konnte, dass das Release, das installiert werden sollte, echt ist, und daher nichts installiert hat. Jede bereits vorhandene Version funktioniert weiterhin.
643 643
644```text theme={null}644```text theme={null}
645Release verification failed for Claude Code <version> (<reason>). The update was not installed.645Release verification failed for Claude Code <version> (<reason>). The update was not installed.
650* **Ein Wert, der mit `sidecar_fetch_` beginnt**: Führen Sie denselben Befehl erneut in Ihrer Shell aus. `claude update` war erfolgreich, wenn eine Zeile ausgegeben wird, die mit `Successfully updated from` beginnt, und `claude install` war erfolgreich, wenn `Claude Code successfully installed!` ausgegeben wird.650* **Ein Wert, der mit `sidecar_fetch_` beginnt**: Führen Sie denselben Befehl erneut in Ihrer Shell aus. `claude update` war erfolgreich, wenn eine Zeile ausgegeben wird, die mit `Successfully updated from` beginnt, und `claude install` war erfolgreich, wenn `Claude Code successfully installed!` ausgegeben wird.
651* **Jeder andere Wert**: Versuchen Sie denselben Befehl später erneut651* **Jeder andere Wert**: Versuchen Sie denselben Befehl später erneut
652 652
653Bei jedem Wert gilt: Wenn die Meldung erneut erscheint, [melden Sie das Problem](#still-stuck) und fügen Sie die vollständige Meldung bei.653Wenn sich die Meldung wiederholt, [melden Sie das Problem](#still-stuck) unabhängig vom Wert und fügen Sie die vollständige Meldung bei.
654 654
655### `Auto-update failed · Run claude doctor` in der Fußzeile der Sitzung655### `Auto-update failed · Run claude doctor` in der Fußzeile der Sitzung
656 656
657Diese rote Zeile bedeutet, dass Claude Code versucht hat, sich im Hintergrund zu aktualisieren, und das Update nicht installiert wurde. Sie können weiterarbeiten, ohne etwas zu unternehmen.657Diese rote Zeile bedeutet, dass Claude Code versucht hat, sich im Hintergrund zu aktualisieren, und das Update nicht installiert wurde. Sie können ohne weiteres Zutun weiterarbeiten.
658 658
659Die Zeile verweist Sie auf `claude doctor`, dessen Zeile `Last update attempt: failed (install_failed)` ein Datum, aber keine Ursache angibt. Um das Update abzuschließen oder zu sehen, warum es fehlgeschlagen ist, führen Sie stattdessen `claude update` in Ihrer Shell aus. Wenn auch diese Installation fehlschlägt, suchen Sie den Fehler, den `claude update` ausgibt, unter [Ihren Fehler finden](#find-your-error).659Die Zeile verweist Sie auf `claude doctor`, dessen Zeile `Last update attempt: failed (install_failed)` ein Datum, aber keine Ursache nennt. Um das Update abzuschließen oder herauszufinden, warum es fehlgeschlagen ist, führen Sie stattdessen `claude update` in Ihrer Shell aus. Wenn auch diese Installation fehlschlägt, suchen Sie den Fehler, den `claude update` ausgibt, unter [Ihren Fehler finden](#find-your-error).
660 660
661### Falscher Installationsbefehl unter Windows661### Falscher Installationsbefehl unter Windows
662 662
663Wenn Sie `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.663Wenn Sie `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.
664 664
665* **`irm` nicht erkannt**: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Optionen:665* **`irm` nicht erkannt**: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Möglichkeiten:
666 666
667 Öffnen Sie PowerShell, indem Sie im Startmenü nach „PowerShell“ suchen, und führen Sie dann den ursprünglichen Installationsbefehl aus:667 Öffnen Sie PowerShell, indem Sie im Startmenü nach „PowerShell“ suchen, und führen Sie dann den ursprünglichen Installationsbefehl aus:
668 668
676 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd676 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
677 ```677 ```
678 678
679* **`&&` nicht gültig**: Sie befinden sich in PowerShell, haben aber den CMD-Installationsbefehl ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm:679* **`&&` kein gültiges Anweisungstrennzeichen**: Sie befinden sich in PowerShell, haben aber den Befehl des CMD-Installationsprogramms ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm:
680 ```powershell theme={null}680 ```powershell theme={null}
681 irm https://claude.ai/install.ps1 | iex681 irm https://claude.ai/install.ps1 | iex
682 ```682 ```
683 683
684* **`A parameter cannot be found that matches parameter name 'fsSL'`**: Sie haben das macOS/Linux `curl -fsSL ... | bash` Installationsprogramm in Windows PowerShell ausgeführt, wo `curl` ein Alias für `Invoke-WebRequest` ist und die `-fsSL` Flags ablehnt. Verwenden Sie stattdessen das PowerShell-Installationsprogramm:684* **`A parameter cannot be found that matches parameter name 'fsSL'`**: Sie haben das macOS/Linux-Installationsprogramm `curl -fsSL ... | bash` in Windows PowerShell ausgeführt, wo `curl` ein Alias für `Invoke-WebRequest` ist und die Flags `-fsSL` ablehnt. Verwenden Sie stattdessen das PowerShell-Installationsprogramm:
685 ```powershell theme={null}685 ```powershell theme={null}
686 irm https://claude.ai/install.ps1 | iex686 irm https://claude.ai/install.ps1 | iex
687 ```687 ```
691 irm https://claude.ai/install.ps1 | iex691 irm https://claude.ai/install.ps1 | iex
692 ```692 ```
693 693
694* **Der Befehl gibt Skript-Text aus, statt zu installieren**: Sie haben die Download-Hälfte des Befehls ohne den Teil ausgeführt, der ihn ausführt. `irm https://claude.ai/install.ps1` allein gibt das heruntergeladene Skript auf dem Terminal aus. Leiten Sie es an `iex` weiter, um es auszuführen:694* **Der Befehl gibt Skripttext aus, statt zu installieren**: Sie haben die Download-Hälfte des Befehls ohne den Teil ausgeführt, der das Skript ausführt. `irm https://claude.ai/install.ps1` allein gibt das heruntergeladene Skript im Terminal aus. Leiten Sie es per Pipe an `iex` weiter, um es auszuführen:
695 695
696 ```powershell theme={null}696 ```powershell theme={null}
697 irm https://claude.ai/install.ps1 | iex697 irm https://claude.ai/install.ps1 | iex
703 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd703 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
704 ```704 ```
705 705
706Welches Installationsprogramm Sie auch verwenden, bestätigen Sie, dass es funktioniert hat: Öffnen Sie ein neues Terminal und führen Sie `claude --version` aus, das eine Versionsnummer wie `2.1.211 (Claude Code)` ausgibt.706Bestätigen Sie unabhängig vom verwendeten Installationsprogramm, dass es funktioniert hat: Öffnen Sie ein neues Terminal und führen Sie `claude --version` aus, das eine Versionsnummer wie `2.1.211 (Claude Code)` ausgibt.
707 707
708### `running scripts is disabled on this system`708### `running scripts is disabled on this system`
709 709
710Die Installation oder das Ausführen von Claude Code über npm unter Windows kann mit einem `SecurityError` fehlschlagen:710Das Installieren oder Ausführen von Claude Code über npm unter Windows kann mit einem `SecurityError` fehlschlagen:
711 711
712```text theme={null}712```text theme={null}
713npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.713npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
715 + CategoryInfo : SecurityError: (:) [], PSSecurityException715 + CategoryInfo : SecurityError: (:) [], PSSecurityException
716```716```
717 717
718Der gleiche Fehler nennt `claude.ps1`, wenn Sie `claude` nach einer npm-Installation ausführen. Die Ausführungsrichtlinie von PowerShell blockiert die `.ps1` Launcher-Skripte, die npm für seine Befehle erstellt. Die Richtlinie gilt für Skriptdateien, daher beeinflusst sie nicht das PowerShell-Installationsprogramm `irm https://claude.ai/install.ps1 | iex`, das den heruntergeladenen Text direkt ausführt.718Derselbe Fehler nennt `claude.ps1`, wenn Sie `claude` nach einer npm-Installation ausführen. Die Ausführungsrichtlinie von PowerShell blockiert die `.ps1`-Startskripte, die npm für seine Befehle erstellt. Die Richtlinie gilt für Skriptdateien und betrifft daher nicht das PowerShell-Installationsprogramm `irm https://claude.ai/install.ps1 | iex`, das den heruntergeladenen Text direkt ausführt.
719 719
720**Lösungen:**720**Lösungen:**
721 721
7221. **Erlauben Sie lokal erstellte Skripte für Ihren Benutzer**, dann versuchen Sie es erneut:7221. **Lassen Sie lokal erstellte Skripte für Ihren Benutzer zu** und versuchen Sie es dann erneut:
723 ```powershell theme={null}723 ```powershell theme={null}
724 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser724 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
725 ```725 ```
7262. **Rufen Sie stattdessen den `.cmd` Launcher auf**: `npm.cmd` und `claude.cmd` machen das gleiche, und die Richtlinie deckt sie nicht ab.7262. **Rufen Sie stattdessen das `.cmd`-Startprogramm auf**: `npm.cmd` und `claude.cmd` erfüllen dieselbe Aufgabe, und die Richtlinie erfasst sie nicht.
7273. **Verwenden Sie das [PowerShell-Installationsprogramm](https://code.claude.com/docs/de/setup.md#install-claude-code)** statt npm. Es installiert eine Binärdatei statt eines `.ps1` Skripts.7273. **Verwenden Sie das [PowerShell-Installationsprogramm](https://code.claude.com/docs/de/setup.md#install-claude-code)** statt npm. Es installiert eine Binärdatei statt eines `.ps1`-Skripts.
728 728
729### `The process cannot access the file` während der Windows-Installation729### `The process cannot access the file` während der Windows-Installation
730 730
731Wenn das PowerShell-Installationsprogramm mit `Failed to download binary: The process cannot access the file ... because it is being used by another process` fehlschlägt, konnte das Installationsprogramm nicht in `%USERPROFILE%\.claude\downloads` schreiben. Dies bedeutet normalerweise, dass ein vorheriger Installationsversuch noch läuft, oder Antivirus-Software scannt eine teilweise heruntergeladene Binärdatei in diesem Ordner.731Wenn das PowerShell-Installationsprogramm mit `Failed to download binary: The process cannot access the file ... because it is being used by another process` fehlschlägt, konnte das Installationsprogramm nicht in `%USERPROFILE%\.claude\downloads` schreiben. Dies bedeutet meist, dass ein früherer Installationsversuch noch läuft oder dass Antivirensoftware eine teilweise heruntergeladene Binärdatei in diesem Ordner scannt.
732 732
733Schließen Sie alle anderen PowerShell-Fenster, die das Installationsprogramm ausführen, und warten Sie, bis Antivirus-Scans die Datei freigeben. Löschen Sie dann den Downloads-Ordner und führen Sie das Installationsprogramm erneut aus:733Schließen Sie alle anderen PowerShell-Fenster, in denen das Installationsprogramm läuft, und warten Sie, bis Antivirenscans die Datei freigeben. Löschen Sie dann den Download-Ordner und führen Sie das Installationsprogramm erneut aus:
734 734
735```powershell theme={null}735```powershell theme={null}
736Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"736Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
739 739
740### `claude.exe` fehlt nach einem Update unter Windows740### `claude.exe` fehlt nach einem Update unter Windows
741 741
742Wenn Ihr Terminal direkt nach einem Claude Code-Update unter Windows `'claude' is not recognized` meldet, überprüfen Sie, ob `%USERPROFILE%\.local\bin` immer noch `claude.exe` enthält. Wenn sich dieses Verzeichnis überhaupt nicht auf Ihrem PATH befindet, siehe stattdessen [Überprüfen Sie Ihren PATH](#verify-your-path). Um unter Windows zu aktualisieren, benennt Claude Code die vorhandene `claude.exe` zur Seite in eine Sicherung um und verschiebt die neue Version an ihre Stelle. Wenn das Verschieben der neuen Version an ihre Stelle fehlschlägt und Claude Code die Sicherung auch nicht zurückbenennen kann, behält das Verzeichnis die Sicherung, hat aber keine `claude.exe`.742Wenn Ihr Terminal direkt nach einem Update von Claude Code unter Windows `'claude' is not recognized` meldet, prüfen Sie, ob `%USERPROFILE%\.local\bin` noch `claude.exe` enthält. Wenn sich dieses Verzeichnis überhaupt nicht in Ihrem PATH befindet, siehe stattdessen [Ihren PATH überprüfen](#verify-your-path). Für ein Update unter Windows benennt Claude Code die vorhandene `claude.exe` in eine Sicherung um und verschiebt die neue Version an ihre Stelle. Wenn das Verschieben der neuen Version fehlschlägt und Claude Code die Sicherung auch nicht zurückbenennen kann, enthält das Verzeichnis die Sicherung, aber keine `claude.exe`.
743 743
744Die Sicherung ist eine Datei im gleichen Verzeichnis, deren Name mit `claude.exe.old.` beginnt, gefolgt von einem numerischen Zeitstempel. Führen Sie Folgendes in PowerShell aus, um die neueste Sicherung zurück zu `claude.exe` umzubenennen:744Die Sicherung ist eine Datei im selben Verzeichnis, deren Name mit `claude.exe.old.` beginnt, gefolgt von einem numerischen Zeitstempel. Führen Sie Folgendes in PowerShell aus, um die neueste Sicherung wieder in `claude.exe` umzubenennen:
745 745
746```powershell theme={null}746```powershell theme={null}
747Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe747Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
749 749
750Führen Sie dann `claude --version` aus, um die Behebung zu bestätigen. Eine wiederhergestellte `claude.exe` gibt eine Versionsnummer aus.750Führen Sie dann `claude --version` aus, um die Behebung zu bestätigen. Eine wiederhergestellte `claude.exe` gibt eine Versionsnummer aus.
751 751
752Wenn es keine `claude.exe.old.*` Datei gibt, oder `claude` schlägt immer noch nach der Umbenennung fehl, installieren Sie statt:752Wenn es keine `claude.exe.old.*`-Datei gibt oder `claude` nach dem Umbenennen weiterhin fehlschlägt, installieren Sie stattdessen neu:
753 753
754```powershell theme={null}754```powershell theme={null}
755irm https://claude.ai/install.ps1 | iex755irm https://claude.ai/install.ps1 | iex
756```756```
757 757
758Vor v2.1.281 konnte Claude Code die Sicherung löschen, während `claude.exe` immer noch fehlte.758Vor v2.1.281 konnte Claude Code die Sicherung löschen, während `claude.exe` noch fehlte.
759 759
760### Installation auf Linux-Servern mit wenig Speicher beendet760### Installation auf Linux-Servern mit wenig Arbeitsspeicher abgebrochen
761 761
762Eine `Killed` Meldung während der Installation bedeutet normalerweise, dass der Linux Out-of-Memory (OOM) Killer den `claude install` Schritt beendet hat, weil dem System der Speicher ausgegangen ist. Dies ist häufig auf kleinen VPS und Cloud-Instanzen der Fall. Das Installationsskript meldet die Ursache und beendet sich mit Exit-Code 137. In diesem Beispiel variieren die Zeilennummer und die Prozess-ID je nach Release und Ausführung:762Eine `Killed`-Meldung während der Installation bedeutet meist, dass der Linux-Out-of-Memory-Killer (OOM-Killer) den Schritt `claude install` beendet hat, weil dem System der freie Arbeitsspeicher ausging. Dies ist bei kleinen VPS- und Cloud-Instanzen häufig. Das Installationsskript meldet die Ursache und wird mit Code 137 beendet. In diesem Beispiel variieren Zeilennummer und Prozess-ID je nach Release und Durchlauf:
763 763
764```text theme={null}764```text theme={null}
765Setting up Claude Code...765Setting up Claude Code...
768Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.768Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
769```769```
770 770
771Die Installation benötigt ungefähr 512 MB freien Speicher, und das Ausführen von Claude Code benötigt mehr. Siehe die [Systemanforderungen](https://code.claude.com/docs/de/setup.md#system-requirements).771Die Installation benötigt etwa 512 MB freien Arbeitsspeicher, und die Ausführung von Claude Code benötigt mehr. Siehe die [Systemanforderungen](https://code.claude.com/docs/de/setup.md#system-requirements).
772 772
773**Lösungen:**773**Lösungen:**
774 774
7751. **Fügen Sie Swap-Speicher hinzu**, wenn Ihr Server über begrenzte RAM verfügt. Swap verwendet Festplattenspeicher als Überlauf-Speicher, sodass die Installation auch bei wenig physischem RAM abgeschlossen werden kann.7751. **Fügen Sie Swap-Speicher hinzu**, wenn Ihr Server über begrenzten RAM verfügt. Swap nutzt Festplattenspeicher als Überlaufspeicher, sodass die Installation auch bei wenig physischem RAM abgeschlossen werden kann.
776 776
777 Erstellen Sie eine 2-GB-Swap-Datei und aktivieren Sie sie:777 Erstellen Sie eine 2-GB-Swap-Datei und aktivieren Sie sie:
778 778
783 sudo swapon /swapfile783 sudo swapon /swapfile
784 ```784 ```
785 785
786 Versuchen Sie dann die Installation erneut:786 Versuchen Sie die Installation dann erneut:
787 787
788 ```bash theme={null}788 ```bash theme={null}
789 curl -fsSL https://claude.ai/install.sh | bash789 curl -fsSL https://claude.ai/install.sh | bash
790 ```790 ```
791 791
7922. **Schließen Sie andere Prozesse**, um Speicher vor der Installation freizugeben.7922. **Schließen Sie andere Prozesse**, um vor der Installation Arbeitsspeicher freizugeben.
793 793
7943. **Verwenden Sie eine größere Instanz**, wenn möglich. Claude Code benötigt mindestens 4 GB RAM.7943. **Verwenden Sie nach Möglichkeit eine größere Instanz**. Claude Code erfordert mindestens 4 GB RAM.
795 795
796### Installation was killed before it could finish796### Installation was killed before it could finish
797 797
798Das Installationsskript meldet, wenn der Schritt `claude install` durch ein Signal beendet wird. Unter Linux bedeutet Exit-Code 137, dass der Prozess SIGKILL erhalten hat, und auf einem Host mit wenig Speicher ist das in der Regel der Out-of-Memory (OOM) Killer des Kernels. Das Skript gibt diese Erklärung aus und beendet sich mit Exit-Code 137:798Das Installationsskript meldet, wenn der Schritt `claude install` durch ein Signal beendet wird. Unter Linux bedeutet Exit-Code 137, dass der Prozess SIGKILL erhalten hat, und auf einem Host mit wenig Arbeitsspeicher ist das meist der Out-of-Memory-Killer (OOM-Killer) des Kernels. Das Skript gibt diese Erklärung aus und wird mit Code 137 beendet:
799 799
800```text theme={null}800```text theme={null}
801Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.801Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
802Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.802Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
803```803```
804 804
805Bei jedem anderen fatalen Signal und bei Exit-Code 137 unter macOS gibt das Skript `Installation was killed before it could finish (exit code <N>)` mit dem tatsächlichen Exit-Code aus und lässt die Out-of-Memory-Erklärung weg. Die Meldung stammt aus dem Installationsskript, das macOS und Linux verwenden und das auch Installationen innerhalb von WSL abdeckt; die nativen Windows-Installationsskripte geben sie nie aus. Vor v2.1.200 beendete sich das Skript nur mit der bloßen `Killed`-Zeile der Shell.805Bei jedem anderen fatalen Signal und bei Exit-Code 137 unter macOS gibt das Skript `Installation was killed before it could finish (exit code <N>)` mit dem tatsächlichen Exit-Code aus und lässt die Erklärung zum Speichermangel weg. Die Meldung stammt aus dem Installationsskript, das macOS und Linux verwenden und das auch Installationen innerhalb von WSL abdeckt; die nativen Windows-Installationsskripte geben sie nie aus. Vor v2.1.200 wurde das Skript nur mit der bloßen `Killed`-Zeile der Shell beendet.
806 806
807**Vorgehensweise:**807**Vorgehensweise:**
808 808
809* Beenden Sie andere Prozesse, um Speicher freizugeben, und führen Sie dann das Installationsprogramm erneut aus809* Beenden Sie andere Prozesse, um Arbeitsspeicher freizugeben, und führen Sie das Installationsprogramm dann erneut aus
810* Fügen Sie Swap-Speicher hinzu oder wechseln Sie zu einer größeren Instanz. Die Befehle für die Swap-Datei finden Sie unter [Installation auf Linux-Servern mit wenig Speicher beendet](#install-killed-on-low-memory-linux-servers).810* Fügen Sie Swap-Speicher hinzu oder wechseln Sie zu einer größeren Instanz. Die Befehle für die Swap-Datei finden Sie unter [Installation auf Linux-Servern mit wenig Arbeitsspeicher abgebrochen](#install-killed-on-low-memory-linux-servers).
811 811
812### Installation hängt in Docker812### Installation hängt in Docker
813 813
814Beim Installieren von Claude Code in einem Docker-Container kann die Installation als Root in `/` zu Hängern führen.814Bei der Installation von Claude Code in einem Docker-Container kann eine Installation als root in `/` zu Hängern führen.
815 815
816**Lösungen:**816**Lösungen:**
817 817
8181. **Setzen Sie ein Arbeitsverzeichnis**, bevor Sie das Installationsprogramm ausführen. Wenn es von `/` aus ausgeführt wird, scannt das Installationsprogramm das gesamte Dateisystem, was zu übermäßiger Speichernutzung führt. Das Setzen von `WORKDIR` begrenzt den Scan auf ein kleines Verzeichnis:8181. **Legen Sie ein Arbeitsverzeichnis fest**, bevor Sie das Installationsprogramm ausführen. Bei Ausführung aus `/` durchsucht das Installationsprogramm das gesamte Dateisystem, was zu übermäßigem Speicherverbrauch führt. Das Setzen von `WORKDIR` beschränkt die Suche auf ein kleines Verzeichnis:
819 ```dockerfile theme={null}819 ```dockerfile theme={null}
820 WORKDIR /tmp820 WORKDIR /tmp
821 RUN curl -fsSL https://claude.ai/install.sh | bash821 RUN curl -fsSL https://claude.ai/install.sh | bash
822 ```822 ```
823 823
8242. **Geben Sie Docker mehr Speicher**, wenn Sie Docker Desktop verwenden. Erstellen Sie Container, die den Speicher teilen, der der Docker Desktop Virtual Machine zugewiesen ist, daher öffnen Sie **Settings > Resources** in Docker Desktop, erhöhen Sie das Speicherlimit und führen Sie den Build erneut aus.8242. **Weisen Sie Docker mehr Arbeitsspeicher zu**, wenn Sie Docker Desktop verwenden. Build-Container teilen sich den Arbeitsspeicher, der der virtuellen Maschine von Docker Desktop zugewiesen ist. Öffnen Sie daher in Docker Desktop **Settings > Resources**, erhöhen Sie das Speicherlimit und führen Sie den Build erneut aus.
825 825
826### `Raw mode is not supported` während der Installation826### `Raw mode is not supported` während der Installation
827 827
828Wenn die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) Ihrer Organisation Änderungen enthalten, die [Sicherheitsgenehmigung](https://code.claude.com/docs/de/server-managed-settings.md#security-approval-dialogs) benötigen, versuchen Claude Code-Versionen vor 2.1.246, das Genehmigungsdialog während `claude install` anzuzeigen. Das Dialogfeld benötigt ein Terminal auf stdin. Wenn das Installationsprogramm `claude install` von einer Pipe aus ausführt, wie `curl -fsSL https://claude.ai/install.sh | bash` es tut, ist stdin die Pipe statt eines Terminals, daher schlägt die Installation mit einem Fehler fehl, der `Raw mode is not supported` enthält.828Wenn die [serververwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) Ihrer Organisation Änderungen enthalten, die eine [Sicherheitsgenehmigung](https://code.claude.com/docs/de/server-managed-settings.md#security-approval-dialogs) erfordern, versuchen Claude Code-Versionen vor 2.1.246, den Genehmigungsdialog während `claude install` anzuzeigen. Der Dialog benötigt ein Terminal an stdin. Wenn das Installationsprogramm `claude install` aus einer Pipe ausführt, wie es `curl -fsSL https://claude.ai/install.sh | bash` tut, ist stdin die Pipe und kein Terminal, sodass die Installation mit einem Fehler fehlschlägt, der `Raw mode is not supported` enthält.
829 829
830Claude Code v2.1.246 und später zeigen das Dialogfeld nicht während `claude install` oder `claude update` an. Der Befehl wird mit den Einstellungen ausgeführt, die Sie zuletzt genehmigt haben, und Claude Code zeigt das Dialogfeld in Ihrer nächsten interaktiven Sitzung an. Wenn die Startkonfiguration Ihrer Organisation [auf das Abrufen der Einstellungen wartet](https://code.claude.com/docs/de/server-managed-settings.md#enforce-fail-closed-startup), z. B. wenn sie `forceRemoteSettingsRefresh` setzt, erscheint das Dialogfeld immer noch während dieser Befehle, und eine Installation, die von einer Pipe aus ausgeführt wird, schlägt immer noch fehl.830Claude Code v2.1.246 und höher zeigen den Dialog während `claude install` oder `claude update` nicht an. Der Befehl läuft mit den zuletzt von Ihnen genehmigten Einstellungen, und Claude Code zeigt den Dialog in Ihrer nächsten interaktiven Sitzung an. Wenn die Startkonfiguration Ihrer Organisation [auf das Abrufen der Einstellungen wartet](https://code.claude.com/docs/de/server-managed-settings.md#enforce-fail-closed-startup), etwa wenn sie `forceRemoteSettingsRefresh` setzt, erscheint der Dialog während dieser Befehle weiterhin, und eine aus einer Pipe ausgeführte Installation schlägt weiterhin fehl.
831 831
832In jeder anderen Konfiguration hilft das erneute Ausführen des Installationsprogramms, diesen Fehler zu beheben, da das Skript den `install`-Befehl der neuesten Version ausführt, auch wenn Sie um die Installation einer älteren Version bitten. Führen Sie den Befehl für Ihre Plattform erneut aus:832In jeder anderen Konfiguration kommen Sie durch erneutes Ausführen des Installationsprogramms über diesen Fehler hinweg, da das Skript den `install`-Befehl des neuesten Releases ausführt, selbst wenn Sie eine ältere Version installieren möchten. Führen Sie den Befehl für Ihre Plattform erneut aus:
833 833
834> [tab] macOS/Linux834> [tab] macOS/Linux
835>835>
843> irm https://claude.ai/install.ps1 | iex843> irm https://claude.ai/install.ps1 | iex
844> ```844> ```
845 845
846`claude --version` gibt die Version aus, die die Wiederholung installiert hat.846`claude --version` gibt die Version aus, die durch den erneuten Durchlauf installiert wurde.
847 847
848### `claude update` oder `claude doctor` hängt848### `claude update` oder `claude doctor` hängt
849 849
850`claude update` und `claude doctor` scannen Ihre Shell-Konfigurationsdateien nach einem veralteten `claude` Alias: `~/.zshrc`, `~/.bashrc` und `~/.config/fish/config.fish`, plus auf macOS die erste von `~/.bash_profile`, `~/.bash_login` oder `~/.profile`, die existiert. Wenn Sie `ZDOTDIR` setzen, ist die Zsh-Datei stattdessen `$ZDOTDIR/.zshrc`. Wenn einer dieser Pfade ein Verzeichnis ist, überspringt Claude Code ihn und beide Befehle werden normal abgeschlossen. Vor v2.1.214 ließ ein Verzeichnis an einem dieser Pfade beide Befehle hängen und ließ den Abschnitt „System diagnostics“ von `/status` leer. `claude doctor` hängte ohne Ausgabe; `claude update` hängte direkt nach dem Drucken von `Checking for updates`.850`claude update` und `claude doctor` durchsuchen Ihre Shell-Konfigurationsdateien nach einem veralteten `claude`-Alias: `~/.zshrc`, `~/.bashrc` und `~/.config/fish/config.fish` sowie unter macOS die erste vorhandene Datei von `~/.bash_profile`, `~/.bash_login` oder `~/.profile`. Wenn Sie `ZDOTDIR` setzen, ist die Zsh-Datei stattdessen `$ZDOTDIR/.zshrc`. Wenn einer dieser Pfade ein Verzeichnis ist, überspringt Claude Code ihn, und beide Befehle werden normal abgeschlossen. Vor v2.1.214 führte ein Verzeichnis an einem dieser Pfade dazu, dass beide Befehle hingen und der Abschnitt mit der Systemdiagnose von `/status` leer blieb. `claude doctor` hing ohne Ausgabe; `claude update` hing direkt nach der Ausgabe von `Checking for updates`.
851 851
852Wenn Sie den Hänger auf einer früheren Version treffen, finden Sie das Verzeichnis. In der Ausgabe dieses Befehls markiert eine Zeile, die mit `d` beginnt, diesen Pfad als Verzeichnis. Eine `No such file or directory` Zeile bedeutet, dass an diesem Pfad nichts existiert und nicht die Ursache ist:852Wenn Sie den Hänger in einer früheren Version haben, suchen Sie das Verzeichnis. In der Ausgabe dieses Befehls kennzeichnet eine Zeile, die mit `d` beginnt, diesen Pfad als Verzeichnis. Eine Zeile `No such file or directory` bedeutet, dass an diesem Pfad nichts existiert, und ist nicht die Ursache:
853 853
854```bash theme={null}854```bash theme={null}
855ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish855ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish
856```856```
857 857
858Verschieben Sie das Verzeichnis zur Seite, oder aktualisieren Sie auf v2.1.214 oder später. Da `claude update` auf den betroffenen Versionen hängt, aktualisieren Sie stattdessen durch erneutes Ausführen des [Installationsskripts](https://code.claude.com/docs/de/setup.md#install-claude-code).858Verschieben Sie das Verzeichnis an eine andere Stelle oder aktualisieren Sie auf v2.1.214 oder höher. Da `claude update` in den betroffenen Versionen hängt, aktualisieren Sie stattdessen, indem Sie das [Installationsskript](https://code.claude.com/docs/de/setup.md#install-claude-code) erneut ausführen.
859 859
860### Claude Desktop überschreibt den `claude` Befehl unter Windows860### Claude Desktop überschreibt den Befehl `claude` unter Windows
861 861
862Wenn Sie eine ältere Version von Claude Desktop installiert haben, kann sie eine `Claude.exe` im `WindowsApps` Verzeichnis registrieren, die PATH-Priorität über Claude Code CLI hat. Das Ausführen von `claude` öffnet die Desktop-App statt der CLI.862Wenn Sie eine ältere Version von Claude Desktop installiert haben, registriert sie möglicherweise eine `Claude.exe` im Verzeichnis `WindowsApps`, die im PATH Vorrang vor der Claude Code CLI hat. Das Ausführen von `claude` öffnet dann die Desktop-App statt der CLI.
863 863
864Aktualisieren Sie Claude Desktop auf die neueste Version, um dieses Problem zu beheben.864Aktualisieren Sie Claude Desktop auf die neueste Version, um dieses Problem zu beheben.
865 865
866### Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell866### Claude Code on Windows requires either Git for Windows (for bash) or PowerShell
867 867
868Git für Windows ist optional. Claude Code verwendet das [PowerShell-Tool](https://code.claude.com/docs/de/tools-reference.md#powershell-tool), wenn Git Bash nicht vorhanden ist, daher bedeutet dieser Fehler, dass keine Shell gefunden wurde.868Git for Windows ist optional. Claude Code verwendet das [PowerShell-Tool](https://code.claude.com/docs/de/tools-reference.md#powershell-tool), wenn Git Bash fehlt, daher bedeutet dieser Fehler, dass keine der beiden Shells gefunden wurde.
869 869
870**Wenn PowerShell in Ihrem PATH fehlt**, ist sein Standardort `C:\Windows\System32\WindowsPowerShell\v1.0\`. Fügen Sie dieses Verzeichnis zu Ihrem `PATH` hinzu, oder installieren Sie [PowerShell 7](https://aka.ms/powershell), das `pwsh` bereitstellt.870**Wenn PowerShell in Ihrem PATH fehlt**: Der Standardspeicherort ist `C:\Windows\System32\WindowsPowerShell\v1.0\`. Fügen Sie dieses Verzeichnis zu Ihrem `PATH` hinzu oder installieren Sie [PowerShell 7](https://aka.ms/powershell), das `pwsh` bereitstellt.
871 871
872**Um Git für Windows stattdessen zu installieren**, laden Sie es von [git-scm.com/downloads/win](https://git-scm.com/downloads/win) herunter. Wählen Sie während der Einrichtung „Add to PATH“ aus. Starten Sie Ihr Terminal nach der Installation neu. Die Installation ermöglicht das Bash-Tool, das beim Arbeiten mit Bash-basierten Skripten und Tools nützlich ist.872**Um stattdessen Git for Windows zu installieren**, laden Sie es von [git-scm.com/downloads/win](https://git-scm.com/downloads/win) herunter. Wählen Sie während der Einrichtung „Add to PATH“. Starten Sie Ihr Terminal nach der Installation neu. Die Installation aktiviert das Bash-Tool, das bei der Arbeit mit Bash-basierten Skripten und Tools nützlich ist.
873 873
874**Wenn Git bereits installiert ist**, aber Claude Code kann es nicht finden, vergleichen Sie seinen Speicherort mit den Stellen, an denen Claude Code sucht. Wenn `CLAUDE_CODE_GIT_BASH_PATH` nicht gesetzt ist, sucht Claude Code nach `bash.exe` in dieser Reihenfolge:874**Wenn Git bereits installiert ist**, Claude Code es aber nicht findet, vergleichen Sie seinen Speicherort mit den Orten, die Claude Code prüft. Wenn `CLAUDE_CODE_GIT_BASH_PATH` nicht gesetzt ist, sucht Claude Code in dieser Reihenfolge nach `bash.exe`:
875 875
8761. Die Standard-Installationsorte `C:\Program Files\Git` und `C:\Program Files (x86)\Git`.8761. Die Standard-Installationsorte `C:\Program Files\Git` und `C:\Program Files (x86)\Git`.
8772. Das `git` auf Ihrem `PATH`, wobei `bin\bash.exe` aus dieser Git-Installation verwendet wird.8772. Das `git` in Ihrem `PATH`, wobei die `bin\bash.exe` dieser Git-Installation verwendet wird.
878 878
879In Schritt 2 überspringt Claude Code ein `git`, das sich in dem Ordner befindet, von dem aus Sie Claude Code gestartet haben, oder darunter in einem Pfad, der `node_modules` oder einen Virtual-Environment-Ordner wie `.venv` oder `env` enthält, z. B. `C:\dev\env\myproject\Git`, wenn Sie von `C:\dev\env\myproject` aus gestartet haben. Dies verhindert, dass Claude Code eine ausführbare Datei ausführt, die ein Projekt dort platziert hat. Wenn sich Ihr Git an einem Ort wie diesem befindet, zeigen Sie `CLAUDE_CODE_GIT_BASH_PATH` darauf.879In Schritt 2 überspringt Claude Code ein `git`, das sich in dem Ordner befindet, aus dem Sie Claude Code gestartet haben, oder darunter in einem Pfad, der `node_modules` oder einen Ordner einer virtuellen Umgebung wie `.venv` oder `env` enthält, zum Beispiel `C:\dev\env\myproject\Git`, wenn Sie aus `C:\dev\env\myproject` gestartet haben. Dies verhindert, dass Claude Code eine ausführbare Datei ausführt, die ein Projekt dort abgelegt hat. Wenn sich Ihr Git an einem solchen Ort befindet, richten Sie `CLAUDE_CODE_GIT_BASH_PATH` darauf aus.
880 880
881**Um Claude Code auf eine bestimmte Git-Installation zu verweisen**, finden Sie sie, indem Sie `where.exe git` in PowerShell ausführen, und setzen Sie dann den `bin\bash.exe` Pfad aus dieser Installation als `CLAUDE_CODE_GIT_BASH_PATH` in Ihrer [settings.json Datei](https://code.claude.com/docs/de/settings.md):881**Um Claude Code auf eine bestimmte Git-Installation zu verweisen**, ermitteln Sie diese, indem Sie `where.exe git` in PowerShell ausführen, und setzen Sie dann den `bin\bash.exe`-Pfad dieser Installation als `CLAUDE_CODE_GIT_BASH_PATH` in Ihrer [settings.json-Datei](https://code.claude.com/docs/de/settings.md):
882 882
883```json theme={null}883```json theme={null}
884{884{
888}888}
889```889```
890 890
891**Wenn `CLAUDE_CODE_GIT_BASH_PATH` auf den korrekten Pfad gesetzt ist und die Datei existiert**, aber Claude Code verwendet sie immer noch nicht, überprüfen Sie zuerst den Dateinamen. Claude Code akzeptiert nur eine Datei mit dem Namen `bash.exe`, `sh.exe`, `bash` oder `sh`; mit jedem anderen Namen, wie Git für Windows' `git-bash.exe` Launcher, ignoriert es die Variable und erkennt Git Bash automatisch, als wäre sie nicht gesetzt, und protokolliert eine Warnung, die mit `--debug` sichtbar ist. Ein Pfad, der nicht existiert, erhält die gleiche Fallback und Warnung. Vor v2.1.219 verwendete Claude Code jede existierende Datei als Shell, ohne ihren Namen zu überprüfen, und beendete sich beim Start mit `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path`, wenn der Pfad nicht existierte.891**Wenn `CLAUDE_CODE_GIT_BASH_PATH` auf den richtigen Pfad gesetzt ist und die Datei existiert**, Claude Code sie aber trotzdem nicht verwendet, prüfen Sie zuerst den Namen der Datei. Claude Code akzeptiert nur eine Datei mit dem Namen `bash.exe`, `sh.exe`, `bash` oder `sh`; bei jedem anderen Namen, etwa dem Startprogramm `git-bash.exe` von Git for Windows, ignoriert es die Variable und erkennt Git Bash automatisch, als wäre sie nicht gesetzt, wobei eine mit `--debug` sichtbare Warnung protokolliert wird. Ein Pfad, der nicht existiert, erhält denselben Fallback und dieselbe Warnung. Vor v2.1.219 verwendete Claude Code jede vorhandene Datei ohne Prüfung ihres Namens als Shell und wurde beim Start mit `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` beendet, wenn der Pfad nicht existierte.
892 892
893Wenn der Dateiname richtig ist, kann Endpoint-Security-Software wie AppLocker, Group Policy-Softwarebeschränkungsrichtlinien oder EDR-Agenten interferieren. Bitten Sie Ihr IT-Team, `claude.exe` und die Prozesse, die es erzeugt, einschließlich `cmd.exe` und `bash.exe`, in Ihrer Endpoint-Protection-Richtlinie auf die Whitelist zu setzen.893Wenn der Dateiname stimmt, stört möglicherweise Endpoint-Sicherheitssoftware wie AppLocker, Softwareeinschränkungsrichtlinien per Gruppenrichtlinie oder EDR-Agenten. Bitten Sie Ihr IT-Team, `claude.exe` und die von ihr gestarteten Prozesse, einschließlich `cmd.exe` und `bash.exe`, in Ihrer Endpoint-Schutzrichtlinie auf die Allowlist zu setzen.
894 894
895### Claude Code unterstützt 32-Bit Windows nicht895### Claude Code does not support 32-bit Windows
896 896
897Windows enthält zwei PowerShell-Einträge im Startmenü: `Windows PowerShell` und `Windows PowerShell (x86)`. Der x86-Eintrag wird als 32-Bit-Prozess ausgeführt und löst diesen Fehler auch auf einer 64-Bit-Maschine aus. Um zu überprüfen, welcher Fall vorliegt, führen Sie dies im gleichen Fenster aus, das den Fehler verursacht hat:897Windows enthält zwei PowerShell-Einträge im Startmenü: `Windows PowerShell` und `Windows PowerShell (x86)`. Der x86-Eintrag läuft als 32-Bit-Prozess und löst diesen Fehler auch auf einem 64-Bit-Rechner aus. Um zu prüfen, welcher Fall vorliegt, führen Sie Folgendes in demselben Fenster aus, das den Fehler erzeugt hat:
898 898
899```powershell theme={null}899```powershell theme={null}
900[Environment]::Is64BitOperatingSystem900[Environment]::Is64BitOperatingSystem
901```901```
902 902
903Wenn dies `True` ausgibt, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie `Windows PowerShell` ohne das x86-Suffix und führen Sie den Installationsbefehl erneut aus.903Wenn `True` ausgegeben wird, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie `Windows PowerShell` ohne den Zusatz x86 und führen Sie den Installationsbefehl erneut aus.
904 904
905Wenn dies `False` ausgibt, befinden Sie sich auf einer 32-Bit-Edition von Windows. Claude Code benötigt ein 64-Bit-Betriebssystem. Siehe die [Systemanforderungen](https://code.claude.com/docs/de/setup.md#system-requirements).905Wenn `False` ausgegeben wird, verwenden Sie eine 32-Bit-Edition von Windows. Claude Code erfordert ein 64-Bit-Betriebssystem. Siehe die [Systemanforderungen](https://code.claude.com/docs/de/setup.md#system-requirements).
906 906
907### Linux musl oder glibc Binärvarianten-Nichtübereinstimmung907### Linux: musl- oder glibc-Binärdatei passt nicht
908 908
909Wenn Sie nach der Installation Fehler über fehlende gemeinsame Bibliotheken wie `libstdc++.so.6` oder `libgcc_s.so.1` sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.909Wenn Sie nach der Installation Fehler zu fehlenden gemeinsam genutzten Bibliotheken wie `ld-linux-x86-64.so.2` oder `ld-linux-aarch64.so.1` sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.
910 910
911```text theme={null}911```text theme={null}
912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory
913```913```
914 914
915Dies kann auf glibc-basierten Systemen geschehen, auf denen musl-Cross-Compilation-Pakete installiert sind, was das Installationsprogramm dazu veranlasst, das System fälschlicherweise als musl zu erkennen.
916
917**Lösungen:**915**Lösungen:**
918 916
9191. **Überprüfen Sie, welche libc Ihr System verwendet**:9171. **Prüfen Sie, welche libc Ihr System verwendet**:
920 ```bash theme={null}918 ```bash theme={null}
921 ldd --version 2>&1 | head -1919 ldd --version 2>&1 | head -1
922 ```920 ```
923 Die Ausgabe, die `GNU libc` oder `GLIBC` erwähnt, bedeutet glibc. Die Ausgabe, die `musl` erwähnt, bedeutet musl.921 Eine Ausgabe, die `GNU libc` oder `GLIBC` erwähnt, bedeutet glibc. Eine Ausgabe, die `musl` erwähnt, bedeutet musl.
924 922
9252. **Wenn Sie auf glibc sind, aber die musl-Binärdatei erhalten haben**, entfernen Sie die Installation und installieren Sie erneut. Sie können die richtige Binärdatei auch manuell mit dem Manifest unter `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` herunterladen. Melden Sie ein [GitHub-Problem](https://github.com/anthropics/claude-code/issues) mit der Ausgabe von `ldd --version` und `ls /lib/libc.musl*`.9232. **Wenn Sie glibc verwenden, aber die musl-Binärdatei erhalten haben**, entfernen Sie die Installation und installieren Sie neu. Sie können die richtige Binärdatei auch manuell über das Manifest unter `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` herunterladen. Erstellen Sie ein [GitHub-Issue](https://github.com/anthropics/claude-code/issues) mit der Ausgabe von `ldd --version` und `ls /lib/libc.musl*`.
926 924
9273. **Wenn Sie sich tatsächlich auf musl befinden**, wie Alpine Linux, installieren Sie die erforderlichen Pakete:9253. **Wenn Sie musl verwenden, aber die glibc-Binärdatei erhalten haben**, [entfernen Sie die Installation](https://code.claude.com/docs/de/setup.md#uninstall-claude-code). Installieren Sie unter Alpine Linux zuerst die Pakete, die unter [Einrichtung für Alpine Linux](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions) genannt werden. Führen Sie dann den [Installationsbefehl](https://code.claude.com/docs/de/setup.md#install-claude-code) aus, der die musl-Binärdatei installiert.
928 ```bash theme={null}
929 apk add libgcc libstdc++ ripgrep
930 ```
931 Auf Alpine befindet sich `ripgrep` im Community-Repository. Wenn `apk` meldet, dass das Paket fehlt, siehe [Alpine Linux-Setup](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions).
932 926
933### `Illegal instruction`927### `Illegal instruction`
934 928
935Wenn das Ausführen von `claude` oder dem Installationsprogramm `Illegal instruction` ausgibt, verwendet die native Binärdatei CPU-Befehle, die Ihr Prozessor nicht unterstützt. Es gibt zwei unterschiedliche Ursachen.929Wenn beim Ausführen von `claude` oder des Installationsprogramms `Illegal instruction` ausgegeben wird, verwendet die native Binärdatei CPU-Befehle, die Ihr Prozessor nicht unterstützt. Es gibt zwei verschiedene Ursachen.
936 930
937**Architektur-Nichtübereinstimmung.** Das Installationsprogramm hat die falsche Binärdatei heruntergeladen, zum Beispiel x86 auf einem ARM-Server. Überprüfen Sie mit `uname -m` auf macOS oder Linux oder `$env:PROCESSOR_ARCHITECTURE` in PowerShell. Wenn das Ergebnis nicht mit der Binärdatei übereinstimmt, die Sie erhalten haben, [melden Sie ein GitHub-Problem](https://github.com/anthropics/claude-code/issues) mit der Ausgabe.931**Architektur passt nicht.** Das Installationsprogramm hat die falsche Binärdatei heruntergeladen, zum Beispiel x86 auf einem ARM-Server. Prüfen Sie dies mit `uname -m` unter macOS oder Linux oder mit `$env:PROCESSOR_ARCHITECTURE` in PowerShell. Wenn das Ergebnis nicht zur erhaltenen Binärdatei passt, [erstellen Sie ein GitHub-Issue](https://github.com/anthropics/claude-code/issues) mit der Ausgabe.
938 932
939**Fehlender AVX-Befehlssatz.** Wenn Ihre Architektur korrekt ist, aber Sie immer noch `Illegal instruction` sehen, fehlt Ihrer CPU wahrscheinlich AVX oder ein anderer Befehl, den die Binärdatei benötigt. Dies betrifft ungefähr Intel- und AMD-Prozessoren vor 2013 und virtuelle Maschinen, bei denen der Hypervisor AVX nicht an den Gast durchleitet.933**Fehlender AVX-Befehlssatz.** Wenn Ihre Architektur korrekt ist, Sie aber dennoch `Illegal instruction` sehen, fehlt Ihrer CPU wahrscheinlich AVX oder ein anderer Befehl, den die Binärdatei benötigt. Dies betrifft etwa Intel- und AMD-Prozessoren von vor 2013 sowie virtuelle Maschinen, bei denen der Hypervisor AVX nicht an das Gastsystem durchreicht.
940 934
941Auf einem VPS oder einer VM führen Sie `grep -m1 -ow avx /proc/cpuinfo` aus; ein leeres Ergebnis bedeutet, dass AVX für den Gast nicht verfügbar ist.935Führen Sie auf einem VPS oder einer VM `grep -m1 -ow avx /proc/cpuinfo` aus; ein leeres Ergebnis bedeutet, dass AVX für das Gastsystem nicht verfügbar ist.
942 936
943Es gibt keine native-binary Umgehung; verfolgen Sie [Problem #50384](https://github.com/anthropics/claude-code/issues/50384) für den Status und geben Sie Ihr CPU-Modell von `grep -m1 "model name" /proc/cpuinfo` unter Linux oder `sysctl -n machdep.cpu.brand_string` auf macOS an, wenn Sie es melden.937Es gibt keine Umgehung für die native Binärdatei; verfolgen Sie den Status in [Issue #50384](https://github.com/anthropics/claude-code/issues/50384) und geben Sie bei einer Meldung Ihr CPU-Modell aus `grep -m1 "model name" /proc/cpuinfo` unter Linux oder `sysctl -n machdep.cpu.brand_string` unter macOS an.
944 938
945Alternative Installationsmethoden laden die gleiche native Binärdatei herunter und werden keine der beiden Ursachen beheben.939Alternative Installationsmethoden laden dieselbe native Binärdatei herunter und beheben keine der beiden Ursachen.
946 940
947### `dyld: cannot load` auf macOS941### `dyld: cannot load` unter macOS
948 942
949Wenn Sie während der Installation `dyld: Symbol not found`, `dyld: cannot load` oder `Abort trap: 6` sehen, ist die Binärdatei mit Ihrer macOS-Version oder Hardware nicht kompatibel.943Wenn Sie während der Installation `dyld: Symbol not found`, `dyld: cannot load` oder `Abort trap: 6` sehen, ist die Binärdatei mit Ihrer macOS-Version oder Hardware nicht kompatibel.
950 944
951Ein `Symbol not found` Fehler, der auf `libicucore` verweist, bedeutet, dass Ihre macOS-Version älter ist als die Binärdatei unterstützt:945Ein `Symbol not found`-Fehler, der auf `libicucore` verweist, bedeutet, dass Ihre macOS-Version älter ist als die von der Binärdatei unterstützte:
952 946
953```text theme={null}947```text theme={null}
954dyld: Symbol not found: _ubrk_clone948dyld: Symbol not found: _ubrk_clone
956 Expected in: /usr/lib/libicucore.A.dylib950 Expected in: /usr/lib/libicucore.A.dylib
957```951```
958 952
959Der Loader kann stattdessen die Befehle zum Laden der Binärdatei ablehnen, was auch bedeutet, dass Ihre macOS-Version zu alt ist:953Der Loader kann stattdessen auch die Ladebefehle der Binärdatei ablehnen, was ebenfalls bedeutet, dass Ihre macOS-Version zu alt ist:
960 954
961```text theme={null}955```text theme={null}
962dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)956dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
965 959
966**Lösungen:**960**Lösungen:**
967 961
9681. **Überprüfen Sie Ihre macOS-Version**: Claude Code benötigt macOS 13.0 oder später. Öffnen Sie das Apple-Menü und wählen Sie „Über diesen Mac“, um Ihre Version zu überprüfen.9621. **Prüfen Sie Ihre macOS-Version**: Claude Code erfordert macOS 13.0 oder höher. Öffnen Sie das Apple-Menü und wählen Sie „Über diesen Mac“, um Ihre Version zu prüfen.
969 963
9702. **Aktualisieren Sie macOS**, wenn Sie eine ältere Version verwenden. Die Binärdatei verwendet Befehle und Systembibliotheken, die ältere macOS-Versionen nicht unterstützen. Alternative Installationsmethoden wie Homebrew laden die gleiche Binärdatei herunter und werden diesen Fehler nicht beheben.9642. **Aktualisieren Sie macOS**, wenn Sie eine ältere Version verwenden. Die Binärdatei verwendet Ladebefehle und Systembibliotheken, die ältere macOS-Versionen nicht unterstützen. Alternative Installationsmethoden wie Homebrew laden dieselbe Binärdatei herunter und beheben diesen Fehler nicht.
971 965
972### `Bus error` während einer laufenden Sitzung966### `Bus error` während einer laufenden Sitzung
973 967
974Wenn eine laufende Sitzung beendet wird und Ihre Shell `Bus error` ausgibt, besteht eine mögliche Ursache darin, dass Claude Code seine eigene ausführbare Datei nicht mehr vom Datenträger lesen konnte. Beispielsweise wurde die Datei während der Sitzung gekürzt oder auf einem Netzwerkspeicher gelöscht.968Wenn eine laufende Sitzung beendet wird und Ihre Shell `Bus error` ausgibt, kann eine Ursache sein, dass Claude Code seine eigene ausführbare Datei nicht mehr von der Festplatte lesen konnte. Beispielsweise wurde die Datei abgeschnitten oder auf einem Netzwerkspeicher gelöscht, während die Sitzung lief.
975 969
976Vor der Meldung der Shell kann die Laufzeitumgebung von Claude Code einen Absturzbericht ausgeben, der `panic(main thread): Bus error at address` und `oh no: Bun has crashed. This indicates a bug in Bun, not your code.` enthält. Wenn die ausführbare Datei unlesbar wurde, stammt der Absturz von der unlesbaren Datei, nicht von einem Fehler in Bun. Der Bericht kann auch fehlen, wenn die Laufzeitumgebung auch den Code, der ihn ausgibt, nicht lesen konnte.970Vor der Meldung der Shell kann die Laufzeitumgebung von Claude Code einen Absturzbericht ausgeben, der `panic(main thread): Bus error at address` und `oh no: Bun has crashed. This indicates a bug in Bun, not your code.` enthält. Wenn die ausführbare Datei unlesbar wurde, stammt der Absturz von der unlesbaren Datei, nicht von einem Fehler in Bun. Der Bericht kann auch fehlen, wenn die Laufzeitumgebung auch den Code, der ihn ausgibt, nicht lesen konnte.
977 971
978Starten Sie eine neue Sitzung, um fortzufahren. Wenn Claude Code auf einem Netzwerkspeicher installiert ist, folgen Sie [Installation auf Netzwerkspeicher](https://code.claude.com/docs/de/setup.md#install-on-network-storage), damit Upgrades keine Binärdatei entfernen, die laufende Sitzungen noch benötigen.972Starten Sie eine neue Sitzung, um fortzufahren. Wenn Claude Code auf einem Netzwerkspeicher installiert ist, folgen Sie [Auf Netzwerkspeicher installieren](https://code.claude.com/docs/de/setup.md#install-on-network-storage), damit Upgrades keine Binärdatei entfernen, die laufende Sitzungen noch benötigen.
979 973
980### `Exec format error` auf WSL1974### `Exec format error` unter WSL1
981 975
982Wenn das Ausführen von `claude` in WSL `cannot execute binary file: Exec format error` ausgibt, befinden Sie sich auf WSL1 und treffen auf eine bekannte native-binary Regression, die in [Problem #38788](https://github.com/anthropics/claude-code/issues/38788) verfolgt wird. Die Programm-Header der Binärdatei haben sich auf eine Weise geändert, die der WSL1-Loader nicht verarbeiten kann.976Wenn beim Ausführen von `claude` in WSL `cannot execute binary file: Exec format error` ausgegeben wird, verwenden Sie WSL1 und stoßen auf eine bekannte Regression der nativen Binärdatei, die in [Issue #38788](https://github.com/anthropics/claude-code/issues/38788) verfolgt wird. Die Programm-Header der Binärdatei haben sich auf eine Weise geändert, mit der der Loader von WSL1 nicht umgehen kann.
983 977
984Die sauberste Behebung ist die Konvertierung Ihrer Distribution zu WSL2 von PowerShell:978Die sauberste Lösung ist, Ihre Distribution in PowerShell auf WSL2 umzustellen:
985 979
986```powershell theme={null}980```powershell theme={null}
987wsl --set-version <DistroName> 2981wsl --set-version <DistroName> 2
988```982```
989 983
990Wenn Sie auf WSL1 bleiben müssen, rufen Sie die Binärdatei über den dynamischen Linker auf. Fügen Sie diese Funktion zu `~/.bashrc` in WSL hinzu, ersetzen Sie den Pfad, wenn sich Ihr Home-Verzeichnis unterscheidet:984Wenn Sie bei WSL1 bleiben müssen, rufen Sie die Binärdatei über den dynamischen Linker auf. Fügen Sie diese Funktion innerhalb von WSL zu `~/.bashrc` hinzu und ersetzen Sie den Pfad, falls Ihr Home-Verzeichnis abweicht:
991 985
992```bash theme={null}986```bash theme={null}
993claude() {987claude() {
999 993
1000### npm-Installationsfehler in WSL994### npm-Installationsfehler in WSL
1001 995
1002Diese Probleme gelten, wenn Sie Claude Code mit `npm install -g` in WSL installiert haben. Wenn Sie das [native Installationsprogramm](https://code.claude.com/docs/de/setup.md) verwendet haben, überspringen Sie diesen Abschnitt. Unter npm 12 installieren Sie wie unter [Eine npm-12-Installation reparieren](#fix-an-npm-12-install) beschrieben.996Diese Probleme gelten, wenn Sie Claude Code mit `npm install -g` innerhalb von WSL installiert haben. Wenn Sie das [native Installationsprogramm](https://code.claude.com/docs/de/setup.md) verwendet haben, überspringen Sie diesen Abschnitt. Installieren Sie unter npm 12 wie unter [Eine npm-12-Installation reparieren](#fix-an-npm-12-install) beschrieben.
1003 997
1004**Betriebssystem- oder Plattformerkennung Probleme.** Wenn npm während der Installation einen Plattform-Nichtübereinstimmung meldet, verwendet WSL wahrscheinlich das Windows `npm`. Führen Sie zuerst `npm config set os linux` aus, dann installieren Sie mit `npm install -g @anthropic-ai/claude-code --force`. Verwenden Sie nicht `sudo`.998**Probleme bei der Betriebssystem- oder Plattformerkennung.** Wenn npm während der Installation eine nicht passende Plattform meldet, führen Sie zuerst `npm config set os linux` aus und installieren Sie dann mit `npm install -g @anthropic-ai/claude-code@latest --force`. Verwenden Sie nicht `sudo`.
1005 999
1006**`exec: node: not found` beim Ausführen von `claude`.** Ihre WSL-Umgebung verwendet wahrscheinlich die Windows-Installation von Node.js. Bestätigen Sie mit `which npm` und `which node`: Pfade, die mit `/mnt/c/` beginnen, sind Windows-Binärdateien, während Linux-Pfade mit `/usr/` beginnen. Um dies zu beheben, installieren Sie Node über den Paketmanager Ihrer Linux-Distribution oder über [`nvm`](https://github.com/nvm-sh/nvm).1000**`exec: node: not found` beim Ausführen von `claude`.** Ihre WSL-Umgebung verwendet wahrscheinlich die Windows-Installation von Node.js. Bestätigen Sie dies mit `which npm` und `which node`: Pfade, die mit `/mnt/c/` beginnen, sind Windows-Binärdateien, während Linux-Pfade mit `/usr/` beginnen. Um dies zu beheben, installieren Sie Node über den Paketmanager Ihrer Linux-Distribution oder über [`nvm`](https://github.com/nvm-sh/nvm).
1007 1001
1008**nvm Versionskonflikte.** Wenn Sie nvm sowohl in WSL als auch in Windows installiert haben, kann das Wechseln von Node-Versionen in WSL fehlschlagen, da WSL standardmäßig den Windows-PATH importiert und das Windows-nvm Priorität hat. Die häufigste Ursache ist, dass nvm nicht in Ihrer Shell geladen wird. Fügen Sie den nvm-Loader zu `~/.bashrc` oder `~/.zshrc` hinzu:1002**nvm-Versionskonflikte.** Wenn Sie nvm sowohl in WSL als auch in Windows installiert haben, kann das Wechseln von Node-Versionen in WSL fehlschlagen, weil WSL standardmäßig den Windows-PATH importiert und das Windows-nvm Vorrang hat. Die häufigste Ursache ist, dass nvm in Ihrer Shell nicht geladen ist. Fügen Sie den nvm-Loader zu `~/.bashrc` oder `~/.zshrc` hinzu:
1009 1003
1010```bash theme={null}1004```bash theme={null}
1011export NVM_DIR="$HOME/.nvm"1005export NVM_DIR="$HOME/.nvm"
1013[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"1007[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
1014```1008```
1015 1009
1016Oder laden Sie es in Ihrer aktuellen Sitzung:1010Oder laden Sie ihn in Ihrer aktuellen Sitzung:
1017 1011
1018```bash theme={null}1012```bash theme={null}
1019source ~/.nvm/nvm.sh1013source ~/.nvm/nvm.sh
1020```1014```
1021 1015
1022Wenn nvm geladen ist, aber Windows-Pfade immer noch Priorität haben, stellen Sie Ihren Linux-Node-Pfad explizit voran:1016Wenn nvm geladen ist, Windows-Pfade aber weiterhin Vorrang haben, stellen Sie Ihren Linux-Node-Pfad explizit voran:
1023 1017
1024```bash theme={null}1018```bash theme={null}
1025export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"1019export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
1027 1021
1028> [!WARNING]1022> [!WARNING]
1029>1023>
1030> Vermeiden Sie das Deaktivieren des Windows-PATH-Imports über `appendWindowsPath = false`, da dies die Möglichkeit bricht, Windows-Ausführbare aus WSL aufzurufen. Vermeiden Sie auch das Deinstallieren von Node.js von Windows, wenn Sie es für Windows-Entwicklung verwenden.1024> Vermeiden Sie es, den Import des Windows-PATH über `appendWindowsPath = false` zu deaktivieren, da dies die Möglichkeit unterbindet, Windows-Programme aus WSL aufzurufen. Vermeiden Sie ebenso, Node.js unter Windows zu deinstallieren, wenn Sie es für die Windows-Entwicklung verwenden.
1031 1025
1032### Berechtigungsfehler während der Installation1026### Berechtigungsfehler während der Installation
1033 1027
1034Wenn das native Installationsprogramm mit Berechtigungsfehlern fehlschlägt, ist das Zielverzeichnis möglicherweise nicht beschreibbar. Siehe [Überprüfen Sie Verzeichnisberechtigungen](#check-directory-permissions).1028Wenn das native Installationsprogramm mit Berechtigungsfehlern fehlschlägt, ist das Zielverzeichnis möglicherweise nicht beschreibbar. Siehe [Verzeichnisberechtigungen prüfen](#check-directory-permissions).
1035 1029
1036Wenn Sie zuvor mit npm installiert haben und npm-spezifische Berechtigungsfehler erhalten, wechseln Sie zum nativen Installationsprogramm:1030Wenn Sie zuvor mit npm installiert haben und auf npm-spezifische Berechtigungsfehler stoßen, wechseln Sie zum nativen Installationsprogramm:
1037 1031
1038```bash theme={null}1032```bash theme={null}
1039curl -fsSL https://claude.ai/install.sh | bash1033curl -fsSL https://claude.ai/install.sh | bash
1040```1034```
1041 1035
1042### Native Binärdatei nicht gefunden nach npm-Installation1036### Native Binärdatei nach npm-Installation nicht gefunden
1043 1037
1044Das `@anthropic-ai/claude-code` npm-Paket lädt die native Binärdatei als pro-Plattform optionale Abhängigkeit herunter, z. B. `@anthropic-ai/claude-code-darwin-arm64`. `claude` ist ein Platzhalter-Skript, bis der Postinstall-Schritt des Pakets `@anthropic-ai/claude-code` ausgeführt wird und den Platzhalter durch diese Binärdatei ersetzt. Wenn entweder der Download oder der Postinstall-Schritt übersprungen wird, bleibt der Platzhalter vorhanden, und das Ausführen von `claude` auf macOS und Linux gibt aus:1038Das npm-Paket `@anthropic-ai/claude-code` lädt die native Binärdatei als plattformspezifische optionale Abhängigkeit herunter, etwa `@anthropic-ai/claude-code-darwin-arm64`. `claude` ist ein Platzhalterskript, bis der Postinstall-Schritt des Pakets `@anthropic-ai/claude-code` ausgeführt wird und den Platzhalter durch diese Binärdatei ersetzt. Wenn entweder der Download oder der Postinstall-Schritt übersprungen wird, bleibt der Platzhalter bestehen, und das Ausführen von `claude` unter macOS und Linux gibt Folgendes aus:
1045 1039
1046```text theme={null}1040```text theme={null}
1047Error: claude native binary not installed.1041Error: claude native binary not installed.
1056Or reinstall without --ignore-scripts / --omit=optional.1050Or reinstall without --ignore-scripts / --omit=optional.
1057```1051```
1058 1052
1059Unter Windows ist `bin/claude.exe` dieser gleiche Shell-Skript-Platzhalter statt einer echten ausführbaren Datei, daher melden PowerShell und CMD, dass sie die Datei nicht ausführen können, statt diese Meldung auszugeben.1053Unter Windows ist `bin/claude.exe` derselbe Shell-Skript-Platzhalter und keine echte ausführbare Datei, daher melden PowerShell und CMD, dass sie die Datei nicht ausführen können, statt diese Meldung auszugeben.
1060 1054
1061Überprüfen Sie die folgenden Ursachen:1055Prüfen Sie die folgenden Ursachen:
1062 1056
1063* **npm 12 überspringt den Postinstall-Schritt standardmäßig.** Wenn Sie Claude Code mit npm 12 installieren oder aktualisieren, schließt npm die Installation trotzdem ab, ohne den Schritt auszuführen. Siehe [Eine npm-12-Installation reparieren](#fix-an-npm-12-install).1057* **npm 12 überspringt den Postinstall-Schritt standardmäßig.** Wenn Sie Claude Code mit npm 12 installieren oder aktualisieren, schließt npm die Installation trotzdem ab, ohne den Schritt auszuführen. Siehe [Eine npm-12-Installation reparieren](#fix-an-npm-12-install).
1064* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` von pnpm oder `--ignore-optional` von yarn, und überprüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird, und das erneute Ausführen von `install.cjs` kann keine Binärdatei verknüpfen, die nie heruntergeladen wurde.1058* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` bei pnpm oder `--ignore-optional` bei yarn, und prüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Installieren Sie dann neu. Die native Binärdatei wird nur als optionale Abhängigkeit ausgeliefert, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird, und ein erneutes Ausführen von `install.cjs` kann keine Binärdatei platzieren, die nie heruntergeladen wurde.
1065* **Installationsskripte sind deaktiviert.** `--ignore-scripts` und einige pnpm-Konfigurationen überspringen den Postinstall-Schritt, laden aber immer noch das Plattform-Paket herunter. Führen Sie `node node_modules/@anthropic-ai/claude-code/install.cjs` wie in der Meldung vorgeschlagen aus, oder installieren Sie erneut ohne das Flag. Wenn Postinstall in Ihrer Umgebung überhaupt nicht ausgeführt werden kann, findet `node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` das heruntergeladene Paket und startet es auf Kosten eines zusätzlichen Node-Prozesses bei jedem Start. Wenn der Wrapper stattdessen `Could not find native binary package` ausgibt, wurde das Plattform-Paket nie heruntergeladen, daher beheben Sie zuerst die Ursache der optionalen Abhängigkeiten oben.1059* **Installationsskripte sind deaktiviert.** `--ignore-scripts` und einige pnpm-Konfigurationen überspringen den Postinstall-Schritt, laden das Plattformpaket aber trotzdem herunter. Führen Sie `node node_modules/@anthropic-ai/claude-code/install.cjs` aus, wie die Meldung vorschlägt, oder installieren Sie ohne das Flag neu. Wenn Postinstall in Ihrer Umgebung überhaupt nicht ausgeführt werden kann, findet `node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` das heruntergeladene Paket und startet es, auf Kosten eines zusätzlichen Node-Prozesses bei jedem Start. Wenn der Wrapper stattdessen `Could not find native binary package` ausgibt, wurde das Plattformpaket nie heruntergeladen; beheben Sie also zuerst die oben genannte Ursache mit den optionalen Abhängigkeiten.
1066* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die [Systemanforderungen](https://code.claude.com/docs/de/setup.md#system-requirements). Auf FreeBSD meldet das Installationsprogramm die Plattform als nicht unterstützt. Vor v2.1.205 behandelte es FreeBSD als Linux und lud eine Binärdatei herunter, die nicht ausgeführt werden konnte.1060* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen aus; siehe die [Systemanforderungen](https://code.claude.com/docs/de/setup.md#system-requirements). Unter FreeBSD meldet das Installationsprogramm die Plattform als nicht unterstützt. Vor v2.1.205 behandelte es FreeBSD als Linux und lud eine Binärdatei herunter, die nicht ausgeführt werden konnte.
1067* **Unternehmens-npm-Spiegel fehlen die Plattform-Pakete.** Stellen Sie sicher, dass Ihr Registry alle acht `@anthropic-ai/claude-code-*` Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.1061* **Dem npm-Mirror des Unternehmens fehlen die Plattformpakete.** Stellen Sie sicher, dass Ihre Registry zusätzlich zum Metapaket alle acht `@anthropic-ai/claude-code-*`-Plattformpakete spiegelt.
1068 1062
1069#### Eine npm-12-Installation reparieren1063#### Eine npm-12-Installation reparieren
1070 1064
1071Wenn `claude` nach einer npm-Installation oder einem Update `Error: claude native binary not installed.` ausgibt oder die Shell es unter Windows nicht ausführen kann, führen Sie `npm --version` aus. Eine Version, die mit `12` beginnt, bedeutet, dass npm den Postinstall-Schritt von Claude Code übersprungen hat, sofern Ihre npm-Konfiguration ihn nicht erlaubt; dieser Schritt platziert die Binärdatei. Bei jeder anderen Version prüfen Sie die [anderen Ursachen](#native-binary-not-found-after-npm-install).1065Wenn `claude` nach einer npm-Installation oder einem Update `Error: claude native binary not installed.` ausgibt oder die Shell es unter Windows nicht ausführen kann, führen Sie `npm --version` aus. Eine Version, die mit `12` beginnt, bedeutet, dass npm den Postinstall-Schritt von Claude Code, der die Binärdatei platziert, übersprungen hat, es sei denn, Ihre npm-Konfiguration lässt ihn zu. Bei jeder anderen Version prüfen Sie die [anderen Ursachen](#native-binary-not-found-after-npm-install).
1072 1066
1073Um eine npm-12-Installation zu reparieren, wechseln Sie zum nativen Installationsprogramm oder erlauben Sie den Schritt:1067Um eine npm-12-Installation zu reparieren, wechseln Sie zum nativen Installationsprogramm oder lassen Sie den Schritt zu:
1074 1068
1075* **Zum nativen Installationsprogramm wechseln**: [Installieren Sie mit dem nativen Installationsprogramm](https://code.claude.com/docs/de/setup.md#install-claude-code) und [deinstallieren Sie dann das npm-Paket](https://code.claude.com/docs/de/setup.md#uninstall-with-npm). Updates verwenden dann kein npm mehr, sodass der Fehler nicht zurückkehrt.1069* **Zum nativen Installationsprogramm wechseln**: [Installieren Sie mit dem nativen Installationsprogramm](https://code.claude.com/docs/de/setup.md#install-claude-code) und [deinstallieren Sie dann das npm-Paket](https://code.claude.com/docs/de/setup.md#uninstall-with-npm). Updates verwenden dann kein npm, sodass der Fehler nicht zurückkehrt.
1076* **Bei npm bleiben**: Fügen Sie für eine globale npm-Installation Claude Code zu `allow-scripts` in Ihrer npm-Benutzerkonfiguration hinzu. npm führt dann die Installationsskripte von Claude Code bei jeder späteren Installation und jedem späteren Update aus, ebenso bei Projektinstallationen, deren `package.json` kein `allowScripts` festlegt.1070* **Bei npm bleiben**: Fügen Sie bei einer globalen npm-Installation Claude Code zu `allow-scripts` in Ihrer Benutzer-npm-Konfiguration hinzu. npm führt dann die Installationsskripte von Claude Code bei jeder späteren Installation und jedem Update aus sowie bei Projektinstallationen, deren `package.json` kein `allowScripts` setzt.
1077 1071
1078 Verwenden Sie das native Installationsprogramm für eine lokale Installation in `~/.claude/local`. Verwenden Sie es auch, wenn die Skripte in Ihrer `package.json` `npm install` aufrufen und Sie diese mit pnpm 9, pnpm 10, Yarn 1 oder einem anderen Tool ausführen, das ihnen diese Einstellung übergibt. Unter npm 12.1 und höher können diese Installationen mit `EALLOWSCRIPTS` fehlschlagen, sobald die Einstellung gespeichert ist.1072 Verwenden Sie für eine lokale Installation in `~/.claude/local` das native Installationsprogramm. Verwenden Sie es auch, wenn die Skripte in Ihrer `package.json` `npm install` aufrufen und Sie diese mit pnpm 9, pnpm 10, Yarn 1 oder einem anderen Tool ausführen, das ihnen diese Einstellung übergibt. Unter npm 12.1 und höher können diese Installationen mit `EALLOWSCRIPTS` fehlschlagen, sobald die Einstellung gespeichert ist.
1079 1073
1080 1. Wenn `npm --version` 12.0.x ausgegeben hat, aktualisieren Sie npm auf 12.1 oder höher, z. B. mit `npm install -g npm@latest`. Unter 12.0.x können Projektinstallationen, die ein `npx`-Tool oder ein `npm run`-Skript startet, mit `EALLOWSCRIPTS` fehlschlagen, sobald die Einstellung gespeichert ist.1074 1. Wenn `npm --version` 12.0.x ausgegeben hat, aktualisieren Sie npm auf 12.1 oder höher, zum Beispiel mit `npm install -g npm@latest`. Unter 12.0.x können Projektinstallationen, die ein `npx`-Tool oder ein `npm run`-Skript startet, mit `EALLOWSCRIPTS` fehlschlagen, sobald die Einstellung gespeichert ist.
1081 1075
1082 2. Führen Sie `npm config get allow-scripts` aus und notieren Sie alle aufgeführten Pakete, da der nächste Befehl den gesamten Wert ersetzt. Speichern Sie die Einstellung mit diesen Paketen innerhalb der Anführungszeichen, wie in `"allow-scripts=@anthropic-ai/claude-code,<package>"`:1076 2. Führen Sie `npm config get allow-scripts` aus und notieren Sie alle aufgeführten Pakete, da der nächste Befehl den gesamten Wert ersetzt. Speichern Sie die Einstellung mit diesen Paketen innerhalb der Anführungszeichen, wie in `"allow-scripts=@anthropic-ai/claude-code,<package>"`:
1083 1077
1085 npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user1079 npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user
1086 ```1080 ```
1087 1081
1088 3. Installieren Sie erneut:1082 3. Installieren Sie neu:
1089 1083
1090 ```bash theme={null}1084 ```bash theme={null}
1091 npm install -g @anthropic-ai/claude-code1085 npm install -g @anthropic-ai/claude-code@latest
1092 ```1086 ```
1093 1087
1094 Wenn dieser Schritt oder Schritt 1 mit `EACCES` fehlschlägt, wechseln Sie zum nativen Installationsprogramm, statt den Befehl mit `sudo` erneut auszuführen. Claude Code führt npm ohne `sudo` aus, wenn es sich selbst aktualisiert, daher würden automatische Updates auf die gleiche Weise fehlschlagen.1088 Wenn dieser Befehl oder Schritt 1 mit `EACCES` fehlschlägt, wechseln Sie zum nativen Installationsprogramm, statt den Befehl mit `sudo` erneut auszuführen. Claude Code führt npm ohne `sudo` aus, wenn es sich selbst aktualisiert, sodass automatische Updates auf dieselbe Weise fehlschlagen würden.
1095 1089
1096 4. Wenn `claude --version` keine Versionsnummer ausgibt, prüfen Sie die [anderen Ursachen](#native-binary-not-found-after-npm-install).1090 4. Wenn `claude --version` keine Versionsnummer ausgibt, prüfen Sie die [anderen Ursachen](#native-binary-not-found-after-npm-install).
1097 1091
1098 Zum Rückgängigmachen setzen Sie die Liste erneut ohne `@anthropic-ai/claude-code` oder entfernen die gesamte Liste mit `npm config delete allow-scripts --location=user`. Unter npm 12 tritt der Fehler dann nach Ihrem nächsten Update erneut auf.1092 Zum Rückgängigmachen setzen Sie die Liste erneut ohne `@anthropic-ai/claude-code` oder entfernen die gesamte Liste mit `npm config delete allow-scripts --location=user`. Unter npm 12 tritt der Fehler dann nach Ihrem nächsten Update wieder auf.
1099 1093
1100### npm `ENOTEMPTY` Fehler während Update oder Neuinstallation1094### npm-Fehler `ENOTEMPTY` beim Update oder bei der Neuinstallation
1101 1095
1102Wenn Sie `npm install -g @anthropic-ai/claude-code` über eine bestehende Installation ausführen, kann npm beim Verschieben des alten Paketverzeichnisses fehlschlagen:1096Wenn Sie `npm install -g @anthropic-ai/claude-code@latest` über eine bestehende Installation ausführen, kann npm beim Verschieben des alten Paketverzeichnisses fehlschlagen:
1103 1097
1104```text theme={null}1098```text theme={null}
1105npm error code ENOTEMPTY1099npm error code ENOTEMPTY
1110npm error ENOTEMPTY: directory not empty, rename '...'1104npm error ENOTEMPTY: directory not empty, rename '...'
1111```1105```
1112 1106
1113Die `npm error path` Zeile nennt das Verzeichnis, das npm nicht verschieben konnte. Löschen Sie dieses Verzeichnis und alle verbleibenden `.claude-code-*` Verzeichnisse daneben, die frühere unterbrochene Läufe hinterlassen können. Die folgenden Befehle finden Ihr globales Paketverzeichnis mit `npm root -g`; wenn das Verzeichnis, das die `npm error path` Zeile nennt, nicht unter dem Verzeichnis liegt, das `npm root -g` ausgibt, z. B. weil Sie Node-Versionen mit nvm gewechselt haben, löschen Sie stattdessen die Verzeichnisse, die der Fehler nennt:1107Die Zeile `npm error path` nennt das Verzeichnis, das npm nicht verschieben konnte. Löschen Sie dieses Verzeichnis sowie alle übrig gebliebenen `.claude-code-*`-Verzeichnisse daneben, die frühere unterbrochene Durchläufe hinterlassen können. Die folgenden Befehle ermitteln Ihr globales Paketverzeichnis mit `npm root -g`; wenn das Verzeichnis, das die Zeile `npm error path` nennt, nicht unter dem von `npm root -g` ausgegebenen Verzeichnis liegt, zum Beispiel weil Sie mit nvm die Node-Version gewechselt haben, löschen Sie stattdessen die Verzeichnisse, die der Fehler nennt:
1114 1108
1115> [tab] macOS/Linux1109> [tab] macOS/Linux
1116>1110>
1118> rm -rf "$(npm root -g)/@anthropic-ai/claude-code"1112> rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
1119> ```1113> ```
1120>1114>
1121> Löschen Sie dann alle verbleibenden Temp-Verzeichnisse. Wenn zsh `no matches found` ausgibt, gab es keine zu löschenden:1115> Entfernen Sie dann alle übrig gebliebenen temporären Verzeichnisse. Wenn Zsh `no matches found` ausgibt, gab es keine zu entfernen:
1122>1116>
1123> ```bash theme={null}1117> ```bash theme={null}
1124> rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*1118> rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*
1130> Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"1124> Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"
1131> ```1125> ```
1132 1126
1133Installieren Sie dann erneut. Unter npm 12 folgen Sie [Eine npm-12-Installation reparieren](#fix-an-npm-12-install). Andernfalls führen Sie Folgendes aus:1127Installieren Sie dann neu. Folgen Sie unter npm 12 [Eine npm-12-Installation reparieren](#fix-an-npm-12-install). Führen Sie andernfalls Folgendes aus:
1134 1128
1135```bash theme={null}1129```bash theme={null}
1136npm install -g @anthropic-ai/claude-code1130npm install -g @anthropic-ai/claude-code@latest
1137```1131```
1138 1132
1139Bestätigen Sie mit `claude --version`, das eine Versionsnummer wie `2.1.211 (Claude Code)` ausgibt.1133Bestätigen Sie mit `claude --version`, das eine Versionsnummer wie `2.1.211 (Claude Code)` ausgibt.
