SpyBara
Go Premium

Documentation 2026-10-18 22:59 UTC to 2026-10-19 23:58 UTC

62 files changed +1,007 −449. 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
Details

20* Für Sitzungen, die von einer Shell aus gestartet werden: Setzen Sie die Umgebungsvariable `CLAUDE_AX_SCREEN_READER` auf `1`. In Bash oder Zsh führen Sie `export CLAUDE_AX_SCREEN_READER=1` aus. In PowerShell führen Sie `$env:CLAUDE_AX_SCREEN_READER = "1"` aus. Fügen Sie diese Zeile zu Ihrem Shell-Profil hinzu, um sie für zukünftige Shells beizubehalten.20* Für Sitzungen, die von einer Shell aus gestartet werden: Setzen Sie die Umgebungsvariable `CLAUDE_AX_SCREEN_READER` auf `1`. In Bash oder Zsh führen Sie `export CLAUDE_AX_SCREEN_READER=1` aus. In PowerShell führen Sie `$env:CLAUDE_AX_SCREEN_READER = "1"` aus. Fügen Sie diese Zeile zu Ihrem Shell-Profil hinzu, um sie für zukünftige Shells beizubehalten.

21* Für jede Sitzung auf dem Computer: Fügen Sie `"axScreenReader": true` zu Ihrer Benutzer-[Einstellungsdatei](/docs/de/settings) hinzu. Die Einstellung gilt in jedem Terminal, einschließlich des integrierten VS Code-Terminals.21* Für jede Sitzung auf dem Computer: Fügen Sie `"axScreenReader": true` zu Ihrer Benutzer-[Einstellungsdatei](/docs/de/settings) hinzu. Die Einstellung gilt in jedem Terminal, einschließlich des integrierten VS Code-Terminals.

22 22 

23Wenn Sie Methoden kombinieren, wendet Claude Code das Flag [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) über die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars#variables) an, und die Variable über die Einstellung [`axScreenReader`](/docs/de/settings-reference#axscreenreader).23Wenn Sie Methoden kombinieren, gibt Claude Code dem Flag [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) Vorrang vor der Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars#variables), und der Variable Vorrang vor der Einstellung [`axScreenReader`](/docs/de/settings-reference#axscreenreader).

24 24 

25Wenn Sie Claude Code über SSH verwenden, legen Sie die Umgebungsvariable oder Einstellung auf dem Remote-Computer fest, auf dem Claude Code ausgeführt wird.25Wenn Sie Claude Code über SSH verwenden, legen Sie die Umgebungsvariable oder Einstellung auf dem Remote-Computer fest, auf dem Claude Code ausgeführt wird.

26 26 

Details

291| :- | :- | :- |291| :- | :- | :- |

292| **System-Prompt** | Jede Anfrage | Kleine feste Kosten, immer vorhanden |292| **System-Prompt** | Jede Anfrage | Kleine feste Kosten, immer vorhanden |

293| **CLAUDE.md-Dateien** | Sitzungsstart, über [`settingSources`](/docs/de/agent-sdk/claude-code-features) | Vollständiger Inhalt in jeder Anfrage (aber prompt-gecacht, daher zahlt nur die erste Anfrage die vollständigen Kosten) |293| **CLAUDE.md-Dateien** | Sitzungsstart, über [`settingSources`](/docs/de/agent-sdk/claude-code-features) | Vollständiger Inhalt in jeder Anfrage (aber prompt-gecacht, daher zahlt nur die erste Anfrage die vollständigen Kosten) |

294| **Werkzeugdefinitionen** | Jede Anfrage; MCP-Schemas standardmäßig aufgeschoben | Integrierte Werkzeugschemas werden bei jeder Anfrage geladen. [Werkzeugsuche](/docs/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und fällt auf vorherige Laden auf nicht unterstützten Modellen und bestimmten Plattformen zurück. Siehe [Werkzeugsuche konfigurieren](/docs/de/agent-sdk/tool-search#configure-tool-search) für die vollständige Matrix |294| **Tool-Definitionen** | Jede Anfrage für zentrale integrierte Tools wie Bash, Read und Edit; bei Bedarf für MCP-Tools und andere integrierte Tools, die die [Tool-Suche](/docs/de/agent-sdk/mcp#mcp-tool-search) standardmäßig aufschiebt | Jedes Schema wird in den unter [Tool-Suche konfigurieren](/docs/de/agent-sdk/tool-search#configure-tool-search) beschriebenen Fällen vorab geladen |

295| **Gesprächsverlauf** | Sammelt sich über Runden an | Wächst mit jeder Runde: Prompts, Antworten, Werkzeugeingaben, Werkzeugergebnisse |295| **Gesprächsverlauf** | Sammelt sich über Runden an | Wächst mit jeder Runde: Prompts, Antworten, Werkzeugeingaben, Werkzeugergebnisse |

296| **Fähigkeitsbeschreibungen** | Sitzungsstart, über Einstellungsquellen | Kurze Zusammenfassungen; vollständiger Inhalt lädt nur bei Aufruf |296| **Fähigkeitsbeschreibungen** | Sitzungsstart, über Einstellungsquellen | Kurze Zusammenfassungen; vollständiger Inhalt lädt nur bei Aufruf |

297 297 


331 331 

332Ein paar Strategien für langfristig laufende Agenten:332Ein paar Strategien für langfristig laufende Agenten:

333 333 

334* **Verwenden Sie Subagenten für Teilaufgaben.** Jeder Subagent startet mit einer neuen Konversation (kein vorheriger Nachrichtenverlauf, er lädt jedoch seinen eigenen System-Prompt und Kontext auf Projektebene wie CLAUDE.md). Er sieht die Turns des übergeordneten Agenten nicht, und nur seine abschließende Antwort wird an den übergeordneten Agenten zurückgegeben. Der Kontext des Hauptagenten wächst um diese Zusammenfassung, nicht um das vollständige Transkript der Teilaufgabe. Siehe [Was Subagenten erben](/docs/de/agent-sdk/subagents#what-subagents-inherit) für Details.334* **Verwenden Sie Subagenten für Teilaufgaben.** Ein Subagent gibt nur seine abschließende Antwort zurück, sodass der Kontext Ihres Hauptagenten um eine Zusammenfassung wächst, nicht um das Transkript der Teilaufgabe.

335* **Seien Sie selektiv mit Werkzeugen.** Jede Werkzeugdefinition nimmt Kontextraum ein. Verwenden Sie das Feld `tools` auf [`AgentDefinition`](/docs/de/agent-sdk/subagents#agentdefinition-configuration), um Subagenten auf die minimale Menge zu beschränken, die sie benötigen.335* **Seien Sie selektiv mit Werkzeugen.** Jede Werkzeugdefinition nimmt Kontextraum ein. Verwenden Sie das Feld `tools` auf [`AgentDefinition`](/docs/de/agent-sdk/subagents#agentdefinition-configuration), um Subagenten auf die minimale Menge zu beschränken, die sie benötigen.

336* **Beobachten Sie MCP-Server-Kosten.** [MCP tool search](/docs/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und lädt sie bei Bedarf. Wenn die Werkzeugsuche ausgeschaltet ist oder auf vorherige Laden auf nicht unterstützten Modellen und bestimmten Plattformen zurückgefallen ist, fügt jeder MCP-Server alle seine Werkzeugschemas zu jeder Anfrage hinzu, daher können ein paar Server mit vielen Werkzeugen erheblichen Kontext verbrauchen, bevor der Agent irgendwelche Arbeiten verrichtet. Siehe [Configure tool search](/docs/de/agent-sdk/tool-search#configure-tool-search) für die Konfigurationen, bei denen das Fallback angewendet wird.336* **Beobachten Sie MCP-Server-Kosten.** [MCP tool search](/docs/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und lädt sie bei Bedarf. Wenn die Werkzeugsuche ausgeschaltet ist oder auf vorherige Laden auf nicht unterstützten Modellen und bestimmten Plattformen zurückgefallen ist, fügt jeder MCP-Server alle seine Werkzeugschemas zu jeder Anfrage hinzu, daher können ein paar Server mit vielen Werkzeugen erheblichen Kontext verbrauchen, bevor der Agent irgendwelche Arbeiten verrichtet. Siehe [Configure tool search](/docs/de/agent-sdk/tool-search#configure-tool-search) für die Konfigurationen, bei denen das Fallback angewendet wird.

337* **Verwenden Sie niedrigere Anstrengung für Routine-Aufgaben.** Setzen Sie [Anstrengung](#effort-level) auf `"low"` für Agenten, die nur Dateien lesen oder Verzeichnisse auflisten müssen. Dies reduziert Token-Nutzung und Kosten.337* **Verwenden Sie niedrigere Anstrengung für Routine-Aufgaben.** Setzen Sie [Anstrengung](#effort-level) auf `"low"` für Agenten, die nur Dateien lesen oder Verzeichnisse auflisten müssen. Dies reduziert Token-Nutzung und Kosten.

Details

123 123 

124Berechtigungsmodi bieten globale Kontrolle darüber, wie Claude Tools nutzt. Sie können den Berechtigungsmodus beim Aufrufen von `query()` festlegen oder ihn während Streaming-Sitzungen dynamisch ändern.124Berechtigungsmodi bieten globale Kontrolle darüber, wie Claude Tools nutzt. Sie können den Berechtigungsmodus beim Aufrufen von `query()` festlegen oder ihn während Streaming-Sitzungen dynamisch ändern.

125 125 

126Wenn Sie keinen festlegen, wählt Claude Code den Startberechtigungsmodus nach den Regeln in [Welcher Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in):126Ab Claude Code v2.1.302 startet Ihre App im `default`-Modus, sofern Sie keinen Berechtigungsmodus festlegen und sie keinen aus [`permissions.defaultMode`](/docs/de/settings-reference#permissions-defaultmode) in ihren Einstellungsdateien erhält. Im `default`-Modus lehnt Claude Code jeden Tool-Aufruf ab, der eine Genehmigung benötigt, es sei denn, Sie genehmigen ihn über eine Allow-Regel, einen Hook, einen `canUseTool`-Callback oder ein Berechtigungsabfrage-Tool. Wenn Tool-Aufrufe abgelehnt werden, siehe [Tool-Aufrufe in `claude -p`- und Agent SDK-Ausführungen abgelehnt](/docs/de/permission-modes#which-mode-a-non-interactive-run-starts-in).

127 

128* Ein `permissions.defaultMode` aus den [Einstellungsdateien](/docs/de/settings#where-settings-live) der Sitzung, wenn einer zutrifft

129* Andernfalls der integrierte Standard, der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) sein kann

130 

131Eine Sitzung, die im Auto-Modus startet, verwirft breite Allow-Regeln wie einen bloßen `Bash`-Eintrag, wie [Wie Auto-Modus Aktionen bewertet](/docs/de/permission-modes#how-auto-mode-evaluates-actions) beschreibt. Wenn Ihre Anwendung auf den `default`-Modus oder auf eine solche Regel angewiesen ist, übergeben Sie `default` explizit.

132 

133Vor TypeScript Agent SDK v0.3.286 war das Weglassen von `permissionMode` dasselbe wie das Übergeben von `default`.

134 127 

135<h3 id="available-modes">128<h3 id="available-modes">

136 Verfügbare Modi129 Verfügbare Modi

Details

1035)1035)

1036```1036```

1037 1037 

1038* `API_TIMEOUT_MS`: Timeout pro Anfrage auf dem Anthropic-Client in Millisekunden. Standard `600000`. Gilt für die Hauptschleife und alle Subagenten.1038* [`API_TIMEOUT_MS`](/docs/de/env-vars): wie lange jeder Anfrageversuch auf Response-Header warten kann, in Millisekunden. Die Variable begrenzt nicht, wie lange eine Streaming-Antwort läuft, nachdem die Header angekommen sind. Standard `600000`. Gilt für die Hauptschleife und alle Subagenten.

1039* `CLAUDE_CODE_MAX_RETRIES`: Maximale Anzahl von API-Wiederholungsversuchen. Standard `10`, begrenzt auf `15`. Jeder Wiederholungsversuch erhält sein eigenes `API_TIMEOUT_MS`-Fenster.1039* `CLAUDE_CODE_MAX_RETRIES`: Maximale Anzahl von API-Wiederholungsversuchen. Standard `10`, begrenzt auf `15`. Jeder Wiederholungsversuch erhält sein eigenes `API_TIMEOUT_MS`-Fenster.

1040 1040 

1041 Für unbeaufsichtigte Läufe, die längere Ausfälle abwarten müssen, setzen Sie [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/de/errors#tune-retry-behavior): Damit werden vorübergehende Kapazitätsfehler unbegrenzt erneut versucht, und ab Claude Code v2.1.199 wird der Standard für andere vorübergehende Fehler auf `300` erhöht und die Obergrenze für diese Variable entfernt.1041 Für unbeaufsichtigte Läufe, die längere Ausfälle abwarten müssen, setzen Sie [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/de/errors#tune-retry-behavior): Damit werden vorübergehende Kapazitätsfehler unbegrenzt erneut versucht, und ab Claude Code v2.1.199 wird der Standard für andere vorübergehende Fehler auf `300` erhöht und die Obergrenze für diese Variable entfernt.

Details

172 172 

173Im Python SDK behalten mehrteilige Feldnamen wie `disallowedTools` und `mcpServers` ihre camelCase-Schreibweise, um dem Wire-Format zu entsprechen, anstatt Pythons snake\_case-Konvention zu folgen. Siehe die [`AgentDefinition`-Referenz](/docs/de/agent-sdk/python#agentdefinition) für Details.173Im Python SDK behalten mehrteilige Feldnamen wie `disallowedTools` und `mcpServers` ihre camelCase-Schreibweise, um dem Wire-Format zu entsprechen, anstatt Pythons snake\_case-Konvention zu folgen. Siehe die [`AgentDefinition`-Referenz](/docs/de/agent-sdk/python#agentdefinition) für Details.

174 174 

175Subagenten laufen standardmäßig im Hintergrund. Ein Agent-Tool-Aufruf, der die [`run_in_background`](/docs/de/sub-agents#run-subagents-in-foreground-or-background)-Eingabe weglässt, startet einen Hintergrund-Subagenten, und Claude setzt `run_in_background: false`, wenn es das Ergebnis benötigt, bevor es fortfährt. Setzen Sie das Feld `background` auf `true`, um die Hintergrund-Ausführung für einen bestimmten Agent zu erzwingen, unabhängig davon, was Claude anfordert. Vor Claude Code v2.1.198 wurde der Hintergrund-Standard schrittweise eingeführt, und ein Agent-Tool-Aufruf, der `run_in_background` wegließ, konnte den Subagenten synchron ausführen.175<h4 id="choose-whether-claude-waits-for-subagents">

176 Festlegen, ob Claude auf Subagenten wartet

177</h4>

176 178 

177Subagenten können auch ihre eigenen Subagenten spawnen. Um zu begrenzen, wie tief diese Verschachtelung geht, wie viele Subagenten gleichzeitig laufen und wie viel eine Abfrage ausgibt, siehe [Subagenten-Tiefe, Parallelität und Ausgaben begrenzen](#cap-subagent-depth-concurrency-and-spend).179Standardmäßig [läuft ein Subagent, den Ihr Hauptagent startet, im Hintergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background). Das Ergebnis des Agent-Tools hat `status: "async_launched"`, und der Bericht kommt in einem späteren Turn an.

180 

181Claude wartet, wenn seine nächste Aktion den Bericht benötigt: Der Aufruf blockiert und gibt `status: "completed"` zurück. So treffen Sie diese Wahl selbst:

182 

183* **In Ihrem Prompt**: Bitten Sie Claude zu warten, etwa mit „Führe den test-runner-Agenten aus und warte auf ihn“

184* **In der Definition**: Setzen Sie `background` auf `true`, um diesen Agenten im Hintergrund zu halten

178 185 

179<h3 id="filesystem-based-definition-alternative">186<h3 id="filesystem-based-definition-alternative">

180 Dateisystem-basierte Definition (Alternative)187 Dateisystem-basierte Definition (Alternative)


242 249 

243Dies umgeht das automatische Matching und ruft den benannten Subagenten direkt auf.250Dies umgeht das automatische Matching und ruft den benannten Subagenten direkt auf.

244 251 

252<h3 id="forked-subagents">

253 Geforkte Subagenten

254</h3>

255 

256Ein [Fork](/docs/de/sub-agents#fork-the-current-conversation) ist ein Subagent, der die bisherige Konversation kopiert, anstatt neu zu beginnen. Ab Claude Code v2.1.302 kann Claude in Ihrer Anwendung ohne jegliche Konfiguration Forks starten, indem es das Agent-Tool mit `subagent_type: "fork"` aufruft.

257 

258Um zu verhindern, dass Claude Forks startet, fügen Sie eine [`Agent(fork)`-Deny-Regel](/docs/de/agent-sdk/permissions#allow-and-deny-rules) hinzu:

259 

260<CodeGroup>

261 ```python Python theme={null}

262 options = ClaudeAgentOptions(

263 # Deny only the fork subagent type; other subagents still run

264 disallowed_tools=["Agent(fork)"],

265 )

266 ```

267 

268 ```typescript TypeScript theme={null}

269 const options = {

270 // Deny only the fork subagent type; other subagents still run

271 disallowedTools: ["Agent(fork)"]

272 };

273 ```

274</CodeGroup>

275 

245<h3 id="dynamic-agent-configuration">276<h3 id="dynamic-agent-configuration">

246 Dynamische Agent-Konfiguration277 Dynamische Agent-Konfiguration

247</h3>278</h3>

Details

610| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Ausgabeformat für Agentenergebnisse definieren. Details finden Sie unter [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs) |610| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Ausgabeformat für Agentenergebnisse definieren. Details finden Sie unter [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs) |

611| `outputStyle` | `string` | `undefined` | Kein `Options`-Feld. Setzen Sie `outputStyle` stattdessen im Inline-Objekt [`settings`](/docs/de/settings) oder in einer Einstellungsdatei. Siehe [Ausgabestil aktivieren](/docs/de/agent-sdk/modifying-system-prompts#activate-an-output-style) |611| `outputStyle` | `string` | `undefined` | Kein `Options`-Feld. Setzen Sie `outputStyle` stattdessen im Inline-Objekt [`settings`](/docs/de/settings) oder in einer Einstellungsdatei. Siehe [Ausgabestil aktivieren](/docs/de/agent-sdk/modifying-system-prompts#activate-an-output-style) |

612| `pathToClaudeCodeExecutable` | `string` | Automatisch aus der mitgelieferten nativen Binärdatei ermittelt | Pfad zur ausführbaren Datei von Claude Code. Nur erforderlich, wenn optionale Abhängigkeiten bei der Installation übersprungen wurden oder Ihre Plattform nicht zu den unterstützten gehört |612| `pathToClaudeCodeExecutable` | `string` | Automatisch aus der mitgelieferten nativen Binärdatei ermittelt | Pfad zur ausführbaren Datei von Claude Code. Nur erforderlich, wenn optionale Abhängigkeiten bei der Installation übersprungen wurden oder Ihre Plattform nicht zu den unterstützten gehört |

613| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | Berechtigungsmodus für die Sitzung. Wenn Sie ihn weglassen, kann die Sitzung im Auto-Modus starten. Unter [Berechtigungsmodi](/docs/de/agent-sdk/permissions#permission-modes) erfahren Sie, wie Claude Code den anfänglichen Berechtigungsmodus wählt |613| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | Berechtigungsmodus für die Sitzung. Wenn Sie ihn weglassen und nichts anderes einen Berechtigungsmodus setzt, etwa eine Einstellung [`permissions.defaultMode`](/docs/de/settings-reference#permissions-defaultmode), startet die Sitzung in `default`. Siehe [Berechtigungsmodi](/docs/de/agent-sdk/permissions#permission-modes) |

614| `permissionPromptToolName` | `string` | `undefined` | Name des MCP-Tools für Berechtigungsabfragen |614| `permissionPromptToolName` | `string` | `undefined` | Name des MCP-Tools für Berechtigungsabfragen |

615| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Wer Berechtigungsabfragen beantwortet: `'host'` leitet sie an Ihren [`canUseTool`](#canusetool)-Callback oder das Tool `permissionPromptToolName` weiter, und `'none'` [lehnt die Aufrufe ab, die eine Abfrage ausgelöst hätten](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated). Erfordert Claude Code v2.1.259 oder höher |615| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Wer Berechtigungsabfragen beantwortet: `'host'` leitet sie an Ihren [`canUseTool`](#canusetool)-Callback oder das Tool `permissionPromptToolName` weiter, und `'none'` [lehnt die Aufrufe ab, die eine Abfrage ausgelöst hätten](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated). Erfordert Claude Code v2.1.259 oder höher |

616| `persistSession` | `boolean` | `true` | Bei `false` wird das Speichern der Sitzung auf der Festplatte deaktiviert. Sitzungen können später nicht fortgesetzt werden |616| `persistSession` | `boolean` | `true` | Bei `false` wird das Speichern der Sitzung auf der Festplatte deaktiviert. Sitzungen können später nicht fortgesetzt werden |


662});662});

663```663```

664 664 

665* `API_TIMEOUT_MS`: Timeout pro Anfrage im Anthropic-Client, in Millisekunden. Standard `600000`. Gilt für die Hauptschleife und alle Subagenten.665* [`API_TIMEOUT_MS`](/docs/de/env-vars): wie lange jeder Anfrageversuch in Millisekunden auf die Response-Header warten kann. Dies begrenzt nicht, wie lange eine Streaming-Antwort nach Eintreffen der Header läuft. Standard `600000`. Gilt für die Hauptschleife und alle Subagenten.

666* `CLAUDE_CODE_MAX_RETRIES`: maximale Anzahl an API-Wiederholungsversuchen. Standard `10`, begrenzt auf `15`. Jeder Wiederholungsversuch erhält ein eigenes `API_TIMEOUT_MS`-Zeitfenster.666* `CLAUDE_CODE_MAX_RETRIES`: maximale Anzahl an API-Wiederholungsversuchen. Standard `10`, begrenzt auf `15`. Jeder Wiederholungsversuch erhält ein eigenes `API_TIMEOUT_MS`-Zeitfenster.

667 667 

668 Für unbeaufsichtigte Läufe, die längere Ausfälle überstehen müssen, setzen Sie [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/de/errors#tune-retry-behavior): Damit werden vorübergehende Kapazitätsfehler unbegrenzt erneut versucht, und ab Claude Code v2.1.199 wird der Standardwert für andere vorübergehende Fehler auf `300` angehoben und die Obergrenze dieser Variable aufgehoben.668 Für unbeaufsichtigte Läufe, die längere Ausfälle überstehen müssen, setzen Sie [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/de/errors#tune-retry-behavior): Damit werden vorübergehende Kapazitätsfehler unbegrenzt erneut versucht, und ab Claude Code v2.1.199 wird der Standardwert für andere vorübergehende Fehler auf `300` angehoben und die Obergrenze dieser Variable aufgehoben.

agent-teams.md +1 −1

Details

557* **Abschaltung kann langsam sein**: Teammates beenden ihre aktuelle Anfrage oder ihren Werkzeugaufruf, bevor sie herunterfahren, was Zeit in Anspruch nehmen kann.557* **Abschaltung kann langsam sein**: Teammates beenden ihre aktuelle Anfrage oder ihren Werkzeugaufruf, bevor sie herunterfahren, was Zeit in Anspruch nehmen kann.

558* **Ein Team pro Sitzung**: eine Sitzung hat genau ein Team, das auf diese Sitzung beschränkt ist. Sie können keine zusätzlichen benannten Teams erstellen oder ein Team über Sitzungen hinweg freigeben.558* **Ein Team pro Sitzung**: eine Sitzung hat genau ein Team, das auf diese Sitzung beschränkt ist. Sie können keine zusätzlichen benannten Teams erstellen oder ein Team über Sitzungen hinweg freigeben.

559* **Keine verschachtelten Teams**: Teammates können ihre eigenen Teammates nicht erzeugen. Nur der Lead kann das Team verwalten.559* **Keine verschachtelten Teams**: Teammates können ihre eigenen Teammates nicht erzeugen. Nur der Lead kann das Team verwalten.

560* **Keine Hintergrund-Subagenten von In-Process-Teammates**: die eigenen Subagenten eines In-Process-Teammates laufen im Vordergrund, da die Hintergrundarbeit eines Teammates nicht länger als der Prozess des Leads bestehen kann. Claude Code gibt einen Fehler zurück, wenn ein Teammate einen Subagenten erzeugt, dessen Definition `background: true` setzt. Eine `run_in_background: true`-Anfrage eines Teammates schlägt ebenfalls fehl, entweder mit einem Fehler oder durch stilles Ausführen im Vordergrund, wie in [wie Claude Code Vordergrund oder Hintergrund auswählt](/docs/de/sub-agents#run-subagents-in-foreground-or-background) beschrieben. Subagenten, die aus der Hauptkonversation gestartet werden, folgen dem [Hintergrund-Standard](/docs/de/sub-agents#run-subagents-in-foreground-or-background).560* **Keine Hintergrund-Subagenten von In-Process-Teammates**: die eigenen Subagenten eines In-Process-Teammates laufen im Vordergrund, da die Hintergrundarbeit eines Teammates nicht länger als der Prozess des Leads bestehen kann. Claude Code gibt einen Fehler zurück, wenn ein Teammate einen Subagenten erzeugt, dessen Definition `background: true` setzt. Eine `run_in_background: true`-Anfrage eines Teammates schlägt ebenfalls fehl, entweder mit einem Fehler oder durch stilles Ausführen im Vordergrund. Subagenten, die aus der Hauptkonversation gestartet werden, folgen dem [Hintergrund-Standard](/docs/de/sub-agents#run-subagents-in-foreground-or-background).

561* **Lead ist fest**: die Hauptsitzung ist der Lead für seine Lebensdauer. Sie können einen Teammate nicht zum Lead befördern oder die Führung übertragen.561* **Lead ist fest**: die Hauptsitzung ist der Lead für seine Lebensdauer. Sie können einen Teammate nicht zum Lead befördern oder die Führung übertragen.

562* **Berechtigungen beim Erzeugen gesetzt**: Teammates starten mit dem Berechtigungsmodus, der unter [Berechtigungen](#permissions) beschrieben ist. Sie können den Berechtigungsmodus eines einzelnen Teammates nach dem Erzeugen ändern, aber Sie können keine Pro-Teammate-Berechtigungsmodi zum Zeitpunkt des Erzeugung setzen.562* **Berechtigungen beim Erzeugen gesetzt**: Teammates starten mit dem Berechtigungsmodus, der unter [Berechtigungen](#permissions) beschrieben ist. Sie können den Berechtigungsmodus eines einzelnen Teammates nach dem Erzeugen ändern, aber Sie können keine Pro-Teammate-Berechtigungsmodi zum Zeitpunkt des Erzeugung setzen.

563* **Split Panes erfordern tmux oder iTerm2**: der Standard-In-Process-Modus funktioniert in jedem Terminal. Der Split-Pane-Modus wird in VS Code's integriertem Terminal, Windows Terminal oder Ghostty nicht unterstützt.563* **Split Panes erfordern tmux oder iTerm2**: der Standard-In-Process-Modus funktioniert in jedem Terminal. Der Split-Pane-Modus wird in VS Code's integriertem Terminal, Windows Terminal oder Ghostty nicht unterstützt.

agent-view.md +11 −3

Details

467 467 

468Führen Sie `/background` oder seinen Alias `/bg` aus, um die aktuelle Konversation in eine Hintergrund-Sitzung zu verschieben. Übergeben Sie einen Prompt wie `/bg run the test suite and fix any failures`, um zuvor noch eine weitere Anweisung zu geben. Wenn Claude gerade antwortet, während Sie `/bg` ausführen, wird die Antwort in der Hintergrund-Sitzung fortgesetzt.468Führen Sie `/background` oder seinen Alias `/bg` aus, um die aktuelle Konversation in eine Hintergrund-Sitzung zu verschieben. Übergeben Sie einen Prompt wie `/bg run the test suite and fix any failures`, um zuvor noch eine weitere Anweisung zu geben. Wenn Claude gerade antwortet, während Sie `/bg` ausführen, wird die Antwort in der Hintergrund-Sitzung fortgesetzt.

469 469 

470Das Beenden einer Sitzung, in der noch Hintergrund-Arbeit läuft, etwa Subagenten, Hintergrund-Shell-Befehle, Workflows oder [Monitore](/docs/de/tools-reference#monitor-tool), zeigt einen Dialog `Background work is running` an, anstatt sofort zu beenden. Wählen Sie `Move to background and exit`, um die Sitzung auf die gleiche Weise wie mit `/background` in den Hintergrund zu verschieben und zu Ihrer Shell zurückzukehren. Die Option wird nicht angezeigt, wenn die Agenten-Ansicht [ausgeschaltet](#turn-off-agent-view) ist.470Das Beenden einer Sitzung, in der noch Hintergrundarbeit läuft, etwa Subagenten, Hintergrund-Shell-Befehle, Workflows oder [Monitore](/docs/de/tools-reference#monitor-tool), zeigt einen Dialog `Background work is running` an, anstatt sofort zu beenden. Wählen Sie `Move to background and exit`, um die Sitzung auf die gleiche Weise wie mit `/background` in den Hintergrund zu verschieben und zu Ihrer Shell zurückzukehren. Die Option wird nicht angezeigt, wenn die Agenten-Ansicht [ausgeschaltet](#turn-off-agent-view) ist.

471 471 

472Wenn eine Hintergrund-Sitzung in der Liste bereits den Namen der Konversation trägt, nummeriert Claude Code den Namen der neuen Zeile, z. B. `my-session (2)`, und lässt den Namen der vorhandenen Zeile unverändert. Um die neue Zeile umzubenennen, wählen Sie sie in der Agenten-Ansicht aus und drücken Sie `Ctrl+R`.472Wenn eine Hintergrund-Sitzung in der Liste bereits den Namen der Konversation trägt, nummeriert Claude Code den Namen der neuen Zeile, z. B. `my-session (2)`, und lässt den Namen der vorhandenen Zeile unverändert. Um die neue Zeile umzubenennen, wählen Sie sie in der Agenten-Ansicht aus und drücken Sie `Ctrl+R`.

473 473 


479 479 

480Nach dem Fork sind die beiden Konversationen unabhängig: Nichts, was die Kopie tut, gelangt von selbst in die ursprüngliche Konversation, wobei in Sitzungen, in denen [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) aktiviert ist, der Claude jeder Sitzung der anderen explizit Nachrichten senden kann.480Nach dem Fork sind die beiden Konversationen unabhängig: Nichts, was die Kopie tut, gelangt von selbst in die ursprüngliche Konversation, wobei in Sitzungen, in denen [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) aktiviert ist, der Claude jeder Sitzung der anderen explizit Nachrichten senden kann.

481 481 

482Das Kopieren der Sitzung erfordert Claude Code v2.1.212 oder später; in v2.1.161 bis v2.1.211 startet `/fork` stattdessen einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation), was jetzt `/subtask` ist. Wenn die [Agenten-Ansicht ausgeschaltet](#turn-off-agent-view) ist, behält `/fork` das Verhalten des geforkten Subagenten bei und `/subtask` ist nicht verfügbar.482Wenn die [Agenten-Ansicht ausgeschaltet](#turn-off-agent-view) ist, startet `/fork` einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation), anstatt die Sitzung zu kopieren.

483 483 

484Übergeben Sie einen Prompt wie `/fork open a draft pull request with the work so far`, und die Kopie beginnt sofort mit der Arbeit daran. Ohne Prompt wartet die Kopie auf ihre erste Anweisung: Wählen Sie ihre Zeile in `claude agents` aus und drücken Sie `Space`, um eine zu senden, oder führen Sie `claude attach <id>` aus. Die ausgewählte Zeile zeigt `space to send it a prompt` an, während sie wartet.484Übergeben Sie einen Prompt wie `/fork open a draft pull request with the work so far`, und die Kopie beginnt sofort mit der Arbeit daran. Ohne Prompt wartet die Kopie auf ihre erste Anweisung: Wählen Sie ihre Zeile in `claude agents` aus und drücken Sie `Space`, um eine zu senden, oder führen Sie `claude attach <id>` aus. Die ausgewählte Zeile zeigt `space to send it a prompt` an, während sie wartet.

485 485 


955* **Ein Workflow mit laufenden Subagenten**: Ein [dynamischer Workflow](/docs/de/workflows) hat noch laufende Subagenten. Der Workflow selbst wird übertragen, aber seine laufenden Subagenten starten von vorne neu, und der Dialog sagt, wie viele.955* **Ein Workflow mit laufenden Subagenten**: Ein [dynamischer Workflow](/docs/de/workflows) hat noch laufende Subagenten. Der Workflow selbst wird übertragen, aber seine laufenden Subagenten starten von vorne neu, und der Dialog sagt, wie viele.

956* **Automatische Artefakt-Antworten**: Claude [antwortet auf Kommentare zu einem Artefakt von selbst](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own). Diese Antworten werden in der Hintergrund-Sitzung fortgesetzt, und der Dialog sagt dies.956* **Automatische Artefakt-Antworten**: Claude [antwortet auf Kommentare zu einem Artefakt von selbst](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own). Diese Antworten werden in der Hintergrund-Sitzung fortgesetzt, und der Dialog sagt dies.

957 957 

958Führen Sie `/tasks` aus, um zu sehen, was läuft, dann bestätigen Sie, um trotzdem in den Hintergrund zu gehen, oder wählen Sie `Stay`, um die Arbeit zuerst fertig zu stellen. Siehe [Was wird übertragen, wenn Sie backgrounden](#what-carries-over-when-you-background), um zu sehen, welche Arten von Arbeit übertragen werden und welche Claude Code stoppt.958Führen Sie `/tasks` aus, um alles zu sehen, was läuft, dann bestätigen Sie, um trotzdem in den Hintergrund zu gehen, oder wählen Sie `Stay`, um die Arbeit zuerst fertig laufen zu lassen. Siehe [Was beim Verschieben in den Hintergrund übernommen wird](#what-carries-over-when-you-background), um zu sehen, welche Arten von Arbeit übertragen werden und welche Claude Code stoppt.

959 

960<h3 id="carried-into-this-session-and-not-resumed">

961 Die Konversation meldet, dass ein Hintergrund-Agent `was carried into this session and not resumed`

962</h3>

963 

964Dieser Hinweis benennt einen [Subagenten](/docs/de/sub-agents) im Hintergrund, der in dieser Sitzung nicht läuft.

965 

966Claude sieht den Hinweis und antwortet von selbst, sodass Sie Claude nicht dazu auffordern müssen. Wenn Sie die Arbeit dieses Subagenten nach dem Lesen von Claudes Antwort weiterhin benötigen, bitten Sie Claude darum.

959 967 

960<h3 id="prompt-rejected-as-too-short">968<h3 id="prompt-rejected-as-too-short">

961 Prompt als zu kurz abgelehnt969 Prompt als zu kurz abgelehnt

Details

182export AWS_PROFILE=your-profile-name182export AWS_PROFILE=your-profile-name

183```183```

184 184 

185Claude Code fordert Rollenzugriffsdaten aus der IAM Identity Center-Region an, die vom `sso_region` des Profils benannt wird, was nicht mit der Region übereinstimmen muss, in der Sie Amazon Bedrock ausführen. In v2.1.207 hat die Amazon Bedrock-Region `sso_region` überschrieben, sodass ein Profil, dessen IAM Identity Center-Instanz sich in einer anderen Region befindet, die Authentifizierung mit einem `Session token not found or invalid`-Fehler nicht durchführen konnte.185Claude Code fordert Rollenzugriffsdaten aus der IAM Identity Center-Region an, die vom `sso_region` des Profils benannt wird, was nicht mit der Region übereinstimmen muss, in der Sie Amazon Bedrock ausführen.

186 186 

187<h4 id="use-aws-management-console-credentials">187<h4 id="use-aws-management-console-credentials">

188 AWS Management Console-Anmeldedaten verwenden188 AWS Management Console-Anmeldedaten verwenden


411 411 

412Wenn Claude Code mit Amazon Bedrock konfiguriert startet, überprüft es, ob die Modelle, die es verwenden möchte, in Ihrem Konto verfügbar sind.412Wenn Claude Code mit Amazon Bedrock konfiguriert startet, überprüft es, ob die Modelle, die es verwenden möchte, in Ihrem Konto verfügbar sind.

413 413 

414Wenn Sie eine ältere Modellversion angeheftet haben als die aktuelle Claude Code-Standardversion, und Ihr Konto die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Anheftung zu aktualisieren. Wenn Sie akzeptieren, wird die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/docs/de/settings) geschrieben und Claude Code wird neu gestartet. Wenn Sie ablehnen, wird dies bis zur nächsten Standardversionänderung beibehalten. Anheftungen, die auf ein [Anwendungs-Inferenzprofil-ARN](#map-each-model-version-to-an-inference-profile) verweisen, werden übersprungen, da diese von Ihrem Administrator verwaltet werden.414Wenn Sie eine ältere Modellversion angeheftet haben als die aktuelle Claude Code-Standardversion, und Ihr Konto die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Anheftung zu aktualisieren. Wenn Sie akzeptieren, wird die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/docs/de/settings) geschrieben und Claude Code wird neu gestartet. Wenn Sie ablehnen, wird dies bis zur nächsten Änderung der Standardversion beibehalten. Anheftungen, die auf ein [Anwendungs-Inferenzprofil-ARN](#map-each-model-version-to-an-inference-profile) verweisen, werden übersprungen, da diese von Ihrem Administrator verwaltet werden.

415 415 

416Wenn Sie kein Modell angeheftet haben und der aktuelle Standard in Ihrem Konto nicht verfügbar ist, greift Claude Code für die aktuelle Sitzung zurück und zeigt einen Hinweis an. Es versucht zuerst frühere Versionen des Standardmodells und greift, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist, auf das Standard-Sonnet-Modell zurück. Der Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell in Ihrem Amazon Bedrock-Konto oder [heften Sie eine Version an](#4-pin-model-versions), um die Auswahl dauerhaft zu machen.416Wenn Sie kein Modell angeheftet haben und der aktuelle Standard in Ihrem Konto nicht verfügbar ist, greift Claude Code für die aktuelle Sitzung zurück und zeigt einen Hinweis an. Es versucht zuerst frühere Versionen des Standardmodells und greift, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist, auf das Standard-Sonnet-Modell zurück. Der Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell in Ihrem Amazon Bedrock-Konto oder [heften Sie eine Version an](#4-pin-model-versions), um die Auswahl dauerhaft zu machen.

417 417 


419 419 

420Modellaliase wie `opus` fungieren nicht als Anheftungen, und auch nicht eine Modell-ID, die Claude Code nicht erkennt, wie beispielsweise ein Anwendungs-Inferenzprofil-ARN.420Modellaliase wie `opus` fungieren nicht als Anheftungen, und auch nicht eine Modell-ID, die Claude Code nicht erkennt, wie beispielsweise ein Anwendungs-Inferenzprofil-ARN.

421 421 

422Wenn diese Prüfungen ein Modell finden, das Ihr Konto nicht aufrufen kann, merkt sich Claude Code die Ablehnung auf diesem Computer bis zu einem Tag lang, und Starts während dieser Zeit überspringen das gemerkten Modell, ohne Amazon Bedrock erneut zu fragen. Claude Code prüft eine gemerkten Ablehnung eines aktuellen Standardmodells beim Start erneut, sobald zehn Minuten seit der letzten Prüfung vergangen sind, sodass ein Standard, den Ihr Administrator erneut aktiviert, zurückkommt. Um das Gedächtnis auszuschalten, setzen Sie [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/de/env-vars).422Wenn diese Prüfungen ein Modell finden, das Ihr Konto nicht aufrufen kann, merkt sich Claude Code die Ablehnung auf diesem Computer bis zu einem Tag lang, und Starts während dieser Zeit überspringen das gemerkte Modell, ohne Amazon Bedrock erneut zu fragen. Claude Code prüft eine gemerkte Ablehnung eines aktuellen Standardmodells beim Start erneut, sobald zehn Minuten seit der letzten Prüfung vergangen sind, sodass ein Standard, den Ihr Administrator erneut aktiviert, zurückkommt. Um das Gedächtnis auszuschalten, setzen Sie [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/de/env-vars).

423 423 

424<h3 id="when-your-organization-enforces-a-model-allowlist">424<h3 id="when-your-organization-enforces-a-model-allowlist">

425 Wenn Ihre Organisation eine Modell-Allowlist erzwingt425 Wenn Ihre Organisation eine Modell-Allowlist erzwingt


444 444 

445Wenn Ihr Konto den Zugriff auf das Modell verliert, auf dem Ihre Sitzung läuft, beispielsweise weil ein Administrator es in Ihrem Amazon Bedrock-Konto deaktiviert, wechselt Claude Code die Sitzung zu einem anderen Modell, anstatt jede Anfrage fehlschlagen zu lassen, und zeigt `Switched to <fallback> because <model> is not available` an. Es versucht die gleichen Modelle wie der Startup-Fallback: zuerst frühere Versionen der gleichen Stufe und für eine Opus-Sitzung ohne verfügbare Opus-Version das Standard-Sonnet-Modell.445Wenn Ihr Konto den Zugriff auf das Modell verliert, auf dem Ihre Sitzung läuft, beispielsweise weil ein Administrator es in Ihrem Amazon Bedrock-Konto deaktiviert, wechselt Claude Code die Sitzung zu einem anderen Modell, anstatt jede Anfrage fehlschlagen zu lassen, und zeigt `Switched to <fallback> because <model> is not available` an. Es versucht die gleichen Modelle wie der Startup-Fallback: zuerst frühere Versionen der gleichen Stufe und für eine Opus-Sitzung ohne verfügbare Opus-Version das Standard-Sonnet-Modell.

446 446 

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

448 448 

449Eine [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains), die Sie konfigurieren, ersetzt den Stufenwechsel: Bei diesen Ablehnungen wechselt Claude Code stattdessen zu Ihrem konfigurierten Fallback. Um zu haben, dass abgelehnte Anfragen fehlschlagen, anstatt zu wechseln, setzen Sie [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/de/env-vars). Eine Fallback-Kette, die Sie konfiguriert haben, wechselt immer noch bei diesen Ablehnungen; entfernen Sie die Kette auch, wenn Sie möchten, dass jede abgelehnte Anfrage fehlschlägt.449Eine [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains), die Sie konfigurieren, ersetzt den Stufenwechsel: Bei diesen Ablehnungen wechselt Claude Code stattdessen zu Ihrem konfigurierten Fallback. Damit abgelehnte Anfragen fehlschlagen, anstatt zu wechseln, setzen Sie [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/de/env-vars). Eine Fallback-Kette, die Sie konfiguriert haben, wechselt immer noch bei diesen Ablehnungen; entfernen Sie die Kette auch, wenn Sie möchten, dass jede abgelehnte Anfrage fehlschlägt.

450 450 

451<h2 id="cross-region-inference-profile-prefixes">451<h2 id="cross-region-inference-profile-prefixes">

452 Präfixe für regionsübergreifende Inferenzprofile452 Präfixe für regionsübergreifende Inferenzprofile

artifacts.md +1 −1

Details

105 Ein Artefakt erneut finden105 Ein Artefakt erneut finden

106</h2>106</h2>

107 107 

108Führen Sie `/artifacts` in Claude Code aus, um die Artefakte aufzulisten, die Sie besitzen, und die Artefakte, die mit Ihnen geteilt wurden. Die Artefakte der aktuellen Sitzung stehen an erster Stelle unter **This session**. Erfordert Claude Code v2.1.208 oder später.108Führen Sie `/artifacts` in Claude Code aus, um die Artefakte aufzulisten, die Sie besitzen, und die Artefakte, die mit Ihnen geteilt wurden. Die Artefakte der aktuellen Sitzung stehen an erster Stelle unter **This session**.

109 109 

110Wählen Sie ein Artefakt aus und drücken Sie dann eine dieser Tasten:110Wählen Sie ein Artefakt aus und drücken Sie dann eine dieser Tasten:

111 111 

Details

321claude auto-mode defaults321claude auto-mode defaults

322```322```

323 323 

324Um die vollständige Formulierung einer Regel ohne Piping durch `jq` zu lesen, übergeben Sie `--label` mit dem Anfang des Regelbezeichners, z. B. `claude auto-mode defaults --label 'Git Destructive'`. Der Abgleich ist ein Präfix ohne Berücksichtigung der Groß-/Kleinschreibung für jeden Regelbezeichner, und Abschnitte ohne Übereinstimmung werden als leere Listen ausgegeben. Erfordert Claude Code v2.1.208 oder später.324Um die vollständige Formulierung einer Regel ohne Piping durch `jq` zu lesen, übergeben Sie `--label` mit dem Anfang des Regelbezeichners, z. B. `claude auto-mode defaults --label 'Git Destructive'`. Der Abgleich ist ein Präfix ohne Berücksichtigung der Groß-/Kleinschreibung für jeden Regelbezeichner, und Abschnitte ohne Übereinstimmung werden als leere Listen ausgegeben.

325 325 

326Geben Sie aus, was der Klassifizierer tatsächlich als JSON verwendet, mit Ihren Einstellungen, wo festgelegt, und Standardwerten andernfalls:326Geben Sie aus, was der Klassifizierer tatsächlich als JSON verwendet, mit Ihren Einstellungen, wo festgelegt, und Standardwerten andernfalls:

327 327 


359 359 

360Wenn Sie benutzerdefinierte Regeln geschrieben haben, überprüft `claude auto-mode critique` diese und kennzeichnet Einträge, die mehrdeutig, redundant oder wahrscheinlich zu falsch positiven Ergebnissen führen.360Wenn Sie benutzerdefinierte Regeln geschrieben haben, überprüft `claude auto-mode critique` diese und kennzeichnet Einträge, die mehrdeutig, redundant oder wahrscheinlich zu falsch positiven Ergebnissen führen.

361 361 

362Um Ihre Anpassungen zu verwerfen und zu den integrierten Standardwerten zurückzukehren, führen Sie den Reset-Unterbefehl aus. Er erfordert Claude Code v2.1.212 oder später und entfernt den Abschnitt `autoMode` aus Ihrer Benutzereinstellungsdatei:362Um Ihre Anpassungen zu verwerfen und zu den integrierten Standardwerten zurückzukehren, führen Sie den Reset-Unterbefehl aus, der den Abschnitt `autoMode` aus Ihrer Benutzereinstellungsdatei entfernt:

363 363 

364```bash theme={null}364```bash theme={null}

365claude auto-mode reset365claude auto-mode reset

chrome.md +3 −3

Details

113 113 

114Wenn die Einstellung aktiviert ist und Sie Claude Code v2.1.287 oder höher verwenden, verbindet sich jede VS Code-Sitzung beim Start mit Ihrem Browser, sodass Claude ihn verwenden kann, bevor Sie `@browser` eingeben. In früheren Versionen oder bei deaktivierter Einstellung verbindet sich eine VS Code-Sitzung, wenn Sie `@browser` eingeben.114Wenn die Einstellung aktiviert ist und Sie Claude Code v2.1.287 oder höher verwenden, verbindet sich jede VS Code-Sitzung beim Start mit Ihrem Browser, sodass Claude ihn verwenden kann, bevor Sie `@browser` eingeben. In früheren Versionen oder bei deaktivierter Einstellung verbindet sich eine VS Code-Sitzung, wenn Sie `@browser` eingeben.

115 115 

116Claude Code startet normal, wenn Chrome nicht ausgeführt wird. Vor v2.1.211 konnte der Start hängen bleiben, wenn Chrome-Integration aktiviert war, aber Chrome nicht ausgeführt wurde.116Claude Code startet normal, wenn Chrome nicht ausgeführt wird.

117 117 

118<Note>118<Note>

119 Das standardmäßige Aktivieren von Chrome erhöht die Kontextnutzung, da die Browser-Tools und ihre Anweisungen immer geladen werden. Wenn Sie eine erhöhte Kontextnutzung bemerken, deaktivieren Sie die Einstellung und verbinden Sie nur bei Bedarf, mit `--chrome` in der CLI oder durch Eingabe von [`@browser`](/docs/de/vs-code#automate-browser-tasks-with-chrome) im Eingabefeld von VS Code.119 Das standardmäßige Aktivieren von Chrome erhöht die Kontextnutzung, da die Browser-Tools und ihre Anweisungen immer geladen werden. Wenn Sie eine erhöhte Kontextnutzung bemerken, deaktivieren Sie die Einstellung und verbinden Sie nur bei Bedarf, mit `--chrome` in der CLI oder durch Eingabe von [`@browser`](/docs/de/vs-code#automate-browser-tasks-with-chrome) im Eingabefeld von VS Code.


192 Dateien auf Webseiten hochladen192 Dateien auf Webseiten hochladen

193</h3>193</h3>

194 194 

195Claude kann Dateien von Ihrem Computer an Upload-Felder auf einer Seite anhängen. Claude Code liest die Datei und sendet ihren Inhalt an den Browser, sodass Uploads sowohl in lokalen als auch in Remote-Sitzungen funktionieren. Erfordert Claude Code v2.1.211 oder später.195Claude kann Dateien von Ihrem Computer an Upload-Felder auf einer Seite anhängen. Claude Code liest die Datei und sendet ihren Inhalt an den Browser, sodass Uploads sowohl in lokalen als auch in Remote-Sitzungen funktionieren.

196 196 

197Dieses Beispiel hängt eine Protokolldatei an ein Formular an:197Dieses Beispiel hängt eine Protokolldatei an ein Formular an:

198 198 


271Take a screenshot of the checkout page and save it to disk271Take a screenshot of the checkout page and save it to disk

272```272```

273 273 

274Claude speichert das Bild auf der Festplatte und meldet den Dateipfad. Vor v2.1.211 schrieb die `save_to_disk`-Option des Screenshot-Tools keine Datei.274Claude speichert das Bild auf der Festplatte und meldet den Dateipfad.

275 275 

276<h2 id="troubleshooting">276<h2 id="troubleshooting">

277 Fehlerbehebung277 Fehlerbehebung

Details

502 CI-Pipelines und Remote-Maschinen502 CI-Pipelines und Remote-Maschinen

503</h3>503</h3>

504 504 

505Es gibt keinen Service-Token-Fluss für unbeaufsichtigte Pipelines. Gateway-Anmeldung führt immer den Browser-Gerätefluss aus, daher kann sich ein CI-Job ohne Entwickler zur Genehmigung der Anmeldung nicht authentifizieren; konfigurieren Sie diese direkt gegen Ihren Anbieter.505Es gibt keinen Service-Token-Fluss für unbeaufsichtigte Pipelines. Gateway-Anmeldung führt immer den Browser-Gerätefluss aus, daher kann sich ein CI-Job ohne Entwickler zur Genehmigung der Anmeldung nicht authentifizieren; konfigurieren Sie diese direkt gegen Ihren Anbieter. Stellen Sie `forceLoginMethod` und `forceLoginGatewayUrl` auf Entwicklermaschinen bereit und lassen Sie sie auf CI-Runnern weg. Auf einer Maschine, deren verwaltete Einstellungen sie setzen, [beendet sich eine Sitzung beim Start](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in), die sich mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert.

506 506 

507Sobald sich ein Entwickler angemeldet hat, verwendet jede Claude Code-Sitzung auf dieser Maschine die Gateway-Sitzung, einschließlich nicht-interaktiver `claude -p`-Läufe und Sitzungen, die vom Agent SDK gestartet werden. Claude Code wendet die [Gateway-Richtlinie](/docs/de/claude-apps-gateway-config#managed) auf jede von ihnen an.507Sobald sich ein Entwickler angemeldet hat, verwendet jede Claude Code-Sitzung auf dieser Maschine die Gateway-Sitzung, einschließlich nicht-interaktiver `claude -p`-Läufe und Sitzungen, die vom Agent SDK gestartet werden. Claude Code wendet die [Gateway-Richtlinie](/docs/de/claude-apps-gateway-config#managed) auf jede von ihnen an.

508 508 

Details

340 340 

341Setzen Sie `forward_user_identity` nur auf einem Upstream, dessen `base_url` ein Proxy ist, den Sie betreiben. Das Gateway sendet Entwickler-E-Mails an jeden Server, den diese `base_url` benennt. Wenn die `base_url` die Anthropic API ist, was der Standard ist, weigert sich das Gateway zu starten.341Setzen Sie `forward_user_identity` nur auf einem Upstream, dessen `base_url` ein Proxy ist, den Sie betreiben. Das Gateway sendet Entwickler-E-Mails an jeden Server, den diese `base_url` benennt. Wenn die `base_url` die Anthropic API ist, was der Standard ist, weigert sich das Gateway zu starten.

342 342 

343<Note>

344 Wenn Sie `forward_user_identity` auf einem Amazon Bedrock-Upstream setzen, beendet sich das Gateway beim Start mit `Unrecognized key(s) in object: 'forward_user_identity'`. Wenn Ihr Proxy vor Bedrock sitzt, listen Sie ihn stattdessen als `provider: anthropic`-Upstream auf. Das Gateway sendet diesem Upstream das Anthropic-Messages-Format, daher muss Ihr Proxy [Anfragen für Bedrock übersetzen](/docs/de/llm-gateway-protocol#format-mismatch-with-the-upstream). Um AWS stattdessen jeden Entwickler namentlich mitzuteilen, siehe [AWS-Kostenzuordnung pro Entwickler](#per-developer-aws-cost-attribution).

345</Note>

346 

343<h4 id="amazon-bedrock">347<h4 id="amazon-bedrock">

344 Amazon Bedrock348 Amazon Bedrock

345</h4>349</h4>


1133 1137 

1134* Die Modellliste aus `availableModels`. [Erweiterter Kontext in Claude Desktop](#extended-context-in-claude-desktop) behandelt die 1M-Kontextoption jedes Modells1138* Die Modellliste aus `availableModels`. [Erweiterter Kontext in Claude Desktop](#extended-context-in-claude-desktop) behandelt die 1M-Kontextoption jedes Modells

1135* 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önnen1139* 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

1136* Die Egress-Zulassungsliste aus `sandbox.network.allowedDomains`. Wenn Sie `coworkEgressAllowedHosts` im `desktop`-Block der Richtlinie setzen, verwendet das Gateway diesen Wert statt der abgeleiteten Liste1140* 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

1137* 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.1141* 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.

1138 1142 

1139 Claude Desktop exportiert jedes Signal mit einer Kodierung: `http/protobuf` oder `http/json`, wenn Sie `OTEL_EXPORTER_OTLP_PROTOCOL` oder eine seiner Pro-Signal-Varianten auf `http/json` im `env` der Richtlinie setzen. Vor Claude Code v2.1.261 auf dem Gateway-Server setzte die Antwort `http/json` unabhängig davon, sodass ein Collector, der nur Protobuf akzeptiert, Claude Desktops Exporte ablehnte1143 Claude Desktop exportiert jedes Signal mit einer Kodierung: `http/protobuf` oder `http/json`, wenn Sie `OTEL_EXPORTER_OTLP_PROTOCOL` oder eine seiner Pro-Signal-Varianten auf `http/json` im `env` der Richtlinie setzen. Vor Claude Code v2.1.261 auf dem Gateway-Server setzte die Antwort `http/json` unabhängig davon, sodass ein Collector, der nur Protobuf akzeptiert, Claude Desktops Exporte ablehnte


1374 1378 

1375Sowohl Protobuf- als auch JSON-OTLP-Kodierungen werden weitergeleitet, und jedes OpenTelemetry-kompatible Backend funktioniert als Ziel.1379Sowohl Protobuf- als auch JSON-OTLP-Kodierungen werden weitergeleitet, und jedes OpenTelemetry-kompatible Backend funktioniert als Ziel.

1376 1380 

1381<h4 id="send-cumulative-metrics">

1382 Kumulative Metriken senden

1383</h4>

1384 

1385Wenn Ihr Collector nur kumulative Metriken akzeptiert, setzen Sie [`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`](/docs/de/monitoring-usage#common-configuration-variables) auf `cumulative`. Claude Code sendet standardmäßig Delta-Metriken, und das Gateway leitet sie ohne Umwandlung weiter. Setzen Sie die Variable dort, wo die jeweilige Sitzungsart sie liest:

1386 

1387* **Terminal-Sitzungen**: im `env`-Block unter dem [`cli`- oder `code`-Schlüssel](#choose-cli-or-code) einer Richtlinie

1388* **Cowork-Sitzungen, die [auf dem Rechner des Benutzers laufen](/docs/de/managed-settings#where-and-when-a-policy-applies)**: im `env`-Block der [clientseitigen verwalteten Einstellungen](#client-side-managed-settings) auf diesem Rechner

1389* **Code-Tab-Sitzungen unter einer `code`-Richtlinie**: im `env`-Block der Richtlinie, sobald Sie die [Bedingungen erfüllen, unter denen `code`-Einstellungen gelten](#apply-code-settings-in-the-code-tab)

1390* **Code-Tab-Sitzungen unter einer `cli`-Richtlinie**: im `env`-Block der clientseitigen verwalteten Einstellungen auf dem Rechner, der die Sitzung ausführt. Über SSH ist das der Remote-Host.

1391 

1392Wenn Sie die Variable zu den verwalteten Einstellungen eines Rechners hinzufügen, setzen Sie außerdem [`parentSettingsBehavior: "merge"`](/docs/de/claude-apps-gateway#set-the-opt-in) in der Quelle mit der höchsten Priorität auf diesem Rechner. Ohne diese Einstellung laufen Cowork-Sitzungen und Code-Tab-Sitzungen unter einer `cli`-Richtlinie ohne die Egress-Allowlist und andere Richtlinien, die Claude Desktop ihnen als übergeordnete Einstellungen übergibt.

1393 

1377<h4 id="add-your-own-labels">1394<h4 id="add-your-own-labels">

1378 Ihre eigenen Labels hinzufügen1395 Ihre eigenen Labels hinzufügen

1379</h4>1396</h4>

Details

1706claude purge ~/work/my-repo --yes1706claude purge ~/work/my-repo --yes

1707```1707```

1708 1708 

1709Übergeben Sie `--all` statt eines Pfads, um den Status für jedes Projekt auf einmal zu bereinigen, was `history.jsonl` vollständig löscht, anstatt es zu filtern. Übergeben Sie `-i`, um den Löschplan Schritt für Schritt durchzugehen.1709Weitere Optionen:

1710 

1711* Übergeben Sie `--all` statt eines Pfads, um den Status für jedes Projekt auf einmal zu bereinigen, was `history.jsonl` vollständig löscht, anstatt es zu filtern.

1712* Übergeben Sie `-i`, um den Löschplan Schritt für Schritt durchzugehen.

1710 1713 

1711Der Befehl lässt `shell-snapshots/` und `backups/` unberührt, da diese nicht projektbezogen sind, und warnt in der Plan-Ausgabe davor. Wenn jemand auf dem Rechner [`/heapdump`](/docs/de/troubleshooting#high-cpu-or-memory-usage) ausgeführt hat, löschen Sie auch die `.heapsnapshot`-Dateien, die dabei geschrieben wurden. Ein Heap-Snapshot enthält die vollständige Konversation und alle Anmeldedaten, die der Prozess gehalten hat, und weder der Aufbewahrungsdurchlauf noch der Purge berührt ihn.1714Der Befehl lässt `shell-snapshots/` und `backups/` unberührt, da diese nicht projektbezogen sind, und warnt in der Plan-Ausgabe davor. Wenn jemand auf dem Rechner [`/heapdump`](/docs/de/troubleshooting#high-cpu-or-memory-usage) ausgeführt hat, löschen Sie auch die `.heapsnapshot`-Dateien, die dabei geschrieben wurden. Ein Heap-Snapshot enthält die vollständige Konversation und alle Anmeldedaten, die der Prozess gehalten hat, und weder der Aufbewahrungsdurchlauf noch der Purge berührt ihn.

1712 1715 

1713Sie können auch jeden der oben genannten Anwendungsdaten-Pfade manuell löschen, abgesehen von den [Zustandsdateien zum Behalten](#state-files-to-keep). Neue Sitzungen sind nicht betroffen. Die folgende Tabelle zeigt, was Sie für vergangene Sitzungen verlieren.1716Sie können auch jeden der oben genannten Anwendungsdaten-Pfade manuell löschen, abgesehen von den [Zustandsdateien zum Behalten](#state-files-to-keep).

1714 1717 

1715| Löschen | Sie verlieren |1718| Löschen | Sie verlieren |

1716| - | - |1719| - | - |


1726| `~/.claude/remote-settings.json` | Nichts. Wird beim nächsten Start erneut abgerufen. |1729| `~/.claude/remote-settings.json` | Nichts. Wird beim nächsten Start erneut abgerufen. |

1727| `~/.claude/cache/changelog.md` | Nichts. Im Hintergrund aktualisiert. |1730| `~/.claude/cache/changelog.md` | Nichts. Im Hintergrund aktualisiert. |

1728| `~/.claude/policy-limits.json` | Nichts. Automatisch aktualisiert. |1731| `~/.claude/policy-limits.json` | Nichts. Automatisch aktualisiert. |

1729| `~/.claude/tasks/` | Aufgabenlisten, die eine fortgesetzte Sitzung aufgreifen würde |1732| `~/.claude/tasks/` | Ihre [Aufgabenlisten](/docs/de/interactive-mode#task-list), einschließlich solcher, die noch verwendet werden |

1730| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Die Möglichkeit, [synchronisierte Skills](/docs/de/skills#how-synced-skills-behave) und [synchronisierte Plugins](/docs/de/plugins/loading#synced-plugins) wiederherzustellen, die Claude Code entfernt hat |1733| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Die Möglichkeit, [synchronisierte Skills](/docs/de/skills#how-synced-skills-behave) und [synchronisierte Plugins](/docs/de/plugins/loading#synced-plugins) wiederherzustellen, die Claude Code entfernt hat |

1731| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`, `~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Die Kopien von Plugin-Installationsdatensätzen, die Claude Code gelöscht hat oder nicht lesen konnte. Nichts liest sie zurück |1734| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`, `~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Die Kopien von Plugin-Installationsdatensätzen, die Claude Code gelöscht hat oder nicht lesen konnte. Nichts liest sie zurück |

1732| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Nichts für Benutzer sichtbar |1735| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Nichts für Benutzer sichtbar |

Details

115| `--no-session-persistence` | Deaktivieren Sie die Sitzungspersistenz, sodass Sitzungen nicht auf der Festplatte gespeichert werden und nicht fortgesetzt werden können. Nur Print-Modus. Die [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/de/env-vars)-Umgebungsvariable macht das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |115| `--no-session-persistence` | Deaktivieren Sie die Sitzungspersistenz, sodass Sitzungen nicht auf der Festplatte gespeichert werden und nicht fortgesetzt werden können. Nur Print-Modus. Die [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/de/env-vars)-Umgebungsvariable macht das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |

116| `--output-format` | Geben Sie das Ausgabeformat für den Print-Modus an (Optionen: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |116| `--output-format` | Geben Sie das Ausgabeformat für den Print-Modus an (Optionen: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

117| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/docs/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, oder `manual` als Alias für `default`. Der `manual`-Alias wählt den Berechtigungsmodus, den die UI als Manual kennzeichnet, und erfordert Claude Code v2.1.200 oder später; `claude --help` listet ihn anstelle von `default` auf, und beide Werte funktionieren. Überschreibt `defaultMode` aus Einstellungsdateien. Ohne diesen Flag oder `--dangerously-skip-permissions` startet eine neue Sitzung im Berechtigungsmodus, der in [welcher Berechtigungsmodus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) beschrieben ist, was auch abdeckt, in welchem Modus ein `-p`-Lauf startet | `claude --permission-mode plan` |117| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/docs/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, oder `manual` als Alias für `default`. Der `manual`-Alias wählt den Berechtigungsmodus, den die UI als Manual kennzeichnet, und erfordert Claude Code v2.1.200 oder später; `claude --help` listet ihn anstelle von `default` auf, und beide Werte funktionieren. Überschreibt `defaultMode` aus Einstellungsdateien. Ohne diesen Flag oder `--dangerously-skip-permissions` startet eine neue Sitzung im Berechtigungsmodus, der in [welcher Berechtigungsmodus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) beschrieben ist, was auch abdeckt, in welchem Modus ein `-p`-Lauf startet | `claude --permission-mode plan` |

118| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. Claude Code wartet darauf, dass der MCP-Server dieses Tools verbunden wird, bevor der erste Turn ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars)-Startup-Timeout, standardmäßig 30 Sekunden. <br /><br />Das Prompt-Tool kann ein MCP-Tool, das als [Benutzerinteraktion erfordernd](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: Claude Code konvertiert ein `allow`-Ergebnis für eines in eine Ablehnung. Diese Einschränkung erfordert Claude Code v2.1.199 oder später | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |118| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsabfragen im nicht interaktiven Modus zu verarbeiten. Übergeben Sie den vollständigen Namen, etwa `mcp__<server>__<tool>`, eines Tools auf einem MCP-Server, den der Lauf lädt. Claude Code wartet darauf, dass der MCP-Server dieses Tools verbunden wird, bevor der erste Turn ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars)-Startup-Timeout, standardmäßig 30 Sekunden. <br /><br />Das Prompt-Tool kann ein MCP-Tool, das als [Benutzerinteraktion erfordernd](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: Claude Code konvertiert ein `allow`-Ergebnis für eines in eine Ablehnung. Diese Einschränkung erfordert Claude Code v2.1.199 oder später | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |

119| `--permission-prompts` | Legen Sie fest, wer Berechtigungsaufforderungen im Print-Modus beantwortet. Mit dem Standard `host` sendet Claude Code sie an den Agent SDK-Host oder das `--permission-prompt-tool`-Tool. Übergeben Sie `none`, wenn niemand antworten kann, und Claude Code lehnt sie stattdessen ab. Siehe [Deaktivieren Sie Berechtigungsaufforderungen in unbeaufsichtigten Läufen](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs). Erfordert Claude Code v2.1.259 oder später | `claude -p --permission-prompts none "query"` |119| `--permission-prompts` | Legen Sie fest, wer Berechtigungsaufforderungen im Print-Modus beantwortet. Mit dem Standard `host` sendet Claude Code sie an den Agent SDK-Host oder das `--permission-prompt-tool`-Tool. Übergeben Sie `none`, wenn niemand antworten kann, und Claude Code lehnt sie stattdessen ab. Siehe [Deaktivieren Sie Berechtigungsaufforderungen in unbeaufsichtigten Läufen](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs). Erfordert Claude Code v2.1.259 oder später | `claude -p --permission-prompts none "query"` |

120| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip`-Archiv, oder mehrere aus einem [Ordner von Plugins](/docs/de/plugins/create#load-a-directory-or-archive-for-one-session), nur für diese Sitzung. Jeder Flag nimmt einen Pfad. Wiederholen Sie den Flag für mehr Pfade: `--plugin-dir A --plugin-dir B.zip`. Das Übergeben eines Ordners von Plugins erfordert Claude Code v2.1.265 oder später | `claude --plugin-dir ./my-plugin` |120| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip`-Archiv, oder mehrere aus einem [Ordner von Plugins](/docs/de/plugins/create#load-a-directory-or-archive-for-one-session), nur für diese Sitzung. Jeder Flag nimmt einen Pfad. Wiederholen Sie den Flag für mehr Pfade: `--plugin-dir A --plugin-dir B.zip`. Das Übergeben eines Ordners von Plugins erfordert Claude Code v2.1.265 oder später | `claude --plugin-dir ./my-plugin` |

121| `--plugin-url` | Rufen Sie ein Plugin `.zip`-Archiv von einer URL für diese Sitzung nur ab. Wiederholen Sie den Flag für mehrere Plugins, oder übergeben Sie durch Leerzeichen getrennte URLs in einem einzelnen angeführten Wert | `claude --plugin-url https://example.com/plugin.zip` |121| `--plugin-url` | Rufen Sie ein Plugin `.zip`-Archiv von einer URL für diese Sitzung nur ab. Wiederholen Sie den Flag für mehrere Plugins, oder übergeben Sie durch Leerzeichen getrennte URLs in einem einzelnen angeführten Wert | `claude --plugin-url https://example.com/plugin.zip` |

Details

117 117 

118* **Das Repository ist auf Manual eingestellt**: wie ein Review per Kommentar angefordert wird118* **Das Repository ist auf Manual eingestellt**: wie ein Review per Kommentar angefordert wird

119* **Der Pull Request stammt aus einem Fork**: dass ein Maintainer das Review anfordern kann119* **Der Pull Request stammt aus einem Fork**: dass ein Maintainer das Review anfordern kann

120* **Ein Bot oder jemand ohne Schreibzugriff kommentiert `@claude review`**: dass kein Review gestartet wurde und wer eines anfordern kann120* **Ein Bot oder jemand ohne Schreibzugriff, der nicht der Autor des Pull Requests ist, kommentiert `@claude review`**: dass kein Review gestartet wurde und wer eines anfordern kann

121* **Die GitHub-Organisation ist nicht mit Ihrer Claude-Organisation verknüpft**: dass Reviews pausiert sind und wie die Verknüpfung hergestellt wird121* **Die GitHub-Organisation ist nicht mit Ihrer Claude-Organisation verknüpft**: dass Reviews pausiert sind und wie die Verknüpfung hergestellt wird

122 122 

123Schalten Sie die Einstellung aus, um diese Kommentare zu unterbinden.123Schalten Sie die Einstellung aus, um diese Kommentare zu unterbinden.

Details

38 38 

39* **Code Review ist für dieses Repository nicht aktiviert**: Claude postet als Antwort auf den Befehl weder einen Kommentar noch einen Check-Run. Bitten Sie einen Owner, [das Repository hinzuzufügen](/docs/de/code-review-setup#add-more-repositories).39* **Code Review ist für dieses Repository nicht aktiviert**: Claude postet als Antwort auf den Befehl weder einen Kommentar noch einen Check-Run. Bitten Sie einen Owner, [das Repository hinzuzufügen](/docs/de/code-review-setup#add-more-repositories).

40* **Der Kommentar erfüllt eine Bedingung nicht**: Es handelte sich um einen Inline-Kommentar oder einen Review-Text statt um einen neuen Kommentar auf oberster Ebene, oder der Befehl stand nicht am Anfang des Kommentars. Das Bearbeiten eines früheren Kommentars statt des Postens eines neuen zählt ebenfalls nicht, und der Pull Request muss offen sein. Lesen Sie die [Bedingungen für Kommentarbefehle](/docs/de/code-review-pull-requests#comment-commands) und posten Sie einen neuen Kommentar, der sie erfüllt.40* **Der Kommentar erfüllt eine Bedingung nicht**: Es handelte sich um einen Inline-Kommentar oder einen Review-Text statt um einen neuen Kommentar auf oberster Ebene, oder der Befehl stand nicht am Anfang des Kommentars. Das Bearbeiten eines früheren Kommentars statt des Postens eines neuen zählt ebenfalls nicht, und der Pull Request muss offen sein. Lesen Sie die [Bedingungen für Kommentarbefehle](/docs/de/code-review-pull-requests#comment-commands) und posten Sie einen neuen Kommentar, der sie erfüllt.

41* **Sie haben keinen Schreibzugriff**: Sie benötigen die Berechtigung write, maintain oder admin für das Repository, und bei einem Pull Request aus einem Fork zählt die Berechtigung für das Basis-Repository. Wenn Ihre Organisation Tipps aktiviert hat, antwortet Claude mit „No review was started: manual reviews can only be requested by someone with write access to this repository.“ Bitten Sie stattdessen jemanden mit Schreibzugriff, den Kommentar zu verfassen.41* **Sie haben keinen Schreibzugriff**: Sie benötigen die Berechtigung write, maintain oder admin für das Repository. Bei einem Pull Request aus einem Fork zählt die Berechtigung für das Basis-Repository. Sofern der Pull Request nicht Ihr eigener ist, kann Claude mit einem [Tipp](/docs/de/code-review-setup#turn-tip-comments-on-or-off) antworten: „No review was started: manual reviews can only be requested by someone with write access to this repository.“ Bitten Sie stattdessen jemanden mit Schreibzugriff, den Kommentar zu verfassen.

42* **Das Budget ist aufgebraucht**: Claude postet einen Kommentar, der mit „⚠️ Code review skipped“ beginnt. Lesen Sie [Das Review wurde nicht ausgeführt und der PR zeigt eine Budgetmeldung](#review-didn’t-run-and-the-pr-shows-a-budget-message).42* **Das Budget ist aufgebraucht**: Claude postet einen Kommentar, der mit „⚠️ Code review skipped“ beginnt. Lesen Sie [Das Review wurde nicht ausgeführt und der PR zeigt eine Budgetmeldung](#review-didn’t-run-and-the-pr-shows-a-budget-message).

43 43 

44<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">44<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">

commands.md +5 −5

Details

65| `/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| `/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` |

66| `/batch <instruction>` | **[Skill](/docs/de/skills#bundled-skills).** Orchestriert umfangreiche Änderungen in einer Codebasis parallel. Untersucht die Codebasis, zerlegt die Arbeit in 5 bis 30 unabhängige Einheiten und präsentiert einen Plan. Nach der Genehmigung startet er pro Einheit einen [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem isolierten [Worktree](/docs/de/worktrees). Jeder Subagent implementiert seine Einheit, führt Tests aus und veröffentlicht seine Änderung. Erfordert ein Git-Repository oder einen [`WorktreeCreate`-Hook](/docs/de/worktrees#non-git-version-control), der die Worktrees erstellt. Außerhalb eines Git-Repositorys erfordert `/batch` Claude Code v2.1.281 oder höher. Beispiel: `/batch migrate src/ from JavaScript to TypeScript` |66| `/batch <instruction>` | **[Skill](/docs/de/skills#bundled-skills).** Orchestriert umfangreiche Änderungen in einer Codebasis parallel. Untersucht die Codebasis, zerlegt die Arbeit in 5 bis 30 unabhängige Einheiten und präsentiert einen Plan. Nach der Genehmigung startet er pro Einheit einen [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem isolierten [Worktree](/docs/de/worktrees). Jeder Subagent implementiert seine Einheit, führt Tests aus und veröffentlicht seine Änderung. Erfordert ein Git-Repository oder einen [`WorktreeCreate`-Hook](/docs/de/worktrees#non-git-version-control), der die Worktrees erstellt. Außerhalb eines Git-Repositorys erfordert `/batch` Claude Code v2.1.281 oder höher. Beispiel: `/batch migrate src/ from JavaScript to TypeScript` |

67| `/branch [name]` | Erstellt an dieser Stelle einen Konversationszweig der aktuellen Konversation, sodass Sie eine andere Richtung ausprobieren können, ohne die Konversation in ihrem aktuellen Stand zu verlieren. Wechselt Sie in den Zweig und bewahrt das Original, zu dem Sie mit `/resume` zurückkehren können. Um eine Kopie als separate [Hintergrundsitzung](/docs/de/agent-view) auszuführen, statt in sie zu wechseln, verwenden Sie `/fork`; um eine Nebenaufgabe an einen [Subagenten](/docs/de/sub-agents) zu übergeben, der in diese Konversation zurückberichtet, verwenden Sie `/subtask` |67| `/branch [name]` | Erstellt an dieser Stelle einen Konversationszweig der aktuellen Konversation, sodass Sie eine andere Richtung ausprobieren können, ohne die Konversation in ihrem aktuellen Stand zu verlieren. Wechselt Sie in den Zweig und bewahrt das Original, zu dem Sie mit `/resume` zurückkehren können. Um eine Kopie als separate [Hintergrundsitzung](/docs/de/agent-view) auszuführen, statt in sie zu wechseln, verwenden Sie `/fork`; um eine Nebenaufgabe an einen [Subagenten](/docs/de/sub-agents) zu übergeben, der in diese Konversation zurückberichtet, verwenden Sie `/subtask` |

68| `/btw [question]` | Stellt eine [Nebenfrage](/docs/de/interactive-mode#side-questions-with-%2Fbtw) zur aktuellen Sitzung, ohne sie der Konversation hinzuzufügen. Wenn Sie `/btw` ohne Frage ausführen, zeigt Claude Code Ihre letzte Nebenfrage an, damit Sie frühere Antworten durchsehen können; wenn Sie noch keine gestellt haben, gibt Claude Code eine Verwendungszeile aus. Vor v2.1.212 erforderte `/btw` eine Frage |68| `/btw [question]` | Stellt eine [Nebenfrage](/docs/de/interactive-mode#side-questions-with-%2Fbtw) zur aktuellen Sitzung, ohne sie der Konversation hinzuzufügen. Wenn Sie `/btw` ohne Frage ausführen, zeigt Claude Code Ihre letzte Nebenfrage an, damit Sie frühere Antworten durchsehen können; wenn Sie noch keine gestellt haben, gibt Claude Code eine Verwendungszeile aus |

69| `/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` |69| `/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` |

70| `/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) |70| `/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) |

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


95| `/feedback [report]` | Sendet Produktfeedback zu Claude Code. Öffnet denselben Dialog wie [`/bug`](#all-commands), mit demselben Einwilligungsschritt, denselben Senderegeln und demselben Verhalten mitten im Turn. In Sitzungen mit [von Claude entworfenem Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) öffnet `/feedback` ohne Argument stattdessen die Entwurfswarteschlange, in der Sie die von Claude eingereihten Entwürfe prüfen, bearbeiten, senden oder verwerfen; die Warteschlange enthält eine Option, einen neuen Bericht im Dialog zu schreiben. Mit einem Argument und bei `/bug` immer wird der Dialog direkt geöffnet |95| `/feedback [report]` | Sendet Produktfeedback zu Claude Code. Öffnet denselben Dialog wie [`/bug`](#all-commands), mit demselben Einwilligungsschritt, denselben Senderegeln und demselben Verhalten mitten im Turn. In Sitzungen mit [von Claude entworfenem Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) öffnet `/feedback` ohne Argument stattdessen die Entwurfswarteschlange, in der Sie die von Claude eingereihten Entwürfe prüfen, bearbeiten, senden oder verwerfen; die Warteschlange enthält eine Option, einen neuen Bericht im Dialog zu schreiben. Mit einem Argument und bei `/bug` immer wird der Dialog direkt geöffnet |

96| `/fewer-permission-prompts` | **[Skill](/docs/de/skills#bundled-skills).** Durchsucht Ihre Transkripte nach häufigen nur lesenden Bash- und MCP-Tool-Aufrufen und fügt dann der Projektdatei `.claude/settings.json` eine priorisierte Allowlist hinzu, um Berechtigungsabfragen zu reduzieren |96| `/fewer-permission-prompts` | **[Skill](/docs/de/skills#bundled-skills).** Durchsucht Ihre Transkripte nach häufigen nur lesenden Bash- und MCP-Tool-Aufrufen und fügt dann der Projektdatei `.claude/settings.json` eine priorisierte Allowlist hinzu, um Berechtigungsabfragen zu reduzieren |

97| `/focus` | Schaltet die Fokusansicht um, die nur Ihren letzten Prompt, eine einzeilige Zusammenfassung der Tool-Aufrufe mit Diffstats der Bearbeitungen und die endgültige Antwort zeigt. Die Zusammenfassung der Tool-Aufrufe zählt außerdem die im Turn gestarteten Subagenten und fasst Benachrichtigungen über abgeschlossene Hintergrundaufgaben zu einer einzigen Zahl zusammen. Die Auswahl bleibt sitzungsübergreifend erhalten; setzen Sie [`viewMode`](/docs/de/settings-reference#viewmode) in den Einstellungen, um sie zu überschreiben. Nur im [Vollbild-Rendering](/docs/de/fullscreen) verfügbar. Führen Sie von einem [Remote Control](/docs/de/remote-control)-Client `/focus [on\|off]` aus, um die Fokusansicht nur für die aktuelle Sitzung ein- oder auszuschalten, ohne Ihre gespeicherte Auswahl zu ändern; dies erfordert Claude Code v2.1.281 oder höher. Die [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) bietet eine eigene Focus-Ansicht als Umschalter im Befehlsmenü, die als Erweiterungseinstellung gespeichert wird, unabhängig von `viewMode` |97| `/focus` | Schaltet die Fokusansicht um, die nur Ihren letzten Prompt, eine einzeilige Zusammenfassung der Tool-Aufrufe mit Diffstats der Bearbeitungen und die endgültige Antwort zeigt. Die Zusammenfassung der Tool-Aufrufe zählt außerdem die im Turn gestarteten Subagenten und fasst Benachrichtigungen über abgeschlossene Hintergrundaufgaben zu einer einzigen Zahl zusammen. Die Auswahl bleibt sitzungsübergreifend erhalten; setzen Sie [`viewMode`](/docs/de/settings-reference#viewmode) in den Einstellungen, um sie zu überschreiben. Nur im [Vollbild-Rendering](/docs/de/fullscreen) verfügbar. Führen Sie von einem [Remote Control](/docs/de/remote-control)-Client `/focus [on\|off]` aus, um die Fokusansicht nur für die aktuelle Sitzung ein- oder auszuschalten, ohne Ihre gespeicherte Auswahl zu ändern; dies erfordert Claude Code v2.1.281 oder höher. Die [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) bietet eine eigene Focus-Ansicht als Umschalter im Befehlsmenü, die als Erweiterungseinstellung gespeichert wird, unabhängig von `viewMode` |

98| `/fork [prompt]` | [Kopiert die aktuelle Konversation](/docs/de/agent-view#copy-the-session-with-%2Ffork) in eine neue Hintergrundsitzung, während Sie hier weiterarbeiten. Übergeben Sie einen Prompt, und die Kopie beginnt sofort damit; ohne Prompt wartet sie in der Agent-Ansicht auf ihren ersten Prompt. Außer wenn die Kopie [direkt an Ort und Stelle bearbeitet](/docs/de/agent-view#how-file-edits-are-isolated), weist Claude Code sie an, vor Codeänderungen einen eigenen Worktree zu erstellen; die Isolationsanweisung erfordert Claude Code v2.1.221 oder höher. Um eine Nebenaufgabe an einen Subagenten zu übergeben, dessen Ergebnis in diese Konversation zurückkommt, verwenden Sie `/subtask`; um selbst in eine Kopie zu wechseln, verwenden Sie `/branch`. Erfordert Claude Code v2.1.212 oder höher; in v2.1.161 bis v2.1.211 und immer dann, wenn [die Agent-Ansicht deaktiviert ist](/docs/de/agent-view#turn-off-agent-view), startet `/fork` stattdessen einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation) |98| `/fork [prompt]` | [Kopiert die aktuelle Konversation](/docs/de/agent-view#copy-the-session-with-%2Ffork) in eine neue Hintergrundsitzung, während Sie hier weiterarbeiten. Übergeben Sie einen Prompt, und die Kopie beginnt sofort damit; ohne Prompt wartet sie in der Agent-Ansicht auf ihren ersten Prompt. Außer wenn die Kopie [direkt an Ort und Stelle bearbeitet](/docs/de/agent-view#how-file-edits-are-isolated), weist Claude Code sie an, vor Codeänderungen einen eigenen Worktree zu erstellen; die Isolationsanweisung erfordert Claude Code v2.1.221 oder höher. Um eine Nebenaufgabe an einen Subagenten zu übergeben, dessen Ergebnis in diese Konversation zurückkommt, verwenden Sie `/subtask`; um selbst in eine Kopie zu wechseln, verwenden Sie `/branch`. Wenn [die Agent-Ansicht deaktiviert ist](/docs/de/agent-view#turn-off-agent-view), startet `/fork` stattdessen einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation) |

99| `/goal [condition\|clear]` | Legt ein [Ziel](/docs/de/goal) fest: Claude arbeitet über mehrere Turns hinweg weiter, bis die Bedingung erfüllt ist oder das Ziel [aus einem anderen Grund aufgehoben wird](/docs/de/goal#how-evaluation-works). Ohne Argument wird das aktuelle oder zuletzt erreichte Ziel angezeigt. `clear`, `stop`, `off`, `reset`, `none` oder `cancel` entfernt ein aktives Ziel vorzeitig |99| `/goal [condition\|clear]` | Legt ein [Ziel](/docs/de/goal) fest: Claude arbeitet über mehrere Turns hinweg weiter, bis die Bedingung erfüllt ist oder das Ziel [aus einem anderen Grund aufgehoben wird](/docs/de/goal#how-evaluation-works). Ohne Argument wird das aktuelle oder zuletzt erreichte Ziel angezeigt. `clear`, `stop`, `off`, `reset`, `none` oder `cancel` entfernt ein aktives Ziel vorzeitig |

100| `/heapdump` | Schreibt einen JavaScript-Heap-Snapshot und eine Speicheraufschlüsselung nach `~/Desktop` oder, unter Linux ohne Desktop-Ordner, in Ihr Home-Verzeichnis, um hohen Speicherverbrauch zu diagnostizieren. Hängen Sie beim Melden eines Speicherproblems nur die Datei `-diagnostics.json` an; die `.heapsnapshot`-Datei enthält Ihre vollständige Konversation und Ihre Anmeldedaten, teilen Sie sie daher nicht. [Im Befehlsmenü ausgeblendet](#how-the-command-menu-matches-what-you-type); geben Sie ihn vollständig ein. Siehe [was Sie mit der Ausgabe tun sollten](/docs/de/troubleshooting#high-cpu-or-memory-usage) |100| `/heapdump` | Schreibt einen JavaScript-Heap-Snapshot und eine Speicheraufschlüsselung nach `~/Desktop` oder, unter Linux ohne Desktop-Ordner, in Ihr Home-Verzeichnis, um hohen Speicherverbrauch zu diagnostizieren. Hängen Sie beim Melden eines Speicherproblems nur die Datei `-diagnostics.json` an; die `.heapsnapshot`-Datei enthält Ihre vollständige Konversation und Ihre Anmeldedaten, teilen Sie sie daher nicht. [Im Befehlsmenü ausgeblendet](#how-the-command-menu-matches-what-you-type); geben Sie ihn vollständig ein. Siehe [was Sie mit der Ausgabe tun sollten](/docs/de/troubleshooting#high-cpu-or-memory-usage) |

101| `/help` | Zeigt Hilfe und verfügbare Befehle an |101| `/help` | Zeigt Hilfe und verfügbare Befehle an |

102| `/hooks` | Zeigt [Hook](/docs/de/hooks#the-%2Fhooks-menu)-Konfigurationen an |102| `/hooks` | Zeigt [Hook](/docs/de/hooks#the-%2Fhooks-menu)-Konfigurationen an |

103| `/ide` | Verwaltet IDE-Integrationen und zeigt den Status an |103| `/ide` | Verwaltet IDE-Integrationen und zeigt den Status an |

104| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Übernimmt Konfiguration aus OpenAI Codex, Google Gemini CLI oder Cursor auf Ihrem Rechner in Claude Code, einschließlich Anweisungsdateien, MCP-Servern, Befehlen, Subagenten und Skills. Im [nicht interaktiven Modus](/docs/de/headless) mit `-p` listet `/import` auf, was gefunden wurde, und nennt Ihnen den Befehl, der den Import bestätigt. Fügen Sie `--dry-run` hinzu, um eine Vorschau anzuzeigen, ohne etwas zu schreiben, oder `--yes`, um die interaktive Auswahl zu überspringen. Nicht verfügbar 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). Ebenfalls nicht verfügbar, wenn Sie das [Abrufen von Feature-Flags](/docs/de/env-vars#features-that-need-feature-flag-fetching) deaktivieren. Erfordert Claude Code v2.1.213 oder höher. Der Import aus Cursor erfordert v2.1.265 oder höher |104| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Übernimmt Konfiguration aus OpenAI Codex, Google Gemini CLI oder Cursor auf Ihrem Rechner in Claude Code, einschließlich Anweisungsdateien, MCP-Servern, Befehlen, Subagenten und Skills. Im [nicht interaktiven Modus](/docs/de/headless) mit `-p` listet `/import` auf, was gefunden wurde, und nennt Ihnen den Befehl, der den Import bestätigt. Fügen Sie `--dry-run` hinzu, um eine Vorschau anzuzeigen, ohne etwas zu schreiben, oder `--yes`, um die interaktive Auswahl zu überspringen. Nicht verfügbar 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). Ebenfalls nicht verfügbar, wenn Sie das [Abrufen von Feature-Flags](/docs/de/env-vars#features-that-need-feature-flag-fetching) deaktivieren. Der Import aus Cursor erfordert v2.1.265 oder höher |

105| `/init` | Initialisiert das Projekt mit einem `CLAUDE.md`-Leitfaden. Setzen Sie `CLAUDE_CODE_NEW_INIT=1` für einen interaktiven Ablauf, der auch durch Skills, Hooks und persönliche Memory-Dateien führt. Wenn `/init` Konfiguration von OpenAI Codex oder Google Gemini CLI findet, bietet es an, sie mit `/import` zu übernehmen |105| `/init` | Initialisiert das Projekt mit einem `CLAUDE.md`-Leitfaden. Setzen Sie `CLAUDE_CODE_NEW_INIT=1` für einen interaktiven Ablauf, der auch durch Skills, Hooks und persönliche Memory-Dateien führt. Wenn `/init` Konfiguration von OpenAI Codex oder Google Gemini CLI findet, bietet es an, sie mit `/import` zu übernehmen |

106| `/insights` | Erstellt einen HTML-Bericht, der Ihre letzten Sitzungen auf diesem Rechner analysiert: in welchen Projekten Sie arbeiten, wie Sie Claude Code nutzen, wo Probleme auftreten und welche Funktionen Sie ausprobieren sollten. Nicht verfügbar in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web). Unter [Nutzungsmuster analysieren](/docs/de/costs#analyze-your-usage-patterns) finden Sie Speicherort, Aufbewahrung und Kosten des Berichts |106| `/insights` | Erstellt einen HTML-Bericht, der Ihre letzten Sitzungen auf diesem Rechner analysiert: in welchen Projekten Sie arbeiten, wie Sie Claude Code nutzen, wo Probleme auftreten und welche Funktionen Sie ausprobieren sollten. Nicht verfügbar in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web). Unter [Nutzungsmuster analysieren](/docs/de/costs#analyze-your-usage-patterns) finden Sie Speicherort, Aufbewahrung und Kosten des Berichts |

107| `/install-github-app` | Installiert die Claude GitHub App für ein Repository, mit einem optionalen Schritt zum Einrichten von [GitHub Actions](/docs/de/github-actions)-Workflows und -Secrets. Führt Sie durch die Auswahl eines Repositorys und die Konfiguration der Integration. Funktioniert nur mit github.com-Repositorys. Wenn das Git-Remote Ihres Repositorys auf gitlab.com oder bitbucket.org liegt, gibt der Befehl einen Hinweis aus und wird beendet, statt die Einrichtung zu starten. Um Claude Code aus GitLab-Pipelines auszuführen, siehe [GitLab CI/CD](/docs/de/gitlab-ci-cd) |107| `/install-github-app` | Installiert die Claude GitHub App für ein Repository, mit einem optionalen Schritt zum Einrichten von [GitHub Actions](/docs/de/github-actions)-Workflows und -Secrets. Führt Sie durch die Auswahl eines Repositorys und die Konfiguration der Integration. Funktioniert nur mit github.com-Repositorys. Wenn das Git-Remote Ihres Repositorys auf gitlab.com oder bitbucket.org liegt, gibt der Befehl einen Hinweis aus und wird beendet, statt die Einrichtung zu starten. Um Claude Code aus GitLab-Pipelines auszuführen, siehe [GitLab CI/CD](/docs/de/gitlab-ci-cd) |


153| `/statusline` | Konfiguriert die [Statuszeile](/docs/de/statusline) von Claude Code. Beschreiben Sie, was Sie möchten, oder führen Sie den Befehl ohne Argumente aus, um sie automatisch anhand Ihres Shell-Prompts zu konfigurieren |153| `/statusline` | Konfiguriert die [Statuszeile](/docs/de/statusline) von Claude Code. Beschreiben Sie, was Sie möchten, oder führen Sie den Befehl ohne Argumente aus, um sie automatisch anhand Ihres Shell-Prompts zu konfigurieren |

154| `/stickers` | Bestellen Sie Claude Code-Sticker |154| `/stickers` | Bestellen Sie Claude Code-Sticker |

155| `/stop` | Stoppt die [Hintergrundsitzung](/docs/de/agent-view), an die Sie angehängt sind, oder diejenige, an die Sie den Befehl als [Peek-Antwort](/docs/de/agent-view#peek-and-reply) senden; das Transkript und ein eventueller Worktree bleiben erhalten. Um die Verbindung zu trennen, ohne zu stoppen, verwenden Sie `/exit` oder drücken Sie `←` |155| `/stop` | Stoppt die [Hintergrundsitzung](/docs/de/agent-view), an die Sie angehängt sind, oder diejenige, an die Sie den Befehl als [Peek-Antwort](/docs/de/agent-view#peek-and-reply) senden; das Transkript und ein eventueller Worktree bleiben erhalten. Um die Verbindung zu trennen, ohne zu stoppen, verwenden Sie `/exit` oder drücken Sie `←` |

156| `/subtask <task>` | Startet einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation): einen Hintergrund-Subagenten, der die vollständige Konversation erbt und an der Aufgabe arbeitet, während Sie weiterarbeiten. Sein Ergebnis kehrt in diese Konversation zurück, wenn er fertig ist. Um die Konversation stattdessen in eine separate Hintergrundsitzung zu kopieren, verwenden Sie `/fork`. Erfordert Claude Code v2.1.212 oder höher; in v2.1.161 bis v2.1.211 heißt dieser Befehl `/fork`. Wenn [die Agent-Ansicht deaktiviert ist](/docs/de/agent-view#turn-off-agent-view), ist `/subtask` nicht verfügbar, und `/fork` behält das Verhalten des geforkten Subagenten bei |156| `/subtask <task>` | Startet einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation): einen Hintergrund-Subagenten, der die vollständige Konversation erbt und an der Aufgabe arbeitet, während Sie weiterarbeiten. Sein Ergebnis kehrt in diese Konversation zurück, wenn er fertig ist. Um die Konversation stattdessen in eine separate Hintergrundsitzung zu kopieren, verwenden Sie `/fork`. Wenn [die Agent-Ansicht deaktiviert ist](/docs/de/agent-view#turn-off-agent-view), ist `/subtask` nicht verfügbar, und `/fork` startet stattdessen den geforkten Subagenten |

157| `/tasks` | Zeigt Hintergrundarbeit in der aktuellen Sitzung an und verwaltet sie, einschließlich bereits abgeschlossener Subagenten. Auch als `/bashes` verfügbar |157| `/tasks` | Zeigt Hintergrundarbeit in der aktuellen Sitzung an und verwaltet sie, einschließlich bereits abgeschlossener Subagenten. Auch als `/bashes` verfügbar |

158| `/team-onboarding` | Erstellt einen Onboarding-Leitfaden für das Team aus Ihrem Claude Code-Nutzungsverlauf. Claude analysiert Ihre Sitzungen, Befehle und MCP-Server-Nutzung der letzten 30 Tage und erstellt einen markdown-Leitfaden, den ein Teammitglied als erste Nachricht einfügen kann, um schnell startklar zu sein. Für claude.ai-Abonnenten mit Pro-, Max-, Team- und Enterprise-Plänen wird außerdem ein Freigabelink zurückgegeben, den Teammitglieder direkt in Claude Code öffnen können |158| `/team-onboarding` | Erstellt einen Onboarding-Leitfaden für das Team aus Ihrem Claude Code-Nutzungsverlauf. Claude analysiert Ihre Sitzungen, Befehle und MCP-Server-Nutzung der letzten 30 Tage und erstellt einen markdown-Leitfaden, den ein Teammitglied als erste Nachricht einfügen kann, um schnell startklar zu sein. Für claude.ai-Abonnenten mit Team- und Enterprise-Plänen wird außerdem ein Freigabelink zurückgegeben, den Teammitglieder direkt in Claude Code öffnen können |

159| `/teleport` | Holt eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) in dieses Terminal. Öffnet eine Auswahl und ruft dann Branch und Konversation ab. Auch als `/tp` verfügbar. Erfordert ein claude.ai-Abonnement |159| `/teleport` | Holt eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) in dieses Terminal. Öffnet eine Auswahl und ruft dann Branch und Konversation ab. Auch als `/tp` verfügbar. Erfordert ein claude.ai-Abonnement |

160| `/terminal-setup` | [Installiert eine Shift+Enter-Tastenkombination für Zeilenumbrüche](/docs/de/terminal-config#enter-multiline-prompts) in VS Code, Cursor, Devin Desktop, Alacritty oder Zed. Im Apple Terminal wird stattdessen [Option+Enter für Zeilenumbrüche aktiviert und der akustische Signalton ausgeschaltet](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos). In iTerm2 wird [der Zugriff auf die Zwischenablage aktiviert, damit `/copy` funktioniert](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos) |160| `/terminal-setup` | [Installiert eine Shift+Enter-Tastenkombination für Zeilenumbrüche](/docs/de/terminal-config#enter-multiline-prompts) in VS Code, Cursor, Devin Desktop, Alacritty oder Zed. Im Apple Terminal wird stattdessen [Option+Enter für Zeilenumbrüche aktiviert und der akustische Signalton ausgeschaltet](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos). In iTerm2 wird [der Zugriff auf die Zwischenablage aktiviert, damit `/copy` funktioniert](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos) |

161| `/theme` | Ändert das Farbtheme. Enthält eine `auto`-Option, die sich an den hellen oder dunklen Hintergrund Ihres Terminals anpasst, helle und dunkle Varianten, für Farbenblinde zugängliche (daltonisierte) Themes, ANSI-Themes, die die Farbpalette Ihres Terminals verwenden, sowie alle [benutzerdefinierten Themes](/docs/de/terminal-config#create-a-custom-theme) aus `~/.claude/themes/` oder aus Plugins. Wählen Sie **New custom theme…**, um eines zu erstellen |161| `/theme` | Ändert das Farbtheme. Enthält eine `auto`-Option, die sich an den hellen oder dunklen Hintergrund Ihres Terminals anpasst, helle und dunkle Varianten, für Farbenblinde zugängliche (daltonisierte) Themes, ANSI-Themes, die die Farbpalette Ihres Terminals verwenden, sowie alle [benutzerdefinierten Themes](/docs/de/terminal-config#create-a-custom-theme) aus `~/.claude/themes/` oder aus Plugins. Wählen Sie **New custom theme…**, um eines zu erstellen |

Details

120Wenn der Launcher nicht ausgeführt werden kann, weigert sich Claude Code, den Prozess zu starten, anstatt ihn ohne Umhüllung zu starten. Unter Windows wird [die Variable ignoriert](#what-the-launcher-covers) und Prozesse starten ohne Umhüllung. Claude Code hält das Skript an diese Regeln:120Wenn der Launcher nicht ausgeführt werden kann, weigert sich Claude Code, den Prozess zu starten, anstatt ihn ohne Umhüllung zu starten. Unter Windows wird [die Variable ignoriert](#what-the-launcher-covers) und Prozesse starten ohne Umhüllung. Claude Code hält das Skript an diese Regeln:

121 121 

122* **Enden Sie mit `exec "$@"`**. Ein Launcher, der ein Kind forkt und beendet, hinterlässt einen verwaisten Claude-Code-Prozess, den der Hintergrunddienst nicht verfolgen kann. Agent View markiert eine solche Sitzung als fehlgeschlagen mit einer Nachricht, die den Launcher benennt, und der Dienst räumt auf, was der Launcher hinterlassen hat.122* **Enden Sie mit `exec "$@"`**. Ein Launcher, der ein Kind forkt und beendet, hinterlässt einen verwaisten Claude-Code-Prozess, den der Hintergrunddienst nicht verfolgen kann. Agent View markiert eine solche Sitzung als fehlgeschlagen mit einer Nachricht, die den Launcher benennt, und der Dienst räumt auf, was der Launcher hinterlassen hat.

123* **Ordnen Sie Argumente nicht neu an, absorbieren oder stellen Sie ihnen voran**. Das erste Argument ist die Claude-Code-Binärdatei und alles danach ist sein argv.123* **Ordnen Sie die Argumente von Claude Code nicht neu an, absorbieren Sie sie nicht und fügen Sie ihnen nichts hinzu**. Entfernen Sie die [eigenen Argumente](#pass-arguments-to-the-launcher) des Launchers, die zuerst kommen, und übergeben Sie den Rest so an `exec`, wie er angekommen ist.

124* **Geben Sie jede geerbte Umgebungsvariable an `exec` weiter**. Das Hinzufügen von Variablen, z. B. injizierte Anmeldedaten, ist in Ordnung; das Löschen geerbter ist nicht.124* **Geben Sie jede geerbte Umgebungsvariable an `exec` weiter**. Das Hinzufügen von Variablen, z. B. injizierte Anmeldedaten, ist in Ordnung; das Löschen geerbter ist nicht.

125 * Die Pro-Sitzungs-Authentifizierungstoken, die Modell- und Anbieterauswahl und `CLAUDE_CODE_PROCESS_WRAPPER` selbst reisen alle in der geerbten Umgebung, daher bricht ein Launcher, der sie aus einer Zulassungsliste neu erstellt, die Sitzungen, die er startet, und `/status` meldet eine Launcher-Nichtübereinstimmung.125 * Die Pro-Sitzungs-Authentifizierungstoken, die Modell- und Anbieterauswahl und `CLAUDE_CODE_PROCESS_WRAPPER` selbst reisen alle in der geerbten Umgebung, daher bricht ein Launcher, der sie aus einer Zulassungsliste neu erstellt, die Sitzungen, die er startet, und `/status` meldet eine Launcher-Nichtübereinstimmung.

126 * Wenn der Launcher einen Namespace oder eine Sandbox betreten muss, die die Umgebung zurückgesetzt, exportieren Sie die geerbte Umgebung darin wörtlich erneut.126 * Wenn der Launcher einen Namespace oder eine Sandbox betreten muss, die die Umgebung zurückgesetzt, exportieren Sie die geerbte Umgebung darin wörtlich erneut.

127* **Erreichen Sie `exec` innerhalb von etwa drei Sekunden jedes Mal, wenn der Launcher ausgeführt wird**. Ein kalter Hintergrund-Dispatch führt den Launcher zweimal hintereinander aus, bevor das erste Byte der Ausgabe, daher führen Sie langsame Arbeiten wie einen Single-Sign-On-Austausch träge oder aus einem Cache durch.127* **Erreichen Sie `exec` innerhalb von etwa drei Sekunden jedes Mal, wenn der Launcher ausgeführt wird**. Eine Hintergrundsitzung kann den Launcher vor ihrer ersten Ausgabe dreimal hintereinander ausführen. Führen Sie langsame Arbeiten wie einen Single-Sign-On-Austausch verzögert oder aus einem Cache durch, und geben Sie jedem Schritt, der auf das Netzwerk wartet, ein eigenes Zeitlimit.

128* **Tolerieren Sie, dass Sie von innen aufgerufen werden**. Claude Code wendet den Launcher auf jeden verschachtelten Self-Spawn an, daher muss ein Launcher, der eine exklusive Ressource erwirbt, erkennen, dass er sie bereits hält.128* **Tolerieren Sie, dass Sie von innen aufgerufen werden**. Claude Code wendet den Launcher auf jeden verschachtelten Self-Spawn an, daher muss ein Launcher, der eine exklusive Ressource erwirbt, erkennen, dass er sie bereits hält.

129* **Schreiben Sie nicht auf das Terminal, bevor Claude Code startet**. Alles, das vor dem `exec` gedruckt wird, wird als Absturzursache gemeldet, wenn die Sitzung vor der Initialisierung stirbt.129* **Schreiben Sie nicht auf das Terminal oder die Standardausgabe, bevor Claude Code startet**. Alles, was vor dem `exec` ausgegeben wird, wird als Absturzursache gemeldet, wenn die Sitzung vor der Initialisierung abbricht. Text auf der Standardausgabe erreicht außerdem ein Programm, das die Ausgabe von Claude Code liest, z. B. ein Skript, das die Ergebnisse von `claude -p` parst.

130* **Verlassen Sie sich nicht darauf, wie Argumente geschrieben werden**. Der Wert eines Flags kann als eigenes Argument ankommen, `--flag value`, oder mit dem Flag verbunden, `--flag=value`. Welche Form ein Flag verwendet, kann sich zwischen Versionen ändern.130* **Verlassen Sie sich nicht darauf, wie Argumente geschrieben werden**. Der Wert eines Flags kann als eigenes Argument ankommen, `--flag value`, oder mit dem Flag verbunden, `--flag=value`. Welche Form ein Flag verwendet, kann sich zwischen Versionen ändern.

131* **Führen Sie `exec` aus dem Verzeichnis aus, in dem der Launcher gestartet wurde**. Claude Code arbeitet in dem Verzeichnis, in dem es startet, daher kann ein Launcher, der das Verzeichnis wechselt, eine Sitzung im falschen Projekt starten. Wenn der Launcher einen Namespace oder eine Sandbox betreten muss, die das Arbeitsverzeichnis zurücksetzt, wechseln Sie darin vor dem `exec` zurück in das Startverzeichnis.131* **Führen Sie `exec` aus dem Verzeichnis aus, in dem der Launcher gestartet wurde**. Claude Code arbeitet in dem Verzeichnis, in dem es startet, daher kann ein Launcher, der das Verzeichnis wechselt, eine Sitzung im falschen Projekt starten. Wenn der Launcher einen Namespace oder eine Sandbox betreten muss, die das Arbeitsverzeichnis zurücksetzt, wechseln Sie darin vor dem `exec` zurück in das Startverzeichnis.

132* **Lesen Sie nicht von der Standardeingabe**. Ein Befehl, der sie vor dem `exec` liest, z. B. einer, der nach einem Passwort fragt, kann auf Eingaben warten, die nicht kommen, und die Sitzung hängen lassen. Er kann außerdem Eingaben abgreifen, die für Claude Code bestimmt sind, sodass die Sitzung ohne diese Eingaben läuft und keinen Fehler meldet. Leiten Sie die Eingabe eines solchen Befehls von `/dev/null` um.

133* **Rufen Sie andere Programme über ihren absoluten Pfad auf**. Der Launcher kann mit einem `PATH` starten, dem die Verzeichnisse fehlen, die Ihr Shell-Profil hinzufügt.

132 134 

133<h3 id="format-of-the-launcher-value">135<h3 id="format-of-the-launcher-value">

134 Format des Launcher-Wertes136 Format des Launcher-Wertes


138 140 

139Um Ihrem Launcher eigene Argumente zu übergeben, schreiben Sie sie nach dem Pfad. Claude Code analysiert den Wert als Argumentliste, nicht als Shell-Befehl:141Um Ihrem Launcher eigene Argumente zu übergeben, schreiben Sie sie nach dem Pfad. Claude Code analysiert den Wert als Argumentliste, nicht als Shell-Befehl:

140 142 

141* Whitespace trennt Token, und doppelte Anführungszeichen gruppieren ein Token, das Leerzeichen enthält.143* Whitespace trennt Token, und doppelte Anführungszeichen gruppieren ein Token, das Leerzeichen enthält. Ein einfaches Anführungszeichen ist ein gewöhnliches Zeichen, daher ergibt `'a b'` zwei Token.

142* Ein Wert, der mit `[` beginnt, wird als JSON-String-Array gelesen, z. B. `["/opt/corp/launcher", "--profile", "cc"]`.144* Ein Wert, der mit `[` beginnt, wird als JSON-String-Array gelesen, z. B. `["/opt/corp/launcher", "--profile", "cc"]`.

143* Shell-Syntax funktioniert nicht: Es gibt keine Variablenerweiterung oder Globbing, und ein unquotierter Operator wie `;`, `|`, `&` oder `$(` wird als Konfigurationsfehler abgelehnt, anstatt neu interpretiert zu werden.145* Shell-Syntax funktioniert nicht: Es gibt keine Variablenerweiterung oder Globbing, und ein unquotierter Operator wie `;`, `|`, `&` oder `$(` wird als Konfigurationsfehler abgelehnt, anstatt neu interpretiert zu werden.

144 146 

145Wenn der Wert nicht verwendet werden kann, weigert sich Claude Code, den betroffenen Prozess zu starten, und [meldet den Grund](/docs/de/errors#claude_code_process_wrapper-launcher-errors).147Wenn der Wert nicht verwendet werden kann, weigert sich Claude Code, den betroffenen Prozess zu starten, und [meldet den Grund](/docs/de/errors#claude_code_process_wrapper-launcher-errors).

146 148 

149Schreiben Sie in einer Einstellungsdatei die Array-Form innerhalb eines JSON-Strings und maskieren Sie deren Anführungszeichen: `"[\"/opt/corp/launcher\", \"--profile\", \"cc\"]"`.

150 

151<h3 id="pass-arguments-to-the-launcher">

152 Argumente an den Launcher übergeben

153</h3>

154 

155Schreiben Sie die eigenen Argumente des Launchers nach seinem Pfad in [den Wert](#format-of-the-launcher-value), und entfernen Sie sie im Skript vor dem `exec`-Aufruf. Sie erreichen das Skript zuerst, vor dem Claude-Code-Befehl. Das folgende Skript, geschrieben für den Wert `/opt/corp/launcher --profile cc`, speichert den Profilnamen und entfernt dann beide Argumente mit `shift`:

156 

157```bash theme={null}

158#!/bin/sh

159if [ "$1" = "--profile" ]; then

160 profile="$2"

161 shift 2

162fi

163# Your organization's setup for "$profile".

164exec "$@"

165```

166 

167Verwenden Sie den [Überprüfungsschritt](#set-up-the-launcher), um den Startbefehl zu sehen, den Claude Code aus dem Wert ermittelt hat.

168 

147<h2 id="relationship-to-claude_code_shell_prefix">169<h2 id="relationship-to-claude_code_shell_prefix">

148 Beziehung zu `CLAUDE_CODE_SHELL_PREFIX`170 Beziehung zu `CLAUDE_CODE_SHELL_PREFIX`

149</h2>171</h2>

desktop.md +330 −68

Details

44 Sitzung starten44 Sitzung starten

45</h2>45</h2>

46 46 

47Bevor Sie Ihre erste Nachricht senden, konfigurieren Sie vier Dinge im Eingabebereich:47Bevor Sie Ihre erste Nachricht senden, wählen Sie in der Zeile unter dem Eingabefeld die Umgebung, den Projektordner, den Berechtigungsmodus und das Modell aus:

48 48 

49* **Umgebung**: Wählen Sie, wo Claude ausgeführt wird. Wählen Sie **Lokal** für Ihren Computer, **Cloud** für eine [Cloud-Sitzung](#cloud-sessions), die nach dem Schließen der App fortgesetzt wird, eine [**SSH-Verbindung**](#ssh-sessions) für einen von Ihnen verwalteten Remote-Computer oder unter Windows eine [**WSL-Distribution**](/docs/de/desktop-wsl). Eine Aufgabe in einer SSH-Sitzung kann [weiterlaufen, während Desktop getrennt ist](#keep-a-task-running-while-desktop-is-disconnected), kann bei einem Claude-Konto jedoch anhalten, wenn dessen Anmeldung abläuft. Siehe [Umgebungskonfiguration](#environment-configuration).49* **Umgebung**: Wählen Sie mit der Umgebungsauswahl, dem ersten Steuerelement in der Zeile, wo Claude ausgeführt wird. Siehe [Umgebungskonfiguration](#environment-configuration).

50* **Projektordner**: Wählen Sie den Ordner oder das Repository aus, in dem Claude arbeitet. Für Cloud-Sitzungen können Sie [mehrere Repositories](#run-long-running-tasks-in-the-cloud) hinzufügen.50 * Wenn eine neue Sitzung keine Umgebungsauswahl unter dem Eingabefeld hat, folgen Sie den [Schritten für das frühere Layout](#check-which-layout-you-have).

51* **Modell**: Wählen Sie ein [Modell](/docs/de/model-config#available-models) aus dem Dropdown neben der Schaltfläche „Senden“. Sie können dies während der Sitzung ändern.51* **Projektordner**: Klicken Sie auf das Steuerelement für den Projektordner neben der Umgebungsauswahl, um den Ordner auszuwählen, in dem Claude arbeitet.

52* **Berechtigungsmodus**: Wählen Sie, wie viel Autonomie Claude aus dem [Moduswahlschalter](#choose-a-permission-mode) hat. Sie können dies während der Sitzung ändern.52 * **Cloud-Sitzung**: Wählen Sie statt eines Ordners [Repositorys](#run-long-running-tasks-in-the-cloud) aus

53 * **[Gespeicherte lokale oder SSH-Umgebung](#create-a-saved-environment)**: Die Umgebung enthält ihre Ordner bereits, daher zeigt die Zeile kein Steuerelement für den Projektordner an. Um die Ordner zu ändern, [bearbeiten Sie die Umgebung](#use-edit-or-remove-a-saved-environment).

54* **Berechtigungsmodus**: Wählen Sie mit dem [Moduswahlschalter](#choose-a-permission-mode), wie viel Autonomie Claude hat. Sie können den Berechtigungsmodus während der Sitzung ändern.

55* **Modell**: Wählen Sie ein [Modell](/docs/de/model-config#available-models) in der Modellauswahl am rechten Ende der Zeile aus. Sie können das Modell während der Sitzung ändern.

53 56 

54Geben Sie Ihre Aufgabe ein und drücken Sie **Eingabe**, um zu starten. Jede Sitzung verfolgt ihren eigenen Kontext und Änderungen unabhängig.57Geben Sie Ihre Aufgabe ein und drücken Sie **Eingabe**, um zu starten. Jede Sitzung verfolgt ihren eigenen Kontext und Änderungen unabhängig.

55 58 


82 Fügen Sie Dateien und Kontext zu Eingaben hinzu85 Fügen Sie Dateien und Kontext zu Eingaben hinzu

83</h3>86</h3>

84 87 

85Das Eingabefeld unterstützt zwei Möglichkeiten, um externen Kontext einzubinden:88Um Claude eine Datei zu geben, erwähnen Sie sie per @mention oder hängen Sie sie im Eingabefeld an:

86 89 

87* **@mention-Dateien**: Geben Sie `@` gefolgt von einem Dateinamen ein, um eine Datei zum Gesprächskontext hinzuzufügen. Claude kann diese Datei dann lesen und referenzieren. @mention ist nicht in Cloud-Sitzungen und WSL-Sitzungen verfügbar.90* **@mention-Dateien**: Geben Sie `@` gefolgt von einem Dateinamen ein, um eine Datei zum Konversationskontext hinzuzufügen.

88* **Dateien anhängen**: Hängen Sie Bilder, PDFs und andere Dateien an Ihre Eingabe an, indem Sie die Schaltfläche „Anhängen“ verwenden, oder ziehen Sie Dateien direkt in die Eingabe. Dies ist nützlich zum Teilen von Screenshots von Fehlern, Design-Mockups oder Referenzdokumenten.91 * **In einer Cloud-Sitzung**: `@` kann Dateien erst auflisten, nachdem Sie Ihre erste Nachricht gesendet haben. Wenn `@` keine Dateien auflistet, senden Sie Ihre erste Nachricht ohne die Datei und erwähnen Sie die Datei dann per @mention in Ihrer nächsten Nachricht.

92* **Dateien anhängen**: Hängen Sie Bilder, PDFs und andere Dateien über die Schaltfläche **+** neben dem Eingabefeld an Ihren Prompt an, oder ziehen Sie Dateien direkt in den Prompt. Dies ist nützlich zum Teilen von Screenshots von Fehlern, Design-Mockups oder Referenzdokumenten.

93 * **In einer [WSL-Sitzung](/docs/de/desktop-wsl)**: Wenn das Menü **+** **Add image** statt **Add files or photos** anzeigt, können Sie nur Bilder anhängen. Um Claude eine andere Datei aus dem Ordner der Sitzung zu geben, erwähnen Sie sie per @mention.

89 94 

90<h3 id="choose-a-permission-mode">95<h3 id="choose-a-permission-mode">

91 Wählen Sie einen Berechtigungsmodus96 Wählen Sie einen Berechtigungsmodus

92</h3>97</h3>

93 98 

94Berechtigungsmodi kontrollieren, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, dem Ausführen von Befehlen oder beidem fragt. Sie können Modi jederzeit mit dem Moduswahlschalter neben der Schaltfläche „Senden“ wechseln. Um jede Änderung selbst zu genehmigen, wechseln Sie zu Manual.99Berechtigungsmodi kontrollieren, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, dem Ausführen von Befehlen oder beidem fragt. Sie können Berechtigungsmodi jederzeit mit dem Moduswahlschalter in der Zeile unter dem Eingabefeld wechseln. Um jede Änderung selbst zu genehmigen, wechseln Sie zu Manual.

95 100 

96Um einen Standardmodus für neue lokale Sitzungen festzulegen, fügen Sie `permissions.defaultMode` zu Ihrer [Einstellungsdatei](/docs/de/settings#where-settings-live) hinzu. Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI. Ein Modus, den Sie im Wahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner, außer Plan, das nur für die aktuelle Sitzung gilt.101Um einen Standardmodus für neue lokale Sitzungen festzulegen, fügen Sie `permissions.defaultMode` zu Ihrer [Einstellungsdatei](/docs/de/settings#where-settings-live) hinzu. Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI. Ein Modus, den Sie im Wahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner, außer Plan, das nur für die aktuelle Sitzung gilt.

97 102 


129 134 

130Claude kann einen Dev-Server starten und ihn im Browser-Pane öffnen, um seine Änderungen zu überprüfen. Dies funktioniert sowohl für Frontend-Web-Apps als auch für Backend-Server: Claude kann API-Endpunkte testen, Server-Logs anzeigen und Probleme, die er findet, iterieren. In den meisten Fällen startet Claude den Server automatisch nach dem Bearbeiten von Projektdateien. Sie können Claude auch jederzeit bitten, eine Vorschau anzuzeigen. Standardmäßig [überprüft Claude automatisch](#auto-verify-changes) Änderungen nach jeder Bearbeitung.135Claude kann einen Dev-Server starten und ihn im Browser-Pane öffnen, um seine Änderungen zu überprüfen. Dies funktioniert sowohl für Frontend-Web-Apps als auch für Backend-Server: Claude kann API-Endpunkte testen, Server-Logs anzeigen und Probleme, die er findet, iterieren. In den meisten Fällen startet Claude den Server automatisch nach dem Bearbeiten von Projektdateien. Sie können Claude auch jederzeit bitten, eine Vorschau anzuzeigen. Standardmäßig [überprüft Claude automatisch](#auto-verify-changes) Änderungen nach jeder Bearbeitung.

131 136 

132Das Browser-Pane kann auch statische HTML-Dateien, PDFs, Bilder und Videos aus Ihrem Projekt öffnen. Klicken Sie auf einen HTML-, PDF-, Bild- oder Videopfad im Chat, um ihn dort zu öffnen.137Klicken Sie in einer lokalen Sitzung auf einen HTML-, PDF- oder Videopfad im Chat, um ihn im Browser-Pane zu öffnen.

133 138 

134<Note>139<Note>

135 In einer [SSH-Sitzung](#ssh-sessions) kann Claude Ihre App nicht im Browser-Pane öffnen, da es dort nicht über die Tools des Panes verfügt. Um sich die App selbst anzusehen, [leiten Sie ihren Port an Ihren Computer weiter](#reach-a-port-on-the-remote-machine).140 In einer [SSH-Sitzung](#ssh-sessions) kann Claude Ihre App nicht im Browser-Pane öffnen, da es dort nicht über die Tools des Panes verfügt. Um sich die App selbst anzusehen, [leiten Sie ihren Port an Ihren Computer weiter](#reach-a-port-on-the-remote-machine).

136</Note>141</Note>

137 142 

143Wenn das Browser-Pane nicht geöffnet ist, nachdem Claude in einer lokalen Sitzung einen Server gestartet hat, klicken Sie im Chat auf der Karte des Servers auf **Open**.

144 

138Aus dem Browser-Pane können Sie:145Aus dem Browser-Pane können Sie:

139 146 

140* Direkt im Browser-Pane mit Ihrer laufenden App interagieren147* Direkt im Browser-Pane mit Ihrer laufenden App interagieren


185 Überprüfen Sie Änderungen mit der Diff-Ansicht192 Überprüfen Sie Änderungen mit der Diff-Ansicht

186</h3>193</h3>

187 194 

188Nachdem Claude Änderungen an Ihrem Code vorgenommen hat, können Sie mit der Diff-Ansicht Änderungen dateiweise überprüfen, bevor Sie einen Pull Request erstellen.195Nachdem Claude Änderungen an Ihrem Code vorgenommen hat, können Sie mit der Diff-Ansicht Änderungen dateiweise überprüfen, bevor Sie einen Pull Request erstellen. Um die Diff-Ansicht zu öffnen, klicken Sie auf die Zeilenzahlen, z. B. `+12 -1`, in der Karte **Changes** des [Sitzungsdetails-Bereichs](#see-session-details). Sie können auch in der Titelleiste der Sitzung auf **Changes** klicken.

189 

190Wenn Claude Dateien ändert, wird ein Diff-Statistik-Indikator angezeigt, der die Anzahl der hinzugefügten und entfernten Zeilen anzeigt, z. B. `+12 -1`. Klicken Sie auf diesen Indikator, um den Diff-Viewer zu öffnen, der eine Dateiliste auf der linken Seite und die Änderungen für jede Datei auf der rechten Seite anzeigt.

191 196 

192Um Kommentare zu bestimmten Zeilen hinzuzufügen, klicken Sie auf eine beliebige Zeile im Diff, um ein Kommentarfeld zu öffnen. Geben Sie Ihr Feedback ein und drücken Sie **Eingabe**, um den Kommentar hinzuzufügen. Nach dem Hinzufügen von Kommentaren zu mehreren Zeilen senden Sie alle Kommentare auf einmal:197Um Kommentare zu bestimmten Zeilen hinzuzufügen, klicken Sie auf eine beliebige Zeile im Diff, um ein Kommentarfeld zu öffnen. Geben Sie Ihr Feedback ein und drücken Sie **Eingabe**, um den Kommentar hinzuzufügen. Nach dem Hinzufügen von Kommentaren zu mehreren Zeilen senden Sie alle Kommentare auf einmal:

193 198 


213 Überwachen Sie den Pull-Request-Status218 Überwachen Sie den Pull-Request-Status

214</h3>219</h3>

215 220 

216Nachdem Sie einen Pull Request öffnen, wird eine CI-Statusleiste in der Sitzung angezeigt. Claude Code verwendet die GitHub CLI, um Prüfergebnisse abzurufen und Fehler anzuzeigen.221Damit Claude fehlgeschlagene Prüfungen behebt oder GitHub den Pull Request mergt, aktivieren Sie **Auto-fix** oder **Merge when ready**. Nachdem Sie einen Pull Request geöffnet haben, wird er in der Karte **Changes** des [Sitzungsdetails-Bereichs](#see-session-details) mit dem Status seiner CI-Prüfungen angezeigt. Öffnen Sie das **⋮**-Menü neben seinem Titel:

217 222 

218* **Auto-fix CI & address comments**: Wenn aktiviert, versucht Claude automatisch, fehlgeschlagene CI-Prüfungen zu beheben, indem es die Fehlerausgabe liest und iteriert. In einer lokalen Sitzung geht Claude außerdem auf neue Review-Kommentare ein, die jemand anderes als Sie hinterlässt, sofern der Autor der Eigentümer des Repositorys, ein Organisationsmitglied, ein Collaborator oder eine GitHub App ist.223* **Auto-fix**: In einer lokalen Sitzung geht Claude außerdem auf neue Review-Kommentare ein, die jemand anderes als Sie hinterlässt. Der Autor des Kommentars muss der Eigentümer des Repositorys, ein Organisationsmitglied, ein Collaborator oder eine GitHub App sein.

219* **Auto-merge when ready**: Wenn aktiviert, mergt Claude den PR, sobald alle Prüfungen bestanden sind. Die Merge-Methode ist Squash. Aktivieren Sie Auto-merge zuerst in Ihren [GitHub-Repository-Einstellungen](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository); ohne diese Einstellung kann Claude den PR nicht mergen.224* **Merge when ready**: Aktiviert GitHubs Auto-Merge für den PR. In einer lokalen Sitzung fordert Desktop einen Squash-Merge an, sofern der Basis-Branch keine Merge-Queue verwendet.

225 * **In SSH- und WSL-Sitzungen**: **Merge when ready** ist deaktiviert, aktivieren Sie daher Auto-Merge für den Pull Request auf GitHub

226 * **Wenn das Repository kein Auto-Merge zulässt**: **Merge when ready** lässt sich nicht aktivieren, aktivieren Sie daher zuerst Auto-Merge in Ihren [GitHub-Repository-Einstellungen](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)

227* **[Früheres Layout](#check-which-layout-you-have)**: Sobald die Sitzung einen Pull Request hat, klicken Sie in ihrer Statusleiste auf **CI**.

220 228 

221Um diese Optionen zu aktivieren, klicken Sie in der Statusleiste auf **CI**. Um die Sitzung automatisch zu archivieren, sobald der PR gemergt oder geschlossen wird, aktivieren Sie [auto-archive](#work-in-parallel-with-sessions) unter **Settings > Claude Code**.229Um die Sitzung automatisch zu archivieren, sobald der PR gemergt oder geschlossen wird, aktivieren Sie [auto-archive](#archive-a-session) unter **Settings > Claude Code**.

222 230 

223<Note>231<Note>

224 Die PR-Überwachung erfordert, dass die [GitHub CLI (`gh`)](https://cli.github.com/) auf Ihrem Computer installiert und authentifiziert ist. Wenn `gh` nicht installiert ist, fordert Desktop Sie auf, es beim ersten Versuch, einen PR zu erstellen, zu installieren.232 Die PR-Überwachung erfordert, dass die [GitHub CLI (`gh`)](https://cli.github.com/) auf Ihrem Computer installiert und authentifiziert ist. Wenn `gh` nicht installiert ist, fordert Desktop Sie auf, es beim ersten Versuch, einen PR zu erstellen, zu installieren.


238 Das Pane-Layout, Terminal, Datei-Editor und Ansichtsmodi in diesem Abschnitt erfordern Claude Desktop v1.2581.0 oder später. Öffnen Sie **Claude → Nach Updates suchen** auf macOS oder **Hilfe → Nach Updates suchen** auf Windows, um zu aktualisieren.246 Das Pane-Layout, Terminal, Datei-Editor und Ansichtsmodi in diesem Abschnitt erfordern Claude Desktop v1.2581.0 oder später. Öffnen Sie **Claude → Nach Updates suchen** auf macOS oder **Hilfe → Nach Updates suchen** auf Windows, um zu aktualisieren.

239</Note>247</Note>

240 248 

249<h3 id="see-session-details">

250 Sitzungsdetails anzeigen

251</h3>

252 

253Das 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.

254 

255<h4 id="hide-or-show-the-session-details-panel">

256 Sitzungsdetails-Panel aus- oder einblenden

257</h4>

258 

259Um das Panel aus- oder einzublenden, klicken Sie in der Titelleiste der Sitzung auf **Sitzungsleiste ausblenden** oder **Sitzungsleiste einblenden**, oder im Menü **⋮** der Leiste, wenn das Fenster schmal ist. Wenn Sie das Panel weiterhin nicht sehen, [prüfen Sie, welches Layout der Code-Registerkarte Sie haben](#check-which-layout-you-have).

260 

241<h3 id="run-commands-in-the-terminal">261<h3 id="run-commands-in-the-terminal">

242 Führen Sie Befehle im Terminal aus262 Führen Sie Befehle im Terminal aus

243</h3>263</h3>

244 264 

245Das integrierte Terminal ermöglicht es Ihnen, Befehle neben Ihrer Sitzung auszuführen, ohne zu einer anderen App zu wechseln. Klicken Sie in der Titelleiste der Sitzung auf **Terminal** oder drücken Sie **Ctrl+\`** auf macOS oder Windows. Das Terminal öffnet sich im Arbeitsverzeichnis Ihrer Sitzung und teilt die gleiche Umgebung wie Claude, sodass Befehle wie `npm test` oder `git status` die gleichen Dateien sehen, die Claude bearbeitet. Um eine zweite Terminal-Registerkarte zu öffnen, klicken Sie auf **+** in der Terminal-Pane-Kopfzeile oder klicken Sie mit der rechten Maustaste auf einen Ordner im Chat, um **Im Terminal öffnen** zu wählen.265Das integrierte Terminal ermöglicht es Ihnen, Befehle neben Ihrer Sitzung auszuführen, ohne zu einer anderen App zu wechseln. Klicken Sie in der Titelleiste der Sitzung auf **Terminal** oder drücken Sie **Ctrl+\`** auf macOS oder Windows. Das Terminal öffnet sich im Arbeitsverzeichnis Ihrer Sitzung und teilt die gleiche Umgebung wie Claude, sodass Befehle wie `npm test` oder `git status` die gleichen Dateien sehen, die Claude bearbeitet. Um eine zweite Terminal-Registerkarte zu öffnen, klicken Sie auf **+** in der Terminal-Pane-Kopfzeile oder klicken Sie mit der rechten Maustaste auf einen Ordner im Chat, um **Im Terminal öffnen** zu wählen.

246 266 

247Das Terminal ist in lokalen und [SSH](#ssh-sessions)-Sitzungen verfügbar, mit einer Einschränkung auf [Windows-Remote-Rechnern](#windows-remote-machines).267Wenn eine WSL-Sitzung kein Terminal hat, lesen Sie [Wenn das Terminal oder Konnektoren nicht verfügbar sind](/docs/de/desktop-wsl#check-for-the-terminal-and-connectors). Das Terminal ist in lokalen und [SSH](#ssh-sessions)-Sitzungen verfügbar, mit einer Einschränkung auf [Windows-Remote-Rechnern](#windows-remote-machines).

248 268 

249<h3 id="open-and-edit-files">269<h3 id="open-and-edit-files">

250 Öffnen und bearbeiten Sie Dateien270 Öffnen und bearbeiten Sie Dateien

251</h3>271</h3>

252 272 

253Klicken Sie auf einen Dateipfad im Chat oder Diff-Viewer, um ihn im Datei-Pane zu öffnen. HTML-, PDF-, Bild- und Videopfade öffnen sich stattdessen im [Browser-Pane](#preview-your-app). Nehmen Sie Spot-Bearbeitungen vor und klicken Sie auf **Speichern**, um sie zurückzuschreiben. Wenn sich die Datei auf der Festplatte geändert hat, seit Sie sie geöffnet haben, warnt Sie das Pane und lässt Sie überschreiben oder verwerfen. Klicken Sie auf **Verwerfen**, um Ihre Bearbeitungen rückgängig zu machen, oder klicken Sie auf den Pfad in der Pane-Kopfzeile, um den absoluten Pfad zu kopieren.273Um eine Datei zu öffnen, die Claude erwähnt, klicken Sie im Chat auf ihren Pfad.

254 274 

255Das Datei-Pane ist in lokalen und SSH-Sitzungen verfügbar. Für Cloud-Sitzungen bitten Sie Claude, die Änderung vorzunehmen.275Um eine Datei selbst zu bearbeiten, verwenden Sie das [Datei-Pane](#arrange-your-workspace):

276 

277* **Lokale Sitzungen**: Sie können Dateien im Arbeitsverzeichnis der Sitzung bearbeiten, mit Ausnahme einiger schreibgeschützter Dateien wie `.mcp.json` und `.claude/settings.json`. Um eine davon zu ändern, [öffnen Sie sie in einer anderen App](#open-files-in-other-apps).

278* **Cloud-, SSH- und WSL-Sitzungen**: Das Datei-Pane ist schreibgeschützt, bitten Sie daher Claude, die Änderungen vorzunehmen.

279 

280<h4 id="save-edits-in-the-file-pane">

281 Bearbeitungen im Datei-Pane speichern

282</h4>

283 

284Standardmäßig werden Ihre Bearbeitungen im Datei-Pane automatisch gespeichert, daher zeigt das Pane keine Schaltfläche **Speichern** an. Um Ihre Bearbeitungen selbst zu speichern, deaktivieren Sie **Automatisch speichern** im Menü **⋮** des Panes. Wenn **Automatisch speichern** deaktiviert ist, klicken Sie nach dem Ändern einer Datei auf **Speichern**, um Ihre Bearbeitungen zu schreiben, oder auf **Abbrechen**, um sie rückgängig zu machen.

285 

286Wenn das Pane warnt, dass sich die Datei auf der Festplatte geändert hat, klicken Sie auf **Überschreiben**, um die Version auf der Festplatte mit Ihren Bearbeitungen zu überschreiben, oder auf **Verwerfen**, um Ihre Bearbeitungen zu verwerfen.

256 287 

257<h3 id="open-files-in-other-apps">288<h3 id="open-files-in-other-apps">

258 Öffnen Sie Dateien in anderen Apps289 Öffnen Sie Dateien in anderen Apps


283 Tastenkombinationen314 Tastenkombinationen

284</h3>315</h3>

285 316 

286Drücken Sie **Cmd+/** auf macOS oder **Ctrl+/** auf Windows, um alle im Code-Tab verfügbaren Kürzel zu sehen. Unter Windows verwenden Sie **Ctrl** anstelle von **Cmd** für die folgenden Kürzel. Sitzungs-Zyklisierung, Terminal-Umschalter und Ansichtsmodus-Umschalter verwenden **Ctrl** auf jeder Plattform.317Drücken Sie **Cmd+/** auf macOS oder **Ctrl+/** auf Windows, um alle in der Code-Registerkarte verfügbaren Tastenkombinationen zu sehen. Die Tabelle in diesem Abschnitt zeigt die macOS-Tasten. Ersetzen Sie unter Windows und Linux diese Tasten:

318 

319* **Cmd+Option**: Drücken Sie **Alt**

320* **Cmd**: Drücken Sie **Ctrl**

321 

322Sitzungs-Zyklisierung, Terminal-Umschalter und Ansichtsmodus-Umschalter verwenden **Ctrl** auf jeder Plattform.

287 323 

288| Kürzel | Aktion |324| Kürzel | Aktion |

289| - | - |325| - | - |

290| `Cmd` `/` | Tastenkombinationen anzeigen |326| `Cmd` `/` | Tastenkombinationen anzeigen |

291| `Cmd` `N` | Neue Sitzung |327| `Cmd` `N` | Neue Sitzung |

328| `Cmd` `Option` `1`–`9` | Auf dem Bildschirm für neue Sitzungen im [aktuellen Layout](#check-which-layout-you-have) eine Umgebung auswählen |

329| `Cmd` `Option` `0` | Auf dem Bildschirm für neue Sitzungen im aktuellen Layout den [Dialog **Neue Umgebung**](#create-a-saved-environment) öffnen |

292| `Cmd` `W` | Sitzung schließen |330| `Cmd` `W` | Sitzung schließen |

293| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Nächste oder vorherige Sitzung |331| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Nächste oder vorherige Sitzung |

294| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Nächste oder vorherige Sitzung |332| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Nächste oder vorherige Sitzung |


404 Arbeiten Sie parallel mit Sitzungen442 Arbeiten Sie parallel mit Sitzungen

405</h3>443</h3>

406 444 

407Klicken Sie auf **+ Neue Sitzung** 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. Für Git-Repositories wählen Sie die **worktree**-Option neben dem Branch-Namen, um der Sitzung ihre eigene isolierte Kopie Ihres Projekts mit [Git worktrees](/docs/de/worktrees) zu geben.445Klicken 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.

408 446 

409Um 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.447Um 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.

410 448 

411Worktrees werden standardmäßig in `<project-root>/.claude/worktrees/` gespeichert. Sie können dies in ein benutzerdefiniertes Verzeichnis ändern:449<h4 id="run-a-session-in-its-own-worktree">

450 Eine Sitzung in einem eigenen Worktree ausführen

451</h4>

452 

453Aktivieren 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**.

454 

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

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

457 

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

412 459 

413* **Lokale Sitzungen**: Legen Sie **Worktree-Speicherort** in **Einstellungen > Claude Code** fest460* **Lokale Sitzungen**: Legen Sie **Worktree-Speicherort** in **Einstellungen > Claude Code** fest

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

415 462 

416Sie 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.463Sie 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.

417 464 

418Um einen Worktree zu entfernen, wenn Sie fertig sind, fahren Sie mit der Maus über die Sitzung in der Seitenleiste und klicken Sie auf das Archiv-Symbol. Um 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. Auto-Archivieren gilt nur für lokale Sitzungen, die beendet wurden.

419 

420Um 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.465Um 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.

421 466 

422<Note>467<Note>

423 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.468 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.

424</Note>469</Note>

425 470 

426Verwenden Sie die Steuerelemente oben in der Seitenleiste, um Sitzungen nach Status, Projekt oder Umgebung zu filtern, und um Sitzungen nach Projekt zu gruppieren. Um eine Sitzung umzubenennen, klicken Sie auf den Sitzungstitel in der Symbolleiste oben in der aktiven Sitzung.471<h3 id="add-folders-to-a-session">

472 Ordner zu einer Sitzung hinzufügen

473</h3>

474 

475Fügen Sie Ordner hinzu, bevor die Sitzung startet oder während sie läuft:

476 

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

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

479 

480<h3 id="archive-a-session">

481 Eine Sitzung archivieren

482</h3>

483 

484Bevor 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.

485 

486Um 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.

487 

488<h4 id="keep-uncommitted-changes-when-a-session-is-archived">

489 Nicht committete Änderungen beim Archivieren einer Sitzung behalten

490</h4>

491 

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

493 

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

495* **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 kann

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

497 

498<h3 id="organize-and-find-sessions">

499 Sitzungen organisieren und finden

500</h3>

501 

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

503 

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

505* **[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**.

506 

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

508 

509<h3 id="check-and-free-up-context">

510 Kontext überprüfen und freigeben

511</h3>

427 512 

428Um 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.513Um 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.

429 514 

515<h3 id="get-notified-when-a-session-finishes">

516 Benachrichtigung erhalten, wenn eine Sitzung abgeschlossen ist

517</h3>

518 

430Die 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.519Die 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.

431 520 

432<h3 id="ask-a-side-question-without-derailing-the-session">521<h3 id="ask-a-side-question-without-derailing-the-session">


451 Arbeiten Sie sitzungsübergreifend540 Arbeiten Sie sitzungsübergreifend

452</h3>541</h3>

453 542 

454Claude 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“. Sie können Claude auch bitten, eine Sitzung umzubenennen oder zu archivieren. Claude archiviert eine Sitzung auf die gleiche Weise wie das Archiv-Symbol der Seitenleiste, daher bitten Sie es, Sitzungen zu bereinigen, deren PRs gemergt wurden.543Claude 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“.

544 

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

455 546 

456Ü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.547Ü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.

457 548 


470 Führen Sie lange laufende Aufgaben in der Cloud aus561 Führen Sie lange laufende Aufgaben in der Cloud aus

471</h3>562</h3>

472 563 

473Für große Umgestaltungen, Test-Suites, Migrationen oder andere lange laufende Aufgaben wählen Sie **Cloud** statt **Lokal**, wenn Sie eine Sitzung starten. 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.564Fü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.

565 

566Cloud-Sitzungen unterstützen auch mehrere Repositorys. Wählen Sie die Repositorys aus:

474 567 

475Cloud-Sitzungen unterstützen auch mehrere Repositories. Nach Auswahl einer Cloud-Umgebung klicken Sie auf die Schaltfläche **+** neben dem ausgewählten Repository, um zusätzliche Repositories zur Sitzung hinzuzufügen. Jedes Repo erhält seinen eigenen Branch-Wahlschalter. Dies ist nützlich für Aufgaben, die mehrere Codebasen umfassen, z. B. das Aktualisieren einer gemeinsamen Bibliothek und ihrer Consumer.568* **Aktuelles Layout**: in der Zeile unter dem Eingabefeld, sobald Sie eine Cloud-Umgebung ausgewählt haben.

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

476 570 

477Siehe [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.571Siehe [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.

478 572 


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

501* **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.595* **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.

502 596 

503Um zu sehen, ob eine Sitzung verbunden ist, achten Sie auf das Laptop-Symbol vor dem Sitzungstitel in der Symbolleiste. Das Symbol ist hervorgehoben, während die Sitzung verbunden ist oder sich verbindet. Klicken Sie darauf, um den Schalter **Remote Control** der Sitzung zu öffnen.597Um 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.

504 598 

505Um Sitzungen von Ihren anderen Geräten fernzuhalten, schalten Sie Remote Control auf der benötigten Ebene aus:599Um Sitzungen von Ihren anderen Geräten fernzuhalten, schalten Sie Remote Control auf der benötigten Ebene aus:

506 600 


538 Externe Tools verbinden632 Externe Tools verbinden

539</h3>633</h3>

540 634 

541Für lokale und [SSH](#ssh-sessions)-Sitzungen klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Connectors** aus, um Integrationen wie Google Calendar, Slack, GitHub, Linear, Notion und mehr hinzuzufügen. Sie können Connectors vor oder während einer Sitzung hinzufügen. Die Schaltfläche **+** ist in Cloud- oder WSL-Sitzungen nicht verfügbar, aber [Routinen](/docs/de/routines) konfigurieren Connectors zum Zeitpunkt der Routinenerstellung.635Konnektoren sind [MCP-Server](/docs/de/mcp) mit einem grafischen Setup-Ablauf.

636 

637Klicken Sie vor oder während der Sitzung auf **+** neben dem Eingabefeld, um Konnektoren in einer lokalen oder [SSH](#ssh-sessions)-Sitzung mit einem Claude-Konto hinzuzufügen. Wählen Sie **Konnektoren hinzufügen** aus, um das Konnektorverzeichnis zu öffnen. Wenn das Menü stattdessen **Konnektoren** anzeigt, wählen Sie diesen Eintrag und dann **Konnektoren durchsuchen** aus.

638 

639<Note>

640 Diese Fälle werden auf anderen Seiten behandelt:

542 641 

543Um Connectors zu verwalten oder zu trennen, gehen Sie zu Einstellungen → Connectors in der Desktop-App oder wählen Sie **Connectors verwalten** aus dem Connectors-Menü im Eingabefeld.642 * **Konnektoren ist in einer WSL-Sitzung ausgegraut**: siehe [Wenn das Terminal oder Konnektoren nicht verfügbar sind](/docs/de/desktop-wsl#check-for-the-terminal-and-connectors)

643 * **Cloud-Sitzungen**: siehe [Wie Konnektoren Claude Code erreichen](/docs/de/mcp#how-connectors-reach-claude-code)

644</Note>

544 645 

545Nach der Verbindung kann Claude Ihren Kalender lesen, Nachrichten senden, Probleme erstellen und direkt mit Ihren Tools interagieren. Sie können Claude fragen, welche Connectors in Ihrer Sitzung konfiguriert sind.646Nach der Verbindung kann Claude Ihren Kalender lesen, Nachrichten senden, Issues erstellen und direkt mit Ihren Tools interagieren. Sie können Claude fragen, welche Konnektoren in Ihrer Sitzung konfiguriert sind. Um Konnektoren zu verwalten oder zu trennen, gehen Sie in der Desktop-App zu **Einstellungen > Konnektoren**.

546 647 

547Connectors sind [MCP-Server](/docs/de/mcp) mit einem grafischen Setup-Ablauf. Verwenden Sie sie für eine schnelle Integration mit unterstützten Diensten. Für Integrationen, die nicht in Connectors aufgelistet sind, fügen Sie MCP-Server manuell über [Einstellungsdateien](/docs/de/mcp#installing-mcp-servers) hinzu. Sie können auch [benutzerdefinierte Connectors erstellen](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).648Für Integrationen, die nicht in Konnektoren aufgelistet sind, fügen Sie MCP-Server manuell über [Einstellungsdateien](/docs/de/mcp#installing-mcp-servers) hinzu. Sie können auch [benutzerdefinierte Konnektoren erstellen](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).

548 649 

549<h3 id="use-skills">650<h3 id="use-skills">

550 Skills verwenden651 Skills verwenden


564 665 

565[Plugins](/docs/de/plugins/overview) sind wiederverwendbare Pakete, die Skills, Agents, Hooks, MCP-Server und LSP-Konfigurationen zu Claude Code hinzufügen. Sie können Plugins aus der Desktop-App installieren, ohne das Terminal zu verwenden.666[Plugins](/docs/de/plugins/overview) sind wiederverwendbare Pakete, die Skills, Agents, Hooks, MCP-Server und LSP-Konfigurationen zu Claude Code hinzufügen. Sie können Plugins aus der Desktop-App installieren, ohne das Terminal zu verwenden.

566 667 

567Für lokale und [SSH](#ssh-sessions)-Sitzungen klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Plugins** aus, um Ihre installierten Plugins und deren Skills zu sehen. Um ein Plugin hinzuzufügen, wählen Sie **Plugin hinzufügen** aus dem Untermenü, um den Plugin-Browser zu öffnen, der verfügbare Plugins aus Ihren konfigurierten [Marketplaces](/docs/de/plugins/overview) einschließlich des offiziellen Anthropic-Marketplace anzeigt. Wählen Sie **Plugins verwalten** aus, um Plugins zu aktivieren, zu deaktivieren oder zu deinstallieren.668Klicken Sie in einer lokalen Sitzung oder einer [SSH-Sitzung](#ssh-sessions) auf **+** neben dem Eingabefeld und wählen Sie **Plugins hinzufügen** aus, um den Plugin-Browser zu öffnen. Wenn das Menü stattdessen **Plugins** anzeigt, wählen Sie diesen Eintrag und dann **Plugins durchsuchen** aus, oder **Plugins verwalten**, um Plugins zu aktivieren, zu deaktivieren oder zu deinstallieren.

568 669 

569Sie können Plugins auf Ihr Benutzerkonto, ein bestimmtes Projekt oder nur lokal beschränken. Wenn Ihre Organisation Plugins zentral verwaltet, sind diese Plugins in Desktop-Sitzungen auf die gleiche Weise verfügbar wie in der CLI, außer den Plugins, die die Desktop-App unter [`disableSideloadFlags`](/docs/de/settings-reference#disablesideloadflags) zurückhält.670Sie können Plugins auf Ihr Benutzerkonto, ein bestimmtes Projekt oder nur lokal beschränken. Wenn Ihre Organisation Plugins zentral verwaltet, sind diese Plugins in Desktop-Sitzungen auf die gleiche Weise verfügbar wie in der CLI, außer den Plugins, die die Desktop-App unter [`disableSideloadFlags`](/docs/de/settings-reference#disablesideloadflags) zurückhält.

570 671 


632| `runtimeArgs` | string\[] | An `runtimeExecutable` übergebene Argumente, z. B. `["run", "dev"]` |733| `runtimeArgs` | string\[] | An `runtimeExecutable` übergebene Argumente, z. B. `["run", "dev"]` |

633| `port` | number | Der Port, auf dem Ihr Server lauscht. Standardmäßig 3000 |734| `port` | number | Der Port, auf dem Ihr Server lauscht. Standardmäßig 3000 |

634| `cwd` | string | Arbeitsverzeichnis relativ zu Ihrem Projektstammverzeichnis. Standardmäßig das Projektstammverzeichnis. Verwenden Sie `${workspaceFolder}`, um das Projektstammverzeichnis explizit zu referenzieren |735| `cwd` | string | Arbeitsverzeichnis relativ zu Ihrem Projektstammverzeichnis. Standardmäßig das Projektstammverzeichnis. Verwenden Sie `${workspaceFolder}`, um das Projektstammverzeichnis explizit zu referenzieren |

635| `env` | object | Zusätzliche Umgebungsvariablen als Schlüssel-Wert-Paare, z. B. `{ "NODE_ENV": "development" }`. Legen Sie hier keine Geheimnisse ab, da diese Datei in Ihr Repo committed wird. Um Geheimnisse an Ihren Dev-Server zu übergeben, legen Sie sie stattdessen im [lokalen Umgebungs-Editor](#local-sessions) fest. |736| `env` | object | Zusätzliche Umgebungsvariablen als Schlüssel-Wert-Paare, z. B. `{ "NODE_ENV": "development" }`. Legen Sie hier keine Geheimnisse ab, da diese Datei in Ihr Repo committed wird. Informationen zu Geheimnissen finden Sie unter [Umgebungsvariablen für Dev-Server festlegen](#set-environment-variables-for-dev-servers). |

636| `autoPort` | boolean | Wie mit Port-Konflikten umgegangen wird. Siehe [Port-Konflikte](#port-conflicts) |737| `autoPort` | boolean | Wie mit Port-Konflikten umgegangen wird. Siehe [Port-Konflikte](#port-conflicts) |

637| `program` | string | Ein Skript, das mit `node` ausgeführt werden soll. Siehe [wann `program` vs `runtimeExecutable` verwendet werden soll](#when-to-use-program-vs-runtimeexecutable) |738| `program` | string | Ein Skript, das mit `node` ausgeführt werden soll. Siehe [wann `program` vs `runtimeExecutable` verwendet werden soll](#when-to-use-program-vs-runtimeexecutable) |

638| `args` | string\[] | An `program` übergebene Argumente. Wird nur verwendet, wenn `program` gesetzt ist |739| `args` | string\[] | An `program` übergebene Argumente. Wird nur verwendet, wenn `program` gesetzt ist |


795* **SSH**: läuft auf einem Remote-Computer, mit dem Sie sich über SSH verbinden, z. B. Ihre eigenen Server, Cloud-VMs oder Dev-Container. Eine laufende Aufgabe kann [weiterlaufen, während Desktop nicht verbunden ist](#keep-a-task-running-while-desktop-is-disconnected), mit einem Claude-Konto kann sie jedoch stoppen, wenn ihre Anmeldung abläuft.896* **SSH**: läuft auf einem Remote-Computer, mit dem Sie sich über SSH verbinden, z. B. Ihre eigenen Server, Cloud-VMs oder Dev-Container. Eine laufende Aufgabe kann [weiterlaufen, während Desktop nicht verbunden ist](#keep-a-task-running-while-desktop-is-disconnected), mit einem Claude-Konto kann sie jedoch stoppen, wenn ihre Anmeldung abläuft.

796* **WSL** (Windows): läuft in einer [WSL 2-Distribution](/docs/de/desktop-wsl) auf Ihrem Computer und verwendet deren Linux-Toolchain und native Pfade897* **WSL** (Windows): läuft in einer [WSL 2-Distribution](/docs/de/desktop-wsl) auf Ihrem Computer und verwendet deren Linux-Toolchain und native Pfade

797 898 

899<h3 id="create-a-saved-environment">

900 Eine gespeicherte Umgebung erstellen

901</h3>

902 

903Eine gespeicherte Umgebung ist ein Eintrag in der [Umgebungsauswahl](#start-a-session), der festhält, wo Claude läuft, damit Sie spätere Sitzungen dort starten können. Eine lokale oder SSH-Umgebung enthält außerdem die Ordner, in denen Claude arbeitet. Gespeicherte lokale und SSH-Umgebungen [erfordern Claude Desktop v2.37337.0 oder höher](#check-which-layout-you-have).

904 

905<Steps>

906 <Step title="Dialog New environment öffnen">

907 Öffnen Sie die Umgebungsauswahl unter dem Eingabefeld und wählen Sie unten in ihrem Menü **New environment** aus.

908 </Step>

909 

910 <Step title="Festlegen, wo Claude läuft">

911 Wählen Sie den Tab **Local**, **SSH** oder [**Cloud**](#cloud-sessions) aus und füllen Sie das Formular auf diesem Tab aus. Wählen Sie auf dem Tab **SSH** eine [Verbindung](#ssh-sessions) und einen Ordner auf dem Remote-Rechner aus.

912 </Step>

913 

914 <Step title="Umgebung speichern">

915 Wählen Sie **Create environment** aus, auf dem Tab **Cloud** **Add environment**.

916 </Step>

917</Steps>

918 

919<h4 id="environments-that-desktop-creates-for-you">

920 Umgebungen, die Desktop für Sie erstellt

921</h4>

922 

923Wenn die Umgebungsauswahl lokale oder SSH-Umgebungen auflistet, die Sie nicht erstellt haben, hat Desktop sie für Sie erstellt. Wenn Sie den Code-Tab im [aktuellen Layout](#check-which-layout-you-have) zum ersten Mal öffnen, erstellt Desktop bis zu acht Umgebungen. Die Umgebungen stammen aus den lokalen und SSH-Ordnern, die Sie im letzten Monat am häufigsten verwendet haben. Sie können sie [bearbeiten oder löschen](#use-edit-or-remove-a-saved-environment).

924 

925<h4 id="use-edit-or-remove-a-saved-environment">

926 Eine gespeicherte Umgebung verwenden, bearbeiten oder entfernen

927</h4>

928 

929Suchen Sie den Eintrag der Umgebung in der [Umgebungsauswahl](#start-a-session):

930 

931* **Eine Sitzung starten**: Wählen Sie den Eintrag aus.

932* **Bearbeiten oder löschen**: Bewegen Sie den Mauszeiger über den Eintrag und klicken Sie auf das Zahnradsymbol. Um eine lokale oder SSH-Umgebung zu löschen, klicken Sie in **Edit environment** auf **Delete environment**.

933* **Cloud-Umgebungen archivieren**: siehe [Eine Umgebung archivieren](/docs/de/cloud-environments#archive-an-environment).

934 

798<h3 id="local-sessions">935<h3 id="local-sessions">

799 Lokale Sitzungen936 Lokale Sitzungen

800</h3>937</h3>

801 938 

802Die Desktop-App erbt nicht immer Ihre vollständige Shell-Umgebung. Auf macOS liest die App beim Starten aus dem Dock oder Finder Ihr Shell-Profil, z. B. `~/.zshrc` oder `~/.bashrc`, um `PATH` und einen festen Satz von Claude Code-Variablen zu extrahieren, aber andere Variablen, die Sie dort exportieren, werden nicht übernommen. Unter Windows erbt die App Benutzer- und Systemumgebungsvariablen, liest aber keine PowerShell-Profile.939Die Desktop-App erbt nicht immer Ihre vollständige Shell-Umgebung. Auf macOS liest die App beim Starten aus dem Dock oder Finder Ihr Shell-Profil, z. B. `~/.zshrc` oder `~/.bashrc`, um `PATH` und einen festen Satz von Claude Code-Variablen zu extrahieren, aber andere Variablen, die Sie dort exportieren, werden nicht übernommen. Unter Windows erbt die App Benutzer- und Systemumgebungsvariablen, liest aber keine PowerShell-Profile.

803 940 

804Um Umgebungsvariablen für lokale Sitzungen und Dev-Server auf jeder Plattform festzulegen, öffnen Sie das Umgebungs-Dropdown im Eingabefeld, fahren Sie mit der Maus über **Lokal** und klicken Sie auf das Zahnrad-Symbol, um den lokalen Umgebungs-Editor zu öffnen. Variablen, die Sie hier speichern, werden verschlüsselt auf Ihrem Computer gespeichert und gelten für jede lokale Sitzung und jeden Vorschau-Server, den Sie starten. Sie können auch Variablen zum Schlüssel `env` in Ihrer Datei `~/.claude/settings.json` hinzufügen, obwohl diese nur Claude-Sitzungen erreichen und nicht Dev-Server. Siehe [Umgebungsvariablen](/docs/de/env-vars) für die vollständige Liste der unterstützten Variablen.941<h4 id="set-environment-variables-for-local-sessions">

942 Umgebungsvariablen für lokale Sitzungen setzen

943</h4>

944 

945Fügen Sie die Variablen einer gespeicherten lokalen Umgebung hinzu und starten Sie Ihre Sitzungen von dort. Desktop [setzt einige Variablen selbst](#environment-variables-desktop-sets-itself), etwa `API_TIMEOUT_MS`, und Ihre Sitzungen erhalten für diese den Wert von Desktop statt Ihres eigenen.

946 

947<Note>

948 Wenn sich Ihre Umgebungsauswahl über dem Eingabefeld befindet, haben Sie das [frühere Layout](#check-which-layout-you-have), das keine gespeicherten lokalen Umgebungen hat. Verwenden Sie stattdessen den [Editor für die lokale Umgebung](#use-the-local-environment-editor).

949</Note>

950 

951<Steps>

952 <Step title="Formular der Umgebung öffnen">

953 Öffnen Sie [**New environment**](#create-a-saved-environment) oder [**Edit environment**](#use-edit-or-remove-a-saved-environment).

954 </Step>

955 

956 <Step title="Variablen eingeben">

957 Wählen Sie **Environment variables** aus, geben Sie pro Zeile ein `KEY=value` ein und wählen Sie **Done** aus.

958 </Step>

959 

960 <Step title="Umgebung speichern">

961 Wählen Sie **Create environment** oder **Save** aus.

962 </Step>

963</Steps>

964 

965Nur Sitzungen, die Sie aus dieser Umgebung starten, erhalten die Variablen.

966 

967Um eine Variable für jede lokale Sitzung zu setzen, fügen Sie sie dem [Schlüssel `env`](/docs/de/env-vars#set-variables-in-settings-files) in Ihrer Datei `~/.claude/settings.json` hinzu. Claude Code [ignoriert den Wert](/docs/de/settings-reference#how-env-values-interact-with-your-shell), wenn diese Variable bereits in der Umgebung vorhanden ist, mit der Desktop die Sitzung startet. Die vollständige Liste der unterstützten Variablen finden Sie unter [Umgebungsvariablen](/docs/de/env-vars).

968 

969<h4 id="set-environment-variables-for-dev-servers">

970 Umgebungsvariablen für Dev-Server setzen

971</h4>

972 

973Um einem Dev-Server ein Secret zu übergeben, ohne es in [`launch.json`](#configure-preview-servers) zu committen, setzen Sie es an einer dieser Stellen und starten Sie Desktop anschließend neu:

974 

975* **macOS und Linux**: Exportieren Sie es in Ihrem Shell-Profil

976* **Windows**: Fügen Sie es Ihren Benutzer- oder Systemumgebungsvariablen hinzu

977* **Jede Plattform**: Speichern Sie es im [Editor für die lokale Umgebung](#use-the-local-environment-editor), sofern Sie ihn öffnen können

978 

979Dev-Server erhalten nicht die Variablen, die Sie einer [gespeicherten Umgebung](#create-a-saved-environment) oder `~/.claude/settings.json` hinzufügen.

980 

981<h4 id="use-the-local-environment-editor">

982 Den Editor für die lokale Umgebung verwenden

983</h4>

984 

985Um den Editor für die lokale Umgebung zu öffnen, klicken Sie auf das Zahnradsymbol am Eintrag für Ihren eigenen Computer, nicht auf das an einer gespeicherten Umgebung:

986 

987* **Auswahl unter dem Eingabefeld**: Bewegen Sie den Mauszeiger über den Eintrag für Ihren Computer, den ersten unter **Local**. Wenn ein Zahnradsymbol erscheint, klicken Sie darauf. Falls nicht, ist der Editor nicht verfügbar. Setzen Sie die Variable dann auf anderem Weg für [lokale Sitzungen](#set-environment-variables-for-local-sessions) oder [Dev-Server](#set-environment-variables-for-dev-servers).

988* **Auswahl über dem Eingabefeld**: Bewegen Sie den Mauszeiger über **Local** und klicken Sie auf das Zahnradsymbol

989 

990Geben Sie pro Zeile ein `KEY=value` ein und wählen Sie **Save changes** aus. Variablen, die Sie hier speichern, werden verschlüsselt auf Ihrem Rechner abgelegt. Lokale Sitzungen erhalten sie, mit Ausnahme jeder Variable, die [Desktop selbst setzt](#environment-variables-desktop-sets-itself), etwa `API_TIMEOUT_MS`. Starten Sie Desktop neu, um Ihre Variablen an Dev-Server zu übergeben.

991 

992<h4 id="environment-variables-desktop-sets-itself">

993 Umgebungsvariablen, die Desktop selbst setzt

994</h4>

995 

996Wenn Sie `API_TIMEOUT_MS` oder `ANTHROPIC_BASE_URL` setzen und sich in Ihren lokalen Sitzungen nichts ändert, liegt das daran, dass Desktop diese [Variablen](/docs/de/env-vars#variables), neben anderen, selbst setzt. Eine lokale Sitzung erhält den Wert von Desktop, unabhängig davon, ob Sie Ihren Wert in Ihrem Shell-Profil, Ihren Windows-Benutzer- oder Systemvariablen, im Editor für die lokale Umgebung oder in einer gespeicherten Umgebung setzen. Ihren Wert in eine Einstellungsdatei zu verschieben, hilft nicht, weil Claude Code [diesen Wert](/docs/de/settings-reference#how-env-values-interact-with-your-shell) in einer lokalen Sitzung ignoriert.

997 

998* `API_TIMEOUT_MS`: Eine lokale Sitzung erhält `900000`, also 15 Minuten. Für einen längeren Timeout [installieren Sie die Claude Code CLI](/docs/de/quickstart) und verwenden Sie sie statt Desktop. [Setzen Sie die Variable in Ihrer Shell](/docs/de/env-vars#set-variables-in-your-shell) und führen Sie `claude` in Ihrem Terminal aus.

999* `ANTHROPIC_BASE_URL`: Eine lokale Sitzung erhält den API-Host von Anthropic, wenn Sie mit einem Claude-Konto angemeldet sind. Um ein Gateway zu verwenden, richten Sie stattdessen die [Konfiguration für Drittanbieter-Inferenz](/docs/de/llm-gateway-connect#desktop-app) von Desktop ein.

1000 

1001<h4 id="turn-off-extended-thinking">

1002 Extended Thinking ausschalten

1003</h4>

805 1004 

806[Extended Thinking](/docs/de/model-config#extended-thinking) ist standardmäßig aktiviert, was die Leistung bei komplexen Denkaufgaben verbessert, aber zusätzliche Token verwendet. Auf der Anthropic API setzen Sie `MAX_THINKING_TOKENS` im lokalen Umgebungs-Editor auf `0`, um Thinking auszuschalten; dies hat keine Auswirkung auf Opus 5.5, Sonnet 5.5, Haiku 5.5 oder die Fable-Modelle, die immer Extended Thinking verwenden. Bei ausgeschaltetem Thinking auf der Anthropic API sendet Claude Code stattdessen den Aufwand `high` an Modelle, von denen es weiß, dass sie [diese Kombination nicht akzeptieren](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5.1005[Extended Thinking](/docs/de/model-config#extended-thinking) ist standardmäßig aktiviert. Das verbessert die Leistung bei komplexen Denkaufgaben, verbraucht aber zusätzliche Token. Um es auszuschalten, setzen Sie `MAX_THINKING_TOKENS` in einer [gespeicherten lokalen Umgebung](#set-environment-variables-for-local-sessions) oder im [Editor für die lokale Umgebung](#use-the-local-environment-editor) auf `0`. Thinking wird dann über die Anthropic API ausgeschaltet, außer bei Opus 5.5, Sonnet 5.5, Haiku 5.5 und den Fable-Modellen, die immer Extended Thinking verwenden.

1006 

1007Wählen Sie bei Opus 5 außerdem den Aufwand `high` oder niedriger aus, bevor Sie die Sitzung starten. Öffnen Sie im [aktuellen Layout](#check-which-layout-you-have) die Modellauswahl und wählen Sie unter **Effort** eine Stufe aus. Wenn Sie die Sitzung mit einer höheren Stufe gestartet haben, starten Sie eine neue mit `high` oder niedriger.

1008 

1009<h4 id="fixed-thinking-budgets">

1010 Feste Thinking-Budgets

1011</h4>

807 1012 

808Bei Modellen mit [adaptiver Argumentation](/docs/de/model-config#adjust-effort-level) ignoriert Claude Code die Zahl selbst in einem positiven `MAX_THINKING_TOKENS`-Wert, da stattdessen die adaptive Argumentation die Denktiefe steuert. Bei Opus 4.6 und Sonnet 4.6 setzen Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` auf `1`, um ein festes Thinking-Budget zu verwenden; Fable-Modelle, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später verwenden immer adaptive Argumentation und haben keinen Modus mit festem Budget.1013Bei Modellen mit [adaptiver Argumentation](/docs/de/model-config#adjust-effort-level) ignoriert Claude Code die Zahl selbst in einem positiven `MAX_THINKING_TOKENS`-Wert, da stattdessen die adaptive Argumentation die Denktiefe steuert. Bei Opus 4.6 und Sonnet 4.6 setzen Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` auf `1`, um ein festes Thinking-Budget zu verwenden; Fable-Modelle, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später verwenden immer adaptive Argumentation und haben keinen Modus mit festem Budget.

809 1014 


811 Lokale Sitzungen auf verwalteten Geräten1016 Lokale Sitzungen auf verwalteten Geräten

812</h4>1017</h4>

813 1018 

814Ihr Administrator kann lokale Sitzungen mit der verwalteten Einstellung [`disableDesktopLocalSessions`](#managed-settings) deaktivieren. Wenn dies der Fall ist, bleibt **Lokal** im Umgebungs-Dropdown, ist aber ausgegraut und kann nicht ausgewählt werden, mit einem Tooltip, das besagt, dass Ihre Organisation es deaktiviert hat, und unter Windows ist der [WSL](/docs/de/desktop-wsl)-Eintrag, dessen Verfügbarkeit auf verwalteten Geräten [separat geregelt wird](/docs/de/admin-setup#wsl-sessions-in-claude-code-desktop), auf die gleiche Weise ausgegraut. Neue Sitzungen werden standardmäßig auf die erste SSH-Verbindung gesetzt, wenn eine konfiguriert ist, und Desktop zeigt eine Meldung an, dass lokale Sitzungen auf diesem Gerät nicht verfügbar sind, wenn Sie versuchen, eine vorhandene fortzusetzen. Wählen Sie stattdessen eine [SSH](#ssh-sessions)- oder [Cloud](#cloud-sessions)-Umgebung, oder kontaktieren Sie Ihr IT-Team.1019Wenn der Eintrag für Ihren Computer in der Umgebungsauswahl ausgegraut ist und den Tooltip **Disabled by your organization** zeigt, hat Ihr Administrator [lokale Sitzungen ausgeschaltet](#managed-settings). Unter Windows ist der Eintrag [WSL](/docs/de/desktop-wsl), dessen Verfügbarkeit auf verwalteten Geräten [separat geregelt](/docs/de/admin-setup#wsl-sessions-in-claude-code-desktop) wird, auf die gleiche Weise ausgegraut.

1020 

1021Neue Sitzungen verwenden standardmäßig die erste SSH-Verbindung, sofern eine konfiguriert ist. Wenn Sie versuchen, eine bestehende lokale Sitzung fortzusetzen, zeigt Desktop eine Meldung an, dass lokale Sitzungen auf diesem Gerät nicht verfügbar sind. [Gespeicherte lokale Umgebungen](#create-a-saved-environment) zeigen diesen Fehler, wenn Sie eine davon auswählen: `Couldn’t switch environments: the Local environment isn’t available anymore.` Wählen Sie stattdessen eine [SSH](#ssh-sessions)- oder [Cloud](#cloud-sessions)-Umgebung aus oder wenden Sie sich an Ihr IT-Team.

815 1022 

816<h3 id="cloud-sessions">1023<h3 id="cloud-sessions">

817 Cloud-Sitzungen1024 Cloud-Sitzungen


819 1026 

820Cloud-Sitzungen werden im Hintergrund fortgesetzt, auch wenn Sie die App schließen. Die Nutzung wird auf Ihre [Abonnementplanlimits](/docs/de/costs) angerechnet, ohne separate Compute-Gebühren.1027Cloud-Sitzungen werden im Hintergrund fortgesetzt, auch wenn Sie die App schließen. Die Nutzung wird auf Ihre [Abonnementplanlimits](/docs/de/costs) angerechnet, ohne separate Compute-Gebühren.

821 1028 

822Sie können benutzerdefinierte Cloud-Umgebungen mit verschiedenen Netzwerkzugriffsstufen und Umgebungsvariablen erstellen. Um diese zu verwalten, öffnen Sie das Umgebungs-Dropdown im Eingabefeld und wählen Sie **Cloud**:1029Um eine Cloud-Umgebung hinzuzufügen, zu bearbeiten oder zu [archivieren](/docs/de/cloud-environments#archive-an-environment), öffnen Sie die [Umgebungsauswahl](#start-a-session):

823 1030 

824* **Eine Umgebung hinzufügen**: wählen Sie **Cloud-Umgebung hinzufügen**1031* **Eine Umgebung hinzufügen**: Wählen Sie unten im Menü der Auswahl **New environment** aus, dann den Tab **Cloud** des [Dialogs **New environment**](#create-a-saved-environment)

825* **Eine Ihrer eigenen Umgebungen bearbeiten oder archivieren**: fahren Sie mit der Maus darüber und klicken Sie auf das Zahnrad-Symbol1032* **Eine Ihrer eigenen Umgebungen bearbeiten oder archivieren**: fahren Sie mit der Maus darüber und klicken Sie auf das Zahnrad-Symbol

826 1033 

827Siehe [Cloud-Umgebungen konfigurieren](/docs/de/cloud-environments) für Details zur Konfiguration von Netzwerkzugriff und Umgebungsvariablen.1034Siehe [Cloud-Umgebungen konfigurieren](/docs/de/cloud-environments) für Details zur Konfiguration von Netzwerkzugriff und Umgebungsvariablen.


836 Wenn Sie Desktop mit einem [Drittanbieter](/docs/de/third-party-integrations) verwenden, benötigen SSH-Sitzungen eine eigene Einrichtung. Siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1043 Wenn Sie Desktop mit einem [Drittanbieter](/docs/de/third-party-integrations) verwenden, benötigen SSH-Sitzungen eine eigene Einrichtung. Siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).

837</Note>1044</Note>

838 1045 

839Um eine SSH-Verbindung hinzuzufügen, öffnen Sie vor dem Starten einer Sitzung das Umgebungs-Dropdown im Eingabefeld, wählen Sie dann **SSH > Add SSH connection…** und füllen Sie die Verbindungsdetails aus:1046Fügen Sie im [Dialog **New environment**](#create-a-saved-environment) eine SSH-Verbindung hinzu und starten Sie dann eine Sitzung auf dieser Verbindung. Wenn eine neue Sitzung keine Umgebungsauswahl unter dem Eingabefeld hat, haben Sie das frühere Layout. Siehe [Prüfen, welches Layout Sie haben](#check-which-layout-you-have).

1047 

1048<Steps>

1049 <Step title="Dialog New environment öffnen">

1050 Bevor Sie eine Sitzung starten, öffnen Sie die Umgebungsauswahl unter dem Eingabefeld und wählen Sie unten in ihrem Menü **New environment** aus.

1051 </Step>

1052 

1053 <Step title="Verbindung hinzufügen">

1054 Öffnen Sie auf dem Tab **SSH** des Dialogs **New environment** die Liste **Host**, wählen Sie **Add SSH connection…** aus und füllen Sie die Verbindungsdetails aus:

840 1055 

841* **Name**: ein freundlicher Bezeichner für diese Verbindung1056 * **Name**: eine aussagekräftige Bezeichnung für diese Verbindung.

842* **SSH host**: `user@hostname` oder ein in `~/.ssh/config` definierter Host1057 * **SSH host**: `user@hostname` oder ein in `~/.ssh/config` definierter Host.

843* **SSH port**: Standard ist 22, wenn leer gelassen, oder verwendet den Port aus Ihrer SSH-Konfiguration1058 * **SSH port**: standardmäßig 22, wenn das Feld leer bleibt, oder der Port aus Ihrer SSH-Konfiguration.

844* **SSH key (optional)**: Pfad zu Ihrem privaten Schlüssel, z. B. `~/.ssh/id_ed25519`. Lassen Sie das Feld leer, um Ihre SSH-Konfiguration oder Ihren SSH-Agenten zu verwenden.1059 * **SSH key (optional)**: Pfad zu Ihrem privaten Schlüssel, etwa `~/.ssh/id_ed25519`. Lassen Sie das Feld leer, um Ihre SSH-Konfiguration oder Ihren SSH-Agent zu verwenden.

845* **Worktree folder**: ein Ordner auf dem Remote-Computer, z. B. `~/worktrees`, in dem neue Sitzungen ihre Worktrees erstellen. Lassen Sie das Feld leer, um den [Standard des Remote-Computers](#choose-where-ssh-session-worktrees-go) zu verwenden.1060 * **Worktree folder**: ein Ordner auf dem Remote-Rechner, etwa `~/worktrees`, in dem neue Sitzungen ihre Worktrees erstellen. Lassen Sie das Feld leer, um den [Standard des Remote-Rechners](#choose-where-ssh-session-worktrees-go) zu verwenden.

846 1061 

847Nach dem Hinzufügen wird die Verbindung im Umgebungs-Dropdown unter **SSH** angezeigt. Wählen Sie sie aus, um eine Sitzung auf diesem Computer zu starten. Claude läuft auf dem Remote-Computer mit Zugriff auf seine Dateien und Tools.1062 Wählen Sie dann **Add SSH connection** aus.

1063 </Step>

1064 

1065 <Step title="Sitzung auf der Verbindung starten">

1066 Wählen Sie einen Ordner auf dem Remote-Rechner aus und klicken Sie auf **Create environment**. Rechner und Ordner bleiben als [gespeicherte Umgebung](#create-a-saved-environment) für spätere Sitzungen zusammen erhalten. Desktop wählt sie für die neue Sitzung aus. Geben Sie also Ihre Aufgabe ein und drücken Sie **Enter**.

1067 </Step>

1068</Steps>

848 1069 

849Auf dem Remote-Computer kann Linux, macOS oder [Windows](#windows-remote-machines) laufen. Desktop installiert Claude Code auf dem Remote-Computer automatisch beim ersten Verbindungsaufbau. Nach der Verbindung unterstützen SSH-Sitzungen Berechtigungsmodi, Konnektoren, Plugins und MCP-Server.1070Auf dem Remote-Computer kann Linux, macOS oder [Windows](#windows-remote-machines) laufen. Desktop installiert Claude Code auf dem Remote-Computer automatisch beim ersten Verbindungsaufbau. Nach der Verbindung unterstützen SSH-Sitzungen Berechtigungsmodi, Konnektoren, Plugins und MCP-Server.

850 1071 


1175 1396 

1176Dateibearbeitungen und einige Tools können fehlschlagen, während Desktop nicht verbunden ist. Wenn die Aufgabe sie benötigt, halten Sie Desktop verbunden:1397Dateibearbeitungen und einige Tools können fehlschlagen, während Desktop nicht verbunden ist. Wenn die Aufgabe sie benötigt, halten Sie Desktop verbunden:

1177 1398 

1178* **Worktrees**: In einer Sitzung, die einen [Worktree](#work-in-parallel-with-sessions) verwendet, prüft Desktop jede Dateibearbeitung, bevor Claude sie vornimmt. Während Desktop nicht verbunden ist, wartet jede Bearbeitung etwa 30 Sekunden und schlägt dann fehl. Shell-Befehle laufen weiterhin. Auf einem Linux- oder macOS-Remote-Computer [können Bearbeitungen weiterhin funktionieren](#worktree-edits-while-disconnected). Wenn Sie unsicher sind, starten Sie die Sitzung ohne Worktree.1399* **Worktrees**: In einer Sitzung, die einen [Worktree](#run-a-session-in-its-own-worktree) verwendet, prüft Desktop jede Dateibearbeitung, bevor Claude sie vornimmt. Während Desktop getrennt ist, wartet jede Bearbeitung etwa 30 Sekunden und schlägt dann fehl. Shell-Befehle laufen weiterhin. Auf einem Linux- oder macOS-Remote-Rechner [können Bearbeitungen weiter funktionieren](#worktree-edits-while-disconnected). Wenn Sie unsicher sind, starten Sie die Sitzung ohne Worktree.

1179* **Ordnerbeschränkungen**: Wenn Ihre Organisation einschränkt, welche Ordner Sitzungen verwenden dürfen, prüft Desktop jedes Lesen, jede Suche und jede Bearbeitung von Dateien, mit oder ohne Worktree. Während Desktop nicht verbunden ist, wartet jeder dieser Vorgänge bis zu 10 Minuten und schlägt dann fehl.1400* **Ordnerbeschränkungen**: Wenn Ihre Organisation einschränkt, welche Ordner Sitzungen verwenden dürfen, prüft Desktop jedes Lesen, jede Suche und jede Bearbeitung von Dateien, mit oder ohne Worktree. Während Desktop nicht verbunden ist, wartet jeder dieser Vorgänge bis zu 10 Minuten und schlägt dann fehl.

1180* **Konnektoren**: [Konnektoren](#connect-external-tools) und andere Tools, die Desktop bereitstellt, laufen über Desktop, daher schlägt jeder Aufruf nach etwa 30 Sekunden fehl, während es nicht verbunden ist1401* **Konnektoren**: [Konnektoren](#connect-external-tools) und andere Tools, die Desktop bereitstellt, laufen über Desktop, daher schlägt jeder Aufruf nach etwa 30 Sekunden fehl, während es nicht verbunden ist

1181* **Workflows**: Desktop prüft jeden neuen [Workflow](/docs/de/workflows), bevor er startet, daher wartet ein neuer Workflow, während Desktop nicht verbunden ist, bis zu 10 Minuten und schlägt dann fehl1402* **Workflows**: Desktop prüft jeden neuen [Workflow](/docs/de/workflows), bevor er startet, daher wartet ein neuer Workflow, während Desktop nicht verbunden ist, bis zu 10 Minuten und schlägt dann fehl


1264 Festlegen, wo Worktrees von SSH-Sitzungen abgelegt werden1485 Festlegen, wo Worktrees von SSH-Sitzungen abgelegt werden

1265</h4>1486</h4>

1266 1487 

1267Sofern Ihre Organisation nicht einschränkt, welche Ordner Sitzungen verwenden dürfen, erstellen neue SSH-Sitzungen ihre [Worktrees](#work-in-parallel-with-sessions) am ersten der folgenden Orte, der festgelegt ist:1488Sofern Ihre Organisation nicht einschränkt, welche Ordner Sitzungen verwenden dürfen, erstellen neue SSH-Sitzungen ihre [Worktrees](#run-a-session-in-its-own-worktree) am ersten dieser Orte, der gesetzt ist:

1268 1489 

12691. **Worktree folder** in der SSH-Verbindung14901. **Worktree folder** in der SSH-Verbindung

12702. [`worktree.location`](/docs/de/settings-reference#worktree-location) in `~/.claude/settings.json` auf dem Remote-Computer14912. [`worktree.location`](/docs/de/settings-reference#worktree-location) in `~/.claude/settings.json` auf dem Remote-Computer


1272 1493 

1273Jedes Projekt erhält einen eigenen Unterordner in dem von Ihnen festgelegten Ordner, sodass der Pfad eines Worktrees bei `~/worktrees` `~/worktrees/<project>-<id>/<worktree-name>` lautet. Wenn der festgelegte Ordner innerhalb des Projekts liegt, ignoriert Desktop ihn für dieses Projekt und verwendet den Standard. Auf einem [Windows-Remote-Computer](#windows-remote-machines) verwendet Desktop immer den Standard.1494Jedes Projekt erhält einen eigenen Unterordner in dem von Ihnen festgelegten Ordner, sodass der Pfad eines Worktrees bei `~/worktrees` `~/worktrees/<project>-<id>/<worktree-name>` lautet. Wenn der festgelegte Ordner innerhalb des Projekts liegt, ignoriert Desktop ihn für dieses Projekt und verwendet den Standard. Auf einem [Windows-Remote-Computer](#windows-remote-machines) verwendet Desktop immer den Standard.

1274 1495 

1275Um **Worktree folder** für eine Verbindung festzulegen, die Sie zuvor hinzugefügt haben oder die Ihre Organisation verwaltet, fahren Sie im Umgebungs-Dropdown mit der Maus darüber und klicken Sie auf das Zahnrad-Symbol.1496<a id="set-the-worktree-folder-on-an-existing-connection" />

1276 1497 

1277Das Feld erfordert Claude Desktop v1.44121.0 oder höher. Wenn Ihre Organisation einschränkt, welche Ordner Sitzungen verwenden dürfen, blendet Desktop das Feld aus und belässt Worktrees innerhalb des Projekts.1498<h5 id="set-the-worktree-folder-on-an-existing-connection">

1499 Den Worktree-Ordner für eine bestehende Verbindung festlegen

1500</h5>

1501 

1502Setzen Sie **Worktree folder** in den Einstellungen einer Verbindung, die Sie früher hinzugefügt haben oder die Ihre Organisation verwaltet. Das Feld erfordert Claude Desktop v1.44121.0 oder höher. Wenn Ihre Organisation einschränkt, welche Ordner Sitzungen verwenden dürfen, blendet Desktop das Feld aus und behält Worktrees innerhalb des Projekts.

1503 

1504<Steps>

1505 <Step title="Verbindung finden">

1506 Öffnen Sie die [Umgebungsauswahl](#start-a-session) und suchen Sie die Verbindung unter **SSH**.

1507 </Step>

1508 

1509 <Step title="Einstellungen der Verbindung öffnen">

1510 Bewegen Sie den Mauszeiger über die Verbindung und klicken Sie auf das Zahnradsymbol. Wenn der geöffnete Dialog neben **Host** **Edit connection…** zeigt, wählen Sie **Edit connection…** aus.

1511 </Step>

1512 

1513 <Step title="Ordner festlegen">

1514 Geben Sie in **Worktree folder** einen Ordner auf dem Remote-Rechner ein, etwa `~/worktrees`, und wählen Sie **Save changes** aus.

1515 </Step>

1516</Steps>

1278 1517 

1279<h4 id="files-and-processes-on-the-remote-machine">1518<h4 id="files-and-processes-on-the-remote-machine">

1280 Dateien und Prozesse auf dem Remote-Computer1519 Dateien und Prozesse auf dem Remote-Computer


1321 Den Prozess einer Sitzung beenden1560 Den Prozess einer Sitzung beenden

1322</h5>1561</h5>

1323 1562 

1324Um den Claude Code-Prozess einer Sitzung zu beenden, [archivieren Sie die Sitzung](#work-in-parallel-with-sessions) in Desktop, während Desktop mit dem Remote-Computer verbunden ist. Der Prozess läuft weiter, nachdem seine Aufgabe erledigt ist und nachdem Sie Desktop beendet haben.1563Um den Claude-Code-Prozess einer Sitzung zu beenden, [archivieren Sie die Sitzung](#archive-a-session) in Desktop, während Desktop mit dem Remote-Rechner verbunden ist. Der Prozess läuft weiter, nachdem seine Aufgabe erledigt ist und nachdem Sie Desktop beendet haben.

1325 1564 

1326Bevor Sie eine Sitzung archivieren, die einen Worktree hat, lesen Sie [Mit Sitzungen parallel arbeiten](#work-in-parallel-with-sessions).1565Bevor Sie eine Sitzung archivieren, deren Worktree nicht committete Änderungen enthält, siehe [Nicht committete Änderungen beim Archivieren einer Sitzung behalten](#keep-uncommitted-changes-when-a-session-is-archived).

1327 1566 

1328<h5 id="see-which-user-the-processes-run-as">1567<h5 id="see-which-user-the-processes-run-as">

1329 Sehen, unter welchem Benutzer die Prozesse laufen1568 Sehen, unter welchem Benutzer die Prozesse laufen


1474 SSH-Verbindungen für Ihr Team vorkonfigurieren1713 SSH-Verbindungen für Ihr Team vorkonfigurieren

1475</h4>1714</h4>

1476 1715 

1477Administratoren können SSH-Verbindungen an Teammitglieder verteilen, indem sie `sshConfigs` in den [verwalteten Einstellungen](/docs/de/managed-settings) setzen. Auf diese Weise definierte Verbindungen werden in der Umgebungs-Dropdown-Liste jedes Benutzers automatisch angezeigt und sind als verwaltet gekennzeichnet. Benutzer können sie auswählen und [ihren eigenen **Worktree folder**](#choose-where-ssh-session-worktrees-go) dafür festlegen, aber in der App nichts anderes bearbeiten oder sie löschen.1716Administratoren können SSH-Verbindungen an Teammitglieder verteilen, indem sie `sshConfigs` in den [verwalteten Einstellungen](/docs/de/managed-settings) festlegen.

1717 

1718* **Was Benutzer sehen**: Auf diese Weise definierte Verbindungen erscheinen automatisch in der Umgebungsauswahl jedes Benutzers.

1719* **Was Benutzer ändern können**: Benutzer können eine verwaltete Verbindung auswählen und [ihren eigenen **Worktree folder**](#set-the-worktree-folder-on-an-existing-connection) dafür festlegen. Die übrigen Felder können sie in der App nicht bearbeiten, und sie können die Verbindung nicht löschen.

1478 1720 

1479Das folgende Beispiel konfiguriert eine einzelne Verbindung vor:1721Das folgende Beispiel konfiguriert eine einzelne Verbindung vor:

1480 1722 


1563Um zu bestätigen, dass die Einstellungen greifen, prüfen Sie den Computer eines Entwicklers:1805Um zu bestätigen, dass die Einstellungen greifen, prüfen Sie den Computer eines Entwicklers:

1564 1806 

1565<Steps>1807<Steps>

1566 <Step title="Umgebungs-Dropdown prüfen">1808 <Step title="Die Umgebungsauswahl prüfen">

1567 Beenden Sie Desktop, öffnen Sie es erneut und öffnen Sie dann das Umgebungs-Dropdown im Eingabefeld. **Lokal** ist ausgegraut, und **Shared Dev VM** erscheint unter **SSH**. Wenn **Lokal** weiterhin verfügbar ist, prüfen Sie die Desktop-Version, ob die Datei gültiges JSON ist und welche verwaltete Quelle der Computer liest.1809 Beenden Sie Desktop, öffnen Sie es erneut und öffnen Sie dann die [Umgebungsauswahl](#start-a-session). Die Einstellungen gelten, wenn dort Folgendes angezeigt wird:

1810 

1811 * Der Eintrag für diesen Computer, ausgegraut

1812 * **Shared Dev VM** unter **SSH**. Wenn der Eintrag dort nicht aufgeführt ist, klicken Sie auf die einzelne Zeile **SSH** oder auf **More** am Ende der Gruppe.

1813 

1814 Wenn der Eintrag für den Computer weiterhin verfügbar ist, prüfen Sie diese Ursachen:

1815 

1816 * **Desktop-Version**: Aktualisieren Sie Desktop, wenn die Version älter als v1.37937.0 ist.

1817 * **Datei mit verwalteten Einstellungen**: Stellen Sie sicher, dass die Datei gültiges JSON enthält.

1818 * **Verwaltete Quelle**: Stellen Sie sicher, dass der Computer die [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources) liest, die die Schlüssel enthält.

1568 </Step>1819 </Step>

1569 1820 

1570 <Step title="Einen Host hinzufügen, der nicht auf der Allowlist steht">1821 <Step title="Einen Host hinzufügen, der nicht auf der Allowlist steht">

1571 [Fügen Sie eine SSH-Verbindung hinzu](#ssh-sessions) mit einem Hostnamen, der nicht auf der Allowlist steht, z. B. `other.example.com`. Desktop speichert die Verbindung, verweigert aber den Verbindungsaufbau und meldet, dass die Einstellungen Ihrer Organisation die Verbindung nicht zulassen.1822 [Fügen Sie eine SSH-Verbindung hinzu](#ssh-sessions) mit einem Hostnamen, der nicht auf der Allowlist steht, etwa `other.example.com`. Desktop speichert die Verbindung, verweigert aber den Verbindungsaufbau und meldet, dass die Einstellungen Ihrer Organisation die Verbindung nicht zulassen.

1572 </Step>1823 </Step>

1573</Steps>1824</Steps>

1574 1825 


1612| `browserExternalPageTools` | auf `"disabled"` setzen, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](#browse-external-sites) zu lesen oder zu bearbeiten. Benutzer können externe Websites weiterhin selbst navigieren, und lokale Dev-Server-Vorschauen sind nicht betroffen. |1863| `browserExternalPageTools` | auf `"disabled"` setzen, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](#browse-external-sites) zu lesen oder zu bearbeiten. Benutzer können externe Websites weiterhin selbst navigieren, und lokale Dev-Server-Vorschauen sind nicht betroffen. |

1613| `disableMobileSimulatorTools` | auf `true` setzen, um Claudes Tools zum Steuern und Erfassen von Geräten im [iOS-Simulator-Bereich](/docs/de/desktop-ios-simulator#turn-off-simulator-access) zu blockieren. Der Bereich bleibt für die eigenen Taps des Benutzers nutzbar; nur Claudes Zugriff wird entfernt. Der Wert muss der JSON-Boolean `true` sein; der String `"true"` wird ignoriert. |1864| `disableMobileSimulatorTools` | auf `true` setzen, um Claudes Tools zum Steuern und Erfassen von Geräten im [iOS-Simulator-Bereich](/docs/de/desktop-ios-simulator#turn-off-simulator-access) zu blockieren. Der Bereich bleibt für die eigenen Taps des Benutzers nutzbar; nur Claudes Zugriff wird entfernt. Der Wert muss der JSON-Boolean `true` sein; der String `"true"` wird ignoriert. |

1614| `disableBrowserExternalNavigation` | auf `true` setzen, um externe Browsing im [Browser-Bereich](#browse-external-sites) vollständig auszuschalten. Weder Benutzer noch Claude können zu externen Websites navigieren, und localhost Dev-Server-Vorschauen sind nicht betroffen. Der Wert muss der JSON-Boolean `true` sein; der String `"true"` wird ignoriert. |1865| `disableBrowserExternalNavigation` | auf `true` setzen, um externe Browsing im [Browser-Bereich](#browse-external-sites) vollständig auszuschalten. Weder Benutzer noch Claude können zu externen Websites navigieren, und localhost Dev-Server-Vorschauen sind nicht betroffen. Der Wert muss der JSON-Boolean `true` sein; der String `"true"` wird ignoriert. |

1615| `sshConfigs` | vorkonfigurieren Sie [SSH-Verbindungen](#pre-configure-ssh-connections-for-your-team), die in der Umgebungs-Dropdown angezeigt werden. Benutzer können verwaltete Verbindungen nicht löschen und daran nichts außer ihrem eigenen **Worktree-Ordner** bearbeiten. |1866| `sshConfigs` | vorkonfigurieren Sie [SSH-Verbindungen](#pre-configure-ssh-connections-for-your-team), die in der Umgebungsauswahl angezeigt werden. Benutzer können verwaltete Verbindungen nicht löschen und daran nichts außer ihrem eigenen **Worktree-Ordner** bearbeiten. |

1616| `sshHostAllowlist` | beschränken Sie [SSH-Sitzungen](#restrict-which-ssh-hosts-users-can-connect-to) auf Hosts, deren aufgelöster Hostname einem dieser Muster entspricht. Wird nur aus verwalteten Einstellungen gelesen. |1867| `sshHostAllowlist` | beschränken Sie [SSH-Sitzungen](#restrict-which-ssh-hosts-users-can-connect-to) auf Hosts, deren aufgelöster Hostname einem dieser Muster entspricht. Wird nur aus verwalteten Einstellungen gelesen. |

1617| `disableDesktopLocalSessions` | auf `true` setzen, um [Code-Sitzungen, die auf dem Gerät ausgeführt werden](#local-sessions-on-managed-devices), auszuschalten und SSH-Sitzungen zu anderen Hosts sowie Cloud-Sitzungen verfügbar zu lassen. Der Wert muss der JSON-Boolean `true` sein. Wird nur aus verwalteten Einstellungen gelesen. Erfordert Claude Desktop v1.37937.0 oder später. |1868| `disableDesktopLocalSessions` | auf `true` setzen, um [Code-Sitzungen, die auf dem Gerät ausgeführt werden](#local-sessions-on-managed-devices), auszuschalten und SSH-Sitzungen zu anderen Hosts sowie Cloud-Sitzungen verfügbar zu lassen. Der Wert muss der JSON-Boolean `true` sein. Wird nur aus verwalteten Einstellungen gelesen. Erfordert Claude Desktop v1.37937.0 oder später. |

1618| `disableSshSavedPasswords` | auf `true` setzen, damit Desktop nicht mehr anbietet, SSH-Passwörter zu speichern, und die zuvor gespeicherten weder verwendet noch anzeigt. Das Einschalten löscht diese nicht. Wird nur aus verwalteten Einstellungen gelesen. Erfordert Claude Desktop v1.49585.0 oder später. |1869| `disableSshSavedPasswords` | auf `true` setzen, damit Desktop nicht mehr anbietet, SSH-Passwörter zu speichern, und die zuvor gespeicherten weder verwendet noch anzeigt. Das Einschalten löscht diese nicht. Wird nur aus verwalteten Einstellungen gelesen. Erfordert Claude Desktop v1.49585.0 oder später. |


1756 2007 

1757| CLI | Desktop-Äquivalent |2008| CLI | Desktop-Äquivalent |

1758| - | - |2009| - | - |

1759| `--model sonnet` | Modell-Dropdown neben der Schaltfläche „Senden“ |2010| `--model sonnet` | Modellauswahl in der Zeile unter dem Eingabefeld |

1760| `--resume`, `--continue` | Klicken Sie auf eine Sitzung in der Seitenleiste, oder geben Sie `/resume` in das Eingabefeld ein, um eine Sitzung aufzugreifen, die Sie von der CLI gestartet haben |2011| `--resume`, `--continue` | Klicken Sie auf eine Sitzung in der Seitenleiste, oder geben Sie `/resume` in das Eingabefeld ein, um eine Sitzung aufzugreifen, die Sie von der CLI gestartet haben |

1761| `--permission-mode` | Moduswahlschalter neben der Schaltfläche „Senden“ |2012| `--permission-mode` | Moduswahlschalter in der Zeile unter dem Eingabefeld |

1762| `--dangerously-skip-permissions` | Bypass-Berechtigungsmodus. Aktivieren Sie auf Pro- und Max-Plänen in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen“; auf Team- und Enterprise-Plänen wird es durch die Organisationsrichtlinie gesteuert |2013| `--dangerously-skip-permissions` | Bypass-Berechtigungsmodus. Aktivieren Sie auf Pro- und Max-Plänen in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen“; auf Team- und Enterprise-Plänen wird es durch die Organisationsrichtlinie gesteuert |

1763| `--add-dir` | Fügen Sie mehrere Repos mit der Schaltfläche **+** in Cloud-Sitzungen hinzu |2014| `--add-dir` | [Ordner zu einer Sitzung hinzufügen](#add-folders-to-a-session) in lokalen und SSH-Sitzungen, oder wählen Sie in einer Cloud-Sitzung [mehrere Repositorys](#run-long-running-tasks-in-the-cloud) aus |

1764| `--allowedTools`, `--disallowedTools` | Kein Pro-Sitzungs-Äquivalent. Berechtigungsregeln in [Einstellungsdateien](/docs/de/settings) gelten weiterhin. |2015| `--allowedTools`, `--disallowedTools` | Kein Pro-Sitzungs-Äquivalent. Berechtigungsregeln in [Einstellungsdateien](/docs/de/settings) gelten weiterhin. |

1765| `--verbose` | [Ausführlicher Ansichtsmodus](#switch-view-modes) |2016| `--verbose` | [Ausführlicher Ansichtsmodus](#switch-view-modes) |

1766| `--print`, `--output-format` | Nicht verfügbar. Desktop ist nur interaktiv. |2017| `--print`, `--output-format` | Nicht verfügbar. Desktop ist nur interaktiv. |

1767| `ANTHROPIC_MODEL` Umgebungsvariable | Modell-Dropdown neben der Schaltfläche „Senden“ |2018| `ANTHROPIC_MODEL` Umgebungsvariable | Modellauswahl in der Zeile unter dem Eingabefeld |

1768| `MAX_THINKING_TOKENS` Umgebungsvariable | Im lokalen Umgebungs-Editor festlegen. Siehe [Umgebungskonfiguration](#environment-configuration). |2019| `MAX_THINKING_TOKENS` Umgebungsvariable | Siehe [Extended Thinking ausschalten](#turn-off-extended-thinking) |

1769 2020 

1770<h3 id="shared-configuration">2021<h3 id="shared-configuration">

1771 Gemeinsame Konfiguration2022 Gemeinsame Konfiguration


1777* **[MCP-Server](/docs/de/mcp)**, die in `~/.claude.json` oder `.mcp.json` konfiguriert sind, funktionieren in beiden2028* **[MCP-Server](/docs/de/mcp)**, die in `~/.claude.json` oder `.mcp.json` konfiguriert sind, funktionieren in beiden

1778* **[Hooks](/docs/de/hooks)** und **[Skills](/docs/de/skills)**, die in Einstellungen definiert sind, gelten für beide2029* **[Hooks](/docs/de/hooks)** und **[Skills](/docs/de/skills)**, die in Einstellungen definiert sind, gelten für beide

1779* **[Einstellungen](/docs/de/settings)** in `~/.claude.json` und `~/.claude/settings.json` werden geteilt. Berechtigungsregeln, erlaubte Tools und andere Einstellungen in `settings.json` gelten für Desktop-Sitzungen.2030* **[Einstellungen](/docs/de/settings)** in `~/.claude.json` und `~/.claude/settings.json` werden geteilt. Berechtigungsregeln, erlaubte Tools und andere Einstellungen in `settings.json` gelten für Desktop-Sitzungen.

1780* **Modelle**: die gleichen [Modelle](/docs/de/model-config#available-models) sind in beiden verfügbar. In Desktop wählen Sie das Modell aus dem Dropdown neben der Schaltfläche „Senden“. Sie können das Modell während der Sitzung über dasselbe Dropdown ändern.2031* **Modelle**: die gleichen [Modelle](/docs/de/model-config#available-models) sind in beiden verfügbar. In Desktop wählen Sie das Modell über die Modellauswahl in der Zeile unter dem Eingabefeld. Sie können das Modell während der Sitzung über dieselbe Auswahl ändern.

1781 2032 

1782<h4 id="mcp-servers-from-the-claude-desktop-chat-app">2033<h4 id="mcp-servers-from-the-claude-desktop-chat-app">

1783 MCP-Server aus der Claude Desktop Chat-App2034 MCP-Server aus der Claude Desktop Chat-App


1805| [Drittanbieter-Provider](/docs/de/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API standardmäßig. Für Gateway-Routing siehe [Desktop-App mit einem Gateway verbinden](/docs/de/llm-gateway-connect#desktop-app). Um die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway auszuführen, siehe [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |2056| [Drittanbieter-Provider](/docs/de/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API standardmäßig. Für Gateway-Routing siehe [Desktop-App mit einem Gateway verbinden](/docs/de/llm-gateway-connect#desktop-app). Um die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway auszuführen, siehe [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

1806| [MCP-Server](/docs/de/mcp) | In Einstellungsdateien konfigurieren | Konnektoren-UI für lokale und SSH-Sitzungen oder Einstellungsdateien |2057| [MCP-Server](/docs/de/mcp) | In Einstellungsdateien konfigurieren | Konnektoren-UI für lokale und SSH-Sitzungen oder Einstellungsdateien |

1807| [Plugins](/docs/de/plugins/overview) | `/plugin`-Befehl | Plugin-Manager-UI |2058| [Plugins](/docs/de/plugins/overview) | `/plugin`-Befehl | Plugin-Manager-UI |

1808| @mention-Dateien | Textbasiert | Mit Autovervollständigung; lokale und SSH-Sitzungen nur |2059| @mention-Dateien | Textbasiert | Mit Autovervollständigung, außer bei der ersten Nachricht einer Cloud-Sitzung |

1809| Dateianhänge | Nicht verfügbar | Bilder, PDFs |2060| Dateianhänge | Nicht verfügbar | Bilder, PDFs |

1810| Sitzungsisolation | [`--worktree`](/docs/de/cli-reference)-Flag | **worktree**-Option beim Starten einer Sitzung |2061| Sitzungsisolation | [`--worktree`](/docs/de/cli-reference)-Flag | [Eine Sitzung in einem eigenen Worktree ausführen](#run-a-session-in-its-own-worktree) |

1811| Mehrere Sitzungen | Separate Terminals | Seitenleisten-Tabs |2062| Mehrere Sitzungen | Separate Terminals | Seitenleisten-Tabs |

1812| Wiederkehrende Aufgaben | Cron-Jobs, CI-Pipelines | [Geplante Aufgaben](/docs/de/desktop-scheduled-tasks) |2063| Wiederkehrende Aufgaben | Cron-Jobs, CI-Pipelines | [Geplante Aufgaben](/docs/de/desktop-scheduled-tasks) |

1813| Computernutzung | [Aktivieren über `/mcp`](/docs/de/computer-use) auf macOS | [App- und Bildschirmsteuerung](#let-claude-use-your-computer) auf macOS und Windows |2064| Computernutzung | [Aktivieren über `/mcp`](/docs/de/computer-use) auf macOS | [App- und Bildschirmsteuerung](#let-claude-use-your-computer) auf macOS und Windows |


1833 Fehlerbehebung2084 Fehlerbehebung

1834</h2>2085</h2>

1835 2086 

1836Die folgenden Abschnitte behandeln Probleme, die spezifisch für die Desktop-App sind. Für Runtime-API-Fehler, die im Chat angezeigt werden, wie `API Error: 500`, `529 Overloaded`, `429` oder `Prompt is too long`, siehe die [Fehlerreferenz](/docs/de/errors). Diese Fehler und ihre Lösungen sind gleich über CLI, Desktop und Web.2087Die folgenden Abschnitte behandeln Probleme, die spezifisch für die Desktop-App sind. Für Runtime-API-Fehler, die im Chat angezeigt werden, wie `API Error: 500`, `529 Overloaded`, `429` oder `Prompt is too long`, siehe die [Fehlerreferenz](/docs/de/errors).

1837 2088 

1838<h3 id="check-your-version">2089<h3 id="check-your-version">

1839 Überprüfen Sie Ihre Version2090 Überprüfen Sie Ihre Version


1856 2107 

1857In einer lokalen Sitzung führt die Registerkarte **Code** ihre eigene Kopie von Claude Code aus, die eine eigene Versionsnummer hat. Die Desktop-App lädt diese Kopie herunter und aktualisiert sie. Daher kann sie sich vom Befehl `claude` in Ihrem Terminal unterscheiden, und das Aktualisieren der einen aktualisiert nicht die andere.2108In einer lokalen Sitzung führt die Registerkarte **Code** ihre eigene Kopie von Claude Code aus, die eine eigene Versionsnummer hat. Die Desktop-App lädt diese Kopie herunter und aktualisiert sie. Daher kann sie sich vom Befehl `claude` in Ihrem Terminal unterscheiden, und das Aktualisieren der einen aktualisiert nicht die andere.

1858 2109 

2110<h3 id="check-which-layout-you-have">

2111 Überprüfen Sie, welches Layout Sie haben

2112</h3>

2113 

2114Wenn eine neue Sitzung keine [Umgebungsauswahl](#start-a-session) unter dem Eingabefeld hat, verwenden Sie das frühere Layout:

2115 

2116* **[Desktop älter als v2.37337.0](#check-your-version)**: Aktualisieren Sie die App, um das aktuelle Layout zu erhalten. Wählen Sie unter macOS **Claude → Nach Updates suchen** bzw. unter Windows **Hilfe → Nach Updates suchen**.

2117* **[Drittanbieter](/docs/de/third-party-integrations)**: Sie behalten das frühere Layout, es ist also nichts zu tun.

2118 

2119Im früheren Layout wählen Sie die Umgebung und den Projektordner oberhalb des Eingabefelds sowie den Berechtigungsmodus und das Modell in der Zeile darunter. Dem früheren Layout fehlen der [Bereich mit Sitzungsdetails](#see-session-details) und die [gespeicherten lokalen und SSH-Umgebungen](#create-a-saved-environment).

2120 

1859<h3 id="403-or-authentication-errors-in-the-code-tab">2121<h3 id="403-or-authentication-errors-in-the-code-tab">

1860 403 oder Authentifizierungsfehler auf der Registerkarte „Code“2122 403 oder Authentifizierungsfehler auf der Registerkarte „Code“

1861</h3>2123</h3>

Details

160* Bestätigen Sie, dass Xcode und die iOS-Simulatoren installiert sind und dass Sie eine [empfohlene Xcode-Version](#requirements) verwenden.160* Bestätigen Sie, dass Xcode und die iOS-Simulatoren installiert sind und dass Sie eine [empfohlene Xcode-Version](#requirements) verwenden.

161* Wenn Ihre Organisation Claude Code verwaltet, können die [Simulator-Tools durch Policy deaktiviert sein](#turn-off-simulator-access).161* Wenn Ihre Organisation Claude Code verwaltet, können die [Simulator-Tools durch Policy deaktiviert sein](#turn-off-simulator-access).

162* Wenn Sie sich in einer Enterprise-Organisation mit aktivierter HIPAA-Konfiguration befinden, ist der Simulator-Bereich für Sie nicht verfügbar.162* Wenn Sie sich in einer Enterprise-Organisation mit aktivierter HIPAA-Konfiguration befinden, ist der Simulator-Bereich für Sie nicht verfügbar.

163* Der Simulator-Bereich erfordert Claude Desktop v1.24012.0 oder später. Öffnen Sie **Claude → Check for Updates** und starten Sie die App neu.163* Der Simulator-Bereich erfordert Claude Desktop v1.24012.0 oder später. Öffnen Sie **Claude > Check for Updates…** und starten Sie die App neu.

164 164 

165<h3 id="the-simulator-pane-says-no-simulators-were-found">165<h3 id="the-simulator-pane-says-no-simulators-were-found">

166 Der Simulator-Bereich sagt, dass keine Simulatoren gefunden wurden166 Der Simulator-Bereich sagt, dass keine Simulatoren gefunden wurden


174 174 

175* [Computernutzung in Desktop](/docs/de/desktop#let-claude-use-your-computer): Bildschirmsteuerung für Apps ohne einen dedizierten Bereich175* [Computernutzung in Desktop](/docs/de/desktop#let-claude-use-your-computer): Bildschirmsteuerung für Apps ohne einen dedizierten Bereich

176* [Computernutzung über die CLI](/docs/de/computer-use): wie die CLI den iOS-Simulator erreicht176* [Computernutzung über die CLI](/docs/de/computer-use): wie die CLI den iOS-Simulator erreicht

177* [Arbeiten Sie parallel mit Sitzungen](/docs/de/desktop#work-in-parallel-with-sessions): wie Sitzungen Änderungen isolieren177* [Eine Sitzung in einem eigenen Worktree ausführen](/docs/de/desktop#run-a-session-in-its-own-worktree): wie Sitzungen Änderungen isolieren

178* [Erste Schritte mit Claude Code Desktop](/docs/de/desktop-quickstart)178* [Erste Schritte mit Claude Code Desktop](/docs/de/desktop-quickstart)

Details

63 63 

64<Steps>64<Steps>

65 <Step title="Wählen Sie eine Umgebung und einen Ordner">65 <Step title="Wählen Sie eine Umgebung und einen Ordner">

66 Wählen Sie **Lokal**, um Claude auf Ihrem Computer mit Ihren Dateien direkt auszuführen. Klicken Sie auf **Ordner auswählen** und wählen Sie Ihr Projektverzeichnis.66 Klicken Sie in der [Zeile unter dem Eingabefeld](/docs/de/desktop#start-a-session) auf das erste Steuerelement, die Umgebungsauswahl, und wählen Sie den obersten Eintrag in der Gruppe **Lokal**. Klicken Sie dann auf das Steuerelement für den Projektordner neben der Umgebungsauswahl, wählen Sie **Ordner öffnen…** und wählen Sie das Verzeichnis Ihres Projekts.

67 

68 Wenn unter Ihrem Eingabefeld keine Umgebungsauswahl angezeigt wird, verwenden Sie das frühere Layout. Siehe [Prüfen, welches Layout Sie verwenden](/docs/de/desktop#check-which-layout-you-have).

67 69 

68 <Tip>70 <Tip>

69 Beginnen Sie mit einem kleinen Projekt, das Sie gut kennen. Das ist der schnellste Weg, um zu sehen, was Claude Code kann.71 Beginnen Sie mit einem kleinen Projekt, das Sie gut kennen. Das ist der schnellste Weg, um zu sehen, was Claude Code kann.


72 Sie können auch folgende Optionen wählen:74 Sie können auch folgende Optionen wählen:

73 75 

74 * **Cloud**: Führen Sie Sitzungen in der Cloud aus, die auch dann fortgesetzt werden, wenn Sie die App schließen. Siehe [Claude Code in der Cloud verwenden](/docs/de/claude-code-on-the-web), um zu erfahren, wie Cloud-Sitzungen funktionieren.76 * **Cloud**: Führen Sie Sitzungen in der Cloud aus, die auch dann fortgesetzt werden, wenn Sie die App schließen. Siehe [Claude Code in der Cloud verwenden](/docs/de/claude-code-on-the-web), um zu erfahren, wie Cloud-Sitzungen funktionieren.

75 * **SSH**: Verbinden Sie sich über SSH mit einem Remote-Computer, z. B. mit Ihren eigenen Servern, Cloud-VMs oder Dev-Containern. Desktop installiert Claude Code beim ersten Verbinden automatisch auf dem Remote-Computer. Eine laufende Aufgabe kann [weiterlaufen, während Desktop getrennt ist](/docs/de/desktop#keep-a-task-running-while-desktop-is-disconnected), kann aber bei einem Claude-Konto anhalten, wenn dessen Anmeldung abläuft.77 * **SSH**: Verbinden Sie sich über SSH mit einem Remote-Computer, z. B. mit Ihren eigenen Servern, Cloud-VMs oder Dev-Containern. [Fügen Sie zuerst eine Verbindung hinzu](/docs/de/desktop#ssh-sessions). Desktop installiert Claude Code beim ersten Verbinden automatisch auf dem Remote-Computer. Eine laufende Aufgabe kann [weiterlaufen, während Desktop getrennt ist](/docs/de/desktop#keep-a-task-running-while-desktop-is-disconnected), kann aber bei einem Claude-Konto anhalten, wenn dessen Anmeldung abläuft.

76 * **WSL** (Windows): Führen Sie die Sitzung in einer [WSL 2-Distribution](/docs/de/desktop-wsl) aus; Claude Code, Tools und Git werden auf der Linux-Seite mit nativen Pfaden ausgeführt.78 * **WSL** (Windows): Führen Sie die Sitzung in einer [WSL 2-Distribution](/docs/de/desktop-wsl) aus; Claude Code, Tools und Git werden auf der Linux-Seite mit nativen Pfaden ausgeführt.

77 </Step>79 </Step>

78 80 

79 <Step title="Wählen Sie ein Modell">81 <Step title="Wählen Sie ein Modell">

80 Wählen Sie ein Modell aus dem Dropdown-Menü neben der Schaltfläche zum Senden. Siehe [Modelle](/docs/de/model-config#available-models) für einen Vergleich der verfügbaren Modelle. Sie können das Modell später über das gleiche Dropdown-Menü ändern.82 Wählen Sie ein Modell aus der Modellauswahl am rechten Ende der Zeile unter dem Eingabefeld. Siehe [Modelle](/docs/de/model-config#available-models) für einen Vergleich der verfügbaren Modelle. Sie können das Modell später über die Modellauswahl ändern.

81 </Step>83 </Step>

82 84 

83 <Step title="Sagen Sie Claude, was zu tun ist">85 <Step title="Sagen Sie Claude, was zu tun ist">


87 * `Add tests for the main function`89 * `Add tests for the main function`

88 * `Create a CLAUDE.md with instructions for this codebase`90 * `Create a CLAUDE.md with instructions for this codebase`

89 91 

90 Eine [Sitzung](/docs/de/desktop#work-in-parallel-with-sessions) ist ein Gespräch mit Claude über Ihren Code. Jede Sitzung verfolgt ihren eigenen Kontext und ihre Änderungen.92 Eine [Sitzung](/docs/de/desktop#work-in-parallel-with-sessions) ist eine Konversation mit Claude über Ihren Code. Jede Sitzung verfolgt ihren eigenen Kontext und ihre Änderungen.

91 </Step>93 </Step>

92 94 

93 <Step title="Überprüfen und akzeptieren Sie Änderungen">95 <Step title="Überprüfen und akzeptieren Sie Änderungen">

94 Was als Nächstes geschieht, hängt vom [Berechtigungsmodus](/docs/de/desktop#choose-a-permission-mode) ab, der in der Auswahl neben der Schaltfläche zum Senden angezeigt wird:96 Prü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:

95 97 

96 * **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önnen98 * **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önnen

97 * **Manuell**: Claude schlägt jede Änderung vor und wartet auf Ihre Genehmigung, bevor sie angewendet wird. Ihre Dateien werden erst geändert, wenn Sie akzeptieren. Wenn Sie eine Änderung ablehnen, fragt Claude, wie Sie stattdessen vorgehen möchten99 * **Manuell**: Claude schlägt jede Änderung vor und wartet auf Ihre Genehmigung, bevor sie angewendet wird

98 100 

99 Im Manuellen Modus sehen Sie:101 Im Manuellen Modus sehen Sie:

100 102 


112 114 

113**Unterbrechen und lenken.** Sie können Claude jederzeit umleiten. Klicken Sie auf die Stoppschaltfläche, um sofort zu unterbrechen, oder geben Sie eine Korrektur ein und drücken Sie **Eingabe**, um sie zu senden, ohne die laufende Aktion zu stoppen. In beiden Fällen müssen Sie nicht warten, bis sie abgeschlossen ist, oder von vorne beginnen.115**Unterbrechen und lenken.** Sie können Claude jederzeit umleiten. Klicken Sie auf die Stoppschaltfläche, um sofort zu unterbrechen, oder geben Sie eine Korrektur ein und drücken Sie **Eingabe**, um sie zu senden, ohne die laufende Aktion zu stoppen. In beiden Fällen müssen Sie nicht warten, bis sie abgeschlossen ist, oder von vorne beginnen.

114 116 

115**Geben Sie Claude mehr Kontext.** Geben Sie `@filename` in das Eingabefeld ein, um eine bestimmte Datei in das Gespräch zu ziehen, fügen Sie Bilder und PDFs mit der Schaltfläche „Anhang“ an, oder ziehen Sie Dateien direkt per Drag-and-Drop in die Eingabe. Je mehr Kontext Claude hat, desto besser sind die Ergebnisse. Siehe [Dateien und Kontext hinzufügen](/docs/de/desktop#add-files-and-context-to-prompts).117**Geben Sie Claude mehr Kontext.** Geben Sie `@filename` in das Eingabefeld ein, um eine bestimmte Datei in die Konversation zu ziehen. Je mehr Kontext Claude hat, desto besser sind die Ergebnisse. Siehe [Dateien und Kontext hinzufügen](/docs/de/desktop#add-files-and-context-to-prompts).

116 118 

117**Verwenden Sie Skills für wiederholbare Aufgaben.** Geben Sie `/` ein oder klicken Sie auf **+** → **Slash commands**, um [integrierte Befehle](/docs/de/commands), [benutzerdefinierte Skills](/docs/de/skills) und Plugin-Skills zu durchsuchen. Skills sind wiederverwendbare Eingabeaufforderungen, die Sie jederzeit aufrufen können, z. B. Code-Review-Checklisten oder Bereitstellungsschritte.119**Verwenden Sie Skills für wiederholbare Aufgaben.** Geben Sie `/` ein oder klicken Sie auf **+** → **Slash commands**, um [integrierte Befehle](/docs/de/commands), [benutzerdefinierte Skills](/docs/de/skills) und Plugin-Skills zu durchsuchen. Skills sind wiederverwendbare Eingabeaufforderungen, die Sie jederzeit aufrufen können, z. B. Code-Review-Checklisten oder Bereitstellungsschritte.

118 120 


125* **Bearbeitungen akzeptieren**: Claude akzeptiert Dateibearbeitungen automatisch für schnellere Iteration.127* **Bearbeitungen akzeptieren**: Claude akzeptiert Dateibearbeitungen automatisch für schnellere Iteration.

126* **Plan**: Claude schlägt einen Ansatz vor, ohne Dateien zu bearbeiten, was vor einem großen Refactoring nützlich ist.128* **Plan**: Claude schlägt einen Ansatz vor, ohne Dateien zu bearbeiten, was vor einem großen Refactoring nützlich ist.

127 129 

128**Fügen Sie Plugins für mehr Funktionen hinzu.** Klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Plugins**, um [Plugins](/docs/de/desktop#install-plugins) zu durchsuchen und zu installieren, die Skills, Agents, MCP-Server und mehr hinzufügen.130**Fügen Sie Plugins für mehr Funktionen hinzu.** Installieren Sie [Plugins](/docs/de/desktop#install-plugins), die Skills, Agenten, MCP-Server und mehr hinzufügen.

129 131 

130**Ordnen Sie Ihren Arbeitsbereich an.** Ziehen Sie die Chat-, Diff-, Terminal-, Datei- und Browser-Bereiche in das gewünschte Layout. Öffnen Sie das Terminal mit **Strg+\`**, um Befehle neben Ihrer Sitzung auszuführen, oder klicken Sie auf einen Dateipfad, um ihn im Dateibereich zu öffnen. Siehe [Arbeitsbereich anordnen](/docs/de/desktop#arrange-your-workspace).132**Ordnen Sie Ihren Arbeitsbereich an.** Ziehen Sie die Chat-, Diff-, Terminal-, Datei- und Browser-Bereiche in das gewünschte Layout. Öffnen Sie das Terminal mit **Strg+\`**, um Befehle neben Ihrer Sitzung auszuführen, oder klicken Sie auf einen Dateipfad, um ihn zu öffnen. Siehe [Arbeitsbereich anordnen](/docs/de/desktop#arrange-your-workspace).

131 133 

132**Zeigen Sie eine Vorschau Ihrer App an.** Wenn Sie Ihren Dev-Server auf dem Desktop ausführen, wird Ihre App im Browser-Bereich geöffnet, der auch [externe Websites öffnen](/docs/de/desktop#browse-external-sites) kann. Claude kann die laufende App anzeigen, Endpunkte testen, Protokolle überprüfen und auf das reagieren, was es sieht. Siehe [Zeigen Sie eine Vorschau Ihrer App an](/docs/de/desktop#preview-your-app).134**Zeigen Sie eine Vorschau Ihrer App an.** Wenn Sie Ihren Dev-Server auf dem Desktop ausführen, wird Ihre App im Browser-Bereich geöffnet, der auch [externe Websites öffnen](/docs/de/desktop#browse-external-sites) kann. Claude kann die laufende App anzeigen, Endpunkte testen, Protokolle überprüfen und auf das reagieren, was es sieht. Siehe [Zeigen Sie eine Vorschau Ihrer App an](/docs/de/desktop#preview-your-app).

133 135 

134**Verfolgen Sie Ihren Pull Request.** Nach dem Öffnen eines PR überwacht Claude Code die CI-Prüfungsergebnisse und kann Fehler automatisch beheben oder den PR zusammenführen, sobald alle Prüfungen bestanden sind. Siehe [Überwachen Sie den Pull-Request-Status](/docs/de/desktop#monitor-pull-request-status).136**Verfolgen Sie Ihren Pull Request.** Nach dem Öffnen eines PR überwacht Claude Code die CI-Prüfungsergebnisse und kann Fehler automatisch beheben. Siehe [Überwachen Sie den Pull-Request-Status](/docs/de/desktop#monitor-pull-request-status).

135 137 

136**Planen Sie Claude ein.** Richten Sie [geplante Aufgaben](/docs/de/desktop-scheduled-tasks) ein, um Claude automatisch regelmäßig auszuführen: eine tägliche Code-Überprüfung jeden Morgen, eine wöchentliche Abhängigkeitsprüfung oder eine Zusammenfassung, die Daten aus Ihren verbundenen Tools abruft.138**Planen Sie Claude ein.** Richten Sie [geplante Aufgaben](/docs/de/desktop-scheduled-tasks) ein, um Claude automatisch regelmäßig auszuführen: eine tägliche Code-Überprüfung jeden Morgen, eine wöchentliche Abhängigkeitsprüfung oder eine Zusammenfassung, die Daten aus Ihren verbundenen Tools abruft.

137 139 

Details

33</Tip>33</Tip>

34 34 

35<Note>35<Note>

36 Standardmäßig werden geplante Aufgaben für den aktuellen Zustand Ihres Arbeitsverzeichnisses ausgeführt, einschließlich nicht committeter Änderungen. Aktivieren Sie den Worktree-Schalter beim Erstellen der Aufgabe, um jeder Ausführung ihren eigenen isolierten Git-Worktree zu geben, auf die gleiche Weise wie [parallele Sitzungen](/docs/de/desktop#work-in-parallel-with-sessions) funktionieren.36 Standardmäßig werden geplante Aufgaben für den aktuellen Zustand Ihres Arbeitsverzeichnisses ausgeführt, einschließlich nicht committeter Änderungen. Aktivieren Sie den Worktree-Schalter beim Erstellen der Aufgabe, um jeder Ausführung ihren eigenen [isolierten Git-Worktree](/docs/de/desktop#run-a-session-in-its-own-worktree) zu geben.

37</Note>37</Note>

38 38 

39<h2 id="create-a-scheduled-task">39<h2 id="create-a-scheduled-task">

desktop-wsl.md +20 −6

Details

24 24 

25<Steps>25<Steps>

26 <Step title="Wählen Sie eine Distribution">26 <Step title="Wählen Sie eine Distribution">

27 Starten Sie eine neue Sitzung in der Registerkarte Code und öffnen Sie die Umgebungsauswahl. Ihre installierten WSL 2-Distributionen werden in einem Abschnitt **WSL** angezeigt. Wählen Sie eine aus.27 Starten Sie eine neue Sitzung in der Registerkarte Code und öffnen Sie die [Umgebungsauswahl](/docs/de/desktop#start-a-session) unter dem Eingabefeld bzw. im [früheren Layout](/docs/de/desktop#check-which-layout-you-have) darüber. Ihre installierten WSL 2-Distributionen werden unter **WSL** angezeigt. Wählen Sie eine aus.

28 </Step>28 </Step>

29 29 

30 <Step title="Wählen Sie einen Ordner">30 <Step title="Wählen Sie einen Ordner">


32 </Step>32 </Step>

33 33 

34 <Step title="Vertrauen Sie dem Ordner">34 <Step title="Vertrauen Sie dem Ordner">

35 Die erste Sitzung in einem Ordner zeigt den Dialog zur Workspace-Vertrauenswürdigkeit. Vertrauen wird pro Distribution und Ordner gewährt; das Vertrauen in einen Ordner in einer Distribution gilt nicht für eine andere Distribution oder denselben Pfad unter Windows.35 Die erste Sitzung in einem Ordner zeigt den Dialog zur Workspace-Vertrauenswürdigkeit. Sie gewähren Vertrauen pro Distribution und Ordner. Ein Ordner, dem Sie in einer Distribution vertrauen, gilt in einer anderen Distribution oder unter demselben Pfad unter Windows nicht als vertrauenswürdig.

36 </Step>36 </Step>

37</Steps>37</Steps>

38 38 

39Die erste Sitzung in einer Distribution dauert etwas länger, während Claude sich darin einrichtet. Sie können auch einen Ordner `\\wsl.localhost\...` aus der normalen Ordnerauswahl öffnen, und er wird in dieser Distribution erneut geöffnet.39Die erste Sitzung in einer Distribution dauert etwas länger, während Claude sich darin einrichtet. Sie können auch einen Ordner `\\wsl.localhost\...` aus der normalen Ordnerauswahl öffnen, und er wird in dieser Distribution erneut geöffnet.

40 40 

41Ordner, die Sie kürzlich verwendet haben, werden in der Auswahl pro Distribution angezeigt, sodass das erneute Verbinden mit einem Projekt nur einen Klick erfordert.

42 

43<h2 id="what-works-in-a-wsl-session">41<h2 id="what-works-in-a-wsl-session">

44 Was in einer WSL-Sitzung funktioniert42 Was in einer WSL-Sitzung funktioniert

45</h2>43</h2>

46 44 

47Parallele Sitzungen, Seitenchats, visuelle Diff-Überprüfung, Branch- und Pull-Request-Status sowie Worktrees funktionieren alle, unterstützt durch Git und die Toolchain in der Distribution. „In Editor öffnen" öffnet VS Code, das über [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) mit der Distribution verbunden ist.45Parallele Sitzungen, Seitenchats, visuelle Diff-Überprüfung, Branch- und Pull-Request-Status sowie Worktrees funktionieren alle, unterstützt durch Git und die Toolchain in der Distribution. „In Editor öffnen“ öffnet VS Code, das über [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) mit der Distribution verbunden ist.

46 

47Wenn eine Desktop-Funktion in einer WSL-Sitzung nicht verfügbar oder eingeschränkt ist, prüfen Sie, ob es sich um eine der folgenden handelt:

48 

49* **Terminal und Konnektoren**: Ihrer Sitzung fehlen möglicherweise das [integrierte Terminal](/docs/de/desktop#run-commands-in-the-terminal), die [Konnektoren](/docs/de/desktop#connect-external-tools) oder beides. Siehe [Wenn das Terminal oder die Konnektoren nicht verfügbar sind](#check-for-the-terminal-and-connectors).

50* **[Plugins](/docs/de/desktop#install-plugins)**: in WSL-Sitzungen nicht verfügbar

51* **Dateibearbeitung**: Sie können Dateien im [Dateibereich](/docs/de/desktop#open-and-edit-files) anzeigen, dort aber nicht bearbeiten. Bitten Sie daher Claude, die Änderungen vorzunehmen

52* **Anhänge**: Wenn das Menü **+** anstelle von **Add files or photos** die Option **Add image** anzeigt, können Sie nur Bilder anhängen. Siehe [Dateien und Kontext zu Prompts hinzufügen](/docs/de/desktop#add-files-and-context-to-prompts).

53 

54<a id="check-for-the-terminal-and-connectors" />

55 

56<h3 id="if-the-terminal-or-connectors-are-unavailable">

57 Wenn das Terminal oder die Konnektoren nicht verfügbar sind

58</h3>

59 

60Sie können das integrierte Terminal oder die Konnektoren für eine WSL-Sitzung nicht selbst aktivieren:

48 61 

49Einige Funktionen sind in WSL-Sitzungen noch nicht verfügbar: das integrierte Terminal, Connectors und Plugins, Sitzungs-Forking, der Datei-Browser-Bereich und Dateivorschläge, wenn Sie `@` im Composer eingeben.62* **Claude-Konto**: Die beiden Funktionen werden getrennt voneinander eingeführt. Wählen Sie **Help > Check for Updates…**. Wenn eine Funktion nach dem Update weiterhin fehlt, müssen Sie nichts weiter tun.

63* **[Drittanbieter](/docs/de/third-party-integrations)**: WSL-Sitzungen erhalten weder das Terminal noch die Konnektoren, und ein Update von Desktop ändert daran nichts

50 64 

51<h2 id="managed-devices">65<h2 id="managed-devices">

52 Verwaltete Geräte66 Verwaltete Geräte

env-vars.md +7 −11

Details

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

197| `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 |197| `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 |

198| `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 |198| `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 |

199| `API_TIMEOUT_MS` | Timeout für API-Anfragen in Millisekunden (Standard: 600000 bzw. 10 Minuten; Maximum: 2147483647). Eine Streaming-Anfrage muss ihre Response-Header innerhalb dieser Zeit erhalten. Erhöhen Sie diesen Wert, wenn Anfragen in langsamen Netzwerken oder beim Routing über einen Proxy in einen Timeout laufen |199| `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 |

200| `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/)) |200| `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/)) |

201| `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 |201| `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 |

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


230| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | In v2.1.283 entfernt. Verwenden Sie stattdessen `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |230| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | In v2.1.283 entfernt. Verwenden Sie stattdessen `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

231| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Legt das [Fenster für die automatische Komprimierung](/docs/de/model-config#set-the-auto-compact-window) in Token fest, von `100000` bis `1000000`. Akzeptiert nur eine einfache Ganzzahl wie `500000`: Ein Wert wie `500k` wird als `500` gelesen und auf das Minimum von 100K angehoben. Das effektive Fenster ist außerdem auf das Kontextfenster des Modells begrenzt. Hat Vorrang vor dem Befehl `/autocompact`, dem Flag `--autocompact` und der Einstellung `autoCompactWindow`. Der Wert `used_percentage` der Statuszeile bemisst sich immer am vollständigen Kontextfenster des Modells, sodass dieser Prozentsatz, sobald diese Variable gesetzt ist, nicht mehr anzeigt, wann die Komprimierung ausgeführt wird |231| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Legt das [Fenster für die automatische Komprimierung](/docs/de/model-config#set-the-auto-compact-window) in Token fest, von `100000` bis `1000000`. Akzeptiert nur eine einfache Ganzzahl wie `500000`: Ein Wert wie `500k` wird als `500` gelesen und auf das Minimum von 100K angehoben. Das effektive Fenster ist außerdem auf das Kontextfenster des Modells begrenzt. Hat Vorrang vor dem Befehl `/autocompact`, dem Flag `--autocompact` und der Einstellung `autoCompactWindow`. Der Wert `used_percentage` der Statuszeile bemisst sich immer am vollständigen Kontextfenster des Modells, sodass dieser Prozentsatz, sobald diese Variable gesetzt ist, nicht mehr anzeigt, wann die Komprimierung ausgeführt wird |

232| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Überschreibt die automatische [IDE-Verbindung](/docs/de/vs-code). Standardmäßig verbindet sich Claude Code automatisch, wenn es im integrierten Terminal einer unterstützten IDE gestartet wird. Setzen Sie `false`, um dies zu verhindern. Setzen Sie `true`, um einen Verbindungsversuch zu erzwingen, wenn die automatische Erkennung fehlschlägt, etwa wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der globalen Konfigurationseinstellung [`autoConnectIde`](/docs/de/settings-reference#autoconnectide) |232| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Überschreibt die automatische [IDE-Verbindung](/docs/de/vs-code). Standardmäßig verbindet sich Claude Code automatisch, wenn es im integrierten Terminal einer unterstützten IDE gestartet wird. Setzen Sie `false`, um dies zu verhindern. Setzen Sie `true`, um einen Verbindungsversuch zu erzwingen, wenn die automatische Erkennung fehlschlägt, etwa wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der globalen Konfigurationseinstellung [`autoConnectIde`](/docs/de/settings-reference#autoconnectide) |

233| `CLAUDE_CODE_AUTO_MODE_MODEL` | Legt das Modell für die Klassifikator-Anfragen fest, die Claude Code im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) sendet. Verwenden Sie eine vollständige Modell-ID wie `claude-sonnet-4-6`. Für die Fälle, in denen Claude Code sie ignoriert, siehe [Klassifikatormodell auswählen](/docs/de/permission-modes#choose-the-classifier-model). Erfordert Claude Code v2.1.302 oder höher |

233| `CLAUDE_CODE_AUTO_MODE_SERVER` | Steuert, ob Claude Code den Server bittet, [Aktionen im Auto-Modus zu prüfen](/docs/de/permission-modes#server-side-classifier-review). Setzen Sie `0`, um stattdessen die eigenen Klassifikator-Anfragen von Claude Code zu verwenden. Erfordert bei einer direkten Verbindung zur Anthropic-API v2.1.281 oder höher. Der verlinkte Abschnitt listet auf, welche Sitzungen den Server anfragen, wenn die Variable nicht gesetzt ist, und ab welcher Version. Erfordert Claude Code v2.1.271 oder höher |234| `CLAUDE_CODE_AUTO_MODE_SERVER` | Steuert, ob Claude Code den Server bittet, [Aktionen im Auto-Modus zu prüfen](/docs/de/permission-modes#server-side-classifier-review). Setzen Sie `0`, um stattdessen die eigenen Klassifikator-Anfragen von Claude Code zu verwenden. Erfordert bei einer direkten Verbindung zur Anthropic-API v2.1.281 oder höher. Der verlinkte Abschnitt listet auf, welche Sitzungen den Server anfragen, wenn die Variable nicht gesetzt ist, und ab welcher Version. Erfordert Claude Code v2.1.271 oder höher |

234| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Zeit in Millisekunden, die Claude Code darauf wartet, dass die AWS-Standardkette der Anmeldedatenanbieter Anmeldedaten liefert, bevor die Anfrage mit [`AWS default-chain credential resolve timed out`](/docs/de/errors#aws-default-chain-credential-resolve-timed-out) fehlschlägt (Standard: `60000`). Erhöhen Sie den Wert, wenn ein Schritt in Ihrer Kette berechtigterweise länger braucht, etwa eine browserbasierte SSO-Anmeldung mit MFA über einen Wrapper wie `aws-vault`. Gilt für Amazon Bedrock, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Siehe [Zwischenspeicherung von Anmeldedaten und Timeout für die Auflösung](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout). Erfordert Claude Code v2.1.207 oder höher |235| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Zeit in Millisekunden, die Claude Code darauf wartet, dass die AWS-Standardkette der Anmeldedatenanbieter Anmeldedaten liefert, bevor die Anfrage mit [`AWS default-chain credential resolve timed out`](/docs/de/errors#aws-default-chain-credential-resolve-timed-out) fehlschlägt (Standard: `60000`). Erhöhen Sie den Wert, wenn ein Schritt in Ihrer Kette berechtigterweise länger braucht, etwa eine browserbasierte SSO-Anmeldung mit MFA über einen Wrapper wie `aws-vault`. Gilt für Amazon Bedrock, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Siehe [Zwischenspeicherung von Anmeldedaten und Timeout für die Auflösung](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout). Erfordert Claude Code v2.1.207 oder höher |

235| `CLAUDE_CODE_BASH_EDIT_DIFF` | Setzen Sie `0`, um den [Diff der Dateien, die sich während der Ausführung eines Bash-Befehls geändert haben](/docs/de/hooks#bash), auszuschalten, oder `1`, um ihn in jedem Berechtigungsmodus aufzuzeichnen. Hat Vorrang vor der Einstellung [`bashEditDiffEnabled`](/docs/de/settings-reference#basheditdiffenabled). Erfordert Claude Code v2.1.269 oder höher |236| `CLAUDE_CODE_BASH_EDIT_DIFF` | Setzen Sie `0`, um den [Diff der Dateien, die sich während der Ausführung eines Bash-Befehls geändert haben](/docs/de/hooks#bash), auszuschalten, oder `1`, um ihn in jedem Berechtigungsmodus aufzuzeichnen. Hat Vorrang vor der Einstellung [`bashEditDiffEnabled`](/docs/de/settings-reference#basheditdiffenabled). Erfordert Claude Code v2.1.269 oder höher |


241| `CLAUDE_CODE_CLIENT_CERT` | Pfad zur Client-Zertifikatsdatei für die mTLS-Authentifizierung |242| `CLAUDE_CODE_CLIENT_CERT` | Pfad zur Client-Zertifikatsdatei für die mTLS-Authentifizierung |

242| `CLAUDE_CODE_CLIENT_KEY` | Pfad zur Datei mit dem privaten Client-Schlüssel für die mTLS-Authentifizierung |243| `CLAUDE_CODE_CLIENT_KEY` | Pfad zur Datei mit dem privaten Client-Schlüssel für die mTLS-Authentifizierung |

243| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase für einen verschlüsselten CLAUDE\_CODE\_CLIENT\_KEY (optional) |244| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase für einen verschlüsselten CLAUDE\_CODE\_CLIENT\_KEY (optional) |

244| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | In v2.1.186 entfernt und jetzt wirkungslos. Legte zuvor einen separaten Timeout für die Verbindungs-, TLS- und Response-Header-Phase einer Streaming-API-Anfrage fest. Verwenden Sie `API_TIMEOUT_MS` für den Timeout pro Anfrage. Für die Response-Header-Phase einer Streaming-Anfrage siehe `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |245| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | In v2.1.186 entfernt und jetzt wirkungslos. Legte zuvor einen separaten Timeout für die Verbindungs-, TLS- und Response-Header-Phase einer Streaming-API-Anfrage fest. Verwenden Sie stattdessen `API_TIMEOUT_MS`. Für die Response-Header-Phase einer Streaming-Anfrage siehe `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

245| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Überschreibt den Pfad der Debug-Logdatei. Trotz des Namens ist dies ein Dateipfad, kein Verzeichnis. Erfordert, dass der Debug-Modus separat über `--debug`, `/debug` oder die Umgebungsvariable `DEBUG` aktiviert wird: Das Setzen dieser Variable allein aktiviert das Logging nicht. Das Flag [`--debug-file`](/docs/de/cli-reference#cli-flags) erledigt beides gleichzeitig. Standardwert ist `~/.claude/debug/<session-id>.txt` |246| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Überschreibt den Pfad der Debug-Logdatei. Trotz des Namens ist dies ein Dateipfad, kein Verzeichnis. Erfordert, dass der Debug-Modus separat über `--debug`, `/debug` oder die Umgebungsvariable `DEBUG` aktiviert wird: Das Setzen dieser Variable allein aktiviert das Logging nicht. Das Flag [`--debug-file`](/docs/de/cli-reference#cli-flags) erledigt beides gleichzeitig. Standardwert ist `~/.claude/debug/<session-id>.txt` |

246| `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 |247| `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 |

247| `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) |248| `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) |


304| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Eingaben von Tool-Aufrufen von der API gestreamt werden, während Claude sie generiert. Ist dies ausgeschaltet, kommt eine große Tool-Eingabe, etwa ein langer Dateischreibvorgang, erst an, nachdem Claude sie vollständig generiert hat, was wie ein Hängen aussehen kann. Bei der Anthropic API standardmäßig aktiviert. Bei Amazon Bedrock und Google Cloud's Agent Platform pro Modell aktiviert, sofern der bereitgestellte Container dies unterstützt. Auf `0` setzen, um dies abzuwählen. Auf `1` setzen, um es zu erzwingen, wenn über einen Proxy per `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_BEDROCK_BASE_URL` geroutet wird. Bei Microsoft Foundry und [Gateway](/docs/de/llm-gateway)-Verbindungen standardmäßig deaktiviert |305| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Eingaben von Tool-Aufrufen von der API gestreamt werden, während Claude sie generiert. Ist dies ausgeschaltet, kommt eine große Tool-Eingabe, etwa ein langer Dateischreibvorgang, erst an, nachdem Claude sie vollständig generiert hat, was wie ein Hängen aussehen kann. Bei der Anthropic API standardmäßig aktiviert. Bei Amazon Bedrock und Google Cloud's Agent Platform pro Modell aktiviert, sofern der bereitgestellte Container dies unterstützt. Auf `0` setzen, um dies abzuwählen. Auf `1` setzen, um es zu erzwingen, wenn über einen Proxy per `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_BEDROCK_BASE_URL` geroutet wird. Bei Microsoft Foundry und [Gateway](/docs/de/llm-gateway)-Verbindungen standardmäßig deaktiviert |

305| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Auf `1` setzen, um die `/model`-Auswahl aus dem `/v1/models`-Endpunkt Ihres Gateways zu befüllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy zeigt. Standardmäßig deaktiviert, da Gateways mit einem gemeinsam genutzten API-Schlüssel sonst jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch eine [`availableModels`](/docs/de/settings-reference#availablemodels)-Allowlist gefiltert, die die Sitzung erhält; stellen Sie die Liste über [MDM oder eine Datei mit verwalteten Einstellungen](/docs/de/managed-settings#delivery-mechanisms) bereit, da [die serverseitig verwaltete Bereitstellung bei Gateway-Konfigurationen nicht verfügbar ist](/docs/de/server-managed-settings#platform-availability) |306| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Auf `1` setzen, um die `/model`-Auswahl aus dem `/v1/models`-Endpunkt Ihres Gateways zu befüllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy zeigt. Standardmäßig deaktiviert, da Gateways mit einem gemeinsam genutzten API-Schlüssel sonst jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch eine [`availableModels`](/docs/de/settings-reference#availablemodels)-Allowlist gefiltert, die die Sitzung erhält; stellen Sie die Liste über [MDM oder eine Datei mit verwalteten Einstellungen](/docs/de/managed-settings#delivery-mechanisms) bereit, da [die serverseitig verwaltete Bereitstellung bei Gateway-Konfigurationen nicht verfügbar ist](/docs/de/server-managed-settings#platform-availability) |

306| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | In v2.1.142 entfernt, als der Standard für den [Fast-Modus](/docs/de/fast-mode) von Opus 4.6 auf Opus 4.7 wechselte |307| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | In v2.1.142 entfernt, als der Standard für den [Fast-Modus](/docs/de/fast-mode) von Opus 4.6 auf Opus 4.7 wechselte |

307| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Auf `false` setzen, um Prompt-Vorschläge auszuschalten, also die ausgegrauten Vorhersagen, die in Ihrem Prompt-Eingabefeld erscheinen. Hat Vorrang vor der Einstellung [`promptSuggestionEnabled`](/docs/de/settings-reference#promptsuggestionenabled), die der Schalter **Prompt suggestions** in `/config` schreibt. Claude Code [pausiert Vorschläge außerdem, während Ihr Konto nahe an seinem Nutzungslimit ist oder es erreicht hat](/docs/de/interactive-mode#when-claude-code-skips-suggestions). Auf `true` setzen, um sie bis zum Erreichen des Limits aktiviert zu lassen. Erfordert Claude Code v2.1.238 oder höher. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) |308| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Auf `false` setzen, um Prompt-Vorschläge zu deaktivieren, also die ausgegrauten Vorhersagen, die in Ihrem Eingabefeld erscheinen. Hat Vorrang vor der Einstellung [`promptSuggestionEnabled`](/docs/de/settings-reference#promptsuggestionenabled), die vom Schalter **Prompt suggestions** in `/config` geschrieben wird. Claude Code [pausiert Vorschläge außerdem, während Ihr Konto nahe an seinem Nutzungslimit ist oder es erreicht hat](/docs/de/interactive-mode#when-claude-code-skips-suggestions). Auf `true` setzen, damit diese Pause erst greift, wenn Sie das Limit erreichen. Erfordert Claude Code v2.1.238 oder neuer. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) |

308| `CLAUDE_CODE_ENABLE_TASKS` | Wählt aus, welche Tools zur Aufgabenverfolgung Claude Code in [Sitzungen bereitstellt, die sie haben](/docs/de/tools-reference#task-tool-availability). Standardmäßig stellt Claude Code die Task-Tools `TaskCreate`, `TaskUpdate`, `TaskGet` und `TaskList` bereit. Auf `0` setzen, um stattdessen das ältere `TodoWrite`-Tool zu erhalten. Siehe [Aufgabenliste](/docs/de/interactive-mode#task-list) |309| `CLAUDE_CODE_ENABLE_TASKS` | Wählt aus, welche Tools zur Aufgabenverfolgung Claude Code in [Sitzungen bereitstellt, die sie haben](/docs/de/tools-reference#task-tool-availability). Standardmäßig stellt Claude Code die Task-Tools `TaskCreate`, `TaskUpdate`, `TaskGet` und `TaskList` bereit. Auf `0` setzen, um stattdessen das ältere `TodoWrite`-Tool zu erhalten. Siehe [Aufgabenliste](/docs/de/interactive-mode#task-list) |

309| `CLAUDE_CODE_ENABLE_TELEMETRY` | Auf `1` setzen, um die OpenTelemetry-Datenerfassung für Metriken und Logging zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. 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. Siehe [Überwachung](/docs/de/monitoring-usage) |310| `CLAUDE_CODE_ENABLE_TELEMETRY` | Auf `1` setzen, um die OpenTelemetry-Datenerfassung für Metriken und Logging zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. 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. Siehe [Überwachung](/docs/de/monitoring-usage) |

310| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Auf `1` setzen, um die Tools zur Aufgabenverfolgung bei jedem Modell zu erhalten. Ohne diese Variable stellt Claude Code sie standardmäßig nur bei den Modellen bereit, die unter [Verfügbarkeit des Task-Tools](/docs/de/tools-reference#task-tool-availability) aufgeführt sind. `CLAUDE_CODE_ENABLE_TASKS` wählt weiterhin zwischen den Task-Tools und `TodoWrite`. Erfordert Claude Code v2.1.233 oder höher |311| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Auf `1` setzen, um die Tools zur Aufgabenverfolgung bei jedem Modell zu erhalten. Ohne diese Variable stellt Claude Code sie standardmäßig nur bei den Modellen bereit, die unter [Verfügbarkeit des Task-Tools](/docs/de/tools-reference#task-tool-availability) aufgeführt sind. `CLAUDE_CODE_ENABLE_TASKS` wählt weiterhin zwischen den Task-Tools und `TodoWrite`. Erfordert Claude Code v2.1.233 oder höher |


316| `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 |317| `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 |

317| `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 |318| `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 |

318| `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 |319| `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 |

319| `CLAUDE_CODE_FORK_SUBAGENT` | Steuert den [Fork-Modus](/docs/de/sub-agents#turn-fork-mode-on-or-off), mit dem Claude selbst [geforkte Subagenten](/docs/de/sub-agents#fork-the-current-conversation) starten kann und der standardmäßig nur in interaktiven Sitzungen aktiviert ist. Auf `1` setzen, um ihn auch in `claude -p` und im Agent SDK zu aktivieren, oder auf `0`, um ihn in jeder Art von Sitzung zu deaktivieren. Sie können `/subtask` unabhängig davon ausführen, ob der Fork-Modus aktiviert ist. Der interaktive Standard erfordert Claude Code v2.1.232 oder höher; setzen Sie in früheren Versionen die Variable auf `1`, um den Fork-Modus zu aktivieren |320| `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) |

320| `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 |321| `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 |

321| `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 |322| `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 |

322| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in Millisekunden für die Anfrage zur [Gateway-Modellerkennung](/docs/de/llm-gateway-protocol#model-discovery), die `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` aktiviert (Standard: `3000`). Erhöhen Sie den Wert, wenn Ihr Gateway beim Start länger als drei Sekunden braucht, um `/v1/models` zu beantworten. Akzeptiert nur reine Ziffern; bei `0`, negativen Werten und anderen Schreibweisen bleibt der Standard erhalten. Erfordert Claude Code v2.1.269 oder höher |323| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in Millisekunden für die Anfrage zur [Gateway-Modellerkennung](/docs/de/llm-gateway-protocol#model-discovery), die `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` aktiviert (Standard: `3000`). Erhöhen Sie den Wert, wenn Ihr Gateway beim Start länger als drei Sekunden braucht, um `/v1/models` zu beantworten. Akzeptiert nur reine Ziffern; bei `0`, negativen Werten und anderen Schreibweisen bleibt der Standard erhalten. Erfordert Claude Code v2.1.269 oder höher |


340| `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 |341| `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 |

341| `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 |342| `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 |

342| `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 |343| `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 |

343| `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. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert, und der Standard gilt, sodass die Obergrenze erhöht, aber nicht ausgeschaltet werden kann. Erfordert Claude Code v2.1.212 oder höher |344| `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 |

344| `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 |345| `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 |

345| `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 |346| `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 |

346| `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 |347| `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 |


599* [`/skill-doctor`](/docs/de/skills#find-unused-skills) ausführen oder dessen Bericht im Tab **Stats** von `/plugin` öffnen600* [`/skill-doctor`](/docs/de/skills#find-unused-skills) ausführen oder dessen Bericht im Tab **Stats** von `/plugin` öffnen

600* Die für Ihr claude.ai-Konto aktivierten [Skills](/docs/de/skills#where-synced-skills-load) und [Plugins](/docs/de/plugins/loading#synced-plugins) in Ihre Terminal-Sitzungen synchronisieren601* Die für Ihr claude.ai-Konto aktivierten [Skills](/docs/de/skills#where-synced-skills-load) und [Plugins](/docs/de/plugins/loading#synced-plugins) in Ihre Terminal-Sitzungen synchronisieren

601* Den [You-should-know-Mod](/docs/de/interactive-mode#you-should-know-suggestions) aktivieren602* Den [You-should-know-Mod](/docs/de/interactive-mode#you-should-know-suggestions) aktivieren

602* Sehen, was ein [Mod](/docs/de/plugins/mods/overview#where-mods-run) im Chat-Bereich der VS Code-Erweiterung darstellt; die Hooks des Mods werden weiterhin ausgeführt

603* [Das Advisor-Tool](/docs/de/advisor#requirements) verwenden603* [Das Advisor-Tool](/docs/de/advisor#requirements) verwenden

604* [Kommentare zu einem Artefakt](/docs/de/artifacts#collect-comments-on-an-artifact) lesen oder beantworten604* [Kommentare zu einem Artefakt](/docs/de/artifacts#collect-comments-on-an-artifact) lesen oder beantworten

605* Claude [das öffentliche Artefakt einer anderen Organisation](/docs/de/artifacts#read-an-artifact-shared-with-you) lesen lassen605* Claude [das öffentliche Artefakt einer anderen Organisation](/docs/de/artifacts#read-an-artifact-shared-with-you) lesen lassen


613 Erste Sitzung nach einer Installation oder einem Upgrade613 Erste Sitzung nach einer Installation oder einem Upgrade

614</h3>614</h3>

615 615 

616In Ihrer ersten Sitzung nach der Installation von Claude Code oder nach einem Upgrade auf eine Version, die eine Funktion hinzufügt, kann eine [durch Flags gesteuerte Funktion](#features-that-need-feature-flag-fetching) fehlen. Diese Sitzung kann außerdem in einem anderen [Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) starten als Ihre späteren Sitzungen. Wenn Claude Code die Flags während dieser Sitzung abruft, speichert es sie auf dem Rechner, sodass Ihre nächste Sitzung auf diesem Rechner die Funktion und den üblichen anfänglichen Berechtigungsmodus hat.616In Ihrer ersten Sitzung nach der Installation von Claude Code oder nach einem Upgrade auf eine Version, die eine Funktion hinzufügt, kann eine [durch Flags gesteuerte Funktion](#features-that-need-feature-flag-fetching) fehlen. Wenn Claude Code seine Feature-Flags während dieser Sitzung abruft, speichert es sie auf dem Rechner, sodass Ihre nächste Sitzung auf diesem Rechner die Funktion hat.

617 

618Nach einer Neuinstallation kann Claude Code in einer nicht interaktiven Sitzung wie `claude -p`, dem Agent SDK oder der VS Code-Erweiterung die Flags übernehmen, bevor es [den anfänglichen Berechtigungsmodus wählt](/docs/de/permission-modes#which-mode-a-session-starts-in), wartet aber nicht immer auf sie.

619 617 

620In Konfigurationen wie den folgenden starten auch Sitzungen nach der ersten ohne frisch abgerufene Flags:618In Konfigurationen wie den folgenden starten auch Sitzungen nach der ersten ohne frisch abgerufene Flags:

621 619 

622* **Eine saubere Umgebung bei jedem Lauf**: Wenn jeder Lauf in einem CI-Container oder einer anderen Umgebung ohne die von einer früheren Sitzung gespeicherten Flags startet, ist jeder Lauf eine erste Sitzung620* **Eine saubere Umgebung bei jedem Lauf**: Wenn jeder Lauf in einem CI-Container oder einer anderen Umgebung ohne die von einer früheren Sitzung gespeicherten Flags startet, ist jeder Lauf eine erste Sitzung

623* **Ein Gateway-Token ohne API-Schlüssel**: Wenn Sie sich mit `ANTHROPIC_AUTH_TOKEN` und ohne API-Schlüssel authentifizieren und `ANTHROPIC_BASE_URL` auf einen anderen Host als den von Anthropic verweist, etwa ein [LLM-Gateway](/docs/de/llm-gateway), hat Claude Code keine Anmeldedaten, mit denen es die Flags abrufen kann621* **Ein Gateway-Token ohne API-Schlüssel**: Wenn Sie sich mit `ANTHROPIC_AUTH_TOKEN` und ohne API-Schlüssel authentifizieren und `ANTHROPIC_BASE_URL` auf einen anderen Host als den von Anthropic verweist, etwa ein [LLM-Gateway](/docs/de/llm-gateway), hat Claude Code keine Anmeldedaten, mit denen es die Flags abrufen kann

624 622 

625Wie Sie den Berechtigungsmodus wählen, in dem Sitzungen in diesen Konfigurationen starten, erfahren Sie unter [In einem anderen Berechtigungsmodus starten](/docs/de/permission-modes#start-in-a-different-mode).

626 

627<h2 id="see-also">623<h2 id="see-also">

628 Siehe auch624 Siehe auch

629</h2>625</h2>

errors.md +32 −5

Details

41| `Auto mode classifier transcript exceeded context window` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |41| `Auto mode classifier transcript exceeded context window` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |

42| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |42| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Serverfehler](#auto-mode-cannot-determine-the-safety-of-an-action) |

43| `The server-side auto mode classifier gave no verdict` | [Serverfehler](#the-server-returned-no-safety-verdict) |43| `The server-side auto mode classifier gave no verdict` | [Serverfehler](#the-server-returned-no-safety-verdict) |

44| `<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier` | [Serverfehler](#was-not-reviewed-and-did-not-run) |

44| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Serverfehler](#the-server-returned-no-safety-verdict) |45| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Serverfehler](#the-server-returned-no-safety-verdict) |

45| `Agent terminated early due to an API error` | [Serverfehler](#agent-terminated-early-due-to-an-api-error) |46| `Agent terminated early due to an API error` | [Serverfehler](#agent-terminated-early-due-to-an-api-error) |

46| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Nutzungslimits](#youve-hit-your-session-limit) |47| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Nutzungslimits](#youve-hit-your-session-limit) |


471| [`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. |472| [`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. |

472| [`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. |473| [`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. |

473| [`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. |474| [`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. |

474| [`API_TIMEOUT_MS`](/docs/de/env-vars) | 600000 | Timeout pro Anfrage in Millisekunden. Erhöhen Sie den Wert bei langsamen Netzwerken oder Proxys. Er begrenzt außerdem, wie lange Claude Code auf Response-Header wartet, wie unter [No response from API](#no-response-from-api) beschrieben. |475| [`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). |

475| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/de/env-vars) | nicht gesetzt | Begrenzung für das erneute Senden einer [Anfrage ohne Streaming](#streaming-response-ended-before-any-complete-data-was-received), bei der eine Zeitüberschreitung auftritt. Ist die Grenze erreicht, schlägt die Anfrage fehl. Eine Antwort von Claude, deren Generierung länger als der Timeout dauert, läuft bei jedem erneuten Senden wieder in eine Zeitüberschreitung; setzen Sie daher einen niedrigen Wert wie `0`, damit die Anfrage schneller fehlschlägt. Jeder Versuch ohne Streaming läuft in einer lokalen Sitzung nach 300 Sekunden in eine Zeitüberschreitung oder nach `API_TIMEOUT_MS`, wenn Sie einen positiven Wert setzen. Erfordert Claude Code v2.1.285 oder höher. |476| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/de/env-vars) | nicht gesetzt | Begrenzung für das erneute Senden einer [Anfrage ohne Streaming](#streaming-response-ended-before-any-complete-data-was-received), bei der eine Zeitüberschreitung auftritt. Ist die Grenze erreicht, schlägt die Anfrage fehl. Eine Antwort von Claude, deren Generierung länger als der Timeout dauert, läuft bei jedem erneuten Senden wieder in eine Zeitüberschreitung; setzen Sie daher einen niedrigen Wert wie `0`, damit die Anfrage schneller fehlschlägt. Jeder Versuch ohne Streaming läuft in einer lokalen Sitzung nach 300 Sekunden in eine Zeitüberschreitung oder nach `API_TIMEOUT_MS`, wenn Sie einen positiven Wert setzen. Erfordert Claude Code v2.1.285 oder höher. |

476| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/de/env-vars) | nicht gesetzt | Deadline in Millisekunden für das erste Antwort-Byte einer Streaming-Anfrage. Erfordert Claude Code v2.1.242 oder höher. Wie Claude Code die Deadline wählt, wenn diese Variable nicht gesetzt ist, erfahren Sie unter [No response from API](#no-response-from-api). |477| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/de/env-vars) | nicht gesetzt | Deadline in Millisekunden für das erste Antwort-Byte einer Streaming-Anfrage. Erfordert Claude Code v2.1.242 oder höher. Wie Claude Code die Deadline wählt, wenn diese Variable nicht gesetzt ist, erfahren Sie unter [No response from API](#no-response-from-api). |

477 478 


535Request timed out536Request timed out

536```537```

537 538 

538Dies kann während Zeiten hoher Last auftreten oder wenn das Modell eine sehr große Antwort generiert. Der Standard-Timeout für Anfragen beträgt 10 Minuten.539Der Standard-Timeout für Anfragen beträgt 10 Minuten.

539 540 

540**Was zu tun ist:**541**Was zu tun ist:**

541 542 


627<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.628<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

628```629```

629 630 

630In einer interaktiven Sitzung erscheint statt dieser Nachricht eine abgeblendete Zeile `Not run · auto mode's check had no usable answer` unter dem Tool-Aufruf. Drücken Sie `Ctrl+O`, um die Nachricht im [Transkript-Viewer](/docs/de/interactive-mode#transcript-viewer) zu lesen. Die Verweigerungen unter [Der Server hat kein Sicherheitsurteil zurückgegeben](#the-server-returned-no-safety-verdict) zeigen dieselbe Zeile. Vor v2.1.296 erschien die Nachricht als roter Fehler unter dem Aufruf.631In einer interaktiven Sitzung erscheint statt dieser Nachricht eine abgeblendete Zeile `Not run · auto mode's check had no usable answer` unter dem Tool-Aufruf. Drücken Sie `Ctrl+O`, um die Nachricht im [Transkript-Viewer](/docs/de/interactive-mode#transcript-viewer) zu lesen. Die `gave no verdict`-Verweigerungen unter [The server returned no safety verdict](#the-server-returned-no-safety-verdict) zeigen dieselbe Zeile. Vor v2.1.296 erschien die Nachricht als roter Fehler unter dem Aufruf.

631 632 

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

633 634 


638* Versuchen Sie es nach ein paar Sekunden erneut; Claude sieht die gleiche Nachricht und versucht es normalerweise selbstständig erneut. Ein vorübergehender Fehler hat nichts mit der [Auto-Modus-Berechtigung](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zu tun; Sie müssen die Einstellungen nicht ändern639* Versuchen Sie es nach ein paar Sekunden erneut; Claude sieht die gleiche Nachricht und versucht es normalerweise selbstständig erneut. Ein vorübergehender Fehler hat nichts mit der [Auto-Modus-Berechtigung](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zu tun; Sie müssen die Einstellungen nicht ändern

639* Wenn Wiederholungsversuche weiterhin fehlschlagen, fahren Sie mit nur lesenden Aufgaben fort und kehren Sie später zur blockierten Aktion zurück640* Wenn Wiederholungsversuche weiterhin fehlschlagen, fahren Sie mit nur lesenden Aufgaben fort und kehren Sie später zur blockierten Aktion zurück

640* Wenn die Nachricht bei Amazon Bedrock bei jedem Wiederholungsversuch zurückkommt, überprüfen Sie, dass Ihr Konto das darin genannte Modell aufrufen kann: Bestätigen Sie für Standard-Amazon Bedrock-Modelle, dass Ihre [IAM-Richtlinie](/docs/de/amazon-bedrock#iam-configuration) das Aufrufen zulässt; für Mantle-Modell-IDs [kontaktieren Sie Ihr AWS-Kontoteam](/docs/de/amazon-bedrock#mantle-endpoint-errors)641* Wenn die Nachricht bei Amazon Bedrock bei jedem Wiederholungsversuch zurückkommt, überprüfen Sie, dass Ihr Konto das darin genannte Modell aufrufen kann: Bestätigen Sie für Standard-Amazon Bedrock-Modelle, dass Ihre [IAM-Richtlinie](/docs/de/amazon-bedrock#iam-configuration) das Aufrufen zulässt; für Mantle-Modell-IDs [kontaktieren Sie Ihr AWS-Kontoteam](/docs/de/amazon-bedrock#mantle-endpoint-errors)

642* Wenn die Nachricht bei jedem Wiederholungsversuch zurückkommt und das Modell nennt, das Sie in [`CLAUDE_CODE_AUTO_MODE_MODEL`](/docs/de/permission-modes#choose-the-classifier-model) festgelegt haben, überprüfen Sie, ob die API oder der Cloud-Anbieter, auf dem Ihre Sitzung läuft, diese Modell-ID bereitstellt. Falls nicht, setzen Sie die Variable auf eine Modell-ID, die dort bereitgestellt wird, oder entfernen Sie die Variable, um das [Standard-Klassifikatormodell](/docs/de/permission-modes#default-classifier-model) zu verwenden.

641 643 

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

643 645 


672* Wechseln Sie in einer interaktiven Sitzung zu einem anderen [Berechtigungsmodus](/docs/de/permission-modes), damit Sie die Aktion genehmigen können, wenn Sie gefragt werden674* Wechseln Sie in einer interaktiven Sitzung zu einem anderen [Berechtigungsmodus](/docs/de/permission-modes), damit Sie die Aktion genehmigen können, wenn Sie gefragt werden

673* Starten Sie eine neue Konversation ohne den auslösenden Inhalt675* Starten Sie eine neue Konversation ohne den auslösenden Inhalt

674 676 

675Wenn die Konversation größer als das Kontextfenster des Klassifikators geworden ist:677Wenn die Konversation zu lang für die Klassifikatoranfrage von Claude Code ist und Claude Code sie nicht [selbstständig komprimieren kann](#was-not-reviewed-and-did-not-run):

676 678 

677```text theme={null}679```text theme={null}

678Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)680Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)


715 717 

716**Was zu tun ist:**718**Was zu tun ist:**

717 719 

720* Drücken Sie in einer interaktiven Sitzung `Ctrl+O`, um den Text der Verweigerung im [Transkript-Viewer](/docs/de/interactive-mode#transcript-viewer) zu lesen.

721* Wenn die Verweigerung `(the conversation is too long for the check)` nennt, führen Sie `/compact` in der Eingabeaufforderung von Claude Code aus, um die Konversation zu kürzen. Solange die Konversation nicht kürzer ist, erhält jede weitere Nachricht dieselbe Verweigerung. Wenn Sie das [automatische Komprimieren](/docs/de/settings-reference#autocompactenabled) ausgeschaltet haben, schalten Sie es wieder ein, damit Claude Code beim nächsten Mal selbstständig komprimiert.

718* Senden Sie eine weitere Nachricht, damit Claude es erneut versucht. Die Zählung der Antworten beginnt von vorne.722* Senden Sie eine weitere Nachricht, damit Claude es erneut versucht. Die Zählung der Antworten beginnt von vorne.

719* Wenn sich der Stopp wiederholt und Ihre Anfragen über ein [LLM-Gateway oder einen Proxy](/docs/de/llm-gateway) laufen, überprüfen Sie, ob dieser Streaming-Antworten kürzt oder umschreibt. [Serverseitige Klassifikatorprüfung](/docs/de/permission-modes#server-side-classifier-review) beschreibt, welches Gateway-Verhalten Verweigerungen verursacht, und der [Gateway-Kompatibilitätsleitfaden](/docs/de/llm-gateway-protocol#feature-pass-through) listet auf, was unverändert durchgeleitet werden muss.723* Wenn sich der Stopp wiederholt und Ihre Anfragen über ein [LLM-Gateway oder einen Proxy](/docs/de/llm-gateway) laufen, überprüfen Sie, ob dieser Streaming-Antworten kürzt oder umschreibt. [Serverseitige Klassifikatorprüfung](/docs/de/permission-modes#server-side-classifier-review) beschreibt, welches Gateway-Verhalten Verweigerungen verursacht, und der [Gateway-Kompatibilitätsleitfaden](/docs/de/llm-gateway-protocol#feature-pass-through) listet auf, was unverändert durchgeleitet werden muss.

720* Setzen Sie `CLAUDE_CODE_AUTO_MODE_SERVER=0`, bevor Sie Claude Code starten, um stattdessen seine eigenen Klassifikatoranfragen zu verwenden. Vor v2.1.281 las Claude Code die Variable bei einer direkten Verbindung zur Anthropic API nicht.724* Setzen Sie `CLAUDE_CODE_AUTO_MODE_SERVER=0`, bevor Sie Claude Code starten, um stattdessen seine eigenen Klassifikatoranfragen zu verwenden. Vor v2.1.281 las Claude Code die Variable bei einer direkten Verbindung zur Anthropic API nicht.


722 726 

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

724 728 

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

730 

731<h3 id="was-not-reviewed-and-did-not-run">

732 Was not reviewed and did not run

733</h3>

734 

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

736 

737```text theme={null}

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

739```

740 

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

742 

743* Eine [`gave no verdict (the conversation is too long for the check)`](#the-server-returned-no-safety-verdict)-Verweigerung

744* Die Nachricht [`Auto mode classifier transcript exceeded context window`](#auto-mode-cannot-determine-the-safety-of-an-action)

745 

746**Was zu tun ist:**

747 

748* Wenn die in der Nachricht angekündigte Komprimierung erfolgreich ist, müssen Sie nichts tun.

749* Wenn Sie eine dieser beiden Nachrichten sehen, führen Sie `/compact` in der Eingabeaufforderung von Claude Code aus, um die Konversation selbst zu kürzen. Wenn Sie das [automatische Komprimieren](/docs/de/settings-reference#autocompactenabled) ausgeschaltet haben, schalten Sie es wieder ein, damit Claude Code beim nächsten Mal selbstständig komprimiert.

750 

725<h3 id="agent-terminated-early-due-to-an-api-error">751<h3 id="agent-terminated-early-due-to-an-api-error">

726 Agent wurde vorzeitig aufgrund eines API-Fehlers beendet752 Agent wurde vorzeitig aufgrund eines API-Fehlers beendet

727</h3>753</h3>


4554* Korrigieren Sie jeden Eintrag, den der Fehler benennt, anhand der [für Subagenten verfügbaren Tools](/docs/de/sub-agents#available-tools)4580* Korrigieren Sie jeden Eintrag, den der Fehler benennt, anhand der [für Subagenten verfügbaren Tools](/docs/de/sub-agents#available-tools)

4555* Entfernen Sie Einträge für Tools, die die Sitzung nicht hat, wie MCP-Tools von einem Server, der nicht verbunden ist4581* Entfernen Sie Einträge für Tools, die die Sitzung nicht hat, wie MCP-Tools von einem Server, der nicht verbunden ist

4556* Wenn der Eintrag einen verbundenen MCP-Server benennt, vergleichen Sie den Eintrag mit dem Namen dieses Servers, wie ihn die [Tool-Namen](/docs/de/permissions#mcp) des Servers schreiben, etwa `reports__v2` in `mcp__reports__v2__get_totals`. Schreiben Sie für diesen Server `mcp__reports__v2__*`, also `mcp__` gefolgt vom vollständigen Namen und `__*`. Mit dem kürzeren `mcp__reports`, das einen Server namens `reports` benennt, erhält der Subagent keines der `reports__v2`-Tools4582* Wenn der Eintrag einen verbundenen MCP-Server benennt, vergleichen Sie den Eintrag mit dem Namen dieses Servers, wie ihn die [Tool-Namen](/docs/de/permissions#mcp) des Servers schreiben, etwa `reports__v2` in `mcp__reports__v2__get_totals`. Schreiben Sie für diesen Server `mcp__reports__v2__*`, also `mcp__` gefolgt vom vollständigen Namen und `__*`. Mit dem kürzeren `mcp__reports`, das einen Server namens `reports` benennt, erhält der Subagent keines der `reports__v2`-Tools

4557* Für ein Tool, das [Hintergrund-Subagenten ablegen](/docs/de/sub-agents#available-tools), wie `CronCreate`, entfernen Sie den Eintrag. Um das Tool zu behalten, [schalten Sie den Fork-Modus aus](/docs/de/sub-agents#turn-fork-mode-on-or-off) und bitten Sie Claude, den Subagenten im Vordergrund auszuführen4583* Für ein Tool, das [Hintergrund-Subagenten ablegen](/docs/de/sub-agents#available-tools), wie `CronCreate`, entfernen Sie den Eintrag

4584* Um stattdessen ein Tool wie `CronCreate` zu behalten, [lassen Sie Claude auf den Subagenten warten](/docs/de/sub-agents#let-claude-wait-for-a-subagent), da ein Subagent, auf den Claude wartet, im Vordergrund ausgeführt wird und das Tool behält. Wenn die Definition `background: true` setzt, entfernen Sie zuerst dieses Feld, da es den Subagenten im Hintergrund hält

4558* Löschen Sie das `tools`-Feld, anstatt Tools aufzulisten, um dem Subagenten alle [für Subagenten verfügbaren Tools](/docs/de/sub-agents#available-tools) zu geben4585* Löschen Sie das `tools`-Feld, anstatt Tools aufzulisten, um dem Subagenten alle [für Subagenten verfügbaren Tools](/docs/de/sub-agents#available-tools) zu geben

4559* Für eine `tools`-Liste, die nur `Agent` enthält, erhöhen Sie das [Tiefenlimit](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) oder geben Sie dem Agenten mindestens ein anderes Tool: Claude Code behält `Agent` bei diesem Limit zurück, daher wird eine Liste mit nichts anderem darin zu keinen Tools aufgelöst4586* Für eine `tools`-Liste, die nur `Agent` enthält, erhöhen Sie das [Tiefenlimit](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) oder geben Sie dem Agenten mindestens ein anderes Tool: Claude Code behält `Agent` bei diesem Limit zurück, daher wird eine Liste mit nichts anderem darin zu keinen Tools aufgelöst

4560 4587 

fast-mode.md +1 −1

Details

47* Ein kleines `↯`-Symbol wird neben der Eingabeaufforderung angezeigt, während der Schnellmodus aktiv ist47* Ein kleines `↯`-Symbol wird neben der Eingabeaufforderung angezeigt, während der Schnellmodus aktiv ist

48* Führen Sie `/fast` jederzeit erneut aus, um zu überprüfen, ob der Schnellmodus aktiviert oder deaktiviert ist48* Führen Sie `/fast` jederzeit erneut aus, um zu überprüfen, ob der Schnellmodus aktiviert oder deaktiviert ist

49 49 

50Opus 5.5 ist der Standard für den Schnellmodus in Claude Code v2.1.280 und später. Vor v2.1.280 war der Schnellmodus standardmäßig auf Opus 5 in v2.1.219 und später, auf Opus 4.8 in v2.1.154 bis v2.1.218 und auf Opus 4.7 in v2.1.142 bis v2.1.153 eingestellt.50Opus 5.5 ist der Standard für den Fast-Modus in Claude Code v2.1.280 und später. Vor v2.1.280 war der Fast-Modus standardmäßig auf Opus 5 in v2.1.219 und später und auf Opus 4.8 in v2.1.154 bis v2.1.218 eingestellt.

51 51 

52Wenn Sie den Schnellmodus mit `/fast` erneut deaktivieren, bleiben Sie auf Opus. Um zu einem anderen Modell zu wechseln, verwenden Sie `/model`.52Wenn Sie den Schnellmodus mit `/fast` erneut deaktivieren, bleiben Sie auf Opus. Um zu einem anderen Modell zu wechseln, verwenden Sie `/model`.

53 53 

fullscreen.md +3 −3

Details

101* **Klicken Sie in die Eingabeaufforderung**, um Ihren Cursor überall im eingegebenen Text zu positionieren.101* **Klicken Sie in die Eingabeaufforderung**, um Ihren Cursor überall im eingegebenen Text zu positionieren.

102* **Klicken Sie auf einen Vorschlag in der `/`-Befehlsliste oder `@`-Dateiliste**, um ihn zu akzeptieren. Das Hovern hebt die Zeile unter Ihrem Cursor hervor.102* **Klicken Sie auf einen Vorschlag in der `/`-Befehlsliste oder `@`-Dateiliste**, um ihn zu akzeptieren. Das Hovern hebt die Zeile unter Ihrem Cursor hervor.

103* **Klicken Sie auf eine Option in einem Auswahlmenü**, um sie auszuwählen. Dies umfasst Berechtigungsabfragen, `/model`, `/config` und andere Dialoge, die eine Liste von Optionen anzeigen.103* **Klicken Sie auf eine Option in einem Auswahlmenü**, um sie auszuwählen. Dies umfasst Berechtigungsabfragen, `/model`, `/config` und andere Dialoge, die eine Liste von Optionen anzeigen.

104* **Klicken Sie auf eine Option in einem Mehrfachauswahlmenü**, um sie umzuschalten, und klicken Sie auf die Schaltfläche „Senden“, um Ihre Auswahl zu bestätigen. Wenn Sie auf eine Freitextzeile klicken, z. B. die Zeile `Other` in einer Multiple-Choice-Frage, wird das Eingabefeld fokussiert, damit Sie eine Antwort eingeben können. Erfordert Claude Code v2.1.208 oder später.104* **Klicken Sie auf eine Option in einem Mehrfachauswahlmenü**, um sie umzuschalten, und klicken Sie auf die Schaltfläche „Senden“, um Ihre Auswahl zu bestätigen. Wenn Sie auf eine Freitextzeile klicken, z. B. die Zeile `Other` in einer Multiple-Choice-Frage, wird das Eingabefeld fokussiert, damit Sie eine Antwort eingeben können.

105* **Klicken Sie auf den Wert einer Einstellung im `/config`-Bereich**, um ihn zu ändern, und scrollen Sie die Einstellungsliste mit dem Mausrad. Erfordert Claude Code v2.1.271 oder später.105* **Klicken Sie auf den Wert einer Einstellung im `/config`-Bereich**, um ihn zu ändern, und scrollen Sie die Einstellungsliste mit dem Mausrad. Erfordert Claude Code v2.1.271 oder später.

106* **Scrollen Sie ein Auswahlmenü oder Mehrfachauswahlmenü mit dem Mausrad**, wenn es mehr Optionen hat, als es auf einmal anzeigt, z. B. die `/model`-Liste in einem kurzen Terminalfenster. Das Rad scrollt die Liste, während sich der Zeiger über den Optionen befindet. Erfordert Claude Code v2.1.280 oder später.106* **Scrollen Sie ein Auswahlmenü oder Mehrfachauswahlmenü mit dem Mausrad**, wenn es mehr Optionen hat, als es auf einmal anzeigt, z. B. die `/model`-Liste in einem kurzen Terminalfenster. Das Rad scrollt die Liste, während sich der Zeiger über den Optionen befindet. Erfordert Claude Code v2.1.280 oder später.

107* **Scrollen Sie eine überlaufende Liste mit ihrer Scrollleiste.** In Listenpanels wie `/skills`, `/mcp` und der Installed-Liste von `/plugin` wird eine Scrollleiste neben einer Liste mit mehr Zeilen als Platz angezeigt, während sich der Zeiger darüber befindet. Klicken Sie auf die Spur, um zu diesem Punkt zu springen, oder ziehen Sie den Schieber. Erfordert Claude Code v2.1.281 oder später.107* **Scrollen Sie eine überlaufende Liste mit ihrer Scrollleiste.** In Listenpanels wie `/skills`, `/mcp` und der Installed-Liste von `/plugin` wird eine Scrollleiste neben einer Liste mit mehr Zeilen als Platz angezeigt, während sich der Zeiger darüber befindet. Klicken Sie auf die Spur, um zu diesem Punkt zu springen, oder ziehen Sie den Schieber. Erfordert Claude Code v2.1.281 oder später.


146| `Ctrl+End` | Zur neuesten Nachricht springen und automatisches Folgen erneut aktivieren |146| `Ctrl+End` | Zur neuesten Nachricht springen und automatisches Folgen erneut aktivieren |

147| Mausrad | Um einige Zeilen gleichzeitig scrollen |147| Mausrad | Um einige Zeilen gleichzeitig scrollen |

148 148 

149Sie können zum Anfang der Sitzung zurückblättern, auch nach [Komprimierung](/docs/de/context-window#what-survives-compaction). Claude arbeitet weiterhin aus der Komprimierungszusammenfassung, aber Claude Code behält jede frühere Nachricht im Vollbild-Scrollback über wiederholte Komprimierungen hinweg.149Wenn Sie eine [komprimierte](/docs/de/context-window#what-survives-compaction) Sitzung schließen und [fortsetzen](/docs/de/sessions#what-a-resumed-session-restores), stoppt das Scrollen nach oben an der Zeile `Conversation compacted`, und Ihre früheren Nachrichten bleiben auf der Festplatte in der [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) gespeichert. Um ein Detail aus diesen Nachrichten abzurufen, bitten Sie Claude, es in dieser Datei nachzuschlagen.

150 150 

151Auf Tastaturen ohne dedizierte `PgUp`-, `PgDn`-, `Home`- oder `End`-Tasten, wie MacBook-Tastaturen, halten Sie `Fn` mit den Pfeiltasten gedrückt: `Fn+↑` sendet `PgUp`, `Fn+↓` sendet `PgDn`, `Fn+←` sendet `Home` und `Fn+→` sendet `End`. `Ctrl+Fn+→` erreicht Claude Code auf macOS nicht, daher hat eine MacBook-Tastatur standardmäßig keine funktionierende Tastenkombination zum Springen nach unten. Verwenden Sie stattdessen eine dieser Optionen:151Auf Tastaturen ohne dedizierte `PgUp`-, `PgDn`-, `Home`- oder `End`-Tasten, wie MacBook-Tastaturen, halten Sie `Fn` mit den Pfeiltasten gedrückt: `Fn+↑` sendet `PgUp`, `Fn+↓` sendet `PgDn`, `Fn+←` sendet `Home` und `Fn+→` sendet `End`. `Ctrl+Fn+→` erreicht Claude Code auf macOS nicht, daher hat eine MacBook-Tastatur standardmäßig keine funktionierende Tastenkombination zum Springen nach unten. Verwenden Sie stattdessen eine dieser Optionen:

152 152 


162 Automatisches Folgen162 Automatisches Folgen

163</h3>163</h3>

164 164 

165Das Scrollen nach oben pausiert das automatische Folgen, damit neue Ausgabe Sie nicht zurück nach unten zieht. Eine `Zum unteren Ende springen`-Schaltfläche schwebt über der unteren Kante des Transkripts, während Sie nach oben gescrollt sind, und zeigt eine Anzahl wie `3 neue Nachrichten` an, wenn neue Ausgabe ankommt. Klicken Sie darauf, drücken Sie `Ctrl+End` oder scrollen Sie nach unten, um das Folgen fortzusetzen.165Das Scrollen nach oben pausiert das automatische Folgen, damit neue Ausgabe Sie nicht zurück nach unten zieht. Eine `Jump to bottom`-Schaltfläche schwebt über der unteren Kante des Transkripts, während Sie nach oben gescrollt sind, und zeigt eine Anzahl wie `3 new messages` an, wenn neue Ausgabe ankommt. Klicken Sie darauf, drücken Sie `Ctrl+End` oder scrollen Sie nach unten, um das Folgen fortzusetzen.

166 166 

167Während das automatische Folgen pausiert ist, bleibt die Ansicht auch dort, wo Sie sie gescrollt haben, wenn eine Antwort das Streaming beendet.167Während das automatische Folgen pausiert ist, bleibt die Ansicht auch dort, wo Sie sie gescrollt haben, wenn eine Antwort das Streaming beendet.

168 168 

headless.md +5 −4

Details

138 Eingeleitetes stdin ist auf 10 MB begrenzt. Wenn Sie die Grenze überschreiten, beendet sich Claude Code mit einer klaren Fehlermeldung und einem Nicht-Null-Status. Um mit größeren Eingaben zu arbeiten, schreiben Sie den Inhalt in eine Datei und verweisen Sie in Ihrem Prompt auf den Dateipfad, anstatt ihn einzuleiten.138 Eingeleitetes stdin ist auf 10 MB begrenzt. Wenn Sie die Grenze überschreiten, beendet sich Claude Code mit einer klaren Fehlermeldung und einem Nicht-Null-Status. Um mit größeren Eingaben zu arbeiten, schreiben Sie den Inhalt in eine Datei und verweisen Sie in Ihrem Prompt auf den Dateipfad, anstatt ihn einzuleiten.

139</Note>139</Note>

140 140 

141Wenn Claude Code stdin nicht lesen kann, beispielsweise weil der Prozess, der es gestartet hat, sein Ende getrennt hat, gibt Claude Code eine Warnung auf stderr aus und fährt mit dem Prompt aus der Befehlszeile fort. Vor v2.1.211 führte ein nicht lesbares stdin unter Windows zum Absturz der Sitzung oder zum stillen Beenden ohne Ausgabe.141Wenn Claude Code stdin nicht lesen kann, beispielsweise weil der Prozess, der es gestartet hat, sein Ende getrennt hat, gibt Claude Code eine Warnung auf stderr aus und fährt mit dem Prompt aus der Befehlszeile fort.

142 142 

143<h3 id="add-claude-to-a-build-script">143<h3 id="add-claude-to-a-build-script">

144 Claude zu einem Build-Skript hinzufügen144 Claude zu einem Build-Skript hinzufügen


213 213 

214Die letzte Zeile des Streams ist eine `result`-Nachricht mit dem endgültigen Antworttext, den Kosten und den Sitzungsmetadaten.214Die letzte Zeile des Streams ist eine `result`-Nachricht mit dem endgültigen Antworttext, den Kosten und den Sitzungsmetadaten.

215 215 

216Wenn Ihr Consumer den Stream langsam liest, wartet Claude Code vor dem Beenden darauf, dass die in der Warteschlange befindliche Ausgabe abfließt, und skaliert die Wartezeit mit der Menge, die sich noch in der Warteschlange befindet, begrenzt auf 30 Sekunden. Vor v2.1.214 war die Wartezeit beim Beenden auf etwa zwei Sekunden begrenzt, was das Ende einer großen Antwort abschneiden konnte.216Wenn Ihr Consumer den Stream langsam liest, wartet Claude Code vor dem Beenden darauf, dass die in der Warteschlange befindliche Ausgabe abfließt, und skaliert die Wartezeit mit der Menge, die sich noch in der Warteschlange befindet, begrenzt auf 30 Sekunden.

217 217 

218Das folgende Beispiel verwendet [jq](https://jqlang.org/) zum Filtern nach Text-Deltas und zum Anzeigen nur des Streaming-Texts. Das Flag `-r` gibt Rohzeichenketten aus (keine Anführungszeichen) und `-j` verbindet ohne Zeilenumbrüche, sodass Token kontinuierlich gestreamt werden:218Das folgende Beispiel verwendet [jq](https://jqlang.org/) zum Filtern nach Text-Deltas und zum Anzeigen nur des Streaming-Texts. Das Flag `-r` gibt Rohzeichenketten aus (keine Anführungszeichen) und `-j` verbindet ohne Zeilenumbrüche, sodass Token kontinuierlich gestreamt werden:

219 219 


249 249 

250Wenn einige dieser Nachrichten in Ihrem Stream fehlen, prüfen Sie Ihre Claude Code-Version anhand dieser Mindestversionen:250Wenn einige dieser Nachrichten in Ihrem Stream fehlen, prüfen Sie Ihre Claude Code-Version anhand dieser Mindestversionen:

251 251 

252* **`--forward-subagent-text` und `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`**: v2.1.211 oder später

253* **Weiterleitung auf jeder Verschachtelungstiefe**: v2.1.219 oder später252* **Weiterleitung auf jeder Verschachtelungstiefe**: v2.1.219 oder später

254* **Ein geforkter Skill, den Claude mit dem Skill-Tool aus der Hauptkonversation startet**: v2.1.86 oder später für seine `tool_use`- und `tool_result`-Blöcke und v2.1.265 oder später für seine erste `user`-Nachricht sowie seine Text- und Thinking-Blöcke253* **Ein geforkter Skill, den Claude mit dem Skill-Tool aus der Hauptkonversation startet**: v2.1.86 oder später für seine `tool_use`- und `tool_result`-Blöcke und v2.1.265 oder später für seine erste `user`-Nachricht sowie seine Text- und Thinking-Blöcke

255* **Nachrichten von Subagenten, die ein geforkter Skill startet, und von geforkten Skills, die in einem Subagenten oder einem anderen geforkten Skill gestartet werden**: v2.1.275 oder später254* **Nachrichten von Subagenten, die ein geforkter Skill startet, und von geforkten Skills, die in einem Subagenten oder einem anderen geforkten Skill gestartet werden**: v2.1.275 oder später


336 --allowedTools "Bash,Read,Edit"335 --allowedTools "Bash,Read,Edit"

337```336```

338 337 

339Um eine Baseline für die gesamte Sitzung festzulegen, anstatt einzelne Tools aufzulisten, übergeben Sie einen [Berechtigungsmodus](/docs/de/permission-modes). Ein Lauf, bei dem nichts einen Berechtigungsmodus setzt, verwendet den [integrierten Start-Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in), der `auto` sein kann. Übergeben Sie also den gewünschten Modus:338Aufrufe von Tools, die Sie nicht aufgelistet haben, werden ausgeführt, wenn sie keine Genehmigung benötigen. In einem `claude -p`-Lauf im [Manual-Modus](/docs/de/permission-modes#available-modes) wird ein Aufruf, der eine Genehmigung benötigt, verweigert, sofern ihn nicht etwas genehmigt, etwa ein [`PermissionRequest`-Hook](/docs/de/hooks#permissionrequest) oder ein [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags). Ab Claude Code v2.1.302 starten `claude -p`-Läufe im Manual-Modus, wenn [nichts einen Berechtigungsmodus setzt](/docs/de/permission-modes#which-mode-a-non-interactive-run-starts-in).

339 

340Um eine Baseline für die gesamte Sitzung festzulegen, anstatt einzelne Tools aufzulisten, übergeben Sie mit `--permission-mode` einen [Berechtigungsmodus](/docs/de/permission-modes), etwa `auto`, `dontAsk` oder `acceptEdits`:

340 341 

341* **`auto`**: Übergeben Sie `--permission-mode auto`, damit ein Klassifikator anstelle von Ihnen die meisten Aktionen überprüft342* **`auto`**: Übergeben Sie `--permission-mode auto`, damit ein Klassifikator anstelle von Ihnen die meisten Aktionen überprüft

342* **`dontAsk`**: Claude Code verweigert jeden Aufruf, bei dem sonst nachgefragt würde, was für abgeschottete CI-Läufe nützlich ist. Aktionen, die im Manual-Modus keine Genehmigung benötigen, werden weiterhin ausgeführt, etwa Dateilesevorgänge in Ihren Arbeitsverzeichnissen und die [nur lesenden Befehle](/docs/de/permissions#read-only-commands), ebenso Aktionen, die Ihre `--allowedTools`-Einträge oder `permissions.allow`-Regeln abdecken. `AskUserQuestion`, Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und [Lesevorgänge von Netzwerkpfaden](/docs/de/permissions#network-paths) werden verweigert, auch wenn eine allow-Regel passt343* **`dontAsk`**: Claude Code verweigert jeden Aufruf, bei dem sonst nachgefragt würde, was für abgeschottete CI-Läufe nützlich ist. Aktionen, die im Manual-Modus keine Genehmigung benötigen, werden weiterhin ausgeführt, etwa Dateilesevorgänge in Ihren Arbeitsverzeichnissen und die [nur lesenden Befehle](/docs/de/permissions#read-only-commands), ebenso Aktionen, die Ihre `--allowedTools`-Einträge oder `permissions.allow`-Regeln abdecken. `AskUserQuestion`, Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und [Lesevorgänge von Netzwerkpfaden](/docs/de/permissions#network-paths) werden verweigert, auch wenn eine allow-Regel passt

hooks.md +26 −32

Details

423* **[Prompt-Hooks](#prompt-and-agent-hook-fields)** (`type: "prompt"`): Senden Sie einen Prompt an ein Claude-Modell zur Einzelturn-Bewertung. Das Modell gibt seine Entscheidung als JSON zurück. Siehe [Prompt-basierte Hooks](#prompt-based-hooks).423* **[Prompt-Hooks](#prompt-and-agent-hook-fields)** (`type: "prompt"`): Senden Sie einen Prompt an ein Claude-Modell zur Einzelturn-Bewertung. Das Modell gibt seine Entscheidung als JSON zurück. Siehe [Prompt-basierte Hooks](#prompt-based-hooks).

424* **[Agent-Hooks](#prompt-and-agent-hook-fields)** (`type: "agent"`): Spawnen Sie einen Subagent, der Tools wie Read, Grep und Glob verwenden kann, um Bedingungen zu überprüfen, bevor er eine Entscheidung zurückgibt. Agent-Hooks sind experimentell und können sich ändern. Siehe [Agent-basierte Hooks](#agent-based-hooks).424* **[Agent-Hooks](#prompt-and-agent-hook-fields)** (`type: "agent"`): Spawnen Sie einen Subagent, der Tools wie Read, Grep und Glob verwenden kann, um Bedingungen zu überprüfen, bevor er eine Entscheidung zurückgibt. Agent-Hooks sind experimentell und können sich ändern. Siehe [Agent-basierte Hooks](#agent-based-hooks).

425 425 

426Alle passenden Hooks werden parallel ausgeführt. Wenn Sie denselben Handler in mehr als einer Einstellungsdatei definieren, wird er einmal ausgeführt. Eine Kopie desselben Handlers eines Plugins oder Skills bleibt separat.426Wenn ein Ereignis ausgelöst wird, werden seine passenden Hooks parallel ausgeführt. Wenn mehr als 12 davon Prompt- oder Agent-Hooks sind, laufen 12 davon gleichzeitig, und die übrigen starten, sobald laufende Hooks fertig sind. Der [`timeout`](#common-fields) jedes wartenden Hooks beginnt zu zählen, wenn dieser Hook startet.

427 

428Wenn Sie denselben Handler in mehr als einer Einstellungsdatei definieren, wird er einmal ausgeführt. Eine Kopie desselben Handlers eines Plugins oder Skills bleibt separat.

427 429 

428Handler werden im aktuellen Verzeichnis mit der Umgebung von Claude Code ausgeführt. Wenn das aktuelle Verzeichnis nicht mehr existiert, z. B. ein Worktree oder temporäres Verzeichnis, das eine andere Shell während der Sitzung gelöscht hat, führt Claude Code Command-Hooks aus dem ersten dieser Verzeichnisse aus, das noch existiert: das Verzeichnis, in dem die Sitzung gestartet wurde, das Projekt-Root, Ihr Home-Verzeichnis oder das System-Temp-Verzeichnis. Claude Code zeichnet eine Warnung auf, die das Fallback-Verzeichnis im [Debug-Log](#debug-hooks) benennt. Für eine Worktree-Sitzung, die Sie aus der Desktop-App starten, siehe [Was Worktrees mit dem Haupt-Checkout teilen](/docs/de/worktrees#what-worktrees-share-with-the-main-checkout).430Handler werden im aktuellen Verzeichnis mit der Umgebung von Claude Code ausgeführt. Wenn das aktuelle Verzeichnis nicht mehr existiert, z. B. ein Worktree oder temporäres Verzeichnis, das eine andere Shell während der Sitzung gelöscht hat, führt Claude Code Command-Hooks aus dem ersten dieser Verzeichnisse aus, das noch existiert: das Verzeichnis, in dem die Sitzung gestartet wurde, das Projekt-Root, Ihr Home-Verzeichnis oder das System-Temp-Verzeichnis. Claude Code zeichnet eine Warnung auf, die das Fallback-Verzeichnis im [Debug-Log](#debug-hooks) benennt. Für eine Worktree-Sitzung, die Sie aus der Desktop-App starten, siehe [Was Worktrees mit dem Haupt-Checkout teilen](/docs/de/worktrees#what-worktrees-share-with-the-main-checkout).

429 431 


445 447 

446Das Feld `if` enthält genau eine Berechtigungsregel. Es gibt keine `&&`-, `||`- oder Listsyntax zum Kombinieren von Regeln; um mehrere Bedingungen anzuwenden, definieren Sie einen separaten Hook-Handler für jede.448Das Feld `if` enthält genau eine Berechtigungsregel. Es gibt keine `&&`-, `||`- oder Listsyntax zum Kombinieren von Regeln; um mehrere Bedingungen anzuwenden, definieren Sie einen separaten Hook-Handler für jede.

447 449 

448In einer `if`-Bedingung für ein Datei-Tool passt ein Verzeichnismuster mit einem Segment wie `"Edit(src/**)"` nur auf das `src`-Verzeichnis im Arbeitsverzeichnis und die Dateien darunter. Um ein Verzeichnis namens `src` in beliebiger Tiefe abzugleichen, schreiben Sie `"Edit(**/src/**)"`. Vor v2.1.214 passte `"Edit(src/**)"` auf ein Verzeichnis namens `src` in beliebiger Tiefe unter dem Arbeitsverzeichnis.450In einer `if`-Bedingung für ein Datei-Tool passt ein Verzeichnismuster mit einem Segment wie `"Edit(src/**)"` nur auf das `src`-Verzeichnis im Arbeitsverzeichnis und die Dateien darunter. Um ein Verzeichnis namens `src` in beliebiger Tiefe abzugleichen, schreiben Sie `"Edit(**/src/**)"`.

449 451 

450<h4 id="bash-if-matching">452<h4 id="bash-if-matching">

451 Wie `if`-Muster Bash-Befehle abgleichen453 Wie `if`-Muster Bash-Befehle abgleichen


825 Exit-Code-Ausgabe827 Exit-Code-Ausgabe

826</h3>828</h3>

827 829 

828Der Exit-Code Ihres Hooks teilt Claude Code mit, ob die Aktion, die den Hook ausgelöst hat, etwa ein Tool-Aufruf oder ein Prompt, fortgesetzt werden soll. Ein abgeschlossener Lauf hat eines von drei Ergebnissen:830Wenn der Lauf Ihres Hooks abgeschlossen ist, entscheidet Claude Code anhand seines Exit-Codes, ob die Aktion, die ihn ausgelöst hat, etwa ein Tool-Aufruf oder ein Prompt, fortgesetzt wird:

829 831 

830* **Erfolg**: Ihr Hook wird mit 0 beendet. Claude Code wendet alle [JSON-Ausgabe](#json-output)-Felder an, die Ihr Hook ausgegeben hat, und die Aktion wird fortgesetzt, sofern diese Felder sie nicht blockieren oder verweigern. [Hooks, die einen Hintergrundprozess starten](#hooks-that-start-a-background-process) behandelt die Ausnahme.832* **Erfolg**: Ihr Hook wird mit 0 beendet. Claude Code wendet alle [JSON-Ausgabe](#json-output)-Felder an, die Ihr Hook ausgegeben hat, und die Aktion wird fortgesetzt, sofern diese Felder sie nicht blockieren oder verweigern. [Hooks, die einen Hintergrundprozess starten](#hooks-that-start-a-background-process) behandelt die Ausnahme.

831* **Blockierender Fehler**: Ihr Hook wird mit 2 beendet. Bei [Events, die blockieren können](#exit-code-2-behavior-per-event), stoppt Claude Code die Aktion.833* **Blockierender Fehler**: Ihr Hook wird mit 2 beendet. Bei [Events, die blockieren können](#exit-code-2-behavior-per-event), stoppt Claude Code die Aktion.


853 Exit-Code 0855 Exit-Code 0

854</h4>856</h4>

855 857 

856Exit 0 bedeutet Erfolg und ist der beabsichtigte Exit-Code, wenn Sie JSON für strukturierte Kontrolle drucken.858Exit 0 bedeutet Erfolg und ist der beabsichtigte Exit-Code, wenn Sie JSON für strukturierte Kontrolle ausgeben. Wenn Ihr Hook mit 0 beendet wird, aber JSON ausgibt, das nicht geparst werden kann oder die [Schemavalidierung](#json-output) nicht besteht, wird die Aktion fortgesetzt, sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails). Statt eines Erfolgs mit angewendeten Feldern ist der Lauf ein [nicht blockierender Fehler](#exit-code-output).

857 

858Für die meisten Events schreibt Claude Code stdout in das Debug-Protokoll und zeigt es nicht im Transkript an. Die Ausnahmen sind `UserPromptSubmit`, `UserPromptExpansion`, `SessionStart` und `PostModelSwitch`, wo Claude Code einfachen Text-stdout als Kontext hinzufügt, den Claude sehen und bearbeiten kann.

859 859 

860Bei einem Hook, der nicht [async](#how-async-hooks-execute) ist, parst Claude Code Ihren stdout als [JSON-Ausgabe](#json-output), wenn die gesamte Ausgabe ein einzelnes JSON-Objekt ist, das nur von Whitespace umgeben ist, und andernfalls als einfachen Text oder als Parse-Fehler:860Um Ihre Ausgabe zu korrigieren, verwenden Sie die Parse- oder Validierungsmeldung, die der `<hook name> hook error`-Hinweis enthält. Bei einem Hook, der nicht [async](#how-async-hooks-execute) ist, zählt Ihr stdout nur dann als [JSON-Ausgabe](#json-output), wenn Sie ein einzelnes JSON-Objekt ausgeben, auf einer oder mehreren Zeilen, das nur von Whitespace umgeben ist. Jeden anderen stdout liest Claude Code als einfachen Text oder als Parse-Fehler:

861 861 

862* **Ein JSON-Objekt, auf einer oder mehreren Zeilen**: wird als JSON-Ausgabe geparst.

863* **Ausgabe, die nicht mit `{` beginnt, oder die mit `{` beginnt und nicht mit `}` endet**: einfacher Text. Ein JSON-Array und ein in Anführungszeichen gesetzter JSON-String sind nach dieser Regel einfacher Text.862* **Ausgabe, die nicht mit `{` beginnt, oder die mit `{` beginnt und nicht mit `}` endet**: einfacher Text. Ein JSON-Array und ein in Anführungszeichen gesetzter JSON-String sind nach dieser Regel einfacher Text.

864* **Zwei oder mehr Zeilen, die jeweils für sich als JSON geparst werden, wobei die erste mit `{` beginnt und die letzte mit `}` endet**: einfacher Text, wenn keine Zeile ein JSON-Ausgabe-Objekt ist, das ein Feld setzt, und ein Parse-Fehler, wenn eine Zeile es ist.863* **Zwei oder mehr Zeilen, die jeweils für sich als JSON geparst werden, wobei die erste mit `{` beginnt und die letzte mit `}` endet**: einfacher Text, wenn keine Zeile ein JSON-Ausgabe-Objekt ist, das ein Feld setzt. Ist eine Zeile ein solches Objekt, ist die Ausgabe ein Parse-Fehler; geben Sie dieses Objekt also ohne weiteren Inhalt auf stdout aus.

865* **Alles andere, das mit `{` beginnt und mit `}` endet, aber kein gültiges JSON ist**: ein Parse-Fehler.864* **Alles andere, das mit `{` beginnt und mit `}` endet, aber kein gültiges JSON ist**: ein Parse-Fehler.

866 865 

867Sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails), ist ein Parse-Fehler oder ein geparstes Objekt, das die [Schemavalidierung](#json-output) nicht besteht, ein [nicht blockierender Fehler](#exit-code-output). Der `<hook name> hook error`-Hinweis enthält die Parse- oder Validierungsmeldung. Bei den Events, die einfachen Text-stdout als Kontext hinzufügen, fügt Claude Code stdout, den es nicht parsen konnte, nicht hinzu.866Für die meisten Events schreibt Claude Code stdout in das Debug-Log und zeigt es nicht im Transkript an. Die Ausnahmen sind `UserPromptSubmit`, `UserPromptExpansion`, `SessionStart` und `PostModelSwitch`, wo Claude Code einfachen Text-stdout als Kontext hinzufügt, den Claude sehen und bearbeiten kann. Bei diesen Events fügt Claude Code stdout, den es nicht parsen konnte, nicht hinzu.

868 867 

869Claude sieht stderr von einem Hook, der mit 0 beendet wird, nie. Um ihn bei Events wie `PreToolUse` selbst zu lesen, aktivieren Sie [Debug-Logging](#debug-hooks). Um eine Warnung an Claude von einem `PostToolUse`- oder `PostToolUseFailure`-Hook zu übermitteln, beenden Sie stattdessen mit 2, damit [Claude den stderr sieht](#exit-code-2-behavior-per-event), obwohl das Tool bereits ausgeführt wurde.868Claude sieht stderr von einem Hook, der mit 0 beendet wird, nie. Um ihn bei Events wie `PreToolUse` selbst zu lesen, aktivieren Sie [Debug-Logging](#debug-hooks). Um eine Warnung an Claude von einem `PostToolUse`- oder `PostToolUseFailure`-Hook zu übermitteln, beenden Sie stattdessen mit 2, damit [Claude den stderr sieht](#exit-code-2-behavior-per-event), obwohl das Tool bereits ausgeführt wurde.

870 869 


907 Andere Exit-Codes906 Andere Exit-Codes

908</h4>907</h4>

909 908 

910Sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails), ist ein Exit-Code außer 0 oder 2 mit einfachem Text oder nichts auf stdout ein [nicht blockierender Fehler](#exit-code-output). Wenn die Aktion fortgesetzt wird, sehen Sie im Transkript einen `<hook name> hook error`-Hinweis mit `Failed with non-blocking status code:` und der ersten Zeile des stderr Ihres Hooks.909Ein `<hook name> hook error`-Hinweis mit `Failed with non-blocking status code:` bedeutet, dass der Exit-Code Ihres Hooks weder 0 noch 2 war und sein stdout einfacher Text oder leer war. Sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails), ist dies ein [nicht blockierender Fehler](#exit-code-output), Ihr Hook hat die Aktion also nicht gestoppt. Um den vollständigen stderr Ihres Hooks statt der ersten Zeile, die der Hinweis zeigt, zu erfassen, aktivieren Sie [Debug-Logging](#debug-hooks).

911 910 

912Wenn zum Beispiel ein `PreToolUse`-Hook für `Bash` `something broke` auf stderr ausgibt und mit 1 beendet wird, enthält der `PreToolUse:Bash hook error`-Hinweis diese Zeile:911Wenn zum Beispiel ein `PreToolUse`-Hook für `Bash` `something broke` auf stderr ausgibt und mit 1 beendet wird, enthält der `PreToolUse:Bash hook error`-Hinweis diese Zeile:

913 912 


915Failed with non-blocking status code: something broke914Failed with non-blocking status code: something broke

916```915```

917 916 

918Um den vollständigen stderr statt nur seiner ersten Zeile zu erfassen, aktivieren Sie [Debug-Logging](#debug-hooks).917Wenn der Hinweis die `No such file or directory`-Meldung der Shell enthält, wie in der folgenden Zeile, wurde der Hook nie ausgeführt, zum Beispiel weil sein Skriptpfad nicht existiert:

919 

920Sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails), ist ein Hook, der nicht starten kann, ebenfalls ein nicht blockierender Fehler. In Shell-Form beendet sich die Shell, wenn der Skriptpfad nicht existiert oder nicht ausführbar ist, mit einem Code wie 127, und der Hinweis enthält die Meldung des Interpreters. Wenn der Skriptpfad zum Beispiel nicht existiert, enthält der Hinweis eine Zeile wie diese:

921 918 

922```text theme={null}919```text theme={null}

923Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory920Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory

924```921```

925 922 

923Wenn der Pfad falsch ist, korrigieren Sie ihn dort, wo der Hook konfiguriert ist. In Shell-Form beendet sich die Shell, wenn der Skriptpfad nicht existiert oder nicht ausführbar ist, mit einem Code wie 127, und der Hinweis enthält die Meldung des Interpreters. Sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails), ist ein Hook, der nicht starten kann, ebenfalls ein nicht blockierender Fehler.

924 

926Wenn Sie einen Policy-Hook einrichten, achten Sie bei seiner ersten Ausführung auf diesen Hinweis, denn ein falsch geschriebener Pfad in `settings.json` bedeutet, dass der Hook nie ausgeführt wird. Um die Aktion zu blockieren, wenn der Hook nicht starten kann, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails).925Wenn Sie einen Policy-Hook einrichten, achten Sie bei seiner ersten Ausführung auf diesen Hinweis, denn ein falsch geschriebener Pfad in `settings.json` bedeutet, dass der Hook nie ausgeführt wird. Um die Aktion zu blockieren, wenn der Hook nicht starten kann, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails).

927 926 

928<Warning>927<Warning>


933 Timeouts932 Timeouts

934</h4>933</h4>

935 934 

936Abgesehen von einem Command Hook, den Sie mit [`async: true`](#run-hooks-in-the-background) ausführen, bricht Claude Code einen `command`-, `http`- oder `mcp_tool`-Hook ab, der sein [`timeout`](#common-fields) erreicht, verwirft die Hook-Ausgabe, sodass bei den meisten Events ein abgelaufener Hook keine Entscheidung rendert.935Abgesehen von einem Command Hook, den Sie mit [`async: true`](#run-hooks-in-the-background) ausführen, bricht Claude Code einen `command`-, `http`- oder `mcp_tool`-Hook ab, der sein [`timeout`](#common-fields) erreicht, und verwirft die Hook-Ausgabe, sodass bei den meisten Events ein abgelaufener Hook keine Entscheidung trifft. Bei [`PreModelSwitch`](#premodelswitch) blockiert ein Hook, der bei seinem Timeout abgebrochen wird, den Modellwechsel.

937 936 

938Bei [`PreModelSwitch`](#premodelswitch) blockiert ein Hook, der bei seinem Timeout abgebrochen wird, den Modellwechsel. Bei `PreToolUse` unterscheiden sich die beiden Hook-Familien:937Bei `PreToolUse` blockiert ein abgelaufener `command`-, `http`- oder `mcp_tool`-Hook den Tool-Aufruf nicht, außer bei Hooks, [deren Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails). Der Aufruf wird durch den normalen [Berechtigungsfluss](/docs/de/permissions) fortgesetzt, verlassen Sie sich also nicht auf einen steckengebliebenen Hook, um als Gate zu fungieren. Um den Aufruf zu blockieren, wenn ein `command`- oder `http`-Hook in ein Timeout läuft, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails). Ein [Agent SDK Callback Hook](/docs/de/agent-sdk/hooks), der sein Timeout überschreitet, [blockiert den Tool-Aufruf](#pretooluse).

939 

940* Ein abgelaufener `command`-, `http`- oder `mcp_tool`-Hook blockiert den Tool-Aufruf nicht, außer bei Hooks, [deren Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails). Der Aufruf wird durch den normalen [Berechtigungsfluss](/docs/de/permissions) fortgesetzt, verlassen Sie sich also nicht auf einen steckengebliebenen Hook, um als Gate zu fungieren. Um den Aufruf zu blockieren, wenn ein `command`- oder `http`-Hook in ein Timeout läuft, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails).

941* Ein [Agent SDK Callback Hook](/docs/de/agent-sdk/hooks), der sein Timeout überschreitet, [blockiert den Tool-Aufruf](#pretooluse).

942 938 

943<h4 id="hooks-that-start-a-background-process">939<h4 id="hooks-that-start-a-background-process">

944 Hooks, die einen Hintergrundprozess starten940 Hooks, die einen Hintergrundprozess starten


1086 HTTP-Response-Handling1082 HTTP-Response-Handling

1087</h3>1083</h3>

1088 1084 

1089HTTP Hooks verwenden HTTP-Statuscodes und Response-Bodies anstelle von Exit-Codes und stdout. Die folgenden Ergebnisse gelten für die meisten Events; ein Event mit seinem eigenen Fehlervertrag in der [Pro-Event-Tabelle](#exit-code-2-behavior-per-event), wie `WorktreeCreate`, wendet diesen Vertrag auch auf einen fehlgeschlagenen HTTP-Hook an:1085HTTP Hooks verwenden HTTP-Statuscodes und Response-Bodies anstelle von Exit-Codes und stdout. Um die Aktion zu blockieren, wenn die Anfrage fehlschlägt oder einen Nicht-2xx-Status zurückgibt, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails). Um einen Tool-Aufruf zu blockieren oder eine Berechtigung zu verweigern, geben Sie eine 2xx-Antwort mit einem JSON-Body zurück, der die entsprechenden [Entscheidungsfelder](#decision-control) enthält.

1086 

1087Nach einem [nicht blockierenden Fehler](#exit-code-output) wird die Aktion fortgesetzt, sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails). Außer bei Events mit eigenem Fehlervertrag in der [Pro-Event-Tabelle](#exit-code-2-behavior-per-event), wie `WorktreeCreate`, erhalten Sie für jede Antwort bzw. jeden Fehlschlag diese Ergebnisse:

1090 1088 

1091* **2xx mit leerem Body**: Erfolg, äquivalent zu Exit-Code 0 ohne Ausgabe1089* **2xx mit leerem Body**: Erfolg, äquivalent zu Exit-Code 0 ohne Ausgabe

1092* **2xx mit JSON-Objekt-Body**: geparst mit dem gleichen [JSON-Ausgabe](#json-output)-Schema wie Command Hooks. Ein Body, der die Schema-Validierung nicht besteht, ist ein nicht blockierender Fehler1090* **2xx mit JSON-Objekt-Body**: geparst mit dem gleichen [JSON-Ausgabe](#json-output)-Schema wie Command Hooks. Ein Body, der die Schema-Validierung nicht besteht, ist ein nicht blockierender Fehler


1095* **Verbindungsfehler**: nicht blockierender Fehler1093* **Verbindungsfehler**: nicht blockierender Fehler

1096* **Timeout**: der Hook wird abgebrochen, wie unter [Timeouts](#timeouts) beschrieben1094* **Timeout**: der Hook wird abgebrochen, wie unter [Timeouts](#timeouts) beschrieben

1097 1095 

1098Nach einem [nicht blockierenden Fehler](#exit-code-output) wird die Aktion fortgesetzt, sofern es sich nicht um einen Hook handelt, [dessen Fehlschlag die Aktion blockiert](#block-the-action-when-a-hook-fails). Um einen Tool-Aufruf zu blockieren oder eine Berechtigung zu verweigern, geben Sie eine 2xx-Antwort mit einem JSON-Body zurück, der die entsprechenden [Entscheidungsfelder](#decision-control) enthält. Um die Aktion zu blockieren, wenn die Anfrage fehlschlägt oder einen Nicht-2xx-Status zurückgibt, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails).

1099 

1100<h3 id="json-output">1096<h3 id="json-output">

1101 JSON-Ausgabe1097 JSON-Ausgabe

1102</h3>1098</h3>


1319| `compact` | Automatische oder manuelle Komprimierung |1315| `compact` | Automatische oder manuelle Komprimierung |

1320| `fork` | Eine neue Sitzung, die von einer bestehenden abgezweigt wurde: `--fork-session` mit `--resume` oder `--continue`, die Hintergrundkopie von `/fork`, `/branch` oder eine Konversation, die Sie [in den Hintergrund verschieben](/docs/de/agent-view#from-inside-a-session) |1316| `fork` | Eine neue Sitzung, die von einer bestehenden abgezweigt wurde: `--fork-session` mit `--resume` oder `--continue`, die Hintergrundkopie von `/fork`, `/branch` oder eine Konversation, die Sie [in den Hintergrund verschieben](/docs/de/agent-view#from-inside-a-session) |

1321 1317 

1322Vor v2.1.214 meldeten abgezweigte Sitzungen die Quelle `"resume"`.

1323 

1324Wenn Sie eine interaktive Sitzung starten, beim Start eine Konversation mit `--continue` oder `--resume` fortsetzen oder `/clear` ausführen, laufen SessionStart-Hooks im Hintergrund. Sie können sofort tippen, und eine fortgesetzte Konversation erscheint, ohne auf die Hooks zu warten. Die erste Antwort von Claude wartet dennoch, bis die Hooks fertig sind, damit ihr Kontext Claude erreicht.1318Wenn Sie eine interaktive Sitzung starten, beim Start eine Konversation mit `--continue` oder `--resume` fortsetzen oder `/clear` ausführen, laufen SessionStart-Hooks im Hintergrund. Sie können sofort tippen, und eine fortgesetzte Konversation erscheint, ohne auf die Hooks zu warten. Die erste Antwort von Claude wartet dennoch, bis die Hooks fertig sind, damit ihr Kontext Claude erreicht.

1325 1319 

1326Wenn Sie innerhalb einer Sitzung mit `/resume` die Konversation wechseln, wartet der Wechsel stattdessen, bis die Hooks fertig sind. Wenn Sie `/clear` ausführen oder zu einer anderen Konversation wechseln, während Hintergrund-Hooks noch laufen, wird nichts von dem, was sie zurückgeben, auf die Sitzung angewendet.1320Wenn Sie innerhalb einer Sitzung mit `/resume` die Konversation wechseln, wartet der Wechsel stattdessen, bis die Hooks fertig sind. Wenn Sie `/clear` ausführen oder zu einer anderen Konversation wechseln, während Hintergrund-Hooks noch laufen, wird nichts von dem, was sie zurückgeben, auf die Sitzung angewendet.


1583 1577 

1584Abgesehen von einem Befehls-Hook, den Sie mit [`async: true`](#run-hooks-in-the-background) ausführen, wird ein `UserPromptSubmit`-Befehls-, HTTP- oder MCP-Tool-Hook, der seinen Timeout erreicht, abgebrochen, und seine Ausgabe, einschließlich eines etwaigen `additionalContext`, wird verworfen. Der Prompt erreicht Claude trotzdem, ohne diesen Kontext. Um den Prompt stattdessen zu blockieren, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails) bei einem Befehls- oder HTTP-Hook. Das Transkript zeigt einen Hinweis, der den Hook und den ausgelösten Timeout nennt und angibt, dass die Ausgabe verworfen wurde.1578Abgesehen von einem Befehls-Hook, den Sie mit [`async: true`](#run-hooks-in-the-background) ausführen, wird ein `UserPromptSubmit`-Befehls-, HTTP- oder MCP-Tool-Hook, der seinen Timeout erreicht, abgebrochen, und seine Ausgabe, einschließlich eines etwaigen `additionalContext`, wird verworfen. Der Prompt erreicht Claude trotzdem, ohne diesen Kontext. Um den Prompt stattdessen zu blockieren, setzen Sie [`onFailure: "block"`](#block-the-action-when-a-hook-fails) bei einem Befehls- oder HTTP-Hook. Das Transkript zeigt einen Hinweis, der den Hook und den ausgelösten Timeout nennt und angibt, dass die Ausgabe verworfen wurde.

1585 1579 

1586Ein [Agent SDK-Callback-Hook](/docs/de/agent-sdk/hooks) bei `UserPromptSubmit`, der seinen Timeout erreicht, blockiert den Prompt mit einer Meldung, die den Hook und den Timeout nennt, da ein Callback an dieser Stelle als Richtlinienprüfung dienen kann, die bei einem Fehler nicht einfach durchlassen darf. Die Sitzung wird fortgesetzt. Vor v2.1.208 beendete ein Callback-Timeout bei diesem Event den Turn mit einem Ausführungsfehler.1580Ein [Agent-SDK-Callback-Hook](/docs/de/agent-sdk/hooks) bei `UserPromptSubmit`, der seinen Timeout erreicht, blockiert den Prompt mit einer Meldung, die den Hook und den Timeout nennt, da ein Callback dort als Richtlinien-Gate fungieren kann, das nicht offen fehlschlagen darf. Die Sitzung wird fortgesetzt.

1587 1581 

1588<h4 id="userpromptsubmit-input">1582<h4 id="userpromptsubmit-input">

1589 UserPromptSubmit-Eingabe1583 UserPromptSubmit-Eingabe


2058 2052 

2059| Feld | Typ | Beispiel | Beschreibung |2053| Feld | Typ | Beispiel | Beschreibung |

2060| :- | :- | :- | :- |2054| :- | :- | :- | :- |

2061| `status` | string | `"completed"` | `"completed"` für Subagenten im Vordergrund, `"async_launched"` für Subagenten im Hintergrund. Subagenten laufen standardmäßig im Hintergrund, daher erzeugt auch ein Agent-Aufruf, der `run_in_background` weglässt, `"async_launched"` |2055| `status` | string | `"completed"` | `"completed"` für Subagenten im Vordergrund, `"async_launched"` für Subagenten im Hintergrund. Welche Subagenten auf welche Weise laufen, erfahren Sie unter [Subagenten im Vordergrund oder Hintergrund ausführen](/docs/de/sub-agents#run-subagents-in-foreground-or-background) |

2062| `agentId` | string | `"a4d2c8f1e0b3a297"` | Kennung des Subagenten-Laufs |2056| `agentId` | string | `"a4d2c8f1e0b3a297"` | Kennung des Subagenten-Laufs |

2063| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Die abschließenden Textblöcke des Subagenten oder, bei einem Subagenten, dessen Bericht über `SubagentHandback` läuft, an ihrer Stelle ein kurzer Hinweis auf diese Übergabe |2057| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Die abschließenden Textblöcke des Subagenten oder, bei einem Subagenten, dessen Bericht über `SubagentHandback` läuft, an ihrer Stelle ein kurzer Hinweis auf diese Übergabe |

2064| `resolvedModel` | string | `"claude-sonnet-4-5"` | Modell, mit dem der Subagent gestartet ist und das vom angeforderten Modell abweichen kann |2058| `resolvedModel` | string | `"claude-sonnet-4-5"` | Modell, mit dem der Subagent gestartet ist und das vom angeforderten Modell abweichen kann |

2065| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Verwendete Modelle in Reihenfolge, wobei aufeinanderfolgende Wiederholungen zusammengefasst sind; nur gesetzt, wenn das Modell während des Laufs gewechselt wurde. Erfordert Claude Code v2.1.212 oder höher |2059| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Verwendete Modelle in Reihenfolge, aufeinanderfolgende Wiederholungen zusammengefasst; nur gesetzt, wenn das Modell während des Laufs gewechselt wurde |

2066| `totalTokens` | number | `12450` | Token-Anzahl aus der letzten API-Anfrage des Subagenten: Eingabe-, Ausgabe- und Cache-Token zusammen. Dies ist keine Gesamtzahl über den ganzen Lauf |2060| `totalTokens` | number | `12450` | Token-Anzahl aus der letzten API-Anfrage des Subagenten: Eingabe-, Ausgabe- und Cache-Token zusammen. Dies ist keine Gesamtzahl über den ganzen Lauf |

2067| `totalDurationMs` | number | `48211` | Echtzeitdauer des Subagenten-Laufs |2061| `totalDurationMs` | number | `48211` | Echtzeitdauer des Subagenten-Laufs |

2068| `totalToolUseCount` | number | `7` | Anzahl der Tool-Aufrufe, die der Subagent ausgeführt hat |2062| `totalToolUseCount` | number | `7` | Anzahl der Tool-Aufrufe, die der Subagent ausgeführt hat |


2072 2066 

2073Bei Subagenten im Hintergrund kehrt das Tool zurück, wenn die Aufgabe in den Hintergrund wechselt, daher enthält `tool_response` keine Nutzungsfelder: Ein Start im Hintergrund kehrt sofort zurück, und eine Vordergrundaufgabe, die Claude Code während des Laufs in den Hintergrund verschiebt, kehrt bei diesem Übergang zurück. Die Antwort enthält `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` und `resolvedModel`.2067Bei Subagenten im Hintergrund kehrt das Tool zurück, wenn die Aufgabe in den Hintergrund wechselt, daher enthält `tool_response` keine Nutzungsfelder: Ein Start im Hintergrund kehrt sofort zurück, und eine Vordergrundaufgabe, die Claude Code während des Laufs in den Hintergrund verschiebt, kehrt bei diesem Übergang zurück. Die Antwort enthält `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` und `resolvedModel`.

2074 2068 

2075Bei einer `completed`-Antwort nennt `resolvedModel` das Modell, mit dem der Subagent gestartet ist, das vom Wert `model` in `tool_input` abweichen kann, etwa wenn `availableModels` oder eine andere Überschreibung greift. Bei einer `async_launched`-Antwort nennt `resolvedModel` das Modell, das verwendet wurde, als der Agent in den Hintergrund wechselte, sodass sich ein Wechsel vor diesem Zeitpunkt dort widerspiegelt. `modelsUsed` und das Verhalten von `resolvedModel` zum Zeitpunkt des Wechsels in den Hintergrund erfordern Claude Code v2.1.212 oder höher.2069Bei einer `completed`-Antwort nennt `resolvedModel` das Modell, mit dem der Subagent gestartet ist; es kann vom `model`-Wert in `tool_input` abweichen, etwa wenn `availableModels` oder eine andere Überschreibung greift. Bei einer `async_launched`-Antwort nennt `resolvedModel` das Modell, das verwendet wurde, als der Agent in den Hintergrund wechselte, sodass ein Wechsel vor dem Verschieben in den Hintergrund dort berücksichtigt ist.

2076 2070 

2077<a id="askuserquestion" />2071<a id="askuserquestion" />

2078 2072 


2120 2114 

2121Wenn ein Hook `"ask"` zurückgibt, enthält die dem Benutzer angezeigte Berechtigungsabfrage eine Bezeichnung, die angibt, woher der Hook stammt: `[settings]` für einen Hook aus einer beliebigen Einstellungsdatei oder aus Agenten-Frontmatter, `[plugin:<name>]` für den Hook eines Plugins oder `[skill]` für einen Hook aus Skill-Frontmatter. So können Benutzer nachvollziehen, welche Konfigurationsquelle die Bestätigung anfordert.2115Wenn ein Hook `"ask"` zurückgibt, enthält die dem Benutzer angezeigte Berechtigungsabfrage eine Bezeichnung, die angibt, woher der Hook stammt: `[settings]` für einen Hook aus einer beliebigen Einstellungsdatei oder aus Agenten-Frontmatter, `[plugin:<name>]` für den Hook eines Plugins oder `[skill]` für einen Hook aus Skill-Frontmatter. So können Benutzer nachvollziehen, welche Konfigurationsquelle die Bestätigung anfordert.

2122 2116 

2123Ein `"ask"` eines Hooks erzwingt auch im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) eine Berechtigungsabfrage: Der Klassifikator kann den Tool-Aufruf weiterhin ablehnen, ihn aber nicht stillschweigend genehmigen. Vor v2.1.211 konnte der Klassifikator einen Bash-Befehl, der außerhalb der [Sandbox](/docs/de/sandboxing) lief, genehmigen, ohne die vom Hook angeforderte Abfrage anzuzeigen; der Klassifikator wandte auf diesen Befehl dennoch seine eigenen Sicherheitsregeln an, und ein `"deny"` eines Hooks wurde immer beachtet.2117Ein `"ask"` eines Hooks erzwingt auch im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) eine Berechtigungsabfrage: Der Klassifikator kann den Tool-Aufruf weiterhin ablehnen, ihn aber nicht stillschweigend genehmigen.

2124 2118 

2125```json theme={null}2119```json theme={null}

2126{2120{


3696| `source` | string | Woher die Anfrage stammt: `"command"` für `/model <name>`, die Einstellung „Model“ in `/config` oder das Einschalten des Fast-Modus; `"picker"` für eine Modellauswahl; `"sdk"` für eine `set_model`-Anfrage oder eine Modelländerung in einer `apply_flag_settings`-Anfrage von einem Agent-SDK-Host oder von Remote Control |3690| `source` | string | Woher die Anfrage stammt: `"command"` für `/model <name>`, die Einstellung „Model“ in `/config` oder das Einschalten des Fast-Modus; `"picker"` für eine Modellauswahl; `"sdk"` für eine `set_model`-Anfrage oder eine Modelländerung in einer `apply_flag_settings`-Anfrage von einem Agent-SDK-Host oder von Remote Control |

3697| `context_tokens` | number | Token, die die nächste Anfrage erneut als Prompt sendet: Eingabe-, Cache-Lese-, Cache-Erstellungs- und Ausgabe-Token der letzten Antwort in der Hauptkonversation zusammengenommen. `0` vor der ersten Antwort |3691| `context_tokens` | number | Token, die die nächste Anfrage erneut als Prompt sendet: Eingabe-, Cache-Lese-, Cache-Erstellungs- und Ausgabe-Token der letzten Antwort in der Hauptkonversation zusammengenommen. `0` vor der ersten Antwort |

3698| `prompt_cache_warm` | boolean | Ob der Prompt-Cache des aktuellen Modells wahrscheinlich noch warm ist, sodass er durch den Wechsel verloren geht |3692| `prompt_cache_warm` | boolean | Ob der Prompt-Cache des aktuellen Modells wahrscheinlich noch warm ist, sodass er durch den Wechsel verloren geht |

3699| `cache_ttl` | string | [Prompt-Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime), die Claude Code für diese Sitzung anfordert: `"5m"` oder `"1h"` |3693| `cache_ttl` | string | [Lebensdauer des Prompt-Caches](/docs/de/prompt-caching#cache-lifetime) der Hauptkonversation zum Zeitpunkt dieses Wechsels: `"5m"` oder `"1h"` |

3700| `estimated_cache_write_usd` | number | Geschätzte Kosten in US-Dollar für das Schreiben von `context_tokens` in den Prompt-Cache von `to_model` zum `cache_ttl`-Tarif, ohne die nächste Antwort. Der Server muss möglicherweise nicht den gesamten Kontext erneut zwischenspeichern, betrachten Sie den Wert daher als Schätzung |3694| `estimated_cache_write_usd` | number | Geschätzte Kosten in US-Dollar für das Schreiben von `context_tokens` in den Prompt-Cache von `to_model` zum `cache_ttl`-Tarif, ohne die nächste Antwort. Der Server muss möglicherweise nicht den gesamten Kontext erneut zwischenspeichern, betrachten Sie den Wert daher als Schätzung |

3701| `pricing` | string | Wie Claude Code `estimated_cache_write_usd` berechnet hat: `"configured"` zu den eigenen Tarifen Ihrer Organisation, sofern diese konfiguriert sind, `"catalog"` zum Listenpreis oder `"default"`, wenn für `to_model` kein Preis bekannt ist und Claude Code einen Standardtarif angenommen hat |3695| `pricing` | string | Wie Claude Code `estimated_cache_write_usd` berechnet hat: `"configured"` zu den eigenen Tarifen Ihrer Organisation, sofern diese konfiguriert sind, `"catalog"` zum Listenpreis oder `"default"`, wenn für `to_model` kein Preis bekannt ist und Claude Code einen Standardtarif angenommen hat |

3702 3696 


3757 3751 

3758Ein PreModelSwitch-Hook, der nicht vor Ablauf seines Timeouts antwortet, blockiert den Wechsel. Der Standard-Timeout für dieses Ereignis beträgt 30 Sekunden.3752Ein PreModelSwitch-Hook, der nicht vor Ablauf seines Timeouts antwortet, blockiert den Wechsel. Der Standard-Timeout für dieses Ereignis beträgt 30 Sekunden.

3759 3753 

3760Was ein anderer Exit-Code als 0 oder 2 bewirkt, erfahren Sie unter [Andere Exit-Codes](#other-exit-codes).3754Ein anderer Exit-Code als 0 oder 2 ohne gültige JSON-Ausgabe ist ein [nicht blockierender Fehler](#other-exit-codes), der Wechsel findet also statt, außer bei Hooks, [deren Fehlschlagen ihn blockiert](#block-the-action-when-a-hook-fails).

3761 3755 

3762<h3 id="postmodelswitch">3756<h3 id="postmodelswitch">

3763 PostModelSwitch3757 PostModelSwitch


4275Was bei `ok: false` passiert, hängt vom Ereignis ab:4269Was bei `ok: false` passiert, hängt vom Ereignis ab:

4276 4270 

4277* `Stop` und `SubagentStop`: der Grund wird an Claude als nächste Anweisung zurückgegeben und der Turn wird fortgesetzt, es sei denn, die Antwort setzt auch `impossible: true`, in welchem Fall Claude Code den Stop zulässt und der Turn endet4271* `Stop` und `SubagentStop`: der Grund wird an Claude als nächste Anweisung zurückgegeben und der Turn wird fortgesetzt, es sei denn, die Antwort setzt auch `impossible: true`, in welchem Fall Claude Code den Stop zulässt und der Turn endet

4278* `PreToolUse`: der Tool-Aufruf wird verweigert; standardmäßig endet der Turn und der Verweigerungsgrund wird im Chat als Warnzeile angezeigt. Setzen Sie `continueOnBlock: true`, um den Grund stattdessen an Claude als Tool-Fehler zurückzugeben, damit es anpassen und fortfahren kann, äquivalent zu einem Command-Hook mit `permissionDecision: "deny"`. Vor v2.1.210 wurde der Verweigerungsgrund an Claude als Tool-Fehler zurückgegeben und der Turn wurde fortgesetzt4272* `PreToolUse`: der Tool-Aufruf wird verweigert; standardmäßig endet der Turn und der Verweigerungsgrund wird im Chat als Warnzeile angezeigt. Setzen Sie `continueOnBlock: true`, um den Grund stattdessen an Claude als Tool-Fehler zurückzugeben, damit es anpassen und fortfahren kann, äquivalent zu einem Command-Hook mit `permissionDecision: "deny"`

4279* `PostToolUse`: standardmäßig endet der Turn und der Grund wird im Chat als Warnzeile angezeigt. Setzen Sie `continueOnBlock: true`, um den Grund an Claude zurückzugeben und den Turn stattdessen fortzusetzen4273* `PostToolUse`: standardmäßig endet der Turn und der Grund wird im Chat als Warnzeile angezeigt. Setzen Sie `continueOnBlock: true`, um den Grund an Claude zurückzugeben und den Turn stattdessen fortzusetzen

4280* `PostToolBatch`, `UserPromptSubmit` und `UserPromptExpansion`: der Turn endet und der Grund wird als Warnzeile angezeigt. Diese Ereignisse beenden den Turn bei `decision: "block"` unabhängig von `continue`4274* `PostToolBatch`, `UserPromptSubmit` und `UserPromptExpansion`: der Turn endet und der Grund wird als Warnzeile angezeigt. Diese Ereignisse beenden den Turn bei `decision: "block"` unabhängig von `continue`

4281* `PostToolUseFailure` und `TaskCreated`: der Grund wird an Claude als Tool-Fehler zurückgegeben und der Turn wird fortgesetzt, unabhängig von `continueOnBlock`4275* `PostToolUseFailure` und `TaskCreated`: der Grund wird an Claude als Tool-Fehler zurückgegeben und der Turn wird fortgesetzt, unabhängig von `continueOnBlock`

hooks-guide.md +22 −27

Details

627exit 0 # exit 0 = keine Entscheidung; der normale Berechtigungsfluss gilt627exit 0 # exit 0 = keine Entscheidung; der normale Berechtigungsfluss gilt

628```628```

629 629 

630Der Exit-Code bestimmt, was als nächstes passiert:630Bei einem anderen Exit-Code als 0 und 2 und ohne gültige JSON-Ausgabe wird die Aktion bei den meisten Events fortgesetzt, es sei denn, es handelt sich um einen Hook, [dessen Fehlschlagen die Aktion blockiert](/docs/de/hooks#block-the-action-when-a-hook-fails). Ein Hook, bei dem `onFailure` auf `"block"` gesetzt ist, ist ein Beispiel dafür. Beenden Sie mit 0, um keinen Einwand zu melden, oder mit 2, um die Aktion zu blockieren:

631 631 

632* **Exit 0**: Ihr Hook meldet keinen Einwand über seinen Exit-Code.632* **Exit 0**: Wenn Sie einen `PreToolUse`-Hook mit 0 beenden, durchläuft der Tool-Aufruf weiterhin den normalen [Berechtigungsfluss](/docs/de/permissions), da exit 0 ihn nicht genehmigt. Für `UserPromptSubmit`-, `UserPromptExpansion`-, `SessionStart`- und `PostModelSwitch`-Hooks fügt Claude Code stdout, das es [als Klartext behandelt](/docs/de/hooks#exit-code-0), zu Claudes Kontext hinzu.

633 * Für einen `PreToolUse`-Hook genehmigt dies nicht den Tool-Aufruf: der normale [Berechtigungsfluss](/docs/de/permissions) gilt weiterhin.633* **Exit 2**: Schreiben Sie einen Grund auf stderr. Je nach Event erhält Claude ihn als Feedback, damit es sich anpassen kann, der Benutzer sieht ihn, oder es erscheint keine Meldung, wie bei `ConfigChange` und `Elicitation`. Einige Events können nicht blockiert werden: Für `SessionStart` und andere zeigt exit 2 stderr dem Benutzer an und die Ausführung wird fortgesetzt. Siehe [Exit-Code-2-Verhalten pro Event](/docs/de/hooks#exit-code-2-behavior-per-event) für die vollständige Liste.

634 * Für `UserPromptSubmit`-, `UserPromptExpansion`-, `SessionStart`- und `PostModelSwitch`-Hooks fügt Claude Code stdout, das es [als Klartext behandelt](/docs/de/hooks#exit-code-0), zu Claudes Kontext hinzu.634* **Jeder andere Exit-Code**: Die Pro-Event-Ausnahmen, etwa dass `WorktreeCreate` bei jedem Exit-Code ungleich null fehlschlägt, finden Sie unter [Exit-Code-Ausgabe](/docs/de/hooks#exit-code-output). Bei anderen Events finden Sie Ihren Fall anhand dessen, was Ihr Hook auf stdout ausgegeben hat, sofern es sich nicht um einen Hook handelt, dessen Fehlschlagen die Aktion blockiert:

635* **Exit 2**: Claude Code blockiert die Aktion. Schreiben Sie einen Grund auf stderr. Wo er landet, hängt vom Event ab: Einige Events geben ihn an Claude als Feedback, damit es sich anpassen kann, andere zeigen ihn dem Benutzer, und einige, wie `ConfigChange` und `Elicitation`, zeigen keine Meldung. Einige Events können nicht blockiert werden: Für `SessionStart` und andere zeigt exit 2 stderr dem Benutzer an und die Ausführung wird fortgesetzt. Siehe [Exit-Code-2-Verhalten pro Event](/docs/de/hooks#exit-code-2-behavior-per-event) für die vollständige Liste.635 * Ein geparstes Objekt, das die Schemavalidierung besteht: Claude Code ignoriert den Exit-Code, nur das JSON entscheidet das Ergebnis, und der Hook wird nicht als Fehler gemeldet.

636* **Jeder andere Exit-Code**: Für die meisten Events wird die Aktion als [nicht blockierender Fehler](/docs/de/hooks#exit-code-output) fortgesetzt, es sei denn, es handelt sich um einen Hook, [dessen Fehlschlagen die Aktion blockiert](/docs/de/hooks#block-the-action-when-a-hook-fails), oder seine JSON-Ausgabe besteht die Validierung:636 * Ein geparstes Objekt, das die Schemavalidierung nicht besteht, oder stdout, das Claude Code [als JSON zu parsen versucht](/docs/de/hooks#exit-code-0), das aber kein gültiges JSON ist: Die Aktion wird als nicht blockierender Fehler fortgesetzt. Prüfen Sie die Meldung `<hook name> hook error` auf die Validierungs- oder Parse-Meldung.

637 * Ein geparstes Objekt, das die Schemavalidierung besteht: Claude Code ignoriert den Exit-Code, nur das JSON entscheidet das Ergebnis, und der Hook wird nicht als Fehler gemeldet. Die Pro-Event-Ausnahmen, wie `WorktreeCreate`, das bei jedem Exit-Code ungleich null fehlschlägt, sind im Abschnitt [Exit-Code-Ausgabe](/docs/de/hooks#exit-code-output) der Referenz aufgelistet.637 * Stdout, das Claude Code [als Klartext behandelt](/docs/de/hooks#exit-code-0), oder leeres stdout: Die Aktion wird als nicht blockierender Fehler fortgesetzt. Das Transkript zeigt eine `<hook name> hook error`-Meldung, dann die erste Zeile von stderr mit dem Präfix `Failed with non-blocking status code:`. Um das vollständige stderr zu erfassen, aktivieren Sie [Debug-Logging](/docs/de/hooks#debug-hooks) mit `claude --debug` oder durch Ausführung von `/debug` während der Sitzung.

638 * Ein geparstes Objekt, das die Schemavalidierung nicht besteht, oder stdout, das Claude Code [als JSON zu parsen versucht](/docs/de/hooks#exit-code-0), das aber kein gültiges JSON ist: ein nicht blockierender Fehler; die Meldung enthält die Validierungs- oder Parse-Meldung.

639 * Stdout, das Claude Code [als Klartext behandelt](/docs/de/hooks#exit-code-0), oder leeres stdout: die Aktion wird als nicht blockierender Fehler fortgesetzt. Das Transkript zeigt eine `<hook name> hook error`-Meldung, dann die erste Zeile von stderr mit dem Präfix `Failed with non-blocking status code:`. Um das vollständige stderr zu erfassen, aktivieren Sie [Debug-Logging](/docs/de/hooks#debug-hooks) mit `claude --debug` oder durch Ausführung von `/debug` während der Sitzung.

640 638 

641<h4 id="structured-json-output">639<h4 id="structured-json-output">

642 Strukturierte JSON-Ausgabe640 Strukturierte JSON-Ausgabe


662 660 

663Mit `"deny"` bricht Claude Code den Tool-Aufruf ab und gibt `permissionDecisionReason` an Claude als Feedback zurück.661Mit `"deny"` bricht Claude Code den Tool-Aufruf ab und gibt `permissionDecisionReason` an Claude als Feedback zurück.

664 662 

665Bei `PreToolUse` behandelt Claude Code jeden `permissionDecision`-Wert wie folgt:663Bei `PreToolUse` können Sie auch `"ask"` zurückgeben, um dem Benutzer die normale Berechtigungsabfrage anzuzeigen, oder `"allow"`, um die interaktive Berechtigungsabfrage zu überspringen. Bei `"allow"` gelten deny- und ask-Regeln, einschließlich unternehmensweit verwalteter Deny-Listen, weiterhin, ebenso wie Abfragen für:

666 664 

667* `"allow"`: die interaktive Berechtigungsabfrage überspringen. Deny- und Ask-Regeln, einschließlich unternehmensweit verwalteter Deny-Listen, gelten weiterhin, ebenso wie Abfragen für:665* Lesezugriffe auf [Netzwerkpfade](/docs/de/permissions#network-paths)

668 666* MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind

669 * Lesezugriffe auf [Netzwerkpfade](/docs/de/permissions#network-paths)667* Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), in Sitzungen, in denen diese Einstellung Claude Code erreicht

670 * MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind

671 * Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), in Sitzungen, in denen diese Einstellung Claude Code erreicht

672 668 

673 Was `"allow"` im Plan-Modus bewirkt, erfahren Sie unter [Hook-Genehmigungen im Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode).669 Was `"allow"` im Plan-Modus bewirkt, erfahren Sie unter [Hook-Genehmigungen im Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode).

674* `"deny"`: Tool-Aufruf abbrechen und den Grund an Claude senden

675* `"ask"`: Berechtigungsaufforderung dem Benutzer wie gewohnt anzeigen

676 670 

677Ein 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.671Ein 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.

678 672 


892 886 

893* `"ok": true`: die Aktion wird fortgesetzt887* `"ok": true`: die Aktion wird fortgesetzt

894* `"ok": false`: was passiert, hängt vom Ereignis ab:888* `"ok": false`: was passiert, hängt vom Ereignis ab:

895 * `Stop` und `SubagentStop`: der `reason` wird an Claude zurückgegeben, sodass es weiterarbeitet, es sei denn, die Antwort setzt auch `"impossible": true`, um die Bedingung als eine zu kennzeichnen, die niemals erfüllt werden kann. In diesem Fall erlaubt Claude Code den Stop und der Zug endet889 * `Stop` und `SubagentStop`: der `reason` wird an Claude zurückgegeben, sodass es weiterarbeitet, es sei denn, die Antwort setzt auch `"impossible": true`, um die Bedingung als eine zu kennzeichnen, die niemals erfüllt werden kann. In diesem Fall erlaubt Claude Code den Stop und der Turn endet

896 * `PreToolUse`: der Tool-Aufruf wird verweigert; standardmäßig endet der Zug und der Ablehnungs-`reason` erscheint im Chat als Warnzeile. Setzen Sie `continueOnBlock: true` auf dem Hook, um stattdessen den `reason` an Claude als Tool-Fehler zurückzugeben, sodass es sich anpassen und fortfahren kann. Vor v2.1.210 wurde der Ablehnungs-`reason` an Claude als Tool-Fehler zurückgegeben und der Zug wurde fortgesetzt890 * `PreToolUse`: der Tool-Aufruf wird verweigert; standardmäßig endet der Turn und der Ablehnungs-`reason` erscheint im Chat als Warnzeile. Setzen Sie `continueOnBlock: true` auf dem Hook, um stattdessen den `reason` an Claude als Tool-Fehler zurückzugeben, sodass es sich anpassen und fortfahren kann

897 * `PostToolUse`: standardmäßig endet der Zug und der `reason` erscheint im Chat als Warnzeile. Setzen Sie `continueOnBlock: true`, um den `reason` an Claude zurückzugeben und den Zug stattdessen fortzusetzen891 * `PostToolUse`: standardmäßig endet der Turn und der `reason` erscheint im Chat als Warnzeile. Setzen Sie `continueOnBlock: true`, um den `reason` an Claude zurückzugeben und den Turn stattdessen fortzusetzen

898 * `PostToolBatch`, `UserPromptSubmit` und `UserPromptExpansion`: der Zug endet und der `reason` erscheint im Chat als Warnzeile892 * `PostToolBatch`, `UserPromptSubmit` und `UserPromptExpansion`: der Turn endet und der `reason` erscheint im Chat als Warnzeile

899 893 

900Dieses Beispiel verwendet einen `Stop`-Hook, um das Modell zu fragen, ob alle angeforderten Aufgaben abgeschlossen sind. Wenn das Modell `"ok": false` zurückgibt, weil die Bedingung noch nicht erfüllt ist, arbeitet Claude weiter und verwendet den `reason` als nächste Anweisung:894Dieses Beispiel verwendet einen `Stop`-Hook, um das Modell zu fragen, ob alle angeforderten Aufgaben abgeschlossen sind. Wenn das Modell `"ok": false` zurückgibt, weil die Bedingung noch nicht erfüllt ist, arbeitet Claude weiter und verwendet den `reason` als nächste Anweisung:

901 895 


1019 Hooks und Genehmigungsmodi1013 Hooks und Genehmigungsmodi

1020</h3>1014</h3>

1021 1015 

1022`PreToolUse`-Hooks werden vor jeder Genehmigungsmodus-Prüfung in jedem [Genehmigungsmodus](/docs/de/permission-modes) ausgelöst, einschließlich `dontAsk`. Ein Hook, der `permissionDecision: "deny"` zurückgibt, blockiert das Tool auch im `bypassPermissions`-Modus oder mit `--dangerously-skip-permissions`. Dies ermöglicht es Ihnen, eine Richtlinie durchzusetzen, die Benutzer nicht umgehen können, indem sie ihren Genehmigungsmodus ändern.1016Mit einem Hook in einer Einstellungsdatei oder in der `hooks/hooks.json` eines Plugins können Sie Einschränkungen nicht über das hinaus lockern, was Berechtigungsregeln zulassen, und das `"deny"` eines Hooks gilt in jedem Berechtigungsmodus:

1023 

1024Das Gegenteil ist nicht wahr: Hooks in Einstellungsdateien und in der `hooks/hooks.json` eines Plugins können Einschränkungen verschärfen, aber nicht über das hinaus lockern, was Berechtigungsregeln zulassen. Ein Hook, der `"allow"` zurückgibt, umgeht nicht die deny-Regeln aus den Einstellungen, und er kann die Berechtigungsabfrage nicht unterdrücken für:

1025 1017 

1026* Lesezugriffe auf [Netzwerkpfade](/docs/de/permissions#network-paths)1018* **Was gegenüber `"allow"` weiterhin gilt**: Ein Hook, der `"allow"` zurückgibt, umgeht nicht die deny-Regeln aus den Einstellungen, und er kann die Berechtigungsabfrage nicht unterdrücken für:

1027* MCP-Tools, die als [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind1019 * Lesezugriffe auf [Netzwerkpfade](/docs/de/permissions#network-paths)

1028* Konnektor-Tools, die [Ihre Organisation auf `ask`](/docs/de/mcp#organization-controls-on-connector-tools) gesetzt hat, in Sitzungen, in denen diese Einstellung Claude Code erreicht1020 * MCP-Tools, die als [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind

1021 * Konnektor-Tools, die [Ihre Organisation auf `ask`](/docs/de/mcp#organization-controls-on-connector-tools) gesetzt hat, in Sitzungen, in denen diese Einstellung Claude Code erreicht

1029 1022 

1030Wenn Ihr `PreToolUse`-Hook im [Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode) für eine Dateibearbeitung `"allow"` zurückgibt, erhalten Sie dieselbe Abfrage, Blockierung oder Genehmigung, die die Bearbeitung ohne Hook erhalten würde. Um diese Beschränkung für Hook-Genehmigungen aufzuheben, [genehmigen Sie den Plan](/docs/de/permission-modes#review-and-approve-a-plan) oder wechseln Sie in einen anderen Berechtigungsmodus.1023Wenn Ihr `PreToolUse`-Hook im [Plan-Modus](/docs/de/permissions#hook-approvals-in-plan-mode) für eine Dateibearbeitung `"allow"` zurückgibt, erhalten Sie dieselbe Abfrage, Blockierung oder Genehmigung, die die Bearbeitung ohne Hook erhalten würde. Um diese Beschränkung für Hook-Genehmigungen aufzuheben, [genehmigen Sie den Plan](/docs/de/permission-modes#review-and-approve-a-plan) oder wechseln Sie in einen anderen Berechtigungsmodus.

1031 1024 

1025* **`"deny"` in jedem Berechtigungsmodus**: Ein Hook, der `permissionDecision: "deny"` zurückgibt, blockiert das Tool auch im `bypassPermissions`-Modus oder mit `--dangerously-skip-permissions`. `PreToolUse`-Hooks werden vor jeder Prüfung des Berechtigungsmodus in jedem [Berechtigungsmodus](/docs/de/permission-modes) ausgelöst, einschließlich `dontAsk`. Dies ermöglicht es Ihnen, eine Richtlinie durchzusetzen, die Benutzer nicht umgehen können, indem sie ihren Berechtigungsmodus ändern.

1026 

1032Ein [Mod](/docs/de/plugins/mods/overview), den Sie installieren und der `tool.check` verarbeitet, kann einen Aufruf genehmigen, den Ihr `PreToolUse`-Hook blockiert hat, es sei denn, der Hook befindet sich in verwalteten Einstellungen. Im Plan-Modus kann der Mod einen solchen Aufruf genehmigen, wenn er nur lesend ist, nicht jedoch eine Dateibearbeitung oder einen anderen Aufruf, der nicht nur lesend ist. [Erweitern Sie Berechtigungen mit Hooks](/docs/de/permissions#extend-permissions-with-hooks) listet auf, welche Regeln über einen Mod gelten.1027Ein [Mod](/docs/de/plugins/mods/overview), den Sie installieren und der `tool.check` verarbeitet, kann einen Aufruf genehmigen, den Ihr `PreToolUse`-Hook blockiert hat, es sei denn, der Hook befindet sich in verwalteten Einstellungen. Im Plan-Modus kann der Mod einen solchen Aufruf genehmigen, wenn er nur lesend ist, nicht jedoch eine Dateibearbeitung oder einen anderen Aufruf, der nicht nur lesend ist. [Erweitern Sie Berechtigungen mit Hooks](/docs/de/permissions#extend-permissions-with-hooks) listet auf, welche Regeln über einen Mod gelten.

1033 1028 

1034<h3 id="hook-not-firing">1029<h3 id="hook-not-firing">

Details

183 INSERT-Modus-Tastenkombinationen neu zuordnen183 INSERT-Modus-Tastenkombinationen neu zuordnen

184</h3>184</h3>

185 185 

186Die Einstellung [`vimInsertModeRemaps`](/docs/de/settings-reference#viminsertmoderemaps) ordnet eine zweitastige INSERT-Modus-Sequenz der Escape-Taste zu, sodass eine Zuordnung wie `jj` Sie in den NORMAL-Modus zurückbringt. Erfordert Claude Code v2.1.208 oder später.186Die Einstellung [`vimInsertModeRemaps`](/docs/de/settings-reference#viminsertmoderemaps) ordnet eine zweitastige INSERT-Modus-Sequenz der Escape-Taste zu, sodass eine Zuordnung wie `jj` Sie in den NORMAL-Modus zurückbringt.

187 187 

188Das folgende `~/.claude/settings.json`-Beispiel aktiviert den Vim-Modus und ordnet `jj` der Escape-Taste zu:188Das folgende `~/.claude/settings.json`-Beispiel aktiviert den Vim-Modus und ordnet `jj` der Escape-Taste zu:

189 189 


248| `cc` | Zeile ändern |248| `cc` | Zeile ändern |

249| `C` | Bis zum Ende der Zeile ändern |249| `C` | Bis zum Ende der Zeile ändern |

250| `cw`/`ce`/`cb` | Wort/bis zum Ende/zurück ändern |250| `cw`/`ce`/`cb` | Wort/bis zum Ende/zurück ändern |

251| `s` | Zeichen ersetzen: Löschen Sie das Zeichen unter dem Cursor und geben Sie den INSERT-Modus ein. Erfordert Claude Code v2.1.211 oder später |251| `s` | Zeichen ersetzen: Löschen Sie das Zeichen unter dem Cursor und geben Sie den INSERT-Modus ein |

252| `S` | Zeile ersetzen: Löschen Sie die Zeile und geben Sie den INSERT-Modus ein. Erfordert Claude Code v2.1.211 oder später |252| `S` | Zeile ersetzen: Löschen Sie die Zeile und geben Sie den INSERT-Modus ein |

253| `yy`/`Y` | Zeile yanken (kopieren) |253| `yy`/`Y` | Zeile yanken (kopieren) |

254| `yw`/`ye`/`yb` | Wort/bis zum Ende/zurück yanken |254| `yw`/`ye`/`yb` | Wort/bis zum Ende/zurück yanken |

255| `p` | Nach dem Cursor einfügen |255| `p` | Nach dem Cursor einfügen |


471* Nach dem ersten Zug eines Gesprächs in einigen Sitzungen471* Nach dem ersten Zug eines Gesprächs in einigen Sitzungen

472* Die vorherige Antwort endete mit einem Fehler472* Die vorherige Antwort endete mit einem Fehler

473* Während Sie sich im Plan Mode befinden473* Während Sie sich im Plan Mode befinden

474* Ihr Konto ist nahe an oder hat sein Nutzungslimit erreicht. Um Vorschläge bis zum Erreichen des Limits aktiviert zu halten, setzen Sie [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/de/env-vars) auf `true`. Vor v2.1.238 übersprangen Claude Code diese in der Nähe des Limits auch mit der auf `true` gesetzten Variablen474* Ihr Konto ist nahe an seinem Nutzungslimit oder hat es erreicht. Damit dieses Überspringen erst beim Erreichen des Limits greift, setzen Sie [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/de/env-vars) auf `true`. Vor v2.1.238 übersprang Claude Code Vorschläge in der Nähe des Limits auch mit der auf `true` gesetzten Variablen

475* In einem [Agent-Team](/docs/de/agent-teams), standardmäßig in den Sitzungen von Teamkollegen. Die Sitzung des Leiters zeigt Vorschläge475* In einem [Agent-Team](/docs/de/agent-teams), standardmäßig in den Sitzungen von Teamkollegen. Die Sitzung des Leiters zeigt Vorschläge

476 476 

477Der Hinweis `Showing fewer prompt suggestions · use one to bring them back` bedeutet, dass Claude Code Vorschläge seltener anzeigt, weil Sie viele nacheinander ungenutzt gelassen haben. Um zur üblichen Häufigkeit zurückzukehren, verwenden Sie einen Vorschlag oder setzen Sie [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/de/env-vars) auf `true`.477Der Hinweis `Showing fewer prompt suggestions · use one to bring them back` bedeutet, dass Claude Code Vorschläge seltener anzeigt, weil Sie viele nacheinander ungenutzt gelassen haben. Um zur üblichen Häufigkeit zurückzukehren, verwenden Sie einen Vorschlag oder setzen Sie [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/de/env-vars) auf `true`.


759 759 

760Ihre fünf neuesten früheren Nebenfragen werden als gedimmte Liste über der aktuellen Antwort angezeigt, mit einer Anzahl älterer. Sie bleiben außerhalb des Gesprächsverlaufs.760Ihre fünf neuesten früheren Nebenfragen werden als gedimmte Liste über der aktuellen Antwort angezeigt, mit einer Anzahl älterer. Sie bleiben außerhalb des Gesprächsverlaufs.

761 761 

762Um nach dem Schließen zum Overlay zurückzukehren, führen Sie `/btw` ohne Frage aus. Das Overlay öffnet sich erneut bei Ihrem letzten Austausch. Vor v2.1.212 gab `/btw` ohne Frage stattdessen eine Nutzungsmeldung aus.762Um nach dem Schließen zum Overlay zurückzukehren, führen Sie `/btw` ohne Frage aus. Das Overlay öffnet sich erneut bei Ihrem letzten Austausch.

763 763 

764Sobald die Antwort angezeigt wird, akzeptiert das Overlay diese Tasten.764Sobald die Antwort angezeigt wird, akzeptiert das Overlay diese Tasten.

765 765 

keybindings.md +3 −4

Details

462| `abovePrompt:highlightNext` | Unten | Nächste Option in einer fokussierten Auswahlliste hervorheben |462| `abovePrompt:highlightNext` | Unten | Nächste Option in einer fokussierten Auswahlliste hervorheben |

463| `abovePrompt:highlightPrevious` | Oben | Vorherige Option in einer fokussierten Auswahlliste hervorheben |463| `abovePrompt:highlightPrevious` | Oben | Vorherige Option in einer fokussierten Auswahlliste hervorheben |

464 464 

465Zwei Kontexte binden standardmäßig weitere Tasten an diese Aktionen:465Im [`AbovePrompt`-Kontext](#contexts) führen Rechts und Links standardmäßig auch `abovePrompt:next` und `abovePrompt:previous` aus, und die Leertaste führt auch `abovePrompt:press` aus.

466 

467* **`AbovePrompt`**: Rechts und Links führen auch `abovePrompt:next` und `abovePrompt:previous` aus, und die Leertaste führt auch `abovePrompt:press` aus

468* **`AbovePromptInput`**: Unten und Oben führen auch `abovePrompt:next` und `abovePrompt:previous` aus

469 466 

470Der `AbovePrompt`-Kontext bindet außerdem Oben, Unten, Bild-Auf, Bild-Ab, Pos1 und Ende an die [Pane-Scroll-Aktionen](#pane-actions) `pane:scrollUp` bis `pane:bottom`. Um eine dieser Tasten für das Band zu ändern, binden Sie daher die Scroll-Aktion in einem `AbovePrompt`-Block.467Der `AbovePrompt`-Kontext bindet außerdem Oben, Unten, Bild-Auf, Bild-Ab, Pos1 und Ende an die [Pane-Scroll-Aktionen](#pane-actions) `pane:scrollUp` bis `pane:bottom`. Um eine dieser Tasten für das Band zu ändern, binden Sie daher die Scroll-Aktion in einem `AbovePrompt`-Block.

471 468 


769* Im Vim-NORMAL-Modus zeigt `?` das Hilfemenü an (Vim-Verhalten)766* Im Vim-NORMAL-Modus zeigt `?` das Hilfemenü an (Vim-Verhalten)

770* Im Vim-NORMAL-Modus öffnet `/` die Verlaufssuche, dasselbe wie Ctrl+R im Standardmodus767* Im Vim-NORMAL-Modus öffnet `/` die Verlaufssuche, dasselbe wie Ctrl+R im Standardmodus

771 768 

769In 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.

770 

772<h2 id="validation">771<h2 id="validation">

773 Validierung772 Validierung

774</h2>773</h2>

mcp.md +37 −35

Details

324* Für einen Server im lokalen, Projekt- oder Benutzer-[Bereich](#mcp-installation-scopes) oder in verwalteter MCP-Konfiguration zeigt der Ursprung den Host wie in dieser Konfiguration geschrieben, daher wird eine `${VAR}`-Referenz im Host in der Meldung nicht erweitert.324* Für einen Server im lokalen, Projekt- oder Benutzer-[Bereich](#mcp-installation-scopes) oder in verwalteter MCP-Konfiguration zeigt der Ursprung den Host wie in dieser Konfiguration geschrieben, daher wird eine `${VAR}`-Referenz im Host in der Meldung nicht erweitert.

325* Bei einem Fehler ohne Status oder Fehlercode zeigt Claude Code den Fehlertext ohne den Ursprung.325* Bei einem Fehler ohne Status oder Fehlercode zeigt Claude Code den Fehlertext ohne den Ursprung.

326 326 

327Ein Remote-Server, dessen Konfiguration eine leere `url` hat, wird in `/mcp`, in `claude mcp list` und im [`/plugin`](/docs/de/plugins/install)-Manager als `not configured` angezeigt, und Claude Code versucht nicht, sich damit zu verbinden. Ein Plugin kann einen Platzhalter-Eintrag wie diesen für einen Connector enthalten, den Sie später konfigurieren, sodass Claude Code ihn nicht als Fehler oder Setup-Problem meldet. Die Detailansicht des Servers in `/mcp` zeigt `No URL configured for this server`; setzen Sie die `url` des Eintrags, um ihn zu verbinden. Vor v2.1.208 meldete Claude Code eine leere `url` als Konfigurationsproblem mit einer Aufforderung zum erneuten Verbinden.327Ein Remote-Server, dessen Konfiguration eine leere `url` hat, wird in `/mcp`, in `claude mcp list` und im [`/plugin`](/docs/de/plugins/install)-Manager als `not configured` angezeigt, und Claude Code versucht nicht, sich damit zu verbinden. Ein Plugin kann einen Platzhalter-Eintrag wie diesen für einen Connector enthalten, den Sie später konfigurieren, sodass Claude Code ihn nicht als Fehler oder Setup-Problem meldet. Die Detailansicht des Servers in `/mcp` zeigt `No URL configured for this server`; setzen Sie die `url` des Eintrags, um ihn zu verbinden.

328 328 

329<h4 id="configuration-warnings">329<h4 id="configuration-warnings">

330 Konfigurationswarnungen330 Konfigurationswarnungen


403* **In einer interaktiven Terminal-Sitzung** ruft Claude Code die aktualisierte Liste von diesem Server ab, sodass Sie ihn nicht erneut verbinden müssen.403* **In einer interaktiven Terminal-Sitzung** ruft Claude Code die aktualisierte Liste von diesem Server ab, sodass Sie ihn nicht erneut verbinden müssen.

404* **Im [nicht interaktiven Modus](/docs/de/headless) mit dem Flag `-p` und im [Agent SDK](/docs/de/agent-sdk/overview)** aktualisiert Claude Code bei diesen Benachrichtigungen nur die Tool-Liste.404* **Im [nicht interaktiven Modus](/docs/de/headless) mit dem Flag `-p` und im [Agent SDK](/docs/de/agent-sdk/overview)** aktualisiert Claude Code bei diesen Benachrichtigungen nur die Tool-Liste.

405 405 

406Wenn eine Aktualisierungsanfrage fehlschlägt, behält Claude Code die zuvor entdeckten Werkzeuge, Prompts und Ressourcen des Servers, bis eine spätere Aktualisierung erfolgreich ist. Vor v2.1.214 ersetzte ein vorübergehender Fehler während der Aktualisierung die Werkzeuge, Prompts und Ressourcen des Servers durch eine leere Liste.406Wenn eine Aktualisierungsanfrage fehlschlägt, behält Claude Code die zuvor entdeckten Werkzeuge, Prompts und Ressourcen des Servers, bis eine spätere Aktualisierung erfolgreich ist.

407 407 

408<h4 id="notification-streams-on-the-v2-runtime">408<h4 id="notification-streams-on-the-v2-runtime">

409 Benachrichtigungsströme auf der v2-Runtime409 Benachrichtigungsströme auf der v2-Runtime


502 Automatisches Backgrounding von langen Werkzeugaufrufen502 Automatisches Backgrounding von langen Werkzeugaufrufen

503</h3>503</h3>

504 504 

505Ein MCP-Werkzeugaufruf in der Hauptkonversation, der nach zwei Minuten noch läuft, wird zu einer Hintergrundaufgabe, statt die Sitzung zu blockieren. Claude erhält die Aufgaben-ID sofort und arbeitet weiter, und das Ergebnis kommt als Aufgabenbenachrichtigung, wenn der Aufruf abgeschlossen ist. Automatisches Backgrounding erfordert Claude Code v2.1.212 oder später.505Ein MCP-Werkzeugaufruf in der Hauptkonversation, der nach zwei Minuten noch läuft, wird zu einer Hintergrundaufgabe, statt die Sitzung zu blockieren. Claude erhält die Aufgaben-ID sofort und arbeitet weiter, und das Ergebnis kommt als Aufgabenbenachrichtigung, wenn der Aufruf abgeschlossen ist.

506 506 

507Die Aufgabe erscheint in [`/tasks`](/docs/de/commands#all-commands), wo Sie sie auch stoppen können, und sie überlebt das Beenden der Sitzung nicht. Der Eintrag der Aufgabe zeigt den neuesten Fortschritt, den der Server gemeldet hat. Wenn Sie die Aufgabe stoppen, bricht Claude Code den Aufruf ab und teilt Claude mit, dass kein Ergebnis kommt. Das Stoppen garantiert nicht, dass der Server stoppt: Er hat möglicherweise bereits einen Teil der Arbeit erledigt oder schließt sie trotzdem ab.507Die Aufgabe erscheint in [`/tasks`](/docs/de/commands#all-commands), wo Sie sie auch stoppen können, und sie überlebt das Beenden der Sitzung nicht. Der Eintrag der Aufgabe zeigt den neuesten Fortschritt, den der Server gemeldet hat. Wenn Sie die Aufgabe stoppen, bricht Claude Code den Aufruf ab und teilt Claude mit, dass kein Ergebnis kommt. Das Stoppen garantiert nicht, dass der Server stoppt: Er hat möglicherweise bereits einen Teil der Arbeit erledigt oder schließt sie trotzdem ab.

508 508 


1245 MCP-Server von claude.ai verwenden1245 MCP-Server von claude.ai verwenden

1246</h2>1246</h2>

1247 1247 

1248Wenn Sie sich bei Claude Code mit einem [claude.ai](https://claude.ai)-Konto angemeldet haben, sind MCP-Server, die Sie in claude.ai hinzugefügt haben, bekannt als [Connectors](https://claude.com/docs/connectors), automatisch in Claude Code verfügbar:1248Wenn Sie sich bei Claude Code mit einem [claude.ai](https://claude.ai)-Konto angemeldet haben, sind MCP-Server, die Sie in claude.ai hinzugefügt haben, bekannt als [Konnektoren](https://claude.com/docs/connectors), automatisch in Claude Code verfügbar:

1249 1249 

1250<Steps>1250<Steps>

1251 <Step title="MCP-Server in claude.ai konfigurieren">1251 <Step title="MCP-Server in claude.ai konfigurieren">

1252 Fügen Sie Server unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) hinzu. Bei Team- und Enterprise-Plänen können nur Administratoren Server hinzufügen.1252 Fügen Sie Server unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) hinzu. Bei Team- und Enterprise-Plänen können nur Admins Server hinzufügen.

1253 </Step>1253 </Step>

1254 1254 

1255 <Step title="MCP-Server authentifizieren">1255 <Step title="MCP-Server authentifizieren">


1267 </Step>1267 </Step>

1268</Steps>1268</Steps>

1269 1269 

1270Anthropic stellt auch einige Connectors selbst bereit, ohne dass Sie oder ein Administrator sie hinzufügen. Bei Konten, auf denen [Claude Docs](/docs/de/artifacts#write-a-document-with-claude-docs) verfügbar ist, listet `/mcp` `claude.ai Claude Docs` ohne Setup auf, und Claude verwendet es, wenn Sie um ein Dokument für andere Personen bitten. Um es auszuschalten, fügen Sie einen `serverName`-Eintrag von `"claude.ai Claude Docs"` zu `deniedMcpServers` hinzu oder verwenden Sie den `/mcp`-Umschalter, beide beschrieben in [claude.ai-Connectors deaktivieren](#disable-claude-ai-connectors).1270Anthropic stellt auch einige Konnektoren selbst bereit, ohne dass Sie oder ein Admin sie hinzufügen. Bei Konten, auf denen [Claude Docs](/docs/de/artifacts#write-a-document-with-claude-docs) verfügbar ist, listet `/mcp` `claude.ai Claude Docs` ohne Setup auf, und Claude verwendet es, wenn Sie um ein Dokument für andere Personen bitten. Um es auszuschalten, fügen Sie einen `serverName`-Eintrag von `"claude.ai Claude Docs"` zu `deniedMcpServers` hinzu oder verwenden Sie den `/mcp`-Umschalter, beide beschrieben in [claude.ai-Konnektoren deaktivieren](#disable-claude-ai-connectors).

1271 1271 

1272Claude Code markiert einen Connector als `managed` in `/mcp` und im [`/plugin`](/docs/de/plugins/install)-Manager, wenn Ihre Organisation dessen Authentifizierung in claude.ai verwaltet. Der Status „Managed“ ändert nicht, wie Claude Code sich mit dem Connector verbindet oder wie die [Tool-Kontrollen](#organization-controls-on-connector-tools) Ihrer Organisation angewendet werden.1272Claude Code markiert einen Konnektor als `managed` in `/mcp` und im [`/plugin`](/docs/de/plugins/install)-Manager, wenn Ihre Organisation dessen Authentifizierung in claude.ai verwaltet. Der Status „Managed“ ändert nicht, wie Claude Code sich mit dem Konnektor verbindet oder wie die [Tool-Kontrollen](#organization-controls-on-connector-tools) Ihrer Organisation angewendet werden.

1273 1273 

1274Connectors, bei denen Sie sich noch nie angemeldet haben, werden hinter einer Zeile `Show unused connectors` am Ende des claude.ai-Abschnitts ausgeblendet, damit eine von der Organisation bereitgestellte Liste das Panel nicht ausfüllt. Wählen Sie die Zeile aus, um sie zu erweitern. Ein Connector, bei dem Sie sich zuvor angemeldet haben, bleibt sichtbar, auch wenn er derzeit eine erneute Authentifizierung benötigt.1274Konnektoren, bei denen Sie sich noch nie angemeldet haben, werden hinter einer Zeile `Show unused connectors` am Ende des claude.ai-Abschnitts ausgeblendet, damit eine von der Organisation bereitgestellte Liste das Panel nicht ausfüllt. Wählen Sie die Zeile aus, um sie zu erweitern. Ein Konnektor, bei dem Sie sich zuvor angemeldet haben, bleibt sichtbar, auch wenn er derzeit eine erneute Authentifizierung benötigt.

1275 1275 

1276Connectors von claude.ai werden nur abgerufen, wenn Ihre aktive [Authentifizierungsmethode](/docs/de/authentication#authentication-precedence) ein claude.ai-Abonnement-Login ist. Sie werden nicht geladen, auch wenn Sie zuvor `/login` ausgeführt haben, wenn:1276Konnektoren von claude.ai werden nur abgerufen, wenn Ihre aktive [Authentifizierungsmethode](/docs/de/authentication#authentication-precedence) ein claude.ai-Abonnement-Login ist. Sie werden nicht geladen, auch wenn Sie zuvor `/login` ausgeführt haben, wenn:

1277 1277 

1278* `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` aktiv ist1278* `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` aktiv ist

1279* Ein Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform aktiv ist1279* Ein Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform aktiv ist

1280* `ANTHROPIC_PROFILE`, die Verbundfariablen oder ein aktives [Anthropic-Profil](/docs/de/authentication#anthropic-profiles-and-federation-credentials) die Anmeldedaten bereitstellt1280* `ANTHROPIC_PROFILE`, die Federation-Variablen oder ein aktives [Anthropic-Profil](/docs/de/authentication#anthropic-profiles-and-federation-credentials) die Anmeldedaten bereitstellt

1281* `CLAUDE_CODE_OAUTH_TOKEN` ein Token von [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) enthält, das nur Modellanfragen stellen kann1281* `CLAUDE_CODE_OAUTH_TOKEN` ein Token von [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) enthält, das nur Modellanfragen stellen kann

1282 1282 

1283Wenn `/mcp` einen Connector, den Sie hinzugefügt haben, nicht auflistet, führen Sie `/status` aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist. Heben Sie diese Umgebungsvariable auf, entfernen Sie die `apiKeyHelper`-Einstellung oder [schalten Sie das Profil aus](/docs/de/authentication#anthropic-profiles-and-federation-credentials), und führen Sie dann `/login` aus, um Ihr claude.ai-Konto auszuwählen.1283Wenn `/mcp` einen Konnektor, den Sie hinzugefügt haben, nicht auflistet, führen Sie `/status` aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist. Heben Sie diese Umgebungsvariable auf, entfernen Sie die `apiKeyHelper`-Einstellung oder [schalten Sie das Profil aus](/docs/de/authentication#anthropic-profiles-and-federation-credentials), und führen Sie dann `/login` aus, um Ihr claude.ai-Konto auszuwählen.

1284 1284 

1285Wenn ein temporäres Netzwerkproblem verhindert, dass die Connector-Liste beim Start Ihrer Sitzung geladen wird, versucht Claude Code den Abruf bis zu dreimal im Hintergrund erneut, und die Connectors werden angezeigt, sobald ein erneuter Versuch erfolgreich ist. Wenn sie immer noch nicht angezeigt werden, starten Sie Claude Code neu, um die Liste erneut abzurufen.1285Wenn ein temporäres Netzwerkproblem verhindert, dass die Konnektor-Liste beim Start Ihrer Sitzung geladen wird, versucht Claude Code den Abruf bis zu dreimal im Hintergrund erneut, und die Konnektoren werden angezeigt, sobald ein Wiederholungsversuch erfolgreich ist. Wenn sie immer noch nicht angezeigt werden, starten Sie Claude Code neu, um die Liste erneut abzurufen.

1286 1286 

1287Wenn `/mcp` einen Connector als `session token rejected` anzeigt oder seine Detailansicht [`claude.ai rejected the session token`](/docs/de/errors#claude-ai-rejected-the-session-token) anzeigt, hat claude.ai das Token aus Ihrem Claude Code-Login abgelehnt. Die erneute Autorisierung des Connectors löscht diesen Status nicht, da die eigene Autorisierung des Connectors in claude.ai nicht das ist, was abgelehnt wurde. Um dies zu beheben:1287Wenn `/mcp` einen Konnektor als `session token rejected` anzeigt oder seine Detailansicht [`claude.ai rejected the session token`](/docs/de/errors#claude-ai-rejected-the-session-token) anzeigt, hat claude.ai das Token aus Ihrem Claude Code-Login abgelehnt. Die erneute Autorisierung des Konnektors löscht diesen Status nicht, da die eigene Autorisierung des Konnektors in claude.ai nicht das ist, was abgelehnt wurde. Um dies zu beheben:

1288 1288 

12891. Führen Sie `/login` aus, um sich erneut anzumelden.12891. Führen Sie `/login` aus, um sich erneut anzumelden.

12902. Verbinden Sie den Connector erneut von `/mcp`.12902. Verbinden Sie den Konnektor erneut von `/mcp`.

1291 1291 

1292Vor v2.1.222 markierte Claude Code Connectors stattdessen als authentifizierungsbedürftig, und deren Autorisierung löste das Problem nicht.1292Vor v2.1.222 markierte Claude Code Konnektoren stattdessen als authentifizierungsbedürftig, und deren Autorisierung löste das Problem nicht.

1293 1293 

1294Ein Server, den Sie in Claude Code hinzugefügt haben, hat [Vorrang](#scope-hierarchy-and-precedence) vor einem claude.ai-Connector, der auf dieselbe URL verweist. In diesem Fall listet `/mcp` den Connector als verborgen auf und zeigt, wie Sie das Duplikat entfernen können, wenn Sie lieber den Connector verwenden möchten.1294Ein Server, den Sie in Claude Code hinzugefügt haben, hat [Vorrang](#scope-hierarchy-and-precedence) vor einem claude.ai-Konnektor, der auf dieselbe URL verweist. In diesem Fall listet `/mcp` den Konnektor als verborgen auf und zeigt, wie Sie das Duplikat entfernen können, wenn Sie lieber den Konnektor verwenden möchten.

1295 1295 

1296Einige von Anthropic gehostete Connectors wie Microsoft 365, Gmail und Google Calendar unterstützen kein lokales OAuth von Claude Code, da der vorgelagerte Identitätsanbieter nur die Umleitungs-URL akzeptiert, die claude.ai registriert hat. Wenn ein Server, den Sie mit `claude mcp add` oder in `.mcp.json` hinzugefügt haben, auf einen dieser Hosts verweist und Sie sich von `/mcp` oder mit `claude mcp login` darin anmelden, zeigt Claude Code [`is Anthropic-hosted and doesn't support local OAuth`](/docs/de/errors#anthropic-hosted-and-doesnt-support-local-oauth) an und leitet Sie stattdessen dazu, den Dienst unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) zu verbinden.1296Einige von Anthropic gehostete Konnektoren wie Microsoft 365, Gmail und Google Calendar unterstützen kein lokales OAuth von Claude Code, da der vorgelagerte Identitätsanbieter nur die Umleitungs-URL akzeptiert, die claude.ai registriert hat. Wenn ein Server, den Sie mit `claude mcp add` oder in `.mcp.json` hinzugefügt haben, auf einen dieser Hosts verweist und Sie sich von `/mcp` oder mit `claude mcp login` darin anmelden, zeigt Claude Code [`is Anthropic-hosted and doesn't support local OAuth`](/docs/de/errors#anthropic-hosted-and-doesnt-support-local-oauth) an und leitet Sie stattdessen dazu, den Dienst unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) zu verbinden.

1297 1297 

1298Nachdem Sie Ihren Eintrag mit `claude mcp remove <name>` entfernt und den Dienst auf claude.ai verbunden haben, wird der Connector automatisch in Claude Code angezeigt.1298Nachdem Sie Ihren Eintrag mit `claude mcp remove <name>` entfernt und den Dienst auf claude.ai verbunden haben, wird der Konnektor automatisch in Claude Code angezeigt.

1299 1299 

1300<h3 id="how-connectors-reach-claude-code">1300<h3 id="how-connectors-reach-claude-code">

1301 Wie Connectors Claude Code erreichen1301 Wie Konnektoren Claude Code erreichen

1302</h3>1302</h3>

1303 1303 

1304Welche Einstellungen einen claude.ai-Connector steuern, hängt davon ab, wo Ihre Sitzung ausgeführt wird, da nur einige Sitzungen Connectors selbst von claude.ai abrufen. Jede Zeile unten benennt, wie Connectors in einer Art von Sitzung ankommen und was sie dort steuert. Die [WSL-Sitzungen](/docs/de/desktop-wsl#what-works-in-a-wsl-session) der Desktop-App haben keine Zeile, da Connectors darin noch nicht verfügbar sind.1304Welche Einstellungen einen claude.ai-Konnektor steuern, hängt davon ab, wo Ihre Sitzung ausgeführt wird, da nur einige Sitzungen Konnektoren selbst von claude.ai abrufen. Jede Zeile unten benennt, wie Konnektoren in einer Art von Sitzung ankommen und was sie dort steuert. Die WSL-Sitzungen der Desktop-App haben keine Zeile, da Konnektoren [für sie noch schrittweise eingeführt werden](/docs/de/desktop-wsl#check-for-the-terminal-and-connectors).

1305 1305 

1306| Wo die Sitzung ausgeführt wird | Wie Connectors ankommen | Was steuert sie |1306| Wo die Sitzung ausgeführt wird | Wie Konnektoren ankommen | Was steuert sie |

1307| :- | :- | :- |1307| :- | :- | :- |

1308| Terminal-, [VS Code](/docs/de/vs-code)-, [JetBrains](/docs/de/jetbrains)- und [Agent SDK](/docs/de/agent-sdk/claude-code-features)-Sitzungen | Claude Code ruft sie von claude.ai ab | Die Einstellungen in diesem Abschnitt und [verwaltete MCP-Konfiguration](/docs/de/managed-mcp) |1308| Terminal-, [VS Code](/docs/de/vs-code)-, [JetBrains](/docs/de/jetbrains)- und [Agent SDK](/docs/de/agent-sdk/claude-code-features)-Sitzungen | Claude Code ruft sie von claude.ai ab | Die Einstellungen in diesem Abschnitt und [verwaltete MCP-Konfiguration](/docs/de/managed-mcp) |

1309| [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) | Der Remote-Host übergibt sie | Ihre claude.ai-Organisationseinstellungen plus die [Allowlist- und Denylist](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists)-Einstellungen, die die Sitzung erreichen, und alle `managed-mcp.json` auf dem Host, der sie ausführt |1309| [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) | Der Cloud-Host übergibt sie | Ihre claude.ai-Organisationseinstellungen plus die [Allowlist- und Denylist](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists)-Einstellungen, die die Sitzung erreichen, und alle `managed-mcp.json` auf dem Host, der sie ausführt |

1310| Die [lokalen und SSH-Sitzungen](/docs/de/desktop) der Desktop-App | Die Desktop-App liefert sie prozessintern | `blocked`-Einträge in den [Tool-Kontrollen](#organization-controls-on-connector-tools) Ihrer Organisation für Connectors |1310| Die lokalen und SSH-Sitzungen der [Desktop-App](/docs/de/desktop) | Die Desktop-App liefert sie prozessintern | `blocked`-Einträge in den [Tool-Kontrollen für Konnektoren](#organization-controls-on-connector-tools) Ihrer Organisation |

1311 1311 

1312[`disableClaudeAiConnectors`](#disable-claude-ai-connectors), `ENABLE_CLAUDEAI_MCP_SERVERS` und [`allowAllClaudeAiMcps`](/docs/de/settings-reference#allowallclaudeaimcps) wirken sich nur auf die erste Zeile aus, die Connectors, die Claude Code selbst abruft. Die anderen beiden Zeilen unterscheiden sich davon auf diese Weise:1312[`disableClaudeAiConnectors`](#disable-claude-ai-connectors), `ENABLE_CLAUDEAI_MCP_SERVERS` und [`allowAllClaudeAiMcps`](/docs/de/settings-reference#allowallclaudeaimcps) wirken sich nur auf die erste Zeile aus, die Konnektoren, die Claude Code selbst abruft. Die anderen beiden Zeilen unterscheiden sich davon auf diese Weise:

1313 1313 

1314* **Cloud-Sitzungen**: `allowedMcpServers`- und `deniedMcpServers`-Einträge, die die Sitzung erreichen, beispielsweise durch [Server-verwaltete Einstellungen](/docs/de/server-managed-settings), filtern auch die bereitgestellten Connectors. Der Proxy der Sitzung schreibt die URL jedes Connectors um, daher passt ein `serverUrl`-Muster, das für die eigene URL des Connectors geschrieben wurde, nicht dazu. Um bereitgestellte Connectors neben einer URL-Allowlist in einer selbstgehosteten Umgebung zuzulassen, fügen Sie die `serverUrl`-Einträge hinzu, die unter [Connector-Datenverkehr verlässt Ihr Netzwerk](/docs/de/self-hosted-environments-deploy#connector-traffic-leaves-your-network) aufgelistet sind. Claude Code verwirft die bereitgestellten Connectors, wenn eine `managed-mcp.json` auf dem Host vorhanden ist, der die Sitzung ausführt, z. B. ein [selbstgehosteter Runner-Host](/docs/de/self-hosted-environments-configuration#mcp-servers), unabhängig davon, ob Sie `allowAllClaudeAiMcps` setzen.1314* **Cloud-Sitzungen**: `allowedMcpServers`- und `deniedMcpServers`-Einträge, die die Sitzung erreichen, beispielsweise durch [Server-verwaltete Einstellungen](/docs/de/server-managed-settings), filtern auch die bereitgestellten Konnektoren. Der Proxy der Sitzung schreibt die URL jedes Konnektors um, daher passt ein `serverUrl`-Muster, das für die eigene URL des Konnektors geschrieben wurde, nicht dazu. Um bereitgestellte Konnektoren neben einer URL-Allowlist in einer selbstgehosteten Umgebung zuzulassen, fügen Sie die `serverUrl`-Einträge hinzu, die unter [Konnektor-Datenverkehr verlässt Ihr Netzwerk](/docs/de/self-hosted-environments-deploy#connector-traffic-leaves-your-network) aufgelistet sind. Claude Code verwirft die bereitgestellten Konnektoren, wenn eine `managed-mcp.json` auf dem Host vorhanden ist, der die Sitzung ausführt, z. B. ein [selbstgehosteter Runner-Host](/docs/de/self-hosted-environments-configuration#mcp-servers), unabhängig davon, ob Sie `allowAllClaudeAiMcps` setzen.

1315* **Desktop-App lokale und SSH-Sitzungen**: Die Desktop-App registriert die Connectors als prozessinterne `type: "sdk"`-Server, und keine MCP-Einstellung oder `managed-mcp.json` erreicht sie. Ein Benutzer hält einen Connector aus seinen eigenen Sitzungen heraus, indem er ihn unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) trennt. Eine Organisation blockiert die [Tools](#organization-controls-on-connector-tools) eines Connectors oder schaltet [Claude Code in der Desktop-App](/docs/de/desktop#admin-console-controls) ganz aus.1315* **Lokale und SSH-Sitzungen der Desktop-App**: Die Desktop-App registriert die Konnektoren als prozessinterne `type: "sdk"`-Server, und keine MCP-Einstellung oder `managed-mcp.json` erreicht sie. Ein Benutzer hält einen Konnektor aus seinen eigenen Sitzungen heraus, indem er ihn unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors) trennt. Eine Organisation blockiert die [Tools](#organization-controls-on-connector-tools) eines Konnektors oder schaltet [Claude Code in der Desktop-App](/docs/de/desktop#admin-console-controls) ganz aus.

1316 1316 

1317<h3 id="organization-controls-on-connector-tools">1317<h3 id="organization-controls-on-connector-tools">

1318 Organisationskontrollen für Connector-Tools1318 Organisationskontrollen für Konnektor-Tools

1319</h3>1319</h3>

1320 1320 

1321Ihre Organisation kann Pro-Tool-Kontrollen auf [claude.ai-Connectors](https://claude.com/docs/connectors) setzen. Claude Code liest diese Einstellungen beim Start und erzwingt sie lokal, außer in den [lokalen und SSH-Sitzungen](#how-connectors-reach-claude-code) der Desktop-App. Dort hält die Desktop-App `blocked`-Tools zurück, bevor sie einen Connector liefert, und die `ask`-Einstellung erreicht Claude Code nicht, daher wendet es die gewöhnlichen [Berechtigungsregeln](/docs/de/permissions) der Sitzung auf diese Tools an, anstatt bei jedem Aufruf zu fragen. In Sitzungen, in denen Claude Code Connectors selbst abruft, führen Sie `/mcp` aus, um zu sehen, welche Einstellung für jedes Tool auf einem Connector gilt.1321Ihre Organisation kann Pro-Tool-Kontrollen auf [claude.ai-Konnektoren](https://claude.com/docs/connectors) setzen. Claude Code liest diese Einstellungen beim Start und erzwingt sie lokal, außer in den [lokalen und SSH-Sitzungen](#how-connectors-reach-claude-code) der Desktop-App. Dort hält die Desktop-App `blocked`-Tools zurück, bevor sie einen Konnektor liefert, und die `ask`-Einstellung erreicht Claude Code nicht, daher wendet es die gewöhnlichen [Berechtigungsregeln](/docs/de/permissions) der Sitzung auf diese Tools an, anstatt bei jedem Aufruf nachzufragen. In Sitzungen, in denen Claude Code Konnektoren selbst abruft, führen Sie `/mcp` aus, um zu sehen, welche Einstellung für jedes Tool auf einem Konnektor gilt.

1322 1322 

1323* **Tool auf `ask` gesetzt**: Claude Code fragt bei jedem Aufruf mit dem Grund `Your organization requires approval for this tool` nach. Die Aufforderung wird auch in `acceptEdits`-, `auto`- und `bypassPermissions`-[Berechtigungsmodi](/docs/de/permissions#permission-modes) angezeigt und bietet niemals eine Option, Ihre Wahl zu merken. [Allow-Regeln](/docs/de/permissions), die das Tool abgleichen, überspringen die Aufforderung auch nicht. Im `dontAsk`-Modus, der niemals fragt, lehnt Claude Code den Aufruf stattdessen ab.1323* **Tool auf `ask` gesetzt**: Claude Code fragt bei jedem Aufruf mit dem Grund `Your organization requires approval for this tool` nach. Die Berechtigungsabfrage wird auch in den [Berechtigungsmodi](/docs/de/permissions#permission-modes) `acceptEdits`, `auto` und `bypassPermissions` angezeigt und bietet niemals eine Option, Ihre Wahl zu merken. [allow-Regeln](/docs/de/permissions), die auf das Tool zutreffen, überspringen die Berechtigungsabfrage auch nicht. Im `dontAsk`-Modus, der niemals nachfragt, lehnt Claude Code den Aufruf stattdessen ab.

1324* **Tool auf `blocked` gesetzt**: Claude Code filtert das Tool heraus, bevor Claude es sieht, daher wird es nie in der Tool-Liste angezeigt. In Sitzungen, in denen Claude Code Connectors selbst abruft, zeigt die `/mcp`-Tool-Liste das Tool immer noch an, markiert als `disabled by your organization`. Die Desktop-App und der claude.ai-Chat wenden die gleiche `blocked`-Einstellung an, daher kann Claude das Tool dort auch nicht verwenden, und Sie können ein Tool nicht von den Sitzungen der Desktop-App fernhalten, während Sie es im Chat verfügbar halten. Die Desktop-App überspringt einen Connector, dessen Tools alle blockiert sind.1324* **Tool auf `blocked` gesetzt**: Claude Code filtert das Tool heraus, bevor Claude es sieht, daher wird es nie in Claudes Tool-Liste angezeigt. In Sitzungen, in denen Claude Code Konnektoren selbst abruft, zeigt die `/mcp`-Tool-Liste das Tool immer noch an, markiert als `disabled by your organization`.

1325 

1326Die Desktop-App und der claude.ai-Chat wenden die gleiche `blocked`-Einstellung an, daher kann Claude ein blockiertes Tool dort auch nicht verwenden, und Sie können ein Tool nicht von den Sitzungen der Desktop-App fernhalten, während Sie es im Chat verfügbar halten. Die Desktop-App überspringt einen Konnektor, dessen Tools alle blockiert sind.

1325 1327 

1326<h3 id="disable-claude-ai-connectors">1328<h3 id="disable-claude-ai-connectors">

1327 claude.ai-Connectors deaktivieren1329 claude.ai-Konnektoren deaktivieren

1328</h3>1330</h3>

1329 1331 

1330Claude Code wendet [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) nur auf die Connectors an, die es [selbst abruft](#how-connectors-reach-claude-code), nicht auf die Connectors, die ein Cloud-Host oder die Desktop-App liefert. Um die Connectors auszuschalten, die es abruft, setzen Sie die Einstellung auf `true` in einem beliebigen Einstellungsbereich:1332Claude Code wendet [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) nur auf die Konnektoren an, die es [selbst abruft](#how-connectors-reach-claude-code), nicht auf die Konnektoren, die ein Cloud-Host oder die Desktop-App liefert. Um die Konnektoren auszuschalten, die es abruft, setzen Sie die Einstellung in einem beliebigen Geltungsbereich auf `true`:

1331 1333 

1332```json theme={null}1334```json theme={null}

1333{1335{


1335}1337}

1336```1338```

1337 1339 

1338Diese Einstellung verwendet Any-Source-True-Semantik: `true` in einer beliebigen Einstellungsquelle hat Vorrang. Eine eingecheckte Projekt-`.claude/settings.json` kann ein Repository von den Connectors abmelden, die Claude Code selbst abruft, aber ein Projekt-Level-`false` kann Connectors nicht erneut aktivieren, die ein Benutzer- oder Policy-Level-`true` deaktiviert hat. Server, die explizit über `--mcp-config` übergeben werden, sind nicht betroffen.1340Diese Einstellung verwendet Any-Source-True-Semantik: `true` in einer beliebigen Einstellungsquelle hat Vorrang. Eine eingecheckte Projekt-`.claude/settings.json` kann ein Repository von den Konnektoren abmelden, die Claude Code selbst abruft, aber ein `false` auf Projektebene kann Konnektoren nicht erneut aktivieren, die ein `true` auf Benutzer- oder Richtlinienebene deaktiviert hat. Server, die explizit über `--mcp-config` übergeben werden, sind nicht betroffen.

1339 1341 

1340Sie können auch die Umgebungsvariable `ENABLE_CLAUDEAI_MCP_SERVERS` auf `false` setzen, was den gleichen Effekt für die aktuelle Shell-Sitzung hat:1342Sie können auch die Umgebungsvariable `ENABLE_CLAUDEAI_MCP_SERVERS` auf `false` setzen, was den gleichen Effekt für die aktuelle Shell-Sitzung hat:

1341 1343 


1343ENABLE_CLAUDEAI_MCP_SERVERS=false claude1345ENABLE_CLAUDEAI_MCP_SERVERS=false claude

1344```1346```

1345 1347 

1346Um einzelne claude.ai-Connectors zu blockieren, anstatt alle zu blockieren, fügen Sie sie nach Name oder nach URL-Muster zu [`deniedMcpServers`](/docs/de/managed-mcp) hinzu. Beispielsweise blockiert ein `serverName`-Eintrag von `"claude.ai Slack"` den Slack-Connector. Sie können auch `/mcp` ausführen, um einen beliebigen Connector, den Claude Code abruft, für das aktuelle Projekt nur ein- oder auszuschalten.1348Um einzelne claude.ai-Konnektoren zu blockieren, anstatt alle zu blockieren, fügen Sie sie nach Name oder nach URL-Muster zu [`deniedMcpServers`](/docs/de/managed-mcp) hinzu. Beispielsweise blockiert ein `serverName`-Eintrag von `"claude.ai Slack"` den Slack-Konnektor. Sie können auch `/mcp` ausführen, um einen beliebigen Konnektor, den Claude Code abruft, nur für das aktuelle Projekt ein- oder auszuschalten.

1347 1349 

1348<h2 id="use-claude-code-as-an-mcp-server">1350<h2 id="use-claude-code-as-an-mcp-server">

1349 Claude Code als MCP-Server verwenden1351 Claude Code als MCP-Server verwenden


1529 1531 

1530Einige Oberflächen, wie [Remote Control](/docs/de/remote-control) und Anwendungen, die auf dem [Agent SDK](/docs/de/agent-sdk/overview) basieren, ermöglichen es Ihnen normalerweise, Tool-Aufrufe mit einem Tippen zu genehmigen. Für ein Tool, das mit dieser Annotation gekennzeichnet ist, hält Claude Code die Aktion mit einem Tippen zurück und zeigt stattdessen die vollständige Berechtigungsabfrage des Tools an. So stammt die Genehmigung weiterhin von einer Person, die die Abfrage beantwortet, und nicht von einem bloßen Tippen.1532Einige Oberflächen, wie [Remote Control](/docs/de/remote-control) und Anwendungen, die auf dem [Agent SDK](/docs/de/agent-sdk/overview) basieren, ermöglichen es Ihnen normalerweise, Tool-Aufrufe mit einem Tippen zu genehmigen. Für ein Tool, das mit dieser Annotation gekennzeichnet ist, hält Claude Code die Aktion mit einem Tippen zurück und zeigt stattdessen die vollständige Berechtigungsabfrage des Tools an. So stammt die Genehmigung weiterhin von einer Person, die die Abfrage beantwortet, und nicht von einem bloßen Tippen.

1531 1533 

1532Claude Code hält die Genehmigung mit einem Tippen auf die gleiche Weise für jede Berechtigungsanfrage zurück, die nur der Terminal-Dialog vollständig darstellen kann, z. B. eine Anfrage mit einer Sicherheitswarnung oder einer Option „Immer zulassen“, die die Remote-Oberfläche nicht anzeigen kann. Sie beantworten diese Anfrage im Terminal-Dialog statt über Remote Control. Erfordert Claude Code v2.1.214 oder später.1534Claude Code hält die Genehmigung mit einem Tippen auf die gleiche Weise für jede Berechtigungsanfrage zurück, die nur der Terminal-Dialog vollständig darstellen kann, z. B. eine Anfrage mit einer Sicherheitswarnung oder einer Option „Immer zulassen“, die die Remote-Oberfläche nicht anzeigen kann. Sie beantworten diese Anfrage im Terminal-Dialog statt über Remote Control.

1533 1535 

1534<h2 id="respond-to-mcp-elicitation-requests">1536<h2 id="respond-to-mcp-elicitation-requests">

1535 Auf MCP-Elicitierungsanfragen reagieren1537 Auf MCP-Elicitierungsanfragen reagieren

memory.md +2 −2

Details

521* Copilot-Regeln in `.github/copilot-instructions.md`521* Copilot-Regeln in `.github/copilot-instructions.md`

522* Mit `CLAUDE_CODE_NEW_INIT=1` gesetzt: `AGENTS.md`, `.devin/rules/`, `.windsurf/rules/` oder `.windsurfrules`, und `.clinerules`522* Mit `CLAUDE_CODE_NEW_INIT=1` gesetzt: `AGENTS.md`, `.devin/rules/`, `.windsurf/rules/` oder `.windsurfrules`, und `.clinerules`

523 523 

524Sie können auch [`/import`](/docs/de/commands) ausführen, um die Konfiguration eines unterstützten Codierungs-Agenten in Claude Code zu bringen, was eine einmalige Kopie von Anweisungsdateien wie `AGENTS.md` an die entsprechende `CLAUDE.md` anhängt und MCP-Server, Befehle, Subagenten und Skills überträgt. Erfordert Claude Code v2.1.213 oder später.524Sie können auch [`/import`](/docs/de/commands) ausführen, um die Konfiguration eines unterstützten Codierungs-Agenten in Claude Code zu bringen, was eine einmalige Kopie von Anweisungsdateien wie `AGENTS.md` an die entsprechende `CLAUDE.md` anhängt und MCP-Server, Befehle, Subagenten und Skills überträgt.

525 525 

526<h2 id="auto-memory">526<h2 id="auto-memory">

527 Auto-Memory527 Auto-Memory


615 615 

616Claude liest und schreibt Memory-Dateien während Ihrer Sitzung. Wenn Sie Meldungen wie „Saved 2 memories“ oder „Recalled 2 memories“ in der Claude Code-Schnittstelle sehen, aktualisiert oder liest Claude aktiv aus `~/.claude/projects/<project>/memory/`.616Claude liest und schreibt Memory-Dateien während Ihrer Sitzung. Wenn Sie Meldungen wie „Saved 2 memories“ oder „Recalled 2 memories“ in der Claude Code-Schnittstelle sehen, aktualisiert oder liest Claude aktiv aus `~/.claude/projects/<project>/memory/`.

617 617 

618Wenn Claude eine Memory-Datei schreibt, die mit YAML-Frontmatter beginnt, speichert Claude Code die Schreibzeit in einem `modified`-Frontmatter-Feld als ISO-8601-Zeitstempel. Der Zeitstempel zeigt, wie aktuell die Tatsache ist, sowohl für Sie als auch für Claude, wenn es das Memory zurückliest. Jede Datei, die Frontmatter hat, erhält das Feld beim nächsten Schreiben durch Claude, einschließlich Dateien, die in früheren Versionen erstellt wurden; Claude Code fügt niemals Frontmatter zu einer Datei hinzu, die keine hat. Das `modified`-Feld erfordert Claude Code v2.1.214 oder später.618Wenn Claude eine Memory-Datei schreibt, die mit YAML-Frontmatter beginnt, speichert Claude Code die Schreibzeit in einem `modified`-Frontmatter-Feld als ISO-8601-Zeitstempel. Der Zeitstempel zeigt, wie aktuell die Tatsache ist, sowohl für Sie als auch für Claude, wenn es das Memory zurückliest.

619 619 

620<h3 id="audit-and-edit-your-memory">620<h3 id="audit-and-edit-your-memory">

621 Überprüfen und bearbeiten Sie Ihr Memory621 Überprüfen und bearbeiten Sie Ihr Memory

model-config.md +2 −1

Details

274* **Skill- oder Befehlsüberschreibung**: Claude Code ignoriert die Überschreibung, einschließlich eines blockierten Familien-Alias, und der Skill oder Befehl wird auf dem Sitzungsmodell ausgeführt. Ein Skill oder Befehl, der [in einem Subagent ausgeführt wird](/docs/de/skills#run-skills-in-a-subagent), folgt stattdessen dem Subagent-Verhalten oben274* **Skill- oder Befehlsüberschreibung**: Claude Code ignoriert die Überschreibung, einschließlich eines blockierten Familien-Alias, und der Skill oder Befehl wird auf dem Sitzungsmodell ausgeführt. Ein Skill oder Befehl, der [in einem Subagent ausgeführt wird](/docs/de/skills#run-skills-in-a-subagent), folgt stattdessen dem Subagent-Verhalten oben

275* **Einstellung `advisorModel`**: der Advisor ist für die Sitzung deaktiviert275* **Einstellung `advisorModel`**: der Advisor ist für die Sitzung deaktiviert

276* **Flag `--advisor`**: Claude Code beendet sich beim Start mit einem Fehler. In einer [Hintergrund-Sitzung](/docs/de/agent-view) startet es die Sitzung ohne den Advisor, anstatt sich zu beenden276* **Flag `--advisor`**: Claude Code beendet sich beim Start mit einem Fehler. In einer [Hintergrund-Sitzung](/docs/de/agent-view) startet es die Sitzung ohne den Advisor, anstatt sich zu beenden

277* **`CLAUDE_CODE_AUTO_MODE_MODEL`**: Claude Code ignoriert die Variable und wählt das Modell für seine [Klassifikator-Anfragen im Auto-Modus](/docs/de/permission-modes#default-classifier-model) so, als hätten Sie sie nicht gesetzt

277 278 

278Claude Code verbirgt ausgeschlossene Modelle in der Auswahl `/model`. Ob eine von Ihnen aufgeführte Modell-ID auch eine eigene Zeile erhält, hängt vom Provider ab:279Claude Code verbirgt ausgeschlossene Modelle in der Auswahl `/model`. Ob eine von Ihnen aufgeführte Modell-ID auch eine eigene Zeile erhält, hängt vom Provider ab:

279 280 


285* **[Fallback-Modellketten](#fallback-model-chains)**: Einträge außerhalb der Allowlist werden gelöscht286* **[Fallback-Modellketten](#fallback-model-chains)**: Einträge außerhalb der Allowlist werden gelöscht

286* **Plan-Modus-Upgrades**: Auf der Anthropic API und Claude Platform on AWS verwendet ein Upgrade wie [`opusplan`](#opusplan-model-setting) zu einem ausgeschlossenen Modell die neueste zulässige Version der Upgrade-Familie. Bei Providern mit Provider-spezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung wird auf dem Sitzungsmodell fortgesetzt287* **Plan-Modus-Upgrades**: Auf der Anthropic API und Claude Platform on AWS verwendet ein Upgrade wie [`opusplan`](#opusplan-model-setting) zu einem ausgeschlossenen Modell die neueste zulässige Version der Upgrade-Familie. Bei Providern mit Provider-spezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung wird auf dem Sitzungsmodell fortgesetzt

287* **[Automatischer Modell-Fallback](#automatic-model-fallback)**: Ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, sodass die gekennzeichnete Anfrage mit einer Ablehnung endet288* **[Automatischer Modell-Fallback](#automatic-model-fallback)**: Ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, sodass die gekennzeichnete Anfrage mit einer Ablehnung endet

288* **[Auto-Modus-Klassifikator](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)**: der Standard Claude Sonnet 5 des Klassifikators gilt nur, wenn die Allowlist Sonnet 5 zulässt. Wenn es ausgeschlossen ist, wird der Klassifikator auf dem Sitzungsmodell ausgeführt, das die Allowlist bereits regelt, oder auf einem Opus-Modell, wenn die Sitzung auf einem [Fable-Modell](#work-with-fable) läuft. Bei Providern außer der Anthropic API wird dieser Opus-Fallback auf dem Modell ausgeführt, das Sie in `ANTHROPIC_DEFAULT_OPUS_MODEL` festlegen, andernfalls auf Opus 5, ohne die Allowlist zu konsultieren. Erfordert Claude Code v2.1.210 oder später289* **[Auto-Modus-Klassifikator](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)**: Wenn die Allowlist das [Standardmodell des Klassifikators](/docs/de/permission-modes#default-classifier-model) ausschließt, werden Klassifikator-Anfragen, die dieses Modell verwenden würden, auf dem Sitzungsmodell ausgeführt, oder in [Fable](#work-with-fable)-Sitzungen auf einem Opus-Modell. Bei Providern außer der Anthropic API wird dieser Opus-Fallback auf dem Modell ausgeführt, das Sie in `ANTHROPIC_DEFAULT_OPUS_MODEL` festlegen, andernfalls auf Opus 5, ohne die Allowlist zu konsultieren. Erfordert Claude Code v2.1.210 oder später

289* **[Schnellmodus](/docs/de/fast-mode)**: Das Aktivieren des Schnellmodus wird abgelehnt, wenn das Modell, auf dem die Sitzung danach läuft, außerhalb der Allowlist liegt290* **[Schnellmodus](/docs/de/fast-mode)**: Das Aktivieren des Schnellmodus wird abgelehnt, wenn das Modell, auf dem die Sitzung danach läuft, außerhalb der Allowlist liegt

290* **Verfügbarkeits-Fallback auf Amazon Bedrock und Google Cloud's Agent Platform**: Wenn Ihr Konto während einer Sitzung den Zugriff auf ein Modell verliert, überspringt der Wechsel zu einem anderen Modell ausgeschlossene Modelle. Die Modellprüfungen beim Start auf [Amazon Bedrock](/docs/de/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) und [Google Cloud's Agent Platform](/docs/de/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) überspringen ausgeschlossene Modelle nur, wenn die verwalteten Einstellungen zusätzlich [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) setzen291* **Verfügbarkeits-Fallback auf Amazon Bedrock und Google Cloud's Agent Platform**: Wenn Ihr Konto während einer Sitzung den Zugriff auf ein Modell verliert, überspringt der Wechsel zu einem anderen Modell ausgeschlossene Modelle. Die Modellprüfungen beim Start auf [Amazon Bedrock](/docs/de/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) und [Google Cloud's Agent Platform](/docs/de/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) überspringen ausgeschlossene Modelle nur, wenn die verwalteten Einstellungen zusätzlich [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) setzen

291 292 

Details

137| `OTEL_LOG_TOOL_CONTENT` | Aktiviert Protokollierung von Tool-Inhalten im [`tool.output` Span-Ereignis](#tool-output-span-event) (Standard: deaktiviert). Span-Attribute tragen Tool-Inhalte unter [ihren eigenen Gates](#new-context-gates). Erfordert [Tracing](#traces-beta). Inhalte werden auf das Inhaltslimit gekürzt (Standard 60 KB) | `1` zum Aktivieren |137| `OTEL_LOG_TOOL_CONTENT` | Aktiviert Protokollierung von Tool-Inhalten im [`tool.output` Span-Ereignis](#tool-output-span-event) (Standard: deaktiviert). Span-Attribute tragen Tool-Inhalte unter [ihren eigenen Gates](#new-context-gates). Erfordert [Tracing](#traces-beta). Inhalte werden auf das Inhaltslimit gekürzt (Standard 60 KB) | `1` zum Aktivieren |

138| `OTEL_LOG_MANAGED_SETTINGS` | Fügt die redigierten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor Redaktion zu [verwaltete Einstellungen aufgelöst](#managed-settings-resolved-event)-Ereignissen hinzu (Standard: deaktiviert). Ein Wert in Projekt- oder lokalen Einstellungen schaltet dies nicht ein. Erfordert Claude Code v2.1.274 oder später | `1` zum Aktivieren |138| `OTEL_LOG_MANAGED_SETTINGS` | Fügt die redigierten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor Redaktion zu [verwaltete Einstellungen aufgelöst](#managed-settings-resolved-event)-Ereignissen hinzu (Standard: deaktiviert). Ein Wert in Projekt- oder lokalen Einstellungen schaltet dies nicht ein. Erfordert Claude Code v2.1.274 oder später | `1` zum Aktivieren |

139| `OTEL_LOG_RAW_API_BODIES` | Gibt den vollständigen Anthropic Messages API-Request und Response JSON als `api_request_body` / `api_response_body` Log-Ereignisse aus (Standard: deaktiviert). Bodies enthalten die gesamte Konversationshistorie. Das Aktivieren impliziert Zustimmung zu allem, was `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` und `OTEL_LOG_TOOL_CONTENT` offenbaren würden | `1` für Inline-Bodies gekürzt auf das Inhaltslimit (Standard 60 KB), oder `file:<dir>` für ungekürzte Bodies auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |139| `OTEL_LOG_RAW_API_BODIES` | Gibt den vollständigen Anthropic Messages API-Request und Response JSON als `api_request_body` / `api_response_body` Log-Ereignisse aus (Standard: deaktiviert). Bodies enthalten die gesamte Konversationshistorie. Das Aktivieren impliziert Zustimmung zu allem, was `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` und `OTEL_LOG_TOOL_CONTENT` offenbaren würden | `1` für Inline-Bodies gekürzt auf das Inhaltslimit (Standard 60 KB), oder `file:<dir>` für ungekürzte Bodies auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |

140| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Inhaltslimit: die maximale Länge von inhaltstragenden Attributen wie Modellresponses, Tool-Inhalten, Systemprompts und Raw API Bodies, Kürzungsmarker eingeschlossen, in UTF-16-Codeeinheiten (Standard: 61440, d.h. 60 KB). Der Standard ist für Backends ausgelegt, die Attributwerte auf 64 KB begrenzen; erhöhen Sie ihn nur, wenn Ihr Backend größere Werte akzeptiert, oder senken Sie ihn, um das Telemetrievolumen zu reduzieren. Wenn ein OpenTelemetry SDK-Attributlimit, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` oder eine seiner Logrecord- und Span-Varianten, auf einen niedrigeren Wert gesetzt ist, kürzt Claude Code auf diesen kleineren Wert, damit der `[TRUNCATED ...]`-Marker innerhalb des SDK-Limits bleibt. Erfordert Claude Code v2.1.214 oder später | `262144` |140| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Inhaltslimit: die maximale Länge von inhaltstragenden Attributen wie Modellresponses, Tool-Inhalten, Systemprompts und Raw API Bodies, Kürzungsmarker eingeschlossen, in UTF-16-Codeeinheiten (Standard: 61440, d.h. 60 KB). Der Standard ist für Backends ausgelegt, die Attributwerte auf 64 KB begrenzen; erhöhen Sie ihn nur, wenn Ihr Backend größere Werte akzeptiert, oder senken Sie ihn, um das Telemetrievolumen zu reduzieren. Wenn ein OpenTelemetry SDK-Attributlimit, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` oder eine seiner Logrecord- und Span-Varianten, auf einen niedrigeren Wert gesetzt ist, kürzt Claude Code auf diesen kleineren Wert, damit der `[TRUNCATED ...]`-Marker innerhalb des SDK-Limits bleibt | `262144` |

141| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Metriken-Temporalitätspräferenz (Standard: `delta`). Setzen Sie auf `cumulative`, wenn Ihr Backend kumulative Temporalität erwartet | `delta`, `cumulative` |141| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Metriken-Temporalitätspräferenz (Standard: `delta`). Setzen Sie auf `cumulative`, wenn Ihr Backend kumulative Temporalität erwartet | `delta`, `cumulative` |

142| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer Header (Standard: 1740000ms / 29 Minuten) | `900000` |142| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer Header (Standard: 1740000ms / 29 Minuten) | `900000` |

143 143 

144Für die Protokolle `http/protobuf` und `http/json` sendet Claude Code jede Exportanfrage mit einem `Content-Length`-Header. Vor v2.1.212 sendeten Claude Code-Versionen ab v2.1.191 diese Anfragen mit Chunked-Transfer-Codierung; Azure Monitor und andere Endpunkte, die eine deklarierte Länge erfordern, lehnten sie mit `411 Length Required` oder `400`-Fehlern ab.144Für die Protokolle `http/protobuf` und `http/json` sendet Claude Code jede Exportanfrage mit einem `Content-Length`-Header.

145 145 

146<h3 id="mtls-authentication">146<h3 id="mtls-authentication">

147 mTLS-Authentifizierung147 mTLS-Authentifizierung


202 202 

203Der eingehende Trace-Kontext gilt auch für [Ereignisse](#events). In Agent SDK und `-p`-Sitzungen mit gesetztem `TRACEPARENT` trägt jeder OTLP-Ereignis-Log-Record `trace_id` und `span_id`-Werte, die ihn mit Ihrem Anwendungs-Trace verbinden, auch wenn der Traces-Exporter nicht konfiguriert ist, damit Ihr Logging-Backend Ereignisse mit dem Rest des Traces korrelieren kann.203Der eingehende Trace-Kontext gilt auch für [Ereignisse](#events). In Agent SDK und `-p`-Sitzungen mit gesetztem `TRACEPARENT` trägt jeder OTLP-Ereignis-Log-Record `trace_id` und `span_id`-Werte, die ihn mit Ihrem Anwendungs-Trace verbinden, auch wenn der Traces-Exporter nicht konfiguriert ist, damit Ihr Logging-Backend Ereignisse mit dem Rest des Traces korrelieren kann.

204 204 

205Ein Record, der ausgegeben wird, während eine Interaktion aktiv ist, trägt die IDs des Interaktions-Spans, auch wenn Claude Code ihn außerhalb des asynchronen Kontexts des Spans ausgibt, z.B. in einem Berechtigungsprompt-Callback oder für einen Record, der während des Starts gepuffert und später exportiert wird. Ein Record, der ohne aktiven Interaktions-Span ausgegeben wird, trägt die eingehenden `TRACEPARENT`-IDs direkt. Vor v2.1.214 trugen Records, die außerhalb des asynchronen Kontexts des Spans ausgegeben wurden, stattdessen die eingehenden `TRACEPARENT`-IDs. Vor v2.1.212 trugen Ereignis-Records, die außerhalb eines aktiven Spans ausgegeben wurden, keine `trace_id` oder `span_id`.205Ein Record, der ausgegeben wird, während eine Interaktion aktiv ist, trägt die IDs des Interaktions-Spans, auch wenn Claude Code ihn außerhalb des asynchronen Kontexts des Spans ausgibt, z.B. in einem Berechtigungsprompt-Callback oder für einen Record, der während des Starts gepuffert und später exportiert wird. Ein Record, der ohne aktiven Interaktions-Span ausgegeben wird, trägt die eingehenden `TRACEPARENT`-IDs direkt.

206 206 

207<h4 id="span-hierarchy">207<h4 id="span-hierarchy">

208 Span-Hierarchie208 Span-Hierarchie


328| Attribut | Beschreibung | Gated by |328| Attribut | Beschreibung | Gated by |

329| - | - | - |329| - | - | - |

330| `duration_ms` | Zeit, die auf die Berechtigungsentscheidung gewartet wurde | |330| `duration_ms` | Zeit, die auf die Berechtigungsentscheidung gewartet wurde | |

331| `decision` | `accept` oder `reject` | |331| `decision` | `accept`, `reject` oder `cancelled`, wobei `cancelled` bedeutet, dass Claude Code nicht mehr auf eine Berechtigungsentscheidung für den Tool-Aufruf gewartet und ihn nicht ausgeführt hat | |

332| `source` | Entscheidungsquelle, entsprechend dem [Tool-Entscheidungs-Ereignis](#tool-decision-event) | |332| `source` | Bei `accept` oder `reject` die Herkunft der Entscheidung, z.B. `config`, `hook` oder `user_temporary`, mit den unter [Tool-Entscheidungs-Ereignis](#tool-decision-event) angegebenen Bedeutungen. Bei `cancelled` das, was das Warten beendet hat, bevor eine Entscheidung getroffen wurde, z.B. `user_abort` | |

333 

334Eine `cancelled`-Entscheidung mit `source` `user_abort` bedeutet, dass eine Nachricht, die sofort zugestellt werden musste, den Turn unterbrochen hat, während die Berechtigungsabfrage oder die [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Prüfung noch ausstand. Zum Beispiel hatte der Benutzer während einer Auto-Modus-Prüfung eine Nachricht in der Warteschlange und [hat sie sofort gesendet](/docs/de/interactive-mode#when-claude-code-sends-what-you-queued).

333 335 

334**`claude_code.tool.execution`**336**`claude_code.tool.execution`**

335 337 


820| - | - |822| - | - |

821| `prompt.id` | UUID v4-Kennung, die alle Ereignisse verknüpft, die während der Verarbeitung einer einzelnen Benutzereingabeaufforderung erzeugt werden |823| `prompt.id` | UUID v4-Kennung, die alle Ereignisse verknüpft, die während der Verarbeitung einer einzelnen Benutzereingabeaufforderung erzeugt werden |

822| `event.sequence` | 0-basierter Zähler zum Ordnen von Ereignissen, gezählt pro Claude Code-Prozess statt pro Sitzung |824| `event.sequence` | 0-basierter Zähler zum Ordnen von Ereignissen, gezählt pro Claude Code-Prozess statt pro Sitzung |

823| `message.uuid` | UUID der Nachricht, wie sie in der Sitzungstranskription gespeichert ist, die `~/.claude/projects/*/*.jsonl`-Dateien. Vorhanden auf `assistant_response`, auf `api_response_body` und auf `user_prompt` außer für Befehlsdispatcher, die null oder viele Nachrichten erzeugen können. Auf `assistant_response` und `api_response_body` ist dies der letzte Transkriptionseintrag der Antwort, von dem die `parentUuid` des nächsten Zuges verkettet wird. Erfordert Claude Code v2.1.214 oder später, oder v2.1.274 oder später auf `api_response_body` |825| `message.uuid` | UUID der Nachricht, wie sie im Sitzungstranskript gespeichert ist, den Dateien `~/.claude/projects/*/*.jsonl`. Vorhanden bei `assistant_response`, bei `api_response_body` und bei `user_prompt`, außer bei Befehlsaufrufen, die null oder viele Nachrichten erzeugen können. Bei `assistant_response` und `api_response_body` ist dies der letzte Transkripteintrag der Antwort, an den die `parentUuid` des nächsten Turns anknüpft. Erfordert bei `api_response_body` Claude Code v2.1.274 oder höher |

824| `request_id` | Server-zugewiesene ID der API-Anfrage, gelesen aus dem `request-id`-Antwortheader, z. B. `req_011...`. Bei einer Antwort ohne `request-id`-Header, wie bei [Amazon Bedrock](/docs/de/amazon-bedrock), kommt der Wert stattdessen aus dem `x-amzn-requestid`-Header. Vorhanden auf `api_request`, `api_error`, `api_refusal`, `assistant_response` und `api_response_body`, wenn die Antwort einen der beiden Header trägt. Entspricht demselben Attribut auf der `llm_request`-Trace-Spanne. Die `x-amzn-requestid`-Quelle erfordert Claude Code v2.1.282 oder später |826| `request_id` | Server-zugewiesene ID der API-Anfrage, gelesen aus dem `request-id`-Antwortheader, z. B. `req_011...`. Bei einer Antwort ohne `request-id`-Header, wie bei [Amazon Bedrock](/docs/de/amazon-bedrock), kommt der Wert stattdessen aus dem `x-amzn-requestid`-Header. Vorhanden auf `api_request`, `api_error`, `api_refusal`, `assistant_response` und `api_response_body`, wenn die Antwort einen der beiden Header trägt. Entspricht demselben Attribut auf der `llm_request`-Trace-Spanne. Die `x-amzn-requestid`-Quelle erfordert Claude Code v2.1.282 oder später |

825| `client_request_id` | Client-generierte UUID, die als `x-client-request-id`-Anfragekopfzeile gesendet wird. Vorhanden auf `api_request` und `api_error` bei Verbindungen mit Erstanbieter-API; nicht vorhanden bei Backends von Drittanbieter-Anbietern und wenn die Anfrage über den Fallback ohne Streaming erneut versucht wurde. Paart eine Anfrage mit ihrer Antwort und bleibt für Fehler wie Timeouts verfügbar, die nie eine Server-`request_id` erzeugt haben. Entspricht demselben Attribut auf der `llm_request`-Trace-Spanne. Erfordert Claude Code v2.1.214 oder später |827| `client_request_id` | Clientseitig generierte UUID, die als Request-Header `x-client-request-id` gesendet wird. Vorhanden bei `api_request` und `api_error` bei direkten API-Verbindungen zu Anthropic; nicht vorhanden bei Backends von Drittanbietern und wenn die Anfrage über den Non-Streaming-Fallback erneut versucht wurde. Ordnet eine Anfrage ihrer Antwort zu und bleibt auch bei Fehlern wie Timeouts verfügbar, bei denen nie eine Server-`request_id` erzeugt wurde. Entspricht demselben Attribut im Trace-Span `llm_request` |

826 828 

827Um alle Aktivitäten zu verfolgen, die durch eine einzelne Eingabeaufforderung ausgelöst werden, filtern Sie Ihre Ereignisse nach einem bestimmten `prompt.id`-Wert. Dies gibt das user\_prompt-Ereignis, alle api\_request-Ereignisse und alle tool\_result-Ereignisse zurück, die während der Verarbeitung dieser Eingabeaufforderung aufgetreten sind.829Um alle Aktivitäten zu verfolgen, die durch eine einzelne Eingabeaufforderung ausgelöst werden, filtern Sie Ihre Ereignisse nach einem bestimmten `prompt.id`-Wert. Dies gibt das user\_prompt-Ereignis, alle api\_request-Ereignisse und alle tool\_result-Ereignisse zurück, die während der Verarbeitung dieser Eingabeaufforderung aufgetreten sind.

828 830 


851* `prompt_length`: Länge der Eingabeaufforderung853* `prompt_length`: Länge der Eingabeaufforderung

852* `prompt`: Inhalt der Eingabeaufforderung. Standardmäßig reduziert. Setzen Sie `OTEL_LOG_USER_PROMPTS=1`, um ihn einzuschließen854* `prompt`: Inhalt der Eingabeaufforderung. Standardmäßig reduziert. Setzen Sie `OTEL_LOG_USER_PROMPTS=1`, um ihn einzuschließen

853* `prompt_text`: Derselbe Wert wie `prompt`, unter derselben Bedingung geschwärzt. Ein Backend, das Attributnamen mit Punkten als verschachtelte Objekte speichert, liest `prompt.id` als `id` innerhalb eines Objekts namens `prompt` und kann dabei den Prompt-String verlieren. Lesen Sie dort stattdessen `prompt_text`. Erfordert Claude Code v2.1.287 oder höher855* `prompt_text`: Derselbe Wert wie `prompt`, unter derselben Bedingung geschwärzt. Ein Backend, das Attributnamen mit Punkten als verschachtelte Objekte speichert, liest `prompt.id` als `id` innerhalb eines Objekts namens `prompt` und kann dabei den Prompt-String verlieren. Lesen Sie dort stattdessen `prompt_text`. Erfordert Claude Code v2.1.287 oder höher

854* `message.uuid`: UUID der resultierenden Benutzernachricht, die dem gespeicherten Transkriptionseintrag entspricht. Nicht vorhanden bei Befehlsdispatchern, die null oder viele Nachrichten erzeugen können. Erfordert Claude Code v2.1.214 oder später856* `message.uuid`: UUID der resultierenden Benutzernachricht, passend zum gespeicherten Transkripteintrag. Nicht vorhanden bei Befehlsaufrufen, die null oder viele Nachrichten erzeugen können.

855* `command_name`: Befehlsname, wenn die Eingabeaufforderung einen aufruft. Integrierte und gebündelte Befehlsnamen wie `compact` oder `debug` werden wie geschrieben ausgegeben; Aliase wie `reset` werden wie eingegeben statt des kanonischen Namens ausgegeben. Benutzerdefinierte, Plugin- und MCP-Befehlsnamen werden auf `custom` oder `mcp` reduziert, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt857* `command_name`: Befehlsname, wenn die Eingabeaufforderung einen aufruft. Integrierte und gebündelte Befehlsnamen wie `compact` oder `debug` werden wie geschrieben ausgegeben; Aliase wie `reset` werden wie eingegeben statt des kanonischen Namens ausgegeben. Benutzerdefinierte, Plugin- und MCP-Befehlsnamen werden auf `custom` oder `mcp` reduziert, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt

856* `command_source`: Ursprung des Befehls, wenn vorhanden: `builtin`, `custom` oder `mcp`. Von Plugins bereitgestellte Befehle werden als `custom` gemeldet858* `command_source`: Ursprung des Befehls, wenn vorhanden: `builtin`, `custom` oder `mcp`. Von Plugins bereitgestellte Befehle werden als `custom` gemeldet

857 859 


873* `response`: Antworttext, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Standardmäßig auf `<REDACTED>` reduziert. Setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=1`, um ihn einzuschließen. Wenn `OTEL_LOG_ASSISTANT_RESPONSES` nicht gesetzt ist, steuert `OTEL_LOG_USER_PROMPTS` es stattdessen, daher setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=0`, um Antworten reduziert zu halten, während die Eingabeaufforderungs-Protokollierung aktiv ist875* `response`: Antworttext, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Standardmäßig auf `<REDACTED>` reduziert. Setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=1`, um ihn einzuschließen. Wenn `OTEL_LOG_ASSISTANT_RESPONSES` nicht gesetzt ist, steuert `OTEL_LOG_USER_PROMPTS` es stattdessen, daher setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=0`, um Antworten reduziert zu halten, während die Eingabeaufforderungs-Protokollierung aktiv ist

874* `model`: Modellkennung (z. B. „claude-sonnet-5“)876* `model`: Modellkennung (z. B. „claude-sonnet-5“)

875* `request_id`: API-Anfrage-ID, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)877* `request_id`: API-Anfrage-ID, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

876* `message.uuid`: UUID des letzten Transkriptionseintrag der Antwort. Eine API-Antwort wird als ein Transkriptionseintrag pro Inhaltsblock gespeichert; dies ist der letzte, von dem die `parentUuid` des nächsten Zuges verkettet wird. Erfordert Claude Code v2.1.214 oder später878* `message.uuid`: UUID des letzten Transkripteintrags der Antwort. Eine API-Antwort wird als ein Transkripteintrag pro Inhaltsblock gespeichert; dies ist der letzte, an den die `parentUuid` des nächsten Turns anknüpft.

877* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name879* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

878 880 

879<h4 id="tool-result-event">881<h4 id="tool-result-event">


902* `tool_result_size_bytes`: Größe des Tool-Ergebnisses in Bytes904* `tool_result_size_bytes`: Größe des Tool-Ergebnisses in Bytes

903* `mcp_server_scope`: MCP-Server-Bereichskennung (für MCP-Tools)905* `mcp_server_scope`: MCP-Server-Bereichskennung (für MCP-Tools)

904* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (wenn `OTEL_LOG_TOOL_DETAILS=1`): die Commit-Identität eines erfolgreichen `git commit`-Laufs durch das Bash- oder PowerShell-Tool. `vcs.ref.head.revision` ist die Commit-SHA, `vcs.ref.head.name` ist der Branch, auf dem es committed wurde, und `vcs.ref.head.type` ist `branch`. Der Name und Typ werden weggelassen, wenn der Commit auf einem detached HEAD gemacht wurde. Erfordert Claude Code v2.1.269 oder später906* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (wenn `OTEL_LOG_TOOL_DETAILS=1`): die Commit-Identität eines erfolgreichen `git commit`-Laufs durch das Bash- oder PowerShell-Tool. `vcs.ref.head.revision` ist die Commit-SHA, `vcs.ref.head.name` ist der Branch, auf dem es committed wurde, und `vcs.ref.head.type` ist `branch`. Der Name und Typ werden weggelassen, wenn der Commit auf einem detached HEAD gemacht wurde. Erfordert Claude Code v2.1.269 oder später

905* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-Zeichenkette mit Tool-spezifischen Parametern. Für die integrierten Server von Claude Desktop in Sitzungen, die Claude Desktop besitzt, ist das Paar `mcp_server_name`/`mcp_tool_name` auch ohne das Flag enthalten, die gleiche Host-erstellte Ausnahme wie das [Tool-Entscheidungsereignis](#tool-decision-event), erfordert Claude Code v2.1.214 oder später. Die Parameter variieren je nach Tool:907* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-String mit toolspezifischen Parametern. Für die integrierten Server von Claude Desktop wird in Sitzungen, die Claude Desktop gehören, das Paar `mcp_server_name`/`mcp_tool_name` auch bei deaktiviertem Flag einbezogen – dieselbe Ausnahme für vom Host definierte Namen wie beim [Tool-Entscheidungs-Event](#tool-decision-event). Die Parameter variieren je nach Tool:

906 * Für Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description` und `dangerouslyDisableSandbox`, plus `git_commit_id` und `git_branch`, wenn ein `git commit`-Befehl erfolgreich ist. `git_commit_id` ist die vollständige Commit-SHA, wenn der Commit der HEAD der Arbeitsverzeichnis der Sitzung ist, und Gits abgekürzte SHA andernfalls. `git_branch` ist der Branch, auf dem es committed wurde, weggelassen auf einem detached HEAD908 * Für das Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description` und `dangerouslyDisableSandbox`, zusätzlich `git_commit_id` und `git_branch`, wenn ein `git commit`-Befehl erfolgreich ist. `git_commit_id` ist der vollständige Commit-SHA, wenn der Commit der HEAD des Arbeitsverzeichnisses der Sitzung ist, andernfalls der von Git abgekürzte SHA. `git_branch` ist der Branch, auf dem committet wurde; entfällt bei einem Detached HEAD

907 * Für das Workspace-Bash-Tool der Desktop-App, das auch `tool_name` als `Bash` meldet: enthält nur `bash_command`, `full_command` und `timeout`909 * Für das Workspace-Bash-Tool der Desktop-App, das `tool_name` ebenfalls als `Bash` meldet: enthält nur `bash_command`, `full_command` und `timeout`

908 * Für MCP-Tools: enthält `mcp_server_name`, `mcp_tool_name`910 * Für MCP-Tools: enthält `mcp_server_name`, `mcp_tool_name`

909 * Für Skill-Tool: enthält `skill_name`911 * Für das Skill-Tool: enthält `skill_name`

910 * Für Agent-Tool oder Legacy-Task-Tool: enthält `subagent_type`912 * Für das Agent-Tool oder das ältere Task-Tool: enthält `subagent_type`

911* `tool_input` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-serialisierte Tool-Argumente. Einzelne Werte über 512 Zeichen werden gekürzt, und die vollständige Nutzlast ist auf \~4 K Zeichen begrenzt. Gilt für alle Tools einschließlich MCP-Tools.913* `tool_input` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-serialisierte Tool-Argumente. Einzelne Werte über 512 Zeichen werden gekürzt, und die vollständige Nutzlast ist auf \~4 K Zeichen begrenzt. Gilt für alle Tools einschließlich MCP-Tools.

912 914 

913<h4 id="api-request-event">915<h4 id="api-request-event">


933* `cache_read_tokens`: Anzahl der aus dem Cache gelesenen Token935* `cache_read_tokens`: Anzahl der aus dem Cache gelesenen Token

934* `cache_creation_tokens`: Anzahl der für die Cache-Erstellung verwendeten Token936* `cache_creation_tokens`: Anzahl der für die Cache-Erstellung verwendeten Token

935* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).937* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).

936* `client_request_id`: Client-generierte UUID, die als `x-client-request-id`-Anfragekopfzeile gesendet wird; siehe die Tabelle [Ereigniskorrelationsattribute](#event-correlation-attributes) für wann sie vorhanden ist. Erfordert Claude Code v2.1.214 oder später938* `client_request_id`: Clientseitig generierte UUID, die als Request-Header `x-client-request-id` gesendet wird; wann sie vorhanden ist, zeigt die Tabelle der [Attribute zur Event-Korrelation](#event-correlation-attributes)

937* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war939* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war

938* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name940* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

939* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.941* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.


959* `duration_ms`: Anfrage-Dauer in Millisekunden961* `duration_ms`: Anfrage-Dauer in Millisekunden

960* `attempt`: Anzahl der unternommenen Versuche, einschließlich der ursprünglichen Anfrage. Unter [Erschöpfung der Wiederholungsversuche erkennen](#detect-retry-exhaustion) erfahren Sie, wann die Zählung neu beginnt962* `attempt`: Anzahl der unternommenen Versuche, einschließlich der ursprünglichen Anfrage. Unter [Erschöpfung der Wiederholungsversuche erkennen](#detect-retry-exhaustion) erfahren Sie, wann die Zählung neu beginnt

961* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).963* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).

962* `client_request_id`: Client-generierte UUID, die als `x-client-request-id`-Anfragekopfzeile gesendet wird. Verfügbar auch wenn ein Fehler wie ein Timeout oder Verbindungsfehler nie eine Server-`request_id` erzeugt hat; siehe die Tabelle [Ereigniskorrelationsattribute](#event-correlation-attributes) für wann sie vorhanden ist. Erfordert Claude Code v2.1.214 oder später964* `client_request_id`: Clientseitig generierte UUID, die als Request-Header `x-client-request-id` gesendet wird. Auch verfügbar, wenn bei einem Fehler wie einem Timeout oder Verbindungsfehler nie eine Server-`request_id` erzeugt wurde; wann sie vorhanden ist, zeigt die Tabelle der [Attribute zur Event-Korrelation](#event-correlation-attributes).

963* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war965* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war

964* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name966* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

965* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.967* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.


1057* `tool_name`: Name des Tools (z. B. „Read“, „Edit“, „Write“, „NotebookEdit“)1059* `tool_name`: Name des Tools (z. B. „Read“, „Edit“, „Write“, „NotebookEdit“)

1058* `tool_use_id`: Eindeutige Kennung für diesen Tool-Aufruf. Entspricht der `tool_use_id`, die an Hooks übergeben wird, und ermöglicht die Korrelation zwischen OTel-Ereignissen und Hook-erfassten Daten.1060* `tool_use_id`: Eindeutige Kennung für diesen Tool-Aufruf. Entspricht der `tool_use_id`, die an Hooks übergeben wird, und ermöglicht die Korrelation zwischen OTel-Ereignissen und Hook-erfassten Daten.

1059* `decision`: Entweder `"accept"` oder `"reject"`1061* `decision`: Entweder `"accept"` oder `"reject"`

1060* `tool_source`: Immer vorhanden. Die Herkunft des Tools als geschlossener Satz von CLI-erstellten Werten. Erfordert Claude Code v2.1.214 oder später1062* `tool_source`: Immer vorhanden. Die Herkunft des Tools, als geschlossene Menge von der CLI festgelegter Werte:

1061 * `"builtin"`: die eigenen Tools der CLI1063 * `"builtin"`: die eigenen Tools der CLI

1062 * `"mcp"`: MCP-Server allgemein1064 * `"mcp"`: MCP-Server im Allgemeinen

1063 * `"sdk_host_builtin_mcp"`: ein In-Prozess-Server, der in Claude Desktop selbst integriert ist, in einer Sitzung, die Claude Desktop besitzt. Claude Desktop besitzt eine Sitzung, die es von einem seiner eigenen Einstiegspunkte gestartet hat, `claude-desktop`, `claude-desktop-3p` oder `local-agent`, wenn diese Sitzung kein verschachteltes Kind ist; verschachtelte Sitzungen, einschließlich Sitzungen, die Claude Code selbst erzeugt, melden diese Server als `"mcp"`1065 * `"sdk_host_builtin_mcp"`: ein prozessinterner Server, der in Claude Desktop selbst integriert ist, in einer Sitzung, die Claude Desktop gehört. Claude Desktop gehört eine Sitzung, die es über einen seiner eigenen Einstiegspunkte – `claude-desktop`, `claude-desktop-3p` oder `local-agent` – gestartet hat, sofern diese Sitzung kein verschachteltes Kind ist; verschachtelte Sitzungen, einschließlich Sitzungen, die Claude Code selbst startet, melden diese Server als `"mcp"`

1064* `source`: Woher die Entscheidung kam:1066* `source`: Woher die Entscheidung stammt:

1065 * `"config"`: Automatisch entschieden ohne Eingabeaufforderung, basierend auf Projekteinstellungen, Zulassungs- oder Ablehnungsregeln in den persönlichen Einstellungen des Benutzers, Unternehmensrichtlinie, `--allowedTools`- oder `--disallowedTools`-Flags, dem aktiven Berechtigungsmodus, einer Sitzungs-Zuschuss aus einer früheren Eingabeaufforderung in derselben interaktiven CLI-Sitzung, oder weil das Tool inhärent sicher ist. Das Ereignis gibt nicht an, welche dieser Quellen übereinstimmte. Claude Code meldet auch `"config"`, wenn die Berechtigungsaufforderungs-Anfrage selbst fehlschlägt, z. B. wenn der [`canUseTool`](/docs/de/agent-sdk/typescript#canusetool)-Callback des Agent SDK oder das [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Tool ein ungültiges Ergebnis zurückgibt, oder wenn der Eingabestrom geschlossen wird, während die Anfrage ausstehend ist. Vor v2.1.216 meldete Claude Code diese Fehler als `"user_reject"`.1067 * `"config"`: Automatisch ohne Nachfrage entschieden, durch eine dieser Quellen:

1066 * `"hook"`: Ein `PreToolUse`- oder `PermissionRequest`-Hook gab die Entscheidung zurück.1068 

1067 * `"user_permanent"`: Ausgegeben, wenn der Benutzer „Ja, und nicht mehr fragen für ...“ bei einer Berechtigungsaufforderung wählte, was eine Zulassungsregel in seinen persönlichen Einstellungen speichert. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; spätere Aufrufe, die die gespeicherte Regel erfüllen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben sowohl die ursprüngliche Wahl als auch spätere Regelübereinstimmungen `"user_permanent"` aus. Wird als Akzeptanz behandelt.1069 * Projekteinstellungen

1068 * `"user_temporary"`: Ausgegeben, wenn der Benutzer „Ja“ bei einer Berechtigungsaufforderung für eine einmalige Genehmigung wählte, oder eine Option wählte, die Zugriff für den Rest der Sitzung bei einer Datei-Bearbeitungs- oder Leseanforderung gewährt. In der interaktiven CLI wird dies nur für die Wahl selbst ausgegeben; spätere Aufrufe, die durch diesen Sitzungs-Zuschuss erlaubt sind, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben sowohl die Wahl als auch spätere Übereinstimmungen `"user_temporary"` aus. Wird als Akzeptanz behandelt.1070 * Allow- oder Deny-Regeln in den persönlichen Einstellungen des Benutzers

1069 * `"user_abort"`: Ausgegeben, wenn der Benutzer die Berechtigungsaufforderung geschlossen hat, ohne zu antworten. In Agent SDK- und nicht-interaktiven `-p`-Sitzungen schließt dies auch das Unterbrechen des Zuges ein, während eine `canUseTool`- oder `--permission-prompt-tool`-Berechtigungsanfrage ausstehend ist; vor v2.1.216 meldete Claude Code diese Unterbrechung als `"user_reject"`. Wird als Ablehnung behandelt.1071 * Verwaltete Unternehmensrichtlinie

1070 * `"user_reject"`: Ausgegeben, wenn der Benutzer „Nein“ bei einer Aufforderung wählte. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; Aufrufe, die eine Ablehnungsregel in den persönlichen Einstellungen des Benutzers erfüllen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben Aufrufe, die eine Ablehnungsregel in persönlichen Einstellungen erfüllen, `"user_reject"` aus. Wird als Ablehnung behandelt.1072 * Flags `--allowedTools` oder `--disallowedTools`

1071* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-Zeichenkette mit Tool-spezifischen Parametern. Gleiche Form wie das [Tool-Ergebnis-Ereignis](#tool-result-event), minus Post-Ausführungs-Felder wie `git_commit_id`. Werte können sich von `tool_result` für einen akzeptierten Aufruf unterscheiden, wenn die Berechtigungsentscheidung die Tool-Eingabe über `updatedInput` umschreibt. Verwenden Sie dieses Attribut, um zu sehen, welcher Befehl abgelehnt wurde, wenn `decision` `"reject"` ist.1073 * Der aktive Berechtigungsmodus

1072 * Für `"sdk_host_builtin_mcp"`-Tools: `mcp_server_name` und `mcp_tool_name` sind auch enthalten, wenn `OTEL_LOG_TOOL_DETAILS` aus ist, da die Host-Anwendung diese Namen definiert; ohne sie wäre ein abgelehnter Aufruf an einen dieser integrierten Server auf dem Standard-Stream nicht zuordenbar. Für benutzerkonfigurierte MCP-Server ist der `tool_name` des Ereignisses immer das Literal `"mcp_tool"`, und die Server- und Tool-Namen erscheinen nur in `tool_parameters` mit dem Flag an; Argument-Inhalt erfordert das Flag überall. Erfordert Claude Code v2.1.214 oder später1074 * Der Klassifikator des Auto-Modus, dessen Urteil dasselbe Ereignis in `classifier_verdict` festhält

1073 * Für Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Das Workspace-Bash-Tool der Desktop-App meldet auch `tool_name` als `Bash`, enthält aber nur `bash_command`, `full_command` und `timeout`1075 * Eine Freigabe für den Rest der Sitzung, erteilt bei einer früheren Berechtigungsabfrage in derselben interaktiven CLI-Sitzung

1076 * Das Tool ist an sich sicher

1077 

1078 Der Wert `source` gibt nicht an, welche dieser Quellen zugetroffen hat.

1079 

1080 Claude Code meldet `"config"` auch, wenn die Anfrage der Berechtigungsabfrage selbst fehlschlägt. Diese Anfrage schlägt zum Beispiel fehl, wenn der Callback [`canUseTool`](/docs/de/agent-sdk/typescript#canusetool) des Agent SDK oder das Tool [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) ein ungültiges Ergebnis zurückgibt oder wenn der Eingabestream geschlossen wird, während die Anfrage aussteht. Vor v2.1.216 meldete Claude Code diese Fehler als `"user_reject"`.

1081 * `"hook"`: Ein `PreToolUse`- oder `PermissionRequest`-Hook hat die Entscheidung zurückgegeben.

1082 * `"user_permanent"`: Wird ausgegeben, wenn der Benutzer bei einer Berechtigungsabfrage „Yes, and don't ask again for ...“ gewählt hat, wodurch eine Allow-Regel in seinen persönlichen Einstellungen gespeichert wird. In der interaktiven CLI wird dies nur für diese Auswahl selbst ausgegeben; spätere Aufrufe, die der gespeicherten Regel entsprechen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht interaktiven `-p`-Sitzungen geben sowohl die ursprüngliche Auswahl als auch spätere Regeltreffer `"user_permanent"` aus. Wird als Akzeptieren behandelt.

1083 * `"user_temporary"`: Wird ausgegeben, wenn der Benutzer bei einer Berechtigungsabfrage „Yes“ für eine einmalige Genehmigung gewählt hat oder bei einer Abfrage zum Bearbeiten oder Lesen einer Datei eine Option gewählt hat, die den Zugriff für den Rest der Sitzung gewährt. In der interaktiven CLI wird dies nur für die Auswahl selbst ausgegeben; spätere Aufrufe, die durch diese sitzungsbezogene Freigabe erlaubt werden, geben stattdessen `"config"` aus. In Agent SDK- oder nicht interaktiven `-p`-Sitzungen geben sowohl die Auswahl als auch spätere Treffer `"user_temporary"` aus. Wird als Akzeptieren behandelt.

1084 * `"user_abort"`: Wird ausgegeben, wenn der Benutzer die Berechtigungsabfrage geschlossen hat, ohne zu antworten. In Agent SDK- und nicht interaktiven `-p`-Sitzungen schließt dies das Unterbrechen des Turns ein, während eine Berechtigungsanfrage über `canUseTool` oder `--permission-prompt-tool` aussteht; vor v2.1.216 meldete Claude Code diese Unterbrechung als `"user_reject"`. Wird als Ablehnen behandelt.

1085 * `"user_reject"`: Wird ausgegeben, wenn der Benutzer bei der Abfrage „No“ gewählt hat. In der interaktiven CLI wird dies nur für diese Auswahl selbst ausgegeben; Aufrufe, die einer Deny-Regel in den persönlichen Einstellungen des Benutzers entsprechen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht interaktiven `-p`-Sitzungen geben Aufrufe, die einer Deny-Regel in den persönlichen Einstellungen entsprechen, `"user_reject"` aus. Wird als Ablehnen behandelt.

1086* `classifier_verdict`: Das Urteil des [Klassifikators](/docs/de/permission-modes#how-the-classifier-evaluates-actions) des Auto-Modus für den Aufruf oder der Grund, warum Claude Code den Aufruf verweigert hat, wenn kein Urteil kam. Erfordert Claude Code v2.1.301 oder höher

1087 

1088 * `"allow"`: Der Klassifikator hat den Aufruf genehmigt

1089 * `"block"`: Der Klassifikator hat den Aufruf blockiert. Eine Klassifikatorprüfung, die mittendrin fehlschlägt, kann ebenfalls mit `"block"` enden, sodass ein teilweiser Ausfall des Klassifikators als vermehrte Blockierungen statt als `"unavailable"` erscheinen kann

1090 * `"no_verdict"`: Die Prüfung lief, lieferte aber [kein verwertbares Urteil](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action), daher hat Claude Code den Aufruf verweigert. Die Verweigerung bedeutet nicht, dass der Klassifikator den Aufruf als unsicher eingestuft hat

1091 * `"unavailable"`: Die Anfrage an den Klassifikator ist fehlgeschlagen, zum Beispiel wegen eines Rate-Limits, eines Timeouts oder eines Verbindungsfehlers, daher hat Claude Code den Aufruf verweigert. Bei der [serverseitigen Klassifikatorprüfung](/docs/de/permission-modes#server-side-classifier-review) kennzeichnet der Wert auch einen Aufruf, der verweigert wurde, weil [der Server kein Sicherheitsurteil zurückgegeben hat](/docs/de/errors#the-server-returned-no-safety-verdict)

1092 

1093 Das Attribut erscheint auch bei Aufrufen im Plan-Modus, wenn [der Klassifikator Befehle im Plan-Modus prüft](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode). In diesen Fällen fehlt das Attribut:

1094 

1095 * Eine Allow- oder Deny-[Berechtigungsregel](/docs/de/permissions#manage-permissions) hat über den Aufruf entschieden

1096 * Claude Code hat den Aufruf im Auto-Modus genehmigt, ohne den Klassifikator zu fragen

1097 * Der Benutzer hat die Abfrage beantwortet, die Claude Code nach [wiederholten Blockierungen](/docs/de/permission-modes#repeated-block-thresholds) angezeigt hat

1098 * In einem `-p`-Lauf ohne `--permission-prompt-tool` hat Claude Code den Aufruf nach wiederholten Blockierungen verweigert, weil niemand eine Abfrage beantworten konnte. Dieses Ereignis meldet `decision` als `"reject"` und `source` als `"config"`

1099* `classifier_category` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Der Name der [integrierten Regel](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config), die der Klassifikator beim Blockieren des Aufrufs genannt hat, in Kleinbuchstaben mit Unterstrichen, z. B. `"data_exfiltration"` für die Regel Data Exfiltration. Erfordert Claude Code v2.1.301 oder höher. Das Attribut ist vorhanden, wenn alle diese Bedingungen erfüllt sind:

1100 * `classifier_verdict` ist `"block"`

1101 * Claude Code hat die Klassifikatoranfrage selbst gesendet, statt die [serverseitige Klassifikatorprüfung](/docs/de/permission-modes#server-side-classifier-review) zu verwenden

1102 * Der Klassifikator hat genau eine Regel genannt, und diese Regel ist eine integrierte und keine von Ihnen geschriebene

1103* `permission_mode`: [Berechtigungsmodus](/docs/de/permission-modes), der aktiv war, als die Berechtigungsprüfung dieses Aufrufs begann: `"default"`, `"plan"`, `"acceptEdits"`, `"bypassPermissions"`, `"dontAsk"` oder `"auto"`. Der manuelle Modus erscheint als `"default"`. Ein Aufruf eines [Subagenten](/docs/de/sub-agents#permission-modes) meldet den Berechtigungsmodus des Subagenten statt den der Sitzung. Erfordert Claude Code v2.1.301 oder höher

1104* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-String mit toolspezifischen Parametern. Gleiche Struktur wie beim [Tool-Ergebnis-Event](#tool-result-event), ohne Felder nach der Ausführung wie `git_commit_id`. Die Werte können bei einem akzeptierten Aufruf von `tool_result` abweichen, wenn die Berechtigungsentscheidung die Tool-Eingabe über `updatedInput` umschreibt. Verwenden Sie dieses Attribut, um zu sehen, welcher Befehl abgelehnt wurde, wenn `decision` `"reject"` ist.

1105 * Für `"sdk_host_builtin_mcp"`-Tools: `mcp_server_name` und `mcp_tool_name` werden auch dann einbezogen, wenn `OTEL_LOG_TOOL_DETAILS` deaktiviert ist, da die Host-Anwendung diese Namen festlegt; ohne sie wäre ein abgelehnter Aufruf an einen dieser integrierten Server im Standard-Stream nicht zuordenbar. Bei vom Benutzer konfigurierten MCP-Servern ist `tool_name` des Events immer der Literalwert `"mcp_tool"`, und die Server- und Tool-Namen erscheinen nur bei aktiviertem Flag in `tool_parameters`; Argumentinhalte erfordern das Flag überall.

1106 * Für das Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Das Workspace-Bash-Tool der Desktop-App meldet `tool_name` ebenfalls als `Bash`, enthält aber nur `bash_command`, `full_command` und `timeout`

1074 * Für MCP-Tools: enthält `mcp_server_name`, `mcp_tool_name`1107 * Für MCP-Tools: enthält `mcp_server_name`, `mcp_tool_name`

1075 * Für Skill-Tool: enthält `skill_name`1108 * Für das Skill-Tool: enthält `skill_name`

1076 * Für Agent-Tool oder Legacy-Task-Tool: enthält `subagent_type`1109 * Für das Agent-Tool oder das ältere Task-Tool: enthält `subagent_type`

1077 1110 

1078<h4 id="permission-mode-changed-event">1111<h4 id="permission-mode-changed-event">

1079 Berechtigungsmodus-Änderungs-Ereignis1112 Berechtigungsmodus-Änderungs-Ereignis


1081 1114 

1082Wird protokolliert, wenn sich der Berechtigungsmodus ändert, zum Beispiel durch Durchschalten mit `Shift+Tab`, durch Verlassen des Plan-Modus oder durch eine Gate-Prüfung des Auto-Modus.1115Wird protokolliert, wenn sich der Berechtigungsmodus ändert, zum Beispiel durch Durchschalten mit `Shift+Tab`, durch Verlassen des Plan-Modus oder durch eine Gate-Prüfung des Auto-Modus.

1083 1116 

1117Um Tool-Aufrufe nach dem Berechtigungsmodus zu gruppieren, in dem sie jeweils geprüft wurden, verwenden Sie `permission_mode` beim [Tool-Entscheidungsereignis](#tool-decision-event).

1118 

1084**Ereignisname**: `claude_code.permission_mode_changed`1119**Ereignisname**: `claude_code.permission_mode_changed`

1085 1120 

1086**Attribute**:1121**Attribute**:


1091* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1126* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1092* `from_mode`: Der vorherige Berechtigungsmodus, z. B. `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` oder `"bypassPermissions"`1127* `from_mode`: Der vorherige Berechtigungsmodus, z. B. `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` oder `"bypassPermissions"`

1093* `to_mode`: Der neue Berechtigungsmodus1128* `to_mode`: Der neue Berechtigungsmodus

1094* `trigger`: Was die Änderung verursacht hat. Einer von `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` oder `"auto_opt_in"`. Bei manchen Änderungen nicht vorhanden, etwa wenn das SDK den Berechtigungsmodus über [`setPermissionMode()`](/docs/de/agent-sdk/typescript#query-object) setzt1129* `trigger`: Was die Änderung verursacht hat, z. B. `"shift_tab"`, `"exit_plan_mode"` oder `"auto_gate_denied"`. Fehlt bei einigen Änderungen, etwa wenn das SDK den Berechtigungsmodus über [`setPermissionMode()`](/docs/de/agent-sdk/typescript#query-object) setzt

1095 1130 

1096<h4 id="auth-event">1131<h4 id="auth-event">

1097 Auth-Ereignis1132 Auth-Ereignis


1402* `total_tool_uses`: Anzahl der Tool-Aufrufe, die der Subagent über den ganzen Lauf gemacht hat1437* `total_tool_uses`: Anzahl der Tool-Aufrufe, die der Subagent über den ganzen Lauf gemacht hat

1403* `duration_ms`: Laufzeit in Millisekunden1438* `duration_ms`: Laufzeit in Millisekunden

1404* `model`: Das Modell, das der Subagent ausgeführt hat1439* `model`: Das Modell, das der Subagent ausgeführt hat

1405* `final_model`: Das Modell, das die letzte Antwort des Subagenten erzeugt hat, das sich von `model` nach einem Mid-Run-Wechsel wie einem Fallback unterscheidet. Erfordert Claude Code v2.1.212 oder später1440* `final_model`: Das Modell, das die letzte Antwort des Subagenten erzeugt hat; es weicht nach einem Wechsel während des Laufs, etwa einem Fallback, von `model` ab

1406* `model_swapped`: Ob mehr als ein Modell die Anfragen des Subagenten bedient hat. Erfordert Claude Code v2.1.212 oder später1441* `model_swapped`: Ob mehr als ein Modell die Anfragen des Subagenten bedient hat

1407* `plugin_id_hash`, `plugin.name`: Vorhanden für von Plugins bereitgestellte Agenten. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt; andere Plugin-Namen werden durch `"third-party"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt1442* `plugin_id_hash`, `plugin.name`: Vorhanden für von Plugins bereitgestellte Agenten. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt; andere Plugin-Namen werden durch `"third-party"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt

1408 1443 

1409<h4 id="feedback-survey-event">1444<h4 id="feedback-survey-event">


1548 Kostenmetriken sind Näherungswerte. Für offizielle Abrechnungsdaten konsultieren Sie Ihren API-Anbieter (Claude Console, Amazon Bedrock oder Google Cloud's Agent Platform).1583 Kostenmetriken sind Näherungswerte. Für offizielle Abrechnungsdaten konsultieren Sie Ihren API-Anbieter (Claude Console, Amazon Bedrock oder Google Cloud's Agent Platform).

1549</Note>1584</Note>

1550 1585 

1551Claude Code zählt jede Streaming-Antwort genau einmal zu den Kosten- und Token-Metriken, auch wenn ein Gateway oder Proxy hinter `ANTHROPIC_BASE_URL` die Nutzung progressiv über mehrere Frames hinweg streamt. Vor v2.1.214 führten Streams, die Nutzung in mehr als einem Frame trugen, zu einer Aufblähung von `claude_code.cost.usage` und `claude_code.token.usage` um ungefähr eine zusätzliche vollständige Anfrage pro zusätzlichem Frame.1586Claude Code zählt jede Streaming-Antwort genau einmal zu den Kosten- und Token-Metriken, auch wenn ein Gateway oder Proxy hinter `ANTHROPIC_BASE_URL` die Nutzung progressiv über mehrere Frames hinweg streamt.

1552 1587 

1553<h3 id="alerting-and-segmentation">1588<h3 id="alerting-and-segmentation">

1554 Warnungen und Segmentierung1589 Warnungen und Segmentierung


1570 1605 

1571Claude Code wiederholt fehlgeschlagene API-Anfragen intern und gibt nur nach dem Aufgeben ein einzelnes `claude_code.api_error` Ereignis aus, daher ist das Ereignis selbst das Endsignal für diese Anfrage. Zwischenzeitliche Wiederholungsversuche werden nicht als separate Ereignisse protokolliert.1606Claude Code wiederholt fehlgeschlagene API-Anfragen intern und gibt nur nach dem Aufgeben ein einzelnes `claude_code.api_error` Ereignis aus, daher ist das Ereignis selbst das Endsignal für diese Anfrage. Zwischenzeitliche Wiederholungsversuche werden nicht als separate Ereignisse protokolliert.

1572 1607 

1573Das Attribut `attempt` auf dem Ereignis zeichnet die Anzahl der Versuche auf. `CLAUDE_CODE_MAX_RETRIES` hat einen Standardwert von 10 und ist auf 15 begrenzt. Ab v2.1.199 können Sie `CLAUDE_CODE_RETRY_WATCHDOG` setzen, um den Standardwert zu erhöhen und die Obergrenze zu entfernen.1608Das Attribut `attempt` auf dem Ereignis zeichnet die Anzahl der Versuche auf. `CLAUDE_CODE_MAX_RETRIES` hat einen Standardwert von 10 und ist auf 15 begrenzt; wenn [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/de/env-vars) gesetzt ist, ist der Standardwert höher und es gibt keine Obergrenze.

1574 1609 

1575Wenn die Anfrage alle Wiederholungsversuche bei einem vorübergehenden Fehler erschöpft, ist `attempt` höchstens um eins höher als dieses effektive Limit: standardmäßig 11.1610Wenn die Anfrage alle Wiederholungsversuche bei einem vorübergehenden Fehler erschöpft, ist `attempt` höchstens um eins höher als dieses effektive Limit: standardmäßig 11.

1576 1611 


1646 1681 

1647Ohne `OTEL_LOG_TOOL_DETAILS` lassen diese Ereignisse die identifizierende Detail fallen:1682Ohne `OTEL_LOG_TOOL_DETAILS` lassen diese Ereignisse die identifizierende Detail fallen:

1648 1683 

1649* `tool_result`: behält `mcp_server_scope` und einen `tool_name`, der für benutzerkonfigurierte Server auf das Literal `"mcp_tool"` redigiert ist, lässt Argument-Inhalte weg. Für Claude Desktop's integrierte Server, in Sitzungen, die Claude Desktop besitzt, behält es auch das `mcp_server_name`/`mcp_tool_name`-Paar innerhalb von `tool_parameters`, die gleiche von Host verfasste Ausnahme wie `tool_decision`, erfordert Claude Code v2.1.214 oder später1684* `tool_result`: behält `mcp_server_scope` und einen `tool_name`, der für benutzerkonfigurierte Server auf das Literal `"mcp_tool"` redigiert ist, lässt Argument-Inhalte weg. Für Claude Desktop's integrierte Server, in Sitzungen, die Claude Desktop besitzt, behält es auch das `mcp_server_name`/`mcp_tool_name`-Paar innerhalb von `tool_parameters`, die gleiche von Host verfasste Ausnahme wie `tool_decision`

1650* `tool_decision`: behält `tool_source` und einen `tool_name`, der für benutzerkonfigurierte Server auf das Literal `"mcp_tool"` redigiert ist, lässt Argument-Inhalte weg. Für Claude Desktop's integrierte Server, in Sitzungen, die Claude Desktop besitzt, behält es auch das `mcp_server_name`/`mcp_tool_name`-Paar innerhalb von `tool_parameters`; `tool_source` und das Name-Paar erfordern beide Claude Code v2.1.214 oder später1685* `tool_decision`: behält `tool_source` und einen `tool_name`, der für benutzerkonfigurierte Server auf das Literal `"mcp_tool"` redigiert ist, lässt Argument-Inhalte weg. Für Claude Desktop's integrierte Server, in Sitzungen, die Claude Desktop besitzt, behält es auch das `mcp_server_name`/`mcp_tool_name`-Paar innerhalb von `tool_parameters`

1651* `mcp_server_connection`: lässt `server_name` und die Fehlermeldung weg, behält aber `is_plugin`, `plugin_id_hash` und `plugin.name`, wobei Namen von Nicht-Anthropic-Plugins auf das Literal `"third-party"` redigiert werden, sodass von Plugins bereitgestellte Server ohne detaillierte Protokollierung unterscheidbar bleiben1686* `mcp_server_connection`: lässt `server_name` und die Fehlermeldung weg, behält aber `is_plugin`, `plugin_id_hash` und `plugin.name`, wobei Namen von Nicht-Anthropic-Plugins auf das Literal `"third-party"` redigiert werden, sodass von Plugins bereitgestellte Server ohne detaillierte Protokollierung unterscheidbar bleiben

1652 1687 

1653<h3 id="map-security-questions-to-events">1688<h3 id="map-security-questions-to-events">


1658 1693 

1659| Signal | Ereignis | Schlüsselattribute |1694| Signal | Ereignis | Schlüsselattribute |

1660| - | - | - |1695| - | - | - |

1661| Tool-Aufruf zulässig oder verweigert, und von wem | `tool_decision` | `decision`, `source`, `tool_name`, `tool_parameters` |1696| Tool-Aufruf zulässig oder verweigert, und woher die Entscheidung kam, etwa von einer Regel, einem Hook oder dem Benutzer | [`tool_decision`](#tool-decision-event) | `decision`, `source`, `classifier_verdict`, `permission_mode`, `tool_name`; `tool_parameters`, wenn Sie `OTEL_LOG_TOOL_DETAILS=1` setzen |

1697| Der Klassifikator des Auto-Modus hat einen Tool-Aufruf zugelassen oder blockiert, oder Claude Code hat den Aufruf ohne Klassifikator-Urteil verweigert | [`tool_decision`](#tool-decision-event), wenn `classifier_verdict` vorhanden ist. Bei einer Verweigerung ohne Urteil ist `classifier_verdict` `"no_verdict"` oder `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name`; `classifier_category`, wenn Sie `OTEL_LOG_TOOL_DETAILS=1` setzen |

1662| Berechtigungsmodus-Eskalation | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |1698| Berechtigungsmodus-Eskalation | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |

1699| In welchem Berechtigungsmodus jeder Tool-Aufruf geprüft wurde, einschließlich der Aufrufe von Subagenten | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |

1663| Policy-Hook blockierte eine Aktion | `hook_execution_complete` | `hook_event`, `num_blocking` |1700| Policy-Hook blockierte eine Aktion | `hook_execution_complete` | `hook_event`, `num_blocking` |

1664| Login, Logout und Authentifizierungsfehler | `auth` | `action`, `success`, `error_category` |1701| Login, Logout und Authentifizierungsfehler | `auth` | `action`, `success`, `error_category` |

1665| MCP-Server-Verbindung oder Fehler | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |1702| MCP-Server-Verbindung oder Fehler | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |


1824 1861 

1825 * Unter detailliertem Beta-Tracing tragen Spans außerdem die neuen Benutzernachrichten, Tool-Ergebnisse und System-Erinnerungen, die mit jeder Anfrage gesendet werden, den Text des System-Prompts und die Modellausgabe. [Inhaltsattribute unter detailliertem Beta-Tracing](#new-context-gates) listet jedes Attribut auf. Das `claude_code.system_prompt`-Ereignis trägt den vollständigen System-Prompt1862 * Unter detailliertem Beta-Tracing tragen Spans außerdem die neuen Benutzernachrichten, Tool-Ergebnisse und System-Erinnerungen, die mit jeder Anfrage gesendet werden, den Text des System-Prompts und die Modellausgabe. [Inhaltsattribute unter detailliertem Beta-Tracing](#new-context-gates) listet jedes Attribut auf. Das `claude_code.system_prompt`-Ereignis trägt den vollständigen System-Prompt

1826* Assistent-Antworttext wird standardmäßig nicht erfasst. Nur die Antwortlänge wird aufgezeichnet. Um Antworttext einzubeziehen, setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=1`. Wie alle OpenTelemetry-Daten von Claude Code wird der Antworttext nur an den OTel-Endpunkt gesendet, den Sie konfigurieren, niemals an Anthropic. Wenn diese Variable nicht gesetzt ist, wird `OTEL_LOG_USER_PROMPTS` als Fallback verwendet, daher setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=0`, wenn Sie Prompt-Inhalte ohne Antwortinhalte in Ereignissen möchten. Unter detailliertem Beta-Tracing trägt der `claude_code.llm_request`-Span weiterhin die Modellausgabe in [`response.model_output`](#new-context-gates), das `OTEL_LOG_USER_PROMPTS` statt dieser Variable folgt1863* Assistent-Antworttext wird standardmäßig nicht erfasst. Nur die Antwortlänge wird aufgezeichnet. Um Antworttext einzubeziehen, setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=1`. Wie alle OpenTelemetry-Daten von Claude Code wird der Antworttext nur an den OTel-Endpunkt gesendet, den Sie konfigurieren, niemals an Anthropic. Wenn diese Variable nicht gesetzt ist, wird `OTEL_LOG_USER_PROMPTS` als Fallback verwendet, daher setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=0`, wenn Sie Prompt-Inhalte ohne Antwortinhalte in Ereignissen möchten. Unter detailliertem Beta-Tracing trägt der `claude_code.llm_request`-Span weiterhin die Modellausgabe in [`response.model_output`](#new-context-gates), das `OTEL_LOG_USER_PROMPTS` statt dieser Variable folgt

1827* Tool-Eingabeargumente und Parameter werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie `OTEL_LOG_TOOL_DETAILS=1`. Für die integrierten Server von Claude Desktop werden in Sitzungen, die Claude Desktop besitzt, `tool_decision` und `tool_result` mit dem Paar `mcp_server_name`/`mcp_tool_name` übertragen, von Hosts erstellte Namen statt Argumentinhalte, auch wenn das Flag aus ist. Die Ausnahme erfordert Claude Code v2.1.214 oder später. Diese Daten werden nur an den OTEL-Endpunkt gesendet, den Sie konfigurieren, niemals an Anthropic. Argumente können immer noch vertrauliche Werte enthalten, daher konfigurieren Sie Ihr Telemetrie-Backend, um diese Attribute nach Bedarf zu filtern oder zu schwärzen. Wenn aktiviert:1864* Tool-Eingabeargumente und Parameter werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie `OTEL_LOG_TOOL_DETAILS=1`. Für die integrierten Server von Claude Desktop werden in Sitzungen, die Claude Desktop besitzt, `tool_decision` und `tool_result` mit dem Paar `mcp_server_name`/`mcp_tool_name` übertragen, von Hosts erstellte Namen statt Argumentinhalte, auch wenn das Flag aus ist. Diese Daten werden nur an den OTEL-Endpunkt gesendet, den Sie konfigurieren, niemals an Anthropic. Argumente können immer noch vertrauliche Werte enthalten, daher konfigurieren Sie Ihr Telemetrie-Backend, um diese Attribute nach Bedarf zu filtern oder zu schwärzen. Wenn aktiviert:

1828 * `tool_result`- und `tool_decision`-Ereignisse enthalten ein `tool_parameters`-Attribut mit Bash-Befehlen, MCP-Server- und Tool-Namen sowie Skill-Namen. Felder wie `full_command` werden ungekürzt ausgegeben1865 * `tool_result`- und `tool_decision`-Ereignisse enthalten ein `tool_parameters`-Attribut mit Bash-Befehlen, MCP-Server- und Tool-Namen sowie Skill-Namen. Felder wie `full_command` werden ungekürzt ausgegeben

1829 * `tool_result`-Ereignisse enthalten zusätzlich ein `tool_input`-Attribut mit Dateipfaden, URLs, Suchmustern und anderen Argumenten. Einzelne Werte über 512 Zeichen werden gekürzt und die Gesamtmenge ist auf etwa 4 K Zeichen begrenzt1866 * `tool_result`-Ereignisse enthalten zusätzlich ein `tool_input`-Attribut mit Dateipfaden, URLs, Suchmustern und anderen Argumenten. Einzelne Werte über 512 Zeichen werden gekürzt und die Gesamtmenge ist auf etwa 4 K Zeichen begrenzt

1830 * `user_prompt`-Ereignisse enthalten den wörtlichen `command_name` für benutzerdefinierte, Plugin- und MCP-Befehle1867 * `user_prompt`-Ereignisse enthalten den wörtlichen `command_name` für benutzerdefinierte, Plugin- und MCP-Befehle

network-config.md +18 −18

Details

203 Streaming-Idle-Watchdogs203 Streaming-Idle-Watchdogs

204</h2>204</h2>

205 205 

206Claude Code führt vier unabhängige Timer aus, die eine Streaming-Modellantwort abbrechen, wenn sie stille wird, sodass eine unterbrochene Verbindung fehlschlägt und erneut versucht wird, anstatt zu hängen. Eine Anfrage, die überhaupt keine Antwortheader erhält, endet auf eine von zwei Arten:206Claude Code betreibt vier unabhängige Timer, die eine streamende Modellantwort abbrechen, wenn sie verstummt, sodass eine tote Verbindung fehlschlägt und erneut versucht wird, statt zu hängen. Eine Anfrage, die überhaupt keine Response-Header erhält, endet auf eine von zwei Arten:

207 207 

208* **Wo die First-Byte-Frist läuft**: Der erste Versuch endet bei dieser Frist. Um sie zu ändern, setzen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`. Zur Wartezeit des Wiederholungsversuchs siehe [Keine Antwort von API](/docs/de/errors#no-response-from-api).208* **Wo die First-Byte-Frist läuft**: Der erste Versuch endet mit Ablauf dieser Frist. Um sie zu ändern, setzen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`. Zur Wartezeit des Wiederholungsversuchs siehe [No response from API](/docs/de/errors#no-response-from-api).

209* **Bei den anderen Verbindungen**: Die Anfrage endet nach 5 bis 6 Minuten, wenn das Body-Idle-Timeout auslöst, es sei denn, Sie haben dieses Timeout ausgeschaltet. Um sie früher zu beenden, senken Sie `API_TIMEOUT_MS`.209* **Auf den anderen Verbindungen**: Die Anfrage endet nach 5 bis 6 Minuten, wenn der Body-Idle-Timeout auslöst, sofern Sie diesen Timeout nicht ausgeschaltet haben. Um sie früher zu beenden, verringern Sie `API_TIMEOUT_MS`.

210 210 

211| Timer | Bricht ab, wenn | Läuft auf | Standard-Timeout |211| Timer | Bricht ab, wenn | Läuft auf | Standard-Timeout |

212| :- | :- | :- | :- |212| :- | :- | :- | :- |

213| First-Byte-Frist | Keine Antwortheader kommen an, nachdem Claude Code die Anfrage sendet | Direkte Anthropic-API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws), einschließlich durch einen HTTPS-Proxy, aber nicht, wenn `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` sie durch ein [Gateway](/docs/de/gateways) leiten. Opt-in auf Amazon Bedrock mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; läuft nicht auf Google Cloud's Agent Platform oder Microsoft Foundry und nicht in einer [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzung | 180 Sekunden auf der direkten Anthropic-API, 300 Sekunden anderswo, plus eine Sekunde pro 32 KB Anfragekörper |213| First-Byte-Frist | Nach dem Senden der Anfrage durch Claude Code keine Response-Header eintreffen | Direkte Anthropic API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws), auch über einen HTTPS-Proxy, jedoch nicht, wenn `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` sie über ein [Gateway](/docs/de/gateways) leiten. Auf Amazon Bedrock per Opt-in mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; läuft nicht auf der Agent Platform von Google Cloud oder Microsoft Foundry oder in einer [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzung | 180 Sekunden auf der direkten Anthropic API, 300 Sekunden anderswo, zuzüglich einer Sekunde pro 32 KB Request-Body |

214| Event-Level-Watchdog | Keine Antwortereignisse werden analysiert. Bei Verbindungen, bei denen der Byte-Level-Watchdog läuft, setzen ankommende Bytes, einschließlich Keep-Alive-Pings, auch diesen Watchdog zurück, für bis zu etwa fünf Minuten ohne ein analysiertes Ereignis | Jeder Anbieter | 300 Sekunden |214| Watchdog auf Ereignisebene | Keine Antwortereignisse geparst werden. Wo der Watchdog auf Byte-Ebene auf einer anderen Verbindung als Amazon Bedrock läuft, setzen eintreffende Bytes, einschließlich Keep-alive-Pings, diesen Watchdog ebenfalls zurück, und zwar für bis zu etwa fünf Minuten ohne geparstes Ereignis | Jedem Anbieter | 300 Sekunden |

215| Byte-Level-Watchdog | Keine Bytes kommen auf der Leitung an, einschließlich SSE-Keep-Alive-Pings | Direkte Anthropic-API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und [Gateway](/docs/de/gateways)-Verbindungen, einschließlich einer benutzerdefinierten `ANTHROPIC_BASE_URL`. Opt-in auf Amazon Bedrock `vnd.amazon.eventstream`-Antworten mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; läuft nicht auf Google Cloud's Agent Platform oder Microsoft Foundry | 180 Sekunden auf der direkten Anthropic-API. 300 Sekunden auf Claude Platform on AWS, auf Amazon Bedrock, in einer [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzung und über eine benutzerdefinierte `ANTHROPIC_BASE_URL` |215| Watchdog auf Byte-Ebene | Keine Bytes auf der Leitung eintreffen, einschließlich SSE-Keep-alive-Pings | Direkte Anthropic API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und [Gateway](/docs/de/gateways)-Verbindungen, einschließlich einer benutzerdefinierten `ANTHROPIC_BASE_URL`. Auf Amazon-Bedrock-Antworten vom Typ `vnd.amazon.eventstream` per Opt-in mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; läuft nicht auf der Agent Platform von Google Cloud oder Microsoft Foundry | 180 Sekunden auf der direkten Anthropic API. 300 Sekunden auf Claude Platform on AWS, auf Amazon Bedrock, in einer [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzung und über eine benutzerdefinierte `ANTHROPIC_BASE_URL` |

216| Body-Idle-Timeout | Keine Bytes kommen für 5 Minuten an, einschließlich der Wartezeit auf Antwortheader | Anbieter außer der direkten Anthropic-API, Claude Platform on AWS und Amazon Bedrock mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` gesetzt, es sei denn, [`API_FORCE_IDLE_TIMEOUT`](/docs/de/env-vars) ändert das | 5 Minuten |216| Body-Idle-Timeout | 5 Minuten lang keine Bytes eintreffen, einschließlich der Wartezeit auf Response-Header | Anderen Anbietern als der direkten Anthropic API, Claude Platform on AWS und Amazon Bedrock mit gesetztem `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, sofern [`API_FORCE_IDLE_TIMEOUT`](/docs/de/env-vars) dies nicht ändert | 5 Minuten |

217 217 

218Wenn Sie `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` setzen, ersetzt der Byte-Level-Watchdog das Body-Idle-Timeout auf Bedrock, anstatt neben ihm zu laufen. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` regelt dann auch, wie lange ein Bedrock-Stream stille bleiben darf, bevor Claude Code die Verbindung als unterbrochen behandelt, innerhalb der unten aufgelisteten Grenzen. Ankommende Bytes setzen den Event-Level-Watchdog auf Bedrock immer noch nicht zurück. Mit Debug-Logging aktiviert, protokolliert dann jeder Bedrock-Stream eine Debug-Nachricht, die mit `wire-heartbeat: _chunkTimes absent` beginnt.218Wenn Sie `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` setzen, ersetzt der Watchdog auf Byte-Ebene auf Bedrock den Body-Idle-Timeout, statt parallel dazu zu laufen. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` bestimmt dann auch, wie lange ein Bedrock-Stream still bleiben darf, bevor Claude Code die Verbindung als tot betrachtet, innerhalb der unten aufgeführten Grenzen. Eintreffende Bytes setzen den Watchdog auf Ereignisebene auf Bedrock weiterhin nicht zurück. Bei aktiviertem Debug-Logging protokolliert dann jeder Bedrock-Stream eine Debug-Meldung, die mit `wire-heartbeat: _chunkTimes absent` beginnt.

219 219 

220Konfigurieren Sie die Timer mit diesen Variablen, die jeweils in der [Referenz für Umgebungsvariablen](/docs/de/env-vars) detailliert beschrieben sind:220Konfigurieren Sie die Timer mit diesen Variablen, die jeweils in der [Referenz der Umgebungsvariablen](/docs/de/env-vars) beschrieben sind:

221 221 

222* `CLAUDE_ENABLE_STREAM_WATCHDOG` und `CLAUDE_ENABLE_BYTE_WATCHDOG` erzwingen den entsprechenden Watchdog mit `1` ein oder mit `0` aus, innerhalb der Verbindungen, die die Tabelle auflistet; keine Variable erweitert einen Watchdog auf einen Verbindungstyp, den er nicht abdeckt. `CLAUDE_ENABLE_BYTE_WATCHDOG` auf `0` gesetzt schaltet auch die First-Byte-Frist aus.222* `CLAUDE_ENABLE_STREAM_WATCHDOG` und `CLAUDE_ENABLE_BYTE_WATCHDOG` schalten den entsprechenden Watchdog mit `1` zwangsweise ein oder mit `0` aus, und zwar innerhalb der Verbindungen, die die Tabelle aufführt; keine der beiden Variablen erweitert einen Watchdog auf einen Verbindungstyp, den er nicht abdeckt. `CLAUDE_ENABLE_BYTE_WATCHDOG` auf `0` gesetzt schaltet auch die First-Byte-Frist aus.

223* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` setzt das Timeout beider Watchdogs. Claude Code erhöht Werte unter 5 Minuten auf 5 Minuten und begrenzt den Wert auf 30 Minuten für den Byte-Level-Watchdog.223* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` legt den Timeout beider Watchdogs fest. Claude Code hebt Werte unter 5 Minuten auf 5 Minuten an und begrenzt den Wert für den Watchdog auf Byte-Ebene auf 30 Minuten.

224* `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` setzt das Timeout des Byte-Level-Watchdogs, ohne das Timeout des Event-Level-Watchdogs zu ändern, begrenzt auf zwischen 10 Sekunden und 30 Minuten, und hat Vorrang vor `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für diesen Watchdog.224* `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` legt den Timeout des Watchdogs auf Byte-Ebene fest, ohne den des Watchdogs auf Ereignisebene zu ändern, begrenzt auf einen Wert zwischen 10 Sekunden und 30 Minuten, und hat für diesen Watchdog Vorrang vor `CLAUDE_STREAM_IDLE_TIMEOUT_MS`.

225* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` setzt die First-Byte-Frist direkt. Lassen Sie sie ungesetzt und Claude Code verwendet das Timeout des Byte-Level-Watchdogs, sodass `CLAUDE_STREAM_IDLE_TIMEOUT_MS` und `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` die Frist auch ändern. Für die Begrenzungen, die Upload-Zulage, die `API_TIMEOUT_MS`-Obergrenze und wie lange das Retry nach einem No-Response-Abbruch wartet, siehe [Keine Antwort von API](/docs/de/errors#no-response-from-api).225* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` legt die First-Byte-Frist direkt fest. Wenn Sie sie nicht setzen, verwendet Claude Code den Timeout des Watchdogs auf Byte-Ebene, sodass `CLAUDE_STREAM_IDLE_TIMEOUT_MS` und `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` die Frist ebenfalls ändern. Zu den Begrenzungen, dem Upload-Zuschlag, der Obergrenze durch `API_TIMEOUT_MS` und dazu, wie lange der Wiederholungsversuch nach einem Abbruch ohne Antwort wartet, siehe [No response from API](/docs/de/errors#no-response-from-api).

226* `API_TIMEOUT_MS` begrenzt das Warten auf Antwortheader. Wo die First-Byte-Frist nicht läuft, etwa in einer Claude-Apps-Gateway-Sitzung, setzen Sie den Wert unter `300000`, also 5 Minuten, um eine unbeantwortete Anfrage früher erneut zu versuchen. Halten Sie ihn über der längsten Wartezeit auf Header und der längsten [Nicht-Streaming-Anfrage](/docs/de/errors#streaming-response-ended-before-any-complete-data-was-received), die Sie erwarten: Eine Anfrage, die länger braucht, läuft bei jedem Wiederholungsversuch erneut in eine Zeitüberschreitung.226* `API_TIMEOUT_MS` begrenzt die Wartezeit auf Response-Header, nicht wie lange eine Antwort danach streamt. Wo die First-Byte-Frist nicht läuft, etwa in einer Claude-Apps-Gateway-Sitzung, setzen Sie den Wert unter `300000`, also 5 Minuten, um eine unbeantwortete Anfrage früher erneut zu versuchen. Halten Sie ihn über der längsten Wartezeit auf Header und der längsten [Nicht-Streaming-Anfrage](/docs/de/errors#streaming-response-ended-before-any-complete-data-was-received), die Sie erwarten: Eine Anfrage, die länger braucht, läuft bei jedem Wiederholungsversuch erneut in den Timeout.

227* `API_FORCE_IDLE_TIMEOUT` auf `0` gesetzt schaltet das Body-Idle-Timeout aus, und auf `1` gesetzt schaltet es für jeden Anbieter ein. Die Watchdogs laufen unabhängig davon, sodass Sie, um einen Stream länger als ihre Schwellwerte pausieren zu lassen, auch diese erhöhen oder deaktivieren müssen.227* `API_FORCE_IDLE_TIMEOUT` auf `0` gesetzt schaltet den Body-Idle-Timeout aus, und auf `1` gesetzt schaltet es ihn für jeden Anbieter ein. Die Watchdogs laufen unabhängig davon; damit ein Stream länger als ihre Schwellenwerte pausieren kann, müssen Sie sie also ebenfalls erhöhen oder deaktivieren.

228 228 

229Wenn ein Watchdog einen stagnierenden Stream abbricht, behandelt Claude Code den Abbruch als einen Mid-Stream-Fehler, und was Sie sehen, hängt davon ab, wie weit die Antwort gekommen war. Claude Code versucht die Anfrage erneut oder beendet den Turn mit einem Fehler, behält die abgeschlossene Ausgabe und zeigt eine [Mitteilung über unvollständige Antwort](/docs/de/errors#the-response-above-may-be-incomplete) an, oder beendet den Turn normal. [Automatische Wiederholungen](/docs/de/errors#automatic-retries) sagt, wo jedes Ergebnis zutrifft.229Wenn ein Watchdog einen blockierten Stream abbricht, behandelt Claude Code den Abbruch als Fehler während des Streams, und was Sie sehen, hängt davon ab, wie weit die Antwort bereits gekommen war. Claude Code versucht die Anfrage erneut oder beendet den Turn mit einem Fehler, behält die abgeschlossene Ausgabe und zeigt einen [Hinweis auf eine unvollständige Antwort](/docs/de/errors#the-response-above-may-be-incomplete) an oder beendet den Turn normal. [Automatische Wiederholungsversuche](/docs/de/errors#automatic-retries) erläutert, wo welches Ergebnis gilt.

230 230 

231In einer [nicht-interaktiven Sitzung](/docs/de/headless) und für die Antwort eines Subagenten in jeder Sitzung kann Claude Code zuerst Claude auffordern, die abgeschnittene Antwort fortzusetzen; [der Eintrag dieser Mitteilung](/docs/de/errors#the-response-above-may-be-incomplete) sagt, wann dies der Fall ist und wann Sie die Mitteilung immer noch sehen.231In einer [nicht interaktiven Sitzung](/docs/de/headless) sowie bei der Antwort eines Subagenten in jeder Sitzung fordert Claude Code Claude möglicherweise zunächst per Prompt auf, die abgeschnittene Antwort fortzusetzen; [der Eintrag zu diesem Hinweis](/docs/de/errors#the-response-above-may-be-incomplete) erläutert, wann dies geschieht und wann Sie den Hinweis dennoch sehen.

232 232 

233Wenn die First-Byte-Frist abläuft, hat keine Antwort begonnen, daher gibt es keine Teilausgabe zu behalten. Für die Art und Weise, wie Claude Code die Anfrage erneut sendet und wann der Turn stattdessen endet, siehe [Keine Antwort von API](/docs/de/errors#no-response-from-api).233Wenn die First-Byte-Frist auslöst, hat noch keine Antwort begonnen, sodass es keine Teilausgabe gibt, die behalten werden könnte. Wie Claude Code die Anfrage erneut sendet und wann stattdessen der Turn endet, erfahren Sie unter [No response from API](/docs/de/errors#no-response-from-api).

234 234 

235<h2 id="network-access-requirements">235<h2 id="network-access-requirements">

236 Anforderungen für Netzwerkzugriff236 Anforderungen für Netzwerkzugriff

Details

86| Wie Sie Claude Code ausführen | Integrierter Start-Berechtigungsmodus |86| Wie Sie Claude Code ausführen | Integrierter Start-Berechtigungsmodus |

87| :- | :- |87| :- | :- |

88| Eine Einstellungsdatei setzt `disableAutoMode` auf `"disable"` | `default` |88| Eine Einstellungsdatei setzt `disableAutoMode` auf `"disable"` | `default` |

89| `claude -p` oder das [Agent SDK](/docs/de/agent-sdk/permissions#permission-modes) | `default` in Sitzungen, die [Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching). In Sitzungen, die dies nicht tun, wie bei einem Drittanbieter oder mit deaktivierter Telemetrie, `auto` mit Claude Code v2.1.285 oder später und `default` bei früheren Versionen. Eine Sitzung in einer Organisation, deren Richtlinie den `auto` Standard vorenthält, startet stattdessen in `default` |89| `claude -p` oder das [Agent SDK](/docs/de/agent-sdk/permissions#permission-modes) | `default` |

90| Auf Ihre Organisation ist die [HIPAA-Konfiguration](#hipaa-configuration) angewendet und die Sitzung ist [dafür berechtigt](/docs/de/hipaa-setup#check-how-developers-sign-in-and-connect) | `default` mit Claude Code v2.1.285 oder später; der Auto-Modus bleibt verfügbar, um dorthin zu wechseln |90| Auf Ihre Organisation ist die [HIPAA-Konfiguration](#hipaa-configuration) angewendet und die Sitzung ist [dafür berechtigt](/docs/de/hipaa-setup#check-how-developers-sign-in-and-connect) | `default` mit Claude Code v2.1.285 oder später; der Auto-Modus bleibt verfügbar, um dorthin zu wechseln |

91| In einem Terminal oder über die [VS Code-Erweiterung](/docs/de/vs-code) | `auto` mit Claude Code v2.1.283 oder später; bei früheren Versionen `auto` bei Pro-, Max- oder Team-Plänen in Sitzungen, die [Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), und `default` andernfalls |91| In einem Terminal oder über die [VS Code-Erweiterung](/docs/de/vs-code) | `auto` mit Claude Code v2.1.283 oder später; bei früheren Versionen `auto` bei Pro-, Max- oder Team-Plänen in Sitzungen, die [Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), und `default` andernfalls |

92 92 

93In Ihrer [ersten Sitzung nach einer Installation oder einem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade) kann Claude Code den Start-Berechtigungsmodus wählen, bevor seine Feature-Flags ankommen. Diese Sitzung kann in einem anderen Berechtigungsmodus starten als die Tabelle angibt.

94 

95Wenn das Flag, eine Einstellungsdatei oder der integrierte Standard `auto` auswählt, aber Auto-Modus nicht für die Sitzung verfügbar ist, startet Claude Code die Sitzung stattdessen im Manual-Modus. Auto-Modus ist nicht verfügbar, wenn die Sitzung die [Verfügbarkeitsanforderungen](#eliminate-prompts-with-auto-mode) nicht erfüllt, wie eine Einstellungsdatei, die ihn ausschaltet, oder ein Modell, das ihn nicht unterstützt, oder wenn Anthropic ihn vorübergehend serverseitig ausgeschaltet hat.93Wenn das Flag, eine Einstellungsdatei oder der integrierte Standard `auto` auswählt, aber Auto-Modus nicht für die Sitzung verfügbar ist, startet Claude Code die Sitzung stattdessen im Manual-Modus. Auto-Modus ist nicht verfügbar, wenn die Sitzung die [Verfügbarkeitsanforderungen](#eliminate-prompts-with-auto-mode) nicht erfüllt, wie eine Einstellungsdatei, die ihn ausschaltet, oder ein Modell, das ihn nicht unterstützt, oder wenn Anthropic ihn vorübergehend serverseitig ausgeschaltet hat.

96 94 

97Das erste Mal, wenn der integrierte Standard eine Ihrer Sitzungen im Auto-Modus startet, zeigt Claude Code einen Hinweis, der auf diese Seite verlinkt:95Das erste Mal, wenn der integrierte Standard eine Ihrer Sitzungen im Auto-Modus startet, zeigt Claude Code einen Hinweis, der auf diese Seite verlinkt:


101 99 

102Wenn Ihre `~/.claude/settings.json` einen `defaultMode` setzt, der nicht `auto` ist, und keine andere Einstellungsdatei setzt einen, starten Ihre Sitzungen weiterhin in diesem Modus. Bei Pro-, Max- und Team-Plänen und in Sitzungen, die [keine Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), fragt Claude Code einmal, im Terminal oder in der VS Code-Erweiterung, ob die Einstellung auf Auto-Modus geändert werden soll. Wenn Sie ablehnen, bleibt Ihre Einstellung wie sie ist.100Wenn Ihre `~/.claude/settings.json` einen `defaultMode` setzt, der nicht `auto` ist, und keine andere Einstellungsdatei setzt einen, starten Ihre Sitzungen weiterhin in diesem Modus. Bei Pro-, Max- und Team-Plänen und in Sitzungen, die [keine Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), fragt Claude Code einmal, im Terminal oder in der VS Code-Erweiterung, ob die Einstellung auf Auto-Modus geändert werden soll. Wenn Sie ablehnen, bleibt Ihre Einstellung wie sie ist.

103 101 

102<h3 id="which-mode-a-non-interactive-run-starts-in">

103 Abgelehnte Tool-Aufrufe in `claude -p`- und Agent SDK-Ausführungen

104</h3>

105 

106In Claude Code v2.1.302 oder später starten `claude -p`- und [Agent SDK](/docs/de/agent-sdk/permissions#permission-modes)-Ausführungen [ohne festgelegten Berechtigungsmodus](#which-mode-a-session-starts-in) im Manual-Modus. Dieser Modus erscheint in SDK-Optionen und Einstellungen als `default`. Aufrufe, die eine Genehmigung erfordern, werden abgelehnt, sofern Sie sie nicht mit einer Allow-Regel, einem Hook, einem `canUseTool`-Callback oder `--permission-prompt-tool` genehmigen.

107 

108Um diese Aufrufe genehmigen zu lassen, fügen Sie Allow-Regeln hinzu oder starten Sie im Auto-Modus:

109 

110* **[Allow-Regeln hinzufügen](/docs/de/permissions#manage-permissions)**: Claude führt die Aufrufe aus, die Sie auflisten. Übergeben Sie [`--allowedTools "Bash(npm test)"`](/docs/de/headless#auto-approve-tools) an `claude -p` oder setzen Sie die [Option für erlaubte Tools](/docs/de/agent-sdk/permissions#allow-and-deny-rules) Ihres SDK.

111* **Im [Auto-Modus](#eliminate-prompts-with-auto-mode) starten**: Ein Klassifikator-Modell prüft die Aufrufe, sodass Sie vorab nichts auflisten müssen. Übergeben Sie `--permission-mode auto` an `claude -p` oder setzen Sie die [Option für den Berechtigungsmodus](/docs/de/agent-sdk/permissions#set-permission-mode) Ihres SDK.

112 

113Diese Beispiele zeigen die Auto-Modus-Variante für die CLI und jedes SDK:

114 

115<Tabs>

116 <Tab title="CLI">

117 ```bash theme={null}

118 claude -p "Run the test suite and fix any failures" --permission-mode auto

119 ```

120 </Tab>

121 

122 <Tab title="TypeScript">

123 ```typescript theme={null}

124 const options = {

125 permissionMode: "auto"

126 };

127 ```

128 </Tab>

129 

130 <Tab title="Python">

131 ```python theme={null}

132 from claude_agent_sdk import ClaudeAgentOptions

133 

134 options = ClaudeAgentOptions(permission_mode="auto")

135 ```

136 </Tab>

137</Tabs>

138 

139Vor v2.1.302 konnten diese Ausführungen im Auto-Modus starten, wenn sie keine [Feature-Flags abriefen](/docs/de/env-vars#features-that-need-feature-flag-fetching), zum Beispiel bei einem [Drittanbieter](/docs/de/third-party-integrations) oder mit `DISABLE_TELEMETRY`.

140 

104<h3 id="start-in-a-different-mode">141<h3 id="start-in-a-different-mode">

105 Starten Sie in einem anderen Berechtigungsmodus142 Starten Sie in einem anderen Berechtigungsmodus

106</h3>143</h3>


216 </Tab>253 </Tab>

217 254 

218 <Tab title="Desktop">255 <Tab title="Desktop">

219 **Während einer Sitzung**: Verwenden Sie auf der Registerkarte Code den Moduswahlschalter neben der Schaltfläche zum Senden. Nicht jeder Modus wird im Wahlschalter angezeigt:256 **Während einer Sitzung**: Verwenden Sie auf der Registerkarte Code den Moduswahlschalter in der Zeile unter dem Eingabefeld. Nicht jeder Modus wird im Wahlschalter angezeigt:

220 257 

221 * **Auto**: wird angezeigt, wenn [Auto-Modus verfügbar ist](#eliminate-prompts-with-auto-mode)258 * **Auto**: wird angezeigt, wenn [Auto-Modus verfügbar ist](#eliminate-prompts-with-auto-mode)

222 * **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 gesteuert259 * **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


345 Auto-Modus auf Bedrock, Agent Platform oder Foundry382 Auto-Modus auf Bedrock, Agent Platform oder Foundry

346</h3>383</h3>

347 384 

348Bei [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und angemeldeten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzungen ist der Auto-Modus standardmäßig verfügbar. Wenn nichts anderes einen Berechtigungsmodus setzt, ist er auch der [integrierte Standard-Berechtigungsmodus](#which-mode-a-session-starts-in), auf den Versionen, die die Tabelle jenes Abschnitts auflistet. Um den Standard-Berechtigungsmodus selbst zu wählen, setzen Sie `permissions.defaultMode` wie in [In einem anderen Berechtigungsmodus starten](#start-in-a-different-mode) beschrieben, oder wählen Sie einen Berechtigungsmodus aus dem Modus-Indikator der VS Code-Erweiterung.385Bei [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und angemeldeten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzungen ist der Auto-Modus standardmäßig verfügbar. Wenn Sie dort keinen Berechtigungsmodus setzen, starten interaktive Sitzungen im Auto-Modus, und `claude -p`- oder Agent SDK-Läufe starten im Manual-Modus, dessen Konfigurationswert `default` ist:

386 

387* **Interaktive Terminal- und VS Code-Sitzungen**: Um sie in einem anderen Berechtigungsmodus als auto zu starten, setzen Sie `permissions.defaultMode` wie in [In einem anderen Berechtigungsmodus starten](#start-in-a-different-mode) beschrieben, oder wählen Sie einen aus dem [Modus-Indikator](#switch-permission-modes) der VS Code-Erweiterung. [In welchem Modus eine Sitzung startet](#which-mode-a-session-starts-in) listet die Claude Code-Versionen auf, die sie im Auto-Modus starten.

388* **`claude -p`- und Agent SDK-Läufe**: Um einen Lauf im Auto-Modus zu starten, übergeben Sie `--permission-mode auto` an `claude -p`, oder übergeben Sie `permissionMode: "auto"` in TypeScript bzw. `permission_mode="auto"` in Python. Wenn Sie keinen Berechtigungsmodus übergeben, siehe [Tool-Aufrufe in `claude -p`- und Agent SDK-Läufen verweigert](#which-mode-a-non-interactive-run-starts-in), wo auch frühere Claude Code-Versionen behandelt werden.

349 389 

350Nur Claude Sonnet 5 oder später, Opus 4.7 oder später, Haiku 5.5 und die Fable-Modelle werden auf diesen Anbietern unterstützt. Bei jedem anderen Modell startet die Sitzung stattdessen im Manual-Modus. Der Auto-Modus mit Haiku 5.5 auf diesen Anbietern erfordert Claude Code v2.1.293 oder später.390Nur Claude Sonnet 5 oder später, Opus 4.7 oder später, Haiku 5.5 und die Fable-Modelle werden auf diesen Anbietern unterstützt. Bei jedem anderen Modell startet die Sitzung stattdessen im Manual-Modus. Der Auto-Modus mit Haiku 5.5 auf diesen Anbietern erfordert Claude Code v2.1.293 oder später.

351 391 


368 408 

369Um die Anfrage beim Server zu überspringen und immer die eigenen Klassifikatoranfragen von Claude Code zu verwenden, setzen Sie [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/de/env-vars). Bei einer direkten Verbindung zur Anthropic API erfordert die Variable Claude Code v2.1.281 oder später. Wenn Sie sie dort auf `1` setzen, wird die Serverüberprüfung in einer Sitzung aktiviert, die sie noch nicht hat, es sei denn, Sie haben auch `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` gesetzt. Wenn Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` setzen und `CLAUDE_CODE_AUTO_MODE_SERVER` nicht setzen, fragt Claude Code ebenfalls nicht mehr beim Server an, außer wie in [Vorabversions-Funktionen deaktivieren](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) beschrieben.409Um die Anfrage beim Server zu überspringen und immer die eigenen Klassifikatoranfragen von Claude Code zu verwenden, setzen Sie [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/de/env-vars). Bei einer direkten Verbindung zur Anthropic API erfordert die Variable Claude Code v2.1.281 oder später. Wenn Sie sie dort auf `1` setzen, wird die Serverüberprüfung in einer Sitzung aktiviert, die sie noch nicht hat, es sei denn, Sie haben auch `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` gesetzt. Wenn Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` setzen und `CLAUDE_CODE_AUTO_MODE_SERVER` nicht setzen, fragt Claude Code ebenfalls nicht mehr beim Server an, außer wie in [Vorabversions-Funktionen deaktivieren](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) beschrieben.

370 410 

411<h3 id="default-classifier-model">

412 Standard-Klassifikatormodell

413</h3>

414 

415Standardmäßig gehen Klassifikatoranfragen an Claude Sonnet 5. Wenn `/status` `Auto mode server` als `Enabled` anzeigt, werden sie nur für Aufrufe außerhalb [der Überprüfung durch den Server](#server-side-classifier-review) gesendet.

416 

417Suchen Sie die erste Zeile in dieser Tabelle, die auf Ihre Sitzung zutrifft. Sie erhalten das Modell dieser Zeile statt Sonnet 5.

418 

419| Ihre Sitzung | Klassifikatormodell |

420| - | - |

421| Hat ein von Anthropic konfiguriertes Klassifikatormodell | Das konfigurierte Modell. [Prüfen Sie das Debug-Log](#classifier-model-check), um zu sehen, welches |

422| Läuft auf Claude Sonnet 4.6 | Sonnet 4.6 |

423| Hat [`ANTHROPIC_DEFAULT_SONNET_MODEL`](/docs/de/model-config#environment-variables) gesetzt | Dessen Wert, oder Sonnet 5, wenn der Wert Claude Sonnet 5.5 oder Claude Opus 5.5 ist |

424 

425Wenn Sonnet 5 oder das Modell in `ANTHROPIC_DEFAULT_SONNET_MODEL` bei Ihrem Anbieter nicht verfügbar ist oder durch die [Modellrichtlinie](/docs/de/model-config#restrict-model-selection) Ihrer Organisation ausgeschlossen wird, verwendet Claude Code ein Fallback-Modell. Das ist das Modell Ihrer Sitzung oder ein Opus-Modell in einer [Fable-Sitzung](/docs/de/model-config#work-with-fable).

426 

427<h3 id="choose-the-classifier-model">

428 Klassifikatormodell wählen

429</h3>

430 

431Setzen Sie mit Claude Code v2.1.302 oder später [`CLAUDE_CODE_AUTO_MODE_MODEL`](/docs/de/env-vars) auf eine vollständige Modell-ID, um den Klassifikator auf einem anderen Modell als dem [Standard](#default-classifier-model) auszuführen. Die eigenen vollständigen Modell-IDs Ihres Cloud-Anbieters funktionieren ebenfalls. Dieses `~/.claude/settings.json`-Beispiel setzt Claude Sonnet 4.6:

432 

433```json theme={null}

434{

435 "env": {

436 "CLAUDE_CODE_AUTO_MODE_MODEL": "claude-sonnet-4-6"

437 }

438}

439```

440 

441<h4 id="classifier-model-not-reviewing">

442 Wenn nicht Ihr Modell überprüft

443</h4>

444 

445| Situation | Was geschieht | Was zu tun ist |

446| - | - | - |

447| In einer Sitzung zeigt `/status` [`Auto mode server`](#server-side-classifier-review) als `Enabled` | Ihr Modell überprüft nur, was der Server nicht überprüft | Nichts erforderlich |

448| Sie haben Claude Opus 5, Claude Sonnet 5.5, Claude Opus 5.5 oder ein Modell gesetzt, das die [Modellrichtlinie](/docs/de/model-config#restrict-model-selection) Ihrer Organisation ausschließt | Das [Standard-Klassifikatormodell](#default-classifier-model) überprüft | Ein anderes Modell setzen |

449| Anthropic hat für Ihre Sitzung ein Klassifikatormodell konfiguriert | Dieses Modell überprüft | Nichts erforderlich |

450| Ihr Anbieter kann das Modell nicht bereitstellen | Anfragen schlagen fehl und Claude Code [verweigert jede überprüfte Aktion](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) | Ein Modell setzen, das der Anbieter bereitstellt, oder die Variable entfernen |

451 

452<h4 id="classifier-model-check">

453 Prüfen, welches Modell der Klassifikator verwendet hat

454</h4>

455 

456Starten Sie aus Ihrer Shell eine Auto-Modus-Sitzung mit [`--debug-file`](/docs/de/cli-reference#cli-flags):

457 

458```bash theme={null}

459claude --permission-mode auto --debug-file classifier-debug.log

460```

461 

462Lassen Sie Claude einen Shell-Befehl ausführen, der nicht nur lesend ist, und durchsuchen Sie dann das Log nach `classifier_request_started`:

463 

464* **Ihr Modell nach `model=`**: Die Variable ist wirksam geworden

465* **Ein anderes Modell nach `model=`**: Durchsuchen Sie das Log nach `ignoring CLAUDE_CODE_AUTO_MODE_MODEL`; dort finden Sie den Grund und gegebenenfalls einen nötigen Schritt

466* **Keine solche Zeile**: Lesen Sie `Auto mode server` in `/status` an der Claude Code-Eingabeaufforderung ab:

467 * **`Enabled`**: Der [Server](#server-side-classifier-review) ist so eingestellt, dass er die Aufrufe dieser Sitzung überprüft. Es ist nichts zu ändern.

468 * **`Disabled`**: Stellen Sie sicher, dass der [Berechtigungsmodus](#switch-permission-modes) auto ist, und lassen Sie Claude dann einen weiteren Befehl ausführen, der nicht nur lesend ist.

469 

371<h3 id="what-the-classifier-blocks-by-default">470<h3 id="what-the-classifier-blocks-by-default">

372 Was der Klassifikator standardmäßig blockiert471 Was der Klassifikator standardmäßig blockiert

373</h3>472</h3>


384* Änderung gemeinsam genutzter Infrastruktur483* Änderung gemeinsam genutzter Infrastruktur

385* Irreversibles Zerstören von Dateien, die vor der Sitzung existierten484* Irreversibles Zerstören von Dateien, die vor der Sitzung existierten

386* Force Push485* Force Push

387* Committen oder Pushen einer Änderung, die bei ihrer Ausführung Geheimnisse oder sensible Daten aus dem Repository hinaussenden oder erweitern würde, was eine Bereitstellung offenlegt. Dies umfasst einen CI-Workflow oder eine Bereitstellungskonfiguration, die ein Geheimnis an ein Ziel übergibt, das es nicht bereits erhält, ein Skript oder einen Setup-Schritt, der einen Geheimnisspeicher liest und die Daten hinaussendet, und eine Konfigurationsänderung, die erweitert, was eine Bereitstellung veröffentlicht, etwa eine Registry-, Sichtbarkeits-, Artefakt- oder Sourcemap-Einstellung. Die Prüfung gilt auf jedem Branch, gilt auch, wenn das Repository öffentlich ist, und greift, wenn die Änderung committet oder gepusht wird, unabhängig davon, ob dieser Commit oder Push die Pipeline auslöst; um sie aufzuheben, muss der Ausführungseffekt benannt werden, nicht nur der Commit oder Push. Vor v2.1.211 war diese Prüfung stattdessen auf den Standard-Branch beschränkt: Ein Push dorthin wurde blockiert, wenn er sensiblen Inhalt enthielt, Änderungen gegenüber Ihrer Anfrage verbarg oder falsch beschrieb, von außerhalb des Repositorys übernommenen Inhalt enthielt oder eine von Ihnen verlangte Überprüfung umging486* Committen oder Pushen einer Änderung, die bei ihrer Ausführung Geheimnisse oder sensible Daten aus dem Repository hinaussenden oder erweitern würde, was eine Bereitstellung offenlegt. Dies umfasst einen CI-Workflow oder eine Bereitstellungskonfiguration, die ein Geheimnis an ein Ziel übergibt, das es nicht bereits erhält, ein Skript oder einen Setup-Schritt, der einen Geheimnisspeicher liest und die Daten hinaussendet, und eine Konfigurationsänderung, die erweitert, was eine Bereitstellung veröffentlicht, etwa eine Registry-, Sichtbarkeits-, Artefakt- oder Sourcemap-Einstellung. Die Prüfung gilt auf jedem Branch, gilt auch, wenn das Repository öffentlich ist, und greift, wenn die Änderung committet oder gepusht wird, unabhängig davon, ob dieser Commit oder Push die Pipeline auslöst; um sie aufzuheben, muss der Ausführungseffekt benannt werden, nicht nur der Commit oder Push

388* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` oder `git stash clear`, von denen der Klassifikator annimmt, dass sie nicht committete Änderungen verwerfen würden487* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` oder `git stash clear`, von denen der Klassifikator annimmt, dass sie nicht committete Änderungen verwerfen würden

389* `git commit --amend`, wenn der Commit am HEAD nicht in dieser Sitzung erstellt wurde488* `git commit --amend`, wenn der Commit am HEAD nicht in dieser Sitzung erstellt wurde

390* Ab v2.1.198 `git commit --amend`, wenn der Commit am HEAD bereits gepusht wurde. Eine reine Umformulierung der Nachricht wird nicht blockiert: `--amend -m` ohne neu gestagte Änderungen, bei einem Commit, den Claude während dieser Sitzung erstellt hat489* Ab v2.1.198 `git commit --amend`, wenn der Commit am HEAD bereits gepusht wurde. Eine reine Umformulierung der Nachricht wird nicht blockiert: `--amend -m` ohne neu gestagte Änderungen, bei einem Commit, den Claude während dieser Sitzung erstellt hat


568 </Accordion>667 </Accordion>

569 668 

570 <Accordion title="Kosten und Latenz">669 <Accordion title="Kosten und Latenz">

571 Der Klassifikator läuft standardmäßig auf Claude Sonnet 5 statt auf dem Modell, das Sie mit `/model` ausgewählt haben. Ein Klassifikatormodell, das Anthropic serverseitig konfiguriert, hat Vorrang vor diesem Standard. Wenn das Modell Ihrer Sitzung Claude Sonnet 4.6 ist oder wenn [`availableModels`](/docs/de/model-config#restrict-model-selection) Sonnet 5 ausschließt, läuft der Klassifikator stattdessen auf dem Modell der Sitzung oder auf einem Opus-Modell, wenn die Sitzung auf einem [Fable-Modell](/docs/de/model-config#work-with-fable) läuft. Bei anderen Anbietern als der Anthropic API ist dieser Opus-Fallback das Modell, das Sie in [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/de/model-config#environment-variables) festgelegt haben, oder Opus 5, wenn Sie keines festgelegt haben.670 Die Klassifikatoranfragen von Claude Code können auf einem anderen Modell als Ihrer `/model`-Auswahl laufen. Siehe [auf welchem Modell sie laufen](#default-classifier-model).

572 

573 Die erste Auto-Modus-Anfrage der Sitzung validiert den Sonnet 5-Standard: Wenn die Anfrage erfolgreich ist, bleibt Sonnet 5 das Klassifikatormodell der Sitzung, und wenn sie fehlschlägt, weil das Modell nicht verfügbar ist, verwendet die Sitzung stattdessen den Fallback.

574 671 

575 Bei Enterprise-Plänen und bei Konten, die die Claude API, [Claude Platform auf AWS](/docs/de/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden, zählen Klassifikatoraufrufe zu Ihrer Token-Nutzung. Jede Prüfung sendet einen Teil des Transkripts plus die ausstehende Aktion und fügt vor der Ausführung einen Roundtrip hinzu. Lesezugriffe und Bearbeitungen im Arbeitsverzeichnis außerhalb geschützter Pfade überspringen den Klassifikator, daher entsteht der Overhead hauptsächlich durch Shell-Befehle und Netzwerkoperationen. Wenn der Server die Aktionen als Teil der Modellanfragen der Sitzung überprüft, gibt es keine separaten Klassifikatoraufrufe, die gezählt werden; siehe [Serverseitige Klassifikatorüberprüfung](#server-side-classifier-review).672 Bei Enterprise-Plänen und bei Konten, die die Claude API, [Claude Platform auf AWS](/docs/de/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden, zählen Klassifikatoraufrufe zu Ihrer Token-Nutzung. Jede Prüfung sendet einen Teil des Transkripts plus die ausstehende Aktion und fügt vor der Ausführung einen Roundtrip hinzu. Lesezugriffe und Bearbeitungen im Arbeitsverzeichnis außerhalb geschützter Pfade überspringen den Klassifikator, daher entsteht der Overhead hauptsächlich durch Shell-Befehle und Netzwerkoperationen. Wenn der Server die Aktionen als Teil der Modellanfragen der Sitzung überprüft, gibt es keine separaten Klassifikatoraufrufe, die gezählt werden; siehe [Serverseitige Klassifikatorüberprüfung](#server-side-classifier-review).

576 673 

permissions.md +3 −3

Details

391 391 

392Claude Code prüft eingefügte Bildpfade und Verzeichnisauflistungen ab v2.1.290.392Claude Code prüft eingefügte Bildpfade und Verzeichnisauflistungen ab v2.1.290.

393 393 

394Eine `Read`-deny-Regel blockiert auch die [Edit- und Write-Tools](/docs/de/errors#file-is-covered-by-a-read-deny-rule) für denselben Pfad, einschließlich des Erstellens einer neuen Datei dort. NotebookEdit ist nicht abgedeckt, daher fügen Sie eine `Edit`-deny-Regel für Pfade hinzu, die kein Tool ändern darf. Die Prüfung erfordert Claude Code v2.1.208 oder höher für Bearbeitungen und v2.1.228 oder höher für Schreibvorgänge.394Eine `Read`-deny-Regel blockiert auch die [Edit- und Write-Tools](/docs/de/errors#file-is-covered-by-a-read-deny-rule) für denselben Pfad, einschließlich des Erstellens einer neuen Datei dort. NotebookEdit ist nicht abgedeckt, daher fügen Sie eine `Edit`-deny-Regel für Pfade hinzu, die kein Tool ändern darf. Für das Write-Tool erfordert die Prüfung Claude Code v2.1.228 oder höher.

395 395 

396Claude Code prüft Dateiberechtigungen nur anhand von `Edit(path)`- und `Read(path)`-Regeln. Wenn Sie stattdessen eine Pfadregel für `Write`, `NotebookEdit`, `Glob` oder das veraltete `MultiEdit`-Tool schreiben, akzeptiert Claude Code die Regel, berücksichtigt sie aber nie und [warnt beim Start](/docs/de/errors#is-not-matched-by-file-permission-checks), außer bei einer `Glob`-Regel, die in `--allowedTools` übergeben wird. Verwenden Sie `Edit(docs/**)` anstelle von `Write(docs/**)`, `NotebookEdit(docs/**)` oder `MultiEdit(docs/**)` und `Read(docs/**)` anstelle von `Glob(docs/**)`. Claude Code warnt nicht vor einer Regel mit Tool-Namen ohne Pfad, wie einer deny-Regel für `Write`; es gleicht diese Regel überall auf Tool-Ebene ab. Erfordert Claude Code v2.1.210 oder höher.396Claude Code prüft Dateiberechtigungen nur anhand von `Edit(path)`- und `Read(path)`-Regeln. Wenn Sie stattdessen eine Pfadregel für `Write`, `NotebookEdit`, `Glob` oder das veraltete `MultiEdit`-Tool schreiben, akzeptiert Claude Code die Regel, berücksichtigt sie aber nie und [warnt beim Start](/docs/de/errors#is-not-matched-by-file-permission-checks), außer bei einer `Glob`-Regel, die in `--allowedTools` übergeben wird. Verwenden Sie `Edit(docs/**)` anstelle von `Write(docs/**)`, `NotebookEdit(docs/**)` oder `MultiEdit(docs/**)` und `Read(docs/**)` anstelle von `Glob(docs/**)`. Claude Code warnt nicht vor einer Regel mit Tool-Namen ohne Pfad, wie einer deny-Regel für `Write`; es gleicht diese Regel überall auf Tool-Ebene ab.

397 397 

398<Warning>398<Warning>

399 Read- und Edit-deny-Regeln gelten für die integrierten Datei-Tools von Claude, für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail`, `sed` und `tee`, sowie für die Ziele von Bash-[Umleitungen](#redirections) wie `> file` und `< file`. Sie gelten nicht für einen Befehl, der Dateien liest, ohne sie zu benennen, wie `grep -r pattern .`, ausgeführt aus dem Verzeichnis, das die Datei enthält, oder für beliebige Unterprozesse, die Dateien indirekt lesen oder schreiben, wie ein Python- oder Node-Skript, das Dateien selbst öffnet. Für eine Durchsetzung auf Betriebssystemebene, die allen Prozessen den Zugriff auf einen Pfad verwehrt, [aktivieren Sie die Sandbox](/docs/de/sandboxing).399 Read- und Edit-deny-Regeln gelten für die integrierten Datei-Tools von Claude, für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail`, `sed` und `tee`, sowie für die Ziele von Bash-[Umleitungen](#redirections) wie `> file` und `< file`. Sie gelten nicht für einen Befehl, der Dateien liest, ohne sie zu benennen, wie `grep -r pattern .`, ausgeführt aus dem Verzeichnis, das die Datei enthält, oder für beliebige Unterprozesse, die Dateien indirekt lesen oder schreiben, wie ein Python- oder Node-Skript, das Dateien selbst öffnet. Für eine Durchsetzung auf Betriebssystemebene, die allen Prozessen den Zugriff auf einen Pfad verwehrt, [aktivieren Sie die Sandbox](/docs/de/sandboxing).


762 762 

763Wenn Sie Sandboxing aktivieren und `autoAllowBashIfSandboxed` auf seinen Standardwert von `true` belassen, laufen sandboxed Bash-Befehle ohne Aufforderung, selbst wenn Ihre Berechtigungen eine einfache `Bash` Ask-Regel oder die [äquivalente `Bash(*)` Form](#match-all-uses-of-a-tool) enthalten: die Sandbox-Grenze ersetzt diese Ganz-Werkzeug-Aufforderung.763Wenn Sie Sandboxing aktivieren und `autoAllowBashIfSandboxed` auf seinen Standardwert von `true` belassen, laufen sandboxed Bash-Befehle ohne Aufforderung, selbst wenn Ihre Berechtigungen eine einfache `Bash` Ask-Regel oder die [äquivalente `Bash(*)` Form](#match-all-uses-of-a-tool) enthalten: die Sandbox-Grenze ersetzt diese Ganz-Werkzeug-Aufforderung.

764 764 

765Im [Plan Mode](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) überspringt Claude Code diese Substitution. Ohne eine Ask-Regel laufen die [integrierten schreibgeschützten Befehle](#read-only-commands) weiterhin ohne Aufforderung, und alle anderen Shell-Befehle durchlaufen den regulären Berechtigungsfluss, während Sie noch planen; siehe [Plan Mode](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) für die Gating-Mechanismen von Claude Code dort. Mit einer einfachen `Bash` Ask-Regel wird jeder Bash-Befehl aufgefordert, einschließlich sandboxed schreibgeschützter Befehle, genauso wie außerhalb von Sandboxing. Vor v2.1.212 galt die Substitution auch im Plan Mode.765Im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) überspringt Claude Code diese Ersetzung. Ohne eine ask-Regel laufen die [integrierten nur lesenden Befehle](#read-only-commands) weiterhin ohne Nachfrage, und alle anderen Shell-Befehle durchlaufen den regulären Berechtigungsablauf, während Sie noch planen; unter [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) erfahren Sie, wie Claude Code Befehle dort absichert. Mit einer einfachen `Bash`-ask-Regel fragt jeder Bash-Befehl nach, einschließlich nur lesender Befehle in der Sandbox, genauso wie außerhalb von Sandboxing.

766 766 

767Diese Überprüfungen gelten weiterhin:767Diese Überprüfungen gelten weiterhin:

768 768 

Details

95 95 

96 <Steps>96 <Steps>

97 <Step title="Öffnen Sie den Plugin-Browser">97 <Step title="Öffnen Sie den Plugin-Browser">

98 Klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Plugins**, dann **Add plugin**. Der Plugin-Browser öffnet sich mit den Plugins aus Ihren Marketplaces.98 Klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Add plugins**. Wenn das Menü **+** statt **Add plugins** den Eintrag **Plugins** anzeigt, wählen Sie **Plugins** und dann **Browse plugins**. Der Plugin-Browser öffnet sich mit den Plugins aus Ihren Marketplaces.

99 </Step>99 </Step>

100 100 

101 <Step title="Wählen Sie das Plugin">101 <Step title="Wählen Sie das Plugin">

102 Finden Sie `commit-commands` und wählen Sie es aus.102 Finden Sie `commit-commands` und wählen Sie es aus.

103 </Step>103 </Step>

104 104 

105 <Step title="Wählen Sie einen Bereich">105 <Step title="Wählen Sie einen Geltungsbereich">

106 Wählen Sie einen [Bereich](#choose-an-install-scope): Ihr Benutzerkonto, dieses Projekt oder nur lokal.106 Wählen Sie einen [Geltungsbereich](#choose-an-install-scope): Ihr Benutzerkonto, dieses Projekt oder nur lokal.

107 </Step>107 </Step>

108 </Steps>108 </Steps>

109 109 

110 Um später zu aktivieren, zu deaktivieren oder zu deinstallieren, verwenden Sie **+ > Plugins > Manage plugins**. Der Plugin-Browser ist in Cloud-Sitzungen der Desktop-App nicht verfügbar. Siehe [Plugins in der Desktop-App installieren](/docs/de/desktop#install-plugins).110 Um ein Plugin später zu aktivieren, zu deaktivieren oder zu deinstallieren, siehe [Plugins in der Desktop-App installieren](/docs/de/desktop#install-plugins).

111 </Tab>111 </Tab>

112 112 

113 <Tab title="VS Code">113 <Tab title="VS Code">

Details

362 In der VS Code-Erweiterung zeichnen362 In der VS Code-Erweiterung zeichnen

363</h3>363</h3>

364 364 

365In der VS Code-Erweiterung erscheint, was ein Mod zeichnet, im Chat-Panel ab Erweiterungsversion 2.1.299, und zwar in einer Sitzung, die [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). In einem `ui.render`-Hook für das Panel ist `e.surface` gleich `vscode`. Welche Stellen und Elemente das Panel zeichnet und welche Props es ignoriert, entnehmen Sie den Tabellen der [Render-Stellen](/docs/de/plugins/mods/reference#render-sites) und der [Elemente](/docs/de/plugins/mods/reference#elements).365In der VS Code-Erweiterung erscheint, was ein Mod zeichnet, ab Erweiterungsversion 2.1.299 im Chat-Panel. Eine Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), etwa eine auf Amazon Bedrock, benötigt Version 2.1.304 oder höher. In einem `ui.render`-Hook für das Panel ist `e.surface` gleich `vscode`. Welche Stellen und Elemente das Panel zeichnet und welche Props es ignoriert, entnehmen Sie den Tabellen der [Render-Stellen](/docs/de/plugins/mods/reference#render-sites) und der [Elemente](/docs/de/plugins/mods/reference#elements).

366 366 

367Damit ein Mod sowohl im Panel als auch im Terminal funktioniert, berücksichtigen Sie diese Unterschiede:367Damit ein Mod sowohl im Panel als auch im Terminal funktioniert, berücksichtigen Sie diese Unterschiede:

368 368 

Details

219| `claude` in einem Terminal, einschließlich des integrierten Terminals eines Editors und des JetBrains-Plugins | Ja | Ja |219| `claude` in einem Terminal, einschließlich des integrierten Terminals eines Editors und des JetBrains-Plugins | Ja | Ja |

220| Der Tab „Code“ der Desktop-App, außer in einer WSL-Sitzung | Ja | Ja, außer bei Elementen, die in der [Elementtabelle](/docs/de/plugins/mods/reference#elements) als nur für das Terminal gekennzeichnet sind |220| Der Tab „Code“ der Desktop-App, außer in einer WSL-Sitzung | Ja | Ja, außer bei Elementen, die in der [Elementtabelle](/docs/de/plugins/mods/reference#elements) als nur für das Terminal gekennzeichnet sind |

221| Eine [WSL-Sitzung](/docs/de/desktop-wsl) in der Desktop-App | Nein, da Plugins in WSL-Sitzungen nicht verfügbar sind | Nein |221| Eine [WSL-Sitzung](/docs/de/desktop-wsl) in der Desktop-App | Nein, da Plugins in WSL-Sitzungen nicht verfügbar sind | Nein |

222| Das Chat-Panel der VS Code-Erweiterung | Ja | Ja, ab Erweiterungsversion 2.1.299 in einer Sitzung, die [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Die Tabellen zu [Render-Stellen](/docs/de/plugins/mods/reference#render-sites) und [Elementen](/docs/de/plugins/mods/reference#elements) kennzeichnen, was das Panel zeichnet. |222| Das Chat-Panel der VS Code-Erweiterung | Ja | Ja, ab Erweiterungsversion 2.1.299. Eine Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), etwa eine Sitzung auf Amazon Bedrock, benötigt Version 2.1.304 oder höher. Die Tabellen zu [Render-Stellen](/docs/de/plugins/mods/reference#render-sites) und [Elementen](/docs/de/plugins/mods/reference#elements) kennzeichnen, was das Panel zeichnet. |

223| `claude -p` und das [Agent SDK](/docs/de/agent-sdk/overview) | Ja | Nein |223| `claude -p` und das [Agent SDK](/docs/de/agent-sdk/overview) | Ja | Nein |

224| [Remote Control](/docs/de/remote-control) über claude.ai oder die mobile App | Ja, in der Sitzung auf Ihrem Rechner | Im Terminal auf Ihrem Rechner |224| [Remote Control](/docs/de/remote-control) über claude.ai oder die mobile App | Ja, in der Sitzung auf Ihrem Rechner | Im Terminal auf Ihrem Rechner |

225| Eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) | Ja, für ein Plugin, das [die Cloud-Sitzung erreicht](/docs/de/cloud-environments#what-carries-over-from-your-setup) | Nein |225| Eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) | Ja, für ein Plugin, das [die Cloud-Sitzung erreicht](/docs/de/cloud-environments#what-carries-over-from-your-setup) | Nein |

Details

257 257 

258Eine Render-Stelle ist ein Erweiterungspunkt in der Oberfläche von Claude Code. Jede Zeile ist ein Wert von `e.component` in einem `ui.render`-Hook, mit den Feldern von `e.props` und den Apps, die sie rendern. `e.surface` benennt die App, die zeichnet, etwa `terminal`, `desktop` oder `vscode`. [Ändern, was Claude Code bereits zeichnet](/docs/de/plugins/mods/interface#change-what-claude-code-already-draws) zeigt, was ein Hook an einer Stelle tun kann, mit einem Beispiel für jede Möglichkeit.258Eine Render-Stelle ist ein Erweiterungspunkt in der Oberfläche von Claude Code. Jede Zeile ist ein Wert von `e.component` in einem `ui.render`-Hook, mit den Feldern von `e.props` und den Apps, die sie rendern. `e.surface` benennt die App, die zeichnet, etwa `terminal`, `desktop` oder `vscode`. [Ändern, was Claude Code bereits zeichnet](/docs/de/plugins/mods/interface#change-what-claude-code-already-draws) zeigt, was ein Hook an einer Stelle tun kann, mit einem Beispiel für jede Möglichkeit.

259 259 

260Das Rendern in der VS Code-Erweiterung erfordert die Erweiterungsversion 2.1.299 oder höher sowie eine Sitzung, die [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). [In der VS Code-Erweiterung zeichnen](/docs/de/plugins/mods/interface#draw-in-the-vs-code-extension) listet auf, was die Erweiterung anders zeichnet.260Das Rendern in der VS Code-Erweiterung erfordert die Erweiterungsversion 2.1.299 oder höher. Eine Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), benötigt 2.1.304 oder höher. [In der VS Code-Erweiterung zeichnen](/docs/de/plugins/mods/interface#draw-in-the-vs-code-extension) listet auf, was die Erweiterung anders zeichnet.

261 261 

262| Stelle | `e.props` | `e.requestId` | Gerendert in |262| Stelle | `e.props` | `e.requestId` | Gerendert in |

263| :- | :- | :- | :- |263| :- | :- | :- | :- |

Details

315 315 

316* **Die Stelle oder das Element wird in dieser App nicht gezeichnet**: Suchen Sie Ihre Stelle in der Tabelle [Render-Stellen](/docs/de/plugins/mods/reference#render-sites) und Ihre Elemente in der Tabelle [Elemente](/docs/de/plugins/mods/reference#elements). Prüfen Sie bei einem Element, das die App nicht hat, `e.surface` im Hook und geben Sie einen Baum zurück, den die App zeichnen kann.316* **Die Stelle oder das Element wird in dieser App nicht gezeichnet**: Suchen Sie Ihre Stelle in der Tabelle [Render-Stellen](/docs/de/plugins/mods/reference#render-sites) und Ihre Elemente in der Tabelle [Elemente](/docs/de/plugins/mods/reference#elements). Prüfen Sie bei einem Element, das die App nicht hat, `e.surface` im Hook und geben Sie einen Baum zurück, den die App zeichnen kann.

317* **Die VS Code-Erweiterung ist älter als 2.1.299**: Das Chat-Panel zeichnet für Mods ab [Erweiterungsversion](/docs/de/vs-code#install-the-extension) 2.1.299. Prüfen Sie die Version in der Erweiterungsansicht von VS Code und aktualisieren Sie die Erweiterung dort.317* **Die VS Code-Erweiterung ist älter als 2.1.299**: Das Chat-Panel zeichnet für Mods ab [Erweiterungsversion](/docs/de/vs-code#install-the-extension) 2.1.299. Prüfen Sie die Version in der Erweiterungsansicht von VS Code und aktualisieren Sie die Erweiterung dort.

318* **Die VS Code-Sitzung ruft keine Feature-Flags ab**: Das Zeichnen im Chat-Panel erfordert dies. Sitzungen über Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry oder über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) überspringen dies, neben weiteren, die unter [Funktionen, die das Abrufen von Feature-Flags erfordern](/docs/de/env-vars#features-that-need-feature-flag-fetching) aufgeführt sind. Um die Darstellung in einer solchen Sitzung zu sehen, führen Sie `claude` stattdessen in einem Terminal aus, etwa im integrierten Terminal von VS Code.318* **Die Erweiterung ist älter als 2.1.304 und die Sitzung ruft keine Feature-Flags ab**: Aktualisieren Sie die Erweiterung, oder führen Sie `claude` stattdessen im integrierten Terminal von VS Code aus. Sitzungen über Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry überspringen den Abruf. Für die anderen, die ihn überspringen, etwa eine Sitzung über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway), siehe [Funktionen, die das Abrufen von Feature-Flags erfordern](/docs/de/env-vars#features-that-need-feature-flag-fetching).

319 319 

320<h2 id="an-edit-or-a-value-is-lost">320<h2 id="an-edit-or-a-value-is-lost">

321 Eine Änderung oder ein Wert geht verloren321 Eine Änderung oder ein Wert geht verloren

Details

40 40 

41Installieren Sie das Plugin von der Oberfläche, auf der Sie sich befinden:41Installieren Sie das Plugin von der Oberfläche, auf der Sie sich befinden:

42 42 

43* **Claude-Desktop-App, lokale oder SSH-Sitzung**: klicken Sie auf die Schaltfläche **+** neben der Eingabeaufforderung, dann **Plugins**, dann **Plugin hinzufügen**, um den [Plugin-Browser](/docs/de/desktop#install-plugins) zu öffnen43* **Claude-Desktop-App, lokale oder SSH-Sitzung**: verwenden Sie die Registerkarte **Desktop-App** unter [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin)

44* **VS Code-Erweiterung**: verwenden Sie die Registerkarte **VS Code** unter [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin)44* **VS Code-Erweiterung**: verwenden Sie die Registerkarte **VS Code** unter [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin)

45* **Claude Code im Web oder eine Desktop-Cloud-Sitzung**: eine Cloud-Sitzung hat keinen Plugin-Browser. Siehe die Registerkarte **Cloud-Sitzung** unter [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin), um zu sehen, was eine Cloud-Sitzung lädt45* **Claude Code im Web oder eine Desktop-Cloud-Sitzung**: eine Cloud-Sitzung hat keinen Plugin-Browser. Siehe die Registerkarte **Cloud-Sitzung** unter [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin), um zu sehen, was eine Cloud-Sitzung lädt

46* **Ein Terminal, auf das Sie Zugriff haben**: führen Sie `claude` aus und geben Sie dort `/plugin` ein, oder führen Sie `claude plugin install <plugin>@<marketplace>` in Ihrer Shell aus, ohne eine Sitzung zu starten46* **Ein Terminal, auf das Sie Zugriff haben**: führen Sie `claude` aus und geben Sie dort `/plugin` ein, oder führen Sie `claude plugin install <plugin>@<marketplace>` in Ihrer Shell aus, ohne eine Sitzung zu starten

Details

122mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }122mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }

123```123```

124 124 

125Sobald die Einstellungsdatei vorhanden ist, starten Sie Claude Code mit `npx` und übergeben Sie `claude` als den zu umhüllenden Befehl:125Installieren Sie die Runtime global, unter einem Präfix außerhalb aller Pfade, für die Sie Schreibzugriff erlauben:

126 126 

127```bash theme={null}127```bash theme={null}

128npx @anthropic-ai/sandbox-runtime claude128npm install -g @anthropic-ai/sandbox-runtime

129```129```

130 130 

131Claude Code startet in der Sandbox mit den Dateisystem- und Netzwerkgrenzen, die Sie konfiguriert haben. Der gleiche Befehl funktioniert zum Sandboxing eigenständiger MCP-Server oder anderer Hilfsprozesse.131Sobald die Einstellungsdatei vorhanden ist, starten Sie Claude Code aus Ihrem Projektverzeichnis durch die Runtime:

132 

133```bash theme={null}

134srt claude

135```

136 

137Claude Code startet in der Sandbox mit den Dateisystem- und Netzwerkgrenzen, die Sie konfiguriert haben. Der gleiche `srt`-Befehl funktioniert zum Sandboxing eigenständiger MCP-Server oder anderer Hilfsprozesse.

132 138 

133<h3 id="what-the-runtime-blocks-on-its-own">139<h3 id="what-the-runtime-blocks-on-its-own">

134 Was die Runtime von selbst blockiert140 Was die Runtime von selbst blockiert

Details

33 33 

34`/plugin` öffnet ein interaktives Panel in der Terminal-CLI. Wenn Claude meldet, dass `/plugin` in dieser Umgebung nicht verfügbar ist, installieren Sie auf andere Weise:34`/plugin` öffnet ein interaktives Panel in der Terminal-CLI. Wenn Claude meldet, dass `/plugin` in dieser Umgebung nicht verfügbar ist, installieren Sie auf andere Weise:

35 35 

36* **Claude-Desktop-App, lokale oder SSH-Sitzung**: öffnen Sie den [Plugin-Browser](/docs/de/desktop#install-plugins), indem Sie auf die Schaltfläche **+** neben der Eingabeaufforderung klicken, dann auf **Plugins** und dann auf **Plugin hinzufügen**36* **Claude-Desktop-App, lokale oder SSH-Sitzung**: verwenden Sie den Tab **Desktop-App** unter [Plugin installieren](/docs/de/plugins/install#install-a-plugin)

37* **VS Code-Erweiterung**: installieren Sie aus dem [Dialog **Plugins verwalten**](/docs/de/vs-code#manage-plugins)37* **VS Code-Erweiterung**: installieren Sie aus dem [Dialog **Plugins verwalten**](/docs/de/vs-code#manage-plugins)

38* **Cloud-Sitzungen**: eine Cloud-Sitzung lädt keine Plugins aus Ihren Benutzereinstellungen oder aus der Datei `.claude/settings.json` des Repositorys, wie unter [Was wird aus Ihrem Setup übernommen](/docs/de/cloud-environments#what-carries-over-from-your-setup) erläutert. Für Plugins, die Ihre Organisation über verwaltete Einstellungen verteilt, siehe [Plugins für Ihre Organisation verwalten](/docs/de/plugins/org)38* **Cloud-Sitzungen**: eine Cloud-Sitzung lädt keine Plugins aus Ihren Benutzereinstellungen oder aus der Datei `.claude/settings.json` des Repositorys, wie unter [Was wird aus Ihrem Setup übernommen](/docs/de/cloud-environments#what-carries-over-from-your-setup) erläutert. Für Plugins, die Ihre Organisation über verwaltete Einstellungen verteilt, siehe [Plugins für Ihre Organisation verwalten](/docs/de/plugins/org)

39 39 

Details

554* **Mit [`--retire-at`](/docs/de/self-hosted-environments-reference#runner-cli-flags)**: Bemessen Sie den Abstand zwischen dem Retire-Zeitpunkt und dem Stopp-Zeitpunkt des Hosts so, dass er typische Turns abdeckt, zuzüglich der Wartezeit für Hintergrundaufgaben, die unter [Runner-Lebenszyklus](/docs/de/self-hosted-environments#runner-lifecycle) beschrieben ist, zuzüglich der protokollierten Dauer. Berechnen Sie den Retire-Zeitpunkt bei jedem Start, beispielsweise `date +%s` plus die vorgesehene Lebensdauer des Runners.554* **Mit [`--retire-at`](/docs/de/self-hosted-environments-reference#runner-cli-flags)**: Bemessen Sie den Abstand zwischen dem Retire-Zeitpunkt und dem Stopp-Zeitpunkt des Hosts so, dass er typische Turns abdeckt, zuzüglich der Wartezeit für Hintergrundaufgaben, die unter [Runner-Lebenszyklus](/docs/de/self-hosted-environments#runner-lifecycle) beschrieben ist, zuzüglich der protokollierten Dauer. Berechnen Sie den Retire-Zeitpunkt bei jedem Start, beispielsweise `date +%s` plus die vorgesehene Lebensdauer des Runners.

555* **Mit [`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal)**: Das Stopp-Timeout muss zusätzlich die von Ihnen konfigurierten Minuten abdecken sowie eine weitere Wartezeit vor Beginn des Drains, mit Standardeinstellungen 75 Sekunden. [Das Leeren über das erste Signal hinaus aufschieben](#defer-the-drain-past-the-first-signal) erläutert beides. Der Runner protokolliert diese längere Dauer ebenfalls beim Start.555* **Mit [`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal)**: Das Stopp-Timeout muss zusätzlich die von Ihnen konfigurierten Minuten abdecken sowie eine weitere Wartezeit vor Beginn des Drains, mit Standardeinstellungen 75 Sekunden. [Das Leeren über das erste Signal hinaus aufschieben](#defer-the-drain-past-the-first-signal) erläutert beides. Der Runner protokolliert diese längere Dauer ebenfalls beim Start.

556 556 

557<h3 id="post-a-status-message-before-a-restart">

558 Vor einem Neustart eine Statusmeldung veröffentlichen

559</h3>

560 

561Lassen Sie vor einem Neustart, der Sitzungen unterbrechen wird, einen [Owner](/docs/de/cloud-environments#organization-shared-environments) über die [Admin-Seite **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) eine Statusmeldung für die Umgebung veröffentlichen. Unter [claude.ai/code](https://claude.ai/code) sehen Mitglieder die Meldung in ihren Sitzungen in dieser Umgebung. Lassen Sie den Owner beim Veröffentlichen ein Ablaufdatum festlegen oder die Meldung entfernen, sobald die Runner wieder verfügbar sind.

562 

557<h3 id="defer-the-drain-past-the-first-signal">563<h3 id="defer-the-drain-past-the-first-signal">

558 Das Leeren über das erste Signal hinaus aufschieben564 Das Leeren über das erste Signal hinaus aufschieben

559</h3>565</h3>


632 Pinnen Sie die Version638 Pinnen Sie die Version

633</h2>639</h2>

634 640 

635Jeder Sitzungs-Kind-Claude-Code-Prozess führt die Binärdatei des Runners selbst aus, und der Runner schaltet Auto-Update in den Sitzungen, die er spawnt, aus, daher führt jede Sitzung die Version aus, die Sie auf dem Host installiert oder in das Image eingebaut haben. Ein Host-Level-Update wird wirksam, das nächste Mal, wenn der Runner startet.641Der Kindprozess jeder Sitzung führt standardmäßig die eigene Binärdatei des Runners aus, und der Runner schaltet Auto-Update in den Sitzungen, die er startet, aus. Mit dieser Standardeinstellung führt jede Sitzung die Version aus, die Sie auf dem Host installiert oder in das Image eingebaut haben. Ein Host-Level-Update wird wirksam, das nächste Mal, wenn der Runner startet.

636 642 

637Legen Sie fest, welche Version Ihre Sitzungen ausführen und wann sie sich ändert:643Legen Sie fest, welche Version Ihre Sitzungen ausführen und wann sie sich ändert:

638 644 


640* **Um eine Flotte auf einer Version zu halten**: Erstellen Sie das Image mit einer gepinnten Version, oder installieren Sie auf einem bloßen Host eine spezifische Version und [deaktivieren Sie Auto-Updates](/docs/de/setup#disable-auto-updates)646* **Um eine Flotte auf einer Version zu halten**: Erstellen Sie das Image mit einer gepinnten Version, oder installieren Sie auf einem bloßen Host eine spezifische Version und [deaktivieren Sie Auto-Updates](/docs/de/setup#disable-auto-updates)

641* **Um eine feste Flotte zu aktualisieren**: Lesen Sie die [Changelog](/docs/en/changelog)-Einträge zwischen Ihrer Version und der Version, die Sie installieren, und installieren Sie dann die neuere Version oder bauen Sie das Image neu und starten Sie die Runner neu647* **Um eine feste Flotte zu aktualisieren**: Lesen Sie die [Changelog](/docs/en/changelog)-Einträge zwischen Ihrer Version und der Version, die Sie installieren, und installieren Sie dann die neuere Version oder bauen Sie das Image neu und starten Sie die Runner neu

642* **Um bedarfsgesteuerte Runner zu aktualisieren**: Lesen Sie die [Changelog](/docs/en/changelog)-Einträge zwischen Ihrer Version und der Version, die Sie installieren, und ändern Sie dann das Image, das Ihr [`spawn-runner`-Hook](/docs/de/self-hosted-environments-configuration#the-spawn-runner-hook) startet. Jeder neue Runner erhält die neue Version. Ein bereits laufender Runner, einschließlich eines Standby-Runners, den [`--min-idle`](/docs/de/self-hosted-environments-reference#orchestrator-cli-flags) gestartet hat, behält seine Version, bis er beendet wird. Starten Sie ihn nicht neu, da sein Arbeitsauftrag nur einmal verwendet werden kann.648* **Um bedarfsgesteuerte Runner zu aktualisieren**: Lesen Sie die [Changelog](/docs/en/changelog)-Einträge zwischen Ihrer Version und der Version, die Sie installieren, und ändern Sie dann das Image, das Ihr [`spawn-runner`-Hook](/docs/de/self-hosted-environments-configuration#the-spawn-runner-hook) startet. Jeder neue Runner erhält die neue Version. Ein bereits laufender Runner, einschließlich eines Standby-Runners, den [`--min-idle`](/docs/de/self-hosted-environments-reference#orchestrator-cli-flags) gestartet hat, behält seine Version, bis er beendet wird. Starten Sie ihn nicht neu, da sein Arbeitsauftrag nur einmal verwendet werden kann.

649* **Wenn Sitzungen eine andere Binärdatei starten**: Wenn Sie [`--exec-path`](/docs/de/self-hosted-environments-reference#runner-cli-flags) oder einen [`command`-Hook](/docs/de/self-hosted-environments-configuration#command) verwenden, um eine andere Claude-Code-Binärdatei als die des Runners zu starten, führen Sitzungen die Version dieser Binärdatei aus. Aktualisieren Sie diese Binärdatei, wenn Sie den Runner aktualisieren.

643* **Plugins**: Plugin-Marktplätze auto-updaten auch nicht; setzen Sie `FORCE_AUTOUPDATE_PLUGINS=1` in der Runner's Umgebung, um Plugins auto-updaten zu lassen, während die Binärdatei gepinnt bleibt650* **Plugins**: Plugin-Marktplätze auto-updaten auch nicht; setzen Sie `FORCE_AUTOUPDATE_PLUGINS=1` in der Runner's Umgebung, um Plugins auto-updaten zu lassen, während die Binärdatei gepinnt bleibt

644 651 

645<h2 id="scale-the-fleet">652<h2 id="scale-the-fleet">


699 * **Bevor Sie das Flag aktivieren**: Beschränken Sie, wer zu `claude/*`-Refs auf dem Quell-Remote pushen kann. Beim Fortsetzen ruft der Runner den zuvor gepushten Branch ab, ohne zu überprüfen, wer ihn gepusht hat.706 * **Bevor Sie das Flag aktivieren**: Beschränken Sie, wer zu `claude/*`-Refs auf dem Quell-Remote pushen kann. Beim Fortsetzen ruft der Runner den zuvor gepushten Branch ab, ohne zu überprüfen, wer ihn gepusht hat.

700* **Ein während der Sitzung hinzugefügtes Repository kann beim Klonen fehlschlagen**: Claude klont es mit `git clone` über HTTPS. Auf einem Runner ohne [`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) schlägt das Klonen mit einem Git-Authentifizierungsfehler fehl, wenn nichts auf dem Host das Repository lesen kann. Wählen Sie nach Möglichkeit jedes Repository, das die Sitzung benötigt, bereits beim Erstellen aus.707* **Ein während der Sitzung hinzugefügtes Repository kann beim Klonen fehlschlagen**: Claude klont es mit `git clone` über HTTPS. Auf einem Runner ohne [`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) schlägt das Klonen mit einem Git-Authentifizierungsfehler fehl, wenn nichts auf dem Host das Repository lesen kann. Wählen Sie nach Möglichkeit jedes Repository, das die Sitzung benötigt, bereits beim Erstellen aus.

701* **Einige Connectoren erscheinen nicht in selbstgehosteten Sitzungen**: Ein Connector, den Sie noch nicht in claude.ai Settings verbunden haben, wird nicht in einer selbstgehosteten Sitzung aufgelistet, und die Sitzung wird Sie nicht auffordern, ihn zu verbinden. Verbinden Sie ihn zuerst in Settings, dann starten Sie eine frische Sitzung. Das Hinzufügen eines Connectors zu einer bereits laufenden Sitzung macht seine Tools auch nicht für Claude verfügbar; starten Sie eine frische Sitzung, um einen neu hinzugefügten Connector aufzugreifen.708* **Einige Connectoren erscheinen nicht in selbstgehosteten Sitzungen**: Ein Connector, den Sie noch nicht in claude.ai Settings verbunden haben, wird nicht in einer selbstgehosteten Sitzung aufgelistet, und die Sitzung wird Sie nicht auffordern, ihn zu verbinden. Verbinden Sie ihn zuerst in Settings, dann starten Sie eine frische Sitzung. Das Hinzufügen eines Connectors zu einer bereits laufenden Sitzung macht seine Tools auch nicht für Claude verfügbar; starten Sie eine frische Sitzung, um einen neu hinzugefügten Connector aufzugreifen.

709* **Wenn jemand eine Sitzung archiviert oder löscht oder ihren Runner über das Menü der Sitzung freigibt**: Verlassen Sie sich nicht auf den Push durch [`--push-outcome-on-release`](/docs/de/self-hosted-environments-reference#runner-cli-flags). Um Commits in diesen Fällen zu sichern, pushen Sie `HEAD` aus einem [`post-session`-Hook](/docs/de/self-hosted-environments-configuration#post-session) in einen Rettungs-Branch. Wenn Sie vom dortigen Beispiel ausgehen, sorgen Sie dafür, dass es auch dann pusht, wenn nichts uncommittet ist, da es nur nach einem Snapshot-Commit pusht.

702 710 

703<h3 id="report-an-issue">711<h3 id="report-an-issue">

704 Melden Sie ein Problem712 Melden Sie ein Problem


745 Wenn jeder Aufruf etwa 30 Minuten in eine Sitzung hinein fehlschlägt, hat ein Wrapper-Skript wahrscheinlich die Sitzungs-stdin unterbrochen, daher können Token-Rotationen sie nicht erreichen; siehe [Halten Sie stdin und Dateideskriptor 3 angehängt](/docs/de/self-hosted-environments-configuration#keep-stdin-and-file-descriptor-3-attached).753 Wenn jeder Aufruf etwa 30 Minuten in eine Sitzung hinein fehlschlägt, hat ein Wrapper-Skript wahrscheinlich die Sitzungs-stdin unterbrochen, daher können Token-Rotationen sie nicht erreichen; siehe [Halten Sie stdin und Dateideskriptor 3 angehängt](/docs/de/self-hosted-environments-configuration#keep-stdin-and-file-descriptor-3-attached).

746 754 

747 Vor v2.1.274 stoppte der Runner das erneute Versuchen eines fehlgeschlagenen Abrufs nach einigen Versuchen und wartete auf den nächsten geplanten. Ein fehlgeschlagener Turn löste keinen Abruf aus, daher schlugen alle Turns mit einem 401 fehl, bis zum nächsten geplanten Abruf.755 Vor v2.1.274 stoppte der Runner das erneute Versuchen eines fehlgeschlagenen Abrufs nach einigen Versuchen und wartete auf den nächsten geplanten. Ein fehlgeschlagener Turn löste keinen Abruf aus, daher schlugen alle Turns mit einem 401 fehl, bis zum nächsten geplanten Abruf.

756* **Ein Turn schlägt in claude.ai/code mit `This model needs a newer version of Claude Code` fehl**: Die Claude Code-Version, mit der Ihre Runner Sitzungen starten, ist älter, als das Modell der Sitzung erfordert, daher [lehnt die API die Anfrage ab](/docs/de/errors#claude-code-does-not-support-this-model). Aktualisieren Sie die Runner auf die Version, die die Meldung verlangt, oder auf eine neuere, wie in [Version festlegen](#pin-the-version) beschrieben. Bis dahin können Benutzer in der Sitzung ein anderes Modell auswählen.

748* **Pod wird Mid-Drain getötet**: Erhöhen Sie `terminationGracePeriodSeconds` auf mindestens den Wert, den der Runner beim Start protokolliert. Siehe [Shutdown-Timing](#shutdown-timing).757* **Pod wird Mid-Drain getötet**: Erhöhen Sie `terminationGracePeriodSeconds` auf mindestens den Wert, den der Runner beim Start protokolliert. Siehe [Shutdown-Timing](#shutdown-timing).

749 758 

750Sobald das Logging initialisiert ist, schreibt der Runner sein Lebenszyklus-Log, einschließlich `[runner:fatal]`-Zeilen, nach stdout und Debug-Ausgabe nach stderr, alles als Plain-Text-Zeilen anstatt JSON. Die Fehler beim Basis-Verzeichnis, die in den Fehlerbehebungs-Einträgen oben beschrieben sind, werden vor diesem Punkt nach stderr ausgegeben. Erfassen Sie beide Streams mit `--log-file`, was auch `self-hosted-runner doctor` ermöglicht, sie mitzulesen, oder mit der Log-Sammlung Ihrer Plattform.759Sobald das Logging initialisiert ist, schreibt der Runner sein Lebenszyklus-Log, einschließlich `[runner:fatal]`-Zeilen, nach stdout und Debug-Ausgabe nach stderr, alles als Plain-Text-Zeilen anstatt JSON. Die Fehler beim Basis-Verzeichnis, die in den Fehlerbehebungs-Einträgen oben beschrieben sind, werden vor diesem Punkt nach stderr ausgegeben. Erfassen Sie beide Streams mit `--log-file`, was auch `self-hosted-runner doctor` ermöglicht, sie mitzulesen, oder mit der Log-Sammlung Ihrer Plattform.

Details

201* Zwischengespeicherte Einstellungen bleiben durch Netzwerkfehler bestehen. Wenn der Start-Abruf fehlschlägt, warnt Claude Code in interaktiven Sitzungen, dass die zwischengespeicherte Richtlinie wirksam ist201* Zwischengespeicherte Einstellungen bleiben durch Netzwerkfehler bestehen. Wenn der Start-Abruf fehlschlägt, warnt Claude Code in interaktiven Sitzungen, dass die zwischengespeicherte Richtlinie wirksam ist

202* Bis ein Abruf erfolgreich ist, bleiben die beim Start zurückgehaltenen Werte zurückgehalten202* Bis ein Abruf erfolgreich ist, bleiben die beim Start zurückgehaltenen Werte zurückgehalten

203 203 

204Claude Code hält mehrere Kategorien von Variablen im zwischengespeicherten `env`-Block zurück, bis der Server die Nutzlast für die Sitzung bestätigt. Dies verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Abruf der Einstellungen, der die Nutzlast bestätigt, umleitet, abfängt oder erneut authentifiziert. Die Härtung gilt nur für den vom Server abgerufenen Einstellungs-Cache: [Endpunkt-verwaltete Einstellungen](/docs/de/managed-settings#delivery-mechanisms), die über MDM oder `managed-settings.json` bereitgestellt werden, sind nicht betroffen. Das Zurückhalten erfordert Claude Code v2.1.198 oder später; vor v2.1.198 gilt der gesamte zwischengespeicherte `env`-Block beim Start. Die zurückgehaltenen Kategorien umfassen:204Claude Code hält mehrere Kategorien von Variablen im zwischengespeicherten `env`-Block zurück, bis der Server die Payload für die Sitzung bestätigt. Dies verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Abruf der Einstellungen, der die Payload bestätigt, umleitet, abfängt oder erneut authentifiziert. Die Härtung gilt nur für den vom Server abgerufenen Einstellungs-Cache: [Endpunkt-verwaltete Einstellungen](/docs/de/managed-settings#delivery-mechanisms), die über MDM oder `managed-settings.json` bereitgestellt werden, sind nicht betroffen. Die zurückgehaltenen Kategorien umfassen:

205 205 

206* Proxy- und TLS-Konfiguration, wie `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` und die mTLS-Client-Zertifikatvariablen `CLAUDE_CODE_CLIENT_CERT` und `CLAUDE_CODE_CLIENT_KEY`206* Proxy- und TLS-Konfiguration, wie `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` und die mTLS-Client-Zertifikatvariablen `CLAUDE_CODE_CLIENT_CERT` und `CLAUDE_CODE_CLIENT_KEY`

207* API-Routing und Anbieterauswahl, einschließlich `ANTHROPIC_BASE_URL`, der Anbieterauswahlvariablen wie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX` und der Anbieter-Endpunkt-URLs wie `ANTHROPIC_BEDROCK_BASE_URL`207* API-Routing und Anbieterauswahl, einschließlich `ANTHROPIC_BASE_URL`, der Anbieterauswahlvariablen wie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX` und der Anbieter-Endpunkt-URLs wie `ANTHROPIC_BEDROCK_BASE_URL`


312 312 

313Claude Code kann den Dialog nicht immer anzeigen. Jeder Fall unten sagt, welche Einstellungen gelten, wenn es nicht kann, und wann Sie den Dialog nächstes Mal sehen:313Claude Code kann den Dialog nicht immer anzeigen. Jeder Fall unten sagt, welche Einstellungen gelten, wenn es nicht kann, und wann Sie den Dialog nächstes Mal sehen:

314 314 

315* **Eine interaktive Sitzung, die den Dialog nicht anzeigen kann**: Claude Code wendet die bereitgestellten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen. Der Dialog wird in der nächsten Sitzung angezeigt, die ihn anzeigen kann. Erfordert Claude Code v2.1.211 oder später.315* **Eine interaktive Sitzung, die den Dialog nicht anzeigen kann**: Claude Code wendet die bereitgestellten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen bei. Der Dialog wird in der nächsten Sitzung angezeigt, die ihn anzeigen kann.

316* **`claude install` oder `claude update`**: Claude Code zeigt den Dialog während keinem der Befehle an. Der Befehl läuft mit den zuletzt genehmigten Einstellungen, und der Dialog wird in Ihrer nächsten interaktiven Sitzung angezeigt. Wenn Claude Code beim Start auf den Abruf der Einstellungen wartet, wie mit [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) gesetzt oder auf einer [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Bereitstellung, zeigt es den Dialog stattdessen während des Befehls an, und ein Install-Lauf aus einer Pipe schlägt fehl; siehe [`Raw mode is not supported` während install](/docs/de/troubleshoot-install#raw-mode-is-not-supported-during-install). Vor v2.1.246 versuchte Claude Code, den Dialog während dieser Befehle auch anzuzeigen.316* **`claude install` oder `claude update`**: Claude Code zeigt den Dialog während keinem der Befehle an. Der Befehl läuft mit den zuletzt genehmigten Einstellungen, und der Dialog wird in Ihrer nächsten interaktiven Sitzung angezeigt. Wenn Claude Code beim Start auf den Abruf der Einstellungen wartet, wie mit [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) gesetzt oder auf einer [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Bereitstellung, zeigt es den Dialog stattdessen während des Befehls an, und ein Install-Lauf aus einer Pipe schlägt fehl; siehe [`Raw mode is not supported` während install](/docs/de/troubleshoot-install#raw-mode-is-not-supported-during-install). Vor v2.1.246 versuchte Claude Code, den Dialog während dieser Befehle auch anzuzeigen.

317* **Ein Fehler schließt den Dialog, bevor Sie antworten**: Claude Code wendet die bereitgestellten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen. Es zeigt den Dialog erneut in der nächsten Sitzung an, die ihn anzeigen kann.317* **Ein Fehler schließt den Dialog, bevor Sie antworten**: Claude Code wendet die bereitgestellten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen. Es zeigt den Dialog erneut in der nächsten Sitzung an, die ihn anzeigen kann.

318* **Ein nicht-interaktiver Lauf**, wie `claude -p`, eine Agent SDK-Sitzung oder eine Sitzung im Chat-Panel der VS Code-Erweiterung oder der Code-Registerkarte der Desktop-App: Claude Code kann den Dialog nicht anzeigen, daher wendet es sie an, wenn die bereitgestellten Einstellungen Genehmigung erfordern würden, nur für diesen Lauf. Es zeichnet sie nicht als genehmigt auf oder schreibt sie in den [lokalen Cache](#fetch-and-caching-behavior), und die nächste interaktive Sitzung zeigt den Dialog. Bis ein Benutzer in einer interaktiven Sitzung genehmigt, ruft jeder nicht-interaktive Lauf die Einstellungen beim Start erneut ab. Vor v2.1.207 speicherte ein nicht-interaktiver Lauf die Einstellungen als genehmigt, daher zeigten spätere interaktive Sitzungen den Dialog dafür nie.318* **Ein nicht-interaktiver Lauf**, wie `claude -p`, eine Agent SDK-Sitzung oder eine Sitzung im Chat-Panel der VS Code-Erweiterung oder der Code-Registerkarte der Desktop-App: Claude Code kann den Dialog nicht anzeigen, daher wendet es sie an, wenn die bereitgestellten Einstellungen Genehmigung erfordern würden, nur für diesen Lauf. Es zeichnet sie nicht als genehmigt auf oder schreibt sie in den [lokalen Cache](#fetch-and-caching-behavior), und die nächste interaktive Sitzung zeigt den Dialog. Bis ein Benutzer in einer interaktiven Sitzung genehmigt, ruft jeder nicht-interaktive Lauf die Einstellungen beim Start erneut ab. Vor v2.1.207 speicherte ein nicht-interaktiver Lauf die Einstellungen als genehmigt, daher zeigten spätere interaktive Sitzungen den Dialog dafür nie.

sessions.md +4 −3

Details

51 51 

52Wenn Claude Code eine Konversation aus ihrem Transkript lädt, stellt die fortgesetzte Sitzung die Konversation zusammen mit dem darin gespeicherten Zustand wieder her:52Wenn Claude Code eine Konversation aus ihrem Transkript lädt, stellt die fortgesetzte Sitzung die Konversation zusammen mit dem darin gespeicherten Zustand wieder her:

53 53 

54* Konversationsverlauf: der vollständige Verlauf, einschließlich Tool-Aufrufen und Ergebnissen. Ein Tool, das noch lief, als der vorherige Prozess endete, beispielsweise bei einem Absturz, wird nicht beendet und läuft nicht erneut, wenn Sie fortsetzen. Claude sieht den Aufruf als abgebrochen markiert, bevor sein Ergebnis aufgezeichnet wurde, und wird angewiesen, zu überprüfen, ob er wirksam wurde, bevor er ihn erneut ausführt, es sei denn, [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/de/env-vars#variables) ist gesetzt.54* Konversationsverlauf: die Nachrichten, Tool-Aufrufe und Ergebnisse. Wenn die Sitzung [komprimiert](/docs/de/context-window#what-survives-compaction) wurde, öffnet sich die Konversation an einer Zeile `Conversation compacted`. Claude setzt mit der Zusammenfassung der letzten Komprimierung, den Nachrichten, die diese Komprimierung nicht zusammengefasst hat, und jeder Nachricht seitdem fort. Die Nachrichten, die die letzte Komprimierung zusammengefasst hat, werden nicht erneut geladen.

55* Unterbrochene Tool-Aufrufe: Ein Tool, das noch lief, als der vorherige Prozess endete, beispielsweise bei einem Absturz, wird nicht beendet und läuft nicht erneut, wenn Sie fortsetzen. Claude sieht den Aufruf als abgebrochen markiert, bevor sein Ergebnis aufgezeichnet wurde, und wird angewiesen, zu überprüfen, ob er wirksam wurde, bevor er ihn erneut ausführt, es sei denn, [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/de/env-vars#variables) ist gesetzt.

55* Modell: Die Sitzung wird mit dem Modell fortgesetzt, das sie verwendete, außer in den Fällen unter [Modell festlegen](/docs/de/model-config#setting-your-model).56* Modell: Die Sitzung wird mit dem Modell fortgesetzt, das sie verwendete, außer in den Fällen unter [Modell festlegen](/docs/de/model-config#setting-your-model).

56* Agent: Eine Sitzung, die mit [`--agent`](/docs/de/sub-agents#invoke-subagents-explicitly) oder der `agent`-Einstellung gestartet wurde, wird als dieser Agent fortgesetzt, wobei seine Tool-Beschränkungen und sein Modell beibehalten werden. Übergeben Sie `--agent` beim Fortsetzen, um einen anderen auszuwählen; für den System-Prompt in beiden Fällen siehe [System-Prompt-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations). Claude Code sucht an zwei Stellen nach dem Agenten: im ursprünglichen Verzeichnis der Sitzung, vorausgesetzt, Sie haben [diesem Workspace vertraut](/docs/de/permissions#project-allow-rules-and-workspace-trust), und dann im Verzeichnis, von dem aus Sie fortsetzen, sodass ein projektbezogener Agent auch dann geladen wird, wenn Sie von einem anderen Verzeichnis aus fortsetzen. Wenn Claude Code den Agenten an keiner der beiden Stellen findet, wird die Sitzung mit den Standard-Tools fortgesetzt und zeigt eine [Warnung mit dem Namen des Agenten](/docs/de/errors#session-agent-no-longer-available).57* Agent: Eine Sitzung, die mit [`--agent`](/docs/de/sub-agents#invoke-subagents-explicitly) oder der `agent`-Einstellung gestartet wurde, wird als dieser Agent fortgesetzt, wobei seine Tool-Beschränkungen und sein Modell beibehalten werden. Übergeben Sie `--agent` beim Fortsetzen, um einen anderen auszuwählen; für den System-Prompt in beiden Fällen siehe [System-Prompt-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations). Claude Code sucht an zwei Stellen nach dem Agenten: im ursprünglichen Verzeichnis der Sitzung, vorausgesetzt, Sie haben [diesem Workspace vertraut](/docs/de/permissions#project-allow-rules-and-workspace-trust), und dann im Verzeichnis, von dem aus Sie fortsetzen, sodass ein projektbezogener Agent auch dann geladen wird, wenn Sie von einem anderen Verzeichnis aus fortsetzen. Wenn Claude Code den Agenten an keiner der beiden Stellen findet, wird die Sitzung mit den Standard-Tools fortgesetzt und zeigt eine [Warnung mit dem Namen des Agenten](/docs/de/errors#session-agent-no-longer-available).

57* Berechtigungsmodus: Wenn Sie von einem Terminal aus mit `claude --continue`, `claude --resume <session-id>` oder `claude --resume <name>` fortsetzen, wenn der Name einer Sitzung entspricht, ohne `-p`, stellt Claude Code den Berechtigungsmodus wieder her, in dem sich die Sitzung befand, außer in den Fällen unter [Berechtigungsmodus beim Fortsetzen](#permission-mode-on-resume), wo auch die Sitzungsauswahl, `/resume` und das Fortsetzen mit `claude -p` behandelt werden. Übergeben Sie `--permission-mode` oder `--dangerously-skip-permissions`, um den wiederhergestellten Modus zu überschreiben.58* Berechtigungsmodus: Wenn Sie von einem Terminal aus mit `claude --continue`, `claude --resume <session-id>` oder `claude --resume <name>` fortsetzen, wenn der Name einer Sitzung entspricht, ohne `-p`, stellt Claude Code den Berechtigungsmodus wieder her, in dem sich die Sitzung befand, außer in den Fällen unter [Berechtigungsmodus beim Fortsetzen](#permission-mode-on-resume), wo auch die Sitzungsauswahl, `/resume` und das Fortsetzen mit `claude -p` behandelt werden. Übergeben Sie `--permission-mode` oder `--dangerously-skip-permissions`, um den wiederhergestellten Modus zu überschreiben.


162| Aus der Sitzungsauswahl | Markieren Sie eine Sitzung und drücken Sie `Ctrl+R` |163| Aus der Sitzungsauswahl | Markieren Sie eine Sitzung und drücken Sie `Ctrl+R` |

163| Bei Plan-Annahme | Das Akzeptieren eines Plans im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) gibt der Sitzung einen generierten Titel basierend auf dem Plan, es sei denn, Sie haben bereits einen Namen festgelegt |164| Bei Plan-Annahme | Das Akzeptieren eines Plans im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) gibt der Sitzung einen generierten Titel basierend auf dem Plan, es sei denn, Sie haben bereits einen Namen festgelegt |

164| Von claude.ai oder der Claude-App | Benennen Sie eine [Remote-Control-Sitzung](/docs/de/remote-control#connect-from-another-device) um; Claude Code wendet denselben Namen in der CLI an. Erfordert Claude Code v2.1.221 oder später |165| Von claude.ai oder der Claude-App | Benennen Sie eine [Remote-Control-Sitzung](/docs/de/remote-control#connect-from-another-device) um; Claude Code wendet denselben Namen in der CLI an. Erfordert Claude Code v2.1.221 oder später |

165| Von der Desktop-App | Benennen Sie eine Sitzung in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) um |166| Von der Desktop-App | Benennen Sie eine Sitzung in der [Desktop-App](/docs/de/desktop#organize-and-find-sessions) um |

166 167 

167Sobald Sie eine Sitzung über eine CLI-Route oder von claude.ai aus benannt haben, kehren Sie mit `claude --resume <name>` oder `/resume <name>` zu ihr zurück; eine Desktop-App-Sitzung wird in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) fortgesetzt. Siehe [Sitzung fortsetzen](#resume-a-session), um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.168Sobald Sie eine Sitzung über eine CLI-Route oder von claude.ai aus benannt haben, kehren Sie mit `claude --resume <name>` oder `/resume <name>` zu ihr zurück; eine Desktop-App-Sitzung wird in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) fortgesetzt. Siehe [Sitzung fortsetzen](#resume-a-session), um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.

168 169 

169Sitzungen, die Sie nicht benennen, erhalten immer noch zwei Bezeichnungen, die Claude Code zuweist. Nur der generierte Titel funktioniert als Resume-Handle:170Sitzungen, die Sie nicht benennen, erhalten immer noch zwei Bezeichnungen, die Claude Code zuweist. Nur der generierte Titel funktioniert als Resume-Handle:

170 171 

171* Standard-Anzeigename: Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start einen Standard-Anzeigenamen. Erfordert Claude Code v2.1.196 oder später. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise `my-app-3f`, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. [Agent-Ansicht](/docs/de/agent-view) und `claude agents --json` Ausgabe. Der Standard ist kein Resume-Handle. Wenn Sie ihn an `claude --resume` oder `/resume` übergeben, findet Claude Code die Sitzung nicht.172* Standard-Anzeigename: Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start trotzdem einen Standard-Anzeigenamen. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise `my-app-3f`, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. [Agent-Ansicht](/docs/de/agent-view) und `claude agents --json` Ausgabe. Der Standard ist kein Resume-Handle. Wenn Sie ihn an `claude --resume` oder `/resume` übergeben, findet Claude Code die Sitzung nicht.

172* Generierter Titel: Wenn Sie eine Sitzung nicht benennen, generiert Claude Code einen Sitzungstitel für sie. Der Titel ist eine kurze Zusammenfassung Ihres ersten Prompts, geschrieben durch eine Hintergrundanfrage an das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Eine `claude -p`-Ausführung, die Sie direkt von einer Shell oder einem Skript aus starten, erhält keinen.173* Generierter Titel: Wenn Sie eine Sitzung nicht benennen, generiert Claude Code einen Sitzungstitel für sie. Der Titel ist eine kurze Zusammenfassung Ihres ersten Prompts, geschrieben durch eine Hintergrundanfrage an das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Eine `claude -p`-Ausführung, die Sie direkt von einer Shell oder einem Skript aus starten, erhält keinen.

173 174 

174 Das Akzeptieren eines Plans ersetzt den generierten Titel durch einen Titel basierend auf dem Plan. Sie können jeden der beiden Titel an `claude --resume` oder `/resume` übergeben, und Claude Code löst ihn auf dieselbe Weise auf wie einen Namen, den Sie festgelegt haben.175 Das Akzeptieren eines Plans ersetzt den generierten Titel durch einen Titel basierend auf dem Plan. Sie können jeden der beiden Titel an `claude --resume` oder `/resume` übergeben, und Claude Code löst ihn auf dieselbe Weise auf wie einen Namen, den Sie festgelegt haben.

Details

795| [`spinnerTipsEnabled`](#spinnertipsenabled) | Verbergen Sie Tipps im Spinner, während Claude arbeitet | Interface and terminal | Any file |795| [`spinnerTipsEnabled`](#spinnertipsenabled) | Verbergen Sie Tipps im Spinner, während Claude arbeitet | Interface and terminal | Any file |

796| [`spinnerTipsOverride`](#spinnertipsoverride) | Fügen Sie Ihre eigenen Tipps zur Spinner-Rotation hinzu, oder ersetzen Sie die integrierten Tipps | Interface and terminal | Any file |796| [`spinnerTipsOverride`](#spinnertipsoverride) | Fügen Sie Ihre eigenen Tipps zur Spinner-Rotation hinzu, oder ersetzen Sie die integrierten Tipps | Interface and terminal | Any file |

797| [`spinnerVerbs`](#spinnerverbs) | Fügen Sie die Verben hinzu oder ersetzen Sie sie, die während eines Turns angezeigt werden | Interface and terminal | Any file |797| [`spinnerVerbs`](#spinnerverbs) | Fügen Sie die Verben hinzu oder ersetzen Sie sie, die während eines Turns angezeigt werden | Interface and terminal | Any file |

798| [`sshConfigs`](#sshconfigs) | Fügen Sie [SSH-Verbindungen](/docs/de/desktop#pre-configure-ssh-connections-for-your-team) zum Desktop-Umgebungs-Dropdown hinzu | Remote, desktop, and notifications | User or managed |798| [`sshConfigs`](#sshconfigs) | Fügen Sie [SSH-Verbindungen](/docs/de/desktop#pre-configure-ssh-connections-for-your-team) zur Desktop-Umgebungsauswahl hinzu | Remote, desktop, and notifications | User or managed |

799| [`sshHostAllowlist`](#sshhostallowlist) | Begrenzen Sie, welche Hosts [Desktop-SSH-Sitzungen](/docs/de/desktop#restrict-which-ssh-hosts-users-can-connect-to) erreichen können | Remote, desktop, and notifications | Managed |799| [`sshHostAllowlist`](#sshhostallowlist) | Begrenzen Sie, welche Hosts [Desktop-SSH-Sitzungen](/docs/de/desktop#restrict-which-ssh-hosts-users-can-connect-to) erreichen können | Remote, desktop, and notifications | Managed |

800| [`statusLine`](#statusline) | Führen Sie Ihren eigenen Befehl aus, um eine [Statuszeile](/docs/de/statusline) unter der Eingabeaufforderung zu rendern | Interface and terminal | Any file |800| [`statusLine`](#statusline) | Führen Sie Ihren eigenen Befehl aus, um eine [Statuszeile](/docs/de/statusline) unter der Eingabeaufforderung zu rendern | Interface and terminal | Any file |

801| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Allowlist der [Marketplace](/docs/de/plugins/overview)-Quellen, die Benutzer hinzufügen und aus denen sie installieren können | Plugins and skills | Managed |801| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Allowlist der [Marketplace](/docs/de/plugins/overview)-Quellen, die Benutzer hinzufügen und aus denen sie installieren können | Plugins and skills | Managed |


4096 `vimInsertModeRemaps`4096 `vimInsertModeRemaps`

4097</h3>4097</h3>

4098 4098 

4099Zwei-Tasten-Sequenzen im INSERT-Modus im [vim-Editor-Modus](/docs/de/interactive-mode#vim-editor-mode) auf Escape abbilden. Jeder Schlüssel besteht aus genau zwei druckbaren Zeichen, die nacheinander eingegeben werden, und `"<Esc>"` ist das einzige unterstützte Ziel; Claude Code ignoriert andere Einträge. Erfordert Claude Code v2.1.208 oder höher.4099Zwei-Tasten-Sequenzen im INSERT-Modus im [vim-Editor-Modus](/docs/de/interactive-mode#vim-editor-mode) auf Escape abbilden. Jeder Schlüssel besteht aus genau zwei druckbaren Zeichen, die nacheinander eingegeben werden, und `"<Esc>"` ist das einzige unterstützte Ziel; Claude Code ignoriert andere Einträge.

4100 4100 

4101* **Geltungsbereich**: [`User or managed`](#scopes). Ein Repository kann Ihre Tastenanschläge nicht umbelegen.4101* **Geltungsbereich**: [`User or managed`](#scopes). Ein Repository kann Ihre Tastenanschläge nicht umbelegen.

4102* **Typ**: Objekt, das eine Sequenz aus zwei Zeichen auf `"<Esc>"` abbildet4102* **Typ**: Objekt, das eine Sequenz aus zwei Zeichen auf `"<Esc>"` abbildet


4110}4110}

4111```4111```

4112 4112 

4113Hat keine Wirkung, sofern `editorMode` nicht `"vim"` ist. Siehe [Tastensequenzen im INSERT-Modus umbelegen](/docs/de/interactive-mode#remap-insert-mode-key-sequences). Erfordert Claude Code v2.1.208 oder höher.4113Hat keine Wirkung, sofern `editorMode` nicht `"vim"` ist. Siehe [Tastensequenzen im INSERT-Modus umbelegen](/docs/de/interactive-mode#remap-insert-mode-key-sequences).

4114 4114 

4115<h3 id="voice">4115<h3 id="voice">

4116 `voice`4116 `voice`


5850 `disableDesktopLocalSessions`5850 `disableDesktopLocalSessions`

5851</h3>5851</h3>

5852 5852 

5853Schalten Sie Code-Sitzungen aus, die auf dem Gerät in der [Desktop-App](/docs/de/desktop#local-sessions-on-managed-devices) ausgeführt werden, für Bereitstellungen, bei denen Entwickler auf Remote-Maschinen über SSH arbeiten sollten. In der Code-Registerkarte bleibt die **Local**-Umgebung in der Umgebungs-Dropdown-Liste, ist aber ausgegraut und kann nicht ausgewählt werden, mit einem Tooltip, das besagt, dass Ihre Organisation sie deaktiviert hat; unter Windows ist der WSL-Eintrag auf die gleiche Weise ausgegraut, obwohl ob WSL-Sitzungen auf einem verwalteten Gerät überhaupt ausgeführt werden, [separat geregelt wird](/docs/de/admin-setup#wsl-sessions-in-claude-code-desktop). Neue Sitzungen werden standardmäßig auf die erste [SSH-Verbindung](/docs/de/desktop#ssh-sessions) gesetzt, falls eine konfiguriert ist, und die App weigert sich, eine Sitzung auf dem Gerät zu starten oder fortzusetzen, einschließlich einer SSH-Verbindung zurück zur gleichen Maschine. SSH-Sitzungen zu anderen Hosts und Cloud-Sitzungen sind nicht betroffen. Die Desktop-App liest diesen Schlüssel; die Terminal-CLI ignoriert ihn. Erfordert Claude Desktop v1.37937.0 oder später.5853Schalten Sie Code-Sitzungen aus, die auf dem Gerät in der [Desktop-App](/docs/de/desktop#local-sessions-on-managed-devices) ausgeführt werden, für Bereitstellungen, bei denen Entwickler auf Remote-Maschinen über SSH arbeiten sollten. Wenn der Schlüssel auf `true` gesetzt ist, sehen Benutzer in der Code-Registerkarte Folgendes:

5854 

5855* **Umgebungsauswahl**: Der Eintrag für den Computer des Benutzers ist ausgegraut und nicht auswählbar, mit dem Tooltip **Disabled by your organization**. Unter Windows ist der WSL-Eintrag auf die gleiche Weise ausgegraut, obwohl [separat geregelt wird](/docs/de/admin-setup#wsl-sessions-in-claude-code-desktop), ob WSL-Sitzungen auf einem verwalteten Gerät überhaupt ausgeführt werden.

5856* **Neue Sitzungen**: werden standardmäßig auf die erste [SSH-Verbindung](/docs/de/desktop#ssh-sessions) gesetzt, falls eine konfiguriert ist

5857* **Sitzungen auf dem Gerät**: Die App weigert sich, eine Sitzung auf dem Gerät zu starten oder fortzusetzen, einschließlich einer SSH-Verbindung zurück zur gleichen Maschine

5858* **SSH-Sitzungen zu anderen Hosts und Cloud-Sitzungen**: nicht betroffen

5859 

5860Die Desktop-App liest diesen Schlüssel; die Terminal-CLI ignoriert ihn. Erfordert Claude Desktop v1.37937.0 oder später.

5854 5861 

5855* **Geltungsbereich**: [`Managed`](#scopes). Standardmäßig liest die Desktop-App den Schlüssel aus [einer verwalteten Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources).5862* **Geltungsbereich**: [`Managed`](#scopes). Standardmäßig liest die Desktop-App den Schlüssel aus [einer verwalteten Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources).

5856* **Typ**: Boolean; nur der JSON-Boolean `true` hat Auswirkungen5863* **Typ**: Boolean; nur der JSON-Boolean `true` hat Auswirkungen


5997 `sshConfigs`6004 `sshConfigs`

5998</h3>6005</h3>

5999 6006 

6000Fügen Sie SSH-Verbindungen zur [Desktop](/docs/de/desktop#pre-configure-ssh-connections-for-your-team)-Umgebungs-Dropdown hinzu. Administratoren verwenden es, um gemeinsame Verbindungen an ein Team zu verteilen. Verbindungen, die Sie in verwalteten Einstellungen definieren, werden als verwaltet angezeigt. Benutzer können sie auswählen und [ihren eigenen **Worktree-Ordner**](/docs/de/desktop#choose-where-ssh-session-worktrees-go) dafür festlegen, können in der App aber nichts anderes bearbeiten und sie nicht löschen.6007Fügen Sie SSH-Verbindungen zur [Desktop](/docs/de/desktop#pre-configure-ssh-connections-for-your-team)-Umgebungsauswahl hinzu. Administratoren verwenden `sshConfigs`, um gemeinsame Verbindungen an ein Team zu verteilen. Benutzer können eine verwaltete Verbindung auswählen und [ihren eigenen **Worktree-Ordner**](/docs/de/desktop#set-the-worktree-folder-on-an-existing-connection) dafür festlegen. Die anderen Felder der Verbindung können sie in der App nicht bearbeiten, und löschen können sie die Verbindung dort ebenfalls nicht.

6001 6008 

6002* **Geltungsbereich**: [`User or managed`](#scopes). Die Desktop-App liest diesen Schlüssel. Standardmäßig liest sie verwaltete Verbindungen aus [einer verwalteten Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources).6009* **Geltungsbereich**: [`User or managed`](#scopes). Die Desktop-App liest diesen Schlüssel. Standardmäßig liest sie verwaltete Verbindungen aus [einer verwalteten Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources).

6003* **Typ**: Array von Objekten, jedes mit erforderlichen `id`, `name` und `sshHost` und optionalen `sshPort` und `sshIdentityFile`6010* **Typ**: Array von Objekten, jedes mit erforderlichen `id`, `name` und `sshHost` und optionalen `sshPort` und `sshIdentityFile`

statusline.md +2 −2

Details

199| `workspace.added_dirs` | Zusätzliche Verzeichnisse, die über `/add-dir` oder `--add-dir` hinzugefügt wurden. Leeres Array, wenn keine hinzugefügt wurden |199| `workspace.added_dirs` | Zusätzliche Verzeichnisse, die über `/add-dir` oder `--add-dir` hinzugefügt wurden. Leeres Array, wenn keine hinzugefügt wurden |

200| `workspace.git_worktree` | Git-Worktree-Name, wenn sich das aktuelle Verzeichnis in einem verknüpften Worktree befindet, der mit `git worktree add` erstellt wurde. Fehlt im Haupt-Worktree. Wird für jeden Git-Worktree gefüllt, im Gegensatz zu `worktree.*`, das nur während einer [Worktree-Sitzung](/docs/de/worktrees) vorhanden ist. |200| `workspace.git_worktree` | Git-Worktree-Name, wenn sich das aktuelle Verzeichnis in einem verknüpften Worktree befindet, der mit `git worktree add` erstellt wurde. Fehlt im Haupt-Worktree. Wird für jeden Git-Worktree gefüllt, im Gegensatz zu `worktree.*`, das nur während einer [Worktree-Sitzung](/docs/de/worktrees) vorhanden ist. |

201| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Repository-Identität, die aus dem `origin` Remote geparst wird, zum Beispiel `"github.com"`, `"anthropics"`, `"claude-code"`. Fehlt außerhalb eines Git-Repositorys oder wenn kein `origin` Remote konfiguriert ist. Für ein gitlab.com-Projekt, das in Untergruppen verschachtelt ist, ist `owner` der vollständige Namespace-Pfad mit Schrägstrichen, wie `"group/subgroup"`. Vor v2.1.260 fehlte `workspace.repo` für diese Projekte |201| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Repository-Identität, die aus dem `origin` Remote geparst wird, zum Beispiel `"github.com"`, `"anthropics"`, `"claude-code"`. Fehlt außerhalb eines Git-Repositorys oder wenn kein `origin` Remote konfiguriert ist. Für ein gitlab.com-Projekt, das in Untergruppen verschachtelt ist, ist `owner` der vollständige Namespace-Pfad mit Schrägstrichen, wie `"group/subgroup"`. Vor v2.1.260 fehlte `workspace.repo` für diese Projekte |

202| `cost.total_cost_usd` | Geschätzte Sitzungskosten in USD, berechnet auf der Client-Seite zum Listenpreis, es sei denn, eine [`modelPricing`](/docs/de/settings-reference#modelpricing) Tabelle ist in Kraft. Kann sich von Ihrer tatsächlichen Rechnung unterscheiden. Wird auf \$0 zurückgesetzt, wenn `/clear` eine neue Sitzung startet. Vor v2.1.211 wurde die Summe nach `/clear` beibehalten |202| `cost.total_cost_usd` | Geschätzte Sitzungskosten in USD, berechnet auf der Client-Seite zum Listenpreis, es sei denn, eine [`modelPricing`](/docs/de/settings-reference#modelpricing) Tabelle ist in Kraft. Kann sich von Ihrer tatsächlichen Rechnung unterscheiden. Wird auf \$0 zurückgesetzt, wenn `/clear` eine neue Sitzung startet |

203| `cost.total_duration_ms` | Gesamtverstrichene Zeit seit Sitzungsbeginn in Millisekunden |203| `cost.total_duration_ms` | Gesamtverstrichene Zeit seit Sitzungsbeginn in Millisekunden |

204| `cost.total_api_duration_ms` | Gesamtzeit, die auf API-Antworten wartet, in Millisekunden |204| `cost.total_api_duration_ms` | Gesamtzeit, die auf API-Antworten wartet, in Millisekunden |

205| `cost.total_lines_added`, `cost.total_lines_removed` | Geänderte Codezeilen |205| `cost.total_lines_added`, `cost.total_lines_removed` | Geänderte Codezeilen |


1199| `label` | string | Kurze Fortschrittszusammenfassung der Aufgabe, sofern Claude Code eine hat, andernfalls derselbe Text wie `description` |1199| `label` | string | Kurze Fortschrittszusammenfassung der Aufgabe, sofern Claude Code eine hat, andernfalls derselbe Text wie `description` |

1200| `startTime` | number | Startzeitpunkt der Aufgabe in Millisekunden seit der Unix-Epoche |1200| `startTime` | number | Startzeitpunkt der Aufgabe in Millisekunden seit der Unix-Epoche |

1201| `model` | string, optional | ID des aufgelösten Modells, auf dem die Aufgabe ausgeführt wird. Wird weggelassen, bis das Modell aufgelöst ist |1201| `model` | string, optional | ID des aufgelösten Modells, auf dem die Aufgabe ausgeführt wird. Wird weggelassen, bis das Modell aufgelöst ist |

1202| `effort` | string or number, optional | Reasoning-Aufwand, der für den Subagenten in seinem [Definitions-Frontmatter](/docs/de/sub-agents#supported-frontmatter-fields) oder beim einzelnen Aufruf festgelegt ist: `low`, `medium`, `high`, `xhigh`, `max` oder ein numerisches Token-Budget. Dies ist der konfigurierte Wert; der Aufwand, den Claude Code anwendet, kann sich unterscheiden, wenn das Modell diese Stufe nicht unterstützt. Wird weggelassen, wenn kein Aufwand festgelegt ist. Erfordert Claude Code v2.1.213 oder später |1202| `effort` | string or number, optional | Reasoning-Aufwand, der für den Subagenten in seinem [Definitions-Frontmatter](/docs/de/sub-agents#supported-frontmatter-fields) oder beim einzelnen Aufruf festgelegt ist: `low`, `medium`, `high`, `xhigh`, `max` oder ein numerisches Token-Budget. Dies ist der konfigurierte Wert; der Aufwand, den Claude Code anwendet, kann sich unterscheiden, wenn das Modell diese Stufe nicht unterstützt. Wird weggelassen, wenn kein Aufwand festgelegt ist |

1203| `contextWindowSize` | number, optional | Kontextfenster von `model` in Token, berechnet auf die gleiche Weise wie das [`context_window.context_window_size`](#context-window-fields) der Hauptstatuszeile, sodass Sie einen Prozentsatz pro Zeile aus `tokenCount` rendern können. Wird weggelassen, wenn `model` weggelassen wird |1203| `contextWindowSize` | number, optional | Kontextfenster von `model` in Token, berechnet auf die gleiche Weise wie das [`context_window.context_window_size`](#context-window-fields) der Hauptstatuszeile, sodass Sie einen Prozentsatz pro Zeile aus `tokenCount` rendern können. Wird weggelassen, wenn `model` weggelassen wird |

1204| `tokenCount` | number | Laufende Token-Anzahl des Subagenten, der Wert, den die Standardzeile anzeigt |1204| `tokenCount` | number | Laufende Token-Anzahl des Subagenten, der Wert, den die Standardzeile anzeigt |

1205| `tokenSamples` | array of numbers | Bis zu 16 der letzten `tokenCount` Messwerte, einer pro Aktualisierungstick, älteste zuerst und endend mit dem aktuellen |1205| `tokenSamples` | array of numbers | Bis zu 16 der letzten `tokenCount` Messwerte, einer pro Aktualisierungstick, älteste zuerst und endend mit dem aktuellen |

sub-agents.md +53 −35

Details

287 287 

288Ein Subagent mit `isolation: worktree` führt seine Bash- und PowerShell-Befehle in seinem Worktree aus. Ein Befehl, dessen Arbeitsverzeichnis sich stattdessen zu Ihrem Haupt-Checkout auflöst, beispielsweise weil das Worktree-Verzeichnis entfernt wurde, während der Subagent lief, schlägt mit einem Fehler fehl.288Ein Subagent mit `isolation: worktree` führt seine Bash- und PowerShell-Befehle in seinem Worktree aus. Ein Befehl, dessen Arbeitsverzeichnis sich stattdessen zu Ihrem Haupt-Checkout auflöst, beispielsweise weil das Worktree-Verzeichnis entfernt wurde, während der Subagent lief, schlägt mit einem Fehler fehl.

289 289 

290Diese Arbeitsverzeichnis-Überprüfung deckt das gesamte Repository ab, das das Verzeichnis enthält, von dem aus Sie Claude Code gestartet haben. Wenn Ihre Sitzung in einem verknüpften [Worktree](/docs/de/worktrees) läuft, deckt die Überprüfung auch den Haupt-Checkout ab, von dem dieser Worktree verknüpft ist. Vor v2.1.210 deckte die Überprüfung nur das Start-Verzeichnis selbst ab. Ein Befehl, dessen Arbeitsverzeichnis sich anderswo im selben Repository auflöste, wie das Repository-Root, wenn Sie Claude Code von einem Monorepo-Unterverzeichnis aus gestartet haben, wurde dort ausgeführt, anstatt zu fehlschlagen.290Diese Arbeitsverzeichnis-Überprüfung deckt das gesamte Repository ab, das das Verzeichnis enthält, von dem aus Sie Claude Code gestartet haben. Wenn Ihre Sitzung in einem eigenen verknüpften [Worktree](/docs/de/worktrees) läuft, deckt die Überprüfung auch den Haupt-Checkout ab, von dem dieser Worktree verknüpft ist.

291 291 

292Für Bash-Befehle überprüft Claude Code auch den Befehl selbst auf zwei Arten:292Für Bash-Befehle überprüft Claude Code auch den Befehl selbst auf zwei Arten:

293 293 


325| `mcpServers` | Nein | [MCP-Server](/docs/de/mcp) verfügbar für diesen Subagenten. Jeder Eintrag ist entweder ein Servername, der auf einen bereits konfigurierten Server verweist (z. B. `"slack"`) oder eine Inline-Definition mit dem Servernamen als Schlüssel und einer vollständigen [MCP-Server-Konfiguration](/docs/de/mcp#installing-mcp-servers) als Wert. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |325| `mcpServers` | Nein | [MCP-Server](/docs/de/mcp) verfügbar für diesen Subagenten. Jeder Eintrag ist entweder ein Servername, der auf einen bereits konfigurierten Server verweist (z. B. `"slack"`) oder eine Inline-Definition mit dem Servernamen als Schlüssel und einer vollständigen [MCP-Server-Konfiguration](/docs/de/mcp#installing-mcp-servers) als Wert. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |

326| `hooks` | Nein | [Lifecycle-Hooks](#define-hooks-for-subagents) mit Umfang auf diesen Subagenten. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |326| `hooks` | Nein | [Lifecycle-Hooks](#define-hooks-for-subagents) mit Umfang auf diesen Subagenten. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |

327| `memory` | Nein | [Persistenter Speicherumfang](#enable-persistent-memory): `user`, `project` oder `local`. Ermöglicht sitzungsübergreifendes Lernen |327| `memory` | Nein | [Persistenter Speicherumfang](#enable-persistent-memory): `user`, `project` oder `local`. Ermöglicht sitzungsübergreifendes Lernen |

328| `background` | Nein | Auf `true` setzen, um diesen Subagenten im Hintergrund zu halten, auch wenn Claude ihn im Vordergrund ausführen möchte. Wo [Fork-Modus](#turn-fork-mode-on-or-off) aktiviert ist, führt Claude Code die Subagenten, die Claude spawnt, bereits [im Hintergrund](#run-subagents-in-foreground-or-background) aus |328| `background` | Nein | Auf `true` setzen, um diesen Subagenten im Hintergrund zu halten, auch wenn Claude darauf warten möchte. Standardmäßig [starten](#run-subagents-in-foreground-or-background) Subagenten, die Claude aus der Hauptkonversation spawnt, bereits im Hintergrund |

329| `omitClaudeMd` | Nein | Auf `true` setzen, um diesen Subagenten ohne die Benutzer-, Projekt- und lokalen CLAUDE.md-Dateien in seinem [anfänglichen Kontext](#what-loads-at-startup) zu starten; [verwaltete Richtliniendateien](/docs/de/memory#how-claude-md-files-load) werden weiterhin geladen, außer bei [verwalteten Subagenten](#choose-the-subagent-scope). Verwenden Sie es für Subagenten, die alles Benötigte aus dem Delegations-Prompt beziehen. Wird ignoriert, wenn der Agent über `--agent` oder die Einstellung `agent` als Agent der Hauptsitzung läuft. Erfordert Claude Code v2.1.271 oder höher |329| `omitClaudeMd` | Nein | Auf `true` setzen, um diesen Subagenten ohne die Benutzer-, Projekt- und lokalen CLAUDE.md-Dateien in seinem [anfänglichen Kontext](#what-loads-at-startup) zu starten; [verwaltete Richtliniendateien](/docs/de/memory#how-claude-md-files-load) werden weiterhin geladen, außer bei [verwalteten Subagenten](#choose-the-subagent-scope). Verwenden Sie es für Subagenten, die alles Benötigte aus dem Delegations-Prompt beziehen. Wird ignoriert, wenn der Agent über `--agent` oder die Einstellung `agent` als Agent der Hauptsitzung läuft. Erfordert Claude Code v2.1.271 oder höher |

330| `effort` | Nein | Effort-Stufe, wenn dieser Subagent aktiv ist. Überschreibt die Effort-Stufe der Sitzung, aber nicht die Umgebungsvariable [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars#variables). Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. Siehe [Wählen Sie eine Effort-Stufe](#choose-an-effort-level) |330| `effort` | Nein | Effort-Stufe, wenn dieser Subagent aktiv ist. Überschreibt die Effort-Stufe der Sitzung, aber nicht die Umgebungsvariable [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars#variables). Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. Siehe [Wählen Sie eine Effort-Stufe](#choose-an-effort-level) |

331| `isolation` | Nein | Auf `worktree` setzen, um den Subagenten in einem temporären [Git-Worktree](/docs/de/worktrees) auszuführen, was ihm eine isolierte Kopie des Repositorys gibt, die standardmäßig von Ihrem [Standard-Branch](/docs/de/worktrees#choose-the-base-branch) verzweigt ist, anstatt vom `HEAD` der übergeordneten Sitzung. Der Worktree wird automatisch bereinigt, wenn der Subagent keine Änderungen vornimmt |331| `isolation` | Nein | Auf `worktree` setzen, um den Subagenten in einem temporären [Git-Worktree](/docs/de/worktrees) auszuführen, was ihm eine isolierte Kopie des Repositorys gibt, die standardmäßig von Ihrem [Standard-Branch](/docs/de/worktrees#choose-the-base-branch) verzweigt ist, anstatt vom `HEAD` der übergeordneten Sitzung. Der Worktree wird automatisch bereinigt, wenn der Subagent keine Änderungen vornimmt |


405 405 

406Um zu überprüfen, auf welchem Modell ein Subagent läuft, führen Sie [`/tasks`](/docs/de/commands) aus. Claude Code benennt das Modell in der Zeile des Subagenten und fügt gegebenenfalls die für diesen Subagenten festgelegte [Effort-Stufe](/docs/de/model-config#adjust-effort-level) hinzu. Erfordert Claude Code v2.1.242 oder später.406Um zu überprüfen, auf welchem Modell ein Subagent läuft, führen Sie [`/tasks`](/docs/de/commands) aus. Claude Code benennt das Modell in der Zeile des Subagenten und fügt gegebenenfalls die für diesen Subagenten festgelegte [Effort-Stufe](/docs/de/model-config#adjust-effort-level) hinzu. Erfordert Claude Code v2.1.242 oder später.

407 407 

408Ein Per-Invokation-`model`-Parameter gilt auch, wenn der Subagent [fortgesetzt oder eine Folgenachricht gesendet wird](#resume-subagents), sodass der Subagent auf diesem Modell bleibt. Vor v2.1.211 ließ das Fortsetzen den Per-Invokation-Wert fallen und der Subagent kehrte zu seinem `model`-Feld oder, ohne einen, zum Modell der Hauptkonversation zurück.408Ein `model`-Parameter pro Aufruf gilt auch, wenn der Subagent [fortgesetzt wird oder eine Folgenachricht erhält](#resume-subagents), sodass der Subagent auf diesem Modell bleibt.

409 409 

410Ab v2.1.198 erben Subagenten auch die [Extended Thinking](/docs/de/model-config#extended-thinking)-Konfiguration der Hauptkonversation: Wenn Thinking in Ihrer Sitzung aktiviert ist, ist es für den Subagenten aktiviert, und wenn es deaktiviert ist, bleibt es deaktiviert. Es gibt keine Pro-Subagenten-Thinking-Einstellung. Vor v2.1.198 liefen Subagenten mit deaktiviertem Extended Thinking, unabhängig von der Einstellung der Hauptkonversation.410Ab v2.1.198 erben Subagenten auch die [Extended Thinking](/docs/de/model-config#extended-thinking)-Konfiguration der Hauptkonversation: Wenn Thinking in Ihrer Sitzung aktiviert ist, ist es für den Subagenten aktiviert, und wenn es deaktiviert ist, bleibt es deaktiviert. Es gibt keine Pro-Subagenten-Thinking-Einstellung. Vor v2.1.198 liefen Subagenten mit deaktiviertem Extended Thinking, unabhängig von der Einstellung der Hauptkonversation.

411 411 


501---501---

502```502```

503 503 

504Wenn nichts in der `tools`-Liste sich zu einem Werkzeug auflöst, beispielsweise weil jeder Eintrag falsch geschrieben ist oder ein Werkzeug benennt, das nicht für Subagenten verfügbar ist, weigert sich Claude Code normalerweise, den Subagenten zu starten, und das Agent-Werkzeug gibt einen Fehler zurück, der die ungelösten Einträge benennt; siehe [Agent würde mit null Werkzeugen gespawnt](/docs/de/errors#agent-would-be-spawned-with-zero-tools) für die Nachricht und wie man jeden Eintrag behebt. Vor v2.1.208 startete dieser Subagent mit keinen Werkzeugen und konnte ein leeres oder verwirrendes Ergebnis zurückgeben.504Wenn sich nichts in der `tools`-Liste zu einem Tool auflöst, beispielsweise weil jeder Eintrag falsch geschrieben ist oder ein Tool benennt, das für Subagenten nicht verfügbar ist, weigert sich Claude Code normalerweise, den Subagenten zu starten, und das Agent-Tool gibt einen Fehler zurück, der die nicht aufgelösten Einträge benennt; siehe [Agent would be spawned with zero tools](/docs/de/errors#agent-would-be-spawned-with-zero-tools) für die Meldung und wie Sie jeden Eintrag korrigieren.

505 505 

506Die Felder `tools` und `disallowedTools` akzeptieren auch Einträge für einen ganzen MCP-Server:506Die Felder `tools` und `disallowedTools` akzeptieren auch Einträge für einen ganzen MCP-Server:

507 507 


969* **Vordergrund-Subagenten** blockieren die Hauptkonversation bis zur Fertigstellung. Berechtigungsabfragen werden an Sie weitergeleitet, wenn sie auftauchen.969* **Vordergrund-Subagenten** blockieren die Hauptkonversation bis zur Fertigstellung. Berechtigungsabfragen werden an Sie weitergeleitet, wenn sie auftauchen.

970* **Hintergrund-Subagenten** werden gleichzeitig ausgeführt, während Sie weiterarbeiten. Wenn ein Hintergrund-Subagent einen Tool-Aufruf erreicht, der eine Berechtigung benötigt, zeigt Claude Code die Abfrage in Ihrer Hauptsitzung an und nennt den Subagenten, der fragt. Genehmigen Sie, um den Subagenten fortfahren zu lassen, oder drücken Sie Esc, um diesen einen Tool-Aufruf zu verweigern, ohne den Subagenten zu stoppen.970* **Hintergrund-Subagenten** werden gleichzeitig ausgeführt, während Sie weiterarbeiten. Wenn ein Hintergrund-Subagent einen Tool-Aufruf erreicht, der eine Berechtigung benötigt, zeigt Claude Code die Abfrage in Ihrer Hauptsitzung an und nennt den Subagenten, der fragt. Genehmigen Sie, um den Subagenten fortfahren zu lassen, oder drücken Sie Esc, um diesen einen Tool-Aufruf zu verweigern, ohne den Subagenten zu stoppen.

971 971 

972Für jeden Subagenten, den Claude mit dem Agent-Tool spawnt, wählt Claude Code Vordergrund oder Hintergrund aus dem ersten dieser Fälle, der zutrifft:972<h4 id="which-subagents-run-in-the-background">

973 Welche Subagenten im Hintergrund laufen

974</h4>

975 

976Ohne weitere Konfiguration startet ein Subagent, den Claude aus Ihrer Hauptkonversation spawnt, im Hintergrund.

973 977 

974* Wenn ein In-Process-[Agent-Team](/docs/de/agent-teams#limitations)-Teamkollege den Subagenten spawnte, führt Claude Code ihn im Vordergrund aus. Claude Code weigert sich mit einem Fehler, einen Subagenten eines Teamkollegen zu spawnen, dessen Definition [`background: true`](#supported-frontmatter-fields) setzt. Wenn [Fork-Modus](#turn-fork-mode-on-or-off) aus ist und Sie [Hintergrundaufgaben nicht ausgeschaltet haben](/docs/de/env-vars), weigert sich Claude Code auch mit einem Fehler, wenn ein Teamkollege `run_in_background: true` setzt.978* **`claude -p` und das Agent SDK**: Claude kann warten, nach eigenem Ermessen oder wenn Sie darum bitten.

975* Wenn Sie [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/de/env-vars) auf `1` setzen, führt Claude Code den Subagenten im Vordergrund aus, in jeder Art von Sitzung und unabhängig davon, ob Fork-Modus an ist.979* **Interaktive Terminal-Sitzung, VS Code und Sitzungen der Desktop-App auf Ihrem Rechner**: Damit Claude auf einen Subagenten warten kann, [schalten Sie den Fork-Modus aus](#let-claude-wait-for-a-subagent), der [standardmäßig aktiviert ist](#turn-fork-mode-on-or-off).

976* Wenn [Fork-Modus](#turn-fork-mode-on-or-off) an ist, wie es standardmäßig in einer interaktiven Sitzung der Fall ist, führt Claude Code den Subagenten im Hintergrund aus, sowohl Fork- als auch Non-Fork-Subagenten, und Claude kann nicht den Vordergrund anfordern.

977* Wenn Fork-Modus aus ist, führt Claude den Subagenten standardmäßig im Hintergrund aus und im Vordergrund, wenn er das Ergebnis benötigt, bevor er fortfährt. Fork-Modus ist aus im [nicht interaktiven Modus](/docs/de/headless) mit `-p` und im Agent SDK, sofern Sie ihn nicht einschalten. Um einen bestimmten Subagenten im Hintergrund zu halten, auch wenn Claude das Ergebnis möchte, setzen Sie sein Frontmatter-Feld [`background`](#supported-frontmatter-fields) auf `true`.

978 980 

979Für einen Skill mit `context: fork` folgt Claude Code stattdessen den Regeln in [Skills in einem Subagenten ausführen](/docs/de/skills#run-skills-in-a-subagent), unabhängig davon, ob Fork-Modus an ist.981Für einen Skill mit `context: fork` folgt Claude Code stattdessen den Regeln in [Skills in einem Subagenten ausführen](/docs/de/skills#run-skills-in-a-subagent), unabhängig davon, ob Fork-Modus an ist.

980 982 

983<h4 id="let-claude-wait-for-a-subagent">

984 Claude auf einen Subagenten warten lassen

985</h4>

986 

9871. Schalten Sie den [Fork-Modus](#turn-fork-mode-on-or-off) aus, indem Sie `CLAUDE_CODE_FORK_SUBAGENT` auf `0` setzen, zum Beispiel in [`settings.json`](/docs/de/settings):

988 

989 ```json theme={null}

990 {

991 "env": {

992 "CLAUDE_CODE_FORK_SUBAGENT": "0"

993 }

994 }

995 ```

996 

9972. Führen Sie `claude` erneut in Ihrer Shell aus oder öffnen Sie eine neue VS Code-Konversation.

998 

9993. Bitten Sie Claude zu warten, wenn Sie zuerst ein Ergebnis benötigen, zum Beispiel „run the reviewer subagent and wait for its report“.

1000 

1001Um weiterzuarbeiten, während Claude wartet, drücken Sie **Ctrl+B** im Terminal oder klicken Sie in VS Code auf [**Run in background**](/docs/de/vs-code#move-a-running-command-or-subagent-to-the-background).

1002 

1003Wenn Sie die Umgebungsvariable [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/de/env-vars) auf `1` setzen, anstatt den Fork-Modus auszuschalten, wartet Claude auf jeden Subagenten, und Hintergrundaufgaben sind ausgeschaltet, einschließlich **Ctrl+B**.

1004 

1005<h4 id="tools-permissions-and-results-of-background-subagents">

1006 Tools, Berechtigungen und Ergebnisse von Hintergrund-Subagenten

1007</h4>

1008 

981Hintergrund-Subagenten werden mit einem [kleineren integrierten Tool-Set](#available-tools) als Vordergrund-Subagenten ausgeführt, außer für Konversations-Forks und [fortgesetzte](#resume-subagents) Vordergrund-Subagenten.1009Hintergrund-Subagenten werden mit einem [kleineren integrierten Tool-Set](#available-tools) als Vordergrund-Subagenten ausgeführt, außer für Konversations-Forks und [fortgesetzte](#resume-subagents) Vordergrund-Subagenten.

982 1010 

983Hintergrund-Subagenten zeigen jede Berechtigungsabfrage in Ihrer Hauptsitzung an. Wenn Sie eine dieser Abfragen mit einer Wahl beantworten, die über diesen einen Tool-Aufruf hinausgeht, z. B. eine Genehmigung, die für den Rest der Sitzung gilt, wendet Claude Code Ihre Antwort auf die gesamte Sitzung an, einschließlich Ihrer Hauptkonversation.1011Hintergrund-Subagenten zeigen jede Berechtigungsabfrage in Ihrer Hauptsitzung an. Wenn Sie eine dieser Abfragen mit einer Wahl beantworten, die über diesen einen Tool-Aufruf hinausgeht, z. B. eine Genehmigung, die für den Rest der Sitzung gilt, wendet Claude Code Ihre Antwort auf die gesamte Sitzung an, einschließlich Ihrer Hauptkonversation.

984 1012 

985Ein Hintergrund-Subagent kann einen Hintergrund-[Bash- oder PowerShell-Befehl](/docs/de/tools-reference#background-commands) [über das Ende seines Turns hinaus laufen lassen](/docs/de/interactive-mode#how-backgrounding-works). Wenn dieser Befehl endet, sendet Claude Code dem Subagenten eine Benachrichtigung.1013Ein Hintergrund-Subagent kann einen Hintergrund-[Bash- oder PowerShell-Befehl](/docs/de/tools-reference#background-commands) [über das Ende seines Turns hinaus laufen lassen](/docs/de/interactive-mode#how-backgrounding-works). Wenn dieser Befehl endet, sendet Claude Code dem Subagenten eine Benachrichtigung.

986 1014 

987Die Ergebnisse eines Hintergrund-Subagenten erreichen Claude als Abschlussbenachrichtigung in einem späteren Turn. Claude wartet auf diese Benachrichtigung, bevor er die Ergebnisse des Subagenten meldet, und wenn Sie zuerst nach Fortschritt fragen, meldet er, dass der Subagent noch läuft. Vor v2.1.211 meldete Claude manchmal Ergebnisse für einen Hintergrund-Subagenten, der nicht fertig war.1015Die Ergebnisse eines Hintergrund-Subagenten erreichen Claude als Abschlussbenachrichtigung in einem späteren Turn. Claude wartet auf diese Benachrichtigung, bevor er die Ergebnisse des Subagenten meldet, und wenn Sie zuerst nach Fortschritt fragen, meldet er, dass der Subagent noch läuft.

988 1016 

989Sie können dies auch selbst steuern:1017<h4 id="finished-subagents-in-the-panel-and-task-list">

990 1018 Beendete Subagenten im Panel und in der Aufgabenliste

991* Wenn Fork-Modus aus ist, bitten Sie Claude, eine Aufgabe im Hintergrund oder im Vordergrund auszuführen1019</h4>

992* Drücken Sie **Ctrl+B**, um eine laufende Aufgabe in den Hintergrund zu verschieben

993 1020 

994Claude Code löscht die Zeile eines Hintergrund-Subagenten aus dem Subagenten-Panel unter der Prompt-Eingabe auf eine von zwei Arten, je nachdem, wie der Subagent endete:1021Claude Code löscht die Zeile eines Hintergrund-Subagenten aus dem Subagenten-Panel unter der Prompt-Eingabe auf eine von zwei Arten, je nachdem, wie der Subagent endete:

995 1022 


1036 1063 

1037Ein [Hintergrund-Subagenten-Bericht](#run-subagents-in-foreground-or-background) kommt in einer Abschlussbenachrichtigung an, die als automatisiertes Ereignis gekennzeichnet ist, anstatt als Nachricht von Ihnen.1064Ein [Hintergrund-Subagenten-Bericht](#run-subagents-in-foreground-or-background) kommt in einer Abschlussbenachrichtigung an, die als automatisiertes Ereignis gekennzeichnet ist, anstatt als Nachricht von Ihnen.

1038 1065 

1039<Note>

1040 Das Subagenten-Ausgabe-Scanning erfordert Claude Code v2.1.210 oder später.

1041</Note>

1042 

1043<h3 id="common-patterns">1066<h3 id="common-patterns">

1044 Häufige Muster1067 Häufige Muster

1045</h3>1068</h3>


1109 1132 

1110Standardmäßig kann ein Subagent seine eigenen Subagenten spawnen, bis zu drei Ebenen unter der Hauptkonversation. Bei der Tiefenbegrenzung entzieht Claude Code das `Agent`-Tool jedem Subagenten außer einem [Fork](#fork-the-current-conversation), sodass ein Subagent bei der Grenze seine delegierte Arbeit selbst erledigt und eine Zusammenfassung zurückgibt. Ein Fork bei der Grenze behält `Agent` in seiner geerbten Tool-Liste, aber das Tool gibt einen Fehler zurück, anstatt zu spawnen.1133Standardmäßig kann ein Subagent seine eigenen Subagenten spawnen, bis zu drei Ebenen unter der Hauptkonversation. Bei der Tiefenbegrenzung entzieht Claude Code das `Agent`-Tool jedem Subagenten außer einem [Fork](#fork-the-current-conversation), sodass ein Subagent bei der Grenze seine delegierte Arbeit selbst erledigt und eine Zusammenfassung zurückgibt. Ein Fork bei der Grenze behält `Agent` in seiner geerbten Tool-Liste, aber das Tool gibt einen Fehler zurück, anstatt zu spawnen.

1111 1134 

1112Verschachtelte Subagenten eignen sich für eine delegierte Aufgabe, die sich selbst in parallele Unteraufgaben aufteilt, z. B. ein Reviewer-Subagent, der einen Verifier pro Befund versendet. In einer interaktiven Sitzung kehrt nur die Zusammenfassung des Top-Level-Subagenten zu Ihnen zurück und die Zwischenausgabe bleibt aus Ihrer Hauptkonversation: Ein Subagent, der Hintergrund-Subagenten startet, wartet auf deren Ergebnisse, bevor er beendet wird. Im [nicht interaktiven Modus](/docs/de/headless) und dem Agent SDK wartet der startende Subagent nicht, sodass ein verschachtelter Hintergrund-Subagent, der nach seinem Starter endet, stattdessen an Ihre Hauptkonversation meldet.1135Verschachtelte Subagenten eignen sich für eine delegierte Aufgabe, die sich selbst in parallele Unteraufgaben aufteilt, z. B. ein Reviewer-Subagent, der einen Verifier pro Befund versendet. Standardmäßig wartet der startende Subagent auf den Bericht jedes verschachtelten Subagenten:

1136 

1137* **Interaktive Terminal-Sitzung**: Nur die Zusammenfassung des Top-Level-Subagenten kehrt zu Ihnen zurück, da ein Subagent, der Hintergrund-Subagenten startet, auf deren Ergebnisse wartet, bevor er beendet wird.

1138* **`claude -p` und das Agent SDK**: Der startende Subagent wartet, solange der [Fork-Modus](#turn-fork-mode-on-or-off) aktiviert ist. Wenn Sie den Fork-Modus ausschalten, starten verschachtelte Subagenten stattdessen im [Hintergrund](#run-subagents-in-foreground-or-background). Der startende Subagent wartet nicht auf einen verschachtelten Hintergrund-Subagenten, der an Ihre Hauptkonversation meldet, wenn er den startenden Subagenten überdauert.

1113 1139 

1114Um die Grenze zu ändern, setzen Sie [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/de/env-vars) auf die Anzahl der Subagenten-Ebenen, die Sie unter Ihrer Hauptkonversation möchten. Beispielsweise begrenzt dieser Eintrag in [`settings.json`](/docs/de/settings) die Verschachtelung auf zwei Ebenen:1140Um die Grenze zu ändern, setzen Sie [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/de/env-vars) auf die Anzahl der Subagenten-Ebenen, die Sie unter Ihrer Hauptkonversation möchten. Beispielsweise begrenzt dieser Eintrag in [`settings.json`](/docs/de/settings) die Verschachtelung auf zwei Ebenen:

1115 1141 


1277</h2>1303</h2>

1278 1304 

1279<Note>1305<Note>

1280 Führen Sie einen gegabelten Subagenten mit `/subtask` aus, was Claude Code v2.1.212 oder später erfordert. Wenn [die Agenten-Ansicht ausgeschaltet ist](/docs/de/agent-view#turn-off-agent-view), ist `/subtask` nicht verfügbar und `/fork` startet stattdessen den gegabelten Subagenten; andernfalls kopiert `/fork` die gesamte Sitzung in eine neue [Hintergrund-Sitzung](/docs/de/agent-view#from-inside-a-session).1306 Wenn [die Agenten-Ansicht ausgeschaltet ist](/docs/de/agent-view#turn-off-agent-view), ist `/subtask` nicht verfügbar und `/fork` startet stattdessen den gegabelten Subagenten; andernfalls kopiert `/fork` die gesamte Sitzung in eine neue [Hintergrund-Sitzung](/docs/de/agent-view#from-inside-a-session).

1281</Note>1307</Note>

1282 1308 

1283Ein Fork ist ein Subagent, der die gesamte bisherige Konversation erbt, anstatt von vorne zu beginnen. Dies lässt die Eingabe-Isolierung fallen, die Subagenten ansonsten bieten: Ein Fork sieht denselben Systemprompt, dieselben Werkzeuge, dasselbe Modell und die Nachrichtenhistorie wie die Hauptsitzung, sodass Sie ihm eine Nebenaufgabe übergeben können, ohne die Situation erneut zu erklären. Die eigenen Werkzeugaufrufe des Forks bleiben weiterhin aus Ihrer Konversation heraus und nur sein endgültiges Ergebnis kommt zurück, sodass Ihr Hauptkontextfenster sauber bleibt. Verwenden Sie einen Fork, wenn ein anderer Subagent zu viel Hintergrund benötigen würde, um nützlich zu sein, oder wenn Sie mehrere Ansätze parallel vom gleichen Ausgangspunkt aus versuchen möchten.1309Ein Fork ist ein Subagent, der die gesamte bisherige Konversation erbt, anstatt von vorne zu beginnen. Dies lässt die Eingabe-Isolierung fallen, die Subagenten ansonsten bieten: Ein Fork sieht denselben Systemprompt, dieselben Werkzeuge, dasselbe Modell und die Nachrichtenhistorie wie die Hauptsitzung, sodass Sie ihm eine Nebenaufgabe übergeben können, ohne die Situation erneut zu erklären. Die eigenen Werkzeugaufrufe des Forks bleiben weiterhin aus Ihrer Konversation heraus und nur sein endgültiges Ergebnis kommt zurück, sodass Ihr Hauptkontextfenster sauber bleibt. Verwenden Sie einen Fork, wenn ein anderer Subagent zu viel Hintergrund benötigen würde, um nützlich zu sein, oder wenn Sie mehrere Ansätze parallel vom gleichen Ausgangspunkt aus versuchen möchten.

1284 1310 

1285Claude startet einen Fork, indem er den `fork`-Subagenten-Typ durch das Agent-Werkzeug anfordert. Sie steuern, ob dies möglich ist, mit dem [Fork-Modus](#turn-fork-mode-on-or-off), der in interaktiven Sitzungen standardmäßig aktiviert ist.1311Claude kann selbstständig einen Fork starten, solange der Fork-Modus aktiviert ist, was standardmäßig der Fall ist. Wie Sie Forks unterbinden, erfahren Sie unter [Fork-Modus deaktivieren](#turn-fork-mode-on-or-off).

1286 1312 

1287Sie können einen Fork selbst mit `/subtask` gefolgt von einer Aufgabe starten, unabhängig davon, ob der Fork-Modus aktiviert ist oder nicht. In v2.1.161 bis v2.1.211 ist der Befehl `/fork`. Claude Code benennt den Fork aus den ersten Worten der Aufgabe. Das folgende Beispiel gabelt die Konversation, um Testfälle zu entwerfen, während Sie mit der Implementierung in der Hauptsitzung fortfahren:1313Sie können einen Fork selbst mit `/subtask` gefolgt von einer Aufgabe starten, unabhängig davon, ob der Fork-Modus aktiviert ist oder nicht. Claude Code benennt den Fork aus den ersten Worten der Aufgabe. Das folgende Beispiel gabelt die Konversation, um Testfälle zu entwerfen, während Sie mit der Implementierung in der Hauptsitzung fortfahren:

1288 1314 

1289```text wrap theme={null}1315```text wrap theme={null}

1290/subtask draft unit tests for the parser changes so far1316/subtask draft unit tests for the parser changes so far


1327| Kontext | Vollständige Konversationshistorie | Frischer Kontext mit dem Prompt, den Sie übergeben |1353| Kontext | Vollständige Konversationshistorie | Frischer Kontext mit dem Prompt, den Sie übergeben |

1328| Systemprompt und Werkzeuge | Gleich wie Hauptsitzung | Aus der [Definitionsdatei](#write-subagent-files) des Subagenten, [gefiltert für Hintergrund-Läufe](#available-tools) |1354| Systemprompt und Werkzeuge | Gleich wie Hauptsitzung | Aus der [Definitionsdatei](#write-subagent-files) des Subagenten, [gefiltert für Hintergrund-Läufe](#available-tools) |

1329| Modell | Gleich wie Hauptsitzung | Aus dem `model`-Feld des Subagenten |1355| Modell | Gleich wie Hauptsitzung | Aus dem `model`-Feld des Subagenten |

1330| Berechtigungen | Aufforderungen erscheinen in Ihrem Terminal | [Aufforderungen erscheinen in Ihrer Hauptsitzung](#run-subagents-in-foreground-or-background) bei Ausführung im Hintergrund |

1331| Prompt-Cache | Mit Hauptsitzung geteilt | Separater Cache |1356| Prompt-Cache | Mit Hauptsitzung geteilt | Separater Cache |

1332 1357 

1333Da der System-Prompt und die Tool-Definitionen eines Forks identisch mit denen des übergeordneten Elements sind, verwendet seine erste Anfrage den [Prompt-Cache](/docs/de/prompt-caching#subagents-and-the-cache) des übergeordneten Elements wieder. Aufgrund dieser Wiederverwendung kostet ein Fork bei Aufgaben, die denselben Kontext benötigen, weniger als ein frischer Subagent.1358Da der System-Prompt und die Tool-Definitionen eines Forks identisch mit denen des übergeordneten Elements sind, verwendet seine erste Anfrage den [Prompt-Cache](/docs/de/prompt-caching#subagents-and-the-cache) des übergeordneten Elements wieder. Aufgrund dieser Wiederverwendung kostet ein Fork bei Aufgaben, die denselben Kontext benötigen, weniger als ein frischer Subagent.


1335Wenn Claude einen Fork durch das Agent-Werkzeug spawnt, kann es `isolation: "worktree"` übergeben, sodass die Dateibearbeitungen des Forks in einen separaten Git-Worktree geschrieben werden, anstatt in Ihren Checkout. Ein Fork kann keine weiteren Forks spawnen.1360Wenn Claude einen Fork durch das Agent-Werkzeug spawnt, kann es `isolation: "worktree"` übergeben, sodass die Dateibearbeitungen des Forks in einen separaten Git-Worktree geschrieben werden, anstatt in Ihren Checkout. Ein Fork kann keine weiteren Forks spawnen.

1336 1361 

1337<h3 id="turn-fork-mode-on-or-off">1362<h3 id="turn-fork-mode-on-or-off">

1338 Fork-Modus aktivieren oder deaktivieren1363 Fork-Modus deaktivieren

1339</h3>1364</h3>

1340 1365 

1341Claude Code aktiviert den Fork-Modus standardmäßig in interaktiven Sitzungen und lässt ihn standardmäßig im [nicht-interaktiven Modus](/docs/de/headless) mit `-p` und im Agent SDK deaktiviert. Der interaktive Standard erfordert Claude Code v2.1.232 oder später. In früheren Versionen setzen Sie `CLAUDE_CODE_FORK_SUBAGENT` auf `1`, um den Fork-Modus zu aktivieren.1366Der Fork-Modus ermöglicht es Claude, selbstständig einen Fork zu starten. So verhindern Sie, dass Claude Forks startet:

1342 

1343Sie können erkennen, dass der Fork-Modus aktiviert ist, an der Art und Weise, wie Claude Code das Agent-Werkzeug handhabt:

1344 

1345* Claude kann einen Fork spawnen, indem er den `fork`-Subagenten-Typ anfordert. Wenn Claude keinen Typ anfordert, erhält es den [allgemeinen](#built-in-subagents)-Subagenten, falls die Sitzung diesen Typ noch hat. Subagenten, die aus einer Definition gespawnt werden, wie Explore, funktionieren wie gewohnt.

1346* Claude Code führt die Subagenten, die Claude spawnt, im Hintergrund aus, Forks und Nicht-Fork-Subagenten gleichermaßen, abgesehen von den [Fällen, die im Vordergrund bleiben](#run-subagents-in-foreground-or-background). Claude Code entfernt auch den `run_in_background`-Parameter des Agent-Werkzeugs, sodass Claude nicht den Vordergrund anfordern kann.

1347 

1348Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/de/env-vars), um die Standardwerte zu überschreiben:

1349 1367 

1350* `1` aktiviert den Fork-Modus auch im nicht-interaktiven Modus und im Agent SDK1368* **Nur Forks unterbinden**: Fügen Sie `"Agent(fork)"` zu `permissions.deny` in Ihren [Einstellungen](#disable-specific-subagents) hinzu.

1351* `0` deaktiviert den Fork-Modus in jeder Art von Sitzung1369* **Fork-Modus deaktivieren**: Setzen Sie `CLAUDE_CODE_FORK_SUBAGENT` auf `0` und folgen Sie dabei den Schritten unter [Claude auf einen Subagenten warten lassen](#let-claude-wait-for-a-subagent).

1352 1370 

1353Um den Fork-Modus aktiviert zu halten, aber Claude daran zu hindern, Forks zu spawnen, [verweigern Sie den `fork`-Subagenten-Typ](#disable-specific-subagents) mit einer `Agent(fork)`-Regel. Claude Code führt die Subagenten, die Claude spawnt, weiterhin im Hintergrund aus, abgesehen von den gleichen [Fällen, die im Vordergrund bleiben](#run-subagents-in-foreground-or-background).1371Solange 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](#run-subagents-in-foreground-or-background). Der Fork-Modus ist ab Claude Code v2.1.302 standardmäßig aktiviert, in einer interaktiven Terminal-Sitzung bereits ab v2.1.232.

1354 1372 

1355<h2 id="example-subagents">1373<h2 id="example-subagents">

1356 Beispiel-Subagenten1374 Beispiel-Subagenten

Details

58 58 

59 Wenn Sie die erste Einrichtungsaufforderung des Terminals von Claude Code akzeptiert haben, ist dies bereits erledigt. Diese Aufforderung führt `/terminal-setup` für Sie aus, wodurch Option als Meta aktiviert und die akustische Benachrichtigung in Ihrem Apple Terminal-Profil deaktiviert wird.59 Wenn Sie die erste Einrichtungsaufforderung des Terminals von Claude Code akzeptiert haben, ist dies bereits erledigt. Diese Aufforderung führt `/terminal-setup` für Sie aus, wodurch Option als Meta aktiviert und die akustische Benachrichtigung in Ihrem Apple Terminal-Profil deaktiviert wird.

60 60 

61 Im [Bildschirmlesemodus](/docs/de/accessibility) lässt `/terminal-setup` die Benachrichtigungseinstellung unverändert, sodass die Terminal-Benachrichtigung hörbar bleibt. Vor v2.1.211 deaktivierte `/terminal-setup` die Benachrichtigung auch im Bildschirmlesemodus. Wenn ein früherer Durchlauf die Benachrichtigung deaktiviert hat, aktivieren Sie sie unter Einstellungen → Profile → Erweitert → „Audible bell“ erneut.61 Im [Bildschirmlesemodus](/docs/de/accessibility) lässt `/terminal-setup` die Benachrichtigungseinstellung unverändert, sodass die Terminal-Benachrichtigung hörbar bleibt. Wenn ein früherer Durchlauf die Benachrichtigung deaktiviert hat, aktivieren Sie sie unter Einstellungen → Profile → Erweitert → „Audible bell“ erneut.

62 </Tab>62 </Tab>

63 63 

64 <Tab title="iTerm2">64 <Tab title="iTerm2">

tools-reference.md +34 −34

Details

26| `CronDelete` | Bricht eine geplante Aufgabe nach ID ab | Nein |26| `CronDelete` | Bricht eine geplante Aufgabe nach ID ab | Nein |

27| `CronList` | Listet alle geplanten Aufgaben in der Sitzung auf | Nein |27| `CronList` | Listet alle geplanten Aufgaben in der Sitzung auf | Nein |

28| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Tool-Verhalten](#edit-tool-behavior) | Ja |28| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Tool-Verhalten](#edit-tool-behavior) | Ja |

29| `EndConversation` | Beendet die Sitzung in seltenen Fällen von anhaltendem missbräuchlichem Input oder wenn Sie Claude auffordern, das Tool zu demonstrieren. Erfordert Claude Code v2.1.213 oder später. Siehe [EndConversation-Tool-Verhalten](#endconversation-tool-behavior) | Nein |29| `EndConversation` | Beendet die Sitzung in seltenen Fällen von anhaltendem missbräuchlichem Input oder wenn Sie Claude auffordern, das Tool zu demonstrieren. Siehe [EndConversation-Tool-Verhalten](#endconversation-tool-behavior) | Nein |

30| `EnterPlanMode` | Wechselt in den Plan Mode, um einen Ansatz vor dem Codieren zu entwerfen | Nein |30| `EnterPlanMode` | Wechselt in den Plan Mode, um einen Ansatz vor dem Codieren zu entwerfen | Nein |

31| `EnterWorktree` | Erstellt einen isolierten [Git-Worktree](/docs/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repositorys sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. Ein `path` außerhalb von `.claude/worktrees/` fordert Ihre Genehmigung auf, bevor Sie eintreten, da er das Arbeitsverzeichnis und den Schreibzugriff der Sitzung an diesen Ort verschiebt. Die Erstellung neuer Worktrees und Pfade unter `.claude/worktrees/` fordern nicht auf. Vor v2.1.206 trat Claude Pfaden außerhalb von `.claude/worktrees/` ohne Aufforderung bei. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` des Repositorys der Sitzung liegen | Ja |31| `EnterWorktree` | Erstellt einen isolierten [Git-Worktree](/docs/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repositorys sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. Ein `path` außerhalb von `.claude/worktrees/` fordert Ihre Genehmigung auf, bevor Sie eintreten, da er das Arbeitsverzeichnis und den Schreibzugriff der Sitzung an diesen Ort verschiebt. Die Erstellung neuer Worktrees und Pfade unter `.claude/worktrees/` fordern nicht auf. Vor v2.1.206 trat Claude Pfaden außerhalb von `.claude/worktrees/` ohne Aufforderung bei. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` des Repositorys der Sitzung liegen | Ja |

32| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet den Plan Mode | Ja |32| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet den Plan Mode | Ja |


48| `SendFeedback` | Entwirft einen Feedbackbericht über Claude Code, der ein Produktproblem oder Claudes eigenes Verhalten in der Sitzung abdeckt, und stellt ihn in die Warteschlange auf Ihrer Maschine, damit Sie ihn überprüfen können. Claude Code sendet nichts, bis Sie sich entscheiden, den Entwurf zu senden. Siehe [SendFeedback-Tool-Verhalten](#sendfeedback-tool-behavior). Erfordert Claude Code v2.1.238 oder später | Nein |48| `SendFeedback` | Entwirft einen Feedbackbericht über Claude Code, der ein Produktproblem oder Claudes eigenes Verhalten in der Sitzung abdeckt, und stellt ihn in die Warteschlange auf Ihrer Maschine, damit Sie ihn überprüfen können. Claude Code sendet nichts, bis Sie sich entscheiden, den Entwurf zu senden. Siehe [SendFeedback-Tool-Verhalten](#sendfeedback-tool-behavior). Erfordert Claude Code v2.1.238 oder später | Nein |

49| `SendMessage` | Sendet eine Nachricht an einen anderen Agenten: einen [Agent-Team](/docs/de/agent-teams)-Teamkollegen, einen [Subagenten, den es nach Agent-ID oder Name fortsetzen kann](/docs/de/sub-agents#resume-subagents), oder eine Ihrer anderen Claude-Code-Sitzungen, auf dieser Maschine oder darüber hinaus. Das Messaging anderer Sitzungen erfordert Claude Code v2.1.224 oder später. [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) behandelt, welche Sitzungen Claude erreichen kann, [wie eine Nachricht aussieht, wenn sie ankommt](/docs/de/cross-session-messaging#what-a-message-looks-like), und [wie Claude eine Benachrichtigung erhält, wenn eine andere Sitzung untätig wird](/docs/de/cross-session-messaging#get-a-notice-when-another-session-goes-idle). Claude kann eine optionale `summary`-Eingabe einschließen, typischerweise 5-10 Wörter, die Claude Code als Einzeilenvorschau anzeigt. Wenn Claude sie bei einer [Nur-Text-Nachricht](/docs/de/cross-session-messaging#limitations) auslässt, verwendet Claude Code die erste Zeile der Nachricht als Zusammenfassung. Claude Code schneidet eine Zusammenfassung, die länger als 200 Zeichen ist, mit einer Ellipse ab | Nein |49| `SendMessage` | Sendet eine Nachricht an einen anderen Agenten: einen [Agent-Team](/docs/de/agent-teams)-Teamkollegen, einen [Subagenten, den es nach Agent-ID oder Name fortsetzen kann](/docs/de/sub-agents#resume-subagents), oder eine Ihrer anderen Claude-Code-Sitzungen, auf dieser Maschine oder darüber hinaus. Das Messaging anderer Sitzungen erfordert Claude Code v2.1.224 oder später. [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) behandelt, welche Sitzungen Claude erreichen kann, [wie eine Nachricht aussieht, wenn sie ankommt](/docs/de/cross-session-messaging#what-a-message-looks-like), und [wie Claude eine Benachrichtigung erhält, wenn eine andere Sitzung untätig wird](/docs/de/cross-session-messaging#get-a-notice-when-another-session-goes-idle). Claude kann eine optionale `summary`-Eingabe einschließen, typischerweise 5-10 Wörter, die Claude Code als Einzeilenvorschau anzeigt. Wenn Claude sie bei einer [Nur-Text-Nachricht](/docs/de/cross-session-messaging#limitations) auslässt, verwendet Claude Code die erste Zeile der Nachricht als Zusammenfassung. Claude Code schneidet eine Zusammenfassung, die länger als 200 Zeichen ist, mit einer Ellipse ab | Nein |

50| `SendUserFile` | Sendet Dateien aus der Sitzung an Sie mit einer optionalen Beschriftung, damit ein generierter Bericht, Diagramm, Screenshot oder erstelltes Artefakt Ihr Gerät erreicht, anstatt nur im Transkript erwähnt zu werden. Die optionale `display`-Eingabe steuert die Präsentation: `render` öffnet die Datei inline im Client, `attach` zeigt nur eine Download-Karte an, und wenn nicht gesetzt, entscheidet der Client nach Dateityp. Verfügbar, wenn ein [Remote Control](/docs/de/remote-control)-Client verbunden ist oder in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web). Die Zustellung läuft durch von Anthropic gehostete Infrastruktur, daher ist das Tool nicht auf Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry verfügbar | Nein |50| `SendUserFile` | Sendet Dateien aus der Sitzung an Sie mit einer optionalen Beschriftung, damit ein generierter Bericht, Diagramm, Screenshot oder erstelltes Artefakt Ihr Gerät erreicht, anstatt nur im Transkript erwähnt zu werden. Die optionale `display`-Eingabe steuert die Präsentation: `render` öffnet die Datei inline im Client, `attach` zeigt nur eine Download-Karte an, und wenn nicht gesetzt, entscheidet der Client nach Dateityp. Verfügbar, wenn ein [Remote Control](/docs/de/remote-control)-Client verbunden ist oder in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web). Die Zustellung läuft durch von Anthropic gehostete Infrastruktur, daher ist das Tool nicht auf Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry verfügbar | Nein |

51| `ShareOnboardingGuide` | Lädt `ONBOARDING.md` hoch und gibt einen Share-Link zurück, den Teamkollegen in Claude Code öffnen können. Wird von `/team-onboarding` aufgerufen, nachdem der Leitfaden geschrieben wurde. Verfügbar für claude.ai-Abonnenten auf Pro-, Max-, Team- und Enterprise-Plänen | Ja |51| `ShareOnboardingGuide` | Lädt `ONBOARDING.md` hoch und gibt einen Share-Link zurück, den Teamkollegen in Claude Code öffnen können. Wird von `/team-onboarding` aufgerufen, nachdem der Leitfaden geschrieben wurde. Verfügbar für claude.ai-Abonnenten auf Team- und Enterprise-Plänen | Ja |

52| `Skill` | Führt einen [Skill](/docs/de/skills#control-who-invokes-a-skill) innerhalb des Hauptgesprächs aus | Ja |52| `Skill` | Führt einen [Skill](/docs/de/skills#control-who-invokes-a-skill) innerhalb des Hauptgesprächs aus | Ja |

53| `SubagentHandback` | Liefert den abschließenden Bericht eines Subagenten an das Gespräch, das das Ergebnis dieses Subagenten erhält. Wird nur im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) bereitgestellt, für Subagenten, die das Agent-Tool lokal ausführt, außer [Forks](/docs/de/sub-agents#fork-the-current-conversation), und ist in der Terminal-CLI, IDE-Erweiterungen, Cloud-Sitzungen und dem Agent SDK verfügbar; der Klassifizierer überprüft den Bericht, bevor er zugestellt wird. Erfordert Claude Code v2.1.271 oder später | Nein |53| `SubagentHandback` | Liefert den abschließenden Bericht eines Subagenten an das Gespräch, das das Ergebnis dieses Subagenten erhält. Wird nur im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) bereitgestellt, für Subagenten, die das Agent-Tool lokal ausführt, außer [Forks](/docs/de/sub-agents#fork-the-current-conversation), und ist in der Terminal-CLI, IDE-Erweiterungen, Cloud-Sitzungen und dem Agent SDK verfügbar; der Klassifizierer überprüft den Bericht, bevor er zugestellt wird. Erfordert Claude Code v2.1.271 oder später | Nein |

54| `TaskCreate` | Erstellt eine neue Aufgabe in der Aufgabenliste. Wird standardmäßig nur auf den Modellen bereitgestellt, die unter [Task-Tool-Verfügbarkeit](#task-tool-availability) aufgelistet sind, und auf anderen Modellen, wenn Sie sich dafür entscheiden | Nein |54| `TaskCreate` | Erstellt eine neue Aufgabe in der Aufgabenliste. Wird standardmäßig nur auf den Modellen bereitgestellt, die unter [Task-Tool-Verfügbarkeit](#task-tool-availability) aufgelistet sind, und auf anderen Modellen, wenn Sie sich dafür entscheiden | Nein |


92 92 

93Tools, die hier nicht aufgeführt sind, wie `ExitPlanMode` oder `ShareOnboardingGuide`, akzeptieren nur den bloßen Tool-Namen ohne Specifier.93Tools, die hier nicht aufgeführt sind, wie `ExitPlanMode` oder `ShareOnboardingGuide`, akzeptieren nur den bloßen Tool-Namen ohne Specifier.

94 94 

95Eine `Edit(...)`-Erlaubnisregel gewährt auch Lesezugriff auf denselben Pfad, sodass Sie keine entsprechende `Read(...)`-Regel benötigen. Eine `Read(...)`-Verweigerungsregel blockiert auch die Tools Edit und Write auf demselben Pfad, einschließlich der Erstellung einer neuen Datei dort, da beide Tools Inhalte ändern, die Claude zurücklesen können muss. Die `Read`-Verweigerungsprüfung erfordert Claude Code v2.1.208 oder später bei Bearbeitungen, und v2.1.228 oder später bei Schreibvorgängen.95Eine `Edit(...)`-Erlaubnisregel gewährt auch Lesezugriff auf denselben Pfad, sodass Sie keine entsprechende `Read(...)`-Regel benötigen. Eine `Read(...)`-Verweigerungsregel blockiert auch die Tools Edit und Write auf demselben Pfad, einschließlich der Erstellung einer neuen Datei dort, da beide Tools Inhalte ändern, die Claude zurücklesen können muss. Für das Write-Tool erfordert die `Read`-Verweigerungsprüfung Claude Code v2.1.228 oder später.

96 96 

97Hook-`matcher`-Felder verwenden bloße Tool-Namen, nicht das geklammerte Regelformat. Siehe [Matcher-Muster](/docs/de/hooks#matcher-patterns) für die Matching-Regeln. Für die Feldnamen, die jedes Tool an `tool_input` in Hooks übergibt, siehe die [PreToolUse-Eingabereferenz](/docs/de/hooks#pretooluse-input).97Hook-`matcher`-Felder verwenden bloße Tool-Namen, nicht das geklammerte Regelformat. Siehe [Matcher-Muster](/docs/de/hooks#matcher-patterns) für die Matching-Regeln. Für die Feldnamen, die jedes Tool an `tool_input` in Hooks übergibt, siehe die [PreToolUse-Eingabereferenz](/docs/de/hooks#pretooluse-input).

98 98 


100 Verhalten des Agent-Tools100 Verhalten des Agent-Tools

101</h2>101</h2>

102 102 

103Das Agent-Tool startet einen Subagenten in einem separaten Kontextfenster. Der Subagent arbeitet seine Aufgabe autonom ab und gibt dann sein Ergebnis an das übergeordnete Gespräch zurück. Das übergeordnete Gespräch sieht nicht die Zwischentool-Aufrufe oder Ausgaben des Subagenten, sondern nur dieses Endergebnis. Mit aktivierten [Agent-Teams](/docs/de/agent-teams) kann ein Aufruf mit einem `name` einen [Teamkollegen](/docs/de/agent-teams#how-claude-starts-agent-teams) starten, der stattdessen über Team-Nachrichten berichtet, anstatt ein Ergebnis zurückzugeben.103Das Agent-Tool startet einen Subagenten in einem separaten Kontextfenster. Der Subagent arbeitet seine Aufgabe autonom ab und gibt dann sein Ergebnis an die übergeordnete Konversation zurück. Die übergeordnete Konversation sieht nicht die Zwischentool-Aufrufe oder Ausgaben des Subagenten, sondern nur dieses Endergebnis. Dasselbe Tool kann auch einen Teamkollegen oder einen Fork starten:

104 104 

105Um die Anzahl der Durchläufe eines Subagenten zu begrenzen, setzen Sie `maxTurns` in der [Subagenten-Definition](/docs/de/sub-agents#supported-frontmatter-fields). Wenn der Subagent das Limit erreicht, markiert Claude Code das zurückgegebene Ergebnis als Teilausgabe, und Claude kann [den Subagenten fortsetzen](/docs/de/sub-agents#resume-subagents), um fortzufahren.105* **Teamkollege**: Mit aktivierten [Agent-Teams](/docs/de/agent-teams) kann ein Aufruf mit einem `name` stattdessen einen [Teamkollegen](/docs/de/agent-teams#how-claude-starts-agent-teams) starten, der über Team-Nachrichten berichtet, anstatt ein Ergebnis zurückzugeben

106* **Fork**: Überall dort, wo der [Fork-Modus](/docs/de/sub-agents#turn-fork-mode-on-or-off) aktiviert ist, kann das Tool einen [abgespaltenen Subagenten](/docs/de/sub-agents#fork-the-current-conversation) starten, der die vollständige übergeordnete Konversation erbt, anstatt neu zu beginnen

106 107 

107Das gleiche Agent-Tool startet auch [abgespaltene Subagenten](/docs/de/sub-agents#fork-the-current-conversation) überall dort, wo [Fork-Modus](/docs/de/sub-agents#turn-fork-mode-on-or-off) aktiviert ist. Ein Fork erbt das vollständige übergeordnete Gespräch, anstatt neu zu beginnen, läuft im Hintergrund außer in den [Fällen, die im Vordergrund bleiben](/docs/de/sub-agents#run-subagents-in-foreground-or-background), und zeigt dennoch Berechtigungsaufforderungen in Ihrem Terminal an. Der Rest dieses Abschnitts beschreibt Nicht-Fork-Subagenten.108Um die Anzahl der Durchläufe eines Subagenten zu begrenzen, setzen Sie `maxTurns` in der [Subagenten-Definition](/docs/de/sub-agents#supported-frontmatter-fields). Wenn der Subagent das Limit erreicht, markiert Claude Code das zurückgegebene Ergebnis als Teilausgabe, und Claude kann [den Subagenten fortsetzen](/docs/de/sub-agents#resume-subagents), um fortzufahren.

108 109 

109Welche Tools ein Nicht-Fork-Subagent verwenden kann, hängt von den Feldern `tools` und `disallowedTools` in der [Subagenten-Definition](/docs/de/sub-agents) ab:110Welche Tools ein Nicht-Fork-Subagent verwenden kann, hängt von den Feldern `tools` und `disallowedTools` in der [Subagenten-Definition](/docs/de/sub-agents) ab:

110 111 


154 Was zwischen Befehlen erhalten bleibt155 Was zwischen Befehlen erhalten bleibt

155</h3>156</h3>

156 157 

157* Wenn Claude `cd` in der Hauptsitzung ausführt, wird das neue Arbeitsverzeichnis zu späteren Bash-Befehlen übernommen, solange es sich im Projektverzeichnis oder einem [zusätzlichen Arbeitsverzeichnis](/docs/de/permissions#working-directories) befindet, das Sie mit `--add-dir`, `/add-dir` oder `additionalDirectories` in den Einstellungen hinzugefügt haben. Dies umfasst Befehle, die Claude in Reaktion auf Ihre späteren Nachrichten ausführt.158* Wenn Claude `cd` in der Hauptsitzung ausführt, wird das neue Arbeitsverzeichnis zu späteren Bash-Befehlen übernommen, solange es sich im Projektverzeichnis oder einem [zusätzlichen Arbeitsverzeichnis](/docs/de/permissions#working-directories) befindet, das Sie mit `--add-dir`, `/add-dir` oder `additionalDirectories` in den Einstellungen hinzugefügt haben. Dies umfasst Befehle, die Claude als Antwort auf Ihre späteren Nachrichten ausführt.

158 * Subagent-Sitzungen übernehmen niemals Änderungen des Arbeitsverzeichnisses.159 * Subagent-Sitzungen übernehmen niemals Änderungen des Arbeitsverzeichnisses.

159 * Wenn `cd` außerhalb dieser Verzeichnisse landet, setzt Claude Code auf das Projektverzeichnis zurück und fügt `Shell cwd was reset to <dir>` zum Tool-Ergebnis hinzu.160 * Wenn `cd` außerhalb dieser Verzeichnisse landet, setzt Claude Code auf das Projektverzeichnis zurück und fügt `Shell cwd was reset to <dir>` zum Tool-Ergebnis hinzu.

160 * Um diese Übernahme zu deaktivieren, damit jeder Bash-Befehl im Projektverzeichnis startet, setzen Sie `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.161 * Um diese Übernahme zu deaktivieren, damit jeder Bash-Befehl im Projektverzeichnis startet, setzen Sie `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.


279 280 

280Das Edit-Tool führt exakte Zeichenkettenersetzung durch. Es nimmt einen `old_string` und einen `new_string` und ersetzt den ersten durch den zweiten. Es verwendet weder Regex noch Fuzzy Matching.281Das Edit-Tool führt exakte Zeichenkettenersetzung durch. Es nimmt einen `old_string` und einen `new_string` und ersetzt den ersten durch den zweiten. Es verwendet weder Regex noch Fuzzy Matching.

281 282 

282Diese Überprüfungen müssen bestanden werden, damit eine Bearbeitung angewendet wird. Bevor eine davon durchgeführt wird, wird ein Pfad, der einer [`Read`-Ablehnungsregel](/docs/de/permissions#tool-specific-permission-rules) entspricht, abgelehnt, einschließlich der Erstellung einer neuen Datei dort. Die Ablehnung erfordert Claude Code v2.1.208 oder später.283Diese Überprüfungen müssen bestanden werden, damit eine Bearbeitung angewendet wird. Bevor eine davon durchgeführt wird, wird ein Pfad, der einer [`Read`-Ablehnungsregel](/docs/de/permissions#tool-specific-permission-rules) entspricht, abgelehnt, einschließlich der Erstellung einer neuen Datei dort.

283 284 

284* **Read-before-edit**: Claude liest die Datei in der aktuellen Konversation, bevor er sie bearbeitet, und ein Lesezugriff, der mit einer [`PARTIAL view`-Benachrichtigung](#large-files) unterbrochen wird, zählt nicht. Claude Opus 4.6, Claude Haiku 4.5 und ältere Modelle erfordern immer das Lesen. Neuere Modelle können eine ungelesene Datei bearbeiten, wenn das Lesen keine Berechtigungsabfrage erfordern würde und das Read-Tool verfügbar ist.285* **Read-before-edit**: Claude liest die Datei in der aktuellen Konversation, bevor er sie bearbeitet, und ein Lesezugriff, der mit einer [`PARTIAL view`-Benachrichtigung](#large-files) unterbrochen wird, zählt nicht. Claude Opus 4.6, Claude Haiku 4.5 und ältere Modelle erfordern immer das Lesen. Neuere Modelle können eine ungelesene Datei bearbeiten, wenn das Lesen keine Berechtigungsabfrage erfordern würde und das Read-Tool verfügbar ist.

285* **Match**: `old_string` muss genau wie geschrieben in der Datei vorkommen. Ein einzelnes Zeichen Unterschied in Leerzeichen oder Einrückung reicht aus, um nicht zu treffen.286* **Match**: `old_string` muss genau wie geschrieben in der Datei vorkommen. Ein einzelnes Zeichen Unterschied in Leerzeichen oder Einrückung reicht aus, um nicht zu treffen.

286* **Eindeutigkeit**: `old_string` muss genau einmal vorkommen. Wenn es mehr als einmal vorkommt, stellt Claude entweder eine längere Zeichenkette mit ausreichend umgebendem Kontext bereit, um ein Vorkommen festzulegen, oder setzt `replace_all: true`, um alle zu ersetzen.287* **Eindeutigkeit**: `old_string` muss genau einmal vorkommen. Wenn es mehr als einmal vorkommt, stellt Claude entweder eine längere Zeichenkette mit ausreichend umgebendem Kontext bereit, um ein Vorkommen festzulegen, oder setzt `replace_all: true`, um alle zu ersetzen.

287 288 

288Eine Datei, die sich auf der Festplatte geändert hat, nachdem Claude sie zuletzt gelesen hat, kann immer noch bearbeitet werden, wenn `old_string` genau und eindeutig dem aktuellen Inhalt entspricht und Claude Code die Datei ohne Aufforderung lesen kann. Das Abgleichen mit dem aktuellen Inhalt der Datei hält dies sicher, und das Ergebnis vermerkt, dass die Datei weitere Änderungen enthält, damit Claude sie vor Bearbeitungen, die auf umgebendem Inhalt basieren, erneut liest. In jedem anderen Fall, z. B. bei einem veralteten `old_string` oder einem, der mehr als einmal ohne `replace_all` übereinstimmt, liest Claude die Datei vor der Bearbeitung erneut. Die gelockerte Behandlung von ungelesenen und geänderten Dateien erfordert Claude Code v2.1.208 oder später; davor lehnte Claude Code jede Bearbeitung einer Datei ab, die es in der Konversation nicht gelesen hatte oder die sich auf der Festplatte nach dem Lesen geändert hatte.289Eine Datei, die sich auf der Festplatte geändert hat, nachdem Claude sie zuletzt gelesen hat, kann immer noch bearbeitet werden, wenn `old_string` genau und eindeutig dem aktuellen Inhalt entspricht und Claude Code die Datei ohne Nachfrage lesen kann. Das Abgleichen mit dem aktuellen Inhalt der Datei hält dies sicher, und das Ergebnis vermerkt, dass die Datei weitere Änderungen enthält, damit Claude sie vor Bearbeitungen, die auf umgebendem Inhalt basieren, erneut liest. In jedem anderen Fall, z. B. bei einem veralteten `old_string` oder einem, der mehr als einmal ohne `replace_all` übereinstimmt, liest Claude die Datei vor der Bearbeitung erneut.

289 290 

290Claude kann eine Datei auch ohne separates Read bearbeiten, nachdem es die Datei mit einem Bash-Befehl wie `cat` oder `grep` angezeigt hat. Diese Befehle sind `cat`, `nl`, `bat`, `batcat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep`, `fgrep` und `rg`, jeweils auf einer einzelnen Datei ohne Pipes oder Umleitungen ausgeführt. Eine Suche, die keine Treffer ausgibt, zählt nicht als Lesen, ebenso wenig wie ein Befehl außerhalb dieser Liste.291Claude kann eine Datei auch ohne separates Read bearbeiten, nachdem es die Datei mit einem Bash-Befehl wie `cat` oder `grep` angezeigt hat. Diese Befehle sind `cat`, `nl`, `bat`, `batcat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep`, `fgrep` und `rg`, jeweils auf einer einzelnen Datei ohne Pipes oder Umleitungen ausgeführt. Eine Suche, die keine Treffer ausgibt, zählt nicht als Lesen, ebenso wenig wie ein Befehl außerhalb dieser Liste.

291 292 


322 323 

323Das Tool wird nur angezeigt, wenn alle folgenden Bedingungen erfüllt sind:324Das Tool wird nur angezeigt, wenn alle folgenden Bedingungen erfüllt sind:

324 325 

325* **Version**: Claude Code v2.1.213 oder später.

326* **Modell**: Das Modell der Sitzung ist Claude Opus 4.8, Claude Sonnet 5, Claude Fable 5 oder eine neuere Version einer dieser Familien.326* **Modell**: Das Modell der Sitzung ist Claude Opus 4.8, Claude Sonnet 5, Claude Fable 5 oder eine neuere Version einer dieser Familien.

327* **Oberfläche**: eine interaktive Terminalsitzung, einschließlich einer `claude`-Sitzung im integrierten Terminal einer IDE, wie der [JetBrains-Plugin](/docs/de/jetbrains) sie ausführt. Andere Oberflächen enthalten das Tool nicht, wie zum Beispiel:327* **Oberfläche**: eine interaktive Terminalsitzung, einschließlich einer `claude`-Sitzung im integrierten Terminal einer IDE, wie der [JetBrains-Plugin](/docs/de/jetbrains) sie ausführt. Andere Oberflächen enthalten das Tool nicht, wie zum Beispiel:

328 * nicht-interaktive `-p`-Läufe328 * nicht-interaktive `-p`-Läufe


334* **Anbieter**: nicht verfügbar auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) oder [Microsoft Foundry](/docs/de/microsoft-foundry), oder auf Sitzungen, die sich über ein [Cloud-Gateway](/docs/de/claude-apps-gateway) anmelden.334* **Anbieter**: nicht verfügbar auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) oder [Microsoft Foundry](/docs/de/microsoft-foundry), oder auf Sitzungen, die sich über ein [Cloud-Gateway](/docs/de/claude-apps-gateway) anmelden.

335 335 

336<h2 id="glob-tool-behavior">336<h2 id="glob-tool-behavior">

337 Glob-Werkzeugverhalten337 Verhalten des Glob-Tools

338</h2>338</h2>

339 339 

340Das Glob-Werkzeug findet Dateien nach Namensmuster. Unter Windows ist es Teil des Standard-Werkzeugsatzes. Auf macOS, Linux und WSL lässt Claude Code Glob und [Grep](#grep-tool-behavior) aus dem Standard-Werkzeugsatz aus, und Claude sucht mit `find` und `grep` über das Bash-Werkzeug. In Claudes Shell führen diese beiden Befehle eingebettete Versionen von `bfs` und `ugrep` aus, und die Suchen erreichen Ihre Hooks und Berechtigungsregeln als `Bash`-Aufrufe.340Das Glob-Tool findet Dateien nach Namensmuster. Unter Windows ist es Teil des Standard-Toolsatzes. Auf macOS, Linux und WSL lässt Claude Code Glob und [Grep](#grep-tool-behavior) aus dem Standard-Toolsatz aus, und Claude sucht stattdessen mit `find` und `grep` über das Bash-Tool. In Claudes Shell führen diese beiden Befehle eingebettete Versionen von `bfs` und `ugrep` aus, und die Suchen erreichen Ihre Hooks und Berechtigungsregeln als `Bash`-Aufrufe.

341 341 

342Auf macOS, Linux und WSL erhalten Sie die Glob- und Grep-Werkzeuge in diesen Fällen zurück:342Auf macOS, Linux und WSL erhalten Sie die Glob- und Grep-Tools in diesen Fällen zurück:

343 343 

344* Sie benennen `Glob` oder `Grep` in [`--tools` oder `--allowedTools`](/docs/de/cli-reference#cli-flags), wenn Sie die Sitzung starten, oder in den entsprechenden [Agent SDK](/docs/de/agent-sdk/overview)-Optionen. Mit `--tools` erhalten Sie die, die Sie auflisten, und das Benennen eines der beiden Werkzeuge in `--allowedTools` stellt beide wieder her. Eine Allow-Regel in einer Einstellungsdatei hat diese Auswirkung nicht.344* Sie benennen `Glob` oder `Grep` in [`--tools` oder `--allowedTools`](/docs/de/cli-reference#cli-flags), wenn Sie die Sitzung starten, oder in den entsprechenden [Agent SDK](/docs/de/agent-sdk/overview)-Optionen. Mit `--tools` erhalten Sie die, die Sie auflisten, und das Benennen eines der beiden Tools in `--allowedTools` stellt beide wieder her. Eine allow-Regel in einer Einstellungsdatei hat diese Auswirkung nicht.

345* Eine Berechtigungen-[Deny-Regel](/docs/de/permissions#match-all-uses-of-a-tool), das Flag `--disallowedTools` oder [`--restricted`](/docs/de/cli-reference#cli-flags) entfernt `Bash` aus der Sitzung.345* Eine [deny-Regel](/docs/de/permissions#match-all-uses-of-a-tool) in den Berechtigungen, das Flag `--disallowedTools` oder [`--restricted`](/docs/de/cli-reference#cli-flags) entfernt `Bash` aus der Sitzung.

346* Ein [Subagent](/docs/de/sub-agents#available-tools) listet `Glob` oder `Grep` in seinem `tools`-Feld auf und lässt `Bash` aus. Die aufgelisteten Werkzeuge kommen für diesen Subagenten nur zurück, oder für die gesamte Sitzung, wenn er als Hauptsitzungs-Agent über [`--agent`](/docs/de/sub-agents#invoke-subagents-explicitly) oder die `agent`-Einstellung ausgeführt wird.346* Ein [Subagent](/docs/de/sub-agents#available-tools) listet `Glob` oder `Grep` in seinem `tools`-Feld auf und lässt `Bash` aus. Die aufgelisteten Tools kommen nur für diesen Subagenten zurück, oder für die gesamte Sitzung, wenn er als Hauptsitzungs-Agent über [`--agent`](/docs/de/sub-agents#invoke-subagents-explicitly) oder die `agent`-Einstellung ausgeführt wird.

347 347 

348Glob unterstützt Standard-Glob-Syntax einschließlich `**` für rekursives Verzeichnis-Matching:348Glob unterstützt Standard-Glob-Syntax einschließlich `**` für rekursives Verzeichnis-Matching:

349 349 

350* `**/*.js` passt alle `.js`-Dateien in beliebiger Tiefe350* `**/*.js` passt auf alle `.js`-Dateien in beliebiger Tiefe

351* `src/**/*.ts` passt alle `.ts`-Dateien unter `src/`351* `src/**/*.ts` passt auf alle `.ts`-Dateien unter `src/`

352* `*.{json,yaml}` passt `.json`- und `.yaml`-Dateien im aktuellen Verzeichnis352* `*.{json,yaml}` passt auf `.json`- und `.yaml`-Dateien im aktuellen Verzeichnis

353 353 

354Ergebnisse werden nach Änderungszeit sortiert und auf 100 Dateien begrenzt. Wenn die Obergrenze erreicht wird, sieht Claude ein Kürzungsflag im Ergebnis und kann das Muster verengen.354Ergebnisse werden nach Änderungszeit sortiert und auf 100 Dateien begrenzt. Wenn die Obergrenze erreicht wird, sieht Claude ein Kürzungsflag im Ergebnis und kann das Muster eingrenzen.

355 355 

356Glob respektiert `.gitignore` standardmäßig nicht, daher findet es gitignorierte Dateien neben verfolgten. Dies unterscheidet sich von [Grep](#grep-tool-behavior), das gitignorierte Dateien überspringt. Um Glob `.gitignore` respektieren zu lassen, setzen Sie `CLAUDE_CODE_GLOB_NO_IGNORE=false`, bevor Sie Claude Code starten.356Glob respektiert `.gitignore` standardmäßig nicht, daher findet es gitignorierte Dateien neben verfolgten. Dies unterscheidet sich von [Grep](#grep-tool-behavior), das gitignorierte Dateien überspringt. Um Glob `.gitignore` respektieren zu lassen, setzen Sie `CLAUDE_CODE_GLOB_NO_IGNORE=false`, bevor Sie Claude Code starten.

357 357 

358Claude Code entscheidet über die Berechtigung für einen Glob-Aufruf, bevor es überprüft, ob das Suchverzeichnis existiert. Es führt immer noch die Leseberechtigung-Überprüfung für einen fehlenden `path` außerhalb der [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) durch, daher bedeutet eine Berechtigungsaufforderung für einen Pfad nicht, dass der Pfad existiert.358Claude Code entscheidet über die Berechtigung für einen Glob-Aufruf, bevor es überprüft, ob das Suchverzeichnis existiert. Es führt dennoch die Prüfung der Leseberechtigung für einen fehlenden `path` außerhalb der [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) durch, daher bedeutet eine Berechtigungsabfrage für einen Pfad nicht, dass der Pfad existiert.

359 359 

360Ein `pattern`- oder `path`-Wert, der ein Null-Byte enthält, gibt einen Fehler zurück, der Claude auffordert, ihn zu entfernen.&#x20;360Ein `pattern`- oder `path`-Wert, der ein Null-Byte enthält, gibt einen Fehler zurück, der Claude auffordert, es zu entfernen.

361 361 

362<h2 id="grep-tool-behavior">362<h2 id="grep-tool-behavior">

363 Grep-Werkzeugverhalten363 Grep-Werkzeugverhalten


373 373 

374* `files_with_matches`: nur Dateipfade, kein Zeileninhalt. Dies ist die Standardeinstellung.374* `files_with_matches`: nur Dateipfade, kein Zeileninhalt. Dies ist die Standardeinstellung.

375* `content`: übereinstimmende Zeilen mit Datei und Zeilennummer. Wenn der `offset`-Parameter des Werkzeugs über den letzten Treffer für ein Muster hinausweist, das Treffer hat, gibt Grep `No entries at this offset` zurück, sodass Claude den Offset vergrößert oder zurückgesetzt wird, anstatt zu dem Ergebnis zu kommen, dass das Muster nicht passt.375* `content`: übereinstimmende Zeilen mit Datei und Zeilennummer. Wenn der `offset`-Parameter des Werkzeugs über den letzten Treffer für ein Muster hinausweist, das Treffer hat, gibt Grep `No entries at this offset` zurück, sodass Claude den Offset vergrößert oder zurückgesetzt wird, anstatt zu dem Ergebnis zu kommen, dass das Muster nicht passt.

376* `count`: Übereinstimmungsanzahl pro Datei, gefolgt von einer Gesamtsumme über alle übereinstimmenden Dateien. Die Gesamtsumme umfasst jeden Treffer, auch wenn die Parameter `head_limit` oder `offset` des Werkzeugs die aufgelisteten Pro-Datei-Einträge kürzen. Vor v2.1.208 summierte die Gesamtsumme nur die aufgelisteten Einträge.376* `count`: Übereinstimmungsanzahl pro Datei, gefolgt von einer Gesamtsumme über alle übereinstimmenden Dateien. Die Gesamtsumme umfasst jeden Treffer, auch wenn die Parameter `head_limit` oder `offset` des Werkzeugs die aufgelisteten Pro-Datei-Einträge kürzen.

377 377 

378Claude kann Ergebnisse nach Datei mit dem `glob`-Parameter wie `**/*.tsx` oder nach Sprache mit dem `type`-Parameter wie `py` oder `rust` eingrenzen. Standardmäßig passen Muster innerhalb einer einzelnen Zeile. Claude kann `multiline: true` setzen, um über Zeilengrenzen hinweg zu passen.378Claude kann Ergebnisse nach Datei mit dem `glob`-Parameter wie `**/*.tsx` oder nach Sprache mit dem `type`-Parameter wie `py` oder `rust` eingrenzen. Standardmäßig passen Muster innerhalb einer einzelnen Zeile. Claude kann `multiline: true` setzen, um über Zeilengrenzen hinweg zu passen.

379 379 


536 Windows-Codierung und Exitcodes536 Windows-Codierung und Exitcodes

537</h3>537</h3>

538 538 

539Unter Windows erfordern die folgenden PowerShell-Codierungs- und Exitcode-Verhaltensweisen Claude Code v2.1.214 oder später:

540 

541* Umleitung mit `>` und `>>` schreibt UTF-8-Dateien auf PowerShell 5.1539* Umleitung mit `>` und `>>` schreibt UTF-8-Dateien auf PowerShell 5.1

542* Claude Code codiert Text, der an die Standardeingabe eines nativen Befehls weitergeleitet wird, als UTF-8540* Claude Code codiert Text, der an die Standardeingabe eines nativen Befehls weitergeleitet wird, als UTF-8

543* Claude Code erfasst Fehlerausgabe ohne ANSI-Escape-Sequenzen541* Claude Code erfasst Fehlerausgabe ohne ANSI-Escape-Sequenzen

544* Ein Befehl, dessen untergeordneter Prozess auf die Standardeingabe wartet, erhält das Dateiende statt zu hängen542* Ein Befehl, dessen untergeordneter Prozess auf die Standardeingabe wartet, erhält das Dateiende statt zu hängen

545* 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 1543* 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 1

546 544 

547Vor v2.1.214 schrieb `>` auf PowerShell 5.1 UTF-16LE-Dateien, nicht-ASCII-weitergeleitete Eingaben kamen als `?` an, und Python-Skripte konnten mit einem `UnicodeEncodeError` abstürzen, wenn nicht-ASCII-Zeichen gedruckt wurden.

548 

549<h3 id="preview-limitations">545<h3 id="preview-limitations">

550 Vorschaubeschränkungen546 Vorschaubeschränkungen

551</h3>547</h3>


561 557 

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

563 559 

564Das Lesen einer leeren Datei gibt eine Benachrichtigung zurück, dass die Datei existiert, aber ihr Inhalt leer ist, und ein `offset` nach der letzten Zeile gibt eine Benachrichtigung zurück, die die Zeilenanzahl der Datei angibt. Vor v2.1.208 gab das Lesen einer leeren Datei stattdessen die Past-the-End-Benachrichtigung zurück.560Das Lesen einer leeren Datei gibt eine Benachrichtigung zurück, dass die Datei existiert, aber ihr Inhalt leer ist, und ein `offset` nach der letzten Zeile gibt eine Benachrichtigung zurück, die die Zeilenanzahl der Datei angibt.

565 561 

566Read verarbeitet mehrere Dateitypen über reinen Text hinaus:562Read verarbeitet mehrere Dateitypen über reinen Text hinaus:

567 563 

568* **Bilder**: PNG, JPG und andere Bildformate 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. Ein Bild, das nach dieser Größenänderung immer noch größer als 500 KB ist, wird als JPEG mit reduzierter Qualität mit seinen unveränderten Pixeldimensionen neu codiert. Wenn Claude feine Pixel-Details in einem großen Bild übersieht, bitten Sie es, zuerst die Region von Interesse zuzuschneiden, beispielsweise mit ImageMagick über Bash.564* **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.

565 

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

569* **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.567* **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.

570* **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.568* **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.

571 569 

572Read liest nur Dateien, keine Verzeichnisse. Claude listet Verzeichnisinhalte mit einem Shell-Befehl wie `ls` auf.570Read liest nur Dateien, keine Verzeichnisse. Claude listet Verzeichnisinhalte mit einem Shell-Befehl wie `ls` auf.

573 571 

572Read lehnt eine Datei ab, deren Erweiterung es als binär behandelt, wie `.xlsx`, `.parquet`, `.heic` oder `.zip`. Claude arbeitet nach einer Ablehnung weiter: Der Fehler schlägt einen Skill für diesen Dateityp vor, sofern einer verfügbar ist, oder andernfalls einen Shell-Befehl oder ein Skript, das das Format liest. Wenn Sie eine Datei, die Read ablehnt, per [`@`-Erwähnung](/docs/de/common-workflows#reference-files-and-directories) referenzieren, erhält Claude den Pfad der Datei, aber nicht ihren Inhalt.

573 

574<h3 id="large-files">574<h3 id="large-files">

575 Große Dateien575 Große Dateien

576</h3>576</h3>


691* WebFetch speichert jede Antwort standardmäßig 15 Minuten lang zwischen, sodass wiederholte Abrufe derselben URL schnell zurückgegeben werden. Auf Claude Code v2.1.233 oder später können Sie [`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](/docs/de/env-vars#variables) setzen, um zu ändern, wie lange WebFetch jede Antwort speichert.691* WebFetch speichert jede Antwort standardmäßig 15 Minuten lang zwischen, sodass wiederholte Abrufe derselben URL schnell zurückgegeben werden. Auf Claude Code v2.1.233 oder später können Sie [`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](/docs/de/env-vars#variables) setzen, um zu ändern, wie lange WebFetch jede Antwort speichert.

692* Eine Seite, die nicht innerhalb von fünf Minuten heruntergeladen wird, einschließlich aller Umleitungen, denen WebFetch folgt, schlägt mit einem Deadline-Fehler fehl. Auf Claude Code v2.1.268 oder später können Sie [`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](/docs/de/env-vars#variables) setzen, um das Limit zu ändern, oder auf `0`, um es zu entfernen.692* Eine Seite, die nicht innerhalb von fünf Minuten heruntergeladen wird, einschließlich aller Umleitungen, denen WebFetch folgt, schlägt mit einem Deadline-Fehler fehl. Auf Claude Code v2.1.268 oder später können Sie [`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](/docs/de/env-vars#variables) setzen, um das Limit zu ändern, oder auf `0`, um es zu entfernen.

693* Wenn eine URL zu einem anderen Host umleitet, gibt WebFetch ein Textergebnis zurück, das die ursprüngliche URL und das Umleitungsziel benennt, anstatt ihr zu folgen. Claude ruft dann die neue URL mit einem zweiten WebFetch-Aufruf ab.693* Wenn eine URL zu einem anderen Host umleitet, gibt WebFetch ein Textergebnis zurück, das die ursprüngliche URL und das Umleitungsziel benennt, anstatt ihr zu folgen. Claude ruft dann die neue URL mit einem zweiten WebFetch-Aufruf ab.

694* Wenn der Extraktionsschritt eine überladene API trifft, versucht Claude Code es mit Backoff erneut; ein Abruf, der immer noch fehlschlägt, gibt ein Fehlerergebnis zurück. Vor v2.1.212 konnte der API-Fehlertext Claude erreichen, als wäre er der extrahierte Seiteninhalt.694* Wenn der Extraktionsschritt eine überladene API trifft, versucht Claude Code es mit Backoff erneut; ein Abruf, der immer noch fehlschlägt, gibt ein Fehlerergebnis zurück.

695 695 

696In Manual und `acceptEdits` [Berechtigungsmodi](/docs/de/permission-modes) fordert WebFetch vor dem Abruf auf, außer für Domänen, die Ihre [Berechtigungsregeln](/docs/de/permissions#manage-permissions) bereits zulassen oder ablehnen, und eine integrierte Reihe von genehmigten Dokumentationsdomänen, die ohne Eingabeaufforderung abgerufen werden. Unabhängig davon, was Ihre Regeln zulassen, muss ein Abruf auch zuerst die [WebFetch-Domänensicherheitsprüfung](/docs/de/data-usage#webfetch-domain-safety-check) bestehen; dieser Abschnitt behandelt, was die Prüfung sendet und die Einstellung, die sie überspringt. Die Eingabeaufforderung bietet drei Optionen:696In Manual und `acceptEdits` [Berechtigungsmodi](/docs/de/permission-modes) fordert WebFetch vor dem Abruf auf, außer für Domänen, die Ihre [Berechtigungsregeln](/docs/de/permissions#manage-permissions) bereits zulassen oder ablehnen, und eine integrierte Reihe von genehmigten Dokumentationsdomänen, die ohne Eingabeaufforderung abgerufen werden. Unabhängig davon, was Ihre Regeln zulassen, muss ein Abruf auch zuerst die [WebFetch-Domänensicherheitsprüfung](/docs/de/data-usage#webfetch-domain-safety-check) bestehen; dieser Abschnitt behandelt, was die Prüfung sendet und die Einstellung, die sie überspringt. Die Eingabeaufforderung bietet drei Optionen:

697 697 


715 715 

716Auf Claude Code v2.1.285 oder später können Sie [`CLAUDE_CODE_DISABLE_WEB_FETCH`](/docs/de/env-vars#variables) auf `1` setzen, um WebFetch auszuschalten.716Auf Claude Code v2.1.285 oder später können Sie [`CLAUDE_CODE_DISABLE_WEB_FETCH`](/docs/de/env-vars#variables) auf `1` setzen, um WebFetch auszuschalten.

717 717 

718Wenn Sie sich mit einem Team- oder Enterprise-claude.ai-Konto anmelden und nicht über ein [LLM-Gateway](/docs/de/llm-gateway) verbunden sind, hängt WebFetch auch von der Richtlinie Ihrer Organisation ab, die Claude Code anfordert, wenn eine Sitzung startet. Dasselbe gilt für eine Sitzung, deren Plan Claude Code nicht bestimmen kann, z. B. eine, die unter einem claude.ai-Token ausgeführt wird, das eine andere App bereitgestellt hat.718Wenn Sie sich mit einem Team- oder Enterprise-claude.ai-Konto anmelden und nicht über ein [LLM-Gateway](/docs/de/llm-gateway) verbunden sind, hängt WebFetch auch von der Richtlinie Ihrer Organisation ab, die Claude Code beim Start einer Sitzung von `api.anthropic.com` anfordert. Dasselbe gilt für eine Sitzung, deren Plan Claude Code nicht bestimmen kann, z. B. eine, die unter einem claude.ai-Token ausgeführt wird, das eine andere App bereitgestellt hat.

719 719 

720Wenn WebFetch in einer Sitzung fehlt, führen Sie `/status` in der Sitzung aus. Wenn die Zeile `Organization policy` meldet, dass die Richtlinie nicht geladen wurde und Web Fetch unter den Funktionen aufgeführt ist, die darauf warten, hält Claude Code WebFetch zurück, bis es bestätigen kann, dass Ihre Organisation es zulässt. Außerhalb einer Sitzung macht `claude doctor` eine eigene Anfrage und gibt dieselbe Zeile aus. Sobald eine Richtlinie, die WebFetch zulässt, geladen wird, gibt das Tool ohne Neustart zurück.720Wenn WebFetch in einer Sitzung fehlt, führen Sie `/status` in der Sitzung aus. Wenn die Zeile `Organization policy` meldet, dass die Richtlinie nicht geladen wurde und Web Fetch unter den Funktionen aufgeführt ist, die darauf warten, hält Claude Code WebFetch zurück, bis es bestätigen kann, dass Ihre Organisation es zulässt. Außerhalb einer Sitzung macht `claude doctor` eine eigene Anfrage und gibt dieselbe Zeile aus. Sobald eine Richtlinie, die WebFetch zulässt, geladen wird, gibt das Tool ohne Neustart zurück.

721 721 


727 727 

728Das Tool kann bis zu acht Backend-Suchen pro Aufruf durchführen und die Suche intern verfeinern, bevor es Ergebnisse zurückgibt. Claude kann Ergebnisse mit `allowed_domains` auf bestimmte Hosts beschränken oder mit `blocked_domains` ausschließen. Die beiden Listen können nicht in einem einzigen Aufruf kombiniert werden.728Das Tool kann bis zu acht Backend-Suchen pro Aufruf durchführen und die Suche intern verfeinern, bevor es Ergebnisse zurückgibt. Claude kann Ergebnisse mit `allowed_domains` auf bestimmte Hosts beschränken oder mit `blocked_domains` ausschließen. Die beiden Listen können nicht in einem einzigen Aufruf kombiniert werden.

729 729 

730Wenn die Suchanfrage ein überladenes API trifft, versucht Claude Code es mit Backoff erneut; ein Aufruf, der immer noch fehlschlägt, gibt ein Fehlerergebnis zurück. Vor v2.1.212 konnte der API-Fehlertext Claude erreichen, als wäre er ein Suchergebnis.730Wenn die Suchanfrage ein überladenes API trifft, versucht Claude Code es mit Backoff erneut; ein Aufruf, der immer noch fehlschlägt, gibt ein Fehlerergebnis zurück.

731 731 

732WebSearch-Berechtigungsregeln benötigen keinen Spezifizierer. Ein einfacher `WebSearch`-Eintrag in `allow` oder `deny` ist die einzige Form.732WebSearch-Berechtigungsregeln benötigen keinen Spezifizierer. Ein einfacher `WebSearch`-Eintrag in `allow` oder `deny` ist die einzige Form.

733 733 


741 Suchgrenze für Sitzungen741 Suchgrenze für Sitzungen

742</h3>742</h3>

743 743 

744Eine interaktive Terminal-Sitzung hat ein Limit von 200 WebSearch-Aufrufen. Suchen aus der Hauptkonversation und aus [Subagenten](/docs/de/sub-agents), etwa bei parallelen Forschungs-Fan-Outs, zählen gegen dasselbe Limit. Das Limit erfordert Claude Code v2.1.212 oder später.744Eine interaktive Terminal-Sitzung hat ein Limit von 200 WebSearch-Aufrufen. Suchen aus der Hauptkonversation und aus [Subagenten](/docs/de/sub-agents), etwa bei parallelen Forschungs-Fan-Outs, zählen gegen dasselbe Limit.

745 745 

746Solange eine Sitzung das Limit erreicht hat, erscheinen Suchen in der Konversation als Aufrufe, die nichts getan haben. Claude erhält einen Hinweis, der ihm mitteilt, mit den bereits gesammelten Informationen fortzufahren und Sie, falls weitere Suchen nötig sind, zu bitten, das Limit zu erhöhen.746Solange eine Sitzung das Limit erreicht hat, erscheinen Suchen in der Konversation als Aufrufe, die nichts getan haben. Claude erhält einen Hinweis, der ihm mitteilt, mit den bereits gesammelten Informationen fortzufahren, dies in seiner Antwort zu erwähnen und Sie, falls weitere Suchen nötig sind, zu bitten, das Limit zu erhöhen.

747 747 

748Um weitere Suchen zu erhalten, erhöhen Sie die Obergrenze, warten Sie, bis das Limit wieder aufgefüllt ist, oder starten Sie eine neue Konversation:748Um weitere Suchen zu erhalten, erhöhen Sie die Obergrenze, warten Sie, bis das Limit wieder aufgefüllt ist, oder starten Sie eine neue Konversation:

749 749 

Details

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

16| Einstellungen werden nicht angewendet, Hooks werden nicht ausgelöst, MCP-Server werden nicht geladen | [Debuggen Sie Ihre Konfiguration](/docs/de/debug-your-config) |16| 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) |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) |

18| Nach einem Update von Claude Code oder dem Agent SDK werden Tool-Aufrufe in `claude -p`- oder SDK-Ausführungen abgelehnt, die `--permission-mode`, `permissionMode` oder `permission_mode` nicht übergeben | [Abgelehnte Tool-Aufrufe in `claude -p`- und Agent SDK-Ausführungen](/docs/de/permission-modes#which-mode-a-non-interactive-run-starts-in) |

18| `API Error: 5xx`, `529 Overloaded`, `429`, Request-Validierungsfehler | [Fehlerreferenz](/docs/de/errors) |19| `API Error: 5xx`, `529 Overloaded`, `429`, Request-Validierungsfehler | [Fehlerreferenz](/docs/de/errors) |

19| `model not found` oder `you may not have access to it` | [Fehlerreferenz](/docs/de/errors#theres-an-issue-with-the-selected-model) |20| `model not found` oder `you may not have access to it` | [Fehlerreferenz](/docs/de/errors#theres-an-issue-with-the-selected-model) |

20| Ein Befehl, den Claude ausführt, schlägt fehl mit `Your disk quota is full`, `is full (ENOSPC)` oder `Command output was lost` | [Fehlerreferenz](/docs/de/errors#disk-quota-or-temp-filesystem-is-full) |21| Ein Befehl, den Claude ausführt, schlägt fehl mit `Your disk quota is full`, `is full (ENOSPC)` oder `Command output was lost` | [Fehlerreferenz](/docs/de/errors#disk-quota-or-temp-filesystem-is-full) |

vs-code.md +25 −9

Details

268 268 

269Klicken Sie oben im Claude-Code-Panel auf die Schaltfläche **Session history**, um auf Ihren Konversationsverlauf zuzugreifen. Sie können nach Stichwörtern suchen oder nach Zeit durchblättern.269Klicken Sie oben im Claude-Code-Panel auf die Schaltfläche **Session history**, um auf Ihren Konversationsverlauf zuzugreifen. Sie können nach Stichwörtern suchen oder nach Zeit durchblättern.

270 270 

271Klicken Sie auf eine beliebige Konversation, um sie mit dem vollständigen Nachrichtenverlauf fortzusetzen. Wenn die Konversation bereits in einem anderen Tab des aktuellen Fensters geöffnet ist, wechselt ein Klick zu diesem Tab. Wenn die Nachrichten zunächst leer bleiben, lesen Sie, [warum sie leer sind und wann sie erscheinen](#a-resumed-conversation-is-blank-at-first). Weitere Informationen zum Fortsetzen von Sitzungen finden Sie unter [Sitzungen verwalten](/docs/de/sessions).271Klicken Sie auf eine beliebige Konversation, um sie fortzusetzen. Wenn die Konversation bereits in einem anderen Tab des aktuellen Fensters geöffnet ist, wechselt ein Klick zu diesem Tab. Wenn die Konversation geöffnet wird, ohne dass Nachrichten angezeigt werden, lesen Sie, [warum eine fortgesetzte Konversation zunächst leer ist](#a-resumed-conversation-is-blank-at-first). Weitere Informationen zum Fortsetzen von Sitzungen finden Sie unter [Sitzungen verwalten](/docs/de/sessions).

272 272 

273* **Sitzungstitel**: Neue Sitzungen erhalten KI-generierte Titel auf Basis Ihrer ersten Nachricht.273* **Sitzungstitel**: Neue Sitzungen erhalten KI-generierte Titel auf Basis Ihrer ersten Nachricht.

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


414 414 

415Ein Öffnungsvorgang wird nicht abgeschlossen, wenn das Panel beim Laden der Konversation abstürzt oder nicht mehr reagiert oder wenn Sie das Fenster innerhalb von etwa drei Sekunden nach dem Öffnen neu laden oder schließen. Die Konversation bleibt unverändert und ist weiterhin im [Sitzungsverlauf](#resume-past-conversations) verfügbar.415Ein Öffnungsvorgang wird nicht abgeschlossen, wenn das Panel beim Laden der Konversation abstürzt oder nicht mehr reagiert oder wenn Sie das Fenster innerhalb von etwa drei Sekunden nach dem Öffnen neu laden oder schließen. Die Konversation bleibt unverändert und ist weiterhin im [Sitzungsverlauf](#resume-past-conversations) verfügbar.

416 416 

417* **Um sie trotzdem zu öffnen**: Klicken Sie auf **Open it anyway** oder wählen Sie die Konversation im Sitzungsverlauf aus. Wenn sie sich öffnet und das Panel weiter funktioniert, kehrt sie bei späteren Neuladevorgängen wie gewohnt zurück. Wenn das Panel erneut nicht mehr reagiert, laden Sie das Fenster neu, um zu einem neuen Chat mit dem Hinweis zurückzukehren.417* **Um sie trotzdem zu öffnen**: Klicken Sie auf **Open it anyway** oder wählen Sie die Konversation im Sitzungsverlauf aus. Sobald die Konversation vollständig geöffnet ist, [kehrt sie bei späteren Neuladevorgängen wie gewohnt zurück](#continue-conversations-after-a-reload).

418* **Wenn das Panel beim Laden der Konversation nicht mehr reagiert**: Laden Sie das Fenster neu. Ein neuer Chat wird geöffnet.

418* **Um sie geschlossen zu lassen**: Arbeiten Sie im neuen Chat weiter. Der Hinweis verschwindet, sobald Sie einen Prompt senden.419* **Um sie geschlossen zu lassen**: Arbeiten Sie im neuen Chat weiter. Der Hinweis verschwindet, sobald Sie einen Prompt senden.

419 420 

420<h3 id="run-multiple-conversations">421<h3 id="run-multiple-conversations">


556 Plugins, die im Panel zeichnen557 Plugins, die im Panel zeichnen

557</h3>558</h3>

558 559 

559Ein Plugin, das einen [Mod](/docs/de/plugins/mods/overview) enthält, kann im Chat-Panel zeichnen. Das Zeichnen erfordert die Erweiterungsversion 2.1.299 oder höher und eine Sitzung, die [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Von einem solchen Plugin können Sie Folgendes sehen:560Ein Plugin, das einen [Mod](/docs/de/plugins/mods/overview) enthält, kann im Chat-Panel zeichnen. Das Zeichnen erfordert die Erweiterungsversion 2.1.299 oder höher. Eine Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), etwa eine auf Amazon Bedrock, benötigt 2.1.304 oder höher. Von einem solchen Plugin können Sie Folgendes sehen:

560 561 

561* Einen Bereich neben der Konversation oder über dem Eingabefeld562* Einen Bereich neben der Konversation oder über dem Eingabefeld

562* Eine Toast-Benachrichtigung oder eine Statuszeile über dem Eingabefeld563* Eine Toast-Benachrichtigung oder eine Statuszeile über dem Eingabefeld


624 625 

625Wenn ein Befehl oder ein [Subagent](/docs/de/sub-agents) Claude länger warten lässt, als Sie möchten, klicken Sie in der Konversation unter dessen Tool-Aufruf auf **Run in background**. Erfordert Claude Code v2.1.287 oder höher.626Wenn ein Befehl oder ein [Subagent](/docs/de/sub-agents) Claude länger warten lässt, als Sie möchten, klicken Sie in der Konversation unter dessen Tool-Aufruf auf **Run in background**. Erfordert Claude Code v2.1.287 oder höher.

626 627 

627* **Zeitpunkt**: Die Aktion erscheint, sobald ein Befehl etwa zwei Sekunden lang läuft, oder sobald ein Subagent startet.628* **Zeitpunkt**: Die Aktion erscheint, sobald ein Befehl etwa zwei Sekunden lang läuft, oder sobald Claude beginnt, auf einen [Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) zu warten, den es aus der Hauptkonversation gestartet hat.

628* **Nach dem Klicken**: Claude wartet nicht mehr und setzt den Turn fort. Der Befehl oder Subagent läuft als [Hintergrundaufgabe](/docs/de/tools-reference#background-commands) weiter, die Claude benachrichtigt, wenn sie abgeschlossen ist.629* **Nach dem Klicken**: Claude wartet nicht mehr und setzt den Turn fort. Der Befehl oder Subagent läuft als [Hintergrundaufgabe](/docs/de/tools-reference#background-commands) weiter, die Claude benachrichtigt, wenn sie abgeschlossen ist.

629 630 

630Um die Aufgabe in der Zwischenzeit zu überprüfen oder zu stoppen, geben Sie `/tasks` in das Eingabefeld ein, um die [Agentenübersicht](#use-the-prompt-box) zu öffnen. Ein Subagent behält dort seinen Platz im Baum der Agenten, und ein Befehl wird unterhalb der Agenten mit seiner [neuesten Ausgabe auf seiner Karte](#monitor-background-processes) aufgeführt.631Um die Aufgabe in der Zwischenzeit zu überprüfen oder zu stoppen, geben Sie `/tasks` in das Eingabefeld ein, um die [Agentenübersicht](#use-the-prompt-box) zu öffnen. Ein Subagent behält dort seinen Platz im Baum der Agenten, und ein Befehl wird unterhalb der Agenten mit seiner [neuesten Ausgabe auf seiner Karte](#monitor-background-processes) aufgeführt.

631 632 

633<h4 id="the-run-in-background-action-is-missing-under-a-subagent">

634 Die Aktion Run in background fehlt unter einem Subagenten

635</h4>

636 

637In VS Code zeigen Subagenten diese Aktion standardmäßig nicht an. Um den Grund für einen bestimmten Subagenten herauszufinden, öffnen Sie dessen Karte in der [Agentenübersicht](#use-the-prompt-box) und lesen Sie die Zeile `Spawned by`:

638 

639* **`Spawned by the main agent`**: Der Subagent wurde im Hintergrund gestartet, sodass Claude nicht auf ihn wartet und Sie nichts tun müssen. Wie Sie Claude stattdessen auf Subagenten warten lassen, erfahren Sie unter [Claude auf einen Subagenten warten lassen](/docs/de/sub-agents#let-claude-wait-for-a-subagent).

640* **`Spawned by` nennt einen anderen Subagenten**: Die Aktion erscheint nur für Subagenten, die der Haupt-Agent gestartet hat, nicht für einen [verschachtelten Subagenten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents), auf den ein anderer Subagent wartet. Um den verschachtelten Subagenten vorzeitig zu beenden, klicken Sie auf seiner Karte auf **Stop agent**. Der wartende Subagent fährt dann ohne dieses Ergebnis fort.

641 

632<h3 id="monitor-background-processes">642<h3 id="monitor-background-processes">

633 Hintergrundprozesse überwachen643 Hintergrundprozesse überwachen

634</h3>644</h3>


1028 1038 

1029Wenn eine Formel so angezeigt wird, wie sie geschrieben ist, während andere in ihrer Nähe gesetzt werden, prüfen Sie sie auf folgende Ursachen:1039Wenn eine Formel so angezeigt wird, wie sie geschrieben ist, während andere in ihrer Nähe gesetzt werden, prüfen Sie sie auf folgende Ursachen:

1030 1040 

1031* **Sie wird als etwas anderes als Mathematik gelesen**: `$…$`-Text, der wie ein Wort gelesen wird, bleibt so, wie er geschrieben ist, etwa `$O(n log n)$`. `$…$`-Text, der mit einer Ziffer beginnt, etwa `$30$` oder `$1/N$`, bleibt ebenfalls so, wie er geschrieben ist, es sei denn, ein Zeichen wie `=`, `+` oder `^` kennzeichnet ihn als Mathematik. Bitten Sie Claude stattdessen um einen `$$`-Block in eigenen Zeilen, den das Panel ohne diese Prüfung setzt.1041* **Die Formel steht inline und das Panel behandelt sie nicht als Mathematik**: Bitten Sie Claude, sie erneut als `$$`-Block in eigenen Zeilen zu senden. Das Panel lässt eine Inline-Formel so, wie sie geschrieben ist, wenn der Text zwischen ihren `$…$`-Begrenzern:

1032* **Sie enthält Leerzeichen, ist lang oder über mehrere Zeilen verteilt**: `$ x^2 $` mit Leerzeichen innerhalb der Dollarzeichen, `$…$`-Inhalte mit mehr als 60 Zeichen sowie `$…$` oder `\(…\)`, die über zwei Zeilen verteilt sind, werden nicht gesetzt. Bitten Sie Claude stattdessen um einen `$$`-Block in eigenen Zeilen, für den keine dieser Einschränkungen gilt.1042 * Mehr als einfache Arithmetik ist, aber kein Zeichen wie `=`, `+` oder `^` enthält, das ihn als Mathematik kennzeichnet, etwa `$O(n log n)$`

1033* **Der TeX-Code kann nicht gesetzt werden**: Eine Formel mit einem Syntaxfehler, einer Makrodefinition wie `\newcommand` oder `\def` oder einem nicht maskierten `%` wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, sie mit korrigiertem Fehler, ohne das Makro oder mit `\%` für ein Prozentzeichen neu zu schreiben.1043 * Mit einer Ziffer beginnt und kein solches Zeichen enthält, etwa `$30$` und `$1/N$`

1034* **Sie ist zu groß**: Eine Formel mit mehr als 8.192 Zeichen oder eine, die weit größer dargestellt würde als ihr Quelltext, wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, sie in kleinere Formeln aufzuteilen oder kompakter zu schreiben.1044 * Leerzeichen innerhalb der Dollarzeichen enthält, etwa `$ x^2 $`

1035* **Sie folgt auf eine große Menge Mathematik**: Innerhalb eines Textblocks in einer Antwort setzt das Panel Formeln der Reihe nach bis zu einer Obergrenze. Eine spätere Formel, die diese Grenze überschreiten würde, wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, die benötigte Formel noch einmal einzeln zu senden.1045 * Länger als 60 Zeichen ist

1046 * Über zwei Zeilen verteilt ist. Eine über zwei Zeilen verteilte `\(…\)`-Formel wird ebenfalls nicht gesetzt.

1047* **Die Formel enthält einen TeX-Syntaxfehler**: Bitten Sie Claude, sie mit korrigiertem Fehler neu zu schreiben.

1048* **Die Formel definiert ein Makro**: Eine Formel mit einer Makrodefinition wie `\newcommand` oder `\def` wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, sie ohne das Makro neu zu schreiben.

1049* **Die Formel enthält ein nicht maskiertes `%`**: Bitten Sie Claude, sie mit `\%` für ein Prozentzeichen neu zu schreiben.

1050* **Die Formel ist zu groß**: Eine Formel mit mehr als 8.192 Zeichen oder eine, deren gesetzte Ausgabe weit größer wäre als ihr TeX-Quelltext, wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, sie in kleinere Formeln aufzuteilen oder kompakter zu schreiben.

1051* **Die Formel folgt auf eine große Menge Mathematik**: Innerhalb eines Textblocks in einer Antwort setzt das Panel Formeln der Reihe nach bis zu einer Obergrenze. Eine spätere Formel, die diese Grenze überschreiten würde, wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, die benötigte Formel noch einmal einzeln zu senden.

1036 1052 

1037<h3 id="claude-code-never-responds">1053<h3 id="claude-code-never-responds">

1038 Claude Code antwortet nie1054 Claude Code antwortet nie

Details

78 <p className="digest-wins-title">Weitere Verbesserungen</p>78 <p className="digest-wins-title">Weitere Verbesserungen</p>

79 79 

80 <div className="digest-wins-grid">80 <div className="digest-wins-grid">

81 <div><code>claude agents</code> erhielt Dispatch-Flags (<code>--add-dir</code>, <code>--settings</code>, <code>--mcp-config</code>, <code>--plugin-dir</code>, <code>--permission-mode</code>, <code>--model</code>, <code>--effort</code>, <code>--dangerously-skip-permissions</code>) zur Konfiguration von Hintergrund-Sitzungen, und <code>claude agents --cwd \<path></code> beschränkt die Sitzungsliste auf ein Verzeichnis</div>81 <div><code>claude agents</code> erhielt Dispatch-Flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) zur Konfiguration von Hintergrund-Sitzungen, und `claude agents --cwd <path>` beschränkt die Sitzungsliste auf ein Verzeichnis</div>

82 <div>Neuer Hook <code>args: string\[]</code> exec-Form startet den Befehl direkt ohne Shell, sodass Pfad-Platzhalter nie Anführungszeichen benötigen</div>82 <div>Neuer Hook <code>args: string\[]</code> exec-Form startet den Befehl direkt ohne Shell, sodass Pfad-Platzhalter nie Anführungszeichen benötigen</div>

83 <div>Neue <code>continueOnBlock</code> Konfigurationsoption für <code>PostToolUse</code> Hooks leitet den Ablehnungsgrund des Hooks an Claude zurück und setzt den Durchlauf fort, anstatt ihn zu beenden</div>83 <div>Neue <code>continueOnBlock</code> Konfigurationsoption für <code>PostToolUse</code> Hooks leitet den Ablehnungsgrund des Hooks an Claude zurück und setzt den Durchlauf fort, anstatt ihn zu beenden</div>

84 <div>Neues <code>terminalSequence</code> Feld in Hook-JSON-Ausgabe ermöglicht es Hooks, Desktop-Benachrichtigungen, Fenstertitel und Glocken ohne steuerndes Terminal auszugeben</div>84 <div>Neues <code>terminalSequence</code> Feld in Hook-JSON-Ausgabe ermöglicht es Hooks, Desktop-Benachrichtigungen, Fenstertitel und Glocken ohne steuerndes Terminal auszugeben</div>

85 <div>Das Rewind-Menü erhielt „Zusammenfassen bis hier" zum Komprimieren früherer Kontexte, während neuere Durchläufe intakt bleiben</div>85 <div>Das Rewind-Menü erhielt „Zusammenfassen bis hier" zum Komprimieren früherer Kontexte, während neuere Durchläufe intakt bleiben</div>

86 <div>Remote Control, <code>/schedule</code>, Claude.ai MCP-Konnektoren und Benachrichtigungseinstellungen sind jetzt deaktiviert, wenn <code>ANTHROPIC\_API\_KEY</code>, <code>apiKeyHelper</code> oder <code>ANTHROPIC\_AUTH\_TOKEN</code> gesetzt ist, auch neben einer Claude.ai-Anmeldung; heben Sie die API-Schlüssel-Einstellung auf, um diese Funktionen zu nutzen</div>86 <div>Remote Control, <code>/schedule</code>, claude.ai MCP-Konnektoren und Benachrichtigungseinstellungen sind jetzt deaktiviert, wenn <code>ANTHROPIC\_API\_KEY</code>, <code>apiKeyHelper</code> oder <code>ANTHROPIC\_AUTH\_TOKEN</code> gesetzt ist, auch neben einer claude.ai-Anmeldung; heben Sie die API-Schlüssel-Einstellung auf, um diese Funktionen zu nutzen</div>

87 <div>MCP-Stdio-Server erhalten jetzt <code>CLAUDE\_PROJECT\_DIR</code> in ihrer Umgebung, was Hooks entspricht, und Plugin-Konfigurationen können <code>\${"{"}CLAUDE\_PROJECT\_DIR{"}"}</code> in Befehlen referenzieren</div>87 <div>MCP-Stdio-Server erhalten jetzt <code>CLAUDE\_PROJECT\_DIR</code> in ihrer Umgebung, was Hooks entspricht, und Plugin-Konfigurationen können <code>\${"{"}CLAUDE\_PROJECT\_DIR{"}"}</code> in Befehlen referenzieren</div>

88 <div><code>claude plugin details \<name></code> zeigt das Komponenten-Inventar eines Plugins und die projizierte Token-Kosten pro Sitzung an, und der <code>/plugin</code> Details-Bereich listet jetzt auch die LSP-Server auf, die ein Plugin bereitstellt</div>88 <div><code>claude plugin details \<name></code> zeigt das Komponenten-Inventar eines Plugins und die projizierte Token-Kosten pro Sitzung an, und der <code>/plugin</code> Details-Bereich listet jetzt auch die LSP-Server auf, die ein Plugin bereitstellt</div>

89 <div>Plugins mit einer Root-Level <code>SKILL.md</code> und keinem <code>skills/</code> Unterverzeichnis werden jetzt als Skill angezeigt</div>89 <div>Plugins mit einer Root-Level <code>SKILL.md</code> und keinem <code>skills/</code> Unterverzeichnis werden jetzt als Skill angezeigt</div>

workflows.md +0 −4

Details

153* eine geplante Task-Eingabeaufforderung153* eine geplante Task-Eingabeaufforderung

154* eine Webhook-Nutzlast oder ein Pull-Request-Kommentar, der in das Gespräch weitergeleitet wird154* eine Webhook-Nutzlast oder ein Pull-Request-Kommentar, der in das Gespräch weitergeleitet wird

155 155 

156<Note>

157 Vor v2.1.210 startete das Schlüsselwort einen Workflow auch von diesen Routen aus, einschließlich einer Webhook-Nutzlast oder eines Pull-Request-Kommentars, der in das Gespräch weitergeleitet wird.

158</Note>

159 

160<h3 id="let-claude-decide-with-ultracode">156<h3 id="let-claude-decide-with-ultracode">

161 Lassen Sie Claude mit Ultracode entscheiden157 Lassen Sie Claude mit Ultracode entscheiden

162</h3>158</h3>

worktrees.md +6 −3

Details

9Ein [Git-Worktree](https://git-scm.com/docs/git-worktree) ist ein separates Arbeitsverzeichnis mit eigenen Dateien und Branch, das die gleiche Repository-Historie und Remote wie Ihr Haupt-Checkout teilt. Wenn Sie jede Claude Code-Sitzung in ihrem eigenen Worktree ausführen, erhält sie eine separate Kopie der Dateien zum Bearbeiten, sodass eine Sitzung ein Feature entwickeln kann, während eine zweite einen Bug behebt.9Ein [Git-Worktree](https://git-scm.com/docs/git-worktree) ist ein separates Arbeitsverzeichnis mit eigenen Dateien und Branch, das die gleiche Repository-Historie und Remote wie Ihr Haupt-Checkout teilt. Wenn Sie jede Claude Code-Sitzung in ihrem eigenen Worktree ausführen, erhält sie eine separate Kopie der Dateien zum Bearbeiten, sodass eine Sitzung ein Feature entwickeln kann, während eine zweite einen Bug behebt.

10 10 

11<Note>11<Note>

12 Worktrees erfordern ein Git-Repository; für andere Versionskontrollsysteme [konfigurieren Sie Hooks, um die Git-Logik zu ersetzen](#non-git-version-control). In der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) wählen Sie die Option **worktree** aus, wenn Sie eine Sitzung starten, um ihr ihren eigenen Worktree zu geben.12 Wenn Sie ein anderes Versionskontrollsystem oder die Desktop-App verwenden, folgen Sie den Anweisungen für Ihr Setup:

13 

14 * **Andere Versionskontrollsysteme**: Worktrees erfordern ein Git-Repository; [konfigurieren Sie Hooks, um die Git-Logik zu ersetzen](#non-git-version-control)

15 * **Desktop-App**: siehe [Eine Sitzung in einem eigenen Worktree ausführen](/docs/de/desktop#run-a-session-in-its-own-worktree)

13</Note>16</Note>

14 17 

15Worktrees sind eine von mehreren Möglichkeiten, Claude parallel auszuführen. Sie isolieren Datei-Änderungen. [Subagents](/docs/de/sub-agents) teilen die Arbeit innerhalb einer Sitzung auf, und [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) ermöglicht es Claude, Erkenntnisse zwischen den Sitzungen in Ihren Worktrees weiterzugeben. Siehe [Agenten parallel ausführen](/docs/de/agents), um die Ansätze zu vergleichen, oder springen Sie direkt zu [Subagents mit Worktrees isolieren](#isolate-subagents-with-worktrees), um Worktrees und Subagents zusammen zu verwenden.18Worktrees sind eine von mehreren Möglichkeiten, Claude parallel auszuführen. Sie isolieren Datei-Änderungen. [Subagents](/docs/de/sub-agents) teilen die Arbeit innerhalb einer Sitzung auf, und [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging) ermöglicht es Claude, Erkenntnisse zwischen den Sitzungen in Ihren Worktrees weiterzugeben. Siehe [Agenten parallel ausführen](/docs/de/agents), um die Ansätze zu vergleichen, oder springen Sie direkt zu [Subagents mit Worktrees isolieren](#isolate-subagents-with-worktrees), um Worktrees und Subagents zusammen zu verwenden.


270 273 

271All diese gelten, ob Sie den Worktree mit `--worktree` oder mit `git worktree add` erstellen.274All diese gelten, ob Sie den Worktree mit `--worktree` oder mit `git worktree add` erstellen.

272 275 

273In einer Worktree-Sitzung, die Sie über die [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) starten, liest Claude Code die Projektkonfiguration wie Einstellungen, Hooks, Skills, Agenten, Befehle und [`.mcp.json`](/docs/de/mcp#project-scope)-Server aus dem Root des Haupt-Checkouts statt aus dem Worktree. Hook-Befehle werden in diesem Root ausgeführt, und `${CLAUDE_PROJECT_DIR}` verweist darauf. Um die Dateien zu erreichen, an denen Claude arbeitet, lesen Sie den Pfad des Worktrees aus dem [Eingabefeld `cwd`](/docs/de/hooks#common-input-fields) des Hooks. `CLAUDE.md`-Dateien und `.claude/rules/` werden weiterhin aus dem Worktree geladen.276In einer Worktree-Sitzung, die Sie über die [Desktop-App](/docs/de/desktop#run-a-session-in-its-own-worktree) starten, liest Claude Code die Projektkonfiguration wie Einstellungen, Hooks, Skills, Agenten, Befehle und [`.mcp.json`](/docs/de/mcp#project-scope)-Server aus dem Root des Haupt-Checkouts. Hook-Befehle werden in diesem Root ausgeführt, und `${CLAUDE_PROJECT_DIR}` verweist darauf. Um die Dateien zu erreichen, an denen Claude arbeitet, lesen Sie den Pfad des Worktrees aus dem [Eingabefeld `cwd`](/docs/de/hooks#common-input-fields) des Hooks. `CLAUDE.md`-Dateien und `.claude/rules/` werden weiterhin aus dem Worktree geladen.

274 277 

275<h2 id="manage-worktrees-manually">278<h2 id="manage-worktrees-manually">

276 Verwalten Sie Worktrees manuell279 Verwalten Sie Worktrees manuell


434* [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): Lassen Sie die Sitzungen in Ihren Worktrees Erkenntnisse aneinander weitergeben437* [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): Lassen Sie die Sitzungen in Ihren Worktrees Erkenntnisse aneinander weitergeben

435* [Agent-Teams](/docs/de/agent-teams): Koordinieren Sie mehrere Claude-Sitzungen automatisch438* [Agent-Teams](/docs/de/agent-teams): Koordinieren Sie mehrere Claude-Sitzungen automatisch

436* [Sitzungen verwalten](/docs/de/sessions): Benennen, fortsetzen und wechseln Sie zwischen Gesprächen439* [Sitzungen verwalten](/docs/de/sessions): Benennen, fortsetzen und wechseln Sie zwischen Gesprächen

437* [Desktop-Parallelsitzungen](/docs/de/desktop#work-in-parallel-with-sessions): Worktree-gestützte Sitzungen in der Desktop-App440* [Eine Desktop-Sitzung in einem eigenen Worktree ausführen](/docs/de/desktop#run-a-session-in-its-own-worktree): Worktree-gestützte Sitzungen in der Desktop-App