Schritt 1: Den tatsächlichen Fehler ermitteln
claude --version # is the CLI there at all?
claude # start it directly: the real error prints here
claude doctor # install health checkWenn es im Terminal funktioniert und nur die Erweiterung oder App scheitert, liegt das Problem in der Umgebung, aus der der Wrapper startet (PATH, Node-Version, Proxy-Variablen) — nicht in Claude Code selbst. Wenn es auch im Terminal scheitert, suchen Sie nach der dort ausgegebenen Meldung.
Bekannte Ursachen (aus dem Issue-Tracker)
- Fortsetzen einer Hintergrundsitzung in VS Code. Das Öffnen einer Sitzung, die gestartet wurde mit
claude --bglöst genau diesen Fehler aus — gemeldet unter macOS, Windows und Linux (#77162). Beenden Sie zuerst den Hintergrundagenten oder öffnen Sie eine neue Sitzung. - Windows: Verwaister Prozess nach einem Absturz. Die App lässt sich nicht erneut starten, weil ein alter Prozess weiterhin eine Sperre hält (#42776, #53247). Beenden Sie verbliebene
claudeProzesse im Task-Manager; die dort gemeldete zuverlässige Lösung ist ein vollständiger Windows-Neustart. - Desktop-App auf Apple Silicon scheitert bei jedem Sitzungsstart, während die CLI funktioniert (#59866, ein Duplikat eines bekannten Problems) — aktualisieren Sie die App; verwenden Sie in der Zwischenzeit die CLI in einem Terminal.
- Node.js unter 18 oder ein beschädigtes PATH nach einer npm-Installation — der Wrapper kann die CLI nicht starten.
node -v; wechseln Sie zum nativen Installationsprogramm, um die Node-Abhängigkeit zu entfernen. - Ungültige `~/.claude/settings.json`. Ein überflüssiges Komma in einem Hooks- oder Berechtigungsblock führt dazu, dass die CLI sofort beendet wird. Validieren Sie die JSON.
- Unpassende Shell unter Windows — ein PowerShell-Tool scheitert beim Aufruf aus Git Bash mit einem bestimmten Modell (#87980); versuchen Sie es mit der anderen Shell.
Wenn nichts davon zutrifft
- Aktualisieren Sie alles:
claude update, und aktualisieren Sie die VS Code-Erweiterung oder die Desktop-App. - Installieren Sie mit dem nativen Installationsprogramm neu (
curl -fsSL https://claude.ai/install.sh | bash, oder mit den PowerShell- / CMD-Einzeilern in der Installationsanleitung). - Starten Sie VS Code aus einem Terminal, damit es dieselbe Umgebung wie die funktionierende CLI übernimmt.
- Erstellen Sie ein neues Issue mit der Ausgabe von
claude doctor— im Tracker werden Abstürze schnell geprüft und eingeordnet.
Verwandte Themen
Wenn Claude Code startet, dann aber mit einem API-Fehler scheitert, ist das ein anderes Problem: siehe API-Fehler 500, überlastet / 529, API-Fehler 400 oder OAuth-Fehler. Speziell zur Erweiterung siehe Claude Code in VS Code.
Müde vom ständigen Kampf mit diesem Problem?
Nutzen Sie Claude Code stattdessen über das Gateway von AI Prime Tech: dieselben Claude-Modelle auf den eigenen Upstream-Konten des Gateways, zwei Umgebungsvariablen für den Wechsel, und neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code FIXIT — ohne Kreditkarte.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyHäufig gestellte Fragen
Was bedeutet „Claude Code-Prozess mit Code 1 beendet“?
Die VS Code-Erweiterung oder die Desktop-App hat die Claude Code CLI gestartet, und diese wurde mit einem Fehler beendet. Führen Sie claude in einem Terminal aus, um die tatsächliche Fehlermeldung zu sehen.
Wie behebe ich „Claude Code mit Code 1 beendet“ unter Windows?
Beenden Sie verbliebene claude-Prozesse (oder starten Sie Windows neu, wenn sich die App nicht erneut starten lässt), prüfen Sie node -v und PATH, validieren Sie ~/.claude/settings.json und installieren Sie bei Bedarf mit dem nativen Installationsprogramm neu.
Warum funktioniert Claude Code im Terminal, aber nicht in VS Code?
VS Code wurde mit einer anderen Umgebung gestartet (PATH, Node, Proxy-Variablen). Starten Sie VS Code aus dem Terminal, in dem claude funktioniert, oder korrigieren Sie die Variablen in Ihrem Shell-Profil.
Claude Code über das Gateway nutzen
Dieselben Modelle, zwei Umgebungsvariablen, Guthaben zum 7.69231-Fachen des Nennwerts — oder ein unbegrenzter Pauschaltarif. Neue Konten: $5 kostenloses API-Guthaben mit dem Code FIXIT.
API-Schlüssel erhalten Unbegrenzte Tarife ansehenAI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.