Documentation — Spybara

amazon-bedrock.md +8 −3

Details

349 349

350### Wenn ein Modell während der Sitzung deaktiviert wird350### Wenn ein Modell während der Sitzung deaktiviert wird

351 351

352Wenn Ihr Konto den Zugriff auf das Modell verliert, auf dem Ihre Sitzung läuft, beispielsweise weil ein Administrator es in Ihrem Amazon Bedrock-Konto deaktiviert, wechselt Claude Code die Sitzung zu einem anderen Modell, anstatt jede Anfrage fehlschlagen zu lassen, und zeigt `Switched to <fallback> because <model> is not available` an. Es versucht die gleichen Modelle wie der Startup-Fallback: zuerst frühere Versionen der gleichen Stufe und für eine Opus-Sitzung ohne verfügbare Opus-Version das Standard-Sonnet-Modell.352Wenn Amazon Bedrock das Modell Ihrer Sitzung als für Ihr Konto nicht verfügbar ablehnt, wechselt Claude Code Ihre Sitzung zu einem anderen Modell, und Sie können weiterarbeiten. Sie sehen eine Meldung, die mit `Switched to <fallback> because <model> is not available` beginnt. Dies geschieht beispielsweise, wenn ein Administrator das Modell deaktiviert oder das neueste Modell für Ihr Konto noch nicht verfügbar ist.

353 353

354Der Wechsel gilt nur für eine Stufe, die Sie nicht angeheftet haben, die gleiche Bedingung wie der Startup-Fallback. Eine Sitzung auf einer bestimmten Version, die Sie ausgewählt haben, oder auf einem [Anwendungs-Inferenzprofil-ARN](#map-each-model-version-to-an-inference-profile) behält ihr Modell, und ohne eine Fallback-Modellkette schlägt die Anfrage stattdessen fehl. Im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) wechselt Claude Code nur zu einem Modell, das der Auto-Modus auf Amazon Bedrock unterstützt. Wenn auch keines dieser Modelle verfügbar ist, schlägt die Anfrage mit [AWS-Authentifizierung fehlgeschlagen](https://code.claude.com/docs/de/errors.md#aws-authentication-failed) und einem Hinweis zum Aktivieren des Modells fehl.354Wenn Sie eine [Fallback-Modellkette](https://code.claude.com/docs/de/model-config.md#fallback-model-chains) konfiguriert haben, wechselt Claude Code stattdessen zu Ihrem konfigurierten Fallback. Ohne eine Kette schlägt die Anfrage beispielsweise in folgenden Fällen fehl:

355 355

356Eine [Fallback-Modellkette](https://code.claude.com/docs/de/model-config.md#fallback-model-chains), die Sie konfigurieren, ersetzt den Stufenwechsel: Bei diesen Ablehnungen wechselt Claude Code stattdessen zu Ihrem konfigurierten Fallback. Damit abgelehnte Anfragen fehlschlagen, anstatt zu wechseln, setzen Sie [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/de/env-vars). Eine Fallback-Kette, die Sie konfiguriert haben, wechselt immer noch bei diesen Ablehnungen; entfernen Sie die Kette auch, wenn Sie möchten, dass jede abgelehnte Anfrage fehlschlägt.356* Ihre Sitzung läuft auf einem angehefteten Modell, einer bestimmten von Ihnen ausgewählten Version oder einem [Anwendungs-Inferenzprofil-ARN](#map-each-model-version-to-an-inference-profile)

357* Keines der [Modelle, die Claude Code versucht](#startup-model-checks), ist verfügbar. Im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) wechselt Claude Code nur zu einem Modell, das der Auto-Modus auf Amazon Bedrock unterstützt.

358

359Um weiterzuarbeiten, führen Sie `/model` in der Sitzung aus und drücken Sie `s` bei einem Modell, das Ihr Konto verwenden kann. Ihr Standard bleibt dabei unverändert. Ein `403` wird als [AWS-Authentifizierung fehlgeschlagen](https://code.claude.com/docs/de/errors.md#aws-authentication-failed) angezeigt.

360

361Damit abgelehnte Anfragen fehlschlagen, anstatt zu wechseln, setzen Sie [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/de/env-vars). Wenn Sie eine Fallback-Modellkette konfiguriert haben, entfernen Sie diese ebenfalls, da Claude Code sonst weiterhin zu diesem Fallback wechselt.

357 362

358## Präfixe für regionsübergreifende Inferenzprofile363## Präfixe für regionsübergreifende Inferenzprofile

359 364

best-practices.md +1 −1

Details

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

claude-apps-gateway.md +3 −1

Details

74| PostgreSQL 11 oder später | Unterstützt den Geräte-Anmeldungsfluss und Rate-Limit-Zähler. Ein verwalteter PostgreSQL-Dienst funktioniert, einschließlich der kleinsten Stufe; siehe [welche Datenbanken unterstützt werden](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#postgres). Mit [Ausgabenlimits](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) enthält es auch dauerhafte Ausgaben-, Audit- und Identitätstabellen, die gesichert werden sollten. TLS über `?sslmode=require` wird empfohlen. PostgreSQL 11, 12 und 13 erfordern Claude Code v2.1.290 oder später auf dem Gateway-Server. Das PostgreSQL-Projekt pflegt diese Versionen nicht mehr, verwenden Sie daher nach Möglichkeit eine neuere. |74| PostgreSQL 11 oder später | Unterstützt den Geräte-Anmeldungsfluss und Rate-Limit-Zähler. Ein verwalteter PostgreSQL-Dienst funktioniert, einschließlich der kleinsten Stufe; siehe [welche Datenbanken unterstützt werden](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#postgres). Mit [Ausgabenlimits](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) enthält es auch dauerhafte Ausgaben-, Audit- und Identitätstabellen, die gesichert werden sollten. TLS über `?sslmode=require` wird empfohlen. PostgreSQL 11, 12 und 13 erfordern Claude Code v2.1.290 oder später auf dem Gateway-Server. Das PostgreSQL-Projekt pflegt diese Versionen nicht mehr, verwenden Sie daher nach Möglichkeit eine neuere. |

75| Modell-Upstream | Amazon-Bedrock-Anmeldedaten, Claude Platform auf AWS Anmeldedaten, Google-Cloud-Anmeldedaten, eine Microsoft-Foundry-Ressource oder einen Anthropic-API-Schlüssel. Mehrere Upstreams werden mit Failover unterstützt. |75| Modell-Upstream | Amazon-Bedrock-Anmeldedaten, Claude Platform auf AWS Anmeldedaten, Google-Cloud-Anmeldedaten, eine Microsoft-Foundry-Ressource oder einen Anthropic-API-Schlüssel. Mehrere Upstreams werden mit Failover unterstützt. |

76| HTTPS | Das Gateway muss über `https://` von Entwickler-Laptops und von jedem Browser, der für die Anmeldung verwendet wird, erreichbar sein; das Gateway bedient die Geräteüberprüfungsseite auf dem gleichen Listener. Stellen Sie entweder ein TLS-Zertifikat über `listen.tls` bereit, oder führen Sie hinter einem TLS-terminierenden Ingress aus und setzen Sie `listen.public_url` auf den externen Ursprung in beiden Fällen. Bei `/login` akzeptiert Claude Code einen einfachen `http://`-Ursprung nur, wenn der Gateway-Host Loopback ist: `localhost`, `127.0.0.1` oder `::1`. |76| HTTPS | Das Gateway muss über `https://` von Entwickler-Laptops und von jedem Browser, der für die Anmeldung verwendet wird, erreichbar sein; das Gateway bedient die Geräteüberprüfungsseite auf dem gleichen Listener. Stellen Sie entweder ein TLS-Zertifikat über `listen.tls` bereit, oder führen Sie hinter einem TLS-terminierenden Ingress aus und setzen Sie `listen.public_url` auf den externen Ursprung in beiden Fällen. Bei `/login` akzeptiert Claude Code einen einfachen `http://`-Ursprung nur, wenn der Gateway-Host Loopback ist: `localhost`, `127.0.0.1` oder `::1`. |

77| Private-Netzwerk-Adresse | Bei `/login` erfordert Claude Code, dass der Hostname oder die IP-Adresse des Gateways nur zu privaten Adressen aufgelöst wird: RFC 1918, Link-lokal, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` oder Loopback. Für ein von Ihnen gehostetes Gateway wird jede öffentliche Adresse außerhalb eines Blocks, den Sie deklarieren, abgelehnt; siehe das [Bedrohungsmodell](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#threat-model-summary) im Bereitstellungsleitfaden. Wenn Entwicklermaschinen HTTPS über einen Unternehmens-Proxy leiten, erfordert die Anmeldung auch, dass der Proxy-Host zu privaten Adressen aufgelöst wird; wenn nicht, fügen Sie den Gateway-Host zu `NO_PROXY` hinzu, damit die CLI direkt verbunden wird. Wenn Ihr internes Netzwerk aus öffentlichem IPv4-Adressraum nummeriert ist, den Ihre Organisation besitzt, [deklarieren Sie diese Blöcke](#allow-a-gateway-on-public-address-space-you-own), damit `/login` ein Gateway dort akzeptiert. |77| Private-Netzwerk-Adresse | Bei `/login` erfordert Claude Code, dass der Hostname oder die IP-Adresse des Gateways nur zu privaten Adressen aufgelöst wird: RFC-1918- und Link-lokale Bereiche, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` und Loopback. Siehe das [Bedrohungsmodell](https://code.claude.com/docs/de/claude-apps-gateway-deploy.md#threat-model-summary). Wenn Ihr internes Netzwerk aus öffentlichem IPv4-Adressraum nummeriert ist, den Ihre Organisation besitzt, [deklarieren Sie diese Blöcke](#allow-a-gateway-on-public-address-space-you-own), damit `/login` ein Gateway dort akzeptiert. |

78| Linux-Laufzeit | Der Gateway-Server läuft nur auf der nativen Linux-Binärdatei. macOS funktioniert für lokale Entwicklung. Windows wird nicht als Serverplattform unterstützt. |78| Linux-Laufzeit | Der Gateway-Server läuft nur auf der nativen Linux-Binärdatei. macOS funktioniert für lokale Entwicklung. Windows wird nicht als Serverplattform unterstützt. |

79 79

80Wenn `HTTPS_PROXY` oder `HTTP_PROXY` für den Gateway-Host gilt, erfordert die Anmeldung außerdem entweder einen Proxy, dessen Hostname zu privaten Adressen aufgelöst wird, oder den Gateway-Host in `NO_PROXY` auf den Entwicklermaschinen. Wenn diese Maschinen auch `no_proxy` setzen, fügen Sie den Gateway-Host auch dort hinzu, andernfalls laufen Modellanfragen weiterhin über den Proxy.

80### Schritte82### Schritte

81 83

82**1. Registrieren Sie einen OAuth-Client in Ihrem IdP**84**1. Registrieren Sie einen OAuth-Client in Ihrem IdP**

claude-apps-gateway-config.md +8 −2

Details

656 656

657| Setup | Wie |657| Setup | Wie |

658| - | - |658| - | - |

659| RBAC | Gewähren Sie der Identität des Gateways `Azure AI User` oder `Cognitive Services User` auf der Microsoft Foundry-Ressource |659| RBAC | Gewähren Sie der Identität des Gateways die Rolle `Foundry User` oder `Cognitive Services User` für die Microsoft-Foundry-Ressource |

660| Deployments | Microsoft Foundry verwendet von Administratoren gewählte Deployment-Namen, nicht kanonische Modell-IDs. Fügen Sie einen [`models:`](#models)-Block hinzu, der jede kanonische ID Ihrem Deployment-Namen zuordnet. |660| Deployments | Microsoft Foundry verwendet von Administratoren gewählte Deployment-Namen, nicht kanonische Modell-IDs. Fügen Sie einen [`models:`](#models)-Block hinzu, der jede kanonische ID Ihrem Deployment-Namen zuordnet. |

661| AKS (Workload Identity) | Verknüpfen Sie eine User-Assigned Managed Identity per Federation mit dem OIDC-Aussteller des Clusters und binden Sie sie an den Service-Account des Gateways. `use_azure_ad: true` übernimmt sie über `WorkloadIdentityCredential`. |661| AKS (Workload Identity) | Verknüpfen Sie eine User-Assigned Managed Identity per Federation mit dem OIDC-Aussteller des Clusters und binden Sie sie an den Service-Account des Gateways. `use_azure_ad: true` übernimmt sie über `WorkloadIdentityCredential`. |

662| ACI / App Service | Aktivieren Sie eine system- oder benutzerzugewiesene Managed Identity auf der Ressource. `use_azure_ad: true` übernimmt sie. |662| ACI / App Service | Aktivieren Sie eine system- oder benutzerzugewiesene Managed Identity auf der Ressource. `use_azure_ad: true` übernimmt sie. |

1001 1001

1002Jeder Schlüssel unter `upstream_model` muss dem `name` eines konfigurierten Upstream entsprechen, der standardmäßig auf den Anbieternamen gesetzt ist. Ein Schlüssel, der keinem Upstream entspricht, schlägt beim Start fehl, daher lassen Sie die Zeilen für Anbieter weg, die Sie nicht verwenden.1002Jeder Schlüssel unter `upstream_model` muss dem `name` eines konfigurierten Upstream entsprechen, der standardmäßig auf den Anbieternamen gesetzt ist. Ein Schlüssel, der keinem Upstream entspricht, schlägt beim Start fehl, daher lassen Sie die Zeilen für Anbieter weg, die Sie nicht verwenden.

1003 1003

1004Damit Entwickler den Alias `fable` mit `auto_include_builtin_models: false` verwenden können, fügen Sie `models` einen Eintrag `claude-fable-5` hinzu. Das ist die ID, zu der der [Alias `fable`](https://code.claude.com/docs/de/model-config#fable-alias-resolution) für am Gateway angemeldete Entwickler aufgelöst wird. Ohne diesen Eintrag schlagen ihre Nachrichten mit einem Fehler fehl, der mit `API Error: 400 model claude-fable-5 is not in the operator's model allowlist` beginnt.

1005

1004### `managed`1006### `managed`

1005 1007

1006Der Block `managed` definiert rollenbasierte Zugriffsrichtlinien, die an IdP-Gruppen oder E-Mail-Domains geknüpft sind. Richtlinien werden der Reihe nach ausgewertet; standardmäßig wird die erste Übereinstimmung ausgewählt und dann mit der Basis des Catch-all `match: {}` zusammengeführt. Ein Benutzer, auf den zwei Rollenrichtlinien zutreffen, erhält nur die erste, sodass die deny-Regeln der zweiten Richtlinie nicht gelten, es sei denn, Sie [wenden jede zutreffende Richtlinie an](#apply-every-matching-policy). Richtlinien werden pro Benutzer unter `GET /managed/settings` mit ETag/304-Caching ausgeliefert.1008Der Block `managed` definiert rollenbasierte Zugriffsrichtlinien, die an IdP-Gruppen oder E-Mail-Domains geknüpft sind. Richtlinien werden der Reihe nach ausgewertet; standardmäßig wird die erste Übereinstimmung ausgewählt und dann mit der Basis des Catch-all `match: {}` zusammengeführt. Ein Benutzer, auf den zwei Rollenrichtlinien zutreffen, erhält nur die erste, sodass die deny-Regeln der zweiten Richtlinie nicht gelten, es sei denn, Sie [wenden jede zutreffende Richtlinie an](#apply-every-matching-policy). Richtlinien werden pro Benutzer unter `GET /managed/settings` mit ETag/304-Caching ausgeliefert.

1025Eine `match: {}`-Catch-All, üblicherweise zuletzt aufgelistet, wird als Basisschicht behandelt. Jede andere Richtlinie erbt jeden Schlüssel, den sie nicht setzt, von der Catch-All, sodass Pro-Rollen-Einträge nur auflisten müssen, was sich vom Organisationsstandardwert unterscheidet. Die Zusammenführungsregeln hängen vom Schlüsseltyp ab:1027Eine `match: {}`-Catch-All, üblicherweise zuletzt aufgelistet, wird als Basisschicht behandelt. Jede andere Richtlinie erbt jeden Schlüssel, den sie nicht setzt, von der Catch-All, sodass Pro-Rollen-Einträge nur auflisten müssen, was sich vom Organisationsstandardwert unterscheidet. Die Zusammenführungsregeln hängen vom Schlüsseltyp ab:

1026 1028

1027* **Zulassungslisten**: `availableModels` und `permissions.allow`. Die Liste einer bestimmten Richtlinie ersetzt die Basis vollständig.1029* **Zulassungslisten**: `availableModels` und `permissions.allow`. Die Liste einer bestimmten Richtlinie ersetzt die Basis vollständig.

1028* **Denylists und Hook-Arrays**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces`, `deniedModels` und jedes `hooks`-Array pro Ereignistyp. Diese bilden die Vereinigung aus Basis und Richtlinie, sodass eine organisationsweite Ablehnung oder ein Audit-Hook nicht versehentlich durch eine rollenspezifische Überschreibung entfallen kann.1030* **Denylists und Hook-Arrays**: Diese bilden die Vereinigung aus Basis und Richtlinie:

1031 * `permissions.deny` und `permissions.ask`

1032 * `disabledMcpjsonServers` und `deniedMcpServers`

1033 * `blockedMarketplaces` und `deniedModels`

1034 * Die Event-Typ-Arrays von `hooks`

1029* **Datensatz-typisierte Schlüssel**: `env`, `modelOverrides` und `skillOverrides`. Diese werden flach zusammengeführt, sodass ein Pro-Rollen-`env`-Block Schlüssel überschreibt, die er setzt, und den Rest von der Basis erbt.1035* **Datensatz-typisierte Schlüssel**: `env`, `modelOverrides` und `skillOverrides`. Diese werden flach zusammengeführt, sodass ein Pro-Rollen-`env`-Block Schlüssel überschreibt, die er setzt, und den Rest von der Basis erbt.

1030 1036

1031`availableModels` wird auch serverseitig unter `/v1/messages` erzwungen, sodass ein abgelehntes Modell `400` zurückgibt, unabhängig davon, was der Client sendet. Eine leere Liste lehnt jedes Modell ab. Die Prüfung umfasst auch das Modell, mit dem eine Sitzung startet, bevor der Entwickler eines auswählt, daher [starten Sie Sitzungen mit einem Modell, das die Richtlinie zulässt](#start-sessions-on-a-model-the-policy-allows).1037`availableModels` wird auch serverseitig unter `/v1/messages` erzwungen, sodass ein abgelehntes Modell `400` zurückgibt, unabhängig davon, was der Client sendet. Eine leere Liste lehnt jedes Modell ab. Die Prüfung umfasst auch das Modell, mit dem eine Sitzung startet, bevor der Entwickler eines auswählt, daher [starten Sie Sitzungen mit einem Modell, das die Richtlinie zulässt](#start-sessions-on-a-model-the-policy-allows).

claude-apps-gateway-deploy.md +1 −1

Details

92 92

93Über die Binärdatei hinaus benötigt das Image:93Über die Binärdatei hinaus benötigt das Image:

94 94

95* **Ein glibc-basiertes Image**: Die einzigen dynamischen Abhängigkeiten des glibc-Builds sind glibc-Bibliotheken. Musl-basierte Images benötigen den `linux-x64-musl`- oder `linux-arm64-musl`-Build plus zusätzliche Pakete; siehe [Alpine-Linux-Setup](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions).95* **Ein glibc-basiertes Image**: Die einzigen dynamischen Abhängigkeiten des glibc-Builds sind glibc-Bibliotheken. Musl-basierte Images benötigen den `linux-x64-musl`- oder `linux-arm64-musl`-Build, dessen einzige dynamische Abhängigkeit musl ist.

96* **Ein beschreibbares Zustandsverzeichnis**: Das Gateway läuft als jeder Benutzer, aber minimale Images haben kein beschreibbares Home. Setzen Sie `CLAUDE_CONFIG_DIR` auf einen beschreibbaren Pfad wie `/tmp/.claude`.96* **Ein beschreibbares Zustandsverzeichnis**: Das Gateway läuft als jeder Benutzer, aber minimale Images haben kein beschreibbares Home. Setzen Sie `CLAUDE_CONFIG_DIR` auf einen beschreibbaren Pfad wie `/tmp/.claude`.

97* **Der Container-Befehl**: `claude gateway --config /etc/claude/gateway.yaml`, mit der Konfigurationsdatei schreibgeschützt eingebunden und Geheimnissen als Umgebungsvariablen bereitgestellt; das Gateway lauscht auf `listen.port`, Standard `8080`.97* **Der Container-Befehl**: `claude gateway --config /etc/claude/gateway.yaml`, mit der Konfigurationsdatei schreibgeschützt eingebunden und Geheimnissen als Umgebungsvariablen bereitgestellt; das Gateway lauscht auf `listen.port`, Standard `8080`.

98 98

claude-projects.md +2 −0

Details

274 274

275Der Thread läuft im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode), sodass Claude Befehle ausführt und Dateien in diesem Ordner bearbeitet, ohne Sie jedes Mal zu fragen. Wenn Auto-Modus auf diesem Computer nicht verfügbar oder deaktiviert ist, läuft der Thread ohne ihn, und jede Berechtigungsaufforderung, die er auslöst, wartet auf Ihre Antwort im Thread, wie [Entsperren Sie einen Thread, der auf Genehmigung wartet](#unblock-a-thread-waiting-on-approval) beschreibt.275Der Thread läuft im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode), sodass Claude Befehle ausführt und Dateien in diesem Ordner bearbeitet, ohne Sie jedes Mal zu fragen. Wenn Auto-Modus auf diesem Computer nicht verfügbar oder deaktiviert ist, läuft der Thread ohne ihn, und jede Berechtigungsaufforderung, die er auslöst, wartet auf Ihre Antwort im Thread, wie [Entsperren Sie einen Thread, der auf Genehmigung wartet](#unblock-a-thread-waiting-on-approval) beschreibt.

276 276

277Um den Thread in einem anderen Modus auszuführen, starten Sie `claude remote-control` mit [`--settings`](https://code.claude.com/docs/de/remote-control#start-a-remote-control-session). Dann kann [`permissions.defaultMode`](https://code.claude.com/docs/de/permission-modes#start-in-a-different-mode) in dieser Datei oder in den Einstellungen dieses Computers einen anderen Modus auswählen.

278

277Während der Thread läuft, zeigt ein Laptop-Symbol in seiner Kopfzeile, ob Ihr Computer verbunden ist. Klicken Sie darauf, um zu sehen, welchen Ordner der Thread verwendet, oder um die Verbindung auszuschalten. Der Thread wird unterbrochen, während dieser Computer schläft, und stoppt, wenn die Desktop-App oder `claude remote-control` beendet wird.279Während der Thread läuft, zeigt ein Laptop-Symbol in seiner Kopfzeile, ob Ihr Computer verbunden ist. Klicken Sie darauf, um zu sehen, welchen Ordner der Thread verwendet, oder um die Verbindung auszuschalten. Der Thread wird unterbrochen, während dieser Computer schläft, und stoppt, wenn die Desktop-App oder `claude remote-control` beendet wird.

278 280

279* **Um den Thread wieder zum Laufen zu bringen**: siehe [Lost contact with your folder](#lost-contact-with-your-folder)281* **Um den Thread wieder zum Laufen zu bringen**: siehe [Lost contact with your folder](#lost-contact-with-your-folder)

commands.md +0 −2

Details

35Die folgende Tabelle listet alle in Claude Code enthaltenen Befehle auf. Die meisten sind integrierte Befehle, deren Verhalten in der CLI implementiert ist. Zwei Arten von Einträgen sind gekennzeichnet:35Die folgende Tabelle listet alle in Claude Code enthaltenen Befehle auf. Die meisten sind integrierte Befehle, deren Verhalten in der CLI implementiert ist. Zwei Arten von Einträgen sind gekennzeichnet:

36 36

37* **[Skill](https://code.claude.com/docs/de/skills.md#bundled-skills)**: ein mitgelieferter Skill. Er funktioniert wie Skills, die Sie selbst schreiben: ein Prompt, der an Claude übergeben wird.37* **[Skill](https://code.claude.com/docs/de/skills.md#bundled-skills)**: ein mitgelieferter Skill. Er funktioniert wie Skills, die Sie selbst schreiben: ein Prompt, der an Claude übergeben wird.

~~38 * `/verify` wird nur ausgeführt, wenn Sie ihn aufrufen.~~

39* **[Workflow](https://code.claude.com/docs/de/workflows.md#bundled-workflows)**: ein mitgelieferter [dynamischer Workflow](https://code.claude.com/docs/de/workflows.md), der Arbeit auf viele Subagenten verteilt und im Hintergrund läuft.38* **[Workflow](https://code.claude.com/docs/de/workflows.md#bundled-workflows)**: ein mitgelieferter [dynamischer Workflow](https://code.claude.com/docs/de/workflows.md), der Arbeit auf viele Subagenten verteilt und im Hintergrund läuft.

~~40 * `/deep-research` wird nur ausgeführt, wenn Sie ihn aufrufen.~~

41 39

42Um eigene Befehle hinzuzufügen, siehe [Skills](https://code.claude.com/docs/de/skills.md).40Um eigene Befehle hinzuzufügen, siehe [Skills](https://code.claude.com/docs/de/skills.md).

43 41

desktop-linux.md +1 −1

Details

71 71

72Starten Sie **Claude** über Ihren Anwendungsstarter oder führen Sie `claude-desktop` von einem Terminal aus aus und melden Sie sich mit Ihrem Anthropic-Konto an.72Starten Sie **Claude** über Ihren Anwendungsstarter oder führen Sie `claude-desktop` von einem Terminal aus aus und melden Sie sich mit Ihrem Anthropic-Konto an.

73 73

74Die Linux-App meldet sich auf die gleiche Weise an wie auf macOS und Windows: mit einem claude.ai-Abonnement oder über das SSO Ihrer Organisation. Verwenden Sie für die API-Schlüssel-Authentifizierung die [CLI](https://code.claude.com/docs/de/quickstart.md). Um Desktop stattdessen mit Amazon Bedrock, der Agent Platform von Google Cloud, Microsoft Foundry oder einem LLM-Gateway zu verwenden, siehe [Claude Desktop auf 3P](https://claude.com/docs/third-party/claude-desktop/overview). Informationen zu Proxyservern und benutzerdefinierten Zertifizierungsstellen in diesen Bereitstellungen finden Sie unter [Netzwerkkonfiguration](https://code.claude.com/docs/de/network-config.md).74Die Linux-App meldet sich auf die gleiche Weise an wie auf macOS und Windows: mit einem claude.ai-Abonnement oder über das SSO Ihrer Organisation. Um Desktop stattdessen mit einem Claude-API-Schlüssel, Amazon Bedrock, der Agent Platform von Google Cloud, Microsoft Foundry oder einem LLM-Gateway zu verwenden, siehe [Claude Desktop auf 3P](https://claude.com/docs/third-party/claude-desktop/overview). Informationen zu Proxyservern und benutzerdefinierten Zertifizierungsstellen in diesen Bereitstellungen finden Sie unter [Netzwerkkonfiguration](https://code.claude.com/docs/de/network-config.md).

75 75

76### Installation aus einer heruntergeladenen Datei76### Installation aus einer heruntergeladenen Datei

77 77

desktop-scheduled-tasks.md +7 −2

Details

83 83

84**8. Berechtigungsmodus und Modell auswählen**84**8. Berechtigungsmodus und Modell auswählen**

85 85

86Wählen Sie in der Symbolleiste des Anweisungsfelds einen [Berechtigungsmodus](#permissions-for-scheduled-tasks) und ein Modell aus. Wenn Sie diese unverändert lassen, verwenden Ausführungen Ihre Claude Code-Einstellungen und das Standardmodell.86Wählen Sie in der Symbolleiste des Anweisungsfelds einen [Berechtigungsmodus](#permissions-for-scheduled-tasks) und ein Modell aus.

88* **Berechtigungsmodus**: Wenn Sie ihn unverändert lassen, verwenden Ausführungen Ihre Claude Code-Einstellungen.

89* **Modell**: Wenn im Modellmenü **Standard · Vom Admin festgelegt** steht und Sie kein anderes Modell auswählen, verwenden Ausführungen das Modell, das Ihre Organisation in den [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md) festgelegt hat. Eine [Nachholausführung](#missed-runs), die beim Öffnen der App startet, kann stattdessen den [Laufzeitstandard für Ihr Konto](https://code.claude.com/docs/de/model-config.md#default-model-setting) verwenden.

87 90

88**9. Aufgabe erstellen**91**9. Aufgabe erstellen**

89 92

90Klicken Sie auf **Erstellen**. Wenn Sie dem Ordner noch nicht vertraut haben, fordert Desktop Sie an dieser Stelle auf, ihm zu vertrauen. Die Detailseite der Aufgabe wird geöffnet.93Klicken Sie auf **Erstellen**. Wenn Sie dem Ordner noch nicht vertraut haben, fordert Desktop Sie an dieser Stelle auf, ihm zu vertrauen. Die Detailseite der Aufgabe wird geöffnet.

91 94

95Um zu sehen, für welches Modell **Standard · Vom Admin festgelegt** steht, klicken Sie auf der Detailseite auf **Jetzt ausführen**, um die Aufgabe sofort auszuführen. [Öffnen Sie dann die Sitzung der Ausführung](#find-a-runs-session), in der die Zeile unter dem Eingabefeld den Namen des Modells anzeigt.

92Klicken Sie auf der Detailseite auf das Stiftsymbol, um das [**Bearbeiten**-Formular](#manage-scheduled-tasks) zu öffnen. Dort können Sie die **Beschreibung** ändern, die Desktop aus Ihren Anweisungen ausgefüllt hat, **Worktree** auswählen oder den Zeitplan auf **Manuell** oder **Benutzerdefiniert** umstellen.97Klicken Sie auf der Detailseite auf das Stiftsymbol, um das [**Bearbeiten**-Formular](#manage-scheduled-tasks) zu öffnen. Dort können Sie die **Beschreibung** ändern, die Desktop aus Ihren Anweisungen ausgefüllt hat, **Worktree** auswählen oder den Zeitplan auf **Manuell** oder **Benutzerdefiniert** umstellen.

93 98

94Sie können auch eine Aufgabe erstellen, indem Sie in einer beliebigen Sitzung beschreiben, was Sie möchten. Zum Beispiel erstellt „Richten Sie ein tägliches Code-Review ein, das jeden Morgen um 9 Uhr ausgeführt wird“ eine wiederkehrende Aufgabe. Eine Anfrage wie „Erinnern Sie mich morgen um 15 Uhr, die Bereitstellung zu überprüfen“ erstellt eine einmalige Aufgabe, die sich nach der Ausführung selbst deaktiviert.99Sie können auch eine Aufgabe erstellen, indem Sie in einer beliebigen Sitzung beschreiben, was Sie möchten. Zum Beispiel erstellt „Richten Sie ein tägliches Code-Review ein, das jeden Morgen um 9 Uhr ausgeführt wird“ eine wiederkehrende Aufgabe. Eine Anfrage wie „Erinnern Sie mich morgen um 15 Uhr, die Bereitstellung zu überprüfen“ erstellt eine einmalige Aufgabe, die sich nach der Ausführung selbst deaktiviert.

181 186

182Damit eine Aufgabe ihren eigenen Zeitplan oder Prompt mit dem MCP-Tool `update_scheduled_task` ändern kann, klicken Sie auf **Jetzt ausführen** und genehmigen Sie den Aufruf jedes Mal.187Damit eine Aufgabe ihren eigenen Zeitplan oder Prompt mit dem MCP-Tool `update_scheduled_task` ändern kann, klicken Sie auf **Jetzt ausführen** und genehmigen Sie den Aufruf jedes Mal.

183 188

184Um die Eingabeaufforderung einer Aufgabe auf der Festplatte zu bearbeiten, öffnen Sie `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (oder unter [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/de/env-vars), falls gesetzt). Die Datei verwendet YAML-Frontmatter für `name` und `description`, mit der Eingabeaufforderung als Text. Änderungen werden bei der nächsten Ausführung wirksam. Zeitplan, Ordner, Modell und aktivierter Status befinden sich nicht in dieser Datei: Ändern Sie sie über das Bearbeitungsformular oder bitten Sie Claude.189Um den Prompt einer Aufgabe auf der Festplatte zu bearbeiten, öffnen Sie `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (oder unter [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/de/env-vars), falls gesetzt). Die Datei verwendet YAML-Frontmatter für `name` und `description`, mit dem Prompt als Text. Änderungen werden bei der nächsten Ausführung wirksam. Zeitplan, Ordner und aktivierter Status befinden sich nicht in dieser Datei: Ändern Sie sie über das Bearbeitungsformular oder bitten Sie Claude.

185 190

186## Verwandte Ressourcen191## Verwandte Ressourcen

187 192

errors.md +50 −7

Details

122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentifizierung](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentifizierung](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `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) |123| `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) |

124| `Issuer mismatch in authorization response (RFC 9207)` | [Authentifizierung](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [Authentifizierung](#issuer-mismatch-in-authorization-response) |

125| `Stopped an OAuth request` | [Authentifizierung](#stopped-an-oauth-request) |

125| `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) |126| `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) |

252| `Remote Control did not start: "<question>" got no answer` | [Befehlszeilenfehler](#remote-control-did-not-start-got-no-answer) |253| `Remote Control did not start: "<question>" got no answer` | [Befehlszeilenfehler](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Befehlszeilenfehler](#not-carried-over-to-the-sessions-remote-control-starts) |254| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Befehlszeilenfehler](#not-carried-over-to-the-sessions-remote-control-starts) |

255| `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) |

256| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Befehlszeilenfehler](#settings-file-changed-since-remote-control-started) |

254| `--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) |257| `--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) |

255| `` `claude import` is not yet available in this build `` | [Befehlszeilenfehler](#claude-import-is-not-yet-available-in-this-build) |258| `` `claude import` is not yet available in this build `` | [Befehlszeilenfehler](#claude-import-is-not-yet-available-in-this-build) |

266| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Befehlszeilenfehler](#mcp-permission-prompt-tool-not-found) |269| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Befehlszeilenfehler](#mcp-permission-prompt-tool-not-found) |

267| `OAuth callback port <port> is already in use — another process may be holding it` | [Befehlszeilenfehler](#oauth-callback-port-is-already-in-use) |270| `OAuth callback port <port> is already in use — another process may be holding it` | [Befehlszeilenfehler](#oauth-callback-port-is-already-in-use) |

269| `Shell command failed for pattern "..."`, von `/security-review` oder einem beliebigen Skill, der dynamischen Kontext einfügt | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |272| `Shell command failed for pattern "..."` von `/security-review` oder einem beliebigen Skill, der dynamischen Kontext einfügt | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |

270| `Shell command permission check failed for pattern "..."`, von einem Skill, der dynamischen Kontext injiziert | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |273| `Shell command permission check failed for pattern "..."`, von einem Skill, der dynamischen Kontext injiziert | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |

271| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |274| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Befehlszeilenfehler](#security-review-fails-without-origin-head) |

272| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Befehlszeilenfehler](#no-shell-command-was-run) |275| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Befehlszeilenfehler](#no-shell-command-was-run) |

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

826 829

827```text theme={null}830```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged831another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```832```

830 833

831Claude 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:834Claude 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:

1822 1825

1823Vor 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.1826Vor 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.

1824 1827

1828### Stopped an OAuth request

1829

1830Diese 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:

1831

1832```text theme={null}

1833Stopped 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.

1834Stopped 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.

1835```

1836

1837**Was zu tun ist:**

1838

1839* 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.

1840

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

1826 1842

1827In 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.1843In 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.

2207 2223

2208### Host not allowed in a cloud session2224### Host not allowed in a cloud session

2209 2225

2210Eine ausgehende HTTP-Anfrage aus einer Cloud-Sitzung oder einer geplanten Cloud-Aufgabe wurde durch die Netzwerkrichtlinie der Umgebung blockiert.2226In 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:

2211 2227

2212```text theme={null}2228```text theme={null}

2213HTTP 4032229HTTP 403

2565 2581

2566Claude 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.2582Claude 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.

2567 2583

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

2585

2568**Was zu tun ist:**2586**Was zu tun ist:**

2569 2587

2570* 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.2588* 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.

3522Sie 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:3540Sie 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:

3523 3541

3524```text theme={null}3542```text theme={null}

3525Error: `--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`).3543Error: `--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>`.

3526```3544```

3527 3545

3528Globale 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.3546Globale 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.

3536 3554

3537Vor 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.3555Vor 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.

3538 3556

3557### Remote Control wurde wegen der `--settings`-Datei nicht gestartet

3558

3559Die 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:

3560

3561```text theme={null}

3562Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3563```

3564

3565**Was Sie tun können:**

3566

3567* Beheben Sie das Problem, das die Meldung nennt, und führen Sie Ihren `claude remote-control`-Befehl dann erneut aus

3568

3569### The settings file has changed since Remote Control started

3570

3571Diese 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:

3572

3573```text theme={null}

3574Session 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.

3575```

3576

3577**Was Sie tun können:**

3578

3579* 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).

3580* 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

3581

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3582### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3583

3541Dieser 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:3584Dieser 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:

3806 3849

3807Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:3850Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:

3808 3851

3809* `Shell command permission check failed for pattern "..."`: Die Berechtigungsprüfung des Befehls hat ihn nicht zugelassen. [Berechtigungsprüfungen für eingefügte Befehle](https://code.claude.com/docs/de/skills.md#permission-checks-on-injected-commands) beschreibt, welche Ergebnisse in jedem Berechtigungsmodus abbrechen und wie Sie einen Befehl mit `allowed-tools` vorab genehmigen3852* `Shell command permission check failed for pattern "..."`: Die Berechtigungsprüfung des Befehls hat ihn nicht zugelassen. [Berechtigungsprüfungen bei eingefügten Befehlen](https://code.claude.com/docs/de/skills.md#permission-checks-on-injected-commands) beschreibt, welche Ergebnisse in jedem Berechtigungsmodus zum Abbruch führen und wie Sie einen Befehl mit `allowed-tools` vorab genehmigen

3810* ``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 zu `shell: powershell`. Siehe [Wie eingefügte Befehle ausgeführt werden](https://code.claude.com/docs/de/skills.md#how-injected-commands-run)3853* ``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)

3811 3854

3812**Vorgehensweise:**3855**Vorgehensweise:**

3813 3856

3960 4003

3961* **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 Beispiel4004* **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

3962* **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>`)``4005* **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>`)``

3963* **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.4006* **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 shallow 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.

3964 4007

3965**Vorgehensweise:**4008**Vorgehensweise:**

3966 4009

gateways.md +1 −1

Details

63* **Client-Telemetrie**: Claude Code deaktiviert seine Anthropic-gebundene Client-Analytik, wenn sich eine Sitzung bei einem Claude apps Gateway anmeldet. Um auch die Telemetrie vor der Anmeldung beim Startup auszuschalten, liefern Sie [`DISABLE_TELEMETRY`](https://code.claude.com/docs/de/managed-settings#turn-telemetry-off-for-your-organization) in den [clientseitigen verwalteten Einstellungen](https://code.claude.com/docs/de/claude-apps-gateway-config.md#client-side-managed-settings) auf jedem Gerät.63* **Client-Telemetrie**: Claude Code deaktiviert seine Anthropic-gebundene Client-Analytik, wenn sich eine Sitzung bei einem Claude apps Gateway anmeldet. Um auch die Telemetrie vor der Anmeldung beim Startup auszuschalten, liefern Sie [`DISABLE_TELEMETRY`](https://code.claude.com/docs/de/managed-settings#turn-telemetry-off-for-your-organization) in den [clientseitigen verwalteten Einstellungen](https://code.claude.com/docs/de/claude-apps-gateway-config.md#client-side-managed-settings) auf jedem Gerät.

64* **Client-Telemetrie auf anderen Gateways**: Ob Claude Code den optionalen Client-Telemetrie-Stream sendet, hängt von Ihrem Anbieter ab, und die [Telemetrie-Standardtabelle](https://code.claude.com/docs/de/data-usage.md#default-behaviors-by-api-provider) behandelt jeden Fall.64* **Client-Telemetrie auf anderen Gateways**: Ob Claude Code den optionalen Client-Telemetrie-Stream sendet, hängt von Ihrem Anbieter ab, und die [Telemetrie-Standardtabelle](https://code.claude.com/docs/de/data-usage.md#default-behaviors-by-api-provider) behandelt jeden Fall.

65* **Telemetrie-Ziele**: Wohin Claude Code die Telemetrie einer Gateway-Sitzung sendet, hängt davon ab, wie sich die Sitzung angemeldet hat, und [Was wird bei Entwicklern durchgesetzt](https://code.claude.com/docs/de/claude-apps-gateway#whats-enforced-on-developers) sagt, wohin die Exporte jeder Art von Sitzung gehen.65* **Telemetrie-Ziele**: Wohin Claude Code die Telemetrie einer Gateway-Sitzung sendet, hängt davon ab, wie sich die Sitzung angemeldet hat, und [Was wird bei Entwicklern durchgesetzt](https://code.claude.com/docs/de/claude-apps-gateway#whats-enforced-on-developers) sagt, wohin die Exporte jeder Art von Sitzung gehen.

66* **Unternehmens-HTTP-Proxies**: Ein `HTTPS_PROXY` sitzt zwischen Claude Code und jedem Server, mit dem es spricht, einschließlich des Gateways. Wenn Ihr Netzwerk einen benötigt, [konfigurieren Sie den Proxy](https://code.claude.com/docs/de/network-config.md) zusätzlich zum Gateway. Für ein Claude apps Gateway, das Sie hosten, [überprüft die Anmeldung, dass der Proxy-Host auch in einem privaten Netzwerk ist](https://code.claude.com/docs/de/claude-apps-gateway#prerequisites); wenn nicht, fügen Sie den Gateway-Host zu `NO_PROXY` hinzu, damit die CLI sich direkt mit ihm verbindet.66* **Unternehmens-HTTP-Proxys**: Claude Code sendet seine Anfragen, einschließlich derer an das Gateway, über den Proxy in `HTTPS_PROXY`. Wenn Ihr Netzwerk einen Proxy erfordert, [konfigurieren Sie ihn](https://code.claude.com/docs/de/network-config.md). Wenn der Proxy für ein Claude apps Gateway gilt, das Sie hosten, erfordert die [Anmeldung](https://code.claude.com/docs/de/claude-apps-gateway#prerequisites), dass der Hostname des Proxys in private Adressen aufgelöst wird oder dass der Gateway-Host in `NO_PROXY` steht.

67 67

68## Nächste Schritte68## Nächste Schritte

69 69

github-actions-cloud-providers.md +3 −3

Details

84> Erstellen Sie eine Microsoft Entra-Anwendung mit einer Verbundberechtigung für Ihr Repository, indem Sie [Microsofts Anleitung zur Authentifizierung von GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect) befolgen:84> Erstellen Sie eine Microsoft Entra-Anwendung mit einer Verbundberechtigung für Ihr Repository, indem Sie [Microsofts Anleitung zur Authentifizierung von GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect) befolgen:

85>85>

86> * Registrieren Sie eine Microsoft Entra-Anwendung und fügen Sie eine Verbundidentitätsberechtigung hinzu, die Tokens vertraut, die GitHub für Ihr Repository ausstellt. Eine benutzerzugewiesene verwaltete Identität funktioniert anstelle einer Anwendung. Beide haben die Client-ID, die Sie unten notieren86> * Registrieren Sie eine Microsoft Entra-Anwendung und fügen Sie eine Verbundidentitätsberechtigung hinzu, die Tokens vertraut, die GitHub für Ihr Repository ausstellt. Eine benutzerzugewiesene verwaltete Identität funktioniert anstelle einer Anwendung. Beide haben die Client-ID, die Sie unten notieren

87> * Weisen Sie der Anwendung die Rolle `Azure AI User` auf Ihrer Foundry-Ressource zu. Siehe [Azure RBAC-Konfiguration](https://code.claude.com/docs/de/microsoft-foundry.md#azure-rbac-configuration) für eine engere benutzerdefinierte Rolle87> * Weisen Sie der Anwendung die Rolle `Foundry User` auf Ihrer Foundry-Ressource zu. Siehe [Azure RBAC-Konfiguration](https://code.claude.com/docs/de/microsoft-foundry.md#azure-rbac-configuration) für die andere integrierte Rolle und benutzerdefinierte Rollen

88>88>

89> Notieren Sie sich die Client-ID der Anwendung, Ihre Mandanten-ID und Ihre Abonnement-ID. Sie fügen sie als Geheimnisse im nächsten Schritt hinzu.89> Notieren Sie sich die Client-ID der Anwendung, Ihre Mandanten-ID und Ihre Abonnement-ID. Sie fügen sie als Geheimnisse im nächsten Schritt hinzu.

90 90

109 109

110Wenn Sie im ersten Schritt eine andere GitHub-Identität gewählt haben, passen Sie das Beispiel an:110Wenn Sie im ersten Schritt eine andere GitHub-Identität gewählt haben, passen Sie das Beispiel an:

111 111

112* **Offizielle Claude GitHub App**: löschen Sie den Schritt „Generate GitHub App token" und die Zeile `github_token`112* **Offizielle Claude GitHub App**: löschen Sie den Schritt „Generate GitHub App token“ und die Zeile `github_token`

113* **GitHub's automatisches Token**: löschen Sie den Token-Generierungsschritt und ändern Sie die Zeile `github_token` in `github_token: ${{ secrets.GITHUB_TOKEN }}`113* **GitHub's automatisches Token**: löschen Sie den Token-Generierungsschritt und ändern Sie die Zeile `github_token` in `github_token: ${{ secrets.GITHUB_TOKEN }}`

114 114

115> [!WARNING]115> [!WARNING]

291 291

292**5. Testen Sie die Einrichtung**292**5. Testen Sie die Einrichtung**

293 293

294Erwähnen Sie `@claude` in einem Issue- oder PR-Kommentar, und beobachten Sie dann die Ausführung auf der Registerkarte „Actions" des Repositories. Claude antwortet in einem Kommentar zum gleichen Issue oder PR.294Erwähnen Sie `@claude` in einem Issue- oder PR-Kommentar, und beobachten Sie dann die Ausführung auf der Registerkarte „Actions“ des Repositories. Claude antwortet in einem Kommentar zum gleichen Issue oder PR.

295 295

296## Fehlerbehebung296## Fehlerbehebung

297 297

google-vertex-ai.md +8 −3

Details

228 228

229### Wenn ein Modell während der Sitzung deaktiviert wird229### Wenn ein Modell während der Sitzung deaktiviert wird

230 230

231Wenn Ihr Projekt den Zugriff auf das Modell verliert, auf dem Ihre Sitzung läuft, beispielsweise weil ein Administrator es im [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) deaktiviert, wechselt Claude Code die Sitzung zu einem anderen Modell, anstatt jede Anfrage fehlschlagen zu lassen, und zeigt `Switched to <fallback> because <model> is not available` an. Es versucht die gleichen Modelle wie das Startup-Fallback: frühere Versionen der gleichen Stufe zuerst und für eine Opus-Sitzung ohne verfügbare Opus-Version das Standard-Sonnet-Modell.231Wenn Agent Platform das Modell Ihrer Sitzung als in Ihrem Projekt oder Ihrer Region nicht verfügbar ablehnt, wechselt Claude Code Ihre Sitzung zu einem anderen Modell, und Sie können weiterarbeiten. Sie sehen eine Meldung, die mit `Switched to <fallback> because <model> is not available` beginnt. Dies geschieht beispielsweise, wenn ein Administrator das Modell im [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) deaktiviert oder es in Ihrer Region nicht bereitgestellt wird.

232 232

233Der Wechsel gilt nur für eine Stufe, die Sie nicht fixiert haben, die gleiche Bedingung wie das Startup-Fallback. Eine Sitzung auf einer bestimmten Version, die Sie ausgewählt haben, behält ihr Modell bei und ohne eine Fallback-Modellkette schlägt die Anfrage stattdessen fehl. Im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) wechselt Claude Code nur zu einem Modell, das der Auto-Modus auf Agent Platform unterstützt. Wenn auch keines dieser Modelle verfügbar ist, schlägt die Anfrage fehl.233Wenn Sie eine [Fallback-Modellkette](https://code.claude.com/docs/de/model-config.md#fallback-model-chains) konfiguriert haben, wechselt Claude Code stattdessen zu Ihrem konfigurierten Fallback. Ohne eine Kette schlägt die Anfrage beispielsweise in diesen Fällen fehl:

234 234

235Eine [Fallback-Modellkette](https://code.claude.com/docs/de/model-config.md#fallback-model-chains), die Sie konfigurieren, ersetzt den Stufenwechsel: Bei diesen Ablehnungen wechselt Claude Code stattdessen zu Ihrem konfigurierten Fallback. Um abgelehnte Anfragen fehlschlagen zu lassen, anstatt zu wechseln, setzen Sie [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/de/env-vars). Eine Fallback-Kette, die Sie konfiguriert haben, wechselt immer noch bei diesen Ablehnungen; entfernen Sie auch die Kette, wenn Sie möchten, dass jede abgelehnte Anfrage fehlschlägt.235* Ihre Sitzung läuft auf einem fixierten Modell oder einer bestimmten Version, die Sie ausgewählt haben

236* Keines der [Modelle, die Claude Code versucht](#startup-model-checks), ist verfügbar. Im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) wechselt Claude Code nur zu einem Modell, das der Auto-Modus auf Agent Platform unterstützt.

237

238Um weiterzuarbeiten, führen Sie `/model` in der Sitzung aus und drücken Sie `s` bei einem Modell, das in Ihrem Projekt und Ihrer Region verfügbar ist. Ihr Standard bleibt dabei unverändert.

239

240Um abgelehnte Anfragen fehlschlagen zu lassen, anstatt zu wechseln, setzen Sie [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/de/env-vars). Wenn Sie eine Fallback-Modellkette konfiguriert haben, entfernen Sie diese ebenfalls, da Claude Code sonst weiterhin zu diesem Fallback wechselt.

236 241

237## IAM-Konfiguration242## IAM-Konfiguration

238 243

hooks.md +9 −3

Details

3000 3000

3001Läuft, wenn sich während einer Sitzung eine Konfigurationsdatei ändert. Verwenden Sie dies, um Änderungen an Einstellungen zu prüfen, Sicherheitsrichtlinien durchzusetzen oder nicht autorisierte Änderungen an Konfigurationsdateien zu blockieren.3001Läuft, wenn sich während einer Sitzung eine Konfigurationsdatei ändert. Verwenden Sie dies, um Änderungen an Einstellungen zu prüfen, Sicherheitsrichtlinien durchzusetzen oder nicht autorisierte Änderungen an Konfigurationsdateien zu blockieren.

3002 3002

3003Claude Code führt ConfigChange-Hooks aus, wenn sich eine Einstellungsdatei, eine verwaltete Richtliniendatei oder eine Skill-Datei ändert. Bei verwalteten Richtlinien führt es sie nur aus, wenn sich `managed-settings.json` oder eine Datei in `managed-settings.d/` ändert. [Servergesteuerte Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) sowie Änderungen an verwalteten macOS-Einstellungen oder Windows-Registry-Richtlinien übernimmt es, ohne die Hooks auszuführen. Unter WSL mit [`wslInheritsWindowsSettings`](https://code.claude.com/docs/de/settings-reference#wslinheritswindowssettings) übernimmt es außerdem eine geänderte Windows-seitige verwaltete Einstellungsdatei bei seiner Richtlinienabfrage, ohne die Hooks auszuführen.3003Claude Code führt ConfigChange-Hooks aus, wenn sich eine Einstellungsdatei, eine verwaltete Richtliniendatei oder eine Skill-Datei ändert. Bei verwalteten Richtlinien führt es sie nur aus, wenn sich `managed-settings.json` oder eine Datei in `managed-settings.d/` ändert.

3004 3004

3005Der Matcher filtert nach der Konfigurationsquelle:3005Der Matcher filtert nach der Konfigurationsquelle:

3006 3006

3014 3014

3015Dieses Beispiel protokolliert alle Konfigurationsänderungen für Sicherheitsaudits:3015Änderungen wie diese werden wirksam, ohne dass die Hooks ausgeführt werden:

3016

3017* Regeln und Einstellungen, die Sie mit **Yes, and don't ask again**, `/permissions` oder `/model` speichern, in der Sitzung, aus der Sie sie gespeichert haben. Wenn eine andere geöffnete Sitzung dieselbe Datei lädt, werden die Hooks dort ausgeführt.

3018* Aktualisierungen von [serververwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md), verwalteten macOS-Einstellungen oder Windows-Registry-Richtlinien

3019* Unter WSL mit [`wslInheritsWindowsSettings`](https://code.claude.com/docs/de/settings-reference#wslinheritswindowssettings) eine geänderte Datei mit verwalteten Einstellungen auf der Windows-Seite, die Claude Code bei seiner Richtlinienabfrage übernimmt

3020

3021Dieses Beispiel protokolliert Konfigurationsänderungen für Sicherheitsaudits:

3016 3022

3017```json theme={null}3023```json theme={null}

3018{3024{

3335 "hooks": [3341 "hooks": [

3336 {3342 {

3337 "type": "command",3343 "type": "command",

3338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3344 "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"

3339 }3345 }

3340 ]3346 ]

3341 }3347 }

hooks-guide.md +3 −3

Details

50 "PostToolUse": [50 "PostToolUse": [

51 {51 {

52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",

~~53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]~~53 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]

54 }54 }

55 ],55 ],

56 "Notification": [56 "Notification": [

221 "hooks": [221 "hooks": [

222 {222 {

223 "type": "command",223 "type": "command",

224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"224 "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""

225 }225 }

226 ]226 ]

227 }227 }

336 336

337Verfolgen Sie, wann sich Einstellungs- oder Skill-Dateien während einer Sitzung ändern. Das Event `ConfigChange` wird ausgelöst, wenn ein externer Prozess oder Editor eine Konfigurationsdatei ändert, sodass Sie Änderungen für Compliance-Zwecke protokollieren oder nicht autorisierte Änderungen blockieren können.337Verfolgen Sie, wann sich Einstellungs- oder Skill-Dateien während einer Sitzung ändern. Das Event `ConfigChange` wird ausgelöst, wenn ein externer Prozess oder Editor eine Konfigurationsdatei ändert, sodass Sie Änderungen für Compliance-Zwecke protokollieren oder nicht autorisierte Änderungen blockieren können.

338 338

339Dieses Beispiel hängt jede Änderung an ein Audit-Log an. Fügen Sie Folgendes zu `~/.claude/settings.json` hinzu:339Dieses Beispiel hängt jedes Event an ein Audit-Log an. Fügen Sie Folgendes zu `~/.claude/settings.json` hinzu:

340 340

341```json theme={null}341```json theme={null}

342{342{

interactive-mode.md +3 −7

Details

36| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Werkzeugaufruf in der Mitte des Zuges, damit Sie umleiten können. Claude behält die bisherige Arbeit bei. Wenn Sie [Nachrichten in der Warteschlange haben](#queue-messages-while-claude-works), sendet Claude Code diese als nächstes. Wenn ein Dialog offen ist, schließt `Esc` den Dialog. Während ein Fußzeilenelement ausgewählt ist, wie eine Zeile im [Subagenten-Panel](https://code.claude.com/docs/de/sub-agents.md#run-subagents-in-foreground-or-background) unter der Eingabeaufforderung, [hebt `Esc` die Auswahl auf](https://code.claude.com/docs/de/keybindings#footer-actions), anstatt zu unterbrechen. Bei einer Berechtigungsaufforderung lehnt `Esc` die Aktion ab, genauso wie [**Nein** ohne Kommentar](https://code.claude.com/docs/de/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |36| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Werkzeugaufruf in der Mitte des Zuges, damit Sie umleiten können. Claude behält die bisherige Arbeit bei. Wenn Sie [Nachrichten in der Warteschlange haben](#queue-messages-while-claude-works), sendet Claude Code diese als nächstes. Wenn ein Dialog offen ist, schließt `Esc` den Dialog. Während ein Fußzeilenelement ausgewählt ist, wie eine Zeile im [Subagenten-Panel](https://code.claude.com/docs/de/sub-agents.md#run-subagents-in-foreground-or-background) unter der Eingabeaufforderung, [hebt `Esc` die Auswahl auf](https://code.claude.com/docs/de/keybindings#footer-actions), anstatt zu unterbrechen. Bei einer Berechtigungsaufforderung lehnt `Esc` die Aktion ab, genauso wie [**Nein** ohne Kommentar](https://code.claude.com/docs/de/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |

37| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Prompt-Eingabe Text enthält, löscht doppeltes `Esc` diesen und speichert den Entwurf im Verlauf, damit `Up` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](https://code.claude.com/docs/de/checkpointing.md), um Code und Konversation von einem früheren Punkt wiederherzustellen oder zusammenzufassen |37| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Prompt-Eingabe Text enthält, löscht doppeltes `Esc` diesen und speichert den Entwurf im Verlauf, damit `Up` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](https://code.claude.com/docs/de/checkpointing.md), um Code und Konversation von einem früheren Punkt wiederherzustellen oder zusammenzufassen |

38| `Ctrl+Enter` oder `Ctrl+X Ctrl+S` | Warteschlangen-Nachrichten jetzt senden | Sendet Ihre [Nachrichten in der Warteschlange](#queue-messages-while-claude-works) und Ihren Entwurf mit ihnen sofort. [Wenn Claude Code das sendet, das Sie in die Warteschlange eingereiht haben](#when-claude-code-sends-what-you-queued) behandelt, was mit dem Zug passiert, an dem Claude arbeitet. Im [Shell-Modus](#shell-mode-with-prefix) reiht der Schlüssel Ihren Befehl nur in die Warteschlange ein. In Terminals, die erweiterte Tasten nicht melden, kommt `Ctrl+Enter` als einfaches `Enter` an; `Ctrl+X Ctrl+S` funktioniert in jedem Terminal. Erfordert Claude Code v2.1.275 oder später |38| `Ctrl+Enter` oder `Ctrl+X Ctrl+S` | Warteschlangen-Nachrichten jetzt senden | Sendet Ihre [Nachrichten in der Warteschlange](#queue-messages-while-claude-works) und Ihren Entwurf mit ihnen sofort. [Wenn Claude Code das sendet, das Sie in die Warteschlange eingereiht haben](#when-claude-code-sends-what-you-queued) behandelt, was mit dem Zug passiert, an dem Claude arbeitet. Im [Shell-Modus](#shell-mode-with-prefix) reiht der Schlüssel Ihren Befehl nur in die Warteschlange ein. In Terminals, die erweiterte Tasten nicht melden, kommt `Ctrl+Enter` als einfaches `Enter` an; `Ctrl+X Ctrl+S` funktioniert in jedem Terminal. Erfordert Claude Code v2.1.275 oder später |

39| `Shift+Tab` oder `Alt+M` unter Windows, wenn die Node- oder Bun-Laufzeit den VT-Eingabemodus nicht aktiviert | Berechtigungsmodi durchlaufen | Durchlaufen Sie `default` (im Modusindikator als Manuell gekennzeichnet), `acceptEdits`, `plan` und, falls verfügbar, `bypassPermissions` und dann `auto`. Von `auto` wechselt der erste Druck zu `default`. Siehe [Berechtigungsmodi](https://code.claude.com/docs/de/permission-modes.md). Bei einer Dateiberechtigungsaufforderung schließt dieselbe Taste ein offenes [Kommentarfeld](https://code.claude.com/docs/de/permissions.md#add-a-comment-when-you-answer-a-permission-prompt). Ohne offenes Feld wählt es die Option aus, die die Aktion für den Rest der Sitzung ermöglicht, wenn die Aufforderung diese Option anbietet |39| `Shift+Tab` oder `Alt+M` unter Windows, wenn die Node- oder Bun-Laufzeit den VT-Eingabemodus nicht aktiviert | Berechtigungsmodi durchlaufen | Durchlaufen Sie `default` (im Modusindikator als Manual gekennzeichnet), `acceptEdits` und `plan`, dann, sofern verfügbar, `bypassPermissions` und `auto`. Siehe [Berechtigungsmodi](https://code.claude.com/docs/de/permission-modes.md). Bei einer Dateiberechtigungsabfrage schließt dieselbe Taste ein offenes [Kommentarfeld](https://code.claude.com/docs/de/permissions.md#add-a-comment-when-you-answer-a-permission-prompt). Ohne offenes Feld wählt sie die Option aus, die die Aktion für den Rest der Sitzung erlaubt, sofern die Abfrage diese Option anbietet. Bei der Abfrage zur Plan-Genehmigung genehmigt sie den Plan |

41| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Extended Thinking umschalten | Aktivieren oder deaktivieren Sie den Thinking-Modus. Hat keine Auswirkung auf Opus 5.5, Sonnet 5.5, Haiku 5.5 oder die Fable-Modelle, die immer Extended Thinking verwenden. Funktioniert auf macOS ohne Konfiguration von Option als Meta |41| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Extended Thinking umschalten | Aktivieren oder deaktivieren Sie den Thinking-Modus. Hat keine Auswirkung auf Opus 5.5, Sonnet 5.5, Haiku 5.5 oder die Fable-Modelle, die immer Extended Thinking verwenden. Funktioniert auf macOS ohne Konfiguration von Option als Meta |

81| :- | :- | :- |81| :- | :- | :- |

84| Shift+Enter | `Shift+Enter` | Nativ in iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal. Für andere Terminals siehe [Mehrzeilige Eingabeaufforderungen eingeben](https://code.claude.com/docs/de/terminal-config.md#enter-multiline-prompts) |84| Shift+Enter | `Shift+Enter` | Nativ in iTerm2, WezTerm, Ghostty, Kitty, Warp, Windows Terminal. Für andere Terminals siehe [Mehrzeilige Eingabeaufforderungen eingeben](https://code.claude.com/docs/de/terminal-config.md#enter-multiline-prompts) |

87 87

137 137

138Aktivieren Sie Vim-ähnliche Bearbeitung über `/config` → Editor mode.138Aktivieren Sie Vim-ähnliche Bearbeitung über `/config` → Editor mode.

139 139

140Claude Code behält Ihren Vim-Modus und die Cursorposition bei, wenn Sie den [Transcript Viewer](#transcript-viewer) mit `Ctrl+O` umschalten oder ein Panel wie `/config` öffnen und schließen. Wenn Sie die Eingabeaufforderung im NORMAL-Modus verlassen, ist sie immer noch im NORMAL-Modus, wenn Sie zurückkehren, mit dem Cursor dort, wo Sie ihn verlassen haben.

~~141~~

142### Moduswechsel140### Moduswechsel

143 141

302 * Drücken Sie `Ctrl+C`, um abzubrechen und Ihre ursprüngliche Eingabe wiederherzustellen300 * Drücken Sie `Ctrl+C`, um abzubrechen und Ihre ursprüngliche Eingabe wiederherzustellen

303 * Drücken Sie `Backspace` bei leerer Suche, um abzubrechen301 * Drücken Sie `Backspace` bei leerer Suche, um abzubrechen

304 302

305Das Übernehmen eines Treffers oder das Abbrechen der Suche wird sofort wirksam, auch wenn Claude Code den Verlauf noch lädt.

~~306~~

307Um einen früheren Prompt zu finden, wenn Sie sich nur noch an einen langen eingefügten Inhalt darin erinnern, etwa ein Fehler-Log, drücken Sie `Ctrl+R` und geben Sie ein Wort aus dem eingefügten Inhalt ein. Erfordert Claude Code v2.1.314 oder höher.303Um einen früheren Prompt zu finden, wenn Sie sich nur noch an einen langen eingefügten Inhalt darin erinnern, etwa ein Fehler-Log, drücken Sie `Ctrl+R` und geben Sie ein Wort aus dem eingefügten Inhalt ein. Erfordert Claude Code v2.1.314 oder höher.

308 304

309## Bash-Befehle im Hintergrund305## Bash-Befehle im Hintergrund

600 596

601### Was Claude Code unterstreicht597### Was Claude Code unterstreicht

602 598

603Kurz nachdem Sie mit der Eingabe pausieren, unterstreicht Claude Code die Wörter, die das Wörterbuch nicht kennt. Es lässt das Wort, das Sie noch eingeben, allein, bis Sie es verlassen, und es ändert niemals Ihren Text. Es überspringt auch Text, der wie Code aussieht:599Kurz nachdem Sie mit der Eingabe pausieren, unterstreicht Claude Code die Wörter, die das Wörterbuch nicht kennt. Es lässt das Wort, das Sie noch eingeben, unberührt, bis Sie es verlassen. Es überspringt auch Text, der wie Code aussieht:

604 600

605* Befehle wie `/help`, `@`-Erwähnungen, URLs, Dateipfade und Flags wie `--verbose`601* Befehle wie `/help`, `@`-Erwähnungen, URLs, Dateipfade und Flags wie `--verbose`

606* Wörter mit Ziffern, Unterstrichen oder einem Großbuchstaben nach dem ersten, und Text in Backticks602* Wörter mit Ziffern, Unterstrichen oder einem Großbuchstaben nach dem ersten, und Text in Backticks

keybindings.md +6 −1

Details

581 581

582Claude Code bindet diese Standard-Akkorde auf dem `ctrl+x`-Präfix, nach Kontext:582Claude Code bindet diese Standard-Akkorde auf dem `ctrl+x`-Präfix, nach Kontext:

583 583

584* `Chat`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s` und `ctrl+x tab`584* `Chat`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s`, `ctrl+x tab`, `ctrl+x ctrl+=`, `ctrl+x ctrl+-`, `ctrl+x ctrl+_`, `ctrl+x =` und `ctrl+x -`

585* `Task`: `ctrl+x ctrl+b`585* `Task`: `ctrl+x ctrl+b`

586* `DiffPanel`: `ctrl+x b`586* `DiffPanel`: `ctrl+x b`

587* `Pane`: `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` und `ctrl+x x`587* `Pane`: `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` und `ctrl+x x`

631 "ctrl+x ctrl+a": null,631 "ctrl+x ctrl+a": null,

632 "ctrl+x ctrl+s": null,632 "ctrl+x ctrl+s": null,

633 "ctrl+x tab": null,633 "ctrl+x tab": null,

634 "ctrl+x ctrl+=": null,

635 "ctrl+x ctrl+-": null,

636 "ctrl+x ctrl+_": null,

637 "ctrl+x =": null,

638 "ctrl+x -": null,

634 "ctrl+x": "chat:newline"639 "ctrl+x": "chat:newline"

635 }640 }

636 }641 }

llm-gateway-connect.md +3 −2

Details

156 156

157### Konflikte mit einem vorhandenen Login157### Konflikte mit einem vorhandenen Login

158 158

159Eine Gateway-Anmeldedaten-Variable hat Vorrang vor einem gespeicherten claude.ai-Login oder Console-Schlüssel. Mit `ANTHROPIC_AUTH_TOKEN` hat die Variable sofort Vorrang. Mit `ANTHROPIC_API_KEY` werden Sie einmal im interaktiven Modus aufgefordert, den Schlüssel zu genehmigen, bevor er übernimmt.159Ihre Anfragen verwenden eine Gateway-Anmeldedaten-Variable statt eines gespeicherten claude.ai-Logins. Mit `ANTHROPIC_AUTH_TOKEN` hat die Variable sofort Vorrang. Mit `ANTHROPIC_API_KEY` werden Sie einmal im interaktiven Modus aufgefordert, den Schlüssel zu genehmigen, bevor er übernimmt.

160 160

161Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedaten-Quelle aktiv ist. Wenn der Start eine Auth-Konflikt-Warnung anzeigt, die zwei Quellen benennt, siehe die erste Zeile der [Fehlerbehebungstabelle](#troubleshoot-gateway-errors), um zu sehen, welche zu löschen ist. Um einen gespeicherten Login zu löschen, damit nur die Gateway-Anmeldedaten verbleiben, führen Sie `/logout` aus.161Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedaten-Quelle aktiv ist. Wenn der Start eine Auth-Konflikt-Warnung anzeigt, die zwei Quellen benennt, siehe die erste Zeile der [Fehlerbehebungstabelle](#troubleshoot-gateway-errors), um zu sehen, welche zu löschen ist. Um einen gespeicherten Login zu löschen, damit nur die Gateway-Anmeldedaten verbleiben, führen Sie `/logout` aus.

162 162

506 506

508| :- | :- | :- |508| :- | :- | :- |

509| Eine Start-Warnung, die zwei Anmeldedaten-Quellen benennt und mit `auth may not work as expected` endet. Ältere Versionen zeigen stattdessen `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` an. | Eine Gateway-Anmeldedaten und ein gespeicherter Login sind beide aktiv; die Variable wird für Anfragen verwendet, aber der veraltete Login kann zu unerwartetem Auth-Verhalten führen | Heben Sie die Festlegung der Variable auf, um den gespeicherten Login zu verwenden, oder führen Sie `/logout` aus, um die Gateway-Anmeldedaten zu verwenden |509| Eine Start-Warnung, die zwei Anmeldedaten-Quellen benennt und mit `auth may not work as expected` endet. Ältere Versionen zeigen stattdessen `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` an. | Gateway-Anmeldedaten und ein gespeicherter Login sind beide aktiv | Heben Sie die Festlegung der Variable auf, um den gespeicherten Login zu verwenden, oder führen Sie `/logout` aus, um die Gateway-Anmeldedaten zu verwenden |

510| `401`-Fehler, die ein ungültiges oder nicht erkanntes Token benennen | Die Anmeldedaten sind nicht eine, die das Gateway ausgestellt hat, oder sie sind in einem Header, den das Gateway nicht liest | Bestätigen Sie, dass die Variable Ihrer Anmeldedaten-Art in der [Anmeldedaten-Tabelle](#set-the-credential-variable) entspricht, und generieren Sie den Schlüssel beim Gateway neu, wenn er widerrufen wurde |510| `401`-Fehler, die ein ungültiges oder nicht erkanntes Token benennen | Die Anmeldedaten sind nicht eine, die das Gateway ausgestellt hat, oder sie sind in einem Header, den das Gateway nicht liest | Bestätigen Sie, dass die Variable Ihrer Anmeldedaten-Art in der [Anmeldedaten-Tabelle](#set-the-credential-variable) entspricht, und generieren Sie den Schlüssel beim Gateway neu, wenn er widerrufen wurde |

511| `Your apiKeyHelper script is failing`, oder `apiKeyHelper failed:` auf stderr im nicht-interaktiven Modus | Der Befehl in der [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Einstellung hat keinen verwendbaren Schlüssel erzeugt, daher enthalten Anfragen einen Platzhalter-Schlüssel | Führen Sie den Befehl direkt aus, um zu sehen, warum er fehlschlägt, und authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, wenn dieser eine abgelaufene Sitzung meldet; siehe [die Fehlerreferenz](https://code.claude.com/docs/de/errors.md#your-apikeyhelper-script-is-failing) |511| `Your apiKeyHelper script is failing`, oder `apiKeyHelper failed:` auf stderr im nicht-interaktiven Modus | Der Befehl in der [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Einstellung hat keinen verwendbaren Schlüssel erzeugt, daher enthalten Anfragen einen Platzhalter-Schlüssel | Führen Sie den Befehl direkt aus, um zu sehen, warum er fehlschlägt, und authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, wenn dieser eine abgelaufene Sitzung meldet; siehe [die Fehlerreferenz](https://code.claude.com/docs/de/errors.md#your-apikeyhelper-script-is-failing) |

512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` wenn nichts unter der Adresse antwortet, oder `Can't reach the API server — check your internet or DNS (ENOTFOUND)` wenn der Hostname nicht aufgelöst wird, oft nach einer stillen Pause, während Claude Code [mit Backoff erneut versucht](https://code.claude.com/docs/de/errors.md#automatic-retries). Der Code in Klammern variiert; [Unable to connect to API](https://code.claude.com/docs/de/errors.md#unable-to-connect-to-api) behandelt die Code-Schreibweisen und die frühere Formulierung | Nichts antwortete unter der Basis-URL: Die Adresse ist falsch, oder ein VPN oder eine Firewall blockiert den Pfad zum Gateway | Führen Sie den [curl-Test oben](#verify-the-connection) aus, der sofort mit der gleichen Ursache fehlschlägt, und bestätigen Sie die URL und den Netzwerkpfad mit Ihrem Gateway-Team |512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` wenn nichts unter der Adresse antwortet, oder `Can't reach the API server — check your internet or DNS (ENOTFOUND)` wenn der Hostname nicht aufgelöst wird, oft nach einer stillen Pause, während Claude Code [mit Backoff erneut versucht](https://code.claude.com/docs/de/errors.md#automatic-retries). Der Code in Klammern variiert; [Unable to connect to API](https://code.claude.com/docs/de/errors.md#unable-to-connect-to-api) behandelt die Code-Schreibweisen und die frühere Formulierung | Nichts antwortete unter der Basis-URL: Die Adresse ist falsch, oder ein VPN oder eine Firewall blockiert den Pfad zum Gateway | Führen Sie den [curl-Test oben](#verify-the-connection) aus, der sofort mit der gleichen Ursache fehlschlägt, und bestätigen Sie die URL und den Netzwerkpfad mit Ihrem Gateway-Team |

520| `/fast` meldet `Fast mode unavailable due to network connectivity issues` während Inferenz-Anfragen funktionieren | Die Verfügbarkeitsprüfung für den [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md) geht direkt zu `api.anthropic.com` und folgt nicht `ANTHROPIC_BASE_URL`, daher schlägt blockierter direkter Ausgang die Prüfung fehl | Nehmen Sie `api.anthropic.com` in die Allowlist auf, wenn Ausgang blockiert ist, oder legen Sie eine Skip-Variable fest. Siehe [Fast-Modus hinter Proxys und LLM-Gateways verwenden](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |520| `/fast` meldet `Fast mode unavailable due to network connectivity issues` während Inferenz-Anfragen funktionieren | Die Verfügbarkeitsprüfung für den [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md) geht direkt zu `api.anthropic.com` und folgt nicht `ANTHROPIC_BASE_URL`, daher schlägt blockierter direkter Ausgang die Prüfung fehl | Nehmen Sie `api.anthropic.com` in die Allowlist auf, wenn Ausgang blockiert ist, oder legen Sie eine Skip-Variable fest. Siehe [Fast-Modus hinter Proxys und LLM-Gateways verwenden](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

521| `/fast` meldet `Fast mode is currently unavailable` in einer Sitzung, die sich mit einem vom Gateway ausgestellten Schlüssel in `ANTHROPIC_API_KEY` authentifiziert | Solange `ANTHROPIC_BASE_URL` auf Ihr Gateway zeigt und der Schlüssel nicht im Format eines Anthropic-API-Schlüssels vorliegt, sendet Claude Code die Verfügbarkeitsprüfung für den [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md) nicht. Ohne eine zwischengespeicherte frühere erfolgreiche Prüfung behandelt es den Fast-Modus als nicht verfügbar | Legen Sie `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` fest; siehe [Fast-Modus hinter Proxys und LLM-Gateways verwenden](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |521| `/fast` meldet `Fast mode is currently unavailable` in einer Sitzung, die sich mit einem vom Gateway ausgestellten Schlüssel in `ANTHROPIC_API_KEY` authentifiziert | Solange `ANTHROPIC_BASE_URL` auf Ihr Gateway zeigt und der Schlüssel nicht im Format eines Anthropic-API-Schlüssels vorliegt, sendet Claude Code die Verfügbarkeitsprüfung für den [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md) nicht. Ohne eine zwischengespeicherte frühere erfolgreiche Prüfung behandelt es den Fast-Modus als nicht verfügbar | Legen Sie `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` fest; siehe [Fast-Modus hinter Proxys und LLM-Gateways verwenden](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

522| `/fast` meldet `Fast mode has been disabled by your organization` in einer Sitzung, die mit `ANTHROPIC_AUTH_TOKEN` authentifiziert ist, obwohl die Organisation den Fast-Modus aktiviert hat | Die Verfügbarkeitsprüfung erfordert einen claude.ai-Login oder einen API-Schlüssel; mit nur einem Bearer-Token behandelt Claude Code den Fast-Modus als deaktiviert, ohne die Prüfung zu senden | Legen Sie `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` fest; siehe [Fast-Modus hinter Proxys und LLM-Gateways verwenden](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |522| `/fast` meldet `Fast mode has been disabled by your organization` in einer Sitzung, die mit `ANTHROPIC_AUTH_TOKEN` authentifiziert ist, obwohl die Organisation den Fast-Modus aktiviert hat | Die Verfügbarkeitsprüfung erfordert einen claude.ai-Login oder einen API-Schlüssel; mit nur einem Bearer-Token behandelt Claude Code den Fast-Modus als deaktiviert, ohne die Prüfung zu senden | Legen Sie `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` fest; siehe [Fast-Modus hinter Proxys und LLM-Gateways verwenden](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

523| `/feedback` speichert eine lokale Datei in einer Sitzung, die `ANTHROPIC_BASE_URL` verwendet | Hinter einem Gateway sind `ANTHROPIC_AUTH_TOKEN` und ein Schlüssel, der nicht im Format eines Anthropic-API-Schlüssels vorliegt, keine Anthropic-Anmeldedaten. Ohne solche Anmeldedaten schreibt Claude Code den Bericht in ein lokales Archiv unter `~/.claude/feedback-bundles/`, anstatt ihn zu senden | Senden Sie die Datei an Ihren Anthropic-Account-Ansprechpartner oder hängen Sie sie an eine Support-Anfrage an. Siehe [Telemetriedienste](https://code.claude.com/docs/de/data-usage.md#telemetry-services) |

523| Claude Code fordert Sie auf, sich anzumelden, obwohl der [curl-Test](#verify-the-connection) erfolgreich ist | Die CLI hat keine eigene Anmeldedaten: Eine erreichbare Basis-URL ist keine, und in einer interaktiven Sitzung gilt ein `env`-Block in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` nur nach dem First-Run-Wizard und der [Vertrauensaufforderung](https://code.claude.com/docs/de/permissions.md#what-runs-before-you-trust-a-folder) | Legen Sie `ANTHROPIC_AUTH_TOKEN` irgendwo fest, wo Claude Code vor dem First-Run-Setup liest: ein Shell-Export, der `env`-Block in `~/.claude/settings.json` oder verwaltete Einstellungen |524| Claude Code fordert Sie auf, sich anzumelden, obwohl der [curl-Test](#verify-the-connection) erfolgreich ist | Die CLI hat keine eigene Anmeldedaten: Eine erreichbare Basis-URL ist keine, und in einer interaktiven Sitzung gilt ein `env`-Block in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` nur nach dem First-Run-Wizard und der [Vertrauensaufforderung](https://code.claude.com/docs/de/permissions.md#what-runs-before-you-trust-a-folder) | Legen Sie `ANTHROPIC_AUTH_TOKEN` irgendwo fest, wo Claude Code vor dem First-Run-Setup liest: ein Shell-Export, der `env`-Block in `~/.claude/settings.json` oder verwaltete Einstellungen |

524| `ANTHROPIC_API_KEY` ist festgelegt, wird aber ignoriert, ohne Aufforderung | Der Schlüssel benötigt eine einmalige Genehmigung in interaktiven Sitzungen, und ein zuvor abgelehnter Schlüssel wird ohne erneute Frage ignoriert | Aktivieren Sie ihn unter `/config` mit der Option `Use custom API key` |525| `ANTHROPIC_API_KEY` ist festgelegt, wird aber ignoriert, ohne Aufforderung | Der Schlüssel benötigt eine einmalige Genehmigung in interaktiven Sitzungen, und ein zuvor abgelehnter Schlüssel wird ohne erneute Frage ignoriert | Aktivieren Sie ihn unter `/config` mit der Option `Use custom API key` |

525| `This machine's managed settings require a first-party login`, oder [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) wenn verwaltete Einstellungen `forceLoginMethod` auf `"gateway"` setzen oder auch `forceLoginGatewayUrl` setzen | Verwaltete Einstellungen enthalten `forceLoginMethod` oder `forceLoginOrgUUID`, die nicht mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` koexistieren können | Ihr Administrator muss `forceLoginMethod`, `forceLoginOrgUUID` und `forceLoginGatewayUrl` aus verwalteten Einstellungen entfernen, um Gateway-Anmeldedaten zu verwenden, oder die Gateway-Anmeldedaten entfernen und die Anmeldung verwenden, die die verwalteten Einstellungen erfordern. Die beiden können nicht kombiniert werden |526| `This machine's managed settings require a first-party login`, oder [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) wenn verwaltete Einstellungen `forceLoginMethod` auf `"gateway"` setzen oder auch `forceLoginGatewayUrl` setzen | Verwaltete Einstellungen enthalten `forceLoginMethod` oder `forceLoginOrgUUID`, die nicht mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` koexistieren können | Ihr Administrator muss `forceLoginMethod`, `forceLoginOrgUUID` und `forceLoginGatewayUrl` aus verwalteten Einstellungen entfernen, um Gateway-Anmeldedaten zu verwenden, oder die Gateway-Anmeldedaten entfernen und die Anmeldung verwenden, die die verwalteten Einstellungen erfordern. Die beiden können nicht kombiniert werden |

llm-gateway-rollout.md +5 −5

Details

142claude -p "Reply with one word: connected"142claude -p "Reply with one word: connected"

143```143```

144 144

145**Checkpoint**: der Prompt gibt eine Antwort zurück, und die Anfrage erscheint im Gateway-Log als `POST` zum `/v1/messages`-Pfad mit Status `200`. Claude Code hängt eine Query-Zeichenkette wie `?beta=true` an, daher stimmen Sie mit dem Pfad überein, nicht mit der vollständigen URL. Zwei Fehlermeldungen weisen in verschiedene Richtungen:145**Checkpoint**: der Prompt gibt eine Antwort zurück, und die Anfrage erscheint im Gateway-Log als `POST` zum `/v1/messages`-Pfad mit Status `200`. Claude Code hängt eine Query-Zeichenkette wie `?beta=true` an, gleichen Sie daher mit dem Pfad ab, nicht mit der vollständigen URL. Prüfen Sie die Fehlermeldung:

146 146

147* `Not logged in`: überprüfen Sie das Gateway-Log, um die beiden Ursachen auseinanderzuhalten. Wenn es leer ist, hat keine Anmeldedaten die Sitzung erreicht und keine Anfrage hat die Maschine verlassen; führen Sie die Exporte in der Shell aus, die Sie testen. Wenn es eine abgelehnte Anfrage mit `x-api-key` im `401`-Body zeigt, erwartet das Gateway Schlüssel in diesem Header stattdessen; wechseln Sie zu `ANTHROPIC_API_KEY`147* `Not logged in`: überprüfen Sie das Gateway-Log. Wenn es leer ist, haben keine Anmeldedaten die Sitzung erreicht und keine Anfrage hat die Maschine verlassen; führen Sie die Exporte in der Shell, aus der Sie testen, erneut aus. Wenn es ein `401` vom Gateway zeigt, das `x-api-key` benennt, erwartet das Gateway Schlüssel stattdessen in diesem Header; wechseln Sie zu `ANTHROPIC_API_KEY`. Wenn es ein `401` von `api.anthropic.com` oder dem Endpunkt Ihres Anbieters zeigt, korrigieren Sie die Anbieteranmeldedaten, die das Gateway hält

148* `Failed to authenticate. API Error: 401` bedeutet, dass eine Anmeldedaten gesendet und abgelehnt wurde, und das Gateway-Log sagt, wo: ein `401`, das `api.anthropic.com` oder Ihren Anbieter-Endpunkt benennt, bedeutet, dass das Gateway den Upstream erreicht hat, aber seine Anbieteranmeldedaten, die es hält, abgelehnt wurden, daher funktionierte der Entwicklerschlüssel und die Anbieteranmeldedaten, die das Gateway hält, sind falsch oder ein Platzhalter148* `Failed to authenticate. API Error: 401` bedeutet, dass eine Anmeldedaten gesendet und abgelehnt wurde, und das Gateway-Log sagt, wo: ein `401`, das `api.anthropic.com` oder Ihren Anbieter-Endpunkt benennt, bedeutet, dass das Gateway den Upstream erreicht hat, aber seine Anbieteranmeldedaten, die es hält, abgelehnt wurden, daher funktionierte der Entwicklerschlüssel und die Anbieteranmeldedaten, die das Gateway hält, sind falsch oder ein Platzhalter

149 149

150Eine falsche oder unerreichbare Basis-URL erzeugt ein anderes Symptom: Claude Code [versucht die Verbindung mit Backoff erneut](https://code.claude.com/docs/de/errors.md#automatic-retries) und kann mehrere Minuten ohne Ausgabe sitzen, bevor es einen Fehler meldet. Wenn der Befehl zu hängen scheint, überprüfen Sie stattdessen das Gateway-Log, anstatt zu warten; keine ankommende Anfrage bedeutet, dass `ANTHROPIC_BASE_URL` nicht auf das Gateway zeigt.150Eine falsche oder unerreichbare Basis-URL erzeugt ein anderes Symptom: Claude Code [versucht die Verbindung mit Backoff erneut](https://code.claude.com/docs/de/errors.md#automatic-retries) und kann mehrere Minuten ohne Ausgabe sitzen, bevor es einen Fehler meldet. Wenn der Befehl zu hängen scheint, überprüfen Sie stattdessen das Gateway-Log, anstatt zu warten; keine ankommende Anfrage bedeutet, dass `ANTHROPIC_BASE_URL` nicht auf das Gateway zeigt.

247 247

248Sie sollten `data:`-Zeilen inkrementell ankommen sehen. Die gesamte Antwort, die auf einmal nach einer Pause ankommt, bedeutet, dass das Gateway puffert, was Claude Code staut; ein `404` bedeutet, dass der Modellname nicht weitergeleitet wird. Wiederholen Sie pro Modellname.248Sie sollten `data:`-Zeilen inkrementell ankommen sehen. Die gesamte Antwort, die auf einmal nach einer Pause ankommt, bedeutet, dass das Gateway puffert, was Claude Code staut; ein `404` bedeutet, dass der Modellname nicht weitergeleitet wird. Wiederholen Sie pro Modellname.

249 249

250Starten Sie dann `claude` und senden Sie eine Nachricht. Jedes Symptom in diesem Schritt hat eine Ursache:250Starten Sie dann `claude`, senden Sie eine Nachricht und gleichen Sie ab, was Sie sehen:

251 251

252* Eine Login-Aufforderung bedeutet eine Anmeldedaten-Lücke. Führen Sie `/status` aus und öffnen Sie die **Status**-Registerkarte: wenn die `Setting sources`-Zeile verwaltete Einstellungen nicht enthält, hat die Verteilung die Maschine nicht erreicht; wenn sie es tut, wurde die Entwickleranmeldedaten nicht bereitgestellt, daher setzen Sie `ANTHROPIC_AUTH_TOKEN` oder den `apiKeyHelper`252* Ein Login-Bildschirm oder `Not logged in` ohne neuen Eintrag im Gateway-Log bedeutet eine Lücke bei den Anmeldedaten. Führen Sie `/status` aus und öffnen Sie die Registerkarte **Status**: wenn die Zeile `Setting sources` keine verwalteten Einstellungen enthält, hat die Verteilung die Maschine nicht erreicht; wenn sie sie enthält, wurden die Entwickleranmeldedaten nicht bereitgestellt, setzen Sie daher `ANTHROPIC_AUTH_TOKEN` oder den `apiKeyHelper`

253* `Failed to authenticate`-Fehler bedeuten, dass das Gateway Anfragen ablehnt; sein Log sagt, welche Anmeldedaten fehlgeschlagen ist. Eine Ablehnung, die das Gateway selbst protokolliert, benennt den Entwicklerschlüssel, während ein `401` von `api.anthropic.com` oder Ihrem Anbieter-Endpunkt bedeutet, dass die Anbieteranmeldedaten, die das Gateway hält, abgelehnt wurden253* `Please run /login · API Error: 401`, `Not logged in` oder `Invalid API key` mit einem `401` im Gateway-Log: Prüfen Sie, wer das `401` ausgegeben hat. Korrigieren Sie den Entwicklerschlüssel oder seinen Header, wenn das Gateway es ausgegeben hat, oder die Anbieteranmeldedaten, die das Gateway hält, wenn es von `api.anthropic.com` oder dem Endpunkt Ihres Anbieters kam

254* Eine einmalige Genehmigungsabfrage für den Schlüssel ist bei der ersten Verwendung zu erwarten, wenn das Gateway Schlüssel im `x-api-key`-Header erwartet, gesetzt als `ANTHROPIC_API_KEY`254* Eine einmalige Genehmigungsabfrage für den Schlüssel ist bei der ersten Verwendung zu erwarten, wenn das Gateway Schlüssel im `x-api-key`-Header erwartet, gesetzt als `ANTHROPIC_API_KEY`

255 255

256Wenn Ihre Organisation [Schnellmodus](https://code.claude.com/docs/de/fast-mode.md) nutzt, führen Sie hier auch `/fast` aus: die Verfügbarkeitsprüfung ruft `api.anthropic.com` direkt auf, anstatt der Gateway-Basis-URL zu folgen, daher kann eine Gateway-geroutete Sitzung Schnellmodus als nicht verfügbar oder deaktiviert melden, obwohl Inferenz funktioniert. [Verwenden Sie Schnellmodus hinter Proxys und LLM-Gateways](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) ordnet jede Nachricht der Variablen zu, die sie wiederherstellt, verteilt mit [dem Rest der Konfiguration](#distribute-the-configuration).256Wenn Ihre Organisation [Schnellmodus](https://code.claude.com/docs/de/fast-mode.md) nutzt, führen Sie hier auch `/fast` aus: die Verfügbarkeitsprüfung ruft `api.anthropic.com` direkt auf, anstatt der Gateway-Basis-URL zu folgen, daher kann eine Gateway-geroutete Sitzung Schnellmodus als nicht verfügbar oder deaktiviert melden, obwohl Inferenz funktioniert. [Verwenden Sie Schnellmodus hinter Proxys und LLM-Gateways](https://code.claude.com/docs/de/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) ordnet jede Nachricht der Variablen zu, die sie wiederherstellt, verteilt mit [dem Rest der Konfiguration](#distribute-the-configuration).

microsoft-foundry.md +2 −16

Details

147 147

148## Azure RBAC-Konfiguration148## Azure RBAC-Konfiguration

149 149

150Die Standardrollen `Azure AI User` und `Cognitive Services User` enthalten alle erforderlichen Berechtigungen zum Aufrufen von Claude-Modellen.150Wenn Sie sich mit Microsoft Entra ID oder einem von Microsoft Entra ID ausgestellten Bearer-Token authentifizieren, weisen Sie Ihrer Identität die Rolle `Foundry User` oder `Cognitive Services User` für Ihre Foundry-Ressource zu. Möglicherweise sehen Sie `Foundry User` noch unter seinem früheren Namen `Azure AI User`.

151 151

152Für restriktivere Berechtigungen erstellen Sie eine benutzerdefinierte Rolle mit Folgendem:152Wenn diese Rollen Ihre Anforderungen nicht erfüllen, finden Sie Informationen zu benutzerdefinierten Rollen in der [Microsoft Foundry RBAC-Dokumentation](https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry).

~~153~~

154```json theme={null}

155{

156 "permissions": [

157 {

158 "dataActions": [

159 "Microsoft.CognitiveServices/accounts/providers/*"

160 ]

161 }

162 ]

163}

164```

~~165~~

166Weitere Informationen finden Sie in der [Microsoft Foundry RBAC-Dokumentation](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).

167 153

168## 1M-Token-Kontextfenster154## 1M-Token-Kontextfenster

169 155

model-config.md +1 −1

Details

903 903

904### Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren904### Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren

905 905

906Jede dieser beiden Startwarnungen bedeutet, dass Claude Code die Modell-ID Ihrer Sitzung nicht erkennt. Daher kann es das Kontextfenster des Modells nicht bestimmen und nimmt 200K Token an:906Jede dieser beiden Warnungen bedeutet, dass Claude Code die Modell-ID Ihrer Sitzung nicht erkennt. Daher kann es das Kontextfenster des Modells nicht bestimmen und nimmt 200K Token an:

907 907

908```text theme={null}908```text theme={null}

909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

monitoring-usage.md +1 −1

Details

431> * **Keine Leerzeichen erlaubt**: Werte dürfen keine Leerzeichen enthalten. Zum Beispiel ist `user.organizationName=My Company` ungültig431> * **Keine Leerzeichen erlaubt**: Werte dürfen keine Leerzeichen enthalten. Zum Beispiel ist `user.organizationName=My Company` ungültig

432> * **Format**: Es müssen durch Kommas getrennte key=value-Paare sein: `key1=value1,key2=value2`432> * **Format**: Es müssen durch Kommas getrennte key=value-Paare sein: `key1=value1,key2=value2`

433> * **Erlaubte Zeichen**: Nur US-ASCII-Zeichen mit Ausnahme von Steuerzeichen, Leerraum, doppelten Anführungszeichen, Kommas, Semikolons und Backslashes433> * **Erlaubte Zeichen**: Nur US-ASCII-Zeichen mit Ausnahme von Steuerzeichen, Leerraum, doppelten Anführungszeichen, Kommas, Semikolons und Backslashes

434> * **Sonderzeichen**: Zeichen außerhalb des erlaubten Bereichs müssen prozentkodiert werden434> * **Sonderzeichen**: Zeichen außerhalb des erlaubten Bereichs müssen prozentkodiert werden, und ein `=` innerhalb eines Werts muss als `%3D` geschrieben werden

435>435>

436> Verwenden Sie für einen Wert, der ein Leerzeichen benötigen würde, stattdessen Unterstriche oder camelCase. Die folgenden Beispiele setzen `org.name` in jeder der beiden Formen:436> Verwenden Sie für einen Wert, der ein Leerzeichen benötigen würde, stattdessen Unterstriche oder camelCase. Die folgenden Beispiele setzen `org.name` in jeder der beiden Formen:

437>437>

permission-modes.md +1 −1

Details

304claude --permission-mode plan304claude --permission-mode plan

305```305```

306 306

307Drücken Sie erneut `Shift+Tab`, um den Plan-Modus zu verlassen, ohne einen Plan zu genehmigen.307Wenn keine Genehmigungsabfrage geöffnet ist, drücken Sie erneut `Shift+Tab`, um den Plan-Modus zu verlassen. Drücken Sie in der Genehmigungsabfrage zuerst `Esc`, da `Shift+Tab` dort den Plan genehmigt.

308 308

309### Einen Plan prüfen und genehmigen309### Einen Plan prüfen und genehmigen

310 310

plugins/create.md +1 −1

Details

344 "PostToolUse": [344 "PostToolUse": [

345 {345 {

346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]

348 }348 }

349 ]349 ]

350 }350 }

plugins/mods/test.md +1 −10

Details

196 196

197### Ein Ergebnis mit `expect` prüfen197### Ein Ergebnis mit `expect` prüfen

198 198

199Das Kit bietet die folgenden Assertions, und die gewählte steht hinter dem Wert, den Sie prüfen, wie in `expect(answer.text).toBe('ok')`:199`expect` hat einen eigenen Satz von Assertions, etwa `toEqual` und `toHaveLength`, die hinter dem Wert stehen, den Sie prüfen, wie in `expect(answer.text).toBe('ok')`. Die vollständige Liste finden Sie, indem Sie in `claude-code/index.d.ts` in [den Typen für Ihren Build](https://code.claude.com/docs/de/plugins/mods/create.md#get-the-types-for-your-build) nach `type Matchers` suchen. Setzen Sie `.not` vor die Assertion, um das Gegenteil zu prüfen. Um zu prüfen, womit ein Promise abgeschlossen wird, setzen Sie `.resolves` oder `.rejects` direkt hinter `expect(...)` und versehen die Zeile mit `await`, wie in `await expect(promise).rejects.toThrow()`.

~~200~~

201* **Gleichheit**: `toBe` für denselben Wert oder dasselbe Objekt, `toEqual` für die Struktur, `toStrictEqual` für die Struktur einschließlich `undefined`-Feldern und des Prototyps, und `toMatchObject` für die Felder, die Sie angeben

202* **Text**: `toMatch`, das einen regulären Ausdruck oder einen Teilstring akzeptiert, `toStartWith` und `toEndWith`

203* **Zahlen**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Inhalte**: `toContain` für einen Teilstring oder ein Element, `toContainEqual` für ein nach Struktur verglichenes Element, `toHaveLength` und `toHaveProperty`

205* **Vorhandensein und Typ**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Ausnahmen**: `toThrow` für eine Funktion, die `expect` aufruft, oder für ein Promise, das Sie mit `.rejects` prüfen

~~207~~

208Setzen Sie `.not` vor eine Assertion, um das Gegenteil zu prüfen, und `.resolves` oder `.rejects`, um zu prüfen, womit ein Promise abgeschlossen wird.

209 200

210Wenn ein `expect` in einem Stub oder Hook fehlschlägt, den Sie `on` als einfache Funktion statt als asynchronen Generator übergeben haben, schlägt der Test fehl. Die Engine überspringt diesen Hook, und die Fehlerausgabe nennt ihn, etwa `in the test's store.set hook`.201Wenn ein `expect` in einem Stub oder Hook fehlschlägt, den Sie `on` als einfache Funktion statt als asynchronen Generator übergeben haben, schlägt der Test fehl. Die Engine überspringt diesen Hook, und die Fehlerausgabe nennt ihn, etwa `in the test's store.set hook`.

211 202

remote-control.md +2 −1

Details

67> | `--capacity <N>` | Maximale Anzahl gleichzeitiger Sitzungen. Standard ist 32. Kann nicht mit `--spawn=session` verwendet werden. |67> | `--capacity <N>` | Maximale Anzahl gleichzeitiger Sitzungen. Standard ist 32. Kann nicht mit `--spawn=session` verwendet werden. |

68> | `--[no-]create-session-in-dir` | Erstellt beim Start des Servers vorab eine Sitzung im aktuellen Verzeichnis, sodass Sie sofort etwas eingeben können. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert. Wenn Sie `--no-create-session-in-dir` übergeben, um ohne Sitzung zu starten, archiviert Claude Code die Sitzungen des Servers, wenn Sie ihn beenden, sodass es nichts [fortzusetzen](#resume-sessions-after-stopping-the-server) gibt. |68> | `--[no-]create-session-in-dir` | Erstellt beim Start des Servers vorab eine Sitzung im aktuellen Verzeichnis, sodass Sie sofort etwas eingeben können. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert. Wenn Sie `--no-create-session-in-dir` übergeben, um ohne Sitzung zu starten, archiviert Claude Code die Sitzungen des Servers, wenn Sie ihn beenden, sodass es nichts [fortzusetzen](#resume-sessions-after-stopping-the-server) gibt. |

69> | `--permission-mode <mode>` | Legt den anfänglichen [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) für die Sitzungen des Servers fest, z. B. `acceptEdits`. Akzeptiert `manual` als Alias für `default`; ein nicht erkannter Modus stoppt den Server beim Start und listet die gültigen Modi auf. |69> | `--permission-mode <mode>` | Legt den anfänglichen [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) für die Sitzungen des Servers fest, z. B. `acceptEdits`. Akzeptiert `manual` als Alias für `default`; ein nicht erkannter Modus stoppt den Server beim Start und listet die gültigen Modi auf. |

70> | `--settings <file>` | Wendet eine JSON-Einstellungsdatei auf die Sitzungen des Servers an, mit demselben [Vorrang](https://code.claude.com/docs/de/settings.md#settings-precedence) wie `claude --settings`. Geben Sie einen Dateipfad an, keinen JSON-String. Erfordert Claude Code v2.1.321 oder höher. |

70> | `--chrome` / `--no-chrome` | Schaltet die [Chrome-Integration](https://code.claude.com/docs/de/chrome.md) in den vom Server erstellten Sitzungen ein oder aus, sodass Claude Chrome auf Ihrem Rechner verwenden kann, während Sie von einem anderen Gerät aus arbeiten. Ohne eines der beiden Flags starten die vom Server vorab erstellte Sitzung und jede Sitzung, die Sie selbst über claude.ai/code oder die Claude-App starten, mit deaktiviertem Chrome, selbst wenn Sie [Chrome standardmäßig aktiviert](https://code.claude.com/docs/de/chrome.md#enable-chrome-by-default) haben. Eine Sitzung, die der Server für einen Ihrer [Projekt](https://code.claude.com/docs/de/claude-projects.md)-Threads startet, folgt stattdessen dieser Einstellung, außer im Modus `bypassPermissions`. Erfordert Claude Code v2.1.273 oder höher. |71> | `--chrome` / `--no-chrome` | Schaltet die [Chrome-Integration](https://code.claude.com/docs/de/chrome.md) in den vom Server erstellten Sitzungen ein oder aus, sodass Claude Chrome auf Ihrem Rechner verwenden kann, während Sie von einem anderen Gerät aus arbeiten. Ohne eines der beiden Flags starten die vom Server vorab erstellte Sitzung und jede Sitzung, die Sie selbst über claude.ai/code oder die Claude-App starten, mit deaktiviertem Chrome, selbst wenn Sie [Chrome standardmäßig aktiviert](https://code.claude.com/docs/de/chrome.md#enable-chrome-by-default) haben. Eine Sitzung, die der Server für einen Ihrer [Projekt](https://code.claude.com/docs/de/claude-projects.md)-Threads startet, folgt stattdessen dieser Einstellung, außer im Modus `bypassPermissions`. Erfordert Claude Code v2.1.273 oder höher. |

71> | `-d`, `--debug[=<filter>]` | Aktiviert das Debug-Logging für den Server, optional nach Kategorie gefiltert. Übergeben Sie einen Filter nur in der `=`-Form, z. B. `--debug=api,hooks`. Erfordert Claude Code v2.1.282 oder höher. |72> | `-d`, `--debug[=<filter>]` | Aktiviert das Debug-Logging für den Server, optional nach Kategorie gefiltert. Übergeben Sie einen Filter nur in der `=`-Form, z. B. `--debug=api,hooks`. Erfordert Claude Code v2.1.282 oder höher. |

72> | `--debug-file <path>` | Schreibt Debug-Logs in die angegebene Datei. |73> | `--debug-file <path>` | Schreibt Debug-Logs in die angegebene Datei. |

73> | `--verbose` | Zeigt detaillierte Verbindungs- und Sitzungslogs an. |74> | `--verbose` | Zeigt detaillierte Verbindungs- und Sitzungslogs an. |

74> | `--sandbox`, `--no-sandbox` | In v2.1.300 entfernt. Wenn Sie eines der beiden Flags übergeben, [beendet sich der Server mit einem Fehler](https://code.claude.com/docs/de/errors.md#sandbox-is-not-supported-by-claude-remote-control), anstatt zu starten. |75> | `--sandbox`, `--no-sandbox` | In v2.1.300 entfernt. Wenn Sie eines der beiden Flags übergeben, [beendet sich der Server mit einem Fehler](https://code.claude.com/docs/de/errors.md#sandbox-is-not-supported-by-claude-remote-control), anstatt zu starten. |

75>76>

76> Wenn Sie ein globales `claude`-Flag vor `remote-control` übergeben oder ein Wrapper-Skript eines hinzufügt, überträgt Claude Code das Flag nicht auf die Sitzungen, die der Server erstellt. Claude Code lässt das Flag nur durch, wenn bekannt ist, dass sein Weglassen nichts daran ändert, was diese Sitzungen tun können, wie etwa bei `--verbose` oder `--model`. Bei jedem anderen Flag, wie etwa `--settings`, [verweigert Claude Code den Start](https://code.claude.com/docs/de/errors.md#not-carried-over-to-the-sessions-remote-control-starts) und nennt das zu entfernende Flag.77> Wenn Sie ein globales `claude`-Flag vor `remote-control` übergeben oder ein Wrapper-Skript eines hinzufügt, überträgt Claude Code das Flag nicht auf die Sitzungen, die der Server erstellt. Bei einigen Flags, wie etwa `--verbose` oder `--model`, startet der Server trotzdem. Bei jedem anderen Flag [startet der Server nicht](https://code.claude.com/docs/de/errors.md#not-carried-over-to-the-sessions-remote-control-starts). Um eine Einstellungsdatei zu übergeben, setzen Sie `--settings` hinter `remote-control`.

77>78>

78> Um die vom Server gestarteten Sitzungen in einer Sandbox auszuführen, aktivieren Sie [Sandboxing](https://code.claude.com/docs/de/sandboxing.md) in einer Einstellungsdatei.79> Um die vom Server gestarteten Sitzungen in einer Sandbox auszuführen, aktivieren Sie [Sandboxing](https://code.claude.com/docs/de/sandboxing.md) in einer Einstellungsdatei.

79>80>

routines.md +1 −1

Details

431 431

432Jede geplante Aufgabe verwendet eine [Cloud-Umgebung](https://code.claude.com/docs/de/cloud-environments.md), die Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte steuert. Die Aufgabe übernimmt bei jeder Ausführung die Netzwerkrichtlinie der Umgebung.432Jede geplante Aufgabe verwendet eine [Cloud-Umgebung](https://code.claude.com/docs/de/cloud-environments.md), die Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte steuert. Die Aufgabe übernimmt bei jeder Ausführung die Netzwerkrichtlinie der Umgebung.

433 433

434Die **Standard**-Umgebung verwendet **Eingeschränkten** Zugriff mit aktivierter Option **Paketmanager zulassen**, sodass ihre Ausführungen die [Standard-Allowlist](https://code.claude.com/docs/de/cloud-environments.md#default-allowed-domains) erreichen. Eine Anfrage an einen blockierten Host schlägt mit `403` und `x-deny-reason: host_not_allowed` fehl. Der Datenverkehr von MCP-Konnektoren wird über die Server von Anthropic geleitet, daher funktionieren die Konnektoren, die Sie der Aufgabe hinzufügen, ohne dass Sie ihre Hosts zu **Zulässige Domains** hinzufügen müssen. Entfernen Sie alle Konnektoren, die Sie nicht benötigen, unter [Konnektoren](#connectors).434Die **Standard**-Umgebung verwendet **Eingeschränkten** Zugriff mit aktivierter Option **Paketmanager zulassen**, sodass ihre Ausführungen die [Standard-Allowlist](https://code.claude.com/docs/de/cloud-environments.md#default-allowed-domains) erreichen. Eine Anfrage an einen blockierten Host schlägt mit [einem Fehler wie `403` oder `ENOTFOUND`](https://code.claude.com/docs/de/errors#host-not-allowed-in-a-cloud-session) fehl. Der Datenverkehr von MCP-Konnektoren wird über die Server von Anthropic geleitet, daher funktionieren die Konnektoren, die Sie der Aufgabe hinzufügen, ohne dass Sie ihre Hosts zu **Zulässige Domains** hinzufügen müssen. Entfernen Sie alle Konnektoren, die Sie nicht benötigen, unter [Konnektoren](#connectors).

435 435

436Um zusätzliche Domains in einer Ihrer eigenen Umgebungen zuzulassen, führen Sie diese Schritte aus. Eine [organisationsweit geteilte Umgebung](https://code.claude.com/docs/de/cloud-environments.md#organization-shared-environments) wird hier schreibgeschützt geöffnet, daher ändert ein Owner ihren Netzwerkzugriff stattdessen auf der Seite **Cloud-Umgebungen** in den [Admin-Einstellungen](https://claude.ai/admin-settings).436Um zusätzliche Domains in einer Ihrer eigenen Umgebungen zuzulassen, führen Sie diese Schritte aus. Eine [organisationsweit geteilte Umgebung](https://code.claude.com/docs/de/cloud-environments.md#organization-shared-environments) wird hier schreibgeschützt geöffnet, daher ändert ein Owner ihren Netzwerkzugriff stattdessen auf der Seite **Cloud-Umgebungen** in den [Admin-Einstellungen](https://claude.ai/admin-settings).

437 437

sandboxing.md +5 −3

Details

276 276

277Diese Pfade werden auf Betriebssystemebene durchgesetzt, sodass alle in der Sandbox ausgeführten Befehle einschließlich ihrer Kindprozesse sie beachten. Dies ist der empfohlene Ansatz, wenn ein Tool Schreibzugriff auf einen bestimmten Ort benötigt, anstatt das Tool mit `excludedCommands` vollständig von der Sandbox auszunehmen.277Diese Pfade werden auf Betriebssystemebene durchgesetzt, sodass alle in der Sandbox ausgeführten Befehle einschließlich ihrer Kindprozesse sie beachten. Dies ist der empfohlene Ansatz, wenn ein Tool Schreibzugriff auf einen bestimmten Ort benötigt, anstatt das Tool mit `excludedCommands` vollständig von der Sandbox auszunehmen.

278 278

279Unter Linux und WSL2 hat ein Eintrag für einen Pfad, der noch nicht existiert, keine Wirkung. Legen Sie den Pfad daher zuerst an.

280

279Wenn Sie dasselbe Dateisystem-Array in mehreren [Einstellungs-Geltungsbereichen](https://code.claude.com/docs/de/settings.md#settings-precedence) definieren, führt Claude Code diese zusammen und kombiniert die Pfade, anstatt das Array eines Geltungsbereichs durch das eines anderen zu ersetzen. Claude Code lässt einen Eintrag beim Zusammenführen aus, wenn eine Sperre unter [Entwickler daran hindern, die Richtlinie zu erweitern](#keep-developers-from-widening-the-policy) ihn abdeckt.281Wenn Sie dasselbe Dateisystem-Array in mehreren [Einstellungs-Geltungsbereichen](https://code.claude.com/docs/de/settings.md#settings-precedence) definieren, führt Claude Code diese zusammen und kombiniert die Pfade, anstatt das Array eines Geltungsbereichs durch das eines anderen zu ersetzen. Claude Code lässt einen Eintrag beim Zusammenführen aus, wenn eine Sperre unter [Entwickler daran hindern, die Richtlinie zu erweitern](#keep-developers-from-widening-the-policy) ihn abdeckt.

280 282

281Wenn Sie eine Quelle mit [`--setting-sources`](https://code.claude.com/docs/de/cli-reference) in der CLI oder mit [`settingSources`](https://code.claude.com/docs/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) im Agent SDK ausschließen, ignoriert Claude Code beim Erstellen der Sandbox-Konfiguration deren `sandbox.filesystem`-Einträge, deren `Edit`-Berechtigungsregeln und deren `Read`-deny-Regeln. Erfordert Claude Code v2.1.246 oder höher.283Wenn Sie eine Quelle mit [`--setting-sources`](https://code.claude.com/docs/de/cli-reference) in der CLI oder mit [`settingSources`](https://code.claude.com/docs/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) im Agent SDK ausschließen, ignoriert Claude Code beim Erstellen der Sandbox-Konfiguration deren `sandbox.filesystem`-Einträge, deren `Edit`-Berechtigungsregeln und deren `Read`-deny-Regeln. Erfordert Claude Code v2.1.246 oder höher.

376 378

377Da das Ausschalten der Dateisystem-Isolation erweitert, was Befehle in der Sandbox tun können, berücksichtigt Claude Code `filesystem.disabled` nur aus diesen Einstellungsquellen:379Da das Ausschalten der Dateisystem-Isolation erweitert, was Befehle in der Sandbox tun können, berücksichtigt Claude Code `filesystem.disabled` nur aus diesen Einstellungsquellen:

378 380

379* Benutzereinstellungen, verwaltete Einstellungen und das CLI-Flag `--settings` können sie setzen. Projekteinstellungen in `.claude/settings.json` und `.claude/settings.local.json` können das nicht, sodass ein ausgechecktes Projekt die Dateisystem-Isolation nicht ausschalten kann.381* Benutzereinstellungen, verwaltete Einstellungen und das CLI-Flag `--settings` können sie setzen. Projekteinstellungen in `.claude/settings.json` und `.claude/settings.local.json` können sie nicht setzen.

380* Wenn verwaltete Einstellungen `sandbox.filesystem` überhaupt konfigurieren oder einen `sandbox.credentials.files`-Eintrag mit `"mode": "deny"` enthalten, können nur verwaltete Einstellungen den Schlüssel setzen. So können Entwickler die Dateisystem-Isolation in einer solchen Bereitstellung nicht ausschalten; um sie für alle auszuschalten, setzen Sie `"disabled": true` in den verwalteten Einstellungen.382* Wenn verwaltete Einstellungen `sandbox.filesystem` überhaupt konfigurieren oder einen `sandbox.credentials.files`-Eintrag mit `"mode": "deny"` enthalten, können nur verwaltete Einstellungen den Schlüssel setzen. Um die Dateisystem-Isolation für alle auszuschalten, setzen Sie `"disabled": true` in den verwalteten Einstellungen.

381* Wenn [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/de/env-vars) gesetzt ist, ignoriert Claude Code `filesystem.disabled` aus jeder Quelle, einschließlich der verwalteten Einstellungen, und lässt die Dateisystem-Isolation eingeschaltet.383* Wenn [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/de/env-vars) gesetzt ist, ignoriert Claude Code `filesystem.disabled` aus jeder Quelle, einschließlich der verwalteten Einstellungen.

382 384

383Ein [gültiger](https://code.claude.com/docs/de/settings-reference.md#invalid-credential-entries-in-managed-settings) `mask`-Eintrag legt den Schlüssel nicht fest, auch dann nicht, wenn Claude Code beim Start für ihn [auf `deny` zurückfällt](#mask-credential-files). Tragen Sie einen Pfad, der nicht maskiert werden kann, etwa ein Verzeichnis mit Anmeldedaten, als expliziten `deny`-Eintrag in den verwalteten Einstellungen ein, der den Schlüssel festlegt.385Ein [gültiger](https://code.claude.com/docs/de/settings-reference.md#invalid-credential-entries-in-managed-settings) `mask`-Eintrag legt den Schlüssel nicht fest, auch dann nicht, wenn Claude Code beim Start für ihn [auf `deny` zurückfällt](#mask-credential-files). Tragen Sie einen Pfad, der nicht maskiert werden kann, etwa ein Verzeichnis mit Anmeldedaten, als expliziten `deny`-Eintrag in den verwalteten Einstellungen ein, der den Schlüssel festlegt.

384 386

settings.md +1 −1

Details

177 177

178Claude Code überwacht Ihre Einstellungsdateien und lädt sie neu, wenn sie sich ändern, sodass es die meisten Änderungen auf die laufende Sitzung ohne Neustart anwendet, einschließlich Änderungen an `permissions`, `hooks` und Anmeldedaten-Helfern wie `apiKeyHelper`. Claude Code lädt auch eine Einstellungsdatei, die Sie mid-Sitzung erstellen, wenn ihr Ordner existierte, als die Sitzung begann. Für den `.claude/` Ordner des Projekts lädt es die Datei auch, wenn Sie den Ordner in der gleichen Sitzung erstellen.178Claude Code überwacht Ihre Einstellungsdateien und lädt sie neu, wenn sie sich ändern, sodass es die meisten Änderungen auf die laufende Sitzung ohne Neustart anwendet, einschließlich Änderungen an `permissions`, `hooks` und Anmeldedaten-Helfern wie `apiKeyHelper`. Claude Code lädt auch eine Einstellungsdatei, die Sie mid-Sitzung erstellen, wenn ihr Ordner existierte, als die Sitzung begann. Für den `.claude/` Ordner des Projekts lädt es die Datei auch, wenn Sie den Ordner in der gleichen Sitzung erstellen.

179 179

180Das Neuladen behandelt Benutzer-, Projekt-, lokale und verwaltete Einstellungen, und Claude Code führt den [`ConfigChange` Hook](https://code.claude.com/docs/de/hooks#configchange) für jede erkannte Einstellungsdatei-Änderung aus, nicht für verwaltete Einstellungen, die von MDM oder der claude.ai-Konsole ankommen. Verwaltete Einstellungen, die von MDM oder der claude.ai-Konsole ankommen, erreichen eine laufende Sitzung nach einem Zeitplan statt sofort; die [Bereitstellungstabelle](https://code.claude.com/docs/de/managed-settings.md#choose-a-delivery-mechanism) gibt ihn pro Quelle an.180Das Neuladen umfasst Benutzer-, Projekt-, lokale und verwaltete Einstellungen. Claude Code führt den [`ConfigChange` Hook](https://code.claude.com/docs/de/hooks#configchange) bei direkten Änderungen an Einstellungsdateien aus, nicht für verwaltete Einstellungen, die von MDM oder der claude.ai-Konsole ankommen. Verwaltete Einstellungen, die über MDM oder von der claude.ai-Konsole ankommen, erreichen eine laufende Sitzung nach einem Zeitplan statt beim Speichern; die [Bereitstellungstabelle](https://code.claude.com/docs/de/managed-settings.md#choose-a-delivery-mechanism) gibt ihn pro Quelle an.

181 181

182Claude Code liest einige Schlüssel nur einmal, beim Sitzungsstart, sodass eine Änderung an einem von ihnen die laufende Sitzung nicht erreicht. Admin-seitige Schlüssel, die auch auf einen Neustart warten, wie `requiredMinimumVersion`, sind unter [wo und wann eine Richtlinie angewendet wird](https://code.claude.com/docs/de/managed-settings.md#where-and-when-a-policy-applies) aufgelistet. Die, die Sie am ehesten mid-Sitzung bearbeiten:182Claude Code liest einige Schlüssel nur einmal, beim Sitzungsstart, sodass eine Änderung an einem von ihnen die laufende Sitzung nicht erreicht. Admin-seitige Schlüssel, die auch auf einen Neustart warten, wie `requiredMinimumVersion`, sind unter [wo und wann eine Richtlinie angewendet wird](https://code.claude.com/docs/de/managed-settings.md#where-and-when-a-policy-applies) aufgelistet. Die, die Sie am ehesten mid-Sitzung bearbeiten:

183 183

settings-reference.md +2 −0

Details

1533}1533}

1534```1534```

1535 1535

1536Unter Linux und WSL2 hat ein Eintrag für einen Pfad, der noch nicht existiert, keine Wirkung; legen Sie den Pfad also zuerst an.

1537

1536Claude Code führt `allowWrite`-Einträge und die Pfade aus Ihren `Edit(...)`-allow-Berechtigungsregeln über die Einstellungsbereiche zusammen, die die Sitzung lädt, und lässt dabei die aus Repository-Einstellungen weg, solange [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) aktiviert ist. [Repository-Sperren](https://code.claude.com/docs/de/sandboxing.md#repository-settings-under-an-admin-required-sandbox) können die Einträge eines Repositorys ebenfalls weglassen. Ein `allowWrite`-Eintrag kann einen [geschützten Pfad](https://code.claude.com/docs/de/sandboxing.md#protected-paths) nicht freigeben.1538Claude Code führt `allowWrite`-Einträge und die Pfade aus Ihren `Edit(...)`-allow-Berechtigungsregeln über die Einstellungsbereiche zusammen, die die Sitzung lädt, und lässt dabei die aus Repository-Einstellungen weg, solange [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) aktiviert ist. [Repository-Sperren](https://code.claude.com/docs/de/sandboxing.md#repository-settings-under-an-admin-required-sandbox) können die Einträge eines Repositorys ebenfalls weglassen. Ein `allowWrite`-Eintrag kann einen [geschützten Pfad](https://code.claude.com/docs/de/sandboxing.md#protected-paths) nicht freigeben.

1537 1539

1538### `sandbox.filesystem.denyWrite`1540### `sandbox.filesystem.denyWrite`

setup.md +8 −26

Details

40>40>

41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**

42>42>

~~43> ```bash theme={null}~~43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell:**49> **Windows PowerShell:**

50>50>

~~51> ```powershell theme={null}~~51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD:**55> **Windows CMD:**

56>56>

~~57> ```batch theme={null}~~57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72

73> [tab] Homebrew73> [tab] Homebrew

74>74>

~~75> ```bash theme={null}~~75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84

85> [tab] WinGet85> [tab] WinGet

86>86>

~~87> ```powershell theme={null}~~87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

141 141

142### Alpine Linux und musl-basierte Distributionen142### Alpine Linux und musl-basierte Distributionen

143 143

144Die Installation von Claude Code auf Alpine und anderen musl/uClibc-basierten Distributionen erfordert `bash` und `curl` für den Installationsbefehl sowie `libgcc`, `libstdc++` und `ripgrep` zur Laufzeit. Alpine enthält `bash` und `curl` nicht standardmäßig, daher schlägt der dokumentierte Installationsbefehl mit einem `not found`-Fehler fehl, bis Sie diese installieren. Installieren Sie diese Pakete mit dem Paketmanager Ihrer Distribution, und setzen Sie dann `USE_BUILTIN_RIPGREP=0`.144Auf Alpine und anderen musl-basierten Distributionen erfordert der [Installationsbefehl](#install-claude-code) `bash` und `curl`, und Claude Code selbst erfordert `bash` oder `zsh`. Alpine enthält `bash` und `curl` nicht standardmäßig, daher schlägt der dokumentierte Installationsbefehl mit einem `not found`-Fehler fehl, bis Sie diese installieren.

145 145

146Dieses Beispiel installiert die erforderlichen Pakete auf Alpine:146Dieses Beispiel installiert die erforderlichen Pakete auf Alpine:

147 147

148```bash theme={null}148```bash theme={null}

149apk add bash curl libgcc libstdc++ ripgrep149apk add bash curl

150```

~~151~~

152Auf Alpine befindet sich `ripgrep` im Community-Repository. Wenn `apk` meldet, dass das Paket fehlt, fügen Sie das Community-Repository zu `/etc/apk/repositories` hinzu, wobei Sie Ihre Alpine-Version verwenden:

~~153~~

154```bash theme={null}

155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

156```

~~157~~

158Führen Sie `apk update` aus, um den Paketindex zu aktualisieren, und versuchen Sie den `apk add`-Befehl erneut.

~~159~~

160Setzen Sie dann `USE_BUILTIN_RIPGREP` auf `0` in Ihrer [`settings.json`](https://code.claude.com/docs/de/settings-reference#all-settings)-Datei:

~~161~~

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151

170## Installation überprüfen152## Installation überprüfen

443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \

444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub

445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories

446> apk add claude-code428> apk add bash claude-code

447> ```429> ```

448>430>

449> Um zum `latest`-Kanal zu wechseln, entfernen Sie die `stable`-Repository-Zeile und fügen Sie das `latest`-Repository hinzu:431> Um zum `latest`-Kanal zu wechseln, entfernen Sie die `stable`-Repository-Zeile und fügen Sie das `latest`-Repository hinzu:

terminal-config.md +1 −1

Details

26 26

27| Terminal | Shift+Enter für Zeilenumbruch |27| Terminal | Shift+Enter für Zeilenumbruch |

28| :- | :- |28| :- | :- |

~~29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Funktioniert ohne Einrichtung |~~29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Windows Terminal | Funktioniert ohne Einrichtung |

30| Andere Terminals, die das Kitty-Tastaturprotokoll unterstützen, wie foot und Alacritty 0.16 oder neuer | Funktioniert ohne Einrichtung. Erfordert Claude Code v2.1.269 oder neuer |30| Andere Terminals, die das Kitty-Tastaturprotokoll unterstützen, wie foot und Alacritty 0.16 oder neuer | Funktioniert ohne Einrichtung. Erfordert Claude Code v2.1.269 oder neuer |

31| VS Code, Cursor, Devin Desktop, Alacritty vor 0.16, Zed | Führen Sie einmalig `/terminal-setup` aus |31| VS Code, Cursor, Devin Desktop, Alacritty vor 0.16, Zed | Führen Sie einmalig `/terminal-setup` aus |

32| gnome-terminal, JetBrains-IDEs wie PyCharm und Android Studio | Nicht verfügbar; verwenden Sie Ctrl+J oder `\` und dann Enter |32| gnome-terminal, JetBrains-IDEs wie PyCharm und Android Studio | Nicht verfügbar; verwenden Sie Ctrl+J oder `\` und dann Enter |

tools-reference.md +1 −3

Details

127 127

128Claude verwendet `AskUserQuestion`, um Ihnen Multiple-Choice-Fragen zu stellen, wenn eine Entscheidung oder Klärung erforderlich ist. Antworten Sie, indem Sie eine Option auswählen, oder geben Sie Ihren eigenen Text über die Zeile `Other` oder das Notizfeld ein.128Claude verwendet `AskUserQuestion`, um Ihnen Multiple-Choice-Fragen zu stellen, wenn eine Entscheidung oder Klärung erforderlich ist. Antworten Sie, indem Sie eine Option auswählen, oder geben Sie Ihren eigenen Text über die Zeile `Other` oder das Notizfeld ein.

129 129

130Wenn Sie durch Eingabe Ihres eigenen Textes antworten, leitet Claude Code die Antwort mit neutraler Formulierung weiter, damit Claude das befolgt, was Sie geschrieben haben, einschließlich einer Anfrage, zu warten oder zunächst zu erklären.

~~131~~

132### Timeout für automatische Fortsetzung von Fragen130### Timeout für automatische Fortsetzung von Fragen

133 131

134Fragen bleiben offen, bis Sie sie beantworten. Wenn Sie möchten, dass eine unbeantwortete Frage irgendwann von selbst geschlossen wird und Claude ohne Sie fortfahren kann, stellen Sie die Einstellung [`askUserQuestionTimeout`](https://code.claude.com/docs/de/settings-reference#askuserquestiontimeout) auf `60s`, `5m` oder `10m` ein, entweder in Ihrer Benutzerdatei `settings.json` oder in der Zeile **Question auto-continue timeout** in `/config`.132Fragen bleiben offen, bis Sie sie beantworten. Wenn Sie möchten, dass eine unbeantwortete Frage irgendwann von selbst geschlossen wird und Claude ohne Sie fortfahren kann, stellen Sie die Einstellung [`askUserQuestionTimeout`](https://code.claude.com/docs/de/settings-reference#askuserquestiontimeout) auf `60s`, `5m` oder `10m` ein, entweder in Ihrer Benutzerdatei `settings.json` oder in der Zeile **Question auto-continue timeout** in `/config`.

525 523

526## Verhalten des Read-Tools524## Verhalten des Read-Tools

527 525

528Das Read-Tool nimmt einen Dateipfad und gibt den Inhalt mit Zeilennummern zurück. Claude ist angewiesen, immer absolute Pfade zu übergeben.526Das Read-Tool nimmt einen Dateipfad und gibt den Inhalt mit Zeilennummern zurück.

529 527

530Das Lesen einer leeren Datei gibt eine Benachrichtigung zurück, dass die Datei existiert, aber ihr Inhalt leer ist, und ein `offset` nach der letzten Zeile gibt eine Benachrichtigung zurück, die die Zeilenanzahl der Datei angibt.528Das Lesen einer leeren Datei gibt eine Benachrichtigung zurück, dass die Datei existiert, aber ihr Inhalt leer ist, und ein `offset` nach der letzten Zeile gibt eine Benachrichtigung zurück, die die Zeilenanzahl der Datei angibt.

531 529

troubleshoot-install.md +4 −10

Details

388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source

389> ```389> ```

390 390

391Prüfen Sie unter Linux auf fehlende gemeinsam genutzte Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Unter Alpine Linux und anderen musl-basierten Distributionen siehe [Einrichtung unter Alpine Linux](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions).391Prüfen Sie unter Linux auf fehlende gemeinsam genutzte Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Unter Alpine Linux und anderen musl-basierten Distributionen siehe [Nicht passende musl- oder glibc-Binärdatei unter Linux](#linux-musl-or-glibc-binary-mismatch).

392 392

393```bash theme={null}393```bash theme={null}

394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"

906 906

907### Linux musl oder glibc Binärvarianten-Nichtübereinstimmung907### Linux musl oder glibc Binärvarianten-Nichtübereinstimmung

908 908

909Wenn Sie nach der Installation Fehler über fehlende gemeinsame Bibliotheken wie `libstdc++.so.6` oder `libgcc_s.so.1` sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.909Wenn Sie nach der Installation Fehler über fehlende gemeinsame Bibliotheken wie `ld-linux-x86-64.so.2` oder `ld-linux-aarch64.so.1` sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.

910 910

911```text theme={null}911```text theme={null}

912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory

913```913```

914 914

915Dies kann auf glibc-basierten Systemen geschehen, auf denen musl-Cross-Compilation-Pakete installiert sind, was das Installationsprogramm dazu veranlasst, das System fälschlicherweise als musl zu erkennen.

~~916~~

917**Lösungen:**915**Lösungen:**

918 916

9191. **Überprüfen Sie, welche libc Ihr System verwendet**:9171. **Überprüfen Sie, welche libc Ihr System verwendet**:

924 922

9252. **Wenn Sie auf glibc sind, aber die musl-Binärdatei erhalten haben**, entfernen Sie die Installation und installieren Sie erneut. Sie können die richtige Binärdatei auch manuell mit dem Manifest unter `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` herunterladen. Melden Sie ein [GitHub-Problem](https://github.com/anthropics/claude-code/issues) mit der Ausgabe von `ldd --version` und `ls /lib/libc.musl*`.9232. **Wenn Sie auf glibc sind, aber die musl-Binärdatei erhalten haben**, entfernen Sie die Installation und installieren Sie erneut. Sie können die richtige Binärdatei auch manuell mit dem Manifest unter `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` herunterladen. Melden Sie ein [GitHub-Problem](https://github.com/anthropics/claude-code/issues) mit der Ausgabe von `ldd --version` und `ls /lib/libc.musl*`.

926 924

9273. **Wenn Sie sich tatsächlich auf musl befinden**, wie Alpine Linux, installieren Sie die erforderlichen Pakete:9253. **Wenn Sie auf musl sind, aber die glibc-Binärdatei erhalten haben**, [entfernen Sie die Installation](https://code.claude.com/docs/de/setup.md#uninstall-claude-code). Installieren Sie unter Alpine Linux zuerst die Pakete, die im [Alpine Linux-Setup](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions) genannt werden. Führen Sie dann den [Installationsbefehl](https://code.claude.com/docs/de/setup.md#install-claude-code) aus, der die musl-Binärdatei installiert.

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 Auf Alpine befindet sich `ripgrep` im Community-Repository. Wenn `apk` meldet, dass das Paket fehlt, siehe [Alpine Linux-Setup](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions).

932 926

933### `Illegal instruction`927### `Illegal instruction`

934 928

troubleshooting.md +1 −1

Details

152> apk add ripgrep152> apk add ripgrep

153> ```153> ```

154>154>

155> `ripgrep` befindet sich im Community-Repository von Alpine. Wenn `apk` meldet, dass das Paket fehlt, siehe [Alpine Linux setup](https://code.claude.com/docs/de/setup.md#alpine-linux-and-musl-based-distributions).155> `ripgrep` befindet sich im Community-Repository von Alpine.

156 156

157> [tab] Arch157> [tab] Arch

158>158>

workflows.md +0 −2

Details

75| :- | :- |75| :- | :- |

76| `/deep-research <question>` | Verteilt Websuchen zu einer Frage auf mehrere Blickwinkel, ruft die gefundenen Quellen ab und gleicht sie miteinander ab, stimmt über jede Aussage ab und liefert einen Bericht mit Quellenangaben, aus dem Aussagen, die dem Abgleich nicht standgehalten haben, herausgefiltert sind. Setzt voraus, dass das [WebSearch-Tool](https://code.claude.com/docs/de/tools-reference.md#websearch-tool-behavior) verfügbar ist |76| `/deep-research <question>` | Verteilt Websuchen zu einer Frage auf mehrere Blickwinkel, ruft die gefundenen Quellen ab und gleicht sie miteinander ab, stimmt über jede Aussage ab und liefert einen Bericht mit Quellenangaben, aus dem Aussagen, die dem Abgleich nicht standgehalten haben, herausgefiltert sind. Setzt voraus, dass das [WebSearch-Tool](https://code.claude.com/docs/de/tools-reference.md#websearch-tool-behavior) verfügbar ist |

77 77

~~78`/deep-research` wird nur ausgeführt, wenn Sie den Workflow aufrufen.~~

80[Workflows, die Sie selbst speichern](#save-the-workflow-for-reuse), werden auf die gleiche Weise zu Befehlen und erscheinen in der `/`-Autovervollständigung neben den mitgelieferten.78[Workflows, die Sie selbst speichern](#save-the-workflow-for-reuse), werden auf die gleiche Weise zu Befehlen und erscheinen in der `/`-Autovervollständigung neben den mitgelieferten.

81 79

82### Die Ausführung verfolgen80### Die Ausführung verfolgen

Documentation 2026-11-12 23:02 UTC to 2026-11-13 02:00 UTC