Source: https://aiprimetech.io/de/claude-code/errors/ [Startseite](/de/) › [Claude Code](/de/claude-code/) › Fehler [Überblick](/de/claude-code/)[Installation](/de/claude-code/install/)[CLI-Referenz](/de/claude-code/cli/)[Preise und Limits](/de/claude-code/pricing/)[Agent SDK](/de/claude-code/sdk/)[Skills und Plugins](/de/claude-code/skills/)[GitHub](/de/claude-code/github/)[Web, Desktop und IDE](/de/claude-code/web-and-desktop/)[Modelle](/de/claude-code/models/)[Fehler](/de/claude-code/errors/)[Open Source?](/de/claude-code/open-source/)[Tutorial](/de/claude-code/tutorial/)[Für Studierende](/de/claude-code/for-students/)[QA-Automatisierung](/de/claude-code/qa-automation/)[Vergleich mit Cursor](/de/claude-code/vs-cursor/)[Vergleich mit Codex und OpenCode](/de/claude-code/vs-codex/)[Subagenten](/de/claude-code/subagents/)[Hooks](/de/claude-code/hooks/)[MCP](/de/claude-code/mcp/)[Ökosystem](/de/claude-code/ecosystem/)[VS Code](/de/claude-code/vscode/)[OpenRouter](/de/claude-code/openrouter/)[Anfragelimits](/de/claude-code/rate-limits/)[Chinesischer Leitfaden](/claude-code/zh/) Zuletzt aktualisiert: 11. Oktober 2026 # Fehler in Claude Code und wie Sie sie beheben Claude Code zeigt API-Fehler mit dem Status HTTP in der Meldung an, sodass die Nummer bereits einen Großteil erklärt. Hier erfahren Sie, was jeder Fehler im Kontext einer Agentensitzung bedeutet und welche Lösung tatsächlich hilft. ## TLDR - 500 / 529 — die Modellseite fällt aus oder ist ausgelastet; mit zunehmenden Wartezeiten erneut versuchen, das Modell wechseln; an Ihrer Einrichtung ist nichts zu beheben. - 400 — meist ist der Kontext für das Modell zu lang; /compact oder /clear verwenden oder zu einer Variante mit 1M-Kontext wechseln. - 429 — Ratenlimit; die parallelen Streams von Claude Code erreichen zuerst das Limit für gleichzeitige Anfragen. - 401 — falscher Schlüssel für den Endpunkt; ein Konsolenschlüssel wird mit einer Gateway-URL verwendet oder umgekehrt. - Nutzungslimit / Wochenlimit — ein Zeitfenster des Abonnements, kein API-Fehler; es wird automatisch zurückgesetzt, und beim Zugriff über die API gibt es kein solches Zeitfenster. ## Ausführliche Anleitungen zu jedem Fehler - [API-Fehler: 500 (Interner Serverfehler)](/de/claude-code/errors/api-error-500/) — Ausfälle, modellspezifische Fehler, Kontextkomprimierung bei 0 %. - [Überlastet / API-Fehler 529](/de/claude-code/errors/overloaded-529/) — Kapazität, Wiederholungsversuche, Anfragespitzen durch Subagenten. - [API-Fehler 400](/de/claude-code/errors/api-error-400/) — zu langer Prompt, gleichzeitige Tool-Nutzung und andere abgelehnte Anfragen. - [OAuth-Fehler](/de/claude-code/errors/oauth-error/) — Zeitüberschreitung von 15000ms, Statuscode 500 bei der Anmeldung. - [Prozess mit Code 1 beendet](/de/claude-code/errors/process-exited-code-1/) — Abstürze der VS Code-Erweiterung und der Desktop-App. - [Ratenlimit erreicht / 429](/de/claude-code/rate-limits/) — die drei Limits und wie Sie sie erhöhen. - [Prompt zu lang / Kontextlimit erreicht](/de/claude-code/errors/prompt-too-long/) — was das Kontextfenster füllt, Fehlalarme, fehlgeschlagene Kontextkomprimierung, Längenlimits von claude.ai. - [Nutzungslimit erreicht](/de/claude-code/errors/usage-limit-reached/) — Sitzungs-, Wochen- und Opus-Zeitfenster, „festgelegte API-Nutzungslimits“, „Guthaben zu niedrig“. - [401 / 403-Authentifizierung](/de/claude-code/errors/auth-401-403/) — ungültige Zugangsdaten, ungültiger API-Schlüssel, „Nicht angemeldet“, host_not_allowed. - [Verbindungsfehler](/de/claude-code/errors/connection-lost/) — ECONNRESET, „Warten auf API-Antwort“, Zertifikate, Proxys, Variablen für Wiederholungsversuche. - [Hängt, steckt fest, reagiert nicht](/de/claude-code/errors/claude-code-hangs/) — wo es hängt, Tasten zum Abbrechen, bekannte Fehler, die zum Hängen führen, Arbeitsspeicher. - [claude.ai funktioniert nicht](/de/claude-code/errors/claude-ai-not-working/) — „Etwas ist schiefgelaufen“, Kapazitätsengpässe, 5-Stunden-Limit, Anmeldefehler. ## API-Fehler 500 (und 529 überlastet) Ein 500 ist ein Upstream-Fehler; 529 ist Anthropics ausdrücklicher Code für „Modell ausgelastet“. Keiner der beiden wird durch Ihren Prompt verursacht. Claude Code versucht es einige Male automatisch erneut; wenn es aufgibt, warten Sie eine Minute und setzen Sie die Sitzung fort mit claude -c. Ein Wechsel der Modellstufe mit /model hilft oft sofort, da die Kapazität pro Modell gilt. Auf diesem Gateway wird bei einem ausgelasteten Upstream-Konto automatisch auf ein anderes umgeschaltet. Deshalb treten 529-Fehler hier seltener auf als bei einem einzelnen Konto. ## API-Fehler 400 — ungültige Anfrage / Kontext zu lang In Claude Code bedeutet ein 400 fast immer, dass die Unterhaltung zusammen mit den gelesenen Dateien nicht mehr in das Kontextfenster des Modells passt. /compact fasst den Verlauf zusammen; /clear beginnt von vorn; oder wechseln Sie zu einer (1M) Variante des Modells. Andere 400-Fehler: ein nicht unterstützter Parameter nach einem Upgrade (führen Sie claude updateaus) oder ein Bild beziehungsweise eine Datei, die das Modell nicht verarbeiten kann. ## API-Fehler 429 — Ratenlimit / Rate überschritten Es gelten drei Limits: Anfragen pro Minute, Tokens pro Minute und gleichzeitige Anfragen. Agentensitzungen erreichen zuerst das Limit für gleichzeitige Anfragen — jeder Subagent ist eine parallele Streaming-Anfrage, die bis zu ihrem Abschluss einen Platz belegt. Reduzieren Sie die Parallelität, warten Sie die retry-after-Frist ab und beantragen Sie für längere Arbeitsphasen ein höheres Limit für gleichzeitige Anfragen für Ihr Gateway-Konto. ## OAuth-Fehler: Zeitüberschreitung von 15000ms Der /login-Ablauf konnte Anthropics Authentifizierungsdienst nicht innerhalb von 15 Sekunden erreichen. Das ist ein Netzwerkproblem, kein Kontoproblem: ein Unternehmensproxy, ein VPN, das den Callback verwirft, oder eine Region, in der der Authentifizierungsendpunkt langsam ist. Versuchen Sie es einmal erneut; falls das Problem bestehen bleibt, setzen Sie HTTPS_PROXY für Ihr Netzwerk oder umgehen Sie OAuth vollständig mit einem API-Schlüssel — mit ANTHROPIC_API_KEY (und ANTHROPIC_BASE_URL für ein Gateway) öffnet Claude Code den Anmeldeablauf überhaupt nicht. ## OAuth-Fehler: Anfrage mit Statuscode 500 fehlgeschlagen Der Authentifizierungsdienst hat während der Anmeldung oder Token-Erneuerung mit einem Serverfehler geantwortet. Die Ursache liegt nicht auf Ihrer Seite; warten Sie einige Minuten und führen Sie /login erneut aus. Wenn Sie sofort weiterarbeiten müssen, umgeht der oben beschriebene Zugriff per API-Schlüssel OAuth, und claude setup-token erzeugt auf einem Rechner, auf dem die Anmeldung funktioniert, ein langlebiges Token, das Sie auf den Rechner übertragen können, auf dem sie nicht funktioniert. ## Fehler: Claude Code-Prozess mit Code 1 beendet Damit meldet die IDE-Erweiterung oder Desktop-App, dass die von ihr gestartete CLI beim Start abgestürzt ist — der eigentliche Fehler liegt eine Ebene tiefer. Öffnen Sie ein Terminal und führen Sie claude direkt aus: Sie sehen dann die tatsächliche Meldung. Fast immer handelt es sich um eine Node.js-Version unter 18, ein defektes PATH nach einer npm-Installation, eine beschädigte native Installation oder eine settings.json mit ungültigem JSON (ein überflüssiges Komma in einem Hooks-Block ist ein Klassiker). claude doctor prüft die ersten drei Ursachen; ein JSON-Linter erkennt die vierte. Eine Neuinstallation mit dem nativen Installer behebt die meisten übrigen Probleme. ## 401 / Authentifizierungsfehler invalid x-api-key oder authentication_error bedeutet, dass der Schlüssel nicht zum Endpunkt gehört. Wenn ANTHROPIC_BASE_URL auf das Gateway verweist, muss der Schlüssel ein Gateway-Schlüssel sein; ein Anthropic-Konsolenschlüssel wird abgelehnt, und umgekehrt gilt dasselbe. /status zeigt an, welcher Endpunkt und welcher Schlüssel aktiv sind. Wenn Sie /login und einen API-Schlüssel gleichzeitig verwenden, hat der Schlüssel Vorrang. Schleifen bei der Token-Erneuerung, Not logged in nach einer erfolgreichen Anmeldung und 403-Fehler von Proxys werden behandelt auf der [401 / 403-Seite](/de/claude-code/errors/auth-401-403/). ## „Kein verfügbarer Upstream“ Kein API-Fehler: Der Load Balancer vor einem Dienst meldet, dass kein Backend verfügbar ist. Beim offiziellen Endpunkt bedeutet dies einen Ausfall; bei einem Gateway bedeutet es, dass der gesamte Upstream-Pool ausgefallen ist oder gedrosselt wird. Warten Sie und versuchen Sie es erneut; ändern Sie Ihre Konfiguration nicht. ## Claude Code funktioniert überhaupt nicht - Startet und beendet sich dann ohne Meldung → führen Sie claude /doctoraus; meist liegt es an der Node-Version oder an PATH. - Hängt beim Start oder während einer Sitzung → siehe [Hänger und festgefahrene Sitzungen](/de/claude-code/errors/claude-code-hangs/) und [Verbindungsfehler](/de/claude-code/errors/connection-lost/). - command not found → siehe Installationsanleitung. - Tools schlagen mit Berechtigungsfehlern fehl → /permissions, oder --allowedTools in Skripten. ## 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_key ``` [Konto mit dem Code FIXIT erstellen](/register?promo=FIXIT) ## Häufig gestellte Fragen Warum gibt Claude Code immer wieder den API-Fehler 500 zurück? Das Modell-Backend fällt aus oder ist überlastet (529 ist die ausdrückliche Variante). Versuchen Sie es nach einer Pause erneut, wechseln Sie die Modellstufe mit /model oder setzen Sie die Sitzung mit claude -c fort. Die Ursache liegt nicht in Ihrer Konfiguration.Wie behebe ich den Claude Code-Fehler 400 wegen der Kontextlänge? Führen Sie /compact aus, um die Sitzung zusammenzufassen, /clear, um sie zurückzusetzen, oder wechseln Sie zu einer Modellvariante mit einem Kontextfenster von 1M.Warum meldet Claude Code einen ungültigen API-Schlüssel? Der Schlüssel passt nicht zum Endpunkt in ANTHROPIC_BASE_URL. Eine Gateway-URL benötigt einen Gateway-Schlüssel; eine Anthropic-URL benötigt einen Konsolenschlüssel. ## 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](/register?promo=FIXIT) [Unbegrenzte Tarife ansehen](/de/plans/) AI 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. ## Weitere Leitfäden zu Claude Code [Claude Code: der vollständige Leitfaden](/de/claude-code/)[So installieren Sie Claude Code](/de/claude-code/install/)[Claude Code CLI-Dokumentation: Befehle und Flags](/de/claude-code/cli/)[Preise und Limits von Claude Code erklärt](/de/claude-code/pricing/)[Das Claude Code SDK, jetzt Claude Agent SDK](/de/claude-code/sdk/)[Skills und Plugins für Claude Code](/de/claude-code/skills/)[Claude Code in GitHub: die App, die Action und @claude](/de/claude-code/github/)[Hat Claude Code eine Weboberfläche? Web, Desktop und IDE erklärt](/de/claude-code/web-and-desktop/)[Welches Modell Claude Code verwendet und wie Sie es ändern](/de/claude-code/models/)[Ist Claude Code Open Source?](/de/claude-code/open-source/)[Claude Code Tutorial: Ihre erste echte Sitzung](/de/claude-code/tutorial/)[Claude für Studierende: Claude Code, die API und was Bildungsangebote Ihnen tatsächlich bieten](/de/claude-code/for-students/)[So nutzen Sie Claude Code für die QA-Automatisierung](/de/claude-code/qa-automation/)[Claude Code im Vergleich mit Cursor: welches Werkzeug wann — und wie Sie beide nutzen](/de/claude-code/vs-cursor/)[Claude Code vs. Codex vs. OpenCode: Terminal-Agenten im Vergleich](/de/claude-code/vs-codex/)[Claude Code-Subagenten: Funktionsweise, Definition und Agententeams](/de/claude-code/subagents/)[Claude Code-Hooks: deterministische Kontrolle über die Aktionen des Agenten](/de/claude-code/hooks/)[Claude Code MCP: Server verbinden, Geltungsbereiche, Remote-MCP und Praxisbeispiele](/de/claude-code/mcp/)[Das Claude Code-Ökosystem: Router, Frameworks, Plugins und die Listen, die sie erfassen](/de/claude-code/ecosystem/)[Claude Code in VS Code: die Erweiterung, die Nutzung im Terminal und die Fehler](/de/claude-code/vscode/)[OpenRouter in Claude Code verwenden (und wann Sie darauf verzichten sollten)](/de/claude-code/openrouter/)[Claude-Fehler zum Ratenlimit: Was „API error: rate limit reached“ bedeutet und wie Sie ihn beheben](/de/claude-code/rate-limits/)[Claude Code verwenden: von der Installation bis zur täglichen Nutzung](/claude-code/zh/)