> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 des Setups siehe [Troubleshoot installation and login](https://code.claude.com/docs/de/troubleshoot-install.md).

Mit Ausnahme von [Wrapper and IDE errors](#wrapper-and-ide-errors), die das startende Programm ausgibt und nicht Claude Code selbst, gelten diese Fehler und Wiederherstellungsbefehle über die CLI, die [Desktop-App](https://code.claude.com/docs/de/desktop.md) und [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md), da alle drei die gleiche Claude Code CLI verwenden. Für andere oberflächenspezifische Probleme siehe den Abschnitt zur Fehlerbehebung auf der Seite dieser Oberfläche.

> [!NOTE]
>
> Claude Code ruft die Claude API für Modellantworten auf, daher werden die meisten Laufzeitfehler einem zugrunde liegenden API-Fehlercode zugeordnet. Diese Seite behandelt, was jeder Fehler in Claude Code bedeutet und wie Sie sich davon erholen. Für die rohen HTTP-Statuscode-Definitionen siehe die [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).

## Fehler finden

Ordnen Sie die angezeigte Meldung einem Abschnitt unten zu.

| Meldung | Abschnitt |
| :- | :- |
| `API Error: 500 Internal server error` | [Serverfehler](#api-error-500-internal-server-error) |
| `API Error: Repeated 529 Overloaded errors` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |
| `Opus is experiencing high load` / `Fable is experiencing high load` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |
| `Request timed out` | [Serverfehler](#request-timed-out), oder [Netzwerk](#unable-to-connect-to-api), wenn die Meldung Ihre Internetverbindung erwähnt |
| `API Error: No response from API` | [Serverfehler](#no-response-from-api) |
| `API Error: Stream idle timeout - no chunks received` | [Streaming-Leerlauf-Watchdogs](https://code.claude.com/docs/de/network-config.md#streaming-idle-watchdogs), oder [Langes Thinking endet in Proxy-Timeouts](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#long-thinking-ends-in-proxy-timeouts) hinter einem Claude-Apps-Gateway |
| `Server error mid-response. The response above may be incomplete.` | [Serverfehler](#the-response-above-may-be-incomplete) |
| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Serverfehler](#the-response-above-may-be-incomplete) |
| `Connection closed mid-response` / `Response stalled mid-stream` | [Serverfehler](#the-response-above-may-be-incomplete) |
| `Part of the response never arrived` / `The response stream was malformed` | [Serverfehler](#the-response-above-may-be-incomplete) |
| `API Error: Content block not found` / `API Error: Content block already closed` / `API Error: Stream event unreadable` | [Serverfehler](#the-response-above-may-be-incomplete) |
| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatische Wiederholungen](#automatic-retries) |
| `Connection closed while thinking` / `Response stalled while thinking` | [Automatische Wiederholungen](#automatic-retries) |
| `Connection lost while your computer was asleep` | [Automatische Wiederholungen](#automatic-retries) |
| `The model's tool call could not be parsed (retry also failed).` | [Automatische Wiederholungen](#automatic-retries) |
| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Auto mode could not evaluate this action and is blocking it for safety` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Not run · auto mode's check had no usable answer` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Auto mode classifier transcript exceeded context window` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `The server-side auto mode classifier gave no verdict` | [Serverfehler](#the-server-returned-no-safety-verdict) |
| `<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier` | [Serverfehler](#was-not-reviewed-and-did-not-run) |
| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Serverfehler](#the-server-returned-no-safety-verdict) |
| `Agent terminated early due to an API error` | [Serverfehler](#agent-terminated-early-due-to-an-api-error) |
| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Nutzungslimits](#youve-hit-your-session-limit) |
| `Usage credits required for 1M context` | [Nutzungslimits](#usage-credits-required-for-1m-context) |
| `the prompt to confirm went unanswered · nothing was sent`, ab v2.1.324 | [Nutzungslimits](#the-prompt-to-confirm-went-unanswered) |
| `Claude stopped here · send a message to be asked again` | [Nutzungslimits](#the-prompt-to-confirm-went-unanswered) |
| `Server is temporarily limiting requests` | [Nutzungslimits](#server-is-temporarily-limiting-requests) |
| `Request rejected (429)` | [Nutzungslimits](#request-rejected-429) |
| `Credit balance is too low` | [Nutzungslimits](#credit-balance-is-too-low) |
| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Nutzungslimits](#youve-hit-your-monthly-spend-limit) |
| `Could not update your spend limit` / `Could not remove your spend limit` | [Nutzungslimits](#could-not-update-your-spend-limit) |
| `spend limit reached` / `spend limit unavailable` / `This request exceeds your group's budget` | [Nutzungslimits](#spend-limit-reached) |
| `Not logged in · Please run /login` | [Authentifizierung](#not-logged-in) |
| `Couldn't save your login` | [Authentifizierung](#couldnt-save-your-login) |
| `Sign in again to take your previous account or API key off the config file.` | [Authentifizierung](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |
| `Your account or API key may still be in the config file. Run claude auth logout.` | [Authentifizierung](#your-account-or-api-key-may-still-be-in-the-config-file) |
| `Authentication required · Sign in again to continue` | [Authentifizierung](#not-logged-in) |
| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |
| `Invalid API key` | [Authentifizierung](#invalid-api-key) |
| `Your apiKeyHelper script is failing` | [Authentifizierung](#your-apikeyhelper-script-is-failing) |
| `Your organization's settings need an update` | [Authentifizierung](#claude-code-didnt-send-your-claude-ai-login) |
| `Couldn't load your organization's settings. Check your connection` | [Authentifizierung](#claude-code-didnt-send-your-claude-ai-login) |
| `Restart Claude Code to finish signing in` | [Authentifizierung](#claude-code-didnt-send-your-claude-ai-login) |
| `Invalid auth token · Fix external auth token` | [Authentifizierung](#invalid-request-header-value) |
| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentifizierung](#invalid-request-header-value) |
| `Invalid request header from the environment · Fix the environment variable` | [Authentifizierung](#invalid-request-header-value) |
| `This organization has been disabled` | [Authentifizierung](#this-organization-has-been-disabled) |
| `Your organization has disabled API key authentication` | [Authentifizierung](#your-organization-has-disabled-api-key-authentication) |
| `Your organization has disabled Claude subscription access` | [Authentifizierung](#your-organization-has-disabled-claude-subscription-access) |
| `Scheduled tasks are off for your organization` | [Authentifizierung](#routines-are-disabled-by-your-organizations-policy) |
| `Routines are off for your organization` | [Authentifizierung](#routines-are-disabled-by-your-organizations-policy) |
| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentifizierung](#remote-control-requires-the-anthropic-api) |
| `OAuth token refresh failed — run /login to re-authenticate` | [Authentifizierung](#remote-control-couldnt-refresh-your-login) |
| `JWT refresh failed: no OAuth token — run /login` | [Authentifizierung](#remote-control-couldnt-refresh-your-login) |
| `Claude.ai login expired` | [Authentifizierung](#remote-control-couldnt-refresh-your-login) |
| `Claude.ai login was rejected — run /login, then /remote-control` | [Authentifizierung](#remote-control-couldnt-refresh-your-login) |
| `OAuth token unavailable — run /login to restore Remote Control` | [Authentifizierung](#remote-control-couldnt-refresh-your-login) |
| `Signed out of Claude — run /login, then /remote-control` | [Authentifizierung](#remote-control-couldnt-refresh-your-login) |
| `Remote Control could not renew this computer's connection` | [Authentifizierung](#remote-control-could-not-renew-this-computers-connection) |
| `signed-in claude.ai account or organization changed on this machine` | [Authentifizierung](#remote-control-stopped-because-the-signed-in-account-changed) |
| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentifizierung](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentifizierung](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
| `Couldn't verify your organization's policy for remote control` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#couldnt-verify-your-organizations-policy-for-remote-control) |
| `Remote Control didn't finish connecting` | [Eine Remote-Control-Sitzung starten](https://code.claude.com/docs/de/remote-control.md#start-a-remote-control-session) |
| `Remote Control is disabled by your organization's policy` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#remote-control-is-disabled-by-your-organizations-policy) |
| `Remote Control was turned off by your organization's policy` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#remote-control-was-turned-off-by-your-organizations-policy) |
| `Session failed: working folder not found:` | [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#working-folder-not-found) |
| `The program file this Remote Control started from is gone` | [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#program-file-is-gone) |
| `Session failed: spawn error:` gefolgt von einer `ENOENT`-Meldung | [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#program-file-is-gone) |
| `Remote Control disconnected:` gefolgt von einem Grund, der einen `share link` erwähnt | [Remote Control](https://code.claude.com/docs/de/remote-control.md#what-connected-devices-see) |
| `OAuth token revoked` / `OAuth token has expired` | [Authentifizierung](#oauth-token-revoked-or-expired) |
| `Failed to authenticate: OAuth token revoked` | [Authentifizierung](#oauth-token-revoked-or-expired) |
| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentifizierung](#oauth-token-revoked-or-expired) |
| `API Error: 401 Invalid authentication credentials` | [Authentifizierung](#api-error-401-invalid-authentication-credentials) |
| `Login expired · Please run /login` | [Authentifizierung](#login-expired) |
| `The browser can't return the sign-in to Claude Code automatically` | [Authentifizierung](#couldnt-start-the-local-sign-in-listener) |
| `Couldn't start the local listener that receives the browser sign-in. Try again.` | [Authentifizierung](#couldnt-start-the-local-sign-in-listener) |
| `Failed to start OAuth callback server` | [Authentifizierung](#failed-to-start-oauth-callback-server) |
| `Claude login not accepted · Run /login, then try again` | [Authentifizierung](#claude-login-not-accepted) |
| `Artifacts need a claude.ai login` | [Authentifizierung](#artifacts-need-a-claude-ai-login) |
| `Not signed in to the Cloud gateway — run /login.` | [Authentifizierung](#administrator-policy-requires-a-cloud-gateway-sign-in) |
| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentifizierung](#administrator-policy-requires-a-cloud-gateway-sign-in) |
| `Managed settings on this machine configure a Cloud gateway sign-in; run interactive /login to authenticate.` | [`claude auth login`](https://code.claude.com/docs/de/cli-reference#cli-commands) |
| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentifizierung](#login-expired) |
| `Login reached its time limit · Please run /login` / `Failed to authenticate: this login reached its time limit` | [Authentifizierung](#login-expired) |
| `Failed to authenticate: your claude.ai login expired` | [Nach Ablauf der Anmeldung](https://code.claude.com/docs/de/authentication.md#after-the-login-expires) |
| `claude.ai login ended · usage now billed to` / `Warning: the claude.ai login on this machine has ended` | [Nach Ablauf der Anmeldung](https://code.claude.com/docs/de/authentication.md#after-the-login-expires) |
| `Could not refresh your login because another Claude Code process is refreshing it` | [Authentifizierung](#could-not-refresh-your-login) |
| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Authentifizierung](#could-not-refresh-your-login) |
| `Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [Authentifizierung](#could-not-refresh-your-login-disk-full) |
| `Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [Authentifizierung](#could-not-refresh-your-login-disk-full) |
| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentifizierung](#your-account-is-on-hold) |
| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentifizierung](#your-account-is-on-hold) |
| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentifizierung](#anthropic-profile-login-expired) |
| `Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile` | [Authentifizierung](#anthropic-profile-login-expired) |
| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentifizierung](#anthropic-profile-login-expired) |
| `does not meet scope requirement user:profile` | [Authentifizierung](#oauth-scope-requirement) |
| `claude.ai rejected the session token` / `session token rejected` | [Authentifizierung](#claude-ai-rejected-the-session-token) |
| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |
| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |
| `(check the helper, then start a new task or chat)` / `(update it, then start a new task or chat)` | [Authentifizierung](#mcp-credential-rejected-in-cowork) |
| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |
| `MCP server "<name>" requires re-authorization (token expired)` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |
| `Couldn't read the stored credentials for MCP server "<name>", so the request didn't run` | [Authentifizierung](#couldnt-read-the-stored-credentials-for-mcp-server) |
| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentifizierung](#couldnt-read-the-stored-credentials-for-mcp-server) |
| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentifizierung](#mcp-server-url-is-missing-or-not-a-valid-url) |
| `Issuer mismatch in authorization response (RFC 9207)` | [Authentifizierung](#issuer-mismatch-in-authorization-response) |
| `Stopped an OAuth request` | [Authentifizierung](#stopped-an-oauth-request) |
| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentifizierung](#refusing-to-send-credentials-to-non-https-token-endpoint) |
| `Cloud gateway session expired — run /login to reconnect.` | [Authentifizierung](#cloud-gateway-session-expired) |
| `Cloud gateway <url> no longer accepts this session` | [Authentifizierung](#cloud-gateway-session-expired) |
| `Sign-in timed out while waiting for you to continue. Try again.` | [Authentifizierung](#sign-in-timed-out-while-waiting-for-you-to-continue) |
| `AWS credentials expired or invalid` | [Authentifizierung](#aws-credentials-expired-or-invalid) |
| `AWS authentication failed` | [Authentifizierung](#aws-authentication-failed) |
| `Google Cloud credentials expired or invalid` | [Authentifizierung](#google-cloud-credentials-expired-or-invalid) |
| `Google Cloud authentication failed` | [Authentifizierung](#google-cloud-authentication-failed) |
| `Microsoft Foundry authentication failed` | [Authentifizierung](#microsoft-foundry-authentication-failed) |
| `Gateway refused the request` | [Authentifizierung](#gateway-refused-the-request) |
| `Could not load AWS credentials` / `Could not load Google Cloud credentials` | [Authentifizierung](#could-not-load-aws-or-google-cloud-credentials) |
| `AWS default-chain credential resolve timed out` | [Authentifizierung](#aws-default-chain-credential-resolve-timed-out) |
| `Timed out after 60s waiting for AWS` | [Authentifizierung](#bedrock-setup-verification-timed-out-waiting-for-aws) |
| `A request to AWS timed out. Check your network and proxy settings, then try again.` | [Authentifizierung](#bedrock-setup-verification-timed-out-waiting-for-aws) |
| `Could not load the default credentials` auf Google Clouds Agent Platform | [Authentifizierung](#could-not-load-aws-or-google-cloud-credentials) |
| `Unable to connect to API` | [Netzwerk](#unable-to-connect-to-api) |
| `Connection refused —` / `Can't reach the API server —` / `No internet route —` / `Couldn't connect through your proxy` / `Connection dropped`, jeweils mit einem Fehlercode in Klammern | [Netzwerk](#unable-to-connect-to-api) |
| `Unable to connect to Anthropic services` während des Setups | [Netzwerk](#unable-to-connect-to-anthropic-services) |
| `Unable to fetch your privacy settings at this time` | [Datenschutzeinstellungen auf claude.ai](https://claude.ai/settings/data-privacy-controls) |
| `Socket is closed` | [Netzwerk](#socket-is-closed) |
| `Waiting for API response · will retry in` | [Automatische Wiederholungen](#automatic-retries), oder [Netzwerk](#unable-to-connect-to-api), wenn es anhält |
| `API returned an empty or malformed response` | [Netzwerk](#api-returned-an-empty-or-malformed-response) |
| `Streaming response ended before any complete data was received` | [Netzwerk](#streaming-response-ended-before-any-complete-data-was-received) |
| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Netzwerk](#bedrock-streaming-response-has-an-unexpected-content-type) |
| `Claude Code used only the certificates that it could read in full from the NODE_EXTRA_CA_CERTS file` / `Claude Code ignored all of the NODE_EXTRA_CA_CERTS file: it holds no certificate that Claude Code can read` | [Benutzerdefinierte CA-Zertifikate](https://code.claude.com/docs/de/network-config.md#custom-ca-certificates) |
| `SSL certificate verification failed` | [Netzwerk](#ssl-certificate-errors) |
| `SSL certificate error (...)` während des Logins oder Starts | [Netzwerk](#ssl-certificate-errors) |
| `unable to get local issuer certificate` | [Netzwerk](#ssl-certificate-errors) |
| `403` mit `x-deny-reason: host_not_allowed` in einer Cloud-Sitzung oder einer geplanten Aufgabe in der Cloud | [Netzwerk](#host-not-allowed-in-a-cloud-session) |
| `proxy refused the connection` | [Netzwerk](#the-proxy-refused-the-connection) |
| `403` mit `GitHub GraphQL is not available from Claude Code sessions` in einer Cloud-Sitzung | [GitHub-Proxy](https://code.claude.com/docs/de/cloud-environments.md#github-proxy) |
| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Netzwerk](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |
| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [Netzwerk](#failed-to-fetch-session-from-sessions-api) |
| `Couldn't load the history of cloud session` | [Netzwerk](#couldnt-load-the-history-of-cloud-session) |
| `Couldn't reconnect to your Remote Control session` | [Netzwerk](#couldnt-reconnect-to-your-remote-control-session) |
| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Netzwerk](#sessions-ended-while-this-machine-was-offline) |
| `Couldn't share the transcript.` | [Netzwerk](#couldnt-share-the-transcript) |
| `Couldn't send feedback` | [Netzwerk](#couldnt-send-feedback) |
| `Feedback payload too large. Try again without the transcript, or shorten the details.` | [Netzwerk](#feedback-payload-too-large) |
| `MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.` | [Netzwerk](#mcp-server-connection-timed-out-during-a-sleep-or-clock-change) |
| `Prompt is too long` / `Input is too long for requested model` | [Anfragefehler](#prompt-is-too-long) |
| `Prompt is too long · automatic compaction failed:` | [Anfragefehler](#prompt-is-too-long) |
| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Anfragefehler](#prompt-is-too-long) |
| `Context limit reached · /compact or /clear to continue` | [Anfragefehler](#prompt-is-too-long) |
| `Context limit reached · /clear to continue` | [Anfragefehler](#prompt-is-too-long) |
| `capability_rejected: prompt_too_long` auf einer Claude-Apps-Gateway-Sitzung | [Anfragefehler](#prompt-is-too-long) |
| `upstream rejected the request` / `request too large for this upstream` auf einer Claude-Apps-Gateway-Sitzung | [Upstream-Fehlermeldungen](https://code.claude.com/docs/de/claude-apps-gateway-config.md#upstream-error-messages) |
| `upstream rate limit exceeded` auf einer Claude-Apps-Gateway-Sitzung | [Upstream-Fehlermeldungen](https://code.claude.com/docs/de/claude-apps-gateway-config.md#upstream-error-messages) |
| `all upstreams failed (N attempted)` auf einer Claude-Apps-Gateway-Sitzung | [Upstream-Fehlermeldungen](https://code.claude.com/docs/de/claude-apps-gateway-config.md#upstream-error-messages) |
| `Claude Code may not be enabled for your organization` nach einer Claude-Apps-Gateway-Anmeldung | [Fehlerbehebung für Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#troubleshooting) |
| `Context exceeds the ...-token limit by ... tokens` in `/context`-Ausgabe | [Anfragefehler](#context-exceeds-the-token-limit) |
| `Request too large` | [Anfragefehler](#request-too-large) |
| `Request too large for the API's 32MB request limit` | [Anfragefehler](#request-too-large) |
| `Image was too large` | [Anfragefehler](#image-was-too-large) |
| `API Error: an image in the conversation could not be processed and was removed` | [Anfragefehler](#image-was-too-large) |
| `An image in the conversation exceeds the dimension limit for many-image requests` | [Anfragefehler](#image-was-too-large) |
| `Unable to resize image` | [Anfragefehler](#unable-to-resize-image) |
| `Request rejected as unprocessable by the model` | [Anfragefehler](#request-rejected-as-unprocessable-by-the-model) |
| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Anfragefehler](#pdf-errors) |
| `Extra inputs are not permitted` | [Anfragefehler](#extra-inputs-are-not-permitted) |
| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Anfragefehler](#tool-input-schema-is-invalid) |
| `N tools left out` neben einem Server in `/mcp` / `Claude wasn't given N tools because the Anthropic API would reject their input schemas` | [Tools mit ungültigen Eingabeschemas](https://code.claude.com/docs/de/mcp.md#tools-with-invalid-input-schemas) |
| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [Anfragefehler](#mcp-tool-name-over-128-characters) |
| `tools.N.custom.name: String should have at most 128 characters` | [Anfragefehler](#mcp-tool-name-over-128-characters) |
| `tool_use.name: String should have at most 200 characters` | [Anfragefehler](#tool-use-name-over-200-characters) |
| `There's an issue with the selected model` | [Anfragefehler](#theres-an-issue-with-the-selected-model) |
| `Model ... is not a recognized model id` | [Anfragefehler](#model-is-not-a-recognized-model-id) |
| `Model ... not found` | [Anfragefehler](#model-not-found) |
| `Couldn't confirm model ... with the API` | [Anfragefehler](#couldnt-confirm-model-with-the-api) |
| `API error: ... · model not changed` | [Anfragefehler](#api-error-model-not-changed) |
| `Claude Opus is not available with the Claude Pro plan` | [Anfragefehler](#claude-opus-is-not-available-with-the-claude-pro-plan) |
| `Claude Code ... does not support this model; version ... or newer is required` | [Anfragefehler](#claude-code-does-not-support-this-model) |
| `Claude Code ... is older than the minimum version required by your organization's policy` | [Anfragefehler](#claude-code-does-not-support-this-model) |
| `Model ... is restricted by your organization's settings` | [Anfragefehler](#model-is-restricted-by-your-organizations-settings) |
| `Model ... is not available. Your organization restricts model selection.` | [Anfragefehler](#model-is-restricted-by-your-organizations-settings) |
| `Can't switch to the default model` | [Anfragefehler](#cant-switch-to-the-default-model) |
| `Model switch ... blocked by a PreModelSwitch hook` | [Anfragefehler](#model-switch-was-blocked-by-a-premodelswitch-hook) |
| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Anfragefehler](#couldnt-save-it-as-your-default) |
| `is less capable than the current main model` / `Advisor will not activate on the main model` / `cannot advise` | [Anfragefehler](#advisor-is-less-capable-than-the-current-main-model) |
| `thinking.type.enabled is not supported for this model` | [Anfragefehler](#thinking-type-enabled-is-not-supported-for-this-model) |
| `Effort '<level>' isn't available with thinking turned off on this model` | [Anfragefehler](#effort-isnt-available-with-thinking-turned-off) |
| `effort '<level>' is not supported when thinking is disabled` | [Anfragefehler](#effort-isnt-available-with-thinking-turned-off) |
| `max_tokens must be greater than thinking.budget_tokens` | [Anfragefehler](#thinking-budget-exceeds-output-limit) |
| `Claude's response exceeded the ... output token maximum` | [Anfragefehler](#response-exceeded-the-output-token-maximum) |
| `API Error: 400 due to tool use concurrency issues` | [Anfragefehler](#tool-use-or-thinking-block-mismatch) |
| `API Error: 400 orphaned tool_result in conversation history` | [Anfragefehler](#tool-use-or-thinking-block-mismatch) |
| `API Error: 400 duplicate tool_use ID in conversation history` | [Anfragefehler](#tool-use-or-thinking-block-mismatch) |
| `Invalid data in redacted_thinking block` | [Anfragefehler](#invalid-data-in-redacted-thinking-block) |
| `[Unsupported tool content removed]` | [Anfragefehler](#unsupported-tool-content-removed) |
| `role 'system' must precede an 'assistant' message` | [Anfragefehler](#role-system-must-precede-an-assistant-message) |
| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Anfragefehler](#invalid-encrypted-content-in-search-result-block) |
| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Anfragefehler](#invalid-encrypted-content-in-search-result-block) |
| `server_tool_use.name: Input should be` auf jedem Turn einer fortgesetzten Sitzung | [Anfragefehler](#unsupported-tool-content-removed) |
| `<model> can't help with this. Start a new session to continue` | [Anfragefehler](#usage-policy-refusal) |
| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Anfragefehler](#usage-policy-refusal) |
| `<model>'s safeguards flagged this message` | [Anfragefehler](#safety-measures-flagged-a-cybersecurity-topic) |
| `<model>'s safeguards flagged this session` | [Anfragefehler](#safety-measures-flagged-a-cybersecurity-topic) |
| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Anfragefehler](#safety-measures-flagged-a-cybersecurity-topic) |
| `` Details: `[reasoning_extraction]` `` | [Anfragefehler](#safeguards-flagged-a-request-for-claudes-reasoning) |
| `API Error: Output blocked by content filtering policy` | [Anfragefehler](#output-blocked-by-content-filtering-policy) |
| `Installation was killed before it could finish (exit code 137)` | [Fehlerbehebung bei Installation und Anmeldung](https://code.claude.com/docs/de/troubleshoot-install.md#installation-was-killed-before-it-could-finish) |
| `The connection dropped while downloading the update` | [Fehlerbehebung bei Installation und Anmeldung](https://code.claude.com/docs/de/troubleshoot-install.md#the-connection-dropped-while-downloading-the-update) |
| `Download timed out: exceeded the total deadline` | [Fehlerbehebung bei Installation und Anmeldung](https://code.claude.com/docs/de/troubleshoot-install.md#the-connection-dropped-while-downloading-the-update) |
| `Release verification failed for Claude Code <version> (<reason>). The update was not installed.` | [Fehlerbehebung bei Installation und Anmeldung](https://code.claude.com/docs/de/troubleshoot-install.md#release-verification-failed) |
| `Auto-update failed · Run claude doctor` | [Fehlerbehebung bei Installation und Anmeldung](https://code.claude.com/docs/de/troubleshoot-install.md#auto-update-failed) |
| `--bg and --print conflict` | [Befehlszeilenfehler](#conflict-between-bg-and-print) |
| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Befehlszeilenfehler](#couldnt-tell-whether-bg-is-a-flag-or-text) |
| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Befehlszeilenfehler](#conflict-between-a-system-prompt-flag-and-its-file-form) |
| `Error: bypassPermissions not supported in restricted mode` | [Eingeschränkter Modus](https://code.claude.com/docs/de/permission-modes.md#restricted-mode-refuses-bypasspermissions) |
| `Session was started with bypass permissions, so plan mode won't ask before most edits or commands` | [Plan-Modus](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode) |
| `Cloud sessions cannot be created from a --restricted session` | [Befehlszeilenfehler](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
| `Cloud sessions are disabled by your organization's policy` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |
| `Cloud sessions use your claude.ai login`, am Ende einer Richtlinienablehnung, die Anmeldedaten nennt | [Befehlszeilenfehler](#cloud-sessions-use-your-claude-ai-login) |
| `Couldn't verify your organization's policy for cloud sessions` | [Befehlszeilenfehler](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |
| `Cloud sessions aren't available:` gefolgt vom Grund, warum die Richtlinie Ihrer Organisation nicht geladen werden konnte | [Befehlszeilenfehler](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |
| `Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in.` | [Organisations-UUID kann nicht abgerufen werden](https://code.claude.com/docs/de/claude-code-on-the-web.md#unable-to-get-organization-uuid) |
| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](https://code.claude.com/docs/de/claude-code-on-the-web.md#unable-to-get-organization-uuid) |
| `Nothing was stashed: "<path>" is now a folder in place of a tracked file or link` / `are now folders in place of tracked files or links` | [Befehlszeilenfehler](#nothing-was-stashed-because-a-folder-replaced-a-tracked-file) |
| `Error: --json-schema is not a valid JSON Schema` | [Befehlszeilenfehler](#the-json-schema-value-is-not-a-valid-json-schema) |
| `Error: Invalid --agents configuration:` | [Befehlszeilenfehler](#invalid-agents-configuration) |
| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Befehlszeilenfehler](#invalid-agents-configuration) |
| `Error: --agents file not found` | [Befehlszeilenfehler](#invalid-agents-configuration) |
| `Error: Settings file exceeds the 2MiB limit` | [Befehlszeilenfehler](#settings-file-exceeds-the-2mib-limit) |
| `Configuration error in` | [Befehlszeilenfehler](#configuration-error-in-claude-json) |
| `Claude configuration file at <path> was empty and no backup holds anything: starting with defaults.` | [Befehlszeilenfehler](#claude-configuration-file-was-empty) |
| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Befehlszeilenfehler](#the-current-directory-no-longer-exists) |
| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |
| `ENOSPC: no space left on device, mkdir '<dir>'` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |
| `Error: Claude Code could not save ... because the disk is full (ENOSPC)` / `because your disk quota is used up (EDQUOT)` | [Befehlszeilenfehler](#could-not-save-because-the-disk-is-full) |
| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [Befehlszeilenfehler](#directory-couldnt-be-resolved-to-a-real-location) |
| `Error: Workspace not trusted` beim Starten von Remote Control | [Befehlszeilenfehler](#workspace-not-trusted-when-starting-remote-control) |
| `Error: Workspace not trusted` beim Ausführen von `claude ultrareview` | [Befehlszeilenfehler](#workspace-not-trusted-when-running-claude-ultrareview) |
| `Ultrareview did not start` | [Befehlszeilenfehler](#ultrareview-did-not-start) |
| `Remote Control did not start: "<question>" got no answer` | [Befehlszeilenfehler](#remote-control-did-not-start-got-no-answer) |
| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Befehlszeilenfehler](#not-carried-over-to-the-sessions-remote-control-starts) |
| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Befehlszeilenfehler](#remote-control-did-not-start-because-of-the-settings-file) |
| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Befehlszeilenfehler](#settings-file-changed-since-remote-control-started) |
| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Befehlszeilenfehler](#sandbox-is-not-supported-by-claude-remote-control) |
| `` `claude import` is not yet available in this build `` | [Befehlszeilenfehler](#claude-import-is-not-yet-available-in-this-build) |
| `Could not read Claude Code config` | [Befehlszeilenfehler](#could-not-read-claude-code-config) |
| `Could not import <server>: <reason>` | [Befehlszeilenfehler](#could-not-import-a-server-from-claude-desktop) |
| `Cannot add MCP server to scope: managed` | [Befehlszeilenfehler](#cannot-add-mcp-server-to-the-managed-scope) |
| `Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide` | [Befehlszeilenfehler](#cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers) |
| `is Anthropic-hosted and doesn't support local OAuth` | [Befehlszeilenfehler](#anthropic-hosted-and-doesnt-support-local-oauth) |
| `Can't add to .mcp.json: it lists servers at the top level` | Verschieben Sie die Server unter einen `mcpServers`-Schlüssel, wie im [Format für den Projekt-Geltungsbereich](https://code.claude.com/docs/de/mcp.md#project-scope). |
| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Befehlszeilenfehler](#cant-read-mcp-json) |
| `MCP server "<name>" was not saved to` / `was not removed from` | [Befehlszeilenfehler](#mcp-server-was-not-saved-or-removed) |
| `MCP server "<name>" may not have been saved` / `may not have been removed` | [Befehlszeilenfehler](#mcp-server-may-not-have-been-saved-or-removed) |
| `Server rejected the Authorization header minted by the configured headersHelper` | [Befehlszeilenfehler](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |
| `This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability` | [Befehlszeilenfehler](#mcp-server-rejected-the-elicitation-capability) |
| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Befehlszeilenfehler](#mcp-permission-prompt-tool-not-found) |
| `OAuth callback port <port> is already in use — another process may be holding it` | [Befehlszeilenfehler](#oauth-callback-port-is-already-in-use) |
| `No available ports for OAuth redirect` | [Befehlszeilenfehler](#no-available-ports-for-oauth-redirect) |
| `Shell command failed for pattern "..."`, von `/security-review` oder einem beliebigen Skill, der dynamischen Kontext einfügt | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |
| `Shell command permission check failed for pattern "..."`, von einem Skill, der dynamischen Kontext injiziert | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |
| ``Couldn't run `<command>` for <name>. A file named HEAD or .git in this folder or one above it may not be yours``, aus einem Skill, der dynamischen Kontext einfügt | [Berechtigungsprüfungen für eingefügte Befehle](https://code.claude.com/docs/de/skills.md#permission-checks-on-injected-commands) |
| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |
| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Befehlszeilenfehler](#no-shell-command-was-run) |
| `This skill, command or hook and the arguments filled into it add up to more than 4,000,000 characters` | [Befehlszeilenfehler](#skill-command-or-hook-over-the-4000000-character-limit) |
| `Input must be provided either through stdin or as a prompt argument when using --print` | [Befehlszeilenfehler](#input-must-be-provided-when-using-print) |
| `Claude Code can't read the keyboard here: stdin is not a terminal` | [Befehlszeilenfehler](#claude-code-cant-read-the-keyboard-here) |
| `Error: Input contained only whitespace` | [Befehlszeilenfehler](#input-contained-only-whitespace) |
| `Blank prompt — the message was only whitespace, so nothing was sent to the model.` | [Befehlszeilenfehler](#input-contained-only-whitespace) |
| `Error: stream-json input carried over 256M characters with no newline` | [Befehlszeilenfehler](#stream-json-input-carried-over-256m-characters-with-no-newline) |
| `Unknown command: /<name>`, mit oder ohne einen `Did you mean`-Vorschlag | [Befehlszeilenfehler](#unknown-command) |
| `Diff is too large for ultrareview` / `PR #<N> is too large for ultrareview` | [Befehlszeilenfehler](#diff-is-too-large-for-ultrareview) |
| `Could not find merge-base with <branch>` | [Befehlszeilenfehler](#could-not-find-merge-base-with-the-base-branch) |
| `Your checkout has no branches (detached HEAD only)` | [Befehlszeilenfehler](#your-checkout-has-no-branches) |
| `Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected` | [Befehlszeilenfehler](#no-github-account-is-connected-to-your-claude-account) |
| `Your connected GitHub account can't see <owner>/<repo>` | [Befehlszeilenfehler](#your-connected-github-account-cant-see-the-repository) |
| `The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead` | [Befehlszeilenfehler](#the-github-app-preflight-failed-transiently) |
| `Not uploading this working tree` mit `the upload cannot follow that setting` | [Befehlszeilenfehler](#the-repository-upload-cant-follow-a-git-setting) |
| `Not uploading this working tree` mit einer anderen Ursache / `Git will not work in this checkout because its folder, or the .git in it, belongs to another user` | [Lokale Repositorys ohne GitHub senden](https://code.claude.com/docs/de/claude-code-on-the-web.md#send-local-repositories-without-github) |
| `GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud` | [Befehlszeilenfehler](#github-isnt-connected-to-your-claude-account) |
| `Your GitHub organization has an IP allowlist that is blocking Claude` | [Befehlszeilenfehler](#a-github-organization-policy-is-blocking-claude) |
| `Your GitHub organization requires single sign-on` | [Befehlszeilenfehler](#a-github-organization-policy-is-blocking-claude) |
| `Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude` | [Befehlszeilenfehler](#a-github-organization-policy-is-blocking-claude) |
| `Single sign-on authorization needed` | [Befehlszeilenfehler](#single-sign-on-authorization-needed) |
| `Failed to resume the conversation` | [Befehlszeilenfehler](#failed-to-resume-the-conversation) |
| `No conversation found with session ID: <session-id>` | [Befehlszeilenfehler](#no-conversation-found-with-the-session-id) |
| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [Befehlszeilenfehler](#windows-reported-an-error-ebadf) |
| `Cannot switch renderers in this session` | [Befehlszeilenfehler](#cannot-switch-renderers-in-this-session) |
| `Cannot switch renderers while work is running in the background` | [Befehlszeilenfehler](#cannot-switch-renderers-in-this-session) |
| `Can't restart while work is running in the background` | [Befehlszeilenfehler](#cant-restart-while-work-is-running-or-remote-control-is-connected) |
| `Can't restart while Remote Control is connected. To use the installed version, exit and start Claude Code again, then run /resume.` | [Befehlszeilenfehler](#cant-restart-while-work-is-running-or-remote-control-is-connected) |
| `Claude Code couldn't restart` | [Befehlszeilenfehler](#claude-code-couldnt-restart) |
| `Couldn't open Claude Desktop` | [Befehlszeilenfehler](#couldnt-open-claude-desktop) |
| `Failed to open Claude Desktop. Please try opening it manually.` | [Befehlszeilenfehler](#couldnt-open-claude-desktop) |
| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Befehlszeilenfehler](#terminal-setup-left-your-zed-keymap-unchanged) |
| `Your Zed keymap isn't a readable list of keybindings` | [Befehlszeilenfehler](#terminal-setup-left-your-zed-keymap-unchanged) |
| `Skill usage reports are not available on this connection.` | [Befehlszeilenfehler](#skill-usage-reports-are-not-available-on-this-connection) |
| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Befehlszeilenfehler](#custom-output-styles-cant-be-selected-over-remote-control) |
| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Befehlszeilenfehler](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |
| `/recap only runs when you ask for it yourself in this session` | [Befehlszeilenfehler](#recap-only-runs-when-you-ask-for-it-yourself) |
| `/feedback is disabled by your organization's policy`, oder dasselbe für `/bug` oder `/share` | [Befehlszeilenfehler](#feedback-is-disabled-by-your-organizations-policy) |
| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin-Fehler](#plugin-eval-is-currently-in-early-access) |
| `credential store on this machine holds a symbolic link inside it` | [Tools gewähren](https://code.claude.com/docs/de/plugin-evals.md#grant-tools) |
| `cannot be evaluated where sessions load it` | [Plugins mit Evals testen](https://code.claude.com/docs/de/plugin-evals.md#cannot-be-evaluated-where-sessions-load-it) |
| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |
| `Claude Code refuses the marketplace name "<name>"` | [Plugin-Fehler](#claude-code-refuses-the-marketplace-name) |
| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin-Fehler](#claude-code-refuses-the-marketplace-name) |
| `Marketplace "<name>" is already added from a different source` | [Plugin-Fehler](#marketplace-is-already-added-from-a-different-source) |
| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin-Fehler](#marketplace-name-is-another-spelling-of-a-reserved-name) |
| `Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#cannot-install-plugins-from-a-marketplace-with-this-name) |
| `Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#claude-code-reserves-this-name) |
| `Marketplace "<name>" is added but ignored` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#marketplace-is-added-but-ignored) |
| `Marketplace "<name>" is registered but was refused (see the debug log)` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#marketplace-is-added-but-ignored) |
| `references ${user_config.*} in a shell-form command` | [Plugin-Fehler](#plugin-command-references-user-config) |
| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin-Fehler](#plugin-command-references-user-config) |
| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin-Fehler](#plugin-command-references-user-config) |
| `Plugin archive integrity check failed` | [Plugin-Fehler](#plugin-archive-integrity-check-failed) |
| `An npm plugin source must name a registry package` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#an-npm-plugin-source-must-name-a-registry-package) |
| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |
| `does not load (...), so Claude Code ignores the whole file` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#does-not-load-so-claude-code-ignores-the-whole-file) |
| `path escapes plugin directory` | [Plugin-Fehler](#path-escapes-plugin-directory) |
| `path not read: <path> is absolute or has a ".." part` | [Plugin-Fehler](#server-file-path-not-read) |
| `Plugin not loaded: its manifest <path> was not read` | [Plugin-Fehler](#plugin-not-loaded-its-manifest-was-not-read) |
| `path couldn't be checked` / `path could not be checked` | [Plugin-Fehler](#path-could-not-be-checked) |
| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
| `Plugin source path refused` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
| `Failed to load marketplace configuration` | [Plugin-Fehler](#failed-to-load-marketplace-configuration) |
| `Marketplace configuration file is corrupted` | [Plugin-Fehler](#failed-to-load-marketplace-configuration) |
| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin-Fehler](#plugin-is-required-by-your-organization) |
| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [Plugin-Fehler](#plugin-was-not-uninstalled) |
| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Plugin-Fehler](#plugin-was-not-uninstalled) |
| `Plugin "<plugin>" was not uninstalled: installed_plugins.json` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#installed-plugins-json-holds-a-record-this-version-cannot-read) |
| `Plugin directory does not exist: <path>` | [Plugin-Fehlerbehebung](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-directory-does-not-exist) |
| `Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)` | [Plugin-Fehler](#skipping-connection-recent-failure-cached) |
| `is not added on this machine, so your organization's marketplace policy keeps its plugins off` | [Einen Marketplace hinzufügen](https://code.claude.com/docs/de/plugins/install.md#add-a-marketplace) |
| `A mod's http.fetch hook stopped this request` | [Mods ein- oder ausschalten](https://code.claude.com/docs/de/plugins/mods/overview.md#turn-mods-on-or-off) |
| `Error: No such tool available: <tool name>` | [Werkzeugfehler](#no-such-tool-available) |
| `MCP server "<name>" connection closed before the tool call was answered` | [Werkzeugfehler](#connection-closed-before-the-tool-call-was-answered) |
| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Tool-Fehler](#mcp-server-is-disabled) |
| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Werkzeugfehler](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |
| `Permission prompt tool returned an invalid result` | [Tool-Fehler](#permission-prompt-tool-returned-an-invalid-result) |
| `would be spawned with zero tools — refusing` | [Werkzeugfehler](#agent-would-be-spawned-with-zero-tools) |
| `File is covered by a Read deny rule in your permission settings` | [Werkzeugfehler](#file-is-covered-by-a-read-deny-rule) |
| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Tool-Fehler](#setting-blocks-writes-outside-the-working-directories) |
| `<path>: Writes outside the working directories are blocked (permissions.blockWritesOutsideWorkingDirectories)` | [Tool-Fehler](#setting-blocks-writes-outside-the-working-directories) |
| `Writes to Claude Code settings files are blocked while permissions.blockWritesOutsideWorkingDirectories is on` | [Tool-Fehler](#writes-to-claude-code-settings-files-are-blocked) |
| `cannot contain null bytes (\0)` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |
| `Path contains null bytes` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |
| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Tool-Fehler](#command-contains-an-invisible-character) |
| `This command's variables and substitutions expand to more text than the permission check reads, so it was not run` | Bitten Sie Claude, weniger oder kürzere Variablen und Ersetzungen zu verwenden. |
| `This call was not run. Claude Code could not confirm that the shell is back in the directory`, ab v2.1.323 | [Tool-Fehler](#command-approved-before-a-restart-was-not-run) |
| `File is too large to read as an image (the limit is 128MB)` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |
| `Cannot read this as an image: <path> is a pipe or a device` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |
| `could not fully check your permission rules` | [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves) |
| `subagent_type is required: the general-purpose agent is not available in this session` | [Werkzeugfehler](#subagent-type-is-required) |
| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Werkzeugfehler](#memory-index-is-over-its-read-limit) |
| `Sandbox is required but failed to initialize: <reason>` | [Sandboxing-Fehlerbehebung](https://code.claude.com/docs/de/sandboxing.md#commands-refused-with-sandbox-is-required) |
| `Sandbox is required (sandbox.failIfUnavailable) and stopped being available in this session: <reason>` | [Sandboxing-Fehlerbehebung](https://code.claude.com/docs/de/sandboxing.md#commands-refused-with-sandbox-is-required) |
| `pkill: refusing to run` | [Werkzeugfehler](#pkill-pattern-matches-the-claude-code-process) |
| `Sandbox settings can't be changed here` / `Sandbox settings are overridden by a higher-priority configuration` | [Sandboxing-Fehlerbehebung](https://code.claude.com/docs/de/sandboxing.md#sandbox-settings-overridden) |
| `Failed to write to <name>'s inbox — nothing was sent` | [Werkzeugfehler](#failed-to-write-to-a-teammate-inbox) |
| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Werkzeugfehler](#failed-to-write-to-a-teammate-inbox) |
| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Werkzeugfehler](#teammate-agent-definition-not-restored) |
| `Only a teammate can approve a shutdown request` | [Werkzeugfehler](#only-a-teammate-can-approve-a-shutdown-request) |
| `cannot be handed to a teammate intact` | [Tool-Fehler](#command-line-deny-rule-cannot-be-handed-to-a-teammate) |
| `Message too large for cross-session delivery` | [Werkzeugfehler](#message-too-large-for-cross-session-delivery) |
| `Too many messages to this session just now` | [Werkzeugfehler](#too-many-messages-to-this-session-just-now) |
| `Cross-session message was dropped at the recipient session's inbox` | [Werkzeugfehler](#cross-session-message-dropped-at-the-inbox) |
| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Werkzeugfehler](#refusing-to-send-a-cross-session-message) |
| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |
| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |
| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |
| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |
| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |
| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |
| `The search failed, so this is not a "no matches" result: matches may exist` | [Tool-Fehler](#the-search-failed) |
| `task output swap refused (tasks dir moved or linked)` | [Werkzeugfehler](#task-output-swap-refused) |
| `Command killed: its output file was replaced or could no longer be verified` | [Werkzeugfehler](#task-output-swap-refused) |
| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |
| `Disk full: a test write beside this command's output file` / `Disk quota used up: a test write beside this command's output file` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |
| `The command was not started: this computer's disk is full (ENOSPC)` / `the user's disk quota is used up (EDQUOT)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |
| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` / `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |
| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |
| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Werkzeugfehler](#file-is-not-valid-utf-8) |
| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [Tool-Fehler](#git-is-not-installed-on-this-mac) |
| `Refusing to apply edits to <path>: a hook is configured for file edits in this session` | [Tool-Fehler](#a-hook-is-configured-for-file-edits) |
| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |
| `the source file has the replacement character U+FFFD` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |
| `Not published: that file is on a network share` | [Werkzeugfehler](#not-published-that-file-is-on-a-network-share) |
| `Not published: Claude sent the same content again after a newer version of the artifact turned it away` / `Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away` | [Werkzeugfehler](#not-published-a-newer-version-of-the-artifact-turned-it-away) |
| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |
| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |
| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Werkzeugfehler](#webfetch-cannot-fetch-localhost) |
| `Claude Code is unable to fetch from ...` | [Tool-Fehler](#claude-code-is-unable-to-fetch-from-a-host) |
| `The safety check for domain ... is rate-limited` | [Werkzeugfehler](#webfetch-domain-safety-check-failed) |
| `The safety check for domain ... is temporarily rate-limited` | [Werkzeugfehler](#webfetch-domain-safety-check-failed) |
| `Unable to verify if domain ... is safe to fetch` | [Werkzeugfehler](#webfetch-domain-safety-check-failed) |
| `MCP tool "<tool>" on server "<server>" gave no answer that could be read` / `answered without its text` | [Wie das Ergebnis eines MCP-Tool-Hooks gelesen wird](https://code.claude.com/docs/de/hooks.md#how-the-tools-result-is-read) |
| `Can't open MCP settings while no terminal is attached to this background session` | [Fehler in Hintergrund-Sitzungen](#commands-refused-in-a-background-session) |
| `Can't open MCP settings in a background session` | [Fehler in Hintergrund-Sitzungen](#commands-refused-in-a-background-session) |
| `blocked because the path is spelled in a form that cannot be safely resolved` | [Fehler in Hintergrund-Sitzungen](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |
| `blocked because the path is network-shaped` | [Fehler in Hintergrund-Sitzungen](#write-or-command-blocked-because-the-path-names-a-network-location) |
| `is isolated in the worktree <path>, but this command <reason>. Refusing to run it` | [Fehler in Hintergrund-Sitzungen](#command-blocked-by-the-worktree-isolation-checks) |
| `too complex to verify that it stays inside the worktree` | [Fehler in Hintergrund-Sitzungen](#command-blocked-by-the-worktree-isolation-checks) |
| `This session has no saved transcript` | [Fehler in Hintergrund-Sitzungen](#this-session-has-no-saved-transcript) |
| `Can't open — this session is running in another terminal` | [Fehler in Hintergrund-Sitzungen](#this-session-is-running-in-another-terminal) |
| `This conversation is already open in another running Claude session` | [Fehler in Hintergrund-Sitzungen](#this-session-is-running-in-another-terminal) |
| `This session's saved conversation is no longer on disk` | [Fehler in Hintergrund-Sitzungen](#this-sessions-saved-conversation-is-no-longer-on-disk) |
| `This forked session could not be started. Fork the conversation again to retry.` | [Fehler bei Hintergrundsitzungen](#this-forked-session-could-not-be-started) |
| `Bypass permissions was requested at launch and ignored` | [Bypass permissions in einer Hintergrund-Sitzung ignoriert](https://code.claude.com/docs/de/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |
| `kept <id> — its worktree is still at <path>` | [Fehler bei Hintergrundsitzungen](#worktree-has-commits-that-are-not-pushed-anywhere), wenn die nächste Zeile der Meldung nicht gepushte Commits erwähnt, andernfalls [Was beim Löschen einer Sitzung entfernt wird](https://code.claude.com/docs/de/agent-view.md#what-deleting-a-session-removes) |
| `kept <id> — <n> unpushed commits on <branch>` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |
| `kept <id> — worktree has commits that are not pushed anywhere` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |
| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [Fehler in Hintergrund-Sitzungen](#terminal-host-process-died) |
| `Session isn't responding` / `Press enter again to restart this session — it isn't responding` | [Fehler in Hintergrund-Sitzungen](#session-isnt-responding) |
| `Session <id> was stopped while the respawn was in flight` | [Fehler in Hintergrund-Sitzungen](#session-was-stopped-while-the-respawn-was-in-flight) |
| `This session was running agent '<name>', which is no longer available` | [Fehler in Hintergrund-Sitzungen](#session-agent-no-longer-available) |
| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Fehler in Hintergrund-Sitzungen](#restarted-after-its-next-loop-wakeup-was-due) |
| `No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder` | [Fehler in Hintergrund-Sitzungen](#no-llm-gateway-opened-from-another-folder) |
| `No LLM gateway: opened from another folder · respawn from <folder>` | [Fehler in Hintergrund-Sitzungen](#no-llm-gateway-opened-from-another-folder) |
| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Fehler in Hintergrund-Sitzungen](#claude_code_process_wrapper-launcher-errors) |
| `EUNKNOWN: unknown error, uv_spawn` | [Fehler in Hintergrund-Sitzungen](#eunknown-when-starting-a-background-session) |
| `EACCES: permission denied, posix_spawn` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |
| `exited before it became reachable` | [Fehler in Hintergrund-Sitzungen](#background-service-exited-before-it-became-reachable) |
| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Fehler in Hintergrund-Sitzungen](#working-directory-no-longer-exists-when-starting-a-background-session) |
| `Workspace not trusted.` beim Starten oder Neustarten einer Hintergrund-Sitzung | [Fehler in Hintergrund-Sitzungen](#workspace-not-trusted-when-dispatching-a-background-session) |
| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |
| `Claude Code process exited with code N` | [Wrapper- und IDE-Fehler](#claude-code-process-exited-with-code-n) |
| `Subprocess initialization did not complete within 60000ms` | [Wrapper- und IDE-Fehler](#subprocess-initialization-did-not-complete-within-60000ms) |
| `Claude Code did not finish starting` | [Wrapper- und IDE-Fehler](#subprocess-initialization-did-not-complete-within-60000ms) |
| `The connection to Claude Code ended before this message completed` | [Wrapper- und IDE-Fehler](#the-connection-to-claude-code-ended-before-this-message-completed) |
| `Could not locate the Claude CLI on PATH` | [Wrapper- und IDE-Fehler](#could-not-locate-the-claude-cli-on-path) |
| `The Claude Code program for this computer, the <build> build, could not be found` | [Wrapper- und IDE-Fehler](#the-claude-code-program-for-this-computer-could-not-be-found) |
| `Restored the code, but skipped N files` | [Rewind-Warnungen und Fehler](#restored-the-code-but-skipped-files) |
| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind-Warnungen und Fehler](#no-files-were-restored) |
| `Couldn't restore N files: the backup is missing or the file can't be written` | Machen Sie die fehlgeschlagenen Dateien beschreibbar und stellen Sie sie dann aus der Versionskontrolle wieder her. |
| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | Wählen Sie in [`/rewind`](https://code.claude.com/docs/de/checkpointing) erneut denselben Punkt aus. Wenn Sie Code kurz nach [`/branch`](https://code.claude.com/docs/de/sessions#branch-a-session) wiederherstellen, kopiert Claude Code die Dateisicherungen möglicherweise noch in die neue Sitzung. |
| `Transcript writes are failing (...)` | [Warnungen zum Speichern von Sitzungen](#transcript-writes-are-failing) |
| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Warnungen zum Speichern von Sitzungen](#transcript-saving-is-off-skip-prompt-history) |
| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Warnungen zum Speichern von Sitzungen](#transcript-saving-is-off-child-session-marker) |
| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Vollbildrendering](https://code.claude.com/docs/de/fullscreen.md#fullscreen-renderer-didnt-finish-starting) |
| `Claude Code exited after an unrecoverable interface error (...)` | [Konfigurationswarnungen](#exited-after-an-unrecoverable-interface-error) |
| `Agent descriptions are over the 15.0k-token limit` | [Konfigurationswarnungen](#agent-descriptions-are-over-the-15000-token-limit) |
| `declares type "claudeai-proxy", which only claude.ai connectors use` | Entfernen Sie den Eintrag aus Ihrer MCP-Konfiguration. Siehe [MCP-Server von claude.ai verwenden](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai). |
| `hook needs quotes around a path with a space` | [Konfigurationswarnungen](#hook-needs-quotes-around-a-path-with-a-space) |
| `Instruction file not loaded` | [Konfigurationswarnungen](#instruction-file-not-loaded) |
| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Konfigurationswarnungen](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |
| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Konfigurationswarnungen](#skill-or-command-name-refused) |
| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Konfigurationswarnungen](#workspace-has-not-been-trusted) |
| `Two Claude Code config files exist: this run uses <path>, not <path>` | [Konfigurationswarnungen](#two-claude-code-config-files-exist) |
| `a settings change wasn't saved` | Machen Sie `~/.claude/settings.json` und die `.claude/settings.local.json` des Projekts beschreibbar und nehmen Sie die Änderung dann erneut vor. Wenn ein anderes Tool die Datei generiert, siehe [Eine Änderung geht in neuen Sitzungen verloren](https://code.claude.com/docs/de/settings.md#a-change-you-made-in-claude-code-is-lost-in-new-sessions). Wenn eine Datei nicht gültig ist, siehe [Eine fehlerhafte Einstellungsdatei reparieren](https://code.claude.com/docs/de/settings.md#fix-a-broken-settings-file). |
| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Konfigurationswarnungen](#make-this-change-again-later) |
| `is a network path, which cannot be added as a working directory` | [Konfigurationswarnungen](#working-directory-is-a-network-path) |
| `Remote managed settings failed to load (<cause>)` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |
| `Your organization requires remote managed settings to load, but they could not be loaded` | [Fail-Closed-Start erzwingen](https://code.claude.com/docs/de/server-managed-settings.md#enforce-fail-closed-startup) |
| `Remote managed settings are still loading` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |
| `Remote managed settings did not load` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |
| `Claude Code couldn't load your organization's settings` / `Claude Code couldn't reach Anthropic to load your organization's settings` / `requires them before a session can start` | [Konfigurationswarnungen](#couldnt-load-your-organizations-settings) |
| `Claude Code can't start this session yet` | [Konfigurationswarnungen](#couldnt-load-your-organizations-settings) |
| `Your Claude session has expired. Sign in again to continue (claude auth login).` | [Konfigurationswarnungen](#couldnt-load-your-organizations-settings) |
| `Managed settings were not approved; exiting without applying them.` | [Konfigurationswarnungen](#managed-settings-were-not-approved) |
| `Your organization's managed settings need your approval, which couldn't be asked for here.` | [Konfigurationswarnungen](#managed-settings-need-your-approval) |
| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Konfigurationswarnungen](#managed-settings-block-the-default-model) |
| `Your organization's managed settings allow Claude Code to use: <providers>` | [Konfigurationswarnungen](#managed-settings-dont-allow-this-api-provider) |
| `Your organization's managed settings allow Claude Code to use no API provider at all` | [Konfigurationswarnungen](#managed-settings-dont-allow-this-api-provider) |
| `MCP server <name> is blocked by enterprise managed policy` | [Konfigurationswarnungen](#mcp-server-is-blocked-by-enterprise-managed-policy) |
| `"<name>" is a reserved MCP server name and was not loaded` | [Konfigurationswarnungen](#mcp-server-name-is-reserved) |
| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Konfigurationswarnungen](#managed-settings-document-could-not-be-parsed) |
| `Managed settings drop-in directory could not be read` | [Konfigurationswarnungen](#managed-settings-document-could-not-be-parsed) |
| `Unable to read managed policy settings` | [Konfigurationswarnungen](#unable-to-read-managed-policy-settings) |
| `Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded; fix or remove each entry:` | [Konfigurationswarnungen](#managed-settings-hooks-not-loaded) |
| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Konfigurationswarnungen](#otelheadershelper-failed) |
| `apply_flag_settings: nothing in this request was applied and earlier settings stay in force. Fix or remove these invalid settings and send it again` | [`applyFlagSettings()`](https://code.claude.com/docs/de/agent-sdk/typescript#applyflagsettings) |
| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Konfigurationswarnungen](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |
| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Konfigurationswarnungen](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |
| `headersHelper not run — this workspace has no persisted trust` | [Konfigurationswarnungen](#headershelper-not-run) |
| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Konfigurationswarnungen](#malformed-tool-content-rule) |
| `matches no tool · check for typos` / `matches no known tool — check for typos` | [Konfigurationswarnungen](#matches-no-tool) |
| `... is not matched by file permission checks` | [Konfigurationswarnungen](#is-not-matched-by-file-permission-checks) |
| `Write(<path>) never matches · use Edit(<path>)` / `Glob(<path>) never matches · use Read(<path>)` | [Konfigurationswarnungen](#is-not-matched-by-file-permission-checks) |
| `... has a wildcard before the rest of the command` | [Konfigurationswarnungen](#has-a-wildcard-before-the-rest-of-the-command) |
| `allows any option at its * · use an exact value` | [Konfigurationswarnungen](#has-a-wildcard-before-the-rest-of-the-command) |
| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Konfigurationswarnungen](#denying-bash-also-turns-off-the-powershell-tool) |
| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Konfigurationswarnungen](#the-200k-limit-isnt-enforced) |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" reads as <N> tokens, so Claude Code treats it as the 100k minimum` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/de/model-config#claude_code_auto_compact_window-values) |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" is too large, so Claude Code treats it as the 1M maximum` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/de/model-config#claude_code_auto_compact_window-values) |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/de/model-config#claude_code_auto_compact_window-values) |
| `Model "<model>" isn't recognized · context assumed to be <N> tokens` / `Claude Code doesn't recognize the model "<model>", so it assumes a context window of <N> tokens` | [Das Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |
| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [Einen falsch geschriebenen Modellnamen korrigieren](https://code.claude.com/docs/de/model-config.md#fix-a-mistyped-model-name) |
| `[claude-code:unrecognized_model]` | [Konfigurationswarnungen](#unrecognized-model-id-on-a-request) |
| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Konfigurationswarnungen](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |
| `Sandbox mask files left behind at write-deny paths` | [Konfigurationswarnungen](#stale-sandbox-mask-files-left-by-a-killed-session) |
| `Stale sandbox mask files left by a killed session` | [Konfigurationswarnungen](#stale-sandbox-mask-files-left-by-a-killed-session) |
| `Ubuntu's AppArmor restriction on user namespaces stops bubblewrap here` | [Fehlerbehebung beim Sandboxing](https://code.claude.com/docs/de/sandboxing.md#apparmor-restriction-stops-bubblewrap) |
| `bwrap: setting up uid map: Permission denied` / `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` | [Fehlerbehebung beim Sandboxing](https://code.claude.com/docs/de/sandboxing.md#bwrap-uid-map-permission-denied) |
| Antworten scheinen von geringerer Qualität als üblich | [Antwortqualität](#responses-seem-lower-quality-than-usual) |

## Automatische Wiederholungsversuche

Claude Code versucht vorübergehende Fehler bis zu 10-mal mit exponentiellem Backoff erneut, bevor Ihnen ein Fehler angezeigt wird. Einen Fehler, der auftritt, während Claudes Antwort noch läuft, versucht Claude Code nicht immer erneut. Wenn Sie einen der Fehler auf dieser Seite sehen, hat Claude Code bereits alle für diesen Fehler vorgesehenen Wiederholungsversuche durchgeführt.

Claude Code versucht diese Fehler erneut:

* Serverfehler, Überlastungsantworten und Anfrage-Timeouts, die eintreffen, bevor ein Teil von Claudes Antwort gestreamt wurde.
* Ein Serverfehler oder eine Überlastungsantwort, die eintrifft, nachdem Claude das Nachdenken abgeschlossen, aber noch keinen Text und keinen Tool-Aufruf begonnen hat. Claude Code versucht einen Serverfehler an diesem Punkt bis zu zweimal erneut. Vor v2.1.284 beendete Claude Code den Turn an diesem Punkt mit dem Fehler.
* Unterbrochene Verbindungen. Wenn eine Verbindung während einer Anfrage unterbrochen wird, bevor Claude einen Teil seiner Antwort abgeschlossen hat, einschließlich seines Thinking, sendet Claude Code die Anfrage mit demselben Backoff erneut, und der Turn wird fortgesetzt, auch wenn bereits etwas Text gestreamt wurde. Wird die Verbindung unterbrochen, nachdem Claude das Nachdenken abgeschlossen, aber noch keinen Text und keinen Tool-Aufruf begonnen hat, sendet Claude Code die Anfrage stattdessen bis zu zweimal schnell hintereinander erneut und beendet den Turn mit `Connection lost before a response was produced`, wenn die Verbindung an diesem Punkt weiterhin abbricht.
* Eine Verbindung, bei der Claude Code erkennt, dass sie unterbrochen wurde, weil Ihr Computer während einer Anfrage in den Ruhezustand gewechselt ist. Claude Code behandelt sie als unterbrochene Verbindung gemäß den obigen Regeln; sobald das Label für den Wiederholungsversuch den konkreten Grund nennt, lautet es `Connection lost while your computer was asleep`, und wenn der Turn endet, nachdem Claude das Nachdenken abgeschlossen, aber noch keinen Text und keinen Tool-Aufruf begonnen hat, lautet die Meldung `Your computer went to sleep before a response was produced`.
* Ein stockender Antwort-Stream, wenn die Response-Header eingetroffen sind, aber noch nichts von Claudes Antwort angekommen ist, oder wenn Claude das Nachdenken abgeschlossen, aber noch keinen Text und keinen Tool-Aufruf begonnen hat: Claude Code bricht die stockende Verbindung ab und streamt die Anfrage höchstens einmal erneut. Stockt die Antwort ein zweites Mal, nachdem Claude das Nachdenken abgeschlossen, aber noch keinen Text und keinen Tool-Aufruf begonnen hat, beendet Claude Code den Turn mit `The response stalled before a response was produced`.
* Eine Streaming-Anfrage, die die API nie mit Response-Headern beantwortet, auf einer Verbindung, bei der die [First-Byte-Deadline gilt](https://code.claude.com/docs/de/network-config.md#streaming-idle-watchdogs). Bei Erreichen der Deadline bricht Claude Code die Anfrage ab und sendet sie innerhalb des Budgets für Wiederholungsversuche erneut. Greift die Deadline auch bei einem erneuten Senden, endet der Turn mit [No response from API](#no-response-from-api). Wenn Sie `CLAUDE_CODE_RETRY_WATCHDOG` setzen, sendet Claude Code die Anfrage stattdessen innerhalb des Budgets weiterhin erneut.
* Eine Streaming-Antwort, die der Inhaltsfilter für die Ausgabe der API stoppt, bevor Claude entweder das Nachdenken abgeschlossen oder einen Text oder Tool-Aufruf begonnen hat. Claude Code sendet die Anfrage einmal erneut, innerhalb des Budgets für Wiederholungsversuche, und zeigt [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) an, wenn der Filter auch die zweite Antwort stoppt.
* Vorübergehende 429-Drosselungen, jedoch nicht die `429` eines Gateways wegen eines Ausgabenlimits, die keine Drosselung ist; siehe [Spend limit reached](#spend-limit-reached).
  * Wenn Sie mit einem claude.ai-Abonnement angemeldet sind, gehören dazu auch 429-Drosselungen, die nicht die Kontingent-Header Ihres Plans enthalten. Vor v2.1.199 versuchte Claude Code diese Drosselungen nur bei Anmeldungen mit API-Schlüssel und Enterprise erneut.
* Eine Anfrage, die abgelehnt wird, weil die Eingabe zuzüglich `max_tokens` das Kontextlimit überschreitet. Ein unverändertes erneutes Senden würde auf dieselbe Weise fehlschlagen, daher versucht Claude Code es mit einem reduzierten `max_tokens` erneut und beendet die Wiederholungsversuche und komprimiert stattdessen in zwei Fällen:
  * Wenn keine Reduzierung ausreicht, zum Beispiel wenn die Konversation selbst das Kontextfenster fast vollständig ausfüllt.
  * Wenn ein Wiederholungsversuch `max_tokens` nicht weiter verringern kann. Vor v2.1.218 konnte Claude Code eine reduzierte Anfrage, die immer noch nicht passte, etwa wenn das Budget für Extended Thinking den verbleibenden Kontext überschritt, so lange erneut senden, bis das Budget für Wiederholungsversuche aufgebraucht war.
* Eine Antwort, die angibt, dass Claude ein Tool aufruft, aber keinen Tool-Aufruf enthält. Claude Code versucht es erneut, indem es Claude bis zu zweimal um den Tool-Aufruf bittet. Schlagen beide Wiederholungsversuche auf dieselbe Weise fehl, sehen Sie `The model's tool call could not be parsed (retry also failed).`, und der Turn endet. Um es erneut zu versuchen, senden Sie eine weitere Nachricht. Vor v2.1.307 versuchte Claude Code es einmal erneut, bevor der Turn beendet wurde.
* Abgelaufene oder fehlende Google Cloud-Anmeldedaten auf der [Agent Platform von Google Cloud](https://code.claude.com/docs/de/google-vertex-ai.md) oder AWS-Anmeldedaten, die auf Ihrem Rechner nicht geladen werden können. Claude Code verwirft seine zwischengespeicherten Anmeldedaten, versucht es bis zu zweimal erneut und meldet dann den Fehler, damit Sie sich sofort erneut authentifizieren können, wie unter [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials) beschrieben. Vor v2.1.228 versuchte Claude Code fehlerhafte Google Cloud-Anmeldedaten über das gesamte Budget für Wiederholungsversuche erneut, bevor der Fehler angezeigt wurde.
* Ein `401` oder `403` von der Anthropic API, direkt oder über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway), während ein [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Skript die Anmeldedaten liefert. Claude Code führt das Skript erneut aus und versucht es mit dessen neuer Ausgabe erneut, innerhalb des vollständigen Budgets für Wiederholungsversuche. Schlägt das Skript selbst bei der erneuten Ausführung fehl, zeigt Claude Code stattdessen [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing) an.

Vor v2.1.227 lautete `Connection lost before a response was produced` noch `Connection closed while thinking, before producing a response` und `The response stalled before a response was produced` noch `Response stalled while thinking, before producing a response`.

Claude Code versucht diese Fehler nicht erneut:

* Einen Fehler bei der Validierung eines TLS-Zertifikats, etwa durch einen TLS-inspizierenden Proxy, ein fehlendes `NODE_EXTRA_CA_CERTS`-Bundle oder ein abgelaufenes Zertifikat. Claude Code meldet den Fehler beim ersten Versuch, damit Sie die Zertifikatseinrichtung sofort korrigieren können; siehe [SSL certificate errors](#ssl-certificate-errors). Vorübergehende TLS-Probleme wie ein Handshake-Timeout versucht Claude Code weiterhin erneut. Vor v2.1.199 versuchte Claude Code Zertifikatsfehler über das gesamte Budget für Wiederholungsversuche erneut, bevor der Fehler angezeigt wurde.
* Einen Serverfehler, eine unterbrochene Verbindung oder einen stockenden Stream, der eintritt, nachdem Claude einen Textblock oder einen Tool-Aufruf abgeschlossen oder nach dem Nachdenken begonnen hat, aber bevor Claude die Antwort beendet hat. Claude Code führt die Anfrage nicht erneut aus, da dadurch dieselben Tool-Aufrufe zweimal ausgeführt werden könnten. Es behält bei, was Claude abgeschlossen hat, führt alle Tool-Aufrufe aus, die Claude fertiggestellt hat, und setzt den Turn mit deren Ergebnissen fort. Was Sie in einer interaktiven und in einer nicht interaktiven Sitzung sehen, erfahren Sie unter [The response above may be incomplete](#the-response-above-may-be-incomplete). Vor v2.1.199 verwarf Claude Code die unvollständige Ausgabe und meldete den gesamten Turn als Fehler, wenn während des Streams ein Serverfehler eintraf.
* Einen Fehler, der eintritt, nachdem Claude die Antwort beendet hat: Es muss nichts erneut versucht werden, daher behält Claude Code die vollständige Antwort und beendet den Turn normal.
* Eine [Amazon Bedrock-Streaming-Antwort mit unerwartetem Content-Type](#bedrock-streaming-response-has-an-unexpected-content-type), da das Gateway oder der Proxy, der die Antwort umschreibt, den Wiederholungsversuch auf dieselbe Weise umschreiben würde. Erfordert Claude Code v2.1.208 oder höher.
* Einen Wiederholungsversuch ohne Streaming für eine fehlgeschlagene Streaming-Anfrage, der einen Erfolgsstatus, aber [keine Claude API-Nachricht im Body](#api-returned-an-empty-or-malformed-response) erhält. Claude Code beendet den Turn mit diesem Fehler.
* Eine Anfrage, die von der Richtlinienprüfung Ihrer Organisation abgelehnt wurde; dies erscheint als `API Error:`-Zeile mit der Ablehnungsmeldung. Die Administratoren Ihrer Organisation richten die Prüfung mit [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks) ein, einer Funktion von Claude Enterprise, und die Meldung endet mit den von ihnen konfigurierten Anweisungen oder fordert Sie standardmäßig auf, sich an sie zu wenden. Claude Code sendet die abgelehnte Anfrage weder erneut an dasselbe Modell noch an ein [Fallback-Modell](https://code.claude.com/docs/de/model-config.md#fallback-model-chains), da sich die Ablehnung auf den Inhalt der Anfrage und nicht auf das Modell bezieht. Vor v2.1.239 konnte Claude Code eine abgelehnte Anfrage ohne Streaming oder an ein konfiguriertes Fallback-Modell erneut senden, bevor Ihnen die Ablehnung angezeigt wurde.

### Was Sie sehen, während Claude Code es erneut versucht oder wartet

Während der Wiederholungsversuche zeigt der Spinner nach einem Fehler-Label einen Countdown `Retrying in Ns · attempt x/y` an. Bei Fehlern, auf die Sie sofort reagieren können, nennt das Label den konkreten Grund bereits ab dem ersten Versuch: Das Netzwerk ist nicht verfügbar, ein TLS-Handshake ist fehlgeschlagen, oder Sie haben ein Rate-Limit erreicht. Bei anderen Fehlern lautet es zunächst `API error`. Ab v2.1.198 wechselt es ab dem dritten Versuch zum konkreten Grund oder beim letzten Versuch, wenn `CLAUDE_CODE_MAX_RETRIES` weniger als drei Versuche zulässt; frühere Versionen wechseln erst beim letzten Versuch.

Ab v2.1.198 wird der übliche Spinner-Tipp während der Wiederholungsversuche ausgeblendet. Sobald der Fehlergrund angezeigt wird und es sich um eine 529-Überlastung handelt, nennt die Zeile unter dem Countdown außerdem, wo Sie den Dienststatus prüfen können: `status.claude.com` bei der Anthropic API oder bei anderen Konfigurationen den in der Meldung genannten Anbieter- oder Gateway-Host.

#### Waiting for API response

Das Banner `Waiting for API response · will retry in … · check your network` bedeutet, dass Claude Code mindestens 20 Sekunden gewartet hat, ohne Daten für eine Anfrage zu empfangen. Die Anfrage ist noch nicht fehlgeschlagen: Der Countdown läuft bis zu dem Zeitpunkt, an dem Claude Code die stockende Verbindung abbricht. Erfolgt der Abbruch:

* Bevor Claude einen Textblock oder einen Tool-Aufruf abgeschlossen oder nach dem Nachdenken begonnen hat, versucht Claude Code die Anfrage erneut oder beendet den Turn mit einem Fehler. Unter [Automatische Wiederholungsversuche](#automatic-retries) steht, welche Stockungen erneut versucht werden und wie oft.
* Nachdem Claude einen Textblock oder einen Tool-Aufruf abgeschlossen oder nach dem Nachdenken begonnen hat, aber bevor Claude die Antwort beendet hat, behält Claude Code bei, was Claude abgeschlossen hat, setzt den Turn mit allen Tool-Aufrufen fort, die Claude fertiggestellt hat, und zeigt [The response above may be incomplete](#the-response-above-may-be-incomplete) an. In einer nicht interaktiven Sitzung und bei der Antwort eines Subagenten in jeder Sitzung fordert Claude Code Claude möglicherweise zunächst auf, die Antwort fortzusetzen; dieser Eintrag erklärt, wann das geschieht und wann Sie den Hinweis dort trotzdem sehen.
* Nachdem Claude die Antwort beendet hat, beendet Claude Code den Turn normal.

Das Banner verschwindet von selbst, sobald wieder Daten eintreffen oder ein Wiederholungsversuch erfolgreich ist. Erscheint es bei jedem Versuch erneut, behandeln Sie es als [Netzwerkproblem](#unable-to-connect-to-api). Wenn Sie sich über ein Gateway verbinden, siehe [Das Warte-Banner erscheint und verschwindet hinter einem Gateway](#waiting-banner-behind-a-gateway). Vor v2.1.185 erschien das Banner nach 10 Sekunden mit anderem Wortlaut.

#### Das Warte-Banner erscheint und verschwindet hinter einem Gateway

Wenn das Banner `Waiting for API response` erscheint und wieder verschwindet, während Claude nachdenkt, und Sie sich über ein Gateway verbinden, [aktualisieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#update-claude-code) auf v2.1.309 oder höher. Das Banner erscheint bei diesen Verbindungen nach 45 Sekunden ohne Daten:

* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) ist auf einen anderen Host als die Anthropic API gesetzt, etwa ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway)
* Eine Sitzung über das [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway)
* [Claude Platform on AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md) mit gesetztem `ANTHROPIC_AWS_BASE_URL`

Vor v2.1.309 erschien das Banner bei diesen Verbindungen nach 20 Sekunden.

### Verhalten bei Wiederholungsversuchen anpassen

Sie können das Verhalten bei Wiederholungsversuchen mit diesen Umgebungsvariablen anpassen:

| Variable | Standard | Wirkung |
| :- | :- | :- |
| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/de/env-vars) | 10 | Anzahl der Wiederholungsversuche. Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standardwert und hebt die Begrenzung auf. Verringern Sie den Wert, damit Fehler in Skripten schneller sichtbar werden. |
| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/de/env-vars) | nicht gesetzt | Setzen Sie den Wert in unbeaufsichtigten Sitzungen wie CI-Jobs auf `1`, um `429`- und `529`-Kapazitätsfehler unbegrenzt erneut zu versuchen, statt nach `CLAUDE_CODE_MAX_RETRIES` Versuchen abzubrechen. Claude Code bricht sofort ab, wenn eine Anfrage mit Standardgeschwindigkeit eine `429` erhält, die ein Ausgabenlimit oder aufgebrauchtes Nutzungsguthaben meldet, auch wenn sie von einer [Ausgabenobergrenze eines Gateways](#spend-limit-reached) stammt, die nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 versuchte der Watchdog diese unbegrenzt erneut. Für Anfragen im Fast-Modus siehe [Rate-Limits handhaben](https://code.claude.com/docs/de/fast-mode.md#handle-rate-limits). Ab v2.1.199 erhöht sie außerdem die Standardanzahl der Wiederholungsversuche für andere vorübergehende Fehler wie Serverfehler, Timeouts und unterbrochene Verbindungen auf 300, was etwa drei Stunden Backoff entspricht, und hebt die Begrenzung von `CLAUDE_CODE_MAX_RETRIES` auf 15 auf, wenn Sie diese Variable explizit setzen. |
| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/docs/de/env-vars) | nicht gesetzt | Maximale Zeit in Millisekunden, die jede API-Anfrage mit dem Abwarten von `429`- und `529`-Fehlern verbringt, wenn `CLAUDE_CODE_RETRY_WATCHDOG` gesetzt ist. Ist die Variable nicht gesetzt, ist die Wartezeit unbegrenzt. Erfordert Claude Code v2.1.295 oder höher. |
| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | keine Obergrenze | Bei gesetztem `CLAUDE_CODE_RETRY_WATCHDOG` die längste Zeit in Millisekunden, die eine Anfrage darauf wartet, dass das [Nutzungslimit](#youve-hit-your-session-limit) Ihres Plans, etwa das Sitzungs- oder Wochenlimit, zurückgesetzt wird. Liegt das Zurücksetzen weiter entfernt als diese Obergrenze, schlägt die Anfrage sofort fehl, es sei denn, das Nutzungsguthaben bietet noch Spielraum oder die API konnte es nicht prüfen. In diesen Fällen wird die Anfrage erneut versucht und schlägt fehl, wenn die Obergrenze verstreicht, bevor sie erfolgreich ist. Erfordert Claude Code v2.1.301 oder höher. |
| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/de/env-vars) | nicht gesetzt | Mindestabstand in Millisekunden zwischen Prüfungen, ob ein [Nutzungslimit](#youve-hit-your-session-limit) bereits aufgehoben wurde, während eine Anfrage bei gesetztem `CLAUDE_CODE_RETRY_WATCHDOG` auf das Zurücksetzen dieses Limits wartet. Stellt eine Prüfung fest, dass das Limit aufgehoben ist, wird die Anfrage sofort gesendet. Geben Sie nur Ziffern von `60000` bis `10800000` an. Ist die Variable nicht gesetzt oder liegt der Wert außerhalb dieses Bereichs, finden keine Prüfungen statt. Wann Claude Code diese Prüfungen überspringt, erfahren Sie in der [Referenz der Umgebungsvariablen](https://code.claude.com/docs/de/env-vars.md). Erfordert Claude Code v2.1.305 oder höher. |
| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/de/env-vars) | 500 | Anfängliche Verzögerung des Backoffs in Millisekunden zwischen Wiederholungsversuchen einer Anfrage, die die API mit einem `529`-Überlastungsfehler ablehnt. Erhöhen Sie den Wert auf bis zu 32000, um die Wiederholungsversuche über einen längeren Zeitraum zu verteilen, wenn die API ausgelastet ist. Hat keine Wirkung, wenn `CLAUDE_CODE_RETRY_WATCHDOG` auf `1` gesetzt ist oder wenn die abgelehnte Anfrage im [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md#handle-rate-limits) gesendet wurde. Erfordert Claude Code v2.1.292 oder höher. |
| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/de/env-vars) | 32000 | Obergrenze des Backoffs in Millisekunden zwischen Wiederholungsversuchen einer Anfrage, die die API mit einem `529`-Überlastungsfehler ablehnt. Erhöhen Sie den Wert auf bis zu 300000, damit spätere Wiederholungsversuche zeitlich weiter auseinanderliegen, wenn die API ausgelastet ist. Werte über 64000 erfordern v2.1.323 oder höher. Hat in denselben Fällen keine Wirkung wie `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`. Erfordert Claude Code v2.1.296 oder höher. |
| [`API_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars) | 600000 | Zeit in Millisekunden, die jeder Anfrageversuch hat, um seine Response-Header zu empfangen. Sie begrenzt nicht, wie lange eine Streaming-Antwort danach läuft. Erhöhen Sie den Wert bei langsamen Netzwerken oder Proxys. Wie der Wert die First-Byte-Deadline begrenzt, erfahren Sie unter [No response from API](#no-response-from-api). |
| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/de/env-vars) | nicht gesetzt | Begrenzung für das erneute Senden einer [Anfrage ohne Streaming](#streaming-response-ended-before-any-complete-data-was-received), bei der eine Zeitüberschreitung auftritt. Ist die Grenze erreicht, schlägt die Anfrage fehl. Eine Antwort von Claude, deren Generierung länger als der Timeout dauert, läuft bei jedem erneuten Senden wieder in eine Zeitüberschreitung; setzen Sie daher einen niedrigen Wert wie `0`, damit die Anfrage schneller fehlschlägt. Den Timeout jedes Versuchs finden Sie unter [Wie lange ein Versuch ohne Streaming wartet](#how-long-a-non-streaming-attempt-waits). Erfordert Claude Code v2.1.285 oder höher. |
| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars) | nicht gesetzt | Deadline in Millisekunden für das erste Antwort-Byte einer Streaming-Anfrage. Erfordert Claude Code v2.1.242 oder höher. Wie Claude Code die Deadline wählt, wenn diese Variable nicht gesetzt ist, erfahren Sie unter [No response from API](#no-response-from-api). |

#### Wie lange ein Versuch ohne Streaming wartet

Ein Versuch ohne Streaming endet bei seinem Anfrage-Timeout oder beim Body-Idle-Timeout, je nachdem, was zuerst eintritt:

* **Anfrage-Timeout**: `API_TIMEOUT_MS`, wenn Sie einen positiven Wert setzen, andernfalls 300 Sekunden in einer lokalen Sitzung.
* **[Body-Idle-Timeout](https://code.claude.com/docs/de/network-config.md#streaming-idle-watchdogs)**: 5 bis 6 Minuten ohne Antwort, unabhängig davon, wie hoch Sie `API_TIMEOUT_MS` setzen, sofern er aktiv ist und Sie ihn nicht ausgeschaltet haben.

## Serverfehler

Die meisten dieser Fehler stammen vom Inferenzanbieter: Anthropic's Service auf der Anthropic API und dem Service hinter dem Endpunkt dieses Anbieters auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem benutzerdefinierten Gateway. [Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen](#auto-mode-cannot-determine-the-safety-of-an-action) und [Agent wurde vorzeitig aufgrund eines API-Fehlers beendet](#agent-terminated-early-due-to-an-api-error) behandeln auch Ursachen auf Ihrer Seite, wie z. B. ein Amazon Bedrock-Konto, das das Klassifikatormodell nicht aufrufen kann, oder einen Subagenten, der ein Nutzungslimit erreicht hat.

### 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:

```text theme={null}
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 nennt den Ort, an dem die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen nennen die Servicestatusseite dieses Anbieters. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.

Ein 5xx von der API selbst zeigt einen unerwarteten Fehler innerhalb der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.

Wenn ein Proxy, Load Balancer oder Gateway mit einer HTML-Fehlerseite antwortet, zeigt die Nachricht den Statuscode und den Titel der Seite an, wie z. B. `API Error: 502 Bad Gateway`. Für eine Seite ohne Titel zeigt die Nachricht stattdessen den Statuscode und seinen Standardnamen an. Vor v2.1.281 wurde der Statuscode weggelassen, wenn die Seite einen Titel hatte, und das rohe Markup der Seite wurde ausgegeben, wenn sie keinen hatte.

**Was zu tun ist:**

* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Nachricht genannte Anbieter-Statusseite auf aktive Vorfälle
* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.
* Wenn [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) auf ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) verweist und jede Anfrage auf diese Weise fehlschlägt, prüfen Sie, ob Ihr Gateway und dessen Upstream die Felder für die [Tool-Suche](https://code.claude.com/docs/de/mcp.md#tool-search-through-a-gateway) akzeptieren. Standardmäßig sendet Claude Code `defer_loading`-Tool-Felder und `tool_reference`-Blöcke zusammen mit dem `anthropic-beta`-Header, der sie aktiviert. Vor v2.1.304 war die Tool-Suche hinter einem Gateway deaktiviert, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` aktiviert hatten.
* Wenn der Fehler ohne einen veröffentlichten Vorfall weiterhin auftritt, führen Sie `/feedback` aus, damit Anthropic Ihre Anfrageinformationen untersuchen kann. Siehe [Fehler melden](#report-an-error), 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 es bereits mehrmals erneut versucht, bevor diese Nachricht angezeigt wird:

```text theme={null}
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 ist nicht Ihr Nutzungslimit und wird nicht auf Ihr Kontingent angerechnet.

**Was zu tun ist:**

* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Nachricht genannte Anbieter-Statusseite 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, z. B. `Opus is experiencing high load, please use /model to switch to Sonnet`. Bei Fable-Modellen nennt die Nachricht Fable.

  In einer Sitzung, die die Claude Desktop-App ausführt, wie z. B. die Registerkarte Code oder Cowork, lautet die Nachricht `Opus is experiencing high load. Switch to Sonnet.` und Sie wechseln Modelle mit der Modellauswahl der App.

### Anfrage hat das Zeitlimit überschritten

Die API hat nicht vor der Verbindungsfrist geantwortet.

```text theme={null}
Request timed out
```

Der Standard-Timeout für Anfragen beträgt 10 Minuten. Wenn Sie [`API_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars) auf `0` setzen, ist dieser Anfrage-Timeout deaktiviert. Die [Frist für das erste Byte](#no-response-from-api) und der Body-Idle-Timeout werden durch `0` nicht deaktiviert, sodass eine Streaming-Anfrage weiterhin unter [denjenigen davon läuft, die für Ihre Verbindung gelten](https://code.claude.com/docs/de/network-config.md#streaming-idle-watchdogs). Ein Versuch ohne Streaming behält in einer lokalen Sitzung sein Limit von 300 Sekunden und kann weiterhin mit dieser Nachricht enden.

**Was zu tun ist:**

* Wenn jede Anfrage mit dieser Nachricht fehlschlägt und Sie `API_TIMEOUT_MS` auf `0` gesetzt haben, überprüfen Sie `claude --version`. Bei einer Version vor v2.1.305 aktualisieren Sie Claude Code oder setzen Sie einen positiven Wert.
* Wiederholen Sie die Anfrage
* Wenn eine langsame Netzwerk- oder Proxy-Verbindung die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben
* Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten

### Keine Antwort von der API

Claude Code hat eine Streaming-Anfrage gesendet, und die API hat innerhalb der Frist für das erste Byte keine Response-Header zurückgegeben. Claude Code bricht eine solche Anfrage ab, anstatt auf den vollständigen `API_TIMEOUT_MS`-Anfrage-Timeout zu warten, und sendet sie erneut, wenn das [Wiederholungsbudget](#tune-retry-behavior) dies zulässt. Wenn die Frist auch für den Wiederholungsversuch verstreicht, endet der Turn mit dieser Nachricht, die anzeigt, wie lange jeder Versuch gewartet hat.

Wenn Sie [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/de/env-vars) setzen, versucht Claude Code es unter dem in [Wiederholungsverhalten abstimmen](#tune-retry-behavior) beschriebenen Budget weiter erneut, anstatt den Turn zu beenden.

```text theme={null}
API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
```

Claude Code legt die Wartezeit des ersten Versuchs auf Response-Header und die des Wiederholungsversuchs separat fest:

* **Erster Versuch**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars), wenn Sie es auf 1 oder mehr setzen, begrenzt auf zwischen 10 Sekunden und 30 Minuten. Andernfalls verwendet Claude Code den Byte-Level-Watchdog-Timeout, der in [Streaming-Idle-Watchdogs](https://code.claude.com/docs/de/network-config.md#streaming-idle-watchdogs) aufgelistet ist, sodass die Variablen, die diesen Timeout ändern, auch diese Wartezeit ändern. In jedem Fall fügt Claude Code eine Sekunde für alle 32 KB des Anfragekörpers hinzu.
* **Wiederholungsversuch**: eine Sekunde weniger als `API_TIMEOUT_MS`, standardmäßig knapp unter 10 Minuten, damit der Wiederholungsversuch einen Proxy oder ein Gateway überdauern kann, das die Antwort bis zum Abschluss der Generierung zurückhält. Bei Amazon Bedrock verwendet der Wiederholungsversuch die gleiche Frist wie der erste Versuch, und die Nachricht zeigt eine Dauer statt zwei an.

  Außer bei Amazon Bedrock wartet der Wiederholungsversuch, wenn Sie `API_TIMEOUT_MS` auf `0` setzen, 10 Minuten plus eine Sekunde pro 32 KB oder so lange wie der erste Versuch, falls dieser länger ist.

Keine Wartezeit überschreitet eine Sekunde weniger als ein positives `API_TIMEOUT_MS`, und ein positives `API_TIMEOUT_MS` unter 11 Sekunden deaktiviert die Frist. Der Byte-Level-Watchdog startet erst, nachdem die Response-Header ankommen, sodass eine Antwort, die danach das Senden von Bytes einstellt, stattdessen den [Stalled-Stream-Regeln](#automatic-retries) folgt.

In einer Sitzung über das [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway) gilt diese Frist nur, wenn Sie sie [aktivieren](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#retry-an-unanswered-request-sooner-with-the-first-byte-deadline), indem Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` auf `1` oder mehr setzen.

**Was zu tun ist:**

* Senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.
* Wenn es sich wiederholt, behandeln Sie es als [Netzwerk- oder Proxy-Problem](#unable-to-connect-to-api).
* Wenn ein Proxy oder Gateway in Ihrem Netzwerk Antworten bis zum Abschluss zurückhält, erhöhen Sie `API_TIMEOUT_MS`, damit der Wiederholungsversuch länger wartet. Bei Amazon Bedrock erhöhen Sie auch `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.
* Wenn beim ersten Versuch immer wieder eine Zeitüberschreitung auftritt und der Wiederholungsversuch dann erfolgreich ist, erhöhen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, damit auch der erste Versuch lange genug wartet.

Vor v2.1.242 wartete Claude Code auf den vollständigen `API_TIMEOUT_MS`-Anfrage-Timeout von standardmäßig 10 Minuten, bevor eine unbeantwortete Streaming-Anfrage fehlschlug. Vor v2.1.261 wartete der Wiederholungsversuch die gleiche Frist wie der erste Versuch und die Nachricht zeigte keine Dauern an. Vor v2.1.307 ignorierte Claude Code `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` in einer Sitzung über das Claude apps gateway.

### Die obige Antwort kann unvollständig sein

Eine Streaming-Anfrage ist fehlgeschlagen, während die Antwort noch in Bearbeitung war, nachdem Claude einen Textblock oder einen Tool-Aufruf abgeschlossen oder nach Abschluss seines Thinking einen begonnen hatte. Das erneute Senden der Anfrage könnte die gleichen Tool-Aufrufe zweimal ausführen, sodass Claude Code die Ausgabe behält, die Claude abgeschlossen hat, und diese Mitteilung anfügt, anstatt den Turn zu verwerfen. Welche Variante Sie sehen, nennt die Ursache:

```text theme={null}
API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.
```

* `Server error mid-response`: ein Overload- oder 5xx-Serverfehler mitten im Stream. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die Teilausgabe und meldete den gesamten Turn als Fehler.
* `Connection lost mid-response`: die Verbindung wurde unterbrochen. Sie sehen diese Variante auch, wenn ein Proxy oder Gateway den Response-Body sauber beendet, bevor die Antwort abgeschlossen ist.
* `Your computer went to sleep mid-response`: Claude Code hat erkannt, dass Ihr Computer in den Ruhezustand gegangen ist, während die Antwort gestreamt wurde. Sobald Ihr Computer aufwacht, behandelt Claude Code die Verbindung als unterbrochen und liest nicht mehr von ihr.
* `Part of the response never arrived`: ein Stream-Ereignis ging zwischen der API und Claude Code verloren, sodass ein späteres Ereignis auf Inhalte verwies, die nie ankamen. Vor v2.1.281 beendete dieser Fall den Turn mit `API Error: Content block not found`.
* `The response stream was malformed`: ein Ereignis kam für einen Inhaltsblock an, der bereits abgeschlossen war, oder ein Ereignis kam beschädigt an. Ein beschädigtes Ereignis ist eines, dessen Daten kein gültiges JSON sind, dessen Inhalt fehlt oder dessen Inhalt nicht dem Ereignistyp entspricht. Vor v2.1.284 erschien stattdessen der rohe Fehler des Parsers, wie z. B. einer, der mit `API Error: JSON Parse error` beginnt, wenn ein Ereignis mit ungültigem JSON ankam, nachdem Claude sein Thinking, einen Textblock oder einen Tool-Aufruf abgeschlossen hatte.
* `The response stopped arriving`: die Verbindung blieb offen, lieferte aber keine Daten mehr, sodass der Streaming-Idle-Watchdog sie abgebrochen hat. Vor v2.1.222 konnte Claude Code diesen Fehler auch bei [Gateway](https://code.claude.com/docs/de/gateways.md)-Verbindungen melden, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht wurden, während die Keep-Alive-Pings des Servers noch ankamen, da es dort nur geparste Antwortereignisse zählte; ein Upgrade beseitigt diese falschen Zeitüberschreitungen auf diesen Routen. Gateways, die über eine Anbieter-Basis-URL wie `ANTHROPIC_BEDROCK_BASE_URL` erreicht werden, sind nicht vom Byte-Watchdog umhüllt; siehe [Streaming-Idle-Watchdogs](https://code.claude.com/docs/de/network-config.md#streaming-idle-watchdogs).

Vor v2.1.227 lautete `Connection lost mid-response` noch `Connection closed mid-response` und `The response stopped arriving` noch `Response stalled mid-stream`.

Wenn ein verlorenes, dupliziertes oder beschädigtes Stream-Ereignis ankommt, bevor Claude mit Text oder einem Tool-Aufruf begonnen hat, sehen Sie diese Mitteilung nicht:

* Wenn Claude nur sein Thinking abgeschlossen hatte, sendet Claude Code die Anfrage erneut. Wenn die erneut gesendeten Streams auf die gleiche Weise abbrechen, endet der Turn mit `Part of the response never arrived and no response was produced. Try again.` oder `The response stream was malformed and no response was produced. Try again.`
* Wenn nichts abgeschlossen war, sendet Claude Code die Anfrage stattdessen ohne Streaming erneut. Wenn Sie diesen Fallback mit [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](https://code.claude.com/docs/de/env-vars) deaktiviert haben, endet der Turn mit `API Error: Content block not found` für ein verlorenes Ereignis oder `API Error: Content block already closed` für ein dupliziertes. Für ein beschädigtes Ereignis mit deaktiviertem Fallback endet der Turn mit `API Error: Stream event unreadable` oder dem rohen Fehler des Parsers.

In vier Fällen behandelt Claude Code den Fehler, ohne diese Mitteilung sofort anzuzeigen:

* Früher in der Antwort versucht Claude Code den Fehler entweder erneut oder beendet den Turn mit einem anderen Fehler. Siehe [Automatische Wiederholungen](#automatic-retries).
* Wenn einer dieser Fehler ankommt, nachdem Claude die Antwort abgeschlossen hat, behält Claude Code die vollständige Antwort und beendet den Turn normal, ohne diese Mitteilung. Vor v2.1.222 zeigte Claude Code diese Mitteilung an, wenn die Verbindung nach Abschluss der Antwort unterbrochen wurde oder stockte, und meldete den Turn als Fehler, obwohl die Antwort vollständig war.
* In einer [nicht interaktiven Sitzung](https://code.claude.com/docs/de/headless.md), wie z. B. einem `-p`-Lauf, einem [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Lauf oder einer [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md), müssen Sie nicht selbst `continue` senden, wenn die abgeschnittene Antwort in der Hauptkonversation ist und Text, aber keine Tool-Aufrufe enthält: Claude Code behält die Teilausgabe und fordert Claude auf, dort fortzufahren, wo es aufgehört hat, bis zu dreimal hintereinander. Sie sehen diese Mitteilung für eine solche Antwort erst, wenn Claude Code diese Fortsetzungen aufgebraucht hat. Vor v2.1.246 beendete Claude Code einen nicht interaktiven Turn beim ersten Abbruch mit dieser Mitteilung.
* In einem [Subagenten](https://code.claude.com/docs/de/sub-agents.md#api-errors-in-subagents), unabhängig davon, ob die Sitzung interaktiv ist oder nicht: Wenn seine abgeschnittene Antwort Text, aber keine Tool-Aufrufe enthält, fordert Claude Code den Subagenten auf, fortzufahren. Die Mitteilung wird erst dann zur letzten Nachricht des Subagenten, wenn diese Fortsetzungen aufgebraucht sind. Vor v2.1.257 zeigte ein Subagent diese Mitteilung beim ersten Abbruch an.

**Was zu tun ist:**

* Lesen Sie in einer interaktiven Sitzung die Antwort, die auf dem Bildschirm verbleibt: Claude Code behält jeden Block, den Claude vor dem Fehler abgeschlossen hat, verwirft aber einen unterbrochenen letzten Block, wenn der Turn endet, sodass die letzten Sätze oder Tool-Aufrufe möglicherweise fehlen. Antworten Sie mit `continue`, damit Claude ab seinem letzten abgeschlossenen Block fortfährt.
* Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`):
  * Mit der Standard-Textausgabe gibt Claude Code den letzten abgeschlossenen Textblock aus, den es noch von früher im Turn vorhält, gefolgt von dieser Nachricht. Wenn es keinen vorhält, gibt Claude Code diese Nachricht allein aus, z. B. weil Claude Code die Konversation mitten im Turn komprimiert und diesen Text entfernt hat. Vor v2.1.219 gab Claude Code in der `-p`-Textausgabe nur diese Nachricht aus und verwarf die bereits erzeugte Antwort.
  * Mit `--output-format json` oder `stream-json` meldet Claude Code diese Nachricht im `result`-Feld.
  * Um den Turn fortzusetzen, sobald die Verbindung stabil ist, setzen Sie die Sitzung fort und senden Sie `continue` wie in [Konversationen fortsetzen](https://code.claude.com/docs/de/headless.md#continue-conversations) beschrieben.

### Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen

Das Modell, das der [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) zum Klassifizieren von Aktionen verwendet, konnte keine Entscheidung treffen, sodass der Auto-Modus die Aktion nicht automatisch genehmigt hat. Die Nachricht, die Sie sehen, hängt davon ab, wie der Klassifikator fehlgeschlagen ist.

Wenn das Klassifikatormodell nicht verfügbar ist:

```text theme={null}
<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
```

In einer interaktiven Sitzung erscheint statt dieser Nachricht eine abgeblendete Zeile `Not run · auto mode's check had no usable answer` unter dem Tool-Aufruf. Die Zeile kann auch eine Nachricht ersetzen, die besagt, dass [der Server kein Urteil geliefert hat](#the-server-returned-no-safety-verdict), oder, außerhalb einer Remote-Sitzung, eine Nachricht, die mit `Auto mode could not evaluate` beginnt. Drücken Sie `Ctrl+O`, um ihre Nachricht im [Transkript-Viewer](https://code.claude.com/docs/de/interactive-mode.md#transcript-viewer) zu lesen. Vor v2.1.296 erschien die Nachricht als roter Fehler.

Wenn Claude Code die Fehlerkategorie bestimmen kann, nennt es die Kategorie in Klammern nach `temporarily unavailable`, z. B. `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Die Kategorien sind `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` und `(connection failed)`. Wenn sich `(timed out)` oder `(connection failed)` wiederholt, überprüfen Sie Ihre Verbindung; siehe [Kann keine Verbindung zur API herstellen](#unable-to-connect-to-api). Vor v2.1.229 nannte die Nachricht nie eine Kategorie und lautete `Wait briefly and then try this action again`.

Wenn keine Kategorie passt, wird die Nachricht ohne Kategorie in Klammern angezeigt; mehr als ein Fehler erzeugt diese Form. Bei [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), einschließlich des [Mantle-Endpunkts](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint), wird sie auch angezeigt, wenn Ihr AWS-Konto das in der Nachricht genannte Modell nicht aufrufen kann, und dieser Fehler wiederholt sich bei jedem Wiederholungsversuch, bis Ihrem Konto Zugriff auf das Modell gewährt wird.

**Was zu tun ist:**

* Versuchen Sie es nach ein paar Sekunden erneut; Claude sieht die gleiche Nachricht und versucht es normalerweise selbstständig erneut. Ein vorübergehender Fehler hat nichts mit der [Auto-Modus-Berechtigung](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) zu tun; Sie müssen die Einstellungen nicht ändern
* Wenn Wiederholungsversuche weiterhin fehlschlagen, fahren Sie mit nur lesenden Aufgaben fort und kehren Sie später zur blockierten Aktion zurück
* Wenn die Nachricht bei Amazon Bedrock bei jedem Wiederholungsversuch zurückkommt, überprüfen Sie, dass Ihr Konto das darin genannte Modell aufrufen kann: Bestätigen Sie für Standard-Amazon Bedrock-Modelle, dass Ihre [IAM-Richtlinie](https://code.claude.com/docs/de/amazon-bedrock.md#iam-configuration) das Aufrufen zulässt; für Mantle-Modell-IDs [kontaktieren Sie Ihr AWS-Kontoteam](https://code.claude.com/docs/de/amazon-bedrock.md#mantle-endpoint-errors)
* Wenn die Nachricht bei jedem Wiederholungsversuch zurückkommt und das Modell nennt, das Sie in [`CLAUDE_CODE_AUTO_MODE_MODEL`](https://code.claude.com/docs/de/permission-modes#choose-the-classifier-model) festgelegt haben, überprüfen Sie, ob die API oder der Cloud-Anbieter, auf dem Ihre Sitzung läuft, diese Modell-ID bereitstellt. Falls nicht, setzen Sie die Variable auf eine Modell-ID, die dort bereitgestellt wird, oder entfernen Sie die Variable, um das [Standard-Klassifikatormodell](https://code.claude.com/docs/de/permission-modes.md#default-classifier-model) zu verwenden.

Wenn eine Klassifikatoranfrage fehlschlägt, weil Ihr OAuth-Token abgelaufen ist oder von einer anderen Sitzung rotiert wurde, aktualisiert Claude Code das Token und versucht die Anfrage einmal erneut, sodass ein regulärer Token-Ablauf nicht als diese Nachricht angezeigt wird. Vor v2.1.216 schlug mit einem abgelaufenen oder rotierten Token jede Klassifikatoranfrage fehl, und der Auto-Modus verweigerte jede überprüfte Aktion mit dieser Nachricht, bis das Token aktualisiert wurde.

Wenn der Klassifikator eine nicht analysierbare Antwort zurückgab:

```text theme={null}
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
```

**Was zu tun ist:**

* Versuchen Sie die Aktion erneut; dies ist normalerweise beim nächsten Versuch erfolgreich
* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion, um Details im Debug-Log zu erhalten

Wenn eine separate API-Sicherheitsprüfung die Klassifikatoranfrage aufgrund früherer Konversationsinhalte blockiert hat:

```text theme={null}
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
```

Claude Code verweigert die Aktion, teilt Claude aber mit, dass dies keine Beurteilung ist, dass die Aktion unsicher ist, und dass es mit anderen Aufgaben fortfahren soll, anstatt es erneut zu versuchen. Diese Verweigerungen zählen nicht zu den [Pausenschwellen des Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#when-auto-mode-falls-back). In einem [nicht interaktiven](https://code.claude.com/docs/de/headless.md) `-p`-Lauf stoppt Claude Code den Lauf nicht. Was Claude erhält, hängt davon ab, wo es die Aktion angefordert hat:

* An einen [Hintergrund-Subagenten](https://code.claude.com/docs/de/sub-agents.md#run-subagents-in-foreground-or-background) in einem `-p`-Lauf ohne `--input-format stream-json` gibt Claude Code ein Fehlerergebnis zurück, das `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode` enthält
* Überall sonst, einschließlich interaktiver Sitzungen und der Hauptkonversation eines `-p`-Laufs, gibt Claude Code diese Verweigerung an Claude zurück

Vor v2.1.225 zählte Claude Code diese Verweigerungen zu den Pausenschwellen und gab die gleiche Ablehnungsmeldung wie bei einer echten Blockierung durch den Klassifikator zurück.

**Was zu tun ist:**

* Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrer Konversation vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus die Konversation an den Klassifikator sendete
* Ein erneuter Versuch hilft nicht; der gleiche Konversationsinhalt wird den Filter erneut auslösen
* Wechseln Sie in einer interaktiven Sitzung zu einem anderen [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md), damit Sie die Aktion genehmigen können, wenn Sie gefragt werden
* Starten Sie eine neue Konversation ohne den auslösenden Inhalt

Wenn die Konversation zu lang für die Klassifikatoranfrage von Claude Code ist und Claude Code sie nicht [selbstständig komprimieren kann](#was-not-reviewed-and-did-not-run):

```text theme={null}
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
```

Was mit der Aktion geschieht, hängt davon ab, wo Claude sie angefordert hat:

* In einer interaktiven Sitzung fällt der Auto-Modus für diese Aktion auf eine normale Berechtigungsabfrage zurück, damit Sie sie manuell genehmigen oder ablehnen können
* An einen [Hintergrund-Subagenten](https://code.claude.com/docs/de/sub-agents.md#run-subagents-in-foreground-or-background) in einem [nicht interaktiven](https://code.claude.com/docs/de/headless.md) `-p`-Lauf ohne `--input-format stream-json` gibt Claude Code ein Fehlerergebnis zurück, das `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` enthält, und der Lauf wird fortgesetzt
* Anderswo in einem `-p`-Lauf ohne [`--permission-prompt-tool`](https://code.claude.com/docs/de/cli-reference#cli-flags) gibt es keine Abfrage, auf die zurückgefallen werden kann, sodass die Aktion nicht ausgeführt wird und der Lauf fortgesetzt wird

**Was zu tun ist:**

* Genehmigen oder lehnen Sie die Aktion in einer interaktiven Sitzung in der angezeigten Abfrage ab
* Führen Sie in einer interaktiven Sitzung `/compact` aus, um die Konversationsgröße zu reduzieren, damit nachfolgende Aktionen wieder in das Fenster des Klassifikators passen

### Der Server hat kein Sicherheitsurteil zurückgegeben

Bei der [serverseitigen Klassifikatorprüfung](https://code.claude.com/docs/de/permission-modes.md#server-side-classifier-review) verweigert der Auto-Modus eine Aktion, wenn der Server kein Urteil dafür liefert. Die Verweigerung nennt eine Kategorie in Klammern, wenn Claude Code eine bestimmen kann, wie z. B. `(timed out)`:

```text theme={null}
The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
```

Der Rest der Nachricht teilt Claude mit, ob ein Wiederholungsversuch helfen kann. Vor einigen dieser Verweigerungen wartet Claude Code, damit Claudes nächster Versuch nicht sofort folgt. Während des Wartens in einer interaktiven Sitzung zeigt der Spinner `Auto mode check unavailable` mit einem Countdown an, und das Drücken von `Esc` unterbricht den Turn.

Nach zehn Antworten hintereinander ohne Urteil stoppt der Auto-Modus den Turn:

```text theme={null}
Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.
```

Einige Verweigerungen zählen nicht zu den zehn, darunter [eine Verweigerung aufgrund einer Änderung durch einen Hook oder Mod](#hook-changed-input-after-review).

Die Stoppmeldung wird in jeder Art von Sitzung an einer anderen Stelle angezeigt:

* In einer interaktiven Sitzung wird die Nachricht als Warnung im Transkript angezeigt und der Turn endet
* In einem [nicht interaktiven](https://code.claude.com/docs/de/headless.md) `-p`-Lauf endet der Lauf und meldet einen Ausführungsfehler. Mit der Standard-Textausgabe wird die Nachricht auf stderr ausgegeben.
* Wenn ein [Subagent](https://code.claude.com/docs/de/sub-agents.md) das Limit erreicht hat, stoppt der Subagent vor Abschluss, und Claude erhält das, was er bis dahin produziert hat, mit einem Hinweis, dass der Auto-Modus ihn gestoppt hat

**Was zu tun ist:**

* Drücken Sie in einer interaktiven Sitzung `Ctrl+O`, um den Text der Verweigerung im [Transkript-Viewer](https://code.claude.com/docs/de/interactive-mode.md#transcript-viewer) zu lesen.
* Wenn die Verweigerung `(the conversation is too long for the check)` nennt, führen Sie `/compact` in der Eingabeaufforderung von Claude Code aus, um die Konversation zu kürzen. Solange die Konversation nicht kürzer ist, erhält jede weitere Nachricht dieselbe Verweigerung. Wenn Sie das [automatische Komprimieren](https://code.claude.com/docs/de/settings-reference.md#autocompactenabled) ausgeschaltet haben, schalten Sie es wieder ein, damit Claude Code beim nächsten Mal selbstständig komprimiert.
* Senden Sie eine weitere Nachricht, damit Claude es erneut versucht. Die Zählung der Antworten beginnt von vorne.
* Wenn sich der Stopp wiederholt und Ihre Anfragen über ein [LLM-Gateway oder einen Proxy](https://code.claude.com/docs/de/llm-gateway) laufen, überprüfen Sie, ob dieser Streaming-Antworten kürzt oder umschreibt. [Serverseitige Klassifikatorprüfung](https://code.claude.com/docs/de/permission-modes.md#server-side-classifier-review) beschreibt, welches Gateway-Verhalten Verweigerungen verursacht, und der [Gateway-Kompatibilitätsleitfaden](https://code.claude.com/docs/de/llm-gateway-protocol.md#feature-pass-through) listet auf, was unverändert durchgeleitet werden muss.
* Setzen Sie `CLAUDE_CODE_AUTO_MODE_SERVER=0`, bevor Sie Claude Code starten, um stattdessen seine eigenen Klassifikatoranfragen zu verwenden. Vor v2.1.281 las Claude Code die Variable bei einer direkten Verbindung zur Anthropic API nicht.
* Um die Aktionen stattdessen selbst zu genehmigen, [wechseln Sie aus dem Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#switch-permission-modes)

Vor v2.1.280 verweigerte Claude Code jede Aktion aus einer Antwort ohne Urteil sofort und stoppte den Turn nie.

Vor v2.1.302 komprimierte Claude Code bei einer direkten Verbindung zur Anthropic API keine Konversation, die für die Prüfung des Servers zu lang geworden war.

#### `a hook changed this call's input after auto mode reviewed it`

Diese Verweigerung bedeutet, dass ein Hook oder Mod [die Eingabe des Aufrufs geändert hat](https://code.claude.com/docs/de/hooks.md#pretooluse-updatedinput-in-auto-mode), nachdem der Server ihn geprüft hat, sodass die Prüfung nicht abdeckt, was ausgeführt würde. Es ist keine Beurteilung, dass die Aktion unsicher ist.

Spätere Aufrufe in derselben Antwort von Claude können mit dieser Begründung verweigert werden:

```text theme={null}
another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged
```

Claude kann dann jeden verweigerten Aufruf erneut absetzen, damit der Server ihn prüft. Wenn sich eine Berechtigungsabfrage öffnet, beantworten Sie sie. Sie müssen nichts weiter tun, es sei denn, Claude gibt in seiner Antwort an, dass der Auto-Modus den Aufruf nicht prüfen konnte. Stoppen Sie dann die Änderung oder genehmigen Sie den Aufruf selbst, und bitten Sie Claude, den Aufruf erneut zu versuchen:

* **Änderung stoppen**: Schalten Sie den [Hook](https://code.claude.com/docs/de/hooks.md#disable-or-remove-hooks) oder [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md#turn-mods-on-or-off) aus, der den Aufruf oder einen früheren Aufruf in derselben Antwort von Claude geändert hat, oder bitten Sie Ihren Administrator, ihn auszuschalten. Um nach einem Hook zu suchen, führen Sie [`/hooks`](https://code.claude.com/docs/de/hooks#the-%2Fhooks-menu) in der Eingabeaufforderung von Claude Code aus. Führen Sie in einer Terminal-Sitzung `/plugin` aus, um die aktiven Mods anzuzeigen.
* **Aufruf selbst genehmigen**: [Wechseln Sie in den Manual-Modus](https://code.claude.com/docs/de/permission-modes.md#switch-permission-modes)

### Was not reviewed and did not run

Eine `was not reviewed and did not run`-Verweigerung bedeutet, dass die Konversation zu lang ist, als dass der Klassifikator des [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) die Aktion prüfen könnte, sodass die Aktion nicht ausgeführt wurde. Claude Code gibt diese Nachricht an Claude zurück:

```text theme={null}
<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier. Claude Code will try to compact the conversation before the next request; if this action is still needed after that, issue it again and it will be reviewed normally.
```

Wenn die Komprimierung fehlschlägt, erhalten spätere Aktionen, die der Klassifikator nicht prüfen kann, eine von zwei anderen Nachrichten:

* Eine [`gave no verdict (the conversation is too long for the check)`](#the-server-returned-no-safety-verdict)-Verweigerung
* Die Nachricht [`Auto mode classifier transcript exceeded context window`](#auto-mode-cannot-determine-the-safety-of-an-action)

**Was zu tun ist:**

* Wenn die in der Nachricht angekündigte Komprimierung erfolgreich ist, müssen Sie nichts tun.
* Wenn Sie eine dieser beiden Nachrichten sehen, führen Sie `/compact` in der Eingabeaufforderung von Claude Code aus, um die Konversation selbst zu kürzen. Wenn Sie das [automatische Komprimieren](https://code.claude.com/docs/de/settings-reference.md#autocompactenabled) ausgeschaltet haben, schalten Sie es wieder ein, damit Claude Code beim nächsten Mal selbstständig komprimiert.

### Agent wurde vorzeitig aufgrund eines API-Fehlers beendet

Die API-Anfrage eines [Subagenten](https://code.claude.com/docs/de/sub-agents.md) ist endgültig fehlgeschlagen, z. B. weil ein Nutzungslimit erreicht wurde oder die Wiederholungsversuche für einen Serverfehler aufgebraucht waren, sodass der Subagent vor Abschluss seiner Aufgabe gestoppt hat. Diese Nachricht 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.

```text theme={null}
Agent terminated early due to an API error: <error detail>
```

**Was zu tun ist:**

* Ordnen Sie die Fehlerdetails nach dem Doppelpunkt dem jeweiligen Abschnitt auf dieser Seite zu, wie z. B. [Nutzungslimits](#usage-limits) oder [Serverfehler](#server-errors), und folgen Sie den Schritten dieses Abschnitts
* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe erneut zu versuchen oder [den Subagenten fortzusetzen](https://code.claude.com/docs/de/sub-agents.md#resume-subagents)

Wenn ein Rate-Limit, ein Overload oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe erzeugt hat, erhält Claude statt dieses Fehlers diese Teilausgabe als unvollständig markiert. Ein Subagent, dessen einzige Ausgabe Tool-Aufrufe waren, erhält ebenfalls diesen Fehler; in v2.1.199 gab diese Konstellation stattdessen ein leeres Teilergebnis zurück. Siehe [API-Fehler in Subagenten](https://code.claude.com/docs/de/sub-agents.md#api-errors-in-subagents).

## Nutzungslimits

Die meisten Fehler in diesem Abschnitt bedeuten, dass ein Kontingent, das an Ihr Konto oder Ihren Plan gebunden ist, erreicht wurde. Drei funktionieren anders: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) ist eine serverseitige Drosselung, die nicht mit Ihrem Plan-Kontingent zusammenhängt, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) ist eine Berechtigungsprüfung statt eines erschöpften Kontingents, und [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) bedeutet, dass eine Bestätigungsabfrage für Nutzungsguthaben unbeantwortet geschlossen wurde, unabhängig davon, ob ein Kontingent erreicht wurde.

### You've hit your session limit

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

```text theme={null}
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
You've hit your Sonnet limit · resets 3:45pm
```

Claude 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 der Wechsel des Modells den Zugriff nicht wieder her. Die Opus- und Sonnet-Limits gelten jeweils nur für Anfragen an diese Modellfamilie, daher können Sie mit `/model` zu einem Modell außerhalb der Familie wechseln und weiterarbeiten.

In einer interaktiven Sitzung, die mit einem claude.ai-Abonnement angemeldet ist, kann Claude Code auch in der offenen Sitzung warten und die unterbrochene Aufgabe kurz nach dem Zurücksetzen fortsetzen. Siehe [Wait for a usage limit to reset](https://code.claude.com/docs/de/interactive-mode.md#wait-for-a-usage-limit-to-reset) für das, was Sie sehen, wie Sie ein Warten starten oder abbrechen, und wie Sie das automatische Fortsetzen ausschalten. Vor v2.1.234 bot Claude Code dieses Warten nicht an.

Die Nutzung wird gleichzeitig gegen die Sitzungs- und Wochenkontingente angerechnet. Ein einzelner Ausbruch intensiver Aktivität, wie z. B. ein großer Workflow-Fanout, kann das Wochenkontingent aufbrauchen, bevor das Sitzungsfenster zurückgesetzt wird.

**Was zu tun ist:**

* Warten Sie auf den in der Fehlermeldung angezeigten Zurücksetzzeitpunkt
* In der Registerkarte Code der [Desktop-App](https://code.claude.com/docs/de/desktop.md) bietet die Sitzungslimit-Karte ein Kontrollkästchen **Auto-continue when limits reset**. Die Wochenlimit-Karte bietet dies nicht. Wenn es aktiviert ist, versucht die Desktop-App den unterbrochenen Turn nach dem Zurücksetzen erneut und zeigt die Wiederholungszeit auf der Karte an. Das Desktop-Kontrollkästchen und die Einstellung **Continue automatically at usage limit** der CLI in `/config` sind unabhängig, daher schalten Sie jede einzeln aus.
* Für das Opus- oder Sonnet-Limit führen Sie `/model` aus und wechseln Sie zu einem Modell außerhalb dieser Familie, um weiterarbeiten zu können. Jedes Modell hat seinen eigenen Prompt-Cache, daher liest die nächste Anfrage die gesamte Konversation ohne Cache-Treffer erneut; siehe [Switching models](https://code.claude.com/docs/de/prompt-caching.md#switching-models)
* Führen Sie `/usage` aus, um Ihre Plan-Limits und deren Zurücksetzzeitpunkte anzuzeigen
* Führen Sie `/usage-credits` aus, um zusätzliche Nutzung auf Pro, Max und Ultra zu kaufen, oder um sie von Ihrem Admin auf Team und Enterprise anzufordern. Siehe [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) für die Abrechnung.
* Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe [claude.com/pricing](https://claude.com/pricing)

Bevor ein Fenster aufgebraucht wird, kann Claude Code Sie warnen, dass Sie den größten Teil davon verwendet haben, mit einer Meldung wie `You've used 85% of your session limit · resets 3:45pm`. Um Ihr verbleibendes Kontingent zu überwachen, fügen Sie die `rate_limits`-Felder zu einer [benutzerdefinierten Statuszeile](https://code.claude.com/docs/de/statusline.md#rate-limit-usage) hinzu, oder klicken Sie in der Desktop-App auf den [Nutzungsring](https://code.claude.com/docs/de/desktop.md#check-usage).

### Usage credits required for 1M context

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

```text theme={null}
API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context
```

In einer Sitzung, die die Claude Desktop-App ausführt, nennt der Hinweis keine Befehle: Er verweist auf die claude.ai-Nutzungseinstellungsseite, oder bei Team- und Enterprise-Plänen sagt er, dass Nutzungsguthaben unter claude.ai/admin-settings/usage aktiviert werden sollen, oder dass Sie Ihren Admin fragen sollen.

Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenkontingente noch Kapazität haben. Siehe [Extended context](https://code.claude.com/docs/de/model-config.md#extended-context) für die Pläne, die 1M-Kontext direkt enthalten, und welche Nutzungsguthaben erfordern.

Wenn dieser Fehler mitten in einer Konversation auftritt, weil der Kontext über 200K Token gewachsen ist, komprimiert Claude Code die Konversation automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, daher ist keine Aktion erforderlich. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` auf diesen Versionen aus, um die Wiederherstellung durchzuführen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.

**Was zu tun ist:**

* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzufallen
* Wo die Meldung `/usage-credits` nennt, führen Sie es aus, um die verbrauchsabhängige Abrechnung für die 1M-Variante auf Pro, Max und Ultra zu aktivieren, oder um Nutzungsguthaben von Ihrem Admin auf Team und Enterprise anzufordern. Sobald Nutzungsguthaben aktiviert ist, starten Sie Claude Code neu oder starten Sie eine neue Sitzung, je nachdem, was die Meldung sagt. Bis dahin bleibt die Sitzung auf dem Standard-Kontextlimit.
* Wenn der Fehler nach `/model` weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle gesetzt sein. Siehe [Setting your model](https://code.claude.com/docs/de/model-config.md#setting-your-model) für die zu überprüfenden Konfigurationsorte in Prioritätsreihenfolge.
* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/de/env-vars)

Vor v2.1.268 endete die Meldung mit `run /usage-credits to turn them on, or /model to switch to standard context` und erwähnte das Neustarten nicht.

### The prompt to confirm went unanswered

Wenn die [Bestätigungsabfrage für Fable-Nutzungsguthaben](https://code.claude.com/docs/de/model-config.md#fable-and-usage-credits) geschlossen wird, ohne dass jemand sie beantwortet, beendet Claude Code den Turn mit einer dieser Meldungen:

```text theme={null}
Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered · nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered · nothing was sent · answer it where this session is running, or /model to change
```

Die Meldungen nennen das Fable-Modell der Sitzung, daher lauten sie auf Fable 5.2 `continuing on Fable 5.2` und `Fable 5.2 now uses usage credits`. Wenn [Remote Control](https://code.claude.com/docs/de/remote-control.md) verbunden ist, kann jede Meldung stattdessen mit `Claude stopped here · send a message to be asked again, or switch models` enden. Vor v2.1.257 begann die erste Meldung mit `Fable 5 limit reached`.

Dies geschieht in [Remote Control](https://code.claude.com/docs/de/remote-control.md)-Sitzungen, [Hintergrund-Sitzungen](https://code.claude.com/docs/de/agent-view.md), [Agent-Team](https://code.claude.com/docs/de/agent-teams.md)-Kollegensitzungen und Sitzungen, die eine andere Anwendung über das Agent SDK hostet. Für den Fall, dass Claude Code die Abfrage schließt, siehe [Fable and usage credits](https://code.claude.com/docs/de/model-config.md#fable-and-usage-credits).

**Was zu tun ist:**

* Wo die Sitzung ausgeführt wird, am Terminal oder in der Anwendung, die sie hostet, senden Sie einen weiteren Prompt und beantworten Sie die Bestätigungsabfrage, wenn sie erneut angezeigt wird. Für eine Hintergrund-Sitzung verbinden Sie sich zuerst über die [Agenten-Ansicht](https://code.claude.com/docs/de/agent-view.md) mit ihr. Wenn die Meldung `Claude stopped here` lautet, können Sie auch von Ihrem verbundenen Gerät aus antworten und die Bestätigungsabfrage dort beantworten.
* Führen Sie `/model` aus, um zu einem Modell zu wechseln, das kein Nutzungsguthaben abrechnet
* Um sich mehr Zeit zu geben, setzen Sie [`dialogExpiry`](https://code.claude.com/docs/de/settings-reference#dialogexpiry) auf einen längeren Wert oder `"never"`

Vor v2.1.236 erschien diese Meldung nicht: Während ein Remote-Control-Client verbunden war, wartete Claude Code 60 Sekunden auf eine Antwort und setzte dann den Turn auf Ihrem Standardmodell fort.

### Server is temporarily limiting requests

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

```text theme={null}
API Error: Server is temporarily limiting requests (not your usage limit)
```

Claude Code unterscheidet diese von Ihrem Plan-Limit durch das Fehlen der einheitlichen Quota-Header, die eine echte Limit-Antwort trägt. Ab v2.1.199 wird dies [automatisch erneut versucht](#automatic-retries) mit Backoff, bevor es angezeigt wird, unabhängig davon, wie Sie sich authentifizieren. In früheren Versionen schlug in einer Sitzung, die mit einem claude.ai-Abonnement angemeldet war, der Turn beim ersten Auftreten fehl; nur bei Anmeldungen mit API-Schlüssel und Enterprise wurde die Anfrage erneut versucht.

**Was zu tun ist:**

* Warten Sie kurz und versuchen Sie es erneut
* Überprüfen Sie [status.claude.com](https://status.claude.com), wenn es weiterhin besteht

### Request rejected (429)

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

```text theme={null}
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
```

Der nachfolgende Satz nennt, wo der Dienststatus überprüft werden kann, und variiert je nach Anbieter. Konfigurationen für Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry nennen die Dienststatus-Seite dieses Anbieters anstelle der Anthropic-Statusseite. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.

Wenn ein Proxy, Load Balancer oder Gateway zwischen Claude Code und der API mit seiner eigenen HTML-429-Seite antwortet, ist der Text nach dem `·` der Titel dieser Seite, wenn sie einen hat, wie z. B. `Too Many Requests`. Vor v2.1.281 wurde das gesamte Markup der Seite nach dem `·` ausgegeben.

**Was zu tun ist:**

* Führen Sie `/status` aus und bestätigen Sie, dass die aktiven Anmeldedaten die erwarteten sind. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen über einen Schlüssel mit niedrigem Tier 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 [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) für die Funktionsweise von Tiers und wie man Obergrenzen pro Workspace setzt
* Reduzieren Sie die Parallelität: Vermeiden Sie das Ausführen vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für skriptgesteuerte Läufe mit hohem Volumen

### You've hit your monthly spend limit

Das in Ihrem Plan enthaltene Nutzungskontingent kann diese Anfrage nicht abdecken, und das [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), das sie sonst bezahlen würde, hat eine Ausgabenbegrenzung erreicht. Ihr Plan kann eine Anfrage nicht abdecken, wenn eines seiner Nutzungsfenster aufgebraucht ist oder wenn die Anfrage nur über Nutzungsguthaben bezahlt wird. Ein Beispiel ist eine Anfrage an ein Modell, das [über Nutzungsguthaben abgerechnet wird](https://code.claude.com/docs/de/model-config.md#fable-and-usage-credits).

Die Wörter vor dem `·` nennen das Limit, das Sie blockiert hat, z. B. die monatliche Ausgabenbegrenzung Ihrer Organisation, und der Text danach sagt, wie Sie dieses Limit erhöhen lassen können. In einer Cloud-Sitzung oder unter [Remote Control](https://code.claude.com/docs/de/remote-control.md) enthält dieser Text keine URL, und eine Meldung über Ihre eigene `monthly spend limit` sagt nicht, wie Sie sie erhöhen können. Andere Sitzungen zeigen Formen wie diese:

```text theme={null}
You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings
```

`team's shared budget` ist ein gepooltes Budget, das ein Admin einer Gruppe zugewiesen hat, der Sie angehören; die Meldung nennt die Gruppe nicht. `channel's monthly spend limit` ist das Budget des einen Slack-Channels, in dem die Sitzung ausgeführt wird, daher kann Ihre Organisation immer noch Budget außerhalb davon haben.

Wenn eines der Fenster Ihres Plans aufgebraucht ist, sagt die Meldung auch, wann dieses Fenster zurückgesetzt wird, zum Beispiel `· your session limit resets 3:45pm`, und der Zugriff ist dann wieder möglich, ohne dass jemand das Limit erhöht. Bei Organisationen mit nutzungsbasierter Abrechnung sagt die Meldung `usage limit` anstelle von `spend limit`, wie in `You've hit your individual usage limit`.

Wenn Sie sich über ein Claude-Apps-Gateway verbinden und `spend limit reached` in Kleinbuchstaben sehen, ist das stattdessen die Obergrenze Ihres Gateway-Betreibers; siehe [Spend limit reached](#spend-limit-reached).

**Was zu tun ist:**

* Auf Pro, Max und Ultra erhöhen Sie Ihre monatliche Ausgabenbegrenzung in [**Settings > Usage**](https://claude.ai/settings/usage) auf claude.ai, oder führen Sie `/usage-credits` aus
* Auf Team und Enterprise erhöhen Sie das Limit in [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), wenn Sie die Abrechnung verwalten, oder bitten Sie einen Admin darum. `/usage-credits` sendet diese Anfrage für Sie an Ihren Admin
* Für ein Channel-Limit bitten Sie einen Org-Owner oder den Manager des Channels, es auf claude.ai zu erhöhen. Siehe [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) in der Claude Tag-Dokumentation
* Wenn die Meldung einen Zurücksetzzeitpunkt für das Fenster Ihres Plans nennt, können Sie stattdessen darauf warten
* Führen Sie `/usage` aus, um die Fenster Ihres Plans und deren Zurücksetzzeitpunkte anzuzeigen

### Spend limit reached

Sie verbinden sich über ein [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway) und haben eine [Ausgabenbegrenzung](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) erreicht, die Ihr Gateway-Betreiber gesetzt hat. Das Gateway blockiert Ihre Anfragen, bis der Betreiber die Obergrenze erhöht oder, falls sie über \$0 liegt, bis die Obergrenze zurückgesetzt wird. Es markiert jede blockierte `429`-Antwort mit `x-should-retry: false`, daher zeigt Claude Code diese Meldung im Terminal ohne erneuten Versuch an.

```text theme={null}
spend limit reached · resets Dec 1
```

Prüfen Sie, ob die Meldung ein Datum enthält:

* **Mit Datum**: Die Obergrenze wird an diesem Datum um 00:00 UTC zurückgesetzt
* **Ohne Datum**: Ihre Obergrenze beträgt \$0, oder Ihr Gateway läuft auf einer Version vor v2.1.225

Jeder weitere Text in der Meldung ist ein Hinweis Ihres Gateway-Betreibers.

Von v2.1.225 bis v2.1.319 auf dem Gateway-Server nannte die Meldung den Zeitraum der Obergrenze und den Zurücksetzzeitpunkt, wie in `spend limit reached (daily; resets 2026-08-09 00:00 UTC)`.

**Was zu tun ist:**

* Wenn die Meldung ein Datum enthält, warten Sie auf das Zurücksetzen, oder folgen Sie dem Hinweis des Betreibers, wenn die Meldung einen enthält
* Bitten Sie Ihren Gateway-Betreiber, die Obergrenze zu erhöhen, wenn die Meldung kein Datum enthält, wenn Sie nach dem Datum weiterhin blockiert sind oder wenn Sie die Obergrenze regelmäßig erreichen

Eine zweite Gateway-Meldung, `This request exceeds your group's budget`, bedeutet, dass das [gepoolte Budget](https://code.claude.com/docs/de/claude-apps-gateway-config.md#pooled-budget-order) Ihrer Gruppe aufgebraucht ist. Folgen Sie den darin genannten Schritten:

```text theme={null}
This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.
```

Eine verwandte Meldung, `spend limit unavailable`, bedeutet, dass das Gateway seine Ausgabendatensätze nicht lesen konnte und die Anfrage als Vorsichtsmaßnahme blockiert hat, nicht wegen Überschreitung Ihrer Obergrenze. Sie verschwindet normalerweise von selbst; wenn sie weiterhin besteht, teilen Sie dies Ihrem Gateway-Betreiber mit.

### Credit balance is too low

Ihre Console-Organisation hat ihr vorausbezahltes Guthaben aufgebraucht, oder Claude Code sendet Ihre Anfragen mit einem Console-API-Schlüssel, obwohl Sie Ihr Abonnement verwenden wollten.

```text theme={null}
Credit balance is too low
Credit balance too low · Add funds: https://platform.claude.com/settings/billing
```

**Was zu tun ist:**

* Wenn Sie einen Pro-, Max-, Ultra-, Team- oder Enterprise-Plan haben und dies sehen, führen Sie `/status` aus und überprüfen Sie die Zeile `API key`. Ein genehmigter `ANTHROPIC_API_KEY` in Ihrer Umgebung leitet Anfragen über diesen Schlüssel statt über Ihr Abonnement. Entfernen Sie die Variable in der aktuellen Shell und aus Ihrem Shell-Profil, und starten Sie dann `claude` neu. Führen Sie `/login` aus, wenn Sie sich noch nicht mit Ihrem Abonnement angemeldet haben.
* Fügen Sie Guthaben unter [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) hinzu, und erwägen Sie, dort das automatische Aufladen zu aktivieren, damit der Saldo aufgefüllt wird, bevor er null erreicht
* Setzen Sie Ausgabengrenzen pro Workspace in der Console, um zu verhindern, dass ein einzelnes Projekt das Guthaben der Organisation aufbraucht. Siehe [Manage costs effectively](https://code.claude.com/docs/de/costs.md).

### Could not update your spend limit

Der Server lehnte eine Änderung der Ausgabenbegrenzung ab, die Sie in der Abfrage vorgenommen haben, die angezeigt wird, wenn Sie Ihre Ausgabenbegrenzung erreichen.

```text theme={null}
Could not update your spend limit: <reason from the server>
```

Wenn der Server die Ablehnung erklärt, endet die Meldung mit diesem Grund, und ein erneuter Versuch mit demselben Wert schlägt wieder fehl. Wenn der Fehler keinen vom Server bereitgestellten Grund hat, wie z. B. bei einer unterbrochenen Verbindung, lautet die Meldung `Could not update your spend limit. Press Enter to retry.` und ein erneuter Versuch kann erfolgreich sein. Vor v2.1.216 zeigte Claude Code die generische Form für jeden Fehler an.

Wenn Sie das Limit entfernen, beginnt die generische Form ab v2.1.327 mit `Could not remove your spend limit`.

**Was zu tun ist:**

* Wenn die Meldung einen Grund enthält, wählen Sie ein Limit, das ihn erfüllt, wie z. B. einen niedrigeren Betrag
* Wenn die Meldung nur die generische Form anzeigt, versuchen Sie es erneut; der Fehler kann vorübergehend sein
* Wenn die Änderung weiterhin fehlschlägt, nehmen Sie sie stattdessen in Ihren [claude.ai-Abrechnungseinstellungen](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) im Browser vor

## Authentifizierungsfehler

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

### Nicht angemeldet

Für diese Sitzung sind keine gültigen Anmeldedaten verfügbar.

```text theme={null}
Not logged in · Please run /login
```

In einer Sitzung, die von der Claude Desktop-App ausgeführt wird, etwa im Code-Tab oder in Cowork, lautet die Meldung `Authentication required · Sign in again to continue`, und Sie melden sich in der App erneut an.

Wenn Sie sich in einem anderen Claude Code-Fenster, das dasselbe [Konfigurationsverzeichnis](https://code.claude.com/docs/de/claude-directory.md) verwendet, mit Ihrem claude.ai-Konto anmelden, verwendet eine interaktive Sitzung, die diese Meldung anzeigt, diese Anmeldung automatisch. Sie müssen sie nicht neu starten.

Vor v2.1.286 konnte die Sitzung unter macOS die Meldung weiterhin anzeigen, nachdem Sie sich in einem anderen Fenster angemeldet hatten. Starten Sie in diesen Versionen die Sitzung, die die Meldung anzeigt, neu.

**Vorgehensweise:**

* Führen Sie `/login` aus, um sich mit Ihrem Claude-Abonnement oder Console-Konto zu authentifizieren
* Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, prüfen Sie, ob `ANTHROPIC_API_KEY` in der Shell, in der Sie `claude` gestartet haben, gesetzt und exportiert ist
* Für CI oder Automatisierung, bei denen keine interaktive Anmeldung möglich ist, konfigurieren Sie ein [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft
* Wenn `claude -p`-Jobs mit dieser Meldung beendet werden, sobald sich jemand erneut bei demselben claude.ai-Konto und derselben Organisation anmeldet, aktualisieren Sie Claude Code dort, wo diese Anmeldung stattfindet. Vor v2.1.318 entfernte Claude Code während dieser Anmeldung die gespeicherte Anmeldung, bevor die neue gespeichert wurde.
* Unter [Vorrang der Authentifizierung](https://code.claude.com/docs/de/authentication.md#authentication-precedence) erfahren Sie, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

Wenn Sie wiederholt zur Anmeldung aufgefordert werden, finden Sie unter [Nicht angemeldet oder Token abgelaufen](https://code.claude.com/docs/de/troubleshoot-install.md#not-logged-in-or-token-expired) Prüfungen der Systemuhr und Schritte zur Wiederherstellung des Anmeldedatenspeichers unter macOS.

### Authentifizierungsmethode konnte nicht ermittelt werden

Die Sitzung hat den API-Client ohne Anmeldedaten erreicht. [Hintergrundsitzungen](https://code.claude.com/docs/de/agent-view.md) und Cloud-Sitzungen zeigen diese Meldung an, wenn der Worker ohne Anmeldedaten startet. Interaktive Ausführungen, `-p`-Ausführungen und Agent SDK-Ausführungen melden denselben Zustand als [Nicht angemeldet](#not-logged-in) und schreiben diese Zeichenfolge nur in ihr Debug-Log. Wenn Sie sie also dort gefunden haben, folgen Sie stattdessen diesem Eintrag.

```text theme={null}
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
```

In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten zur Verfügung standen. Vor v2.1.174 konnte eine Hintergrundsitzung, die einem inaktiven, vorinitialisierten Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Vor v2.1.176 konnte dies auch bei einer Cloud-Sitzung passieren, die inaktiv war, bevor sie übernommen wurde. Aktualisieren Sie, um das Problem zu beheben.

**Vorgehensweise:**

* Aktualisieren Sie auf v2.1.176 oder neuer, wenn dies in einer Hintergrund- oder Cloud-Sitzung auftritt und Ihre Anmeldedaten bereits konfiguriert sind
* Prüfen Sie, ob `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` oder die Anmeldedaten Ihres Cloud-Anbieters in der Umgebung gesetzt sind, die den Worker startet, und nicht nur in Ihrer interaktiven Shell
* Für das Agent SDK siehe [Einrichtung der Authentifizierung im Schnellstart](https://code.claude.com/docs/de/agent-sdk/quickstart.md#setup)
* Führen Sie `/status` in einer interaktiven Sitzung in derselben Umgebung aus, um zu prüfen, welche Quelle für Anmeldedaten ermittelt wird

### Ungültiger API-Schlüssel

Die Umgebungsvariable `ANTHROPIC_API_KEY` oder das `apiKeyHelper`-Skript hat einen Schlüssel geliefert, den die API abgelehnt hat, oder Claude Code hat einen Schlüssel aus `ANTHROPIC_API_KEY` blockiert, bevor er gesendet wurde.

```text theme={null}
Invalid API key · Fix external API key
```

Wenn die Meldung nach `Fix external API key` mit einer Beschreibung wie `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).` weitergeht, hat die API den Schlüssel nie gesehen. Claude Code hat ein Zeichen gefunden, das HTTP-Header nicht übertragen können, und die Anfrage vor dem Senden gestoppt. Unter [Ungültiger Wert im Request-Header](#invalid-request-header-value) erfahren Sie, wie Sie die Beschreibung lesen und den Wert korrigieren.

**Vorgehensweise:**

* Prüfen Sie auf Tippfehler und stellen Sie sicher, dass der Schlüssel in der [Console](https://platform.claude.com/settings/keys) nicht widerrufen wurde
* Führen Sie in derselben Shell `env | grep ANTHROPIC` aus, in PowerShell `Get-ChildItem Env:ANTHROPIC*`. 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 gesetzt haben.
* Entfernen Sie `ANTHROPIC_API_KEY` und führen Sie `/login` aus, um stattdessen die Abonnement-Authentifizierung zu verwenden
* Wenn der Schlüssel aus einem [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Skript stammt, führen Sie das Skript direkt aus, um zu prüfen, ob es einen gültigen Schlüssel auf stdout ausgibt
* Führen Sie `/status` aus, um zu prüfen, welche Quelle für Anmeldedaten Claude Code tatsächlich verwendet

### Ihr apiKeyHelper-Skript schlägt fehl

Claude Code hat den Befehl in Ihrer [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Einstellung ausgeführt und keinen Schlüssel zurückerhalten. Ohne Schlüssel erreicht die Anfrage die API mit Platzhalter-Anmeldedaten, und die API lehnt sie mit `401` ab. Das `Authentication`-Panel im Terminal zeigt, welcher der folgenden Fälle eingetreten ist:

* Der Befehl wurde mit einem Fehler beendet oder hat eine Zeitüberschreitung erreicht
* Der Befehl hat nichts auf stdout ausgegeben
* Der Befehl hat neben dem Schlüssel noch etwas anderes ausgegeben, etwa ein Login-Banner oder eine Logzeile. Das Panel zeigt `returned output that cannot be used as an API key` und beschreibt das Problem, ohne die Ausgabe zu wiederholen. Vor v2.1.227 hat Claude Code alles gesendet, was der Befehl ausgegeben hat, nachdem umgebende Leerzeichen entfernt wurden.

```text theme={null}
Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) enthält stderr außerdem den konkreten Grund mit dem Präfix `apiKeyHelper failed:`.

Claude Code führt das Skript erneut aus und wiederholt die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, sodass der Fehler innerhalb von drei Versuchen sichtbar wird. Vor v2.1.208 hat Claude Code das gesamte [Budget für Wiederholungsversuche](#automatic-retries) damit verbraucht, die Anfrage mit den Platzhalter-Anmeldedaten erneut zu senden, und dann statt des Skriptfehlers einen generischen `401`-Authentifizierungsfehler gemeldet.

Das Ausführen von `/login` hilft hier nicht: Die Ausgabe des Helpers [hat Vorrang](https://code.claude.com/docs/de/authentication.md#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.

**Vorgehensweise:**

* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren
* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anbieter für Anmeldedaten, zum Beispiel indem Sie sich erneut bei Ihrem SSO oder Secrets-Vault anmelden
* Korrigieren Sie den Befehl so, dass er nur den Schlüssel auf stdout ausgibt, als einzelnes Token aus druckbaren ASCII-Zeichen mit bis zu 16.384 Zeichen, und mit Exit-Code 0 beendet wird. Eine funktionierende Einrichtung finden Sie unter [Anmeldedaten mit apiKeyHelper rotieren](https://code.claude.com/docs/de/llm-gateway-connect.md#rotate-credentials-with-apikeyhelper).
* Führen Sie `/status` aus, um den Fehler zu sehen und zu prüfen, ob `apiKeyHelper` die aktive Quelle für Anmeldedaten ist. Die Zeile `apiKeyHelper` zeigt `Failing` mit den Details des letzten Fehlers an, etwa dem Exit-Code und der Fehlerausgabe des Befehls, und verschwindet nach der nächsten erfolgreichen Ausführung. Vor v2.1.274 zeigte `/status` nur die Quelle der Anmeldedaten an, nicht den Fehler.
* Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und seine Fehlerausgabe außerdem in einem `Authentication`-Panel im Terminal. Vor v2.1.212 trug das Panel den Titel `Cloud authentication`.

### Claude Code didn't send your claude.ai login

Diese Meldungen bedeuten, dass Claude Code Ihre Anfrage abgelehnt und Ihre claude.ai-Anmeldung nicht gesendet hat:

```text theme={null}
Your organization's settings need an update. Ask your administrator to fix the API key helper configuration.
Couldn't load your organization's settings. Check your connection, then restart Claude Code.
Restart Claude Code to finish signing in.
```

**Vorgehensweise:**

* `Your organization's settings need an update`: Bitten Sie Ihren Administrator, die Konfiguration des API-Key-Helpers zu korrigieren
  * Um Ihrem Administrator mitzuteilen, welche verwalteten Quellen Ihr Rechner hat, führen Sie `/status` an der Claude Code-Eingabeaufforderung aus und kopieren Sie die [Zeile `Setting sources`](https://code.claude.com/docs/de/managed-settings#read-the-source-in-/status). Wenn eine Zeile `Skipped sources` erscheint, kopieren Sie diese ebenfalls
  * Wenn Sie die Einstellungen verwalten und der Helper in der Datei mit verwalteten Einstellungen eines Rechners oder in einer MDM-Richtlinie steht, siehe [Wenn der `apiKeyHelper` eines Rechners nicht wirksam ist](https://code.claude.com/docs/de/server-managed-settings#machine-apikeyhelper-not-in-effect)
* `Couldn't load your organization's settings`: Prüfen Sie Ihre Verbindung und starten Sie Claude Code dann neu. Wenn die Meldung nach einem Neustart erneut erscheint, informieren Sie Ihren Administrator
* `Restart Claude Code to finish signing in`: Starten Sie Claude Code neu

Vor v2.1.315 gab ein abgelehnter Prompt oder Datei-Upload eine einzige Meldung aus, die mit `Claude Code didn't send your claude.ai login` begann.

### Ungültiger Wert im Request-Header

Ein Wert, den Claude Code als Request-Header senden wollte, enthält ein Zeichen, das HTTP-Header nicht übertragen können: einen Zeilenumbruch, ein NUL-Byte oder ein Zeichen oberhalb von `U+00FF`, etwa ein typografisches Anführungszeichen oder ein Leerzeichen ohne Breite. Claude Code stoppt die Anfrage, bevor etwas gesendet wird, und nennt die Variable oder Einstellung, die korrigiert werden muss. Die übliche Ursache sind Anmeldedaten, die aus einem Dokument oder Chat eingefügt wurden und ein unsichtbares Zeichen oder einen überzähligen Zeilenumbruch enthielten.

Claude Code führt diese Prüfung durch, wenn Anfragen direkt oder über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) an die Claude API gesendet werden. Bei einem Cloud-Anbieter eines Drittanbieters wie [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) führt Claude Code sie vor dem Senden nicht durch.

```text theme={null}
Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable
```

Der erste Teil der Meldung hängt davon ab, woher der fehlerhafte Wert stammt:

* `Invalid auth token`: ein Bearer-Token aus [`ANTHROPIC_AUTH_TOKEN`](https://code.claude.com/docs/de/env-vars) oder [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/de/env-vars)
* `Invalid ANTHROPIC_CUSTOM_HEADERS`: ein Header-Name oder -Wert, den Sie in [`ANTHROPIC_CUSTOM_HEADERS`](https://code.claude.com/docs/de/env-vars) gesetzt haben. Die Beschreibung zählt, welches `Name: Value`-Paar fehlerhaft ist, etwa `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, ohne Namen oder Wert zu wiederholen, da Sie beides selbst gewählt haben.
* `Invalid request header from the environment`: ein Wert, den Claude Code aus einer anderen Umgebungsvariable in einen Request-Header kopiert, etwa `CLAUDE_AGENT_SDK_CLIENT_APP`. Die Beschreibung nennt die Variable, die korrigiert werden muss.

Einen fehlerhaften `ANTHROPIC_API_KEY`, der bei dieser Prüfung auffällt, meldet Claude Code als [Ungültiger API-Schlüssel](#invalid-api-key), mit derselben nachgestellten Beschreibung. Fehlerhafte gespeicherte `/login`-Anmeldedaten meldet es stattdessen als [Nicht angemeldet](#not-logged-in); führen Sie `/login` aus, um neue zu speichern. Die Ausgabe eines [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Skripts erreicht diese Prüfung nie: Claude Code validiert sie beim Ausführen des Skripts, und eine Ausgabe, die ein HTTP-Header nicht übertragen kann, schlägt mit [Ihr apiKeyHelper-Skript schlägt fehl](#your-apikeyhelper-script-is-failing) fehl.

Nach dem zweiten `·` beschreibt die Meldung das Problem, wie in diesem vollständigen Beispiel:

```text theme={null}
Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
```

Positionen zählen Zeichen ab eins. Die Beschreibung wird aus festen Formulierungen und Zeichenzahlen aufgebaut, sodass sie nie den Wert selbst enthält. Sie nennt das betroffene Zeichen nur, wenn es sich um ein bekanntes unsichtbares oder typografisches Zeichen handelt, etwa eine Byte-Order-Mark, ein Leerzeichen ohne Breite oder ein typografisches Anführungszeichen, und meldet alles andere als `a non-ASCII character`.

**Vorgehensweise:**

* Setzen Sie die in der Meldung genannte Variable oder Einstellung neu und tippen Sie die Zeichen um die gemeldete Position herum neu ein, anstatt sie erneut aus derselben Quelle einzufügen
* Behalten Sie bei `ANTHROPIC_CUSTOM_HEADERS` ein `Name: Value`-Paar pro Zeile bei und schreiben Sie das Paar, das die Meldung zählt, neu
* Führen Sie `/status` aus, um zu prüfen, welche Quelle für Anmeldedaten aktiv ist

### Diese Organisation wurde deaktiviert

Claude Code verwendet einen veralteten `ANTHROPIC_API_KEY` aus einer deaktivierten Console-Organisation. Wenn Sie eine gespeicherte Abonnement-Anmeldung haben, überschreibt der Schlüssel diese.

```text theme={null}
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.
```

Der Hinweis nach dem `·` hängt von Ihren gespeicherten Anmeldedaten ab: Die erste Form erscheint, wenn ein gespeichertes `/login` übernehmen kann, nachdem Sie den Schlüssel entfernt haben, und die zweite, wenn der Schlüssel Ihre einzigen Anmeldedaten sind.

Wenn Sie einen Schlüssel in Ihrem Shell-Profil exportieren oder aus `.env` laden, verwendet Claude Code diesen anstelle von `/login`, selbst bei einem funktionierenden Pro-, Max- oder Ultra-Abonnement. Im nicht interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.

**Vorgehensweise:**

* Entfernen Sie `ANTHROPIC_API_KEY` in der aktuellen Shell und aus Ihrem Shell-Profil, und starten Sie dann `claude` neu
* Wenn die Meldung `Update or unset` lautet, haben Sie keine gespeicherte Anmeldung, auf die zurückgegriffen werden kann. Entfernen Sie den Schlüssel und führen Sie `/login` aus, oder ersetzen Sie den Schlüssel durch einen aus einer aktiven Console-Organisation.
* Führen Sie anschließend `/status` aus, um zu prüfen, ob Ihr Abonnement die aktiven Anmeldedaten sind
* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin auftritt, wenden Sie sich an den Support oder melden Sie sich mit einem anderen Konto an.

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

Diese Meldung erfordert Claude Code v2.1.169 oder neuer. Der Admin Ihrer Console-Organisation hat die Authentifizierung per API-Schlüssel deaktiviert, sodass die API den Schlüssel ablehnt, den Claude Code sendet. Der Hinweis zur Behebung nach dem `·` variiert je nachdem, woher der Schlüssel stammt:

```text theme={null}
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
Your organization has disabled API key authentication · Sign in again with your claude.ai account
```

Die letzte Form erscheint in einer Sitzung, die von der Claude Desktop-App ausgeführt wird, etwa im Code-Tab oder in Cowork, wo Sie sich in der App erneut anmelden.

Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, sodass das alleinige Ausführen von `/login` nicht hilft, solange eines davon noch einen Schlüssel liefert. Siehe [Vorrang der Authentifizierung](https://code.claude.com/docs/de/authentication.md#authentication-precedence).

**Vorgehensweise:**

* Wenn die Meldung `ANTHROPIC_API_KEY` nennt, entfernen Sie die Variable in der aktuellen Shell und aus Ihrem Shell-Profil oder Ihrer `.env`-Datei, und starten Sie dann `claude` neu
* Wenn die Meldung `apiKeyHelper` nennt, entfernen Sie die Einstellung [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper) aus Ihrer `settings.json`
* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden
* Führen Sie anschließend `/status` aus, um zu prüfen, ob Ihr Abonnement und nicht ein API-Schlüssel die aktiven Anmeldedaten sind
* Wenn Sie für Automatisierung die Authentifizierung per API-Schlüssel benötigen, bitten Sie den Admin Ihrer Organisation, sie in der Console wieder zu aktivieren

### Ihre Organisation hat den Zugriff per Claude-Abonnement deaktiviert

Ihre Claude-Organisation erlaubt keine Anmeldung bei Claude Code mit einer Abonnement-Anmeldung. Ein erneutes Ausführen von `/login` mit demselben Konto führt zum selben Fehler.

```text theme={null}
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, sodass sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden kann.

Das Agent SDK und der nicht interaktive Modus `-p` geben dies als Fehlercode `oauth_org_not_allowed` aus.

**Vorgehensweise:**

* Bitten Sie Ihren Admin, den Zugriff auf Claude Code für Ihre Organisation zu aktivieren
* Authentifizieren Sie sich mit einem Console-API-Schlüssel statt mit Ihrem Abonnement. Die Einrichtung finden Sie unter [Authentifizierung über die Claude Console](https://code.claude.com/docs/de/authentication.md#claude-console-authentication).
* Wenn Sie der Admin sind und keine Option zum Aktivieren des Zugriffs sehen, wenden Sie sich an den [Anthropic-Support](https://support.claude.com)

### Scheduled tasks are off for your organization

[Geplante Aufgaben in der Cloud](https://code.claude.com/docs/de/routines.md) sind für Ihre Organisation ausgeschaltet, daher können Sie sie weder erstellen noch ausführen. Die Meldung von claude.ai bezeichnet sie als geplante Aufgaben oder Routinen, gefolgt von einem Satz über Ihren Admin:

```text theme={null}
Scheduled tasks are off for your organization. …
Routines are off for your organization. …
```

Sie können sie nicht über lokale Einstellungen, Umgebungsvariablen oder CLI-Flags einschalten.

**Vorgehensweise:**

* Fragen Sie Ihren Team- oder Enterprise-Owner, ob er den Schalter mit der Beschriftung **Scheduled tasks (Was Routines)** oder **Routines** unter [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) einschalten kann

### Remote Control erfordert die Anthropic API

Die Sitzung kommuniziert nicht direkt mit der Anthropic API, was [Remote Control](https://code.claude.com/docs/de/remote-control.md) voraussetzt.

```text theme={null}
Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
```

Ein zweiter Satz erklärt, was die Sitzung von der Anthropic API weggeleitet hat; vor v2.1.219 bestand die Meldung nur aus dem ersten Satz. Je nach Ursache nennt die Meldung:

* Eine `CLAUDE_CODE_USE_*`-Anbietervariable, etwa `CLAUDE_CODE_USE_BEDROCK` für [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) oder `CLAUDE_CODE_USE_VERTEX` für [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md)
* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars), das auf einen anderen Host als `api.anthropic.com` zeigt, etwa ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) oder einen Proxy, selbst wenn Sie sich mit claude.ai anmelden; vor v2.1.196 hat eine benutzerdefinierte Basis-URL Remote Control nicht blockiert
* Ein gesetztes `ANTHROPIC_UNIX_SOCKET`, sodass die Sitzung ihre Anfragen über einen lokalen Socket statt an `api.anthropic.com` sendet
* Eine Anmeldung an einem Enterprise-[Cloud-Gateway](https://code.claude.com/docs/de/claude-apps-gateway) über `/login`, das Remote Control nicht unterstützt und keine Variable hat, die entfernt werden könnte

**Vorgehensweise:**

* Entfernen Sie die in der Meldung genannte Variable, etwa `CLAUDE_CODE_USE_BEDROCK` oder `ANTHROPIC_BASE_URL`, und starten Sie die Sitzung neu, oder starten Sie Remote Control aus einer Sitzung, die direkt mit der Anthropic API kommuniziert
* Wenn die Variable in Ihrer Shell nicht gesetzt ist, prüfen Sie den Schlüssel `env` in Ihren [Einstellungsdateien](https://code.claude.com/docs/de/settings.md#where-settings-live), der Umgebungsvariablen auf jede Sitzung anwendet
* Für diese und andere Startmeldungen von Remote Control siehe [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#troubleshooting)

### Remote Control konnte Ihre Anmeldung nicht aktualisieren

Claude Code betreibt eine aktive [Remote Control](https://code.claude.com/docs/de/remote-control.md)-Verbindung mit kurzlebigen Anmeldedaten, die es mithilfe Ihrer gespeicherten claude.ai-Anmeldung bezieht und erneuert. Wenn claude.ai diese Anmeldung nicht mehr akzeptiert oder Claude Code keine gespeicherte Anmeldung mehr hat, stoppt Claude Code Remote Control, und Sie müssen sich erneut anmelden. Beide Fehler können auftreten, während Claude Code noch eine Verbindung herstellt, oder später, wenn es die Anmeldedaten erneuert.

Wenn Claude Code den Anmeldedienst auffordert, Ihre gespeicherte Anmeldung zu aktualisieren, und keine Antwort erhält, lässt es Remote Control weiterlaufen und versucht die Aktualisierung erneut, solange die aktuellen Anmeldedaten der Verbindung noch gültig sind. Eine Aktualisierung erhält keine Antwort, wenn Claude Code den Anmeldedienst nicht erreichen kann, die Anfrage eine Zeitüberschreitung erreicht oder der Dienst fehlschlägt, ohne Ihre Anmeldung abzulehnen. Wenn der Anmeldedienst beim Ablauf dieser Anmeldedaten immer noch nicht antwortet, stoppt Claude Code Remote Control und meldet `OAuth token refresh failed`.

Wenn Claude Code Remote Control stoppt, zeigt es den Grund in einer Warnung und in einer Transkriptzeile an, die mit `Remote Control disconnected` beginnt. Ihre lokale Sitzung läuft ohne Remote Control weiter. Dieser Abschnitt behandelt die folgenden Zeilen:

```text theme={null}
Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
```

Claude Code nennt die Ursache in der Mitte der Meldung:

* `Claude.ai login expired` und `Claude.ai login was rejected`: claude.ai akzeptiert Ihr gespeichertes Anmelde-Token nicht mehr, weil es abgelaufen ist oder widerrufen wurde
* `OAuth token unavailable`: Claude Code hatte kein gespeichertes Anmelde-Token, als die Anmeldedaten der Verbindung erneuert werden mussten
* `OAuth token refresh failed`: claude.ai hat Ihr gespeichertes Anmelde-Token abgelehnt, während Claude Code die Verbindung wiederherstellte, und die Aktualisierung des Tokens hat kein neues ergeben
* `JWT refresh failed: no OAuth token`: Claude Code hat kein gespeichertes Anmelde-Token zum Erneuern gefunden
* `Signed out of Claude`: Sie haben sich auf diesem Rechner abgemeldet, zum Beispiel durch Ausführen von `/logout` in einem anderen Terminal, sodass Claude Code keine gespeicherte Anmeldung mehr hat, mit der es die Verbindung erneuern könnte

**Vorgehensweise:**

* Führen Sie `/login` aus, um sich erneut anzumelden
* Führen Sie `/remote-control` aus, um die Sitzung wieder zu verbinden. Bei Meldungen, die mit `run /login to restore Remote Control` enden, ist dieser Schritt nicht nötig: Claude Code verbindet sich automatisch neu, sobald Sie sich anmelden.

Vor v2.1.224 lautete `OAuth token refresh failed — run /login to re-authenticate` noch `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, und `JWT refresh failed: no OAuth token — run /login` lautete `no OAuth token available for recovery (code <N>)`. Die Meldungen `Claude.ai login expired`, `Claude.ai login was rejected` und `OAuth token unavailable` wurden in v2.1.225 hinzugefügt.

Vor v2.1.238 hat Claude Code die Fälle, die jetzt `Signed out of Claude` lauten, als `JWT refresh failed: no OAuth token — run /login` gemeldet und Remote Control mit `Claude.ai login expired — run /login to restore Remote Control` gestoppt, sobald eine einzige Aktualisierung der Anmeldung keine Antwort erhielt.

### Remote Control could not renew this computer's connection

Diese Warnung erscheint in dem Terminal, in dem [`claude remote-control`](https://code.claude.com/docs/de/remote-control#start-a-remote-control-session) läuft, wenn der Server Ihre claude.ai-Anmeldung nicht verwenden kann, um die Anmeldedaten seiner Verbindung vor deren Ablauf zu erneuern. Der letzte Satz der Warnung gibt an, wie lange die aktuellen Anmeldedaten noch funktionieren oder dass sie bereits abgelaufen sind:

```text theme={null}
Remote Control could not renew this computer's connection: claude.ai did not accept the sign-in it uses. Run `claude /login` to sign in again. The connection keeps working for about 26 hours; if it still cannot sign in then, it stops.
```

**Vorgehensweise:**

* Wenn die Warnung Sie auffordert, `claude /login` auszuführen, öffnen Sie ein weiteres Terminal auf dem Rechner, auf dem der Server läuft, führen Sie dort `claude /login` aus und melden Sie sich mit Ihrem claude.ai-Konto an
* Wenn sich der Server auch nach Ablauf der Anmeldedaten der Verbindung nicht anmelden kann, gibt er einen Fehler aus, der `Poll: Authentication failed (401)` enthält, und stoppt. Melden Sie sich erneut an, wie es der zweite Satz der Warnung beschreibt, und führen Sie dann `claude remote-control` erneut in dem Terminal aus, in dem der Server gestoppt wurde.

### Remote Control wurde gestoppt, weil sich das angemeldete Konto geändert hat

Claude Code zeigt diese Zeile während einer [Remote Control](https://code.claude.com/docs/de/remote-control.md)-Sitzung an, wenn Sie sich auf diesem Rechner bei einem anderen claude.ai-Konto oder einer anderen Organisation anmelden. Sie haben den Wechsel außerhalb der Claude Code-Sitzung vorgenommen, zum Beispiel durch Ausführen von `/login` in einem anderen Terminal.

Eine Remote-Control-Sitzung, die Sie gestartet haben, während Sie über `/login` angemeldet waren, gehört zu dem claude.ai-Konto und der Organisation, die zu diesem Zeitpunkt angemeldet waren.

```text theme={null}
Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
```

Claude Code stoppt die Remote-Control-Sitzung, sobald claude.ai bestätigt, dass sich das Konto oder die Organisation geändert hat. Ihre lokale Sitzung läuft ohne Remote Control weiter.

**Vorgehensweise:**

* Führen Sie `/remote-control` aus, um eine neue Remote-Control-Sitzung unter dem aktuellen Konto oder der aktuellen Organisation zu starten
* Um zurückzuwechseln, führen Sie `/login` aus und melden Sie sich erneut beim vorherigen Konto oder der vorherigen Organisation an. Führen Sie dann `/remote-control` aus.

Vor v2.1.234 hat Claude Code nicht bemerkt, wenn Sie außerhalb der Claude Code-Sitzung zu einem anderen Konto oder einer anderen Organisation gewechselt sind. Claude Code hielt die Remote-Control-Sitzung verbunden, bis eine spätere Anfrage an den Remote-Control-Server mit `Remote Control server rejected the request (HTTP 404)` fehlschlug. Dieser Fehler konnte Stunden nach dem Wechsel auftreten.

### Remote Control wurde gestoppt, weil sich die App, die die Sitzung ausführt, abgemeldet oder das Konto gewechselt hat

Wenn die Claude Desktop-App oder eine IDE Ihre Sitzung hostet, erhält Claude Code sein Anmelde-Token von dieser App statt von `/login`. Wenn claude.ai dieses Token ablehnt, fordert Claude Code bei der App ein neues an. Antwortet die App, dass sie abgemeldet ist oder nun bei einem anderen Claude-Konto angemeldet ist, beendet Claude Code die [Remote Control](https://code.claude.com/docs/de/remote-control.md)-Sitzung und sendet der App eine dieser Zeilen:

```text theme={null}
Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
```

Ihre lokale Sitzung läuft ohne Remote Control weiter.

**Vorgehensweise:**

* Wenn die App abgemeldet ist, melden Sie sich erneut bei ihr an und schalten Sie Remote Control in der App wieder ein
* Wenn die App das Konto gewechselt hat, kann Claude Code die beendete Sitzung nicht unter dem neuen Konto fortsetzen. Starten Sie eine neue Remote-Control-Sitzung unter diesem Konto.

Vor v2.1.238 hat Claude Code der App in beiden Fällen die `run /login`-Meldungen gesendet, die unter [Remote Control konnte Ihre Anmeldung nicht aktualisieren](#remote-control-couldnt-refresh-your-login) aufgeführt sind.

### 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 Admin den Zugriff entfernt hat; ein abgelaufenes Token bedeutet, dass die automatische Aktualisierung während der Sitzung fehlgeschlagen ist.

Beide Meldungen geben eine Ablehnung wieder, die die API für eine von Claude Code gesendete Anfrage zurückgegeben hat. Wenn die gespeicherte Anmeldung nach einer fehlgeschlagenen Aktualisierung bereits gelöscht wurde, siehe stattdessen [Login expired](#login-expired). Wenn Sie sich mit einem langlebigen Token in [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/de/env-vars) authentifizieren, sehen Sie dieselben Meldungen, wenn dieses Token abläuft oder widerrufen wird.

```text theme={null}
OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`) und im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) lauten die Meldungen wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:

```text theme={null}
Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...
```

Vor v2.1.287 lautete die Meldung für ein widerrufenes Token im nicht interaktiven Modus und im Agent SDK `Your account does not have access to Claude. Please login again or contact your administrator.`

**Vorgehensweise:**

* Führen Sie `/login` im Prompt von Claude Code aus, um sich erneut anzumelden
* Wenn Ihr `-p`-Befehl oder Ihr Agent SDK-Programm eine gespeicherte Anmeldung verwendet, führen Sie `claude` in derselben Umgebung aus, schließen Sie `/login` ab und führen Sie dann den Befehl oder das Programm erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit [`ANTHROPIC_API_KEY`](https://code.claude.com/docs/de/env-vars) oder [erzeugen Sie ein langlebiges Token mit `claude setup-token`](https://code.claude.com/docs/de/authentication#generate-a-long-lived-token).
* Wenn Sie sich mit der Umgebungsvariable `CLAUDE_CODE_OAUTH_TOKEN` authentifizieren, sendet Claude Code nach einer mit 401 fehlgeschlagenen Anfrage weiterhin den von Ihnen gesetzten Wert, statt zum Token einer gespeicherten Anmeldung zu wechseln. [`/status`](https://code.claude.com/docs/de/commands) zeigt diese Anmeldedaten als Zeile `Auth token` mit dem Wert `CLAUDE_CODE_OAUTH_TOKEN` an. Erzeugen Sie ein neues Token mit [`claude setup-token`](https://code.claude.com/docs/de/authentication#generate-a-long-lived-token) und starten Sie damit neu, oder entfernen Sie die Variable und führen Sie `/login` aus. Vor v2.1.225 konnte Claude Code den Wert der Variable während der Sitzung durch das kurzlebige Zugriffstoken einer gespeicherten Anmeldung ersetzen, und die Sitzung schlug erneut mit 401-Fehlern fehl, sobald dieses Token abgelaufen war.
* Bei wiederholten Anmeldeaufforderungen über mehrere Starts hinweg finden Sie die Prüfungen der Systemuhr und die Schritte zur Wiederherstellung des Anmeldedatenspeichers unter macOS unter [Fehlerbehebung](https://code.claude.com/docs/de/troubleshoot-install.md#not-logged-in-or-token-expired)
* Für andere Fehler, darunter `403 Forbidden` und Probleme mit OAuth im Browser, siehe [Anmeldung und Authentifizierung](https://code.claude.com/docs/de/troubleshoot-install.md#login-and-authentication)

### API Error: 401 Invalid authentication credentials

Die API hat das Format Ihrer Anmeldedaten erkannt, aber das dahinterstehende Konto oder die Organisation abgelehnt. Anthropic gibt diese Meldung zurück, wenn Anmeldedaten kürzlich widerrufen wurden, wenn eine Organisation deaktiviert wurde oder Ihren Zugriff entfernt hat oder wenn das Konto selbst deaktiviert wurde – ein abgelaufenes Token ist also nicht die Ursache. Die Anmeldedaten können Ihre gespeicherte Anmeldung oder ein genehmigter `ANTHROPIC_API_KEY` sein, und die Behebung unterscheidet sich. Führen Sie daher zunächst `/status` aus, um zu sehen, welche aktiv sind.

```text theme={null}
Please run /login · API Error: 401 Invalid authentication credentials
```

**Vorgehensweise:**

* Wenn `/status` eine Zeile `API key` anzeigt, die nicht als nicht verwendet gekennzeichnet ist, ist ein genehmigter [`ANTHROPIC_API_KEY`](https://code.claude.com/docs/de/authentication#authentication-precedence) die aktiven Anmeldedaten und hat Vorrang vor Ihrer Anmeldung, sodass `/login` ihn nicht ersetzt. Rotieren Sie den Schlüssel in der Claude Console oder greifen Sie auf Ihr Abonnement zurück, indem Sie `unset ANTHROPIC_API_KEY` ausführen, in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
* Wenn `/status` nur Ihre Anmeldung anzeigt, führen Sie einmal `/login` aus. Wurden die Anmeldedaten widerrufen, ersetzt eine neue Anmeldung sie.
* Wenn dieselbe Meldung für dasselbe Anmeldekonto erneut erscheint, ist das Konto oder die Organisation nicht mehr aktiv. Prüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie den Admin Ihrer Organisation, den Zugriff wiederherzustellen.
* Wenn [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) auf ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) zeigt, ist der Text nach `401` die Meldung Ihres Gateways und nicht die von Anthropic, und `/login` ändert daran nichts. Korrigieren Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.
* Wenn jede Anfrage mit `401` fehlschlägt, obwohl Ihr Gateway die erwarteten Anmeldedaten hat, prüfen Sie, ob das Gateway und sein Upstream die Felder für die [Tool-Suche](https://code.claude.com/docs/de/mcp.md#tool-search-through-a-gateway) akzeptieren. Standardmäßig sendet Claude Code `defer_loading`-Tool-Felder und `tool_reference`-Blöcke mit dem `anthropic-beta`-Header, der sie aktiviert. Vor v2.1.304 war die Tool-Suche hinter einem Gateway deaktiviert, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` aktiviert hatten.

### Anmeldung abgelaufen

Claude Code hat versucht, Ihre gespeicherte claude.ai-Anmeldung zu erneuern, und der OAuth-Dienst hat das gespeicherte Refresh-Token abgelehnt, sodass Claude Code die gespeicherten Anmeldedaten gelöscht hat. Ohne [andere gespeicherte Anmeldedaten](https://code.claude.com/docs/de/authentication.md#after-the-login-expires) stoppen Modellanfragen dann mit dieser Meldung:

```text theme={null}
Login expired · Please run /login
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`) und im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:

```text theme={null}
Failed to authenticate: OAuth session expired and could not be refreshed
```

Wenn die Anmeldung ihr Zeitlimit erreicht hat, lauten beide Meldungen ab Claude Code v2.1.318 stattdessen `reached its time limit`. Für eine `Login expired`-Meldung, die mit `or re-authenticate your Anthropic profile` endet, siehe [Anthropic profile login expired](#anthropic-profile-login-expired).

Wenn die Erneuerung fehlschlägt, weil das Konto selbst gesperrt ist, zeigt Claude Code stattdessen [Your account is on hold](#your-account-is-on-hold) an.

**Vorgehensweise:**

* Führen Sie `/login` aus, um sich erneut anzumelden.
* Wenn Sie sich in einem anderen Claude Code-Fenster mit Ihrem claude.ai-Konto anmelden, erfahren Sie unter [Nicht angemeldet](#not-logged-in), wann diese Sitzung diese Anmeldung automatisch verwendet.
* Führen Sie im nicht interaktiven Modus `claude` in derselben Umgebung aus, schließen Sie `/login` ab und führen Sie dann Ihren Befehl erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [erzeugen Sie ein langlebiges Token mit `claude setup-token`](https://code.claude.com/docs/de/authentication#generate-a-long-lived-token).
* Wenn die Anmeldung weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](https://code.claude.com/docs/de/troubleshoot-install.md#login-and-authentication)

### Ihre Anmeldung konnte nicht aktualisiert werden, weil ein anderer Claude Code-Prozess sie gerade aktualisiert

Diese Meldung bedeutet nicht, dass Ihre Anmeldung abgelehnt wurde. Ihre gespeicherte claude.ai-Anmeldung war abgelaufen und musste erneuert werden. Ein anderer Claude Code-Prozess auf demselben Rechner hielt die gemeinsame Aktualisierungssperre oder wurde beendet und hat sie zurückgelassen, und die Aktualisierung kam nicht voran, während diese Sitzung wartete. Claude Code stoppt die Anfrage vor dem Senden:

```text theme={null}
Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`) und im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `server_error`:

```text theme={null}
Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
```

**Vorgehensweise:**

* Versuchen Sie es in einer Minute erneut. Wenn ein anderer Prozess die Aktualisierung zuerst abschließt, verwendet diese Sitzung die erneuerte Anmeldung.
* Wenn die Meldung weiterhin erscheint, schließen Sie andere Claude Code-Fenster und -Prozesse und versuchen Sie es dann erneut.
* Wenn sie erscheint, obwohl kein anderer Claude Code-Prozess läuft, führen Sie `/login` aus. Eine erneute Anmeldung wartet nicht auf die Aktualisierungssperre.

### Could not refresh your login: the disk that holds the Claude Code config directory is full

Geben Sie Speicherplatz auf dem Datenträger frei, der das Claude Code-Konfigurationsverzeichnis enthält, und senden Sie Ihre Nachricht dann erneut. Eine erneute Anmeldung würde nicht helfen, solange der Datenträger voll ist, da eine neue Anmeldung nicht gespeichert werden könnte. Das Konfigurationsverzeichnis ist `~/.claude` in Ihrem Home-Verzeichnis, sofern Sie nicht [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/de/env-vars) setzen.

```text wrap theme={null}
Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full · Delete files you no longer need on that disk, then try again · Signing in again won't help
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`) und im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) lautet die Meldung:

```text wrap theme={null}
Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full. Delete files you no longer need on that disk and retry; signing in again won't help
```

**Was Sie tun können:**

* Führen Sie bei einem Skript dessen `claude -p`-Befehl erneut aus
* Wenn der Datenträger bereits freien Speicherplatz anzeigt, führt ein erschöpftes Datenträgerkontingent oder ein Mangel an Inodes zur selben Meldung. Löschen Sie Ihre eigenen Dateien auf diesem Datenträger. Wenn die Meldung erneut erscheint, löschen Sie viele kleine Dateien statt weniger großer, da jede Datei unabhängig von ihrer Größe einen Inode belegt.

### Ihre Anmeldung konnte nicht gespeichert werden

Sie haben sich mit claude.ai angemeldet, aber Claude Code konnte die Anmeldung nicht in seinem Anmeldedatenspeicher speichern, sodass die Anmeldung nicht abgeschlossen wurde. Unter macOS kann dies passieren, wenn der Anmeldeschlüsselbund gesperrt wird, zum Beispiel im Ruhezustand oder bei Inaktivität, nachdem Claude Code in derselben Sitzung bereits Anmeldedaten darin gelesen oder gespeichert hat.

```text theme={null}
Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.
```

Die erste Form erscheint unter macOS, die zweite überall sonst. Ein vorübergehender Fehler des Anmeldedatenspeichers, etwa eine Zeitüberschreitung oder ein nicht lesbarer Speicher, erzeugt dieselbe Meldung.

**Vorgehensweise:**

* Entsperren Sie unter macOS den Anmeldeschlüsselbund und führen Sie dann erneut `/login` aus
* Führen Sie auf anderen Plattformen erneut `/login` aus
* Wenn die Anmeldung weiterhin nicht gespeichert wird, finden Sie unter [Nicht angemeldet oder Token abgelaufen](https://code.claude.com/docs/de/troubleshoot-install.md#not-logged-in-or-token-expired) den Befehl zum Entsperren des Schlüsselbunds und weitere Schritte zur Wiederherstellung des Anmeldedatenspeichers

### Sign in again to take your previous account or API key off the config file

Diese Warnung nach der Anmeldung bedeutet, dass ein Konto, mit dem Sie zuvor angemeldet waren, möglicherweise noch in [`~/.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json) gespeichert ist:

```text theme={null}
Sign in again to take your previous account or API key off the config file.
```

Auch ein API-Schlüssel kann noch in `~/.claude.json` stehen, wenn eine Console-Anmeldung unter Linux oder Windows einen erstellt hat.

**Vorgehensweise:**

* Führen Sie `claude auth login` in Ihrer Shell aus, um sich erneut anzumelden. Claude Code wiederholt dann den Speichervorgang, der das ersetzte Konto oder den API-Schlüssel aus der Datei entfernt.

### Your account or API key may still be in the config file

Sie haben `/logout` oder `claude auth logout` ausgeführt, und Claude Code hat diesen Prozess abgemeldet, konnte aber nicht bestätigen, dass [`~/.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json) Ihr Konto nicht mehr enthält. Entweder wurde das Speichern nicht übernommen, oder die Datei konnte zur Prüfung nicht zurückgelesen werden.

```text theme={null}
Your account or API key may still be in the config file. Run claude auth logout.
```

Auch ein API-Schlüssel kann noch in `~/.claude.json` stehen, wenn eine Console-Anmeldung unter Linux oder Windows einen erstellt hat.

**Vorgehensweise:**

* Führen Sie `claude auth logout` in Ihrer Shell aus, um das Speichern erneut zu versuchen. Wenn das Speichern erfolgreich ist, gibt der Befehl `Successfully logged out from your Anthropic account.` aus.

### Couldn't start the local listener that receives the browser sign-in

Jede dieser Meldungen von `/login`, `claude auth login` oder `claude setup-token` bedeutet, dass Claude Code den Port auf `127.0.0.1`, über den Ihr Browser das Anmeldeergebnis zurückgibt, nicht öffnen konnte.

Bei dem Hinweis, der mit `The browser can't return the sign-in to Claude Code automatically` beginnt, wird die Anmeldung ohne diesen Port fortgesetzt. Es öffnet sich kein Browser, und der Hinweis erscheint über einer URL, unter der Sie sich stattdessen anmelden:

```text wrap theme={null}
The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.
```

Bei der Meldung, die `Couldn't start the local listener` enthält, wurde die Anmeldung gestoppt. Das passiert zum Beispiel, wenn Sie Eingaben per Pipe an `claude auth login` übergeben:

```text theme={null}
Couldn't start the local listener that receives the browser sign-in. Try again.
```

**Vorgehensweise:**

* **`The browser can't return the sign-in to Claude Code automatically`**: Sie müssen zuerst nichts beheben. Öffnen Sie die unter dem Hinweis angezeigte URL in einem Browser und melden Sie sich an. Der Browser zeigt dann einen Code: Fügen Sie ihn in Claude Code bei der Eingabe `Paste code here >` ein, und die Anmeldung wird von dort fortgesetzt.
* **`Couldn't start the local listener that receives the browser sign-in`**: Führen Sie denselben Befehl erneut aus. Wenn er auf dieselbe Weise stoppt, melden Sie sich statt über den Browser mit einem Token oder API-Schlüssel an. Oder, falls Sie Eingaben per Pipe an `claude auth login` übergeben haben, führen Sie den Befehl in einem Terminal aus, damit er einen eingefügten Code annehmen kann.
* **Anmeldung mit einem Token oder API-Schlüssel statt über den Browser**: Wenn Sie ein claude.ai-Abonnement verwenden, führen Sie [`claude setup-token`](https://code.claude.com/docs/de/authentication#generate-a-long-lived-token) auf einem Rechner aus, auf dem die Anmeldung funktioniert. Setzen Sie dann das ausgegebene Token auf diesem Rechner als Umgebungsvariable [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/de/env-vars). Andernfalls setzen Sie die Umgebungsvariable `ANTHROPIC_API_KEY` auf einen Schlüssel aus der [Claude Console](https://platform.claude.com/settings/keys). Unter [Vorrang bei der Authentifizierung](https://code.claude.com/docs/de/authentication.md#authentication-precedence) wird erklärt, wie Claude Code zwischen Anmeldedaten wählt.
* **Automatische Rückgabe aus dem Browser wiederherstellen**: Claude Code muss auf `127.0.0.1` lauschen können. Wenn es in einer Sandbox läuft, prüfen Sie, ob die Richtlinie der Sandbox das Lauschen auf lokalen Ports erlaubt, und melden Sie sich dann erneut an. Wenn das Lauschen dort funktionieren sollte und der Hinweis trotzdem erscheint, führen Sie `/feedback` aus, damit der Bericht Ihre Umgebungsdetails enthält.

Vor v2.1.305 wurde die Anmeldung gestoppt, sobald der Port nicht geöffnet werden konnte, und es wurde keine URL zur Anmeldung angezeigt. Die Meldung lautete zum Beispiel `Failed to start OAuth callback server: Failed to start server. Is port 0 in use?`. Aktualisieren Sie bei diesen Versionen Claude Code und melden Sie sich erneut an, oder melden Sie sich statt über den Browser mit einem Token oder API-Schlüssel an.

### Claude-Anmeldung nicht akzeptiert

Sie haben versucht, eine [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) zu starten, und der Server hat sich geweigert, sie zu erstellen, mit einem 401: Er hat die Claude-Anmeldung, die dieser Rechner gesendet hat, nicht akzeptiert, meist weil die Anmeldung abgelaufen ist oder widerrufen wurde.

Der erste Teil der Zeile ist der eigene Grund des Servers, sofern er einen angibt. Andernfalls lautet die Zeile:

```text theme={null}
Claude login not accepted · Run /login, then try again
```

**Vorgehensweise:**

* Führen Sie `/login` aus, schließen Sie die Anmeldung ab und starten Sie die Sitzung dann erneut

### Artefakte erfordern eine claude.ai-Anmeldung

Claude Code hat das Veröffentlichen oder Lesen eines [Artefakts](https://code.claude.com/docs/de/artifacts.md) verweigert, weil die Sitzung keine claude.ai-Anmeldung hat, die es für Artefakte verwenden kann.

Jede Form der Meldung beginnt mit denselben Worten, gefolgt von einer Abhilfe, die davon abhängt, wie sich Ihre Sitzung authentifiziert. Ohne konkurrierende Anmeldedaten lautet sie:

```text theme={null}
Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
```

**Vorgehensweise:**

* Führen Sie `/login` aus und wählen Sie **Claude account with subscription**. Die Option **Anthropic Console account** stellt keine claude.ai-Anmeldedaten bereit.
* Wenn die Meldung Anmeldedaten nennt, die Vorrang haben, etwa `ANTHROPIC_API_KEY`, eine `apiKeyHelper`-Einstellung oder einen Console-Schlüssel, der durch ein früheres `/login` gespeichert wurde, entfernen Sie diese wie in der Meldung beschrieben und führen Sie dann `/login` aus
* Wenn die Meldung besagt, dass sich diese Remote-Sitzung über den Rechner authentifiziert, der sie gestartet hat, melden Sie sich auf diesem Rechner bei claude.ai an und verbinden Sie die Sitzung dann erneut
* Wenn die Meldung besagt, dass die Anmeldedaten von der Host-Umgebung der Sitzung eingespeist werden, können Sie sie in dieser Sitzung nicht ändern; starten Sie eine Sitzung, die bei claude.ai angemeldet ist
* Unter [Verfügbarkeit](https://code.claude.com/docs/de/artifacts.md#availability) finden Sie die weiteren Voraussetzungen für Artefakte, etwa Plan, Modellanbieter und Organisationsrichtlinie

### Administratorrichtlinie erfordert eine Anmeldung am Cloud-Gateway

Die [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) eines Administrators auf diesem Rechner setzen [`forceLoginMethod`](https://code.claude.com/docs/de/settings-reference#forceloginmethod) auf `"gateway"` oder setzen [`forceLoginGatewayUrl`](https://code.claude.com/docs/de/settings-reference#forcelogingatewayurl). Sofern Sie keinen Cloud-Anbieter über eine Variable wie `CLAUDE_CODE_USE_BEDROCK` auswählen, akzeptiert Claude Code dann nur die Anmeldung am [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway). Sie sehen eine von zwei Meldungen:

```text theme={null}
Not signed in to the Cloud gateway — run /login.
```

Modellanfragen schlagen mit dieser Meldung fehl, wenn die Sitzung keine Gateway-Anmeldung hat, zum Beispiel weil Sie `/login` nicht mehr ausgeführt haben, seit die Richtlinie auf den Rechner gelangt ist.

Wenn der Rechner außerdem von Anthropic ausgestellte Anmeldedaten enthält und die verwalteten Einstellungen `forceLoginMethod` oder `forceLoginOrgUUID` setzen, wird Claude Code stattdessen beim Start beendet. Diese Anmeldedaten können eine Variable `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN`, eine `apiKeyHelper`-Einstellung oder ein API-Schlüssel sein, der bei einer früheren Anmeldung über die Claude Console gespeichert wurde.

Die Startmeldung nennt die Anmeldedaten, mit denen die Sitzung konfiguriert ist, wo sie gesetzt sind und den Schritt, mit dem sie entfernt werden. Ist zum Beispiel eine Variable `ANTHROPIC_API_KEY` in Ihrer Shell gesetzt, lautet sie:

```text theme={null}
Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.
```

**Vorgehensweise:**

* Führen Sie bei `Not signed in to the Cloud gateway` den Befehl `/login` aus und schließen Sie die Anmeldung auf dem Bildschirm **Cloud gateway** ab
* Entfernen Sie bei der Startmeldung die Anmeldedaten, indem Sie den Schritten am Ende der Meldung folgen
* Wenn Sie der Meinung sind, dass der Rechner das Gateway nicht erfordern sollte, bitten Sie den Administrator, der ihn verwaltet, `forceLoginMethod` und `forceLoginGatewayUrl` aus seinen verwalteten Einstellungen zu entfernen

Vor v2.1.284 hat die Startmeldung die möglichen Anmeldedaten aufgelistet, statt die konfigurierten zu nennen. Sie begann mit `Administrator policy requires a Cloud gateway sign-in on this machine; the Anthropic-issued credential configured here (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.` Wenn Sie diesen Wortlaut sehen und nicht erkennen können, welche Anmeldedaten Sie entfernen müssen, aktualisieren Sie auf v2.1.284 oder neuer und starten Sie `claude` erneut.

In v2.1.265 zeigte eine Regression die erste Meldung außerdem in einigen LLM-Gateway- und Proxy-Konfigurationen an, die sich mit einem API-Schlüssel, `apiKeyHelper` oder benutzerdefinierten Headern authentifizieren, selbst wenn auf dem Rechner keine Administratoranforderung bestand. Aktualisieren Sie auf v2.1.266 oder neuer. Sie müssen Ihre Konfiguration nicht ändern.

Vor v2.1.261 hat Claude Code auf Rechnern, die `forceLoginMethod` auf `"gateway"` setzen, eine übrig gebliebene gespeicherte Anmeldung verwendet, statt Modellanfragen fehlschlagen zu lassen, und konfigurierte Anmeldedaten aus der Umgebung mit `This machine's managed settings require a first-party login` statt mit der Startmeldung gemeldet.

### Ihr Konto ist gesperrt

Das Claude-Konto hinter Ihrer Anmeldung wurde gesperrt. Claude Code zeigt die erste Meldung an, wenn es versucht, Ihre gespeicherte Anmeldung zu erneuern, und dabei von der Sperre erfährt, und die zweite, wenn eine Anmeldung, die Sie im Browser abschließen, die Sperre meldet:

```text theme={null}
Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
```

Eine erneute Anmeldung mit demselben Konto beseitigt die Meldung nicht, da die Sperre auf dem Konto und nicht auf der Anmeldung liegt. Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`) und im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) ist der strukturierte Fehlercode `account_on_hold`. Vor v2.1.235 hat Claude Code ein gesperrtes Konto als [Login expired · Please run /login](#login-expired) gemeldet, dessen Schritte zur Behebung eine Sperre nicht aufheben können.

**Vorgehensweise:**

* Öffnen Sie den Link in der Meldung, um die Details der Sperre anzuzeigen oder Einspruch einzulegen
* Wenn Sie ein anderes Claude-Konto oder einen API-Schlüssel haben, der nicht von der Sperre betroffen ist, können Sie weiterarbeiten, während die Sperre geklärt wird: Führen Sie `/login` mit diesem Konto aus oder setzen Sie den Schlüssel mit `ANTHROPIC_API_KEY`

### Anmeldung für Anthropic-Profil abgelaufen

Claude Code authentifiziert sich über ein Anthropic-Anmeldedatenprofil, dessen gespeicherte Anmeldedaten abgelaufen sind, und das Profil enthält keine Refresh-Anmeldedaten, die Claude Code zur Erneuerung verwenden kann. Claude Code stoppt jede Anfrage lokal, ohne sie zu wiederholen.

```text theme={null}
Anthropic profile login expired · Re-authenticate your Anthropic profile
Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile
```

**Vorgehensweise:**

* Wenn die Meldung mit `Login expired` beginnt, führen Sie `/login` aus, um sich erneut anzumelden
* Um ein Profil zu erneuern, das die schlüssellose Console-Anmeldung oder `ant auth login` der Claude Platform CLI geschrieben hat, führen Sie `/login` auf einem Rechner aus, der [die schlüssellose Anmeldung anbietet](https://code.claude.com/docs/de/authentication.md#sign-in-without-an-api-key). Wählen Sie das Anthropic Console-Konto und dann **Sign in with your Console account**. Claude Code ersetzt die abgelaufenen Anmeldedaten in diesem Profil
* Um ein Profil zu erneuern, das ein anderes Tool erstellt hat, melden Sie sich erneut mit diesem Tool an. Wenn Sie stattdessen bei `/login` **Sign in with your Console account** wählen, lässt Claude Code das Profil unverändert und erstellt einen API-Schlüssel
* Wenn ein Administrator die Anmeldedaten des Profils bereitgestellt hat, bitten Sie ihn, neue auszustellen
* Führen Sie `/status` aus, um die aktive Quelle für Anmeldedaten und den Profilnamen zu prüfen
* Um das Profil nicht mehr zu verwenden, entfernen Sie `ANTHROPIC_PROFILE`, falls Sie es gesetzt haben, und authentifizieren Sie sich dann auf andere Weise, etwa mit `/login` oder `ANTHROPIC_API_KEY`

Der Anfang der Meldung verrät Ihnen, wie Claude Code das Profil gefunden hat:

* Wenn Claude Code das Profil in Ihrem Konfigurationsverzeichnis ermittelt hat und dessen Authentifizierungsmodus `user_oauth` ist, beginnt die Meldung mit `Login expired` und bietet zuerst `/login` an. Claude Code gibt einem funktionierenden `/login` Vorrang vor dem ermittelten Profil und authentifiziert sich dann stattdessen mit Ihrem claude.ai-Konto. Von v2.1.234 bis v2.1.277 lautete diese Form `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile`. Vor v2.1.234 zeigte Claude Code auch in diesem Fall die Form `Re-authenticate your Anthropic profile` an.
* Wenn Sie das Profil mit `ANTHROPIC_PROFILE` ausgewählt haben, beginnt die Meldung mit `Anthropic profile login expired`.

Dies erscheint nur, wenn die aktiven Anmeldedaten aus einem Anthropic-Anmeldedatenprofil stammen – einem, das Sie mit der Umgebungsvariable `ANTHROPIC_PROFILE` auswählen, das Claude Code als aktives Profil in Ihrem Anthropic-Konfigurationsverzeichnis ermittelt oder das Claude Code geschrieben hat, als Sie sich [ohne API-Schlüssel angemeldet](https://code.claude.com/docs/de/authentication.md#sign-in-without-an-api-key) haben. Sitzungen, die sich mit einem API-Schlüssel, einem Bearer-Token wie `ANTHROPIC_AUTH_TOKEN` oder einem Drittanbieter authentifizieren, sehen diese Meldung nie.

### OAuth-Scope-Anforderung

Das gespeicherte Token ist älter als ein Berechtigungs-Scope, den eine neuere Funktion benötigt:

```text theme={null}
OAuth token does not meet scope requirement: user:profile
```

**Vorgehensweise:**

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

### claude.ai hat das Sitzungstoken abgelehnt

Eine Anfrage an einen [claude.ai-Konnektor](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai) ist fehlgeschlagen, weil claude.ai das Token aus Ihrer Claude Code-Anmeldung abgelehnt hat. Das abgelehnte Token ist Ihre Anmeldung, nicht die eigene Autorisierung des Konnektors in claude.ai, sodass eine erneute Autorisierung des Konnektors das Problem nicht behebt. In `/mcp` wird der Konnektor als `session token rejected` angezeigt, und seine Detailansicht lautet:

```text theme={null}
claude.ai rejected the session token. Run /login, then reconnect.
```

**Vorgehensweise:**

* Führen Sie `/login` aus, um sich erneut anzumelden
* Verbinden Sie den Konnektor über `/mcp` erneut oder führen Sie `/mcp reconnect <server>` aus. Wenn Sie die Verbindung vor der erneuten Anmeldung wiederherstellen, bleibt der Konnektor im selben Zustand. Die Option **Reconnect** im `/mcp`-Panel meldet `your claude.ai session token was rejected`; die eingetippte Form `/mcp reconnect <server>` meldet eine erfolgreiche Wiederverbindung, obwohl das Token weiterhin abgelehnt wird.

Vor v2.1.222 hat Claude Code den Konnektor stattdessen als authentifizierungsbedürftig markiert, was Sie zum Autorisierungsablauf des Konnektors geführt hat, obwohl dessen Abschluss den Zustand nicht behoben hat.

### MCP-Server erfordert eine erneute Anmeldung

Ein Remote-[MCP-Server](https://code.claude.com/docs/de/mcp.md) hat die Anmeldedaten bei einem Tool-Aufruf während der Sitzung abgelehnt, meist weil eine Anmeldung oder ein Token abgelaufen ist oder weil dem Token eine Berechtigung fehlt, die das Tool benötigt. Der Tool-Aufruf schlägt fehl, und `/mcp` markiert den Server als [authentifizierungsbedürftig](https://code.claude.com/docs/de/mcp.md#authenticate-with-remote-mcp-servers).

Bei einem Server, bei dem Sie sich über Claude Code anmelden, einschließlich eines claude.ai-Konnektors, ist die Anmeldung abgelaufen oder wurde widerrufen:

```text theme={null}
MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
```

Führen Sie `/mcp` aus, wählen Sie den Server aus und melden Sie sich über sein Menü erneut an.

Bei einem Server, der mit einem [`headersHelper`](https://code.claude.com/docs/de/mcp#use-dynamic-headers-for-custom-authentication)-Skript konfiguriert ist, hat Claude Code den Helper bereits erneut ausgeführt und den Aufruf einmal wiederholt, bevor dies angezeigt wird:

```text theme={null}
MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
```

Prüfen Sie, ob der Helper Anmeldedaten zurückgibt, die der Server akzeptiert, und stellen Sie dann die Verbindung über `/mcp` wieder her, wodurch der Helper erneut ausgeführt wird.

Bei einem Server mit einem statischen `Authorization`-Header in seiner Konfiguration:

```text theme={null}
MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
```

Aktualisieren Sie den Header-Wert dort, wo der Server konfiguriert ist, und stellen Sie dann die Verbindung über `/mcp` wieder her.

In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung auf Ihrem Rechner in der Claude Desktop-App bedeuten diese Meldungen, dass der MCP-Server Anmeldedaten abgelehnt hat, die ihm übergeben wurden. Korrigieren Sie die in der Meldung genannten und starten Sie dann eine neue Aufgabe oder einen neuen Chat in Cowork:

```text theme={null}
MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)
MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)
```

* **`headersHelper`-Anmeldedaten abgelehnt**: Prüfen Sie, ob der Helper Anmeldedaten zurückgibt, die der Server akzeptiert, und starten Sie dann eine neue Aufgabe oder einen neuen Chat in Cowork
* **`Authorization`-Header abgelehnt**: Aktualisieren Sie den `Authorization`-Wert unter `headers` in der Konfiguration dieses Servers und starten Sie dann eine neue Aufgabe oder einen neuen Chat in Cowork

Vor v2.1.302 zeigte eine Cowork-Sitzung stattdessen die Endungen `run /mcp to reconnect` an, obwohl `/mcp` dort nicht verfügbar ist. Wenn Sie eine solche Endung in Cowork sehen, prüfen Sie trotzdem den Helper oder aktualisieren Sie den Header und starten Sie dann eine neue Aufgabe oder einen neuen Chat. Vor v2.1.273 zeigten die Fälle einer abgelaufenen Anmeldung, des `headersHelper` und des `Authorization`-Headers alle `MCP server "<name>" requires re-authorization (token expired)` an.

Ein Server kann einen Tool-Aufruf auch mit HTTP 403 `insufficient_scope` ablehnen, um Sie zur Autorisierung eines Scopes aufzufordern, manchmal eines, das Ihr Token bereits enthält. Die Meldung nennt diesen Scope:

```text theme={null}
MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
```

Führen Sie `/mcp` aus, wählen Sie den Server aus und authentifizieren Sie sich über sein Menü erneut.

Wenn die Konfiguration des Servers weder [`oauth.scopes`](https://code.claude.com/docs/de/mcp#restrict-oauth-scopes) noch [`authServerMetadataUrl`](https://code.claude.com/docs/de/mcp#override-oauth-metadata-discovery) setzt, fordert Claude Code den vom Server genannten Scope an. Mit einer dieser Einstellungen fordert Claude Code stattdessen die Scopes dieser Einstellung an. Wenn Sie `oauth.scopes` festgelegt haben, fügen Sie den fehlenden Scope zu dieser Liste hinzu, bevor Sie sich erneut authentifizieren.

Vor v2.1.274 zeigte dieser Fall die Meldung `needs you to sign in again` an, und vor v2.1.273 zeigte er wie die anderen Fälle `requires re-authorization (token expired)` an.

### Couldn't read the stored credentials for MCP server

Claude Code speichert Ihre Anmeldungen für OAuth-[MCP-Server](https://code.claude.com/docs/de/mcp.md) in einem Anmeldedatenspeicher. Diese Meldung bedeutet, dass Claude Code diesen Speicher nicht lesen konnte, sodass eine Anfrage an den Server nicht ausgeführt wurde:

```text theme={null}
Couldn't read the stored credentials for MCP server "<name>", so the request didn't run. If your Mac's keychain is locked, unlock it, then try again.
Couldn't read the stored credentials for MCP server "<name>", so the request didn't run. Try again.
```

Ihre gespeicherten Anmeldungen sind unverändert: Versuchen Sie es erneut, sobald der Speicher gelesen werden kann, und melden Sie sich nur dann erneut an, wenn der Server Sie anschließend dazu auffordert.

Bei einer Ausführung von [`claude -p`](https://code.claude.com/docs/de/headless) oder des [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) unter macOS kann der Schlüsselbund lesbar werden, nachdem bereits eine Anfrage ohne die gespeicherte Anmeldung gesendet wurde. Diese Anfrage schlägt fehl mit:

```text theme={null}
A request to MCP server "<name>" was sent without your stored credentials, so the server rejected it. The credentials are available now. Try again.
```

**Was Sie tun können:**

* Wenn die Meldung Sie auffordert, den Schlüsselbund Ihres Mac zu entsperren, führen Sie [`claude doctor`](https://code.claude.com/docs/de/cli-reference#cli-commands) in der Shell-Sitzung aus, aus der Sie Claude Code starten, und prüfen Sie den Bericht auf eine Schlüsselbund-Warnung:
  * Wenn der Bericht eine Warnung enthält, die mit `macOS Keychain is not writable` beginnt, oder Ihre Shell keinen `claude`-Befehl hat, führen Sie diesen Entsperrbefehl in dieser Shell-Sitzung aus:

    ```bash theme={null}
    security unlock-keychain ~/Library/Keychains/login.keychain-db
    ```

  * Wenn der Bericht keine Schlüsselbund-Warnung enthält, überspringen Sie den Entsperrbefehl

* Versuchen Sie es dort erneut, wo Sie die Meldung gesehen haben:
  * Führen Sie bei `claude -p` den Befehl erneut aus
  * Verbinden Sie in einer interaktiven Sitzung den Server über `/mcp` erneut, wenn er dort als fehlgeschlagen angezeigt wird, und bitten Sie Claude dann, es erneut zu versuchen
  * Rufen Sie in einer weiterlaufenden Agent SDK-Anwendung in TypeScript [`reconnectMcpServer()`](https://code.claude.com/docs/de/agent-sdk/typescript#methods) oder in Python [`ClaudeSDKClient.reconnect_mcp_server()`](https://code.claude.com/docs/de/agent-sdk/python#methods) auf, oder starten Sie eine neue Sitzung

* Wenn der Server anschließend meldet, dass er eine Authentifizierung benötigt, hat Claude Code keine Anmeldung gefunden, die es für diesen Server verwenden kann. Melden Sie sich interaktiv an: Führen Sie `/mcp` in einer Claude Code-Sitzung oder [`claude mcp login <name>`](https://code.claude.com/docs/de/mcp#authenticate-from-the-command-line) in Ihrer Shell aus. Für eine Agent SDK-Anwendung siehe [OAuth2-Authentifizierung im Agent SDK](https://code.claude.com/docs/de/agent-sdk/mcp.md#oauth2-authentication).

Vor v2.1.307 meldete eine Ausführung von `claude -p` oder des Agent SDK auf einem Mac mit gesperrtem Anmeldeschlüsselbund, dass der Server eine Authentifizierung benötigt, statt eine der beiden Meldungen anzuzeigen.

### MCP-Server-URL fehlt oder ist keine gültige URL

Claude Code hat sich geweigert, eine OAuth-Anmeldung für einen Remote-MCP-Server zu starten, weil die konfigurierte `url` des Servers nicht als URL geparst werden kann. Sofern Claude Code kein spezifischeres Konfigurationsproblem für den Server zu melden hat, gibt das Ausführen von [`claude mcp login <name>`](https://code.claude.com/docs/de/mcp#authenticate-from-the-command-line) in Ihrer Shell die Ablehnung wie folgt aus:

```text theme={null}
Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.
```

**Vorgehensweise:**

* Setzen Sie die `url` des Eintrags dort, wo der Server konfiguriert ist, auf den tatsächlichen Endpunkt des Servers, oder setzen Sie die Umgebungsvariable, die seine [`${VAR}`-Referenz](https://code.claude.com/docs/de/mcp#environment-variable-expansion-in-mcp-json) nennt, und führen Sie die Anmeldung dann erneut aus.

### Issuer-Abweichung in der Autorisierungsantwort

Während einer [MCP-OAuth-Anmeldung](https://code.claude.com/docs/de/mcp.md#authenticate-with-remote-mcp-servers) hat der Autorisierungsserver mit einem `iss`-Parameter zurück zu Claude Code weitergeleitet, der nicht den Issuer nennt, den Claude Code aus den OAuth-Metadaten des Servers erwartet hat. Ein falscher Issuer in diesem Schritt ist das Erkennungszeichen eines Mix-up-Angriffs auf Autorisierungsserver, daher lässt Claude Code die Anmeldung fehlschlagen, statt den Autorisierungscode einzutauschen. Claude Code zeigt den Fehler nach der Browser-Anmeldung im Servermenü von `/mcp` an:

```text theme={null}
Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
```

`expected` ist der Issuer aus den OAuth-Metadaten des Servers, und `received` ist der `iss`-Wert, den die Weiterleitung enthielt. Eine Anmeldung, deren Weiterleitung keinen `iss`-Parameter enthält, besteht die Prüfung, es sei denn, die Metadaten des Servers setzen `authorization_response_iss_parameter_supported` – in diesem Fall lässt Claude Code die Anmeldung fehlschlagen.

**Vorgehensweise:**

* Versuchen Sie die Anmeldung über `/mcp` erneut
* Wenn der Fehler erneut auftritt, melden Sie ihn dem Betreiber des Servers. Die Behebung erfolgt serverseitig: Der Autorisierungsserver muss im `iss`-Parameter denselben Issuer zurückgeben, den er in seinen Metadaten angibt
* Um eine Verbindung herzustellen, während der Server korrigiert wird, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](https://code.claude.com/docs/de/env-vars), dessen [Runtime](https://code.claude.com/docs/de/mcp.md#mcp-client-runtimes) diese Prüfung nicht durchführt. Dadurch entfällt ein Schutz vor Mix-up-Angriffen, bevorzugen Sie daher die serverseitige Behebung

Vor v2.1.232 hat Claude Code die v2-Runtime nur im Rahmen einer schrittweisen Einführung oder dann verwendet, wenn Sie `MCP_SDK_GENERATION=v2` gesetzt hatten.

### Stopped an OAuth request

Diese Meldung bedeutet, dass Claude Code eine [OAuth-Anfrage für einen MCP-Server](https://code.claude.com/docs/de/mcp.md#authenticate-with-remote-mcp-servers) gestoppt hat, weil ein OAuth-Endpunkt sie weitergeleitet hat. In beiden Formen der Meldung ist die erste Adresse diejenige, die die Weiterleitung gesendet hat:

```text theme={null}
Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.
Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.
```

**Was zu tun ist:**

* Bitten Sie den Betreiber der ersten Adresse, etwa den Betreiber des MCP-Servers, die Weiterleitung zu entfernen oder zu korrigieren. Versuchen Sie es dann über `/mcp` erneut.

### Anmeldedaten werden nicht an einen Token-Endpunkt ohne HTTPS gesendet

In der [v2-Runtime](https://code.claude.com/docs/de/mcp.md#mcp-client-runtimes) sendet Claude Code eine [MCP-OAuth](https://code.claude.com/docs/de/mcp.md#authenticate-with-remote-mcp-servers)-Token-Anfrage nur an einen Token-Endpunkt, der über HTTPS oder unter `localhost`, `127.0.0.1` oder `::1` bereitgestellt wird. Diese Meldung bedeutet, dass der Token-Endpunkt des Servers keines von beidem ist, sodass Claude Code vor dem Senden der Anfrage gestoppt hat. Das geschieht nach der Browser-Anmeldung, sodass der Browserschritt zunächst erfolgreich ist, und erneut jedes Mal, wenn Claude Code das Token des Servers aktualisiert.

In ihrer vollständigen Form stammt die Meldung aus dem MCP SDK und zitiert den abgelehnten Token-Endpunkt. Im Debug-Log folgt sie bei einer Anmeldung auf `Error during auth completion:` und bei einer Aktualisierung auf `Token refresh failed:`. In Ihrer Shell gibt `claude mcp login <name>` sie nach `Couldn't complete authentication for "<name>":` aus, und in einer Sitzung zeigt `/mcp` sie im Menü des Servers an:

```text theme={null}
Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).
```

Claude Code behandelt eine Server-URL mit einem Query-String oder einem langen, zufällig aussehenden Pfadsegment als möglicherweise geheim. Bei einem solchen Server schwärzt es die Anmeldefehler, die das MCP SDK auslöst, bevor es sie anzeigt oder protokolliert. Dieser Fehler erscheint dann als kurzer Name, der sich zwischen Releases ändern kann, etwa `io`, gefolgt von `from the MCP SDK for` und der geschwärzten Server-URL. Andere Fehler aus dem MCP SDK haben dort dieselbe Form. Die geschwärzte Meldung kann nur dann dieser Fehler sein, wenn der Token-Endpunkt des Servers einfaches `http://` unter einer anderen Adresse als `localhost`, `127.0.0.1` oder `::1` ist.

**Vorgehensweise:**

* Stellen Sie diesen Token-Endpunkt über HTTPS bereit, zum Beispiel indem Sie den Server hinter einen Reverse-Proxy oder Tunnel stellen, der TLS terminiert, und den Server so konfigurieren, dass er die `https://`-Adresse angibt
* Um eine Verbindung herzustellen, ohne den Server zu ändern, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](https://code.claude.com/docs/de/env-vars), dessen [Runtime](https://code.claude.com/docs/de/mcp.md#mcp-client-runtimes) diese Regel nicht anwendet und die Token-Anfrage über einfaches HTTP sendet. Diese Wahl gilt, bis Sie Claude Code beenden, und betrifft jeden Server. Die v1-Runtime überspringt außerdem die [Issuer-Prüfung](#issuer-mismatch-in-authorization-response), bevorzugen Sie daher die Bereitstellung des Endpunkts über HTTPS

### AWS-Anmeldedaten abgelaufen oder ungültig

Ihr AWS-Sitzungstoken ist abgelaufen oder wurde abgelehnt. Diese Meldung erscheint bei einem 401 von [Claude Platform on AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md) oder dem [Mantle-Endpunkt](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint), da diese Anbieter ein abgelaufenes Sicherheitstoken auf diese Weise melden.

Der Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der stabile Teil ist das einleitende `AWS credentials expired or invalid`:

```text theme={null}
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 ...
```

Vor v2.1.273 erschien diese Meldung nur, wenn `awsAuthRefresh` konfiguriert war.

**Vorgehensweise:**

* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, gehören die Anmeldedaten der App, die Claude Code gestartet hat, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator
* Wenn [`awsAuthRefresh`](https://code.claude.com/docs/de/amazon-bedrock#advanced-credential-configuration) gesetzt ist, führen Sie den in der Meldung genannten Befehl, etwa `aws sso login --profile myprofile`, in einem anderen Terminal aus, schließen Sie die Browser-Anmeldung ab und versuchen Sie es dann erneut. Andernfalls aktualisieren Sie die von Ihnen verwendeten AWS-Anmeldedaten selbst: Ihre SSO-Anmeldung, Zugriffsschlüssel, Ihren API-Schlüssel oder Ihr Proxy-Token
* Wenn `awsAuthRefresh` in einer interaktiven Sitzung gesetzt ist, können Sie stattdessen `/login` ausführen, **3rd-party platform** wählen und dann unter **Using 3rd-party platforms** die Option **Claude Platform on AWS · refresh credentials** auswählen, um denselben Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](https://code.claude.com/docs/de/claude-platform-on-aws.md#1-configure-aws-credentials)
* Wenn der Fehler erneut auftritt, nachdem der Aktualisierungsbefehl erfolgreich war, prüfen Sie mit `aws sts get-caller-identity` in derselben Shell und demselben Profil, ob die Identität außerhalb von Claude Code gültig ist

### AWS-Authentifizierung fehlgeschlagen

Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) hat einen 401 zurückgegeben.

Amazon Bedrock meldet ein abgelaufenes Sicherheitstoken als 403, aber ein 403 ist auch die Art, wie es eine verweigerte Autorisierung meldet, etwa eine `AccessDeniedException` aufgrund einer fehlenden IAM-Berechtigung. Claude Code kann diese beiden Ursachen nicht unterscheiden.

Ein 401 von Amazon Bedrock landet ebenfalls hier und nicht unter [AWS-Anmeldedaten abgelaufen oder ungültig](#aws-credentials-expired-or-invalid), da Amazon Bedrock ein abgelaufenes Token nicht als 401 meldet. Ein 401 von diesem Endpunkt stammt typischerweise von etwas anderem im Anfragepfad, etwa einem Unternehmens-Proxy.

Eine Aktualisierung der Anmeldedaten behebt ein abgelaufenes Token, aber nicht die anderen Ursachen, daher bietet die Meldung beides an:

```text theme={null}
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 Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der stabile Teil ist das einleitende `AWS authentication failed`.

Wenn der 403 die Antwort von Amazon Bedrock ist, dass Sie keinen Zugriff auf das Modell mit der angegebenen Modell-ID haben, fordert der Hinweis Sie stattdessen auf, das Modell für Ihr Konto und Ihre Region in der Amazon Bedrock-Konsole zu aktivieren.

Vor v2.1.273 erschien diese Meldung nur, wenn `awsAuthRefresh` konfiguriert war.

**Vorgehensweise:**

* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, gehören die Anmeldedaten der App, die Claude Code gestartet hat, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator
* Aktualisieren Sie Ihre AWS-Anmeldedaten für den Fall, dass abgelaufene Anmeldedaten die Ursache sind: Führen Sie den in der Meldung genannten [`awsAuthRefresh`](https://code.claude.com/docs/de/amazon-bedrock#advanced-credential-configuration)-Befehl aus, sofern einer gesetzt ist, oder aktualisieren Sie Ihre SSO-Anmeldung, Zugriffsschlüssel, Ihren API-Schlüssel oder Ihr Proxy-Token selbst
* Wenn Ihre Anmeldedaten aktuell sind, prüfen Sie, ob die IAM-Berechtigungen aus [IAM-Konfiguration](https://code.claude.com/docs/de/amazon-bedrock.md#iam-configuration) der von Ihnen verwendeten Identität zugewiesen sind und ob das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist
* Führen Sie `aws sts get-caller-identity` aus, um zu prüfen, welche Identität Ihre Anfragen verwenden

### Google Cloud-Anmeldedaten abgelaufen oder ungültig

Ihre Google Cloud-Anmeldedaten für [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) sind abgelaufen oder wurden abgelehnt: Die Anfrage hat einen 401 zurückgegeben, da Agent Platform den Ablauf von Anmeldedaten auf diese Weise meldet.

Der Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der stabile Teil ist das einleitende `Google Cloud credentials expired or invalid`:

```text theme={null}
Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
```

**Vorgehensweise:**

* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, gehören die Anmeldedaten der App, die Claude Code gestartet hat, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator
* Wenn Sie `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` gesetzt haben, folgen Sie stattdessen den Schritten für [Claude Models on Google Cloud (von Anthropic verwaltet)](https://code.claude.com/docs/de/claude-models-on-google-cloud-anthropic-managed.md#google-cloud-credentials-expired-or-invalid)
* Wenn Sie sich mit Application Default Credentials authentifizieren, führen Sie den in der Meldung genannten [`gcpAuthRefresh`](https://code.claude.com/docs/de/google-vertex-ai#advanced-credential-configuration)-Befehl oder `gcloud auth application-default login` aus, schließen Sie die Anmeldung ab und versuchen Sie es dann erneut
* Wenn Sie über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) mit gesetztem `CLAUDE_CODE_SKIP_VERTEX_AUTH` leiten, aktualisieren Sie das Gateway-Token in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_CUSTOM_HEADERS` und versuchen Sie es dann erneut
* Wenn Sie sich mit einer Schlüsseldatei für ein Dienstkonto authentifizieren, prüfen Sie, ob `GOOGLE_APPLICATION_CREDENTIALS` auf einen gültigen Schlüssel zeigt. Siehe [GCP-Anmeldedaten konfigurieren](https://code.claude.com/docs/de/google-vertex-ai.md#3-configure-gcp-credentials)
* Wenn der Fehler nach einer Aktualisierung erneut auftritt, prüfen Sie mit `gcloud auth application-default print-access-token` in derselben Shell, ob die Identität außerhalb von Claude Code funktioniert

Vor v2.1.273 zeigte ein 401 von Agent Platform stattdessen die generische Meldung `Please run /login` oder `Failed to authenticate` an, mit der sich Google Cloud-Anmeldedaten nicht aktualisieren lassen.

### Google Cloud authentication failed

[Google Clouds Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) hat einen 403-Fehler zurückgegeben, den sie für verweigerte Autorisierungen statt für abgelaufene Anmeldedaten verwendet. Meist fehlt der Identität, mit der Sie sich authentifizieren, eine IAM-Berechtigung, oder das Modell ist für Ihr Projekt nicht aktiviert.

Der Handlungshinweis in der Mitte variiert je nach Ihrer Konfiguration. Der stabile Teil ist das einleitende `Google Cloud authentication failed`:

```text theme={null}
Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
```

**Was Sie tun können:**

* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, gehören die Anmeldedaten der App, die Claude Code gestartet hat, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator
* Wenn Sie `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` gesetzt haben, folgen Sie stattdessen den Schritten für [Claude Models on Google Cloud (von Anthropic verwaltet)](https://code.claude.com/docs/de/claude-models-on-google-cloud-anthropic-managed.md#google-cloud-authentication-failed)
* Stellen Sie sicher, dass die Rollen aus der [IAM-Konfiguration](https://code.claude.com/docs/de/google-vertex-ai.md#iam-configuration) der Identität zugewiesen sind, mit der Sie sich authentifizieren
* Stellen Sie sicher, dass das Modell für Ihr Projekt aktiviert ist. Siehe [Modellzugriff anfordern](https://code.claude.com/docs/de/google-vertex-ai.md#2-request-model-access)

Vor v2.1.273 zeigte ein 403-Fehler von Agent Platform stattdessen die generische Meldung `Please run /login` oder `Failed to authenticate` an, mit der sich Google-Cloud-Anmeldedaten nicht aktualisieren lassen.

### Microsoft Foundry authentication failed

[Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) hat einen 401- oder 403-Fehler zurückgegeben: Die Azure-Anmeldedaten der Anfrage wurden abgelehnt, oder die dahinterstehende Identität hat keinen Zugriff auf die Foundry-Ressource. `/login` kann keine Azure-Anmeldedaten erzeugen. Der Handlungshinweis in der Mitte variiert je nach Ihrer Konfiguration. Der stabile Teil ist das einleitende `Microsoft Foundry authentication failed`:

```text theme={null}
Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
```

**Was Sie tun können:**

* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, gehören die Anmeldedaten der App, die Claude Code gestartet hat, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator
* Aktualisieren Sie die Anmeldedaten, die Sie unter [Azure-Anmeldedaten konfigurieren](https://code.claude.com/docs/de/microsoft-foundry.md#2-configure-azure-credentials) eingerichtet haben: Rotieren Sie `ANTHROPIC_FOUNDRY_API_KEY`, erzeugen Sie ein neues `ANTHROPIC_FOUNDRY_AUTH_TOKEN` oder führen Sie `az login` aus, damit sich die standardmäßige Microsoft-Entra-Anmeldedatenkette erneut anmelden kann
* Wenn die Anmeldedaten aktuell sind, stellen Sie sicher, dass die Identität Zugriff auf die Foundry-Ressource hat. Siehe [Azure-RBAC-Konfiguration](https://code.claude.com/docs/de/microsoft-foundry.md#azure-rbac-configuration)

Vor v2.1.273 zeigte ein 401- oder 403-Fehler von Microsoft Foundry stattdessen die generische Meldung `Please run /login` oder `Failed to authenticate` an, mit der sich Azure-Anmeldedaten nicht aktualisieren lassen.

### Could not load AWS or Google Cloud credentials

Claude Code konnte auf dem Rechner, auf dem es ausgeführt wird, keine verwendbaren Anmeldedaten aus der AWS-Anmeldedatenanbieterkette oder aus Ihren Google Application Default Credentials abrufen, daher hat keine Anfrage Ihren Cloud-Anbieter erreicht. Das Detail nach dem `·` nennt die konkrete Ursache, etwa eine abgelaufene SSO-Sitzung, fehlende Application Default Credentials, gemeldet als `Could not load the default credentials`, oder eine widerrufene Anmeldung, gemeldet als `invalid_grant`:

```text theme={null}
API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit `-p` und im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) lautet der strukturierte Fehlercode `cloud_credential_error`. Vor v2.1.267 zeigte die Meldung nur den Detailtext nach `API Error:` an, und der strukturierte Code war `server_error` oder `unknown`.

**Was Sie tun können:**

* Führen Sie den Anmeldebefehl Ihres Anbieters aus, etwa `aws sso login --profile myprofile` oder `gcloud auth application-default login`, und versuchen Sie es dann erneut. [Bedrock-, Agent-Platform- oder Foundry-Anmeldedaten werden nicht geladen](https://code.claude.com/docs/de/troubleshoot-install.md#bedrock-agent-platform-or-foundry-credentials-not-loading) zeigt, wie Sie die Anmeldedaten außerhalb von Claude Code überprüfen
* Wenn das Detail `AWS default-chain credential resolve timed out` lautet, ist die Kette hängen geblieben statt fehlgeschlagen; folgen Sie in diesem Fall stattdessen [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)

### AWS default-chain credential resolve timed out

Die standardmäßige AWS-Anmeldedaten-Anbieterkette hat innerhalb von 60 Sekunden keine Anmeldedaten geliefert, daher hat Claude Code die Auflösung abgebrochen und die Anfrage scheitern lassen. Dieser Timeout ist eine Ursache von [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Der Fehler liegt in der lokalen Auflösung der Anmeldedaten: Die Anfrage hat [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md) oder den [Mantle-Endpunkt](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint) nie erreicht. Claude Code leert seinen [Anmeldedaten-Cache](https://code.claude.com/docs/de/amazon-bedrock.md#credential-caching-and-resolution-timeout) und versucht es erneut, bevor dieser Fehler angezeigt wird. Wenn Sie ihn sehen, ist die Kette also bei wiederholten Versuchen hängen geblieben.

```text theme={null}
API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
```

Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf eine Eingabe wartet, die er nicht erhalten kann, sowie ein Container oder eine VM, deren Instance Metadata Service (IMDS) nie auf die Abfrage der Kette antwortet.

Vor v2.1.267 lautete die Meldung `API Error: AWS default-chain credential resolve timed out`.
Vor v2.1.207 ließ eine hängende Kette die Anfrage unbegrenzt warten, statt sie scheitern zu lassen.

**Was Sie tun können:**

* Führen Sie `aws sts get-caller-identity` in derselben Shell mit demselben `AWS_PROFILE` aus. Wenn auch dieser Befehl hängt, korrigieren Sie das Profil; ein `credential_process`-Befehl, der interaktiv nachfragt, ist eine häufige Ursache.
* Schließen Sie den Anmeldeschritt ab, bevor Sie Claude Code starten, zum Beispiel `aws sso login --profile myprofile`
* Wenn Ihre Kette eine interaktive Anmeldung ausführt, die berechtigterweise mehr als 60 Sekunden benötigt, etwa SSO mit MFA über einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars)

### Bedrock setup verification timed out waiting for AWS

Ein Aufruf an AWS während der Überprüfung der Anmeldedaten im [Bedrock-Einrichtungsassistenten](https://code.claude.com/docs/de/amazon-bedrock.md#sign-in-with-bedrock), etwa die Suche nach Anmeldedaten oder die Identitätsprüfung, wurde nicht innerhalb des 60-Sekunden-Limits abgeschlossen. Der Assistent wartet nicht länger und lässt den Überprüfungsschritt fehlschlagen:

```text theme={null}
Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
```

Die Zahl entspricht Ihrem Limit: standardmäßig 60 Sekunden oder der Wert, den Sie in [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars) festgelegt haben.

Häufige Ursachen sind ein Netzwerk oder Proxy, der Anfragen an AWS blockiert, einschließlich der Aktualisierung des SSO-Tokens, sowie ein Credential Helper, der noch auf eine Eingabe wartet, die Sie nicht sehen können. Erhöhen Sie das Limit nur, wenn der Helper berechtigterweise mehr Zeit benötigt.

Eine einzelne hängende Anfrage an AWS kann auch an ihrem eigenen Timeout pro Anfrage scheitern, was im selben Schritt eine kürzere Meldung anzeigt:

```text theme={null}
A request to AWS timed out. Check your network and proxy settings, then try again.
```

Wenn dieselben Zeitüberschreitungen beim Schritt zum Festlegen des Modells auftreten, markiert der Assistent ein Modell als `unreachable`, statt eine der beiden Meldungen anzuzeigen.

**Was Sie tun können:**

* Führen Sie `aws sts get-caller-identity` in derselben Shell aus. Wenn auch dieser Befehl hängt, liegt die Blockade außerhalb von Claude Code, in Ihrem Netzwerk, Ihrem Proxy oder dem Credential Helper in Ihrem AWS-Profil; beheben Sie das zuerst.
* Schließen Sie jede interaktive Anmeldung ab, bevor Sie den Assistenten öffnen, zum Beispiel `aws sso login --profile myprofile`
* Wenn ein Credential Helper in Ihrem AWS-Profil berechtigterweise länger als 60 Sekunden benötigt, um Sie zur Eingabe aufzufordern, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](https://code.claude.com/docs/de/env-vars)

### Cloud gateway session expired

Sie haben sich über ein [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) angemeldet, und die auf diesem Rechner gespeicherte Gateway-Sitzung ist abgelaufen und konnte nicht erneuert werden, oder das Gateway akzeptiert sie nicht mehr, zum Beispiel nachdem das [JWT-Secret des Gateways ersetzt wurde](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#jwt-secret-rotation). Wenn Sie diese Zeile sehen, wenn Sie `claude` interaktiv starten, wurde die Sitzung ohne Anmeldung am Gateway geöffnet:

```text theme={null}
Cloud gateway session expired — run /login to reconnect.
```

Dieselbe Zeile kann mitten in einer Sitzung erscheinen, wenn die Gateway-Anmeldedaten ablaufen und Claude Code sie nicht erneuern kann.

Bei einer [nicht interaktiven](https://code.claude.com/docs/de/headless.md) Ausführung, einer Hintergrundsitzung oder einer anderen unbeaufsichtigten Sitzung oder einem anderen `claude`-Unterbefehl als `claude auth` beendet sich Claude Code stattdessen mit dieser Meldung, wenn das Gateway die Sitzung nicht mehr akzeptiert:

```text theme={null}
Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
```

**Was Sie tun können:**

* Führen Sie `/login` in der Sitzung aus und schließen Sie die Anmeldung im Browser ab
* Bei einem nicht interaktiven Start starten Sie `claude` in derselben Umgebung, führen `/login` aus und führen dann Ihren Befehl erneut aus

### Sign-in timed out while waiting for you to continue

Während einer Anmeldung über ein [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) hat das Gateway das angemeldete Konto genannt, und Claude Code hat Sie gebeten, es zu bestätigen, bevor die Anmeldedaten gespeichert werden. Sie haben die Bestätigung über den Ablauf der Anmeldung hinaus offen gelassen, und das Gateway hat kein Refresh-Token ausgestellt, mit dem sie sich hätte erneuern lassen, sodass Claude Code beim Fortfahren nichts gespeichert hat:

```text theme={null}
Sign-in timed out while waiting for you to continue. Try again.
```

**Was Sie tun können:**

* Führen Sie `/login` erneut aus und bestätigen Sie das Konto, bevor die Anmeldung abläuft

### Gateway refused the request

Sie sind über ein [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) angemeldet, und eine Anfrage hat einen 403-Fehler zurückgegeben: Das Gateway oder der dahinterliegende Upstream hat sie abgelehnt. Eine erneute Anmeldung ändert an einer Ablehnung nichts, daher verweist die Meldung an Ihren Gateway-Administrator:

```text theme={null}
Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
```

**Was Sie tun können:**

* Bitten Sie Ihren Gateway-Administrator, die Anfrage nachzuschlagen. Der `API Error:`-Teil am Ende enthält die Ablehnung, die das Gateway zurückgegeben hat
* Für Administratoren: Eine [Zugriffskontrollregel](https://code.claude.com/docs/de/claude-apps-gateway-config.md#http-tuning) am Gateway gibt einen 403-Fehler zurück, den das [Audit-Log](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#logs) mit seinem Grund festhält, und eine Autorisierungsverweigerung eines Upstreams wird gemäß [Upstream-Fehlermeldungen](https://code.claude.com/docs/de/claude-apps-gateway-config.md#upstream-error-messages) durchgereicht

Vor v2.1.273 zeigte ein 403-Fehler bei einer Gateway-Sitzung stattdessen die generische Meldung `Please run /login` oder `Failed to authenticate` an, und eine erneute Anmeldung hob die Ablehnung nicht auf.

## Netzwerk- und Verbindungsfehler

Die meisten dieser Fehler bedeuten, dass eine Netzwerkanfrage von Claude Code ihr Ziel nicht erreicht hat oder etwas zwischen Claude Code und der API die Antwort auf dem Rückweg verändert hat. Wenn ein Eintrag auch eine lokale Ursache hat, wie z. B. einen fehlgeschlagenen Archivschreibvorgang, wird dies im Text angegeben. Sie entstehen normalerweise in Ihrem lokalen Netzwerk, Proxy oder Firewall oder in der Netzwerkrichtlinie der Cloud-Umgebung.

### Unable to connect to API

Die TCP-Verbindung zur API ist fehlgeschlagen oder wurde nie abgeschlossen. Bei den häufigen Verbindungsfehlercodes benennt die Nachricht die Art des Fehlers und behält den Code in Klammern:

```text theme={null}
Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
Request timed out. Check your internet connection and proxy settings
```

Ein Code, den Claude Code nicht erkennt, wird als `Unable to connect to API` angezeigt, gefolgt vom Code in Klammern. Einige dieser Meldungen können mehr als einen Code anzeigen: `Connection refused` kann `ConnectionRefused` oder `ECONNREFUSED` anzeigen, und `Can't reach the API server` kann `ENOTFOUND` oder `FailedToOpenSocket` anzeigen.

Vor v2.1.227 las sich jede dieser codierten Meldungen als `Unable to connect to API` gefolgt vom Code, z. B. `Unable to connect to API (ECONNREFUSED)`.

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](https://code.claude.com/docs/de/network-config.md)
* Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) auf dessen Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](https://code.claude.com/docs/de/llm-gateway-connect.md) für die Einrichtung.
* Wenn `ANTHROPIC_BASE_URL` bereits auf Ihr Gateway verweist und jede Anfrage mit `Connection dropped` endet, prüfen Sie, ob Ihr Gateway und dessen Upstream die Felder der [Tool-Suche](https://code.claude.com/docs/de/mcp.md#tool-search-through-a-gateway) akzeptieren. Standardmäßig sendet Claude Code `defer_loading`-Tool-Felder und `tool_reference`-Blöcke zusammen mit dem `anthropic-beta`-Header, der sie aktiviert. Vor v2.1.304 war die Tool-Suche hinter einem Gateway deaktiviert, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` aktiviert hatten.
* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](https://code.claude.com/docs/de/network-config.md#network-access-requirements) aufgelisteten Hosts zulässt
* Intermittierende Fehler werden [automatisch wiederholt](#automatic-retries)

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

* Überprüfen Sie, ob `ANTHROPIC_BASE_URL` gesetzt ist, indem Sie `echo $ANTHROPIC_BASE_URL` ausführen, oder `echo $env:ANTHROPIC_BASE_URL` in PowerShell, und suchen Sie danach im `env`-Block Ihrer [Einstellungsdateien](https://code.claude.com/docs/de/settings.md). Wenn es gesetzt ist, sendet Claude Code Modellanfragen an diese Adresse statt an `api.anthropic.com`, daher erzeugt ein veralteter Wert, der auf einen lokalen Proxy oder ein Gateway verweist, das nicht mehr läuft, `Connection refused`, obwohl `curl` die API erreicht. Entfernen Sie ihn aus Ihrem Shell-Profil oder den Einstellungen und starten Sie Claude Code aus einem neuen Terminal.
* 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.

### Unable to connect to Anthropic services

Während der Ersteinrichtung überprüft Claude Code, ob es `api.anthropic.com` und `platform.claude.com` erreichen kann, bevor der Anmeldeschritt angezeigt wird. Wenn eine der Überprüfungen fehlschlägt, druckt Claude Code den Grund aus und beendet sich.

```text theme={null}
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.
```

Claude Code sendet die Überprüfung durch die gleiche [Proxy-Konfiguration](https://code.claude.com/docs/de/network-config.md) wie API-Anfragen und gibt jeder Sonde 10 Sekunden. Wenn die fehlgeschlagene Sonde durch einen Proxy ging, benennt die Nachricht die Umgebungsvariable, die ihn konfiguriert hat, wie z. B. `HTTPS_PROXY`. Vor v2.1.222 verwendete die Überprüfung einen anderen Proxy-Transport ohne Timeout: Hinter einer Proxy-URL mit dem `https://`-Schema könnte sie auf `Checking connectivity...` unbegrenzt steckenbleiben und dann fehlschlagen, obwohl API-Anfragen durch denselben Proxy erfolgreich sind.

Claude Code überspringt diese Überprüfung, wenn eine [verwaltete Einstellungsdatei, MDM-Richtlinie oder Richtlinien-Hilfsprogramm](https://code.claude.com/docs/de/managed-settings.md) [`forceLoginMethod`](https://code.claude.com/docs/de/settings-reference#forceloginmethod) auf `"gateway"` setzt oder [`forceLoginGatewayUrl`](https://code.claude.com/docs/de/settings-reference#forcelogingatewayurl) ohne `forceLoginMethod` setzt. Mit einer dieser Konfigurationen öffnet Claude Code den Anmeldeschritt auf dem Bildschirm **Cloud gateway** statt einer Anthropic-Anmeldemethode. Claude Code überspringt die Überprüfung auch, wenn eine verwaltete Einstellungsquelle auf dem Computer vorhanden ist, aber nicht gelesen werden kann, da diese Quelle die Gateway-Konfiguration enthalten kann. Vor v2.1.247 führte Claude Code die Überprüfung auch unter dieser Konfiguration aus und beendete sich mit diesem Fehler, wenn die Anthropic-Endpunkte unerreichbar waren.

Claude Code überspringt die Überprüfung auch auf einem Computer ohne verwaltete Einstellungen, wenn Ihre eigene `~/.claude/settings.json` mit `forceLoginMethod` und `forceLoginGatewayUrl` [ein Gateway benennt](https://code.claude.com/docs/de/claude-apps-gateway#set-the-gateway-url-in-user-settings). Vor v2.1.295 führte Claude Code die Überprüfung in diesem Fall aus.

**Was zu tun ist:**

* Wenn die Nachricht eine Proxy-Variable benennt, überprüfen Sie, dass ihr Wert auf den richtigen Proxy verweist, und bitten Sie Ihr Netzwerk-Team, HTTPS-Verbindungen durch ihn zum Host in der Nachricht zuzulassen. Siehe [Netzwerkkonfiguration](https://code.claude.com/docs/de/network-config.md).
* Arbeiten Sie die Überprüfungen in [Unable to connect to API](#unable-to-connect-to-api) durch. Der `curl`-Test und die Firewall-Anleitung dort gelten auch für diese Überprüfung.
* Wenn Ihr Netzwerk offen ist und der Fehler weiterhin besteht, ist Claude Code möglicherweise nicht [in Ihrem Land verfügbar](https://www.anthropic.com/supported-countries)

### Socket is closed

`Socket is closed` bedeutet, dass die Verbindung, die eine Streaming-Antwort übertrug, geschlossen wurde, während die Antwort noch ankam. Die häufigste Ursache ist ein Unternehmens-Proxy unter Windows, der einen etablierten Tunnel mitten in der Antwort abbricht.

Je nachdem, wie weit die Antwort fortgeschritten war, wiederholt Claude Code die Anfrage, behält das, was Claude produziert hat, oder beendet den Turn. Siehe [Automatische Wiederholungen](#automatic-retries).

Vor v2.1.214 wiederholte Claude Code diesen Fehler nicht, und der Turn stoppte mit einem Fehler, der `Socket is closed` enthielt.

**Was zu tun ist:**

* Wenn Sie diesen Fehler sehen, aktualisieren Sie mit `claude update` auf v2.1.214 oder später und senden Sie Ihre Nachricht erneut
* Wenn Turns hinter demselben Proxy nach dem Update weiterhin fehlschlagen, arbeiten Sie [Unable to connect to API](#unable-to-connect-to-api) durch und überprüfen Sie die Proxy-Einrichtung in [Netzwerkkonfiguration](https://code.claude.com/docs/de/network-config.md)

### API returned an empty or malformed response

Claude Code zeigt diesen Fehler an, wenn sein Nicht-Streaming-Wiederholungsversuch einer fehlgeschlagenen Streaming-Anfrage einen HTTP-Erfolgsstatus erhält, aber der Text keine Claude-API-Nachricht ist: häufig eine HTML-Fehler- oder Anmeldungsseite, ein leerer Text oder JSON in einem anderen Format. Ein Proxy, Gateway oder eine Netzwerk-Anmeldungsseite, die an der Stelle der API antwortet, ist die übliche Quelle. Claude Code wiederholt die Anfrage nicht, und der Turn endet mit diesem Fehler.

```text theme={null}
API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.
```

Nach dieser Eröffnung meldet die Nachricht, was zurückkam und welche Anfrage fehlgeschlagen ist:

* Eine `Response:`-Klausel mit dem Inhaltstyp, der Art des Textes, wie z. B. `body is an HTML page` oder `empty body`, seiner Größe in Bytes und ob die Antwort eine Anthropic-Anfrage-ID trug. Wenn die Antwort einen erkennbaren Server benennt, wie z. B. `nginx` oder `cloudflare`, oder Zwischenkopfzeilen trägt, wie z. B. `cf-ray` oder `via`, listet die Klausel diese auch auf.
* Ein Satz, der die ID der fehlgeschlagenen Streaming-Anfrage und den Fehler benennt, der den Wiederholungsversuch ausgelöst hat. Wenn ein Stream geöffnet wurde, bevor der Fehler auftrat, meldet er auch, wie viele Stream-Ereignisse ankamen und, falls vorhanden, wie lange der Stream stumm war, als der Versuch fehlschlug.

Vor v2.1.234 endete die Nachricht nach `intercepting the request`.

Vor v2.1.271 beendete auch eine Antwort, die eine gültige API-Nachricht unter einem nicht-JSON-Inhaltstyp wie `text/plain` trug, den Turn mit diesem Fehler. Einige LLM-Gateways verwenden diesen Inhaltstyp für die Nicht-Streaming-Antwort.

**Was zu tun ist:**

* Lesen Sie die `Response:`-Klausel, um zu sehen, welches System geantwortet hat. Ein HTML-Text, keine Anthropic-Anfrage-ID oder ein benannter Server wie `nginx` oder `cloudflare` bedeutet, dass etwas zwischen Claude Code und der API an seiner Stelle geantwortet hat
* Wenn Sie über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway-connect.md#troubleshoot-gateway-errors) weiterleiten, testen Sie die Route mit einer direkten Anfrage und beheben Sie den Hop, der die Nicht-API-Antwort zurückgibt
* Führen Sie in einem Netzwerk mit einer Anmeldungsseite, wie z. B. Gast-Wi-Fi, die Anmeldung in einem Browser durch und versuchen Sie es erneut
* Wenn nur die Nicht-Streaming-Route durch Ihr Gateway fehlerhaft ist, setzen Sie [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](https://code.claude.com/docs/de/env-vars#variables), um diesen Fallback auszuschalten, außer wenn der Streaming-Endpunkt selbst `404` zurückgibt, wo Claude Code immer noch zurückfällt

### Streaming response ended before any complete data was received

Eine Streaming-Antwort von Ihrem Modell-Provider wurde abgeschlossen, ohne brauchbare Daten zu liefern, daher hat Claude Code die Anfrage ohne Streaming erneut gesendet, um den Turn zu beenden. Claude Code zeigt die Warnung einmal pro Sitzung, nur in interaktiven Sitzungen. Vor v2.1.239 wiederholte Claude Code stillschweigend ohne Streaming.

```text theme={null}
Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.
```

Claude Code sendet jede betroffene Anfrage zweimal: den leeren Streaming-Versuch und den Wiederholungsversuch. Die übliche Ursache ist ein Proxy oder Gateway, das den Streaming-Antwort-Text auf dem Rückweg verbraucht oder transformiert.

**Was zu tun ist:**

* Konfigurieren Sie jeden Proxy oder Gateway zwischen Claude Code und Ihrem Modell-Provider so, dass Streaming-Antwort-Texte und deren Header unverändert durchgeleitet werden
* Auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) siehe [Streaming-Fehler hinter einem Gateway oder Proxy](https://code.claude.com/docs/de/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy) für die Header- und Text-Anforderungen

### Bedrock streaming response has an unexpected content-type

Ein Gateway oder Proxy zwischen Claude Code und [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) transformiert den Streaming-Antwort-Text oder seinen `Content-Type`-Header. Amazon Bedrock streamt Antworten als `application/vnd.amazon.eventstream`. Anstatt einen Text zu dekodieren, den es nicht lesen kann, lehnt Claude Code eine erfolgreiche Streaming-Antwort ab, die einen anderen Inhaltstyp meldet. Claude Code wiederholt die Anfrage nicht.

```text theme={null}
Bedrock 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.
```

Vor v2.1.208 tauchte die gleiche Fehlkonfiguration als `API Error: Truncated event message received` auf, nachdem der gesamte Text gepuffert worden war.

**Was zu tun ist:**

* Konfigurieren Sie das Gateway so, dass der `InvokeModelWithResponseStream`-Antwort-Text und sein `Content-Type`-Header unverändert durchgeleitet werden. Ein Vermittler, der den Stream als Server-Sent-Events erneut aussendet, ist eine häufige Ursache.
* Das Setzen von [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](https://code.claude.com/docs/de/env-vars) verbirgt diesen Fehler, aber Claude Code dekodiert keinen binären Text unter einem umgeschriebenen Header, daher fallen diese Anfragen auf einen langsameren Nicht-Streaming-Pfad zurück. Siehe [Streaming-Fehler hinter einem Gateway oder Proxy](https://code.claude.com/docs/de/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy).

### SSL certificate errors

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

```text theme={null}
Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
```

Vor v2.1.273 endeten beide Meldungen bei `Check your proxy or corporate SSL certificates`, ohne den OpenSSL-Code oder den `NODE_EXTRA_CA_CERTS`-Hinweis.

Ab v2.1.199 wird ein Zertifikatvalidierungsfehler nicht wiederholt, daher wird dieser Fehler beim ersten Versuch angezeigt, anstatt nach dem vollständigen [Wiederholungsbudget](#automatic-retries). Frühere Versionen verbrachten einige Minuten mit Wiederholungsversuchen, bevor sie ihn zeigten. Vorübergehende TLS-Bedingungen, wie z. B. ein Handshake-Timeout, werden immer noch wiederholt.

Während `/login` und der Startup-Konnektivitätsprüfung wird der gleiche Fehler mit einer anderen Nachricht gemeldet:

```text theme={null}
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.
```

Auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) hängen die Anfragen, die Claude Code selbst an AWS sendet, wie z. B. die STS- und SSO-Rollen-Anmeldedaten-Aufrufe, Modellermittlung und die Überprüfungen des Setup-Assistenten, von der gleichen Zertifikatskonfiguration ab. Siehe [Zertifikatsfehler hinter einem TLS-inspizierenden Proxy](https://code.claude.com/docs/de/amazon-bedrock.md#certificate-errors-behind-a-tls-inspecting-proxy).

**Was zu tun ist:**

* Exportieren Sie das CA-Bundle Ihrer Organisation und verweisen Sie Claude Code mit `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem` darauf
* Siehe [Netzwerkkonfiguration](https://code.claude.com/docs/de/network-config.md#custom-ca-certificates) für vollständige Einrichtungsanweisungen
* Setzen Sie nicht `NODE_TLS_REJECT_UNAUTHORIZED=0`, was die Zertifikatvalidierung vollständig deaktiviert

### Host not allowed in a cloud session

In einer Cloud-Sitzung oder einer geplanten Cloud-Aufgabe kann ein `403` oder ein DNS-Fehler wie `ENOTFOUND` bedeuten, dass der angefragte Host nicht auf der [Allowlist der Cloud-Umgebung](https://code.claude.com/docs/de/cloud-environments.md#access-levels) steht. Gleichen Sie den Host zur Bestätigung mit dieser Liste ab. Ein `403` mit diesem Header bestätigt die Blockierung, aber nicht jeder `403` einer blockierten Anfrage enthält ihn:

```text theme={null}
HTTP 403
x-deny-reason: host_not_allowed
```

Sie können auch ein TLS-Zertifikat sehen, das nicht dem echten Zertifikat des Ziels entspricht. Cloud-Sitzungen leiten 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 [geplante Cloud-Aufgaben](https://code.claude.com/docs/de/routines.md) laufen in einer sandboxierten VM, deren ausgehender Datenverkehr durch das Netzwerk der Sitzung auf die Allowlist der [Cloud-Umgebung](https://code.claude.com/docs/de/cloud-environments.md) gefiltert wird:

* **GitHub- und Konnektor-Datenverkehr**: [GitHub-Operationen](https://code.claude.com/docs/de/cloud-environments.md#github-proxy) und MCP-Konnektor-Datenverkehr verwenden separate Kanäle, weshalb sie weiterhin funktionieren können, während andere Hosts blockiert sind
* **Standardumgebung**: Die **Standard**-Umgebung verwendet **Eingeschränkten** Zugriff mit aktivierter Option **Paketmanager zulassen**. Ihre Sitzungen erreichen die [Standard-Allowlist](https://code.claude.com/docs/de/cloud-environments.md#default-allowed-domains) von Paket-Registries, Cloud-Provider-APIs, Container-Registries und häufigen Entwicklungsdomänen.

**Was zu tun ist:**

Diese Schritte ändern eine Ihrer eigenen Umgebungen. Eine [organisationsweit gemeinsame Umgebung](https://code.claude.com/docs/de/cloud-environments.md#organization-shared-environments) wird im Selector schreibgeschützt geöffnet, daher bitten Sie einen Owner, ihren Netzwerkzugriff von der Seite **Cloud-Umgebungen** in den [Admin-Einstellungen](https://claude.ai/admin-settings) zu ändern.

* Öffnen Sie Ihre Umgebung zum Bearbeiten, entweder aus dem [Formular der geplanten Cloud-Aufgabe](https://code.claude.com/docs/de/routines.md#environments-and-network-access) oder aus dem [Umgebungs-Selector](https://code.claude.com/docs/de/cloud-environments.md#configure-your-environment), wo Sie Cloud-Sitzungen starten.
* Wählen Sie im Dialog **Cloud-Umgebung bearbeiten** unter **Netzwerkzugriff** die Option **Eingeschränkt** und fügen Sie dann die blockierte Domäne zu **Zulässige Domänen** hinzu. Geben Sie eine Domäne pro Zeile ein. Aktivieren Sie **Paketmanager zulassen**, um die [Standard-Allowlist](https://code.claude.com/docs/de/cloud-environments.md#default-allowed-domains) neben Ihren eigenen Domänen zuzulassen. 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 Allowlist. Für eine Cloud-Sitzung, die bereits offen ist, siehe [wann eine Netzwerkzugriffsänderung bestehende Sitzungen erreicht](https://code.claude.com/docs/de/cloud-environments.md#network-access).

Siehe [Netzwerkzugriff](https://code.claude.com/docs/de/cloud-environments.md#network-access) für Zugriffsstufen und die Standard-Allowlist. Lokale CLI-Sitzungen sind nicht von dieser Richtlinie betroffen.

### The proxy refused the connection

Sie sehen diese Nachricht, wenn Claude ein [Artefakt](https://code.claude.com/docs/de/artifacts.md) durch den Proxy liest, den Sie in `HTTPS_PROXY` oder einer verwandten [Proxy-Variable](https://code.claude.com/docs/de/network-config.md#environment-variables) setzen. Artefakt-Inhalte stammen von `*.frame.claudeusercontent.com`, daher sendet Claude Code zuerst dem Proxy eine `CONNECT`-Anfrage, um ihn zu bitten, einen Tunnel zu diesem Host zu öffnen. Wenn der Proxy sich weigert, erreicht nichts den Host, und die Nachricht trägt den HTTP-Status des Proxys:

```text theme={null}
artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)
```

Der Status ist die Antwort des Proxys auf die `CONNECT`. Der Host hat nie geantwortet, daher weist jeder Status auf eine andere Behebung hin:

* `HTTP 407`: Der Proxy benötigt Anmeldedaten, die er nicht erhalten hat. Geben Sie diese in die Proxy-URL ein, wie [Basic-Authentifizierung](https://code.claude.com/docs/de/network-config.md#basic-authentication) zeigt.
* `HTTP 403`: Der Proxy weigert sich, zu `*.frame.claudeusercontent.com` zu tunneln. Bitten Sie denjenigen, der den Proxy betreibt, diesen Host zuzulassen, den [Netzwerkzugriffsanforderungen](https://code.claude.com/docs/de/network-config.md#network-access-requirements) auflistet.
* Jeder andere Status, wie z. B. `HTTP 502`: Der Proxy hat den Tunnel aus eigenem Grund nicht geöffnet, wie z. B. Fehler beim Erreichen des Hosts. Schlagen Sie den Status in den Logs des Proxys nach.
* `unreadable reply` anstelle eines Status: Was sich unter der Proxy-Adresse befindet, hat nicht mit einer HTTP-Statuszeile geantwortet. Überprüfen Sie, dass die Adresse ein HTTP-Proxy ist.

**Was zu tun ist:**

* Überprüfen Sie die Adresse und Anmeldedaten in der Proxy-Variable, wie [Proxy-Konfiguration](https://code.claude.com/docs/de/network-config.md#proxy-configuration) beschreibt, und führen Sie dann `curl -x http://proxy.example.com:8080 -I https://api.anthropic.com` aus der Shell aus, in der Sie Claude Code starten, mit Ihrer eigenen Proxy-URL. Unter Windows PowerShell führen Sie `curl.exe` aus. Wenn diese Sonde auf die gleiche Weise fehlschlägt, beheben Sie zuerst die Proxy-Einrichtung. Wenn sie erfolgreich ist, ist die Weigerung spezifisch für den Artefakt-Host.
* Wenn Ihr Netzwerk Claude Code den direkten Zugriff auf den Artefakt-Host ermöglicht, fügen Sie `.frame.claudeusercontent.com` zu [`NO_PROXY`](https://code.claude.com/docs/de/network-config#environment-variables) hinzu. Halten Sie den Eintrag eng: Ein breiterer `.claudeusercontent.com`-Eintrag umgeht auch den Proxy für `bridge.claudeusercontent.com`, das Organisationen mit [IP-Allowlists](https://code.claude.com/docs/de/network-config.md#organization-ip-allowlists-and-proxy-egress) auf dem Proxy behalten müssen.

Vor v2.1.238 meldete Claude Code einen abgelehnten Tunnel als generischen Netzwerkfehler.

### The cloud environments service returned an empty or unexpected response

Claude Code fordert Ihre [Cloud-Umgebungen](https://code.claude.com/docs/de/cloud-environments.md)-Liste an mehreren Stellen an, z. B. wenn Sie eine Cloud-Sitzung aus der CLI erstellen oder [`/remote-env`](https://code.claude.com/docs/de/cloud-environments#select-an-environment-from-the-cli) ausführen. Wenn es die Antwort des Servers nicht lesen kann, zeigt es eine dieser Meldungen:

```text theme={null}
The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.
```

Der Server akzeptierte die Anfrage, antwortete aber mit einem Text, der nicht die Umgebungsliste ist: leer, nicht JSON oder JSON ohne die Liste. Dies begleitet normalerweise eine Störung auf der Serverseite und klärt sich von selbst. Je nachdem, welche Oberfläche die Liste anforderte, kann Claude Code ein Präfix hinzufügen, wie z. B. `couldn't list environments:` im `/remote-env`-Dialog.

**Was zu tun ist:**

* Wiederholen Sie die Aktion. Claude Code fordert die Liste jedes Mal erneut an
* Wenn die Nachricht weiterhin angezeigt wird, überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle

Vor v2.1.236 zeigte Claude Code stattdessen einen rohen JavaScript-TypeError.

### Failed to fetch session from Sessions API

Diese Meldung bedeutet, dass Claude Code die [Cloud-Sitzung, die Sie in Ihr Terminal holen wollten](https://code.claude.com/docs/de/claude-code-on-the-web.md#from-cloud-to-terminal), gefunden hat, ihren Konversationsverlauf aber nicht von den Servern von Anthropic lesen konnte und sie daher nicht geöffnet hat:

```text theme={null}
Failed to fetch session from Sessions API: Failed to fetch session logs
```

Sie sehen sie nach `claude --teleport`, `/teleport` oder der Auswahl der Sitzung in der [`/tasks`](https://code.claude.com/docs/de/commands)-Liste. `claude --teleport <session-id>` gibt sie aus und beendet sich mit Code 1.

**Was zu tun ist:**

* Führen Sie denselben Teleport erneut aus. Wenn er auf die gleiche Weise fehlschlägt, [melden Sie das Problem](#report-an-error)

Vor v2.1.296 versuchte Claude Code einen fehlgeschlagenen Lesevorgang nicht erneut, und danach konnte es die Sitzung mit einer leeren Konversation öffnen und einen Erfolg melden, anstatt diese Meldung auszugeben.

### Couldn't load the history of cloud session

Diese Meldung bedeutet, dass Claude Code die [Cloud-Sitzung, die Sie in Ihr Terminal holen wollten](https://code.claude.com/docs/de/claude-code-on-the-web.md#from-cloud-to-terminal), gefunden hat, die Anfrage nach ihrem Konversationsverlauf aber mit „nicht gefunden“ beantwortet wurde:

```text theme={null}
Couldn't load the history of cloud session session_01HJKLMNOPQRSTUVWXYZ. Check it at https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ?from=cli
```

**Was zu tun ist:**

* Öffnen Sie den Link in der Meldung, um die Sitzung in Ihrem Browser zu prüfen. Wenn sie sich dort öffnet und derselbe Teleport erneut auf diese Weise fehlschlägt, [melden Sie das Problem](#report-an-error).

### Couldn't reconnect to your Remote Control session

```text theme={null}
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](https://code.claude.com/docs/de/remote-control.md)-Sitzung wieder her, die in dieser Konversation aufgezeichnet wurde. Diese Nachricht bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der vorübergehend sein kann, wie z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist. Ihre lokale Sitzung läuft ohne Remote Control weiter.

**Was zu tun ist:**

* Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen
* Starten Sie eine neue Sitzung mit `claude --remote-control`, um eine neue Remote-Control-Sitzung zu erstellen
* Für andere Remote-Control-Startup-Meldungen siehe [Remote Control beheben](https://code.claude.com/docs/de/remote-control.md#troubleshooting)

Wenn der Server stattdessen meldet, dass die vorherige Sitzung weg ist, sehen Sie diese Nachricht nicht. Claude Code startet eine neue Sitzung an ihrer Stelle oder zeigt [`Previous session is unavailable — run /remote-control to start a new one`](https://code.claude.com/docs/de/remote-control#previous-session-is-unavailable).

### Sessions ended while this machine was offline

Claude Code zeigt diese Nachricht im Terminal, das [`claude remote-control`](https://code.claude.com/docs/de/remote-control#start-a-remote-control-session) ausführt, nachdem Ihr Computer lange genug offline war, dass der Server die Remote-Control-Umgebung bereinigt hat, die Ihr Computer bediente. Die Sitzungen in dieser Umgebung endeten, und Sie können sie nicht fortsetzen. Die Anzahl ist die Anzahl der Sitzungen, die endeten.

```text theme={null}
2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.
```

**Was zu tun ist:**

* Wenn Claude Code beibehaltene Worktrees unter dieser Nachricht auflistet, holen Sie sich alle nicht committeten Arbeiten von ihnen
* Führen Sie `claude remote-control` aus, um eine frische Umgebung zu starten

### Couldn't share the transcript

Nachdem Sie zugestimmt haben, Ihr Sitzungs-Transkript aus einer Umfrage-Abfrage zu teilen, wie z. B. der [Sitzungsqualitäts-Umfrage](https://code.claude.com/docs/de/data-usage.md#session-quality-surveys), lädt Claude Code es zu Anthropic hoch oder speichert stattdessen ein lokales Archiv bei Drittanbietern, bei [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzungen und wenn keine Anthropic-Anmeldedaten verfügbar sind. Diese Nachricht bedeutet, dass die Freigabe nicht abgeschlossen wurde.

```text theme={null}
Couldn't share the transcript.
```

Der Upload muss in ein 8-MiB-Limit passen. Bei einer langen Sitzung lässt Claude Code schrittweise Teile der Freigabe weg. Sie sehen diese Nachricht, wenn keine reduzierte Version gesendet werden kann oder ein Netzwerk- oder Serverfehler den Upload stoppt. Wenn Claude Code stattdessen ein lokales Archiv speichert, bedeutet die Nachricht, dass es das Archiv nicht schreiben konnte.

**Was zu tun ist:**

* Führen Sie `/feedback` aus, um das Transkript mit einer Beschreibung dessen zu senden, was passiert ist. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist
* Wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api)

### Couldn't send feedback

Eine Meldung, die mit `Couldn't send feedback` beginnt, bedeutet, dass der Feedback-Dienst den Bericht, den Sie aus dem [`/feedback`-, `/bug`- oder `/share`-Dialog](https://code.claude.com/docs/de/commands#all-commands) abgeschickt haben, oder einen [Feedback-Entwurf](https://code.claude.com/docs/de/tools-reference.md#sendfeedback-tool-behavior) in der Warteschlange nicht bestätigt hat. Behandeln Sie ihn als nicht empfangen. Wenn auf den Doppelpunkt ein Satz über Ihre Organisation folgt, lehnt Ihre Organisation Feedback ab.

Das zweite Beispiel ist die Ablehnung durch eine Organisation:

```text wrap theme={null}
Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

Couldn't send feedback: Feedback has not been enabled for your organization. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
```

**Was zu tun ist:**

* **Nicht angemeldet**: Die Meldung wird mit `: not signed in. Run /login, then retry.` fortgesetzt. Führen Sie `/login` aus und senden Sie dann erneut
* **Ablehnung durch Ihre Organisation**: zum Beispiel `: Feedback has not been enabled for your organization.` oder `: Feedback collection is not available for organizations with custom data retention policies.` `/feedback` kann danach sieben Tage lang antworten, dass es [durch die Richtlinie Ihrer Organisation deaktiviert ist](#feedback-is-disabled-by-your-organizations-policy). Ein Entwurf in der Warteschlange bleibt in der Warteschlange und [läuft trotzdem planmäßig ab](https://code.claude.com/docs/de/tools-reference.md#discard-or-keep-a-draft)
* **Abgelehnte Anmeldedaten**: Die Meldung wird mit `: the sign-in this session uses is not allowed to send feedback` oder `: the server did not accept the credentials this session uses` fortgesetzt. Führen Sie `/status` in der Claude-Code-Eingabe aus, um zu sehen, welche Anmeldung, welches Token oder welchen API-Schlüssel diese Sitzung sendet
* **`(request timed out)` oder `(couldn't reach the service)` direkt nach `Couldn't send feedback`**: Senden Sie den Bericht oder den Entwurf in der Warteschlange erneut. Der Dialog behält Ihren Text, und die Meldung eines Entwurfs in der Warteschlange lautet `The draft is still queued.` Wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api). Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein
* **`(server returned <status>)` oder kein Grund direkt nach `Couldn't send feedback`**: Der Status ist der Antwortcode des Dienstes. Die eigene Meldung des Dienstes folgt darauf, wenn eine gesendet wurde, wie in `(server returned 403: Access Forbidden)`. Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein

Issues unter github.com/anthropics/claude-code sind öffentlich. Lassen Sie daher Code, Transkripte und alles andere Vertrauliche weg, wenn Sie ein Issue eröffnen.

Vor v2.1.281 schlug jeder Versand mit dieser Nachricht fehl, sobald ein Remote Control **Stop** oder eine dringende sitzungsübergreifende Nachricht angekommen war, während der Dialog offen war. Schließen Sie auf diesen Versionen den Dialog, öffnen Sie ihn erneut und senden Sie erneut.

### Feedback payload too large

Diese Meldung im [Prüfbildschirm](https://code.claude.com/docs/de/tools-reference.md#review-and-edit-a-draft) für einen [Feedback-Entwurf](https://code.claude.com/docs/de/tools-reference.md#sendfeedback-tool-behavior) bedeutet, dass Claude Code keine Bestätigung hat, dass der Dienst den Entwurf angenommen hat. Behandeln Sie ihn als nicht empfangen. Der Entwurf bleibt in Ihrer `/feedback`-Warteschlange, sodass Sie ihn erneut senden können.

```text wrap theme={null}
Feedback payload too large. Try again without the transcript, or shorten the details.
```

**Was zu tun ist:**

* Setzen Sie im Prüfbildschirm **Send transcript** auf `no` und senden Sie den Entwurf dann erneut. Durch Kürzen der Details werden höchstens 10 KB Text entfernt, denn mehr können die Details eines Entwurfs nicht enthalten.

### MCP server connection timed out during a sleep or clock change

Diese Meldung bedeutet, dass bei einer Verbindung zu einem [MCP-Server](https://code.claude.com/docs/de/mcp.md) eine Zeitüberschreitung aufgetreten ist und Claude Code festgestellt hat, dass Ihre Systemuhr während des Versuchs vorgesprungen ist:

```text theme={null}
MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.
```

Claude Code kann nicht unterscheiden, ob Ihr Computer im Ruhezustand war oder seine Uhr vorgestellt wurde, daher nennt die Meldung beides.

**Was zu tun ist:**

Verbinden Sie sich erneut mit dem Server und halten Sie Ihren Computer wach, bis der Versuch abgeschlossen ist. Wenn der Server sich verbindet, müssen Sie nichts beheben.

* **In einer interaktiven Sitzung**: Führen Sie `/mcp` aus, wählen Sie den Server aus und wählen Sie **Reconnect**
* **In Ihrer Shell**: Führen Sie den Befehl [`claude -p`](https://code.claude.com/docs/de/headless), [`claude mcp list`](https://code.claude.com/docs/de/mcp#managing-your-servers) oder `claude mcp get` erneut aus. Wenn der Server dann mit einer Meldung fehlschlägt, die mit `Skipping connection (recent failure cached` beginnt, warten Sie 15 Minuten und führen Sie den Befehl erneut aus.
* **In einer [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Anwendung**: Rufen Sie [`reconnectMcpServer()`](https://code.claude.com/docs/de/agent-sdk/typescript#methods) in TypeScript oder [`ClaudeSDKClient.reconnect_mcp_server()`](https://code.claude.com/docs/de/agent-sdk/python#methods) in Python auf
* **Wenn der Server erneut fehlschlägt**: Wenn sich die Meldung von dieser unterscheidet, siehe [was zu prüfen ist, wenn ein MCP-Server keine Verbindung herstellt](https://code.claude.com/docs/de/mcp-quickstart.md#troubleshooting). Wenn diese Meldung zurückkehrt, obwohl Ihr Computer wach blieb und nichts seine Uhr geändert hat, siehe [Fehler melden](#report-an-error).

Vor v2.1.307 zeigte Claude Code stattdessen eine Timeout-Meldung wie `MCP server "<name>" connection timed out after <N>ms` an.

## 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.

### Prompt ist zu lang

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

```text theme={null}
Prompt is too long
```

In einer interaktiven Sitzung zeigt Claude Code diesen Fehler als:

```text theme={null}
Context limit reached · /compact or /clear to continue
```

Die Zeile nennt nur `/clear`, wenn [`DISABLE_COMPACT`](https://code.claude.com/docs/de/env-vars) gesetzt ist. Längere Formen des Fehlers, wie die unten aufgeführte Form für eine fehlgeschlagene Komprimierung, behalten die Formulierung `Prompt is too long ·` bei. In der `-p`-Ausgabe und im Transkript bleibt der Text `Prompt is too long`.

Wenn Sie die automatische Komprimierung in Ihren [Benutzereinstellungen](https://code.claude.com/docs/de/settings-reference.md#autocompactenabled) ausgeschaltet haben, weist die Zeile auch darauf hin:

```text theme={null}
Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
```

Der Schalter **Auto-compact** in `/config` schreibt `autoCompactEnabled` in die Benutzereinstellungen. Der Hinweis wird nur angezeigt, wenn eine `/config`-Änderung wirksam würde. Beispielsweise wird er nicht angezeigt, wenn [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/de/env-vars) oder [`DISABLE_COMPACT`](https://code.claude.com/docs/de/env-vars) die automatische Komprimierung ausgeschaltet haben. Er wird auch nicht angezeigt, wenn ein höherrangiger Geltungsbereich, wie Projekt- oder verwaltete Einstellungen, `autoCompactEnabled` auf `false` gesetzt hat. Vor v2.1.235 enthielt die Zeile keinen Hinweis zur automatischen Komprimierung.

Amazon Bedrock meldet diese Bedingung als `Input is too long for requested model.`, was Claude Code auf die gleiche Weise behandelt. Vor v2.1.217 erkannte Claude Code die Bedrock-Formulierung nicht, daher wurde die automatische Komprimierung nie ausgelöst und `/compact` schlug mit demselben Fehler fehl.

Ein [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway-config.md#upstream-error-messages) meldet diese Bedingung als `capability_rejected: prompt_too_long`, wenn ein Cloud-Upstream die Anfrage in der eigenen Fehlerform des Anbieters ablehnt. Claude Code behandelt das Token gleich wie `Prompt is too long`. Vor v2.1.228 erkannte Claude Code das Token nicht, daher wurde die automatische Komprimierung nicht ausgelöst.

Wenn die automatische Komprimierung in diesem Turn ausgeführt wurde und an einem zugrunde liegenden Fehler gescheitert ist, wie z. B. einem nicht verfügbaren Modell oder einem Authentifizierungsfehler, benennt die Nachricht diesen Fehler nach einem Trennzeichen:

```text theme={null}
Prompt is too long · automatic compaction failed: <the underlying error>
```

Beheben Sie zunächst den benannten Fehler; `/compact` schlägt mit demselben Fehler fehl, bis Sie dies tun. Vor v2.1.229 zeigte eine fehlgeschlagene automatische Komprimierung `Prompt is too long` ohne die Ursache an.

Wenn die automatische Komprimierung bei diesem Fehler ausgeführt wird, fasst sie normalerweise Ihre ältesten Austausche zusammen und behält die neuesten. Als letzter Ausweg fasst Claude Code anders zusammen:

* Wenn es keinen ganzen Austausch zusammenfassen kann, behält Claude Code Ihren neuesten Prompt wörtlich und fasst alles davor zusammen.
* In diesem Fall fasst Claude Code stattdessen die gesamte Konversation zusammen, wenn die Konversation nicht mit Ihrem Prompt endet.

Claude Code überspringt diese Wiederherstellung, wenn der Inhalt, den es weitergeben würde, keine Modellantwort und weniger als etwa 1.000 Token Ihres eigenen Textes enthält, wie z. B. einen kurzen erneuten Versuch nach einem übergroßen Einfügen. Führen Sie `/clear` aus, um neu zu beginnen. Vor v2.1.269 schlug die Komprimierung immer fehl, wenn sie keinen ganzen Austausch zusammenfassen konnte, daher trat dieser Fehler bei einer Sitzung in diesem Zustand bei jedem Turn erneut auf.

Eine Konversation mit einem einzelnen Austausch hat keine früheren Turns zum Zusammenfassen. Wenn die automatische Komprimierung bei einer solchen ausgeführt würde, überspringt Claude Code den Versuch und erklärt stattdessen, was die Anfrage füllt. Wenn die API keine Token-Zählungen in ihrem Fehler meldet, lautet die Nachricht:

```text theme={null}
Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.
```

Wenn die API Token-Zählungen in ihrem Fehler meldet, vergleicht Claude Code diese mit seiner eigenen Schätzung der Konversationsgröße, um zu bestimmen, was den größten Teil der Anfrage ausmacht: der Inhalt der Konversation selbst oder der System-Prompt, die Tool-Definitionen und der Anhangsinhalt, den Claude Code damit sendet. Wenn der Inhalt der Konversation selbst den größten Teil der Anfrage ausmacht, lautet die Nachricht:

```text theme={null}
Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).
```

Wenn der größte Teil der Anfrage außerhalb der Konversation liegt, lautet die Nachricht:

```text theme={null}
Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.
```

Vor v2.1.162 versuchte Claude Code die Komprimierung trotzdem und zeigte das bloße `Prompt is too long` an, wenn sie fehlschlug.

**Was zu tun ist:**

* Führen Sie `/compact` aus, um frühere Turns zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen. Wenn `/compact` mit `Not enough messages to compact.` antwortet, ist die Konversation ein einzelner Austausch ohne frühere Inhalte zum Zusammenfassen, daher wird der Platz von diesem einen Prompt und dem, was Claude Code mit jeder Anfrage sendet, beansprucht: Führen Sie `/clear` aus und senden Sie erneut mit weniger eingefügtem Text oder kleineren Anhängen, oder reduzieren Sie die Tool-Definitionen und Memory-Dateien mit den folgenden Schritten
* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: System-Prompt, Tools, Memory-Dateien und Nachrichten
* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Tool-Definitionen aus dem Kontext zu entfernen
* Kürzen Sie große `CLAUDE.md`-Memory-Dateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](https://code.claude.com/docs/de/memory.md#path-specific-rules), die nur bei Bedarf geladen werden
* Die automatische Komprimierung ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie sie in `/config` oder mit [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/de/env-vars) ausgeschaltet haben, schalten Sie sie wieder ein. Wenn Sie sie ausgeschaltet lassen, führen Sie `/compact` selbst aus, bevor das Fenster voll wird.
* Wenn Claude Code gewarnt hat, dass es Ihre Modell-ID nicht erkennt, kann die Warnung das angenommene Fenster nennen. Wenn das tatsächliche Fenster des Modells davon abweicht, [teilen Sie Claude Code das tatsächliche Fenster mit](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id).
  * Wenn Sie eine benutzerdefinierte [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) verwenden und der Fehler mit `Prompt is too long · automatic compaction failed` beginnt, [legen Sie das Kontextfenster des Modells fest](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) oder [aktualisieren Sie](https://code.claude.com/docs/de/setup.md#update-claude-code) auf v2.1.299 oder höher. Vor v2.1.299 beendete Claude Code den Turn mit dieser Meldung in der Nähe des angenommenen 200K-Fensters, statt die Anfrage zu senden.
* Wenn der Fehler direkt auftrat, nachdem Sie Claude während der Komprimierung der Konversation gestoppt haben, ist Ihre Konversation unverändert und immer noch groß genug, um eine Komprimierung zu erfordern. Führen Sie `/compact` aus und senden Sie Ihre Nachricht erneut. Damit der Fehler nicht erneut auftritt, [aktualisieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#update-claude-code) auf v2.1.304 oder neuer. Vor v2.1.304 konnte ein Stopp in diesem Moment den Turn mit diesem Fehler beenden.
* In v2.1.305 kann dieser Fehler bei vielen MCP-Tools und einer direkten Verbindung zur Anthropic API einen nicht damit zusammenhängenden 400- oder 422-Fehler der API verdecken. [Aktualisieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#update-claude-code) auf v2.1.306 oder neuer, um den ursprünglichen Fehler zu sehen.

Siehe [Erkunden Sie das Kontextfenster](https://code.claude.com/docs/de/context-window.md) für eine interaktive Ansicht, wie sich der Kontext füllt.

### Kontext überschreitet das Token-Limit

`/context` zeigt diese Warnung oben in seiner Ausgabe an, wenn die Konversation über das Kontextfenster des Modells hinausgewachsen ist:

```text theme={null}
Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
```

Nach einer `Context exceeds`-Warnung müssen Sie keinen der beiden Befehle ausführen, solange die [automatische Komprimierung](https://code.claude.com/docs/de/settings-reference.md#autocompactenabled) eingeschaltet ist, was der Standard ist:

* **Automatische Komprimierung eingeschaltet**: Senden Sie Ihre nächste Nachricht. Wenn sie weiterhin mit [`Prompt is too long`](#prompt-is-too-long) fehlschlägt, lesen Sie diesen Eintrag.
* **Automatische Komprimierung ausgeschaltet**: Führen Sie in der Sitzung `/compact` aus, wenn die Warnung diesen Befehl nennt, oder `/clear`, um neu zu beginnen. Bis Sie einen davon ausführen, schlagen Nachrichten mit `Context limit reached` fehl, bzw. mit `Prompt is too long` in der `-p`-Ausgabe.

Wenn das Limit, das Sie überschritten haben, ein Komprimierungsfenster ist, wie z. B. die 200K-Grenze bei Modellen mit 1M-Kontext, lautet die Warnung anders. Ein Komprimierungsfenster kann unter dem Kontextfenster des Modells liegen, daher können Anfragen darüber hinaus immer noch erfolgreich sein.

```text theme={null}
Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.
```

Beide Formen nennen `/clear` statt `/compact`, wenn Sie [`DISABLE_COMPACT`](https://code.claude.com/docs/de/env-vars) gesetzt haben.

**Was zu tun ist:**

* **Nach einer Warnung zum Komprimierungsfenster**: Führen Sie in einer Konversation mit mehreren Turns `/compact` aus, um frühere Turns zusammenzufassen und Platz zu schaffen. Um stattdessen neu zu beginnen, führen Sie `/clear` aus.
* Weitere Möglichkeiten zur Reduzierung der Nutzung finden Sie unter [Prompt ist zu lang](#prompt-is-too-long)

Vor v2.1.216 zeigte `/context` eine Nutzung über 100 % ohne Warnzeile an, die erklärte, was das bedeutet oder wie man den Zustand behebt.

### Anfrage zu groß

Der rohe Anfragekörper überschritt das 32-MB-Limit der API vor der Tokenisierung, normalerweise wegen großer eingefügter Inhalte, Tool-Ergebnisse oder Anhänge. Dieses Limit ist unabhängig vom [Kontextfenster](#prompt-is-too-long).

```text theme={null}
Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.
```

Wenn die Anfrage direkt an die Claude API ging und die API selbst sie ablehnte, misst Claude Code die Konversation und formuliert die Nachricht danach, ob eine Wiederherstellung funktionieren kann. Über einen Proxy, ein Gateway oder einen Cloud-Anbieter erhalten Sie die allgemeine Nachricht. Die gemessenen Formen:

* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: Bilder oder Dokumente haben die Anfrage über das Limit gebracht. Claude Code versucht es ohne sie erneut.
* `Request too large for the API's 32MB request limit`: Die Nachrichten allein liegen über dem Limit, daher sagt die Nachricht `compacting cannot make it fit` und Claude Code versucht es nicht erneut. Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) fordert die Nachricht Sie stattdessen auf, die Eingabe zu reduzieren oder eine neue Sitzung zu starten.

Vor v2.1.212 schlugen Konversationen mit genügend angesammelten Bildern bei jedem Turn mit `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` fehl. Vor v2.1.229 zeigte Claude Code den Hinweis zu Anhängen bei jeder Ablehnung an, auch wenn die Komprimierung nicht helfen konnte.

**Was zu tun ist:**

* Wenn die Nachricht `compacting cannot make it fit` enthält, drücken Sie zweimal Esc, um hinter den Turn zurückzugehen, der den großen Inhalt hinzugefügt hat, oder führen Sie `/clear` aus, um neu zu beginnen
* Führen Sie andernfalls `/compact` aus, was angesammelte Bilder und Anhänge entfernt
* Referenzieren Sie große Dateien über ihren Pfad, anstatt ihren Inhalt einzufügen, damit Claude sie in Abschnitten lesen kann
* Für Bilder siehe [Bild war zu groß](#image-was-too-large) unten

### Bild war zu groß

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

```text theme={null}
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
API Error: an image in the conversation could not be processed and was removed.
An image in the conversation exceeds the dimension limit for many-image requests (3000px). Run /compact to remove old images from context, or start a new session.
```

Die Zeile `could not be processed and was removed` bedeutet, dass die API ein Bild in der Konversation abgelehnt hat, etwa eines, das die Größen- oder Abmessungslimits überschreitet.

Wenn einer dieser Fehler immer wieder auftritt, aktualisieren Sie Claude Code. In älteren Versionen konnte sich ein Bildfehler aus Gründen wie diesen wiederholen:

* Vor v2.1.299 konnte Claude Code in einer langen Konversation mit vielen Bildern die zuletzt angehängten Bilder entfernen statt des Bildes, das das Limit überschritt. Die Zeile `was removed` wiederholte sich dann bei jedem Turn, und Claude sah Ihre neuen Bilder nicht.
* Vor v2.1.299 wurden in VS Code, in der Desktop-App und im Agent SDK Bilder, die Sie angehängt haben, während Claude arbeitete, nicht wie andere angehängte Bilder verkleinert. Sie erreichten die API in ihrer Originalgröße, was in langen Konversationen zu wiederholten Bildfehlern führte.
* Vor v2.1.166 konnte ein eingefügtes Bild in der Konversation verbleiben, und derselbe Fehler wiederholte sich dann bei jeder folgenden Nachricht

**Was zu tun ist:**

* Ändern Sie die Größe des Bildes vor dem Einfügen. Die API akzeptiert Bilder bis zu 8000 Pixeln an der längsten Kante für ein einzelnes Bild oder 3000 Pixel, wenn mehr als 20 Bilder im Kontext sind.
* Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms
* Bei der Meldung `dimension limit for many-image requests` führen Sie `/compact` im Claude-Code-Prompt aus, wenn die Meldung es nennt, oder starten Sie eine neue Sitzung mit weniger Bildern

Die Meldung `dimension limit for many-image requests` zeigt das Pixellimit an, das im Fehler der API genannt wird.

### Bildgröße konnte nicht geändert werden

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

```text theme={null}
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.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.
```

Claude Code ändert die Größe großer Bilder normalerweise automatisch. Diese Fehler bedeuten, dass das Bild nicht dekodiert oder nicht so angepasst werden konnte, dass es in die API-Limits passt.

Der angezeigte Fehler kann ein anderes Pixellimit nennen, etwa `2576x2576px`, wo diese Beispiele `2000x2000px` angeben.

**Was zu tun ist:**

* Wenn die Nachricht Sie auffordert, das Bild zu konvertieren, konvertieren Sie es in PNG, JPEG, GIF oder WebP und hängen Sie es erneut an. Claude Code kann die Dimensionen für diese Formate aus dem Datei-Header überprüfen, ohne das Bild zu dekodieren.
* Wenn die Nachricht ein Dimensions- oder Größenlimit meldet, ändern Sie die Größe oder komprimieren Sie das Bild unter dieses Limit, bevor Sie es anhängen.
* Wenn die Nachricht eine Ursache benennt, wie z. B. ein CMYK-JPEG, ein animiertes WebP oder eine möglicherweise beschädigte Datei, speichern Sie das Bild in dem Format, das die Nachricht vorschlägt, erneut und hängen Sie es erneut an.

### Request rejected as unprocessable by the model

Die API hat die Anfrage als eine abgelehnt, die das Modell nicht verarbeiten kann. Die Meldung stammt von der API selbst.

```text theme={null}
API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)
```

Claude Code kann die ältesten Bilder und Dokumente aus einer abgelehnten Anfrage entfernen und sie erneut senden. Vor v2.1.290 entfernte Claude Code bei dieser Ablehnung keine Bilder, sodass eine lange Sitzung, in der sich Hunderte davon angesammelt hatten, bei jedem Turn mit diesem Fehler fehlschlagen konnte.

**Was Sie tun können:**

* Wenn die Meldung in einer Konversation mit Bildern oder Dokumenten immer wieder erscheint, entfernen Sie diese selbst. Drücken Sie zweimal Esc, um hinter die Turns zurückzugehen, die sie hinzugefügt haben, oder führen Sie `/clear` aus, um neu zu beginnen.

### PDF-Fehler

Das PDF, das Sie angehängt haben, konnte nicht verarbeitet werden. Die Nachrichten werden hier in ihrer nicht interaktiven Form angezeigt; in einer interaktiven Sitzung fordern sie Sie stattdessen auf, zweimal Esc zu drücken und es erneut zu versuchen.

```text theme={null}
PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).
```

**Was zu tun ist:**

* Bitten Sie Claude bei übergroßen PDFs, einen Seitenbereich mit dem Read-Tool zu lesen, anstatt die ganze Datei anzuhängen, oder extrahieren Sie Text mit einem Tool wie `pdftotext` und referenzieren Sie die Ausgabedatei über ihren Pfad
* Entfernen Sie bei geschützten oder ungültigen PDFs das Passwort oder exportieren Sie die Datei erneut aus ihrer Quellanwendung und versuchen Sie es dann erneut

Wenn Claude einen Seitenbereich aus einem PDF mit dem Read-Tool liest, kann das Lesen mit einer anderen Nachricht fehlschlagen:

```text theme={null}
pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.
```

Lesevorgänge für Seitenbereiche rendern Seiten mit `pdftoppm`. Installieren Sie poppler-utils mit dem Befehl, den die Nachricht angibt, oder auf anderen Plattformen einen poppler-Build, der `pdftoppm` in Ihren `PATH` legt. Unter [Verhalten des Read-Tools](https://code.claude.com/docs/de/tools-reference.md#read-tool-behavior) erfahren Sie, welche PDFs nach Seitenbereich gelesen werden.

### Zusätzliche Eingaben sind nicht zulässig

Der Endpunkt, der die Anfrage empfangen hat, hat eines der Felder der Anfrage als Eingabe abgelehnt, die er nicht akzeptiert, und seine Meldung nennt dieses Feld.

```text theme={null}
API Error: 400 ... context_management: Extra inputs are not permitted
```

Claude Code sendet reine Beta-Felder wie `context_management` und `defer_loading` der Tool-Suche zusammen mit einem `anthropic-beta`-Header, der sie aktiviert. Wenn ein Gateway den Body weiterleitet, aber den Header verwirft, sieht die API Felder, die sie nicht erkennt. Wenn ein Gateway einen Body im Anthropic-Format an einen Upstream mit anderem Schema weiterleitet, lehnt dieser Upstream solche Felder ab. [Paare aus Beta-Header und Body-Feld](https://code.claude.com/docs/de/llm-gateway-protocol.md#beta-header-and-body-field-pairs) behandelt beide Fälle.

**Was zu tun ist:**

* Wenn die Meldung `context_management: Extra inputs are not permitted` enthält, [aktualisieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#update-claude-code) auf v2.1.304 oder neuer. Nach dem Update reagiert Claude Code auf diese Ablehnung, indem es die Anfrage einmal ohne das Feld erneut sendet. Vor v2.1.304 versuchte Claude Code diese Ablehnung nicht erneut.
* Wenn die Meldung `defer_loading` oder `tool_reference` nennt, [aktualisieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#update-claude-code) auf v2.1.305 oder neuer. Claude Code reagiert dann auf diese Ablehnung, indem es [die Anfrage noch einmal](https://code.claude.com/docs/de/llm-gateway-protocol.md#retry-without-tool-search) ohne Felder der Tool-Suche sendet.
* Wenn Ihr Gateway den Header verwirft, konfigurieren Sie es so, dass es den `anthropic-beta`-Header weiterleitet. Unter [Feature-Durchleitung](https://code.claude.com/docs/de/llm-gateway-protocol.md#feature-pass-through) erfahren Sie, was Gateways weiterleiten müssen.
* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](https://code.claude.com/docs/de/env-vars) vor dem Start. [Pre-Release-Funktionen deaktivieren](https://code.claude.com/docs/de/llm-gateway-protocol.md#disable-pre-release-capabilities) beschreibt den genauen Umfang.

Vor v2.1.302 konnte dieser Fehler auch das Feld `diagnostics` nennen, ohne dass ein Gateway beteiligt war. Er trat auf, wenn eine Sitzung, die bereits die Anthropic API verwendet hatte, ohne Neustart zu Amazon Bedrock oder zur Agent Platform von Google Cloud wechselte. Beispielsweise wechselt eine offen gelassene Sitzung zu Bedrock, wenn Sie in einem anderen Claude-Code-Fenster [`/setup-bedrock`](https://code.claude.com/docs/de/commands) ausführen. Führen Sie in diesen Versionen in der betreffenden Sitzung `/clear` aus oder starten Sie sie neu.

### Tool-Eingabeschema ist ungültig

Ein Tool in der Anfrage deklarierte ein `input_schema`, das die JSON-Schema-Validierung der API nicht besteht, daher lehnte die API die ganze Anfrage ab. Die Nummer nach `tools.` ist die Position des fehlerhaften Tools in der Tool-Liste der Anfrage, nicht ein Name, den Sie nachschlagen können.

```text theme={null}
API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'
```

Die erste Form bedeutet, dass das Schema kein gültiges JSON Schema Draft 2020-12 ist. Die zweite bedeutet, dass der Name einer Top-Level-Eigenschaft nicht dem Muster entspricht, das die Nachricht angibt.

Claude Code [schließt MCP-Tools aus, deren Eingabeschema diese Validierung nicht bestehen würde](https://code.claude.com/docs/de/mcp.md#tools-with-invalid-input-schemas), wenn es die Tools eines Servers lädt, daher enthalten Anfragen normalerweise nie ein solches Tool.

Bei einer [Bereitstellung, bei der das Abrufen von Flags ausgeschaltet ist](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching), oder auf einem Computer, dessen Flags nie angekommen sind, vermerkt Claude Code im Log des Servers, welches Tool abgelehnt würde, sendet es aber trotzdem, daher kann dieser Fehler immer noch auftreten.

Der Fehler kann auch bei einem Tool auftreten, dessen Schema in `$schema` einen anderen JSON-Schema-Dialekt als Draft 2020-12 deklariert. Claude Code prüft diese Schemas nicht gegen das JSON-Schema-Metaschema, die Prüfung der Top-Level-Eigenschaftsnamen gilt jedoch weiterhin.

Vor v2.1.216 führte keine Bereitstellung die Ausschlussprüfungen durch.

**Was zu tun ist:**

* Wenn Ihre Claude-Code-Version älter als v2.1.300 ist, führen Sie [`claude update`](https://code.claude.com/docs/de/setup#update-claude-code) in Ihrer Shell aus. Vor v2.1.300 hat Claude Code [die Anfrage nicht ohne die Parameter des abgelehnten Tools erneut versucht](https://code.claude.com/docs/de/mcp.md#tools-whose-input-schema-the-api-refuses), sodass sich dieser Fehler bei jeder Anfrage wiederholte, die das Tool enthielt.
* Entfernen oder [deaktivieren](https://code.claude.com/docs/de/mcp.md#disable-a-server-without-removing-it) Sie den MCP-Server, der das ungültige Schema deklariert. Der Fehler benennt das Tool nur über seine Position. Prüfen Sie ab v2.1.216 das Log jedes Servers auf eine Zeile, die ein Tool benennt, dessen Eingabeschema abgelehnt würde. Wenn kein Log eines benennt, deaktivieren Sie die Server nacheinander.
* Wenn Sie den Server pflegen, korrigieren Sie das `input_schema` des Tools. Das Schema muss gültiges JSON Schema sein, und Top-Level-Eigenschaftsnamen müssen 1 bis 64 Zeichen lang sein und dürfen nur ASCII-Buchstaben und Ziffern, `_`, `.` und `-` verwenden. Siehe [Tools mit ungültigen Eingabeschemas](https://code.claude.com/docs/de/mcp.md#tools-with-invalid-input-schemas).

### MCP-Tool-Name über 128 Zeichen

Ein MCP-Server listet ein Tool auf, dessen vollständiger Name, wie z. B. `mcp__<server>__<tool>`, länger ist als die 128 Zeichen, die die API akzeptiert. Claude Code [lässt dieses Tool bei den Tools weg, die es an Claude sendet](https://code.claude.com/docs/de/mcp.md#tools-with-names-longer-than-128-characters), und die anderen Tools des Servers funktionieren weiterhin. In einer Sitzung, die Sie mit `claude --debug` aus Ihrer Shell starten, schreibt Claude Code diese Nachricht in das Debug-Log unter `~/.claude/debug/<session-id>.txt`:

```text theme={null}
Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128
```

**Was zu tun ist:**

* Wenn Sie den Server pflegen, kürzen Sie den Namen des Tools.
* Wenn der Server in Ihrer [MCP-Konfiguration](https://code.claude.com/docs/de/mcp.md#mcp-installation-scopes) steht, geben Sie ihm dort einen kürzeren Namen, wie z. B. `db` anstelle von `analytics-database`. Aktualisieren Sie dann alles, was sich über den alten Namen auf den Server oder seine Tools bezieht, wie z. B. [Berechtigungsregeln](https://code.claude.com/docs/de/permissions.md#mcp) und [Hook-Matcher](https://code.claude.com/docs/de/hooks.md#match-mcp-tools).
* Wenn ein [Plugin den Server mitliefert](https://code.claude.com/docs/de/mcp.md#plugin-provided-mcp-servers), enthält der vollständige Name des Tools auch den Plugin-Namen. Bitten Sie den Maintainer des Plugins, den Server- oder Tool-Namen zu kürzen.

Vor v2.1.292 sendete Claude Code das Tool trotzdem, und die API lehnte jede Anfrage, die es enthielt, mit `API Error: 400 ... tools.N.custom.name: String should have at most 128 characters` ab.

### tool\_use.name über 200 Zeichen

Ein Tool-Aufruf im Konversationsverlauf trägt einen Namen, der länger ist als die 200 Zeichen, die die API in einer Anfrage akzeptiert:

```text theme={null}
API Error: 400 ... tool_use.name: String should have at most 200 characters
```

Claude Code kürzt einen solchen Namen auf 200 Zeichen, wenn die Antwort eintrifft und wenn es eine gespeicherte Konversation lädt, daher schlägt der Aufruf mit einem [`No such tool available`](#no-such-tool-available)-Tool-Fehler fehl und die Konversation wird ohne diesen API-Fehler fortgesetzt.

**Was zu tun ist:**

* Führen Sie `claude update` aus und setzen Sie dann die Konversation fort. Die aktualisierte Version repariert den überlangen Namen, wenn sie das Transkript lädt, daher funktioniert eine Konversation, die festgesteckt hat, wieder.

Vor v2.1.281 blieb der überlange Name im Verlauf, und die API lehnte jede Anfrage ab, die die Konversation erneut sendete, einschließlich `/compact` und `--resume`, daher wiederholte sich dieser Fehler und die Konversation steckte fest.

### 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 abschließende Hinweis, der hier in seiner interaktiven Form angezeigt wird, je nach Oberfläche.

```text theme={null}
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 den 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 gültigen ID, oder setzen Sie [`ANTHROPIC_MODEL`](https://code.claude.com/docs/de/env-vars). Der Fehlertext zeigt auf dieser Oberfläche `Run --model`.
* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` in `Options`](https://code.claude.com/docs/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](https://code.claude.com/docs/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungsversuch oder Ihre eigene Modellauswahl anzuzeigen.
* Verwenden Sie einen Alias wie `sonnet` oder `opus` statt einer vollständigen versionierten ID. Aliase werden zu einem gepflegten Standard aufgelöst, daher veralten sie nicht. Siehe [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md).
* Wenn in der CLI immer wieder das falsche Modell auftaucht, ist irgendwo eine veraltete ID gesetzt. Überprüfen Sie die Orte, an denen Sie ein Modell setzen können, in [Prioritätsreihenfolge](https://code.claude.com/docs/de/model-config.md#setting-your-model) und entfernen Sie den veralteten Wert.
* Vor v2.1.206 ließ eine abgelaufene claude.ai-Anmeldung, die nicht mehr aktualisiert werden konnte, jedes Modell mit diesem Fehler fehlschlagen. Führen Sie in diesen Versionen `/login` aus.
* Wenn [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) auf ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) zeigt und jedes Modell auf diese Weise fehlschlägt, prüfen Sie, ob Ihr Gateway und sein Upstream Felder der [Tool-Suche](https://code.claude.com/docs/de/mcp.md#tool-search-through-a-gateway) akzeptieren. Standardmäßig sendet Claude Code `defer_loading`-Tool-Felder und `tool_reference`-Blöcke zusammen mit dem `anthropic-beta`-Header, der sie aktiviert. Vor v2.1.304 war die Tool-Suche hinter einem Gateway ausgeschaltet, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` eingeschaltet hatten.
* Für Bereitstellungen auf Google Cloud's Agent Platform siehe [Fehlerbehebung für Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md#troubleshooting).

### Modell ist keine erkannte Modell-ID

Die Zeichenkette, die Sie an einen Modellwechsel übergeben haben, kann Claude Code nicht als Modell verwenden, daher lehnte es den Wechsel ab, ohne eine Anfrage zu senden, und die Sitzung behält ihr aktuelles Modell. Sie können diesen Fehler erhalten, wenn ein Modell über die `setModel()`-Methode des [Agent SDK](https://code.claude.com/docs/de/agent-sdk/typescript.md) gesetzt wird, durch eine App, die die Claude Code CLI für Sie ausführt, wie die [Desktop-App](https://code.claude.com/docs/de/desktop.md), oder wenn Sie ein Modell auf einem Gerät auswählen, das über [Remote Control](https://code.claude.com/docs/de/remote-control.md) verbunden ist. Vor v2.1.200 speicherte Claude Code die Zeichenkette und schlug bei der nächsten Anfrage mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) fehl.

```text theme={null}
Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
```

In diesem Beispiel hat eine App den Anzeigenamen `Sonnet 5` gesendet, den die Nachricht ohne das Leerzeichen wiederholt. Der abschließende Hinweis benennt den am besten passenden Alias oder die am besten passende Modell-ID. Wenn nichts nah genug ist, lautet er stattdessen `Run /model to see available models.` In einer Sitzung, die die [Desktop-App](https://code.claude.com/docs/de/desktop.md) für Sie startet, lautet der Hinweis ohne Treffer `Switch to a different model.`

Wenn Sie über das Agent SDK oder eine App auf der Anthropic API wechseln, erhält nur eine Zeichenkette diesen Fehler, die keine Modell-ID sein kann, wie z. B. ein Anzeigename oder eine leere Zeichenkette.

Wenn Sie ein Modell auf einem Remote-Control-Gerät auswählen, prüft Claude Code die Zeichenkette lokal. Jede Zeichenkette, die weder ein Modell-Alias noch ein Modell ist, das Claude Code auflistet oder das Sie konfiguriert haben, noch eine ID, die mit `claude-` beginnt, erhält diesen Fehler, einschließlich einer falsch geschriebenen ID wie `claud-sonnet-5`. Vor v2.1.260 deckte diese Prüfung Auswahlen über Remote Control nicht ab, daher wurde eine nicht erkannte Zeichenkette übernommen und schlug bei der nächsten Anfrage fehl.

**Was zu tun ist:**

* Führen Sie `/model` ohne Argument aus, um die Auswahl zu öffnen, wählen Sie aus den Modellen, die für Ihr Konto verfügbar sind, und übergeben Sie dann den dort angezeigten Alias oder die ID
* Wenn Sie einen Alias verwendet haben, den nur eine neuere Claude Code-Version unterstützt, führen Sie `claude update` aus, oder übergeben Sie stattdessen die vollständige ID des Modells. Der Server kann dennoch eine Mindestversion von Claude Code für dieses Modell verlangen; siehe [Claude Code unterstützt dieses Modell nicht](#claude-code-does-not-support-this-model).
* Ein Modell, das vor v2.1.200 gespeichert wurde, wird durch diese Prüfung nicht repariert. Wenn ein veralteter Wert immer wieder auftaucht, entfernen Sie ihn von den unter [Ihr Modell festlegen](https://code.claude.com/docs/de/model-config.md#setting-your-model) aufgeführten Orten.
* Bei jedem anderen Anbieter als der Anthropic API oder hinter einem Gateway oder einer benutzerdefinierten `ANTHROPIC_BASE_URL` erhält nur eine leere Zeichenkette diesen Fehler. Claude Code kann die [Diagnosezeile für nicht erkannte Modelle](#unrecognized-model-id-on-a-request) dennoch zum Zeitpunkt der Anfrage schreiben, bei jedem Anbieter.

### Modell nicht gefunden

Sie haben über einen Namen zu einem Modell gewechselt, und Claude Code konnte nicht bestätigen, dass ein Modell mit diesem Namen existiert. Wenn der Name kein [Modell-Alias](https://code.claude.com/docs/de/model-config.md#model-aliases) und keine andere Schreibweise ist, die Claude Code lokal akzeptiert, prüft Claude Code ihn mit einer minimalen API-Anfrage, und dieser Fehler ist normalerweise die Antwort Ihres API-Endpunkts. Mit `/model <name>` erhält ein Name, der überhaupt keine Modell-ID sein kann, wie z. B. einer mit Leerzeichen, dieselbe Nachricht.

```text theme={null}
Model 'claude-opus-9' not found
```

Bei Anbietern mit anbieterspezifischen Modell-IDs kann die Nachricht einen `Try '...' instead`-Vorschlag hinzufügen, der die ID Ihres Anbieters für ein Fallback-Modell nennt.

**Was zu tun ist:**

* Führen Sie `/model` ohne Argument aus und wählen Sie aus den Modellen, die für Ihr Konto verfügbar sind, oder verwenden Sie einen [Modell-Alias](https://code.claude.com/docs/de/model-config.md#model-aliases) wie `sonnet`, der zu einem gepflegten Standard aufgelöst wird
* Wenn Sie eine vollständige ID eingegeben haben, gleichen Sie sie mit dem Modellkatalog Ihres Anbieters ab. Ein neu veröffentlichtes Modell kann auf der Anthropic API verfügbar sein, bevor Ihr Anbieter oder Ihre Region es anbietet.
* Im Agent SDK schlägt `setModel()` mit dieser Nachricht fehl und die Sitzung läuft auf ihrem vorherigen Modell weiter. Rufen Sie im TypeScript SDK [`supportedModels()`](https://code.claude.com/docs/de/agent-sdk/typescript#query-object) auf, um die Modelle aufzulisten, zu denen Sie wechseln können.
* Vor v2.1.265 lehnte `/model` auch die Alias-Schreibweise `opusplan[1m]` mit diesem Fehler ab. Aktualisieren Sie in diesen Versionen Claude Code, oder setzen Sie das Modell stattdessen in den [Einstellungen](https://code.claude.com/docs/de/model-config.md#setting-your-model) oder mit `--model`.

### Modell konnte nicht mit der API bestätigt werden

Sie haben über die Methode `setModel()` des [Agent SDK](https://code.claude.com/docs/de/agent-sdk/typescript.md) oder eine App, die die Claude Code CLI für Sie ausführt, etwa die [Desktop-App](https://code.claude.com/docs/de/desktop.md), das Modell gewechselt, und die Anfrage, die die Modell-ID bei Ihrem API-Endpunkt bestätigt, erhielt innerhalb von 15 Sekunden keine Antwort. Die Sitzung behält ihr aktuelles Modell.

```text theme={null}
Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.
```

In einer Sitzung, die die [Desktop-App](https://code.claude.com/docs/de/desktop.md) für Sie startet, endet die Nachricht bei `Try again.`

**Was zu tun ist:**

* Wechseln Sie erneut zu dem Modell
* Wenn der Wechsel weiterhin fehlschlägt, prüfen Sie, ob Claude Code Ihren API-Endpunkt erreichen kann; siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors)

### API-Fehler beim Überprüfen des ausgewählten Modells

Sie haben ein Modell mit `/model <name>` ausgewählt, oder eine mit der Sitzung verbundene App hat den Wechsel angefordert. Die API lehnte die minimale Anfrage ab, die Claude Code zur Überprüfung des Modells sendet, und zwar aus einem Grund, der keinen eigenen Eintrag hat, wie z. B. ein Rate-Limit oder ein Serverfehler. Die Sitzung behält ihr aktuelles Modell, und die Nachricht weist am Ende darauf hin:

```text theme={null}
API error: 429 <the server's explanation> · model not changed
```

Der mittlere Teil der Nachricht ist der HTTP-Status und die eigene Erklärung des Servers.

**Was zu tun ist:**

* Handeln Sie entsprechend der Erklärung des Servers; warten Sie bei einem Rate-Limit oder einem 5xx-Status und wählen Sie das Modell erneut aus
* Die Ablehnungen mit eigener Formulierung werden in den umliegenden Einträgen behandelt, wie [Modell nicht gefunden](#model-not-found) und [Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt](#model-is-restricted-by-your-organizations-settings)

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

Ihr aktiver Abonnementplan enthält das ausgewählte Modell nicht.

```text theme={null}
Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.
```

In einer Sitzung, die die Claude Desktop-App ausführt, fordert die Nachricht Sie auf, `sign out and sign in again`, anstatt die Befehle zu nennen.

**Was zu tun ist:**

* Führen Sie `/model` aus und wählen Sie ein Modell, das Ihr Plan enthält
* Wenn Sie Ihren Plan kürzlich aktualisiert haben und dies immer noch sehen, führen Sie `/logout` und dann `/login` aus. Das gespeicherte Token spiegelt Ihren Plan zum Zeitpunkt der Anmeldung wider, daher wird ein Upgrade auf claude.ai in einer bestehenden Sitzung erst wirksam, wenn Sie sich erneut authentifizieren.
* Unter [claude.com/pricing](https://claude.com/pricing) erfahren Sie, welche Modelle jeder Plan enthält

### Claude Code unterstützt dieses Modell nicht

Die API lehnte die Anfrage mit einem 400 ab, weil Ihre Claude Code-Version unter einem erforderlichen Minimum liegt. Entweder erfordert das ausgewählte Modell eine neuere Version, was der Server pro Modell prüft, oder die Richtlinie Ihrer Organisation erfordert eine. Der 400 trägt den Fehlercode `claude_code_version_too_old`, und die Nachricht gibt an, welches Minimum gilt.

```text theme={null}
API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.
```

Die Formulierung für die Organisationsrichtlinie lautet:

```text theme={null}
API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.
```

Die Version, die die API prüft, ist die, die von der Claude Code-Binärdatei gemeldet wird, die die Anfrage gestellt hat.

**Was zu tun ist:**

Aktualisieren Sie diese Binärdatei und starten Sie dann eine neue Sitzung. Woher die Binärdatei stammt, bestimmt, wie Sie vorgehen, außer in einer [selbst gehosteten Umgebung](https://code.claude.com/docs/de/self-hosted-environments-deploy.md#pin-the-version):

| Die Binärdatei, die die Anfrage gestellt hat | So aktualisieren Sie sie |
| :- | :- |
| Ein Claude Code, das Sie installiert haben | Führen Sie `claude update` aus |
| Die Claude Desktop-App | Aktualisieren Sie die App |
| Die Binärdatei, die die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) mitliefert | Aktualisieren Sie die Erweiterung |
| Die Binärdatei, die ein Agent SDK-Paket mitliefert | [Aktualisieren Sie das SDK-Paket](https://code.claude.com/docs/de/agent-sdk/hosting.md#runtime-dependencies) und starten Sie dann Ihre Anwendung neu. Bauen Sie eine [kompilierte ausführbare Einzeldatei](https://code.claude.com/docs/de/agent-sdk/typescript.md#compile-to-a-single-executable) neu |

* Wenn Sie `claude update` im [stabilen Release-Kanal](https://code.claude.com/docs/de/setup.md#configure-release-channel) ausführen, bringt es Sie nicht über das neueste stabile Release hinaus, das immer noch unter dem erforderlichen Minimum liegen kann. Wechseln Sie zum Latest-Kanal und aktualisieren Sie dann erneut. Wenn Ihre Organisation Ihren Kanal oder Ihre Version über [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) festlegt, bitten Sie Ihren Admin, dies zu ändern
* Bei der modellspezifischen Formulierung können Sie in der aktuellen Sitzung weiterarbeiten, indem Sie zu einem anderen Modell wechseln: Führen Sie `/model` in der CLI aus, rufen Sie [`setModel()`](https://code.claude.com/docs/de/agent-sdk/typescript#query-object) auf dem `Query`-Objekt des TypeScript SDK im Streaming-Eingabemodus auf, oder rufen Sie [`set_model()`](https://code.claude.com/docs/de/agent-sdk/python#claudesdkclient) auf dem `ClaudeSDKClient` des Python SDK auf
* Bei der Formulierung für die Organisationsrichtlinie aktualisieren Sie, bevor Sie fortfahren

### Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt

Der Admin Ihrer Organisation hat dieses Modell in der claude.ai-Admin-Konsole deaktiviert, oder verwaltete Einstellungen schließen es über eine [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Allowlist oder eine [`deniedModels`](https://code.claude.com/docs/de/model-config#block-specific-models-or-versions)-Liste aus. Der Hinweis erscheint beim Start, wenn `--model`, `ANTHROPIC_MODEL` oder die Einstellung `model` das eingeschränkte Modell angegeben haben, und er nennt das Modell, das die Sitzung stattdessen verwendet. Wenn verwaltete Einstellungen der Sitzung kein zulässiges Modell lassen, siehe [Verwaltete Einstellungen blockieren das Standardmodell](#managed-settings-block-the-default-model). Der Ersetzungshinweis kann auch während einer Sitzung erscheinen, nachdem ein Admin das Modell, auf dem eine Sitzung läuft, in der claude.ai-Admin-Konsole deaktiviert hat.

```text theme={null}
Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
```

Die Eingabe von `/model <name>` für ein eingeschränktes Modell wird abgelehnt und die Sitzung behält ihr aktuelles Modell. Für ein in der Admin-Konsole deaktiviertes Modell lautet die Ablehnung `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` Für ein Modell, das verwaltete Einstellungen ausschließen, lautet sie `Model '<name>' is not available. Your organization restricts model selection.`

Ein Hinweis mit vorangestelltem Agenten-, Skill- oder Befehlsnamen bedeutet, dass die Einschränkung auf das [angeforderte Modell dieses Subagenten](https://code.claude.com/docs/de/sub-agents.md#choose-a-model) angewendet wurde: Der Subagent läuft auf dem ersetzten Modell, und das Modell Ihrer Sitzung bleibt unverändert. Vor v2.1.223 zeigte Claude Code den Hinweis nur für Subagenten an, die mit dem Agent-Tool gestartet wurden.

Claude Code behandelt einen Alias für eine Modellfamilie, also `opus`, `sonnet`, `haiku` oder `fable`, als Anfrage für diese Familie statt für ihre neueste Version. Auf der Anthropic API und auf [Claude Platform on AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md) wird ein eingeschränkter Familien-Alias zur neuesten Version der Familie aufgelöst, die die Einstellungen Ihrer Organisation zulassen, und der Ersetzungshinweis nennt diese Version. Claude Code lehnt `/model <alias>` nur ab, wenn jede Version der Familie eingeschränkt ist. Vor v2.1.205 wurde ein Familien-Alias allein anhand seiner neuesten Version ersetzt oder abgelehnt, auch wenn eine ältere Version derselben Familie zulässig war.

**Was zu tun ist:**

* Führen Sie `/model` aus, um aus den Modellen zu wählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind in der Auswahl ausgeblendet.
* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL`, im Feld `model` einer Einstellungsdatei oder im `model`-Frontmatter eines [Subagenten](https://code.claude.com/docs/de/sub-agents.md#choose-a-model), Skills oder Befehls gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, damit der Hinweis nicht erneut erscheint
* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie den Admin Ihrer Organisation, es zu aktivieren. Siehe [Modelleinschränkungen der Organisation](https://code.claude.com/docs/de/model-config.md#organization-model-restrictions).

### Wechsel zum Standardmodell nicht möglich

Sie haben das Standardmodell ausgewählt, zum Beispiel durch Auswahl der Zeile „Default“ in der `/model`-Auswahl oder durch Eingabe von `/model default`. Claude Code lehnte den Wechsel ab, daher behält die Sitzung ihr aktuelles Modell.

```text theme={null}
Can't switch to the default model: your organization's managed settings block it (claude-opus-4-6) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".
```

Die Formulierung nach dem Doppelpunkt nennt, was den Wechsel blockiert hat:

* **`your organization's managed settings block it ... in "deniedModels"`**: Eine verwaltete Denylist blockiert das Modell, zu dem die Standardoption aufgelöst wird
* **`your organization allows only the models listed in "availableModels"`**: Eine verwaltete [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Allowlist, bei der [`availableModelsMatch`](https://code.claude.com/docs/de/settings-reference#availablemodelsmatch) auf `"exact"` gesetzt ist, lässt das Modell aus, zu dem die Standardoption aufgelöst wird
* **`Claude Code couldn't read your organization's managed settings to check which models they allow`**: Die [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) konnten nicht gelesen werden, und Claude Code lehnt den Wechsel ab, anstatt ihn ungeprüft anzuwenden

**Was zu tun ist:**

* Bei den Formulierungen zu [`deniedModels`](https://code.claude.com/docs/de/settings-reference#deniedmodels) und `availableModels` führen Sie `/model` aus und wählen ein Modell, das Ihre Organisation zulässt, über seinen Namen
* Bitten Sie Ihren Administrator, die verwaltete Einstellung zu aktualisieren, die die Nachricht nennt
* Bei der Formulierung `couldn't read` starten Sie Claude Code neu; wenn es weiterhin auftritt, bitten Sie Ihren Administrator, die verwalteten Einstellungen zu überprüfen

Wenn eine Sitzung unter diesen verwalteten Einstellungen stattdessen mit einer `Claude Code can't start`-Nachricht nicht startet, siehe [Verwaltete Einstellungen blockieren das Standardmodell](#managed-settings-block-the-default-model).

### Modellwechsel wurde durch einen PreModelSwitch-Hook blockiert

Ein [PreModelSwitch-Hook](https://code.claude.com/docs/de/hooks.md#premodelswitch) hat den Modellwechsel, den Sie oder ein Client angefordert haben, nicht genehmigt, daher behält die Sitzung ihr aktuelles Modell. Wenn der Wechsel von einem [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Host oder über [Remote Control](https://code.claude.com/docs/de/remote-control.md) statt über einen von Ihnen eingegebenen Befehl kam, lautet die Nachricht `Model switch blocked by a PreModelSwitch hook`, ohne das Zielmodell zu nennen.

```text theme={null}
Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.
```

Der Grund nach dem Doppelpunkt gibt an, was den Wechsel verweigert hat:

* **Ein Grund, den ein Hook geschrieben hat**: Ein PreModelSwitch-Hook hat diesen Grund angegeben, als er [den Wechsel verweigert oder um Bestätigung gebeten hat](https://code.claude.com/docs/de/hooks.md#premodelswitch-decision-control). Kümmern Sie sich um das, was er verlangt, oder wählen Sie ein Modell, das Ihre Hooks zulassen.
* **`PreModelSwitch hook <name> did not respond before its timeout`**: Ein Hook, der nicht vor seinem [Timeout](https://code.claude.com/docs/de/hooks.md#timeouts) antwortet, blockiert den Wechsel. Beheben Sie den hängenden Befehl oder erhöhen Sie den `timeout` dieses Hooks und wechseln Sie dann erneut.
* **`confirmation required, and this session cannot ask`**: Ein Hook antwortete `ask` ohne Grund, und eine Steuerungsanfrage hat keine Möglichkeit, die Bestätigungsabfrage anzuzeigen. Ein `/model`-Befehl in einem [`-p`-Lauf](https://code.claude.com/docs/de/headless) meldet dieselbe Bedingung mit `(run /model interactively to confirm)` nach dem Grund. Führen Sie den Wechsel in einer interaktiven Sitzung durch, oder ändern Sie die Entscheidung des Hooks für dieses Modell.
* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code vor v2.1.323 lehnt ab, wenn es nicht feststellen kann, welche PreModelSwitch-Hooks Ihre [verwalteten Plugins](https://code.claude.com/docs/de/settings-reference.md#enabledplugins) mitliefern. Der Text vor dieser Formulierung nennt, was fehlgeschlagen ist. Um die Ablehnung zu beenden, aktualisieren Sie Claude Code. Damit auch die Hooks eines fehlgeschlagenen Plugins ausgeführt werden, beheben Sie das Plugin oder wenden Sie sich an Ihren Admin. Für Details starten Sie `claude --debug` in Ihrer Shell, wechseln Sie das Modell und lesen Sie dann das [Debug-Log](https://code.claude.com/docs/de/hooks.md#debug-hooks).
* **`a PreModelSwitch hook failed before answering`** oder **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: Der Hook-Lauf endete ohne Entscheidung, und Claude Code wertet das nicht als Genehmigung. Führen Sie `claude --debug` aus, um zu sehen, was fehlgeschlagen ist, und wechseln Sie dann erneut.

Vor v2.1.260 lautete die Ablehnung für verwaltete Plugins `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code versuchte das Laden der Plugins einmal erneut und lehnte dann spätere Wechsel in der Sitzung ab, auch wenn Ihre Organisation keine Plugins verwaltete. Starten Sie die Sitzung in diesen Versionen neu, um das Laden der Plugins erneut auszuführen.

### Konnte nicht als Ihr Standard gespeichert werden

Sie haben ein Modell ausgewählt, um es als Ihren Standard zu speichern, zum Beispiel mit `/model <name>` oder `Enter` in der `/model`-Auswahl, und Claude Code konnte die Auswahl nicht in Ihre Benutzereinstellungsdatei `~/.claude/settings.json` schreiben. Der Wechsel selbst wurde angewendet, daher läuft die aktuelle Sitzung auf dem ausgewählten Modell, aber Ihr Standard ist unverändert und die nächste Sitzung startet mit dem alten Wert.

```text theme={null}
Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)
```

Der Grund nach dem Dateipfad gibt an, was fehlgeschlagen ist:

* **`can't be written (<code>)`**: Der Schreibvorgang schlug mit dem Betriebssystem-Fehlercode in Klammern fehl, wie `EROFS`, wenn die Datei oder die Datei, auf die sie verweist, auf einem Dateisystem liegt, das Schreibvorgänge verweigert. Machen Sie die Datei beschreibbar und wechseln Sie erneut. Wenn ein anderes Tool die Datei erzeugt, setzen Sie stattdessen den Schlüssel `model` in diesem Tool; siehe [Eine in Claude Code vorgenommene Änderung geht in neuen Sitzungen verloren](https://code.claude.com/docs/de/settings.md#a-change-you-made-in-claude-code-is-lost-in-new-sessions).
* **`isn't valid JSON`**: Die Datei auf der Festplatte lässt sich nicht parsen, und Claude Code lässt sie unverändert, anstatt Inhalte zu überschreiben, die es nicht zurücklesen kann. Beheben Sie den Syntaxfehler und wechseln Sie dann erneut; siehe [Eine fehlerhafte Einstellungsdatei reparieren](https://code.claude.com/docs/de/settings.md#fix-a-broken-settings-file).

Ein Hinweis, der mit `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` endet, bedeutet, dass der Schreibvorgang nach drei Sekunden noch nicht abgeschlossen war. Er wird im Hintergrund fortgesetzt, daher kann der Standard dennoch gespeichert werden; prüfen Sie, mit welchem Modell Ihre nächste Sitzung startet, oder führen Sie `/model <name>` erneut aus.

Vor v2.1.265 besagte der Hinweis, das Modell sei `saved as your default for new sessions`, auch wenn der Schreibvorgang fehlgeschlagen war.

### Advisor ist weniger leistungsfähig als das aktuelle Hauptmodell

Ihr [Advisor-Modell](https://code.claude.com/docs/de/advisor.md) ist niedriger eingestuft als das Hauptmodell Ihrer Sitzung, daher behält Claude Code die Auswahl bei, hängt den Advisor aber nicht an die Anfragen des Hauptmodells an.

```text theme={null}
Advisor set to Opus 4.8
Note: Opus 4.8 is less capable than the current main model (Sonnet 5.5), so the advisor will not activate. Choose a more capable advisor, or switch to a smaller main model.
```

Andere Nachrichten melden dieselbe Bedingung:

* In einer interaktiven Sitzung lautet eine Benachrichtigung `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.
* Wenn Sie im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit dem Flag `--advisor` starten und der Lauf keine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) ist, geht eine Warnung an stderr, und der Lauf startet trotzdem. Sie lautet `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` Eine interaktive Sitzung schreibt diese Warnung nur in das [Debug-Log](#configuration-warnings).

**Was zu tun ist:**

* Wählen Sie einen höher eingestuften Advisor oder ein niedriger eingestuftes Hauptmodell. [Ein Advisor-Modell wählen](https://code.claude.com/docs/de/advisor.md#choose-an-advisor-model) zeigt die Rangfolge und listet die akzeptierten Advisors für jedes Hauptmodell auf.
* Lassen Sie den Advisor gesetzt, wenn [Subagenten](https://code.claude.com/docs/de/sub-agents.md), deren Modell er beraten kann, ihn weiterhin verwenden sollen

Vor v2.1.287 stufte Claude Code mehrere Kombinationen anders ein. Es zeigte diesen Hinweis für einen Sonnet 5.5-Advisor mit einem Opus 4.7- oder Opus 4.8-Hauptmodell an, eine Kombination, die es jetzt akzeptiert. Außerdem hängte es einige Advisors an, die jetzt diesen Hinweis erzeugen, wie einen Opus 4.8-Advisor mit einem Sonnet 5.5-Hauptmodell.

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

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

```text theme={null}
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 höher. Opus 4.8 benötigt v2.1.154 oder höher. Sonnet 5 benötigt v2.1.197 oder höher. Opus 5 benötigt v2.1.219 oder höher. Opus 5.5 benötigt v2.1.280 oder höher. Sonnet 5.5 benötigt v2.1.284 oder höher
* Im [stabilen Release-Kanal](https://code.claude.com/docs/de/setup.md#configure-release-channel) bringt Sie ein Update nicht über das neueste stabile Release hinaus, das immer noch älter als diese Versionen sein kann. Wechseln Sie zum Latest-Kanal und aktualisieren Sie dann
* Wenn Sie nicht aktualisieren können, führen Sie `/model` aus und wählen Sie stattdessen Opus 4.6 oder Sonnet 4.6
* Wenn dies im [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) auftritt, aktualisieren Sie stattdessen das SDK-Paket. Opus 4.8 benötigt TypeScript SDK v0.3.154 oder höher und Python SDK v0.2.88 oder höher. Sonnet 5 benötigt TypeScript SDK v0.3.197 oder höher. Opus 5 benötigt TypeScript SDK v0.3.219 oder höher. Opus 5.5 benötigt TypeScript SDK v0.3.280 oder höher. Sonnet 5.5 benötigt TypeScript SDK v0.3.284 oder höher

### Effort ist bei ausgeschaltetem Thinking nicht verfügbar

Sie haben [Extended Thinking](https://code.claude.com/docs/de/model-config.md#extended-thinking) ausgeschaltet und mit einer [Effort-Stufe](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) über `high` gearbeitet. Das Modell akzeptiert diese Kombination nicht, daher lehnte die API die Anfrage ab.

```text theme={null}
API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)
```

Der Hinweis nach dem `·` variiert je nach Sitzung: In einer nicht interaktiven Sitzung lautet er `use --effort high (or the effortLevel setting)`, und in einer Sitzung, die die Claude Desktop-App ausführt, lautet er `you can lower effort to High`.

**Was zu tun ist:**

* [Senken Sie die Effort-Stufe](https://code.claude.com/docs/de/model-config.md#set-the-effort-level) auf `high` oder darunter.
* Schalten Sie Thinking wieder ein, zum Beispiel indem Sie [`MAX_THINKING_TOKENS`](https://code.claude.com/docs/de/env-vars) aufheben oder [`"alwaysThinkingEnabled": false`](https://code.claude.com/docs/de/settings-reference#alwaysthinkingenabled) aus Ihren Einstellungen entfernen.

Vor v2.1.242 zeigte Claude Code die eigene Nachricht der API an: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` Vor v2.1.251 sendete Claude Code die Anfrage mit der von Ihnen festgelegten Effort-Stufe, daher lehnte Opus 5 bei ausgeschaltetem Thinking jede Anfrage über `high` ab. Claude Code sendet jetzt stattdessen Effort `high` an Modelle, von denen es weiß, dass sie die Kombination ablehnen, wie Opus 5.

### Thinking-Budget überschreitet Ausgabelimit

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

```text theme={null}
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
```

**Was zu tun ist:**

* Erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](https://code.claude.com/docs/de/env-vars) über das Thinking-Budget
* Unter [Extended Thinking](https://code.claude.com/docs/de/model-config.md#extended-thinking) erfahren Sie, wie das Budget mit der Ausgabelänge zusammenwirkt

### Response exceeded the output token maximum

Claudes Antwort hat die größte Anzahl an Ausgabe-Token erreicht, die die Anfrage erlaubte, und wurde dort abgeschnitten:

```text theme={null}
API Error: Claude's response exceeded the ... output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable.
API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit.
```

Die Form, die `a request sent without streaming` nennt, bedeutet, dass eine Streaming-Anfrage fehlgeschlagen ist und Claude Code sie ohne Streaming erneut gesendet hat, was die Antwort auf 64.000 Ausgabe-Token begrenzt. Vor v2.1.299 beendete eine bei einer solchen erneut gesendeten Anfrage abgeschnittene Antwort den Turn ohne diese Meldung, als wäre die Antwort vollständig.

**Was Sie tun können:**

* Wenn Claude vor dem Abschneiden der Antwort bereits Text geschrieben hat, antworten Sie in einer interaktiven Sitzung mit `continue`, um den Rest anzufordern. Dieser Text bleibt in der Konversation.
* Wenn die Meldung Sie auffordert, `CLAUDE_CODE_MAX_OUTPUT_TOKENS` zu setzen, erfahren Sie unter [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](https://code.claude.com/docs/de/env-vars), wie der Wert begrenzt wird, und unter [Umgebungsvariablen setzen](https://code.claude.com/docs/de/env-vars.md#set-environment-variables), wo Sie ihn setzen
* Damit jede Antwort unter dem Limit bleibt, bitten Sie Claude, die Ausgabe in kleineren Teilen zu liefern, etwa eine Datei oder einen Abschnitt pro Antwort

### Nichtübereinstimmung bei Tool-Nutzung oder Thinking-Block

Der Konversationsverlauf erreichte die API in einem inkonsistenten Zustand.

```text theme={null}
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
API Error: 400 duplicate tool_use ID in conversation history. 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 Varianten bedeuten dasselbe: Die Abfolge von `tool_use`-, `tool_result`- und `thinking`-Blöcken im Verlauf stimmt nicht mehr mit dem überein, was die API erwartet.

**Was zu tun ist:**

* 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 bei normaler Tool-Nutzung auslösen, und `/rewind` behebt ihn nicht.
* Führen Sie `/rewind` aus oder drücken Sie zweimal Esc, um zu einem Checkpoint vor dem beschädigten Turn zurückzugehen und von dort aus fortzufahren. Unter [Checkpointing](https://code.claude.com/docs/de/checkpointing.md) erfahren Sie, wie Checkpoints erstellt und wiederhergestellt werden.

### Ungültige Daten im redacted\_thinking-Block

Die API lehnte die Anfrage mit einem 400 ab, weil sie einen `redacted_thinking`-Block, den ein früherer Turn im Konversationsverlauf enthält, nicht akzeptieren konnte.

```text theme={null}
API Error: 400 ... Invalid `data` in `redacted_thinking` block
```

Claude Code lässt das frühere Thinking der Konversation aus der Anfrage weg und versucht es einmal erneut, daher wird die Sitzung fortgesetzt, ohne den Fehler anzuzeigen. Vor v2.1.282 behielt Claude Code den abgelehnten Block bei, und jeder spätere Turn schlug mit demselben Fehler fehl.

**Was zu tun ist:**

* Wenn Sie v2.1.281 oder älter verwenden und jeder Turn mit diesem Fehler fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung fort
* Wenn der Fehler weiterhin auftritt, führen Sie `/clear` aus, um eine Konversation zu starten, die den Block nicht enthält

### Nicht unterstützter Tool-Inhalt entfernt

Wenn Claude Code direkt mit der Anthropic API verbunden ist und eine gespeicherte Sitzung lädt oder in der Vorschau anzeigt, entfernt es Tool-Inhalte, die die Anthropic API nicht akzeptiert, und hinterlässt diese Zeile dort, wo entfernter Inhalt zwischen zwei Thinking-Blöcken stand:

```text theme={null}
[Unsupported tool content removed]
```

Solcher Inhalt gelangt in eine Sitzungsdatei, wenn etwas anderes als die Anthropic API im Format der API geantwortet hat, typischerweise ein über [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) gesetzter Drittanbieter-Proxy, der die Tool-Aufrufe eines anderen Anbieters übersetzt. Claude Code entfernt ihn nur, wenn die Sitzung direkt mit der Anthropic API verbunden ist, und lädt den gespeicherten Verlauf unverändert, wenn die Sitzung über einen Proxy oder bei einem anderen Anbieter läuft. Vor v2.1.246 sendete Claude Code die Tool-Nutzung und ihr Ergebnis an die API zurück, und jeder Turn der fortgesetzten Sitzung schlug mit einem 400-Fehler wie `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...` fehl.

**Was zu tun ist:**

* Keine Aktion erforderlich, wenn Sie die Platzhalterzeile sehen. Die Sitzung wird ohne den entfernten Inhalt fortgesetzt.
* Wenn stattdessen jeder Turn einer fortgesetzten Sitzung mit dem 400-Fehler fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung erneut fort. Versionen vor v2.1.246 entfernen den Inhalt nicht.

### Rolle 'system' muss einer 'assistant'-Nachricht vorangehen

Die API lehnte die Anfrage mit einem 400 ab, weil eine System-Nachricht an einer Position in der Konversation steht, die sie nicht akzeptiert:

```text theme={null}
API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...
```

Claude Code sendet einen Teil seines Erinnerungs- und Anhangstextes als System-Nachrichten innerhalb der Konversation. Wenn die API die Position einer solchen Nachricht ablehnt, versucht Claude Code die Anfrage einmal erneut und sendet diesen Text stattdessen als gewöhnliche Benutzernachrichten. Die verwandten Formulierungen der API zur Platzierung, wie `use the top-level 'system' parameter for the initial system prompt`, erhalten dieselbe Wiederherstellung.

Wenn der Fehler dennoch erscheint, ist die abgelehnte System-Nachricht keine, die Claude Code entfernen kann. Das bedeutet normalerweise, dass ein Proxy oder [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) zwischen Claude Code und der API eine eigene System-Nachricht hinzugefügt hat.

**Was zu tun ist:**

* Wenn sich der Fehler hinter einem über [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/de/env-vars) konfigurierten Proxy oder Gateway bei jedem Turn wiederholt, verbinden Sie sich ohne den Proxy, um die Quelle zu bestätigen, und melden Sie den Fehler an den Betreiber
* Führen Sie `/clear` aus, um eine neue Konversation zu starten. Wenn der Fehler auch dort auftritt, liegt die Ursache auf dem Anfragepfad, nicht in der gespeicherten Konversation.

Vor v2.1.280 erkannte Claude Code diese Formulierung nicht, daher trat der Fehler auch auf, wenn die abgelehnte System-Nachricht von Claude Code selbst gesendet wurde, und jeder spätere Turn der Konversation schlug auf die gleiche Weise fehl.

### Ungültiger encrypted\_content im search\_result-Block

Die API lehnte die Anfrage mit einem 400 ab, weil der Konversationsverlauf gehostete Websuche-Inhalte enthält, die sie nicht entschlüsseln kann. Die Formulierung nennt das Feld, das sie nicht lesen kann:

```text theme={null}
API Error: 400 ... Invalid `encrypted_content` in `search_result` block
API Error: 400 ... Invalid `encrypted_index` in `text` block
API Error: 400 ... Failed to decrypt web search result content
API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block
```

Ergebnisse des gehosteten [Websuche-Tools](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) der API enthalten verschlüsselte Felder, die nur die API lesen kann. Die Formulierung mit `encrypted_stdout` bezieht sich auf die Ausgabe eines gehosteten Code-Ausführungsprogramms, das solche Ergebnisse gelesen hat und das die API ebenfalls verschlüsselt. Die API lehnt eine Anfrage ab, die Inhalte erneut sendet, die sie nicht entschlüsseln kann, wie z. B. Inhalte, die für eine andere Organisation erzeugt wurden.

Das eigene [WebSearch-Tool](https://code.claude.com/docs/de/tools-reference.md#websearch-tool-behavior) von Claude Code speichert Suchergebnisse als Klartext, daher gelangen diese Blöcke normalerweise über einen Proxy oder ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway), das selbst die gehostete Websuche ausgeführt hat, in eine Konversation.

Bei den drei Websuche-Formulierungen lässt Claude Code die Suchaufrufe, Ergebnisse und Zitate aus dem Gesendeten weg und versucht die Anfrage einmal erneut, daher wird die Sitzung fortgesetzt, ohne den Fehler anzuzeigen. Für die Formulierung mit `encrypted_stdout` gibt es keine solche Wiederherstellung, daher erreicht Sie diese Nachricht weiterhin. Vor v2.1.282 behielt Claude Code auch die abgelehnten Websuche-Blöcke bei, und jeder spätere Turn sowie `/compact` schlugen auf die gleiche Weise fehl.

**Was zu tun ist:**

* Wenn Sie v2.1.281 oder älter verwenden und jeder Turn mit einer der Websuche-Formulierungen fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung fort
* Wenn der Fehler weiterhin auftritt oder die Nachricht `encrypted_stdout` nennt, führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der den Inhalt hinzugefügt hat, oder führen Sie `/clear` aus, um eine Konversation zu starten, die ihn nicht enthält
* Wenn Sie Claude Code hinter einem Proxy oder Gateway ausführen, melden Sie den Fehler an den Betreiber

### Ablehnung wegen Nutzungsrichtlinie

Die API lehnte eine Antwort ab, weil Inhalte in der Konversation eine Prüfung der [Nutzungsrichtlinie](https://www.anthropic.com/legal/aup) ausgelöst haben.

Wenn die Nachricht die Zeile `` Details: `[reasoning_extraction]` `` enthält, siehe [Schutzmaßnahmen haben eine Anfrage nach Claudes Denkprozess gekennzeichnet](#safeguards-flagged-a-request-for-claudes-reasoning).

Die Nachricht enthält eine Request-ID und eine Message-ID, die Sie dem Support nennen können, wenn Sie die Ablehnung für falsch halten.

```text theme={null}
API Error: Opus 4.6 can't help with this. Start a new session to continue.

Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup
```

Die Nachricht nennt das Modell, das abgelehnt hat, oder `Claude`, wenn kein Modell erfasst ist.

Die Prüfung bewertet die gesamte Konversation, nicht nur Ihren neuesten Prompt, daher löst das Senden einer neuen Nachricht in derselben Sitzung normalerweise dieselbe Ablehnung erneut aus. 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](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) und [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) deckt diese Nachricht auch Anfragen ab, die die Sicherheitsmaßnahmen des Modells als Cybersicherheitsthema gekennzeichnet haben. Siehe [Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet](#safety-measures-flagged-a-cybersecurity-topic).

Vor v2.1.219 lautete die Nachricht `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.`

**Was zu tun ist:**

* Drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Ablehnung ausgelöst hat, und formulieren Sie dann um oder wählen Sie einen anderen Ansatz. Siehe [Checkpointing](https://code.claude.com/docs/de/checkpointing.md).
* Wenn Sie nicht feststellen können, welcher Turn die Ablehnung verursacht hat, führen Sie `/clear` aus, um eine neue Konversation im selben Projekt zu starten. Ihre vorherige Konversation bleibt auf der Festplatte erhalten und ist weiterhin über `/resume` verfügbar.
* Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) (`-p`), in dem Rewind nicht verfügbar ist, versuchen Sie es mit einem umformulierten Prompt in einer neuen Sitzung ohne `--continue` erneut. Richtlinienprüfungen variieren je nach Modell, daher kann in manchen Fällen auch ein Wechsel zu einem anderen Modell mit `--model` die Ablehnung beheben.

### Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet

Die Sicherheitsmaßnahmen des Modells haben Inhalte in der Konversation als Cybersicherheitsthema gekennzeichnet. Die Nachricht nennt das Modell, das die Anfrage gekennzeichnet hat:

```text theme={null}
API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude
```

Wenn die Nachricht die Zeile `` Details: `[reasoning_extraction]` `` enthält, siehe [Schutzmaßnahmen haben eine Anfrage nach Claudes Denkprozess gekennzeichnet](#safeguards-flagged-a-request-for-claudes-reasoning).

Diese Nachricht verlinkt auf das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), das Zugang für legitime Cybersicherheitsarbeit gewährt. Modelle mit [automatischem Modell-Fallback](https://code.claude.com/docs/de/model-config.md#automatic-model-fallback) geben eine andere Nachricht ohne diesen Link aus; bei Opus 5.5 und Sonnet 5.5 beginnt sie mit `<model>'s safeguards flagged this session`. Dieser Abschnitt beschreibt auch, wann Claude Code stattdessen das Modell wechselt.

Auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) und [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) erzeugt eine Cybersicherheitskennzeichnung stattdessen die Nachricht zur [Ablehnung wegen Nutzungsrichtlinie](#usage-policy-refusal).

**Was zu tun ist:**

* Wenn Ihre Arbeit diese Inhalte erfordert, beantragen Sie Zugang über das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
* Wenn Ihre Anfrage kein Cybersicherheitsthema betraf, führen Sie `/feedback` aus, um das falsch positive Ergebnis zu melden
* Um in derselben Sitzung weiterzuarbeiten, drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Kennzeichnung ausgelöst hat, und wählen Sie dann einen anderen Ansatz. Siehe [Checkpointing](https://code.claude.com/docs/de/checkpointing.md).

Wenn die angezeigte Meldung stattdessen wie eine der folgenden formuliert ist, handelt es sich um dieselbe Kennzeichnung in einer älteren Claude Code-Version:

* Von v2.1.219 bis v2.1.296 konnte die Meldung vor ihrem abschließenden Satz zusätzlich `Apply to the Cyber Verification Program to reduce these interruptions.` enthalten
* Von v2.1.203 bis v2.1.218 lautete die Meldung `<model> 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:`, gefolgt von demselben Link zum Hilfecenter. In interaktiven Sitzungen wurde sie mit `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.` fortgesetzt
* Vor v2.1.203 lautete sie `<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 Link zu einem Ausnahmeformular

### Schutzmaßnahmen haben eine Anfrage nach Claudes Denkprozess gekennzeichnet

Die API lehnte die Anfrage ab, weil Schutzmaßnahmen sie als Aufforderung an das Modell gekennzeichnet haben, seinen internen Denkprozess in der Antwort wiederzugeben. Die API bezeichnet diese [Ablehnungskategorie](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#refusal-response) als `reasoning_extraction`, und die Ablehnungsnachricht enthält diese Zeile:

```text theme={null}
Details: `[reasoning_extraction]`
```

Vor v2.1.234 enthielten Ablehnungsnachrichten die Zeile `Details` nicht.

**Was zu tun ist:**

* Entfernen oder formulieren Sie jede Anweisung um, die Claude auffordert, sein Thinking oder seinen Denkprozess wörtlich oder in einem festen Format auszuschreiben, wie z. B. einen `<thinking>`-Abschnitt, einen Scratchpad-Abschnitt oder ein `reasoning`-Feld in einer JSON-Ausgabe. Die Anweisung kann in Ihrem Prompt stehen oder in einer Anpassung, die Claude Code zusammen damit lädt, wie CLAUDE.md, einem Skill, einem Subagenten-Prompt, einem Ausgabestil oder einer MCP-Tool-Beschreibung.
* Um zu prüfen, ob eine Anpassung der Auslöser ist, führen Sie [`claude --safe-mode`](https://code.claude.com/docs/de/cli-reference#cli-flags) in Ihrem Terminal aus, um eine Sitzung mit deaktivierten Anpassungen zu starten, und senden Sie dann denselben Prompt
* Starten Sie eine neue Sitzung, nachdem Sie eine Anpassung geändert haben
* Wie Sie einen bereits gesendeten Prompt umformulieren, erfahren Sie unter [Zurückspulen und zusammenfassen](https://code.claude.com/docs/de/checkpointing.md#rewind-and-summarize)
* Sie können Claude weiterhin bitten, seine Antwort zu erklären. Bitten Sie um eine kurze Erklärung, die Belege für ein Ergebnis oder eine Zusammenfassung der durchgeführten Aktionen. Wie Sie Zusammenfassungen von Claudes Thinking lesen, erfahren Sie unter [`showThinkingSummaries`](https://code.claude.com/docs/de/settings-reference#showthinkingsummaries).
* Weitere Beispiele und was zu tun ist, wenn eine umformulierte Anfrage weiterhin abgelehnt wird, finden Sie unter [Reasoning in Thinking-Blöcken belassen](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#keep-reasoning-in-thinking-blocks)

### Ausgabe durch Inhaltsfilter-Richtlinie blockiert

Der Ausgabe-Inhaltsfilter der API hat die Antwort gestoppt, die Claude gerade erzeugte. Der Nachrichtentext stammt von der API:

```text theme={null}
API Error: Output blocked by content filtering policy
```

**Was zu tun ist:**

* Formulieren Sie Ihre letzte Nachricht um oder wählen Sie einen anderen Ansatz
* Um zu einem Checkpoint vor dem Turn zurückzugehen, der die Blockierung ausgelöst hat, drücken Sie zweimal Esc oder führen Sie `/rewind` aus. Siehe [Checkpointing](https://code.claude.com/docs/de/checkpointing.md)

## Befehlszeilenfehler

Diese Fehler stammen von der `claude`-Befehlszeile und ihren Unterbefehlen, von einem Befehlsnamen, den Sie im Eingabefeld absenden, und von Befehlen wie `/security-review`, die Kontext sammeln, indem sie Shell-Befehle ausführen, bevor ihr Prompt ausgeführt wird. Sie stammen außerdem von `/tui`, das die CLI neu startet.

### Konflikt zwischen `--bg` und `--print`

Diese Meldung erfordert Claude Code v2.1.198 oder höher. Sie haben `--bg` mit `-p` oder `--print` im selben `claude`-Aufruf kombiniert. `--bg` startet eine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md#from-your-shell), mit der Sie sich später über `claude agents` verbinden, während `--print` [nicht interaktiv](https://code.claude.com/docs/de/headless.md) ausgeführt wird und nie die interaktive Sitzung startet, mit der sich `claude agents` verbindet. Vor v2.1.198 erzeugte diese Kombination stillschweigend einen Hintergrundjob, mit dem man sich nie verbinden konnte.

```text theme={null}
--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>'`.
```

**Vorgehensweise:**

* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt den Prompt als Positionsargument entgegen, daher ist `claude --bg "<task>"` der vollständige Befehl. Siehe [Neue Agenten aus Ihrer Shell starten](https://code.claude.com/docs/de/agent-view.md#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

### Couldn't tell whether `--bg` is a flag or text

Sie haben `claude` mit `--bg` oder `--background` an einer Position ausgeführt, an der Claude Code nicht erkennen konnte, ob Sie es als Hintergrund-Flag oder als Text gemeint haben. Der Befehl hat nichts gestartet, diese Zeile ausgegeben und sich mit Exit-Code 1 beendet:

```text theme={null}
Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>
```

Wenn Sie `--background` eingegeben haben, nennt die Zeile stattdessen `--background`.

**Was zu tun ist:**

* Um eine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md#from-your-shell) zu starten, führen Sie den Befehl erneut in Ihrer Shell aus und stellen Sie das Flag an den Anfang: `claude --bg --name nightly-audit "<task>"`

### Konflikt zwischen einem System-Prompt-Flag und seiner Dateiform

Sie haben [`--append-subagent-system-prompt`](https://code.claude.com/docs/de/cli-reference#cli-flags) zusammen mit `--append-subagent-system-prompt-file` in einem `claude`-Aufruf übergeben, daher beendet sich `claude` mit Exit-Code 1, anstatt die Sitzung zu starten:

```text theme={null}
Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
```

Vor v2.1.283 beendete sich `claude` auf dieselbe Weise, wenn Sie `--system-prompt` mit `--system-prompt-file` oder `--append-system-prompt` mit `--append-system-prompt-file` übergeben haben, weil diese Paare in Konflikt standen, anstatt [kombiniert zu werden](https://code.claude.com/docs/de/cli-reference.md#system-prompt-flags). In diesen Versionen nennt die Meldung das Paar, das Sie kombiniert haben.

**Vorgehensweise:**

* Behalten Sie eine Form des Flags bei und lassen Sie die andere weg. Um eine feste Prompt-Datei mit Text pro Ausführung zu kombinieren, fügen Sie den Text vor dem Start in die Datei ein, anstatt beide Flags zu übergeben

### Ungültige `--agents`-Konfiguration

Der Wert, den Sie an `--agents` übergeben haben, ist ungültig, daher beendet sich `claude` mit Exit-Code 1, anstatt die Sitzung zu starten. Wenn Sie `--safe-mode` übergeben oder [`CLAUDE_CODE_SAFE_MODE`](https://code.claude.com/docs/de/env-vars#variables) setzen, ignoriert Claude Code `--agents` vollständig. Mit `--resume` oder `--continue` wird ein Inline-JSON-Wert nicht geprüft und die Sitzung startet; ein aus einer Datei gelesener Wert wird bei jedem Start geprüft. Vor v2.1.242 startete Claude Code die Sitzung trotzdem.

```text theme={null}
Error: Invalid --agents configuration:
<what failed>
```

Was auf die erste Zeile folgt, hängt davon ab, wie der Wert fehlgeschlagen ist. Claude Code führt diese Prüfungen der Reihe nach aus und stoppt bei der ersten, die fehlschlägt. Wenn Ihr Wert zwei Arten von Problemen hat, sehen Sie das zweite erst, nachdem Sie das erste behoben haben:

1. Wenn der Wert mit `{` beginnt, aber nicht als JSON geparst werden kann, oder der Inhalt einer `--agents`-Datei nicht geparst werden kann, gibt Claude Code eine `invalid JSON:`-Zeile mit der eigenen Meldung des JSON-Parsers aus
2. Wenn er geparst wird, aber eine Agentendefinition nicht dem Schema für [per CLI definierte Subagenten](https://code.claude.com/docs/de/sub-agents.md#choose-the-subagent-scope) entspricht, gibt Claude Code eine Zeile pro Problem aus
3. Wenn ein Agentenname mit `-` beginnt, gibt Claude Code `<name>: agent names must not start with '-'` aus

Bei mehr als 20 Problemzeilen gibt Claude Code die ersten 20 aus und ersetzt den Rest durch `…and N more`.

Mit `--print` akzeptiert `--agents` anstelle des Inline-Objekts auch [den Pfad zu einer JSON-Datei](https://code.claude.com/docs/de/sub-agents.md#choose-the-subagent-scope). Vor v2.1.281 akzeptierte `--agents` nur Inline-JSON und behandelte einen Dateipfad als ungültiges JSON. Die Dateiform hat eigene Ablehnungen, die anstelle dieser Meldung ausgegeben werden, darunter diese:

* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code hat den Wert in einer interaktiven Sitzung als Dateipfad gelesen. Übergeben Sie die Definitionen als Inline-JSON oder fügen Sie `-p` hinzu, um sie aus einer Datei zu lesen.
* **`Error: --agents file not found: <path>`**: Unter diesem Pfad existiert keine Datei. Ein Wert, der nicht mit `{` beginnt und kein gültiges JSON ist, wird als Pfad gelesen, sodass auch Inline-JSON, das Ihre Shell verstümmelt hat, auf diese Weise fehlschlagen kann. Prüfen Sie den Pfad oder die Anführungszeichen und führen Sie den Befehl erneut aus.

**Vorgehensweise:**

* Beheben Sie jedes Problem, das die Meldung auflistet, und führen Sie den Befehl dann erneut aus. Siehe [die Felder, die ein per CLI definierter Subagent akzeptiert](https://code.claude.com/docs/de/sub-agents.md#choose-the-subagent-scope).

### Cloud-Sitzungen können nicht aus einer `--restricted`-Sitzung erstellt werden

Wenn Sie eine Sitzung mit [`--restricted`](https://code.claude.com/docs/de/cli-reference#cli-flags) starten, weigert sich Claude Code, daraus [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md#from-terminal-to-cloud) zu erstellen, weil die neue Sitzung außerhalb des eingeschränkten Prozesses laufen und den eingeschränkten Modus nicht durchsetzen würde. Claude Code lehnt dies auf dem Client ab, bevor der Server kontaktiert wird, sodass keine Cloud-Sitzung erstellt wird:

```text theme={null}
Cloud sessions cannot be created from a --restricted session: they would not enforce it.
```

**Vorgehensweise:**

* Führen Sie die Aufgabe lokal in der eingeschränkten Sitzung aus
* Wenn Sie steuern, wie die Sitzung gestartet wurde, starten Sie eine neue `claude`-Sitzung ohne `--restricted` und erstellen Sie die Cloud-Sitzung von dort aus

Vor v2.1.248 hatte Claude Code kein `--restricted`-Flag; frühere Versionen lehnen das Flag selbst mit einem Fehler wegen einer unbekannten Option ab.

### Cloud-Sitzungen sind durch die Richtlinie Ihrer Organisation deaktiviert

Die Richtlinie `allow_remote_sessions` Ihrer Organisation ist ausgeschaltet, daher sind [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md) und die Befehle, die sie verwenden, nicht verfügbar:

```text theme={null}
Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
```

Die Meldung erscheint, wenn Sie [eine Cloud-Sitzung aus dem Terminal erstellen](https://code.claude.com/docs/de/claude-code-on-the-web.md#from-terminal-to-cloud), und wenn Sie einen Befehl absenden, der Cloud-Sitzungen benötigt, etwa `/teleport`, `/remote-env` oder `/web-setup`. Vor v2.1.268 lieferte das Absenden eines dieser Befehle stattdessen [`Unknown command`](#unknown-command).

Wenn die Meldung stattdessen Anmeldedaten nennt, die diese Sitzung verwendet, und mit `Cloud sessions use your claude.ai login.` endet, siehe [Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login). Wenn Claude Code die Richtlinie Ihrer Organisation überhaupt nicht laden konnte, sehen Sie stattdessen [eine andere Meldung](#couldnt-verify-your-organizations-policy-for-cloud-sessions).

**Vorgehensweise:**

* Bitten Sie einen [Owner](https://code.claude.com/docs/de/server-managed-settings.md#access-control) in Ihrer Organisation, Cloud-Sitzungen in den Claude-Code-Admin-Einstellungen unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren

### Cloud sessions use your claude.ai login

Wenn die [Richtlinienablehnung](#cloud-sessions-are-disabled-by-your-organizations-policy) Anmeldedaten nennt, die diese Sitzung verwendet, und mit diesem Satz endet, hat Claude Code die Cloud-Sitzungs-Richtlinie der Organisation geprüft, die diese Anmeldedaten ausgestellt hat. Diese Organisation kann sich von derjenigen unterscheiden, zu der Ihr claude.ai-Login gehört:

```text theme={null}
Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.
```

Der letzte Satz bedeutet, dass Cloud-Sitzungen mit Ihrem claude.ai-Login laufen und nicht mit diesen Anmeldedaten. Diese Form erscheint, wenn Sie eine Cloud-Sitzung aus Ihrer Shell starten, fortsetzen oder ihr eine Nachricht senden, etwa mit `--cloud` oder `--teleport`. Vor v2.1.296 gab Claude Code auch in diesem Fall die Form aus, die Sie auffordert, sich an den Admin Ihrer Organisation zu wenden.

### Couldn't verify your organization's policy for cloud sessions

Diese Meldungen bedeuten, dass Claude Code die Richtlinie Ihrer Organisation nicht laden konnte, die es prüft, bevor es eine [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) erstellt, fortsetzt oder ihr eine Nachricht sendet. Solange die Richtlinienanfrage noch nicht abgeschlossen ist, lautet die Meldung:

```text theme={null}
Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.
```

Innerhalb einer Sitzung gibt auch ein Befehl, der Cloud-Sitzungen benötigt, etwa `/teleport` oder `/web-setup`, diese Meldung aus. Das geschieht selbst dort, wo Ihre Shell eine `Cloud sessions aren't available:`-Form ausgeben würde, und ihr zweiter Satz lautet `Check your network connection, then restart Claude Code and try again.`

Sobald die Richtlinienanfrage fehlgeschlagen ist, nennt die Meldung, was fehlgeschlagen ist. Das gilt, wenn Sie eine Cloud-Sitzung aus Ihrer Shell mit einem Flag wie `--cloud` oder `--teleport` starten, fortsetzen oder ihr eine Nachricht senden. Ohne Route zur API lautet sie:

```text theme={null}
Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.
```

Andere Fehler folgen demselben Anfang mit ihrer eigenen Ursache, etwa ein Proxy, der die Anfrage mit HTTP 403 abgelehnt hat, ein Serverfehler oder Anmeldedaten, die die API nicht akzeptiert hat. Wenn die API Anmeldedaten nicht akzeptiert hat, die diese Sitzung anstelle Ihres claude.ai-Logins verwendet, etwa eine Umgebungsvariable `ANTHROPIC_API_KEY`, kann die Meldung diese auch nennen und sagen, dass Sie sie entfernen sollen:

```text theme={null}
Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.
```

Vor v2.1.296 gaben diese Fehler ebenfalls die `Couldn't verify`-Meldung aus.

**Was Sie tun können:**

* Prüfen Sie bei der `Couldn't verify`-Meldung Ihre Netzwerkverbindung und versuchen Sie es erneut. Starten Sie innerhalb einer Sitzung zuerst Claude Code neu
* Tun Sie bei einer `Cloud sessions aren't available:`-Meldung, was deren Ursache erfordert, etwa Ihren Proxy prüfen oder die genannten Anmeldedaten entfernen, und führen Sie den Befehl dann erneut aus

### Nichts wurde gestasht, weil ein Ordner eine getrackte Datei ersetzt hat

Diese Meldung bedeutet, dass sich in Ihrem Checkout jetzt ein Ordner dort befindet, wo früher eine von Git getrackte Datei oder ein Link war. Sie erscheint, nachdem Sie beim Übernehmen einer [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md#from-cloud-to-terminal) in Ihr Terminal die Stash-Option gewählt haben, zum Beispiel mit `claude --teleport` oder `/teleport`. Das Stashen dieses Zustands könnte die Dateien im Ordner löschen, daher verweigert Claude Code den Stash und lässt Ihren Checkout und Index unverändert:

```text wrap theme={null}
Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.
```

**Was zu tun ist:**

* Committen Sie die Änderung oder verschieben Sie den Ordner an einen anderen Ort, wie es die Meldung sagt, und führen Sie den Teleport dann erneut aus

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

Das Schema, das Sie im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md#get-structured-output) an [`--json-schema`](https://code.claude.com/docs/de/cli-reference#cli-flags) übergeben haben, konnte nicht als JSON-Schema kompiliert werden, daher beendet sich `claude` mit Exit-Code 1, anstatt den Prompt auszuführen. Vor v2.1.205 erzeugte ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler, und jedes Schema, das das Schlüsselwort `format` verwendete, wurde als ungültig behandelt.

```text theme={null}
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 nennt das Schlüsselwort oder die Stelle, die fehlgeschlagen ist. Schemas, die das Schlüsselwort `format` verwenden, etwa `"format": "email"`, sind gültig: Claude Code akzeptiert `format` als Annotation und setzt es nicht durch.

Claude Code führt vor der Schemakompilierung zwei Prüfungen aus: Einen Wert, der kein parsebares JSON ist, lehnt es 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`.

**Vorgehensweise:**

* Beheben Sie den Teil des Schemas, den die Diagnose nennt, und führen Sie den Befehl dann erneut aus
* Unter [Strukturierte Ausgabe erhalten](https://code.claude.com/docs/de/headless.md#get-structured-output) finden Sie ein funktionierendes Schema und einen funktionierenden Befehl

### Einstellungsdatei überschreitet das Limit von 2 MiB

Die Datei, die Sie an [`--settings`](https://code.claude.com/docs/de/cli-reference#cli-flags) übergeben haben, ist größer als 2 MiB, daher beendet sich `claude` beim Start mit Exit-Code 1, anstatt sie zu laden. Vor v2.1.214 las Claude Code die Datei ohne Größenprüfung, und eine mehrere Gigabyte große Datei oder eine Gerätedatei wie `/dev/zero` ließ den Speicherverbrauch unbegrenzt wachsen.

```text theme={null}
Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
```

Claude Code lehnt einen `--settings`-Pfad, der keine reguläre Datei ist, auf dieselbe Weise ab: Ein Gerät, ein FIFO oder ein Socket meldet `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` gefolgt vom Pfad, und ein Verzeichnis meldet einen `EISDIR`-Grund.

**Vorgehensweise:**

* Verweisen Sie mit `--settings` auf eine reguläre JSON-Einstellungsdatei unter 2 MiB. Das Format finden Sie unter [Einstellungen](https://code.claude.com/docs/de/settings.md).

### Configuration error in \~/.claude.json

Claude Code konnte `~/.claude.json` nicht parsen, die Datei, die Ihre Kontodaten, MCP-Server und den Zustand pro Projekt enthält. Ein [nicht interaktiver](https://code.claude.com/docs/de/headless.md) Start wie `claude -p` beendet sich mit Exit-Code 1.

Wenn Claude Code ein [Backup](https://code.claude.com/docs/de/claude-directory.md#cleaned-up-automatically) findet, nennt die Ausgabe es und gibt eine `cp`-Zeile aus, die es zurückkopiert:

```text wrap theme={null}
Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>
The corrupted file has been backed up to: /home/user/.claude/backups/.claude.json.corrupted.1793664000000
A backup file exists at: /home/user/.claude/backups/.claude.json.backup.1793660400000
You can manually restore it by running: cp -f "/home/user/.claude/backups/.claude.json.backup.1793660400000" "/home/user/.claude.json"

Configuration error in /home/user/.claude.json: <JSON parser's message>
```

**Was Sie tun können:**

* **Die Ausgabe enthält eine `cp`-Zeile**: Führen Sie diese Zeile in Ihrem Terminal aus. Unter Windows führen Sie sie in PowerShell aus.
* **Die Ausgabe enthält keine `cp`-Zeile, oder der Fehler tritt nach dem Ausführen erneut auf**: Wenn `~/.claude.json` Ihre Konfiguration noch enthält, beheben Sie das JSON. Wenn das nicht möglich ist, kopieren Sie eine andere `.claude.json.backup.<timestamp>`-Datei aus [`~/.claude/backups/`](https://code.claude.com/docs/de/claude-directory#cleaned-up-automatically) darüber, falls vorhanden, oder benennen Sie die ursprüngliche Datei um. Ohne Datei unter `~/.claude.json` startet Claude Code mit Standardeinstellungen und ohne den Inhalt der Datei.
* **`~/.claude.json` enthält Ihre Konfiguration nicht mehr**: Suchen Sie eine `.claude.json.corrupted.<timestamp>`-Datei, die sie noch enthält, in [`~/.claude/backups/`](https://code.claude.com/docs/de/claude-directory#cleaned-up-automatically) oder Ihrem Home-Verzeichnis. Beheben Sie ihr JSON und kopieren Sie sie dann über `~/.claude.json`. Wenn Sie keine finden oder beheben können, versuchen Sie dieselben Schritte mit einer `.claude.json.backup.<timestamp>`-Datei, die Ihre Konfiguration enthält. Wenn keine das tut, benennen Sie `~/.claude.json` um und fügen Sie Ihre MCP-Server mit [`claude mcp add`](https://code.claude.com/docs/de/mcp#installing-mcp-servers) erneut hinzu.

### Claude configuration file was empty and no backup holds anything

Diese Meldung beim Start bedeutet, dass die genannte Datei leer war und keine der [`.backup`-Kopien](https://code.claude.com/docs/de/claude-directory#cleaned-up-automatically) der Datei Inhalt hat. Claude Code ist für den Inhalt dieser Datei mit Standardwerten gestartet. Ihre `settings.json`-Dateien und `.mcp.json` sind separate Dateien.

```text wrap theme={null}
Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.
```

**Was Sie tun können:**

* Richten Sie erneut ein, was Sie in dieser Datei konfiguriert hatten. Fügen Sie beispielsweise Ihre [MCP-Server](https://code.claude.com/docs/de/mcp.md#mcp-installation-scopes) mit den Geltungsbereichen `user` und `local` mit `claude mcp add` aus Ihrem Terminal hinzu.
* Melden Sie sich erneut an, wenn Claude Code Sie dazu auffordert

Vor v2.1.318 meldete Claude Code eine leere Datei ohne Backup als [beschädigt](#configuration-error-in-claude-json).

### Das aktuelle Verzeichnis existiert nicht mehr

Sie haben `claude` aus einem Verzeichnis gestartet, das gelöscht oder verschoben wurde, nachdem Ihre Shell es betreten hatte, zum Beispiel ein Worktree oder ein temporäres Verzeichnis, das eine andere Shell entfernt hat. Claude Code kann sein Arbeitsverzeichnis nicht lesen, daher beendet es sich mit Exit-Code 1, bevor die Sitzung startet, im interaktiven wie im [nicht interaktiven](https://code.claude.com/docs/de/headless.md) Modus. Vor v2.1.239 stürzte Claude Code ab und gab statt dieser Meldung minifizierten Bundle-Quellcode und einen rohen `ENOENT ... uv_cwd`-Stack auf stderr aus.

```text theme={null}
The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
```

Ursache und Lösung sind für beide Formen dieselben.

Wenn Claude Code das Arbeitsverzeichnis aus einem anderen Grund nicht lesen kann, etwa wegen einer geänderten Berechtigung, nennt die Meldung stattdessen den Fehlercode: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`

Unter macOS bedeutet `EPERM` für ein Verzeichnis in `~/Desktop`, `~/Documents`, `~/Downloads` oder iCloud Drive in der Regel, dass macOS Ihrer Terminal-App den Zugriff auf diesen Ordner verweigert. Andere Befehle, die diesen Ordner lesen, schlagen auf dieselbe Weise fehl: `ls` meldet dort `Operation not permitted`, selbst mit `sudo`.

**Vorgehensweise:**

* Wechseln Sie in ein existierendes Verzeichnis, etwa Ihr Home- oder Projektverzeichnis, und führen Sie `claude` dann erneut aus
* Wenn das Verzeichnis unter demselben Pfad neu erstellt wurde, hält Ihre Shell noch das gelöschte. Führen Sie `cd "$PWD"` aus oder verlassen Sie das Verzeichnis und betreten Sie es erneut, und führen Sie `claude` dann erneut aus
* Bei `EPERM` unter macOS beenden Sie Ihre Terminal-App mit Cmd+Q, öffnen Sie sie erneut, kehren Sie in diesen Ordner zurück und führen Sie `claude` aus. Wenn `ls` in diesem Ordner weiterhin fehlschlägt, öffnen Sie **Systemeinstellungen > Datenschutz & Sicherheit > Dateien und Ordner**, aktivieren Sie den Ordner für Ihre Terminal-App und öffnen Sie das Terminal dann erneut

### Temporäres Verzeichnis abgelehnt oder kann nicht erstellt werden

Unter macOS und Linux erstellt Claude Code beim Start ein privates temporäres Verzeichnis, `claude-<uid>`, unterhalb des temporären Systemverzeichnisses oder der Überschreibung durch [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/de/env-vars). Wenn das Verzeichnis nicht erstellt werden kann oder ein bereits unter diesem Pfad vorhandener Eintrag die Sicherheitsprüfungen nicht besteht, gibt Claude Code den Fehler auf stderr aus und beendet sich mit Exit-Code 1, anstatt die Sitzung zu starten:

```text wrap theme={null}
Claude Code's temporary directory /tmp/claude-501 could not be created: the volume holding /tmp is full (ENOSPC). Free space on that volume, or set CLAUDE_CODE_TMPDIR to a directory on another one, then try again.

Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
```

**Vorgehensweise:**

* Bei `could not be created` gefolgt von `is full (ENOSPC)` geben Sie Speicherplatz auf dem Volume frei, das die Meldung nennt. Wenn sie stattdessen `your disk quota on the volume holding /tmp is used up (EDQUOT)` lautet, löschen Sie eigene Dateien auf diesem Volume, die Sie nicht mehr benötigen
* Bei den `Refusing to use it`-Formen entfernen Sie den genannten Eintrag selbst, nicht das Ziel eines Links, und starten Sie Claude Code erneut; bei der `owned by uid`-Form kann ihn nur ein Administrator oder dieser Benutzer entfernen
* Bei `is not readable` führen Sie `chmod 0700` für das genannte Verzeichnis aus oder entfernen Sie es und starten Sie erneut
* In jedem dieser Fälle können Sie [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/de/env-vars) auf ein Verzeichnis setzen, das Sie kontrollieren, und Claude Code erneut starten, ohne den abgelehnten Pfad anzutasten

Vor v2.1.309 gab Claude Code nur den Fehlertext des Betriebssystems aus, wenn das Volume voll oder Ihr Kontingent aufgebraucht war. Ein Beispiel ist `ENOSPC: no space left on device, mkdir '/tmp/claude-501'`, und es gelten dieselben Schritte.

### Claude Code could not save because the disk is full

Diese Zeile auf stderr nach einer [`claude -p`](https://code.claude.com/docs/de/headless)-Ausführung bedeutet, dass die Festplatte voll oder Ihr Festplattenkontingent aufgebraucht ist, sodass Claude Code nicht alles aus der Ausführung speichern konnte:

```text wrap theme={null}
Error: Claude Code could not save all of this session's transcript under /Users/you/.claude because the disk is full (ENOSPC). If you resume this session, part of the conversation may be missing. Free up space on that disk before the next run.
```

Bei Text- oder `json`-Ausgabe endet die Ausführung mit Exit-Code 1, und die Antwort wurde bereits ausgegeben. Bei `stream-json`-Ausgabe behält die Ausführung ihren üblichen Exit-Code, und die Antwort kommt trotzdem an.

**Was zu tun ist:**

* **`the disk is full (ENOSPC)`**: Geben Sie vor Ihrer nächsten Ausführung Speicherplatz auf der Festplatte frei, die den Pfad aus der Meldung enthält
* **`your disk quota is used up (EDQUOT)`**: Geben Sie vor Ihrer nächsten Ausführung Speicherplatz frei oder fordern Sie ein größeres Kontingent an

### Verzeichnis konnte nicht zu einem realen Speicherort aufgelöst werden

Sie haben `/add-dir` für ein Unterverzeichnis Ihres Arbeitsverzeichnisses ausgeführt, und Claude Code konnte das Verzeichnis nicht zu seinem realen Speicherort auflösen.

Auf ein Unterverzeichnis des Arbeitsverzeichnisses haben Sie bereits Dateizugriff, daher lädt `/add-dir` nur dessen Skills, Befehle und Agenten. Bevor Claude Code sie lädt, prüft es, ob der reale Speicherort des Verzeichnisses, mit aufgelösten Symlinks, innerhalb des Arbeitsverzeichnisses liegt. Wenn Claude Code diesen Speicherort nicht auflösen kann, lädt es nichts und zeigt diese Meldung an:

```text theme={null}
packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
```

**Vorgehensweise:**

* Prüfen Sie, ob der Pfad ein reales Verzeichnis innerhalb des Arbeitsverzeichnisses bezeichnet, und führen Sie `/add-dir` dann erneut aus
* Die Meldung ändert Ihren Dateizugriff nicht; sie meldet nur, dass der `.claude/`-Inhalt des Verzeichnisses nicht geladen wurde

Vor v2.1.261 erschien diese Meldung auch bei jedem `/add-dir <subdirectory>`, wenn das Arbeitsverzeichnis auf einem `/net/<host>`-Automount lag, wo Claude Code absichtlich keine Pfade auflöst; das Verzeichnis war in Ordnung, und ein erneuter Versuch half nicht.

### Workspace beim Starten von Remote Control nicht vertrauenswürdig

> [!NOTE]
>
> Wenn `claude ultrareview` `Error: Workspace not trusted` ausgegeben hat, siehe stattdessen [Workspace not trusted when running claude ultrareview](#workspace-not-trusted-when-running-claude-ultrareview).

Sie haben den Servermodus von [Remote Control](https://code.claude.com/docs/de/remote-control.md) mit `claude remote-control` oder dessen Alias `claude rc` in einem Verzeichnis gestartet, dem Sie nicht vertraut haben, und der Befehl konnte Sie nicht fragen, ob Sie ihm vertrauen möchten. Zum Beispiel ist die Standardeingabe oder Standardausgabe des Befehls kein Terminal, weil eine davon umgeleitet oder über eine Pipe verbunden ist. Der Befehl beendet sich mit Exit-Code 1:

```text theme={null}
Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
```

Zwei Varianten, die ebenfalls mit `Error: Workspace not trusted.` beginnen, erscheinen in einem Terminal, das zu klein ist, um anzuzeigen, was das Vertrauen in das Verzeichnis aktiviert, oder das seine Größe nicht gemeldet hat. Vergrößern Sie das Fenster oder wechseln Sie zu einem normalen Terminalfenster und führen Sie `claude rc` dann erneut aus.

In Ihrem Home-Verzeichnis lautet die Meldung anders, weil der Workspace-Vertrauensdialog das Vertrauen für das Home-Verzeichnis nie speichert, sodass das Bestätigen dort diese Prüfung nicht erfüllen kann. Vor v2.1.214 zeigte das Home-Verzeichnis die obige Meldung, deren Rat dort nicht zum Erfolg führen kann.

```text theme={null}
Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
```

Wenn Sie bei der [`Trust <directory>?`-Frage](https://code.claude.com/docs/de/remote-control#requirements) mit `n` antworten oder Enter drücken, gibt der Befehl eine `Remote Control did not start`-Meldung aus, die das Verzeichnis nennt, und beendet sich mit Exit-Code 1. Führen Sie `claude rc` erneut aus, um mit `y` zu antworten.

**Vorgehensweise:**

* Vertrauen Sie dem Verzeichnis zuerst über ein Terminal: Führen Sie dort `claude` aus und akzeptieren Sie den [Workspace-Vertrauensdialog](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust), und führen Sie dann Ihren ursprünglichen Befehl erneut aus
* In Ihrem Home-Verzeichnis wechseln Sie in ein Projektverzeichnis und starten Remote Control dort

Vor v2.1.284 fragte der Befehl nie, selbst in einem Terminal.

### Workspace not trusted when running claude ultrareview

Wenn [`claude ultrareview`](https://code.claude.com/docs/de/ultrareview#trust-the-folder-before-the-review-runs) in einem Ordner, dem Sie nicht vertraut haben, nicht fragen kann, ob Sie ihm vertrauen, beendet sich die Ausführung mit Exit-Code 1, bevor das Review startet:

```text theme={null}
Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. Or, in a script or CI job, pass `--trust-workspace` to trust the folder for this run only.
```

Zum Beispiel kann der Unterbefehl nicht fragen, wenn seine Standardeingabe oder Standardausgabe kein Terminal ist. Wenn Sie die Ausgabe in eine Datei schreiben, wie bei `claude ultrareview --json > findings.json`, ist die Standardausgabe kein Terminal.

**Was zu tun ist:**

* In einem Skript oder CI-Job hängen Sie `--trust-workspace` an, um dem Ordner für diesen Lauf zu vertrauen: `claude ultrareview --trust-workspace`. Hängen Sie es nur für Code an, dem Sie vertrauen, denn Git und Claude Code können dann Programme ausführen, die in der Git-Konfiguration und den Projekteinstellungen des Ordners genannt sind. Für einen Pull Request, dessen Code Sie nicht vertrauen, [führen Sie das Review von einem Branch aus, dem Sie vertrauen](https://code.claude.com/docs/de/ultrareview.md#trust-the-folder-before-the-review-runs).
* Auf Ihrem eigenen Rechner führen Sie `claude` in diesem Ordner aus und akzeptieren den [Workspace-Vertrauensdialog](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust), und führen dann Ihren ursprünglichen Befehl erneut aus

In einer Sitzung können `/ultrareview` und `/code-review ultra` mit `Ultrareview did not start: "<folder>" is not trusted, and this session started without asking whether you trust it` stoppen. Starten Sie `claude` in diesem Ordner, ohne dass [`IS_DEMO`](https://code.claude.com/docs/de/env-vars#variables) gesetzt ist, akzeptieren Sie den Workspace-Vertrauensdialog und führen Sie den Befehl in der neuen Sitzung aus.

Jede dieser Meldungen von `claude ultrareview` bedeutet, dass kein Review gestartet wurde und der Exit-Code 1 ist:

* **`Error: Workspace not trusted. This terminal ...`**: Das Terminal hat keine Zeilen- und Spaltenanzahl gemeldet oder kann die Vertrauensfrage und ihre Warnungen nicht darstellen. Vergrößern Sie es oder verwenden Sie ein Terminal, das seine Größe meldet, und führen Sie `claude ultrareview` dann erneut aus. Außerhalb Ihres Home-Verzeichnisses können Sie auch einmal `claude` in diesem Ordner ausführen und den Vertrauensdialog akzeptieren, damit spätere Ausführungen dort nicht mehr fragen.
* **`Error: Workspace not trusted. <folder> is your home directory`**: Da das Vertrauen für Ihr Home-Verzeichnis nie gespeichert wird, hilft es nicht, dort zuerst `claude` auszuführen. Führen Sie `claude ultrareview` stattdessen aus einem Projektverzeichnis aus, nachdem Sie dort einmal `claude` ausgeführt und den Vertrauensdialog akzeptiert haben, oder hängen Sie `--trust-workspace` an.
* **`No answer in time.` gefolgt von `Error: Workspace not trusted`**: Die Frage `Trust <folder>? [y/N]` blieb 5 Minuten lang unbeantwortet. Führen Sie `claude ultrareview` erneut aus und beantworten Sie sie.
* **`Ultrareview did not start: <folder> is not trusted`**: Sie haben bei der Frage `Trust <folder>? [y/N]` abgelehnt, zum Beispiel indem Sie `n` geantwortet oder Enter gedrückt haben. Um das Review zu starten, führen Sie `claude ultrareview` erneut aus und antworten Sie `y`.
* **``Ultrareview did not start: `--trust-workspace` takes no value``**: Auf `--trust-workspace` folgt etwas anderes als ein Flag, etwa eine PR-Nummer oder `false`. Wenn Sie dem Ordner nicht vertrauen, lassen Sie das Flag weg. Um ihm für diese Ausführung zu vertrauen, setzen Sie die PR-Nummer oder den Basis-Branch vor das Flag: `claude ultrareview 1234 --trust-workspace`.

Vor v2.1.309 akzeptierte `claude ultrareview` kein `--trust-workspace`.

### Remote Control wurde nicht gestartet, weil eine Frage unbeantwortet blieb

Diese Meldung bedeutet, dass [`claude remote-control`](https://code.claude.com/docs/de/remote-control) die in der Meldung zitierte Frage beim ersten Start gestellt und keine Antwort erhalten hat:

```text theme={null}
Remote Control did not start: "Enable Remote Control?" got no answer. Run `claude remote-control` at a terminal and answer y once; it won't ask again.
Remote Control did not start: "Choose [1/2] (default: 1):" got no answer. You can run `claude remote-control` and choose, or pass --spawn=same-dir or --spawn=worktree.
```

**Was zu tun ist:**

* **`Enable Remote Control?`**: In einem Skript oder Dienst endet die Standardeingabe, bevor jemand antworten kann. Führen Sie `claude remote-control` einmal in einem Terminal aus, als der Benutzer, unter dem Ihr Skript oder Dienst läuft, und antworten Sie mit `y`.
* **`Choose [1/2] (default: 1):`**: Führen Sie `claude remote-control` erneut aus und [wählen Sie einen Spawn-Modus](https://code.claude.com/docs/de/remote-control.md#set-the-default-spawn-mode-for-a-project), oder übergeben Sie [`--spawn=same-dir` oder `--spawn=worktree`](https://code.claude.com/docs/de/remote-control#start-a-remote-control-session), um die Frage zu überspringen

### Nicht an die Sitzungen übertragen, die Remote Control startet

Sie haben [Remote Control](https://code.claude.com/docs/de/remote-control.md) mit einem globalen `claude`-Flag vor dem Verb `remote-control` gestartet, das die von Remote Control gestarteten Sitzungen einschränken oder konfigurieren würde, etwa `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` oder `--mcp-config`. Ein vor dem Verb platziertes Flag erreicht diese Sitzungen nie. Claude Code verweigert stattdessen den Start und nennt das Flag:

```text theme={null}
Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). Pass settings with `claude remote-control --settings <file>`.
```

Globale Flags, deren Wegfall unbedenklich ist, etwa `--verbose`, `--model` oder ein von einem Wrapper eingefügtes `--session-id` oder `--plugin-dir`, lehnt Claude Code nicht ab: Es ignoriert sie, und Remote Control startet.

Claude Code verweigert den Start auch bei einem globalen Flag, das es noch nicht als unbedenklich erkennt, sodass ein in einem neueren Release hinzugefügtes Flag in dieser Meldung erscheinen kann, bis ein späteres Release es als unbedenklich kennzeichnet.

**Vorgehensweise:**

* Entfernen Sie das Flag vor dem Verb und übergeben Sie [die eigenen Optionen von Remote Control](https://code.claude.com/docs/de/remote-control.md#start-a-remote-control-session) danach; `claude remote-control --help` listet sie auf
* Wenn das abgelehnte Flag `--permission-mode` ist, führen Sie `claude remote-control --permission-mode <mode>` aus, um den Berechtigungsmodus für die von Remote Control gestarteten Sitzungen festzulegen

Vor v2.1.248 akzeptierte `claude remote-control` seine eigenen Flags nicht, wenn zuerst ein globales Flag kam, und der Befehl schlug mit einem `unknown option`-Fehler fehl.

### Remote Control wurde wegen der `--settings`-Datei nicht gestartet

Die Datei, die Sie an [`claude remote-control --settings`](https://code.claude.com/docs/de/remote-control#start-a-remote-control-session) übergeben haben, hat ein Problem:

```text theme={null}
Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON
```

**Was Sie tun können:**

* Beheben Sie das Problem, das die Meldung nennt, und führen Sie Ihren `claude remote-control`-Befehl dann erneut aus

### The settings file has changed since Remote Control started

Diese Meldung im Terminal, in dem `claude remote-control` läuft, bedeutet, dass Sitzungen nicht mit der Datei in ihrem jetzigen Zustand starten, die Sie an [`--settings`](https://code.claude.com/docs/de/remote-control#start-a-remote-control-session) übergeben haben:

```text theme={null}
Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.
```

**Was Sie tun können:**

* Um die Datei in ihrem jetzigen Zustand zu verwenden, stoppen Sie `claude remote-control` und führen Sie denselben Befehl erneut aus. Um die Sitzungen zurückzuholen, die es bedient hat, siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](https://code.claude.com/docs/de/remote-control.md#resume-sessions-after-stopping-the-server).
* Um die Einstellungen beizubehalten, mit denen Remote Control gestartet wurde, stellen Sie den Inhalt der Datei wieder so her, wie er war, und führen Sie den Befehl dann erneut aus, falls sich `claude remote-control` beendet hat

### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

Dieser Fehler bedeutet, dass der Befehl, der Ihren [Remote Control](https://code.claude.com/docs/de/remote-control.md)-Server startet, `--sandbox` oder `--no-sandbox` nach `remote-control` übergibt, und `claude remote-control` akzeptiert keines der beiden Flags. Der Server beendet sich mit Exit-Code 1, anstatt zu starten:

```text theme={null}
Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings.
Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.
```

**Vorgehensweise:**

* Entfernen Sie das Flag aus dem Befehl, auch in einem Skript oder einer Dienstdefinition, die den Server für Sie startet, und führen Sie ihn dann erneut aus
* Um die vom Server gestarteten Sitzungen in einer Sandbox auszuführen, aktivieren Sie [Sandboxing](https://code.claude.com/docs/de/sandboxing.md), indem Sie [`sandbox.enabled`](https://code.claude.com/docs/de/settings-reference#sandbox-enabled) in einer [Einstellungsdatei](https://code.claude.com/docs/de/settings.md#where-settings-live) auf `true` setzen

Beide Flags wurden in v2.1.300 aus `claude remote-control` entfernt, sodass ein für eine frühere Version geschriebener Befehl noch eines davon enthalten kann.

### claude import ist in diesem Build noch nicht verfügbar

Sie haben [`claude import`](https://code.claude.com/docs/de/cli-reference#cli-commands) ausgeführt, und Claude Code hat festgestellt, dass der Importablauf ausgeschaltet ist, daher beendet sich der Befehl mit Exit-Code 1, anstatt den Import zu starten. Vor v2.1.222 behandelte ein Build mit ausgeschaltetem Importablauf `import` als Prompt und startete eine interaktive Sitzung, anstatt diese Meldung auszugeben.

```text theme={null}
`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
```

Claude Code schaltet `claude import` über ein Feature-Flag ein, das es von Anthropic abruft und auf der Festplatte zwischenspeichert. Diese Meldung bedeutet, dass der zwischengespeicherte Wert ausgeschaltet ist. Die Ursache ist in der Regel eine der folgenden:

* Sie haben seit der Installation keine Sitzung gestartet, daher hat Claude Code das Flag noch nicht abgerufen. Das erste `claude import` kann diese Meldung ausgeben, selbst wenn die Funktion für Sie verfügbar ist.
* Sie verwenden Claude Code über Amazon Bedrock, die Agent Platform von Google Cloud, Microsoft Foundry oder Claude Platform on AWS oder über ein [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway#availability-and-limitations). Claude Code ruft in diesen Sitzungen keine Feature-Flags ab, daher bleibt `claude import` nicht verfügbar.
* Sie haben `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/de/env-vars#variables), `DISABLE_GROWTHBOOK` oder [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/de/env-vars) gesetzt, die das Abrufen von Feature-Flags ausschalten, daher bleibt `claude import` nicht verfügbar.

**Vorgehensweise:**

* Bei einer frischen Installation starten Sie `claude`, warten, bis die Sitzung geladen ist, beenden sie und führen `claude import` erneut aus
* Wo das Abrufen von Feature-Flags ausgeschaltet bleibt, richten Sie die Konfiguration selbst ein: Fügen Sie MCP-Server mit [`claude mcp add`](https://code.claude.com/docs/de/mcp#installing-mcp-servers) hinzu und erstellen Sie die [`CLAUDE.md`-Dateien](https://code.claude.com/docs/de/memory#how-claude-md-files-load), [Skills und Befehle](https://code.claude.com/docs/de/skills.md#where-skills-live) sowie [Subagenten](https://code.claude.com/docs/de/sub-agents.md#choose-the-subagent-scope), die Sie übernehmen möchten. Die Meldung nennt außerdem `~/.claude/settings.json`. Von der Konfiguration, die `claude import` übernimmt, enthält diese Datei nur den [Berechtigungsmodus](https://code.claude.com/docs/de/settings-reference.md#permission-settings); Claude Code liest keine MCP-Server daraus.

### Claude-Code-Konfiguration konnte nicht gelesen werden

Sie haben [`claude import`](https://code.claude.com/docs/de/cli-reference#cli-commands) ausgeführt, während Claude Code `~/.claude.json` nicht parsen konnte, die Datei, in der es Ihre Kontodaten und den projektbezogenen Zustand speichert. Der Unterbefehl liest diese Datei, um die Verfügbarkeit zu prüfen, zeigt aber nicht den Wiederherstellungsdialog an, den die interaktive Sitzung anzeigt, daher beendet er sich mit Exit-Code 1. Vor v2.1.222 startete `claude import` bei einer unlesbaren Konfigurationsdatei eine interaktive Sitzung, deren Wiederherstellungsdialog die Datei behandelte.

```text theme={null}
Could not read Claude Code config — run `claude` with no arguments to recover it.
```

**Vorgehensweise:**

* Führen Sie `claude` ohne Argumente aus. Claude Code erkennt die ungültige Datei und bietet an, sie zurückzusetzen. Führen Sie dann `claude import` erneut aus.
* Um manuelle Änderungen zu behalten, korrigieren Sie stattdessen die JSON-Syntax in `~/.claude.json` in einem Editor und führen Sie `claude import` dann erneut aus

### Ein 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 die anderen ausgewählten Server trotzdem und gibt für jeden Server, den er nicht hinzufügen konnte, eine Zeile aus. Vor v2.1.205 stoppte der erste fehlgeschlagene Server den Import.

```text theme={null}
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 Namensprüfung: Claude Desktop erlaubt Zeichen in Servernamen, etwa Leerzeichen und Punkte, die `claude mcp` auf Buchstaben, Ziffern, Bindestriche und Unterstriche beschränkt. Weitere Gründe sind eine Serverkonfiguration, die die Validierung nicht besteht, und ein Server, der durch die [MCP-Richtlinie](https://code.claude.com/docs/de/managed-mcp.md) Ihrer Organisation blockiert ist.

**Vorgehensweise:**

* Benennen Sie den Server in `claude_desktop_config.json` so um, dass er nur Buchstaben, Ziffern, Bindestriche und Unterstriche enthält, und führen Sie `claude mcp add-from-claude-desktop` dann erneut aus
* 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](https://code.claude.com/docs/de/mcp.md#import-mcp-servers-from-claude-desktop).

### MCP-Server kann nicht zum verwalteten Geltungsbereich hinzugefügt werden

Sie haben `claude mcp add` oder `claude mcp add-json` mit `--scope managed` ausgeführt. Dieser Geltungsbereich enthält die Server, die Ihre Organisation über die verwaltete Einstellung [`managedMcpServers`](https://code.claude.com/docs/de/settings-reference#managedmcpservers) bereitstellt. Claude Code liest sie nur aus verwalteten Einstellungen, daher kann der Befehl keinen Server in diesen Geltungsbereich schreiben.

```text theme={null}
Cannot add MCP server to scope: managed
```

**Vorgehensweise:**

* Fügen Sie den Server zu einem Geltungsbereich hinzu, in den Sie schreiben können: `local`, `user` oder `project`. Ohne `--scope` verwendet der Befehl `local`. Siehe [MCP-Installationsgeltungsbereiche](https://code.claude.com/docs/de/mcp.md#mcp-installation-scopes)
* Um den Server allen Benutzern in Ihrer Organisation bereitzustellen, fügen Sie ihn in den verwalteten Einstellungen, die Sie verteilen, zu [`managedMcpServers`](https://code.claude.com/docs/de/settings-reference#managedmcpservers) hinzu

### MCP-Server kann nicht hinzugefügt werden, wenn verwaltete Einstellungen nur Plugin-Server erlauben

Sie haben `claude mcp add` oder `claude mcp add-json` ausgeführt, während die verwalteten Einstellungen Ihrer Organisation [`strictPluginOnlyCustomization`](https://code.claude.com/docs/de/settings-reference#strictpluginonlycustomization) auf `true` oder auf eine Liste setzen, die `mcp` enthält. Mit dieser Einstellung lädt Claude Code keine MCP-Server aus `~/.claude.json` oder `.mcp.json`, daher beendet sich der Befehl mit Exit-Code 1, anstatt einen Server zu speichern, der nie geladen würde:

```text theme={null}
Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.
```

`claude mcp add-from-claude-desktop` meldet jeden ausgewählten Server als nicht importiert, mit dieser Meldung als Grund. [`/import`](https://code.claude.com/docs/de/commands#all-commands) meldet diese Meldung für jeden MCP-Server, den es hinzuzufügen versucht, und importiert die anderen gefundenen Elemente trotzdem.

Vor v2.1.284 speicherten diese Befehle den Server und meldeten Erfolg, und der Server wurde nie geladen.

**Vorgehensweise:**

* Installieren Sie ein [Plugin](https://code.claude.com/docs/de/plugins/install.md), das den Server bereitstellt
* Bitten Sie Ihren Administrator, den Server in einem [Plugin](https://code.claude.com/docs/de/plugins/org.md) zu verteilen oder ihn über [`managedMcpServers`](https://code.claude.com/docs/de/settings-reference#managedmcpservers) bereitzustellen, falls es sich um einen Remote-HTTP- oder SSE-Server handelt

### .mcp.json kann nicht gelesen werden

Ein Befehl, der die [`.mcp.json`](https://code.claude.com/docs/de/mcp#project-scope) des Projekts liest, etwa `claude mcp add` oder `claude mcp add-json` mit `--scope project` oder `claude mcp remove`, hat festgestellt, dass die Datei in Ihrem aktuellen Verzeichnis keine reguläre Datei oder größer als 2 MiB ist, daher beendet er sich mit diesem Fehler, anstatt die Datei zu lesen.

```text theme={null}
Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
```

Vor v2.1.257 ließ ein FIFO unter `.mcp.json` den Befehl ohne Ausgabe endlos warten, und ein Symlink auf eine Gerätedatei wie `/dev/zero` ließ den Speicherverbrauch wachsen, bis der Prozess beendet wurde.

**Vorgehensweise:**

* Prüfen Sie, was sich unter `.mcp.json` in Ihrem aktuellen Verzeichnis befindet. Ersetzen Sie es durch eine gewöhnliche JSON-Datei im [Format für den Projekt-Geltungsbereich](https://code.claude.com/docs/de/mcp.md#project-scope) oder löschen Sie es, und führen Sie den Befehl dann erneut aus.

### MCP-Server wurde nicht gespeichert oder entfernt

Dieser Fehler bedeutet, dass ein Befehl wie `claude mcp add` oder `claude mcp remove` Ihre Änderung nicht in `~/.claude.json` übernommen hat. Möglicherweise haben andere Claude-Code-Prozesse die Datei gesperrt gehalten, oder die Datei ist schreibgeschützt oder durch eine Sandbox geschützt.

```text theme={null}
MCP server "example" was not saved to /home/user/.claude.json. If other Claude Code processes use that file, they may have kept it locked: add the server again, with CLAUDE_CODE_CONFIG_LOCK_WAIT_MS=60000 set to wait up to a minute. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox first.
```

Nach einem Entfernen lautet die Meldung `was not removed from` statt `was not saved to` und `remove the server again` statt `add the server again`. Bei einem Server im Geltungsbereich `local` folgt auf den Pfad das Projektverzeichnis, zu dem der Eintrag gehört, als `(local scope for /path/to/project)`.

**Vorgehensweise:**

* **Andere Claude-Code-Prozesse laufen**: Der Befehl wartet etwa 10 bis 20 Sekunden auf die Sperre der Datei und gibt dann auf, ohne zu schreiben. Führen Sie denselben Befehl erneut aus und setzen Sie dabei [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/de/env-vars#variables) auf eine längere Wartezeit in Millisekunden, etwa `60000`.
* **Die Datei ist schreibgeschützt oder durch eine Sandbox geschützt**: Machen Sie die in der Meldung genannte Datei beschreibbar und führen Sie denselben Befehl zum Hinzufügen oder Entfernen erneut aus, oder führen Sie diesen Befehl außerhalb der Sandbox aus.

Vor v2.1.283 meldeten `claude mcp add`, `claude mcp add-json` und `claude mcp remove` Erfolg, selbst wenn die Änderung die Datei nicht erreichte. Vor v2.1.318 erwähnte die Meldung die Sperre nicht, und Claude Code las [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/de/env-vars#variables) nicht.

### MCP-Server wurde möglicherweise nicht gespeichert oder entfernt

Sie haben `claude mcp add`, `claude mcp add-json` oder `claude mcp remove` für einen Server im [Geltungsbereich](https://code.claude.com/docs/de/mcp.md#mcp-installation-scopes) `user` oder `local` ausgeführt, und Claude Code konnte `~/.claude.json` nicht erneut lesen, um die Änderung zu bestätigen. Die Änderung befindet sich möglicherweise auf der Festplatte, möglicherweise aber auch nicht. Die Klammern nach `to confirm the change` nennen den Grund.

```text theme={null}
MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
```

Nach einem Entfernen lautet die Meldung `may not have been removed` und endet mit `then remove the server again if it is still listed`. Wenn der Grund `the file was not found` ist, ist der Server möglicherweise noch konfiguriert.

Vor v2.1.283 meldeten die Befehle Erfolg, selbst wenn die Änderung nicht bestätigt werden konnte.

**Vorgehensweise:**

* Führen Sie `claude mcp get <name>` aus, um zu prüfen, ob die Änderung auf der Festplatte ist. Bei einem Server im Geltungsbereich `local` führen Sie den Befehl aus dem Projektverzeichnis aus, zu dem der Server gehört, da der lokale Geltungsbereich projektspezifisch ist.
* Wenn der Server nach einem Hinzufügen fehlt oder nach einem Entfernen weiterhin aufgeführt ist, führen Sie denselben Hinzufügen- oder Entfernen-Befehl erneut aus.

### Server wird von Anthropic gehostet und unterstützt kein lokales OAuth

Sie haben eine Anmeldung für einen MCP-Server gestartet, dessen URL auf einen von Anthropic gehosteten Konnektor-Host verweist, der sich über einen Identitätsanbieter eines Drittanbieters authentifiziert. Zu diesen Hosts gehören `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` und `gcal.mcp.claude.com`. Claude Code weigert sich, seinen lokalen OAuth-Ablauf für diese Hosts sowohl aus dem `/mcp`-Panel als auch über `claude mcp login` zu starten, weil [ihre Anmeldung nur über claude.ai funktioniert](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai).

```text theme={null}
"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
```

**Vorgehensweise:**

* Entfernen Sie Ihren Eintrag mit `claude mcp remove <name>`, damit er den claude.ai-Konnektor unter derselben URL nicht verdecken kann
* Verbinden Sie den Dienst nach dem Entfernen unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors), während Sie mit dem Konto angemeldet sind, das Sie in Claude Code verwenden. Nach dem Verbinden [erscheint der Konnektor automatisch in Claude Code](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai), sofern Ihre aktive Authentifizierungsmethode eine Anmeldung mit einem claude.ai-Abonnement ist

### Server hat den vom konfigurierten headersHelper erzeugten Authorization-Header abgelehnt

Ein MCP-Server, dessen [`headersHelper`](https://code.claude.com/docs/de/mcp#use-dynamic-headers-for-custom-authentication) den `Authorization`-Header liefert, hat die Verbindung mit HTTP 401 oder 403 beantwortet, daher meldet Claude Code die Verbindung als fehlgeschlagen. Da der Helper den `Authorization`-Header liefert, [fällt Claude Code für den Server nicht auf OAuth zurück](https://code.claude.com/docs/de/mcp.md#authenticate-with-remote-mcp-servers):

```text theme={null}
Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
```

Claude Code führt den Helper bei jedem Verbindungsversuch erneut aus, sodass ein erneuter Versuch nach einer vorübergehenden Ablehnung, etwa bei einer Race Condition während der Token-Rotation, mit frischen Anmeldedaten erfolgreich sein kann.

**Vorgehensweise:**

* Führen Sie den `headersHelper`-Befehl selbst so aus, wie Claude Code ihn ausführt: aus dem [Verzeichnis, in dem Claude Code ihn ausführt](https://code.claude.com/docs/de/mcp.md#where-the-helper-runs), mit den [Umgebungsvariablen, die Claude Code dafür setzt](https://code.claude.com/docs/de/mcp.md#use-dynamic-headers-for-custom-authentication), und ohne die [Anmeldedaten-Variablen, die Claude Code entfernt](https://code.claude.com/docs/de/mcp.md#which-variables-a-helper-can-read), bei einem Server aus einer Projekt-`.mcp.json`, einem Plugin oder einer Projekt-Agentendatei. Prüfen Sie, ob er einen `Authorization`-Wert ausgibt, den der Endpunkt des Servers akzeptiert
* Nachdem Sie den Helper oder die Quelle seiner Anmeldedaten korrigiert haben, wählen Sie den Server in `/mcp` aus und wählen Sie **Reconnect**

Vor v2.1.248 führte Claude Code für einen Server, dessen Helper den `Authorization`-Header lieferte, eine OAuth-Erkennung aus. Diese Erkennung konnte mit `Incompatible auth server: does not support dynamic client registration` fehlschlagen, anstatt die abgelehnten Anmeldedaten zu melden.

### MCP server rejected the elicitation capability

Ein MCP-Server, der auf Java MCP SDK 0.11.0 bis 0.17.0 aufbaut, hat die Verbindung abgelehnt. Diese SDK-Versionen können die [Elicitation-Modi](https://code.claude.com/docs/de/mcp.md#elicitation-modes-claude-code-declares) `form` und `url` nicht parsen, die Claude Code in seinem Handshake deklariert. Die Meldung lautet:

```text theme={null}
This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability. Set "bareElicitationCapability": true for it, or upgrade to Java MCP SDK 0.17.1+ (Spring AI 1.0.7+ or 1.1.6+).
```

**Was Sie tun können:**

* Aktualisieren Sie den Server auf Java MCP SDK 0.17.1 oder höher oder auf eines der in der Meldung genannten Spring-AI-Releases
* Oder fügen Sie `"bareElicitationCapability": true` zum Eintrag dieses Servers in Ihrer MCP-Konfiguration hinzu und starten Sie Claude Code dann neu. Das Feld wird bei stdio-, `sse`-, `http`- und `ws`-Einträgen akzeptiert und erfordert Claude Code v2.1.281 oder höher

Dieser `.mcp.json`-Eintrag setzt das Feld für einen HTTP-Server:

```json theme={null}
{
  "mcpServers": {
    "inventory": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "bareElicitationCapability": true
    }
  }
}
```

Nach dem Neustart zeigt `/mcp` den Server als verbunden an. Claude Code deklariert nur gegenüber diesem Server den Formularmodus, entfernen Sie das Feld daher, sobald Sie ihn aktualisiert haben.

Ein Server kann auch mit seinem eigenen Fehlertext fehlschlagen, etwa einem, der `Unrecognized field "form"` enthält. Es gelten dieselben Lösungen.

### MCP-Tool für Berechtigungsabfragen nicht gefunden

Das Tool, das Sie an [`--permission-prompt-tool`](https://code.claude.com/docs/de/cli-reference#cli-flags) übergeben haben, befand sich nicht unter den verbundenen MCP-Tools, als die Ausführung zum ersten Mal eine Berechtigungsentscheidung benötigte, entweder weil sich sein Server nie verbunden hat oder weil kein verbundener Server ein Tool mit diesem Namen bereitstellt. Claude Code sendet Ihren Prompt trotzdem: Die [nicht interaktive](https://code.claude.com/docs/de/headless.md) Ausführung endet beim ersten Tool-Aufruf mit diesem Fehler und Exit-Code 1, sodass sie keine Antwort liefert, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zum serverspezifischen Verbindungs-Timeout von 30 Sekunden, festgelegt durch [`MCP_TIMEOUT`](https://code.claude.com/docs/de/env-vars), darauf, dass sich dieser Server verbindet. Vor v2.1.206 wartete der Start nicht darauf, dass der Server die Verbindung abschließt, sodass auch ein langsam startender, aber funktionsfähiger Server diesen Fehler verursachte.

```text theme={null}
Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
```

Die Liste nach `Available MCP tools:` nennt die MCP-Tools, die verbunden waren.

**Vorgehensweise:**

* Prüfen Sie, ob 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 aufgeführt ist
* Bestätigen Sie, dass der Tool-Name dem Namen `mcp__<server>__<tool>` entspricht, den der Server bereitstellt
* Wenn der Server länger als 30 Sekunden zum Starten benötigt, erhöhen Sie [`MCP_TIMEOUT`](https://code.claude.com/docs/de/env-vars)

### OAuth-Callback-Port wird bereits verwendet

Wenn Sie sich mit OAuth bei einem Remote-MCP-Server anmelden, startet Claude Code einen lokalen Listener, um den Anmelde-Callback zu empfangen. Wenn der Port, den dieser Listener benötigt, von einem anderen Prozess belegt ist, schlägt die Anmeldung mit dieser Meldung fehl. Dies geschieht vor allem bei einem [festen Callback-Port](https://code.claude.com/docs/de/mcp.md#use-a-fixed-oauth-callback-port), der über die Variable [`MCP_OAUTH_CALLBACK_PORT`](https://code.claude.com/docs/de/env-vars) oder `--callback-port` festgelegt ist, da Claude Code ohne diesen einen verfügbaren Port auswählt.

```text theme={null}
OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
```

Unter Windows lautet der vorgeschlagene Befehl stattdessen `netstat -ano | findstr :<port>`.

**Vorgehensweise:**

* Führen Sie den Befehl aus der Meldung aus, um den Prozess zu finden, der den Port belegt, und beenden Sie ihn oder warten Sie, bis er fertig ist
* Wenn ein anderes Programm diesen Port dauerhaft benötigt, registrieren Sie beim Server eine andere Redirect-URI und legen Sie deren Port mit `MCP_OAUTH_CALLBACK_PORT` oder `--callback-port` fest, je nachdem, was Sie verwenden
* Starten Sie die Anmeldung dann erneut, zum Beispiel indem Sie den Server in `/mcp` auswählen

### Keine verfügbaren Ports für die OAuth-Weiterleitung

Wenn Sie sich mit [OAuth](https://code.claude.com/docs/de/mcp.md#authenticate-with-remote-mcp-servers) bei einem Remote-MCP-Server anmelden, startet Claude Code einen lokalen Listener, um den Anmelde-Callback zu empfangen. Die Anmeldung schlägt mit dieser Meldung fehl, wenn Claude Code dafür keinen lokalen Port binden kann. Etwas auf dem Rechner hindert es daran, auf `127.0.0.1` zu lauschen, zum Beispiel Sicherheitssoftware oder eine Sandbox-Richtlinie, die lokale Listener verbietet.

```text theme={null}
No available ports for OAuth redirect
```

Vor v2.1.268 fiel Claude Code nicht auf einen vom Betriebssystem zugewiesenen Port zurück, sodass die Meldung auch erschien, wenn nur die selbst gewählten Ports nicht gebunden werden konnten. Das kann auf Windows-Hosts passieren, auf denen Hyper-V Portbereiche reserviert, die die Ports abdecken, aus denen Claude Code auswählt.

**Vorgehensweise:**

* Prüfen Sie, ob Sicherheitssoftware oder eine Sandbox-Richtlinie Prozesse daran hindert, auf `127.0.0.1` zu lauschen, und erlauben Sie Claude Code, einen lokalen Port zu binden
* Starten Sie die Anmeldung dann erneut, zum Beispiel indem Sie den Server in `/mcp` auswählen

### /security-review schlägt ohne origin/HEAD fehl

[`/security-review`](https://code.claude.com/docs/de/commands#all-commands) erstellt seinen Review-Kontext, indem es einen Diff Ihres Branches gegen `origin/HEAD` bildet, die lokale Ref, die festhält, welcher Branch auf Ihrem `origin`-Remote der Standard ist. Wenn diese Ref nicht existiert, schlagen die git-Befehle, die den Diff sammeln, fehl, und das Review stoppt, bevor es beginnt.

```text theme={null}
Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
```

Die Meldung kann stattdessen `git log` oder einen anderen `git diff` zitieren. Git erstellt `origin/HEAD` nur, wenn das Remote einen Standard-Branch bekanntgibt und Ihre Fetch-Refspec ihn abdeckt, was bei einem vollständigen `git clone` eines Remotes mit Commits der Fall ist. In diesen Konstellationen fehlt die Ref:

* Ein Single-Branch- oder CI-Checkout, der eine zu enge Refspec abruft
* Ein Remote, dessen serverseitiges HEAD auf einen Branch verweist, den niemand gepusht hat
* Ein Repository ohne `origin`-Remote oder eines, das Sie nie abgerufen haben

Claude Code zeigt denselben Fehler für jeden Skill, der [dynamischen Kontext einfügt](https://code.claude.com/docs/de/skills.md#when-an-injected-command-fails), und ein fehlgeschlagener eingefügter Befehl bricht den Aufruf dieses Skills ab.

Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:

* `Shell command permission check failed for pattern "..."`: Die Berechtigungsprüfung des Befehls hat ihn nicht zugelassen. Unter [Berechtigungsprüfungen für eingefügte Befehle](https://code.claude.com/docs/de/skills.md#permission-checks-on-injected-commands) erfahren Sie, welche Ergebnisse in jedem Berechtigungsmodus abbrechen und wann `allowed-tools` einen Befehl vorab genehmigt
* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: Das Frontmatter des Skills verlangt bash auf einem Rechner ohne bash. Installieren Sie Git for Windows oder ändern Sie das Frontmatter in `shell: powershell`. Siehe [Wie eingefügte Befehle ausgeführt werden](https://code.claude.com/docs/de/skills.md#how-injected-commands-run)

**Vorgehensweise:**

* Erstellen Sie die Ref, indem Sie den Standard-Branch Ihres Remotes benennen: `git remote set-head origin <default-branch>`. Dies funktioniert, sofern die lokale Tracking-Ref `origin/<default-branch>` existiert. Falls nicht, wie bei Single-Branch-Klonen, rufen Sie zuerst den Branch ab: Führen Sie `git remote set-branches --add origin <branch>` aus, dann `git fetch origin`, und führen Sie dann den set-head-Befehl erneut aus. Führen Sie `/security-review` erneut aus.
* Wenn Sie den Branch lieber nicht benennen möchten, führen Sie `git fetch origin` und dann `git remote set-head origin --auto` aus, das das Remote fragt, welcher Branch sein Standard ist. Es schlägt mit `error: Cannot determine remote HEAD` fehl, wenn das Remote keinen Standard-Branch bekanntgibt, weil es leer ist oder sein HEAD auf einen Branch verweist, den niemand gepusht hat; benennen Sie den Branch dann explizit. Es schlägt mit `error: Not a valid ref` fehl, wenn Ihr Klon diesen Branch nicht abruft; erweitern Sie dann zuerst die Refspec wie oben beschrieben.
* Wenn das Repository kein Remote hat, fügen Sie eines mit `git remote add origin <url>` hinzu und rufen Sie es ab, bevor Sie die Ref erstellen. Wenn das Remote leer ist, pushen Sie zuerst Ihren Branch mit `git push -u origin HEAD` und benennen Sie diesen Branch im set-head-Befehl; `origin/HEAD` verweist dann auf den Branch, den Sie gerade gepusht haben, sodass `/security-review` einen leeren Diff sieht, bis der Branch davon abweicht.

### No shell command in a skill or command was run

`No shell command in <name> was run` bedeutet, dass ein `` !`<command>` ``-[Befehl für dynamischen Kontext](https://code.claude.com/docs/de/skills.md#inject-dynamic-context) in dieser Skill- oder Befehlsdatei ein Zeichen enthält, das das Bash- oder PowerShell-Tool ablehnt:

* **Beide Tools**: ein rohes Steuerzeichen außer Tabulator oder Zeilenumbruch
* **PowerShell-Tool**: zusätzlich U+FEFF oder U+180E

Die Meldung endet mit dem abgelehnten Befehl, wobei jedes abgelehnte Zeichen als `�` angezeigt wird, wie in diesem Beispiel für das Bash-Tool:

```text theme={null}
No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.
build.sh --target�dist
```

**Vorgehensweise:**

* Suchen Sie jedes `�` im Befehl, der am Ende der Meldung zitiert wird. Entfernen Sie das Zeichen, für das es steht, aus der [Skill- oder Befehlsdatei](https://code.claude.com/docs/de/skills.md#where-skills-live) oder aus den Argumenten oder [Optionen](https://code.claude.com/docs/de/plugins/manifest-reference.md#user-configuration), die in die Datei eingesetzt werden.

### Skill, Befehl oder Hook über dem Limit von 4.000.000 Zeichen

Eine Meldung mit `more than 4,000,000 characters` bedeutet, dass ein Skill, ein Befehl oder ein [Prompt- oder Agent-Hook](https://code.claude.com/docs/de/hooks.md#prompt-and-agent-hook-fields) nicht ausgeführt wurde. Wenn Sie langen Text als Argumente eingefügt haben, speichern Sie ihn in einer Datei, führen Sie `/clear` aus, da der Text in der Konversation verbleibt, und übergeben Sie dann den Pfad der Datei. Außerhalb von [Code Mode](https://code.claude.com/docs/de/code-mode.md#tool-call-refused-by-a-hook) blockiert ein `PreToolUse`-Prompt- oder Agent-Hook über dem Limit den Aufruf nicht. Verwenden Sie einen [Command-Hook](https://code.claude.com/docs/de/hooks.md#command-hook-fields), der kein solches Limit hat.

### Bei Verwendung von `--print` muss eine Eingabe angegeben werden

Das bloße `claude` benötigt ein Terminal als stdout, um die interaktive Oberfläche zu starten. Wenn stdout umgeleitet ist oder die Konsole kein echtes Terminal ist, etwa bei PowerShell ISE und manchen IDE-Ausgabebereichen, läuft `claude` stattdessen [nicht interaktiv](https://code.claude.com/docs/de/headless.md). Das ist derselbe Modus wie `claude -p`, der einen Prompt erfordert, daher nennt die Meldung `--print`, selbst wenn Sie das Flag nicht übergeben haben. Die Übergabe von `-p`/`--print` ohne Prompt und ohne etwas über stdin Weitergeleitetes erzeugt überall denselben Fehler.

```text theme={null}
Error: Input must be provided either through stdin or as a prompt argument when using --print
```

**Vorgehensweise:**

* Für die interaktive Nutzung führen Sie `claude` in einem echten Terminal aus: Windows Terminal oder die PowerShell-Konsole statt ISE und das integrierte Terminal Ihrer IDE statt eines Ausgabebereichs
* Für die einmalige Nutzung übergeben Sie den Prompt: `claude -p "your question"`, oder leiten Sie ihn mit `echo "your question" | claude -p` weiter

### Claude Code kann die Tastatur hier nicht lesen

Sie haben `claude` ohne [`-p`](https://code.claude.com/docs/de/headless) ausgeführt, was eine [interaktive Sitzung](https://code.claude.com/docs/de/interactive-mode.md) startet, aber dessen Standardeingabe ist kein Terminal. Etwas hat sie über eine Pipe verbunden oder umgeleitet, oder das Programm, das `claude` gestartet hat, hat einen eigenen Eingabestrom bereitgestellt.

Eine interaktive Sitzung benötigt ein Terminal, aus dem sie Ihre Tastatureingaben liest, und was Claude Code ohne eines tut, hängt von Ihrer Plattform ab:

* **Windows**: Claude Code gibt die Meldung auf stderr aus und beendet sich mit Exit-Code 1, anstatt die Oberfläche zu starten
* **macOS und Linux**: Claude Code liest Ihre Tastatureingaben aus `/dev/tty` und startet die Sitzung, wobei weitergeleiteter Text Ihr erster Prompt ist. Sie sehen die Meldung, wenn `/dev/tty` nicht geöffnet werden kann, und ihre erste Zeile nennt `/dev/tty` anstelle der Windows-Formulierung.

Unter Windows lautet die Meldung:

```text theme={null}
Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.
Run claude directly in Windows Terminal, PowerShell, or Command Prompt, without piping or redirecting its input.
To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).
```

**Vorgehensweise:**

* Um interaktiv zu arbeiten, führen Sie `claude` direkt in einem Terminal aus, ohne seine Eingabe über eine Pipe zu verbinden oder umzuleiten
* Um eine Antwort ohne die interaktive Oberfläche zu erhalten, zum Beispiel aus einem Skript, fügen Sie `-p` hinzu und übergeben Sie den Prompt als Argument oder über stdin, wie in `claude -p "your question"` oder `echo "your question" | claude -p`. Dasselbe funktioniert mit `--continue` und `--resume <session-id>`.

Vor v2.1.287 startete Claude Code die Oberfläche, anstatt diese Meldung auszugeben, und zeigte dann entweder nichts auf dem Bildschirm an oder schlug mit einem Fehler fehl, der `Raw mode is not supported` enthielt.

Wenn Sie `Raw mode is not supported` stattdessen während `claude install` sehen, siehe [`Raw mode is not supported` während der Installation](https://code.claude.com/docs/de/troubleshoot-install#raw-mode-is-not-supported-during-install).

### Eingabe enthielt nur Leerraum

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) lehnt Claude Code einen Prompt, der ausschließlich aus Leerzeichen, Tabulatoren oder Zeilenumbrüchen besteht, ab, anstatt ihn zu senden, weil die API Nachrichten ohne sichtbaren Text ablehnt. Welche Meldung Sie sehen, hängt davon ab, woher der leere Prompt stammt:

* **Prompt-Argument oder weitergeleitetes stdin für `claude -p`**: `claude` beendet sich mit `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`
* **An eine laufende `--input-format stream-json`- oder [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Sitzung gesendete Nachricht**: Claude Code beendet den Turn, ohne das Modell aufzurufen, und die Sitzung bleibt nutzbar. Die Ablehnung erscheint als Informationsmeldung und als Ergebnistext des Turns: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`

Vor v2.1.229 sendete Claude Code die nur aus Leerraum bestehende Nachricht an die API, die die Anfrage mit einem 400-Fehler ablehnte.

**Vorgehensweise:**

* Fügen Sie sichtbaren Text in den Prompt ein. Wenn ein Skript den Prompt aus einer Variablen oder Datei erstellt, prüfen Sie vor dem Aufruf von Claude Code, dass die Quelle nicht leer ist.

### stream-json-Eingabe enthielt über 256M Zeichen ohne Zeilenumbruch

Ihr Programm hat über stdin mehr als 268.435.456 Zeichen ohne Zeilenumbruch an eine `claude -p --input-format stream-json`-Ausführung gesendet, daher gibt Claude Code diesen Fehler auf stderr aus und beendet sich mit Exit-Code 1, anstatt weitere Eingaben zu puffern. Die Meldung gibt dieses Budget als `256M` an. Vor v2.1.257 pufferte Claude Code solche Eingaben unbegrenzt, wodurch der Speicherverbrauch wuchs, bis der Prozess abstürzte oder beendet wurde.

```text theme={null}
Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
```

Eine so lange Eingabe ohne Zeilenumbruch bedeutet in der Regel, dass der Erzeuger überhaupt kein stream-json-Erzeuger ist, etwa eine Binärdatei oder reine Log-Ausgabe, die versehentlich weitergeleitet wurde. Eine einzelne Nachricht über dem Budget scheitert an derselben Prüfung.

**Vorgehensweise:**

* Prüfen Sie, was an stdin weitergeleitet wird. Mit [`--input-format stream-json`](https://code.claude.com/docs/de/cli-reference#cli-flags) muss jede Nachricht eine mit Zeilenumbruch abgeschlossene JSON-Zeile sein
* Um stattdessen reinen Text zu senden, lassen Sie `--input-format stream-json` weg; `claude -p` liest standardmäßig einen Prompt als reinen Text aus stdin

### Unbekannter Befehl

In einer interaktiven Terminalsitzung haben Sie einen `/`-Namen abgesendet, der keinem Befehl in dieser Sitzung entspricht, daher meldet Claude Code den Namen, anstatt etwas auszuführen:

```text theme={null}
Unknown command: /hepl. Did you mean /help?
```

Claude Code schlägt den nächstliegenden Befehlsnamen oder Alias vor, den das Menü in dieser Sitzung auflistet. Wenn nichts nahe liegt, endet die Meldung nach dem Namen. Die Ursache ist in der Regel eine der folgenden:

* Ein Tippfehler, etwa `/hepl` statt `/help`. [Wie das Befehlsmenü Ihre Eingabe abgleicht](https://code.claude.com/docs/de/commands.md#how-the-command-menu-matches-what-you-type) beschreibt, wie Sie vor dem Absenden einen nahen Treffer auswählen
* Ein Befehl, der existiert, aber in dieser Sitzung nicht verfügbar ist, weil eine Voraussetzung nicht erfüllt ist, etwa Ihre Plattform, Ihr Plan oder Ihre Authentifizierungsmethode. Siehe den Eintrag für [`/web-setup`](https://code.claude.com/docs/de/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command), [`/schedule`](https://code.claude.com/docs/de/routines#schedule-returns-unknown-command) oder [`/auto-mode-setup`](https://code.claude.com/docs/de/auto-mode-config#auto-mode-setup-returns-unknown-command). Manche Befehle antworten mit einer eigenen Meldung, wenn die Richtlinie Ihrer Organisation sie deaktiviert, etwa [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
* Ein Befehl aus einem [Plugin](https://code.claude.com/docs/de/plugins/overview.md) oder [MCP-Server](https://code.claude.com/docs/de/mcp.md#use-mcp-prompts-as-commands), das bzw. der in dieser Sitzung nicht installiert oder verbunden ist

Claude Code antwortet auf einen nicht zugeordneten `/`-Namen nur in einer interaktiven Terminalsitzung auf diese Weise. In jeder anderen Sitzung sendet es den Prompt stattdessen als normale Nachricht an Claude, mit dem Hinweis, dass der Befehl nicht ausgeführt wurde, und einer Liste der Befehle, die Claude in der Sitzung ausführen kann. Zu diesen Sitzungen gehören:

* `-p`-Ausführungen
* [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Anwendungen
* Der Code-Tab der [Desktop-App](https://code.claude.com/docs/de/desktop.md)
* Das Chat-Panel der [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md)
* [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md) und [geplante Cloud-Aufgaben](https://code.claude.com/docs/de/routines.md)

Bei einem integrierten Befehl, der in einer dieser Sitzungen nicht ausgeführt werden kann, antwortet Claude Code weiterhin, dass der Befehl nicht verfügbar ist, statt ihn an Claude zu senden. Vor v2.1.274 sendeten nur Cloud-Sitzungen und geplante Cloud-Aufgaben einen nicht zugeordneten Namen an Claude. Vor v2.1.273 antworteten auch sie mit `Unknown command`.

Claude Code behandelt nicht jeden Prompt, der mit `/` beginnt, als Befehl. Es sendet den Prompt als normale Nachricht an Claude, wenn das erste Wort nach dem `/` mit einem Satzzeichen beginnt, etwa das `/--`, das einen Lean-Doc-Kommentar einleitet, oder ein Pfad wie `/var/log/syslog` ist.

Vor v2.1.236 führte Claude Code, wenn Sie `Enter` drückten, während das Befehlsmenü einen nahen Treffer für den eingegebenen Namen auflistete, diesen Treffer aus, sodass ein Tippfehler wie `/hepl` `/help` ausführte, anstatt diese Meldung zu erzeugen.

**Vorgehensweise:**

* Führen Sie den vorgeschlagenen Namen aus oder geben Sie `/` gefolgt von einem Teil des Namens ein, um zu sehen, was in dieser Sitzung verfügbar ist
* Wenn Claude Code einen dokumentierten Befehl als unbekannt meldet, prüfen Sie dessen Zeile in der [Befehlsreferenz](https://code.claude.com/docs/de/commands.md) auf die genannte Voraussetzung

### Diff ist für ultrareview zu groß

Der Diff zwischen Ihrem Branch und dem Basis-Branch, einschließlich nicht committeter und gestagter Änderungen, überschreitet die Größenlimits für ein [ultrareview](https://code.claude.com/docs/de/ultrareview.md), daher lehnen `/code-review ultra` und der Unterbefehl `claude ultrareview` das Review ab, bevor die Cloud-Sitzung startet. Ein abgelehntes Review verbraucht keinen kostenlosen Durchlauf und verrechnet kein Nutzungsguthaben. Die Meldung nennt die geltenden Limits, die Größe Ihres Diffs und die Dateien, die die meisten geänderten Zeilen beitragen. Vor v2.1.216 zeigte die Meldung nur die rohe Diff-Statistik.

```text theme={null}
Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
```

Für das Review eines Pull Requests gelten dieselben Limits; diese Form der Meldung beginnt mit `PR #<N> is too large for ultrareview` und nennt die Datei- und Zeilenzahlen des PR.

**Vorgehensweise:**

* Übergeben Sie einen Basis-Branch, der näher an Ihrer Arbeit liegt, etwa `/code-review ultra develop`, damit das Review nur den Diff gegen diesen Branch abdeckt
* Teilen Sie die Änderung in kleinere Branches auf und lassen Sie jeden einzeln reviewen. Die in der Meldung genannten Dateien tragen die meisten geänderten Zeilen bei, verschieben Sie daher zuerst diese in einen eigenen Branch.

### Merge-Base mit dem Basis-Branch konnte nicht gefunden werden

`/code-review ultra` und der Unterbefehl `claude ultrareview` prüfen den Diff zwischen Ihrem Branch und einem Basis-Branch, wofür ein gemeinsamer Commit der beiden nötig ist. Wenn `git merge-base` keinen findet, lehnt Claude Code das Review ab, bevor die Cloud-Sitzung startet. Bei einem Klon, den Claude Code als vollständig verifizieren kann und der mindestens einen Branch hat, fällt es darauf zurück, [jede getrackte Datei zu reviewen](https://code.claude.com/docs/de/ultrareview.md#diff-limits-and-fallbacks), anstatt abzulehnen. Sie sehen diese Ablehnung, wenn der Basis-Branch überhaupt nicht gefunden werden kann, wenn Claude Code nicht verifizieren kann, dass Ihr Klon vollständig ist, oder in dem seltenen Repository, in dem der Diff über den gesamten Baum nicht möglich ist, etwa beim SHA-256-Objektformat.

```text theme={null}
Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
```

Der Hinweis nach dem ersten Satz hängt davon ab, was Claude Code festgestellt hat:

* **Sie haben keinen Basis-Branch übergeben**: Claude Code hat mit dem Standard-Branch des Repositorys verglichen und schlägt vor, Ihre Basis explizit zu übergeben, wie im obigen Beispiel
* **Sie haben einen Basis-Branch übergeben, der bereits in Ihrem Klon vorhanden war**: Der Hinweis lautet ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
* **Sie haben einen Basis-Branch übergeben, der nicht in Ihrem Klon vorhanden war**: Claude Code hat ihn vor dem Vergleich von origin abgerufen. Der Hinweis lautet ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; wenn Claude Code nicht feststellen kann, ob Ihr Klon flach ist, schlägt es stattdessen `git fetch --unshallow origin` vor. Vor v2.1.221 schlug der Hinweis für jeden abgerufenen Basis-Branch `git fetch --unshallow origin` vor, und bei einem vollständigen Klon schlägt dieser Befehl mit `fatal: --unshallow on a complete repository does not make sense` fehl.

**Vorgehensweise:**

* Wenn ein anderer Branch Ihre tatsächliche Basis ist, übergeben Sie ihn explizit: `/code-review ultra <branch>`
* Wenn Ihr Klon möglicherweise nicht die vollständige Historie hat, führen Sie `git fetch --unshallow origin` aus und starten Sie das Review erneut

### Ihr Checkout hat keine Branches

Ein Checkout kann Commits, aber keine Branches haben: Wenn Sie `git init` gefolgt von `git fetch <url>` und `git checkout FETCH_HEAD` ausführen, erhalten Sie ein Detached HEAD ohne Refs. Claude Code verpackt Ihr Repository als git-Bundle, um es für ein [ultrareview](https://code.claude.com/docs/de/ultrareview.md) hochzuladen, und es kann kein Repository bündeln, das keine Branches oder andere Refs hat, daher lehnen `/code-review ultra` und der Unterbefehl `claude ultrareview` das Review ab, bevor die Cloud-Sitzung startet.

```text theme={null}
Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
```

Vor v2.1.221 versuchte Claude Code, jede getrackte Datei in diesem Checkout zu reviewen, und der Upload schlug fehl.

**Vorgehensweise:**

* Erstellen Sie mit `git checkout -b <name>` einen Branch an Ihrem aktuellen Commit und starten Sie das Review dann erneut

### Mit Ihrem Claude-Konto ist kein GitHub-Konto verbunden

Sie haben `/code-review ultra <PR#>` oder `claude ultrareview <PR#>` ausgeführt, und bevor Claude Code die Cloud-Sitzung erstellt, fragt es den Server, ob [das mit Ihrem Claude-Konto verbundene GitHub-Konto](https://code.claude.com/docs/de/ultrareview.md#review-a-pull-request) auf das Repository des PR zugreifen kann. Es ist kein Konto verbunden oder die Verbindung ist abgelaufen, sodass der Cloud-Klon fehlschlagen würde, und Claude Code lehnt den Start ab. Für einen abgelehnten Start verbraucht Claude Code keinen kostenlosen Durchlauf und verrechnet kein Nutzungsguthaben.

```text theme={null}
Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
```

Wenn [`/web-setup`](https://code.claude.com/docs/de/web-quickstart#connect-from-your-terminal) in Ihrer Sitzung nicht verfügbar ist, nennt die Meldung nur den claude.ai-Link.

**Vorgehensweise:**

* Führen Sie `/web-setup` aus, um Ihre GitHub-CLI-Anmeldung mit Ihrem Claude-Konto zu verbinden, oder verbinden Sie ein Konto unter [claude.ai/connect-github](https://claude.ai/connect-github)
* Starten Sie das Review eine Minute nach dem Verbinden erneut

Vor v2.1.248 prüfte Claude Code dies nicht vor dem Start.

### Ihr verbundenes GitHub-Konto kann das Repository nicht sehen

Sie haben `/code-review ultra <PR#>` oder `claude ultrareview <PR#>` ausgeführt, und [das mit Ihrem Claude-Konto verbundene GitHub-Konto](https://code.claude.com/docs/de/ultrareview.md#review-a-pull-request) kann das Repository des PR nicht lesen, sodass der Cloud-Klon fehlschlagen würde, und Claude Code lehnt den Start ab. Für einen abgelehnten Start verbraucht Claude Code keinen kostenlosen Durchlauf und verrechnet kein Nutzungsguthaben.

```text theme={null}
Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
```

Wenn [`/web-setup`](https://code.claude.com/docs/de/web-quickstart#connect-from-your-terminal) in Ihrer Sitzung nicht verfügbar ist, nennt die Meldung nur die Installation der App.

**Vorgehensweise:**

* Wenn Ihre lokale `gh`-CLI das Repository lesen kann, führen Sie `/web-setup` aus, um diese Anmeldung mit Ihrem Claude-Konto zu verbinden
* Starten Sie das Review nach der Änderung erneut

Vor v2.1.248 prüfte Claude Code dies nicht vor dem Start.

### Die GitHub-App-Vorabprüfung ist vorübergehend fehlgeschlagen

Sie haben eine [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) aus einem lokalen Repository gestartet, und zwei Schritte sind zusammen fehlgeschlagen. Claude Code konnte das Bundle Ihres Repositorys nicht erstellen oder hochladen. Vor dem Upload hat es geprüft, ob der Cloud-Dienst das Repository von GitHub klonen kann, und statt einer eindeutigen Antwort endete diese Prüfung mit einem Fehler, den ein erneuter Versuch beheben könnte, etwa ein Netzwerkfehler, ein Timeout oder ein vorübergehender Serverfehler. Die vollständige Meldung beginnt mit dem, was das Bundle verhindert hat, zum Beispiel `Could not upload repo bundle (<error>)`, und endet mit dem Satz zur Vorabprüfung:

```text theme={null}
Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
```

**Vorgehensweise:**

* Führen Sie den Befehl nach einem Moment erneut aus. Wenn die GitHub-Prüfung erfolgreich ist, kann Claude Code die Sitzung aus einem GitHub-Klon starten, sodass der fehlgeschlagene Upload den Start nicht mehr blockiert
* Wenn Wiederholungsversuche weiterhin fehlschlagen, nennt der Anfang der Meldung, was den Upload verhindert hat. Wenn Sie diese Ursache beheben können, beheben Sie sie, damit die Sitzung stattdessen aus Ihrem lokalen Repository starten kann

Vor v2.1.251 beendete Claude Code die Meldung mit `Please set up GitHub on https://claude.ai/code`, selbst wenn die GitHub-Prüfung nur vorübergehend fehlschlug, und ein Einrichtungsrat kann einen vorübergehenden Fehler nicht beheben.

### Der Repository-Upload kann einer git-Einstellung nicht folgen

Sie haben eine [Cloud-Sitzung, die Ihr lokales Repository hochlädt](https://code.claude.com/docs/de/claude-code-on-the-web.md#send-local-repositories-without-github), oder ein [ultrareview](https://code.claude.com/docs/de/ultrareview.md) eines Branches gestartet, und der Upload kann einer der git-Einstellungen nicht folgen, die bestimmen, welche Attributregeln für Ihre Dateien gelten. Wenn der Upload fortgesetzt würde und eine Regel übersähe, könnte eine Datei, die git vor dem Speichern umwandelt, etwa eine, die ein Clean-Filter verschlüsselt, so in die Cloud gelangen, wie sie auf der Festplatte liegt. Claude Code lehnt den Upload stattdessen ab, und es wird nichts hochgeladen:

```text theme={null}
Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
```

Die Meldung nennt die Einstellung und wo sie gesetzt ist und endet mit der Lösung für den vorliegenden Fall. Dieselbe Ablehnung erscheint für `core.attributesFile` und `attr.tree`, jeweils mit eigener Lösung.

Die Meldung kann eine Konfigurationsdatei nennen, die Ihre git-Konfiguration über eine `include`- oder `includeIf`-Direktive einbindet, selbst wenn die Bedingung dieser Direktive für dieses Repository nicht zutrifft.

**Vorgehensweise:**

* Wenden Sie die Lösung aus dem letzten Satz der Meldung an

### GitHub ist nicht mit Ihrem Claude-Konto verbunden

Sie haben eine [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) aus Ihrem lokalen Repository gestartet, zum Beispiel mit `/autofix-pr`. Mit Ihrem Claude-Konto ist kein GitHub-Konto verbunden oder die Verbindung ist abgelaufen, daher lehnt Claude Code den Start ab:

```text theme={null}
GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
```

Wenn Sie mit [`/schedule`](https://code.claude.com/docs/de/routines) eine geplante Aufgabe in der Cloud erstellen, erscheint dieselbe Meldung als Einrichtungshinweis, der das Repository nennt; der Hinweis blockiert das Erstellen der Aufgabe nicht.

**Vorgehensweise:**

* Führen Sie `/web-setup` aus, um Ihre GitHub-CLI-Anmeldung mit Ihrem Claude-Konto zu verbinden, oder verbinden Sie ein Konto unter [claude.ai/connect-github](https://claude.ai/connect-github). Unter [GitHub-Authentifizierungsoptionen](https://code.claude.com/docs/de/claude-code-on-the-web.md#github-authentication-options) erfahren Sie, wie sich die beiden unterscheiden.
* Führen Sie den Befehl eine Minute nach dem Verbinden erneut aus

Vor v2.1.268 meldete Claude Code dies als vorübergehenden Fehler der Claude-GitHub-App-Prüfung und schlug vor, es erneut zu versuchen oder die App zu installieren; keines von beiden verbindet ein GitHub-Konto.

### Eine Richtlinie Ihrer GitHub-Organisation blockiert Claude

Sie haben in der Claude Code-Eingabe einen Befehl ausgeführt, der eine Cloud-Sitzung startet, etwa [`/autofix-pr`](https://code.claude.com/docs/de/claude-code-on-the-web#auto-fix-pull-requests). Bevor die Sitzung erstellt wird, prüft Claude Code den Zugriff von Claude auf das Repository auf GitHub, und GitHub hat den Zugriff verweigert, weil Ihre GitHub-Organisation eine Richtlinie hat, die Claude blockiert. Claude Code bricht an dieser Stelle ab und zeigt eine Meldung an, die die Richtlinie benennt.

Wenn eine IP-Allowlist den Zugriff blockiert, lautet die Meldung:

```text theme={null}
Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.
```

Wenn Single Sign-On den Zugriff blockiert, lautet die Meldung:

```text theme={null}
Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.
```

Wenn eine Conditional-Access-Richtlinie von Microsoft Entra ID den Zugriff blockiert, lautet die Meldung:

```text theme={null}
Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.
```

**Was Sie tun können:**

* **IP-Allowlist**: Bitten Sie einen Owner Ihrer GitHub-Organisation oder Ihres Enterprise, die ausgehenden IP-Adressen von Anthropic zuzulassen. Die Adressen und die zu ändernden GitHub-Einstellungen finden Sie unter [GitHub-Allowlists und Firewalls](https://code.claude.com/docs/de/network-config.md#github-allow-lists-and-firewalls).
* **Single Sign-On**: Trennen Sie GitHub unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) und verbinden Sie es anschließend erneut. Wenn GitHub danach fragt, klicken Sie neben Ihrer Organisation auf **Authorize**, damit die neue Verbindung für deren Single Sign-On autorisiert wird.
* **Conditional-Access-Richtlinie**: Bitten Sie Ihren GitHub-Enterprise- oder Microsoft-Entra-ID-Administrator, Claude in dieser Richtlinie zuzulassen
* Führen Sie den Befehl nach der Änderung erneut aus

### Single-Sign-On-Autorisierung erforderlich

Sie haben [`/install-github-app`](https://code.claude.com/docs/de/github-actions#quick-setup) ausgeführt und ein Repository ausgewählt, dessen Organisation SAML-Single-Sign-On erzwingt. Vor der Einrichtung prüft Claude Code Ihren Zugriff auf das Repository mit der GitHub CLI, und GitHub hat diese Prüfung abgelehnt, weil Ihr `gh`-Token noch nicht für die Organisation autorisiert ist. Der Assistent zeigt die Warnung zusammen mit den Schritten zur Autorisierung an:

```text theme={null}
Single sign-on authorization needed
<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.
```

**Was Sie tun können:**

* Autorisieren Sie Ihre GitHub-CLI-Anmeldung mit den Scopes `repo` und `workflow` erneut, indem Sie `gh auth refresh -h github.com -s repo,workflow` ausführen, und autorisieren Sie die Organisation, wenn GitHub zur Single-Sign-On-Anmeldung auffordert
* Wenn Sie sich mit einem Personal Access Token in `GH_TOKEN` authentifizieren, öffnen Sie [github.com/settings/tokens](https://github.com/settings/tokens), wählen Sie beim Token **Configure SSO** aus und autorisieren Sie die Organisation
* Führen Sie `/install-github-app` erneut aus

Vor v2.1.273 zeigte Claude Code in diesem Fall stattdessen die Warnung `Admin permissions required` an.

### Fortsetzen der Konversation fehlgeschlagen

Claude Code konnte das gespeicherte Transkript der Sitzung, die Sie in der [`claude --resume`-Auswahl](https://code.claude.com/docs/de/sessions#use-the-session-picker) ausgewählt haben, nicht lesen oder verarbeiten. Daher beendet es den Prozess, statt in einem teilweise geladenen Zustand fortzufahren. Die Meldung enthält den Befehl für einen erneuten Versuch:

```text theme={null}
Failed to resume the conversation.
Run claude --resume <session-id> to retry, or claude to start a new session.
```

Claude Code wird nach Anzeige der Meldung mit Code 1 beendet. Die `/resume`-Auswahl innerhalb einer laufenden Sitzung meldet stattdessen `Failed to resume conversation` in der Konversation, und Ihre aktuelle Sitzung läuft weiter. Vor v2.1.216 blieb ein fehlgeschlagenes Fortsetzen aus der `claude --resume`-Auswahl unbegrenzt beim Ladeindikator `Resuming conversation…` stehen, statt diese Meldung anzuzeigen.

**Was Sie tun können:**

* Führen Sie `claude --resume <session-id>` mit der Sitzungs-ID aus der Meldung aus, um es erneut zu versuchen
* Wenn auf einer Version vor v2.1.285 der erneute Versuch auf dieselbe Weise fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung erneut fort. Diese Versionen scheitern beim Fortsetzen, wenn das gespeicherte Transkript einen Eintrag enthält, den sie nicht lesen können.
* Wenn der erneute Versuch wieder fehlschlägt, führen Sie `claude` aus, um eine neue Sitzung zu starten

### Keine Konversation mit der Sitzungs-ID gefunden

Sie haben `claude --resume <session-id>` eine Sitzungs-ID übergeben, und kein gespeichertes Transkript passte dazu:

```text theme={null}
No conversation found with session ID: <session-id>
```

Claude Code beendet sich nach der Anzeige der Meldung mit dem Code 1. Claude Code [durchsucht zuerst das aktuelle Projekt und dann jedes andere Projekt auf diesem Rechner](https://code.claude.com/docs/de/sessions.md#where-the-session-picker-looks) nach der ID. Vor v2.1.223 endete die Suche beim aktuellen Projektverzeichnis und dessen Git-Worktrees; setzen Sie die Sitzung daher aus dem Verzeichnis fort, in dem sie zuletzt gearbeitet hat.

Häufige Ursachen:

* **Falsch eingegebene ID**: Bei einer nicht interaktiven Ausführung ist die ID das Feld `session_id` der [Ausgabe von `--output-format json`](https://code.claude.com/docs/de/headless#get-structured-output)
* **Gelöschtes Transkript**: Claude Code entfernt Transkripte nach Ablauf der [Aufbewahrungsfrist](https://code.claude.com/docs/de/sessions.md#where-transcripts-are-stored), standardmäßig 30 Tage, gemäß den [Regeln für die Bereinigung](https://code.claude.com/docs/de/claude-directory.md#cleaned-up-automatically)
* **Anderer Rechner**: Claude Code speichert Transkripte lokal, setzen Sie die Sitzung also auf dem Rechner fort, auf dem sie lief
* **Doppelte Kopien**: Wenn Sie ein Projektverzeichnis unter `~/.claude/projects` kopiert haben, sodass zwei Transkripte dieselbe ID tragen, meldet Claude Code diese Meldung, statt willkürlich eine Kopie fortzusetzen

**Was Sie tun können:**

* Öffnen Sie bei einer interaktiven Sitzung die [Sitzungsauswahl](https://code.claude.com/docs/de/sessions.md#use-the-session-picker) mit `claude --resume` und drücken Sie `Ctrl+A`, um sie auf alle Projekte auf diesem Rechner zu erweitern, und wählen Sie dann die Sitzung aus
* Sitzungen, die mit `claude -p` oder dem [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md) erstellt wurden, erscheinen nicht in der Auswahl. Gleichen Sie die ID daher erneut mit der `session_id` ab, die Ihre ursprüngliche Ausführung ausgegeben hat

### Windows hat einen Fehler (EBADF) gemeldet, als Claude Code die Transkriptdatei dieser Sitzung gelesen hat

Sie haben unter Windows eine Sitzung fortgesetzt, ihre gespeicherte [Transkriptdatei](https://code.claude.com/docs/de/sessions.md#where-transcripts-are-stored) wurde normal geöffnet, und das anschließende Lesen schlug mit dem Systemfehler EBADF fehl. Der Systemfehler gibt nicht an, warum das Lesen fehlgeschlagen ist, daher nennt die Meldung wahrscheinliche Ursachen und Lösungsansätze:

```text theme={null}
Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
```

Die Meldung folgt auf die eigene Fehlerzeile des Befehls, etwa `Failed to resume session <session-id>`. Ein `claude --resume`- oder [`claude -p`](https://code.claude.com/docs/de/headless)-Befehl wird nach Anzeige der Meldung mit Code 1 beendet. Nach `/resume` innerhalb einer Sitzung läuft Ihre aktuelle Sitzung weiter.

**Was Sie tun können:**

* Nehmen Sie den Ordner mit Ihren Sitzungstranskripten von Software aus, die Dateizugriffe scannt oder abfängt, etwa Sicherheits-, Verschlüsselungs- oder Endpoint-Management-Tools. Transkripte liegen standardmäßig unter `%USERPROFILE%\.claude\projects` oder unter dem Verzeichnis, das [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/de/env-vars) angibt
* Wenn Sie keine Ausnahme hinzufügen können, fügen Sie Claude Code stattdessen zu den zugelassenen Anwendungen dieser Software hinzu
* Setzen Sie die Sitzung erneut fort

Vor v2.1.282 kam der Fehler ohne Erklärung: `claude --resume <session-id>` endete bei `Failed to resume session <session-id>`, und eine `-p`-Ausführung gab nur den Text des Systemfehlers aus, etwa `Failed to resume session: EBADF: bad file descriptor, read`.

### Renderer kann in dieser Sitzung nicht gewechselt werden

Wenn Sie den Renderer wechseln, startet Claude Code seinen Prozess neu. Sie haben [`/tui`](https://code.claude.com/docs/de/fullscreen#enable-fullscreen-rendering) in einer Sitzung ausgeführt, die Claude Code nicht neu startet, daher wechselt es nicht und speichert nichts. Welche Meldung Sie sehen, verrät Ihnen die Ursache:

* `Cannot switch renderers while work is running in the background`: Es läuft Hintergrundarbeit, die bei einem Neustart verloren ginge, etwa eine Hintergrund-Shell oder ein Subagent. Warten Sie, bis die Arbeit abgeschlossen ist, oder beenden Sie sie mit [`/tasks`](https://code.claude.com/docs/de/commands), und führen Sie dann erneut `/tui fullscreen` oder `/tui default` aus
* `Cannot switch renderers in this session`: Die Sitzung hat Einschränkungen, die Claude Code nicht an den neu gestarteten Prozess übergeben kann. Vor v2.1.234 startete Claude Code trotzdem neu, und die neu gestartete Sitzung lief ohne diese Einschränkungen

In der Meldung zu Einschränkungen nennt der Teil in Klammern die Einschränkungen, die Claude Code gefunden hat:

```text theme={null}
Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
```

Jeder Grund, den die Meldung in Klammern anzeigen kann:

* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Sie haben die Sitzung mit einem Flag gestartet, das Claude Code nicht an den neu gestarteten Prozess zurückgibt. Zu diesen Flags gehören [`--system-prompt`](https://code.claude.com/docs/de/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, eine [`--tools`](https://code.claude.com/docs/de/cli-reference#cli-flags)-Allowlist, [`--setting-sources`](https://code.claude.com/docs/de/cli-reference#cli-flags) und [`--permission-prompt-tool`](https://code.claude.com/docs/de/cli-reference#cli-flags)
* `permission rules set for this session only`: Ein [Berechtigungs-Update](https://code.claude.com/docs/de/hooks.md#permission-update-entries) von einem Hook oder SDK-Aufrufer hat deny- oder ask-Regeln mit dem Ziel `session` hinzugefügt. Auf die Sitzung beschränkte allow-Regeln lösen die Ablehnung nicht aus. Ein Neustart verwirft sie, und Claude Code fragt stattdessen erneut nach
* `ask-before-running rules with no command-line form`: Ein Berechtigungs-Update von einem Hook oder SDK-Aufrufer hat ask-Regeln zusätzlich zu den Regeln hinzugefügt, die Claude Code als `--allowed-tools` und `--disallowed-tools` zurückgibt. Für ask-Regeln gibt es kein Flag
* `permission rules a command line cannot carry intact` und `added directories a command line cannot carry intact`: Ein Berechtigungs-Update hat während der Sitzung eine Regel oder einen Verzeichnispfad hinzugefügt. Die Befehlszeile des neu gestarteten Prozesses kann deren Text nicht als denselben Wert übernehmen

**Was Sie tun können:**

* Führen Sie in einer Sitzung, die ohne diese Einschränkungen gestartet wurde, `/tui fullscreen` aus, oder `/tui default`, um zurückzuwechseln. Claude Code speichert dort die [Einstellung `tui`](https://code.claude.com/docs/de/settings-reference#tui)

### Can't restart while work is running or Remote Control is connected

Claude Code wurde nicht neu gestartet, und Ihre Sitzung läuft unverändert weiter. Folgen Sie der Lösung in der Meldung.

### Claude Code couldn't restart

Wenn diese Meldung besagt, dass Ihre Konversation gespeichert ist, liegt die Konversation auf der Festplatte, und Sie können dort weitermachen, wo sie aufgehört hat. Claude Code war dabei, sich selbst neu zu starten, zum Beispiel um nach dem Ausführen von [`/tui`](https://code.claude.com/docs/de/fullscreen#enable-fullscreen-rendering) zur Vollbilddarstellung oder von ihr weg zu wechseln, konnte den neuen Prozess aber nicht starten und hat sich daher mit Status 1 beendet:

```text theme={null}
Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.
```

Wenn der Neustart keine Konversation zum erneuten Öffnen hatte, zum Beispiel weil `/tui` Ihre erste Eingabe in einer neuen Sitzung war, lautet die Meldung `Claude Code couldn't restart. Start Claude Code again.`

**Was Sie tun können:**

* Führen Sie `claude` erneut in Ihrer Shell aus. Wenn die Meldung besagte, dass Ihre Konversation gespeichert ist, führen Sie in der neuen Sitzung [`/resume`](https://code.claude.com/docs/de/sessions#resume-a-session) aus und wählen Sie die Konversation aus. Wenn sie nicht in der Liste steht, [erweitern Sie die Sitzungsauswahl](https://code.claude.com/docs/de/sessions.md#where-the-session-picker-looks)
* Wenn Neustarts weiterhin fehlschlagen, starten Sie Claude Code aus Ihrer Shell mit [`claude --debug-file claude-debug.log`](https://code.claude.com/docs/de/cli-reference#cli-flags). Wenn ein Neustart aus dieser Sitzung fehlschlägt, enthält `claude-debug.log` im Startverzeichnis eine Zeile `Failed to relaunch:` mit dem Fehler des Betriebssystems. Fügen Sie diese Zeile hinzu, wenn Sie [das Problem melden](#report-an-error)

### Claude Desktop konnte nicht geöffnet werden

Sie haben in einer Sitzung [`/desktop`](https://code.claude.com/docs/de/desktop#coming-from-the-cli) oder dessen Alias `/app` ausgeführt, oder [`claude --desktop`](https://code.claude.com/docs/de/cli-reference#cli-flags) in Ihrer Shell, und der Systembefehl, mit dem Claude Code Claude Desktop öffnet, ist fehlgeschlagen. Nach `/desktop` bleibt die Sitzung im Terminal; `claude --desktop` gibt die Meldung ohne das Präfix `Error:` aus und wird mit Status 1 beendet.

Der Text in Klammern nennt den fehlgeschlagenen Befehl mit seinem Exit-Status und der ersten Zeile seiner Fehlerausgabe, sofern er diese erzeugt hat. Unter macOS ist dieser Befehl `open`, wie in diesem Beispiel; unter Windows ist es `rundll32`:

```text theme={null}
Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.
```

**Was Sie tun können:**

* Öffnen Sie Claude Desktop selbst und führen Sie dann erneut `/desktop` oder `claude --desktop` aus
* Um die vollständige Fehlerausgabe des fehlgeschlagenen Befehls zu lesen, aktivieren Sie das Debug-Logging mit `/debug` und führen Sie `/desktop` erneut aus, oder führen Sie `claude --desktop --debug-file <path>` aus, und prüfen Sie dann das Debug-Log

Vor v2.1.285 endete die Meldung mit `Open Claude Desktop and run /desktop again.` Vor v2.1.275 lautete sie `Failed to open Claude Desktop. Please try opening it manually.` und gab nicht an, was fehlgeschlagen war.

### /terminal-setup hat Ihre Zed-Keymap unverändert gelassen

Sie haben [`/terminal-setup`](https://code.claude.com/docs/de/terminal-config#enter-multiline-prompts) in Zed ausgeführt, und Claude Code konnte die Aktualisierung Ihrer Zed-Datei `keymap.json` nicht abschließen, daher hat es die Datei unverändert gelassen.

Jede Meldung nennt den Pfad zu Ihrer Keymap und endet mit dem Block für die Tastenkombination, den Sie selbst hinzufügen können:

```text theme={null}
Couldn't update your Zed keymap, so it was left unchanged.
To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
```

Die erste Zeile der Meldung nennt die Ursache:

* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code konnte die Datei nicht lesen, zum Beispiel aufgrund von Dateiberechtigungen
* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: Die Datei wurde zwar gelesen, lässt sich aber nicht als Array von Tastenkombinationsblöcken parsen, selbst wenn `//`-Kommentare und nachgestellte Kommas erlaubt sind
* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code konnte die Datei nicht in eine `.bak`-Sicherung daneben kopieren und hat daher nichts geändert
* `Couldn't update your Zed keymap, so it was left unchanged.`: Das zusammengeführte Ergebnis ließ sich nicht als gültige Keymap mit der Tastenkombination verifizieren, daher hat Claude Code es verworfen, statt es zu schreiben. Ein Tastenkombinationsblock mit einem doppelten Schlüssel kann dies verursachen

**Was Sie tun können:**

* Kopieren Sie den Block aus der Meldung in das Array der obersten Ebene Ihrer `keymap.json` unter dem Pfad, den die Meldung nennt
* Bei `isn't a readable list of keybindings` beheben Sie den Syntaxfehler oder machen Sie den Wert der obersten Ebene der Datei zu einem Array, und führen Sie dann `/terminal-setup` erneut aus

Vor v2.1.247 konnte `/terminal-setup` eine Zed-Keymap mit `//`-Kommentaren oder nachgestellten Kommas nicht parsen und ersetzte die gesamte Datei nur durch die eigene Tastenkombination, während es die Tastenkombination als installiert meldete. Um eine Keymap wiederherzustellen, die eine frühere Version ersetzt hat, verwenden Sie die `.bak`-Sicherungsdatei, die unter [Mehrzeilige Prompts eingeben](https://code.claude.com/docs/de/terminal-config.md#enter-multiline-prompts) beschrieben ist.

### Skill-Nutzungsberichte sind über diese Verbindung nicht verfügbar

Sie haben [`/skill-doctor`](https://code.claude.com/docs/de/skills#find-unused-skills) über [Remote Control](https://code.claude.com/docs/de/remote-control.md) von Ihrem Smartphone oder Browser aus ausgeführt. Claude Code sendet den Skill-Nutzungsbericht nicht über Remote Control und antwortet stattdessen mit dieser Meldung:

```text theme={null}
Skill usage reports are not available on this connection.
```

**Was Sie tun können:**

* Führen Sie `/skill-doctor` im Terminal auf dem Rechner aus, auf dem die Sitzung läuft, oder führen Sie dort `claude -p "/skill-doctor"` aus

### Benutzerdefinierte Ausgabestile können nicht über Remote Control ausgewählt werden

Sie haben [`/output-style`](https://code.claude.com/docs/de/output-styles#change-your-output-style) über [Remote Control](https://code.claude.com/docs/de/remote-control.md) aus der mobilen App oder dem Web ausgeführt, oder der Befehl kam in einer Nachricht an, die in die Sitzung weitergeleitet wurde. Da ein solcher Turn möglicherweise nicht vom Kontoinhaber stammt, listet Claude Code dort nur [integrierte Stile](https://code.claude.com/docs/de/output-styles.md#built-in-output-styles) auf und wählt nur diese aus. Es fügt diesen Hinweis immer dann hinzu, wenn der Befehl die Stile auflistet oder den angegebenen Namen nicht erkennt. Der Name eines [benutzerdefinierten Stils](https://code.claude.com/docs/de/output-styles.md#create-a-custom-output-style) erhält dieselbe Antwort wie ein Name, der nicht existiert:

```text theme={null}
Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
```

**Was Sie tun können:**

* Wählen Sie einen integrierten Stil, zum Beispiel `/output-style concise`
* Um einen benutzerdefinierten Stil zu verwenden, setzen Sie [`outputStyle`](https://code.claude.com/docs/de/settings-reference#outputstyle) in der Datei `.claude/settings.local.json` des Projekts, oder führen Sie `/output-style <style>` im eigenen Terminal der Sitzung aus, sofern sie eines hat

### Ausgabestile werden in lokalen Einstellungen gespeichert, die diese Sitzung nicht lädt

Sie haben versucht, mit `/output-style <style>` oder `/config outputStyle=<style>` den [Ausgabestil](https://code.claude.com/docs/de/output-styles.md) in einer Sitzung zu wechseln, deren Einstellungsquellen `local` ausschließen. Beispiele sind eine [Agent SDK](https://code.claude.com/docs/de/agent-sdk/typescript.md)-Sitzung, deren [`settingSources`](https://code.claude.com/docs/de/agent-sdk/typescript#options) `"local"` auslässt, und eine CLI-Sitzung, die mit einem [`--setting-sources`](https://code.claude.com/docs/de/cli-reference#cli-flags)-Wert ohne `local` gestartet wurde. Beide Befehle speichern den Stil in `.claude/settings.local.json`, einer Datei, die eine solche Sitzung nie zurückliest. Daher lehnt Claude Code ab, statt eine Einstellung zu schreiben, die keine Wirkung hätte:

```text theme={null}
Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
```

**Was Sie tun können:**

* Fügen Sie `local` zu den Einstellungsquellen der Sitzung hinzu und wechseln Sie erneut
* Setzen Sie den Schlüssel [`outputStyle`](https://code.claude.com/docs/de/settings-reference#outputstyle) in einer Einstellungsdatei, die die Sitzung lädt, etwa `.claude/settings.json` im Projekt oder `~/.claude/settings.json`. Im TypeScript SDK setzen Sie `outputStyle` stattdessen im Inline-Objekt `settings`; siehe [Einen Ausgabestil aktivieren](https://code.claude.com/docs/de/agent-sdk/modifying-system-prompts.md#activate-an-output-style)

### /recap wird nur ausgeführt, wenn Sie es selbst anfordern

Die [`/recap`](https://code.claude.com/docs/de/interactive-mode#session-recap)-Anfrage stammte nicht aus Ihrer eigenen Eingabe. Sie kam in einer Nachricht an, die aus einem Slack-, Teams- oder [Projekt](https://code.claude.com/docs/de/claude-projects.md)-Thread in die Sitzung weitergeleitet wurde, oder in einem Prompt, den eine [geplante Aufgabe in der Cloud](https://code.claude.com/docs/de/routines.md) oder ein anderes Programm gesendet hat.

Eine weitergeleitete Nachricht erhält den Hinweis auch dann, wenn Sie sie selbst geschrieben haben. Claude Code kann nicht erkennen, ob eine weitergeleitete oder automatisierte Nachricht von der Person stammt, deren Konto die Sitzung ausführt, daher antwortet es mit diesem Hinweis statt mit einer Zusammenfassung:

```text theme={null}
/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.
```

Ein `/recap`, das Sie an `claude -p` übergeben oder das Ihre eigene [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Anwendung an eine von ihr gestartete Sitzung sendet, zählt als Ihre eigene Eingabe.

**Was Sie tun können:**

* Öffnen Sie die Sitzung selbst und führen Sie `/recap` dort aus: in ihrem Terminal, in der [Desktop-App](https://code.claude.com/docs/de/desktop.md) oder der [mobilen App](https://code.claude.com/docs/de/mobile.md), unter [claude.ai/code](https://claude.ai/code) oder über [Remote Control](https://code.claude.com/docs/de/remote-control.md)
* Wenn eine geplante Aufgabe in der Cloud oder ein anderes Programm es gesendet hat, entfernen Sie `/recap` aus diesem Prompt

### /feedback is disabled by your organization's policy

Diese Meldung bedeutet, dass Produktfeedback ausgeschaltet ist, sodass der eingegebene Befehl den Feedback-Dialog nicht öffnet. Sowohl eine Richtlinie Ihrer Organisation als auch eine frühere Ablehnung erzeugen die Meldung:

* **Organisationsrichtlinie**: Die Richtlinie Ihrer Organisation erlaubt kein Produktfeedback aus Claude Code. `/feedback`, `/bug` und `/share` antworten alle mit der Meldung.
* **Frühere Ablehnung**: Der Feedback-Dienst hat einen von Ihnen gesendeten Bericht abgelehnt, zum Beispiel mit [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) `/feedback` und `/bug` können dann mit der Meldung antworten. Das gilt auf diesem Rechner sieben Tage ab dieser Ablehnung. Dies betrifft jeden Plan, einschließlich Pro und Max.

Die Meldung nennt den Befehl, den Sie an der Claude Code-Eingabeaufforderung eingegeben haben:

```text wrap theme={null}
/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
```

Die Meldung kann auch nur aus ihrem ersten Satz bestehen.

**Was Sie tun können:**

* Um einen Fehler zu melden, eröffnen Sie ein Issue unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Issues dort sind für alle lesbar, lassen Sie daher Code, Transkripte und alles andere Vertrauliche weg.
* Warten Sie nach einer früheren Ablehnung, bis die sieben Tage vergangen sind, und senden Sie dann erneut einen Bericht, um zu sehen, ob der Dienst ihn weiterhin ablehnt

Vor v2.1.319 erzeugte eine frühere Ablehnung diese Meldung nicht.

Vor v2.1.302 lautete die vollständige Meldung `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

## Plugin-Fehler

Diese Fehler stammen aus der Konfiguration von [Plugins](https://code.claude.com/docs/de/plugins/overview.md) und [Marketplaces](https://code.claude.com/docs/de/plugins/overview.md). Für Plugin-Probleme, die keine der Meldungen auf dieser Seite erzeugen, etwa eine Marketplace-URL, die nicht lädt, oder ein Plugin, das sich installiert, aber nicht erscheint, siehe [Fehlerbehebung bei Plugins](https://code.claude.com/docs/de/plugins/troubleshooting.md).

### plugin eval is currently in early access

Sie haben [`claude plugin eval`](https://code.claude.com/docs/de/plugin-evals) oder `claude plugin eval init` ausgeführt, und der Befehl wurde mit Exit-Code 1 und einer dieser Meldungen beendet, bevor er irgendetwas getan hat:

```text theme={null}
`plugin eval` is currently in early access
```

```text theme={null}
`plugin eval` is currently unavailable
```

Die erste Meldung bedeutet, dass Ihr Build älter als v2.1.269 ist, die erste Version, in der der Befehl allgemein verfügbar ist. Die zweite bedeutet, dass Anthropic den Befehl serverseitig abgeschaltet hat; nichts auf Ihrem Rechner schaltet ihn wieder ein.

**Vorgehensweise:**

* Führen Sie `claude --version` und dann `claude update` aus und führen Sie den Befehl in einer neuen Sitzung erneut aus. Siehe die [Voraussetzungen für Plugin-Evals](https://code.claude.com/docs/de/plugin-evals.md#requirements)
* Wenn Sie die zweite Meldung mit einem aktuellen Build sehen, versuchen Sie es später nach einem weiteren `claude update` erneut

### Marketplace is registered from an untrusted source

Der Marketplace ist unter einem Namen registriert, der [für offizielle Anthropic-Marketplaces reserviert](https://code.claude.com/docs/de/plugins/marketplace-reference.md#marketplace-file) ist, aber seine registrierte Quelle ist kein GitHub-Repository von `anthropics`. Claude Code prüft reservierte Namen jedes Mal erneut, wenn es einen Marketplace lädt oder aktualisiert, sodass der Marketplace und die daraus installierten Plugins nicht mehr geladen werden. Vor v2.1.205 wurde ein Eintrag, der registriert wurde, bevor sein Name reserviert wurde, weiterhin geladen.

```text theme={null}
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.
```

Bei einem Marketplace, dessen Quelle weder ein GitHub-Repository noch eine Git-URL ist, etwa ein lokales Verzeichnis, lautet der mittlere Satz stattdessen `can only be used with GitHub sources from the 'anthropics' organization`. `claude plugin marketplace add` führt dieselbe Prüfung durch und lehnt einen reservierten Namen mit `Failed to add marketplace:` gefolgt von demselben Satz zum reservierten Namen ab.

**Vorgehensweise:**

* Wenn der Marketplace bereits registriert ist, führen Sie `claude plugin marketplace remove <name>` aus und fügen Sie ihn dann erneut aus dem offiziellen Repository `github.com/anthropics` hinzu
* Wenn Sie einen Drittanbieter-Marketplace veröffentlichen, der den Namen verwendet hat, bevor dieser reserviert wurde, benennen Sie ihn um und bitten Sie die Benutzer, ihn erneut aus Ihrer Quelle hinzuzufügen
* Siehe die Liste der reservierten Namen unter [Marketplace-Schema](https://code.claude.com/docs/de/plugins/marketplace-reference.md#marketplace-file)

### Marketplace-Name ist eine andere Schreibweise eines reservierten Namens

Der Name des Marketplace ist selbst kein reservierter Name, aber Claude Code behandelt ihn als andere Schreibweise eines solchen. [Reservierte Namen](https://code.claude.com/docs/de/plugins/marketplace-reference.md#reserved-name-spellings) listet auf, welche Schreibweisen als reservierter Name gelten. Claude Code lehnt einen solchen Namen ab, wenn Sie den Marketplace hinzufügen:

```text theme={null}
Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.
```

Wenn ein Marketplace bereits unter einem solchen Namen registriert ist, wird sein Eintrag nicht mehr geladen, und `/plugin`, `claude plugin install` sowie `claude plugin update` warnen:

```text wrap theme={null}
known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins
```

Wenn der Name in der Shell maskiert werden müsste, lautet die Ablehnung beim Hinzufügen `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.`

**Vorgehensweise:**

* Benennen Sie den Marketplace in einen Namen um, der keinen reservierten Namen schreibt, und fügen Sie ihn erneut hinzu
* Führen Sie bei der Warnung über den ignorierten Eintrag den angegebenen Befehl `claude plugin marketplace remove` aus oder entfernen Sie den Eintrag aus `~/.claude/plugins/known_marketplaces.json`

### Claude Code refuses the marketplace name

Der Name eines registrierten Marketplace [gibt sich als offizieller Anthropic-Marketplace aus](https://code.claude.com/docs/de/plugins/marketplace-reference.md#reserved-names), gemäß den Regeln, die dieser Abschnitt auflistet.

Wenn ein Marketplace unter einem solchen Namen registriert wurde, bevor die Prüfung ihn blockierte, werden der Marketplace und die daraus installierten Plugins nicht mehr geladen, da Claude Code den Namen jedes Mal prüft, wenn es den Katalog des Marketplace liest. Wenn der Name einen offiziellen Namen imitiert, melden `claude plugin list` und der Tab **Errors** in `/plugin` jedes betroffene Plugin mit einer Meldung, die so beginnt:

```text theme={null}
Claude Code refuses the marketplace name "anthropic-plugins-v2"
```

Bei einem imitierenden Namen lautet der Fehler des Marketplace selbst stattdessen `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own`. `claude plugin marketplace add` lehnt jeden Namen, der sich als offizieller ausgibt, mit `Marketplace name impersonates an official Anthropic/Claude marketplace` ab.

Vor v2.1.282 meldeten `claude plugin list` und `/plugin` die Plugins eines imitierenden Namens ebenfalls als nicht geladen, ohne den Namen des Marketplace als Ursache zu nennen.

**Vorgehensweise:**

* Um einen Marketplace zu behalten, den eine Einstellungsdatei inline mit `"source": "settings"` deklariert, benennen Sie ihn um, bevor Sie den alten Namen entfernen, denn das Entfernen des Marketplace löscht auch seinen Eintrag aus Ihren Einstellungsdateien. Claude Code v2.1.292 oder neuer listet diese Schritte in der Meldung auf:
  1. Geben Sie in jeder Einstellungsdatei, die den Marketplace unter `extraKnownMarketplaces` auflistet, dem Schlüssel des Eintrags und seinem `source.name` einen gemeinsamen neuen Namen in reinem ASCII, der nicht wie ein offizieller Name aussieht. Wenn ein Administrator den Marketplace über die verwalteten Einstellungen Ihrer Organisation hinzufügt, führt der Administrator diesen Schritt aus
  2. Führen Sie `claude plugin marketplace remove <old-name>` aus oder entfernen Sie den alten Namen im Tab **Marketplaces** in `/plugin`. Dadurch werden auch seine Plugins deinstalliert und deren Daten, Optionen und Geheimnisse gelöscht
  3. Starten Sie Claude Code erneut, im Ordner des Projekts, falls die Datei eine Projekt-Einstellungsdatei ist. Installieren Sie dann die Plugins aus dem umbenannten Marketplace
* Um einen anderen Marketplace zu behalten, warten Sie, bis sein Betreuer ihn umbenennt, und führen Sie dann `claude plugin marketplace update <name>` aus
* Um den Marketplace zu entfernen, führen Sie `claude plugin marketplace remove <name>` aus. Dadurch werden auch die aus dem Marketplace installierten Plugins deinstalliert und deren Daten, Optionen und Geheimnisse gelöscht
* Wenn Sie den Marketplace veröffentlichen, benennen Sie ihn in Ihrer `marketplace.json` um; Benutzer aktualisieren den Marketplace dann, anstatt ihn zu entfernen

### Marketplace is already added from a different source

Sie haben mit [`--marketplace <source>` im Installationsbefehl](https://code.claude.com/docs/de/plugins/install#add-a-marketplace-and-install-in-one-command) eine neue Marketplace-Quelle angegeben, in einer Sitzung oder aus Ihrer Shell. Der Katalog, den Claude Code aus dieser Quelle abgerufen hat, trägt denselben Namen wie ein Marketplace, den Sie bereits aus einer anderen Quelle hinzugefügt haben. Claude Code behält den bestehenden Marketplace, anstatt ihn zu ersetzen, und das Plugin wird nicht installiert.

```text theme={null}
Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.
```

**Vorgehensweise:**

* Wenn der bereits hinzugefügte Marketplace der gewünschte ist, installieren Sie daraus über den Namen: `/plugin install <plugin>@<name>`
* Um zur neuen Quelle zu wechseln, führen Sie `/plugin marketplace remove <name>` aus und versuchen Sie die Installation dann erneut

### Plugin-Befehl referenziert user\_config in einem Shell-Befehl

Ein Befehl eines Plugin-Hooks, eines [Monitors](https://code.claude.com/docs/de/plugins/components.md#monitors) oder eines MCP-[`headersHelper`](https://code.claude.com/docs/de/mcp#use-dynamic-headers-for-custom-authentication) referenziert eine [Plugin-Option](https://code.claude.com/docs/de/plugins/manifest-reference.md#user-configuration) `${user_config.KEY}`, 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 verweigert Claude Code den Start der Komponente, anstatt den Wert einzusetzen. Die Prüfung erfolgt anhand der Befehlsvorlage, sodass der Fehler auch dann erscheint, wenn noch kein Wert konfiguriert ist. Vor v2.1.207 wurde der Wert in den Shell-Befehl eingesetzt.

Der Wortlaut hängt davon ab, welche Oberfläche die Option referenziert hat. Ein Hook in Shell-Form meldet:

```text theme={null}
Hook 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}
```

Ein Monitor meldet:

```text theme={null}
Monitor "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.
```

Ein MCP-`headersHelper` meldet:

```text theme={null}
headersHelper 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).
```

**Vorgehensweise:**

* Fügen Sie bei einem Hook ein `args`-Array hinzu, damit er in [Exec-Form](https://code.claude.com/docs/de/hooks.md#exec-form-and-shell-form) läuft, in der jedes `${user_config.KEY}` zu einem Argument ohne dazwischenliegende Shell wird. Oder entfernen Sie die Referenz und lesen Sie die Umgebungsvariable `$CLAUDE_PLUGIN_OPTION_<KEY>` innerhalb des Skripts
* Entfernen Sie bei einem Monitor die Referenz und lassen Sie das Monitor-Skript den Wert aus einer Konfigurationsdatei lesen
* Verschieben Sie bei einem `headersHelper` `${user_config.KEY}` in das Feld `headers` des Servers, das nicht von der Shell geparst wird, oder lesen Sie den Wert innerhalb des Hilfsskripts

### Plugin archive integrity check failed

Der Marketplace-Eintrag des Plugins verwendet eine [`archive`-Quelle](https://code.claude.com/docs/de/plugins/marketplace-reference#archive-plugin-source) mit einer `sha256`-Fixierung, und der Digest der heruntergeladenen Datei stimmt nicht mit der Fixierung überein. Claude Code verweigert die Installation, sodass sich im Plugin-Cache nichts ändert. Die Abweichung hat drei mögliche Ursachen:

* Die Datei unter der URL wurde geändert, nachdem der Autor die Fixierung berechnet hatte
* Der Autor hat den falschen Digest in den Marketplace-Eintrag eingetragen
* Die URL liefert eine andere Datei als die, die der Autor fixiert hat

```text theme={null}
Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.
```

**Vorgehensweise:**

* Wenn Sie das Plugin veröffentlichen, berechnen Sie den Digest genau der Datei neu, die die URL liefert, zum Beispiel mit `shasum -a 256 my-plugin.zip` oder in PowerShell mit `Get-FileHash -Algorithm SHA256 my-plugin.zip`, und aktualisieren Sie den `sha256` im Marketplace-Eintrag
* Wenn Sie das Plugin installieren, führen Sie `/plugin marketplace update <name>` aus, um den Katalog zu aktualisieren, falls der Eintrag korrigiert wurde, und versuchen Sie die Installation dann erneut
* Wenn die Digests nach einer Aktualisierung weiterhin nicht übereinstimmen, fragen Sie den Marketplace-Betreiber vor der Installation, welche Datei er fixiert hat

### Path escapes plugin directory

Einer der Komponentenpfade des Plugins führt aus dem Plugin-Verzeichnis heraus oder konnte nicht als darin liegend bestätigt werden, daher verwirft Claude Code diesen Pfad und lädt den Rest des Plugins. Bei einem Pfad, den das Plugin in `plugin.json` oder in seinem [Marketplace-Eintrag](https://code.claude.com/docs/de/plugins/marketplace-reference.md#plugin-entries) deklariert, benennt der Komponentenname in der Meldung, etwa `commands` oder `hooks`, das Feld, das den Pfad deklariert hat.

```text theme={null}
commands path escapes plugin directory: ./../shared.md
```

In der Ausgabe von `claude plugin`-Befehlen lautet derselbe Fehler `Path escapes plugin directory: ./../shared.md (commands)`.

Claude Code lehnt sowohl einen Pfad ab, der bereits in seiner Schreibweise aus dem Plugin herauszeigt, etwa `../shared-utils`, als auch einen Symlink, der aus dem Plugin herausführt und den die [Symlink-Regeln für Marketplaces](https://code.claude.com/docs/de/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks) nicht erlauben. Bei einem Symlink gibt die Meldung zusätzlich an, wohin der Pfad aufgelöst wird:

```text theme={null}
commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory
```

Eine Meldung, die den vollständigen Pfad einer der eigenen Dateien eines Marketplace-Plugins angibt, etwa `hooks/hooks.json`, bedeutet, dass Claude Code diese Datei übersprungen hat. Wenn Claude Code nicht bestätigen kann, dass sich die Datei innerhalb des Plugins befindet – oder bei einem Plugin in einem [lokalen Marketplace](https://code.claude.com/docs/de/plugins/loading.md#in-place-and-copied-plugins) innerhalb seines Marketplace –, überspringt es die Datei. Die Meldung führt diese Dateien unter dem angezeigten Komponentennamen auf:

* `hooks/hooks.json`: `hooks`
* `monitors/monitors.json`: `monitors`
* `SKILL.md` im Plugin-Stammverzeichnis: `skills`

Diese Meldung betrifft beispielsweise eine `hooks/hooks.json`, die sowohl außerhalb des Plugins als auch außerhalb seines lokalen Marketplace aufgelöst wird:

```text theme={null}
hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory
```

Unter macOS und Linux lehnt Claude Code außerdem einen Komponentenpfad ab, der an beliebiger Stelle einen Backslash enthält, selbst wenn der Pfad innerhalb des Plugins bleibt. Ein Plugin, dessen Komponentenpfade Windows-Trennzeichen verwenden, lädt unter Windows und löst auf den anderen Plattformen diese Ablehnung aus:

```text theme={null}
commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform
```

Vor v2.1.251 lud Claude Code einen in einem Marketplace-Eintrag deklarierten `commands`-Pfad auch dann, wenn er aus dem Plugin-Verzeichnis herauszeigte.

Vor v2.1.257 berücksichtigte die Prüfung der vom Plugin deklarierten Pfade nur die Schreibweise des Pfads, nicht aber, wohin ein Symlink führt.

**Vorgehensweise:**

* Wenn Sie das Plugin installiert haben und es nicht pflegen, melden Sie die Meldung seinem Autor
* Verschieben Sie bei einem vom Plugin deklarierten Pfad die referenzierte Datei in das Plugin-Verzeichnis und lassen Sie den Pfad mit einem relativen `./`-Pfad darauf zeigen
* Wenn der Pfad oder ein übergeordneter Ordner innerhalb des Plugins ein Symlink ist, der aus dem Plugin herausführt, ersetzen Sie den Symlink durch eine Kopie dessen, worauf er zeigt
* Wenn die Meldung besagt, dass ein vom Plugin deklarierter Pfad einen Backslash enthält, schreiben Sie den Pfad mit Schrägstrichen, zum Beispiel `./commands/deploy.md`
* Wenn die Meldung mit `EACCES` endet, stellen Sie Ihre Ausführungsberechtigung für jedes Verzeichnis wieder her, das zu der Datei oder dem Ordner führt, die bzw. den der Pfad benennt. Prüfen Sie die Verzeichnisse oberhalb des Pfads, folgen Sie dann jedem Symlink, auf den Sie stoßen, und prüfen Sie die Verzeichnisse, die zu seinem Ziel führen. Schlagen Sie jeden anderen Fehlercode in den [Ursachen und Schritten für einen Pfad, der nicht geprüft werden konnte](#path-could-not-be-checked), nach.
* Um Dateien mit anderen Plugins im selben Marketplace zu teilen, verknüpfen Sie sie mit einem Symlink innerhalb des Plugin-Verzeichnisses und befolgen Sie dabei die [Symlink-Regeln](https://code.claude.com/docs/de/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

### Serverdateipfad nicht gelesen

Die Meldung `path not read` bedeutet, dass Claude Code eine MCP- oder LSP-Serverdatei, die ein Plugin benennt, aufgrund des Pfads der Datei nicht gelesen hat. Der Rest des Plugins wird geladen, ohne die Server, die die Datei definiert.

Ein `..`-Bestandteil zählt auch dann, wenn der Pfad innerhalb des Plugins bleibt, wie in diesem Beispiel:

```text theme={null}
mcp-servers path not read: ./sub/../x.json is absolute or has a ".." part
```

**Vorgehensweise:**

* Wenn Sie das Plugin installiert haben und es nicht pflegen, melden Sie die Meldung seinem Autor
* Wenn Sie das Plugin pflegen, belassen Sie die Serverdatei innerhalb des Plugin-Verzeichnisses. Benennen Sie sie im Manifest oder im Marketplace-Eintrag mit einem Pfad, der mit `./` beginnt und kein `..` enthält, zum Beispiel `./servers/x.json`
* Um eine Serverdatei zwischen Plugins im selben Marketplace zu teilen, verknüpfen Sie die Datei mit einem Symlink in jedes Plugin und befolgen Sie dabei die [Symlink-Regeln](https://code.claude.com/docs/de/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

### Plugin not loaded: its manifest was not read

Claude Code konnte nicht bestätigen, dass das [Manifest](https://code.claude.com/docs/de/plugins/manifest-reference.md) eines Marketplace-Plugins unter `.claude-plugin/plugin.json` innerhalb des Plugins liegt, daher lädt es nichts aus diesem Plugin. Bei einem Plugin in einem [lokalen Marketplace](https://code.claude.com/docs/de/plugins/loading.md#in-place-and-copied-plugins) konnte Claude Code außerdem nicht bestätigen, dass das Manifest innerhalb dieses Marketplace liegt. Die Meldung erscheint im Tab **Errors** in `/plugin`, und der Grund an ihrem Ende gibt an, was Claude Code vorgefunden hat.

Diese Meldung betrifft beispielsweise ein Plugin in einem lokalen Marketplace, dessen Ordner `.claude-plugin` ein Symlink ist, der aus dem Marketplace herausführt:

```text theme={null}
Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory
```

**Vorgehensweise:**

* Wenn der Grund mit `EACCES` endet, stellen Sie Ihre Ausführungsberechtigung für jedes Verzeichnis wieder her, das zum Manifest führt. Prüfen Sie die Verzeichnisse oberhalb des Manifests, folgen Sie dann jedem Symlink, auf den Sie stoßen, und prüfen Sie die Verzeichnisse, die zu seinem Ziel führen. Schlagen Sie jeden anderen Fehlercode in den [Ursachen und Schritten für einen Pfad, der nicht geprüft werden konnte](#path-could-not-be-checked), nach.
* Wenn Sie das Plugin pflegen und der Grund angibt, wohin das Manifest aufgelöst wird, ist der Ordner `.claude-plugin` oder `plugin.json` selbst ein Symlink, der dorthin führt. Ersetzen Sie diesen Link durch eine Kopie dessen, worauf er zeigt.
* Wenn Sie das Plugin installiert haben und es nicht pflegen, melden Sie die Meldung seinem Autor

### Path could not be checked

Claude Code hat das Betriebssystem gefragt, ob ein Plugin-Pfad existiert, und einen anderen Fehler als „nicht gefunden“ erhalten, daher lädt es nicht, was der Pfad benennt. Wie viel vom Plugin geladen wird, hängt davon ab, welcher Pfad fehlgeschlagen ist:

* Einer der [Standard-Komponentenorte](https://code.claude.com/docs/de/plugins/manifest-reference.md#standard-layout) eines Plugins, etwa der Ordner `skills/`, die Datei `monitors/monitors.json` oder eine [`SKILL.md` im Plugin-Stammverzeichnis](https://code.claude.com/docs/de/plugins/components#skills): Die anderen Komponenten des Plugins werden weiterhin geladen
* Das eigene Verzeichnis des Plugins: Nichts aus diesem Plugin wird geladen

Für einen Pfad, der überhaupt nicht existiert, sehen Sie diesen Fehler nicht. In `/plugin` erscheint der Fehler unter dem Plugin und nennt den Pfad sowie den Code, den das Betriebssystem zurückgegeben hat:

```text theme={null}
skills path couldn't be checked: /home/user/my-plugin/skills (ELOOP)
```

In `claude plugin list` lautet derselbe Fehler `Path not found: /home/user/my-plugin/skills (skills, ELOOP)`.

Zu den Ursachen für diesen Fehler gehören:

* `ELOOP`: Ein Symlink im Pfad zeigt auf sich selbst oder bildet eine Schleife
* `EIO` oder `ESTALE`: Der Pfad liegt auf einem Netzwerk-Mount, der defekt oder veraltet ist
* `EACCES`: Eines der Verzeichnisse oberhalb des Pfads verweigert Ihnen die Berechtigung, es zu durchlaufen

**Vorgehensweise:**

* Ersetzen Sie einen Symlink, der auf sich selbst zeigt, durch einen echten Ordner, oder löschen Sie ihn
* Wenn der Pfad auf einem Netzwerk-Mount liegt, hängen Sie die Freigabe erneut ein
* Wenn der Code `EACCES` lautet, stellen Sie Ihre Ausführungsberechtigung für die Verzeichnisse oberhalb des Pfads wieder her
* Führen Sie nach dem Korrigieren des Pfads `/reload-plugins` aus oder starten Sie Claude Code neu, um das Plugin oder die Komponente zu laden

Vor v2.1.265 behandelte Claude Code einen Standard-Komponentenordner, den es nicht prüfen konnte, als nicht vorhanden und lud das Plugin ohne diese Komponente, ohne einen Fehler anzuzeigen.

### Marketplace entry path does not stay inside the marketplace directory

Der [Marketplace-Eintrag](https://code.claude.com/docs/de/plugins/marketplace-reference.md#plugin-entries) des Plugins deklariert einen Quellpfad, den Claude Code nicht zu einem Ort innerhalb des eigenen Verzeichnisses des Marketplace auflösen kann, daher wird das Plugin weder installiert noch geladen. Die Ablehnung betrifft:

* Einen Eintragspfad, der absolut ist, mit `..` aus dem Marketplace heraussteigt oder wie ein Netzwerkpfad geschrieben ist
* Unter macOS und Linux einen Eintragspfad, der irgendwo nach dem führenden `./` einen Backslash enthält
* Einen Eintrag in einem Marketplace, der aus einer Remote-Quelle wie Git oder einer URL abgerufen wurde und sein Ziel über einen Symlink erreicht, der außerhalb des Marketplace-Verzeichnisses aufgelöst wird
* Einen relativen Eintrag in einem Marketplace, der über eine direkte URL zu seiner `marketplace.json` hinzugefügt wurde: Claude Code lädt nur diese Datei herunter, daher existieren keine lokalen Plugin-Dateien, die der Pfad benennen könnte. Siehe [Plugins mit relativen Pfaden schlagen in URL-basierten Marketplaces fehl](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces)

`claude plugin install` meldet die Ablehnung so:

```text theme={null}
Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)
```

Wenn der Eintrag eines bereits installierten Plugins dieselbe Prüfung nicht besteht, zeigt `claude plugin list` das Plugin als `failed to load` an mit:

```text theme={null}
Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.
```

**Vorgehensweise:**

* Wenn Sie den Marketplace pflegen, schreiben Sie die `source` des Eintrags als einfachen relativen Pfad mit Schrägstrichen, etwa `./plugins/my-plugin`, und sorgen Sie dafür, dass jeder Symlink, den er durchläuft, innerhalb des Marketplace-Verzeichnisses zeigt
* Wenn Sie den Marketplace über eine direkte URL hinzugefügt haben, können relative Einträge nicht aufgelöst werden. Bitten Sie den Autor des Marketplace, eine [andere Plugin-Quelle](https://code.claude.com/docs/de/plugins/marketplace-reference.md#plugin-sources) zu verwenden, oder fügen Sie den Marketplace stattdessen aus seinem Git-Repository hinzu

### Failed to load marketplace configuration

Claude Code speichert die von Ihnen hinzugefügten Plugin-Marketplaces in einer Registry-Datei unter `~/.claude/plugins/known_marketplaces.json`. Ein Plugin-Befehl, der die Registry benötigt, etwa `claude plugin install`, schlägt mit einer von zwei Meldungen fehl, wenn Claude Code die Datei nicht verwenden kann:

* `Failed to load marketplace configuration`: Die Datei existiert, ist aber kein gültiges JSON oder kann nicht gelesen werden. Auch eine leere Datei schlägt auf diese Weise fehl.
* `Marketplace configuration file is corrupted`: Die Datei ist gültiges JSON, aber ihr Inhalt entspricht nicht dem Registry-Schema.

Bei einer leeren Datei meldet `claude plugin install`:

```text theme={null}
✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF
```

Vor v2.1.246 meldete `claude plugin install` diesen Fehler nicht.

**Vorgehensweise:**

* Öffnen Sie `~/.claude/plugins/known_marketplaces.json` und reparieren Sie das JSON, oder korrigieren Sie die Einträge, die laut Meldung nicht dem Registry-Schema entsprechen
* Wenn Sie sie nicht reparieren können, löschen Sie die Datei oder ersetzen Sie ihren Inhalt durch `{}` und fügen Sie dann jeden Marketplace mit `claude plugin marketplace add <source>` erneut hinzu. Claude Code registriert die Marketplaces, die Ihre Benutzer- oder verwalteten Einstellungen in [`extraKnownMarketplaces`](https://code.claude.com/docs/de/settings-reference#extraknownmarketplaces) deklarieren, beim nächsten Start in einem Ordner, dem Sie vertraut haben, erneut.

### Plugin is required by your organization

Sie haben `claude plugin disable` ausgeführt oder den Tab **Installed** in `/plugin` verwendet, um ein [von claude.ai synchronisiertes Plugin](https://code.claude.com/docs/de/plugins/loading.md#synced-plugins) auszuschalten, das Ihre Organisation als erforderlich markiert:

```text theme={null}
Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.
```

Claude Code speichert nichts, und das Plugin bleibt aktiviert.

Wenn Sie versuchen, ein Plugin zu deaktivieren, von dem ein erforderliches Plugin abhängt, lehnt Claude Code dies auf dieselbe Weise ab, mit einer Meldung, die das erforderliche Plugin nennt, welches das zu deaktivierende Plugin benötigt.

**Vorgehensweise:**

* Bitten Sie einen Admin Ihrer claude.ai-Organisation, den Status „erforderlich“ des Plugins auf claude.ai zu ändern

### Plugin was not uninstalled

Sie haben [`claude plugin uninstall`](https://code.claude.com/docs/de/plugins/cli-reference#plugin-uninstall) ausgeführt oder im Tab **Installed** in `/plugin` **Uninstall** gewählt, und die Deinstallation wurde mit einer Meldung abgebrochen, die mit `"<plugin>" was not uninstalled:` beginnt. Wenn der Text nach diesem Doppelpunkt mit `installed_plugins.json` beginnt, anstatt eine Einstellungsdatei zu nennen, ist die Ursache ein Inhalt in `installed_plugins.json`, den diese Version von Claude Code nicht lesen kann. Für diese Form siehe [`installed_plugins.json` enthält einen Datensatz, den diese Version nicht lesen kann](https://code.claude.com/docs/de/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read).

Als Claude Code den Eintrag des Plugins aus `enabledPlugins` entfernt und die Einstellungsdateien dieses Geltungsbereichs erneut gelesen hat, war das Plugin dort entweder weiterhin eingeschaltet, oder eine Datei, die es einschalten könnte, konnte nicht gelesen oder geprüft werden. Das Löschen der gespeicherten Optionen, Geheimnisse und Daten des Plugins, während ein Einstellungseintrag es wieder einschalten könnte, würde diese verloren gehen lassen, daher bricht die Deinstallation stattdessen ab: Das Plugin bleibt installiert, und nichts, was es gespeichert hat, wird gelöscht.

```text theme={null}
✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.
```

Der mittlere Teil der Meldung nennt die Datei und die Ursache:

* `it is still switched on in <file>, although the settings change reported no error`: Das Schreiben der Einstellungen meldete Erfolg, aber der Eintrag ist beim erneuten Lesen der Datei noch vorhanden
* `it is still switched on in <file>, and the settings change failed (<error>)`: Die Datei konnte aus dem in Klammern genannten Grund nicht gespeichert werden
* `<file> is there and could not be read`: Die Datei existiert, konnte aber nicht als Einstellungen gelesen werden, zum Beispiel weil sie kein gültiges JSON ist, sodass sie das Plugin möglicherweise weiterhin aktiviert
* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code hat die Projekt- oder lokale Einstellungsdatei nicht gelesen, weil die Datei oder der Ordner `.claude`, der sie enthält, ein Link ist, der zu einem Netzwerkort führt, oder weil es diesen Pfad nicht untersuchen konnte

`claude plugin uninstall` wird mit Exit-Code 1 beendet, und mit `--json` enthält das Ergebnis `failureCode: "settings_still_on"`. `/plugin` zeigt dieselbe Meldung an.

**Vorgehensweise:**

* Befolgen Sie den letzten Satz der Meldung: Reparieren oder ersetzen Sie die genannte Einstellungsdatei oder entfernen Sie den Eintrag des Plugins selbst aus `enabledPlugins` in dieser Datei, und führen Sie die Deinstallation dann erneut aus

### Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)

Diese Meldung bedeutet, dass Claude Code einen stdio-[MCP-Server, den ein Plugin bereitstellt](https://code.claude.com/docs/de/mcp.md#plugin-provided-mcp-servers), nicht gestartet hat, weil eine Verbindung zu diesem Server vor weniger als 15 Minuten fehlgeschlagen ist:

```text theme={null}
Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)
```

Die Sitzung wird ohne die Tools des Servers fortgesetzt, und Claude Code versucht den Server in dieser Sitzung nach Ablauf der 15 Minuten nicht erneut. Wenn Sie mindestens 15 Minuten nach der letzten fehlgeschlagenen Verbindung eine neue Sitzung oder einen [`claude -p`](https://code.claude.com/docs/de/headless)-Lauf starten, versucht Claude Code den Server erneut.

**Vorgehensweise:**

So lassen Sie Claude Code den Server ohne Wartezeit erneut versuchen:

* **In einer interaktiven Sitzung**: Führen Sie `/mcp` aus, wählen Sie den Server aus und wählen Sie **Reconnect**
* **In einer [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Anwendung**: Rufen Sie in TypeScript [`reconnectMcpServer()`](https://code.claude.com/docs/de/agent-sdk/typescript#methods) oder in Python [`ClaudeSDKClient.reconnect_mcp_server()`](https://code.claude.com/docs/de/agent-sdk/python#methods) mit dem Namen des Servers auf
* **In `claude -p`**: Starten Sie eine interaktive Sitzung, die dasselbe Plugin lädt, auf demselben Rechner und mit demselben Betriebssystemkonto und demselben [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/de/env-vars)-Wert wie Ihre Läufe. Verbinden Sie den Server dort über `/mcp` erneut. Sobald er verbunden ist, versucht Claude Code die Verbindung in Ihrem nächsten Lauf.
* **Wenn Sie das Plugin entwickeln**: Ändern Sie `command`, `args` oder `env` des Servers in der `.mcp.json` oder `plugin.json` des Plugins. Claude Code versucht die Verbindung in der nächsten Sitzung oder im nächsten `claude -p`-Lauf, der den geänderten Eintrag lädt.

Die Meldung ersetzt den Fehler der fehlgeschlagenen Verbindung. Wenn auch der neue Versuch fehlschlägt, meldet Claude Code den Fehler dieses Versuchs anstelle dieser Meldung.

## Tool-Fehler

Diese Fehler stammen aus Claudes Tool-Aufrufen. Claude korrigiert die meisten Tool-Fehler automatisch. Wenn eine Änderung von Ihnen erforderlich ist, gibt die Liste **Was zu tun ist** für diesen Fehler an, was zu ändern ist.

### Kein solches Tool verfügbar

Claude hat ein Tool unter einem Namen aufgerufen, der nicht in der Tool-Liste der Sitzung enthalten ist. Claude Code gibt den Fehler als Ergebnis des Tool-Aufrufs an Claude zurück, und der Turn wird fortgesetzt. Wenn Claude Code erkennen kann, warum das Tool fehlt, fügt es nach dem Tool-Namen einen Satz hinzu, der den Grund nennt oder das stattdessen aufzurufende Tool benennt, wie in der zweiten Zeile:

```text theme={null}
Error: No such tool available: <tool name>
Error: No such tool available: read. Tool names are case-sensitive: call Read instead.
```

Direkt nachdem Sie eine Sitzung fortgesetzt haben, kann sich ein MCP-Server noch in seinem ersten Verbindungsversuch befinden, wenn Claude eines seiner Tools aufruft. Claude Code [wartet dann auf den Server](https://code.claude.com/docs/de/mcp.md#tool-availability) und gibt diesen Fehler zurück, wenn das Tool nach Ende der Wartezeit immer noch nicht verfügbar ist. Vor v2.1.284 schlug ein solcher Aufruf sofort fehl, anstatt zu warten.

Ein Aufruf, dessen Tool-Namen Claude Code [auf 200 Zeichen gekürzt hat](#tool-use-name-over-200-characters), schlägt ebenfalls mit diesem Fehler fehl.

**Was zu tun ist:**

* Wenn es einmal auftritt, müssen Sie nichts tun. Claude liest den Fehler, und der Turn wird fortgesetzt.
* Wenn Aufrufe der Tools eines MCP-Servers wiederholt mit diesem Fehler fehlschlagen, führen Sie `/mcp` in der Sitzung oder `claude mcp list` in Ihrer Shell aus, um den [Status](https://code.claude.com/docs/de/mcp.md#server-status) des Servers zu prüfen, und verbinden Sie einen fehlgeschlagenen Server über `/mcp` erneut. Im Agent SDK siehe [Fehlerbehandlung](https://code.claude.com/docs/de/agent-sdk/mcp.md#error-handling).

### MCP-Server-Verbindung wurde geschlossen, bevor der Tool-Aufruf beantwortet wurde

Ein Tool-Aufruf an einen HTTP-[MCP-Server](https://code.claude.com/docs/de/mcp.md) oder einen [claude.ai-Konnektor](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai) hat seine Verbindung verloren, bevor der Server geantwortet hat, daher kann Claude Code nicht feststellen, ob das Tool ausgeführt wurde:

```text theme={null}
MCP server "<name>" connection closed before the tool call was answered. The tool may have run: check whether it did before running it again.
```

Ein erneuter Aufruf könnte die Aktion des Tools wiederholen, etwa ein zweites Issue erstellen. Claude Code wiederholt den Aufruf daher nur dann selbstständig, und zwar einmal, wenn der Server das Tool als sicher wiederholbar markiert.

**Was zu tun ist:**

* Prüfen Sie in dem Dienst, auf den das Tool wirkt, ob die Aktion stattgefunden hat, zum Beispiel ob das Issue oder der Datensatz vorhanden ist, den es erstellen sollte
* Wenn die Aktion stattgefunden hat, führen Sie das Tool nicht erneut aus. Claude hat diese Nachricht anstelle des Tool-Ergebnisses erhalten, teilen Sie Claude also das Ergebnis mit.
* Wenn die Aktion nicht stattgefunden hat, bitten Sie Claude, das Tool erneut auszuführen. Sie müssen den Server vorher nicht neu verbinden, da Claude Code sich beim nächsten Aufruf eines seiner Tools erneut mit ihm verbindet. Wenn auch diese Verbindung fehlschlägt, siehe [Verbindungsabbrüche eines Remote-Servers während der Sitzung](https://code.claude.com/docs/de/mcp.md#mid-session-drops-of-a-remote-server).
* Wenn Sie den Server entwickeln und das Tool gefahrlos zweimal aufgerufen werden kann, [markieren Sie es als sicher wiederholbar](https://code.claude.com/docs/de/mcp.md#tool-calls-pending-when-a-connection-closes), damit Claude Code einen verlorenen Aufruf wiederholen kann

### MCP-Server ist deaktiviert

Diese Nachricht in einem Tool-Ergebnis bedeutet, dass Claude ein Tool auf einem [MCP-Server](https://code.claude.com/docs/de/mcp.md) aufgerufen hat, der [ausgeschaltet](https://code.claude.com/docs/de/mcp.md#disable-a-server-without-removing-it) ist. Claude Code hat sich nicht mit dem Server verbunden, daher wurde das Tool nicht ausgeführt, und Claude hat diesen Text anstelle eines Ergebnisses erhalten:

```text wrap theme={null}
MCP server "<name>" is disabled — re-enable it via /mcp to use its tools
```

**Was zu tun ist:**

* Wenn Sie den Server absichtlich ausgeschaltet haben, müssen Sie nichts tun
* Wenn Claude die Tools des Servers benötigt, schalten Sie ihn über `/mcp` im Eingabefeld von Claude Code wieder ein
* In einer [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Anwendung schalten Sie den Server wieder ein, indem Sie in TypeScript [`toggleMcpServer()`](https://code.claude.com/docs/de/agent-sdk/typescript#togglemcpserver) mit `enabled` auf `true` aufrufen oder in Python [`toggle_mcp_server()`](https://code.claude.com/docs/de/agent-sdk/python#claudesdkclient) mit `enabled` auf `True`

### MCP-Tool-Aufruf hat das Zeitlimit überschritten, ohne dass die Frage des Servers beantwortet wurde

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) hat ein [MCP-Server](https://code.claude.com/docs/de/mcp.md) während eines Tool-Aufrufs über [Elicitation](https://code.claude.com/docs/de/mcp.md#respond-to-mcp-elicitation-requests) eine Eingabe angefordert, und das Zeitlimit des Aufrufs lief ab, bevor eine Antwort kam:

```text theme={null}
MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit. Do not call this tool again in this turn. Tell the user that the server's question got no answer, and wait for their reply.
```

Vor v2.1.310 endete das Ergebnis bei `timed out after <N>s` und erwähnte die Frage nicht.

**Was zu tun ist:**

* Richten Sie einen [`Elicitation`-Hook](https://code.claude.com/docs/de/hooks#elicitation) ein, der die Anfragen des Servers beantwortet
* Sorgen Sie in einer TypeScript-Agent-SDK-Anwendung dafür, dass Ihr [`onElicitation`](https://code.claude.com/docs/de/agent-sdk/typescript#options)-Callback seine Antwort zurückgibt, bevor das Limit abläuft
* Um einer Antwort mehr Zeit zu geben, setzen Sie im Konfigurationseintrag des Servers einen längeren [`timeout`](https://code.claude.com/docs/de/mcp#time-limits-on-mcp-tool-calls) in Millisekunden, etwa `"timeout": 600000` für 10 Minuten
* Führen Sie die Aufgabe stattdessen in einer interaktiven Sitzung aus und beantworten Sie den [Dialog](https://code.claude.com/docs/de/mcp.md#respond-to-mcp-elicitation-requests) des Servers selbst

### Permission prompt tool returned an invalid result

Das Tool, das Sie an [`--permission-prompt-tool`](https://code.claude.com/docs/de/cli-reference#cli-flags) übergeben haben, hat eine Antwort zurückgegeben, die Claude Code nicht lesen konnte, daher wurde der Tool-Aufruf, der darauf wartete, nicht ausgeführt, selbst wenn die Antwort den Aufruf erlaubte:

```text wrap theme={null}
Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.
```

**Was zu tun ist:**

* Geben Sie einen einzigen Textblock zurück, dessen Text `{"behavior": "allow"}` oder `{"behavior": "deny", "message": "<reason>"}` lautet. Um die Eingabe zu ändern, fügen Sie `updatedInput` zum `allow`-Objekt hinzu. Von v2.1.86 bis v2.1.206 benötigte ein `allow` den Eintrag `"updatedInput": {}`, um die Eingabe beizubehalten.
* Geben Sie kein [`structuredContent`](https://code.claude.com/docs/de/agent-sdk/custom-tools#return-structured-data) zurück, das Ihr MCP SDK möglicherweise selbstständig hinzufügt. Registrieren Sie das Tool zum Beispiel:
  * **`FastMCP` oder `MCPServer` aus `mcp.server`**: mit `structured_output=False`
  * **`FastMCP` aus `fastmcp`**: mit `output_schema=None`, und geben Sie einen String zurück
  * **MCP TypeScript SDK**: ohne `outputSchema`
* Wenn der Fehler nur bei Eingaben von etwa 40 KB oder mehr auftritt, kopieren Sie die Eingabe nicht in `updatedInput` oder in die `message` einer Ablehnung. Um eine so große Eingabe zu ändern, [erhöhen Sie das Ausgabelimit Ihres Prompt-Tools](https://code.claude.com/docs/de/mcp.md#raise-the-limit-for-a-specific-tool).

### Agent würde mit null Tools erzeugt

Jeder Eintrag in der [`tools`-Liste](https://code.claude.com/docs/de/sub-agents#supported-frontmatter-fields) des Subagenten konnte mit keinem verwendbaren Tool abgeglichen werden, daher weigerte sich Claude Code, den Subagenten zu starten: Ohne Tools konnte er nicht handeln. Die Nachricht gruppiert Ihre Einträge nach dem, was schiefgelaufen ist:

* **Unbekannt**: Der Eintrag stimmt mit keinem Tool-Namen überein, normalerweise ein Tippfehler wie `Grpe` für `Grep`.
* **Nicht für Subagenten verfügbar**: Der Eintrag benennt ein echtes Tool, das [Subagenten nicht verwenden können](https://code.claude.com/docs/de/sub-agents.md#available-tools). Hintergrund-Subagenten behalten einen kleineren integrierten Tool-Satz, daher landet ein Eintrag, den nur ein Vordergrund-Subagent verwenden kann, hier, wenn der Subagent im Hintergrund ausgeführt würde, was die Standardeinstellung ist. Wenn Sie `Agent` auflisten, meldet die Nachricht ihn stattdessen unter der nächsten Gruppe.
* **Stimmt mit keinen Tools in dieser Sitzung überein**: Der Eintrag ist gültig, aber kein Tool in der aktuellen Sitzung stimmt gerade damit überein, wie `mcp__github__*` ohne verbundenen GitHub-MCP-Server oder `Agent` für einen Subagenten am [Tiefenlimit](https://code.claude.com/docs/de/sub-agents.md#let-subagents-spawn-their-own-subagents).

Das Weglassen des `tools`-Feldes löst diese Weigerung nie aus. Wenn Sie die `tools`-Liste leer lassen oder `disallowedTools` jeden Eintrag darin entfernt, überspringt Claude Code die Weigerung auch und startet den Subagenten ohne Tools.

Vor v2.1.208 wurde der Subagent ohne Tools gestartet und konnte ein leeres oder verwirrendes Ergebnis zurückgeben.

```text theme={null}
Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
```

**Was zu tun ist:**

* Korrigieren Sie jeden Eintrag, den der Fehler benennt, anhand der [für Subagenten verfügbaren Tools](https://code.claude.com/docs/de/sub-agents.md#available-tools)
* Entfernen Sie Einträge für Tools, die die Sitzung nicht hat, wie MCP-Tools von einem Server, der nicht verbunden ist
* Wenn der Eintrag einen verbundenen MCP-Server benennt, vergleichen Sie den Eintrag mit dem Namen dieses Servers, wie ihn die [Tool-Namen](https://code.claude.com/docs/de/permissions.md#mcp) des Servers schreiben, etwa `reports__v2` in `mcp__reports__v2__get_totals`. Schreiben Sie für diesen Server `mcp__reports__v2__*`, also `mcp__` gefolgt vom vollständigen Namen und `__*`. Mit dem kürzeren `mcp__reports`, das einen Server namens `reports` benennt, erhält der Subagent keines der `reports__v2`-Tools
* Für ein Tool, das [Hintergrund-Subagenten ablegen](https://code.claude.com/docs/de/sub-agents.md#available-tools), wie `CronCreate`, entfernen Sie den Eintrag
* Um stattdessen ein Tool wie `CronCreate` zu behalten, [lassen Sie Claude auf den Subagenten warten](https://code.claude.com/docs/de/sub-agents.md#let-claude-wait-for-a-subagent), da ein Subagent, auf den Claude wartet, im Vordergrund ausgeführt wird und das Tool behält. Wenn die Definition `background: true` setzt, entfernen Sie zuerst dieses Feld, da es den Subagenten im Hintergrund hält
* Löschen Sie das `tools`-Feld, anstatt Tools aufzulisten, um dem Subagenten alle [für Subagenten verfügbaren Tools](https://code.claude.com/docs/de/sub-agents.md#available-tools) zu geben
* Für eine `tools`-Liste, die nur `Agent` enthält, erhöhen Sie das [Tiefenlimit](https://code.claude.com/docs/de/sub-agents.md#let-subagents-spawn-their-own-subagents) oder geben Sie dem Agenten mindestens ein anderes Tool: Claude Code behält `Agent` bei diesem Limit zurück, daher wird eine Liste mit nichts anderem darin zu keinen Tools aufgelöst

### Datei wird durch eine Read-Ablehnungsregel abgedeckt

Das Edit- oder Write-Tool wurde auf einem Pfad aufgerufen, der einer [`Read`-Ablehnungsregel](https://code.claude.com/docs/de/permissions#read-and-edit) entspricht, einschließlich der Erstellung einer neuen Datei unter diesem Pfad. Beide Tools ändern Inhalte, die Claude zurücklesen können muss, daher lehnt Claude Code den Aufruf vor jedem Dateizugriff ab. NotebookEdit wird nicht durch `Read`-Ablehnungsregeln abgedeckt. Vor v2.1.228 blockierte die Regel nur das Edit-Tool, und vor v2.1.208 blockierte nur eine `Edit`-Ablehnungsregel Bearbeitungen.

```text theme={null}
File is covered by a Read deny rule in your permission settings and cannot be edited.
```

Wenn Claude Code das Write-Tool ablehnt, endet die Nachricht stattdessen mit `and cannot be written`.

**Was zu tun ist:**

* Wenn Claude die Datei ändern können sollte, entfernen oder verengen Sie die `Read`-Ablehnungsregel in `/permissions` oder in [Einstellungen](https://code.claude.com/docs/de/settings-reference.md#permission-settings)
* Wenn die Datei unverändert bleiben muss, behalten Sie die Regel und fügen Sie eine `Edit`-Ablehnungsregel für denselben Pfad hinzu, um auch das NotebookEdit-Tool zu blockieren

### Einstellung blockiert Schreibvorgänge außerhalb der Arbeitsverzeichnisse

Wenn Claude versucht, eine Datei zu schreiben, und der Tool-Aufruf mit dieser Nachricht fehlschlägt, liegt der Pfad außerhalb der [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories) der Sitzung, und [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockwritesoutsideworkingdirectories) ist aktiviert:

```text wrap theme={null}
<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories. Ask the user to add the directory with /add-dir, or to remove that setting.
```

Claude Code lehnt diesen Schreibvorgang in jedem Berechtigungsmodus ab. Die Weigerung kann auch so lauten:

```text wrap theme={null}
<path>: Writes outside the working directories are blocked (permissions.blockWritesOutsideWorkingDirectories). Add the directory with /add-dir, or remove that setting.
```

**Was zu tun ist:**

* Wenn Claude dort nicht schreiben soll, tun Sie nichts
* Damit Claude in ein vorhandenes Verzeichnis schreiben kann, das den Pfad enthält, führen Sie `/add-dir <directory>` im Eingabefeld von Claude Code aus, oder übergeben Sie `--add-dir <directory>` beim Start von Claude Code
* Wenn der Pfad eine Einstellungsdatei von Claude Code ist, etwa `~/.claude/settings.json`, bearbeiten Sie sie selbst. Das Hinzufügen ihres Verzeichnisses mit `/add-dir` hilft nicht, da Claude Code den Schreibvorgang dann [als Einstellungsdatei](#writes-to-claude-code-settings-files-are-blocked) ablehnt.
* Um ein Verzeichnis in jeder Sitzung beschreibbar zu halten, führen Sie es unter [`permissions.additionalDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-additionaldirectories) in Ihren Benutzer- oder verwalteten Einstellungen auf
* Um `permissions.blockWritesOutsideWorkingDirectories` auszuschalten, entfernen Sie es aus jeder Einstellungsdatei, die es setzt, und starten Sie Claude Code dann neu
* Wenn keine Ihrer Einstellungsdateien `permissions.blockWritesOutsideWorkingDirectories` enthält, kann es aus `--settings` oder aus einer Host-Anwendung stammen. Claude Code lehnt diese Schreibvorgänge außerdem ab, solange es `permissions` in Ihren [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md#keys-that-fail-closed) nicht lesen kann. Fragen Sie die Person, die die Sitzung startet oder verwaltet.

### Schreibvorgänge in Einstellungsdateien von Claude Code sind blockiert

Wenn Claude versucht, eine Datei zu schreiben, und der Tool-Aufruf mit dieser Nachricht fehlschlägt, behandelt Claude Code die Datei als eine seiner Einstellungsdateien, und [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockwritesoutsideworkingdirectories) ist aktiviert:

```text wrap theme={null}
<path>: Writes to Claude Code settings files are blocked while permissions.blockWritesOutsideWorkingDirectories is on, because a settings file can lift that block. While a managed settings folder cannot be resolved, any .json file counts as one.
```

**Was zu tun ist:**

* Um eine Einstellung zu ändern, bearbeiten Sie die Einstellungsdatei selbst
* Damit Claude Einstellungsdateien wieder bearbeiten kann, entfernen Sie `permissions.blockWritesOutsideWorkingDirectories` aus jeder Einstellungsdatei, die es setzt, und starten Sie Claude Code dann neu
* Wenn die Datei keine Ihrer Einstellungsdateien ist, finden Sie sie unter den anderen Dateien, die Claude Code als Einstellungsdateien behandelt:
  * **Eine Datei, die Sie an `--agents` oder `--mcp-config` übergeben haben**: Bearbeiten Sie sie selbst
  * **Die gespeicherte Kopie der [serververwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md#security-considerations) und die zusammen mit ihr abgelegten Dateien**: Bitten Sie einen [Owner](https://code.claude.com/docs/de/server-managed-settings.md#access-control), die Einstellung in den serververwalteten Einstellungen zu ändern.
  * **Jede `.json`-Datei, solange Claude Code nicht ermitteln kann, wohin der Ordner [`managed-settings.d/`](https://code.claude.com/docs/de/managed-settings#split-a-file-based-policy-across-teams) führt**: Bitten Sie Ihren Administrator, diesen Ordner zu überprüfen

### Pfad kann keine Null-Bytes enthalten

Das Pfad- oder Muster-Argument eines Datei-Tool-Aufrufs enthielt ein Null-Byte, das Dateisysteme und Such-Tools nicht akzeptieren können. Read, Write, Edit, NotebookEdit, Glob und Grep überprüfen dies, und die Nachricht benennt das Tool und das Argument:

```text theme={null}
Read file_path cannot contain null bytes (\0). Remove the null byte and try again.
```

Der Tool-Aufruf schlägt fehl, Claude sieht den Fehler, und der Turn wird fortgesetzt.

**Was zu tun ist:**

* Nichts auf Ihrer Seite: Der Fehler wird an Claude als Ergebnis des Tools zurückgegeben, und die Nachricht selbst weist Claude an, das Null-Byte zu entfernen und es erneut zu versuchen

Vor v2.1.281 beendete ein Null-Byte in einem Read-, Write-, Edit- oder NotebookEdit-Pfad den ganzen Turn mit einem Fehler, der `Path contains null bytes` nannte, und das Tool wurde nie ausgeführt.

### Befehl enthält ein unsichtbares Zeichen

Das [PowerShell-Tool](https://code.claude.com/docs/de/tools-reference.md#powershell-tool) hat sich geweigert, einen Befehl auszuführen, der U+FEFF oder U+180E enthält:

```text theme={null}
Error: command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run. Remove the character, keep the text that needs it in a file that the command reads, or write it as $([char]0xFEFF) or $([char]0x180E) inside a double-quoted string
```

**Was zu tun ist:**

* **Für einen Befehl, den Claude geschrieben hat**: Sie müssen nichts beheben. Die Nachricht teilt Claude mit, wie der Befehl umzuschreiben ist.
* **Für eine Skill- oder Befehlsdatei**: Die Nachricht folgt auf `No shell command in <name> was run`. Siehe [wo Sie das Zeichen finden und wie Sie es entfernen](#no-shell-command-was-run).

### Genehmigter Befehl wurde nach dem Neustart von Claude Code nicht ausgeführt

Ein Shell-Befehl, den Sie genehmigt haben, wurde nicht ausgeführt, und Claude erhält diese Nachricht als Ergebnis des Befehls:

```text wrap theme={null}
This call was not run. Claude Code could not confirm that the shell is back in the directory where it was approved. That directory may be gone or replaced, lie outside the directory where the session started, or be one that Claude Code needs approval to enter or is not allowed to examine. The shell's directory is <directory>. If the command still makes sense, cd to the directory it was meant for and make the call again; it may need approval again.
```

Der dritte Satz der Nachricht kann stattdessen `It does not keep track of that directory across a restart in a session that has been in a worktree.` lauten.

**Was zu tun ist:**

* Lassen Sie Claude fortfahren, und beantworten Sie die Berechtigungsabfrage, falls Sie gebeten werden, den Befehl erneut zu genehmigen.

### Datei ist zu groß, um als Bild gelesen zu werden

Claude hat versucht, eine Datei mit dem [Read-Tool](https://code.claude.com/docs/de/tools-reference.md#read-tool-behavior) als Bild zu lesen, und die Datei ist größer als 128 MB, die maximale Größe, die Read aus einer Bilddatei lädt. Es wurde nichts gelesen, und Claude erhält diesen Fehler als Tool-Ergebnis:

```text wrap theme={null}
File is too large to read as an image (the limit is 128MB): <path>. If it is an image, resize it or export a smaller copy, then read that.
```

Wenn der Pfad eine Pipe oder ein Gerät statt einer regulären Datei ist, bricht Read ab, sobald mehr als 128 MB eingegangen sind, und gibt stattdessen diesen Fehler zurück:

```text wrap theme={null}
Cannot read this as an image: <path> is a pipe or a device, not a regular file, and it sent more than 128MB without ending.
```

**Was zu tun ist:**

* Wenn Claude der Nachricht `File is too large` gefolgt ist und das Bild anschließend verkleinert oder eine kleinere Kopie gelesen hat, tun Sie nichts
* Wenn Claude beim Fehler aufgehört hat, exportieren Sie selbst eine Kopie unter 128 MB, zum Beispiel mit einer niedrigeren Auflösung, und verweisen Sie Claude auf diese Datei
* Wenn der Pfad eine Pipe oder ein Gerät war, verweisen Sie Claude stattdessen auf eine reguläre Bilddatei

### subagent\_type ist erforderlich

```text theme={null}
subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...
```

Claude hat das [Agent-Tool](https://code.claude.com/docs/de/tools-reference.md#agent-tool-behavior) ohne `subagent_type` aufgerufen, und diese Sitzung hat keinen [allgemeinen Subagenten](https://code.claude.com/docs/de/sub-agents.md#built-in-subagents) als Fallback. Das ist in zwei Setups der Fall:

* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](https://code.claude.com/docs/de/env-vars) ist im nicht interaktiven Modus gesetzt, was jeden integrierten Subagenten entfernt
* Der Hauptthread-Agent der Sitzung hat eine [`tools: Agent(...)`-Allowlist](https://code.claude.com/docs/de/sub-agents#restrict-which-subagents-can-be-spawned), die `general-purpose` ausschließt

**Was zu tun ist:**

* Normalerweise nichts: Die Nachricht listet die Subagenten auf, die die Sitzung hat, daher kann Claude es mit einem von ihnen erneut versuchen
* Wenn Claude weiterhin fehlschlägt, fügen Sie `general-purpose` zur `tools: Agent(...)`-Allowlist hinzu, oder heben Sie `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` auf

Vor v2.1.235 schlug derselbe Aufruf mit `Agent type 'general-purpose' not found` fehl.

### Memory-Index überschreitet sein Leselimit

Claude schrieb in den [Auto-Memory](https://code.claude.com/docs/de/memory.md#auto-memory)-Index `MEMORY.md` und hinterließ ihn über einem seiner Leselimits: 200 Zeilen oder 25 KB. Der Schreibvorgang war erfolgreich, aber nur die ersten 200 Zeilen oder 25 KB, je nachdem, was zuerst erreicht wird, werden zu Beginn einer Sitzung geladen, daher wird alles über dem Limit jedes Mal verworfen, wenn der Index gelesen wird. Vor v2.1.210 wurde ein über dem Limit liegender Index beim nächsten Laden stillschweigend gekürzt, ohne ein Signal zum Zeitpunkt des Schreibens.

```text theme={null}
Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.
```

Nur der Inhalt, der geladen wird, zählt zu den Limits. YAML-Frontmatter und Block-Level-HTML-Kommentare werden entfernt, bevor der Index geladen wird, daher sind sie von der Messung ausgeschlossen. Vor v2.1.211 maß Claude Code die Rohdatei, und Frontmatter oder Kommentare konnten diesen Fehler auslösen, selbst wenn der geladene Inhalt passte.

Claude Code liefert den Fehler nach dem Schreibvorgang an Claude, anstatt ihn als Banner in Ihrem Terminal auszugeben, daher bemerken Sie ihn möglicherweise nur im Transkript.

Wenn Claudes Schreibvorgang die Datei nahe an ein Limit bringt, ohne es zu überschreiten, gibt Claude Code anstelle dieses Fehlers eine mildere Erinnerung zurück, den Index zu verdichten.

**Was zu tun ist:**

* Lassen Sie Claude `MEMORY.md` umschreiben, oder bitten Sie ihn darum: Behalten Sie eine Zeile pro Eintrag, verschieben Sie Details in Themendateien, und führen Sie veraltete Einträge zusammen oder löschen Sie sie
* Um den Index selbst zu kürzen, siehe [Ihr Memory prüfen und bearbeiten](https://code.claude.com/docs/de/memory.md#audit-and-edit-your-memory)

### pkill-Muster stimmt mit dem Claude Code-Prozess überein

Ein `pkill`-Befehl in einem Bash-Tool-Aufruf verwendete ein Muster, normalerweise mit `-f`, das mit dem Claude Code-Prozess selbst übereinstimmt, daher lehnt Claude Code den Befehl ab, anstatt ihn die Sitzung beenden zu lassen. Claude Code testet das Muster mit `pgrep`, bevor `pkill` ausgeführt wird, und lehnt ab, wenn seine eigene Prozess-ID im Ergebnis enthalten ist. Die Überprüfung läuft nur unter Linux; unter macOS wird `pkill` unverändert ausgeführt. Vor v2.1.214 wurde der Befehl ausgeführt, und ein übereinstimmendes Muster beendete die Claude Code-Sitzung mitten im Turn.

```text theme={null}
pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.
```

Die Weigerung erscheint im Bash-Tool-Ergebnis statt als Banner in Ihrem Terminal, und Claude passt den Befehl normalerweise selbst an.

**Was zu tun ist:**

* Verengen Sie das Muster, damit es nur den beabsichtigten Prozess abgleicht, zum Beispiel den vollständigen Pfad der Ziel-Binärdatei anstelle einer kurzen Teilzeichenfolge
* Um Prozesse zu stoppen, die von der aktuellen Shell gestartet wurden, verwenden Sie `pkill -P $$` mit dem Muster, was die Übereinstimmung auf die eigenen untergeordneten Prozesse der Shell beschränkt

### Fehler beim Schreiben in den Posteingang eines Teamkollegen

Claude Code konnte keine Nachricht in die Postfachdatei eines Teamkollegen unter `~/.claude/teams/{team-name}/inboxes/` schreiben, daher erhielt der Empfänger nichts. Der Schreibvorgang schlägt fehl, wenn Claude Code die Datei nicht erstellen oder aktualisieren kann, zum Beispiel weil die Festplatte voll ist, das Verzeichnis nicht beschreibbar ist oder ein anderer Agent die Posteingangssperre zu lange hält. Vor v2.1.224 meldete Claude Code die Nachricht als gesendet, selbst wenn der Schreibvorgang fehlschlug.

Der Fehler erscheint im Tool-Ergebnis des sendenden Agenten statt als Banner in Ihrem Terminal, und sein Text weist Claude an, es erneut zu versuchen:

```text theme={null}
Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.
```

Strukturierte [Agent-Team](https://code.claude.com/docs/de/agent-teams.md)-Protokollnachrichten schlagen auf die gleiche Weise fehl, und der Fehler benennt die nicht zugestellte Nachricht: Wenn Claude Code eine Plan-Genehmigung, Plan-Ablehnung, Shutdown-Anfrage oder Shutdown-Ablehnung nicht schreiben kann, lautet der Fehler `Failed to write the <message> to <name>'s inbox — nothing was sent`. Die `plan approval` in dieser Liste ist die Entscheidung des Leads, den Plan eines Teamkollegen zu genehmigen; die Plan-Einreichung des Teamkollegen ist die separate Nachricht `plan approval request`. Diese Nachricht und zwei weitere Protokollnachrichten haben ihren eigenen Nachrichtentext und ihre eigene Konsequenz:

* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: Der Plan des Teamkollegen erreichte den Lead nie, und der Teamkollege bleibt im Plan-Modus, bis eine erneute Einreichung erfolgreich ist
* `The permission request could not be delivered to the team lead (mailbox write failed)`: Die Berechtigungsanfrage des Teamkollegen erreichte den Lead nie, daher genehmigte niemand den Tool-Aufruf
* `The confirmation could not be written to team-lead's inbox.`: Die Shutdown-Genehmigung selbst trat in Kraft und der Teamkollege beendet sich; nur die Bestätigung an den Lead fehlt

Wenn Sie selbst einem Teamkollegen eine Nachricht senden, indem Sie `@name` gefolgt von der Nachricht in der Lead-Sitzung eingeben, erscheint derselbe Fehler als Benachrichtigung, `Couldn't write to @name's inbox — message not sent. Try again.`, und Claude Code behält Ihren Text im Eingabefeld, damit Sie ihn erneut senden können.

**Was zu tun ist:**

* Bitten Sie den Absender, die Nachricht erneut zu senden; Konkurrenz um die Posteingangssperre ist vorübergehend und löst sich bei einem Wiederholungsversuch auf
* Überprüfen Sie den freien Speicherplatz, und überprüfen Sie, dass `~/.claude/teams` und die Dateien darunter für Ihren Benutzer beschreibbar sind

### Agent-Definition des Teamkollegen wurde nicht wiederhergestellt

Claude sendete einem gestoppten [Agent-Team](https://code.claude.com/docs/de/agent-teams.md)-Teamkollegen eine Nachricht, und Claude Code brachte ihn zurück, ohne die [Subagenten-Definition](https://code.claude.com/docs/de/agent-teams.md#use-subagent-definitions-for-teammates) erneut anzuwenden, aus der er erzeugt wurde. Der Hinweis folgt dem Wiederaufnahmebericht im Tool-Ergebnis des sendenden Agenten und nennt den Grund. Wenn die Definitionsdatei aus einem Ordner ohne gespeichertes Vertrauen stammte, lautet er:

```text wrap theme={null}
Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.
```

Die Überprüfung gilt für eine Definition im `.claude/agents/`-Verzeichnis des Projekts oder eines `--add-dir`-Verzeichnisses, und das Akzeptieren des Vertrauensdialogs für einen übergeordneten Ordner erfüllt sie nicht.

**Was zu tun ist:**

* Führen Sie `claude` in dem Ordner aus, den das [Debug-Log](https://code.claude.com/docs/de/debug-your-config.md) benennt, und akzeptieren Sie den Vertrauensdialog. Die Definition wird erneut angewendet, wenn Claude Code den Teamkollegen das nächste Mal zurückbringt; Sie müssen die Lead-Sitzung nicht neu starten
* Oder setzen Sie den Eintrag `hasTrustDialogAccepted` in `~/.claude.json` auf `true`, wobei Sie genau den `projects["<path>"]`-Schlüssel verwenden, den das Debug-Log ausgibt

### Nur ein Teamkollege kann eine Shutdown-Anfrage genehmigen

Claude Code hat eine Shutdown-Genehmigung in einem [Agent-Team](https://code.claude.com/docs/de/agent-teams.md) abgelehnt, weil die Sitzung, die sie gesendet hat, nicht als Teamkollege läuft. Es wurde nichts gesendet und nichts heruntergefahren. Die Weigerung erscheint im Tool-Ergebnis der sendenden Sitzung:

```text wrap theme={null}
Only a teammate can approve a shutdown request, and this session is not running as one. Nothing was sent. To shut down a teammate, send that teammate a shutdown_request message. The teammate is the one that approves it.
```

**Was zu tun ist:**

* Wenn die Weigerung in Ihrer Lead-Sitzung erschienen ist, prüfen Sie zuerst, ob der Teamkollege inzwischen heruntergefahren ist. Die Weigerung geht mit der Anweisung an Claude zurück, stattdessen eine `shutdown_request` zu senden, und der Turn wird fortgesetzt. In einer interaktiven Lead-Sitzung erscheint `<name> has shut down.`, wenn der Teamkollege eine Shutdown-Anfrage genehmigt.
* Wenn der Teamkollege noch läuft, bitten Sie den Lead in dessen Eingabefeld, den Teamkollegen herunterzufahren, zum Beispiel mit `Ask the researcher teammate to shut down`. Siehe [Teamkollegen herunterfahren](https://code.claude.com/docs/de/agent-teams.md#shut-down-teammates).
* Wenn ein ehemaliger Teamkollege, den Sie selbst mit `claude --resume` fortgesetzt haben, diese Weigerung erhalten hat, wurde nichts gesendet. Um diese Sitzung zu beenden, führen Sie `/exit` in deren Eingabefeld aus.

### A command-line deny rule cannot be handed to a teammate intact

Diese Nachricht bedeutet, dass Claude Code einen [Split-Pane](https://code.claude.com/docs/de/agent-teams.md#choose-a-display-mode)-Teamkollegen in Ihrem [Agent-Team](https://code.claude.com/docs/de/agent-teams.md) nicht gestartet hat. Claude Code übergibt die Befehlszeilen-Ablehnungsregeln des Leads über die eigene Befehlszeile des Teamkollegen an einen Split-Pane-Teamkollegen und bricht ab, wenn der Teamkollege eine davon anders lesen würde:

```text wrap theme={null}
The deny rule "<rule>" cannot be handed to a teammate intact, so the teammate was not started. Remove that rule or move it to permissions.deny in settings, then try again.
```

**Was zu tun ist:**

* Führen Sie `/config` in der Lead-Sitzung aus und setzen Sie **Teammate mode** auf `in-process`. Wenn die Zeile `overridden` anzeigt und bereits `in-process` zeigt, wechseln Sie durch die Werte, bis Sie wieder bei diesem Wert sind. Bitten Sie Claude dann, den Teamkollegen erneut zu starten. Ein In-Process-Teamkollege [läuft unter den aktuellen Ablehnungsregeln des Leads](https://code.claude.com/docs/de/agent-teams.md#permissions).
* Spätere Sitzungen, die [`teammateMode`](https://code.claude.com/docs/de/settings-reference#teammatemode) aus Ihren Benutzereinstellungen übernehmen, starten Teamkollegen ebenfalls in-process, da `/config` die Auswahl dort speichert. Um in einer späteren Sitzung zu geteilten Bereichen zurückzukehren, setzen Sie **Teammate mode** auf `auto`, `tmux` oder `iterm2`, je nachdem, was Sie zuvor verwendet haben.

### Nachricht zu groß für sitzungsübergreifende Zustellung

Claudes [sitzungsübergreifende Nachricht](https://code.claude.com/docs/de/cross-session-messaging.md) an eine andere Ihrer Sitzungen auf diesem Rechner war zu lang zum Senden. Claude Code lehnte sie ab, und die empfangende Sitzung erhielt nichts. Die Weigerung erscheint im Tool-Ergebnis der sendenden Sitzung, nicht als Banner in Ihrem Terminal. Sie nennt beide Größen und wie die Nachricht passend gemacht werden kann:

```text wrap theme={null}
Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.
```

Das erneute Senden desselben Textes schlägt auf die gleiche Weise fehl.

**Was zu tun ist:**

* Bitten Sie Claude, die Nachricht zusammenzufassen oder den umfangreichen Inhalt in eine Datei zu legen und den Pfad der Datei zu senden
* Bitten Sie Claude, den Inhalt auf mehrere kürzere Nachrichten zu verteilen

Vor v2.1.235 meldete Claude Code eine übergroße Nachricht als gesendet. Die empfangende Sitzung verwarf sie ungelesen.

### Zu viele Nachrichten an diese Sitzung gerade eben

Claude sendete eine schnelle Folge von [sitzungsübergreifenden Nachrichten](https://code.claude.com/docs/de/cross-session-messaging.md) an eine Ihrer Sitzungen auf diesem Rechner, und die Folge erreichte das, was der Posteingang dieser Sitzung akzeptiert. Claude Code lehnte das nächste Senden ab, und die empfangende Sitzung erhielt nichts davon. Die Weigerung erscheint im Tool-Ergebnis der sendenden Sitzung, nicht als Banner in Ihrem Terminal:

```text wrap theme={null}
Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.
```

**Was zu tun ist:**

* Normalerweise nichts: Claude fasst den verbleibenden Inhalt in einer Nachricht zusammen oder wartet, bevor es weitere sendet
* Wenn Sie die Folge selbst ausgelöst haben, bitten Sie Claude, das Verbleibende in einer einzigen Nachricht zusammenzufassen

Vor v2.1.236 meldete Claude Code diese Sendevorgänge als gesendet. Die empfangende Sitzung verwarf sie ungelesen.

### Sitzungsübergreifende Nachricht wurde am Posteingang der Empfänger-Sitzung verworfen

Claude sendete eine [sitzungsübergreifende Nachricht](https://code.claude.com/docs/de/cross-session-messaging.md) an eine andere Ihrer Sitzungen auf diesem Rechner, und der Posteingang dieser Sitzung verwarf sie, bevor Claude in dieser Sitzung sie las. Die Zeile nennt den Empfänger und fügt, wenn der Empfänger einen Grund angab, den Grund nach einem Gedankenstrich hinzu:

```text wrap theme={null}
Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.
```

Eine Zeile kann mehrere verworfene Nachrichten abdecken. Sie beginnt dann im Plural, zum Beispiel `Cross-session messages (12) were dropped`. Um herauszufinden, zu welcher Sitzung eine Adresse gehört, vergleichen Sie sie mit der [Zeile `Peer address`](https://code.claude.com/docs/de/cross-session-messaging#the-sessions-inbox-socket), die `/status` in jeder Sitzung anzeigt.

Nach dem Gedankenstrich gibt die Zeile einen oder mehrere dieser Gründe an:

* `its queue of undelivered peer messages was full`: Der Empfänger hielt bereits so viele nicht zugestellte Nachrichten von anderen Sitzungen, wie seine Warteschlange zulässt
* `you sent faster than that session accepts`: Die Nachrichten der sendenden Sitzung kamen schneller an, als der Empfänger von einem einzelnen Absender akzeptiert
* `it repeated your previous message`: Die Nachricht war identisch mit einer, die die sendende Sitzung diesem Empfänger kurz zuvor gesendet hatte
* `a relay loop between sessions was cut`: Die Nachricht setzte eine lange [Kette von Antworten fort, die abgeschnitten werden kann](https://code.claude.com/docs/de/cross-session-messaging.md#limitations), etwa eine, die eine Sitzung außerhalb dieses Rechners einschließt

**Was zu tun ist:**

* Gehen Sie davon aus, dass der Empfänger die verworfenen Nachrichten nie gesehen hat. Claude Code teilt Claude dasselbe mit und weist es an, alles, was noch wichtig ist, in eine spätere Nachricht aufzunehmen, anstatt sofort erneut zu senden
* Wenn Ihre Sitzungen sich häufig gegenseitig Updates senden, bitten Sie Claude, weniger, dafür größere Nachrichten zu senden, etwa einen Bericht, wenn eine Sitzung ihre Arbeit beendet
* Bei `a relay loop between sessions was cut` geben Sie die nächste Anweisung selbst in eine der Sitzungen ein. Eine Nachricht, die Claude als Antwort auf Ihren eigenen Prompt sendet, beginnt eine neue Kette

Vor v2.1.238 erhielt die sendende Sitzung keinen Bericht, wenn der Posteingang des Empfängers eine Nachricht verwarf.

### Weigerung, eine sitzungsübergreifende Nachricht zu senden

Bevor Claude Code eine [sitzungsübergreifende Nachricht](https://code.claude.com/docs/de/cross-session-messaging.md) an eine andere Ihrer Sitzungen auf diesem Rechner schreibt, überprüft es, dass der Posteingangs-Socket der Ziel-Sitzung der Endpunkt ist, an den die Nachricht adressiert wurde. Wenn eine Überprüfung fehlschlägt, lehnt Claude Code das Senden in der sendenden Sitzung ab, und die Ziel-Sitzung erhält nichts. Für eine Nachricht, die Claude sendet, erscheint die Weigerung im Tool-Ergebnis der sendenden Sitzung:

```text theme={null}
Failed to send to api-worker: Refusing to send: reply target is a symlink
```

Der Text nach `Refusing to send:` benennt die Überprüfung, die fehlgeschlagen ist:

* `reply target is a symlink`: Am Socket-Pfad der Ziel-Sitzung befindet sich ein symbolischer Link. Claude Code stellt nicht über ihn zu, weil ein Link dort die Nachricht an einen Endpunkt umleiten könnte, den die Ziel-Sitzung nicht erstellt hat.
* `cannot vet reply target`: Claude Code konnte den Zielpfad überhaupt nicht untersuchen, zum Beispiel weil das Lesen mit einem Berechtigungsfehler fehlschlug.

**Was zu tun ist:**

* Normalerweise nichts: Die Überprüfungen verhindern, dass eine Nachricht einen anderen Endpunkt als die Sitzung erreicht, an die sie adressiert wurde, und es wurde nichts gesendet
* Wenn `reply target is a symlink` für eine Sitzung wiederholt auftritt, überprüfen Sie, was einen Link am Socket-Pfad dieser Sitzung erstellt hat, der in ihrem `/status` unter `Peer address` angezeigt wird

### Weigerung, einen Pfad zu lesen, zu schreiben oder zu durchsuchen

Claude Code überprüft die [Berechtigungsregeln](https://code.claude.com/docs/de/permissions.md#read-and-edit) eines Dateipfads und bestätigt diese Auflösung dann erneut, wenn das Tool die Datei öffnet oder die Suche startet. Wenn es nicht bestätigen kann, dass der Pfad immer noch zu dem Ort führt, den die Überprüfung genehmigt hat, lehnt Claude Code die Operation ab, anstatt dem Pfad zu folgen. Die Weigerung erscheint im Tool-Ergebnis:

```text wrap theme={null}
Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.
```

Jede Weigerung nennt ihren Grund:

* `its symlink resolution changed after permission was checked`: Ein Symlink entlang des Pfads oder an einer Grep- oder Glob-Suchwurzel wurde zwischen der Berechtigungsprüfung und der Operation ersetzt. Bei einer Leseverweigerung benennt der eingeklammerte Ausdruck, welcher Vergleich fehlschlug.
* `its parent-directory symlink resolution changed after permission was checked`: Ein Verzeichnis, das der Schreibpfad durchläuft, wird nicht mehr zu dem genehmigten Ort aufgelöst
* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code konnte dem Pfad nicht bis zu einem endgültigen Ort auf der Festplatte folgen, zum Beispiel weil Symlinks darauf eine Schleife bilden
* `it is a symbolic link. Write to the link's target path instead`: Am angeforderten Schreibort selbst befindet sich ein symbolischer Link, zum Beispiel eine `CLAUDE.md`, die ein Symlink auf `AGENTS.md` ist; die Nachricht verweist Claude auf das Ziel des Links
* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: dieselbe Bedingung, erkannt, wenn ein anderer Schreibvorgang die Datei öffnet, etwa ein Schreiben in eine per Symlink verknüpfte `.mcp.json`
* `Refusing to write into symlinked directory: <path>`: Das Verzeichnis, das die Datei enthält, ist selbst ein symbolischer Link, zum Beispiel das `.claude/`-Verzeichnis eines Projekts, das auf einen anderen Ort verlinkt ist
* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: Eine `Read`-Ablehnungsregel für die Suche nennt einen Pfad, der durch einen Symlink führt, und dieser Link änderte sich, während Claude Code die Suche vorbereitete
* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: Die Suchwurzel existiert, konnte aber nicht geöffnet werden; der eingeklammerte Code ist der Betriebssystemfehler
* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code hat den Genehmigungsdatensatz bei vielen gleichzeitigen Dateivorgängen verworfen, bevor das Tool ihn verwendete; ein erneuter Versuch führt eine neue Berechtigungsprüfung durch
* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code konnte die `rg`-Binärdatei nicht zu einem absoluten Pfad auflösen, daher lehnt es Suchen außerhalb des Arbeitsverzeichnisses ab, anstatt eine auszuführen, die Ihre Ablehnungsregeln nicht abdecken

**Was zu tun ist:**

* Normalerweise nichts: Die Weigerung erreicht Claude als Tool-Ergebnis, und die abgelehnte Operation wird nicht ausgeführt
* Wenn eine Symlink-Weigerung auf einem Pfad wiederholt auftritt, finden Sie heraus, was dort ständig einen Link umschreibt, etwa ein Build-Tool oder ein File-Watcher, oder bitten Sie Claude, den aufgelösten Pfad der Datei anstelle des verlinkten zu verwenden
* Wenn diese Weigerung für jede Datei erscheint, während Claude Code unter Windows in einem AppContainer oder einer Sandbox mit eingeschränktem Token läuft, aktualisieren Sie auf v2.1.265 oder später
* Wenn unter macOS eine Leseverweigerung für eine Datei erscheint, die nichts umschreibt, etwa ein Screenshot, der in den Prompt gezogen wurde, aktualisieren Sie auf v2.1.273 oder später
* Für die ripgrep-Weigerung installieren Sie ripgrep mit Ihrem Paketmanager, damit `rg` zu einem absoluten Pfad auf `PATH` aufgelöst wird, oder halten Sie Suchen innerhalb des Arbeitsverzeichnisses

Vor v2.1.251 überprüfte Claude Code die Auflösung eines Pfads nur bei Dateischreibvorgängen erneut, daher konnte ein Link, der nach der Berechtigungsprüfung ersetzt wurde, einen Lesevorgang oder eine Suche ohne Meldung an einen anderen Ort umleiten. Von diesen Weigerungen erscheinen auf früheren Versionen nur die Schreibverweigerungen für das übergeordnete Verzeichnis, für das Schreiben durch einen Symlink und für verlinkte Verzeichnisse.

Vor v2.1.280 erschien die Weigerung `where it leads on disk could not be determined` nicht.

### The search failed, so this is not a "no matches" result

Eine von Claude ausgeführte [Grep](https://code.claude.com/docs/de/tools-reference.md#grep-tool-behavior)- oder [Glob](https://code.claude.com/docs/de/tools-reference.md#glob-tool-behavior)-Suche ist fehlgeschlagen, bevor sie ein Ergebnis zurückgegeben hat, daher ist unbekannt, ob Treffer existieren. Die Nachricht, die Claude anstelle der Ergebnisse erhält, beginnt so:

```text wrap theme={null}
The search failed, so this is not a "no matches" result: matches may exist. What happened to the search program (ripgrep) is not known, and no results were read. Run the search once more. If it fails again, tell the user that searches are failing.
```

**Was zu tun ist:**

* **Beim ersten Auftreten**: nichts. Die Nachricht bittet Claude, zunächst erneut zu suchen.
* **Wenn Claude meldet, dass Suchen fehlschlagen**: Erfassen Sie den Fehler von ripgrep für einen Fehlerbericht:
  1. Starten Sie in Ihrer Shell eine Sitzung mit denselben Flags wie die Sitzung, in der die Suchen fehlgeschlagen sind, zuzüglich [`--debug-file claude-debug.log`](https://code.claude.com/docs/de/cli-reference#cli-flags)
  2. Senden Sie Claude die Anfrage, die zu der fehlgeschlagenen Suche geführt hat
  3. Wenn die Suche erneut fehlschlägt, suchen Sie in `claude-debug.log` die Zeile, die `rg error (signal=` enthält
  4. Fügen Sie diese Zeile bei, wenn Sie [das Problem melden](#report-an-error)

### Task-Ausgabe-Swap abgelehnt

Claude Code speichert die Ausgabe jedes Bash-Befehls in einer Datei unter seinem Temp-Verzeichnis. Jedes Mal, wenn es eine dieser Dateien öffnet, überprüft es, dass der Pfad immer noch zu der Datei führt, die es erstellt hat, ohne dass ein Symlink, ein zusätzlicher Hardlink oder ein verschobenes Verzeichnis ihn umleitet. Diese Nachricht bedeutet, dass diese Überprüfung fehlgeschlagen ist, daher lehnte Claude Code die Operation ab, anstatt Ausgabe über diesen Pfad zu schreiben oder zu lesen. Die Nachricht erscheint im Bash-Tool-Ergebnis:

```text wrap theme={null}
task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.
```

Der eingeklammerte Text benennt die Überprüfung, die fehlgeschlagen ist. Gründe wie `output symlink was re-pointed`, `output file identity changed` und `not a regular file` melden alle dieselbe Bedingung: Etwas am oder entlang des Ausgabepfads ist nicht mehr die Datei, die Claude Code erstellt hat. Nur einige Gründe enthalten einen `To recover:`-Satz.

Wenn die Überprüfung fehlschlägt, während ein Befehl noch läuft, stoppt Claude Code den Befehl, und sein Ergebnis meldet:

```text theme={null}
Command killed: its output file was replaced or could no longer be verified
```

**Was zu tun ist:**

* Aktualisieren Sie auf v2.1.260 oder später. Frühere Versionen zeigten diese Nachricht manchmal, obwohl kein Link und kein verschobenes Verzeichnis vorhanden war
* Starten Sie Claude Code neu, wobei [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/de/env-vars) auf ein neues Verzeichnis gesetzt ist
* Oder überprüfen Sie das Verzeichnis Ihres Projekts unter dem Claude Code-Temp-Verzeichnis, `/private/tmp/claude-501/-Users-you-my-project` in der Beispielnachricht. Wenn dieser Pfad ein Symlink oder ein Verzeichnis ist, das nicht dort sein sollte, entfernen Sie den Link oder das Verzeichnis selbst statt des Link-Ziels, und starten Sie Claude Code neu
* Wenn die Weigerung wiederholt auftritt, ersetzt, verlinkt oder entfernt ein Prozess Einträge unter dem Temp-Verzeichnis von Claude Code, während die Sitzung läuft. Setzen Sie [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/de/env-vars) auf ein Verzeichnis, das nichts anderes verwaltet, und starten Sie neu

### Festplatte voll oder Festplattenquota aufgebraucht

Geben Sie Speicherplatz, Inodes oder Festplattenquota auf dem Volume frei, das das temporäre Verzeichnis von Claude Code enthält. Eine Zeile im Ergebnis eines Befehls, die mit `Disk full:`, `Disk quota used up:` oder `Nearly out of inodes:` beginnt, nennt dieses Verzeichnis.

Claude Code speichert die Ausgabe jedes Bash- und PowerShell-Befehls in einer Datei unter diesem Verzeichnis. Wenn es diese Datei nicht erstellen kann, weil das Volume oder Ihre Quota darauf voll ist, startet Ihr Befehl nicht, und das Ergebnis, das Claude liest, lautet:

```text wrap theme={null}
The command was not started: this computer's disk is full (ENOSPC) on the volume holding /tmp/claude-501 (Claude Code's temporary directory), so the file that captures command output could not be created there and nothing ran. Free space on that volume, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another one, then retry. If this is the user's own computer, tell them before deleting anything to make room.
```

Die Nachrichten `Disk full:`, `Disk quota used up:` und `Nearly out of inodes:` folgen auf einen Befehl, der ausgeführt wurde und mit einem Exit-Code ungleich null beendet wurde. Zum Beispiel:

```text wrap theme={null}
Disk full: this computer's volume holding /tmp/claude-501 (Claude Code's temporary directory) has 3 MB free, so whatever this command printed was lost and its own writes may have failed with "No space left on device". Free space on that volume, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another one, then retry. If this is the user's own computer, tell them before deleting anything to make room.
```

**Was zu tun ist:**

* Führen Sie unter macOS und Linux `df -h <dir>` in Ihrer Shell aus, um zu sehen, welches Volume das Verzeichnis enthält und wie voll es ist. `df -i <dir>` zeigt, wie viele Inodes frei sind. `<dir>` ist das Verzeichnis, das Ihre Nachricht nennt, wie in `df -i /tmp/claude-501`
* **`Disk full: this computer's volume` oder `disk is full (ENOSPC)`**: Löschen Sie an beliebiger Stelle auf diesem Volume Dateien, die Sie nicht benötigen
* **`Disk quota used up:`, `disk quota is used up (EDQUOT)` oder `Disk full: a test write`**: Löschen Sie Ihre eigenen Dateien auf diesem Volume, auch wenn es noch freien Speicherplatz anzeigt
* **`Nearly out of inodes:`**: Löschen Sie viele Dateien auf diesem Volume. Jede belegt unabhängig von ihrer Größe einen Inode, daher zählt ihre Anzahl, nicht ihre Größe
* Oder starten Sie Claude Code neu, wobei [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/de/env-vars) auf ein Verzeichnis auf einem Volume mit ausreichend Platz gesetzt ist
* Lassen Sie Claude den Befehl dann erneut ausführen

Vor v2.1.309 lauteten die Nachrichten wie folgt, und es gelten dieselben Schritte:

* `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)`
* `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)`
* `Command output was lost: the temp filesystem at <dir> is full` oder `... is out of inodes`
* `The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran.` oder dasselbe mit `(EDQUOT)`. Diese Form nennt kein Verzeichnis: Suchen Sie auf dem Volume, das Ihr System-Temp-Verzeichnis enthält, etwa `/tmp`, oder das in `CLAUDE_CODE_TMPDIR` gesetzte Verzeichnis

Vor v2.1.305 gab ein Befehl, den Claude Code wegen voller Festplatte nicht starten konnte, nur den Fehlertext des Betriebssystems zurück. Dieser Text lautete zum Beispiel `ENOSPC: no space left on device, open <path>.output`.

### git ist auf diesem Mac nicht installiert

Diese Nachricht bedeutet, dass ein Schritt in Claude Code git benötigte und das gefundene git Apples Platzhalter unter `/usr/bin/git` ist. Die Entwicklertools, die git bereitstellen, sind nicht installiert.

Claude Code startet den Platzhalter nicht und zeigt stattdessen diesen Text an, zum Beispiel innerhalb einer längeren Nachricht:

```text wrap theme={null}
git is not installed on this Mac. To install it, run xcode-select --install, then try again.
```

**Was zu tun ist:**

* Führen Sie im Terminal `xcode-select --install` aus, schließen Sie die damit gestartete Installation ab und versuchen Sie dann erneut, was Sie in Claude Code getan haben

### Datei ist kein gültiges UTF-8

Claude hat das Edit- oder NotebookEdit-Tool auf eine Datei angewendet, deren Bytes sich nicht als UTF-8 dekodieren lassen, und Claude Code hat die Änderung abgelehnt. Es wurde nichts geschrieben, die Datei ist also unverändert. Diese Tools speichern die gesamte Datei als UTF-8 zurück, wodurch jedes Byte, das sie nicht dekodieren konnten, in das Ersatzzeichen `U+FFFD` umgewandelt worden wäre. Die Nachricht erscheint im Tool-Ergebnis:

```text wrap theme={null}
File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary. This tool saves the whole file as UTF-8, which would replace every byte it cannot decode with U+FFFD. Nothing was written. Make the change with a shell command that reads and writes the file in its own encoding, or ask the user whether to convert the file to UTF-8 first.
```

Auch eine Datei, die UTF-8 sein soll, erhält diese Nachricht, wenn sie auch nur eine ungültige Bytefolge enthält, da die Überprüfung die Bytes der Datei als Ganzes umfasst.

**Was zu tun ist:**

* Um die Datei in ihrer aktuellen Kodierung zu behalten, lassen Sie Claude die Änderung mit einem Shell-Befehl vornehmen, der die Datei in dieser Kodierung liest und schreibt, wie es die Nachricht vorgibt
* Um die Datei weiterhin mit dem Edit-Tool zu bearbeiten, konvertieren Sie sie in UTF-8 oder beheben Sie die ungültigen Bytes in einer Datei, die UTF-8 sein soll, und bitten Sie Claude dann, die Bearbeitung erneut vorzunehmen

Vor v2.1.296 wendeten Edit und NotebookEdit eine solche Bearbeitung an und speicherten jedes Byte, das sie nicht dekodieren konnten, als `U+FFFD`. Aktualisieren Sie Claude Code, wenn Sie eine dieser Versionen verwenden.

### Refusing to apply edits: a hook is configured for file edits in this session

Claude versuchte, ein [Artefakt](https://code.claude.com/docs/de/artifacts.md) mit einem [einstufigen Update](https://code.claude.com/docs/de/artifacts.md#turn-off-one-step-artifact-updates) zu veröffentlichen, also einer kleinen Änderung an der Datei des Artefakts, die in die Veröffentlichung aufgenommen wird, und Claude Code lehnte ab. Es wurde nichts veröffentlicht, und die Datei ist unverändert. Die Nachricht erscheint im Artifact-Tool-Ergebnis:

```text wrap theme={null}
Refusing to apply edits to <path>: a hook is configured for file edits in this session, so a publish can't apply edits here. Edit the file, then publish it without edits. Nothing was published.
```

Claude Code lässt keine einstufigen Updates zu, solange Ihre Sitzung einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/hooks#pretooluse) oder einen [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) für `Edit` oder `Write` hat.

**Was zu tun ist:**

* Nichts, wenn Claude anschließend die Datei bearbeitet und veröffentlicht hat
* Wenn Claude bei der Nachricht aufgehört hat, bitten Sie Claude, die Datei zu bearbeiten und zu veröffentlichen
* Wenn die Nachricht immer wieder erscheint, beenden Sie Claude Code und starten Sie es neu
* Wenn die Nachricht auch nach einem Neustart wieder erscheint, [schalten Sie einstufige Updates aus](https://code.claude.com/docs/de/artifacts.md#turn-off-one-step-artifact-updates)

### Die Quelldatei ist kein gültiger UTF-8-Text

Claude versuchte, ein [Artefakt](https://code.claude.com/docs/de/artifacts.md) aus einer Datei zu veröffentlichen, deren Bytes sich nicht als Text dekodieren lassen oder deren Text bereits das Ersatzzeichen `U+FFFD` enthält, daher lehnte Claude Code die Veröffentlichung ab, bevor etwas hochgeladen wurde. Die Nachricht erscheint im Artifact-Tool-Ergebnis und nennt die erste zu behebende Position:

```text wrap theme={null}
file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.

file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as &#xFFFD;), then publish again. Nothing was published.
```

Claude Code dekodiert die Datei als UTF-8 oder als UTF-16, wenn sie mit einer Little-Endian-UTF-16-Byte-Order-Mark beginnt. Wenn sich eine solche UTF-16-Datei nicht dekodieren lässt, nennt die erste Nachricht `UTF-16` und weist Sie trotzdem an, die Datei als UTF-8 neu zu schreiben. Wenn auf die genannte Position weitere folgen, fügt die Nachricht nach der Position eine Anzahl wie `(+2 more)` hinzu.

**Was zu tun ist:**

* Normalerweise nichts: Claude schreibt die Datei neu und veröffentlicht erneut
* Wenn Sie die Datei selbst geschrieben oder exportiert haben, speichern Sie sie erneut als UTF-8, und ersetzen Sie jedes `U+FFFD` durch das Zeichen, das eine frühere Bearbeitung, ein Einfügen oder eine Konvertierung verloren hat
* Um ein beabsichtigtes `U+FFFD` auf der Seite anzuzeigen, schreiben Sie es im HTML als `&#xFFFD;` statt des wörtlichen Zeichens

Vor v2.1.267 lud Claude Code eine solche Datei ohne Überprüfung hoch, und stattdessen lehnte der Server die Veröffentlichung ab.

### Nicht veröffentlicht: Diese Datei befindet sich auf einer Netzwerkfreigabe

Claude versuchte, ein [Artefakt](https://code.claude.com/docs/de/artifacts.md) aus einer Datei unter einem Pfad zu veröffentlichen, der einen Netzwerk-Host benennt:

* Unter Windows ein `\\server\share`-Pfad, der nicht unter einem zugeordneten Netzlaufwerk liegt, das Sie beim Start mit [`--add-dir`](https://code.claude.com/docs/de/cli-reference#cli-flags) übergeben haben
* Unter macOS oder Linux ein Automount-Pfad wie `/net/<host>/page.html`

Das Auflösen eines solchen Pfads kontaktiert den darin genannten Host, und unter Windows kann dieser Kontakt Ihre Anmeldedaten an den Host senden. Claude Code lehnt die Veröffentlichung der Datei ab und liest sie nicht. Die Weigerung erscheint im Artifact-Tool-Ergebnis:

```text theme={null}
Not published: that file is on a network share. Publish a file from this session's folders instead.
```

**Was zu tun ist:**

* Nichts, wenn Sie genau diese Datei nicht benötigen: Die Nachricht weist Claude an, stattdessen eine Datei aus den eigenen Ordnern der Sitzung zu veröffentlichen
* Um genau diese Datei zu veröffentlichen, kopieren Sie sie in einen Ordner auf einem lokalen Datenträger und fragen Sie erneut
* Unter Windows: Damit Claude direkt von der Freigabe veröffentlichen kann, ordnen Sie sie einem Laufwerksbuchstaben zu und übergeben Sie das Laufwerk beim Start von Claude Code. Führen Sie in PowerShell zum Beispiel `net use Z: \\server\share` und dann `claude --add-dir Z:\` aus. Claude kann dann Dateien von diesem Laufwerk veröffentlichen. Das Hinzufügen des Laufwerks während der Sitzung mit `/add-dir` reicht nicht aus.
* Unter macOS oder Linux binden Sie die Freigabe in einem Verzeichnis ein, etwa unter `/mnt` oder `/Volumes`, und veröffentlichen Sie von diesem Pfad statt vom Automount-Pfad

### Nicht veröffentlicht: Claude hat denselben Inhalt erneut gesendet, nachdem eine neuere Version des Artefakts ihn abgewiesen hatte

Diese rote Zeile unter einem Artifact-Aufruf bedeutet, dass Claude Code eine wiederholte Veröffentlichung gestoppt hat: Das [Artefakt](https://code.claude.com/docs/de/artifacts.md) wurde nicht aktualisiert, und in die Datei, aus der Claude veröffentlicht, wurde nichts geschrieben. Sie müssen nichts tun, es sei denn, Claude hört auf, ohne zu veröffentlichen.

Früher in der Sitzung hat Claude Code eine Veröffentlichung abgewiesen, weil das Artefakt eine neuere Version hatte, zum Beispiel eine, die ein [Bearbeiter](https://code.claude.com/docs/de/artifacts.md#let-someone-edit-with-you) oder eine andere Ihrer Sitzungen veröffentlicht hat. Das Ende der Zeile gibt an, was Claude als Nächstes tun muss:

```text wrap theme={null}
Not published: Claude sent the same content again after a newer version of the artifact turned it away. Claude needs to work from that newer version first.
Not published: Claude sent the same content again after a newer version of the artifact turned it away. The artifact hasn't changed since, so publishing it once more should go through.
Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. Claude needs to work from that newer version first.
Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. The artifact hasn't changed since, so publishing once more should go through.
```

**Was zu tun ist:**

* **Endet mit `Claude needs to work from that newer version first`**: Wenn Claude dort aufgehört hat, bitten Sie es, die aktuelle Version des Artefakts abzurufen, deren Änderungen einzuarbeiten und erneut zu veröffentlichen
* **Endet mit `should go through`**: Wenn Claude dort aufgehört hat, bitten Sie es, erneut zu veröffentlichen

### Lesen einer lokalen Datei von außerhalb der verbundenen Ordner in einer Cowork-Sitzung

In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung, die auf Ihrem Rechner in der Claude Desktop-App läuft, nannte Claude eine lokale Datei für ein [Artefakt](https://code.claude.com/docs/de/artifacts.md). Claude Code konnte nicht bestätigen, dass die Datei eine einfache Datei innerhalb der verbundenen Ordner der Sitzung ist: Der Pfad liegt außerhalb dieser Ordner, führt durch einen symbolischen Link oder ist so geschrieben, dass er eine andere Datei benennen kann, als es scheint. Das Lesen einer solchen Datei erfordert Ihre Genehmigung, und in einer Sitzung, die Ihnen die Genehmigungskarte nicht anzeigen kann, etwa einer, die so eingestellt ist, dass alle Genehmigungen übersprungen werden, lehnt Claude Code das Lesen ab.

Die Weigerung erscheint im Artifact-Tool-Ergebnis; wenn die Datei überhaupt nicht untersucht werden konnte, nennt sie stattdessen diesen Fehler:

```text wrap theme={null}
Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.

cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.
```

**Was zu tun ist:**

* Normalerweise nichts: Die Nachricht weist Claude an, stattdessen eine einfache Datei innerhalb der verbundenen Ordner zu verwenden
* Um genau diese Datei in das Artefakt aufzunehmen, kopieren Sie sie als reguläre Datei, nicht als Symlink, in einen der verbundenen Ordner der Sitzung, und fragen Sie erneut

### WebFetch kann localhost nicht abrufen

Claude hat [WebFetch](https://code.claude.com/docs/de/tools-reference.md#webfetch-tool-behavior) mit einer URL aufgerufen, deren Hostname keinen Punkt enthält, wie `http://localhost:3000` oder einen bloßen Intranet-Namen wie `http://wiki/`. WebFetch lehnt diese URLs ab, bevor eine Anfrage gestellt wird:

```text wrap theme={null}
WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.
```

**Was zu tun ist:**

* Normalerweise nichts: Die Nachricht verweist Claude auf `curl` über das Bash-Tool, das lokale und Intranet-Server erreichen kann

Vor v2.1.268 meldete WebFetch diese URLs mit einem generischen `Invalid URL`-Fehler.

### Claude Code kann nicht von einem Host abrufen

WebFetch sendet den Hostnamen einer URL an `api.anthropic.com`, bevor die Seite angefordert wird, um ihn mit Anthropics Domänensicherheits-Blocklist abzugleichen. Diese Nachricht bedeutet, dass die Überprüfung ergeben hat, dass der Hostname nicht abgerufen werden kann:

```text wrap theme={null}
Claude Code is unable to fetch from example.com
```

Claude Code hat den Host nicht kontaktiert, da die Überprüfung vor der Anfrage ausgeführt wird.

Was die Überprüfung sendet, erfahren Sie unter [WebFetch-Domänensicherheitsprüfung](https://code.claude.com/docs/de/data-usage.md#webfetch-domain-safety-check).

### WebFetch-Domänensicherheitsprüfung fehlgeschlagen

Bevor WebFetch eine URL abruft, sendet es den Hostnamen der URL an `api.anthropic.com`, um ihn mit Anthropics [Domänensicherheits-Blocklist](https://code.claude.com/docs/de/data-usage.md#webfetch-domain-safety-check) abzugleichen. Wenn die Überprüfung nicht abgeschlossen werden kann, kann WebFetch nicht bestätigen, dass die Domäne sicher ist, daher ruft es die Seite nicht ab, und das Tool-Ergebnis enthält stattdessen eine dieser Nachrichten:

```text wrap theme={null}
The safety check for domain example.com is rate-limited (too many domain checks from this network; the limit is shared and can stay exhausted for minutes). Do not retry WebFetch in a loop or sleep to wait it out; continue without this page and report that its safety check was rate-limited. A single later attempt is fine; if that is rate-limited too, stop.

Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.
```

* `rate-limited`: Der Prüf-Endpunkt antwortete mit HTTP `429`. Die Nachricht weist Claude an, ohne die Seite fortzufahren und es später höchstens einmal erneut zu versuchen. Claude Code speichert eine fehlgeschlagene Überprüfung nicht im Cache, daher führt ein späterer Abruf dieser Domäne die Überprüfung erneut aus. Wenn Sitzungen in Ihrem Netzwerk häufig darauf stoßen, können Sie die Überprüfung mit [`skipWebFetchPreflight: true`](https://code.claude.com/docs/de/settings-reference#skipwebfetchpreflight) in den Einstellungen überspringen.
* `Unable to verify`: Die Prüfanfrage schlug fehl, überschritt das Zeitlimit oder erhielt einen anderen Fehlerstatus. Wenn Ihr Netzwerk `api.anthropic.com` blockiert, setzen Sie diese Domäne auf die Allowlist, oder überspringen Sie die Überprüfung mit [`skipWebFetchPreflight: true`](https://code.claude.com/docs/de/settings-reference#skipwebfetchpreflight) in den Einstellungen.

Vor v2.1.286 lautete die Nachricht zum Rate-Limit `The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way.`.
Vor v2.1.285 wurde eine durch das Rate-Limit begrenzte Überprüfung stattdessen mit der Nachricht `Unable to verify` gemeldet.

## Fehler in Hintergrund-Sitzungen

[Hintergrund-Sitzungen](https://code.claude.com/docs/de/agent-view.md) laufen ohne eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, im Terminal, das sich an eine anhängt, in der Sitzung oder Shell, von der Sie sie entsenden, oder für die [Worktree-Guard-Einträge](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) unten in jeder Sitzung, die in einem Worktree isoliert ist oder einen Worktree-isolierten Subagenten ausführt; wenn eine Meldung spezifisch für eine Oberfläche ist, gibt ihr Eintrag das an.

### Befehle, die in einer Hintergrund-Sitzung abgelehnt werden

Befehle, die einen interaktiven Dialog öffnen, können dies nicht tun, während kein Terminal an eine Hintergrund-Sitzung angehängt ist. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü antworten mit einer Meldung. Für `/install-github-app` und die `/mcp`-Einstellungsliste wird die Sitzung auch unter **Needs input** in der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) angezeigt, damit Sie sie finden, anhängen und den Befehl erneut ausführen können. Während ein Terminal angehängt ist, funktionieren diese Befehle normal.

Vor v2.1.216 wurde die Sitzung nach `/install-github-app` oder der `/mcp`-Einstellungsliste nicht unter **Needs input** angezeigt. In v2.1.213 bis v2.1.215 funktionierten die Befehle weiterhin, während ein Terminal angehängt war, und die Ablehnungsmeldung sagte Ihnen, dass Sie anhängen und den Befehl erneut ausführen sollen. Von v2.1.208 bis v2.1.212 lehnte Claude Code sie sogar ab, während ein Terminal angehängt war, mit einer Meldung wie `Can't open MCP settings in a background session`; auf diesen Versionen führen Sie den Befehl stattdessen aus einer regulären `claude`-Sitzung aus oder aktualisieren. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung. Nur in v2.1.208 lehnte Claude Code auch die `/model`-Auswahl in einer Hintergrund-Sitzung ab, und `/upgrade` gab die Upgrade-URL aus, anstatt einen Browser zu öffnen.

Die Formulierung nennt den Befehl. Die `/mcp`-Einstellungsliste meldet:

```text theme={null}
Can't open MCP settings while no terminal is attached to this background session. This session now shows "needs input" in agent view — open it and run /mcp to manage servers, or use `/mcp enable|disable|reconnect <server>` to steer without the panel.
```

**Was zu tun ist:**

* Hängen Sie sich von der Agent-Ansicht an die Sitzung an und führen Sie den Befehl erneut aus
* Oder verwenden Sie die Form, die die Meldung nennt, wie `/mcp reconnect <server>`, `/mcp enable` oder `/mcp disable`, die ohne Anhängen funktionieren

### Schreib- oder Befehlsoperation blockiert, da der Pfad nicht sicher aufgelöst werden kann

Claude hat auf eine Datei oder ein Arbeitsverzeichnis durch eine Schreibweise zugegriffen, die der [Worktree-Isolations-Guard](https://code.claude.com/docs/de/agent-view.md#how-file-edits-are-isolated) nicht zu einem verifizierbaren Ort auflösen kann. Der Guard überprüft Schreibvorgänge und Befehlsarbeitsverzeichnisse in [jeder Sitzung, die in einem Worktree isoliert ist](https://code.claude.com/docs/de/worktrees.md#how-claude-code-enforces-isolation), interaktiv oder im Hintergrund, und in [Worktree-isolierten Subagenten](https://code.claude.com/docs/de/worktrees.md#isolate-subagents-with-worktrees). Er löst Symlinks auf, bevor er überprüft, dass die Operation den gemeinsamen Checkout nicht erreicht, und wenn die Auflösung fehlschlägt, blockiert er die Operation, anstatt sie dort landen zu lassen. Die Meldung nennt die Pfadformen, die er ablehnt, und wie Sie es erneut versuchen:

```text theme={null}
This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.
```

Ein blockierter Befehl meldet die gleiche Ursache für sein Arbeitsverzeichnis und endet mit `re-run the command from its direct symlink-free path`. Vor v2.1.217 verglich der Guard Pfadschreibweisen, ohne Symlinks aufzulösen, daher wurden diese Schreibweisen nicht blockiert und ein Schreibvorgang, der durch einen Symlink geleitet wurde, konnte im gemeinsamen Checkout landen.

**Was zu tun ist:**

* Normalerweise nichts: Die vollständige Meldung geht an Claude als Tool-Fehler, und Claude versucht es erneut mit dem direkten Pfad, den sie nennt. Für einen blockierten Datei-Edit zeigt die Konversationsansicht nur eine kurze `Error editing file`-Zeile; die vollständige Meldung erscheint in der Transkript-Ansicht, die Sie mit `Ctrl+O` öffnen. Ein blockierter Befehl gibt sie in seiner Befehlsausgabe aus.
* Wenn die Blockierung bei derselben Datei wiederholt wird, läuft der Pfad wahrscheinlich durch einen committeten Symlink, dessen Ziel `..` enthält, wie `docs/current -> ../README.md`; bitten Sie Claude, die Zieldatei stattdessen über ihren echten Pfad zu bearbeiten, anstatt über den Link

### Schreib- oder Befehlsoperation blockiert, da der Pfad einen Netzwerkort benennt

Claude hat auf eine Datei oder ein Arbeitsverzeichnis durch einen Pfad zugegriffen, der ein Laufwerk benennt, das sich nicht auf Ihrem Computer befindet, eine UNC-Freigabe wie `\\server\share\file` oder einen `/net`-Automount-Pfad, während der Checkout der Sitzung auf einer lokalen Festplatte ist. Der gleiche [Worktree-Isolations-Guard](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) kann nicht überprüfen, dass ein solcher Pfad aus dem gemeinsamen Checkout herausbleibt, daher blockiert er die Operation. Das Isolieren der Sitzung in einem Worktree hebt die Blockierung nicht auf. Die Meldung nennt die Pfadform, die stattdessen verwendet werden soll:

```text theme={null}
This write was blocked because the path is network-shaped (a UNC share or /net automount spelling) while this session's checkout is local. Isolating cannot unblock it. If the file is genuinely inside the worktree /path/to/worktree, address it by its local, plainly-spelled path instead.
```

Ein blockierter Befehl meldet die gleiche Ursache für sein Arbeitsverzeichnis und endet mit `re-run the command from its local, plainly-spelled path`. Vor v2.1.217 verglich der Guard nur Pfadtext, daher wurde das Adressieren einer Datei innerhalb des Checkouts über einen UNC- oder `/net`-Pfad nicht blockiert.

**Was zu tun ist:**

* Normalerweise nichts: Claude versucht es erneut mit der lokalen Schreibweise, die die Meldung verlangt

### Befehl blockiert durch die Worktree-Isolationsprüfungen

Claude hat einen Bash-, [PowerShell](https://code.claude.com/docs/de/tools-reference.md#powershell-tool)- oder [Monitor](https://code.claude.com/docs/de/tools-reference.md#monitor-tool)-Befehl in einer [Sitzung ausgeführt, die in einem Worktree isoliert ist](https://code.claude.com/docs/de/worktrees.md#how-claude-code-enforces-isolation), und Claude Code hat ihn aus einem dieser Gründe abgelehnt:

* Der Befehl würde im Haupt-Checkout oder in einem anderen Worktree ausgeführt. Die Meldung sagt, dass sein Arbeitsverzeichnis `resolved to the shared checkout` oder `is in a different worktree`.
* Ein Bash- oder Monitor-Befehl zeigt git auf den Haupt-Checkout.
* Claude Code kann aus dem Text eines Bash- oder Monitor-Befehls nicht überprüfen, dass jedes git, das der Befehl ausführt, innerhalb des Worktree bleibt. Ein Befehl, der git nie benennt, kann trotzdem aus diesem Grund abgelehnt werden, da das Erweitern einer Variablenumleitung wie `${!name}` oder das Ausführen einer Bash-Funktionssubstitution wie `${ command; }` einen Wert zur Laufzeit erzeugt, der selbst ein Befehl sein kann.

Die Meldung sagt `is isolated in the worktree <path>, but this command`, gefolgt vom Grund, etwa einem Befehl, dessen Text Claude Code nicht überprüfen konnte:

```text wrap theme={null}
This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.
```

**Was zu tun ist:**

* **Git auf den Haupt-Checkout gezeigt oder Befehlstext, der nicht überprüft werden kann**: nichts. Claude liest die Meldung und schreibt den Befehl so um, wie ihr letzter Satz verlangt. Wenn ein Befehl, den Sie angefordert haben, wegen einer Erweiterung in seinem Text weiterhin abgelehnt wird, schreiben Sie den gekennzeichneten Wert wörtlich und führen Sie git als eigenen einfachen Befehl von innerhalb des Worktree aus
* Um absichtlich auf den Haupt-Checkout einzuwirken, führen Sie den Befehl selbst in einem Terminal außerhalb der Sitzung aus

### Diese Sitzung hat kein gespeichertes Transkript

Sie haben sich an eine Sitzung angehängt, die Sie mit `←` oder `/background` [in den Hintergrund verschoben](https://code.claude.com/docs/de/agent-view.md#from-inside-a-session) haben und die gestoppt wurde, bevor sie einen eigenen Turn ausgeführt hat. Claude Code konnte die Konversation, aus der Sie sie verschoben haben, nicht finden, daher hat die Sitzung nichts zum Fortsetzen. Die Meldung endet mit dem `claude respawn`-Befehl für diese Sitzung:

```text theme={null}
This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.
```

Das Öffnen der Zeile derselben Sitzung in der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) zeigt stattdessen `Press enter again to restart this session fresh` unter der Liste an, und ein zweites `Enter` auf der Zeile startet die Sitzung mit einer leeren Konversation neu.

**Was zu tun ist:**

* Um die gestoppte Sitzung neu zu starten, führen Sie `claude respawn <id>` mit der ID aus der Meldung aus, oder drücken Sie `Enter` zweimal auf ihrer Zeile in der Agent-Ansicht
* Wenn die Sitzung eine Antwort fertiggestellt hat und Sie diese Ablehnung immer noch auf einer Version vor v2.1.214 sehen, könnte ein unlesbarer Ordner in `~/.claude/projects` dazu führen, dass der Transkript-Scan die gespeicherte Konversation verpasst; aktualisieren Sie auf v2.1.214 oder später, das unlesbare Ordner während des Scans toleriert

### Diese Sitzung läuft in einem anderen Terminal

Sie haben die Zeile einer gestoppten Sitzung in der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) geöffnet, und ihre gespeicherte Konversation ist bereits in einem anderen aktiven Claude Code-Prozess auf diesem Computer offen, daher lehnt Claude Code ab, einen zweiten Prozess zu starten, der in das gleiche Transkript schreiben würde. Welche Meldung Sie sehen, hängt davon ab, [was die Konversation hält](https://code.claude.com/docs/de/agent-view.md#opening-a-session-says-the-conversation-is-already-open):

```text theme={null}
Can't open — this session is running in another terminal
This conversation is already open in another running Claude session — use that one, or close it and try again
```

* **`running in another terminal`**: Ein anderer Prozess als eine Hintergrund-Sitzung hält die Konversation, zum Beispiel ein `claude -p`-Lauf oder ein Terminal, in dem Sie sie mit `claude --resume` oder `/resume` fortgesetzt haben. Die Zeile zeigt auch `Open in a terminal`.
* **`already open in another running Claude session`**: Eine andere [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) hält sie.

**Was zu tun ist:**

* Bei `running in another terminal`: Fahren Sie in diesem Terminal fort, oder beenden Sie diesen Prozess bzw. lassen Sie ihn zu Ende laufen, und versuchen Sie es dann erneut
* Bei `already open in another running Claude session`: Verwenden Sie diese Sitzung, oder stoppen Sie sie und versuchen Sie es dann erneut

Vor v2.1.248 existierte nur die `already open in another running Claude session`-Ablehnung: Eine Konversation, die in einem Terminal fortgesetzt wurde, zählte nicht als offen, und das Öffnen der Zeile startete einen zweiten Claude Code-Prozess, der in dieselbe Konversation schrieb.

### Die gespeicherte Konversation dieser Sitzung ist nicht mehr auf der Festplatte

Sie haben eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) geöffnet, die endete, während der Hintergrund-Service aus war, und die [Transkript-Bereinigung](https://code.claude.com/docs/de/settings-reference.md#cleanupperioddays) hat seitdem ihre gespeicherte Konversation entfernt, zum Beispiel nachdem der Computer für Wochen aus war. Das Öffnen einer solchen Zeile [setzt normalerweise ihre gespeicherte Konversation fort](https://code.claude.com/docs/de/agent-view.md#sessions-show-as-failed-after-shutdown). Da nichts zum Fortsetzen übrig ist, lehnt Claude Code ab, anstatt den ursprünglichen Prompt der Sitzung ohne Nachfrage erneut auszuführen:

```text theme={null}
This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` removes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.
```

`claude attach <id>` gibt diesen Text aus. In der Agent-Ansicht ist die Fußzeile kürzer und endet mit `ctrl+x removes the row`.

**Was zu tun ist:**

* Führen Sie `claude rm <id>` aus, um die Zeile zu löschen. Wenn einer der [beibehaltenen Fälle](https://code.claude.com/docs/de/agent-view.md#what-deleting-a-session-removes) zutrifft, behält `claude rm` die Zeile und den Worktree stattdessen bei und nennt den Grund
* Um den ursprünglichen Prompt der Sitzung erneut als frische Konversation auszuführen, führen Sie `claude respawn <id>` aus

Vor v2.1.248 führte das Öffnen einer solchen Zeile den ursprünglichen Prompt der Sitzung erneut aus, anstatt abzulehnen, und zog eine Wochen alte Aufgabe zurück in den Vordergrund.

### Worktree hat Commits, die nirgendwo gepusht werden

Sie haben versucht, eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md#what-deleting-a-session-removes) zu löschen, deren Worktree Commits enthält, bei denen Claude Code nicht bestätigen kann, dass sie anderswo gespeichert sind. `claude rm` sagt, wie Sie vorgehen:

```text theme={null}
kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
  2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
  push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
```

Wenn Claude Code die Commits nicht zusammenfassen kann, lautet die Detailzeile stattdessen `The worktree has unpushed commits`. In der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) zeigt die Sitzungszeile `not removed` mit dem gleichen Grund.

**Was zu tun ist:**

* Um die Commits zu behalten, pushen Sie sie. Sobald der Push sie auf einen Remote-Tracking-Branch wie `origin/claude/fix-login` bringt, versuchen Sie erneut, die Sitzung zu löschen.
* Wenn die Meldung anbietet, die Commits zu verwerfen, stellen Sie zuerst sicher, dass Sie den Worktree, die Commits und alle nicht committeten Änderungen nicht benötigen. Führen Sie dann den Schritt aus, den die Meldung angibt: Drücken Sie `Ctrl+X` zweimal auf der Sitzungszeile in der Agent-Ansicht, oder führen Sie den `claude rm <id> --discard-unpushed <commit>@<worktree-id>`-Befehl aus, den `claude rm` ausgegeben hat. Wenn Claude Code erneut ablehnt, folgen Sie der neuen Meldung.
* Wenn die Meldung sagt, dass der Worktree auch von einer anderen beendeten Sitzung aufgezeichnet wird, verwirft erneutes Löschen ihn nicht: Pushen Sie die Commits, dann versuchen Sie erneut, die Sitzung zu löschen

Vor v2.1.268 setzte `claude rm` die Commit-Zusammenfassung auf die `kept`-Zeile selbst. Wenn `claude rm` die Commits nicht zusammenfassen konnte, lautete die `kept`-Zeile `worktree has commits that are not pushed anywhere` anstelle der Zusammenfassung.

Vor v2.1.260 nannte die Meldung nicht den Branch oder die Commits, und es gab keine Möglichkeit zum Verwerfen. Sie können die Sitzung trotzdem löschen, wobei nicht committete Änderungen verloren gehen, der Branch und die Commits aber erhalten bleiben. Führen Sie `git worktree remove --force --force <path>` mit dem Pfad aus, den die Ablehnung ausgegeben hat, dann `claude rm <id>`. Git benötigt `--force` zweimal für einen gesperrten Worktree.

### Terminal-Host-Prozess ist gestorben

Das Terminal jeder [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) läuft in einem Host-Prozess unter dem Hintergrund-Service, und dieser Prozess ist gestorben, während der Service seine Verbindung noch hielt, daher konnte die Sitzung nicht erreicht werden.

Unter Linux und WSL überprüft der Hintergrund-Service jeden Host-Prozess alle paar Sekunden, markiert die Sitzung als fehlgeschlagen, wenn der Prozess beendet wurde, aber seine Verbindung zum Service nie geschlossen wurde, und zeigt den Grund auf ihrer Zeile in der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md#read-session-state):

```text theme={null}
terminal host process died — press Enter to restart
```

Aus der Shell startet `claude attach <id>` eine Sitzung, die bereits wegen eines toten Hosts als fehlgeschlagen markiert ist, neu, und gibt ansonsten die Ursache aus und beendet sich:

```text theme={null}
Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.
```

Die Konversation ist in jedem Fall gespeichert.

Eine Zeile, die einen [Shell-Befehl](https://code.claude.com/docs/de/agent-view.md#run-a-shell-command) ausführt, zeigt stattdessen `terminal host process died — its output is gone; the command was not run again`, und `claude attach` gibt `This command's terminal host process died — its output is gone and the command was not run again` aus. Claude Code führt den Befehl niemals für Sie erneut aus.

**Was zu tun ist:**

* Drücken Sie in der Agent-Ansicht `Enter` auf der fehlgeschlagenen Zeile; die Sitzung startet auf einem frischen Host-Prozess neu und die Konversation wird fortgesetzt
* Führen Sie aus der Shell `claude attach <id>` erneut aus. Claude Code gibt `Session <id>'s terminal host died — restarting it on a fresh one…` aus und öffnet die Sitzung erneut
* Sie können eine Shell-Befehl-Zeile auf diese Weise nicht neu starten; entsenden Sie den Befehl erneut, um ihn erneut auszuführen

Vor v2.1.247 konnte ein toter Host-Prozess jede Liveness-Überprüfung bestehen, die der Hintergrund-Service ausführte, daher zeigte das Öffnen der Sitzung `opening… · esc to cancel` unbegrenzt und `claude attach <id>` wartete ohne Fehlermeldung.

### Sitzung antwortet nicht

Sie haben eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) geöffnet und der Hintergrund-Service hat das Öffnen akzeptiert, aber etwa zehn Sekunden lang kam keine Ausgabe an, daher schließt Claude Code, dass der Prozess, der das Terminal der Sitzung weiterleitet, keine Ausgabe liefern kann, und beendet den Versuch, anstatt zu warten.

In der Agent-Ansicht bietet Claude Code einen Neustart in der Fußzeile an:

```text theme={null}
Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).
```

Aus der Shell gibt `claude attach <id>` die Ursache aus und beendet sich:

```text theme={null}
Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).
```

Claude Code startet eine Zeile, die einen [Shell-Befehl](https://code.claude.com/docs/de/agent-view.md#run-a-shell-command) ausführt, niemals für Sie neu, da ein Neustart den Befehl erneut ausführen würde.

**Was zu tun ist:**

* Drücken Sie in der Agent-Ansicht `Enter` auf derselben Zeile erneut. Claude Code stoppt den nicht reagierenden Prozess und startet die Sitzung neu, und die Konversation wird fortgesetzt. Nichts wird ohne diesen zweiten Tastendruck gestoppt
* Führen Sie aus der Shell `claude stop <id>` aus, dann `claude attach <id>`
* Drücken Sie für eine Shell-Befehl-Zeile `Ctrl+X` in der Agent-Ansicht oder führen Sie `claude stop <id>` aus, um sie zu stoppen; entsenden Sie den Befehl erneut, um ihn erneut auszuführen

### Sitzung wurde gestoppt, während der Respawn im Gange war

Sie haben eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) geöffnet, deren Prozess nicht lief, und während Claude Code sie neu startete, stoppte ein anderer Claude Code-Prozess sie, zum Beispiel `claude stop` in einem anderen Terminal. Claude Code hält die Sitzung gestoppt:

```text theme={null}
Session <id> was stopped while the respawn was in flight
```

Das Öffnen einer Sitzung, die Sie gerade entsandt haben, während ihr Prozess noch startet, wartet stattdessen auf den Prozess. Vor v2.1.246 konnte das Öffnen zu diesem Zeitpunkt sie stoppen und diese Meldung anzeigen.

**Was zu tun ist:**

* Wenn Sie die Sitzung nicht gestoppt haben, öffnen Sie ihre Zeile erneut in der Agent-Ansicht oder führen Sie `claude respawn <id>` aus, um sie neu zu starten
* Wenn Sie sie selbst gestoppt haben, bleibt nichts zu tun: Die Sitzung bleibt gestoppt

### Sitzungs-Agent nicht mehr verfügbar

Sie haben eine Sitzung fortgesetzt, die einen [benutzerdefinierten Agenten](https://code.claude.com/docs/de/sub-agents.md#invoke-subagents-explicitly) ausführte, gestartet mit `--agent` oder der `agent`-Einstellung, und Claude Code hat keinen Agenten mit diesem Namen gefunden. Es durchsucht zuerst das ursprüngliche Verzeichnis der Sitzung, wenn Sie [diesem Workspace vertraut haben](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust), dann das Verzeichnis, von dem aus Sie fortsetzen. Die Sitzung wird trotzdem fortgesetzt, aber mit den Standard-Tools, sodass die Tool-Einschränkungen des Agenten nicht mehr gelten:

```text theme={null}
This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
```

Die Warnung nennt nur die Verzeichnisse, die Claude Code durchsucht hat, und sie erscheint in der fortgesetzten Konversation, ob Sie eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) aufwecken, `/resume` oder `claude --resume` ausführen oder im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) fortsetzen, wo sie auch an stderr geht. Sitzungen, die `--input-format stream-json` verwenden, zeigen sie nicht, da das Agent SDK Agenten nach dem Start bereitstellt.

Claude Code speichert den Fallback nicht in der Sitzung, daher wiederholt sich die Warnung bei jedem Fortsetzen, bis Sie handeln. Der eingebaute `claude`-Agent löst die Warnung nicht aus, da das Zurückfallen auf das Standard-Toolset für ihn nichts ändert. Vor v2.1.216 setzte Claude Code stillschweigend als Standard-Agent fort, und die Suche deckte nur das Verzeichnis ab, von dem aus Sie fortgesetzt haben, daher ging ein projektbezogener Agent bei jedem Fortsetzen aus einem anderen Verzeichnis verloren.

**Was zu tun ist:**

* Erstellen Sie die Agent-Datei unter `.claude/agents/<name>.md` im Projekt der Sitzung oder unter `~/.claude/agents/<name>.md` für einen persönlichen Agenten neu, dann setzen Sie erneut fort
* Oder setzen Sie mit `--agent <name>` fort, das einen Agenten benennt, der existiert, um die Sitzung stattdessen als dieser Agent auszuführen
* Wenn der Agent projektbezogen ist und Sie dem ursprünglichen Verzeichnis der Sitzung nicht vertraut haben, führen Sie Claude Code dort einmal aus, akzeptieren Sie den Vertrauensdialog, dann setzen Sie erneut fort

### Diese Sitzung wurde neu gestartet, nachdem ihr nächstes /loop-Aufwachen fällig war

Ein [selbstgetaktetes `/loop`](https://code.claude.com/docs/de/scheduled-tasks#let-claude-choose-the-interval) in einer [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) wurde gestoppt. Der Prozess der Sitzung endete, während die Schleife auf ihr nächstes Aufwachen wartete, und dieses Aufwachen wurde fällig, bevor der [nächste Prozess](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) der Sitzung startete. Das verpasste Aufwachen wird nicht verspätet ausgelöst. Der Hinweis gibt an, wie überfällig das Aufwachen war, als die Sitzung neu startete:

```text theme={null}
This session restarted 12m after its next /loop wakeup was due, so that wakeup will not fire. The loop stays stopped until Claude schedules it again: reply to continue it.
```

Vor v2.1.295 stoppte die Schleife in dieser Situation ohne Hinweis.

**Was zu tun ist:**

* Um die Schleife fortzusetzen, [antworten Sie der Sitzung](https://code.claude.com/docs/de/agent-view.md#peek-and-reply) und sagen Sie es, etwa `keep the loop running`. Claude liest den Hinweis mit Ihrer Antwort und kann das nächste Aufwachen planen
* Wenn Sie mit der Schleife fertig sind, tun Sie nichts. Sie ist bereits gestoppt

### No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder

Die [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md), die diese Meldung anzeigt, verwendet Ihr [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) nicht: Sie hat die Adresse des Gateways nicht erhalten, daher schlagen ihre Anfragen fehl. Die Meldung erscheint in der Konversation anstelle der Antwort von Claude, wobei die ID und der Ordner Ihrer Sitzung eingesetzt sind:

```text wrap theme={null}
No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder. To fix, run `claude respawn abc12345` from ~/project in another terminal where your gateway is set, or set ANTHROPIC_BASE_URL and its API key or token in a settings file's env block.
```

Während Sie an die Sitzung angehängt sind, zeigt der Hinweis unter ihrem Eingabefeld die Kurzform `No LLM gateway: opened from another folder · respawn from ~/project`.

Sie haben die Sitzung aus einem anderen Ordner als dem in der Meldung genannten entsandt, aufgeweckt oder neu gestartet, während `ANTHROPIC_BASE_URL` auf Ihr Gateway gesetzt war. Für die Fälle, in denen ein in der Shell exportiertes Gateway eine Hintergrund-Sitzung erreicht, siehe [LLM-Gateway](https://code.claude.com/docs/de/agent-view.md#llm-gateway).

**Was zu tun ist:**

* **Sie haben die Agent-Ansicht in einem Projekt verwendet, dessen Einstellungen das Gateway festlegen**: Tragen Sie `ANTHROPIC_BASE_URL` und den zugehörigen API-Schlüssel oder das Token in [den `env`-Block einer Einstellungsdatei](https://code.claude.com/docs/de/llm-gateway-connect#set-in-a-settings-file) ein. Verwenden Sie `~/.claude/settings.json` oder `.claude/settings.local.json` im eigenen Projekt der Sitzung; beide werden von einer neu gestarteten Sitzung gelesen. Führen Sie dann `claude respawn <id>` in Ihrer Shell aus einem beliebigen Ordner aus.
* **Sie haben das Gateway in Ihrem Terminal exportiert**: Wechseln Sie in einem Terminal, in dem Sie die Gateway-Variablen exportiert haben, mit `cd` in den Ordner, den die Meldung nennt, und führen Sie den `claude respawn <id>`-Befehl aus der Meldung aus. Die Sitzung startet aus ihrer gespeicherten Konversation neu.
  * Das Gateway erreicht die Sitzung nur, wenn der [Supervisor](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) selbst aus einer Shell gestartet wurde, die dasselbe Gateway exportiert hat. Falls nicht, starten Sie ihn aus diesem Terminal neu, wie unter [Dispatch schlägt mit `Could not resolve authentication method` fehl](https://code.claude.com/docs/de/agent-view#dispatch-fails-with-could-not-resolve-authentication-method) beschrieben, und führen Sie dann den Respawn-Befehl erneut aus.

Vor v2.1.302 zeigte eine Hintergrund-Sitzung in dieser Situation stattdessen einen Anmeldefehler wie [`Not logged in · Please run /login`](#not-logged-in), ohne den Ordner zu nennen.

### CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler

[`CLAUDE_CODE_PROCESS_WRAPPER`](https://code.claude.com/docs/de/corporate-launcher) ist gesetzt, und sein Wert kann nicht verwendet werden, daher lehnt Claude Code ab, 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:

```text theme={null}
CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
```

Ein Launcher, der startet, aber beendet wird, ohne sich selbst durch Claude Code zu ersetzen, lässt die Sitzung fehlschlagen, die er startete, und die Sitzungszeile in der Agent-Ansicht meldet, dass der Launcher `must exec, not daemonize`, gefolgt von allem, was der Launcher ausgegeben hat. Eine Sitzung, die wegen des Launchers nicht starten oder den Hintergrund-Service nicht erreichen kann, meldet das Launcher-Problem als Grund innerhalb von `Couldn't reach the background service (...)`.

**Was zu tun ist:**

* Setzen Sie die Variable auf den absoluten Pfad einer ausführbaren Datei, die mit dem Aufruf `exec "$@"` endet. Siehe [den Launcher-Vertrag](https://code.claude.com/docs/de/corporate-launcher.md#the-launcher-contract) für den vollständigen Vertrag
* Überprüfen Sie `/status`, das den aufgelösten Start-Befehl in seinem Self-exec-Eintrag anzeigt und warnt, wenn der laufende Hintergrund-Service nicht damit übereinstimmt, oder führen Sie `claude daemon status` aus einer Shell aus
* Nach dem Beheben des Wertes im `env`-Block der [Einstellungen](https://code.claude.com/docs/de/corporate-launcher.md#set-up-the-launcher) starten Sie den Hintergrund-Service mit `claude daemon stop --any` neu, damit der nächste Dispatch einen umschlossenen startet

### EUNKNOWN beim Starten einer Hintergrund-Sitzung

Windows lehnte ab, ein Programm zu starten, mit einem Fehlercode, der keinen Standardnamen hat, daher wird der Fehler als `EUNKNOWN` angezeigt. Der übliche Auslöser ist eine Softwarebeschränkungsrichtlinie, wie Gruppenrichtlinie oder AppLocker, die das gestartete Programm blockiert. Der Fehler erscheint, wenn Sie eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) mit `/background` oder `claude --bg` starten:

```text theme={null}
Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'
```

Bei einigen Konten sagt die Meldung `daemon` anstelle von `background service`.

Bei einer npm-Installation hat ein `EUNKNOWN`, das erscheint, während `npm install -g @anthropic-ai/claude-code` die Binärdatei ersetzt, die gleiche Ursache wie [`EACCES` während einer Neuinstallation](#eacces-when-starting-a-background-session) und verschwindet, wenn Sie es nach Abschluss der Installation erneut versuchen.

Claude Code startet den Hintergrund-Service über PowerShell, damit der Service das Schließen des Terminals überlebt, wobei PowerShell 7 verwendet wird, wenn es installiert ist, und ansonsten Windows PowerShell 5.1. Wenn keine der beiden PowerShell-Versionen laufen kann, startet Claude Code den Service stattdessen direkt, daher verursacht eine Richtlinie, die nur PowerShell blockiert, diesen Fehler nicht.

Vor v2.1.212 verwendete Claude Code nur Windows PowerShell 5.1, um den Service zu starten, daher schlug jede Maschine, auf der Gruppenrichtlinie PowerShell 5.1 blockierte, mit `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn` fehl, selbst wenn PowerShell 7 installiert war.

**Was zu tun ist:**

* Wenn die Meldung `Couldn't start the session` lautet, aktualisieren Sie auf v2.1.212 oder später. Auf früheren Versionen können Sie auch zuerst `claude daemon run` in einem separaten Terminal ausführen und dann die Hintergrund-Sitzung erneut starten. Dieser Befehl führt den Hintergrund-Service im Vordergrund des Terminals aus, daher läuft der Service nur so lange, wie dieses Terminal offen bleibt.
* Wenn eine npm-Installation die Binärdatei ersetzt hat, warten Sie, bis sie fertig ist, dann starten Sie die Hintergrund-Sitzung erneut
* Wenn der Fehler auf v2.1.212 oder später erscheint, während keine npm-Installation läuft, klären Sie mit Ihrem Windows-Administrator, ob eine Beschränkungsrichtlinie die Claude Code-Ausführungsdatei blockiert
* Wenn der Hintergrund-Service stoppt, wenn Sie das Terminal schließen, hat Claude Code ihn ohne PowerShell gestartet. Installieren Sie PowerShell 7, oder bitten Sie Ihren Administrator, PowerShell freizugeben, damit der Service das Terminal überleben kann.

### EACCES beim Starten einer Hintergrund-Sitzung

Claude Code konnte seine eigene Binärdatei nicht ausführen, um den [Hintergrund-Service](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) zu starten, der Hintergrund-Sitzungen hostet. Bei einer npm-Installation bedeutet dies normalerweise, dass `npm install -g @anthropic-ai/claude-code` die Binärdatei zu diesem Zeitpunkt ersetzte, ob Sie es ausgeführt haben oder der [Auto-Updater](https://code.claude.com/docs/de/setup.md#auto-updates). Der Fehler erscheint, wenn Sie eine Sitzung aus der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) öffnen:

```text theme={null}
Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'
```

Wenn Sie eine Sitzung mit `/background` oder `claude --bg` starten, erscheint der gleiche Grund innerhalb von `Couldn't reach the background service (...)`. Während desselben Neuinstallationsfensters kann der Fehler stattdessen einen anderen Code benennen, wie `ENOENT` oder `ENOEXEC`, oder `EUNKNOWN` oder `EPERM` unter Windows; ein `EUNKNOWN`, das über Wiederholungsversuche hinweg anhält, hat eine [andere Ursache](#eunknown-when-starting-a-background-session).

Bei einer npm-Installation wartet Claude Code, bis die Neuinstallation abgeschlossen ist, und versucht es automatisch erneut: bis zu zehn Sekunden, und bis zu zwei Minuten, während eine npm-Installation von Claude Code auf der Maschine sichtbar noch läuft, was einen anderen Claude Code-Prozess abdeckt, der ein Update herunterlädt. Wenn die Installation länger als diese Wartezeit dauert, benennt der Fehler das Update anstelle des bloßen Fehlercodes:

```text theme={null}
Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes
```

Vor v2.1.257 endete die Wartezeit in jedem Fall nach zehn Sekunden, daher erschien dieser Fehler, während ein anderer Claude Code-Prozess noch ein Update herunterlud. Vor v2.1.246 schlug Claude Code sofort fehl, ohne zu warten.

**Was zu tun ist:**

* Warten Sie ein paar Sekunden, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Wenn die Meldung sagt, dass Claude Code aktualisiert wird, versuchen Sie es erneut, nachdem das Update fertig ist.
* Wenn der Fehler anhält, während keine npm-Installation läuft, kann Ihr Benutzer die installierte Binärdatei nicht ausführen. Überprüfen Sie ihre Berechtigungen und die ihres Verzeichnisses, oder installieren Sie Claude Code neu.

### Hintergrund-Service beendet, bevor er erreichbar wurde

Der Prozess, den Claude Code als [Hintergrund-Service](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) startete, hat sich beendet, bevor er Verbindungen akzeptierte, daher konnte Claude Code Ihre Sitzung nicht öffnen. Wenn der Service vor dem Beenden einen Fehler ausgegeben hat, gibt der Grund in Klammern den Exit-Code oder das Signal und die erste Zeile an, die der Service ausgegeben hat, die benennt, was ihn gestoppt hat:

```text theme={null}
Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'
```

Wenn Sie eine Sitzung aus der [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) öffnen, folgt der gleiche Grund auf `Couldn't start the background service —`. Wenn der Service vor dem Beenden nichts ausgegeben hat, sagt die Meldung stattdessen `nothing on stderr`.

Claude Code meldet den Fehler mit der Fehlerzeile des Service. Vor v2.1.246 wurde der Fehler erst nach einer Wartezeit von 45 Sekunden angezeigt, als `background service did not become reachable within 45s`, ohne die Fehlerzeile des Service.

Zwei zitierte Gründe haben bekannte Ursachen:

* `Error: claude native binary not installed.`: Eine npm-Installation ersetzte die Claude Code-Binärdatei zu diesem Zeitpunkt, daher führte der Service stattdessen den Platzhalter von npm aus. Versuchen Sie es erneut, nachdem die Installation fertig ist; wenn die Zeile anhält, ohne dass eine Installation läuft, [schließen Sie die npm-Installation ab](https://code.claude.com/docs/de/troubleshoot-install.md#native-binary-not-found-after-npm-install). Vor v2.1.257 verursachte eine npm-Selbstaktualisierung unter macOS diesen Fehler bei jedem Start während des Installationsfensters.
* `nothing on stderr` mit Exit-Code 1, bei jedem Start, unter Windows: `daemon.lock` benennt einen Prozess, den Claude Code weder signalisieren noch als beendet nachweisen kann, daher schließt jeder neue Service, dass ein anderer die Sperre hält, und beendet sich. Eine Sperre, deren Schreiber Claude Code als beendet nachweisen kann, wird von selbst ersetzt und verursacht diesen Fehler nicht. Wenn der Fehler bei jedem Start wiederholt auftritt, löschen Sie `~/.claude/daemon.lock`, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Vor v2.1.257 blockierte eine solche Sperre jeden Start, bis Sie die Datei löschten.

**Was zu tun ist:**

* Wenn die Meldung eine Zeile zitiert, beheben Sie, was sie benennt, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Der nächste Versuch startet den Service erneut
* Führen Sie `claude daemon status` aus, um zu überprüfen, ob jetzt ein Service läuft

### Arbeitsverzeichnis existiert nicht mehr beim Starten einer Hintergrund-Sitzung

Das Verzeichnis, in dem Sie eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) gestartet haben, wurde entfernt, während die Sitzung startete. Claude Code startet die Sitzung nicht, und die Meldung nennt das fehlende Verzeichnis:

```text theme={null}
Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
```

Vor v2.1.257 schien die Sitzung zu starten und erschien dann in der Agent-Ansicht als fehlgeschlagene Zeile mit dem gleichen Grund.

Vor v2.1.281 erschien diese Meldung auch, wenn das Verzeichnis bereits weg war, bevor Sie die Sitzung gestartet haben. Dieser Fall meldet [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).

**Was zu tun ist:**

* Erstellen Sie das Verzeichnis neu, das die Meldung nennt, oder entsenden Sie aus einem Verzeichnis, das existiert, dann versuchen Sie es erneut

### Diese geforkte Sitzung konnte nicht gestartet werden

Sie haben von claude.ai aus [eine Remote-Control-Sitzung geforkt](https://code.claude.com/docs/de/remote-control.md#fork-a-session-from-your-browser), und Claude Code konnte das Starten der [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md), die den Fork auf Ihrem Computer ausführt, nicht abschließen. Dieser Hinweis erscheint im Transkript der geforkten Sitzung:

```text theme={null}
This forked session could not be started. Fork the conversation again to retry.
```

Die Sitzung, die Sie geforkt haben, läuft weiter.

**Was zu tun ist:**

* Kehren Sie zu der Sitzung zurück, die Sie geforkt haben, und forken Sie sie erneut, sobald die Sitzung im Leerlauf ist

### Workspace nicht vertraut beim Entsenden einer Hintergrund-Sitzung

Sie haben eine [Hintergrund-Sitzung](https://code.claude.com/docs/de/agent-view.md) in einem Verzeichnis gestartet oder neu gestartet, dem Sie nicht [vertraut haben](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust), und der Workspace-Vertrauensdialog konnte nicht erscheinen, um Sie zu fragen. Claude Code startet die Sitzung nicht:

```text theme={null}
Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
```

Aus einem Terminal im eigenen Verzeichnis der Sitzung zeigt derselbe Befehl stattdessen den Vertrauensdialog und startet die Sitzung, sobald Sie akzeptieren. Diese Meldung erscheint dort, wo kein Dialog erscheinen kann, etwa in einem Skript, oder wenn Sie eine Sitzung aus einem anderen Verzeichnis als ihrem eigenen neu starten.

Zwei Varianten nennen eine andere Ursache:

* **`The home directory is trusted one session at a time`**: Das Verzeichnis der Sitzung ist Ihr Home-Verzeichnis. Claude Code speichert niemals Vertrauen für das Home-Verzeichnis, daher zählt das Akzeptieren des Dialogs dort in einer früheren Sitzung nicht.
* **`<path> could not be resolved on disk`**: Claude Code konnte das Verzeichnis der Sitzung auf der Festplatte nicht finden.

Vor v2.1.286 konnte diese Meldung unter Windows auch in einem Verzeichnis erscheinen, dem Sie bereits vertraut hatten, wenn dessen Vertrauenseintrag mit dem Pfad in anderer Groß-/Kleinschreibung gespeichert war. Aktualisieren Sie auf v2.1.286 oder später.

**Was zu tun ist:**

* Führen Sie `claude` im Verzeichnis aus, das die Meldung nennt, und akzeptieren Sie den Vertrauensdialog, dann führen Sie den Befehl erneut aus
* Für die Home-Verzeichnis-Meldung führen Sie den Befehl aus einem Terminal in Ihrem Home-Verzeichnis aus, damit der Dialog erscheinen kann, oder starten Sie die Sitzung stattdessen aus einem Projektverzeichnis
* Für die `could not be resolved on disk`-Meldung erstellen Sie das Verzeichnis neu, oder starten Sie eine neue Sitzung aus einem Verzeichnis, das existiert

## Fehler bei Wrapper und IDE

Diese Fehler stammen von dem Programm, das Claude Code für Sie gestartet hat, z. B. eine IDE-Erweiterung oder eine [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Anwendung, und nicht von Claude Code selbst.

### Subprocess initialization did not complete within 60000ms

Dieser Fehler bedeutet, dass ein Claude Code-Prozess, den die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) oder eine Agent SDK-Anwendung gestartet hat, nicht rechtzeitig gemeldet hat, dass er bereit ist. Die Erweiterung bzw. Anwendung hat ihn daraufhin beendet. In einer VS Code-Konversation beginnt der Fehler mit `Claude Code did not finish starting`, zum Beispiel:

```text theme={null}
Claude Code did not finish starting: it did not answer in time. The output logs ("View output logs") show how far it got. Slow plugins, MCP servers, hooks, disks or network can each cause this.
```

In den Ausgabe-Logs der Erweiterung, auf ihrem Anmeldebildschirm und in einer Agent SDK-Anwendung lautet der Fehler anders. Er beginnt mit `Subprocess initialization did not complete within` und dem Zeitlimit und gibt dann an, was Claude Code gemeldet hat, zum Beispiel:

```text theme={null}
Subprocess initialization did not complete within 60000ms. Claude Code did not answer the initialize request and reported no SessionStart or Setup hook running. Slow plugins, MCP servers, hooks that Claude Code does not report, disks or network can each cause this.
```

**Was zu tun ist:**

* Um es in VS Code erneut zu versuchen, senden Sie eine Nachricht. Wenn der Fehler während der Anmeldung aufgetreten ist, wählen Sie stattdessen die Anmeldemethode erneut aus.
* Um zu sehen, wie weit Claude Code gekommen ist, klicken Sie unter dem Fehler einer Konversation auf **View output logs**, oder führen Sie **Claude Code: Show Logs** über die Befehlspalette aus. Fügen Sie die Einträge rund um die Zeile `Subprocess initialization` bei, wenn Sie [das Problem melden](https://github.com/anthropics/claude-code/issues).
* Informationen zur Überprüfung Ihres Netzwerks finden Sie unter [Netzwerkkonfiguration](https://code.claude.com/docs/de/network-config.md). Wenn die Meldung Sie auffordert, Ihre Anmeldung oder Authentifizierung zu überprüfen, lesen Sie [Anmeldung und Authentifizierung](https://code.claude.com/docs/de/troubleshoot-install.md#login-and-authentication).
* Wenn die Meldung besagt, dass [SessionStart](https://code.claude.com/docs/de/hooks.md#sessionstart)- oder [Setup](https://code.claude.com/docs/de/hooks.md#setup)-Hooks noch nicht abgeschlossen waren, [prüfen Sie, wie lange Ihre Hooks laufen](https://code.claude.com/docs/de/hooks.md#debug-hooks). In VS Code zählen die ersten 10 Minuten, in denen Claude Code meldet, dass diese Hooks laufen, nicht zum 60-Sekunden-Limit. Sorgen Sie dafür, dass ein langsamer Hook früher fertig wird, senken Sie den [`timeout`](https://code.claude.com/docs/de/hooks#common-fields) eines nicht asynchronen Hooks, oder [entfernen Sie den Hook](https://code.claude.com/docs/de/hooks.md#disable-or-remove-hooks).
* Wenn Ihre Agent SDK-Anwendung [`startup()`](https://code.claude.com/docs/de/agent-sdk/typescript#startup) aufruft, setzen Sie `initializeTimeoutMs` lang genug für den gesamten Start, oder lassen Sie es ungesetzt, damit bis zu 10 Minuten gemeldeter Hook-Zeit nicht mitzählen.

Vor der VS Code-Erweiterung v2.1.304 und dem TypeScript Agent SDK v0.3.304 zählte die gesamte Hook-Zeit zum Limit. Mit dem Standardlimit enthielt die Meldung `Subprocess initialization did not complete within 60000ms — check authentication and network connectivity`. Wenn Sie diesen Wortlaut sehen, aktualisieren Sie die Erweiterung oder das SDK.

### Claude Code-Prozess mit Code N beendet

Der zugrunde liegende `claude`-Prozess wurde mit einem Nicht-Null-Code beendet. Der Exit-Code allein sagt nicht, was fehlgeschlagen ist: Der eigentliche Fehler befindet sich in der eigenen Ausgabe des Prozesses, die der Wrapper anfügt, wenn er etwas erfasst hat, und ansonsten in seinen Protokollen behält.

```text theme={null}
Error: Claude Code process exited with code 1
```

Unter Windows kann der native Build mit Code `4294967295` direkt nach Abschluss eines Durchlaufs beendet werden. Wenn dieser Exit an einer Durchlauf-Grenze landet, ohne dass eine Nachricht wartet und keine Hintergrundaufgabe ausgeführt wird, schließt die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) die Sitzung stillschweigend, anstatt diesen Fehler anzuzeigen. Ihre nächste Nachricht setzt das Gespräch fort.

Vor v2.1.273 zeigte die Erweiterung den Fehler für diesen Exit bei jeder Durchlauf-Grenze an, obwohl nichts verloren ging.

**Was zu tun ist:**

* In VS Code folgen Sie dem Link **View output logs**, der mit dem Fehler angezeigt wird, um den zugrunde liegenden Fehler zu sehen
* In einer Agent SDK-Anwendung fangen Sie den Fehler um Ihre Nachrichtenschleife ab. Die Einträge unter [CLI-Prozess-Exit](https://code.claude.com/docs/de/agent-sdk/troubleshooting.md#cli-process-exit) behandeln, was Ihr Code in jeder SDK-Sprache erhält.
* Führen Sie `claude` in einem Terminal im selben Projekt aus. Der Fehler wird dort normalerweise mit seiner echten Fehlermeldung reproduziert, die Sie dann auf dieser Seite nachschlagen können.
* Führen Sie `claude doctor` in einem Terminal aus, um die Installation und Konfiguration zu überprüfen

### Claude CLI auf PATH nicht gefunden

Die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) zeigt diesen Fehler unter Windows an, wenn Sie Claude Code im integrierten Terminal öffnen, die Shell des Terminals PowerShell ist und die Erweiterung die installierte `claude`-Ausführungsdatei auf PATH nicht finden kann. Die Erweiterung weigert sich, Claude Code zu starten, bis sie die installierte `claude` auf PATH findet.

```text theme={null}
Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH. Launching by name in a PowerShell terminal would run a 'claude' from the open folder instead of the installed CLI, so the launch was blocked. Make sure the Claude CLI's install directory is on your system PATH (not only your PowerShell profile), then restart VS Code and try again. VS Code reads PATH when it starts, so PATH changes take effect only after a restart.
```

**Was zu tun ist:**

* Öffnen Sie ein neues PowerShell-Fenster außerhalb von VS Code und führen Sie `where.exe claude` aus. Wenn es keinen Pfad ausgibt, befindet sich die CLI nicht auf Ihrem PATH: Fügen Sie sein Installationsverzeichnis hinzu, indem Sie [Überprüfen Sie Ihren PATH](https://code.claude.com/docs/de/troubleshoot-install.md#verify-your-path) befolgen. Wenn es einen Pfad ausgibt, stammt der Eintrag aus Ihrem PowerShell-Profil oder aus einer PATH-Änderung, die VS Code noch nicht aufgegriffen hat; die nächsten zwei Schritte behandeln diese Fälle.
* Legen Sie den PATH-Eintrag als Benutzer- oder Systemumgebungsvariable fest, nicht in Ihrem PowerShell-Profil. Die Erweiterung führt Ihr Profil nicht aus, daher erreicht eine PATH-Bearbeitung, die nur dort vorhanden ist, sie nie.
* Starten Sie VS Code nach dem Ändern von PATH neu. Die Erweiterung überprüft den PATH, den VS Code beim Start erfasst hat, daher wird eine PATH-Änderung erst nach einem Neustart wirksam.

### The Claude Code program for this computer could not be found

Die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) hat nach der in ihr gebündelten Kopie von Claude Code gesucht und keine gefunden, die für Ihren Computer gebaut wurde. Die Meldung nennt den Build, den Ihr Computer benötigt:

```text theme={null}
The Claude Code program for this computer, the Linux (linux-x64) build, could not be found.
```

**Was zu tun ist:**

* Wenn die Meldung angibt, welchen Build die Erweiterung enthält, haben Sie das Erweiterungspaket für eine andere Plattform: Installieren Sie das Paket, das für den in der Meldung genannten Build erstellt wurde
* Wenn die Meldung nicht angibt, welchen Build die Erweiterung enthält, installieren Sie die Claude Code-Erweiterung über die Erweiterungsansicht Ihres Editors neu
* Oder setzen Sie in beiden Fällen [`claudeCode.claudeProcessWrapper`](https://code.claude.com/docs/de/vs-code#extension-settings) auf eine separat installierte `claude`-Binärdatei

Vor v2.1.290 wurde dies als `Unsupported platform: <platform>-<arch>. No compatible Claude Code binary found.` angezeigt.

### Die Verbindung zu Claude Code wurde beendet, bevor diese Nachricht abgeschlossen wurde

Die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) hat Ihre Nachricht an den `claude`-Prozess gesendet, und die Verbindung wurde ohne Fehler beendet, bevor der Prozess sie bestätigt oder abgeschlossen hat. Die Erweiterung kann nicht feststellen, ob die Nachricht verarbeitet wurde, daher fordert sie Sie auf, sie erneut zu senden:

```text theme={null}
The connection to Claude Code ended before this message completed — it may not have been processed, so please send it again.
```

**Was zu tun ist:**

* Senden Sie die Nachricht erneut. Die nächste Nachricht startet einen neuen `claude`-Prozess, der das Gespräch fortsetzt.
* Wenn es sich wiederholt, führen Sie `claude` in einem Terminal im selben Projekt aus. Ein Fehler, der den Prozess immer wieder beendet, wird dort normalerweise mit seiner echten Fehlermeldung reproduziert.

## Rewind-Warnungen und Fehler

Diese Meldungen stammen von einer [`/rewind`](https://code.claude.com/docs/de/checkpointing) Code-Wiederherstellung. `Restored the code, but skipped N files` ist eine Warnung, dass Claude Code einige Pfade übersprungen hat. `No files were restored` ist ein Fehler, der bedeutet, dass nichts wiederhergestellt wurde.

### Restored the code, but skipped files

Eine `/rewind` Code-Wiederherstellung hat einen oder mehrere überwachte Pfade übersprungen, anstatt sie zu schreiben oder zu löschen. Claude Code überspringt einen Pfad, wenn:

* er ist oder wurde ein Symlink, Hard Link oder eine andere nicht-reguläre Datei
* sein Verzeichnis sich seit dem Checkpoint geändert hat
* seine Sicherung nicht sicher gelesen werden kann

Übersprungene Pfade behalten ihren aktuellen Inhalt. Vor v2.1.216 schrieb und löschte `/rewind` durch Links bei überwachten Pfaden und meldete keine teilweise Wiederherstellung.

```text theme={null}
Restored the code, but skipped 2 files: the tracked path is (or became) a link or other non-regular file, its directory changed since the checkpoint, or its backup could not be safely read. Skipped files were left untouched — run with --debug for the paths.
```

**Was zu tun ist:**

* Identifizieren Sie, welche Dateien übersprungen wurden, damit Sie jede mit den folgenden Schritten behandeln können. Die Meldung gibt nur eine Anzahl an; das Debug-Protokoll unter `~/.claude/debug/<session-id>.txt` nennt jeden übersprungenen Pfad während der Wiederherstellung, also aktivieren Sie Debug-Protokollierung mit `/debug` vor Ihrer nächsten Wiederherstellung. Unter macOS oder Linux können Sie die Links stattdessen direkt finden: `find . -type l` für Symlinks und `find . -type f -links +1` für Hard-linked-Dateien.
* Wenn eine übersprungene Datei ein Link ist, den Sie absichtlich erstellt haben, z. B. eine Konfigurationsdatei, die von einem Dotfile-Manager verwaltet wird, oder eine Datei, die von Tools wie pnpm Hard-linked ist, hat der Rewind ihren Inhalt allein gelassen. Um die Änderungen der Sitzung rückgängig zu machen, bitten Sie Claude, die Bearbeitung rückgängig zu machen oder bearbeiten Sie die Datei selbst
* Wenn Sie den Link nicht erstellt haben, überprüfen Sie den Pfad, bevor Sie seinem Inhalt vertrauen

### No files were restored

Claude Code zeigt diese Meldung an, wenn Sie Code mit [`/rewind`](https://code.claude.com/docs/de/checkpointing) wiederherstellen und keine der Dateien in diesem Checkpoint wiederherstellen kann. Für jede Datei fehlt entweder die Sicherung, die Claude Code vor der Bearbeitung gespeichert hat, oder Claude Code konnte die Datei nicht schreiben oder löschen.

```text theme={null}
Failed to restore the code:
No files were restored: 1 file failed (backup missing, or the file could not be updated)
```

Claude Code löscht die Sicherungen einer Sitzung beim [Aufräumen](https://code.claude.com/docs/de/claude-directory.md#cleaned-up-automatically), standardmäßig etwa 30 Tage, nachdem die Sitzung eine zuletzt gespeichert hat. Wenn Sie eine Sitzung danach fortsetzen, listet `/rewind` ihre Checkpoints immer noch auf, aber das Zurückspulen zu einem von ihnen kann mit diesem Fehler fehlschlagen. Wenn die Meldung auch `N paths were skipped for link safety` sagt, siehe [Restored the code, but skipped files](#restored-the-code-but-skipped-files) für diese Pfade.

Wenn Sie eine Sitzung verzweigen, z. B. mit [`--fork-session`](https://code.claude.com/docs/de/cli-reference#cli-flags) oder [`/branch`](https://code.claude.com/docs/de/sessions#branch-a-session), kopiert Claude Code die Sicherungen der ursprünglichen Sitzung in die Verzweigung. Wenn Claude Code eine Sicherung nicht kopieren kann, z. B. weil der Speicherplatz voll ist, fehlt diese Sicherung in der Verzweigung. Das Zurückspulen zu einem Checkpoint, der sie benötigt, kann mit diesem Fehler fehlschlagen.

**Was zu tun ist:**

* Machen Sie die Änderungen auf andere Weise rückgängig: Bitten Sie Claude, seine Bearbeitungen rückgängig zu machen, oder stellen Sie die Dateien aus der Versionskontrolle wieder her. Wenn die Sicherungen weg sind, schlägt das erneute Ausführen von `/rewind` auf die gleiche Weise fehl.
* Wenn Claude Code eine Datei nicht schreiben oder löschen konnte, beheben Sie das, was den Schreibvorgang blockiert, z. B. Dateiberechtigungen, und führen Sie dann `/rewind` erneut aus.
* Um Sicherungen in zukünftigen Sitzungen länger zu behalten, erhöhen Sie [`cleanupPeriodDays`](https://code.claude.com/docs/de/settings-reference#cleanupperioddays).

Vor v2.1.260 übersprangen Claude Code stillschweigend Dateien, deren Sicherungen fehlten, und die Wiederherstellung schien erfolgreich zu sein.

## Warnungen zum Speichern von Sitzungen

Claude Code zeigt diese Warnungen auf einer persistenten Zeile unter dem Eingabefeld an, wenn die Sitzungstranskription nicht gespeichert wird. Die Sitzung funktioniert in beiden Fällen weiter; die Warnungen teilen Ihnen mit, dass die Sitzung möglicherweise später bei [`--resume`](https://code.claude.com/docs/de/sessions) fehlt.

### Transkriptschreibvorgänge schlagen fehl

Claude Code speichert das Transkript während der Arbeit auf der Festplatte, und die Schreibvorgänge in [die Transkriptdatei](https://code.claude.com/docs/de/sessions.md#where-transcripts-are-stored) schlagen fehl. Die Meldung benennt die Ursache mit dem zugrunde liegenden Fehlercode, beispielsweise eine volle Festplatte:

```text theme={null}
Transcript writes are failing (disk full — ENOSPC) · recent messages may not be saved for resume
```

Die Warnung wird je nach Fehler an verschiedenen Stellen angezeigt:

* Beim ersten Fehler für Bedingungen, die sich nicht von selbst beheben: eine volle Festplatte, ein überschrittenes Festplattenkontingent, ein schreibgeschütztes Dateisystem, ein Pfad, der die Längenbeschränkung des Dateisystems überschreitet, oder auf macOS und Linux ein Berechtigungsfehler
* Nach wiederholten Fehlern, die sich über mindestens eine Minute erstrecken, für alles andere, einschließlich Berechtigungsfehlern unter Windows, bei denen ein Antivirenscan einen einzelnen Schreibvorgang fehlschlagen lassen kann, der dann beim erneuten Versuch erfolgreich ist

Vor v2.1.217 verwarf Claude Code die fehlgeschlagenen Schreibvorgänge ohne Warnung, und ein späteres `--resume` mit fehlenden aktuellen Meldungen war das erste Zeichen.

**Was zu tun ist:**

* Beheben Sie die Bedingung, die der Fehlercode benennt: Geben Sie Festplattenspeicher für `ENOSPC` frei; erhöhen oder löschen Sie das Kontingent für `EDQUOT`; stellen Sie Schreibzugriff auf den Transkriptspeicherort für `EACCES`, `EPERM` oder `EROFS` wieder her
* Die Warnung wird beim nächsten erfolgreichen Schreibvorgang automatisch gelöscht; kein Neustart ist erforderlich
* Meldungen, die während der Anzeige der Warnung gesendet wurden, können später beim Fortsetzen der Sitzung immer noch fehlen

### Transkriptspeicherung ist deaktiviert, da CLAUDE\_CODE\_SKIP\_PROMPT\_HISTORY gesetzt ist

Diese Sitzung wurde mit [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/de/env-vars) gestartet, daher schreibt Claude Code keine Transkription oder Eingabeaufforderungsverlauf dafür:

```text theme={null}
Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set · --resume will not find this session; if unintended, unset it and restart
```

Die Variable ist ein absichtliches Opt-out für kurzlebige Skriptsitzungen, kann aber auch eine Sitzung durch ein Shell-Profil, ein Wrapper-Skript oder einen übergeordneten Prozess erreichen, der sie exportiert hat.

**Was zu tun ist:**

* Wenn Sie die Variable absichtlich gesetzt haben, ist keine Aktion erforderlich; die Benachrichtigung bestätigt, dass die Sitzung nicht in `--resume`, `--continue` oder im Aufwärts-Pfeil-Verlauf angezeigt wird
* Wenn nicht, entfernen Sie die Variable aus der Shell oder dem Skript, das `claude` startet, und starten Sie dann eine neue Sitzung. Meldungen aus der aktuellen Sitzung werden nicht rückwirkend gespeichert.

### Transkriptspeicherung ist deaktiviert, da ein vererbter CLAUDE\_CODE\_CHILD\_SESSION-Marker vorhanden ist

Claude Code setzt [`CLAUDE_CODE_CHILD_SESSION`](https://code.claude.com/docs/de/env-vars) in den Unterprozessen, die es startet, und behandelt eine interaktive Sitzung, die ihn erbt, als verschachtelt: Claude Code speichert keine Transkription dafür, daher füllen Sitzungen, die Claude selbst startet, nicht Ihre `--resume`-Liste. Diese Benachrichtigung bedeutet, dass Ihre aktuelle Sitzung den Marker geerbt hat:

```text theme={null}
Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker · restart with CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 to keep future transcripts
```

Die Benachrichtigung ist zu erwarten, wenn Sie `claude` von innen aus einer anderen Claude Code-Sitzung ausgeführt haben; sie signalisiert eine Fehlklassifizierung, wenn der Marker durch einen langlebigen Vermittler durchgesickert ist, beispielsweise ein Terminal, eine `screen`-Sitzung oder ein Launcher, den eine Claude Code-Sitzung ursprünglich gestartet hat.

Innerhalb von tmux erkennt Claude Code einen Marker, der durch die globale Umgebung des tmux-Servers angekommen ist, und setzt das Speichern fort, daher wird diese Benachrichtigung für diesen Fall nicht angezeigt.

**Was zu tun ist:**

* Wenn Sie diese Sitzung absichtlich von innen aus einer anderen Claude Code-Sitzung gestartet haben, ist keine Aktion erforderlich
* Wenn dies eine Sitzung auf oberster Ebene ist, beenden Sie sie und starten Sie sie mit [`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`](https://code.claude.com/docs/de/env-vars) neu. Das Speichern wird ab dem Neustart angewendet, daher werden Meldungen, die davor gesendet wurden, nicht gespeichert.
* Um zukünftige Starts vom selben Terminal oder Launcher zu beheben, entfernen Sie `CLAUDE_CODE_CHILD_SESSION` aus seiner Umgebung

## Konfigurationswarnungen

Um eine Warnung zu finden, die Claude Code beim Start einer interaktiven Sitzung ausgegeben hat, sehen Sie zuerst unterhalb des Startbanners nach und dann im Debug-Log:

* **Zeile unterhalb des Startbanners**: einige Warnungen zu [Berechtigungsregeln](https://code.claude.com/docs/de/permissions.md), z. B. [`⚠ Deny rule Bsh matches no tool · check for typos`](#matches-no-tool)
* **Debug-Log**: Claude Code führt dieses Log nur im Debug-Modus. Um die darin enthaltenen Warnungen zu lesen, starten Sie Claude Code aus Ihrer Shell mit `claude --debug-file <path>` und öffnen Sie dann die Datei unter diesem Pfad.

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit Textausgabe, außerhalb einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md), finden Sie Startwarnungen auf stderr.

Vor v2.1.305 finden Sie sie auch in einer interaktiven Sitzung auf stderr, einschließlich der Warnungen zu Berechtigungsregeln, die jetzt als Zeilen unterhalb des Banners erscheinen.

### Claude Code wurde nach einem nicht behebbaren Schnittstellenfehler beendet

Claude Code gibt diese Meldung aus, wenn es beendet wird, weil seine Terminalschnittstelle auf einen Fehler stößt, von dem sie sich nicht erholen kann, in beiden Renderern. Der zweite Satz erscheint nur, wenn der Fehler aufgetreten ist, während der [Fullscreen](https://code.claude.com/docs/de/fullscreen.md)-Renderer gestartet wurde:

```text theme={null}
Claude Code exited after an unrecoverable interface error (<error>). It happened while the fullscreen renderer was starting, so the next launch will use the classic renderer (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 forces that any time).
```

**Was zu tun ist:**

* Starten Sie Claude Code erneut. Um die Konversation fortzusetzen, führen Sie `claude --resume` im selben Verzeichnis aus.
* Wenn die Meldung den Fullscreen-Renderer benennt, sagt [Fullscreen-Rendering](https://code.claude.com/docs/de/fullscreen.md#fullscreen-renderer-didnt-finish-starting), was der nächste Start tut, was davon abhängt, wie Sie Fullscreen aktiviert haben, und wie Sie Fullscreen erneut versuchen oder den klassischen Renderer beibehalten können.

Vor v2.1.236 wurde Claude Code nach dieser Art von Fehler ohne Meldung beendet.

### Agent-Beschreibungen überschreiten das Limit von 15.000 Token

Claude Code zeigt diese Warnung als Startnachricht in der Konversationsansicht statt auf stderr an. Die kombinierten Beschreibungen Ihrer [Subagenten](https://code.claude.com/docs/de/sub-agents.md), außer den integrierten, überschreiten 15.000 Token, wie Claude Code sie schätzt. Jeder Agent zählt seinen Namen plus sein `description`-Frontmatter. Claude Code lädt jeden Agent, unabhängig davon, ob die Gesamtzahl das Limit überschreitet, daher ändert die Warnung nicht, was geladen wird.

```text theme={null}
Agent descriptions are over the 15.0k-token limit (~16.2k tokens) · ask Claude to trim agent descriptions in .claude/agents/
```

**Was zu tun ist:**

* Kürzen Sie das `description`-Frontmatter Ihrer Agent-Dateien, oder bitten Sie Claude, diese für Sie zu kürzen.
* Entfernen Sie Agent-Dateien, die Sie nicht mehr verwenden.

### Hook needs quotes around a path with a space

Diese Benachrichtigung in der Konversationsansicht bedeutet, dass das Skript eines Hooks nicht ausgeführt wurde, weil sein Pfad ein Leerzeichen enthält und nicht in Anführungszeichen steht. Dieser Hook ist ein [`asyncRewake`](https://code.claude.com/docs/de/hooks#run-hooks-in-the-background)-Hook in Shell-Form. In seinem `command` folgt auf einen Interpreter wie `python3` ein Pfadplatzhalter ohne Anführungszeichen, und der aufgelöste Pfad enthält ein Leerzeichen.

Die Benachrichtigung beginnt mit dem Ereignisnamen des Hooks und benennt das Skript:

```text theme={null}
Stop hook needs quotes around a path with a space (check.py)
```

**Was zu tun ist:**

* Setzen Sie im `command` des Hooks, der das in der Benachrichtigung genannte Skript ausführt, den Pfad in doppelte Anführungszeichen. In einer JSON-Datei schreiben Sie ihn als `"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\""`.

### Instruction file not loaded

Dieser Hinweis in der Konversationsansicht einer interaktiven Sitzung bedeutet, dass eine vorhandene [Memory-Datei](https://code.claude.com/docs/de/memory.md#how-claude-md-files-load) nicht geladen wurde. Eine Lesebeschränkung ist in Kraft.

```text theme={null}
Instruction file not loaded (a Read deny rule covers it):
path: .claude/rules/shared.md
```

Die Klammer benennt den Grund, zum Beispiel:

* **`a Read deny rule covers it`**: Eine `Read`-[deny-Regel](https://code.claude.com/docs/de/permissions.md#read-and-edit) passt auf den Pfad der Datei, wie er geschrieben ist, oder auf das Ziel, auf das ein Link darauf verweist
* **`it's read from outside your working directories, where reads are blocked`**: Die Datei wird außerhalb der [Arbeitsverzeichnisse](https://code.claude.com/docs/de/settings-reference.md#permissions-blockreadsoutsideworkingdirectories) aufgelöst, während [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) aktiviert ist
* **`where it leads couldn't be worked out`**: Zum Beispiel ist die Datei ein Link, der direkt oder über andere Links auf sich selbst zurückverweist

Wenn die eigene Memory-Datei eines Unterverzeichnisses nicht geladen werden kann, während Claude mit Dateien dort arbeitet, erscheinen dieselben Zeilen während des Turns in der Konversation. Wenn mehr Dateien zurückgehalten werden, als die Zeilen benennen, zählt eine letzte Zeile den Rest, z. B. `and 3 more instruction files not loaded`.

**Was zu tun ist:**

* Nichts, wenn die Beschränkung beabsichtigt ist: Die Sitzung läuft ohne die Anweisungen dieser Datei.
* Um eine Datei zu laden, die wegen `a Read deny rule covers it` zurückgehalten wurde, [entfernen Sie diese Regel oder grenzen Sie sie ein](https://code.claude.com/docs/de/permissions.md#manage-permissions). Starten Sie dann eine neue Sitzung.
* Um eine Datei zu laden, die wegen `it's read from outside your working directories, where reads are blocked` zurückgehalten wurde, verschieben Sie sie oder ihr Link-Ziel in die Arbeitsverzeichnisse. Starten Sie dann eine neue Sitzung.
* Um eine Datei zu laden, die wegen `where it leads couldn't be worked out` zurückgehalten wurde, prüfen Sie, ob die Datei ein Link ist, der auf sich selbst zurückverweist. Falls ja, lassen Sie den Link auf eine vorhandene Datei verweisen oder ersetzen Sie ihn durch eine reguläre Datei. Starten Sie dann eine neue Sitzung.

Vor v2.1.292 benannte der Hinweis die Datei am Ende derselben Zeile nach dem Grund.

### Eine Fähigkeit, ein Befehl oder ein Workflow wurde nicht geladen, weil sein Name reserviert ist

Ein Fähigkeitsordner, ein Frontmatter `name`, eine Datei oder ein Unterordner in `.claude/commands/` oder ein [gespeicherter Workflow](https://code.claude.com/docs/de/workflows.md#save-the-workflow-for-reuse) verwendet den Namen `anthropic-skills` oder einen Namen, der mit `anthropic-skills:` beginnt. Claude Code [reserviert diesen Namen für Fähigkeiten, die von claude.ai synchronisiert werden](https://code.claude.com/docs/de/skills.md#names-reserved-for-synced-skills) und lädt diesen Artikel nicht.

Claude Code zeigt diese Warnung als Startnachricht in der Konversationsansicht statt auf stderr an:

```text theme={null}
Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account
```

Die Meldung benennt, was für den ersten Artikel geändert werden soll, den sie abgelehnt hat: einen Ordner oder eine Datei zum Umbenennen, eine `name:`-Zeile zum Bearbeiten oder einen Workflow zum Umbenennen. Wenn mehr als ein Artikel abgelehnt wurde, endet die Meldung mit einer Anzahl wie `· 2 more`, und das [Debug-Protokoll](https://code.claude.com/docs/de/debug-your-config.md) benennt jeden.

**Was zu tun ist:**

* Benennen Sie den Artikel um, den die Meldung benennt, oder bearbeiten Sie die `name:`-Zeile, auf die sie verweist, und starten Sie die Sitzung neu.

Vor v2.1.282 lud Claude Code Fähigkeiten und Befehle mit diesen Namen.

### Skill- oder Befehlsname abgelehnt

Diese Startnachricht bedeutet, dass Claude Code den Namen mindestens eines [Skills oder benutzerdefinierten Befehls](https://code.claude.com/docs/de/skills.md) abgelehnt hat, sodass dieser nicht oder ohne sein `name`-Feld geladen wurde:

```text theme={null}
1 skill or command name refused: run with --debug to see which ([names]), rename, then restart — a name may not hold hidden, direction-changing or blank-like characters, < or >, or be over 256 characters
```

* **Nicht geladen**: Claude Code hat den Namen abgelehnt, unter dem ein Skill oder Befehl geführt wird, z. B. seinen Verzeichnisnamen oder den Namen oder Unterordner einer Befehlsdatei. Er fehlt im `/`-Menü, und Claude kann ihn nicht aufrufen. Seine Zeile im Debug-Log lautet `<name> is not offered`.
* **`name`-Feld ignoriert**: Claude Code hat den Frontmatter-`name` eines Skills abgelehnt. Der Skill wird trotzdem geladen, aber das `/`-Menü zeigt den `name`-Wert nicht an, und die Eingabe dieses Werts ruft den Skill nicht auf. Seine Zeile im Debug-Log lautet `<name value> is not shown for <skill>`.

**Was zu tun ist:**

* Starten Sie Claude Code mit `claude --debug` aus Ihrer Shell und durchsuchen Sie das [Debug-Log](https://code.claude.com/docs/de/debug-your-config.md) nach `[names]`. Jeder Name, den die Meldung zählt, hat dort eine Zeile. Die Zeile schreibt einige versteckte Zeichen als Codes aus, z. B. `\u{200B}` für ein Leerzeichen mit Nullbreite, damit Sie sehen, wo sie sich befinden.
* Entfernen Sie die [Zeichen, die ein Skill-Name nicht enthalten darf](https://code.claude.com/docs/de/skills.md#characters-a-skill-name-cant-hold), indem Sie den Ordner oder die Datei umbenennen oder die `name:`-Zeile bearbeiten, oder kürzen Sie einen Namen, der länger als 256 Zeichen ist. Starten Sie dann die Sitzung neu, es sei denn, die Datei befindet sich in einem Verzeichnis, das Claude Code [auf Änderungen überwacht](https://code.claude.com/docs/de/skills.md#live-change-detection). Bei einem Skill aus einem Plugin, das Sie nicht selbst geschrieben haben, bitten Sie den Autor des Plugins, ihn umzubenennen.

### Arbeitsbereich wurde nicht vertraut

Claude Code fand `permissions.allow`-Regeln oder `permissions.additionalDirectories`-Einträge in der `.claude/settings.json` oder `.claude/settings.local.json` des Projekts und wendete sie nicht an, weil [Allow-Regeln aus Projekteinstellungen Arbeitsbereichsvertrauen erfordern](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust). Die Anzahl, der Einstellungsname und die in der Meldung benannte Datei variieren je nach Ihrer Konfiguration. `deny`- und `ask`-Regeln sind nicht betroffen.

```text theme={null}
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. [Projekterlaubnisregeln und Arbeitsbereichsvertrauen](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust) sagt, welcher Ordner diese Akzeptanz abdeckt.
* Im [nicht-interaktiven Modus](https://code.claude.com/docs/de/headless.md) 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.
* Wenn die Meldung `.claude/settings.local.json` benennt 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` als vom Repository bereitgestellt in diesen Arbeitsbereichen. Auf v2.1.207 und später reicht eine Aktualisierung außerhalb eines Git-Repositorys nicht aus, 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 akzeptieren, daher verwenden Sie den ersten Schritt. Ihr Home-Verzeichnis und alle anderen [Konfigurationshome](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust) sind ausgenommen und warten nicht auf den Dialog. Siehe [Projekterlaubnisregeln und Arbeitsbereichsvertrauen](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust).

### Arbeitsverzeichnis ist ein Netzwerkpfad

Claude Code fügt Netzwerkpfade nicht als Arbeitsverzeichnisse hinzu. Das Nachschlagen eines Netzwerkpfads kann den Host kontaktieren, den er benennt, und unter Windows kann dieser Kontakt dem Host Ihre Anmeldedaten senden. Claude Code lehnt den Pfad daher ab, ohne ihn nachzuschlagen.

Sie sehen diese Meldung, wenn Sie `/add-dir` mit einem Netzwerkpfad ausführen:

```text theme={null}
\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).
```

Wenn Sie stattdessen einen solchen Pfad beim Start übergeben, mit `--add-dir` oder in `permissions.additionalDirectories`, startet Claude Code ohne dieses Verzeichnis. In einer interaktiven Sitzung sehen Sie die Meldung beim Start nicht, weil sie zusammen mit den anderen [Startwarnungen](#configuration-warnings) in das Debug-Log geschrieben wird.

Pfade, die Claude Code auf diese Weise ablehnt, umfassen:

* UNC-Freigaben wie `\\server\share`
* Automount-Pfade wie `/net/<host>`, es sei denn, Sie haben Claude Code aus einem Verzeichnis unter dem Automount dieses Hosts gestartet. Lesezugriffe unter diesem Automount durchlaufen weiterhin die [Netzwerkpfadprüfung](https://code.claude.com/docs/de/permissions.md#network-paths).
* Lokale Pfade, die einen Netzwerkort über einen symbolischen Link oder eine Verknüpfung erreichen

Zugeordnete Laufwerksbuchstaben und `\\wsl$`-Pfade zählen nicht als Netzwerkpfade.

**Was zu tun ist:**

* Unter Windows ordnen Sie die Freigabe einem Laufwerksbuchstaben zu und übergeben Sie das Laufwerk beim Start. Führen Sie in PowerShell beispielsweise `net use Z: \\server\share` und dann `claude --add-dir Z:\` aus.
* Unter macOS oder Linux mounten Sie die Freigabe unter einem lokalen Pfad und fügen Sie stattdessen diesen Pfad hinzu.
* Wenn sich der Pfad in `permissions.additionalDirectories` befindet, entfernen Sie ihn aus der Einstellungsdatei, die ihn auflistet.

Vor v2.1.257 akzeptierte Claude Code einen erreichbaren Netzwerkpfad als Arbeitsverzeichnis.

### Remote verwaltete Einstellungen konnten nicht geladen werden

Ihre Sitzung ist für [servergesteuerte Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) berechtigt, aber Claude Code konnte sie nicht abrufen oder konnte nicht anwenden, was der Server zurückgegeben hat, daher zeigt es diese Warnung in interaktiven Sitzungen und im Code-Tab von Claude Desktop an.

Die eingeklammerte Ursache benennt, was fehlgeschlagen ist, z. B. `network error`, `request timed out` oder `authentication rejected (401)`. Die Ursache `no setting in the server response could be applied as written` bedeutet, dass der Server geantwortet hat, aber keine der Einstellungen, die er zurückgegeben hat, die [Validierung](https://code.claude.com/docs/de/server-managed-settings.md#invalid-entries-in-delivered-settings) bestanden hat. Vor v2.1.282 lautete diese Ursache `server returned invalid settings`.

Der Rest der Zeile sagt, welche Richtlinie die Sitzung ausführt:

* **Einstellungen aus einem früheren erfolgreichen Abruf zwischengespeichert**: Claude Code führt die Sitzung auf dieser zwischengespeicherten Richtlinie aus, außer den [zurückhaltenen Umgebungsvariablen](https://code.claude.com/docs/de/server-managed-settings.md#fetch-and-caching-behavior), und die Zeile liest `using cached policy`.
* **Keine zwischengespeicherten Einstellungen zum Anwenden**: Claude Code führt die Sitzung ohne servergesteuerte Einstellungen aus, und die Zeile lautet `no remote policy applied`. Zum Beispiel hat der Computer noch keine Einstellungen abgerufen oder sie zuletzt vor mehr als [24 Stunden](https://code.claude.com/docs/de/server-managed-settings.md#fetch-and-caching-behavior) abgerufen.

Im Code-Tab erscheint die Warnung als Zeile in der Konversation, wenn Sie eine Nachricht senden, und eine neue Zeile erscheint, wenn sich der Status des Abrufs ändert. Drei verwandte Meldungen erscheinen auf dieselbe Weise:

* `Remote managed settings are still loading`: Der Abruf lief noch, als die Sitzung fortgesetzt wurde
* `Remote managed settings did not load`: Der Abruf endete ohne Antwort
* `Remote managed settings have now loaded`: Die Einstellungen wurden nach einer dieser Warnungen geladen, und der Rest der Zeile gibt an, ob eine Remote-Richtlinie gilt

**Was zu tun ist:**

* Handeln Sie nach der Ursache, die die Meldung benennt: Überprüfen Sie für eine Netzwerkursache, dass dieser Computer `api.anthropic.com` erreichen kann; für eine Authentifizierungsursache überprüfen Sie Ihre Anmeldung mit `/status`
* Für `no setting in the server response could be applied as written` bitten Sie Ihren Administrator, die Einstellungen auf dem Server zu korrigieren
* Führen Sie `/status` oder `claude doctor` aus, um die vollständige Diagnose zu erhalten

Vor v2.1.248 meldete Claude Code einen fehlgeschlagenen Einstellungsabruf nur im Debug-Protokoll.

### Claude Code konnte die Einstellungen Ihrer Organisation nicht laden

Ihre Sitzung wurde nicht gestartet, weil die Einstellungen Ihrer Organisation, einschließlich ihrer [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md), zuerst geladen werden müssen und Claude Code sie nicht laden konnte. Zum Beispiel:

```text theme={null}
Claude Code couldn't reach Anthropic to load your organization's settings (could not connect). <Organization name> requires them before a session can start.
```

Wenn die Meldung in einem Dialog mit dem Titel `Claude Code can't start this session yet` erscheint, schließt sich der Dialog, und die Sitzung startet, sobald die Einstellungen geladen sind.

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) und in [Hintergrundsitzungen](https://code.claude.com/docs/de/agent-view.md) gibt Claude Code stattdessen die Meldung aus und wird mit Status 1 beendet.

**Was zu tun ist:**

* **`could not connect` oder `the reply came from a network proxy, not Anthropic`**: Überprüfen Sie Ihre Netzwerkverbindung, und bitten Sie in einem Unternehmensnetzwerk die IT, HTTPS zu `api.anthropic.com/api/claude_code/policy_limits` und `api.anthropic.com/api/claude_code/settings` zuzulassen. Wählen Sie dann **Retry now** aus, oder führen Sie Ihren Befehl erneut aus.
* **`timed out`, `Anthropic returned an error` oder `Anthropic asked it to retry shortly`**: Lassen Sie den Dialog es erneut versuchen, oder führen Sie Ihren Befehl später erneut aus. Prüfen Sie [status.anthropic.com](https://status.anthropic.com), wenn das Problem weiterhin auftritt.
* **`still loading` oder `couldn't verify your sign-in with Anthropic yet`**: Lassen Sie den Dialog es erneut versuchen, oder führen Sie Ihren Befehl erneut aus. Wenn die Anmeldemeldung immer wieder erscheint, melden Sie sich erneut an, indem Sie `claude auth login` in Ihrer Shell ausführen.
* **`Your Claude session has expired`**: Die auf diesem Computer gespeicherte Anmeldung ist nicht mehr gültig, daher hilft ein erneuter Versuch nicht. Wählen Sie im Dialog **Sign in again** aus, um Claude Code zu schließen; führen Sie dann in Ihrer Shell `claude auth login` aus, was auch funktioniert, solange Sitzungen nicht starten können.
* **`none of the settings the server returned could be applied as written`**: Bitten Sie Ihren Administrator, die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md#invalid-entries-in-delivered-settings) der Organisation zu korrigieren, und versuchen Sie es dann erneut.

### Verwaltete Einstellungen wurden nicht genehmigt

Die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) Ihrer Organisation enthalten Einstellungen, die Ihre Genehmigung benötigen, und Sie haben den [Sicherheitsgenehmigungsdialog](https://code.claude.com/docs/de/server-managed-settings.md#security-approval-dialogs) abgelehnt, daher wird Claude Code beendet, ohne sie anzuwenden:

```text theme={null}
Managed settings were not approved; exiting without applying them.
```

**Was zu tun ist:**

* Starten Sie Claude Code erneut und genehmigen Sie den Dialog, um unter den Einstellungen Ihrer Organisation fortzufahren. Ein abgelehnter Dialog wird nicht gespeichert, daher erscheint er beim nächsten Start erneut.
* Wenn Sie sich über eine Einstellung unsicher sind, die der Dialog auflistet, fragen Sie denjenigen, der die verwalteten Einstellungen Ihrer Organisation verwaltet, bevor Sie genehmigen

### Managed settings need your approval

Die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) Ihrer Organisation enthalten Einstellungen, die Ihre Genehmigung im [Sicherheitsgenehmigungsdialog](https://code.claude.com/docs/de/server-managed-settings.md#security-approval-dialogs) benötigen. Der von Ihnen ausgeführte `claude plugin`-Befehl konnte nicht von der Tastatur lesen und diesen Dialog daher nicht anzeigen. Das passiert, wenn Sie seine Eingabe per Pipe oder Umleitung übergeben und er unter macOS und Linux außerdem `/dev/tty` nicht öffnen kann. Der Befehl wurde angehalten, bevor er Änderungen vorgenommen hat:

```text theme={null}
Your organization's managed settings need your approval, which couldn't be asked for here. Run `claude` in a terminal and approve them, then run this command again.
```

**Was zu tun ist:**

* Führen Sie `claude` in einem Terminal aus und genehmigen Sie die Einstellungen, wenn der Dialog erscheint, und führen Sie dann denselben `claude plugin`-Befehl erneut aus. Claude Code speichert die Genehmigung und die genehmigten Einstellungen in Ihrem [Konfigurationsverzeichnis](https://code.claude.com/docs/de/server-managed-settings.md#approval-memory). Wenn der angehaltene Befehl als anderer Benutzer oder mit gesetztem `CLAUDE_CONFIG_DIR` ausgeführt wurde, führen Sie `claude` auf dieselbe Weise aus, damit beide dasselbe Verzeichnis verwenden.

### Verwaltete Einstellungen blockieren das Standardmodell

Die [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) Ihrer Organisation blockieren das Modell, zu dem die Standardoption aufgelöst wird, und jedes Modell, zu dem es herabgestuft werden könnte. Eine Sitzung, die auf der Standardoption starten würde, wird stattdessen beim Start beendet, anstatt ein blockiertes Modell auszuführen. Welche Meldung Sie sehen, hängt von der Einstellung ab, die es blockiert. Wenn eine [`deniedModels`](https://code.claude.com/docs/de/model-config#block-specific-models-or-versions)-Liste es blockiert, lautet die Meldung:

```text theme={null}
Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".
```

Wenn eine `availableModels`-Liste mit [`availableModelsMatch`](https://code.claude.com/docs/de/settings-reference#availablemodelsmatch) auf `"exact"` gesetzt es auslässt, lautet die Meldung:

```text theme={null}
Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".
```

**Was zu tun ist:**

* Wenn Sie die Einstellungen verwalten, fügen Sie ein Modell, das Ihre Benutzer ausführen können, zu `availableModels` hinzu, oder grenzen Sie die `deniedModels`-Einträge ein, die jeden Fallback blockieren. [Blockieren Sie bestimmte Modelle oder Versionen](https://code.claude.com/docs/de/model-config.md#block-specific-models-or-versions) beschreibt, wie die Standardoption herabgestuft wird
* Wenn Sie sie nicht verwalten, senden Sie die Meldung an Ihren Administrator. Ihre eigenen Einstellungsdateien können eine verwaltete `availableModels`- oder `deniedModels`-Liste nicht verbreitern

### Verwaltete Einstellungen erlauben diesen API-Anbieter nicht

Die [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) Ihrer Organisation setzen eine [`allowedProviders`](https://code.claude.com/docs/de/settings-reference#allowedproviders)-Liste, und der API-Anbieter der Sitzung ist nicht darauf oder die Sitzung verwendet einen Endpunkt, der nicht auf die Weise angeheftet ist, die dieser Eintrag erfordert. Claude Code weigert sich beim Start, vor einer Anmeldung oder wenn die Sitzung das nächste Mal die API kontaktiert. Die Meldung beginnt mit den zulässigen Anbietern:

```text theme={null}
Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.
```

Wenn die Liste leer ist, lautet die Meldung stattdessen:

```text theme={null}
Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.
```

Wenn jeder Eintrag nicht erkannt wird, lautet die Klammer stattdessen `(allowedProviders lists only unrecognized entries)`.

**Was zu tun ist:**

* Folgen Sie den `To continue:`-Schritten der Meldung
* Wenn Sie die Einstellungen verwalten, benennen die Zeilen der Meldung, die mit `Admins:` beginnen, den Eintrag zum Hinzufügen oder den Wert zum Anheften, und der [`allowedProviders`](https://code.claude.com/docs/de/settings-reference#allowedproviders)-Eintrag sagt, welcher Block `env` des Quellcodes es anheften kann

### MCP-Server wird durch Unternehmensrichtlinie blockiert

Sie haben **Reconnect** auf einem Server in `/mcp` ausgewählt oder einen deaktivierten Server dort wieder aktiviert, und eine Einstellung, die [MCP-Server einschränkt](https://code.claude.com/docs/de/managed-mcp.md), blockiert diesen Server. Claude Code weigert sich, ihn zu verbinden, und zeigt:

```text theme={null}
MCP server <name> is blocked by enterprise managed policy
```

Jede dieser Einstellungen kann die Meldung erzeugen:

* Ein [`deniedMcpServers`](https://code.claude.com/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists)-Eintrag, der dem Server entspricht, einschließlich eines in Ihrer eigenen `~/.claude/settings.json` oder der `.claude/settings.json` des Projekts
* Eine [`allowedMcpServers`](https://code.claude.com/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists)-Liste, der der Server nicht entspricht
* [`strictPluginOnlyCustomization`](https://code.claude.com/docs/de/settings-reference#strictpluginonlycustomization) mit `mcp` gesperrt, das Server blockiert, die in `~/.claude.json` und `.mcp.json` konfiguriert sind
* [`disableClaudeAiConnectors`](https://code.claude.com/docs/de/mcp#disable-claude-ai-connectors), wenn der Server ein claude.ai-Connector ist

**Was zu tun ist:**

* Überprüfen Sie Ihre eigenen Benutzer- und Projekteinstellungsdateien auf eine dieser Einstellungen und ändern oder entfernen Sie sie
* Wenn keine Ihrer eigenen Einstellungen die Blockade erklärt, fragen Sie Ihren Administrator, welche verwaltete Einstellung den Server blockiert

Vor v2.1.257 konnten **Reconnect** und Reaktivierung in `/mcp` einen Server verbinden, den eine Richtlinienaktualisierung während der Sitzung blockierte.

### MCP-Servername ist reserviert

Diese Meldung benennt einen Ihrer MCP-Server, dessen Name zu denen gehört, die Claude Code reserviert, z. B. die Namen seiner integrierten Server:

```text theme={null}
"workspace" is a reserved MCP server name and was not loaded
```

**Was zu tun ist:**

* Benennen Sie den Server dort um, wo Sie ihn definieren, z. B. von `workspace` in `my-workspace`
* Weitere reservierte Namen, die Sie vermeiden sollten, finden Sie unter [MCP-Konfigurationswarnungen](https://code.claude.com/docs/de/mcp.md#configuration-warnings)

### Verwaltetes Einstellungsdokument konnte nicht analysiert werden

Ihre Organisation stellt [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereit, und eines der bereitgestellten Dokumente ist vorhanden, kann aber nicht als JSON-Objekt analysiert werden, daher wird Claude Code beim Start mit Code 1 beendet, anstatt ohne die Richtlinie ausgeführt zu werden, die das Dokument trägt. Die Zeile benennt die fehlgeschlagene Quelle vor der Meldung:

```text theme={null}
/Library/Application Support/ClaudeCode/managed-settings.json: Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.
```

Die Quelle ist eine der folgenden:

* Der Pfad der `managed-settings.json`-Datei oder eine Drop-in-Datei unter `managed-settings.d`
* Das macOS-Verwaltungseinstellungsprofil, `per-user managed preferences` oder `device-level managed preferences`
* Der Windows-Registrierungswert, `Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings`

[Einträge suchen, die Claude Code gelöscht hat](https://code.claude.com/docs/de/managed-settings.md#find-entries-claude-code-dropped) listet auf, was jede Quelle nicht analysierbar macht.

Claude Code weigert sich zu starten, auch wenn eine andere Admin-Quelle eine gültige Richtlinie liefert. Sie sehen diesen Fehler in interaktiven Sitzungen, `claude -p`, Agent SDK-Sitzungen, [Hintergrundsitzungen](https://code.claude.com/docs/de/agent-view.md) und den meisten Unterbefehlen, einschließlich `claude doctor`. Die Weigerung schließt absichtlich: Einstellungen in einem Dokument, das Claude Code nicht analysieren kann, können nicht erzwungen werden, und das Starten würde Sitzungen ohne die Kontrollen der Organisation ausführen.

Ein Schemaproblem in einem analysierbaren Dokument erzeugt diesen Fehler nicht. [Einträge suchen, die Claude Code gelöscht hat](https://code.claude.com/docs/de/managed-settings.md#find-entries-claude-code-dropped) behandelt, was Claude Code damit tut.

Wenn ein `managed-settings.d/`-Verzeichnis vorhanden ist, aber nicht aufgelistet werden kann, meldet Claude Code `Managed settings drop-in directory could not be read:` gefolgt vom zugrunde liegenden Fehler statt. [Einträge suchen, die Claude Code gelöscht hat](https://code.claude.com/docs/de/managed-settings.md#find-entries-claude-code-dropped) behandelt, wann ein Lesefehler beim Start beendet wird.

**Was zu tun ist:**

* Wenn Sie den Computer verwalten, beheben Sie das benannte Dokument, damit es als JSON-Objekt analysiert wird, oder entfernen Sie die Datei, das Profil oder den Registrierungswert. Ein leeres `managed-settings.json` zählt als `{}` und blockiert den Start nicht.
* Wenn nicht, bitten Sie Ihren Administrator, das bereitgestellte Dokument zu beheben. Nichts in Ihren eigenen Einstellungsdateien verursacht oder löscht diesen Fehler.

### Verwaltete Einstellungen konnten nicht gelesen werden

Ihre Organisation stellt [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereit, und eine der bereitgestellten Quellen existiert, konnte aber nicht gelesen werden, aus einem Grund wie einem E/A-Fehler statt der Verweigerung durch das Betriebssystem. Ohne eine andere Admin-Quelle, die eine Richtlinie liefert, wird Claude Code beim Start beendet, anstatt ohne die Richtlinie ausgeführt zu werden, die die Quelle möglicherweise trägt:

```text theme={null}
Unable to read managed policy settings.
This machine may require organization login enforcement, but the policy file failed to load.
Contact your administrator.

Detail: <source>: <reason>
```

Im gleichen Zustand werden Anmeldungsflüsse, API-Anfragen aus einer bereits laufenden Sitzung und der [`claude gateway`](https://code.claude.com/docs/de/claude-apps-gateway)-Server mit einer Variante der ersten Zeile abgelehnt, die [`allowedProviders`](https://code.claude.com/docs/de/settings-reference#allowedproviders) benennt.

Ein Lesezugriff, den das Betriebssystem verweigert hat, z. B. auf eine Datei, die nur root gehört, erzeugt diesen Exit nicht: [die Sitzung startet ohne die Richtlinien dieser Quelle](https://code.claude.com/docs/de/managed-settings.md#find-entries-claude-code-dropped). Für eine Quelle, die nicht analysiert werden kann, wird Claude Code mit [einer anderen Meldung beendet, die die Quelle benennt](#managed-settings-document-could-not-be-parsed).

**Was zu tun ist:**

* Wenn Sie den Computer verwalten, beheben Sie das Problem, das die `Detail:`-Zeile benennt, damit die bereitgestellte Quelle gelesen werden kann, oder entfernen Sie die Quelle
* Wenn nicht, senden Sie die Meldung an Ihren Administrator. Nichts in Ihren eigenen Einstellungsdateien verursacht oder löscht diesen Fehler

Vor v2.1.285 wurden nur Sitzungen, die mit claude.ai- oder Claude Console-Anmeldedaten angemeldet waren, mit dieser Meldung beendet, und ein Lesezugriff, den das Betriebssystem verweigert hatte, erzeugte ihn auch.

### Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded

Dieser stderr-Block aus einem `-p`-Lauf bedeutet, dass eine Quelle [verwalteter Einstellungen](https://code.claude.com/docs/de/managed-settings.md) einen Hook-Eintrag enthält, den Claude Code nicht laden kann. Dieser Hook wird nicht ausgeführt, und wenn eine Zeile das `hooks`-Feld der Quelle als ignoriert aufführt, wird keiner der Hooks dieser Quelle ausgeführt.

Jede Zeile benennt die Quelle, das Feld, sofern vorhanden, und das Problem, z. B. einen unbekannten Hook-`type` oder einen Hook, der außerhalb des `hooks`-Schlüssels deklariert ist:

```text theme={null}
Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded; fix or remove each entry:
  <source> (<field>): <message>
```

**Was zu tun ist:**

* Wenn Sie die Quelle verwalten, beheben oder entfernen Sie jeden Eintrag, den der Block auflistet. [Hook-Konfiguration](https://code.claude.com/docs/de/hooks.md#configuration) zeigt die Struktur, die Claude Code unter `hooks` erwartet.
* Wenn die Quelle einer Zeile `parent managed settings` lautet, hat die Anwendung, die Claude Code gestartet hat, diesen Eintrag als [übergeordnete Einstellungen](https://code.claude.com/docs/de/managed-settings.md#parent-settings-from-embedding-hosts) übergeben; melden Sie ihn daher dem Entwickler dieser Anwendung
* Andernfalls senden Sie den Block an Ihren Administrator

Vor v2.1.300 führte ein `-p`-Lauf diesen Fall unter der Überschrift `Managed settings failed to load; policies from the failed source are NOT in effect:` auf.

### otelHeadersHelper fehlgeschlagen

Claude Code zeigt diese Warnung als Benachrichtigung in der Terminalschnittstelle an, einmal pro interaktiver Sitzung, wenn das [`otelHeadersHelper`](https://code.claude.com/docs/de/settings-reference#otelheadershelper)-Skript fehlschlägt oder eine Ausgabe druckt, die nicht den [Skriptanforderungen](https://code.claude.com/docs/de/monitoring-usage.md#script-requirements) entspricht.

Während das Skript weiterhin fehlschlägt, schlagen Exporte fehl und Ihr Telemetrie-Backend empfängt nichts aus der Sitzung.

Der Text nach `See /status:` sagt, was fehlgeschlagen ist, z. B. der Exit-Code des Skripts gefolgt von seiner Fehlerausgabe:

```text theme={null}
otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable
```

**Was zu tun ist:**

* Führen Sie `/status` aus, um das Fehlerdetail zu lesen.
* Beheben Sie das Skript, damit es mit 0 beendet wird, innerhalb von 30 Sekunden, und drucken Sie ein JSON-Objekt von String-Header-Werten auf stdout. Siehe [Skriptanforderungen](https://code.claude.com/docs/de/monitoring-usage.md#script-requirements).
* Wenn Ihre Organisation das Skript durch [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereitstellt, bitten Sie denjenigen, der sie verwaltet, es zu beheben.

Im [nicht-interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit `-p` erscheint der gleiche Fehler auf stderr statt als `otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error>`.

### headersHelper nicht ausgeführt

Claude Code verbundene einen MCP-Server nur mit seinen statischen `headers` und übersprung den [`headersHelper`](https://code.claude.com/docs/de/mcp#use-dynamic-headers-for-custom-authentication) des Servers, weil der Helper ein Shell-Befehl ist und der Ordner kein gespeichertes Vertrauen hat. Ein Ordner erhält gespeichertes Vertrauen, wenn Sie seinen Eintrag in `~/.claude.json` von Hand setzen oder, außerhalb Ihres Home-Verzeichnisses, wenn Sie den Vertrauensdialog dafür in einer interaktiven Sitzung akzeptieren. Siehe [Vertrauen Sie einem Ordner, bevor sein headersHelper ausgeführt wird](https://code.claude.com/docs/de/mcp.md#trust-a-folder-before-its-headershelper-runs), für welche Server diese Überprüfung gilt.

Claude Code schreibt diese Zeile nur im [nicht-interaktiven Modus](https://code.claude.com/docs/de/headless.md), einmal pro Server. In einer interaktiven Sitzung schreibt es stattdessen die gleiche Weigerung in das Debug-Protokoll.

```text theme={null}
MCP server 'internal-api': headersHelper not run — this workspace has no persisted trust; accept the trust dialog here once interactively, or set projects["/Users/you/project"].hasTrustDialogAccepted in /Users/you/.claude.json.
```

Der `projects`-Schlüssel, den die Meldung ausgibt, ist der Ordner, auf den [Projekterlaubnisregeln und Arbeitsbereichsvertrauen](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust) sagt, dass Claude Code das Vertrauen basiert. Das Akzeptieren des Vertrauensdialogs für einen übergeordneten Ordner erfüllt die Überprüfung nicht, und eine `-p`- oder SDK-Sitzung erfüllt sie auch nicht.

**Was zu tun ist:**

* Führen Sie `claude` im Ordner aus, den die Meldung benennt, akzeptieren Sie den Vertrauensdialog, führen Sie dann Ihren `-p`- oder SDK-Befehl erneut aus
* Legen Sie den `hasTrustDialogAccepted`-Eintrag in `~/.claude.json` selbst fest, mit dem genauen `projects`-Schlüssel, den die Meldung ausgibt
* Wenn Sie die Sitzung in Ihrem Home-Verzeichnis gestartet haben, arbeiten Sie aus einem Projektverzeichnis, dem Sie vertraut haben. Wenn Sie den Vertrauensdialog in Ihrem Home-Verzeichnis akzeptieren, behält Claude Code dieses Vertrauen nur für die aktuelle Sitzung.

### Malformed Tool(content) rule

Eine [Berechtigungsregel](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax) in einer Ihrer Einstellungsdateien hat nicht die Form `Tool` oder `Tool(content)`, z. B. weil Text nach der schließenden Klammer folgt oder eine der Klammern fehlt. Claude Code überspringt die Regel und listet sie im Dialog für ungültige Einstellungen auf, wenn eine interaktive Sitzung startet, und in der Ausgabe von [`claude doctor`](https://code.claude.com/docs/de/debug-your-config#check-resolved-settings):

```text theme={null}
Invalid permission rule "Bash(ls) x" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal
```

**Was zu tun ist:**

* Schreiben Sie in der mit der Meldung aufgelisteten Einstellungsdatei die Regel so um, dass sie bei ihrer schließenden Klammer endet, z. B. `Bash(ls *)` statt `Bash(ls) x`
* Lassen Sie Klammern im Inhalt wie sie sind. Sie sind literal, daher ist eine Regel wie `Edit(./Finance (2024)/**)` gültig ohne Escaping

Vor v2.1.260 meldete Claude Code eine Regel mit nicht übereinstimmenden Klammern als `Mismatched parentheses`.

### Matches no tool · check for typos

Diese Zeile unterhalb des Startbanners benennt eine deny- oder ask-[Berechtigungsregel](https://code.claude.com/docs/de/permissions.md), deren Tool-Namen Claude Code nicht erkennt, sodass die Regel nicht für das gemeinte Tool gilt. Eine als `Bsh` geschriebene deny-Regel wird nicht auf Bash angewendet, und ebenso wenig eine, die die Bezeichnung verwendet, die ein Tool im Transkript anzeigt, statt seines kanonischen Namens. Die Zeile gibt die Regel so wieder, wie Sie sie geschrieben haben:

```text theme={null}
⚠ Deny rule Bsh matches no tool · check for typos
```

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit Textausgabe gibt Claude Code die Warnung stattdessen in ihrer längeren Form auf stderr aus:

```text theme={null}
Permission deny rule "Bsh" matches no known tool — check for typos.
```

**Was zu tun ist:**

* Korrigieren Sie den Tool-Namen in der Regel, z. B. `Bash` statt `Bsh`. Kanonische Namen finden Sie in der [Tool-Referenz](https://code.claude.com/docs/de/tools-reference.md).
* Um herauszufinden, wo die Regel definiert ist, führen Sie `/permissions` in der Sitzung aus und wählen Sie die Regel aus. Ihre Details geben an, woher sie stammt, z. B. `From project local settings` oder `From CLI argument` für einen `--disallowedTools`-Wert.
* Wenn die Details `From enterprise managed settings` lauten, leiten Sie die Zeile an denjenigen weiter, der Ihre [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) verwaltet, da Sie diese Regel nicht selbst ändern können.

In einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Log. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen.

Vor v2.1.305 gab eine interaktive Sitzung beim Start die längere Form auf stderr aus, statt die Zeile anzuzeigen.

### Wird nicht durch Dateiberechtigungsprüfungen abgeglichen

Claude Code fand eine `Write`-, `NotebookEdit`-, `MultiEdit`- oder `Glob`-[Berechtigungsregel](https://code.claude.com/docs/de/permissions.md#read-and-edit) mit einem Pfad in einer Ihrer [Einstellungsdateien](https://code.claude.com/docs/de/settings.md#where-settings-live), in [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) oder in einem `--allowedTools`-, `--disallowedTools`- oder `--settings`-Flagwert. Es prüft Dateiberechtigungen nur anhand von `Edit`- und `Read`-Regeln, daher zieht es nie eine Pfadregel heran, die eines der anderen Datei-Tools benennt. Es behält die Regel bei und ändert nichts anderes.

* **Interaktive Sitzung**: Die vollständige Warnung wird in das [Debug-Log](#configuration-warnings) geschrieben, und eine deny- oder ask-Regel dieser Form erscheint zusätzlich als diese Zeile unterhalb des Startbanners:

  ```text theme={null}
  ⚠ Deny rule Write(docs/**) never matches · use Edit(docs/**)
  ```

  Eine allow-Regel dieser Form erhält keine Zeile. Um herauszufinden, wo die Regel definiert ist, führen Sie `/permissions` in der Sitzung aus und wählen Sie die Regel aus.
* **[Nicht interaktiver Modus](https://code.claude.com/docs/de/headless.md) mit Textausgabe**: Die vollständige Warnung auf stderr benennt die Regel, ihre Quelle in Klammern und den zu schreibenden Ersatz:

  ```text theme={null}
  Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).
  ```
* **[Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) oder `--output-format json` bzw. `stream-json`**: Die vollständige Warnung wird statt auf stderr in das Debug-Log geschrieben, damit die maschinenlesbare Ausgabe sauber bleibt. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen.

**Was zu tun ist:**

* Ersetzen Sie `Write(path)`-, `NotebookEdit(path)`- und Legacy-`MultiEdit(path)`-Regeln durch `Edit(path)`. `Edit`-Regeln decken alle Dateieditierungswerkzeuge ab.
* Außer in `--allowedTools`, wo Claude Code eine `Glob`-Regel ohne Warnung akzeptiert, ersetzen Sie `Glob(path)`-Regeln durch `Read(path)`.
* Korrigieren Sie die Regel an ihrer Quelle, die die vollständige Warnung in Klammern benennt: ein Einstellungsdateipfad oder das Flag selbst bei `--allowed-tools` und `--disallowed-tools`. Ein `claude-settings-<hash>.json`-Pfad, der auf der Festplatte nicht existiert, steht für einen Inline-`--settings`-Wert. Korrigieren Sie das JSON, das Sie an dieses Flag übergeben.
* Lassen Sie bloße Werkzeugnamen-Regeln wie `Write` oder `Glob` allein. Claude Code gleicht sie auf der [Werkzeugebene](https://code.claude.com/docs/de/permissions.md#match-all-uses-of-a-tool) ab und warnt nicht davor.
* Bei einer Regel aus verwalteten Einstellungen lauten die Klammern der vollständigen Warnung `managed policy settings`, und die Details der Regel in `/permissions` lauten `From enterprise managed settings`. Leiten Sie diese Warnung an denjenigen weiter, der Ihre verwalteten Einstellungen verwaltet, da Sie sie nicht selbst beheben können.

Vor v2.1.210 akzeptierte Claude Code diese Regeln ohne Warnung. Vor v2.1.305 gab eine interaktive Sitzung die vollständige Warnung auf stderr aus.

### Hat einen Platzhalter vor dem Rest des Befehls

Claude Code fand eine `Bash`-Allow-Regel, deren `*` vor einem späteren Wort kommt, das bestimmt, welcher Befehl es ist, z. B. `Bash(git * main)` oder `Bash(git -C * status *)`, in einer Ihrer [Einstellungsdateien](https://code.claude.com/docs/de/settings.md#where-settings-live), in [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) oder in einem `--allowedTools`- oder `--settings`-Flagwert. Der `*` gleicht jeden Text ab, einschließlich Optionen, die an dieser Position eingefügt werden: `Bash(git * main)` genehmigt auch `git -c core.fsmonitor=<script> diff main`, wobei `-c` git veranlasst, ein Programm auszuführen, das der Befehl benennt. [Wildcard-Muster](https://code.claude.com/docs/de/permissions.md#wildcard-patterns) zeigt die Abgleichsregeln.

Die Warnung existiert, damit Sie eine Regel eingrenzen können, deren Wildcard breiter ist als beabsichtigt. Claude Code behält die Regel bei und ändert nichts daran, wie sie abgleicht. Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit Textausgabe benennt die Warnung auf stderr die Regel und ihre Quelle in Klammern:

```text theme={null}
Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).
```

In einer interaktiven Sitzung wird die vollständige Warnung in das [Debug-Log](#configuration-warnings) geschrieben, und die Regel erscheint als diese Zeile unterhalb des Startbanners:

```text theme={null}
⚠ Allow rule Bash(git -C * status *) allows any option at its * · use an exact value
```

Um herauszufinden, wo die Regel definiert ist, führen Sie `/permissions` in der Sitzung aus und wählen Sie die Regel aus.

**Was zu tun ist:**

* Ersetzen Sie den `*` vor dem Unterbefehl durch den genauen Wert, den Sie meinen: `Bash(git checkout main)` statt `Bash(git * main)`.
* Verschieben Sie jeden `*` nach dem Unterbefehl: `Bash(git status *)` statt `Bash(git -C * status *)`. Schreiben Sie eine Regel pro Unterbefehl, den Sie zulassen möchten.
* Korrigieren Sie die Regel an ihrer Quelle, die die vollständige Warnung in Klammern benennt: ein Einstellungsdateipfad oder das `--allowed-tools`-Flag selbst. Ein `claude-settings-<hash>.json`-Pfad, der auf der Festplatte nicht existiert, steht für einen Inline-`--settings`-Wert. Korrigieren Sie das JSON, das Sie an dieses Flag übergeben.
* Bei einer Regel aus verwalteten Einstellungen lauten die Klammern der vollständigen Warnung `managed policy settings`, und die Details der Regel in `/permissions` lauten `From enterprise managed settings`. Leiten Sie diese Warnung an denjenigen weiter, der Ihre verwalteten Einstellungen verwaltet, da Sie sie nicht selbst beheben können.

In einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Protokoll, damit die maschinenlesbare Ausgabe sauber bleibt. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.246 akzeptierte Claude Code diese Regeln ohne Warnung.

Vor v2.1.305 gab eine interaktive Sitzung die vollständige Warnung auf stderr aus, statt eine Zeile anzuzeigen.

### Denying Bash also turns off the PowerShell tool

Sie haben das gesamte Bash-Tool entfernt, z. B. mit `--disallowedTools Bash` oder mit einer reinen `Bash`- oder `Bash(*)`-[deny-Regel](https://code.claude.com/docs/de/permissions.md#match-all-uses-of-a-tool) in einer Ihrer Einstellungsdateien. Unter Windows mit installiertem Git Bash [schaltet das Verweigern von Bash auch das PowerShell-Tool aus](https://code.claude.com/docs/de/tools-reference.md#bash-deny-rules-also-turn-off-the-powershell-tool), sodass die Sitzung ohne Shell-Tool startet.

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit Textausgabe gibt Claude Code diese Warnung beim Start auf stderr aus, und eine interaktive Sitzung schreibt sie nur in das [Debug-Log](#configuration-warnings):

```text theme={null}
Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.
```

**Was zu tun ist:**

* Damit Claude PowerShell verwendet, setzen Sie [`CLAUDE_CODE_USE_POWERSHELL_TOOL`](https://code.claude.com/docs/de/env-vars) in Ihrer Umgebung oder im `env`-Block einer Einstellungsdatei auf `1`, wie [Das PowerShell-Tool aktivieren](https://code.claude.com/docs/de/tools-reference.md#enable-the-powershell-tool) zeigt. Das PowerShell-Tool bleibt dann neben Ihrer Bash-deny-Regel eingeschaltet.
* Um bestimmte Befehle statt des gesamten Tools zu blockieren, ersetzen Sie den bloßen `Bash`-Eintrag in derselben Einstellungsdatei oder demselben Flag durch eingegrenzte Regeln wie `Bash(git push *)`. Claude behält das Bash-Tool, und das PowerShell-Tool bleibt ausgeschaltet, bis Sie zusätzlich die Variable setzen oder eine eingegrenzte [`PowerShell`-Berechtigungsregel](https://code.claude.com/docs/de/permissions#powershell) hinzufügen.

In einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Log. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.287 schaltete Claude Code das PowerShell-Tool auf dieselbe Weise aus, ohne eine Warnung auszugeben.

Vor v2.1.305 gab auch eine interaktive Sitzung die Warnung beim Start auf stderr aus.

### crossSessionInbound muss eines von accept, hold, refuse sein

Eine Einstellungsdatei setzt [`crossSessionInbound`](https://code.claude.com/docs/de/settings-reference#crosssessioninbound) auf einen Wert, den Claude Code nicht erkennt, z. B. den Tippfehler `"reject"`. Der zweite Satz der Warnung hängt davon ab, welche Datei den Wert hält; in einer Benutzer-, Projekt-, lokalen oder `--settings`-Datei liest er:

```text theme={null}
"crossSessionInbound" must be one of "accept", "hold", "refuse"; received "reject". This value was ignored; while it is present, cross-session messages are held for your approval instead of being delivered. Set it to one of the values above.
```

In [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) behandelt Claude Code den nicht erkannten Wert als `refuse`, den restriktivsten Wert, und die Warnung sagt, dass Sitzungsübergreifende Meldungen abgelehnt werden, bis ein Administrator es behebt. Wie die Hold mit Werten in Ihren anderen Einstellungsdateien kombiniert wird, siehe [`crossSessionInbound`](https://code.claude.com/docs/de/settings-reference#crosssessioninbound).

**Was zu tun ist:**

* Setzen Sie den Schlüssel auf `"accept"`, `"hold"` oder `"refuse"`, oder entfernen Sie ihn
* Wenn die Warnung verwaltete Einstellungen benennt, bitten Sie den Administrator, den Wert zu beheben

Vor v2.1.248 ignorierte Claude Code einen nicht erkannten Wert ohne Warnung.

### ANTHROPIC\_FOUNDRY\_RESOURCE muss ein Foundry-Ressourcenname sein

Sie haben [`ANTHROPIC_FOUNDRY_RESOURCE`](https://code.claude.com/docs/de/env-vars) auf etwas anderes als einen reinen [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md)-Ressourcennamen gesetzt, z. B. auf die Endpunkt-URL oder deren Hostnamen. Claude Code hat den Wert abgelehnt, bevor eine Anfrage gesendet wurde. Die Meldung erscheint anstelle von Claudes Antwort, nicht als Startwarnung:

```text theme={null}
API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name (2-64 letters, digits and hyphens, not starting or ending with a hyphen, such as my-resource), not a URL or host name. To use a full URL, set ANTHROPIC_FOUNDRY_BASE_URL instead.
```

**Was zu tun ist:**

* Setzen Sie `ANTHROPIC_FOUNDRY_RESOURCE` nur auf den Ressourcennamen und starten Sie Claude Code neu. Für den Endpunkt `https://my-resource.services.ai.azure.com/anthropic` lautet der Name `my-resource`.
* Um stattdessen die vollständige Endpunkt-URL anzugeben, setzen Sie [`ANTHROPIC_FOUNDRY_BASE_URL`](https://code.claude.com/docs/de/env-vars) auf die URL, entfernen Sie `ANTHROPIC_FOUNDRY_RESOURCE` und starten Sie Claude Code dann neu. Claude Code akzeptiert nur eine der beiden Variablen.

### Das 200K-Limit wird nicht erzwungen

Sie setzen [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/de/env-vars), das normalerweise [Auto-Komprimierung](https://code.claude.com/docs/de/model-config.md#default-auto-compact-thresholds) dazu bringt, Sitzungen auf 1M-Kontext-Modellen auf ein 200K-Fenster zu halten, aber kein Komprimierungsschwellenwert begrenzt diese Sitzung auf oder unter 200K, daher kann die Konversation über sie hinauswachsen.

```text theme={null}
CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it. To enforce it, set CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 (or the autoCompactWindow setting).
```

Claude Code erzwingt das 200K-Limit auf eigene Faust für jedes Modell, das es als ein Modell mit nativem 1M-Fenster erkennt, und für Modell-IDs, die es nicht erkennt, komprimiert es im Fenster, das es annimmt. Die Warnung erscheint, wenn andere Konfiguration diese Erzwingung besiegt:

* Die Modell-ID ist nicht eine, die Claude Code erkennt, z. B. ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway)-Alias, und Sie setzen [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](https://code.claude.com/docs/de/env-vars) oder erhöhten das angenommene Fenster über 200K mit [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/de/env-vars). In diesem Fall bietet die Meldung auch `or update to a Claude Code version that recognizes <model>` als Abhilfe an.
* Ein `context-1m`-Beta, das durch [`ANTHROPIC_BETAS`](https://code.claude.com/docs/de/env-vars) oder das [`--betas`](https://code.claude.com/docs/de/cli-reference#cli-flags)-Flag angefordert wird, fragt die API immer noch nach dem 1M-Fenster auf einem Modell an, das dieses Beta akzeptiert, während nichts die Sitzung bei 200K komprimiert

**Was zu tun ist:**

* Setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/de/env-vars), oder die [`autoCompactWindow`](https://code.claude.com/docs/de/settings-reference#autocompactwindow)-Einstellung auf `200000`, damit Auto-Komprimierung bei der 200K-Grenze komprimiert
* Wenn die Meldung eine Modell-ID benennt, die diese Version nicht erkennt, führen Sie `claude update` aus. Eine Version, die die ID als 1M-Kontext-Modell erkennt, erzwingt das Limit ohne weitere Konfiguration.
* Wenn Sie möchten, dass die Sitzung das vollständige Fenster des Modells verwendet, heben Sie `CLAUDE_CODE_DISABLE_1M_CONTEXT` auf; die Warnung meldet nur, dass das 200K-Limit nicht erzwungen wird

Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit Textausgabe erscheint diese Warnung auf stderr. In einer interaktiven Sitzung, einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) oder mit `--output-format json` oder `stream-json` wird sie stattdessen in das Debug-Log geschrieben. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen.

Vor v2.1.305 gab eine interaktive Sitzung die Warnung beim Start auf stderr aus.

### Nicht erkannte Modell-ID bei einer Anfrage

Claude Code sendete eine Anfrage für eine Modell-ID, die Ihre Claude Code-Version nicht erkennt, und fand keinen [`modelOverrides`](https://code.claude.com/docs/de/model-config#override-model-ids-per-version)-Eintrag, der diese ID einem Modell zuordnet, das es erkennt. Claude Code sendet die Anfrage immer noch mit der ID, wie Sie sie konfiguriert haben, und beendet sich nicht oder wechselt Modelle.

```text theme={null}
[claude-code:unrecognized_model] {"model":"my-proxy-model","query_source":"sdk"}
```

In einem Skript oder einer Harness, die stderr liest, gleichen Sie das Präfix `[claude-code:unrecognized_model]` ab. Nach dem Präfix und einem Leerzeichen schreibt Claude Code ein einzeiliges JSON-Objekt. Claude Code kann in einer späteren Version Felder hinzufügen, daher ignorieren Sie alle Felder, die Sie nicht erwarten. Es schreibt mindestens diese zwei:

* `model`: die Modellzeichenkette, wie Sie sie konfiguriert haben
* `query_source`: der Anfragepfad, der das Modell verwendet hat. Beispielsweise lautet der Wert `sdk` für die Hauptkonversation eines `-p`-Laufs und beginnt bei einem Subagenten mit `agent:`.

Claude Code schreibt die Zeile an einen von zwei Orten, je nachdem, wie Sie es ausführen:

* Im [nicht-interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit `-p` schreibt Claude Code es unter jedem `--output-format` auf stderr, daher können Sie stdout analysieren, ohne die Zeile herauszufiltern
* In einer interaktiven Sitzung oder einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) schreibt Claude Code es stattdessen in das Debug-Protokoll; führen Sie mit `--debug` aus, um es unter `~/.claude/debug/<session-id>.txt` zu erfassen

Claude Code schreibt die Zeile einmal pro Modell-ID pro Prozess. Es schreibt eine separate Zeile für jede weitere nicht erkannte ID, z. B. eine, die ein [Subagent](https://code.claude.com/docs/de/sub-agents.md#choose-a-model) oder eine [Hintergrundfunktionalität](https://code.claude.com/docs/de/model-config.md#environment-variables) verwendet.

Claude Code schreibt die Zeile nicht für Provider-IDs, die es zu einem Modell auflöst, das es erkennt, z. B. Amazon Bedrock `us.anthropic.claude-...`-IDs, Google Cloud's Agent Platform-IDs mit einem `@`-Versionssuffix und Microsoft Foundry-Bereitstellungsnamen, die eine Claude-Modell-ID enthalten. Claude Code überprüft das Modell hinter einem Amazon Bedrock-[Anwendungs-Inferenzprofil-ARN](https://code.claude.com/docs/de/amazon-bedrock.md#map-each-model-version-to-an-inference-profile) statt des ARN selbst. Es schreibt keine Zeile für einen ARN, den es nicht auflösen kann, z. B. einen falsch geschriebenen.

**Was zu tun ist:**

* Wenn Sie die ID absichtlich setzen, z. B. einen [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway)-Alias, fügen Sie einen [`modelOverrides`](https://code.claude.com/docs/de/model-config#override-model-ids-per-version)-Eintrag zu Ihrer [Einstellungsdatei](https://code.claude.com/docs/de/settings.md#where-settings-live) mit der ID als Wert hinzu. Verwenden Sie eine Anthropic-Modell-ID als Schlüssel, nicht einen Familien-Alias wie `opus`. Für `my-proxy-model` aus der Beispielzeile fügen Sie diesen Eintrag hinzu:

  ```json theme={null}
  {
    "modelOverrides": {
      "claude-opus-4-6": "my-proxy-model"
    }
  }
  ```

  Claude Code behandelt dann `my-proxy-model` als `claude-opus-4-6` und stoppt das Schreiben der Zeile.

* Wenn die ID ein Modell benennt, das neuer als Ihre Claude Code-Version ist, führen Sie `claude update` aus

* Wenn die ID ein Tippfehler ist, beheben Sie sie in welchem der [Orte, an denen Sie ein Modell setzen können](https://code.claude.com/docs/de/model-config.md#setting-your-model) oder [Alias-Variablen](https://code.claude.com/docs/de/model-config.md#environment-variables) es hält. Wenn `query_source` mit `agent:` beginnt, beheben Sie es stattdessen dort, wo Sie das [Modell des Subagenten](https://code.claude.com/docs/de/sub-agents.md#choose-a-model) setzen.

Vor v2.1.233 schrieb Claude Code keine Zeile, wenn es eine Anfrage für eine Modell-ID sendete, die es nicht erkannte.

### Sandbox-Allow-Einträge werden unter einer verwalteten Sperre ignoriert

Diese Warnung in `/status` und `claude doctor` bedeutet, dass verwaltete Einstellungen [`allowManagedReadPathsOnly`](https://code.claude.com/docs/de/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) oder [`allowManagedDomainsOnly`](https://code.claude.com/docs/de/settings-reference#sandbox-network-allowmanageddomainsonly) setzen, sodass die [`allowRead`](https://code.claude.com/docs/de/settings-reference#sandbox-filesystem-allowread)- oder [`allowedDomains`](https://code.claude.com/docs/de/settings-reference#sandbox-network-alloweddomains)-Einträge in der genannten Datei nicht gelten:

```text wrap theme={null}
sandbox.filesystem.allowRead is ignored — managed settings set allowManagedReadPathsOnly, so only allowRead paths from managed settings are honored. The 3 entries in /home/you/.claude/settings.json will NOT apply (see https://code.claude.com/docs/en/settings#sandbox-settings).
```

Für die Netzwerksperre benennt die Warnung `sandbox.network.allowedDomains` und `allowManagedDomainsOnly` und sagt `only allowed domains (and WebFetch domain rules) from managed settings are honored`.

**Was zu tun ist:**

* Sie müssen auf die Warnung nicht reagieren
* Wenn Sie diese Pfade oder Domains benötigen und die verwalteten Einstellungen Ihrer Organisation die Sperre setzen, bitten Sie Ihren Administrator, sie zu diesen Einstellungen hinzuzufügen. Die Warnung bleibt bestehen, bis Sie außerdem die Einträge aus der genannten Datei entfernen.
* Um die Warnung zu beseitigen, entfernen Sie die Einträge aus der genannten Datei. Bei einer Datei, die Sie teilen, z. B. der `.claude/settings.json` eines Projekts, können Sie die Einträge für Teammitglieder ohne die Sperre belassen und die Warnung weiterhin angezeigt lassen.

### Sandbox mask files left behind at write-deny paths

Diese Warnung in `claude doctor` und `/status` listet Maskierungsdateien auf: schreibgeschützte 0-Byte-Platzhalterdateien an Pfaden, für die die [Sandbox](https://code.claude.com/docs/de/sandboxing.md) Schreibzugriffe verweigert. Sie erscheint unter Linux und WSL2, wenn Sandboxing mit aktivierter Dateisystem-Isolation eingeschaltet ist. Löschen Sie diese Dateien aus Ihrer Shell, sobald in dem Projekt, das sie enthält, keine Claude Code-Sitzung mehr geöffnet ist.

Die Sandbox erstellt einen Platzhalter, während ein in der Sandbox ausgeführter Befehl läuft, und entfernt ihn, wenn der Befehl endet. In Fällen wie diesen bleibt einer zurück:

* Die Sitzung wird zwangsweise beendet, bevor der Befehl endet, z. B. durch SIGKILL
* Sie beenden die Sitzung, während ein in der Sandbox ausgeführter Befehl noch läuft, z. B. einer im Hintergrund

In `claude doctor` lautet die Warnung:

```text theme={null}
- Sandbox mask files left behind at write-deny paths: /home/you/project/.claude/settings.local.json
  Fix: A session leaves one where it was killed, or where it exited while a sandboxed command was still running. Remove each with `rm <path>` while no other Claude Code session is running in that project — a 0-byte read-only file where a settings file belongs makes "Yes, and don't ask again" fail to save, and the sandbox binds it read-only again on every start
```

**Was zu tun ist:**

* Beenden Sie jede Claude Code-Sitzung, die in dem Projekt mit den aufgelisteten Dateien geöffnet ist, einschließlich der Sitzung, in der `/status` die Warnung angezeigt hat, und arbeiten Sie dann in Ihrer Shell. Ein Platzhalter, den die Sandbox einer anderen Sitzung noch verwendet, ist ein aktiver Teil des Schreibschutzes dieser Sitzung
* Löschen Sie in Ihrer Shell jede aufgelistete Datei mit `rm` und bestätigen Sie, wenn `rm` nach einer schreibgeschützten Datei fragt. Die Warnung nennt bis zu drei Dateien und zählt den Rest, führen Sie daher `claude doctor` nach dem Löschen erneut aus, bis die Warnung nicht mehr erscheint
* Wenn eine Berechtigungswahl, die Sie mit „Ja, und nicht mehr fragen“ gespeichert haben, nicht haften blieb, speichern Sie sie erneut, nachdem Sie den Platzhalter gelöscht haben

Vor v2.1.309 lautete die Warnung `Stale sandbox mask files left by a killed session`.

Vor v2.1.257 kennzeichnete `claude doctor` diese Dateien nicht; frühere Versionen hinterlassen die gleichen Platzhalter, wenn eine Sitzung zwangsweise beendet wird.

### Two Claude Code config files exist

Claude Code verwendet die erste Datei, die diese Meldung nennt, daher ist der Inhalt der zweiten Datei nicht wirksam. Die erste ist `.config.json`, ein älterer Name für [`.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json). Die Meldung enthält eine Prüfung, mit der Sie feststellen können, welche Datei Ihre Konfiguration enthält:

```text wrap theme={null}
Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.
```

Unter Windows ersetzt `The one with hasCompletedOnboarding or mcpServers in it is usually yours.` den Satz mit dem `grep`-Befehl.

**Was zu tun ist:**

**1. Die Datei mit Ihrer Konfiguration finden**

* **Unter Windows**: Öffnen Sie beide Dateien und prüfen Sie, welche `hasCompletedOnboarding` oder `mcpServers` enthält
* **Auf anderen Plattformen**: Führen Sie in Ihrer Shell den `grep`-Befehl aus der Meldung aus und prüfen Sie, welche Datei die höhere Anzahl hat

**2. Jeden Host aktualisieren, der das Home-Verzeichnis teilt**

Wenn mehrere Hosts dieses Home-Verzeichnis teilen, aktualisieren Sie Claude Code zuerst auf jedem Host auf die in der Meldung genannte Version oder höher.

**3. Claude Code beenden**

Beenden Sie Ihre Claude Code-Prozesse auf jedem Host.

**4. Die nicht gewünschte Datei verschieben**

Verschieben Sie die Datei, die Sie nicht möchten, aus ihrem Ordner. Verschieben Sie sie, statt sie zu löschen, damit Sie sie wiederherstellen können.

**5. Warten, bevor Sie Claude Code erneut starten**

Starten Sie Claude Code auf keinem Host, bis kein Host die verschobene Datei mehr unter ihrem alten Pfad auflistet.

Die Meldung verschwindet, sobald eine der beiden Dateien nicht mehr vorhanden ist.

### Make this change again later: \~/.claude.json could not be updated

Dieser Hinweis auf stderr bedeutet, dass eine Änderung an [`~/.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json), z. B. eine Anmeldung oder eine Antwort auf eine Vertrauensabfrage, nicht in der Datei gespeichert wurde:

```text theme={null}
Make this change again later: /home/user/.claude.json could not be updated, so it applies to this session only.
```

**Was zu tun ist:**

* Nehmen Sie die Änderung in einer späteren Sitzung erneut vor. Führen Sie zum Beispiel `/login` erneut aus oder beantworten Sie die Vertrauensabfrage erneut.

## 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 diesen Fällen zu einem Fallback-Modell wechseln:

* Ein konfiguriertes [`--fallback-model`](https://code.claude.com/docs/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript
* Eine Verfügbarkeitsprüfung von Amazon Bedrock oder Google Cloud's Agent Platform stellt fest, dass Ihr Standardmodell nicht verfügbar ist, oder Ihr Konto [verliert während einer Sitzung den Zugriff darauf](https://code.claude.com/docs/de/amazon-bedrock.md#when-a-model-is-disabled-mid-session)
* [Automatisches Modell-Fallback](https://code.claude.com/docs/de/model-config.md#automatic-model-fallback) bei Fable-Modellen, Opus 5.5, Sonnet 5.5 und Opus 5 verschiebt die Sitzung zum Fallback-Modell der gekennzeichneten Kategorie, wenn diese Kategorie über eines verfügt. Eine Notiz erscheint im Transkript

Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md) erklärt, wann jedes Fallback angewendet wird.

Überprüfen Sie diese zuerst:

* **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.
* **Aufwandsstufe**: 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 [Aufwandsstufe anpassen](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) 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](https://code.claude.com/docs/de/context-window.md), 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. 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.

Wenn eine Antwort schiefgeht, funktioniert das Zurückspulen normalerweise besser als das Antworten mit Korrektionen. Drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um vor den 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ätere Antworten daran verankern kann. Siehe [Checkpointing](https://code.claude.com/docs/de/checkpointing.md).

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](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.

Wenn 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. Vor v2.1.201 lehnten Sonnet 5 einige Anfragen auf die gleiche Weise ab.

## Fehler melden

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

* MCP-Server konnte sich nicht verbinden oder authentifizieren: [MCP](https://code.claude.com/docs/de/mcp.md)
* Hook-Skript ist fehlgeschlagen oder hat ein Tool blockiert: [Debug-Hooks](https://code.claude.com/docs/de/hooks.md#debug-hooks)
* Berechtigung verweigert oder Dateisystemfehler während der Installation: [Troubleshoot-Installation und -Anmeldung](https://code.claude.com/docs/de/troubleshoot-install.md)

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. Das Senden an Anthropic erfordert [Authentifizierung](https://code.claude.com/docs/de/authentication.md). 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.
* Wenn `/feedback` meldet, dass der Befehl durch die Richtlinie Ihrer Organisation deaktiviert ist, siehe [den Eintrag zu dieser Meldung](#feedback-is-disabled-by-your-organizations-policy)
* 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](https://status.claude.com) auf aktive Vorfälle
* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub
