Documentation — Spybara

advisor.md +4 −3

Details

98| Opus 4.7 oder Opus 4.8 | Fable, Opus 4.7 oder später, Sonnet 5.5 |98| Opus 4.7 oder Opus 4.8 | Fable, Opus 4.7 oder später, Sonnet 5.5 |

99| Sonnet 5.5 | Fable, Opus 5 oder später, Sonnet 5.5 |99| Sonnet 5.5 | Fable, Opus 5 oder später, Sonnet 5.5 |

100| Opus 5 oder Opus 5.5 | Fable, Opus 5 oder später |100| Opus 5 oder Opus 5.5 | Fable, Opus 5 oder später |

101| Fable 5 | Fable 5.1 oder Fable 5 |101| Fable 5 | Fable 5.2, Fable 5.1 oder Fable 5 |

102| Fable 5.1 | Fable 5.1 |102| Fable 5.1 | Fable 5.2 oder Fable 5.1 |

103| Fable 5.2 | Fable 5.2 |

103 104

104Fable 5.1 erfordert Claude Code v2.1.257 oder später. Fable-Modelle erfordern [Fable-Zugriff](https://code.claude.com/docs/de/model-config.md#work-with-fable). Sonnet 5.5 als Advisor für ein Opus 4.7- oder Opus 4.8-Hauptmodell erfordert Claude Code v2.1.287 oder später. Haiku 5.5 als Hauptmodell oder als Advisor erfordert Claude Code v2.1.293 oder später.105Fable 5.2 erfordert Claude Code v2.1.321 oder später, und Fable 5.1 erfordert v2.1.257 oder später. Fable-Modelle erfordern [Fable-Zugriff](https://code.claude.com/docs/de/model-config.md#work-with-fable). Sonnet 5.5 als Advisor für ein Opus 4.7- oder Opus 4.8-Hauptmodell erfordert Claude Code v2.1.287 oder später. Haiku 5.5 als Hauptmodell oder als Advisor erfordert Claude Code v2.1.293 oder später.

105 106

106Legen Sie den Advisor als `fable`, `opus` oder `sonnet` fest. Diese Aliase werden in die [in Claude Code integrierte Standardversion](https://code.claude.com/docs/de/model-config.md#model-aliases) für jede Modellfamilie aufgelöst, die sich mit neuen Claude Code-Versionen weiterentwickelt. Sie können auch eine vollständige Modell-ID wie `claude-opus-5-5` oder `claude-haiku-5-5` übergeben. Haiku 4.5 kann den Advisor aufrufen, kann aber nicht als einer fungieren.107Legen Sie den Advisor als `fable`, `opus` oder `sonnet` fest. Diese Aliase werden in die [in Claude Code integrierte Standardversion](https://code.claude.com/docs/de/model-config.md#model-aliases) für jede Modellfamilie aufgelöst, die sich mit neuen Claude Code-Versionen weiterentwickelt. Sie können auch eine vollständige Modell-ID wie `claude-opus-5-5` oder `claude-haiku-5-5` übergeben. Haiku 4.5 kann den Advisor aufrufen, kann aber nicht als einer fungieren.

107 108

agent-sdk/custom-tools.md +17 −11

Details

56 56

57### Beispiel für ein Wetter-Tool57### Beispiel für ein Wetter-Tool

58 58

59Dieses Beispiel definiert ein `get_temperature` Tool und wickelt es in einen MCP-Server ein, ohne den Server an `query` zu übergeben. Um das Tool auszuführen, siehe [Ein benutzerdefiniertes Tool aufrufen](#call-a-custom-tool) unten.59Dieses Beispiel definiert ein `get_temperature` Tool und wickelt es in einen MCP-Server ein, ohne den Server an `query` zu übergeben. Um das Tool auszuführen, siehe [Ein benutzerdefiniertes Tool aufrufen](#call-a-custom-tool).

60 60

61```python Python theme={null}61```python Python theme={null}

62from typing import Annotated, Any62from typing import Annotated, Any

148* **TypeScript**: Fügen Sie `.optional()` zum Zod-Feld hinzu.148* **TypeScript**: Fügen Sie `.optional()` zum Zod-Feld hinzu.

149* **Python**: Das Dict-Schema behandelt jeden Schlüssel als erforderlich. Verwenden Sie die JSON-Schema-Form, lassen Sie den Parameter aus `required` weg und lesen Sie ihn mit `args.get()`. Für ein typisiertes Schema mit optionalen Schlüsseln siehe [TypedDict-Klasse](https://code.claude.com/docs/de/agent-sdk/python.md#input-schema-options).149* **Python**: Das Dict-Schema behandelt jeden Schlüssel als erforderlich. Verwenden Sie die JSON-Schema-Form, lassen Sie den Parameter aus `required` weg und lesen Sie ihn mit `args.get()`. Für ein typisiertes Schema mit optionalen Schlüsseln siehe [TypedDict-Klasse](https://code.claude.com/docs/de/agent-sdk/python.md#input-schema-options).

150 150

151Das [`get_precipitation_chance` Tool unten](#add-more-tools) zeigt beide Muster.151Das [`get_precipitation_chance` Tool](#add-more-tools) zeigt beide Muster.

152 152

153### Ein benutzerdefiniertes Tool aufrufen153### Ein benutzerdefiniertes Tool aufrufen

154 154

155Übergeben Sie den MCP-Server, den Sie erstellt haben, über die Option `mcpServers` an `query` und listen Sie den [vollständig qualifizierten Namen](https://code.claude.com/docs/de/agent-sdk/mcp.md#tool-naming-convention) jedes Tools in `allowedTools` auf, damit das Tool ohne Berechtigungsabfrage ausgeführt wird. Dieser Name lautet `mcp__{server_name}__{tool_name}`, wobei `{server_name}` der Schlüssel ist, den Sie dem Server in `mcpServers` geben. Wenn der Schlüssel Zeichen wie `.` oder Leerzeichen enthält, ersetzen Sie diese durch `_`, wenn Sie `{server_name}` schreiben.155Um ein benutzerdefiniertes Tool aufzurufen, gehen Sie wie folgt vor:

156

1571. Übergeben Sie den MCP-Server, den Sie erstellt haben, über die Option `mcpServers` an `query`.

1582. Listen Sie den [vollständig qualifizierten Namen](https://code.claude.com/docs/de/agent-sdk/mcp.md#tool-naming-convention) des Tools in `allowedTools` auf, um seine Aufrufe [vorab zu genehmigen](https://code.claude.com/docs/de/agent-sdk/permissions.md#allow-and-deny-rules). Dieser Name folgt der Konvention `mcp__{server_name}__{tool_name}`, wobei `{server_name}` der Schlüssel ist, den Sie dem Server in `mcpServers` geben. Wenn der Schlüssel Zeichen wie `.` oder Leerzeichen enthält, ersetzen Sie diese durch `_`, wenn Sie `{server_name}` schreiben.

156 159

157Diese Snippets verwenden den `weatherServer` aus dem [Wetter-Tool-Beispiel](#weather-tool-example) erneut, um Claude zu fragen, wie das Wetter an einem bestimmten Ort ist.160Diese Snippets verwenden den `weatherServer` aus dem [Wetter-Tool-Beispiel](#weather-tool-example) erneut, um Claude zu fragen, wie das Wetter an einem bestimmten Ort ist.

158 161

329| :- | :- | :- |332| :- | :- | :- |

331| `destructiveHint` | `true` | Tool kann destruktive Aktualisierungen durchführen. Setzen Sie es bei jedem Tool, das Sie [mit `always_ask` markieren](#require-approval-for-specific-tools), explizit auf `true`. |334| `destructiveHint` | `true` | Tool kann destruktive Aktualisierungen durchführen. Setzen Sie es bei jedem Tool, das Sie [mit `always_ask` markieren](#require-approval-for-specific-tools), explizit auf `true`. |

334 337

335Anmerkungen sind Metadaten, keine Durchsetzung. Ein Tool, das mit `readOnlyHint: true` markiert ist, kann immer noch auf die Festplatte schreiben, wenn das der Handler tut. Halten Sie die Anmerkung genau zum Handler.338Anmerkungen sind Metadaten, keine Durchsetzung. Ein Tool, das mit `readOnlyHint: true` markiert ist, kann immer noch auf die Festplatte schreiben, wenn das der Handler tut. Halten Sie die Anmerkung genau zum Handler.

336 339

373 376

374### Zulässige Tools konfigurieren377### Zulässige Tools konfigurieren

375 378

376Die Option `tools` und die Zulassungs-/Ausschlusslisten beeinflussen zwei Ebenen: Verfügbarkeit, die steuert, ob ein Tool im Kontext von Claude angezeigt wird, und Berechtigung, die steuert, ob ein Aufruf genehmigt wird, sobald Claude ihn versucht. `tools` und Einträge in `disallowedTools` ohne Bereichsangabe ändern die Verfügbarkeit. `allowedTools` und Regeln in `disallowedTools` mit Bereichsangabe ändern die Berechtigung. Wenn Sie eines der [Task-Tracking-Tools](https://code.claude.com/docs/de/agent-sdk/todo-tracking.md#model-availability) in `allowedTools` nennen, aktiviert Claude Code diese auch für die Sitzung.379Mit den Optionen `tools`, `allowedTools` und `disallowedTools` steuern Sie zwei Ebenen:

380

381* **Verfügbarkeit**: ob ein Tool im Kontext von Claude erscheint. Um sie zu ändern, verwenden Sie die Option `tools` oder listen Sie einen integrierten Tool-Namen ohne Bereichsangabe wie `"Bash"` in `disallowedTools` auf.

382* **Berechtigung**: ob Claude Code einen Aufruf genehmigt, wenn Claude ihn ausführt. Um sie zu ändern, verwenden Sie `allowedTools` oder eine Regel in `disallowedTools` mit Bereichsangabe wie `"Bash(rm *)"`.

377 383

379| :- | :- | :- |385| :- | :- | :- |

380| `tools: ["Read", "Grep"]` | Verfügbarkeit | Nur die aufgelisteten integrierten Tools befinden sich im Kontext von Claude. Nicht aufgelistete integrierte Tools werden entfernt. MCP-Tools sind nicht betroffen. |386| `tools: ["Read", "Grep"]` | Verfügbarkeit | Nur die aufgelisteten integrierten Tools befinden sich im Kontext von Claude. Nicht aufgelistete integrierte Tools werden entfernt. MCP-Tools sind nicht betroffen. |

382| zulässige Tools | Berechtigung | Aufgelistete Tools werden ohne Genehmigungsaufforderung ausgeführt. Andere nicht aufgelistete Tools bleiben verfügbar; Aufrufe durchlaufen den [Berechtigungsfluss](https://code.claude.com/docs/de/agent-sdk/permissions.md). |388| zulässige Tools | Berechtigung | Aufgelistete Tools sind vorab genehmigt, mit Ausnahme der [Aufrufe, die keine Zulassungsregel genehmigt](https://code.claude.com/docs/de/agent-sdk/permissions.md#calls-an-allow-rule-never-approves). Aufrufe von Tools, die Sie nicht in die Liste aufnehmen, durchlaufen den [Berechtigungsfluss](https://code.claude.com/docs/de/agent-sdk/permissions.md). |

383| nicht zulässige Tools | Beide | Ein Tool-Name ohne Bereichsangabe wie `"Bash"` entfernt das Tool aus dem Kontext von Claude, genauso wie das Weglassen aus `tools`. Eine Regel mit Bereichsangabe wie `"Bash(rm *)"` behält das Tool im Kontext und verweigert nur übereinstimmende Aufrufe, die [wie geschrieben](https://code.claude.com/docs/de/permissions.md#bash-rule-limits) entsprechen. |389| nicht zulässige Tools | Beide | Ein integrierter Tool-Name ohne Bereichsangabe wie `"Bash"` entfernt das Tool aus dem Kontext von Claude. Eine Regel mit Bereichsangabe wie `"Bash(rm *)"` behält das Tool im Kontext und verweigert die Aufrufe, die ihr [wie geschrieben](https://code.claude.com/docs/de/permissions.md#bash-rule-limits) entsprechen. |

384 390

385Um ein integriertes Tool vollständig zu entfernen, lassen Sie es aus `tools` weg oder listen Sie seinen Namen ohne Bereichsangabe in `disallowedTools` auf (Python: `disallowed_tools`); beide halten das Tool aus dem Kontext heraus, sodass Claude es nie versucht. Eine Regel in `disallowedTools` mit Bereichsangabe blockiert übereinstimmende Aufrufe, behält das Tool aber sichtbar, sodass Claude möglicherweise einen Zug damit verschwenden kann. Siehe [Berechtigungen konfigurieren](https://code.claude.com/docs/de/agent-sdk/permissions.md) für die vollständige Evaluierungsreihenfolge.391Um ein integriertes Tool aus dem Kontext von Claude zu entfernen, lassen Sie es aus `tools` weg oder listen Sie seinen Namen ohne Bereichsangabe in `disallowedTools` (TypeScript) bzw. `disallowed_tools` (Python) auf. Die vollständige Evaluierungsreihenfolge finden Sie unter [Berechtigungen konfigurieren](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated).

386 392

387### Genehmigung für bestimmte Tools verlangen393### Genehmigung für bestimmte Tools verlangen

388 394

637 643

638## Strukturierte Daten zurückgeben644## Strukturierte Daten zurückgeben

639 645

640`structuredContent` ist ein optionales JSON-Objekt im Ergebnis, getrennt vom `content`-Array. Verwenden Sie es, um Rohwerte zurückzugeben, die Claude als exakte Felder lesen kann, anstatt sie aus einer Textzeichenfolge oder einem Bild zu analysieren.646`structuredContent` ist ein optionales JSON-Objekt im Ergebnis, getrennt vom `content`-Array. Verwenden Sie es, um Rohwerte zurückzugeben, die Claude als exakte Felder lesen kann, anstatt sie aus einer Textzeichenfolge oder einem Bild zu analysieren. Informationen zu Python-Handlern finden Sie unter [Strukturierte Inhalte in Python](#structured-content-in-python).

641 647

642Wenn `structuredContent` gesetzt ist, erhält Claude das JSON plus alle Bild- oder Ressourcenblöcke aus `content`. Textblöcke in `content` werden nicht weitergeleitet, da angenommen wird, dass sie die strukturierten Daten duplizieren. Das folgende Beispiel rendert ein Diagramm als Bildblock und gibt die dahinter liegenden Datenpunkte in `structuredContent` vom gleichen Handler zurück. Im Snippet ist `chartPngBuffer` ein `Buffer`, das die gerenderten PNG-Bytes enthält.648Wenn ein TypeScript-`tool()`-Handler `structuredContent` setzt, erhält Claude das JSON plus die Bild- und Ressourcenblöcke aus `content`, und die Textblöcke in `content` erreichen Claude nicht. Das folgende Beispiel rendert ein Diagramm als Bildblock und gibt die dahinter liegenden Datenpunkte in `structuredContent` vom gleichen Handler zurück. Im Snippet ist `chartPngBuffer` ein `Buffer`, das die gerenderten PNG-Bytes enthält.

643 649

644```typescript TypeScript theme={null}650```typescript TypeScript theme={null}

645return {651return {

agent-sdk/mcp.md +1 −1

Details

205 205

206### Automatische Genehmigung mit allowedTools206### Automatische Genehmigung mit allowedTools

207 207

208Verwenden Sie `allowedTools`, um bestimmte MCP-Tools automatisch zu genehmigen, damit Claude sie ohne Genehmigungsaufforderung verwenden kann:208Verwenden Sie `allowedTools`, um bestimmte MCP-Tools automatisch zu genehmigen:

209 209

210```typescript TypeScript hidelines={1,-1} theme={null}210```typescript TypeScript hidelines={1,-1} theme={null}

211const _ = {211const _ = {

agent-sdk/permissions.md +5 −5

Details

18 18

19**1. Hooks**19**1. Hooks**

20 20

21Führen Sie [Hooks](https://code.claude.com/docs/de/agent-sdk/hooks.md) aus. Ein Hook kann den Aufruf direkt ablehnen oder ihn weitergeben. Ein Hook, der `allow` zurückgibt, überspringt nicht die Deny- und Ask-Regeln unten; diese werden unabhängig vom Hook-Ergebnis ausgewertet.21Führen Sie [Hooks](https://code.claude.com/docs/de/agent-sdk/hooks.md) aus. Ein Hook kann den Aufruf direkt ablehnen oder ihn weitergeben. Ein Hook, der `allow` zurückgibt, überspringt nicht die Schritte für Deny- und Ask-Regeln, die unabhängig vom Hook-Ergebnis ausgewertet werden.

22 22

23Ein `PreToolUse`-Hook, der `allow` zurückgibt, kann außerdem keinen `rm`- oder `rmdir`-Befehl genehmigen, dessen Ziel Claude Code als [kritischen Pfad](https://code.claude.com/docs/de/permission-modes.md#critical-paths) erkennt, etwa `rm -rf ~`. Was dieses `allow` im Plan-Modus bewirkt, erfahren Sie unter [Hook-Genehmigungen im Plan-Modus](https://code.claude.com/docs/de/permissions.md#hook-approvals-in-plan-mode).23Ein `PreToolUse`-Hook, der `allow` zurückgibt, kann außerdem keinen `rm`- oder `rmdir`-Befehl genehmigen, dessen Ziel Claude Code als [kritischen Pfad](https://code.claude.com/docs/de/permission-modes.md#critical-paths) erkennt, etwa `rm -rf ~`. Was dieses `allow` im Plan-Modus bewirkt, erfahren Sie unter [Hook-Genehmigungen im Plan-Modus](https://code.claude.com/docs/de/permissions.md#hook-approvals-in-plan-mode).

24 24

58 58

59**6. canUseTool Callback**59**6. canUseTool Callback**

60 60

61Wenn nicht durch einen der oben genannten Punkte aufgelöst, rufen Sie Ihren [`canUseTool` Callback](https://code.claude.com/docs/de/agent-sdk/user-input) zur Entscheidung auf. Im `dontAsk` Modus wird dieser Schritt übersprungen und das Tool wird abgelehnt, wobei ein von Ihnen installierter [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) [einige solcher Aufrufe](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) dennoch genehmigen kann.61Wenn kein vorheriger Schritt die Anfrage auflöst, rufen Sie Ihren [`canUseTool` Callback](https://code.claude.com/docs/de/agent-sdk/user-input) zur Entscheidung auf. Im `dontAsk` Modus wird dieser Schritt übersprungen und das Tool wird abgelehnt, wobei ein von Ihnen installierter [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) [einige solcher Aufrufe](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) dennoch genehmigen kann.

62 62

63Im TypeScript SDK, wenn Sie [`permissionPrompts: 'none'`](https://code.claude.com/docs/de/agent-sdk/typescript#options) setzen, wird Ihr Callback in diesem Schritt nicht aufgerufen. Ein [`PermissionRequest` Hook](https://code.claude.com/docs/de/hooks#permissionrequest) erhält immer noch eine Chance zu entscheiden, und wenn nicht, lehnt Claude Code den Aufruf ab. Die Option erfordert Claude Code v2.1.259 oder später.63Im TypeScript SDK, wenn Sie [`permissionPrompts: 'none'`](https://code.claude.com/docs/de/agent-sdk/typescript#options) setzen, wird Ihr Callback in diesem Schritt nicht aufgerufen. Ein [`PermissionRequest` Hook](https://code.claude.com/docs/de/hooks#permissionrequest) erhält immer noch eine Chance zu entscheiden, und wenn nicht, lehnt Claude Code den Aufruf ab. Die Option erfordert Claude Code v2.1.259 oder später.

64 64

80 80

81## Allow- und Deny-Regeln81## Allow- und Deny-Regeln

82 82

83`allowed_tools` und `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) fügen Einträge zu den Allow- und Deny-Regellisten im obigen Evaluierungsfluss hinzu. Wenn Sie eines der [Task-Tracking-Tools](https://code.claude.com/docs/de/agent-sdk/todo-tracking.md#model-availability) in `allowed_tools` benennen, aktiviert Claude Code auch die Sitzung dafür. Jedes andere Tool, das nicht in `allowed_tools` aufgelistet ist, ist weiterhin für Claude verfügbar, und ein Aufruf, der Genehmigung benötigt, fällt durch zum Genehmigungsmodus. Deny-Regeln verhalten sich unterschiedlich, je nachdem, ob sie ein Tool benennen oder ein Muster innerhalb eines Tools eingrenzen.83Wenn Sie `allowedTools` und `disallowedTools` (TypeScript) oder `allowed_tools` und `disallowed_tools` (Python) setzen, fügt Claude Code deren Einträge zu den Allow- und Deny-Regellisten im [Ablauf der Berechtigungsauswertung](#how-permissions-are-evaluated) hinzu. Jedes andere Tool, das nicht in `allowed_tools` aufgelistet ist, ist weiterhin für Claude verfügbar, und ein Aufruf, der Genehmigung benötigt, fällt durch zum Berechtigungsmodus.

84 84

85| Option | Auswirkung |85| Option | Auswirkung |

86| :- | :- |86| :- | :- |

87| `allowed_tools=["Read", "Grep"]` | `Read` und `Grep` werden automatisch genehmigt, abgesehen von [Lesezugriffen auf Netzwerkpfade](https://code.claude.com/docs/de/permissions.md#network-paths). Andere Tools, die hier nicht aufgelistet sind, existieren weiterhin, und Aufrufe, die Genehmigung benötigen, fallen durch zum Berechtigungsmodus und `canUseTool`. |87| `allowed_tools=["Read", "Grep"]` | `Read` und `Grep` werden automatisch genehmigt, abgesehen von [Lesezugriffen auf Netzwerkpfade](https://code.claude.com/docs/de/permissions.md#network-paths). Andere Tools, die hier nicht aufgelistet sind, existieren weiterhin, und Aufrufe, die Genehmigung benötigen, fallen durch zum Berechtigungsmodus und `canUseTool`. |

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

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

91 91

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

93 93

agent-sdk/python.md +1 −1

Details

2787 2787

2788Führt eine Hintergrund-Quelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Text-Frame aus. Geben Sie genau eines von `command` oder `ws` an.2788Führt eine Hintergrund-Quelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Text-Frame aus. Geben Sie genau eines von `command` oder `ws` an.

2789 2789

2790Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash; eine WebSocket-Überwachung fordert separat zur Genehmigung auf. Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später. Siehe die [Monitor-Tool-Referenz](https://code.claude.com/docs/de/tools-reference.md#monitor-tool) für Verhalten und Anbieter-Verfügbarkeit.2790Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später. Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash. Siehe die [Monitor-Tool-Referenz](https://code.claude.com/docs/de/tools-reference.md#monitor-tool) für WebSocket-Berechtigungen, Verhalten und Anbieter-Verfügbarkeit.

2791 2791

2792**Eingabe:**2792**Eingabe:**

2793 2793

agent-sdk/typescript.md +5 −3

Details

3387 3387

3388Führt eine Hintergrund-Quelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Text-Frame aus. Geben Sie genau eines von `command` oder `ws` an. Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später.3388Führt eine Hintergrund-Quelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Text-Frame aus. Geben Sie genau eines von `command` oder `ws` an. Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später.

3389 3389

3390`timeout_ms` ist die Frist der Überwachung in Millisekunden. Sie beträgt standardmäßig 300000 und akzeptiert Werte bis zu 3600000. Die effektive Frist beträgt höchstens 1800000, was 30 Minuten sind, daher wird ein größerer akzeptierter Wert auf diesen gekürzt. Bei Ablauf der Frist endet die Überwachung und Claude erhält eine Benachrichtigung, damit es eine neue Überwachung starten kann, wenn es noch eine benötigt.3390`timeout_ms` ist die Frist der Überwachung in Millisekunden:

3391 3391

3392Der exportierte Typ markiert `timeout_ms` als erforderlich, da das Schema den Standard ausfüllt; ein Aufruf, der ihn auslässt, validiert.3392* **Standard und Grenzen**: Sie beträgt standardmäßig 300000 und akzeptiert Werte bis zu 3600000. Die effektive Frist beträgt höchstens 1800000, was 30 Minuten sind, daher wird ein größerer akzeptierter Wert auf diesen gekürzt

3393* **Bei Ablauf der Frist**: Die Überwachung endet und Claude erhält eine Benachrichtigung, damit es eine neue Überwachung starten kann, wenn es noch eine benötigt

3394* **Im Typ erforderlich**: Der exportierte Typ markiert `timeout_ms` als erforderlich, da das Schema den Standard ausfüllt; ein Aufruf, der ihn auslässt, validiert

3393 3395

3394Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash; eine WebSocket-Überwachung fordert separat zur Genehmigung auf. Siehe die [Monitor-Tool-Referenz](https://code.claude.com/docs/de/tools-reference.md#monitor-tool) für Verhalten und Anbieter-Verfügbarkeit.3396Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash. Siehe die [Monitor-Tool-Referenz](https://code.claude.com/docs/de/tools-reference.md#monitor-tool) für WebSocket-Berechtigungen, Verhalten und Anbieter-Verfügbarkeit.

3395 3397

3396### TaskOutput3398### TaskOutput

3397 3399

best-practices.md +2 −2

Details

433 433

434### Ändern Sie Modell und Effort434### Ändern Sie Modell und Effort

435 435

436[Effort](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) ist die wichtigste Steuerung dafür, wie lange Claude nachdenkt, und ersetzt das meiste, was man früher mit Prompt-Formulierungen gemacht hat. Claude Opus 5.5, Sonnet 5.5 und Haiku 5.5 verwenden standardmäßig `medium`, was für alltägliche Feature-Arbeit mit klarem Umfang völlig ausreicht. Wann Sie es mit `/effort` in der Sitzung ändern sollten:436[Effort](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) ist die wichtigste Steuerung dafür, wie lange Claude nachdenkt, und ersetzt das meiste, was man früher mit Prompt-Formulierungen gemacht hat. Claude Fable 5.2, Opus 5.5, Sonnet 5.5 und Haiku 5.5 verwenden standardmäßig `medium`, was für alltägliche Feature-Arbeit mit klarem Umfang völlig ausreicht. Wann Sie es mit `/effort` in der Sitzung ändern sollten:

437 437

438* Erhöhen Sie es mit `/effort high` oder `/effort xhigh`, wenn es darauf ankommt, Fälle zu erfassen, die leicht übersehen werden. Denken Sie an einen Fehler in Code, den Sie nicht geschrieben haben, einen instabilen Test oder eine Schemaänderung, bei der Claude jeden Leser der alten Struktur finden muss. Claude prüft dann mehr Edge Cases und verifiziert mehr von seiner Arbeit, bevor es antwortet. Dafür gehen die zusätzliche Zeit und die zusätzlichen Token drauf.438* Erhöhen Sie es mit `/effort high` oder `/effort xhigh`, wenn es darauf ankommt, Fälle zu erfassen, die leicht übersehen werden. Denken Sie an einen Fehler in Code, den Sie nicht geschrieben haben, einen instabilen Test oder eine Schemaänderung, bei der Claude jeden Leser der alten Struktur finden muss. Claude prüft dann mehr Edge Cases und verifiziert mehr von seiner Arbeit, bevor es antwortet. Dafür gehen die zusätzliche Zeit und die zusätzlichen Token drauf.

439* Senken Sie es mit `/effort low`, wenn Sie schnell hin und her arbeiten und ohnehin jedes Ergebnis prüfen: Brainstorming, ein erster Entwurf, eine Umbenennung über ein paar Dateien. Claude liefert Ihnen schneller einen Ausgangspunkt, und da Sie jeden Schritt steuern, hätte die zusätzliche Überlegung außer der Wartezeit kaum etwas geändert.439* Senken Sie es mit `/effort low`, wenn Sie schnell hin und her arbeiten und ohnehin jedes Ergebnis prüfen: Brainstorming, ein erster Entwurf, eine Umbenennung über ein paar Dateien. Claude liefert Ihnen schneller einen Ausgangspunkt, und da Sie jeden Schritt steuern, hätte die zusätzliche Überlegung außer der Wartezeit kaum etwas geändert.

440* Heben Sie `max` für ein schwieriges Problem auf, das Claude ohne Sie durcharbeiten soll, etwa die Suche nach einer Sicherheitslücke. Bei gewöhnlichen Aufgaben neigt es dazu, zu viel nachzudenken, sodass Sie mehr für eine Antwort bezahlen, die womöglich nicht besser ist als mit `high`.440* Heben Sie `max` für ein schwieriges Problem auf, das Claude ohne Sie durcharbeiten soll, etwa die Suche nach einer Sicherheitslücke. Bei gewöhnlichen Aufgaben neigt es dazu, zu viel nachzudenken, sodass Sie mehr für eine Antwort bezahlen, die womöglich nicht besser ist als mit `high`.

441* Wenn nur die nächste Nachricht es braucht, etwa eine knifflige Frage mitten in ansonsten alltäglicher Arbeit, schreiben Sie [`ultrathink`](https://code.claude.com/docs/de/model-config#use-ultrathink-for-one-off-deep-reasoning) in diesen Prompt, statt die Einstellung zu ändern.441* Wenn nur die nächste Nachricht es braucht, etwa eine knifflige Frage mitten in ansonsten alltäglicher Arbeit, schreiben Sie [`ultrathink`](https://code.claude.com/docs/de/model-config#use-ultrathink-for-one-off-deep-reasoning) in diesen Prompt, statt die Einstellung zu ändern.

442 442

443Was das Modell selbst angeht, bewältigt das Standardmodell Opus 5.5 die meisten Programmieraufgaben gut, und Sonnet kostet bei alltäglicher Arbeit weniger. [Claude Fable 5.1](https://code.claude.com/docs/de/model-config.md#work-with-fable) steht zur Verfügung, wenn Sie es ausdrücklich mit `/model fable` auswählen, und Haiku eignet sich gut für Subagenten mit einfachen Aufgaben. Unter [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md) finden Sie die vollständige Liste pro Plan und Anbieter.443Was das Modell selbst angeht, bewältigt das Standardmodell Opus 5.5 die meisten Programmieraufgaben gut, und Sonnet kostet bei alltäglicher Arbeit weniger. Um [Claude Fable 5.2](https://code.claude.com/docs/de/model-config.md#work-with-fable) zu verwenden, führen Sie `/model fable` aus. Haiku eignet sich gut für Subagenten mit einfachen Aufgaben. Unter [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md) finden Sie die vollständige Liste pro Plan und Anbieter.

444 444

445### Wissen Sie, was Subagenten kosten445### Wissen Sie, was Subagenten kosten

446 446

claude-apps-gateway.md +1 −1

Details

172 172

173Ein erfolgreicher Start validiert nicht den Inferenzpfad, da Amazon Bedrock und Google Clouds Agent Platform Instance-Anmeldedaten bei der ersten Anfrage aufgelöst werden, nicht beim Start.173Ein erfolgreicher Start validiert nicht den Inferenzpfad, da Amazon Bedrock und Google Clouds Agent Platform Instance-Anmeldedaten bei der ersten Anfrage aufgelöst werden, nicht beim Start.

174 174

175Beobachten Sie stderr auf die Boot-Sequenz. Log-Zeilen verwenden das Format `[gateway] <timestamp> <level> <message>`, Audit-Events sind einzeilige JSON mit einem `evt`-Feld, und ein Startup-Banner, unten weggelassen, wird zwischen der Migration und den Listening-Zeilen gedruckt. Eine frische Datenbank druckt eine `migration N applied`-Zeile pro Schema-Migration; eine bereits migrierte Datenbank druckt keine. Sie sollten in dieser Reihenfolge sehen:175Beobachten Sie stderr auf die Boot-Sequenz. Standardmäßig verwenden Log-Zeilen das Format `[gateway] <timestamp> <level> <message>`, und ein Startup-Banner, unten weggelassen, wird zwischen der Migration und den Listening-Zeilen gedruckt. Audit-Events sind einzeiliges JSON mit einem `evt`-Feld. Eine frische Datenbank druckt eine `migration N applied`-Zeile pro Schema-Migration; eine bereits migrierte Datenbank druckt keine. Sie sollten in dieser Reihenfolge sehen:

176 176

177```text theme={null}177```text theme={null}

178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}

claude-apps-gateway-config.md +43 −5

Details

28 28

29**Optionale Abschnitte:**29**Optionale Abschnitte:**

30 30

31* [`login_notice`](#login_notice): ein Hinweis, den Entwickler bei der Anmeldung sehen

31* [`admin`](#admin): Admin-API-Authentifizierung und Aufbewahrung für Ausgabenlimits32* [`admin`](#admin): Admin-API-Authentifizierung und Aufbewahrung für Ausgabenlimits

32* [`enforcement`](#enforcement): Ausgabenlimit-Verhalten bei Fehler-offen oder Fehler-geschlossen33* [`enforcement`](#enforcement): Ausgabenlimit-Verhalten bei Fehler-offen oder Fehler-geschlossen

33* [`pricing`](#pricing): vertraglich vereinbarte Sätze und ein Multiplikator für das Ausgabenmessgerät und für die Kostenzahlen, die Entwickler sehen34* [`pricing`](#pricing): vertraglich vereinbarte Sätze und ein Multiplikator für das Ausgabenmessgerät und für die Kostenzahlen, die Entwickler sehen

847 848

848## Optionale Abschnitte849## Optionale Abschnitte

849 850

851### `login_notice`

852

853Um Entwicklern bei der Anmeldung einen Hinweis anzuzeigen, setzen Sie den Schlüssel `login_notice` auf oberster Ebene auf den Hinweistext mit bis zu 500 Zeichen. Dieses Beispiel gibt an, für wen das Gateway bestimmt ist und wo man Zugriff anfragen kann:

854

855```yaml theme={null}

856login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

857```

858

859Entwickler sehen den Text unter `Notice from <gateway hostname>` auf der Verifizierungsseite des Gateways im Browser und auf dem interaktiven Anmeldebildschirm im Terminal. Zeilenumbrüche im Text werden zu Leerzeichen. Der Hinweis erscheint vor der Anmeldung, sodass ihn jeder lesen kann, der das Gateway erreicht.

860

861Erfordert Claude Code v2.1.319 oder höher auf dem Gateway-Server und für den Terminal-Bildschirm auch auf dem Rechner des Entwicklers. Ein älteres Gateway verweigert den Start, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Schlüssel hinzufügen, und entfernen Sie den Schlüssel, bevor Sie ein Rollback durchführen.

862

850### `admin`863### `admin`

851 864

852Optional. Aktiviert `/v1/organizations/spend_limits`, das Anthropics öffentliche Admin-API widerspiegelt, und erzwingt Ausgabenlimits pro Entwickler auf `/v1/messages`. Siehe [Ausgabenlimits](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) für die Festlegung und Durchsetzung von Limits; dieser Abschnitt behandelt die `gateway.yaml`-Schlüssel, die die Funktion aktivieren und optimieren.865Optional. Aktiviert `/v1/organizations/spend_limits`, das Anthropics öffentliche Admin-API widerspiegelt, und erzwingt Ausgabenlimits pro Entwickler auf `/v1/messages`. Siehe [Ausgabenlimits](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) für die Festlegung und Durchsetzung von Limits; dieser Abschnitt behandelt die `gateway.yaml`-Schlüssel, die die Funktion aktivieren und optimieren.

853 866

854```yaml theme={null}867```yaml theme={null}

855admin:868admin:

856 # Benannte statische API-Schlüssel für die Admin-Endpunkte, gesendet als x-api-key.869 # Named static API keys for the admin endpoints, sent as x-api-key.

857 # Die ID wird im Audit-Log als admin-key:<id> angezeigt, sodass jeder Schlüssel870 # The id appears in the audit log as admin-key:<id> so each key is

858 # zuordenbar ist. Array für Rotation: neuen Schlüssel hinzufügen, Clients aktualisieren,871 # attributable. Array for rotation: add the new key, roll clients,

859 # alten entfernen.872 # remove the old.

860 write_keys:873 write_keys:

861 - { id: terraform, key: "${GATEWAY_ADMIN_WRITE_KEY_TF}" }874 - { id: terraform, key: "${GATEWAY_ADMIN_WRITE_KEY_TF}" }

862 - { id: ci, key: "${GATEWAY_ADMIN_WRITE_KEY_CI}" }875 - { id: ci, key: "${GATEWAY_ADMIN_WRITE_KEY_CI}" }

863 read_keys:876 read_keys:

864 - { id: reporting, key: "${GATEWAY_ADMIN_READ_KEY}" }877 - { id: reporting, key: "${GATEWAY_ADMIN_READ_KEY}" }

865 # IdP-Gruppen mit vollständigem Admin-Zugriff über das normale Gateway-JWT (kein API-Schlüssel).878 # IdP groups granted full admin via the normal gateway JWT (no API key).

866 admin_groups: [platform-finops]879 admin_groups: [platform-finops]

867 blocked_message: request an increase at https://go.example.com/claude-limits880 blocked_message: request an increase at https://go.example.com/claude-limits

881 # Try eng-platform's pooled budget first, then eng-all's, then any other group's.

882 pooled_conflict_rule: priority_list

883 pooled_priority_order: [eng-platform, eng-all]

868```884```

869 885

877| `spend_retention_months` | Nein | Standard `13`. `spend`-Zählerzeilen, die älter als dieser Wert sind, werden gelöscht. Der Standard behält ein volles Jahr plus den aktuellen Teilmonat für Jahresvergleichsberichte. |893| `spend_retention_months` | Nein | Standard `13`. `spend`-Zählerzeilen, die älter als dieser Wert sind, werden gelöscht. Der Standard behält ein volles Jahr plus den aktuellen Teilmonat für Jahresvergleichsberichte. |

878| `identity_retention_days` | Nein | Standard `90`. Last-Seen-TTL für `principal_emails`-Zeilen, die die E-Mail, den Anzeigenamen und die Gruppen jedes Entwicklers enthalten (PII). Absichtlich kürzer als die Ausgabenaufbewahrung, sodass eine deprovisionierte Identität ausläuft, während ihre anonymen Ausgabenzähler erhalten bleiben. |894| `identity_retention_days` | Nein | Standard `90`. Last-Seen-TTL für `principal_emails`-Zeilen, die die E-Mail, den Anzeigenamen und die Gruppen jedes Entwicklers enthalten (PII). Absichtlich kürzer als die Ausgabenaufbewahrung, sodass eine deprovisionierte Identität ausläuft, während ihre anonymen Ausgabenzähler erhalten bleiben. |

879| `group_limit_mode` | Nein | `min` (Standard) oder `max`. Wenn sich ein Entwickler in mehreren Gruppen mit Limits befindet, erzwingt `min` das restriktivste und `max` das am wenigsten restriktive. Wird sowohl von der Durchsetzung als auch von `/effective` verwendet. |895| `group_limit_mode` | Nein | `min` (Standard) oder `max`. Wenn sich ein Entwickler in mehreren Gruppen mit Limits befindet, erzwingt `min` das restriktivste und `max` das am wenigsten restriktive. Wird sowohl von der Durchsetzung als auch von `/effective` verwendet. |

896| `pooled_conflict_rule` | Nein | `default_order` (Standard) oder `priority_list`. Die Reihenfolge, in der das Gateway die gemeinsamen Budgets eines Entwicklers ausprobiert. Siehe [Reihenfolge gemeinsamer Budgets](#pooled-budget-order). Erfordert v2.1.319 oder höher. |

897| `pooled_priority_order` | Mit `priority_list` | Bis zu 50 Gruppennamen, jeder einmal aufgeführt und so geschrieben, wie Ihr IdP ihn sendet. Die Gruppen, deren gemeinsame Budgets das Gateway zuerst ausprobiert. Siehe [Reihenfolge gemeinsamer Budgets](#pooled-budget-order). Erfordert v2.1.319 oder höher. |

898

899#### Reihenfolge gemeinsamer Budgets

900

901Ein gemeinsames Budget ist ein monatliches Limit, auf das eine ganze Gruppe ihre Ausgaben anrechnet. Um eines festzulegen, fügen Sie `pooled_budget` zur [Anfrage hinzu, die die monatliche Obergrenze der Gruppe festlegt](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md#set-a-cap), etwa `"pooled_budget": {"amount": "500000"}` für 5.000 \$. Die Anfrage enthält außerdem den `scope` der Gruppe, `"period": "monthly"` und `amount`, das weiterhin die eigene Obergrenze jedes Mitglieds bleibt.

902

903Für einen Entwickler in mehreren solchen Gruppen wird jede Anfrage auf das erste Budget angerechnet, dessen Ausgaben unter seinem Limit liegen, und abgelehnt, wenn jedes Budget aufgebraucht ist. `pooled_conflict_rule` legt die Reihenfolge fest, in der das Gateway die Budgets ausprobiert:

904

905* **`default_order`**: das größte Limit zuerst, bei gleichen Limits in aufsteigender Reihenfolge der Gruppennamen

906* **`priority_list`**: die Budgets der Gruppen in `pooled_priority_order` in Listenreihenfolge, danach die Budgets der übrigen Gruppen nach Gruppenname

907

908Wenn Sie Gruppen ohne `pooled_conflict_rule: priority_list` auflisten, ignoriert das Gateway die Liste und protokolliert beim Start eine Warnung.

909

910Ein Gateway-Server vor v2.1.319 verweigert den Start, wenn er `pooled_conflict_rule` oder `pooled_priority_order` findet. Aktualisieren Sie jedes Replikat, bevor Sie einen der beiden Schlüssel hinzufügen, und entfernen Sie beide Schlüssel, bevor Sie ein Rollback durchführen.

880 911

881### `enforcement`912### `enforcement`

882 913

1676# protokolliert auch die Anspruchsnamen in jedem id_token zur Diagnose von groups_claim.1707# protokolliert auch die Anspruchsnamen in jedem id_token zur Diagnose von groups_claim.

1677# Es beeinflusst nicht Audit-Ereignisse, die immer ausgegeben werden.1708# Es beeinflusst nicht Audit-Ereignisse, die immer ausgegeben werden.

1709# Setzen Sie CLAUDE_GATEWAY_LOG_FORMAT=json, um operative Log-Zeilen als JSON-

1710# Objekte mit severity, time und message zu schreiben.

1678 1711

1679listen:1712listen:

1680 host: 0.0.0.01713 host: 0.0.0.0

1715 # connect_timeout_seconds: 51748 # connect_timeout_seconds: 5

1716 # readiness_grace_seconds: 300 # die Readiness-Prüfung während eines Datenbank-Failovers weiterhin bestehen1749 # readiness_grace_seconds: 300 # die Readiness-Prüfung während eines Datenbank-Failovers weiterhin bestehen

1717 1750

1751# Hinweis, der bei der Anmeldung angezeigt wird. Jeder, der das Gateway erreichen kann, kann ihn lesen.

1752# login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

1753

1718# Aktiviert /v1/organizations/spend_limits (spiegelt die Anthropic Admin API)1754# Aktiviert /v1/organizations/spend_limits (spiegelt die Anthropic Admin API)

1719# und Pro-Entwickler-Ausgabendurchsetzung auf /v1/messages. Lassen Sie weg, um zu deaktivieren.1755# und Pro-Entwickler-Ausgabendurchsetzung auf /v1/messages. Lassen Sie weg, um zu deaktivieren.

1720# Caps selbst werden über die Admin API gesetzt, nicht hier.1756# Caps selbst werden über die Admin API gesetzt, nicht hier.

1729# # spend_retention_months: 131765# # spend_retention_months: 13

1730# # identity_retention_days: 901766# # identity_retention_days: 90

1731# # group_limit_mode: min1767# # group_limit_mode: min

1768# # pooled_conflict_rule: priority_list

1769# # pooled_priority_order: [eng-platform, eng-all]

1732 1770

1733# enforcement:1771# enforcement:

1734# fail_closed_on_error: false1772# fail_closed_on_error: false

claude-apps-gateway-deploy.md +14 −0

Details

173 * `admin.denied` protokolliert einen abgelehnten Authentifizierungsversuch an der Admin-API mit Client-IP, Methode, Pfad und einem Grund, ohne das vorgelegte Schlüsselmaterial: `invalid_key`, wenn ein `x-api-key` vorgelegt wurde, der zu keinem konfigurierten Schlüssel passte, `bearer_rejected`, wenn nur ein `Authorization`-Header vorgelegt wurde und dieser nicht als Gateway-Sitzung in `admin.admin_groups` verifiziert werden konnte, oder `no_credentials`, wenn keiner der beiden Header vorgelegt wurde173 * `admin.denied` protokolliert einen abgelehnten Authentifizierungsversuch an der Admin-API mit Client-IP, Methode, Pfad und einem Grund, ohne das vorgelegte Schlüsselmaterial: `invalid_key`, wenn ein `x-api-key` vorgelegt wurde, der zu keinem konfigurierten Schlüssel passte, `bearer_rejected`, wenn nur ein `Authorization`-Header vorgelegt wurde und dieser nicht als Gateway-Sitzung in `admin.admin_groups` verifiziert werden konnte, oder `no_credentials`, wenn keiner der beiden Header vorgelegt wurde

174* **Betriebs-Logs**: menschenlesbare Zeilen mit dem Präfix `[gateway]` für Start, Warnungen und Upstream-Fehler. Die Umgebungsvariable `CLAUDE_GATEWAY_LOG_LEVEL` steuert die Ausführlichkeit und akzeptiert `debug`, `info`, `warn` oder `error`, wobei `info` der Standard ist. Bei `debug` protokolliert jede Anmeldung und jeder Refresh zusätzlich die Namen, nicht die Werte, der Claims im id\_token sowie die Namen der Userinfo-Claims, wenn `userinfo_fallback` welche geliefert hat, sodass Sie die Einstellungen `email_claim` und `groups_claim` diagnostizieren können, ohne personenbezogene Daten zu protokollieren. Sie wirkt sich nicht auf Audit-Ereignisse aus, die immer ausgegeben werden.174* **Betriebs-Logs**: menschenlesbare Zeilen mit dem Präfix `[gateway]` für Start, Warnungen und Upstream-Fehler. Die Umgebungsvariable `CLAUDE_GATEWAY_LOG_LEVEL` steuert die Ausführlichkeit und akzeptiert `debug`, `info`, `warn` oder `error`, wobei `info` der Standard ist. Bei `debug` protokolliert jede Anmeldung und jeder Refresh zusätzlich die Namen, nicht die Werte, der Claims im id\_token sowie die Namen der Userinfo-Claims, wenn `userinfo_fallback` welche geliefert hat, sodass Sie die Einstellungen `email_claim` und `groups_claim` diagnostizieren können, ohne personenbezogene Daten zu protokollieren. Sie wirkt sich nicht auf Audit-Ereignisse aus, die immer ausgegeben werden.

175 175

176#### Betriebs-Logs als JSON schreiben

177

178Wenn Ihr Log-Collector die Stufe jeder Zeile aus einem JSON-Feld liest, setzen Sie `CLAUDE_GATEWAY_LOG_FORMAT=json` in der Umgebung des Gateways. Erfordert Claude Code v2.1.319 oder höher auf dem Gateway-Server.

179

180Jede Zeile der Betriebs-Logs ist dann ein Objekt mit `severity`, `time` und `message`:

181

182```json theme={null}

183{"severity":"INFO","time":"2026-11-04T17:03:21.512Z","message":"claude gateway listening on http://0.0.0.0:8080"}

184```

185

186`severity` ist die Log-Stufe in Großbuchstaben, wobei `warn` als `WARNING` geschrieben wird. Ein fehlgeschlagener Start ist eine `ERROR`-Zeile.

187

188Audit-Ereignisse, die ebenfalls nach stderr gehen, ändern sich nicht. Sie enthalten `ts` und `evt`, aber kein `severity`.

189

176### Zustand190### Zustand

177 191

178Das Gateway stellt `GET /healthz` als Liveness-Probe und `GET /readyz` als Readiness-Probe bereit. `/readyz` prüft, ob der Store erreichbar ist. Wenn Sie [`store.readiness_grace_seconds`](https://code.claude.com/docs/de/claude-apps-gateway-config#store) setzen, meldet `/readyz` bis zu diese Anzahl an Sekunden weiterhin Bereitschaft, nachdem der Store nicht mehr antwortet.192Das Gateway stellt `GET /healthz` als Liveness-Probe und `GET /readyz` als Readiness-Probe bereit. `/readyz` prüft, ob der Store erreichbar ist. Wenn Sie [`store.readiness_grace_seconds`](https://code.claude.com/docs/de/claude-apps-gateway-config#store) setzen, meldet `/readyz` bis zu diese Anzahl an Sekunden weiterhin Bereitschaft, nachdem der Store nicht mehr antwortet.

claude-apps-gateway-spend-limits.md +11 −2

Details

6 6

7> Begrenzen Sie die Ausgaben jedes Entwicklers über das Claude-Apps-Gateway pro Tag, Woche oder Monat. Legen Sie Limits mit einer Admin-API fest und das Gateway erzwingt sie live bei jeder Anfrage.7> Begrenzen Sie die Ausgaben jedes Entwicklers über das Claude-Apps-Gateway pro Tag, Woche oder Monat. Legen Sie Limits mit einer Admin-API fest und das Gateway erzwingt sie live bei jeder Anfrage.

8 8

9Ausgabenlimits begrenzen, wie viel jeder Entwickler über Ihr [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway) an einem bestimmten Tag, einer Woche oder einem Monat ausgeben kann. Wenn ein Entwickler sein Limit überschreitet, gibt das Gateway `429` bei seiner nächsten Anfrage zurück und blockiert ihn, bis sich der Zeitraum zurückgesetzt hat oder ein Administrator das Limit erhöht. Verwenden Sie Ausgabenlimits, um jedem Entwickler, einer Gruppe oder der gesamten Organisation eine Obergrenze für eine gemeinsam genutzte Anmeldedaten zu setzen.9Ausgabenlimits begrenzen, wie viel jeder Entwickler über Ihr [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway) an einem bestimmten Tag, einer Woche oder einem Monat ausgeben kann. Wenn ein Entwickler sein Limit überschreitet, gibt das Gateway bei seinen folgenden Anfragen `429` zurück, bis ein Admin das Limit erhöht oder, falls das Limit über \$0 liegt, bis es sich zurücksetzt. Verwenden Sie Ausgabenlimits, um jedem Entwickler, einer Gruppe oder der gesamten Organisation eine Obergrenze für gemeinsam genutzte Anmeldedaten zu setzen.

10 10

11Standardmäßig leitet ein Claude-Apps-Gateway alle Inferenzen über eine gemeinsame Upstream-Anmeldedaten weiter, sodass die Rechnung Ihres Anbieters alles dieser Anmeldedaten zuordnet, nicht einzelnen Entwicklern. Auf Amazon Bedrock ändert die [Pro-Entwickler-AWS-Kostenattribution](https://code.claude.com/docs/de/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) dies. Ohne Pro-Entwickler-Limits kann eine unkontrollierte Agent-Flotte die gesamte Verpflichtung der Organisation ausgeben. Ausgabenlimits sind die Pro-Entwickler-Ansicht des Gateways und ein Schutzschalter auf dieser gemeinsamen Rechnung.11Standardmäßig leitet ein Claude-Apps-Gateway alle Inferenzen über eine gemeinsame Upstream-Anmeldedaten weiter, sodass die Rechnung Ihres Anbieters alles dieser Anmeldedaten zuordnet, nicht einzelnen Entwicklern. Auf Amazon Bedrock ändert die [Pro-Entwickler-AWS-Kostenattribution](https://code.claude.com/docs/de/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) dies. Ohne Pro-Entwickler-Limits kann eine unkontrollierte Agent-Flotte die gesamte Verpflichtung der Organisation ausgeben. Ausgabenlimits sind die Pro-Entwickler-Ansicht des Gateways und ein Schutzschalter auf dieser gemeinsamen Rechnung.

12 12

51 51

52Bei jeder `/v1/messages`-Anfrage schlägt das Gateway die Limits und die bisherigen Ausgaben des Entwicklers in einer Postgres-Abfrage nach. Ein Entwickler, der ein Limit überschreitet, erhält eine `429` mit `error.type: billing_error` und dem Header `x-should-retry: false`.52Bei jeder `/v1/messages`-Anfrage schlägt das Gateway die Limits und die bisherigen Ausgaben des Entwicklers in einer Postgres-Abfrage nach. Ein Entwickler, der ein Limit überschreitet, erhält eine `429` mit `error.type: billing_error` und dem Header `x-should-retry: false`.

53 53

54Die Nachricht nennt den Zeitraum und die Rücksetzeit, z. B. `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, gefolgt von Ihrer [`admin.blocked_message`](https://code.claude.com/docs/de/claude-apps-gateway-config#admin), falls gesetzt. Wenn ein Entwickler mehrere Limits gleichzeitig überschreitet, nennt die Nachricht das Limit, das zuletzt zurückgesetzt wird. Die Antwort enthält auch einen `retry-after`-Header mit den Sekunden bis zu diesem Zurücksetzen. Vor v2.1.225 auf dem Gateway-Server war die Nachricht `spend limit reached` ohne Zeitraum, Rücksetzeit oder `retry-after`-Header.54Bei einem Limit über `"0"` nennt die Nachricht das UTC-Datum, an dem dieses Limit zurückgesetzt wird. Wenn Sie [`admin.blocked_message`](https://code.claude.com/docs/de/claude-apps-gateway-config#admin) setzen, hängt das Gateway diese an, wie in diesem Beispiel:

56```text theme={null}

57spend limit reached · resets Dec 1 · request an increase at https://go.example.com/claude-limits

58```

60Bei einem Limit von `"0"`, das durch ein Zurücksetzen nicht aufgehoben wird, enthält die Nachricht kein Datum. Wenn ein Entwickler mehrere Limits gleichzeitig überschreitet, beschreibt die Nachricht das Limit, das zuletzt zurückgesetzt wird. Die Antwort enthält auch einen `retry-after`-Header mit den Sekunden bis zum Ende des Zeitraums dieses Limits.

62Vor v2.1.319 auf dem Gateway-Server nannte die Nachricht den Zeitraum und die Rücksetzeit, z. B. `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`. Vor v2.1.225 war die Nachricht `spend limit reached` ohne Zeitraum, Rücksetzeit oder `retry-after`-Header.

55 63

56Ab v2.1.227 listet die Protokollreferenz unter `<public_url>/protocol` auch die genauen Antwortheader für Nutzungslimits und den `429`-Body auf.64Ab v2.1.227 listet die Protokollreferenz unter `<public_url>/protocol` auch die genauen Antwortheader für Nutzungslimits und den `429`-Body auf.

57 65

96| Eine **Spend limit**-Leiste in `/usage` mit dem Prozentsatz des verwendeten Limits und dem Zeitpunkt des Zurücksetzens sowie ein `rate_limits.spend_limit`-Objekt in der Statuszeilen-Eingabe | v2.1.251 oder später | v2.1.225 oder später |104| Eine **Spend limit**-Leiste in `/usage` mit dem Prozentsatz des verwendeten Limits und dem Zeitpunkt des Zurücksetzens sowie ein `rate_limits.spend_limit`-Objekt in der Statuszeilen-Eingabe | v2.1.251 oder später | v2.1.225 oder später |

97| Die geschätzten Ausgaben und das Limit in US-Dollar in der **Spend limit**-Leiste, z. B. „\$271.40 / \$500.00 spent this month“, sowie dieselben Beträge plus den Zeitraum des Limits in der Statuszeilen-Eingabe | v2.1.284 oder später | v2.1.284 oder später |105| Die geschätzten Ausgaben und das Limit in US-Dollar in der **Spend limit**-Leiste, z. B. „\$271.40 / \$500.00 spent this month“, sowie dieselben Beträge plus den Zeitraum des Limits in der Statuszeilen-Eingabe | v2.1.284 oder später | v2.1.284 oder später |

106| Auf einem Gateway mit einem [`admin:`](https://code.claude.com/docs/de/claude-apps-gateway-config#admin)-Block, wenn kein Limit für den Entwickler gilt, die geschätzten Ausgaben unter **Spend (UTC)** in `/usage`, z. B. „\$13.06 today · \$80.76 this week · \$272.06 this month“ | v2.1.319 oder später | v2.1.319 oder später |

98 107

99Die Warnungen und der Prozentsatz stammen aus den `anthropic-ratelimit-unified-*`-Headern, die das Gateway jeder erfolgreichen `/v1/messages`-Antwort für einen Entwickler hinzufügt, der ein Limit hat. Die Header beschreiben immer das eigene Limit des Entwicklers: Das Gateway entfernt die Rate-Limit-Header des Upstream-Anbieters, die Ihre gemeinsame Quote beschreiben, und leitet sie nie weiter.108Die Warnungen und der Prozentsatz stammen aus den `anthropic-ratelimit-unified-*`-Headern, die das Gateway jeder erfolgreichen `/v1/messages`-Antwort für einen Entwickler hinzufügt, der ein Limit hat. Die Header beschreiben immer das eigene Limit des Entwicklers: Das Gateway entfernt die Rate-Limit-Header des Upstream-Anbieters, die Ihre gemeinsame Quote beschreiben, und leitet sie nie weiter.

100 109

cli-reference.md +2 −2

Details

42| `claude plugin` | Verwalten Sie Claude Code [Plugins](https://code.claude.com/docs/de/plugins/overview.md). Alias: `claude plugins`. Siehe [Plugin-Referenz](https://code.claude.com/docs/de/plugins/cli-reference.md#claude-plugin-commands) für Unterbefehle | `claude plugin install code-review@claude-plugins-official` |42| `claude plugin` | Verwalten Sie Claude Code [Plugins](https://code.claude.com/docs/de/plugins/overview.md). Alias: `claude plugins`. Siehe [Plugin-Referenz](https://code.claude.com/docs/de/plugins/cli-reference.md#claude-plugin-commands) für Unterbefehle | `claude plugin install code-review@claude-plugins-official` |

43| `claude purge [path]` | Löschen Sie alle lokalen Claude Code-Status für ein Projekt: Transkripte, Aufgabenlisten, Debug-Logs, Datei-Bearbeitungsverlauf, Prompt-Verlaufszeilen und den Projekteintrag in `~/.claude.json`. Lassen Sie `[path]` weg, um aus einer interaktiven Liste auszuwählen. Flags: `--dry-run` zum Vorschau, `-y`/`--yes` zum Überspringen der Bestätigung, `-i`/`--interactive` zum Bestätigen jedes Elements, `--all` für jedes Projekt. Siehe [Lokale Daten löschen](https://code.claude.com/docs/de/claude-directory.md#clear-local-data) | `claude purge ~/work/repo --dry-run` |43| `claude purge [path]` | Löschen Sie alle lokalen Claude Code-Status für ein Projekt: Transkripte, Aufgabenlisten, Debug-Logs, Datei-Bearbeitungsverlauf, Prompt-Verlaufszeilen und den Projekteintrag in `~/.claude.json`. Lassen Sie `[path]` weg, um aus einer interaktiven Liste auszuwählen. Flags: `--dry-run` zum Vorschau, `-y`/`--yes` zum Überspringen der Bestätigung, `-i`/`--interactive` zum Bestätigen jedes Elements, `--all` für jedes Projekt. Siehe [Lokale Daten löschen](https://code.claude.com/docs/de/claude-directory.md#clear-local-data) | `claude purge ~/work/repo --dry-run` |

44| `claude remote-control` | Starten Sie einen [Remote Control](https://code.claude.com/docs/de/remote-control.md) Server, um Claude Code von Claude.ai oder der Claude App zu steuern. Läuft im Server-Modus (keine lokale interaktive Sitzung). Siehe [Server-Modus-Flags](https://code.claude.com/docs/de/remote-control.md#start-a-remote-control-session). Nach dem Stoppen des Servers können Sie die Sitzungen, die er bedient hat, zurückbringen. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](https://code.claude.com/docs/de/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |44| `claude remote-control` | Starten Sie einen [Remote Control](https://code.claude.com/docs/de/remote-control.md) Server, um Claude Code von claude.ai oder der Claude App zu steuern. Alias: `claude rc`. Läuft im Server-Modus (keine lokale interaktive Sitzung). Siehe [Server-Modus-Flags](https://code.claude.com/docs/de/remote-control.md#start-a-remote-control-session). Nach dem Stoppen des Servers können Sie die Sitzungen, die er bedient hat, zurückbringen. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](https://code.claude.com/docs/de/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |

45| `claude respawn <id>` | Starten Sie eine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md#manage-sessions-from-the-shell) neu, ob laufend oder gestoppt, mit ihrer Konversation intakt. Verwenden Sie `--all`, um jede laufende Sitzung neu zu starten, z. B. um eine aktualisierte Claude Code Binärdatei zu verwenden | `claude respawn 7c5dcf5d` |45| `claude respawn <id>` | Starten Sie eine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md#manage-sessions-from-the-shell) neu, ob laufend oder gestoppt, mit ihrer Konversation intakt. Verwenden Sie `--all`, um jede laufende Sitzung neu zu starten, z. B. um eine aktualisierte Claude Code Binärdatei zu verwenden | `claude respawn 7c5dcf5d` |

46| `claude rm <id>` | Entfernen Sie eine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md#manage-sessions-from-the-shell) aus der Liste. Wenn die Entfernung [über das Worktree der Sitzung abgelehnt wird](https://code.claude.com/docs/de/agent-view.md#what-deleting-a-session-removes) und ein zweites `claude rm` kann es beheben, gibt die Ablehnung das genaue Flag und den Wert aus, die übergeben werden sollen: `--discard-unpushed <commit>@<worktree-id>` verwirft ein Worktree, das nicht gepushte Commits zusammen mit diesen Commits hat, und `--force-remove-worktree <worktree-id>` löscht ein Worktree-Verzeichnis, das git oder der `WorktreeRemove` Hook nicht entfernen konnte. `--discard-unpushed` erfordert Claude Code v2.1.260 oder später, und `--force-remove-worktree` erfordert v2.1.268 oder später. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über `claude --resume` verfügbar | `claude rm 7c5dcf5d` |46| `claude rm <id>` | Entfernen Sie eine [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md#manage-sessions-from-the-shell) aus der Liste. Wenn die Entfernung [über das Worktree der Sitzung abgelehnt wird](https://code.claude.com/docs/de/agent-view.md#what-deleting-a-session-removes) und ein zweites `claude rm` kann es beheben, gibt die Ablehnung das genaue Flag und den Wert aus, die übergeben werden sollen: `--discard-unpushed <commit>@<worktree-id>` verwirft ein Worktree, das nicht gepushte Commits zusammen mit diesen Commits hat, und `--force-remove-worktree <worktree-id>` löscht ein Worktree-Verzeichnis, das git oder der `WorktreeRemove` Hook nicht entfernen konnte. `--discard-unpushed` erfordert Claude Code v2.1.260 oder später, und `--force-remove-worktree` erfordert v2.1.268 oder später. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über `claude --resume` verfügbar | `claude rm 7c5dcf5d` |

47| `claude self-hosted-runner` | Starten Sie einen Runner-Prozess, der diese Maschine oder diesen Container bei einer [selbstgehosteten Umgebung](https://code.claude.com/docs/de/self-hosted-environments) registriert und Claude Code Cloud-Sitzungen auf Ihrer Infrastruktur hostet. Führen Sie `claude self-hosted-runner setup` für eine geführte Operator-Anleitung aus, `claude self-hosted-runner doctor`, um [einen bereitgestellten Runner zu diagnostizieren](https://code.claude.com/docs/de/self-hosted-environments-deploy.md#troubleshooting), und `claude self-hosted-runner orchestrator`, um [On-Demand-Runner](https://code.claude.com/docs/de/self-hosted-environments-configuration.md#on-demand-runners) zu spawnen. Erfordert Claude Code v2.1.224 oder später | `claude self-hosted-runner setup` |47| `claude self-hosted-runner` | Starten Sie einen Runner-Prozess, der diese Maschine oder diesen Container bei einer [selbstgehosteten Umgebung](https://code.claude.com/docs/de/self-hosted-environments) registriert und Claude Code Cloud-Sitzungen auf Ihrer Infrastruktur hostet. Führen Sie `claude self-hosted-runner setup` für eine geführte Operator-Anleitung aus, `claude self-hosted-runner doctor`, um [einen bereitgestellten Runner zu diagnostizieren](https://code.claude.com/docs/de/self-hosted-environments-deploy.md#troubleshooting), und `claude self-hosted-runner orchestrator`, um [On-Demand-Runner](https://code.claude.com/docs/de/self-hosted-environments-configuration.md#on-demand-runners) zu spawnen. Erfordert Claude Code v2.1.224 oder später | `claude self-hosted-runner setup` |

111| `--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`](https://code.claude.com/docs/de/env-vars)-Umgebungsvariable macht das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |111| `--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`](https://code.claude.com/docs/de/env-vars)-Umgebungsvariable macht das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |

113| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md). 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](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) beschrieben ist, was auch abdeckt, in welchem Modus ein `-p`-Lauf startet | `claude --permission-mode plan` |113| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md). 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](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) beschrieben ist, was auch abdeckt, in welchem Modus ein `-p`-Lauf startet | `claude --permission-mode plan` |

114| `--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`](https://code.claude.com/docs/de/env-vars)-Startup-Timeout, standardmäßig 30 Sekunden. Das Prompt-Tool kann ein MCP-Tool, das als [Benutzerinteraktion erfordernd](https://code.claude.com/docs/de/mcp.md#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"` |114| `--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`](https://code.claude.com/docs/de/env-vars)-Startup-Timeout, standardmäßig 30 Sekunden. Siehe [was das Tool zurückgeben muss](https://code.claude.com/docs/de/errors.md#permission-prompt-tool-returned-an-invalid-result). Das Prompt-Tool kann ein MCP-Tool, das als [Benutzerinteraktion erfordernd](https://code.claude.com/docs/de/mcp.md#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"` |

115| `--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](https://code.claude.com/docs/de/headless.md#turn-off-permission-prompts-in-unattended-runs). Erfordert Claude Code v2.1.259 oder später | `claude -p --permission-prompts none "query"` |115| `--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](https://code.claude.com/docs/de/headless.md#turn-off-permission-prompts-in-unattended-runs). Erfordert Claude Code v2.1.259 oder später | `claude -p --permission-prompts none "query"` |

116| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip`-Archiv, oder mehrere aus einem [Ordner von Plugins](https://code.claude.com/docs/de/plugins/create.md#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` |116| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip`-Archiv, oder mehrere aus einem [Ordner von Plugins](https://code.claude.com/docs/de/plugins/create.md#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` |

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

commands.md +1 −1

Details

162| `/ultrareview [PR or branch]` | Führt mit [ultrareview](https://code.claude.com/docs/de/ultrareview.md) ein tiefgehendes Multi-Agenten-Code-Review in einer Cloud-Sandbox aus. Übergeben Sie eine PR-Referenz, um diesen Pull Request zu prüfen, oder einen Basis-Branch oder Commit, um die Vergleichsbasis zu ändern. Der bevorzugte Aufruf ist `/code-review ultra`, und `/ultrareview` ist ein Alias. Enthält 3 kostenlose Durchläufe bei Pro, Max und Ultra, danach ist [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) erforderlich |162| `/ultrareview [PR or branch]` | Führt mit [ultrareview](https://code.claude.com/docs/de/ultrareview.md) ein tiefgehendes Multi-Agenten-Code-Review in einer Cloud-Sandbox aus. Übergeben Sie eine PR-Referenz, um diesen Pull Request zu prüfen, oder einen Basis-Branch oder Commit, um die Vergleichsbasis zu ändern. Der bevorzugte Aufruf ist `/code-review ultra`, und `/ultrareview` ist ein Alias. Enthält 3 kostenlose Durchläufe bei Pro, Max und Ultra, danach ist [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) erforderlich |

163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/de/skills.md#bundled-skills).** Beschreiben Sie eine Einstellungsänderung, etwa das Erlauben eines Befehls, das Setzen einer Umgebungsvariable oder das Hinzufügen eines [Hooks](https://code.claude.com/docs/de/hooks.md), und Claude bearbeitet die passende [`settings.json`](https://code.claude.com/docs/de/settings)-Datei. Für Optionen wie Theme und Modell verwenden Sie stattdessen `/config` |163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/de/skills.md#bundled-skills).** Beschreiben Sie eine Einstellungsänderung, etwa das Erlauben eines Befehls, das Setzen einer Umgebungsvariable oder das Hinzufügen eines [Hooks](https://code.claude.com/docs/de/hooks.md), und Claude bearbeitet die passende [`settings.json`](https://code.claude.com/docs/de/settings)-Datei. Für Optionen wie Theme und Modell verwenden Sie stattdessen `/config` |

164| `/upgrade` | Öffnet die Upgrade-Seite in Ihrem Browser, um zu einem höheren Plan zu wechseln. Wenn sich der Browser nicht öffnen lässt, zeigt der Befehl eine Anmeldeaufforderung an, ohne die URL auszugeben |164| `/upgrade` | Öffnet die Upgrade-Seite in Ihrem Browser, um zu einem höheren Plan zu wechseln. Wenn sich der Browser nicht öffnen lässt, zeigt der Befehl eine Anmeldeaufforderung an, ohne die URL auszugeben |

165| `/usage` | Zeigt Sitzungskosten, Nutzungslimits des Plans und Aktivitätsstatistiken an. Bei einem Pro-, Max-, Ultra-, Team- oder Enterprise-Plan ist eine [Aufschlüsselung dessen enthalten, was auf Ihre Planlimits angerechnet wird](https://code.claude.com/docs/de/costs.md#plan-usage-breakdown). `/cost` und `/stats` sind Aliase |165| `/usage` | Zeigt Sitzungskosten, Nutzungslimits des Plans und Aktivitätsstatistiken an. Bei einem Pro-, Max-, Ultra-, Team- oder Enterprise-Plan ist eine [Aufschlüsselung dessen enthalten, was auf Ihre Planlimits angerechnet wird](https://code.claude.com/docs/de/costs.md#plan-usage-breakdown). Hinter einem Claude-Apps-Gateway, das Ausgaben erfasst, wird [Ihr Verbrauch über das Gateway](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md#usage-warnings-in-claude-code) angezeigt. `/cost` und `/stats` sind Aliase |

166| `/usage-credits` | Konfiguriert Nutzungsguthaben oder fordert es bei Ihrem Admin an, wenn Sie ein Limit erreichen. Öffnet Ihre [Abrechnungseinstellungen für Nutzungsguthaben](https://code.claude.com/docs/de/costs.md#add-usage-credits-to-your-subscription) im Browser; Team- und Enterprise-Mitglieder ohne Abrechnungszugriff senden stattdessen über die CLI eine Anfrage für Nutzungsguthaben an ihren Admin, nachdem sie in einem Dialog bestätigt haben, dass die Anfrage ihre Admins benachrichtigt. Wenn kein Browser die Abrechnungsseite öffnen kann, zum Beispiel über SSH, gibt der Befehl stattdessen die aufzurufende URL aus; dies erfordert Claude Code v2.1.205 oder höher, und frühere Versionen zeigten in diesem Fall nichts an. Früher `/extra-usage` |166| `/usage-credits` | Konfiguriert Nutzungsguthaben oder fordert es bei Ihrem Admin an, wenn Sie ein Limit erreichen. Öffnet Ihre [Abrechnungseinstellungen für Nutzungsguthaben](https://code.claude.com/docs/de/costs.md#add-usage-credits-to-your-subscription) im Browser; Team- und Enterprise-Mitglieder ohne Abrechnungszugriff senden stattdessen über die CLI eine Anfrage für Nutzungsguthaben an ihren Admin, nachdem sie in einem Dialog bestätigt haben, dass die Anfrage ihre Admins benachrichtigt. Wenn kein Browser die Abrechnungsseite öffnen kann, zum Beispiel über SSH, gibt der Befehl stattdessen die aufzurufende URL aus; dies erfordert Claude Code v2.1.205 oder höher, und frühere Versionen zeigten in diesem Fall nichts an. Früher `/extra-usage` |

167| `/verify` | **[Skill](https://code.claude.com/docs/de/skills.md#bundled-skills).** Bestätigt, dass eine Codeänderung das tut, was sie soll, indem die App Ihres Projekts gebaut und ausgeführt und das Ergebnis beobachtet wird, statt sich auf Tests oder Typprüfungen zu verlassen. Siehe [App ausführen und verifizieren](https://code.claude.com/docs/de/skills.md#run-and-verify-your-app) |167| `/verify` | **[Skill](https://code.claude.com/docs/de/skills.md#bundled-skills).** Bestätigt, dass eine Codeänderung das tut, was sie soll, indem die App Ihres Projekts gebaut und ausgeführt und das Ergebnis beobachtet wird, statt sich auf Tests oder Typprüfungen zu verlassen. Siehe [App ausführen und verifizieren](https://code.claude.com/docs/de/skills.md#run-and-verify-your-app) |

168| `/vim` | In v2.1.92 entfernt. Um zwischen den Bearbeitungsmodi Vim und Normal umzuschalten, verwenden Sie `/config` → Editor mode |168| `/vim` | In v2.1.92 entfernt. Um zwischen den Bearbeitungsmodi Vim und Normal umzuschalten, verwenden Sie `/config` → Editor mode |

costs.md +1 −1

Details

236 * Führen Sie `/usage-credits` aus, um Nutzung über die Erlaubnis hinaus anzufordern, wenn Sie [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) aktiviert haben.236 * Führen Sie `/usage-credits` aus, um Nutzung über die Erlaubnis hinaus anzufordern, wenn Sie [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) aktiviert haben.

237 * Bei Claude Code v2.1.234 oder später [warten und fahren Sie die unterbrochene Aufgabe nach dem Zurücksetzen automatisch fort](https://code.claude.com/docs/de/interactive-mode.md#wait-for-a-usage-limit-to-reset); dieser Abschnitt listet auf, wann Claude Code das Warten von selbst startet und wann der Entwickler es aus `/rate-limit-options` auswählt. Um für Ihre Flotte zu steuern, ob Claude Code das Warten von selbst startet, setzen Sie [`autoContinueAtUsageLimit`](https://code.claude.com/docs/de/settings-reference#autocontinueatusagelimit) in [verwalteten Einstellungen](https://code.claude.com/docs/de/settings.md#settings-precedence).237 * Bei Claude Code v2.1.234 oder später [warten und fahren Sie die unterbrochene Aufgabe nach dem Zurücksetzen automatisch fort](https://code.claude.com/docs/de/interactive-mode.md#wait-for-a-usage-limit-to-reset); dieser Abschnitt listet auf, wann Claude Code das Warten von selbst startet und wann der Entwickler es aus `/rate-limit-options` auswählt. Um für Ihre Flotte zu steuern, ob Claude Code das Warten von selbst startet, setzen Sie [`autoContinueAtUsageLimit`](https://code.claude.com/docs/de/settings-reference#autocontinueatusagelimit) in [verwalteten Einstellungen](https://code.claude.com/docs/de/settings.md#settings-precedence).

238* **„Sie haben Ihr individuelles Ausgabenlimit erreicht“, „monatliches Ausgabenlimit der Organisation“ oder „gemeinsames Budget des Teams“**: Die Anfrage des Entwicklers würde über Nutzungsguthaben abgerechnet, und dieses Guthaben hat ein Ausgabenlimit erreicht, das Sie festgelegt haben. Um dem Entwickler zu ermöglichen, fortzufahren, gehen Sie zu [**Organisationseinstellungen > Nutzung**](https://claude.ai/admin-settings/usage) und erhöhen Sie das Limit, das die Nachricht nennt. Wenn die Nachricht auch eine Plan-Zurücksetzzeit nennt, kann der Entwickler stattdessen bis dahin warten. Siehe [die Fehlerreferenz](https://code.claude.com/docs/de/errors.md#youve-hit-your-monthly-spend-limit) für jede Variante.238* **„Sie haben Ihr individuelles Ausgabenlimit erreicht“, „monatliches Ausgabenlimit der Organisation“ oder „gemeinsames Budget des Teams“**: Die Anfrage des Entwicklers würde über Nutzungsguthaben abgerechnet, und dieses Guthaben hat ein Ausgabenlimit erreicht, das Sie festgelegt haben. Um dem Entwickler zu ermöglichen, fortzufahren, gehen Sie zu [**Organisationseinstellungen > Nutzung**](https://claude.ai/admin-settings/usage) und erhöhen Sie das Limit, das die Nachricht nennt. Wenn die Nachricht auch eine Plan-Zurücksetzzeit nennt, kann der Entwickler stattdessen bis dahin warten. Siehe [die Fehlerreferenz](https://code.claude.com/docs/de/errors.md#youve-hit-your-monthly-spend-limit) für jede Variante.

239* **Eine Ausgabenlimit-Nachricht von einem [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway)**: Der Entwickler hat eine Ausgabenbegrenzung überschritten, die Sie auf Ihrem selbst gehosteten Gateway festgelegt haben, und das Gateway blockiert seine Anfragen, bis sich der Zeitraum zurückgesetzt oder Sie die Begrenzung erhöhen. Siehe [Gateway-Ausgabenlimits](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) für Begrenzungen, Zurücksetzzeitpläne und die Nachricht, die der Entwickler sieht.239* **Eine Ausgabenlimit-Nachricht von einem [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway)**: Der Entwickler hat eine Ausgabenbegrenzung überschritten, die Sie auf Ihrem selbst gehosteten Gateway festgelegt haben. Das Gateway blockiert seine Anfragen, bis Sie die Begrenzung erhöhen oder bis sich die Begrenzung zurücksetzt, sofern sie über \$0 liegt. Siehe [Gateway-Ausgabenlimits](https://code.claude.com/docs/de/claude-apps-gateway-spend-limits.md) für Begrenzungen, Zurücksetzzeitpläne und die Nachricht, die der Entwickler sieht.

240* **Eine Kontext- oder Auto-Compact-Warnung**: Kein Nutzungslimit. Das Gespräch ist der [Auto-Compact-Fenster](https://code.claude.com/docs/de/model-config.md#set-the-auto-compact-window) der Sitzung nahe gewachsen, der Schwellenwert, bei dem Claude Code ältere Verlauf zusammenfasst, um Platz freizugeben. Verweisen Sie den Entwickler auf [Token-Nutzung reduzieren](#reduce-token-usage).240* **Eine Kontext- oder Auto-Compact-Warnung**: Kein Nutzungslimit. Das Gespräch ist der [Auto-Compact-Fenster](https://code.claude.com/docs/de/model-config.md#set-the-auto-compact-window) der Sitzung nahe gewachsen, der Schwellenwert, bei dem Claude Code ältere Verlauf zusammenfasst, um Platz freizugeben. Verweisen Sie den Entwickler auf [Token-Nutzung reduzieren](#reduce-token-usage).

241* **Unerwartet hohe Ausgaben bei einem API- oder Cloud-Anbieter-Plan**: Normalerweise zurückzuführen auf lange Sitzungen, die nie gelöscht wurden, oder auf Opus, das als Standard-Modell belassen wurde. Die Gewohnheiten mit der höchsten Auswirkung zum Teilen sind das Löschen zwischen nicht verwandten Aufgaben und das Anpassen des Modells an die Aufgabe, beide in [Token-Nutzung reduzieren](#reduce-token-usage) behandelt.241* **Unerwartet hohe Ausgaben bei einem API- oder Cloud-Anbieter-Plan**: Normalerweise zurückzuführen auf lange Sitzungen, die nie gelöscht wurden, oder auf Opus, das als Standard-Modell belassen wurde. Die Gewohnheiten mit der höchsten Auswirkung zum Teilen sind das Löschen zwischen nicht verwandten Aufgaben und das Anpassen des Modells an die Aufgabe, beide in [Token-Nutzung reduzieren](#reduce-token-usage) behandelt.

242 242

env-vars.md +2 −1

Details

365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Setzen Sie `5m` oder `1h`, die einzigen Werte, die Claude Code akzeptiert, um die [Prompt-Cache-TTL](https://code.claude.com/docs/de/prompt-caching.md#cache-lifetime) für die Hauptkonversation zu wählen: Ihre interaktiven, `-p`- und SDK-Turns sowie die Hilfsprozesse, die inline mit ihnen laufen. Hat Vorrang vor der Einstellung `promptCacheTtl` und vor `ENABLE_PROMPT_CACHING_1H`, und `FORCE_PROMPT_CACHING_5M` überschreibt sie. Die API berechnet 1-Stunden-Cache-Schreibvorgänge zu einem höheren Tarif. Erfordert Claude Code v2.1.242 oder höher |365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Setzen Sie `5m` oder `1h`, die einzigen Werte, die Claude Code akzeptiert, um die [Prompt-Cache-TTL](https://code.claude.com/docs/de/prompt-caching.md#cache-lifetime) für die Hauptkonversation zu wählen: Ihre interaktiven, `-p`- und SDK-Turns sowie die Hilfsprozesse, die inline mit ihnen laufen. Hat Vorrang vor der Einstellung `promptCacheTtl` und vor `ENABLE_PROMPT_CACHING_1H`, und `FORCE_PROMPT_CACHING_5M` überschreibt sie. Die API berechnet 1-Stunden-Cache-Schreibvorgänge zu einem höheren Tarif. Erfordert Claude Code v2.1.242 oder höher |

366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Auf `1` setzen, um den W3C-Trace-Kontext weiterzugeben, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy zeigt. Die Weitergabe umfasst den `traceparent`-Header bei Modell- und HTTP-MCP-Anfragen sowie die Umgebungsvariable `TRACEPARENT` für Bash-, PowerShell- und Hook-Unterprozesse. Standardmäßig ist die Weitergabe nur bei direkter Verbindung zur Anthropic API aktiviert. In v2.1.152 hinzugefügt. Siehe [Traces (Beta)](https://code.claude.com/docs/de/monitoring-usage.md#traces-beta) |366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Auf `1` setzen, um den W3C-Trace-Kontext weiterzugeben, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy zeigt. Die Weitergabe umfasst den `traceparent`-Header bei Modell- und HTTP-MCP-Anfragen sowie die Umgebungsvariable `TRACEPARENT` für Bash-, PowerShell- und Hook-Unterprozesse. Standardmäßig ist die Weitergabe nur bei direkter Verbindung zur Anthropic API aktiviert. In v2.1.152 hinzugefügt. Siehe [Traces (Beta)](https://code.claude.com/docs/de/monitoring-usage.md#traces-beta) |

367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Routing zum Modellanbieter in dessen Namen verwalten. Wenn gesetzt, ignoriert Claude Code Variablen für Anbieterauswahl, Endpunkt und Authentifizierung wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Claude Code ignoriert außerdem Schlüssel zur Modellauswahl wie `model`, `fallbackModel` und `modelOverrides` in [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md), unabhängig davon, welche verwaltete Quelle sie bereitstellt, sodass die Modellkonfiguration des Hosts Vorrang vor einer veralteten verwalteten Modellfestlegung hat. Claude Code ignoriert außerdem Variablen zur Modellauswahl wie `ANTHROPIC_MODEL` und die `ANTHROPIC_DEFAULT_*_MODEL`-Familie in einem verwalteten `env`-Block; eine [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Allowlist in verwalteten Einstellungen gilt weiterhin, sofern der Host keine eigene bereitstellt. Claude Code überspringt außerdem die automatische Telemetrie-Abmeldung, die es sonst bei Drittanbietern wie Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry anwendet, sodass die Telemetrie der standardmäßigen Abmeldung über `DISABLE_TELEMETRY` folgt. Siehe [Standardverhalten nach API-Anbieter](https://code.claude.com/docs/de/data-usage.md#default-behaviors-by-api-provider) |367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Routing zum Modellanbieter in dessen Namen verwalten. Wenn gesetzt, ignoriert Claude Code Variablen für Anbieterauswahl, Endpunkt und Authentifizierung wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Claude Code ignoriert außerdem Schlüssel zur Modellauswahl wie `model`, `fallbackModel` und `modelOverrides` in [verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md), unabhängig davon, welche verwaltete Quelle sie bereitstellt, sodass die Modellkonfiguration des Hosts Vorrang vor einer veralteten verwalteten Modellfestlegung hat. Claude Code ignoriert außerdem Variablen zur Modellauswahl wie `ANTHROPIC_MODEL` und die `ANTHROPIC_DEFAULT_*_MODEL`-Familie in einem verwalteten `env`-Block; eine [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Allowlist in verwalteten Einstellungen gilt weiterhin, sofern der Host keine eigene bereitstellt. Claude Code überspringt außerdem die automatische Telemetrie-Abmeldung, die es sonst bei Drittanbietern wie Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry anwendet, sodass die Telemetrie der standardmäßigen Abmeldung über `DISABLE_TELEMETRY` folgt. Siehe [Standardverhalten nach API-Anbieter](https://code.claude.com/docs/de/data-usage.md#default-behaviors-by-api-provider) |

368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Auf `1` setzen, damit der Proxy statt des Aufrufers die DNS-Auflösung durchführt. Opt-in für Umgebungen, in denen der Proxy die Auflösung von Hostnamen übernehmen soll |368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Auf `1` setzen, damit der Proxy statt des Aufrufers die DNS-Auflösung durchführt. Opt-in für Umgebungen, in denen der Proxy die Auflösung von Hostnamen übernehmen soll. Wenn `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` gesetzt ist, setzen Sie dies in der Umgebung des Prozesses, der Claude Code startet |

369| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) läuft. Lesen Sie die Variable in einem Hook oder Setup-Skript aus, um zu erkennen, ob Sie sich in einer Cloud-Sitzung befinden |369| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) läuft. Lesen Sie die Variable in einem Hook oder Setup-Skript aus, um zu erkennen, ob Sie sich in einer Cloud-Sitzung befinden |

370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird in [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md) automatisch auf die ID der aktuellen Sitzung gesetzt. Lesen Sie die Variable aus, um einen Link zurück zum Sitzungstranskript zu erstellen. Siehe [Ausgabe mit der Sitzung verknüpfen](https://code.claude.com/docs/de/cloud-environments.md#link-output-back-to-the-session) |370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird in [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md) automatisch auf die ID der aktuellen Sitzung gesetzt. Lesen Sie die Variable aus, um einen Link zurück zum Sitzungstranskript zu erstellen. Siehe [Ausgabe mit der Sitzung verknüpfen](https://code.claude.com/docs/de/cloud-environments.md#link-output-back-to-the-session) |

371| `CLAUDE_CODE_RESTRICTED` | Auf `1` setzen, um die Sitzung im eingeschränkten Modus zu starten, genau wie bei Übergabe von [`--restricted`](https://code.claude.com/docs/de/cli-reference#cli-flags). Claude Code ignoriert diese Variable im `env`-Block einer Einstellungsdatei. Erfordert Claude Code v2.1.248 oder höher |371| `CLAUDE_CODE_RESTRICTED` | Auf `1` setzen, um die Sitzung im eingeschränkten Modus zu starten, genau wie bei Übergabe von [`--restricted`](https://code.claude.com/docs/de/cli-reference#cli-flags). Claude Code ignoriert diese Variable im `env`-Block einer Einstellungsdatei. Erfordert Claude Code v2.1.248 oder höher |

529| `VERTEX_REGION_CLAUDE_5_SONNET` | Überschreibt die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |529| `VERTEX_REGION_CLAUDE_5_SONNET` | Überschreibt die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |

530| `VERTEX_REGION_CLAUDE_FABLE_5` | Überschreibt die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |530| `VERTEX_REGION_CLAUDE_FABLE_5` | Überschreibt die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |

531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Überschreibt die Region für Claude Fable 5.1 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.257 |531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Überschreibt die Region für Claude Fable 5.1 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.257 |

532| `VERTEX_REGION_CLAUDE_FABLE_5_2` | Region für Claude Fable 5.2 bei Verwendung von Google Cloud's Agent Platform überschreiben. Hinzugefügt in v2.1.321 |

532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreibt die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |533| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreibt die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |

533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Überschreibt die Region für Claude Haiku 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.293 |534| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Überschreibt die Region für Claude Haiku 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.293 |

534 535

errors.md +92 −15

Details

52| `Credit balance is too low` | [Nutzungslimits](#credit-balance-is-too-low) |52| `Credit balance is too low` | [Nutzungslimits](#credit-balance-is-too-low) |

53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Nutzungslimits](#youve-hit-your-monthly-spend-limit) |53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Nutzungslimits](#youve-hit-your-monthly-spend-limit) |

54| `Could not update your spend limit` | [Nutzungslimits](#could-not-update-your-spend-limit) |54| `Could not update your spend limit` | [Nutzungslimits](#could-not-update-your-spend-limit) |

56| `Not logged in · Please run /login` | [Authentifizierung](#not-logged-in) |56| `Not logged in · Please run /login` | [Authentifizierung](#not-logged-in) |

57| `Couldn't save your login` | [Authentifizierung](#couldnt-save-your-login) |57| `Couldn't save your login` | [Authentifizierung](#couldnt-save-your-login) |

58| `Sign in again to take your previous account or API key off the config file.` | [Authentifizierung](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |58| `Sign in again to take your previous account or API key off the config file.` | [Authentifizierung](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |

336| `MCP server "<name>" connection closed before the tool call was answered` | [Werkzeugfehler](#connection-closed-before-the-tool-call-was-answered) |336| `MCP server "<name>" connection closed before the tool call was answered` | [Werkzeugfehler](#connection-closed-before-the-tool-call-was-answered) |

338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Werkzeugfehler](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Werkzeugfehler](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |

339| `Permission prompt tool returned an invalid result` | [Tool-Fehler](#permission-prompt-tool-returned-an-invalid-result) |

340| `File is covered by a Read deny rule in your permission settings` | [Werkzeugfehler](#file-is-covered-by-a-read-deny-rule) |341| `File is covered by a Read deny rule in your permission settings` | [Werkzeugfehler](#file-is-covered-by-a-read-deny-rule) |

341| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Tool-Fehler](#setting-blocks-writes-outside-the-working-directories) |342| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Tool-Fehler](#setting-blocks-writes-outside-the-working-directories) |

420| `The Claude Code program for this computer, the <build> build, could not be found` | [Wrapper- und IDE-Fehler](#the-claude-code-program-for-this-computer-could-not-be-found) |421| `The Claude Code program for this computer, the <build> build, could not be found` | [Wrapper- und IDE-Fehler](#the-claude-code-program-for-this-computer-could-not-be-found) |

422| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind-Warnungen und Fehler](#no-files-were-restored) |423| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind-Warnungen und Fehler](#no-files-were-restored) |

424| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | Wählen Sie in [`/rewind`](https://code.claude.com/docs/de/checkpointing) erneut denselben Punkt aus. Wenn Sie Code kurz nach [`/branch`](https://code.claude.com/docs/de/sessions#branch-a-session) wiederherstellen, kopiert Claude Code die Dateisicherungen möglicherweise noch in die neue Sitzung. |

424| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Warnungen zum Speichern von Sitzungen](#transcript-saving-is-off-skip-prompt-history) |426| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Warnungen zum Speichern von Sitzungen](#transcript-saving-is-off-skip-prompt-history) |

425| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Warnungen zum Speichern von Sitzungen](#transcript-saving-is-off-child-session-marker) |427| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Warnungen zum Speichern von Sitzungen](#transcript-saving-is-off-child-session-marker) |

431| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Konfigurationswarnungen](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |433| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Konfigurationswarnungen](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

432| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Konfigurationswarnungen](#skill-or-command-name-refused) |434| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Konfigurationswarnungen](#skill-or-command-name-refused) |

433| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Konfigurationswarnungen](#workspace-has-not-been-trusted) |435| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Konfigurationswarnungen](#workspace-has-not-been-trusted) |

436| `Two Claude Code config files exist: this run uses <path>, not <path>` | [Konfigurationswarnungen](#two-claude-code-config-files-exist) |

434| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Konfigurationswarnungen](#make-this-change-again-later) |437| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Konfigurationswarnungen](#make-this-change-again-later) |

435| `is a network path, which cannot be added as a working directory` | [Konfigurationswarnungen](#working-directory-is-a-network-path) |438| `is a network path, which cannot be added as a working directory` | [Konfigurationswarnungen](#working-directory-is-a-network-path) |

436| `Remote managed settings failed to load (<cause>)` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |439| `Remote managed settings failed to load (<cause>)` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |

468| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/de/model-config#claude_code_auto_compact_window-values) |471| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Werte und Warnungen für `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/de/model-config#claude_code_auto_compact_window-values) |

469| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |472| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

470| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |473| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Kontextfenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](https://code.claude.com/docs/de/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

474| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [Einen falsch geschriebenen Modellnamen korrigieren](https://code.claude.com/docs/de/model-config.md#fix-a-mistyped-model-name) |

472| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Konfigurationswarnungen](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |476| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Konfigurationswarnungen](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |

473| `Sandbox mask files left behind at write-deny paths` | [Konfigurationswarnungen](#stale-sandbox-mask-files-left-by-a-killed-session) |477| `Sandbox mask files left behind at write-deny paths` | [Konfigurationswarnungen](#stale-sandbox-mask-files-left-by-a-killed-session) |

909Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change913Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

910```914```

911 915

912Die Meldungen nennen das Fable-Modell der Sitzung, daher lauten sie auf Fable 5 `continuing on Fable 5` und `Fable 5 now uses usage credits`. Vor v2.1.257 begann die erste Meldung mit `Fable 5 limit reached`.916Die Meldungen nennen das Fable-Modell der Sitzung, daher lauten sie auf Fable 5.2 `continuing on Fable 5.2` und `Fable 5.2 now uses usage credits`. Vor v2.1.257 begann die erste Meldung mit `Fable 5 limit reached`.

913 917

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

915 919

983 987

984### Spend limit reached988### Spend limit reached

985 989

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

987 991

988```text theme={null}992```text theme={null}

989spend limit reached (daily; resets 2026-08-09 00:00 UTC)993spend limit reached · resets Dec 1

990```994```

991 995

992Die Meldung nennt den Zeitraum der Obergrenze und den Zurücksetzzeitpunkt, und wenn der Betreiber eine `blocked_message` konfiguriert hat, folgen seine Anweisungen. Vor v2.1.225 lautete die Meldung nur `spend limit reached`; ein Gateway auf einer älteren Version sendet immer noch diese kürzere Form.996Prüfen Sie, ob die Meldung ein Datum enthält:

997

998* **Mit Datum**: Die Obergrenze wird an diesem Datum um 00:00 UTC zurückgesetzt

999* **Ohne Datum**: Ihre Obergrenze beträgt \$0, oder Ihr Gateway läuft auf einer Version vor v2.1.225

1000

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

1002

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

993 1004

994**Was zu tun ist:**1005**Was zu tun ist:**

995 1006

996* Warten Sie auf den Zurücksetzzeitpunkt, den die Meldung nennt, oder folgen Sie den Anweisungen des Betreibers, wenn die Meldung diese enthält1007* Wenn die Meldung ein Datum enthält, warten Sie auf das Zurücksetzen, oder folgen Sie dem Hinweis des Betreibers, wenn die Meldung einen enthält

997* Bitten Sie Ihren Gateway-Betreiber, die Obergrenze zu erhöhen, wenn Sie sie regelmäßig erreichen1008* Bitten Sie Ihren Gateway-Betreiber, die Obergrenze zu erhöhen, wenn die Meldung kein Datum enthält, wenn Sie nach dem Datum weiterhin blockiert sind oder wenn Sie die Obergrenze regelmäßig erreichen

1009

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

1011

1012```text theme={null}

1013This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.

1014```

998 1015

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

1000 1017

2287 2304

2288### Couldn't send feedback2305### Couldn't send feedback

2289 2306

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

2291 2308

2292Das zweite dieser beiden Beispiele ist die Ablehnung durch eine Organisation:2309Das zweite Beispiel ist die Ablehnung durch eine Organisation:

2293 2310

2294```text wrap theme={null}2311```text wrap theme={null}

2295Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.2312Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

2300**Was zu tun ist:**2317**Was zu tun ist:**

2301 2318

2302* **Nicht angemeldet**: Die Meldung wird mit `: not signed in. Run /login, then retry.` fortgesetzt. Führen Sie `/login` aus und senden Sie dann erneut2319* **Nicht angemeldet**: Die Meldung wird mit `: not signed in. Run /login, then retry.` fortgesetzt. Führen Sie `/login` aus und senden Sie dann erneut

2303* **Ablehnung durch Ihre Organisation**: zum Beispiel `: Feedback has not been enabled for your organization.` oder `: Feedback collection is not available for organizations with custom data retention policies.` Wenn die Meldung `To report a bug, open an issue` hinzufügt, tun Sie dies unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Ein Entwurf in der Warteschlange bleibt in der Warteschlange, und Sie können [ihn verwerfen](https://code.claude.com/docs/de/tools-reference.md#discard-or-keep-a-draft)2320* **Ablehnung durch Ihre Organisation**: zum Beispiel `: Feedback has not been enabled for your organization.` oder `: Feedback collection is not available for organizations with custom data retention policies.` Wenn die Meldung `To report a bug, open an issue` hinzufügt, tun Sie dies unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). `/feedback` kann danach sieben Tage lang antworten, dass es [durch die Richtlinie Ihrer Organisation deaktiviert ist](#feedback-is-disabled-by-your-organizations-policy). Ein Entwurf in der Warteschlange bleibt in der Warteschlange und [läuft trotzdem planmäßig ab](https://code.claude.com/docs/de/tools-reference.md#discard-or-keep-a-draft)

2304* **Abgelehnte Anmeldedaten**: Die Meldung wird mit `: the sign-in this session uses is not allowed to send feedback` oder `: the server did not accept the credentials this session uses` fortgesetzt. Führen Sie `/status` in der Claude-Code-Eingabe aus, um zu sehen, welche Anmeldung, welches Token oder welchen API-Schlüssel diese Sitzung sendet2321* **Abgelehnte Anmeldedaten**: Die Meldung wird mit `: the sign-in this session uses is not allowed to send feedback` oder `: the server did not accept the credentials this session uses` fortgesetzt. Führen Sie `/status` in der Claude-Code-Eingabe aus, um zu sehen, welche Anmeldung, welches Token oder welchen API-Schlüssel diese Sitzung sendet

2305* **`(request timed out)` oder `(couldn't reach the service)` direkt nach `Couldn't send feedback`**: Senden Sie den Bericht oder den Entwurf in der Warteschlange erneut. Der Dialog behält Ihren Text, und die Meldung eines Entwurfs in der Warteschlange lautet `The draft is still queued.` Wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api). Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein2322* **`(request timed out)` oder `(couldn't reach the service)` direkt nach `Couldn't send feedback`**: Senden Sie den Bericht oder den Entwurf in der Warteschlange erneut. Der Dialog behält Ihren Text, und die Meldung eines Entwurfs in der Warteschlange lautet `The draft is still queued.` Wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api). Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein

2306* **`(server returned <status>)` oder kein Grund direkt nach `Couldn't send feedback`**: Der Status ist der Antwortcode des Dienstes. Die eigene Meldung des Dienstes folgt darauf, wenn eine gesendet wurde, wie in `(server returned 403: Access Forbidden)`. Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein2323* **`(server returned <status>)` oder kein Grund direkt nach `Couldn't send feedback`**: Der Status ist der Antwortcode des Dienstes. Die eigene Meldung des Dienstes folgt darauf, wenn eine gesendet wurde, wie in `(server returned 403: Access Forbidden)`. Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein

3431* **`Error: Workspace not trusted. <folder> is your home directory`**: Da das Vertrauen für Ihr Home-Verzeichnis nie gespeichert wird, hilft es nicht, dort zuerst `claude` auszuführen. Führen Sie `claude ultrareview` stattdessen aus einem Projektverzeichnis aus, nachdem Sie dort einmal `claude` ausgeführt und den Vertrauensdialog akzeptiert haben, oder hängen Sie `--trust-workspace` an.3448* **`Error: Workspace not trusted. <folder> is your home directory`**: Da das Vertrauen für Ihr Home-Verzeichnis nie gespeichert wird, hilft es nicht, dort zuerst `claude` auszuführen. Führen Sie `claude ultrareview` stattdessen aus einem Projektverzeichnis aus, nachdem Sie dort einmal `claude` ausgeführt und den Vertrauensdialog akzeptiert haben, oder hängen Sie `--trust-workspace` an.

3432* **`No answer in time.` gefolgt von `Error: Workspace not trusted`**: Die Frage `Trust <folder>? [y/N]` blieb 5 Minuten lang unbeantwortet. Führen Sie `claude ultrareview` erneut aus und beantworten Sie sie.3449* **`No answer in time.` gefolgt von `Error: Workspace not trusted`**: Die Frage `Trust <folder>? [y/N]` blieb 5 Minuten lang unbeantwortet. Führen Sie `claude ultrareview` erneut aus und beantworten Sie sie.

3433* **`Ultrareview did not start: <folder> is not trusted`**: Sie haben bei der Frage `Trust <folder>? [y/N]` abgelehnt, zum Beispiel indem Sie `n` geantwortet oder Enter gedrückt haben. Um das Review zu starten, führen Sie `claude ultrareview` erneut aus und antworten Sie `y`.3450* **`Ultrareview did not start: <folder> is not trusted`**: Sie haben bei der Frage `Trust <folder>? [y/N]` abgelehnt, zum Beispiel indem Sie `n` geantwortet oder Enter gedrückt haben. Um das Review zu starten, führen Sie `claude ultrareview` erneut aus und antworten Sie `y`.

3434* **``Ultrareview did not start: `--trust-workspace` takes no value``**: Auf `--trust-workspace` folgt etwas anderes als ein Flag, etwa eine PR-Nummer oder `false`. Wenn Sie dem Ordner nicht vertrauen, lassen Sie das Flag weg. Um ihm für diesen Lauf zu vertrauen, setzen Sie die PR-Nummer oder den Basis-Branch vor das Flag: `claude ultrareview 1234 --trust-workspace`.3451* **``Ultrareview did not start: `--trust-workspace` takes no value``**: Auf `--trust-workspace` folgt etwas anderes als ein Flag, etwa eine PR-Nummer oder `false`. Wenn Sie dem Ordner nicht vertrauen, lassen Sie das Flag weg. Um ihm für diese Ausführung zu vertrauen, setzen Sie die PR-Nummer oder den Basis-Branch vor das Flag: `claude ultrareview 1234 --trust-workspace`.

3435 3452

3436Vor v2.1.309 akzeptierte `claude ultrareview` kein `--trust-workspace`.3453Vor v2.1.309 akzeptierte `claude ultrareview` kein `--trust-workspace`.

3437 3454

3724 3741

3725Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:3742Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:

3726 3743

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

3728* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: Das Frontmatter des Skills verlangt Bash auf einem Rechner ohne Bash. Installieren Sie Git for Windows oder ändern Sie das Frontmatter in `shell: powershell`. Siehe [Wie eingefügte Befehle ausgeführt werden](https://code.claude.com/docs/de/skills.md#how-injected-commands-run)3745* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: Das Frontmatter des Skills verlangt Bash auf einem Rechner ohne Bash. Installieren Sie Git for Windows oder ändern Sie das Frontmatter in `shell: powershell`. Siehe [Wie eingefügte Befehle ausgeführt werden](https://code.claude.com/docs/de/skills.md#how-injected-commands-run)

3729 3746

3730**Vorgehensweise:**3747**Vorgehensweise:**

3878 3895

3879* **Sie haben keinen Basis-Branch übergeben**: Claude Code hat mit dem Standard-Branch des Repositorys verglichen und schlägt vor, Ihre Basis explizit zu übergeben, wie im obigen Beispiel3896* **Sie haben keinen Basis-Branch übergeben**: Claude Code hat mit dem Standard-Branch des Repositorys verglichen und schlägt vor, Ihre Basis explizit zu übergeben, wie im obigen Beispiel

3880* **Sie haben einen Basis-Branch übergeben, der bereits in Ihrem Klon vorhanden war**: Der Hinweis lautet ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3897* **Sie haben einen Basis-Branch übergeben, der bereits in Ihrem Klon vorhanden war**: Der Hinweis lautet ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3881* **Sie haben einen Basis-Branch übergeben, der nicht in Ihrem Klon vorhanden war**: Claude Code hat ihn vor dem Vergleich von origin abgerufen. Der Hinweis lautet ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; wenn Claude Code nicht feststellen kann, ob Ihr Klon shallow ist, schlägt es stattdessen `git fetch --unshallow origin` vor. Vor v2.1.221 schlug der Hinweis für jeden abgerufenen Basis-Branch `git fetch --unshallow origin` vor, und bei einem vollständigen Klon schlägt dieser Befehl mit `fatal: --unshallow on a complete repository does not make sense` fehl.3898* **Sie haben einen Basis-Branch übergeben, der nicht in Ihrem Klon vorhanden war**: Claude Code hat ihn vor dem Vergleich von origin abgerufen. Der Hinweis lautet ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; wenn Claude Code nicht feststellen kann, ob Ihr Klon flach (shallow) ist, schlägt es stattdessen `git fetch --unshallow origin` vor. Vor v2.1.221 schlug der Hinweis für jeden abgerufenen Basis-Branch `git fetch --unshallow origin` vor, und bei einem vollständigen Klon schlägt dieser Befehl mit `fatal: --unshallow on a complete repository does not make sense` fehl.

3882 3899

3883**Vorgehensweise:**3900**Vorgehensweise:**

3884 3901

4227 4244

4228### /feedback is disabled by your organization's policy4245### /feedback is disabled by your organization's policy

4229 4246

4230Diese Meldung bedeutet, dass die Richtlinie Ihrer Organisation kein Produktfeedback aus Claude Code zulässt, daher öffnen `/feedback`, `/bug` und `/share` den Feedback-Dialog nicht. Die Meldung nennt den Befehl, den Sie in der Eingabeaufforderung von Claude Code eingegeben haben:4247Diese Meldung bedeutet, dass Produktfeedback ausgeschaltet ist, sodass der eingegebene Befehl den Feedback-Dialog nicht öffnet. Sowohl eine Richtlinie Ihrer Organisation als auch eine frühere Ablehnung erzeugen die Meldung:

4248

4249* **Organisationsrichtlinie**: Die Richtlinie Ihrer Organisation erlaubt kein Produktfeedback aus Claude Code. `/feedback`, `/bug` und `/share` antworten alle mit der Meldung.

4250* **Frühere Ablehnung**: Der Feedback-Dienst hat einen von Ihnen gesendeten Bericht abgelehnt, zum Beispiel mit [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) `/feedback` und `/bug` können dann mit der Meldung antworten. Das gilt auf diesem Rechner sieben Tage ab dieser Ablehnung. Dies betrifft jeden Plan, einschließlich Pro und Max.

4251

4252Die Meldung nennt den Befehl, den Sie an der Claude Code-Eingabeaufforderung eingegeben haben:

4231 4253

4232```text wrap theme={null}4254```text wrap theme={null}

4233/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.4255/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.

4238**Was Sie tun können:**4260**Was Sie tun können:**

4239 4261

4240* Um einen Fehler zu melden, eröffnen Sie ein Issue unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Issues dort sind für alle lesbar, lassen Sie daher Code, Transkripte und alles andere Vertrauliche weg.4262* Um einen Fehler zu melden, eröffnen Sie ein Issue unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Issues dort sind für alle lesbar, lassen Sie daher Code, Transkripte und alles andere Vertrauliche weg.

4263* Warten Sie nach einer früheren Ablehnung, bis die sieben Tage vergangen sind, und senden Sie dann erneut einen Bericht, um zu sehen, ob der Dienst ihn weiterhin ablehnt

4264

4265Vor v2.1.319 erzeugte eine frühere Ablehnung diese Meldung nicht.

4241 4266

4242Vor v2.1.302 lautete die vollständige Meldung `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`4267Vor v2.1.302 lautete die vollständige Meldung `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

4243 4268

4654* Um einer Antwort mehr Zeit zu geben, setzen Sie im Konfigurationseintrag des Servers einen längeren [`timeout`](https://code.claude.com/docs/de/mcp#time-limits-on-mcp-tool-calls) in Millisekunden, etwa `"timeout": 600000` für 10 Minuten4679* Um einer Antwort mehr Zeit zu geben, setzen Sie im Konfigurationseintrag des Servers einen längeren [`timeout`](https://code.claude.com/docs/de/mcp#time-limits-on-mcp-tool-calls) in Millisekunden, etwa `"timeout": 600000` für 10 Minuten

4655* Führen Sie die Aufgabe stattdessen in einer interaktiven Sitzung aus und beantworten Sie den [Dialog](https://code.claude.com/docs/de/mcp.md#respond-to-mcp-elicitation-requests) des Servers selbst4680* Führen Sie die Aufgabe stattdessen in einer interaktiven Sitzung aus und beantworten Sie den [Dialog](https://code.claude.com/docs/de/mcp.md#respond-to-mcp-elicitation-requests) des Servers selbst

4656 4681

4682### Permission prompt tool returned an invalid result

4683

4684Das Tool, das Sie an [`--permission-prompt-tool`](https://code.claude.com/docs/de/cli-reference#cli-flags) übergeben haben, hat eine Antwort zurückgegeben, die Claude Code nicht lesen konnte, daher wurde der Tool-Aufruf, der darauf wartete, nicht ausgeführt, selbst wenn die Antwort den Aufruf erlaubte:

4685

4686```text wrap theme={null}

4687Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.

4688```

4689

4690**Was zu tun ist:**

4691

4692* Geben Sie einen einzigen Textblock zurück, dessen Text `{"behavior": "allow"}` oder `{"behavior": "deny", "message": "<reason>"}` lautet. Um die Eingabe zu ändern, fügen Sie `updatedInput` zum `allow`-Objekt hinzu. Von v2.1.86 bis v2.1.206 benötigte ein `allow` den Eintrag `"updatedInput": {}`, um die Eingabe beizubehalten.

4693* Geben Sie kein [`structuredContent`](https://code.claude.com/docs/de/agent-sdk/custom-tools#return-structured-data) zurück, das Ihr MCP SDK möglicherweise selbstständig hinzufügt. Registrieren Sie das Tool zum Beispiel:

4694 * **`FastMCP` oder `MCPServer` aus `mcp.server`**: mit `structured_output=False`

4695 * **`FastMCP` aus `fastmcp`**: mit `output_schema=None`, und geben Sie einen String zurück

4696 * **MCP TypeScript SDK**: ohne `outputSchema`

4697* Wenn der Fehler nur bei Eingaben von etwa 40 KB oder mehr auftritt, kopieren Sie die Eingabe nicht in `updatedInput` oder in die `message` einer Ablehnung. Um eine so große Eingabe zu ändern, [erhöhen Sie das Ausgabelimit Ihres Prompt-Tools](https://code.claude.com/docs/de/mcp.md#raise-the-limit-for-a-specific-tool).

4698

4657### Agent würde mit null Tools erzeugt4699### Agent würde mit null Tools erzeugt

4658 4700

4659Jeder Eintrag in der [`tools`-Liste](https://code.claude.com/docs/de/sub-agents#supported-frontmatter-fields) des Subagenten konnte mit keinem verwendbaren Tool abgeglichen werden, daher weigerte sich Claude Code, den Subagenten zu starten: Ohne Tools konnte er nicht handeln. Die Nachricht gruppiert Ihre Einträge nach dem, was schiefgelaufen ist:4701Jeder Eintrag in der [`tools`-Liste](https://code.claude.com/docs/de/sub-agents#supported-frontmatter-fields) des Subagenten konnte mit keinem verwendbaren Tool abgeglichen werden, daher weigerte sich Claude Code, den Subagenten zu starten: Ohne Tools konnte er nicht handeln. Die Nachricht gruppiert Ihre Einträge nach dem, was schiefgelaufen ist:

6432 6474

6433Vor v2.1.257 kennzeichnete `claude doctor` diese Dateien nicht; frühere Versionen hinterlassen die gleichen Platzhalter, wenn eine Sitzung zwangsweise beendet wird.6475Vor v2.1.257 kennzeichnete `claude doctor` diese Dateien nicht; frühere Versionen hinterlassen die gleichen Platzhalter, wenn eine Sitzung zwangsweise beendet wird.

6434 6476

6477### Two Claude Code config files exist

6478

6479Claude Code verwendet die erste Datei, die diese Meldung nennt, daher ist der Inhalt der zweiten Datei nicht wirksam. Die erste ist `.config.json`, ein älterer Name für [`.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json). Die Meldung enthält eine Prüfung, mit der Sie feststellen können, welche Datei Ihre Konfiguration enthält:

6480

6481```text wrap theme={null}

6482Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.

6483```

6484

6485Unter Windows ersetzt `The one with hasCompletedOnboarding or mcpServers in it is usually yours.` den Satz mit dem `grep`-Befehl.

6486

6487**Was zu tun ist:**

6488

6489**1. Die Datei mit Ihrer Konfiguration finden**

6490

6491* **Unter Windows**: Öffnen Sie beide Dateien und prüfen Sie, welche `hasCompletedOnboarding` oder `mcpServers` enthält

6492* **Auf anderen Plattformen**: Führen Sie in Ihrer Shell den `grep`-Befehl aus der Meldung aus und prüfen Sie, welche Datei die höhere Anzahl hat

6493

6494**2. Jeden Host aktualisieren, der das Home-Verzeichnis teilt**

6495

6496Wenn mehrere Hosts dieses Home-Verzeichnis teilen, aktualisieren Sie Claude Code zuerst auf jedem Host auf die in der Meldung genannte Version oder höher. Eine ältere Version kann eine verschobene `.config.json` zurückschreiben.

6497

6498**3. Claude Code beenden**

6499

6500Beenden Sie Ihre Claude Code-Prozesse auf jedem Host.

6501

6502**4. Die nicht gewünschte Datei verschieben**

6503

6504Verschieben Sie die Datei, die Sie nicht möchten, aus ihrem Ordner. Verschieben Sie sie, statt sie zu löschen, damit Sie sie wiederherstellen können.

6505

6506**5. Warten, bevor Sie Claude Code erneut starten**

6507

6508Starten Sie Claude Code auf keinem Host, bis kein Host die verschobene Datei mehr unter ihrem alten Pfad auflistet.

6509

6510Die Meldung verschwindet, sobald eine der beiden Dateien nicht mehr vorhanden ist.

6511

6435### Make this change again later: \~/.claude.json could not be updated6512### Make this change again later: \~/.claude.json could not be updated

6436 6513

6437Dieser Hinweis auf stderr bedeutet, dass eine Änderung an [`~/.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json), z. B. eine Anmeldung oder eine Antwort auf eine Vertrauensabfrage, nicht in der Datei gespeichert wurde:6514Dieser Hinweis auf stderr bedeutet, dass eine Änderung an [`~/.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json), z. B. eine Anmeldung oder eine Antwort auf eine Vertrauensabfrage, nicht in der Datei gespeichert wurde:

6450 6527

6451* Ein konfiguriertes [`--fallback-model`](https://code.claude.com/docs/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript6528* Ein konfiguriertes [`--fallback-model`](https://code.claude.com/docs/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript

6452* Eine Verfügbarkeitsprüfung von Amazon Bedrock oder Google Cloud's Agent Platform stellt fest, dass Ihr Standardmodell nicht verfügbar ist, oder Ihr Konto [verliert während einer Sitzung den Zugriff darauf](https://code.claude.com/docs/de/amazon-bedrock.md#when-a-model-is-disabled-mid-session)6529* Eine Verfügbarkeitsprüfung von Amazon Bedrock oder Google Cloud's Agent Platform stellt fest, dass Ihr Standardmodell nicht verfügbar ist, oder Ihr Konto [verliert während einer Sitzung den Zugriff darauf](https://code.claude.com/docs/de/amazon-bedrock.md#when-a-model-is-disabled-mid-session)

6453* [Automatisches Modell-Fallback](https://code.claude.com/docs/de/model-config.md#automatic-model-fallback) auf Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 und Opus 5 verschiebt die Sitzung zum Fallback-Modell der gekennzeichneten Kategorie, wenn diese Kategorie über einen verfügt, und zeigt eine Notiz im Transkript an6530* [Automatisches Modell-Fallback](https://code.claude.com/docs/de/model-config.md#automatic-model-fallback) bei Fable-Modellen, Opus 5.5, Sonnet 5.5 und Opus 5 verschiebt die Sitzung zum Fallback-Modell der gekennzeichneten Kategorie, wenn diese Kategorie über eines verfügt. Eine Notiz erscheint im Transkript

6454 6531

6455Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md) erklärt, wann jedes Fallback angewendet wird.6532Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md) erklärt, wann jedes Fallback angewendet wird.

6456 6533

fast-mode.md +22 −17

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4

~~5# Beschleunigen Sie Antworten mit dem Schnellmodus~~5# Beschleunigen Sie Antworten mit dem Fast-Modus

6 6

~~7> Erhalten Sie schnellere Opus-Antworten in Claude Code durch Aktivierung des Schnellmodus.~~7> Erhalten Sie schnellere Opus- und Fable-Antworten in Claude Code, indem Sie den Fast-Modus mit `/fast` umschalten.

8 8

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

10>10>

~~11> Der Fast-Modus für Claude Opus 5.5 ist verfügbar, und der Fast-Modus für Claude Opus 5 und Claude Opus 4.8 befindet sich in der [Research Preview](#research-preview).~~11> Der Fast-Modus für Claude Fable 5.2 und Claude Opus 5.5 ist verfügbar. Der Fast-Modus für Claude Opus 5 und Claude Opus 4.8 befindet sich in der [Research Preview](#research-preview).

12 12

13Der Schnellmodus ist eine Hochgeschwindigkeitskonfiguration für Claude Opus, die das Modell bis zu 2,5x schneller macht, allerdings zu höheren Kosten pro Token. Aktivieren Sie ihn mit `/fast`, wenn Sie Geschwindigkeit für interaktive Arbeiten wie schnelle Iteration oder Live-Debugging benötigen, und deaktivieren Sie ihn, wenn Kosten wichtiger sind als Latenz.13Der Fast-Modus ist eine Hochgeschwindigkeitskonfiguration für unterstützte Modelle, die das Modell bis zu 2,5x schneller macht, allerdings zu höheren Kosten pro Token. Aktivieren Sie ihn mit `/fast`, wenn Sie Geschwindigkeit für interaktive Arbeiten wie schnelle Iteration oder Live-Debugging benötigen, und deaktivieren Sie ihn, wenn Kosten wichtiger sind als Latenz.

14 14

15Der Schnellmodus ist kein anderes Modell. Er verwendet Claude Opus mit einer anderen API-Konfiguration, die Geschwindigkeit über Kosteneffizienz priorisiert. Sie erhalten identische Qualität und Funktionen mit schnelleren Antworten. Der Schnellmodus wird auf Opus 5.5, Opus 5 und Opus 4.8 unterstützt. Er ist nicht auf Sonnet, Haiku oder anderen Modellen verfügbar.15Der Fast-Modus verwendet dasselbe Modell mit einer anderen API-Konfiguration, die Geschwindigkeit über Kosteneffizienz priorisiert, sodass Qualität und Funktionen gleich bleiben. Der Fast-Modus wird auf Fable 5.2, Opus 5.5, Opus 5 und Opus 4.8 unterstützt. Er ist nicht auf Sonnet, Haiku oder anderen Modellen verfügbar.

16 16

17> [!WARNING]17> [!WARNING]

18>18>

26Was Sie wissen sollten:26Was Sie wissen sollten:

27 27

28* Verwenden Sie `/fast`, um den Schnellmodus in der Claude Code CLI ein- oder auszuschalten. Die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) bietet einen **Schnellmodus umschalten**-Befehl, wenn das ausgewählte Modell den Schnellmodus unterstützt. Claude Code speichert diese Einstellung in Ihrer [`fastMode`-Einstellung](#toggle-fast-mode).28* Verwenden Sie `/fast`, um den Schnellmodus in der Claude Code CLI ein- oder auszuschalten. Die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) bietet einen **Schnellmodus umschalten**-Befehl, wenn das ausgewählte Modell den Schnellmodus unterstützt. Claude Code speichert diese Einstellung in Ihrer [`fastMode`-Einstellung](#toggle-fast-mode).

~~29* Die Preisgestaltung für den Schnellmodus beträgt \$8/\$40 pro MTok Ein-/Ausgabe auf Opus 5.5 und \$10/\$50 auf Opus 5 und Opus 4.8.~~29* Die Preisgestaltung für den Fast-Modus beträgt pro MTok Ein-/Ausgabe \$16/\$80 auf Fable 5.2, \$8/\$40 auf Opus 5.5 und \$10/\$50 auf Opus 5 und Opus 4.8.

30* Verfügbar für Claude Code-Benutzer mit Abonnementplänen (Pro/Max/Ultra/Team/Enterprise) und auf Claude Console. Bei Team- und Enterprise-Organisationen muss zunächst ein Eigentümer den Fast-Modus aktivieren, und Console-Organisationen benötigen zunächst bereitgestellten Zugriff, um ihn mit Opus 5 oder Opus 4.8 zu verwenden. Unter [Anforderungen](#requirements) werden beide Fälle beschrieben.30* Verfügbar für Claude Code-Benutzer mit Abonnementplänen (Pro/Max/Ultra/Team/Enterprise) und auf Claude Console. Bei Team- und Enterprise-Organisationen muss zunächst ein Eigentümer den Fast-Modus aktivieren, und Console-Organisationen benötigen zunächst bereitgestellten Zugriff, um ihn mit Opus 5 oder Opus 4.8 zu verwenden. Unter [Anforderungen](#requirements) werden beide Fälle beschrieben.

31* Für Claude Code-Benutzer mit Abonnementplänen (Pro/Max/Ultra/Team/Enterprise) ist der Fast-Modus nur über Nutzungsguthaben verfügbar und nicht in den Rate-Limits des Abonnements enthalten.31* Für Claude Code-Benutzer mit Abonnementplänen (Pro/Max/Ultra/Team/Enterprise) ist der Fast-Modus nur über Nutzungsguthaben verfügbar und nicht in den Rate-Limits des Abonnements enthalten.

32 32

35In der CLI schalten Sie den Fast-Modus auf eine der folgenden Arten um:35In der CLI schalten Sie den Fast-Modus auf eine der folgenden Arten um:

36 36

37* Führen Sie `/fast` aus, drücken Sie Space zum Ein- oder Ausschalten und anschließend Enter zum Bestätigen37* Führen Sie `/fast` aus, drücken Sie Space zum Ein- oder Ausschalten und anschließend Enter zum Bestätigen

38* Setzen Sie bei einem Modell, das den Fast-Modus unterstützt, `"fastMode": true` in Ihrer [Benutzer-Einstellungsdatei](https://code.claude.com/docs/de/settings.md). Wenn Sie dies bei einem anderen Modell setzen, bleiben Sie bei diesem Modell, und der Fast-Modus bleibt ausgeschaltet.38* Setzen Sie bei einem Modell, das den Fast-Modus unterstützt, `"fastMode": true` in Ihrer [Benutzer-Einstellungsdatei](https://code.claude.com/docs/de/settings.md). Wenn Sie dies bei einem anderen Modell setzen, bleiben Sie bei diesem Modell, und der Fast-Modus bleibt ausgeschaltet. Bei Fable 5.2 hat diese Einstellung allein keine Wirkung, bis Sie `/fast` ausführen, während Sie Fable 5.2 verwenden.

39 39

40Standardmäßig bleibt der Fast-Modus, den Sie in einer interaktiven Sitzung einschalten, bei einem unterstützten Modell über Sitzungen hinweg erhalten. Sie können den Fast-Modus so konfigurieren, dass er bei jeder Sitzung zurückgesetzt wird. Details finden Sie unter [Aktivierung pro Sitzung erzwingen](#require-per-session-opt-in).40Standardmäßig bleibt der Fast-Modus, den Sie in einer interaktiven Sitzung einschalten, bei einem unterstützten Modell über Sitzungen hinweg erhalten. Bei Fable 5.2 bleibt er nur erhalten, wenn Sie [ihn eingeschaltet haben, während Sie Fable 5.2 verwendet haben](#switch-models-while-fast-mode-is-on). Sie können den Fast-Modus so konfigurieren, dass er bei jeder Sitzung zurückgesetzt wird. Details finden Sie unter [Aktivierung pro Sitzung erzwingen](#require-per-session-opt-in).

41 41

42Außerhalb einer [Cloud-Sitzung](#use-fast-mode-in-cloud-sessions) funktioniert `/fast` im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit dem Flag `-p` nur in einer Sitzung, die mit dem Fast-Modus in ihrem [`--settings`](https://code.claude.com/docs/de/cli-reference#cli-flags)-Wert gestartet wurde, zum Beispiel `claude -p --settings '{"fastMode": true}'`; das Umschalten gilt dann nur für diese Sitzung und wird nicht als Ihr Standard gespeichert. Die `-p`-Variante erfordert Claude Code v2.1.205 oder höher. Ansonsten meldet der Befehl im nicht interaktiven Modus, dass der Fast-Modus nicht verfügbar ist.42Außerhalb einer [Cloud-Sitzung](#use-fast-mode-in-cloud-sessions) funktioniert `/fast` im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) mit dem Flag `-p` nur in einer Sitzung, die mit dem Fast-Modus in ihrem [`--settings`](https://code.claude.com/docs/de/cli-reference#cli-flags)-Wert gestartet wurde, zum Beispiel `claude -p --settings '{"fastMode": true}'`; das Umschalten gilt dann nur für diese Sitzung und wird nicht als Ihr Standard gespeichert. Die `-p`-Variante erfordert Claude Code v2.1.205 oder höher. Ansonsten meldet der Befehl im nicht interaktiven Modus, dass der Fast-Modus nicht verfügbar ist.

43 43

48Wenn Sie den Fast-Modus mit `/fast` aktivieren:48Wenn Sie den Fast-Modus mit `/fast` aktivieren:

49 49

50* Wenn Ihr aktuelles Modell den Fast-Modus nicht unterstützt, wechselt Claude Code zu Opus50* Wenn Ihr aktuelles Modell den Fast-Modus nicht unterstützt, wechselt Claude Code zu Opus

51* Der Fast-Modus bei Fable 5.2 erfordert Claude Code v2.1.321 oder höher

51* Sie sehen eine Bestätigungsmeldung: „Fast mode ON“52* Sie sehen eine Bestätigungsmeldung: „Fast mode ON“

52* Ein kleines `↯`-Symbol erscheint neben dem Prompt, solange der Fast-Modus aktiv ist53* Ein kleines `↯`-Symbol erscheint neben dem Prompt, solange der Fast-Modus aktiv ist

53* Führen Sie `/fast` jederzeit erneut aus, um zu prüfen, ob der Fast-Modus ein- oder ausgeschaltet ist54* Führen Sie `/fast` jederzeit erneut aus, um zu prüfen, ob der Fast-Modus ein- oder ausgeschaltet ist

54 55

55Opus 5.5 ist der Standard für den Fast-Modus in Claude Code v2.1.280 und höher. Vor v2.1.280 war der Standard für den Fast-Modus ab v2.1.219 Opus 5.56Opus 5.5 ist der Standard für den Fast-Modus in Claude Code v2.1.280 und höher. Vor v2.1.280 war der Standard für den Fast-Modus ab v2.1.219 Opus 5.

56 57

~~57Wenn Sie den Fast-Modus mit `/fast` wieder deaktivieren, bleiben Sie bei Opus. Um zu einem anderen Modell zu wechseln, verwenden Sie `/model`.~~58Wenn Sie den Fast-Modus mit `/fast` wieder deaktivieren, bleiben Sie bei Ihrem aktuellen Modell. Um zu einem anderen Modell zu wechseln, verwenden Sie `/model`.

58 59

59### Modelle wechseln, während der Fast-Modus eingeschaltet ist60### Modelle wechseln, während der Fast-Modus eingeschaltet ist

60 61

~~61Der Fast-Modus folgt Ihren Modellwechseln in beide Richtungen:~~62Der Fast-Modus folgt Ihren Modellwechseln:

62 63

63* **Wegwechseln**: Wenn Sie zu einem Modell wechseln, das den Fast-Modus nicht unterstützt, schaltet Claude Code den Fast-Modus aus. Dies gilt auch für Opus 4.7; vor v2.1.221 blieb der Fast-Modus nach einem Wechsel zu Opus 4.7 eingeschaltet, und die API lehnte die Anfragen ab.64* **Wegwechseln**: Wenn Sie zu einem Modell wechseln, das den Fast-Modus nicht unterstützt, schaltet Claude Code den Fast-Modus aus. Dies gilt auch für Opus 4.7; vor v2.1.221 blieb der Fast-Modus nach einem Wechsel zu Opus 4.7 eingeschaltet, und die API lehnte die Anfragen ab.

64* **Zurückwechseln**: Ein Wechsel zurück zu einem unterstützten Opus-Modell schaltet den Fast-Modus wieder ein, wenn Ihre gespeicherte Fast-Modus-Präferenz eingeschaltet ist – dieselbe Präferenz, mit der eine neue Sitzung standardmäßig startet. Ein Modellwechsel schaltet den Fast-Modus niemals für eine Sitzung ein, deren gespeicherte Präferenz ausgeschaltet ist, und wenn [Aktivierung pro Sitzung](#require-per-session-opt-in) konfiguriert ist, schaltet ihn auch ein Zurückwechseln nicht ein; führen Sie `/fast` aus, um ihn wieder zu aktivieren.65* **Zurückwechseln**: Der Fast-Modus wird bei einem unterstützten Opus-Modell wieder eingeschaltet, wenn Ihre gespeicherte Präferenz eingeschaltet ist. Mit [Aktivierung pro Sitzung](#require-per-session-opt-in) führen Sie stattdessen `/fast` aus.

66* **Zu Fable 5.2 wechseln**: Der Fast-Modus wird ausgeschaltet, es sei denn, Sie haben ihn eingeschaltet, während Sie Fable 5.2 verwendet haben. Um ihn einzuschalten, führen Sie `/fast` bei Fable 5.2 aus. Sofern Sie keine [Aktivierung pro Sitzung](#require-per-session-opt-in) festgelegt haben, bleibt dies über Sitzungen hinweg erhalten, bis Sie ihn ausschalten oder mit einem anderen Modell einschalten.

65 67

66Immer wenn ein Modellwechsel den Fast-Modus ein- oder ausschaltet, zeigt Claude Code eine Bestätigung `Fast mode ON` oder `Fast mode OFF` an, und das `↯`-Symbol erscheint, solange der Fast-Modus eingeschaltet ist. Dies gilt unabhängig davon, ob Sie mit `/model`, mit [`/config model=<model>`](https://code.claude.com/docs/de/settings) oder von einem über [Remote Control](https://code.claude.com/docs/de/remote-control.md) verbundenen Gerät aus wechseln.68Immer wenn ein Modellwechsel den Fast-Modus ein- oder ausschaltet, zeigt Claude Code eine Bestätigung `Fast mode ON` oder `Fast mode OFF` an, und das `↯`-Symbol erscheint, solange der Fast-Modus eingeschaltet ist. Dies gilt unabhängig davon, ob Sie mit `/model`, mit [`/config model=<model>`](https://code.claude.com/docs/de/settings) oder von einem über [Remote Control](https://code.claude.com/docs/de/remote-control.md) verbundenen Gerät aus wechseln.

67 69

77 79

78## Kostenabwägung verstehen80## Kostenabwägung verstehen

79 81

~~80Der Schnellmodus hat höhere Pro-Token-Preise als Standard-Opus:~~82Der Fast-Modus hat höhere Pro-Token-Preise als die Standardgeschwindigkeit:

81 83

83| - | - | - |85| - | - | - |

86| Fable 5.2 | \$16 | \$80 |

84| Opus 5.5 | \$8 | \$40 |87| Opus 5.5 | \$8 | \$40 |

85| Opus 5 | \$10 | \$50 |88| Opus 5 | \$10 | \$50 |

86| Opus 4.8 | \$10 | \$50 |89| Opus 4.8 | \$10 | \$50 |

87 90

88Die Preisgestaltung für den Schnellmodus ist über das gesamte 1M-Token-Kontextfenster einheitlich. Für den Standard-Opus-Satz zum Vergleich siehe die [Claude-Preisreferenz](https://platform.claude.com/docs/de/about-claude/pricing).91Die Preisgestaltung für den Fast-Modus ist über das gesamte 1M-Token-Kontextfenster einheitlich. Den Standardpreis zum Vergleich finden Sie in der [Claude-Preisreferenz](https://platform.claude.com/docs/de/about-claude/pricing).

89 92

90Wenn Sie den Fast-Modus zum ersten Mal in einer Konversation aktivieren, zahlen Sie den vollständigen Fast-Modus-Preis für nicht zwischengespeicherte Eingabe-Token für den gesamten Konversationskontext. Je weiter Sie in einer Konversation fortgeschritten sind, desto mehr kostet dies, daher ist die Aktivierung des Fast-Modus von Anfang an am günstigsten. Der Fast-Modus und die Standardgeschwindigkeit verwenden [separate Caches](https://code.claude.com/docs/de/prompt-caching.md#turning-on-fast-mode), daher liest jeder spätere Wechsel einen Teil oder die gesamte Konversation erneut ohne Cache ein.93Wenn Sie den Fast-Modus zum ersten Mal in einer Konversation aktivieren, zahlen Sie den vollständigen Fast-Modus-Preis für nicht zwischengespeicherte Eingabe-Token für den gesamten Konversationskontext. Je weiter Sie in einer Konversation fortgeschritten sind, desto mehr kostet dies, daher ist die Aktivierung des Fast-Modus von Anfang an am günstigsten. Der Fast-Modus und die Standardgeschwindigkeit verwenden [separate Caches](https://code.claude.com/docs/de/prompt-caching.md#turning-on-fast-mode), daher liest jeder spätere Wechsel einen Teil oder die gesamte Konversation erneut ohne Cache ein.

91 94

137 140

138* **Bezahlte Console-Organisation**: Claude Console-Konten verwenden keine Nutzungsguthaben, und Ihre Organisation zahlt für den Schnellmodus pro Token zusammen mit dem Rest ihrer API-Nutzung. Im kostenlosen Evaluierungsplan der Console zeigt `/fast` „Fast mode unavailable during evaluation. Please purchase credits.“ an. Um dies zu beheben, kaufen Sie Guthaben in Ihren [Console-Abrechnungseinstellungen](https://platform.claude.com/settings/billing).141* **Bezahlte Console-Organisation**: Claude Console-Konten verwenden keine Nutzungsguthaben, und Ihre Organisation zahlt für den Schnellmodus pro Token zusammen mit dem Rest ihrer API-Nutzung. Im kostenlosen Evaluierungsplan der Console zeigt `/fast` „Fast mode unavailable during evaluation. Please purchase credits.“ an. Um dies zu beheben, kaufen Sie Guthaben in Ihren [Console-Abrechnungseinstellungen](https://platform.claude.com/settings/billing).

139 142

140 Der Fast-Modus mit Opus 5.5 hängt außerdem von der [Nutzungsstufe](https://platform.claude.com/docs/en/api/rate-limits) Ihrer Organisation ab.143 Der Fast-Modus mit Fable 5.2 oder Opus 5.5 hängt außerdem von der [Nutzungsstufe](https://platform.claude.com/docs/en/api/rate-limits) Ihrer Organisation ab.

141* **Owner-Aktivierung für Teams und Enterprise**: Der Schnellmodus ist standardmäßig für Teams- und Enterprise-Organisationen deaktiviert. Ein Owner muss den Schnellmodus explizit [aktivieren](#enable-fast-mode-for-your-organization), bevor Benutzer darauf zugreifen können.144* **Owner-Aktivierung für Teams und Enterprise**: Der Schnellmodus ist standardmäßig für Teams- und Enterprise-Organisationen deaktiviert. Ein Owner muss den Schnellmodus explizit [aktivieren](#enable-fast-mode-for-your-organization), bevor Benutzer darauf zugreifen können.

142 145

143> [!NOTE]146> [!NOTE]

147> * **Schnellmodus nicht aktiviert**: Wenn der Schnellmodus für Ihre Organisation nicht aktiviert wurde, zeigt das Aktivieren des Schnellmodus mit `/fast` „Fast mode has been disabled by your organization.“ an.150> * **Schnellmodus nicht aktiviert**: Wenn der Schnellmodus für Ihre Organisation nicht aktiviert wurde, zeigt das Aktivieren des Schnellmodus mit `/fast` „Fast mode has been disabled by your organization.“ an.

148> * **Schnellmodus durch verwaltete Einstellungen deaktiviert**: Wenn Ihre Organisation [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereitstellt, die [`fastMode: false`](https://code.claude.com/docs/de/settings-reference#fastmode) setzen, zeigt das Aktivieren des Schnellmodus mit `/fast` die gleiche Meldung „Fast mode has been disabled by your organization“ an.151> * **Schnellmodus durch verwaltete Einstellungen deaktiviert**: Wenn Ihre Organisation [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereitstellt, die [`fastMode: false`](https://code.claude.com/docs/de/settings-reference#fastmode) setzen, zeigt das Aktivieren des Schnellmodus mit `/fast` die gleiche Meldung „Fast mode has been disabled by your organization“ an.

149> * **Opt-in pro Sitzung erforderlich**: Verwaltete Einstellungen, die [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) setzen, lehnen `/fast on` mit der gleichen Meldung überall ab, außer in einer interaktiven Terminalsitzung.152> * **Opt-in pro Sitzung erforderlich**: Verwaltete Einstellungen, die [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) setzen, lehnen `/fast on` mit der gleichen Meldung überall ab, außer in einer interaktiven Terminalsitzung.

150> * **Schnellmodus-Modell nicht zulässig**: Wenn die [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation das Schnellmodus-Opus-Modell ausschließt, wird das Aktivieren mit „is not in your organization's allowed models“ abgelehnt. In einer Sitzung, die bereits auf einem zulässigen Opus-Modell ausgeführt wird, das den Schnellmodus unterstützt, aktiviert `/fast` stattdessen den Schnellmodus auf Ihrem aktuellen Modell, ohne Modelle zu wechseln.153> * **Fast-Modus-Modell nicht zulässig**: Wenn die [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Allowlist Ihrer Organisation das Fast-Modus-Opus-Modell ausschließt, wird das Aktivieren mit „is not in your organization's allowed models“ abgelehnt. In einer Sitzung, die bereits auf einem zulässigen Modell ausgeführt wird, das den Fast-Modus unterstützt, aktiviert `/fast` stattdessen den Fast-Modus auf Ihrem aktuellen Modell, ohne Modelle zu wechseln.

151 154

152### Schnellmodus für Ihre Organisation aktivieren155### Schnellmodus für Ihre Organisation aktivieren

153 156

196 199

197### Opt-in pro Sitzung erforderlich200### Opt-in pro Sitzung erforderlich

198 201

199Standardmäßig bleibt der Fast-Modus, den ein Benutzer in einer interaktiven Sitzung aktiviert, auf einem unterstützten Modell über Sitzungen hinweg erhalten. Um dies zu ändern, setzen Sie `fastModePerSessionOptIn` in einer beliebigen [Einstellungsdatei](https://code.claude.com/docs/de/settings.md#where-settings-live) auf `true`, was dazu führt, dass jede Sitzung mit deaktiviertem Fast-Modus beginnt und Benutzer ihn explizit mit `/fast` aktivieren müssen. Owners in [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise)- oder [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise)-Plänen können dies organisationsweit über [servergesteuerte Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) bereitstellen.202Standardmäßig bleibt der Fast-Modus, den ein Benutzer in einer interaktiven Sitzung aktiviert, auf einem unterstützten Modell über Sitzungen hinweg erhalten. Bei Fable 5.2 bleibt er nur erhalten, wenn der Benutzer [ihn während der Verwendung von Fable 5.2 aktiviert hat](#switch-models-while-fast-mode-is-on).

203

204Damit jede Sitzung mit deaktiviertem Fast-Modus beginnt, setzen Sie `fastModePerSessionOptIn` in einer beliebigen [Einstellungsdatei](https://code.claude.com/docs/de/settings.md#where-settings-live) auf `true`. Benutzer aktivieren ihn dann in jeder Sitzung mit `/fast`. Owners in [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise)- oder [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise)-Plänen können dies organisationsweit über [servergesteuerte Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) bereitstellen.

200 205

201```json theme={null}206```json theme={null}

202{207{

210 215

211## Ratenlimits handhaben216## Ratenlimits handhaben

212 217

213Der Fast-Modus hat vom Standard-Opus getrennte Rate-Limits; für Console-Organisationen werden diese auf der Seite [Rate-Limits](https://platform.claude.com/docs/en/api/rate-limits) der Claude Platform beschrieben. Wenn Sie das Rate-Limit des Fast-Modus erreichen:218Der Fast-Modus hat von der Standard-Geschwindigkeit getrennte Rate-Limits; für Console-Organisationen werden diese auf der Seite [Rate-Limits](https://platform.claude.com/docs/en/api/rate-limits) der Claude Platform beschrieben. Wenn Sie das Rate-Limit des Fast-Modus erreichen:

214 219

2151. Der Schnellmodus fällt automatisch auf Standard-Geschwindigkeit auf2201. Der Schnellmodus fällt automatisch auf Standard-Geschwindigkeit auf

2162. Das `↯`-Symbol wird grau, um die Abkühlung anzuzeigen2212. Das `↯`-Symbol wird grau, um die Abkühlung anzuzeigen

hooks.md +12 −4

Details

1089 1089

1090#### Terminal-Benachrichtigungen ausgeben1090#### Terminal-Benachrichtigungen ausgeben

1091 1091

1092Hooks werden ohne steuerndes Terminal ausgeführt, daher schlägt das direkte Schreiben von Escape-Sequenzen zu `/dev/tty` fehl. Geben Sie stattdessen die Escape-Sequenz im `terminalSequence`-Feld zurück und Claude Code gibt sie für Sie über seinen eigenen Terminal-Schreibpfad aus. Dies ist race-frei, funktioniert innerhalb von tmux und GNU screen und funktioniert unter Windows, wo es kein `/dev/tty` gibt.1092Hooks werden ohne steuerndes Terminal ausgeführt, daher schlägt das direkte Schreiben von Escape-Sequenzen zu `/dev/tty` fehl. Geben Sie stattdessen die Escape-Sequenz im `terminalSequence`-Feld zurück und Claude Code gibt sie für Sie über seinen eigenen Terminal-Schreibpfad aus. Dies ist race-frei und funktioniert unter Windows, wo es kein `/dev/tty` gibt.

1093 1093

1094Das Feld akzeptiert einen String von einer oder mehreren zugelassenen Escape-Sequenzen:1094Das Feld akzeptiert einen String von einer oder mehreren zugelassenen Escape-Sequenzen:

1095 1095

1101 1101

1102Sequenzen können mit BEL oder mit ST beendet werden. Alles außerhalb der Allowlist, einschließlich CSI-Cursor- und Farbsequenzen, OSC-Palettensequenzen, OSC-8-Hyperlinks, OSC-52-Clipboard-Schreibvorgänge und OSC 1337, wird abgelehnt und das Feld wird ignoriert.1102Sequenzen können mit BEL oder mit ST beendet werden. Alles außerhalb der Allowlist, einschließlich CSI-Cursor- und Farbsequenzen, OSC-Palettensequenzen, OSC-8-Hyperlinks, OSC-52-Clipboard-Schreibvorgänge und OSC 1337, wird abgelehnt und das Feld wird ignoriert.

1103 1103

1104Claude Code schreibt die Sequenz selbst, wenn es Ihre Hook-Ausgabe verarbeitet, sodass das Feld bei Events funktioniert, die `systemMessage` und `continue` verwerfen, wie `Notification` und `StopFailure`. Es hat zwei Limits:1104Claude Code schreibt die Sequenz selbst, wenn es Ihre Hook-Ausgabe verarbeitet, sodass das Feld bei Events funktioniert, die `systemMessage` und `continue` verwerfen, wie `Notification` und `StopFailure`. Es gibt einige Einschränkungen:

1105 1105

1106* Claude Code schreibt die Sequenz nur in einer interaktiven Session und nur, während seine Schnittstelle auf dem Bildschirm ist. Im nicht interaktiven Modus mit dem `-p`-Flag und im Agent SDK ignoriert es das Feld.1106* Claude Code schreibt die Sequenz nur in einer interaktiven Session und nur, während seine Oberfläche geöffnet ist. Im nicht interaktiven Modus mit dem `-p`-Flag und im Agent SDK ignoriert es das Feld.

1107* Das Feld funktioniert nur bei einem Hook, der nicht im [Hintergrund](#run-hooks-in-the-background) ausgeführt wird, lassen Sie `async` und `asyncRewake` also deaktiviert.

1107* Ein `WorktreeCreate`-Command-Hook kann kein JSON zurückgeben, da Claude Code seinen stdout als Worktree-Pfad liest. Ein HTTP-`WorktreeCreate`-Hook gibt JSON zurück und kann das Feld enthalten.1108* Ein `WorktreeCreate`-Command-Hook kann kein JSON zurückgeben, da Claude Code seinen stdout als Worktree-Pfad liest. Ein HTTP-`WorktreeCreate`-Hook gibt JSON zurück und kann das Feld enthalten.

1108 1109

1109Das folgende Beispiel löst eine Desktop-Benachrichtigung von einem `Notification`-Hook aus. Die Escape-Sequenz wird mit `printf`-Oktal-Escapes erstellt, sodass die Steuerbytes nie auf der Shell-Befehlszeile erscheinen, und `jq -n --arg` erstellt die JSON-Ausgabe, sodass Anführungszeichen, Backslashes und Zeilenumbrüche in der Benachrichtigungsmeldung korrekt escaped werden:1110Wenn Sie tmux oder GNU screen verwenden, schließen Sie zuerst [die Einrichtung dafür](#get-terminal-notifications-inside-tmux-or-gnu-screen) ab. Das folgende Beispiel löst eine Desktop-Benachrichtigung von einem `Notification`-Hook in einem Terminal aus, das OSC `777` liest, etwa Ghostty oder Warp. Der Aufruf `jq -nc --arg` des Skripts erstellt die JSON-Ausgabe und escaped alle Anführungszeichen, Backslashes und Zeilenumbrüche in der Benachrichtigungsmeldung:

1110 1111

1111```bash theme={null}1112```bash theme={null}

1112#!/bin/bash1113#!/bin/bash

1120 1121

1121Die `{ "terminalSequence": "..." }`-Form ist die gleiche aus jeder Shell oder Sprache.1122Die `{ "terminalSequence": "..." }`-Form ist die gleiche aus jeder Shell oder Sprache.

1122 1123

1124#### Terminal-Benachrichtigungen innerhalb von tmux oder GNU screen erhalten

1125

1126Wenn Claude Code innerhalb von tmux oder GNU screen läuft, benötigen OSC-Sequenzen Folgendes, um Ihre Terminal-Anwendung zu erreichen:

1127

1128* **tmux 3.3 oder später**: Fügen Sie `set -g allow-passthrough on` zu `~/.tmux.conf` hinzu und führen Sie dann `tmux source-file ~/.tmux.conf` in einer Shell aus. Die Option gilt für jedes Programm in diesen Panes, nicht nur für Claude Code. Mit `on` können nur Panes, die tmux gerade anzeigt, die Sequenzen senden. Damit auch andere Panes in einer Sitzung, mit der Sie verbunden sind, sie senden können, verwenden Sie ab tmux 3.4 `all` anstelle von `on`.

1129* **GNU screen**: Lassen Sie das Fenster von Claude Code in screen angezeigt, da Sequenzen aus einem Hintergrundfenster Ihre Terminal-Anwendung nicht erreichen

1130

1123#### Kontext für Claude hinzufügen1131#### Kontext für Claude hinzufügen

1124 1132

1125Das `additionalContext`-Feld übergibt einen String von Ihrem Hook in Claudes Kontextfenster. Claude Code umhüllt den String in eine [System-Erinnerung](https://code.claude.com/docs/de/glossary.md#system-reminder) und fügt ihn in die Konversation an dem Punkt ein, an dem der Hook ausgelöst wurde. Claude liest die Erinnerung bei der nächsten Modellanfrage, aber sie erscheint nicht als Chat-Nachricht in der Schnittstelle.1133Das `additionalContext`-Feld übergibt einen String von Ihrem Hook in Claudes Kontextfenster. Claude Code umhüllt den String in eine [System-Erinnerung](https://code.claude.com/docs/de/glossary.md#system-reminder) und fügt ihn in die Konversation an dem Punkt ein, an dem der Hook ausgelöst wurde. Claude liest die Erinnerung bei der nächsten Modellanfrage, aber sie erscheint nicht als Chat-Nachricht in der Schnittstelle.

llm-gateway-protocol.md +1 −1

Details

223| Beta [Tool-Felder](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Tool-bezogene Beta-Header paaren sich mit Tool-Schema-Feldern wie `strict` und `defer_loading` | `400` mit Nennung des nicht erkannten Tool-Schema-Feldes, wenn der Body ohne seinen Header durchgeht. Zu `defer_loading` siehe [Wiederholungsversuch ohne Tool Search](#retry-without-tool-search) | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |223| Beta [Tool-Felder](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Tool-bezogene Beta-Header paaren sich mit Tool-Schema-Feldern wie `strict` und `defer_loading` | `400` mit Nennung des nicht erkannten Tool-Schema-Feldes, wenn der Body ohne seinen Header durchgeht. Zu `defer_loading` siehe [Wiederholungsversuch ohne Tool Search](#retry-without-tool-search) | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

224| [Aufwand](https://platform.claude.com/docs/de/build-with-claude/effort) und [strukturierte Ausgaben](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) | Das `output_config` Body-Feld trägt Aufwand, strukturierte Ausgabeformat und Task-Budget-Einstellungen; jedes paart sich mit seinem eigenen Beta-Header | `400` mit Nennung von `output_config`, oft `Extra inputs are not permitted`, auf Amazon Bedrock und Google Cloud Agent Platform Upstreams | Leiten Sie das Feld und seine Header zusammen weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, wodurch die Format- und Task-Budget-Einstellungen entfernt werden, nicht aber der Aufwand. Um nur das Format zu entfernen, können sie stattdessen [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/de/env-vars) setzen, was v2.1.288 oder später erfordert |224| [Aufwand](https://platform.claude.com/docs/de/build-with-claude/effort) und [strukturierte Ausgaben](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) | Das `output_config` Body-Feld trägt Aufwand, strukturierte Ausgabeformat und Task-Budget-Einstellungen; jedes paart sich mit seinem eigenen Beta-Header | `400` mit Nennung von `output_config`, oft `Extra inputs are not permitted`, auf Amazon Bedrock und Google Cloud Agent Platform Upstreams | Leiten Sie das Feld und seine Header zusammen weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, wodurch die Format- und Task-Budget-Einstellungen entfernt werden, nicht aber der Aufwand. Um nur das Format zu entfernen, können sie stattdessen [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/de/env-vars) setzen, was v2.1.288 oder später erfordert |

225| Systemnachrichten mitten in der Konversation | Kein Beta-Header. Claude Code sendet einige Erinnerungs- und Anhangstexte als `role: "system"`-Einträge in `messages` für Claude Opus 4.8, danach veröffentlichte Modelle und nicht erkannte Modell-IDs | `400` wie z. B. `Unexpected role "system"` | Claude Code [versucht die Anfrage ohne Systemnachrichten erneut](#automatic-retry-and-error-forwarding). Um Systemnachrichten für einen Alias eines vor Claude Opus 4.8 veröffentlichten Modells zu unterbinden, fügen Sie den von Ihnen verteilten Einstellungen einen [`modelOverrides`-Eintrag](#settings-for-unrecognized-model-ids) hinzu |225| Systemnachrichten mitten in der Konversation | Kein Beta-Header. Claude Code sendet einige Erinnerungs- und Anhangstexte als `role: "system"`-Einträge in `messages` für Claude Opus 4.8, danach veröffentlichte Modelle und nicht erkannte Modell-IDs | `400` wie z. B. `Unexpected role "system"` | Claude Code [versucht die Anfrage ohne Systemnachrichten erneut](#automatic-retry-and-error-forwarding). Um Systemnachrichten für einen Alias eines vor Claude Opus 4.8 veröffentlichten Modells zu unterbinden, fügen Sie den von Ihnen verteilten Einstellungen einen [`modelOverrides`-Eintrag](#settings-for-unrecognized-model-ids) hinzu |

226| [Pro Turn festgelegter Aufwand](https://code.claude.com/docs/de/prompt-caching.md#changing-effort-level) | Bei Opus 5.5, Sonnet 5.5, Haiku 5.5 und Fable 5.1 paart sich ein Beta-Header mit `output_config.effort` auf `role: "system"`-Einträgen, entweder einer Systemnachricht oder einem Eintrag mit leerem Inhalt | `400` mit `messages.N: system content must contain at least one block`, wenn Ihr Gateway das Feld aus einem leeren Eintrag entfernt | Leiten Sie beide weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, um das Feld und die leeren Einträge zu unterbinden |226| [Pro Turn festgelegter Aufwand](https://code.claude.com/docs/de/prompt-caching.md#changing-effort-level) | Bei Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 und Fable 5.1 paart sich ein Beta-Header mit `output_config.effort` auf `role: "system"`-Einträgen. Ein Eintrag ist eine Systemnachricht oder ein Eintrag mit leerem Inhalt | `400` mit `messages.N: system content must contain at least one block`, wenn Ihr Gateway das Feld aus einem leeren Eintrag entfernt | Leiten Sie beide weiter, oder lassen Sie Entwickler [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) setzen, um das Feld und die leeren Einträge zu unterbinden |

227| [Prompt Caching](https://code.claude.com/docs/de/prompt-caching.md) | Keine Beta-Paarung. Claude Code fügt `cache_control` Marker an `system` Blöcke und an `messages` Einträge an, einschließlich `role: "system"` Einträge, die mitten in der Konversation angehängt werden | Kein Fehler: das Gespräch wird bei jedem Turn als nicht gecachter Input abgerechnet, sichtbar als hohe `input_tokens` mit wenig oder keiner Cache-Aktivität in `usage` | Leiten Sie `cache_control` unverändert weiter, wo immer es erscheint, und konvertieren Sie nicht Block-Form `system` oder Message-Inhalte in einfache Strings |227| [Prompt Caching](https://code.claude.com/docs/de/prompt-caching.md) | Keine Beta-Paarung. Claude Code fügt `cache_control` Marker an `system` Blöcke und an `messages` Einträge an, einschließlich `role: "system"` Einträge, die mitten in der Konversation angehängt werden | Kein Fehler: das Gespräch wird bei jedem Turn als nicht gecachter Input abgerechnet, sichtbar als hohe `input_tokens` mit wenig oder keiner Cache-Aktivität in `usage` | Leiten Sie `cache_control` unverändert weiter, wo immer es erscheint, und konvertieren Sie nicht Block-Form `system` oder Message-Inhalte in einfache Strings |

228| [Token Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Keine Beta-Paarung; verwendet den `count_tokens` Endpunkt | Kein Fehler: Claude Code fällt auf eine zeichenbasierte Schätzung zurück, daher zeigt `/context` ungefähre Zählungen | Stellen Sie den Endpunkt für genaue Token-Zählungen bereit |228| [Token Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Keine Beta-Paarung; verwendet den `count_tokens` Endpunkt | Kein Fehler: Claude Code fällt auf eine zeichenbasierte Schätzung zurück, daher zeigt `/context` ungefähre Zählungen | Stellen Sie den Endpunkt für genaue Token-Zählungen bereit |

229 229

model-config.md +52 −23

Details

30| Modellalias | Verhalten |30| Modellalias | Verhalten |

31| - | - |31| - | - |

32| **`default`** | Spezialwert, der jede Modellüberschreibung löscht und auf den [Laufzeit-Standard für Ihr Konto](#default-model-setting) zurücksetzt. Ist selbst kein Modellalias |32| **`default`** | Spezialwert, der jede Modellüberschreibung löscht und auf den [Laufzeit-Standard für Ihr Konto](#default-model-setting) zurücksetzt. Ist selbst kein Modellalias |

34| **`fable`** | Verwendet das [Fable-Modell für Ihren Anbieter](#fable-alias-resolution) für Ihre schwierigsten und längsten Aufgaben |34| **`fable`** | Verwendet das [Fable-Modell für Ihren Anbieter](#fable-alias-resolution) für Ihre schwierigsten und längsten Aufgaben |

35| **`sonnet`** | Verwendet das neueste Sonnet-Modell für tägliche Codierungsaufgaben |35| **`sonnet`** | Verwendet das neueste Sonnet-Modell für tägliche Codierungsaufgaben |

36| **`opus`** | Verwendet das neueste Opus-Modell für komplexe Denkaufgaben |36| **`opus`** | Verwendet das neueste Opus-Modell für komplexe Denkaufgaben |

50 50

51Sofern Sie `ANTHROPIC_DEFAULT_FABLE_MODEL` nicht festlegen, wird der `fable`-Alias zu Fable 5.1 aufgelöst, außer in [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzungen, wo `fable` und `best` zu Fable 5 aufgelöst werden.51Sofern Sie `ANTHROPIC_DEFAULT_FABLE_MODEL` nicht festlegen, wird der `fable`-Alias in [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzungen zu Fable 5 und überall sonst zu Fable 5.2 aufgelöst.

52 52

53Ein Gateway, das nicht für die Bereitstellung von `claude-fable-5-1` konfiguriert ist, lehnt Anfragen für dieses Modell ab. Um Fable 5.1 über ein Gateway zu verwenden, das es bereitstellt, wählen Sie es mit `/model claude-fable-5-1` aus.53Ein Gateway, das nicht für die Bereitstellung von `claude-fable-5-2` konfiguriert ist, lehnt Anfragen für dieses Modell ab. Um Fable 5.2 über ein Gateway zu verwenden, das es bereitstellt, wählen Sie es mit `/model claude-fable-5-2` aus.

54 54

55Wenn `opus` oder `sonnet` zu einem älteren Modell aufgelöst wird, sind neuere Modelle verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder `ANTHROPIC_DEFAULT_OPUS_MODEL` oder `ANTHROPIC_DEFAULT_SONNET_MODEL` festlegen.55Wenn `opus` oder `sonnet` zu einem älteren Modell aufgelöst wird, sind neuere Modelle verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder `ANTHROPIC_DEFAULT_OPUS_MODEL` oder `ANTHROPIC_DEFAULT_SONNET_MODEL` festlegen.

56 56

64 64

65### Mit Fable arbeiten65### Mit Fable arbeiten

66 66

67[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) und Claude Fable 5 sind die leistungsfähigsten Modelle in Claude Code, geeignet für Aufgaben, die größer als eine einzelne Sitzung sind. Sie halten lange autonome Sitzungen, untersuchen vor dem Handeln und überprüfen ihre Arbeit häufiger als kleinere Modelle. Fable 5.1 ist die neuere Version.67[Claude-Fable-Modelle](https://platform.claude.com/docs/en/about-claude/models/overview) sind die leistungsfähigsten Modelle in Claude Code, geeignet für Aufgaben, die größer als eine einzelne Sitzung sind. Sie halten lange autonome Sitzungen, untersuchen vor dem Handeln und überprüfen ihre Arbeit häufiger als kleinere Modelle.

68 68

69Keines der Fable-Modelle ist der Standard für den Kontotyp auf einem Plan oder Anbieter. Wählen Sie eines explizit aus:69Keines der Fable-Modelle ist der Standard für den Kontotyp auf einem Plan oder Anbieter. Wählen Sie eines explizit aus:

70 70

71* **Fable 5.1**: Führen Sie `/model fable` aus oder starten Sie mit `claude --model fable`. In [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzungen, wo der Alias zu Fable 5 aufgelöst wird, führen Sie stattdessen `/model claude-fable-5-1` aus.71* **Fable 5.2**: Führen Sie `/model fable` aus oder starten Sie mit `claude --model fable`. In [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzungen führen Sie stattdessen `/model claude-fable-5-2` aus.

72* **Fable 5**: Wählen Sie es nach Modell-ID aus. Auf der Anthropic API führen Sie `/model claude-fable-5` aus oder starten Sie mit `claude --model claude-fable-5`. Bei anderen Anbietern verwenden Sie die Fable-5-Modell-ID Ihres Anbieters oder [fixieren Sie sie](#pin-models-for-third-party-deployments) mit `ANTHROPIC_DEFAULT_FABLE_MODEL`.72* **Fable 5.1 oder Fable 5**: Wählen Sie es nach Modell-ID aus. Auf der Anthropic API führen Sie `/model claude-fable-5-1` oder `/model claude-fable-5` aus oder starten Sie mit `claude --model claude-fable-5-1`. Bei anderen Anbietern verwenden Sie die Modell-ID Ihres Anbieters oder [fixieren Sie sie](#pin-models-for-third-party-deployments) mit `ANTHROPIC_DEFAULT_FABLE_MODEL`.

73 73

74Wenn Sie sich direkt mit der Anthropic API verbinden und Ihre Benutzereinstellungen `claude-fable-5` oder `claude-fable-5[1m]` als Modell enthalten, z. B. weil Sie Fable in der `/model`-Auswahl vor v2.1.257 ausgewählt haben, ändert Claude Code diesen gespeicherten Wert beim ersten Ausführen von v2.1.257 oder später in den `fable`- oder `fable[1m]`-Alias. Die Startmodellzeile zeigt `(auto-updated)` einmal an. Ein `claude-fable-5`-Wert in Projekt-, Lokal- oder verwalteten Einstellungen bleibt unverändert.74Bei Pro-, Max-, Team- und Enterprise-Plänen wird ein in Ihren Benutzereinstellungen gespeichertes `claude-fable-5-1`-Modell auf den `fable`-Alias umgestellt:

76* **Pro- oder Max-Plan**: Die Umstellung erfolgt beim ersten Ausführen von v2.1.321 oder später. Im Terminal kann die Startmodellzeile einmal `(auto-updated)` anzeigen.

77* **Team- oder Enterprise-Plan**: Die Umstellung wartet auf die Einstellungen Ihrer Organisation und kann daher bei einem späteren Start oder gar nicht erfolgen. Sie gilt ab der nächsten Sitzung, ohne `(auto-updated)`-Zeile. Um Ihr Modell zu prüfen, führen Sie `/model` aus.

79Nach der Umstellung starten Sitzungen mit der Standard-Effort-Stufe von Fable 5.2, sofern Sie nicht [eine Stufe dafür festgelegt haben](#adjust-effort-level). Console-Konten, Drittanbieter sowie Projekt-, Lokal- oder verwaltete Einstellungen behalten `claude-fable-5-1`.

75 80

76Anfragen, die die Sicherheitsklassifikatoren eines Fable-Modells kennzeichnen, meist in Cybersicherheits- und Biologie-Bereichen, lösen einen [automatischen Modell-Fallback](#automatic-model-fallback) aus.81Anfragen, die die Sicherheitsklassifikatoren eines Fable-Modells kennzeichnen, meist in Cybersicherheits- und Biologie-Bereichen, lösen einen [automatischen Modell-Fallback](#automatic-model-fallback) aus.

77 82

84 89

85> [!NOTE]90> [!NOTE]

86>91>

87> Fable 5.1 erfordert Claude Code v2.1.257 oder später. Wenn eine Anfrage dafür von einer älteren Version fehlschlägt, siehe [Claude Code does not support this model](https://code.claude.com/docs/de/errors.md#claude-code-does-not-support-this-model). Führen Sie `claude update` aus, um zu aktualisieren. Zur Verfügbarkeit unter Null-Datenspeicherung siehe [Model availability under ZDR](https://code.claude.com/docs/de/zero-data-retention.md#model-availability-under-zdr).92> Fable 5.2 erfordert Claude Code v2.1.321 oder später, und Fable 5.1 erfordert v2.1.257 oder später. Wenn eine Anfrage für eines von ihnen von einer älteren Version fehlschlägt, siehe [Claude Code does not support this model](https://code.claude.com/docs/de/errors.md#claude-code-does-not-support-this-model). Führen Sie `claude update` aus, um zu aktualisieren. Zur Verfügbarkeit unter Null-Datenspeicherung siehe [Model availability under ZDR](https://code.claude.com/docs/de/zero-data-retention.md#model-availability-under-zdr).

88 93

89Auf der Anthropic API wird ein Fable-Modell in der `/model`-Auswahl angezeigt, sofern [`availableModels`](#restrict-model-selection) oder [Organisationsmodellbeschränkungen](#organization-model-restrictions) es nicht ausschließen. Wenn Ihre Organisation Fable überhaupt nicht verwenden kann, z. B. unter [Null-Datenspeicherung](https://code.claude.com/docs/de/zero-data-retention.md#model-availability-under-zdr), bleibt die Zeile in der Auswahl ausgegraut mit einer Notiz zum Grund.94Auf der Anthropic API wird ein Fable-Modell in der `/model`-Auswahl angezeigt, sofern [`availableModels`](#restrict-model-selection) oder [Organisationsmodellbeschränkungen](#organization-model-restrictions) es nicht ausschließen. Wenn Ihre Organisation Fable überhaupt nicht verwenden kann, z. B. unter [Null-Datenspeicherung](https://code.claude.com/docs/de/zero-data-retention.md#model-availability-under-zdr), bleibt die Zeile in der Auswahl ausgegraut mit einer Notiz zum Grund.

90 95

163 168

164Siehe [Model is not a recognized model id](https://code.claude.com/docs/de/errors.md#model-is-not-a-recognized-model-id) und [Model not found](https://code.claude.com/docs/de/errors.md#model-not-found) für die Meldungen.169Siehe [Model is not a recognized model id](https://code.claude.com/docs/de/errors.md#model-is-not-a-recognized-model-id) und [Model not found](https://code.claude.com/docs/de/errors.md#model-not-found) für die Meldungen.

165 170

166Wenn Sie das Modell mit dem `--model`-Flag, der `ANTHROPIC_MODEL`-Umgebungsvariable oder der `model`-Einstellung festlegen, prüft Claude Code es nicht im Voraus, und ein falsch geschriebener Wert erzeugt [There's an issue with the selected model](https://code.claude.com/docs/de/errors.md#theres-an-issue-with-the-selected-model) bei der ersten Anfrage.171Wenn Sie das Modell mit dem `--model`-Flag, der `ANTHROPIC_MODEL`-Umgebungsvariable oder der `model`-Einstellung festlegen, lehnt Claude Code einen falsch geschriebenen Wert nicht im Voraus ab. Die Sitzung startet, und die erste Anfrage erzeugt [There's an issue with the selected model](https://code.claude.com/docs/de/errors.md#theres-an-issue-with-the-selected-model). Auf der Anthropic API kann ein Wert, der nicht mit `claude-` beginnt und einem Modellnamen oder Alias sehr nahekommt, zusätzlich eine [Startwarnung erzeugen, die diesen vorschlägt](#fix-a-mistyped-model-name).

167 172

168Wenn das angeforderte Modell ein geplantes Ausmusterungsdatum hat oder automatisch einer neueren Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen sie als Starthinweis. Ab v2.1.182 wird die gleiche Warnung im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Prüfung deckt auch ein `model` ab, das im [Subagenten-Frontmatter](https://code.claude.com/docs/de/sub-agents.md) festgelegt ist. Die stderr-Warnung wird für `--output-format json` und `stream-json` unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem `modelUsage`-Feld der [Ergebnisnachricht](https://code.claude.com/docs/de/headless.md#get-structured-output).173Wenn das angeforderte Modell ein geplantes Ausmusterungsdatum hat oder automatisch einer neueren Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen sie als Starthinweis. Ab v2.1.182 wird die gleiche Warnung im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Prüfung deckt auch ein `model` ab, das im [Subagenten-Frontmatter](https://code.claude.com/docs/de/sub-agents.md) festgelegt ist. Die stderr-Warnung wird für `--output-format json` und `stream-json` unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem `modelUsage`-Feld der [Ergebnisnachricht](https://code.claude.com/docs/de/headless.md#get-structured-output).

169 174

225 230

226## Modellauswahl einschränken231## Modellauswahl einschränken

227 232

228Administratoren können `availableModels` in [verwalteten oder Richtlinieneinstellungen](https://code.claude.com/docs/de/managed-settings.md) verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Einträge entsprechen einer Modellfamilie wie `sonnet`, einem Versionspräfix wie `claude-sonnet-4-5` oder einer vollständigen Modell-ID wie `claude-sonnet-4-5-20250929`. Ein Versionspräfix entspricht auch späteren Modell-IDs, die es um ein weiteres Segment erweitern, sodass `claude-fable-5` sowohl Fable 5 als auch Fable 5.1 zulässt, während `claude-fable-5-1` nur Fable 5.1 zulässt. Um ein Modell zu blockieren, das die Liste zulässt, oder um festzulegen, dass jeder Modell-ID-Eintrag nur die genannte Version zulässt, lesen Sie [Bestimmte Modelle oder Versionen blockieren](#block-specific-models-or-versions).233Administratoren können `availableModels` in [verwalteten oder Richtlinieneinstellungen](https://code.claude.com/docs/de/managed-settings.md) verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Jeder Eintrag entspricht einem der folgenden:

234

235* Einer Modellfamilie wie `sonnet`

236* Einem Versionspräfix wie `claude-sonnet-4-5`. Es entspricht auch späteren Modell-IDs, die es um ein weiteres Segment erweitern. Beispielsweise lässt `claude-fable-5` Fable 5, Fable 5.1 und Fable 5.2 zu, während `claude-fable-5-1` nur Fable 5.1 zulässt

237* Einer vollständigen Modell-ID wie `claude-sonnet-4-5-20250929`

238

239Um ein Modell zu blockieren, das die Liste zulässt, oder um festzulegen, dass jeder Modell-ID-Eintrag nur die genannte Version zulässt, lesen Sie [Bestimmte Modelle oder Versionen blockieren](#block-specific-models-or-versions).

229 240

230Auf Plattformen, die Claude Code einbetten und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/de/env-vars) setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete `availableModels`-Allowlist in Kraft bleibt, sofern der Host keine eigene bereitstellt; [Ausnahmen vom Vorrang verwalteter Einstellungen](https://code.claude.com/docs/de/settings.md#exceptions-to-managed-settings-precedence) gibt an, welche Schlüssel und Variablen der Host überschreibt.241Auf Plattformen, die Claude Code einbetten und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/de/env-vars) setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete `availableModels`-Allowlist in Kraft bleibt, sofern der Host keine eigene bereitstellt; [Ausnahmen vom Vorrang verwalteter Einstellungen](https://code.claude.com/docs/de/settings.md#exceptions-to-managed-settings-precedence) gibt an, welche Schlüssel und Variablen der Host überschreibt.

231 242

465 476

466Wenn nichts auf Ihrem Konto gespeichert ist, verwaltete Einstellungen [die Allowlist für das Standardmodell erzwingen](#enforce-the-allowlist-for-the-default-model) und das Kontotyp-Standardmodell nicht in `availableModels` ist, wird `default` zum erzwungenen Standard aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Wenn sowohl ein Organisations-Standard als auch eine Erzwingung gelten, ersetzt der Organisations-Standard zunächst den Kontotyp-Standard und die Erzwingung wird dann darauf angewendet: Ein in der Allowlist enthaltener Organisations-Standard wird beibehalten, während einer außerhalb der Liste zum erzwungenen Standard aufgelöst wird.477Wenn nichts auf Ihrem Konto gespeichert ist, verwaltete Einstellungen [die Allowlist für das Standardmodell erzwingen](#enforce-the-allowlist-for-the-default-model) und das Kontotyp-Standardmodell nicht in `availableModels` ist, wird `default` zum erzwungenen Standard aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Wenn sowohl ein Organisations-Standard als auch eine Erzwingung gelten, ersetzt der Organisations-Standard zunächst den Kontotyp-Standard und die Erzwingung wird dann darauf angewendet: Ein in der Allowlist enthaltener Organisations-Standard wird beibehalten, während einer außerhalb der Liste zum erzwungenen Standard aufgelöst wird.

467 478

468Fable-Modelle sind auf keinem Plan oder Provider der Kontotyp-Standard. Wenn Sie eines mit `/model` auswählen, wird es als das ausgewählte Modell in Ihren Benutzereinstellungen gespeichert, sodass spätere Sitzungen damit beginnen. Für die einmalige Änderung, die Claude Code an einer gespeicherten Fable 5-Auswahl in v2.1.257 vornimmt, siehe [Mit Fable arbeiten](#work-with-fable).479> [!NOTE]

480>

481> Fable-Modelle sind auf keinem Plan oder Provider der Kontotyp-Standard. Wenn Sie eines mit `/model` auswählen, wird es als das ausgewählte Modell in Ihren Benutzereinstellungen gespeichert, sodass spätere Sitzungen damit beginnen, abgesehen von der [einmaligen Änderung an einer gespeicherten Fable 5.1-Auswahl](#work-with-fable).

469 482

470### `opusplan` Modelleinstellung483### `opusplan` Modelleinstellung

471 484

521 534

522Fable-Modelle, Opus 5.5, Sonnet 5.5 und Opus 5 laufen mit Sicherheitsklassifikatoren, die am häufigsten Cybersicherheits- und Biologie-Inhalte kennzeichnen. Für diese beiden Kategorien hängt das Fallback-Modell davon ab, welches Modell abgelehnt hat:535Fable-Modelle, Opus 5.5, Sonnet 5.5 und Opus 5 laufen mit Sicherheitsklassifikatoren, die am häufigsten Cybersicherheits- und Biologie-Inhalte kennzeichnen. Für diese beiden Kategorien hängt das Fallback-Modell davon ab, welches Modell abgelehnt hat:

523 536

524* **Fable 5.1, Fable 5 und Opus 5.5**: Biologie-gekennzeichnete Anfragen werden auf Opus 5 erneut ausgeführt, und Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt.537* **Fable-Modelle und Opus 5.5**: Biologie-gekennzeichnete Anfragen werden auf Opus 5 erneut ausgeführt, und Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt.

525* **Sonnet 5.5**: Cybersicherheits-gekennzeichnete Anfragen werden auf Sonnet 5 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Sonnet 5.5 kein Biologie-Fallback-Modell hat.538* **Sonnet 5.5**: Cybersicherheits-gekennzeichnete Anfragen werden auf Sonnet 5 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Sonnet 5.5 kein Biologie-Fallback-Modell hat.

526* **Opus 5**: Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Opus 5 seine eigenen Biologie-Klassifikatoren ohne Fallback-Modell ausführt.539* **Opus 5**: Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Opus 5 seine eigenen Biologie-Klassifikatoren ohne Fallback-Modell ausführt.

527 540

582 595

583Auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) und [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) sind Modell-IDs Provider-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code jedes beteiligte Modell identifizieren kann:596Auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) und [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) sind Modell-IDs Provider-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code jedes beteiligte Modell identifizieren kann:

584 597

585* Claude Code muss das aktuelle Modell als Fallback-Quelle erkennen. Fable 5.1 und Fable 5 werden erkannt, wenn die Modell-ID `claude-fable-5` enthält, dem Wert von `ANTHROPIC_DEFAULT_FABLE_MODEL` entspricht oder mit [`modelOverrides`](#override-model-ids-per-version) zugeordnet ist. Opus 5.5, Sonnet 5.5 und Opus 5 werden durch ihre Provider-Modell-ID oder eine [`modelOverrides`](#override-model-ids-per-version) Zuordnung erkannt.598* Claude Code muss das aktuelle Modell als Fallback-Quelle erkennen. Fable-Modelle werden erkannt, wenn die Modell-ID `claude-fable-5` enthält, dem Wert von `ANTHROPIC_DEFAULT_FABLE_MODEL` entspricht oder mit [`modelOverrides`](#override-model-ids-per-version) zugeordnet ist. Opus 5.5, Sonnet 5.5 und Opus 5 werden durch ihre Provider-Modell-ID oder eine [`modelOverrides`](#override-model-ids-per-version) Zuordnung erkannt.

586* Ein Opus-Ziel muss sich in Ihrer Bereitstellung auflösen, unabhängig davon, welches Modell abgelehnt hat: Stellen Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` ein oder behalten Sie einen Opus 4.8-Eintrag in der Modelliste des Providers. Ohne einen bleibt das Fallback für jedes Quellmodell aus, einschließlich Sonnet 5.5, und gekennzeichnete Anfragen enden mit einer Ablehnung.599* Ein Opus-Ziel muss sich in Ihrer Bereitstellung auflösen, unabhängig davon, welches Modell abgelehnt hat: Stellen Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` ein oder behalten Sie einen Opus 4.8-Eintrag in der Modelliste des Providers. Ohne einen bleibt das Fallback für jedes Quellmodell aus, einschließlich Sonnet 5.5, und gekennzeichnete Anfragen enden mit einer Ablehnung.

587* Das Fallback-Modell der gekennzeichneten Kategorie muss sich in Ihrer Bereitstellung auflösen. Von einem Fable-Modell, Opus 5.5 oder Opus 5, wenn Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` einstellen, werden gekennzeichnete Anfragen auf diesem Modell für jede Kategorie erneut ausgeführt, die ein Fallback hat; eine Biologie-Kennzeichnung auf Opus 5 endet immer noch mit einer Ablehnung. Wenn Sie es nicht einstellen, werden Cybersicherheits-gekennzeichnete Anfragen auf dem Opus 4.8-Eintrag erneut ausgeführt und Biologie-gekennzeichnete Anfragen von einem Fable-Modell oder Opus 5.5 auf einem Opus 5-Eintrag. Von Sonnet 5.5 werden Cybersicherheits-gekennzeichnete Anfragen auf dem Modell erneut ausgeführt, das Sie in `ANTHROPIC_DEFAULT_SONNET_MODEL` einstellen, oder auf einem Sonnet 5-Eintrag in der Modelliste des Providers, wenn Sie es nicht einstellen.600* Das Fallback-Modell der gekennzeichneten Kategorie muss sich in Ihrer Bereitstellung auflösen. Von einem Fable-Modell, Opus 5.5 oder Opus 5, wenn Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` einstellen, werden gekennzeichnete Anfragen auf diesem Modell für jede Kategorie erneut ausgeführt, die ein Fallback hat; eine Biologie-Kennzeichnung auf Opus 5 endet immer noch mit einer Ablehnung. Wenn Sie es nicht einstellen, werden Cybersicherheits-gekennzeichnete Anfragen auf dem Opus 4.8-Eintrag erneut ausgeführt und Biologie-gekennzeichnete Anfragen von einem Fable-Modell oder Opus 5.5 auf einem Opus 5-Eintrag. Von Sonnet 5.5 werden Cybersicherheits-gekennzeichnete Anfragen auf dem Modell erneut ausgeführt, das Sie in `ANTHROPIC_DEFAULT_SONNET_MODEL` einstellen, oder auf einem Sonnet 5-Eintrag in der Modelliste des Providers, wenn Sie es nicht einstellen.

588 601

596 609

597#### Sicherheitsforschung und Biologie-Workloads610#### Sicherheitsforschung und Biologie-Workloads

598 611

599Workloads in offensiver Sicherheit oder Biologie, einschließlich Penetrationstests, Capture the Flag (CTF)-Übungen und biologienaher Codebasen, lösen häufig Fallback aus, oft bei der ersten Anfrage. Für substantielle Biologie-Arbeit auf Fable 5.1, Fable 5 oder Opus 5.5 verschiebt die erste gekennzeichnete Anfrage, die das Modell wechselt, die Sitzung zu Opus 5, und spätere Biologie-gekennzeichnete Anfragen enden dort in Ablehnungen, da Opus 5 kein Biologie-Fallback hat. Auf Opus 5 und Sonnet 5.5 erhalten Sie diese Ablehnungen von der ersten gekennzeichneten Anfrage an.612Workloads in offensiver Sicherheit oder Biologie, einschließlich Penetrationstests, Capture the Flag (CTF)-Übungen und biologienaher Codebasen, lösen häufig Fallback aus, oft bei der ersten Anfrage. Dies ist das erwartete Routing für diese Domänen, keine Kontokennzeichnung. Wenn Ihre Organisation Fähigkeiten der Fable-Klasse für diese Arbeit benötigt, fragen Sie Ihr Anthropic-Kontoteam nach Programmen für vertrauenswürdigen Zugriff.

600 613

601Dies ist das erwartete Routing für diese Domänen, keine Kontokennzeichnung. Wenn Ihre Organisation Fähigkeiten der Fable-Klasse für diese Arbeit benötigt, fragen Sie Ihr Anthropic-Kontoteam nach Programmen für vertrauenswürdigen Zugriff.614Für substantielle Biologie-Arbeit auf einem Fable-Modell oder Opus 5.5 verschiebt die erste gekennzeichnete Anfrage, die das Modell wechselt, die Sitzung zu Opus 5. Spätere Biologie-gekennzeichnete Anfragen enden dort in Ablehnungen, da Opus 5 kein Biologie-Fallback hat. Auf Opus 5 und Sonnet 5.5 beginnen diese Ablehnungen mit der ersten gekennzeichneten Anfrage.

602 615

603### Effort-Stufe anpassen616### Effort-Stufe anpassen

604 617

608 621

609| Modell | Stufen |622| Modell | Stufen |

610| :- | :- |623| :- | :- |

614 627

6202. Eine Stufe, die Sie in der Sitzung auswählen, etwa mit `/effort`, dem `/model` Picker oder [`applyFlagSettings()`](https://code.claude.com/docs/de/agent-sdk/typescript#applyflagsettings)6332. Eine Stufe, die Sie in der Sitzung auswählen, etwa mit `/effort`, dem `/model` Picker oder [`applyFlagSettings()`](https://code.claude.com/docs/de/agent-sdk/typescript#applyflagsettings)

6213. Start mit `--effort`6343. Start mit `--effort`

6224. Ihre Einstellungen: die Stufe, die Sie für das Modell gespeichert haben, oder ein [`effortLevel`](https://code.claude.com/docs/de/settings-reference#effortlevel) Schlüssel, mit dem Vorrang zwischen ihnen und über Einstellungsdateien hinweg, wie unter [`modelSettings`](https://code.claude.com/docs/de/settings-reference#modelsettings) angegeben6354. Ihre Einstellungen: die Stufe, die Sie für das Modell gespeichert haben, oder ein [`effortLevel`](https://code.claude.com/docs/de/settings-reference#effortlevel) Schlüssel, mit dem Vorrang zwischen ihnen und über Einstellungsdateien hinweg, wie unter [`modelSettings`](https://code.claude.com/docs/de/settings-reference#modelsettings) angegeben

6235. Der Standard-Effort des Modells: `high` auf jedem Modell, das Effort unterstützt, außer dass Opus 5.5, Sonnet 5.5 und Haiku 5.5 standardmäßig `medium` verwenden und Opus 4.7 standardmäßig `xhigh` verwendet. Wenn Ihre Organisation eine Standard-Effort-Stufe für ihr [Organisations-Standardmodell](#organization-default-model) festlegt, ist diese Stufe der Standard, wenn Sie dieses Modell ausführen.6365. Der Standard-Effort des Modells: Fable 5.2, Opus 5.5, Sonnet 5.5 und Haiku 5.5 verwenden standardmäßig `medium`, und Opus 4.7 verwendet standardmäßig `xhigh`. Andere Modelle in der [Tabelle der Effort-Stufen](#adjust-effort-level) verwenden standardmäßig `high`. Wenn Ihre Organisation eine Standard-Effort-Stufe für ihr [Organisations-Standardmodell](#organization-default-model) festlegt, ist diese Stufe der Standard, wenn Sie dieses Modell ausführen.

624 637

625Nach einem automatischen Modell-Fallback siehe [Effort-Stufe nach einem Fallback](#effort-level-after-a-fallback) für die geltende Stufe. Für Subagenten und Teammates siehe [Effort-Stufe von Subagenten und Teammates](#effort-level-of-subagents-and-teammates).638Nach einem automatischen Modell-Fallback siehe [Effort-Stufe nach einem Fallback](#effort-level-after-a-fallback) für die geltende Stufe. Für Subagenten und Teammates siehe [Effort-Stufe von Subagenten und Teammates](#effort-level-of-subagents-and-teammates).

626 639

671| Stufe | Wann man sie verwendet |684| Stufe | Wann man sie verwendet |

672| :- | :- |685| :- | :- |

673| `low` | Schnelle Austausche, bei denen Sie jedes Ergebnis überprüfen, wie Brainstorming, eine erste Skizze oder eine kleine Änderung wie eine Umbenennung |686| `low` | Schnelle Austausche, bei denen Sie jedes Ergebnis überprüfen, wie Brainstorming, eine erste Skizze oder eine kleine Änderung wie eine Umbenennung |

674| `medium` | Der Standard auf Opus 5.5, Sonnet 5.5 und Haiku 5.5. Auf Opus 5.5 und Sonnet 5.5 passt er zu alltäglicher Entwicklungsarbeit mit klarem Umfang, wie der Implementierung einer neuen Funktion. Auf Modellen mit einem höheren Standard reduziert er die Token-Nutzung für kostensensible Arbeit, die etwas Intelligenz opfern kann |687| `medium` | Der Standard auf den Modellen Fable 5.2, Opus 5.5, Sonnet 5.5 und Haiku 5.5. Auf Opus 5.5 und Sonnet 5.5 passt er zu alltäglicher Entwicklungsarbeit mit klarem Umfang, wie der Implementierung einer neuen Funktion. Auf Modellen mit einem höheren Standard reduziert er die Token-Nutzung für kostensensible Arbeit, die etwas Intelligenz opfern kann |

675| `high` | Arbeit, bei der Überprüfung wichtig ist oder Grenzfälle wahrscheinlich sind, wie das Beheben eines Fehlers in einer bestehenden Codebasis. Der Standard auf jedem Modell außer Opus 5.5, Sonnet 5.5, Haiku 5.5 und Opus 4.7 |688| `high` | Arbeit, bei der Überprüfung wichtig ist oder Grenzfälle wahrscheinlich sind, wie das Beheben eines Fehlers in einer bestehenden Codebasis. Der Standard auf den anderen Modellen in der Effort-Tabelle |

677| `max` | Schwierige Probleme, die Claude ohne Sie durcharbeiten soll, wie das Finden von Sicherheitslücken. `max` kann abnehmende Erträge zeigen und neigt zum Überdenken, daher testen Sie es, bevor Sie es breit einführen |690| `max` | Schwierige Probleme, die Claude ohne Sie durcharbeiten soll, wie das Finden von Sicherheitslücken. `max` kann abnehmende Erträge zeigen und neigt zum Überdenken, daher testen Sie es, bevor Sie es breit einführen |

678| `ultracode` | Eine Claude Code-Einstellung statt einer Stufe: plant einen [dynamischen Workflow](https://code.claude.com/docs/de/workflows.md) für jede substantielle Aufgabe auf jeder Effort-Stufe |691| `ultracode` | Eine Claude Code-Einstellung statt einer Stufe: plant einen [dynamischen Workflow](https://code.claude.com/docs/de/workflows.md) für jede substantielle Aufgabe auf jeder Effort-Stufe |

691 704

692* Geben Sie es erneut außerhalb von Elementen wie Anführungszeichen, Klammern, einem Pfad oder einem Befehl ein, in einem Prompt, der nicht mit `/` beginnt705* Geben Sie es erneut außerhalb von Elementen wie Anführungszeichen, Klammern, einem Pfad oder einem Befehl ein, in einem Prompt, der nicht mit `/` beginnt

693* Entfernen Sie `CLAUDE_CODE_EFFORT_LEVEL`, wenn die Variable unter `xhigh` gesetzt ist, erhöhen Sie Ihr eigenes [`maxEffortLevel`](https://code.claude.com/docs/de/settings-reference#maxeffortlevel) auf `xhigh` oder höher, oder bitten Sie einen Admin Ihrer Organisation, das [Limit Ihrer Organisation](#organization-effort-limits) anzuheben706* Entfernen Sie `CLAUDE_CODE_EFFORT_LEVEL`, wenn die Variable unter `xhigh` gesetzt ist, erhöhen Sie Ihr eigenes [`maxEffortLevel`](https://code.claude.com/docs/de/settings-reference#maxeffortlevel) auf `xhigh` oder höher, oder bitten Sie einen Admin Ihrer Organisation, das [Limit Ihrer Organisation](#organization-effort-limits) anzuheben

694* Führen Sie `/model` in Ihrer Sitzung aus, um zu einem Opus 5.5-, Sonnet 5.5-, Haiku 5.5- oder Fable 5.1-Modell zu wechseln. Wo das Wort einen Turn nicht anheben kann, etwa auf Amazon Bedrock, [stellen Sie stattdessen die Effort-Stufe ein](#set-the-effort-level)707* Führen Sie `/model` in Ihrer Sitzung aus, um zu einem Opus 5.5-, Sonnet 5.5-, Haiku 5.5-, Fable 5.2- oder Fable 5.1-Modell zu wechseln. Wo das Wort einen Turn nicht anheben kann, etwa auf Amazon Bedrock, [stellen Sie stattdessen die Effort-Stufe ein](#set-the-effort-level)

695 708

696#### Stellen Sie die Effort-Stufe ein709#### Stellen Sie die Effort-Stufe ein

697 710

767 780

768### Erweiterter Kontext781### Erweiterter Kontext

769 782

770Fable 5.1, Fable 5, Sonnet 5 und später, Haiku 5.5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen ein [Kontextfenster mit 1 Million Token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen mit großen Codebasen.783Lange Sitzungen mit großen Codebasen können ein [Kontextfenster mit 1 Million Token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) nutzen. Fable-Modelle, Sonnet 5 und später, Haiku 5.5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen es.

771 784

772Fable 5.1, Fable 5, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später laufen standardmäßig mit dem 1M-Fenster, ohne dass ein `[1m]` Suffix nötig ist. Das schließt Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry sowie Sitzungen über das [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway) ein. Um sie stattdessen mit einem 200K-Fenster auszuführen, siehe [1M-Kontext ausschalten](#turn-off-1m-context).785Fable-Modelle, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später laufen standardmäßig mit dem 1M-Fenster, ohne dass ein `[1m]` Suffix nötig ist. Das schließt Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry sowie Sitzungen über das [Claude apps gateway](https://code.claude.com/docs/de/claude-apps-gateway) ein. Um sie stattdessen mit einem 200K-Fenster auszuführen, siehe [1M-Kontext ausschalten](#turn-off-1m-context).

773 786

774Opus 4.6 und Sonnet 4.6 erreichen 1M nur durch ihre `[1m]` Variante, und der Zugriff auf diese Variante hängt von Ihrem Plan ab. Auf Max-, Ultra-, Team- und Enterprise-Plänen, einschließlich sowohl Team Standard als auch Team Premium Plätze, ist Opus 4.6 mit 1M-Kontext in Ihrem Abonnement enthalten. Sonnet 4.6 mit 1M-Kontext erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) auf jedem Abonnementplan, einschließlich Max und Ultra.787Opus 4.6 und Sonnet 4.6 erreichen 1M nur durch ihre `[1m]` Variante, und der Zugriff auf diese Variante hängt von Ihrem Plan ab. Auf Max-, Ultra-, Team- und Enterprise-Plänen, einschließlich sowohl Team Standard als auch Team Premium Plätze, ist Opus 4.6 mit 1M-Kontext in Ihrem Abonnement enthalten. Sonnet 4.6 mit 1M-Kontext erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) auf jedem Abonnementplan, einschließlich Max und Ultra.

775 788

798 811

799#### Kontextfenster hinter einem LLM-Gateway812#### Kontextfenster hinter einem LLM-Gateway

800 813

801Wenn Sie `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) oder einen anderen Proxy setzen, gibt Claude Code jedem Modell, das es erkennt, das gleiche Kontextfenster, das das Modell auf der Anthropic API hat. Fable 5.1, Fable 5, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später erhalten das 1M-Fenster, ohne dass eine `[1m]` Variante ausgewählt werden muss, und ein Modell, das 1M nur über seine `[1m]` Variante erreicht, wie Opus 4.6, läuft ohne sie mit 200K. Claude Code kann ein niedrigeres Limit, das das Gateway oder der dahinterliegende Server erzwingt, nicht erkennen. Wenn Ihr Gateway Anfragen über 200K Token ablehnt, setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/de/env-vars) in der Umgebung, die Claude Code startet, damit Sitzungen auf jedem Modell [an dieser Grenze komprimieren](#set-the-auto-compact-window).814Wenn Sie `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) oder einen anderen Proxy setzen, gibt Claude Code jedem Modell, das es erkennt, das gleiche Kontextfenster, das das Modell auf der Anthropic API hat. Fable-Modelle, Sonnet 5 und später, Haiku 5.5 sowie Opus 4.7 und später erhalten das 1M-Fenster ohne `[1m]` Variante. Ein Modell, das 1M nur über seine `[1m]` Variante erreicht, wie Opus 4.6, läuft ohne sie mit 200K.

815

816Claude Code kann ein niedrigeres Limit, das das Gateway oder der dahinterliegende Server erzwingt, nicht erkennen. Wenn Ihr Gateway Anfragen über 200K Token ablehnt, setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/de/env-vars) in der Umgebung, die Claude Code startet, damit Sitzungen auf jedem Modell [an dieser Grenze komprimieren](#set-the-auto-compact-window).

802 817

803#### 1M-Kontext ausschalten818#### 1M-Kontext ausschalten

804 819

885 900

886Sobald Claude Code die ID erkennt oder das von Ihnen angegebene Fenster verwendet, erscheint die Warnung nicht mehr, wenn Sie eine Sitzung mit dieser ID starten.901Sobald Claude Code die ID erkennt oder das von Ihnen angegebene Fenster verwendet, erscheint die Warnung nicht mehr, wenn Sie eine Sitzung mit dieser ID starten.

887 902

903#### Falsch geschriebenen Modellnamen korrigieren

904

905Jede dieser beiden Warnungen bedeutet, dass Claude Code die von Ihnen festgelegte Modell-ID nicht erkennt und die ID beinahe einem Modellnamen oder Alias entspricht, den es erkennt:

906

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911

912* **Sie haben die ID falsch geschrieben**: Ändern Sie sie in den Vorschlag, [wo auch immer Sie das Modell festlegen](#setting-your-model)

913* **Die ID ist beabsichtigt**: Lassen Sie sie unverändert. Die Sitzung sendet sie so, wie Sie sie geschrieben haben. Wenn das Kontextfenster, das Claude Code dafür annimmt, falsch ist, [korrigieren Sie das Fenster](#correct-the-window-for-a-gateway-or-custom-model-id)

914

888#### Für welche IDs `CLAUDE_CODE_MAX_CONTEXT_TOKENS` gilt915#### Für welche IDs `CLAUDE_CODE_MAX_CONTEXT_TOKENS` gilt

889 916

890Bei einem [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) oder einer anderen benutzerdefinierten Bereitstellung kann Claude Code ein Kontextfenster für die Modell-ID annehmen, das sich vom echten Fenster des Modells unterscheidet, unabhängig davon, ob es die ID zu einem Claude-Modell auflöst oder nicht. Setzen Sie [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/de/env-vars) auf das Fenster, das Claude Code stattdessen annehmen sollte.917Bei einem [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) oder einer anderen benutzerdefinierten Bereitstellung kann Claude Code ein Kontextfenster für die Modell-ID annehmen, das sich vom echten Fenster des Modells unterscheidet, unabhängig davon, ob es die ID zu einem Claude-Modell auflöst oder nicht. Setzen Sie [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/de/env-vars) auf das Fenster, das Claude Code stattdessen annehmen sollte.

1100 1127

1101| Version | Änderung |1128| Version | Änderung |

1102| :- | :- |1129| :- | :- |

1130| v2.1.321 | `fable` wird zu Fable 5.2 aufgelöst, außer in Claude Apps Gateway-Sitzungen |

1131| v2.1.321 | `best` wird zu demselben Modell wie `opus` aufgelöst. Frühere Versionen verwenden das Modell, zu dem `fable` aufgelöst wird, sofern Fable verfügbar ist |

1103| v2.1.293 | `haiku` wird zu Haiku 5.5 auf der Anthropic API aufgelöst |1132| v2.1.293 | `haiku` wird zu Haiku 5.5 auf der Anthropic API aufgelöst |

1104| v2.1.284 | `sonnet` wird zu Sonnet 5.5 auf der Anthropic API aufgelöst |1133| v2.1.284 | `sonnet` wird zu Sonnet 5.5 auf der Anthropic API aufgelöst |

1105| v2.1.280 | `opus` wird zu Opus 5.5 auf der Anthropic API, Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform aufgelöst |1134| v2.1.280 | `opus` wird zu Opus 5.5 auf der Anthropic API, Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform aufgelöst |

permissions.md +2 −1

Details

253| :- | :- | :- |253| :- | :- | :- |

257 257

258Ihre anderen Regeln und der Berechtigungsmodus entscheiden über die Befehle in der letzten Spalte.258Ihre anderen Regeln und der Berechtigungsmodus entscheiden über die Befehle in der letzten Spalte.

259 259

273* **`docker` mit Verweis auf einen anderen Daemon**: Bei nur lesenden Formen von `docker` wird nachgefragt, wenn der Befehl ein Flag enthält, das einen anderen Daemon auswählt, wie `-H`, `--context` oder die Podman-Flags `--url` und `--connection`.273* **`docker` mit Verweis auf einen anderen Daemon**: Bei nur lesenden Formen von `docker` wird nachgefragt, wenn der Befehl ein Flag enthält, das einen anderen Daemon auswählt, wie `-H`, `--context` oder die Podman-Flags `--url` und `--connection`.

274* **`file` mit Flags, die Pfade öffnen**: Bei `file` wird nachgefragt, wenn es `-m`/`--magic-file` oder `-f`/`--files-from` übergibt, da diese Flags `file` dazu veranlassen, die im Wert des Flags genannten Pfade zu öffnen.274* **`file` mit Flags, die Pfade öffnen**: Bei `file` wird nachgefragt, wenn es `-m`/`--magic-file` oder `-f`/`--files-from` übergibt, da diese Flags `file` dazu veranlassen, die im Wert des Flags genannten Pfade zu öffnen.

275* **`ps`, das Umgebungsvariablen ausgeben könnte**: Bei `ps` wird nachgefragt, wenn eines seiner Argumente als Option `e` wirken könnte, wie in `ps auxe` oder `ps aux -e`, da diese Option die Umgebungsvariablen von Prozessen ausgibt. `ps aux` und `ps -ef` laufen ohne Abfrage. Die Prüfung von Formen mit Bindestrich wie `ps aux -e` erfordert Claude Code v2.1.290 oder höher.275* **`ps`, das Umgebungsvariablen ausgeben könnte**: Bei `ps` wird nachgefragt, wenn eines seiner Argumente als Option `e` wirken könnte, wie in `ps auxe` oder `ps aux -e`, da diese Option die Umgebungsvariablen von Prozessen ausgibt. `ps aux` und `ps -ef` laufen ohne Abfrage. Die Prüfung von Formen mit Bindestrich wie `ps aux -e` erfordert Claude Code v2.1.290 oder höher.

276* **`which` mit Flags, die über Nachschlagen und Anzeigen hinausgehen**: Bei `which` wird nachgefragt, wenn es ein Flag wie `-i`/`--read-alias` oder `--read-functions` übergibt. `which node` und `which -a node` laufen ohne Abfrage.

276* **Netzwerkpfade unter Windows**: Bei einem Befehl, dessen Argumente einen Netzwerkpfad (UNC-Pfad) wie `\\server\share\file` enthalten, wird nachgefragt, da der Zugriff auf einen Netzwerkpfad Ihre Windows-Anmeldedaten an den genannten Host senden kann. Dieselbe Prüfung gilt für Befehle des [PowerShell-Tools](https://code.claude.com/docs/de/tools-reference.md#powershell-tool).277* **Netzwerkpfade unter Windows**: Bei einem Befehl, dessen Argumente einen Netzwerkpfad (UNC-Pfad) wie `\\server\share\file` enthalten, wird nachgefragt, da der Zugriff auf einen Netzwerkpfad Ihre Windows-Anmeldedaten an den genannten Host senden kann. Dieselbe Prüfung gilt für Befehle des [PowerShell-Tools](https://code.claude.com/docs/de/tools-reference.md#powershell-tool).

277* **Schreibzugriffe auf spezielle Shell-Variablen**: Bei einem Befehl, der bestimmte spezielle Shell-Variablen wie `PATH` oder `IFS` setzt, zurücksetzt oder über sie iteriert, wird nachgefragt, auch wenn der Rest des Befehls nur lesend ist.278* **Schreibzugriffe auf spezielle Shell-Variablen**: Bei einem Befehl, der bestimmte spezielle Shell-Variablen wie `PATH` oder `IFS` setzt, zurücksetzt oder über sie iteriert, wird nachgefragt, auch wenn der Rest des Befehls nur lesend ist.

278* **Befehle, die die Analyse nicht parsen kann**: Wenn Claude Code einen Befehl nicht vollständig parsen kann, bittet es um Genehmigung, anstatt den Befehl als nur lesend zu behandeln. Bei Befehlen mit mehr als 10.000 Zeichen wird immer nachgefragt, da sie den Umfang überschreiten, den die Analyse parst.279* **Befehle, die die Analyse nicht parsen kann**: Wenn Claude Code einen Befehl nicht vollständig parsen kann, bittet es um Genehmigung, anstatt den Befehl als nur lesend zu behandeln. Bei Befehlen mit mehr als 10.000 Zeichen wird immer nachgefragt, da sie den Umfang überschreiten, den die Analyse parst.

plugins/mods/events.md +1 −1

Details

279* **Ihr Hook gibt ein `drop` zurück, nachdem sein Aufruf von `next(e)` den Prompt durchgelassen hat**: Der Turn wird trotzdem ausgeführt, und der Hook [schlägt fehl](#handle-a-hook-that-fails), mit einer Meldung, die `a drop after its next() was answered` enthält279* **Ihr Hook gibt ein `drop` zurück, nachdem sein Aufruf von `next(e)` den Prompt durchgelassen hat**: Der Turn wird trotzdem ausgeführt, und der Hook [schlägt fehl](#handle-a-hook-that-fails), mit einer Meldung, die `a drop after its next() was answered` enthält

280* **Ihr Hook löst einen Fehler aus oder überschreitet das Zeitlimit**: Claude Code überspringt ihn und sendet den Prompt. [Fügen Sie einen `.catch`-Handler hinzu](#handle-a-hook-that-fails), damit ein Fehler keinen Prompt sendet, den der Hook gestoppt hätte.280* **Ihr Hook löst einen Fehler aus oder überschreitet das Zeitlimit**: Claude Code überspringt ihn und sendet den Prompt. [Fügen Sie einen `.catch`-Handler hinzu](#handle-a-hook-that-fails), damit ein Fehler keinen Prompt sendet, den der Hook gestoppt hätte.

281 281

282[Weitere Events](https://code.claude.com/docs/de/plugins/mods/reference.md#prompts-and-what-claude-reads) decken den Rest dessen ab, was Claude liest: `prompt.section` für jeden Abschnitt des System-Prompts, `prompt.context` für den mit der ersten Nachricht gesendeten Kontext und `skill.prompt` für den Text eines Skills. Text aus diesen Hooks, der sich zwischen Anfragen ändert, [macht den Prompt-Cache ungültig](https://code.claude.com/docs/de/prompt-caching.md). In einem `skill.prompt`-Hook können Sie außerdem auslesen, [aus welchem Plugin oder welcher Datei der Skill stammt](https://code.claude.com/docs/de/plugins/mods/reference.md#skill-prompt-fields).282[Weitere Events](https://code.claude.com/docs/de/plugins/mods/reference.md#prompts-and-what-claude-reads) decken den Rest dessen ab, was Claude liest: `prompt.section` für jeden Abschnitt des System-Prompts, `prompt.context` für den mit der ersten Nachricht gesendeten Kontext und `skill.prompt` für den Text eines Skills. Um einen Abschnitt zu ändern, nachdem eine Konversation begonnen hat, lesen Sie [Einen geänderten Abschnitt des System-Prompts oder eine geänderte Tool-Beschreibung senden](https://code.claude.com/docs/de/plugins/mods/reference.md#break-prompt-cache). In einem `skill.prompt`-Hook können Sie außerdem auslesen, [aus welchem Plugin oder welcher Datei der Skill stammt](https://code.claude.com/docs/de/plugins/mods/reference.md#skill-prompt-fields).

283 283

284### Einen Turn verfolgen284### Einen Turn verfolgen

285 285

plugins/mods/interface.md +87 −0

Details

197>197>

198> Um im Band zu zeichnen, filtern Sie auf `{ component: 'AbovePrompt' }`.198> Um im Band zu zeichnen, filtern Sie auf `{ component: 'AbovePrompt' }`.

199 199

200Ein Mod kann außerdem [eine eigene Zeile im Transkript platzieren](#place-a-row-in-the-transcript).

201

200### Ändern, was Claude Code bereits zeichnet202### Ändern, was Claude Code bereits zeichnet

201 203

202Claude Code zeichnet den Großteil seiner Oberfläche selbst: Nachrichten, Zeilen für Tool-Aufrufe, den Spinner und mehr. Jeder dieser Teile ist ebenfalls eine Render-Stelle, sodass ein Mod ihn umgestalten oder ersetzen kann. Um einen davon zu ändern, filtern Sie Ihren `ui.render`-Hook auf seinen Namen aus dieser Tabelle:204Claude Code zeichnet den Großteil seiner Oberfläche selbst: Nachrichten, Zeilen für Tool-Aufrufe, den Spinner und mehr. Jeder dieser Teile ist ebenfalls eine Render-Stelle, sodass ein Mod ihn umgestalten oder ersetzen kann. Um einen davon zu ändern, filtern Sie Ihren `ui.render`-Hook auf seinen Namen aus dieser Tabelle:

349* **Prompt-Vorschläge**: `$.prompt.suggest` wird mit `isShown: false` aufgelöst und zeigt nichts an, da das Panel den abgeblendeten Vorschlagstext des Prompt-Eingabefelds für Claudes eigene Vorschläge reserviert.351* **Prompt-Vorschläge**: `$.prompt.suggest` wird mit `isShown: false` aufgelöst und zeigt nichts an, da das Panel den abgeblendeten Vorschlagstext des Prompt-Eingabefelds für Claudes eigene Vorschläge reserviert.

350* **Textlimits**: Das Panel kürzt eine Statuszeile nach 200 Zeichen oder zwei Zeilen und einen Toast nach 500 Zeichen.352* **Textlimits**: Das Panel kürzt eine Statuszeile nach 200 Zeichen oder zwei Zeilen und einen Toast nach 500 Zeichen.

351 353

354### Eine Zeile im Transkript platzieren

355

356Eine Zeile ist eine Zeile, die Ihr Mod im Terminal nach der neuesten Nachricht zum Transkript hinzufügt. Sie bleibt an dieser Stelle, während die Konversation weitergeht, und Claude sieht sie nicht. `$.ui.place` erfordert Claude Code v2.1.314 oder höher.

357

358**1. Die Zeile platzieren**

359

360Rufen Sie [`$.ui.place`](https://code.claude.com/docs/de/plugins/mods/reference#mods-api-methods) mit einer `id` auf. Die `id` ist ein Name, den Sie sich für die Zeile ausdenken, etwa `build-status`. Sie kann aus 1 bis 64 Buchstaben, Ziffern, `_` oder `-` bestehen, und jede Zeile, die Ihr Mod im Transkript hat, benötigt ihre eigene.

361

362**2. Die Zeile zeichnen**

363

364Zeichnen Sie die Zeile an der Render-Stelle [`Placed`](https://code.claude.com/docs/de/plugins/mods/reference#render-sites).

365

366Dieses Beispiel fügt einen Befehl `/build-status` hinzu. Wenn der Benutzer den Befehl ausführt, fügt der Mod eine Zeile hinzu, die `Build: passing` anzeigt. Der Text ist fest vorgegeben, um das Beispiel kurz zu halten; ein echter Mod würde sein eigenes Ergebnis zeichnen:

367

368```javascript theme={null}

369export function register(on) {

370 on('session.start', async ($, e, next) => {

371 await $.command.register({ name: 'build-status', description: 'Show the build status' })

372 return next(e)

373 })

374

375 on('command.run', { command: 'build-status' }, async ($) => {

376 const placed = await $.ui.place({ id: 'build-status' })

377 // Where nothing draws the row, reply with text instead

378 return placed.isPlaced ? {} : { text: 'Build: passing' }

379 })

380

381 on('ui.render', { component: 'Placed' }, async ($, e, next) => {

382 // This hook runs for every mod's rows, and another mod can use the same id

383 if (e.props.plugin !== $.plugin.name || e.props.id !== 'build-status') return next(e)

384 const { Text } = $.ui.resolve(e)

385 return Text({ children: ['Build: passing'] })

386 })

387}

388```

389

390Um das Beispiel auszuprobieren, fügen Sie diesen Code in einen [Mod](https://code.claude.com/docs/de/plugins/mods/create.md) ein. Führen Sie in einer Terminal-Sitzung `/build-status` am Claude Code-Prompt aus. `Build: passing` erscheint als Zeile am Ende des Transkripts.

391

392Der Aufruf zeigt nicht immer eine Zeile an, und eine Zeile kann später wieder verschwinden. Behandeln Sie daher diese Fälle in Ihrem Mod:

393

394* **Das Ergebnis**: `{ isPlaced: true, requestId }`, wenn das Terminal die Zeile zeichnet. Andernfalls ist `isPlaced` `false`, und `reason` gibt den Grund an, etwa `no attached surface draws placed rows yet`. Ein möglicher Grund ist das [Limit für Zeilen](https://code.claude.com/docs/de/plugins/mods/reference.md#limits), die ein Mod gleichzeitig haben kann.

395* **Ein zweiter Aufruf mit derselben `id`**: Solange sich die erste Zeile noch im Transkript befindet, fügt der Aufruf keine Zeile hinzu und wird mit der `requestId` dieser Zeile aufgelöst. Um zu ändern, was die Zeile anzeigt, [zeichnen Sie die Zeile neu](#redraw-when-something-changes).

396* **Wann die Zeile verschwindet**: wenn die Konversation endet, wenn der Benutzer über die Zeile hinaus zurückspult oder, außerhalb des [Vollbild-Renderings](https://code.claude.com/docs/de/fullscreen.md), wenn die Konversation komprimiert wird. `--resume` bringt die Zeile nicht zurück. Um die Zeile erneut anzuzeigen, rufen Sie `$.ui.place` erneut auf.

397

398### Einen Hintergrund hinter die Konversation legen

399

400> [!NOTE]

401>

402> `$.theme.set` und `$.theme.clear` ersetzen `$.ui.backdrop`, das in Claude Code v2.1.319 entfernt wurde. Ändern Sie `$.ui.backdrop({ id: 'your-backdrop' })` in `$.theme.set({ backdrop: { id: 'your-backdrop' } })` und `$.ui.backdrop(undefined)` in `$.theme.clear()`, das den Hintergrund jedes Mods entfernt.

403

404Um in der Desktop-App oder der mobilen App einen Hintergrund hinter die Konversation zu legen, rufen Sie [`$.theme.set`](https://code.claude.com/docs/de/plugins/mods/reference#mods-api-methods) mit einem `backdrop` auf und zeichnen Sie den Hintergrund dann an der Render-Stelle [`Backdrop`](https://code.claude.com/docs/de/plugins/mods/reference#render-sites). Um den Hintergrund zu entfernen, rufen Sie `$.theme.clear()` auf. Das Terminal zeichnet keinen Hintergrund. `$.theme.set` und `$.theme.clear` erfordern Claude Code v2.1.319 oder höher.

405

406Dieser Mod setzt beim Start der Sitzung einen Hintergrund, zeichnet den Hintergrund und fügt einen Befehl `/plain` hinzu, der den Hintergrund entfernt:

407

408```javascript theme={null}

409export function register(on) {

410 // Neither a reload of this mod nor --resume keeps the backdrop, so set it here

411 on('session.start', async ($, e, next) => {

412 await $.theme.set({ backdrop: { id: 'night-sky', colorScheme: 'dark' } })

413 await $.command.register({ name: 'plain', description: 'Take the backdrop off' })

414 return next(e)

415 })

416

417 on('ui.render', { component: 'Backdrop' }, async ($, e, next) => {

418 // This hook runs for every mod's backdrop, and another mod can use the same id

419 if (e.props.plugin !== $.plugin.name || e.props.id !== 'night-sky') return next(e)

420 const { Box, Text } = $.ui.resolve(e)

421 return Box({ backgroundColor: 'blue', children: [Text({ children: ['Night sky'] })] })

422 })

423

424 on('command.run', { command: 'plain' }, async ($) => {

425 const cleared = await $.theme.clear()

426 return { text: cleared.reason }

427 })

428}

429```

430

431Um das Beispiel auszuprobieren, fügen Sie diesen Code in einen [Mod](https://code.claude.com/docs/de/plugins/mods/create.md) ein und starten Sie eine Sitzung in der Desktop-App oder der mobilen App. Um den Hintergrund zu entfernen, führen Sie `/plain` am Claude Code-Prompt aus. Das Transkript zeigt `the theme is cleared` nach dem Namen des Mods an, etwa `night-sky: the theme is cleared` für einen Mod namens `night-sky`.

432

433Prüfen Sie, was `backdrop` akzeptiert, was Ihnen das Ergebnis des Aufrufs mitteilt und was andere Mods ändern können:

434

435* **Die Felder von `backdrop`**: `id`, ein von Ihnen gewählter [Name](https://code.claude.com/docs/de/plugins/mods/reference.md#limits), ist erforderlich, die übrigen Felder sind optional. `colorScheme` ist `'light'` oder `'dark'` und gibt an, ob Ihre Darstellung hell oder dunkel ist. Zu `glass` siehe [die Typen für Ihren Build](https://code.claude.com/docs/de/plugins/mods/create.md#get-the-types-for-your-build).

436* **Ob der Hintergrund gezeichnet wird**: `$.theme.set` wird mit `isDrawn: true` aufgelöst, wenn eine mit der Sitzung verbundene Desktop- oder mobile App meldet, dass sie Hintergründe zeichnet. Andernfalls ist `isDrawn` `false`, und `reason` gibt den Grund an.

437* **Ein Hintergrund pro Sitzung**: Ein Aufruf von `$.theme.set` ersetzt den Hintergrund der Sitzung, und `$.theme.clear()` entfernt diesen Hintergrund, unabhängig davon, welcher Mod ihn gesetzt hat. Rufen Sie `$.theme.clear()` nur auf, wenn der Benutzer dies verlangt.

438

352## Einen Baum aus Elementen erstellen439## Einen Baum aus Elementen erstellen

353 440

354Was ein `ui.render`-Hook zurückgibt, ist ein Elementbaum: eine Beschreibung dessen, was gezeichnet werden soll, bestehend aus Boxen, Text und Steuerelementen, die ineinander verschachtelt sind. Sie beschreiben die Zeichnung, und Claude Code rendert sie in der App, die der Benutzer geöffnet hat: im Terminal, in der Desktop-App oder in der VS Code-Erweiterung.441Was ein `ui.render`-Hook zurückgibt, ist ein Elementbaum: eine Beschreibung dessen, was gezeichnet werden soll, bestehend aus Boxen, Text und Steuerelementen, die ineinander verschachtelt sind. Sie beschreiben die Zeichnung, und Claude Code rendert sie in der App, die der Benutzer geöffnet hat: im Terminal, in der Desktop-App oder in der VS Code-Erweiterung.

plugins/mods/reference.md +14 −4

Details

57| :- | :- | :- |57| :- | :- | :- |

58| [`tool.call`](https://code.claude.com/docs/de/plugins/mods/events#guard-or-change-a-tool-call) | Ein Tool gleich ausgeführt wird | `next(e)`, `{ deny: reason }` oder `{ result }` |58| [`tool.call`](https://code.claude.com/docs/de/plugins/mods/events#guard-or-change-a-tool-call) | Ein Tool gleich ausgeführt wird | `next(e)`, `{ deny: reason }` oder `{ result }` |

59| [`tool.check`](https://code.claude.com/docs/de/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code entscheidet, ob ein Tool-Aufruf ausgeführt werden darf, nach den Hooks `tool.call` und `PreToolUse`. `next(e)` wird zu der Entscheidung aufgelöst, zu der die Regeln, der Berechtigungsmodus und diese Hooks gelangt sind. | `next(e)` oder `{ decision }`, wobei `decision` auf `allow`, `ask` oder `deny` gesetzt ist, mit einem optionalen `reason` |59| [`tool.check`](https://code.claude.com/docs/de/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code entscheidet, ob ein Tool-Aufruf ausgeführt werden darf, nach den Hooks `tool.call` und `PreToolUse`. `next(e)` wird zu der Entscheidung aufgelöst, zu der die Regeln, der Berechtigungsmodus und diese Hooks gelangt sind. | `next(e)` oder `{ decision }`, wobei `decision` auf `allow`, `ask` oder `deny` gesetzt ist, mit einem optionalen `reason` |

60| `tool.describe` | Einmal für jedes Tool, wenn seine Beschreibung zum ersten Mal an Claude gesendet wird. Ein zweites Mal für ein MCP-Tool, wenn Claude es über die [Tool-Suche](https://code.claude.com/docs/de/mcp.md#scale-with-mcp-tool-search) lädt, wobei `e.description` auf den Text gesetzt ist, den Claude für das geladene Tool liest. | `{ description }`, optional mit `isDeferred` auf `true` gesetzt, um das Tool hinter die Tool-Suche zu stellen, oder auf `false`, um es vorab zu laden |60| `tool.describe` | Einmal für jedes Tool, wenn seine Beschreibung zum ersten Mal an Claude gesendet wird. Ein zweites Mal für ein MCP-Tool, wenn Claude es über die [Tool-Suche](https://code.claude.com/docs/de/mcp.md#scale-with-mcp-tool-search) lädt, wobei `e.description` auf den Text gesetzt ist, den Claude für das geladene Tool liest. | `{ description }`, optional mit `isDeferred` auf `true` gesetzt, um das Tool hinter die Tool-Suche zu stellen, oder auf `false`, um es vorab zu laden. Fügen Sie [`breakPromptCache: true`](#break-prompt-cache) hinzu, um im nächsten Turn eine geänderte Beschreibung zu senden. |

61 61

62#### Agenten- und Organisationsfelder in `tool.check`62#### Agenten- und Organisationsfelder in `tool.check`

63 63

86| `prompt.autocomplete` | Der Benutzer im Eingabefeld tippt und an der Cursorposition ein Wort endet. `e.token` ist dieses Wort. Claude Code wartet nicht auf den Hook: Seine eigenen Autovervollständigungszeilen werden zuerst angezeigt. | `{ suggestions }`, eine Liste von `{ text, label, description }`-Zeilen, die unter denen von Claude Code angezeigt werden. Das Auswählen einer Zeile schreibt ihren `text` über das Wort. |86| `prompt.autocomplete` | Der Benutzer im Eingabefeld tippt und an der Cursorposition ein Wort endet. `e.token` ist dieses Wort. Claude Code wartet nicht auf den Hook: Seine eigenen Autovervollständigungszeilen werden zuerst angezeigt. | `{ suggestions }`, eine Liste von `{ text, label, description }`-Zeilen, die unter denen von Claude Code angezeigt werden. Das Auswählen einer Zeile schreibt ihren `text` über das Wort. |

87| `prompt.compose` | Claude Code einen System-Prompt rendert | `{ sections }`, eine Liste von `{ id, text, scope }` in der Reihenfolge, in der sie gesendet werden |87| `prompt.compose` | Claude Code einen System-Prompt rendert | `{ sections }`, eine Liste von `{ id, text, scope }` in der Reihenfolge, in der sie gesendet werden |

88| [`prompt.section`](https://code.claude.com/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Einmal für jeden benannten Abschnitt des System-Prompts. `e.name` ist die `id` des Abschnitts in `prompt.compose`. | `{ text }` oder `{ text: null }`, um den Abschnitt auszulassen |88| [`prompt.section`](https://code.claude.com/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Einmal für jeden benannten Abschnitt des System-Prompts. `e.name` ist die `id` des Abschnitts in `prompt.compose`. | `{ text }` oder `{ text: null }`, um den Abschnitt auszulassen. Fügen Sie [`breakPromptCache: true`](#break-prompt-cache) hinzu, um im nächsten Turn einen geänderten Abschnitt zu senden. |

89| [`prompt.context`](https://code.claude.com/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Einmal pro Konversation, für den Kontext, der mit der ersten Nachricht gesendet wird | `{ blocks }` |89| [`prompt.context`](https://code.claude.com/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Einmal pro Konversation, für den Kontext, der mit der ersten Nachricht gesendet wird | `{ blocks }` |

90| `prompt.attachment` | Claude Code eine eigene Nachricht für Claude hinzufügt, etwa eine Erinnerung. `e.type` benennt die Art, und für die Arten, die die Typen deklarieren, enthält `e.detail` die Fakten, aus denen der Text geschrieben wurde. | `{ text }` oder `{ text: null }`, um sie auszulassen |90| `prompt.attachment` | Claude Code eine eigene Nachricht für Claude hinzufügt, etwa eine Erinnerung. `e.type` benennt die Art, und für die Arten, die die Typen deklarieren, enthält `e.detail` die Fakten, aus denen der Text geschrieben wurde. | `{ text }` oder `{ text: null }`, um sie auszulassen |

91| `prompt.mention` | Claude Code gleich eine Datei liest, die in einem Prompt per @ erwähnt wird. Erfordert Claude Code v2.1.290 oder höher. | `next({ ...e, path })`, um eine andere Datei zu lesen, oder `{ deny: reason }` |91| `prompt.mention` | Claude Code gleich eine Datei liest, die in einem Prompt per @ erwähnt wird. Erfordert Claude Code v2.1.290 oder höher. | `next({ ...e, path })`, um eine andere Datei zu lesen, oder `{ deny: reason }` |

108 108

109Bei `skill.prompt` erfordern `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` und `e.frontmatterProblem` Claude Code v2.1.299 oder höher.109Bei `skill.prompt` erfordern `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` und `e.frontmatterProblem` Claude Code v2.1.299 oder höher.

110 110

111#### Einen geänderten System-Prompt-Abschnitt oder eine geänderte Tool-Beschreibung mit `breakPromptCache` senden

112

113Um einen Abschnitt oder eine Tool-Beschreibung in einer laufenden Konversation zu ändern, rufen Sie `$.ui.invalidate('prompt.section')` oder `$.ui.invalidate('tool.describe')` auf, damit Ihr Hook erneut ausgeführt wird. Geben Sie daraus `{ text, breakPromptCache: true }` oder `{ description, breakPromptCache: true }` zurück. Ohne das Feld liest Claude für einen Abschnitt oder ein vorab geladenes Tool weiterhin den [mit der Konversation gespeicherten](https://code.claude.com/docs/de/cli-reference.md#system-prompt-flags-in-resumed-conversations) Text, bis eine neue Konversation beginnt oder eine [Komprimierung](https://code.claude.com/docs/de/prompt-caching.md#compacting-the-conversation) erfolgt.

114

115Der geänderte Text erreicht Claude im nächsten Turn, und der [Prompt-Cache](https://code.claude.com/docs/de/prompt-caching.md) beginnt von vorn, sodass dieser Turn langsamer und teurer ist. Das Feld erfordert Claude Code v2.1.321 oder höher. Von v2.1.299 bis v2.1.321 erhielt eine laufende Konversation den geänderten Text im nächsten Turn.

116

111### Befehle und Konfiguration117### Befehle und Konfiguration

112 118

212| Namespace | Methoden |218| Namespace | Methoden |

213| :- | :- |219| :- | :- |

215| [`$.ui`](https://code.claude.com/docs/de/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |221| [`$.ui`](https://code.claude.com/docs/de/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, [`place`](https://code.claude.com/docs/de/plugins/mods/interface#place-a-row-in-the-transcript), `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit`, `view`. `view` erfordert Claude Code v2.1.300 oder neuer und `place` v2.1.314 oder neuer. |

222| [`$.theme`](https://code.claude.com/docs/de/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `set`, `clear`: einen Hintergrund festlegen, den die Desktop- oder Mobile-App zeichnet, und den Hintergrund wieder entfernen. Erfordert Claude Code v2.1.319 oder neuer. |

218| `$.agent` | `register`, `spawn`, `list`. `list()` gibt die Subagenten und Teammitglieder dieser Sitzung zurück, jeweils mit einem `status` von `pending`, `running`, `waiting`, `idle`, `completed`, `failed` oder `killed`, wobei `idle` und `waiting` Claude Code v2.1.289 oder neuer erfordern. |225| `$.agent` | `register`, `spawn`, `list`. `list()` gibt die Subagenten und Teammitglieder dieser Sitzung zurück, jeweils mit einem `status` von `pending`, `running`, `waiting`, `idle`, `completed`, `failed` oder `killed`, wobei `idle` und `waiting` Claude Code v2.1.289 oder neuer erfordern. |

243| :- | :- | :- | :- |250| :- | :- | :- | :- |

254| [`Backdrop`](https://code.claude.com/docs/de/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `id`, `plugin`, `glass`, `colorScheme` | `backdrop` | Oberflächen `desktop` und `mobile`. Ihr Hook wird ausgeführt, wenn die Desktop- oder die mobile App das Zeichnen eines Hintergrunds anfordert. |

399| Neuzeichnungen durch `$.ui.invalidate('ui.render')` | Gedrosselt auf 10 pro Sekunde bzw. 30 im Terminal für den sichtbaren Bereich, das erweiterte Band und die Hinweiszeile unter dem Eingabefeld. Früher eingehende Aufrufe werden zusammengefasst. |408| Neuzeichnungen durch `$.ui.invalidate('ui.render')` | Gedrosselt auf 10 pro Sekunde bzw. 30 im Terminal für den sichtbaren Bereich, das erweiterte Band und die Hinweiszeile unter dem Eingabefeld. Früher eingehende Aufrufe werden zusammengefasst. |

400| `$.ui.toast` | Wird 4 Sekunden lang angezeigt, sofern Sie nicht `{ timeoutMs }` übergeben. Im [klassischen Renderer](https://code.claude.com/docs/de/fullscreen.md#enable-fullscreen-rendering) kann ein neuerer Toast eines Mods [den Platz seines älteren Toasts einnehmen](https://code.claude.com/docs/de/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear), der gerade angezeigt wird oder auf die Anzeige wartet. |409| `$.ui.toast` | Wird 4 Sekunden lang angezeigt, sofern Sie nicht `{ timeoutMs }` übergeben. Im [klassischen Renderer](https://code.claude.com/docs/de/fullscreen.md#enable-fullscreen-rendering) kann ein neuerer Toast eines Mods [den Platz seines älteren Toasts einnehmen](https://code.claude.com/docs/de/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear), der gerade angezeigt wird oder auf die Anzeige wartet. |

401| Ein Bereich, der ohne Anforderung durch den Benutzer geöffnet wird | Wird ab 144 Terminalspalten platziert, ab 110, nachdem der Benutzer ihn einmal geöffnet hat |410| Ein Bereich, der ohne Anforderung durch den Benutzer geöffnet wird | Wird ab 144 Terminalspalten platziert, ab 110, nachdem der Benutzer ihn einmal geöffnet hat |

411| Zeilen aus `$.ui.place`, die ein Mod gleichzeitig in einer Konversation hat | 500. Beim Erreichen des Limits wird ein Aufruf mit einer neuen `id` zu `{ isPlaced: false, reason: 'a plugin holds at most 500 placed rows' }` aufgelöst. |

402| Verschachtelungstiefe der Argumente eines Aufrufs der Mods-API | 28.000 Ebenen. Darüber hinaus wird der Aufruf mit einer Meldung abgelehnt, die auf `nesting deeper than 28000 levels is not supported` endet. Erfordert Claude Code v2.1.299 oder höher. |412| Verschachtelungstiefe der Argumente eines Aufrufs der Mods-API | 28.000 Ebenen. Darüber hinaus wird der Aufruf mit einer Meldung abgelehnt, die auf `nesting deeper than 28000 levels is not supported` endet. Erfordert Claude Code v2.1.299 oder höher. |

403| Verschachtelungstiefe eines geänderten Ereignisses, das an `next` übergeben wird, außerhalb von [asynchronen Generator-Hooks](#events) wie einem Hook auf `turn.step` | 28.000 Ebenen. Darüber hinaus wird `next` mit einer Meldung abgelehnt, die auf `nesting deeper than 28000 levels is not supported` endet. Erfordert Claude Code v2.1.299 oder höher. |413| Verschachtelungstiefe eines geänderten Ereignisses, das an `next` übergeben wird, außerhalb von [asynchronen Generator-Hooks](#events) wie einem Hook auf `turn.step` | 28.000 Ebenen. Darüber hinaus wird `next` mit einer Meldung abgelehnt, die auf `nesting deeper than 28000 levels is not supported` endet. Erfordert Claude Code v2.1.299 oder höher. |

404| Verschachtelungstiefe des Rückgabewerts eines Hooks, außerhalb von `ui.render`, `ui.resolve` und asynchronen Generator-Hooks | 28.000 Ebenen. Darüber hinaus wird das Ergebnis des Hooks zurückgewiesen, und [der Hinweis, der dies meldet](https://code.claude.com/docs/de/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing), enthält `nesting deeper than 28000 levels is not supported`. Erfordert Claude Code v2.1.299 oder höher. |414| Verschachtelungstiefe des Rückgabewerts eines Hooks, außerhalb von `ui.render`, `ui.resolve` und asynchronen Generator-Hooks | 28.000 Ebenen. Darüber hinaus wird das Ergebnis des Hooks zurückgewiesen, und [der Hinweis, der dies meldet](https://code.claude.com/docs/de/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing), enthält `nesting deeper than 28000 levels is not supported`. Erfordert Claude Code v2.1.299 oder höher. |

405| Geltungsbereiche wie Funktionen, Blöcke und Schleifen, die in einer Datei eines Hooks-Moduls ineinander verschachtelt sind | 2.000 |415| Geltungsbereiche wie Funktionen, Blöcke und Schleifen, die in einer Datei eines Hooks-Moduls ineinander verschachtelt sind | 2.000 |

406| Namen von Befehlen, Tools, Subagent-Typen und Bereichen | Buchstaben, Ziffern, `_` und `-`, bis zu 64 Zeichen |416| Namen von Befehlen, Tools, Subagent-Typen und Bereichen sowie die `id` einer platzierten Zeile oder eines Backdrops | Buchstaben, Ziffern, `_` und `-`, bis zu 64 Zeichen |

408 418

409## Einstellungen und Umgebungsvariablen419## Einstellungen und Umgebungsvariablen

prompt-caching.md +2 −2

Details

33Zwei Einstellungen erscheinen nicht in der Ebenen-Tabelle, beeinflussen aber dennoch, was zwischengespeichert bleibt:33Zwei Einstellungen erscheinen nicht in der Ebenen-Tabelle, beeinflussen aber dennoch, was zwischengespeichert bleibt:

34 34

35* **Modell**: Jedes Modell hat seinen eigenen Cache. Das Wechseln von Modellen berechnet die gesamte Anfrage neu, auch wenn der Inhalt identisch ist. Siehe [Modelle wechseln](#switching-models) unten.35* **Modell**: Jedes Modell hat seinen eigenen Cache. Das Wechseln von Modellen berechnet die gesamte Anfrage neu, auch wenn der Inhalt identisch ist. Siehe [Modelle wechseln](#switching-models) unten.

36* **Effort-Stufe**: Bei den meisten Modellen hat jede Effort-Stufe ihren eigenen Cache, daher wird die gesamte Anfrage neu berechnet, wenn Sie die Effort-Stufe während einer Sitzung ändern. Bei Opus 5.5, Sonnet 5.5, Haiku 5.5 und Fable 5.1 mit einem API-Schlüssel oder einem Claude-Abonnement bleibt der Cache standardmäßig intakt. Siehe [Effort-Stufe ändern](#changing-effort-level) unten.36* **Effort-Stufe**: Bei den meisten Modellen hat jede Effort-Stufe ihren eigenen Cache, daher wird die gesamte Anfrage neu berechnet, wenn Sie die Effort-Stufe während einer Sitzung ändern. Mit einem API-Schlüssel oder einem Claude-Abonnement bleibt der Cache bei Fable 5.1 und neuer, Opus 5.5, Sonnet 5.5 und Haiku 5.5 standardmäßig intakt. Siehe [Effort-Stufe ändern](#changing-effort-level) unten.

37 37

38> [!TIP]38> [!TIP]

39>39>

94 94

95Bei den meisten Modellen bedeutet das Ändern der [Effort-Stufe](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) während einer Sitzung, dass die nächste Anfrage die gesamte Konversationshistorie ohne Cache-Treffer liest. Während der Cache noch warm ist, bittet Claude Code Sie, die Änderung zuerst zu bestätigen.95Bei den meisten Modellen bedeutet das Ändern der [Effort-Stufe](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) während einer Sitzung, dass die nächste Anfrage die gesamte Konversationshistorie ohne Cache-Treffer liest. Während der Cache noch warm ist, bittet Claude Code Sie, die Änderung zuerst zu bestätigen.

96 96

97Bei Opus 5.5, Sonnet 5.5, Haiku 5.5 und Fable 5.1 mit einem API-Schlüssel oder einem Claude-Abonnement behalten Sie den Cache, wenn Sie die Effort-Stufe ändern. Claude Code [wendet die neue Stufe](https://code.claude.com/docs/de/model-config.md#when-a-new-effort-level-starts) ohne Nachfrage an. Bei Amazon Bedrock, Google Cloud's Agent Platform oder einem [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) oder wenn Sie [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) setzen oder Ihre Organisation eine HIPAA-Konfiguration hat, verhält es sich wie bei den meisten Modellen.97Mit einem API-Schlüssel oder einem Claude-Abonnement behalten Sie bei Fable 5.1 und neuer, Opus 5.5, Sonnet 5.5 und Haiku 5.5 den Cache, wenn Sie die Effort-Stufe ändern. Claude Code [wendet die neue Stufe](https://code.claude.com/docs/de/model-config.md#when-a-new-effort-level-starts) ohne Nachfrage an. Bei Amazon Bedrock, Google Cloud's Agent Platform oder einem [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) oder wenn Sie [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) setzen oder Ihre Organisation eine HIPAA-Konfiguration hat, verhält es sich wie bei den meisten Modellen.

98 98

99Vor v2.1.260 machte das Ändern der Effort-Stufe auf Fable 5.1 mit einem API-Schlüssel oder Claude-Abonnement auch den Cache ungültig.99Vor v2.1.260 machte das Ändern der Effort-Stufe auf Fable 5.1 mit einem API-Schlüssel oder Claude-Abonnement auch den Cache ungültig.

100 100

remote-control.md +3 −0

Details

49> claude remote-control49> claude remote-control

50> ```50> ```

51>51>

52> `claude rc` ist ein Alias für diesen Befehl.

53>

52> Solange Sie die einmalige Bestätigung von Remote Control nicht akzeptiert haben, erklärt `claude remote-control`, was der Befehl tut, und fragt `Enable Remote Control? (y/n)`, bevor der Server gestartet wird. Antworten Sie mit `y`, um zu akzeptieren und den Server zu starten. Wenn Sie ablehnen, beendet sich Claude Code, ohne den Server zu starten, und fragt beim nächsten Ausführen des Befehls erneut.54> Solange Sie die einmalige Bestätigung von Remote Control nicht akzeptiert haben, erklärt `claude remote-control`, was der Befehl tut, und fragt `Enable Remote Control? (y/n)`, bevor der Server gestartet wird. Antworten Sie mit `y`, um zu akzeptieren und den Server zu starten. Wenn Sie ablehnen, beendet sich Claude Code, ohne den Server zu starten, und fragt beim nächsten Ausführen des Befehls erneut.

53>55>

54> Der Prozess läuft im Servermodus in Ihrem Terminal weiter und wartet auf Remote-Verbindungen. Er zeigt eine URL an, mit der Sie sich [von einem anderen Gerät aus verbinden](#connect-from-another-device) können, und Sie können die Leertaste drücken, um einen QR-Code für den schnellen Zugriff von Ihrem Telefon aus anzuzeigen. Während eine Remote-Sitzung aktiv ist, zeigt das Terminal den Verbindungsstatus und die Tool-Aktivität an.56> Der Prozess läuft im Servermodus in Ihrem Terminal weiter und wartet auf Remote-Verbindungen. Er zeigt eine URL an, mit der Sie sich [von einem anderen Gerät aus verbinden](#connect-from-another-device) können, und Sie können die Leertaste drücken, um einen QR-Code für den schnellen Zugriff von Ihrem Telefon aus anzuzeigen. Während eine Remote-Sitzung aktiv ist, zeigt das Terminal den Verbindungsstatus und die Tool-Aktivität an.

462* **Ihr claude.ai-Plan ist Pro, Max oder Ultra**: Claude Code ist immer noch unter einer Team- oder Enterprise-Organisation von einer früheren Anmeldung angemeldet, daher überprüft es die Remote-Control-Richtlinie dieser Organisation. Führen Sie `/status` aus, um zu sehen, welcher Plan und welche Organisation Ihre Anmeldung verwendet. Führen Sie `claude auth logout` und dann `claude auth login` aus, um sich erneut unter Ihrem aktuellen Plan anzumelden.464* **Ihr claude.ai-Plan ist Pro, Max oder Ultra**: Claude Code ist immer noch unter einer Team- oder Enterprise-Organisation von einer früheren Anmeldung angemeldet, daher überprüft es die Remote-Control-Richtlinie dieser Organisation. Führen Sie `/status` aus, um zu sehen, welcher Plan und welche Organisation Ihre Anmeldung verwendet. Führen Sie `claude auth logout` und dann `claude auth login` aus, um sich erneut unter Ihrem aktuellen Plan anzumelden.

463* **Die Meldung sagt nicht, dass Sie den Admin Ihrer Organisation kontaktieren sollen**: Auf Ihre Organisation ist die [HIPAA-Konfiguration](https://code.claude.com/docs/de/hipaa-setup.md) angewendet, die Remote Control ausschaltet. Führen Sie zur Bestätigung `/status` aus und suchen Sie in der Zeile `Organization configuration` nach `HIPAA`. Ein Owner sieht den **Remote Control**-Umschalter in den [Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) ausgegraut und kann ihn nicht einschalten. Wenn Sie Fragen zur Konfiguration haben, wenden Sie sich an einen Owner, der das Anthropic-Account-Team Ihrer Organisation kontaktieren kann. Vor v2.1.267 zeigte dieser Fall stattdessen „Remote Control isn't available for your organization due to its compliance policy“.465* **Die Meldung sagt nicht, dass Sie den Admin Ihrer Organisation kontaktieren sollen**: Auf Ihre Organisation ist die [HIPAA-Konfiguration](https://code.claude.com/docs/de/hipaa-setup.md) angewendet, die Remote Control ausschaltet. Führen Sie zur Bestätigung `/status` aus und suchen Sie in der Zeile `Organization configuration` nach `HIPAA`. Ein Owner sieht den **Remote Control**-Umschalter in den [Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) ausgegraut und kann ihn nicht einschalten. Wenn Sie Fragen zur Konfiguration haben, wenden Sie sich an einen Owner, der das Anthropic-Account-Team Ihrer Organisation kontaktieren kann. Vor v2.1.267 zeigte dieser Fall stattdessen „Remote Control isn't available for your organization due to its compliance policy“.

464* **Remote Control funktioniert für andere in Ihrer Organisation, aber nicht für Sie**: Wenn Ihre Enterprise-Organisation Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452) verwaltet, können Ihre Rollen die Ursache sein. Remote Control benötigt sowohl die Berechtigung für Cloud-Sitzungen als auch die Berechtigung **Claude Code remote control**. Bitten Sie einen Owner zu prüfen, ob Ihre Rollen beide enthalten, und Fehlendes unter [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) zu ergänzen.466* **Remote Control funktioniert für andere in Ihrer Organisation, aber nicht für Sie**: Wenn Ihre Enterprise-Organisation Ihren Zugriff mit [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452) verwaltet, können Ihre Rollen die Ursache sein. Remote Control benötigt sowohl die Berechtigung für Cloud-Sitzungen als auch die Berechtigung **Claude Code remote control**. Bitten Sie einen Owner zu prüfen, ob Ihre Rollen beide enthalten, und Fehlendes unter [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) zu ergänzen.

467* **Ein Owner sieht ein [Zero Data Retention](https://code.claude.com/docs/de/zero-data-retention.md)-Banner in den [Admin-Einstellungen](https://claude.ai/admin-settings/claude-code)**: Remote Control ist für Ihre Organisation nicht verfügbar, und ein Owner kann es nicht einschalten.

465* **Andernfalls hat ein Owner es für Ihre Organisation nicht aktiviert**: Remote Control ist standardmäßig bei Team- und Enterprise-Plänen deaktiviert. Ein Owner kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den **Remote Control**-Umschalter einschaltet. Dieser Umschalter ist eine serverseitige Organisationseinstellung.468* **Andernfalls hat ein Owner es für Ihre Organisation nicht aktiviert**: Remote Control ist standardmäßig bei Team- und Enterprise-Plänen deaktiviert. Ein Owner kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den **Remote Control**-Umschalter einschaltet. Dieser Umschalter ist eine serverseitige Organisationseinstellung.

466 469

467Vor v2.1.281 erschien diese Meldung auch, wenn Claude Code die Richtlinie Ihrer Organisation auf diesem Computer nicht geladen hatte, z. B. nach dem Starten im Offline-Modus. Spätere Versionen melden diesen Zustand stattdessen als [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control).470Vor v2.1.281 erschien diese Meldung auch, wenn Claude Code die Richtlinie Ihrer Organisation auf diesem Computer nicht geladen hatte, z. B. nach dem Starten im Offline-Modus. Spätere Versionen melden diesen Zustand stattdessen als [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control).

self-hosted-environments-configuration.md +5 −1

Details

154| :- | :- |154| :- | :- |

155| `CLAUDE_RUNNER_REPO_URL` | Repository-URL zum Klonen, nachdem alle `--git-host-rewrite` und `--git-ssh-rewrite` angewendet wurden |155| `CLAUDE_RUNNER_REPO_URL` | Repository-URL zum Klonen, nachdem alle `--git-host-rewrite` und `--git-ssh-rewrite` angewendet wurden |

156| `CLAUDE_RUNNER_REPO_REF` | Revision zum Auschecken, wie die Sitzung sie angefordert hat: ein Branch, Tag, Commit-SHA oder vollständiger Referenzname wie `refs/heads/<branch>` oder `refs/pull/<number>/head`. Leer bedeutet den Standard-Branch des Repositorys. |156| `CLAUDE_RUNNER_REPO_REF` | Revision zum Auschecken, wie die Sitzung sie angefordert hat: ein Branch, Tag, Commit-SHA oder vollständiger Referenzname wie `refs/heads/<branch>` oder `refs/pull/<number>/head`. Leer bedeutet den Standard-Branch des Repositorys. |

157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Absoluter Pfad, wo der Arbeitsbaum hinterlassen werden muss |157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Absoluter Pfad, wo der Arbeitsbaum hinterlassen werden muss. Siehe [Namen von Checkout-Ordnern](#checkout-folder-names). |

166 166

167Nachdem Ihr Hook zurückkehrt, überprüft der Runner, ob `CLAUDE_RUNNER_CHECKOUT_PATH` eine `.git` enthält. Wenn Ihr Hook eine Nicht-Git-Quelle wie Perforce oder ein entpacktes Tarball materialisiert, setzen Sie `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` in der Umgebung des Runners, um diese Überprüfung zu überspringen. Git-basierte Abläufe wie die Erstellung des Arbeits-Branches und das Pushen von Ergebnissen erfordern einen Git-Checkout, daher exportieren Sie Ergebnisse aus Nicht-Git-Bäumen mit einem [`post-session`-Hook](#post-session).167Nachdem Ihr Hook zurückkehrt, überprüft der Runner, ob `CLAUDE_RUNNER_CHECKOUT_PATH` eine `.git` enthält. Wenn Ihr Hook eine Nicht-Git-Quelle wie Perforce oder ein entpacktes Tarball materialisiert, setzen Sie `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` in der Umgebung des Runners, um diese Überprüfung zu überspringen. Git-basierte Abläufe wie die Erstellung des Arbeits-Branches und das Pushen von Ergebnissen erfordern einen Git-Checkout, daher exportieren Sie Ergebnisse aus Nicht-Git-Bäumen mit einem [`post-session`-Hook](#post-session).

168 168

169#### Namen von Checkout-Ordnern

170

171`CLAUDE_RUNNER_CHECKOUT_PATH` endet in einem Ordner namens `<repo-owner>-<repo>`, wie `acme-api`. Zwei Repositorys in einer Sitzung können sich keinen Ordner teilen, auch wenn sich ihre Namen nur in der Groß-/Kleinschreibung unterscheiden. Wenn eine Sitzung beispielsweise `acme/api` und dann `Acme/API` auflistet, erhält das erste `acme-api` und das zweite `Acme-API-2`.

172

169#### Git-Anmeldedaten im Hook beziehen173#### Git-Anmeldedaten im Hook beziehen

170 174

171Der Runner übergibt keine Git-Anmeldedaten an den Hook. Auch der Unterbefehl `decode-token` ist hier nicht verfügbar, weil `CLAUDE_RUNNER_CLAUDE_BIN` in der Checkout-Hook-Umgebung nicht gesetzt ist. Erzeugen Sie stattdessen Pro-Sitzungs-Klon-Anmeldedaten aus der Identität der Sitzung, oder greifen Sie auf die eigene Git-Authentifizierung des Hosts zurück:175Der Runner übergibt keine Git-Anmeldedaten an den Hook. Auch der Unterbefehl `decode-token` ist hier nicht verfügbar, weil `CLAUDE_RUNNER_CLAUDE_BIN` in der Checkout-Hook-Umgebung nicht gesetzt ist. Erzeugen Sie stattdessen Pro-Sitzungs-Klon-Anmeldedaten aus der Identität der Sitzung, oder greifen Sie auf die eigene Git-Authentifizierung des Hosts zurück:

self-hosted-environments-deploy.md +20 −3

Details

22* **Halten Sie die GitHub-Anmeldedaten des Hosts von Sitzungen fern**: Claude kann alle GitHub-Anmeldedaten verwenden, die eine Sitzung lesen kann, mit dem Zugriff, den diese Anmeldedaten gewähren. Halten Sie die eigenen, weit gefassten GitHub-Anmeldedaten des Runner-Hosts aus allem heraus, was eine Sitzung lesen kann. Solche Anmeldedaten können ein persönliches Zugriffstoken sein, das Token, das `gh auth login` für Ihr Konto speichert, oder ein `GH_TOKEN` in der Umgebung des Runners.22* **Halten Sie die GitHub-Anmeldedaten des Hosts von Sitzungen fern**: Claude kann alle GitHub-Anmeldedaten verwenden, die eine Sitzung lesen kann, mit dem Zugriff, den diese Anmeldedaten gewähren. Halten Sie die eigenen, weit gefassten GitHub-Anmeldedaten des Runner-Hosts aus allem heraus, was eine Sitzung lesen kann. Solche Anmeldedaten können ein persönliches Zugriffstoken sein, das Token, das `gh auth login` für Ihr Konto speichert, oder ein `GH_TOKEN` in der Umgebung des Runners.

23 * **Mit [Anthropic-verwaltetem Git](#use-the-anthropic-git-proxy)**: Mit solchen Anmeldedaten erreicht Claude GitHub direkt statt über Anthropic-verwaltetes Git.23 * **Mit [Anthropic-verwaltetem Git](#use-the-anthropic-git-proxy)**: Mit solchen Anmeldedaten erreicht Claude GitHub direkt statt über Anthropic-verwaltetes Git.

24 * **Ohne Anthropic-verwaltetes Git**: Clone-Anmeldedaten können im Image bleiben, wenn Sie sie so eng beschränken, wie in [Git-Konfiguration in Ihrem Image ausliefern](#ship-git-config-in-your-image) beschrieben.24 * **Ohne Anthropic-verwaltetes Git**: Clone-Anmeldedaten können im Image bleiben, wenn Sie sie so eng beschränken, wie in [Git-Konfiguration in Ihrem Image ausliefern](#ship-git-config-in-your-image) beschrieben.

25* **Halten Sie das Umgebungsgeheimnis von sitzungsausführenden Hosts fern**: Das Umgebungsgeheimnis kann Runner registrieren und jede Sitzung abholen, die in der Umgebung in die Warteschlange eingereiht ist. In einer festen Flotte lebt es auf jedem Runner-Host, wo jeder Sitzungscode das Geheimnisdatei lesen kann. Bevorzugen Sie [On-Demand-Runner](https://code.claude.com/docs/de/self-hosted-environments-configuration.md#on-demand-runners), bei denen das Geheimnis auf dem Orchestrator-Host bleibt, der niemals Benutzercode ausführt, und jeder Runner einen einmaligen Arbeitsauftrag erhält, der genau einen Runner registriert. Behandeln Sie in einer festen Flotte die Umgebungsgeheimnisdatei als von jeder Sitzung lesbar und rotieren Sie das Geheimnis nach jedem vermuteten Sitzungskompromiss.25* **Halten Sie das Umgebungsgeheimnis von sitzungsausführenden Hosts fern**: Das Umgebungsgeheimnis kann Runner registrieren und jede Sitzung abholen, die in der Umgebung in die Warteschlange eingereiht ist. In einer festen Flotte lebt es auf jedem Runner-Host, wo jeder Sitzungscode die Geheimnisdatei lesen kann. Bevorzugen Sie [On-Demand-Runner](https://code.claude.com/docs/de/self-hosted-environments-configuration.md#on-demand-runners), bei denen das Geheimnis auf dem Orchestrator-Host bleibt, der niemals Benutzercode ausführt, und jeder Runner einen einmaligen Arbeitsauftrag erhält, der genau einen Runner registriert. Behandeln Sie in einer festen Flotte die Umgebungsgeheimnisdatei als von jeder Sitzung lesbar und rotieren Sie das Geheimnis nach jedem vermuteten Sitzungskompromiss.

26 * **Nach einer vermuteten Kompromittierung**: Lassen Sie einen [Owner](https://code.claude.com/docs/de/cloud-environments.md#organization-shared-environments) auf der Registerkarte **Configuration** der Umgebung ein neues Geheimnis erstellen und das alte widerrufen, und rollen Sie dann das neue aus. Anthropic lehnt jeden Orchestrator und Runner mit dem alten Geheimnis ab, einschließlich On-Demand-Runnern aus dessen Arbeitsaufträgen. Ihre Runner werden beendet, wodurch ihre Sitzungen unterbrochen werden.

26* **Standard-Deny-Netzwerk-Egress**: Beschränken Sie den ausgehenden Datenverkehr von Runner- und Sitzungs-Containern an Ihrer eigenen Netzwerkgrenze in jeder Umgebung; [Standard-Deny-Egress](#default-deny-egress) behandelt, was erlaubt ist und warum.27* **Standard-Deny-Netzwerk-Egress**: Beschränken Sie den ausgehenden Datenverkehr von Runner- und Sitzungs-Containern an Ihrer eigenen Netzwerkgrenze in jeder Umgebung; [Standard-Deny-Egress](#default-deny-egress) behandelt, was erlaubt ist und warum.

27* **Least-Privilege-Host-IAM**: Die Compute-Identität, die an den Runner-Host angehängt ist, wie ein Instance-Profil oder ein Node-Service-Konto, sollte nur das gewähren, was der Runner selbst benötigt. Sitzungen sollten ihre eigenen Anmeldedaten über Ihr Wrapper-Skript erhalten, anstatt die des Hosts zu erben.28* **Least-Privilege-Host-IAM**: Die Compute-Identität, die an den Runner-Host angehängt ist, wie ein Instance-Profil oder ein Node-Service-Konto, sollte nur das gewähren, was der Runner selbst benötigt. Sitzungen sollten ihre eigenen Anmeldedaten über Ihr Wrapper-Skript erhalten, anstatt die des Hosts zu erben.

28* **Blockieren Sie den Cloud-Metadaten-Endpunkt von Sitzungen**: Um Sitzungen von der Host-Identität fernzuhalten, müssen Sie ihren Zugriff auf den Cloud-Metadaten-Endpunkt blockieren, und Subnetz-Level-Egress-Richtlinien unterbrechen keinen Link-Local-Metadaten-Datenverkehr, daher blockieren Sie ihn im Container selbst:29* **Blockieren Sie den Cloud-Metadaten-Endpunkt von Sitzungen**: Um Sitzungen von der Host-Identität fernzuhalten, müssen Sie ihren Zugriff auf den Cloud-Metadaten-Endpunkt blockieren, und Subnetz-Level-Egress-Richtlinien unterbrechen keinen Link-Local-Metadaten-Datenverkehr, daher blockieren Sie ihn im Container selbst:

203> [!WARNING]204> [!WARNING]

204>205>

205> Wenn `--use-anthropic-git-proxy` gesetzt ist, löscht und ersetzt der Runner die globale Git-Konfiguration des Benutzers, unter dem er läuft, und legt keine Sicherung an. Das geschieht beim Start und vor jeder Sitzung. Ein Login- oder Credential-Helper, den Sie dort hinterlegt hatten, geht verloren. Einstellungen, die [`--configure-git`](#let-the-runner-configure-git) schreibt, bleiben erhalten. Führen Sie den Runner als dedizierten Benutzer oder in einem Container aus, niemals als Ihren eigenen Benutzer.206> Wenn `--use-anthropic-git-proxy` gesetzt ist, löscht und ersetzt der Runner die globale Git-Konfiguration des Benutzers, unter dem er läuft, und legt keine Sicherung an. Das geschieht beim Start und vor jeder Sitzung. Ein Login- oder Credential-Helper, den Sie dort hinterlegt hatten, geht verloren. Einstellungen, die [`--configure-git`](#let-the-runner-configure-git) schreibt, bleiben erhalten. Führen Sie den Runner als dedizierten Benutzer oder in einem Container aus, niemals als Ihren eigenen Benutzer.

207>

208> Die globale Git-Konfiguration umfasst alle drei: `~/.gitconfig`, die Datei, die `GIT_CONFIG_GLOBAL` benennt, falls Sie diese Variable setzen, und das gesamte Verzeichnis `$XDG_CONFIG_HOME/git`, standardmäßig `~/.config/git`.

206 209

207Bewahren Sie Git-Einstellungen, die nicht geheim sind, wie die Identität und `safe.directory`, in der System-Git-Konfiguration auf.210Bewahren Sie Git-Einstellungen, die nicht geheim sind, wie die Identität und `safe.directory`, in der System-Git-Konfiguration auf.

208 211

247* **Eine Zeile mit `remote: access denied by the git proxy`**: Auch eine Sitzung, für die Anthropic Git bereitstellt, kann abgewiesen werden, zum Beispiel wenn eine Organisationsrichtlinie den Git-Zugriff für die Sitzung verweigert oder die Sitzung nicht für das Repository autorisiert ist. Das Log des Runners zeigt dann eine Zeile mit `remote: access denied by the git proxy`, und der Rest dieser Zeile nennt den Grund.250* **Eine Zeile mit `remote: access denied by the git proxy`**: Auch eine Sitzung, für die Anthropic Git bereitstellt, kann abgewiesen werden, zum Beispiel wenn eine Organisationsrichtlinie den Git-Zugriff für die Sitzung verweigert oder die Sitzung nicht für das Repository autorisiert ist. Das Log des Runners zeigt dann eine Zeile mit `remote: access denied by the git proxy`, und der Rest dieser Zeile nennt den Grund.

248* **`GitHub authentication required`**: Dies erscheint, wenn der Ersteller der Sitzung keine funktionierende GitHub-Verbindung auf claude.ai hat. Der Clone der Sitzung schlägt fehl, und der Git-Fehler lautet `GitHub authentication required. Please reconnect your GitHub account.` Bitten Sie diese Person, GitHub in ihren claude.ai-Einstellungen zu verbinden oder erneut zu verbinden.251* **`GitHub authentication required`**: Dies erscheint, wenn der Ersteller der Sitzung keine funktionierende GitHub-Verbindung auf claude.ai hat. Der Clone der Sitzung schlägt fehl, und der Git-Fehler lautet `GitHub authentication required. Please reconnect your GitHub account.` Bitten Sie diese Person, GitHub in ihren claude.ai-Einstellungen zu verbinden oder erneut zu verbinden.

249 252

250Nachdem Sie die Ursache behoben haben, starten Sie die fehlgeschlagenen Sitzungen erneut.253Nachdem Sie die Ursache behoben haben, starten Sie die Runner neu, bei denen die Sitzungen fehlgeschlagen sind, und lassen Sie dann jeden Ersteller eine Nachricht in seiner Sitzung senden oder einen Owner **Retry** auswählen.

251 254

252#### Den Anthropic-Git-Proxy ausschalten255#### Den Anthropic-Git-Proxy ausschalten

253 256

265 268

266Stellen Sie Anmeldedaten bereit, die ohne Eingabeaufforderung für jeden Git-Host funktionieren, den die Sitzungen der Runner verwenden, github.com eingeschlossen. Alle Anmeldedaten, die in der globalen Git-Konfiguration des Runner-Benutzers lagen, sind verloren, weil der Runner diese Konfiguration gelöscht hat, während `--use-anthropic-git-proxy` gesetzt war. [Liefern Sie Anmeldedaten in Ihrem Image mit](#ship-git-config-in-your-image) oder verwenden Sie einen [`checkout`-Lebenszyklus-Hook](https://code.claude.com/docs/de/self-hosted-environments-configuration#checkout).269Stellen Sie Anmeldedaten bereit, die ohne Eingabeaufforderung für jeden Git-Host funktionieren, den die Sitzungen der Runner verwenden, github.com eingeschlossen. Alle Anmeldedaten, die in der globalen Git-Konfiguration des Runner-Benutzers lagen, sind verloren, weil der Runner diese Konfiguration gelöscht hat, während `--use-anthropic-git-proxy` gesetzt war. [Liefern Sie Anmeldedaten in Ihrem Image mit](#ship-git-config-in-your-image) oder verwenden Sie einen [`checkout`-Lebenszyklus-Hook](https://code.claude.com/docs/de/self-hosted-environments-configuration#checkout).

267 270

271Um Anmeldedaten stattdessen in der [globalen Git-Konfiguration](#git-proxy-replaces-global-git-config) zu behalten, [stoppen Sie zuerst die Runner](#shutdown-timing), da ein mit dem Flag gestarteter Runner diese Konfiguration vor jeder Sitzung neu schreibt. Löschen Sie dann `$XDG_CONFIG_HOME/git`, standardmäßig `~/.config/git`, und ersetzen Sie `~/.gitconfig` oder die Datei, die `GIT_CONFIG_GLOBAL` benennt, durch Ihre eigene.

272

268**3. Netzwerkpfad öffnen**273**3. Netzwerkpfad öffnen**

269 274

270Erlauben Sie dem Runner, jeden Git-Host, den die Sitzungen der Runner verwenden, über Port 443 oder 22 zu erreichen. Siehe die Zeile für den Git-Host unter [Netzwerkanforderungen](#network-requirements).275Erlauben Sie dem Runner, jeden Git-Host, den die Sitzungen der Runner verwenden, über Port 443 oder 22 zu erreichen. Siehe die Zeile für den Git-Host unter [Netzwerkanforderungen](#network-requirements).

507 512

508## Kubernetes513## Kubernetes

509 514

510Der Runner bedient `GET /healthz` auf Port 8080 standardmäßig, konfigurierbar mit `--health-port`, daher funktionieren Kubernetes-Probes ohne zusätzliches Setup. Der Endpunkt gibt `200` zurück, wann immer der Prozess lebt, daher erkennen die Probes unten einen toten Prozess, nicht einen steckengebliebenen; um einen Runner zu fangen, der aufgehört hat zu pollen, warnen Sie die `last_poll_age_seconds`-Serie von [`/metrics`](https://code.claude.com/docs/de/self-hosted-environments-reference#prometheus-metrics). Die Deployment unten bindet das Umgebungsgeheimnis von einem Kubernetes Secret, zeigt die Liveness- und Readiness-Probes auf `/healthz` und setzt eine 90-Sekunden-Terminierungs-Grace-Periode. Siehe [Shutdown-Timing](#shutdown-timing) für warum die Grace-Periode wichtig ist.515Der Runner stellt standardmäßig `GET /healthz` auf Port 8080 bereit, konfigurierbar mit `--health-port`. Nach dem Start gibt der Endpunkt `200` zurück, solange der Prozess läuft, daher erkennen die Probes unten einen toten Prozess, nicht einen hängenden. Um einen Runner zu erkennen, der aufgehört hat zu pollen, richten Sie Alerts für die Serie `last_poll_age_seconds` aus [`/metrics`](https://code.claude.com/docs/de/self-hosted-environments-reference#prometheus-metrics) ein.

516

517Das Deployment unten bindet das Umgebungsgeheimnis aus einem Kubernetes Secret ein, richtet die Liveness- und Readiness-Probes auf `/healthz` aus und setzt eine Termination-Grace-Period von 90 Sekunden. Unter [Shutdown-Timing](#shutdown-timing) erfahren Sie, warum die Grace-Period wichtig ist.

511 518

512Das Manifest setzt keine CPU- oder Speicher-`resources` auf dem Runner-Container. Fügen Sie einen Block hinzu, der für die Kapazität dimensioniert ist, die Sie ausführen, wie [Dimensionieren Sie CPU und Speicher für Sitzungen](#size-cpu-and-memory-for-sessions) beschreibt.519Das Manifest setzt keine CPU- oder Speicher-`resources` auf dem Runner-Container. Fügen Sie einen Block hinzu, der für die Kapazität dimensioniert ist, die Sie ausführen, wie [Dimensionieren Sie CPU und Speicher für Sitzungen](#size-cpu-and-memory-for-sessions) beschreibt.

513 520

565 secretName: claude-runner-environment-secret572 secretName: claude-runner-environment-secret

566```573```

567 574

575> [!NOTE]

576>

577> Wenn die Ereignisse des Pods zeigen, dass die Liveness-Probe während des Starts fehlschlägt, erhöhen Sie deren `initialDelaySeconds` oder fügen Sie eine `startupProbe` hinzu. Auf dem Health-Port antwortet nichts, bis der Runner sich registriert und seine Startprüfungen abgeschlossen hat. Mit den obigen Einstellungen startet Kubernetes einen Runner neu, der nicht innerhalb von etwa 90 Sekunden antwortet.

578

568Die Deployment oben lebt in einem `claude-runners`-Namespace. Erstellen Sie den Namespace zuerst:579Die Deployment oben lebt in einem `claude-runners`-Namespace. Erstellen Sie den Namespace zuerst:

569 580

570```bash theme={null}581```bash theme={null}

942 Wenn etwa 30 Minuten nach Sitzungsbeginn jeder Aufruf fehlschlägt, hat wahrscheinlich ein Wrapper-Skript das stdin der Sitzung getrennt, sodass Token-Rotationen sie nicht erreichen; siehe [stdin und Dateideskriptor 3 verbunden lassen](https://code.claude.com/docs/de/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).953 Wenn etwa 30 Minuten nach Sitzungsbeginn jeder Aufruf fehlschlägt, hat wahrscheinlich ein Wrapper-Skript das stdin der Sitzung getrennt, sodass Token-Rotationen sie nicht erreichen; siehe [stdin und Dateideskriptor 3 verbunden lassen](https://code.claude.com/docs/de/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).

943 954

944 Vor v2.1.274 gab der Runner einen fehlgeschlagenen Abruf nach einigen Versuchen auf und wartete auf den nächsten geplanten Abruf. Ein fehlgeschlagener Turn löste keinen Abruf aus, sodass bis zum nächsten geplanten Abruf jeder Turn mit einem 401 fehlschlug.955 Vor v2.1.274 gab der Runner einen fehlgeschlagenen Abruf nach einigen Versuchen auf und wartete auf den nächsten geplanten Abruf. Ein fehlgeschlagener Turn löste keinen Abruf aus, sodass bis zum nächsten geplanten Abruf jeder Turn mit einem 401 fehlschlug.

956* **Eine Sitzung zeigt `The server has refused to renew this session's access to the model`**: Das [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/de/self-hosted-environments-configuration#wrapper-scripts) der Sitzung ist abgelaufen, und der Runner hat auf seine Anfragen nach einem neuen Token HTTP 400 als Antwort erhalten. Der Runner protokolliert `the server has refused to renew the inference_token`. Turns in dieser Sitzung schlagen fehl. Der Runner fordert so lange weiter ein neues Token an, wie der Prozess der Sitzung läuft:

957

958 * **Eine Anfrage gelingt**: Eine Sitzung, die die Warnung gezeigt hat, zeigt dann `The server renewed this session's access to the model`

959 * **Turns schlagen weiterhin fehl**: Der Prozess beendet sich schließlich, und die Sitzung zeigt einen Fehler wie `The session process exited with code 1`

960

961 Um weiterzuarbeiten, ohne auf ein neues Token zu warten, starten Sie eine neue Sitzung. Schlägt auch eine neue Sitzung fehl, prüfen Sie, ob ein Proxy oder Gateway Ihrerseits die HTTP-400-Antwort gegeben hat. Falls keiner das getan hat, [wenden Sie sich an Ihr Anthropic-Account-Team](#report-an-issue) und nennen Sie die ID der ersten Sitzung.

945* **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, sodass die API [die Anfrage ablehnt](https://code.claude.com/docs/de/errors.md#claude-code-does-not-support-this-model). Aktualisieren Sie die Runner auf die in der Meldung genannte oder eine neuere Version, wie in [Version festlegen](#pin-the-version) beschrieben. Bis dahin können Benutzer in der Sitzung ein anderes Modell wählen.962* **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, sodass die API [die Anfrage ablehnt](https://code.claude.com/docs/de/errors.md#claude-code-does-not-support-this-model). Aktualisieren Sie die Runner auf die in der Meldung genannte oder eine neuere Version, wie in [Version festlegen](#pin-the-version) beschrieben. Bis dahin können Benutzer in der Sitzung ein anderes Modell wählen.

946* **Der Pod wird mitten im Drain beendet**: Erhöhen Sie `terminationGracePeriodSeconds` mindestens auf den Wert, den der Runner beim Start protokolliert. Siehe [Timing beim Herunterfahren](#shutdown-timing).963* **Der Pod wird mitten im Drain beendet**: Erhöhen Sie `terminationGracePeriodSeconds` mindestens auf den Wert, den der Runner beim Start protokolliert. Siehe [Timing beim Herunterfahren](#shutdown-timing).

947* **Der Runner protokolliert eine `[runner:log]`-Zeile, die mit `was paused or too slow` endet**: Der Runner lief weiter und muss nicht neu gestartet werden. Bis der in der Zeile genannte stdout- oder stderr-Stream wieder gelesen wurde, verwarf der Runner alle Zeilen dieses Streams außer den neuesten 256 KiB. Wenn Sie [`--log-file`](https://code.claude.com/docs/de/self-hosted-environments-reference#runner-cli-flags) übergeben haben, finden Sie die verworfenen Zeilen dort.964* **Der Runner protokolliert eine `[runner:log]`-Zeile, die mit `was paused or too slow` endet**: Der Runner lief weiter und muss nicht neu gestartet werden. Bis der in der Zeile genannte stdout- oder stderr-Stream wieder gelesen wurde, verwarf der Runner alle Zeilen dieses Streams außer den neuesten 256 KiB. Wenn Sie [`--log-file`](https://code.claude.com/docs/de/self-hosted-environments-reference#runner-cli-flags) übergeben haben, finden Sie die verworfenen Zeilen dort.

self-hosted-environments-quickstart.md +3 −1

Details

73 73

74Gehen Sie zur [**Cloud-Umgebungen** Seite](https://claude.ai/admin-settings/cloud-environments) in den Admin-Einstellungen. Wählen Sie unter **Selbstgehostete Umgebungen** die Option **Neu**, benennen Sie die Umgebung und wählen Sie **Erstellen**. Wählen Sie im zweiten Schritt des Assistenten **Umgebungsschlüssel kopieren**, um das Umgebungsgeheimnis zu kopieren, das die Admin-Benutzeroberfläche als Umgebungsschlüssel bezeichnet. claude.ai zeigt das Geheimnis einmal an, und Sie können es später nicht abrufen; es läuft 365 Tage nach der Erstellung ab. Die `ccpool_...`-ID der Umgebung bleibt in ihrem Detaildialog sichtbar; Sie benötigen sie für die `aud`-Überprüfung in [Token-Verifizierung](https://code.claude.com/docs/de/self-hosted-environments-identity.md) und zum Versenden von [Test-Sitzungen aus CI](https://code.claude.com/docs/de/self-hosted-environments-testing.md#run-the-test-loop).74Gehen Sie zur [**Cloud-Umgebungen** Seite](https://claude.ai/admin-settings/cloud-environments) in den Admin-Einstellungen. Wählen Sie unter **Selbstgehostete Umgebungen** die Option **Neu**, benennen Sie die Umgebung und wählen Sie **Erstellen**. Wählen Sie im zweiten Schritt des Assistenten **Umgebungsschlüssel kopieren**, um das Umgebungsgeheimnis zu kopieren, das die Admin-Benutzeroberfläche als Umgebungsschlüssel bezeichnet. claude.ai zeigt das Geheimnis einmal an, und Sie können es später nicht abrufen; es läuft 365 Tage nach der Erstellung ab. Die `ccpool_...`-ID der Umgebung bleibt in ihrem Detaildialog sichtbar; Sie benötigen sie für die `aud`-Überprüfung in [Token-Verifizierung](https://code.claude.com/docs/de/self-hosted-environments-identity.md) und zum Versenden von [Test-Sitzungen aus CI](https://code.claude.com/docs/de/self-hosted-environments-testing.md#run-the-test-loop).

75 75

76Wenn Sie das Geheimnis verlieren oder es rotieren müssen, erstellen Sie ein neues Geheimnis auf der Registerkarte **Konfiguration** der Umgebung, rollen Sie das neue Geheimnis auf Ihren Runnern aus und widerrufen Sie dann das alte. Runner, die ein widerrufenes Geheimnis halten, schlagen ihre nächste authentifizierte Abfrage fehl und beenden sich, protokollieren `poll auth failed`, und Ihr Orchestrator startet sie mit dem neuen Geheimnis neu.76Wenn das Geheimnis möglicherweise offengelegt wurde, folgen Sie [den Schritten der Bereitstellungsseite für eine vermutete Kompromittierung](https://code.claude.com/docs/de/self-hosted-environments-deploy.md#after-a-suspected-compromise), nicht der unten beschriebenen Rotation.

78Wenn Sie das Geheimnis verlieren oder es rotieren möchten, erstellen Sie ein neues Geheimnis auf der Registerkarte **Konfiguration** der Umgebung. Rollen Sie das neue Geheimnis auf Ihren Runnern aus und widerrufen Sie dann das alte. Runner, die ein widerrufenes Geheimnis halten, schlagen ihre nächste authentifizierte Abfrage fehl und beenden sich, protokollieren `poll auth failed`, und Ihr Orchestrator startet sie mit dem neuen Geheimnis neu.

77 79

78**2. Starten Sie einen Runner**80**2. Starten Sie einen Runner**

79 81

self-hosted-environments-reference.md +1 −1

Details

141 141

142## Health-Endpunkt142## Health-Endpunkt

143 143

144Der Runner bedient `GET /healthz` auf dem konfigurierten Health-Port. Die Antwort ist `200 OK`, wann immer der Prozess am Leben ist, unabhängig davon, in welchem Zustand sich die Abfrageschleife befindet, sodass ein HTTP-Probe auf diesem Endpunkt nur einen toten Prozess erkennt. Der JSON-Body beschreibt den aktuellen Zustand:144Der Runner bedient `GET /healthz` auf dem konfigurierten Health-Port, sobald er sich registriert und seine Startprüfungen abgeschlossen hat. Ab diesem Zeitpunkt ist die Antwort `200 OK`, wann immer der Prozess am Leben ist, unabhängig davon, in welchem Zustand sich die Abfrageschleife befindet, sodass ein HTTP-Probe auf diesem Endpunkt nur einen toten Prozess erkennt. Der JSON-Body beschreibt den aktuellen Zustand:

145 145

146```json theme={null}146```json theme={null}

147{147{

settings.md +1 −0

Details

310| [`isolatePeerMachines`](https://code.claude.com/docs/de/settings-reference#isolatepeermachines) | `true` aus jedem Geltungsbereich | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt |310| [`isolatePeerMachines`](https://code.claude.com/docs/de/settings-reference#isolatepeermachines) | `true` aus jedem Geltungsbereich | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt |

311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` aus jedem Geltungsbereich | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt. Erfordert Claude Code v2.1.257 oder höher |311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` aus jedem Geltungsbereich | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt. Erfordert Claude Code v2.1.257 oder höher |

312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` aus jedem Geltungsbereich | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt. Erfordert Claude Code v2.1.314 oder höher |312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/de/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` aus jedem Geltungsbereich | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt. Erfordert Claude Code v2.1.314 oder höher |

313| [`permissions.denyInsteadOfPrompting`](https://code.claude.com/docs/de/settings-reference#permissions-denyinsteadofprompting) | `true` aus `~/.claude/settings.json` oder `--settings` | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt. Erfordert Claude Code v2.1.319 oder höher |

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/de/settings-reference#automode-classifyallshell) | `true` aus `~/.claude/settings.json` oder `--settings` | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt |314| [`autoMode.classifyAllShell`](https://code.claude.com/docs/de/settings-reference#automode-classifyallshell) | `true` aus `~/.claude/settings.json` oder `--settings` | Wird berücksichtigt, auch wenn eine verwaltete Quelle `false` setzt |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/de/settings-reference#remotecontrolatstartup) | `false` aus `.claude/settings.json` oder `.claude/settings.local.json` | Wird berücksichtigt, auch wenn eine verwaltete Quelle `true` setzt; ein `true` im Projekt oder lokal wird ignoriert |315| [`remoteControlAtStartup`](https://code.claude.com/docs/de/settings-reference#remotecontrolatstartup) | `false` aus `.claude/settings.json` oder `.claude/settings.local.json` | Wird berücksichtigt, auch wenn eine verwaltete Quelle `true` setzt; ein `true` im Projekt oder lokal wird ignoriert |

315| [`crossSessionInbound`](https://code.claude.com/docs/de/settings-reference#crosssessioninbound) | Ein strengerer Wert aus `.claude/settings.json` oder `.claude/settings.local.json`, auf der Stufenleiter `accept` \< `hold` \< `refuse` | Hat Vorrang vor verwalteten Werten, `--settings` und Benutzerwerten; ein Projekt- oder lokaler Wert, der nicht strenger ist, wird ignoriert |316| [`crossSessionInbound`](https://code.claude.com/docs/de/settings-reference#crosssessioninbound) | Ein strengerer Wert aus `.claude/settings.json` oder `.claude/settings.local.json`, auf der Stufenleiter `accept` \< `hold` \< `refuse` | Hat Vorrang vor verwalteten Werten, `--settings` und Benutzerwerten; ein Projekt- oder lokaler Wert, der nicht strenger ist, wird ignoriert |

settings-reference.md +4 −4

Details

448 448

449Schalten Sie den [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md) für Sitzungen ein, in denen er verfügbar ist, etwa für interaktive Arbeit wie schnelle Iteration oder Live-Debugging, bei der Ihnen Geschwindigkeit höhere Kosten pro Token wert ist. Normalerweise bearbeiten Sie diesen Schlüssel nicht selbst. Das Ausführen von `/fast` schreibt `fastMode: true` in `~/.claude/settings.json`, und erneutes Ausführen zum Ausschalten des Fast-Modus entfernt den Schlüssel.449Schalten Sie den [Fast-Modus](https://code.claude.com/docs/de/fast-mode.md) für Sitzungen ein, in denen er verfügbar ist, etwa für interaktive Arbeit wie schnelle Iteration oder Live-Debugging, bei der Ihnen Geschwindigkeit höhere Kosten pro Token wert ist. Normalerweise bearbeiten Sie diesen Schlüssel nicht selbst. Das Ausführen von `/fast` schreibt `fastMode: true` in `~/.claude/settings.json`, und erneutes Ausführen zum Ausschalten des Fast-Modus entfernt den Schlüssel.

450 450

451Nur Opus 5.5, Opus 5 und Opus 4.8 unterstützen den Fast-Modus. Wenn Sie `/fast` von einem anderen Modell aus ausführen, wechseln Sie zu Opus, und ein Wechsel zu einem nicht unterstützten Modell schaltet den Fast-Modus aus. Siehe [Modelle wechseln, während der Fast-Modus eingeschaltet ist](https://code.claude.com/docs/de/fast-mode.md#switch-models-while-fast-mode-is-on).451Nur Fable 5.2, Opus 5.5, Opus 5 und Opus 4.8 unterstützen den Fast-Modus. Wenn Sie `/fast` von einem anderen Modell aus ausführen, wechseln Sie zu Opus, und ein Wechsel zu einem nicht unterstützten Modell schaltet den Fast-Modus aus. Siehe [Modelle wechseln, während der Fast-Modus eingeschaltet ist](https://code.claude.com/docs/de/fast-mode.md#switch-models-while-fast-mode-is-on).

452 452

453* **Geltungsbereich**: [`Any file`](#scopes)453* **Geltungsbereich**: [`Any file`](#scopes)

454* **Typ**: Boolean454* **Typ**: Boolean

455 * `true`: Claude Code schaltet den Fast-Modus für Sitzungen ein, in denen er verfügbar ist455 * `true`: Claude Code schaltet den Fast-Modus für Sitzungen ein, in denen er verfügbar ist. Bei Fable 5.2 müssen Sie außerdem [`/fast` ausführen, während Sie Fable 5.2 verwenden](https://code.claude.com/docs/de/fast-mode#switch-models-while-fast-mode-is-on)

456 * `false`: Der Fast-Modus bleibt ausgeschaltet456 * `false`: Der Fast-Modus bleibt ausgeschaltet

457* **Standard**: nicht gesetzt, der Fast-Modus ist also ausgeschaltet457* **Standard**: nicht gesetzt, der Fast-Modus ist also ausgeschaltet

458* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/de/env-vars) schaltet den Fast-Modus für eine Sitzung aus, und dieser Schlüssel kann ihn nicht wieder einschalten458* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/de/env-vars) schaltet den Fast-Modus für eine Sitzung aus, und dieser Schlüssel kann ihn nicht wieder einschalten

465 465

466### `fastModePerSessionOptIn`466### `fastModePerSessionOptIn`

467 467

468Normalerweise speichert das Ausführen von `/fast` den Schlüssel [`fastMode`](#fastmode) in den Benutzereinstellungen einer Person, sodass neue Sitzungen mit einem unterstützten Modell mit eingeschaltetem Fast-Modus starten. Setzen Sie diesen Schlüssel auf `true`, um das zu verhindern: Ein gespeichertes `fastMode: true` schaltet den Fast-Modus beim Sitzungsstart nicht mehr ein, und jede Person muss `/fast` in jeder Sitzung ausführen, in der sie ihn nutzen möchte. Claude Code belässt den Schlüssel `fastMode` in der Datei, sodass das Ausschalten dieses Schlüssels das alte Verhalten wiederherstellt.468Normalerweise speichert das Ausführen von `/fast` den Schlüssel [`fastMode`](#fastmode) in den Benutzereinstellungen einer Person, sodass neue Sitzungen mit einem unterstützten Modell mit eingeschaltetem Fast-Modus starten. Bei Fable 5.2 geschieht das nur, wenn die Person ihn [eingeschaltet hat, während sie Fable 5.2 verwendet hat](https://code.claude.com/docs/de/fast-mode.md#switch-models-while-fast-mode-is-on). Damit jede Person `/fast` in jeder Sitzung ausführen muss, in der sie ihn nutzen möchte, setzen Sie diesen Schlüssel auf `true`. Claude Code belässt den Schlüssel `fastMode` in der Datei, sodass das Ausschalten dieses Schlüssels das alte Verhalten wiederherstellt.

469 469

470Owner in Team- oder Enterprise-Plänen können ihn organisationsweit über [serververwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) bereitstellen. Wenn verwaltete Einstellungen den Schlüssel setzen, wird `/fast on` außerhalb interaktiver Terminal-Sitzungen abgelehnt und meldet, dass Ihre Organisation den Fast-Modus deaktiviert hat. Das betrifft den [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md), die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) und [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md).470Owner in Team- oder Enterprise-Plänen können ihn organisationsweit über [serververwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) bereitstellen. Wenn verwaltete Einstellungen den Schlüssel setzen, wird `/fast on` außerhalb interaktiver Terminal-Sitzungen abgelehnt und meldet, dass Ihre Organisation den Fast-Modus deaktiviert hat. Das betrifft den [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md), die [VS Code-Erweiterung](https://code.claude.com/docs/de/vs-code.md) und [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md).

471 471

472* **Geltungsbereich**: [`Any file`](#scopes)472* **Geltungsbereich**: [`Any file`](#scopes)

473* **Typ**: Boolean473* **Typ**: Boolean

474 * `true`: Ein gespeichertes `fastMode: true` schaltet den Fast-Modus beim Sitzungsstart nicht mehr ein, sodass jede Person `/fast` in jeder Sitzung ausführt, in der sie ihn nutzen möchte; ein mit `--settings` übergebenes `fastMode: true` gilt weiterhin für diese Sitzung, sofern verwaltete Einstellungen diesen Schlüssel nicht setzen474 * `true`: Ein gespeichertes `fastMode: true` schaltet den Fast-Modus beim Sitzungsstart nicht mehr ein, sodass jede Person `/fast` in jeder Sitzung ausführt, in der sie ihn nutzen möchte; ein mit `--settings` übergebenes `fastMode: true` gilt weiterhin für diese Sitzung, sofern verwaltete Einstellungen diesen Schlüssel nicht setzen

475 * `false`: Ein gespeichertes `fastMode: true` schaltet den Fast-Modus zu Beginn jeder neuen Sitzung mit einem unterstützten Modell ein475 * `false`: Ein gespeichertes `fastMode: true` wirkt so, wie unter [`fastMode`](#fastmode) beschrieben

476* **Standard**: `false`476* **Standard**: `false`

477 477

478```json settings.json theme={null}478```json settings.json theme={null}

sub-agents.md +2 −0

Details

592Die Hauptkonversation's Berechtigungsmodus entscheidet, ob Claude Code den Wert verwendet, den Sie setzen:592Die Hauptkonversation's Berechtigungsmodus entscheidet, ob Claude Code den Wert verwendet, den Sie setzen:

593 593

594* Wenn die Hauptkonversation in `bypassPermissions`, `acceptEdits` oder [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) ist, läuft der Subagent in diesem gleichen Modus und Claude Code ignoriert den `permissionMode`, den Sie setzen. Unter Auto-Modus bewertet der Klassifizierer die Werkzeugaufrufe des Subagenten mit den Block- und Zulassungsregeln der Hauptkonversation. Wenn der Subagent endet, überprüft der Klassifizierer auch seine Arbeit und seinen endgültigen Bericht, bevor der Bericht geliefert wird, wie [Wie Auto-Modus Subagenten handhabt](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) beschreibt.594* Wenn die Hauptkonversation in `bypassPermissions`, `acceptEdits` oder [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) ist, läuft der Subagent in diesem gleichen Modus und Claude Code ignoriert den `permissionMode`, den Sie setzen. Unter Auto-Modus bewertet der Klassifizierer die Werkzeugaufrufe des Subagenten mit den Block- und Zulassungsregeln der Hauptkonversation. Wenn der Subagent endet, überprüft der Klassifizierer auch seine Arbeit und seinen endgültigen Bericht, bevor der Bericht geliefert wird, wie [Wie Auto-Modus Subagenten handhabt](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) beschreibt.

595

596 Wenn ein Subagent um Erlaubnis fragt, während die Hauptkonversation in `bypassPermissions` ist, prüfen Sie, ob sein Tool-Aufruf zu den [Aktionen gehört, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves).

595* Wenn die Hauptkonversation im Modus `plan` ist, bleibt der Subagent im Plan-Modus, unabhängig davon, welchen `permissionMode` Sie setzen, es sei denn, er läuft als [Teammate eines Agent-Teams](#subagent-names) gemäß den [Regeln für Agent-Teams](https://code.claude.com/docs/de/agent-teams.md#have-teammates-plan-before-implementing). Wenn Sie `dontAsk` setzen, fragt der Subagent Sie außerdem nicht nach: Eine Aktion, für die der Plan-Modus Sie um Genehmigung bitten würde, wird stattdessen abgelehnt.597* Wenn die Hauptkonversation im Modus `plan` ist, bleibt der Subagent im Plan-Modus, unabhängig davon, welchen `permissionMode` Sie setzen, es sei denn, er läuft als [Teammate eines Agent-Teams](#subagent-names) gemäß den [Regeln für Agent-Teams](https://code.claude.com/docs/de/agent-teams.md#have-teammates-plan-before-implementing). Wenn Sie `dontAsk` setzen, fragt der Subagent Sie außerdem nicht nach: Eine Aktion, für die der Plan-Modus Sie um Genehmigung bitten würde, wird stattdessen abgelehnt.

596* Wenn die Hauptkonversation im Modus `default` oder `dontAsk` ist, läuft der Subagent in dem Berechtigungsmodus, den Sie setzen. In diesen Fällen behält er stattdessen den Berechtigungsmodus der Hauptkonversation:598* Wenn die Hauptkonversation im Modus `default` oder `dontAsk` ist, läuft der Subagent in dem Berechtigungsmodus, den Sie setzen. In diesen Fällen behält er stattdessen den Berechtigungsmodus der Hauptkonversation:

597 * Sie setzen `bypassPermissions`. Die `bypassPermissions`-Ausnahme erfordert Claude Code v2.1.267 oder später.599 * Sie setzen `bypassPermissions`. Die `bypassPermissions`-Ausnahme erfordert Claude Code v2.1.267 oder später.

tools-reference.md +22 −7

Details

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. 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 bitten, die Sitzung zu beenden, und dies anschließend bestätigen. Siehe [EndConversation-Tool-Verhalten](#endconversation-tool-behavior) | Nein |

31| `EnterWorktree` | Erstellt einen isolierten [Git-Worktree](https://code.claude.com/docs/de/worktrees.md) und wechselt hinein oder wechselt in einen vorhandenen Worktree. Siehe [EnterWorktree-Tool-Verhalten](#enterworktree-tool-behavior) | Ja |31| `EnterWorktree` | Erstellt einen isolierten [Git-Worktree](https://code.claude.com/docs/de/worktrees.md) und wechselt hinein oder wechselt in einen vorhandenen Worktree. Siehe [EnterWorktree-Tool-Verhalten](#enterworktree-tool-behavior) | Ja |

32| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet den Plan-Modus | Ja |32| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet den Plan-Modus | Ja |

274 274

275Das EndConversation-Tool beendet die aktuelle Sitzung. Claude verwendet es nur in zwei Situationen:275Das EndConversation-Tool beendet die aktuelle Sitzung. Claude verwendet es nur in zwei Situationen:

276 276

277* als letztes Mittel gegen anhaltende missbräuchliche Eingaben, nachdem Versuche, das Gespräch umzuleiten, fehlgeschlagen sind und nachdem eine klare Warnung in einer früheren Nachricht erfolgt ist277* wenn Sie weiterhin missbräuchliche Nachrichten senden, nachdem Claude eine klare Warnung ausgesprochen hat und es nicht gelungen ist, die Konversation umzulenken

278* wenn Sie explizit darum bitten, das Tool demonstriert zu sehen, und bestätigen, dass Sie die Sitzung beenden möchten278* wenn Sie Claude ausdrücklich bitten, die Sitzung zu beenden, und dies bestätigen, wenn Claude fragt, ob Sie tatsächlich fortfahren möchten

279 279

280Allgemeine Frustration, Fluchen oder eine schlecht laufende Aufgabe qualifizieren sich nicht, und ebenso wenig Anfragen nach schädlichen Inhalten, die Claude ablehnt, anstatt die Sitzung zu beenden. Claude Code folgt dem gleichen Ansatz wie claude.ai, das [eine seltene Teilmenge von Chats beenden kann](https://www.anthropic.com/research/end-subset-conversations).280Allgemeine Frustration, Fluchen oder eine schlecht laufende Aufgabe qualifizieren sich nicht, und ebenso wenig Anfragen nach schädlichen Inhalten, die Claude ablehnt, anstatt die Sitzung zu beenden. Claude Code folgt dem gleichen Ansatz wie claude.ai, das [eine seltene Teilmenge von Chats beenden kann](https://www.anthropic.com/research/end-subset-conversations).

281 281

390 390

391Wenn Monitor einen Befehl ausführt, verwendet es die gleichen [Berechtigungsregeln wie Bash](https://code.claude.com/docs/de/permissions.md#tool-specific-permission-rules), daher gelten `allow`- und `deny`-Muster, die Sie für Bash festgelegt haben, auch hier. Während der [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) aktiv ist, setzt Claude Code allow-Regeln beiseite, die `Monitor` selbst benennen, zusammen mit den anderen [breiten allow-Regeln, die es verwirft](https://code.claude.com/docs/de/permission-modes.md#how-the-classifier-evaluates-actions), sodass der Klassifikator Monitor-Befehle auf die gleiche Weise überprüft wie Bash-Befehle.391Wenn Monitor einen Befehl ausführt, verwendet es die gleichen [Berechtigungsregeln wie Bash](https://code.claude.com/docs/de/permissions.md#tool-specific-permission-rules), daher gelten `allow`- und `deny`-Muster, die Sie für Bash festgelegt haben, auch hier. Während der [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) aktiv ist, setzt Claude Code allow-Regeln beiseite, die `Monitor` selbst benennen, zusammen mit den anderen [breiten allow-Regeln, die es verwirft](https://code.claude.com/docs/de/permission-modes.md#how-the-classifier-evaluates-actions), sodass der Klassifikator Monitor-Befehle auf die gleiche Weise überprüft wie Bash-Befehle.

392 392

393Die [WebSocket-Quelle](#websocket-source) hat ihre eigene Genehmigungsabfrage, die der Klassifikator auch im Auto-Modus entscheidet.

~~394~~

395Monitor benötigt in diesen Fällen eine Mindestversion oder Git Bash:393Monitor benötigt in diesen Fällen eine Mindestversion oder Git Bash:

396 394

397* **Mindestversion**: Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform oder Microsoft Foundry sowie wenn `DISABLE_TELEMETRY` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist, erfordert Monitor Claude Code v2.1.310 oder höher. Die Anforderung gilt, wenn das [Abrufen von Feature-Flags](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching) deaktiviert ist395* **Mindestversion**: Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform oder Microsoft Foundry sowie wenn `DISABLE_TELEMETRY` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist, erfordert Monitor Claude Code v2.1.310 oder höher. Die Anforderung gilt, wenn das [Abrufen von Feature-Flags](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching) deaktiviert ist

417 415

418Die `timeout_ms`-Frist gilt auch für eine WebSocket-Überwachung: die Überwachung endet bei der Frist, und `TaskStop` bricht sie früh ab.416Die `timeout_ms`-Frist gilt auch für eine WebSocket-Überwachung: die Überwachung endet bei der Frist, und `TaskStop` bricht sie früh ab.

419 417

420Das Öffnen einer WebSocket fragt nach einer Genehmigung; im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) entscheidet der Klassifikator stattdessen. Die Abfrage bietet keine Option, zukünftige Abfragen für denselben Host zu überspringen.418Ohne eine `Monitor`-allow-Regel werden Sie um Bestätigung gebeten, bevor Claude eine WebSocket öffnet; im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) entscheidet stattdessen der Klassifikator, es sei denn, eine [ask-Regel](#bash-rules-that-deny-or-prompt-for-websocket-watches) greift. Die Abfrage bietet keine Option, zukünftige Abfragen für denselben Host zu überspringen.

419

420#### Für WebSocket-Überwachungen abgelehnte Adressen und Hosts

421

422Claude Code lehnt URLs ab, die auf eine private, Link-Local- oder Cloud-Metadaten-Adresse verweisen, einschließlich Hostnamen, die Ihr Rechner zu einer solchen auflöst. Hinter einem [Proxy](https://code.claude.com/docs/de/network-config.md#proxy-configuration) kann eine Überwachung eine private, Link-Local- oder Cloud-Metadaten-Adresse erreichen, sofern der Proxy sie nicht blockiert, da Claude Code die vom Proxy ermittelte Adresse nicht prüft. Claude Code lehnt außerdem Hosts in `sandbox.network.deniedDomains` ab, und wenn [`allowManagedDomainsOnly`](https://code.claude.com/docs/de/settings-reference#sandbox-network-allowmanageddomainsonly) in verwalteten Einstellungen gesetzt ist, jeden Host außerhalb der verwalteten Allowlist.

423

424Wenn eine Überwachung hinter einem Proxy mit `could not resolve <host>` fehlschlägt, starten Sie Claude Code v2.1.319 oder höher neu, wobei [`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`](https://code.claude.com/docs/de/env-vars#variables) auf `1` gesetzt ist, damit der Proxy den Hostnamen auflöst.

425

426#### Bash-Regeln, die WebSocket-Überwachungen ablehnen oder eine Abfrage auslösen

427

428Wenn Claude Code einen `Monitor`-Aufruf ablehnt, der eine WebSocket öffnet, suchen Sie nach einer [deny- oder ask-Regel](https://code.claude.com/docs/de/permissions.md#manage-permissions), die als `Bash` oder `Bash(*)` geschrieben ist. Gehen Sie genauso vor, wenn für diesen Aufruf trotz Ihrer `Monitor`-allow-Regel nachgefragt wird. Eine Regel für jeden Bash-Befehl deckt auch diese WebSocket-Überwachungen ab:

429

430* **deny-Regel**: Wenn die Regel beim Start der Sitzung besteht, hat Claude das Monitor-Tool nicht und kann die Überwachung daher nicht starten. Wenn Sie die Regel während einer Sitzung hinzufügen, wird Claudes nächster `Monitor`-Aufruf abgelehnt. Die Ablehnung lautet `Permission to use Monitor has been denied: it runs code as Bash does, and a rule denies Bash.`

431* **ask-Regel**: Sie werden gebeten, die Überwachung zu genehmigen. Eine allow-Regel, ein `PreToolUse`-Hook, der `bypassPermissions`-Modus oder der Klassifikator des Auto-Modus können sie nicht für Sie genehmigen. Sie können sie über einen [`PermissionRequest`-Hook](https://code.claude.com/docs/de/hooks#permissionrequest) genehmigen. Wo niemand antworten kann, etwa im `dontAsk`-Modus, lehnt Claude Code die Überwachung ab.

432

433Damit diese Überwachungen laufen können, schränken Sie die Regel auf die gemeinten Befehle ein, etwa `Bash(rm *)`.

421 434

422Claude Code lehnt URLs ab, die auf eine private, Link-Local- oder Cloud-Metadaten-Adresse verweisen, einschließlich Hostnamen, die zu einer aufgelöst werden. Es lehnt auch Hosts in `sandbox.network.deniedDomains` ab, und wenn [`allowManagedDomainsOnly`](https://code.claude.com/docs/de/settings-reference#sandbox-network-allowmanageddomainsonly) in verwalteten Einstellungen gesetzt ist, jeden Host außerhalb der verwalteten Allowlist.435Die ask-Regel sowie eine während einer Sitzung hinzugefügte deny-Regel decken diese Überwachungen in Claude Code v2.1.319 oder höher ab.

423 436

424## NotebookEdit-Werkzeugverhalten437## NotebookEdit-Werkzeugverhalten

425 438

594* Nicht-interaktiven `-p`-Läufen und [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Sitzungen, die keinen Bildschirm zum Überprüfen der Warteschlange haben607* Nicht-interaktiven `-p`-Läufen und [Agent SDK](https://code.claude.com/docs/de/agent-sdk/overview.md)-Sitzungen, die keinen Bildschirm zum Überprüfen der Warteschlange haben

595* [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md), die nicht in die Warteschlange auf Ihrem Computer schreiben können608* [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md), die nicht in die Warteschlange auf Ihrem Computer schreiben können

596* Sitzungen auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) oder [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md)609* Sitzungen auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) oder [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md)

610* Sitzungen, die Claude über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway) mit dem eigenen Schlüssel oder Token des Gateways erreichen

597* Sitzungen, in denen Sie [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/de/env-vars) oder [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/de/env-vars) setzen, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` auf einen beliebigen nicht-leeren Wert setzen oder [Feature-Flag-Abruf](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching) deaktiviert haben611* Sitzungen, in denen Sie [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/de/env-vars) oder [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/de/env-vars) setzen, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` auf einen beliebigen nicht-leeren Wert setzen oder [Feature-Flag-Abruf](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching) deaktiviert haben

598* Organisationen, die Produktfeedback deaktiviert haben, [Organisationen mit Null-Datenspeicherung](https://code.claude.com/docs/de/zero-data-retention.md#features-disabled-under-zdr) und Organisationen, in denen die [HIPAA-Konfiguration](https://code.claude.com/docs/de/hipaa-setup.md) angewendet wurde612* Organisationen, die Produktfeedback deaktiviert haben, [Organisationen mit Null-Datenspeicherung](https://code.claude.com/docs/de/zero-data-retention.md#features-disabled-under-zdr) und Organisationen, in denen die [HIPAA-Konfiguration](https://code.claude.com/docs/de/hipaa-setup.md) angewendet wurde

613* Sitzungen, in denen Claude Code [nach einem abgelehnten Bericht kein Feedback mehr anbietet](https://code.claude.com/docs/de/errors.md#feedback-is-disabled-by-your-organizations-policy)

599 614

600## Verfügbarkeit des Task-Tools615## Verfügbarkeit des Task-Tools

601 616

zero-data-retention.md +2 −2

Details

70 70

71### Modellverfügbarkeit unter ZDR71### Modellverfügbarkeit unter ZDR

72 72

73Claude Fable 5.1 und Fable 5 sind [Covered Models](https://support.claude.com/en/articles/15425695-covered-models), die [Datenspeicherung erfordern](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements), und ob eine ZDR-Organisation oder ein Workspace diese verwenden kann, wird durch die Covered Models-Richtlinien und nicht durch Claude Code geregelt. Wenn Ihre Organisation diese nicht verwenden kann, fehlen die Modelle entweder in der `/model`-Auswahl oder werden als deaktiviert angezeigt, und der Server lehnt Anfragen dafür unabhängig von der Client-Konfiguration ab.73Claude Fable 5.2, Fable 5.1 und Fable 5 sind [Covered Models](https://support.claude.com/en/articles/15425695-covered-models), die standardmäßig [Datenspeicherung erfordern](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements), und ob eine ZDR-Organisation oder ein Workspace diese verwenden kann, wird durch die Covered Models-Richtlinien und nicht durch Claude Code geregelt. Wenn Ihre Organisation diese nicht verwenden kann, fehlen die Modelle entweder in der `/model`-Auswahl oder werden als deaktiviert angezeigt, und der Server lehnt Anfragen dafür unabhängig von der Client-Konfiguration ab.

74 74

75Andere Modelle bleiben unter ZDR verfügbar. Fable-Modelle sind nicht das Standard-Modell, und der `best`-Alias, der sich zu dem neuesten Fable-Modell auflöst, wo er verfügbar ist, wird zu Opus für Organisationen, wo er nicht verfügbar ist.75Andere Modelle bleiben unter ZDR verfügbar. Fable-Modelle sind nicht das Standard-Modell, und der `best`-Alias wird zu Opus aufgelöst.

76 76

77## Datenspeicherung bei Richtlinienverletzungen77## Datenspeicherung bei Richtlinienverletzungen

78 78

Documentation 2026-11-08 22:58 UTC to 2026-11-09 23:02 UTC