Fehlerreferenz

Schlagen Sie Claude Code-Laufzeitfehlermeldungen nach und erfahren Sie, was jede bedeutet und wie Sie sie beheben.

Diese Seite listet Laufzeitfehler auf, die Claude Code anzeigt, und wie Sie sich von jedem erholen können, sowie was Sie überprüfen sollten, wenn Antworten ohne Fehler seltsam wirken. Für Installationsfehler wie command not found oder TLS-Fehler während der Einrichtung siehe Fehlerbehebung bei Installation und Anmeldung.

Diese Fehler und Wiederherstellungsbefehle gelten für die CLI, die Desktop-App und Claude Code im Web, da alle drei die gleiche Claude Code CLI verwenden. Für oberflächenspezifische Probleme siehe den Abschnitt zur Fehlerbehebung auf der Seite dieser Oberfläche.

Finden Sie Ihren Fehler

Ordnen Sie die Meldung, die Sie in Ihrem Terminal sehen, einem Abschnitt unten zu.

Automatische Wiederholungen

Claude Code wiederholt vorübergehende Fehler, bevor ein Fehler angezeigt wird. Serverfehler, Überlastungsantworten, Anfrage-Timeouts, vorübergehende 429-Drosselungen und unterbrochene Verbindungen werden alle bis zu 10-mal mit exponentiellem Backoff wiederholt. Während der Wiederholung zeigt der Spinner einen Retrying in Ns · attempt x/y Countdown an.

Wenn Sie einen der Fehler auf dieser Seite sehen, wurden diese Wiederholungen bereits erschöpft. Sie können das Verhalten mit zwei Umgebungsvariablen anpassen:

Serverfehler

Diese Fehler stammen von der Anthropic-Infrastruktur und nicht von Ihrem Konto oder Ihrer Anfrage.

API Error: 500 Internal server error

Claude Code zeigt den rohen API-Antwortkörper für jeden 5xx-Status an. Das folgende Beispiel zeigt eine 500-Antwort:

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com

Dies zeigt einen unerwarteten Fehler in der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.

Was zu tun ist:

• Überprüfen Sie status.claude.com auf aktive Vorfälle
• Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht ist noch in der Konversation, daher können Sie für einen langen Prompt try again eingeben, anstatt das Ganze erneut einzufügen.
• Wenn der Fehler ohne veröffentlichten Vorfall weiterhin auftritt, führen Sie /feedback aus, damit Anthropic mit Ihren Anfrageinformationen untersuchen kann. Siehe Fehler melden, wenn /feedback in Ihrer Umgebung nicht verfügbar ist.

API Error: Repeated 529 Overloaded errors

Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat bereits mehrmals versucht, bevor diese Meldung angezeigt wird:

API Error: Repeated 529 Overloaded errors · check status.claude.com

Ein 529 ist nicht Ihr Nutzungslimit und wird nicht gegen Ihr Kontingent angerechnet.

Was zu tun ist:

• Überprüfen Sie status.claude.com auf Kapazitätsmitteilungen
• Versuchen Sie es in ein paar Minuten erneut
• Führen Sie /model aus und wechseln Sie zu einem anderen Modell, um weiterarbeiten zu können, da die Kapazität pro Modell verfolgt wird. Claude Code fordert Sie dazu auf, wenn ein Modell unter besonders hoher Last ist, zum Beispiel Opus is experiencing high load, please use /model to switch to Sonnet.

Request timed out

Die API hat nicht vor der Verbindungsfrist geantwortet.

Request timed out

Dies kann während Zeiten hoher Last oder bei der Generierung einer sehr großen Antwort auftreten. Das Standard-Anfrage-Timeout beträgt 10 Minuten.

Was zu tun ist:

• Wiederholen Sie die Anfrage
• Für langfristige Aufgaben teilen Sie die Arbeit in kleinere Prompts auf
• Wenn ein langsames Netzwerk oder Proxy die Ursache ist, erhöhen Sie API_TIMEOUT_MS wie in Automatische Wiederholungen beschrieben
• Wenn Timeouts häufig sind und Ihr Netzwerk ansonsten gesund ist, siehe Netzwerk- und Verbindungsfehler unten

Auto mode cannot determine the safety of an action

Das Modell, das auto mode zur Klassifizierung von Aktionen verwendet, konnte keine Entscheidung treffen, daher hat auto mode die Aktion nicht automatisch genehmigt. Die Meldung, die Sie sehen, hängt davon ab, warum der Klassifizierer fehlgeschlagen ist.

Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifizierer, daher funktionieren sie in all diesen Fällen weiterhin.

Wenn das Klassifizierer-Modell überlastet ist:

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

Was zu tun ist:

• Wiederholen Sie nach ein paar Sekunden; Claude sieht die gleiche Meldung und wiederholt normalerweise automatisch
• Wenn Wiederholungen weiterhin fehlschlagen, fahren Sie mit schreibgeschützten Aufgaben fort und kehren Sie später zur blockierten Aktion zurück
• Dies ist vorübergehend und nicht mit der auto mode-Berechtigung verbunden; Sie müssen die Einstellungen nicht ändern

Wenn der Klassifizierer eine nicht analysierbare Antwort zurückgegeben hat:

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

Was zu tun ist:

• Wiederholen Sie die Aktion; dies ist normalerweise beim nächsten Versuch erfolgreich
• Führen Sie claude --debug aus und wiederholen Sie die Aktion, um die zugrunde liegende Klassifizierer-Antwort im Debug-Protokoll zu sehen

Wenn die Konversation größer als das Kontextfenster des Klassifizierers geworden ist:

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

In einer interaktiven Sitzung fällt auto mode auf eine normale Genehmigungsaufforderung für diese Aktion zurück, damit Sie sie manuell genehmigen oder ablehnen können. Im nicht-interaktiven Modus wird die Ausführung abgebrochen, da das Transkript nur wächst und Wiederholungen nicht erfolgreich sein können.

Was zu tun ist:

• Genehmigen oder lehnen Sie die Aktion in der angezeigten Aufforderung ab
• Führen Sie /compact aus, um die Konversationsgröße zu reduzieren, damit nachfolgende Aktionen wieder in das Klassifizierer-Fenster passen

Nutzungslimits

Diese Fehler bedeuten, dass ein Kontingent, das an Ihr Konto oder Ihren Plan gebunden ist, erreicht wurde. Sie unterscheiden sich von Serverfehlern, die alle betreffen.

You've hit your session limit

Abonnementpläne enthalten ein rollendes Nutzungskontingent. Wenn es aufgebraucht ist, sehen Sie eine dieser Meldungen:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Claude Code blockiert weitere Anfragen bis zur in der Meldung angezeigten Rückstellungszeit.

Was zu tun ist:

• Warten Sie auf die in der Fehlermeldung angezeigte Rückstellungszeit
• Führen Sie /usage aus, um Ihre Planlimits und deren Rückstellungszeiten anzuzeigen
• Führen Sie /usage-credits aus, um zusätzliche Nutzung auf Pro und Max zu kaufen, oder um sie von Ihrem Administrator auf Team und Enterprise anzufordern. Siehe usage credits for paid plans für die Abrechnung.
• Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe claude.com/pricing

Um Ihr verbleibendes Kontingent zu überwachen, bevor Sie das Limit erreichen, fügen Sie die rate_limits-Felder zu einer benutzerdefinierten Statuszeile hinzu, oder klicken Sie in der Desktop-App auf den Nutzungsring neben dem Modellwähler.

Server is temporarily limiting requests

Die API hat eine kurzfristige Drosselung angewendet, die nicht mit Ihrem Plankontingent zusammenhängt.

API Error: Server is temporarily limiting requests (not your usage limit)

Dies wird automatisch wiederholt, bevor es angezeigt wird.

Was zu tun ist:

• Warten Sie kurz und versuchen Sie es erneut
• Überprüfen Sie status.claude.com, wenn es weiterhin auftritt

Request rejected (429)

Sie haben das für Ihren API-Schlüssel, Ihr Amazon Bedrock-Projekt oder Ihr Google Vertex AI-Projekt konfigurierte Ratenlimit erreicht.

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

Der nachfolgende Satz benennt, wo die Dienststabilität überprüft werden kann, und variiert je nach Anbieter. Bedrock- und Vertex AI-Konfigurationen benennen stattdessen die Dienststatus-Seite dieses Anbieters anstelle der Anthropic-Statusseite.

Was zu tun ist:

• Führen Sie /status aus und bestätigen Sie, dass die aktive Anmeldeinformation die ist, die Sie erwarten. Ein verwaister ANTHROPIC_API_KEY in Ihrer Umgebung kann Anfragen durch einen Low-Tier-Schlüssel statt durch Ihr Abonnement leiten.
• Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich
• Für Anthropic API-Schlüssel siehe die Ratenlimit-Referenz für die Funktionsweise von Tiers und wie Sie Pro-Workspace-Limits setzen
• Reduzieren Sie die Parallelität: senken Sie CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, vermeiden Sie die Ausführung vieler paralleler Subagenten, oder wechseln Sie mit /model zu einem kleineren Modell für Hochvolumen-Skriptläufe

Credit balance is too low

Ihre Console-Organisation hat keine vorausbezahlten Guthaben mehr.

Credit balance is too low

Was zu tun ist:

• Fügen Sie Guthaben unter platform.claude.com/settings/billing hinzu, und erwägen Sie, dort Auto-Reload zu aktivieren, damit das Guthaben aufgefüllt wird, bevor es null erreicht
• Wechseln Sie mit /login zur Abonnement-Authentifizierung, wenn Sie einen Pro-, Max-, Team- oder Enterprise-Plan haben
• Legen Sie Pro-Workspace-Ausgabenlimits in der Console fest, um zu verhindern, dass ein einzelnes Projekt das Org-Guthaben aufbraucht. Siehe Manage costs effectively.

Authentifizierungsfehler

Diese Fehler bedeuten, dass Claude Code nicht nachweisen kann, wer Sie für die API sind. Führen Sie /status jederzeit aus, um zu sehen, welche Anmeldeinformation derzeit aktiv ist.

Not logged in

Für diese Sitzung ist keine gültige Anmeldeinformation verfügbar.

Not logged in · Please run /login

Was zu tun ist:

• Führen Sie /login aus, um sich mit Ihrem Claude-Abonnement oder Console-Konto zu authentifizieren
• Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, bestätigen Sie, dass ANTHROPIC_API_KEY in der Shell gesetzt und exportiert ist, in der Sie claude gestartet haben
• Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein apiKeyHelper-Skript, das beim Start einen Schlüssel abruft
• Siehe Authentifizierungspriorität, um zu verstehen, welche Anmeldeinformation gewinnt, wenn mehrere vorhanden sind

Wenn Sie wiederholt aufgefordert werden, sich anzumelden, siehe Not logged in or token expired für Systemuhr- und macOS Keychain-Fixes.

Invalid API key

Die Umgebungsvariable ANTHROPIC_API_KEY oder das apiKeyHelper-Skript hat einen Schlüssel zurückgegeben, den die API abgelehnt hat.

Invalid API key · Fix external API key

Was zu tun ist:

• Überprüfen Sie auf Tippfehler und bestätigen Sie, dass der Schlüssel nicht in der Console widerrufen wurde
• Führen Sie env | grep ANTHROPIC in der gleichen Shell aus. Tools wie direnv, dotenv Shell-Plugins und IDE-Terminals können einen veralteten Schlüssel aus einer .env-Datei in Ihrem Projekt laden, ohne dass Sie ihn explizit setzen
• Heben Sie ANTHROPIC_API_KEY auf und führen Sie /login aus, um stattdessen Abonnement-Authentifizierung zu verwenden
• Wenn der Schlüssel von einem apiKeyHelper-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt
• Führen Sie /status aus, um zu bestätigen, welche Anmeldeinformationsquelle Claude Code tatsächlich verwendet

This organization has been disabled

Ein veralteter ANTHROPIC_API_KEY von einer deaktivierten Console-Organisation überschreibt Ihre Abonnement-Anmeldung.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.

Umgebungsvariablen haben Vorrang vor /login, daher wird ein Schlüssel, der in Ihrem Shell-Profil exportiert oder aus einer .env-Datei geladen wird, verwendet, auch wenn Sie ein funktionierendes Pro- oder Max-Abonnement haben. Im nicht-interaktiven Modus (-p) wird der Schlüssel immer verwendet, wenn er vorhanden ist.

Was zu tun ist:

• Heben Sie ANTHROPIC_API_KEY in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil, dann starten Sie claude neu
• Führen Sie danach /status aus, um zu bestätigen, dass die aktive Anmeldeinformation Ihr Abonnement ist
• Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin auftritt, ist die deaktivierte Organisation die, die an Ihrem /login gebunden ist. Kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.

Routines are disabled by your organization's policy

Ihr Team- oder Enterprise-Administrator hat Routinen auf Organisationsebene deaktiviert. Der Fehler wird angezeigt, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, einschließlich von /schedule und der Routines-Benutzeroberfläche auf claude.ai/code.

Routines are disabled by your organization's policy.

Dies ist eine serverseitige Einstellung, daher kann sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.

Was zu tun ist:

• Bitten Sie Ihren Administrator, den Routines-Schalter unter claude.ai/admin-settings/claude-code zu aktivieren
• Für einmalige geplante Arbeiten, die keine Routinen auf Organisationsebene erfordern, siehe geplante Aufgaben

OAuth token revoked or expired

Ihre gespeicherte Anmeldung ist nicht mehr gültig. Ein widerrufener Token bedeutet, dass Sie sich überall abgemeldet haben oder ein Administrator den Zugriff entfernt hat; ein abgelaufener Token bedeutet, dass die automatische Aktualisierung mitten in der Sitzung fehlgeschlagen ist.

OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error

Was zu tun ist:

• Führen Sie /login aus, um sich erneut anzumelden
• Wenn der Fehler nach der erneuten Authentifizierung in der gleichen Sitzung zurückkommt, führen Sie zuerst /logout aus, um den gespeicherten Token vollständig zu löschen, dann /login
• Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS Keychain-Überprüfungen in Fehlerbehebung
• Für andere Fehler einschließlich 403 Forbidden und OAuth-Browser-Probleme siehe Anmeldung und Authentifizierung

OAuth scope requirement

Der gespeicherte Token stammt von vor einem Berechtigungsumfang, den ein neueres Feature benötigt. Sie sehen dies am häufigsten von /usage und dem Statuszeilen-Nutzungsindikator:

OAuth token does not meet scope requirement: user:profile

Was zu tun ist:

• Führen Sie /login aus, um einen neuen Token mit den aktuellen Umfängen zu erstellen. Sie müssen sich nicht zuerst abmelden.

Netzwerk- und Verbindungsfehler

Diese Fehler bedeuten, dass eine Netzwerkanfrage von Claude Code ihr Ziel nicht erreicht hat. Sie stammen normalerweise aus Ihrem lokalen Netzwerk, Proxy oder Firewall oder aus der Netzwerkrichtlinie der Cloud-Umgebung.

Unable to connect to API

Die TCP-Verbindung zur API ist fehlgeschlagen oder wurde nie abgeschlossen.

Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings

Häufige Ursachen sind kein Internetzugang, ein VPN, das api.anthropic.com blockiert, oder ein erforderlicher Unternehmens-Proxy, der nicht konfiguriert ist.

Was zu tun ist:

• Bestätigen Sie, dass Sie den API-Host aus der gleichen Shell erreichen können, indem Sie curl -I https://api.anthropic.com ausführen. Verwenden Sie auf Windows PowerShell curl.exe -I https://api.anthropic.com, damit der integrierte Invoke-WebRequest-Alias nicht verwendet wird.
• Wenn Sie hinter einem Unternehmens-Proxy sind, setzen Sie HTTPS_PROXY, bevor Sie Claude Code starten, und siehe Netzwerkkonfiguration
• Wenn Sie durch ein LLM-Gateway oder Relay leiten, setzen Sie ANTHROPIC_BASE_URL auf seine Adresse. Siehe LLM-Gateway-Konfiguration für die Einrichtung.
• Stellen Sie sicher, dass Ihre Firewall die in Netzwerkzugriffsanforderungen aufgelisteten Hosts zulässt
• Vorübergehende Fehler werden automatisch wiederholt; anhaltende Fehler deuten auf ein lokales Netzwerkproblem hin

Wenn curl erfolgreich ist, aber Claude Code immer noch fehlschlägt, ist die Ursache normalerweise etwas zwischen der Laufzeit und dem Netzwerk und nicht das Netzwerk selbst:

• Überprüfen Sie auf Linux und WSL /etc/resolv.conf auf einen unerreichbaren Nameserver. WSL kann insbesondere einen fehlerhaften Resolver vom Host erben.
• Auf macOS kann ein VPN-Client, der getrennt oder deinstalliert wurde, eine Tunnel-Schnittstelle oder Routing-Regel hinterlassen. Überprüfen Sie ifconfig auf verwaiste utun-Schnittstellen und entfernen Sie die Netzwerkerweiterung des VPN in den Systemeinstellungen.
• Docker Desktop und ähnliche Container-Runtimes können ausgehenden Datenverkehr abfangen. Beenden Sie sie und versuchen Sie es erneut, um dies auszuschließen.

SSL certificate errors

Ein Proxy oder Sicherheitsgerät in Ihrem Netzwerk fängt TLS-Datenverkehr mit seinem eigenen Zertifikat ab, und Claude Code vertraut ihm nicht.

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected

Was zu tun ist:

• Exportieren Sie das CA-Bundle Ihrer Organisation und zeigen Sie Claude Code mit NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem darauf
• Siehe Netzwerkkonfiguration für vollständige Einrichtungsanweisungen
• Setzen Sie nicht NODE_TLS_REJECT_UNAUTHORIZED=0, was die Zertifikatvalidierung vollständig deaktiviert

Host not allowed in a cloud session

Eine ausgehende HTTP-Anfrage von einer Cloud-Sitzung oder Routine wurde durch die Netzwerkrichtlinie der Umgebung blockiert.

HTTP 403
x-deny-reason: host_not_allowed

Möglicherweise wird auch ein TLS-Zertifikat angezeigt, das nicht dem echten Zertifikat des Ziels entspricht. Die Cloud-Umgebung leitet ausgehenden Datenverkehr durch einen Proxy, der die Netzwerkrichtlinie durchsetzt, daher bedeutet ein nicht übereinstimmendes Zertifikat, dass der Proxy die Verbindung beendet hat, nicht das Ziel.

Dies ist kein clientseitiges Netzwerkproblem. Cloud-Sitzungen und Routinen werden in einer Sandbox-Umgebung ausgeführt, deren ausgehender Datenverkehr auf die Zulassungsliste der Umgebung gefiltert wird. Die Standard-Umgebung verwendet Vertrauenswürdigen Zugriff, der die Standard-Zulassungsliste von Paketregistern, Cloud-Provider-APIs, Container-Registern und häufigen Entwicklungsdomänen zulässt, aber alles andere blockiert.

Was zu tun ist:

• Öffnen Sie die Routine zum Bearbeiten, oder starten Sie eine Cloud-Sitzung. Wählen Sie das Cloud-Symbol, das den Namen Ihrer Umgebung anzeigt, z. B. Standard, um die Auswahl zu öffnen. Bewegen Sie den Mauszeiger über Ihre Umgebung und klicken Sie auf das Einstellungssymbol.
• Im Dialog Cloud-Umgebung aktualisieren ändern Sie Netzwerkzugriff von Vertrauenswürdig zu Benutzerdefiniert, und fügen Sie dann die blockierte Domain zu Zulässige Domains hinzu. Geben Sie eine Domain pro Zeile ein. Aktivieren Sie Auch Standard-Liste häufiger Paketmanager einschließen, um die Standard-Zulassungsliste neben Ihren benutzerdefinierten Domains zu behalten. Wählen Sie stattdessen Vollständig, wenn Sie uneingeschränkten Zugriff möchten.
• Klicken Sie auf Änderungen speichern. Der nächste Durchlauf verwendet die aktualisierte Zulassungsliste.

Siehe Netzwerkzugriff für Zugriffsstufen und die Standard-Zulassungsliste. Lokale CLI-Sitzungen sind von dieser Richtlinie nicht betroffen.

Anfragefehler

Diese Fehler bedeuten, dass die API Ihre Anfrage erhalten hat, aber ihren Inhalt abgelehnt hat.

Prompt is too long

Die Konversation plus angehängte Dateien überschreitet das Kontextfenster des Modells.

Prompt is too long

Was zu tun ist:

• Führen Sie /compact aus, um frühere Turns zusammenzufassen und Platz freizugeben, oder /clear, um neu zu beginnen
• Führen Sie /context aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: Systemprompt, Tools, Memory-Dateien und Nachrichten
• Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit /mcp disable <name>, um ihre Tool-Definitionen aus dem Kontext zu entfernen
• Trimmen Sie große CLAUDE.md Memory-Dateien, oder verschieben Sie Anweisungen in path-scoped rules, die nur bei Bedarf geladen werden
• Subagenten erben jede MCP-Tool-Definition von der übergeordneten Sitzung, was ihr Kontextfenster füllen kann, bevor der erste Turn stattfindet. Deaktivieren Sie MCP-Server, die Sie nicht verwenden, bevor Sie Subagenten spawnen.
• Auto-compact ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie DISABLE_AUTO_COMPACT gesetzt haben, aktivieren Sie es erneut oder führen Sie /compact manuell aus, bevor das Fenster voll wird.

Siehe Explore the context window für eine interaktive Ansicht, wie sich der Kontext füllt.

Error during compaction: Conversation too long

/compact selbst ist fehlgeschlagen, weil nicht genug freier Kontext vorhanden ist, um die Zusammenfassung zu halten, die es erzeugt.

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

Dies kann auftreten, wenn das Fenster bereits voll ist, wenn auto-compact ausgelöst wird, oder wenn Sie /compact ausführen, nachdem Sie Prompt is too long gesehen haben.

Was zu tun ist:

• Drücken Sie Esc zweimal, um die Nachrichtenliste zu öffnen und mehrere Turns zurückzugehen. Dies lässt die neuesten Nachrichten aus dem Kontext fallen. Führen Sie dann /compact erneut aus.
• Wenn das Zurückgehen nicht genug Platz freimacht, führen Sie /clear aus, um eine neue Sitzung zu starten. Ihre vorherige Konversation wird beibehalten und kann mit /resume erneut geöffnet werden.

Request too large

Der rohe Anfragekörper überschritt das Byte-Limit der API vor der Tokenisierung, normalerweise wegen einer großen eingefügten Datei oder eines Anhangs.

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

Dies ist ein Größenlimit für die HTTP-Anfrage, getrennt vom Kontextfenster-Limit.

Was zu tun ist:

• Drücken Sie Esc zweimal und gehen Sie zurück über den Turn, der den übergroßen Inhalt hinzugefügt hat
• Referenzieren Sie große Dateien nach Pfad, anstatt ihren Inhalt einzufügen, damit Claude sie in Chunks lesen kann
• Für Bilder siehe Image was too large unten

Image was too large

Ein eingefügtes oder angehängtes Bild überschreitet die Größen- oder Dimensionslimits der API.

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size

Das Bild bleibt nach dem Fehler in der Konversationshistorie, daher schlägt jede nachfolgende Nachricht mit dem gleichen Fehler fehl, bis Sie es entfernen.

Was zu tun ist:

• Drücken Sie Esc zweimal und gehen Sie zurück über den Turn, in dem das Bild hinzugefügt wurde
• Ändern Sie die Größe des Bildes vor dem Einfügen. Die API akzeptiert Bilder bis zu 8000 Pixeln auf der längsten Kante für ein einzelnes Bild oder 2000 Pixel, wenn viele Bilder im Kontext sind.
• Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms

PDF errors

Das PDF, das Sie angehängt haben, konnte nicht verarbeitet werden.

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.

Was zu tun ist:

• Für übergroße PDFs bitten Sie Claude, einen Seitenbereich mit dem Read-Tool zu lesen, anstatt die ganze Datei anzuhängen, oder extrahieren Sie Text mit einem Tool wie pdftotext und referenzieren Sie die Ausgabedatei nach Pfad
• Für geschützte oder ungültige PDFs entfernen Sie das Passwort oder exportieren Sie die Datei erneut aus ihrer Quellanwendung, dann versuchen Sie es erneut

Extra inputs are not permitted

Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den anthropic-beta Request-Header entfernt, daher hat die API Felder abgelehnt, die davon abhängen.

API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

Claude Code sendet Beta-only-Felder wie context_management, effort und Tool input_examples zusammen mit einem anthropic-beta Header, der sie aktiviert. Wenn ein Gateway den Body weiterleitet, aber den Header löscht, sieht die API Felder, die sie nicht erkennt.

Was zu tun ist:

• Konfigurieren Sie Ihr Gateway, um den anthropic-beta Header weiterzuleiten. Siehe LLM gateway configuration.
• Setzen Sie als Fallback CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 vor dem Start. Dies deaktiviert Features, die den Beta-Header benötigen, damit Anfragen durch ein Gateway erfolgreich sind, das ihn nicht weiterleiten kann.

There's an issue with the selected model

Der konfigurierte Modellname wurde nicht erkannt oder Ihr Konto hat keinen Zugriff darauf.

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to select a different one.

Was zu tun ist:

• Führen Sie /model aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind
• Verwenden Sie einen Alias wie sonnet oder opus statt einer vollständigen versionierten ID. Aliases verfolgen die neueste Version, daher werden sie nicht veraltet. Siehe Model configuration.
• Wenn das falsche Modell immer wieder zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in Prioritätsreihenfolge: das --model Flag, die ANTHROPIC_MODEL Umgebungsvariable, dann das model Feld in .claude/settings.local.json, die settings.json Ihres Projekts und ~/.claude/settings.json. Entfernen Sie den veralteten Wert und Claude Code fällt auf Ihren Kontostandard zurück.
• Für Vertex AI-Bereitstellungen siehe Vertex AI troubleshooting.

Claude Opus is not available with the Claude Pro plan

Ihr aktiver Abonnementplan enthält nicht das Modell, das Sie ausgewählt haben.

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

Was zu tun ist:

• Führen Sie /model aus und wählen Sie ein Modell, das Ihr Plan enthält
• Wenn Sie Ihren Plan kürzlich aktualisiert haben und dies immer noch sehen, führen Sie /logout dann /login aus. Der gespeicherte Token spiegelt Ihren Plan zum Zeitpunkt der Anmeldung wider, daher wird ein Upgrade im Web nicht in einer bestehenden Sitzung wirksam, bis Sie sich erneut authentifizieren.
• Siehe claude.com/pricing für die Modelle, die jeder Plan enthält

thinking.type.enabled is not supported for this model

Ihre Claude Code-Version ist älter als das Minimum für Opus 4.7. Die CLI hat eine Thinking-Konfiguration gesendet, die das Modell nicht mehr akzeptiert.

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

Was zu tun ist:

• Führen Sie claude update aus, um auf v2.1.111 oder später zu aktualisieren, dann starten Sie Claude Code neu
• Wenn Sie nicht aktualisieren können, führen Sie /model aus und wählen Sie stattdessen Opus 4.6 oder Sonnet
• Wenn Sie dies im Agent SDK treffen, siehe SDK troubleshooting

Thinking budget exceeds output limit

Das konfigurierte Extended Thinking-Budget überschreitet die maximale Antwortlänge, daher bleibt kein Platz für die tatsächliche Antwort.

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code passt diese Werte auf der Anthropic API automatisch an. Sie sehen diesen Fehler normalerweise auf Amazon Bedrock oder Google Vertex AI, wenn MAX_THINKING_TOKENS höher als das Output-Limit des Anbieters gesetzt ist, oder wenn Plan Mode das Thinking-Budget erhöht.

Was zu tun ist:

• Senken Sie MAX_THINKING_TOKENS, oder erhöhen Sie CLAUDE_CODE_MAX_OUTPUT_TOKENS über das Thinking-Budget
• Siehe Extended thinking für wie das Budget mit der Ausgabelänge interagiert

Tool use or thinking block mismatch

Die Konversationshistorie erreichte die API in einem inkonsistenten Zustand, normalerweise nachdem ein Tool-Aufruf unterbrochen oder ein Turn während des Streams bearbeitet wurde.

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

Alle drei Varianten bedeuten das Gleiche: die Sequenz von tool_use, tool_result und thinking Blöcken in der Historie stimmt nicht mehr mit dem überein, was die API erwartet.

Was zu tun ist:

• Führen Sie /rewind aus, oder drücken Sie Esc zweimal, um zu einem Checkpoint vor dem beschädigten Turn zurückzugehen und von dort aus fortzufahren. Siehe Checkpointing für die Erstellung und Wiederherstellung von Checkpoints.

Responses seem lower quality than usual

Wenn Claudes Antworten weniger fähig erscheinen als erwartet, aber kein Fehler angezeigt wird, ist die Ursache normalerweise der Konversationszustand und nicht das Modell selbst. Claude Code ändert Modellversionen nicht stillschweigend. Es kann in bestimmten Fällen zu einem Fallback-Modell wechseln, z. B. wenn ein Opus-Kontingent erreicht wird oder ein Bedrock- oder Vertex AI-Bereich Ihr Modell nicht hat; die Modellauswahlprüfung unten erfasst beide, und Model configuration erklärt, wann Fallback angewendet wird.

Überprüfen Sie diese zuerst:

• Modellauswahl: Führen Sie /model aus, um zu bestätigen, dass Sie auf dem Modell sind, das Sie erwarten. Eine vorherige /model-Wahl oder eine ANTHROPIC_MODEL Umgebungsvariable kann Sie auf einem kleineren Modell haben als beabsichtigt.
• Anstrengungsstufe: Führen Sie /effort aus, um die aktuelle Reasoning-Stufe zu überprüfen und sie für schwieriges Debugging oder Design-Arbeit zu erhöhen. Die Standardwerte variieren je nach Modell, daher überprüfen Sie, bevor Sie davon ausgehen, dass Sie unter dem Maximum sind. Siehe Adjust effort level für Pro-Modell-Standardwerte und die ultrathink Verknüpfung.
• Kontextdruck: Führen Sie /context aus, um zu sehen, wie voll das Fenster ist. Wenn es sich der Kapazität nähert, führen Sie /compact an einem natürlichen Haltepunkt oder /clear aus, um neu zu beginnen. Siehe Explore the context window für die Auswirkungen von auto-compact auf frühere Turns.
• Veraltete Anweisungen: Große oder veraltete CLAUDE.md Dateien und MCP-Tool-Definitionen verbrauchen Kontext und können Antworten lenken. /doctor kennzeichnet übergroße Memory-Dateien und Subagenten-Definitionen; /context zeigt die MCP-Tool-Token-Nutzung.

Wenn eine Antwort schiefgeht, funktioniert das Zurückspulen normalerweise besser als das Antworten mit Korrektionen. Drücken Sie Esc zweimal oder führen Sie /rewind aus, um zu vor dem schlechten Turn zurückzugehen, dann formulieren Sie den Prompt mit mehr Spezifika um. Korrigieren im Thread hält den falschen Versuch im Kontext, was später Antworten daran verankern kann. Siehe Checkpointing.

Wenn die Qualität immer noch seltsam wirkt, nachdem Sie das Obige überprüft haben, führen Sie /feedback aus und beschreiben Sie, was Sie erwartet haben versus was Sie bekommen haben. Auf diese Weise eingereichte Rückmeldungen enthalten das Konversationstranskript, das der schnellste Weg für Anthropic ist, eine echte Regression zu diagnostizieren. Siehe Report an error, wenn /feedback bei Ihrem Anbieter nicht verfügbar ist.

Fehler melden

Diese Seite behandelt Fehler von der Claude API. Für Fehler von anderen Claude Code-Komponenten siehe das relevante Handbuch:

• MCP-Server konnte sich nicht verbinden oder authentifizieren: MCP
• Hook-Skript ist fehlgeschlagen oder hat ein Tool blockiert: Debug hooks
• Berechtigung verweigert oder Dateisystemfehler während der Installation: Troubleshooting-Installation und Anmeldung

Wenn ein Fehler hier nicht aufgelistet ist oder der vorgeschlagene Fix nicht hilft:

• Führen Sie /feedback in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Problem zu öffnen. Auf Bedrock, Vertex AI, Foundry und anderen Drittanbieter-Plattformen speichert /feedback ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontovertreter senden können.
• Führen Sie /doctor aus, um auf lokale Konfigurationsprobleme zu überprüfen
• Überprüfen Sie status.claude.com auf aktive Vorfälle
• Suchen Sie existing issues auf GitHub