SpyBara
Go Premium

Documentation 2026-10-20 23:00 UTC to 2026-10-21 23:02 UTC

85 files changed +1,577 −648. View all changes and history on the product overview
2026
Fri 30 23:01 Thu 29 23:57 Wed 28 23:57 Tue 27 22:59 Mon 26 22:57 Sun 25 23:58 Sat 24 22:59 Fri 23 22:59 Thu 22 22:58 Wed 21 23:02 Tue 20 23:00 Mon 19 23:58 Sat 17 23:57 Fri 16 22:59 Thu 15 23:58 Wed 14 22:58 Tue 13 23:57 Sun 11 23:57 Sat 10 23:01 Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +1 −1

Details

91| [Berechtigungssperre](/docs/de/permissions#managed-only-settings) | Verwaltete Einstellungen zur [einzigen Quelle von Berechtigungsregeln](/docs/de/settings-reference#allowmanagedpermissionrulesonly) machen. Deaktivieren Sie `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |91| [Berechtigungssperre](/docs/de/permissions#managed-only-settings) | Verwaltete Einstellungen zur [einzigen Quelle von Berechtigungsregeln](/docs/de/settings-reference#allowmanagedpermissionrulesonly) machen. Deaktivieren Sie `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |

92| [Startberechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) | Wählen Sie den Berechtigungsmodus, in dem die Terminal-Sitzungen Ihrer Entwickler starten, anstelle des integrierten Startberechtigungsmodus, oder entfernen Sie den Auto-Modus. [Berechtigungsmodi wechseln](/docs/de/permission-modes#switch-permission-modes) listet auf, wann die VS Code-Erweiterung einen `defaultMode` liest, den Sie festgelegt haben | `permissions.defaultMode`, `permissions.disableAutoMode` |92| [Startberechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) | Wählen Sie den Berechtigungsmodus, in dem die Terminal-Sitzungen Ihrer Entwickler starten, anstelle des integrierten Startberechtigungsmodus, oder entfernen Sie den Auto-Modus. [Berechtigungsmodi wechseln](/docs/de/permission-modes#switch-permission-modes) listet auf, wann die VS Code-Erweiterung einen `defaultMode` liest, den Sie festgelegt haben | `permissions.defaultMode`, `permissions.disableAutoMode` |

93| [Sandboxing](/docs/de/sandboxing) | Isolierung auf Betriebssystemebene des Dateisystems und Netzwerks mit Domain-Allowlists | `sandbox.enabled`, `sandbox.network.allowedDomains` |93| [Sandboxing](/docs/de/sandboxing) | Isolierung auf Betriebssystemebene des Dateisystems und Netzwerks mit Domain-Allowlists | `sandbox.enabled`, `sandbox.network.allowedDomains` |

94| [Verwaltete Richtlinie CLAUDE.md](/docs/de/memory#deploy-organization-wide-claude-md) | Organisationsweite Anweisungen, die in jeder Sitzung geladen werden, können nicht ausgeschlossen werden | Datei im verwalteten Richtlinienpfad |94| [Verwaltete Richtlinie CLAUDE.md](/docs/de/memory#deploy-organization-wide-claude-md) | Organisationsweite Verhaltensrichtlinien für Claude statt einer vom Client durchgesetzten Regel | Datei im verwalteten Richtlinienpfad |

95| [MCP-Server-Kontrolle](/docs/de/managed-mcp) | Einschränken, welche MCP-Server Benutzer hinzufügen oder verbinden können, einen festen Satz bereitstellen oder Remote-Server neben ihren eigenen für jeden Benutzer bereitstellen | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers` oder eine bereitgestellte `managed-mcp.json`-Datei |95| [MCP-Server-Kontrolle](/docs/de/managed-mcp) | Einschränken, welche MCP-Server Benutzer hinzufügen oder verbinden können, einen festen Satz bereitstellen oder Remote-Server neben ihren eigenen für jeden Benutzer bereitstellen | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers` oder eine bereitgestellte `managed-mcp.json`-Datei |

96| [Plugin-Marketplace-Kontrolle](/docs/de/plugins/org#restrict-what-users-can-install) | Einschränken, von welchen Marketplace-Quellen Benutzer hinzufügen und installieren können, CLI-Flags ablehnen, die Plugins, Agenten und MCP-Server für einen einzelnen Lauf sideloaden, [`command`-Plugin-Quellen](/docs/de/plugins/marketplace-reference#command-plugin-source) blockieren und per Allowlist festlegen, welche Plugins von Marketplaces vorgeschlagen werden können | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |96| [Plugin-Marketplace-Kontrolle](/docs/de/plugins/org#restrict-what-users-can-install) | Einschränken, von welchen Marketplace-Quellen Benutzer hinzufügen und installieren können, CLI-Flags ablehnen, die Plugins, Agenten und MCP-Server für einen einzelnen Lauf sideloaden, [`command`-Plugin-Quellen](/docs/de/plugins/marketplace-reference#command-plugin-source) blockieren und per Allowlist festlegen, welche Plugins von Marketplaces vorgeschlagen werden können | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |

97| [Anpassungssperre](/docs/de/settings-reference#strictpluginonlycustomization) | Blockieren Sie Skills, Agenten, Hooks und MCP-Server aus Benutzer- und Projektquellen, damit sie nur aus Plugins oder verwalteten Einstellungen stammen können. Das Sperren von Skills stoppt auch die [Skills, die Ihre Entwickler auf claude.ai aktivieren](/docs/de/skills#where-synced-skills-load) vom Synchronisieren | `strictPluginOnlyCustomization` |97| [Anpassungssperre](/docs/de/settings-reference#strictpluginonlycustomization) | Blockieren Sie Skills, Agenten, Hooks und MCP-Server aus Benutzer- und Projektquellen, damit sie nur aus Plugins oder verwalteten Einstellungen stammen können. Das Sperren von Skills stoppt auch die [Skills, die Ihre Entwickler auf claude.ai aktivieren](/docs/de/skills#where-synced-skills-load) vom Synchronisieren | `strictPluginOnlyCustomization` |

advisor.md +1 −1

Details

83 83 

84Wenn Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) mit `--advisor` starten und eine dieser Bedingungen zutrifft, startet Claude Code die Sitzung ohne den Advisor, anstatt zu beenden.84Wenn Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) mit `--advisor` starten und eine dieser Bedingungen zutrifft, startet Claude Code die Sitzung ohne den Advisor, anstatt zu beenden.

85 85 

86Wenn das angeforderte Modell als Advisor fungieren kann, aber [niedriger eingestuft ist](#choose-an-advisor-model) als das Hauptmodell der Sitzung, startet Claude Code die Sitzung trotzdem. Außerhalb von Hintergrund-Sitzungen warnt es beim Start außerdem, dass das Modell das Hauptmodell nicht beraten kann (`cannot advise`).86Wenn das übergebene Modell als Advisor fungieren kann, aber [niedriger eingestuft ist als Ihr Hauptmodell](#choose-an-advisor-model), startet die Sitzung unabhängig davon, ob es sich um eine Hintergrund-Sitzung handelt. Ihr Hauptmodell läuft dann ohne den Advisor.

87 87 

88## Wählen Sie ein Advisor-Modell88## Wählen Sie ein Advisor-Modell

89 89 

Details

20 20 

21Die Anwendungen in [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) sind Demos für die lokale Entwicklung, von einem E-Mail-Client bis zu einem Multi-Agent-Forschungssystem. Klonen Sie die Demo, deren Form dem entspricht, was Sie erstellen.21Die Anwendungen in [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) sind Demos für die lokale Entwicklung, von einem E-Mail-Client bis zu einem Multi-Agent-Forschungssystem. Klonen Sie die Demo, deren Form dem entspricht, was Sie erstellen.

22 22 

23## Ein vollständiges Projekt forken

24 

25Um mit dem Python SDK einen Shopping-Agenten oder einen Händler-Agenten zu erstellen, beginnen Sie mit der [Referenzimplementierung von Claude for Commerce](https://platform.claude.com/docs/en/about-claude/use-case-guides/commerce-agents).

26 

23## Arbeiten Sie ein Python-Rezept durch27## Arbeiten Sie ein Python-Rezept durch

24 28 

25Die Agent SDK-Serie des Claude Cookbook ist eine Abfolge von Rezepten, jeweils ein Python-Notebook, die von einem einfachen Forschungsagent zu ausgefeilten Multi-Agent-Systemen fortschreitet. Jedes Notebook baut auf dem vorherigen auf und führt neue Konzepte und Funktionen ein. Beginnen Sie mit [dem One-Liner-Forschungsagent](https://platform.claude.com/cookbook/claude-agent-sdk-00-the-one-liner-research-agent) und arbeiten Sie sich vorwärts.29Die Agent SDK-Serie des Claude Cookbook ist eine Abfolge von Rezepten, jeweils ein Python-Notebook, die von einem einfachen Forschungsagent zu ausgefeilten Multi-Agent-Systemen fortschreitet. Jedes Notebook baut auf dem vorherigen auf und führt neue Konzepte und Funktionen ein. Beginnen Sie mit [dem One-Liner-Forschungsagent](https://platform.claude.com/cookbook/claude-agent-sdk-00-the-one-liner-research-agent) und arbeiten Sie sich vorwärts.

Details

638 638 

639* [`permission_prompt`](/docs/de/hooks#notification) sobald eine Berechtigungsanfrage etwa sechs Sekunden auf Ihrem [`canUseTool` Callback](/docs/de/agent-sdk/user-input) gewartet hat. Erfordert TypeScript Agent SDK v0.3.233 oder später oder Python Agent SDK v0.2.139 oder später639* [`permission_prompt`](/docs/de/hooks#notification) sobald eine Berechtigungsanfrage etwa sechs Sekunden auf Ihrem [`canUseTool` Callback](/docs/de/agent-sdk/user-input) gewartet hat. Erfordert TypeScript Agent SDK v0.3.233 oder später oder Python Agent SDK v0.2.139 oder später

640* `elicitation_complete` und `elicitation_response` für Benutzer-Abfrage-Flows640* `elicitation_complete` und `elicitation_response` für Benutzer-Abfrage-Flows

641* `plugin_notification`, wenn ein [Mod](/docs/de/plugins/mods/api#show-something-without-starting-a-turn) `$.ui.notify` aufruft

641 642 

642Claude Code gibt die anderen Typen aus, wie `idle_prompt`, `auth_success` und `elicitation_dialog`, aus interaktiver Benutzeroberfläche, die SDK-Sitzungen nicht ausführen.643Claude Code gibt die anderen Typen aus, wie `idle_prompt`, `auth_success` und `elicitation_dialog`, aus interaktiver Benutzeroberfläche, die SDK-Sitzungen nicht ausführen.

643 644 

agent-sdk/mcp.md +29 −11

Details

142 142 

143## Verbindungszeitpunkt143## Verbindungszeitpunkt

144 144 

145Claude Code registriert die Server, die Sie in `options.mcpServers` übergeben, beim Start und sendet die [Init-Nachricht](#error-handling), sobald die Wartezeit für die erste Runde, falls vorhanden, abgelaufen ist. Ob jeder `options.mcpServers`-Server die erste Runde verzögert und wann er sich verbindet, hängt von seinem Typ ab:145Claude Code beginnt beim Start der Sitzung, Ihre MCP-Server zu verbinden, und sendet die [Init-Nachricht](#error-handling), sobald die Wartezeit für den ersten Turn, falls vorhanden, endet. Wie lange der erste Turn auf einen Server wartet, hängt davon ab, wo Sie ihn konfiguriert haben. Wenn Sie `permissionPromptToolName` setzen, wartet der erste Turn immer auf den Server dieses Tools, bis zu `MCP_TIMEOUT`, unabhängig davon, wo Sie ihn konfiguriert haben.

146 

147Suchen Sie für einen Server in `options.mcpServers` seinen Typ in der ersten Spalte, um zu sehen, wie lange der erste Turn auf ihn wartet.

146 148 

147| Servertyp | Verzögert die erste Runde? | Wartezeit-Timeout für die erste Runde |149| Servertyp | Verzögert die erste Runde? | Wartezeit-Timeout für die erste Runde |

148| :- | :- | :- |150| :- | :- | :- |


150| Remote-Server mit zwischengespeicherter Werkzeugliste, gespeichert von Claude Code aus einer vorherigen Verbindung | Nein; die zwischengespeicherten Werkzeuge sind ab der ersten Runde verfügbar | Keine; verbindet sich beim ersten Werkzeugaufruf, und diese aufgeschobene Verbindung hat ihr eigenes Timeout |152| Remote-Server mit zwischengespeicherter Werkzeugliste, gespeichert von Claude Code aus einer vorherigen Verbindung | Nein; die zwischengespeicherten Werkzeuge sind ab der ersten Runde verfügbar | Keine; verbindet sich beim ersten Werkzeugaufruf, und diese aufgeschobene Verbindung hat ihr eigenes Timeout |

151| In-Process-[SDK-Server](#sdk-mcp-servers) | Ja, bis zur Verbindung und Auflistung der Werkzeuge | [`MCP_TIMEOUT`](/docs/de/env-vars), standardmäßig 30 Sekunden pro Verbindungsversuch; die Verbindung schlägt bei dieser Frist fehl |153| In-Process-[SDK-Server](#sdk-mcp-servers) | Ja, bis zur Verbindung und Auflistung der Werkzeuge | [`MCP_TIMEOUT`](/docs/de/env-vars), standardmäßig 30 Sekunden pro Verbindungsversuch; die Verbindung schlägt bei dieser Frist fehl |

152 154 

153Server, die aus [Konfigurationsdateien](#from-a-config-file) wie `.mcp.json` oder aus Plugins geladen werden, zeigen häufig `pending` in der Init-Nachricht an. Wenn `options.mcpServers` einen Stdio-, HTTP- oder SSE-Server enthält, wartet die erste Runde auch auf diese ausstehenden Server, bis zu `MCP_TIMEOUT`. Wenn `options.mcpServers` leer ist oder nur SDK-Server enthält, wartet die erste Runde stattdessen bis zu 2 Sekunden:155Ein Server hat nur dann eine zwischengespeicherte Tool-Liste, wenn der [MCP-Discovery-Cache](/docs/de/mcp#server-status-detail) aktiviert ist.

156 

157Server aus [Einstellungsdateien](#from-a-config-file) wie `.mcp.json` oder aus Plugins zeigen in der Init-Nachricht häufig noch `pending` an. Wie lange der erste Turn auf sie wartet, hängt von `options.mcpServers` und der Tool-Suche ab:

158 

159* **`options.mcpServers` enthält einen Stdio-, HTTP- oder SSE-Server**: Der erste Turn wartet auch auf die ausstehenden Server aus Einstellungsdateien und Plugins, bis zu `MCP_TIMEOUT`.

160* **Andernfalls, wenn `ANTHROPIC_BASE_URL` auf ein [Gateway](/docs/de/mcp#tool-search-through-a-gateway) verweist und [`ENABLE_TOOL_SEARCH`](/docs/de/mcp#configure-tool-search) nicht gesetzt ist**: Der erste Turn wartet bis zu 2 Sekunden auf jeden ausstehenden Server aus Einstellungsdateien und Plugins.

161* **Andernfalls, wenn die [Tool-Suche](/docs/de/agent-sdk/tool-search) aktiviert ist, was der Standard ist**: Der erste Turn wartet bis zu 2 Sekunden, und zwar nur auf ausstehende Server, die [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) setzen oder die Sie [benannt](#named-servers) haben. Die übrigen verbinden sich weiter im Hintergrund, und Claude [greift auf ihre Tools zu](/docs/de/mcp#tool-availability), sobald sie verbunden sind.

162* **Andernfalls, wenn die Tool-Suche deaktiviert ist**: Der erste Turn wartet bis zu 2 Sekunden auf jeden ausstehenden Server aus Einstellungsdateien und Plugins. Die Tool-Suche ist deaktiviert, wenn Ihr [`ENABLE_TOOL_SEARCH`-Wert oder Ihr Modell](/docs/de/agent-sdk/tool-search#configure-tool-search) sie ausschaltet oder wenn Sie das Tool `ToolSearch` ausschließen, beispielsweise durch `disallowedTools`.

163 

164### Benannte Server

165 

166Sie benennen einen Server, indem Sie eines seiner Tools, etwa `mcp__github__list_issues` oder `mcp__github__*`, in [`allowedTools`](#allow-mcp-tools) oder in einer `permissions.allow`-Regel in der Option `settings` aufführen. Ein [`mcp_tool`-Hook](/docs/de/hooks#mcp-tool-hook-fields) benennt ebenfalls den Server, den er aufruft, wenn Sie ihn für ein Ereignis zur Prompt-Übermittlung, Tool-Nutzung, Berechtigung, zu Subagenten, Tasks, Elicitation oder Worktrees konfigurieren. Vor v2.1.284 hatte das Benennen eines Servers keine Auswirkung auf die Wartezeit für den ersten Turn.

167 

168### Die Wartezeit für den ersten Turn selbst festlegen

169 

170Um die Wartezeit für den ersten Turn selbst festzulegen, setzen Sie `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` in der [`env`-Option](/docs/de/agent-sdk/configuration#set-environment-variables), beispielsweise `CLAUDE_CODE_MCP_STARTUP_WAIT_MS: "5000"`. Der erste Turn wartet dann bis zu dieser Anzahl von Millisekunden auf ausstehende Server aus Einstellungsdateien und Plugins, unabhängig davon, ob die Tool-Suche aktiviert ist. Dieselbe Frist ersetzt die `MCP_TIMEOUT`-Wartezeit für die Stdio-, HTTP- und SSE-Server in `options.mcpServers`.

154 171 

155* **Mit [Werkzeugsuche](/docs/de/agent-sdk/tool-search), der Standardeinstellung**: Die Wartezeit umfasst noch ausstehende Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) konfiguriert sind, und nicht die übrigen. Die übrigen bleiben im Hintergrund verbunden. [Werkzeugverfügbarkeit](/docs/de/mcp#tool-availability) beschreibt, wie Claude auf ihre Werkzeuge zugreift, sobald sie verbunden sind.172Drei Wartezeiten gelten unabhängig vom gesetzten Wert, einschließlich `0`:

156* **Ohne Werkzeugsuche**: Die Wartezeit umfasst jeden ausstehenden Server. [Werkzeugsuche konfigurieren](/docs/de/agent-sdk/tool-search#configure-tool-search) behandelt, wie die Werkzeugsuche deaktiviert wird. Wenn Sie das `ToolSearch`-Werkzeug aus der Sitzung ausschließen, beispielsweise durch `disallowedTools`, wird die Sitzung auch ohne Werkzeugsuche ausgeführt.

157 173 

158Wenn Sie `permissionPromptToolName` setzen, wartet die erste Runde auch in jedem Fall auf den Server dieses Werkzeugs, bis zu `MCP_TIMEOUT`.174* **Ein `permissionPromptToolName`-Server**: bis zu `MCP_TIMEOUT`.

175* **Ein In-Process-[SDK-Server](#sdk-mcp-servers)**: bis zu `MCP_TIMEOUT` pro Verbindungsversuch.

176* **Ein [benannter Server](#named-servers), der sich noch verbindet**: mindestens bis zu 2 Sekunden, sodass ein Wert unter `2000` seine Wartezeit nicht verkürzt.

159 177 

160Um die Wartezeit für die erste Runde selbst zu setzen, fügen Sie `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` zur [`env`-Option](/docs/de/agent-sdk/configuration#set-environment-variables) hinzu, beispielsweise `CLAUDE_CODE_MCP_STARTUP_WAIT_MS: "5000"`. Die erste Runde wartet dann bis zu dieser Anzahl von Millisekunden auf jeden ausstehenden Server, unabhängig davon, ob die Werkzeugsuche verfügbar ist. Diese Frist ersetzt auch die `MCP_TIMEOUT`-Wartezeit für die erste Runde für Stdio-, HTTP- und SSE-Server in `options.mcpServers`. `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` erfordert Claude Code v2.1.274 oder später.178Setzen Sie die Variable auf `0`, um die Wartezeit für jeden anderen Server zu überspringen. Server, die noch ausstehend sind, wenn die Wartezeit endet, verbinden sich weiter im Hintergrund. `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` erfordert Claude Code v2.1.274 oder später.

161 179 

162Server, die noch ausstehend sind, wenn die Wartezeit endet, bleiben im Hintergrund verbunden. Setzen Sie die Variable auf `0`, um die Wartezeit zu überspringen. Ein `permissionPromptToolName`-Server behält seine eigene `MCP_TIMEOUT`-Wartezeit unabhängig vom Wert bei.180### Den Start auf Server warten lassen

163 181 

164Um den Start selbst in einer separaten, früheren Phase als die Wartezeit für die erste Runde zu blockieren, bevor die Init-Nachricht gesendet wird:182Zwei Einstellungen lassen bereits den Start warten, bevor Claude Code die Init-Nachricht sendet:

165 183 

166* Setzen Sie [`MCP_CONNECTION_NONBLOCKING`](/docs/de/env-vars) auf `0`, um den gesamten Verbindungsstapel zu blockieren. Claude Code begrenzt diese Wartezeit standardmäßig auf 5 Sekunden. Passen Sie die Obergrenze mit der Umgebungsvariablen [`MCP_CONNECT_TIMEOUT_MS`](/docs/de/env-vars) in Millisekunden an. Server, die bei dieser Frist noch ausstehend sind, bleiben im Hintergrund verbunden.184* **[`MCP_CONNECTION_NONBLOCKING`](/docs/de/env-vars) auf `0` gesetzt**: Der Start wartet auf den gesamten Verbindungsstapel, standardmäßig bis zu 5 Sekunden. Setzen Sie [`MCP_CONNECT_TIMEOUT_MS`](/docs/de/env-vars) in Millisekunden, um diese Obergrenze zu ändern. Server, die bei Erreichen der Obergrenze noch ausstehend sind, verbinden sich weiter im Hintergrund.

167* Setzen Sie `alwaysLoad: true` in der Konfiguration eines Servers, um seine Werkzeuge mit ihren vollständigen Schemas ab der ersten Runde verfügbar zu machen, [ausgenommen von der Werkzeugsuche-Aufschubung](/docs/de/mcp#exempt-a-server-from-deferral). Claude Code wartet beim Start auf die Werkzeuge dieses Servers, begrenzt auf die gleiche Frist, während andere Server im Hintergrund verbunden bleiben; ein Remote-Server mit einer zwischengespeicherten Werkzeugliste stellt sie ohne Verbindung bereit, wie in der obigen Tabelle angegeben.185* **`alwaysLoad: true` in der Konfiguration eines Servers**: Der Start wartet bis zur selben Obergrenze auf die Tools dieses Servers, sodass der erste Turn sie mit vollständigem Schema hat, [ausgenommen vom Aufschub durch die Tool-Suche](/docs/de/mcp#exempt-a-server-from-deferral). Ein Remote-Server mit einer zwischengespeicherten Tool-Liste stellt sie bereit, ohne sich zu verbinden oder den Start aufzuhalten.

168 186 

169Die `system`-Nachricht mit dem Subtyp `init` meldet den Status jedes Servers zum Zeitpunkt ihrer Emission; siehe [Fehlerbehandlung](#error-handling) zum Lesen dieser Status.187Die Init-Nachricht meldet den Status jedes Servers zu dem Zeitpunkt, an dem Claude Code sie sendet.

170 188 

171## MCP-Tools zulassen189## MCP-Tools zulassen

172 190 

Details

78| `disallowed_tools=["Bash(rm *)"]` | `Bash` bleibt verfügbar. Aufrufe, die `rm *` [wie geschrieben](/docs/de/permissions#bash-rule-limits) entsprechen, werden in jedem Genehmigungsmodus abgelehnt, einschließlich `bypassPermissions`. Andere `Bash`-Aufrufe, einschließlich `/bin/rm`, fallen durch zum Genehmigungsmodus. |78| `disallowed_tools=["Bash(rm *)"]` | `Bash` bleibt verfügbar. Aufrufe, die `rm *` [wie geschrieben](/docs/de/permissions#bash-rule-limits) entsprechen, werden in jedem Genehmigungsmodus abgelehnt, einschließlich `bypassPermissions`. Andere `Bash`-Aufrufe, einschließlich `/bin/rm`, fallen durch zum Genehmigungsmodus. |

79| `disallowed_tools=["*"]` | Jede Tool-Definition wird aus der Anfrage entfernt. Tool-Name-Globs werden in Deny-Regeln unterstützt: `"*"` entspricht jedem Tool und `"mcp__*"` entspricht jedem MCP-Tool über alle Server hinweg. |79| `disallowed_tools=["*"]` | Jede Tool-Definition wird aus der Anfrage entfernt. Tool-Name-Globs werden in Deny-Regeln unterstützt: `"*"` entspricht jedem Tool und `"mcp__*"` entspricht jedem MCP-Tool über alle Server hinweg. |

80 80 

81Allow-Regeln akzeptieren Tool-Name-Globs nur nach einem literalen `mcp__<server>__`-Präfix. Das Server-Segment muss glob-frei sein, damit die Regel einen bestimmten Server benennt, den Sie konfiguriert haben: `mcp__puppeteer__*` entspricht jedem Tool vom `puppeteer`-Server, und `mcp__github__get_*` entspricht seinen `get_`-Tools. Ein unverankter Eintrag wie `allowed_tools=["*"]` oder `allowed_tools=["mcp__*"]` wird mit einer Startwarnmeldung ignoriert und genehmigt nichts automatisch.81Allow-Regeln akzeptieren Tool-Name-Globs nur nach einem literalen `mcp__<server>__`-Präfix. Das Server-Segment muss glob-frei sein, damit die Regel einen bestimmten Server benennt, den Sie konfiguriert haben: `mcp__puppeteer__*` entspricht jedem Tool vom `puppeteer`-Server, und `mcp__github__get_*` entspricht seinen `get_`-Tools. Ein unverankerter Eintrag wie `allowed_tools=["*"]` oder `allowed_tools=["mcp__*"]` wird ignoriert und genehmigt nichts automatisch.

82 82 

83Begrenzte Regeln für `Read` und `Edit` verwenden ein Pfadmuster. `Edit(path)`-Regeln regeln alle integrierten Tools, die Dateien schreiben, einschließlich `Write` und `NotebookEdit`; eine `Write(path)`-Regel wird niemals durch die Dateiberechtigungsprüfungen abgeglichen.83Begrenzte Regeln für `Read` und `Edit` verwenden ein Pfadmuster. `Edit(path)`-Regeln regeln alle integrierten Tools, die Dateien schreiben, einschließlich `Write` und `NotebookEdit`; eine `Write(path)`-Regel wird niemals durch die Dateiberechtigungsprüfungen abgeglichen.

84 84 

Details

535| `set_model(model)` | Ändern Sie das Modell für die aktuelle Sitzung. Übergeben Sie `None`, um auf [Claude Code's Standardmodell](/docs/de/model-config) zurückzusetzen. Eine Sitzung im `auto`-Modus [wechselt in den `default`-Modus](/docs/de/agent-sdk/permissions#auto-mode-auto), wenn das neue Modell den Auto-Modus nicht unterstützt |535| `set_model(model)` | Ändern Sie das Modell für die aktuelle Sitzung. Übergeben Sie `None`, um auf [Claude Code's Standardmodell](/docs/de/model-config) zurückzusetzen. Eine Sitzung im `auto`-Modus [wechselt in den `default`-Modus](/docs/de/agent-sdk/permissions#auto-mode-auto), wenn das neue Modell den Auto-Modus nicht unterstützt |

536| `rewind_files(user_message_id)` | Stellen Sie Dateien in ihren Zustand bei der angegebenen Benutzernachricht wieder her. Erfordert `enable_file_checkpointing=True`. Siehe [Datei-Checkpointing](/docs/de/agent-sdk/file-checkpointing) |536| `rewind_files(user_message_id)` | Stellen Sie Dateien in ihren Zustand bei der angegebenen Benutzernachricht wieder her. Erfordert `enable_file_checkpointing=True`. Siehe [Datei-Checkpointing](/docs/de/agent-sdk/file-checkpointing) |

537| `get_mcp_status()` | Rufen Sie den Status aller konfigurierten MCP-Server ab. Gibt [`McpStatusResponse`](#mcpstatusresponse) zurück |537| `get_mcp_status()` | Rufen Sie den Status aller konfigurierten MCP-Server ab. Gibt [`McpStatusResponse`](#mcpstatusresponse) zurück |

538| `get_context_usage()` | Rufen Sie eine Aufschlüsselung der Kontextfenster-Nutzung nach Kategorie, Skill und Tool ab. Dies sind die gleichen Daten, die `/context` in einer interaktiven Sitzung anzeigt. Gibt [`ContextUsageResponse`](#contextusageresponse) zurück. Um die Aufschlüsselung zu berechnen, führt Claude Code mehrere Token-Zähl-API-Anfragen durch, die nicht im Nachrichtenstrom erscheinen; siehe [wie diese Anfragen behandelt werden](#contextusageresponse) |538| `get_context_usage()` | Rufen Sie eine Aufschlüsselung der Kontextfenster-Nutzung nach Kategorie, Skill und Tool ab. Enthält die Daten, die `/context` in einer interaktiven Sitzung anzeigt. Gibt [`ContextUsageResponse`](#contextusageresponse) zurück. Um die Aufschlüsselung zu berechnen, führt Claude Code mehrere Token-Zähl-API-Anfragen durch, die nicht im Nachrichtenstrom erscheinen; siehe [wie diese Anfragen behandelt werden](#contextusageresponse) |

539| `reconnect_mcp_server(server_name)` | Versuchen Sie, eine Verbindung zu einem MCP-Server herzustellen, der fehlgeschlagen ist oder getrennt wurde |539| `reconnect_mcp_server(server_name)` | Versuchen Sie, eine Verbindung zu einem MCP-Server herzustellen, der fehlgeschlagen ist oder getrennt wurde |

540| `toggle_mcp_server(server_name, enabled)` | Aktivieren oder deaktivieren Sie einen MCP-Server während der Sitzung. Das Deaktivieren entfernt seine Tools |540| `toggle_mcp_server(server_name, enabled)` | Aktivieren oder deaktivieren Sie einen MCP-Server während der Sitzung. Das Deaktivieren entfernt seine Tools |

541| `stop_task(task_id)` | Stoppen Sie eine laufende Hintergrundaufgabe. Eine [`TaskNotificationMessage`](#tasknotificationmessage) mit Status `"stopped"` folgt im Nachrichtenstrom |541| `stop_task(task_id)` | Stoppen Sie eine laufende Hintergrundaufgabe. Eine [`TaskNotificationMessage`](#tasknotificationmessage) mit Status `"stopped"` folgt im Nachrichtenstrom |


1524 1524 

1525### `ContextUsageResponse`1525### `ContextUsageResponse`

1526 1526 

1527Antwort von [`ClaudeSDKClient.get_context_usage()`](#methods). Dies ist dieselbe Payload, die Claude Code für den Befehl `/context` in einer interaktiven Sitzung rendert, daher enthält sie neben den Token-Zählungen auch Anzeigefelder wie `color` und `gridRows`, mit denen Claude Code das `/context`-Nutzungsraster zeichnet.1527Antwort von [`ClaudeSDKClient.get_context_usage()`](#methods). Die Antwort enthält die Payload, die Claude Code für den Befehl `/context` in einer interaktiven Sitzung rendert. Neben den Token-Zählungen enthält diese Payload Anzeigefelder wie `color` und `gridRows`, mit denen Claude Code das `/context`-Nutzungsraster zeichnet.

1528 1528 

1529Claude Code erstellt diese Payload, indem es mehrere Anfragen an die [Token-Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting)-API sendet. Diese Anfragen erscheinen nicht im Nachrichtenstrom, daher sieht eine Kostenverfolgung, die den Strom liest, sie nicht. In der Anthropic API wird Token-Counting nicht abgerechnet.1529Claude Code erstellt diese Payload, indem es mehrere Anfragen an die [Token-Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting)-API sendet. Diese Anfragen erscheinen nicht im Nachrichtenstrom, daher sieht eine Kostenverfolgung, die den Strom liest, sie nicht. In der Anthropic API wird Token-Counting nicht abgerechnet.

1530 1530 


1715 1715 

1716Mehrere Felder enthalten diagnostische Details, wie das Gespräch endete:1716Mehrere Felder enthalten diagnostische Details, wie das Gespräch endete:

1717 1717 

1718* `is_error`: `True`, wenn das Gespräch in einem Fehlerzustand endete. Immer `True` bei den `error_*`-Subtypen. Bei `subtype="success"` ist es `True`, wenn die letzte Modellanfrage fehlgeschlagen ist, was bedeutet, dass die Agent-Schleife abgeschlossen wurde, aber der letzte API-Aufruf einen Fehler zurückgab.1718* `is_error`: `True`, wenn die Konversation in einem Fehlerzustand endete. Immer `True` bei den `error_*`-Subtypen. Bei `subtype="success"` ist es in drei Fällen `True`. Prüfen Sie `stop_reason`, um sie zu unterscheiden:

1719 * `"refusal"`: Das Modell hat eine Antwort abgelehnt. Lesen Sie den Ablehnungstext in `result` oder in der vorhergehenden `AssistantMessage`, wenn `result` leer ist.

1720 * `"tool_deferred_unavailable"`: Das [zurückgestellte Tool](/docs/de/hooks#defer-a-tool-call-for-later) war beim Fortsetzen der Sitzung nicht mehr verfügbar, zum Beispiel weil sein MCP-Server nicht verbunden war. In den beiden folgenden Fällen zählt ein Prompt, den Sie nach dem Fortsetzen senden, genauso wie einer, der beim Fortsetzen übergeben wird:

1721 * Kein Prompt: Der Aufruf steht weiterhin aus. Machen Sie das Tool verfügbar und setzen Sie die Sitzung erneut ohne Prompt fort; dann wird der Aufruf zuerst ausgeführt.

1722 * Ein Prompt: Claude Code beantwortet ihn ohne das Ergebnis des Tools, und der zurückgestellte Aufruf entfällt. Senden Sie einen neuen Prompt, wenn das Tool weiterhin aufgerufen werden soll.

1723 * Jeder andere Wert: Der Turn endete mit einem Fehler, den Claude Code anstelle einer Modellantwort gemeldet hat, etwa einem API-Fehler. Lesen Sie `terminal_reason` für die Ursache, `result` für die Meldung und `api_error_status` für den HTTP-Status, wenn die API einen zurückgegeben hat.

1719* `api_error_status`: Der HTTP-Statuscode des beendenden API-Fehlers. `None`, wenn die Umdrehung ohne einen endete. Wird nur bei `subtype="success"` gefüllt.1724* `api_error_status`: Der HTTP-Statuscode des beendenden API-Fehlers. `None`, wenn die Umdrehung ohne einen endete. Wird nur bei `subtype="success"` gefüllt.

1720* `result`: Text der endgültigen Assistent-Nachricht bei `subtype="success"` oder `None` bei den `error_*`-Subtypen. Wenn `subtype="success"` und `is_error=True`, enthält dies die API-Fehlerzeichenfolge, falls verfügbar, kann aber leer sein. Überprüfen Sie daher `api_error_status` und den vorherigen `AssistantMessage`-Inhalt für Details.1725* `result`: Text der endgültigen Assistent-Nachricht bei `subtype="success"` oder `None` bei den `error_*`-Subtypen. Wenn `subtype="success"` und `is_error=True`, enthält dies die API-Fehlerzeichenfolge, falls verfügbar, kann aber leer sein. Überprüfen Sie daher `api_error_status` und den vorherigen `AssistantMessage`-Inhalt für Details.

1721* `errors`: Fehlerzeichenfolgen auf Schleifenebene, wie die Max-Turns-Nachricht. Wird nur bei den `error_*`-Subtypen gefüllt.1726* `errors`: Fehlerzeichenfolgen auf Schleifenebene, wie die Max-Turns-Nachricht. Wird nur bei den `error_*`-Subtypen gefüllt.


2062 errors: list[str] # an empty list when the result message reported none2067 errors: list[str] # an empty list when the result message reported none

2063 result: str | None2068 result: str | None

2064 api_error_status: int | None2069 api_error_status: int | None

2065 terminal_reason: str | None # "max_turns", "api_error", ...; check this before subtype2070 terminal_reason: str | None # "max_turns", "api_error", ...; check after data["stop_reason"], before subtype

2066 session_id: str | None2071 session_id: str | None

2067 data: dict[str, Any] # the raw result message payload2072 data: dict[str, Any] # the raw result message payload

2068```2073```

2069 2074 

2070Um Fehler zu unterscheiden, überprüfen Sie `terminal_reason` vor `subtype`. Wenn die endgültige Anfrage fehlschlägt, z. B. bei einem API-Fehler, meldet Claude Code `subtype` `"success"` mit der Ursache in `terminal_reason`, z. B. `"api_error"`; wenn ein von Ihnen festgelegtes Limit die Ausführung beendet, z. B. `max_turns` oder `max_budget_usd`, meldet es einen `error_*`-Subtyp.2075Um Fehler zu unterscheiden, überprüfen Sie zuerst `data["stop_reason"]`, dann `terminal_reason` und dann `subtype`. Eine abgelehnte Antwort hat `stop_reason` `"refusal"`, in der Regel mit `subtype` `"success"`; ihr `terminal_reason` kennzeichnet sie nicht eindeutig und kann `"completed"` oder `"api_error"` lauten. Eine fehlgeschlagene endgültige Anfrage hat `subtype` `"success"` und ihre Ursache in `terminal_reason`, z. B. `"api_error"` bei einem API-Fehler. Wenn die Ausführung ein von Ihnen festgelegtes Limit erreicht, z. B. `max_turns` oder `max_budget_usd`, erhalten Sie einen `error_*`-Subtyp.

2071 2076 

2072### `CLIJSONDecodeError`2077### `CLIJSONDecodeError`

2073 2078 


2574 "subagent_type": str | None, # Der Typ des zu verwendenden spezialisierten Agenten2579 "subagent_type": str | None, # Der Typ des zu verwendenden spezialisierten Agenten

2575 "model": "sonnet" | "opus" | "haiku" | "fable" | None, # Modellüberschreibung für diesen Agent2580 "model": "sonnet" | "opus" | "haiku" | "fable" | None, # Modellüberschreibung für diesen Agent

2576 "effort": "low" | "medium" | "high" | "xhigh" | "max" | None, # Denkaufwand für diesen Agenten2581 "effort": "low" | "medium" | "high" | "xhigh" | "max" | None, # Denkaufwand für diesen Agenten

2577 "run_in_background": bool | None, # Agenten laufen standardmäßig im Hintergrund; auf False setzen, um synchron auszuführen2582 "run_in_background": bool | None, # Standard bei Auslassung: Ein Aufruf Ihres Haupt-Agenten führt den neuen Agenten im Hintergrund aus, der Aufruf eines Subagenten wartet auf ihn

2578 "name": str | None, # Name für den erzeugten Agent2583 "name": str | None, # Name für den erzeugten Agent

2579 "team_name": str | None, # Veraltet; wird ignoriert2584 "team_name": str | None, # Veraltet; wird ignoriert

2580 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # Veraltet; wird ignoriert. Die Vererbungsregeln für Subagenten bestimmen den Berechtigungsmodus eines Subagenten2585 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # Veraltet; wird ignoriert. Die Vererbungsregeln für Subagenten bestimmen den Berechtigungsmodus eines Subagenten


2584 2589 

2585Startet einen neuen Agent, um komplexe, mehrstufige Aufgaben autonom zu bewältigen.2590Startet einen neuen Agent, um komplexe, mehrstufige Aufgaben autonom zu bewältigen.

2586 2591 

2592Wenn Claude `run_in_background` in einem `Agent`-Aufruf weglässt, wartet Ihr Haupt-Agent standardmäßig nicht auf den neuen Agenten, ein Subagent hingegen schon:

2593 

2594* **Von Ihrem Haupt-Agenten aus**: Der neue Agent läuft im Hintergrund, und das Ergebnis hat `status: "async_launched"`. Wie Sie Ihren Haupt-Agenten stattdessen auf den neuen Agenten warten lassen, erfahren Sie unter [Festlegen, ob Claude auf Subagenten wartet](/docs/de/agent-sdk/subagents#choose-whether-claude-waits-for-subagents).

2595* **Von einem Ihrer Subagenten aus**: Der aufrufende Subagent [wartet auf den neuen Agenten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents). Der neue Agent läuft stattdessen im Hintergrund, wenn seine Definition [`background`](#agentdefinition) auf `True` setzt oder wenn Sie den [Fork-Modus ausschalten](/docs/de/sub-agents#turn-fork-mode-on-or-off), indem Sie `CLAUDE_CODE_FORK_SUBAGENT` auf `0` setzen.

2596 

2597Vor Python SDK v0.2.169 liefen auch Agenten, die Ihre Subagenten gestartet hatten, standardmäßig im Hintergrund. Diese Version ist die erste, die Claude Code v2.1.302 oder später bündelt.

2598 

2587**Ausgabe (Status: `"completed"`):**2599**Ausgabe (Status: `"completed"`):**

2588 2600 

2589```python theme={null}2601```python theme={null}


3519 "Claude Code CLI not found. Try reinstalling: pip install --force-reinstall claude-agent-sdk"3531 "Claude Code CLI not found. Try reinstalling: pip install --force-reinstall claude-agent-sdk"

3520 )3532 )

3521 # Catch ResultError before ProcessError, which it subclasses. Its message3533 # Catch ResultError before ProcessError, which it subclasses. Its message

3522 # carries the error text. A failed final request, such as an API error,3534 # carries the error text. A refusal and a failed final request both usually

3523 # arrives with subtype "success", so branch on terminal_reason first.3535 # arrive with subtype "success", so check stop_reason, then terminal_reason.

3524 except ResultError as e:3536 except ResultError as e:

3525 if e.terminal_reason == "api_error":3537 if e.data.get("stop_reason") == "refusal":

3538 print(f"Model declined to respond: {e}")

3539 elif e.terminal_reason == "api_error":

3526 print(f"API request failed: {e}")3540 print(f"API request failed: {e}")

3527 else:3541 else:

3528 print(f"Query ended with an error result ({e.terminal_reason or e.subtype}): {e}")3542 print(f"Query ended with an error result ({e.terminal_reason or e.subtype}): {e}")

Details

318 318 

319## Bekannte Einschränkungen319## Bekannte Einschränkungen

320 320 

321* **Strukturierte Ausgabe**: Bei aktivierten Teilnachrichten wird das JSON als unkontrollierte `input_json_delta`-Chunks eines Tool-Aufrufs gestreamt, und nur das validierte Ergebnis erreicht die finale `ResultMessage.structured_output`. Weitere Informationen finden Sie unter [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs).321* **Strukturierte Ausgabe**: Bei aktivierten Teilnachrichten wird das JSON als nicht validierte `input_json_delta`-Chunks eines Tool-Aufrufs gestreamt, und nur das validierte Ergebnis erreicht die finale `ResultMessage.structured_output`. Unter [Den StructuredOutput-Tool-Aufruf erkennen](/docs/de/agent-sdk/structured-outputs#recognize-the-structuredoutput-tool-call) wird beschrieben, wie dieser Aufruf in Ihrem Stream erscheint.

322 322 

323## Nächste Schritte323## Nächste Schritte

324 324 

Details

368asyncio.run(main())368asyncio.run(main())

369```369```

370 370 

371## Den StructuredOutput-Tool-Aufruf erkennen

372 

373Wenn Sie `outputFormat` in TypeScript oder `output_format` in Python festlegen, enthält Ihr Nachrichtenstream einen Tool-Aufruf namens `StructuredOutput`, den Sie nie definiert haben. Claude Code fügt dieses Tool der Sitzung hinzu, und der Agent ruft es auf, um seine Antwort zurückzugeben. Die [System-Init-Nachricht](/docs/de/agent-sdk/typescript#sdksystemmessage) führt es im Array `tools` auf, und jeder Aufruf kommt als zwei Blöcke an:

374 

375* Ein `tool_use`-Block namens `StructuredOutput`, dessen Eingabe das Objekt ist, das der Agent für Ihr Schema erzeugt hat

376* Ein `tool_result`-Block mit dem Inhalt `Structured output provided successfully`

377 

378Wenn dieses Objekt nicht Ihrem Schema entspricht, enthält das `tool_result` stattdessen `is_error: true`, und der Agent ruft `StructuredOutput` erneut auf, sodass Ihr Stream mehrere Aufrufe für eine Abfrage enthalten kann. Lesen Sie die validierten Daten aus `structured_output` in der Ergebnisnachricht statt aus einem `tool_use`-Block, und unter [Fehlerbehandlung](#error-handling) finden Sie das Ergebnis, das Sie erhalten, wenn kein Versuch erfolgreich ist.

379 

380Wenn Ihre Anwendung Tool-Aufrufe anzeigt oder protokolliert, überspringen Sie diejenigen mit dem Namen `StructuredOutput`, damit der Mechanismus nicht als Schritt erscheint, den der Agent gewählt hat. Ein `tool_result`-Block enthält keinen Tool-Namen, sondern nur die `tool_use_id` des Aufrufs, auf den er antwortet. Gleichen Sie diese daher mit der `id` jedes übersprungenen Aufrufs ab.

381 

371## Fehlerbehandlung382## Fehlerbehandlung

372 383 

373Die Generierung strukturierter Ausgaben kann fehlschlagen, wenn der Agent kein gültiges JSON erzeugen kann, das Ihrem Schema entspricht. Dies geschieht normalerweise, wenn das Schema für die Aufgabe zu komplex ist, die Aufgabe selbst mehrdeutig ist, oder der Agent sein Wiederholungslimit beim Versuch, Validierungsfehler zu beheben, erreicht. Es kann auch ohne Validierungsfehler geschehen: Ein [Modell-Fallback](/docs/de/model-config#automatic-model-fallback) kann eine bereits abgeschlossene Ausgabe mitten im Stream zurückziehen, und wenn kein erfolgreicher Wiederholungsversuch sie ersetzt, endet der Durchlauf mit demselben Fehler. Überprüfen Sie die `errors`-Liste der Fehler-Ergebnismeldung, um die beiden Ursachen auseinanderzuhalten, bevor Sie Ihr Schema debuggen.384Die Generierung strukturierter Ausgaben kann fehlschlagen, wenn der Agent kein gültiges JSON erzeugen kann, das Ihrem Schema entspricht. Dies geschieht normalerweise, wenn das Schema für die Aufgabe zu komplex ist, die Aufgabe selbst mehrdeutig ist, oder der Agent sein Wiederholungslimit beim Versuch, Validierungsfehler zu beheben, erreicht. Es kann auch ohne Validierungsfehler geschehen: Ein [Modell-Fallback](/docs/de/model-config#automatic-model-fallback) kann eine bereits abgeschlossene Ausgabe mitten im Stream zurückziehen, und wenn kein erfolgreicher Wiederholungsversuch sie ersetzt, endet der Durchlauf mit demselben Fehler. Überprüfen Sie die `errors`-Liste der Fehler-Ergebnismeldung, um die beiden Ursachen auseinanderzuhalten, bevor Sie Ihr Schema debuggen.

Details

147| `tools` | `string[]` | Nein | Array von zulässigen Tool-Namen. Falls weggelassen, erbt jeden [für Subagenten verfügbaren Tool](/docs/de/sub-agents#available-tools) |147| `tools` | `string[]` | Nein | Array von zulässigen Tool-Namen. Falls weggelassen, erbt jeden [für Subagenten verfügbaren Tool](/docs/de/sub-agents#available-tools) |

148| `disallowedTools` | `string[]` | Nein | Array von Tool-Namen, die aus dem Tool-Set des Agenten entfernt werden sollen. MCP-Server-Level-Muster werden ebenfalls akzeptiert: `mcp__server` oder `mcp__server__*` entfernt jeden Tool von diesem Server, und `mcp__*` entfernt jeden MCP-Tool von jedem Server |148| `disallowedTools` | `string[]` | Nein | Array von Tool-Namen, die aus dem Tool-Set des Agenten entfernt werden sollen. MCP-Server-Level-Muster werden ebenfalls akzeptiert: `mcp__server` oder `mcp__server__*` entfernt jeden Tool von diesem Server, und `mcp__*` entfernt jeden MCP-Tool von jedem Server |

149| `model` | `string` | Nein | Modell-Override für diesen Agent. Akzeptiert einen Alias wie `'fable'`, `'opus'`, `'sonnet'`, `'haiku'`, `'inherit'`, oder eine vollständige Modell-ID. `'inherit'` verwendet das Hauptmodell. Wenn Sie es weglassen, wählt Claude Code das Modell in der [Subagenten-Modellreihenfolge](/docs/de/sub-agents#choose-a-model) |149| `model` | `string` | Nein | Modell-Override für diesen Agent. Akzeptiert einen Alias wie `'fable'`, `'opus'`, `'sonnet'`, `'haiku'`, `'inherit'`, oder eine vollständige Modell-ID. `'inherit'` verwendet das Hauptmodell. Wenn Sie es weglassen, wählt Claude Code das Modell in der [Subagenten-Modellreihenfolge](/docs/de/sub-agents#choose-a-model) |

150| `skills` | `string[]` | Nein | Liste von Skill-Namen, die beim Start in den Kontext des Agenten vorgeladen werden sollen. Nicht aufgelistete Skills bleiben über das Skill-Tool aufrufbar |150| `skills` | `string[]` | Nein | Liste von Skill-Namen, die beim Start in den Kontext des Agenten vorgeladen werden sollen. Höchstens die [ersten 32 unterschiedlichen Namen](/docs/de/sub-agents#preload-skills-into-subagents) in der Liste werden vorgeladen. Nicht aufgelistete Skills bleiben über das Skill-Tool aufrufbar |

151| `memory` | `'user' \| 'project' \| 'local'` | Nein | Speicherquelle für diesen Agent |151| `memory` | `'user' \| 'project' \| 'local'` | Nein | Speicherquelle für diesen Agent |

152| `mcpServers` | `(string \| object)[]` | Nein | MCP-Server, die diesem Agent zur Verfügung stehen, nach Name oder Inline-Konfiguration |152| `mcpServers` | `(string \| object)[]` | Nein | MCP-Server, die diesem Agent zur Verfügung stehen, nach Name oder Inline-Konfiguration |

153| `initialPrompt` | `string` | Nein | Wird automatisch als erste Benutzer-Runde eingereicht, wenn dieser Agent als Haupt-Thread-Agent läuft. Wird ignoriert, wenn der Agent als Subagent aufgerufen wird |153| `initialPrompt` | `string` | Nein | Wird automatisch als erste Benutzer-Runde eingereicht, wenn dieser Agent als Haupt-Thread-Agent läuft. Wird ignoriert, wenn der Agent als Subagent aufgerufen wird |


323 323 

324Claude ruft Subagenten über das Agent-Tool auf. Um zu erkennen, wenn ein Subagent aufgerufen wird, suchen Sie nach `tool_use`-Blöcken, bei denen `name` gleich `"Agent"` ist.324Claude ruft Subagenten über das Agent-Tool auf. Um zu erkennen, wenn ein Subagent aufgerufen wird, suchen Sie nach `tool_use`-Blöcken, bei denen `name` gleich `"Agent"` ist.

325 325 

326Nachrichten aus dem Kontext eines Subagenten enthalten ein `parent_tool_use_id`-Feld. In TypeScript enthält außerdem jede Assistenten- und Benutzernachricht, die ein Subagent erzeugt, [`agent_id`](/docs/de/agent-sdk/typescript#sdkassistantmessage): die `task_id` der [Task-Ereignisse](/docs/de/agent-sdk/typescript#sdktaskstartedmessage) dieses Subagenten. `agent_id` erfordert TypeScript Agent SDK v0.3.292 oder höher.326Nachrichten aus dem Kontext eines Subagenten enthalten ein `parent_tool_use_id`-Feld. In TypeScript enthält außerdem jede Assistenten- und Benutzernachricht, die ein Subagent erzeugt, [`agent_id`](/docs/de/agent-sdk/typescript#sdkassistantmessage): die `task_id` der [Task-Ereignisse](/docs/de/agent-sdk/typescript#sdktaskstartedmessage) dieses Subagenten. `agent_id` bleibt gleich, wenn Sie [den Subagenten fortsetzen](#resume-subagents). `agent_id` erfordert TypeScript Agent SDK v0.3.292 oder höher.

327 327 

328> [!NOTE]328> [!NOTE]

329>329>

Details

8 8 

9Claude Code stellt die [Task-Tracking-Tools](/docs/de/tools-reference#task-tool-availability) standardmäßig nur auf den unter [Modellverfügbarkeit](#model-availability) aufgelisteten Modellen bereit. Neuere Modelle verfolgen mehrstufige Arbeiten ohne eine schriftliche Todo-Liste, daher benötigen Sie auf diesen nichts auf dieser Seite, damit Claude mehrstufige Aufgaben durcharbeitet.9Claude Code stellt die [Task-Tracking-Tools](/docs/de/tools-reference#task-tool-availability) standardmäßig nur auf den unter [Modellverfügbarkeit](#model-availability) aufgelisteten Modellen bereit. Neuere Modelle verfolgen mehrstufige Arbeiten ohne eine schriftliche Todo-Liste, daher benötigen Sie auf diesen nichts auf dieser Seite, damit Claude mehrstufige Aufgaben durcharbeitet.

10 10 

11In einer Sitzung, die die Task-Tracking-Tools hat, führt Claude eine schriftliche Todo-Liste, aktualisiert den Status jedes Elements während der Arbeit. Sie sehen jede Änderung im Nachrichtenstrom als strukturierten Tool-Aufruf. Aktivieren Sie eine Sitzung nur, wenn Ihre Anwendung diese Tool-Aufrufe liest, sei es zum Protokollieren von Task-Aktivitäten oder zum Rendern einer eigenen Fortschrittsanzeige.11In einer Sitzung, die die Task-Tracking-Tools hat, führt Claude eine schriftliche Todo-Liste, aktualisiert den Status jedes Elements während der Arbeit. Sie sehen jede Änderung im Nachrichtenstrom als strukturierten Tool-Aufruf. Aktivieren Sie die Tools für eine Sitzung nur, wenn Ihre Anwendung diese Tool-Aufrufe liest, sei es zum Protokollieren von Task-Aktivitäten oder zum Rendern einer eigenen Fortschrittsanzeige.

12 12 

13## Modellverfügbarkeit13## Modellverfügbarkeit

14 14 


26>26>

27> Dieser Standardsatz gilt in Claude Code v2.1.268 und später, das das TypeScript Agent SDK ab v0.3.268 bündelt.27> Dieser Standardsatz gilt in Claude Code v2.1.268 und später, das das TypeScript Agent SDK ab v0.3.268 bündelt.

28 28 

29Bei einem Modell, das die Tools standardmäßig nicht hat, sehen Sie keine `tool_use`-Blöcke für diese im Nachrichtenstrom, es sei denn, Sie aktivieren eine Sitzung. Das Agent SDK wendet diese Standardeinstellungen über die Claude Code-Binärdatei an, die es bündelt. Wenn Sie `pathToClaudeCodeExecutable` (TypeScript) oder `cli_path` (Python) auf Ihre eigene Claude Code-Installation verweisen, erhalten Sie die Tools, die diese Installation bereitstellt, unter ihren eigenen Standardeinstellungen. Um die genaue Menge in einer laufenden Sitzung zu sehen, [überprüfen Sie, welche Tools verfügbar sind](/docs/de/tools-reference#check-which-tools-are-available). Um eine Sitzung zu aktivieren, führen Sie eines der folgenden Verfahren durch:29Bei einem Modell, das die Tools standardmäßig nicht hat, sehen Sie keine `tool_use`-Blöcke für diese im Nachrichtenstrom, es sei denn, Sie aktivieren die Tools für eine Sitzung. Das Agent SDK wendet diese Standardeinstellungen über die Claude Code-Binärdatei an, die es bündelt. Wenn Sie `pathToClaudeCodeExecutable` (TypeScript) oder `cli_path` (Python) auf Ihre eigene Claude Code-Installation verweisen, erhalten Sie die Tools, die diese Installation bereitstellt, unter ihren eigenen Standardeinstellungen. Um die genaue Menge in einer laufenden Sitzung zu sehen, [überprüfen Sie, welche Tools verfügbar sind](/docs/de/tools-reference#check-which-tools-are-available). Um die Tools für eine Sitzung zu aktivieren, führen Sie eines der folgenden Verfahren durch:

30 30 

31* Nennen Sie eines der Tools in der Option [`allowedTools`](/docs/de/agent-sdk/permissions#allow-and-deny-rules) (TypeScript) oder `allowed_tools` (Python)31* Nennen Sie eines der Tools in der Option [`allowedTools`](/docs/de/agent-sdk/permissions#allow-and-deny-rules) (TypeScript) oder `allowed_tools` (Python)

32* Listen Sie die Tools in der Option `tools` auf, die die integrierten Tools der Sitzung auf die beschriebenen beschränkt. Fügen Sie die gewünschten Tools neben den anderen integrierten Tools ein, die Sie verwenden32* Listen Sie die Tools in der Option `tools` auf, die die integrierten Tools der Sitzung auf die beschriebenen beschränkt. Fügen Sie die gewünschten Tools neben den anderen integrierten Tools ein, die Sie verwenden

Details

660| `supportedModels()` | Gibt verfügbare Modelle mit Anzeigeinformationen zurück |660| `supportedModels()` | Gibt verfügbare Modelle mit Anzeigeinformationen zurück |

661| `supportedAgents()` | Gibt verfügbare Subagenten als [`AgentInfo`](#agentinfo)`[]` zurück |661| `supportedAgents()` | Gibt verfügbare Subagenten als [`AgentInfo`](#agentinfo)`[]` zurück |

662| `mcpServerStatus()` | Gibt den Status verbundener MCP-Server als [`McpServerStatus`](#mcpserverstatus)`[]` zurück |662| `mcpServerStatus()` | Gibt den Status verbundener MCP-Server als [`McpServerStatus`](#mcpserverstatus)`[]` zurück |

663| `getContextUsage(opts?)` | Gibt eine [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) zurück, die die Nutzung des Kontextfensters der Sitzung nach Kategorie, Skill und Tool aufschlüsselt. Mit dem Standardwert für `detail` sind dies dieselben Daten, die `/context` in einer interaktiven Sitzung anzeigt, berechnet mit API-Anfragen zur Token-Zählung, die nicht im Nachrichtenstream erscheinen; siehe [wie diese Anfragen behandelt werden](#sdkcontrolgetcontextusageresponse). Die [Option `detail`](#sdkcontrolgetcontextusageresponse) erfordert Agent SDK v0.3.257 oder höher |663| `getContextUsage(opts?)` | Gibt eine [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) zurück, die die Nutzung des Kontextfensters der Sitzung nach Kategorie, Skill und Tool aufschlüsselt. Mit dem Standardwert von `detail` enthält sie die Daten, die `/context` in einer interaktiven Sitzung anzeigt, berechnet mit Token-Counting-API-Anfragen, die nicht im Nachrichtenstream erscheinen; siehe [wie diese Anfragen behandelt werden](#sdkcontrolgetcontextusageresponse). Die [Option `detail`](#sdkcontrolgetcontextusageresponse) erfordert Agent SDK v0.3.257 oder höher |

664| `readFile(path, options?)` | Liest eine Datei aus dem Dateisystem der Sitzung. Claude Code löst den Pfad relativ zu `cwd` auf; [Was `readFile()` lesen kann](#what-readfile-can-read) listet die Dateien auf, die bereitgestellt werden. Übergeben Sie `{ maxBytes }`, um die Leseobergrenze zu ändern (Standard 1 MB, Maximum 10 MB), und `{ encoding: 'base64' }` für Binärdateien wie Bilder. Wird mit einer [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) aufgelöst oder bei verweigerter Berechtigung, fehlender Datei oder Transportfehler mit `null`. Erfordert TypeScript SDK v0.2.121 oder höher |664| `readFile(path, options?)` | Liest eine Datei aus dem Dateisystem der Sitzung. Claude Code löst den Pfad relativ zu `cwd` auf; [Was `readFile()` lesen kann](#what-readfile-can-read) listet die Dateien auf, die bereitgestellt werden. Übergeben Sie `{ maxBytes }`, um die Leseobergrenze zu ändern (Standard 1 MB, Maximum 10 MB), und `{ encoding: 'base64' }` für Binärdateien wie Bilder. Wird mit einer [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) aufgelöst oder bei verweigerter Berechtigung, fehlender Datei oder Transportfehler mit `null`. Erfordert TypeScript SDK v0.2.121 oder höher |

665| `reloadPlugins(options?)` | Lädt Plugins von der Festplatte neu, sodass Plugins, die Sie während der Sitzung installieren oder bearbeiten, die laufende Sitzung erreichen. Wird mit einer [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) aufgelöst, die die Befehle, Subagenten, Plugins und den MCP-Server-Status der Sitzung auflistet. Erfordert Agent SDK v0.2.85 oder höher. Die [Option `holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) erfordert Agent SDK v0.3.268 oder höher |665| `reloadPlugins(options?)` | Lädt Plugins von der Festplatte neu, sodass Plugins, die Sie während der Sitzung installieren oder bearbeiten, die laufende Sitzung erreichen. Wird mit einer [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) aufgelöst, die die Befehle, Subagenten, Plugins und den MCP-Server-Status der Sitzung auflistet. Erfordert Agent SDK v0.2.85 oder höher. Die [Option `holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) erfordert Agent SDK v0.3.268 oder höher |

666| `reloadSkills()` | Lädt Skills von der Festplatte neu, sodass Skills, die Sie während der Sitzung hinzufügen oder bearbeiten, in der laufenden Sitzung verfügbar werden. Wird mit einer [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) aufgelöst, die die nach dem Neuladen verfügbaren Skills auflistet. Erfordert Agent SDK v0.3.163 oder höher |666| `reloadSkills()` | Lädt Skills von der Festplatte neu, sodass Skills, die Sie während der Sitzung hinzufügen oder bearbeiten, in der laufenden Sitzung verfügbar werden. Wird mit einer [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) aufgelöst, die die nach dem Neuladen verfügbaren Skills auflistet. Erfordert Agent SDK v0.3.163 oder höher |


863 863 

864### `SDKControlGetContextUsageResponse`864### `SDKControlGetContextUsageResponse`

865 865 

866Rückgabetyp von [`getContextUsage()`](#query-object). Mit dem Standardwert für `detail` ist dies dieselbe Payload, die Claude Code für den Befehl `/context` in einer interaktiven Sitzung darstellt. Neben den Token-Zahlen enthält sie daher Anzeigefelder wie `color` und `gridRows`, mit denen Claude Code das Nutzungsraster von `/context` zeichnet.866Rückgabetyp von [`getContextUsage()`](#query-object). Mit dem Standardwert von `detail` enthält die Antwort die Payload, die Claude Code für den Befehl `/context` in einer interaktiven Sitzung darstellt. Neben den Token-Zahlen enthält diese Payload Anzeigefelder wie `color` und `gridRows`, mit denen Claude Code das Nutzungsraster von `/context` zeichnet.

867 867 

868Das optionale Argument `detail` der Methode legt fest, wie Claude Code jede Kategorie zählt. Das Argument `detail` erfordert Agent SDK v0.3.257 oder höher.868Das optionale Argument `detail` der Methode legt fest, wie Claude Code jede Kategorie zählt. Das Argument `detail` erfordert Agent SDK v0.3.257 oder höher.

869 869 


872 872 

873Wenn Sie `/context` als Prompt senden, anstatt die Methode aufzurufen, hängt Claude Code eine [`SDKContextUsage`](#sdkcontextusage)-Payload an das Feld `context_usage` der Assistant-Nachricht an, die das Ergebnis liefert. Dieses Feld erfordert Agent SDK v0.3.232 oder höher.873Wenn Sie `/context` als Prompt senden, anstatt die Methode aufzurufen, hängt Claude Code eine [`SDKContextUsage`](#sdkcontextusage)-Payload an das Feld `context_usage` der Assistant-Nachricht an, die das Ergebnis liefert. Dieses Feld erfordert Agent SDK v0.3.232 oder höher.

874 874 

875In `SDKControlGetContextUsageResponse` erfordern `categories[].id`, `mcpInstructions` sowie die Felder `pluginId` und `path` der Einträge in `agents` und `skills.skillFrontmatter` Agent SDK v0.3.304 oder höher.

876 

875```typescript theme={null}877```typescript theme={null}

876type SDKControlGetContextUsageResponse = {878type SDKControlGetContextUsageResponse = {

877 categories: {879 categories: {

880 id?:

881 | "system_prompt"

882 | "system_tools"

883 | "mcp_tools"

884 | "mcp_instructions"

885 | "mcp_tools_deferred"

886 | "system_tools_deferred"

887 | "custom_agents"

888 | "memory_files"

889 | "skills"

890 | "messages"

891 | "autocompact_buffer"

892 | "compact_buffer"

893 | "free_space";

878 name: string;894 name: string;

879 tokens: number;895 tokens: number;

880 color: string;896 color: string;


905 tokens: number;921 tokens: number;

906 isLoaded?: boolean;922 isLoaded?: boolean;

907 }[];923 }[];

924 mcpInstructions?: {

925 serverName: string;

926 tokens: number;

927 }[];

908 deferredBuiltinTools?: {928 deferredBuiltinTools?: {

909 name: string;929 name: string;

910 tokens: number;930 tokens: number;


921 agents: {941 agents: {

922 agentType: string;942 agentType: string;

923 source: string;943 source: string;

944 pluginId?: string;

945 path?: string;

924 tokens: number;946 tokens: number;

925 }[];947 }[];

926 slashCommands?: {948 slashCommands?: {


935 skillFrontmatter: {957 skillFrontmatter: {

936 name: string;958 name: string;

937 source: string;959 source: string;

960 pluginName?: string;

961 pluginId?: string;

962 path?: string;

938 tokens: number;963 tokens: number;

939 }[];964 }[];

940 };965 };


978 1003 

979Claude Code lässt die optionalen Diagnosefelder `deferredBuiltinTools`, `systemTools` und `systemPromptSections` ungesetzt; rechnen Sie also damit, dass sie fehlen, obwohl der Typ sie deklariert.1004Claude Code lässt die optionalen Diagnosefelder `deferredBuiltinTools`, `systemTools` und `systemPromptSections` ungesetzt; rechnen Sie also damit, dass sie fehlen, obwohl der Typ sie deklariert.

980 1005 

1006#### Eine Zeile anhand der ID, die Anweisungs-Token eines Servers oder Plugin und Datei eines Eintrags finden

1007 

1008MCP-Server-Anweisungen sind die Nutzungshinweise, die verbundene Server bereitstellen und Claude Code dem Kontext hinzufügt, und die Zeile `mcp_instructions` von `categories` zählt ihre Token. Verwenden Sie diese Felder von [`getContextUsage()`](#query-object), um eine Zeile von `categories` anhand von `id` herauszugreifen, die Token von `mcp_instructions` nach Server aufzuteilen oder das Plugin und die Datei hinter einem Agenten- oder Skill-Eintrag zu finden:

1009 

1010| Feld | Vorhanden in | Inhalt |

1011| :- | :- | :- |

1012| `id` | Jeder Zeile von `categories` | Die Kennung der Zeile, einer der Werte, die der [Antworttyp](#sdkcontrolgetcontextusageresponse) auflistet, etwa `mcp_instructions`. Gleichen Sie auf `id` ab, um eine Zeile herauszugreifen, oder auf `kind`, um Zeilen zu gruppieren. Eine spätere Claude Code-Version kann einen Wert senden, den Ihre installierten Typen nicht auflisten; behandeln Sie eine `id`, die Sie nicht kennen, daher als nicht vorhanden |

1013| `mcpInstructions` | Der Antwort | Ein Eintrag `{ serverName, tokens }` pro verbundenem MCP-Server, der Anweisungen bereitstellt, oder ein leeres Array, wenn keiner dies tut. Die `tokens`-Werte sind Schätzungen, die sich zu den `tokens` der Zeile `mcp_instructions` summieren. `serverName` ist der `name`, den [`mcpServerStatus()`](#query-object) für diesen Server meldet |

1014| `pluginId` | Einträgen von `agents` und `skills.skillFrontmatter` | Nennt das Plugin, aus dem der Eintrag stammt, als ID in der Form `name@marketplace`, und fehlt bei einem Eintrag, der nicht aus einem Plugin stammt. Wenn das Plugin nicht aus einem Marketplace stammt, nennt der Teil nach `@` stattdessen [seine Herkunft](/docs/de/plugins/loading#find-where-a-plugin-came-from), etwa `inline` für eines, das Sie über die Option [`plugins`](#options) geladen haben |

1015| `path` | Einträgen von `agents` und `skills.skillFrontmatter` | Absoluter Pfad der Datei, die den Agenten oder Skill definiert, auf dem Rechner, auf dem Claude Code läuft. Das Feld fehlt, wenn keine Datei den Eintrag definiert, zum Beispiel bei einem Agenten aus der Option [`agents`](#options) oder einem in Claude Code integrierten Skill |

1016 

1017Als Beispiel für den Abgleich auf `id` findet dieses Beispiel die Zeile `mcp_instructions`:

1018 

1019```typescript theme={null}

1020// q is the Query object that query() returned

1021const usage = await q.getContextUsage();

1022// undefined if no connected server supplies instructions

1023const row = usage.categories.find((c) => c.id === "mcp_instructions");

1024```

1025 

981### `SDKControlReadFileResponse`1026### `SDKControlReadFileResponse`

982 1027 

983Rückgabetyp von [`readFile()`](#query-object).1028Rückgabetyp von [`readFile()`](#query-object).


2989 3034 

2990Dokumentation von Eingabeschemas für integrierte Claude Code-Tools. Diese Typen werden aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert und können für typsichere Tool-Interaktionen verwendet werden.3035Dokumentation von Eingabeschemas für integrierte Claude Code-Tools. Diese Typen werden aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert und können für typsichere Tool-Interaktionen verwendet werden.

2991 3036 

3037Das Tool `StructuredOutput` hat hier keinen Typ: Claude Code erstellt sein Eingabeschema aus dem Schema, das Sie an `outputFormat` übergeben, daher gibt es nichts Festes zu exportieren. Unter [StructuredOutput-Tool-Aufruf erkennen](/docs/de/agent-sdk/structured-outputs#recognize-the-structuredoutput-tool-call) sehen Sie, wie dieser Aufruf in Ihrem Nachrichtenstream aussieht.

3038 

2992### `ToolInputSchemas`3039### `ToolInputSchemas`

2993 3040 

2994Union von Tool-Eingabetypen, die aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert werden; Mitglieder umfassen:3041Union von Tool-Eingabetypen, die aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert werden; Mitglieder umfassen:


5204* **Server, die der Aufruf nicht benennt**: Außerhalb einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) trennt Claude Code die Server, die ein früherer `setMcpServers()`-Aufruf hinzugefügt hat, sowie die In-Process-SDK-Server und listet sie in `removed` auf. Andere Server laufen weiter und werden nicht in `removed` aufgeführt, darunter die Stdio-, HTTP- und SSE-Server aus der [`mcpServers`](#options)-Option, Server aus Einstellungsdateien und von Plugins bereitgestellte Server.5251* **Server, die der Aufruf nicht benennt**: Außerhalb einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) trennt Claude Code die Server, die ein früherer `setMcpServers()`-Aufruf hinzugefügt hat, sowie die In-Process-SDK-Server und listet sie in `removed` auf. Andere Server laufen weiter und werden nicht in `removed` aufgeführt, darunter die Stdio-, HTTP- und SSE-Server aus der [`mcpServers`](#options)-Option, Server aus Einstellungsdateien und von Plugins bereitgestellte Server.

5205* **Server, die der Aufruf benennt**: Claude Code ersetzt einen Stdio-, HTTP- oder SSE-Server, den ein früherer `setMcpServers()`-Aufruf hinzugefügt hat, nur, wenn sich seine Konfiguration von der unterscheidet, die Sie übergeben haben. Ein In-Process-SDK-Server, der bereits unter diesem Namen registriert ist, bleibt unverändert; um einen auszutauschen, lassen Sie ihn in einem Aufruf weg und fügen Sie ihn im nächsten hinzu.5252* **Server, die der Aufruf benennt**: Claude Code ersetzt einen Stdio-, HTTP- oder SSE-Server, den ein früherer `setMcpServers()`-Aufruf hinzugefügt hat, nur, wenn sich seine Konfiguration von der unterscheidet, die Sie übergeben haben. Ein In-Process-SDK-Server, der bereits unter diesem Namen registriert ist, bleibt unverändert; um einen auszutauschen, lassen Sie ihn in einem Aufruf weg und fügen Sie ihn im nächsten hinzu.

5206* **Integrierte Server, die die CLI beim Start gestartet hat**: Wenn der Aufruf einen benennt, verwirft Claude Code diesen Eintrag und meldet ihn in `errors`.5253* **Integrierte Server, die die CLI beim Start gestartet hat**: Wenn der Aufruf einen benennt, verwirft Claude Code diesen Eintrag und meldet ihn in `errors`.

5254* **Stdio-, HTTP- oder SSE-Server, die ihren Namen mit einem Server aus einem MCP-Installations-Geltungsbereich wie `.mcp.json` teilen**: Unter diesem Namen verwendet die Sitzung die Tools Ihres Servers statt die des [Servers aus dem Installations-Geltungsbereich](/docs/de/mcp#mcp-installation-scopes). Vor Claude Code v2.1.305 konnte Claude Code Ihren Server trennen und den Server aus dem Installations-Geltungsbereich verbinden, wenn Ihre App [Plugins neu lud](#query-object).

5207 5255 

5208Das Promise wird aufgelöst, nachdem neu hinzugefügte Stdio-, HTTP- und SSE-Server verbunden oder fehlgeschlagen sind, daher sind Tools von Servern, die verbunden sind, im nächsten Turn verfügbar.5256Das Promise wird aufgelöst, nachdem neu hinzugefügte Stdio-, HTTP- und SSE-Server verbunden oder fehlgeschlagen sind, daher sind Tools von Servern, die verbunden sind, im nächsten Turn verfügbar.

5209 5257 

agent-teams.md +56 −54

Details

34| | Subagents | Agent-Teams |34| | Subagents | Agent-Teams |

35| :- | :- | :- |35| :- | :- | :- |

36| **Kontext** | Eigenes Kontextfenster; Ergebnisse kehren zum Aufrufer zurück | Eigenes Kontextfenster; vollständig unabhängig |36| **Kontext** | Eigenes Kontextfenster; Ergebnisse kehren zum Aufrufer zurück | Eigenes Kontextfenster; vollständig unabhängig |

37| **Kommunikation** | Ergebnis an den Aufrufer zurückgeben. Subagents, die Claude beim Spawnen benannt hat, können sich auch [gegenseitig Nachrichten senden](/docs/de/sub-agents#what-loads-at-startup) | Teammates senden sich gegenseitig direkt Nachrichten |37| **Kommunikation** | Ergebnis an den Aufrufer zurückgeben. Subagenten, die Claude beim Spawnen [benannt](/docs/de/sub-agents#subagent-names) hat, können sich auch [gegenseitig Nachrichten senden](/docs/de/sub-agents#what-loads-at-startup) | Teammates senden sich gegenseitig direkt Nachrichten |

38| **Koordination** | Hauptagent verwaltet alle Arbeiten | Selbstkoordination durch Nachrichten, plus eine gemeinsame Aufgabenliste für [Agenten, die die Task-Tools haben](/docs/de/tools-reference#task-tool-availability) |38| **Koordination** | Hauptagent verwaltet alle Arbeiten | Selbstkoordination durch Nachrichten, plus eine gemeinsame Aufgabenliste für [Agenten, die die Task-Tools haben](/docs/de/tools-reference#task-tool-availability) |

39| **Am besten für** | Fokussierte Aufgaben, bei denen nur das Ergebnis zählt | Komplexe Arbeit, die Diskussion und Zusammenarbeit erfordert |39| **Am besten für** | Fokussierte Aufgaben, bei denen nur das Ergebnis zählt | Komplexe Arbeit, die Diskussion und Zusammenarbeit erfordert |

40| **Token-Kosten** | Niedriger: Ergebnisse werden zum Hauptkontext zusammengefasst | Höher: jeder Teammate ist eine separate Claude-Instanz |40| **Token-Kosten** | Niedriger: Ergebnisse werden zum Hauptkontext zusammengefasst | Höher: jeder Teammate ist eine separate Claude-Instanz |


85 85 

86Wenn Sie jeden Teammate in seinem eigenen Split-Pane haben möchten, siehe [Wählen Sie einen Anzeigemodus](#choose-a-display-mode).86Wenn Sie jeden Teammate in seinem eigenen Split-Pane haben möchten, siehe [Wählen Sie einen Anzeigemodus](#choose-a-display-mode).

87 87 

88## Kontrolle Ihres Agent-Teams88## Ihr Agent-Team steuern

89 89 

90Teilen Sie dem Lead in natürlicher Sprache mit, was Sie möchten. Es kümmert sich um Teamkoordination, Aufgabenzuweisung und Delegation basierend auf Ihren Anweisungen.90Teilen Sie dem Lead in natürlicher Sprache mit, was Sie möchten. Er übernimmt die Teamkoordination, die Aufgabenzuweisung und die Delegation auf Grundlage Ihrer Anweisungen.

91 91 

92### Wählen Sie einen Anzeigemodus92### Einen Anzeigemodus wählen

93 93 

94Agent-Teams unterstützen zwei Anzeigemodi:94Agent-Teams unterstützen zwei Anzeigemodi:

95 95 

96* **In-Process**: alle Teammates laufen in Ihrem Hauptterminal. Verwenden Sie die Pfeiltasten nach oben und unten im Agent-Panel, um einen Teammate auszuwählen, drücken Sie dann die Eingabetaste, um ihn anzuzeigen und geben Sie ein, um ihm direkt eine Nachricht zu senden. Funktioniert in jedem Terminal, keine zusätzliche Einrichtung erforderlich.96* **In-Process**: Alle Teammitglieder laufen in Ihrem Hauptterminal. Verwenden Sie die Pfeiltasten nach oben und unten im Agenten-Panel, um ein Teammitglied auszuwählen, drücken Sie dann die Eingabetaste, um es anzuzeigen, und tippen Sie, um ihm direkt eine Nachricht zu senden. Funktioniert in jedem Terminal, keine zusätzliche Einrichtung erforderlich.

97* **Split Panes**: jeder Teammate erhält seinen eigenen Pane. Sie können die Ausgabe aller gleichzeitig sehen und in einen Pane klicken, um direkt zu interagieren. Erfordert tmux oder iTerm2.97* **Geteilte Bereiche**: Jedes Teammitglied erhält einen eigenen Bereich. Sie sehen die Ausgabe aller gleichzeitig und können in einen Bereich klicken, um direkt damit zu interagieren. Erfordert tmux oder iTerm2.

98 98 

99> [!NOTE]99> [!NOTE]

100>100>

101> `tmux` hat bekannte Einschränkungen auf bestimmten Betriebssystemen und funktioniert traditionell am besten auf macOS. Die Verwendung von `tmux -CC` in iTerm2 ist der empfohlene Einstiegspunkt in `tmux`.101> `tmux` hat bekannte Einschränkungen auf bestimmten Betriebssystemen und funktioniert traditionell am besten unter macOS. Die Verwendung von `tmux -CC` in iTerm2 ist der empfohlene Einstieg in `tmux`.

102 102 

103Der Standard ist `"in-process"`. Setzen Sie `"auto"`, um Split Panes zu aktivieren, wenn Sie bereits in einer tmux-Sitzung ausgeführt werden oder Ihr Terminal iTerm2 mit der installierten `it2` CLI ist, und fallen Sie ansonsten auf In-Process zurück. Die Einstellung `"tmux"` aktiviert den Split-Pane-Modus und erkennt automatisch, ob tmux oder iTerm2 basierend auf Ihrem Terminal verwendet werden soll.103Der Standardwert ist `"in-process"`. Setzen Sie `"auto"`, um geteilte Bereiche zu aktivieren, wenn Sie bereits innerhalb einer tmux-Sitzung arbeiten oder Ihr Terminal iTerm2 mit installiertem `it2` CLI ist; andernfalls wird auf In-Process zurückgefallen. Die Einstellung `"tmux"` aktiviert den Modus mit geteilten Bereichen und erkennt anhand Ihres Terminals automatisch, ob tmux oder iTerm2 verwendet werden soll.

104 104 

105Setzen Sie `"iterm2"`, um native Split Panes von iTerm2 explizit zu verwenden. Dieser Modus erfordert die [`it2` CLI](https://github.com/mkusaka/it2) und zeigt einen Fehler mit dem Installationsbefehl an, wenn `it2` fehlt. Die Setup-Eingabeaufforderung, die angeboten wird, `it2` zu installieren oder zu tmux zu wechseln, wird unter `"auto"` oder `"tmux"` angezeigt, wenn Ihr Terminal iTerm2 ist und tmux als Fallback verfügbar ist.105Setzen Sie `"iterm2"`, um explizit die nativen geteilten Bereiche von iTerm2 zu verwenden. Dieser Modus erfordert das [`it2` CLI](https://github.com/mkusaka/it2) und zeigt einen Fehler mit dem Installationsbefehl an, wenn `it2` fehlt. Die Einrichtungsabfrage, die anbietet, `it2` zu installieren oder zu tmux zu wechseln, erscheint bei `"auto"` oder `"tmux"`, wenn Ihr Terminal iTerm2 ist und tmux als Fallback verfügbar ist.

106 106 

107Um den Standard zu überschreiben, setzen Sie [`teammateMode`](/docs/de/settings-reference#teammatemode) in `~/.claude/settings.json`:107Um den Standardwert zu überschreiben, setzen Sie [`teammateMode`](/docs/de/settings-reference#teammatemode) in `~/.claude/settings.json`:

108 108 

109```json theme={null}109```json theme={null}

110{110{


118claude --teammate-mode auto118claude --teammate-mode auto

119```119```

120 120 

121Das Flag `--teammate-mode` ist experimentell und wird nicht in `claude --help` angezeigt.121Das Flag `--teammate-mode` ist experimentell und erscheint nicht in `claude --help`.

122 122 

123Der Split-Pane-Modus erfordert entweder [tmux](https://github.com/tmux/tmux/wiki) oder iTerm2 mit der [`it2` CLI](https://github.com/mkusaka/it2). Zur manuellen Installation:123Der Modus mit geteilten Bereichen erfordert entweder [tmux](https://github.com/tmux/tmux/wiki) oder iTerm2 mit dem [`it2` CLI](https://github.com/mkusaka/it2). So installieren Sie manuell:

124 124 

125* **tmux**: installieren Sie über den Paketmanager Ihres Systems. Siehe das [tmux Wiki](https://github.com/tmux/tmux/wiki/Installing) für plattformspezifische Anweisungen.125* **tmux**: Installieren Sie es über den Paketmanager Ihres Systems. Plattformspezifische Anweisungen finden Sie im [tmux-Wiki](https://github.com/tmux/tmux/wiki/Installing).

126* **iTerm2**: installieren Sie die [`it2` CLI](https://github.com/mkusaka/it2), aktivieren Sie dann die Python-API in **iTerm2 → Settings → General → Magic → Enable Python API**.126* **iTerm2**: Installieren Sie das [`it2` CLI](https://github.com/mkusaka/it2) und aktivieren Sie dann die Python API unter **iTerm2 → Settings → General → Magic → Enable Python API**.

127 127 

128### Geben Sie Teammates und Modelle an128### Teammitglieder und Modelle festlegen

129 129 

130Claude entscheidet die Anzahl der zu erzeugenden Teammates basierend auf Ihrer Aufgabe, oder Sie können genau angeben, was Sie möchten:130Claude entscheidet anhand Ihrer Aufgabe, wie viele Teammitglieder erzeugt werden, oder Sie geben genau an, was Sie möchten:

131 131 

132```text wrap theme={null}132```text wrap theme={null}

133Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for133Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for

134each teammate.134each teammate.

135```135```

136 136 

137Claude Code wählt das Modell jedes Teammates aus dem ersten dieser Punkte aus, der zutrifft:137Claude Code wählt das Modell jedes Teammitglieds aus der ersten der folgenden Quellen, die zutrifft:

138 138 

1391. Das Modell, das Ihr Spawn-Prompt für diesen Teammate benennt.1391. Das Modell, das Ihr Spawn-Prompt für dieses Teammitglied nennt.

1402. Für einen Teammate, der aus einer [Subagent-Definition](#use-subagent-definitions-for-teammates) erzeugt wird, die `model` der Definition, wobei `inherit` das Modell des Leads auswählt.1402. Für ein Teammitglied, das aus einer [Subagent-Definition](#use-subagent-definitions-for-teammates) erzeugt wurde, das `model` der Definition, wobei `inherit` das Modell des Leads auswählt.

1413. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/de/model-config#environment-variables), wenn es auf etwas anderes als `inherit` gesetzt ist.1413. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/de/model-config#environment-variables), wenn diese Variable auf einen anderen Wert als `inherit` gesetzt ist.

1424. Das aktuelle Modell des Leads.1424. Das aktuelle Modell des Leads.

143 143 

144Wenn ein installierter [Mod](/docs/de/plugins/mods/overview) in seinem Hook [`agent.spawn`](/docs/de/plugins/mods/reference#subagents) ein Modell festlegt, verwendet Claude Code dieses Modell anstelle der ersten Quelle.144Wenn ein installierter [Mod](/docs/de/plugins/mods/overview) in seinem [`agent.spawn`](/docs/de/plugins/mods/reference#subagents)-Hook ein Modell festlegt, verwendet Claude Code dieses Modell anstelle der ersten Quelle.

145 145 

146Wenn Sie [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/de/sub-agents#run-every-subagent-on-one-model) setzen, gelten die ersten beiden Quellen nicht. Claude Code wählt das Modell jedes Teammates aus `CLAUDE_CODE_SUBAGENT_MODEL`, wenn es auf etwas anderes als `inherit` gesetzt ist, und ansonsten aus dem aktuellen Modell des Leads. Erfordert Claude Code v2.1.257 oder später.146Wenn Sie [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/de/sub-agents#run-every-subagent-on-one-model) setzen, gelten die ersten beiden Quellen nicht. Claude Code wählt das Modell jedes Teammitglieds aus `CLAUDE_CODE_SUBAGENT_MODEL`, wenn diese Variable auf einen anderen Wert als `inherit` gesetzt ist, und andernfalls aus dem aktuellen Modell des Leads. Erfordert Claude Code v2.1.257 oder neuer.

147 147 

148Vor v2.1.251 kam `CLAUDE_CODE_SUBAGENT_MODEL` zuerst in dieser Reihenfolge.148Vor v2.1.251 stand `CLAUDE_CODE_SUBAGENT_MODEL` an erster Stelle dieser Reihenfolge.

149 149 

150> [!NOTE]150> [!NOTE]

151>151>

152> `teammateDefaultModel` wurde in v2.1.234 entfernt; Claude Code ignoriert einen verbleibenden Wert. Benennen Sie das Modell stattdessen in Ihrem Prompt.152> `teammateDefaultModel` wurde in v2.1.234 entfernt; Claude Code ignoriert einen verbliebenen Wert. Nennen Sie das Modell stattdessen in Ihrem Prompt.

153 153 

154Claude Code überprüft das Modell, das es für einen Teammate auswählt, gegen die [`availableModels`](/docs/de/model-config#restrict-model-selection) Allowlist Ihrer Organisation. Wenn die Allowlist einen Wert blockiert, ersetzt Claude Code ein anderes Modell:154Claude Code prüft das Modell, das es für ein Teammitglied auswählt, anhand der [`availableModels`](/docs/de/model-config#restrict-model-selection)-Allowlist Ihrer Organisation. Wenn die Allowlist einen Wert blockiert, setzt Claude Code ein anderes Modell ein:

155 155 

156* **Family-Alias wie `opus`**: Auf der Anthropic API und Claude Platform auf AWS führt Claude Code den Teammate auf der neuesten Version dieser Familie aus, die die Allowlist zulässt. Bei Anbietern mit anbieterspezifischen Modell-IDs, bei denen die [Substitution nicht funktioniert](/docs/de/model-config#restrict-model-selection), fällt ein blockierter Alias wie jeder andere blockierte Wert gemäß dem nächsten Punkt zurück156* **Familienalias wie `opus`**: Bei der Anthropic API und der Claude Platform on AWS führt Claude Code das Teammitglied mit der neuesten Version dieser Familie aus, die die Allowlist zulässt. Bei Anbietern mit anbieterspezifischen Modell-IDs, bei denen die [Ersetzung nicht greift](/docs/de/model-config#restrict-model-selection), fällt ein blockierter Alias wie jeder andere blockierte Wert gemäß dem nächsten Punkt zurück

157* **Jeder andere blockierte Wert, einschließlich eines Family-Alias bei Anbietern, bei denen die Substitution nicht funktioniert, oder einer Familie, die keine zulässige Version hat**: Claude Code führt den Teammate auf dem Modell des Leads aus. Wenn Sie `CLAUDE_CODE_SUBAGENT_MODEL` setzen, versucht Claude Code zuerst dieses Modell unter denselben Regeln157* **Jeder andere blockierte Wert, einschließlich eines Familienalias bei Anbietern, bei denen die Ersetzung nicht greift, oder eines Alias, dessen Familie keine zulässige Version hat**: Claude Code führt das Teammitglied stattdessen mit dem Modell des Leads aus. Wenn Sie `CLAUDE_CODE_SUBAGENT_MODEL` setzen, versucht Claude Code zuerst dieses Modell, nach denselben Regeln

158 158 

159Standardmäßig erben Teammates die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) des Leads. Im Split-Pane-Modus gilt dies ab v2.1.186; frühere Versionen haben die Effort-Stufe der Lead-Sitzung nicht an Split-Pane-Teammates weitergegeben.159Standardmäßig übernehmen Teammitglieder die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) des Leads. Im Modus mit geteilten Bereichen gilt dies ab v2.1.186; frühere Versionen haben die Effort-Stufe der Sitzung des Leads nicht an Teammitglieder in geteilten Bereichen weitergegeben.

160 160 

161### Genehmigung von Plänen für Teammates erforderlich161### Teammitglieder vor der Implementierung planen lassen

162 162 

163Für komplexe oder riskante Aufgaben können Sie verlangen, dass Teammates planen, bevor sie implementieren. Ein Teammate, den Claude erzeugt, während der Lead im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) ist, arbeitet im schreibgeschützten Plan-Modus, bis sein Plan fertig ist. Schalten Sie den Lead zuerst in den Plan-Modus und fragen Sie dann nach dem Teammate:163Bei komplexen oder riskanten Aufgaben können Sie Teammitglieder vor der Implementierung planen lassen. Ein Teammitglied, das Claude erzeugt, während sich der Lead im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) befindet, arbeitet im nur lesenden Plan-Modus, bis sein Plan fertig ist. Versetzen Sie zuerst den Lead in den Plan-Modus und fordern Sie dann das Teammitglied an:

164 164 

165```text wrap theme={null}165```text wrap theme={null}

166Spawn an architect teammate to refactor the authentication module.166Spawn an architect teammate to refactor the authentication module.

167```167```

168 168 

169Wenn ein Teammate die Planung abgeschlossen hat, sendet er eine Genehmigungsanfrage an den Lead. Claude Code genehmigt den Plan in der Sitzung des Leads, sobald die Anfrage ankommt, ohne dass der Lead ihn überprüft. Die Änderungen und Befehle des Teammates durchlaufen weiterhin die in [Berechtigungen](#permissions) beschriebenen Genehmigungsaufforderungen. Nach der Genehmigung beendet der Teammate den Plan-Modus und beginnt mit der Implementierung.169Wenn dieses Teammitglied mit der Planung fertig ist, sendet es eine Anfrage zur Plangenehmigung an den Lead. Wenn Sie den Berechtigungsmodus dieses Teammitglieds seit seiner Erzeugung nicht geändert haben, genehmigt Claude Code den Plan, sobald die Anfrage eintrifft, ohne dass der Lead ihn prüft. Die Bearbeitungen und Befehle des Teammitglieds durchlaufen weiterhin die unter [Berechtigungen](#permissions) beschriebenen Berechtigungsabfragen. Nach der Genehmigung verlässt das Teammitglied den Plan-Modus und beginnt mit der Implementierung.

170 170 

171### Sprechen Sie direkt mit Teammates171Wenn Sie ein laufendes In-Process-Teammitglied in den Plan-Modus versetzen, indem Sie beim Anzeigen seiner Sitzung [`Shift+Tab`](/docs/de/permission-modes#switch-permission-modes) drücken, prüft der Lead den Plan dieses Durchlaufs, anstatt dass Claude Code ihn genehmigt. Sie werden nicht um Genehmigung gebeten; der Lead genehmigt den Plan oder schickt ihn zur Überarbeitung zurück.

172 172 

173Jeder Teammate ist eine vollständige, unabhängige Claude Code-Sitzung. Sie können jedem Teammate direkt eine Nachricht senden, um zusätzliche Anweisungen zu geben, Folgefragen zu stellen oder seinen Ansatz umzuleiten.173### Direkt mit Teammitgliedern sprechen

174 174 

175* **In-Process-Modus**: verwenden Sie die Pfeiltasten nach oben und unten im Agent-Panel, um einen Teammate auszuwählen, drücken Sie dann die Eingabetaste, um seine Sitzung anzuzeigen und geben Sie ein, um ihm eine Nachricht zu senden. Drücken Sie `x` auf einem ausgewählten Teammate, um ihn zu stoppen. Drücken Sie Ctrl+T, um die Aufgabenliste umzuschalten.175Jedes Teammitglied ist eine vollständige, unabhängige Claude Code-Sitzung. Sie können jedem Teammitglied direkt eine Nachricht senden, um zusätzliche Anweisungen zu geben, Rückfragen zu stellen oder seine Vorgehensweise umzulenken.

176* **Split-Pane-Modus**: klicken Sie in den Pane eines Teammates, um direkt mit seiner Sitzung zu interagieren. Jeder Teammate hat eine vollständige Ansicht seines eigenen Terminals.

177 176 

178Während Sie einen In-Process-Teammate anzeigen, gehen einfacher Text und [Skills](/docs/de/skills) an diesen Teammate, und integrierte Befehle gehen an die Sitzung des Leads, mit diesen Schutzmechanismen:177* **In-Process-Modus**: Verwenden Sie die Pfeiltasten nach oben und unten im Agenten-Panel, um ein Teammitglied auszuwählen, drücken Sie dann die Eingabetaste, um seine Sitzung anzuzeigen, und tippen Sie, um ihm eine Nachricht zu senden. Drücken Sie `x` bei einem ausgewählten Teammitglied, um es zu stoppen. Drücken Sie Ctrl+T, um die Aufgabenliste ein- oder auszublenden.

178* **Modus mit geteilten Bereichen**: Klicken Sie in den Bereich eines Teammitglieds, um direkt mit seiner Sitzung zu interagieren. Jedes Teammitglied hat eine vollständige Ansicht seines eigenen Terminals.

179 

180Während Sie ein In-Process-Teammitglied anzeigen, gehen einfacher Text und [Skills](/docs/de/skills) an dieses Teammitglied, und integrierte Befehle gehen an die Sitzung des Leads, mit folgenden Schutzmaßnahmen:

179 181 

180* `/compact`, `/clear` und `/rewind` wirken auf die Konversation des Leads, daher bittet Claude Code Sie um Bestätigung, bevor einer dieser Befehle aus dieser Ansicht ausgeführt wird.182* `/compact`, `/clear` und `/rewind` wirken auf die Konversation des Leads, daher bittet Claude Code Sie um Bestätigung, bevor einer dieser Befehle aus dieser Ansicht ausgeführt wird.

181* `/model` und `/fast` legen das Modell und den Fast-Modus des Leads fest, nicht die des Teammates, daher werden sie aus dieser Ansicht nicht ausgeführt. Ein Hinweis erklärt Ihnen, warum.183* `/model` und `/fast` legen das Modell und den Fast-Modus des Leads fest, nicht die des Teammitglieds, daher werden sie aus dieser Ansicht nicht ausgeführt. Ein Hinweis erklärt Ihnen den Grund.

182 184 

183Das Modell und der Fast-Modus eines Teammates sind festgelegt, wenn er erzeugt wird.185Das Modell und der Fast-Modus eines Teammitglieds werden bei seiner Erzeugung festgelegt.

184 186 

185### Aufgaben zuweisen und beanspruchen187### Aufgaben zuweisen und übernehmen

186 188 

187Die gemeinsame Aufgabenliste koordiniert die Arbeit im Team. Der Lead erstellt Aufgaben und Teammates arbeiten sie durch. Aufgaben haben drei Zustände: ausstehend, in Bearbeitung und abgeschlossen. Aufgaben können auch von anderen Aufgaben abhängen: eine ausstehende Aufgabe mit ungelösten Abhängigkeiten kann nicht beansprucht werden, bis diese Abhängigkeiten erfüllt sind.189Die gemeinsame Aufgabenliste koordiniert die Arbeit im gesamten Team. Der Lead erstellt Aufgaben, und die Teammitglieder arbeiten sie ab. Aufgaben haben drei Zustände: ausstehend, in Bearbeitung und abgeschlossen. Aufgaben können auch von anderen Aufgaben abhängen: Eine ausstehende Aufgabe mit ungelösten Abhängigkeiten kann erst übernommen werden, wenn diese Abhängigkeiten abgeschlossen sind.

188 190 

189Agents [ohne die Task-Tools](/docs/de/tools-reference#task-tool-availability) koordinieren sich stattdessen durch Nachrichten.191Agenten [ohne die Task-Tools](/docs/de/tools-reference#task-tool-availability) koordinieren sich stattdessen über Nachrichten statt über die gemeinsame Aufgabenliste.

190 192 

191Der Lead kann Aufgaben explizit zuweisen oder Teammates können selbst beanspruchen:193Der Lead kann Aufgaben explizit zuweisen, oder Teammitglieder können sie selbst übernehmen:

192 194 

193* **Lead weist zu**: teilen Sie dem Lead mit, welche Aufgabe welchem Teammate gegeben werden soll195* **Lead weist zu**: Teilen Sie dem Lead mit, welche Aufgabe er welchem Teammitglied geben soll

194* **Selbst beanspruchen**: nach Abschluss einer Aufgabe wählt ein Teammate die nächste nicht zugewiesene, nicht blockierte Aufgabe selbst aus196* **Selbst übernehmen**: Nach Abschluss einer Aufgabe übernimmt ein Teammitglied selbstständig die nächste nicht zugewiesene, nicht blockierte Aufgabe

195 197 

196Das Beanspruchen von Aufgaben verwendet Dateisperrung, um Race Conditions zu verhindern, wenn mehrere Teammates versuchen, gleichzeitig dieselbe Aufgabe zu beanspruchen.198Die Übernahme von Aufgaben verwendet Dateisperren, um Race Conditions zu verhindern, wenn mehrere Teammitglieder gleichzeitig versuchen, dieselbe Aufgabe zu übernehmen.

197 199 

198### Teammates herunterfahren200### Teammitglieder beenden

199 201 

200Um die Sitzung eines Teammates ordnungsgemäß zu beenden, beziehen Sie sich auf ihn mit seinem Namen. Zum Beispiel mit einem Teammate namens researcher:202Um die Sitzung eines Teammitglieds ordnungsgemäß zu beenden, sprechen Sie es mit seinem Namen an. Zum Beispiel bei einem Teammitglied namens researcher:

201 203 

202```text wrap theme={null}204```text wrap theme={null}

203Ask the researcher teammate to shut down205Ask the researcher teammate to shut down

204```206```

205 207 

206Der Lead sendet eine Abschaltungsanfrage. Der Teammate kann zustimmen und ordnungsgemäß beenden oder mit einer Erklärung ablehnen.208Der Lead sendet eine Anfrage zum Beenden. Das Teammitglied kann zustimmen und sich ordnungsgemäß beenden oder mit einer Begründung ablehnen.

207 209 

208Die gemeinsamen Verzeichnisse des Teams werden automatisch bereinigt, wenn die Sitzung endet, daher gibt es keinen separaten Bereinigungsschritt. Unter [Architektur](#architecture) erfahren Sie, welche Verzeichnisse entfernt werden und welche auf der Festplatte verbleiben.210Die gemeinsamen Verzeichnisse des Teams werden beim Ende der Sitzung automatisch bereinigt, daher gibt es keinen separaten Bereinigungsschritt. Unter [Architektur](#architecture) erfahren Sie, welche Verzeichnisse entfernt werden und welche auf dem Datenträger verbleiben.

209 211 

210### Erzwingen Sie Qualitätsgates mit Hooks212### Qualitätsprüfungen mit Hooks durchsetzen

211 213 

212Verwenden Sie [Hooks](/docs/de/hooks), um Regeln durchzusetzen, wenn Teammates ihre Arbeit abschließen oder Aufgaben erstellt oder abgeschlossen werden:214Verwenden Sie [Hooks](/docs/de/hooks), um Regeln durchzusetzen, wenn Teammitglieder ihre Arbeit beenden oder Aufgaben erstellt oder abgeschlossen werden:

213 215 

214* [`TeammateIdle`](/docs/de/hooks#teammateidle): wird ausgeführt, wenn ein Teammate im Begriff ist, untätig zu werden. Beenden Sie mit Code 2, um Feedback zu senden und den Teammate weiterarbeiten zu lassen.216* [`TeammateIdle`](/docs/de/hooks#teammateidle): wird ausgeführt, wenn ein Teammitglied kurz davor ist, in den Leerlauf zu wechseln. Beenden Sie mit Code 2, um Feedback zu senden und das Teammitglied weiterarbeiten zu lassen.

215* [`TaskCreated`](/docs/de/hooks#taskcreated): wird ausgeführt, wenn eine Aufgabe erstellt wird. Beenden Sie mit Code 2, um die Erstellung zu verhindern und Feedback zu senden.217* [`TaskCreated`](/docs/de/hooks#taskcreated): wird ausgeführt, wenn eine Aufgabe erstellt wird. Beenden Sie mit Code 2, um die Erstellung zu verhindern und Feedback zu senden.

216* [`TaskCompleted`](/docs/de/hooks#taskcompleted): wird ausgeführt, wenn eine Aufgabe als abgeschlossen markiert wird. Beenden Sie mit Code 2, um die Fertigstellung zu verhindern und Feedback zu senden.218* [`TaskCompleted`](/docs/de/hooks#taskcompleted): wird ausgeführt, wenn eine Aufgabe als abgeschlossen markiert wird. Beenden Sie mit Code 2, um den Abschluss zu verhindern und Feedback zu senden.

217 219 

218## Wie Agent-Teams funktionieren220## Wie Agent-Teams funktionieren

219 221 


286 288 

287Teammates starten mit dem Berechtigungsmodus des Leads, außer dem [`dontAsk`-Modus](/docs/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), den sie nicht erben. Wenn der Lead mit `--dangerously-skip-permissions` ausgeführt wird, tun dies auch alle Teammates. Nach dem Erzeugen können Sie den Berechtigungsmodus eines einzelnen Teammates ändern, aber Sie können keine Pro-Teammate-Berechtigungsmodi zum Zeitpunkt des Erzeugung setzen.289Teammates starten mit dem Berechtigungsmodus des Leads, außer dem [`dontAsk`-Modus](/docs/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), den sie nicht erben. Wenn der Lead mit `--dangerously-skip-permissions` ausgeführt wird, tun dies auch alle Teammates. Nach dem Erzeugen können Sie den Berechtigungsmodus eines einzelnen Teammates ändern, aber Sie können keine Pro-Teammate-Berechtigungsmodi zum Zeitpunkt des Erzeugung setzen.

288 290 

289Teammate-Berechtigungsaufforderungen werden an die Lead-Sitzung weitergeleitet, also genehmigen Sie sie dort selbst. [Plan-Genehmigung](#have-teammates-plan-before-implementing) ist die konzipierte Ausnahme: die Lead-Sitzung gewährt Teammate-Plan-Genehmigungen ohne eine separate Aufforderung an Sie.291Berechtigungsabfragen von Teammates erscheinen in der Lead-Sitzung, also genehmigen Sie sie dort selbst. Den [Plan eines Teammates](#have-teammates-plan-before-implementing) müssen Sie nicht genehmigen.

290 292 

291#### Nachrichten zwischen Agenten293#### Nachrichten zwischen Agenten

292 294 

agent-view.md +93 −35

Details

276 276 

277Nach etwa zehn Sekunden verschiebt Claude Code die Sitzung in den Hintergrund, ohne länger zu warten, außer in Fällen wie diesen:277Nach etwa zehn Sekunden verschiebt Claude Code die Sitzung in den Hintergrund, ohne länger zu warten, außer in Fällen wie diesen:

278 278 

279* **Vordergrund-Subagenten laufen noch**: Claude Code wartet weiter, damit die Arbeit der [Vordergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background), die Claude gestartet hat, übertragen wird, und zeigt `Still backgrounding after the current tool`. Drücken Sie `←` erneut, um ohne Warten in den Hintergrund zu verschieben, was diese Subagenten von vorne neu startet.279* **Subagenten im Vordergrund laufen noch**: Claude Code wartet weiter, damit die Arbeit der [Subagenten im Vordergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background), die Claude gestartet hat, erhalten bleibt, und zeigt `Still backgrounding after the current tool` an. Drücken Sie erneut `←`, um ohne Warten in den Hintergrund zu wechseln. Dadurch werden diese Subagenten von vorn neu gestartet.

280* **Eine Berechtigungsabfrage oder Frage wartet auf Ihre Antwort**: Während eine Berechtigungsabfrage oder eine Frage, die Claude gestellt hat, wartet, wartet Claude Code weiter und zeigt `Still backgrounding after the current tool — a question is waiting for your answer.` Wenn Ihre Antwort den Turn fortsetzen lässt, z. B. **Yes** bei einer Berechtigungsabfrage, verschiebt Claude Code die Sitzung in den Hintergrund, sobald das aktuelle Tool fertig ist.280* **Eine Berechtigungsabfrage oder Frage wartet auf Ihre Antwort**: Während eine Berechtigungsabfrage oder eine Frage, die Claude gestellt hat, wartet, wartet Claude Code weiter und zeigt `Still backgrounding after the current tool — a question is waiting for your answer.` Wenn Ihre Antwort den Turn fortsetzen lässt, z. B. **Yes** bei einer Berechtigungsabfrage, verschiebt Claude Code die Sitzung in den Hintergrund, sobald das aktuelle Tool fertig ist.

281* **Sie tippen in die Prompt-Eingabe**: Claude Code bricht den Wechsel ab, da ungesendeter Text im Eingabefeld Ihres Terminals bleibt und nicht in die Hintergrund-Sitzung verschoben würde. Es zeigt `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`281* **Sie tippen in die Prompt-Eingabe**: Claude Code bricht den Wechsel ab, da ungesendeter Text im Eingabefeld Ihres Terminals bleibt und nicht in die Hintergrund-Sitzung verschoben würde. Es zeigt `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` Claude arbeitet im Vordergrund weiter.

282* **Sie stoppen den Turn**: Claude Code bricht den Wechsel ab und zeigt `Backgrounding cancelled — the turn was stopped.` Der Turn stoppt beispielsweise, wenn Sie [Claude mit `Esc` unterbrechen](/docs/de/interactive-mode#general-controls) oder bei einer Berechtigungsabfrage aus der Hauptkonversation **No** [ohne Kommentar](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt) auswählen, oder wenn Sie bei einer Frage, die Claude dort stellt, `Esc` drücken. Drücken Sie `←` erneut, um die Sitzung in den Hintergrund zu verschieben.282* **Sie stoppen den Turn**: Claude Code bricht den Wechsel ab und zeigt `Backgrounding cancelled — the turn was stopped.` Der Turn stoppt beispielsweise, wenn Sie [Claude mit `Esc` unterbrechen](/docs/de/interactive-mode#general-controls) oder bei einer Berechtigungsabfrage aus der Hauptkonversation **No** [ohne Kommentar](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt) auswählen, oder wenn Sie bei einer Frage, die Claude dort stellt, `Esc` drücken. Drücken Sie `←` erneut, um die Sitzung in den Hintergrund zu verschieben.

283* **Eine Nachricht in der Warteschlange kann nicht verschoben werden**: Nachrichten, die Sie [in die Warteschlange gestellt haben, während Claude gearbeitet hat](/docs/de/interactive-mode#queue-messages-while-claude-works), werden mit der Konversation in die Hintergrund-Sitzung verschoben. Wenn das bei einer davon nicht möglich ist, bleibt die Sitzung im Vordergrund und Claude Code zeigt einen Hinweis wie `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`283* **Eine Nachricht in der Warteschlange kann nicht verschoben werden**: Nachrichten, die Sie [in die Warteschlange gestellt haben, während Claude gearbeitet hat](/docs/de/interactive-mode#queue-messages-while-claude-works), werden mit der Konversation in die Hintergrund-Sitzung verschoben. Wenn das bei einer davon nicht möglich ist, bleibt die Sitzung im Vordergrund und Claude Code zeigt einen Hinweis wie `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`

284 284 


288 288 

289Sie können diese Tastenkombination für Vordergrund-Sitzungen mit der [`leftArrowOpensAgents`](/docs/de/settings-reference#leftarrowopensagents)-Einstellung in `/config` ausschalten.289Sie können diese Tastenkombination für Vordergrund-Sitzungen mit der [`leftArrowOpensAgents`](/docs/de/settings-reference#leftarrowopensagents)-Einstellung in `/config` ausschalten.

290 290 

291##### Prompts, die gesendet werden, während die Sitzung in den Hintergrund wechselt

292 

293Wenn Sie genau in dem Moment, in dem die Sitzung in den Hintergrund wechselt, einen Prompt oder `!`-Shell-Befehl eingeben, wird er gestoppt oder nicht gesendet:

294 

295* **Gesendet, während sich die Konversation schließt**: Die Antwort oder der Befehl stoppt, wenn sich die Konversation schließt und die Agent-Ansicht öffnet

296* **In diesem Moment noch auf [Hooks](/docs/de/hooks) wartend**: Der Prompt wird nicht gesendet, und nichts auf dem Bildschirm weist darauf hin. Dies schließt einen Prompt ein, den Sie eingegeben haben, während [`SessionStart`-Hooks](/docs/de/hooks#sessionstart) noch liefen

297 

298In beiden Fällen bleibt der eingegebene Text im [Prompt-Verlauf](/docs/de/interactive-mode#command-history) erhalten. Um ihn erneut zu senden, öffnen Sie die in den Hintergrund verschobene Sitzung und drücken Sie `↑` in deren Prompt, um den Text zurückzuholen.

299 

291### Liste organisieren300### Liste organisieren

292 301 

293Die Agent-Ansicht gruppiert Sitzungen, sodass die, die Eingaben benötigen, oben sind, mit `Ready for review` und `Needs input` über `Working` und `Completed`. Diese Gruppennamen entsprechen nicht eins-zu-eins den [Status](#read-session-state) oben: Eine Sitzung wechselt zu `Ready for review`, wenn sie einen offenen Pull Request hat, der ein Review benötigt oder fehlschlagende Checks hat, und `Completed` sammelt abgeschlossene, fehlgeschlagene und gestoppte Sitzungen zusammen.302Die Agent-Ansicht gruppiert Sitzungen, sodass die, die Eingaben benötigen, oben sind, mit `Ready for review` und `Needs input` über `Working` und `Completed`. Diese Gruppennamen entsprechen nicht eins-zu-eins den [Status](#read-session-state) oben: Eine Sitzung wechselt zu `Ready for review`, wenn sie einen offenen Pull Request hat, der ein Review benötigt oder fehlschlagende Checks hat, und `Completed` sammelt abgeschlossene, fehlgeschlagene und gestoppte Sitzungen zusammen.


300* Drücken Sie `Shift+↑` oder `Shift+↓`, um Sitzungen neu zu ordnen309* Drücken Sie `Shift+↑` oder `Shift+↓`, um Sitzungen neu zu ordnen

301* Drücken Sie `Ctrl+R`, um eine Sitzung umzubenennen310* Drücken Sie `Ctrl+R`, um eine Sitzung umzubenennen

302* Drücken Sie `Enter` auf einem Gruppen-Header, um ihn einzuklappen, außer während ein [Filter](#filter-sessions) aktiv ist; dann bleiben alle Gruppen ausgeklappt311* Drücken Sie `Enter` auf einem Gruppen-Header, um ihn einzuklappen, außer während ein [Filter](#filter-sessions) aktiv ist; dann bleiben alle Gruppen ausgeklappt

312* Drücken Sie `Ctrl+X`, um eine Sitzung zu stoppen, und `Ctrl+X` erneut innerhalb von zwei Sekunden, um sie aus der Liste zu löschen, oder `Esc`, um die Bestätigung zu schließen, ohne zu löschen. Der zweite Tastendruck löscht die Sitzung auch, wenn der Stoppversuch fehlschlägt, z. B. weil der [Hintergrund-Service nicht reagiert](#agent-view-says-the-background-service-did-not-respond). In diesem Fall bleibt die Bestätigung für weitere zwei Sekunden aktiv, und das Löschen beendet den Prozess der Sitzung selbst

303 313 

304Um eine Sitzung aus der Liste zu entfernen, drücken Sie `Ctrl+X`, um sie zu stoppen, und `Ctrl+X` erneut innerhalb von zwei Sekunden, um sie zu löschen. Wenn Sie `Ctrl+X` auf einem Gruppen-Header drücken, werden alle Sitzungen in dieser Gruppe nach Bestätigung gelöscht.314Wenn Sie `Ctrl+X` auf einem Gruppen-Header drücken, werden alle Sitzungen in dieser Gruppe nach Bestätigung gelöscht. Mit Ausnahme der beibehaltenen Fälle, die in [Was das Löschen einer Sitzung entfernt](#what-deleting-a-session-removes) behandelt werden, entfernt das Löschen die Sitzung aus der Liste. Ein Worktree, den Claude dafür erstellt hat, wird entfernt, beibehalten oder an Ort und Stelle gelassen, je nachdem, wie Sie löschen und was der Worktree enthält. Das Konversations-Transkript bleibt auf Ihrem lokalen Computer, verfügbar über `claude --resume`.

305 315 

306Der zweite Tastendruck löscht die Sitzung auch, wenn der Stoppversuch fehlschlägt, z. B. weil der [Hintergrund-Service nicht reagiert](#agent-view-says-the-background-service-did-not-respond): Die Bestätigung bleibt für weitere zwei Sekunden aktiv, und das Löschen beendet den Prozess der Sitzung selbst. Drücken Sie `Esc`, um die Bestätigung zu schließen, ohne zu löschen.316Abgeschlossene Sitzungen, die nicht auf den Bildschirm passen, werden in eine `… N more`-Zeile zusammengefasst. Die `Completed`-Gruppe füllt den vertikalen Platz, der nach den Live-Gruppen verbleibt. Auf einem kurzen Terminal wird der Header zu einer einzelnen Zusammenfassungszeile komprimiert, sodass Sitzungen, die arbeiten oder Eingaben benötigen, sichtbar bleiben.

307 317 

308Mit Ausnahme der beibehaltenen Fälle, die in [Was das Löschen einer Sitzung entfernt](#what-deleting-a-session-removes) behandelt werden, entfernt das Löschen die Sitzung aus der Liste, und ein Worktree, den Claude dafür erstellt hat, wird entfernt, beibehalten oder an Ort und Stelle gelassen, je nachdem, wie Sie löschen und was der Worktree enthält. Das Konversations-Transkript bleibt auf Ihrem lokalen Computer, verfügbar über `claude --resume`.318#### Eine vergangene Sitzung zurückholen

309 319 

310Um eine Sitzung mit Claude Code v2.1.212 oder später zurückzuholen, geben Sie `/resume` in die Versand-Eingabe ein. Eine Auswahl öffnet sich mit vergangenen Sitzungen des Repositorys, aus dem Sie die Agent-Ansicht geöffnet haben, neueste zuerst, einschließlich Sitzungen, die Sie aus der Liste gelöscht haben; Sitzungen, die bereits eine Zeile haben, werden nicht aufgelistet. `↑`/`↓` verschieben die Auswahl, `Enter` setzt die ausgewählte Sitzung als Hintergrund-Sitzung fort, damit sie als Zeile wieder in die Liste aufgenommen wird, und `Esc` schließt die Auswahl.320Um eine Sitzung mit Claude Code v2.1.212 oder später zurückzuholen, geben Sie `/resume` in die [Versand-Eingabe](#dispatch-an-agent-from-agent-view) ein. Eine Auswahl öffnet sich mit vergangenen Sitzungen des Repositorys, aus dem Sie die Agent-Ansicht geöffnet haben, neueste zuerst, einschließlich Sitzungen, die Sie aus der Liste gelöscht haben. Sitzungen, die bereits eine Zeile haben, werden nicht aufgelistet. Drücken Sie `Enter`, um die ausgewählte Sitzung als Hintergrund-Sitzung fortzusetzen, damit sie als Zeile wieder in die Liste aufgenommen wird.

311 321 

312Die Auswahl öffnet sich nur für ein einfaches `/resume`. Ein gezieltes, bereichsgebundenes oder eingeschränktes Fortsetzen kann nicht über die Auswahl erfolgen, daher zeigt die Agent-Ansicht stattdessen den Hinweis `attach to a session to run it`, wenn:322`/resume` schlägt mit `isn't available in agent view` fehl, wenn:

313 323 

314* `/resume` eine ID oder einen Suchbegriff benennt324* `/resume` eine ID oder einen Suchbegriff benennt

315* die Ansicht mit `--cwd` bereichsgebunden ist325* die Ansicht mit `--cwd` bereichsgebunden ist

316* die Ansicht mit [`--safe-mode`](/docs/de/cli-reference#cli-flags) gestartet wurde326* die Ansicht mit [`--safe-mode`](/docs/de/cli-reference#cli-flags) gestartet wurde

317* die Ansicht mit einem Flag wie `--permission-mode` oder `--settings` geöffnet wurde327* die Ansicht mit einem Flag wie `--permission-mode` oder `--settings` geöffnet wurde

318 328 

319Abgeschlossene Sitzungen, die nicht auf den Bildschirm passen, werden in eine `… N more`-Zeile zusammengefasst. Die `Completed`-Gruppe füllt den vertikalen Platz, der nach den Live-Gruppen verbleibt, und auf einem kurzen Terminal wird der Header zu einer einzelnen Zusammenfassungszeile komprimiert, sodass Sitzungen, die arbeiten oder Eingaben benötigen, sichtbar bleiben.329Wenn Sie nach `/resume` etwas eingegeben haben, geben Sie den Befehl ohne diesen Zusatz erneut ein. Wenn Sie eines dieser Flags verwendet haben, führen Sie `claude agents` in Ihrer Shell ohne das Flag aus und geben Sie dann nur `/resume` ein.

320 330 

321### Sitzungen filtern331### Sitzungen filtern

322 332 


361| `Ctrl+X` | Sitzung stoppen; innerhalb von zwei Sekunden erneut drücken, um sie zu löschen |371| `Ctrl+X` | Sitzung stoppen; innerhalb von zwei Sekunden erneut drücken, um sie zu löschen |

362| `Shift+↑` / `Shift+↓` | Ausgewählte Sitzung neu ordnen |372| `Shift+↑` / `Shift+↓` | Ausgewählte Sitzung neu ordnen |

363| `Esc` | Peek-Panel schließen, Eingabe löschen oder beenden. Wenn Sie die Agent-Ansicht geöffnet haben, indem Sie Ihre Sitzung mit `←` in den Hintergrund verschoben haben, kehrt das letzte `Esc` zu dieser Konversation zurück, anstatt zu beenden. Bei aktiviertem [Vim-Editor-Modus](/docs/de/interactive-mode#vim-editor-mode) wechselt `Esc` in der Eingabe vom INSERT- in den NORMAL-Modus und behält Ihren Text, wie im Haupt-Prompt |373| `Esc` | Peek-Panel schließen, Eingabe löschen oder beenden. Wenn Sie die Agent-Ansicht geöffnet haben, indem Sie Ihre Sitzung mit `←` in den Hintergrund verschoben haben, kehrt das letzte `Esc` zu dieser Konversation zurück, anstatt zu beenden. Bei aktiviertem [Vim-Editor-Modus](/docs/de/interactive-mode#vim-editor-mode) wechselt `Esc` in der Eingabe vom INSERT- in den NORMAL-Modus und behält Ihren Text, wie im Haupt-Prompt |

364| `Ctrl+C` | Eingabe löschen; zweimal drücken, um zu beenden |374| `Ctrl+C` | Eingabe löschen; zweimal drücken, um zu beenden. Wenn Text auf dem Bildschirm ausgewählt ist, hebt der Tastendruck stattdessen die Auswahl auf und kopiert sie zuvor, sofern [das Auswählen sie nicht bereits kopiert hat](/docs/de/settings-reference#copyonselect) |

365| `?` | Tastenkombinationen anzeigen |375| `?` | Tastenkombinationen anzeigen |

366 376 

367Die Tastenkombinationen, die eine Aktion im [`Agents`-Kontext](/docs/de/keybindings#agents-actions) haben, folgen Ihrer [`keybindings.json`](/docs/de/keybindings). Das gilt auch für `Ctrl+G`, über die `Chat`-Kontext-Bindung `chat:externalEditor`.377Die Tastenkombinationen, die eine Aktion im [`Agents`-Kontext](/docs/de/keybindings#agents-actions) haben, folgen Ihrer [`keybindings.json`](/docs/de/keybindings). Das gilt auch für `Ctrl+G`, über die `Chat`-Kontext-Bindung `chat:externalEditor`.


395 405 

396* `/exit` und `/quit` schließen die Agenten-Ansicht406* `/exit` und `/quit` schließen die Agenten-Ansicht

397* `/logout` meldet Sie ab407* `/logout` meldet Sie ab

398* `/model` legt das [Versand-Modell](#set-the-model) fest408* `/model`, `/effort` und `/fast` legen fest, [womit die Sitzungen starten, die Sie als Nächstes versenden](#set-the-model-effort-and-fast-mode). `/effort` und `/fast` erfordern Claude Code v2.1.299 oder später.

399* `/login` öffnet den Anmeldedialog, damit Sie sich erneut anmelden können, ohne sich an eine Sitzung anzuhängen409* `/login` öffnet den Anmeldedialog, damit Sie sich erneut anmelden können, ohne sich an eine Sitzung anzuhängen

400* Ein einfaches `/resume` oder sein Alias `/continue` öffnet eine Auswahl der vergangenen Sitzungen des Repositorys, um [eine davon als Hintergrund-Sitzung zurückzuholen](#organize-the-list). Erfordert Claude Code v2.1.212 oder später410* Ein einfaches `/resume` oder sein Alias `/continue` öffnet eine Auswahl der vergangenen Sitzungen des Repositorys, um [eine davon als Hintergrund-Sitzung zurückzuholen](#bring-back-a-past-session). Erfordert Claude Code v2.1.212 oder später

401 411 

402Skills, Ihre eigenen Befehle und Prompt-erweiternde integrierte Befehle wie `/init` werden als erster Prompt an eine neue Hintergrund-Sitzung gesendet. Andere integrierte Befehle zeigen stattdessen einen Hinweis `attach to a session to run it` an. Alles, was Sie eingegeben haben, bleibt neben dem Hinweis im Eingabefeld, damit Sie es bearbeiten können.412Skills, Ihre eigenen Befehle und Prompt-erweiternde integrierte Befehle wie `/init` werden als erster Prompt an eine neue Hintergrund-Sitzung gesendet. Der Hinweis `isn't available in agent view` bedeutet, dass der eingegebene integrierte Befehl nicht ausgeführt wurde. Um ihn auszuführen, [hängen Sie sich an eine Sitzung an](#attach-to-a-session) und geben Sie ihn dort ein. Alles, was Sie eingegeben haben, bleibt neben dem Hinweis im Eingabefeld, damit Sie es bearbeiten können.

403 413 

404Wenn Sie eine wiederkehrende Aufgabe als [Skill](/docs/de/skills) verpacken, können Sie denselben Workflow wiederholt aus der Agenten-Ansicht starten, ohne den Prompt erneut einzugeben.414Wenn Sie eine wiederkehrende Aufgabe als [Skill](/docs/de/skills) verpacken, können Sie denselben Workflow wiederholt aus der Agenten-Ansicht starten, ohne den Prompt erneut einzugeben.

405 415 


458 468 

459#### Was beim Verschieben in den Hintergrund übernommen wird469#### Was beim Verschieben in den Hintergrund übernommen wird

460 470 

461Das Verschieben in den Hintergrund startet einen neuen Prozess, der die gespeicherte Konversation fortsetzt, und laufende Hintergrundarbeit wird dorthin übertragen: laufende Hintergrund-Shell-Befehle, in den Hintergrund verschobene Subagenten, dynamische Workflows, geplante Aufgaben, die Sie mit [`/loop`](/docs/de/scheduled-tasks) erstellt haben, und Claudes [automatische Antworten auf Artefakt-Kommentare](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own) werden alle übernommen und laufen dort weiter. Ein Subagent wird zusammen mit allem übertragen, was er gestartet hat, daher wird er nur übernommen, wenn all diese Arbeit ebenfalls übertragen werden kann. Um laufende Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, setzen Sie die Umgebungsvariable [`CLAUDE_DISABLE_ADOPT=1`](/docs/de/env-vars#variables); Claude Code bittet Sie dann vor dem Verschieben in den Hintergrund um Bestätigung.471Das Verschieben in den Hintergrund startet einen neuen Prozess, der die gespeicherte Konversation fortsetzt, und laufende Hintergrundarbeit wird dorthin übertragen. Laufende Hintergrund-Shell-Befehle, in den Hintergrund verschobene Subagenten, dynamische Workflows, geplante Aufgaben, die Sie mit [`/loop`](/docs/de/scheduled-tasks) erstellt haben, und Claudes [automatische Antworten auf Artefakt-Kommentare](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own) werden alle übernommen und laufen dort weiter. Ein Subagent wird zusammen mit allem übertragen, was er gestartet hat, daher wird er nur übernommen, wenn all diese Arbeit ebenfalls übertragen werden kann.

462 472 

463Wenn in einem [dynamischen Workflow](/docs/de/workflows) noch Subagenten laufen, fragt Claude Code vor dem Verschieben in den Hintergrund mit dem Dialog `Background this session?` nach, der angibt, wie viele Subagenten neu starten würden. Wählen Sie `Stay`, um sie zuerst fertig laufen zu lassen. Wenn Sie bestätigen, spielt Claude Code den Lauf in der Hintergrund-Sitzung erneut ab: Subagenten, die noch liefen, beginnen von vorn, sodass die bisher verbrauchten Token erneut anfallen. Siehe [Nach einer Pause fortsetzen](/docs/de/workflows#resume-after-a-pause), um zu erfahren, welche abgeschlossenen Subagenten ihre gespeicherten Ergebnisse zurückgeben und welche erneut ausgeführt werden.473Wenn in einem [dynamischen Workflow](/docs/de/workflows) noch Subagenten laufen, fragt Claude Code vor dem Verschieben in den Hintergrund mit dem Dialog `Background this session?` nach, der angibt, wie viele Subagenten neu starten würden. Wählen Sie `Stay`, um sie zuerst fertig laufen zu lassen. Wenn Sie bestätigen, spielt Claude Code den Lauf in der Hintergrund-Sitzung erneut ab: Subagenten, die noch liefen, beginnen von vorn, sodass die bisher verbrauchten Token erneut anfallen. Siehe [Nach einer Pause fortsetzen](/docs/de/workflows#resume-after-a-pause), um zu erfahren, welche abgeschlossenen Subagenten ihre gespeicherten Ergebnisse zurückgeben und welche erneut ausgeführt werden.

464 474 


526 claude stop 7c5dcf5d stop this session536 claude stop 7c5dcf5d stop this session

527```537```

528 538 

539#### Prompts, die `--bg` enthalten

540 

541Ein Prompt, der `--bg` oder `--background` erwähnt, wird so zugestellt, wie Sie ihn eingegeben haben, und ebenso eine Antwort `--bg`, die Sie an eine Hintergrund-Sitzung senden. Beispielsweise startet dieser Befehl eine Hintergrund-Sitzung, und das zweite `--bg` ist Teil ihres Prompts:

542 

543```bash theme={null}

544claude --bg "find out why --bg sessions are slow to start on this machine"

545```

546 

547Claude Code liest ein ganzes Argument nur dort als Flag, wo ein Flag stehen kann: vor einem einfachen `--`-Trennzeichen und nicht an einer Stelle, an der ein anderes Flag seinen Wert erwartet. Setzen Sie das Flag an den Anfang, wie in `claude --bg "<prompt>"`.

548 

549Wo die Position mehrdeutig ist, etwa nach einer Folge kombinierter Kurz-Flags, startet Claude Code nichts. Es wird stattdessen mit [`Couldn't tell whether --bg is a flag or text here`](/docs/de/errors#couldnt-tell-whether-bg-is-a-flag-or-text) beendet.

550 

529#### Einen Shell-Befehl ausführen551#### Einen Shell-Befehl ausführen

530 552 

531Um einen Shell-Befehl als Hintergrund-Job statt als Claude-Sitzung auszuführen, übergeben Sie `--exec`. Das folgende Beispiel führt `pytest -x` als Hintergrund-Job aus:553Um einen Shell-Befehl als Hintergrund-Job statt als Claude-Sitzung auszuführen, übergeben Sie `--exec`. Das folgende Beispiel führt `pytest -x` als Hintergrund-Job aus:


626 648 

627Beide Wege behalten ein Verzeichnis, das in den Datensätzen einer anderen abgeschlossenen Sitzung genannt wird.649Beide Wege behalten ein Verzeichnis, das in den Datensätzen einer anderen abgeschlossenen Sitzung genannt wird.

628 650 

629### Das Modell festlegen651### Modell, Effort-Stufe und Fast-Modus festlegen

630 652 

631Der im Header der Agenten-Ansicht angezeigte Modellname ist der Versand-Standard. Neue Sitzungen, die Sie über das Eingabefeld starten, verwenden dieses Modell, das aus der [`model`-Einstellung](/docs/de/settings-reference#model) in Ihren Benutzereinstellungen stammt. Legen Sie es fest, indem Sie ein Modell in der [`/model`-Auswahl](/docs/de/model-config) auswählen, oder bearbeiten Sie die Einstellung direkt.653Geben Sie in der Agenten-Ansicht `/model`, `/effort` oder `/fast` in das [Versand-Eingabefeld](#dispatch-an-agent-from-agent-view) ein und drücken Sie `Enter`; die Sitzungen, die Sie danach versenden, starten mit dem, was Sie festgelegt haben. Ihre Auswahl gilt für dieses Fenster der Agenten-Ansicht und wird nicht in einer Einstellungsdatei gespeichert. `/effort` und `/fast` erfordern Claude Code v2.1.299 oder später, ebenso `/model` ohne nachfolgende Eingabe.

632 654 

633Um den Versand-Standard für die gesamte Sitzung der Agenten-Ansicht zu überschreiben, übergeben Sie `--model` beim Öffnen der Agenten-Ansicht. Siehe [Berechtigungsmodus, Modell und Aufwand](#permission-mode-model-and-effort).655Geben Sie den Wert nach dem Befehl an, oder geben Sie nur den Befehl ein, um einen Wert aus einer Liste auszuwählen:

634 656 

635Um den Versand-Standard innerhalb der Agenten-Ansicht zu ändern, geben Sie `/model` gefolgt von einem Modellnamen in das Versand-Eingabefeld ein und drücken Sie `Enter`. Der Header zeigt dann dieses Modell mit einer `(session)`-Markierung an, und Sitzungen, die Sie danach versenden, verwenden es. Geben Sie `/model default` ein, um die Überschreibung zu entfernen und zum Versand-Standard zurückzukehren. Diese Überschreibung gilt für den Rest des aktuellen `claude agents`-Laufs und wird nicht in Ihre Einstellungsdatei geschrieben. Das folgende Beispiel versendet eine Sitzung mit Opus und die nächste mit Sonnet:657* **Modell**: `/model <name>`, zum Beispiel `/model opus`

658* **[Effort-Stufe](/docs/de/model-config#adjust-effort-level)**: `/effort` mit `low`, `medium`, `high`, `xhigh` oder `max`, zum Beispiel `/effort high`. Um Sitzungen in [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) zu starten, öffnen Sie die Agenten-Ansicht stattdessen aus Ihrer Shell mit [`claude agents --effort ultracode`](#dispatch-defaults); das Versand-Eingabefeld akzeptiert `/effort ultracode` nicht

659* **Fast-Modus**: `/fast on` oder `/fast off`. Die Sitzung startet nur dann im Fast-Modus, wenn der Fast-Modus [für Sie verfügbar](/docs/de/fast-mode#requirements) ist und ihr Modell den Fast-Modus unterstützt. Bei einem Modell, das ihn nicht unterstützt, startet die Sitzung mit ausgeschaltetem Fast-Modus; wählen Sie daher zuerst mit `/model` eines der [Modelle, die den Fast-Modus unterstützen](/docs/de/fast-mode). Der Hinweis unter dem Eingabefeld, nicht die Kopfzeile, bestätigt, ob neue Sitzungen den Fast-Modus erhalten.

660 

661Um eine Auswahl rückgängig zu machen, geben Sie `default` als Wert an, zum Beispiel `/effort default`.

662 

663Das folgende Beispiel versendet eine Sitzung mit Opus und die nächste mit Sonnet:

636 664 

637```text theme={null}665```text theme={null}

638/model opus666/model opus


644Jede Hintergrund-Sitzung kann ein anderes Modell verwenden. Um es für eine einzelne Sitzung zu überschreiben:672Jede Hintergrund-Sitzung kann ein anderes Modell verwenden. Um es für eine einzelne Sitzung zu überschreiben:

645 673 

646* Übergeben Sie in der Shell `--model` zusammen mit `claude --bg`.674* Übergeben Sie in der Shell `--model` zusammen mit `claude --bg`.

647* Hängen Sie sich an eine laufende Sitzung an und führen Sie `/model` aus, um zu wechseln: Eine Auswahl in der Auswahlliste oder ein eingegebenes `/model <name>` wird als Standard für neue Sitzungen gespeichert, es sei denn, Sie drücken `s` in der Auswahl, um nur für diese Sitzung zu wechseln. Ein Wechsel nur für diese Sitzung bleibt erhalten, wenn die Sitzung neu gestartet wird.675* Hängen Sie sich an eine laufende Sitzung an und führen Sie `/model` aus, um zu wechseln. Eine Auswahl in der Auswahlliste oder ein eingegebenes `/model <name>` wird als Standard für neue Sitzungen gespeichert, es sei denn, Sie drücken `s` in der Auswahl, um nur für diese Sitzung zu wechseln. Ein Wechsel nur für diese Sitzung bleibt erhalten, wenn die Sitzung neu gestartet wird.

648* Versenden Sie einen [Subagenten](/docs/de/sub-agents), dessen Frontmatter ein `model`-Feld setzt.676* Versenden Sie einen [Subagenten](/docs/de/sub-agents), der in seinem Frontmatter `model` setzt, indem Sie den Prompt mit seinem Namen beginnen oder `@name` erwähnen. Solange eine `/model`-Auswahl im Versand-Eingabefeld gilt, wird das `model` des Subagenten nicht verwendet; geben Sie daher dort `/model default` ein. Wenn Sie mit [`claude agents --model`](#dispatch-defaults) gestartet haben, wird das Modell des Subagenten ebenfalls nicht verwendet; führen Sie daher `claude agents` in Ihrer Shell ohne `--model` aus.

649 677 

650### Berechtigungsmodus, Modell und Aufwand678### Berechtigungsmodus, Modell und Aufwand

651 679 


666* Sie verschieben Ihre eigene Sitzung mit `←` oder `/background` in den Hintergrund694* Sie verschieben Ihre eigene Sitzung mit `←` oder `/background` in den Hintergrund

667* Sie versenden eine Sitzung in das Verzeichnis, in dem Sie sich befinden695* Sie versenden eine Sitzung in das Verzeichnis, in dem Sie sich befinden

668* Sie wecken eine gestoppte Sitzung in dem Verzeichnis, in dem Sie sich befinden, auf, indem Sie sich an sie anhängen oder ihr antworten696* Sie wecken eine gestoppte Sitzung in dem Verzeichnis, in dem Sie sich befinden, auf, indem Sie sich an sie anhängen oder ihr antworten

697* Sie starten eine Sitzung in dem Verzeichnis, in dem Sie sich befinden, mit [`claude respawn`](#manage-sessions-from-the-shell) neu

669 698 

670Claude Code leitet ein Gateway vor einem Cloud-Provider weiter. Wenn die Shell, aus der Sie versenden, den Provider auswählt und dessen Gateway-Endpunkt zusammen mit seinem Auth-Bypass-Flag exportiert, leitet Claude Code das Paar aus Endpunkt und Flag unter denselben Bedingungen wie bei `ANTHROPIC_BASE_URL` zusammen mit `ANTHROPIC_CUSTOM_HEADERS` an die Sitzung weiter. Exportieren Sie beispielsweise `CLAUDE_CODE_USE_VERTEX=1` mit `ANTHROPIC_VERTEX_BASE_URL` und `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, und Claude Code leitet diesen Endpunkt und dieses Flag weiter.699Claude Code leitet ein Gateway vor einem Cloud-Provider weiter. Wenn die Shell, aus der Sie versenden, den Provider auswählt und dessen Gateway-Endpunkt zusammen mit seinem Auth-Bypass-Flag exportiert, leitet Claude Code das Paar aus Endpunkt und Flag unter denselben Bedingungen wie bei `ANTHROPIC_BASE_URL` zusammen mit `ANTHROPIC_CUSTOM_HEADERS` an die Sitzung weiter. Exportieren Sie beispielsweise `CLAUDE_CODE_USE_VERTEX=1` mit `ANTHROPIC_VERTEX_BASE_URL` und `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, und Claude Code leitet diesen Endpunkt und dieses Flag weiter.

671 700 


673 702 

674#### Berechtigungsmodus703#### Berechtigungsmodus

675 704 

676Der [Berechtigungsmodus](/docs/de/permissions) hängt davon ab, wie Sie die Sitzung gestartet haben:705* **Mit `/bg` oder `←` in den Hintergrund verschoben**: Claude Code behält den [Berechtigungsmodus](/docs/de/permissions) bei, in dem sich die Sitzung befand, sodass eine Sitzung, die Sie auf `acceptEdits` oder `auto` umgestellt haben, nach dem Trennen dabei bleibt

677 

678* **Mit `/bg` oder `←` in den Hintergrund verschoben**: Claude Code behält den Berechtigungsmodus bei, in dem sich die Sitzung befand, sodass eine Sitzung, die Sie auf `acceptEdits` oder `auto` umgestellt haben, nach dem Trennen dabei bleibt

679* **Aus einer mit `←` geöffneten Agenten-Ansicht versendet**: Claude Code übernimmt den Berechtigungsmodus der neuen Sitzung zuerst aus der Konfiguration des Zielverzeichnisses, dann aus der Sitzung, aus der Sie kamen

680* **Aus einem in einer Shell gestarteten `claude agents` oder mit `claude --bg` versendet**: Die neue Sitzung startet so, wie eine neue `claude`-Sitzung in diesem Verzeichnis starten würde, es sei denn, Sie haben sie aus einer Agenten-Ansicht versendet, die Sie mit [Versand-Standardwerten](#dispatch-defaults) geöffnet haben. [In welchem Berechtigungsmodus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) führt die Reihenfolge auf706* **Aus einem in einer Shell gestarteten `claude agents` oder mit `claude --bg` versendet**: Die neue Sitzung startet so, wie eine neue `claude`-Sitzung in diesem Verzeichnis starten würde, es sei denn, Sie haben sie aus einer Agenten-Ansicht versendet, die Sie mit [Versand-Standardwerten](#dispatch-defaults) geöffnet haben. [In welchem Berechtigungsmodus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) führt die Reihenfolge auf

681 707 

682Für eine Sitzung, die Sie aus einer mit `←` geöffneten Agenten-Ansicht versenden, übernimmt Claude Code den Berechtigungsmodus aus dem ersten zutreffenden der folgenden Punkte:708Für eine Sitzung, die Sie aus einer mit `←` geöffneten Agenten-Ansicht versenden, übernimmt Claude Code den Berechtigungsmodus aus dem ersten zutreffenden der folgenden Punkte:

683 709 

6841. Der [`permissions.defaultMode`](/docs/de/settings-reference#permissions-defaultmode) des Zielverzeichnisses. Dabei gelten zwei Quellregeln:7101. Der [`permissions.defaultMode`](/docs/de/settings-reference#permissions-defaultmode) des Zielverzeichnisses. `auto` und `bypassPermissions` [werden nur aus verwalteten Einstellungen, einer `--settings`-Datei oder `~/.claude/settings.json` wirksam](/docs/de/settings-reference#permissions-defaultmode). Claude Code lehnt einen `defaultMode` aus der `.claude/settings.json` oder `.claude/settings.local.json` des Projekts ab, der einen freizügigeren Modus auswählt als den, in dem sich die Sitzung befand, aus der Sie kamen.

685 * `auto` und `bypassPermissions` [werden nur aus verwalteten Einstellungen, einer `--settings`-Datei oder `~/.claude/settings.json` wirksam](/docs/de/settings-reference#permissions-defaultmode).7112. Der Berechtigungsmodus der Sitzung, aus der Sie kamen.

686 * Claude Code lehnt einen `defaultMode` aus der `.claude/settings.json` oder `.claude/settings.local.json` des Projekts ab, der einen freizügigeren Modus auswählt als den, in dem sich die Sitzung befand, aus der Sie kamen.712 

6872. Der Berechtigungsmodus der Sitzung, aus der Sie kamen. Wenn sich diese Sitzung im Modus `bypassPermissions` befand, kann die neue Sitzung stattdessen im Manual-Modus starten, mit dem Hinweis `Bypass permissions was requested at launch and ignored`. Das passiert, wenn Ihre Akzeptanz des Bypass-Haftungsausschlusses nur in `.claude/settings.local.json` oder einer `--settings`-Datei hinterlegt ist. Fahren Sie im Manual-Modus fort, oder [fügen Sie diese Akzeptanz zu `~/.claude/settings.json` hinzu](/docs/de/permission-modes#bypass-permissions-acceptance).713 Wenn sich diese Sitzung im Modus `bypassPermissions` befand, kann die neue Sitzung stattdessen im Manual-Modus starten, mit dem Hinweis `Bypass permissions was requested at launch and ignored`. Das passiert, wenn Ihre Akzeptanz des Bypass-Haftungsausschlusses nur in `.claude/settings.local.json` oder einer `--settings`-Datei hinterlegt ist. Fahren Sie im Manual-Modus fort, oder [fügen Sie diese Akzeptanz zu `~/.claude/settings.json` hinzu](/docs/de/permission-modes#bypass-permissions-ignored-in-a-background-session).

688 714 

689Wenn Claude Code den Modus einer Quelle als zu freizügig ablehnt, entscheidet die nächste Quelle in der Liste. Wenn Sie beispielsweise aus einer Sitzung im Plan-Modus in ein Verzeichnis versenden, dessen eingecheckte Einstellungen `acceptEdits` verlangen, startet die neue Sitzung im Plan-Modus. Wenn Sie diesen `defaultMode` in `~/.claude/settings.json` verschieben, gilt er unabhängig vom Berechtigungsmodus der Sitzung, aus der Sie kamen.715Wenn Claude Code den Modus einer Quelle als zu freizügig ablehnt, entscheidet die nächste Quelle in der Liste. Wenn Sie beispielsweise aus einer Sitzung im Plan-Modus in ein Verzeichnis versenden, dessen eingecheckte Einstellungen `acceptEdits` verlangen, startet die neue Sitzung im Plan-Modus. Wenn Sie diesen `defaultMode` in `~/.claude/settings.json` verschieben, gilt er unabhängig vom Berechtigungsmodus der Sitzung, aus der Sie kamen.

690 716 


816* **Fertig oder wartet auf Ihre nächste Nachricht und unverbunden für etwa eine Stunde**: Der Supervisor stoppt den Prozess, um Ressourcen freizugeben. Eine Sitzung, die ihren Turn beendet hat, indem sie Ihnen eine Frage gestellt hat, zählt als Warten auf Ihre nächste Nachricht. Die Konversation bleibt auf der Festplatte, und das nächste Mal, wenn Sie anhängen oder antworten, wird die Sitzung dort fortgesetzt, wo sie aufgehört hat. Heften Sie eine Sitzung mit `Ctrl+T` an, um ihren Prozess am Laufen zu halten.842* **Fertig oder wartet auf Ihre nächste Nachricht und unverbunden für etwa eine Stunde**: Der Supervisor stoppt den Prozess, um Ressourcen freizugeben. Eine Sitzung, die ihren Turn beendet hat, indem sie Ihnen eine Frage gestellt hat, zählt als Warten auf Ihre nächste Nachricht. Die Konversation bleibt auf der Festplatte, und das nächste Mal, wenn Sie anhängen oder antworten, wird die Sitzung dort fortgesetzt, wo sie aufgehört hat. Heften Sie eine Sitzung mit `Ctrl+T` an, um ihren Prozess am Laufen zu halten.

817* **Unerwartet beendet, während der Supervisor läuft**: Der Supervisor startet den Prozess neu. Das Beenden einer Sitzung, die Sie selbst mit `←` oder `/background` in den Hintergrund verschoben haben, beispielsweise mit `kill`, markiert sie als gestoppt statt neu gestartet. Für Sitzungen, die mit einem Herunterfahren beendet wurden, siehe [Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt](#sessions-show-as-failed-after-shutdown).843* **Unerwartet beendet, während der Supervisor läuft**: Der Supervisor startet den Prozess neu. Das Beenden einer Sitzung, die Sie selbst mit `←` oder `/background` in den Hintergrund verschoben haben, beispielsweise mit `kill`, markiert sie als gestoppt statt neu gestartet. Für Sitzungen, die mit einem Herunterfahren beendet wurden, siehe [Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt](#sessions-show-as-failed-after-shutdown).

818* **Nach einem automatischen Update**: Der Supervisor startet sich selbst in der neuen Version neu und verschiebt untätige Sitzungen im Hintergrund. Sitzungen, die arbeiten, auf Sie warten oder angehängt sind, werden nicht unterbrochen.844* **Nach einem automatischen Update**: Der Supervisor startet sich selbst in der neuen Version neu und verschiebt untätige Sitzungen im Hintergrund. Sitzungen, die arbeiten, auf Sie warten oder angehängt sind, werden nicht unterbrochen.

819* **Der Supervisor selbst stoppt**, beispielsweise weil sein Prozess von außerhalb von Claude Code beendet wurde: Unter macOS und Linux wartet der Prozess jeder Sitzung etwa eine Minute darauf, dass sich ein neuer Supervisor wieder mit ihm verbindet, und stoppt, wenn dies nicht geschieht. Führen Sie innerhalb dieser Minute `claude agents` in Ihrer Shell aus, um einen neuen Supervisor zu starten und Ihre Sitzungen am Laufen zu halten. Wenn die Minute zuerst verstreicht, stoppen die Sitzungen, aber ihre gespeicherten Konversationen bleiben auf der Festplatte: Hängen Sie sich an eine Sitzung an oder antworten Sie ihr, und sie startet aus ihrer gespeicherten Konversation neu, wie unter [Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt](#sessions-show-as-failed-after-shutdown) beschrieben.845* **Der Supervisor selbst stoppt**, beispielsweise weil sein Prozess von außerhalb von Claude Code beendet wurde: Unter macOS und Linux stoppen Ihre Sitzungen, sofern sich nicht innerhalb von etwa einer Minute ein neuer Supervisor verbindet. Um einen zu starten, führen Sie `claude agents` in Ihrer Shell aus. Wenn diese Minute verstrichen ist, siehe [Sitzungen nach dem Stoppen des Supervisors am Laufen halten](#keep-sessions-running-after-the-supervisor-stops).

820 846 

821Wenn ein Sitzungsprozess stoppt oder neu gestartet wird, werden die Hintergrund-Shell-Befehle, dynamischen Workflows und Hintergrund-Subagenten, die Claude darin gestartet hat, in seinen nächsten Prozess übernommen; laufende Monitore und Shell-Befehle, die ein Subagent gestartet hat, stoppen mit dem Prozess. Das Löschen der Sitzung stoppt alles, das sie übernommen hat. Um stattdessen all dies mit dem Prozess zu stoppen, setzen Sie [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/de/env-vars#variables) auf `1`.847Wenn ein Sitzungsprozess stoppt oder neu gestartet wird, werden die Hintergrund-Shell-Befehle, dynamischen Workflows und Hintergrund-Subagenten, die Claude darin gestartet hat, in seinen nächsten Prozess übernommen; laufende Monitore und Shell-Befehle, die ein Subagent gestartet hat, stoppen mit dem Prozess. Das Löschen der Sitzung stoppt alles, das sie übernommen hat. Um stattdessen all dies mit dem Prozess zu stoppen, setzen Sie [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/de/env-vars#variables) auf `1`.

822 848 

823Der Supervisor und seine Sitzungen authentifizieren sich mit denselben gespeicherten Anmeldedaten wie Ihre interaktiven Sitzungen. Welche Einstellungen und Shell-Variablen eine Sitzung erreichen, einschließlich `PATH`, finden Sie unter [Einstellungen und Anbieter](#settings-and-provider). Für Gateway-Endpunkte siehe [LLM-Gateway](#llm-gateway).849Der Supervisor und seine Sitzungen authentifizieren sich mit denselben gespeicherten Anmeldedaten wie Ihre interaktiven Sitzungen. Welche Einstellungen und Shell-Variablen eine Sitzung erreichen, einschließlich `PATH`, finden Sie unter [Einstellungen und Anbieter](#settings-and-provider). Für Gateway-Endpunkte siehe [LLM-Gateway](#llm-gateway).

824 850 

851#### Sitzungen nach dem Stoppen des Supervisors am Laufen halten

852 

853Wenn die Agenten-Ansicht beim Beenden diesen Hinweis ausgibt, läuft kein [Supervisor](#the-supervisor-process):

854 

855```text theme={null}

856Background sessions still running will stop in about a minute. Run 'claude agents' to keep them.

857```

858 

859Führen Sie innerhalb dieser Minute `claude agents` in Ihrer Shell aus, um einen neuen Supervisor zu starten und Ihre Sitzungen am Laufen zu halten.

860 

861Wenn die Minute zuerst verstreicht, stoppen die Sitzungen, aber ihre gespeicherten Konversationen bleiben auf der Festplatte. Um eine Sitzung aus ihrer gespeicherten Konversation neu zu starten, [hängen Sie sich an sie an](#attach-to-a-session) oder [antworten Sie ihr](#peek-and-reply), wie unter [Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt](#sessions-show-as-failed-after-shutdown) beschrieben.

862 

825### Wo der Status gespeichert ist863### Wo der Status gespeichert ist

826 864 

827Der Sitzungsstatus wird unter Ihrem Claude Code-Konfigurationsverzeichnis gespeichert. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, verwendet der Supervisor stattdessen dieses Verzeichnis anstelle von `~/.claude` und läuft als separate Instanz mit ihren eigenen Sitzungen.865Der Sitzungsstatus wird unter Ihrem Claude Code-Konfigurationsverzeichnis gespeichert. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, verwendet der Supervisor stattdessen dieses Verzeichnis anstelle von `~/.claude` und läuft als separate Instanz mit ihren eigenen Sitzungen.


930claude daemon stop --any --keep-workers968claude daemon stop --any --keep-workers

931```969```

932 970 

933Führen Sie dann `claude agents` in Ihrer Shell aus, um den neuen Supervisor zu starten. Wenn Sie dies innerhalb von [etwa einer Minute](#the-supervisor-process) nach dem Stoppen tun, verbindet er sich wieder mit den noch laufenden Sitzungen, und deren Arbeit wird ohne Unterbrechung fortgesetzt. Wenn Sie länger brauchen, haben sich die Sitzungen unter macOS und Linux bis dahin von selbst beendet, und das Anhängen an eine Sitzung oder eine Antwort darauf startet sie aus ihrer gespeicherten Konversation neu. Ohne `--keep-workers` beendet der Befehl auch die Hintergrund-Sitzungen. Das Flag `--any` bewirkt, dass der Befehl einen Supervisor stoppt, den Claude Code bei Bedarf gestartet hat.971Führen Sie dann `claude agents` in Ihrer Shell aus, um einen neuen Supervisor zu starten. Tun Sie dies unter macOS und Linux innerhalb von etwa einer Minute nach dem Beenden des alten, andernfalls [stoppen die Sitzungen ohne Supervisor](#the-supervisor-process). Wenn Sie `stopped` gesehen haben, aber derselbe Fehler erneut auftritt, und Sie unter macOS oder Linux eine Claude Code-Version älter als v2.1.300 verwenden, führen Sie `claude update` aus und anschließend beide Befehle erneut.

934 

935Ein Supervisor, der startet, aber keine Verbindungen akzeptieren kann, beendet sich selbst und gibt seine Sperre frei, sodass der nächste `claude agents` ohne diesen manuellen Stop einen neuen startet. Die obigen Schritte gelten, wenn ein laufender Supervisor steckenbleibt.

936 972 

937Wenn der Befehl stattdessen beendet wird und sagt, dass der aufgezeichnete Prozess nicht als Supervisor verifiziert werden konnte, überprüfen Sie die gemeldete Prozess-ID: Wenn es ein Supervisor ist, den Sie besitzen, stoppen Sie ihn selbst, dann löschen Sie `~/.claude/daemon.lock`, damit der nächste `claude agents` frisch startet.973Wenn der Stopp-Befehl stattdessen eine dieser vier Meldungen ausgegeben hat, wurde der alte Prozess nicht gestoppt. Tun Sie in Ihrer Shell, was die passende Zeile angibt, und führen Sie dann `claude agents` aus:

938 974 

939Unter Windows gibt der Befehl die Prozess-ID des Supervisors aus, wenn dieser nicht auf die Stoppanfrage antwortet. Beenden Sie diesen Prozess mit `taskkill /PID <pid>`, um die Wiederherstellung abzuschließen. Hintergrund-Sitzungen werden immer noch beibehalten, wenn Sie `--keep-workers` übergeben haben.975| Meldung enthält | Plattform | Aktion |

976| :- | :- | :- |

977| `could not be verified as the daemon, so it was not signalled` | Alle | Ermitteln Sie, welches Programm diese Prozess-ID hat. Wenn es Ihr eigener Supervisor ist, stoppen Sie ihn; lassen Sie jedes andere Programm unangetastet. Löschen Sie dann `~/.claude/daemon.lock`. |

978| `is still running after SIGKILL` | macOS, Linux | Warten Sie, bis der Prozess beendet wird. Falls das nie geschieht, starten Sie Ihren Computer neu. |

979| `was not sent SIGKILL` | macOS, Linux | Führen Sie den Stopp-Befehl erneut aus. Wenn der Prozess weiterhin besteht, prüfen Sie ihn mit `ps -ww -o args= -p <pid>`: Ein mit `daemon` gestartetes Claude Code ist ein Supervisor, führen Sie also `kill -9 <pid>` aus. Lassen Sie alles andere unangetastet; wenn `claude agents` dann keinen Supervisor starten kann, löschen Sie `~/.claude/daemon.lock`. |

980| `supervisor (pid=<pid>) is still running` | Windows | Beenden Sie den Prozess mit `taskkill /PID <pid>` |

940 981 

941### Versand schlägt mit `Could not resolve authentication method` fehl982### Versand schlägt mit `Could not resolve authentication method` fehl

942 983 


950 991 

951Siehe die [Fehlerreferenz](/docs/de/errors#could-not-resolve-authentication-method) für die vollständige Liste der Ursachen und Behebungen.992Siehe die [Fehlerreferenz](/docs/de/errors#could-not-resolve-authentication-method) für die vollständige Liste der Ursachen und Behebungen.

952 993 

994### Eine Hintergrund-Sitzung zeigt `No LLM gateway`

995 

996Wenn eine Hintergrund-Sitzung [`No LLM gateway`](/docs/de/errors#no-llm-gateway-opened-from-another-folder) anzeigt, hat sie Ihre Gateway-`ANTHROPIC_BASE_URL` nicht erhalten, sodass ihre Anfragen fehlschlagen. Claude Code hat sie zurückgehalten, weil Sie die Sitzung aus einem anderen Verzeichnis als dem in der Meldung genannten Ordner versendet, aufgeweckt oder neu gestartet haben.

997 

998Sie sehen die Meldung beispielsweise, nachdem Sie mit [`@<repo>`](#dispatch-to-a-specific-directory) in ein Repository versendet oder eine gestoppte Sitzung durch Ausführen von `claude attach` aus einem anderen Verzeichnis aufgeweckt haben. Um der Sitzung Ihr Gateway zu geben, wählen Sie die Lösung, die dazu passt, wo Ihr Gateway festgelegt ist:

999 

1000* **Sie haben das Gateway in Ihrem Terminal exportiert**: Wechseln Sie in einem Terminal, in dem Sie die Gateway-Variablen exportiert haben, mit `cd` in den in der Meldung genannten Ordner und führen Sie den [`claude respawn <id>`](#manage-sessions-from-the-shell)-Befehl aus der Meldung aus.

1001 * Das Gateway erreicht die Sitzung nur, wenn der [Supervisor](#the-supervisor-process) selbst aus einer Shell gestartet wurde, die dasselbe Gateway exportiert hat. Falls nicht, starten Sie ihn aus dem Terminal neu, in dem Sie den respawn-Befehl ausgeführt haben, wie unter [Versand schlägt mit `Could not resolve authentication method` fehl](#dispatch-fails-with-could-not-resolve-authentication-method) beschrieben, und führen Sie diesen Befehl dann erneut aus.

1002* **Sie haben die Agenten-Ansicht in einem Projekt verwendet, dessen Einstellungen das Gateway festlegen**: Legen Sie `ANTHROPIC_BASE_URL` und die zugehörigen Anmeldedaten im [`env`-Block einer Einstellungsdatei](/docs/de/llm-gateway-connect#set-in-a-settings-file) fest. Verwenden Sie `~/.claude/settings.json` oder `.claude/settings.local.json` im eigenen Projekt der Sitzung; beide werden von einer neu gestarteten Sitzung gelesen. Führen Sie dann [`claude respawn <id>`](#manage-sessions-from-the-shell) in Ihrer Shell aus einem beliebigen Verzeichnis aus, um diese Sitzung mit dem Gateway neu zu starten.

1003 

953### Hintergrund-Sitzungen können Desktop, Dokumente oder Downloads auf macOS nicht lesen1004### Hintergrund-Sitzungen können Desktop, Dokumente oder Downloads auf macOS nicht lesen

954 1005 

955Unter macOS wird der Hintergrund-Sitzungs-Host als eigener Prozess ausgeführt und fordert Zugriff auf geschützte Ordner separat von Ihrem Terminal an. Wenn eine Hintergrund-Sitzung `Operation not permitted` meldet, wenn sie `~/Desktop`, `~/Documents`, `~/Downloads` oder einen anderen geschützten Ort liest, gewähren Sie Zugriff in den Systemeinstellungen unter Datenschutz & Sicherheit > Dateien und Ordner, oder aktivieren Sie Vollständigen Festplattenzugriff für den Eintrag.1006Unter macOS wird der Hintergrund-Sitzungs-Host als eigener Prozess ausgeführt und fordert Zugriff auf geschützte Ordner separat von Ihrem Terminal an. Wenn eine Hintergrund-Sitzung `Operation not permitted` meldet, wenn sie `~/Desktop`, `~/Documents`, `~/Downloads` oder einen anderen geschützten Ort liest, gewähren Sie Zugriff in den Systemeinstellungen unter Datenschutz & Sicherheit > Dateien und Ordner, oder aktivieren Sie Vollständigen Festplattenzugriff für den Eintrag.


996 1047 

997| Version | Änderung |1048| Version | Änderung |

998| - | - |1049| - | - |

1050| v2.1.299 | [`/effort` und `/fast` in der Dispatch-Eingabe](#set-the-model-effort-and-fast-mode) legen die Effort-Stufe und den Fast-Modus für die Sitzungen fest, die Sie als Nächstes starten. `/model`, `/effort` oder `/fast` ohne Wert eingegeben öffnet eine Auswahl. |

1051| v2.1.299 | Claude Code [interpretiert `--bg` und `--background` nur dann als Flag](#from-your-shell), wenn sie vor einem alleinstehenden `--`-Trennzeichen und außerhalb des Werts eines anderen Flags stehen, und lehnt eine mehrdeutige Position ab, statt zu raten. Vor diesem Release konnte ein Prompt oder eine Antwort an eine Hintergrundsitzung, die `--bg` oder `--background` lautete, als das Flag aufgefasst werden. Dadurch konnten immer wieder neue Hintergrundsitzungen gestartet werden, statt den Text zuzustellen. |

1052| v2.1.296 | Ein Prompt oder `!`-Shell-Befehl, den Sie eingeben, [während die Sitzung in den Hintergrund wechselt](#switch-sessions-without-leaving-the-terminal), wird gestoppt oder nicht gesendet, und sein Text bleibt im Prompt-Verlauf erhalten. Vor diesem Release lief die Antwort oder der Befehl dort weiter, wo Sie sie nicht mehr sehen konnten, und ein direkt nach `←` gesendeter Prompt konnte unbemerkt ein zweites Mal ausgeführt werden. Ein Prompt, der eingegeben wurde, während `SessionStart`-Hooks noch liefen, ging verloren: Er wurde weder gesendet noch im Prompt-Verlauf gespeichert. |

1053| v2.1.295 | `Ctrl+C` im inaktiven Eingabefeld einer [verbundenen Hintergrundsitzung](#attach-to-a-session) lässt das ausstehende Aufwecken eines [selbst getakteten `/loop`](/docs/de/scheduled-tasks#let-claude-choose-the-interval) unberührt, sodass zweimaliges Drücken die Verbindung trennt und die Schleife weiterläuft. `Esc` in diesem Eingabefeld [stoppt die selbst getaktete Schleife](/docs/de/scheduled-tasks#stop-a-loop) und zeigt einen `Pending wakeup cancelled`-Hinweis an. Vor diesem Release konnte das erste `Ctrl+C` eine selbst getaktete Schleife ohne Hinweis beenden, und `Esc` stoppte keine Schleife, die mit der Sitzung in den Hintergrund gewechselt war. |

1054| v2.1.295 | Unter macOS und Linux startet `claude agents`, wenn es sich beendet, während kein [Supervisor](#keep-sessions-running-after-the-supervisor-stops) läuft, nicht von selbst einen neuen. Laufende Sitzungen stoppen dann etwa eine Minute später, sofern Sie `claude agents` nicht erneut ausführen, und die Agentenansicht kann beim Beenden einen entsprechenden Hinweis ausgeben. Vor diesem Release startete das sich beendende `claude agents` einen neuen Supervisor. |

1055| v2.1.295 | Unter macOS mit dem nativen Installer laufen Hintergrundsitzungen, die nach einem Update gemeinsam neu starten, unter demselben Claude-Code-Eintrag, der den von Ihnen gewährten [Zugriff auf geschützte Ordner](#background-sessions-can’t-read-desktop-documents-or-downloads-on-macos) besitzt. Vor diesem Release konnten diese Sitzungen stattdessen unter dem eigenen Pfad der Binärdatei laufen. macOS führt diesen Pfad als separaten Eintrag, sodass die Abfragen für den Ordnerzugriff nach einem Update erneut erscheinen konnten. |

999| v2.1.290 | [`claude attach` und `claude logs`](#manage-sessions-from-the-shell) akzeptieren anstelle der ID einen Teil des Namens einer Sitzung. |1056| v2.1.290 | [`claude attach` und `claude logs`](#manage-sessions-from-the-shell) akzeptieren anstelle der ID einen Teil des Namens einer Sitzung. |

1000| v2.1.290 | `/model`, `/effort`, `/rename` und `/usage` werden sofort ausgeführt, wenn sie als [Peek-Antwort](#peek-and-reply) an eine arbeitende Sitzung gesendet werden. |1057| v2.1.290 | `/model`, `/effort`, `/rename` und `/usage` werden sofort ausgeführt, wenn sie als [Peek-Antwort](#peek-and-reply) an eine arbeitende Sitzung gesendet werden. |

1001| v2.1.290 | Eine [Peek-Antwort](#peek-and-reply), die nicht zugestellt werden kann, wird nicht mehr für den nächsten Neustart gespeichert, wenn sie mit `/` beginnt oder wenn sie eine Frage mit vorgegebenen Auswahlmöglichkeiten beantwortet, während der Prozess der Sitzung läuft. |1058| v2.1.290 | Eine [Peek-Antwort](#peek-and-reply), die nicht zugestellt werden kann, wird nicht mehr für den nächsten Neustart gespeichert, wenn sie mit `/` beginnt oder wenn sie eine Frage mit vorgegebenen Auswahlmöglichkeiten beantwortet, während der Prozess der Sitzung läuft. |


1048| v2.1.216 | `/fork`: Die [Bestätigung](#from-inside-a-session) ist eine Zeile, die den Zustand der Kopie, den Namen ihrer Zeile in der Agentenansicht und ihre Sitzungs-ID für `claude attach` zeigt und nur dann mit `runs in the origin tree` oder `edits this checkout` endet, wenn die Kopie im Haupt-Arbeitsverzeichnis läuft oder den Checkout bearbeitet, den Sie geöffnet haben. Ein Klick auf den Namen verschiebt diese Sitzung in den Hintergrund und öffnet die Agentenansicht in der Sitzung der Kopie. Die Bestätigung wiederholt nicht mehr den geerbten Berechtigungsmodus der Kopie; frühere Versionen gaben eine mehrzeilige Bestätigung ohne anklickbaren Namen aus. Needs input: `/install-github-app` und die `/mcp`-Einstellungsliste zeigen, wenn sie ausgeführt werden, während niemand verbunden ist, die Sitzung unter `Needs input` mit einer Zeile an, die den Befehl nennt, und Verbinden und erneutes Ausführen des Befehls setzt fort; von v2.1.208 bis v2.1.215 wurden sie in diesem Zustand direkt abgelehnt. `--agent`-Wiederherstellung: Das Fortsetzen oder Neustarten einer [in den Hintergrund verschobenen `--agent`-Sitzung](#from-your-shell) stellt den System-Prompt und die Tool-Einschränkungen des Agenten wieder her, wobei zuerst das eigene Verzeichnis der Sitzung nach dem Agenten durchsucht wird, sofern ihr Workspace vertrauenswürdig ist; eine Sitzung, deren Agent nicht mehr existiert, läuft mit den Standard-Tools und dem Standard-System-Prompt weiter und öffnet sich mit einer sichtbaren Warnung, statt unbemerkt auf den Standard-Agenten zurückzufallen. `Ctrl+X`: Zweimaliges Drücken löscht eine Sitzung auch dann, wenn der Stoppversuch fehlschlägt, statt dass ein fehlgeschlagenes Stoppen das ausstehende Löschen abbricht, und eine gelöschte Sitzung, deren Worker-Prozess beendet war, erscheint beim nächsten Aktualisieren nicht mehr erneut. Worktree-Löschung: Eine Sitzung, deren Worktree-Verzeichnis zu keinem Git-Repository gehört, kann gelöscht werden; vor diesem Release wurde jeder Versuch, eine solche Sitzung zu löschen, abgelehnt. Ein bereits nicht mehr vorhandenes Verzeichnis wird sofort bereinigt. Das doppelte Drücken in der Agentenansicht entfernt ein Verzeichnis, das noch Dateien enthält, und führt bei einem von einem Hook erstellten Verzeichnis Ihren `WorktreeRemove`-Hook aus, es sei denn, die Einträge einer anderen Sitzung nennen es ebenfalls. `claude rm` behält ein solches Verzeichnis, solange noch Dateien vorhanden sind. |1105| v2.1.216 | `/fork`: Die [Bestätigung](#from-inside-a-session) ist eine Zeile, die den Zustand der Kopie, den Namen ihrer Zeile in der Agentenansicht und ihre Sitzungs-ID für `claude attach` zeigt und nur dann mit `runs in the origin tree` oder `edits this checkout` endet, wenn die Kopie im Haupt-Arbeitsverzeichnis läuft oder den Checkout bearbeitet, den Sie geöffnet haben. Ein Klick auf den Namen verschiebt diese Sitzung in den Hintergrund und öffnet die Agentenansicht in der Sitzung der Kopie. Die Bestätigung wiederholt nicht mehr den geerbten Berechtigungsmodus der Kopie; frühere Versionen gaben eine mehrzeilige Bestätigung ohne anklickbaren Namen aus. Needs input: `/install-github-app` und die `/mcp`-Einstellungsliste zeigen, wenn sie ausgeführt werden, während niemand verbunden ist, die Sitzung unter `Needs input` mit einer Zeile an, die den Befehl nennt, und Verbinden und erneutes Ausführen des Befehls setzt fort; von v2.1.208 bis v2.1.215 wurden sie in diesem Zustand direkt abgelehnt. `--agent`-Wiederherstellung: Das Fortsetzen oder Neustarten einer [in den Hintergrund verschobenen `--agent`-Sitzung](#from-your-shell) stellt den System-Prompt und die Tool-Einschränkungen des Agenten wieder her, wobei zuerst das eigene Verzeichnis der Sitzung nach dem Agenten durchsucht wird, sofern ihr Workspace vertrauenswürdig ist; eine Sitzung, deren Agent nicht mehr existiert, läuft mit den Standard-Tools und dem Standard-System-Prompt weiter und öffnet sich mit einer sichtbaren Warnung, statt unbemerkt auf den Standard-Agenten zurückzufallen. `Ctrl+X`: Zweimaliges Drücken löscht eine Sitzung auch dann, wenn der Stoppversuch fehlschlägt, statt dass ein fehlgeschlagenes Stoppen das ausstehende Löschen abbricht, und eine gelöschte Sitzung, deren Worker-Prozess beendet war, erscheint beim nächsten Aktualisieren nicht mehr erneut. Worktree-Löschung: Eine Sitzung, deren Worktree-Verzeichnis zu keinem Git-Repository gehört, kann gelöscht werden; vor diesem Release wurde jeder Versuch, eine solche Sitzung zu löschen, abgelehnt. Ein bereits nicht mehr vorhandenes Verzeichnis wird sofort bereinigt. Das doppelte Drücken in der Agentenansicht entfernt ein Verzeichnis, das noch Dateien enthält, und führt bei einem von einem Hook erstellten Verzeichnis Ihren `WorktreeRemove`-Hook aus, es sei denn, die Einträge einer anderen Sitzung nennen es ebenfalls. `claude rm` behält ein solches Verzeichnis, solange noch Dateien vorhanden sind. |

1049| v2.1.214 | Bei einer mit `←` oder `/background` in den Hintergrund verschobenen Sitzung, die inaktiv ist und in der nichts läuft, wird der Prozess wie bei jeder anderen inaktiven Sitzung gestoppt, statt dass ihr Prozess und der Hintergrunddienst unbegrenzt weiterlaufen. Eine abgeschlossene Sitzung kann mit `claude rm` oder aus der Agentenansicht entfernt werden, nachdem der Hintergrunddienst in den Ruhezustand gegangen ist, und eine Sitzung, die in einen Worktree gewechselt ist, nachdem sie aus einem Verzeichnis gestartet wurde, das kein Git-Repository ist, etwa einem Workspace-Ordner mit mehreren Repositorys, kann aus der Agentenansicht gelöscht werden, wenn der Worktree selbst zu einem Git-Repository gehört, weil die Bereinigung anhand des Worktrees statt des Verzeichnisses aufgelöst wird, aus dem die Sitzung gestartet wurde; beide Entfernungen wurden zuvor bei jedem Versuch abgelehnt. Das erneute Öffnen einer gestoppten Sitzung stellt ihre gespeicherte Konversation auch dann wieder her, wenn ein Ordner im Transkriptspeicher nicht gelesen werden kann. |1106| v2.1.214 | Bei einer mit `←` oder `/background` in den Hintergrund verschobenen Sitzung, die inaktiv ist und in der nichts läuft, wird der Prozess wie bei jeder anderen inaktiven Sitzung gestoppt, statt dass ihr Prozess und der Hintergrunddienst unbegrenzt weiterlaufen. Eine abgeschlossene Sitzung kann mit `claude rm` oder aus der Agentenansicht entfernt werden, nachdem der Hintergrunddienst in den Ruhezustand gegangen ist, und eine Sitzung, die in einen Worktree gewechselt ist, nachdem sie aus einem Verzeichnis gestartet wurde, das kein Git-Repository ist, etwa einem Workspace-Ordner mit mehreren Repositorys, kann aus der Agentenansicht gelöscht werden, wenn der Worktree selbst zu einem Git-Repository gehört, weil die Bereinigung anhand des Worktrees statt des Verzeichnisses aufgelöst wird, aus dem die Sitzung gestartet wurde; beide Entfernungen wurden zuvor bei jedem Versuch abgelehnt. Das erneute Öffnen einer gestoppten Sitzung stellt ihre gespeicherte Konversation auch dann wieder her, wenn ein Ordner im Transkriptspeicher nicht gelesen werden kann. |

1050| v2.1.213 | `/install-github-app`, die [`/mcp`](/docs/de/mcp)-Einstellungsliste und MCP-Authentifizierungsaktionen funktionieren in einer Hintergrundsitzung, während ein Terminal verbunden ist, und werden nur abgelehnt, wenn niemand verbunden ist, mit einer Meldung, die Sie auffordert, sich zu verbinden und den Befehl erneut auszuführen; von v2.1.208 bis v2.1.212 wurden sie selbst bei verbundenem Terminal abgelehnt. |1107| v2.1.213 | `/install-github-app`, die [`/mcp`](/docs/de/mcp)-Einstellungsliste und MCP-Authentifizierungsaktionen funktionieren in einer Hintergrundsitzung, während ein Terminal verbunden ist, und werden nur abgelehnt, wenn niemand verbunden ist, mit einer Meldung, die Sie auffordert, sich zu verbinden und den Befehl erneut auszuführen; von v2.1.208 bis v2.1.212 wurden sie selbst bei verbundenem Terminal abgelehnt. |

1051| v2.1.212 | [`/fork` in einer interaktiven Sitzung](#from-inside-a-session) kopiert die Konversation in eine neue Hintergrundsitzung, die als eigene Zeile erscheint, benannt nach der Sitzung, aus der sie stammt, oder bei einem Fork mit Prompt aus einer unbenannten Sitzung nach dem Fork-Prompt, während das Original weiterläuft; das frühere Verhalten von `/fork` als geforkter Subagent wurde zu `/subtask` verschoben. Wenn die [Agentenansicht deaktiviert ist](#turn-off-agent-view), behält `/fork` das Verhalten als geforkter Subagent bei. Eine fokussierte Zeile, die auf ihren ersten Prompt wartet, zeigt `space to send it a prompt` an. `Ctrl+J` fügt in der Dispatch-Eingabe einen Zeilenumbruch ein, auf Terminals mit erweiterter Tastenmeldung, wo der Tastendruck zuvor ignoriert wurde, und das `?`-Overlay listet die Tastenkombination auf. Der `←`-Hinweis in der Fußzeile einer interaktiven Sitzung zeigt kurz `N done` an, wenn eine Hintergrundsitzung fertig wird, während keine Ihre Eingabe benötigt. Die Eingabe eines alleinstehenden `/resume` in der Agentenansicht öffnet eine Auswahl vergangener Sitzungen des Repositorys, aus dem Sie die Agentenansicht geöffnet haben, einschließlich aus der Liste gelöschter Sitzungen, und die Auswahl einer Sitzung setzt sie als Hintergrundsitzung fort; vor diesem Release war `/resume` in der Agentenansicht nicht verfügbar, und gelöschte Sitzungen waren nur mit `claude --resume` oder `/resume` aus einer interaktiven Sitzung erreichbar. Gezielte, beschränkte und eingeschränkte Formen behalten den Hinweis `attach to a session to run it`, den frühere Versionen für jede Form anzeigten. Sitzungen, die auf eine Sandbox-Netzwerk-Host-Abfrage, eine MCP-Eingabeanfrage oder eine Abfrage der verwalteten Einstellungen warten, werden als `Needs input` statt `Working` angezeigt, in der Agentenansicht und in `claude agents --json`, und eine Frage von Claude meldet `waitingFor: input needed` statt `permission prompt`. Das Verbinden mit einer Sitzung, deren Prozess gestoppt wurde, zeigt ihr Transkript so formatiert an, wie die laufende Sitzung es darstellt, statt als Rohtext. Eine gestoppte Sitzung, deren Transkript sich an einem unerwarteten Ort befindet, wird über eine letzte Suche in Ihren gespeicherten Transkripten daraus fortgesetzt, und das Öffnen einer Zeile ohne gespeichertes Transkript zeigt `Press enter again to restart this session fresh` an und startet sie beim zweiten Drücken neu; v2.1.211 zeigte die Ablehnung ohne Möglichkeit, aus der Agentenansicht neu zu starten. |1108| v2.1.212 | [`/fork` in einer interaktiven Sitzung](#from-inside-a-session) kopiert die Konversation in eine neue Hintergrundsitzung, während das Original weiterläuft; das frühere Verhalten von `/fork` als geforkter Subagent wurde zu `/subtask` verschoben. Wenn die [Agentenansicht deaktiviert ist](#turn-off-agent-view), behält `/fork` das Verhalten als geforkter Subagent bei. |

1109| v2.1.212 | [Die Eingabe eines alleinstehenden `/resume` in der Agentenansicht](#bring-back-a-past-session) öffnet eine Auswahl vergangener Sitzungen des Repositorys, aus dem Sie die Agentenansicht geöffnet haben. |

1052| v2.1.211 | Das Aufwecken einer gestoppten Sitzung durch Verbinden oder Antworten aus dem Verzeichnis, in dem sie läuft, leitet die Gateway-`ANTHROPIC_BASE_URL` Ihrer Shell wieder weiter, unter denselben Bedingungen wie ein neuer Start, sodass eine über ein Gateway-`ANTHROPIC_AUTH_TOKEN` authentifizierte Sitzung auf dem Gateway fortgesetzt wird, statt `Not logged in` zu melden. Das Verbinden mit einer gestoppten Sitzung, die aus einer anderen Konversation in den Hintergrund verschoben wurde, bevor ihre erste Antwort fertig war, wird mit `This session has no saved transcript` abgelehnt, statt unbemerkt eine leere Konversation unter derselben Sitzungs-ID zu starten; das Öffnen derselben Zeile aus der Agentenansicht zeigte die Ablehnung in der Fußzeile. Das Beenden des Prozesses einer `←`- oder `/background`-Sitzung von außerhalb von Claude Code markiert sie als gestoppt, statt dass der Supervisor sie neu startet, ein bereits auf der Festplatte aufgezeichneter Stopp wird beachtet, es sei denn, eine von Ihnen gesendete Antwort wartet noch auf Zustellung, einer nach einem Absturz neu gestarteten Sitzung wird mitgeteilt, dass sie neu gestartet wurde, und eine neu gestartete `←`- oder `/background`-Sitzung setzt keine unterbrochene Antwort fort, die älter als etwa eine Stunde ist. Eine Antwort zur Sitzungsbenennung, die den Prompt beantwortet oder ablehnt, statt ihn zu beschriften, etwa bei einem Prompt, der größtenteils aus einem Link besteht, wird verworfen, und die Zeile behält einen aus dem Prompt-Text übernommenen Namen. Das Löschen einer Sitzung, deren Worktree Git nicht mehr erkennt, gelingt, wobei das Worktree-Verzeichnis auf der Festplatte verbleibt und sein Pfad genannt wird, statt dass jeder Versuch abgelehnt wird. Ein abgelehntes Löschen zeigt den Grund in der Zeile der Sitzung an, einschließlich des zugrunde liegenden Git-Fehlers, wenn der Worktree nicht entfernt werden konnte, statt dass die Zeile unbemerkt wieder erscheint. |1110| v2.1.211 | Das Aufwecken einer gestoppten Sitzung durch Verbinden oder Antworten aus dem Verzeichnis, in dem sie läuft, leitet die Gateway-`ANTHROPIC_BASE_URL` Ihrer Shell wieder weiter, unter denselben Bedingungen wie ein neuer Start, sodass eine über ein Gateway-`ANTHROPIC_AUTH_TOKEN` authentifizierte Sitzung auf dem Gateway fortgesetzt wird, statt `Not logged in` zu melden. Das Verbinden mit einer gestoppten Sitzung, die aus einer anderen Konversation in den Hintergrund verschoben wurde, bevor ihre erste Antwort fertig war, wird mit `This session has no saved transcript` abgelehnt, statt unbemerkt eine leere Konversation unter derselben Sitzungs-ID zu starten; das Öffnen derselben Zeile aus der Agentenansicht zeigte die Ablehnung in der Fußzeile. Das Beenden des Prozesses einer `←`- oder `/background`-Sitzung von außerhalb von Claude Code markiert sie als gestoppt, statt dass der Supervisor sie neu startet, ein bereits auf der Festplatte aufgezeichneter Stopp wird beachtet, es sei denn, eine von Ihnen gesendete Antwort wartet noch auf Zustellung, einer nach einem Absturz neu gestarteten Sitzung wird mitgeteilt, dass sie neu gestartet wurde, und eine neu gestartete `←`- oder `/background`-Sitzung setzt keine unterbrochene Antwort fort, die älter als etwa eine Stunde ist. Eine Antwort zur Sitzungsbenennung, die den Prompt beantwortet oder ablehnt, statt ihn zu beschriften, etwa bei einem Prompt, der größtenteils aus einem Link besteht, wird verworfen, und die Zeile behält einen aus dem Prompt-Text übernommenen Namen. Das Löschen einer Sitzung, deren Worktree Git nicht mehr erkennt, gelingt, wobei das Worktree-Verzeichnis auf der Festplatte verbleibt und sein Pfad genannt wird, statt dass jeder Versuch abgelehnt wird. Ein abgelehntes Löschen zeigt den Grund in der Zeile der Sitzung an, einschließlich des zugrunde liegenden Git-Fehlers, wenn der Worktree nicht entfernt werden konnte, statt dass die Zeile unbemerkt wieder erscheint. |

1053| v2.1.210 | `claude attach` wartet, während der Hintergrunddienst startet oder sich neu verbindet, statt mit einem `job not found`- oder `still starting`-Fehler fehlzuschlagen, meldet eine Sitzung, die während des Verbindens beendet wurde, als beendet, und wendet eine während eines langsamen Verbindens vorgenommene Größenänderung des Terminals an, wenn das Verbinden abgeschlossen ist. Die `←`-Anzahl der auf Eingabe wartenden Sitzungen in der Prompt-Fußzeile erscheint bei jedem Anbieter, einschließlich Drittanbietern, die zuvor die einfache Form `← for agents` zeigten. Das Verschieben einer Sitzung in den Hintergrund mit `←` überträgt Claudes Aufgabenliste in die Hintergrundsitzung, statt sie zu verwerfen. Die Zeile, aus der Sie `←` gedrückt haben, behält einen fetten, nicht abgeblendeten Namen, nachdem die Auswahl weiterbewegt wurde. `claude agents --effort` akzeptiert `ultracode`, statt es unbemerkt zu verwerfen. |1111| v2.1.210 | `claude attach` wartet, während der Hintergrunddienst startet oder sich neu verbindet, statt mit einem `job not found`- oder `still starting`-Fehler fehlzuschlagen, meldet eine Sitzung, die während des Verbindens beendet wurde, als beendet, und wendet eine während eines langsamen Verbindens vorgenommene Größenänderung des Terminals an, wenn das Verbinden abgeschlossen ist. Die `←`-Anzahl der auf Eingabe wartenden Sitzungen in der Prompt-Fußzeile erscheint bei jedem Anbieter, einschließlich Drittanbietern, die zuvor die einfache Form `← for agents` zeigten. Das Verschieben einer Sitzung in den Hintergrund mit `←` überträgt Claudes Aufgabenliste in die Hintergrundsitzung, statt sie zu verwerfen. Die Zeile, aus der Sie `←` gedrückt haben, behält einen fetten, nicht abgeblendeten Namen, nachdem die Auswahl weiterbewegt wurde. `claude agents --effort` akzeptiert `ultracode`, statt es unbemerkt zu verwerfen. |

1054| v2.1.208 | Das Verbinden mit einer Sitzung, deren Prozess gestoppt wurde, zeigt den letzten Bildschirminhalt ihres Transkripts an, während der Prozess startet, statt nur eines `Session is starting`-Hinweises. Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrunddienst nicht erreichbar ist oder das Senden fehlschlägt, wird gespeichert und als nächster Prompt der Sitzung gesendet, wenn ihr Prozess wieder startet; vor diesem Release wurde eine Antwort, die verloren ging, während der Hintergrunddienst nicht erreichbar war, verworfen. Ein Prozess, dessen eigene Binärdatei durch ein Update ersetzt wurde, kann den Supervisor weiterhin starten, über den installierten `claude`-Launcher oder die neueste Version auf der Festplatte, statt fehlzuschlagen, bis Claude Code neu gestartet wurde. Ein Supervisor, der eine ältere Version ausführt, startet eine inaktive, von einer neueren Version gestartete Sitzung nie mit seiner eigenen älteren Binärdatei neu. Das Löschen einer Sitzung entfernt ihren Worktree auch dann, wenn die Sitzung den Worktree auf einen anderen Branch umgestellt hat, und behält den Worktree zusammen mit der Sitzungszeile bei, wenn der Worktree Commits hat, die nirgendwohin gepusht wurden, oder eine andere Sitzung ihn beansprucht, statt die Commits zu vernichten oder den Worktree verwaist zurückzulassen. `/install-github-app` sowie die `/mcp`-Einstellungsliste und deren Authentifizierungsaktionen werden in einer Hintergrundsitzung mit einer Meldung abgelehnt, die die Alternative nennt; nur in v2.1.208 wurde die `/model`-Auswahl auf dieselbe Weise abgelehnt, und ein eingegebenes `/model <name>` wechselte nur das Modell dieser Sitzung, statt auch Ihr Standardmodell zu speichern. |1112| v2.1.208 | Das Verbinden mit einer Sitzung, deren Prozess gestoppt wurde, zeigt den letzten Bildschirminhalt ihres Transkripts an, während der Prozess startet, statt nur eines `Session is starting`-Hinweises. Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrunddienst nicht erreichbar ist oder das Senden fehlschlägt, wird gespeichert und als nächster Prompt der Sitzung gesendet, wenn ihr Prozess wieder startet; vor diesem Release wurde eine Antwort, die verloren ging, während der Hintergrunddienst nicht erreichbar war, verworfen. Ein Prozess, dessen eigene Binärdatei durch ein Update ersetzt wurde, kann den Supervisor weiterhin starten, über den installierten `claude`-Launcher oder die neueste Version auf der Festplatte, statt fehlzuschlagen, bis Claude Code neu gestartet wurde. Ein Supervisor, der eine ältere Version ausführt, startet eine inaktive, von einer neueren Version gestartete Sitzung nie mit seiner eigenen älteren Binärdatei neu. Das Löschen einer Sitzung entfernt ihren Worktree auch dann, wenn die Sitzung den Worktree auf einen anderen Branch umgestellt hat, und behält den Worktree zusammen mit der Sitzungszeile bei, wenn der Worktree Commits hat, die nirgendwohin gepusht wurden, oder eine andere Sitzung ihn beansprucht, statt die Commits zu vernichten oder den Worktree verwaist zurückzulassen. `/install-github-app` sowie die `/mcp`-Einstellungsliste und deren Authentifizierungsaktionen werden in einer Hintergrundsitzung mit einer Meldung abgelehnt, die die Alternative nennt; nur in v2.1.208 wurde die `/model`-Auswahl auf dieselbe Weise abgelehnt, und ein eingegebenes `/model <name>` wechselte nur das Modell dieser Sitzung, statt auch Ihr Standardmodell zu speichern. |


1061| v2.1.199 | Eine Hintergrundsitzung, deren Prozess auf einem Host mit wenig Arbeitsspeicher beendet wird, bevor er vollständig gestartet ist, zeigt in ihrem Zeilenstatus `possibly low memory — free some up and retry` an statt nur des reinen Beendigungsgrunds. Das Verschieben einer Sitzung in den Hintergrund mit `←` oder `/background` überträgt ihre `/color` auf die neue Zeile. |1119| v2.1.199 | Eine Hintergrundsitzung, deren Prozess auf einem Host mit wenig Arbeitsspeicher beendet wird, bevor er vollständig gestartet ist, zeigt in ihrem Zeilenstatus `possibly low memory — free some up and retry` an statt nur des reinen Beendigungsgrunds. Das Verschieben einer Sitzung in den Hintergrund mit `←` oder `/background` überträgt ihre `/color` auf die neue Zeile. |

1062| v2.1.198 | Die Agentenansicht sendet eine Benachrichtigung über `preferredNotifChannel`, wenn eine Hintergrundsitzung eine Eingabe benötigt, fertig wird oder fehlschlägt, und löst den `Notification`-Hook mit dem Typ `agent_needs_input` oder `agent_completed` aus. `←` und `/exit` innerhalb von `claude attach <id>` kehren zur Agentenansicht zurück, statt zur Shell zu beenden; `Ctrl+Z` kehrt zur Shell zurück. Eine Hintergrundsitzung, die ihre Arbeit in einem Worktree isoliert hat, committet, pusht ihren eigenen isolierten Branch, niemals `main` oder `master`, und öffnet einen Draft-Pull-Request, wenn sie fertig ist, statt vorher nachzufragen. `/login` läuft in der Agentenansicht und öffnet den Anmeldedialog. Der Beenden-Dialog `Background work is running` bietet `Move to background and exit` an. Die Übergabe beim Beenden umfasst auch Hintergrund-Subagenten, die beim nächsten Aufwecken aus ihrem Transkript fortgesetzt werden, statt als fehlgeschlagen gemeldet zu werden. `claude --bg` in Kombination mit `-p` oder `--print` wird mit einem Fehler abgelehnt. Der Host für Hintergrundsitzungen fordert beim ersten LAN-Zugriff die macOS-Berechtigung für das lokale Netzwerk an, statt mit `connect: no route to host` fehlzuschlagen. |1120| v2.1.198 | Die Agentenansicht sendet eine Benachrichtigung über `preferredNotifChannel`, wenn eine Hintergrundsitzung eine Eingabe benötigt, fertig wird oder fehlschlägt, und löst den `Notification`-Hook mit dem Typ `agent_needs_input` oder `agent_completed` aus. `←` und `/exit` innerhalb von `claude attach <id>` kehren zur Agentenansicht zurück, statt zur Shell zu beenden; `Ctrl+Z` kehrt zur Shell zurück. Eine Hintergrundsitzung, die ihre Arbeit in einem Worktree isoliert hat, committet, pusht ihren eigenen isolierten Branch, niemals `main` oder `master`, und öffnet einen Draft-Pull-Request, wenn sie fertig ist, statt vorher nachzufragen. `/login` läuft in der Agentenansicht und öffnet den Anmeldedialog. Der Beenden-Dialog `Background work is running` bietet `Move to background and exit` an. Die Übergabe beim Beenden umfasst auch Hintergrund-Subagenten, die beim nächsten Aufwecken aus ihrem Transkript fortgesetzt werden, statt als fehlgeschlagen gemeldet zu werden. `claude --bg` in Kombination mit `-p` oder `--print` wird mit einem Fehler abgelehnt. Der Host für Hintergrundsitzungen fordert beim ersten LAN-Zugriff die macOS-Berechtigung für das lokale Netzwerk an, statt mit `connect: no route to host` fehlzuschlagen. |

1063| v2.1.196 | Ein einziges Drücken von `←` verschiebt eine Vordergrundsitzung in den Hintergrund; frühere Versionen erforderten zwei Tastendrücke, mit einem Hinweis in der Fußzeile und einer Bestätigung. An `claude agents` übergebenes `--dangerously-skip-permissions` zeigt den Bypass-Hinweis an, statt unbemerkt verworfen zu werden. Interaktive Sitzungen, die Sie nie benannt haben, tragen in Sitzungslisten und in `claude agents --json` einen Standardnamen wie `my-app-3f`. Hintergrund-Shell-Befehle und dynamische Workflows überstehen das Stoppen, Neustarten oder Aktualisieren des Sitzungsprozesses, auch unter Windows; setzen Sie `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, um die Übergabe zu deaktivieren. Ein Transkript, das beim Neustart fälschlich als leer gelesen wird, wird mit einem `.orphaned-`-Suffix umbenannt statt gelöscht. |1121| v2.1.196 | Ein einziges Drücken von `←` verschiebt eine Vordergrundsitzung in den Hintergrund; frühere Versionen erforderten zwei Tastendrücke, mit einem Hinweis in der Fußzeile und einer Bestätigung. An `claude agents` übergebenes `--dangerously-skip-permissions` zeigt den Bypass-Hinweis an, statt unbemerkt verworfen zu werden. Interaktive Sitzungen, die Sie nie benannt haben, tragen in Sitzungslisten und in `claude agents --json` einen Standardnamen wie `my-app-3f`. Hintergrund-Shell-Befehle und dynamische Workflows überstehen das Stoppen, Neustarten oder Aktualisieren des Sitzungsprozesses, auch unter Windows; setzen Sie `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, um die Übergabe zu deaktivieren. Ein Transkript, das beim Neustart fälschlich als leer gelesen wird, wird mit einem `.orphaned-`-Suffix umbenannt statt gelöscht. |

1064| v2.1.195 | Laufende Hintergrundarbeit wird auch unter Windows übernommen, wenn Sie eine Sitzung in den Hintergrund verschieben; setzen Sie `CLAUDE_DISABLE_ADOPT=1`, um sie stattdessen zu stoppen. Die Gruppe `Completed` füllt den verbleibenden vertikalen Platz, und die Kopfzeile wird auf kurzen Terminals kompakter. Eine ältere Claude-Code-Version verwirft keine `state.json`-Felder neuerer Sitzungen mehr und blendet diese Sitzungen nicht mehr in `claude agents` aus. Das Verbinden mit einer gestoppten Sitzung wechselt sofort, statt bis zu fünf Sekunden lang einen leeren Bildschirm anzuzeigen. Ein Supervisor, der keine Verbindungen annehmen kann, beendet sich und gibt seine Sperre selbstständig frei. |1122| v2.1.195 | Laufende Hintergrundarbeit wird auch unter Windows übernommen, wenn Sie eine Sitzung in den Hintergrund verschieben. Die Gruppe `Completed` füllt den verbleibenden vertikalen Platz, und die Kopfzeile wird auf kurzen Terminals kompakter. Eine ältere Claude-Code-Version verwirft keine `state.json`-Felder neuerer Sitzungen mehr und blendet diese Sitzungen nicht mehr in `claude agents` aus. Das Verbinden mit einer gestoppten Sitzung wechselt sofort, statt bis zu fünf Sekunden lang einen leeren Bildschirm anzuzeigen. Ein Supervisor, der keine Verbindungen annehmen kann, beendet sich und gibt seine Sperre selbstständig frei. |

1065| v2.1.191 | `claude --bg` mit einem `--agent`-Namen, der keinem Ihrer Subagenten entspricht, lässt den Start fehlschlagen: Die Sitzung beendet sich sofort mit einem `--agent '<name>' not found`-Fehler, statt mit dem Standard-Agenten zu laufen. |1123| v2.1.191 | `claude --bg` mit einem `--agent`-Namen, der keinem Ihrer Subagenten entspricht, lässt den Start fehlschlagen: Die Sitzung beendet sich sofort mit einem `--agent '<name>' not found`-Fehler, statt mit dem Standard-Agenten zu laufen. |

1066| v2.1.174 | Hintergrundsitzungen erben keine Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL` mehr aus der Start-Shell des Supervisors; der Supervisor liefert vorab gestarteten Workern einen frischen Snapshot der Anmeldedaten, wodurch fälschliche `Could not resolve authentication method`-Fehler behoben werden. |1124| v2.1.174 | Hintergrundsitzungen erben keine Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL` mehr aus der Start-Shell des Supervisors; der Supervisor liefert vorab gestarteten Workern einen frischen Snapshot der Anmeldedaten, wodurch fälschliche `Could not resolve authentication method`-Fehler behoben werden. |

1067| v2.1.172 | `/model` in der Dispatch-Eingabe legt eine sitzungsbezogene Überschreibung des Dispatch-Modells fest. |1125| v2.1.172 | `/model` in der Dispatch-Eingabe legt eine sitzungsbezogene Überschreibung des Dispatch-Modells fest. |

artifacts.md +16 −5

Details

98* **`Enter`**: öffnet es in Ihrem Browser, wenn es bereits an die aktuelle Sitzung angefügt ist, und fügt es an, wenn dies nicht der Fall ist. Vor v2.1.216 öffnete `Enter` es in Ihrem Browser98* **`Enter`**: öffnet es in Ihrem Browser, wenn es bereits an die aktuelle Sitzung angefügt ist, und fügt es an, wenn dies nicht der Fall ist. Vor v2.1.216 öffnete `Enter` es in Ihrem Browser

99* **`o`**: öffnet es in Ihrem Browser99* **`o`**: öffnet es in Ihrem Browser

100* **`c`**: kopiert seinen Link100* **`c`**: kopiert seinen Link

101* **`d`**: löscht außerhalb einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) ein Artefakt, das Sie besitzen, nach Ihrer Bestätigung dauerhaft. Sein Link funktioniert danach für niemanden mehr, auch nicht für Sie

101 102 

102Claude Code liest die Liste aus Ihrem claude.ai-Konto, daher funktioniert es in einer neuen Sitzung und nach `/clear`, wenn der Link aus dem Terminal gescrollt ist.103Claude Code liest die Liste aus Ihrem claude.ai-Konto, daher funktioniert `/artifacts` in einer neuen Sitzung und nach `/clear`, wenn der Link eines Artefakts aus dem Terminal gescrollt ist.

103 104 

104## Ein Artefakt teilen105## Ein Artefakt teilen

105 106 


112* **Innerhalb Ihrer Organisation**: Bei Team- und Enterprise-Plänen können Sie Zugriff auf bestimmte Personen in Ihrer Organisation oder auf alle gewähren. Betrachter melden sich bei claude.ai als Mitglieder Ihrer Organisation an, um die Seite zu sehen.113* **Innerhalb Ihrer Organisation**: Bei Team- und Enterprise-Plänen können Sie Zugriff auf bestimmte Personen in Ihrer Organisation oder auf alle gewähren. Betrachter melden sich bei claude.ai als Mitglieder Ihrer Organisation an, um die Seite zu sehen.

113* **Öffentlich**: Teilen Sie einen Link, den jeder im Internet öffnen kann, ohne sich bei claude.ai anmelden zu müssen. Bei Team- und Enterprise-Plänen ist die öffentliche Freigabe deaktiviert, bis ein Eigentümer [sie für die Organisation aktiviert](#control-public-sharing).114* **Öffentlich**: Teilen Sie einen Link, den jeder im Internet öffnen kann, ohne sich bei claude.ai anmelden zu müssen. Bei Team- und Enterprise-Plänen ist die öffentliche Freigabe deaktiviert, bis ein Eigentümer [sie für die Organisation aktiviert](#control-public-sharing).

114 115 

116### Auf eine bestimmte Ansicht verlinken

117 

118Wenn eine Seite mehrere Ansichten hat, etwa Tabs oder Abschnitte, können Sie direkt auf eine davon verlinken. Bitten Sie Claude um die Links:

119 

120```text wrap theme={null}

121Give me a link to each tab of the deploy failures dashboard.

122```

123 

124Jeder Link ist der Link des Artefakts mit einem Anker am Ende, etwa `#overview`.

125 

115### Lassen Sie jemanden mit Ihnen bearbeiten126### Lassen Sie jemanden mit Ihnen bearbeiten

116 127 

117Personen, mit denen Sie teilen, sind standardmäßig Betrachter: Sie sehen jede Version, die Sie veröffentlichen, können aber die Seite nicht ändern. Bei Team- und Enterprise-Plänen können Sie jemanden auch zum Bearbeiter machen. Fügen Sie im Freigabedialog eine Person hinzu und ändern Sie ihre Rolle von **Betrachter** zu **Bearbeiter**.128Personen, mit denen Sie teilen, sind standardmäßig Betrachter: Sie sehen jede Version, die Sie veröffentlichen, können aber die Seite nicht ändern. Bei Team- und Enterprise-Plänen können Sie jemanden auch zum Bearbeiter machen. Fügen Sie im Freigabedialog eine Person hinzu und ändern Sie ihre Rolle von **Betrachter** zu **Bearbeiter**.


424 435 

425| Methode | Endpunkt |436| Methode | Endpunkt |

426| :- | :- |437| :- | :- |

427| `GET` | `/v1/compliance/code/artifacts` |438| `GET` | `/v1/compliance/apps/code/artifacts` |

428| `GET` | `/v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}` |439| `GET` | `/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}` |

429| `DELETE` | `/v1/compliance/code/artifacts/{artifact_id}` |440| `DELETE` | `/v1/compliance/apps/code/artifacts/{artifact_id}` |

430 441 

431Für die Request- und Response-Schemas siehe die [Compliance API-Referenz](https://docs.claude.com/en/api/compliance/code/artifacts).442Die Schemas für Anfrage und Antwort finden Sie in der [Compliance API-Referenz](https://platform.claude.com/docs/en/api/compliance/apps/code/artifacts).

432 443 

433## Verwandte Ressourcen444## Verwandte Ressourcen

434 445 

Details

161 161 

162> [!NOTE]162> [!NOTE]

163>163>

164> `/auto-mode-setup` erfordert einen Pro-, Max- oder Team-Plan und Claude Code v2.1.228 oder später. Unter nativem Windows ist v2.1.233 oder später erforderlich. Sie können es nicht in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) ausführen. Es benötigt auch [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching), daher können Sie es nicht in einer Sitzung ausführen, in der Sie den Flag-Abruf deaktiviert haben.164> `/auto-mode-setup` ist in den Plänen Pro, Max, Team und Enterprise sowie mit einem Claude Console API-Schlüssel verfügbar. Bei einem Pro-, Max- oder Team-Plan benötigen Sie v2.1.228 oder später bzw. unter nativem Windows v2.1.233 oder später. Bei einem Enterprise-Plan oder mit einem Claude Console API-Schlüssel benötigen Sie v2.1.283 oder später. Wenn der Befehl in Ihrer Sitzung fehlt, lesen Sie [`/auto-mode-setup` gibt „Unknown command“ zurück](#auto-mode-setup-returns-unknown-command).

165 165 

166### Was `/auto-mode-setup` liest166### Was `/auto-mode-setup` liest

167 167 


202 202 

203`/auto-mode-setup` ist ein integrierter Befehl und keine [gebündelte Skill](/docs/de/skills#bundled-skills), daher gilt dieser `skillOverrides`-Eintrag immer noch dafür, aber [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills) schaltet ihn nicht aus.203`/auto-mode-setup` ist ein integrierter Befehl und keine [gebündelte Skill](/docs/de/skills#bundled-skills), daher gilt dieser `skillOverrides`-Eintrag immer noch dafür, aber [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills) schaltet ihn nicht aus.

204 204 

205### `/auto-mode-setup` gibt „Unknown command“ zurück

206 

207Wenn die Eingabe von `/auto-mode-setup` im Claude Code-Prompt `Unknown command: /auto-mode-setup` ausgibt, prüfen Sie diese Ursachen:

208 

209* **Erste Sitzung nach einer Installation oder einem Upgrade**: Starten Sie eine neue Sitzung. Wenn der Befehl dort immer noch fehlt, lesen Sie die [Konfigurationen, in denen auch spätere Sitzungen ohne ihn starten](/docs/de/env-vars#first-session-after-an-install-or-upgrade).

210* **Veraltete Version**: Führen Sie `claude --version` in Ihrer Shell aus. Wenn die Version unter [dem Minimum für Ihren Plan](#generate-environment-entries) liegt, [aktualisieren Sie Claude Code](/docs/de/setup#update-claude-code).

211* **Telemetrie ausgeschaltet, Drittanbieter oder Claude-Apps-Gateway**: Vor v2.1.304 ist der Befehl in [Sitzungen, in denen der Feature-Flag-Abruf ausgeschaltet ist](/docs/de/env-vars#features-that-need-feature-flag-fetching), nicht verfügbar. Wenn Ihre Sitzung dazu gehört, [aktualisieren Sie Claude Code](/docs/de/setup#update-claude-code) auf v2.1.304 oder später.

212 

213In einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) gibt der Befehl stattdessen `/auto-mode-setup isn't available in this environment.` aus. Führen Sie ihn in einer interaktiven Sitzung in Ihrem Terminal aus.

214 

205## Override the block and allow rules215## Override the block and allow rules

206 216 

207Drei zusätzliche Felder ermöglichen es Ihnen, die integrierten Regellisten des Klassifizierers zu ersetzen:217Drei zusätzliche Felder ermöglichen es Ihnen, die integrierten Regellisten des Klassifizierers zu ersetzen:

Details

44 44 

45Die Auswahl von „Bis hier zusammenfassen“ lässt Sie am Ende der Konversation mit leerem Eingabefeld zurück. Bei beiden Zusammenfassungsoptionen wird ein **Zusammengefasste Konversation**-Marker in der Konversation angezeigt, wo die komprimierten Nachrichten waren.45Die Auswahl von „Bis hier zusammenfassen“ lässt Sie am Ende der Konversation mit leerem Eingabefeld zurück. Bei beiden Zusammenfassungsoptionen wird ein **Zusammengefasste Konversation**-Marker in der Konversation angezeigt, wo die komprimierten Nachrichten waren.

46 46 

47#### Zurückgespulte Nachrichten können zurückkehren, wenn Sie vor Ihrem nächsten Prompt beenden

48 

49Um die zurückgekehrten Nachrichten erneut zu entfernen, führen Sie `/rewind` in der Sitzung aus, wählen Sie denselben Prompt aus und anschließend **Konversation wiederherstellen**. Senden Sie Claude vor dem Beenden einen Prompt, da Claude Code die zurückgespulte Konversation zusammen mit diesem Prompt speichert. Von Ihnen wiederhergestellte Dateien bleiben so, wie der Rewind sie hinterlassen hat.

50 

47#### Rewind über eine gelöschte Konversation hinweg51#### Rewind über eine gelöschte Konversation hinweg

48 52 

49Wenn Sie `/clear` früher im selben Claude Code-Prozess ausgeführt haben, zeigt das Rewind-Menü einen zusätzlichen Eintrag oben in der Liste mit der Bezeichnung `/resume <session-id> (previous session)`. Wählen Sie ihn aus, um die Konversation fortzusetzen, die vor dem Ausführen von `/clear` aktiv war. Der Eintrag ist verfügbar, bis Sie Claude Code beenden oder eine andere Sitzung fortsetzen.53Wenn Sie `/clear` früher im selben Claude Code-Prozess ausgeführt haben, zeigt das Rewind-Menü einen zusätzlichen Eintrag oben in der Liste mit der Bezeichnung `/resume <session-id> (previous session)`. Wählen Sie ihn aus, um die Konversation fortzusetzen, die vor dem Ausführen von `/clear` aktiv war. Der Eintrag ist verfügbar, bis Sie Claude Code beenden oder eine andere Sitzung fortsetzen.

Details

827Eine `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:827Eine `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:

828 828 

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

830* **Ablehnungslisten und Hook-Arrays**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` und jedes `hooks`-Event-Typ-Array. Diese nehmen die Vereinigung von Basis und Richtlinie, sodass ein organisationsweiter Ablehnungs- oder Audit-Hook nicht versehentlich durch eine Pro-Rollen-Überschreibung gelöscht werden kann.830* **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.

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

832 832 

833`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).833`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).


973| Schlüssel | Erzwungen von | Auswirkung |973| Schlüssel | Erzwungen von | Auswirkung |

974| - | - | - |974| - | - | - |

975| `availableModels` | Gateway + CLI | Modell-Zulassungsliste. Auch unter `/v1/messages` geprüft, sodass ein gepatchter Client sie nicht umgehen kann. |975| `availableModels` | Gateway + CLI | Modell-Zulassungsliste. Auch unter `/v1/messages` geprüft, sodass ein gepatchter Client sie nicht umgehen kann. |

976| [`deniedModels`](/docs/de/settings-reference#deniedmodels), [`availableModelsMatch`](/docs/de/settings-reference#availablemodelsmatch) | Gateway + CLI | [Bestimmte Modelle oder Versionen blockieren](/docs/de/model-config#block-specific-models-or-versions), die `availableModels` sonst zulassen würde. Ein blockiertes Modell wird an `/v1/messages` mit `400` abgelehnt und erscheint nicht in `/v1/models`. Die eigene Prüfung des Gateways erfordert Claude Code v2.1.299 oder höher auf dem Gateway-Server. Die Prüfung der CLI erfordert v2.1.283 oder höher auf den Clients; frühere Clients ignorieren beide Schlüssel. |

976| `permissions.allow` / `.deny` | CLI | Tool- und Befehlsregeln. Siehe [Berechtigungen](/docs/de/permissions). |977| `permissions.allow` / `.deny` | CLI | Tool- und Befehlsregeln. Siehe [Berechtigungen](/docs/de/permissions). |

977| `permissions.disableBypassPermissionsMode` | CLI | Setzen Sie auf `disable`, um [`bypassPermissions`](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode), den Modus, der Berechtigungsabfragen überspringt, und das Flag `--dangerously-skip-permissions` zu blockieren |978| `permissions.disableBypassPermissionsMode` | CLI | Setzen Sie auf `disable`, um [`bypassPermissions`](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode), den Modus, der Berechtigungsabfragen überspringt, und das Flag `--dangerously-skip-permissions` zu blockieren |

978| `allowManagedPermissionRulesOnly` | CLI | Wenn `true`, werden verwaltete Einstellungen zur einzigen Einstellungsquelle von Berechtigungsregeln. Der Eintrag [`allowManagedPermissionRulesOnly`](/docs/de/settings-reference#allowmanagedpermissionrulesonly) listet jede Quelle auf, die Claude Code dann ignoriert. |979| `allowManagedPermissionRulesOnly` | CLI | Wenn `true`, werden verwaltete Einstellungen zur einzigen Einstellungsquelle von Berechtigungsregeln. Der Eintrag [`allowManagedPermissionRulesOnly`](/docs/de/settings-reference#allowmanagedpermissionrulesonly) listet jede Quelle auf, die Claude Code dann ignoriert. |


1045 1046 

1046Das Gateway leitet einen Großteil der Bootstrap-Antwort aus dem `cli`- oder `code`-Block der zutreffenden Richtlinie und aus der Gateway-Konfiguration auf oberster Ebene ab:1047Das Gateway leitet einen Großteil der Bootstrap-Antwort aus dem `cli`- oder `code`-Block der zutreffenden Richtlinie und aus der Gateway-Konfiguration auf oberster Ebene ab:

1047 1048 

1048* Die Modellliste aus `availableModels`. [Erweiterter Kontext in Claude Desktop](#extended-context-in-claude-desktop) behandelt die 1M-Kontextoption jedes Modells1049* Die Modellliste, aus `availableModels`. Die Liste lässt Modelle aus, die die Richtlinie mit [`deniedModels` oder `availableModelsMatch: exact`](#what-goes-in-cli) blockiert. Dieser Filter erfordert Claude Code v2.1.299 oder höher auf dem Gateway-Server. [Erweiterter Kontext in Claude Desktop](#extended-context-in-claude-desktop) behandelt die 1M-Kontextoption jedes Modells

1049* Deaktivierte Tools aus `permissions.deny`-Einträgen mit bloßen Tool-Namen. Wenn Sie `disabledBuiltinTools` im `desktop`-Block der Richtlinie setzen, bedient das Gateway die Vereinigung Ihres Wertes und der abgeleiteten Liste, sodass Sie auf diese Weise mehr Tools deaktivieren können, aber eines, das Sie durch `permissions.deny` deaktiviert haben, nicht erneut aktivieren können1050* Deaktivierte Tools aus `permissions.deny`-Einträgen mit bloßen Tool-Namen. Wenn Sie `disabledBuiltinTools` im `desktop`-Block der Richtlinie setzen, bedient das Gateway die Vereinigung Ihres Wertes und der abgeleiteten Liste, sodass Sie auf diese Weise mehr Tools deaktivieren können, aber eines, das Sie durch `permissions.deny` deaktiviert haben, nicht erneut aktivieren können

1050* Die Egress-Allowlist, aus `sandbox.network.allowedDomains`. Wenn Sie `coworkEgressAllowedHosts` im `desktop`-Block der Richtlinie setzen, verwendet das Gateway diesen Wert anstelle der abgeleiteten Liste. Wenn die vom Gateway ausgelieferte Allowlist `*` enthält und das Gateway nicht zusätzlich [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/code#applied-as-managed-policy) von Claude Desktop ausliefert, schaltet Claude Desktop die [Bash-Sandbox](/docs/de/sandboxing) im Code-Tab nicht ein1051* Die Egress-Allowlist, aus `sandbox.network.allowedDomains`. Wenn Sie `coworkEgressAllowedHosts` im `desktop`-Block der Richtlinie setzen, verwendet das Gateway diesen Wert anstelle der abgeleiteten Liste. Wenn die vom Gateway ausgelieferte Allowlist `*` enthält und das Gateway nicht zusätzlich [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/code#applied-as-managed-policy) von Claude Desktop ausliefert, schaltet Claude Desktop die [Bash-Sandbox](/docs/de/sandboxing) im Code-Tab nicht ein

1051* Ein OTLP-Endpunkt, der auf das Gateway selbst zeigt, und die Identitätsattribute des angemeldeten Benutzers. Das Gateway leitet die Exporte, die es an diesem Endpunkt erhält, an Ihre `forward_to`-Ziele weiter. Es enthält den Endpunkt und die Attribute, wenn Sie sowohl [`telemetry.forward_to`](#telemetry) als auch `listen.public_url` setzen.1052* Ein OTLP-Endpunkt, der auf das Gateway selbst zeigt, und die Identitätsattribute des angemeldeten Benutzers. Das Gateway leitet die Exporte, die es an diesem Endpunkt erhält, an Ihre `forward_to`-Ziele weiter. Es enthält den Endpunkt und die Attribute, wenn Sie sowohl [`telemetry.forward_to`](#telemetry) als auch `listen.public_url` setzen.

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Cloud-Sitzungen sind in Pro-, Max- und Team-Plänen sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen verfügbar.11> Cloud-Sitzungen sind in Pro-, Max- und Team-Plänen sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen verfügbar. Wenn Ihre Enterprise-Organisation Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452) verwaltet, benötigen Sie außerdem eine Rolle, die die Berechtigung für Cloud-Sitzungen enthält. Bitten Sie einen Owner, Ihre Rollen zu überprüfen und die Berechtigung unter [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) hinzuzufügen, falls sie fehlt.

12 12 

13Eine Cloud-Sitzung ist eine Claude Code-Sitzung, die auf Cloud-Infrastruktur statt auf Ihrem Computer ausgeführt wird. Standardmäßig wird sie auf von Anthropic verwalteter Infrastruktur ausgeführt oder auf der [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) Ihrer Organisation, wenn sie dorthin weitergeleitet wird. Die Sitzung läuft weiter, nachdem Sie Ihren Laptop schließen, und Sie können sie von jedem Gerät aus überprüfen oder steuern. Sie wird zusammen mit Ihrer übrigen Nutzung von Claude und Claude Code auf die Nutzungslimits Ihres Plans angerechnet, und für die Cloud-VM fallen keine separaten Kosten an.13Eine Cloud-Sitzung ist eine Claude Code-Sitzung, die auf Cloud-Infrastruktur statt auf Ihrem Computer ausgeführt wird. Standardmäßig wird sie auf von Anthropic verwalteter Infrastruktur ausgeführt oder auf der [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) Ihrer Organisation, wenn sie dorthin weitergeleitet wird. Die Sitzung läuft weiter, nachdem Sie Ihren Laptop schließen, und Sie können sie von jedem Gerät aus überprüfen oder steuern. Sie wird zusammen mit Ihrer übrigen Nutzung von Claude und Claude Code auf die Nutzungslimits Ihres Plans angerechnet, und für die Cloud-VM fallen keine separaten Kosten an.

14 14 


264 264 

265* **`/model`, `/effort`, `/color` und `/rename`**: Übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet`, anstatt die Terminal-Auswahl oder den Schieberegler zu öffnen. Die Argumentformen folgen den [Verfügbarkeitshinweisen](/docs/de/commands#all-commands) jedes Befehls.265* **`/model`, `/effort`, `/color` und `/rename`**: Übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet`, anstatt die Terminal-Auswahl oder den Schieberegler zu öffnen. Die Argumentformen folgen den [Verfügbarkeitshinweisen](/docs/de/commands#all-commands) jedes Befehls.

266* **`/fast`**: schaltet den [Fast-Modus](/docs/de/fast-mode#use-fast-mode-in-cloud-sessions) für die Sitzung um, wenn Fast-Modus [auf Ihrem Konto verfügbar ist](/docs/de/fast-mode#requirements). Erfordert Claude Code v2.1.271 oder später in der Umgebung der Sitzung.266* **`/fast`**: schaltet den [Fast-Modus](/docs/de/fast-mode#use-fast-mode-in-cloud-sessions) für die Sitzung um, wenn Fast-Modus [auf Ihrem Konto verfügbar ist](/docs/de/fast-mode#requirements). Erfordert Claude Code v2.1.271 oder später in der Umgebung der Sitzung.

267* **`/config`**: In Ihrem Browser unter claude.ai/code öffnet dies den Claude Code-Bereich Ihrer Einstellungen, anstatt einen Wert zu setzen, und Text nach dem Befehl, einschließlich `key=value`, wird ignoriert. Um eine Einstellung für eine Cloud-Sitzung zu ändern, legen Sie eine [Umgebungsvariable](/docs/de/cloud-environments#set-environment-variables) in der Umgebung fest, oder committen Sie in einer Sitzung mit einem Repository den Schlüssel in die `.claude/settings.json` dieses Repositorys. [Einstellungen in Cloud-Sitzungen](/docs/de/settings#settings-in-cloud-sessions) listet auf, was jede Sitzung liest.267* **`/config`**: In Ihrem Browser unter claude.ai/code öffnet dies den Claude Code-Bereich Ihrer Einstellungen, anstatt einen Wert zu setzen, und Text nach dem Befehl, einschließlich `key=value`, wird ignoriert. Um eine Einstellung für eine Cloud-Sitzung zu ändern, setzen Sie eine [Umgebungsvariable](/docs/de/cloud-environments#set-environment-variables) in der Umgebung. In einer Sitzung mit einem Repository außerhalb eines [Projekts](/docs/de/claude-projects) committen Sie den Schlüssel stattdessen in die `.claude/settings.json` dieses Repositorys. [Einstellungen in Cloud-Sitzungen](/docs/de/settings#settings-in-cloud-sessions) listet auf, was jede Sitzung liest.

268 268 

269Für Kontextverwaltung speziell:269Für Kontextverwaltung speziell:

270 270 


278 278 

279Um das Auto-Compact-Fenster stattdessen zu ändern, setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars) in Ihren Umgebungsvariablen, oder führen Sie [`/autocompact`](/docs/de/commands#all-commands) mit einer Token-Anzahl in einer Sitzung aus, in der die Variable nicht gesetzt ist.279Um das Auto-Compact-Fenster stattdessen zu ändern, setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars) in Ihren Umgebungsvariablen, oder führen Sie [`/autocompact`](/docs/de/commands#all-commands) mit einer Token-Anzahl in einer Sitzung aus, in der die Variable nicht gesetzt ist.

280 280 

281[Subagents](/docs/de/sub-agents) funktionieren genauso wie lokal. Claude kann sie mit dem Agent-Tool spawnen, um Forschung oder parallele Arbeit in ein separates Kontextfenster auszulagern, um das Hauptgespräch leichter zu halten. Subagents, die in Ihrem Repo's `.claude/agents/` definiert sind, werden automatisch aufgegriffen.281[Subagenten](/docs/de/sub-agents) funktionieren genauso wie lokal. Claude kann sie mit dem Agent-Tool starten, um Recherche oder parallele Arbeit in ein separates Kontextfenster auszulagern und so die Hauptkonversation schlanker zu halten. Außerhalb der Threads eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) werden Subagenten, die in `.claude/agents/` Ihres Repositorys definiert sind, automatisch geladen.

282 282 

283[Agent-Teams](/docs/de/agent-teams) sind standardmäßig deaktiviert, können aber aktiviert werden, indem Sie `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` zu Ihren [Umgebungsvariablen](/docs/de/cloud-environments#set-environment-variables) hinzufügen.283[Agent-Teams](/docs/de/agent-teams) sind standardmäßig deaktiviert, können aber aktiviert werden, indem Sie `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` zu Ihren [Umgebungsvariablen](/docs/de/cloud-environments#set-environment-variables) hinzufügen.

284 284 


428Öffnen Sie die Sitzung erneut über [claude.ai/code](https://claude.ai/code), um eine neue VM bereitzustellen:428Öffnen Sie die Sitzung erneut über [claude.ai/code](https://claude.ai/code), um eine neue VM bereitzustellen:

429 429 

430* **Wiederhergestellt**: Ihr Konversationsverlauf430* **Wiederhergestellt**: Ihr Konversationsverlauf

431* **Nicht wiederhergestellt**: Hintergrundarbeit, die noch lief, als die VM freigegeben wurde, wie Subagenten und Shell-Befehle, sowie das ausstehende Aufwecken eines [selbstgetakteten `/loop`](/docs/de/scheduled-tasks#let-claude-choose-the-interval). Um die Schleife neu zu starten, führen Sie `/loop` erneut aus.431* **Nicht wiederhergestellt**: Hintergrundarbeit, die noch lief oder ausstand, als die VM freigegeben wurde, darunter:

432 * **Shell-Befehle**: Claude Code teilt Claude mit, welche Befehle gestoppt wurden. Bitten Sie Claude, diejenigen erneut auszuführen, die Sie noch benötigen.

433 * **Subagenten**: Claude Code teilt Claude mit, welche Subagenten gestoppt wurden und welche davon [fortgesetzt](/docs/de/sub-agents#resume-subagents) werden können, anstatt neu gestartet zu werden. Bitten Sie Claude, deren Arbeit fortzusetzen.

434 * **Sitzungsbezogene geplante Aufgaben**: Aufgaben, die Sie [in der Sitzung geplant](/docs/de/scheduled-tasks) haben, sowie ein `/loop`, der auf seine nächste Iteration wartet, werden nicht in die erneut geöffnete Sitzung übernommen. Bitten Sie Claude, die Aufgaben erneut zu planen, oder führen Sie `/loop` erneut aus, um die Schleife neu zu starten.

432 435 

433## Einschränkungen436## Einschränkungen

434 437 

Details

175 175 

176| Pfad unter `~/.claude/` | Inhalte |176| Pfad unter `~/.claude/` | Inhalte |

177| - | - |177| - | - |

178| `history.jsonl` | Jeder Prompt, den Sie eingegeben haben, mit Zeitstempel und Projektpfad. Verwendet für Up-Arrow-Abruf, `Ctrl+R` Verlaufssuche und `!` Shell-Befehl-Vervollständigung. Jeder Durchlauf entfernt die Einträge, die älter als `cleanupPeriodDays` sind, wenn die [HIPAA-Konfiguration für Ihre Sitzungen gilt](/docs/de/hipaa-setup#check-how-developers-sign-in-and-connect). |178| `history.jsonl` | Prompts, die Sie eingegeben haben, mit Zeitstempel und Projektpfad. Verwendet für Up-Arrow-Abruf, `Ctrl+R` Verlaufssuche und `!` Shell-Befehl-Vervollständigung. Jeder Durchlauf entfernt die Einträge, die älter als `cleanupPeriodDays` sind, wenn die [HIPAA-Konfiguration für Ihre Sitzungen gilt](/docs/de/hipaa-setup#check-how-developers-sign-in-and-connect). |

179| `stats-cache.json` | Aggregierte Token- und Kostenzählungen, die von `/usage` angezeigt werden |179| `stats-cache.json` | Aggregierte Token- und Kostenzählungen, die von `/usage` angezeigt werden |

180| `remote-settings.json` | Zwischengespeicherte Kopie von [servergesteuerten Einstellungen](/docs/de/server-managed-settings) für Ihre Organisation, oder `{}` wenn Ihre Organisation keine konfiguriert hat. Nur vorhanden, wenn die Sitzung sie [abruft](/docs/de/server-managed-settings#platform-availability). Claude Code prüft beim Start und stündlich während einer Sitzung auf Updates. Claude Code löscht es beim Abmelden. |180| `remote-settings.json` | Zwischengespeicherte Kopie von [servergesteuerten Einstellungen](/docs/de/server-managed-settings) für Ihre Organisation, oder `{}` wenn Ihre Organisation keine konfiguriert hat. Nur vorhanden, wenn die Sitzung sie [abruft](/docs/de/server-managed-settings#platform-availability). Claude Code prüft beim Start und stündlich während einer Sitzung auf Updates. Claude Code löscht es beim Abmelden. |

181| `cache/changelog.md` | Zwischengespeicherte Kopie des Claude Code Änderungsprotokolls, angezeigt von `/release-notes`. Im Hintergrund aktualisiert. |181| `cache/changelog.md` | Zwischengespeicherte Kopie des Claude Code Änderungsprotokolls, angezeigt von `/release-notes`. Im Hintergrund aktualisiert. |

claude-projects.md +23 −27

Details

52* **Threads**: die ausführenden Einheiten. Jeder Thread ist eine separate Sitzung mit eigenem Kontextfenster, die ein Arbeitspaket erledigt und nach Abschluss an die Konversation zurückmeldet. Ein Cloud-Thread arbeitet auf einem eigenen Branch und öffnet einen Pull Request, wenn die Arbeit dies erfordert.52* **Threads**: die ausführenden Einheiten. Jeder Thread ist eine separate Sitzung mit eigenem Kontextfenster, die ein Arbeitspaket erledigt und nach Abschluss an die Konversation zurückmeldet. Ein Cloud-Thread arbeitet auf einem eigenen Branch und öffnet einen Pull Request, wenn die Arbeit dies erfordert.

53* **Womit jeder Cloud-Thread startet**:53* **Womit jeder Cloud-Thread startet**:

54 * Die Repositorys und Dateien des Projekts sowie seine [Anweisungen und sein Memory](#give-a-project-standing-context)54 * Die Repositorys und Dateien des Projekts sowie seine [Anweisungen und sein Memory](#give-a-project-standing-context)

55 * Die `CLAUDE.md` und Skills in [jedem Repository des Projekts](#what-threads-pick-up-from-your-repositories) und in einem Projekt mit nur einem Repository zusätzlich die Berechtigungsregeln und Hooks dieses Repositorys55 * Die `CLAUDE.md` in [jedem Repository des Projekts](#what-threads-pick-up-from-your-repositories), jedoch nicht die Skills, `.claude/settings.json` oder `.mcp.json` der Repositorys

56 * Die [Konnektoren](#get-skills-plugins-connectors-and-tools-into-threads) in Ihrem claude.ai-Konto56 * Die [Konnektoren](#get-skills-plugins-connectors-and-tools-into-threads) in Ihrem claude.ai-Konto

57 * Eine [Cloud-Umgebung](#choose-an-environment-for-threads), die Netzwerkzugriff, Umgebungsvariablen, Netzwerk-Secrets und installierte Tools festlegt57 * Eine [Cloud-Umgebung](#choose-an-environment-for-threads), die Netzwerkzugriff, Umgebungsvariablen, Netzwerk-Secrets und installierte Tools festlegt

58* **Der Bereich Overview**: Hier [sehen Sie alle Threads auf einen Blick](#see-what-needs-you-in-overview) und welche davon auf Sie warten. Die weiteren Tabs sind **Library** für die von Ihnen hinzugefügten und die von Threads erzeugten Dateien, **Pull requests** für die von Threads geöffneten Pull Requests und **Scheduled tasks** für geplante Arbeit im Projekt.58* **Der Bereich Overview**: Hier [sehen Sie alle Threads auf einen Blick](#see-what-needs-you-in-overview) und welche davon auf Sie warten. Die weiteren Tabs sind **Library** für die von Ihnen hinzugefügten und die von Threads erzeugten Dateien, **Pull requests** für die von Threads geöffneten Pull Requests und **Scheduled tasks** für geplante Arbeit im Projekt.


239 239 

240Threads laufen im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), wenn das Modell des Threads dies unterstützt, sodass die meisten Tool-Aufrufe ohne Nachfrage ausgeführt werden. Wenn ein Thread Ihre Genehmigung benötigt, befindet sich die Aufforderung in diesem Thread und der Thread wartet, bis Sie dort antworten. Claude in der Projektkonversation zu sagen, dass er fortfahren soll, erreicht ihn nicht.240Threads laufen im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), wenn das Modell des Threads dies unterstützt, sodass die meisten Tool-Aufrufe ohne Nachfrage ausgeführt werden. Wenn ein Thread Ihre Genehmigung benötigt, befindet sich die Aufforderung in diesem Thread und der Thread wartet, bis Sie dort antworten. Claude in der Projektkonversation zu sagen, dass er fortfahren soll, erreicht ihn nicht.

241 241 

242Jede Genehmigung deckt diese Abfrage oder den Rest dieses Threads ab, wenn Sie die breitere Option wählen.242Jede Genehmigung deckt diese Abfrage oder den Rest dieses Threads ab, wenn Sie die breitere Option wählen. Cloud-Threads lesen keine [Berechtigungsregeln](/docs/de/permissions) aus der `.claude/settings.json` eines Repositorys, daher verlassen Sie sich auf den Auto-Modus und auf die Genehmigungen, die Sie in jedem Thread geben.

243 

244Um jeden Thread bestimmte Befehle ohne Nachfrage ausführen zu lassen, oder um einige zu blockieren, fügen Sie [Berechtigungsregeln](/docs/de/permissions) zur `.claude/settings.json` des Repositorys hinzu. Prüfen Sie, ob Cloud-Threads in Ihrem Projekt sie anwenden:

245 

246* **Ein Repository**: Cloud-Threads wenden die Regeln an. Siehe [Was Threads aus Ihren Repositorys aufgreifen](#what-threads-pick-up-from-your-repositories).

247* **Mehrere Repositorys, von Anthropic gehostete Umgebung**: Die Berechtigungsregeln keines Repositorys erreichen einen Cloud-Thread, daher verlassen Sie sich auf den Auto-Modus und auf die Genehmigungen, die Sie in jedem Thread geben.

248* **Mehrere Repositorys, selbst gehostete Umgebung**: siehe [welche Repository-Einstellungen gelten](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).

249 243 

250### Führen Sie einen Thread auf Ihrem eigenen Computer aus244### Führen Sie einen Thread auf Ihrem eigenen Computer aus

251 245 


301Zum Beispiel:295Zum Beispiel:

302 296 

303```text theme={null}297```text theme={null}

304Dieses Projekt hält die p95-Latenz für die Payments-API unter 200 ms: Profiling, Abfrage- und Caching-Fixes und die Abhängigkeits-Upgrades, die damit einhergehen, im payments-api-Repository.298This project holds p95 latency for the payments API under 200 ms: profiling, query and caching fixes, and the dependency upgrades that come with them, in the payments-api repository.

305 299 

306- Branch von main und öffnen Sie einen Draft-Pull-Request pro Thread.300- Branch from main and open one draft pull request per thread.

307- Bevor Sie die Arbeit für erledigt erklären, führen Sie `make test` und `make lint` aus und fügen Sie die Zusammenfassungszeilen in Ihre abschließende Nachricht ein.301- Before you call work done, run `make test` and `make lint` and paste the summary lines in your final message.

308- Wenn Sie etwas nicht erreichen können, das Sie benötigen, wie ein Repository, ein Secret, eine API oder einen Konnektor, sagen Sie in Ihrer ersten Nachricht genau, was fehlt, und stoppen Sie. Ersetzen Sie nicht, mocken Sie nicht und raten Sie nicht.302- If you can't reach something you need, such as a repository, a secret, an API, or a connector, say exactly what's missing in your first message and stop. Don't substitute, mock, or guess.

309- Führen Sie keine Merges durch, erzwingen Sie keine Pushes und ändern Sie die CI-Konfiguration nicht, ohne mich im Thread zu fragen.303- Don't merge, force-push, or change CI configuration without asking me in the thread.

310```304```

311 305 

312Regeln zu einem Repository, wie seine Build-Befehle, gehören in die `CLAUDE.md` dieses Repositorys, die jeder Cloud-Thread liest, wenn das Repository Teil des Projekts ist. Sobald die Arbeit im Gange ist, wenn Sie einen Thread korrigieren, sagen Sie Claude auch, dass er sich die Korrektur merken soll: Sie geht in das [Projektgedächtnis](#give-a-project-standing-context), und spätere Cloud-Threads beginnen damit.306Regeln zu einem Repository, wie seine Build-Befehle, gehören in die `CLAUDE.md` dieses Repositorys, die jeder Cloud-Thread liest, wenn das Repository Teil des Projekts ist. Sobald die Arbeit im Gange ist, wenn Sie einen Thread korrigieren, sagen Sie Claude auch, dass er sich die Korrektur merken soll: Sie geht in das [Projektgedächtnis](#give-a-project-standing-context), und spätere Cloud-Threads beginnen damit.

313 307 

314### Entscheiden Sie, welche Repositories hinzugefügt werden sollen308### Entscheiden Sie, welche Repositories hinzugefügt werden sollen

315 309 

316Die Repositories, die Sie zu einem Projekt hinzufügen, bringen alles mit, was sie enthalten, ihren Code, `CLAUDE.md` und Skills, in jeden Cloud-Thread. Repositories, die Sie nicht hinzufügen, sind immer noch erreichbar: Ein Cloud-Thread kann eines zu sich selbst hinzufügen, wenn seine Aufgabe es benötigt. Die meisten Projekte verwenden beides:310Die Repositories, die Sie zu einem Projekt hinzufügen, bringen ihren Code und ihre `CLAUDE.md` in jeden Cloud-Thread mit, aber [nicht ihre Skills, `.claude/settings.json` oder `.mcp.json`](#what-threads-pick-up-from-your-repositories). Repositories, die Sie nicht hinzufügen, sind immer noch erreichbar: Ein Cloud-Thread kann eines zu sich selbst hinzufügen, wenn seine Aufgabe es benötigt. Die meisten Projekte verwenden beides:

317 311 

318* **Fügen Sie es zum Projekt hinzu**, im Dialog **Neues Projekt**, in **Projekteinstellungen > Umgebung**, oder bitten Sie Claude in der Konversation, es zum Projekt hinzuzufügen. Jeder Cloud-Thread klont es von da an und startet mit seiner `CLAUDE.md` und seinen Skills geladen, unabhängig davon, ob die Aufgabe es berührt. Der Wechsel von einem Repository zu mehreren ändert auch, was Threads aus der `.claude/settings.json` jedes Repositorys aufgreifen; siehe [Was Threads aus Ihren Repositories aufgreifen](#what-threads-pick-up-from-your-repositories).312* **Fügen Sie es zum Projekt hinzu**, im Dialog **Neues Projekt**, in **Projekteinstellungen > Umgebung**, oder bitten Sie Claude in der Konversation, es zum Projekt hinzuzufügen. Jeder Cloud-Thread klont es von da an und startet mit seiner geladenen `CLAUDE.md`, unabhängig davon, ob die Aufgabe es berührt.

319* **Lassen Sie es weg und lassen Sie Threads es hinzufügen, wenn nötig.** Ein Cloud-Thread, dessen Aufgabe ein Repository benötigt, das das Projekt nicht hat, kann es zu sich selbst hinzufügen, und eine Notiz im Thread sagt, dass es nur zu diesem Thread hinzugefügt wurde. Der Klon findet mitten in der Aufgabe statt, also waren die `CLAUDE.md` und Skills dieses Repositorys nicht vorhanden, als der Thread startete. Der nächste Thread startet ohne es. Ein auf diese Weise hinzugefügtes Repository benötigt dieselben [Voraussetzungen](#check-the-prerequisites) wie ein Projekt-Repository: die darauf installierte Claude GitHub App und Push-Zugriff über Ihr GitHub-Konto.313* **Lassen Sie es weg und lassen Sie Threads es hinzufügen, wenn nötig.** Ein Cloud-Thread, dessen Aufgabe ein Repository benötigt, das das Projekt nicht hat, kann es zu sich selbst hinzufügen, und eine Notiz im Thread sagt, dass es nur zu diesem Thread hinzugefügt wurde. Der Klon findet mitten in der Aufgabe statt, also war die `CLAUDE.md` dieses Repositorys nicht vorhanden, als der Thread startete. Der nächste Thread startet ohne es. Ein auf diese Weise hinzugefügtes Repository benötigt dieselben [Voraussetzungen](#check-the-prerequisites) wie ein Projekt-Repository: die darauf installierte Claude GitHub App und Push-Zugriff über Ihr GitHub-Konto.

320 314 

321Ein Projekt benötigt überhaupt kein Repository. Seine Cloud-Threads können immer noch recherchieren, Dokumente schreiben und Code in ihrer eigenen Sandbox schreiben und ausführen, und sie liefern Dateien auf der Registerkarte **Bibliothek** ab. Jeder seiner Cloud-Threads kann trotzdem ein Repository zu sich selbst hinzufügen, wenn eine Aufgabe eines erfordert.315Ein Projekt benötigt überhaupt kein Repository. Seine Cloud-Threads können immer noch recherchieren, Dokumente schreiben und Code in ihrer eigenen Sandbox schreiben und ausführen, und sie liefern Dateien auf der Registerkarte **Bibliothek** ab. Jeder seiner Cloud-Threads kann trotzdem ein Repository zu sich selbst hinzufügen, wenn eine Aufgabe eines erfordert.

322 316 


335 329 

336### Was Threads aus Ihren Repositories aufgreifen330### Was Threads aus Ihren Repositories aufgreifen

337 331 

338Jeder Cloud-Thread klont jedes Repository im Projekt und lädt `CLAUDE.md` und Skills aus allen. Berechtigungsregeln, Hooks und `env` kommen nur aus der `.claude/settings.json` in dem Verzeichnis, in dem der Thread startet.332Cloud-Threads laden die `CLAUDE.md`-Anweisungen jedes Repositorys, aber nicht seine Skills, `.mcp.json`-Server oder `.claude/settings.json`, unabhängig davon, ob das Projekt ein Repository oder mehrere hat.

339 333 

340| In jedem Repository | Ein Repository | Mehrere Repositories |334| In jedem Repository | In einem Cloud-Thread |

341| :- | :- | :- |335| :- | :- |

342| `CLAUDE.md` | Geladen, wenn der Thread startet | Geladen aus jedem Repository, wenn der Thread startet |336| `CLAUDE.md`, `.claude/CLAUDE.md` und `.claude/rules/` im Stammverzeichnis des Repositorys | Aus jedem Repository geladen, wenn der Thread startet. `CLAUDE.md`-Dateien in Unterverzeichnissen und [pfadspezifische Regeln](/docs/de/memory#path-specific-rules) werden nicht geladen |

343| Skills, Agenten und Befehle unter `.claude/` | Geladen | Geladen aus jedem Repository |337| Skills unter `.claude/skills/` | Nicht geladen. Aktivieren Sie den Skill stattdessen für Ihr claude.ai-Konto, wie unter [Bringen Sie Skills, Plugins, Konnektoren und Tools in Threads](#get-skills-plugins-connectors-and-tools-into-threads) beschrieben |

344| Plugins, die in `.claude/settings.json` aktiviert sind | Nicht geladen. Fügen Sie das Plugin stattdessen in **Projekteinstellungen > Plugins** hinzu | Nicht geladen. Fügen Sie das Plugin stattdessen in **Projekteinstellungen > Plugins** hinzu |338| Agenten und Befehle unter `.claude/` | Nicht geladen. Um sie zu verwenden, [führen Sie den Thread auf Ihrem eigenen Computer aus](#run-a-thread-on-your-own-computer) |

345| Berechtigungsregeln, Hooks und `env`, die in `.claude/settings.json` definiert sind | Gelten für den Thread, außer den `env`-Schlüsseln, die [keine Cloud-Sitzung berücksichtigt](/docs/de/cloud-environments#what-carries-over-from-your-setup) | Gelten nicht in einer von Anthropic gehosteten Umgebung. Für eine selbst gehostete Umgebung siehe [welche Repository-Einstellungen gelten](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories) |339| MCP-Server in `.mcp.json` | Nicht geladen. Verwenden Sie stattdessen die Konnektoren in Ihrem claude.ai-Konto, wie unter [Bringen Sie Skills, Plugins, Konnektoren und Tools in Threads](#get-skills-plugins-connectors-and-tools-into-threads) beschrieben |

346 340| Plugins, die in `.claude/settings.json` aktiviert sind | Nicht geladen. Fügen Sie das Plugin stattdessen in **Projekteinstellungen > Plugins** hinzu |

347Legen Sie in einem Projekt mit mehreren Repositories stehende Regeln in Projektanweisungen fest und geben Sie Threads Umgebungsvariablen über die [Cloud-Umgebung](#choose-an-environment-for-threads).341| Berechtigungsregeln in `.claude/settings.json` | Werden nicht angewendet. Genehmigen Sie Tool-Aufrufe im Thread, wie unter [Einen Thread freigeben, der auf eine Genehmigung wartet](#unblock-a-thread-waiting-on-approval) beschrieben, oder [führen Sie den Thread auf Ihrem eigenen Computer aus](#run-a-thread-on-your-own-computer) |

342| Hooks in `.claude/settings.json` | Werden nicht ausgeführt. Um Ihre Hooks zu verwenden, [führen Sie den Thread auf Ihrem eigenen Computer aus](#run-a-thread-on-your-own-computer) |

343| `env` in `.claude/settings.json` | Wird nicht angewendet. Setzen Sie Umgebungsvariablen in der [Cloud-Umgebung](#choose-an-environment-for-threads) |

348 344 

349### Wählen Sie eine Umgebung für Threads345### Wählen Sie eine Umgebung für Threads

350 346 


356 352 

357Cloud-Threads haben nicht die Skills, MCP-Server, Plugins und Tools, die nur auf Ihrem Computer installiert sind. Ein Thread, den Claude auf Ihrem Computer über [Remote Control](/docs/de/remote-control) ausführt, verwendet das, was dort installiert ist. Um jedes dieser Elemente für Cloud-Threads verfügbar zu machen:353Cloud-Threads haben nicht die Skills, MCP-Server, Plugins und Tools, die nur auf Ihrem Computer installiert sind. Ein Thread, den Claude auf Ihrem Computer über [Remote Control](/docs/de/remote-control) ausführt, verwendet das, was dort installiert ist. Um jedes dieser Elemente für Cloud-Threads verfügbar zu machen:

358 354 

359* Skills, Subagenten und Befehle: Committen Sie sie in ein Repository, das Sie zum Projekt hinzugefügt haben, zum Beispiel einen Skill unter `.claude/skills/<skill-name>/SKILL.md`. Jeder Cloud-Thread klont jedes Repository im Projekt und lädt `.claude/skills/`, `.claude/agents/` und `.claude/commands/` aus jedem davon, also ist ein Skill, der in ein Repository committet wird, in jedem Cloud-Thread verfügbar. Cloud-Threads laden auch die [Skills, die Sie für Ihr claude.ai-Konto aktivieren](/docs/de/skills#skills-in-cowork-and-cloud-sessions).355* Skills: Aktivieren Sie sie für Ihr claude.ai-Konto, und Cloud-Threads laden die [Skills, die Sie dort aktivieren](/docs/de/skills#skills-in-cowork-and-cloud-sessions), abgesehen von [einigen Threads in einer selbst gehosteten Umgebung](/docs/de/self-hosted-environments-configuration#how-each-session’s-config-is-assembled). Skills, die in `.claude/skills/` eines Repositorys committet sind, werden in Cloud-Threads nicht geladen.

360* Plugins: Fügen Sie sie in **Projekteinstellungen > Plugins** hinzu; sie werden in jeden neuen Cloud-Thread geladen. Plugins, die ein Repository in seiner `.claude/settings.json` deklariert, [werden nicht in Cloud-Threads geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).356* Plugins: Fügen Sie sie in **Projekteinstellungen > Plugins** hinzu; sie werden in jeden neuen Cloud-Thread geladen. Plugins, die ein Repository in seiner `.claude/settings.json` deklariert, [werden nicht in Cloud-Threads geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).

361* MCP-Server: Cloud-Threads erhalten ihre MCP-Tools von den Konnektoren in Ihrem claude.ai-Konto, also MCP-Servern, die Sie einmal unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) verbinden. Jeder Cloud-Thread kann alle ohne projektspezifische Einrichtung verwenden. Die Projektkonversation selbst hat keine Konnektoren, also senden Sie Arbeit, die einen benötigt, als Aufgabe für einen Cloud-Thread. In einem Projekt mit einem Repository laden Cloud-Threads auch MCP-Server aus der [`.mcp.json`](/docs/de/cloud-environments#what-carries-over-from-your-setup) dieses Repositorys. [Wie Konnektoren Claude Code erreichen](/docs/de/mcp#how-connectors-reach-claude-code) listet die Regeln für Cloud-Sitzungen und die Einstellungen auf, die Konnektoren ausschalten.357* MCP-Server: Cloud-Threads erhalten ihre MCP-Tools von den Konnektoren in Ihrem claude.ai-Konto, also MCP-Servern, die Sie einmal unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) verbinden. Jeder Cloud-Thread kann alle ohne projektspezifische Einrichtung verwenden. Die Projektkonversation selbst hat keine Konnektoren, also senden Sie Arbeit, die einen benötigt, als Aufgabe für einen Cloud-Thread. [Wie Konnektoren Claude Code erreichen](/docs/de/mcp#how-connectors-reach-claude-code) listet die Regeln für Cloud-Sitzungen und die Einstellungen auf, die Konnektoren ausschalten.

362* Befehlszeilen-Tools und Pakete: Installieren Sie sie im [Setup-Skript](/docs/de/cloud-environments#setup-scripts) der Umgebung.358* Befehlszeilen-Tools und Pakete: Installieren Sie sie im [Setup-Skript](/docs/de/cloud-environments#setup-scripts) der Umgebung.

363 359 

364Um zu sehen, welche Konnektoren ein laufender Cloud-Thread unter claude.ai/code hat, öffnen Sie den Thread und wählen Sie **Connectors** aus dem Menü **+** neben seinem Nachrichtenfeld. Das Ausschalten eines Konnektors dort entfernt ihn aus diesem Thread und speichert das als Ihren Kontostandard, sodass neue Threads und claude.ai-Chats ohne ihn starten, bis Sie ihn wieder einschalten. Ein Cloud-Thread übernimmt einen Konnektor, den Sie hinzufügen oder erneut verbinden, nach der nächsten Nachricht, die Sie ihm senden.360Um zu sehen, welche Konnektoren ein laufender Cloud-Thread unter claude.ai/code hat, öffnen Sie den Thread und wählen Sie **Connectors** aus dem Menü **+** neben seinem Nachrichtenfeld. Das Ausschalten eines Konnektors dort entfernt ihn aus diesem Thread und speichert das als Ihren Kontostandard, sodass neue Threads und claude.ai-Chats ohne ihn starten, bis Sie ihn wieder einschalten. Ein Cloud-Thread übernimmt einen Konnektor, den Sie hinzufügen oder erneut verbinden, nach der nächsten Nachricht, die Sie ihm senden.

Details

8 8 

9Das Claude Security Plugin führt einen Multi-Agent-Sicherheitslückenscan Ihrer Codebasis innerhalb einer Claude Code-Sitzung durch. Ein Team von Claude-Agenten kartiert Ihre Architektur, erstellt ein Bedrohungsmodell, sucht nach Sicherheitslücken und überprüft unabhängig jeden Fund, bevor der Bericht geschrieben wird. Verwenden Sie das Plugin, um ein ganzes Repository zu scannen oder [nur einen Satz von Änderungen](#scan-only-your-changes), wie das Diff eines Branches, das Diff eines Pull Requests oder einen einzelnen Commit, und wandeln Sie dann die Erkenntnisse Ihrer Wahl in Patches um, die Sie selbst überprüfen und anwenden.9Das Claude Security Plugin führt einen Multi-Agent-Sicherheitslückenscan Ihrer Codebasis innerhalb einer Claude Code-Sitzung durch. Ein Team von Claude-Agenten kartiert Ihre Architektur, erstellt ein Bedrohungsmodell, sucht nach Sicherheitslücken und überprüft unabhängig jeden Fund, bevor der Bericht geschrieben wird. Verwenden Sie das Plugin, um ein ganzes Repository zu scannen oder [nur einen Satz von Änderungen](#scan-only-your-changes), wie das Diff eines Branches, das Diff eines Pull Requests oder einen einzelnen Commit, und wandeln Sie dann die Erkenntnisse Ihrer Wahl in Patches um, die Sie selbst überprüfen und anwenden.

10 10 

11Das Plugin wird lokal in Ihrer Sitzung ausgeführt, verwendet [die Modelle, auf die Sie in Claude Code Zugriff haben](#models-and-providers), und jeder Scan wird auf Ihre [Nutzung](/docs/de/costs) angerechnet. Wenn Sie einen verwalteten Service möchten, der Ihre Repositories überwacht, oder Scans auf [Claude Mythos](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) ausführen möchten, siehe das [Claude Security](https://claude.com/product/claude-security) Produkt, das im Enterprise-Plan verfügbar ist. Das Plugin erreicht Code, den das verwaltete Produkt nicht erreichen kann, wie Repositories, die auf GitLab oder Bitbucket gehostet werden, oder auf Netzwerken, die keine eingehenden Verbindungen zulassen.11Das Plugin wird lokal in Ihrer Sitzung ausgeführt, verwendet [die Modelle, auf die Sie in Claude Code Zugriff haben](#models-and-providers), und jeder Scan wird auf Ihre [Nutzung](/docs/de/costs) angerechnet. Wenn Sie einen verwalteten Service möchten, der Ihre Repositorys überwacht, oder Scans auf [Claude Mythos](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) ausführen möchten, siehe das [Claude Security](https://claude.com/product/claude-security) Produkt, das im Enterprise-Plan verfügbar ist.

12 12 

13Das Plugin unterscheidet sich auch von den Überprüfungswerkzeugen, die bereits in Claude Code vorhanden sind: Das [Security Guidance Plugin](/docs/de/security-guidance) überprüft Code, während Claude ihn schreibt, [`/security-review`](/docs/de/commands#all-commands) führt einen einzelnen Durchgang über Ihren Branch durch, und [Code Review](/docs/de/code-review) überprüft Pull Requests. Wie die Ebenen zusammenpassen, siehe [Wie das Plugin mit anderen Sicherheitswerkzeugen passt](#how-the-plugin-fits-with-other-security-tools).13Das Plugin unterscheidet sich auch von den Überprüfungswerkzeugen, die bereits in Claude Code vorhanden sind: Das [Security Guidance Plugin](/docs/de/security-guidance) überprüft Code, während Claude ihn schreibt, [`/security-review`](/docs/de/commands#all-commands) führt einen einzelnen Durchgang über Ihren Branch durch, und [Code Review](/docs/de/code-review) überprüft Pull Requests. Wie die Ebenen zusammenpassen, siehe [Wie das Plugin mit anderen Sicherheitswerkzeugen passt](#how-the-plugin-fits-with-other-security-tools).

14 14 

Details

164 164 

165### Archivieren Sie eine Umgebung165### Archivieren Sie eine Umgebung

166 166 

167Um eine Ihrer eigenen Umgebungen zu archivieren, öffnen Sie sie zur Bearbeitung, wählen Sie **Umgebung archivieren** und bestätigen Sie. Wenn die Umgebung [mit Ihrer Organisation geteilt](#organization-shared-environments) ist, archiviert stattdessen ein Owner sie über die Seite **Cloud-Umgebungen** in den [Admin-Einstellungen](https://claude.ai/admin-settings). Wenden Sie sich daher an einen Owner, sofern Sie nicht selbst einer sind. Sie können eine Umgebung nicht löschen, nur archivieren.167Um eine Ihrer eigenen Umgebungen zu archivieren, öffnen Sie sie zur Bearbeitung, wählen Sie **Umgebung archivieren** und bestätigen Sie. Wenn die Umgebung [mit Ihrer Organisation geteilt](#organization-shared-environments) ist, archiviert stattdessen ein Owner sie über die Seite **Cloud-Umgebungen** in den [Admin-Einstellungen](https://claude.ai/admin-settings). Wenden Sie sich daher an einen Owner, sofern Sie nicht selbst einer sind.

168 168 

169Das Archivieren wirkt sich auf neue Sitzungen aus, nicht auf laufende:169Das Archivieren wirkt sich auf neue Sitzungen aus, nicht auf laufende:

170 170 


175 * **Gespeicherter CLI-Standard**: Wenn die Umgebung Ihr gespeicherter [CLI-Standard](#select-an-environment-from-the-cli) war, startet Claude Code CLI-Cloud-Sitzungen in der von Anthropic gehosteten Umgebung, wenn Ihre Liste eine hat. Andernfalls startet es sie in der ersten Umgebung in Ihrer Liste, die keine [Remote-Control-Bridge-Umgebung](#the-default-environment) ist.175 * **Gespeicherter CLI-Standard**: Wenn die Umgebung Ihr gespeicherter [CLI-Standard](#select-an-environment-from-the-cli) war, startet Claude Code CLI-Cloud-Sitzungen in der von Anthropic gehosteten Umgebung, wenn Ihre Liste eine hat. Andernfalls startet es sie in der ersten Umgebung in Ihrer Liste, die keine [Remote-Control-Bridge-Umgebung](#the-default-environment) ist.

176 * **Explizit konfiguriert**: Alles, das explizit mit der Umgebung konfiguriert ist, wie eine [geplante Cloud-Aufgabe](/docs/de/routines#environments-and-network-access), kann keine neuen Sitzungen darin starten. Zeigen Sie es auf eine andere Umgebung.176 * **Explizit konfiguriert**: Alles, das explizit mit der Umgebung konfiguriert ist, wie eine [geplante Cloud-Aufgabe](/docs/de/routines#environments-and-network-access), kann keine neuen Sitzungen darin starten. Zeigen Sie es auf eine andere Umgebung.

177 177 

178Wenn Sie eine von Anthropic gehostete Umgebung nicht mehr benötigen, archivieren Sie sie. Weder der Umgebungsdialog noch die Admin-Seite **Cloud-Umgebungen** bietet eine Option zum Löschen einer von Anthropic gehosteten Umgebung. Wenn die Umgebung [selbst gehostet](/docs/de/self-hosted-environments) ist, kann ein Owner sie über die Seite **Cloud-Umgebungen** in den Admin-Einstellungen löschen. Wenn Sie kein Owner sind, bitten Sie einen Owner, sie zu löschen.

179 

178### Gemeinsame Organisationsumgebungen180### Gemeinsame Organisationsumgebungen

179 181 

180In Team- und Enterprise-Plänen kann ein Owner Cloud-Umgebungen erstellen, die mit jedem Mitglied der Organisation geteilt werden. Dieselbe Rolle verwaltet alles andere auf der Seite **Cloud-Umgebungen** in den Admin-Einstellungen, einschließlich [selbst gehosteter Umgebungen](/docs/de/self-hosted-environments); die Admin-Rolle kann die Seite nicht öffnen. Die vollständige Liste der Rollen, die die Seite öffnen können, ist die für [Verwaltung von Server-verwalteten Einstellungen](/docs/de/server-managed-settings#access-control).182In Team- und Enterprise-Plänen kann ein Owner Cloud-Umgebungen erstellen, die mit jedem Mitglied der Organisation geteilt werden. Dieselbe Rolle verwaltet alles andere auf der Seite **Cloud-Umgebungen** in den Admin-Einstellungen, einschließlich [selbst gehosteter Umgebungen](/docs/de/self-hosted-environments); die Admin-Rolle kann die Seite nicht öffnen. Die vollständige Liste der Rollen, die die Seite öffnen können, ist die für [Verwaltung von Server-verwalteten Einstellungen](/docs/de/server-managed-settings#access-control).


275 277 

276### Was wird von Ihrem Setup übernommen278### Was wird von Ihrem Setup übernommen

277 279 

280> [!NOTE]

281>

282> Von der Repository-Konfiguration in dieser Tabelle lädt ein Cloud-Thread in einem [Projekt](/docs/de/claude-projects) nur die `CLAUDE.md`, die `.claude/CLAUDE.md` und die `.claude/rules/`-Dateien aus dem Stammverzeichnis des Repositorys, die nicht [pfadspezifisch](/docs/de/memory#path-specific-rules) sind. Siehe [Was Threads aus Ihren Repositorys übernehmen](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories).

283 

278Cloud-Sitzungen starten aus einem frischen Klon Ihres Repositorys. Alles, das Sie in das Repo committen, ist verfügbar. Alles, das Sie nur auf Ihrem eigenen Computer installiert oder konfiguriert haben, ist nicht in der Sitzung verfügbar. Die Richtlinie Ihrer Organisation kommt separat über [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) an.284Cloud-Sitzungen starten aus einem frischen Klon Ihres Repositorys. Alles, das Sie in das Repo committen, ist verfügbar. Alles, das Sie nur auf Ihrem eigenen Computer installiert oder konfiguriert haben, ist nicht in der Sitzung verfügbar. Die Richtlinie Ihrer Organisation kommt separat über [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) an.

279 285 

280| | Verfügbar in Cloud-Sitzungen | Warum |286| | Verfügbar in Cloud-Sitzungen | Warum |


465 471 

466Wenn Sie SessionStart-Hooks in Ihrer Benutzer-Ebene `~/.claude/settings.json` haben, erwarten Sie diese nicht in der Cloud. Benutzer-Ebene-Einstellungen bleiben auf Ihrem Computer. Welche anderen Hooks ausgeführt werden, hängt davon ab, wo die Sitzung ausgeführt wird:472Wenn Sie SessionStart-Hooks in Ihrer Benutzer-Ebene `~/.claude/settings.json` haben, erwarten Sie diese nicht in der Cloud. Benutzer-Ebene-Einstellungen bleiben auf Ihrem Computer. Welche anderen Hooks ausgeführt werden, hängt davon ab, wo die Sitzung ausgeführt wird:

467 473 

468* **Von Anthropic gehostete Umgebung**: Claude Code führt Hooks aus dem Repository und aus den [servergesteuerten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation aus. [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen erhalten keine servergesteuerten Einstellungen, daher werden Hooks aus servergesteuerten Einstellungen dort nicht ausgeführt.474* **Von Anthropic gehostete Umgebung**: Claude Code führt Hooks aus den [servergesteuerten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation und, außerhalb eines Threads in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories), aus dem Repository aus. [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen erhalten keine servergesteuerten Einstellungen, daher werden Hooks aus servergesteuerten Einstellungen dort nicht ausgeführt.

469* **[Selbst gehostete Umgebung](/docs/de/self-hosted-environments-configuration#permissions-and-tool-approval)**: Claude Code führt auch die Hooks aus, die der Operator aus dem `~/.claude/` des Runner-Hosts gesät hat, und die Hooks in der verwalteten Einstellungsdatei des Runner-Images, wenn diese Datei eine der [verwalteten Quellen ist, die Claude Code anwendet](/docs/de/managed-settings#how-claude-code-combines-managed-sources).475* **[Selbst gehostete Umgebung](/docs/de/self-hosted-environments-configuration#permissions-and-tool-approval)**: Claude Code führt auch die Hooks aus, die der Operator aus dem `~/.claude/` des Runner-Hosts gesät hat, und die Hooks in der verwalteten Einstellungsdatei des Runner-Images, wenn diese Datei eine der [verwalteten Quellen ist, die Claude Code anwendet](/docs/de/managed-settings#how-claude-code-combines-managed-sources).

470 476 

471### Abhängigkeiten mit einem SessionStart-Hook installieren477### Abhängigkeiten mit einem SessionStart-Hook installieren

472 478 

473Um Abhängigkeiten nur in Cloud-Sitzungen zu installieren, kombinieren Sie einen SessionStart-Hook mit einem Skript, das überprüft, wo es ausgeführt wird.479Um Abhängigkeiten nur in Cloud-Sitzungen außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) zu installieren, kombinieren Sie einen SessionStart-Hook mit einem Skript, das überprüft, wo es ausgeführt wird.

474 480 

475Fügen Sie zunächst einen SessionStart-Hook zu Ihrer `.claude/settings.json` des Repositorys hinzu. Diese Konfiguration weist Claude Code an, `scripts/install_pkgs.sh` aus Ihrem Repository auszuführen, wenn eine Sitzung startet oder fortgesetzt wird:481Fügen Sie zunächst einen SessionStart-Hook zu Ihrer `.claude/settings.json` des Repositorys hinzu. Diese Konfiguration weist Claude Code an, `scripts/install_pkgs.sh` aus Ihrem Repository auszuführen, wenn eine Sitzung startet oder fortgesetzt wird:

476 482 


532SessionStart-Hooks verhalten sich in der Cloud genauso wie lokal, mit diesen Vorbehalten:538SessionStart-Hooks verhalten sich in der Cloud genauso wie lokal, mit diesen Vorbehalten:

533 539 

534* **Ein Repository pro Sitzung**: In einer von Anthropic gehosteten Umgebung lädt eine Sitzung mit mehreren Repositorys keine Hooks aus der `.claude/settings.json` eines Repositorys, daher wird ein SessionStart-Hook, den Sie dort definieren, nicht ausgeführt. Installieren Sie Abhängigkeiten für diese Sitzungen stattdessen mit einem [Setup-Skript](#setup-scripts). Für eine selbst gehostete Umgebung siehe [welche Repository-Einstellungen gelten](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).540* **Ein Repository pro Sitzung**: In einer von Anthropic gehosteten Umgebung lädt eine Sitzung mit mehreren Repositorys keine Hooks aus der `.claude/settings.json` eines Repositorys, daher wird ein SessionStart-Hook, den Sie dort definieren, nicht ausgeführt. Installieren Sie Abhängigkeiten für diese Sitzungen stattdessen mit einem [Setup-Skript](#setup-scripts). Für eine selbst gehostete Umgebung siehe [welche Repository-Einstellungen gelten](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).

541* **Nicht in den Cloud-Threads eines Projekts**: Ein Cloud-Thread in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) führt keine Hooks aus der `.claude/settings.json` eines Repositorys aus, unabhängig von der Anzahl der Repositorys. Installieren Sie in einer von Anthropic gehosteten Umgebung Abhängigkeiten für Threads mit einem [Setup-Skript](#setup-scripts). Verwenden Sie in einer selbst gehosteten Umgebung stattdessen einen Hook in den [Einstellungen des Runner-Hosts](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).

535* **Keine Cloud-Only-Scoping**: Hooks werden in lokalen und Cloud-Sitzungen ausgeführt. Um die lokale Ausführung zu überspringen, beenden Sie früh, es sei denn, die Umgebungsvariable `CLAUDE_CODE_REMOTE` ist `true`, wie das [Abhängigkeitsinstallations-Skript](#install-dependencies-with-a-sessionstart-hook) es tut.542* **Keine Cloud-Only-Scoping**: Hooks werden in lokalen und Cloud-Sitzungen ausgeführt. Um die lokale Ausführung zu überspringen, beenden Sie früh, es sei denn, die Umgebungsvariable `CLAUDE_CODE_REMOTE` ist `true`, wie das [Abhängigkeitsinstallations-Skript](#install-dependencies-with-a-sessionstart-hook) es tut.

536* **Erfordert Netzwerkzugriff**: Installationsbefehle müssen Paket-Registries erreichen. Wenn Ihre Umgebung **Keine** Netzwerkzugriff verwendet, schlagen diese Hooks fehl. Die [Standard-Zulassungsliste](#default-allowed-domains) unter **Vertraut** deckt npm, PyPI, RubyGems und crates.io ab.543* **Erfordert Netzwerkzugriff**: Installationsbefehle müssen Paket-Registries erreichen. Wenn Ihre Umgebung **Keine** Netzwerkzugriff verwendet, schlagen diese Hooks fehl. Die [Standard-Zulassungsliste](#default-allowed-domains) unter **Vertraut** deckt npm, PyPI, RubyGems und crates.io ab.

537* **Proxy-Kompatibilität**: In von Anthropic gehosteten Umgebungen wird der gesamte ausgehende Datenverkehr durch einen [Sicherheits-Proxy](#security-proxy) geleitet, und einige Paket-Manager funktionieren nicht korrekt damit; Bun ist ein bekanntes Beispiel. In einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments-deploy#default-deny-egress) wird der ausgehende Datenverkehr stattdessen durch Ihre eigene Netzwerk-Grenze geleitet.544* **Proxy-Kompatibilität**: In von Anthropic gehosteten Umgebungen wird der gesamte ausgehende Datenverkehr durch einen [Sicherheits-Proxy](#security-proxy) geleitet, und einige Paket-Manager funktionieren nicht korrekt damit; Bun ist ein bekanntes Beispiel. In einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments-deploy#default-deny-egress) wird der ausgehende Datenverkehr stattdessen durch Ihre eigene Netzwerk-Grenze geleitet.

Details

92 92 

93Beschränken Sie `REVIEW.md` auf Anweisungen, die das Review-Verhalten ändern, und belassen Sie allgemeinen Projektkontext in `CLAUDE.md`.93Beschränken Sie `REVIEW.md` auf Anweisungen, die das Review-Verhalten ändern, und belassen Sie allgemeinen Projektkontext in `CLAUDE.md`.

94 94 

95### Andere Dateien in REVIEW\.md einbinden

96 

97Sie können Review-Anweisungen auf mehrere Dateien aufteilen und diese in Ihre Stamm-`REVIEW.md` einbinden. Nutzen Sie dies, wenn `REVIEW.md` zu lang wird oder wenn Sie Review-Regeln bereits in einer anderen Datei pflegen.

98 

99Um eine Datei einzubinden, fügen Sie der Stamm-`REVIEW.md` eine Zeile hinzu, die nur `@` und den Dateinamen enthält. Code Review setzt den Inhalt der Datei an die Stelle dieser Zeile, sodass er als Teil von `REVIEW.md` gilt. In diesem Beispiel gibt die Stammdatei eine eigene Anweisung und bindet dann zwei Regeldateien ein:

100 

101```markdown theme={null}

102# Review instructions

103 

104Report at most five Nits per review.

105 

106@review-security.md

107@review-api.md

108```

109 

110Speichern Sie die eingebundenen Dateien im Stammverzeichnis des Repositorys, neben `REVIEW.md`:

111 

112```text theme={null}

113your-repo/

114├── REVIEW.md

115├── review-security.md

116└── review-api.md

117```

118 

119Code Review bindet die Dateien ein, wenn es `REVIEW.md` aus einem geschützten Branch liest. Prüfen Sie daher, [welchen Branch ein Review für Ihr Repository liest](#what-a-review-reads-for-each-branch-setup):

120 

121* **Geschützter Branch**: Code Review setzt die eingebundene Datei an die Stelle ihrer `@`-Zeile

122* **Ungeschützter Standard-Branch**: Die `@`-Zeile bleibt als reiner Text in `REVIEW.md`. Wenn der Pull Request die in der Zeile genannte Datei ändert, wird die Zeile weggelassen.

123 

124Wenn ein Review eine eingebundene Datei nicht anwendet, prüfen Sie jeden dieser Punkte:

125 

126* **Speicherort**: Verschieben Sie die Datei in das Stammverzeichnis des Repositorys. Ein Pfad in ein Unterverzeichnis wie `@docs/review-rules.md` wird nicht eingebunden.

127* **Name**: Geben Sie den Dateinamen exakt an, einschließlich Groß- und Kleinschreibung, und verwenden Sie einen Namen ohne Leerzeichen. Eine Zeile, deren Name keiner Datei neben `REVIEW.md` entspricht, bleibt als reiner Text in `REVIEW.md`, und der Check Run meldet sie nicht als übersprungene Einbindung.

128* **Eine Ebene**: Führen Sie jede Datei in der Stamm-`REVIEW.md` auf. Eine `@`-Zeile in einer eingebundenen Datei oder in einer `REVIEW.md` in einem Unterverzeichnis bleibt reiner Text, und ein Markdown-Link auf eine andere Datei ist keine Einbindung.

129* **Grenzwerte**: Binden Sie höchstens acht verschiedene Dateien ein, und halten Sie `REVIEW.md` und die eingebundenen Dateien zusammen unter 150.000 Bytes. Eine Datei, die das Byte-Limit erreichen würde, wird vollständig übersprungen und nicht gekürzt. Der Check Run meldet, wie viele Einbindungszeilen er aufgrund eines der beiden Grenzwerte übersprungen hat.

130* **Links**: Verwenden Sie in `REVIEW.md` und den eingebundenen Dateien insgesamt höchstens 64 Markdown-Links. Links auf `http`-, `https`- oder `mailto`-Adressen und auf `#`-Anker zählen nicht. Oberhalb dieses Grenzwerts überspringt das Review Ihre gesamte Stamm-`REVIEW.md`, nicht nur die eingebundenen Dateien. Der Check Run [meldet dann, dass die Anweisungen nicht angewendet wurden](/docs/de/code-review-troubleshooting#the-check-run-mentions-review-md).

131* **Gemergte Kopie**: Mergen Sie die eingebundene Datei in den [Branch, aus dem `REVIEW.md` gelesen wird](#which-branch-review-md-is-read-from). Das Review liest beide aus demselben Commit, niemals aus den Änderungen des Pull Requests selbst.

132 

95### Von welchem Branch REVIEW\.md gelesen wird133### Von welchem Branch REVIEW\.md gelesen wird

96 134 

97Code Review liest `REVIEW.md` aus dem Basis-Branch des Pull Requests oder aus dem Standard-Branch, niemals aus den Änderungen des Pull Requests selbst. Um das Review-Verhalten zu ändern, mergen Sie die Änderung an `REVIEW.md` zuerst.135Code Review liest `REVIEW.md` aus dem Basis-Branch des Pull Requests oder aus dem Standard-Branch, niemals aus den Änderungen des Pull Requests selbst. Um das Review-Verhalten zu ändern, mergen Sie die Änderung an `REVIEW.md` zuerst.


117 155 

118| Branch-Schutz | Gelesene Kopie | Gelesene Dateien |156| Branch-Schutz | Gelesene Kopie | Gelesene Dateien |

119| :- | :- | :- |157| :- | :- | :- |

120| Der Standard-Branch ist geschützt, und der Pull Request zielt auf ihn oder auf einen Branch, den kein Ruleset schützt | Standard-Branch | Stammdatei und Dateien in Unterverzeichnissen |158| Der Standard-Branch ist geschützt, und der Pull Request zielt auf ihn oder auf einen Branch, den kein Ruleset schützt | Standard-Branch | Stammdatei, die von ihr eingebundenen Dateien und Dateien in Unterverzeichnissen |

121| Der Pull Request zielt auf einen anderen Branch, den ein Ruleset schützt | Dieser Basis-Branch | Stammdatei und Dateien in Unterverzeichnissen |159| Der Pull Request zielt auf einen anderen Branch, den ein Ruleset schützt | Dieser Basis-Branch | Stammdatei, die von ihr eingebundenen Dateien und Dateien in Unterverzeichnissen |

122| Der Standard-Branch ist nicht geschützt, und der Basis-Branch hat keine Schutzregel der einen oder anderen Art | Standard-Branch | Stammdatei |160| Der Standard-Branch ist nicht geschützt, und der Basis-Branch hat keine Schutzregel der einen oder anderen Art | Standard-Branch | Stammdatei |

123| Code Review kann die Schutzeinstellungen nicht bestätigen. Dazu gehört ein ungeschützter Standard-Branch mit einem Basis-Branch, der nur eine klassische Regel hat | Keine | Keine |161| Code Review kann die Schutzeinstellungen nicht bestätigen. Dazu gehört ein ungeschützter Standard-Branch mit einem Basis-Branch, der nur eine klassische Regel hat | Keine | Keine |

124 162 

Details

55 55 

56### Das Ergebnis aus einem Skript lesen56### Das Ergebnis aus einem Skript lesen

57 57 

58Um einen Merge zu steuern oder eine Zusammenfassung aus Ihrem eigenen CI zu veröffentlichen, parsen Sie die letzte Zeile des Details-Texts mit `gh` und jq. Diese Zeile ist ein maschinenlesbarer Kommentar.58Um einen Merge zu steuern oder eine Zusammenfassung aus Ihrem eigenen CI zu veröffentlichen, parsen Sie die letzte Zeile des Details-Texts mit `gh` und jq. Diese Zeile ist ein HTML-Kommentar, der die Anzahlen pro Schweregrad als JSON enthält:

59 

60```text theme={null}

61<!-- bughunter-severity: {"nit":1,"normal":2,"pre_existing":0} -->

62```

63 

64Die Zeilen darüber können Dateinamen aus dem Pull Request enthalten. Wenn Sie den Text auf eigene Weise parsen, entnehmen Sie die Anzahlen nur der letzten Zeile, wie es der Befehl in diesen Schritten tut.

59 65 

60**1. Die Check-Run-ID ermitteln**66**1. Die Check-Run-ID ermitteln**

61 67 


67 73 

68**2. Die Anzahl pro Schweregrad lesen**74**2. Die Anzahl pro Schweregrad lesen**

69 75 

70Lesen Sie die Anzahlen aus diesem Check Run und ersetzen Sie dabei `CHECK_RUN_ID` durch die ID:76Lesen Sie die Anzahlen aus dem Feld `output.text` des Check Runs, das den Details-Text enthält. Ersetzen Sie `CHECK_RUN_ID` durch die ID:

71 77 

72```bash theme={null}78```bash theme={null}

73gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \79gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID --jq '

74 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'80 (.output.text | split("\n") | last

81 | scan("^<!-- bughunter-severity: (.*) -->$")[0] | fromjson)?

82 // error("no severity line")'

75```83```

76 84 

77Dies gibt ein JSON-Objekt mit einer Anzahl pro Schweregrad aus, dessen Schlüssel alphabetisch sortiert sind, zum Beispiel `{"nit": 1, "normal": 2, "pre_existing": 0}`. Die Anzahlen enthalten Ergebnisse aus früheren Reviews des Pull Requests, deren Threads noch offen sind.85Dies gibt ein JSON-Objekt mit einer Anzahl pro Schweregrad aus, dessen Schlüssel alphabetisch sortiert sind, zum Beispiel `{"nit": 1, "normal": 2, "pre_existing": 0}`. Die Anzahlen enthalten Ergebnisse aus früheren Reviews des Pull Requests, deren Threads noch offen sind.


80 88 

81Lassen Sie Ihr Skript diese Fälle behandeln:89Lassen Sie Ihr Skript diese Fälle behandeln:

82 90 

83* **`normal` ist größer als null**: Lassen Sie den Job fehlschlagen, wenn Sie den Merge steuern möchten. Der Schlüssel `normal` enthält die Anzahl der Important-Ergebnisse, Claude hat also mindestens einen Fehler gefunden, der vor dem Merge behoben werden sollte.91* **`normal` ist größer als null**: Lassen Sie den Job fehlschlagen, wenn Sie den Merge steuern möchten. Der Schlüssel `normal` enthält die Anzahl der Important-Ergebnisse, Claude hat also mindestens einen Fehler gefunden, der vor dem Merge behoben werden sollte. Um nur diese Anzahl auszugeben, fügen Sie `| .normal` vor dem schließenden einfachen Anführungszeichen ein.

84* **Die Zeile fehlt**: Behandeln Sie dies als fehlendes Urteil und nicht als null Ergebnisse. Ein Check Run für ein Review, das fehlgeschlagen ist, eine Zeitüberschreitung hatte, abgebrochen oder durch ein neueres ersetzt wurde, hat keine solche Zeile, und auch manche abgeschlossene Reviews haben keine.92* **Die Zeile fehlt**: Der Befehl gibt statt der Anzahlen einen Fehler aus, der `no severity line` enthält, und endet mit einem Exit-Status ungleich null. Behandeln Sie dies als fehlendes Urteil und nicht als null Ergebnisse. Ein Check Run für ein Review, das fehlgeschlagen ist, eine Zeitüberschreitung hatte, abgebrochen oder durch ein neueres ersetzt wurde, hat keine solche Zeile, und auch manche abgeschlossene Reviews haben keine.

85 93 

86## Ein Review anfordern94## Ein Review anfordern

87 95 


99 107 

100| Befehl | Was er bewirkt | Wann Sie ihn verwenden |108| Befehl | Was er bewirkt | Wann Sie ihn verwenden |

101| :- | :- | :- |109| :- | :- | :- |

102| `@claude review` | Startet ein einzelnes Review, ohne den PR für künftige Pushes zu abonnieren | Sie möchten jetzt ein Review, etwa bei einem Pull Request in einem Repository mit der Einstellung Manual, oder in den anderen Modi sofort ein weiteres Review |110| `@claude review` | Startet ein einzelnes Review, ohne den PR für künftige Pushes zu abonnieren | Sie möchten jetzt ein Review, etwa bei einem Pull Request in einem Repository mit der Einstellung **Manual**, oder in den anderen Modi sofort ein weiteres Review |

103| `@claude review always` | Startet ein Review und abonniert den PR künftig für durch Pushes ausgelöste Reviews | Sie möchten, dass jeder nachfolgende Push ein neues Review startet, etwa bei einem PR mit hoher Priorität in einem Repository mit der Einstellung Manual |111| `@claude review always` | Startet ein Review und abonniert den PR künftig für durch Pushes ausgelöste Reviews | Sie möchten, dass jeder nachfolgende Push ein neues Review startet, etwa bei einem PR mit hoher Priorität in einem Repository mit der Einstellung **Manual** |

104| `@claude review once` | Wie `@claude review`: startet ein einzelnes Review ohne Abonnement | Dieselben Fälle wie bei `@claude review` |112| `@claude review once` | Wie `@claude review`: startet ein einzelnes Review ohne Abonnement | Dieselben Fälle wie bei `@claude review` |

113| `@claude review stop` | Beendet das Abonnement des PR für durch Pushes ausgelöste Reviews, ohne ein Review zu starten oder ein bereits eingereihtes oder laufendes abzubrechen. Claude antwortet mit einem Kommentar statt mit einem Check Run. | Sie haben einen PR mit `@claude review always` in einem Repository mit der Einstellung **Manual** oder **Once after PR creation** abonniert und möchten nicht mehr, dass jeder Push ein Review startet |

114| `@claude review off` oder `@claude review pause` | Wie `@claude review stop` | Dieselben Fälle wie bei `@claude review stop` |

115 

116In einem Repository mit der Einstellung **After every push** können Sie Reviews nicht mit einem Kommentar stoppen, da Pushes dort Reviews mit oder ohne Abonnement starten. Um zu verhindern, dass Pushes dort Reviews für einen einzelnen Pull Request starten, wandeln Sie ihn in einen [Entwurf](#review-drafts-and-pull-requests-from-forks) um. Wenn Sie ihn wieder als bereit für das Review markieren, startet ein Review.

105 117 

106Damit einer dieser Befehle ein Review startet, müssen alle diese Bedingungen erfüllt sein:118Damit ein Kommentarbefehl wirksam wird, müssen alle diese Bedingungen erfüllt sein:

107 119 

108* Veröffentlichen Sie ihn als neuen Pull-Request-Kommentar auf oberster Ebene, nicht als Inline-Kommentar an einer Diff-Zeile und nicht als Text eines Reviews. Das Bearbeiten eines früheren Kommentars zählt nicht.120* Veröffentlichen Sie ihn als neuen Pull-Request-Kommentar auf oberster Ebene, nicht als Inline-Kommentar an einer Diff-Zeile und nicht als Text eines Reviews. Das Bearbeiten eines früheren Kommentars zählt nicht.

109* Setzen Sie den Befehl an den Anfang des Kommentars, mit `always` in derselben Zeile wie der Rest des Befehls. Groß- und Kleinschreibung spielt keine Rolle.121* Setzen Sie den gesamten Befehl in eine Zeile am Anfang des Kommentars. Weiterer Text kann folgen. Wenn `always` oder `stop` falsch geschrieben ist oder in einer späteren Zeile steht, liest Claude den Kommentar als einfaches `@claude review` und startet ein einzelnes Review. Groß- und Kleinschreibung spielt keine Rolle.

110* Sie benötigen die Berechtigung write, maintain oder admin für das Repository. Claude prüft dies bei GitHub für jede Person, die kommentiert, und Kommentare von Bots starten keine Reviews.122* Sie benötigen die Berechtigung write, maintain oder admin für das Repository. Claude prüft dies bei GitHub für jede Person, die kommentiert, und Kommentare von Bots starten keine Reviews.

111* Der Pull Request muss geöffnet sein.123* Der Pull Request muss geöffnet sein.

112 124 

113Wenn der Befehl angenommen wird, erscheint im Pull Request ein Check Run **Claude Code Review** mit dem Titel **Code review queued...**. Der Titel ändert sich zu **Code review in progress...**, wenn das Review startet. Claude reagiert möglicherweise auch mit 👀 auf Ihren Kommentar, aber diese Reaktion kann auch erscheinen, wenn kein Review startet; achten Sie daher stattdessen auf den Check Run.125Wenn ein Befehl, der ein Review startet, angenommen wird, erscheint im Pull Request ein Check Run **Claude Code Review** mit dem Titel **Code review queued...**. Der Titel ändert sich zu **Code review in progress...**, wenn das Review startet. Claude reagiert möglicherweise auch mit 👀 auf Ihren Kommentar, aber diese Reaktion kann auch erscheinen, wenn kein Review startet; achten Sie daher stattdessen auf den Check Run.

114 126 

115Wenn bereits ein Review für den neuesten Commit des Pull Requests läuft, startet eine neue Anfrage kein zweites.127Wenn bereits ein Review für den neuesten Commit des Pull Requests läuft, startet eine neue Anfrage kein zweites.

116 128 

Details

66 66 

67## Der Check-Run erwähnt REVIEW\.md67## Der Check-Run erwähnt REVIEW\.md

68 68 

69Zwei der Meldungen, die ein Check-Run zu `REVIEW.md` enthalten kann, betreffen den Branch-Schutz:69Dies sind drei der Meldungen, die ein Check-Run zu `REVIEW.md` enthalten kann:

70 70 

71* **„This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes.“**: Das Review hat nur die Datei im Stammverzeichnis gelesen. Unter [Aus welchem Branch REVIEW.md gelesen wird](/docs/de/code-review-customize#which-branch-review-md-is-read-from) erfahren Sie, was sich durch das Schützen des Branches ändert.71* **„This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes.“**: Das Review hat nur die Datei im Stammverzeichnis gelesen. Unter [Aus welchem Branch REVIEW.md gelesen wird](/docs/de/code-review-customize#which-branch-review-md-is-read-from) erfahren Sie, was sich durch das Schützen des Branches ändert.

72* **„were not applied to this review: branch protection could not be confirmed“**: Das Review hat keine `REVIEW.md` gelesen.72* **„were not applied to this review: branch protection could not be confirmed“**: Das Review hat keine `REVIEW.md` gelesen.

73* **„they link to a file this pull request modifies, or carry more links than the review checks“**: Das Review hat die `REVIEW.md` im Stammverzeichnis übersprungen oder die in der Meldung angegebene Anzahl von `REVIEW.md`-Dateien in Unterverzeichnissen. Prüfen Sie die übersprungene Datei auf jede der folgenden Ursachen. Prüfen Sie bei der `REVIEW.md` im Stammverzeichnis auch die [Dateien, die sie einbindet](/docs/de/code-review-customize#include-other-files-in-review-md):

74 * **Zu viele Links**: Die Datei enthält mehr als 64 Markdown-Links. Reduzieren Sie die Links auf [64 oder weniger](/docs/de/code-review-customize#include-other-files-in-review-md).

75 * **Ein Link, den das Review nicht parsen kann**: Die Datei enthält einen fehlerhaften Markdown-Link. Korrigieren oder entfernen Sie den Link.

76 * **Ein Link auf eine geänderte Datei**: Die Datei verlinkt auf eine Datei oder einen Ordner, die bzw. den dieser Pull Request ändert, und das Review konnte nicht nur die Zeilen mit diesem Link auslassen. Schreiben Sie die Regel direkt in `REVIEW.md`.

73 77 

74## Probleme bei der Einrichtung78## Probleme bei der Einrichtung

75 79 

commands.md +4 −4

Details

55| `/artifact-capabilities` | **[Skill](/docs/de/skills#bundled-skills).** Lädt die Referenz zu den Laufzeitfunktionen, die ein veröffentlichtes [Artefakt](/docs/de/artifacts) nutzen kann, etwa [Ihre Konnektoren aufrufen](/docs/de/artifacts#pull-live-data-with-mcp-connectors) oder [einen Datei-Download anbieten](/docs/de/artifacts#offer-a-file-download), einschließlich der Angabe, welche davon Ihr Konto hat. Claude lädt sie normalerweise selbstständig, bevor es eine Seite erstellt, die eine davon nutzt. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind |55| `/artifact-capabilities` | **[Skill](/docs/de/skills#bundled-skills).** Lädt die Referenz zu den Laufzeitfunktionen, die ein veröffentlichtes [Artefakt](/docs/de/artifacts) nutzen kann, etwa [Ihre Konnektoren aufrufen](/docs/de/artifacts#pull-live-data-with-mcp-connectors) oder [einen Datei-Download anbieten](/docs/de/artifacts#offer-a-file-download), einschließlich der Angabe, welche davon Ihr Konto hat. Claude lädt sie normalerweise selbstständig, bevor es eine Seite erstellt, die eine davon nutzt. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind |

56| `/artifact-diagramming` | **[Skill](/docs/de/skills#bundled-skills).** Lädt Leitlinien für Diagramme, denen Claude in [Artefakten](/docs/de/artifacts) folgt: wann ein Diagramm hilft, was gezeichnet werden soll und wie man Inline-SVG schreibt, das in hellen und dunklen Themes lesbar bleibt. Erfordert Claude Code v2.1.221 oder höher |56| `/artifact-diagramming` | **[Skill](/docs/de/skills#bundled-skills).** Lädt Leitlinien für Diagramme, denen Claude in [Artefakten](/docs/de/artifacts) folgt: wann ein Diagramm hilft, was gezeichnet werden soll und wie man Inline-SVG schreibt, das in hellen und dunklen Themes lesbar bleibt. Erfordert Claude Code v2.1.221 oder höher |

57| `/artifacts` | Listet die [Artefakte](/docs/de/artifacts#find-an-artifact-again) auf, die Ihnen gehören oder mit Ihnen geteilt wurden; anschließend können Sie eines an die Sitzung anhängen, in Ihrem Browser öffnen oder seinen Link kopieren. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind. Erfordert Claude Code v2.1.208 oder höher; das Anhängen mit `Enter` erfordert v2.1.216 |57| `/artifacts` | Listet die [Artefakte](/docs/de/artifacts#find-an-artifact-again) auf, die Ihnen gehören oder mit Ihnen geteilt wurden; anschließend können Sie eines an die Sitzung anhängen, in Ihrem Browser öffnen oder seinen Link kopieren. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind. Erfordert Claude Code v2.1.208 oder höher; das Anhängen mit `Enter` erfordert v2.1.216 |

58| `/auto-mode-setup` | [Entwirft `autoMode.environment`-Einträge](/docs/de/auto-mode-config#generate-environment-entries) aus Ihrem Projekt und den letzten Sitzungen; anschließend prüfen Sie den Entwurf und speichern ihn in Ihren Benutzereinstellungen. Erfordert einen Pro-, Max- oder Team-Plan und Claude Code v2.1.228 oder höher. Unter nativem Windows ist v2.1.233 oder höher erforderlich |58| `/auto-mode-setup` | [Entwirft `autoMode.environment`-Einträge](/docs/de/auto-mode-config#generate-environment-entries) aus Ihrem Projekt und den letzten Sitzungen; anschließend prüfen Sie den Entwurf und speichern ihn in Ihren Benutzereinstellungen. Bei einem Pro-, Max- oder Team-Plan ist Claude Code v2.1.228 oder höher erforderlich, unter nativem Windows v2.1.233 oder höher. Bei einem Enterprise-Plan oder mit einem API-Schlüssel der Claude Console ist v2.1.283 oder höher erforderlich. Wenn der Befehl fehlt, siehe [`/auto-mode-setup` gibt „Unknown command“ zurück](/docs/de/auto-mode-config#auto-mode-setup-returns-unknown-command) |

59| `/autocompact [auto\|<tokens>]` | Legt das Fenster für die automatische Komprimierung fest: wie voll das Kontextfenster wird, bevor Claude Code automatisch komprimiert. Übergeben Sie eine Größe wie `500k` oder `auto`, um zu dem für Ihr Modell abgestimmten Fenster zurückzukehren. Claude Code speichert den Wert in den Benutzereinstellungen und wendet ihn auf die aktuelle Sitzung an. Unter [Fenster für die automatische Komprimierung festlegen](/docs/de/model-config#set-the-auto-compact-window) finden Sie die akzeptierten Werte und was sie überschreibt. Ohne Argument wird ein Dialog geöffnet, der das aktuelle Fenster anzeigt. Erfordert Claude Code v2.1.221 oder höher |59| `/autocompact [auto\|<tokens>]` | Legt das Fenster für die automatische Komprimierung fest: wie voll das Kontextfenster wird, bevor Claude Code automatisch komprimiert. Übergeben Sie eine Größe wie `500k` oder `auto`, um zu dem für Ihr Modell abgestimmten Fenster zurückzukehren. Claude Code speichert den Wert in den Benutzereinstellungen und wendet ihn auf die aktuelle Sitzung an. Unter [Fenster für die automatische Komprimierung festlegen](/docs/de/model-config#set-the-auto-compact-window) finden Sie die akzeptierten Werte und was sie überschreibt. Ohne Argument wird ein Dialog geöffnet, der das aktuelle Fenster anzeigt. Erfordert Claude Code v2.1.221 oder höher |

60| `/autofix-pr [prompt]` | Startet eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#auto-fix-pull-requests), die den PR des aktuellen Branches überwacht und Fixes pusht, wenn CI fehlschlägt oder Reviewer Kommentare hinterlassen. Erkennt den offenen PR Ihres ausgecheckten Branches mit `gh pr view`; um einen anderen PR zu überwachen, checken Sie zuerst dessen Branch aus. Standardmäßig wird die Cloud-Sitzung angewiesen, jeden CI-Fehler und jeden Review-Kommentar zu beheben; übergeben Sie einen Prompt, um ihr andere Anweisungen zu geben, zum Beispiel `/autofix-pr only fix lint and type errors`. Erfordert die `gh`-CLI und Zugriff auf [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) |60| `/autofix-pr [prompt]` | Startet eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#auto-fix-pull-requests), die den PR des aktuellen Branches überwacht und Fixes pusht, wenn CI fehlschlägt oder Reviewer Kommentare hinterlassen. Erkennt den offenen PR Ihres ausgecheckten Branches mit `gh pr view`; um einen anderen PR zu überwachen, checken Sie zuerst dessen Branch aus. Standardmäßig wird die Cloud-Sitzung angewiesen, jeden CI-Fehler und jeden Review-Kommentar zu beheben; übergeben Sie einen Prompt, um ihr andere Anweisungen zu geben, zum Beispiel `/autofix-pr only fix lint and type errors`. Erfordert die `gh`-CLI und Zugriff auf [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) |

61| `/background [prompt]` | Löst die aktuelle Sitzung, damit sie als [Hintergrund-Agent](/docs/de/agent-view) läuft, und gibt dieses Terminal frei. Übergeben Sie einen Prompt, um vor dem Lösen noch eine weitere Anweisung zu senden. Überwachen Sie die Sitzung mit `claude agents`. Um die Konversation in eine neue Hintergrundsitzung zu kopieren, während diese weiterläuft, verwenden Sie `/fork`. Alias: `/bg` |61| `/background [prompt]` | Löst die aktuelle Sitzung, damit sie als [Hintergrund-Agent](/docs/de/agent-view) läuft, und gibt dieses Terminal frei. Übergeben Sie einen Prompt, um vor dem Lösen noch eine weitere Anweisung zu senden. Überwachen Sie die Sitzung mit `claude agents`. Um die Konversation in eine neue Hintergrundsitzung zu kopieren, während diese weiterläuft, verwenden Sie `/fork`. Alias: `/bg` |


65| `/bug [report]` | Meldet einen Fehler oder teilt Ihre Konversation. Sie wählen, wie viel Sitzungsverlauf einbezogen wird, und bestätigen auf einem Einwilligungsbildschirm, bevor etwas gesendet wird. Wenn Sie über eine Erstanbieterverbindung bei Anthropic angemeldet sind, geht der Bericht an Anthropic; bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten schreibt Claude Code den Bericht in ein [lokales Archiv unter `~/.claude/feedback-bundles/`](/docs/de/data-usage#telemetry-services), das Sie selbst weiterleiten. In der [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) öffnet `/bug` stattdessen den eigenen Feedback-Dialog der Erweiterung; erfordert Claude Code v2.1.229 oder höher. Wenn Sie den Befehl ausführen, während Claude antwortet, öffnet Claude Code den Dialog sofort. Vor v2.1.232 stellte Claude Code den Befehl in die Warteschlange, bis der Turn beendet war. Alias: `/share`. Vor v2.1.212 waren `/bug` und `/share` Aliase von `/feedback` |65| `/bug [report]` | Meldet einen Fehler oder teilt Ihre Konversation. Sie wählen, wie viel Sitzungsverlauf einbezogen wird, und bestätigen auf einem Einwilligungsbildschirm, bevor etwas gesendet wird. Wenn Sie über eine Erstanbieterverbindung bei Anthropic angemeldet sind, geht der Bericht an Anthropic; bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten schreibt Claude Code den Bericht in ein [lokales Archiv unter `~/.claude/feedback-bundles/`](/docs/de/data-usage#telemetry-services), das Sie selbst weiterleiten. In der [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) öffnet `/bug` stattdessen den eigenen Feedback-Dialog der Erweiterung; erfordert Claude Code v2.1.229 oder höher. Wenn Sie den Befehl ausführen, während Claude antwortet, öffnet Claude Code den Dialog sofort. Vor v2.1.232 stellte Claude Code den Befehl in die Warteschlange, bis der Turn beendet war. Alias: `/share`. Vor v2.1.212 waren `/bug` und `/share` Aliase von `/feedback` |

66| `/cd <path>` | Verschiebt diese Sitzung in ein neues Arbeitsverzeichnis und behält die Konversation bei. Geben Sie einen Teilpfad ein, um passende Verzeichnisvorschläge zu sehen; drücken Sie `Tab`, um einen zu übernehmen. Was Claude Code aus dem neuen Verzeichnis sofort nach dem Wechsel anwendet und wie sich `/cd` von `/add-dir` unterscheidet, erfahren Sie unter [Sitzung in ein anderes Verzeichnis verschieben](/docs/de/permissions#move-the-session-to-another-directory) |66| `/cd <path>` | Verschiebt diese Sitzung in ein neues Arbeitsverzeichnis und behält die Konversation bei. Geben Sie einen Teilpfad ein, um passende Verzeichnisvorschläge zu sehen; drücken Sie `Tab`, um einen zu übernehmen. Was Claude Code aus dem neuen Verzeichnis sofort nach dem Wechsel anwendet und wie sich `/cd` von `/add-dir` unterscheidet, erfahren Sie unter [Sitzung in ein anderes Verzeichnis verschieben](/docs/de/permissions#move-the-session-to-another-directory) |

67| `/chrome` | Konfiguriert die Einstellungen für [Claude in Chrome](/docs/de/chrome) |67| `/chrome` | Konfiguriert die Einstellungen für [Claude in Chrome](/docs/de/chrome) |

68| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/de/skills#bundled-skills).** Lädt Referenzmaterial zur [Claude API](https://platform.claude.com/docs/en/api/overview) und zu [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) für die Sprache Ihres Projekts. Wird außerdem automatisch aktiviert, wenn Ihr Code `anthropic` oder `@anthropic-ai/sdk` importiert. Was jeder Unterbefehl tut und welche Version er erfordert, erfahren Sie unter [An Claude-API-Projekten arbeiten](/docs/de/skills#work-on-claude-api-projects) |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/de/skills#bundled-skills).** Lädt Referenzmaterial zur [Claude API](https://platform.claude.com/docs/en/api/overview) und zu [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) für die Sprache Ihres Projekts. Wird außerdem automatisch aktiviert, wenn Ihr Code `anthropic` oder `@anthropic-ai/sdk` importiert. Was jeder Unterbefehl tut und welche Version er erfordert, erfahren Sie unter [An Claude-API-Projekten arbeiten](/docs/de/skills#work-on-claude-api-projects) |

69| `/claude-in-chrome [task]` | **[Skill](/docs/de/skills#bundled-skills).** Lässt Claude über [Claude in Chrome](/docs/de/chrome) eine Aufgabe in Ihrem Browser ausführen, etwa eine Seite testen, ein Formular ausfüllen oder Konsolen-Logs lesen. Verfügbar, wenn die Chrome-Integration für die Sitzung aktiviert ist, zum Beispiel mit `claude --chrome`, oder wenn Claude Code anbieten kann, [die Erweiterung zu installieren](/docs/de/chrome#install-the-extension-when-claude-asks) |69| `/claude-in-chrome [task]` | **[Skill](/docs/de/skills#bundled-skills).** Lässt Claude über [Claude in Chrome](/docs/de/chrome) eine Aufgabe in Ihrem Browser ausführen, etwa eine Seite testen, ein Formular ausfüllen oder Konsolen-Logs lesen. Verfügbar, wenn die Chrome-Integration für die Sitzung aktiviert ist, zum Beispiel mit `claude --chrome`, oder wenn Claude Code anbieten kann, [die Erweiterung zu installieren](/docs/de/chrome#install-the-extension-when-claude-asks) |

70| `/clear [name]` | Startet eine neue Konversation mit leerem Kontext. Übergeben Sie einen Namen, um die vorherige Konversation in der `/resume`-Auswahl zu benennen. Um Kontext freizugeben und dabei dieselbe Konversation fortzusetzen, verwenden Sie stattdessen `/compact`. Setzen Sie die vorherige Konversation mit `/resume` fort oder stellen Sie sie im selben Claude Code-Prozess über [den Eintrag für die vorherige Sitzung im Rewind-Menü](/docs/de/checkpointing#rewind-past-a-cleared-conversation) wieder her. Aliase: `/reset`, `/new` |70| `/clear [name]` | Startet eine neue Konversation mit leerem Kontext. Übergeben Sie einen Namen, um die vorherige Konversation in der `/resume`-Auswahl zu benennen. Um Kontext freizugeben und dabei dieselbe Konversation fortzusetzen, verwenden Sie stattdessen `/compact`. Setzen Sie die vorherige Konversation mit `/resume` fort oder stellen Sie sie im selben Claude Code-Prozess über [den Eintrag für die vorherige Sitzung im Rewind-Menü](/docs/de/checkpointing#rewind-past-a-cleared-conversation) wieder her. Aliase: `/reset`, `/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](/docs/de/skills#bundled-skills).** Prüft den aktuellen Diff oder eine übergebene PR-Nummer, einen Branch oder einen Pfad auf Korrektheitsfehler. Abhängig von Ihrem Modell und Ihrer Effort-Stufe deckt das Review auch Möglichkeiten zur Bereinigung ab. Übergeben Sie `--fix`, damit Claude die Befunde anwendet, `--comment`, um sie im GitHub-PR oder GitLab Merge Request zu posten, oder `ultra`, um ein tiefgehendes [Cloud-Review](/docs/de/ultrareview) auszuführen. Das Posten in einem GitLab Merge Request erfordert Claude Code v2.1.257 oder höher. Mit `ultra` bei einem `github.com`-PR als Ziel übergeben Sie `--post`, um im Startdialog [das Posten der fertigen Befunde im PR](/docs/de/ultrareview#post-findings-to-the-pull-request) vorauszuwählen; `--post` erfordert Claude Code v2.1.227 oder höher. Unter [Lokal mit `/code-review` reviewen](/docs/de/code-review-local) finden Sie die Effort-Stufen, die Zielauswahl und die Beziehung zu `/simplify`. Alias: `/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](/docs/de/skills#bundled-skills).** Prüft den aktuellen Diff oder eine übergebene PR-Nummer, einen Branch oder einen Pfad auf Korrektheitsfehler. Abhängig von Ihrem Modell und Ihrer Effort-Stufe deckt das Review auch Möglichkeiten zur Bereinigung ab. Übergeben Sie `--fix`, damit Claude die Befunde anwendet, `--comment`, um sie im GitHub-PR oder GitLab Merge Request zu posten, oder `ultra`, um ein tiefgehendes [Cloud-Review](/docs/de/ultrareview) auszuführen. Das Posten in einem GitLab Merge Request erfordert Claude Code v2.1.257 oder höher. Mit `ultra` bei einem `github.com`-PR als Ziel übergeben Sie `--post`, um im Startdialog [das Posten der fertigen Befunde im PR](/docs/de/ultrareview#post-findings-to-the-pull-request) vorauszuwählen; `--post` erfordert Claude Code v2.1.227 oder höher. Unter [Lokal mit `/code-review` reviewen](/docs/de/code-review-local) finden Sie die Effort-Stufen, die Zielauswahl und die Beziehung zu `/simplify`. Alias: `/review` |


80| `/deep-research <question>` | **[Workflow](/docs/de/workflows#bundled-workflows).** Verteilt Websuchen zu einer Frage, ruft Quellen ab, gleicht sie miteinander ab und erstellt einen Bericht mit Quellenangaben |80| `/deep-research <question>` | **[Workflow](/docs/de/workflows#bundled-workflows).** Verteilt Websuchen zu einer Frage, ruft Quellen ab, gleicht sie miteinander ab und erstellt einen Bericht mit Quellenangaben |

81| `/design [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Entwirft UI-Mockups, Bildschirmabläufe, Landingpages oder Poster als Artboards auf einer Leinwand, veröffentlicht als Claude Design-[Artefakt](/docs/de/artifacts#draft-a-design-canvas), zum Beispiel `/design a settings screen for a mobile banking app`. Sie bearbeiten die Artboards in einem Desktop-Browser, und Ihre Änderungen werden automatisch gespeichert. Sie können jedes Artboard als PNG oder PDF exportieren. Erfordert Claude Code v2.1.265 oder höher, eine Sitzung, in der [Artefakte verfügbar sind](/docs/de/artifacts#availability), und ein Konto, in dem die [Design-Vorlage verfügbar ist](/docs/de/artifacts#start-from-a-slides-design-or-docs-template); wenn Ihre Organisation diese Vorlage deaktiviert hat, entwirft `/design` keine Designs. Verfügbar über die Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |81| `/design [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Entwirft UI-Mockups, Bildschirmabläufe, Landingpages oder Poster als Artboards auf einer Leinwand, veröffentlicht als Claude Design-[Artefakt](/docs/de/artifacts#draft-a-design-canvas), zum Beispiel `/design a settings screen for a mobile banking app`. Sie bearbeiten die Artboards in einem Desktop-Browser, und Ihre Änderungen werden automatisch gespeichert. Sie können jedes Artboard als PNG oder PDF exportieren. Erfordert Claude Code v2.1.265 oder höher, eine Sitzung, in der [Artefakte verfügbar sind](/docs/de/artifacts#availability), und ein Konto, in dem die [Design-Vorlage verfügbar ist](/docs/de/artifacts#start-from-a-slides-design-or-docs-template); wenn Ihre Organisation diese Vorlage deaktiviert hat, entwirft `/design` keine Designs. Verfügbar über die Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |

82| `/design consent`, `/design revoke` | Erteilt Claude Zugriff auf [Claude Design](https://claude.ai/design) oder entzieht ihn wieder. Wenn Claude Sie in einer Antwort auffordert, `/design consent` auszuführen, geben Sie den Befehl selbst im Prompt von Claude Code ein |82| `/design consent`, `/design revoke` | Erteilt Claude Zugriff auf [Claude Design](https://claude.ai/design) oder entzieht ihn wieder. Wenn Claude Sie in einer Antwort auffordert, `/design consent` auszuführen, geben Sie den Befehl selbst im Prompt von Claude Code ein |

83| `/design-login` | Autorisiert den Zugriff auf das Designsystem für `/design-sync` mit Ihrem claude.ai-Konto. Melden Sie sich mit `/design-login` an, wann immer `/design-sync` oder `/design consent` Sie dazu auffordert |83| `/design-login` | Autorisiert den Zugriff auf das Designsystem für `/design-sync` mit Ihrem claude.ai-Konto. Melden Sie sich mit `/design-login` an, wann immer `/design-sync` oder `/design consent` Sie dazu auffordert. Diese Anmeldung gilt für die eigenständige Claude Design-Website unter claude.ai/design, die spätestens am 14.12.2026 geschlossen wird; siehe [Von eigenständigem Claude Design zu Claude migrieren](https://support.claude.com/en/articles/17440474-migrate-from-standalone-claude-design-to-claude) |

84| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertiert das React-Designsystem Ihres Repositorys und lädt es zu [Claude Design](https://claude.ai/design) hoch, sodass die dort erzeugten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Designsystem, zum Beispiel `/design-sync Acme DS`. Eine erste Synchronisierung prüft jede Komponente und kann bei einem großen Repository einige Stunden dauern. Verfügbar über die Anthropic API. Der Befehl benötigt claude.ai, das die CLI auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS sowie über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway#availability-and-limitations) nicht kontaktiert, daher ist der Befehl dort nicht verfügbar |84| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertiert das React-Designsystem Ihres Repositorys und lädt es zu [Claude Design](https://claude.ai/design) hoch, sodass die dort erzeugten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Designsystem, zum Beispiel `/design-sync Acme DS`. Eine erste Synchronisierung prüft jede Komponente und kann bei einem großen Repository einige Stunden dauern. Verfügbar über die Anthropic API. Der Befehl benötigt claude.ai, das die CLI auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS sowie über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway#availability-and-limitations) nicht kontaktiert. Dort ist der Befehl nicht verfügbar. Dieser Befehl lädt auf die eigenständige Website claude.ai/design hoch, die spätestens am 14.12.2026 geschlossen wird; siehe [Von eigenständigem Claude Design zu Claude migrieren](https://support.claude.com/en/articles/17440474-migrate-from-standalone-claude-design-to-claude) |

85| `/desktop` | Setzt die aktuelle Sitzung in der Claude Code Desktop-App fort. Erfordert macOS oder x64-Windows und ein Claude-Abonnement. Alias: `/app` |85| `/desktop` | Setzt die aktuelle Sitzung in der Claude Code Desktop-App fort. Erfordert macOS oder x64-Windows und ein Claude-Abonnement. Alias: `/app` |

86| `/diff` | Prüft die Änderungen in Ihrem Working Tree, einschließlich der Bearbeitungen, die Claude bisher vorgenommen hat. Siehe [Änderungen mit /diff prüfen](/docs/de/interactive-mode#review-changes-with-%2Fdiff) |86| `/diff` | Prüft die Änderungen in Ihrem Working Tree, einschließlich der Bearbeitungen, die Claude bisher vorgenommen hat. Siehe [Änderungen mit /diff prüfen](/docs/de/interactive-mode#review-changes-with-%2Fdiff) |

87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/de/skills#bundled-skills).** Führt einen Setup-Check durch, der Probleme mit Installation, Einstellungen, Erweiterungen und `CLAUDE.md` diagnostiziert und Korrekturen vorschlägt, die Claude nach Ihrer Bestätigung anwendet. Was der Check abdeckt oder wie Sie stattdessen mit `prompt-audit` Ihre Anweisungen prüfen, erfahren Sie unter [Setup mit `/doctor` prüfen](/docs/de/skills#check-your-setup-with-/doctor). Der Unterbefehl `prompt-audit` erfordert Claude Code v2.1.283 oder höher. Alias: `/checkup` |87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/de/skills#bundled-skills).** Führt einen Setup-Check durch, der Probleme mit Installation, Einstellungen, Erweiterungen und `CLAUDE.md` diagnostiziert und Korrekturen vorschlägt, die Claude nach Ihrer Bestätigung anwendet. Was der Check abdeckt oder wie Sie stattdessen mit `prompt-audit` Ihre Anweisungen prüfen, erfahren Sie unter [Setup mit `/doctor` prüfen](/docs/de/skills#check-your-setup-with-/doctor). Der Unterbefehl `prompt-audit` erfordert Claude Code v2.1.283 oder höher. Alias: `/checkup` |

Details

379 379 

380Um zu verhindern, dass `@`-Referenzen Dateiinhalte und Verzeichnisauflistungen in Ihre Nachricht einfügen, setzen Sie [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/de/env-vars#variables) in Ihrer Shell oder in Ihren Benutzereinstellungen. Claude erhält dann die von Ihnen referenzierten Pfade zusammen mit einem Hinweis, sie mit seinen Datei-Tools zu lesen. Die Variable erfordert Claude Code v2.1.299 oder höher, und Claude Code ignoriert sie in Projekt- und lokalen Einstellungen.380Um zu verhindern, dass `@`-Referenzen Dateiinhalte und Verzeichnisauflistungen in Ihre Nachricht einfügen, setzen Sie [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/de/env-vars#variables) in Ihrer Shell oder in Ihren Benutzereinstellungen. Claude erhält dann die von Ihnen referenzierten Pfade zusammen mit einem Hinweis, sie mit seinen Datei-Tools zu lesen. Die Variable erfordert Claude Code v2.1.299 oder höher, und Claude Code ignoriert sie in Projekt- und lokalen Einstellungen.

381 381 

382Ihre [`PreToolUse`-Hooks](/docs/de/hooks#pretooluse) werden nicht ausgeführt, wenn Claude Code eine Datei einbezieht, die Sie mit `@` referenzieren, da dabei kein Tool-Aufruf erfolgt. Wenn Sie sich auf diese Hooks verlassen, um zu steuern, was Claude liest, blockieren Sie bestimmte Pfade oder verhindern Sie, dass `@`-Referenzen Dateien einbeziehen:

383 

384* **Bestimmte Pfade blockieren**: Fügen Sie eine [`Read`-Deny-Regel](/docs/de/permissions#read-and-edit) für diese Pfade hinzu. Claude Code bezieht keine Datei ein, auf die die Regel zutrifft.

385* **Verhindern, dass `@`-Referenzen Dateien einbeziehen**: Setzen Sie `CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`. Dadurch beziehen `@`-Datei- und Verzeichnisreferenzen in Ihren Nachrichten keine Inhalte mehr ein, auch nicht für Pfade, die Ihre Hooks nicht prüfen. Ihre passenden Hooks werden dann ausgeführt, bevor Claude einen referenzierten Pfad mit einem Tool wie `Read` öffnet.

386 

382***387***

383 388 

384### Claude nach einem Zeitplan ausführen389### Claude nach einem Zeitplan ausführen


392| [Geplante Aufgaben in der Cloud](/docs/de/routines) | Cloud, standardmäßig von Anthropic verwaltet | Aufgaben, die auch dann ausgeführt werden sollten, wenn Ihr Computer ausgeschaltet ist. Können auch durch API-Aufrufe oder GitHub-Ereignisse zusätzlich zu einem Zeitplan ausgelöst werden. Konfigurieren Sie unter [claude.ai/code/routines](https://claude.ai/code/routines). |397| [Geplante Aufgaben in der Cloud](/docs/de/routines) | Cloud, standardmäßig von Anthropic verwaltet | Aufgaben, die auch dann ausgeführt werden sollten, wenn Ihr Computer ausgeschaltet ist. Können auch durch API-Aufrufe oder GitHub-Ereignisse zusätzlich zu einem Zeitplan ausgelöst werden. Konfigurieren Sie unter [claude.ai/code/routines](https://claude.ai/code/routines). |

393| [Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) | Ihr Computer, über die Desktop-App | Aufgaben, die direkten Zugriff auf lokale Dateien, Tools oder nicht committete Änderungen benötigen. |398| [Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) | Ihr Computer, über die Desktop-App | Aufgaben, die direkten Zugriff auf lokale Dateien, Tools oder nicht committete Änderungen benötigen. |

394| [GitHub Actions](/docs/de/github-actions) | Ihre CI-Pipeline | Aufgaben, die an Repository-Ereignisse wie geöffnete PRs gebunden sind, oder Cron-Zeitpläne, die neben Ihrer Workflow-Konfiguration leben sollten. |399| [GitHub Actions](/docs/de/github-actions) | Ihre CI-Pipeline | Aufgaben, die an Repository-Ereignisse wie geöffnete PRs gebunden sind, oder Cron-Zeitpläne, die neben Ihrer Workflow-Konfiguration leben sollten. |

395| [`/loop`](/docs/de/scheduled-tasks) | Die aktuelle CLI-Sitzung | Schnelle Abfragen während eine Sitzung offen ist. `--resume` und `--continue` stellen Schleifen mit festem Intervall wieder her. |400| [`/loop`](/docs/de/scheduled-tasks) | Die aktuelle CLI-Sitzung | Schnelle Abfragen während eine Sitzung offen ist. `--resume` und `--continue` stellen nicht abgelaufene Schleifen mit festem Intervall wieder her. |

396 401 

397> [!TIP]402> [!TIP]

398>403>

costs.md +24 −5

Details

55 55 

56#### Plannutzungs-Aufschlüsselung56#### Plannutzungs-Aufschlüsselung

57 57 

58Bei einem Pro-, Max-, Team- oder Enterprise-Plan zeigt `/usage` auch eine Aufschlüsselung dessen, was gegen Ihre Planlimits zählt:58Bei einem Pro-, Max-, Team- oder Enterprise-Plan zeigt `/usage` auch eine Aufschlüsselung dessen, was gegen Ihre Planlimits zählt, mit Empfehlungen:

59 59 

60* **Attribution**: kürzliche Nutzung, die Skills, Subagenten, Plugins und einzelnen MCP-Servern zugeordnet ist, jeweils als Prozentsatz des Gesamtbetrags angezeigt. Der Anteil eines MCP-Servers zählt nur die Anfragen, die eines seiner Tool-Ergebnisse verbraucht haben. Vor v2.1.222 ordnete Claude Code nach einem Aufruf eines MCP-Servers jede nachfolgende Anfrage diesem Server zu, was seinen Anteil überzeichnete.60* **Attribution**: kürzliche Nutzung, die Skills, Subagenten, Plugins und einzelnen MCP-Servern zugeordnet ist, jeweils als Prozentsatz des Gesamtbetrags angezeigt. Der Anteil eines MCP-Servers zählt nur die Anfragen, die eines seiner Tool-Ergebnisse verbraucht haben. Vor v2.1.222 ordnete Claude Code nach einem Aufruf eines MCP-Servers jede nachfolgende Anfrage diesem Server zu, was seinen Anteil überzeichnete.

61* **Verhaltensflags**: Verhaltensweisen wie langer Kontext oder Cache-Misses, gekennzeichnet, wenn eine 10% oder mehr der kürzlichen Nutzung ausmacht.61* **Empfehlungen**: Änderungen, die Ihre Nutzung senken, eine pro Zeile. Jede Zeile beginnt mit dem Anteil der kürzlichen Nutzung, den sie betrifft, mindestens 10%, wie in `25% Trim ~/code/api/CLAUDE.md · 49k tokens per request`. Wie Sie Claude Code die Empfehlungen umsetzen lassen, die es umsetzen kann, erfahren Sie unter [Empfehlungen mit dem Fix-Kürzel anwenden](#apply-recommendations-with-the-fix-shortcut).

62* **Schleifen**: eine Zeile für jede der schwersten [`/loop`- oder anderen sitzungsbezogenen geplanten Aufgaben](/docs/de/scheduled-tasks), die kürzlich ausgeführt wurden, geordnet nach Gesamttoken, mit einer Zählung der übrigen. Erfordert Claude Code v2.1.242 oder später.62* **Schleifen**: eine Zeile für jede der schwersten [`/loop`- oder anderen sitzungsbezogenen geplanten Aufgaben](/docs/de/scheduled-tasks), die kürzlich ausgeführt wurden, geordnet nach Gesamttoken, mit einer Zählung der übrigen. Erfordert Claude Code v2.1.242 oder später.

63 * **Was jede Zeile meldet**: wie oft die Aufgabe ausgelöst wird, wie oft sie ausgeführt wurde, ihre Gesamt- und Pro-Lauf-Token und wann sie zuletzt ausgeführt wurde63 * **Was jede Zeile meldet**: wie oft die Aufgabe ausgelöst wird, wie oft sie ausgeführt wurde, ihre Gesamt- und Pro-Lauf-Token und wann sie zuletzt ausgeführt wurde

64 * **Gestoppte und neu erstellte Schleifen**: Claude Code ordnet eine Zeile anhand des Prompts der Aufgabe zu, daher bleibt eine Schleife, die Sie stoppen und neu erstellen, eine Zeile64 * **Gestoppte und neu erstellte Schleifen**: Claude Code ordnet eine Zeile anhand des Prompts der Aufgabe zu, daher bleibt eine Schleife, die Sie stoppen und neu erstellen, eine Zeile

65 65 

66Drücken Sie `d` oder `w`, um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Zahlen sind ungefähr und werden aus dem lokalen Sitzungsverlauf auf diesem Computer berechnet, daher ist die Nutzung von anderen Geräten oder claude.ai nicht enthalten.66Drücken Sie `d` oder `w`, um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Zahlen sind ungefähr und werden aus dem lokalen Sitzungsverlauf auf diesem Computer berechnet, daher ist die Nutzung von anderen Geräten oder claude.ai nicht enthalten.

67 67 

68In der [VS Code-Erweiterung](/docs/de/vs-code#check-account-and-usage) erscheinen die Attributionsanteile und Verhaltensflags im Dialog „Konto & Nutzung“ mit einem Tag- und Woche-Umschalter, ohne die Zeilen „Schleifen“.68In der [VS Code-Erweiterung](/docs/de/vs-code#check-account-and-usage) erscheinen die Attributionsanteile und Empfehlungen im Dialog „Konto & Nutzung“ mit einem Tag- und Woche-Umschalter, ohne die Zeilen „Schleifen“.

69 

70#### Empfehlungen mit dem Fix-Kürzel anwenden

71 

72Wenn die Fußzeile von `/usage` einen Hinweis wie `f to fix 2 of 3` anzeigt, drücken Sie `f`, damit Claude Code die Empfehlungen umsetzt, die es umsetzen kann. Das Kürzel `f` erfordert Claude Code v2.1.305 oder später.

73 

741. Nachdem ein gerade laufender Turn beendet ist, führt Claude Code jeden [`/effort`](/docs/de/model-config#adjust-effort-level)-Befehl aus, der in einer Zeile ohne `run` angezeigt wird.

752. Claude erhält dann einen Prompt mit einem Schritt für jede der anderen Zeilen, die es umsetzen kann. Der Prompt bittet Claude, Ihnen jede Änderung zu zeigen, bevor es sie vornimmt.

76 

77Um zu sehen, was das Drücken von `f` mit jeder Ihrer Zeilen bewirkt, suchen Sie die Form der Zeile in der ersten Spalte:

78 

79| Form der Zeile | Beispielzeile | Wenn Sie `f` drücken |

80| :- | :- | :- |

81| Endet mit einem `/effort`-Befehl ohne vorangestelltes `run` | `40% Switch from max to high effort · /effort high` | Claude Code führt den Befehl aus |

82| Endet mit `run` und einem Befehl | `30% Compact before you step away · run /compact` | Für diese Zeile passiert nichts. Führen Sie den Befehl selbst im Eingabefeld von Claude Code aus |

83| Endet mit etwas anderem | `25% Trim ~/code/api/CLAUDE.md · 49k tokens per request` | Claude erhält für einige dieser Zeilen einen Schritt im Prompt, für die übrigen passiert nichts. Wenn Claude Ihnen für eine Zeile keine Änderung zeigt, setzen Sie diese Empfehlung selbst um |

84 

85In `f to fix 2 of 3` zählt die erste Zahl die Zeilen, die Claude Code umsetzt, wenn Sie `f` drücken, und die zweite die angezeigten Zeilen. Ein Hinweis ohne `of`, etwa `f to fix both`, bedeutet, dass Claude Code jede angezeigte Zeile umsetzt.

86 

87Während [Remote Control](/docs/de/remote-control) verbunden ist, zeigt die Fußzeile keinen `f`-Hinweis. Wenn das Drücken von `f` `/usage` mit `Nothing was sent. Turn off Remote Control to use fixes.` schließt, wurde Remote Control verbunden, während `/usage` geöffnet war. Um `f` wieder zu verwenden, [trennen Sie Remote Control](/docs/de/remote-control#check-connection-status), führen Sie dann `/usage` im Eingabefeld von Claude Code aus und drücken Sie erneut `f`.

69 88 

70#### Überprüfen Sie Ihre Ausgaben für Nutzungsguthaben89#### Überprüfen Sie Ihre Ausgaben für Nutzungsguthaben

71 90 


367Eine Sitzung, die stundenlang offen war, kann viel mehr von Ihren Planlimits verbrauchen als Ihre Aktivität vermuten lässt, normalerweise aus einem dieser Gründe:386Eine Sitzung, die stundenlang offen war, kann viel mehr von Ihren Planlimits verbrauchen als Ihre Aktivität vermuten lässt, normalerweise aus einem dieser Gründe:

368 387 

369* **Langer Kontext**: Claude Code sendet Ihre vollständige Konversation mit jeder Anfrage, und jedes Mal, wenn Claude Tools verwendet, sendet es eine weitere Anfrage mit diesem Batch von Tool-Ergebnissen. Mit [Prompt Caching](/docs/de/prompt-caching) liest Claude Code diese Historie mit der [zwischengespeicherten Token-Rate](https://platform.claude.com/docs/en/about-claude/pricing), sodass eine einzeilige Frage in einer Sitzung, die den ganzen Tag offen war, immer noch Nutzung für die gesamte Konversation verursacht. Siehe [Kontext proaktiv verwalten](#manage-context-proactively) für Möglichkeiten, Ihren Kontext klein zu halten388* **Langer Kontext**: Claude Code sendet Ihre vollständige Konversation mit jeder Anfrage, und jedes Mal, wenn Claude Tools verwendet, sendet es eine weitere Anfrage mit diesem Batch von Tool-Ergebnissen. Mit [Prompt Caching](/docs/de/prompt-caching) liest Claude Code diese Historie mit der [zwischengespeicherten Token-Rate](https://platform.claude.com/docs/en/about-claude/pricing), sodass eine einzeilige Frage in einer Sitzung, die den ganzen Tag offen war, immer noch Nutzung für die gesamte Konversation verursacht. Siehe [Kontext proaktiv verwalten](#manage-context-proactively) für Möglichkeiten, Ihren Kontext klein zu halten

370* **Cache-Misses**: Ihre erste Nachricht nach einer Pause, die länger als die [Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime) ist, verfehlt den Cache und verarbeitet Ihren vollständigen Kontext neu. Die Lebensdauer beträgt eine Stunde bei einem Abonnement und sinkt auf fünf Minuten, sobald Sie [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) in Anspruch nehmen; bei einem API-Schlüssel oder Cloud-Provider beträgt sie standardmäßig fünf Minuten. Um die einstündige Lebensdauer beizubehalten, während Sie Nutzungsguthaben in Anspruch nehmen, [wählen Sie die TTL selbst](/docs/de/prompt-caching#choose-the-ttl-yourself)389* **Cache-Misses**: Ihre erste Nachricht nach einer Pause, die länger als die [Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime) ist, verfehlt den Cache und verarbeitet Ihren vollständigen Kontext neu. Siehe [welche Lebensdauer Ihre Anfragen erhalten](/docs/de/prompt-caching#which-ttl-each-request-gets) und [die Steuerungsmöglichkeiten zum Festlegen](/docs/de/prompt-caching#choose-the-ttl-yourself)

371* **Geplante Aufgaben**: Eine [sitzungsbezogene geplante Aufgabe](/docs/de/scheduled-tasks) wird in ihrem Intervall ausgelöst, auch während die Sitzung untätig ist, und sendet jedes Mal Ihren vollständigen Kontext390* **Geplante Aufgaben**: Eine [sitzungsbezogene geplante Aufgabe](/docs/de/scheduled-tasks) wird in ihrem Intervall ausgelöst, auch während die Sitzung untätig ist, und sendet jedes Mal Ihren vollständigen Kontext

372* **Sitzungsübergreifende Nachrichten**: Claude Code liefert eine [Nachricht aus einer anderen Ihrer Sitzungen](/docs/de/cross-session-messaging) als neuen Zug, wenn diese Sitzung untätig ist, und sendet jedes Mal Ihren vollständigen Kontext. Um eingehende Nachrichten zu halten, anstatt sie zu liefern, setzen Sie [`crossSessionInbound`](/docs/de/settings-reference#crosssessioninbound) auf `hold`391* **Sitzungsübergreifende Nachrichten**: Claude Code liefert eine [Nachricht aus einer anderen Ihrer Sitzungen](/docs/de/cross-session-messaging) als neuen Zug, wenn diese Sitzung untätig ist, und sendet jedes Mal Ihren vollständigen Kontext. Um eingehende Nachrichten zu halten, anstatt sie zu liefern, setzen Sie [`crossSessionInbound`](/docs/de/settings-reference#crosssessioninbound) auf `hold`

373* **Zielüberprüfungen**: Während Hintergrundarbeit ein aktives [Ziel](/docs/de/goal) wartet, fragt Claude Code [Claude, um diese Arbeit zu überprüfen](/docs/de/goal#background-work-defers-evaluation), auch wenn die Sitzung untätig ist, und startet einen neuen Zug, der Ihren vollständigen Kontext sendet. Claude Code startet höchstens drei untätige Überprüfungen pro Ziel zwischen Ihren Eingaben. Vor v2.1.246 waren untätige Überprüfungen unbegrenzt. Um Überprüfungen auszuschalten, setzen Sie [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/de/env-vars) auf `0`. Untätige Überprüfungen erfordern Claude Code v2.1.236 oder später392* **Zielüberprüfungen**: Während Hintergrundarbeit ein aktives [Ziel](/docs/de/goal) wartet, fragt Claude Code [Claude, um diese Arbeit zu überprüfen](/docs/de/goal#background-work-defers-evaluation), auch wenn die Sitzung untätig ist, und startet einen neuen Zug, der Ihren vollständigen Kontext sendet. Claude Code startet höchstens drei untätige Überprüfungen pro Ziel zwischen Ihren Eingaben. Vor v2.1.246 waren untätige Überprüfungen unbegrenzt. Um Überprüfungen auszuschalten, setzen Sie [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/de/env-vars) auf `0`. Untätige Überprüfungen erfordern Claude Code v2.1.236 oder später


375* **Agent-Teamkollegen**: Jeder aktive [Teamkollege](#agent-team-token-costs) verbraucht weiterhin Token, bis er beendet wird394* **Agent-Teamkollegen**: Jeder aktive [Teamkollege](#agent-team-token-costs) verbraucht weiterhin Token, bis er beendet wird

376* **Komprimierung**: `/compact` liest die Konversation, die es zusammenfasst, sodass [das Komprimieren eines großen Kontexts](/docs/de/prompt-caching#compacting-the-conversation) selbst eine große Anfrage ist. Wenn Sie einen Neuanfang statt Kontinuität möchten, kostet `/clear` nichts395* **Komprimierung**: `/compact` liest die Konversation, die es zusammenfasst, sodass [das Komprimieren eines großen Kontexts](/docs/de/prompt-caching#compacting-the-conversation) selbst eine große Anfrage ist. Wenn Sie einen Neuanfang statt Kontinuität möchten, kostet `/clear` nichts

377 396 

378Bei einem Pro-, Max-, Team- oder Enterprise-Plan kennzeichnet die `/usage`-Aufschlüsselung Verhaltensweisen, die 10 % oder mehr Ihrer kürzlichen Nutzung ausmachen, wie langer Kontext oder Cache-Misses, jeweils mit einem Tipp, um es zu reduzieren.397Bei einem Pro-, Max-, Team- oder Enterprise-Plan empfiehlt die [`/usage`-Aufschlüsselung](#plan-usage-breakdown) eine Änderung für Verhaltensweisen, die 10 % oder mehr Ihrer kürzlichen Nutzung ausmachen, wie langer Kontext oder Cache-Misses.

379 398 

380## Änderungen im Verhalten von Claude Code verstehen399## Änderungen im Verhalten von Claude Code verstehen

381 400 

Details

228* **Vor der Frist**: Wenn eine Einstellung oder Einstellungsänderung die Nachricht zulässt, übermittelt Claude Code sie.228* **Vor der Frist**: Wenn eine Einstellung oder Einstellungsänderung die Nachricht zulässt, übermittelt Claude Code sie.

229* **Nach der Frist**: Claude Code verwirft die Nachricht und meldet sie als abgelaufen an einen Absender, den es erreichen kann.229* **Nach der Frist**: Claude Code verwirft die Nachricht und meldet sie als abgelaufen an einen Absender, den es erreichen kann.

230 230 

231Setzen Sie `dialogExpiry` auf `"never"`, um Standard-gehaltene Nachrichten bis zum Ende der Sitzung zu behalten. Eine Nachricht, die durch eine explizite `hold`-Einstellung gehalten wird, läuft nicht ab; Claude Code übermittelt sie nur, wenn ein `accept` später gilt.231Setzen Sie `dialogExpiry` auf `"never"`, um standardmäßig zurückgehaltene Nachrichten bis zum Ende der Sitzung zu behalten. Eine Nachricht, die durch eine explizite `hold`-Einstellung zurückgehalten wird, läuft nicht ab; Claude Code übermittelt sie, wenn später ein `accept` gilt.

232 232 

233Um einen `-p`-Worker unbeaufsichtigt Nachrichten zu nehmen, starten Sie ihn mit `crossSessionInbound` auf `accept` in seinem `--settings`-Wert. Ein `accept` in Ihren Benutzereinstellungen funktioniert auch, gilt aber für jede Sitzung, die Sie ausführen.233Um einen `-p`-Worker unbeaufsichtigt Nachrichten zu nehmen, starten Sie ihn mit `crossSessionInbound` auf `accept` in seinem `--settings`-Wert. Ein `accept` in Ihren Benutzereinstellungen funktioniert auch, gilt aber für jede Sitzung, die Sie ausführen.

234 234 

desktop.md +76 −69

Details

6 6 

7> Nutzen Sie Claude Code Desktop optimal: parallele Sitzungen mit Git-Isolation, Drag-and-Drop-Pane-Layout, integriertes Terminal und Datei-Editor, Seitenchats, Computernutzung, Dispatch-Sitzungen von Ihrem Telefon, visuelle Diff-Überprüfung, App-Vorschau, PR-Überwachung, Konnektoren und Unternehmenskonfiguration.7> Nutzen Sie Claude Code Desktop optimal: parallele Sitzungen mit Git-Isolation, Drag-and-Drop-Pane-Layout, integriertes Terminal und Datei-Editor, Seitenchats, Computernutzung, Dispatch-Sitzungen von Ihrem Telefon, visuelle Diff-Überprüfung, App-Vorschau, PR-Überwachung, Konnektoren und Unternehmenskonfiguration.

8 8 

9Die Claude Desktop-App hat drei Registerkarten: **Chat** für Gespräche, **Cowork** für [Dispatch und längere agentengestützte Arbeiten](https://claude.com/product/cowork) und **Code** für Softwareentwicklung. Diese Seite ist die Referenz für die Registerkarte Code.9In der Claude Desktop-App ist Claude Code die Registerkarte **Code**. Die App bietet außerdem Chat und [Cowork](https://claude.com/product/cowork), das Dispatch und längere agentengestützte Arbeiten übernimmt. Diese Seite ist die Referenz für die Registerkarte Code.

10 10 

11> **[Für macOS herunterladen](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**11> **[Für macOS herunterladen](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**

12>12>


214 214 

215### Sitzungsdetails anzeigen215### Sitzungsdetails anzeigen

216 216 

217Das Sitzungsdetails-Panel ist eine Gruppe von Karten neben dem Chat, die anzeigen, wo die Sitzung läuft, was sie geändert hat und was sie gerade ausführt. Das Panel erscheint, nachdem Sie eine Sitzung gestartet haben, sofern der Chat breit genug dafür ist.217Das Sitzungsdetails-Panel ist eine Gruppe von Karten neben dem Chat, die anzeigen, wo die Sitzung läuft, was sie geändert hat, was sie gerade ausführt und wie viel Kontext sie nutzt. Das Panel erscheint, nachdem Sie eine Sitzung gestartet haben, sofern der Chat breit genug dafür ist.

218 218 

219#### Sitzungsdetails-Panel aus- oder einblenden219#### Sitzungsdetails-Panel aus- oder einblenden

220 220 


298 298 

299### Überprüfen Sie die Nutzung299### Überprüfen Sie die Nutzung

300 300 

301Klicken Sie auf den Nutzungsring neben dem Modell-Wahlschalter, um Ihre aktuelle Kontextfenster-Nutzung und Ihre Plan-Nutzung für den Zeitraum zu sehen. Die Kontext-Nutzung ist pro Sitzung; die Plan-Nutzung wird über alle Ihre Claude-Code-Oberflächen hinweg geteilt.301Um zu sehen, wie voll das Kontextfenster dieser Sitzung ist, ermitteln Sie das Layout Ihrer Code-Registerkarte:

302 

303* **Aktuelles Layout**: Die Kopfzeile der Karte **Kontext** im [Sitzungsdetails-Panel](#see-session-details) zeigt es als Prozentwert an. Öffnen Sie die Karte, um nach Kategorie zu sehen, was das Fenster belegt.

304* **[Früheres Layout](#check-which-layout-you-have)**: Klicken Sie auf den Nutzungsring neben dem Modell-Wahlschalter. Sein Popover zeigt Ihre Kontextfenster-Nutzung an.

305 

306Geben Sie in beiden Layouts `/context` in das Eingabefeld ein, um im Chat eine Aufschlüsselung des Kontextfensters dieser Sitzung nach Kategorien auszugeben.

307 

308Beide Layouts haben den Nutzungsring neben dem Modell-Wahlschalter. Klicken Sie darauf, um Ihre Plan-Nutzung zu sehen, die über alle Ihre Claude-Code-Oberflächen hinweg geteilt wird.

302 309 

303## Lassen Sie Claude Ihren Computer verwenden310## Lassen Sie Claude Ihren Computer verwenden

304 311 


370* **Abgelehnte Apps**: Fügen Sie Apps hier hinzu, um sie ohne Aufforderung abzulehnen. Claude kann eine abgelehnte App indirekt durch Aktionen in einer zulässigen App beeinflussen, kann aber nicht direkt mit der abgelehnen App interagieren.377* **Abgelehnte Apps**: Fügen Sie Apps hier hinzu, um sie ohne Aufforderung abzulehnen. Claude kann eine abgelehnte App indirekt durch Aktionen in einer zulässigen App beeinflussen, kann aber nicht direkt mit der abgelehnen App interagieren.

371* **Apps anzeigen, wenn Claude fertig ist**: Wenn Computernutzung nicht im Hintergrund ausgeführt wird, blendet Claude Ihre anderen Fenster aus, während es arbeitet, damit es nur mit der genehmigten App interagiert. Wenn Claude fertig ist, werden ausgeblendete Fenster wiederhergestellt, es sei denn, Sie deaktivieren diese Einstellung.378* **Apps anzeigen, wenn Claude fertig ist**: Wenn Computernutzung nicht im Hintergrund ausgeführt wird, blendet Claude Ihre anderen Fenster aus, während es arbeitet, damit es nur mit der genehmigten App interagiert. Wenn Claude fertig ist, werden ausgeblendete Fenster wiederhergestellt, es sei denn, Sie deaktivieren diese Einstellung.

372 379 

373## Verwalten Sie Sitzungen380## Sitzungen verwalten

374 381 

375Jede Sitzung ist ein unabhängiges Gespräch mit eigenem Kontext und Änderungen. Sie können mehrere Sitzungen parallel ausführen, Seitenchats verzweigen, Claude Ihre anderen Sitzungen überprüfen und Nachrichten senden lassen, Arbeit in die Cloud senden oder Dispatch Sitzungen von Ihrem Telefon aus starten lassen.382Jede Sitzung ist eine unabhängige Konversation mit eigenem Kontext und eigenen Änderungen. Sie können mehrere Sitzungen parallel ausführen, Nebenchats abzweigen, Claude Ihre anderen Sitzungen überprüfen und ihnen Nachrichten senden lassen, Arbeit in die Cloud senden oder Dispatch Sitzungen von Ihrem Telefon aus für Sie starten lassen.

376 383 

377### Arbeiten Sie parallel mit Sitzungen384### Mit Sitzungen parallel arbeiten

378 385 

379Klicken Sie auf **+ New** in der Seitenleiste, oder drücken Sie **Cmd+N** auf macOS oder **Ctrl+N** auf Windows, um an mehreren Aufgaben parallel zu arbeiten. Drücken Sie **Ctrl+Tab** und **Ctrl+Shift+Tab**, um durch Sitzungen in der Seitenleiste zu zyklisieren.386Klicken Sie in der Seitenleiste auf **+ New** oder drücken Sie **Cmd+N** unter macOS bzw. **Ctrl+N** unter Windows, um parallel an mehreren Aufgaben zu arbeiten. Drücken Sie **Ctrl+Tab** und **Ctrl+Shift+Tab**, um durch die Sitzungen in der Seitenleiste zu wechseln.

380 387 

381Um zwei Sitzungen gleichzeitig anzuzeigen, halten Sie **Cmd** auf macOS oder **Ctrl** auf Windows gedrückt und klicken Sie auf eine Sitzung in der Seitenleiste. Die Sitzung wird in einem zweiten Bereich neben dem bereits geöffneten angezeigt. Während die Aufteilung aktiv ist, ersetzt das Klicken auf eine andere Sitzung in der Seitenleiste denjenigen Bereich, der den Fokus hat. Drücken Sie **Cmd+\\** auf macOS oder **Ctrl+\\** auf Windows, um den fokussierten Bereich zu schließen und zu einer einzelnen Sitzung zurückzukehren.388Um zwei Sitzungen gleichzeitig anzuzeigen, halten Sie **Cmd** unter macOS bzw. **Ctrl** unter Windows gedrückt und klicken Sie auf eine Sitzung in der Seitenleiste. Die Sitzung öffnet sich in einem zweiten Bereich neben der bereits geöffneten. Solange die geteilte Ansicht aktiv ist, ersetzt ein Klick auf eine andere Sitzung in der Seitenleiste den Bereich, der den Fokus hat. Drücken Sie **Cmd+\\** unter macOS bzw. **Ctrl+\\** unter Windows, um den fokussierten Bereich zu schließen und zu einer einzelnen Sitzung zurückzukehren.

382 389 

383#### Eine Sitzung in einem eigenen Worktree ausführen390#### Eine Sitzung in einem eigenen Worktree ausführen

384 391 

385Aktivieren Sie in einem Projekt, das ein Git-Repository ist, **Worktree**, bevor Sie eine Sitzung starten, um sie in einem eigenen [Git-Worktree](/docs/de/worktrees) auszuführen, einer isolierten Kopie des Projekts. Standardmäßig ist **Worktree** ausgeschaltet, und Claude arbeitet direkt im Projektordner. Klicken Sie auf das Steuerelement für den Projektordner in der [Zeile unter dem Eingabefeld](#start-a-session) und aktivieren Sie **Worktree**.392Aktivieren Sie in einem Projekt, das ein Git-Repository ist, vor dem Start einer Sitzung **Worktree**, um sie in einem eigenen [Git-Worktree](/docs/de/worktrees) auszuführen, einer isolierten Kopie des Projekts. Standardmäßig ist **Worktree** ausgeschaltet und Claude arbeitet direkt im Projektordner. Klicken Sie auf das Steuerelement für den Projektordner in der [Zeile unter dem Eingabefeld](#start-a-session) und aktivieren Sie **Worktree**.

386 393 

387* **Mit einer [gespeicherten Umgebung](#create-a-saved-environment)**: Legen Sie **Worktree** fest, wenn Sie die Umgebung erstellen oder bearbeiten394* **Mit einer [gespeicherten Umgebung](#create-a-saved-environment)**: Legen Sie **Worktree** fest, wenn Sie die Umgebung erstellen oder bearbeiten

388* **[Früheres Layout](#check-which-layout-you-have)**: Aktivieren Sie das Kontrollkästchen **worktree** neben dem Branch-Namen oberhalb des Eingabefelds395* **[Früheres Layout](#check-which-layout-you-have)**: Aktivieren Sie das Kontrollkästchen **worktree** neben dem Branch-Namen oberhalb des Eingabefelds

389 396 

390Worktrees werden standardmäßig in `<project-root>/.claude/worktrees/` gespeichert. Um sie stattdessen in einem benutzerdefinierten Verzeichnis zu speichern:397Worktrees werden standardmäßig in `<project-root>/.claude/worktrees/` gespeichert. So speichern Sie sie stattdessen in einem benutzerdefinierten Verzeichnis:

391 398 

392* **Lokale Sitzungen**: Legen Sie **Worktree-Speicherort** in **Einstellungen > Claude Code** fest399* **Lokale Sitzungen**: Legen Sie **Worktree location** unter **Settings > Claude Code** fest

393* **SSH-Sitzungen**: Legen Sie **Worktree-Ordner** in der [SSH-Verbindung](#choose-where-ssh-session-worktrees-go) fest400* **SSH-Sitzungen**: Legen Sie **Worktree folder** in der [SSH-Verbindung](#choose-where-ssh-session-worktrees-go) fest

394 401 

395Sie können auch ein **Branch-Präfix** in **Einstellungen > Claude Code** festlegen. Desktop stellt es jedem Worktree-Branch-Namen voran, was nützlich ist, um von Claude erstellte Branches organisiert zu halten.402Sie können außerdem unter **Settings > Claude Code** ein **Branch prefix** festlegen. Desktop stellt es jedem Worktree-Branch-Namen voran, was hilfreich ist, um von Claude erstellte Branches übersichtlich zu halten.

396 403 

397Um gitignorierte Dateien wie `.env` in neue Worktrees einzubeziehen, erstellen Sie eine [`.worktreeinclude`-Datei](/docs/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstammverzeichnis. Unter [Was Worktrees mit dem Haupt-Checkout teilen](/docs/de/worktrees#what-worktrees-share-with-the-main-checkout) erfahren Sie, woher eine Worktree-Sitzung Projekteinstellungen, Hooks und Skills liest.404Um von Git ignorierte Dateien wie `.env` in neue Worktrees aufzunehmen, erstellen Sie eine [`.worktreeinclude`-Datei](/docs/de/worktrees#copy-gitignored-files-into-worktrees) im Stammverzeichnis Ihres Projekts. Unter [Was Worktrees mit dem Haupt-Checkout teilen](/docs/de/worktrees#what-worktrees-share-with-the-main-checkout) erfahren Sie, woher eine Worktree-Sitzung Projekteinstellungen, Hooks und Skills liest.

398 405 

399> [!NOTE]406> [!NOTE]

400>407>

401> Die Sitzungsisolation erfordert [Git](https://git-scm.com/downloads). Die meisten Macs enthalten Git standardmäßig. Führen Sie `git --version` im Terminal aus, um zu überprüfen. Wenn es eine Versionsnummer ausgibt, ist Git installiert. Wenn Sie auf Git-Fehler stoßen, bitten Sie Claude im [Cowork-Tab](https://claude.com/product/cowork), Ihnen bei der Behebung Ihres Setups zu helfen.408> Die Sitzungsisolierung erfordert [Git](https://git-scm.com/downloads). Auf den meisten Macs ist Git standardmäßig installiert. Führen Sie `git --version` im Terminal aus, um dies zu prüfen; wenn eine Versionsnummer ausgegeben wird, ist Git installiert. Wenn Git-Fehler auftreten, bitten Sie Claude in [Cowork](https://claude.com/product/cowork), Ihnen bei der Fehlerbehebung Ihrer Einrichtung zu helfen.

402 409 

403### Ordner zu einer Sitzung hinzufügen410### Ordner zu einer Sitzung hinzufügen

404 411 

405Fügen Sie Ordner hinzu, bevor die Sitzung startet oder während sie läuft:412Fügen Sie Ordner vor dem Start der Sitzung oder während ihrer Ausführung hinzu:

406 413 

407* **Bevor eine lokale Sitzung startet**: Fügen Sie die Ordner unter **Folders** hinzu, wenn Sie [eine gespeicherte Umgebung erstellen](#create-a-saved-environment) oder bearbeiten, und [starten Sie die Sitzung dann aus dieser gespeicherten Umgebung](#use-edit-or-remove-a-saved-environment).414* **Vor dem Start einer lokalen Sitzung**: Fügen Sie die Ordner unter **Folders** hinzu, wenn Sie [eine gespeicherte Umgebung erstellen](#create-a-saved-environment) oder bearbeiten, und [starten Sie dann die Sitzung aus dieser gespeicherten Umgebung](#use-edit-or-remove-a-saved-environment).

408* **Während eine lokale oder [SSH](#ssh-sessions)-Sitzung läuft**: Klicken Sie auf **+** neben dem Eingabefeld und wählen Sie **Add folder**. Claude arbeitet direkt in diesem Ordner, ohne [Worktree](#run-a-session-in-its-own-worktree).415* **Während eine lokale oder [SSH](#ssh-sessions)-Sitzung läuft**: Klicken Sie neben dem Eingabefeld auf **+** und wählen Sie **Add folder**. Claude arbeitet direkt in diesem Ordner, ohne [Worktree](#run-a-session-in-its-own-worktree).

409 416 

410### Eine Sitzung archivieren417### Eine Sitzung archivieren

411 418 

412Bevor Sie eine Sitzung archivieren, deren Worktree nicht committete Änderungen enthält, lesen Sie [Nicht committete Änderungen beim Archivieren einer Sitzung behalten](#keep-uncommitted-changes-when-a-session-is-archived). Um eine Sitzung zu archivieren, fahren Sie mit der Maus in der Seitenleiste über die Sitzung, öffnen Sie ihr Menü und wählen Sie **Archive**. Die Sitzung wird in Ihre [archivierten Sitzungen](#organize-and-find-sessions) verschoben.419Bevor Sie eine Sitzung archivieren, deren Worktree nicht committete Änderungen enthält, lesen Sie [Nicht committete Änderungen beim Archivieren einer Sitzung behalten](#keep-uncommitted-changes-when-a-session-is-archived). Um eine Sitzung zu archivieren, bewegen Sie den Mauszeiger in der Seitenleiste darüber, öffnen Sie ihr Menü und wählen Sie **Archive**. Die Sitzung wird in Ihre [archivierten Sitzungen](#organize-and-find-sessions) verschoben.

413 420 

414Um Sitzungen automatisch zu archivieren, wenn ihr Pull Request gemergt oder geschlossen wird, schalten Sie **Auto-Archivieren nach PR-Merge oder -Schließung** in **Einstellungen > Claude Code** ein. Cloud-Sitzungen und Sitzungen, die noch laufen, werden nicht automatisch archiviert.421Damit sich Sitzungen selbst archivieren, wenn ihr Pull Request gemergt oder geschlossen wird, aktivieren Sie **Auto-archive after PR merge or close** unter **Settings > Claude Code**. Cloud-Sitzungen und Sitzungen, die noch laufen, archivieren sich nicht selbst.

415 422 

416#### Nicht committete Änderungen beim Archivieren einer Sitzung behalten423#### Nicht committete Änderungen beim Archivieren einer Sitzung behalten

417 424 

418Nicht committete Änderungen im Worktree einer Sitzung können beim Archivieren der Sitzung verloren gehen. Committen Sie daher zuerst, was Sie behalten möchten:425Nicht committete Änderungen im Worktree einer Sitzung können beim Archivieren der Sitzung verloren gehen. Committen Sie daher zuerst, was Sie behalten möchten:

419 426 

420* **Wenn Desktop nach den Änderungen fragt**: Wählen Sie **Archive anyway**, um sie zu verwerfen, oder brechen Sie ab und committen Sie sie427* **Wenn Desktop nach den Änderungen fragt**: Wählen Sie **Archive anyway**, um sie zu verwerfen, oder brechen Sie ab und committen Sie sie

421* **Wenn die einzigen Änderungen nicht verfolgte Dateien sind**: Committen Sie diejenigen, die Sie behalten möchten, bevor ein Pull Request gemergt wird, den Claude in der Sitzung geöffnet hat, da Desktop sie dann ohne Nachfrage löschen kann428* **Wenn die einzigen Änderungen nicht nachverfolgte Dateien sind**: Committen Sie diejenigen, die Sie behalten möchten, bevor ein Pull Request gemergt wird, den Claude in der Sitzung geöffnet hat, da Desktop sie dann ohne Nachfrage löschen kann

422* **In allen anderen Fällen**: Der Worktree bleibt mit seinen Änderungen auf dem Datenträger erhalten. Bei einer lokalen Sitzung entfernt Desktop beides etwa 30 Tage nachdem die Sitzung archiviert wurde oder Sie sie zuletzt geöffnet haben, je nachdem, was später eintritt. Um die Änderungen zu behalten, öffnen Sie die Sitzung über die [Registerkarte **Archived**](#organize-and-find-sessions) und wählen Sie **Unarchive**429* **In allen anderen Fällen**: Der Worktree bleibt mit seinen Änderungen auf dem Datenträger erhalten. Bei einer lokalen Sitzung entfernt Desktop beides etwa 30 Tage, nachdem die Sitzung archiviert wurde oder Sie sie zuletzt geöffnet haben, je nachdem, was später eintritt. Um die Änderungen zu behalten, öffnen Sie die Sitzung über den [Tab **Archived**](#organize-and-find-sessions) und wählen Sie **Unarchive**

423 430 

424### Sitzungen organisieren und finden431### Sitzungen organisieren und finden

425 432 

426Sie gruppieren, sortieren und finden Sitzungen über ein Symbol in der Sitzungsliste der Seitenleiste:433Sie gruppieren, sortieren und finden Sitzungen über ein Symbol in der Sitzungsliste der Seitenleiste:

427 434 

428* **Aktuelles Layout**: Fahren Sie mit der Maus über eine Überschrift in der Sitzungsliste, um das Symbol **Group and sort** anzuzeigen, und klicken Sie darauf. Um archivierte Sitzungen zu finden, wählen Sie **View all**, die letzte Zeile des Menüs, und öffnen Sie dann die Registerkarte **Archived**.435* **Aktuelles Layout**: Bewegen Sie den Mauszeiger über eine Überschrift in der Sitzungsliste, um das Symbol **Group and sort** anzuzeigen, und klicken Sie darauf. Um archivierte Sitzungen zu finden, wählen Sie **View all**, die letzte Zeile des Menüs, und öffnen Sie dann den Tab **Archived**.

429* **[Früheres Layout](#check-which-layout-you-have)**: Das Symbol **Filter** wird ohne Überfahren mit der Maus angezeigt. Klicken Sie darauf, um die Liste mit **Group by** oder **Sort by** anzuordnen. Um archivierte Sitzungen anzuzeigen, wählen Sie **Status** und dann **Archived**.436* **[Früheres Layout](#check-which-layout-you-have)**: Das Symbol **Filter** wird ohne Mauszeigerbewegung angezeigt. Klicken Sie darauf, um die Liste mit **Group by** oder **Sort by** anzuordnen. Um archivierte Sitzungen anzuzeigen, wählen Sie **Status** und dann **Archived**.

430 437 

431Um eine Sitzung umzubenennen, öffnen Sie sie und klicken Sie auf den Sitzungstitel in der Titelleiste.438Um eine Sitzung umzubenennen, öffnen Sie sie und klicken Sie in der Titelleiste auf den Sitzungstitel.

432 439 

433### Kontext überprüfen und freigeben440### Kontext prüfen und freigeben

434 441 

435Um die Kontext-Nutzung zu überprüfen, siehe [Überprüfen Sie die Nutzung](#check-usage). Wenn der Kontext voll wird, fasst Claude das Gespräch automatisch zusammen und arbeitet weiter. Sie können auch `/compact` eingeben, um die Zusammenfassung früher auszulösen und Kontextraum freizugeben. Siehe [das Kontextfenster](/docs/de/how-claude-code-works#the-context-window) für Details, wie die Komprimierung funktioniert.442Informationen zur Prüfung der Kontextnutzung finden Sie unter [Nutzung prüfen](#check-usage). Wenn sich der Kontext füllt, fasst Claude die Konversation automatisch zusammen und arbeitet weiter. Sie können auch `/compact` eingeben, um die Zusammenfassung früher auszulösen und Kontextplatz freizugeben. Unter [Das Kontextfenster](/docs/de/how-claude-code-works#the-context-window) finden Sie Details zur Funktionsweise der Komprimierung.

436 443 

437### Benachrichtigung erhalten, wenn eine Sitzung abgeschlossen ist444### Benachrichtigung erhalten, wenn eine Sitzung abgeschlossen ist

438 445 

439Die Desktop-App sendet eine Betriebssystem-Benachrichtigung, wenn eine Code-Sitzung eine Aufgabe abschließt und Sie diese Sitzung gerade nicht anzeigen. Für Sitzungen, die zu einem [Projekt](/docs/de/claude-projects#see-what-needs-you-in-overview) gehören, erhalten Sie stattdessen die Benachrichtigungen des Projekts.446Die Desktop-App sendet eine Betriebssystembenachrichtigung, wenn eine Code-Sitzung eine Aufgabe abschließt und Sie diese Sitzung gerade nicht ansehen. Für Sitzungen, die zu einem [Projekt](/docs/de/claude-projects#see-what-needs-you-in-overview) gehören, erhalten Sie stattdessen die Benachrichtigungen des Projekts.

440 447 

441### Fragen Sie eine Seitenfrage, ohne die Sitzung zu entgleisen448### Eine Nebenfrage stellen, ohne die Sitzung zu stören

442 449 

443Ein Seitenchat ermöglicht es Ihnen, Claude eine Frage zu stellen, die den Kontext Ihrer Sitzung nutzt, aber nichts zum Hauptgespräch hinzufügt. Verwenden Sie ihn, wenn Sie ein Stück Code verstehen, eine Annahme überprüfen oder eine Idee erkunden möchten, ohne die Sitzung vom Kurs abzubringen.450Mit einem Nebenchat können Sie Claude eine Frage stellen, die den Kontext Ihrer Sitzung nutzt, aber nichts zur Hauptkonversation hinzufügt. Verwenden Sie ihn, wenn Sie ein Stück Code verstehen, eine Annahme prüfen oder eine Idee erkunden möchten, ohne die Sitzung vom Kurs abzubringen.

444 451 

445Drücken Sie **Cmd+;** auf macOS oder **Ctrl+;** auf Windows, um einen Seitenchat zu öffnen, oder geben Sie `/btw` im Eingabefeld ein. Der Seitenchat kann alles im Hauptthread bis zu diesem Punkt lesen. Wenn Sie fertig sind, schließen Sie den Seitenchat und setzen Sie die Hauptsitzung dort fort, wo Sie aufgehört haben.452Drücken Sie **Cmd+;** unter macOS bzw. **Ctrl+;** unter Windows, um einen Nebenchat zu öffnen, oder geben Sie `/btw` in das Eingabefeld ein. Der Nebenchat kann alles im Hauptthread bis zu diesem Zeitpunkt lesen. Wenn Sie fertig sind, schließen Sie den Nebenchat und setzen Sie die Hauptsitzung dort fort, wo Sie aufgehört haben.

446 453 

447Seitenchats sind in lokalen, SSH- und WSL-Sitzungen verfügbar. Die Desktop-App speichert Seitenchats nicht auf der Festplatte, daher können Sie nach dem Schließen der App nicht zu einem zurückkehren.454Nebenchats sind in lokalen, SSH- und WSL-Sitzungen verfügbar. Die Desktop-App speichert Nebenchats nicht auf dem Datenträger, sodass Sie nach dem Schließen der App nicht zu einem zurückkehren können.

448 455 

449### Beobachten Sie Hintergrundaufgaben456### Hintergrundaufgaben beobachten

450 457 

451Das Aufgaben-Pane zeigt die Hintergrundarbeit, die in der aktuellen Sitzung läuft: Subagenten, Hintergrund-Shell-Befehle und [dynamische Workflows](/docs/de/workflows). Sobald die Sitzung Hintergrundarbeit hat, öffnen Sie das Pane über **Hintergrundaufgaben** im Menü **⋮** der Titelleiste.458Der Aufgabenbereich zeigt die Hintergrundarbeit, die innerhalb der aktuellen Sitzung läuft: Subagenten, Shell-Befehle im Hintergrund und [dynamische Workflows](/docs/de/workflows). Sobald die Sitzung Hintergrundarbeit hat, öffnen Sie den Bereich über **Background tasks** im Menü **⋮** der Titelleiste.

452 459 

453Klicken Sie auf einen beliebigen Eintrag, um seine Ausgabe im Subagent-Pane zu sehen oder ihn zu stoppen. Um zu sehen, was andere Sitzungen tun, verwenden Sie die [Seitenleiste](#work-in-parallel-with-sessions), oder bitten Sie Claude, [sie für Sie zu überprüfen](#work-across-sessions).460Klicken Sie auf einen beliebigen Eintrag, um seine Ausgabe im Subagenten-Bereich zu sehen oder ihn zu stoppen. Um zu sehen, was andere Sitzungen tun, verwenden Sie die [Seitenleiste](#work-in-parallel-with-sessions) oder bitten Sie Claude, [sie für Sie zu überprüfen](#work-across-sessions).

454 461 

455### Arbeiten Sie sitzungsübergreifend462### Sitzungsübergreifend arbeiten

456 463 

457Claude kann Ihre anderen Code-Tab-Sitzungen auflisten, lesen, was jede getan hat, und Nachrichten zwischen ihnen senden. Fragen Sie in natürlicher Sprache: „Welche Sitzung hat die Auth-Umgestaltung berührt?“, „Zu welchem Ergebnis ist die API-Sitzung gekommen?“ oder „Teilen Sie der Zahlungs-Sitzung mit, dass sich das Schema geändert hat“.464Claude kann Ihre anderen Sitzungen im Code-Tab auflisten, lesen, woran jede gearbeitet hat, und Nachrichten zwischen ihnen senden. Fragen Sie in natürlicher Sprache: „Welche Sitzung hat das Auth-Refactoring angefasst?“, „Zu welchem Ergebnis ist die API-Sitzung gekommen?“ oder „Sag der Payments-Sitzung, dass sich das Schema geändert hat“.

458 465 

459Sie können Claude auch bitten, eine Sitzung umzubenennen oder zu archivieren. Bitten Sie es zum Beispiel, die Sitzungen zu archivieren, deren PRs gemergt wurden.466Sie können Claude auch bitten, eine Sitzung umzubenennen oder zu archivieren. Bitten Sie es beispielsweise, die Sitzungen zu archivieren, deren PRs gemergt wurden.

460 467 

461Über diese Oberfläche sieht Claude nur die Sitzungen, die die Desktop-App selbst ausführt: lokale, [SSH](#ssh-sessions) und [WSL](/docs/de/desktop-wsl) Sitzungen im Code-Tab. Claude sieht keine Cloud-Sitzungen oder Sitzungen, die Sie vom Terminal CLI oder der VS Code-Erweiterung gestartet haben, auch nicht in Worktrees desselben Projekts. Mit neun Terminal-Worktrees offen und zwei Desktop-Sitzungen meldet Claude, das in einer von ihnen antwortet, die eine andere Desktop-Sitzung. Claude listet niemals die Sitzung auf, von der aus Sie fragen. Standardmäßig sieht es die 20 zuletzt aktiven Sitzungen und überspringt archivierte Sitzungen, es sei denn, Sie fragen danach. [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) ermöglicht Claude separat, [Ihre anderen Claude Code-Sitzungen](/docs/de/cross-session-messaging#see-which-sessions-claude-can-reach) zu kontaktieren, einschließlich Terminal-Sitzungen.468Über diese Oberfläche sieht Claude nur die Sitzungen, die die Desktop-App selbst ausführt: lokale, [SSH](#ssh-sessions)- und [WSL](/docs/de/desktop-wsl)-Sitzungen im Code-Tab. Claude sieht keine Cloud-Sitzungen oder Sitzungen, die Sie über die Terminal-CLI oder die VS Code-Erweiterung gestartet haben, auch nicht in Worktrees desselben Projekts. Wenn also neun Terminal-Worktrees und zwei Desktop-Sitzungen geöffnet sind, meldet Claude in einer davon die eine andere Desktop-Sitzung. Claude listet nie die Sitzung auf, aus der Sie fragen. Standardmäßig sieht es die 20 zuletzt aktiven Sitzungen und überspringt archivierte Sitzungen, sofern Sie nicht danach fragen. Mit [sitzungsübergreifendem Messaging](/docs/de/cross-session-messaging) kann Claude separat [Ihren anderen Claude Code-Sitzungen](/docs/de/cross-session-messaging#see-which-sessions-claude-can-reach) Nachrichten senden, einschließlich Terminal-Sitzungen.

462 469 

463Wenn Claude eine andere Sitzung über diese Oberfläche kontaktiert, zeigt Claude Code sie dort als eine Karte an, die mit dem Titel der sendenden Sitzung gekennzeichnet ist und einen Link zurück enthält, damit Sie immer sehen können, woher eine Nachricht kam. Wenn die empfangende Sitzung gerade eine Aufgabe ausführt, hält Claude Code die Nachricht und Claude liest sie, sobald die aktuelle Arbeit beendet ist. Der empfangende Claude kann antworten, und Claude Code liefert die Antwort über diese Oberfläche zurück. Claude kann nicht an eine archivierte Sitzung liefern und teilt Ihnen mit, wenn eine Nachricht nicht durchkommt.470Wenn Claude über diese Oberfläche einer anderen Sitzung eine Nachricht sendet, zeigt Claude Code sie dort als Karte an, die mit dem Titel der sendenden Sitzung und einem Rücklink beschriftet ist, sodass Sie immer erkennen können, woher eine Nachricht stammt. Wenn die empfangende Sitzung gerade mitten in einer Aufgabe ist, hält Claude Code die Nachricht zurück und Claude liest sie, sobald die aktuelle Arbeit abgeschlossen ist. Das empfangende Claude kann antworten, und Claude Code stellt die Antwort über diese Oberfläche zurück zu. Claude kann keine Nachrichten an eine archivierte Sitzung zustellen und teilt Ihnen mit, wenn eine Nachricht nicht ankommt.

464 471 

465Claude Code wendet vier Sicherheitsverhalten sitzungsübergreifend an:472Claude Code wendet sitzungsübergreifend drei Sicherheitsmechanismen an:

466 473 

467* Sie erhalten eine Genehmigungskarte, bevor Claude eine Sitzung archiviert, außer im Auto-Modus und im Bypass-Permissions-Modus, in denen Claude eine Sitzung ohne Genehmigungskarte archivieren kann. Wenn Sie gefragt werden möchten, wechseln Sie zu Manual.474* Sie erhalten eine Genehmigungskarte, bevor Claude eine Sitzung archiviert, außer im Auto-Modus und im Bypass-permissions-Modus, in denen Claude eine Sitzung ohne Genehmigungskarte archivieren kann. Um gefragt zu werden, wechseln Sie zu Manual.

468* Über diese Oberfläche kann Claude keine sitzungsübergreifenden Nachrichten von einer Sitzung senden, die niemand beobachtet, z. B. eine geplante Aufgabenausführung, und kann nicht in eine liefern.475* Claude Code prüft jede Nachricht von dieser Oberfläche anhand der [Steuerung eingehender Nachrichten](/docs/de/cross-session-messaging#control-inbound-messages) der empfangenden Sitzung, auch wenn die empfangende Sitzung selbst kein [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging#availability) hat. Wenn Sie [`crossSessionInbound`](/docs/de/settings-reference#crosssessioninbound) in der empfangenden Sitzung auf `refuse` setzen, verwirft Claude Code Nachrichten von dieser Oberfläche. Claude Code meldet diese Ablehnung an die Claude Desktop-App. Vor v2.1.234 verwarf Claude Code jede Nachricht von dieser Oberfläche an eine empfangende Sitzung ohne sitzungsübergreifendes Messaging.

469* Claude Code überprüft jede Nachricht von dieser Oberfläche gegen die [eingehenden Steuerelemente](/docs/de/cross-session-messaging#control-inbound-messages) der empfangenden Sitzung, auch wenn die empfangende Sitzung nicht über [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging#availability) selbst verfügt. Wenn Sie [`crossSessionInbound`](/docs/de/settings-reference#crosssessioninbound) in der empfangenden Sitzung auf `refuse` setzen, verwirft Claude Code Nachrichten von dieser Oberfläche. Claude Code meldet die Ablehnung der Claude Desktop-App. Vor v2.1.234 verwarf Claude Code jede Nachricht von dieser Oberfläche an eine empfangende Sitzung ohne sitzungsübergreifendes Messaging.476* Claude Code zitiert jede eingehende Nachricht und ordnet sie der Sitzung zu, die sie gesendet hat, und Claude befolgt beim Handeln auf eine Nachricht weiterhin die eigenen Berechtigungseinstellungen der empfangenden Sitzung.

470* Claude Code zitiert jede eingehende Nachricht und schreibt sie der Sitzung zu, die sie gesendet hat, und Claude befolgt immer noch die eigenen Berechtigungseinstellungen der empfangenden Sitzung, wenn er auf eine eingeht.

471 477 

472Claude kann auch neue Sitzungen vorschlagen. Wenn es etwas bemerkt, das es wert ist, behoben zu werden und das außerhalb des Umfangs der aktuellen Aufgabe liegt, bietet es die Arbeit als Task-Chip im Chat an. Klicken Sie auf den Chip, um diese Arbeit in einer neuen Sitzung mit eigenem Worktree zu starten. Claude setzt Ihre aktuelle Sitzung ungestört fort.478Claude kann auch neue Sitzungen vorschlagen. Wenn es etwas bemerkt, das es wert ist, behoben zu werden, aber außerhalb des Umfangs der aktuellen Aufgabe liegt, bietet es die Arbeit als Aufgaben-Chip im Chat an. Klicken Sie auf den Chip, um diese Arbeit in einer neuen Sitzung mit eigenem Worktree zu starten; Claude setzt Ihre aktuelle Sitzung ohne Unterbrechung fort.

473 479 

474### Führen Sie lange laufende Aufgaben in der Cloud aus480### Lang laufende Aufgaben in der Cloud ausführen

475 481 

476Für große Umgestaltungen, Test-Suites, Migrationen oder andere lange laufende Aufgaben wählen Sie beim Starten einer Sitzung im [Umgebungswähler](#start-a-session) eine Umgebung unter **Cloud** aus. Cloud-Sitzungen laufen standardmäßig auf von Anthropic verwalteter Infrastruktur und werden fortgesetzt, auch wenn Sie die App schließen oder Ihren Computer herunterfahren. Überprüfen Sie jederzeit den Fortschritt oder lenken Sie Claude in eine andere Richtung. Sie können Cloud-Sitzungen auch von [claude.ai/code](https://claude.ai/code) oder der [Claude Mobile-App](/docs/de/mobile) aus überwachen.482Für große Refactorings, Test-Suites, Migrationen oder andere lang laufende Aufgaben wählen Sie beim Start einer Sitzung im [Umgebungsselektor](#start-a-session) eine Umgebung unter **Cloud**. Cloud-Sitzungen laufen standardmäßig auf von Anthropic verwalteter Infrastruktur und werden fortgesetzt, auch wenn Sie die App schließen oder Ihren Computer herunterfahren. Schauen Sie jederzeit wieder vorbei, um den Fortschritt zu sehen oder Claude in eine andere Richtung zu lenken. Sie können Cloud-Sitzungen auch über [claude.ai/code](https://claude.ai/code) oder die [Claude-Mobil-App](/docs/de/mobile) überwachen.

477 483 

478Cloud-Sitzungen unterstützen auch mehrere Repositorys. Wählen Sie die Repositorys aus:484Cloud-Sitzungen unterstützen außerdem mehrere Repositorys. Wählen Sie die Repositorys aus:

479 485 

480* **Aktuelles Layout**: in der Zeile unter dem Eingabefeld, sobald Sie eine Cloud-Umgebung ausgewählt haben.486* **Aktuelles Layout**: in der Zeile unter dem Eingabefeld, sobald Sie eine Cloud-Umgebung ausgewählt haben.

481* **[Früheres Layout](#check-which-layout-you-have)**: oberhalb des Eingabefelds. Um ein weiteres Repository hinzuzufügen, klicken Sie auf **+** neben dem ausgewählten.487* **[Früheres Layout](#check-which-layout-you-have)**: oberhalb des Eingabefelds. Um ein weiteres Repository hinzuzufügen, klicken Sie auf **+** neben dem ausgewählten.

482 488 

483Siehe [Claude Code in der Cloud verwenden](/docs/de/claude-code-on-the-web) für mehr darüber, wie Cloud-Sitzungen funktionieren. Wenn ein Körper von Arbeit viele Cloud-Sitzungen benötigt, wählen Sie **Projekte** in der Seitenleiste, um ein [Projekt](/docs/de/claude-projects) zu erstellen, in dem Claude die Sitzungen für Sie aus einem Gespräch heraus startet und verfolgt.489Unter [Claude Code in der Cloud verwenden](/docs/de/claude-code-on-the-web) erfahren Sie mehr über die Funktionsweise von Cloud-Sitzungen. Wenn ein Arbeitspaket viele Cloud-Sitzungen benötigt, wählen Sie **Projects** in der Seitenleiste, um ein [Projekt](/docs/de/claude-projects) zu erstellen, in dem Claude die Sitzungen für Sie aus einer einzigen Konversation heraus startet und nachverfolgt.

484 490 

485> [!NOTE]491> [!NOTE]

486>492>

487> Eine Aufgabe in einer [SSH-Sitzung](#ssh-sessions) kann ebenfalls [weiterlaufen, während Desktop getrennt ist](#keep-a-task-running-while-desktop-is-disconnected), kann jedoch mit einem Claude-Konto anhalten, wenn ihre Anmeldung abläuft.493> Eine Aufgabe in einer [SSH-Sitzung](#ssh-sessions) kann ebenfalls [weiterlaufen, während Desktop getrennt ist](#keep-a-task-running-while-desktop-is-disconnected), mit einem Claude-Konto kann sie jedoch stoppen, wenn ihre Anmeldung abläuft.

488 494 

489### Fortsetzen auf einer anderen Oberfläche495### Auf einer anderen Oberfläche fortfahren

490 496 

491Um eine Sitzung an anderer Stelle fortzusetzen, öffnen Sie das Sitzungsmenü über das Caret-Symbol neben dem Sitzungstitel oder über die Zeile der Sitzung in der Seitenleiste und wählen Sie dann **Öffnen in**:497Um eine Sitzung an anderer Stelle fortzusetzen, öffnen Sie das Sitzungsmenü über das Caret-Symbol neben dem Sitzungstitel oder über die Zeile der Sitzung in der Seitenleiste und wählen Sie dann **Open in**:

492 498 

493* Wählen Sie **Cloud**, um die Sitzung als [Cloud-Sitzung](/docs/de/claude-code-on-the-web) fortzusetzen, wobei Ihre Konversation als Zusammenfassung übernommen wird. Bevor Sie bestätigen, gibt der Dialog an, ob auch Ihre Dateien verschoben werden und ob diese Sitzung archiviert wird, sobald die Cloud-Sitzung bereit ist. Eine Sitzung, die über [SSH](#ssh-sessions) oder in [WSL](/docs/de/desktop-wsl) läuft, können Sie auf diese Weise nicht verschieben.499* Wählen Sie **Cloud**, um die Sitzung als [Cloud-Sitzung](/docs/de/claude-code-on-the-web) fortzusetzen, wobei Ihre Konversation als Zusammenfassung übernommen wird. Bevor Sie bestätigen, gibt der Dialog an, ob Ihre Dateien ebenfalls verschoben werden und ob diese Sitzung archiviert wird, sobald die Cloud-Sitzung bereit ist. Eine Sitzung, die über [SSH](#ssh-sessions) oder in [WSL](/docs/de/desktop-wsl) läuft, können Sie auf diese Weise nicht verschieben.

494* Wählen Sie einen installierten Editor oder Ihren Dateimanager, um den Ordner der Sitzung auf dem Datenträger dort zu öffnen.500* Wählen Sie einen installierten Editor oder Ihren Dateimanager, um den Ordner der Sitzung auf dem Datenträger dort zu öffnen.

495 501 

496### Steuern, welche Sitzungen auf Ihren anderen Geräten erscheinen502### Steuern, welche Sitzungen auf Ihren anderen Geräten angezeigt werden

497 503 

498Eine lokale Sitzung wird auf Ihren anderen Geräten angezeigt, sobald [Remote Control](/docs/de/remote-control) sie verbindet. Eine verbundene Sitzung erscheint in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code) und in den Claude-Apps auf Geräten, die bei Ihrem claude.ai-Konto angemeldet sind.504Eine lokale Sitzung wird auf Ihren anderen Geräten angezeigt, sobald [Remote Control](/docs/de/remote-control) sie verbindet. Eine verbundene Sitzung erscheint in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code) und in den Claude-Apps auf Geräten, die bei Ihrem claude.ai-Konto angemeldet sind.

499 505 

500Eine lokale Sitzung wird verbunden, wenn Sie Remote Control für sie einschalten oder wenn sie sich beim Start automatisch verbindet:506Eine lokale Sitzung wird verbunden, wenn Sie Remote Control für sie einschalten oder wenn sie sich beim Start automatisch verbindet:

501 507 

502* **Sie schalten es für diese Sitzung ein**: mit dem Schalter **Remote Control** der Sitzung oder durch Eingabe von `/remote-control` in ihrem Eingabefeld.508* **Sie schalten es für diese Sitzung ein**: mit dem Schalter **Remote Control** der Sitzung oder durch Eingabe von `/remote-control` in ihr Eingabefeld.

503* **Sie verbindet sich beim Start**: Neue Sitzungen verbinden sich automatisch, solange **Neue Sitzungen mit Remote Control verbinden** in **Einstellungen > Claude Code** eingeschaltet ist. Wenn Sie diese Einstellung nie geändert haben, richtet sich Desktop nach [`remoteControlAtStartup`](/docs/de/settings-reference#remotecontrolatstartup) in Ihren Benutzereinstellungen oder verwalteten Einstellungen und anschließend nach dem Standard Ihrer Organisation.509* **Sie verbindet sich beim Start**: Neue Sitzungen verbinden sich automatisch, solange **Connect new sessions to Remote Control** unter **Settings > Claude Code** eingeschaltet ist. Wenn Sie diese Einstellung nie geändert haben, folgt Desktop [`remoteControlAtStartup`](/docs/de/settings-reference#remotecontrolatstartup) in Ihren Benutzer- oder verwalteten Einstellungen und danach der Standardeinstellung Ihrer Organisation.

504 510 

505Um zu sehen, ob eine Sitzung verbunden ist, prüfen Sie den Schalter **Remote Control** in der Karte **Environment** im [Sitzungsdetailbereich](#see-session-details) der Sitzung.511Um zu sehen, ob eine Sitzung verbunden ist, prüfen Sie den Schalter **Remote Control** in der Karte **Environment** des [Sitzungsdetailbereichs](#see-session-details).

506 512 

507Um Sitzungen von Ihren anderen Geräten fernzuhalten, schalten Sie Remote Control auf der benötigten Ebene aus:513Um Sitzungen von Ihren anderen Geräten fernzuhalten, schalten Sie Remote Control auf der gewünschten Ebene aus:

508 514 

509* **Eine Sitzung**: Schalten Sie ihren Schalter **Remote Control** aus. In einer Sitzung, die sich beim Start verbunden hat, lässt die Eingabe von `/remote-control` Remote Control eingeschaltet und zeigt `Remote Control is already on. This session connected automatically when it started.` an. Klicken Sie in dieser Zeile auf **Turn off**, um die Verbindung zu trennen.515* **Eine Sitzung**: Schalten Sie ihren Schalter **Remote Control** aus. In einer Sitzung, die sich beim Start verbunden hat, lässt die Eingabe von `/remote-control` Remote Control eingeschaltet und zeigt `Remote Control is already on. This session connected automatically when it started.` an. Klicken Sie in dieser Zeile auf **Turn off**, um die Verbindung zu trennen.

510* **Neue Desktop-Sitzungen auf diesem Computer**: Schalten Sie **Neue Sitzungen mit Remote Control verbinden** in **Einstellungen > Claude Code** aus. Wenn die Option bereits als ausgeschaltet angezeigt wird, schalten Sie sie ein und wieder aus, damit Desktop Ihre Auswahl speichert. Nach dem Speichern hat sie Vorrang vor `remoteControlAtStartup` und den Standardwerten.516* **Neue Desktop-Sitzungen auf diesem Computer**: Schalten Sie **Connect new sessions to Remote Control** unter **Settings > Claude Code** aus. Wenn die Einstellung bereits als ausgeschaltet angezeigt wird, schalten Sie sie ein und wieder aus, damit Desktop Ihre Auswahl speichert. Nach dem Speichern hat sie Vorrang vor `remoteControlAtStartup` und den Standardwerten.

511* **Jede Sitzung auf diesem Computer, einschließlich der CLI**: Setzen Sie [`disableRemoteControl`](/docs/de/settings-reference#disableremotecontrol) in `~/.claude/settings.json` auf `true`, um zu verhindern, dass sich Sitzungen verbinden. Eine Sitzung, die beim Speichern der Datei bereits verbunden war, bleibt verbunden, bis Sie Remote Control für sie ausschalten.517* **Jede Sitzung auf diesem Computer, einschließlich der CLI**: Setzen Sie [`disableRemoteControl`](/docs/de/settings-reference#disableremotecontrol) in `~/.claude/settings.json` auf `true`, um zu verhindern, dass sich Sitzungen verbinden. Eine Sitzung, die beim Speichern der Datei bereits verbunden war, bleibt verbunden, bis Sie Remote Control für sie ausschalten.

512 518 

513Um eine Sitzung auszublenden, die bereits auf Ihren anderen Geräten erscheint, archivieren Sie sie in Desktop. Desktop archiviert auch die Remote-Control-Kopie der Sitzung, sodass sie aus der Standard-Sitzungsliste auf diesen Geräten verschwindet. Wie Sie sie dort anzeigen oder löschen, erfahren Sie unter [Sitzungen archivieren](/docs/de/claude-code-on-the-web#archive-sessions).519Um eine Sitzung auszublenden, die bereits auf Ihren anderen Geräten angezeigt wird, archivieren Sie sie in Desktop. Desktop archiviert auch die Remote-Control-Kopie der Sitzung, sodass sie aus der Standard-Sitzungsliste auf diesen Geräten verschwindet. Informationen zum Anzeigen oder Löschen dort finden Sie unter [Sitzungen archivieren](/docs/de/claude-code-on-the-web#archive-sessions).

514 520 

515### Sitzungen von Dispatch521### Sitzungen aus Dispatch

516 522 

517[Dispatch](https://support.claude.com/en/articles/13947068) ist ein persistentes Gespräch mit Claude, das in der Registerkarte [Cowork](https://claude.com/product/cowork) lebt. Sie senden Dispatch eine Aufgabe, und es entscheidet, wie damit umzugehen ist.523[Dispatch](https://support.claude.com/en/articles/13947068) ist eine dauerhafte Konversation mit Claude, die in [Cowork](https://claude.com/product/cowork) angesiedelt ist. Sie senden Dispatch eine Aufgabe, und Dispatch entscheidet, wie sie bearbeitet wird.

518 524 

519Eine Aufgabe kann auf zwei Wegen als Code-Sitzung enden: Sie fragen direkt danach, z. B. „Öffnen Sie eine Claude Code-Sitzung und beheben Sie den Login-Fehler“, oder Dispatch entscheidet, dass die Aufgabe Entwicklungsarbeit ist und startet eine von selbst. Aufgaben, die typischerweise zu Code führen, umfassen das Beheben von Fehlern, das Aktualisieren von Abhängigkeiten, das Ausführen von Tests oder das Öffnen von Pull Requests. Forschung, Dokumentbearbeitung und Tabellenkalkulationsarbeit bleiben in Cowork.525Eine Aufgabe kann auf zwei Arten zu einer Code-Sitzung werden: Sie fordern direkt eine an, etwa „Öffne eine Claude Code-Sitzung und behebe den Login-Bug“, oder Dispatch entscheidet, dass es sich bei der Aufgabe um Entwicklungsarbeit handelt, und startet selbstständig eine. Aufgaben, die typischerweise an Code weitergeleitet werden, sind das Beheben von Bugs, das Aktualisieren von Abhängigkeiten, das Ausführen von Tests oder das Öffnen von Pull Requests. Recherche, Dokumentbearbeitung und Tabellenkalkulationsarbeit bleiben in Cowork.

520 526 

521In jedem Fall wird die Code-Sitzung in der Seitenleiste der Registerkarte „Code“ mit einem **Dispatch**-Badge angezeigt. Sie erhalten eine Push-Benachrichtigung auf Ihrem Telefon, wenn sie fertig ist oder Ihre Genehmigung benötigt.527In beiden Fällen erscheint die Code-Sitzung in der Seitenleiste des Code-Tabs mit einem **Dispatch**-Abzeichen. Sie erhalten eine Push-Benachrichtigung auf Ihrem Telefon, wenn sie abgeschlossen ist oder Ihre Genehmigung benötigt.

522 528 

523Wenn Sie [Computernutzung](#let-claude-use-your-computer) aktiviert haben, können Dispatch-generierte Code-Sitzungen diese auch verwenden. App-Genehmigungen in diesen Sitzungen verfallen nach 30 Minuten und werden erneut angefordert, anstatt die gesamte Sitzung zu dauern wie bei regulären Code-Sitzungen.529Wenn Sie die [Computernutzung](#let-claude-use-your-computer) aktiviert haben, können auch von Dispatch gestartete Code-Sitzungen sie verwenden. App-Genehmigungen in diesen Sitzungen laufen nach 30 Minuten ab und werden erneut abgefragt, anstatt wie bei regulären Code-Sitzungen für die gesamte Sitzung zu gelten.

524 530 

525Für Setup, Pairing und Dispatch-Einstellungen siehe den [Dispatch-Hilfeartikel](https://support.claude.com/en/articles/13947068). Dispatch erfordert einen Pro- oder Max-Plan und ist nicht für Team- oder Enterprise-Pläne verfügbar.531Informationen zu Einrichtung, Kopplung und Dispatch-Einstellungen finden Sie im [Dispatch-Hilfeartikel](https://support.claude.com/en/articles/13947068). Dispatch erfordert einen Pro- oder Max-Plan und ist in Team- oder Enterprise-Plänen nicht verfügbar.

526 532 

527Dispatch ist eine von mehreren Möglichkeiten, mit Claude zu arbeiten, wenn Sie weg von Ihrem Terminal sind. Für einen Vergleich mit den anderen Optionen siehe [Plattformen und Integrationen](/docs/de/platforms#work-when-you-are-away-from-your-terminal).533Dispatch ist eine von mehreren Möglichkeiten, mit Claude zu arbeiten, wenn Sie nicht an Ihrem Terminal sind. Einen Vergleich mit den anderen Optionen finden Sie unter [Plattformen und Integrationen](/docs/de/platforms#work-when-you-are-away-from-your-terminal).

528 534 

529## Claude Code erweitern535## Claude Code erweitern

530 536 

531Verbinden Sie externe Dienste, fügen Sie wiederverwendbare Workflows hinzu, passen Sie Claudes Verhalten an und konfigurieren Sie Vorschauserver. Um Connectors, Skills und Plugins an einem Ort zu verwalten, klicken Sie auf **Anpassen** in der Seitenleiste. Die [Cowork](https://claude.com/product/cowork)-Registerkarte in der Desktop-App bezieht ihre Skills, Plugins und Connectors aus dieser Anpassungskonfiguration, die über Ihr claude.ai-Konto synchronisiert wird, nicht aus dem CLI-Verzeichnis `~/.claude`.537Verbinden Sie externe Dienste, fügen Sie wiederverwendbare Workflows hinzu, passen Sie Claudes Verhalten an und konfigurieren Sie Vorschauserver. Um Konnektoren, Skills und Plugins an einem Ort zu verwalten, klicken Sie auf **Anpassen** in der Seitenleiste. [Cowork](https://claude.com/product/cowork) in der Desktop-App bezieht seine Skills, Plugins und Konnektoren aus dieser Anpassungskonfiguration, die über Ihr claude.ai-Konto synchronisiert wird, nicht aus dem CLI-Verzeichnis `~/.claude`.

532 538 

533Claude Code lädt auch die Skills und Plugins, die für Ihr claude.ai-Konto aktiviert sind, in Terminalsitzungen, in denen Sie sich mit demselben Konto anmelden. Siehe [Skills synchronisiert von claude.ai](/docs/de/skills#how-synced-skills-behave) und [Plugins synchronisiert von claude.ai](/docs/de/plugins/loading#synced-plugins).539Claude Code lädt auch die Skills und Plugins, die für Ihr claude.ai-Konto aktiviert sind, in Terminalsitzungen, in denen Sie sich mit demselben Konto anmelden. Siehe [Skills synchronisiert von claude.ai](/docs/de/skills#how-synced-skills-behave) und [Plugins synchronisiert von claude.ai](/docs/de/plugins/loading#synced-plugins).

534 540 


1659*.livepreview.claude.ai1665*.livepreview.claude.ai

1660claude.com1666claude.com

1661platform.claude.com1667platform.claude.com

1668sso.claude.com

1662*.livepreview.claude.app1669*.livepreview.claude.app

1663*.claudeusercontent.com1670*.claudeusercontent.com

1664*.claudemcpcontent.com1671*.claudemcpcontent.com

Details

21 21 

22### Cowork-Anforderungen22### Cowork-Anforderungen

23 23 

24Cowork ist die Desktop-Registerkarte für [Dispatch und längere agentengestützte Arbeiten](https://claude.com/docs/cowork/overview). Unter Linux führt Cowork diese Aufgaben in einer virtuellen Maschine aus, die die Desktop-App mit QEMU und KVM hostet. Um Cowork zu verwenden, benötigt Ihr Computer:24Cowork ist der Teil der Desktop-App für [Dispatch und längere agentengestützte Arbeiten](https://claude.com/docs/cowork/overview). Unter Linux führt Cowork diese Aufgaben in einer virtuellen Maschine aus, die die Desktop-App mit QEMU und KVM hostet. Um Cowork zu verwenden, benötigt Ihr Computer:

25 25 

26* **Hardware-Virtualisierung**: aktiviert in Ihren Firmware-Einstellungen. Ohne diese meldet die Cowork-Registerkarte „Cowork requires hardware virtualization (KVM)".26* **Hardware-Virtualisierung**: aktiviert in Ihren Firmware-Einstellungen. Ohne diese meldet Cowork „Cowork requires hardware virtualization (KVM)“.

27* **QEMU und UEFI-Firmware**: `qemu-system-x86`, `ovmf` und `virtiofsd` auf x86\_64 oder `qemu-system-arm`, `qemu-efi-aarch64` und `virtiofsd` auf arm64. `apt install claude-desktop` installiert diese standardmäßig als empfohlene Pakete. Wenn Sie mit `--no-install-recommends` installiert haben oder Ihr System ein minimales Image ist, das empfohlene Pakete überspringt, meldet die Cowork-Registerkarte „Cowork requires QEMU" und zeigt den auszuführenden `apt install`-Befehl an. Ubuntu 22.04 hat kein `virtiofsd`-Paket; die App verwendet dort eine gebündelte Kopie.27* **QEMU und UEFI-Firmware**: `qemu-system-x86`, `ovmf` und `virtiofsd` auf x86\_64 oder `qemu-system-arm`, `qemu-efi-aarch64` und `virtiofsd` auf arm64. `apt install claude-desktop` installiert diese standardmäßig als empfohlene Pakete. Wenn Sie mit `--no-install-recommends` installiert haben oder Ihr System ein minimales Image ist, das empfohlene Pakete überspringt, meldet Cowork „Cowork requires QEMU“ und zeigt den auszuführenden `apt install`-Befehl an. Ubuntu 22.04 hat kein `virtiofsd`-Paket; die App verwendet dort eine gebündelte Kopie.

28* **Zugriff auf `/dev/kvm`**: Fügen Sie Ihren Benutzer mit `sudo usermod -aG kvm $USER` zur `kvm`-Gruppe hinzu, melden Sie sich dann ab und wieder an. Einige Desktop-Umgebungen gewähren dem angemeldeten Benutzer Zugriff auf `/dev/kvm` ohne die Gruppe, aber Cowork benötigt auch `/dev/vhost-vsock`, auf das nur Mitglieder der `kvm`-Gruppe zugreifen können. Treten Sie der Gruppe bei, auch wenn `/dev/kvm` bereits für Sie funktioniert.28* **Zugriff auf `/dev/kvm`**: Fügen Sie Ihren Benutzer mit `sudo usermod -aG kvm $USER` zur `kvm`-Gruppe hinzu, melden Sie sich dann ab und wieder an. Einige Desktop-Umgebungen gewähren dem angemeldeten Benutzer Zugriff auf `/dev/kvm` ohne die Gruppe, aber Cowork benötigt auch `/dev/vhost-vsock`, auf das nur Mitglieder der `kvm`-Gruppe zugreifen können. Treten Sie der Gruppe bei, auch wenn `/dev/kvm` bereits für Sie funktioniert.

29 29 

30Die App überprüft diese Anforderungen einmal beim Start: Starten Sie sie neu, nachdem Sie Pakete installiert haben, und melden Sie sich ab und wieder an, nachdem Sie der Gruppe beigetreten sind. Wenn `/dev/vhost-vsock` fehlt und Ihr laufender Kernel kein Modulverzeichnis unter `/lib/modules` hat, meldet die Cowork-Registerkarte, dass der Kernel die Virtualisierungsunterstützung, die Cowork benötigt, nicht enthält und dass diese nicht manuell hinzugefügt werden kann. Diese Kombination ist häufig auf ChromeOS und in containergestützten Linux-Umgebungen anzutreffen.30Die App überprüft diese Anforderungen einmal beim Start: Starten Sie sie neu, nachdem Sie Pakete installiert haben, und melden Sie sich ab und wieder an, nachdem Sie der Gruppe beigetreten sind. Wenn `/dev/vhost-vsock` fehlt und Ihr laufender Kernel kein Modulverzeichnis unter `/lib/modules` hat, meldet Cowork, dass der Kernel die Virtualisierungsunterstützung, die Cowork benötigt, nicht enthält und dass diese nicht manuell hinzugefügt werden kann. Diese Kombination ist häufig auf ChromeOS und in containergestützten Linux-Umgebungen anzutreffen.

31 31 

32## Installation32## Installation

33 33 


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. Desktop akzeptiert keinen Claude Console API-Schlüssel direkt; verwenden Sie die [CLI](/docs/de/quickstart) für die API-Schlüssel-Authentifizierung. Für Enterprise-Bereitstellungen, die Desktop zu Googles Agent Platform oder einem LLM-Gateway weiterleiten, siehe [Claude Desktop auf 3P](https://claude.com/docs/third-party/claude-desktop/overview) und [Netzwerkkonfiguration](/docs/de/network-config).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](/docs/de/quickstart). 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](/docs/de/network-config).

75 75 

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

77 77 


153 153 

154### Cowork ist nicht verfügbar154### Cowork ist nicht verfügbar

155 155 

156Wenn die Cowork-Registerkarte eine dieser Meldungen anzeigt, beheben Sie die Anforderung, die sie benennt, und starten Sie die App neu:156Wenn Cowork eine dieser Meldungen anzeigt, beheben Sie die Anforderung, die sie benennt, und starten Sie die App neu:

157 157 

158* **Cowork erfordert QEMU**: Installieren Sie die [QEMU- und UEFI-Firmware-Pakete](#cowork-requirements), die die Meldung auflistet.158* **Cowork erfordert QEMU**: Installieren Sie die [QEMU- und UEFI-Firmware-Pakete](#cowork-requirements), die die Meldung auflistet.

159* **Cowork erfordert Hardware-Virtualisierung (KVM)**: Aktivieren Sie die [Hardware-Virtualisierung](#cowork-requirements) in Ihren Firmware-Einstellungen.159* **Cowork erfordert Hardware-Virtualisierung (KVM)**: Aktivieren Sie die [Hardware-Virtualisierung](#cowork-requirements) in Ihren Firmware-Einstellungen.

Details

6 6 

7> Installieren Sie die Claude-Desktop-App, öffnen Sie die Registerkarte Code und starten Sie Ihre erste Claude-Code-Sitzung in einem Projektordner auf Ihrem Computer.7> Installieren Sie die Claude-Desktop-App, öffnen Sie die Registerkarte Code und starten Sie Ihre erste Claude-Code-Sitzung in einem Projektordner auf Ihrem Computer.

8 8 

9Die Desktop-App bietet Ihnen Claude Code mit einer grafischen Benutzeroberfläche, sodass Sie Claude bitten können, an dem Code in einem Ordner auf Ihrem Computer zu arbeiten und seine Änderungen zu überprüfen, ohne ein Terminal zu verwenden. Diese Seite führt Sie durch die Installation der App und den Start Ihrer ersten Sitzung in der Registerkarte **Code**. Claude Code erfordert ein [Pro-, Max-, Team- oder Enterprise-Abonnement](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).9Die Desktop-App bietet Ihnen Claude Code mit einer grafischen Benutzeroberfläche. Sie können Claude bitten, an dem Code in einem Ordner auf Ihrem Computer zu arbeiten, und seine Änderungen überprüfen, ohne ein Terminal zu verwenden.

10 

11Claude Code befindet sich in der Registerkarte **Code** oben in der Seitenleiste der App. Diese Seite führt Sie durch die Installation der App und den Start Ihrer ersten Sitzung dort. Claude Code erfordert ein [Pro-, Max-, Team- oder Enterprise-Abonnement](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).

10 12 

11> **[Für macOS herunterladen](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**13> **[Für macOS herunterladen](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**

12>14>


28>30>

29> * **Bereits eingerichtet**: siehe [Claude Code Desktop verwenden](/docs/de/desktop) für alles, was die Registerkarte Code kann31> * **Bereits eingerichtet**: siehe [Claude Code Desktop verwenden](/docs/de/desktop) für alles, was die Registerkarte Code kann

30> * **Möchten `claude` in Ihrem Terminal**: [installieren Sie die CLI](/docs/de/quickstart) separat32> * **Möchten `claude` in Ihrem Terminal**: [installieren Sie die CLI](/docs/de/quickstart) separat

31 33> * **Verwenden Chat oder Cowork**: siehe das [Claude Help Center](https://support.claude.com/)

32Die Desktop-App hat drei Registerkarten:34> * **Benötigen mehr Informationen zur Installation oder Bereitstellung der Desktop-App**: siehe die [Claude Desktop-Supportartikel](https://support.claude.com/en/collections/16163169-claude-desktop)

33 

34* **Chat**: Allgemeine Konversation ohne Dateizugriff, ähnlich wie claude.ai.

35* **Cowork**: Ein autonomer Hintergrund-Agent, der an Aufgaben unabhängig arbeitet, während Sie andere Dinge tun.

36* **Code**: Ein interaktiver Coding-Assistent mit direktem Zugriff auf Ihre lokalen Dateien. Abhängig vom Berechtigungsmodus genehmigen Sie jede Änderung, wenn Claude sie vorschlägt, oder überprüfen die Änderungen, nachdem Claude sie vorgenommen hat.

37 

38Chat und Cowork werden im [Claude Help Center](https://support.claude.com/) behandelt; die Installation und Bereitstellung der Desktop-App wird in den [Claude Desktop-Supportartikeln](https://support.claude.com/en/collections/16163169-claude-desktop) behandelt. Diese Seite konzentriert sich auf die Registerkarte **Code**.

39 35 

40## Installieren36## Installieren

41 37 


45 41 

46**2. Öffnen Sie die Registerkarte Code**42**2. Öffnen Sie die Registerkarte Code**

47 43 

48Klicken Sie auf die Registerkarte **Code** oben in der Mitte. Wenn Sie beim Klicken auf „Code“ aufgefordert werden, ein Upgrade durchzuführen, müssen Sie zunächst [ein bezahltes Abonnement abschließen](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade). Wenn Sie aufgefordert werden, sich online anzumelden, schließen Sie die Anmeldung ab und starten Sie die App neu. Wenn Sie einen 403-Fehler sehen, siehe [Authentifizierungsfehlersuche](/docs/de/desktop#403-or-authentication-errors-in-the-code-tab).44Klicken Sie auf die Registerkarte **Code** oben in der Seitenleiste. Wenn die Registerkarten nur Symbole anzeigen, bewegen Sie den Mauszeiger über eines davon, um seinen Namen zu sehen. Wenn nach dem Klicken auf **Code** eine Meldung oder ein Fehler erscheint, wenden Sie die passende Lösung an:

45 

46* **Aufforderung zum Upgrade**: Sie müssen zunächst [ein bezahltes Abonnement abschließen](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade)

47* **Aufforderung zur Online-Anmeldung**: Schließen Sie die Anmeldung ab und starten Sie die App neu

48* **403-Fehler**: Siehe [Fehlerbehebung bei der Authentifizierung](/docs/de/desktop#403-or-authentication-errors-in-the-code-tab)

49 49 

50Die Desktop-App enthält Claude Code, daher müssen Sie Node.js oder die CLI nicht installieren, um die Registerkarte „Code“ zu verwenden.50Die Desktop-App enthält Claude Code, daher müssen Sie Node.js oder die CLI nicht installieren, um die Registerkarte „Code“ zu verwenden.

51 51 


87 87 

88Prüfen Sie Ihren [Berechtigungsmodus](/docs/de/desktop#choose-a-permission-mode) in der Zeile unter dem Eingabefeld, um zu sehen, ob Claude auf Ihre Genehmigung wartet:88Prüfen Sie Ihren [Berechtigungsmodus](/docs/de/desktop#choose-a-permission-mode) in der Zeile unter dem Eingabefeld, um zu sehen, ob Claude auf Ihre Genehmigung wartet:

89 89 

90* **Auto oder Änderungen akzeptieren**: Claude wendet seine Dateiänderungen an, und ein Indikator wie `+12 -1` wird angezeigt, damit Sie diese in der Diff-Ansicht überprüfen können90* **Auto oder Änderungen akzeptieren**: Claude wendet seine Dateiänderungen an, und ein Indikator wie `+12 -1` wird angezeigt, damit Sie diese in der [Diff-Ansicht](/docs/de/desktop#review-changes-with-diff-view) überprüfen können

91* **Manuell**: Claude schlägt jede Änderung vor und wartet auf Ihre Genehmigung, bevor sie angewendet wird91* **Manuell**: Claude schlägt jede Änderung vor und wartet auf Ihre Genehmigung, bevor sie angewendet wird

92 92 

93Im Manuellen Modus sehen Sie:93Im Manuellen Modus sehen Sie:

94 94 

951. Eine [Diff-Ansicht](/docs/de/desktop#review-changes-with-diff-view), die genau zeigt, was sich in jeder Datei ändert951. Einen Diff, der genau zeigt, was sich ändern wird

962. Schaltflächen zum Akzeptieren/Ablehnen, um jede Änderung zu genehmigen oder abzulehnen962. Schaltflächen, um jede Änderung zu genehmigen oder abzulehnen

973. Echtzeit-Updates, während Claude Ihre Anfrage bearbeitet973. Echtzeit-Updates, während Claude Ihre Anfrage bearbeitet

98 98 

99## Und jetzt?99## Und jetzt?

Details

28| Zugriff auf lokale Dateien | Nein (frischer Klon) | Ja | Ja |28| Zugriff auf lokale Dateien | Nein (frischer Klon) | Ja | Ja |

29| MCP-Server | Konnektoren pro Aufgabe konfiguriert | [Konfigurationsdateien](/docs/de/mcp) und Konnektoren | Erbt von Sitzung |29| MCP-Server | Konnektoren pro Aufgabe konfiguriert | [Konfigurationsdateien](/docs/de/mcp) und Konnektoren | Erbt von Sitzung |

30| Berechtigungsaufforderungen | Nein (läuft autonom) | Pro Aufgabe konfigurierbar | Erbt von Sitzung |30| Berechtigungsaufforderungen | Nein (läuft autonom) | Pro Aufgabe konfigurierbar | Erbt von Sitzung |

31| Anpassbarer Zeitplan | Via `/schedule` in der CLI | Ja | Ja |31| Anpassbarer Zeitplan | Ja | Ja | Ja |

32| Minimales Intervall | 1 Stunde | 1 Minute | 1 Minute |32| Minimales Intervall | 1 Stunde | 1 Minute, wenn Claude es festlegt, [1 Stunde in den Formularen](/docs/de/desktop-scheduled-tasks#schedule-options) | 1 Minute |

33 33 

34> [!TIP]34> [!TIP]

35>35>


61 61 

62**5. „Nur auf diesem Computer“ einschalten**62**5. „Nur auf diesem Computer“ einschalten**

63 63 

64Überspringen Sie die Karte **Auslöser** vorerst und klappen Sie darunter **Erweiterte Einstellungen** auf. Schalten Sie auf der Registerkarte **Allgemein** die Option **Nur auf diesem Computer** ein. Wenn diese Option eingeschaltet ist, wird die Aufgabe auf Ihrem Rechner in einem lokalen Ordner ausgeführt, und die Karte **Auslöser** bietet die unter [Planungsoptionen](#schedule-options) aufgeführten Voreinstellungen an.64Überspringen Sie die Karte **Auslöser** vorerst und klappen Sie darunter **Erweiterte Einstellungen** auf. Schalten Sie auf der Registerkarte **Allgemein** die Option **Nur auf diesem Computer** ein. Wenn diese Option eingeschaltet ist, wird die Aufgabe auf Ihrem Rechner in einem lokalen Ordner ausgeführt.

65 65 

66Wenn der Schalter nicht verfügbar ist, entfernen Sie das Repository oder den GitHub-Ereignis- bzw. API-Auslöser, da diese die Aufgabe zu einer [geplanten Cloud-Aufgabe](/docs/de/routines) machen.66Wenn der Schalter nicht verfügbar ist, entfernen Sie das Repository oder den GitHub-Ereignis- bzw. API-Auslöser, da diese die Aufgabe zu einer [geplanten Cloud-Aufgabe](/docs/de/routines) machen.

67 67 


81 81 

82Klicken 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.82Klicken 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.

83 83 

84Klicken 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** umstellen.84Klicken 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.

85 85 

86Sie 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.86Sie 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.

87 87 


95* **Beschreibung**: Geben Sie eine Beschreibung ein. **Erstellen** bleibt nicht verfügbar, bis Sie dies tun.95* **Beschreibung**: Geben Sie eine Beschreibung ein. **Erstellen** bleibt nicht verfügbar, bis Sie dies tun.

96* **Das Anweisungsfeld**: Geben Sie ein, was Claude tun soll, wenn die Aufgabe ausgeführt wird. Wählen Sie den Berechtigungsmodus und das Modell aus den Menüs im Feld aus.96* **Das Anweisungsfeld**: Geben Sie ein, was Claude tun soll, wenn die Aufgabe ausgeführt wird. Wählen Sie den Berechtigungsmodus und das Modell aus den Menüs im Feld aus.

97* **Arbeitsordner**: Wählen Sie den Ordner aus, in dem die Aufgabe ausgeführt wird. **Erstellen** bleibt nicht verfügbar, bis Sie einen ausgewählt haben.97* **Arbeitsordner**: Wählen Sie den Ordner aus, in dem die Aufgabe ausgeführt wird. **Erstellen** bleibt nicht verfügbar, bis Sie einen ausgewählt haben.

98* **Auslöser**: Wählen Sie einen Zeitplan aus. **Benutzerdefiniert** akzeptiert einen Cron-Ausdruck. Informationen zu den anderen Voreinstellungen finden Sie unter [Planungsoptionen](#schedule-options).98* **Auslöser**: Wählen Sie einen Zeitplan aus. Informationen zu den Voreinstellungen finden Sie unter [Planungsoptionen](#schedule-options).

99 99 

100Klicken Sie auf **Erstellen**. Die Detailseite der Aufgabe wird geöffnet.100Klicken Sie auf **Erstellen**. Die Detailseite der Aufgabe wird geöffnet.

101 101 

102## Planungsoptionen102## Planungsoptionen

103 103 

104Wenn Sie unter **Advanced settings** die Option **Only on this computer** aktivieren, bietet die Karte **Trigger** die Optionen Stündlich, Täglich, Wochentage und Wöchentlich. Das [**Edit**-Formular](#manage-scheduled-tasks) der Aufgabe bietet außerdem **Manuell**.104Wenn Sie unter **Advanced settings** die Option **Only on this computer** aktivieren, bietet die Karte **Trigger** die Optionen Stündlich, Täglich, Wochentage und Wöchentlich. Um für eine solche Aufgabe **Manuell** oder **Benutzerdefiniert** zu erhalten, öffnen Sie nach dem Erstellen ihr [**Edit**-Formular](#manage-scheduled-tasks). Dieses Formular und der [Dialog mit **Only on this computer** oben](#dialog-with-only-on-this-computer-at-the-top) bieten diese sechs Optionen:

105 105 

106* **Stündlich**: wird jede Stunde ausgeführt106* **Stündlich**: wird jede Stunde ausgeführt

107* **Täglich**: wird jeden Tag zur lokalen Zeit ausgeführt, die Sie auswählen107* **Täglich**: wird jeden Tag zur lokalen Zeit ausgeführt, die Sie auswählen

108* **Wochentage**: wie täglich, aber überspringt Samstag und Sonntag108* **Wochentage**: wie täglich, aber überspringt Samstag und Sonntag

109* **Wöchentlich**: zeigt eine Zeitauswahl und eine Tagesauswahl an109* **Wöchentlich**: zeigt eine Zeitauswahl und eine Tagesauswahl an

110* **Manuell**: kein Zeitplan, wird nur ausgeführt, wenn Sie auf **Run now** klicken. Nützlich zum Speichern eines Prompts, den Sie bei Bedarf auslösen110* **Manuell**: kein Zeitplan, wird nur ausgeführt, wenn Sie auf **Run now** klicken. Nützlich zum Speichern eines Prompts, den Sie bei Bedarf auslösen

111* **Benutzerdefiniert**: wird nach einem Cron-Ausdruck ausgeführt, den Sie eingeben und der in Ihrer lokalen Zeit ausgewertet wird, z. B. `0 9 * * *` für täglich 9:00 Uhr. Geben Sie Wochentage und Monate als Zahlen an, da ihre Namen nicht akzeptiert werden. Sonntag ist `0`, nicht `7`. Das Formular lehnt einen Ausdruck ab, der häufiger als einmal pro Stunde ausgeführt wird.

111 112 

112Für Intervalle, die die Auswahl nicht bietet, z. B. alle 15 Minuten, am ersten des Monats oder eine einzelne Ausführung zu einem bestimmten zukünftigen Zeitpunkt, bitten Sie Claude in einer beliebigen Desktop-Sitzung, den Zeitplan festzulegen. Verwenden Sie einfache Sprache; zum Beispiel „Planen Sie eine Aufgabe, um alle Tests alle 6 Stunden auszuführen.“113Sie können Claude auch in einer beliebigen Desktop-Sitzung bitten, den Zeitplan festzulegen. Für Claude gilt die Beschränkung auf einmal pro Stunde nicht, und Claude kann eine einzelne Ausführung zu einem zukünftigen Zeitpunkt festlegen. Bitten Sie zum Beispiel: „Führe die Testsuite alle 30 Minuten aus“ oder „Fasse nächsten Montag um 9 Uhr die seit Freitag gemergten Pull Requests zusammen.“

113 114 

114## Wie geplante Aufgaben ausgeführt werden115## Wie geplante Aufgaben ausgeführt werden

115 116 


121>122>

122> Für Aufgaben, die auch ausgeführt werden müssen, wenn Ihr Computer ausgeschaltet ist, oder die durch einen API-Aufruf oder ein GitHub-Ereignis ausgelöst werden sollen, erstellen Sie stattdessen eine [geplante Cloud-Aufgabe](/docs/de/routines).123> Für Aufgaben, die auch ausgeführt werden müssen, wenn Ihr Computer ausgeschaltet ist, oder die durch einen API-Aufruf oder ein GitHub-Ereignis ausgelöst werden sollen, erstellen Sie stattdessen eine [geplante Cloud-Aufgabe](/docs/de/routines).

123 124 

124Wenn eine lokale Aufgabe ausgelöst wird, wird eine neue Sitzung unter einem Abschnitt **Geplant** in der Seitenleiste angezeigt. Öffnen Sie sie, um zu sehen, was Claude getan hat, Änderungen zu überprüfen oder auf Berechtigungsabfragen zu reagieren. Claude kann Dateien bearbeiten, Befehle ausführen, Commits erstellen und Pull Requests öffnen, genau wie in einer Sitzung, die Sie selbst starten.125### Die Sitzung einer Ausführung finden

126 

127Um die Sitzung zu öffnen, die eine Ausführung gestartet hat, gehen Sie zur [Detailseite](#manage-scheduled-tasks) der Aufgabe und klicken Sie in der Liste **Verlauf** auf die Zeile dieser Ausführung.

128 

129Die Sitzungsliste in der Seitenleiste kann außerdem eine Gruppe **Geplant** anzeigen, mit einer Zeile pro Aufgabe. Um die Sitzung der letzten Ausführung einer Aufgabe zu öffnen, klicken Sie in dieser Gruppe auf die Zeile der Aufgabe. Um die Gruppe anzuzeigen, [prüfen Sie, welches Layout Sie haben](/docs/de/desktop#check-which-layout-you-have):

130 

131* **Aktuelles Layout**: Öffnen Sie das Menü [**Gruppieren und sortieren**](/docs/de/desktop#organize-and-find-sessions), wählen Sie **Anzeigen** und dann **Geplant**. Die Gruppe ist anfangs eingeklappt, klicken Sie also auf ihre Überschrift, um sie auszuklappen. **Anzeigen** listet **Geplant** auf, wenn mindestens eine Ihrer Aufgaben **Aktiv** ist, also den **Status**, den die Detailseite einer Aufgabe anzeigt. Wenn der Eintrag nicht aufgeführt ist, verwenden Sie die Liste **Verlauf**, die unabhängig davon funktioniert, ob die Gruppe angezeigt wird.

132* **Früheres Layout**: Die Gruppe befindet sich in der Sitzungsliste, ohne dass Sie etwas aktivieren müssen

133 

134In der Sitzung einer Ausführung können Sie, unabhängig davon, wie Sie sie erreicht haben, sehen, was Claude getan hat, Änderungen überprüfen und auf Berechtigungsabfragen reagieren. Claude kann Dateien bearbeiten, Befehle ausführen, Commits erstellen und Pull Requests öffnen, genau wie in einer Sitzung, die Sie selbst starten.

125 135 

126## Verpasste Ausführungen136## Verpasste Ausführungen

127 137 


131 141 

132## Berechtigungen für geplante Aufgaben142## Berechtigungen für geplante Aufgaben

133 143 

134Jede Aufgabe hat ihren eigenen Berechtigungsmodus, den Sie beim Erstellen oder Bearbeiten der Aufgabe festlegen. Zulassungsregeln aus `~/.claude/settings.json` gelten auch für geplante Aufgabensitzungen. Wenn eine Aufgabe im [Manuellen Modus](/docs/de/desktop#choose-a-permission-mode) ausgeführt wird und ein Tool ausführen muss, für das sie keine Berechtigung hat, bleibt die Ausführung stehen, bis Sie sie genehmigen. Die Sitzung bleibt in der Seitenleiste offen, damit Sie später antworten können.144Jede Aufgabe hat ihren eigenen Berechtigungsmodus, den Sie beim Erstellen oder Bearbeiten der Aufgabe festlegen. Zulassungsregeln aus `~/.claude/settings.json` gelten auch für geplante Aufgabensitzungen. Wenn eine Aufgabe im [Manuellen Modus](/docs/de/desktop#choose-a-permission-mode) ausgeführt wird und ein Tool ausführen muss, für das sie keine Berechtigung hat, bleibt die Ausführung stehen, bis Sie sie genehmigen. Um sie zu genehmigen, [suchen Sie die Sitzung der Ausführung](#find-a-runs-session) und beantworten Sie dort die Berechtigungsabfrage.

135 145 

136Um Stalls zu vermeiden, klicken Sie nach dem Erstellen einer Aufgabe auf **Jetzt ausführen**, achten Sie auf Berechtigungsaufforderungen und wählen Sie für jede „immer zulassen“. Zukünftige Ausführungen dieser Aufgabe genehmigen automatisch die gleichen Tools ohne Aufforderung. Sie können diese Genehmigungen auf der Detailseite der Aufgabe überprüfen und widerrufen.146Um Stalls zu vermeiden, klicken Sie nach dem Erstellen einer Aufgabe auf **Jetzt ausführen**, achten Sie auf Berechtigungsaufforderungen und wählen Sie für jede „immer zulassen“. Zukünftige Ausführungen dieser Aufgabe genehmigen automatisch die gleichen Tools ohne Aufforderung. Sie können diese Genehmigungen auf der Detailseite der Aufgabe überprüfen und widerrufen.

137 147 


146* **Bearbeiten**: Ändern Sie die Anweisungen, den Zeitplan, den Ordner oder andere Einstellungen156* **Bearbeiten**: Ändern Sie die Anweisungen, den Zeitplan, den Ordner oder andere Einstellungen

147* **Verlauf überprüfen**: Sehen Sie jede vergangene Ausführung, einschließlich übersprungener Ausführungen. Bewegen Sie den Mauszeiger über einen übersprungenen Eintrag, um zu sehen, warum: Ihr Computer war im Ruhezustand, die vorherige Ausführung war noch in Bearbeitung, oder andere geplante Aufgaben wurden bereits ausgeführt. Klicken Sie auf **Mehr anzeigen**, um ältere Einträge zu laden.157* **Verlauf überprüfen**: Sehen Sie jede vergangene Ausführung, einschließlich übersprungener Ausführungen. Bewegen Sie den Mauszeiger über einen übersprungenen Eintrag, um zu sehen, warum: Ihr Computer war im Ruhezustand, die vorherige Ausführung war noch in Bearbeitung, oder andere geplante Aufgaben wurden bereits ausgeführt. Klicken Sie auf **Mehr anzeigen**, um ältere Einträge zu laden.

148* **Zulässige Berechtigungen überprüfen**: Sehen Sie und widerrufen Sie gespeicherte Tool-Genehmigungen für diese Aufgabe aus dem Bereich **Immer zulässig**158* **Zulässige Berechtigungen überprüfen**: Sehen Sie und widerrufen Sie gespeicherte Tool-Genehmigungen für diese Aufgabe aus dem Bereich **Immer zulässig**

149* **Löschen**: Entfernen Sie die Aufgabe und archivieren Sie alle Sitzungen, die sie erstellt hat. Ein Kontrollkästchen **Auch Dateien auf der Festplatte löschen** wird im Bestätigungsdialog angezeigt. Aktivieren Sie es, um auch die Datei `SKILL.md` der Aufgabe und zugehörige Daten aus `~/.claude/scheduled-tasks/` zu entfernen.159* **Löschen**: Entfernen Sie die Aufgabe. Die Sitzungen, die die Aufgabe erstellt hat, werden [archiviert](/docs/de/desktop#organize-and-find-sessions), nicht gelöscht. Der Ordner mit der Datei `SKILL.md` der Aufgabe verbleibt auf der Festplatte unter `~/.claude/scheduled-tasks/<task-name>/` bzw. unter `scheduled-tasks/<task-name>/` in [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars), falls Sie diese Variable gesetzt haben. Um diesen Ordner zu entfernen, löschen Sie ihn selbst.

150 160 

151Sie können Aufgaben auch auflisten, erstellen, bearbeiten und pausieren, indem Sie Claude in einer beliebigen Desktop-Sitzung bitten. Zum Beispiel „Pausieren Sie meine Aufgabe zur Abhängigkeitsprüfung“ oder „Zeigen Sie mir meine geplanten Aufgaben.“ Um eine Aufgabe zu löschen, verwenden Sie die Schaltfläche **Löschen** auf ihrer Detailseite.161Sie können Aufgaben auch auflisten, erstellen, bearbeiten und pausieren, indem Sie Claude in einer beliebigen Desktop-Sitzung bitten. Zum Beispiel „Pausieren Sie meine Aufgabe zur Abhängigkeitsprüfung“ oder „Zeigen Sie mir meine geplanten Aufgaben.“ Um eine Aufgabe zu löschen, verwenden Sie die Schaltfläche **Löschen** auf ihrer Detailseite.

152 162 

env-vars.md +10 −19

Details

124> * `DISABLE_TELEMETRY`124> * `DISABLE_TELEMETRY`

125> * `DISABLE_ERROR_REPORTING`125> * `DISABLE_ERROR_REPORTING`

126> * `CLAUDE_CODE_TMUX_TRUECOLOR`126> * `CLAUDE_CODE_TMUX_TRUECOLOR`

127> * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

128> * `IS_DEMO`127> * `IS_DEMO`

129>128>

130> Eine weitere Variable hat ihre eigene Regel: `FORCE_HYPERLINK` liest eine Zahl, daher schaltet nur `0` sie aus. Die Zeile jeder Variable nennt ebenfalls ihre eigene Regel.129> Eine weitere Variable hat ihre eigene Regel: `FORCE_HYPERLINK` liest eine Zahl, daher schaltet nur `0` sie aus. Die Zeile jeder Variable nennt ebenfalls ihre eigene Regel.


136| `ANTHROPIC_AWS_API_KEY` | Workspace-API-Schlüssel für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), in der AWS Console generiert. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |135| `ANTHROPIC_AWS_API_KEY` | Workspace-API-Schlüssel für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), in der AWS Console generiert. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |

137| `ANTHROPIC_AWS_BASE_URL` | Überschreibt die Endpunkt-URL von [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Verwenden Sie dies für benutzerdefinierte Regionen oder beim Routing über ein [LLM-Gateway](/docs/de/llm-gateway). Standardwert ist `https://aws-external-anthropic.{region}.api.aws`. Claude Code ermittelt die Region mit [derselben Rangfolge wie bei Amazon Bedrock](/docs/de/amazon-bedrock#3-configure-claude-code) |136| `ANTHROPIC_AWS_BASE_URL` | Überschreibt die Endpunkt-URL von [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Verwenden Sie dies für benutzerdefinierte Regionen oder beim Routing über ein [LLM-Gateway](/docs/de/llm-gateway). Standardwert ist `https://aws-external-anthropic.{region}.api.aws`. Claude Code ermittelt die Region mit [derselben Rangfolge wie bei Amazon Bedrock](/docs/de/amazon-bedrock#3-configure-claude-code) |

138| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |137| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |

139| `ANTHROPIC_BASE_URL` | Überschreibt den API-Endpunkt, um Anfragen über einen Proxy oder ein Gateway zu leiten. Wenn ein Host gesetzt ist, der kein First-Party-Host ist, ist [MCP Tool Search](/docs/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. Ab v2.1.196 ist [Remote Control](/docs/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` zeigt, entsprechend dem Verhalten bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry |138| `ANTHROPIC_BASE_URL` | Überschreibt den API-Endpunkt, um Anfragen über einen Proxy oder ein Gateway zu leiten. Was passiert, wenn dieses Gateway MCP Tool Search ablehnt, erfahren Sie unter [Tool Search über ein LLM-Gateway](/docs/de/mcp#tool-search-through-a-gateway). Ab v2.1.196 ist [Remote Control](/docs/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` verweist, entsprechend dem Verhalten bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry |

140| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreibt die Amazon Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing über ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Amazon Bedrock](/docs/de/amazon-bedrock) |139| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreibt die Amazon Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing über ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Amazon Bedrock](/docs/de/amazon-bedrock) |

141| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreibt die Endpunkt-URL von Amazon Bedrock Mantle. Siehe [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |140| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreibt die Endpunkt-URL von Amazon Bedrock Mantle. Siehe [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |

142| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Präfix des regionsübergreifenden Inferenzprofils (`us`, `eu`, `apac`, `jp`, `au` oder `global`), das Claude Code zuerst versucht, anstelle des aus der AWS-Region abgeleiteten Präfixes. Wird in AWS-GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder höher. Siehe [Amazon Bedrock](/docs/de/amazon-bedrock#cross-region-inference-profile-prefixes) |141| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Präfix des regionsübergreifenden Inferenzprofils (`us`, `eu`, `apac`, `jp`, `au` oder `global`), das Claude Code zuerst versucht, anstelle des aus der AWS-Region abgeleiteten Präfixes. Wird in AWS-GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder höher. Siehe [Amazon Bedrock](/docs/de/amazon-bedrock#cross-region-inference-profile-prefixes) |


178| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID, an die Anfragen an Google Cloud's Agent Platform adressiert werden. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials) |177| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID, an die Anfragen an Google Cloud's Agent Platform adressiert werden. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials) |

179| `ANTHROPIC_WORKSPACE_ID` | Workspace-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie diese, wenn Ihre Federation-Regel mehr als einen Workspace umfasst, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |178| `ANTHROPIC_WORKSPACE_ID` | Workspace-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie diese, wenn Ihre Federation-Regel mehr als einen Workspace umfasst, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |

180| `API_FORCE_IDLE_TIMEOUT` | Überschreibt den 5-minütigen Leerlauf-Timeout für den Body, der eine gestreamte Modellantwort abbricht, wenn keine Bytes eintreffen. Setzen Sie `0`, um den Timeout auszuschalten, etwa wenn ein langsames [Gateway](/docs/de/llm-gateway) oder ein lokales Modell zwischen Chunks länger als 5 Minuten pausiert, oder `1`, um ihn für jeden Anbieter eingeschaltet zu lassen. Wenn nicht gesetzt, ist der Timeout bei anderen Anbietern als der direkten Anthropic-API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und Amazon Bedrock mit gesetztem `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` aktiv. Die [Stream-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) laufen unabhängig davon und brechen eine lange stille Pause auch dann ab, wenn Sie hier `0` setzen |179| `API_FORCE_IDLE_TIMEOUT` | Überschreibt den 5-minütigen Leerlauf-Timeout für den Body, der eine gestreamte Modellantwort abbricht, wenn keine Bytes eintreffen. Setzen Sie `0`, um den Timeout auszuschalten, etwa wenn ein langsames [Gateway](/docs/de/llm-gateway) oder ein lokales Modell zwischen Chunks länger als 5 Minuten pausiert, oder `1`, um ihn für jeden Anbieter eingeschaltet zu lassen. Wenn nicht gesetzt, ist der Timeout bei anderen Anbietern als der direkten Anthropic-API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und Amazon Bedrock mit gesetztem `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` aktiv. Die [Stream-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) laufen unabhängig davon und brechen eine lange stille Pause auch dann ab, wenn Sie hier `0` setzen |

181| `API_TIMEOUT_MS` | Zeit in Millisekunden, die jeder API-Anfrageversuch hat, um seine Response-Header zu empfangen (Standard: 600000 bzw. 10 Minuten; Maximum: 2147483647). Sie begrenzt nicht, wie lange eine Streaming-Antwort danach läuft. Wenn Sie einen positiven Wert setzen, muss jeder Versuch einer [Nicht-Streaming-Anfrage](/docs/de/errors#streaming-response-ended-before-any-complete-data-was-received) innerhalb dieser Zeit abgeschlossen sein. Erhöhen Sie diesen Wert, wenn Anfragen in langsamen Netzwerken oder beim Routing über einen Proxy in eine Zeitüberschreitung laufen |180| `API_TIMEOUT_MS` | Zeit in Millisekunden, die jeder Versuch einer API-Anfrage hat, um seine Response-Header zu empfangen. Sie begrenzt nicht, wie lange eine gestreamte Antwort danach läuft. Der Standardwert ist 600000, also 10 Minuten, und das Maximum ist 2147483647. Wenn Sie einen positiven Wert setzen, muss jeder Versuch einer [nicht gestreamten Anfrage](/docs/de/errors#streaming-response-ended-before-any-complete-data-was-received) innerhalb dieser Zeit abgeschlossen sein. Erhöhen Sie den Wert, wenn Anfragen in langsamen Netzwerken oder beim Routing über einen Proxy in eine Zeitüberschreitung laufen. Setzen Sie `0`, um diese Begrenzung aufzuheben, was Claude Code v2.1.305 oder höher erfordert. Mit `0` läuft ein nicht gestreamter Versuch in einer lokalen Sitzung dennoch nach 300 Sekunden in eine Zeitüberschreitung |

182| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock-API-Schlüssel für die Authentifizierung (siehe [Amazon Bedrock-API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |181| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock-API-Schlüssel für die Authentifizierung (siehe [Amazon Bedrock-API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

183| `BASH_DEFAULT_TIMEOUT_MS` | Standard-Timeout für einen Bash- oder PowerShell-Tool-Befehl im Vordergrund, in Millisekunden (Standard: 120000 bzw. 2 Minuten). Ein Wert über dem [Standard-Zeitlimit für Hintergrundbefehle](/docs/de/tools-reference#time-limit-for-background-commands) ersetzt diesen Standard in unbeaufsichtigten Sitzungen. Das Zeitlimit für Hintergrundbefehle erfordert Claude Code v2.1.285 oder höher |182| `BASH_DEFAULT_TIMEOUT_MS` | Standard-Timeout für einen Bash- oder PowerShell-Tool-Befehl im Vordergrund, in Millisekunden (Standard: 120000 bzw. 2 Minuten). Ein Wert über dem [Standard-Zeitlimit für Hintergrundbefehle](/docs/de/tools-reference#time-limit-for-background-commands) ersetzt diesen Standard in unbeaufsichtigten Sitzungen. Das Zeitlimit für Hintergrundbefehle erfordert Claude Code v2.1.285 oder höher |

184| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen der Bash-Ausgabe, die Claude Code in das Ergebnis eines Befehls zurückliest (Standard: 30000; Maximum: 150000). Wenn Sie die Einstellung [`bashOutputMaxChars`](/docs/de/settings-reference#bashoutputmaxchars) setzen, ignoriert Claude Code diese Variable. Siehe [Ausgabelimits](/docs/de/tools-reference#output-limits) |183| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen der Bash-Ausgabe, die Claude Code in das Ergebnis eines Befehls zurückliest (Standard: 30000; Maximum: 150000). Wenn Sie die Einstellung [`bashOutputMaxChars`](/docs/de/settings-reference#bashoutputmaxchars) setzen, ignoriert Claude Code diese Variable. Siehe [Ausgabelimits](/docs/de/tools-reference#output-limits) |


186| `BETA_TRACING_ENDPOINT` | OTLP/HTTP-Endpunkt für [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta): Mit `ENABLE_BETA_TRACING_DETAILED=1` werden Logs und Traces dorthin statt an die konfigurierten Exporter gesendet. Setzen Sie ihn in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |185| `BETA_TRACING_ENDPOINT` | OTLP/HTTP-Endpunkt für [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta): Mit `ENABLE_BETA_TRACING_DETAILED=1` werden Logs und Traces dorthin statt an die konfigurierten Exporter gesendet. Setzen Sie ihn in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

187| `CCR_FORCE_BUNDLE` | Setzen Sie `1`, um [`claude --cloud`](/docs/de/claude-code-on-the-web#send-local-repositories-without-github) zu zwingen, Ihr lokales Repository zu bündeln und hochzuladen, anstatt es von seinem Remote zu klonen |186| `CCR_FORCE_BUNDLE` | Setzen Sie `1`, um [`claude --cloud`](/docs/de/claude-code-on-the-web#send-local-repositories-without-github) zu zwingen, Ihr lokales Repository zu bündeln und hochzuladen, anstatt es von seinem Remote zu klonen |

188| `CLAUDECODE` | Wird in Subprozessen, die Claude Code startet (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/docs/de/hooks)-Befehle, [Statuszeilen](/docs/de/statusline)-Befehle, stdio-[MCP-Server](/docs/de/mcp)-Subprozesse), auf `1` gesetzt. IDE-Erweiterungen setzen dies ebenfalls in ihren integrierten Terminals. Verwenden Sie dies, um zu erkennen, wann ein Skript innerhalb eines von Claude Code gestarteten Subprozesses läuft. Um zu prüfen, ob der aktuelle Prozess direkt durch einen Tool-Aufruf oder Hook gestartet wurde und nicht innerhalb eines stdio-MCP-Servers, den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |187| `CLAUDECODE` | Wird in Subprozessen, die Claude Code startet (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/docs/de/hooks)-Befehle, [Statuszeilen](/docs/de/statusline)-Befehle, stdio-[MCP-Server](/docs/de/mcp)-Subprozesse), auf `1` gesetzt. IDE-Erweiterungen setzen dies ebenfalls in ihren integrierten Terminals. Verwenden Sie dies, um zu erkennen, wann ein Skript innerhalb eines von Claude Code gestarteten Subprozesses läuft. Um zu prüfen, ob der aktuelle Prozess direkt durch einen Tool-Aufruf oder Hook gestartet wurde und nicht innerhalb eines stdio-MCP-Servers, den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |

189| `CLAUDE_AFK_COUNTDOWN_MS` | Wie viele Millisekunden vor dem automatischen Fortfahren der Countdown auf dem Bildschirm in einem unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog erscheint. Standard `20000` (20 Sekunden), begrenzt auf den Timeout für das automatische Fortfahren. Hat keine Wirkung, sofern das automatische Fortfahren nicht eingeschaltet ist; siehe die Einstellung [`askUserQuestionTimeout`](/docs/de/settings-reference#askuserquestiontimeout) und `CLAUDE_AFK_TIMEOUT_MS`. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Erfordert Claude Code v2.1.198 oder höher |

190| `CLAUDE_AFK_TIMEOUT_MS` | Wie viele Millisekunden Leerlaufzeit vergehen, bevor ein unbeantworteter [`AskUserQuestion`](/docs/de/tools-reference)-Dialog ohne Sie automatisch fortfährt. Das automatische Fortfahren ist standardmäßig ausgeschaltet; aktivieren Sie es mit der Einstellung [`askUserQuestionTimeout`](/docs/de/settings-reference#askuserquestiontimeout). Diese Variable ist eine Überschreibung für Demos und automatisierte Tests: Wenn gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet das automatische Fortfahren ein, selbst wenn die Einstellung nicht gesetzt oder `never` ist. Das Setzen von `0` schaltet den Timeout nicht aus, sondern schließt den Dialog sofort. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Vor v2.1.200 war das automatische Fortfahren standardmäßig mit einem Timeout von `60000` (60 Sekunden) eingeschaltet. Erfordert Claude Code v2.1.198 oder höher |

191| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie `1`, um alle integrierten [Subagenten](/docs/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht interaktiven Modus (das `-p`-Flag). Nützlich für SDK-Benutzer, die bei null beginnen möchten. Dadurch wird auch `general-purpose` entfernt, der Subagent, den Claude Code ausführt, wenn ein Agent-Tool-Aufruf `subagent_type` weglässt. Ein solcher Aufruf schlägt dann mit [`subagent_type is required`](/docs/de/errors#subagent-type-is-required) fehl |188| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie `1`, um alle integrierten [Subagenten](/docs/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht interaktiven Modus (das `-p`-Flag). Nützlich für SDK-Benutzer, die bei null beginnen möchten. Dadurch wird auch `general-purpose` entfernt, der Subagent, den Claude Code ausführt, wenn ein Agent-Tool-Aufruf `subagent_type` weglässt. Ein solcher Aufruf schlägt dann mit [`subagent_type is required`](/docs/de/errors#subagent-type-is-required) fehl |

192| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie `1`, um das Präfix `mcp__<server>__` bei Tool-Namen von im SDK erstellten MCP-Servern wegzulassen. Tools verwenden ihre ursprünglichen Namen. Nur für die SDK-Nutzung |189| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie `1`, um das Präfix `mcp__<server>__` bei Tool-Namen von im SDK erstellten MCP-Servern wegzulassen. Tools verwenden ihre ursprünglichen Namen. Nur für die SDK-Nutzung |

193| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout in Millisekunden, nach dem Subagenten als hängend gelten. Deckt unter Claude Code v2.1.286 oder höher auch [Workflow-Agenten](/docs/de/workflows#when-an-agent-stalls-and-restarts) ab. Standard `600000` (10 Minuten); wenn Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standardwert mit, wie [Langsame oder hängende API-Antworten behandeln](/docs/de/agent-sdk/typescript#handle-slow-or-stalled-api-responses) beschreibt |190| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout in Millisekunden, nach dem Subagenten als hängend gelten. Deckt unter Claude Code v2.1.286 oder höher auch [Workflow-Agenten](/docs/de/workflows#when-an-agent-stalls-and-restarts) ab. Standard `600000` (10 Minuten); wenn Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standardwert mit, wie [Langsame oder hängende API-Antworten behandeln](/docs/de/agent-sdk/typescript#handle-slow-or-stalled-api-responses) beschreibt |


229| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Minimale Log-Stufe, die in die Debug-Logdatei geschrieben wird. Werte: `verbose`, `debug` (Standard), `info`, `warn`, `error`. Setzen Sie `verbose`, um umfangreiche Diagnosedaten wie die vollständige Ausgabe des Statuszeilenbefehls einzuschließen, oder erhöhen Sie auf `error`, um überflüssige Meldungen zu reduzieren |226| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Minimale Log-Stufe, die in die Debug-Logdatei geschrieben wird. Werte: `verbose`, `debug` (Standard), `info`, `warn`, `error`. Setzen Sie `verbose`, um umfangreiche Diagnosedaten wie die vollständige Ausgabe des Statuszeilenbefehls einzuschließen, oder erhöhen Sie auf `error`, um überflüssige Meldungen zu reduzieren |

230| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Setzen Sie `1`, um die Unterstützung des [1M-Kontextfensters](/docs/de/model-config#extended-context) auszuschalten. Claude Code entfernt `[1m]`-Modellvarianten aus der Modellauswahl und beschränkt Modelle, die standardmäßig mit dem 1M-Fenster laufen, auf ein 200K-Fenster. Siehe [1M-Kontext ausschalten](/docs/de/model-config#turn-off-1m-context). Nützlich für Unternehmensumgebungen mit Compliance-Anforderungen. Zur Rolle dieser Variable bei der Korrektur des Fensters für eine nicht erkannte `[1m]`-Modell-ID siehe [Das Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |227| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Setzen Sie `1`, um die Unterstützung des [1M-Kontextfensters](/docs/de/model-config#extended-context) auszuschalten. Claude Code entfernt `[1m]`-Modellvarianten aus der Modellauswahl und beschränkt Modelle, die standardmäßig mit dem 1M-Fenster laufen, auf ein 200K-Fenster. Siehe [1M-Kontext ausschalten](/docs/de/model-config#turn-off-1m-context). Nützlich für Unternehmensumgebungen mit Compliance-Anforderungen. Zur Rolle dieser Variable bei der Korrektur des Fensters für eine nicht erkannte `[1m]`-Modell-ID siehe [Das Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

231| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Setzen Sie `1`, um [adaptives Reasoning](/docs/de/model-config#adjust-effort-level) bei Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Thinking-Budget zurückzufallen, das durch `MAX_THINKING_TOKENS` gesteuert wird. Hat keine Wirkung auf [Fable-Modelle](/docs/de/model-config#extended-thinking), Sonnet 5 und höher, Haiku 5.5 oder Opus 4.7 und höher, die immer adaptives Reasoning verwenden |228| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Setzen Sie `1`, um [adaptives Reasoning](/docs/de/model-config#adjust-effort-level) bei Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Thinking-Budget zurückzufallen, das durch `MAX_THINKING_TOKENS` gesteuert wird. Hat keine Wirkung auf [Fable-Modelle](/docs/de/model-config#extended-thinking), Sonnet 5 und höher, Haiku 5.5 oder Opus 4.7 und höher, die immer adaptives Reasoning verwenden |

232| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Setzen Sie `1`, damit Claude Code `env`-Blöcke der [verwalteten Einstellungen](/docs/de/managed-settings#precedence-within-the-managed-tier) nicht mehr schlüsselweise über Admin-Quellen hinweg zusammenführt, sodass nur der gesamte `env`-Block der Quelle mit der höchsten Priorität gilt, wie vor v2.1.223. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen `env`-Block der Einstellungen bereitgestellte Kopie ignoriert. Erfordert Claude Code v2.1.223 oder höher |

233| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Setzen Sie `1`, um das [Advisor-Tool](/docs/de/advisor) zu deaktivieren. Der Befehl `/advisor` ist dann nicht verfügbar, ein konfiguriertes `advisorModel` wird ignoriert, und das Flag `--advisor` wird akzeptiert, hat aber keine Wirkung, sodass bestehende Skripte, die es übergeben, weiterhin ohne Fehler funktionieren |229| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Setzen Sie `1`, um das [Advisor-Tool](/docs/de/advisor) zu deaktivieren. Der Befehl `/advisor` ist dann nicht verfügbar, ein konfiguriertes `advisorModel` wird ignoriert, und das Flag `--advisor` wird akzeptiert, hat aber keine Wirkung, sodass bestehende Skripte, die es übergeben, weiterhin ohne Fehler funktionieren |

234| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Setzen Sie `1`, um [Hintergrundagenten und die Agentenansicht](/docs/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den bei Bedarf gestarteten Supervisor. Entspricht der Einstellung [`disableAgentView`](/docs/de/settings-reference#disableagentview) |230| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Setzen Sie `1`, um [Hintergrundagenten und die Agentenansicht](/docs/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den bei Bedarf gestarteten Supervisor. Entspricht der Einstellung [`disableAgentView`](/docs/de/settings-reference#disableagentview) |

235| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie `1`, um die [Vollbilddarstellung](/docs/de/fullscreen) zu deaktivieren und den klassischen Renderer für den Hauptbildschirm zu verwenden. Die Konversation bleibt im nativen Scrollback Ihres Terminals, sodass `Cmd+f` und der tmux-Kopiermodus wie gewohnt funktionieren. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der Einstellung [`tui`](/docs/de/settings-reference#tui). Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrundsitzungen, die aus der [Agentenansicht](/docs/de/agent-view) geöffnet werden, da diese immer die Vollbilddarstellung verwenden |231| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie `1`, um die [Vollbilddarstellung](/docs/de/fullscreen) zu deaktivieren und den klassischen Renderer für den Hauptbildschirm zu verwenden. Die Konversation bleibt im nativen Scrollback Ihres Terminals, sodass `Cmd+f` und der tmux-Kopiermodus wie gewohnt funktionieren. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der Einstellung [`tui`](/docs/de/settings-reference#tui). Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrundsitzungen, die aus der [Agentenansicht](/docs/de/agent-view) geöffnet werden, da diese immer die Vollbilddarstellung verwenden |


240| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie `1`, um alle Funktionen für Hintergrundaufgaben zu deaktivieren, einschließlich des Parameters `run_in_background` bei Bash- und Subagenten-Tools, des automatischen Verschiebens in den Hintergrund und der Tastenkombination Ctrl+B |236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie `1`, um alle Funktionen für Hintergrundaufgaben zu deaktivieren, einschließlich des Parameters `run_in_background` bei Bash- und Subagenten-Tools, des automatischen Verschiebens in den Hintergrund und der Tastenkombination Ctrl+B |

241| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie `1`, damit Claude Code eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlendem oder leerem `Content-Type`-Header nicht mehr als binären Event-Stream von Amazon Bedrock behandelt. Standardmäßig nimmt Claude Code an, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort entfernt hat, und dekodiert daher den Body, sodass das Streaming weiter funktioniert. Setzen Sie dies nur für ein Gateway, das den Stream außerdem als Server-Sent Events neu ausgibt; Claude Code liest den Body ohne Header dann stattdessen als Server-Sent Events. Erfordert Claude Code v2.1.239 oder höher |237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie `1`, damit Claude Code eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlendem oder leerem `Content-Type`-Header nicht mehr als binären Event-Stream von Amazon Bedrock behandelt. Standardmäßig nimmt Claude Code an, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort entfernt hat, und dekodiert daher den Body, sodass das Streaming weiter funktioniert. Setzen Sie dies nur für ein Gateway, das den Stream außerdem als Server-Sent Events neu ausgibt; Claude Code liest den Body ohne Header dann stattdessen als Server-Sent Events. Erfordert Claude Code v2.1.239 oder höher |

242| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie `1`, um die Prüfung zu überspringen, ob eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort den Content-Type `application/vnd.amazon.eventstream` trägt. Ohne diese Variable lässt Claude Code die Anfrage, wenn eine Antwort einen anderen Content-Type trägt, mit einem Fehler fehlschlagen, der diesen Typ nennt; das bedeutet, dass ein [Gateway oder Proxy die Antwort umwandelt](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Konfigurieren Sie das Gateway so, dass es den `Content-Type`-Header und den Body unverändert weiterleitet, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher |238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie `1`, um die Prüfung zu überspringen, ob eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort den Content-Type `application/vnd.amazon.eventstream` trägt. Ohne diese Variable lässt Claude Code die Anfrage, wenn eine Antwort einen anderen Content-Type trägt, mit einem Fehler fehlschlagen, der diesen Typ nennt; das bedeutet, dass ein [Gateway oder Proxy die Antwort umwandelt](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Konfigurieren Sie das Gateway so, dass es den `Content-Type`-Header und den Body unverändert weiterleitet, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher |

243| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie `1`, um laufende Hintergrund-Shell-Befehle, dynamische Workflows und ab v2.1.198 Hintergrund-Subagenten einer [Hintergrundsitzung](/docs/de/agent-view) zu beenden, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, statt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Wenn Sie eine Sitzung mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) in den Hintergrund verschieben, wird laufende Hintergrundarbeit weiterhin übernommen, und `CLAUDE_DISABLE_ADOPT` schaltet beides aus. Erfordert Claude Code v2.1.196 oder neuer |239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie `1`, um laufende Arbeit einer [Hintergrundsitzung](/docs/de/agent-view) zu beenden, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, statt sie an den nächsten Prozess der Sitzung zu übergeben. Diese Arbeit umfasst die laufenden Shell-Befehle im Hintergrund und dynamischen Workflows der Sitzung, ab v2.1.198 außerdem Hintergrund-Subagenten. Betrifft nur diese Übergabe: Wenn Sie eine Sitzung mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) in den Hintergrund verschieben, wird laufende Hintergrundarbeit weiterhin übernommen. Erfordert Claude Code v2.1.196 oder höher |

244| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie `1`, damit Claude Code [Hintergrund-Shell-Befehle](/docs/de/interactive-mode#background-bash-commands) bei Speicherdruck nicht mehr beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang inaktiv war, ohne dass ein Turn oder Subagent läuft. Windows hat kein Signal für Speicherdruck, daher hat diese Variable dort keine Wirkung. Erfordert Claude Code v2.1.193 oder höher |240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie `1`, damit Claude Code [Hintergrund-Shell-Befehle](/docs/de/interactive-mode#background-bash-commands) bei Speicherdruck nicht mehr beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang inaktiv war, ohne dass ein Turn oder Subagent läuft. Windows hat kein Signal für Speicherdruck, daher hat diese Variable dort keine Wirkung. Erfordert Claude Code v2.1.193 oder höher |

245| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie `1`, um die mit Claude Code gelieferten [Skills](/docs/de/skills) und Workflows zu deaktivieren: Mitgelieferte Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie `/init` weiterhin eingegeben werden können, aber vor dem Modell verborgen werden. `/doctor` bleibt wie die integrierten Befehle eingebbar; blenden Sie es stattdessen mit `DISABLE_DOCTOR_COMMAND` aus. Skills aus Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht der Einstellung [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills) |241| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie `1`, um die mit Claude Code gelieferten [Skills](/docs/de/skills) und Workflows zu deaktivieren: Mitgelieferte Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie `/init` weiterhin eingegeben werden können, aber vor dem Modell verborgen werden. `/doctor` bleibt wie die integrierten Befehle eingebbar; blenden Sie es stattdessen mit `DISABLE_DOCTOR_COMMAND` aus. Skills aus Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht der Einstellung [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills) |

246| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Setzen Sie `1`, um die Browser-Tools von [Claude in Chrome](/docs/de/chrome) verfügbar zu halten, während der Chrome-Abschnitt des System-Prompts und der [mitgelieferte Skill](/docs/de/skills#bundled-skills) `/claude-in-chrome` weggelassen werden. Für Hosts, die Claude Code einbetten und eigene Browser-Anleitungen bereitstellen. Erfordert Claude Code v2.1.257 oder höher |242| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Setzen Sie `1`, um die Browser-Tools von [Claude in Chrome](/docs/de/chrome) verfügbar zu halten, während der Chrome-Abschnitt des System-Prompts und der [mitgelieferte Skill](/docs/de/skills#bundled-skills) `/claude-in-chrome` weggelassen werden. Für Hosts, die Claude Code einbetten und eigene Browser-Anleitungen bereitstellen. Erfordert Claude Code v2.1.257 oder höher |


299| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Auf `1` setzen, um die Persistenz von Transkripten, den Prompt-Verlauf und die Registrierung bei `claude agents` zu erzwingen, selbst wenn dieses `claude` aus einer anderen Claude Code-Sitzung heraus gestartet wurde. Verwenden Sie dies, wenn ein geerbter `CLAUDE_CODE_CHILD_SESSION`-Wert, etwa aus einer `screen`-Sitzung oder einem Hintergrund-Launcher, der zuerst vom Bash-Tool von Claude Code gestartet wurde, dazu führt, dass eine echte Sitzung der obersten Ebene fälschlich als verschachtelt eingestuft wird. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert die geerbte Markierung, sodass tmux diese Variable nicht mehr benötigt. Wird auch in v2.1.169 und früher berücksichtigt; hat in v2.1.170 und v2.1.171 keine Wirkung, da dort die Erkennung verschachtelter Sitzungen, die sie überschreibt, entfernt war |295| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Auf `1` setzen, um die Persistenz von Transkripten, den Prompt-Verlauf und die Registrierung bei `claude agents` zu erzwingen, selbst wenn dieses `claude` aus einer anderen Claude Code-Sitzung heraus gestartet wurde. Verwenden Sie dies, wenn ein geerbter `CLAUDE_CODE_CHILD_SESSION`-Wert, etwa aus einer `screen`-Sitzung oder einem Hintergrund-Launcher, der zuerst vom Bash-Tool von Claude Code gestartet wurde, dazu führt, dass eine echte Sitzung der obersten Ebene fälschlich als verschachtelt eingestuft wird. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert die geerbte Markierung, sodass tmux diese Variable nicht mehr benötigt. Wird auch in v2.1.169 und früher berücksichtigt; hat in v2.1.170 und v2.1.171 keine Wirkung, da dort die Erkennung verschachtelter Sitzungen, die sie überschreibt, entfernt war |

300| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Auf `1` setzen, um die durchgestrichene Darstellung von `~~text~~` in Claudes Antworten zu erzwingen, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird, etwa über SSH ohne weitergeleitetes `TERM_PROGRAM`. Ohne diese Variable zeigen nicht erkannte Terminals die wörtlichen `~~`-Markierungen an, statt den Text durchgestrichen darzustellen. Erfordert Claude Code v2.1.186 oder höher |296| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Auf `1` setzen, um die durchgestrichene Darstellung von `~~text~~` in Claudes Antworten zu erzwingen, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird, etwa über SSH ohne weitergeleitetes `TERM_PROGRAM`. Ohne diese Variable zeigen nicht erkannte Terminals die wörtlichen `~~`-Markierungen an, statt den Text durchgestrichen darzustellen. Erfordert Claude Code v2.1.186 oder höher |

301| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Auf `1` setzen, um den DEC Private Mode 2026 für [synchronisierte Ausgabe](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) zwangsweise zu aktivieren, wenn Ihr Terminal ihn unterstützt, aber nicht automatisch erkannt wird. Nützlich für Emulatoren wie Emacs `eat`, die BSU/ESU implementieren, aber nicht auf die Fähigkeitsabfrage antworten. Hat unter tmux keine Wirkung. Anders als `CLAUDE_CODE_NO_FLICKER`, das zum [Vollbild-Rendering](/docs/de/fullscreen) wechselt, ändert dies den Renderer nicht |297| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Auf `1` setzen, um den DEC Private Mode 2026 für [synchronisierte Ausgabe](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) zwangsweise zu aktivieren, wenn Ihr Terminal ihn unterstützt, aber nicht automatisch erkannt wird. Nützlich für Emulatoren wie Emacs `eat`, die BSU/ESU implementieren, aber nicht auf die Fähigkeitsabfrage antworten. Hat unter tmux keine Wirkung. Anders als `CLAUDE_CODE_NO_FLICKER`, das zum [Vollbild-Rendering](/docs/de/fullscreen) wechselt, ändert dies den Renderer nicht |

302| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | Auf `1` setzen, um [`Image`-Elemente von Mods](/docs/de/plugins/mods/reference#elements) als Bilder zu zeichnen, wenn Ihr Terminal Bilder des kitty-Grafikprotokolls mit Unicode-Platzhaltern zeichnet, aber nicht automatisch erkannt wird. Siehe, [welche Terminals Claude Code erkennt](/docs/de/plugins/mods/gallery#image-and-client) und warum dies innerhalb von tmux oder screen nicht hilft |298| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | Auf `1` setzen, um [Mod-`Image`-Elemente](/docs/de/plugins/mods/reference#elements) als Bilder zu zeichnen, wenn Ihr Terminal Bilder des Kitty-Grafikprotokolls mit Unicode-Platzhaltern zeichnet und Sie dennoch den abgeblendeten `alt`-Text eines `Image` sehen. Siehe [welche Terminals ein `Image` zeichnen](/docs/de/plugins/mods/gallery#image-and-client) und warum diese Variable innerhalb von tmux oder screen nicht hilft |

303| `CLAUDE_CODE_FORK_SUBAGENT` | Steuert den Fork-Modus, der standardmäßig aktiviert ist und Claude erlaubt, selbstständig [Forks](/docs/de/sub-agents#fork-the-current-conversation) zu starten. Solange der Fork-Modus aktiviert ist, kann Claude in interaktiven Terminal-, VS Code- oder Desktop-Sitzungen auf Ihrem Rechner außerdem nicht [auf einen Subagenten warten](/docs/de/sub-agents#run-subagents-in-foreground-or-background). Auf `0` setzen, um den Fork-Modus zu deaktivieren. Informationen zu Versionen finden Sie unter [Fork-Modus deaktivieren](/docs/de/sub-agents#turn-fork-mode-on-or-off) |299| `CLAUDE_CODE_FORK_SUBAGENT` | Steuert den Fork-Modus, der standardmäßig aktiviert ist und Claude erlaubt, selbstständig [Forks](/docs/de/sub-agents#fork-the-current-conversation) zu starten. Solange der Fork-Modus aktiviert ist, kann Claude in interaktiven Terminal-, VS Code- oder Desktop-Sitzungen auf Ihrem Rechner außerdem nicht [auf einen Subagenten warten](/docs/de/sub-agents#run-subagents-in-foreground-or-background). Auf `0` setzen, um den Fork-Modus zu deaktivieren. Informationen zu Versionen finden Sie unter [Fork-Modus deaktivieren](/docs/de/sub-agents#turn-fork-mode-on-or-off) |

304| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Auf `1` setzen, um Text- und Thinking-Blöcke von [Subagenten](/docs/de/sub-agents) in der Ausgabe von `claude -p --output-format stream-json` auszugeben, mit demselben Verhalten wie das Flag [`--forward-subagent-text`](/docs/de/cli-reference#cli-flags). Verwenden Sie die Variable, wenn ein Harness `claude` aufruft und das Flag nicht selbst übergeben kann. Anders als das Flag, das außerhalb des nicht interaktiven Modus mit stream-json-Ausgabe mit einem Fehler beendet wird, wird die Variable dort ignoriert, sodass verschachtelte Aufrufe weiterhin funktionieren, wenn sie prozessweit gesetzt ist. Erfordert Claude Code v2.1.211 oder höher |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Auf `1` setzen, um Text- und Thinking-Blöcke von [Subagenten](/docs/de/sub-agents) in der Ausgabe von `claude -p --output-format stream-json` auszugeben, mit demselben Verhalten wie das Flag [`--forward-subagent-text`](/docs/de/cli-reference#cli-flags). Verwenden Sie die Variable, wenn ein Harness `claude` aufruft und das Flag nicht selbst übergeben kann. Anders als das Flag, das außerhalb des nicht interaktiven Modus mit stream-json-Ausgabe mit einem Fehler beendet wird, wird die Variable dort ignoriert, sodass verschachtelte Aufrufe weiterhin funktionieren, wenn sie prozessweit gesetzt ist. Erfordert Claude Code v2.1.211 oder höher |

305| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Auf `1` setzen, um die [Gateway-Hinweis-Header](/docs/de/llm-gateway-protocol#gateway-hint-headers) wie `x-claude-code-request-class` und `x-claude-code-compaction` an einen benutzerdefinierten Proxy oder einen Drittanbieter wie Amazon Bedrock oder Claude Platform on AWS zu senden. Auf `0` setzen, um sie bei keiner Verbindung mehr zu senden, einschließlich einer direkten Verbindung zur Anthropic API, bei der Claude Code sie standardmäßig sendet. Erfordert Claude Code v2.1.273 oder höher |301| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Auf `1` setzen, um die [Gateway-Hinweis-Header](/docs/de/llm-gateway-protocol#gateway-hint-headers) wie `x-claude-code-request-class` und `x-claude-code-compaction` an einen benutzerdefinierten Proxy oder einen Drittanbieter wie Amazon Bedrock oder Claude Platform on AWS zu senden. Auf `0` setzen, um sie bei keiner Verbindung mehr zu senden, einschließlich einer direkten Verbindung zur Anthropic API, bei der Claude Code sie standardmäßig sendet. Erfordert Claude Code v2.1.273 oder höher |


319| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreibt die Größe des Kontextfensters, die Claude Code für das aktive Modell annimmt. Ab v2.1.193 hängt die Anwendung davon ab, wie Claude Code die Modell-ID auflöst; siehe [Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Verwenden Sie dies beim Routing über `ANTHROPIC_BASE_URL` zu einem Modell, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht |315| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreibt die Größe des Kontextfensters, die Claude Code für das aktive Modell annimmt. Ab v2.1.193 hängt die Anwendung davon ab, wie Claude Code die Modell-ID auflöst; siehe [Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Verwenden Sie dies beim Routing über `ANTHROPIC_BASE_URL` zu einem Modell, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht |

320| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Maximale Länge in Zeichen von MCP-Tool-Beschreibungen und MCP-Server-Anweisungen, die Claude Code an das Modell sendet. Der von Ihnen gesetzte Wert ersetzt beide [Standardlimits](/docs/de/mcp#for-mcp-server-authors): 4096 sowie 16384 für die Beschreibung eines Tools, das Claude über die Tool-Suche lädt. Akzeptiert eine positive ganze Zahl als reine Ziffern. Alles andere wird ignoriert, und es gelten die Standardwerte. Erfordert Claude Code v2.1.280 oder höher |316| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Maximale Länge in Zeichen von MCP-Tool-Beschreibungen und MCP-Server-Anweisungen, die Claude Code an das Modell sendet. Der von Ihnen gesetzte Wert ersetzt beide [Standardlimits](/docs/de/mcp#for-mcp-server-authors): 4096 sowie 16384 für die Beschreibung eines Tools, das Claude über die Tool-Suche lädt. Akzeptiert eine positive ganze Zahl als reine Ziffern. Alles andere wird ignoriert, und es gelten die Standardwerte. Erfordert Claude Code v2.1.280 oder höher |

321| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Legt die maximale Anzahl an Ausgabe-Token für die meisten Anfragen fest. Standardwerte und Obergrenzen variieren je nach Modell; siehe [maximale Ausgabe-Token](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code senkt einen Wert oberhalb der Obergrenze eines Modells auf diese Obergrenze. Für eine Modell-ID, die Claude Code keinem bekannten Modell zuordnen kann, beträgt der Standard 32000 und die Obergrenze 128000. Eine Erhöhung dieses Werts verkleinert das effektive Kontextfenster, das verfügbar ist, bevor die [automatische Komprimierung](/docs/de/costs#reduce-token-usage) ausgelöst wird |317| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Legt die maximale Anzahl an Ausgabe-Token für die meisten Anfragen fest. Standardwerte und Obergrenzen variieren je nach Modell; siehe [maximale Ausgabe-Token](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code senkt einen Wert oberhalb der Obergrenze eines Modells auf diese Obergrenze. Für eine Modell-ID, die Claude Code keinem bekannten Modell zuordnen kann, beträgt der Standard 32000 und die Obergrenze 128000. Eine Erhöhung dieses Werts verkleinert das effektive Kontextfenster, das verfügbar ist, bevor die [automatische Komprimierung](/docs/de/costs#reduce-token-usage) ausgelöst wird |

322| `CLAUDE_CODE_MAX_RETRIES` | Überschreibt die Anzahl der Wiederholungsversuche für fehlgeschlagene API-Anfragen (Standard: 10). Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standard und hebt die Obergrenze auf. Für unbeaufsichtigte Sitzungen, die längere Ausfälle abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |318| `CLAUDE_CODE_MAX_RETRIES` | Überschreibt die Anzahl der Wiederholungsversuche für fehlgeschlagene API-Anfragen (Standard: 10). Bei `529`-Überlastungsfehlern können die Wiederholungsversuche früher enden. Beispielsweise endet es mit einem API-Schlüssel bei einem Opus-Modell beim dritten `529` und zeigt [Repeated 529 Overloaded errors](/docs/de/errors#api-error-repeated-529-overloaded-errors) an. Wenn Sie ein [Fallback-Modell](/docs/de/settings-reference#fallbackmodel) festlegen, wechselt Claude Code zu diesem Modell, statt den Fehler anzuzeigen. Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standard und entfernt die Obergrenze. Für unbeaufsichtigte Sitzungen, die längere Ausfälle abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |

323| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | In v2.1.224 entfernt und jetzt wirkungslos. Begrenzte zuvor die Gesamtzahl der [Subagenten](/docs/de/sub-agents), die Claude mit dem Agent-Tool in einer Sitzung starten konnte (Standard: 200); das Starten über die Obergrenze hinaus schlug mit `Subagent spawn limit reached` fehl. Das [Limit für gleichzeitige Subagenten](/docs/de/sub-agents#concurrent-subagent-limit) und das [Tiefenlimit](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) gelten weiterhin |319| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | In v2.1.224 entfernt und jetzt wirkungslos. Begrenzte zuvor die Gesamtzahl der [Subagenten](/docs/de/sub-agents), die Claude mit dem Agent-Tool in einer Sitzung starten konnte (Standard: 200); das Starten über die Obergrenze hinaus schlug mit `Subagent spawn limit reached` fehl. Das [Limit für gleichzeitige Subagenten](/docs/de/sub-agents#concurrent-subagent-limit) und das [Tiefenlimit](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) gelten weiterhin |

324| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Anzahl der [Subagenten-Ebenen](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents), die unterhalb der Hauptkonversation zulässig sind (Standard: 3). Beim Standard können Subagenten ihre eigenen Subagenten starten, und ein Subagent auf der dritten Ebene kann keine weiteren starten; setzen Sie `1`, um die Verschachtelung auszuschalten. In v2.1.217 bis v2.1.218 war der Standard 1, sodass ein Subagent keine eigenen starten konnte, sofern Sie das Limit nicht erhöhten; v2.1.219 erhöhte den Standard auf 3. Akzeptiert eine positive ganze Zahl in reinen Ziffern; alles andere wird ignoriert, sodass das Limit angepasst, aber nicht entfernt werden kann. Erfordert Claude Code v2.1.217 oder höher |320| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Anzahl der [Subagenten-Ebenen](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents), die unterhalb der Hauptkonversation zulässig sind (Standard: 3). Beim Standard können Subagenten ihre eigenen Subagenten starten, und ein Subagent auf der dritten Ebene kann keine weiteren starten; setzen Sie `1`, um die Verschachtelung auszuschalten. In v2.1.217 bis v2.1.218 war der Standard 1, sodass ein Subagent keine eigenen starten konnte, sofern Sie das Limit nicht erhöhten; v2.1.219 erhöhte den Standard auf 3. Akzeptiert eine positive ganze Zahl in reinen Ziffern; alles andere wird ignoriert, sodass das Limit angepasst, aber nicht entfernt werden kann. Erfordert Claude Code v2.1.217 oder höher |

325| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl nur lesender Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen |

326| `CLAUDE_CODE_MAX_TURNS` | Begrenzt die Anzahl agentischer Turns, wenn kein explizites Limit übergeben wird. Entspricht der Übergabe von [`--max-turns`](/docs/de/cli-reference#cli-flags), das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive ganze Zahl ist, wird beim Start mit einem Fehler abgelehnt, statt als unbegrenzt behandelt zu werden |321| `CLAUDE_CODE_MAX_TURNS` | Begrenzt die Anzahl agentischer Turns, wenn kein explizites Limit übergeben wird. Entspricht der Übergabe von [`--max-turns`](/docs/de/cli-reference#cli-flags), das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive ganze Zahl ist, wird beim Start mit einem Fehler abgelehnt, statt als unbegrenzt behandelt zu werden |

327| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Obergrenze für [WebSearch](/docs/de/tools-reference#session-search-limit)-Aufrufe (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe einen Hinweis zurück, der Claude anweist, mit den bereits gesammelten Informationen fortzufahren und dies in der Antwort zu erwähnen. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert, und der Standard gilt, sodass die Obergrenze erhöht, aber nicht deaktiviert werden kann. Erfordert Claude Code v2.1.212 oder höher |322| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Obergrenze für [WebSearch](/docs/de/tools-reference#session-search-limit)-Aufrufe (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe einen Hinweis zurück, der Claude anweist, mit den bereits gesammelten Informationen fortzufahren und dies in der Antwort zu erwähnen. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert, und der Standard gilt, sodass die Obergrenze erhöht, aber nicht deaktiviert werden kann. Erfordert Claude Code v2.1.212 oder höher |

328| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Auf `1` setzen, um stdio-MCP-Server nur mit einer sicheren Basisumgebung plus dem konfigurierten `env` des Servers zu starten, statt Ihre Shell-Umgebung zu erben |323| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Auf `1` setzen, um stdio-MCP-Server nur mit einer sicheren Basisumgebung plus dem konfigurierten `env` des Servers zu starten, statt Ihre Shell-Umgebung zu erben |

329| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Verstrichene Zeit in Millisekunden, bevor ein noch laufender MCP-Tool-Aufruf [in eine Hintergrundaufgabe verschoben wird](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) (Standard: 120000, also 2 Minuten). Auf `0` setzen, um das automatische Verschieben in den Hintergrund auszuschalten. Erfordert Claude Code v2.1.212 oder höher |324| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Verstrichene Zeit in Millisekunden, bevor ein noch laufender MCP-Tool-Aufruf [in eine Hintergrundaufgabe verschoben wird](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) (Standard: 120000, also 2 Minuten). Auf `0` setzen, um das automatische Verschieben in den Hintergrund auszuschalten. Erfordert Claude Code v2.1.212 oder höher |

330| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Wie lange in Millisekunden der erste Turn einer [nicht interaktiven](/docs/de/headless) Sitzung auf MCP-Server wartet, die sich noch verbinden, anstelle der standardmäßigen [Wartezeit im ersten Turn](/docs/de/agent-sdk/mcp#connection-timing). Wenn gesetzt, gilt die Wartezeit für jeden ausstehenden Server; in einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments-configuration#connection-timing) ändert sie nur, wie lange die Wartezeit dauert. Auf `0` setzen, um die Wartezeit zu überspringen. Ein [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Server behält unabhängig vom Wert seine eigene `MCP_TIMEOUT`-Wartezeit. Erfordert Claude Code v2.1.274 oder höher |325| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Wie lange in Millisekunden der erste Turn einer [nicht interaktiven](/docs/de/headless) Sitzung auf MCP-Server wartet, die noch eine Verbindung aufbauen, anstelle der standardmäßigen [Wartezeit beim ersten Turn](/docs/de/agent-sdk/mcp#connection-timing). In einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments-configuration#connection-timing) ändert sie nur die Dauer der Wartezeit. Einige Server behalten unabhängig vom Wert eine eigene Wartezeit bei; [Verbindungszeitpunkt](/docs/de/agent-sdk/mcp#connection-timing) listet sie auf. Auf `0` setzen, um die Wartezeit für alle anderen Server zu überspringen. Erfordert Claude Code v2.1.274 oder höher |

331| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Leerlauf-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Konnektor](/docs/de/mcp#use-mcp-servers-from-claude-ai)-MCP-Server so lange weder eine Antwort noch eine Fortschrittsbenachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, statt auf den gesamten `MCP_TOOL_TIMEOUT` zu warten. Überschreibt die transportspezifischen Standardwerte von 300000 (5 Minuten) für Netzwerkserver und 1800000 (30 Minuten) für stdio-Server. Auf `0` setzen, um die Leerlaufprüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde angehoben, und der Wert ist auf den effektiven `MCP_TOOL_TIMEOUT` begrenzt. Ein serverspezifischer `timeout` in `.mcp.json` von mindestens 1000 hebt das Leerlauffenster dieses Servers auf mindestens den `timeout`-Wert an. Gilt nicht für IDE-Server oder prozessinterne SDK-Server. Erfordert Claude Code v2.1.187 oder höher. Vor v2.1.203 waren stdio-Server vom Leerlauf-Timeout ausgenommen |326| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Leerlauf-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Konnektor](/docs/de/mcp#use-mcp-servers-from-claude-ai)-MCP-Server so lange weder eine Antwort noch eine Fortschrittsbenachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, statt auf den gesamten `MCP_TOOL_TIMEOUT` zu warten. Überschreibt die transportspezifischen Standardwerte von 300000 (5 Minuten) für Netzwerkserver und 1800000 (30 Minuten) für stdio-Server. Auf `0` setzen, um die Leerlaufprüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde angehoben, und der Wert ist auf den effektiven `MCP_TOOL_TIMEOUT` begrenzt. Ein serverspezifischer `timeout` in `.mcp.json` von mindestens 1000 hebt das Leerlauffenster dieses Servers auf mindestens den `timeout`-Wert an. Gilt nicht für IDE-Server oder prozessinterne SDK-Server. Erfordert Claude Code v2.1.187 oder höher. Vor v2.1.203 waren stdio-Server vom Leerlauf-Timeout ausgenommen |

332| `CLAUDE_CODE_MESSAGING_SOCKET` | Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code den Pfad dieses Sockets an Hooks und Bash-Befehle, wenn es den Socket bindet. In einer Sitzung, die mit aktiviertem Messaging startet, bindet Claude Code den Socket, bevor ein Hook ausgeführt wird. Andere Sitzungen auf dem Rechner stellen Nachrichten an diesen Pfad zu. Jede Sitzung exportiert ihren eigenen Socket statt eines von einem übergeordneten Prozess geerbten, und darauf eingehende Nachrichten durchlaufen die [Steuerung eingehender Nachrichten](/docs/de/cross-session-messaging#control-inbound-messages) der Sitzung. `env`-Blöcke in Einstellungen können die Variable nicht setzen. Erfordert Claude Code v2.1.224 oder höher |327| `CLAUDE_CODE_MESSAGING_SOCKET` | Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code den Pfad dieses Sockets an Hooks und Bash-Befehle, wenn es den Socket bindet. In einer Sitzung, die mit aktiviertem Messaging startet, bindet Claude Code den Socket, bevor ein Hook ausgeführt wird. Andere Sitzungen auf dem Rechner stellen Nachrichten an diesen Pfad zu. Jede Sitzung exportiert ihren eigenen Socket statt eines von einem übergeordneten Prozess geerbten, und darauf eingehende Nachrichten durchlaufen die [Steuerung eingehender Nachrichten](/docs/de/cross-session-messaging#control-inbound-messages) der Sitzung. `env`-Blöcke in Einstellungen können die Variable nicht setzen. Erfordert Claude Code v2.1.224 oder höher |

333| `CLAUDE_CODE_MESSAGING_TOKEN` | Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code dieses sitzungsspezifische Token zusammen mit `CLAUDE_CODE_MESSAGING_SOCKET` an Hooks und Bash-Befehle. Ein Skript, das an den Socket sendet, kann `{"type":"auth","token":"<token>"}` als erste Zeile senden, um nachzuweisen, dass es zur Sitzung gehört. Unter nativem Windows verlangt Claude Code diese Zeile und schließt jede Verbindung, die nicht mit einer gültigen Zeile beginnt. Die [Regeln für eigene Kindprozesse](/docs/de/cross-session-messaging#the-sessions-inbox-socket) legen fest, wann Claude Code das Token heranzieht. Jede Sitzung exportiert ihr eigenes Token, nie eines, das von einer übergeordneten Sitzung geerbt wurde. `env`-Blöcke in Einstellungen können die Variable nicht setzen. Erfordert Claude Code v2.1.228 oder höher |328| `CLAUDE_CODE_MESSAGING_TOKEN` | Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code dieses sitzungsspezifische Token zusammen mit `CLAUDE_CODE_MESSAGING_SOCKET` an Hooks und Bash-Befehle. Ein Skript, das an den Socket sendet, kann `{"type":"auth","token":"<token>"}` als erste Zeile senden, um nachzuweisen, dass es zur Sitzung gehört. Unter nativem Windows verlangt Claude Code diese Zeile und schließt jede Verbindung, die nicht mit einer gültigen Zeile beginnt. Die [Regeln für eigene Kindprozesse](/docs/de/cross-session-messaging#the-sessions-inbox-socket) legen fest, wann Claude Code das Token heranzieht. Jede Sitzung exportiert ihr eigenes Token, nie eines, das von einer übergeordneten Sitzung geerbt wurde. `env`-Blöcke in Einstellungen können die Variable nicht setzen. Erfordert Claude Code v2.1.228 oder höher |


372| `CLAUDE_CODE_RESUME_PROMPT` | Überschreibt die Fortsetzungsnachricht, die Claude Code an Claude sendet, wenn `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` einen unterbrochenen Turn fortsetzt, statt dessen Prompt erneut zu senden, oder wenn Sie einen [zurückgestellten Tool-Aufruf](/docs/de/hooks#defer-a-tool-call-for-later) mit `-p` fortsetzen. Standardmäßig `Continue from where you left off.`. Eine leere Zeichenfolge verwendet den Standard |367| `CLAUDE_CODE_RESUME_PROMPT` | Überschreibt die Fortsetzungsnachricht, die Claude Code an Claude sendet, wenn `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` einen unterbrochenen Turn fortsetzt, statt dessen Prompt erneut zu senden, oder wenn Sie einen [zurückgestellten Tool-Aufruf](/docs/de/hooks#defer-a-tool-call-for-later) mit `-p` fortsetzen. Standardmäßig `Continue from where you left off.`. Eine leere Zeichenfolge verwendet den Standard |

373| `CLAUDE_CODE_RETRY_WATCHDOG` | Für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker auf `1` setzen. Wiederholt Kapazitätsfehler `429` und `529` unbegrenzt, statt nach `CLAUDE_CODE_MAX_RETRIES` Versuchen fehlzuschlagen. Claude Code schlägt sofort fehl, wenn eine Anfrage mit Standardgeschwindigkeit einen `429` erhält, der ein Ausgabenlimit oder aufgebrauchtes Nutzungsguthaben meldet, selbst einen von einer [Gateway-Ausgabenobergrenze](/docs/de/errors#spend-limit-reached), die nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 wiederholte der Watchdog diese unbegrenzt. Für Anfragen im Fast-Modus siehe [Rate-Limits handhaben](/docs/de/fast-mode#handle-rate-limits). Der Watchdog wartet zwischen den Versuchen bis zu 5 Minuten oder bis das Limit zurückgesetzt wird, wenn die Antwort einen Rücksetzzeitpunkt für das Rate-Limit enthält, sodass eine Sitzung, die ein Nutzungslimit erreicht, das verbleibende Zeitfenster abwartet. Ab v2.1.199 erhöht er außerdem die standardmäßige Anzahl von Wiederholungsversuchen für andere vorübergehende Fehler wie Serverfehler, Timeouts und abgebrochene Verbindungen auf 300, was etwa drei Stunden Backoff entspricht, und hebt die Obergrenze von 15 für `CLAUDE_CODE_MAX_RETRIES` auf, falls Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder höher |368| `CLAUDE_CODE_RETRY_WATCHDOG` | Für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker auf `1` setzen. Wiederholt Kapazitätsfehler `429` und `529` unbegrenzt, statt nach `CLAUDE_CODE_MAX_RETRIES` Versuchen fehlzuschlagen. Claude Code schlägt sofort fehl, wenn eine Anfrage mit Standardgeschwindigkeit einen `429` erhält, der ein Ausgabenlimit oder aufgebrauchtes Nutzungsguthaben meldet, selbst einen von einer [Gateway-Ausgabenobergrenze](/docs/de/errors#spend-limit-reached), die nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 wiederholte der Watchdog diese unbegrenzt. Für Anfragen im Fast-Modus siehe [Rate-Limits handhaben](/docs/de/fast-mode#handle-rate-limits). Der Watchdog wartet zwischen den Versuchen bis zu 5 Minuten oder bis das Limit zurückgesetzt wird, wenn die Antwort einen Rücksetzzeitpunkt für das Rate-Limit enthält, sodass eine Sitzung, die ein Nutzungslimit erreicht, das verbleibende Zeitfenster abwartet. Ab v2.1.199 erhöht er außerdem die standardmäßige Anzahl von Wiederholungsversuchen für andere vorübergehende Fehler wie Serverfehler, Timeouts und abgebrochene Verbindungen auf 300, was etwa drei Stunden Backoff entspricht, und hebt die Obergrenze von 15 für `CLAUDE_CODE_MAX_RETRIES` auf, falls Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder höher |

374| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | Maximale Zeit in Millisekunden, die jede API-Anfrage mit dem Abwarten von `429`- und `529`-Fehlern verbringt, wenn `CLAUDE_CODE_RETRY_WATCHDOG` gesetzt ist. Ist diese Zeit verbraucht, beendet der nächste solche Fehler die Anfrage. Geben Sie eine positive ganze Zahl in reinen Ziffern an, etwa `1800000` für 30 Minuten. Wenn nicht gesetzt, ist die Wartezeit unbegrenzt. Erfordert Claude Code v2.1.295 oder höher |369| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | Maximale Zeit in Millisekunden, die jede API-Anfrage mit dem Abwarten von `429`- und `529`-Fehlern verbringt, wenn `CLAUDE_CODE_RETRY_WATCHDOG` gesetzt ist. Ist diese Zeit verbraucht, beendet der nächste solche Fehler die Anfrage. Geben Sie eine positive ganze Zahl in reinen Ziffern an, etwa `1800000` für 30 Minuten. Wenn nicht gesetzt, ist die Wartezeit unbegrenzt. Erfordert Claude Code v2.1.295 oder höher |

370| `CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS` | Mindestintervall in Millisekunden zwischen Prüfungen, ob ein [Nutzungslimit](/docs/de/errors#youve-hit-your-session-limit) bereits aufgehoben wurde, während eine Anfrage bei gesetztem `CLAUDE_CODE_RETRY_WATCHDOG` auf das Zurücksetzen dieses Limits wartet. Stellt eine Prüfung fest, dass das Limit aufgehoben ist, wird die Anfrage sofort gesendet. Geben Sie eine ganze Zahl in reinen Ziffern von `60000`, einer Minute, bis `10800000`, drei Stunden, an. Prüfungen erfolgen nur für das Sitzungs- oder Wochenlimit eines claude.ai-Abonnements, solange kein Nutzungsguthaben verwendet wird, und nicht, solange `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist. Wenn diese Variable nicht gesetzt ist oder ihr Wert außerhalb dieses Bereichs liegt, erfolgen keine Prüfungen. Erfordert Claude Code v2.1.305 oder höher |

375| `CLAUDE_CODE_SAFE_MODE` | Auf `1` setzen, um im abgesicherten Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Themes, benutzerdefinierte Tastenkombinationen, Statuszeilen- und Dateivorschlagsbefehle, LSP-Server und Auto-Memory werden nicht geladen, um eine defekte Konfiguration zu beheben. Richtlinien aus verwalteten Einstellungen gelten weiterhin, einschließlich per Richtlinie konfigurierter Hooks, Statuszeilen- und Dateivorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und per Richtlinie konfigurierte MCP-Server hingegen nicht. Entspricht der Übergabe von [`--safe-mode`](/docs/de/cli-reference#cli-flags). Direkt gestartete Kindprozesse erben die Variable |371| `CLAUDE_CODE_SAFE_MODE` | Auf `1` setzen, um im abgesicherten Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Themes, benutzerdefinierte Tastenkombinationen, Statuszeilen- und Dateivorschlagsbefehle, LSP-Server und Auto-Memory werden nicht geladen, um eine defekte Konfiguration zu beheben. Richtlinien aus verwalteten Einstellungen gelten weiterhin, einschließlich per Richtlinie konfigurierter Hooks, Statuszeilen- und Dateivorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und per Richtlinie konfigurierte MCP-Server hingegen nicht. Entspricht der Übergabe von [`--safe-mode`](/docs/de/cli-reference#cli-flags). Direkt gestartete Kindprozesse erben die Variable |

376| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft bestimmte Skripte pro Sitzung aufgerufen werden dürfen, wenn `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` gesetzt ist. Schlüssel sind Teilzeichenfolgen, die mit dem Befehlstext abgeglichen werden; Werte sind ganzzahlige Aufruflimits. Beispielsweise erlaubt `{"deploy.sh": 2}`, dass `deploy.sh` höchstens zweimal aufgerufen wird. Der Abgleich basiert auf Teilzeichenfolgen, sodass Shell-Expansionstricks wie `./scripts/deploy.sh $(evil)` trotzdem auf die Obergrenze angerechnet werden. Eine Auffächerung zur Laufzeit über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Maßnahme |372| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft bestimmte Skripte pro Sitzung aufgerufen werden dürfen, wenn `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` gesetzt ist. Schlüssel sind Teilzeichenfolgen, die mit dem Befehlstext abgeglichen werden; Werte sind ganzzahlige Aufruflimits. Beispielsweise erlaubt `{"deploy.sh": 2}`, dass `deploy.sh` höchstens zweimal aufgerufen wird. Der Abgleich basiert auf Teilzeichenfolgen, sodass Shell-Expansionstricks wie `./scripts/deploy.sh $(evil)` trotzdem auf die Obergrenze angerechnet werden. Eine Auffächerung zur Laufzeit über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Maßnahme |

377| `CLAUDE_CODE_SCROLL_SPEED` | Legt den Multiplikator für das Scrollen mit dem Mausrad im [Vollbild-Rendering](/docs/de/fullscreen#mouse-wheel-scrolling) fest. Akzeptiert jeden positiven Wert bis 20, einschließlich Bruchwerten unter 1 wie `0.5`, um beschleunigtes Trackpad- und Mausradscrollen in Terminals zu verlangsamen, die Mausradereignisse bereits verstärken. Auf `3` setzen, um `vim` zu entsprechen, wenn Ihr Terminal ohne Verstärkung ein Mausradereignis pro Raste sendet. Wird im Terminal der JetBrains IDE ignoriert, wo Claude Code seine eigene Scroll-Verarbeitung verwendet |373| `CLAUDE_CODE_SCROLL_SPEED` | Legt den Multiplikator für das Scrollen mit dem Mausrad im [Vollbild-Rendering](/docs/de/fullscreen#mouse-wheel-scrolling) fest. Akzeptiert jeden positiven Wert bis 20, einschließlich Bruchwerten unter 1 wie `0.5`, um beschleunigtes Trackpad- und Mausradscrollen in Terminals zu verlangsamen, die Mausradereignisse bereits verstärken. Auf `3` setzen, um `vim` zu entsprechen, wenn Ihr Terminal ohne Verstärkung ein Mausradereignis pro Raste sendet. Wird im Terminal der JetBrains IDE ignoriert, wo Claude Code seine eigene Scroll-Verarbeitung verwendet |


405| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in Millisekunden, wie lange die erste Abfrage auf die anfängliche Skill-Liste wartet, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 5000). Bei Überschreitung läuft die erste Abfrage mit den bereits eingetroffenen Skills. Die Downloads werden in jedem Fall im Hintergrund abgeschlossen, und Claude wartet auf den Download eines Skills, wenn es diesen Skill aufruft |401| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in Millisekunden, wie lange die erste Abfrage auf die anfängliche Skill-Liste wartet, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 5000). Bei Überschreitung läuft die erste Abfrage mit den bereits eingetroffenen Skills. Die Downloads werden in jedem Fall im Hintergrund abgeschlossen, und Claude wartet auf den Download eines Skills, wenn es diesen Skill aufruft |

406| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Auf `false` setzen, um die Syntaxhervorhebung in der Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihre Terminal-Einrichtung stören. Um die Hervorhebung auch in Codeblöcken und Dateivorschauen zu deaktivieren, verwenden Sie die Einstellung [`syntaxHighlightingDisabled`](/docs/de/settings-reference#syntaxhighlightingdisabled) |402| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Auf `false` setzen, um die Syntaxhervorhebung in der Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihre Terminal-Einrichtung stören. Um die Hervorhebung auch in Codeblöcken und Dateivorschauen zu deaktivieren, verwenden Sie die Einstellung [`syntaxHighlightingDisabled`](/docs/de/settings-reference#syntaxhighlightingdisabled) |

407| `CLAUDE_CODE_TASK_LIST_ID` | Teilt eine Aufgabenliste über Sitzungen hinweg. Setzen Sie dieselbe ID in mehreren Claude Code-Instanzen, um sich über eine gemeinsame Aufgabenliste abzustimmen, in [Sitzungen, die die Task-Tools haben](/docs/de/tools-reference#task-tool-availability). Siehe [Aufgabenliste](/docs/de/interactive-mode#task-list) |403| `CLAUDE_CODE_TASK_LIST_ID` | Teilt eine Aufgabenliste über Sitzungen hinweg. Setzen Sie dieselbe ID in mehreren Claude Code-Instanzen, um sich über eine gemeinsame Aufgabenliste abzustimmen, in [Sitzungen, die die Task-Tools haben](/docs/de/tools-reference#task-tool-availability). Siehe [Aufgabenliste](/docs/de/interactive-mode#task-list) |

408| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Überschreibt in Millisekunden, wie lange eine nicht interaktive Sitzung beim Beenden wartet, bis ihr [Agent-Team](/docs/de/agent-teams) vollständig abgebaut ist. Akzeptiert 1000 bis 60000; ein Wert außerhalb dieses Bereichs wird ignoriert, und der Standard von 10000 gilt. Erfordert Claude Code v2.1.206 oder höher |

409| `CLAUDE_CODE_TMPDIR` | Überschreibt das temporäre Verzeichnis für interne temporäre Dateien. Claude Code hängt unter Unix `/claude-{uid}/` an diesen Pfad an, unter Windows `/claude/`. Standard: `/tmp` unter macOS, `os.tmpdir()` unter Linux und Windows. Unter macOS und Linux erhalten per [Sandboxing](/docs/de/sandboxing) isolierte Bash-Unterprozesse ein kurzes Fallback-`$TMPDIR` unter dem Systemstandard, wenn Ihre Überschreibung ein langer Pfad ist, da einige Tools fehlschlagen, wenn temporäre Pfade zu lang werden. Nicht isolierte Bash-Befehle erben das `$TMPDIR` Ihrer Shell, wenn es gesetzt ist. Unter nativem Windows erhält ein Bash-Befehl, der auf `$TMPDIR` verweist, wenn Ihre Shell `$TMPDIR` nicht setzt, Ihre Überschreibung oder `%TEMP%`, falls Sie keine festgelegt haben. Die eigenen temporären Dateien von Claude Code verwenden immer Ihre Überschreibung. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |404| `CLAUDE_CODE_TMPDIR` | Überschreibt das temporäre Verzeichnis für interne temporäre Dateien. Claude Code hängt unter Unix `/claude-{uid}/` an diesen Pfad an, unter Windows `/claude/`. Standard: `/tmp` unter macOS, `os.tmpdir()` unter Linux und Windows. Unter macOS und Linux erhalten per [Sandboxing](/docs/de/sandboxing) isolierte Bash-Unterprozesse ein kurzes Fallback-`$TMPDIR` unter dem Systemstandard, wenn Ihre Überschreibung ein langer Pfad ist, da einige Tools fehlschlagen, wenn temporäre Pfade zu lang werden. Nicht isolierte Bash-Befehle erben das `$TMPDIR` Ihrer Shell, wenn es gesetzt ist. Unter nativem Windows erhält ein Bash-Befehl, der auf `$TMPDIR` verweist, wenn Ihre Shell `$TMPDIR` nicht setzt, Ihre Überschreibung oder `%TEMP%`, falls Sie keine festgelegt haben. Die eigenen temporären Dateien von Claude Code verwenden immer Ihre Überschreibung. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

410| `CLAUDE_CODE_TMUX_TRUECOLOR` | Auf einen beliebigen nicht leeren Wert wie `1` setzen, um 24-Bit-Truecolor-Ausgabe innerhalb von tmux zu erlauben. **Das Setzen auf `0` oder `false` erlaubt Truecolor trotzdem**, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Begrenzung auf 256 Farben wiederherzustellen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, da tmux Truecolor-Escape-Sequenzen nur durchreicht, wenn es dafür konfiguriert ist. Setzen Sie dies, nachdem Sie `set -ga terminal-overrides ',*:Tc'` zu Ihrer `~/.tmux.conf` hinzugefügt haben. Siehe [Terminal-Konfiguration](/docs/de/terminal-config) für weitere tmux-Einstellungen |405| `CLAUDE_CODE_TMUX_TRUECOLOR` | Auf einen beliebigen nicht leeren Wert wie `1` setzen, um 24-Bit-Truecolor-Ausgabe innerhalb von tmux zu erlauben. **Das Setzen auf `0` oder `false` erlaubt Truecolor trotzdem**, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Begrenzung auf 256 Farben wiederherzustellen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, da tmux Truecolor-Escape-Sequenzen nur durchreicht, wenn es dafür konfiguriert ist. Setzen Sie dies, nachdem Sie `set -ga terminal-overrides ',*:Tc'` zu Ihrer `~/.tmux.conf` hinzugefügt haben. Siehe [Terminal-Konfiguration](/docs/de/terminal-config) für weitere tmux-Einstellungen |

411| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Unter Linux und WSL auf eine kommagetrennte Liste der Prozessarten setzen, die Claude Code [von der Speicherobergrenze für Tools ausnimmt](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), etwa `mcp` oder `lsp`. Setzen Sie `none`, um jede Art zu begrenzen, oder `all-new`, um nur Befehle der Tools Bash, PowerShell und Monitor zu begrenzen. Claude Code hält Befehle der Tools Bash, PowerShell und Monitor unabhängig von Ihrer Liste unter der Obergrenze. Erfordert Claude Code v2.1.246 oder höher |406| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Unter Linux und WSL auf eine kommagetrennte Liste der Prozessarten setzen, die Claude Code [von der Speicherobergrenze für Tools ausnimmt](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), etwa `mcp` oder `lsp`. Setzen Sie `none`, um jede Art zu begrenzen, oder `all-new`, um nur Befehle der Tools Bash, PowerShell und Monitor zu begrenzen. Claude Code hält Befehle der Tools Bash, PowerShell und Monitor unabhängig von Ihrer Liste unter der Obergrenze. Erfordert Claude Code v2.1.246 oder höher |

412| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Unter Linux und WSL auf eine Größe wie `4G` setzen, um [den Speicher zu begrenzen, den Befehle der Tools Bash und PowerShell verwenden können](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), ab v2.1.246 auch Befehle des Monitor-Tools. Schreiben Sie die Größe in reinen Ziffern, allein für eine Anzahl von Bytes oder mit einem Suffix `K`, `M`, `G` oder `T`. Setzen Sie `0` oder `off`, um die Obergrenze auszuschalten. Sobald der erste Prozess, den Claude Code startet, die Obergrenze ein- oder ausgeschaltet hat, wird ein geänderter Wert beim nächsten Start von `claude` wirksam. Erfordert Claude Code v2.1.233 oder höher |407| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Unter Linux und WSL auf eine Größe wie `4G` setzen, um [den Speicher zu begrenzen, den Befehle der Tools Bash und PowerShell verwenden können](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), ab v2.1.246 auch Befehle des Monitor-Tools. Schreiben Sie die Größe in reinen Ziffern, allein für eine Anzahl von Bytes oder mit einem Suffix `K`, `M`, `G` oder `T`. Setzen Sie `0` oder `off`, um die Obergrenze auszuschalten. Sobald der erste Prozess, den Claude Code startet, die Obergrenze ein- oder ausgeschaltet hat, wird ein geänderter Wert beim nächsten Start von `claude` wirksam. Erfordert Claude Code v2.1.233 oder höher |

413| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Auf `1` setzen, um zu begrenzen, wie groß die [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) einer langen `-p`- oder Agent SDK-Sitzung wird. Nach jeder Komprimierung entfernt Claude Code, sobald die Datei größer als 5 MB ist, den Verlauf vor dieser Komprimierung. Das Fortsetzen der Sitzung stellt dieselbe Konversation wieder her, unabhängig davon, ob die Datei gekürzt wurde. Setzen Sie die Variable in der Umgebung, aus der Sie Claude Code starten, da ein `env`-Block in Einstellungen sie nicht aktivieren kann. Erfordert Claude Code v2.1.287 oder höher |408| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Auf `1` setzen, um zu begrenzen, wie groß die [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) einer langen `-p`- oder Agent-SDK-Sitzung wird. Nach jeder Komprimierung entfernt Claude Code, sobald die Datei größer als 5 MB ist, den Verlauf vor dieser Komprimierung. Ab v2.1.296 bleibt die Datei unverändert, wenn das Entfernen dieses Verlaufs sie um weniger als 10 % verkleinern würde. Beim Fortsetzen der Sitzung wird dieselbe Konversation wiederhergestellt, unabhängig davon, ob die Datei gekürzt wurde. Setzen Sie die Variable in der Umgebung, aus der Sie Claude Code starten, da ein `env`-Block in den Einstellungen sie nicht aktivieren kann. Erfordert Claude Code v2.1.287 oder neuer |

414| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Frist in Millisekunden, bevor Claude Code einen Dialog abbricht, den es an einen Remote-Client wie einen [Remote Control](/docs/de/remote-control)- oder SDK-Host weiterleitet, oder den Genehmigungsdialog für eine [zurückgehaltene sitzungsübergreifende Nachricht](/docs/de/cross-session-messaging#control-inbound-messages); Berechtigungsabfragen und `AskUserQuestion`-Fragen verwenden eigene Abläufe und werden davon nicht gesteuert. Ab Claude Code v2.1.236 begrenzt die Variable außerdem die während der Sitzung angezeigte [Zustimmungsabfrage zum Fable-Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) in einer Sitzung, die möglicherweise unbeaufsichtigt läuft. [Eingehende Nachrichten steuern](/docs/de/cross-session-messaging#control-inbound-messages) und [Nicht interaktive Sitzungen](/docs/de/cross-session-messaging#non-interactive-sessions) beschreiben die vollständigen Ablaufregeln für zurückgehaltene Nachrichten, einschließlich der Fälle, in denen die Frist nicht gilt. Überschreibt die Einstellung [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry). `0` oder ein negativer Wert deaktiviert die Frist. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |409| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Frist in Millisekunden, bevor Claude Code einen Dialog abbricht, den es an einen Remote-Client wie einen [Remote Control](/docs/de/remote-control)- oder SDK-Host weiterleitet, oder den Genehmigungsdialog für eine [zurückgehaltene sitzungsübergreifende Nachricht](/docs/de/cross-session-messaging#control-inbound-messages); Berechtigungsabfragen und `AskUserQuestion`-Fragen verwenden eigene Abläufe und werden davon nicht gesteuert. Ab Claude Code v2.1.236 begrenzt die Variable außerdem die während der Sitzung angezeigte [Zustimmungsabfrage zum Fable-Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) in einer Sitzung, die möglicherweise unbeaufsichtigt läuft. [Eingehende Nachrichten steuern](/docs/de/cross-session-messaging#control-inbound-messages) und [Nicht interaktive Sitzungen](/docs/de/cross-session-messaging#non-interactive-sessions) beschreiben die vollständigen Ablaufregeln für zurückgehaltene Nachrichten, einschließlich der Fälle, in denen die Frist nicht gilt. Überschreibt die Einstellung [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry). `0` oder ein negativer Wert deaktiviert die Frist. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

415| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/de/claude-platform-on-aws) verwenden |410| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/de/claude-platform-on-aws) verwenden |

416| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/de/amazon-bedrock) verwenden |411| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/de/amazon-bedrock) verwenden |

417| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/de/microsoft-foundry) verwenden |412| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/de/microsoft-foundry) verwenden |

418| `CLAUDE_CODE_USE_MANTLE` | Den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) von Amazon Bedrock verwenden |413| `CLAUDE_CODE_USE_MANTLE` | Den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) von Amazon Bedrock verwenden |

419| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Auf `1` setzen, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit Node.js-Datei-APIs statt mit ripgrep zu ermitteln. Setzen Sie dies, wenn die mitgelieferte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Wirkt sich nicht auf die Tools Grep oder Dateisuche aus |

420| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Unter Windows ohne Git Bash wird das Tool automatisch aktiviert; setzen Sie `0`, um es zu deaktivieren. Unter Windows mit installiertem Git Bash ist das Tool für claude.ai- und Console-Konten standardmäßig aktiviert; setzen Sie `1`, um es in Sitzungen mit Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry zu aktivieren, oder `0`, um es auszuschalten. Unter Linux, macOS und WSL setzen Sie `1`, um es zu aktivieren; dafür muss `pwsh` in Ihrem `PATH` liegen. Wenn das Tool unter Windows aktiviert ist, kann Claude PowerShell-Befehle nativ ausführen, statt sie über Git Bash zu leiten. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) |414| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Unter Windows ohne Git Bash wird das Tool automatisch aktiviert; setzen Sie `0`, um es zu deaktivieren. Unter Windows mit installiertem Git Bash ist das Tool für claude.ai- und Console-Konten standardmäßig aktiviert; setzen Sie `1`, um es in Sitzungen mit Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry zu aktivieren, oder `0`, um es auszuschalten. Unter Linux, macOS und WSL setzen Sie `1`, um es zu aktivieren; dafür muss `pwsh` in Ihrem `PATH` liegen. Wenn das Tool unter Windows aktiviert ist, kann Claude PowerShell-Befehle nativ ausführen, statt sie über Git Bash zu leiten. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) |

421| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) verwenden |415| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) verwenden |

422| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Auf die Anzahl der Millisekunden setzen, die [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) die Antwort jeder abgerufenen URL im Cache behält. Der Standardwert ist `900000`, also 15 Minuten. Akzeptiert nur reine Ziffern; `0`, eine Dezimalzahl oder jede andere Schreibweise behält den Standardwert bei. Claude Code liest den Wert einmal pro Start, daher wird eine Änderung in einem `env`-Block der Einstellungen beim nächsten Start von `claude` wirksam. Erfordert Claude Code v2.1.233 oder höher |416| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Auf die Anzahl der Millisekunden setzen, die [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) die Antwort jeder abgerufenen URL im Cache behält. Der Standardwert ist `900000`, also 15 Minuten. Akzeptiert nur reine Ziffern; `0`, eine Dezimalzahl oder jede andere Schreibweise behält den Standardwert bei. Claude Code liest den Wert einmal pro Start, daher wird eine Änderung in einem `env`-Block der Einstellungen beim nächsten Start von `claude` wirksam. Erfordert Claude Code v2.1.233 oder höher |


427| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Obergrenze in Millisekunden dafür, wie lange ein [Workflow](/docs/de/workflows)-Agent darauf wartet, dass die erste Antwort eines Geschwisteragenten mit demselben Präfix beginnt, bevor er seine eigene erste Anfrage sendet. Wenn ein Fan-out mehrere Agenten startet, die sich ein [Prompt-Cache-Präfix](/docs/de/workflows#prompt-caching-in-a-fan-out) teilen, hält Claude Code alle Agenten außer dem ersten bis zu dieser Dauer zurück, damit die übrigen das zwischengespeicherte Präfix lesen, statt es jeweils ohne Cache zu verarbeiten. Standardwert `5000`. Setzen Sie `0`, um das Warten zu deaktivieren. Wenn `DISABLE_PROMPT_CACHING` gesetzt ist, warten Agenten nie. Erfordert Claude Code v2.1.229 oder höher |421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Obergrenze in Millisekunden dafür, wie lange ein [Workflow](/docs/de/workflows)-Agent darauf wartet, dass die erste Antwort eines Geschwisteragenten mit demselben Präfix beginnt, bevor er seine eigene erste Anfrage sendet. Wenn ein Fan-out mehrere Agenten startet, die sich ein [Prompt-Cache-Präfix](/docs/de/workflows#prompt-caching-in-a-fan-out) teilen, hält Claude Code alle Agenten außer dem ersten bis zu dieser Dauer zurück, damit die übrigen das zwischengespeicherte Präfix lesen, statt es jeweils ohne Cache zu verarbeiten. Standardwert `5000`. Setzen Sie `0`, um das Warten zu deaktivieren. Wenn `DISABLE_PROMPT_CACHING` gesetzt ist, warten Agenten nie. Erfordert Claude Code v2.1.229 oder höher |

428| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | Auf `1` setzen, um oberhalb des Prompts für jede der letzten drei Prüfungen, die der [Mod „You should know“](/docs/de/interactive-mode#you-should-know-suggestions) in dieser Sitzung durchgeführt hat, eine Zeile anzuzeigen. Verwenden Sie dies, um zu bestätigen, dass der Mod prüft, wenn keine Hinweise erscheinen. Erfordert Claude Code v2.1.287 oder höher |422| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | Auf `1` setzen, um oberhalb des Prompts für jede der letzten drei Prüfungen, die der [Mod „You should know“](/docs/de/interactive-mode#you-should-know-suggestions) in dieser Sitzung durchgeführt hat, eine Zeile anzuzeigen. Verwenden Sie dies, um zu bestätigen, dass der Mod prüft, wenn keine Hinweise erscheinen. Erfordert Claude Code v2.1.287 oder höher |

429| `CLAUDE_CONFIG_DIR` | Überschreibt das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, der Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert. Informationen zu Anmeldedaten finden Sie unter [wo Claude Code Anmeldedaten speichert](/docs/de/authentication#credential-management). Nützlich, um mehrere Konten parallel zu betreiben: zum Beispiel `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in den verwalteten Einstellungen. Schreiben Sie in einer Einstellungsdatei den [absoluten Pfad](#in-settings-files). Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |423| `CLAUDE_CONFIG_DIR` | Überschreibt das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, der Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert. Informationen zu Anmeldedaten finden Sie unter [wo Claude Code Anmeldedaten speichert](/docs/de/authentication#credential-management). Nützlich, um mehrere Konten parallel zu betreiben: zum Beispiel `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in den verwalteten Einstellungen. Schreiben Sie in einer Einstellungsdatei den [absoluten Pfad](#in-settings-files). Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

430| `CLAUDE_DISABLE_ADOPT` | Auf `1` setzen, um laufende Hintergrundarbeit zu stoppen, statt sie zu übernehmen, wenn Sie eine Sitzung durch Drücken von `←` oder mit [`/background`](/docs/de/agent-view#from-inside-a-session) in den Hintergrund verschieben. Claude Code bittet Sie vor dem Verschieben in den Hintergrund um Bestätigung und stoppt dann die Aufgaben, die sonst übernommen würden. Erfordert Claude Code v2.1.195 oder höher |

431| `CLAUDE_EFFORT` | Wird in Subprozessen des Bash-Tools und in Hook-Befehlen automatisch auf die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) gesetzt, die beim Start des Subprozesses gilt: `low`, `medium`, `high`, `xhigh` oder `max`. Entspricht dem Feld `effort.level`, das an [Hooks](/docs/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |424| `CLAUDE_EFFORT` | Wird in Subprozessen des Bash-Tools und in Hook-Befehlen automatisch auf die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) gesetzt, die beim Start des Subprozesses gilt: `low`, `medium`, `high`, `xhigh` oder `max`. Entspricht dem Feld `effort.level`, das an [Hooks](/docs/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |

432| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Auf `1` setzen, um den Streaming-Leerlauf-Watchdog auf Byte-Ebene zwangsweise zu aktivieren, oder auf `0`, um ihn zwangsweise zu deaktivieren. `0` schaltet außerdem die [Erstbyte-Frist](/docs/de/network-config#streaming-idle-watchdogs) auf den Verbindungen aus, auf denen diese Frist läuft. Wenn die Variable nicht gesetzt ist, ist der Watchdog standardmäßig für direkte Verbindungen zur Anthropic API und zu [Claude Platform on AWS](/docs/de/claude-platform-on-aws) aktiviert sowie für Streaming-Antworten auf [Gateway](/docs/de/gateways)-Verbindungen, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht werden; vor v2.1.222 lief er auf diesen Gateway-Verbindungen nicht, sodass der Watchdog auf Ereignisebene dort einen Stillstand melden konnte, obwohl Keep-alive-Pings eintrafen. Zu Timeouts und dem Zusammenspiel der Timer siehe [Streaming-Leerlauf-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Auf `1` setzen, um den Streaming-Leerlauf-Watchdog auf Byte-Ebene zwangsweise zu aktivieren, oder auf `0`, um ihn zwangsweise zu deaktivieren. `0` schaltet außerdem die [Erstbyte-Frist](/docs/de/network-config#streaming-idle-watchdogs) auf den Verbindungen aus, auf denen diese Frist läuft. Wenn die Variable nicht gesetzt ist, ist der Watchdog standardmäßig für direkte Verbindungen zur Anthropic API und zu [Claude Platform on AWS](/docs/de/claude-platform-on-aws) aktiviert sowie für Streaming-Antworten auf [Gateway](/docs/de/gateways)-Verbindungen, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht werden; vor v2.1.222 lief er auf diesen Gateway-Verbindungen nicht, sodass der Watchdog auf Ereignisebene dort einen Stillstand melden konnte, obwohl Keep-alive-Pings eintrafen. Zu Timeouts und dem Zusammenspiel der Timer siehe [Streaming-Leerlauf-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |

433| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Auf `1` setzen, um den Streaming-Leerlauf-Watchdog auf Byte-Ebene für Amazon-Bedrock-Antworten vom Typ `vnd.amazon.eventstream` zu aktivieren, wodurch auch die [Erstbyte-Frist](/docs/de/network-config#streaming-idle-watchdogs) für Bedrock-Streaming-Anfragen aktiviert wird. Standardmäßig aus. Konfigurieren Sie den Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Auf `1` setzen, um den Streaming-Leerlauf-Watchdog auf Byte-Ebene für Amazon-Bedrock-Antworten vom Typ `vnd.amazon.eventstream` zu aktivieren, wodurch auch die [Erstbyte-Frist](/docs/de/network-config#streaming-idle-watchdogs) für Bedrock-Streaming-Anfragen aktiviert wird. Standardmäßig aus. Konfigurieren Sie den Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |


465| `DO_NOT_TRACK` | Auf `1` setzen, um die Telemetrie abzulehnen, mit derselben Wirkung wie `DISABLE_TELEMETRY`, auch auf das [Abrufen von Feature-Flags](#features-that-need-feature-flag-fetching). Claude Code liest diese Variable als Standard-Boolean, sodass `0` die Telemetrie eingeschaltet lässt, und berücksichtigt sie als toolübergreifende Konvention, die von vielen Entwickler-CLIs erkannt wird |458| `DO_NOT_TRACK` | Auf `1` setzen, um die Telemetrie abzulehnen, mit derselben Wirkung wie `DISABLE_TELEMETRY`, auch auf das [Abrufen von Feature-Flags](#features-that-need-feature-flag-fetching). Claude Code liest diese Variable als Standard-Boolean, sodass `0` die Telemetrie eingeschaltet lässt, und berücksichtigt sie als toolübergreifende Konvention, die von vielen Entwickler-CLIs erkannt wird |

466| `ENABLE_BETA_TRACING_DETAILED` | Auf `1` setzen und `BETA_TRACING_ENDPOINT` auf Ihren OTLP/HTTP-Collector-Endpunkt setzen, um [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta) einzuschalten, das inhaltstragende Span-Attribute und den Span `claude_code.hook` hinzufügt. Interaktive CLI-Sitzungen erfordern außerdem, dass Ihre Organisation für die Beta freigeschaltet ist. Beide Variablen werden in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |459| `ENABLE_BETA_TRACING_DETAILED` | Auf `1` setzen und `BETA_TRACING_ENDPOINT` auf Ihren OTLP/HTTP-Collector-Endpunkt setzen, um [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta) einzuschalten, das inhaltstragende Span-Attribute und den Span `claude_code.hook` hinzufügt. Interaktive CLI-Sitzungen erfordern außerdem, dass Ihre Organisation für die Beta freigeschaltet ist. Beide Variablen werden in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

467| `ENABLE_CLAUDEAI_MCP_SERVERS` | Auf `false` setzen, damit Claude Code keine [claude.ai-MCP-Server](/docs/de/mcp#use-mcp-servers-from-claude-ai) mehr abruft. Für angemeldete Benutzer standardmäßig aktiviert. Um dies pro Projekt oder pro Organisation zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) in den Einstellungen |460| `ENABLE_CLAUDEAI_MCP_SERVERS` | Auf `false` setzen, damit Claude Code keine [claude.ai-MCP-Server](/docs/de/mcp#use-mcp-servers-from-claude-ai) mehr abruft. Für angemeldete Benutzer standardmäßig aktiviert. Um dies pro Projekt oder pro Organisation zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) in den Einstellungen |

468| `ENABLE_PROMPT_CACHING_1H` | Auf `1` setzen, um eine [Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) von 1 Stunde statt der standardmäßigen 5 Minuten anzufordern. Gedacht für Benutzer mit API-Schlüssel, [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Abonnementbenutzer innerhalb der enthaltenen Nutzung erhalten die 1-Stunden-TTL automatisch für die [Hauptkonversation](/docs/de/prompt-caching#which-ttl-each-request-gets). Abonnementbenutzer, die [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) verwenden, können die Variable setzen, um die 1-Stunden-TTL beizubehalten. 1-Stunden-Cache-Schreibvorgänge werden zu einem höheren Tarif abgerechnet. Um die TTL stattdessen pro Anfragekategorie zu wählen, verwenden Sie `CLAUDE_CODE_PROMPT_CACHE_TTL` und `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, die Vorrang vor dieser Variable haben |461| `ENABLE_PROMPT_CACHING_1H` | Auf `1` setzen, um eine [Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) von 1 Stunde statt der standardmäßigen 5 Minuten anzufordern. Gedacht für Benutzer mit API-Schlüssel, [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Für Abonnementbenutzer innerhalb der enthaltenen Nutzung fordert Claude Code die 1-Stunden-TTL für die [Hauptkonversation](/docs/de/prompt-caching#which-ttl-each-request-gets) automatisch an. Abonnementbenutzer, die [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) in Anspruch nehmen, können die Variable setzen, um die 1-Stunden-TTL beizubehalten. Cache-Schreibvorgänge mit 1 Stunde werden zu einem höheren Satz abgerechnet. Um die TTL getrennt für die Hauptkonversation und für Anfragen außerhalb davon zu wählen, verwenden Sie `CLAUDE_CODE_PROMPT_CACHE_TTL` und `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, die Vorrang vor dieser Variable haben |

469| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Veraltet. Verwenden Sie stattdessen `ENABLE_PROMPT_CACHING_1H` |462| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Veraltet. Verwenden Sie stattdessen `ENABLE_PROMPT_CACHING_1H` |

470| `ENABLE_TOOL_SEARCH` | Steuert [MCP Tool Search](/docs/de/mcp#scale-with-mcp-tool-search). Ohne gesetzte Variable stellt Claude Code standardmäßig alle MCP-Tools zurück und lädt sie stattdessen vorab, wenn `ANTHROPIC_BASE_URL` auf einen Host verweist, der kein First-Party-Host ist. `true` hält sie auch auf einem solchen Host zurückgestellt. `auto` lädt vorab, wenn die Tool-Definitionen in 10 % des Kontexts passen. `auto:N` legt einen benutzerdefinierten Schwellenwert fest, z. B. `auto:5` für 5 %. `false` lädt alle Tools vorab. Zu den Modellen und Bereitstellungen, die unabhängig von diesem Wert jedes Tool vorab laden, siehe [Tool Search konfigurieren](/docs/de/mcp#configure-tool-search) |463| `ENABLE_TOOL_SEARCH` | Steuert [MCP Tool Search](/docs/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt oder `true` lädt MCP-Tools verzögert, außer in den [Fällen, in denen Tool Search ausgeschaltet bleibt](/docs/de/mcp#configure-tool-search). `auto` schaltet Tool Search ein, sobald die Definitionen 10 % des Kontextfensters erreichen. `auto:N` legt einen eigenen Schwellenwert fest, etwa `auto:5` für 5 %. `false` lädt alle Tools von vornherein. Wenn ein Gateway Tool Search ablehnt, siehe [Tool Search über ein LLM-Gateway](/docs/de/mcp#tool-search-through-a-gateway) |

471| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Auf einen beliebigen nicht leeren Wert wie `1` setzen, damit Claude Code bei wiederholten Überlastungsfehlern für jedes Modell die Wiederholungsversuche beendet, wenn kein Fallback-Modell konfiguriert ist. **Auch das Setzen auf `0` oder `false` aktiviert dies**, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um das standardmäßige Wiederholungsverhalten wiederherzustellen. Ohne die Variable beendet Claude Code die Wiederholungsversuche auf diese Weise bei Modellen, die es als Opus-, Fable- oder Mythos-Modelle erkennt, wenn Sie sich mit einem API-Schlüssel oder über einen [Drittanbieter](/docs/de/third-party-integrations) statt mit einem Claude-Abonnement authentifizieren. Ab Claude Code v2.1.160 wechselt Claude Code bei wiederholten Überlastungsfehlern für jedes primäre Modell zu Ihrer konfigurierten [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains), sodass diese Variable den Wechsel zu einem Fallback-Modell nicht beeinflusst |

472| `FORCE_AUTOUPDATE_PLUGINS` | Auf `1` setzen, um automatische Plugin-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |464| `FORCE_AUTOUPDATE_PLUGINS` | Auf `1` setzen, um automatische Plugin-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |

473| `FORCE_HYPERLINK` | Auf `1` setzen, um anklickbare OSC-8-Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, dies aber nicht automatisch erkannt wird, oder auf `0`, um sie zu deaktivieren. Wenn die Variable nicht gesetzt ist, aktiviert Claude Code Hyperlinks nur, wenn es Terminalunterstützung erkennt. Claude Code wertet diesen Wert als Zahl aus, nicht als Boolean, daher aktiviert ein Wert wie `false`, `no` oder `off` Hyperlinks, statt sie zu deaktivieren. Das [Badge für PR oder Merge Request](/docs/de/interactive-mode#pr-review-status) in der Fußzeile wird als Hyperlink dargestellt, auch wenn Claude Code keine Terminalunterstützung erkennen kann, etwa über SSH. Setzen Sie `0`, um das Badge als reinen Text darzustellen |465| `FORCE_HYPERLINK` | Auf `1` setzen, um anklickbare OSC-8-Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, dies aber nicht automatisch erkannt wird, oder auf `0`, um sie zu deaktivieren. Wenn die Variable nicht gesetzt ist, aktiviert Claude Code Hyperlinks nur, wenn es Terminalunterstützung erkennt. Claude Code wertet diesen Wert als Zahl aus, nicht als Boolean, daher aktiviert ein Wert wie `false`, `no` oder `off` Hyperlinks, statt sie zu deaktivieren. Das [Badge für PR oder Merge Request](/docs/de/interactive-mode#pr-review-status) in der Fußzeile wird als Hyperlink dargestellt, auch wenn Claude Code keine Terminalunterstützung erkennen kann, etwa über SSH. Setzen Sie `0`, um das Badge als reinen Text darzustellen |

474| `FORCE_PROMPT_CACHING_5M` | Auf `1` setzen, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn sonst die 1-Stunden-TTL gelten würde. Überschreibt `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` sowie die Einstellungen `promptCacheTtl` und `subagentPromptCacheTtl` |466| `FORCE_PROMPT_CACHING_5M` | Auf `1` setzen, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn sonst die 1-Stunden-TTL gelten würde. Überschreibt `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` sowie die Einstellungen `promptCacheTtl` und `subagentPromptCacheTtl` |


572 564 

573Bei ausgeschaltetem Abruf können Sie Folgendes nicht:565Bei ausgeschaltetem Abruf können Sie Folgendes nicht:

574 566 

575* [`/auto-mode-setup`](/docs/de/auto-mode-config#generate-environment-entries) ausführen, um Einträge für `autoMode.environment` zu entwerfen

576* [Remote Control](/docs/de/remote-control) verwenden, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` gesetzt ist. Informationen zu `DISABLE_TELEMETRY` und `DO_NOT_TRACK` finden Sie in den [Anforderungen für Remote Control](/docs/de/remote-control#requirements)567* [Remote Control](/docs/de/remote-control) verwenden, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` gesetzt ist. Informationen zu `DISABLE_TELEMETRY` und `DO_NOT_TRACK` finden Sie in den [Anforderungen für Remote Control](/docs/de/remote-control#requirements)

577* [Nachrichten an Sitzungen außerhalb dieses Rechners senden](/docs/de/cross-session-messaging#message-sessions-on-other-machines), wenn [Remote Control](/docs/de/remote-control#requirements) nicht verfügbar ist. Nachrichten zwischen Sitzungen auf diesem Rechner funktionieren auch bei ausgeschaltetem Abruf568* [Nachrichten an Sitzungen außerhalb dieses Rechners senden](/docs/de/cross-session-messaging#message-sessions-on-other-machines), wenn [Remote Control](/docs/de/remote-control#requirements) nicht verfügbar ist. Nachrichten zwischen Sitzungen auf diesem Rechner funktionieren auch bei ausgeschaltetem Abruf

578* [`claude import` oder den Befehl `/import`](/docs/de/cli-reference#cli-commands) ausführen569* [`claude import` oder den Befehl `/import`](/docs/de/cli-reference#cli-commands) ausführen

errors.md +288 −41

Details

83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentifizierung](#oauth-token-revoked-or-expired) |83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentifizierung](#oauth-token-revoked-or-expired) |

84| `API Error: 401 Invalid authentication credentials` | [Authentifizierung](#api-error-401-invalid-authentication-credentials) |84| `API Error: 401 Invalid authentication credentials` | [Authentifizierung](#api-error-401-invalid-authentication-credentials) |

85| `Login expired · Please run /login` | [Authentifizierung](#login-expired) |85| `Login expired · Please run /login` | [Authentifizierung](#login-expired) |

86| `The browser can't return the sign-in to Claude Code automatically` | [Authentifizierung](#couldnt-start-the-local-sign-in-listener) |

87| `Couldn't start the local listener that receives the browser sign-in. Try again.` | [Authentifizierung](#couldnt-start-the-local-sign-in-listener) |

86| `Failed to start OAuth callback server` | [Authentifizierung](#failed-to-start-oauth-callback-server) |88| `Failed to start OAuth callback server` | [Authentifizierung](#failed-to-start-oauth-callback-server) |

87| `Claude login not accepted · Run /login, then try again` | [Authentifizierung](#claude-login-not-accepted) |89| `Claude login not accepted · Run /login, then try again` | [Authentifizierung](#claude-login-not-accepted) |

88| `Artifacts need a claude.ai login` | [Authentifizierung](#artifacts-need-a-claude-ai-login) |90| `Artifacts need a claude.ai login` | [Authentifizierung](#artifacts-need-a-claude-ai-login) |


100| `claude.ai rejected the session token` / `session token rejected` | [Authentifizierung](#claude-ai-rejected-the-session-token) |102| `claude.ai rejected the session token` / `session token rejected` | [Authentifizierung](#claude-ai-rejected-the-session-token) |

101| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |103| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |

102| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |104| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |

105| `(check the helper, then start a new task or chat)` / `(update it, then start a new task or chat)` | [Authentifizierung](#mcp-credential-rejected-in-cowork) |

103| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |106| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |

104| `MCP server "<name>" requires re-authorization (token expired)` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |107| `MCP server "<name>" requires re-authorization (token expired)` | [Authentifizierung](#mcp-server-needs-you-to-sign-in-again) |

105| `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) |108| `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) |


200| `Installation was killed before it could finish (exit code 137)` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#installation-was-killed-before-it-could-finish) |203| `Installation was killed before it could finish (exit code 137)` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#installation-was-killed-before-it-could-finish) |

201| `The connection dropped while downloading the update` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |204| `The connection dropped while downloading the update` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

202| `Download timed out: exceeded the total deadline` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |205| `Download timed out: exceeded the total deadline` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

206| `Release verification failed for Claude Code <version> (<reason>). The update was not installed.` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#release-verification-failed) |

207| `Auto-update failed · Run claude doctor` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#auto-update-failed) |

203| `--bg and --print conflict` | [Befehlszeilenfehler](#conflict-between-bg-and-print) |208| `--bg and --print conflict` | [Befehlszeilenfehler](#conflict-between-bg-and-print) |

204| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Befehlszeilenfehler](#couldnt-tell-whether-bg-is-a-flag-or-text) |209| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Befehlszeilenfehler](#couldnt-tell-whether-bg-is-a-flag-or-text) |

205| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Befehlszeilenfehler](#conflict-between-a-system-prompt-flag-and-its-file-form) |210| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Befehlszeilenfehler](#conflict-between-a-system-prompt-flag-and-its-file-form) |


270| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Befehlszeilenfehler](#custom-output-styles-cant-be-selected-over-remote-control) |275| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Befehlszeilenfehler](#custom-output-styles-cant-be-selected-over-remote-control) |

271| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Befehlszeilenfehler](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |276| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Befehlszeilenfehler](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

272| `/recap only runs when you ask for it yourself in this session` | [Befehlszeilenfehler](#recap-only-runs-when-you-ask-for-it-yourself) |277| `/recap only runs when you ask for it yourself in this session` | [Befehlszeilenfehler](#recap-only-runs-when-you-ask-for-it-yourself) |

278| `/feedback is disabled by your organization's policy`, oder dasselbe für `/bug` oder `/share` | [Befehlszeilenfehler](#feedback-is-disabled-by-your-organizations-policy) |

273| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin-Fehler](#plugin-eval-is-currently-in-early-access) |279| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin-Fehler](#plugin-eval-is-currently-in-early-access) |

274| `cannot be evaluated where sessions load it` | [Plugins mit Evals testen](/docs/de/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |280| `cannot be evaluated where sessions load it` | [Plugins mit Evals testen](/docs/de/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |

275| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |281| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |


289| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |295| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |

290| `does not load (...), so Claude Code ignores the whole file` | [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |296| `does not load (...), so Claude Code ignores the whole file` | [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |

291| `path escapes plugin directory` | [Plugin-Fehler](#path-escapes-plugin-directory) |297| `path escapes plugin directory` | [Plugin-Fehler](#path-escapes-plugin-directory) |

298| `Plugin not loaded: its manifest <path> was not read` | [Plugin-Fehler](#plugin-not-loaded-its-manifest-was-not-read) |

292| `path could not be checked` | [Plugin-Fehler](#path-could-not-be-checked) |299| `path could not be checked` | [Plugin-Fehler](#path-could-not-be-checked) |

293| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |300| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

294| `Plugin source path refused` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |301| `Plugin source path refused` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |


304| `File is covered by a Read deny rule in your permission settings` | [Werkzeugfehler](#file-is-covered-by-a-read-deny-rule) |311| `File is covered by a Read deny rule in your permission settings` | [Werkzeugfehler](#file-is-covered-by-a-read-deny-rule) |

305| `cannot contain null bytes (\0)` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |312| `cannot contain null bytes (\0)` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |

306| `Path contains null bytes` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |313| `Path contains null bytes` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |

314| `File is too large to read as an image (the limit is 128MB)` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |

315| `Cannot read this as an image: <path> is a pipe or a device` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |

307| `subagent_type is required: the general-purpose agent is not available in this session` | [Werkzeugfehler](#subagent-type-is-required) |316| `subagent_type is required: the general-purpose agent is not available in this session` | [Werkzeugfehler](#subagent-type-is-required) |

308| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Werkzeugfehler](#memory-index-is-over-its-read-limit) |317| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Werkzeugfehler](#memory-index-is-over-its-read-limit) |

309| `pkill: refusing to run` | [Werkzeugfehler](#pkill-pattern-matches-the-claude-code-process) |318| `pkill: refusing to run` | [Werkzeugfehler](#pkill-pattern-matches-the-claude-code-process) |

310| `Failed to write to <name>'s inbox — nothing was sent` | [Werkzeugfehler](#failed-to-write-to-a-teammate-inbox) |319| `Failed to write to <name>'s inbox — nothing was sent` | [Werkzeugfehler](#failed-to-write-to-a-teammate-inbox) |

311| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Werkzeugfehler](#failed-to-write-to-a-teammate-inbox) |320| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Werkzeugfehler](#failed-to-write-to-a-teammate-inbox) |

312| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Werkzeugfehler](#teammate-agent-definition-not-restored) |321| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Werkzeugfehler](#teammate-agent-definition-not-restored) |

322| `Only a teammate can approve a shutdown request` | [Werkzeugfehler](#only-a-teammate-can-approve-a-shutdown-request) |

313| `Message too large for cross-session delivery` | [Werkzeugfehler](#message-too-large-for-cross-session-delivery) |323| `Message too large for cross-session delivery` | [Werkzeugfehler](#message-too-large-for-cross-session-delivery) |

314| `Too many messages to this session just now` | [Werkzeugfehler](#too-many-messages-to-this-session-just-now) |324| `Too many messages to this session just now` | [Werkzeugfehler](#too-many-messages-to-this-session-just-now) |

315| `Cross-session message was dropped at the recipient session's inbox` | [Werkzeugfehler](#cross-session-message-dropped-at-the-inbox) |325| `Cross-session message was dropped at the recipient session's inbox` | [Werkzeugfehler](#cross-session-message-dropped-at-the-inbox) |


325| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |335| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

326| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |336| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

327| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |337| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

338| `The command was not started: this computer's disk is full (ENOSPC)` / `(EDQUOT)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

328| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Werkzeugfehler](#file-is-not-valid-utf-8) |339| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Werkzeugfehler](#file-is-not-valid-utf-8) |

329| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |340| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |

330| `the source file has the replacement character U+FFFD` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |341| `the source file has the replacement character U+FFFD` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |

331| `Not published: that file is on a network share` | [Werkzeugfehler](#not-published-that-file-is-on-a-network-share) |342| `Not published: that file is on a network share` | [Werkzeugfehler](#not-published-that-file-is-on-a-network-share) |

343| `Not published: Claude sent the same content again after a newer version of the artifact turned it away` / `Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away` | [Werkzeugfehler](#not-published-a-newer-version-of-the-artifact-turned-it-away) |

332| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |344| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |

333| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |345| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |

334| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Werkzeugfehler](#webfetch-cannot-fetch-localhost) |346| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Werkzeugfehler](#webfetch-cannot-fetch-localhost) |


345| `Can't open — this session is running in another terminal` | [Fehler in Hintergrund-Sitzungen](#this-session-is-running-in-another-terminal) |357| `Can't open — this session is running in another terminal` | [Fehler in Hintergrund-Sitzungen](#this-session-is-running-in-another-terminal) |

346| `This conversation is already open in another running Claude session` | [Fehler in Hintergrund-Sitzungen](#this-session-is-running-in-another-terminal) |358| `This conversation is already open in another running Claude session` | [Fehler in Hintergrund-Sitzungen](#this-session-is-running-in-another-terminal) |

347| `This session's saved conversation is no longer on disk` | [Fehler in Hintergrund-Sitzungen](#this-sessions-saved-conversation-is-no-longer-on-disk) |359| `This session's saved conversation is no longer on disk` | [Fehler in Hintergrund-Sitzungen](#this-sessions-saved-conversation-is-no-longer-on-disk) |

348| `Bypass permissions was requested at launch and ignored` | [Alle Prüfungen mit dem bypassPermissions-Modus überspringen](/docs/de/permission-modes#bypass-permissions-acceptance) |360| `Bypass permissions was requested at launch and ignored` | [Bypass permissions in einer Hintergrund-Sitzung ignoriert](/docs/de/permission-modes#bypass-permissions-ignored-in-a-background-session) |

349| `kept <id> — its worktree is still at <path>` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |361| `kept <id> — its worktree is still at <path>` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |

350| `kept <id> — <n> unpushed commits on <branch>` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |362| `kept <id> — <n> unpushed commits on <branch>` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |

351| `kept <id> — worktree has commits that are not pushed anywhere` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |363| `kept <id> — worktree has commits that are not pushed anywhere` | [Fehler in Hintergrund-Sitzungen](#worktree-has-commits-that-are-not-pushed-anywhere) |


354| `Session <id> was stopped while the respawn was in flight` | [Fehler in Hintergrund-Sitzungen](#session-was-stopped-while-the-respawn-was-in-flight) |366| `Session <id> was stopped while the respawn was in flight` | [Fehler in Hintergrund-Sitzungen](#session-was-stopped-while-the-respawn-was-in-flight) |

355| `This session was running agent '<name>', which is no longer available` | [Fehler in Hintergrund-Sitzungen](#session-agent-no-longer-available) |367| `This session was running agent '<name>', which is no longer available` | [Fehler in Hintergrund-Sitzungen](#session-agent-no-longer-available) |

356| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Fehler in Hintergrund-Sitzungen](#restarted-after-its-next-loop-wakeup-was-due) |368| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Fehler in Hintergrund-Sitzungen](#restarted-after-its-next-loop-wakeup-was-due) |

369| `No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder` | [Fehler in Hintergrund-Sitzungen](#no-llm-gateway-opened-from-another-folder) |

370| `No LLM gateway: opened from another folder · respawn from <folder>` | [Fehler in Hintergrund-Sitzungen](#no-llm-gateway-opened-from-another-folder) |

357| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Fehler in Hintergrund-Sitzungen](#claude_code_process_wrapper-launcher-errors) |371| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Fehler in Hintergrund-Sitzungen](#claude_code_process_wrapper-launcher-errors) |

358| `EUNKNOWN: unknown error, uv_spawn` | [Fehler in Hintergrund-Sitzungen](#eunknown-when-starting-a-background-session) |372| `EUNKNOWN: unknown error, uv_spawn` | [Fehler in Hintergrund-Sitzungen](#eunknown-when-starting-a-background-session) |

359| `EACCES: permission denied, posix_spawn` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |373| `EACCES: permission denied, posix_spawn` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |


394| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Konfigurationswarnungen](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |408| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Konfigurationswarnungen](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |

395| `headersHelper not run — this workspace has no persisted trust` | [Konfigurationswarnungen](#headershelper-not-run) |409| `headersHelper not run — this workspace has no persisted trust` | [Konfigurationswarnungen](#headershelper-not-run) |

396| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Konfigurationswarnungen](#malformed-tool-content-rule) |410| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Konfigurationswarnungen](#malformed-tool-content-rule) |

411| `matches no tool · check for typos` / `matches no known tool — check for typos` | [Konfigurationswarnungen](#matches-no-tool) |

397| `... is not matched by file permission checks` | [Konfigurationswarnungen](#is-not-matched-by-file-permission-checks) |412| `... is not matched by file permission checks` | [Konfigurationswarnungen](#is-not-matched-by-file-permission-checks) |

413| `Write(<path>) never matches · use Edit(<path>)` / `Glob(<path>) never matches · use Read(<path>)` | [Konfigurationswarnungen](#is-not-matched-by-file-permission-checks) |

398| `... has a wildcard before the rest of the command` | [Konfigurationswarnungen](#has-a-wildcard-before-the-rest-of-the-command) |414| `... has a wildcard before the rest of the command` | [Konfigurationswarnungen](#has-a-wildcard-before-the-rest-of-the-command) |

415| `allows any option at its * · use an exact value` | [Konfigurationswarnungen](#has-a-wildcard-before-the-rest-of-the-command) |

399| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Konfigurationswarnungen](#denying-bash-also-turns-off-the-powershell-tool) |416| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Konfigurationswarnungen](#denying-bash-also-turns-off-the-powershell-tool) |

400| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Konfigurationswarnungen](#the-200k-limit-isnt-enforced) |417| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Konfigurationswarnungen](#the-200k-limit-isnt-enforced) |

418| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" reads as <N> tokens, so Claude Code treats it as the 100k minimum` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/model-config#claude_code_auto_compact_window-values) |

419| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" is too large, so Claude Code treats it as the 1M maximum` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/model-config#claude_code_auto_compact_window-values) |

420| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/model-config#claude_code_auto_compact_window-values) |

401| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |421| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

402| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |422| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

403| `[claude-code:unrecognized_model]` | [Konfigurationswarnungen](#unrecognized-model-id-on-a-request) |423| `[claude-code:unrecognized_model]` | [Konfigurationswarnungen](#unrecognized-model-id-on-a-request) |


462| [`CLAUDE_CODE_MAX_RETRIES`](/docs/de/env-vars) | 10 | Anzahl der Wiederholungsversuche. Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standardwert und hebt die Begrenzung auf. Verringern Sie den Wert, damit Fehler in Skripten schneller sichtbar werden. |482| [`CLAUDE_CODE_MAX_RETRIES`](/docs/de/env-vars) | 10 | Anzahl der Wiederholungsversuche. Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standardwert und hebt die Begrenzung auf. Verringern Sie den Wert, damit Fehler in Skripten schneller sichtbar werden. |

463| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/de/env-vars) | nicht gesetzt | Setzen Sie den Wert in unbeaufsichtigten Sitzungen wie CI-Jobs auf `1`, um `429`- und `529`-Kapazitätsfehler unbegrenzt erneut zu versuchen, statt nach `CLAUDE_CODE_MAX_RETRIES` Versuchen abzubrechen. Claude Code bricht sofort ab, wenn eine Anfrage mit Standardgeschwindigkeit eine `429` erhält, die ein Ausgabenlimit oder aufgebrauchtes Nutzungsguthaben meldet, auch wenn sie von einer [Ausgabenobergrenze eines Gateways](#spend-limit-reached) stammt, die nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 versuchte der Watchdog diese unbegrenzt erneut. Für Anfragen im Fast-Modus siehe [Rate-Limits handhaben](/docs/de/fast-mode#handle-rate-limits). Ab v2.1.199 erhöht sie außerdem die Standardanzahl der Wiederholungsversuche für andere vorübergehende Fehler wie Serverfehler, Timeouts und unterbrochene Verbindungen auf 300, was etwa drei Stunden Backoff entspricht, und hebt die Begrenzung von `CLAUDE_CODE_MAX_RETRIES` auf 15 auf, wenn Sie diese Variable explizit setzen. |483| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/de/env-vars) | nicht gesetzt | Setzen Sie den Wert in unbeaufsichtigten Sitzungen wie CI-Jobs auf `1`, um `429`- und `529`-Kapazitätsfehler unbegrenzt erneut zu versuchen, statt nach `CLAUDE_CODE_MAX_RETRIES` Versuchen abzubrechen. Claude Code bricht sofort ab, wenn eine Anfrage mit Standardgeschwindigkeit eine `429` erhält, die ein Ausgabenlimit oder aufgebrauchtes Nutzungsguthaben meldet, auch wenn sie von einer [Ausgabenobergrenze eines Gateways](#spend-limit-reached) stammt, die nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 versuchte der Watchdog diese unbegrenzt erneut. Für Anfragen im Fast-Modus siehe [Rate-Limits handhaben](/docs/de/fast-mode#handle-rate-limits). Ab v2.1.199 erhöht sie außerdem die Standardanzahl der Wiederholungsversuche für andere vorübergehende Fehler wie Serverfehler, Timeouts und unterbrochene Verbindungen auf 300, was etwa drei Stunden Backoff entspricht, und hebt die Begrenzung von `CLAUDE_CODE_MAX_RETRIES` auf 15 auf, wenn Sie diese Variable explizit setzen. |

464| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/de/env-vars) | nicht gesetzt | Maximale Zeit in Millisekunden, die jede API-Anfrage mit dem Abwarten von `429`- und `529`-Fehlern verbringt, wenn `CLAUDE_CODE_RETRY_WATCHDOG` gesetzt ist. Ist die Variable nicht gesetzt, ist die Wartezeit unbegrenzt. Erfordert Claude Code v2.1.295 oder höher. |484| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/de/env-vars) | nicht gesetzt | Maximale Zeit in Millisekunden, die jede API-Anfrage mit dem Abwarten von `429`- und `529`-Fehlern verbringt, wenn `CLAUDE_CODE_RETRY_WATCHDOG` gesetzt ist. Ist die Variable nicht gesetzt, ist die Wartezeit unbegrenzt. Erfordert Claude Code v2.1.295 oder höher. |

485| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](/docs/de/env-vars) | nicht gesetzt | Mindestabstand in Millisekunden zwischen Prüfungen, ob ein [Nutzungslimit](#youve-hit-your-session-limit) bereits aufgehoben wurde, während eine Anfrage bei gesetztem `CLAUDE_CODE_RETRY_WATCHDOG` auf das Zurücksetzen dieses Limits wartet. Stellt eine Prüfung fest, dass das Limit aufgehoben ist, wird die Anfrage sofort gesendet. Geben Sie nur Ziffern von `60000` bis `10800000` an. Ist die Variable nicht gesetzt oder liegt der Wert außerhalb dieses Bereichs, finden keine Prüfungen statt. Wann Claude Code diese Prüfungen überspringt, erfahren Sie in der [Referenz der Umgebungsvariablen](/docs/de/env-vars). Erfordert Claude Code v2.1.305 oder höher. |

465| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/de/env-vars) | 500 | Anfängliche Verzögerung des Backoffs in Millisekunden zwischen Wiederholungsversuchen einer Anfrage, die die API mit einem `529`-Überlastungsfehler ablehnt. Erhöhen Sie den Wert auf bis zu 32000, um die Wiederholungsversuche über einen längeren Zeitraum zu verteilen, wenn die API ausgelastet ist. Hat keine Wirkung, wenn `CLAUDE_CODE_RETRY_WATCHDOG` auf `1` gesetzt ist oder wenn die abgelehnte Anfrage im [Fast-Modus](/docs/de/fast-mode#handle-rate-limits) gesendet wurde. Erfordert Claude Code v2.1.292 oder höher. |486| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/de/env-vars) | 500 | Anfängliche Verzögerung des Backoffs in Millisekunden zwischen Wiederholungsversuchen einer Anfrage, die die API mit einem `529`-Überlastungsfehler ablehnt. Erhöhen Sie den Wert auf bis zu 32000, um die Wiederholungsversuche über einen längeren Zeitraum zu verteilen, wenn die API ausgelastet ist. Hat keine Wirkung, wenn `CLAUDE_CODE_RETRY_WATCHDOG` auf `1` gesetzt ist oder wenn die abgelehnte Anfrage im [Fast-Modus](/docs/de/fast-mode#handle-rate-limits) gesendet wurde. Erfordert Claude Code v2.1.292 oder höher. |

466| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/de/env-vars) | 32000 | Obergrenze des Backoffs in Millisekunden zwischen Wiederholungsversuchen einer Anfrage, die die API mit einem `529`-Überlastungsfehler ablehnt. Erhöhen Sie den Wert auf bis zu 64000, damit spätere Wiederholungsversuche zeitlich weiter auseinanderliegen, wenn die API ausgelastet ist. Hat keine Wirkung, wenn `CLAUDE_CODE_RETRY_WATCHDOG` auf `1` gesetzt ist oder wenn die abgelehnte Anfrage im [Fast-Modus](/docs/de/fast-mode#handle-rate-limits) gesendet wurde. Erfordert Claude Code v2.1.296 oder höher. |487| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/de/env-vars) | 32000 | Obergrenze des Backoffs in Millisekunden zwischen Wiederholungsversuchen einer Anfrage, die die API mit einem `529`-Überlastungsfehler ablehnt. Erhöhen Sie den Wert auf bis zu 64000, damit spätere Wiederholungsversuche zeitlich weiter auseinanderliegen, wenn die API ausgelastet ist. Hat keine Wirkung, wenn `CLAUDE_CODE_RETRY_WATCHDOG` auf `1` gesetzt ist oder wenn die abgelehnte Anfrage im [Fast-Modus](/docs/de/fast-mode#handle-rate-limits) gesendet wurde. Erfordert Claude Code v2.1.296 oder höher. |

467| [`API_TIMEOUT_MS`](/docs/de/env-vars) | 600000 | Zeit in Millisekunden, die jeder Anfrageversuch hat, um seine Response-Header zu empfangen. Sie begrenzt nicht, wie lange eine Streaming-Antwort danach läuft. Erhöhen Sie den Wert bei langsamen Netzwerken oder Proxys. Wie der Wert die First-Byte-Deadline begrenzt, erfahren Sie unter [No response from API](#no-response-from-api). |488| [`API_TIMEOUT_MS`](/docs/de/env-vars) | 600000 | Zeit in Millisekunden, die jeder Anfrageversuch hat, um seine Response-Header zu empfangen. Sie begrenzt nicht, wie lange eine Streaming-Antwort danach läuft. Erhöhen Sie den Wert bei langsamen Netzwerken oder Proxys. Wie der Wert die First-Byte-Deadline begrenzt, erfahren Sie unter [No response from API](#no-response-from-api). |


490 511 

491* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Nachricht genannte Anbieter-Statusseite auf aktive Vorfälle512* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Nachricht genannte Anbieter-Statusseite auf aktive Vorfälle

492* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.513* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.

514* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) verweist und jede Anfrage auf diese Weise fehlschlägt, prüfen Sie, ob Ihr Gateway die Tool-Search-Felder ablehnt, die Claude Code standardmäßig sendet. Setzen Sie dazu `ENABLE_TOOL_SEARCH=false`, wie unter [Tool-Suche über ein LLM-Gateway](/docs/de/mcp#tool-search-through-a-gateway) beschrieben, und versuchen Sie es dann erneut. Vor v2.1.304 war die Tool-Suche hinter einem Gateway deaktiviert, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` aktiviert hatten.

493* Wenn der Fehler ohne einen veröffentlichten Vorfall weiterhin auftritt, führen Sie `/feedback` aus, damit Anthropic Ihre Anfrageinformationen untersuchen kann. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.515* Wenn der Fehler ohne einen veröffentlichten Vorfall weiterhin auftritt, führen Sie `/feedback` aus, damit Anthropic Ihre Anfrageinformationen untersuchen kann. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.

494 516 

495### API-Fehler: Wiederholte 529 Overloaded-Fehler517### API-Fehler: Wiederholte 529 Overloaded-Fehler


520Request timed out542Request timed out

521```543```

522 544 

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

524 546 

525**Was zu tun ist:**547**Was zu tun ist:**

526 548 

549* Wenn jede Anfrage mit dieser Nachricht fehlschlägt und Sie `API_TIMEOUT_MS` auf `0` gesetzt haben, überprüfen Sie `claude --version`. Bei einer Version vor v2.1.305 aktualisieren Sie Claude Code oder setzen Sie einen positiven Wert.

527* Wiederholen Sie die Anfrage550* Wiederholen Sie die Anfrage

528* Wenn eine langsame Netzwerk- oder Proxy-Verbindung die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben551* Wenn eine langsame Netzwerk- oder Proxy-Verbindung die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben

529* Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten552* Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten


541* **Erster Versuch**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/de/env-vars), wenn Sie es auf 1 oder mehr setzen, begrenzt auf zwischen 10 Sekunden und 30 Minuten. Andernfalls verwendet Claude Code den Byte-Level-Watchdog-Timeout, der in [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) aufgelistet ist, sodass die Variablen, die diesen Timeout ändern, auch diese Wartezeit ändern. In jedem Fall fügt Claude Code eine Sekunde für alle 32 KB des Anfragekörpers hinzu.564* **Erster Versuch**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/de/env-vars), wenn Sie es auf 1 oder mehr setzen, begrenzt auf zwischen 10 Sekunden und 30 Minuten. Andernfalls verwendet Claude Code den Byte-Level-Watchdog-Timeout, der in [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) aufgelistet ist, sodass die Variablen, die diesen Timeout ändern, auch diese Wartezeit ändern. In jedem Fall fügt Claude Code eine Sekunde für alle 32 KB des Anfragekörpers hinzu.

542* **Wiederholungsversuch**: eine Sekunde weniger als `API_TIMEOUT_MS`, standardmäßig knapp unter 10 Minuten, damit der Wiederholungsversuch einen Proxy oder ein Gateway überdauern kann, das die Antwort bis zum Abschluss der Generierung zurückhält. Bei Amazon Bedrock verwendet der Wiederholungsversuch die gleiche Frist wie der erste Versuch, und die Nachricht zeigt eine Dauer statt zwei an.565* **Wiederholungsversuch**: eine Sekunde weniger als `API_TIMEOUT_MS`, standardmäßig knapp unter 10 Minuten, damit der Wiederholungsversuch einen Proxy oder ein Gateway überdauern kann, das die Antwort bis zum Abschluss der Generierung zurückhält. Bei Amazon Bedrock verwendet der Wiederholungsversuch die gleiche Frist wie der erste Versuch, und die Nachricht zeigt eine Dauer statt zwei an.

543 566 

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

568 

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

545 570 

546**Was zu tun ist:**571**Was zu tun ist:**


845* Führen Sie `/status` aus und bestätigen Sie, dass die aktiven Anmeldedaten die erwarteten sind. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen über einen Schlüssel mit niedrigem Tier statt über Ihr Abonnement leiten.870* Führen Sie `/status` aus und bestätigen Sie, dass die aktiven Anmeldedaten die erwarteten sind. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen über einen Schlüssel mit niedrigem Tier statt über Ihr Abonnement leiten.

846* Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich871* Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich

847* Für Anthropic-API-Schlüssel siehe die [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) für die Funktionsweise von Tiers und wie man Obergrenzen pro Workspace setzt872* Für Anthropic-API-Schlüssel siehe die [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) für die Funktionsweise von Tiers und wie man Obergrenzen pro Workspace setzt

848* Reduzieren Sie die Parallelität: Senken Sie [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/de/env-vars), vermeiden Sie das Ausführen vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für skriptgesteuerte Läufe mit hohem Volumen873* Reduzieren Sie die Parallelität: Vermeiden Sie das Ausführen vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für skriptgesteuerte Läufe mit hohem Volumen

849 874 

850### You've hit your monthly spend limit875### You've hit your monthly spend limit

851 876 


1267* Wenn `/status` nur Ihre Anmeldung anzeigt, führen Sie einmal `/login` aus. Wurden die Anmeldedaten widerrufen, ersetzt eine neue Anmeldung sie.1292* Wenn `/status` nur Ihre Anmeldung anzeigt, führen Sie einmal `/login` aus. Wurden die Anmeldedaten widerrufen, ersetzt eine neue Anmeldung sie.

1268* Wenn dieselbe Meldung für dasselbe Anmeldekonto erneut erscheint, ist das Konto oder die Organisation nicht mehr aktiv. Prüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie den Admin Ihrer Organisation, den Zugriff wiederherzustellen.1293* Wenn dieselbe Meldung für dasselbe Anmeldekonto erneut erscheint, ist das Konto oder die Organisation nicht mehr aktiv. Prüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie den Admin Ihrer Organisation, den Zugriff wiederherzustellen.

1269* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) zeigt, ist der Text nach `401` die Meldung Ihres Gateways und nicht die von Anthropic, und `/login` ändert daran nichts. Korrigieren Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.1294* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) zeigt, ist der Text nach `401` die Meldung Ihres Gateways und nicht die von Anthropic, und `/login` ändert daran nichts. Korrigieren Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.

1295* Wenn jede Anfrage mit einem `401` fehlschlägt, obwohl Ihr Gateway die erwarteten Anmeldedaten hat, prüfen Sie, ob das Gateway die Felder für die Tool-Suche ablehnt, die Claude Code standardmäßig sendet. Setzen Sie dazu `ENABLE_TOOL_SEARCH=false`, wie unter [Tool-Suche über ein LLM-Gateway](/docs/de/mcp#tool-search-through-a-gateway) beschrieben, und versuchen Sie es erneut. Vor v2.1.304 war die Tool-Suche hinter einem Gateway deaktiviert, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` eingeschaltet hatten.

1270 1296 

1271### Anmeldung abgelaufen1297### Anmeldung abgelaufen

1272 1298 


1338* Führen Sie auf anderen Plattformen erneut `/login` aus1364* Führen Sie auf anderen Plattformen erneut `/login` aus

1339* Wenn die Anmeldung weiterhin nicht gespeichert wird, finden Sie unter [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) den Befehl zum Entsperren des Schlüsselbunds und weitere Schritte zur Wiederherstellung des Anmeldedatenspeichers1365* Wenn die Anmeldung weiterhin nicht gespeichert wird, finden Sie unter [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) den Befehl zum Entsperren des Schlüsselbunds und weitere Schritte zur Wiederherstellung des Anmeldedatenspeichers

1340 1366 

1341### OAuth-Callback-Server konnte nicht gestartet werden1367### Couldn't start the local listener that receives the browser sign-in

1342 1368 

1343Wenn `/login`, `claude auth login` oder `claude setup-token` Sie über den Browser anmeldet, öffnet Claude Code einen lauschenden Port auf `127.0.0.1`, damit Ihr Browser das Anmeldeergebnis an Claude Code zurückgeben kann. Diese Meldung bedeutet, dass Claude Code diesen Port nicht öffnen konnte, und die Anmeldung stoppt, bevor ein Browserfenster oder eine Anmelde-URL erscheint:1369Jede dieser Meldungen von `/login`, `claude auth login` oder `claude setup-token` bedeutet, dass Claude Code den Port auf `127.0.0.1`, über den Ihr Browser das Anmeldeergebnis zurückgibt, nicht öffnen konnte.

1344 1370 

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

1346Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1372 

1373```text wrap theme={null}

1374The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.

1347```1375```

1348 1376 

1349Wenn Ihre Meldung mit `Is port 0 in use?` endet, ist der Versuch, auf der IPv4-Loopback-Adresse `127.0.0.1` zu lauschen, vollständig fehlgeschlagen. Da der Fehler auftritt, bevor eine Anmelde-URL existiert, steht der Ablauf `Paste code here if prompted` nicht als Workaround zur Verfügung.1377Bei der Meldung, die `Couldn't start the local listener` enthält, wurde die Anmeldung gestoppt. Das passiert zum Beispiel, wenn Sie Eingaben per Pipe an `claude auth login` übergeben:

1378 

1379```text theme={null}

1380Couldn't start the local listener that receives the browser sign-in. Try again.

1381```

1350 1382 

1351**Vorgehensweise:**1383**Vorgehensweise:**

1352 1384 

1353* Um sich sofort ohne den lokalen Listener anzumelden: Wenn Sie ein claude.ai-Abonnement verwenden, führen Sie [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) auf einem Rechner aus, auf dem die Anmeldung funktioniert, und setzen Sie das ausgegebene Token auf diesem Rechner als `CLAUDE_CODE_OAUTH_TOKEN`. Andernfalls setzen Sie `ANTHROPIC_API_KEY` auf einen Schlüssel aus der [Claude Console](https://platform.claude.com/settings/keys). Unter [Vorrang der Authentifizierung](/docs/de/authentication#authentication-precedence) wird erklärt, wie Claude Code zwischen Anmeldedaten wählt.1385* **`The browser can't return the sign-in to Claude Code automatically`**: Sie müssen zuerst nichts beheben. Öffnen Sie die unter dem Hinweis angezeigte URL in einem Browser und melden Sie sich an. Der Browser zeigt dann einen Code: Fügen Sie ihn in Claude Code bei der Eingabe `Paste code here >` ein, und die Anmeldung wird von dort fortgesetzt.

1354* Um stattdessen die Browser-Anmeldung auf diesem Rechner zu verwenden, muss Claude Code auf `127.0.0.1` lauschen können. Wenn es in einer Sandbox läuft, prüfen Sie, ob die Richtlinie der Sandbox das Lauschen auf lokalen Ports erlaubt, und führen Sie dann erneut `/login` aus. Wenn es dazu in der Lage sein sollte und trotzdem fehlschlägt, führen Sie `/feedback` aus, damit der Bericht Ihre Umgebungsdetails enthält.1386* **`Couldn't start the local listener that receives the browser sign-in`**: Führen Sie denselben Befehl erneut aus. Wenn er auf dieselbe Weise stoppt, melden Sie sich statt über den Browser mit einem Token oder API-Schlüssel an. Oder, falls Sie Eingaben per Pipe an `claude auth login` übergeben haben, führen Sie den Befehl in einem Terminal aus, damit er einen eingefügten Code annehmen kann.

1387* **Anmeldung mit einem Token oder API-Schlüssel statt über den Browser**: Wenn Sie ein claude.ai-Abonnement verwenden, führen Sie [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) auf einem Rechner aus, auf dem die Anmeldung funktioniert. Setzen Sie dann das ausgegebene Token auf diesem Rechner als Umgebungsvariable [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars). Andernfalls setzen Sie die Umgebungsvariable `ANTHROPIC_API_KEY` auf einen Schlüssel aus der [Claude Console](https://platform.claude.com/settings/keys). Unter [Vorrang bei der Authentifizierung](/docs/de/authentication#authentication-precedence) wird erklärt, wie Claude Code zwischen Anmeldedaten wählt.

1388* **Automatische Rückgabe aus dem Browser wiederherstellen**: Claude Code muss auf `127.0.0.1` lauschen können. Wenn es in einer Sandbox läuft, prüfen Sie, ob die Richtlinie der Sandbox das Lauschen auf lokalen Ports erlaubt, und melden Sie sich dann erneut an. Wenn das Lauschen dort funktionieren sollte und der Hinweis trotzdem erscheint, führen Sie `/feedback` aus, damit der Bericht Ihre Umgebungsdetails enthält.

1389 

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

1355 1391 

1356### Claude-Anmeldung nicht akzeptiert1392### Claude-Anmeldung nicht akzeptiert

1357 1393 


1513 1549 

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

1515 1551 

1516Vor v2.1.273 zeigten die Fälle der abgelaufenen Anmeldung, des `headersHelper` und des `Authorization`-Headers alle `MCP server "<name>" requires re-authorization (token expired)` an.1552In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung auf Ihrem Rechner in der Claude Desktop-App bedeuten diese Meldungen, dass der MCP-Server Anmeldedaten abgelehnt hat, die ihm übergeben wurden. Korrigieren Sie die in der Meldung genannten und starten Sie dann eine neue Aufgabe oder einen neuen Chat in Cowork:

1553 

1554```text theme={null}

1555MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)

1556MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)

1557```

1558 

1559* **`headersHelper`-Anmeldedaten abgelehnt**: Prüfen Sie, ob der Helper Anmeldedaten zurückgibt, die der Server akzeptiert, und starten Sie dann eine neue Aufgabe oder einen neuen Chat in Cowork

1560* **`Authorization`-Header abgelehnt**: Aktualisieren Sie den `Authorization`-Wert unter `headers` in der Konfiguration dieses Servers und starten Sie dann eine neue Aufgabe oder einen neuen Chat in Cowork

1561 

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

1517 1563 

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

1519 1565 


1812* Bestätigen Sie, dass Sie den API-Host aus derselben Shell erreichen können, indem Sie `curl -I https://api.anthropic.com` ausführen. Verwenden Sie unter Windows PowerShell `curl.exe -I https://api.anthropic.com`, damit der integrierte `Invoke-WebRequest`-Alias nicht verwendet wird.1858* Bestätigen Sie, dass Sie den API-Host aus derselben Shell erreichen können, indem Sie `curl -I https://api.anthropic.com` ausführen. Verwenden Sie unter Windows PowerShell `curl.exe -I https://api.anthropic.com`, damit der integrierte `Invoke-WebRequest`-Alias nicht verwendet wird.

1813* Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie `HTTPS_PROXY` vor dem Starten von Claude Code und siehe [Netzwerkkonfiguration](/docs/de/network-config)1859* Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie `HTTPS_PROXY` vor dem Starten von Claude Code und siehe [Netzwerkkonfiguration](/docs/de/network-config)

1814* Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf dessen Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect) für die Einrichtung.1860* Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf dessen Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect) für die Einrichtung.

1861* Wenn `ANTHROPIC_BASE_URL` bereits auf Ihr Gateway verweist und jede Anfrage mit `Connection dropped` endet, prüfen Sie, ob Ihr Gateway die Tool-Search-Felder ablehnt, die Claude Code standardmäßig sendet. Setzen Sie dazu `ENABLE_TOOL_SEARCH=false`, wie [Tool-Suche über ein LLM-Gateway](/docs/de/mcp#tool-search-through-a-gateway) beschreibt, und versuchen Sie es dann erneut. Vor v2.1.304 war die Tool-Suche hinter einem Gateway deaktiviert, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` aktiviert hatten.

1815* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) aufgelisteten Hosts zulässt1862* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) aufgelisteten Hosts zulässt

1816* Intermittierende Fehler werden [automatisch wiederholt](#automatic-retries); anhaltende Fehler deuten auf ein lokales Netzwerkproblem hin1863* Intermittierende Fehler werden [automatisch wiederholt](#automatic-retries)

1817 1864 

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

1819 1866 


2166* Kürzen Sie große `CLAUDE.md`-Memory-Dateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/docs/de/memory#path-specific-rules), die nur bei Bedarf geladen werden2213* Kürzen Sie große `CLAUDE.md`-Memory-Dateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/docs/de/memory#path-specific-rules), die nur bei Bedarf geladen werden

2167* Die automatische Komprimierung ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie sie in `/config` oder mit [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) ausgeschaltet haben, schalten Sie sie wieder ein. Wenn Sie sie ausgeschaltet lassen, führen Sie `/compact` selbst aus, bevor das Fenster voll wird.2214* Die automatische Komprimierung ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie sie in `/config` oder mit [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) ausgeschaltet haben, schalten Sie sie wieder ein. Wenn Sie sie ausgeschaltet lassen, führen Sie `/compact` selbst aus, bevor das Fenster voll wird.

2168* Wenn der Fehler bei etwa 200K Token auf einem Modell auftritt, das mehr akzeptiert, kann eine Ursache eine Modell-ID sein, die Claude Code nicht erkennt. Claude Code nimmt für eine solche ID ein Fenster von 200K an. Um über diesen Punkt hinaus weiterzuarbeiten, [teilen Sie Claude Code das tatsächliche Kontextfenster des Modells mit](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id).2215* Wenn der Fehler bei etwa 200K Token auf einem Modell auftritt, das mehr akzeptiert, kann eine Ursache eine Modell-ID sein, die Claude Code nicht erkennt. Claude Code nimmt für eine solche ID ein Fenster von 200K an. Um über diesen Punkt hinaus weiterzuarbeiten, [teilen Sie Claude Code das tatsächliche Kontextfenster des Modells mit](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id).

2216* Wenn der Fehler direkt auftrat, nachdem Sie Claude während der Komprimierung der Konversation gestoppt haben, ist Ihre Konversation unverändert und immer noch groß genug, um eine Komprimierung zu erfordern. Führen Sie `/compact` aus und senden Sie Ihre Nachricht erneut. Damit der Fehler nicht erneut auftritt, [aktualisieren Sie Claude Code](/docs/de/setup#update-claude-code) auf v2.1.304 oder neuer. Vor v2.1.304 konnte ein Stopp in diesem Moment den Turn mit diesem Fehler beenden.

2169 2217 

2170Siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.2218Siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.

2171 2219 


2298 2346 

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

2300 2348 

2301Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den `anthropic-beta`-Request-Header entfernt, daher lehnte die API Felder ab, die davon abhängen.2349Der Endpunkt, der die Anfrage empfangen hat, hat eines der Felder der Anfrage als Eingabe abgelehnt, die er nicht akzeptiert, und seine Meldung nennt dieses Feld.

2302 2350 

2303```text theme={null}2351```text theme={null}

2304API Error: 400 ... Extra inputs are not permitted ... context_management2352API Error: 400 ... context_management: Extra inputs are not permitted

2305```2353```

2306 2354 

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

2308 2356 

2309**Was zu tun ist:**2357**Was zu tun ist:**

2310 2358 

2311* Konfigurieren Sie Ihr Gateway so, dass es den `anthropic-beta`-Header weiterleitet. Unter [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through) erfahren Sie, was Gateways weiterleiten müssen.2359* Wenn die Meldung `context_management: Extra inputs are not permitted` enthält, [aktualisieren Sie Claude Code](/docs/de/setup#update-claude-code) auf v2.1.304 oder neuer. Nach dem Update reagiert Claude Code auf diese Ablehnung, indem es die Anfrage einmal ohne das Feld erneut sendet. Vor v2.1.304 versuchte Claude Code diese Ablehnung nicht erneut.

2360* Wenn die Meldung `defer_loading` oder `tool_reference` nennt, aktualisieren Sie Claude Code oder schalten Sie die [Tool-Suche](/docs/de/mcp#tool-search-through-a-gateway) aus:

2361 * [Aktualisieren Sie Claude Code](/docs/de/setup#update-claude-code) auf v2.1.305 oder neuer. Claude Code reagiert dann auf diese Ablehnung, indem es die Anfrage einmal ohne Felder der Tool-Suche erneut sendet.

2362 * Wenn Sie nicht aktualisieren können oder die Meldung danach weiterhin erscheint, setzen Sie `ENABLE_TOOL_SEARCH=false` in Ihrer Shell oder in Ihren [Einstellungen unter `env`](/docs/de/settings-reference#env). Wenn eine Einstellungsdatei die Variable bereits setzt, ändern Sie sie dort, da dieser Wert [einen Shell-Export überschreiben kann](/docs/de/settings-reference#how-env-values-interact-with-your-shell). Claude Code lädt MCP-Tools dann von vornherein.

2363* Wenn Ihr Gateway den Header verwirft, konfigurieren Sie es so, dass es den `anthropic-beta`-Header weiterleitet. Unter [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through) erfahren Sie, was Gateways weiterleiten müssen.

2312* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/de/env-vars) vor dem Start. [Pre-Release-Funktionen deaktivieren](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) beschreibt den genauen Umfang.2364* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/de/env-vars) vor dem Start. [Pre-Release-Funktionen deaktivieren](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) beschreibt den genauen Umfang.

2313 2365 

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

2367 

2314### Tool-Eingabeschema ist ungültig2368### Tool-Eingabeschema ist ungültig

2315 2369 

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


2384* Verwenden Sie einen Alias wie `sonnet` oder `opus` statt einer vollständigen versionierten ID. Aliase werden zu einem gepflegten Standard aufgelöst, daher veralten sie nicht. Siehe [Modellkonfiguration](/docs/de/model-config).2438* Verwenden Sie einen Alias wie `sonnet` oder `opus` statt einer vollständigen versionierten ID. Aliase werden zu einem gepflegten Standard aufgelöst, daher veralten sie nicht. Siehe [Modellkonfiguration](/docs/de/model-config).

2385* Wenn in der CLI immer wieder das falsche Modell auftaucht, ist irgendwo eine veraltete ID gesetzt. Überprüfen Sie die Orte, an denen Sie ein Modell setzen können, in [Prioritätsreihenfolge](/docs/de/model-config#setting-your-model) und entfernen Sie den veralteten Wert.2439* Wenn in der CLI immer wieder das falsche Modell auftaucht, ist irgendwo eine veraltete ID gesetzt. Überprüfen Sie die Orte, an denen Sie ein Modell setzen können, in [Prioritätsreihenfolge](/docs/de/model-config#setting-your-model) und entfernen Sie den veralteten Wert.

2386* Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als diesen Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das in einer älteren Version sehen.2440* Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als diesen Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das in einer älteren Version sehen.

2441* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) zeigt und jedes Modell auf diese Weise fehlschlägt, prüfen Sie, ob Ihr Gateway die Felder der Tool-Suche ablehnt, die Claude Code standardmäßig sendet. Setzen Sie dazu `ENABLE_TOOL_SEARCH=false`, wie unter [Tool-Suche über ein LLM-Gateway](/docs/de/mcp#tool-search-through-a-gateway) beschrieben, und versuchen Sie es dann erneut. Vor v2.1.304 war die Tool-Suche hinter einem Gateway ausgeschaltet, sofern Sie sie nicht mit `ENABLE_TOOL_SEARCH` eingeschaltet haben.

2387* Für Bereitstellungen auf Google Cloud's Agent Platform siehe [Fehlerbehebung für Google Cloud's Agent Platform](/docs/de/google-vertex-ai#troubleshooting).2442* Für Bereitstellungen auf Google Cloud's Agent Platform siehe [Fehlerbehebung für Google Cloud's Agent Platform](/docs/de/google-vertex-ai#troubleshooting).

2388 2443 

2389### Modell ist keine erkannte Modell-ID2444### Modell ist keine erkannte Modell-ID


2590Andere Nachrichten melden dieselbe Bedingung:2645Andere Nachrichten melden dieselbe Bedingung:

2591 2646 

2592* In einer interaktiven Sitzung lautet eine Benachrichtigung `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.2647* In einer interaktiven Sitzung lautet eine Benachrichtigung `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.

2593* Beim Start mit dem Flag `--advisor` lautet eine Warnung `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.`, und die Sitzung startet trotzdem.2648* Wenn Sie im [nicht interaktiven Modus](/docs/de/headless) mit dem Flag `--advisor` starten und der Lauf keine [Hintergrundsitzung](/docs/de/agent-view) ist, geht eine Warnung an stderr, und der Lauf startet trotzdem. Sie lautet `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` Eine interaktive Sitzung schreibt diese Warnung nur in das [Debug-Log](#configuration-warnings).

2594 2649 

2595**Was zu tun ist:**2650**Was zu tun ist:**

2596 2651 


3361 3416 

3362Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:3417Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:

3363 3418 

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

3365* ``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](/docs/de/skills#how-injected-commands-run)3420* ``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](/docs/de/skills#how-injected-commands-run)

3366* `No shell command in <name> was run`: Einer der `!`-Befehle der Datei enthält ein rohes Steuerzeichen außer Tab oder Zeilenumbruch, daher wird keiner davon ausgeführt. Siehe [wie Sie das Zeichen finden und entfernen](#no-shell-command-was-run)3421* `No shell command in <name> was run`: Einer der `!`-Befehle der Datei enthält ein rohes Steuerzeichen außer Tab oder Zeilenumbruch, daher wird keiner davon ausgeführt. Siehe [wie Sie das Zeichen finden und entfernen](#no-shell-command-was-run)

3367 3422 

3368**Vorgehensweise:**3423**Vorgehensweise:**


3464Claude Code schlägt den nächstliegenden Befehlsnamen oder Alias vor, den das Menü in dieser Sitzung auflistet. Wenn nichts nahe liegt, endet die Meldung nach dem Namen. Die Ursache ist in der Regel eine der folgenden:3519Claude Code schlägt den nächstliegenden Befehlsnamen oder Alias vor, den das Menü in dieser Sitzung auflistet. Wenn nichts nahe liegt, endet die Meldung nach dem Namen. Die Ursache ist in der Regel eine der folgenden:

3465 3520 

3466* Ein Tippfehler, etwa `/hepl` statt `/help`. [Wie das Befehlsmenü Ihre Eingabe abgleicht](/docs/de/commands#how-the-command-menu-matches-what-you-type) beschreibt, wie Sie vor dem Absenden einen nahen Treffer auswählen3521* Ein Tippfehler, etwa `/hepl` statt `/help`. [Wie das Befehlsmenü Ihre Eingabe abgleicht](/docs/de/commands#how-the-command-menu-matches-what-you-type) beschreibt, wie Sie vor dem Absenden einen nahen Treffer auswählen

3467* Ein Befehl, der existiert, aber in dieser Sitzung nicht verfügbar ist, weil eine Voraussetzung nicht erfüllt ist, etwa Ihre Plattform, Ihr Tarif oder Ihre Authentifizierungsmethode. Die Einträge zur Fehlerbehebung für [`/web-setup`](/docs/de/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) und [`/schedule`](/docs/de/routines#schedule-returns-unknown-command) behandeln zwei häufige Fälle. Einige Befehle antworten mit einer eigenen Meldung, wenn die Richtlinie Ihrer Organisation sie deaktiviert, etwa [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3522* Ein Befehl, der existiert, aber in dieser Sitzung nicht verfügbar ist, weil eine Voraussetzung nicht erfüllt ist, etwa Ihre Plattform, Ihr Plan oder Ihre Authentifizierungsmethode. Siehe den Eintrag für [`/web-setup`](/docs/de/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command), [`/schedule`](/docs/de/routines#schedule-returns-unknown-command) oder [`/auto-mode-setup`](/docs/de/auto-mode-config#auto-mode-setup-returns-unknown-command). Manche Befehle antworten mit einer eigenen Meldung, wenn die Richtlinie Ihrer Organisation sie deaktiviert, etwa [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)

3468* Ein Befehl aus einem [Plugin](/docs/de/plugins/overview) oder [MCP-Server](/docs/de/mcp#use-mcp-prompts-as-commands), das bzw. der in dieser Sitzung nicht installiert oder verbunden ist3523* Ein Befehl aus einem [Plugin](/docs/de/plugins/overview) oder [MCP-Server](/docs/de/mcp#use-mcp-prompts-as-commands), das bzw. der in dieser Sitzung nicht installiert oder verbunden ist

3469 3524 

3470Claude Code antwortet auf einen nicht zugeordneten `/`-Namen nur in einer interaktiven Terminalsitzung auf diese Weise. In jeder anderen Sitzung sendet es den Prompt stattdessen als normale Nachricht an Claude, mit dem Hinweis, dass der Befehl nicht ausgeführt wurde, und einer Liste der Befehle, die Claude in der Sitzung ausführen kann. Zu diesen Sitzungen gehören:3525Claude Code antwortet auf einen nicht zugeordneten `/`-Namen nur in einer interaktiven Terminalsitzung auf diese Weise. In jeder anderen Sitzung sendet es den Prompt stattdessen als normale Nachricht an Claude, mit dem Hinweis, dass der Befehl nicht ausgeführt wurde, und einer Liste der Befehle, die Claude in der Sitzung ausführen kann. Zu diesen Sitzungen gehören:


3856* Öffnen Sie die Sitzung selbst und führen Sie `/recap` dort aus: in ihrem Terminal, in der [Desktop-App](/docs/de/desktop) oder der [mobilen App](/docs/de/mobile), unter [claude.ai/code](https://claude.ai/code) oder über [Remote Control](/docs/de/remote-control)3911* Öffnen Sie die Sitzung selbst und führen Sie `/recap` dort aus: in ihrem Terminal, in der [Desktop-App](/docs/de/desktop) oder der [mobilen App](/docs/de/mobile), unter [claude.ai/code](https://claude.ai/code) oder über [Remote Control](/docs/de/remote-control)

3857* Wenn eine geplante Aufgabe in der Cloud oder ein anderes Programm es gesendet hat, entfernen Sie `/recap` aus diesem Prompt3912* Wenn eine geplante Aufgabe in der Cloud oder ein anderes Programm es gesendet hat, entfernen Sie `/recap` aus diesem Prompt

3858 3913 

3914### /feedback is disabled by your organization's policy

3915 

3916Diese Meldung bedeutet, dass die Richtlinie Ihrer Organisation kein Produktfeedback aus Claude Code zulässt, daher öffnen `/feedback`, `/bug` und `/share` den Feedback-Dialog nicht. Die Meldung nennt den Befehl, den Sie in der Eingabeaufforderung von Claude Code eingegeben haben:

3917 

3918```text wrap theme={null}

3919/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.

3920```

3921 

3922Die Meldung kann auch nur aus ihrem ersten Satz bestehen.

3923 

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

3925 

3926* Um einen Fehler zu melden, eröffnen Sie ein Issue unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Issues dort sind für alle lesbar, lassen Sie daher Code, Transkripte und alles andere Vertrauliche weg.

3927 

3928Vor v2.1.302 lautete die vollständige Meldung `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

3929 

3859## Plugin-Fehler3930## Plugin-Fehler

3860 3931 

3861Diese Fehler stammen aus der [Plugin](/docs/de/plugins/overview)- und [Marketplace](/docs/de/plugins/overview)-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, wie z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting).3932Diese Fehler stammen aus der [Plugin](/docs/de/plugins/overview)- und [Marketplace](/docs/de/plugins/overview)-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, wie z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting).


4001 4072 

4002### Pfad entweicht dem Plugin-Verzeichnis4073### Pfad entweicht dem Plugin-Verzeichnis

4003 4074 

4004Ein Plugin-Komponentenpfad, der im `plugin.json` des Plugins oder in seinem [Marketplace-Eintrag](/docs/de/plugins/marketplace-reference#plugin-entries) deklariert ist, wird außerhalb des eigenen Verzeichnisses des Plugins aufgelöst. Claude Code verwirft diesen Pfad und lädt den Rest des Plugins. Der Komponentenname in der Meldung, wie z. B. `commands` oder `hooks`, benennt das Feld, das den Pfad deklariert hat.4075Einer der Komponentenpfade des Plugins führt aus dem Plugin-Verzeichnis heraus oder konnte nicht als darin liegend bestätigt werden, daher verwirft Claude Code diesen Pfad und lädt den Rest des Plugins. Bei einem Pfad, den das Plugin in `plugin.json` oder in seinem [Marketplace-Eintrag](/docs/de/plugins/marketplace-reference#plugin-entries) deklariert, benennt der Komponentenname in der Meldung, wie z. B. `commands` oder `hooks`, das Feld, das den Pfad deklariert hat.

4005 4076 

4006```text theme={null}4077```text theme={null}

4007commands path escapes plugin directory: ./../shared.md4078commands path escapes plugin directory: ./../shared.md


4015commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory4086commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory

4016```4087```

4017 4088 

4089Eine Meldung, die den vollständigen Pfad einer der eigenen Dateien eines Marketplace-Plugins angibt, wie z. B. `hooks/hooks.json`, bedeutet, dass Claude Code diese Datei übersprungen hat. Das geschieht, wenn Claude Code nicht bestätigen kann, dass sich die Datei innerhalb des Plugins befindet oder, bei einem Plugin in einem [lokalen Marketplace](/docs/de/plugins/loading#in-place-and-copied-plugins), innerhalb dieses Marketplace. Die Meldung führt jede dieser Dateien unter dem angezeigten Komponentennamen auf:

4090 

4091* `hooks/hooks.json`: `hooks`

4092* `monitors/monitors.json`: `monitors`

4093* `settings.json`: `settings`

4094* `SKILL.md` im Plugin-Stammverzeichnis: `skills`

4095 

4096Diese Meldung betrifft beispielsweise eine `hooks/hooks.json`, die außerhalb sowohl des Plugins als auch seines lokalen Marketplace aufgelöst wird:

4097 

4098```text theme={null}

4099hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory

4100```

4101 

4018Auf macOS und Linux lehnt Claude Code auch einen Komponentenpfad ab, der an irgendeiner Stelle einen Backslash enthält, auch wenn der Pfad im Plugin bleibt. Ein Plugin, dessen Komponentenpfade Windows-ähnliche Trennzeichen verwenden, wird auf Windows geladen und löst diese Ablehnung auf den anderen Plattformen aus:4102Auf macOS und Linux lehnt Claude Code auch einen Komponentenpfad ab, der an irgendeiner Stelle einen Backslash enthält, auch wenn der Pfad im Plugin bleibt. Ein Plugin, dessen Komponentenpfade Windows-ähnliche Trennzeichen verwenden, wird auf Windows geladen und löst diese Ablehnung auf den anderen Plattformen aus:

4019 4103 

4020```text theme={null}4104```text theme={null}


4023 4107 

4024Vor v2.1.251 lud Claude Code einen `commands`-Pfad, der in einem Marketplace-Eintrag deklariert war, auch wenn er außerhalb des Plugin-Verzeichnisses zeigte.4108Vor v2.1.251 lud Claude Code einen `commands`-Pfad, der in einem Marketplace-Eintrag deklariert war, auch wenn er außerhalb des Plugin-Verzeichnisses zeigte.

4025 4109 

4026Vor v2.1.257 überprüfte die Kontrolle nur die Schreibweise des Pfads, nicht wo ein Symlink führt.4110Vor v2.1.257 überprüfte die Kontrolle von Pfaden, die das Plugin deklariert, nur die Schreibweise des Pfads, nicht wohin ein Symlink führt.

4027 4111 

4028**Was zu tun ist:**4112**Was zu tun ist:**

4029 4113 

4030* Verschieben Sie die referenzierte Datei in das Plugin-Verzeichnis und zeigen Sie mit einem `./` relativen Pfad darauf4114* Wenn Sie das Plugin installiert haben und es nicht selbst pflegen, leiten Sie die Meldung an seinen Autor weiter

4031* Wenn der Pfad ein Symlink zu einer Datei außerhalb des Plugins ist, ersetzen Sie den Symlink durch eine Kopie der Datei4115* Verschieben Sie bei einem Pfad, den das Plugin deklariert, die referenzierte Datei in das Plugin-Verzeichnis und zeigen Sie mit einem `./` relativen Pfad darauf

4032* Wenn die Meldung sagt, dass der Pfad einen Backslash enthält, schreiben Sie den Pfad mit Schrägstrichen, z. B. `./commands/deploy.md`4116* Wenn der Pfad oder ein darüberliegender Ordner innerhalb des Plugins ein Symlink ist, der aus dem Plugin herausführt, ersetzen Sie den Symlink durch eine Kopie dessen, worauf er zeigt

4117* Wenn die Meldung sagt, dass ein Pfad, den das Plugin deklariert, einen Backslash enthält, schreiben Sie den Pfad mit Schrägstrichen, z. B. `./commands/deploy.md`

4118* Wenn die Meldung mit `EACCES` endet, stellen Sie Ihre Ausführungsberechtigung für jedes Verzeichnis wieder her, das zu der Datei oder dem Ordner führt, die der Pfad benennt. Überprüfen Sie die Verzeichnisse über dem Pfad, folgen Sie dann jedem Symlink, auf den Sie stoßen, und überprüfen Sie die Verzeichnisse, die zu seinem Ziel führen. Schlagen Sie jeden anderen Fehlercode in den [Ursachen und Schritten für einen Pfad, der nicht überprüft werden konnte](#path-could-not-be-checked) nach.

4033* Um Dateien mit anderen Plugins im selben Marketplace zu teilen, verlinken Sie sie mit einem Symlink im Plugin-Verzeichnis, gemäß den [Symlink-Regeln](/docs/de/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)4119* Um Dateien mit anderen Plugins im selben Marketplace zu teilen, verlinken Sie sie mit einem Symlink im Plugin-Verzeichnis, gemäß den [Symlink-Regeln](/docs/de/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)

4034 4120 

4121### Plugin nicht geladen: Sein Manifest wurde nicht gelesen

4122 

4123Claude Code konnte nicht bestätigen, dass sich das [Manifest](/docs/de/plugins/manifest-reference) eines Marketplace-Plugins unter `.claude-plugin/plugin.json` innerhalb des Plugins befindet, daher lädt es nichts aus diesem Plugin. Bei einem Plugin in einem [lokalen Marketplace](/docs/de/plugins/loading#in-place-and-copied-plugins) konnte Claude Code außerdem nicht bestätigen, dass sich das Manifest innerhalb dieses Marketplace befindet. Die Meldung erscheint auf der Registerkarte **Fehler** in `/plugin`, und der Grund an ihrem Ende gibt an, was Claude Code vorgefunden hat.

4124 

4125Diese Meldung betrifft beispielsweise ein Plugin in einem lokalen Marketplace, dessen `.claude-plugin`-Ordner ein Symlink ist, der aus dem Marketplace herausführt:

4126 

4127```text theme={null}

4128Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory

4129```

4130 

4131**Was zu tun ist:**

4132 

4133* Wenn der Grund mit `EACCES` endet, stellen Sie Ihre Ausführungsberechtigung für jedes Verzeichnis wieder her, das zum Manifest führt. Überprüfen Sie die Verzeichnisse über dem Manifest, folgen Sie dann jedem Symlink, auf den Sie stoßen, und überprüfen Sie die Verzeichnisse, die zu seinem Ziel führen. Schlagen Sie jeden anderen Fehlercode in den [Ursachen und Schritten für einen Pfad, der nicht überprüft werden konnte](#path-could-not-be-checked) nach.

4134* Wenn Sie das Plugin pflegen und der Grund angibt, wohin das Manifest aufgelöst wird, ist der `.claude-plugin`-Ordner oder `plugin.json` selbst ein Symlink, der dorthin führt. Ersetzen Sie diesen Link durch eine Kopie dessen, worauf er zeigt.

4135* Wenn Sie das Plugin installiert haben und es nicht selbst pflegen, leiten Sie die Meldung an seinen Autor weiter

4136 

4035### Pfad konnte nicht überprüft werden4137### Pfad konnte nicht überprüft werden

4036 4138 

4037Claude Code fragte das Betriebssystem, ob ein Plugin-Pfad existiert, und erhielt einen Fehler, der nicht „nicht gefunden“ ist, daher wird nicht geladen, was der Pfad benennt. Wie viel des Plugins geladen wird, hängt davon ab, welcher Pfad fehlgeschlagen ist:4139Claude Code fragte das Betriebssystem, ob ein Plugin-Pfad existiert, und erhielt einen Fehler, der nicht „nicht gefunden“ ist, daher wird nicht geladen, was der Pfad benennt. Wie viel des Plugins geladen wird, hängt davon ab, welcher Pfad fehlgeschlagen ist:


4226 4328 

4227Vor v2.1.281 beendete ein Null-Byte in einem Read-, Write-, Edit- oder NotebookEdit-Pfad den ganzen Turn mit einem Fehler, der `Path contains null bytes` nannte, und das Tool wurde nie ausgeführt.4329Vor v2.1.281 beendete ein Null-Byte in einem Read-, Write-, Edit- oder NotebookEdit-Pfad den ganzen Turn mit einem Fehler, der `Path contains null bytes` nannte, und das Tool wurde nie ausgeführt.

4228 4330 

4331### Datei ist zu groß, um als Bild gelesen zu werden

4332 

4333Claude hat versucht, eine Datei mit dem [Read-Tool](/docs/de/tools-reference#read-tool-behavior) als Bild zu lesen, und die Datei ist größer als 128 MB, die maximale Größe, die Read aus einer Bilddatei lädt. Es wurde nichts gelesen, und Claude erhält diesen Fehler als Tool-Ergebnis:

4334 

4335```text wrap theme={null}

4336File is too large to read as an image (the limit is 128MB): <path>. If it is an image, resize it or export a smaller copy, then read that.

4337```

4338 

4339Wenn der Pfad eine Pipe oder ein Gerät statt einer regulären Datei ist, bricht Read ab, sobald mehr als 128 MB eingegangen sind, und gibt stattdessen diesen Fehler zurück:

4340 

4341```text wrap theme={null}

4342Cannot read this as an image: <path> is a pipe or a device, not a regular file, and it sent more than 128MB without ending.

4343```

4344 

4345**Was zu tun ist:**

4346 

4347* Wenn Claude der Nachricht `File is too large` gefolgt ist und das Bild anschließend verkleinert oder eine kleinere Kopie gelesen hat, tun Sie nichts

4348* Wenn Claude beim Fehler aufgehört hat, exportieren Sie selbst eine Kopie unter 128 MB, zum Beispiel mit einer niedrigeren Auflösung, und verweisen Sie Claude auf diese Datei

4349* Wenn der Pfad eine Pipe oder ein Gerät war, verweisen Sie Claude stattdessen auf eine reguläre Bilddatei

4350 

4229### subagent\_type ist erforderlich4351### subagent\_type ist erforderlich

4230 4352 

4231```text theme={null}4353```text theme={null}


4316* Führen Sie `claude` in dem Ordner aus, den das [Debug-Log](/docs/de/debug-your-config) benennt, und akzeptieren Sie den Vertrauensdialog. Die Definition wird erneut angewendet, wenn Claude Code den Teamkollegen das nächste Mal zurückbringt; Sie müssen die Lead-Sitzung nicht neu starten4438* Führen Sie `claude` in dem Ordner aus, den das [Debug-Log](/docs/de/debug-your-config) benennt, und akzeptieren Sie den Vertrauensdialog. Die Definition wird erneut angewendet, wenn Claude Code den Teamkollegen das nächste Mal zurückbringt; Sie müssen die Lead-Sitzung nicht neu starten

4317* Oder setzen Sie den Eintrag `hasTrustDialogAccepted` in `~/.claude.json` auf `true`, wobei Sie genau den `projects["<path>"]`-Schlüssel verwenden, den das Debug-Log ausgibt4439* Oder setzen Sie den Eintrag `hasTrustDialogAccepted` in `~/.claude.json` auf `true`, wobei Sie genau den `projects["<path>"]`-Schlüssel verwenden, den das Debug-Log ausgibt

4318 4440 

4441### Nur ein Teamkollege kann eine Shutdown-Anfrage genehmigen

4442 

4443Claude Code hat eine Shutdown-Genehmigung in einem [Agent-Team](/docs/de/agent-teams) abgelehnt, weil die Sitzung, die sie gesendet hat, nicht als Teamkollege läuft. Es wurde nichts gesendet und nichts heruntergefahren. Die Weigerung erscheint im Tool-Ergebnis der sendenden Sitzung:

4444 

4445```text wrap theme={null}

4446Only a teammate can approve a shutdown request, and this session is not running as one. Nothing was sent. To shut down a teammate, send that teammate a shutdown_request message. The teammate is the one that approves it.

4447```

4448 

4449**Was zu tun ist:**

4450 

4451* Wenn die Weigerung in Ihrer Lead-Sitzung erschienen ist, prüfen Sie zuerst, ob der Teamkollege inzwischen heruntergefahren ist. Die Weigerung geht mit der Anweisung an Claude zurück, stattdessen eine `shutdown_request` zu senden, und der Turn wird fortgesetzt. In einer interaktiven Lead-Sitzung erscheint `<name> has shut down.`, wenn der Teamkollege eine Shutdown-Anfrage genehmigt.

4452* Wenn der Teamkollege noch läuft, bitten Sie den Lead in dessen Eingabefeld, den Teamkollegen herunterzufahren, zum Beispiel mit `Ask the researcher teammate to shut down`. Siehe [Teamkollegen herunterfahren](/docs/de/agent-teams#shut-down-teammates).

4453* Wenn ein ehemaliger Teamkollege, den Sie selbst mit `claude --resume` fortgesetzt haben, diese Weigerung erhalten hat, wurde nichts gesendet. Um diese Sitzung zu beenden, führen Sie `/exit` in deren Eingabefeld aus.

4454 

4319### Nachricht zu groß für sitzungsübergreifende Zustellung4455### Nachricht zu groß für sitzungsübergreifende Zustellung

4320 4456 

4321Claudes [sitzungsübergreifende Nachricht](/docs/de/cross-session-messaging) an eine andere Ihrer Sitzungen auf diesem Rechner war zu lang zum Senden. Claude Code lehnte sie ab, und die empfangende Sitzung erhielt nichts. Die Weigerung erscheint im Tool-Ergebnis der sendenden Sitzung, nicht als Banner in Ihrem Terminal. Sie nennt beide Größen und wie die Nachricht passend gemacht werden kann:4457Claudes [sitzungsübergreifende Nachricht](/docs/de/cross-session-messaging) an eine andere Ihrer Sitzungen auf diesem Rechner war zu lang zum Senden. Claude Code lehnte sie ab, und die empfangende Sitzung erhielt nichts. Die Weigerung erscheint im Tool-Ergebnis der sendenden Sitzung, nicht als Banner in Ihrem Terminal. Sie nennt beide Größen und wie die Nachricht passend gemacht werden kann:


4449 4585 

4450### Festplattenquota oder Temp-Dateisystem ist voll4586### Festplattenquota oder Temp-Dateisystem ist voll

4451 4587 

4452Claude Code speichert die Ausgabe jedes Bash- und PowerShell-Befehls in einer Datei unter seinem Temp-Verzeichnis. Wenn ein Befehl mit einem Exit-Code ungleich null und ganz ohne Ausgabe endet, überprüft Claude Code, ob das Dateisystem, das diese Datei enthält, keinen Speicherplatz oder keine Inodes mehr hat oder ob Ihre Festplattenquota darauf aufgebraucht ist. Wenn ja, erscheint anstelle der leeren Ausgabe eine Diagnose im Ergebnis des Befehls:4588Claude Code speichert die Ausgabe jedes Bash- und PowerShell-Befehls in einer Datei unter seinem Temp-Verzeichnis. Diese Nachrichten im Ergebnis eines Befehls bedeuten, dass das Dateisystem, das dieses Verzeichnis enthält, oder Ihre Festplattenquota darauf voll ist.

4589 

4590Wenn Claude Code diese Datei nicht erstellen kann, weil das Dateisystem oder Ihre Quota darauf voll ist, startet Ihr Befehl nicht, und das Ergebnis lautet:

4591 

4592```text wrap theme={null}

4593The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran. If this is the user's own computer, tell them before deleting anything to make room.

4594```

4595 

4596Wenn ein Befehl mit einem Exit-Code ungleich null und ganz ohne Ausgabe endet, überprüft Claude Code das Dateisystem, das die Ausgabedatei enthält. Wenn dieses Dateisystem keinen Speicherplatz oder keine Inodes mehr hat oder Ihre Festplattenquota darauf aufgebraucht ist, ersetzt eine Diagnose die leere Ausgabe im Ergebnis des Befehls:

4453 4597 

4454```text wrap theme={null}4598```text wrap theme={null}

4455Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.4599Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.


4460* `Your disk quota is full ... (EDQUOT)`: Ihre eigene Quota auf diesem Dateisystem ist aufgebraucht. Eine Quota kann voll sein, während das Dateisystem noch freien Speicherplatz anzeigt4604* `Your disk quota is full ... (EDQUOT)`: Ihre eigene Quota auf diesem Dateisystem ist aufgebraucht. Eine Quota kann voll sein, während das Dateisystem noch freien Speicherplatz anzeigt

4461* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: Das Dateisystem oder Ihre Quota darauf hat keinen Speicherplatz mehr4605* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: Das Dateisystem oder Ihre Quota darauf hat keinen Speicherplatz mehr

4462* `Command output was lost: the temp filesystem at ... is full` oder `... is out of inodes`: Das Dateisystem hat fast keinen freien Speicherplatz mehr oder geht die Inodes aus4606* `Command output was lost: the temp filesystem at ... is full` oder `... is out of inodes`: Das Dateisystem hat fast keinen freien Speicherplatz mehr oder geht die Inodes aus

4607* `The command was not started: this computer's disk is full (ENOSPC)` oder `... (EDQUOT)`: Das Dateisystem hat keinen Speicherplatz mehr für die Ausgabedatei, oder bei `EDQUOT` ist Ihre eigene Quota darauf aufgebraucht

4463 4608 

4464**Was zu tun ist:**4609**Was zu tun ist:**

4465 4610 

4466* Löschen Sie Dateien, die Sie nicht mehr benötigen, auf dem Dateisystem, das das Temp-Verzeichnis von Claude Code enthält. Bei `EDQUOT` löschen Sie Dateien, die auf Ihre eigene Quota angerechnet werden. Bei `out of inodes` löschen Sie viele Dateien statt weniger großer, da jede Datei unabhängig von ihrer Größe einen Inode belegt4611* Löschen Sie Dateien, die Sie nicht mehr benötigen, auf dem Dateisystem, das das Temp-Verzeichnis von Claude Code enthält. Wenn Ihre Nachricht dieses Verzeichnis nicht nennt, schlagen Sie seinen Standardort in der Referenz zu [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) nach. Bei `EDQUOT` löschen Sie Dateien, die auf Ihre eigene Quota angerechnet werden. Bei `out of inodes` löschen Sie viele Dateien statt weniger großer, da jede Datei unabhängig von ihrer Größe einen Inode belegt

4467* Oder starten Sie Claude Code neu, wobei [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) auf ein Verzeichnis auf einem Dateisystem mit ausreichend Platz gesetzt ist4612* Oder starten Sie Claude Code neu, wobei [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) auf ein Verzeichnis auf einem Dateisystem mit ausreichend Platz gesetzt ist

4468* Lassen Sie Claude den Befehl dann erneut ausführen. Die ausgegebene Ausgabe ging verloren, sie wurde nicht gekürzt4613* Lassen Sie Claude den Befehl dann erneut ausführen

4614 

4615Vor v2.1.305 gab ein Befehl, den Claude Code wegen voller Festplatte nicht starten konnte, nur den Fehlertext des Betriebssystems zurück. Dieser Text lautete zum Beispiel `ENOSPC: no space left on device, open <path>.output`.

4469 4616 

4470### Datei ist kein gültiges UTF-84617### Datei ist kein gültiges UTF-8

4471 4618 


4524* Unter Windows: Damit Claude direkt von der Freigabe veröffentlichen kann, ordnen Sie sie einem Laufwerksbuchstaben zu und übergeben Sie das Laufwerk beim Start von Claude Code. Führen Sie in PowerShell zum Beispiel `net use Z: \\server\share` und dann `claude --add-dir Z:\` aus. Claude kann dann Dateien von diesem Laufwerk veröffentlichen. Das Hinzufügen des Laufwerks während der Sitzung mit `/add-dir` reicht nicht aus.4671* Unter Windows: Damit Claude direkt von der Freigabe veröffentlichen kann, ordnen Sie sie einem Laufwerksbuchstaben zu und übergeben Sie das Laufwerk beim Start von Claude Code. Führen Sie in PowerShell zum Beispiel `net use Z: \\server\share` und dann `claude --add-dir Z:\` aus. Claude kann dann Dateien von diesem Laufwerk veröffentlichen. Das Hinzufügen des Laufwerks während der Sitzung mit `/add-dir` reicht nicht aus.

4525* Unter macOS oder Linux binden Sie die Freigabe in einem Verzeichnis ein, etwa unter `/mnt` oder `/Volumes`, und veröffentlichen Sie von diesem Pfad statt vom Automount-Pfad4672* Unter macOS oder Linux binden Sie die Freigabe in einem Verzeichnis ein, etwa unter `/mnt` oder `/Volumes`, und veröffentlichen Sie von diesem Pfad statt vom Automount-Pfad

4526 4673 

4674### Nicht veröffentlicht: Claude hat denselben Inhalt erneut gesendet, nachdem eine neuere Version des Artefakts ihn abgewiesen hatte

4675 

4676Diese rote Zeile unter einem Artifact-Aufruf bedeutet, dass Claude Code eine wiederholte Veröffentlichung gestoppt hat: Das [Artefakt](/docs/de/artifacts) wurde nicht aktualisiert, und in die Datei, aus der Claude veröffentlicht, wurde nichts geschrieben. Sie müssen nichts tun, es sei denn, Claude hört auf, ohne zu veröffentlichen.

4677 

4678Früher in der Sitzung hat Claude Code eine Veröffentlichung abgewiesen, weil das Artefakt eine neuere Version hatte, zum Beispiel eine, die ein [Bearbeiter](/docs/de/artifacts#let-someone-edit-with-you) oder eine andere Ihrer Sitzungen veröffentlicht hat. Das Ende der Zeile gibt an, was Claude als Nächstes tun muss:

4679 

4680```text wrap theme={null}

4681Not published: Claude sent the same content again after a newer version of the artifact turned it away. Claude needs to work from that newer version first.

4682Not published: Claude sent the same content again after a newer version of the artifact turned it away. The artifact hasn't changed since, so publishing it once more should go through.

4683Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. Claude needs to work from that newer version first.

4684Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. The artifact hasn't changed since, so publishing once more should go through.

4685```

4686 

4687**Was zu tun ist:**

4688 

4689* **Endet mit `Claude needs to work from that newer version first`**: Wenn Claude dort aufgehört hat, bitten Sie es, die aktuelle Version des Artefakts abzurufen, deren Änderungen einzuarbeiten und erneut zu veröffentlichen

4690* **Endet mit `should go through`**: Wenn Claude dort aufgehört hat, bitten Sie es, erneut zu veröffentlichen

4691 

4527### Lesen einer lokalen Datei von außerhalb der verbundenen Ordner in einer Cowork-Sitzung4692### Lesen einer lokalen Datei von außerhalb der verbundenen Ordner in einer Cowork-Sitzung

4528 4693 

4529In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung, die auf Ihrem Rechner in der Claude Desktop-App läuft, nannte Claude eine lokale Datei für ein [Artefakt](/docs/de/artifacts). Claude Code konnte nicht bestätigen, dass die Datei eine einfache Datei innerhalb der verbundenen Ordner der Sitzung ist: Der Pfad liegt außerhalb dieser Ordner, führt durch einen symbolischen Link oder ist so geschrieben, dass er eine andere Datei benennen kann, als es scheint. Das Lesen einer solchen Datei erfordert Ihre Genehmigung, und in einer Sitzung, die Ihnen die Genehmigungskarte nicht anzeigen kann, etwa einer, die so eingestellt ist, dass alle Genehmigungen übersprungen werden, lehnt Claude Code das Lesen ab.4694In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung, die auf Ihrem Rechner in der Claude Desktop-App läuft, nannte Claude eine lokale Datei für ein [Artefakt](/docs/de/artifacts). Claude Code konnte nicht bestätigen, dass die Datei eine einfache Datei innerhalb der verbundenen Ordner der Sitzung ist: Der Pfad liegt außerhalb dieser Ordner, führt durch einen symbolischen Link oder ist so geschrieben, dass er eine andere Datei benennen kann, als es scheint. Das Lesen einer solchen Datei erfordert Ihre Genehmigung, und in einer Sitzung, die Ihnen die Genehmigungskarte nicht anzeigen kann, etwa einer, die so eingestellt ist, dass alle Genehmigungen übersprungen werden, lehnt Claude Code das Lesen ab.


4816* Um die Schleife fortzusetzen, [antworten Sie der Sitzung](/docs/de/agent-view#peek-and-reply) und sagen Sie es, etwa `keep the loop running`. Claude liest den Hinweis mit Ihrer Antwort und kann das nächste Aufwachen planen4981* Um die Schleife fortzusetzen, [antworten Sie der Sitzung](/docs/de/agent-view#peek-and-reply) und sagen Sie es, etwa `keep the loop running`. Claude liest den Hinweis mit Ihrer Antwort und kann das nächste Aufwachen planen

4817* Wenn Sie mit der Schleife fertig sind, tun Sie nichts. Sie ist bereits gestoppt4982* Wenn Sie mit der Schleife fertig sind, tun Sie nichts. Sie ist bereits gestoppt

4818 4983 

4984### No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder

4985 

4986Die [Hintergrund-Sitzung](/docs/de/agent-view), die diese Meldung anzeigt, verwendet Ihr [LLM-Gateway](/docs/de/llm-gateway) nicht: Sie hat die Adresse des Gateways nicht erhalten, daher schlagen ihre Anfragen fehl. Die Meldung erscheint in der Konversation anstelle der Antwort von Claude, wobei die ID und der Ordner Ihrer Sitzung eingesetzt sind:

4987 

4988```text wrap theme={null}

4989No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder. To fix, run `claude respawn abc12345` from ~/project in another terminal where your gateway is set, or set ANTHROPIC_BASE_URL and its API key or token in a settings file's env block.

4990```

4991 

4992Während Sie an die Sitzung angehängt sind, zeigt der Hinweis unter ihrem Eingabefeld die Kurzform `No LLM gateway: opened from another folder · respawn from ~/project`.

4993 

4994Sie haben die Sitzung aus einem anderen Ordner als dem in der Meldung genannten entsandt, aufgeweckt oder neu gestartet, während `ANTHROPIC_BASE_URL` auf Ihr Gateway gesetzt war. Für die Fälle, in denen ein in der Shell exportiertes Gateway eine Hintergrund-Sitzung erreicht, siehe [LLM-Gateway](/docs/de/agent-view#llm-gateway).

4995 

4996**Was zu tun ist:**

4997 

4998* **Sie haben die Agent-Ansicht in einem Projekt verwendet, dessen Einstellungen das Gateway festlegen**: Tragen Sie `ANTHROPIC_BASE_URL` und den zugehörigen API-Schlüssel oder das Token in [den `env`-Block einer Einstellungsdatei](/docs/de/llm-gateway-connect#set-in-a-settings-file) ein. Verwenden Sie `~/.claude/settings.json` oder `.claude/settings.local.json` im eigenen Projekt der Sitzung; beide werden von einer neu gestarteten Sitzung gelesen. Führen Sie dann `claude respawn <id>` in Ihrer Shell aus einem beliebigen Ordner aus.

4999* **Sie haben das Gateway in Ihrem Terminal exportiert**: Wechseln Sie in einem Terminal, in dem Sie die Gateway-Variablen exportiert haben, mit `cd` in den Ordner, den die Meldung nennt, und führen Sie den `claude respawn <id>`-Befehl aus der Meldung aus. Die Sitzung startet aus ihrer gespeicherten Konversation neu.

5000 * Das Gateway erreicht die Sitzung nur, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) selbst aus einer Shell gestartet wurde, die dasselbe Gateway exportiert hat. Falls nicht, starten Sie ihn aus diesem Terminal neu, wie unter [Dispatch schlägt mit `Could not resolve authentication method` fehl](/docs/de/agent-view#dispatch-fails-with-could-not-resolve-authentication-method) beschrieben, und führen Sie dann den Respawn-Befehl erneut aus.

5001 

5002Vor v2.1.302 zeigte eine Hintergrund-Sitzung in dieser Situation stattdessen einen Anmeldefehler wie [`Not logged in · Please run /login`](#not-logged-in), ohne den Ordner zu nennen.

5003 

4819### CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler5004### CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler

4820 5005 

4821[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/de/corporate-launcher) ist gesetzt, und sein Wert kann nicht verwendet werden, daher lehnt Claude Code ab, den betroffenen Prozess zu starten, anstatt ihn ohne den Launcher auszuführen. Konfigurationsprobleme werden mit einer Meldung gemeldet, die mit dem Variablennamen beginnt und den Grund angibt, zum Beispiel:5006[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/de/corporate-launcher) ist gesetzt, und sein Wert kann nicht verwendet werden, daher lehnt Claude Code ab, den betroffenen Prozess zu starten, anstatt ihn ohne den Launcher auszuführen. Konfigurationsprobleme werden mit einer Meldung gemeldet, die mit dem Variablennamen beginnt und den Grund angibt, zum Beispiel:


5094 5279 

5095## Konfigurationswarnungen5280## Konfigurationswarnungen

5096 5281 

5097Claude Code schreibt die meisten dieser Meldungen auf stderr, nicht in die Konversation, und schreibt die meisten beim Start. Ein Eintrag gibt an, wenn seine Meldung an anderer Stelle erscheint, z. B. im Debug-Protokoll oder als Startnachricht in der Konversationsansicht, oder zu einem anderen Zeitpunkt, z. B. die [Zeile zur Diagnose nicht erkannter Modelle](#unrecognized-model-id-on-a-request) zur Anfragezeitpunkt.5282Um eine Warnung zu finden, die Claude Code beim Start einer interaktiven Sitzung ausgegeben hat, sehen Sie zuerst unterhalb des Startbanners nach und dann im Debug-Log:

5283 

5284* **Zeile unterhalb des Startbanners**: einige Warnungen zu [Berechtigungsregeln](/docs/de/permissions), z. B. [`⚠ Deny rule Bsh matches no tool · check for typos`](#matches-no-tool)

5285* **Debug-Log**: Claude Code führt dieses Log nur im Debug-Modus. Um die darin enthaltenen Warnungen zu lesen, starten Sie Claude Code aus Ihrer Shell mit `claude --debug-file <path>` und öffnen Sie dann die Datei unter diesem Pfad.

5286 

5287Im [nicht interaktiven Modus](/docs/de/headless) mit Textausgabe, außerhalb einer [Hintergrundsitzung](/docs/de/agent-view), finden Sie Startwarnungen auf stderr.

5288 

5289Vor v2.1.305 finden Sie sie auch in einer interaktiven Sitzung auf stderr, einschließlich der Warnungen zu Berechtigungsregeln, die jetzt als Zeilen unterhalb des Banners erscheinen.

5098 5290 

5099### Claude Code wurde nach einem nicht behebbaren Schnittstellenfehler beendet5291### Claude Code wurde nach einem nicht behebbaren Schnittstellenfehler beendet

5100 5292 


5214 5406 

5215### Arbeitsverzeichnis ist ein Netzwerkpfad5407### Arbeitsverzeichnis ist ein Netzwerkpfad

5216 5408 

5217Claude Code fügt Netzwerkpfade nicht als Arbeitsverzeichnisse hinzu. Das Nachschlagen eines Netzwerkpfads kann den Host kontaktieren, den er benennt, und unter Windows kann dieser Kontakt dem Host Ihre Anmeldedaten senden, daher lehnt Claude Code den Pfad ab, ohne ihn nachzuschlagen. Sie sehen diese Meldung, wenn Sie `/add-dir` mit einem solchen Pfad ausführen, oder als Warnung beim Start. Wenn es beim Start erscheint, startet Claude Code ohne dieses Verzeichnis.5409Claude Code fügt Netzwerkpfade nicht als Arbeitsverzeichnisse hinzu. Das Nachschlagen eines Netzwerkpfads kann den Host kontaktieren, den er benennt, und unter Windows kann dieser Kontakt dem Host Ihre Anmeldedaten senden. Claude Code lehnt den Pfad daher ab, ohne ihn nachzuschlagen.

5410 

5411Sie sehen diese Meldung, wenn Sie `/add-dir` mit einem Netzwerkpfad ausführen:

5218 5412 

5219```text theme={null}5413```text theme={null}

5220\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).5414\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).

5221```5415```

5222 5416 

5417Wenn Sie stattdessen einen solchen Pfad beim Start übergeben, mit `--add-dir` oder in `permissions.additionalDirectories`, startet Claude Code ohne dieses Verzeichnis. In einer interaktiven Sitzung sehen Sie die Meldung beim Start nicht, weil sie zusammen mit den anderen [Startwarnungen](#configuration-warnings) in das Debug-Log geschrieben wird.

5418 

5223Pfade, die Claude Code auf diese Weise ablehnt, umfassen:5419Pfade, die Claude Code auf diese Weise ablehnt, umfassen:

5224 5420 

5225* UNC-Freigaben wie `\\server\share`5421* UNC-Freigaben wie `\\server\share`


5465 5661 

5466Vor v2.1.260 meldete Claude Code eine Regel mit nicht übereinstimmenden Klammern als `Mismatched parentheses`.5662Vor v2.1.260 meldete Claude Code eine Regel mit nicht übereinstimmenden Klammern als `Mismatched parentheses`.

5467 5663 

5468### Wird nicht durch Dateiberechtigungsprüfungen abgeglichen5664### Matches no tool · check for typos

5665 

5666Diese Zeile unterhalb des Startbanners benennt eine deny- oder ask-[Berechtigungsregel](/docs/de/permissions), deren Tool-Namen Claude Code nicht erkennt, sodass die Regel nicht für das gemeinte Tool gilt. Eine als `Bsh` geschriebene deny-Regel wird nicht auf Bash angewendet, und ebenso wenig eine, die die Bezeichnung verwendet, die ein Tool im Transkript anzeigt, statt seines kanonischen Namens. Die Zeile gibt die Regel so wieder, wie Sie sie geschrieben haben:

5667 

5668```text theme={null}

5669⚠ Deny rule Bsh matches no tool · check for typos

5670```

5469 5671 

5470Claude Code fand eine `Write`-, `NotebookEdit`-, `MultiEdit`- oder `Glob`-[Berechtigungsregel](/docs/de/permissions#read-and-edit) mit einem Pfad in einer Ihrer [Einstellungsdateien](/docs/de/settings#where-settings-live), in [verwalteten Einstellungen](/docs/de/managed-settings) oder in einem `--allowedTools`-, `--disallowedTools`- oder `--settings`-Flagwert. Es überprüft Dateiberechtigungen nur gegen `Edit`- und `Read`-Regeln, daher konsultiert es niemals eine Pfadregel, die einen der anderen Dateiwerkzeuge benennt. Es behält die Regel und ändert nichts anderes; die Warnung benennt die Regel, ihre Quelle in Klammern und den Ersatz zum Schreiben:5672Im [nicht interaktiven Modus](/docs/de/headless) mit Textausgabe gibt Claude Code die Warnung stattdessen in ihrer längeren Form auf stderr aus:

5471 5673 

5472```text theme={null}5674```text theme={null}

5473Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).5675Permission deny rule "Bsh" matches no known tool — check for typos.

5474```5676```

5475 5677 

5476**Was zu tun ist:**5678**Was zu tun ist:**

5477 5679 

5680* Korrigieren Sie den Tool-Namen in der Regel, z. B. `Bash` statt `Bsh`. Kanonische Namen finden Sie in der [Tool-Referenz](/docs/de/tools-reference).

5681* Um herauszufinden, wo die Regel definiert ist, führen Sie `/permissions` in der Sitzung aus und wählen Sie die Regel aus. Ihre Details geben an, woher sie stammt, z. B. `From project local settings` oder `From CLI argument` für einen `--disallowedTools`-Wert.

5682* Wenn die Details `From enterprise managed settings` lauten, leiten Sie die Zeile an denjenigen weiter, der Ihre [verwalteten Einstellungen](/docs/de/managed-settings) verwaltet, da Sie diese Regel nicht selbst ändern können.

5683 

5684In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Log. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen.

5685 

5686Vor v2.1.305 gab eine interaktive Sitzung beim Start die längere Form auf stderr aus, statt die Zeile anzuzeigen.

5687 

5688### Wird nicht durch Dateiberechtigungsprüfungen abgeglichen

5689 

5690Claude Code fand eine `Write`-, `NotebookEdit`-, `MultiEdit`- oder `Glob`-[Berechtigungsregel](/docs/de/permissions#read-and-edit) mit einem Pfad in einer Ihrer [Einstellungsdateien](/docs/de/settings#where-settings-live), in [verwalteten Einstellungen](/docs/de/managed-settings) oder in einem `--allowedTools`-, `--disallowedTools`- oder `--settings`-Flagwert. Es prüft Dateiberechtigungen nur anhand von `Edit`- und `Read`-Regeln, daher zieht es nie eine Pfadregel heran, die eines der anderen Datei-Tools benennt. Es behält die Regel bei und ändert nichts anderes.

5691 

5692* **Interaktive Sitzung**: Die vollständige Warnung wird in das [Debug-Log](#configuration-warnings) geschrieben, und eine deny- oder ask-Regel dieser Form erscheint zusätzlich als diese Zeile unterhalb des Startbanners:

5693 

5694 ```text theme={null}

5695 ⚠ Deny rule Write(docs/**) never matches · use Edit(docs/**)

5696 ```

5697 

5698 Eine allow-Regel dieser Form erhält keine Zeile. Um herauszufinden, wo die Regel definiert ist, führen Sie `/permissions` in der Sitzung aus und wählen Sie die Regel aus.

5699* **[Nicht interaktiver Modus](/docs/de/headless) mit Textausgabe**: Die vollständige Warnung auf stderr benennt die Regel, ihre Quelle in Klammern und den zu schreibenden Ersatz:

5700 

5701 ```text theme={null}

5702 Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).

5703 ```

5704* **[Hintergrundsitzung](/docs/de/agent-view) oder `--output-format json` bzw. `stream-json`**: Die vollständige Warnung wird statt auf stderr in das Debug-Log geschrieben, damit die maschinenlesbare Ausgabe sauber bleibt. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen.

5705 

5706**Was zu tun ist:**

5707 

5478* Ersetzen Sie `Write(path)`-, `NotebookEdit(path)`- und Legacy-`MultiEdit(path)`-Regeln durch `Edit(path)`. `Edit`-Regeln decken alle Dateieditierungswerkzeuge ab.5708* Ersetzen Sie `Write(path)`-, `NotebookEdit(path)`- und Legacy-`MultiEdit(path)`-Regeln durch `Edit(path)`. `Edit`-Regeln decken alle Dateieditierungswerkzeuge ab.

5479* Außer in `--allowedTools`, wo Claude Code eine `Glob`-Regel ohne Warnung akzeptiert, ersetzen Sie `Glob(path)`-Regeln durch `Read(path)`.5709* Außer in `--allowedTools`, wo Claude Code eine `Glob`-Regel ohne Warnung akzeptiert, ersetzen Sie `Glob(path)`-Regeln durch `Read(path)`.

5480* Beheben Sie die Regel an der Quelle, die die Warnung in Klammern benennt: ein Einstellungsdateipfad oder das Flag selbst für `--allowed-tools` und `--disallowed-tools`. Ein `claude-settings-<hash>.json`-Pfad, der nicht auf der Festplatte vorhanden ist, steht für einen Inline-`--settings`-Wert. Beheben Sie das JSON, das Sie an dieses Flag übergeben.5710* Korrigieren Sie die Regel an ihrer Quelle, die die vollständige Warnung in Klammern benennt: ein Einstellungsdateipfad oder das Flag selbst bei `--allowed-tools` und `--disallowed-tools`. Ein `claude-settings-<hash>.json`-Pfad, der auf der Festplatte nicht existiert, steht für einen Inline-`--settings`-Wert. Korrigieren Sie das JSON, das Sie an dieses Flag übergeben.

5481* Lassen Sie bloße Werkzeugnamen-Regeln wie `Write` oder `Glob` allein. Claude Code gleicht sie auf der [Werkzeugebene](/docs/de/permissions#match-all-uses-of-a-tool) ab und warnt nicht davor.5711* Lassen Sie bloße Werkzeugnamen-Regeln wie `Write` oder `Glob` allein. Claude Code gleicht sie auf der [Werkzeugebene](/docs/de/permissions#match-all-uses-of-a-tool) ab und warnt nicht davor.

5482* Wenn die Quelle `managed policy settings` liest, leiten Sie die Warnung an denjenigen weiter, der Ihre verwalteten Einstellungen verwaltet, da Sie sie nicht selbst löschen können.5712* Bei einer Regel aus verwalteten Einstellungen lauten die Klammern der vollständigen Warnung `managed policy settings`, und die Details der Regel in `/permissions` lauten `From enterprise managed settings`. Leiten Sie diese Warnung an denjenigen weiter, der Ihre verwalteten Einstellungen verwaltet, da Sie sie nicht selbst beheben können.

5483 5713 

5484In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Protokoll, damit die maschinenlesbare Ausgabe sauber bleibt. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.210 akzeptierte Claude Code diese Regeln ohne Warnung.5714Vor v2.1.210 akzeptierte Claude Code diese Regeln ohne Warnung. Vor v2.1.305 gab eine interaktive Sitzung die vollständige Warnung auf stderr aus.

5485 5715 

5486### Hat einen Platzhalter vor dem Rest des Befehls5716### Hat einen Platzhalter vor dem Rest des Befehls

5487 5717 

5488Claude Code fand eine `Bash`-Allow-Regel, deren `*` vor einem späteren Wort kommt, das bestimmt, welcher Befehl es ist, z. B. `Bash(git * main)` oder `Bash(git -C * status *)`, in einer Ihrer [Einstellungsdateien](/docs/de/settings#where-settings-live), in [verwalteten Einstellungen](/docs/de/managed-settings) oder in einem `--allowedTools`- oder `--settings`-Flagwert. Der `*` gleicht jeden Text ab, einschließlich Optionen, die an dieser Position eingefügt werden: `Bash(git * main)` genehmigt auch `git -c core.fsmonitor=<script> diff main`, wobei `-c` git veranlasst, ein Programm auszuführen, das der Befehl benennt. [Wildcard-Muster](/docs/de/permissions#wildcard-patterns) zeigt die Abgleichsregeln.5718Claude Code fand eine `Bash`-Allow-Regel, deren `*` vor einem späteren Wort kommt, das bestimmt, welcher Befehl es ist, z. B. `Bash(git * main)` oder `Bash(git -C * status *)`, in einer Ihrer [Einstellungsdateien](/docs/de/settings#where-settings-live), in [verwalteten Einstellungen](/docs/de/managed-settings) oder in einem `--allowedTools`- oder `--settings`-Flagwert. Der `*` gleicht jeden Text ab, einschließlich Optionen, die an dieser Position eingefügt werden: `Bash(git * main)` genehmigt auch `git -c core.fsmonitor=<script> diff main`, wobei `-c` git veranlasst, ein Programm auszuführen, das der Befehl benennt. [Wildcard-Muster](/docs/de/permissions#wildcard-patterns) zeigt die Abgleichsregeln.

5489 5719 

5490Die Warnung existiert, damit Sie eine Regel eingrenzen können, deren Platzhalter breiter ist als beabsichtigt. Claude Code behält die Regel und ändert nichts daran, wie sie abgleicht; die Warnung benennt die Regel und ihre Quelle in Klammern:5720Die Warnung existiert, damit Sie eine Regel eingrenzen können, deren Wildcard breiter ist als beabsichtigt. Claude Code behält die Regel bei und ändert nichts daran, wie sie abgleicht. Im [nicht interaktiven Modus](/docs/de/headless) mit Textausgabe benennt die Warnung auf stderr die Regel und ihre Quelle in Klammern:

5491 5721 

5492```text theme={null}5722```text theme={null}

5493Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).5723Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).

5494```5724```

5495 5725 

5726In einer interaktiven Sitzung wird die vollständige Warnung in das [Debug-Log](#configuration-warnings) geschrieben, und die Regel erscheint als diese Zeile unterhalb des Startbanners:

5727 

5728```text theme={null}

5729⚠ Allow rule Bash(git -C * status *) allows any option at its * · use an exact value

5730```

5731 

5732Um herauszufinden, wo die Regel definiert ist, führen Sie `/permissions` in der Sitzung aus und wählen Sie die Regel aus.

5733 

5496**Was zu tun ist:**5734**Was zu tun ist:**

5497 5735 

5498* Ersetzen Sie den `*` vor dem Unterbefehl durch den genauen Wert, den Sie meinen: `Bash(git checkout main)` statt `Bash(git * main)`.5736* Ersetzen Sie den `*` vor dem Unterbefehl durch den genauen Wert, den Sie meinen: `Bash(git checkout main)` statt `Bash(git * main)`.

5499* Verschieben Sie jeden `*` nach dem Unterbefehl: `Bash(git status *)` statt `Bash(git -C * status *)`. Schreiben Sie eine Regel pro Unterbefehl, den Sie zulassen möchten.5737* Verschieben Sie jeden `*` nach dem Unterbefehl: `Bash(git status *)` statt `Bash(git -C * status *)`. Schreiben Sie eine Regel pro Unterbefehl, den Sie zulassen möchten.

5500* Beheben Sie die Regel an der Quelle, die die Warnung in Klammern benennt: ein Einstellungsdateipfad oder das `--allowed-tools`-Flag selbst. Ein `claude-settings-<hash>.json`-Pfad, der nicht auf der Festplatte vorhanden ist, steht für einen Inline-`--settings`-Wert. Beheben Sie das JSON, das Sie an dieses Flag übergeben.5738* Korrigieren Sie die Regel an ihrer Quelle, die die vollständige Warnung in Klammern benennt: ein Einstellungsdateipfad oder das `--allowed-tools`-Flag selbst. Ein `claude-settings-<hash>.json`-Pfad, der auf der Festplatte nicht existiert, steht für einen Inline-`--settings`-Wert. Korrigieren Sie das JSON, das Sie an dieses Flag übergeben.

5501* Wenn die Quelle `managed policy settings` liest, leiten Sie die Warnung an denjenigen weiter, der Ihre verwalteten Einstellungen verwaltet, da Sie sie nicht selbst löschen können.5739* Bei einer Regel aus verwalteten Einstellungen lauten die Klammern der vollständigen Warnung `managed policy settings`, und die Details der Regel in `/permissions` lauten `From enterprise managed settings`. Leiten Sie diese Warnung an denjenigen weiter, der Ihre verwalteten Einstellungen verwaltet, da Sie sie nicht selbst beheben können.

5502 5740 

5503In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Protokoll, damit die maschinenlesbare Ausgabe sauber bleibt. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.246 akzeptierte Claude Code diese Regeln ohne Warnung.5741In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Protokoll, damit die maschinenlesbare Ausgabe sauber bleibt. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.246 akzeptierte Claude Code diese Regeln ohne Warnung.

5504 5742 

5743Vor v2.1.305 gab eine interaktive Sitzung die vollständige Warnung auf stderr aus, statt eine Zeile anzuzeigen.

5744 

5505### Denying Bash also turns off the PowerShell tool5745### Denying Bash also turns off the PowerShell tool

5506 5746 

5507Sie haben das gesamte Bash-Tool entfernt, z. B. mit `--disallowedTools Bash` oder mit einer bloßen `Bash`- oder `Bash(*)`-[deny-Regel](/docs/de/permissions#match-all-uses-of-a-tool) in einer Ihrer Einstellungsdateien. Unter Windows mit installiertem Git Bash [schaltet das Verweigern von Bash auch das PowerShell-Tool aus](/docs/de/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), sodass die Sitzung ohne Shell-Tool startet. Claude Code gibt beim Start diese Warnung aus:5747Sie haben das gesamte Bash-Tool entfernt, z. B. mit `--disallowedTools Bash` oder mit einer reinen `Bash`- oder `Bash(*)`-[deny-Regel](/docs/de/permissions#match-all-uses-of-a-tool) in einer Ihrer Einstellungsdateien. Unter Windows mit installiertem Git Bash [schaltet das Verweigern von Bash auch das PowerShell-Tool aus](/docs/de/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), sodass die Sitzung ohne Shell-Tool startet.

5748 

5749Im [nicht interaktiven Modus](/docs/de/headless) mit Textausgabe gibt Claude Code diese Warnung beim Start auf stderr aus, und eine interaktive Sitzung schreibt sie nur in das [Debug-Log](#configuration-warnings):

5508 5750 

5509```text theme={null}5751```text theme={null}

5510Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.5752Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.


5517 5759 

5518In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Log. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.287 schaltete Claude Code das PowerShell-Tool auf dieselbe Weise aus, ohne eine Warnung auszugeben.5760In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Log. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen. Vor v2.1.287 schaltete Claude Code das PowerShell-Tool auf dieselbe Weise aus, ohne eine Warnung auszugeben.

5519 5761 

5762Vor v2.1.305 gab auch eine interaktive Sitzung die Warnung beim Start auf stderr aus.

5763 

5520### crossSessionInbound muss eines von accept, hold, refuse sein5764### crossSessionInbound muss eines von accept, hold, refuse sein

5521 5765 

5522Eine Einstellungsdatei setzt [`crossSessionInbound`](/docs/de/settings-reference#crosssessioninbound) auf einen Wert, den Claude Code nicht erkennt, z. B. den Tippfehler `"reject"`. Der zweite Satz der Warnung hängt davon ab, welche Datei den Wert hält; in einer Benutzer-, Projekt-, lokalen oder `--settings`-Datei liest er:5766Eine Einstellungsdatei setzt [`crossSessionInbound`](/docs/de/settings-reference#crosssessioninbound) auf einen Wert, den Claude Code nicht erkennt, z. B. den Tippfehler `"reject"`. Der zweite Satz der Warnung hängt davon ab, welche Datei den Wert hält; in einer Benutzer-, Projekt-, lokalen oder `--settings`-Datei liest er:


5566* Wenn die Meldung eine Modell-ID benennt, die diese Version nicht erkennt, führen Sie `claude update` aus. Eine Version, die die ID als 1M-Kontext-Modell erkennt, erzwingt das Limit ohne weitere Konfiguration.5810* Wenn die Meldung eine Modell-ID benennt, die diese Version nicht erkennt, führen Sie `claude update` aus. Eine Version, die die ID als 1M-Kontext-Modell erkennt, erzwingt das Limit ohne weitere Konfiguration.

5567* Wenn Sie möchten, dass die Sitzung das vollständige Fenster des Modells verwendet, heben Sie `CLAUDE_CODE_DISABLE_1M_CONTEXT` auf; die Warnung meldet nur, dass das 200K-Limit nicht erzwungen wird5811* Wenn Sie möchten, dass die Sitzung das vollständige Fenster des Modells verwendet, heben Sie `CLAUDE_CODE_DISABLE_1M_CONTEXT` auf; die Warnung meldet nur, dass das 200K-Limit nicht erzwungen wird

5568 5812 

5569In einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` schreibt Claude Code die Warnung statt auf stderr in das Debug-Protokoll.5813Im [nicht interaktiven Modus](/docs/de/headless) mit Textausgabe erscheint diese Warnung auf stderr. In einer interaktiven Sitzung, einer [Hintergrundsitzung](/docs/de/agent-view) oder mit `--output-format json` oder `stream-json` wird sie stattdessen in das Debug-Log geschrieben. Führen Sie mit `--debug` aus, um sie unter `~/.claude/debug/<session-id>.txt` zu erfassen.

5814 

5815Vor v2.1.305 gab eine interaktive Sitzung die Warnung beim Start auf stderr aus.

5570 5816 

5571### Nicht erkannte Modell-ID bei einer Anfrage5817### Nicht erkannte Modell-ID bei einer Anfrage

5572 5818 


5678Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:5924Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:

5679 5925 

5680* Führen Sie `/feedback` in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Issue zu öffnen. Das Senden an Anthropic erfordert [Authentifizierung](/docs/de/authentication). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind, speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.5926* Führen Sie `/feedback` in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Issue zu öffnen. Das Senden an Anthropic erfordert [Authentifizierung](/docs/de/authentication). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind, speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.

5927* Wenn `/feedback` meldet, dass der Befehl durch die Richtlinie Ihrer Organisation deaktiviert ist, siehe [den Eintrag zu dieser Meldung](#feedback-is-disabled-by-your-organizations-policy)

5681* Führen Sie `claude doctor` aus Ihrer Shell aus, um eine schreibgeschützte Diagnose Ihrer Installation zu erhalten, oder führen Sie die `/doctor`-Überprüfung in Claude Code aus, um Setup-Probleme zu finden und zu beheben5928* Führen Sie `claude doctor` aus Ihrer Shell aus, um eine schreibgeschützte Diagnose Ihrer Installation zu erhalten, oder führen Sie die `/doctor`-Überprüfung in Claude Code aus, um Setup-Probleme zu finden und zu beheben

5682* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle5929* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle

5683* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub5930* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub

Details

34 34 

35Diese haben anbieter-spezifische Unterschiede:35Diese haben anbieter-spezifische Unterschiede:

36 36 

37* **MCP-Server**: [Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai) werden nur geladen, wenn Ihr claude.ai-Abonnement die aktive Authentifizierungsmethode ist. [Tool-Suche](/docs/de/mcp#configure-tool-search) ist standardmäßig deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist, und wird auf Google Cloud's Agent Platform-Modellen vor Claude Opus 4.5, Claude Sonnet 4.5 und Claude Haiku 4.5 oder auf Microsoft Foundry [Bereitstellungen, die auf Azure gehostet werden](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) nicht unterstützt37* **MCP-Server**: [Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai) werden nur geladen, wenn Ihr claude.ai-Abonnement die aktive Authentifizierungsmethode ist. [Tool-Suche](/docs/de/mcp#configure-tool-search) wird auf Microsoft Foundry [Bereitstellungen, die auf Azure gehostet werden](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) nicht unterstützt. Auf Google Cloud's Agent Platform wird die Tool-Suche auf Modellen vor Claude Opus 4.5, Claude Sonnet 4.5 und Claude Haiku 4.5 nicht unterstützt

38* **Subagents**: Wenn die Hauptkonversation Fable ausführt, läuft der integrierte [Explore Subagent](/docs/de/sub-agents#built-in-subagents) mit einem Claude-Abonnement, einem Anthropic Console-Konto oder einem über `ANTHROPIC_BASE_URL` erreichten [LLM-Gateway](/docs/de/llm-gateway) auf Opus. Bei anderen Anbietern, einschließlich Claude Platform on AWS, läuft er auf Fable38* **Subagents**: Wenn die Hauptkonversation Fable ausführt, läuft der integrierte [Explore Subagent](/docs/de/sub-agents#built-in-subagents) mit einem Claude-Abonnement, einem Anthropic Console-Konto oder einem über `ANTHROPIC_BASE_URL` erreichten [LLM-Gateway](/docs/de/llm-gateway) auf Opus. Bei anderen Anbietern, einschließlich Claude Platform on AWS, läuft er auf Fable

39* **[Commands](/docs/de/commands#all-commands)**:39* **[Commands](/docs/de/commands#all-commands)**:

40 * `/design-sync` und `/import` mit seiner `claude import` Subbefehlsform sind auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS nicht verfügbar, und über ein [Claude apps gateway](/docs/de/claude-apps-gateway#availability-and-limitations)40 * `/design-sync` und `/import` mit seiner `claude import` Subbefehlsform sind auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS nicht verfügbar, und über ein [Claude apps gateway](/docs/de/claude-apps-gateway#availability-and-limitations)


57* [Artifacts](/docs/de/artifacts): Pro-, Max-, Team- und Enterprise-Pläne57* [Artifacts](/docs/de/artifacts): Pro-, Max-, Team- und Enterprise-Pläne

58* [Voice dictation](/docs/de/voice-dictation)58* [Voice dictation](/docs/de/voice-dictation)

59 59 

60Desktop ist die teilweise Ausnahme: [Gateway-Routing kann in der App oder von einem Administrator konfiguriert werden](/docs/de/llm-gateway-connect#desktop-app), Enterprise-Bereitstellungen können Desktop über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) an Google Cloud's Agent Platform oder einen Gateway-Anbieter weiterleiten, und [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) führt die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus. Für die Verfügbarkeit dieser Funktionen pro Plan siehe [Verfügbarkeit nach Abonnementplan](#availability-by-subscription-plan).60Desktop ist die teilweise Ausnahme: [Gateway-Routing kann in der App oder von einem Administrator konfiguriert werden](/docs/de/llm-gateway-connect#desktop-app). [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) führt die Code-Registerkarte außerdem auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus. Ebenso führt es die Code-Registerkarte auf der [Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api) mit einem Anthropic Console API-Schlüssel aus. Für die Verfügbarkeit dieser Funktionen pro Plan siehe [Verfügbarkeit nach Abonnementplan](#availability-by-subscription-plan).

61 61 

62### CLI-Funktionen, die je nach Anbieter unterschiedlich sind62### CLI-Funktionen, die je nach Anbieter unterschiedlich sind

63 63 


287 287 

288Alles in [CLI-Funktionen, die je nach Anbieter unterschiedlich sind](#cli-capabilities-that-vary-by-provider) ist verfügbar, außer dass der [Fast-Modus](/docs/de/fast-mode) [bereitgestellten Zugriff](/docs/de/fast-mode#enable-fast-mode-for-your-organization) erfordert. [Serververwaltete Einstellungen](/docs/de/server-managed-settings), die Sie in einer claude.ai Team- oder Enterprise-Organisation konfigurieren, erreichen keine Sitzung, die sich mit einem Console-API-Schlüssel authentifiziert. Unter [Plattformverfügbarkeit](/docs/de/server-managed-settings#platform-availability) erfahren Sie, wie Sie diese Sitzungen abdecken.288Alles in [CLI-Funktionen, die je nach Anbieter unterschiedlich sind](#cli-capabilities-that-vary-by-provider) ist verfügbar, außer dass der [Fast-Modus](/docs/de/fast-mode) [bereitgestellten Zugriff](/docs/de/fast-mode#enable-fast-mode-for-your-organization) erfordert. [Serververwaltete Einstellungen](/docs/de/server-managed-settings), die Sie in einer claude.ai Team- oder Enterprise-Organisation konfigurieren, erreichen keine Sitzung, die sich mit einem Console-API-Schlüssel authentifiziert. Unter [Plattformverfügbarkeit](/docs/de/server-managed-settings#platform-availability) erfahren Sie, wie Sie diese Sitzungen abdecken.

289 289 

290**Teilweise Unterstützung:**

291 

292* [Desktop](/docs/de/desktop): über [Claude Desktop on 3P mit der Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api)

293 

290## Verfügbarkeit nach Abonnementplan294## Verfügbarkeit nach Abonnementplan

291 295 

292Wenn Sie sich über Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einen Anthropic Console API-Schlüssel authentifizieren, gilt dieser Abschnitt nicht für Sie. Wenn Sie sich mit einem claude.ai-Konto anmelden, bestimmt Ihr Plan, welche der folgenden Funktionen verfügbar sind.296Wenn Sie sich über Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einen Anthropic Console API-Schlüssel authentifizieren, gilt dieser Abschnitt nicht für Sie. Wenn Sie sich mit einem claude.ai-Konto anmelden, bestimmt Ihr Plan, welche der folgenden Funktionen verfügbar sind.

Details

148* **Subagents** sind Worker, die Claude spawnt, jeder gibt eine Zusammenfassung an das Gespräch zurück, das ihn spawnt148* **Subagents** sind Worker, die Claude spawnt, jeder gibt eine Zusammenfassung an das Gespräch zurück, das ihn spawnt

149* **[Dynamische Workflows](/docs/de/workflows)** sind Skripte, die Claude schreibt und die viele Subagents im Hintergrund ausführen und ein Ergebnis zurückgeben149* **[Dynamische Workflows](/docs/de/workflows)** sind Skripte, die Claude schreibt und die viele Subagents im Hintergrund ausführen und ein Ergebnis zurückgeben

150 150 

151**Verwenden Sie einen Subagent**, wenn Sie einen schnellen, fokussierten Worker benötigen: eine Frage recherchieren, einen Anspruch überprüfen, eine Datei überprüfen. Der Subagent führt die Arbeit aus und gibt eine Zusammenfassung zurück, sodass Ihr Hauptgespräch sauber bleibt. Subagents, die Claude benannt hat, als es sie spawnte, können auch [sich gegenseitig Nachrichten senden](/docs/de/sub-agents#what-loads-at-startup).151**Verwenden Sie einen Subagenten**, wenn Sie einen schnellen, fokussierten Worker benötigen: eine Frage recherchieren, eine Behauptung überprüfen, eine Datei überprüfen. Der Subagent führt die Arbeit aus und gibt eine Zusammenfassung zurück, sodass Ihre Hauptkonversation sauber bleibt. Subagenten, die Claude [benannt](/docs/de/sub-agents#subagent-names) hat, als es sie spawnte, können auch [sich gegenseitig Nachrichten senden](/docs/de/sub-agents#what-loads-at-startup).

152 152 

153**Verwenden Sie einen dynamischen Workflow**, wenn ein Job [über eine Handvoll Subagents hinauswächst](/docs/de/workflows#when-to-use-a-workflow), oder wenn Sie möchten, dass die Erkenntnisse überprüft werden, bevor Sie sie sehen, wie ein codebase-weites Audit, eine große Migration oder ein Plan, der aus mehreren Blickwinkeln entworfen wurde. Um einen zu starten, [fragen Sie in Ihrem Prompt nach einem Workflow](/docs/de/workflows#ask-for-a-workflow-in-your-prompt).153**Verwenden Sie einen dynamischen Workflow**, wenn ein Job [über eine Handvoll Subagents hinauswächst](/docs/de/workflows#when-to-use-a-workflow), oder wenn Sie möchten, dass die Erkenntnisse überprüft werden, bevor Sie sie sehen, wie ein codebase-weites Audit, eine große Migration oder ein Plan, der aus mehreren Blickwinkeln entworfen wurde. Um einen zu starten, [fragen Sie in Ihrem Prompt nach einem Workflow](/docs/de/workflows#ask-for-a-workflow-in-your-prompt).

154 154 

fullscreen.md +1 −0

Details

32* Ihr [Berechtigungsmodus](/docs/de/permission-modes) und [Aufwandsstufe](/docs/de/model-config#adjust-effort-level)32* Ihr [Berechtigungsmodus](/docs/de/permission-modes) und [Aufwandsstufe](/docs/de/model-config#adjust-effort-level)

33* Das Modell, das Sie zuletzt mit [`/model`](/docs/de/model-config#setting-your-model) ausgewählt haben33* Das Modell, das Sie zuletzt mit [`/model`](/docs/de/model-config#setting-your-model) ausgewählt haben

34* Regeln, die Sie mit [`--allowed-tools` oder `--disallowed-tools`](/docs/de/cli-reference#cli-flags) übergeben haben, und Ihre `--agent`, `--agents`, `--append-system-prompt` und `--system-prompt-snapshot` Flags34* Regeln, die Sie mit [`--allowed-tools` oder `--disallowed-tools`](/docs/de/cli-reference#cli-flags) übergeben haben, und Ihre `--agent`, `--agents`, `--append-system-prompt` und `--system-prompt-snapshot` Flags

35* Ein `--chrome`- oder `--no-chrome`-Flag, mit dem Sie gestartet haben, sodass die [Chrome-Integration](/docs/de/chrome) für diese Sitzung wie von Ihnen gewählt ein- oder ausgeschaltet bleibt

35 36 

36Claude Code lehnt einen Neustart ab, wenn die Sitzung eine Einschränkung hat, die es nicht an den neu gestarteten Prozess übergeben kann. Einschränkungen, die es nicht übergeben kann, sind:37Claude Code lehnt einen Neustart ab, wenn die Sitzung eine Einschränkung hat, die es nicht an den neu gestarteten Prozess übergeben kann. Einschränkungen, die es nicht übergeben kann, sind:

37 38 

hipaa-setup.md +1 −0

Details

93| :- | :- |93| :- | :- |

94| `api.anthropic.com` | Claude-API-Anfragen, Telemetrie und die Organisationsrichtlinie, die Claude Code mitteilt, dass die HIPAA-Konfiguration aktiv ist |94| `api.anthropic.com` | Claude-API-Anfragen, Telemetrie und die Organisationsrichtlinie, die Claude Code mitteilt, dass die HIPAA-Konfiguration aktiv ist |

95| `claude.ai`, `claude.com`, `platform.claude.com` | Anmeldung und Token-Aktualisierung |95| `claude.ai`, `claude.com`, `platform.claude.com` | Anmeldung und Token-Aktualisierung |

96| `sso.claude.com` | Anmeldung, wenn Ihre Organisation Single Sign-On verwendet |

96| `downloads.claude.ai` | Den nativen Installer und seine Updates |97| `downloads.claude.ai` | Den nativen Installer und seine Updates |

97| `mcp-proxy.anthropic.com` | [Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai) |98| `mcp-proxy.anthropic.com` | [Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai) |

98 99 

hooks.md +12 −6

Details

294| `SessionStart` | wie die Sitzung gestartet wurde | `startup`, `resume`, `clear`, `compact`, `fork` |294| `SessionStart` | wie die Sitzung gestartet wurde | `startup`, `resume`, `clear`, `compact`, `fork` |

295| `Setup` | welches CLI-Flag Setup ausgelöst hat | `init`, `maintenance` |295| `Setup` | welches CLI-Flag Setup ausgelöst hat | `init`, `maintenance` |

296| `SessionEnd` | warum die Sitzung endete | `clear`, `resume`, `logout`, `prompt_input_exit`, `other` |296| `SessionEnd` | warum die Sitzung endete | `clear`, `resume`, `logout`, `prompt_input_exit`, `other` |

297| `Notification` | Benachrichtigungstyp | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled` |297| `Notification` | Benachrichtigungstyp | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled`, `plugin_notification` |

298| `SubagentStart` | Agent-Typ | `general-purpose`, `Explore`, `Plan`, benutzerdefinierte Agent-Namen oder Plugin-bezogene Namen wie `^my-plugin:reviewer$` |298| `SubagentStart` | Agent-Typ | `general-purpose`, `Explore`, `Plan`, benutzerdefinierte Agent-Namen oder Plugin-bezogene Namen wie `^my-plugin:reviewer$` |

299| `PreCompact`, `PostCompact` | was Komprimierung ausgelöst hat | `manual`, `auto` |299| `PreCompact`, `PostCompact` | was Komprimierung ausgelöst hat | `manual`, `auto` |

300| `PreModelSwitch`, `PostModelSwitch` | kanonischer Name des Modells, zu dem die Sitzung wechselt, wie unter [PreModelSwitch](#premodelswitch) beschrieben | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |300| `PreModelSwitch`, `PostModelSwitch` | kanonischer Name des Modells, zu dem die Sitzung wechselt, wie unter [PreModelSwitch](#premodelswitch) beschrieben | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |


1923 1923 

1924| Feld | Beschreibung |1924| Feld | Beschreibung |

1925| :- | :- |1925| :- | :- |

1926| `permissionDecision` | `"allow"` überspringt die Berechtigungsabfrage, außer bei [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves), und bei [Lesezugriffen auf Netzwerkpfade](/docs/de/permissions#network-paths). `AskUserQuestion` und `ExitPlanMode` benötigen [`updatedInput` zusammen mit `"allow"`](#allow-with-updatedinput). Für den Plan-Modus siehe [Hook-Genehmigungen im Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode). `"deny"` verhindert den Tool-Aufruf. `"ask"` fordert den Benutzer zur Bestätigung auf. `"defer"` beendet sich ordnungsgemäß, sodass das Tool später fortgesetzt werden kann. [deny- und ask-Regeln](/docs/de/permissions#manage-permissions) werden unabhängig davon ausgewertet, was der Hook zurückgibt |1926| `permissionDecision` | `"allow"` überspringt die Berechtigungsabfrage, außer bei [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves), und bei [Lesevorgängen von Netzwerkpfaden](/docs/de/permissions#network-paths). `AskUserQuestion` und `ExitPlanMode` benötigen [`updatedInput` zusammen mit `"allow"`](#allow-with-updatedinput). Zum Plan-Modus siehe [Hook-Genehmigungen im Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode). `"deny"` verhindert den Tool-Aufruf. `"ask"` fordert den Benutzer zur Bestätigung auf. `"defer"` beendet den Turn, damit das Tool später fortgesetzt werden kann, und erfordert den [nicht interaktiven Modus](#defer-a-tool-call-for-later) mit dem Flag `-p`. [deny- und ask-Regeln](/docs/de/permissions#manage-permissions) werden unabhängig davon ausgewertet, was der Hook zurückgibt |

1927| `permissionDecisionReason` | Bei `"ask"` wird es dem Benutzer in der Berechtigungsabfrage angezeigt. Wenn Claude Code in einem `-p`-Lauf, in dem niemand die Abfrage beantworten kann, [den Aufruf ablehnt](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs), liest Claude den Grund stattdessen im Tool-Ergebnis. Bei `"deny"` wird es Claude angezeigt. Bei `"allow"` und `"defer"` wird es nur in das [Debug-Log](#debug-hooks) geschrieben |1927| `permissionDecisionReason` | Bei `"ask"` wird es dem Benutzer in der Berechtigungsabfrage angezeigt. Wenn Claude Code in einem `-p`-Lauf, in dem niemand die Abfrage beantworten kann, [den Aufruf ablehnt](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs), liest Claude den Grund stattdessen im Tool-Ergebnis. Bei `"deny"` wird es Claude angezeigt. Bei `"allow"` und `"defer"` wird es nur in das [Debug-Log](#debug-hooks) geschrieben |

1928| `updatedInput` | Ändert die Eingabeparameter des Tools vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, fügen Sie daher unveränderte Felder zusammen mit den geänderten ein. Claude Code wertet Berechtigungsregeln und die [Eignung eines Bash-Befehls für den automatischen Wechsel in den Hintergrund](/docs/de/tools-reference#foreground-commands-that-move-to-the-background) anhand der Eingabe aus, die Ihr Hook zurückgibt, nicht anhand der Eingabe, die Claude gesendet hat. Kombinieren Sie es mit `"allow"` für eine automatische Genehmigung oder mit `"ask"`, um dem Benutzer die geänderte Eingabe anzuzeigen. Bei `"defer"` wird es ignoriert |1928| `updatedInput` | Ändert die Eingabeparameter des Tools vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, fügen Sie daher unveränderte Felder zusammen mit den geänderten ein. Claude Code wertet Berechtigungsregeln und die [Eignung eines Bash-Befehls für den automatischen Wechsel in den Hintergrund](/docs/de/tools-reference#foreground-commands-that-move-to-the-background) anhand der Eingabe aus, die Ihr Hook zurückgibt, nicht anhand der Eingabe, die Claude gesendet hat. Kombinieren Sie es mit `"allow"` für eine automatische Genehmigung oder mit `"ask"`, um dem Benutzer die geänderte Eingabe anzuzeigen. Bei `"defer"` wird es ignoriert |

1929| `additionalContext` | String, der zusammen mit dem Tool-Ergebnis zum Kontext von Claude hinzugefügt wird. Wird ignoriert, wenn `permissionDecision` den Wert `"defer"` hat. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |1929| `additionalContext` | String, der zusammen mit dem Tool-Ergebnis zum Kontext von Claude hinzugefügt wird. Wird ignoriert, wenn `permissionDecision` den Wert `"defer"` hat. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |


1997Das Tool `AskUserQuestion` ist der typische Fall: Claude möchte dem Benutzer eine Frage stellen, aber es gibt kein Terminal, in dem geantwortet werden könnte. Ein `-p`-Lauf bietet `AskUserQuestion` nur an, wenn er einen [Berechtigungs-Host](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs) hat, etwa ein MCP-Tool, das Sie mit `--permission-prompt-tool` übergeben. Starten Sie den Lauf daher mit einem solchen. Der Ablauf funktioniert so:1997Das Tool `AskUserQuestion` ist der typische Fall: Claude möchte dem Benutzer eine Frage stellen, aber es gibt kein Terminal, in dem geantwortet werden könnte. Ein `-p`-Lauf bietet `AskUserQuestion` nur an, wenn er einen [Berechtigungs-Host](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs) hat, etwa ein MCP-Tool, das Sie mit `--permission-prompt-tool` übergeben. Starten Sie den Lauf daher mit einem solchen. Der Ablauf funktioniert so:

1998 1998 

19991. Claude ruft `AskUserQuestion` auf. Der `PreToolUse`-Hook wird ausgelöst.19991. Claude ruft `AskUserQuestion` auf. Der `PreToolUse`-Hook wird ausgelöst.

20002. Der Hook gibt `permissionDecision: "defer"` zurück. Das Tool wird nicht ausgeführt. Der Prozess beendet sich mit `stop_reason: "tool_deferred"`, und der ausstehende Tool-Aufruf bleibt im Transkript erhalten.20002. Der Hook gibt `permissionDecision: "defer"` zurück. Das Tool wird nicht ausgeführt. Der Turn endet mit einem Ergebnis, das `stop_reason: "tool_deferred"` enthält, und der ausstehende Tool-Aufruf bleibt im Transkript.

20013. Der aufrufende Prozess liest `deferred_tool_use` aus dem SDK-Ergebnis, zeigt die Frage in seiner eigenen Benutzeroberfläche an und wartet auf eine Antwort.20013. Der aufrufende Prozess liest `deferred_tool_use` aus dem SDK-Ergebnis, zeigt die Frage in seiner eigenen Benutzeroberfläche an und wartet auf eine Antwort.

20024. Der aufrufende Prozess führt `claude -p --resume <session-id>` mit demselben Berechtigungs-Host aus. Derselbe Tool-Aufruf löst `PreToolUse` erneut aus.20024. Der aufrufende Prozess führt `claude -p --resume <session-id>` mit demselben Berechtigungs-Host aus. Derselbe Tool-Aufruf löst `PreToolUse` erneut aus.

20035. Der Hook gibt `permissionDecision: "allow"` mit der Antwort in `updatedInput` zurück. Das Tool wird ausgeführt, und Claude fährt fort.20035. Der Hook gibt `permissionDecision: "allow"` mit der Antwort in `updatedInput` zurück. Das Tool wird ausgeführt, und Claude fährt fort.


2018}2018}

2019```2019```

2020 2020 

2021Es gibt weder einen Timeout noch ein Limit für Wiederholungsversuche. Die Sitzung bleibt auf der Festplatte, bis Sie sie fortsetzen, vorbehaltlich der Aufbewahrungsbereinigung durch [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays), die Sitzungsdateien standardmäßig nach 30 Tagen löscht, gemäß den [Regeln der Aufbewahrungsbereinigung](/docs/de/claude-directory#cleaned-up-automatically). Wenn die Antwort beim Fortsetzen noch nicht bereit ist, kann der Hook erneut `"defer"` zurückgeben, und der Prozess beendet sich auf dieselbe Weise. Der aufrufende Prozess bestimmt, wann die Schleife endet, indem er schließlich `"allow"` oder `"deny"` aus dem Hook zurückgibt.2021Es gibt keinen Timeout und keine Begrenzung für Wiederholungsversuche. Die Sitzung bleibt auf dem Datenträger, bis Sie sie fortsetzen, vorbehaltlich der Aufbewahrungsbereinigung über [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays), die Sitzungsdateien standardmäßig nach 30 Tagen löscht, gemäß den [Regeln der Aufbewahrungsbereinigung](/docs/de/claude-directory#cleaned-up-automatically).

2022 2022 

2023`"defer"` funktioniert nur, wenn Claude im Turn einen einzigen Tool-Aufruf ausführt. Wenn Claude mehrere Tool-Aufrufe gleichzeitig ausführt, wird `"defer"` mit einer Warnung ignoriert, und das Tool durchläuft den normalen Berechtigungsablauf. Diese Einschränkung besteht, weil beim Fortsetzen nur ein Tool erneut ausgeführt werden kann: Es gibt keine Möglichkeit, einen Aufruf aus einem Stapel zurückzustellen, ohne die anderen ungelöst zu lassen.2023Wenn das zurückgestellte Tool beim Fortsetzen nicht mehr verfügbar ist, hat das erste Ergebnis der Fortsetzung `stop_reason: "tool_deferred_unavailable"` und `is_error: true`, und der Hook wird nicht ausgelöst. Das passiert, wenn ein MCP-Server, der das Tool bereitgestellt hat, für die fortgesetzte Sitzung nicht verbunden ist. Die Payload `deferred_tool_use` ist trotzdem enthalten, damit Sie erkennen können, welches Tool fehlt.

2024 

2025* **Wenn Sie weder mit der Fortsetzung noch danach einen Prompt gesendet haben**, ist der Aufruf weiterhin ausstehend. Setzen Sie erneut fort, wenn das Tool verfügbar ist, und es wird zuerst ausgeführt.

2026* **Wenn Sie mit der Fortsetzung oder danach einen Prompt gesendet haben**, beantwortet Claude Code diesen ohne das Ergebnis des Tools und verwirft den zurückgestellten Aufruf. Senden Sie einen neuen Prompt, sobald das Tool verfügbar ist, falls es weiterhin aufgerufen werden soll.

2024 2027 

2025Wenn das zurückgestellte Tool beim Fortsetzen nicht mehr verfügbar ist, beendet sich der Prozess mit `stop_reason: "tool_deferred_unavailable"` und `is_error: true`, bevor der Hook ausgelöst wird. Das passiert, wenn ein MCP-Server, der das Tool bereitgestellt hat, für die fortgesetzte Sitzung nicht verbunden ist. Die `deferred_tool_use`-Payload ist dennoch enthalten, sodass Sie erkennen können, welches Tool fehlt.2028Wenn die Antwort, auf die Sie warten, beim Fortsetzen ohne Prompt noch nicht bereit ist, kann der Hook erneut `"defer"` zurückgeben. Wenn Sie einen Prompt gesendet haben und der Hook erneut zurückstellt, behandelt Claude Code den Prompt genauso: Es antwortet ohne das Ergebnis des Tools und verwirft den Aufruf. Setzen Sie ohne Prompt fort, bis der Hook `"allow"` oder `"deny"` zurückgibt; so durchbricht der aufrufende Prozess die Schleife.

2029 

2030`"defer"` funktioniert nur, wenn Claude im Turn einen einzigen Tool-Aufruf ausführt. Wenn Claude mehrere Tool-Aufrufe gleichzeitig ausführt, wird `"defer"` mit einer Warnung ignoriert, und das Tool durchläuft den normalen Berechtigungsablauf. Diese Einschränkung besteht, weil beim Fortsetzen nur ein Tool erneut ausgeführt werden kann: Es gibt keine Möglichkeit, einen Aufruf aus einem Stapel zurückzustellen, ohne die anderen ungelöst zu lassen.

2026 2031 

2027> [!NOTE]2032> [!NOTE]

2028>2033>


2424| `quota_auto_resume_fired` | Claude Code setzt Ihre Aufgabe fort, nachdem ein claude.ai-Nutzungslimit sie pausiert hatte: beim Zurücksetzen oder früher, wenn etwas, das Sie während der Wartezeit in Claude Code tun, etwa das Hinzufügen von Nutzungsguthaben, ein Upgrade Ihres Plans oder ein Modellwechsel, die Nutzung wieder verfügbar macht, mit der [Ausnahme für die Modelleinstellung](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) |2429| `quota_auto_resume_fired` | Claude Code setzt Ihre Aufgabe fort, nachdem ein claude.ai-Nutzungslimit sie pausiert hatte: beim Zurücksetzen oder früher, wenn etwas, das Sie während der Wartezeit in Claude Code tun, etwa das Hinzufügen von Nutzungsguthaben, ein Upgrade Ihres Plans oder ein Modellwechsel, die Nutzung wieder verfügbar macht, mit der [Ausnahme für die Modelleinstellung](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) |

2425| `quota_auto_resume_stale` | Ein claude.ai-Nutzungslimit wurde zurückgesetzt, während Ihr Computer länger als etwa 30 Minuten im Ruhezustand war. Claude Code wartet darauf, dass Sie `Enter` drücken, statt fortzufahren. Nach einem kürzeren Ruhezustand fährt es fort und löst stattdessen `quota_auto_resume_fired` aus |2430| `quota_auto_resume_stale` | Ein claude.ai-Nutzungslimit wurde zurückgesetzt, während Ihr Computer länger als etwa 30 Minuten im Ruhezustand war. Claude Code wartet darauf, dass Sie `Enter` drücken, statt fortzufahren. Nach einem kürzeren Ruhezustand fährt es fort und löst stattdessen `quota_auto_resume_fired` aus |

2426| `quota_auto_resume_disabled` | Claude Code beendet das Warten auf ein claude.ai-Nutzungslimit, ohne Ihre Aufgabe fortzusetzen: [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) wurde ausgeschaltet oder das Zurücksetzen hat sich während einer Wartezeit, die Claude Code selbst begonnen hat, um mehr als 24 Stunden verschoben, die fortgesetzte Aufgabe ist wiederholt an das Limit gestoßen, oder die Fortsetzung wurde blockiert, bevor sie das Modell erreichte. Wird nicht ausgelöst, wenn Sie `Esc` oder `Ctrl+C` drücken oder **Don't continue automatically** wählen |2431| `quota_auto_resume_disabled` | Claude Code beendet das Warten auf ein claude.ai-Nutzungslimit, ohne Ihre Aufgabe fortzusetzen: [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) wurde ausgeschaltet oder das Zurücksetzen hat sich während einer Wartezeit, die Claude Code selbst begonnen hat, um mehr als 24 Stunden verschoben, die fortgesetzte Aufgabe ist wiederholt an das Limit gestoßen, oder die Fortsetzung wurde blockiert, bevor sie das Modell erreichte. Wird nicht ausgelöst, wenn Sie `Esc` oder `Ctrl+C` drücken oder **Don't continue automatically** wählen |

2432| `plugin_notification` | Ein [Mod](/docs/de/plugins/mods/api#show-something-without-starting-a-turn) löst mit `$.ui.notify` eine Benachrichtigung aus. Der `title` des Hooks ist der Name des Mods, sofern der Mod keinen festgelegt hat |

2427 2433 

2428Die Typen `quota_auto_resume_fired`, `quota_auto_resume_stale` und `quota_auto_resume_disabled` erfordern Claude Code v2.1.234 oder höher.2434Die Typen `quota_auto_resume_fired`, `quota_auto_resume_stale` und `quota_auto_resume_disabled` erfordern Claude Code v2.1.234 oder höher.

2429 2435 

hooks-guide.md +3 −2

Details

193| `quota_auto_resume_fired` | Claude Code setzt Ihre Aufgabe fort, nachdem ein claude.ai-Nutzungslimit sie unterbrochen hat: beim Zurücksetzen oder früher, wenn etwas, das Sie in Claude Code während des Wartens tun, wie das Hinzufügen von Nutzungsguthaben, das Upgrade Ihres Plans oder das Wechseln von Modellen, die Nutzung wieder verfügbar macht, mit der [Modelleinstellungsausnahme](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) |193| `quota_auto_resume_fired` | Claude Code setzt Ihre Aufgabe fort, nachdem ein claude.ai-Nutzungslimit sie unterbrochen hat: beim Zurücksetzen oder früher, wenn etwas, das Sie in Claude Code während des Wartens tun, wie das Hinzufügen von Nutzungsguthaben, das Upgrade Ihres Plans oder das Wechseln von Modellen, die Nutzung wieder verfügbar macht, mit der [Modelleinstellungsausnahme](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) |

194| `quota_auto_resume_stale` | Ein claude.ai-Nutzungslimit wurde zurückgesetzt, während Ihr Computer länger als etwa 30 Minuten geschlafen hat. Claude Code wartet darauf, dass Sie `Enter` drücken, anstatt fortzufahren. Nach einem kürzeren Schlaf wird fortgesetzt und stattdessen `quota_auto_resume_fired` ausgelöst |194| `quota_auto_resume_stale` | Ein claude.ai-Nutzungslimit wurde zurückgesetzt, während Ihr Computer länger als etwa 30 Minuten geschlafen hat. Claude Code wartet darauf, dass Sie `Enter` drücken, anstatt fortzufahren. Nach einem kürzeren Schlaf wird fortgesetzt und stattdessen `quota_auto_resume_fired` ausgelöst |

195| `quota_auto_resume_disabled` | Claude Code beendet sein Warten auf ein claude.ai-Nutzungslimit, ohne Ihre Aufgabe fortzusetzen: [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) ist ausgeschaltet oder das Zurücksetzen hat sich während eines Wartens, das Claude Code selbst gestartet hat, um mehr als 24 Stunden verschoben, die fortgesetzte Aufgabe traf weiterhin das Limit, oder die Fortsetzung wurde blockiert, bevor sie das Modell erreichte. Wird nicht ausgelöst, wenn Sie `Esc` oder `Ctrl+C` drücken oder **Nicht automatisch fortfahren** wählen |195| `quota_auto_resume_disabled` | Claude Code beendet sein Warten auf ein claude.ai-Nutzungslimit, ohne Ihre Aufgabe fortzusetzen: [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) ist ausgeschaltet oder das Zurücksetzen hat sich während eines Wartens, das Claude Code selbst gestartet hat, um mehr als 24 Stunden verschoben, die fortgesetzte Aufgabe traf weiterhin das Limit, oder die Fortsetzung wurde blockiert, bevor sie das Modell erreichte. Wird nicht ausgelöst, wenn Sie `Esc` oder `Ctrl+C` drücken oder **Nicht automatisch fortfahren** wählen |

196| `plugin_notification` | Ein [Mod](/docs/de/plugins/mods/api#show-something-without-starting-a-turn) löst mit `$.ui.notify` eine Benachrichtigung aus. Der `title` des Hooks ist der Name des Mods, sofern der Mod keinen eigenen festgelegt hat |

196 197 

197Claude Code zeitlich `permission_prompt` unterschiedlich in einem Terminal und in Claude Desktop, der VS Code-Erweiterung und anderen Hosts, die Berechtigungsanfragen über das Agent SDK beantworten. Siehe [wann jeder Benachrichtigungstyp ausgelöst wird](/docs/de/hooks#notification) für beide Zeitpunkte.198Claude Code zeitlich `permission_prompt` unterschiedlich in einem Terminal und in Claude Desktop, der VS Code-Erweiterung und anderen Hosts, die Berechtigungsanfragen über das Agent SDK beantworten. Siehe [wann jeder Benachrichtigungstyp ausgelöst wird](/docs/de/hooks#notification) für beide Zeitpunkte.

198 199 


632 633 

633 Was `"allow"` im Plan-Modus bewirkt, erfahren Sie unter [Hook-Genehmigungen im Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode).634 Was `"allow"` im Plan-Modus bewirkt, erfahren Sie unter [Hook-Genehmigungen im Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode).

634 635 

635Ein vierter Wert, `"defer"`, ist im [nicht-interaktiven Modus](/docs/de/headless) mit dem Flag `-p` verfügbar. Er beendet den Prozess mit dem beibehaltenen Tool-Aufruf, sodass ein Agent SDK-Wrapper Eingaben sammeln und fortfahren kann. Siehe [Einen Tool-Aufruf für später aufschieben](/docs/de/hooks#defer-a-tool-call-for-later) in der Referenz.636Ein vierter Wert, `"defer"`, ist im [nicht interaktiven Modus](/docs/de/headless) mit dem Flag `-p` verfügbar. Wird er zurückgegeben, endet der Turn mit dem beibehaltenen Tool-Aufruf, sodass ein Agent SDK-Wrapper Eingaben sammeln und fortfahren kann. Siehe [Einen Tool-Aufruf für später aufschieben](/docs/de/hooks#defer-a-tool-call-for-later) in der Referenz.

636 637 

637Ein `PreModelSwitch`-Hook gibt das gleiche `permissionDecision`-Feld zurück: `"allow"` lässt einen Modellwechsel fortfahren, und `"deny"` bricht ihn ab. `"ask"` lässt Sie den Wechsel bestätigen, wenn Sie `/model` in einer interaktiven Sitzung ausführen; überall sonst behandelt Claude Code `"ask"` als Verweigerung. Siehe [PreModelSwitch-Entscheidungskontrolle](/docs/de/hooks#premodelswitch-decision-control).638Ein `PreModelSwitch`-Hook gibt das gleiche `permissionDecision`-Feld zurück: `"allow"` lässt einen Modellwechsel fortfahren, und `"deny"` bricht ihn ab. `"ask"` lässt Sie den Wechsel bestätigen, wenn Sie `/model` in einer interaktiven Sitzung ausführen; überall sonst behandelt Claude Code `"ask"` als Verweigerung. Siehe [PreModelSwitch-Entscheidungskontrolle](/docs/de/hooks#premodelswitch-decision-control).

638 639 


686| `SessionStart` | wie die Sitzung gestartet wurde | `startup`, `resume`, `clear`, `compact`, `fork` |687| `SessionStart` | wie die Sitzung gestartet wurde | `startup`, `resume`, `clear`, `compact`, `fork` |

687| `Setup` | welches CLI-Flag das Setup ausgelöst hat | `init`, `maintenance` |688| `Setup` | welches CLI-Flag das Setup ausgelöst hat | `init`, `maintenance` |

688| `SessionEnd` | warum die Sitzung endete | `clear`, `resume`, `logout`, `prompt_input_exit`, `other` |689| `SessionEnd` | warum die Sitzung endete | `clear`, `resume`, `logout`, `prompt_input_exit`, `other` |

689| `Notification` | Benachrichtigungstyp | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled` |690| `Notification` | Benachrichtigungstyp | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled`, `plugin_notification` |

690| `SubagentStart` | Agent-Typ | `general-purpose`, `Explore`, `Plan` oder benutzerdefinierte Agent-Namen |691| `SubagentStart` | Agent-Typ | `general-purpose`, `Explore`, `Plan` oder benutzerdefinierte Agent-Namen |

691| `PreCompact`, `PostCompact` | was die Komprimierung ausgelöst hat | `manual`, `auto` |692| `PreCompact`, `PostCompact` | was die Komprimierung ausgelöst hat | `manual`, `auto` |

692| `PreModelSwitch`, `PostModelSwitch` | kanonischer Name des Modells, zu dem die Sitzung wechselt, wie unter [PreModelSwitch](/docs/de/hooks#premodelswitch) beschrieben | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |693| `PreModelSwitch`, `PostModelSwitch` | kanonischer Name des Modells, zu dem die Sitzung wechselt, wie unter [PreModelSwitch](/docs/de/hooks#premodelswitch) beschrieben | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |

Details

18 18 

19| Kürzel | Beschreibung | Kontext |19| Kürzel | Beschreibung | Kontext |

20| :- | :- | :- |20| :- | :- | :- |

21| `Ctrl+C` | Unterbrechen oder Eingabe löschen | Unterbricht einen laufenden Vorgang. Wenn nichts läuft, löscht der erste Druck die Prompt-Eingabe und ein zweiter Druck beendet Claude Code. Drücken Sie `Up`, solange der Prompt noch leer ist, um den gelöschten Entwurf zurückzuholen; dies erfordert Claude Code v2.1.288 oder später |21| `Ctrl+C` | Unterbrechen oder Eingabe löschen | Unterbricht einen laufenden Vorgang. Wenn nichts läuft, löscht der erste Druck die Prompt-Eingabe und ein zweiter Druck beendet Claude Code. Wie Sie einen gelöschten Entwurf zurückholen, erfahren Sie unter [Gelöschten Entwurf zurückholen](#bring-back-a-cleared-draft) |

22| `Ctrl+X Ctrl+K` | Alle laufenden [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in dieser Sitzung stoppen und [automatische Artefakt-Antworten](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own) für den Rest deaktivieren. Zweimal innerhalb von 3 Sekunden drücken, um zu bestätigen. Sie können die Tastenkombination auch drücken, während die Berechtigungsabfrage eines Hintergrund-Subagenten geöffnet ist | Subagenten-Steuerung |22| `Ctrl+X Ctrl+K` | Alle laufenden [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in dieser Sitzung stoppen und [automatische Artefakt-Antworten](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own) für den Rest deaktivieren. Zweimal innerhalb von 3 Sekunden drücken, um zu bestätigen. Sie können die Tastenkombination auch drücken, während die Berechtigungsabfrage eines Hintergrund-Subagenten geöffnet ist | Subagenten-Steuerung |

23| `Ctrl+D` | Claude Code-Sitzung beenden | Der erste Druck zeigt einen Bestätigungshinweis und ein zweiter Druck innerhalb von 800 ms beendet die Sitzung. Wenn die Eingabeaufforderung Text enthält, löscht `Ctrl+D` das Zeichen nach dem Cursor |23| `Ctrl+D` | Claude Code-Sitzung beenden | Der erste Druck zeigt einen Bestätigungshinweis und ein zweiter Druck innerhalb von 800 ms beendet die Sitzung. Wenn die Eingabeaufforderung Text enthält, löscht `Ctrl+D` das Zeichen nach dem Cursor |

24| `Ctrl+G` oder `Ctrl+X Ctrl+E` | Im Standard-Texteditor öffnen | Bearbeiten Sie Ihre Eingabeaufforderung oder benutzerdefinierte Antwort in Ihrem Standard-Texteditor. `Ctrl+X Ctrl+E` ist die readline-native Bindung. Aktivieren Sie **Letzte Antwort im externen Editor anzeigen** in `/config`, um Claudes vorherige Antwort als `#`-kommentierter Kontext über Ihrer Eingabeaufforderung einzufügen; Claude Code entfernt den Kommentarblock, wenn Sie speichern |24| `Ctrl+G` oder `Ctrl+X Ctrl+E` | Im Standard-Texteditor öffnen | Bearbeiten Sie Ihre Eingabeaufforderung oder benutzerdefinierte Antwort in Ihrem Standard-Texteditor. `Ctrl+X Ctrl+E` ist die readline-native Bindung. Aktivieren Sie **Letzte Antwort im externen Editor anzeigen** in `/config`, um Claudes vorherige Antwort als `#`-kommentierter Kontext über Ihrer Eingabeaufforderung einzufügen; Claude Code entfernt den Kommentarblock, wenn Sie speichern |


262 262 

263Der blockweise visuelle Modus mit `Ctrl+V` wird nicht unterstützt.263Der blockweise visuelle Modus mit `Ctrl+V` wird nicht unterstützt.

264 264 

265### Eine Frage im Vim-Modus abbrechen

266 

267Wenn Sie in der Zeile `Other` einer [Frage, die Claude stellt](/docs/de/tools-reference#askuserquestion-tool-behavior), Ihre eigene Antwort eingeben, drücken Sie zweimal `Esc`, um die Frage abzubrechen.

268 

269Um stattdessen mit einem einzigen Tastendruck abzubrechen, [weisen Sie dem Abbrechen der Frage eine andere Taste zu](/docs/de/keybindings#cancel-a-question-with-one-key-press).

270 

265## Befehlsverlauf271## Befehlsverlauf

266 272 

267Claude Code speichert einen Verlauf der Eingabeaufforderungen, die Sie eingeben, und die Pfeiltaste-nach-oben-Funktion ruft Eingabeaufforderungen aus früheren Sitzungen desselben Projekts ab:273Claude Code speichert einen Verlauf der Eingabeaufforderungen, die Sie eingeben, und die Pfeiltaste-nach-oben-Funktion ruft Eingabeaufforderungen aus früheren Sitzungen desselben Projekts ab:


272* Wenn Sie eine Eingabeaufforderung abrufen, die eingefügten Text enthielt, sendet Claude Code den vollständigen eingefügten Inhalt erneut, wenn Sie sie erneut absenden. Wenn der Inhalt inzwischen [bereinigt](/docs/de/claude-directory#cleaned-up-automatically) wurde, sendet Claude Code nicht die wörtliche Zeichenkette `[Pasted text #N]`; siehe [Großen Inhalt einfügen](/docs/de/terminal-config#paste-large-content) für Details, was mit der Eingabeaufforderung geschieht278* Wenn Sie eine Eingabeaufforderung abrufen, die eingefügten Text enthielt, sendet Claude Code den vollständigen eingefügten Inhalt erneut, wenn Sie sie erneut absenden. Wenn der Inhalt inzwischen [bereinigt](/docs/de/claude-directory#cleaned-up-automatically) wurde, sendet Claude Code nicht die wörtliche Zeichenkette `[Pasted text #N]`; siehe [Großen Inhalt einfügen](/docs/de/terminal-config#paste-large-content) für Details, was mit der Eingabeaufforderung geschieht

273* Die Verlaufserweiterung mit `!` ist standardmäßig deaktiviert279* Die Verlaufserweiterung mit `!` ist standardmäßig deaktiviert

274 280 

281### Einen gelöschten Entwurf zurückholen

282 

283Um einen Entwurf zurückzuholen, den Sie mit `Strg+C` gelöscht haben, drücken Sie `Pfeiltaste nach oben`, entweder sofort oder nachdem Sie eine Nachricht oder einen Befehl gesendet haben:

284 

285* **Direkt nach dem Löschen des Entwurfs**: Drücken Sie einmal `Pfeiltaste nach oben`, solange das Eingabefeld noch leer ist. Erfordert Claude Code v2.1.288 oder höher.

286* **Nach dem Senden einer Nachricht oder eines Befehls**: Drücken Sie `Pfeiltaste nach oben`, um zum Entwurf zurückzugehen. Claude Code speichert die zehn zuletzt gelöschten Entwürfe der aktuellen Sitzung mitsamt ihrem eingefügten Text und ihren Bildern und verwirft sie, wenn Sie die Sitzung beenden. Erfordert Claude Code v2.1.292 oder höher.

287 

275### Rückwärtssuche mit Strg+R288### Rückwärtssuche mit Strg+R

276 289 

277Drücken Sie `Strg+R`, um interaktiv durch Ihren Befehlsverlauf zu suchen. Bei [Vollbilddarstellung](/docs/de/fullscreen) öffnet `Strg+R` stattdessen einen Suchdialog: Geben Sie Text ein, um zu filtern, drücken Sie `Pfeiltaste nach oben` und `Pfeiltaste nach unten`, um sich durch Treffer zu bewegen, und drücken Sie `Strg+S`, um den Bereich durch diese Sitzung, dieses Projekt und alle Projekte zu durchlaufen. Drücken Sie `Eingabe` oder `Tab`, um einen Treffer in die Eingabeaufforderung einzufügen, oder `Esc`, um abzubrechen. Die folgenden Schritte beschreiben die Inline-Suche des klassischen Renderers:290Drücken Sie `Strg+R`, um interaktiv durch Ihren Befehlsverlauf zu suchen. Bei [Vollbilddarstellung](/docs/de/fullscreen) öffnet `Strg+R` stattdessen einen Suchdialog: Geben Sie Text ein, um zu filtern, drücken Sie `Pfeiltaste nach oben` und `Pfeiltaste nach unten`, um sich durch Treffer zu bewegen, und drücken Sie `Strg+S`, um den Bereich durch diese Sitzung, dieses Projekt und alle Projekte zu durchlaufen. Drücken Sie `Eingabe` oder `Tab`, um einen Treffer in die Eingabeaufforderung einzufügen, oder `Esc`, um abzubrechen. Die folgenden Schritte beschreiben die Inline-Suche des klassischen Renderers:


386* [`/effort`](/docs/de/model-config#adjust-effort-level): Nachdem Sie die [Cache-Warnung](/docs/de/prompt-caching#changing-effort-level) bestätigt haben, falls Claude Code eine anzeigt, wendet Claude Code Ihre Änderung auf die nächste Anfrage an, die es in diesem Turn stellt399* [`/effort`](/docs/de/model-config#adjust-effort-level): Nachdem Sie die [Cache-Warnung](/docs/de/prompt-caching#changing-effort-level) bestätigt haben, falls Claude Code eine anzeigt, wendet Claude Code Ihre Änderung auf die nächste Anfrage an, die es in diesem Turn stellt

387* [`/fast`](/docs/de/fast-mode#toggle-fast-mode): Claude Code behält die Fast-Modus-Einstellung bei, die beim Start des Turns aktiv war, sodass Ihre Geschwindigkeitsänderung ab dem nächsten Turn gilt. Wenn Ihr aktuelles Modell den Fast-Modus nicht unterstützt, wird durch das Aktivieren auch [Ihr Modell gewechselt](/docs/de/prompt-caching#turning-on-fast-mode), und Claude Code verwendet das neue Modell ab seiner nächsten Anfrage in diesem Turn400* [`/fast`](/docs/de/fast-mode#toggle-fast-mode): Claude Code behält die Fast-Modus-Einstellung bei, die beim Start des Turns aktiv war, sodass Ihre Geschwindigkeitsänderung ab dem nächsten Turn gilt. Wenn Ihr aktuelles Modell den Fast-Modus nicht unterstützt, wird durch das Aktivieren auch [Ihr Modell gewechselt](/docs/de/prompt-caching#turning-on-fast-mode), und Claude Code verwendet das neue Modell ab seiner nächsten Anfrage in diesem Turn

388 401 

402### Eine Sitzung mit eingereihten Nachrichten in den Hintergrund verschieben

403 

404Wenn die Sitzung in den Hintergrund verschoben wird, nachdem Sie [`←` gedrückt haben](/docs/de/agent-view#switch-sessions-without-leaving-the-terminal), werden die Nachrichten, die Sie eingereiht hatten, mit ihr verschoben. Claude liest sie dort in der Reihenfolge, in der Sie sie gesendet haben.

405 

406Befehle und `!` Shell-Befehle können nicht verschoben werden, ebenso wenig wie einige Nachrichten, etwa eine mit angehängter [IDE-Auswahl](/docs/de/vs-code#the-built-in-ide-mcp-server). Wenn Sie `←` drücken, während einer dieser Einträge eingereiht ist, bleibt die Sitzung im Vordergrund und es erscheint ein Hinweis, der mit `Cannot open agents` beginnt. Um die Sitzung in den Hintergrund zu verschieben, entfernen Sie den Eintrag aus der Warteschlange und drücken Sie dann erneut `←`:

407 

408* **Befehle und `!` Shell-Befehle**: Warten Sie, bis sie am Ende des Turns ausgeführt werden, oder [nehmen Sie sie zurück](#take-back-what-you-queued) und leeren Sie das Eingabefeld. Solange etwas anderes eingereiht ist, können Sie `!` Shell-Befehle nicht zurücknehmen, warten Sie also, bis sie ausgeführt werden.

409* **Nachrichten, die nicht verschoben werden können**: Warten Sie, bis Claude sie gelesen hat

410 

389### Nehmen Sie das Eingereihte zurück411### Nehmen Sie das Eingereihte zurück

390 412 

391Drücken Sie `Up` von der ersten Zeile des Eingabefelds, um die eingereihten Nachrichten und Befehle zurückzunehmen. Claude Code entfernt sie aus der Warteschlange und fügt sie in das Eingabefeld ein, einen pro Zeile, vor jedem Text, den Sie eingegeben haben. Bearbeiten Sie den Text und drücken Sie `Enter`, um ihn erneut als einen Eintrag einzureihen, oder löschen Sie das Eingabefeld, um ihn zu verwerfen.413Drücken Sie `Up` von der ersten Zeile des Eingabefelds, um die eingereihten Nachrichten und Befehle zurückzunehmen. Claude Code entfernt sie aus der Warteschlange und fügt sie in das Eingabefeld ein, einen pro Zeile, vor jedem Text, den Sie eingegeben haben. Bearbeiten Sie den Text und drücken Sie `Enter`, um ihn erneut als einen Eintrag einzureihen, oder löschen Sie das Eingabefeld, um ihn zu verwerfen.

keybindings.md +23 −0

Details

446| :- | :- | :- |446| :- | :- | :- |

447| `settings:search` | / | Suchmodus aktivieren |447| `settings:search` | / | Suchmodus aktivieren |

448| `settings:retry` | R | Nutzungsdaten neu laden (bei Fehler) |448| `settings:retry` | R | Nutzungsdaten neu laden (bei Fehler) |

449| `settings:fixUsage` | F | Die [`/usage`-Empfehlungen](/docs/de/costs#apply-recommendations-with-the-fix-shortcut), die Claude Code anwenden kann, an Ihre Sitzung senden, wenn die `/usage`-Fußzeile eine Korrektur anbietet. Erfordert v2.1.305 oder später |

449| `select:accept` | Enter, Leertaste | Ändern Sie die ausgewählte Einstellung oder öffnen Sie das Untermenü |450| `select:accept` | Enter, Leertaste | Ändern Sie die ausgewählte Einstellung oder öffnen Sie das Untermenü |

450| `confirm:no` | Escape | Schließen Sie das Panel. Änderungen sind bereits gespeichert |451| `confirm:no` | Escape | Schließen Sie das Panel. Änderungen sind bereits gespeichert |

451 452 


688 689 

689In der Zeile `Other` einer Frage, die Claude stellt, bricht Escape die Frage im Vim-Modus nicht sofort ab. Außer im [Screenreader-Modus](/docs/de/accessibility) startet die Zeile jedes Mal im INSERT-Modus, wenn Sie sie fokussieren. Wenn Sie in der Zeile `Other` Escape drücken, wechselt die Zeile in den NORMAL-Modus oder verwirft einen halb eingegebenen Vim-Befehl, und die Frage bleibt geöffnet. Drücken Sie im NORMAL-Modus erneut Escape, um die Frage abzubrechen.690In der Zeile `Other` einer Frage, die Claude stellt, bricht Escape die Frage im Vim-Modus nicht sofort ab. Außer im [Screenreader-Modus](/docs/de/accessibility) startet die Zeile jedes Mal im INSERT-Modus, wenn Sie sie fokussieren. Wenn Sie in der Zeile `Other` Escape drücken, wechselt die Zeile in den NORMAL-Modus oder verwirft einen halb eingegebenen Vim-Befehl, und die Frage bleibt geöffnet. Drücken Sie im NORMAL-Modus erneut Escape, um die Frage abzubrechen.

690 691 

692### Eine Frage mit einem einzigen Tastendruck abbrechen

693 

694Um eine Frage im Vim-Modus mit einem einzigen Tastendruck abzubrechen, binden Sie eine andere Taste an `select:cancel` im Kontext `Select`. Auf diese Weise können Sie aus der Zeile `Other` einer Frage abbrechen, bei der Sie eine Option auswählen. Im [Screenreader-Modus](/docs/de/accessibility) oder bei einer Frage, bei der Sie mehrere Optionen auswählen können, bricht die gebundene Taste nicht ab; brechen Sie stattdessen mit Escape ab.

695 

696Wählen Sie eine Taste, die Sie mit Ctrl oder Alt drücken. Ein einzelner Buchstabe oder eine einzelne Ziffer [geht stattdessen in die Zeile `Other`](#text-fields) und erreicht Ihre Tastenkombinationen nicht. Um beispielsweise `Ctrl+Q` zu binden, fügen Sie Folgendes zu `~/.claude/keybindings.json` hinzu:

697 

698```json theme={null}

699{

700 "bindings": [

701 {

702 "context": "Select",

703 "bindings": {

704 "ctrl+q": "select:cancel"

705 }

706 }

707 ]

708}

709```

710 

711Nachdem Sie die Datei gespeichert haben, drücken Sie `Ctrl+Q` in der Zeile `Other` einer Frage, bei der Sie eine Option auswählen. Die Frage wird geschlossen, unabhängig davon, ob sich die Zeile im INSERT- oder NORMAL-Modus befindet.

712 

691## Validierung713## Validierung

692 714 

693Claude Code validiert Ihre Keybindings und schreibt eine Warnung in das Debug-Protokoll für:715Claude Code validiert Ihre Keybindings und schreibt eine Warnung in das Debug-Protokoll für:

694 716 

695* Parse-Fehler (ungültiges JSON oder Struktur)717* Parse-Fehler (ungültiges JSON oder Struktur)

696* Falsch geschriebene Modifizierer, wie `ctl+k`. Claude Code verwirft den Teil, den es nicht erkennt, und wendet die Bindung auf den verbleibenden Tastendruck an, `k` in diesem Beispiel.718* Falsch geschriebene Modifizierer, wie `ctl+k`. Claude Code verwirft den Teil, den es nicht erkennt, und wendet die Bindung auf den verbleibenden Tastendruck an, `k` in diesem Beispiel.

719* Ein Leerzeichen neben `+` in einer Tastenzeichenfolge, wie `ctrl+ k`. Claude Code liest die Zeichenfolge als [Akkord](#chords) aus `ctrl+` gefolgt von `k`. Kein Tastendruck entspricht `ctrl+` allein, daher wird die Bindung nie ausgelöst. Entfernen Sie das Leerzeichen.

697* Ungültige Kontextnamen720* Ungültige Kontextnamen

698* Ungültige Aktionswerte, wie eine Aktion, die keine Zeichenkette oder `null` ist721* Ungültige Aktionswerte, wie eine Aktion, die keine Zeichenkette oder `null` ist

699* Unbekannte Aktionsnamen, wie ein Tippfehler einer registrierten Aktion. Claude Code überspringt die Bindung und behält alle Standard-Bindungen für diese Taste bei.722* Unbekannte Aktionsnamen, wie ein Tippfehler einer registrierten Aktion. Claude Code überspringt die Bindung und behält alle Standard-Bindungen für diese Taste bei.

Details

93```markdown packages/api/CLAUDE.md theme={null}93```markdown packages/api/CLAUDE.md theme={null}

94Kopieren Sie `.env.example` zu `.env`, bevor Sie etwas ausführen. Tests und der Dev-Server schlagen ohne sie fehl.94Kopieren Sie `.env.example` zu `.env`, bevor Sie etwas ausführen. Tests und der Dev-Server schlagen ohne sie fehl.

95Schreiben Sie Datenbankabfragen mit dem Knex-Query-Builder. Setzen Sie niemals Raw-SQL-Strings in Route-Handler.95Schreiben Sie Datenbankabfragen mit dem Knex-Query-Builder. Setzen Sie niemals Raw-SQL-Strings in Route-Handler.

96Bearbeiten Sie eine Migration niemals, nachdem sie zusammengeführt wurde. Fügen Sie stattdessen eine neue Migration hinzu.96Bearbeiten Sie eine Migration niemals, nachdem sie gemergt wurde. Fügen Sie stattdessen eine neue Migration hinzu.

97```97```

98 98 

99Wenn Sie Claude von `packages/api/` starten, lädt es sowohl `packages/api/CLAUDE.md` als auch die Root `CLAUDE.md`. Claude sieht die lokalen Anweisungen neben den Repository-weiten Regeln, ohne Anweisungen von `packages/web/` im Kontext. Das Gleiche gilt für jedes Unterverzeichnis in einem Non-Monorepo-Baum. Um zu bestätigen, welche Dateien geladen wurden, führen Sie `/context` aus und überprüfen Sie die Liste unter **Memory-Dateien**.99Wenn Sie Claude von `packages/api/` starten, lädt es sowohl `packages/api/CLAUDE.md` als auch die Root `CLAUDE.md`. Claude sieht die lokalen Anweisungen neben den Repository-weiten Regeln, ohne Anweisungen von `packages/web/` im Kontext. Das Gleiche gilt für jedes Unterverzeichnis in einem Non-Monorepo-Baum. Um zu bestätigen, welche Dateien geladen wurden, führen Sie `/context` aus und überprüfen Sie die Liste unter **Memory-Dateien**.


141* `"**/packages/legacy-*/**"`: schließt jedes Paket aus, dessen Name dem Glob entspricht, einschließlich Regeln141* `"**/packages/legacy-*/**"`: schließt jedes Paket aus, dessen Name dem Glob entspricht, einschließlich Regeln

142* `"/home/user/monorepo/legacy/CLAUDE.md"`: schließt eine spezifische Datei nach absolutem Pfad aus142* `"/home/user/monorepo/legacy/CLAUDE.md"`: schließt eine spezifische Datei nach absolutem Pfad aus

143 143 

144Verwaltete Policy-CLAUDE.md-Dateien können nicht ausgeschlossen werden, daher gelten organisationsweite Anweisungen immer. Sie können `claudeMdExcludes` auf jedem [Einstellungsbereich](/docs/de/settings#where-settings-live) setzen: Benutzer, Projekt, lokal oder verwaltet. Arrays werden über Bereiche hinweg zusammengeführt, daher kann ein Team Projekt-Level-Standardwerte setzen, während Einzelne lokale Overrides hinzufügen.144Sie können `claudeMdExcludes` in jedem [Geltungsbereich für Einstellungen](/docs/de/settings#where-settings-live) festlegen: Benutzer, Projekt, lokal oder verwaltet. Arrays werden über Geltungsbereiche hinweg zusammengeführt, sodass ein Team Standardwerte auf Projektebene festlegen kann, während Einzelne lokale Überschreibungen hinzufügen. Wenn Ihre Organisation eine [verwaltete CLAUDE.md-Datei](/docs/de/memory#deploy-organization-wide-claude-md) bereitstellt, wird sie von einem passenden Muster nicht übersprungen, unabhängig davon, in welchem Geltungsbereich das Muster festgelegt ist.

145 145 

146Für die vollständige Ausschlussdokumentation siehe [Schließen Sie spezifische CLAUDE.md-Dateien aus](/docs/de/memory#exclude-specific-claude-md-files).146Für die vollständige Ausschlussdokumentation siehe [Schließen Sie spezifische CLAUDE.md-Dateien aus](/docs/de/memory#exclude-specific-claude-md-files).

147 147 


338## Test-Utilities338## Test-Utilities

339 339 

340- `src/__tests__/helpers/db.ts`: bietet `setupTestDb()` und `teardownTestDb()` für Datenbank-Tests340- `src/__tests__/helpers/db.ts`: bietet `setupTestDb()` und `teardownTestDb()` für Datenbank-Tests

341- `src/__tests__/helpers/auth.ts`: bietet `createTestUser()` und `getAuthToken()` für authentifizierte Endpoints341- `src/__tests__/helpers/auth.ts`: bietet `createTestUser()` und `getAuthToken()` für authentifizierte Endpunkte

342 342 

343## Muster343## Muster

344 344 

345- Verwenden Sie `supertest` für HTTP-Assertions, nicht Raw-Fetch345- Verwenden Sie `supertest` für HTTP-Assertions, nicht Raw-Fetch

346- Wickeln Sie Datenbank-Tests immer in eine Transaktion, die zurückrollt346- Wickeln Sie Datenbank-Tests immer in eine Transaktion, die zurückrollt

347- Mock externe Services in `src/__tests__/mocks/`347- Mocken Sie externe Services in `src/__tests__/mocks/`

348```348```

349 349 

350Ein anderes Unterverzeichnis hält auf die gleiche Weise andere Skills: `packages/web/.claude/skills/component-patterns/` beschreibt die Frontend-Komponentenkonventionen anstelle von Tests. Wenn Claude an einer Datei in `packages/api/` arbeitet, lädt es den api-testing-Skill. Wenn es in `packages/web/` arbeitet, lädt es stattdessen component-patterns. Die Skills keines Verzeichnisses werden während der Aufgaben des anderen geladen.350Ein anderes Unterverzeichnis hält auf die gleiche Weise andere Skills: `packages/web/.claude/skills/component-patterns/` beschreibt die Frontend-Komponentenkonventionen anstelle von Tests. Wenn Claude an einer Datei in `packages/api/` arbeitet, lädt es den api-testing-Skill. Wenn es in `packages/web/` arbeitet, lädt es stattdessen component-patterns. Die Skills keines Verzeichnisses werden während der Aufgaben des anderen geladen.

351 351 

352Sie können einen Skill auch nach Dateimuster anstelle von Platzierung scoped. Das [`paths`-Frontmatter-Feld](/docs/de/skills#frontmatter-reference) nimmt Glob-Muster, und Claude lädt den Skill automatisch nur, wenn er mit passenden Dateien arbeitet. Verwenden Sie dies für einen Skill, der im `.claude/skills/` des Repository-Roots lebt, aber nur auf bestimmte Dateien überall angewendet wird, wie einen Datenbankmigrations-Skill, der auf `**/migrations/**` beschränkt ist.352Sie können einen Skill auch nach Dateimuster statt nach Platzierung beschränken. Das [`paths`-Frontmatter-Feld](/docs/de/skills#frontmatter-reference) nimmt Glob-Muster, und Claude lädt den Skill automatisch nur, wenn er mit passenden Dateien arbeitet. Verwenden Sie dies für einen Skill, der im `.claude/skills/` des Repository-Roots lebt, aber nur für bestimmte Dateien gilt, wie einen Datenbankmigrations-Skill, der auf `**/migrations/**` beschränkt ist.

353 353 

354Weitere Informationen zum Erstellen und Organisieren von Skills finden Sie unter [Skills](/docs/de/skills).354Weitere Informationen zum Erstellen und Organisieren von Skills finden Sie unter [Skills](/docs/de/skills).

355 355 

Details

513| `Your apiKeyHelper script is failing`, oder `apiKeyHelper failed:` auf stderr im nicht-interaktiven Modus | Der Befehl in der [`apiKeyHelper`](/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](/docs/de/errors#your-apikeyhelper-script-is-failing) |513| `Your apiKeyHelper script is failing`, oder `apiKeyHelper failed:` auf stderr im nicht-interaktiven Modus | Der Befehl in der [`apiKeyHelper`](/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](/docs/de/errors#your-apikeyhelper-script-is-failing) |

514| `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](/docs/de/errors#automatic-retries). Der Code in Klammern variiert; [Unable to connect to API](/docs/de/errors#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 |514| `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](/docs/de/errors#automatic-retries). Der Code in Klammern variiert; [Unable to connect to API](/docs/de/errors#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 |

515| `API returned an empty or malformed response (HTTP 200)` | Das Gateway oder ein zwischengelagerter Proxy gab eine Nicht-API-Antwort zurück, oft eine HTML-Fehler oder Anmeldeseite | Testen Sie mit der [curl-Anfrage oben](#verify-the-connection); beheben Sie die Gateway-Route, die mit etwas anderem als einer Claude-API-Antwort antwortet. [Die Fehlerreferenz](/docs/de/errors#api-returned-an-empty-or-malformed-response) erklärt das Detail, das die Nachricht meldet |515| `API returned an empty or malformed response (HTTP 200)` | Das Gateway oder ein zwischengelagerter Proxy gab eine Nicht-API-Antwort zurück, oft eine HTML-Fehler oder Anmeldeseite | Testen Sie mit der [curl-Anfrage oben](#verify-the-connection); beheben Sie die Gateway-Route, die mit etwas anderem als einer Claude-API-Antwort antwortet. [Die Fehlerreferenz](/docs/de/errors#api-returned-an-empty-or-malformed-response) erklärt das Detail, das die Nachricht meldet |

516| `400`-Fehler, die `context_management`, `Extra inputs are not permitted` oder andere nicht erkannte Felder benennen | Das Gateway leitet Anfragen an einen Upstream weiter, der Felder ablehnt, die Claude Code an Anthropic-Format-Endpunkte sendet | Legen Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` fest, das die meisten Pre-Release-Felder unterdrückt; siehe [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through). Einige Betas werden nicht durch dieses Flag gated; für diese legen Sie die passende `CLAUDE_CODE_USE_*`-Anbieter-Variable fest, damit Claude Code nur das sendet, das dieser Anbieter akzeptiert |516| `400`-Fehler, die `context_management`, `Extra inputs are not permitted` oder andere nicht erkannte Felder benennen | Das Gateway leitet Anfragen an einen Upstream weiter, der Felder ablehnt, die Claude Code an Anthropic-Format-Endpunkte sendet | Legen Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` fest, das die meisten Pre-Release-Felder unterdrückt; siehe [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through). Einige Betas werden nicht durch dieses Flag gated; für diese legen Sie die passende `CLAUDE_CODE_USE_*`-Anbieter-Variable fest, damit Claude Code nur das sendet, das dieser Anbieter akzeptiert. Schritte, die davon abhängen, welches Feld die Nachricht benennt, finden Sie unter [Extra inputs are not permitted](/docs/de/errors#extra-inputs-are-not-permitted) |

517| `400`-Fehler, die `thinking` oder `adaptive` benennen, z. B. `Input tag 'adaptive' found` | Der Upstream-Modell-Build akzeptiert keine adaptive Überlegung, die Claude Code für Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 5.5, Claude Fable 5 und neuere Modelle anfordert | Aktualisieren Sie den Upstream des Gateways. Auf Opus 4.6 und Sonnet 4.6 funktioniert stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`. Die [Modellkonfiguration](/docs/de/model-config)-Fähigkeitsvariablen gelten nur für die Anbieter-Konfigurationen, z. B. `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX`, nicht hinter einem `ANTHROPIC_BASE_URL`-Gateway |517| `400`-Fehler, die `thinking` oder `adaptive` benennen, z. B. `Input tag 'adaptive' found` | Der Upstream-Modell-Build akzeptiert keine adaptive Überlegung, die Claude Code für Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 5.5, Claude Fable 5 und neuere Modelle anfordert | Aktualisieren Sie den Upstream des Gateways. Auf Opus 4.6 und Sonnet 4.6 funktioniert stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`. Die [Modellkonfiguration](/docs/de/model-config)-Fähigkeitsvariablen gelten nur für die Anbieter-Konfigurationen, z. B. `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX`, nicht hinter einem `ANTHROPIC_BASE_URL`-Gateway |

518| `400`-Fehler, die einen Kontext- oder Token-Limit in den eigenen Worten des Gateways angeben, z. B. `ContextWindowExceededError` oder `prompt token count of N exceeds the limit of M` | Das Gateway erzwingt ein kleineres Kontext als das native Fenster des Modells und schreibt den Upstream-Fehler um, daher erkennt Claude Code ihn nicht als [zu-langer Fehler](/docs/de/errors#prompt-is-too-long) und komprimiert und versucht nicht automatisch erneut | Führen Sie `/compact` aus, um die Sitzung wiederherzustellen. Um dies zu verhindern, legen Sie `CLAUDE_CODE_AUTO_COMPACT_WINDOW` auf das Limit des Gateways fest; Claude Code begrenzt den Wert auf mindestens 100.000 Token und höchstens das Kontext-Fenster des Modells, daher kann ein Gateway-Limit unter 100.000 nicht abgeglichen werden und `/compact` bleibt die Wiederherstellung dort. Legen Sie auch `CLAUDE_CODE_MAX_OUTPUT_TOKENS` unter das Output-Limit des Gateway-Modells fest |518| `400`-Fehler, die einen Kontext- oder Token-Limit in den eigenen Worten des Gateways angeben, z. B. `ContextWindowExceededError` oder `prompt token count of N exceeds the limit of M` | Das Gateway erzwingt ein kleineres Kontext als das native Fenster des Modells und schreibt den Upstream-Fehler um, daher erkennt Claude Code ihn nicht als [zu-langer Fehler](/docs/de/errors#prompt-is-too-long) und komprimiert und versucht nicht automatisch erneut | Führen Sie `/compact` aus, um die Sitzung wiederherzustellen. Um dies zu verhindern, legen Sie `CLAUDE_CODE_AUTO_COMPACT_WINDOW` auf das Limit des Gateways fest; Claude Code begrenzt den Wert auf mindestens 100.000 Token und höchstens das Kontext-Fenster des Modells, daher kann ein Gateway-Limit unter 100.000 nicht abgeglichen werden und `/compact` bleibt die Wiederherstellung dort. Legen Sie auch `CLAUDE_CODE_MAX_OUTPUT_TOKENS` unter das Output-Limit des Gateway-Modells fest |

519| `400`-Fehler bei jeder Anfrage, in den eigenen Worten des Gateways, die das Eingabe-Schema eines Tools oder sein `pattern` ablehnen, auf Claude Code v2.1.265 bis v2.1.267 | Bei einem schrittweisen Rollout auf diesen Versionen trägt das [Artifact-Tool](/docs/de/artifacts#availability)-Schema einen regulären Ausdruck mit `\p{...}` Unicode-Zeichenklassen. Die Anthropic-API akzeptiert ihn, aber ein Gateway oder Upstream, der jedes Tool-Schema `pattern` mit seiner eigenen Regex-Engine überprüft, lehnt die gesamte Anfrage ab | Aktualisieren Sie auf v2.1.268 oder später, das den regulären Ausdruck nicht sendet. Auf einer betroffenen Version [deaktivieren Sie Artifacts](/docs/de/artifacts#disable-artifacts), das das Tool und sein Schema aus Anfragen entfernt |519| `400`-Fehler bei jeder Anfrage, in den eigenen Worten des Gateways, die das Eingabe-Schema eines Tools oder sein `pattern` ablehnen, auf Claude Code v2.1.265 bis v2.1.267 | Bei einem schrittweisen Rollout auf diesen Versionen trägt das [Artifact-Tool](/docs/de/artifacts#availability)-Schema einen regulären Ausdruck mit `\p{...}` Unicode-Zeichenklassen. Die Anthropic-API akzeptiert ihn, aber ein Gateway oder Upstream, der jedes Tool-Schema `pattern` mit seiner eigenen Regex-Engine überprüft, lehnt die gesamte Anfrage ab | Aktualisieren Sie auf v2.1.268 oder später, das den regulären Ausdruck nicht sendet. Auf einer betroffenen Version [deaktivieren Sie Artifacts](/docs/de/artifacts#disable-artifacts), das das Tool und sein Schema aus Anfragen entfernt |

Details

100| :- | :- | :- | :- |100| :- | :- | :- | :- |

101| Modell-IDs in Anforderungen standardmäßig | Das Format des Anbieters, z. B. `us.anthropic.claude-opus-4-8` auf Amazon Bedrock | Anthropic-IDs, z. B. `claude-opus-4-8` | Anthropic-IDs |101| Modell-IDs in Anforderungen standardmäßig | Das Format des Anbieters, z. B. `us.anthropic.claude-opus-4-8` auf Amazon Bedrock | Anthropic-IDs, z. B. `claude-opus-4-8` | Anthropic-IDs |

102| Gesendete `anthropic-beta`-Werte | Die Teilmenge, die Amazon Bedrock und Agent Platform akzeptieren | Der vollständige Satz, der unter [Feature Pass-Through](#feature-pass-through) beschrieben ist, sofern der Entwickler nicht [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](#disable-pre-release-capabilities) setzt | Die Teilmenge, die Amazon Bedrock und Agent Platform akzeptieren |102| Gesendete `anthropic-beta`-Werte | Die Teilmenge, die Amazon Bedrock und Agent Platform akzeptieren | Der vollständige Satz, der unter [Feature Pass-Through](#feature-pass-through) beschrieben ist, sofern der Entwickler nicht [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](#disable-pre-release-capabilities) setzt | Die Teilmenge, die Amazon Bedrock und Agent Platform akzeptieren |

103| Anforderungsfelder für eine Modell-ID, die Claude Code nicht erkennt, z. B. ein Gateway-Alias | Thinking mit einem festen Budget statt adaptiver Argumentation und keine Aufwands- oder Kontextverwaltungsfelder | Alles, was aktuelle Claude-Modelle auf der Claude API akzeptieren, einschließlich adaptiver Argumentation, Aufwand und Kontextverwaltung, die ein Amazon Bedrock oder Agent Platform Upstream ablehnen kann | Gleich wie das Amazon Bedrock oder Agent Platform-Format |103| Anfragefelder für eine Modell-ID, die Claude Code nicht erkennt, z. B. ein Gateway-Alias | Thinking mit einem festen Budget statt adaptiver Argumentation und keine Aufwands- oder Kontextverwaltungsfelder. Claude Code sendet weiterhin [Systemnachrichten mitten in der Konversation](#feature-pass-through) | Alles, was aktuelle Claude-Modelle auf der Claude API akzeptieren, einschließlich adaptiver Argumentation, Aufwand und Kontextverwaltung, die ein Amazon Bedrock oder Agent Platform Upstream ablehnen kann | Gleich wie das Amazon Bedrock oder Agent Platform-Format |

104| Eine Stunde [Prompt Cache TTL](/docs/de/prompt-caching#choose-the-ttl-yourself), wenn ein Entwickler sie aktiviert | Angefordert über das Feld `ttl` in `cache_control`, ohne Beta-Wert | Angefordert über das Feld `ttl` plus einen `extended-cache-ttl`-Wert in `anthropic-beta`, den Sie weiterleiten müssen | Siehe die Tabelle [Verfügbarkeit und Einschränkungen](/docs/de/claude-apps-gateway#availability-and-limitations) des Claude Apps Gateway |104| Eine Stunde [Prompt Cache TTL](/docs/de/prompt-caching#choose-the-ttl-yourself), wenn ein Entwickler sie aktiviert | Angefordert über das Feld `ttl` in `cache_control`, ohne Beta-Wert | Angefordert über das Feld `ttl` plus einen `extended-cache-ttl`-Wert in `anthropic-beta`, den Sie weiterleiten müssen | Siehe die Tabelle [Verfügbarkeit und Einschränkungen](/docs/de/claude-apps-gateway#availability-and-limitations) des Claude Apps Gateway |

105| Modell für [Hintergrundaufgaben](/docs/de/costs#background-token-usage), sofern `ANTHROPIC_DEFAULT_HAIKU_MODEL` keinen festlegt | Das Standard-Sonnet-Modell oder das Hauptmodell, sobald eines ausgewählt ist, wie die Seiten [Amazon Bedrock](/docs/de/amazon-bedrock#4-pin-model-versions) und [Agent Platform](/docs/de/google-vertex-ai#5-pin-model-versions) beschreiben | Das Hauptmodell oder das Standard-Haiku-Modell, wenn `ANTHROPIC_API_KEY` oder `apiKeyHelper` einen Anthropic Console-Schlüssel bereitstellt und `ANTHROPIC_AUTH_TOKEN` nicht gesetzt ist | Das Hauptmodell |105| Modell für [Hintergrundaufgaben](/docs/de/costs#background-token-usage), sofern `ANTHROPIC_DEFAULT_HAIKU_MODEL` keinen festlegt | Das Standard-Sonnet-Modell oder das Hauptmodell, sobald eines ausgewählt ist, wie die Seiten [Amazon Bedrock](/docs/de/amazon-bedrock#4-pin-model-versions) und [Agent Platform](/docs/de/google-vertex-ai#5-pin-model-versions) beschreiben | Das Hauptmodell oder das Standard-Haiku-Modell, wenn `ANTHROPIC_API_KEY` oder `apiKeyHelper` einen Anthropic Console-Schlüssel bereitstellt und `ANTHROPIC_AUTH_TOKEN` nicht gesetzt ist | Das Hauptmodell |

106 106 


207 207 

208Claude Code behandelt ein `ANTHROPIC_BASE_URL` Gateway als einen Anthropic-Format-Endpunkt und sendet ihm die Beta-Header und Request-Body-Felder, die es an `api.anthropic.com` sendet, außer einer kleinen Menge von Diagnosen und Standardwerten, die für direkte Verbindungen reserviert sind, wie z. B. der unten behandelte Fine-Grained-Tool-Streaming-Standard. Diese Menge variiert je nach Version, daher verlassen Sie sich nicht auf ihren Inhalt.208Claude Code behandelt ein `ANTHROPIC_BASE_URL` Gateway als einen Anthropic-Format-Endpunkt und sendet ihm die Beta-Header und Request-Body-Felder, die es an `api.anthropic.com` sendet, außer einer kleinen Menge von Diagnosen und Standardwerten, die für direkte Verbindungen reserviert sind, wie z. B. der unten behandelte Fine-Grained-Tool-Streaming-Standard. Diese Menge variiert je nach Version, daher verlassen Sie sich nicht auf ihren Inhalt.

209 209 

210Funktionen, die Body-Felder hinzufügen, paaren sie mit einem Beta-Header, und das Paar reist zusammen. Ein Gateway, das den Header löscht, während es den Body durchleitet, oder ein Anthropic-Format-Body an ein Upstream mit einem anderen Schema weiterleitet, erzeugt harte `400` Fehler; nur wenn beide Hälften zusammen fehlen, schaltet sich die Funktion stillschweigend aus. Ein Gateway, das Request-Bodies zur Inhaltsüberprüfung umschreibt oder redigiert, bricht die Paarung auf die gleiche Weise wie das Löschen, daher überprüfen Sie ohne Änderung. Die Tabelle vermerkt, wo eine Funktion von der Paarung abweicht.

211 

212Fine-Grained Tool Streaming ist einer der Direct-Connection-Standardwerte: Es ist standardmäßig aus, wenn Anfragen durch eine benutzerdefinierte Basis-URL geleitet werden, und ein Gateway empfängt es, wenn Entwickler [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/de/env-vars) setzen.210Fine-Grained Tool Streaming ist einer der Direct-Connection-Standardwerte: Es ist standardmäßig aus, wenn Anfragen durch eine benutzerdefinierte Basis-URL geleitet werden, und ein Gateway empfängt es, wenn Entwickler [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/de/env-vars) setzen.

213 211 

212### Paare aus Beta-Header und Body-Feld

213 

214Funktionen, die Body-Felder hinzufügen, paaren sie mit einem Beta-Header, und das Paar wird gemeinsam übertragen. Ein Gateway, das den Header entfernt, während es den Body durchleitet, oder einen Anthropic-Format-Body an ein Upstream mit einem anderen Schema weiterleitet, erzeugt `400`-Fehler. Wenn beide Hälften zusammen fehlen, schaltet sich die Funktion stillschweigend aus.

215 

216Ein Gateway, das Request-Bodies zur Inhaltsüberprüfung umschreibt oder redigiert, bricht die Paarung auf die gleiche Weise wie das Entfernen, daher überprüfen Sie ohne Änderung. Die Tabelle vermerkt, wo eine Funktion von der Paarung abweicht.

217 

214| Funktion | Header und Body-Paar | Symptom bei Fehler | Abhilfe |218| Funktion | Header und Body-Paar | Symptom bei Fehler | Abhilfe |

215| :- | :- | :- | :- |219| :- | :- | :- | :- |

216| [Adaptive Reasoning](/docs/de/model-config#adjust-effort-level) | Kein Beta-Header. Claude Code sendet `thinking: {"type": "adaptive"}` für Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 5.5, Claude Fable 5 und spätere Modelle und behandelt Modellnamen, die es nicht erkennt, wie Gateway-Aliase, als aktuelle Modelle, die das Feld erhalten | `400` mit Nennung des `thinking` Feldes oder des `adaptive` Tags, wenn der Upstream-Modell-Build es nicht akzeptiert | Aktualisieren Sie das Upstream. Auf Opus 4.6 und Sonnet 4.6 können Entwickler stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen |220| [Adaptive Reasoning](/docs/de/model-config#adjust-effort-level) | Kein Beta-Header. Claude Code sendet `thinking: {"type": "adaptive"}` für Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 5.5, Claude Fable 5 und spätere Modelle und behandelt Modellnamen, die es nicht erkennt, wie Gateway-Aliase, als aktuelle Modelle, die das Feld erhalten | `400` mit Nennung des `thinking` Feldes oder des `adaptive` Tags, wenn der Upstream-Modell-Build es nicht akzeptiert | Aktualisieren Sie das Upstream. Auf Opus 4.6 und Sonnet 4.6 können Entwickler stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen |

217| [Kontextverwaltung](https://platform.claude.com/docs/de/build-with-claude/context-editing) | Kontextverwaltungs-Beta-Header paart sich mit dem `context_management` Body-Feld | `400` mit `Extra inputs are not permitted`. Häufig, wenn ein Gateway Anthropic-Format-Anfragen akzeptiert, aber an Amazon Bedrock weiterleitet | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |221| [Kontextverwaltung](https://platform.claude.com/docs/de/build-with-claude/context-editing) | Kontextverwaltungs-Beta-Header paart sich mit dem `context_management` Body-Feld | `400` mit `Extra inputs are not permitted`. Häufig, wenn ein Gateway Anthropic-Format-Anfragen akzeptiert, aber an Amazon Bedrock weiterleitet. Ab v2.1.304 [versucht Claude Code die Anfrage selbstständig ohne das Paar erneut](#automatic-retry-and-error-forwarding) | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

218| [Erweiterter Kontext](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) und [verschachteltes Denken](https://platform.claude.com/docs/de/build-with-claude/extended-thinking#interleaved-thinking) | Nur Beta-Header, kein Body-Feld | Stillschweigend nicht verfügbar, wenn der Header gelöscht wird; das Upstream sieht die Funktionsanfrage nie | Leiten Sie `anthropic-beta` wörtlich weiter |222| [Erweiterter Kontext](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) und [verschachteltes Denken](https://platform.claude.com/docs/de/build-with-claude/extended-thinking#interleaved-thinking) | Nur Beta-Header, kein Body-Feld | Stillschweigend nicht verfügbar, wenn der Header gelöscht wird; das Upstream sieht die Funktionsanfrage nie | Leiten Sie `anthropic-beta` wörtlich weiter |

219| Beta [Tool-Felder](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Tool-bezogene Beta-Header paaren sich mit Tool-Schema-Feldern wie `strict` und `defer_loading` | `400` mit Nennung des nicht erkannten Tool-Schema-Feldes, wenn der Body ohne seinen Header durchgeht | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |223| Beta [Tool-Felder](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Tool-bezogene Beta-Header paaren sich mit Tool-Schema-Feldern wie `strict` und `defer_loading` | `400` mit Nennung des nicht erkannten Tool-Schema-Feldes, wenn der Body ohne seinen Header durchgeht. Zu `defer_loading` siehe [Wiederholungsversuch ohne Tool Search](#retry-without-tool-search) | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

220| [Aufwand](https://platform.claude.com/docs/de/build-with-claude/effort) und [strukturierte Ausgaben](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) | Das `output_config` Body-Feld trägt Aufwand, strukturierte Ausgabeformat und Task-Budget-Einstellungen; jedes paart sich mit seinem eigenen Beta-Header | `400` mit Nennung von `output_config`, oft `Extra inputs are not permitted`, auf Amazon Bedrock und Google Cloud Agent Platform Upstreams | Leiten Sie das Feld und seine Header zusammen weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, wodurch die Format- und Task-Budget-Einstellungen entfernt werden, nicht aber der Aufwand. Um nur das Format zu entfernen, können sie stattdessen [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](/docs/de/env-vars) setzen, was v2.1.288 oder später erfordert |224| [Aufwand](https://platform.claude.com/docs/de/build-with-claude/effort) und [strukturierte Ausgaben](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) | Das `output_config` Body-Feld trägt Aufwand, strukturierte Ausgabeformat und Task-Budget-Einstellungen; jedes paart sich mit seinem eigenen Beta-Header | `400` mit Nennung von `output_config`, oft `Extra inputs are not permitted`, auf Amazon Bedrock und Google Cloud Agent Platform Upstreams | Leiten Sie das Feld und seine Header zusammen weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, wodurch die Format- und Task-Budget-Einstellungen entfernt werden, nicht aber der Aufwand. Um nur das Format zu entfernen, können sie stattdessen [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](/docs/de/env-vars) setzen, was v2.1.288 oder später erfordert |

225| Systemnachrichten mitten in der Konversation | Kein Beta-Header. Claude Code sendet einige Erinnerungs- und Anhangstexte als `role: "system"`-Einträge in `messages` für Claude Opus 4.8, danach veröffentlichte Modelle und nicht erkannte Modell-IDs | `400` wie z. B. `Unexpected role "system"` | Claude Code [versucht die Anfrage ohne Systemnachrichten erneut](#automatic-retry-and-error-forwarding). Um Systemnachrichten für einen Alias eines vor Claude Opus 4.8 veröffentlichten Modells zu unterbinden, fügen Sie den von Ihnen verteilten Einstellungen einen [`modelOverrides`-Eintrag](#settings-for-unrecognized-model-ids) hinzu |

226| [Pro Turn festgelegter Aufwand](/docs/de/prompt-caching#changing-effort-level) | Bei Opus 5.5, Sonnet 5.5, Haiku 5.5 und Fable 5.1 paart sich ein Beta-Header mit `output_config.effort` auf `role: "system"`-Einträgen, entweder einer Systemnachricht oder einem Eintrag mit leerem Inhalt | `400` mit `messages.N: system content must contain at least one block`, wenn Ihr Gateway das Feld aus einem leeren Eintrag entfernt | Leiten Sie beide weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, um das Feld und die leeren Einträge zu unterbinden |

221| [Prompt Caching](/docs/de/prompt-caching) | Keine Beta-Paarung. Claude Code fügt `cache_control` Marker an `system` Blöcke und an `messages` Einträge an, einschließlich `role: "system"` Einträge, die mitten in der Konversation angehängt werden | Kein Fehler: das Gespräch wird bei jedem Turn als nicht gecachter Input abgerechnet, sichtbar als hohe `input_tokens` mit wenig oder keiner Cache-Aktivität in `usage` | Leiten Sie `cache_control` unverändert weiter, wo immer es erscheint, und konvertieren Sie nicht Block-Form `system` oder Message-Inhalte in einfache Strings |227| [Prompt Caching](/docs/de/prompt-caching) | Keine Beta-Paarung. Claude Code fügt `cache_control` Marker an `system` Blöcke und an `messages` Einträge an, einschließlich `role: "system"` Einträge, die mitten in der Konversation angehängt werden | Kein Fehler: das Gespräch wird bei jedem Turn als nicht gecachter Input abgerechnet, sichtbar als hohe `input_tokens` mit wenig oder keiner Cache-Aktivität in `usage` | Leiten Sie `cache_control` unverändert weiter, wo immer es erscheint, und konvertieren Sie nicht Block-Form `system` oder Message-Inhalte in einfache Strings |

222| [Token Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Keine Beta-Paarung; verwendet den `count_tokens` Endpunkt | Kein Fehler: Claude Code fällt auf eine zeichenbasierte Schätzung zurück, daher zeigt `/context` ungefähre Zählungen | Stellen Sie den Endpunkt für genaue Token-Zählungen bereit |228| [Token Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Keine Beta-Paarung; verwendet den `count_tokens` Endpunkt | Kein Fehler: Claude Code fällt auf eine zeichenbasierte Schätzung zurück, daher zeigt `/context` ungefähre Zählungen | Stellen Sie den Endpunkt für genaue Token-Zählungen bereit |

223 229 


225 231 

226### Automatische Wiederholung und Fehlerweiterleitung232### Automatische Wiederholung und Fehlerweiterleitung

227 233 

228Was Claude Code nach einer Upstream-Ablehnung tut, hängt davon ab, was abgelehnt wurde:234Wenn das Upstream eine dieser Funktionen ablehnt, kann Claude Code die Anfrage selbstständig erneut versuchen, wobei der abgelehnte Teil entfernt oder geändert wird:

229 235 

230* Wenn das Upstream das `thinking` Feld, eine Mid-Conversation-Systemnachricht oder den `cache_control` Marker auf einer solchen Nachricht ablehnt, versucht Claude Code die Anfrage erneut und deaktiviert die abgelehnte Funktion für den Rest des Gesprächs236* Wenn ein `400` besagt, dass der `thinking.type`-Wert `enabled` oder `adaptive` nicht unterstützt wird, versucht Claude Code die Anfrage einmal mit dem jeweils anderen Typ erneut und behält das `thinking`-Feld bei. Spätere Anfragen an dieses Modell verwenden den gewechselten Typ weiter, bis Claude Code beendet wird. Vor v2.1.121 versuchte Claude Code die Anfrage nicht erneut, sodass [`thinking.type.enabled is not supported`](/docs/de/errors#thinking-type-enabled-is-not-supported-for-this-model) den Entwickler erreichte

237* Wenn das Upstream einen `role: "system"`-Eintrag innerhalb von `messages` ablehnt, versucht Claude Code die Anfrage einmal ohne diese Systemnachrichten mitten in der Konversation erneut und überträgt deren Text stattdessen in Benutzernachrichten. Spätere Anfragen in der Konversation behalten diese Form bei, bis der Entwickler `/clear` ausführt oder die Konversation komprimiert wird

238* Wenn das Upstream nur den `cache_control`-Marker auf einer Systemnachricht mitten in der Konversation ablehnt, behält Claude Code die Systemnachrichten bei und versucht die Anfrage einmal mit verschobenem Marker erneut. Der Marker wird auf den letzten Eintrag in `messages` gesetzt, der keine Systemnachricht ist, sowohl bei diesem Wiederholungsversuch als auch bei späteren Anfragen, bis Claude Code beendet wird

231* Wenn das Upstream eine [Thinking-Signatur](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) ablehnt, einschließlich mit einem `400` dessen Nachricht besagt, dass der Block `bound to a different conversation` ist, entfernt Claude Code frühere Thinking-Blöcke aus der Anfrage, versucht erneut und hält sie aus jeder späteren Anfrage heraus. Neue Antworten enthalten immer noch Thinking239* Wenn das Upstream eine [Thinking-Signatur](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) ablehnt, einschließlich mit einem `400` dessen Nachricht besagt, dass der Block `bound to a different conversation` ist, entfernt Claude Code frühere Thinking-Blöcke aus der Anfrage, versucht erneut und hält sie aus jeder späteren Anfrage heraus. Neue Antworten enthalten immer noch Thinking

232* Wenn das Gateway oder sein Upstream den [Advisor-Tool](/docs/de/advisor) Eintrag in `tools` als einen nicht erkannten Tool-Typ ablehnt, versucht Claude Code die Anfrage einmal ohne diesen Eintrag und seinen `anthropic-beta` Wert erneut. Spätere Anfragen an diese Basis-URL lassen den Advisor aus, bis Claude Code beendet wird, und `/advisor` ist für den Entwickler für diese Zeit nicht verfügbar. Claude Code erkennt diese Ablehnung durch eine `400` oder `422` Antwort, deren Nachricht den Tool-Typ nach `Input tag` benennt, wie z. B. `Input tag 'advisor_20260301'`. Vor v2.1.280 wiederholte Claude Code diese Ablehnung nicht240* Wenn das Gateway oder sein Upstream den [Advisor-Tool](/docs/de/advisor) Eintrag in `tools` als einen nicht erkannten Tool-Typ ablehnt, versucht Claude Code die Anfrage einmal ohne diesen Eintrag und seinen `anthropic-beta` Wert erneut. Spätere Anfragen an diese Basis-URL lassen den Advisor aus, bis Claude Code beendet wird, und `/advisor` ist für den Entwickler für diese Zeit nicht verfügbar. Claude Code erkennt diese Ablehnung durch eine `400` oder `422` Antwort, deren Nachricht den Tool-Typ nach `Input tag` benennt, wie z. B. `Input tag 'advisor_20260301'`. Vor v2.1.280 wiederholte Claude Code diese Ablehnung nicht

233* Wenn das Upstream `output_config.effort` ablehnt, versucht Claude Code die Anfrage ohne Aufwand erneut und lässt ihn aus späteren Anfragen an dieses Modell weg, bis Claude Code beendet wird. Claude Code erkennt diese Ablehnung an einem `400`, dessen Nachricht `output_config.effort` zusammen mit `Extra inputs are not permitted` nennt oder besagt, dass das Modell den Effort-Parameter nicht unterstützt241* Wenn das Upstream `output_config.effort` ablehnt, versucht Claude Code die Anfrage ohne Aufwand erneut und lässt ihn aus späteren Anfragen an dieses Modell weg, bis Claude Code beendet wird. Claude Code erkennt diese Ablehnung an einem `400`, dessen Nachricht `output_config.effort` zusammen mit `Extra inputs are not permitted` nennt oder besagt, dass das Modell den Effort-Parameter nicht unterstützt

234* Claude Code versucht Ablehnungen von Kontextverwaltungs- oder Tool-Schema-Feldern nicht erneut, daher erreichen diese `400` Fehler den Entwickler242* Wenn das Upstream das `context_management` Feld oder seinen `anthropic-beta` Wert ablehnt, sieht das Gateway die Anfrage noch einmal ohne diese. Wenn das Gateway sie in einer späteren Anfrage erneut sieht und das Upstream sie erneut ablehnt, folgt derselbe Wiederholungsversuch. Claude Code erkennt diese Ablehnung an ihrer Nachricht, zum Beispiel einer, die `context_management: Extra inputs are not permitted` enthält. Vor v2.1.304 wiederholte Claude Code diese Ablehnung nicht

243* Wenn das Upstream ein anderes Beta-Tool-Feld als `defer_loading` ablehnt, etwa `strict`, erreicht der `400`-Fehler den Entwickler. Zuvor kann das Gateway die Anfrage erneut [ohne die Tool-Search-Felder](#retry-without-tool-search) sehen. Um das Senden solcher Felder zu unterbinden, lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen

235 244 

236Die `bound to a different conversation` Ablehnung kommt von der API-Überprüfung für [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), die fehlschlägt, wenn `system`, `tools` oder frühere `messages` Inhalte sich von der Anfrage unterscheiden, die das Thinking produziert hat. Ein Gateway, das einen dieser Inhalte umschreibt, kann die Ablehnung selbst verursachen; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) behandelt, was unverändert durchgeleitet werden muss.245Die `bound to a different conversation` Ablehnung kommt von der API-Überprüfung für [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), die fehlschlägt, wenn `system`, `tools` oder frühere `messages` Inhalte sich von der Anfrage unterscheiden, die das Thinking produziert hat. Ein Gateway, das einen dieser Inhalte umschreibt, kann die Ablehnung selbst verursachen; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) behandelt, was unverändert durchgeleitet werden muss.

237 246 

238Die Wiederholungslogik gleicht die Fehlerformulierung des Upstreams ab, daher leiten Sie Fehler-Response-Bodies unverändert weiter. Ein Gateway, das Upstream-Fehler in seine eigene Hülle einwickelt, bricht den Wiederherstellungspfad, auch wenn es den Statuscode beibehält, es sei denn, die Nachricht der Hülle trägt ein stabiles `capability_rejected:` Token. [Claude Apps Gateway ersetzt diese Tokens für Cloud-Provider-Fehlerformulierungen](/docs/de/claude-apps-gateway-config#upstream-error-messages), zum Beispiel `capability_rejected: prompt_too_long`.247Der Großteil dieser Wiederholungslogik gleicht die Fehlerformulierung des Upstreams ab, daher leiten Sie Fehler-Response-Bodies unverändert weiter. Ein Gateway, das Upstream-Fehler in seine eigene Hülle einwickelt, bricht den Wiederherstellungspfad, auch wenn es den Statuscode beibehält, es sei denn, die Nachricht der Hülle trägt ein stabiles `capability_rejected:` Token. [Claude Apps Gateway ersetzt diese Tokens für Cloud-Provider-Fehlerformulierungen](/docs/de/claude-apps-gateway-config#upstream-error-messages), zum Beispiel `capability_rejected: prompt_too_long`.

248 

249#### Wiederholungsversuch ohne Tool Search

250 

251Ab v2.1.305 kann eine Anfrage mit [`defer_loading`-Feldern und `tool_reference`-Blöcken](/docs/de/mcp#tool-search-through-a-gateway) nach einem `400` oder `422`, dessen Ursache Claude Code nicht erkennt, erneut ohne diese eintreffen. Nach einem erfolgreichen Wiederholungsversuch lassen auch spätere Anfragen sie weg.

252 

253Die Anfragen des Entwicklers funktionieren ohne Änderung am Gateway weiter, wobei seine MCP-Tools vorab geladen werden. Claude Code versucht Tool Search später erneut, sodass das Gateway eine weitere abgelehnte Anfrage gefolgt von ihrem Wiederholungsversuch sehen kann. Um die Felder aus allen Anfragen herauszuhalten, lassen Sie Entwickler `ENABLE_TOOL_SEARCH=false` setzen. Für Tool Search selbst erwartet Claude Code, dass das Gateway die `defer_loading`-Felder und `tool_reference`-Blöcke zusammen mit ihrem `anthropic-beta`-Wert weiterleitet.

239 254 

240### Deaktivieren Sie Pre-Release-Funktionen255### Deaktivieren Sie Pre-Release-Funktionen

241 256 


250Die Variable entfernt nicht jeden `anthropic-beta`-Wert. Unverändert bleiben unter anderem:265Die Variable entfernt nicht jeden `anthropic-beta`-Wert. Unverändert bleiben unter anderem:

251 266 

252* Die `anthropic-beta`-Werte für erweiterten Kontext, verschachteltes Denken und Aufwand, die auch Cloud-Provider akzeptieren267* Die `anthropic-beta`-Werte für erweiterten Kontext, verschachteltes Denken und Aufwand, die auch Cloud-Provider akzeptieren

253* Das Feld `output_config.effort`. [Automatische Wiederholungsversuche und Fehlerweiterleitung](#automatic-retry-and-error-forwarding) behandelt ein Upstream, das es ablehnt268* Das Feld `output_config.effort` auf oberster Ebene. [Automatische Wiederholungsversuche und Fehlerweiterleitung](#automatic-retry-and-error-forwarding) behandelt ein Upstream, das es ablehnt

254* Das `thinking` Feld für Adaptive Reasoning, das keinen Beta-Header hat269* Das `thinking` Feld für Adaptive Reasoning, das keinen Beta-Header hat

270* Die `role: "system"`-Einträge, die [Systemnachrichten mitten in der Konversation](#feature-pass-through) enthalten

255* Der OAuth-`anthropic-beta`-Wert, den die Abonnement-Authentifizierung benötigt271* Der OAuth-`anthropic-beta`-Wert, den die Abonnement-Authentifizierung benötigt

256* Header-Werte und Body-Felder, die Entwickler selbst über [`ANTHROPIC_BETAS`](/docs/de/env-vars) oder [`CLAUDE_CODE_EXTRA_BODY`](/docs/de/env-vars) hinzufügen272* Header-Werte und Body-Felder, die Entwickler selbst über [`ANTHROPIC_BETAS`](/docs/de/env-vars) oder [`CLAUDE_CODE_EXTRA_BODY`](/docs/de/env-vars) hinzufügen

257 273 

Details

86 * **In einer vollständigen VM-Sandbox**: Wenn Ihre Claude Desktop-verwaltete Konfiguration [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) setzt, wird Claude Code in einer virtuellen Maschine ausgeführt, in der die MDM-Richtlinie und die verwaltete Einstellungsdatei des Geräts nicht vorhanden sind.86 * **In einer vollständigen VM-Sandbox**: Wenn Ihre Claude Desktop-verwaltete Konfiguration [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) setzt, wird Claude Code in einer virtuellen Maschine ausgeführt, in der die MDM-Richtlinie und die verwaltete Einstellungsdatei des Geräts nicht vorhanden sind.

87 * **Remote-Cowork-Sitzungen**: Diese werden auf von Anthropic verwalteten VMs ausgeführt, wo Claude Code keine Geräterichtlinie zum Lesen hat.87 * **Remote-Cowork-Sitzungen**: Diese werden auf von Anthropic verwalteten VMs ausgeführt, wo Claude Code keine Geräterichtlinie zum Lesen hat.

88 88 

89 Überall dort, wo die Sitzung ausgeführt wird, wendet claude.ai die Listen [`strictKnownMarketplaces`](/docs/de/settings-reference#strictknownmarketplaces) und [`blockedMarketplaces`](/docs/de/settings-reference#blockedmarketplaces) der Verwaltungskonsole selbst an, wenn jemand einen Marketplace aus einem Git-Repository auf claude.ai oder aus **Anpassen** in der Cowork-Registerkarte hinzufügt. [Wie Einschränkungen funktionieren](/docs/de/plugins/org#restrict-what-users-can-install) beschreibt diese Überprüfung. Die [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) vergleicht Cowork mit den anderen Oberflächen.89 Überall dort, wo die Sitzung ausgeführt wird, wendet claude.ai die Listen [`strictKnownMarketplaces`](/docs/de/settings-reference#strictknownmarketplaces) und [`blockedMarketplaces`](/docs/de/settings-reference#blockedmarketplaces) der Verwaltungskonsole selbst an, wenn jemand einen Marketplace aus einem Git-Repository auf claude.ai oder aus **Anpassen** in Cowork hinzufügt. [Wie Einschränkungen funktionieren](/docs/de/plugins/org#restrict-what-users-can-install) beschreibt diese Überprüfung. Die Tabelle zur [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) vergleicht Cowork mit den anderen Oberflächen.

90* **Laufende Sitzungen**: Die meisten Änderungen erreichen eine laufende Sitzung nach dem Zeitplan in der [Bereitstellungsmechanismus-Tabelle](#choose-a-delivery-mechanism), ohne einen Neustart.90* **Laufende Sitzungen**: Die meisten Änderungen erreichen eine laufende Sitzung nach dem Zeitplan in der [Bereitstellungsmechanismus-Tabelle](#choose-a-delivery-mechanism), ohne einen Neustart.

91 * Änderungen an [`forceRemoteSettingsRefresh`](/docs/de/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/de/settings-reference#requiredminimumversion) und [einigen benutzerbearbeitbaren Schlüsseln](/docs/de/settings#when-edits-take-effect) treten beim nächsten Sitzungsstart in Kraft.91 * Änderungen an [`forceRemoteSettingsRefresh`](/docs/de/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/de/settings-reference#requiredminimumversion) und [einigen benutzerbearbeitbaren Schlüsseln](/docs/de/settings#when-edits-take-effect) treten beim nächsten Sitzungsstart in Kraft.

92 * Ein neuer oder geänderter [`policyHelper`](/docs/de/settings-reference#policyhelper)-Eintrag tritt beim nächsten Start in Kraft. Wenn serververwaltete Einstellungen den Helper bei diesem Start überschatten, wird der Helper ausgeführt, sobald ein Abruf meldet, dass diese Einstellungen entfernt wurden.92 * Ein neuer oder geänderter [`policyHelper`](/docs/de/settings-reference#policyhelper)-Eintrag tritt beim nächsten Start in Kraft. Wenn serververwaltete Einstellungen den Helper bei diesem Start überschatten, wird der Helper ausgeführt, sobald ein Abruf meldet, dass diese Einstellungen entfernt wurden.

mcp.md +31 −7

Details

302Wenn Ihre Anfrage Werkzeuge von einem Server benötigt, der sich noch im Hintergrund verbindet, wartet Claude auf diesen Server, bevor er fortfährt. Wie das Warten geschieht, hängt von Ihrer Konfiguration ab:302Wenn Ihre Anfrage Werkzeuge von einem Server benötigt, der sich noch im Hintergrund verbindet, wartet Claude auf diesen Server, bevor er fortfährt. Wie das Warten geschieht, hängt von Ihrer Konfiguration ab:

303 303 

304* **Mit [Werkzeugsuche](#scale-with-mcp-tool-search), der Standard**: Das Warten geschieht innerhalb des `ToolSearch`-Aufrufs.304* **Mit [Werkzeugsuche](#scale-with-mcp-tool-search), der Standard**: Das Warten geschieht innerhalb des `ToolSearch`-Aufrufs.

305* **Ohne Werkzeugsuche**: Claude verwendet stattdessen das `WaitForMcpServers`-Werkzeug. Konfigurationen ohne Werkzeugsuche enthalten eine benutzerdefinierte `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` und ein Modell, das älter als Claude Opus 4.5, Claude Sonnet 4.5 und Claude Haiku 4.5 ist, auf Google Clouds Agent Platform.305* **Ohne Werkzeugsuche**: Claude verwendet stattdessen das `WaitForMcpServers`-Werkzeug. Konfigurationen ohne Werkzeugsuche umfassen `ENABLE_TOOL_SEARCH=false` und ein Modell, das älter als Claude Opus 4.5, Claude Sonnet 4.5 und Claude Haiku 4.5 ist, auf Google Clouds Agent Platform. Für ein `ANTHROPIC_BASE_URL`-Gateway siehe [Werkzeugsuche über ein LLM-Gateway](#tool-search-through-a-gateway).

306* **Bei einer Microsoft Foundry-[Bereitstellung auf Azure gehostet](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude startet auf dem Werkzeugsuche-Pfad statt mit `WaitForMcpServers`, da Claude Code die serverseitige Ablehnung der Bereitstellung nur von der API entdeckt. Nachdem Claude Code diese Bereitstellung auf [vorausgehendes Laden](#scale-with-mcp-tool-search) umschaltet, werden Werkzeuge von einem Server, der seinen Verbindungsaufbau abschließt, bei Claudes nächster Anfrage verfügbar.306* **Bei einer Microsoft Foundry-[Bereitstellung auf Azure gehostet](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude startet auf dem Werkzeugsuche-Pfad statt mit `WaitForMcpServers`, da Claude Code die serverseitige Ablehnung der Bereitstellung nur von der API entdeckt. Nachdem Claude Code diese Bereitstellung auf [vorausgehendes Laden](#scale-with-mcp-tool-search) umschaltet, werden Werkzeuge von einem Server, der seinen Verbindungsaufbau abschließt, bei Claudes nächster Anfrage verfügbar.

307 307 

308Mit aktivierter Werkzeugsuche, wenn ein Server seinen Verbindungsaufbau abschließt, während Claude arbeitet, listet Claude Code die Werkzeugnamen des Servers bei Claudes nächster Anfrage im selben Turn auf. Claude kann dann diese Werkzeuge suchen und aufrufen, ohne auf Ihre nächste Nachricht zu warten.308Mit aktivierter Werkzeugsuche, wenn ein Server seinen Verbindungsaufbau abschließt, während Claude arbeitet, listet Claude Code die Werkzeugnamen des Servers bei Claudes nächster Anfrage im selben Turn auf. Claude kann dann diese Werkzeuge suchen und aufrufen, ohne auf Ihre nächste Nachricht zu warten.


509 509 

510Plugin-Server erscheinen in `/mcp` mit Indikatoren, die zeigen, dass sie von Plugins stammen.510Plugin-Server erscheinen in `/mcp` mit Indikatoren, die zeigen, dass sie von Plugins stammen.

511 511 

512Für einen Stdio-Server eines Plugins gibt `claude mcp get` `Command: stdio`, eine leere `Args:`-Zeile und jede Umgebungsvariable als `NAME=[REDACTED]` aus. Die Werte sind verborgen, da sie Anmeldedaten enthalten können.512`claude mcp get` verbirgt die Werte, die für den Stdio- oder WebSocket-Server eines Plugins konfiguriert sind, da sie Anmeldedaten enthalten können:

513 

514* **Stdio-Server**: Es gibt `Command: stdio`, eine leere `Args:`-Zeile und jede Umgebungsvariable als `NAME=[REDACTED]` aus

515* **WebSocket-Server**: Es gibt `URL: ws` und jeden Header als `<name>: [REDACTED]` aus, und `claude mcp list` zeigt `ws` anstelle der URL

516 

517Um zu sehen, was das Plugin konfiguriert hat, [suchen Sie das Plugin auf der Festplatte](/docs/de/plugins/loading#find-plugins-on-disk) und lesen Sie seine `.mcp.json` oder `plugin.json`.

513 518 

514**Namen von Plugin-MCP-Werkzeugen**:519**Namen von Plugin-MCP-Werkzeugen**:

515 520 


592 597 

593Aus Sicherheitsgründen fordert Claude Code eine Genehmigung an, bevor projektbegrenzte Server aus `.mcp.json`-Dateien in interaktiven Sitzungen verwendet werden. Um diese Genehmigungswahlmöglichkeiten zurückzusetzen, führen Sie `claude mcp reset-project-choices` aus.598Aus Sicherheitsgründen fordert Claude Code eine Genehmigung an, bevor projektbegrenzte Server aus `.mcp.json`-Dateien in interaktiven Sitzungen verwendet werden. Um diese Genehmigungswahlmöglichkeiten zurückzusetzen, führen Sie `claude mcp reset-project-choices` aus.

594 599 

595In `claude -p`-Läufen, [Agent SDK](/docs/de/headless)-Sitzungen und [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) kann Claude Code diese Eingabeaufforderung nicht anzeigen: Es lädt projektbegrenzte Server ohne Nachfrage. Claude Code überspringt die Eingabeaufforderung auch in einer Sitzung, die Sie im `bypassPermissions`-Modus mit [`skipDangerousModePermissionPrompt`](/docs/de/settings-reference#skipdangerousmodepermissionprompt) in Ihren Benutzereinstellungen oder in verwalteten Einstellungen starten. Um einen Server trotzdem auszuschließen:600In `claude -p`-Läufen, [Agent SDK](/docs/de/headless)-Sitzungen und [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) kann Claude Code diese Eingabeaufforderung nicht anzeigen: Es lädt projektbegrenzte Server ohne Nachfrage. Claude Code überspringt die Eingabeaufforderung auch in einer Sitzung, die Sie im `bypassPermissions`-Modus mit [`skipDangerousModePermissionPrompt`](/docs/de/settings-reference#skipdangerousmodepermissionprompt) in Ihren Benutzereinstellungen oder in verwalteten Einstellungen starten. Um einen Server trotzdem auszuschließen:

596 601 

597* Fügen Sie ihn zu [`disabledMcpjsonServers`](/docs/de/settings-reference#disabledmcpjsonservers) hinzu, was ihn in jedem Berechtigungsmodus blockiert.602* Fügen Sie ihn zu [`disabledMcpjsonServers`](/docs/de/settings-reference#disabledmcpjsonservers) hinzu, was ihn in jedem Berechtigungsmodus blockiert.

598* Schließen Sie Projekteinstellungen vollständig mit [`--setting-sources`](/docs/de/cli-reference#cli-flags) oder der SDK-Option `settingSources` aus.603* Schließen Sie Projekteinstellungen vollständig mit [`--setting-sources`](/docs/de/cli-reference#cli-flags) oder der SDK-Option `settingSources` aus.


1483 1488 

1484### Tool-Suche konfigurieren1489### Tool-Suche konfigurieren

1485 1490 

1486Die Tool-Suche ist standardmäßig aktiviert: MCP-Tools werden aufgeschoben und bei Bedarf erkannt. Claude Code deaktiviert sie, wenn `ANTHROPIC_BASE_URL` auf einen Host eines Drittanbieters verweist, da die meisten Proxys `tool_reference`-Blöcke nicht weiterleiten. Setzen Sie `ENABLE_TOOL_SEARCH` explizit, um diesen Fallback zu überschreiben.1491Die Tool-Suche ist standardmäßig aktiviert: MCP-Tools werden aufgeschoben und bei Bedarf erkannt.

1487 1492 

1488Das Setzen von [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/de/env-vars) hält die Tool-Suche aus. Sie können sie nicht durch das Setzen von `ENABLE_TOOL_SEARCH` selbst überschreiben. Ab Claude Code v2.1.227 kann Ihre Organisation die Tool-Suche unter dieser Variablen über [verwaltete Einstellungen](/docs/de/managed-settings) aktiviert halten. In einer Sitzung, die [die HIPAA-Konfiguration erhält](/docs/de/hipaa-setup#check-how-developers-sign-in-and-connect), ist die Tool-Suche ausgeschaltet, und weder `ENABLE_TOOL_SEARCH` noch verwaltete Einstellungen schalten sie wieder ein. [Deaktivieren Sie Pre-Release-Funktionen](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) behandelt, wo die Überschreibung gilt und was die Variable entfernt.1493Das Setzen von [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/de/env-vars) hält die Tool-Suche aus. Sie können sie nicht durch das Setzen von `ENABLE_TOOL_SEARCH` selbst überschreiben. Ab Claude Code v2.1.227 kann Ihre Organisation die Tool-Suche unter dieser Variablen über [verwaltete Einstellungen](/docs/de/managed-settings) aktiviert halten. In einer Sitzung, die [die HIPAA-Konfiguration erhält](/docs/de/hipaa-setup#check-how-developers-sign-in-and-connect), ist die Tool-Suche ausgeschaltet, und weder `ENABLE_TOOL_SEARCH` noch verwaltete Einstellungen schalten sie wieder ein. [Deaktivieren Sie Pre-Release-Funktionen](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) behandelt, wo die Überschreibung gilt und was die Variable entfernt.

1489 1494 


1500 1505 

1501| Wert | Verhalten |1506| Wert | Verhalten |

1502| :- | :- |1507| :- | :- |

1503| (nicht gesetzt) | Alle MCP-Tools werden aufgeschoben und bei Bedarf geladen. Fallback zum Vorab-Laden bei Modellen älter als Opus 4 und Sonnet 4, auf Google Clouds Agent Platform-Modellen älter als Opus 4.5, Sonnet 4.5 und Haiku 4.5, wenn `ANTHROPIC_BASE_URL` ein Host eines Drittanbieters ist, oder bei einer Microsoft Foundry-Bereitstellung auf Azure |1508| (nicht gesetzt) | Alle MCP-Tools werden aufgeschoben und bei Bedarf geladen. Vorab geladen bei Modellen älter als Opus 4 und Sonnet 4, bei den [früheren Agent Platform-Modellen](#configure-tool-search) und bei Microsoft Foundry-Bereitstellungen auf Azure |

1504| `true` | MCP-Tools bleiben aufgeschoben, wenn `ANTHROPIC_BASE_URL` ein Host eines Drittanbieters ist. Die anderen Fallbacks von (nicht gesetzt) gelten weiterhin. Claude Code sendet den Beta-Header durch Proxys, und Anfragen schlagen auf Proxys fehl, die `tool_reference`-Blöcke nicht unterstützen |1509| `true` | MCP-Tools werden aufgeschoben, mit denselben Fallbacks wie bei (nicht gesetzt) |

1505| `auto` | Schwellenmodus: Claude Code lädt die Tools, die es sonst aufgeschoben hätte, vorab, während ihre Definitionen weniger als 10 % des Kontextfensters ausmachen, und schiebt alle auf, sobald die Definitionen 10 % erreichen |1510| `auto` | Schwellenmodus. Tools, die sonst aufgeschoben würden, werden vorab geladen, solange ihre Definitionen insgesamt weniger als 10 % des Kontextfensters ausmachen. Ab 10 % wird die Tool-Suche aktiviert, und diese Tools können [aufgeschoben bleiben](#tools-that-stay-deferred-below-the-threshold), auch wenn die Summe unter 10 % fällt |

1506| `auto:N` | Schwellenmodus mit einem benutzerdefinierten Prozentsatz, wobei `N` 0-100 ist. Zum Beispiel `auto:5` für 5 % |1511| `auto:N` | Schwellenmodus mit einem benutzerdefinierten Prozentsatz, wobei `N` 0-100 ist. Zum Beispiel `auto:5` für 5 % |

1507| `false` | Alle MCP-Tools werden vorab geladen, kein Aufschub |1512| `false` | Alle MCP-Tools werden vorab geladen, kein Aufschub |

1508 1513 


1526}1531}

1527```1532```

1528 1533 

1534Wenn Sie `ToolSearch` verweigern oder es in [`--tools`](/docs/de/cli-reference#cli-flags) weglassen, werden MCP-Tools stattdessen vorab geladen, aber eine Anfrage kann dennoch einen Platzhalter-Eintrag `defer_loading` enthalten. Wenn ein Gateway diesen Eintrag ablehnt, siehe [Tool-Suche über ein LLM-Gateway](#tool-search-through-a-gateway).

1535 

1536#### Tool-Suche über ein LLM-Gateway

1537 

1538> [!NOTE]

1539>

1540> Diese Fälle werden an anderer Stelle behandelt:

1541>

1542> * **Sie haben `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` gesetzt**: siehe [wie sich dies auf die Tool-Suche auswirkt](#configure-tool-search)

1543> * **Eine Anfrage ist mit einem Fehler fehlgeschlagen, der `defer_loading` oder `tool_reference` nennt**: siehe [Extra inputs are not permitted](/docs/de/errors#extra-inputs-are-not-permitted)

1544 

1545Wenn `ANTHROPIC_BASE_URL` auf ein Gateway verweist, ist die Tool-Suche standardmäßig aktiviert, sodass Anfragen `defer_loading`-Tool-Felder und `tool_reference`-Blöcke enthalten, die das Gateway weiterleiten muss. Solange die Tool-Suche aktiviert ist, werden MCP-Tools [aufgeschoben](#scale-with-mcp-tool-search). Um stattdessen alle Tools vorab zu laden, setzen Sie `ENABLE_TOOL_SEARCH=false` in Ihrer Shell oder in Ihrem [Einstellungsfeld `env`](/docs/de/settings-reference#env). Vor v2.1.304 war die Tool-Suche hinter einem Gateway ausgeschaltet, es sei denn, `ENABLE_TOOL_SEARCH` war `true`, `auto` oder `auto:N`.

1546 

1547Ab v2.1.305 kann Claude Code [eine Anfrage ohne Tool-Suche erneut versuchen](/docs/de/llm-gateway-protocol#retry-without-tool-search), nachdem ein `400` oder `422` aufgetreten ist, dessen Ursache es nicht erkennt. Wenn der Wiederholungsversuch funktioniert, wird nichts auf dem Bildschirm angezeigt, und Sie müssen nichts tun: MCP-Tools werden stattdessen vorab geladen. Claude Code versucht die Tool-Suche später erneut, auf Kosten einer weiteren abgelehnten Anfrage. Um diese Anfragen zu vermeiden, setzen Sie `ENABLE_TOOL_SEARCH=false`.

1548 

1549#### Tools, die unterhalb des `ENABLE_TOOL_SEARCH=auto`-Schwellenwerts aufgeschoben bleiben

1550 

1551Wenn [`/context`](/docs/de/commands#all-commands) Tools als `(deferred)` oder `(loaded on-demand)` kennzeichnet, obwohl ihre Definitionen insgesamt unter dem `auto`-Schwellenwert liegen, war die Tool-Suche in dieser Konversation bereits aktiviert und ist aktiviert geblieben. Die Summe kann später sinken, zum Beispiel während sich MCP-Server neu verbinden, nachdem Sie eine Sitzung fortgesetzt haben. Sie müssen nichts tun: Claude lädt jedes dieser Tools, wenn eine Aufgabe es benötigt.

1552 

1529### Einen Server vom Aufschub ausnehmen1553### Einen Server vom Aufschub ausnehmen

1530 1554 

1531Wenn die Tools eines Servers Claude immer sichtbar sein sollten, ohne einen Suchschritt, setzen Sie `alwaysLoad` in der Konfiguration dieses Servers auf `true`. Die Tools des Servers werden dann unabhängig von der `ENABLE_TOOL_SEARCH`-Einstellung in den Kontext geladen. Verwenden Sie dies für eine kleine Anzahl von Tools, die Claude bei jedem Durchgang benötigt, da jedes vorab geladene Tool Kontext verbraucht, der sonst für Ihre Konversation verfügbar wäre.1555Wenn die Tools eines Servers Claude immer sichtbar sein sollten, ohne einen Suchschritt, setzen Sie `alwaysLoad` in der Konfiguration dieses Servers auf `true`. Die Tools des Servers werden dann unabhängig von der `ENABLE_TOOL_SEARCH`-Einstellung in den Kontext geladen. Verwenden Sie dies für eine kleine Anzahl von Tools, die Claude bei jedem Durchgang benötigt, da jedes vorab geladene Tool Kontext verbraucht, der sonst für Ihre Konversation verfügbar wäre.

Details

278* **Claude Code Desktop-App**: Fügen Sie Server über die [Connectors-Benutzeroberfläche](/docs/de/desktop#connect-external-tools) hinzu.278* **Claude Code Desktop-App**: Fügen Sie Server über die [Connectors-Benutzeroberfläche](/docs/de/desktop#connect-external-tools) hinzu.

279* **Claude Desktop Chat-App**: eine separate App von Claude Code. Um Server aus ihrer `claude_desktop_config.json` in die CLI zu kopieren, führen Sie `claude mcp add-from-claude-desktop` auf macOS oder WSL aus.279* **Claude Desktop Chat-App**: eine separate App von Claude Code. Um Server aus ihrer `claude_desktop_config.json` in die CLI zu kopieren, führen Sie `claude mcp add-from-claude-desktop` auf macOS oder WSL aus.

280* **VS Code**: siehe [Mit externen Tools mit MCP verbinden](/docs/de/vs-code#connect-to-external-tools-with-mcp).280* **VS Code**: siehe [Mit externen Tools mit MCP verbinden](/docs/de/vs-code#connect-to-external-tools-with-mcp).

281* **Cloud-Sitzungen**: Committen Sie eine `.mcp.json` in Ihr Repository; eine Sitzung mit einem Repository lädt sie. Siehe [.mcp.json direkt bearbeiten](#edit-mcp-json-directly) und [Was aus Ihrem Setup übernommen wird](/docs/de/cloud-environments#what-carries-over-from-your-setup).281* **Cloud-Sitzungen**: Committen Sie außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) eine `.mcp.json` in Ihr Repository; eine Sitzung mit einem Repository lädt sie. Cloud-Threads in einem Projekt verwenden stattdessen Ihre claude.ai-Konnektoren. Siehe [.mcp.json direkt bearbeiten](#edit-mcp-json-directly) und [Was aus Ihrem Setup übernommen wird](/docs/de/cloud-environments#what-carries-over-from-your-setup).

282* **Claude.ai**: Connectors, die Sie unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) hinzufügen, werden automatisch in die CLI geladen, wenn Sie sich mit diesem Konto anmelden. Siehe [MCP-Server von Claude.ai verwenden](/docs/de/mcp#use-mcp-servers-from-claude-ai).282* **Claude.ai**: Connectors, die Sie unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) hinzufügen, werden automatisch in die CLI geladen, wenn Sie sich mit diesem Konto anmelden. Siehe [MCP-Server von Claude.ai verwenden](/docs/de/mcp#use-mcp-servers-from-claude-ai).

283 283 

284## Fehlerbehebung284## Fehlerbehebung

memory.md +10 −5

Details

208 208 

209Regeln ohne ein `paths`-Feld werden bedingungslos geladen und gelten für alle Dateien. Eine pfadgebundene Regel wird geladen, wenn Claude das Read-, Write- oder Edit-Tool auf eine passende Datei anwendet. Sie wird auch geladen, wenn Claude eine passende Datei mit einem Bash-Befehl anzeigt, der [als Lesevorgang gilt](/docs/de/tools-reference#edit-tool-behavior), etwa `cat` oder `head` auf eine einzelne Datei. Das Matching funktioniert auch, wenn Claude eine Datei über einen per Symlink verknüpften Pfad zum Projektverzeichnis erreicht, zum Beispiel in einem per Symlink verknüpften Checkout.209Regeln ohne ein `paths`-Feld werden bedingungslos geladen und gelten für alle Dateien. Eine pfadgebundene Regel wird geladen, wenn Claude das Read-, Write- oder Edit-Tool auf eine passende Datei anwendet. Sie wird auch geladen, wenn Claude eine passende Datei mit einem Bash-Befehl anzeigt, der [als Lesevorgang gilt](/docs/de/tools-reference#edit-tool-behavior), etwa `cat` oder `head` auf eine einzelne Datei. Das Matching funktioniert auch, wenn Claude eine Datei über einen per Symlink verknüpften Pfad zum Projektverzeichnis erreicht, zum Beispiel in einem per Symlink verknüpften Checkout.

210 210 

211Jedes Muster ist relativ zum Basisverzeichnis der Regel:

212 

213* **Projektregeln**: das Verzeichnis, das den `.claude`-Ordner der Regel enthält

214* **[Benutzerweite Regeln](#user-level-rules)**: das [primäre Arbeitsverzeichnis](/docs/de/permissions#working-directories) der Sitzung

215 

216Damit pfadgebundene Regeln für Dateien in einem benachbarten Git-Worktree geladen werden, starten Sie Claude Code in diesem Worktree oder [verschieben Sie die Sitzung mit `/cd` dorthin](/docs/de/permissions#move-the-session-to-another-directory).

217 

211Verwenden Sie Glob-Muster im Feld `paths`, um Dateien nach Erweiterung, Verzeichnis oder einer beliebigen Kombination zu vergleichen:218Verwenden Sie Glob-Muster im Feld `paths`, um Dateien nach Erweiterung, Verzeichnis oder einer beliebigen Kombination zu vergleichen:

212 219 

213| Muster | Passt zu |220| Muster | Passt zu |


279 286 

280#### Stellen Sie organisationsweite CLAUDE.md bereit287#### Stellen Sie organisationsweite CLAUDE.md bereit

281 288 

282Organisationen können eine zentral verwaltete CLAUDE.md bereitstellen, die für alle Benutzer auf einem Computer gilt. Diese Datei kann nicht durch individuelle Einstellungen ausgeschlossen werden.289Organisationen können eine zentral verwaltete CLAUDE.md bereitstellen, die für alle Benutzer auf einem Computer gilt. Entwickler können mit der Einstellung `claudeMdExcludes` [andere CLAUDE.md-Dateien ausschließen](#exclude-specific-claude-md-files), diese jedoch nicht. Wenn ein Entwickler eine Sitzung startet, in der das Laden von CLAUDE.md vollständig deaktiviert ist, lädt diese Sitzung auch den verwalteten Inhalt nicht. Verwenden Sie die Datei für Anleitungen und setzen Sie Regeln mit [verwalteten Einstellungen](/docs/de/managed-settings) wie `permissions.deny` durch.

283 290 

284**1. Erstellen Sie die Datei am verwalteten Richtlinienort**291**1. Erstellen Sie die Datei am verwalteten Richtlinienort**

285 292 


293 300 

294Der Schlüssel `claudeMd` ermöglicht es Ihnen, verwaltete CLAUDE.md-Inhalte direkt in `managed-settings.json` zu platzieren, statt eine separate Datei bereitzustellen.301Der Schlüssel `claudeMd` ermöglicht es Ihnen, verwaltete CLAUDE.md-Inhalte direkt in `managed-settings.json` zu platzieren, statt eine separate Datei bereitzustellen.

295 302 

296**Umfang**: jede Claude Code-Sitzung auf dem Computer, in jedem Repository. Für repositoryspezifische Anleitung committen Sie stattdessen eine Projekt-CLAUDE.md.303**Umfang**: alle Benutzer auf dem Computer, in jedem Repository. Für repositoryspezifische Anleitung committen Sie stattdessen eine Projekt-CLAUDE.md.

297 304 

298**Vorrang**: gleich wie eine verwaltete CLAUDE.md-Datei. Wird vor Benutzer- und Projekt-CLAUDE.md geladen.305**Vorrang**: gleich wie eine verwaltete CLAUDE.md-Datei. Wird vor Benutzer- und Projekt-CLAUDE.md geladen.

299 306 


323 330 

324#### Schließen Sie bestimmte CLAUDE.md-Dateien aus331#### Schließen Sie bestimmte CLAUDE.md-Dateien aus

325 332 

326In großen Monorepos können Vorgänger-CLAUDE.md-Dateien Anweisungen enthalten, die für Ihre Arbeit nicht relevant sind. Die Einstellung `claudeMdExcludes` ermöglicht es Ihnen, bestimmte Dateien nach Pfad oder Glob-Muster zu überspringen.333In großen Monorepos können Vorgänger-CLAUDE.md-Dateien Anweisungen enthalten, die für Ihre Arbeit nicht relevant sind. Die Einstellung `claudeMdExcludes` ermöglicht es Ihnen, bestimmte Dateien nach Pfad oder Glob-Muster zu überspringen. Eine [verwaltete CLAUDE.md-Datei](#deploy-organization-wide-claude-md) können Sie mit `claudeMdExcludes` nicht ausschließen.

327 334 

328Dieses Beispiel schließt eine CLAUDE.md auf oberster Ebene und ein Regelverzeichnis aus einem übergeordneten Ordner aus. Fügen Sie es zu `.claude/settings.local.json` hinzu, damit der Ausschluss lokal auf Ihrem Computer bleibt:335Dieses Beispiel schließt eine CLAUDE.md auf oberster Ebene und ein Regelverzeichnis aus einem übergeordneten Ordner aus. Fügen Sie es zu `.claude/settings.local.json` hinzu, damit der Ausschluss lokal auf Ihrem Computer bleibt:

329 336 


340 347 

341Um eine Regeldatei auszuschließen, die Sie über einen [Symlink](#share-rules-across-projects-with-symlinks) erreichen, ob die Datei oder ihr Verzeichnis der Link ist, schreiben Sie das Muster gegen einen der beiden Pfade: den Pfad der Datei unter `.claude/rules/` oder ihr Link-Ziel. Ein Muster, das zu einem der beiden Pfade passt, schließt die Datei aus. Vor v2.1.239 schloss nur ein Muster, das zum Link-Ziel passte, die Datei aus.348Um eine Regeldatei auszuschließen, die Sie über einen [Symlink](#share-rules-across-projects-with-symlinks) erreichen, ob die Datei oder ihr Verzeichnis der Link ist, schreiben Sie das Muster gegen einen der beiden Pfade: den Pfad der Datei unter `.claude/rules/` oder ihr Link-Ziel. Ein Muster, das zu einem der beiden Pfade passt, schließt die Datei aus. Vor v2.1.239 schloss nur ein Muster, das zum Link-Ziel passte, die Datei aus.

342 349 

343Verwaltete Richtlinien-CLAUDE.md-Dateien können nicht ausgeschlossen werden. Dies stellt sicher, dass organisationsweite Anweisungen unabhängig von individuellen Einstellungen immer gelten.

344 

345## AGENTS.md350## AGENTS.md

346 351 

347Claude Code kann [`AGENTS.md`](/docs/de/glossary#agents-md) als Ihre Projektanweisungen lesen, daher funktioniert ein Repository, das bereits für andere Codierungs-Agenten eingerichtet ist, ohne dass Sie eine `CLAUDE.md`, einen Import oder eine Einstellung hinzufügen müssen. Diese Tabelle zeigt, was Claude standardmäßig für jede Kombination von Anweisungsdateien in Ihrem Repository liest:352Claude Code kann [`AGENTS.md`](/docs/de/glossary#agents-md) als Ihre Projektanweisungen lesen, daher funktioniert ein Repository, das bereits für andere Codierungs-Agenten eingerichtet ist, ohne dass Sie eine `CLAUDE.md`, einen Import oder eine Einstellung hinzufügen müssen. Diese Tabelle zeigt, was Claude standardmäßig für jede Kombination von Anweisungsdateien in Ihrem Repository liest:

model-config.md +6 −2

Details

441 441 

442Ihre Organisation kann die [Anstrengungsstufe](#adjust-effort-level) auf zwei Wege begrenzen. Bei einem Claude Enterprise-Plan legen Organisationsadministratoren Anstrengungsgrenzen pro Rolle fest, wie unten beschrieben. Bei jedem Plan und jedem Anbieter, einschließlich Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, begrenzt die verwaltete Einstellung [`maxEffortLevel`](/docs/de/settings-reference#maxeffortlevel) die Anstrengung stattdessen auf dem Client. Wenn beide auf ein Modell zutreffen, gilt die niedrigere Obergrenze.442Ihre Organisation kann die [Anstrengungsstufe](#adjust-effort-level) auf zwei Wege begrenzen. Bei einem Claude Enterprise-Plan legen Organisationsadministratoren Anstrengungsgrenzen pro Rolle fest, wie unten beschrieben. Bei jedem Plan und jedem Anbieter, einschließlich Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, begrenzt die verwaltete Einstellung [`maxEffortLevel`](/docs/de/settings-reference#maxeffortlevel) die Anstrengung stattdessen auf dem Client. Wenn beide auf ein Modell zutreffen, gilt die niedrigere Obergrenze.

443 443 

444Organisationsadministratoren in Claude Enterprise-Plänen können eine maximale [Anstrengungsstufe](#adjust-effort-level) pro Modell für jede benutzerdefinierte Rolle festlegen, zusammen mit Rollenbeschränkungen auf [Organisationsmodellebene](#organization-model-restrictions). Stufen über der Obergrenze werden nicht in der `/effort`-Auswahl angeboten, und das Benennen einer höheren Stufe mit `--effort` oder `/effort` wird stattdessen mit der Obergrenze ausgeführt. In interaktiven Sitzungen und einfachen Text-`--print`-Läufen warnt eine Meldung vor den angeforderten und angewendeten Stufen; bei `json`- oder `stream-json`-Ausgabe oder in Hintergrund-Agenten wird die Begrenzung stillschweigend angewendet. Obergrenzen gelten pro Modell, daher kann der Wechsel von Modellen ändern, welche Stufen verfügbar sind. Wenn mehrere Ihrer Rollen dasselbe Modell gewähren, gilt die am wenigsten restriktive Obergrenze. Erfordert Claude Code v2.1.195 oder später.444Admins der Organisation in Claude Enterprise-Plänen können für jede benutzerdefinierte Rolle eine maximale [Effort-Stufe](#adjust-effort-level) pro Modell festlegen, zusammen mit [Modellbeschränkungen der Organisation](#organization-model-restrictions) auf Rollenebene. Erfordert Claude Code v2.1.195 oder später.

445 

446* Stufen über der Obergrenze werden nicht in der `/effort`-Auswahl angeboten, und das Benennen einer höheren Stufe mit `--effort` oder `/effort` wird stattdessen mit der Obergrenze ausgeführt. Wenn Sie einen einfachen Text-`--print`-Lauf mit `--effort` über der Obergrenze starten, nennt eine Warnung auf stderr die angeforderte und die angewendete Stufe. In interaktiven Sitzungen, bei `json`- oder `stream-json`-Ausgabe oder in Hintergrund-Agenten wird diese Warnung stattdessen in das [Debug-Log](/docs/de/errors#configuration-warnings) geschrieben.

447* Obergrenzen gelten pro Modell, daher kann der Wechsel von Modellen ändern, welche Stufen verfügbar sind.

448* Wenn mehrere Ihrer Rollen dasselbe Modell gewähren, gilt die am wenigsten restriktive Obergrenze.

445 449 

446Anstrengungsgrenzen werden zusammen mit [Organisationsmodellbeschränkungen](#organization-model-restrictions) bereitgestellt und erreichen dieselben Sitzungen.450Anstrengungsgrenzen werden zusammen mit [Organisationsmodellbeschränkungen](#organization-model-restrictions) bereitgestellt und erreichen dieselben Sitzungen.

447 451 


843* Wenn Claude Code einen Anbieter oder eine benutzerdefinierte Schreibweise nicht zu einem Modell auflösen kann, das es erkennt, und die ID kein `[1m]` enthält, wird die Variable direkt angewendet und die proaktive Komprimierung wird bei dem deklarierten Fenster fortgesetzt.847* Wenn Claude Code einen Anbieter oder eine benutzerdefinierte Schreibweise nicht zu einem Modell auflösen kann, das es erkennt, und die ID kein `[1m]` enthält, wird die Variable direkt angewendet und die proaktive Komprimierung wird bei dem deklarierten Fenster fortgesetzt.

844* Wenn Claude Code einen Anbieter oder eine benutzerdefinierte Schreibweise nicht zu einem Modell auflösen kann, das es erkennt, und die ID enthält `[1m]`, in beliebiger Schreibweise, nimmt Claude Code ein 1M-Fenster dafür an und die Variable wird nicht von selbst angewendet. Um das Fenster zu korrigieren und gleichzeitig die proaktive Komprimierung beizubehalten, setzen Sie auch [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars). Mit dieser Variable gesetzt, dimensioniert Claude Code die ID wie dieselbe Schreibweise ohne `[1m]`, daher wird `CLAUDE_CODE_MAX_CONTEXT_TOKENS` angewendet, wenn es auf diese ungetaggte Schreibweise angewendet würde.848* Wenn Claude Code einen Anbieter oder eine benutzerdefinierte Schreibweise nicht zu einem Modell auflösen kann, das es erkennt, und die ID enthält `[1m]`, in beliebiger Schreibweise, nimmt Claude Code ein 1M-Fenster dafür an und die Variable wird nicht von selbst angewendet. Um das Fenster zu korrigieren und gleichzeitig die proaktive Komprimierung beizubehalten, setzen Sie auch [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars). Mit dieser Variable gesetzt, dimensioniert Claude Code die ID wie dieselbe Schreibweise ohne `[1m]`, daher wird `CLAUDE_CODE_MAX_CONTEXT_TOKENS` angewendet, wenn es auf diese ungetaggte Schreibweise angewendet würde.

845 849 

846 Mit einem deklarierten Fenster über 200K zeigt Claude Code dann eine [Startwarnung](/docs/de/errors#the-200k-limit-isnt-enforced) an, dass das 200K-Limit nicht erzwungen wird. Die Warnung ist in dieser Konfiguration zu erwarten.850 Mit einem deklarierten Fenster über 200K ist die Warnung, dass [das 200K-Limit nicht erzwungen wird](/docs/de/errors#the-200k-limit-isnt-enforced), in dieser Konfiguration zu erwarten.

847* Wenn die ID zu einem Modell aufgelöst wird, das Claude Code erkennt, oder die ID ein bloßer `claude-`-Name ohne Suffix ist, das Claude Code entfernen kann, in beliebiger Schreibweise, wird die Variable nur wirksam, wenn auch [`DISABLE_COMPACT`](/docs/de/env-vars) gesetzt ist, was alle Komprimierung deaktiviert.851* Wenn die ID zu einem Modell aufgelöst wird, das Claude Code erkennt, oder die ID ein bloßer `claude-`-Name ohne Suffix ist, das Claude Code entfernen kann, in beliebiger Schreibweise, wird die Variable nur wirksam, wenn auch [`DISABLE_COMPACT`](/docs/de/env-vars) gesetzt ist, was alle Komprimierung deaktiviert.

848 852 

849 Beispielsweise löst eine ID, die einen Claude-Modellnamen enthält, den Claude Code kennt, wie `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0`, oder das datierte `claude-sonnet-4-5@20250929`, zu diesem Modell auf. Dies umfasst IDs, die auch `[1m]` enthalten: Claude Code löst `claude-opus-4-8[1m]` zu Opus 4.8 auf, auch wenn `CLAUDE_CODE_DISABLE_1M_CONTEXT` gesetzt ist.853 Beispielsweise löst eine ID, die einen Claude-Modellnamen enthält, den Claude Code kennt, wie `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0`, oder das datierte `claude-sonnet-4-5@20250929`, zu diesem Modell auf. Dies umfasst IDs, die auch `[1m]` enthalten: Claude Code löst `claude-opus-4-8[1m]` zu Opus 4.8 auf, auch wenn `CLAUDE_CODE_DISABLE_1M_CONTEXT` gesetzt ist.

Details

220| `claude.ai` | claude.ai-Kontoauthentifizierung |220| `claude.ai` | claude.ai-Kontoauthentifizierung |

221| `claude.com` | claude.ai-Kontoanmeldung öffnet eine `claude.com`-Seite im Browser, die zu `claude.ai` umleitet; vorab genehmigte WebFetch-Dokumentationssuchen erreichen diesen Host auch von der CLI aus |221| `claude.com` | claude.ai-Kontoanmeldung öffnet eine `claude.com`-Seite im Browser, die zu `claude.ai` umleitet; vorab genehmigte WebFetch-Dokumentationssuchen erreichen diesen Host auch von der CLI aus |

222| `platform.claude.com` | Anthropic Console-Kontoauthentifizierung. OAuth-Token-Austausch, Aktualisierung und Widerruf gehen auch zu diesem Host für claude.ai-Konten, daher erfordern sowohl Console- als auch claude.ai-Anmeldungen ihn |222| `platform.claude.com` | Anthropic Console-Kontoauthentifizierung. OAuth-Token-Austausch, Aktualisierung und Widerruf gehen auch zu diesem Host für claude.ai-Konten, daher erfordern sowohl Console- als auch claude.ai-Anmeldungen ihn |

223| `sso.claude.com` | Teil des Browser-Anmeldeablaufs für Organisationen, die Single Sign-On (SSO) verwenden. Wenn ein Proxy diesen Host blockiert, können diese Anmeldungen fehlschlagen |

223| `mcp-proxy.anthropic.com` | [MCP-Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai), einschließlich Konnektoren, die ein Organisationsadministrator konfiguriert. Der Konnektordatenverkehr wird durch diesen Proxy geleitet; Konnektoren sind standardmäßig für claude.ai-authentifizierte Benutzer aktiviert. Um Claude Code daran zu hindern, sie abzurufen, setzen Sie [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/de/env-vars) oder die Einstellung [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) |224| `mcp-proxy.anthropic.com` | [MCP-Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai), einschließlich Konnektoren, die ein Organisationsadministrator konfiguriert. Der Konnektordatenverkehr wird durch diesen Proxy geleitet; Konnektoren sind standardmäßig für claude.ai-authentifizierte Benutzer aktiviert. Um Claude Code daran zu hindern, sie abzurufen, setzen Sie [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/de/env-vars) oder die Einstellung [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) |

224| `downloads.claude.ai` | Plugin-Executable-Downloads; nativer Installer, nativer Auto-Updater und Versionsprüfungen |225| `downloads.claude.ai` | Plugin-Executable-Downloads; nativer Installer, nativer Auto-Updater und Versionsprüfungen |

225| `storage.googleapis.com` | Plugin-Installationszähler und Metadaten, die in `/plugin` angezeigt werden |226| `storage.googleapis.com` | Plugin-Installationszähler und Metadaten, die in `/plugin` angezeigt werden |

overview.md +5 −5

Details

22 22 

23**macOS, Linux, WSL:**23**macOS, Linux, WSL:**

24 24 

25```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}25```bash theme={null}

26curl -fsSL https://claude.ai/install.sh | bash26curl -fsSL https://claude.ai/install.sh | bash

27```27```

28 28 


30 30 

31**Windows PowerShell:**31**Windows PowerShell:**

32 32 

33```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}33```powershell theme={null}

34irm https://claude.ai/install.ps1 | iex34irm https://claude.ai/install.ps1 | iex

35```35```

36 36 

37**Windows CMD:**37**Windows CMD:**

38 38 

39```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}39```batch theme={null}

40curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd40curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41```41```

42 42 


54 54 

55**Homebrew**55**Homebrew**

56 56 

57```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57```bash theme={null}

58brew install --cask claude-code58brew install --cask claude-code

59```59```

60 60 


66 66 

67**WinGet**67**WinGet**

68 68 

69```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}69```powershell theme={null}

70winget install Anthropic.ClaudeCode70winget install Anthropic.ClaudeCode

71```71```

72 72 

Details

172 172 

173Beobachten Sie die Statusleiste in diesem Clip einer Sitzung, die im Auto-Modus gestartet wurde. Jedes Mal, wenn Sie `Shift+Tab` drücken, wechselt sie von `auto mode on` zu `manual mode on`, `accept edits on`, `plan mode on` und zurück zu `auto mode on`.173Beobachten Sie die Statusleiste in diesem Clip einer Sitzung, die im Auto-Modus gestartet wurde. Jedes Mal, wenn Sie `Shift+Tab` drücken, wechselt sie von `auto mode on` zu `manual mode on`, `accept edits on`, `plan mode on` und zurück zu `auto mode on`.

174 174 

175<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/oa7CKjMeIChox26S/images/permission-modes-cycle-light.mp4?fit=max&auto=format&n=oa7CKjMeIChox26S&q=85&s=198ca90aeb2e3675b3d01b7d686aab0b" aria-label="Die Statusleiste unter dem Claude Code-Prompt ändert sich bei jedem Drücken von Shift+Tab: auto mode on, manual mode on, accept edits on, plan mode on, dann wieder auto mode on." />175<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/tA-x-5L2YsYSVdee/images/permission-modes-cycle-light.mp4?fit=max&auto=format&n=tA-x-5L2YsYSVdee&q=85&s=3927dd62d59b01efd81b3578f2a6f971" aria-label="Die Statusleiste unter dem Claude Code-Prompt ändert sich bei jedem Drücken von Shift+Tab: auto mode on, manual mode on, accept edits on, plan mode on, dann wieder auto mode on." />

176 176 

177Nicht jeder Modus ist im Standard-Zyklus enthalten:177Nicht jeder Modus ist im Standard-Zyklus enthalten:

178 178 


236* **Auto**: wird angezeigt, wenn [Auto-Modus verfügbar ist](#eliminate-prompts-with-auto-mode)236* **Auto**: wird angezeigt, wenn [Auto-Modus verfügbar ist](#eliminate-prompts-with-auto-mode)

237* **Bypass permissions**: erfordert den Schalter **Allow bypass permissions mode** in den Desktop-Einstellungen bei Pro- und Max-Plänen; bei Team- und Enterprise-Plänen wird dies stattdessen durch die Organisationsrichtlinie gesteuert237* **Bypass permissions**: erfordert den Schalter **Allow bypass permissions mode** in den Desktop-Einstellungen bei Pro- und Max-Plänen; bei Team- und Enterprise-Plänen wird dies stattdessen durch die Organisationsrichtlinie gesteuert

238 238 

239Die Registerkarte Cowork verwendet diese Modi nicht. Cowork hat seine eigenen Berechtigungsmodi, die separat aktiviert werden, und die Registerkarte Cowork zeigt überhaupt keinen Moduswahlschalter, bis ein Modus über seinen Standard für Ihr Konto aktiviert wird. Siehe die [Cowork-Dokumentation](https://claude.com/docs/cowork/overview).239Cowork verwendet diese Modi nicht. Es hat seine eigenen Berechtigungsmodi, die separat aktiviert werden, und zeigt überhaupt keinen Moduswahlschalter an, bis ein Modus über seinen Standard hinaus für Ihr Konto aktiviert wird. Siehe die [Cowork-Dokumentation](https://claude.com/docs/cowork/overview).

240 240 

241Für Desktop-spezifische Details siehe [Wählen Sie einen Berechtigungsmodus](/docs/de/desktop#choose-a-permission-mode) im Desktop-Leitfaden.241Für Desktop-spezifische Details siehe [Wählen Sie einen Berechtigungsmodus](/docs/de/desktop#choose-a-permission-mode) im Desktop-Leitfaden.

242 242 


579>579>

580> Ein von Ihnen installierter [Mod](/docs/de/plugins/mods/overview), der `tool.check` verarbeitet, kann ebenfalls eine Aktion genehmigen. Für die Fälle, in denen seine Genehmigung nicht an Ihren Regeln und Hooks vorbeikommt, siehe [Berechtigungen mit Hooks erweitern](/docs/de/permissions#precedence-among-rules-hooks-and-mods).580> Ein von Ihnen installierter [Mod](/docs/de/plugins/mods/overview), der `tool.check` verarbeitet, kann ebenfalls eine Aktion genehmigen. Für die Fälle, in denen seine Genehmigung nicht an Ihren Regeln und Hooks vorbeikommt, siehe [Berechtigungen mit Hooks erweitern](/docs/de/permissions#precedence-among-rules-hooks-and-mods).

581>581>

582> In der VS Code-Erweiterung hängt die Art, wie Browser-Aktionen von [Claude in Chrome](/docs/de/chrome) genehmigt werden, davon ab, wie die Sitzung mit dem Browser verbunden ist: siehe [Berechtigungsabfragen in VS Code-Sitzungen](/docs/de/chrome#permission-prompts-in-vs-code-sessions).582> Wie Browser-Aktionen von [Claude in Chrome](/docs/de/chrome) in der VS Code-Erweiterung genehmigt werden, erfahren Sie unter [Berechtigungsabfragen in VS Code-Sitzungen](/docs/de/chrome#permission-prompts-in-vs-code-sessions).

583>583>

584> Beim Wechsel in den Auto-Modus werden breite Allow-Regeln, die beliebige Codeausführung gewähren, verworfen:584> Beim Wechsel in den Auto-Modus werden breite Allow-Regeln, die beliebige Codeausführung gewähren, verworfen:

585>585>


633claude --permission-mode dontAsk633claude --permission-mode dontAsk

634```634```

635 635 

636## Alle Überprüfungen mit bypassPermissions-Modus überspringen636## Alle Prüfungen mit dem bypassPermissions-Modus überspringen

637 637 

638Der `bypassPermissions`-Modus deaktiviert Berechtigungsaufforderungen und Sicherheitsüberprüfungen, sodass Tool-Aufrufe sofort ausgeführt werden, einschließlich Schreibvorgänge in [geschützte Pfade](#protected-paths).638Der Modus `bypassPermissions` deaktiviert Berechtigungsabfragen und Sicherheitsprüfungen, sodass Tool-Aufrufe sofort ausgeführt werden, einschließlich Schreibvorgängen in [geschützte Pfade](#protected-paths).

639 639 

640Bei den [Aktionen, die kein Modus automatisch genehmigt](#actions-no-mode-auto-approves), wird auch in diesem Modus weiterhin nachgefragt. Das Lesen des [öffentlichen Artefakts einer anderen Organisation](/docs/de/artifacts#read-an-artifact-shared-with-you) erfordert Ihre Genehmigung, und dieser Modus fragt nicht danach, daher kann Claude ein solches Artefakt nicht lesen. Die [Remove-Item in PowerShell](#remove-item-in-powershell) Verweigerungen gelten auch in diesem Modus.640Bei den [Aktionen, die kein Modus automatisch genehmigt](#actions-no-mode-auto-approves), wird auch in diesem Modus nachgefragt. Das Lesen eines [öffentlichen Artefakts einer anderen Organisation](/docs/de/artifacts#read-an-artifact-shared-with-you) erfordert Ihre Genehmigung, und dieser Modus fragt nicht danach, daher kann Claude ein solches Artefakt nicht lesen. Die Ablehnungen für [Remove-Item in PowerShell](#remove-item-in-powershell) gelten ebenfalls in diesem Modus.

641 641 

642Zwei [Cross-Session-Messaging](/docs/de/cross-session-messaging) Schutzmaßnahmen gelten weiterhin in diesem Modus und in interaktiven Terminal-Plan-Mode-Sitzungen, in denen Bypass-Berechtigungen verfügbar sind:642Zwei Schutzmaßnahmen für [sitzungsübergreifende Nachrichten](/docs/de/cross-session-messaging) gelten weiterhin in diesem Modus sowie in interaktiven Terminal-Sitzungen im Plan-Modus, in denen die Umgehung von Berechtigungen verfügbar ist:

643 643 

644* Die [`isolatePeerMachines`](/docs/de/settings-reference#isolatepeermachines) Genehmigungsaufforderung für Nachrichten an Ihre Sitzungen über diese Maschine hinaus wird weiterhin angezeigt.644* Die Genehmigungsabfrage von [`isolatePeerMachines`](/docs/de/settings-reference#isolatepeermachines) für Nachrichten an Ihre Sitzungen außerhalb dieses Rechners wird weiterhin angezeigt.

645* Wenn kein [`crossSessionInbound`](/docs/de/cross-session-messaging#control-inbound-messages) Wert zutrifft, hält Claude Code eine eingehende Nachricht von einer anderen Ihrer Sitzungen für Ihre Genehmigung und liefert ohne Fragen nur, wenn die sendende Sitzung sich selbst als auch Berechtigungsaufforderungen umgehend identifiziert. Wenn Sie den Berechtigungsmodus verlassen, während Nachrichten gehalten werden, wendet Claude Code die eingehenden Regeln erneut an und liefert jede gehaltene Nachricht, die sie jetzt akzeptieren.645* Wenn kein [`crossSessionInbound`](/docs/de/cross-session-messaging#control-inbound-messages)-Wert zutrifft, hält Claude Code eine eingehende Nachricht aus einer anderen Ihrer Sitzungen zur Genehmigung durch Sie zurück und stellt sie nur dann ohne Nachfrage zu, wenn sich die sendende Sitzung als eine Sitzung ausweist, die ebenfalls Berechtigungsabfragen überspringt. Wenn Sie den Berechtigungsmodus verlassen, während Nachrichten zurückgehalten werden, wendet Claude Code die Regeln für eingehende Nachrichten erneut an und stellt alle zurückgehaltenen Nachrichten zu, die diese Regeln nun zulassen.

646 646 

647In interaktiven Terminal-Sitzungen mit verfügbaren Bypass-Berechtigungen erzwingt Claude Code auch nicht [Plan-Mode's](#analyze-before-you-edit-with-plan-mode) Blockierungen. Claude wird immer noch angewiesen, ohne Bearbeitung zu planen, aber ein Dateibearbeitungs- oder Shell-Befehl, den es während der Planung versucht, läuft ohne Aufforderung. Explizite [Ask-Regeln](/docs/de/permissions#manage-permissions) und `rm` und `rmdir` Löschungen, die auf einen [kritischen Pfad](#critical-paths) abzielen, fordern weiterhin auf.647In interaktiven Terminal-Sitzungen mit verfügbarer Umgehung von Berechtigungen setzt Claude Code außerdem die Sperren des [Plan-Modus](#analyze-before-you-edit-with-plan-mode) nicht durch. Claude wird weiterhin angewiesen, ohne Bearbeitungen zu planen, aber eine Dateibearbeitung oder ein Shell-Befehl, den Claude während der Planung versucht, wird ohne Nachfrage ausgeführt. Bei expliziten [Ask-Regeln](/docs/de/permissions#manage-permissions) sowie bei Löschvorgängen mit `rm` und `rmdir`, die auf einen [kritischen Pfad](#critical-paths) abzielen, wird weiterhin nachgefragt.

648 648 

649Der Plan-Mode behält seine Blockierungen überall dort bei, wo Claude Code ohne interaktives Terminal läuft, einschließlich [nicht-interaktiver Ausführungen](/docs/de/headless) mit `-p`, [Agent SDK](/docs/de/agent-sdk/permissions#plan-mode-plan) Sitzungen und Unterhaltungen im Chat-Panel der [VS Code-Erweiterung](/docs/de/vs-code). Dort macht `--allow-dangerously-skip-permissions` `bypassPermissions` später auswählbar.649Der Plan-Modus behält seine Sperren überall dort bei, wo Claude Code ohne interaktives Terminal ausgeführt wird, einschließlich [nicht interaktiver Ausführungen](/docs/de/headless) mit `-p`, Sitzungen mit dem [Agent SDK](/docs/de/agent-sdk/permissions#plan-mode-plan) und Konversationen im Chat-Bereich der [VS Code-Erweiterung](/docs/de/vs-code). Dort macht `--allow-dangerously-skip-permissions` den Modus `bypassPermissions` später auswählbar.

650 650 

651> [!WARNING]651> [!WARNING]

652>652>

653> Verwenden Sie diesen Modus nur in isolierten Umgebungen wie Containern, VMs oder Dev-Containern ohne Internetzugang, in denen Claude Code Ihr Host-System nicht beschädigen kann.653> Verwenden Sie diesen Modus nur in isolierten Umgebungen wie Containern, VMs oder Dev-Containern ohne Internetzugang, in denen Claude Code Ihr Hostsystem nicht beschädigen kann.

654 654 

655Sie können `bypassPermissions` nicht aus einer Sitzung eingeben, die Sie ohne ihn gestartet haben. Aktivieren Sie es beim Start mit [`permissions.defaultMode: "bypassPermissions"`](/docs/de/settings-reference#permissions-defaultmode) oder mit einem aktivierenden Flag:655Sie können `bypassPermissions` nicht aus einer Sitzung heraus aktivieren, die Sie ohne diese Option gestartet haben. Aktivieren Sie den Modus beim Start mit [`permissions.defaultMode: "bypassPermissions"`](/docs/de/settings-reference#permissions-defaultmode) oder mit einem entsprechenden Flag:

656 656 

657```bash theme={null}657```bash theme={null}

658claude --permission-mode bypassPermissions658claude --permission-mode bypassPermissions


660 660 

661Das Flag `--dangerously-skip-permissions` ist gleichwertig.661Das Flag `--dangerously-skip-permissions` ist gleichwertig.

662 662 

663Claude Code verweigert `bypassPermissions` in einer Sitzung, die Sie mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten. `--restricted` erfordert Claude Code v2.1.248 oder später.663Claude Code lehnt `bypassPermissions` in einer Sitzung ab, die Sie mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten. `--restricted` erfordert Claude Code v2.1.248 oder höher.

664 664 

665Wenn Sie zum ersten Mal eine interaktive Sitzung mit aktiviertem Modus starten, zeigt Claude Code einen Warnungsdialog, der Sie auffordert, die Verantwortung für Aktionen ohne Berechtigungsprüfungen zu übernehmen:665Wenn Sie zum ersten Mal eine interaktive Sitzung mit aktiviertem Modus starten, zeigt Claude Code einen Warndialog an, in dem Sie gebeten werden, die Verantwortung für Aktionen zu übernehmen, die ohne Berechtigungsprüfungen ausgeführt werden:

666 666 

667* **Wenn Sie akzeptieren**: Claude Code setzt `skipDangerousModePermissionPrompt` auf `true` in `~/.claude/settings.json`, sodass spätere Sitzungen den Dialog überspringen. Um den Dialog erneut zu sehen, entfernen Sie den Schlüssel aus dieser Datei oder setzen Sie ihn auf `false`. Die [`skipDangerousModePermissionPrompt` Referenz](/docs/de/settings-reference#skipdangerousmodepermissionprompt) listet die anderen Einstellungsdateien auf, in denen Sie oder Ihre Organisation ihn setzen können.667* **Wenn Sie zustimmen**: Claude Code setzt `skipDangerousModePermissionPrompt` in `~/.claude/settings.json` auf `true`, sodass spätere Sitzungen den Dialog überspringen. Um den Dialog erneut anzuzeigen, entfernen Sie den Schlüssel aus dieser Datei oder setzen Sie ihn auf `false`. Die [Referenz zu `skipDangerousModePermissionPrompt`](/docs/de/settings-reference#skipdangerousmodepermissionprompt) listet die weiteren Einstellungsdateien auf, in denen Sie oder Ihre Organisation ihn festlegen können.

668* **Wenn Sie ablehnen**: Claude Code wird beendet.668* **Wenn Sie ablehnen**: Claude Code wird beendet.

669 669 

670Im [nicht interaktiven Modus](/docs/de/headless) wird kein Dialog angezeigt. Eine [Hintergrund-Sitzung](/docs/de/agent-view) berücksichtigt Ihre Zustimmung, wenn diese in Benutzer- oder verwalteten Einstellungen gespeichert ist:670Im [nicht interaktiven Modus](/docs/de/headless) wird kein Dialog angezeigt.

671 671 

672* Ohne gespeicherte Zustimmung wird `claude --bg --permission-mode bypassPermissions` verweigert, bis Sie den Dialog in einer interaktiven Sitzung akzeptieren.672Eine [Hintergrundsitzung](/docs/de/agent-view) berücksichtigt Ihre Zustimmung, wenn sie in den Benutzer- oder verwalteten Einstellungen gespeichert ist:

673* Wenn `skipDangerousModePermissionPrompt` nur in `.claude/settings.local.json` gesetzt ist, startet die Hintergrund-Sitzung, ignoriert die Bypass-Anfrage und heftet den Hinweis `Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true` an. Fügen Sie diesen Schlüssel zu `~/.claude/settings.json` hinzu und starten Sie dann eine neue Hintergrund-Sitzung. Die Sitzung, die den Hinweis anzeigt, läuft weiterhin:

674 * Wenn `--allow-dangerously-skip-permissions` ignoriert wurde, ist `bypassPermissions` nicht in ihrem `Shift+Tab`-Zyklus enthalten.

675 * Wenn `--permission-mode bypassPermissions` oder `--dangerously-skip-permissions` ignoriert wurde, startet die Sitzung stattdessen im Manual-Modus.

676 673 

677Auf Linux und macOS weigert sich Claude Code, im `bypassPermissions`-Modus zu starten, wenn es als Root oder unter `sudo` ausgeführt wird:674* Ist keine Zustimmung gespeichert, wird `claude --bg --permission-mode bypassPermissions` abgelehnt. Stimmen Sie dem Dialog zuerst in einer interaktiven Sitzung zu.

675* Ist `skipDangerousModePermissionPrompt` nur in `.claude/settings.local.json` gesetzt, startet die Hintergrundsitzung, wobei [die Umgehungsanfrage ignoriert wird](#bypass-permissions-ignored-in-a-background-session):

676 

677 * Wird `--allow-dangerously-skip-permissions` ignoriert, ist `bypassPermissions` nicht im `Shift+Tab`-Zyklus enthalten.

678 * Wird `--permission-mode bypassPermissions` oder `--dangerously-skip-permissions` ignoriert, startet die Sitzung stattdessen im Manual-Modus.

679 

680 Fügen Sie `"skipDangerousModePermissionPrompt": true` zu `~/.claude/settings.json` hinzu und starten Sie dann eine neue Hintergrundsitzung.

681 

682Unter Linux und macOS verweigert Claude Code den Start im Modus `bypassPermissions`, wenn es als root oder unter `sudo` ausgeführt wird:

678 683 

679```text theme={null}684```text theme={null}

680--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons685--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

681```686```

682 687 

683Die Überprüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container zu laufen, verwenden Sie die [Dev-Container](/docs/de/devcontainer) Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.688Diese Prüfung wird innerhalb einer erkannten Sandbox automatisch übersprungen. Um Claude Code autonom in einem Container auszuführen, verwenden Sie die [Dev-Container](/docs/de/devcontainer)-Konfiguration, die Claude Code als Nicht-root-Benutzer ausführt.

684 689 

685[Cloud-Sitzungen](/docs/de/claude-code-on-the-web) berücksichtigen `defaultMode: "bypassPermissions"` oder `"dontAsk"` aus Ihren Einstellungsdateien nicht, daher können die eingecheckten Einstellungen eines Repositorys keine Cloud-Sitzung im Bypass-Permissions-Modus starten. Die Einstellung wird stillschweigend ignoriert und die Sitzung startet im Berechtigungsmodus, der im Modusmenü angezeigt wird. Siehe [Berechtigungsmodi wechseln](#switch-permission-modes), welche Modi Cloud-Sitzungen bieten.690[Cloud-Sitzungen](/docs/de/claude-code-on-the-web) berücksichtigen `defaultMode: "bypassPermissions"` oder `"dontAsk"` aus Ihren Einstellungsdateien nicht, sodass die eingecheckten Einstellungen eines Repositorys keine Cloud-Sitzung im Modus zur Umgehung von Berechtigungen starten können. Die Einstellung wird stillschweigend ignoriert, und die Sitzung startet stattdessen in dem Berechtigungsmodus, der im Modus-Dropdown angezeigt wird. Unter [Berechtigungsmodi wechseln](#switch-permission-modes) erfahren Sie, welche Modi Cloud-Sitzungen anbieten.

686 691 

687> [!WARNING]692> [!WARNING]

688>693>

689> `bypassPermissions` bietet keinen Schutz vor Prompt-Injection oder unbeabsichtigten Aktionen. Verwenden Sie stattdessen den [Auto-Modus](#eliminate-prompts-with-auto-mode) für Hintergrund-Sicherheitsüberprüfungen mit deutlich weniger Berechtigungsaufforderungen. Administratoren können diesen Modus blockieren, indem sie `permissions.disableBypassPermissionsMode` auf `"disable"` in [verwalteten Einstellungen](/docs/de/managed-settings) setzen.694> `bypassPermissions` bietet keinen Schutz vor Prompt-Injection oder unbeabsichtigten Aktionen. Für Sicherheitsprüfungen im Hintergrund mit deutlich weniger Berechtigungsabfragen verwenden Sie stattdessen den [Auto-Modus](#eliminate-prompts-with-auto-mode). Administratoren können diesen Modus blockieren, indem sie `permissions.disableBypassPermissionsMode` in den [verwalteten Einstellungen](/docs/de/managed-settings) auf `"disable"` setzen.

695 

696### Umgehung von Berechtigungen in einer Hintergrundsitzung ignoriert

697 

698Dieser Hinweis bedeutet, dass die [Hintergrundsitzung](/docs/de/agent-view) Ihre Zustimmung zur [Warnung zur Umgehung von Berechtigungen](#bypass-permissions-acceptance) nicht in den Benutzer- oder verwalteten Einstellungen gefunden hat und daher die beim Start gestellte Umgehungsanfrage ignoriert hat:

699 

700```text theme={null}

701Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true

702```

703 

704Fügen Sie `"skipDangerousModePermissionPrompt": true` zu `~/.claude/settings.json` hinzu und starten Sie dann eine neue Hintergrundsitzung.

705 

706### `claude agents` zeigt die Warnung zur Umgehung von Berechtigungen an, die interaktive Sitzungen überspringen

707 

708Wenn [`claude agents`](/docs/de/agent-view#dispatch-defaults) die [Warnung zur Umgehung von Berechtigungen](#bypass-permissions-acceptance) anzeigt, obwohl Ihre interaktiven Sitzungen sie überspringen, prüfen Sie, ob `skipDangerousModePermissionPrompt` in `.claude/settings.local.json` oder in einer `--settings`-Datei gesetzt ist. Interaktive Sitzungen werten den Schlüssel dort als Ihre Zustimmung zur Warnung, `claude agents` hingegen nicht. Unabhängig davon, ob Sie ihn dort finden, stimmen Sie der Warnung zu, um den Schlüssel zu `~/.claude/settings.json` hinzuzufügen, wo `claude agents` danach sucht.

690 709 

691## Geschützte Pfade710## Geschützte Pfade

692 711 

permissions.md +31 −8

Details

77| :- | :- |77| :- | :- |

78| `default` | Fragt bei der ersten Verwendung jedes Tools nach Berechtigung. In der CLI, den VS Code- und JetBrains-Erweiterungen sowie der Desktop-App als „Manual“ gekennzeichnet, und Claude Code akzeptiert `manual` als Alias |78| `default` | Fragt bei der ersten Verwendung jedes Tools nach Berechtigung. In der CLI, den VS Code- und JetBrains-Erweiterungen sowie der Desktop-App als „Manual“ gekennzeichnet, und Claude Code akzeptiert `manual` als Alias |

79| `acceptEdits` | Akzeptiert automatisch Dateibearbeitungen und häufige Dateisystembefehle wie `mkdir`, `touch`, `mv` und `cp` für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |79| `acceptEdits` | Akzeptiert automatisch Dateibearbeitungen und häufige Dateisystembefehle wie `mkdir`, `touch`, `mv` und `cp` für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |

80| `plan` | Claude liest Dateien und führt schreibgeschützte Shell-Befehle aus, um zu erkunden, bearbeitet aber nicht Ihre Quelldateien; mit [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) verfügbar, genehmigungsklassifizierte Befehle werden auch ausgeführt. In der CLI und der VS Code-Erweiterung als „Plan“ gekennzeichnet |80| `plan` | Claude liest Dateien und führt schreibgeschützte Shell-Befehle aus, um zu erkunden, bearbeitet aber nicht Ihre Quelldateien; wenn der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) verfügbar ist, werden auch vom Klassifizierer genehmigte Befehle ausgeführt. In der CLI und der VS Code-Erweiterung als „Plan“ gekennzeichnet |

81| `auto` | Wird ohne routinemäßige Eingabeaufforderungen ausgeführt; bevor Aktionen wie Shell-Befehle und Netzwerkanfragen ausgeführt werden, überprüft ein Hintergrund-[Klassifizierer](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), dass sie mit Ihrer Anfrage übereinstimmen |81| `auto` | Wird ohne routinemäßige Eingabeaufforderungen ausgeführt; bevor Aktionen wie Shell-Befehle und Netzwerkanfragen ausgeführt werden, überprüft ein Hintergrund-[Klassifizierer](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), dass sie mit Ihrer Anfrage übereinstimmen |

82| `dontAsk` | Lehnt automatisch jeden Aufruf ab, der sonst eine Berechtigungsabfrage auslösen würde, wobei ein von Ihnen installierter [Mod](/docs/de/plugins/mods/overview) einige dieser Aufrufe dennoch genehmigen kann. Dateilesevorgänge in Ihren Arbeitsverzeichnissen und andere Aktionen, die keine Genehmigung benötigen, werden weiterhin ausgeführt, ebenso wie Tools, die über `/permissions` oder `permissions.allow`-Regeln vorab genehmigt wurden. `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, [Lesevorgänge von Netzwerkpfaden](#network-paths) und Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), werden in Sitzungen, in denen diese Einstellung Claude Code erreicht, verweigert, auch wenn Sie diese zugelassen haben |82| `dontAsk` | Lehnt automatisch jeden Aufruf ab, der sonst eine Berechtigungsabfrage auslösen würde, wobei ein von Ihnen installierter [Mod](/docs/de/plugins/mods/overview) einige dieser Aufrufe dennoch genehmigen kann. Dateilesevorgänge in Ihren Arbeitsverzeichnissen und andere Aktionen, die keine Genehmigung benötigen, werden weiterhin ausgeführt, ebenso wie Tools, die über `/permissions` oder `permissions.allow`-Regeln vorab genehmigt wurden. `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, [Lesevorgänge von Netzwerkpfaden](#network-paths) und Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), werden verweigert, auch wenn Sie diese zugelassen haben. Für die Konnektor-Tools gilt das nur, wenn diese Einstellung Claude Code in der jeweiligen Sitzung erreicht |

83| `bypassPermissions` | Überspringt Genehmigungsaufforderungen, außer für die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves) |83| `bypassPermissions` | Überspringt Genehmigungsaufforderungen, außer für die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves) |

84 84 

85> [!WARNING]85> [!WARNING]


202}202}

203```203```

204 204 

205Zulassungsregeln akzeptieren Werkzeugnamen-Globs nur nach einem literalen `mcp__<server>__`-Präfix. Das Server-Segment muss glob-frei sein, damit die Regel einen bestimmten Server benennt, den Sie konfiguriert haben. `mcp__puppeteer__*` gleicht jedes Werkzeug vom `puppeteer`-Server ab, und `mcp__github__get_*` gleicht seine `get_`-Werkzeuge ab. Ein unverankerte Zulassungs-Glob wie `"*"`, `"B*"` oder `"mcp__*"` wird mit einer Warnung übersprungen und genehmigt nichts automatisch.205Zulassungsregeln akzeptieren Werkzeugnamen-Globs nur nach einem literalen `mcp__<server>__`-Präfix. Das Server-Segment muss glob-frei sein, damit die Regel einen bestimmten Server benennt, den Sie konfiguriert haben. `mcp__puppeteer__*` gleicht jedes Werkzeug vom `puppeteer`-Server ab, und `mcp__github__get_*` gleicht seine `get_`-Werkzeuge ab. Ein unverankerter Zulassungs-Glob wie `"*"`, `"B*"` oder `"mcp__*"` wird übersprungen und genehmigt nichts automatisch.

206 206 

207Eine Ablehnungs- oder Anfrage-Regel, deren Werkzeugname mit keinem bekannten Werkzeug übereinstimmt, erzeugt eine Startwarnmeldung, um Tippfehler zu erfassen. Werkzeugnamen, die `_` oder `*` enthalten, sind von der Überprüfung ausgenommen, und ebenso die Namen von Werkzeugen, die Claude Code entfernt hat, wie `TaskOutput`.207Eine Ablehnungs- oder Anfrage-Regel, deren Werkzeugname mit keinem bekannten Werkzeug übereinstimmt, erzeugt eine [Startwarnmeldung](/docs/de/errors#matches-no-tool), um Tippfehler zu erfassen. Werkzeugnamen, die `_` oder `*` enthalten, sind von der Überprüfung ausgenommen, und ebenso die Namen von Werkzeugen, die Claude Code entfernt hat, wie `TaskOutput`.

208 208 

209Das Etikett, das für ein Werkzeug im Transkript und im Berechtigungsdialog angezeigt wird, kann sich vom kanonischen Namen unterscheiden. Beispielsweise hat das Werkzeug mit der Bezeichnung `Stop Task` im Transkript den kanonischen Namen `TaskStop`. Berechtigungsregeln und [Hook-Matcher](/docs/de/hooks) gleichen das Etikett nicht ab, daher passt eine Regel, die als `Stop Task` geschrieben ist, nicht. Für Ablehnungs- und Anfrage-Regeln erfasst die obige Startwarnmeldung die Nichtübereinstimmung. Verwenden Sie die kanonischen Namen, die in der [Werkzeugreferenz](/docs/de/tools-reference) aufgelistet sind.209Das Etikett, das für ein Werkzeug im Transkript und im Berechtigungsdialog angezeigt wird, kann sich vom kanonischen Namen unterscheiden. Beispielsweise hat das Werkzeug mit der Bezeichnung `Stop Task` im Transkript den kanonischen Namen `TaskStop`. Berechtigungsregeln und [Hook-Matcher](/docs/de/hooks) gleichen das Etikett nicht ab, daher passt eine Regel, die als `Stop Task` geschrieben ist, nicht. Für Ablehnungs- und Anfrage-Regeln erfasst die obige Startwarnmeldung die Nichtübereinstimmung. Verwenden Sie die kanonischen Namen, die in der [Werkzeugreferenz](/docs/de/tools-reference) aufgelistet sind.

210 210 


241Eine Präfixregel wie `Bash(watch *)` oder `Bash(find *)` kann die folgenden Befehle nicht automatisch genehmigen, daher wird im Manual-Modus bei ihnen nachgefragt:241Eine Präfixregel wie `Bash(watch *)` oder `Bash(find *)` kann die folgenden Befehle nicht automatisch genehmigen, daher wird im Manual-Modus bei ihnen nachgefragt:

242 242 

243* **Exec-Wrapper**: wie `watch`, `setsid`, `ionice` und `flock`243* **Exec-Wrapper**: wie `watch`, `setsid`, `ionice` und `flock`

244* **`find`**: mit einer Aktion, die Befehle ausführt, Dateien löscht oder Dateien schreibt, wie `-exec`, `-delete` oder `-fprint`, oder mit `-files0-from`, das die zu durchsuchenden Pfade aus einer Datei übernimmt244* **`find`**: mit einer Aktion, die Befehle ausführt, Dateien löscht oder Dateien schreibt, wie `-exec`, `-delete`, `-rm` oder `-fprint`, oder mit `-files0-from`, das die zu durchsuchenden Pfade aus einer Datei übernimmt

245 245 

246Um einen bestimmten Aufruf zu genehmigen, der kein `*` enthält, schreiben Sie eine Regel mit exakter Übereinstimmung für die vollständige Befehlszeichenkette, wie `Bash(find build -type f -delete)`.246Um einen bestimmten Aufruf zu genehmigen, der kein `*` enthält, schreiben Sie eine Regel mit exakter Übereinstimmung für die vollständige Befehlszeichenkette, wie `Bash(find build -type f -delete)`.

247 247 


460 460 

461Grep und Glob durchsuchen das Verzeichnis, zu dem das `path`-Argument aufgelöst wird. Claude Code wendet `Read`-deny-Regeln auf dieses Verzeichnis an.461Grep und Glob durchsuchen das Verzeichnis, zu dem das `path`-Argument aufgelöst wird. Claude Code wendet `Read`-deny-Regeln auf dieses Verzeichnis an.

462 462 

463##### Anhänge über einen Symlink

464 

465Eine `Read`-deny-Regel deckt auch diese Anhänge ab und gleicht jeden davon entweder über den genannten Pfad oder über die Datei ab, zu der er aufgelöst wird. Claude Code lässt einen Anhang aus der Konversation weg, wenn eine Regel ihn abgleicht:

466 

467* **`@`-Erwähnungen**: eine Datei oder ein Verzeichnis, das Sie in Ihrem Prompt erwähnen. Eine abgelehnte Datei hinterlässt nichts in der Konversation, und die [Auflistung eines Verzeichnisses](#read-and-edit) lässt die Namen aus, die eine Regel abdeckt.

468* **Eingefügte Bilder**: ein Bild, dessen Pfad Sie im Terminal in den Prompt einfügen oder hineinziehen

469* **Geänderte Dateien**: eine Datei, die Claude Code erneut liest, nachdem sie sich auf dem Datenträger geändert hat

470* **IDE-Kontext**: der Auswahl- und Kontext geöffneter Dateien, den eine verbundene IDE teilt

471 

472Wenn [`permissions.blockReadsOutsideWorkingDirectories`](/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) aktiviert ist oder in einer [`--restricted`](/docs/de/cli-reference#cli-flags)-Sitzung werden diese Anhänge auch weggelassen, wenn sie von einem Pfad stammen, für den diese Einstellung bzw. dieses Flag Dateilesevorgänge von Claude verweigert.

473 

474Diese Zeile anstelle einer Datei, die Sie per `@` erwähnt haben, bedeutet, dass Claude Code nicht ermitteln konnte, wohin der Pfad führt, zum Beispiel weil seine Symlinks eine Schleife bilden:

475 

476```text theme={null}

477Referenced <path> (not read: could not be examined)

478```

479 

480Claude wird angewiesen, den Pfad stattdessen mit seinen Datei-Tools zu lesen, was gelingen kann, wenn Claude Code lediglich die Zeit für die Untersuchung des Pfads ausgegangen ist.

481 

482Wenn die Symlinks des Pfads nicht aufgelöst werden können, wird dieser Lesevorgang ebenfalls [verweigert](/docs/de/errors#refusing-after-a-symlink-changed); korrigieren Sie daher den Link auf dem Datenträger oder erwähnen Sie die Datei per `@` über einen Pfad, der aufgelöst werden kann.

483 

463##### Schreibvorgänge über einen Symlink484##### Schreibvorgänge über einen Symlink

464 485 

465Wenn der Pfad, den Claude bearbeiten oder schreiben möchte, selbst ein Symlink ist, [verweigern die Edit- und Write-Tools den Schreibvorgang und verweisen Claude auf das Ziel des Links](/docs/de/errors#refusing-after-a-symlink-changed).486Wenn der Pfad, den Claude bearbeiten oder schreiben möchte, selbst ein Symlink ist, [verweigern die Edit- und Write-Tools den Schreibvorgang und verweisen Claude auf das Ziel des Links](/docs/de/errors#refusing-after-a-symlink-changed).


489 510 

490Um Dateien auf einer Netzwerkfreigabe ohne diese Abfrage zu lesen, geben Sie der Freigabe zunächst einen lokalen Pfad:511Um Dateien auf einer Netzwerkfreigabe ohne diese Abfrage zu lesen, geben Sie der Freigabe zunächst einen lokalen Pfad:

491 512 

492* **Windows**: Ordnen Sie die Freigabe einem Laufwerksbuchstaben zu und übergeben Sie das Laufwerk beim Start von Claude Code mit `--add-dir`, wie unter [Arbeitsverzeichnisse](#working-directories) beschrieben513* **Windows**: Ordnen Sie die Freigabe einem Laufwerksbuchstaben zu und übergeben Sie das Laufwerk beim Start von Claude Code mit `--add-dir`, wie unter [Arbeitsverzeichnisse](#working-directories) beschrieben. Bei Lesevorgängen unter einem Laufwerk, das Sie später mit `/add-dir` hinzufügen oder in einer Einstellungsdatei unter `additionalDirectories` aufführen, wird weiterhin nachgefragt. Um diese Abfragen für eine Freigabe zu beenden, die `Z:` zugeordnet ist, starten Sie in PowerShell eine neue Sitzung mit `claude --add-dir Z:\`.

493* **macOS und Linux**: Hängen Sie die Freigabe unter einem lokalen Pfad ein, etwa einem Verzeichnis unter `/mnt` oder `/Volumes`, und lesen Sie die Dateien von dort, wie unter [Arbeitsverzeichnis ist ein Netzwerkpfad](/docs/de/errors#working-directory-is-a-network-path) beschrieben514* **macOS und Linux**: Hängen Sie die Freigabe unter einem lokalen Pfad ein, etwa einem Verzeichnis unter `/mnt` oder `/Volumes`, und lesen Sie die Dateien von dort, wie unter [Arbeitsverzeichnis ist ein Netzwerkpfad](/docs/de/errors#working-directory-is-a-network-path) beschrieben

494 515 

495### WebFetch516### WebFetch


545 566 

546* **Namen mit Zeichen wie `.` oder Leerzeichen**: Diese Zeichen werden zu `_`, daher schreiben Sie für einen Server, den Sie als `my.server` konfiguriert haben, `mcp__my_server__*`567* **Namen mit Zeichen wie `.` oder Leerzeichen**: Diese Zeichen werden zu `_`, daher schreiben Sie für einen Server, den Sie als `my.server` konfiguriert haben, `mcp__my_server__*`

547* **Server, die ein Plugin bereitstellt**: `<server>` hat die [Plugin-bezogene Form](/docs/de/mcp#plugin-provided-mcp-servers), daher schreiben Sie für den Server `database-tools` in einem Plugin namens `my-plugin` `mcp__plugin_my-plugin_database-tools__*`568* **Server, die ein Plugin bereitstellt**: `<server>` hat die [Plugin-bezogene Form](/docs/de/mcp#plugin-provided-mcp-servers), daher schreiben Sie für den Server `database-tools` in einem Plugin namens `my-plugin` `mcp__plugin_my-plugin_database-tools__*`

548* **Ein `<server>`, der `__` enthält oder auf `_` endet**: Schreiben Sie die Wildcard-Form `mcp__<server>__*` mit dem vollständigen Namen. Für einen Server namens `reports__v2` schreiben Sie `mcp__reports__v2__*`. Das bloße `mcp__reports__v2` und das kürzere `mcp__reports` gleichen seine Tools als allow-Regeln nicht ab, da Claude Code beide als Regeln für einen Server namens `reports` liest569* **Ein `<server>`, der `__` enthält oder auf `_` endet**: Schreiben Sie die Wildcard-Form `mcp__<server>__*` mit dem vollständigen Namen. Für einen Server namens `reports__v2` schreiben Sie `mcp__reports__v2__*`. Das bloße `mcp__reports__v2` und das kürzere `mcp__reports` gleichen seine Tools als allow-Regeln nicht ab, da Claude Code beide als Regeln für einen Server namens `reports` liest.

570 

571 Als deny- oder ask-Regel deckt jedoch jeder dieser beiden Namen auch jedes Tool des Servers `reports__v2` ab. Um nur einen Server namens `reports` abzudecken, schreiben Sie eine Regel pro Tool in der Form `mcp__reports__<tool>` oder benennen Sie einen der Server um.

549 572 

550Wenn Ihre Organisation ein Tool eines [claude.ai-Konnektors](/docs/de/mcp#organization-controls-on-connector-tools) auf `ask` gesetzt hat und diese Einstellung in Ihrer Sitzung bei Claude Code ankommt, werden allow-Regeln für dieses Tool nicht wirksam: Claude Code fragt bei jedem Aufruf nach, auch in den Modi `auto` und `bypassPermissions`. Im `dontAsk`-Modus, der nie nachfragt, verweigert Claude Code den Aufruf stattdessen. Tools von Konnektoren, die Claude Code selbst abruft, erscheinen als `mcp__claude_ai_<server>__<tool>`.573Wenn Ihre Organisation ein Tool eines [claude.ai-Konnektors](/docs/de/mcp#organization-controls-on-connector-tools) auf `ask` gesetzt hat und diese Einstellung in Ihrer Sitzung bei Claude Code ankommt, werden allow-Regeln für dieses Tool nicht wirksam: Claude Code fragt bei jedem Aufruf nach, auch in den Modi `auto` und `bypassPermissions`. Im `dontAsk`-Modus, der nie nachfragt, verweigert Claude Code den Aufruf stattdessen. Tools von Konnektoren, die Claude Code selbst abruft, erscheinen als `mcp__claude_ai_<server>__<tool>`.

551 574 


593 616 

594PreToolUse-Hook-Entscheidungen umgehen keine Berechtigungsregeln. Claude Code evaluiert Deny- und Ask-Regeln unabhängig davon, was ein PreToolUse-Hook zurückgibt: Eine übereinstimmende Deny-Regel blockiert den Aufruf, und eine übereinstimmende Ask-Regel fordert immer noch auf, selbst wenn der Hook `"allow"` oder `"ask"` zurückgegeben hat. Dies bewahrt die Deny-First-Priorität, die in [Berechtigungen verwalten](#manage-permissions) beschrieben ist, einschließlich Deny-Regeln, die in verwalteten Einstellungen festgelegt sind.617PreToolUse-Hook-Entscheidungen umgehen keine Berechtigungsregeln. Claude Code evaluiert Deny- und Ask-Regeln unabhängig davon, was ein PreToolUse-Hook zurückgibt: Eine übereinstimmende Deny-Regel blockiert den Aufruf, und eine übereinstimmende Ask-Regel fordert immer noch auf, selbst wenn der Hook `"allow"` oder `"ask"` zurückgegeben hat. Dies bewahrt die Deny-First-Priorität, die in [Berechtigungen verwalten](#manage-permissions) beschrieben ist, einschließlich Deny-Regeln, die in verwalteten Einstellungen festgelegt sind.

595 618 

596Dieser Vorrang gilt für Hooks in Einstellungsdateien und in der `hooks/hooks.json` eines Plugins. Ein [Mod](/docs/de/plugins/mods/overview), den Sie installieren und der das Ereignis [`tool.check`](/docs/de/plugins/mods/events#approve-or-refuse-a-tool-call-before-the-user-is-asked) verarbeitet, gibt seine Antwort, nachdem die Berechtigungsregeln und die `PreToolUse`-Hooks entschieden haben. Wenn auf dem Computer [verwaltete Einstellungen](/docs/de/settings#check-what-your-organization-enforces) vorhanden sind oder ein Team- oder Enterprise-[`/login`](/docs/de/authentication#authentication-precedence) als Anmeldedaten der Sitzung dient, bleiben diese Ergebnisse standardmäßig bestehen, wenn der Mod einen Aufruf genehmigt:619Dieser Vorrang gilt für Hooks in Einstellungsdateien und in der `hooks/hooks.json` eines Plugins. Ein [Mod](/docs/de/plugins/mods/overview), den Sie installieren und der das Ereignis [`tool.check`](/docs/de/plugins/mods/events#approve-or-refuse-a-tool-call-before-the-user-is-asked) verarbeitet, gibt seine Antwort, nachdem die `PreToolUse`-Hooks ausgeführt wurden. Wenn auf dem Computer [verwaltete Einstellungen](/docs/de/settings#check-what-your-organization-enforces) vorhanden sind oder ein Team- oder Enterprise-[`/login`](/docs/de/authentication#authentication-precedence) als Anmeldedaten der Sitzung dient, bleiben diese Ergebnisse standardmäßig bestehen, wenn der Mod einen Aufruf genehmigt:

597 620 

598* Ein Aufruf, den eine deny-Regel ablehnt, bleibt abgelehnt, und Ihre Organisation kann dies ändern.621* Ein Aufruf, den eine deny-Regel ablehnt, bleibt abgelehnt, und Ihre Organisation kann dies ändern.

599* Bei einem Aufruf, für den eine ask-Regel nachfragen würde, werden Sie weiterhin gefragt.622* Bei einem Aufruf, für den eine ask-Regel nachfragen würde, werden Sie weiterhin gefragt.

Details

211| `$.ui.status(text)` | Eine Zeile unter dem Eingabefeld, die bestehen bleibt, bis Sie sie ändern. Sie beginnt mit `⚠` und dem Namen des Mods, wie in `⚠ my-mod: checks: 3 passing`. |211| `$.ui.status(text)` | Eine Zeile unter dem Eingabefeld, die bestehen bleibt, bis Sie sie ändern. Sie beginnt mit `⚠` und dem Namen des Mods, wie in `⚠ my-mod: checks: 3 passing`. |

212| `$.ui.toast(text)` | Eine Toast-Benachrichtigung mit dem Namen des Mods, die nach einigen Sekunden verschwindet. Im [Vollbild-Rendering](/docs/de/fullscreen) ist sie ein Feld oben rechts, im klassischen Renderer eine Zeile rechts unter dem Eingabefeld. |212| `$.ui.toast(text)` | Eine Toast-Benachrichtigung mit dem Namen des Mods, die nach einigen Sekunden verschwindet. Im [Vollbild-Rendering](/docs/de/fullscreen) ist sie ein Feld oben rechts, im klassischen Renderer eine Zeile rechts unter dem Eingabefeld. |

213| `$.ui.log(text)` | Eine abgeblendete Zeile im Transkript, die Claude nicht liest. Sie beginnt mit `●` und dem Namen des Mods, wie in `● my-mod: build finished`. |213| `$.ui.log(text)` | Eine abgeblendete Zeile im Transkript, die Claude nicht liest. Sie beginnt mit `●` und dem Namen des Mods, wie in `● my-mod: build finished`. |

214| `$.ui.notify(text)` | Eine Benachrichtigung seines Terminals, außerhalb von Claude Code, die so gesendet wird, wie es seine Einstellung [`preferredNotifChannel`](/docs/de/settings-reference#preferrednotifchannel) festlegt. Der Name des Mods ist ihr Titel, sofern Sie keinen nicht leeren `{ title }` übergeben, der so angezeigt wird, wie Sie ihn angeben. |

215 

216`$.ui.notify` ist der einzige dieser Aufrufe, der eine Antwort liefert. Er wird zu `{ isSent: true, channel }` aufgelöst, wenn der Kanal des Benutzers die Benachrichtigung in sein Terminal geschrieben hat. `channel` ist der Wert der Einstellung, über den sie gesendet wurde, etwa `kitty` oder `terminal_bell`. Der Kanal `terminal_bell` lässt die Glocke ertönen und zeigt weder Ihren Text noch den Titel an.

217 

218Andernfalls wird der Aufruf zu `{ isSent: false, reason }` aufgelöst:

219 

220| `reason` | Bedeutung |

221| :- | :- |

222| `disabled` | Der Benutzer hat `preferredNotifChannel` auf `notifications_disabled` gesetzt |

223| `no-channel` | Die Einstellung ist `auto`, und sein Terminal bietet keine Benachrichtigung, die Claude Code senden kann |

224| `no-surface` | Die Sitzung hat kein Terminal, etwa bei einer `-p`-Ausführung, im Agent SDK, in der Desktop-App, in der VS Code-Erweiterung oder in einer Cloud-Sitzung. Ebenfalls die Antwort auf einen Aufruf, der vor dem Start der Sitzung erfolgt, während Ihr Mod geladen wird, sowie auf einen Aufruf, der erfolgt, während Claude Code beendet wird |

225| `refused` | Der Hook eines anderen Mods auf `ui.notify` hat anstelle von Claude Code geantwortet, ohne zu senden |

226 

227Der Aufruf wird abgelehnt statt aufgelöst, wenn `text` kein String ist, wenn der Hook eines anderen Mods auf `ui.notify` `{ deny }` zurückgibt oder wenn das Schreiben in das Terminal fehlschlägt.

228 

229Ihr Mod kann den Kanal nicht wählen, und Claude Code begrenzt nicht, wie oft ein Mod Benachrichtigungen sendet. Die Einstellung des Benutzers ist der einzige Schalter.

230 

231Wenn der Aufruf eine laufende Sitzung erreicht, werden die [`Notification`-Hooks](/docs/de/hooks#notification) des Benutzers mit dem Typ `plugin_notification` ausgeführt. Sie laufen auch dann, wenn die Antwort `disabled` lautet, sowie in einer Sitzung ohne Terminal, in der die Antwort `no-surface` lautet. Für einen Aufruf, der vor dem Start der Sitzung oder während des Beendens von Claude Code erfolgt, läuft kein Hook. Der Hook, aus dem Ihr Mod `$.ui.notify` aufgerufen hat, wird bei diesem Durchlauf ausgelassen, sodass ein `classic.Notification`-Hook, der eine Benachrichtigung sendet, für seine eigene Benachrichtigung nicht erneut aufgerufen wird.

232 

233Ein Terminal meldet nicht, ob es die Benachrichtigung angezeigt hat, daher bedeutet `isSent: true`, dass sie gesendet wurde, nicht, dass der Benutzer sie gesehen hat.

234 

235Dieses Beispiel sendet eine Benachrichtigung, wenn der Turn der Hauptkonversation ohne Unterbrechung endet, und greift auf einen Toast zurück, wenn keine Benachrichtigung mit Text gesendet wurde. Es wartet nicht auf die Benachrichtigung, bevor es das Event weitergibt, da die `Notification`-Hooks des Benutzers zuerst laufen und eine Weile dauern können:

236 

237```javascript theme={null}

238on('turn.complete', ($, e, next) => {

239 const isMainTurn = e.agentId === undefined && !e.isAborted

240 const fallBack = () => $.ui.toast('Turn finished')

241 if (isMainTurn) {

242 $.ui.notify('Turn finished').then(sent => {

243 const hasText = sent.isSent && sent.channel !== 'terminal_bell'

244 if (!hasText) fallBack()

245 }, fallBack)

246 }

247 return next(e)

248})

249```

214 250 

215In der [VS Code-Erweiterung](/docs/de/plugins/mods/interface#draw-in-the-vs-code-extension) werden Statuszeilen und Toasts stattdessen oberhalb des Eingabefelds angezeigt und Log-Zeilen in der Konversation.251In der [VS Code-Erweiterung](/docs/de/plugins/mods/interface#draw-in-the-vs-code-extension) werden Statuszeilen und Toasts stattdessen oberhalb des Eingabefelds angezeigt und Log-Zeilen in der Konversation.

216 252 

Details

181 181 

182#### Einen Tool-Aufruf genehmigen oder ablehnen, bevor der Benutzer gefragt wird182#### Einen Tool-Aufruf genehmigen oder ablehnen, bevor der Benutzer gefragt wird

183 183 

184Um zu entscheiden, ob ein Tool-Aufruf ausgeführt werden darf, behandeln Sie [`tool.check`](/docs/de/plugins/mods/reference#tools), das Event, in dem Claude Code diese Entscheidung trifft. Es wird ausgelöst, nachdem die Berechtigungsregeln und die Einstellungs-Hooks entschieden haben, und `next(e)` wird mit deren Entscheidung aufgelöst: `allow`, `ask` oder `deny`. Ihr Hook gibt diese Entscheidung oder eine andere zurück. `e.input` enthält die Argumente des Tools, etwa `command` für Bash.184Um zu entscheiden, ob ein Tool-Aufruf ausgeführt werden darf, behandeln Sie [`tool.check`](/docs/de/plugins/mods/reference#tools), das Event, in dem Claude Code diese Entscheidung trifft.

185 185 

186Für einen festen Befehl oder Pfad verwenden Sie eine [Berechtigungsregel](/docs/de/permissions#permission-rule-syntax) wie `Bash(npm test)`, die keinen Code erfordert. Behandeln Sie `tool.check`, wenn die Entscheidung davon abhängt, was in diesem Moment zutrifft, etwa vom aktuellen Git-Branch oder von einem Wert, den ein anderer Hook festgehalten hat.186Für einen festen Befehl oder Pfad verwenden Sie eine [Berechtigungsregel](/docs/de/permissions#permission-rule-syntax) wie `Bash(npm test)`, die keinen Code erfordert. Behandeln Sie `tool.check`, wenn die Entscheidung davon abhängt, was in diesem Moment zutrifft, etwa vom aktuellen Git-Branch oder von einem Wert, den ein anderer Hook festgehalten hat.

187 187 

188* **Was Sie zurückgeben**: Um den Aufruf selbst zu entscheiden, geben Sie ein eigenes Objekt zurück, etwa `{ decision: 'allow' }` oder `{ decision: 'deny', reason }`. Um die Entscheidung unverändert zu lassen, geben Sie zurück, was `await next(e)` Ihnen liefert.

189* **Was `await next(e)` Ihnen liefert**: Die eigene Entscheidung von Claude Code, als Objekt, dessen `decision` den Wert `allow`, `ask` oder `deny` hat. Während `next(e)` läuft, erscheint keine Berechtigungsabfrage.

190* **Argumente**: `e.input` enthält die Argumente des Tools, etwa `command` für Bash

191* **Wann `tool.check` ausgelöst wird**: Nachdem die [`PreToolUse`-Hooks](/docs/de/hooks#pretooluse) ausgeführt wurden und vor der Berechtigungsabfrage, dem Klassifikator des [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) oder einem [`PermissionRequest`](/docs/de/hooks#permissionrequest)-Hook

192 

188Dieser Hook lehnt `git push` ab, solange der aktuelle Branch `main` ist:193Dieser Hook lehnt `git push` ab, solange der aktuelle Branch `main` ist:

189 194 

190```javascript theme={null}195```javascript theme={null}

191on('tool.check', { tool: 'Bash' }, async ($, e, next) => {196on('tool.check', { tool: 'Bash' }, async ($, e, next) => {

192 // What the permission rules and settings hooks decided: 'allow', 'ask', or 'deny'197 // Claude Code's own decision

193 const decided = await next(e)198 const decided = await next(e)

194 if (!e.input.command.includes('git push')) return decided199 if (!e.input.command.includes('git push')) return decided

195 const branch = await $.process.run(['git', 'branch', '--show-current'])200 const branch = await $.process.run(['git', 'branch', '--show-current'])


209>214>

210> Ein `tool.check`-Hook kann auch `allow` oder `ask` zurückgeben. Im [Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode) kann Ihr Hook bei einem Aufruf, der nicht nur lesend ist, etwa einer Dateibearbeitung, die von `next(e)` zurückgegebene Entscheidung verschärfen, aber nicht lockern. Welche Berechtigungsregeln und Entscheidungen von `PreToolUse`-Hooks das `allow` Ihres Hooks nicht ersetzen kann, erfahren Sie unter [Berechtigungen mit Hooks erweitern](/docs/de/permissions#precedence-among-rules-hooks-and-mods).215> Ein `tool.check`-Hook kann auch `allow` oder `ask` zurückgeben. Im [Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode) kann Ihr Hook bei einem Aufruf, der nicht nur lesend ist, etwa einer Dateibearbeitung, die von `next(e)` zurückgegebene Entscheidung verschärfen, aber nicht lockern. Welche Berechtigungsregeln und Entscheidungen von `PreToolUse`-Hooks das `allow` Ihres Hooks nicht ersetzen kann, erfahren Sie unter [Berechtigungen mit Hooks erweitern](/docs/de/permissions#precedence-among-rules-hooks-and-mods).

211 216 

217#### Prüfen, ob ein Tool-Aufruf nur lesend ist

218 

219In einem [`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked)-Hook ist `e.isReadOnly` `true`, wenn das Tool den Aufruf als nur lesend meldet. Andernfalls fehlt das Feld, statt `false` zu sein. `e.isReadOnly` erfordert Claude Code v2.1.304 oder höher.

220 

221Einige Tools, etwa Read, Grep, Glob und WebSearch, melden jeden Aufruf als nur lesend. Bash und MCP-Tools melden einen Aufruf in diesen Fällen als nur lesend:

222 

223* **Bash**: Der Befehl besteht die integrierte [Prüfung auf nur lesende Befehle](/docs/de/permissions#read-only-commands) von Claude Code

224* **Ein MCP-Tool**: Der Server setzt die Annotation `readOnlyHint` des Tools auf `true`

225 

226Der Wert ist die eigene Angabe des Tools, genehmigen Sie einen Aufruf also nicht allein aufgrund dieses Felds. So melden sich etwa Aufrufe von WebFetch und Agent als nur lesend, obwohl [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) eine URL anfragt und [Agent](/docs/de/tools-reference#agent-tool-behavior) einen Subagenten startet, der eigene Tools ausführt.

227 

228Dieser Hook gibt für jeden `mcp__github__`-Aufruf, der nicht nur lesend ist und noch nicht abgelehnt wurde, ein `ask` zurück:

229 

230```javascript theme={null}

231on('tool.check', { tool: /^mcp__github__/ }, async ($, e, next) => {

232 const decided = await next(e)

233 // Read-only calls and denied calls pass through unchanged

234 if (e.isReadOnly || decided.decision === 'deny') return decided

235 return { decision: 'ask', reason: 'This tool can change the GitHub repository' }

236})

237```

238 

239#### Einen `tool.check`-Hook danach filtern, ob der Aufruf nur lesend ist

240 

241Um anhand von [`e.isReadOnly`](#check-whether-a-tool-call-is-read-only) einzuschränken, welche Aufrufe Ihr Hook behandelt, verwenden Sie den [Matcher](#filter-which-events-a-hook-handles) für nur lesende Aufrufe und den Hook-Rumpf für die übrigen:

242 

243* **Nur nur lesende Aufrufe**: Fügen Sie dem Matcher `isReadOnly: true` hinzu, wie in `on('tool.check', { tool: 'Bash', isReadOnly: true }, hook)`

244* **Aufrufe, die nicht nur lesend sind**: Prüfen Sie `e.isReadOnly` im Hook-Rumpf, wie es das [`mcp__github__`-Beispiel](#check-whether-a-tool-call-is-read-only) tut. Wenn Sie `isReadOnly: false` in einen Matcher schreiben, wird Ihr Hook nie ausgeführt.

245 

212### Einen Prompt umschreiben oder ergänzen246### Einen Prompt umschreiben oder ergänzen

213 247 

214Ein `prompt.submit`-Hook sieht jeden Prompt, bevor der Turn beginnt, und kann den Text daher umschreiben oder ergänzen. `e.text` ist das, was eingegeben wurde.248Ein `prompt.submit`-Hook sieht jeden Prompt, bevor der Turn beginnt, und kann den Text daher umschreiben oder ergänzen. `e.text` ist das, was eingegeben wurde.


312* **`PreToolUse`-Hooks aus verwalteten Einstellungen**: werden vor dem `tool.call`-Hook des ersten Mods ausgeführt. Wenn ein verwalteter Hook den Aufruf blockiert, wird für diesen Aufruf kein `tool.call`-Hook eines Mods ausgeführt.346* **`PreToolUse`-Hooks aus verwalteten Einstellungen**: werden vor dem `tool.call`-Hook des ersten Mods ausgeführt. Wenn ein verwalteter Hook den Aufruf blockiert, wird für diesen Aufruf kein `tool.call`-Hook eines Mods ausgeführt.

313* **`PreToolUse`-Hooks aus allen anderen Einstellungsdateien und aus der `hooks/hooks.json` von Plugins**: werden ausgeführt, nachdem der letzte Mod `next` aufgerufen hat, als Teil des eigenen Verhaltens von Claude Code. Ein Mod, der `tool.call` beantwortet, ohne `next` aufzurufen, verhindert ihre Ausführung, und ein Mod, der `next` aufruft, sieht ihre Entscheidung in dem Ergebnis, das er zurückgibt.347* **`PreToolUse`-Hooks aus allen anderen Einstellungsdateien und aus der `hooks/hooks.json` von Plugins**: werden ausgeführt, nachdem der letzte Mod `next` aufgerufen hat, als Teil des eigenen Verhaltens von Claude Code. Ein Mod, der `tool.call` beantwortet, ohne `next` aufzurufen, verhindert ihre Ausführung, und ein Mod, der `next` aufruft, sieht ihre Entscheidung in dem Ergebnis, das er zurückgibt.

314 348 

315[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) wird ausgelöst, nachdem die Berechtigungsregeln und beide Gruppen von `PreToolUse`-Hooks entschieden haben. Welche dieser Entscheidungen das `allow` eines `tool.check`-Hooks nicht ersetzen kann, erfahren Sie unter [Berechtigungen mit Hooks erweitern](/docs/de/permissions#precedence-among-rules-hooks-and-mods).349[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) wird ausgelöst, nachdem die `PreToolUse`-Hooks ausgeführt wurden. Welche Berechtigungsregeln und Entscheidungen von `PreToolUse`-Hooks das `allow` eines `tool.check`-Hooks nicht ersetzen kann, erfahren Sie unter [Berechtigungen mit Hooks erweitern](/docs/de/permissions#precedence-among-rules-hooks-and-mods).

316 350 

317### Einen fehlschlagenden Hook behandeln351### Einen fehlschlagenden Hook behandeln

318 352 

Details

306| `closeOnEscape` | Sorgt dafür, dass Esc das Pane schließt |306| `closeOnEscape` | Sorgt dafür, dass Esc das Pane schließt |

307| `holdToasts` | Hält im Terminal Toasts zurück, solange dieses Pane angezeigt wird. Siehe [Toasts hinter einem Dialog zurückhalten](#hold-toasts-behind-a-dialog). |307| `holdToasts` | Hält im Terminal Toasts zurück, solange dieses Pane angezeigt wird. Siehe [Toasts hinter einem Dialog zurückhalten](#hold-toasts-behind-a-dialog). |

308| `rows` | Die anzufordernde Höhe, wenn sich das Pane über dem Prompt befindet. Standardmäßig ein Drittel des Platzes. |308| `rows` | Die anzufordernde Höhe, wenn sich das Pane über dem Prompt befindet. Standardmäßig ein Drittel des Platzes. |

309| `columns` | Die anzufordernde Breite, wenn sich das Pane neben dem Transkript befindet |309| `columns` | Die anzufordernde Breite, wenn sich das Pane neben dem Transkript befindet, höchstens 45 % der Terminalbreite. Sobald der Benutzer die Größe eines Panes neben dem Transkript geändert hat, in dieser Sitzung oder einer früheren, öffnen sich Panes dort stattdessen mit der von ihm festgelegten Breite. Für diese Breite gilt dieselbe Grenze von 45 %. |

310 310 

311Die [VS Code-Erweiterung](#draw-in-the-vs-code-extension) ignoriert `rows` und `columns` und legt die Größe des Panes selbst fest.311Die [VS Code-Erweiterung](#draw-in-the-vs-code-extension) ignoriert `rows` und `columns` und legt die Größe des Panes selbst fest.

312 312 


537| Enter | Drückt den fokussierten `Button`, sendet das fokussierte `Input` ab oder wählt in einem `Select` aus |537| Enter | Drückt den fokussierten `Button`, sendet das fokussierte `Input` ab oder wählt in einem `Select` aus |

538| Der Hotkey einer Schaltfläche | Drückt diese Schaltfläche. Solange ein `Input` den Fokus hat, geht jede druckbare Taste an das Feld. |538| Der Hotkey einer Schaltfläche | Drückt diese Schaltfläche. Solange ein `Input` den Fokus hat, geht jede druckbare Taste an das Feld. |

539| Page Up, Page Down, Home und End | Scrollen Ihren Bereich oder Ihr Band, wenn er bzw. es mehr Zeilen hat, als angezeigt werden können |539| Page Up, Page Down, Home und End | Scrollen Ihren Bereich oder Ihr Band, wenn er bzw. es mehr Zeilen hat, als angezeigt werden können |

540| Ctrl+X und dann eine Pfeiltaste | Ändert die Größe Ihres Bereichs. Links oder nach oben gibt ihm mehr Platz, rechts oder nach unten gibt den Platz wieder ab. |540| Ctrl+X und dann eine Pfeiltaste | Ändert die Größe Ihres Bereichs. Links oder nach oben gibt ihm mehr Platz, rechts oder nach unten gibt den Platz wieder ab. Ein Bereich neben dem Transkript wird ab 45 % der Terminalbreite nicht mehr breiter. |

541| Ctrl+X und dann X | Schließt Ihren Bereich, auch wenn eines seiner Felder den Fokus hat |541| Ctrl+X und dann X | Schließt Ihren Bereich, auch wenn eines seiner Felder den Fokus hat |

542| Esc | Gibt den Tastaturfokus an den Prompt zurück. Mit `closeOnEscape: true` schließt sie außerdem den Bereich. |542| Esc | Gibt den Tastaturfokus an den Prompt zurück. Mit `closeOnEscape: true` schließt sie außerdem den Bereich. |

543 543 

Details

56| Event | Wird ausgelöst, wenn | Ein Hook kann zurückgeben |56| Event | Wird ausgelöst, wenn | Ein Hook kann zurückgeben |

57| :- | :- | :- |57| :- | :- | :- |

58| [`tool.call`](/docs/de/plugins/mods/events#guard-or-change-a-tool-call) | Ein Tool gleich ausgeführt wird | `next(e)`, `{ deny: reason }` oder `{ result }` |58| [`tool.call`](/docs/de/plugins/mods/events#guard-or-change-a-tool-call) | Ein Tool gleich ausgeführt wird | `next(e)`, `{ deny: reason }` oder `{ result }` |

59| [`tool.check`](/docs/de/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code entscheidet, ob ein Tool-Aufruf ausgeführt werden darf, nach den Hooks `tool.call` und `PreToolUse`. `next(e)` wird zu der Entscheidung aufgelöst, zu der die Regeln, der Berechtigungsmodus und diese Hooks gelangt sind. | `{ decision }`, also `allow`, `ask` oder `deny` |59| [`tool.check`](/docs/de/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code entscheidet, ob ein Tool-Aufruf ausgeführt werden darf, nach den Hooks `tool.call` und `PreToolUse`. `next(e)` wird zu der Entscheidung aufgelöst, zu der die Regeln, der Berechtigungsmodus und diese Hooks gelangt sind. | `next(e)` oder `{ decision }`, wobei `decision` auf `allow`, `ask` oder `deny` gesetzt ist, mit einem optionalen `reason` |

60| `tool.describe` | Einmal für jedes Tool, wenn seine Beschreibung zum ersten Mal an Claude gesendet wird. Ein zweites Mal für ein MCP-Tool, wenn Claude es über die [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) lädt, wobei `e.description` auf den Text gesetzt ist, den Claude für das geladene Tool liest. | `{ description }`, optional mit `isDeferred` auf `true` gesetzt, um das Tool hinter die Tool-Suche zu stellen, oder auf `false`, um es vorab zu laden |60| `tool.describe` | Einmal für jedes Tool, wenn seine Beschreibung zum ersten Mal an Claude gesendet wird. Ein zweites Mal für ein MCP-Tool, wenn Claude es über die [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) lädt, wobei `e.description` auf den Text gesetzt ist, den Claude für das geladene Tool liest. | `{ description }`, optional mit `isDeferred` auf `true` gesetzt, um das Tool hinter die Tool-Suche zu stellen, oder auf `false`, um es vorab zu laden |

61 61 

62#### Agenten- und Organisationsfelder in `tool.check`62#### Agenten- und Organisationsfelder in `tool.check`


68 68 

69Bei `tool.check` erfordern `e.agentId` und `e.ceiling` Claude Code v2.1.290 oder höher.69Bei `tool.check` erfordern `e.agentId` und `e.ceiling` Claude Code v2.1.290 oder höher.

70 70 

71#### Das Feld `e.isReadOnly` in `tool.check`

72 

73In einem `tool.check`-Hook ist `e.isReadOnly` gleich `true`, wenn das Tool diesen Aufruf als nur lesend meldet. Andernfalls ist das Feld nicht vorhanden, statt `false` zu sein. Der Wert ist die eigene Angabe des Tools. Lesen Sie daher [Prüfen, ob ein Tool-Aufruf nur lesend ist](/docs/de/plugins/mods/events#check-whether-a-tool-call-is-read-only), bevor Sie einen Aufruf allein anhand dieses Felds genehmigen.

74 

75Bei `tool.check` erfordert `e.isReadOnly` Claude Code v2.1.304 oder höher.

76 

71### Prompts und was Claude liest77### Prompts und was Claude liest

72 78 

73Prompt-Events betreffen den Text, den der Benutzer eingibt, und den Text, den Claude Code von sich aus an Claude sendet, etwa den System-Prompt und Erinnerungen:79Prompt-Events betreffen den Text, den der Benutzer eingibt, und den Text, den Claude Code von sich aus an Claude sendet, etwa den System-Prompt und Erinnerungen:


196| Namespace | Methoden |202| Namespace | Methoden |

197| :- | :- |203| :- | :- |

198| `$.plugin` | `name`, `root`: Name und Verzeichnis dieses Plugins |204| `$.plugin` | `name`, `root`: Name und Verzeichnis dieses Plugins |

199| [`$.ui`](/docs/de/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |205| [`$.ui`](/docs/de/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |

200| [`$.command`](/docs/de/plugins/mods/api#add-a-command) | `register`, `run`, `list` |206| [`$.command`](/docs/de/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

201| [`$.tool`](/docs/de/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |207| [`$.tool`](/docs/de/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

202| `$.agent` | `register`, `spawn`, `list`. `list()` gibt die Subagenten und Teammitglieder dieser Sitzung zurück, jeweils mit einem `status` von `pending`, `running`, `waiting`, `idle`, `completed`, `failed` oder `killed`, wobei `idle` und `waiting` Claude Code v2.1.289 oder neuer erfordern. |208| `$.agent` | `register`, `spawn`, `list`. `list()` gibt die Subagenten und Teammitglieder dieser Sitzung zurück, jeweils mit einem `status` von `pending`, `running`, `waiting`, `idle`, `completed`, `failed` oder `killed`, wobei `idle` und `waiting` Claude Code v2.1.289 oder neuer erfordern. |


266| `Svg` | Ein SVG-Dokument, bis zu 131.072 Zeichen | | ✓ | ✓ |272| `Svg` | Ein SVG-Dokument, bis zu 131.072 Zeichen | | ✓ | ✓ |

267| [`Client`](/docs/de/plugins/mods/interface#build-a-tree-from-elements) | `module`, `key` | ✓ | ✓ | |273| [`Client`](/docs/de/plugins/mods/interface#build-a-tree-from-elements) | `module`, `key` | ✓ | ✓ | |

268| [`Raster`](/docs/de/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`, `columns` bis zu 512, `rows` bis zu 256, `cells`. Siehe [Ein Raster farbiger Zellen zeichnen](/docs/de/plugins/mods/interface#draw-a-grid-of-colored-cells). | ✓ | | |274| [`Raster`](/docs/de/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`, `columns` bis zu 512, `rows` bis zu 256, `cells`. Siehe [Ein Raster farbiger Zellen zeichnen](/docs/de/plugins/mods/interface#draw-a-grid-of-colored-cells). | ✓ | | |

269| `Image` | PNG- oder RGBA-Bytes bis zu 2 MiB oder ein Dateipfad, `columns` und `rows` bis zu 255 sowie `alt`-Text. | ✓ | | |275| `Image` | PNG- oder RGBA-Bytes bis zu 2 MiB oder ein Dateipfad, `columns` und `rows` bis zu 255 sowie `alt`-Text. Siehe [welche Terminals es darstellen](/docs/de/plugins/mods/gallery#image-and-client). | ✓ | | |

270 276 

271Weitere Regeln für `Button`: `action` benennt eine der eigenen [Tastenkombinations-Aktionen](/docs/de/keybindings) von Claude Code, und die Tastenkombination des Benutzers dafür drückt die Schaltfläche, wenn diese Tastenkombination ein Akkord oder eine Taste mit Modifikator ist. Ein Ziffern-`hotkey` auf einer Schaltfläche im Band wird auch ausgelöst, wenn der Benutzer nur diese Ziffer in einen leeren Prompt eingibt und innehält. Wenn zwei Schaltflächen in einer Zeichnung denselben `hotkey` angeben, erhält ihn die spätere. `autoFocus` akzeptiert bei jedem Steuerelement nur `true`; lassen Sie die Prop also weg, um es deaktiviert zu lassen.277Weitere Regeln für `Button`: `action` benennt eine der eigenen [Tastenkombinations-Aktionen](/docs/de/keybindings) von Claude Code, und die Tastenkombination des Benutzers dafür drückt die Schaltfläche, wenn diese Tastenkombination ein Akkord oder eine Taste mit Modifikator ist. Ein Ziffern-`hotkey` auf einer Schaltfläche im Band wird auch ausgelöst, wenn der Benutzer nur diese Ziffer in einen leeren Prompt eingibt und innehält. Wenn zwei Schaltflächen in einer Zeichnung denselben `hotkey` angeben, erhält ihn die spätere. `autoFocus` akzeptiert bei jedem Steuerelement nur `true`; lassen Sie die Prop also weg, um es deaktiviert zu lassen.

272 278 

Details

187| `prompt.fill` | `() => ({ isFilled: true })` |187| `prompt.fill` | `() => ({ isFilled: true })` |

188| `$.prompt.read` | `() => ({ value: { text: '...', cursor: 0 } })` |188| `$.prompt.read` | `() => ({ value: { text: '...', cursor: 0 } })` |

189| `$.ui.copy` | `() => ({ value: { isCopied: true } })` |189| `$.ui.copy` | `() => ({ value: { isCopied: true } })` |

190| `$.ui.notify` | `() => ({ value: { isSent: true, channel: 'terminal_bell' } })`. Der Text ist `e.text` und der Titel ist `e.title`. |

190| `$.session.messages` | `() => ({ value: [{ role: 'assistant', text: '...', toolUses: [] }] })` |191| `$.session.messages` | `() => ({ value: [{ role: 'assistant', text: '...', toolUses: [] }] })` |

191| `$.session.id`, `$.agent.list` | `() => ({ value: 'abc123' })`, `() => ({ value: [] })` |192| `$.session.id`, `$.agent.list` | `() => ({ value: 'abc123' })`, `() => ({ value: [] })` |

192| `session.send` | `() => ({ isDelivered: true })`. `e.to` kommt als String an, auch wenn Ihr Mod `{ sessionId }` übergeben hat. |193| `session.send` | `() => ({ isDelivered: true })`. `e.to` kommt als String an, auch wenn Ihr Mod `{ sessionId }` übergeben hat. |

Details

830 830 

831* **`Failed to load hooks from <path>: <reason>`**: `hooks/hooks.json` ist kein gültiges JSON oder schlägt das Hooks-Schema fehl. Der Grund benennt den Parse- oder Validierungsfehler. Beheben Sie die Datei. Um ein JSON-Syntaxproblem in `hooks/hooks.json` zu fangen, bevor Sie das Plugin veröffentlichen, führen Sie `claude plugin validate <plugin-directory>` in Ihrer Shell aus831* **`Failed to load hooks from <path>: <reason>`**: `hooks/hooks.json` ist kein gültiges JSON oder schlägt das Hooks-Schema fehl. Der Grund benennt den Parse- oder Validierungsfehler. Beheben Sie die Datei. Um ein JSON-Syntaxproblem in `hooks/hooks.json` zu fangen, bevor Sie das Plugin veröffentlichen, führen Sie `claude plugin validate <plugin-directory>` in Ihrer Shell aus

832* **`hooks path not found: <path>`**: das Feld `hooks` des Manifests benennt eine Datei, die nicht an diesem Pfad relativ zum Plugin-Root vorhanden ist. Beheben Sie den Pfad oder fügen Sie die Datei hinzu832* **`hooks path not found: <path>`**: das Feld `hooks` des Manifests benennt eine Datei, die nicht an diesem Pfad relativ zum Plugin-Root vorhanden ist. Beheben Sie den Pfad oder fügen Sie die Datei hinzu

833* **`hooks path escapes plugin directory: <path>`**: siehe [Path escapes plugin directory](/docs/de/errors#path-escapes-plugin-directory)

833 834 

834#### `hook error`-Hinweise im Transkript835#### `hook error`-Hinweise im Transkript

835 836 


948 949 

949Claude Code hat einen Pfad aus Ihrer `plugin.json` oder Ihrem Marktplatz-Eintrag gegen den Plugin-Root aufgelöst und dort nichts gefunden. Der Pfad in der Meldung ist der absolute Pfad, den es überprüft hat, daher vergleichen Sie ihn mit dem, was auf der Festplatte vorhanden ist. Beheben Sie den Pfad oder erstellen Sie das Verzeichnis, und führen Sie dann `/reload-plugins` aus.950Claude Code hat einen Pfad aus Ihrer `plugin.json` oder Ihrem Marktplatz-Eintrag gegen den Plugin-Root aufgelöst und dort nichts gefunden. Der Pfad in der Meldung ist der absolute Pfad, den es überprüft hat, daher vergleichen Sie ihn mit dem, was auf der Festplatte vorhanden ist. Beheben Sie den Pfad oder erstellen Sie das Verzeichnis, und führen Sie dann `/reload-plugins` aus.

950 951 

952> [!NOTE]

953>

954> Vor v2.1.299 konnte diese Meldung beim Start in einer Zeile erscheinen, die mit einem Tag wie `synced[0]` beschriftet ist. Diese Zeile steht für ein Plugin, das [von claude.ai synchronisiert](/docs/de/plugins/loading#synced-plugins) wurde. Sie erschien, wenn eine andere Claude Code-Sitzung auf Ihrem Rechner das Plugin kurz zuvor aktualisiert und seine Dateien verschoben hatte. Um das Plugin zu laden, starten Sie Claude Code neu. Damit die Meldung aus diesem Grund nicht mehr erscheint, aktualisieren Sie auf v2.1.299 oder höher.

955 

951Pfade im Manifest sind relativ zum Plugin-Root und beginnen mit `./`. Ein Pfad, der außerhalb des Plugin-Root aufgelöst wird, wird stattdessen als `<component> path escapes plugin directory` gemeldet und wird gelöscht.956Pfade im Manifest sind relativ zum Plugin-Root und beginnen mit `./`. Ein Pfad, der außerhalb des Plugin-Root aufgelöst wird, wird stattdessen als `<component> path escapes plugin directory` gemeldet und wird gelöscht.

952 957 

953### `--plugin-dir` in einem Marktplatz-Root lädt die Plugins unter `plugins/` nicht958### `--plugin-dir` in einem Marktplatz-Root lädt die Plugins unter `plugins/` nicht

Details

55Wenn Ihre Anfragen durch ein [LLM-Gateway](/docs/de/llm-gateway), eine benutzerdefinierte `ANTHROPIC_BASE_URL` oder eine Cloud-Provider-Basis-URL-Überschreibung wie [`ANTHROPIC_BEDROCK_BASE_URL`](/docs/de/env-vars) geleitet werden, hängt das, was zwischengespeichert bleibt, davon ab, wie das Gateway die [`cache_control`-Marker](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints) handhabt, die Claude Code sendet:55Wenn Ihre Anfragen durch ein [LLM-Gateway](/docs/de/llm-gateway), eine benutzerdefinierte `ANTHROPIC_BASE_URL` oder eine Cloud-Provider-Basis-URL-Überschreibung wie [`ANTHROPIC_BEDROCK_BASE_URL`](/docs/de/env-vars) geleitet werden, hängt das, was zwischengespeichert bleibt, davon ab, wie das Gateway die [`cache_control`-Marker](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints) handhabt, die Claude Code sendet:

56 56 

57* **Leitet sie unverändert weiter**: Der Block und Ihre Konversation werden auf die gleiche Weise zwischengespeichert wie am eigenen Endpunkt des Anbieters.57* **Leitet sie unverändert weiter**: Der Block und Ihre Konversation werden auf die gleiche Weise zwischengespeichert wie am eigenen Endpunkt des Anbieters.

58* **Lehnt die markierte Anfrage mit einem `400`-Fehler ab, der `cache_control` nennt**: Claude Code sendet die Anfrage erneut mit dem Marker, der vom Block auf Ihre letzte Konversationsnachricht verschoben wird, und behält ihn dort für den Rest der Konversation. Der Block wird als unzwischengespeicherte Eingabe abgerechnet; Ihre Konversation bleibt zwischengespeichert.58* **Lehnt die markierte Anfrage mit einem `400`-Fehler ab, der `cache_control` nennt**: Claude Code sendet die Anfrage erneut mit dem Marker, der vom Block auf Ihre letzte Konversationsnachricht verschoben wird, und behält ihn dort, bis Claude Code beendet wird. Der Block wird als unzwischengespeicherte Eingabe abgerechnet; Ihre Konversation bleibt zwischengespeichert.

59* **Entfernt die Marker bei erfolgreicher Rückgabe**: Ihr gesamter Konversationsverlauf wird bei jedem Turn als unzwischengespeicherte Eingabe abgerechnet. Ein Gateway, das Block-Form-Systeminhalt in einen einfachen String konvertiert, lässt den Marker auf die gleiche Weise fallen.59* **Entfernt die Marker bei erfolgreicher Rückgabe**: Ihr gesamter Konversationsverlauf wird bei jedem Turn als unzwischengespeicherte Eingabe abgerechnet. Ein Gateway, das Block-Form-Systeminhalt in einen einfachen String konvertiert, lässt den Marker auf die gleiche Weise fallen.

60 60 

61Für das, was jeder Anbieter speichert und verarbeitet, siehe [Datennutzung](/docs/de/data-usage). Wo immer der Cache lebt, Einträge verfallen nach einer Inaktivitätsperiode, und [Cache-Lebensdauer](#cache-lifetime) unten behandelt die TTL und wie man sie verlängert.61Für das, was jeder Anbieter speichert und verarbeitet, siehe [Datennutzung](/docs/de/data-usage). Wo immer der Cache lebt, Einträge verfallen nach einer Inaktivitätsperiode, und [Cache-Lebensdauer](#cache-lifetime) unten behandelt die TTL und wie man sie verlängert.


109Tool-Definitionen befinden sich in der System-Prompt-Schicht, sodass der Cache ungültig wird, wenn sich die Menge der Tool-Definitionen in der Anfrage zwischen Turns ändert. Das Umschalten des [Advisor-Tools](/docs/de/advisor) ist eine Ausnahme: seine Definition befindet sich nach dem Cache-Breakpoint, sodass das Aktivieren oder Deaktivieren von `/advisor` das zwischengespeicherte Präfix intakt hält. Ob eine [MCP-Server](/docs/de/mcp)-Änderung dies tut, hängt davon ab, ob [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) die MCP-Tools der Sitzung aufschiebt, die Standardeinstellung auf unterstützten Modellen:109Tool-Definitionen befinden sich in der System-Prompt-Schicht, sodass der Cache ungültig wird, wenn sich die Menge der Tool-Definitionen in der Anfrage zwischen Turns ändert. Das Umschalten des [Advisor-Tools](/docs/de/advisor) ist eine Ausnahme: seine Definition befindet sich nach dem Cache-Breakpoint, sodass das Aktivieren oder Deaktivieren von `/advisor` das zwischengespeicherte Präfix intakt hält. Ob eine [MCP-Server](/docs/de/mcp)-Änderung dies tut, hängt davon ab, ob [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) die MCP-Tools der Sitzung aufschiebt, die Standardeinstellung auf unterstützten Modellen:

110 110 

111* **Tools aufgeschoben**: Claude Code behält die Tool-Liste aus der ersten Anfrage der Konversation für die gesamte Konversation, sodass ein Server, der sich während einer Sitzung verbindet oder trennt, nichts stört, das bereits zwischengespeichert ist. Ein Server, der sich nach der ersten Anfrage verbindet, stellt seine Tools als aufgeschobene Definitionen bereit, die Claude bei Bedarf lädt.111* **Tools aufgeschoben**: Claude Code behält die Tool-Liste aus der ersten Anfrage der Konversation für die gesamte Konversation, sodass ein Server, der sich während einer Sitzung verbindet oder trennt, nichts stört, das bereits zwischengespeichert ist. Ein Server, der sich nach der ersten Anfrage verbindet, stellt seine Tools als aufgeschobene Definitionen bereit, die Claude bei Bedarf lädt.

112* **Tools geladen im Voraus**: Das Hinzufügen einer Definition macht den Cache ungültig, und das absichtliche Entfernen einer Definition auch. Dies gilt, wenn Tool-Suche [unter ihrem `auto`-Schwellenwert liegt, deaktiviert oder nicht verfügbar ist](/docs/de/mcp#configure-tool-search), z. B. auf Google Cloud's Agent Platform-Modellen, die älter als Opus 4.5, Sonnet 4.5 und Haiku 4.5 sind, mit einem benutzerdefinierten `ANTHROPIC_BASE_URL`-Gateway oder auf einer Microsoft Foundry [auf Azure gehosteten Bereitstellung](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options), sobald Claude Code erkennt, dass die Bereitstellung Tool-Suche ablehnt.112* **Tools geladen im Voraus**: Das Hinzufügen einer Definition macht den Cache ungültig, und das absichtliche Entfernen einer Definition auch. Dies gilt, wenn Tool-Suche [deaktiviert oder nicht verfügbar ist](/docs/de/mcp#configure-tool-search), z. B. auf:

113 * Google Cloud's Agent Platform-Modellen, die älter als Opus 4.5, Sonnet 4.5 und Haiku 4.5 sind

114 * einer Microsoft Foundry [auf Azure gehosteten Bereitstellung](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options), sobald Claude Code erkennt, dass die Bereitstellung Tool-Suche ablehnt

113 115 

114Ohne Tool-Suche hängt es davon ab, was sich geändert hat, ob eine Server-Änderung während einer Sitzung den Cache ungültig macht. Für jede Änderung gibt diese Tabelle an, ob der Cache beibehalten wird und was mit den Tool-Definitionen in der nächsten Anfrage geschieht.116Ohne Tool-Suche hängt es davon ab, was sich geändert hat, ob eine Server-Änderung während einer Sitzung den Cache ungültig macht. Für jede Änderung gibt diese Tabelle an, ob der Cache beibehalten wird und was mit den Tool-Definitionen in der nächsten Anfrage geschieht.

115 117 


169 171 

170### Konversation komprimieren172### Konversation komprimieren

171 173 

172[Komprimierung](/docs/de/context-window#what-survives-compaction) ersetzt Ihren Nachrichtenverlauf durch eine Zusammenfassung. Dies macht die Konversationsschicht absichtlich ungültig, da die nächste Anfrage einen neuen, kürzeren Verlauf hat, der kein Präfix mit dem alten teilt. Claude Code verwendet die System-Prompt-Schicht wieder, es sei denn, die Konversation wurde [fortgesetzt, während ein System-Prompt beibehalten wurde, der sich sonst geändert hätte](#resuming-a-session); in diesem Fall wechselt die erste Komprimierung zum aktuellen Prompt und diese Schicht wird einmal neu erstellt. Es lädt Projektkontext von der Festplatte neu, was nur Cache-Treffer hat, wenn CLAUDE.md und Memory seit Sitzungsbeginn unverändert sind.174[Komprimierung](/docs/de/context-window#what-survives-compaction) ersetzt Ihren Nachrichtenverlauf durch eine Zusammenfassung. Dies macht die Konversationsschicht absichtlich ungültig: Die nächste Anfrage hat einen neuen, kürzeren Verlauf, der kein Präfix mit dem alten teilt. Die Schichten für System-Prompt und Projektkontext können im Cache bleiben:

173 175 

174Um die Zusammenfassung zu erstellen, sendet Claude Code eine separate Anfrage mit dem gleichen System-Prompt, den gleichen Tools und dem gleichen Verlauf wie Ihre Konversation, plus eine Zusammenfassungsanweisung, die als letzte Benutzernachricht angehängt wird. Während der Cache warm ist, liest diese Anfrage Ihr Präfix aus dem Cache, sodass ein `/compact` während einer Sitzung einen Bruchteil dessen kostet, was die Kontextgröße nahelegt, und die meiste Zeit mit der Generierung der Zusammenfassung verbringt.176* **System-Prompt**: Die nächste Anfrage liest diese Schicht aus dem Cache, es sei denn, eine [fortgesetzte Konversation](#resuming-a-session) hat einen System-Prompt beibehalten, der inzwischen veraltet ist. Wenn diese Konversation zum ersten Mal komprimiert wird, stellt Claude Code sie auf den aktuellen Prompt um, und die nächste Anfrage baut den Cache dieser Schicht einmal neu auf.

177* **Projektkontext**: Claude Code lädt diese Schicht von der Festplatte neu. Die nächste Anfrage liest sie nur dann aus dem Cache, wenn CLAUDE.md und Memory seit Sitzungsbeginn unverändert sind.

175 178 

176Nach einer Pause länger als die [Cache-Lebensdauer](#cache-lifetime) gibt es keinen Cache mehr zum Lesen, sodass die Zusammenfassungsanfrage den vollständigen Verlauf als nicht zwischengespeicherte Eingabe erneut verarbeitet. Dies ist der Grund, warum `/compact` am meisten kostet, wenn Sie [eine alte Sitzung fortsetzen](/docs/de/sessions#resume-a-session). In beiden Fällen, warm und kalt, erstellt der Turn nach der Komprimierung den Konversations-Cache nur für die viel kürzere Zusammenfassung neu, sodass dieser Turn nicht der langsame Teil ist.179Um die Zusammenfassung zu erstellen, sendet Claude Code eine separate Anfrage. Die Anfrage wiederholt den System-Prompt, die Tools und den zusammenzufassenden Verlauf Ihrer Konversation. Sie endet mit einer Zusammenfassungsanweisung. Während der Cache warm ist, liest diese Anfrage Ihr Präfix aus dem Cache. Ein `/compact` während einer Sitzung kostet dann einen Bruchteil dessen, was die Kontextgröße nahelegt, und verbringt die meiste Zeit mit der Generierung der Zusammenfassung.

180 

181Nach einer Pause länger als die [Cache-Lebensdauer](#cache-lifetime) gibt es keinen Cache mehr zum Lesen, sodass die Zusammenfassungsanfrage diesen Verlauf als nicht zwischengespeicherte Eingabe erneut verarbeitet. Dies ist der Grund, warum `/compact` am meisten kostet, wenn Sie [eine alte Sitzung fortsetzen](/docs/de/sessions#resume-a-session). In beiden Fällen, warm und kalt, erstellt der Turn nach der Komprimierung den Konversations-Cache nur für die viel kürzere Zusammenfassung neu, sodass dieser Turn nicht der langsame Teil ist.

177 182 

178> [!TIP]183> [!TIP]

179>184>

remote-control.md +91 −80

Details

26Bevor Sie Remote Control verwenden, bestätigen Sie, dass Ihre Umgebung diese Bedingungen erfüllt:26Bevor Sie Remote Control verwenden, bestätigen Sie, dass Ihre Umgebung diese Bedingungen erfüllt:

27 27 

28* **Abonnement**: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Eigentümer zunächst den Remote Control-Schalter in den [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code) aktivieren.28* **Abonnement**: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Eigentümer zunächst den Remote Control-Schalter in den [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code) aktivieren.

29* **Benutzerdefinierte Rollen**: Wenn Ihre Enterprise-Organisation Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452) verwaltet, müssen Ihnen Ihre Rollen sowohl die Berechtigung für Cloud-Sitzungen als auch die Berechtigung **Claude Code remote control** erteilen. Fehlt eine davon, zeigt der Start von Remote Control [`Remote Control is disabled by your organization's policy`](#remote-control-is-disabled-by-your-organizations-policy) an. Bitten Sie einen Owner, Ihre Rollen zu prüfen und das Fehlende unter [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) hinzuzufügen.

29* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben. Ohne eine berechtigte Anmeldung wird `claude remote-control` mit einem Fehler beendet, während `claude --remote-control` weiterhin eine interaktive Sitzung startet und kurz nach dem Start eine Remote Control-Fehlerbenachrichtigung anzeigt.30* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben. Ohne eine berechtigte Anmeldung wird `claude remote-control` mit einem Fehler beendet, während `claude --remote-control` weiterhin eine interaktive Sitzung startet und kurz nach dem Start eine Remote Control-Fehlerbenachrichtigung anzeigt.

30* **API-Endpunkt**: nicht verfügbar in einer dieser Konfigurationen:31* **API-Endpunkt**: nicht verfügbar in einer dieser Konfigurationen:

31 * Sie verwenden Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry.32 * Sie verwenden Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry.


33 * Sie melden sich über ein Enterprise-[Claude-Apps-Gateway](/docs/de/claude-apps-gateway) an.34 * Sie melden sich über ein Enterprise-[Claude-Apps-Gateway](/docs/de/claude-apps-gateway) an.

34* **Feature-Flag-Evaluierung**: Wenn Sie eine [Umgebungsvariable festlegen, die die Feature-Flag-Evaluierung deaktiviert](/docs/de/env-vars#features-that-need-feature-flag-fetching), hängt die Verfügbarkeit von Remote Control davon ab, welche Sie festlegen:35* **Feature-Flag-Evaluierung**: Wenn Sie eine [Umgebungsvariable festlegen, die die Feature-Flag-Evaluierung deaktiviert](/docs/de/env-vars#features-that-need-feature-flag-fetching), hängt die Verfügbarkeit von Remote Control davon ab, welche Sie festlegen:

35 * Wenn Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` festlegen, ist Remote Control nicht verfügbar. Heben Sie die Variablenzuweisung überall auf – in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings) – um Remote Control zu verwenden.36 * Wenn Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` festlegen, ist Remote Control nicht verfügbar. Heben Sie die Variablenzuweisung überall auf – in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings) – um Remote Control zu verwenden.

36 * Wenn Sie nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` festlegen, bleibt Remote Control verfügbar, es sei denn, Ihre Organisation erfordert [Vertrauenswürdige Geräte](#trusted-devices). Falls ja, heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden. Die Verwendung von Remote Control mit einer dieser Variablen erfordert Claude Code v2.1.283 oder später.37 * Wenn Sie nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` festlegen, bleibt Remote Control verfügbar, es sei denn, Ihre Organisation erfordert [Vertrauenswürdige Geräte](#trusted-devices). Falls ja, heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden. Die Verwendung von Remote Control mit einer dieser Variablen erfordert Claude Code v2.1.283 oder später bzw. v2.1.304 oder später in der Claude Desktop-App.

37* **Workspace-Vertrauen**: In einem Verzeichnis, das Sie noch nicht vertraut haben, gibt `claude remote-control` aus, was das Vertrauen aktiviert, und fragt `Trust <directory>? [y/N]` ab, bevor es startet. Die Antwort `y` speichert die Wahl, außer in Ihrem Home-Verzeichnis, wo Vertrauen niemals gespeichert wird und die Frage bei jedem Durchlauf erneut gestellt wird. Wenn die Standardeingabe oder -ausgabe kein Terminal ist, kann der Befehl nicht fragen und wird mit einem [`Workspace not trusted`](/docs/de/errors#workspace-not-trusted-when-starting-remote-control)-Fehler beendet.38* **Workspace-Vertrauen**: In einem Verzeichnis, das Sie noch nicht vertraut haben, gibt `claude remote-control` aus, was das Vertrauen aktiviert, und fragt `Trust <directory>? [y/N]` ab, bevor es startet. Die Antwort `y` speichert die Wahl, außer in Ihrem Home-Verzeichnis, wo Vertrauen niemals gespeichert wird und die Frage bei jedem Durchlauf erneut gestellt wird. Wenn die Standardeingabe oder -ausgabe kein Terminal ist, kann der Befehl nicht fragen und wird mit einem [`Workspace not trusted`](/docs/de/errors#workspace-not-trusted-when-starting-remote-control)-Fehler beendet.

38 39 

39## Starten Sie eine Remote Control-Sitzung40## Eine Remote-Control-Sitzung starten

40 41 

41Sie können eine Remote Control-Sitzung über die CLI, die [Claude Desktop-App](/docs/de/desktop) oder die VS Code-Erweiterung starten. Die CLI bietet drei Aufrufmodi; die Desktop-App und VS Code verwenden den Befehl `/remote-control`.42Sie können eine Remote-Control-Sitzung über die CLI, die [Claude Desktop-App](/docs/de/desktop) oder die VS Code-Erweiterung starten. Die CLI bietet drei Aufrufmodi; die Desktop-App und VS Code verwenden den Befehl `/remote-control`.

42 43 

43**Server-Modus**44**Servermodus**

44 45 

45Navigieren Sie zu Ihrem Projektverzeichnis und führen Sie aus:46Führen Sie in Ihrem Projektverzeichnis Folgendes aus:

46 47 

47```bash theme={null}48```bash theme={null}

48claude remote-control49claude remote-control

49```50```

50 51 

51Bis Sie Remote Controls einmalige Bestätigung akzeptieren, erklärt `claude remote-control`, was es tut, und fragt `Enable Remote Control? (y/n)`, bevor der Server gestartet wird. Antworten Sie mit `y`, um zu akzeptieren und den Server zu starten. Wenn Sie ablehnen, beendet Claude Code den Vorgang ohne Starten des Servers und fragt beim nächsten Ausführen des Befehls erneut.52Solange Sie die einmalige Bestätigung von Remote Control nicht akzeptiert haben, erklärt `claude remote-control`, was der Befehl tut, und fragt `Enable Remote Control? (y/n)`, bevor der Server gestartet wird. Antworten Sie mit `y`, um zu akzeptieren und den Server zu starten. Wenn Sie ablehnen, beendet sich Claude Code, ohne den Server zu starten, und fragt beim nächsten Ausführen des Befehls erneut.

52 53 

53Der Prozess läuft weiterhin in Ihrem Terminal im Server-Modus und wartet auf Remote-Verbindungen. Er zeigt eine Sitzungs-URL an, die Sie zum [Verbinden von einem anderen Gerät](#connect-from-another-device) verwenden können, und Sie können die Leertaste drücken, um einen QR-Code für schnellen Zugriff von Ihrem Telefon anzuzeigen. Während eine Remote-Sitzung aktiv ist, zeigt das Terminal den Verbindungsstatus und die Tool-Aktivität an.54Der Prozess läuft im Servermodus in Ihrem Terminal weiter und wartet auf Remote-Verbindungen. Er zeigt eine Sitzungs-URL an, mit der Sie sich [von einem anderen Gerät aus verbinden](#connect-from-another-device) können, und Sie können die Leertaste drücken, um einen QR-Code für den schnellen Zugriff von Ihrem Telefon aus anzuzeigen. Während eine Remote-Sitzung aktiv ist, zeigt das Terminal den Verbindungsstatus und die Tool-Aktivität an.

54 55 

55Übergeben Sie eines dieser Flags nach `remote-control`:56Übergeben Sie eines dieser Flags nach `remote-control`:

56 57 

57| Flag | Beschreibung |58| Flag | Beschreibung |

58| - | - |59| - | - |

59| `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |60| `--name "My Project"` | Legt einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code angezeigt wird. |

60| `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte Sitzungsnamen, wenn kein expliziter Name festgelegt ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Setzen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für denselben Effekt. |61| `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte Sitzungsnamen, wenn kein expliziter Name festgelegt ist. Standardmäßig der Hostname Ihres Rechners, was Namen wie `myhost-graceful-unicorn` ergibt. Setzen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für denselben Effekt. |

61| `-c`, `--continue` | Bringen Sie die Sitzung zurück, die der letzte Server in diesem Verzeichnis gestartet hat, anstatt eine neue zu erstellen. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |62| `-c`, `--continue` | Holt die Sitzung zurück, mit der der letzte Server in diesem Verzeichnis gestartet wurde, anstatt eine neue zu erstellen. Siehe [Sitzungen nach dem Beenden des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder höher. |

62| `--session-id <id>` | Bringen Sie eine Sitzung anhand ihrer ID zurück. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |63| `--session-id <id>` | Holt eine einzelne Sitzung anhand ihrer ID zurück. Siehe [Sitzungen nach dem Beenden des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder höher. |

63| `--spawn <mode>` | Wie der Server Sitzungen erstellt. • `same-dir` (Standard): Alle Sitzungen teilen sich das aktuelle Arbeitsverzeichnis, sodass sie in Konflikt geraten können, wenn dieselben Dateien bearbeitet werden. • `worktree`: Jede On-Demand-Sitzung erhält ihren eigenen [git worktree](/docs/de/worktrees). Erfordert ein Git-Repository oder einen [`WorktreeCreate`-Hook](/docs/de/hooks#worktreecreate). • `session`: Single-Session-Modus. Bedient genau eine Sitzung und lehnt zusätzliche Verbindungen ab. Wird nur beim Start festgelegt. Drücken Sie `w` zur Laufzeit, um zwischen `same-dir` und `worktree` umzuschalten. |64| `--spawn <mode>` | Wie der Server Sitzungen erstellt. • `same-dir` (Standard, wenn kein Modus gespeichert ist): Alle Sitzungen teilen sich das aktuelle Arbeitsverzeichnis, sodass es zu Konflikten kommen kann, wenn dieselben Dateien bearbeitet werden. • `worktree`: Jede On-Demand-Sitzung erhält ihren eigenen [Git-Worktree](/docs/de/worktrees). Erfordert ein Git-Repository oder einen [`WorktreeCreate`-Hook](/docs/de/hooks#worktreecreate). • `session`: Einzelsitzungsmodus. Bedient genau eine Sitzung und lehnt weitere Verbindungen ab. Kann nur beim Start festgelegt werden. Drücken Sie zur Laufzeit `w`, um zwischen `same-dir` und `worktree` umzuschalten. Der Modus, zu dem Sie wechseln, wird zum [Standard für dieses Projekt](#set-the-default-spawn-mode-for-a-project). |

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

65| `--[no-]create-session-in-dir` | Erstellen Sie vorab eine Sitzung im aktuellen Verzeichnis, wenn der Server startet, damit Sie sofort einen Ort zum Eingeben haben. 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 zu starten, archiviert Claude Code die Sitzungen des Servers, wenn Sie ihn stoppen, sodass es nichts zum [Fortsetzen](#resume-sessions-after-stopping-the-server) gibt. |66| `--[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. |

66| `--permission-mode <mode>` | Legen Sie den Startmodus für [Berechtigungen](/docs/de/permission-modes) 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. |67| `--permission-mode <mode>` | Legt den anfänglichen [Berechtigungsmodus](/docs/de/permission-modes) 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. |

67| `--chrome` / `--no-chrome` | Schalten Sie die [Chrome-Integration](/docs/de/chrome) in den Sitzungen, die der Server erstellt, ein oder aus, damit Claude Chrome auf Ihrem Computer nutzen kann, während Sie von einem anderen Gerät aus arbeiten. Ohne eines der beiden Flags beginnen die Sitzung, die der Server vorab erstellt, und jede Sitzung, die Sie selbst von claude.ai/code oder der Claude-App aus starten, mit Chrome aus, auch wenn Sie [Chrome standardmäßig aktiviert haben](/docs/de/chrome#enable-chrome-by-default). Eine Sitzung, die der Server für einen Ihrer [Projekt](/docs/de/claude-projects)-Threads startet, folgt dieser Einstellung stattdessen, außer im `bypassPermissions`-Modus. Erfordert Claude Code v2.1.273 oder später. |68| `--chrome` / `--no-chrome` | Schaltet die [Chrome-Integration](/docs/de/chrome) 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](/docs/de/chrome#enable-chrome-by-default) haben. Eine Sitzung, die der Server für einen Ihrer [Projekt](/docs/de/claude-projects)-Threads startet, folgt stattdessen dieser Einstellung, außer im Modus `bypassPermissions`. Erfordert Claude Code v2.1.273 oder höher. |

68| `-d`, `--debug[=<filter>]` | Aktivieren Sie Debug-Protokollierung für den Server, optional gefiltert nach Kategorie. Übergeben Sie einen Filter nur in der `=`-Form, z. B. `--debug=api,hooks`. Erfordert Claude Code v2.1.282 oder später. |69| `-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. |

69| `--debug-file <path>` | Schreiben Sie Debug-Protokolle in die angegebene Datei. |70| `--debug-file <path>` | Schreibt Debug-Logs in die angegebene Datei. |

70| `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |71| `--verbose` | Zeigt detaillierte Verbindungs- und Sitzungslogs an. |

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

72 73 

73Wenn Sie ein globales `claude`-Flag vor `remote-control` übergeben, oder ein Wrapper-Skript fügt eines hinzu, trägt Claude Code das Flag nicht auf die Sitzungen über, die der Server erstellt. Claude Code lässt das Flag nur durch, wenn bekannt ist, dass das Löschen nicht ändert, was diese Sitzungen tun können, z. B. `--verbose` oder `--model`. Für jedes andere Flag, z. B. `--settings`, [weigert sich Claude Code zu starten](/docs/de/errors#not-carried-over-to-the-sessions-remote-control-starts) und nennt das zu entfernende Flag.74Wenn 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](/docs/de/errors#not-carried-over-to-the-sessions-remote-control-starts) und nennt das zu entfernende Flag.

74 75 

75Um die Sitzungen, die der Server startet, in eine Sandbox zu packen, aktivieren Sie [Sandboxing](/docs/de/sandboxing) in einer Einstellungsdatei.76Um die vom Server gestarteten Sitzungen in einer Sandbox auszuführen, aktivieren Sie [Sandboxing](/docs/de/sandboxing) in einer Einstellungsdatei.

76 77 

77Um die `remote-control`-Flags in Ihrem Terminal auszugeben, führen Sie `claude remote-control --help` aus. Vor v2.1.302 gab der Befehl ohne berechtigte Anmeldung stattdessen einen der Fehler unter [Fehlerbehebung](#troubleshooting) zurück.78Um die `remote-control`-Flags in Ihrem Terminal auszugeben, führen Sie `claude remote-control --help` aus. Vor v2.1.302 gab der Befehl ohne berechtigte Anmeldung stattdessen einen der Fehler unter [Fehlerbehebung](#troubleshooting) zurück.

78 79 


84claude --remote-control85claude --remote-control

85```86```

86 87 

87Geben Sie optional einen Namen für die Sitzung an:88Optional können Sie einen Namen für die Sitzung übergeben:

88 89 

89```bash theme={null}90```bash theme={null}

90claude --remote-control "My Project"91claude --remote-control "My Project"

91```92```

92 93 

93Dies gibt Ihnen eine vollständige interaktive Sitzung in Ihrem Terminal, die Sie auch von claude.ai oder der Claude-App aus steuern können. Im Gegensatz zu `claude remote-control` (Server-Modus) können Sie lokal Nachrichten eingeben, während die Sitzung auch remote verfügbar ist.94Damit erhalten Sie eine vollständige interaktive Sitzung in Ihrem Terminal, die Sie auch über claude.ai oder die Claude-App steuern können. Anders als bei `claude remote-control` (Servermodus) können Sie lokal Nachrichten eingeben, während die Sitzung auch remote verfügbar ist.

94 95 

95**Aus einer bestehenden Sitzung**96**Aus einer bestehenden Sitzung**

96 97 


106/remote-control My Project107/remote-control My Project

107```108```

108 109 

109Dies startet eine Remote Control-Sitzung, die Ihren aktuellen Gesprächsverlauf überträgt.110Dadurch wird eine Remote-Control-Sitzung gestartet, die Ihren aktuellen Konversationsverlauf übernimmt.

110 111 

111Bis Sie Remote Controls einmalige Bestätigung akzeptieren, wird ein Dialog angezeigt, bevor `/remote-control` verbunden wird. Wählen Sie **Enable Remote Control**, um zu akzeptieren und zu verbinden. Wenn Sie **Never mind** wählen oder Esc drücken, verbindet Claude Code nicht und fragt beim nächsten Ausführen von `/remote-control` erneut.112Solange Sie die einmalige Bestätigung von Remote Control nicht akzeptiert haben, erscheint ein Dialog, bevor `/remote-control` eine Verbindung herstellt. Wählen Sie **Enable Remote Control**, um zu akzeptieren und eine Verbindung herzustellen. Wenn Sie **Never mind** wählen oder Esc drücken, stellt Claude Code keine Verbindung her und fragt beim nächsten Ausführen von `/remote-control` erneut.

112 113 

113Das Flag `--verbose` ist mit diesem Befehl nicht verfügbar.114Das Flag `--verbose` ist mit diesem Befehl nicht verfügbar.

114 115 

115**VS Code**116**VS Code**

116 117 

117In der [Claude Code VS Code-Erweiterung](/docs/de/vs-code) geben Sie `/remote-control` oder `/rc` in das Eingabefeld ein.118Geben Sie in der [Claude Code VS Code-Erweiterung](/docs/de/vs-code) `/remote-control` oder `/rc` in das Eingabefeld ein.

118 119 

119```text theme={null}120```text theme={null}

120/remote-control121/remote-control

121```122```

122 123 

123Während Remote Control aktiviert ist, zeigt Claude Code einen **Remote Control**-Indikator in der Fußzeile des Eingabefelds an. Sobald sich die Sitzung verbindet, klicken Sie auf den Indikator, um direkt zur Sitzung zu gehen, oder finden Sie sie in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code). Claude Code postet auch die Sitzungs-URL im Gespräch. Um die Verbindung zu trennen, führen Sie `/remote-control` erneut aus.124Während Remote Control aktiv ist, zeigt Claude Code in der Fußzeile des Eingabefelds einen **Remote Control**-Indikator an. Sobald die Sitzung verbunden ist, klicken Sie auf den Indikator, um direkt zur Sitzung zu gelangen, oder suchen Sie sie in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code). Claude Code veröffentlicht außerdem die Sitzungs-URL in der Konversation. Um die Verbindung zu trennen, führen Sie `/remote-control` erneut aus.

124 125 

125Im Gegensatz zur CLI akzeptiert der VS Code-Befehl kein Namensargument und zeigt keinen QR-Code an. Der Sitzungstitel wird aus Ihrem Gesprächsverlauf oder der ersten Eingabeaufforderung abgeleitet.126Anders als die CLI akzeptiert der VS Code-Befehl kein Namensargument und zeigt keinen QR-Code an. Der Sitzungstitel wird aus Ihrem Konversationsverlauf oder Ihrem ersten Prompt abgeleitet.

126 127 

127**Desktop-App**128**Desktop-App**

128 129 

129In einer lokalen Sitzung im [Code-Tab der Claude Desktop-App](/docs/de/desktop) geben Sie `/remote-control` oder `/rc` in das Eingabefeld ein.130Geben Sie in einer lokalen Sitzung im Code-Tab der [Claude Desktop-App](/docs/de/desktop) `/remote-control` oder `/rc` in das Eingabefeld ein.

130 131 

131```text theme={null}132```text theme={null}

132/remote-control133/remote-control

133```134```

134 135 

135Sobald sich die Sitzung verbindet, finden Sie sie in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code). Um die Verbindung zu trennen, führen Sie `/remote-control` erneut aus.136Sobald die Sitzung verbunden ist, finden Sie sie in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code). Um die Verbindung zu trennen, führen Sie `/remote-control` erneut aus.

136 137 

137Um Remote Control stattdessen standardmäßig für jede Sitzung zu aktivieren, siehe [Aktivieren Sie Remote Control für alle Sitzungen](#enable-remote-control-for-all-sessions).138Um Remote Control stattdessen standardmäßig für jede Sitzung zu aktivieren, siehe [Remote Control für alle Sitzungen aktivieren](#enable-remote-control-for-all-sessions).

138 139 

139### Verbindungsstatus überprüfen140### Verbindungsstatus prüfen

140 141 

141In einer interaktiven Sitzung zeigt das Terminal während der Remote Control-Verbindung einen `/rc active`-Indikator an, der auf die Sitzung auf claude.ai verlinkt. Der Indikator ist ausgeblendet, wenn das Terminal zu schmal ist, um ihn anzuzeigen. Um die Sitzungs-URL und einen QR-Code zum [Verbinden von einem anderen Gerät](#connect-from-another-device) anzuzeigen, führen Sie `/remote-control` erneut aus, um das Statusfenster zu öffnen. Das Fenster bietet auch eine Trennungsoption, die Remote Control ausschaltet, während Ihre lokale Sitzung weiterhin im Terminal läuft.142In einer interaktiven Sitzung zeigt das Terminal, während Remote Control verbunden ist, einen `/rc active`-Indikator an, der auf die Sitzung auf claude.ai verlinkt. Der Indikator wird ausgeblendet, wenn das Terminal zu schmal dafür ist. Um die Sitzungs-URL und einen QR-Code zum [Verbinden von einem anderen Gerät](#connect-from-another-device) anzuzeigen, führen Sie `/remote-control` erneut aus, um das Statusfenster zu öffnen. Über das Fenster können Sie Remote Control auch trennen, während Ihre lokale Sitzung weiterläuft.

142 143 

143Wenn die Verbindung in einer interaktiven Sitzung fehlschlägt, ändert sich der Indikator, um den Fehler anzuzeigen, und Claude Code zeigt den Grund in einer Benachrichtigung an und fügt ihn zum Gespräch hinzu. Führen Sie `/remote-control` aus, um erneut zu verbinden, es sei denn, der Grund besagt, dass die Sitzung anderswo übernommen oder beendet wurde:144Wenn die Verbindung in einer interaktiven Sitzung fehlschlägt, ändert sich der Indikator, um den Fehler anzuzeigen, und Claude Code zeigt den Grund in einer Benachrichtigung an und fügt ihn der Konversation hinzu. Führen Sie `/remote-control` aus, um die Verbindung wiederherzustellen, es sei denn, der Grund besagt, dass sich die Sitzung an anderer Stelle geändert hat:

144 145 

145* **Another connection took over this session**: Ein anderes Gerät oder eine Claude Code-Sitzung hat sie jetzt. Führen Sie `/remote-control` nur aus, wenn Sie sie von diesem Gerät zurücknehmen möchten.146* **Another connection took over this session**: Ein anderes Gerät oder eine andere Claude Code-Sitzung hat sie jetzt. Führen Sie `/remote-control` nur aus, wenn Sie sie zurückholen möchten.

146* **This session was ended or archived from another device or app**: Führen Sie `/remote-control` nur aus, wenn Sie sie zurück möchten. Claude Code öffnet eine archivierte Sitzung erneut.147* **This session was ended or archived from another device or app**: Führen Sie `/remote-control` nur aus, wenn Sie die Sitzung zurückhaben möchten. Claude Code öffnet eine archivierte Sitzung erneut.

147* **The server no longer reports this session**: Sie wurde möglicherweise von einem anderen Gerät oder einer App gelöscht.148* **The server no longer reports this session**: Sie wurde möglicherweise von einem anderen Gerät oder einer anderen App aus gelöscht.

148 149 

149### Verbinden Sie sich von einem anderen Gerät150### Von einem anderen Gerät aus verbinden

150 151 

151Sobald eine Remote Control-Sitzung aktiv ist, haben Sie mehrere Möglichkeiten, sich von einem anderen Gerät aus zu verbinden:152Sobald eine Remote-Control-Sitzung aktiv ist, haben Sie mehrere Möglichkeiten, sich von einem anderen Gerät aus zu verbinden:

152 153 

153* **Öffnen Sie die Sitzungs-URL** in einem beliebigen Browser, um direkt zur Sitzung auf [claude.ai/code](https://claude.ai/code) zu gehen.154* **Öffnen Sie die Sitzungs-URL** in einem beliebigen Browser, um direkt zur Sitzung auf [claude.ai/code](https://claude.ai/code) zu gelangen.

154* **Scannen Sie den QR-Code**, der neben der Sitzungs-URL angezeigt wird, um ihn direkt in der Claude-App zu öffnen. Mit `claude remote-control` drücken Sie die Leertaste, um die QR-Code-Anzeige umzuschalten.155* **Scannen Sie den QR-Code**, der neben der Sitzungs-URL angezeigt wird, um sie direkt in der Claude-App zu öffnen. Drücken Sie bei `claude remote-control` die Leertaste, um die QR-Code-Anzeige umzuschalten.

155* **Öffnen Sie [claude.ai/code](https://claude.ai/code) oder die Claude-App** und finden Sie die Sitzung nach Name in der Sitzungsliste. In der mobilen Claude-App tippen Sie auf **Code** in der Navigation, um die Sitzungsliste zu erreichen. Remote Control-Sitzungen zeigen ein Computersymbol mit einem grünen Statusindikator an, wenn sie online sind.156* **Öffnen Sie [claude.ai/code](https://claude.ai/code) oder die Claude-App** und suchen Sie die Sitzung anhand ihres Namens in der Sitzungsliste. Tippen Sie in der mobilen Claude-App in der Navigation auf **Code**, um zur Sitzungsliste zu gelangen. Remote-Control-Sitzungen werden mit einem Computersymbol und einem grünen Statuspunkt angezeigt, wenn sie online sind.

156 157 

157Wenn Sie sich verbinden, zeigt das Gerät alle Subagenten und Workflows an, die die Sitzung bereits im Hintergrund ausführt. Stoppen Sie einen von ihnen vom Gerät aus, und Claude Code stoppt diese Aufgabe auf Ihrem Computer.158Wenn Sie sich verbinden, zeigt das Gerät alle Subagenten und Workflows an, die in der Sitzung bereits im Hintergrund laufen. Wenn Sie einen davon über das Gerät stoppen, stoppt Claude Code diese Aufgabe auf Ihrem Rechner.

158 159 

159Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:160Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:

160 161 

1611. Der Name, den Sie an `--name`, `--remote-control` oder `/remote-control` übergeben haben1621. Der Name, den Sie an `--name`, `--remote-control` oder `/remote-control` übergeben haben

1622. Der Titel, den Sie mit `/rename` festgelegt haben1632. Der Titel, den Sie mit `/rename` festgelegt haben

1633. Die letzte aussagekräftige Nachricht im vorhandenen Gesprächsverlauf1643. Die letzte aussagekräftige Nachricht im bestehenden Konversationsverlauf

1644. Ein automatisch generierter Name wie `myhost-graceful-unicorn`, wobei `myhost` der Hostname Ihres Computers oder das Präfix ist, das Sie mit `--remote-control-session-name-prefix` festgelegt haben1654. Ein automatisch generierter Name wie `myhost-graceful-unicorn`, wobei `myhost` der Hostname Ihres Rechners oder das Präfix ist, das Sie mit `--remote-control-session-name-prefix` festgelegt haben

165 166 

166Wenn Sie keinen expliziten Namen festgelegt haben, aktualisiert Claude Code den Titel, um Ihre Eingabeaufforderung widerzuspiegeln, sobald Sie eine senden. Wenn Sie eine Sitzung von claude.ai oder der Claude-App aus umbenennen, aktualisiert Claude Code auch den lokalen Titel, der in `claude --resume` angezeigt wird.167Wenn Sie keinen expliziten Namen festgelegt haben, aktualisiert Claude Code den Titel entsprechend Ihrem Prompt, sobald Sie einen senden. Wenn Sie eine Sitzung über claude.ai oder die Claude-App umbenennen, aktualisiert Claude Code auch den lokalen Titel, der in `claude --resume` angezeigt wird.

167 168 

168Wenn Sie die Claude-App noch nicht haben, verwenden Sie den Befehl `/mobile` in Claude Code, um einen QR-Code für [claude.ai/mobile](https://claude.ai/mobile) anzuzeigen, das die richtige App-Store-Seite für Ihr Telefon öffnet.169Wenn Sie die Claude-App noch nicht haben, führen Sie `/mobile` in Claude Code aus, um einen QR-Code für [claude.ai/mobile](https://claude.ai/mobile) anzuzeigen, der den passenden App Store für Ihr Telefon öffnet.

169 170 

170### Was verbundene Geräte sehen171### Was verbundene Geräte sehen

171 172 

172Ein verbundenes Gerät zeigt das Gespräch in Ihrem Terminal, während es passiert. Diese Fälle gehen über gewöhnliche Nachrichten hinaus:173Ein verbundenes Gerät zeigt die Konversation in Ihrem Terminal in Echtzeit an. Diese Fälle gehen über gewöhnliche Nachrichten hinaus:

173 174 

174* **Komprimierung und `/clear`**: Während Claude Code [das Gespräch komprimiert](/docs/de/context-window#what-survives-compaction), zeigen verbundene Geräte den Fortschritt und dann an, wo das Gespräch komprimiert wurde. Wenn Sie `/clear` ausführen, wird das Gespräch auch auf verbundenen Geräten zurückgesetzt.175* **Komprimierung und `/clear`**: Während Claude Code [die Konversation komprimiert](/docs/de/context-window#what-survives-compaction), zeigen verbundene Geräte den Fortschritt und anschließend die Stelle an, an der die Konversation komprimiert wurde. Wenn Sie `/clear` ausführen, wird die Konversation auch auf verbundenen Geräten zurückgesetzt.

175* **Wechsel von Gesprächen mit `/resume`**: Das verbundene Gerät empfängt nicht den Titel oder die frühere Verlauf des gewechselten Gesprächs, aber neue Nachrichten in beide Richtungen gehen zu und von dem Gespräch, das in Ihrem Terminal offen ist. Um von dem Gerät aus wieder an dem ursprünglichen Gespräch zu arbeiten, führen Sie `/resume` in Ihrem Terminal aus und wechseln Sie zurück.176* **Wechseln von Konversationen mit `/resume`**: Das verbundene Gerät erhält weder den Titel noch den früheren Verlauf der Konversation, zu der gewechselt wurde, aber neue Nachrichten in beide Richtungen gehen an bzw. kommen von der Konversation, die gerade in Ihrem Terminal geöffnet ist. Um vom Gerät aus wieder an der ursprünglichen Konversation zu arbeiten, führen Sie `/resume` in Ihrem Terminal aus und wechseln Sie zu ihr zurück.

176* **Ziehen Sie eine Sitzung mit `/teleport`**: Wenn Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) mit `/teleport` in Ihr Terminal ziehen, empfängt das verbundene Gerät nicht den früheren Verlauf des gezogenen Gesprächs. Neue Nachrichten in beide Richtungen gehen zu und von dem gezogenen Gespräch, das jetzt das in Ihrem Terminal offene ist.177* **Abrufen einer Sitzung mit `/teleport`**: Wenn Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) mit `/teleport` in Ihr Terminal holen, erhält das verbundene Gerät nicht den früheren Verlauf der abgerufenen Konversation. Neue Nachrichten in beide Richtungen gehen an bzw. kommen von der abgerufenen Konversation, die jetzt in Ihrem Terminal geöffnet ist.

177* **Nachrichten von Ihren anderen Sitzungen**: Mit [sitzungsübergreifendem Messaging](/docs/de/cross-session-messaging) trägt dieselbe Verbindung Nachrichten zwischen Ihren eigenen Sitzungen auf verschiedenen Maschinen.178* **Nachrichten aus Ihren anderen Sitzungen**: Mit [sitzungsübergreifendem Messaging](/docs/de/cross-session-messaging) überträgt dieselbe Verbindung Nachrichten zwischen Ihren eigenen Sitzungen auf verschiedenen Rechnern.

178* **Diff Ihrer Änderungen**: Wenn sich das Verzeichnis der Sitzung in einem Git-Repository befindet, zeigt der Diff-Bereich eines verbundenen Geräts Ihre Änderungen. Auf einem Branch, der Commits vor dem Standard-Branch des Repositories hat, zeigt der Bereich die Änderungen seit dem Abzweigen des Branches an, einschließlich Ihrer nicht committeten Änderungen. Auf dem Standard-Branch selbst oder auf einem Branch, der nicht vor ihm liegt, zeigt der Bereich nur Ihre nicht committeten Änderungen.179* **Diff Ihrer Änderungen**: Wenn sich das Verzeichnis der Sitzung in einem Git-Repository befindet, zeigt der Diff-Bereich eines verbundenen Geräts Ihre Änderungen an. Auf einem Branch, der Commits vor dem Standard-Branch des Repositorys hat, zeigt der Bereich die Änderungen seit der Abzweigung des Branches, einschließlich Ihrer nicht committeten Bearbeitungen. Auf dem Standard-Branch selbst oder auf einem Branch, der ihm nicht voraus ist, zeigt der Bereich nur Ihre nicht committeten Änderungen an.

179* **Modell**: Wenn Sie ein [Modell](/docs/de/model-config) von einem verbundenen Gerät aus auswählen, führt Claude Code die Sitzung auf diesem Modell aus. Erfordert Claude Code v2.1.238 oder später. Ein Modell, das Sie vom Modellsteuerelement des Geräts auswählen, gilt nur für die aktuelle Sitzung. Wenn Sie `/model <name>` vom Gerät an eine interaktive Sitzung senden, setzt Claude Code auch Ihren Standard für neue Sitzungen.180* **Modell**: Wenn Sie auf einem verbundenen Gerät ein [Modell](/docs/de/model-config) auswählen, führt Claude Code die Sitzung mit diesem Modell aus. Erfordert Claude Code v2.1.238 oder höher. Ein Modell, das Sie über die Modellsteuerung des Geräts auswählen, gilt nur für die aktuelle Sitzung. Wenn Sie `/model <name>` vom Gerät an eine interaktive Sitzung senden, legt Claude Code außerdem Ihren Standard für neue Sitzungen fest.

180* **Anstrengungsstufe**: Wenn Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) von einem verbundenen Gerät aus mit `/effort` oder dem Anstrengungssteuerelement des Geräts einstellen, wendet Claude Code sie auf die Sitzung auf Ihrem Computer an. Wenn Sie eine Stufe mit `CLAUDE_CODE_EFFORT_LEVEL` angeheftet haben, behält die Sitzung diese Stufe, und Claude Code weigert sich, eine andere Auswahl vom Anstrengungssteuerelement zu treffen. Eine Stufe vom Anstrengungssteuerelement auszuwählen erfordert Claude Code v2.1.234 oder später auf Ihrem Computer.181* **Effort-Stufe**: Wenn Sie die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) auf einem verbundenen Gerät festlegen, mit `/effort` oder über die Effort-Steuerung des Geräts, wendet Claude Code sie auf die Sitzung auf Ihrem Rechner an. Wenn Sie eine Stufe mit `CLAUDE_CODE_EFFORT_LEVEL` fixiert haben, behält die Sitzung diese Stufe bei, und Claude Code lehnt eine abweichende Auswahl über die Effort-Steuerung ab. Die Auswahl einer Stufe über die Effort-Steuerung erfordert Claude Code v2.1.234 oder höher auf Ihrem Rechner.

181* **Erneute Verbindung nach einem Verbindungsfehler**: Führen Sie `/remote-control` aus, um erneut zu verbinden. Wenn die Komprimierung das Gespräch umgeschrieben hat oder Sie Gespräche mit `/resume` in der Zwischenzeit gewechselt haben, archiviert Claude Code die Server-Sitzung, die es verwendete, anstatt sie in der Sitzungsliste zu belassen. Sie können sie immer noch finden, indem Sie [nach archivierten Sitzungen filtern](/docs/de/claude-code-on-the-web#archive-sessions). Das Wechseln von Gesprächen, während ein Gerät noch verbunden ist, archiviert die Sitzung nicht.182* **Wiederverbinden nach einem Verbindungsfehler**: Führen Sie `/remote-control` aus, um die Verbindung wiederherzustellen. Wenn die Komprimierung die Konversation zwischenzeitlich umgeschrieben hat oder Sie mit `/resume` die Konversation gewechselt haben, archiviert Claude Code die verwendete Serversitzung, anstatt sie in der Sitzungsliste zu belassen. Sie können sie weiterhin finden, indem Sie [nach archivierten Sitzungen filtern](/docs/de/claude-code-on-the-web#archive-sessions). Das Wechseln von Konversationen, während ein Gerät noch verbunden ist, archiviert die Sitzung nicht.

182 183 

183### Aktivieren Sie Remote Control für alle Sitzungen184### Remote Control für alle Sitzungen aktivieren

184 185 

185Remote Control wird nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen, es sei denn, die automatische Verbindung ist aktiviert. Um die automatische Verbindung für jede interaktive Sitzung zu aktivieren, führen Sie `/config` in Claude Code aus und setzen Sie **Enable Remote Control for all sessions**. Der Schalter nimmt drei Werte an:186Remote Control wird nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen, es sei denn, die automatische Verbindung ist eingeschaltet. Um die automatische Verbindung für jede interaktive Sitzung einzuschalten, führen Sie `/config` in Claude Code aus und setzen Sie **Enable Remote Control for all sessions**. Der Schalter kennt drei Werte:

186 187 

187* **`true`**: Verbinden Sie sich automatisch, wenn eine interaktive Sitzung startet.188* **`true`**: Automatisch verbinden, wenn eine interaktive Sitzung startet.

188* **`false`**: Schalten Sie die automatische Verbindung aus, obwohl ein `true` von [verwalteten Einstellungen](/docs/de/managed-settings) es übertrumpft, da Claude Code die Auswahl in Ihren Benutzereinstellungen speichert. Ein `false` in Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) schaltet die automatische Verbindung aus, auch über einem verwalteten `true`.189* **`false`**: Die automatische Verbindung ausschalten, wobei ein `true` aus [verwalteten Einstellungen](/docs/de/managed-settings) Vorrang hat, da Claude Code die Auswahl in Ihren Benutzereinstellungen speichert. Ein `false` in Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) schaltet die automatische Verbindung auch gegenüber einem verwalteten `true` aus.

189* **`default`**: Löschen Sie Ihre Auswahl und folgen Sie dem Admin-Standard Ihrer Organisation, falls einer festgelegt ist, andernfalls dem aktuellen Standard von Claude Code. Wenn Sie `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt haben, siehe [Automatische Verbindung mit gesetztem `DISABLE_TELEMETRY` oder `DO_NOT_TRACK`](#auto-connect-with-disable-telemetry-or-do-not-track).190* **`default`**: Ihre Auswahl löschen und dem Admin-Standard Ihrer Organisation folgen, sofern einer festgelegt ist, andernfalls dem aktuellen Standard von Claude Code. Wenn Sie `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt haben, siehe [Automatische Verbindung bei gesetztem `DISABLE_TELEMETRY` oder `DO_NOT_TRACK`](#auto-connect-with-disable-telemetry-or-do-not-track).

190 191 

191Die VS Code-Erweiterung und die Desktop-App haben ebenfalls einen Schalter für die automatische Verbindung:192Die VS Code-Erweiterung und die Desktop-App verfügen ebenfalls über einen Schalter für die automatische Verbindung:

192 193 

193* **VS Code-Erweiterung**: **Enable Remote Control for all sessions** im Abschnitt „Einstellungen“ des [Befehlsmenüs](/docs/de/vs-code#use-the-prompt-box).194* **VS Code-Erweiterung**: **Enable Remote Control for all sessions** im Abschnitt „Settings“ des [Befehlsmenüs](/docs/de/vs-code#use-the-prompt-box).

194* **Desktop-App**: **Einstellungen > Claude Code > Connect new sessions to Remote Control**. Siehe [Steuern, welche Sitzungen auf Ihren anderen Geräten angezeigt werden](/docs/de/desktop#control-which-sessions-appear-on-your-other-devices).195* **Desktop-App**: **Settings > Claude Code > Connect new sessions to Remote Control**. Siehe [Steuern, welche Sitzungen auf Ihren anderen Geräten angezeigt werden](/docs/de/desktop#control-which-sessions-appear-on-your-other-devices).

195 196 

196Um die automatische Verbindung stattdessen aus einer Einstellungsdatei zu aktivieren, setzen Sie [`remoteControlAtStartup`](/docs/de/settings-reference#remotecontrolatstartup) auf `true` in Ihrer Benutzer-`~/.claude/settings.json` oder in [verwalteten Einstellungen](/docs/de/managed-settings). In Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ehrt Claude Code ein `false` und schaltet die automatische Verbindung für dieses Repository aus, ignoriert aber ein `true`, sodass eine eingecheckte Datei Remote Control nicht für alle aktivieren kann, die das Repository öffnen.197Um die automatische Verbindung stattdessen über eine Einstellungsdatei einzuschalten, setzen Sie [`remoteControlAtStartup`](/docs/de/settings-reference#remotecontrolatstartup) in Ihrer Benutzerdatei `~/.claude/settings.json` oder in [verwalteten Einstellungen](/docs/de/managed-settings) auf `true`. In Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) berücksichtigt Claude Code ein `false` und schaltet die automatische Verbindung für dieses Repository aus, ignoriert jedoch ein `true`, sodass eine eingecheckte Datei Remote Control nicht für alle aktivieren kann, die das Repository öffnen.

197 198 

198Die automatische Verbindung meldet sich mit Ihrem eigenen claude.ai-Konto an, daher wird eine Sitzung, die sie startet, nur in Ihren eigenen Claude-Apps angezeigt und gewährt niemandem sonst Zugriff.199Die automatische Verbindung meldet sich mit Ihrem eigenen claude.ai-Konto an, sodass eine dadurch gestartete Sitzung nur in den Claude-Apps Ihres eigenen Kontos erscheint und niemand anderem Zugriff gewährt.

199 200 

200Mit dieser Einstellung registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Remote-Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen, verwenden Sie stattdessen den [Server-Modus](#start-a-remote-control-session).201Wenn diese Einstellung aktiviert ist, registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Remote-Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzigen Prozess auszuführen, verwenden Sie stattdessen den [Servermodus](#start-a-remote-control-session).

201 202 

202#### Automatische Verbindung mit gesetztem `DISABLE_TELEMETRY` oder `DO_NOT_TRACK`203#### Automatische Verbindung bei gesetztem `DISABLE_TELEMETRY` oder `DO_NOT_TRACK`

203 204 

204Wenn nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, verbinden sich Ihre Sitzungen weder über den Admin-Standard Ihrer Organisation noch über den eigenen Standard von Claude Code automatisch. Wenn etwas anderes Remote Control für Sie unverfügbar macht, z. B. `DISABLE_GROWTHBOOK` oder ein LLM-Gateway, beginnen Sie stattdessen mit den [Anforderungen](#requirements).205Wenn nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, verbinden sich Ihre Sitzungen weder über den Admin-Standard Ihrer Organisation noch über den eigenen Standard von Claude Code automatisch. Wenn etwas anderes Remote Control für Sie unverfügbar macht, etwa `DISABLE_GROWTHBOOK` oder ein LLM-Gateway, beginnen Sie stattdessen mit den [Voraussetzungen](#requirements).

205 206 

206Das Aktivieren der automatischen Verbindung, wenn nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, erfordert Claude Code v2.1.283 oder später. Um die automatische Verbindung zu nutzen, prüfen Sie, ob Ihre Organisation [Trusted Devices](#trusted-devices) voraussetzt:207Bevor Sie die automatische Verbindung einschalten, während nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, vergewissern Sie sich, dass Ihre Claude Code-Version die [Voraussetzung für diese Variablen](#requirements) erfüllt. Prüfen Sie dann, ob Ihre Organisation [Trusted Devices](#trusted-devices) verlangt:

207 208 

208* **Nicht erforderlich**: Setzen Sie **Enable Remote Control for all sessions** in `/config` auf `true`.209* **Nicht erforderlich**: Setzen Sie **Enable Remote Control for all sessions** in `/config` auf `true`.

209* **Erforderlich**: Remote Control ist nicht verfügbar, solange `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist. Entfernen Sie diejenige der beiden Variablen, die Sie gesetzt haben. Wenn sich Ihre Sitzungen dann immer noch nicht automatisch verbinden, setzen Sie **Enable Remote Control for all sessions** in `/config` auf `true`.210* **Erforderlich**: Remote Control ist nicht verfügbar, solange `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist. Entfernen Sie die Variable, die Sie gesetzt haben. Wenn sich Ihre Sitzungen weiterhin nicht automatisch verbinden, setzen Sie **Enable Remote Control for all sessions** in `/config` auf `true`.

210 211 

211### Sitzungen nach dem Stoppen des Servers fortsetzen212### Sitzungen nach dem Beenden des Servers fortsetzen

212 213 

213Wenn Sie `claude remote-control` mit Strg+C stoppen, reagieren die Sitzungen, die es bediente, nicht mehr von Ihrem Telefon oder Browser. Solange Sie nicht einen anderen `claude remote-control` im selben Verzeichnis ausführten und diesen nicht mit `--no-create-session-in-dir` starteten, archiviert Claude Code sie nicht. Um sie zurückzubringen, führen Sie einen dieser Befehle im selben Verzeichnis aus:214Wenn Sie `claude remote-control` mit Ctrl+C beenden, reagieren die Sitzungen, die es bedient hat, nicht mehr auf Ihrem Telefon oder in Ihrem Browser. Solange Sie kein weiteres `claude remote-control` im selben Verzeichnis ausgeführt und dieses nicht mit `--no-create-session-in-dir` gestartet haben, archiviert Claude Code sie nicht. Um sie zurückzuholen, führen Sie einen dieser Befehle im selben Verzeichnis aus:

214 215 

215* **`claude remote-control`**: Bringt jede Sitzung zurück, die der Server bediente.216* **`claude remote-control`**: Holt jede Sitzung zurück, die der Server bedient hat.

216* **`claude remote-control --continue`**: Bringt nur die Sitzung zurück, die der Server startete, und beendet sich, wenn diese Sitzung endet. Wenn dieses Verzeichnis keinen Datensatz hat, verwendet Claude Code den neuesten aus den anderen Git-Worktrees dieses Repositories.217* **`claude remote-control --continue`**: Holt nur die Sitzung zurück, mit der der Server gestartet wurde, und beendet sich, wenn diese Sitzung endet. Wenn für dieses Verzeichnis kein Eintrag vorhanden ist, verwendet Claude Code den neuesten aus den anderen Git-Worktrees dieses Repositorys.

217* **`claude remote-control --session-id <id>`**: Bringt nur die Sitzung zurück, deren ID Sie übergeben, und beendet sich, wenn diese Sitzung endet. Die ID ist der Teil der Sitzungs-URL unter claude.ai/code zwischen `/code/` und jedem `?`.218* **`claude remote-control --session-id <id>`**: Holt nur die Sitzung zurück, deren ID Sie übergeben, und beendet sich, wenn diese Sitzung endet. Die ID ist der Teil der Sitzungs-URL unter claude.ai/code zwischen `/code/` und einem eventuellen `?`.

218 219 

219Diese Befehle funktionieren etwa vier Stunden, nachdem der Server gestoppt wurde. Danach führen Sie `claude remote-control` aus, um eine neue Sitzung zu starten. Wenn Sie eine Sitzung in der Zwischenzeit archiviert haben, entarchivieren `--continue` und `--session-id` sie auf Claude Code v2.1.228 oder später.220Diese Befehle funktionieren etwa vier Stunden lang, nachdem der Server beendet wurde. Danach führen Sie `claude remote-control` aus, um eine neue Sitzung zu starten. Wenn Sie eine Sitzung zwischenzeitlich archiviert haben, heben `--continue` und `--session-id` die Archivierung ab Claude Code v2.1.228 auf.

220 221 

221Um eine Sitzung zurückzubringen, die Sie mit `claude --remote-control` oder `/remote-control` gestartet haben, setzen Sie die Konversation mit `claude --continue` oder `claude --resume` fort. Informationen zum Berechtigungsmodus, in dem die fortgesetzte Konversation startet, finden Sie unter [Berechtigungsmodus beim Fortsetzen](/docs/de/sessions#permission-mode-on-resume). Wenn Remote Control nicht erneut verbunden wird, siehe [Konnte nicht erneut mit Ihrer Remote-Control-Sitzung verbunden werden](#couldnt-reconnect-to-your-remote-control-session).222Um eine Sitzung zurückzuholen, die Sie mit `claude --remote-control` oder `/remote-control` gestartet haben, setzen Sie die Konversation mit `claude --continue` oder `claude --resume` fort. Informationen zum Berechtigungsmodus, mit dem die fortgesetzte Konversation startet, finden Sie unter [Berechtigungsmodus beim Fortsetzen](/docs/de/sessions#permission-mode-on-resume). Wenn Remote Control keine erneute Verbindung herstellt, siehe [Couldn't reconnect to your Remote Control session](#couldnt-reconnect-to-your-remote-control-session).

222 223 

223Wenn Sie das Gespräch in einem zweiten Terminal fortsetzen, während das erste noch Remote Control aktiviert hat, druckt Claude Code eine `Remote Control not started here`-Benachrichtigung im zweiten Terminal und lässt Remote Control dort stattdessen aus, anstatt die Sitzung vom ersten zu nehmen. Führen Sie `/remote-control` im zweiten Terminal aus, um Remote Control dorthin zu verschieben.224Wenn Sie die Konversation in einem zweiten Terminal fortsetzen, während im ersten noch Remote Control aktiv ist, gibt Claude Code im zweiten Terminal den Hinweis `Remote Control not started here` aus und lässt Remote Control dort ausgeschaltet, anstatt dem ersten die Sitzung wegzunehmen. Führen Sie `/remote-control` im zweiten Terminal aus, um Remote Control dorthin zu verlagern.

224 225 

225Wenn Sie ein Gespräch in Claude Desktop oder einer IDE-Erweiterung fortsetzen, die Remote Control aktiviert hatte, hängt Claude Code es erneut an die bestehende claude.ai-Sitzung an, anstatt eine neue zur Sitzungsliste hinzuzufügen.226Wenn Sie in Claude Desktop oder einer IDE-Erweiterung eine Konversation fortsetzen, bei der Remote Control aktiv war, verbindet Claude Code sie wieder mit der bestehenden claude.ai-Sitzung, anstatt eine neue zur Sitzungsliste hinzuzufügen.

227 

228### Den Standard-Spawn-Modus für ein Projekt festlegen

229 

230Wenn `claude remote-control` beim Start `Spawn mode: <mode> (saved for this folder; press w to change)` ausgibt, startet der Server in einem Spawn-Modus, der zuvor für dieses Projekt gespeichert wurde.

231 

232Der gespeicherte Modus stammt aus einer Auswahl, die Sie in Ihrem eigenen Terminal getroffen haben. Wenn `claude remote-control` dort `Spawn mode for this project:` gefragt hat, hat Claude Code Ihre Antwort übernommen: `1` für `same-dir` oder `2` für `worktree`. Wenn Sie während der Ausführung `w` gedrückt haben, hat Claude Code den Modus übernommen, zu dem Sie gewechselt haben, selbst bei einem Lauf, den Sie mit `--spawn same-dir` oder `--spawn worktree` gestartet haben.

233 

234* Während der Server im Modus `same-dir` oder `worktree` läuft, drücken Sie `w` im Terminal des Servers, um zum jeweils anderen Modus zu wechseln. Das Wechseln erfordert ein Git-Repository oder einen `WorktreeCreate`-Hook.

235* Um für einen einzelnen Lauf einen anderen Modus zu verwenden, übergeben Sie `--spawn <mode>`.

226 236 

227## Verbindung und Sicherheit237## Verbindung und Sicherheit

228 238 


426Eine [Umgebungsvariable](/docs/de/env-vars#features-that-need-feature-flag-fetching), die die Feature-Flag-Evaluierung deaktiviert, ist festgelegt, und die vollständige Meldung nennt die Variable, die Claude Code gefunden hat. In Versionen vor 2.1.154 erzeugt die gleiche Konfiguration stattdessen „Remote Control is not yet enabled for your account“. Was zu tun ist, hängt von der Variable ab, die die Meldung nennt:436Eine [Umgebungsvariable](/docs/de/env-vars#features-that-need-feature-flag-fetching), die die Feature-Flag-Evaluierung deaktiviert, ist festgelegt, und die vollständige Meldung nennt die Variable, die Claude Code gefunden hat. In Versionen vor 2.1.154 erzeugt die gleiche Konfiguration stattdessen „Remote Control is not yet enabled for your account“. Was zu tun ist, hängt von der Variable ab, die die Meldung nennt:

427 437 

428* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK`**: Heben Sie die Festlegung der Variable überall dort auf, wo sie festgelegt ist, in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings).438* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK`**: Heben Sie die Festlegung der Variable überall dort auf, wo sie festgelegt ist, in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings).

429* **`DISABLE_TELEMETRY` oder `DO_NOT_TRACK`**: Bei einem Pro-, Max-, Team- oder Enterprise-Plan mit nicht festgelegtem `DISABLE_GROWTHBOOK` lassen diese Variablen Remote Control verfügbar, es sei denn, Ihre Organisation erfordert [Vertrauenswürdige Geräte](#trusted-devices). Wenn dies der Fall ist, heben Sie die Festlegung der Variable überall dort auf, wo sie festgelegt ist, um Remote Control zu verwenden. Von v2.1.154 bis v2.1.282 erzeugte jede Variable diese Meldung, daher aktualisieren Sie Claude Code auf v2.1.283 oder später.439* **`DISABLE_TELEMETRY` oder `DO_NOT_TRACK`**: Bei einem Pro-, Max-, Team- oder Enterprise-Plan mit nicht festgelegtem `DISABLE_GROWTHBOOK` lassen diese Variablen Remote Control verfügbar, es sei denn, Ihre Organisation erfordert [Vertrauenswürdige Geräte](#trusted-devices). Wenn dies der Fall ist, heben Sie die Festlegung der Variable überall dort auf, wo sie festgelegt ist, um Remote Control zu verwenden. Von v2.1.154 bis v2.1.282 sehen Sie diese Meldung, wenn eine der beiden Variablen festgelegt ist. Aktualisieren Sie Claude Code daher auf eine Version, die die [Anforderung für diese Variablen](#requirements) erfüllt.

430 440 

431### "Remote Control is only available when using Claude via api.anthropic.com"441### "Remote Control is only available when using Claude via api.anthropic.com"

432 442 


441* **Der Fehler erwähnt `disableRemoteControl`**: Ihr IT-Administrator hat Remote Control auf diesem Gerät durch [verwaltete Einstellungen](/docs/de/managed-settings) deaktiviert, unabhängig vom organisationsweiten Umschalter und davon, wie Sie angemeldet sind.451* **Der Fehler erwähnt `disableRemoteControl`**: Ihr IT-Administrator hat Remote Control auf diesem Gerät durch [verwaltete Einstellungen](/docs/de/managed-settings) deaktiviert, unabhängig vom organisationsweiten Umschalter und davon, wie Sie angemeldet sind.

442* **Ihr claude.ai-Plan ist Pro oder Max**: Claude Code ist immer noch unter einer Team- oder Enterprise-Organisation von einer früheren Anmeldung angemeldet, daher überprüft es die Remote-Control-Richtlinie dieser Organisation. Führen Sie `/status` aus, um zu sehen, welcher Plan und welche Organisation Ihre Anmeldung verwendet. Führen Sie `claude auth logout` und dann `claude auth login` aus, um sich erneut unter Ihrem aktuellen Plan anzumelden.452* **Ihr claude.ai-Plan ist Pro oder Max**: Claude Code ist immer noch unter einer Team- oder Enterprise-Organisation von einer früheren Anmeldung angemeldet, daher überprüft es die Remote-Control-Richtlinie dieser Organisation. Führen Sie `/status` aus, um zu sehen, welcher Plan und welche Organisation Ihre Anmeldung verwendet. Führen Sie `claude auth logout` und dann `claude auth login` aus, um sich erneut unter Ihrem aktuellen Plan anzumelden.

443* **Die Meldung sagt nicht, dass Sie den Admin Ihrer Organisation kontaktieren sollen**: Auf Ihre Organisation ist die [HIPAA-Konfiguration](/docs/de/hipaa-setup) angewendet, die Remote Control ausschaltet. Führen Sie zur Bestätigung `/status` aus und suchen Sie in der Zeile `Organization configuration` nach `HIPAA`. Ein Owner sieht den **Remote Control**-Umschalter in den [Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) ausgegraut und kann ihn nicht einschalten. Wenn Sie Fragen zur Konfiguration haben, wenden Sie sich an einen Owner, der das Anthropic-Account-Team Ihrer Organisation kontaktieren kann. Vor v2.1.267 zeigte dieser Fall stattdessen „Remote Control isn't available for your organization due to its compliance policy“.453* **Die Meldung sagt nicht, dass Sie den Admin Ihrer Organisation kontaktieren sollen**: Auf Ihre Organisation ist die [HIPAA-Konfiguration](/docs/de/hipaa-setup) angewendet, die Remote Control ausschaltet. Führen Sie zur Bestätigung `/status` aus und suchen Sie in der Zeile `Organization configuration` nach `HIPAA`. Ein Owner sieht den **Remote Control**-Umschalter in den [Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) ausgegraut und kann ihn nicht einschalten. Wenn Sie Fragen zur Konfiguration haben, wenden Sie sich an einen Owner, der das Anthropic-Account-Team Ihrer Organisation kontaktieren kann. Vor v2.1.267 zeigte dieser Fall stattdessen „Remote Control isn't available for your organization due to its compliance policy“.

454* **Remote Control funktioniert für andere in Ihrer Organisation, aber nicht für Sie**: Wenn Ihre Enterprise-Organisation Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452) verwaltet, können Ihre Rollen die Ursache sein. Remote Control benötigt sowohl die Berechtigung für Cloud-Sitzungen als auch die Berechtigung **Claude Code remote control**. Bitten Sie einen Owner zu prüfen, ob Ihre Rollen beide enthalten, und Fehlendes unter [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) zu ergänzen.

444* **Andernfalls hat ein Owner es für Ihre Organisation nicht aktiviert**: Remote Control ist standardmäßig bei Team- und Enterprise-Plänen deaktiviert. Ein Owner kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den **Remote Control**-Umschalter einschaltet. Dieser Umschalter ist eine serverseitige Organisationseinstellung.455* **Andernfalls hat ein Owner es für Ihre Organisation nicht aktiviert**: Remote Control ist standardmäßig bei Team- und Enterprise-Plänen deaktiviert. Ein Owner kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den **Remote Control**-Umschalter einschaltet. Dieser Umschalter ist eine serverseitige Organisationseinstellung.

445 456 

446Vor v2.1.281 erschien diese Meldung auch, wenn Claude Code die Richtlinie Ihrer Organisation auf diesem Computer nicht geladen hatte, z. B. nach dem Starten im Offline-Modus. Spätere Versionen melden diesen Zustand stattdessen als [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control).457Vor v2.1.281 erschien diese Meldung auch, wenn Claude Code die Richtlinie Ihrer Organisation auf diesem Computer nicht geladen hatte, z. B. nach dem Starten im Offline-Modus. Spätere Versionen melden diesen Zustand stattdessen als [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control).

routines.md +10 −9

Details

33 33 

34Team- und Enterprise-Owner können geplante Aufgaben für alle Mitglieder mit dem Schalter **Scheduled tasks (Was Routines)** unter [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) deaktivieren. Wenn der Schalter ausgeschaltet ist, werden vorhandene geplante Aufgaben nicht mehr ausgeführt und Mitglieder können keine neuen erstellen.34Team- und Enterprise-Owner können geplante Aufgaben für alle Mitglieder mit dem Schalter **Scheduled tasks (Was Routines)** unter [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) deaktivieren. Wenn der Schalter ausgeschaltet ist, werden vorhandene geplante Aufgaben nicht mehr ausgeführt und Mitglieder können keine neuen erstellen.

35 35 

36Wenn Ihre Enterprise-Organisation Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452) verwaltet, benötigen Sie außerdem eine Rolle, die die Berechtigung für geplante Aufgaben enthält. Ein Owner kann sie im Abschnitt **Remote sessions** einer Rolle unter [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) hinzufügen.

37 

36## Beispiel-Anwendungsfälle38## Beispiel-Anwendungsfälle

37 39 

38Jedes Beispiel kombiniert einen Trigger-Typ mit der Art von Arbeit, für die geplante Aufgaben geeignet sind: unbeaufsichtigt, wiederholbar und an ein klares Ergebnis gebunden.40Jedes Beispiel kombiniert einen Trigger-Typ mit der Art von Arbeit, für die geplante Aufgaben geeignet sind: unbeaufsichtigt, wiederholbar und an ein klares Ergebnis gebunden.


48 50 

49Erstellen Sie eine geplante Aufgabe im Web unter [claude.ai/code/routines](https://claude.ai/code/routines), in der Desktop-App oder in der CLI. Alle drei Oberflächen schreiben in dasselbe Cloud-Konto, sodass eine geplante Aufgabe, die Sie in einer Oberfläche erstellen, sofort in den anderen angezeigt wird. Klicken Sie in der Desktop-App auf der Registerkarte **Code** in der Seitenleiste oder im Menü **Mehr** der Seitenleiste auf **Geplant** und dann auf **Neue Aufgabe**, und fahren Sie mit [Im Web erstellen](#create-from-the-web) fort.51Erstellen Sie eine geplante Aufgabe im Web unter [claude.ai/code/routines](https://claude.ai/code/routines), in der Desktop-App oder in der CLI. Alle drei Oberflächen schreiben in dasselbe Cloud-Konto, sodass eine geplante Aufgabe, die Sie in einer Oberfläche erstellen, sofort in den anderen angezeigt wird. Klicken Sie in der Desktop-App auf der Registerkarte **Code** in der Seitenleiste oder im Menü **Mehr** der Seitenleiste auf **Geplant** und dann auf **Neue Aufgabe**, und fahren Sie mit [Im Web erstellen](#create-from-the-web) fort.

50 52 

51Geplante Aufgaben werden autonom als vollständige Claude Code-Cloud-Sitzungen ausgeführt. Sie wählen keinen Berechtigungsmodus. Die Sitzung führt Shell-Befehle aus, verwendet [Skills](/docs/de/skills), die im geklonten Repository committet sind, und ruft alle Konnektoren auf, die Sie einbeziehen, alles ohne Unterbrechung für eine Genehmigung außer bei einigen [Artefakt-Aktionen](#when-a-run-publishes-an-artifact-without-asking).53Geplante Aufgaben werden autonom als vollständige Claude Code-Cloud-Sitzungen ausgeführt. Sie wählen keinen Berechtigungsmodus. Die Sitzung führt Shell-Befehle aus, verwendet [Skills](/docs/de/skills) und ruft alle Konnektoren auf, die Sie einbeziehen, alles ohne Unterbrechung für eine Genehmigung außer bei einigen [Artefakt-Aktionen](#when-a-run-publishes-an-artifact-without-asking). Außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) gehören zu diesen Skills auch die im geklonten Repository committeten Skills.

52 54 

53Was eine geplante Aufgabe erreichen kann, wird bestimmt durch:55Was eine geplante Aufgabe erreichen kann, wird bestimmt durch:

54 56 


116 118 

117Klicken Sie auf **Erstellen**. Der Dialog wird geschlossen und die Detailseite der neuen Aufgabe öffnet sich. Die Aufgabe wird ausgeführt, sobald das nächste Mal einer ihrer Trigger passt. Um eine Ausführung sofort zu starten, klicken Sie auf der Detailseite auf **Jetzt ausführen**.119Klicken Sie auf **Erstellen**. Der Dialog wird geschlossen und die Detailseite der neuen Aufgabe öffnet sich. Die Aufgabe wird ausgeführt, sobald das nächste Mal einer ihrer Trigger passt. Um eine Ausführung sofort zu starten, klicken Sie auf der Detailseite auf **Jetzt ausführen**.

118 120 

119Jede Ausführung erstellt eine neue Sitzung neben Ihren anderen Sitzungen, in der Sie sehen können, was Claude getan hat, Änderungen überprüfen und einen Pull Request erstellen können.121Um zu sehen, was eine Ausführung getan hat, klicken Sie in der Liste **Verlauf** auf der Detailseite darauf. Die Ausführung [öffnet sich als vollständige Sitzung](#view-and-interact-with-runs), eine neue für jede Ausführung, in der Sie sehen können, was Claude getan hat, Änderungen überprüfen und einen Pull Request erstellen können.

120 122 

121#### Dialog mit Repositorys und Umgebung in der Hauptansicht123#### Dialog mit Repositorys und Umgebung in der Hauptansicht

122 124 


147 149 

148Ein Zeitplan-Trigger führt die Aufgabe in einem wiederkehrenden Rhythmus oder einmalig zu einem bestimmten zukünftigen Zeitpunkt aus. Wählen Sie im Erstellungs- oder Bearbeitungsdialog der Aufgabe im Web eine voreingestellte Häufigkeit wie stündlich, täglich oder wöchentlich:150Ein Zeitplan-Trigger führt die Aufgabe in einem wiederkehrenden Rhythmus oder einmalig zu einem bestimmten zukünftigen Zeitpunkt aus. Wählen Sie im Erstellungs- oder Bearbeitungsdialog der Aufgabe im Web eine voreingestellte Häufigkeit wie stündlich, täglich oder wöchentlich:

149 151 

150* **Zeitzone**: Zeiten werden in Ihrer lokalen Zeitzone eingegeben und automatisch umgerechnet, sodass die Aufgabe zu dieser Uhrzeit ausgeführt wird, unabhängig davon, wo sich die Cloud-Infrastruktur befindet.

151* **Ausführungen zur vollen Stunde**: Wenn Sie eine Ausführung genau zur vollen Stunde planen, z. B. 9:00, kann sie mehrere Minuten später starten. Um nahe an der geplanten Zeit zu starten, wählen Sie ein paar Minuten nach der vollen Stunde, z. B. 9:07.152* **Ausführungen zur vollen Stunde**: Wenn Sie eine Ausführung genau zur vollen Stunde planen, z. B. 9:00, kann sie mehrere Minuten später starten. Um nahe an der geplanten Zeit zu starten, wählen Sie ein paar Minuten nach der vollen Stunde, z. B. 9:07.

152* **Benutzerdefinierte Intervalle**: Für ein benutzerdefiniertes Intervall wie alle zwei Stunden wählen Sie die nächstliegende Voreinstellung im Dialog aus und führen dann `/schedule update` in der CLI aus, um einen spezifischen Cron-Ausdruck festzulegen. Das Mindestintervall beträgt eine Stunde; Ausdrücke, die häufiger ausgeführt werden, werden abgelehnt.153* **Benutzerdefinierte Intervalle**: Für einen Rhythmus, den die Voreinstellungen nicht abdecken, erstellen Sie die Aufgabe und wählen Sie in ihrem [Bearbeitungsdialog](#edit-and-control-scheduled-tasks) **Benutzerdefiniert** aus. Geben Sie dann einen Cron-Ausdruck ein, z. B. `0 */2 * * *` für alle zwei Stunden. Um einen Ausdruck über die CLI festzulegen, führen Sie [`/schedule update`](#manage-scheduled-tasks-from-the-cli) aus. Ausdrücke, die häufiger als einmal pro Stunde ausgeführt werden, werden abgelehnt.

154* **Zeitzone**: Wenn Sie eine voreingestellte Häufigkeit wählen, geben Sie die Uhrzeit in Ihrer lokalen Zeitzone ein.

153 155 

154#### Einmalige Ausführung planen156#### Einmalige Ausführung planen

155 157 


159* Einen Cleanup-PR nach Abschluss eines Rollouts zu öffnen161* Einen Cleanup-PR nach Abschluss eines Rollouts zu öffnen

160* Folgearbeiten zu starten, nachdem eine vorgelagerte Änderung ausgeliefert wurde162* Folgearbeiten zu starten, nachdem eine vorgelagerte Änderung ausgeliefert wurde

161 163 

162Nach der Ausführung deaktiviert sich die Aufgabe selbst und die Web-UI markiert sie als **Abgeschlossen**. Um sie erneut auszuführen, öffnen Sie den Bearbeitungsdialog der Aufgabe im Web, der für eine einmalige Aufgabe **Einmalig** anbietet, und legen Sie eine neue Zeit fest.164Nach der Ausführung deaktiviert sich die Aufgabe selbst und die Web-UI markiert sie als **Abgeschlossen**. Um sie erneut auszuführen, öffnen Sie den [Bearbeitungsdialog](#edit-and-control-scheduled-tasks) der Aufgabe im Web und wählen Sie **Einmalig** oder **Einmal**, je nachdem, welche Beschriftung Ihr Dialog anzeigt. Legen Sie dann ein neues Datum und eine neue Uhrzeit in Ihrer lokalen Zeitzone fest und speichern Sie.

163 165 

164Erstellen Sie eine einmalige Ausführung in der CLI, indem Sie die Zeit in natürlicher Sprache beschreiben. Claude löst den Ausdruck anhand der aktuellen Zeit auf und bestätigt den absoluten Zeitstempel vor dem Speichern.166Erstellen Sie eine einmalige Ausführung in der CLI, indem Sie die Zeit in natürlicher Sprache beschreiben. Claude löst den Ausdruck anhand der aktuellen Zeit auf und bestätigt den absoluten Zeitstempel vor dem Speichern.

165 167 


171/schedule in 2 weeks, open a cleanup PR that removes the feature flag173/schedule in 2 weeks, open a cleanup PR that removes the feature flag

172```174```

173 175 

174Die gleiche Umrechnung von lokaler Zeit in UTC wie bei wiederkehrenden Zeitplänen gilt auch für einmalige Zeitstempel.

175 

176Einmalige Ausführungen zählen gegen dasselbe stündliche Limit wie andere geplante Ausführungen. Siehe [Nutzung und Limits](#usage-and-limits) für Details.176Einmalige Ausführungen zählen gegen dasselbe stündliche Limit wie andere geplante Ausführungen. Siehe [Nutzung und Limits](#usage-and-limits) für Details.

177 177 

178### API-Trigger hinzufügen178### API-Trigger hinzufügen


356Konnektoren sind die [claude.ai-Integrationen](/docs/de/mcp#use-mcp-servers-from-claude-ai) in Ihrem Konto. MCP-Server, die Sie lokal in der CLI mit `claude mcp add` hinzugefügt haben, werden auf Ihrem Computer gespeichert statt in Ihrem claude.ai-Konto, daher erscheinen sie nicht in der Konnektorenliste. Um einen dieser Server in einer geplanten Aufgabe zu verwenden:356Konnektoren sind die [claude.ai-Integrationen](/docs/de/mcp#use-mcp-servers-from-claude-ai) in Ihrem Konto. MCP-Server, die Sie lokal in der CLI mit `claude mcp add` hinzugefügt haben, werden auf Ihrem Computer gespeichert statt in Ihrem claude.ai-Konto, daher erscheinen sie nicht in der Konnektorenliste. Um einen dieser Server in einer geplanten Aufgabe zu verwenden:

357 357 

358* **Als Konnektor**: Fügen Sie ihn als Konnektor unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) hinzu358* **Als Konnektor**: Fügen Sie ihn als Konnektor unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) hinzu

359* **Im Repository**: Bei einer geplanten Aufgabe mit einem einzigen Repository können Sie den Server stattdessen in einer committeten [`.mcp.json`](/docs/de/mcp#project-scope) deklarieren, damit er Teil des geklonten Repositorys ist359* **Im Repository**: Bei einer geplanten Aufgabe mit einem einzigen Repository außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) können Sie den Server stattdessen in einer committeten [`.mcp.json`](/docs/de/mcp#project-scope) deklarieren. Eine geplante Aufgabe in einem Projekt lädt `.mcp.json` nicht, fügen Sie den Server daher als Konnektor hinzu

360 360 

361Wenn Sie eine geplante Aufgabe erstellen, sind alle Ihre derzeit verbundenen Konnektoren standardmäßig enthalten. Entfernen Sie alle, die nicht benötigt werden, um zu begrenzen, auf welche Tools Claude während der Ausführung Zugriff hat. Sie können Konnektoren auch direkt im Erstellungs- oder Bearbeitungsdialog der Aufgabe hinzufügen.361Wenn Sie eine geplante Aufgabe erstellen, sind alle Ihre derzeit verbundenen Konnektoren standardmäßig enthalten. Entfernen Sie alle, die nicht benötigt werden, um zu begrenzen, auf welche Tools Claude während der Ausführung Zugriff hat. Sie können Konnektoren auch direkt im Erstellungs- oder Bearbeitungsdialog der Aufgabe hinzufügen.

362 362 


452* Sie befinden sich in einer Cloud-Sitzung, in der das Absenden von `/schedule` mit dem Hinweis beantwortet wird, dass der Befehl in dieser Umgebung nicht verfügbar ist. Verwalten Sie geplante Aufgaben stattdessen über die [Web-UI](https://claude.ai/code/routines)452* Sie befinden sich in einer Cloud-Sitzung, in der das Absenden von `/schedule` mit dem Hinweis beantwortet wird, dass der Befehl in dieser Umgebung nicht verfügbar ist. Verwalten Sie geplante Aufgaben stattdessen über die [Web-UI](https://claude.ai/code/routines)

453* Die Richtlinie Ihrer Organisation deaktiviert [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), die für geplante Aufgaben erforderlich sind. In diesem Fall antwortet das Absenden von `/schedule` stattdessen mit [`Cloud sessions are disabled by your organization's policy`](/docs/de/errors#cloud-sessions-are-disabled-by-your-organizations-policy). Vor v2.1.268 gab es `Unknown command: /schedule` zurück453* Die Richtlinie Ihrer Organisation deaktiviert [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), die für geplante Aufgaben erforderlich sind. In diesem Fall antwortet das Absenden von `/schedule` stattdessen mit [`Cloud sessions are disabled by your organization's policy`](/docs/de/errors#cloud-sessions-are-disabled-by-your-organizations-policy). Vor v2.1.268 gab es `Unknown command: /schedule` zurück

454* Ein Owner hat für Ihre Team- oder Enterprise-Organisation [geplante Aufgaben deaktiviert](#routines-are-disabled-by-your-organizations-policy). Vor v2.1.227 erschien der Befehl in diesem Fall weiterhin, und claude.ai lehnte die Aufgabe ab, wenn Claude versuchte, sie zu erstellen oder auszuführen454* Ein Owner hat für Ihre Team- oder Enterprise-Organisation [geplante Aufgaben deaktiviert](#routines-are-disabled-by-your-organizations-policy). Vor v2.1.227 erschien der Befehl in diesem Fall weiterhin, und claude.ai lehnte die Aufgabe ab, wenn Claude versuchte, sie zu erstellen oder auszuführen

455* Ihre Enterprise-Organisation verwaltet Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452), und keine Ihrer Rollen enthält die Berechtigung für geplante Aufgaben unter **Remote sessions**. Bitten Sie einen Owner, sie einer Ihrer Rollen hinzuzufügen

455 456 

456Sofern die Richtlinie Ihrer Organisation geplante Aufgaben oder Cloud-Sitzungen nicht deaktiviert, können Sie geplante Aufgaben unabhängig von der Konfiguration der CLI unter [claude.ai/code/routines](https://claude.ai/code/routines) erstellen und verwalten.457Wenn die Ursache Ihre CLI-Anmeldung ist oder Sie sich in einer Cloud-Sitzung befinden, können Sie geplante Aufgaben weiterhin unter [claude.ai/code/routines](https://claude.ai/code/routines) erstellen und verwalten. Dafür benötigen Sie dort ein Pro-, Max-, Team- oder Enterprise-Konto. Wenn geplante Aufgaben oder Cloud-Sitzungen für Ihre Organisation deaktiviert sind oder in Ihren Rollen fehlen, können Sie sie auch im Web nicht erstellen.

457 458 

458### "Routines are disabled by your organization's policy"459### "Routines are disabled by your organization's policy"

459 460 

sandboxing.md +16 −2

Details

546 546 

547Wenn `git merge` oder `git checkout` bei einem dieser Pfade mit `unable to unlink old` fehlschlägt, lesen Sie [Ein Git-Befehl schlägt mit `unable to unlink old` fehl](#a-git-command-fails-with-unable-to-unlink-old).547Wenn `git merge` oder `git checkout` bei einem dieser Pfade mit `unable to unlink old` fehlschlägt, lesen Sie [Ein Git-Befehl schlägt mit `unable to unlink old` fehl](#a-git-command-fails-with-unable-to-unlink-old).

548 548 

549#### Gesperrte Pfade, die über einen Symlink führen

550 

551Wenn unter macOS ein gesperrter Pfad über einen Symlink führt, etwa ein `~/.claude`, das ein Link in ein Dotfiles-Repository ist, sperrt die Sandbox auch den tatsächlichen Speicherort des Pfads. Dies umfasst die eigenen Sperren der Sandbox sowie Ihre wörtlichen `denyWrite`- und `denyRead`-Einträge.

552 

549### Netzwerkisolation553### Netzwerkisolation

550 554 

551Ein in der Sandbox ausgeführter Befehl hat keinen direkten Zugang zum Netzwerk:555Ein in der Sandbox ausgeführter Befehl hat keinen direkten Zugang zum Netzwerk:


974✗ Sandbox settings not changed: /home/you/project/.claude/settings.local.json couldn't be updated (EACCES). Start Claude Code in a project folder you can write to.978✗ Sandbox settings not changed: /home/you/project/.claude/settings.local.json couldn't be updated (EACCES). Start Claude Code in a project folder you can write to.

975```979```

976 980 

977Wenn der Grund in Klammern `EACCES`, `EPERM` oder `EROFS` lautet, starten Sie Claude Code in einem Projektordner, in den Sie schreiben können, und führen Sie `/sandbox` in dieser Sitzung erneut aus.981Wenn der Grund in Klammern `EACCES`, `EPERM` oder `EROFS` lautet, starten Sie Claude Code in einem Projektordner, in den Sie schreiben können, und führen Sie `/sandbox` in dieser Sitzung erneut aus. Wenn der Grund mit `Invalid JSON syntax in settings file` beginnt, korrigieren Sie das JSON in der `.claude/settings.local.json` Ihres Projekts und führen Sie `/sandbox` anschließend erneut aus.

982 

983Wenn Ihnen kein beschreibbarer Projektordner zur Verfügung steht, aktivieren Sie die Sandbox stattdessen über Ihre Benutzereinstellungen. Fügen Sie Folgendes zu `~/.claude/settings.json` hinzu:

984 

985```json theme={null}

986{

987 "sandbox": {

988 "enabled": true

989 }

990}

991```

978 992 

979Wenn der Grund mit `Invalid JSON syntax in settings file` beginnt, korrigieren Sie das JSON in der `.claude/settings.local.json` Ihres Projekts und führen Sie `/sandbox` anschließend erneut aus.993Dadurch wird der [Auto-Allow-Modus](#sandbox-modes) aktiviert. Für den regulären Berechtigungsmodus setzen Sie zusätzlich [`sandbox.autoAllowBashIfSandboxed`](/docs/de/settings-reference#sandbox-autoallowbashifsandboxed) auf `false`. Die Änderung wird in Ihrer laufenden Sitzung beim nächsten Shell-Befehl wirksam, den Claude ausführt, und der Tab **Mode** von `/sandbox` markiert anschließend den aktiven Modus.

980 994 

981## Einschränkungen995## Einschränkungen

982 996 

Details

30| Zugriff auf lokale Dateien | Nein (frischer Klon) | Ja | Ja |30| Zugriff auf lokale Dateien | Nein (frischer Klon) | Ja | Ja |

31| MCP-Server | Konnektoren pro Aufgabe konfiguriert | [Konfigurationsdateien](/docs/de/mcp) und Konnektoren | Erbt von Sitzung |31| MCP-Server | Konnektoren pro Aufgabe konfiguriert | [Konfigurationsdateien](/docs/de/mcp) und Konnektoren | Erbt von Sitzung |

32| Berechtigungsaufforderungen | Nein (läuft autonom) | Pro Aufgabe konfigurierbar | Erbt von Sitzung |32| Berechtigungsaufforderungen | Nein (läuft autonom) | Pro Aufgabe konfigurierbar | Erbt von Sitzung |

33| Anpassbarer Zeitplan | Via `/schedule` in der CLI | Ja | Ja |33| Anpassbarer Zeitplan | Ja | Ja | Ja |

34| Minimales Intervall | 1 Stunde | 1 Minute | 1 Minute |34| Minimales Intervall | 1 Stunde | 1 Minute, wenn Claude es festlegt, [1 Stunde in den Formularen](/docs/de/desktop-scheduled-tasks#schedule-options) | 1 Minute |

35 35 

36> [!TIP]36> [!TIP]

37>37>


124 124 

125### Stoppen Sie eine Schleife125### Stoppen Sie eine Schleife

126 126 

127Um eine [selbstgesteuertem `/loop`](#let-claude-choose-the-interval) zu stoppen, während sie auf die nächste Iteration wartet, drücken Sie `Esc`. Dies löscht den ausstehenden Wakeup, sodass die Schleife nicht erneut läuft. Aufgaben, die Sie durch [direktes Fragen an Claude](#manage-scheduled-tasks) geplant haben, sind nicht von `Esc` betroffen und bleiben bestehen, bis Sie sie löschen.127* **[Selbstgesteuerte Schleife](#let-claude-choose-the-interval)**: Während die Schleife auf ihre nächste Iteration wartet, drücken Sie `Esc`, um sie zu stoppen. Sie können sie auch mit `Ctrl+C` stoppen, während Claude inaktiv ist, außer in einer [Hintergrundsitzung, an die Sie angehängt sind](#detach-without-stopping-a-loop). Ein Hinweis `Pending wakeup cancelled` bestätigt, dass die Schleife nicht erneut ausgelöst wird.

128* **[Schleife mit festem Intervall](#run-on-a-fixed-interval)**: Um eine Schleife wie `/loop 5m` zu stoppen, bitten Sie Claude, sie abzubrechen, zum Beispiel `cancel the deploy check loop`. `Esc` und `Ctrl+C` stoppen sie nicht, ebenso wenig wie Aufgaben, die Sie [durch direktes Fragen an Claude geplant haben](#manage-scheduled-tasks). Eine Schleife, die Sie nicht abbrechen, endet, wenn [sieben Tage vergehen](#seven-day-expiry).

128 129 

129Im [selbstgesteuertem Modus](#let-claude-choose-the-interval) kann Claude die Schleife auch selbst beenden, sobald die Aufgabe abgeschlossen ist. Claude ruft das [`ScheduleWakeup`-Tool](/docs/de/tools-reference) mit `stop: true` auf, was den ausstehenden Wakeup sofort storniert. Wenn eine Iteration endet, ohne entweder neu zu planen oder zu stoppen, plant Claude Code einen Fallback-Wakeup etwa 20 Minuten später und beendet die Schleife, wenn diese Iteration auch nicht neu plant.130Im [selbstgesteuertem Modus](#let-claude-choose-the-interval) kann Claude die Schleife auch selbst beenden, sobald die Aufgabe abgeschlossen ist. Claude ruft das [`ScheduleWakeup`-Tool](/docs/de/tools-reference) mit `stop: true` auf, was den ausstehenden Wakeup sofort storniert. Wenn eine Iteration endet, ohne entweder neu zu planen oder zu stoppen, plant Claude Code einen Fallback-Wakeup etwa 20 Minuten später und beendet die Schleife, wenn diese Iteration auch nicht neu plant.

130 131 

131Schleifen nach einem festen Intervall laufen weiter, bis Sie sie [wie jede andere geplante Aufgabe stornieren](#manage-scheduled-tasks) oder [sieben Tage vergehen](#seven-day-expiry).132#### Trennen, ohne eine Schleife zu stoppen

133 

134Wenn Sie [an eine Hintergrundsitzung angehängt sind](/docs/de/agent-view#attach-to-a-session) und Claude inaktiv ist, drücken Sie bei leerem Prompt zweimal `Ctrl+C`, um sich zu trennen. Eine selbstgesteuerte Schleife, die dort auf ihre nächste Iteration wartet, läuft weiter, und diese Iteration startet planmäßig. Um die Schleife stattdessen zu stoppen, drücken Sie `Esc`, bevor Sie sich trennen. Das Trennen mit `Ctrl+C`, ohne die Schleife zu stoppen, erfordert Claude Code v2.1.295 oder später.

132 135 

133## Setzen Sie eine einmalige Erinnerung136## Setzen Sie eine einmalige Erinnerung

134 137 


232 235 

233* Aufgaben laufen nur, während Claude Code läuft und untätig ist. Das Schließen des Terminals oder das Beenden der Sitzung stoppt sie. [Backgrounding der Sitzung](/docs/de/agent-view#from-inside-a-session) trägt `/loop`-Aufgaben zu einer Hintergrund-Sitzung über, die ohne Terminal weiterläuft.236* Aufgaben laufen nur, während Claude Code läuft und untätig ist. Das Schließen des Terminals oder das Beenden der Sitzung stoppt sie. [Backgrounding der Sitzung](/docs/de/agent-view#from-inside-a-session) trägt `/loop`-Aufgaben zu einer Hintergrund-Sitzung über, die ohne Terminal weiterläuft.

234* Kein Aufholen für verpasste Läufe. Wenn die geplante Zeit einer Aufgabe verstreicht, während Claude mit einer langwierigen Anfrage beschäftigt ist, läuft sie einmal, wenn Claude untätig wird, nicht einmal pro verpasstem Intervall.237* Kein Aufholen für verpasste Läufe. Wenn die geplante Zeit einer Aufgabe verstreicht, während Claude mit einer langwierigen Anfrage beschäftigt ist, läuft sie einmal, wenn Claude untätig wird, nicht einmal pro verpasstem Intervall.

235* Wenn Sie eine Sitzung mit `claude --resume` oder `claude --continue` fortsetzen, stellt Claude Code die mit `CronCreate` geplanten Aufgaben wieder her, außer wiederkehrenden Aufgaben, die [abgelaufen sind](#seven-day-expiry), und einmaligen Aufgaben, deren geplante Zeit bereits vergangen ist. Ein [selbstgesteuerter `/loop`](#let-claude-choose-the-interval) wird nicht wiederhergestellt, daher führen Sie `/loop` erneut aus, um ihn neu zu starten. Hintergrund-Bash- und Monitor-Aufgaben werden bei Fortsetzen nie wiederhergestellt.238* In einer [Hintergrund-Sitzung](/docs/de/agent-view#from-inside-a-session) stoppt eine [selbstgesteuerte Schleife](#let-claude-choose-the-interval), wenn ihr nächstes Aufwachen fällig wird, während der Prozess der Sitzung nicht läuft, etwa nach einem Absturz. Wenn der Prozess erneut startet, zeigt das Transkript einen [Hinweis, dass das Aufwachen nicht ausgelöst wird](/docs/de/errors#restarted-after-its-next-loop-wakeup-was-due). Um die Schleife fortzusetzen, [antworten Sie in der Sitzung](/docs/de/agent-view#peek-and-reply) und bitten Sie Claude, sie weiterlaufen zu lassen.

239* Wenn Sie eine Sitzung mit `claude --resume` oder `claude --continue` fortsetzen, stellt Claude Code die mit `CronCreate` geplanten Aufgaben wieder her, außer wiederkehrenden Aufgaben, die [abgelaufen sind](#seven-day-expiry), und einmaligen Aufgaben, deren geplante Zeit bereits vergangen ist. Ein [selbstgesteuerter `/loop`](#let-claude-choose-the-interval) wird nicht wiederhergestellt, daher führen Sie `/loop` erneut aus, um ihn neu zu starten.

240* Eine wiederhergestellte wiederkehrende Aufgabe wird für die Läufe, die sie verpasst hat, während die Sitzung nicht lief, nicht nachträglich ausgeführt. Ihr nächster Lauf ist der erste, der nach dem Fortsetzen fällig ist, und [Jitter](#jitter) gilt für diesen Lauf.

241* Wenn Sie mit `claude --resume` oder `claude --continue` fortsetzen, startet Claude Code die Bash-Befehle im Hintergrund und die Monitore, die beim Beenden der Sitzung liefen, nicht neu. Wenn Sie einen davon weiterhin benötigen, bitten Sie Claude, ihn erneut zu starten.

236* Mit [Feature-Flag-Abruf deaktiviert](/docs/de/env-vars#features-that-need-feature-flag-fetching) speichert Claude Code eine Aufgabe, die Sie über Sitzungen hinweg behalten möchten, in der Datei `.claude/scheduled_tasks.json` des Projekts. Wenn das `.claude`-Verzeichnis oder diese Datei ein Symlink ist, gibt Claude Code einen Fehler zurück, anstatt die Aufgabe zu planen. Eine gespeicherte Aufgabe läuft nur in dem Projektordner, in dem Sie sie erstellt haben. Wenn Sie die Datei in einen anderen Ordner kopieren, z. B. in einen neuen Worktree, listen Sitzungen dort die kopierten Aufgaben auf, führen sie aber nicht aus. Erstellen Sie die Aufgabe daher erneut in diesem Ordner.242* Mit [Feature-Flag-Abruf deaktiviert](/docs/de/env-vars#features-that-need-feature-flag-fetching) speichert Claude Code eine Aufgabe, die Sie über Sitzungen hinweg behalten möchten, in der Datei `.claude/scheduled_tasks.json` des Projekts. Wenn das `.claude`-Verzeichnis oder diese Datei ein Symlink ist, gibt Claude Code einen Fehler zurück, anstatt die Aufgabe zu planen. Eine gespeicherte Aufgabe läuft nur in dem Projektordner, in dem Sie sie erstellt haben. Wenn Sie die Datei in einen anderen Ordner kopieren, z. B. in einen neuen Worktree, listen Sitzungen dort die kopierten Aufgaben auf, führen sie aber nicht aus. Erstellen Sie die Aufgabe daher erneut in diesem Ordner.

237 243 

238Für Cron-gesteuerte Automatisierung, die unbeaufsichtigt laufen muss:244Für Cron-gesteuerte Automatisierung, die unbeaufsichtigt laufen muss:

security.md +2 −2

Details

17Der Berechtigungsmodus einer Sitzung legt fest, welche Aktionen Claude ausführen kann, ohne Sie vorher zu fragen. Der Auto-Modus ist der integrierte anfängliche Berechtigungsmodus für interaktive Terminal- und VS Code-Sitzungen. [Mit welchem Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) behandelt frühere Versionen, andere Oberflächen und die Einstellungen, die den anfänglichen Berechtigungsmodus ändern.17Der Berechtigungsmodus einer Sitzung legt fest, welche Aktionen Claude ausführen kann, ohne Sie vorher zu fragen. Der Auto-Modus ist der integrierte anfängliche Berechtigungsmodus für interaktive Terminal- und VS Code-Sitzungen. [Mit welchem Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) behandelt frühere Versionen, andere Oberflächen und die Einstellungen, die den anfänglichen Berechtigungsmodus ändern.

18 18 

19* **Auto-Modus**: Ein separates Klassifikatormodell überprüft Aktionen anstelle von Ihnen und blockiert diejenigen, die es als unsicher einstuft. [Wie der Klassifikator Aktionen bewertet](/docs/de/permission-modes#how-the-classifier-evaluates-actions) listet auf, welche Aktionen Claude Code direkt genehmigt, welche es an den Klassifikator sendet und bei welchen Claude Code Sie weiterhin fragt. Ihre expliziten Nachfrage- und Ablehnungsregeln gelten weiterhin, und Ihre Organisation kann [den Auto-Modus deaktivieren](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)19* **Auto-Modus**: Ein separates Klassifikatormodell überprüft Aktionen anstelle von Ihnen und blockiert diejenigen, die es als unsicher einstuft. [Wie der Klassifikator Aktionen bewertet](/docs/de/permission-modes#how-the-classifier-evaluates-actions) listet auf, welche Aktionen Claude Code direkt genehmigt, welche es an den Klassifikator sendet und bei welchen Claude Code Sie weiterhin fragt. Ihre expliziten Nachfrage- und Ablehnungsregeln gelten weiterhin, und Ihre Organisation kann [den Auto-Modus deaktivieren](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)

20* **Manueller Modus**: Claude Code startet mit reinen Leseberechtigungen. Wenn es Dateien bearbeiten, Tests ausführen oder Befehle ausführen muss, fragt es Sie zuerst, und Sie entscheiden, ob Sie die Aktion einmalig genehmigen oder von nun an zulassen möchten. Es führt einen integrierten Satz [nur lesender Befehle](/docs/de/permissions#read-only-commands) wie `ls`, `cat` und `git status` aus, ohne nachzufragen20* **Manual-Modus**: Claude Code startet mit reinen Leseberechtigungen. Wenn es Dateien bearbeiten, Tests ausführen oder Befehle ausführen muss, fragt es Sie zuerst, und Sie entscheiden, ob Sie die Aktion einmalig genehmigen oder von nun an zulassen möchten. Es führt einen integrierten Satz [nur lesender Befehle](/docs/de/permissions#read-only-commands) wie `ls`, `cat` und `git status` aus, ohne nachzufragen

21 21 

22Sie und Ihre Organisation konfigurieren diese Berechtigungen direkt. Für detaillierte Berechtigungskonfiguration siehe [Berechtigungen](/docs/de/permissions).22Sie und Ihre Organisation konfigurieren diese Berechtigungen direkt. Für detaillierte Berechtigungskonfiguration siehe [Berechtigungen](/docs/de/permissions).

23 23 


26Um Risiken in agentengestützten Systemen zu mindern:26Um Risiken in agentengestützten Systemen zu mindern:

27 27 

28* **Sandbox-Bash-Tool**: [Sandbox](/docs/de/sandboxing) Bash-Befehle mit Dateisystem- und Netzwerkisolation, wodurch Berechtigungsaufforderungen reduziert werden, während die Sicherheit gewährleistet bleibt. Konfigurieren Sie mit `/sandbox`, um Grenzen zu definieren, in denen Claude Code autonom arbeiten kann28* **Sandbox-Bash-Tool**: [Sandbox](/docs/de/sandboxing) Bash-Befehle mit Dateisystem- und Netzwerkisolation, wodurch Berechtigungsaufforderungen reduziert werden, während die Sicherheit gewährleistet bleibt. Konfigurieren Sie mit `/sandbox`, um Grenzen zu definieren, in denen Claude Code autonom arbeiten kann

29* **Arbeitsverzeichnis-Grenze**: Im manuellen Modus fragt Claude Code Sie, bevor seine Datei-Tools außerhalb des Ordners, in dem es gestartet wurde, und dessen Unterordnern lesen oder schreiben. Die Grenze ist eine Berechtigungsabfrage, sodass ein von Ihnen genehmigter Bash-Befehl weiterhin überall dort schreiben kann, wo Ihr Benutzerkonto Schreibrechte hat29* **Arbeitsverzeichnis-Grenze**: Im Manual-Modus fragt Claude Code Sie, bevor seine Datei-Tools außerhalb des Ordners, in dem es gestartet wurde, und dessen Unterordnern lesen oder schreiben. Die Grenze ist eine Berechtigungsabfrage, sodass ein von Ihnen genehmigter Bash-Befehl weiterhin überall dort schreiben kann, wo Ihr Benutzerkonto Schreibrechte hat

30 * Um einen Ordner ohne Abfrage zu lesen, fügen Sie ihn als [zusätzliches Verzeichnis](/docs/de/permissions#working-directories) hinzu30 * Um einen Ordner ohne Abfrage zu lesen, fügen Sie ihn als [zusätzliches Verzeichnis](/docs/de/permissions#working-directories) hinzu

31 * Um Bash-Befehle auf Betriebssystemebene einzuschränken, aktivieren Sie [Sandboxing](/docs/de/sandboxing#filesystem-isolation)31 * Um Bash-Befehle auf Betriebssystemebene einzuschränken, aktivieren Sie [Sandboxing](/docs/de/sandboxing#filesystem-isolation)

32* **Minderung von Genehmigungsmüdigkeit**: Unterstützung für das Zulassen häufig verwendeter sicherer Befehle pro Benutzer, pro Codebasis oder pro Organisation32* **Minderung von Genehmigungsmüdigkeit**: Unterstützung für das Zulassen häufig verwendeter sicherer Befehle pro Benutzer, pro Codebasis oder pro Organisation

Details

281| `CLAUDE_RUNNER_ATTEMPT` | Ein Zähler pro Sitzung zur Verwendung in Logs. Er ist weder eine Anzahl von Wiederholungsversuchen noch eine Anzahl von Anfragen. `0` für Pre-Warming-Anfragen, wobei auch eine Anfrage für eine Sitzung `0` enthalten kann. |281| `CLAUDE_RUNNER_ATTEMPT` | Ein Zähler pro Sitzung zur Verwendung in Logs. Er ist weder eine Anzahl von Wiederholungsversuchen noch eine Anzahl von Anfragen. `0` für Pre-Warming-Anfragen, wobei auch eine Anfrage für eine Sitzung `0` enthalten kann. |

282| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | Server-Zeit aus dem HTTP-`Date`-Header der Poll-Antwort. Wenn der Hook das Arbeitsorder-JWT `exp` überprüft, vergleichen Sie gegen diesen Wert anstelle der lokalen Uhr, um Skew zu tolerieren. Leer, wenn das Gateway den Header weggelassen hat. |282| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | Server-Zeit aus dem HTTP-`Date`-Header der Poll-Antwort. Wenn der Hook das Arbeitsorder-JWT `exp` überprüft, vergleichen Sie gegen diesen Wert anstelle der lokalen Uhr, um Skew zu tolerieren. Leer, wenn das Gateway den Header weggelassen hat. |

283| `CLAUDE_RUNNER_POOL_ID` | Die ID der Umgebung, der der neue Runner beitreten sollte, in der Form `ccpool_...` |283| `CLAUDE_RUNNER_POOL_ID` | Die ID der Umgebung, der der neue Runner beitreten sollte, in der Form `ccpool_...` |

284| `CLAUDE_RUNNER_ACCOUNT_ID` | Getaggte ID des Kontos, das die Sitzung in die Warteschlange eingereiht hat, für Pro-Konto-Routing, Kontingent oder Chargeback. Leer, wenn nicht verfügbar, und immer leer für Claude Tag-Kanal-Sitzungen, die kein Konto einreiht. |284| `CLAUDE_RUNNER_ACCOUNT_ID` | Getaggte ID des Kontos, das die Sitzung in die Warteschlange eingereiht hat. Verwenden Sie sie für Pro-Konto-Routing, Kontingent oder Chargeback, nicht als Dedup-Schlüssel. Leer, wenn nicht verfügbar, und immer leer für Claude Tag-Channel-Sitzungen, die kein Konto einreiht. |

285| `CLAUDE_RUNNER_ACCOUNT_EMAIL` | E-Mail des Kontos, das die Sitzung in die Warteschlange eingereiht hat. Leer, wenn nicht verfügbar. Behandeln Sie die E-Mail als personenbezogene Informationen und protokollieren Sie sie nicht. |285| `CLAUDE_RUNNER_ACCOUNT_EMAIL` | E-Mail des Kontos, das die Sitzung in die Warteschlange eingereiht hat. Leer, wenn nicht verfügbar. Behandeln Sie die E-Mail als personenbezogene Informationen und protokollieren Sie sie nicht. |

286| `CLAUDE_RUNNER_PRIMARY_REPO_URL` | URL der ersten Git-Quelle der Sitzung, für Routing zu einem Runner mit diesem Repository pre-warmed. Leer, wenn die Sitzung keine Git-Quellen hat. |286| `CLAUDE_RUNNER_PRIMARY_REPO_URL` | URL der ersten Git-Quelle der Sitzung, für Routing zu einem Runner mit diesem Repository pre-warmed. Leer, wenn die Sitzung keine Git-Quellen hat. |

287| `CLAUDE_RUNNER_PRIMARY_REPO_REVISION` | Revision der ersten Git-Quelle der Sitzung: Branch, SHA, Tag oder vollständiger Referenzname. Leer, wenn nicht angegeben. |287| `CLAUDE_RUNNER_PRIMARY_REPO_REVISION` | Revision der ersten Git-Quelle der Sitzung: Branch, SHA, Tag oder vollständiger Referenzname. Leer, wenn nicht angegeben. |


306 * **Exit 1 oder Hook läuft bei Ablauf von `--hook-timeout` noch**: wiederholbarer Fehler. Die Sitzung wartet mit Backoff und wird erneut angeboten.306 * **Exit 1 oder Hook läuft bei Ablauf von `--hook-timeout` noch**: wiederholbarer Fehler. Die Sitzung wartet mit Backoff und wird erneut angeboten.

307 * **Exit 2 oder höher**: nicht wiederholbarer Fehler. Die Sitzung wird für weitere Spawns blockiert, bis ein Benutzer ihr eine neue Nachricht sendet oder ein [Owner](/docs/de/cloud-environments#organization-shared-environments) auf der Registerkarte **Aktivität** der Umgebung **Erneut versuchen** auswählt.307 * **Exit 2 oder höher**: nicht wiederholbarer Fehler. Die Sitzung wird für weitere Spawns blockiert, bis ein Benutzer ihr eine neue Nachricht sendet oder ein [Owner](/docs/de/cloud-environments#organization-shared-environments) auf der Registerkarte **Aktivität** der Umgebung **Erneut versuchen** auswählt.

308 308 

309 Bei einem Exit ungleich null erscheint das Ende der stderr-Ausgabe des Hooks auf der Registerkarte **Aktivität** als Fehlergrund; schreiben Sie daher den umsetzbaren Fehler auf stderr und schreiben Sie dort niemals Geheimnisse. In einem Shell-Hook [halten Sie vorübergehende Fehler wiederholbar](#keep-transient-failures-retryable-in-a-shell-hook).309 Während eine Sitzung mit Backoff wartet, wird sie auf der Registerkarte **Aktivität** als **In Warteschlange** ohne Spawn-Fehler angezeigt; lesen Sie daher die Ausgabe des Hooks im Log des Orchestrators. Sobald die Sitzung blockiert ist, wird sie als **Fehlgeschlagen** angezeigt. Erweitern Sie sie, um den Spawn-Fehler zu lesen, der aus den letzten 512 Zeichen der stderr-Ausgabe des Hooks stammt. Schreiben Sie einen umsetzbaren Fehler auf stderr und keine Geheimnisse. In einem Shell-Hook [halten Sie vorübergehende Fehler wiederholbar](#keep-transient-failures-retryable-in-a-shell-hook).

310 310 

311 Eine Pre-Warming-Anfrage hat keine Sitzung, die fehlschlagen kann: Der Orchestrator protokolliert einen Exit ungleich null nur lokal, und der Server fordert den Spawn erneut an, nachdem das Lease von `--expected-spawn-seconds` abgelaufen ist.311 Eine Pre-Warming-Anfrage hat keine Sitzung, die fehlschlagen kann: Der Orchestrator protokolliert einen Exit ungleich null nur lokal, und der Server fordert den Spawn erneut an, nachdem das Lease von `--expected-spawn-seconds` abgelaufen ist.

3124. **Setzen Sie `--expected-spawn-seconds` auf mindestens Ihre p99-Zeit von der Spawn-Anfrage bis zur Runner-Registrierung.** Messen Sie ab dem Zeitpunkt, an dem der Orchestrator die Spawn-Anfrage erhält, und beziehen Sie jede Wartezeit auf Kapazität auf Ihrer Plattform sowie die Boot-Zeit ein. Dieser Wert ist das serverseitige Lease, und die Arbeitsorder läuft mit ihm ab, sodass sich ein Runner, dessen Workload länger braucht, nicht registrieren kann. Alle Orchestrator-Replikas müssen denselben Wert verwenden.3124. **Setzen Sie `--expected-spawn-seconds` auf mindestens Ihre p99-Zeit von der Spawn-Anfrage bis zur Runner-Registrierung.** Messen Sie ab dem Zeitpunkt, an dem der Orchestrator die Spawn-Anfrage erhält, und beziehen Sie jede Wartezeit auf Kapazität auf Ihrer Plattform sowie die Boot-Zeit ein. Dieser Wert ist das serverseitige Lease, und die Arbeitsorder läuft mit ihm ab, sodass sich ein Runner, dessen Workload länger braucht, nicht registrieren kann. Alle Orchestrator-Replikas müssen denselben Wert verwenden.


327 327 

328Entfernen Sie die Workload, wenn sich der Runner beendet, zum Beispiel indem Sie `ttlSecondsAfterFinished` auf einem Kubernetes Job setzen oder das Startskript der VM die VM anschließend löschen lassen.328Entfernen Sie die Workload, wenn sich der Runner beendet, zum Beispiel indem Sie `ttlSecondsAfterFinished` auf einem Kubernetes Job setzen oder das Startskript der VM die VM anschließend löschen lassen.

329 329 

330#### Ausgabe eines Hintergrundprozesses in eine Datei umleiten

331 

332Wenn Ihr `spawn-runner`-Hook einen Prozess im Hintergrund weiterlaufen lässt, leiten Sie die Ausgabe dieses Prozesses in eine Datei um, die der Benutzer des Hooks anlegen kann. Hängen Sie zum Beispiel `>> "$HOME/claude-runner.log" 2>&1` an den Befehl an, der den Prozess startet, und zwar vor einem etwaigen `&`. Diese Hook-Zeile zeigt, wo die Umleitung steht, wobei `your-background-command` für den Befehl steht, den Ihr Hook im Hintergrund ausführt:

333 

334```bash theme={null}

335your-background-command >> "$HOME/claude-runner.log" 2>&1 &

336```

337 

338Ohne die Umleitung schreibt der Prozess auf stdout und stderr des Hooks:

339 

340* Etwa eine Sekunde nach dem Ende des Hooks protokolliert der Orchestrator `exited, but a process it started still has the hook's stdout or stderr open`. Ab dieser Zeile protokolliert er bis zu 64 KB weitere Ausgabe davon unter `[runner:hook:spawn-runner:after-exit jti=<order id>]` und verwirft dann den Rest.

341* Sobald sich der Orchestrator beendet, schlagen die Schreibvorgänge des Prozesses dorthin fehl.

342 

343Ein Runner, den Ihr Hook selbst startet, führt Sitzungen auf dem Orchestrator-Host aus, der das [Umgebungsgeheimnis](/docs/de/self-hosted-environments-deploy#harden-your-deployment) enthält.

344 

345Vor v2.1.305 lief ein bereits beendeter Hook trotzdem bis zum [`--hook-timeout`](/docs/de/self-hosted-environments-reference#orchestrator-cli-flags), solange ein von ihm gestarteter Prozess stdout oder stderr des Hooks geöffnet hielt. Dies wurde so angezeigt:

346 

347* **Registerkarte Aktivität**, im Spawn-Fehler einer fehlgeschlagenen Sitzung: `spawn-runner hook timed out after 60000ms` oder die letzten Zeilen auf stderr des Hooks.

348* **Orchestrator-Log**: `timed out after 60000ms, sending SIGTERM to process tree`.

349 

330#### Vorübergehende Fehler in einem Shell-Hook wiederholbar halten350#### Vorübergehende Fehler in einem Shell-Hook wiederholbar halten

331 351 

332In einem Shell-Hook, der `set -e` verwendet, kann ein Fehler, den ein Wiederholungsversuch hätte beheben können, die Sitzung blockieren. Der Hook stoppt beim fehlschlagenden Befehl und endet mit dem eigenen Status dieses Befehls, und der Orchestrator wendet den Exit-Code-Vertrag auf diesen Status an. Viele Fehler geben einen Status von 2 oder höher zurück, etwa `127`, wenn ein Befehl nicht installiert ist, und `22` von `curl --fail` bei einem HTTP-Fehler, sodass sie die Sitzung bereits beim ersten Fehler blockieren.352In einem Shell-Hook, der `set -e` verwendet, kann ein Fehler, den ein Wiederholungsversuch hätte beheben können, die Sitzung blockieren. Der Hook stoppt beim fehlschlagenden Befehl und endet mit dem eigenen Status dieses Befehls, und der Orchestrator wendet den Exit-Code-Vertrag auf diesen Status an. Viele Fehler geben einen Status von 2 oder höher zurück, etwa `127`, wenn ein Befehl nicht installiert ist, und `22` von `curl --fail` bei einem HTTP-Fehler, sodass sie die Sitzung bereits beim ersten Fehler blockieren.


350 ```bash theme={null}370 ```bash theme={null}

351 trap 'rc=$?; your-cleanup-command || true; [ "$rc" -eq 0 ] || [ -n "${PERMANENT:-}" ] || exit 1' EXIT371 trap 'rc=$?; your-cleanup-command || true; [ "$rc" -eq 0 ] || [ -n "${PERMANENT:-}" ] || exit 1' EXIT

352 ```372 ```

353* **Befehle, die fehlschlagen dürfen**: Wenn der Hook zuvor kein `set -e` verwendet hat, stoppt er jetzt beim ersten Befehl, der einen Wert ungleich null zurückgibt, etwa bei einer Suche ohne Ergebnis oder einer doppelten Einreichung, die Ihre Plattform ablehnt. Wenn der Hook auf das Ergebnis reagiert, machen Sie diesen Befehl zur Bedingung eines `if`. Wenn er das Ergebnis ignoriert, hängen Sie `|| true` an den Befehl an.373* **Befehle, die fehlschlagen dürfen**: Wenn der Hook zuvor kein `set -e` verwendet hat, stoppt er jetzt beim ersten Befehl, der einen Wert ungleich null zurückgibt, etwa bei einer Suche ohne Ergebnis. Wenn der Hook auf das Ergebnis reagiert, machen Sie diesen Befehl zur Bedingung eines `if`. Wenn er das Ergebnis ignoriert, hängen Sie `|| true` an den Befehl an.

374* **Der Befehl, der die Workload einreicht**: Hängen Sie an diesen Befehl kein `|| true` an. Mit `|| true` endet der Hook mit 0, selbst wenn Ihre Plattform die Einreichung ablehnt, zum Beispiel wegen eines überschrittenen Kontingents, und die Sitzung wartet auf einen Runner, der nie gestartet wurde.

375 

376 Benennen Sie die Workload nach `CLAUDE_RUNNER_ORDER_ID`, wie es [die erste Regel des Hooks](#the-spawn-runner-hook) vorgibt. Eine Already-exists-Antwort ist dann eine Neulieferung derselben Anfrage; behandeln Sie daher ausschließlich diese Antwort als Erfolg. Geben Sie bei allem anderen die Antwort auf stderr aus und beenden Sie den Hook mit 1, oder rufen Sie `permanent` auf, wenn kein Wiederholungsversuch das Problem beheben kann. Dieses Beispiel tut das für `kubectl create`, mit einer `job.yaml`, die nur die Workload enthält:

377 

378 ```bash theme={null}

379 if ! out=$(kubectl create -f job.yaml 2>&1); then

380 case "$out" in

381 *AlreadyExists*) ;;

382 *) printf '%s\n' "${out:-kubectl create failed}" >&2; exit 1 ;;

383 esac

384 fi

385 ```

386 

387 Das Log des Orchestrators zeigt dann diese Meldung. Wenn der Hook weitere Objekte erstellt, benennen Sie jedes nach der Order-ID, geben Sie ihm einen eigenen Befehl und behandeln Sie seine Already-exists-Antwort auf dieselbe Weise als Erfolg. Geben Sie für ein Objekt, das ein Geheimnis enthält, anstelle der Ausgabe des Befehls eine feste Meldung aus.

354 388 

355Um zu bestätigen, dass der Trap funktioniert, fügen Sie direkt unter der `trap`-Zeile eine Zeile ein, die einen nicht existierenden Befehl aufruft, etwa `no-such-command`. Führen Sie die Hook-Datei aus Ihrer Shell aus und prüfen Sie, dass `echo $?` den Wert `1` ausgibt; entfernen Sie die Zeile anschließend.389Um zu bestätigen, dass der Trap funktioniert, fügen Sie direkt unter der `trap`-Zeile eine Zeile ein, die einen nicht existierenden Befehl aufruft, etwa `no-such-command`. Führen Sie die Hook-Datei aus Ihrer Shell aus und prüfen Sie, dass `echo $?` den Wert `1` ausgibt; entfernen Sie die Zeile anschließend.

356 390 


457 491 

458* Die [verwaltete MCP-Datei](/docs/de/managed-mcp) im Enterprise-Geltungsbereich an ihrem Standard-Systempfad: `/etc/claude-code/managed-mcp.json` auf Linux-Runner-Hosts, `/Library/Application Support/ClaudeCode/managed-mcp.json` auf macOS-Hosts. Verwenden Sie sie für abgeschottete Umgebungen, in denen nur vom Administrator aufgeführte Server geladen werden dürfen. Die Regeln zum Vorrang finden Sie unter [Exklusive Kontrolle mit managed-mcp.json](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json). Wenn sich diese Datei auf dem Runner-Host befindet, überspringt Claude Code die MCP-Server, die die Control Plane von Anthropic an eine Sitzung übermittelt, einschließlich claude.ai-Konnektoren, und nennt sie in einer Warnung auf stderr des Sitzungs-Kindprozesses, die der Runner auf der Log-Ebene `debug` aufzeichnet. Vor v2.1.229 wurden diese Sitzungen beim Start mit `You cannot dynamically configure MCP servers when an enterprise MCP config is present` beendet.492* Die [verwaltete MCP-Datei](/docs/de/managed-mcp) im Enterprise-Geltungsbereich an ihrem Standard-Systempfad: `/etc/claude-code/managed-mcp.json` auf Linux-Runner-Hosts, `/Library/Application Support/ClaudeCode/managed-mcp.json` auf macOS-Hosts. Verwenden Sie sie für abgeschottete Umgebungen, in denen nur vom Administrator aufgeführte Server geladen werden dürfen. Die Regeln zum Vorrang finden Sie unter [Exklusive Kontrolle mit managed-mcp.json](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json). Wenn sich diese Datei auf dem Runner-Host befindet, überspringt Claude Code die MCP-Server, die die Control Plane von Anthropic an eine Sitzung übermittelt, einschließlich claude.ai-Konnektoren, und nennt sie in einer Warnung auf stderr des Sitzungs-Kindprozesses, die der Runner auf der Log-Ebene `debug` aufzeichnet. Vor v2.1.229 wurden diese Sitzungen beim Start mit `You cannot dynamically configure MCP servers when an enterprise MCP config is present` beendet.

459* Der Schlüssel [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) in den [verwalteten Einstellungen](/docs/de/managed-settings) auf dem Runner-Host: Stellt HTTP- und SSE-Server bereit, ohne die exklusive Kontrolle zu übernehmen, sodass Server aus den anderen Quellen weiterhin geladen werden. Erfordert Claude Code v2.1.259 oder neuer.493* Der Schlüssel [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) in den [verwalteten Einstellungen](/docs/de/managed-settings) auf dem Runner-Host: Stellt HTTP- und SSE-Server bereit, ohne die exklusive Kontrolle zu übernehmen, sodass Server aus den anderen Quellen weiterhin geladen werden. Erfordert Claude Code v2.1.259 oder neuer.

460* `<repo>/.mcp.json`: Projekt-Geltungsbereich. Committen Sie die Datei in das Repository; ihre Server werden in Cloud-Sitzungen automatisch genehmigt. In einer Sitzung mit mehreren Repositorys wird [höchstens die Datei eines Repositorys geladen](#repository-settings-in-sessions-with-several-repositories).494* `<repo>/.mcp.json`: Projekt-Geltungsbereich. Außerhalb eines Threads in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) committen Sie die Datei in das Repository, und ihre Server werden in Cloud-Sitzungen automatisch genehmigt. In einer Sitzung mit mehreren Repositorys wird [höchstens die Datei eines Repositorys geladen](#repository-settings-in-sessions-with-several-repositories).

461* Eine [`--mcp-config`](/docs/de/cli-reference#cli-flags)-Datei aus Ihrem Wrapper-Skript: Hängen Sie das Flag nach `"$@"` an, wie in `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Damit die Server aus dieser Datei weiterlaufen, wenn die übermittelten Server der Sitzung während der Sitzung aktualisiert werden, lassen Sie Ihr Wrapper-Skript die [vollständige Umgebung](#wrapper-scripts) an den Kindprozess weitergeben, wie es `exec` tut. Vor v2.1.299 wurden die stdio-, HTTP- und SSE-Server in dieser Datei bei der ersten solchen Aktualisierung beendet, in der sie nicht genannt wurden.495* Eine [`--mcp-config`](/docs/de/cli-reference#cli-flags)-Datei aus Ihrem Wrapper-Skript: Hängen Sie das Flag nach `"$@"` an, wie in `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Damit die Server aus dieser Datei weiterlaufen, wenn die übermittelten Server der Sitzung während der Sitzung aktualisiert werden, lassen Sie Ihr Wrapper-Skript die [vollständige Umgebung](#wrapper-scripts) an den Kindprozess weitergeben, wie es `exec` tut. Vor v2.1.299 wurden die stdio-, HTTP- und SSE-Server in dieser Datei bei der ersten solchen Aktualisierung beendet, in der sie nicht genannt wurden.

462 496 

463Wenn die Bereitstellung von Konnektoren für Ihre Organisation aktiviert ist, übermittelt die Control Plane von Anthropic die Konnektoren, die Sie auf claude.ai konfiguriert haben, über serverseitig bereitgestellte MCP-Konfiguration an interaktiv erstellte Sitzungen, geleitet über `api.anthropic.com`. Programmgesteuert erstellte Sitzungen, wie etwa [CLI-Dispatches](/docs/de/self-hosted-environments-testing#run-the-test-loop), erhalten keine Konnektoren; stellen Sie ihnen MCP-Server stattdessen über eine der anderen in diesem Abschnitt aufgeführten Quellen bereit. Das OAuth-Token des Kindprozesses enthält keinen Scope zum direkten Abrufen von Konnektoren, daher versucht der Kindprozess diesen Abruf nicht selbst; die Bereitstellung erfolgt serverseitig.497Wenn die Bereitstellung von Konnektoren für Ihre Organisation aktiviert ist, übermittelt die Control Plane von Anthropic die Konnektoren, die Sie auf claude.ai konfiguriert haben, über serverseitig bereitgestellte MCP-Konfiguration an interaktiv erstellte Sitzungen, geleitet über `api.anthropic.com`. Programmgesteuert erstellte Sitzungen, wie etwa [CLI-Dispatches](/docs/de/self-hosted-environments-testing#run-the-test-loop), erhalten keine Konnektoren; stellen Sie ihnen MCP-Server stattdessen über eine der anderen in diesem Abschnitt aufgeführten Quellen bereit. Das OAuth-Token des Kindprozesses enthält keinen Scope zum direkten Abrufen von Konnektoren, daher versucht der Kindprozess diesen Abruf nicht selbst; die Bereitstellung erfolgt serverseitig.

464 498 

499> [!NOTE]

500>

501> In einer Sitzung, die einen Konnektor erhalten hat, wird ein gleichnamiger Server aus der `.claude.json` des Hosts oder der `.mcp.json` eines Repositorys nicht verbunden. Um beide zu verwenden, geben Sie Ihrem Server einen anderen Namen.

502 

465`settings.json` enthält keine MCP-Server-Definitionen, und das Einstellungsschema hat kein Feld `mcpServers` auf oberster Ebene. Stellen Sie Server in verwalteten Einstellungen stattdessen mit dem Schlüssel [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) bereit.503`settings.json` enthält keine MCP-Server-Definitionen, und das Einstellungsschema hat kein Feld `mcpServers` auf oberster Ebene. Stellen Sie Server in verwalteten Einstellungen stattdessen mit dem Schlüssel [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) bereit.

466 504 

467Sitzungen erben die Umgebung des Runners. Setzen Sie daher [`ENABLE_TOOL_SEARCH`](/docs/de/mcp#scale-with-mcp-tool-search) dort, um MCP Tool Search für jede Sitzung zu steuern, die ein Runner startet; die MCP-Seite beschreibt die möglichen Werte.505Sitzungen erben die Umgebung des Runners. Setzen Sie daher [`ENABLE_TOOL_SEARCH`](/docs/de/mcp#scale-with-mcp-tool-search) dort, um MCP Tool Search für jede Sitzung zu steuern, die ein Runner startet; die MCP-Seite beschreibt die möglichen Werte.


635 673 

636Sitzungen lesen außerdem diese Einstellungsdateien:674Sitzungen lesen außerdem diese Einstellungsdateien:

637 675 

638* **Projekteinstellungen**: Eine im Repository committete `.claude/settings.json` wird über die Basis auf Benutzerebene gelegt. In einer Sitzung mit mehreren Repositorys [wird höchstens die Datei eines einzigen Repositorys wirksam](#repository-settings-in-sessions-with-several-repositories).676* **Projekteinstellungen**: Außerhalb eines Threads in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) wird eine im Repository committete `.claude/settings.json` über die Basis auf Benutzerebene gelegt. In einer Sitzung mit mehreren Repositorys [wird höchstens die Datei eines einzigen Repositorys wirksam](#repository-settings-in-sessions-with-several-repositories).

639* **Verwaltete Einstellungen**: Sitzungen lesen [`managed-settings.json`](/docs/de/settings#where-settings-live) aus dem standardmäßigen Systempfad in Ihrem Runner-Image. Ob deren Schlüssel neben [serververwalteten Einstellungen](/docs/de/server-managed-settings) gelten, erfahren Sie unter [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources).677* **Verwaltete Einstellungen**: Sitzungen lesen [`managed-settings.json`](/docs/de/settings#where-settings-live) aus dem standardmäßigen Systempfad in Ihrem Runner-Image. Ob deren Schlüssel neben [serververwalteten Einstellungen](/docs/de/server-managed-settings) gelten, erfahren Sie unter [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources).

640 678 

641In welcher Reihenfolge diese Quellen angewendet werden, erfahren Sie unter [Vorrang der Einstellungen](/docs/de/settings#settings-precedence).679In welcher Reihenfolge diese Quellen angewendet werden, erfahren Sie unter [Vorrang der Einstellungen](/docs/de/settings#settings-precedence).


646* **Wer sie erstellt**: Die Steuerungsebene füllt die Skripte aus festen Konstanten in ihrem eigenen Deployment, niemals aus sitzungsspezifischen Eingaben oder Eingaben von Drittanbietern.684* **Wer sie erstellt**: Die Steuerungsebene füllt die Skripte aus festen Konstanten in ihrem eigenen Deployment, niemals aus sitzungsspezifischen Eingaben oder Eingaben von Drittanbietern.

647* **Was weiterhin für sie gilt**: Hooks, die über `--settings` bereitgestellt werden, gehen in die gewöhnliche zusammengeführte Hook-Konfiguration ein, nicht in die verwaltete Ebene, sodass Ihre verwalteten Einstellungen weiterhin gelten. `disableAllHooks` deaktiviert sie, und sie gehören nicht zu den Kategorien, die [`allowManagedHooksOnly`](/docs/de/settings-reference#allowmanagedhooksonly) geladen lässt.685* **Was weiterhin für sie gilt**: Hooks, die über `--settings` bereitgestellt werden, gehen in die gewöhnliche zusammengeführte Hook-Konfiguration ein, nicht in die verwaltete Ebene, sodass Ihre verwalteten Einstellungen weiterhin gelten. `disableAllHooks` deaktiviert sie, und sie gehören nicht zu den Kategorien, die [`allowManagedHooksOnly`](/docs/de/settings-reference#allowmanagedhooksonly) geladen lässt.

648 686 

649Wenn eine Person ihre eigene Sitzung startet, lädt Claude Code außerdem die [für ihr claude.ai-Konto aktivierten Skills](/docs/de/skills#skills-in-cowork-and-cloud-sessions) in das Konfigurationsverzeichnis dieser Sitzung herunter. Die Ausführung einer [geplanten Cloud-Aufgabe](/docs/de/routines) erhält nicht die Skills ihres Eigentümers, und eine Sitzung, die [Modellanfragen an Bedrock oder Agent Platform sendet](#send-model-requests-to-bedrock-or-agent-platform), lädt keine herunter. Für einen Skill, den diese Sitzungen benötigen, committen Sie ihn in das Verzeichnis `.claude/skills/` des Repositorys oder fügen Sie ihn Ihrem Runner-Image hinzu.687Wenn eine Person ihre eigene Sitzung startet, lädt Claude Code außerdem die [für ihr claude.ai-Konto aktivierten Skills](/docs/de/skills#skills-in-cowork-and-cloud-sessions) in das Konfigurationsverzeichnis dieser Sitzung herunter. Die Ausführung einer [geplanten Cloud-Aufgabe](/docs/de/routines) erhält nicht die Skills ihres Eigentümers, und eine Sitzung, die [Modellanfragen an Bedrock oder Agent Platform sendet](#send-model-requests-to-bedrock-or-agent-platform), lädt keine herunter. Für einen Skill, den diese Sitzungen benötigen, fügen Sie ihn Ihrem Runner-Image hinzu oder committen Sie ihn außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) in das Verzeichnis `.claude/skills/` des Repositorys.

650 688 

651Außerhalb von [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen läuft eine Sitzung in einer selbstgehosteten Umgebung standardmäßig mit ausgeschaltetem [Auto-Memory](/docs/de/memory#auto-memory). Für Anweisungen, die über Sitzungen hinweg erhalten bleiben sollen, verwenden Sie die `CLAUDE.md` in Ihrem Runner-Image oder im Repository.689Außerhalb von [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen läuft eine Sitzung in einer selbstgehosteten Umgebung standardmäßig mit ausgeschaltetem [Auto-Memory](/docs/de/memory#auto-memory). Für Anweisungen, die über Sitzungen hinweg erhalten bleiben sollen, verwenden Sie die `CLAUDE.md` in Ihrem Runner-Image oder im Repository.

652 690 


654 692 

655### Repository-Einstellungen in Sitzungen mit mehreren Repositorys693### Repository-Einstellungen in Sitzungen mit mehreren Repositorys

656 694 

657In einer Sitzung mit mehreren Repositorys liest Claude Code die Projekteinstellungen aus dem Verzeichnis, in dem die Sitzung startet, sodass höchstens die `.claude/settings.json` eines einzigen Repositorys als Projekteinstellungen wirksam wird. Ein Hook, der in der Datei eines anderen Repositorys definiert ist, wird nicht ausgeführt, eine deny-Regel darin gilt nicht, und ihr `env` wird nicht gesetzt.695In einem Thread in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) wird die `.claude/settings.json` keines Repositorys als Projekteinstellungen wirksam, und weder die `.mcp.json` noch die Skills eines Repositorys werden geladen, unabhängig davon, wo der Thread startet. Um diesen Threads einen Skill bereitzustellen, fügen Sie ihn Ihrem Runner-Image hinzu.

696 

697In jeder anderen Sitzung mit mehreren Repositorys liest Claude Code die Projekteinstellungen aus dem Verzeichnis, in dem die Sitzung startet, sodass höchstens die `.claude/settings.json` eines einzigen Repositorys als Projekteinstellungen wirksam wird. Ein Hook, der in der Datei eines anderen Repositorys definiert ist, wird nicht ausgeführt, eine deny-Regel darin gilt nicht, und ihr `env` wird nicht gesetzt.

658 698 

659* **`--capacity 1`, der Standardwert, mit dem integrierten Checkout**: Die Sitzung startet im ersten Repository ihrer Liste von Repositorys. Die `.claude/settings.json` dieses Repositorys wird als Projekteinstellungen wirksam und seine `.mcp.json` wird geladen, die der anderen Repositorys nicht.699* **`--capacity 1`, der Standardwert, mit dem integrierten Checkout**: Die Sitzung startet im ersten Repository ihrer Liste von Repositorys. Die `.claude/settings.json` dieses Repositorys wird als Projekteinstellungen wirksam und seine `.mcp.json` wird geladen, die der anderen Repositorys nicht.

660* **Ein `--capacity`-Wert größer als eins oder ein [`checkout`-Hook](#checkout)**: Die Sitzung startet in einem sitzungsspezifischen Verzeichnis, das die Checkouts enthält. Die `.claude/settings.json` keines Repositorys wird als Projekteinstellungen wirksam, die `.mcp.json` keines Repositorys wird geladen, und [`$CLAUDE_PROJECT_DIR`](/docs/de/hooks#reference-scripts-by-path) in einem Hook-Befehl ist dieses Verzeichnis, nicht ein Checkout.700* **Ein `--capacity`-Wert größer als eins oder ein [`checkout`-Hook](#checkout)**: Die Sitzung startet in einem sitzungsspezifischen Verzeichnis, das die Checkouts enthält. Die `.claude/settings.json` keines Repositorys wird als Projekteinstellungen wirksam, die `.mcp.json` keines Repositorys wird geladen, und [`$CLAUDE_PROJECT_DIR`](/docs/de/hooks#reference-scripts-by-path) in einem Hook-Befehl ist dieses Verzeichnis, nicht ein Checkout.

661 701 

662Die `CLAUDE.md` und die Skills jedes Repositorys werden geladen, unabhängig davon, wo die Sitzung startet. Der Runner übergibt jedes Repository als [zusätzliches Verzeichnis](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) an Claude Code, daher liest Claude Code außerdem die Schlüssel `enabledPlugins` und `extraKnownMarketplaces` aus der `.claude/settings.json` jedes Repositorys.702Die `CLAUDE.md` jedes Repositorys wird geladen, unabhängig davon, wo die Sitzung startet. Außerhalb eines Threads in einem Projekt werden auch seine Skills geladen. Der Runner übergibt jedes Repository als [zusätzliches Verzeichnis](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) an Claude Code, daher liest Claude Code außerdem die Schlüssel `enabledPlugins` und `extraKnownMarketplaces` aus der `.claude/settings.json` jedes Repositorys.

663 703 

664Um einen Hook in jeder Sitzung auszuführen oder eine Berechtigungsregel in jeder Sitzung anzuwenden, legen Sie ihn bzw. sie in `~/.claude/settings.json` auf dem Runner-Host ab. Der Runner [übernimmt die Host-Datei in jede Sitzung](#how-each-session’s-config-is-assembled), unabhängig davon, wo die Sitzung startet. Schreiben Sie einen Pfad in einer `Read`- oder `Edit`-Regel als [Muster](/docs/de/permissions#read-and-edit) mit `//` (absolut) oder `~/` (relativ zum Home-Verzeichnis), da andere Muster an der Einstellungsquelle oder am aktuellen Verzeichnis verankert werden.704Um einen Hook in jeder Sitzung auszuführen oder eine Berechtigungsregel in jeder Sitzung anzuwenden, legen Sie ihn bzw. sie in `~/.claude/settings.json` auf dem Runner-Host ab. Der Runner [übernimmt die Host-Datei in jede Sitzung](#how-each-session’s-config-is-assembled), unabhängig davon, wo die Sitzung startet. Schreiben Sie einen Pfad in einer `Read`- oder `Edit`-Regel als [Muster](/docs/de/permissions#read-and-edit) mit `//` (absolut) oder `~/` (relativ zum Home-Verzeichnis), da andere Muster an der Einstellungsquelle oder am aktuellen Verzeichnis verankert werden.

665 705 

Details

80Diese Host-seitigen Flows erreichen `claude.ai`, führen Sie sie daher von einem Host aus, dessen Egress dies erlaubt, anstatt den Sitzungs-Container-Egress zu erweitern:80Diese Host-seitigen Flows erreichen `claude.ai`, führen Sie sie daher von einem Host aus, dessen Egress dies erlaubt, anstatt den Sitzungs-Container-Egress zu erweitern:

81 81 

82* **Der Einzeilen-Installer**: Ruft `install.sh` zur Installationszeit von `claude.ai` ab.82* **Der Einzeilen-Installer**: Ruft `install.sh` zur Installationszeit von `claude.ai` ab.

83* **Interaktives `claude auth login`**: Meldet sich über `claude.ai`, `claude.com` und `platform.claude.com` an. Das [geführte Setup](/docs/de/self-hosted-environments-quickstart#run-the-guided-setup), der angemeldete Modus von `doctor` und [CI-Dispatch](/docs/de/self-hosted-environments-testing#authenticate-from-ci) verwenden es. Der Browser, mit dem Sie sich anmelden, lädt außerdem die Browser-Prüfungen der claude.ai-Anmeldeseite von `hcaptcha.com`, `*.hcaptcha.com` und `challenges.cloudflare.com`.83* **Interaktives `claude auth login`**: Meldet sich über `claude.ai`, `claude.com` und `platform.claude.com` an. Das [geführte Setup](/docs/de/self-hosted-environments-quickstart#run-the-guided-setup), der angemeldete Modus von `doctor` und [CI-Dispatch](/docs/de/self-hosted-environments-testing#authenticate-from-ci) verwenden es. Der Browser, mit dem Sie sich anmelden, lädt außerdem die Browser-Prüfungen der claude.ai-Anmeldeseite von `hcaptcha.com`, `*.hcaptcha.com` und `challenges.cloudflare.com`. Wenn Ihre Organisation Single Sign-On verwendet, kann dieser Browser außerdem über `sso.claude.com` umgeleitet werden.

84 84 

85### Standard-Deny-Egress85### Standard-Deny-Egress

86 86 


654* **Runner beendet sich beim Start mit `RegisterRunner failed:` und einem TLS-Zertifikatsfehler**: Der Fehler kann zum Beispiel `self signed certificate in certificate chain` lauten. Der Runner vertraut der Zertifizierungsstelle (CA) hinter dem empfangenen Zertifikat nicht, wie es hinter einem TLS-inspizierenden Proxy vorkommt. Setzen Sie [`NODE_EXTRA_CA_CERTS`](/docs/de/network-config#custom-ca-certificates) in der Umgebung des Runners auf eine PEM-Datei mit der Root-CA des Proxys.654* **Runner beendet sich beim Start mit `RegisterRunner failed:` und einem TLS-Zertifikatsfehler**: Der Fehler kann zum Beispiel `self signed certificate in certificate chain` lauten. Der Runner vertraut der Zertifizierungsstelle (CA) hinter dem empfangenen Zertifikat nicht, wie es hinter einem TLS-inspizierenden Proxy vorkommt. Setzen Sie [`NODE_EXTRA_CA_CERTS`](/docs/de/network-config#custom-ca-certificates) in der Umgebung des Runners auf eine PEM-Datei mit der Root-CA des Proxys.

655 655 

656 Für Sitzungen müssen Sie die Variable nicht erneut setzen, da diese sie erben. Git liest sie nicht: Für Clones über diesen Proxy setzen Sie zusätzlich [`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git).656 Für Sitzungen müssen Sie die Variable nicht erneut setzen, da diese sie erben. Git liest sie nicht: Für Clones über diesen Proxy setzen Sie zusätzlich [`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git).

657* **Ihr Startskript gibt einen Schreibfehler mit `Resource temporarily unavailable` aus und beendet sich**: Ihr Skript teilt seine stdout oder stderr mit dem Prozess `claude self-hosted-runner` oder [Orchestrator](/docs/de/self-hosted-environments-configuration#on-demand-runners), den es startet, und dieser Prozess hat die gemeinsame Pipe bzw. den gemeinsamen Socket in den nicht blockierenden Modus umgeschaltet. Wenn die Pipe voll ist, schlägt ein Schreibvorgang Ihres Skripts mit diesem Betriebssystemfehler fehl, anstatt zu warten, und unter `set -e` beendet sich das Skript.

658 

659 Um den Fehler zu vermeiden, leiten Sie die Ausgabe des Runners oder Orchestrators in eine Datei um, die der Benutzer Ihres Skripts erstellen kann. Hängen Sie `>> "$HOME/claude-runner.log" 2>&1` an den Befehl an, der ihn startet, und zwar vor einem eventuellen `&`, das ihn in den Hintergrund schickt:

660 

661 ```bash theme={null}

662 claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret >> "$HOME/claude-runner.log" 2>&1

663 ```

664 

665 Die eigene Ausgabe Ihres Skripts geht weiterhin dorthin, wohin sie vorher ging, während das, was der Runner nach stdout und stderr schreibt, einschließlich seiner Startfehler, in diese Datei geht. Verwenden Sie diese Shell-Umleitung statt [`--log-file`](/docs/de/self-hosted-environments-reference#runner-cli-flags) allein, das das Log in eine Datei spiegelt, während der Runner weiterhin nach stdout und stderr schreibt. Wenn Sie bereits `--log-file` übergeben, behalten Sie es ebenfalls bei, denn die Umleitung ändert nicht, was diese Datei empfängt.

657* **Orchestrator protokolliert `poll failed:` mit einem TLS-Zertifikatsfehler und versucht es fortlaufend erneut**: Der Orchestrator vertraut der CA hinter dem empfangenen Zertifikat nicht, wie es hinter einem TLS-inspizierenden Proxy vorkommt. Setzen Sie [`NODE_EXTRA_CA_CERTS`](/docs/de/network-config#custom-ca-certificates) in der Umgebung des Orchestrators auf eine PEM-Datei mit der Root-CA des Proxys. Setzen Sie die Variable auch für die Runner, die Ihr `spawn-runner`-Hook startet.666* **Orchestrator protokolliert `poll failed:` mit einem TLS-Zertifikatsfehler und versucht es fortlaufend erneut**: Der Orchestrator vertraut der CA hinter dem empfangenen Zertifikat nicht, wie es hinter einem TLS-inspizierenden Proxy vorkommt. Setzen Sie [`NODE_EXTRA_CA_CERTS`](/docs/de/network-config#custom-ca-certificates) in der Umgebung des Orchestrators auf eine PEM-Datei mit der Root-CA des Proxys. Setzen Sie die Variable auch für die Runner, die Ihr `spawn-runner`-Hook startet.

658 667 

659 Zum Beispiel kann eine Zeile mit `poll failed: self signed certificate in certificate chain — retrying in 1s` enden, wobei zwischen dem Doppelpunkt und dem Gedankenstrich die Worte der TLS-Bibliothek stehen. Um die Behebung zu bestätigen, prüfen Sie, dass `connected` im Body von [`/healthz`](/docs/de/self-hosted-environments-reference#health-endpoint) des Orchestrators `true` ist.668 Zum Beispiel kann eine Zeile mit `poll failed: self signed certificate in certificate chain — retrying in 1s` enden, wobei zwischen dem Doppelpunkt und dem Gedankenstrich die Worte der TLS-Bibliothek stehen. Um die Behebung zu bestätigen, prüfen Sie, dass `connected` im Body von [`/healthz`](/docs/de/self-hosted-environments-reference#health-endpoint) des Orchestrators `true` ist.

Details

321* **OAuth-Token**: Generieren Sie ein Token mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token), autorisieren Sie es für Ihre Team- oder Enterprise-Organisation und setzen Sie es als `CLAUDE_CODE_OAUTH_TOKEN` in der Umgebung des Jobs. Entfernen Sie aus dieser Umgebung alle Anmeldedaten, die [Vorrang](/docs/de/authentication#authentication-precedence) vor dem Token haben, etwa `ANTHROPIC_API_KEY`.321* **OAuth-Token**: Generieren Sie ein Token mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token), autorisieren Sie es für Ihre Team- oder Enterprise-Organisation und setzen Sie es als `CLAUDE_CODE_OAUTH_TOKEN` in der Umgebung des Jobs. Entfernen Sie aus dieser Umgebung alle Anmeldedaten, die [Vorrang](/docs/de/authentication#authentication-precedence) vor dem Token haben, etwa `ANTHROPIC_API_KEY`.

322* **Endpunktverwaltete Einstellungen**: Stellen Sie eine [verwaltete Einstellungsdatei](/docs/de/managed-settings#delivery-mechanisms) auf dem Computer bereit, auf dem der Job ausgeführt wird.322* **Endpunktverwaltete Einstellungen**: Stellen Sie eine [verwaltete Einstellungsdatei](/docs/de/managed-settings#delivery-mechanisms) auf dem Computer bereit, auf dem der Job ausgeführt wird.

323 323 

324In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung in der Claude Desktop-App ruft Claude Code keine serververwalteten Einstellungen aus der claude.ai-Admin-Konsole ab, auch wenn sich der Benutzer mit einem Team- oder Enterprise-Konto anmeldet. [Wo und wann eine Richtlinie gilt](/docs/de/managed-settings#where-and-when-a-policy-applies) behandelt, welche Richtlinie Cowork-Sitzungen auf dem Computer des Benutzers und Remote-Cowork-Sitzungen erreicht. claude.ai wendet weiterhin Ihre [`strictKnownMarketplaces`](/docs/de/settings-reference#strictknownmarketplaces)- und [`blockedMarketplaces`](/docs/de/settings-reference#blockedmarketplaces)-Listen selbst an, wenn ein Cowork-Benutzer einen Marketplace aus einem Git-Repository auf claude.ai oder aus **Anpassen** in der Cowork-Registerkarte hinzufügt. [Wie Einschränkungen funktionieren](/docs/de/plugins/org#restrict-what-users-can-install) beschreibt diese Überprüfung.324In einer [Cowork](https://claude.com/docs/cowork/overview)-Sitzung in der Claude Desktop-App ruft Claude Code keine serververwalteten Einstellungen aus der claude.ai-Admin-Konsole ab, auch wenn sich der Benutzer mit einem Team- oder Enterprise-Konto anmeldet. [Wo und wann eine Richtlinie gilt](/docs/de/managed-settings#where-and-when-a-policy-applies) behandelt, welche Richtlinie Cowork-Sitzungen auf dem Computer des Benutzers und Remote-Cowork-Sitzungen erreicht. claude.ai wendet weiterhin Ihre [`strictKnownMarketplaces`](/docs/de/settings-reference#strictknownmarketplaces)- und [`blockedMarketplaces`](/docs/de/settings-reference#blockedmarketplaces)-Listen selbst an, wenn ein Cowork-Benutzer einen Marketplace aus einem Git-Repository auf claude.ai oder aus **Anpassen** in Cowork hinzufügt. [Wie Einschränkungen funktionieren](/docs/de/plugins/org#restrict-what-users-can-install) beschreibt diese Überprüfung.

325 325 

326Wenn Sie eine `CLAUDE_CODE_USE_*`-Providervariable oder eine nicht standardmäßige `ANTHROPIC_BASE_URL` in Ihrer Shell exportieren, überspringt Claude Code den Abruf der Einstellungen für Ihre Sitzungen. [`claude doctor` und `/status` melden den übersprungenen Abruf und dessen Ursache](#verify-settings-delivery).326Wenn Sie eine `CLAUDE_CODE_USE_*`-Providervariable oder eine nicht standardmäßige `ANTHROPIC_BASE_URL` in Ihrer Shell exportieren, überspringt Claude Code den Abruf der Einstellungen für Ihre Sitzungen. [`claude doctor` und `/status` melden den übersprungenen Abruf und dessen Ursache](#verify-settings-delivery).

327 327 

settings.md +4 −2

Details

321 321 

322Eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) läuft in einer [Cloud-Umgebung](/docs/de/cloud-environments) auf einem frischen Klon Ihres Repositorys, nicht auf Ihrer Maschine. Das ändert, welche Einstellungen es erreichen:322Eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) läuft in einer [Cloud-Umgebung](/docs/de/cloud-environments) auf einem frischen Klon Ihres Repositorys, nicht auf Ihrer Maschine. Das ändert, welche Einstellungen es erreichen:

323 323 

324* **Gemeinsame Projekt-Einstellungen** (`.claude/settings.json`): werden in einer Sitzung mit einem Repository gelesen, da die Datei Teil des Klons ist und die Sitzung darin startet. Committen Sie eine Einstellung dort, um sie in diesen Sitzungen anzuwenden. In einer von Anthropic gehosteten Umgebung startet eine Sitzung mit mehreren Repositorys über den Klonen und liest aus jeder `.claude/settings.json` des Repositorys nur die Schlüssel `enabledPlugins` und `extraKnownMarketplaces`, nicht Berechtigungsregeln, Hooks, `env` oder andere Schlüssel. Die Marketplaces und Plugins, die diese beiden Schlüssel deklarieren, [werden immer noch nicht in einer Cloud-Sitzung geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup). Für eine selbstgehostete Umgebung siehe [welche Repository-Einstellungen gelten](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).324* **Cloud-Threads in einem Projekt**: In einem Cloud-Thread in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) gelten keine Berechtigungsregeln, Hooks oder `env` aus der `.claude/settings.json` eines Repositorys, unabhängig davon, wie viele Repositorys das Projekt hat. [Was Threads aus Ihren Repositorys übernehmen](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) listet auf, was Sie stattdessen verwenden können.

325* **Gemeinsame Projekt-Einstellungen** (`.claude/settings.json`): werden in einer Sitzung mit einem Repository außerhalb eines Projekts gelesen, da die Datei Teil des Klons ist und die Sitzung darin startet. Committen Sie eine Einstellung dort, um sie in diesen Sitzungen anzuwenden.

326* **Gemeinsame Projekt-Einstellungen mit mehreren Repositorys**: In einer von Anthropic gehosteten Umgebung startet eine Sitzung mit mehreren Repositorys über den Klonen und liest aus jeder `.claude/settings.json` des Repositorys nur die Schlüssel `enabledPlugins` und `extraKnownMarketplaces`, nicht Berechtigungsregeln, Hooks, `env` oder andere Schlüssel. Die Marketplaces und Plugins, die diese beiden Schlüssel deklarieren, [werden immer noch nicht in einer Cloud-Sitzung geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup). Für eine selbstgehostete Umgebung siehe [welche Repository-Einstellungen gelten](/docs/de/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).

325* **Benutzer- und Projekt-lokale Einstellungen** (`~/.claude/settings.json` und `.claude/settings.local.json`): nicht gelesen. Beide bleiben auf Ihrer Maschine, und die lokale Datei ist nicht im Klon.327* **Benutzer- und Projekt-lokale Einstellungen** (`~/.claude/settings.json` und `.claude/settings.local.json`): nicht gelesen. Beide bleiben auf Ihrer Maschine, und die lokale Datei ist nicht im Klon.

326* **Verwaltete Einstellungen**: eine `managed-settings.json` Datei oder MDM-Profil auf Ihrem Gerät erreicht eine Cloud-Sitzung nicht. Die [serververwalteten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation erreichen sie; [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) listet auf, welche Cloud-Sitzungen sie erhalten. Eine [selbstgehostete Umgebung](/docs/de/self-hosted-environments) liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image. [Wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) sagt, wann diese Datei angewendet wird.328* **Verwaltete Einstellungen**: eine `managed-settings.json` Datei oder MDM-Profil auf Ihrem Gerät erreicht eine Cloud-Sitzung nicht. Die [serververwalteten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation erreichen sie; [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) listet auf, welche Cloud-Sitzungen sie erhalten. Eine [selbstgehostete Umgebung](/docs/de/self-hosted-environments) liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image. [Wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) sagt, wann diese Datei angewendet wird.

327* **`/config`**: im Browser unter claude.ai/code öffnet die Claude Code-Sektion Ihrer claude.ai-Einstellungen statt einen Wert zu ändern. Um eine Einstellung für eine Cloud-Sitzung zu ändern, setzen Sie eine [Umgebungsvariable](/docs/de/cloud-environments#set-environment-variables) auf der Umgebung, oder committen Sie in einer Sitzung mit einem Repository den Schlüssel zu der `.claude/settings.json` dieses Repositorys.329* **`/config`**: im Browser unter claude.ai/code öffnet die Claude Code-Sektion Ihrer claude.ai-Einstellungen statt einen Wert zu ändern. Um eine Einstellung für eine Cloud-Sitzung zu ändern, setzen Sie eine [Umgebungsvariable](/docs/de/cloud-environments#set-environment-variables) auf der Umgebung. In einer Sitzung mit einem Repository außerhalb eines Projekts können Sie stattdessen den Schlüssel in die `.claude/settings.json` dieses Repositorys committen.

328 330 

329[Was von Ihrem Setup überträgt](/docs/de/cloud-environments#what-carries-over-from-your-setup) listet den Rest auf: `CLAUDE.md`, Skills, MCP-Server, Plugins und Anmeldedaten.331[Was von Ihrem Setup überträgt](/docs/de/cloud-environments#what-carries-over-from-your-setup) listet den Rest auf: `CLAUDE.md`, Skills, MCP-Server, Plugins und Anmeldedaten.

330 332 

Details

94 94 

95Die gemeinsamen Einstellungen eines Teams, die im Repository festgehalten werden, damit jeder, der es klont, die gleichen Berechtigungen, Hooks und das Plugin-Marketplace erhält. Speichern Sie eine Datei wie diese unter `.claude/settings.json` am oberen Ende des Repositories. Das sollten Sie vor dem Commit wissen:95Die gemeinsamen Einstellungen eines Teams, die im Repository festgehalten werden, damit jeder, der es klont, die gleichen Berechtigungen, Hooks und das Plugin-Marketplace erhält. Speichern Sie eine Datei wie diese unter `.claude/settings.json` am oberen Ende des Repositories. Das sollten Sie vor dem Commit wissen:

96 96 

97* **Cloud-Sitzungen lesen sie auch.** Eine [Cloud-Sitzung](/docs/de/settings#settings-in-cloud-sessions) startet von einem Klon des Repositories, daher gilt die festgesetzte Datei auch dort.97* **Cloud-Sitzungen außerhalb eines [Projekts](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) lesen sie auch.** Eine [Cloud-Sitzung](/docs/de/settings#settings-in-cloud-sessions) mit einem Repository startet innerhalb des Klons, daher gilt die committete Datei auch dort.

98* **Telemetrie gehört in verwaltete oder persönliche Einstellungen.** Claude Code ignoriert die [OpenTelemetry-Exporter-Variablen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) in den Einstellungsdateien eines Repositories, mit Ausnahme einiger Werte, die Telemetrie deaktivieren. Legen Sie diese in [verwalteten Einstellungen](/docs/de/monitoring-usage#administrator-configuration) für Ihre Organisation fest, oder in der `~/.claude/settings.json` jeder Person.98* **Telemetrie gehört in verwaltete oder persönliche Einstellungen.** Claude Code ignoriert die [OpenTelemetry-Exporter-Variablen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) in den Einstellungsdateien eines Repositories, mit Ausnahme einiger Werte, die Telemetrie deaktivieren. Legen Sie diese in [verwalteten Einstellungen](/docs/de/monitoring-usage#administrator-configuration) für Ihre Organisation fest, oder in der `~/.claude/settings.json` jeder Person.

99* **Allow-Regeln warten auf Vertrauen.** Allow-Regeln und `extraKnownMarketplaces`-Einträge werden wirksam, nachdem jede Person [diesem Ordner selbst vertraut](/docs/de/permissions#project-allow-rules-and-workspace-trust), nicht nur einem übergeordneten Ordner; Deny- und Ask-Regeln gelten in jeder Sitzung, vertraut oder nicht.99* **Allow-Regeln warten auf Vertrauen.** Allow-Regeln und `extraKnownMarketplaces`-Einträge werden wirksam, nachdem jede Person [diesem Ordner selbst vertraut](/docs/de/permissions#project-allow-rules-and-workspace-trust), nicht nur einem übergeordneten Ordner; Deny- und Ask-Regeln gelten in jeder Sitzung, vertraut oder nicht.

100* **Der Hook ist ein Skript im Repo.** Der Hook dieser Datei führt `.claude/hooks/block-rm.sh` aus; [Wie ein Hook aufgelöst wird](/docs/de/hooks#how-a-hook-resolves) zeigt, wie man ihn schreibt.100* **Der Hook ist ein Skript im Repo.** Der Hook dieser Datei führt `.claude/hooks/block-rm.sh` aus; [Wie ein Hook aufgelöst wird](/docs/de/hooks#how-a-hook-resolves) zeigt, wie man ihn schreibt.

Details

725 725 

726### `showThinkingSummaries`726### `showThinkingSummaries`

727 727 

728Zeigen Sie Zusammenfassungen von Claudes [Extended Thinking](/docs/de/model-config#extended-thinking) in interaktiven Sitzungen an. Setzen Sie den Schlüssel, wenn Sie die vollständigen Zusammenfassungen sehen möchten, wenn Sie Thinking mit `Ctrl+O` aufklappen. Wenn er nicht gesetzt oder `false` ist, schwärzt die Anthropic API Thinking-Blöcke und Claude Code zeigt einen zugeklappten Platzhalter; Drittanbieter-Provider schwärzen nicht.728Zeigen Sie Zusammenfassungen von Claudes [Extended Thinking](/docs/de/model-config#extended-thinking) in interaktiven Sitzungen an. Setzen Sie den Schlüssel, wenn Sie die vollständigen Zusammenfassungen sehen möchten, wenn Sie Thinking mit `Ctrl+O` aufklappen. Wenn er nicht gesetzt oder `false` ist, schwärzt die Anthropic API Thinking-Blöcke und Claude Code zeigt einen zugeklappten Platzhalter.

729 729 

730* **Geltungsbereich**: [`Beliebige Datei`](#scopes)730* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

731* **Typ**: Boolean731* **Typ**: Boolean


1370* **`allowWrite` und `denyWrite`**: Auf macOS funktionieren Wildcards. Auf Linux und WSL2 mountet die Sandbox konkrete Pfade, daher überspringt Claude Code einen Eintrag, der nach dem Entfernen des nachgestellten `/**` noch `*`, `?` oder `[` enthält, und dieser Eintrag hat keine Wirkung. Claude Code fügt die Pfade aus Ihren `Edit`-Berechtigungsregeln zu diesen Listen hinzu, daher gilt für sie dieselbe Einschränkung, und die **Config**-Registerkarte von `/sandbox` warnt vor `Edit`- und `Read`-Berechtigungsregeln, die Wildcards enthalten.1370* **`allowWrite` und `denyWrite`**: Auf macOS funktionieren Wildcards. Auf Linux und WSL2 mountet die Sandbox konkrete Pfade, daher überspringt Claude Code einen Eintrag, der nach dem Entfernen des nachgestellten `/**` noch `*`, `?` oder `[` enthält, und dieser Eintrag hat keine Wirkung. Claude Code fügt die Pfade aus Ihren `Edit`-Berechtigungsregeln zu diesen Listen hinzu, daher gilt für sie dieselbe Einschränkung, und die **Config**-Registerkarte von `/sandbox` warnt vor `Edit`- und `Read`-Berechtigungsregeln, die Wildcards enthalten.

1371* **`denyRead` und `allowRead`**: Wildcards funktionieren auf jeder Plattform. Auf Linux und WSL2 erweitert Claude Code einen Leseeintrag auf die konkreten Pfade, auf die er passt, was es für die Schreiblisten nicht tut.1371* **`denyRead` und `allowRead`**: Wildcards funktionieren auf jeder Plattform. Auf Linux und WSL2 erweitert Claude Code einen Leseeintrag auf die konkreten Pfade, auf die er passt, was es für die Schreiblisten nicht tut.

1372 1372 

1373Geschweifte Klammern werden in einem Namen als gewöhnliche Zeichen abgeglichen, daher deckt `~/data/{keys,tokens}` ein Verzeichnis ab, das wörtlich `{keys,tokens}` heißt, und nicht zwei Alternativen. Um `~/data/keys` und `~/data/tokens` abzudecken, fügen Sie jeden Pfad als eigenen Eintrag hinzu.

1374 

1373### `sandbox.filesystem.allowWrite`1375### `sandbox.filesystem.allowWrite`

1374 1376 

1375Fügen Sie Pfade hinzu, in die Befehle in der Sandbox schreiben können, über das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis und die Verzeichnisse hinaus, die Sie mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories` hinzugefügt haben. Verwenden Sie es, wenn ein Unterprozess wie `kubectl` oder ein Build-Tool außerhalb des Projekts schreiben muss.1377Fügen Sie Pfade hinzu, in die Befehle in der Sandbox schreiben können, über das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis und die Verzeichnisse hinaus, die Sie mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories` hinzugefügt haben. Verwenden Sie es, wenn ein Unterprozess wie `kubectl` oder ein Build-Tool außerhalb des Projekts schreiben muss.


2321 2323 

2322 Das Ignorieren dieser Gruppe in Projekt- und lokalen Einstellungen erfordert Claude Code v2.1.282 oder später.2324 Das Ignorieren dieser Gruppe in Projekt- und lokalen Einstellungen erfordert Claude Code v2.1.282 oder später.

2323 * Variablen, die ändern, wie Claude Code startet oder synchronisiert, wie `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` und `CLAUDE_CODE_PLUGIN_SEED_DIR`.2325 * Variablen, die ändern, wie Claude Code startet oder synchronisiert, wie `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` und `CLAUDE_CODE_PLUGIN_SEED_DIR`.

2324 * Variablen, die die Timer für einen unbeantworteten Dialog festlegen: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`, `CLAUDE_AFK_TIMEOUT_MS` und `CLAUDE_AFK_COUNTDOWN_MS`](/docs/de/env-vars#variables).2326 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/de/env-vars#variables), das den Timer für einen unbeantworteten Dialog festlegt.

2325 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](/docs/de/env-vars#variables), das die Verarbeitung von Anhängen ausschaltet.2327 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](/docs/de/env-vars#variables), das die Verarbeitung von Anhängen ausschaltet.

2326 * [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](/docs/de/env-vars#variables), das verhindert, dass Claude Code `@`-Erwähnungen von Dateien und Verzeichnissen auflöst.2328 * [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](/docs/de/env-vars#variables), das verhindert, dass Claude Code `@`-Erwähnungen von Dateien und Verzeichnissen auflöst.

2327 2329 


2470* **Geltungsbereich**: [`User or managed`](#scopes)2472* **Geltungsbereich**: [`User or managed`](#scopes)

2471* **Typ**: String, einer von `"60s"`, `"5m"`, `"10m"` oder `"never"`2473* **Typ**: String, einer von `"60s"`, `"5m"`, `"10m"` oder `"never"`

2472* **Standard**: `"never"`2474* **Standard**: `"never"`

2473* **Überschreibungen pro Sitzung**: [`CLAUDE_AFK_TIMEOUT_MS`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel

2474 2475 

2475```json settings.json theme={null}2476```json settings.json theme={null}

2476{2477{


4854 4855 

4855### `preferredNotifChannel`4856### `preferredNotifChannel`

4856 4857 

4857Wählen Sie, wie Claude Code Sie benachrichtigt, wenn eine Aufgabe abgeschlossen ist oder eine Berechtigungsabfrage wartet. Wird in `/config` als **Lokale Benachrichtigungen** angezeigt.4858Wählen Sie, wie Claude Code Sie benachrichtigt, wenn eine Aufgabe abgeschlossen ist oder eine Berechtigungsabfrage wartet. Die [Benachrichtigungen eines Mods](/docs/de/plugins/mods/api#show-something-without-starting-a-turn) verwenden dieselbe Einstellung. Wird in `/config` als **Lokale Benachrichtigungen** angezeigt.

4858 4859 

4859* **Geltungsbereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.4860* **Geltungsbereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.

4860* **Typ**: Zeichenkette, eine von:4861* **Typ**: Zeichenkette, eine von:

setup.md +1 −1

Details

200 200 

201Claude Code prüft beim Start und regelmäßig während der Ausführung auf Updates. Updates werden im Hintergrund heruntergeladen und installiert und treten beim nächsten Start von Claude Code in Kraft.201Claude Code prüft beim Start und regelmäßig während der Ausführung auf Updates. Updates werden im Hintergrund heruntergeladen und installiert und treten beim nächsten Start von Claude Code in Kraft.

202 202 

203Führen Sie `claude doctor` aus, um das Ergebnis des letzten Aktualisierungsversuchs anzuzeigen.203Führen Sie `claude doctor` in Ihrer Shell aus, um das Ergebnis des letzten Aktualisierungsversuchs anzuzeigen, den Claude Code aufgezeichnet hat. Wenn bei einer nativen Installation ein fehlgeschlagener Versuch gemeldet wird, lesen Sie unter [`Auto-update failed` in der Sitzungsfußzeile](/docs/de/troubleshoot-install#auto-update-failed) nach, wie Sie weiter vorgehen.

204 204 

205Unter macOS und Linux verwaltet das native Installationsprogramm das Startprogramm unter `~/.local/bin/claude` als Symlink in `~/.local/share/claude/versions/`. Wenn Sie dieses Startprogramm durch Ihr eigenes Skript oder Symlink ersetzen, lassen Auto-Update und `claude update` es an Ort und Stelle: neue Versionen werden weiterhin im Verzeichnis `versions/` installiert, und Ihr Startprogramm entscheidet, welche Version ausgeführt wird.205Unter macOS und Linux verwaltet das native Installationsprogramm das Startprogramm unter `~/.local/bin/claude` als Symlink in `~/.local/share/claude/versions/`. Wenn Sie dieses Startprogramm durch Ihr eigenes Skript oder Symlink ersetzen, lassen Auto-Update und `claude update` es an Ort und Stelle: neue Versionen werden weiterhin im Verzeichnis `versions/` installiert, und Ihr Startprogramm entscheidet, welche Version ausgeführt wird.

206 206 

skills.md +10 −7

Details

42* **Erweiterungen**: nicht genutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten sowie langsame [Hooks](/docs/de/hooks)42* **Erweiterungen**: nicht genutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten sowie langsame [Hooks](/docs/de/hooks)

43* **`CLAUDE.md`-Dateien**: lokale `CLAUDE.md`-Dateien, die eingecheckte Dateien duplizieren, eingecheckte [`CLAUDE.md`-Inhalte, die Claude aus der Codebasis ableiten könnte](/docs/de/memory#my-claude-md-is-too-large), sowie die verbleibenden, stets geladenen Anweisungen, die Claude in Skills und verschachtelte `CLAUDE.md`-Dateien zu migrieren anbietet, die bei Bedarf geladen werden43* **`CLAUDE.md`-Dateien**: lokale `CLAUDE.md`-Dateien, die eingecheckte Dateien duplizieren, eingecheckte [`CLAUDE.md`-Inhalte, die Claude aus der Codebasis ableiten könnte](/docs/de/memory#my-claude-md-is-too-large), sowie die verbleibenden, stets geladenen Anweisungen, die Claude in Skills und verschachtelte `CLAUDE.md`-Dateien zu migrieren anbietet, die bei Bedarf geladen werden

44* **Berechtigungen**: ein Angebot, den [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard-Berechtigungsmodus zu machen und nur lesende Befehle, die Sie häufig ablehnen, [vorab zu genehmigen](/docs/de/permissions)44* **Berechtigungen**: ein Angebot, den [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard-Berechtigungsmodus zu machen und nur lesende Befehle, die Sie häufig ablehnen, [vorab zu genehmigen](/docs/de/permissions)

45* **Nutzung**: bei einem Pro-, Max-, Team- oder Enterprise-Plan die [Änderungen, die `/usage` empfiehlt](/docs/de/costs#plan-usage-breakdown), um Ihre Plan-Nutzung zu senken, gemessen über die letzten 7 Tage. Claude schlägt die Änderungen vor, die es selbst vornehmen kann, und meldet den Rest als Hinweis, etwa einen Befehl, den Sie ausführen sollen. Die Nutzungsprüfung erfordert Claude Code v2.1.305 oder später, und `/doctor` lässt sie aus, solange [Remote Control](/docs/de/remote-control) verbunden ist.

45 46 

46Für eine nur lesende Diagnose der Installation, ohne eine Sitzung zu starten, führen Sie stattdessen `claude doctor` in Ihrem Terminal aus.47Für eine nur lesende Diagnose der Installation, ohne eine Sitzung zu starten, führen Sie stattdessen `claude doctor` in Ihrem Terminal aus.

47 48 


83| :- | :- | :- |84| :- | :- | :- |

84| `migrate` | Aktualisieren Sie Ihren vorhandenen Claude API-Code auf ein neueres Modell | Früher als v2.1.221 |85| `migrate` | Aktualisieren Sie Ihren vorhandenen Claude API-Code auf ein neueres Modell | Früher als v2.1.221 |

85| `upgrade` | Verschieben Sie die Anthropic SDK-Abhängigkeit Ihres Projekts über eine Hauptversion hinweg, derzeit das Python-Paket `anthropic` von 0.x zu 1.x | v2.1.236 oder später |86| `upgrade` | Verschieben Sie die Anthropic SDK-Abhängigkeit Ihres Projekts über eine Hauptversion hinweg, derzeit das Python-Paket `anthropic` von 0.x zu 1.x | v2.1.236 oder später |

87| `api-version` | Aktualisieren Sie Ihren Claude API-Code für eine neuere [API-Version](https://platform.claude.com/docs/en/api/versioning) und stellen Sie Ihre Anfragen anschließend auf diese Version um | v2.1.307 oder später |

86| `managed-agents-onboard` | Durchlaufen Sie die Erstellung eines neuen Managed Agent | Früher als v2.1.221 |88| `managed-agents-onboard` | Durchlaufen Sie die Erstellung eines neuen Managed Agent | Früher als v2.1.221 |

87| `managed-agents-onboard <url>` | Erstellen Sie den Managed Agent, den die Seite unter der URL beschreibt, z. B. eine Seite in der [Managed Agents-Dokumentation](https://platform.claude.com/docs/en/managed-agents/overview) | v2.1.290 oder später |89| `managed-agents-onboard <url>` | Erstellen Sie den Managed Agent, den die Seite unter der URL beschreibt, z. B. eine Seite in der [Managed Agents-Dokumentation](https://platform.claude.com/docs/en/managed-agents/overview) | v2.1.290 oder später |

88| `managed-agents-onboard <quickstart-name>` | Erstellen Sie eine der Schnellstart-Vorlagen der Console, z. B. `deep-researcher`. Wenn Sie ein einzelnes Wort angeben, das kein Vorlagenname ist, listet Claude die gültigen Namen auf | v2.1.290 oder später |90| `managed-agents-onboard <quickstart-name>` | Erstellen Sie eine der Schnellstart-Vorlagen der Console, z. B. `deep-researcher`. Wenn Sie ein einzelnes Wort angeben, das kein Vorlagenname ist, listet Claude die gültigen Namen auf | v2.1.290 oder später |


155| :- | :- | :- |157| :- | :- | :- |

156| Enterprise | `.claude/skills/<skill-name>/SKILL.md` im [Verzeichnis für verwaltete Einstellungen](/docs/de/managed-settings#delivery-mechanisms) | Alle Benutzer auf Maschinen, auf denen Ihre Organisation es bereitstellt |158| Enterprise | `.claude/skills/<skill-name>/SKILL.md` im [Verzeichnis für verwaltete Einstellungen](/docs/de/managed-settings#delivery-mechanisms) | Alle Benutzer auf Maschinen, auf denen Ihre Organisation es bereitstellt |

157| Persönlich | `~/.claude/skills/<skill-name>/SKILL.md` | Alle Ihre Projekte auf dieser Maschine, aber nicht [Cowork- oder Cloud-Sitzungen](#skills-in-cowork-and-cloud-sessions) |159| Persönlich | `~/.claude/skills/<skill-name>/SKILL.md` | Alle Ihre Projekte auf dieser Maschine, aber nicht [Cowork- oder Cloud-Sitzungen](#skills-in-cowork-and-cloud-sessions) |

158| Projekt | `.claude/skills/<skill-name>/SKILL.md` | Sitzungen in diesem Repository. Committen Sie es, damit Ihr Team es auch erhält |160| Projekt | `.claude/skills/<skill-name>/SKILL.md` | Sitzungen in diesem Repository, aber nicht [Cloud-Threads in einem Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories). Committen Sie es, damit Ihr Team es auch erhält |

159| Verschachtelt | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Sitzungen, die in oder unter `<subdir>` gestartet werden. Eine Sitzung, die darüber gestartet wird, lädt den Skill einmal, wenn Claude an Dateien dort arbeitet. Siehe [Monorepos und Unterverzeichnisse](#discovery-from-parent-and-nested-directories) |161| Verschachtelt | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Sitzungen, die in oder unter `<subdir>` gestartet werden, aber nicht Cloud-Threads in einem Projekt. Außerhalb dieser Threads lädt eine Sitzung, die darüber gestartet wird, den Skill, sobald Claude an Dateien dort arbeitet. Siehe [Monorepos und Unterverzeichnisse](#discovery-from-parent-and-nested-directories) |

160| Zusätzliches Verzeichnis | `.claude/skills/<skill-name>/SKILL.md` in einem Verzeichnis, das Sie mit `--add-dir` übergeben | Diese Sitzung. Siehe [Verzeichnisse außerhalb des Projekts](#skills-from-additional-directories) |162| Zusätzliches Verzeichnis | `.claude/skills/<skill-name>/SKILL.md` in einem Verzeichnis, das Sie mit `--add-dir` übergeben | Diese Sitzung. Siehe [Verzeichnisse außerhalb des Projekts](#skills-from-additional-directories) |

161| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Überall dort, wo das [Plugin](/docs/de/plugins/overview) aktiviert ist, als `/plugin-name:skill-name` |163| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Überall dort, wo das [Plugin](/docs/de/plugins/overview) aktiviert ist, als `/plugin-name:skill-name` |

162| claude.ai-Konto | Skills, die für Ihr claude.ai-Konto aktiviert sind | Cowork-Sitzungen, Cloud-Sitzungen und Terminal-Sitzungen, in denen Sie sich mit diesem Konto anmelden. Siehe [Skills, die von claude.ai synchronisiert werden](#how-synced-skills-behave) |164| claude.ai-Konto | Skills, die für Ihr claude.ai-Konto aktiviert sind | Cowork-Sitzungen, Cloud-Sitzungen und Terminal-Sitzungen, in denen Sie sich mit diesem Konto anmelden. Siehe [Skills, die von claude.ai synchronisiert werden](#how-synced-skills-behave) |


207 209 

208### Skills in Cowork- und Cloud-Sitzungen verwenden210### Skills in Cowork- und Cloud-Sitzungen verwenden

209 211 

210[Cowork](https://claude.com/product/cowork)-Sitzungen und [Cloud-Sitzungen](/docs/de/cloud-environments#what-carries-over-from-your-setup), einschließlich [geplanter Aufgaben in der Cloud](/docs/de/routines), lesen nicht `~/.claude/skills/` auf Ihrer Maschine. Sowohl interaktive als auch geplante Cowork-Sitzungen laden die Skills, die für Ihr claude.ai-Konto aktiviert sind, synchronisiert beim Sitzungsstart. Verwalten Sie sie über **Customize** in der Desktop-App-Seitenleiste oder in den Skill-Einstellungen auf claude.ai. Cloud-Sitzungen laden zusätzlich Projekt-Skills, die in `.claude/skills/` des geklonten Repositorys committet sind.212[Cowork](https://claude.com/product/cowork)-Sitzungen und [Cloud-Sitzungen](/docs/de/cloud-environments#what-carries-over-from-your-setup), einschließlich [geplanter Aufgaben in der Cloud](/docs/de/routines), lesen nicht `~/.claude/skills/` auf Ihrer Maschine. Sowohl interaktive als auch geplante Cowork-Sitzungen laden die Skills, die für Ihr claude.ai-Konto aktiviert sind, synchronisiert beim Sitzungsstart. Verwalten Sie sie über **Customize** in der Desktop-App-Seitenleiste oder in den Skill-Einstellungen auf claude.ai.

211 213 

212Wenn ein Skill nur in `~/.claude/skills/` auf Ihrer Maschine vorhanden ist, meldet Claude Code, dass der Skill nicht gefunden wurde, wenn eine [geplante Aufgabe in der Cloud](/docs/de/routines) ihn aufruft. Das liegt daran, dass jede Ausführung als frische Cloud-Sitzung startet. Um einen persönlichen Skill in diesen Sitzungen verfügbar zu machen:214Wenn ein Skill nur in `~/.claude/skills/` auf Ihrer Maschine vorhanden ist, meldet Claude Code, dass der Skill nicht gefunden wurde, wenn eine [geplante Aufgabe in der Cloud](/docs/de/routines) ihn aufruft. Das liegt daran, dass jede Ausführung als frische Cloud-Sitzung startet. Um einen persönlichen Skill in diesen Sitzungen verfügbar zu machen:

213 215 

214* Für Cowork- und Cloud-Sitzungen aktivieren Sie den Skill für Ihr claude.ai-Konto. [Einige Sitzungen in einer selbst gehosteten Umgebung](/docs/de/self-hosted-environments-configuration#how-each-session’s-config-is-assembled) laden die Skills Ihres Kontos nicht.216* Für Cowork-Sitzungen, Cloud-Sitzungen und Cloud-Threads in einem [Projekt](/docs/de/claude-projects#what-threads-pick-up-from-your-repositories) aktivieren Sie den Skill für Ihr claude.ai-Konto. In einem Cloud-Thread eines Projekts sind Skills, die in `.claude/skills/` eines Repositorys committet sind, nicht verfügbar. [Einige Sitzungen in einer selbst gehosteten Umgebung](/docs/de/self-hosted-environments-configuration#how-each-session’s-config-is-assembled) laden die Skills Ihres Kontos nicht.

215* Für Cloud-Sitzungen können Sie den Skill stattdessen in `.claude/skills/` des Repositorys committen. Plugins, die in `.claude/settings.json` des Repositorys deklariert sind, und Plugins, die nur in Ihren Benutzereinstellungen aktiviert sind, [werden nicht in Cloud-Sitzungen geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).217* Für Cloud-Sitzungen außer Projekt-Threads können Sie den Skill stattdessen in `.claude/skills/` des Repositorys committen. Plugins, die in `.claude/settings.json` des Repositorys deklariert sind, und Plugins, die nur in Ihren Benutzereinstellungen aktiviert sind, [werden nicht in Cloud-Sitzungen geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).

216 218 

217[Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) werden lokal auf Ihrer Maschine ausgeführt, daher laden sie `~/.claude/skills/`.219[Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) werden lokal auf Ihrer Maschine ausgeführt, daher laden sie `~/.claude/skills/`.

218 220 


398| `agent` | Nein | Welcher Subagent-Typ verwendet werden soll, wenn `context: fork` gesetzt ist. |400| `agent` | Nein | Welcher Subagent-Typ verwendet werden soll, wenn `context: fork` gesetzt ist. |

399| `background` | Nein | Gilt nur mit `context: fork`. Setzen Sie auf `false`, um auf das Ergebnis des verzweigten Subagents im Turn zu warten, der die Fähigkeit aufgerufen hat, anstatt [es im Hintergrund auszuführen](#run-skills-in-a-subagent). Standard: `true`. Erfordert Claude Code v2.1.218 oder später. |401| `background` | Nein | Gilt nur mit `context: fork`. Setzen Sie auf `false`, um auf das Ergebnis des verzweigten Subagents im Turn zu warten, der die Fähigkeit aufgerufen hat, anstatt [es im Hintergrund auszuführen](#run-skills-in-a-subagent). Standard: `true`. Erfordert Claude Code v2.1.218 oder später. |

400| `hooks` | Nein | Hooks, die Claude Code registriert, wenn die Fähigkeit aufgerufen wird, und die für den Rest der Sitzung weiterhin ausgeführt werden. Siehe [Hooks in Fähigkeiten und Agenten](/docs/de/hooks#hooks-in-skills-and-agents) für das Konfigurationsformat und die `once`-Option. |402| `hooks` | Nein | Hooks, die Claude Code registriert, wenn die Fähigkeit aufgerufen wird, und die für den Rest der Sitzung weiterhin ausgeführt werden. Siehe [Hooks in Fähigkeiten und Agenten](/docs/de/hooks#hooks-in-skills-and-agents) für das Konfigurationsformat und die `once`-Option. |

401| `paths` | Nein | Glob-Muster, die einschränken, wann diese Fähigkeit aktiviert wird. Akzeptiert eine durch Komma getrennte Zeichenkette oder eine YAML-Liste. Wenn gesetzt, lädt Claude die Fähigkeit automatisch nur, wenn mit Dateien arbeitet, die den Mustern entsprechen. Verwendet das gleiche Format wie [pfadspezifische Regeln](/docs/de/memory#path-specific-rules). |403| `paths` | Nein | Glob-Muster, die einschränken, wann dieser Skill aktiviert wird. Akzeptiert eine durch Komma getrennte Zeichenkette oder eine YAML-Liste. Wenn gesetzt, lädt Claude den Skill automatisch nur, wenn es mit Dateien arbeitet, die den Mustern entsprechen. Muster sind relativ zu Claudes aktuellem Arbeitsverzeichnis, und Dateien außerhalb dieses Verzeichnisses stimmen nicht überein. Verwendet das gleiche Glob-Format wie [pfadspezifische Regeln](/docs/de/memory#path-specific-rules). |

402| `shell` | Nein | Shell, die für `` !`command` ``- und ` ```! `-Blöcke in diesem Skill verwendet werden soll. Akzeptiert `bash` (Standard) oder `powershell`. Das Setzen von `powershell` führt Inline-Shell-Befehle über PowerShell aus, wenn das [PowerShell-Tool](/de/tools-reference#powershell-tool) aktiviert ist: Es ist standardmäßig unter Windows ohne Git Bash aktiviert, standardmäßig mit Git Bash für claude.ai- und Console-Konten aktiviert und benötigt `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` in Sitzungen mit Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry sowie auf macOS, Linux und WSL. Setzen Sie es auf `0`, um das Tool auszuschalten. |404| `shell` | Nein | Shell, die für `` !`command` ``- und ` ```! `-Blöcke in diesem Skill verwendet werden soll. Akzeptiert `bash` (Standard) oder `powershell`. Das Setzen von `powershell` führt Inline-Shell-Befehle über PowerShell aus, wenn das [PowerShell-Tool](/de/tools-reference#powershell-tool) aktiviert ist: Es ist standardmäßig unter Windows ohne Git Bash aktiviert, standardmäßig mit Git Bash für claude.ai- und Console-Konten aktiviert und benötigt `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` in Sitzungen mit Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry sowie auf macOS, Linux und WSL. Setzen Sie es auf `0`, um das Tool auszuschalten. |

403| `metadata` | Nein | Freie YAML-Zuordnung für Ihre eigenen Schlüssel-Wert-Daten, z. B. Berechtigung oder Katalogfelder, die von Ihrem eigenen Tooling aus `SKILL.md` gelesen werden. Claude Code handelt nicht nach ihrem Inhalt und verwirft einen Wert, der keine Zuordnung ist. Verwenden Sie keine Frontmatter-Feldnamen wie `paths` als Schlüssel erneut. |405| `metadata` | Nein | Freie YAML-Zuordnung für Ihre eigenen Schlüssel-Wert-Daten, z. B. Berechtigung oder Katalogfelder, die von Ihrem eigenen Tooling aus `SKILL.md` gelesen werden. Claude Code handelt nicht nach ihrem Inhalt und verwirft einen Wert, der keine Zuordnung ist. Verwenden Sie keine Frontmatter-Feldnamen wie `paths` als Schlüssel erneut. |

404| `license` | Nein | Lizenz, die die Fähigkeit abdeckt. Teil der [Agent Skills](https://agentskills.io)-Spezifikation; siehe [Fähigkeits-Frontmatter außerhalb von Claude Code verwenden](#using-skill-frontmatter-outside-claude-code). Claude Code akzeptiert das Feld, handelt aber nicht danach. |406| `license` | Nein | Lizenz, die die Fähigkeit abdeckt. Teil der [Agent Skills](https://agentskills.io)-Spezifikation; siehe [Fähigkeits-Frontmatter außerhalb von Claude Code verwenden](#using-skill-frontmatter-outside-claude-code). Claude Code akzeptiert das Feld, handelt aber nicht danach. |


755Welche Befehle unter die Ausnahme fallen, hängt von der Shell ab:757Welche Befehle unter die Ausnahme fallen, hängt von der Shell ab:

756 758 

757* Standard-Shell `bash`: die unter [Ausgabelimits](/docs/de/tools-reference#output-limits) aufgeführten Befehle759* Standard-Shell `bash`: die unter [Ausgabelimits](/docs/de/tools-reference#output-limits) aufgeführten Befehle

758* `shell: powershell`, wenn das PowerShell-Tool aktiviert ist: eine [andere Menge](/docs/de/tools-reference#shell-selection-in-settings-hooks-and-skills), die `grep` und `git diff` enthält, aber nicht `find` oder `diff`760* `shell: powershell`, wenn das PowerShell-Tool aktiviert ist: eine [andere Menge](/docs/de/tools-reference#exit-code-1-from-searches-and-git-diff-in-powershell), die `grep` und `git diff` enthält, aber nicht `find` oder `diff`

759 761 

760Hängen Sie bei der Standard-Shell `bash` `|| true` an jeden anderen Befehl an, bei dem Sie einen Exit-Code ungleich null erwarten. Ein Prüfskript, das mit 1 endet, wenn es Probleme findet, ist ein Beispiel dafür.762Hängen Sie bei der Standard-Shell `bash` `|| true` an jeden anderen Befehl an, bei dem Sie einen Exit-Code ungleich null erwarten. Ein Prüfskript, das mit 1 endet, wenn es Probleme findet, ist ein Beispiel dafür.

761 763 


11773. Versuchen Sie, Ihre Anfrage umzuformulieren, um sie besser an die Beschreibung anzupassen11793. Versuchen Sie, Ihre Anfrage umzuformulieren, um sie besser an die Beschreibung anzupassen

11784. Rufen Sie ihn direkt mit `/skill-name` auf, wenn der Skill vom Benutzer aufgerufen werden kann11804. Rufen Sie ihn direkt mit `/skill-name` auf, wenn der Skill vom Benutzer aufgerufen werden kann

11795. Wenn auch `/skill-name` nicht erkannt wird, prüfen Sie, ob Claude Code [den Namen des Skills abgelehnt hat](#characters-a-skill-name-cant-hold)11815. Wenn auch `/skill-name` nicht erkannt wird, prüfen Sie, ob Claude Code [den Namen des Skills abgelehnt hat](#characters-a-skill-name-cant-hold)

11826. Wenn der Skill `paths` festlegt, prüfen Sie, ob sich die Dateien, die Claude liest, bearbeitet oder schreibt, im aktuellen Arbeitsverzeichnis von Claude befinden. Für Dateien außerhalb davon wird der Skill nicht aktiviert, etwa für Dateien in einem benachbarten Git-Worktree, selbst wenn Sie diesen mit `/add-dir` hinzugefügt haben. Damit der Skill für diese Dateien aktiviert wird, starten Sie Claude Code in diesem Worktree oder [verschieben Sie die Sitzung mit `/cd` dorthin](/docs/de/permissions#move-the-session-to-another-directory).

1180 1183 

1181Wenn die Frontmatter-YAML fehlerhaft ist, lädt Claude Code den Skill-Body mit leeren Metadaten, sodass `/skill-name` weiterhin funktioniert, aber Claude keine `description` zum Abgleichen hat. Führen Sie mit `--debug` aus, um den Parse-Fehler zu sehen.1184Wenn die Frontmatter-YAML fehlerhaft ist, lädt Claude Code den Skill-Body mit leeren Metadaten, sodass `/skill-name` weiterhin funktioniert, aber Claude keine `description` zum Abgleichen hat. Führen Sie mit `--debug` aus, um den Parse-Fehler zu sehen.

1182 1185 

sub-agents.md +26 −3

Details

489 489 

490Ein `disallowedTools`-Eintrag mit einem Spezifizierer, wie `Bash(git push *)`, entfernt immer noch das ganze Werkzeug aus dem Subagenten, nicht nur die übereinstimmenden Befehle. Um Bash zu behalten und bestimmte Befehle zu blockieren, fügen Sie eine [Bash-Ablehnungsregel](/docs/de/permissions#bash) wie `Bash(git push *)` zu `permissions.deny` in Ihren Einstellungen hinzu. Die Regel gilt für die Hauptkonversation und für Subagenten.490Ein `disallowedTools`-Eintrag mit einem Spezifizierer, wie `Bash(git push *)`, entfernt immer noch das ganze Werkzeug aus dem Subagenten, nicht nur die übereinstimmenden Befehle. Um Bash zu behalten und bestimmte Befehle zu blockieren, fügen Sie eine [Bash-Ablehnungsregel](/docs/de/permissions#bash) wie `Bash(git push *)` zu `permissions.deny` in Ihren Einstellungen hinzu. Die Regel gilt für die Hauptkonversation und für Subagenten.

491 491 

492##### MCP-Servernamen, die einen doppelten Unterstrich enthalten

493 

494Wenn ein Subagent keines der Tools eines MCP-Servers erhält, dessen Name `__` enthält, wie etwa `reports__v2`, überprüfen Sie die `mcp__`-Einträge des Subagenten:

495 

496* **In `tools`**: Schreiben Sie `mcp__`, gefolgt vom [vollständigen Namen des Servers](/docs/de/permissions#mcp) und `__*`, wie in `mcp__reports__v2__*`. Ohne das abschließende `__*` passt `mcp__reports__v2` auf keines der Tools dieses Servers.

497* **In `disallowedTools`**: Suchen Sie nach `mcp__reports` oder `mcp__reports__*`, den Einträgen, die die Tools eines Servers namens `reports` vorenthalten. Mit jedem der beiden Einträge verliert der Subagent auch jedes `reports__v2`-Tool, da diese Tool-Namen ebenfalls mit `mcp__reports__` beginnen. Um nur die Tools des `reports`-Servers vorzuenthalten, listen Sie sie stattdessen einzeln auf, etwa `mcp__reports__run_query`.

498 

492#### Beschränken Sie, welche Subagenten gespawnt werden können499#### Beschränken Sie, welche Subagenten gespawnt werden können

493 500 

494Wenn ein Agent als Hauptthread mit `claude --agent` läuft, kann er Subagenten mit dem Agent-Werkzeug spawnen. Um zu beschränken, welche Subagenten-Typen er spawnen kann, verwenden Sie die `Agent(agent_type)`-Syntax im `tools`-Feld.501Wenn ein Agent als Hauptthread mit `claude --agent` läuft, kann er Subagenten mit dem Agent-Werkzeug spawnen. Um zu beschränken, welche Subagenten-Typen er spawnen kann, verwenden Sie die `Agent(agent_type)`-Syntax im `tools`-Feld.


594| `default` | Manueller Modus: fordert Berechtigung an |601| `default` | Manueller Modus: fordert Berechtigung an |

595| `acceptEdits` | Auto-Akzeptanz von Dateibearbeitungen und häufigen Dateisystem-Befehlen für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |602| `acceptEdits` | Auto-Akzeptanz von Dateibearbeitungen und häufigen Dateisystem-Befehlen für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |

596| `auto` | [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): ein Hintergrund-Klassifizierer überprüft Befehle und Schreibvorgänge in geschützten Verzeichnissen |603| `auto` | [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): ein Hintergrund-Klassifizierer überprüft Befehle und Schreibvorgänge in geschützten Verzeichnissen |

597| `dontAsk` | Lehnt Aufrufe, die eine Berechtigungsabfrage auslösen würden, automatisch ab, wobei ein von Ihnen installierter [Mod](/docs/de/plugins/mods/overview) [einige dieser Aufrufe](/docs/de/permissions#precedence-among-rules-hooks-and-mods) trotzdem genehmigen kann. Explizit zugelassene Tools funktionieren weiterhin. `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, [Lesezugriffe auf Netzwerkpfade](/docs/de/permissions#network-paths) und Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), werden in Sitzungen, in denen diese Einstellung Claude Code erreicht, verweigert, auch wenn Sie sie zugelassen haben |604| `dontAsk` | Lehnt Aufrufe, die eine Berechtigungsabfrage auslösen würden, automatisch ab, wobei ein von Ihnen installierter [Mod](/docs/de/plugins/mods/overview) [einige dieser Aufrufe](/docs/de/permissions#precedence-among-rules-hooks-and-mods) trotzdem genehmigen kann. Explizit zugelassene Tools funktionieren weiterhin. `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, [Lesezugriffe auf Netzwerkpfade](/docs/de/permissions#network-paths) und Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), werden verweigert, auch wenn Sie sie zugelassen haben. Für die Konnektor-Tools gilt das nur, wenn diese Einstellung Claude Code in der jeweiligen Sitzung erreicht |

598| `bypassPermissions` | [Alle Berechtigungsprüfungen überspringen](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode). Ein Subagent läuft in diesem Modus nur, wenn die Hauptkonversation es tut |605| `bypassPermissions` | [Alle Berechtigungsprüfungen überspringen](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode). Ein Subagent läuft in diesem Modus nur, wenn die Hauptkonversation es tut |

599| `plan` | Plan-Modus (schreibgeschützte Exploration) |606| `plan` | Plan-Modus (schreibgeschützte Exploration) |

600 607 


955 962 

956### Subagenten-Namen963### Subagenten-Namen

957 964 

958Claude kann einem Subagenten einen Namen geben, indem er einen `name`-Parameter beim Agent-Tool-Aufruf übergibt, und kann dies auch von selbst tun, ohne Sie zuerst zu fragen. Der Name macht den Subagenten adressierbar: Claude kann ihn [nach Abschluss nach Name ansprechen oder fortsetzen](#resume-subagents).965Wenn Sie eine Sitzung mit aktivierten [Agent-Teams](/docs/de/agent-teams#enable-agent-teams) starten, kann Claude einem Subagenten einen Namen geben, indem er einen `name`-Parameter beim Agent-Tool-Aufruf übergibt. Er kann dies auch von selbst tun, ohne Sie zuerst zu fragen. Der Name macht den Subagenten adressierbar: Claude kann ihn [nach Abschluss nach Name ansprechen oder fortsetzen](#resume-subagents).

959 966 

960In einer interaktiven Sitzung mit aktivierten [Agent-Teams](/docs/de/agent-teams) wird ein Subagent, den Claude aus der Hauptkonversation mit einem `name` spawnt, stattdessen als Teamkollege gestartet, sofern der Aufruf kein [Fork](#fork-the-current-conversation) ist oder `isolation` beim Aufruf selbst übergibt. Ein `isolation`-Wert im Frontmatter des Subagenten verhindert es nicht, und der Teamkollege wird dann im Arbeitsverzeichnis der Hauptsitzung ausgeführt. Siehe [Wie Claude Agent-Teams startet](/docs/de/agent-teams#how-claude-starts-agent-teams).967In einer interaktiven Sitzung mit aktivierten [Agent-Teams](/docs/de/agent-teams) wird ein Subagent, den Claude aus der Hauptkonversation mit einem `name` spawnt, stattdessen als Teamkollege gestartet, sofern der Aufruf kein [Fork](#fork-the-current-conversation) ist oder `isolation` beim Aufruf selbst übergibt. Ein `isolation`-Wert im Frontmatter des Subagenten verhindert es nicht, und der Teamkollege wird dann im Arbeitsverzeichnis der Hauptsitzung ausgeführt. Siehe [Wie Claude Agent-Teams startet](/docs/de/agent-teams#how-claude-starts-agent-teams).

961 968 


968* **Vordergrund**: Wenn ein Rate-Limit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Textausgabe produziert hat, gibt das Agent-Tool diese teilweise Ausgabe mit einer Notiz zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. Ein Subagent, der nichts produziert hat oder dessen einzige Ausgabe Tool-Aufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/docs/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt vom Fehlerdetail.975* **Vordergrund**: Wenn ein Rate-Limit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Textausgabe produziert hat, gibt das Agent-Tool diese teilweise Ausgabe mit einer Notiz zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. Ein Subagent, der nichts produziert hat oder dessen einzige Ausgabe Tool-Aufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/docs/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt vom Fehlerdetail.

969* **Hintergrund**: Der Subagent wird als fehlgeschlagen markiert, und die Nachricht, die Claude erhält, wenn er endet, nennt den API-Fehler und enthält die letzte Ausgabe des Subagenten, sodass teilweise Arbeit nicht verloren geht.976* **Hintergrund**: Der Subagent wird als fehlgeschlagen markiert, und die Nachricht, die Claude erhält, wenn er endet, nennt den API-Fehler und enthält die letzte Ausgabe des Subagenten, sodass teilweise Arbeit nicht verloren geht.

970 977 

978Wenn der Bericht eines Subagenten mit der folgenden Zeile beginnt, hat der Subagent seine Arbeit mit einem Fallback-Modell abgeschlossen:

979 

980```text theme={null}

981⚠ This agent switched to <model> because its earlier model could not be used.

982```

983 

971Wenn Sie eine [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains) konfigurieren und ein Subagent auf einen Fehler trifft, den die Kette abdeckt, z. B. dass sein Modell nicht verfügbar ist, wechselt Claude Code den Subagenten zum ersten Modell in der Kette, das die Anfrage akzeptiert. Der Subagent arbeitet weiter, anstatt beim Fehler zu enden.984Wenn Sie eine [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains) konfigurieren und ein Subagent auf einen Fehler trifft, den die Kette abdeckt, z. B. dass sein Modell nicht verfügbar ist, wechselt Claude Code den Subagenten zum ersten Modell in der Kette, das die Anfrage akzeptiert. Der Subagent arbeitet weiter, anstatt beim Fehler zu enden.

972 985 

973Sobald der zugrunde liegende API-Fehler behoben ist, bitten Sie Claude, die Aufgabe erneut zu versuchen oder [den Subagenten fortzusetzen](#resume-subagents).986Sobald der zugrunde liegende API-Fehler behoben ist, bitten Sie Claude, die Aufgabe erneut zu versuchen oder [den Subagenten fortzusetzen](#resume-subagents).


1114 1127 

1115Jeder Subagenten-Aufruf erstellt eine neue Instanz, anstatt eine frühere fortzusetzen. Um die Arbeit eines bestehenden Subagenten fortzusetzen, anstatt von vorne zu beginnen, bitten Sie Claude, ihn fortzusetzen.1128Jeder Subagenten-Aufruf erstellt eine neue Instanz, anstatt eine frühere fortzusetzen. Um die Arbeit eines bestehenden Subagenten fortzusetzen, anstatt von vorne zu beginnen, bitten Sie Claude, ihn fortzusetzen.

1116 1129 

1117Fortgesetzte Subagenten behalten ihre vollständige Konversationshistorie, einschließlich aller vorherigen Tool-Aufrufe, Ergebnisse und Überlegungen. Wenn der Subagent [Hintergrund-Subagenten seiner eigenen](#let-subagents-spawn-their-own-subagents) spawnte, enthält diese Historie die Ergebnisse, die sie während des Laufs lieferten. Der Subagent setzt genau dort an, wo er stoppte, anstatt von vorne zu beginnen.1130Fortgesetzte Subagenten behalten ihre vollständige Konversationshistorie, einschließlich aller vorherigen Tool-Aufrufe, Ergebnisse und Überlegungen. Wenn der Subagent [Hintergrund-Subagenten seiner eigenen](#let-subagents-spawn-their-own-subagents) spawnte, enthält diese Historie die Ergebnisse, die sie während des Laufs lieferten. Vor v2.1.304 konnte ein Subagent, dem Claude direkt nach seinem Abschluss eine Nachricht sendete oder den Claude direkt danach fortsetzte, seine jüngste Arbeit vergessen.

1118 1131 

1119* Wenn ein Subagent abgeschlossen wird, erhält Claude seine Agent-ID.1132* Wenn ein Subagent abgeschlossen wird, erhält Claude seine Agent-ID.

1120* Die integrierten Explore- und Plan-Agenten sind einmalig und geben keine Agent-ID zurück, sodass Claude sie nicht fortsetzen kann. Verwenden Sie `general-purpose` oder einen benutzerdefinierten Subagenten, wenn Sie die Arbeit fortsetzen müssen.1133* Die integrierten Explore- und Plan-Agenten sind einmalig und geben keine Agent-ID zurück, sodass Claude sie nicht fortsetzen kann. Verwenden Sie `general-purpose` oder einen benutzerdefinierten Subagenten, wenn Sie die Arbeit fortsetzen müssen.


1154* **Sitzungs-Persistenz**: Subagenten-Transkripte bleiben innerhalb ihrer Sitzung bestehen. Sie können [einen Subagenten fortsetzen](#resume-subagents), nachdem Sie Claude Code neu gestartet haben, indem Sie dieselbe Sitzung fortsetzen.1167* **Sitzungs-Persistenz**: Subagenten-Transkripte bleiben innerhalb ihrer Sitzung bestehen. Sie können [einen Subagenten fortsetzen](#resume-subagents), nachdem Sie Claude Code neu gestartet haben, indem Sie dieselbe Sitzung fortsetzen.

1155* **Automatische Bereinigung**: Claude Code löscht Subagenten-Transkripte nach der Aufbewahrungsfrist `cleanupPeriodDays`, standardmäßig 30 Tage, nach den [Regeln für die automatische Bereinigung](/docs/de/claude-directory#cleaned-up-automatically).1168* **Automatische Bereinigung**: Claude Code löscht Subagenten-Transkripte nach der Aufbewahrungsfrist `cleanupPeriodDays`, standardmäßig 30 Tage, nach den [Regeln für die automatische Bereinigung](/docs/de/claude-directory#cleaned-up-automatically).

1156 1169 

1170##### Einem Subagenten nach einem Neustart per Name eine Nachricht senden

1171 

1172> [!NOTE]

1173>

1174> Für einen Subagenten, der als Teamkollege gestartet wurde, siehe stattdessen die [Einschränkungen von Agent-Teams](/docs/de/agent-teams#limitations).

1175 

1176Wenn Claude einem Subagenten keine Nachricht per Name senden kann, nachdem Sie Claude Code neu gestartet und die Sitzung fortgesetzt haben, geben Sie Claude stattdessen die Agent-ID des Subagenten. Namen, die Claude seit der letzten [Komprimierung](/docs/de/context-window#what-survives-compaction) aus der Hauptkonversation vergeben hat, überstehen den Neustart. Ein Name von vor dieser Komprimierung übersteht ihn nicht. Um die ID zu einem Namen zu finden, suchen Sie nach diesem Namen in den Dateien `agent-{agentId}.meta.json` in `~/.claude/projects/{project}/{sessionId}/subagents/`.

1177 

1178Nach einer Nachricht per ID funktioniert der Name des Subagenten wieder, es sei denn, ein neuerer Agent hat diesen Namen übernommen. Vor v2.1.299 überstand kein Name einen Neustart, und ein Senden per Name wurde abgelehnt, selbst wenn die Agent-ID noch funktionierte.

1179 

1157#### Automatische Komprimierung1180#### Automatische Komprimierung

1158 1181 

1159Subagenten unterstützen automatische Komprimierung. Die Komprimierung wird ausgelöst, wenn sich das eigene Kontextfenster des Subagenten füllt, und `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` gilt auch für Subagenten. Siehe [Umgebungsvariablen](/docs/de/env-vars) für den Zeitpunkt, an dem die Überschreibung wirksam wird.1182Subagenten unterstützen automatische Komprimierung. Die Komprimierung wird ausgelöst, wenn sich das eigene Kontextfenster des Subagenten füllt, und `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` gilt auch für Subagenten. Siehe [Umgebungsvariablen](/docs/de/env-vars) für den Zeitpunkt, an dem die Überschreibung wirksam wird.

Details

476 476 

477PowerShell-Befehle erhalten außerdem die Variablen, die Hooks über `CLAUDE_ENV_FILE` persistieren, unter den in [Persistierte Variablen in PowerShell-Befehlen](/docs/de/hooks#persisted-variables-in-powershell-commands) beschriebenen Bedingungen. Erfordert Claude Code v2.1.296 oder später.477PowerShell-Befehle erhalten außerdem die Variablen, die Hooks über `CLAUDE_ENV_FILE` persistieren, unter den in [Persistierte Variablen in PowerShell-Befehlen](/docs/de/hooks#persisted-variables-in-powershell-commands) beschriebenen Bedingungen. Erfordert Claude Code v2.1.296 oder später.

478 478 

479Exit-Code 1 von `grep`, `rg`, `egrep`, `fgrep`, `findstr` und `git grep` bedeutet keine Übereinstimmungen. Exit-Code 1 von `git diff` bedeutet, dass Unterschiede vorhanden sind. Keines dieser Ergebnisse wird Claude als Befehlsfehler gemeldet. Für `robocopy` sind Exit-Codes 0 bis 7 Informationsergebnisse, wie kopierte Dateien oder erkannte zusätzliche Dateien. Exit-Codes von 8 oder höher zählen als Fehler.479### Exit-Code 1 von Suchen und `git diff` in PowerShell

480 

481Wenn eine `grep`- oder `rg`-Suche ohne Treffer `Error: Exit code 1` anzeigt, wenn Claude sie im PowerShell-Tool ausführt, ist die Suche nicht fehlgeschlagen. Sie müssen nichts unternehmen. Der Fehler kann erscheinen, wenn die Suche Teil eines längeren Befehls ist. Wenn `rg` beispielsweise mit Code 1 beendet wird, zeigt `rg foo | Out-Null` den Fehler an, `rg foo` hingegen nicht.

482 

483Das PowerShell-Tool kann Exit-Code 1 als normales Ergebnis von `grep`, `rg`, `egrep`, `fgrep`, `findstr`, `git grep` und `git diff` werten. Die Suchen verwenden Exit-Code 1, um zu melden, dass es keine Treffer gibt. Bei `git diff` bedeutet Exit-Code 1, dass sich die Dateien unterscheiden. Ein Befehl, der den Fehler anzeigt, wenn Claude ihn ausführt, [gilt als fehlgeschlagen](/docs/de/skills#when-an-injected-command-fails) in einem Skill mit `shell: powershell`.

480 484 

481### Windows-Codierung und Exitcodes485### Windows-Codierung und Exitcodes

482 486 


484* Claude Code codiert Text, der an die Standardeingabe eines nativen Befehls weitergeleitet wird, als UTF-8488* Claude Code codiert Text, der an die Standardeingabe eines nativen Befehls weitergeleitet wird, als UTF-8

485* Claude Code erfasst Fehlerausgabe ohne ANSI-Escape-Sequenzen489* Claude Code erfasst Fehlerausgabe ohne ANSI-Escape-Sequenzen

486* Ein Befehl, dessen untergeordneter Prozess auf die Standardeingabe wartet, erhält das Dateiende statt zu hängen490* Ein Befehl, dessen untergeordneter Prozess auf die Standardeingabe wartet, erhält das Dateiende statt zu hängen

487* Exitcode 1 von `where.exe` bedeutet keine Übereinstimmung, und von `fc.exe` und `diff.exe` bedeutet es, dass sich die Dateien unterscheiden. Wenn der Befehl eine Ausgabe erzeugt, behandelt Claude Code diesen Exitcode als eine gültige negative Antwort statt als Befehlsfehler. Claude Code meldet weiterhin eine stille Form, wie `where.exe /Q` oder eine Umleitung zu `$null`, als Fehler bei Exitcode 1491* Wenn `where.exe` keinen Treffer findet oder `fc.exe` bzw. `diff.exe` feststellt, dass sich die Dateien unterscheiden, kann das Ergebnis `Error: Exit code 1` anzeigen, obwohl der Befehl nicht fehlgeschlagen ist. Sie müssen nichts unternehmen.

492* Wenn ein `robocopy`-Exit-Code von 1 bis 7 als Fehler angezeigt wird, ist der Kopiervorgang nicht fehlgeschlagen, und Sie müssen nichts unternehmen. `robocopy` wird mit Code 0 bis 7 beendet, um ein Ergebnis wie kopierte Dateien zu melden, und mit 8 oder höher, wenn es fehlschlägt.

488 493 

489### Vorschaubeschränkungen494### Vorschaubeschränkungen

490 495 


504* **Bilder**: PNG-, JPEG-, GIF- und WebP-Dateien werden als visueller Inhalt zurückgegeben, den Claude sehen kann, nicht als Rohdaten. Claude Code ändert die Größe großer Bilder und komprimiert sie neu, um die Bildgrößenlimits des Modells einzuhalten, bevor sie gesendet werden, sodass Claude möglicherweise eine herunterskalierte Version eines großen Screenshots sieht.509* **Bilder**: PNG-, JPEG-, GIF- und WebP-Dateien werden als visueller Inhalt zurückgegeben, den Claude sehen kann, nicht als Rohdaten. Claude Code ändert die Größe großer Bilder und komprimiert sie neu, um die Bildgrößenlimits des Modells einzuhalten, bevor sie gesendet werden, sodass Claude möglicherweise eine herunterskalierte Version eines großen Screenshots sieht.

505 510 

506 Wenn Claude feine Pixel-Details in einem großen Bild übersieht, bitten Sie es, die für Sie relevante Region zuzuschneiden, beispielsweise mit ImageMagick über Bash, und anschließend den Ausschnitt zu lesen.511 Wenn Claude feine Pixel-Details in einem großen Bild übersieht, bitten Sie es, die für Sie relevante Region zuzuschneiden, beispielsweise mit ImageMagick über Bash, und anschließend den Ausschnitt zu lesen.

512 

513 Read lehnt eine Bilddatei, die größer als 128 MB ist, mit einem Fehler ab, der Claude anweist, die Größe des Bildes zu ändern oder eine kleinere Kopie zu exportieren und dann diese Kopie zu lesen. Wenn Claude beim Fehler stehen bleibt, statt dies zu tun, siehe [File is too large to read as an image](/docs/de/errors#file-is-too-large-to-read-as-an-image).

507* **PDFs**: Claude liest kurze `.pdf`-Dateien vollständig. Für PDFs länger als 10 Seiten liest es in Bereichen mit einem `pages`-Parameter, wie `"1-5"`, bis zu 20 Seiten auf einmal. Seitenbereich-Lesevorgänge rendern Seiten mit `pdftoppm` aus poppler-utils, daher installieren Sie es mit `brew install poppler` auf macOS oder `apt-get install poppler-utils` auf Debian und Ubuntu. Auf Windows und anderen Plattformen installieren Sie einen poppler-Build, der `pdftoppm` auf Ihrem `PATH` platziert. Ohne ihn schlägt ein Seitenbereich-Lesevorgang mit `pdftoppm is not installed` fehl.514* **PDFs**: Claude liest kurze `.pdf`-Dateien vollständig. Für PDFs länger als 10 Seiten liest es in Bereichen mit einem `pages`-Parameter, wie `"1-5"`, bis zu 20 Seiten auf einmal. Seitenbereich-Lesevorgänge rendern Seiten mit `pdftoppm` aus poppler-utils, daher installieren Sie es mit `brew install poppler` auf macOS oder `apt-get install poppler-utils` auf Debian und Ubuntu. Auf Windows und anderen Plattformen installieren Sie einen poppler-Build, der `pdftoppm` auf Ihrem `PATH` platziert. Ohne ihn schlägt ein Seitenbereich-Lesevorgang mit `pdftoppm is not installed` fehl.

508* **Jupyter-Notizbücher**: `.ipynb`-Dateien geben alle Zellen mit ihren Ausgaben zurück, einschließlich Code, Markdown und Visualisierungen. Ein Notizbuch, dessen Zellen zusammen mehr als 256 KB oder mehr als das [Token-Limit](#large-files) umfassen, gibt stattdessen einen Fehler zurück. Claude Code weigert sich, eine Notizbuchdatei über 100 MB zu lesen; der Fehler teilt Claude mit, wie er stattdessen einen Teil des Notizbuchs liest, wie z. B. einen Ausschnitt von Zellen, mit einem Shell-Befehl.515* **Jupyter-Notizbücher**: `.ipynb`-Dateien geben alle Zellen mit ihren Ausgaben zurück, einschließlich Code, Markdown und Visualisierungen. Ein Notizbuch, dessen Zellen zusammen mehr als 256 KB oder mehr als das [Token-Limit](#large-files) umfassen, gibt stattdessen einen Fehler zurück. Claude Code weigert sich, eine Notizbuchdatei über 100 MB zu lesen; der Fehler teilt Claude mit, wie er stattdessen einen Teil des Notizbuchs liest, wie z. B. einen Ausschnitt von Zellen, mit einem Shell-Befehl.

509 516 


558 565 

559Claude Code behält Ihr Arbeitsverzeichnis im lokalen Entwurf, um das Transkript zu finden, und sendet das Verzeichnis nicht.566Claude Code behält Ihr Arbeitsverzeichnis im lokalen Entwurf, um das Transkript zu finden, und sendet das Verzeichnis nicht.

560 567 

561In [Organisationen mit Null-Datenspeicherung](/docs/de/zero-data-retention#features-disabled-under-zdr) sowie in Organisationen, in denen die [HIPAA-Konfiguration](/docs/de/hipaa-setup) angewendet wurde, lässt Claude Code das Tool weg, wie es auch bei `/feedback` der Fall ist. Wenn eine Sitzung in einer Organisation mit Null-Datenspeicherung das Tool immer noch anbietet, bleiben Entwürfe auf Ihrem Computer, und das Senden schlägt mit `Feedback collection is not available for organizations with custom data retention policies.` fehl.568In [Organisationen mit Null-Datenspeicherung](/docs/de/zero-data-retention#features-disabled-under-zdr) sowie in Organisationen, in denen die [HIPAA-Konfiguration](/docs/de/hipaa-setup) angewendet wurde, lässt Claude Code das SendFeedback-Tool in Ihren Sitzungen weg. Wenn eine Sitzung in einer Organisation mit Null-Datenspeicherung das Tool immer noch anbietet, bleiben Entwürfe auf Ihrem Computer, und das Senden schlägt mit `Feedback collection is not available for organizations with custom data retention policies.` fehl.

562 569 

563### Verwerfen oder behalten Sie einen Entwurf570### Verwerfen oder behalten Sie einen Entwurf

564 571 


665* **Auf das Auffüllen warten**: Ab Claude Code v2.1.290 wird das Limit einer interaktiven Terminal-Sitzung mit etwa 100 Aufrufen pro Stunde wieder aufgefüllt. Um die Rate zu ändern, setzen Sie [`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/de/env-vars#variables) auf eine Anzahl von Aufrufen pro Stunde, etwa `50`.672* **Auf das Auffüllen warten**: Ab Claude Code v2.1.290 wird das Limit einer interaktiven Terminal-Sitzung mit etwa 100 Aufrufen pro Stunde wieder aufgefüllt. Um die Rate zu ändern, setzen Sie [`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/de/env-vars#variables) auf eine Anzahl von Aufrufen pro Stunde, etwa `50`.

666* **Neue Konversation starten**: Das Ausführen von [`/clear`](/docs/de/commands#all-commands) im Prompt von Claude Code setzt den Zähler ebenfalls zurück. Wenn Arbeiten, die noch Subagenten erzeugen können, das Löschen überstehen, wie z. B. ein laufender Workflow, wird der Zähler stattdessen übertragen.673* **Neue Konversation starten**: Das Ausführen von [`/clear`](/docs/de/commands#all-commands) im Prompt von Claude Code setzt den Zähler ebenfalls zurück. Wenn Arbeiten, die noch Subagenten erzeugen können, das Löschen überstehen, wie z. B. ein laufender Workflow, wird der Zähler stattdessen übertragen.

667 674 

675Im [nicht interaktiven Modus](/docs/de/headless) mit `-p` und im [Agent SDK](/docs/de/agent-sdk/overview) gilt das Limit pro Turn, nicht pro Sitzung. Ein Turn dauert von einer Nachricht, die Sie senden, bis Claude seine Antwort abgeschlossen hat. Das Limit wird zurückgesetzt, wenn Sie danach die nächste Nachricht senden oder einen neuen `claude -p`-Lauf starten, auch mit [`--continue` oder `--resume`](/docs/de/headless#continue-conversations). Für weitere Suchen erhöhen Sie [`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`](/docs/de/env-vars#variables) oder legen mit [`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/de/env-vars#variables) eine Auffüllrate fest.

676 

668## Verhalten des Write-Tools677## Verhalten des Write-Tools

669 678 

670Das Write-Tool erstellt eine neue Datei oder überschreibt eine vorhandene Datei mit dem vollständigen bereitgestellten Inhalt. Es fügt nicht an und führt nicht zusammen. Write überschreibt außerdem eine vorhandene Datei, deren Bytes sich nicht dekodieren lassen, und speichert den neuen Inhalt als UTF-8, wie unter [Nicht-UTF-8-Dateien](#non-utf-8-files) beschrieben.679Das Write-Tool erstellt eine neue Datei oder überschreibt eine vorhandene Datei mit dem vollständigen bereitgestellten Inhalt. Es fügt nicht an und führt nicht zusammen. Write überschreibt außerdem eine vorhandene Datei, deren Bytes sich nicht dekodieren lassen, und speichert den neuen Inhalt als UTF-8, wie unter [Nicht-UTF-8-Dateien](#non-utf-8-files) beschrieben.

Details

31| `CRYPT_E_NO_REVOCATION_CHECK` oder `CRYPT_E_REVOCATION_OFFLINE` | [Umgehen Sie blockierte Sperrprüfungen](#tls-or-ssl-connection-errors) |31| `CRYPT_E_NO_REVOCATION_CHECK` oder `CRYPT_E_REVOCATION_OFFLINE` | [Umgehen Sie blockierte Sperrprüfungen](#tls-or-ssl-connection-errors) |

32| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |32| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |

33| `The connection dropped while downloading the update` oder `Download timed out: exceeded the total deadline` | [Führen Sie das Update erneut aus oder legen Sie Ihren Proxy fest](#the-connection-dropped-while-downloading-the-update) |33| `The connection dropped while downloading the update` oder `Download timed out: exceeded the total deadline` | [Führen Sie das Update erneut aus oder legen Sie Ihren Proxy fest](#the-connection-dropped-while-downloading-the-update) |

34| `Release verification failed for Claude Code` | [Führen Sie `claude update` oder `claude install` erneut aus](#release-verification-failed) |

35| `Auto-update failed · Run claude doctor` in Rot in der Fußzeile der Sitzung | [Führen Sie `claude update` in Ihrer Shell aus](#auto-update-failed) |

34| `irm is not recognized` oder `The token '&&' is not a valid statement separator` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |36| `irm is not recognized` oder `The token '&&' is not a valid statement separator` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |

35| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Aktualisieren Sie Homebrew](#homebrew-cask-unavailable-or-outdated) |37| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Aktualisieren Sie Homebrew](#homebrew-cask-unavailable-or-outdated) |

36| `Cask 'claude-code@latest' is not installed` | [Aktualisieren Sie den Cask, den Sie installiert haben](#cask-is-not-installed) |38| `Cask 'claude-code@latest' is not installed` | [Aktualisieren Sie den Cask, den Sie installiert haben](#cask-is-not-installed) |


564 irm https://claude.ai/install.ps1 | iex566 irm https://claude.ai/install.ps1 | iex

565 ```567 ```

566 568 

5673. **Überprüfen Sie auf Proxy- oder Firewall-Interferenz**: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich `unable to get local issuer certificate` und `SELF_SIGNED_CERT_IN_CHAIN`. Für den Installationsschritt zeigen Sie curl auf Ihr Unternehmens-CA-Bundle mit `--cacert`:5693. **Überprüfen Sie auf Proxy- oder Firewall-Interferenz**: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich `unable to get local issuer certificate` und `SELF_SIGNED_CERT_IN_CHAIN`. Sorgen Sie für den Installationsschritt dafür, dass der Installations-Download der CA Ihres Unternehmens-Proxys vertraut:

568 570 

569 **macOS/Linux**571 **macOS/Linux**

570 572 


631* Wenn ein Unternehmens-Proxy die Übertragung immer wieder schließt, bitten Sie Ihr Netzwerkteam, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Anforderungen an den Netzwerkzugriff](/docs/de/network-config#network-access-requirements).633* Wenn ein Unternehmens-Proxy die Übertragung immer wieder schließt, bitten Sie Ihr Netzwerkteam, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Anforderungen an den Netzwerkzugriff](/docs/de/network-config#network-access-requirements).

632* Führen Sie `claude doctor` in Ihrer Shell aus, um Installationsdiagnosen zu erhalten634* Führen Sie `claude doctor` in Ihrer Shell aus, um Installationsdiagnosen zu erhalten

633 635 

636### Release verification failed for Claude Code

637 

638Diese Meldung von `claude update` oder `claude install` bedeutet, dass Claude Code nicht bestätigen konnte, dass das Release, das installiert werden sollte, echt ist, und daher nichts installiert hat. Eine bereits vorhandene Version funktioniert weiterhin.

639 

640```text theme={null}

641Release verification failed for Claude Code <version> (<reason>). The update was not installed.

642```

643 

644Führen Sie den Schritt aus, der zum Wert in Klammern in Ihrer Meldung passt:

645 

646* **Ein Wert, der mit `sidecar_fetch_` beginnt**: Führen Sie denselben Befehl erneut in Ihrer Shell aus. `claude update` war erfolgreich, wenn eine Zeile ausgegeben wird, die mit `Successfully updated from` beginnt, und `claude install` war erfolgreich, wenn `Claude Code successfully installed!` ausgegeben wird.

647* **Jeder andere Wert**: Versuchen Sie denselben Befehl später erneut

648 

649Bei jedem Wert gilt: Wenn die Meldung erneut erscheint, [melden Sie das Problem](#still-stuck) und fügen Sie die vollständige Meldung bei.

650 

651### `Auto-update failed · Run claude doctor` in der Fußzeile der Sitzung

652 

653Diese rote Zeile bedeutet, dass Claude Code versucht hat, sich im Hintergrund zu aktualisieren, und das Update nicht installiert wurde. Sie können weiterarbeiten, ohne etwas zu unternehmen.

654 

655Die Zeile verweist Sie auf `claude doctor`, dessen Zeile `Last update attempt: failed (install_failed)` ein Datum, aber keine Ursache angibt. Um das Update abzuschließen oder zu sehen, warum es fehlgeschlagen ist, führen Sie stattdessen `claude update` in Ihrer Shell aus. Wenn auch diese Installation fehlschlägt, suchen Sie den Fehler, den `claude update` ausgibt, unter [Ihren Fehler finden](#find-your-error).

656 

634### Falscher Installationsbefehl unter Windows657### Falscher Installationsbefehl unter Windows

635 658 

636Wenn Sie `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.659Wenn Sie `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.


802 825 

803Claude Code v2.1.246 und später zeigen das Dialogfeld nicht während `claude install` oder `claude update` an. Der Befehl wird mit den Einstellungen ausgeführt, die Sie zuletzt genehmigt haben, und Claude Code zeigt das Dialogfeld in Ihrer nächsten interaktiven Sitzung an. Wenn die Startkonfiguration Ihrer Organisation [auf das Abrufen der Einstellungen wartet](/docs/de/server-managed-settings#enforce-fail-closed-startup), z. B. wenn sie `forceRemoteSettingsRefresh` setzt, erscheint das Dialogfeld immer noch während dieser Befehle, und eine Installation, die von einer Pipe aus ausgeführt wird, schlägt immer noch fehl.826Claude Code v2.1.246 und später zeigen das Dialogfeld nicht während `claude install` oder `claude update` an. Der Befehl wird mit den Einstellungen ausgeführt, die Sie zuletzt genehmigt haben, und Claude Code zeigt das Dialogfeld in Ihrer nächsten interaktiven Sitzung an. Wenn die Startkonfiguration Ihrer Organisation [auf das Abrufen der Einstellungen wartet](/docs/de/server-managed-settings#enforce-fail-closed-startup), z. B. wenn sie `forceRemoteSettingsRefresh` setzt, erscheint das Dialogfeld immer noch während dieser Befehle, und eine Installation, die von einer Pipe aus ausgeführt wird, schlägt immer noch fehl.

804 827 

805In jeder anderen Konfiguration hilft das erneute Ausführen des Installationsprogramms, diesen Fehler zu beheben, da das Skript den Installationsbefehl der neuesten Version ausführt, auch wenn Sie um die Installation einer älteren Version bitten. Führen Sie den Befehl für Ihre Plattform erneut aus:828In jeder anderen Konfiguration hilft das erneute Ausführen des Installationsprogramms, diesen Fehler zu beheben, da das Skript den `install`-Befehl der neuesten Version ausführt, auch wenn Sie um die Installation einer älteren Version bitten. Führen Sie den Befehl für Ihre Plattform erneut aus:

806 829 

807**macOS/Linux**830**macOS/Linux**

808 831 

Details

12| :- | :- |12| :- | :- |

13| `command not found`, Installation schlägt fehl, PATH-Probleme, `EACCES`, TLS-Fehler | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install) |13| `command not found`, Installation schlägt fehl, PATH-Probleme, `EACCES`, TLS-Fehler | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install) |

14| Update oder Installation schlägt fehl mit `The connection dropped while downloading the update` oder `aborted` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |14| Update oder Installation schlägt fehl mit `The connection dropped while downloading the update` oder `aborted` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

15| Update oder Installation schlägt fehl mit `Release verification failed for Claude Code` | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#release-verification-failed) |

16| Die Fußzeile der Sitzung zeigt `Auto-update failed · Run claude doctor` in Rot an | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#auto-update-failed) |

15| Anmeldeschleifen, OAuth-Fehler, `403 Forbidden`, „Organisation deaktiviert“, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry-Anmeldedaten | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#login-and-authentication) |17| Anmeldeschleifen, OAuth-Fehler, `403 Forbidden`, „Organisation deaktiviert“, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry-Anmeldedaten | [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install#login-and-authentication) |

16| Einstellungen werden nicht angewendet, Hooks werden nicht ausgelöst, MCP-Server werden nicht geladen | [Debuggen Sie Ihre Konfiguration](/docs/de/debug-your-config) |18| Einstellungen werden nicht angewendet, Hooks werden nicht ausgelöst, MCP-Server werden nicht geladen | [Debuggen Sie Ihre Konfiguration](/docs/de/debug-your-config) |

17| Sitzung wurde im Auto-Modus gestartet, oder Claude bearbeitet Dateien und führt Befehle aus, ohne zu fragen | [Welcher Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) |19| Sitzung wurde im Auto-Modus gestartet, oder Claude bearbeitet Dateien und führt Befehle aus, ohne zu fragen | [Welcher Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) |

vs-code.md +16 −3

Details

174* **Lesezeichen**: Fahren Sie mit der Maus über eine Antwort und klicken Sie auf **Bookmark response**, um sie zu speichern, oder klicken Sie bei einer gespeicherten Antwort auf **Remove bookmark**, um sie zu entfernen.174* **Lesezeichen**: Fahren Sie mit der Maus über eine Antwort und klicken Sie auf **Bookmark response**, um sie zu speichern, oder klicken Sie bei einer gespeicherten Antwort auf **Remove bookmark**, um sie zu entfernen.

175 175 

176 Um gespeicherte Antworten anzusehen, öffnen Sie das Panel Bookmarks. Sie können oben im Claude-Code-Panel auf das Lesezeichensymbol klicken, im Bereich Context des Befehlsmenüs **Bookmarks** wählen oder `/bookmarks` eingeben. Erfordert Claude Code v2.1.286 oder höher.176 Um gespeicherte Antworten anzusehen, öffnen Sie das Panel Bookmarks. Sie können oben im Claude-Code-Panel auf das Lesezeichensymbol klicken, im Bereich Context des Befehlsmenüs **Bookmarks** wählen oder `/bookmarks` eingeben. Erfordert Claude Code v2.1.286 oder höher.

177* **Dateien, die Claude Ihnen sendet**: Wenn die Sitzung mit [Remote Control](/docs/de/remote-control#start-a-remote-control-session) verbunden ist und Claude Ihnen mit dem [Tool `SendUserFile`](/docs/de/tools-reference) Dateien sendet, zeigt die Konversation eine Zeile wie **Sent report.md, chart.png** an. Klicken Sie auf den Namen einer Datei, um sie im Editor zu öffnen.177* **Dateien, die Claude Ihnen sendet**: Wenn die Sitzung mit [Remote Control](/docs/de/remote-control#start-a-remote-control-session) verbunden ist und Claude Ihnen mit dem [Tool `SendUserFile`](/docs/de/tools-reference) Dateien sendet, zeigt die Konversation eine Zeile wie **Sent report.md, chart.png** an. Klicken Sie auf den Namen einer Datei, um sie im Editor zu öffnen. Die Zeile bleibt in der Focus view sichtbar. Erfordert Claude Code v2.1.295 oder höher.

178 

179 Eine Datei erscheint als vollständiger Pfad, den Sie nicht anklicken können, z. B. `\\server\share\report.md`, wenn ihr Pfad einen Netzwerkhost benennt. Claude Code verlinkt diese Datei nicht, weil das Öffnen diesen Host kontaktieren und unter Windows [Ihre Windows-Anmeldedaten an diesen Host senden könnte](/docs/de/permissions#read-only-commands).

178* **Kontextanzeige**: Das Eingabefeld zeigt an, wie viel von Claudes Kontextfenster Sie nutzen. Claude komprimiert bei Bedarf automatisch, oder Sie können `/compact` manuell ausführen.180* **Kontextanzeige**: Das Eingabefeld zeigt an, wie viel von Claudes Kontextfenster Sie nutzen. Claude komprimiert bei Bedarf automatisch, oder Sie können `/compact` manuell ausführen.

179* **Prompt-Cache-Uhr**: Ein Uhrsymbol neben der Kontextanzeige schätzt, wie viel Zeit dem [Prompt-Cache](/docs/de/prompt-caching) der Konversation bis zum Ablauf noch bleibt. Es zählt von der fünfminütigen oder einstündigen [Lebensdauer](/docs/de/prompt-caching#cache-lifetime) des Caches herunter, und jede Antwort, die den Cache nutzt, startet den Countdown neu. Abgesehen von der Komprimierung setzen die [Aktionen, die den Cache ungültig machen](/docs/de/prompt-caching#actions-that-invalidate-the-cache), die Uhr nicht zurück, sodass sie nach einem Modellwechsel noch verbleibende Minuten anzeigen kann.181* **Prompt-Cache-Uhr**: Ein Uhrsymbol neben der Kontextanzeige schätzt, wie viel Zeit dem [Prompt-Cache](/docs/de/prompt-caching) der Konversation bis zum Ablauf noch bleibt. Es zählt von der fünfminütigen oder einstündigen [Lebensdauer](/docs/de/prompt-caching#cache-lifetime) des Caches herunter, und jede Antwort, die den Cache nutzt, startet den Countdown neu. Abgesehen von der Komprimierung setzen die [Aktionen, die den Cache ungültig machen](/docs/de/prompt-caching#actions-that-invalidate-the-cache), die Uhr nicht zurück, sodass sie nach einem Modellwechsel noch verbleibende Minuten anzeigen kann.

180 * Bis der Countdown abgelaufen ist, zeigt das Symbol die verbleibenden Minuten an, z. B. **12m**.182 * Bis der Countdown abgelaufen ist, zeigt das Symbol die verbleibenden Minuten an, z. B. **12m**.


252 254 

253* **Sitzungstitel**: Neue Sitzungen erhalten KI-generierte Titel auf Basis Ihrer ersten Nachricht.255* **Sitzungstitel**: Neue Sitzungen erhalten KI-generierte Titel auf Basis Ihrer ersten Nachricht.

254* **Umbenennen und archivieren**: Fahren Sie mit der Maus über eine Sitzung, um diese Aktionen anzuzeigen. Benennen Sie sie um, um ihr einen aussagekräftigen Titel zu geben, oder archivieren Sie sie, um sie in die Gruppe **Archived sessions** am Ende der Liste zu verschieben.256* **Umbenennen und archivieren**: Fahren Sie mit der Maus über eine Sitzung, um diese Aktionen anzuzeigen. Benennen Sie sie um, um ihr einen aussagekräftigen Titel zu geben, oder archivieren Sie sie, um sie in die Gruppe **Archived sessions** am Ende der Liste zu verschieben.

257* **Fehlende Konversationen bei gesetztem [`claudeProcessWrapper`](#extension-settings)**: Aktualisieren Sie die Erweiterung auf Version 2.1.304 oder höher. Die Liste enthält dann die fehlenden Konversationen sowie Sitzungen, die `claude -p` oder das [Agent SDK](/docs/de/agent-sdk/overview) in diesem Arbeitsbereich gestartet hat.

255 258 

256Wenn die Konversation in einem anderen Claude-Code-Prozess geöffnet ist, etwa `claude` in einem Terminal oder in einem anderen VS-Code-Fenster, erscheint anstelle des Eingabefelds dieser Hinweis:259Wenn die Konversation in einem anderen Claude-Code-Prozess geöffnet ist, etwa `claude` in einem Terminal oder in einem anderen VS-Code-Fenster, erscheint anstelle des Eingabefelds dieser Hinweis:

257 260 


308 311 

309* **claude.ai-Plan**: Nutzungsbalken für die Limits Ihres Plans, etwa für die aktuelle Sitzung und die Woche. Jeder Balken zeigt an, wie lange es dauert, bis sein Limit zurückgesetzt wird.312* **claude.ai-Plan**: Nutzungsbalken für die Limits Ihres Plans, etwa für die aktuelle Sitzung und die Woche. Jeder Balken zeigt an, wie lange es dauert, bis sein Limit zurückgesetzt wird.

310 313 

311 Der Dialog schlüsselt außerdem auf, was zu Ihren Plan-Limits beiträgt. Er kennzeichnet Verhaltensweisen, die 10 % oder mehr der jüngsten Nutzung ausmachen, etwa Cache-Misses, langen Kontext sowie Sitzungen mit vielen Subagenten oder hoher Parallelität. Zu jeder gekennzeichneten Verhaltensweise gibt es einen Tipp, wie Sie sie reduzieren können. Zuordnungstabellen zeigen, wie viel Nutzung auf jeden Skill, Subagenten, jedes Plugin und jeden MCP-Server entfiel.314 Der Dialog schlüsselt außerdem auf, was zu Ihren Plan-Limits beiträgt:

315 

316 * **Empfehlungen**: Änderungen, die Ihre Nutzung senken, eine pro Zeile mit dem Anteil der jüngsten Nutzung, den sie betrifft, z. B. `Trim ~/code/api/CLAUDE.md · 49k tokens per request`

317 * **Schaltfläche zum Beheben**: Damit Claude Code die Empfehlungen anwendet, die es umsetzen kann, klicken Sie auf die Schaltfläche darunter, z. B. **Fix both**. Auf welche Zeilen sich die Schaltfläche auswirkt und was danach in Ihrer Sitzung geschieht, erfahren Sie unter [Empfehlungen mit der Fix-Verknüpfung anwenden](/docs/de/costs#apply-recommendations-with-the-fix-shortcut). Erfordert Claude Code v2.1.305 oder höher.

318 

319 Die Schaltfläche wird nicht angezeigt, solange [Remote Control](/docs/de/remote-control) verbunden ist. Wenn nach dem Verbinden von Remote Control die Warnung `The usage fix wasn’t fully sent. Open usage and try again.` erscheint, [trennen Sie Remote Control](/docs/de/remote-control#check-connection-status), bevor Sie es erneut versuchen.

320 * **Zuordnung**: Tabellen, die zeigen, wie viel Nutzung auf jeden Skill, Subagenten, jedes Plugin und jeden MCP-Server entfiel

312 321 

313 Verwenden Sie den Umschalter Day/Week, um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Angaben sind Näherungswerte und werden aus lokalen Sitzungen auf diesem Rechner berechnet, sodass Nutzung auf anderen Geräten oder auf claude.ai nicht enthalten ist.322 Verwenden Sie den Umschalter Day/Week, um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Angaben sind Näherungswerte und werden aus lokalen Sitzungen auf diesem Rechner berechnet, sodass Nutzung auf anderen Geräten oder auf claude.ai nicht enthalten ist.

314* **Andere Anmeldungen**: Wenn für Ihre Anmeldung keine Plan-Limits gelten, etwa bei einem [Drittanbieter](#use-third-party-providers) oder mit einem API-Schlüssel, zeigt der Abschnitt Usage stattdessen die Kosten und die Token-Nutzung der Sitzung selbst an. Der `/usage`-Befehl der CLI zeigt dieselben Summen in seinem [Session-Block](/docs/de/costs#track-your-costs) an. Die Sitzungsliste in der Aktivitätsleiste zeigt die Summen der aktiven Sitzung ebenfalls unter ihrer Überschrift **Account & usage** an. Erfordert Claude Code v2.1.277 oder höher.323* **Andere Anmeldungen**: Wenn für Ihre Anmeldung keine Plan-Limits gelten, etwa bei einem [Drittanbieter](#use-third-party-providers) oder mit einem API-Schlüssel, zeigt der Abschnitt Usage stattdessen die Kosten und die Token-Nutzung der Sitzung selbst an. Der `/usage`-Befehl der CLI zeigt dieselben Summen in seinem [Session-Block](/docs/de/costs#track-your-costs) an. Die Sitzungsliste in der Aktivitätsleiste zeigt die Summen der aktiven Sitzung ebenfalls unter ihrer Überschrift **Account & usage** an. Erfordert Claude Code v2.1.277 oder höher.


573 582 

574Bei einem Shell-Befehl im Hintergrund oder einem [Monitor](/docs/de/tools-reference#monitor-tool), der einen Befehl ausführt, zeigt die Karte außerdem die neueste Ausgabe des Befehls an und aktualisiert sie, während der Befehl läuft.583Bei einem Shell-Befehl im Hintergrund oder einem [Monitor](/docs/de/tools-reference#monitor-tool), der einen Befehl ausführt, zeigt die Karte außerdem die neueste Ausgabe des Befehls an und aktualisiert sie, während der Befehl läuft.

575 584 

585#### Tool-Aufrufe eines Subagenten im Hintergrund anzeigen

586 

587Wenn ein Subagent als einzelne Statuszeile ohne Tool-Aufrufe angezeigt wird, geben Sie `/tasks` in das Eingabefeld ein, um die [Agentenübersicht](#use-the-prompt-box) zu öffnen, und klicken Sie dort auf den Subagenten. Der Subagent [läuft im Hintergrund](#the-run-in-background-action-is-missing-under-a-subagent), und seine Karte zeigt seine Tool-Aufrufe sowie eine Schaltfläche, die sein Transkript öffnet.

588 

576## VS Code-Befehle und Tastenkombinationen589## VS Code-Befehle und Tastenkombinationen

577 590 

578Um die Befehlspalette zu öffnen, drücken Sie `Cmd+Shift+P` auf dem Mac oder `Ctrl+Shift+P` unter Windows/Linux. Geben Sie dort „Claude Code“ ein, um alle verfügbaren VS Code-Befehle für die Claude Code-Erweiterung anzuzeigen.591Um die Befehlspalette zu öffnen, drücken Sie `Cmd+Shift+P` auf dem Mac oder `Ctrl+Shift+P` unter Windows/Linux. Geben Sie dort „Claude Code“ ein, um alle verfügbaren VS Code-Befehle für die Claude Code-Erweiterung anzuzeigen.


726 739 

727* **Antworten von Claude**: Die Erweiterung kündigt jede Antwort einmal an, sobald sie vollständig ist, und bleibt still, während der Text gestreamt wird. Ihr Screenreader liest Codeblöcke als Zusammenfassung der Zeilenanzahl vor, liest Links anhand ihrer Beschriftung und liest Tabellen Zelle für Zelle vor; die vollständige Antwort bleibt im Transkript lesbar.740* **Antworten von Claude**: Die Erweiterung kündigt jede Antwort einmal an, sobald sie vollständig ist, und bleibt still, während der Text gestreamt wird. Ihr Screenreader liest Codeblöcke als Zusammenfassung der Zeilenanzahl vor, liest Links anhand ihrer Beschriftung und liest Tabellen Zelle für Zelle vor; die vollständige Antwort bleibt im Transkript lesbar.

728* **Berechtigungsanfragen und Fragen**: Die Erweiterung kündigt eine Anfrage an, wenn ihre Berechtigungsabfrage erscheint, und nennt dabei das Tool, das Claude verwenden möchte. Auf dieselbe Weise erfolgt eine Ankündigung, wenn Claude Ihnen eine Frage stellt und wenn Claude einen Plan fertigstellt und auf Ihre Prüfung wartet.741* **Berechtigungsanfragen und Fragen**: Die Erweiterung kündigt eine Anfrage an, wenn ihre Berechtigungsabfrage erscheint, und nennt dabei das Tool, das Claude verwenden möchte. Auf dieselbe Weise erfolgt eine Ankündigung, wenn Claude Ihnen eine Frage stellt und wenn Claude einen Plan fertigstellt und auf Ihre Prüfung wartet.

729* **Statusänderungen**: Die Erweiterung kündigt an, wenn Claude mit der Arbeit beginnt, wenn Claude für Ihre Eingabe bereit ist und wenn Claude Code mit dem Komprimieren der Konversation beginnt.742* **Statusänderungen**: Die Erweiterung kündigt an, wenn Claude mit der Arbeit beginnt, wenn Claude für Ihre Eingabe bereit ist und wenn Claude Code mit dem Komprimieren der Konversation beginnt. Wenn Sie einen Prompt senden, während die [SessionStart](/docs/de/hooks#sessionstart)-Hooks der Sitzung noch laufen, sagt Ihr Screenreader außerdem „Running start-up hooks.“

730* **Nachrichten in der Warteschlange**: Wenn Sie eine Nachricht senden, während Claude arbeitet, kündigt die Erweiterung für diese Nachricht „Message queued.“ an.743* **Nachrichten in der Warteschlange**: Wenn Sie eine Nachricht senden, während Claude arbeitet, kündigt die Erweiterung für diese Nachricht „Message queued.“ an.

731* **Fehler und Modellabfragen**: Die Erweiterung kündigt Fehler in der Konversation an und kündigt an, wenn die [Zustimmungsabfrage für Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) oder die [Abfrage für markierte Anfragen](/docs/de/model-config#ask-before-switching) erscheint.744* **Fehler und Modellabfragen**: Die Erweiterung kündigt Fehler in der Konversation an und kündigt an, wenn die [Zustimmungsabfrage für Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) oder die [Abfrage für markierte Anfragen](/docs/de/model-config#ask-before-switching) erscheint.

732 745 

workflows.md +67 −65

Details

361| Bis zu 4.096 Elemente in einem einzelnen `parallel()`- oder `pipeline()`-Aufruf: Die Laufzeit lehnt eine längere Liste mit einem Fehler ab | Eine stille Obergrenze würde einen Teil der Arbeitslast ablegen, ohne das Skript zu informieren |361| Bis zu 4.096 Elemente in einem einzelnen `parallel()`- oder `pipeline()`-Aufruf: Die Laufzeit lehnt eine längere Liste mit einem Fehler ab | Eine stille Obergrenze würde einen Teil der Arbeitslast ablegen, ohne das Skript zu informieren |

362| 1.000 Agenten insgesamt pro Ausführung | Verhindert Endlosschleifen |362| 1.000 Agenten insgesamt pro Ausführung | Verhindert Endlosschleifen |

363 363 

364## Verwalten Sie Ausführungen364## Läufe verwalten

365 365 

366Sobald eine Ausführung startet, verwalten Sie sie über die `/workflows`-Ansicht oder durch Erweitern der Fortschrittszeile im Aufgabenpanel unter dem Eingabefeld.366Sobald ein Lauf gestartet ist, verwalten Sie ihn über die Ansicht `/workflows` oder indem Sie seine Fortschrittszeile im Aufgabenbereich unter dem Eingabefeld aufklappen.

367 367 

368Wenn Sie eine Ausführung stoppen, bleibt sie im Aufgabenpanel, während alle Prozesse ihrer Agenten noch laufen. Wenn Sie sie erneut stoppen, signalisiert Claude Code diese Prozesse erneut.368Wenn Sie einen Lauf stoppen, bleibt er im Aufgabenbereich, solange noch Prozesse seiner Agenten laufen. Wenn Sie ihn erneut stoppen, sendet Claude Code erneut ein Signal an diese Prozesse.

369 369 

370### Fortsetzen nach einer Pause370### Nach einer Pause fortsetzen

371 371 

372Setzen Sie eine unterbrochene Ausführung von `/workflows` fort, indem Sie sie auswählen und `p` drücken. Für eine Ausführung, die Sie gestoppt haben, bitten Sie Claude, den Workflow mit dem gleichen Skript erneut zu starten. Wenn Agenten aus der gestoppten Ausführung noch nicht beendet wurden, weigert sich Claude Code, den Neustart durchzuführen, bis sie beendet sind, sodass keine zweite Kopie dieser Agenten neben ihnen laufen kann.372Setzen Sie einen pausierten Lauf in `/workflows` fort, indem Sie ihn auswählen und `p` drücken. Bei einem Lauf, den Sie gestoppt haben, bitten Sie Claude, den Workflow mit demselben Skript neu zu starten. Wenn Agenten aus dem gestoppten Lauf noch nicht beendet sind, verweigert Claude Code den Neustart, bis sie beendet sind, damit keine zweite Kopie dieser Agenten parallel zu ihnen laufen kann.

373 373 

374#### Welche Agenten erneut ausgeführt werden374#### Welche Agenten erneut ausgeführt werden

375 375 

376Claude Code spielt die Ausführung in der Reihenfolge ab, in der die Agenten gestartet wurden, und jeder Agent gibt entweder sein gespeichertes Ergebnis zurück oder wird erneut ausgeführt:376Claude Code spielt den Lauf in der Reihenfolge ab, in der die Agenten starten, und jeder Agent gibt entweder sein gespeichertes Ergebnis zurück oder wird erneut ausgeführt:

377 377 

378* **Abgeschlossen**: gibt sein gespeichertes Ergebnis zurück. Der erste Agent, dessen Eingabeaufforderung sich vom vorherigen Durchlauf unterscheidet, weil Sie das Skript bearbeitet haben oder ein früherer Agent etwas anderes zurückgegeben hat, wird erneut ausgeführt, und ebenso jeder Agent danach, auch solche, die abgeschlossen wurden.378* **Abgeschlossen**: gibt sein gespeichertes Ergebnis zurück. Der erste Agent, dessen Prompt sich vom vorherigen Lauf unterscheidet, weil Sie das Skript bearbeitet haben oder ein früherer Agent etwas anderes zurückgegeben hat, wird erneut ausgeführt, ebenso jeder Agent danach, auch bereits abgeschlossene.

379* **Noch ausgeführt, als Sie gestoppt haben**: startet neu. Das Stoppen der gesamten Ausführung zählt keinen Agent als fehlgeschlagen.

380* **Fehlgeschlagen**: wird erneut ausgeführt, und ebenso jeder Agent, der danach gestartet wurde, auch solche, die abgeschlossen wurden. Das Stoppen eines einzelnen Agenten durch Auswahl in [`/workflows`](#watch-the-run) und Drücken von `x` zählt als Fehler.

381 379 

382Der letzte Fall bedeutet, dass ein Fehler in der Mitte eines Fan-out-Durchlaufs Arbeit erneut ausführt, die bereits abgeschlossen war. Wenn ein Skript A, B, C und D in dieser Reihenfolge startet und B fehlschlägt, gibt das erneute Starten A aus dem Cache zurück und führt B, C und D erneut aus.380 Vor v2.1.305 konnten abgeschlossene Agenten auch dann erneut ausgeführt werden, wenn Sie ein unverändertes Skript neu starteten, dessen `pipeline()`-Elemente oder `parallel()`-Aufgaben jeweils mehr als einen Agenten ausführten. Um diese erneuten Ausführungen bei neuen Läufen zu verhindern, aktualisieren Sie Claude Code.

381* **Lief noch, als Sie gestoppt haben**: beginnt von vorn. Das Stoppen des gesamten Laufs zählt keinen Agenten als fehlgeschlagen.

382* **Fehlgeschlagen**: wird erneut ausgeführt, ebenso jeder Agent, den das Skript danach startet, auch bereits abgeschlossene. Das Stoppen eines einzelnen Agenten, indem Sie ihn in [`/workflows`](#watch-the-run) auswählen und `x` drücken, zählt als Fehlschlag.

383 383 

384Wenn Sie ein Skript, das A, B, C und D gestartet hat, so bearbeiten, dass es A, C, B und D startet, ist der zweite gestartete Agent nun C, während die vorherige Ausführung an dieser Stelle B gestartet hat. Das erneute Starten gibt A aus dem Cache zurück und führt C, B und D erneut aus.384Der letzte Fall bedeutet, dass ein Fehlschlag mitten in einem Fan-out bereits abgeschlossene Arbeit erneut ausführt. Wenn ein Skript A, B, C und D in dieser Reihenfolge startet und B fehlschlägt, gibt ein Neustart A aus dem Cache zurück und führt B, C und D erneut aus.

385 

386Wenn Sie ein Skript, das A, B, C und D gestartet hat, so bearbeiten, dass es A, C, B und D startet, ist der zweite gestartete Agent jetzt C, wo der vorherige Lauf B gestartet hat. Ein Neustart gibt A aus dem Cache zurück und führt C, B und D erneut aus.

385 387 

386#### Fortsetzen, nachdem Sie die Sitzung verlassen haben388#### Fortsetzen, nachdem Sie die Sitzung verlassen haben

387 389 

388Sie können eine Ausführung innerhalb derselben Claude Code-Sitzung fortsetzen. Was mit einem laufenden Workflow geschieht, wenn Sie die Sitzung verlassen, hängt davon ab, wie Sie sie verlassen:390Sie können einen Lauf innerhalb derselben Claude-Code-Sitzung fortsetzen. Was mit einem laufenden Workflow geschieht, wenn Sie die Sitzung verlassen, hängt davon ab, wie Sie sie verlassen:

389 391 

390* Wenn Sie [die Sitzung in den Hintergrund verschieben](/docs/de/agent-view#what-carries-over-when-you-background), spielt Claude Code die Ausführung auf die gleiche Weise in der Hintergrund-Sitzung ab und setzt sie fort.392* Wenn Sie [die Sitzung in den Hintergrund verschieben](/docs/de/agent-view#what-carries-over-when-you-background), spielt Claude Code den Lauf auf dieselbe Weise in der Hintergrundsitzung ab und setzt ihn fort.

391* Wenn Sie Claude Code beenden, während ein Workflow ausgeführt wird, und [die Agent-Ansicht aktiviert ist](/docs/de/agent-view#from-inside-a-session), bietet der Beendigungsdialog `Move to background and exit` an, was die Ausführung auf die gleiche Weise überträgt. Wenn Sie stattdessen `Exit and stop tasks` wählen oder die Option nicht angeboten wird, stoppt die Ausführung mit der Sitzung. Claude Code behält die gespeicherten Ergebnisse der Ausführung im Verzeichnis dieser Sitzung in `~/.claude/projects/` bei, sodass eine Sitzung, die Sie mit `claude --resume` fortsetzen, diese abspielen kann, wenn Sie Claude bitten, den Workflow erneut zu starten. In einer neu gestarteten Sitzung hat Claude keine frühere Ausführung zum Abspielen und startet den Workflow als neue Ausführung.393* Wenn Sie Claude Code beenden, während ein Workflow läuft und [die Agentenansicht aktiviert ist](/docs/de/agent-view#from-inside-a-session), bietet der Beenden-Dialog `Move to background and exit` an, wodurch der Lauf auf dieselbe Weise übernommen wird. Wenn Sie stattdessen `Exit and stop tasks` wählen oder die Option nicht angeboten wird, stoppt der Lauf mit der Sitzung. Claude Code bewahrt die gespeicherten Ergebnisse des Laufs im Verzeichnis dieser Sitzung unter `~/.claude/projects/` auf, sodass eine Sitzung, die Sie mit `claude --resume` fortsetzen, sie abspielen kann, wenn Sie Claude bitten, den Workflow neu zu starten. In einer neu gestarteten Sitzung hat Claude keinen früheren Lauf, den es neu starten könnte, und startet den Workflow als neuen Lauf von vorn.

392 394 

393In einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) speichert Claude Code auch die Ergebnisse der Ausführung zusammen mit der Gesprächshistorie der Sitzung, die erhalten bleibt, wenn die VM der Sitzung zurückgefordert wird. Wenn Sie [eine solche Sitzung erneut öffnen](/docs/de/claude-code-on-the-web#environment-expired) und Claude bitten, den Workflow erneut zu starten, geben abgeschlossene Agenten immer noch ihre gespeicherten Ergebnisse zurück.395In einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) speichert Claude Code die Ergebnisse des Laufs außerdem mit dem Konversationsverlauf der Sitzung, der erhalten bleibt, wenn die VM der Sitzung freigegeben wird. Wenn Sie [eine solche Sitzung wieder öffnen](/docs/de/claude-code-on-the-web#environment-expired) und Claude bitten, den Workflow neu zu starten, geben abgeschlossene Agenten weiterhin ihre gespeicherten Ergebnisse zurück.

394 396 

395In lokalen und Cloud-Sitzungen gleichermaßen schlägt der Neustart fehl, wenn Claude eine frühere Ausführung erneut startet und Claude Code die gespeicherten Ergebnisse dieser Ausführung überhaupt nicht finden kann, mit einem `nothing to resume`-Fehler, anstatt die Ausführung von selbst neu zu starten. Bitten Sie Claude, den Workflow als neue Ausführung neu zu starten.397Sowohl in lokalen als auch in Cloud-Sitzungen gilt: Wenn Claude einen früheren Lauf neu startet und Claude Code die gespeicherten Ergebnisse dieses Laufs überhaupt nicht finden kann, schlägt der Neustart mit einem `nothing to resume`-Fehler fehl, anstatt den Lauf eigenständig von vorn zu beginnen. Bitten Sie Claude, den Workflow als neuen Lauf von vorn zu starten.

396 398 

397### Wenn eine Ausführung Ihr Nutzungslimit erreicht399### Wenn ein Lauf Ihr Nutzungslimit erreicht

398 400 

399Wenn ein Agent Ihr claude.ai [Nutzungslimit](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) erreicht, wird die Ausführung unterbrochen, anstatt diesen Agent fehlschlagen zu lassen: Die Agenten, die das Limit erreicht haben, warten auf den Reset, und es starten keine neuen Agenten. Kurz nach dem Limit-Reset werden die wartenden Agenten erneut ausgeführt und die Ausführung wird automatisch fortgesetzt. Erfordert Claude Code v2.1.271 oder später; in früheren Versionen schlagen die betroffenen Agenten fehl.401Wenn ein Agent Ihr claude.ai-[Nutzungslimit](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) erreicht, wird der Lauf pausiert, anstatt diesen Agenten fehlschlagen zu lassen: Die Agenten, die das Limit erreicht haben, warten auf das Zurücksetzen, und es starten keine neuen Agenten. Kurz nachdem das Limit zurückgesetzt wurde, werden die wartenden Agenten erneut ausgeführt, und der Lauf wird eigenständig fortgesetzt. Erfordert Claude Code v2.1.271 oder neuer; in früheren Versionen schlagen die betroffenen Agenten fehl.

400 402 

401Während die Ausführung wartet, zeigen die Fortschrittszeile im Aufgabenpanel und der [`/workflows`](#watch-the-run)-Header an, wann das Limit zurückgesetzt wird.403Während der Lauf wartet, zeigen seine Fortschrittszeile im Aufgabenbereich und die Kopfzeile von [`/workflows`](#watch-the-run) an, wann das Limit zurückgesetzt wird.

402 404 

403Die Ausführung wird nur unterbrochen, wenn alle diese Bedingungen erfüllt sind; wenn eine nicht erfüllt ist, schlägt der betroffene Agent stattdessen fehl:405Der Lauf wird nur pausiert, wenn alle folgenden Bedingungen erfüllt sind; ist eine nicht erfüllt, schlägt der betroffene Agent stattdessen fehl:

404 406 

405* Die Sitzung ist interaktiv und mit einem claude.ai-Abonnement angemeldet. Eine Ausführung wird nicht unterbrochen im [nicht-interaktiven Modus](/docs/de/headless) mit `claude -p` oder dem [Agent SDK](/docs/de/agent-sdk/overview), in einer [Hintergrund-Sitzung](/docs/de/agent-view), oder in einer [Remote Control](/docs/de/remote-control) oder [Agent-Team](/docs/de/agent-teams) Kollegensitzung.407* Die Sitzung ist interaktiv und mit einem claude.ai-Abonnement angemeldet. Ein Lauf wird nicht pausiert im [nicht interaktiven Modus](/docs/de/headless) mit `claude -p` oder dem [Agent SDK](/docs/de/agent-sdk/overview), in einer [Hintergrundsitzung](/docs/de/agent-view) oder in einer [Remote-Control](/docs/de/remote-control)- oder [Agent-Team](/docs/de/agent-teams)-Teammitglied-Sitzung.

406* [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) ist aktiviert, die gleiche Einstellung, die die Sitzung selbst [auf einen Nutzungslimit-Reset warten lässt](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset). Wenn Sie sie während eines Wartevorgangs ausschalten, endet der Wartevorgang und die wartenden Agenten schlagen fehl.408* [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) ist aktiviert, dieselbe Einstellung, mit der die Sitzung selbst [auf das Zurücksetzen eines Nutzungslimits warten](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) kann. Wenn Sie sie während einer Wartezeit deaktivieren, endet die Wartezeit, und die wartenden Agenten schlagen fehl.

407* Das Limit wird innerhalb von 24 Stunden zurückgesetzt. Ein wöchentliches Limit kann weiter hinaus zurückgesetzt werden.409* Das Limit wird innerhalb von 24 Stunden zurückgesetzt. Ein wöchentliches Limit kann später zurückgesetzt werden.

408* Die Ausführung hat nicht bereits zweimal gewartet. Wenn sie das Limit zum dritten Mal erreicht, schlägt der Agent fehl.410* Der Lauf hat noch nicht zweimal gewartet. Wenn er das Limit ein drittes Mal erreicht, schlägt der Agent fehl.

409 411 

410### Wenn ein Agent hängen bleibt und neu startet412### Wenn ein Agent hängen bleibt und neu startet

411 413 

412Ein Agent, dessen Ausgabe lange genug ausbleibt, beginnt mit demselben Prompt von vorn. In [`/workflows`](#watch-the-run) erhält sein Name das Suffix `(retry 1)`, und seine Detailansicht zeigt `attempt 2 (stalled)`. Der Neustart erfolgt automatisch, Sie müssen also nichts tun.414Ein Agent, dessen Ausgabe lange genug ausbleibt, beginnt mit demselben Prompt von vorn. In [`/workflows`](#watch-the-run) erhält sein Name das Suffix `(retry 1)`, und seine Details zeigen `attempt 2 (stalled)`. Der Neustart erfolgt automatisch, Sie müssen also nichts tun.

413 415 

414Der neue Versuch beginnt ohne das Transkript des hängengebliebenen Versuchs. Dateien, die der hängengebliebene Versuch bereits geändert hat, bleiben geändert, und die von ihm verbrauchten Token bleiben in der Gesamtsumme der Ausführung. Das Stall-Fenster ist die Zeit, die Claude Code auf eine Ausgabe eines Agenten wartet, bevor es den Versuch beendet. Zeit, die der Agent mit Warten auf seine eigenen Tool-Aufrufe oder auf einen [Nutzungslimit-Reset](#when-a-run-hits-your-usage-limit) verbringt, zählt nicht zum Stall-Fenster.416Der neue Versuch startet ohne das Transkript des hängengebliebenen Versuchs. Dateien, die der hängengebliebene Versuch bereits geändert hat, bleiben geändert, und die Token, die er verbraucht hat, bleiben in der Gesamtsumme des Laufs. Das Stall-Fenster ist die Zeitspanne, die Claude Code auf eine Ausgabe eines Agenten wartet, bevor es den Versuch beendet. Zeit, die der Agent mit dem Warten auf seine eigenen Tool-Aufrufe oder auf das [Zurücksetzen eines Nutzungslimits](#when-a-run-hits-your-usage-limit) verbringt, zählt nicht zum Stall-Fenster.

415 417 

416Ein Agent startet höchstens fünfmal neu, einschließlich aller Neustarts, die Sie mit `r` anfordern. Wenn auch der sechste Versuch hängen bleibt, schlägt der `agent()`-Aufruf fehl, und der Anfang der Fehlermeldung nennt den Grund:418Ein Agent startet höchstens fünfmal neu, einschließlich aller Neustarts, die Sie mit `r` anfordern. Wenn auch der sechste Versuch hängen bleibt, schlägt der `agent()`-Aufruf fehl, und der Anfang der Fehlermeldung nennt den Grund:

417 419 

418* `agent stalled on all 6 attempts`: Jeder Versuch verstrich über das gesamte Fenster ohne Ausgabe. Wenn die Arbeit des Agenten ihn so lange ohne Ausgabe lässt, verlängern Sie das Fenster420* `agent stalled on all 6 attempts`: Jeder Versuch hat das gesamte Fenster ohne Ausgabe verbracht. Wenn die Arbeit des Agenten ihn so lange still hält, verlängern Sie das Fenster

419* `agent lost its reply on all 6 attempts`: Der Antwort-Stream jedes Versuchs verstummte, und Claude Code hörte auf, darauf zu warten. Ein längeres Stall-Fenster hilft nicht, da ein [Streaming-Idle-Watchdog](/docs/de/network-config#streaming-idle-watchdogs) die Antwort zuerst beendet hat und `CLAUDE_STREAM_IDLE_TIMEOUT_MS` den Timeout dieses Watchdogs festlegt421* `agent lost its reply on all 6 attempts`: Der Antwort-Stream jedes Versuchs ist verstummt, und Claude Code hat das Warten darauf aufgegeben. Eine Verlängerung des Stall-Fensters hilft nicht, da ein [Streaming-Idle-Watchdog](/docs/de/network-config#streaming-idle-watchdogs) die Antwort zuerst beendet hat und `CLAUDE_STREAM_IDLE_TIMEOUT_MS` den Timeout dieses Watchdogs festlegt

420* `agent abandoned after 6 attempts`: Die Versuche endeten auf unterschiedliche Weise, die der Fehler der Reihe nach auflistet422* `agent abandoned after 6 attempts`: Die Versuche endeten auf unterschiedliche Weise, die die Fehlermeldung der Reihe nach auflistet

421 423 

422Um einem Agenten mehr Zeit für eine Ausgabe zu geben, bevor das Fenster endet:424So geben Sie einem Agenten mehr Zeit, eine Ausgabe zu erzeugen, bevor das Fenster endet:

423 425 

424* **Ein Agent**: Übergeben Sie `stallMs` in Millisekunden in seinem `agent()`-Aufruf, etwa `agent(prompt, { stallMs: 1800000 })` für 30 Minuten426* **Ein Agent**: Übergeben Sie `stallMs` in Millisekunden an seinen `agent()`-Aufruf, etwa `agent(prompt, { stallMs: 1800000 })` für 30 Minuten

425* **Alle Agenten**: Setzen Sie [`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`](/docs/de/env-vars#variables), was auch für Subagenten außerhalb von Workflows gilt427* **Alle Agenten**: Setzen Sie [`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`](/docs/de/env-vars#variables), was auch für Subagenten außerhalb von Workflows gilt

426 428 

427Ob die Ausführung nach dem Fehler fortgesetzt wird, hängt davon ab, wie Ihr Skript den Agenten aufgerufen hat:429Ob der Lauf nach dem Fehlschlag fortgesetzt wird, hängt davon ab, wie Ihr Skript den Agenten aufgerufen hat:

428 430 

429* **Innerhalb von [`parallel()` oder `pipeline()`](#what-the-saved-script-looks-like)**: Die Ausführung läuft weiter, mit `null` anstelle des Ergebnisses des Agenten431* **Innerhalb von [`parallel()` oder `pipeline()`](#what-the-saved-script-looks-like)**: Der Lauf wird mit `null` anstelle des Ergebnisses des Agenten fortgesetzt

430* **Direkt mit await abgewartet**: Die Ausführung endet mit dem Fehler432* **Direkt mit await aufgerufen**: Der Lauf endet mit dem Fehler

431 433 

432Um es erneut zu versuchen, bitten Sie Claude, den Workflow erneut zu starten. [Fortsetzen nach einer Pause](#resume-after-a-pause) beschreibt, was erneut ausgeführt wird.434Um es erneut zu versuchen, bitten Sie Claude, den Workflow neu zu starten. [Nach einer Pause fortsetzen](#resume-after-a-pause) beschreibt, was erneut ausgeführt wird.

433 435 

434### Kosten436### Kosten

435 437 

436Ein Workflow spawnt viele Agenten, sodass eine einzelne Ausführung bedeutend mehr Token verwenden kann als die Bearbeitung der gleichen Aufgabe in einem Gespräch. Ausführungen zählen zur Nutzung und zu Ratenlimits Ihres Plans.438Ein Workflow startet viele Agenten, daher kann ein einzelner Lauf deutlich mehr Token verbrauchen, als dieselbe Aufgabe in der Konversation zu bearbeiten. Läufe werden auf die Nutzung und die Rate-Limits Ihres Plans angerechnet.

437 439 

438Um die Ausgaben vor der Verpflichtung zu einer großen Aufgabe zu schätzen, führen Sie den Workflow zunächst auf einem kleinen Ausschnitt aus: ein Verzeichnis statt des gesamten Repositorys oder eine enge Frage statt einer breiten. Die `/workflows`-Ansicht zeigt die Token-Nutzung jedes Agenten während der Ausführung an, und Sie können die Ausführung dort jederzeit beenden, ohne abgeschlossene Arbeiten zu verlieren. [Fortsetzen nach einer Pause](#resume-after-a-pause) behandelt, was eine gestoppte Ausführung behält. Die Laufzeit-[Agent-Limits](#behavior-and-limits) begrenzen, wie viele Agenten eine einzelne Ausführung spawnen kann, was die Kosten eines unkontrollierten Skripts begrenzt. Um Ausführungen auf weniger Agenten zu halten, wählen Sie die `small` [Größenrichtlinie](#set-a-size-guideline).440Um den Verbrauch abzuschätzen, bevor Sie sich auf eine große Aufgabe festlegen, führen Sie den Workflow zuerst auf einem kleinen Ausschnitt aus: ein Verzeichnis statt des gesamten Repositorys oder eine eng gefasste Frage statt einer breiten. Die Ansicht `/workflows` zeigt den Token-Verbrauch jedes Agenten während des Laufs, und Sie können den Lauf dort jederzeit stoppen, in der Regel ohne abgeschlossene Arbeit zu verlieren. [Nach einer Pause fortsetzen](#resume-after-a-pause) beschreibt, was ein gestoppter Lauf behält. Die [Agenten-Obergrenzen](#behavior-and-limits) der Laufzeitumgebung begrenzen, wie viele Agenten ein einzelner Lauf starten kann, was die Kosten eines außer Kontrolle geratenen Skripts begrenzt. Um Läufe auf weniger Agenten zu beschränken, wählen Sie die [Größenrichtlinie](#set-a-size-guideline) `small`.

439 441 

440Claude Code kennzeichnet auch eine Ausführung, die ungewöhnlich groß wird. Wenn ein Workflow mehr als 25 Agenten plant oder seine projizierte Token-Gesamtzahl 1,5 Millionen überschreitet, zeigt die Fortschrittszeile im Aufgabenpanel unter dem Eingabefeld eine `Large workflow`-Warnung an. Die Warnung verweist Sie auf [`/workflows`](#watch-the-run), wo Sie die Ausführung beenden können.442Claude Code kennzeichnet außerdem einen Lauf, der ungewöhnlich groß wird. Wenn ein Workflow mehr als 25 Agenten einplant oder seine prognostizierte Token-Gesamtzahl 1,5 Millionen überschreitet, zeigt seine Fortschrittszeile im Aufgabenbereich unter dem Eingabefeld eine `Large workflow`-Warnung. Die Warnung verweist Sie auf [`/workflows`](#watch-the-run), wo Sie den Lauf stoppen können.

441 443 

442Die Warnung ist informativ: Sie pausiert oder begrenzt die Ausführung nicht. Zwei Einstellungen ändern sich, wenn Sie sie sehen:444Die Warnung ist nur ein Hinweis: Sie pausiert oder begrenzt den Lauf nicht. Zwei Einstellungen ändern, wann Sie sie sehen:

443 445 

444* Wenn Sie eine [Größenrichtlinie](#set-a-size-guideline) selbst wählen, ersetzt die Agentenzahl dieser Richtlinie den Schwellenwert von 25 Agenten. Die integrierte Standard-Richtlinie lässt den Schwellenwert bei 25.446* Wenn Sie selbst eine [Größenrichtlinie](#set-a-size-guideline) wählen, ersetzt deren Agentenanzahl den Schwellenwert von 25 Agenten. Die integrierte Standardrichtlinie belässt den Schwellenwert bei 25.

445* Sitzungen mit [ultracode](#let-claude-decide-with-ultracode) aktiviert zeigen die Warnung nicht an, da das Aktivieren von ultracode Sie bereits für große Ausführungen anmeldet.447* Sitzungen mit aktiviertem [ultracode](#let-claude-decide-with-ultracode) zeigen die Warnung nicht, da Sie durch das Aktivieren von ultracode bereits große Läufe zulassen.

446 448 

447Claude Code wählt das Modell jedes Workflow-Agenten in der gleichen [Reihenfolge, die es für Subagenten verwendet](/docs/de/sub-agents#choose-a-model). Ein Modell, das das Skript für eine Phase benennt, zählt als das Pro-Aufruf-Modell in dieser Reihenfolge. Wenn nichts anderes eines zuweist, wird der Agent auf dem Modell Ihrer Sitzung ausgeführt.449Claude Code wählt das Modell jedes Workflow-Agenten in derselben [Reihenfolge wie bei Subagenten](/docs/de/sub-agents#choose-a-model). Ein Modell, das das Skript für eine Phase angibt, zählt in dieser Reihenfolge als das Modell pro Aufruf. Wenn nichts anderes eines zuweist, läuft der Agent auf dem Modell Ihrer Sitzung.

448 450 

449Um die Modellkosten zu kontrollieren:451So steuern Sie die Modellkosten:

450 452 

451* Überprüfen Sie `/model` vor einer großen Ausführung, wenn Sie normalerweise zu einem kleineren Modell für Routinearbeit wechseln453* Prüfen Sie `/model` vor einem großen Lauf, wenn Sie für Standardarbeiten normalerweise zu einem kleineren Modell wechseln

452* Bitten Sie Claude, ein kleineres Modell für Phasen zu verwenden, die nicht das stärkste benötigen, wenn Sie die Aufgabe beschreiben454* Bitten Sie Claude bei der Beschreibung der Aufgabe, für Phasen, die nicht das stärkste Modell benötigen, ein kleineres Modell zu verwenden

453 455 

454Wenn die [`availableModels`-Allowlist](/docs/de/model-config#restrict-model-selection) Ihrer Organisation ein Modell blockiert, das das Skript für einen Agenten anfordert, wird dieser Agent stattdessen auf einem ersetzten Modell ausgeführt, wobei die gleichen [Ersetzungsregeln wie bei Subagenten](/docs/de/sub-agents#choose-a-model) gelten.456Wenn die [`availableModels`-Allowlist](/docs/de/model-config#restrict-model-selection) Ihrer Organisation ein Modell blockiert, das das Skript für einen Agenten anfordert, läuft dieser Agent stattdessen auf einem Ersatzmodell, nach denselben [Ersetzungsregeln wie bei Subagenten](/docs/de/sub-agents#choose-a-model).

455 457 

456### Legen Sie eine Größenrichtlinie fest458### Eine Größenrichtlinie festlegen

457 459 

458Eine Größenrichtlinie teilt Claude mit, wie viele Agenten angestrebt werden sollen, wenn es einen dynamischen Workflow schreibt. Claude Code sendet die Richtlinie an Claude als Ratschlag, nicht als Obergrenze, sodass ein Prompt, der einen anderen Maßstab fordert, diese Richtlinie immer noch überschreibt.460Eine Größenrichtlinie teilt Claude mit, wie viele Agenten es anstreben soll, wenn es einen dynamischen Workflow schreibt. Claude Code übermittelt die Richtlinie an Claude als Empfehlung, nicht als Obergrenze, sodass ein Prompt, der eine andere Größenordnung verlangt, sie weiterhin überschreibt.

459 461 

460Jeder Wert entspricht einer Agentenzahl:462Jeder Wert entspricht einer Agentenanzahl:

461 463 

462| Wert | Agentenzahl, auf die Claude abzielt |464| Wert | Agentenanzahl, die Claude anstrebt |

463| :- | :- |465| :- | :- |

464| `unrestricted` | Keine Richtlinie: Claude dimensioniert den Workflow zur Aufgabe |466| `unrestricted` | Keine Richtlinie: Claude dimensioniert den Workflow passend zur Aufgabe |

465| `small` | Weniger als 5 Agenten |467| `small` | Weniger als 5 Agenten |

466| `medium` | Weniger als 10 Agenten |468| `medium` | Weniger als 10 Agenten |

467| `large` | Weniger als 50 Agenten |469| `large` | Weniger als 50 Agenten |

468 470 

469Der Standard ist `medium`, oder `small`, wenn Sie mit Claude Code v2.1.271 oder später bei einem Pro-Plan angemeldet sind. Bis Sie einen Wert wählen, zeigt die `/config`-Zeile den Wert als Standard an, und die Zeile `Running in background` des Workflows benennt die geltende Größe. Erfordert Claude Code v2.1.219 oder später; frühere Versionen standardmäßig auf `unrestricted`.471Der Standardwert ist `medium`, oder `small`, wenn Sie mit einem Pro-Plan und Claude Code v2.1.271 oder neuer angemeldet sind. Bis Sie einen Wert wählen, kennzeichnet die `/config`-Zeile den Wert als Standard, und die Zeile `Running in background` des Workflows nennt die geltende Größe. Erfordert Claude Code v2.1.219 oder neuer; frühere Versionen verwenden standardmäßig `unrestricted`.

470 472 

471Um die Richtlinie zu ändern, wählen Sie einen Wert für die Einstellung „Dynamic workflow size“ in `/config` oder führen Sie `/config workflowSizeGuideline=small` aus. Auf v2.1.219 und später können Sie auch den [`workflowSizeGuideline`-Schlüssel](/docs/de/settings-reference#workflowsizeguideline) in jeder Einstellungsdatei festlegen; dieser Wert hat Vorrang vor `/config`, und Claude Code verbirgt die `/config`-Zeile, während eine Einstellungsdatei einen bereitstellt.473Um die Richtlinie zu ändern, wählen Sie in `/config` einen Wert für die Einstellung Dynamic workflow size oder führen Sie `/config workflowSizeGuideline=small` aus. Ab v2.1.219 können Sie auch den [`workflowSizeGuideline`-Schlüssel](/docs/de/settings-reference#workflowsizeguideline) in einer beliebigen Einstellungsdatei festlegen; dieser Wert hat Vorrang vor `/config`, und Claude Code blendet die `/config`-Zeile aus, solange eine Einstellungsdatei einen Wert vorgibt.

472 474 

473Änderungen werden beim nächsten Prompt wirksam. Die [Laufzeit-Agent-Limits](#behavior-and-limits) gelten weiterhin unabhängig von der Einstellung.475Änderungen werden mit dem nächsten Prompt wirksam. Die [Agenten-Obergrenzen der Laufzeitumgebung](#behavior-and-limits) gelten unabhängig von der Einstellung weiterhin.

474 476 

475### Schalten Sie Workflows aus477### Workflows deaktivieren

476 478 

477Workflows sind in der CLI, der Desktop-App, den IDE-Erweiterungen, [nicht-interaktivem Modus](/docs/de/headless) mit `claude -p` und dem [Agent SDK](/docs/de/agent-sdk/overview) verfügbar. Die gleichen Deaktivierungseinstellungen gelten auf jeder Oberfläche.479Workflows sind in der CLI, der Desktop-App, den IDE-Erweiterungen, im [nicht interaktiven Modus](/docs/de/headless) mit `claude -p` und im [Agent SDK](/docs/de/agent-sdk/overview) verfügbar. Auf allen Oberflächen gelten dieselben Einstellungen zum Deaktivieren.

478 480 

479Um Workflows für sich selbst auszuschalten:481So deaktivieren Sie Workflows für sich selbst:

480 482 

481* Schalten Sie Dynamic workflows in `/config` aus. Bleibt über Sitzungen hinweg erhalten.483* Schalten Sie Dynamic workflows in `/config` aus. Bleibt sitzungsübergreifend erhalten.

482* Setzen Sie `"disableWorkflows": true` in `~/.claude/settings.json`. Bleibt über Sitzungen hinweg erhalten.484* Setzen Sie `"disableWorkflows": true` in `~/.claude/settings.json`. Bleibt sitzungsübergreifend erhalten.

483* Setzen Sie `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Wird beim Start gelesen, daher gilt es überall dort, wo Sie es setzen.485* Setzen Sie `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Wird beim Start gelesen und gilt daher überall dort, wo Sie es setzen.

484 486 

485Um Workflows für Ihre gesamte Organisation auszuschalten, setzen Sie `"disableWorkflows": true` in [verwalteten Einstellungen](/docs/de/server-managed-settings) oder verwenden Sie den Umschalter auf der Seite [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code).487Um Workflows für Ihre gesamte Organisation zu deaktivieren, setzen Sie `"disableWorkflows": true` in den [verwalteten Einstellungen](/docs/de/server-managed-settings) oder verwenden Sie den Schalter auf der Seite [Claude Code admin settings](https://claude.ai/admin-settings/claude-code).

486 488 

487Wenn Workflows deaktiviert sind:489Wenn Workflows deaktiviert sind:

488 490 

489* `/workflows`, die Workflow-Befehle und der `/workflow-authoring`-Skill sind nicht verfügbar491* `/workflows`, die Workflow-Befehle und der Skill `/workflow-authoring` sind nicht verfügbar

490* Das Schlüsselwort `ultracode` löst keine Ausführung mehr aus, und die **Ultracode**-Umschaltfläche wird aus `/effort` entfernt492* Das Schlüsselwort `ultracode` löst keinen Lauf mehr aus, und der Schalter **Ultracode** wird aus `/effort` entfernt

491 493 

492Eine Ausführung, die bereits in Bearbeitung ist, wird fortgesetzt.494Ein bereits laufender Lauf wird fortgesetzt.

493 495 

494Das Ausschalten von Workflows macht auch [ultracode](#let-claude-decide-with-ultracode) nicht verfügbar. Keine verwaltete Einstellung schließt ultracode allein aus: Überall dort, wo es [verfügbar](/docs/de/model-config#when-ultracode-is-available) ist, können Benutzer es mit `/effort ultracode` aktivieren. Eine [Effort-Obergrenze](/docs/de/model-config#organization-effort-limits) senkt die Effort-Stufe, auf der eine Sitzung mit aktiviertem ultracode läuft, schaltet aber ultracode nicht aus.496Das Deaktivieren von Workflows macht auch [ultracode](#let-claude-decide-with-ultracode) nicht verfügbar. Es gibt keine verwaltete Einstellung, die nur ultracode ausschließt: Überall, wo es [verfügbar](/docs/de/model-config#when-ultracode-is-available) ist, können Benutzer es mit `/effort ultracode` aktivieren. Eine [Effort-Obergrenze](/docs/de/model-config#organization-effort-limits) senkt die Effort-Stufe, mit der eine Sitzung mit aktiviertem ultracode läuft, deaktiviert ultracode jedoch nicht.

495 497 

496## Verwandte Ressourcen498## Verwandte Ressourcen

497 499 

worktrees.md +1 −0

Details

58 58 

59* **Der Worktree ist sauber**: Bei einer unbenannten Sitzung entfernt Claude den Worktree und seinen Branch automatisch. Eine [benannte](/docs/de/sessions#name-your-sessions) Sitzung fragt Sie zuerst, damit Sie den Worktree später behalten können59* **Der Worktree ist sauber**: Bei einer unbenannten Sitzung entfernt Claude den Worktree und seinen Branch automatisch. Eine [benannte](/docs/de/sessions#name-your-sessions) Sitzung fragt Sie zuerst, damit Sie den Worktree später behalten können

60* **Der Worktree enthält Arbeiten**: Claude fragt Sie, ob Sie den Worktree behalten oder entfernen möchten. Das Behalten bewahrt das Verzeichnis und den Branch. Um später zurückzukehren, führen Sie den Befehl `claude --worktree <name> --resume` aus, den Claude Code beim Beenden ausgibt. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch zusammen mit allen darin enthaltenen Arbeiten60* **Der Worktree enthält Arbeiten**: Claude fragt Sie, ob Sie den Worktree behalten oder entfernen möchten. Das Behalten bewahrt das Verzeichnis und den Branch. Um später zurückzukehren, führen Sie den Befehl `claude --worktree <name> --resume` aus, den Claude Code beim Beenden ausgibt. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch zusammen mit allen darin enthaltenen Arbeiten

61* **Ein anderer Branch ist ausgecheckt**: Wenn sich der Worktree auf einem anderen als seinem eigenen Branch befindet und dieser Branch Commits nach dem Start-Commit des Worktree enthält, fragt Claude Sie, ob Sie den Worktree behalten oder entfernen möchten. Bei beiden Antworten bleiben dieser andere Branch und seine Commits erhalten. Das Entfernen löscht das Worktree-Verzeichnis und den eigenen Branch des Worktree, also den, den Claude zusammen mit ihm erstellt hat

61* **Der Zustand des Worktree kann nicht überprüft werden**: Wenn Claude Code die Änderungen des Worktree nicht zählen kann oder seine Submodul-Checkouts nicht überprüfen kann, fragt es Sie, anstatt den Worktree automatisch zu entfernen. Die Eingabeaufforderung benennt, was nicht überprüft werden konnte62* **Der Zustand des Worktree kann nicht überprüft werden**: Wenn Claude Code die Änderungen des Worktree nicht zählen kann oder seine Submodul-Checkouts nicht überprüfen kann, fragt es Sie, anstatt den Worktree automatisch zu entfernen. Die Eingabeaufforderung benennt, was nicht überprüft werden konnte

62 63 

63Nicht-interaktive Ausführungen mit `-p` haben keine Exit-Eingabeaufforderung, daher bereinigt Claude ihre Worktrees nicht, und Claude Code behält die Sperre, die es bei der Erstellung auf jedem einzelnen genommen hat, bis eine spätere Sitzung's [stale-lock sweep](#clean-up-subagent-and-background-session-worktrees) sie freigegeben hat. Um einen zu entfernen, führen Sie `git worktree remove` aus; wenn git sich weigert, weil der Worktree gesperrt ist, führen Sie zuerst `git worktree unlock` darauf aus.64Nicht-interaktive Ausführungen mit `-p` haben keine Exit-Eingabeaufforderung, daher bereinigt Claude ihre Worktrees nicht, und Claude Code behält die Sperre, die es bei der Erstellung auf jedem einzelnen genommen hat, bis eine spätere Sitzung's [stale-lock sweep](#clean-up-subagent-and-background-session-worktrees) sie freigegeben hat. Um einen zu entfernen, führen Sie `git worktree remove` aus; wenn git sich weigert, weil der Worktree gesperrt ist, führen Sie zuerst `git worktree unlock` darauf aus.