Fehler in Claude Code und wie Sie sie beheben

Ausführliche Anleitungen zu jedem Fehler

• API-Fehler: 500 (Interner Serverfehler) — Ausfälle, modellspezifische Fehler, Kontextkomprimierung bei 0 %.
• Überlastet / API-Fehler 529 — Kapazität, Wiederholungsversuche, Anfragespitzen durch Subagenten.
• API-Fehler 400 — zu langer Prompt, gleichzeitige Tool-Nutzung und andere abgelehnte Anfragen.
• OAuth-Fehler — Zeitüberschreitung von 15000ms, Statuscode 500 bei der Anmeldung.
• Prozess mit Code 1 beendet — Abstürze der VS Code-Erweiterung und der Desktop-App.
• Ratenlimit erreicht / 429 — die drei Limits und wie Sie sie erhöhen.
• Prompt zu lang / Kontextlimit erreicht — was das Kontextfenster füllt, Fehlalarme, fehlgeschlagene Kontextkomprimierung, Längenlimits von claude.ai.
• Nutzungslimit erreicht — Sitzungs-, Wochen- und Opus-Zeitfenster, „festgelegte API-Nutzungslimits“, „Guthaben zu niedrig“.
• 401 / 403-Authentifizierung — ungültige Zugangsdaten, ungültiger API-Schlüssel, „Nicht angemeldet“, host_not_allowed.
• Verbindungsfehler — ECONNRESET, „Warten auf API-Antwort“, Zertifikate, Proxys, Variablen für Wiederholungsversuche.
• Hängt, steckt fest, reagiert nicht — wo es hängt, Tasten zum Abbrechen, bekannte Fehler, die zum Hängen führen, Arbeitsspeicher.
• claude.ai funktioniert nicht — „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.

„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 und Verbindungsfehler.
• command not found → siehe Installationsanleitung.
• Tools schlagen mit Berechtigungsfehlern fehl → /permissions, oder --allowedTools in Skripten.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Häufig gestellte Fragen

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.