SpyBara
Go Premium

errors.md 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

447 added, 239 removed.

2026
Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

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.

Meldung Abschnitt
API Error: 500 Internal server error Serverfehler
API Error: Repeated 529 Overloaded errors Serverfehler
Request timed out Serverfehler, oder Netzwerk wenn die Meldung Ihre Internetverbindung erwähnt
Server error mid-response. The response above may be incomplete. Serverfehler
Connection closed mid-response / Response stalled mid-stream Serverfehler
<model> is temporarily unavailable, so auto mode cannot determine the safety of... Serverfehler
Auto mode could not evaluate this action and is blocking it for safety Serverfehler
Auto mode classifier transcript exceeded context window Serverfehler
Agent terminated early due to an API error Serverfehler
You've hit your session limit / You've hit your weekly limit Nutzungslimits
Usage credits required for 1M context Nutzungslimits
Server is temporarily limiting requests Nutzungslimits
Request rejected (429) Nutzungslimits
Credit balance is too low Nutzungslimits
Not logged in · Please run /login Authentifizierung
Could not resolve authentication method Authentifizierung
Invalid API key Authentifizierung
This organization has been disabled Authentifizierung
Your organization has disabled API key authentication Authentifizierung
Your organization has disabled Claude subscription access Authentifizierung
Routines are disabled by your organization's policy Authentifizierung
Remote Control is only available when using Claude via api.anthropic.com Authentifizierung
OAuth token revoked / OAuth token has expired Authentifizierung
does not meet scope requirement user:profile Authentifizierung
AWS credentials expired or invalid Authentifizierung
AWS authentication failed Authentifizierung
Unable to connect to API Netzwerk
Waiting for API response · will retry in Automatische Wiederholungen, oder Netzwerk wenn es anhält
SSL certificate verification failed Netzwerk
SSL certificate error (...) during login or startup Netzwerk
403 with x-deny-reason: host_not_allowed in a cloud or routine session Netzwerk
Couldn't reconnect to your Remote Control session Netzwerk
Prompt is too long Anfragefehler
Error during compaction: Conversation too long Anfragefehler
Request too large Anfragefehler
Image was too large Anfragefehler
Unable to resize image Anfragefehler
PDF too large / PDF is password protected Anfragefehler
Extra inputs are not permitted Anfragefehler
There's an issue with the selected model Anfragefehler
Model ... is not a recognized model id Anfragefehler
Claude Opus is not available with the Claude Pro plan Anfragefehler
Model ... is restricted by your organization's settings Anfragefehler
thinking.type.enabled is not supported for this model Anfragefehler
max_tokens must be greater than thinking.budget_tokens Anfragefehler
API Error: 400 due to tool use concurrency issues Anfragefehler
Claude Code is unable to respond to this request, which appears to violate our Usage Policy Anfragefehler
<model> has safety measures that flagged this message for a cybersecurity topic Anfragefehler
Installation was killed before it could finish (exit code 137) Installationsfehler
The connection dropped while downloading the update Installationsfehler
Download timed out: exceeded the total deadline Installationsfehler
--bg and --print conflict Befehlszeilenfehler
Error: --json-schema is not a valid JSON Schema Befehlszeilenfehler
Could not import <server>: <reason> Befehlszeilenfehler
Marketplace "<name>" is registered from an untrusted source Plugin-Fehler
Ignoring N permissions.allow entries from ... this workspace has not been trusted Konfigurationswarnungen
Responses seem lower quality than usual Antwortqualität

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. {/* min-version: 2.1.198 /}Ab v2.1.198 umfasst dies Verbindungen, die in der Mitte einer Antwort abbrechen, bevor sichtbare Ausgabe gestreamt wurde: Claude Code sendet die Anfrage mit dem gleichen Backoff erneut aus und der Turn wird fortgesetzt, anstatt mit einem Verbindungsfehler zu stoppen. {/ min-version: 2.1.199 */}Ab v2.1.199 werden auch vorübergehende 429-Drosselungen, die nicht die Quota-Header Ihres Plans tragen, wiederholt, wenn Sie mit einem claude.ai-Abonnement angemeldet sind; frühere Versionen wiederholten sie nur für API-Schlüssel- und Enterprise-Anmeldungen.

Zwei Fehlerklassen werden nicht wiederholt, da eine Wiederholung nicht erfolgreich sein kann:

  • {/* min-version: 2.1.199 */}Ab v2.1.199 schlägt ein TLS-Zertifikatvalidierungsfehler, wie ein TLS-inspizierender Proxy, ein fehlender NODE_EXTRA_CA_CERTS Bundle oder ein abgelaufenes Zertifikat, beim ersten Versuch fehl, daher wird die Behebung sofort angezeigt, anstatt nach dem vollständigen Wiederholungsbudget. Siehe SSL-Zertifikatsfehler. Vorübergehende TLS-Bedingungen wie ein Handshake-Timeout werden weiterhin wiederholt.
  • {/* min-version: 2.1.199 */}Ab v2.1.199 behält ein Serverfehler, der ankommt, nachdem Claude bereits sichtbare Ausgabe gestreamt hat, die Teilantwort und fügt stattdessen eine Benachrichtigung über unvollständige Antwort an, anstatt zu wiederholen, da das erneute Ausführen der Anfrage die gleichen Tool-Aufrufe zweimal ausführen könnte. Frühere Versionen verwarfen die Teilausgabe und meldeten den Turn als Fehler.

Während der Wiederholung zeigt der Spinner einen Retrying in Ns · attempt x/y Countdown nach einem Fehler-Label an. Das Label benennt den spezifischen Grund aus dem ersten Versuch für Fehler, auf die Sie sofort reagieren können: Das Netzwerk ist ausgefallen, ein TLS-Handshake ist fehlgeschlagen, oder Sie haben ein Ratenlimit erreicht. Für andere Fehler lautet es zunächst API error. {/* min-version: 2.1.198 */}Ab v2.1.198 wechselt es zum spezifischen Grund aus dem dritten Versuch, oder beim letzten Versuch, wenn CLAUDE_CODE_MAX_RETRIES weniger als drei erlaubt; frühere Versionen wechseln nur beim letzten Versuch.

{/* min-version: 2.1.198 */}Ab v2.1.198 wird der übliche Spinner-Tipp während Wiederholungen unterdrückt. Sobald der Fehlergrund offenbart wird, wenn der Fehler eine 529-Überlastung ist, benennt die Zeile unter dem Countdown auch, wo der Dienststatus überprüft werden kann: status.claude.com auf der Anthropic API, oder der in der Nachricht genannte Provider- oder Gateway-Host bei anderen Konfigurationen.

{/* min-version: 2.1.185 */}Wenn 20 Sekunden lang keine Daten im Antwortstrom ankommen, während eine Anfrage noch ausstehend ist, zeigt der Spinner Waiting for API response · will retry in … · check your network an, bevor ein Wiederholungsversuch gestartet wurde. Die Anfrage ist noch nicht fehlgeschlagen: Der Countdown läuft bis zu dem Punkt, an dem Claude Code die stillgelegte Verbindung abbricht und wiederholt, sodass das Banner von selbst verschwindet, sobald Daten wieder ankommen oder die Wiederholung erfolgreich ist. Ab v2.1.185 beträgt der Schwellenwert 20 Sekunden; frühere Versionen zeigen das Banner nach 10 Sekunden mit unterschiedlicher Formulierung an. Wenn es bei jedem Versuch erneut angezeigt wird, behandeln Sie es als Netzwerkproblem.

Wenn Sie einen der Fehler auf dieser Seite sehen, wurden diese Wiederholungen bereits erschöpft, es sei denn, er gehört zu einer Klasse, die nicht wiederholt wird, wie ein Zertifikatvalidierungsfehler. Sie können das Verhalten mit diesen Umgebungsvariablen anpassen:

Variable Standard Effekt
CLAUDE_CODE_MAX_RETRIES 10 Anzahl der Wiederholungsversuche. {/* min-version: 2.1.186 /}Ab v2.1.186 auf 15 begrenzt; {/ min-version: 2.1.199 */}ab v2.1.199 hebt CLAUDE_CODE_RETRY_WATCHDOG den Standard an und entfernt die Obergrenze. Senken Sie den Wert, um Fehler in Skripten schneller anzuzeigen.
CLAUDE_CODE_RETRY_WATCHDOG nicht gesetzt Setzen Sie auf 1 in unbeaufsichtigten Sitzungen wie CI-Jobs, um 429- und 529-Kapazitätsfehler unbegrenzt zu wiederholen, anstatt nach CLAUDE_CODE_MAX_RETRIES-Versuchen fehlzuschlagen. {/* min-version: 2.1.199 */}Ab v2.1.199 erhöht es auch die Standard-Wiederholungsanzahl für andere vorübergehende Fehler, wie Serverfehler, Timeouts und unterbrochene Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf CLAUDE_CODE_MAX_RETRIES, wenn Sie diese Variable explizit setzen.
API_TIMEOUT_MS 600000 Pro-Anfrage-Timeout in Millisekunden. Erhöhen Sie es für langsame Netzwerke oder Proxys.

Serverfehler

Diese Fehler stammen vom Inferenzanbieter und nicht von Ihrem Konto oder Ihrer Anfrage. Bei der Anthropic API bedeutet das Anthropic-Infrastruktur. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem benutzerdefinierten Gateway bedeutet das die Infrastruktur dieses Anbieters.

API-Fehler: 500 Interner Serverfehler

Claude Code zeigt den Statuscode und die Fehlermeldung der API für jede 5xx-Antwort an. Das folgende Beispiel zeigt eine 500-Antwort auf der Anthropic API:

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

Der abschließende Satz benennt, wo die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen benennen die Servicestatuseite dieses Anbieters. Eine benutzerdefinierte ANTHROPIC_BASE_URL benennt den Gateway-Host.

Dies deutet auf einen unerwarteten Fehler innerhalb der API hin. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.

Was zu tun ist:

  • Überprüfen Sie status.claude.com oder die in der Meldung genannte Servicestatusseite des Anbieters auf aktive Vorfälle
  • Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht ist noch im Gespräch, sodass Sie bei einem langen Prompt try again eingeben können, anstatt alles erneut einzufügen.
  • Wenn der Fehler ohne einen veröffentlichten Vorfall weiterhin auftritt, führen Sie /feedback aus, damit Anthropic Ihre Anfrageinformationen untersuchen kann. Siehe Fehler melden, wenn /feedback in Ihrer Umgebung nicht verfügbar ist.

API-Fehler: Wiederholte 529 Overloaded-Fehler

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

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

Der abschließende Satz variiert je nach Anbieter auf die gleiche Weise wie der 500-Fehler oben.

Ein 529-Fehler ist nicht Ihr Nutzungslimit und wird nicht auf Ihr Kontingent angerechnet.

Was zu tun ist:

  • Überprüfen Sie status.claude.com oder die in der Meldung genannte Servicestatusseite des Anbieters 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 steht, zum Beispiel Opus is experiencing high load, please use /model to switch to Sonnet.

Anfrage hat das Zeitlimit überschritten

Die API hat nicht vor der Verbindungsfrist geantwortet.

Request timed out

Dies kann während Zeiten hoher Last auftreten oder wenn das Modell eine sehr große Antwort generiert. Das Standard-Anfrage-Zeitlimit beträgt 10 Minuten.

Was zu tun ist:

  • Wiederholen Sie die Anfrage
  • Teilen Sie die Arbeit bei langfristigen Aufgaben in kleinere Prompts auf
  • Wenn eine langsame Netzwerkverbindung oder ein Proxy die Ursache ist, erhöhen Sie API_TIMEOUT_MS wie in Automatische Wiederholungen beschrieben
  • Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe Netzwerk- und Verbindungsfehler unten

Die obige Antwort kann unvollständig sein

Eine Streaming-Antwort ist fehlgeschlagen, nachdem Claude bereits sichtbare Ausgabe produziert hatte. Das erneute Senden der Anfrage könnte die gleichen Tool-Aufrufe zweimal ausführen, daher behält Claude Code das bereits Gestreamte und fügt stattdessen diese Mitteilung an, anstatt den Zug zu verwerfen. Welche Variante Sie sehen, benennt die Ursache:

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.
  • {/* min-version: 2.1.199 */}Server error mid-response: ein Mid-Stream-Overloaded- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die teilweise Ausgabe und meldete den gesamten Zug als Fehler.
  • Connection closed mid-response: die Verbindung wurde unterbrochen.
  • Response stalled mid-stream: der Stream hat das Senden von Daten gestoppt.

Was zu tun ist:

  • Lesen Sie die Antwort, die gestreamt wurde. Nichts ist verloren gegangen, aber die letzten Sätze oder Tool-Aufrufe können fehlen.
  • Antworten Sie mit continue, damit Claude dort weitermacht, wo es aufgehört hat
  • Wenn der gleiche Fehler vor einer sichtbaren Ausgabe auftritt, wiederholt Claude Code die Anfrage, anstatt sie abzuschließen. Siehe Automatische Wiederholungen.

Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen

Das Modell, das der Auto-Modus zur Klassifizierung von Aktionen verwendet, konnte keine Entscheidung treffen, daher genehmigte der Auto-Modus die Aktion nicht automatisch. 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 hängt nicht mit der Auto-Modus-Berechtigung zusammen; 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 eine separate API-Sicherheitsprüfung die Klassifizierer-Anfrage aufgrund früherer Gesprächsinhalte blockiert hat:

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

Was zu tun ist:

  • Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrem Gespräch vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus das Gespräch an den Klassifizierer sendete
  • Eine Wiederholung hilft nicht; der gleiche Gesprächsinhalt löst den Filter erneut aus
  • Wechseln Sie zu einem anderen Berechtigungsmodus, damit Sie die Aktion bei Aufforderung genehmigen können, oder starten Sie ein neues Gespräch ohne den auslösenden Inhalt

Wenn das Gespräch 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 der Auto-Modus auf eine normale Berechtigungsaufforderung 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 eine Wiederholung nicht erfolgreich sein kann.

Was zu tun ist:

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

Agent wurde aufgrund eines API-Fehlers vorzeitig beendet

{/* min-version: 2.1.199 */}Eine Subagent-API-Anfrage ist terminal fehlgeschlagen, zum Beispiel weil ein Nutzungslimit erreicht wurde oder Wiederholungen für einen Serverfehler aufgebraucht wurden, daher stoppte der Subagent, bevor er seine Aufgabe beendete. Diese Meldung erfordert Claude Code v2.1.199 oder später; davor wurde der API-Fehlertext an Claude zurückgegeben, als wäre er das Ergebnis des Subagenten.

Agent terminated early due to an API error: <error detail>

Was zu tun ist:

  • Ordnen Sie die Fehlerdetails nach dem Doppelpunkt einem eigenen Abschnitt auf dieser Seite zu, wie z. B. Nutzungslimits oder Serverfehler, und folgen Sie den Schritten dieses Abschnitts
  • Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder den Subagenten fortzusetzen

Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe produziert hat, erhält Claude diese teilweise Ausgabe als unvollständig markiert, anstatt diesen Fehler. {/* min-version: 2.1.200 */}Ein Subagent, dessen einzige Ausgabe Tool-Aufrufe waren, erhält auch diesen Fehler; in v2.1.199 gab dies stattdessen ein leeres Teilergebnis zurück. Siehe API-Fehler in Subagenten.

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.

Sie haben Ihr Sitzungslimit erreicht

Abonnementpläne enthalten eine rollende Nutzungszuteilung. Wenn diese 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 zum in der Meldung angezeigten Zurücksetzzeitpunkt.

Was Sie tun können:

  • Warten Sie auf den im Fehler angezeigten Zurücksetzzeitpunkt
  • Führen Sie /usage aus, um Ihre Planlimits und deren Zurücksetzzeitpunkte anzuzeigen
  • Führen Sie /usage-credits aus, um zusätzliche Nutzung auf Pro und Max zu kaufen, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an. Siehe Nutzungsguthaben für bezahlte Pläne für Informationen zur Abrechnung.
  • Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe claude.com/pricing

Um Ihre verbleibende Zuteilung 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.

Nutzungsguthaben erforderlich für 1M-Kontext

Das ausgewählte Modell verwendet das 1M-Token-Kontextfenster mit erweiterter Länge, und Ihr Plan enthält es nur über Nutzungsguthaben.

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenzuteilungen noch Kapazität haben. Siehe Erweiterter Kontext für Informationen darüber, welche Pläne 1M-Kontext direkt enthalten und welche Nutzungsguthaben erfordern.

{/* min-version: 2.1.172 */}Wenn dieser Fehler während eines Gesprächs auftritt, weil der Kontext über 200K Token gewachsen ist, komprimiert Claude Code das Gespräch automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, sodass keine Aktion erforderlich ist. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich /compact; führen Sie /clear in diesen Versionen aus, um die Funktion wiederherzustellen. Die folgenden Schritte gelten, wenn Sie explizit ein [1m]-Modell ausgewählt haben.

Was Sie tun können:

  • Führen Sie /model aus und wählen Sie die Variante ohne das [1m]-Suffix, um auf das Standard-Kontextfenster zurückzufallen
  • Führen Sie /usage-credits aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an
  • Wenn der Fehler nach /model weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle festgelegt sein. Siehe Es gibt ein Problem mit dem ausgewählten Modell für die Konfigurationsorte, die in Prioritätsreihenfolge zu überprüfen sind.
  • Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie CLAUDE_CODE_DISABLE_1M_CONTEXT=1

Server drosselt Anfragen vorübergehend

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

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

Claude Code unterscheidet diese von Ihrem Planlimit durch das Fehlen der einheitlichen Kontingent-Header, die eine echte Limit-Antwort trägt. {/* min-version: 2.1.199 */}Ab v2.1.199 wird dies automatisch erneut versucht mit Backoff, bevor es angezeigt wird, unabhängig davon, wie Sie sich authentifizieren. In früheren Versionen schlug eine Sitzung, die mit einem claude.ai-Abonnement angemeldet war, beim ersten Auftreten fehl; nur API-Schlüssel und Enterprise-Anmeldungen wiederholten den Versuch.

Was Sie tun können:

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

Anfrage abgelehnt (429)

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

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

Der nachfolgende Satz benennt, wo die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen benennen stattdessen die Servicestatusseite dieses Anbieters anstelle der Anthropic-Statusseite. Eine benutzerdefinierte ANTHROPIC_BASE_URL benennt den Gateway-Host.

Was Sie tun können:

  • 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 über einen Low-Tier-Schlüssel statt über 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 Informationen zur Funktionsweise von Tiers und zum Festlegen von Pro-Workspace-Limits
  • 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 Läufe mit hohem Volumen

Guthabensaldo ist zu niedrig

Ihre Console-Organisation hat die vorausbezahlten Guthaben aufgebraucht.

Credit balance is too low

Was Sie tun können:

  • Fügen Sie Guthaben unter platform.claude.com/settings/billing hinzu, und erwägen Sie, dort das automatische Nachladen zu aktivieren, damit der Saldo aufgefüllt wird, bevor er 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 Organisationsguthaben aufbraucht. Siehe Kosten effektiv verwalten.

Authentifizierungsfehler

Diese Fehler bedeuten, dass Claude Code nicht nachweisen kann, wer Sie gegenüber der API sind. Führen Sie jederzeit /status aus, um zu sehen, welche Anmeldedaten derzeit aktiv sind.

Nicht angemeldet

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

Not logged in · Please run /login

Was zu tun ist:

  • Führen Sie /login aus, um sich mit Ihrem Claude-Abonnement oder Ihrem Console-Konto zu authentifizieren
  • Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, bestätigen Sie, dass ANTHROPIC_API_KEY in der Shell, in der Sie claude gestartet haben, gesetzt und exportiert ist
  • 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 Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

Wenn Sie wiederholt zur Anmeldung aufgefordert werden, siehe Nicht angemeldet oder Token abgelaufen für Systemuhr- und macOS-Keychain-Korrektionen.

Authentifizierungsmethode konnte nicht aufgelöst werden

Die Sitzung erreichte den API-Client ohne Anmeldedaten. Dies erscheint in Hintergrundsitzungen, Cloud-Sitzungen und Agent-SDK-Kontexten, bei denen die interaktive Anmeldungsprüfung nicht vor der ersten Anfrage ausgeführt wird.

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

{/* min-version: 2.1.174 */}Vor v2.1.174 konnte eine Hintergrund- oder Cloud-Sitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Führen Sie ein Upgrade durch, um die Funktion wiederherzustellen. In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten verfügbar waren.

Was zu tun ist:

  • Führen Sie ein Upgrade auf v2.1.174 oder später durch, wenn dies in einer Hintergrund- oder Cloud-Sitzung angezeigt wird und Ihre Anmeldedaten bereits konfiguriert sind
  • Bestätigen Sie, dass ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN oder Ihre Cloud-Provider-Anmeldedaten in der Umgebung gesetzt sind, die den Worker startet, nicht nur in Ihrer interaktiven Shell
  • Für das Agent SDK siehe Authentifizierungseinrichtung
  • Führen Sie /status in einer interaktiven Sitzung in derselben Umgebung aus, um zu bestätigen, welche Anmeldedatenquelle aufgelöst wird

Ungültiger API-Schlüssel

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 derselben 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 Anmeldedatenquelle Claude Code tatsächlich verwendet

Diese Organisation wurde deaktiviert

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, selbst 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 Anmeldedaten Ihr Abonnement sind
  • Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin besteht, ist die deaktivierte Organisation diejenige, die mit Ihrem /login verknüpft ist. Kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.

Ihre Organisation hat die API-Schlüssel-Authentifizierung deaktiviert

Diese Meldung erfordert Claude Code v2.1.169 oder später. Der Administrator Ihrer Console-Organisation hat die API-Schlüssel-Authentifizierung deaktiviert, daher lehnt die API den Schlüssel ab, den Claude Code sendet. Der Wiederherstellungshinweis nach dem · variiert je nachdem, woher der Schlüssel stammt:

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

Umgebungsvariablen und apiKeyHelper haben Vorrang vor /login, daher hilft das alleinige Ausführen von /login nicht, während einer von ihnen noch einen Schlüssel bereitstellt. Siehe Authentifizierungspriorität.

Was zu tun ist:

  • Wenn die Meldung ANTHROPIC_API_KEY nennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder .env-Datei, dann starten Sie claude neu
  • Wenn die Meldung apiKeyHelper nennt, entfernen Sie die apiKeyHelper-Einstellung aus Ihrer settings.json
  • Führen Sie /login aus, um sich mit Ihrem claude.ai-Konto anzumelden
  • Führen Sie danach /status aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement und nicht ein API-Schlüssel sind
  • Wenn Sie API-Schlüssel-Authentifizierung für Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren

Ihre Organisation hat den Claude-Abonnementzugriff deaktiviert

Ihre Claude-Organisation erlaubt nicht, sich bei Claude Code mit einer Abonnement-Anmeldung anzumelden. Das erneute Ausführen von /login mit demselben Konto gibt denselben Fehler zurück.

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

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

Das Agent SDK und der -p nicht-interaktive Modus zeigen dies als oauth_org_not_allowed-Fehlercode an.

Was zu tun ist:

  • Bitten Sie Ihren Administrator, den Claude-Code-Zugriff für Ihre Organisation zu aktivieren
  • Authentifizieren Sie sich stattdessen mit einem Console-API-Schlüssel anstelle Ihres Abonnements. Siehe Claude-Console-Authentifizierung für die Einrichtung.
  • Wenn Sie der Administrator sind und keine Option zum Aktivieren des Zugriffs sehen, kontaktieren Sie den Anthropic-Support

Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert

Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisationsebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, einschließlich von /schedule und der Routinen-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:

Remote Control erfordert die Anthropic API

Die Sitzung spricht nicht direkt mit der Anthropic API, daher gibt es kein claude.ai-Backend für Remote Control zum Koppeln.

Remote Control is only available when using Claude via api.anthropic.com.

Dies erscheint auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 erscheint es auch, wenn ANTHROPIC_BASE_URL auf einen anderen Host als api.anthropic.com verweist, z. B. ein LLM-Gateway oder Proxy, selbst wenn Sie sich mit claude.ai anmelden.

Was zu tun ist:

  • Heben Sie ANTHROPIC_BASE_URL auf und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht
  • Für diese und die anderen Remote-Control-Startmeldungen siehe Remote Control beheben

OAuth-Token widerrufen oder abgelaufen

Ihre gespeicherte Anmeldung ist nicht mehr gültig. Ein widerrufenes Token bedeutet, dass Sie sich überall abgemeldet haben oder ein Administrator den Zugriff entfernt hat; ein abgelaufenes Token bedeutet, dass die automatische Aktualisierung während 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 innerhalb derselben Sitzung zurückkommt, führen Sie zuerst /logout aus, um das gespeicherte Token vollständig zu löschen, dann /login
  • Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS-Keychain-Prüfungen in Fehlerbehebung
  • Für andere Fehler einschließlich 403 Forbidden und OAuth-Browser-Probleme siehe Anmeldung und Authentifizierung

OAuth-Bereichsanforderung

Das gespeicherte Token stammt von vor einem Berechtigungsbereich, den eine neuere Funktion benötigt. Sie sehen dies am häufigsten von /usage und dem Nutzungsindikator in der Statuszeile:

OAuth token does not meet scope requirement: user:profile

Was zu tun ist:

  • Führen Sie /login aus, um ein neues Token mit den aktuellen Bereichen zu erhalten. Sie müssen sich nicht zuerst abmelden.

AWS-Anmeldedaten abgelaufen oder ungültig

{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn awsAuthRefresh in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt, und die automatische Aktualisierung, die Claude Code bereits ausgeführt hat, hat keine Anmeldedaten erzeugt, die die API akzeptiert. Es erscheint bei einem 401 von Claude Platform on AWS oder dem Mantle-Endpunkt, wie diese Anbieter ein abgelaufenes Sicherheits-Token melden.

Der Aktionshinweis in der Mitte nennt den awsAuthRefresh-Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende AWS credentials expired or invalid:

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

Ohne awsAuthRefresh konfiguriert, zeigt derselbe 401 stattdessen die generische Please run /login-Meldung an, die AWS-Anmeldedaten nicht aktualisieren kann.

Was zu tun ist:

  • Führen Sie den in der Meldung genannten awsAuthRefresh-Befehl aus, z. B. aws sso login --profile myprofile, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut
  • Führen Sie in einer interaktiven Sitzung /login aus, wählen Sie 3rd-party platform, dann wählen Sie Claude Platform on AWS · refresh credentials unter Using 3rd-party platforms, um denselben Befehl auszuführen, ohne Claude Code neu zu starten. Siehe AWS-Anmeldedaten konfigurieren
  • Wenn der Fehler nach dem erfolgreichen Aktualisierungsbefehl wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit aws sts get-caller-identity in derselben Shell und demselben Profil gültig ist

AWS-Authentifizierung fehlgeschlagen

{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn awsAuthRefresh in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder Amazon Bedrock hat einen 401 zurückgegeben.

Claude Code kann nicht sagen, welche Ursache Sie getroffen haben. Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch, wie es eine Autorisierungsverweigerung meldet, z. B. eine AccessDeniedException von einer fehlenden IAM-Berechtigung oder ein Modell, das nicht für Ihr Konto aktiviert ist.

Ein 401 von Amazon Bedrock landet hier auch anstelle von AWS-Anmeldedaten abgelaufen oder ungültig, da Amazon Bedrock ein abgelaufenes Token nicht als 401 meldet. Ein 401 von diesem Endpunkt kommt normalerweise von etwas anderem im Anfragepfad, z. B. einem Unternehmens-Proxy.

Eine Anmeldedaten-Aktualisierung behebt ein abgelaufenes Token und kann die anderen Ursachen nicht beheben, daher bietet die Meldung beide an:

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

Der Aktionshinweis in der Mitte nennt den awsAuthRefresh-Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende AWS authentication failed.

Was zu tun ist:

  • Führen Sie den in der Meldung genannten awsAuthRefresh-Befehl oder aws sso login aus, falls ein abgelaufenes Anmeldedaten die Ursache ist
  • Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie, dass die IAM-Berechtigungen in IAM-Konfiguration an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist
  • Führen Sie aws sts get-caller-identity aus, um zu bestätigen, welche Identität Ihre Anfragen verwenden; ein veraltetes AWS_PROFILE oder Standardprofil ist eine häufige Ursache für einen Berechtigungskonflikt

Netzwerk- und Verbindungsfehler

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

Verbindung zur API nicht möglich

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 fehlender 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 derselben Shell erreichen können, indem Sie curl -I https://api.anthropic.com ausführen. Verwenden Sie unter Windows PowerShell curl.exe -I https://api.anthropic.com, damit der integrierte Invoke-WebRequest-Alias nicht verwendet wird.
  • Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie HTTPS_PROXY vor dem Starten von Claude Code und siehe Netzwerkkonfiguration
  • Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie ANTHROPIC_BASE_URL auf dessen Adresse. Siehe Claude Code mit einem LLM-Gateway verbinden 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, liegt die Ursache normalerweise bei etwas zwischen der Laufzeit und dem Netzwerk und nicht beim Netzwerk selbst:

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

SSL-Zertifikatsfehler

Ein Proxy oder eine Sicherheitsappliance 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

{/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Zertifikatvalidierungsfehler nicht wiederholt, daher wird dieser Fehler beim ersten Versuch angezeigt, anstatt nach dem vollständigen Wiederholungsbudget. Frühere Versionen verbrachten einige Minuten mit Wiederholungen, bevor sie angezeigt wurden. Vorübergehende TLS-Bedingungen, wie z. B. ein Handshake-Timeout, werden weiterhin wiederholt.

Während /login und der Startup-Konnektivitätsprüfung wird derselbe Fehler mit dem OpenSSL-Code und der Behebung inline gemeldet:

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

Was zu tun ist:

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

Host nicht zulässig in einer Cloud-Sitzung

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 weiter, 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 mit dem Namen Ihrer Umgebung, z. B. Standard, um die Auswahl zu öffnen. Bewegen Sie den Mauszeiger über Ihre Umgebung und klicken Sie auf das Einstellungssymbol.
  • Ändern Sie im Dialog Cloud-Umgebung aktualisieren den 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. Die nächste Ausführung verwendet die aktualisierte Zulassungsliste.

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

Verbindung zu Ihrer Remote-Control-Sitzung konnte nicht wiederhergestellt werden

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

Das Fortsetzen mit claude --resume oder claude --continue stellt die Verbindung zur Remote Control-Sitzung wieder her, die in diesem Gespräch aufgezeichnet wurde. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der vorübergehend sein kann, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist. Ihre lokale Sitzung wird ohne Remote Control weiterhin ausgeführt.

Was zu tun ist:

  • Führen Sie /remote-control aus, um die Verbindung erneut zu versuchen
  • Starten Sie Claude Code ohne --resume, um eine neue Remote-Control-Sitzung zu erstellen
  • Weitere Remote-Control-Startmeldungen finden Sie unter Remote Control beheben

Diese Meldung wird nicht angezeigt, wenn der Server bestätigt, dass die vorherige Sitzung nicht mehr vorhanden ist. Claude Code erstellt in diesem Fall eine neue. {/* min-version: 2.1.200 */}Vor v2.1.200 hat jeder Wiederverbindungsfehler eine neue Remote-Control-Sitzung erstellt, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.

Anfragefehler

Diese Fehler beziehen sich auf den Inhalt Ihrer Anfrage. Die meisten werden von der API zurückgegeben, nachdem sie die Anfrage abgelehnt hat; einige werden lokal von Claude Code erzeugt, bevor eine Anfrage gesendet wird.

Eingabeaufforderung ist zu lang

Das Gespräch 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: Systemaufforderung, Tools, Speicherdateien 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-Speicherdateien, oder verschieben Sie Anweisungen in pfadgebundene Regeln, 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 Erkunden Sie das Kontextfenster für eine interaktive Ansicht, wie sich der Kontext füllt.

Fehler während der Komprimierung: Gespräch zu lang

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

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

Dies kann passieren, 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 entfernt die neuesten Nachrichten aus dem Kontext. 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. Ihr vorheriges Gespräch bleibt erhalten und kann mit /resume erneut geöffnet werden.

Anfrage zu groß

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 zum 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 Bild war zu groß unten

Bild war zu groß

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

{/* min-version: 2.1.142 */}Claude Code ersetzt das nicht verarbeitbare Bild durch einen Textplatzhalter und versucht es erneut, sodass nachfolgende Nachrichten erfolgreich sind. In Versionen vor 2.1.142 konnte ein eingefügtes Bild im Gespräch bleiben und denselben Fehler bei jeder nachfolgenden Nachricht wiederholen. Um sich in diesen Versionen zu erholen, drücken Sie Esc zweimal und gehen Sie zurück zum Turn, in dem das Bild hinzugefügt wurde.

Was zu tun ist:

  • Ä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 anstelle des gesamten Bildschirms

Bild konnte nicht in der Größe geändert werden

Claude Code konnte ein angehängtes Bild nicht herunterskalieren, bevor es an die API gesendet wurde.

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code ändert normalerweise die Größe großer Bilder automatisch. Diese Fehler bedeuten, dass der native Bildprozessor nicht geladen werden konnte oder einen Fehler zurückgegeben hat, sodass das Bild nicht an die API-Limits angepasst werden konnte.

Was zu tun ist:

  • Wenn die Nachricht Sie auffordert, das Bild zu konvertieren, konvertieren Sie es in PNG, JPEG, GIF oder WebP und fügen Sie es erneut an. Claude Code kann Dimensionen für diese Formate ohne den Bildprozessor überprüfen.
  • Wenn die Nachricht ein Dimensions- oder Größenlimit meldet, ändern Sie die Größe oder komprimieren Sie das Bild unter diesem Limit, bevor Sie es anhängen.

PDF-Fehler

Das angehängte PDF 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 gesamte 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 und versuchen Sie es erneut

Zusätzliche Eingaben sind nicht zulässig

Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den anthropic-beta-Anfrage-Header entfernt, sodass die API Felder ablehnte, 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 entfernt, sieht die API Felder, die sie nicht erkennt.

Was zu tun ist:

  • Konfigurieren Sie Ihr Gateway, um den anthropic-beta-Header weiterzuleiten. Siehe Feature-Durchleitung für das, was Gateways weiterleiten müssen.
  • Setzen Sie als Fallback CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 vor dem Start. Dies deaktiviert Funktionen, die den Beta-Header erfordern, sodass Anfragen durch ein Gateway erfolgreich sind, das ihn nicht weiterleiten kann.

Es gibt ein Problem mit dem ausgewählten Modell

Der konfigurierte Modellname wurde nicht erkannt oder Ihr Konto hat keinen Zugriff darauf. Ab v2.1.160 variiert der nachfolgende Hinweis, der hier in seiner interaktiven Form angezeigt wird, je nach Oberfläche.

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

Was zu tun ist:

  • Interaktive CLI: Führen Sie /model aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.
  • Nicht-interaktiver Modus (-p): Übergeben Sie --model mit einem gültigen Alias oder einer ID, oder setzen Sie ANTHROPIC_MODEL. Der Fehlertext zeigt Run --model auf dieser Oberfläche.
  • Agent SDK: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie model auf Options in TypeScript oder ClaudeAgentOptions(model=...) in Python, und behandeln Sie den strukturierten model_not_found-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.
  • Verwenden Sie einen Alias wie sonnet oder opus anstelle einer vollständigen versionierten ID. Aliase werden zu einem verwalteten Standard aufgelöst, sodass sie nicht veralten. Siehe Modellkonfiguration.
  • Wenn die falsche Modell immer wieder in der CLI 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 .claude/settings.json Ihres Projekts und ~/.claude/settings.json. Entfernen Sie den veralteten Wert und Claude Code fällt auf Ihren Kontostandardwert zurück.
  • Für Google Cloud's Agent Platform-Bereitstellungen siehe Google Cloud's Agent Platform-Fehlerbehebung.

Modell ist keine erkannte Modell-ID

Die Modellzeichenkette, die Sie an einen Modellwechsel übergeben haben, ist kein Modellalias, keine Modell-ID, die diese Claude Code-Version kennt, oder keine ID, die mit claude- beginnt. Die üblichen Ursachen sind ein Tippfehler in der ID, ein Anzeigename wie Sonnet 5, wobei die ID claude-sonnet-5 erwartet wird, oder ein Alias, den nur neuere Claude Code-Versionen erkennen. Claude Code lehnt den Wechsel sofort ab. Vor v2.1.200 speicherte Claude Code die Zeichenkette und schlug beim nächsten Request mit Es gibt ein Problem mit dem ausgewählten Modell fehl.

Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

Der nachfolgende Hinweis nennt den nächsten passenden Alias oder die Modell-ID. Wenn nichts nah genug ist, lautet es stattdessen Run /model to see available models.

Claude Code erzeugt diesen Fehler lokal in dem Moment, in dem der Wechsel angefordert wird, bevor eine API-Anfrage gestellt wird. Er gilt, wenn ein Modell durch die Agent SDK setModel()-Methode oder durch eine App wie die Desktop-App gesetzt wird, die die Claude Code CLI für Sie ausführt.

Was zu tun ist:

  • Führen Sie /model ohne Argument aus, um den Wähler zu öffnen und aus den Modellen auszuwählen, die für Ihr Konto verfügbar sind, dann übergeben Sie den dort angezeigten Alias oder die ID
  • Wenn Sie einen Alias verwendet haben, den eine neuere Claude Code-Version unterstützt, führen Sie claude update aus. Eine vollständige ID, die mit claude- beginnt, besteht diese Überprüfung, auch wenn das Modell neuer ist als Ihre Claude Code-Version, sodass ein Upgrade nicht erforderlich ist.
  • Ein Modell, das vor v2.1.200 gespeichert wurde, wird durch diese Überprüfung nicht repariert. Wenn ein veralteter Wert immer wieder zurückkommt, entfernen Sie ihn aus den unter Es gibt ein Problem mit dem ausgewählten Modell aufgelisteten Speicherorten.
  • Die Überprüfung wird nur auf der Anthropic API ausgeführt. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS und hinter einem LLM-Gateway oder einer benutzerdefinierten ANTHROPIC_BASE_URL definiert Ihr Anbieter oder Gateway die Modellnamen, sodass Claude Code jede Zeichenkette akzeptiert und durchleitet.

Claude Opus ist nicht mit dem Claude Pro-Plan verfügbar

Ihr aktiver Abonnementplan beinhaltet 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 beinhaltet
  • Wenn Sie Ihren Plan kürzlich aktualisiert haben und dies immer noch sehen, führen Sie /logout und dann /login aus. Das gespeicherte Token spiegelt Ihren Plan zum Zeitpunkt der Anmeldung wider, sodass ein Upgrade im Web in einer bestehenden Sitzung erst nach erneuter Authentifizierung wirksam wird.
  • Siehe claude.com/pricing für die Modelle, die jeder Plan beinhaltet

Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt

Ihr Organisationsadministrator hat dieses Modell in der claude.ai-Administratorkonsole deaktiviert, oder es ist durch eine availableModels-Zulassungsliste in verwalteten Einstellungen ausgeschlossen. Wenn das eingeschränkte Modell mit --model, ANTHROPIC_MODEL oder der model-Einstellung gesetzt wurde, ersetzt Claude Code ein zulässiges Modell und fährt fort. Das Eingeben von /model <name> für ein eingeschränktes Modell wird mit Run /model to choose a different model. abgelehnt und die Sitzung behält ihr aktuelles Modell.

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

Claude Code behandelt einen Modellgruppen-Alias, einen von opus, sonnet, haiku oder fable, als Anfrage für diese Gruppe statt für ihre neueste Version. Auf der Anthropic API und auf Claude Platform on AWS wird ein eingeschränkter Gruppen-Alias zur neuesten Version der Gruppe aufgelöst, die Ihre Organisation und die availableModels-Zulassungsliste zulassen, und die Ersetzungsmitteilung nennt diese Version. Claude Code lehnt /model <alias> nur ab, wenn jede Version der Gruppe eingeschränkt ist. Vor v2.1.205 wurde ein Gruppen-Alias basierend auf seiner neuesten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version derselben Gruppe zulässig war.

Was zu tun ist:

  • Führen Sie /model aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind im Wähler verborgen.
  • Wenn das eingeschränkte Modell in --model, ANTHROPIC_MODEL oder dem model-Feld einer Einstellungsdatei gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, sodass die Mitteilung nicht bei jedem Start erneut angezeigt wird
  • Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe Organisationsmodell-Einschränkungen.

thinking.type.enabled wird für dieses Modell nicht unterstützt

Ihre Claude Code-Version ist älter als das Minimum für Sonnet 5, Opus 4.8 oder 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 und starten Sie Claude Code neu. Opus 4.7 benötigt v2.1.111 oder später. Opus 4.8 benötigt v2.1.154 oder später. Sonnet 5 benötigt v2.1.197 oder später
  • Wenn Sie nicht aktualisieren können, führen Sie /model aus und wählen Sie stattdessen Opus 4.6 oder Sonnet 4.6
  • {/* min-version: agent-sdk@0.3.197 */}Wenn Sie dies im Agent SDK treffen, aktualisieren Sie stattdessen das SDK-Paket. Opus 4.8 benötigt TypeScript SDK v0.3.154 oder später und Python SDK v0.2.88 oder später. Sonnet 5 benötigt TypeScript SDK v0.3.197 oder später

Thinking-Budget überschreitet Ausgabelimit

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

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 Cloud's Agent Platform, wenn MAX_THINKING_TOKENS höher als das Ausgabelimit des Anbieters gesetzt ist, oder wenn Plan Mode das Thinking-Budget erhöht.

Was zu tun ist:

Tool-Verwendung oder Thinking-Block-Nichtübereinstimmung

Die Gesprächshistorie 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 dasselbe: Die Abfolge 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:

  • {/* max-version: 2.1.155 */}Wenn Sie Opus 4.7 oder Opus 4.8 verwenden, führen Sie zuerst claude update aus. Versionen vor v2.1.156 können diesen Fehler während normaler Tool-Verwendung auslösen, und /rewind löscht ihn nicht.
  • 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.

Richtlinienverletzung bei Nutzung

Die API lehnte es ab zu antworten, da Inhalte im Gespräch eine Nutzungsrichtlinie-Überprüfung auslösten. Die Nachricht enthält eine Request-ID, die Sie dem Support mitteilen können, wenn Sie glauben, dass die Ablehnung falsch ist.

API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

Die Überprüfung bewertet das gesamte Gespräch, nicht nur Ihre neueste Eingabeaufforderung, sodass das Senden einer neuen Nachricht in derselben Sitzung normalerweise dieselbe Ablehnung erneut auslöst. Dasselbe gilt nach dem Beenden und erneuten Öffnen der Sitzung mit --continue oder --resume, da das Transkript auf der Festplatte immer noch den auslösenden Inhalt enthält. Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry deckt diese Nachricht auch Anfragen ab, die die Sicherheitsmaßnahmen des Modells als Cybersicherheitsthema gekennzeichnet haben. Siehe Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet.

Was zu tun ist:

  • Drücken Sie Esc zweimal oder führen Sie /rewind aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Ablehnung auslöste, und formulieren Sie dann neu oder versuchen Sie einen anderen Ansatz. Siehe Checkpointing.
  • Wenn Sie nicht identifizieren können, welcher Turn es verursacht hat, führen Sie /clear aus, um ein neues Gespräch im selben Projekt zu starten. Ihr vorheriges Gespräch bleibt auf der Festplatte erhalten und ist in /resume verfügbar.
  • Im nicht-interaktiven Modus (-p), wo Rewind nicht verfügbar ist, versuchen Sie es erneut mit einer umformulierten Eingabeaufforderung in einer neuen Sitzung ohne --continue. Richtlinienüberprüfungen variieren je nach Modell, sodass der Wechsel zu einem anderen Modell mit --model die Ablehnung in einigen Fällen auch beheben kann.

Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet

Die Sicherheitsmaßnahmen des Modells haben Inhalte im Gespräch als Cybersicherheitsthema gekennzeichnet. Die Nachricht nennt das Modell, das die Anfrage gekennzeichnet hat:

API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

Die Nachricht verlinkt auf das Cyber Verification Program, das Zugriff für legitime Cybersicherheitsarbeit gewährt. Die Schutzmaßnahme selbst ist serverseitig und stammt vor v2.1.203; diese Version änderte nur die Formulierung der Nachricht und die Seite, auf die sie verlinkt.

Was Sie sehen, hängt von Ihrem Anbieter und Modus ab:

{/* max-version: 2.1.202 */}Vor v2.1.203 lautete die Nachricht <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: gefolgt von einem Ausnahmeantragsformular-Link.

Was zu tun ist:

  • Wenn Ihre Arbeit diesen Inhalt erfordert, beantragen Sie Zugriff durch das Cyber Verification Program
  • Wenn Ihre Anfrage nicht über ein Cybersicherheitsthema war, führen Sie /feedback aus, um das falsch positive Ergebnis zu melden
  • Um in derselben Sitzung weiterzuarbeiten, drücken Sie Esc zweimal oder führen Sie /rewind aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Kennzeichnung auslöste, und versuchen Sie dann einen anderen Ansatz. Siehe Checkpointing.

Installationsfehler

Diese Fehler treten bei der Installation oder Aktualisierung von Claude Code auf, entweder vom Installationsskript, von claude install oder von claude update. Für command not found, PATH-, Berechtigungs- und TLS-Probleme während der Einrichtung siehe Installationen und Anmeldung beheben.

Installation wurde beendet, bevor sie abgeschlossen werden konnte

Das Installationsskript meldet, wenn der claude install-Schritt 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 normalerweise der Kernel-Out-of-Memory (OOM)-Killer. Das Skript gibt diese Erklärung aus und beendet sich mit Code 137:

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Für jedes andere tödliche Signal und für Exit-Code 137 auf 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 vom Installationsskript, das macOS und Linux verwenden, das auch Installationen innerhalb von WSL abdeckt; die nativen Windows-Installationsskripte geben es nie aus. Vor v2.1.200 beendete sich das Skript nur mit der bloßen Killed-Zeile der Shell.

Was zu tun ist:

Die Verbindung wurde während des Download der Aktualisierung unterbrochen

Die Verbindung zum Download-Server wurde geschlossen, während claude install, claude update oder das automatische Update-Programm die Claude Code-Binärdatei abrief, und die Wiederholungen konnten sich nicht erholen. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung steckenbleibt oder die heruntergeladene Datei ihre Prüfsumme nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, wie z. B. ein 404, wird nicht wiederholt, da der Server bereits geantwortet hat. {/* min-version: 2.1.202 */}Vor v2.1.202 führte eine einzelne unterbrochene Verbindung sofort zum Fehlschlag des Downloads mit dem bloßen Fehler aborted statt zu wiederholen.

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

Der Text in Klammern nennt, welcher Versuch fehlgeschlagen ist, und den zugrunde liegenden Netzwerkfehler. claude update stellt der Meldung Error: Failed to install native update auf stderr voran.

Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten abgeschlossen wird, schlägt mit Download timed out: exceeded the total deadline fehl. Claude Code wiederholt einen abgelaufenen Download nicht, da eine Verbindung, die zu langsam ist, um innerhalb der Frist abgeschlossen zu werden, auch bei einer sofortigen Wiederholung nicht abgeschlossen wird. Die folgenden Schritte gelten für beide Meldungen. Vor v2.1.205 wurde die gleiche 10-Minuten-Frist als generischer timeout of 600000ms exceeded des HTTP-Clients gemeldet.

Die übliche Ursache ist ein Proxy oder Gateway, das eine lange Übertragung beendet, bevor sie abgeschlossen ist. Die Claude Code-Binärdatei ist ein großer Download, daher kann eine Proxy-Verbindungsbegrenzung, die normalen API-Verkehr nie beeinträchtigt, dennoch unterbrochen werden.

Was zu tun ist:

  • Führen Sie claude update erneut aus. Bei einem ansonsten gesunden Netzwerk ist der Download normalerweise beim nächsten Durchlauf erfolgreich. Für die Timeout-Meldung führen Sie es erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.
  • Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie HTTPS_PROXY vor dem Ausführen des Installationsprogramms oder claude update. Siehe Netzwerkkonnektivität überprüfen.
  • Wenn ein Unternehmens-Proxy die Übertragung immer wieder beendet, bitten Sie Ihr Netzwerk-Team, den vollständigen Download von downloads.claude.ai zuzulassen. Siehe Netzwerkzugriffsanforderungen.
  • Führen Sie claude doctor aus Ihrer Shell aus, um Installationsdiagnosen durchzuführen

Befehlszeilenfehler

Diese Fehler stammen aus dem claude Befehl und seinen Unterbefehlen. Claude Code gibt sie aus, bevor er Ihren Prompt ausführt oder eine API-Anfrage sendet.

Konflikt zwischen --bg und --print

Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben --bg mit -p oder --print in demselben claude Aufruf kombiniert. --bg startet eine Hintergrundsitzung, an die Sie sich später mit claude agents anschließen, während --print nicht interaktiv ausgeführt wird und niemals die interaktive Sitzung startet, an die sich claude agents anschließt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der niemals angehängt werden konnte.

--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

Was zu tun ist:

  • Lassen Sie -p oder --print weg. --bg nimmt den Prompt als sein Positionsargument, also ist claude --bg "<task>" der vollständige Befehl. Siehe Dispatch new agents from your shell.
  • Um den Prompt nicht interaktiv auszuführen und das Ergebnis auszugeben, anstatt eine Hintergrundsitzung zu erstellen, lassen Sie --bg weg und führen Sie claude -p "<task>" aus

Der --json-schema Wert ist kein gültiges JSON Schema

Das Schema, das Sie an --json-schema im nicht interaktiven Modus übergeben haben, ist bei der JSON Schema Kompilierung fehlgeschlagen, daher beendet sich claude mit Code 1, anstatt den Prompt auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das format Schlüsselwort verwendete, wurde als ungültig behandelt.

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

Der Text nach dem zweiten Doppelpunkt ist die Diagnose des Validators und benennt das Schlüsselwort oder die Position, die fehlgeschlagen ist. Schemas, die das format Schlüsselwort verwenden, wie z. B. "format": "email", sind gültig: Claude Code akzeptiert format als Anmerkung und erzwingt es nicht.

Claude Code führt zwei Überprüfungen vor der Schema-Kompilierung durch: Es lehnt einen Wert ab, der nicht als JSON analysierbar ist, mit Error: --json-schema is not valid JSON ab, und gültiges JSON, das kein Objekt ist, mit Error: --json-schema must be a JSON object.

Was zu tun ist:

  • Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus
  • Wenn die Diagnose schema too large ist, reduzieren Sie die Verschachtelung des Schemas und die $ref Wiederverwendung
  • Siehe Get structured output für ein funktionierendes Schema und einen Befehl

Server konnte nicht aus Claude Desktop importiert werden

Claude Code konnte einen der Server, die Sie in claude mcp add-from-claude-desktop ausgewählt haben, nicht hinzufügen. Der Befehl importiert weiterhin die anderen ausgewählten Server und gibt eine Zeile pro Server aus, den er nicht hinzufügen konnte. Vor v2.1.205 hat der erste Server, der fehlgeschlagen ist, den Import gestoppt und keiner der ausgewählten Server wurde hinzugefügt.

Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

Der Text nach dem Servernamen ist der Grund. Der häufigste ist die Namensüberprüfung: Claude Desktop erlaubt Zeichen in Servernamen, wie Leerzeichen und Punkte, die claude mcp auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Andere Gründe sind eine Serverkonfiguration, die die Validierung nicht besteht, und ein Server, der durch die MCP-Richtlinie Ihrer Organisation blockiert wird.

Was zu tun ist:

  • Benennen Sie den Server in claude_desktop_config.json um, um nur Buchstaben, Zahlen, Bindestriche und Unterstriche zu verwenden, und führen Sie dann claude mcp add-from-claude-desktop erneut aus
  • Fügen Sie diesen Server direkt mit claude mcp add oder claude mcp add-json unter einem gültigen Namen hinzu. Siehe Import MCP servers from Claude Desktop.

Plugin-Fehler

Diese Fehler stammen aus der Plugin- und Marketplace-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe Plugin-Fehlerbehebung.

Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert

Der Marketplace ist unter einem Namen registriert, der für offizielle Anthropic-Marketplaces reserviert ist, aber seine registrierte Quelle ist kein anthropics GitHub-Repository. Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marketplace lädt oder aktualisiert, sodass der Marketplace und die von ihm installierten Plugins nicht mehr geladen werden. Vor v2.1.205 wurde der Name nur überprüft, wenn der Marketplace hinzugefügt wurde, sodass ein Eintrag, der registriert wurde, bevor sein Name reserviert wurde, weiterhin geladen wurde.

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

Was zu tun ist:

  • Führen Sie claude plugin marketplace remove <name> aus und fügen Sie den Marketplace dann erneut aus dem offiziellen github.com/anthropics-Repository hinzu
  • Wenn Sie einen Drittanbieter-Marketplace veröffentlichen, der den Namen verwendet hat, bevor er reserviert wurde, benennen Sie ihn um und bitten Sie Benutzer, ihn von Ihrer Quelle erneut hinzuzufügen
  • Siehe die Liste der reservierten Namen unter Marketplace-Schema

Konfigurationswarnungen

Claude Code schreibt diese Meldungen beim Start in stderr statt einen Fehler im Gespräch anzuzeigen. Sie berichten über Konfigurationen, die gelesen, aber nicht angewendet wurden.

Arbeitsbereich wurde nicht vertraut

Claude Code fand permissions.allow-Regeln oder permissions.additionalDirectories-Einträge in der Datei .claude/settings.json oder .claude/settings.local.json des Projekts und wendete sie nicht an, da Allow-Regeln aus Projekteinstellungen Arbeitsbereichsvertrauen erfordern. Die Anzahl, der Einstellungsname und die in der Meldung genannte Datei variieren je nach Ihrer Konfiguration. deny- und ask-Regeln sind nicht betroffen.

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

Was zu tun ist:

  • Führen Sie claude im Verzeichnis aus und akzeptieren Sie den Vertrauensdialog. {/* min-version: 2.1.200 */}Der Dialog wird auch angezeigt, wenn ein übergeordnetes Verzeichnis bereits vertraut ist, listet die zurückgehaltenen Regeln auf und ermöglicht es Ihnen, abzulehnen und ohne diese weiterzuarbeiten. Vor v2.1.200 wurde in dieser Situation kein Dialog angezeigt, daher konnte dieser Schritt dort nicht abgeschlossen werden.
  • Im nicht-interaktiven Modus mit -p wird kein Dialog angezeigt. Legen Sie den hasTrustDialogAccepted-Eintrag in ~/.claude.json mit dem genauen projects-Schlüssel fest, den die Meldung ausgibt.
  • {/* min-version: 2.1.200 */}Wenn die Meldung .claude/settings.local.json nennt und Sie Claude Code außerhalb eines Git-Repositorys oder in Ihrem Home-Verzeichnis gestartet haben, aktualisieren Sie auf v2.1.200 oder später. Die Versionen 2.1.196 bis 2.1.199 behandelten Ihre eigene .claude/settings.local.json in diesen Arbeitsbereichen als vom Repository bereitgestellt. Siehe Project allow rules and workspace trust.

Antworten scheinen von geringerer Qualität als üblich

Wenn Claudes Antworten weniger leistungsfähig erscheinen als erwartet, aber kein Fehler angezeigt wird, liegt die Ursache normalerweise im Gesprächszustand und nicht im Modell selbst. Claude Code ändert nicht stillschweigend Modellversionen. Es kann in drei spezifischen Fällen zu einem Fallback-Modell wechseln:

  • Ein konfiguriertes --fallback-model übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript
  • Eine Amazon Bedrock oder Google Cloud Agent Platform Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist
  • Automatisches Modell-Fallback auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Notiz im Transkript an

Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als /model-Änderung. Modellkonfiguration erklärt, wann jedes Fallback gilt.

Überprüfen Sie diese zuerst:

  • Modellauswahl: Führen Sie /model aus, um zu bestätigen, dass Sie sich auf dem erwarteten Modell befinden. Eine vorherige /model-Auswahl oder eine ANTHROPIC_MODEL-Umgebungsvariable könnte Sie auf einem kleineren Modell als beabsichtigt platzieren.
  • Anstrengungsgrad: Führen Sie /effort aus, um die aktuelle Reasoning-Ebene zu überprüfen und sie für schwieriges Debugging oder Designarbeit zu erhöhen. Die Standardwerte variieren je nach Modell, daher überprüfen Sie, bevor Sie davon ausgehen, dass Sie unter dem Maximum liegen. Siehe Anstrengungsgrad anpassen für modellspezifische 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 Erkunden Sie das Kontextfenster, um zu erfahren, wie Auto-Compact frühere Züge beeinflusst.
  • Veraltete Anweisungen: Große oder veraltete CLAUDE.md-Dateien und MCP-Tool-Definitionen verbrauchen Kontext und können Antworten lenken. {/* min-version: 2.1.205 */}Die /doctor-Überprüfung kennzeichnet übergroße Speicherdateien und ungenutzte Erweiterungen, und /context zeigt die Token-Nutzung von MCP-Tools. Vor v2.1.205 öffnete /doctor einen Diagnosebildschirm, der übergroße Speicherdateien und Subagent-Definitionen kennzeichnete.

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

Wenn die Qualität nach Überprüfung der obigen Punkte immer noch schlecht erscheint, führen Sie /feedback aus und beschreiben Sie, was Sie erwartet haben im Vergleich zu dem, was Sie erhalten haben. Auf diese Weise eingereichte Rückmeldungen enthalten das Gesprächstranskript, das die schnellste Möglichkeit für Anthropic ist, eine echte Regression zu diagnostizieren. Siehe Fehler melden, wenn /feedback in Ihrer Umgebung nicht verfügbar ist.

{/* min-version: 2.1.201 */}Wenn Sonnet 5 eine Anfrage ablehnt und eine vermutete Prompt-Injection auf Claude Code v2.1.200 oder früher anführt, führen Sie claude update aus, um die v2.1.201-Korrektur zu erhalten.

Fehler melden

Für Fehler von Komponenten, die auf dieser Seite nicht behandelt werden, siehe die relevanten Anleitungen:

Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung 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-Issue zu öffnen. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen speichert /feedback ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.
  • Führen Sie claude doctor aus Ihrer Shell aus, um eine schreibgeschützte Diagnose Ihrer Installation zu erhalten, oder führen Sie die /doctor-Überprüfung in Claude Code aus, um Setup-Probleme zu finden und zu beheben
  • Überprüfen Sie status.claude.com auf aktive Vorfälle
  • Suchen Sie nach bestehenden Issues auf GitHub