21Ordnen Sie die Meldung, die Sie in Ihrem Terminal sehen, einem Abschnitt unten zu.21Ordnen Sie die Meldung, die Sie in Ihrem Terminal sehen, einem Abschnitt unten zu.
22 22
23| Meldung | Abschnitt |23| Meldung | Abschnitt |
24| :-------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |24| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
25| `API Error: 500 Internal server error` | [Serverfehler](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Serverfehler](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [Serverfehler](#request-timed-out), oder [Netzwerk](#unable-to-connect-to-api) wenn die Meldung Ihre Internetverbindung erwähnt |27| `Request timed out` | [Serverfehler](#request-timed-out), oder [Netzwerk](#unable-to-connect-to-api) wenn die Meldung Ihre Internetverbindung erwähnt |
39| `Not logged in · Please run /login` | [Authentifizierung](#not-logged-in) |39| `Not logged in · Please run /login` | [Authentifizierung](#not-logged-in) |
40| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [Authentifizierung](#invalid-api-key) |41| `Invalid API key` | [Authentifizierung](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [Authentifizierung](#your-apikeyhelper-script-is-failing) |
42| `This organization has been disabled` | [Authentifizierung](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [Authentifizierung](#this-organization-has-been-disabled) |
43| `Your organization has disabled API key authentication` | [Authentifizierung](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [Authentifizierung](#your-organization-has-disabled-api-key-authentication) |
44| `Your organization has disabled Claude subscription access` | [Authentifizierung](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [Authentifizierung](#your-organization-has-disabled-claude-subscription-access) |
45| `Routines are disabled by your organization's policy` | [Authentifizierung](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [Authentifizierung](#routines-are-disabled-by-your-organizations-policy) |
46| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentifizierung](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentifizierung](#remote-control-requires-the-anthropic-api) |
47| `OAuth token revoked` / `OAuth token has expired` | [Authentifizierung](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [Authentifizierung](#oauth-token-revoked-or-expired) |
49| `Login expired · Please run /login` | [Authentifizierung](#login-expired) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentifizierung](#login-expired) |
48| `does not meet scope requirement user:profile` | [Authentifizierung](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [Authentifizierung](#oauth-scope-requirement) |
49| `AWS credentials expired or invalid` | [Authentifizierung](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [Authentifizierung](#aws-credentials-expired-or-invalid) |
50| `AWS authentication failed` | [Authentifizierung](#aws-authentication-failed) |53| `AWS authentication failed` | [Authentifizierung](#aws-authentication-failed) |
54| `AWS default-chain credential resolve timed out` | [Authentifizierung](#aws-default-chain-credential-resolve-timed-out) |
51| `Unable to connect to API` | [Netzwerk](#unable-to-connect-to-api) |55| `Unable to connect to API` | [Netzwerk](#unable-to-connect-to-api) |
52| `Waiting for API response · will retry in` | [Automatische Wiederholungen](#automatic-retries), oder [Netzwerk](#unable-to-connect-to-api) wenn es anhält |56| `Waiting for API response · will retry in` | [Automatische Wiederholungen](#automatic-retries), oder [Netzwerk](#unable-to-connect-to-api) wenn es anhält |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Netzwerk](#bedrock-streaming-response-has-an-unexpected-content-type) |
53| `SSL certificate verification failed` | [Netzwerk](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [Netzwerk](#ssl-certificate-errors) |
54| `SSL certificate error (...)` during login or startup | [Netzwerk](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [Netzwerk](#ssl-certificate-errors) |
55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Netzwerk](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Netzwerk](#host-not-allowed-in-a-cloud-session) |
76| `--bg and --print conflict` | [Befehlszeilenfehler](#command-line-errors) |81| `--bg and --print conflict` | [Befehlszeilenfehler](#command-line-errors) |
77| `Error: --json-schema is not a valid JSON Schema` | [Befehlszeilenfehler](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [Befehlszeilenfehler](#command-line-errors) |
78| `Could not import <server>: <reason>` | [Befehlszeilenfehler](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [Befehlszeilenfehler](#could-not-import-a-server-from-claude-desktop) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Befehlszeilenfehler](#mcp-permission-prompt-tool-not-found) |
79| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [Plugin-Fehler](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin-Fehler](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin-Fehler](#plugin-command-references-user-config) |
89| `would be spawned with zero tools — refusing` | [Werkzeugfehler](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [Werkzeugfehler](#file-is-covered-by-a-read-deny-rule) |
91| `Can't open MCP settings in a background session` | [Fehler in Hintergrundsitzungen](#commands-refused-in-a-background-session) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Fehler in Hintergrundsitzungen](#claude_code_process_wrapper-launcher-errors) |
80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Konfigurationswarnungen](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Konfigurationswarnungen](#workspace-has-not-been-trusted) |
81| Responses seem lower quality than usual | [Antwortqualität](#responses-seem-lower-quality-than-usual) |94| Responses seem lower quality than usual | [Antwortqualität](#responses-seem-lower-quality-than-usual) |
82 95
86 99
87Claude 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.100Claude 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.
88 101
89Zwei Fehlerklassen werden nicht wiederholt, da eine Wiederholung nicht erfolgreich sein kann:102Einige Fehlerklassen werden nicht wiederholt, da eine Wiederholung nicht erfolgreich sein kann:
90 103
91* {/* 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](#ssl-certificate-errors). Vorübergehende TLS-Bedingungen wie ein Handshake-Timeout werden weiterhin wiederholt.104* {/* 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](#ssl-certificate-errors). Vorübergehende TLS-Bedingungen wie ein Handshake-Timeout werden weiterhin wiederholt.
92* {/* 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](#the-response-above-may-be-incomplete) 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.105* {/* 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](#the-response-above-may-be-incomplete) an, anstatt zu wiederholen, da das erneute Ausführen der Anfrage die gleichen Tools zweimal ausführen könnte. Frühere Versionen verwarfen die Teilausgabe und meldeten den Turn als Fehler.
106* {/* min-version: 2.1.208 */}Eine [Amazon Bedrock Streaming-Antwort mit einem unerwarteten Content-Type](#bedrock-streaming-response-has-an-unexpected-content-type) schlägt beim ersten Versuch fehl, da das Gateway oder der Proxy, der die Antwort umschreibt, die Wiederholung auf die gleiche Weise umschreiben würde. Erfordert Claude Code v2.1.208 oder später.
93 107
94Wä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.108Wä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.
95 109
285 299
286Claude Code blockiert weitere Anfragen bis zum in der Meldung angezeigten Zurücksetzzeitpunkt. Die Sitzungs- und Wochenlimits werden über alle Modelle hinweg gemeinsam genutzt, daher stellt das Wechseln von Modellen den Zugriff nicht wieder her. Das Opus-Limit gilt nur für Opus-Anfragen, daher können Sie mit `/model` zu einem anderen Modell wechseln und weiterarbeiten.300Claude Code blockiert weitere Anfragen bis zum in der Meldung angezeigten Zurücksetzzeitpunkt. Die Sitzungs- und Wochenlimits werden über alle Modelle hinweg gemeinsam genutzt, daher stellt das Wechseln von Modellen den Zugriff nicht wieder her. Das Opus-Limit gilt nur für Opus-Anfragen, daher können Sie mit `/model` zu einem anderen Modell wechseln und weiterarbeiten.
287 301
302Die Nutzung wird gleichzeitig gegen die Sitzungs- und Wochenzuteilungen angerechnet. Ein einzelner Ausbruch intensiver Aktivität, wie z. B. ein großer Workflow-Fanout, kann die Wochenzuteilung aufbrauchen, bevor sich das Sitzungsfenster zurückgesetzt hat.
303
288**Was Sie tun können:**304**Was Sie tun können:**
289 305
290* Warten Sie auf den im Fehler angezeigten Zurücksetzzeitpunkt306* Warten Sie auf den im Fehler angezeigten Zurücksetzzeitpunkt
430* Wenn der Schlüssel von einem [`apiKeyHelper`](/de/settings#available-settings)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt446* Wenn der Schlüssel von einem [`apiKeyHelper`](/de/settings#available-settings)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt
431* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle Claude Code tatsächlich verwendet447* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle Claude Code tatsächlich verwendet
432 448
449<h3 id="your-apikeyhelper-script-is-failing">
450 Ihr apiKeyHelper-Skript schlägt fehl
451</h3>
452
453Der in der [`apiKeyHelper`](/de/settings#available-settings)-Einstellung konfigurierte Befehl ist mit einem Fehler beendet worden, hat das Zeitlimit überschritten oder hat nichts auf stdout ausgegeben. Ohne einen Schlüssel vom Skript erreicht die Anfrage die API mit einer Platzhalter-Anmeldedaten, und die API lehnt sie mit `401` ab.
454
455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```
458
459Claude Code führt das Skript erneut aus und versucht die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, daher wird der Fehler innerhalb von drei Versuchen angezeigt. {/* min-version: 2.1.208 */}Vor v2.1.208 verbrauchte Claude Code das gesamte [Wiederholungsbudget](#automatic-retries) beim erneuten Senden der Anfrage mit der Platzhalter-Anmeldedaten und meldete dann einen generischen `401`-Authentifizierungsfehler anstelle des Skriptfehlers.
460
461Das Ausführen von `/login` hilft hier nicht: die Ausgabe des Helfers [hat Vorrang](/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.
462
463**Was zu tun ist:**
464
465* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren
466* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, z. B. indem Sie sich erneut bei Ihrem SSO oder Ihrem Secrets-Tresor anmelden
467* Beheben Sie den Befehl so, dass er den Schlüssel auf stdout ausgibt und mit Code 0 beendet wird. Siehe [Anmeldedaten mit apiKeyHelper rotieren](/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) für ein funktionierendes Setup.
468* Führen Sie `/status` aus, um zu bestätigen, dass `apiKeyHelper` die aktive Anmeldedatenquelle ist. Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und die Fehlerausgabe in einem `Cloud authentication`-Panel im Terminal.
469
433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
434 Diese Organisation wurde deaktiviert471 Diese Organisation wurde deaktiviert
435</h3>472</h3>
532 569
533Ihre 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.570Ihre 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.
534 571
572Beide Meldungen melden eine Ablehnung, die die API für eine Anfrage zurückgegeben hat, die Claude Code gesendet hat. Wenn die gespeicherte Anmeldung bereits nach einer fehlgeschlagenen Aktualisierung gelöscht wurde, sehen Sie stattdessen [Anmeldung abgelaufen](#login-expired).
573
535```text theme={null}574```text theme={null}
536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login
537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login
545* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS-Keychain-Prüfungen in [Fehlerbehebung](/de/troubleshoot-install#not-logged-in-or-token-expired)584* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS-Keychain-Prüfungen in [Fehlerbehebung](/de/troubleshoot-install#not-logged-in-or-token-expired)
546* Für andere Fehler einschließlich `403 Forbidden` und OAuth-Browser-Probleme siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)585* Für andere Fehler einschließlich `403 Forbidden` und OAuth-Browser-Probleme siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)
547 586
587<h3 id="login-expired">
588 Anmeldung abgelaufen
589</h3>
590
591Claude Code versuchte, Ihre gespeicherte claude.ai- oder Claude-Console-Anmeldung zu erneuern, und der OAuth-Dienst lehnte das gespeicherte Aktualisierungs-Token ab, daher löschte Claude Code die gespeicherten Anmeldedaten. Danach stoppt jede Anfrage lokal, bevor sie die API erreicht, da nur `/login` neue Anmeldedaten erstellen kann. {/* min-version: 2.1.206 */}Vor v2.1.206 sendete Claude Code die Anfrage trotzdem mit allen verbleibenden Anmeldedaten in der Umgebung, und dann schlugen alle Modelle mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 anstelle einer Aufforderung zur Anmeldung fehl.
592
593```text theme={null}
594Login expired · Please run /login
595```
596
597Im [nicht-interaktiven Modus](/de/headless) (`-p`) und dem [Agent SDK](/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:
598
599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed
601```
602
603Dies ist nicht derselbe Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Diese Meldungen melden einen 401, den die API zurückgegeben hat. Claude Code selbst erzeugt `Login expired` für eine Anmeldung, die es bereits nicht erneuern konnte, daher sendet es keine Anfrage.
604
605Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/de/env-vars) oder einem Drittanbieter authentifiziert sind, verwenden nicht die gespeicherte Anmeldung und sehen diese Meldung nie.
606
607**Was zu tun ist:**
608
609* Führen Sie `/login` aus, um sich erneut anzumelden. Das erneute Versuchen ohne Anmeldung zeigt dieselbe Meldung bei jeder Anfrage.
610* Im nicht-interaktiven Modus führen Sie `claude` in derselben Umgebung aus, schließen Sie `/login` ab, dann führen Sie Ihren Befehl erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [generieren Sie ein langlebiges Token mit `claude setup-token`](/de/authentication#generate-a-long-lived-token).
611* Wenn die Anmeldung weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)
612
548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
549 OAuth-Bereichsanforderung614 OAuth-Bereichsanforderung
550</h3>615</h3>
603* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie, dass die IAM-Berechtigungen in [IAM-Konfiguration](/de/amazon-bedrock#iam-configuration) an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist668* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie, dass die IAM-Berechtigungen in [IAM-Konfiguration](/de/amazon-bedrock#iam-configuration) 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
604* 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 Berechtigungskonflikt669* 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
605 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 AWS-Standard-Chain-Anmeldedaten-Auflösung hat das Zeitlimit überschritten
673</h3>
674
675Der AWS-Standard-Anmeldedaten-Provider-Chain hat keine Anmeldedaten innerhalb von 60 Sekunden erzeugt, daher stoppte Claude Code die Auflösung und schlugen die Anfrage fehl. Der Fehler ist lokale Anmeldedaten-Auflösung: die Anfrage erreichte nie [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws) oder den [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint). Claude Code löscht seinen [Anmeldedaten-Cache](/de/amazon-bedrock#credential-caching-and-resolution-timeout) und versucht erneut, bevor dieser Fehler angezeigt wird, daher hat die Chain bei wiederholten Versuchen stagniert, wenn Sie ihn sehen.
676
677```text theme={null}
678API Error: AWS default-chain credential resolve timed out
679```
680
681Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf Eingaben wartet, die er nicht erhalten kann, und ein Container oder eine VM, deren Instance-Metadaten-Dienst (IMDS) nie auf die Sonde der Chain antwortet. {/* min-version: 2.1.207 */}Vor v2.1.207 ließ eine stagnierte Chain die Anfrage auf unbestimmte Zeit warten, anstatt mit dieser Meldung fehlzuschlagen.
682
683**Was zu tun ist:**
684
685* Führen Sie `aws sts get-caller-identity` in derselben Shell mit demselben `AWS_PROFILE` aus. Wenn es auch hängt, beheben Sie das Profil; ein `credential_process`-Befehl, der interaktiv auffordert, ist eine häufige Ursache.
686* Schließen Sie den Anmeldeschritt ab, bevor Sie Claude Code starten, z. B. `aws sso login --profile myprofile`, damit die Chain aus dem lokalen SSO-Cache aufgelöst wird, anstatt auf einen Browser-Flow zu warten
687* Wenn Ihre Chain eine interaktive Anmeldung ausführt, die legitim mehr als 60 Sekunden benötigt, z. B. SSO mit MFA durch einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/de/env-vars)
688
606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
607 Netzwerk- und Verbindungsfehler690 Netzwerk- und Verbindungsfehler
608</h2>691</h2>
609 692
610Diese 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.693Diese Fehler bedeuten, dass eine Netzwerkanfrage von Claude Code ihr Ziel nicht erreicht hat, oder etwas zwischen Claude Code und der API hat die Antwort auf dem Rückweg verändert. Sie entstehen normalerweise in Ihrem lokalen Netzwerk, Proxy oder Firewall oder in der Netzwerkrichtlinie der Cloud-Umgebung.
611 694
612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">
613 Verbindung zur API nicht möglich696 Verbindung zur API nicht möglich
640* 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.723* 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.
641* Docker Desktop und ähnliche Container-Laufzeiten können ausgehenden Datenverkehr abfangen. Beenden Sie diese und versuchen Sie es erneut, um dies auszuschließen.724* Docker Desktop und ähnliche Container-Laufzeiten können ausgehenden Datenverkehr abfangen. Beenden Sie diese und versuchen Sie es erneut, um dies auszuschließen.
642 725
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
727 Bedrock-Streaming-Antwort hat einen unerwarteten Content-Type
728</h3>
729
730Ein Gateway oder Proxy zwischen Claude Code und [Amazon Bedrock](/de/amazon-bedrock) transformiert den Streaming-Antwortkörper oder seinen `Content-Type`-Header. Amazon Bedrock streamt Antworten als `application/vnd.amazon.eventstream`, und Claude Code lehnt eine erfolgreiche Streaming-Antwort ab, die einen anderen Content-Type meldet, anstatt einen Körper zu dekodieren, den es nicht lesen kann. Die Anfrage wird nicht wiederholt.
731
732```text theme={null}
733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
734```
735
736{/* min-version: 2.1.208 */}Vor v2.1.208 zeigte sich dieselbe Fehlkonfiguration als `API Error: Truncated event message received`, nachdem die gesamte Antwort gepuffert worden war.
737
738**Was zu tun ist:**
739
740* Konfigurieren Sie das Gateway so, dass der `InvokeModelWithResponseStream`-Antwortkörper und sein `Content-Type`-Header unverändert weitergeleitet werden. Ein Vermittler, der den Stream als Server-Sent Events erneut aussendet, ist eine häufige Ursache.
741* Wenn das Gateway nur den Header umschreibt und den binären Körper intakt weitergeleitet, setzen Sie [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/de/env-vars), um die Überprüfung zu überspringen, bis das Gateway behoben ist. Siehe [Streaming-Fehler hinter einem Gateway oder Proxy](/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742
643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
644 SSL-Zertifikatsfehler744 SSL-Zertifikatsfehler
645</h3>745</h3>
859* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.959* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.
860* 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](/de/model-config).960* 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](/de/model-config).
861* Wenn die falsche Modell immer wieder in der CLI zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in [Prioritätsreihenfolge](/de/model-config#setting-your-model): 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.961* Wenn die falsche Modell immer wieder in der CLI zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in [Prioritätsreihenfolge](/de/model-config#setting-your-model): 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.
962* {/* min-version: 2.1.206 */}Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als dieser Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das auf einer älteren Version sehen.
862* Für Google Cloud's Agent Platform-Bereitstellungen siehe [Google Cloud's Agent Platform-Fehlerbehebung](/de/google-vertex-ai#troubleshooting).963* Für Google Cloud's Agent Platform-Bereitstellungen siehe [Google Cloud's Agent Platform-Fehlerbehebung](/de/google-vertex-ai#troubleshooting).
863 964
864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
1070 Konflikt zwischen --bg und --print1171 Konflikt zwischen --bg und --print
1071</h3>1172</h3>
1072 1173
1073Diese 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](/de/agent-view#from-your-shell), an die Sie sich später mit `claude agents` anschließen, während `--print` [nicht interaktiv](/de/headless) 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.1174Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben `--bg` mit `-p` oder `--print` in derselben `claude` Invokation kombiniert. `--bg` startet eine [Hintergrundsitzung](/de/agent-view#from-your-shell), die Sie später mit `claude agents` anfügen, während `--print` [nicht interaktiv](/de/headless) ausgeführt wird und niemals die interaktive Sitzung startet, die `claude agents` anfügt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der niemals angefügt werden konnte.
1074 1175
1075```text theme={null}1176```text theme={null}
1076--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>'`.1177--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>'`.
1078 1179
1079**Was zu tun ist:**1180**Was zu tun ist:**
1080 1181
1081* 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](/de/agent-view#from-your-shell).1182* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt den Prompt als sein Positionsargument, also ist `claude --bg "<task>"` der vollständige Befehl. Siehe [Neue Agenten von Ihrer Shell aus versenden](/de/agent-view#from-your-shell).
1082* 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>"` aus1183* Um den Prompt nicht interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrundsitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus
1083 1184
1084<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
1085 Der --json-schema Wert ist kein gültiges JSON Schema1186 Der --json-schema Wert ist kein gültiges JSON Schema
1091Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1092```1193```
1093 1194
1094Der 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.1195Der 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 `"format": "email"`, sind gültig: Claude Code akzeptiert `format` als Anmerkung und erzwingt es nicht.
1095 1196
1096Claude 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`.1197Claude 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`, und gültiges JSON, das kein Objekt ist, mit `Error: --json-schema must be a JSON object`.
1097 1198
1098**Was zu tun ist:**1199**Was zu tun ist:**
1099 1200
1100* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus1201* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus
1101* Wenn die Diagnose `schema too large` ist, reduzieren Sie die Verschachtelung des Schemas und die `$ref` Wiederverwendung1202* Wenn die Diagnose `schema too large` ist, reduzieren Sie die Verschachtelung des Schemas und die `$ref` Wiederverwendung
1102* Siehe [Get structured output](/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl1203* Siehe [Strukturierte Ausgabe abrufen](/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl
1103 1204
1104<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1105 Server konnte nicht aus Claude Desktop importiert werden1206 Konnte keinen Server aus Claude Desktop importieren
1106</h3>1207</h3>
1107 1208
1108Claude 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.1209Claude 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.
1116**Was zu tun ist:**1217**Was zu tun ist:**
1117 1218
1118* 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 aus1219* 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
1119* 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](/de/mcp#import-mcp-servers-from-claude-desktop).1220* Fügen Sie diesen Server direkt mit `claude mcp add` oder `claude mcp add-json` unter einem gültigen Namen hinzu. Siehe [MCP-Server aus Claude Desktop importieren](/de/mcp#import-mcp-servers-from-claude-desktop).
1221
1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 MCP-Berechtigungsprompt-Tool nicht gefunden
1224</h3>
1225
1226Das Tool, das Sie an [`--permission-prompt-tool`](/de/cli-reference#cli-flags) übergeben haben, war nicht unter den verbundenen MCP-Tools, als der Lauf zum ersten Mal eine Berechtigungsentscheidung benötigte, entweder weil sein Server sich nie verbunden hat oder weil kein verbundener Server ein Tool mit diesem Namen verfügbar macht. Claude Code sendet Ihren Prompt weiterhin: Der [nicht interaktive](/de/headless) Lauf beendet sich mit diesem Fehler und Exit-Code 1 beim ersten Tool-Aufruf, der Genehmigung benötigt, daher wird keine Antwort erzeugt, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zu 30 Sekunden auf das pro-Server-Verbindungs-Timeout, das durch [`MCP_TIMEOUT`](/de/env-vars) festgelegt ist, damit sich dieser Server verbindet. {/* min-version: 2.1.206 */}Vor v2.1.206 hat der Start nicht auf das Beenden der Serververbindung gewartet, daher hat ein langsam startender, aber funktionierender Server auch diesen Fehler erzeugt.
1227
1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1230```
1231
1232Die Liste nach `Available MCP tools:` benennt die MCP-Tools, die verbunden waren, als das Warten endete.
1233
1234**Was zu tun ist:**
1235
1236* Überprüfen Sie, dass der Server startet und verbunden bleibt: Führen Sie `claude mcp list` im selben Verzeichnis aus und bestätigen Sie, dass der Server als verbunden aufgelistet ist
1237* Bestätigen Sie, dass der Tool-Name dem `mcp__<server>__<tool>` Namen entspricht, den der Server verfügbar macht
1238* Wenn der Server länger als 30 Sekunden zum Starten benötigt, erhöhen Sie [`MCP_TIMEOUT`](/de/env-vars)
1120 1239
1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1122 Plugin-Fehler1241 Plugin-Fehler
1123</h2>1242</h2>
1124 1243
1125Diese Fehler stammen aus der [Plugin](/de/plugins)- und [Marketplace](/de/plugin-marketplaces)-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](/de/discover-plugins#troubleshooting).1244Diese Fehler stammen aus der [Plugin](/de/plugins)- und [Marketplace](/de/plugin-marketplaces)-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, wie z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe [Plugin-Fehlerbehebung](/de/discover-plugins#troubleshooting).
1126 1245
1127<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">
1128 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert1247 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert
1140* 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ügen1259* 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
1141* Siehe die Liste der reservierten Namen unter [Marketplace-Schema](/de/plugin-marketplaces#marketplace-schema)1260* Siehe die Liste der reservierten Namen unter [Marketplace-Schema](/de/plugin-marketplaces#marketplace-schema)
1142 1261
1262<h3 id="plugin-command-references-user-config">
1263 Plugin-Befehl referenziert user\_config in einem Shell-Befehl
1264</h3>
1265
1266Ein Plugin-Hook, [monitor](/de/plugins-reference#monitors), oder MCP [`headersHelper`](/de/mcp#use-dynamic-headers-for-custom-authentication)-Befehl referenziert eine `${user_config.KEY}` [Plugin-Option](/de/plugins-reference#user-configuration), und die ersetzte Zeichenkette würde an eine Shell übergeben. Ein konfigurierter Wert, der `$(...)`, Backticks oder `;` enthält, würde dort als Code ausgeführt, daher weigert sich Claude Code, die Komponente zu starten, anstatt den Wert zu ersetzen. Die Überprüfung wird auf der Befehlsvorlage ausgeführt, daher wird der Fehler angezeigt, auch wenn noch kein Wert konfiguriert ist. Vor v2.1.207 wurde der Wert in den Shell-Befehl eingesetzt.
1267
1268Die Formulierung hängt davon ab, welche Oberfläche die Option referenziert hat. Ein Shell-Form-Hook meldet:
1269
1270```text theme={null}
1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
1272```
1273
1274Ein Monitor meldet:
1275
1276```text theme={null}
1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
1278```
1279
1280Ein MCP `headersHelper` meldet:
1281
1282```text theme={null}
1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
1284```
1285
1286**Was zu tun ist:**
1287
1288* Für einen Hook fügen Sie ein `args`-Array hinzu, damit es in [Exec-Form](/de/hooks#exec-form-and-shell-form) ausgeführt wird, wobei jedes `${user_config.KEY}` zu einem Argument wird, ohne dass eine Shell dazwischen liegt. Oder lassen Sie die Referenz weg und lesen Sie die `$CLAUDE_PLUGIN_OPTION_<KEY>`-Umgebungsvariable innerhalb des Skripts
1289* Für einen Monitor lassen Sie die Referenz weg und lassen Sie das Monitor-Skript den Wert aus einer Konfigurationsdatei lesen
1290* Für einen `headersHelper` verschieben Sie `${user_config.KEY}` in das `headers`-Feld des Servers, das nicht shell-geparst wird, oder lesen Sie den Wert innerhalb des Helper-Skripts
1291
1292<h2 id="tool-errors">
1293 Werkzeugfehler
1294</h2>
1295
1296Diese Fehler entstehen, wenn Claude's integrierte Werkzeuge eine Eingabe ablehnen. Claude korrigiert die meisten Werkzeugfehler automatisch; die beiden folgenden erfordern eine Änderung von Ihnen, da sie aus einer Subagent-Definition oder einer Berechtigungsregel stammen, die Sie kontrollieren.
1297
1298<h3 id="agent-would-be-spawned-with-zero-tools">
1299 Agent würde mit null Werkzeugen erzeugt
1300</h3>
1301
1302Nichts in der [Werkzeugliste eines Subagent's](/de/sub-agents#supported-frontmatter-fields) wurde zu einem Werkzeug aufgelöst, daher weigert sich Claude Code, den Subagent zu starten, anstatt einen zu starten, der nicht handeln kann. Die Meldung gruppiert die Einträge danach, warum sie nicht aufgelöst wurden: kein erkanntes Werkzeug, ein Werkzeug, das für Subagents nicht verfügbar ist, oder erkannt, aber kein Werkzeug in der aktuellen Sitzung entsprechend. Das Weglassen des `tools`-Feldes löst diese Ablehnung niemals aus. Ein MCP-Servermuster wie `mcp__github__*` ist nicht ausgenommen: Wenn kein verbundenes Werkzeug von diesem Server stammt, wird der Start mit dem Muster in der Gruppe „nichts gefunden" abgelehnt. Vor v2.1.208 wurde der Subagent mit null Werkzeugen gestartet und gab ein leeres oder verwirrendes Ergebnis zurück.
1303
1304```text theme={null}
1305Agent 'code-reviewer' würde mit null Werkzeugen erzeugt — Ablehnung. Seine Werkzeugliste wurde zu nichts aufgelöst: unerkannt [Grpe]. Korrigieren Sie die Werkzeuge-Frontmatter des Agenten oder übergeben Sie einen anderen subagent_type.
1306```
1307
1308**Was zu tun ist:**
1309
1310* Korrigieren Sie jeden Eintrag, den der Fehler gegen die [für Subagents verfügbaren Werkzeuge](/de/sub-agents#available-tools) benennt
1311* Entfernen Sie Einträge für Werkzeuge, die die Sitzung nicht hat, wie MCP-Werkzeuge von einem Server, der nicht verbunden ist
1312* Um dem Subagent jedes Werkzeug zu geben, das der übergeordnete Agent hat, löschen Sie stattdessen das `tools`-Feld, anstatt Werkzeuge aufzulisten
1313
1314<h3 id="file-is-covered-by-a-read-deny-rule">
1315 Datei wird durch eine Read-Ablehnungsregel abgedeckt
1316</h3>
1317
1318Das Edit-Werkzeug wurde auf einem Pfad aufgerufen, der einer [`Read`-Ablehnungsregel](/de/permissions#read-and-edit) entspricht, einschließlich der Erstellung einer neuen Datei in diesem Pfad. Das Bearbeiten schreibt Inhalte um, die Claude zurücklesen können muss, daher wird der Aufruf vor jedem Dateizugriff abgelehnt. Die Regel blockiert nur das Edit-Werkzeug: Write und NotebookEdit werden nicht durch `Read`-Ablehnungsregeln abgedeckt. Vor v2.1.208 blockierten nur eine `Edit`-Ablehnungsregel Bearbeitungen, und eine `Read`-Ablehnungsregel allein tat dies nicht.
1319
1320```text theme={null}
1321Die Datei wird durch eine Read-Ablehnungsregel in Ihren Berechtigungseinstellungen abgedeckt und kann nicht bearbeitet werden.
1322```
1323
1324**Was zu tun ist:**
1325
1326* Wenn Claude die Datei bearbeiten können soll, entfernen oder verengen Sie die `Read`-Ablehnungsregel in `/permissions` oder in [Einstellungen](/de/settings#permission-settings)
1327* Wenn die Datei unverändert bleiben muss, behalten Sie die Regel und fügen Sie eine `Edit`-Ablehnungsregel für denselben Pfad hinzu, damit die Write- und NotebookEdit-Werkzeuge ebenfalls blockiert werden
1328
1329<h2 id="background-session-errors">
1330 Fehler in Hintergrund-Sitzungen
1331</h2>
1332
1333[Hintergrund-Sitzungen](/de/agent-view) laufen ohne ein eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, in der Agent-Ansicht oder nach dem Anhängen.
1334
1335<h3 id="commands-refused-in-a-background-session">
1336 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden
1337</h3>
1338
1339Befehle, die einen interaktiven Dialog öffnen, werden in einer Hintergrund-Sitzung mit einer Meldung abgelehnt, die entweder ein dort funktionierendes Formular benennt oder Ihnen mitteilt, den Befehl von einem regulären Terminal aus auszuführen. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü werden alle auf diese Weise abgelehnt. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung.
1340{/* max-version: 2.1.208 */}In v2.1.208 nur wurde die `/model`-Auswahl auch in einer Hintergrund-Sitzung abgelehnt, und `/upgrade` gab die Upgrade-URL aus, anstatt einen Browser zu öffnen.
1341
1342Die Formulierung benennt den Befehl, der abgelehnt wurde. Die `/mcp`-Einstellungsliste meldet:
1343
1344```text theme={null}
1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.
1346```
1347
1348**Was zu tun ist:**
1349
1350* Verwenden Sie das Formular, das die Meldung benennt, wie `/mcp reconnect <server>`, `/mcp enable` oder `/mcp disable`
1351* Für Anmelde- und Autorisierungsabläufe führen Sie den Befehl von einer regulären `claude`-Sitzung in einem Terminal aus
1352
1353<h3 id="claude_code_process_wrapper-launcher-errors">
1354 CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler
1355</h3>
1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/de/corporate-launcher) ist gesetzt, und sein Wert kann nicht verwendet werden, daher weigert sich Claude Code, den betroffenen Prozess zu starten, anstatt ihn ohne den Launcher auszuführen. Konfigurationsprobleme werden mit einer Meldung gemeldet, die mit dem Variablennamen beginnt und den Grund angibt, zum Beispiel:
1358
1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1361```
1362
1363Ein Launcher, der startet, aber beendet wird, ohne sich selbst durch Claude Code zu ersetzen, schlägt die Sitzung fehl, die er starten wollte, und die Zeile der Sitzung in der Agent-Ansicht meldet, dass der Launcher `must exec, not daemonize`, gefolgt von allem, was der Launcher ausgegeben hat. Eine Sitzung, die nicht starten oder den Hintergrund-Service nicht erreichen kann, weil des Launchers, meldet das Launcher-Problem als Grund innerhalb von `Couldn't reach the background service (...)`.
1364
1365**Was zu tun ist:**
1366
1367* Setzen Sie die Variable auf den absoluten Pfad einer ausführbaren Datei, die mit dem Aufruf von `exec "$@"` endet. Siehe [den Launcher-Vertrag](/de/corporate-launcher#the-launcher-contract) für den vollständigen Vertrag
1368* Überprüfen Sie `/status`, das den aufgelösten Startbefehl in seinem Self-exec-Eintrag anzeigt und warnt, wenn der laufende Hintergrund-Service nicht damit übereinstimmt, oder führen Sie `claude daemon status` von einer Shell aus
1369* Nach dem Beheben des Werts im `env`-Block von [Einstellungen](/de/corporate-launcher#set-up-the-launcher) starten Sie den Hintergrund-Service mit `claude daemon stop --any` neu, damit die nächste Verteilung einen umschlossenen startet
1370
1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1144 Konfigurationswarnungen1372 Konfigurationswarnungen
1145</h2>1373</h2>
1158 1386
1159**Was zu tun ist:**1387**Was zu tun ist:**
1160 1388
1161* 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.1389* Führen Sie `claude` im Verzeichnis aus und akzeptieren Sie den Vertrauensdialog. {/* min-version: 2.1.200 */}Der Dialog wird angezeigt, auch 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.
1162* Im [nicht-interaktiven Modus](/de/headless) 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.1390* Im [nicht-interaktiven Modus](/de/headless) 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.
1163* {/* 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](/de/permissions#project-allow-rules-and-workspace-trust).1391* {/* 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. {/* min-version: 2.1.207 */}Auf v2.1.207 und später ist eine Aktualisierung außerhalb eines Git-Repositorys nicht ausreichend, wenn Sie den Ordner nicht vertraut haben: Die Feststellung, dass sich ein Ordner nicht in einem Repository befindet, führt Git aus, und Claude Code führt diese Überprüfung nur durch, nachdem Sie den Vertrauensdialog akzeptiert haben. Verwenden Sie daher den ersten Schritt. Ihr Home-Verzeichnis und alle anderen [Konfigurationshome](/de/permissions#project-allow-rules-and-workspace-trust) sind ausgenommen und warten nicht auf den Dialog. Siehe [Projektallow-Regeln und Arbeitsbereichsvertrauen](/de/permissions#project-allow-rules-and-workspace-trust).
1164 1392
1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1166 Antworten scheinen von geringerer Qualität als üblich1394 Antworten scheinen von geringerer Qualität als üblich
1172* Eine Amazon Bedrock oder Google Cloud Agent Platform Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist1400* Eine Amazon Bedrock oder Google Cloud Agent Platform Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist
1173* [Automatisches Modell-Fallback](/de/model-config#automatic-model-fallback) auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Notiz im Transkript an1401* [Automatisches Modell-Fallback](/de/model-config#automatic-model-fallback) auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Notiz im Transkript an
1174 1402
1175Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](/de/model-config) erklärt, wann jedes Fallback gilt.1403Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](/de/model-config) erklärt, wann jedes Fallback angewendet wird.
1176 1404
1177Überprüfen Sie diese zuerst:1405Überprüfen Sie diese zuerst:
1178 1406
1179* **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.1407* **Modellauswahl**: Führen Sie `/model` aus, um zu bestätigen, dass Sie das erwartete Modell verwenden. Eine vorherige `/model`-Auswahl oder eine `ANTHROPIC_MODEL`-Umgebungsvariable kann Sie auf einem kleineren Modell als beabsichtigt platzieren.
1180* **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](/de/model-config#adjust-effort-level) für modellspezifische Standardwerte und die `ultrathink`-Verknüpfung.1408* **Anstrengungsgrad**: 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 liegen. Siehe [Anstrengungsgrad anpassen](/de/model-config#adjust-effort-level) für modellspezifische Standardwerte und die `ultrathink`-Verknüpfung.
1181* **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](/de/context-window), um zu erfahren, wie Auto-Compact frühere Züge beeinflusst.1409* **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](/de/context-window), um zu erfahren, wie Auto-Compact frühere Züge beeinflusst.
1182* **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.1410* **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 MCP-Tool-Token-Nutzung an. Vor v2.1.205 öffnete `/doctor` einen Diagnose-Bildschirm, der übergroße Speicherdateien und Subagent-Definitionen kennzeichnete.
1183 1411
1184Wenn 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](/de/checkpointing).1412Wenn 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 den fehlerhaften Zug zurückzugehen, und formulieren Sie dann die Eingabeaufforderung mit mehr Spezifika um. Korrigieren im Thread behält den falschen Versuch im Kontext, was später Antworten daran verankern kann. Siehe [Checkpointing](/de/checkpointing).
1185 1413
1186Wenn 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](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.1414Wenn 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](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.
1187 1415
1188{/* 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.1416Wenn Claude vor einer vermuteten Prompt-Injection warnt oder eine Anfrage wegen einer vermuteten Injection ablehnt, und der Text, den die Warnung benennt, Kontext ist, den Claude Code automatisch zum Gespräch hinzufügt, anstatt Datei- oder Webinhalte, führen Sie `claude update` aus und versuchen Sie es erneut. Wenn die Warnung nach dem Update wiederholt wird, [melden Sie es](#report-an-error), anstatt den gekennzeichneten Inhalt zurück in die Eingabeaufforderung einzufügen. {/* min-version: 2.1.201 */}Vor v2.1.201 lehnten Sonnet 5 einige Anfragen auf die gleiche Weise ab.
1189 1417
1190<h2 id="report-an-error">1418<h2 id="report-an-error">
1191 Fehler melden1419 Fehler melden
1199 1427
1200Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:1428Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:
1201 1429
1202* 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.1430* 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. Das Senden an Anthropic erfordert [Authentifizierung](/de/authentication). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind, speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.
1203* 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 beheben1431* 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
1204* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle1432* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle
1205* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub1433* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub
