SpyBara
Go Premium

Documentation 2026-11-03 23:58 UTC to 2026-11-04 23:59 UTC

33 files changed +510 −152. View all changes and history on the product overview
2026
Thu 12 21:00 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57
Details

231| Modus | Verhalten | Anwendungsfall |231| Modus | Verhalten | Anwendungsfall |

232| :- | :- | :- |232| :- | :- | :- |

233| `"default"` | Tool-Aufrufe, die Genehmigung benötigen und nicht durch Allow-Regeln abgedeckt sind, lösen Ihren `canUseTool`-Callback aus; kein Callback bedeutet Ablehnung | Interaktive Anwendungen mit einem benutzerdefinierten Genehmigungsrückruf |233| `"default"` | Tool-Aufrufe, die Genehmigung benötigen und nicht durch Allow-Regeln abgedeckt sind, lösen Ihren `canUseTool`-Callback aus; kein Callback bedeutet Ablehnung | Interaktive Anwendungen mit einem benutzerdefinierten Genehmigungsrückruf |

234| `"acceptEdits"` | Genehmigt automatisch Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp` usw.); andere Bash-Befehle folgen Standardregeln | Sie vertrauen Claudes Bearbeitungen und möchten schnellere Iterationen, z. B. während des Prototyping oder beim Arbeiten in einem isolierten Verzeichnis |234| `"acceptEdits"` | Genehmigt automatisch Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp` usw.) innerhalb Ihrer [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories); andere Bash-Befehle folgen Standardregeln | Sie vertrauen Claudes Bearbeitungen und möchten schnellere Iterationen, z. B. während des Prototyping oder beim Arbeiten in einem isolierten Verzeichnis |

235| `"plan"` | Claude erkundet und plant, ohne Ihre Quelldateien zu bearbeiten; Dateibearbeitungen werden nie automatisch genehmigt und werden durch Ihren `canUseTool`-Callback angefordert | Sie möchten, dass Claude Änderungen vorschlägt, ohne sie auszuführen, z. B. während einer Code-Überprüfung oder wenn Sie Änderungen genehmigen müssen, bevor sie vorgenommen werden |235| `"plan"` | Claude erkundet und plant. Bearbeitungen, die mit Claudes Datei-Tools vorgenommen werden, gehen an Ihren `canUseTool`-Callback, selbst wenn eine Allow-Regel auf sie zutrifft | Sie möchten, dass Claude zuerst einen Plan erstellt, z. B. während eines Code-Reviews oder vor einer größeren Änderung |

236| `"dontAsk"` | Fragt nie nach. Tools, die durch [Berechtigungsregeln](https://code.claude.com/docs/de/settings-reference.md#permission-settings) vorab genehmigt sind, werden ausgeführt, ebenso wie Aufrufe, die im `default`-Modus keine Genehmigung benötigen, z. B. Datei-Lesevorgänge in Ihren Arbeitsverzeichnissen. Jeder Aufruf, bei dem sonst nachgefragt würde, wird abgelehnt, wobei ein von Ihnen installierter [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) [einige dieser Aufrufe](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) dennoch genehmigen kann. Einige Aufrufe, z. B. [Lesevorgänge von Netzwerkpfaden](https://code.claude.com/docs/de/permissions.md#network-paths), werden auch dann abgelehnt, wenn Sie sie erlaubt haben. Die Liste finden Sie unter [Don't ask mode](https://code.claude.com/docs/de/agent-sdk/permissions.md#don’t-ask-mode-dontask) | Headless-Agenten, bei denen niemand Aufrufe genehmigen kann |236| `"dontAsk"` | Fragt nie nach. Tools, die durch [Berechtigungsregeln](https://code.claude.com/docs/de/settings-reference.md#permission-settings) vorab genehmigt sind, werden ausgeführt, ebenso wie Aufrufe, die im `default`-Modus keine Genehmigung benötigen, z. B. Datei-Lesevorgänge in Ihren Arbeitsverzeichnissen. Jeder Aufruf, bei dem sonst nachgefragt würde, wird abgelehnt, wobei ein von Ihnen installierter [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) [einige dieser Aufrufe](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) dennoch genehmigen kann. Einige Aufrufe, z. B. [Lesevorgänge von Netzwerkpfaden](https://code.claude.com/docs/de/permissions.md#network-paths), werden auch dann abgelehnt, wenn Sie sie erlaubt haben. Die Liste finden Sie unter [Don't ask mode](https://code.claude.com/docs/de/agent-sdk/permissions.md#don’t-ask-mode-dontask) | Headless-Agenten, bei denen niemand Aufrufe genehmigen kann |

237| `"auto"` | Verwendet einen Modell-Klassifizierer, um Aktionen wie Shell-Befehle und Netzwerkanfragen zu überprüfen und jede einzelne zu genehmigen oder zu blockieren. Siehe [Auto mode](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) für Verfügbarkeit und die Entscheidungsreihenfolge | Autonome Agenten, die immer noch Sicherheitsvorkehrungen bei der Tool-Nutzung wünschen |237| `"auto"` | Verwendet einen Modell-Klassifizierer, um Aktionen wie Shell-Befehle und Netzwerkanfragen zu überprüfen und jede einzelne zu genehmigen oder zu blockieren. Siehe [Auto mode](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) für Verfügbarkeit und die Entscheidungsreihenfolge | Autonome Agenten, die immer noch Sicherheitsvorkehrungen bei der Tool-Nutzung wünschen |

238| `"bypassPermissions"` | Führt Tool-Aufrufe aus, ohne um Genehmigung zu fragen, einschließlich Aufrufen von Tools, die Sie nicht in `allowedTools` aufgeführt haben. Einige Aufrufe gehen dennoch an Ihren `canUseTool`-Callback; diese sind unter [Bypass permissions mode](https://code.claude.com/docs/de/agent-sdk/permissions.md#bypass-permissions-mode-bypasspermissions) aufgeführt. Im TypeScript SDK ist auch `allowDangerouslySkipPermissions: true` in `options` erforderlich. Kann nicht verwendet werden, wenn als Root auf Unix ausgeführt wird. Verwenden Sie nur in isolierten Umgebungen, in denen die Aktionen des Agenten keine Systeme beeinflussen können, die Ihnen wichtig sind | CI, Container oder andere isolierte Umgebungen |238| `"bypassPermissions"` | Führt Tool-Aufrufe aus, ohne um Genehmigung zu fragen, einschließlich Aufrufen von Tools, die Sie nicht in `allowedTools` aufgeführt haben. Einige Aufrufe gehen dennoch an Ihren `canUseTool`-Callback; diese sind unter [Bypass permissions mode](https://code.claude.com/docs/de/agent-sdk/permissions.md#bypass-permissions-mode-bypasspermissions) aufgeführt. Im TypeScript SDK ist auch `allowDangerouslySkipPermissions: true` in `options` erforderlich. Kann nicht verwendet werden, wenn als Root auf Unix ausgeführt wird. Verwenden Sie nur in isolierten Umgebungen, in denen die Aktionen des Agenten keine Systeme beeinflussen können, die Ihnen wichtig sind | CI, Container oder andere isolierte Umgebungen |

239 239 

240Verwenden Sie für interaktive Anwendungen `"default"` mit einem Tool-Genehmigungsrückruf, um Genehmigungsaufforderungen anzuzeigen. Für autonome Agenten auf einem Dev-Computer genehmigt `"acceptEdits"` automatisch Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp` usw.), während andere `Bash`-Befehle immer noch durch Allow-Regeln kontrolliert werden. Reservieren Sie `"bypassPermissions"` für CI, Container oder andere isolierte Umgebungen. Siehe [Permissions](https://code.claude.com/docs/de/agent-sdk/permissions.md) für vollständige Details.240Verwenden Sie für interaktive Anwendungen `"default"` mit einem Tool-Genehmigungsrückruf, um Genehmigungsabfragen anzuzeigen. Verwenden Sie für Agenten, die Dateien auf einem Dev-Computer bearbeiten, `"acceptEdits"`. Reservieren Sie `"bypassPermissions"` für CI, Container oder andere isolierte Umgebungen. Siehe [Permissions](https://code.claude.com/docs/de/agent-sdk/permissions.md) für vollständige Details.

241 241 

242### Modell242### Modell

243 243 

Details

14>14>

15> Wenn Sie ein Plugin laden, das einen [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) enthält, erfahren Sie unter [wo sich die Entscheidungen eines Mods zwischen Regeln und Hooks einordnen](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) mehr.15> Wenn Sie ein Plugin laden, das einen [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) enthält, erfahren Sie unter [wo sich die Entscheidungen eines Mods zwischen Regeln und Hooks einordnen](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) mehr.

16 16 

17Wenn Claude ein Tool anfordert, prüft das SDK Berechtigungen in dieser Reihenfolge:17Wenn Claude ein Tool anfordert, prüft Claude Code den Aufruf in diesen Schritten. Jeder Schritt kann über den Aufruf entscheiden, ihn an Ihren `canUseTool` Callback senden oder ihn weitergeben:

18 18 

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

20 20 

21Führen Sie [Hooks](https://code.claude.com/docs/de/agent-sdk/hooks.md) zuerst 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 Deny- und Ask-Regeln unten; diese werden unabhängig vom Hook-Ergebnis ausgewertet.

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 

25**2. Deny-Regeln**25**2. Deny-Regeln**

26 26 

27Wenn eine Deny-Regel aus `disallowed_tools` oder [settings.json](https://code.claude.com/docs/de/settings-reference.md#permission-settings) zutrifft, wird der Aufruf abgelehnt und [`canUseTool`](https://code.claude.com/docs/de/agent-sdk/user-input) wird nicht aufgerufen, selbst im [`bypassPermissions`](#bypass-permissions-mode-bypasspermissions) Modus und selbst wenn ein Hook `allow` zurückgegeben hat.27Wenn eine Deny-Regel aus `disallowed_tools` oder aus einer [Einstellungsdatei, die das SDK lädt](#rules-in-settings-files), zutrifft, wird der Aufruf abgelehnt und [`canUseTool`](https://code.claude.com/docs/de/agent-sdk/user-input) wird nicht aufgerufen. Der Aufruf wird auf diese Weise selbst im [`bypassPermissions`](#bypass-permissions-mode-bypasspermissions) Modus abgelehnt und auch dann, wenn ein Hook `allow` zurückgegeben hat.

28 28 

29Wenn Sie im TypeScript SDK die `permission_policy` eines [benutzerdefinierten Tools](https://code.claude.com/docs/de/agent-sdk/custom-tools.md#require-approval-for-specific-tools) auf [`always_deny`](https://code.claude.com/docs/de/agent-sdk/typescript#mcpservertoolpolicy) setzen, wird ein Aufruf dieses Tools in diesem Schritt abgelehnt.29Wenn Sie im TypeScript SDK die `permission_policy` eines [benutzerdefinierten Tools](https://code.claude.com/docs/de/agent-sdk/custom-tools.md#require-approval-for-specific-tools) auf [`always_deny`](https://code.claude.com/docs/de/agent-sdk/typescript#mcpservertoolpolicy) setzen, wird ein Aufruf dieses Tools in diesem Schritt abgelehnt.

30 30 


32 32 

33Prüfen Sie `ask` Regeln aus [settings.json](https://code.claude.com/docs/de/settings-reference.md#permission-settings). Wenn eine Ask-Regel zutrifft, fällt der Aufruf in Ihren [`canUseTool` Callback](https://code.claude.com/docs/de/agent-sdk/user-input) zur Bestätigung, auch im `bypassPermissions` Modus.33Prüfen Sie `ask` Regeln aus [settings.json](https://code.claude.com/docs/de/settings-reference.md#permission-settings). Wenn eine Ask-Regel zutrifft, fällt der Aufruf in Ihren [`canUseTool` Callback](https://code.claude.com/docs/de/agent-sdk/user-input) zur Bestätigung, auch im `bypassPermissions` Modus.

34 34 

35Tools, die Benutzerinteraktion erfordern, verhalten sich auf die gleiche Weise: `AskUserQuestion` und MCP-Tools, deren Server [`_meta["anthropic/requiresUserInteraction"]`](https://code.claude.com/docs/de/mcp#require-approval-for-a-specific-tool) setzt, fallen immer in den Callback, auch wenn eine Allow-Regel zutrifft. Im `dontAsk` Modus werden beide Fälle stattdessen abgelehnt, da dieser Modus niemals auffordert. Die MCP-Anmerkung erfordert Claude Code v2.1.199 oder später.35Tools, die Benutzerinteraktion erfordern, verhalten sich auf die gleiche Weise. `AskUserQuestion` und MCP-Tools, deren Server [`_meta["anthropic/requiresUserInteraction"]`](https://code.claude.com/docs/de/mcp#require-approval-for-a-specific-tool) setzt, fallen in den Callback, auch wenn eine Allow-Regel zutrifft. Im `dontAsk` Modus werden beide Fälle stattdessen abgelehnt, da dieser Modus jede Berechtigungsabfrage in eine Ablehnung umwandelt. Die MCP-Anmerkung erfordert Claude Code v2.1.199 oder später.

36 36 

37[claude.ai Connector](https://code.claude.com/docs/de/mcp.md#organization-controls-on-connector-tools) Tools, die Ihre Organisation auf `ask` gesetzt hat, verlassen den Fluss auch in diesem Schritt. Jeder Aufruf fällt in den Callback, auch im `bypassPermissions` Modus und auch wenn eine Allow-Regel zutrifft. Der Callback erhält den Grund `Your organization requires approval for this tool`. Im `dontAsk` Modus wird der Aufruf stattdessen abgelehnt, da dieser Modus niemals auffordert.37[claude.ai Connector](https://code.claude.com/docs/de/mcp.md#organization-controls-on-connector-tools) Tools, die Ihre Organisation auf `ask` gesetzt hat, verlassen den Fluss auch in diesem Schritt. Jeder Aufruf fällt in den Callback, auch im `bypassPermissions` Modus und auch wenn eine Allow-Regel zutrifft. Der Callback erhält den Grund `Your organization requires approval for this tool`. Im `dontAsk` Modus wird der Aufruf stattdessen abgelehnt, da dieser Modus niemals auffordert.

38 38 


42 42 

43Wenden Sie den aktiven [Berechtigungsmodus](#permission-modes) an:43Wenden Sie den aktiven [Berechtigungsmodus](#permission-modes) an:

44 44 

45* Im `bypassPermissions` Modus genehmigt Claude Code alles, das diesen Schritt erreicht, außer erkannten [Entfernungen kritischer Pfade](https://code.claude.com/docs/de/permission-modes.md#critical-paths) und Bash-Befehlen, die mit [`Dangerous rm operation not ruled out`](https://code.claude.com/docs/de/permission-modes#dangerous-rm-operation-not-ruled-out) markiert sind; diese werden stattdessen weitergeleitet.45* Im `bypassPermissions` Modus genehmigt Claude Code jeden Aufruf, der diesen Schritt erreicht, es sei denn, es handelt sich um eine der [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves). Welche dieser Aktionen an Ihren `canUseTool` Callback gehen, erfahren Sie unter [Bypass permissions mode](#bypass-permissions-mode-bypasspermissions).

46 * Um diese Entfernungen ohne Nachfrage auszuführen, siehe [Berechtigungsabfrage für Entfernungen kritischer Pfade ausschalten](https://code.claude.com/docs/de/permission-modes.md#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode).

47* Im `acceptEdits` Modus genehmigt Claude Code die unter [Accept edits mode](#accept-edits-mode-acceptedits) aufgelisteten Dateivorgänge.46* Im `acceptEdits` Modus genehmigt Claude Code die unter [Accept edits mode](#accept-edits-mode-acceptedits) aufgelisteten Dateivorgänge.

48* Im `plan` Modus sendet Claude Code Tools zur Dateibearbeitung unabhängig von Allow-Regeln an Ihren `canUseTool` Callback.47* Im `plan` Modus erreichen einige Aufrufe Ihren Callback, und wenn der Auto-Modus verfügbar ist, gehen andere stattdessen an dessen Klassifikator. Weitere Informationen finden Sie unter [Plan mode](#plan-mode-plan).

49* In anderen Modi fällt die Anfrage durch.48* Im `default` und `dontAsk` Modus geht der Aufruf weiter zu den Allow-Regeln.

49* Zum `auto` Modus siehe [Auto mode](#auto-mode-auto).

50 50 

51**5. Allow-Regeln**51**5. Allow-Regeln**

52 52 


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 

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

95 

96Verwenden Sie `//path` für einen absoluten Dateisystempfad: eine Deny-Regel von `Edit(//secrets/**)` blockiert Schreibvorgänge überall unter `/secrets` auf der Festplatte. Mit einem einzelnen führenden Schrägstrich verankert `Edit(/secrets/**)` stattdessen an der Quelle der Regel. Für Regeln, die durch `allowed_tools` oder `disallowed_tools` übergeben werden, bedeutet das das Arbeitsverzeichnis der Sitzung, daher blockiert die Regel nicht `/secrets` auf der Festplatte. Siehe [Read- und Edit-Regeln](https://code.claude.com/docs/de/permissions.md#read-and-edit) für die vier Ankerformen und wie Regeln aus Einstellungsdateien aufgelöst werden.

97 

98> [!WARNING]94> [!WARNING]

99>95>

100> **Automatisch genehmigte Tools erreichen `canUseTool` niemals.** Ein Tool-Aufruf, der in einem früheren Schritt genehmigt wird, durch `acceptEdits` oder `bypassPermissions` oder durch eine Allow-Regel, überspringt Ihren `canUseTool`-Callback, daher werden Berechtigungsprüfungen, die Sie dort durchführen, für dieses Tool stillschweigend umgangen.96> **Automatisch genehmigte Tools erreichen `canUseTool` niemals.** Ein Tool-Aufruf, der in einem früheren Schritt genehmigt wird, durch `acceptEdits` oder `bypassPermissions` oder durch eine Allow-Regel, überspringt Ihren `canUseTool`-Callback, daher werden Berechtigungsprüfungen, die Sie dort durchführen, für dieses Tool stillschweigend umgangen.


105>101>

106> * Benutzerdefinierte Tools, die Ihre Anwendung mit [`always_ask`](https://code.claude.com/docs/de/agent-sdk/custom-tools#require-approval-for-specific-tools) kennzeichnet: Entscheiden Sie über den Aufruf im Callback. Damit diese Aufrufe nicht mehr ankommen, [ändern Sie die Richtlinie während der Sitzung](https://code.claude.com/docs/de/agent-sdk/typescript.md#mcpsdkserverconfigwithinstance). In den Modi `auto`, `plan` und `bypassPermissions` kann der Aufruf stattdessen vor dem Callback genehmigt werden, und zwar in den Fällen, die unter [Berechtigungsmodi, die einen `always_ask`-Aufruf genehmigen können](https://code.claude.com/docs/de/agent-sdk/typescript#permission-modes-that-can-approve-an-always_ask-call) aufgeführt sind102> * Benutzerdefinierte Tools, die Ihre Anwendung mit [`always_ask`](https://code.claude.com/docs/de/agent-sdk/custom-tools#require-approval-for-specific-tools) kennzeichnet: Entscheiden Sie über den Aufruf im Callback. Damit diese Aufrufe nicht mehr ankommen, [ändern Sie die Richtlinie während der Sitzung](https://code.claude.com/docs/de/agent-sdk/typescript.md#mcpsdkserverconfigwithinstance). In den Modi `auto`, `plan` und `bypassPermissions` kann der Aufruf stattdessen vor dem Callback genehmigt werden, und zwar in den Fällen, die unter [Berechtigungsmodi, die einen `always_ask`-Aufruf genehmigen können](https://code.claude.com/docs/de/agent-sdk/typescript#permission-modes-that-can-approve-an-always_ask-call) aufgeführt sind

107>103>

108> * Erkannte `rm`- und `rmdir`-[Entfernungen kritischer Pfade](https://code.claude.com/docs/de/permission-modes.md#critical-paths): Im Modus `default`, `acceptEdits` und `bypassPermissions` erlauben oder verweigern Sie die Entfernung im Callback, wobei [`decisionReason`](https://code.claude.com/docs/de/agent-sdk/typescript#canusetool) mit `Dangerous rm` beginnt. Für die Modi `auto` und `plan` siehe [Entfernungen kritischer Pfade in jedem Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md#critical-path-removals-in-each-permission-mode). Die Prüfung, die diese Entfernungen erkennt, [kann einige Befehle übersehen](https://code.claude.com/docs/de/permission-modes.md#critical-paths)104> * Erkannte `rm`- und `rmdir`-[Entfernungen kritischer Pfade](https://code.claude.com/docs/de/permission-modes.md#critical-paths): Im Modus `default`, `acceptEdits` und `bypassPermissions` erlauben oder verweigern Sie die Entfernung im Callback, wobei [`decisionReason`](https://code.claude.com/docs/de/agent-sdk/typescript#canusetool) mit `Dangerous rm` beginnt. Für die Modi `auto` und `plan` siehe [Entfernungen kritischer Pfade in jedem Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md#critical-path-removals-in-each-permission-mode)

109>105>

110> * **Bloßer Name**: Ein Eintrag wie `Read` oder `mcp__github__get_issue` genehmigt automatisch jeden Aufruf dieses Tools, abgesehen von den [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves), und [Lesezugriffen auf Netzwerkpfade](https://code.claude.com/docs/de/permissions.md#network-paths).106> * **Bloßer Name**: Ein Eintrag wie `Read` oder `mcp__github__get_issue` genehmigt automatisch jeden Aufruf dieses Tools, abgesehen von den [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves), und [Lesezugriffen auf Netzwerkpfade](https://code.claude.com/docs/de/permissions.md#network-paths).

111>107>

112> * **Begrenzte Regel**: Ein Eintrag wie `Bash(npm test *)` genehmigt nur übereinstimmende Aufrufe automatisch, und andere `Bash`-Aufrufe, die Genehmigung benötigen, fallen weiterhin durch zum Callback.108> * **Begrenzte Regel**: Ein Eintrag wie `Bash(npm test *)` genehmigt übereinstimmende Aufrufe automatisch, und andere `Bash`-Aufrufe, die Genehmigung benötigen, fallen durch zum Berechtigungsmodus.

113>109>

114> Für Prüfungen, die bei jedem Tool-Aufruf ausgeführt werden müssen, verwenden Sie einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks): Hooks werden vor jedem anderen Schritt ausgeführt, und eine Hook-Ablehnung gilt auch im `bypassPermissions`-Modus.110> Um Aufrufe zu prüfen, die eine Allow-Regel, `acceptEdits` oder `bypassPermissions` genehmigt, verwenden Sie einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks), der auch für diese Aufrufe ausgeführt wird. Eine Hook-Ablehnung gilt auch im `bypassPermissions`-Modus.

115 111 

116Für einen abgesperrten Agent kombinieren Sie `allowedTools` mit `permissionMode: "dontAsk"`:112Für einen abgesperrten Agent kombinieren Sie `allowedTools` mit `permissionMode: "dontAsk"`:

117 113 


128 124 

129> [!WARNING]125> [!WARNING]

130>126>

131> **`allowed_tools` schränkt `bypassPermissions` nicht ein.** `allowed_tools` genehmigt die Tools, die Sie aufgelistet haben, im Voraus. Andere nicht aufgelistete Tools werden nicht durch eine Allow-Regel abgeglichen und fallen durch zum Genehmigungsmodus, wo `bypassPermissions` sie genehmigt. Das Setzen von `allowed_tools=["Read"]` zusammen mit `permission_mode="bypassPermissions"` genehmigt immer noch jedes Tool, einschließlich `Bash`, `Write` und `Edit`. Wenn Sie `bypassPermissions` benötigen, aber bestimmte Tools blockiert haben möchten, verwenden Sie `disallowed_tools`.127> **`allowed_tools` schränkt `bypassPermissions` nicht ein.** `allowed_tools` genehmigt die Tools, die Sie aufgelistet haben, im Voraus. Im `bypassPermissions`-Modus genehmigt Claude Code einen Aufruf eines nicht aufgelisteten Tools, es sei denn, es handelt sich um eine der [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves).

128>

129> Wenn Sie `allowed_tools=["Read"]` zusammen mit `permission_mode="bypassPermissions"` setzen, genehmigt Claude Code dennoch Aufrufe von Tools wie `Bash`, `Write` und `Edit`. Wenn Sie `bypassPermissions` benötigen, aber bestimmte Tools blockiert haben möchten, verwenden Sie `disallowed_tools`. Für die Aufrufe, die in diesem Modus dennoch Ihren `canUseTool`-Callback erreichen, siehe [Modus zum Umgehen von Berechtigungen](#bypass-permissions-mode-bypasspermissions).

132 130 

133Sie können auch Allow-, Deny- und Ask-Regeln deklarativ in `.claude/settings.json` konfigurieren. Diese Regeln werden gelesen, wenn die `project`-Einstellungsquelle aktiviert ist, was sie für Standard-`query()`-Optionen ist. Wenn Sie `setting_sources` (TypeScript: `settingSources`) explizit setzen, schließen Sie `"project"` ein, damit sie angewendet werden. Siehe [Berechtigungseinstellungen](https://code.claude.com/docs/de/settings-reference.md#permission-settings) für die Regelsyntax.131Sie können auch Allow-, Deny- und Ask-Regeln deklarativ in `.claude/settings.json` konfigurieren. Diese Regeln werden gelesen, wenn die `project`-Einstellungsquelle aktiviert ist, was sie für Standard-`query()`-Optionen ist. Wenn Sie `setting_sources` (TypeScript: `settingSources`) explizit setzen, schließen Sie `"project"` ein, damit sie angewendet werden. Siehe [Berechtigungseinstellungen](https://code.claude.com/docs/de/settings-reference.md#permission-settings) für die Regelsyntax.

134 132 

133Wann Allow-Regeln in der `.claude/settings.json` eines Projekts gelten, erfahren Sie unter [Projekt-Allow-Regeln und Workspace-Vertrauen](https://code.claude.com/docs/de/permissions.md#project-allow-rules-and-workspace-trust).

134 

135### Pfadmuster in Regeln

136 

137Begrenzte Regeln für `Read` und `Edit` verwenden ein Pfadmuster. `Edit(path)`-Regeln regeln alle integrierten Tools, die Dateien schreiben, einschließlich `Write` und `NotebookEdit`. Schreiben Sie eine Pfadregel für jedes dieser Tools daher als `Edit(path)`. Wenn Sie eine Pfadregel als `Write(path)` oder `NotebookEdit(path)` schreiben, [entspricht sie keinem Aufruf](https://code.claude.com/docs/de/permissions.md#path-rules-that-never-match) und hat keine Wirkung.

138 

139Beginnen Sie in `allowed_tools` und `disallowed_tools` ein Pfadmuster mit `//` für einen absoluten Pfad oder mit einem einzelnen `/` für einen Pfad innerhalb des Arbeitsverzeichnisses der Sitzung:

140 

141* **`//path`**: Mit einer Deny-Regel von `Edit(//secrets/**)` blockiert Claude Code Schreibvorgänge unter `/secrets` auf der Festplatte durch Claudes Datei-Tools und durch [Bash-Befehle wie `tee` und `> file`-Umleitung](https://code.claude.com/docs/de/permissions#what-read-and-edit-rules-cover). Ein Skript, das Claude ausführt und das selbst Dateien öffnet, kann weiterhin unter `/secrets` schreiben. Für eine Durchsetzung durch das Betriebssystem siehe [Das Bash-Tool in der Sandbox konfigurieren](https://code.claude.com/docs/de/sandboxing.md).

142* **`/path`**: `Edit(/secrets/**)` entspricht dem Verzeichnis `secrets` innerhalb des Arbeitsverzeichnisses.

143 

144Weitere Möglichkeiten, ein Pfadmuster zu beginnen, finden Sie unter [Read- und Edit-Regeln](https://code.claude.com/docs/de/permissions.md#read-and-edit).

145 

135## Berechtigungsmodi146## Berechtigungsmodi

136 147 

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


146| :- | :- | :- |157| :- | :- | :- |

147| `default` | Standardberechtigungsverhalten | Keine modusbasierten automatischen Genehmigungen; Aufrufe, die eine Genehmigung benötigen und keine Allow-Regel erfüllen, lösen Ihren `canUseTool`-Callback aus |158| `default` | Standardberechtigungsverhalten | Keine modusbasierten automatischen Genehmigungen; Aufrufe, die eine Genehmigung benötigen und keine Allow-Regel erfüllen, lösen Ihren `canUseTool`-Callback aus |

148| `dontAsk` | Ablehnung statt Nachfrage | Jeder Aufruf, der sonst eine Nachfrage auslösen würde, wird abgelehnt, ohne `canUseTool` aufzurufen, wobei ein von Ihnen installierter [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) [einige dieser Aufrufe](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) dennoch genehmigen kann. Aufrufe, die von `allowed_tools` oder `settings.json`-Allow-Regeln genehmigt werden, werden ausgeführt, ebenso wie Aufrufe, die im `default`-Modus keine Genehmigung benötigen. Einige Aufrufe, wie [Lesezugriffe auf Netzwerkpfade](https://code.claude.com/docs/de/permissions.md#network-paths), werden abgelehnt, auch wenn `allowed_tools` oder eine Allow-Regel auf sie zutrifft. Die Liste finden Sie unter [Nicht-Fragen-Modus](#don’t-ask-mode-dontask) |159| `dontAsk` | Ablehnung statt Nachfrage | Jeder Aufruf, der sonst eine Nachfrage auslösen würde, wird abgelehnt, ohne `canUseTool` aufzurufen, wobei ein von Ihnen installierter [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) [einige dieser Aufrufe](https://code.claude.com/docs/de/permissions.md#precedence-among-rules-hooks-and-mods) dennoch genehmigen kann. Aufrufe, die von `allowed_tools` oder `settings.json`-Allow-Regeln genehmigt werden, werden ausgeführt, ebenso wie Aufrufe, die im `default`-Modus keine Genehmigung benötigen. Einige Aufrufe, wie [Lesezugriffe auf Netzwerkpfade](https://code.claude.com/docs/de/permissions.md#network-paths), werden abgelehnt, auch wenn `allowed_tools` oder eine Allow-Regel auf sie zutrifft. Die Liste finden Sie unter [Nicht-Fragen-Modus](#don’t-ask-mode-dontask) |

149| `acceptEdits` | Dateibearbeitungen automatisch akzeptieren | Dateibearbeitungen und [Dateisystemoperationen](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` usw.) werden automatisch genehmigt |160| `acceptEdits` | Dateibearbeitungen automatisch akzeptieren | Dateibearbeitungen und [Dateisystemoperationen](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` usw.) innerhalb Ihrer [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories) werden automatisch genehmigt |

150| `bypassPermissions` | Berechtigungsprüfungen umgehen | Tools werden ohne Berechtigungsabfragen ausgeführt, außer für die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves) und, außerhalb einer [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md), benutzerdefinierte Tools, die Ihre Anwendung [als `always_ask` kennzeichnet](https://code.claude.com/docs/de/agent-sdk/custom-tools#require-approval-for-specific-tools). Mit Vorsicht verwenden |161| `bypassPermissions` | Berechtigungsprüfungen umgehen | Tools werden ohne Berechtigungsabfragen ausgeführt, außer für die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves) und, außerhalb einer [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md), benutzerdefinierte Tools, die Ihre Anwendung [als `always_ask` kennzeichnet](https://code.claude.com/docs/de/agent-sdk/custom-tools#require-approval-for-specific-tools). Mit Vorsicht verwenden |

151| `plan` | Planungsmodus | Claude erkundet und plant, ohne Ihre Quelldateien zu bearbeiten; Dateibearbeitungen werden nie automatisch genehmigt und werden durch Ihren `canUseTool`-Callback abgefragt |162| `plan` | Plan-Modus | Claude erkundet und plant. Bearbeitungen mit Claudes Datei-Tools gehen an Ihren `canUseTool`-Callback, auch wenn eine Allow-Regel auf sie zutrifft |

152| `auto` | Modellklassifizierte Genehmigungen | Ein Modellklassifizierer überprüft Aktionen wie Shell-Befehle und Netzwerkanfragen und genehmigt oder blockiert jede überprüfte Aktion. Siehe [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) für Verfügbarkeit und die Entscheidungsreihenfolge |163| `auto` | Modellklassifizierte Genehmigungen | Ein Modellklassifizierer überprüft Aktionen wie Shell-Befehle und Netzwerkanfragen und genehmigt oder blockiert jede überprüfte Aktion. Siehe [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) für Verfügbarkeit und die Entscheidungsreihenfolge |

153 164 

154> [!WARNING]165> [!WARNING]


267 278 

268**Automatisch genehmigte Vorgänge:**279**Automatisch genehmigte Vorgänge:**

269 280 

270* Dateibearbeitungen (Edit-, Write-Tools)281* Dateibearbeitungen mit den Tools Edit, Write und NotebookEdit

271* Dateisystembefehle: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp`, `sed`282* Dateisystembefehle: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp`, `sed`

272 283 

273Beide gelten nur für Pfade innerhalb des Arbeitsverzeichnisses oder `additionalDirectories`. Im `acceptEdits`-Modus genehmigt Claude Code die Anfrage nicht automatisch, wenn Claude:284Beide gelten für Pfade innerhalb des Arbeitsverzeichnisses oder eines von Ihnen hinzugefügten Verzeichnisses. In Python fügen Sie eines mit `add_dirs` hinzu, in TypeScript mit `additionalDirectories`. Im `acceptEdits`-Modus genehmigt Claude Code die Anfrage nicht automatisch, wenn Claude:

274 285 

275* An einem Pfad außerhalb dieses Bereichs arbeitet286* An einem Pfad außerhalb dieses Bereichs arbeitet

276* In einen geschützten Pfad schreibt287* In einen [geschützten Pfad](https://code.claude.com/docs/de/permission-modes.md#protected-paths) schreibt

277* Einen Pfad, den Claude Code als [kritischen Pfad](https://code.claude.com/docs/de/permission-modes.md#critical-paths) erkennt, mit `rm` oder `rmdir` löscht288* Einen Pfad, den Claude Code als [kritischen Pfad](https://code.claude.com/docs/de/permission-modes.md#critical-paths) erkennt, mit `rm` oder `rmdir` löscht

278* [`touch`](https://code.claude.com/docs/de/permission-modes#auto-approve-file-edits-with-acceptedits-mode) beispielsweise mit einer Option, einem Glob oder einem Präfix wie `timeout 5` oder `LANG=C` ausführt289* [`touch`](https://code.claude.com/docs/de/permission-modes#auto-approve-file-edits-with-acceptedits-mode) beispielsweise mit einer Option, einem Glob oder einem Präfix wie `timeout 5` oder `LANG=C` ausführt

279 290 


293 304 

294Wenn Ihr `PreToolUse`-Hook `allow` für eine erkannte Löschung eines kritischen Pfads, einen Lesezugriff auf einen Netzwerkpfad oder einen Aufruf eines als `always_ask` gekennzeichneten Tools zurückgibt, wird der Aufruf dennoch abgelehnt. Die Prüfung, die diese Löschungen erkennt, [kann einige Befehle übersehen](https://code.claude.com/docs/de/permission-modes.md#critical-paths).305Wenn Ihr `PreToolUse`-Hook `allow` für eine erkannte Löschung eines kritischen Pfads, einen Lesezugriff auf einen Netzwerkpfad oder einen Aufruf eines als `always_ask` gekennzeichneten Tools zurückgibt, wird der Aufruf dennoch abgelehnt. Die Prüfung, die diese Löschungen erkennt, [kann einige Befehle übersehen](https://code.claude.com/docs/de/permission-modes.md#critical-paths).

295 306 

296**Verwenden Sie, wenn:** Sie eine feste, explizite Tool-Oberfläche für einen Headless-Agent wünschen und eine harte Ablehnung gegenüber stiller Abhängigkeit von fehlender `canUseTool` bevorzugen.307**Verwenden Sie, wenn:** Sie einen Headless-Agenten ausführen und für jeden Aufruf, der sonst eine Nachfrage auslösen würde, eine harte Ablehnung wünschen.

297 308 

298#### Berechtigungen umgehen-Modus (`bypassPermissions`)309#### Berechtigungen umgehen-Modus (`bypassPermissions`)

299 310 


303>314>

304> Mit äußerster Vorsicht verwenden. Claude hat in diesem Modus vollständigen Systemzugriff. Verwenden Sie nur in kontrollierten Umgebungen, in denen Sie allen möglichen Vorgängen vertrauen.315> Mit äußerster Vorsicht verwenden. Claude hat in diesem Modus vollständigen Systemzugriff. Verwenden Sie nur in kontrollierten Umgebungen, in denen Sie allen möglichen Vorgängen vertrauen.

305>316>

306> `allowed_tools` beschränkt diesen Modus nicht. Jedes Tool wird genehmigt, nicht nur die, die Sie aufgelistet haben. Diese Kontrollen gelten weiterhin:317> `allowed_tools` beschränkt diesen Modus nicht, und auch Aufrufe von Tools, die Sie nicht aufgelistet haben, werden genehmigt. Diese Kontrollen gelten weiterhin:

307>318>

308> * Deny-Regeln, explizite `ask`-Regeln und Hooks werden vor der Modusüberprüfung ausgewertet und können ein Tool weiterhin blockieren.319> * Deny-Regeln, explizite `ask`-Regeln und Hooks werden vor der Modusüberprüfung ausgewertet und können ein Tool weiterhin blockieren.

309> * Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](https://code.claude.com/docs/de/mcp#organization-controls-on-connector-tools), Tools, die Benutzerinteraktion erfordern, und erkannte [Löschungen kritischer Pfade](https://code.claude.com/docs/de/permission-modes.md#critical-paths) fallen weiterhin in Ihren `canUseTool`-Callback. Die Prüfung, die diese Löschungen erkennt, [kann einige Befehle übersehen](https://code.claude.com/docs/de/permission-modes.md#critical-paths), und Sie können [die Abfrage bei Löschungen kritischer Pfade ausschalten](https://code.claude.com/docs/de/permission-modes.md#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode). Außerhalb einer [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) fallen auch Aufrufe benutzerdefinierter Tools, die Ihre Anwendung [als `always_ask` kennzeichnet](https://code.claude.com/docs/de/agent-sdk/custom-tools#require-approval-for-specific-tools), in den Callback.320> * Konnektor-Tools, [die Ihre Organisation auf `ask` gesetzt hat](https://code.claude.com/docs/de/mcp#organization-controls-on-connector-tools), Tools, die Benutzerinteraktion erfordern, erkannte [Löschungen kritischer Pfade](https://code.claude.com/docs/de/permission-modes.md#critical-paths) und Bash-Befehle, die mit [`Dangerous rm operation not ruled out`](https://code.claude.com/docs/de/permission-modes#dangerous-rm-operation-not-ruled-out) markiert sind, fallen weiterhin in Ihren `canUseTool`-Callback. Die Prüfung, die Löschungen kritischer Pfade erkennt, [kann einige Befehle übersehen](https://code.claude.com/docs/de/permission-modes.md#critical-paths), und Sie können [die Abfrage bei Löschungen kritischer Pfade ausschalten](https://code.claude.com/docs/de/permission-modes.md#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode). Außerhalb einer [Cloud-Sitzung](https://code.claude.com/docs/de/claude-code-on-the-web.md) fallen auch Aufrufe benutzerdefinierter Tools, die Ihre Anwendung [als `always_ask` kennzeichnet](https://code.claude.com/docs/de/agent-sdk/custom-tools#require-approval-for-specific-tools), in den Callback.

310> * Die [Sitzungsübergreifenden Messaging-Schutzmaßnahmen](https://code.claude.com/docs/de/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) gelten weiterhin.321> * Die [Sitzungsübergreifenden Messaging-Schutzmaßnahmen](https://code.claude.com/docs/de/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) gelten weiterhin.

311 322 

312#### Planungsmodus (`plan`)323#### Planungsmodus (`plan`)

313 324 

314Claude erkundet die Codebasis und erstellt einen Plan, ohne Ihre Quelldateien zu bearbeiten. Dateibearbeitungen werden im Plan-Modus nie automatisch genehmigt, auch wenn eine Allow-Regel übereinstimmt oder ein `PreToolUse`-Hook `allow` zurückgibt. Sie werden stattdessen durch Ihren `canUseTool`-Callback abgefragt.325Claude erkundet die Codebasis und erstellt einen Plan. Während der Planung erreichen Bearbeitungen mit Claudes Datei-Tools außerhalb [geschützter Pfade](https://code.claude.com/docs/de/permission-modes.md#protected-paths) Ihren `canUseTool`-Callback, auch wenn eine Allow-Regel übereinstimmt oder ein `PreToolUse`-Hook `allow` zurückgibt. [`AskUserQuestion`](https://code.claude.com/docs/de/agent-sdk/user-input#handle-clarifying-questions)-Aufrufe erreichen ebenfalls Ihren Callback, auch wenn eine Allow-Regel das Tool nennt.

326 

327Wenn der [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) verfügbar ist, sendet Claude Code diese Aufrufe während der Planung zur Überprüfung an den [Klassifikator des Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode) statt an Ihren Callback, sofern keine Allow-Regel sie genehmigt:

328 

329* Shell-Befehle

330* Web-Abrufe

331* Websuchen

332* Aufrufe von MCP-Tools, die ihr Server als nur lesend kennzeichnet

333 

334Diese Überprüfung ist standardmäßig aktiviert. Um sie auszuschalten, setzen Sie [`useAutoModeDuringPlan`](https://code.claude.com/docs/de/settings-reference#useautomodeduringplan) in der `settings`-Option, die Sie an `query()` übergeben, oder in Ihren Benutzereinstellungen auf `false`. Solange die Überprüfung ausgeschaltet ist, erreichen Websuchen und Aufrufe von als nur lesend gekennzeichneten MCP-Tools Ihren Callback.

315 335 

316Solange der Auto-Modus für die Sitzung verfügbar ist, erreichen Befehle, die Claude während der Planung ausführt, Ihren Callback standardmäßig nicht, da das Klassifikatormodell, das der [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) verwendet, [sie stattdessen überprüft](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode). Ist diese Überprüfung aktiv, kann der Klassifikator auch nur lesende Aufrufe genehmigen, die sonst Ihren Callback erreichen würden, etwa einen `WebFetch`-Aufruf ohne Allow-Regel.336Für Shell-Befehle und Web-Abrufe zeigt die Tabelle, ob der jeweilige Aufruf Ihren Callback erreicht:

337 

338| Aufruf während der Planung | Überprüfung aktiviert | Überprüfung ausgeschaltet oder Auto-Modus nicht verfügbar |

339| :- | :- | :- |

340| Ein [nur lesender](https://code.claude.com/docs/de/permissions.md#read-only-commands) Shell-Befehl wie `ls` | Wird ausgeführt, ohne Ihren Callback zu erreichen | Wird ausgeführt, ohne Ihren Callback zu erreichen |

341| Jeder andere Shell-Befehl, den keine Allow-Regel genehmigt, außer einer [Löschung eines kritischen Pfads](https://code.claude.com/docs/de/permission-modes.md#critical-paths) | Geht an den Klassifikator, der ihn ohne Ihren Callback genehmigt oder ablehnt | Erreicht Ihren Callback |

342| Ein `WebFetch`-Aufruf an eine [vorab genehmigte Dokumentationsdomain](https://code.claude.com/docs/de/tools-reference.md#webfetch-tool-behavior) | Wird ausgeführt, ohne Ihren Callback zu erreichen | Wird ausgeführt, ohne Ihren Callback zu erreichen |

343| Jeder andere `WebFetch`-Aufruf, den keine Allow-Regel genehmigt | Geht an den Klassifikator, der ihn ohne Ihren Callback genehmigt oder ablehnt | Erreicht Ihren Callback |

344 

345Was passiert, nachdem der Klassifikator mehrere Aufrufe hintereinander abgelehnt hat, erfahren Sie unter [Schwellenwerte für wiederholte Blockierungen](https://code.claude.com/docs/de/permission-modes.md#repeated-block-thresholds).

317 346 

318> [!NOTE]347> [!NOTE]

319>348>

320> Wenn Sie im TypeScript SDK `allowDangerouslySkipPermissions: true` zusammen mit `permissionMode: 'plan'` festlegen, erreichen Dateibearbeitungen weiterhin Ihren `canUseTool`-Callback. Um eine Sitzung, die im Plan-Modus startet, später mit `setPermissionMode()` auf `bypassPermissions` umzustellen, muss `allowDangerouslySkipPermissions` von Anfang an gesetzt sein.349> Wenn Sie im TypeScript SDK `allowDangerouslySkipPermissions: true` zusammen mit `permissionMode: 'plan'` festlegen, erreichen Dateibearbeitungen weiterhin Ihren `canUseTool`-Callback. Um eine Sitzung, die im Plan-Modus startet, später mit `setPermissionMode()` auf `bypassPermissions` umzustellen, muss `allowDangerouslySkipPermissions` von Anfang an gesetzt sein.

321 350 

322Claude kann `AskUserQuestion` verwenden, um Anforderungen zu klären, bevor der Plan abgeschlossen wird. Siehe [Genehmigungen und Benutzereingaben verarbeiten](https://code.claude.com/docs/de/agent-sdk/user-input.md#handle-clarifying-questions) für die Verarbeitung dieser Aufforderungen.351**Verwenden Sie, wenn:** Claude zuerst einen Plan erstellen soll, z. B. während eines Code-Reviews oder vor einer großen Änderung.

323 

324**Verwenden Sie, wenn:** Sie möchten, dass Claude Änderungen vorschlägt, ohne sie auszuführen, z. B. während einer Code-Überprüfung oder wenn Sie Änderungen genehmigen müssen, bevor sie vorgenommen werden.

325 352 

326#### Auto-Modus (`auto`)353#### Auto-Modus (`auto`)

327 354 

Details

1175PermissionMode = Literal[1175PermissionMode = Literal[

1176 "default", # Standard permission behavior1176 "default", # Standard permission behavior

1177 "acceptEdits", # Auto-accept file edits1177 "acceptEdits", # Auto-accept file edits

1178 "plan", # Planning mode - explore without editing1178 "plan", # Planning mode - Claude explores and plans

1179 "dontAsk", # Deny anything not pre-approved instead of prompting1179 "dontAsk", # Deny anything not pre-approved instead of prompting

1180 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)1180 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)

1181 "auto", # A model classifier reviews actions such as shell commands and network requests1181 "auto", # A model classifier reviews actions such as shell commands and network requests


1214 1214 

1215Gibt ein `PermissionResult` zurück (entweder `PermissionResultAllow` oder `PermissionResultDeny`).1215Gibt ein `PermissionResult` zurück (entweder `PermissionResultAllow` oder `PermissionResultDeny`).

1216 1216 

1217Der Callback ist der SDK-Ersatz für die interaktive Berechtigungsabfrage: Er wird nur aufgerufen, wenn der [Ablauf der Berechtigungsprüfung](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) zu einer Berechtigungsabfrage führt. Tool-Aufrufe, die bereits durch einen `allowed_tools`-Eintrag, eine Allow-Regel in den Einstellungen oder den Berechtigungsmodus wie `acceptEdits` oder `bypassPermissions` genehmigt wurden, rufen ihn nie auf. Um jeden Tool-Aufruf zu kontrollieren, verwenden Sie stattdessen einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks).1217Der Callback ersetzt die interaktive Berechtigungsabfrage. Das SDK ruft `can_use_tool` auf, wenn der [Ablauf der Berechtigungsprüfung](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) zu einer Berechtigungsabfrage führt. Aufrufe, die auf eine dieser Arten genehmigt werden, laufen, ohne `can_use_tool` aufzurufen:

1218 

1219* Ein Aufruf, den ein `allowed_tools`-Eintrag oder eine Allow-Regel in den Einstellungen genehmigt

1220* Ein Aufruf, den der Berechtigungsmodus genehmigt, etwa eine Dateibearbeitung im Modus `acceptEdits`

1221 

1222Um diese Aufrufe zu prüfen, verwenden Sie einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks), der auch für sie ausgeführt wird.

1218 1223 

1219Eine Allow-Regel genehmigt nicht vorab die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves); siehe [Wie Berechtigungen ausgewertet werden](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) dazu, welche davon den Callback erreichen und was im Modus `dontAsk` und `auto` geschieht.1224Eine Allow-Regel genehmigt nicht vorab die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves); siehe [Wie Berechtigungen ausgewertet werden](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) dazu, welche davon den Callback erreichen und was im Modus `dontAsk` und `auto` geschieht.

1220 1225 


3659 3664 

3660> [!NOTE]3665> [!NOTE]

3661>3666>

3662> Der integrierte Sandbox-Proxy erzwingt die Netzwerk-Allowlist basierend auf dem angeforderten Hostnamen und beendet oder inspiziert keinen TLS-Verkehr, daher können Techniken wie [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) ihn möglicherweise umgehen. Siehe [Sandboxing-Sicherheitsbeschränkungen](https://code.claude.com/docs/de/sandboxing.md#security-limitations) für Details und [Sichere Bereitstellung](https://code.claude.com/docs/de/agent-sdk/secure-deployment.md#traffic-forwarding) für die Konfiguration eines TLS-terminierenden Proxys.3667> Der integrierte Sandbox-Proxy erzwingt die Netzwerk-Allowlist basierend auf dem angeforderten Hostnamen. Standardmäßig beendet oder inspiziert der Proxy keinen TLS-Verkehr, daher können Techniken wie [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) die Allowlist möglicherweise umgehen. Siehe [Sandboxing-Sicherheitsbeschränkungen](https://code.claude.com/docs/de/sandboxing.md#security-limitations) für Details und [Sichere Bereitstellung](https://code.claude.com/docs/de/agent-sdk/secure-deployment.md#traffic-forwarding) für die Konfiguration eines TLS-terminierenden Proxys.

3663 3668 

3664### `SandboxIgnoreViolations`3669### `SandboxIgnoreViolations`

3665 3670 

Details

22 22 

23Claude Code enthält mehrere Sicherheitsfunktionen, die häufige Bedenken adressieren. Siehe die [Sicherheitsdokumentation](https://code.claude.com/docs/de/security.md) für vollständige Details.23Claude Code enthält mehrere Sicherheitsfunktionen, die häufige Bedenken adressieren. Siehe die [Sicherheitsdokumentation](https://code.claude.com/docs/de/security.md) für vollständige Details.

24 24 

25* **Berechtigungssystem**: Jedes Tool und jeder Bash-Befehl kann so konfiguriert werden, dass er erlaubt, blockiert oder der Benutzer zur Genehmigung aufgefordert wird. Verwenden Sie Glob-Muster, um Regeln wie „alle npm-Befehle erlauben“ oder „jeden Befehl mit sudo blockieren“ zu erstellen. Organisationen können Richtlinien festlegen, die für alle Benutzer gelten. Siehe [Berechtigungen](https://code.claude.com/docs/de/permissions.md).25* **Berechtigungssystem**: Berechtigungsregeln entscheiden, ob ein Tool-Aufruf ausgeführt wird, blockiert wird oder zuerst um Genehmigung bittet. Welche Formen eine Bash-Regel nicht erfasst und wie Regeln mit Berechtigungsmodi zusammenwirken, erfahren Sie unter [Was eine Bash-Regel nicht erfasst](https://code.claude.com/docs/de/permissions.md#bash-rule-limits) und [Berechtigungen konfigurieren](https://code.claude.com/docs/de/agent-sdk/permissions.md). Administratoren können Regeln außerdem in [verwalteten Einstellungen](https://code.claude.com/docs/de/permissions.md#managed-settings) festlegen.

26* **Befehlsanalyse für Berechtigungen**: Vor der Ausführung von Bash-Befehlen analysiert Claude Code diese in einen AST und gleicht das Ergebnis mit Ihren Berechtigungsregeln ab. Befehle, die nicht sauber analysiert werden können oder die keine Erlaubnisregel erfüllen, erfordern explizite Genehmigung. Eine kleine Reihe von Konstrukten wie `eval` erfordern immer Genehmigung, unabhängig von Erlaubnisregeln. Dies ist ein Berechtigungsgate, kein Sandbox; abgesehen von integrierten Sicherheitsprüfungen wie der [kritischen Pfadprüfung](https://code.claude.com/docs/de/permission-modes.md#critical-paths) auf `rm` und `rmdir` und der [geschützten Pfade](https://code.claude.com/docs/de/permission-modes.md#protected-paths)-Liste leitet es nicht ab, ob ein Befehl basierend auf seinem Zielpfad oder seinen Auswirkungen gefährlich ist.26* **Entfernen kritischer Pfade**: Wenn der Berechtigungsmodus auf `default` gesetzt ist, erfordert ein `rm`- oder `rmdir`-Befehl, der als Entfernen Ihres Arbeitsverzeichnisses oder eines anderen [kritischen Pfads](https://code.claude.com/docs/de/permission-modes.md#critical-paths) erkannt wird, eine Genehmigung. Eine passende allow-Regel überspringt diese Genehmigung nicht. Dies ist ein Berechtigungsgate, keine Sandbox. Um zu steuern, was der Agent schreiben darf, verwenden Sie [Dateisystemkontrollen](#filesystem-configuration).

27* **Web-Suche-Zusammenfassung**: Suchergebnisse werden zusammengefasst, anstatt rohe Inhalte direkt in den Kontext zu übergeben, was das Risiko von Prompt-Injection aus bösartigen Webinhalten verringert.27* **Web-Suche-Zusammenfassung**: Suchergebnisse werden zusammengefasst, anstatt rohe Inhalte direkt in den Kontext zu übergeben, was das Risiko von Prompt-Injection aus bösartigen Webinhalten verringert.

28* **Sandbox-Modus**: Bash-Befehle können in einer Sandbox-Umgebung ausgeführt werden, die Dateisystem- und Netzwerkzugriff einschränkt. Siehe die [Sandboxing-Dokumentation](https://code.claude.com/docs/de/sandboxing.md) für Details.28* **Sandbox-Modus**: Bash-Befehle können in einer Sandbox-Umgebung ausgeführt werden, die Dateisystem- und Netzwerkzugriff einschränkt. Siehe die [Sandboxing-Dokumentation](https://code.claude.com/docs/de/sandboxing.md) für Details.

29 29 


83**Funktionsweise:**83**Funktionsweise:**

84 84 

85* **Dateisystem**: Verwendet OS-Primitive (`bubblewrap` auf Linux, `sandbox-exec` auf macOS), um Lese-/Schreibzugriff auf konfigurierte Pfade zu beschränken85* **Dateisystem**: Verwendet OS-Primitive (`bubblewrap` auf Linux, `sandbox-exec` auf macOS), um Lese-/Schreibzugriff auf konfigurierte Pfade zu beschränken

86* **Netzwerk**: Entfernt Netzwerk-Namespace (Linux) oder verwendet Seatbelt-Profile (macOS), um Netzwerkverkehr durch einen integrierten Proxy zu leiten86* **Netzwerk**: Führt Befehle in einem eigenen Netzwerk-Namespace (Linux) oder unter einem Seatbelt-Profil (macOS) aus und leitet ihren Verkehr durch einen integrierten Proxy, der die konfigurierten Domänen zulässt. Eine Verbindung zu einem externen Host, die den Proxy umgeht, schlägt fehl.

87* **Konfiguration**: JSON-basierte Zulassungslisten für Domänen und Dateisystempfade87* **Konfiguration**: JSON-basierte Zulassungslisten für Domänen und Dateisystempfade

88 88 

89**Setup:**89**Setup:**

90 90 

91```bash theme={null}91Die Schritte zur Installation, Konfiguration und zum Start finden Sie unter [Laufzeit einrichten und starten](https://code.claude.com/docs/de/sandbox-environments.md#set-up-and-launch-the-runtime).

92npm install @anthropic-ai/sandbox-runtime

93```

94 

95Erstellen Sie dann eine Konfigurationsdatei, die zulässige Pfade und Domänen angibt.

96 92 

97**Sicherheitsüberlegungen:**93**Sicherheitsüberlegungen:**

98 94 

991. **Gleicher Host-Kernel**: Im Gegensatz zu VMs teilen sich Sandbox-Prozesse den Host-Kernel. Eine Kernel-Schwachstelle könnte theoretisch einen Escape ermöglichen. Für einige Bedrohungsmodelle ist dies akzeptabel, aber wenn Sie Kernel-Isolation benötigen, verwenden Sie gVisor oder eine separate VM.951. **Gleicher Host-Kernel**: Im Gegensatz zu VMs teilen sich Sandbox-Prozesse den Host-Kernel. Eine Kernel-Schwachstelle könnte theoretisch einen Escape ermöglichen. Für einige Bedrohungsmodelle ist dies akzeptabel, aber wenn Sie Kernel-Isolation benötigen, verwenden Sie gVisor oder eine separate VM.

100 96 

1012. **Keine TLS-Inspektion**: Der Proxy erstellt Zulassungslisten für Domänen basierend auf dem vom Client bereitgestellten Hostnamen und terminiert oder inspiziert keinen verschlüsselten Verkehr. Code, der in der Sandbox ausgeführt wird, kann möglicherweise [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) oder ähnliche Techniken verwenden, um Hosts außerhalb der Zulassungsliste zu erreichen. Wenn Ihr Bedrohungsmodell stärkere Garantien erfordert, konfigurieren Sie einen [TLS-terminierenden Proxy](#traffic-forwarding). Siehe die [Sandboxing-Sicherheitsbeschränkungen](https://code.claude.com/docs/de/sandboxing.md#security-limitations) für weitere Details. Stellen Sie separat sicher, dass der Agent mit zulässigen Domänen keine Berechtigungen hat, um andere Netzwerkanfragen auszulösen oder Daten zu exfiltrieren.972. **Keine TLS-Inspektion**: Standardmäßig lässt der Proxy Domänen anhand des vom Client bereitgestellten Hostnamens per Allowlist zu und terminiert oder inspiziert keinen verschlüsselten Verkehr. Code, der in der Sandbox ausgeführt wird, kann möglicherweise [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) oder ähnliche Techniken verwenden, um Hosts außerhalb der Allowlist zu erreichen. Wenn Ihr Bedrohungsmodell stärkere Garantien erfordert, verwenden Sie einen TLS-terminierenden Proxy, der den Verkehr inspiziert, wie unter [Weiterleitung des Datenverkehrs](#traffic-forwarding) beschrieben. Weitere Informationen finden Sie in den [Sandboxing-Sicherheitsbeschränkungen](https://code.claude.com/docs/de/sandboxing.md#security-limitations).

98 

993. **Anmeldedaten für zulässige Domänen**: Wenn der Agent über weitreichende Anmeldedaten für eine zulässige Domäne verfügt, stellen Sie sicher, dass er diese Domäne nicht nutzen kann, um andere Netzwerkanfragen auszulösen oder Daten zu exfiltrieren.

102 100 

103Für viele Single-Developer- und CI/CD-Anwendungsfälle erhöht sandbox-runtime die Messlatte erheblich mit minimalem Setup. Die folgenden Abschnitte behandeln Container und VMs für Bereitstellungen, die stärkere Isolation erfordern.101Für viele Single-Developer- und CI/CD-Anwendungsfälle erhöht sandbox-runtime die Messlatte erheblich mit minimalem Setup. Die folgenden Abschnitte behandeln Container und VMs für Bereitstellungen, die stärkere Isolation erfordern.

104 102 


135| `--security-opt seccomp=...` | Beschränkt verfügbare Systemaufrufe; Dockers Standard blockiert \~44, benutzerdefinierte Profile können mehr blockieren |133| `--security-opt seccomp=...` | Beschränkt verfügbare Systemaufrufe; Dockers Standard blockiert \~44, benutzerdefinierte Profile können mehr blockieren |

136| `--read-only` | Macht das Dateisystem des Containers unveränderlich und verhindert, dass der Agent Änderungen beibehält |134| `--read-only` | Macht das Dateisystem des Containers unveränderlich und verhindert, dass der Agent Änderungen beibehält |

137| `--tmpfs /tmp:...` | Stellt ein beschreibbares temporäres Verzeichnis bereit, das gelöscht wird, wenn der Container stoppt |135| `--tmpfs /tmp:...` | Stellt ein beschreibbares temporäres Verzeichnis bereit, das gelöscht wird, wenn der Container stoppt |

138| `--network none` | Entfernt alle Netzwerkschnittstellen; der Agent kommuniziert über den unten eingebundenen Unix-Socket |136| `--network none` | Trennt den Container von externen Netzwerken |

139| `--memory 2g` | Begrenzt die Speichernutzung, um Ressourcenerschöpfung zu verhindern |137| `--memory 2g` | Begrenzt die Speichernutzung, um Ressourcenerschöpfung zu verhindern |

140| `--pids-limit 100` | Begrenzt die Prozessanzahl, um Fork-Bomben zu verhindern |138| `--pids-limit 100` | Begrenzt die Prozessanzahl, um Fork-Bomben zu verhindern |

141| `--user 1000:1000` | Wird als nicht-root-Benutzer ausgeführt |139| `--user 1000:1000` | Wird als nicht-root-Benutzer ausgeführt |


144 142 

145**Unix-Socket-Architektur:**143**Unix-Socket-Architektur:**

146 144 

147Mit `--network none` hat der Container überhaupt keine Netzwerkschnittstellen. Die einzige Möglichkeit für den Agent, die Außenwelt zu erreichen, ist über den eingebundenen Unix-Socket, der mit einem Proxy auf dem Host verbunden ist. Dieser Proxy kann Domain-Zulassungslisten erzwingen, Anmeldedaten injizieren und den gesamten Verkehr protokollieren.145Mit `--network none` schlagen eine DNS-Abfrage oder eine direkte Verbindung zu einem anderen Host innerhalb des Containers fehl. Damit Code im Container andere Hosts erreichen kann, führen Sie einen Proxy auf dem Host aus und binden dessen Unix-Socket in den Container ein. Wenn Sie `ANTHROPIC_BASE_URL` oder `HTTP_PROXY` auf einen Port auf `localhost` verweisen lassen, wie unter [Claude Code für die Verwendung eines Proxys konfigurieren](#configuring-claude-code-to-use-a-proxy) gezeigt, leiten Sie diesen Port innerhalb des Containers an den Socket weiter.

148 146 

149Dies ist die gleiche Architektur, die von [sandbox-runtime](https://github.com/anthropics/sandbox-runtime) verwendet wird. Selbst wenn der Agent über Prompt-Injection kompromittiert wird, kann er Daten nicht zu beliebigen Servern exfiltrieren. Er kann nur über den Proxy kommunizieren, der kontrolliert, welche Domänen erreichbar sind. Weitere Details finden Sie im [Claude Code Sandboxing Blog-Beitrag](https://www.anthropic.com/engineering/claude-code-sandboxing).147Sie können diesen Proxy so einrichten, dass er Domain-Allowlists erzwingt, Anmeldedaten injiziert und den gesamten Verkehr protokolliert.

148 

149> [!WARNING]

150>

151> Innerhalb der Allowlist Ihres Proxys kann der Agent Daten an jede zulässige Domäne senden. Lassen Sie nur die Domänen zu, die der Agent benötigt.

150 152 

151**Zusätzliche Härtungsoptionen:**153**Zusätzliche Härtungsoptionen:**

152 154 

Details

1340 | "default" // Standard permission behavior1340 | "default" // Standard permission behavior

1341 | "acceptEdits" // Auto-accept file edits1341 | "acceptEdits" // Auto-accept file edits

1342 | "bypassPermissions" // Bypass permission checks; explicit ask rules still prompt1342 | "bypassPermissions" // Bypass permission checks; explicit ask rules still prompt

1343 | "plan" // Planning mode - explore without editing1343 | "plan" // Planning mode - Claude explores and plans

1344 | "dontAsk" // Don't prompt for permissions, deny if not pre-approved1344 | "dontAsk" // Don't prompt for permissions, deny if not pre-approved

1345 | "auto"; // A model classifier reviews actions such as shell commands and network requests1345 | "auto"; // A model classifier reviews actions such as shell commands and network requests

1346```1346```


1349 1349 

1350Typ einer benutzerdefinierten Berechtigungsfunktion zur Steuerung der Tool-Nutzung.1350Typ einer benutzerdefinierten Berechtigungsfunktion zur Steuerung der Tool-Nutzung.

1351 1351 

1352Die Funktion ist der SDK-Ersatz für die interaktive Berechtigungsabfrage: Sie wird nur aufgerufen, wenn der [Ablauf der Berechtigungsauswertung](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) zu einer Abfrage führt. Tool-Aufrufe, die bereits durch einen `allowedTools`-Eintrag, eine Allow-Regel in den Einstellungen oder den Berechtigungsmodus wie `acceptEdits` oder `bypassPermissions` genehmigt sind, rufen sie nie auf. Um jeden Tool-Aufruf zu kontrollieren, verwenden Sie stattdessen einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks).1352Die Funktion ersetzt die interaktive Berechtigungsabfrage. Das SDK ruft `canUseTool` auf, wenn der [Ablauf der Berechtigungsauswertung](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) zu einer Abfrage führt. Aufrufe, die auf eine dieser Arten genehmigt werden, laufen ohne Aufruf von `canUseTool`:

1353 

1354* Ein Aufruf, den ein `allowedTools`-Eintrag oder eine Allow-Regel in den Einstellungen genehmigt

1355* Ein Aufruf, den der Berechtigungsmodus genehmigt, etwa eine Dateibearbeitung im Modus `acceptEdits`

1356 

1357Um diese Aufrufe zu prüfen, verwenden Sie einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks), der auch für sie ausgeführt wird.

1353 1358 

1354Eine Allow-Regel genehmigt die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves), nicht vorab; unter [Wie Berechtigungen ausgewertet werden](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) erfahren Sie, welche davon den Callback erreichen und was im Modus `dontAsk` und `auto` geschieht.1359Eine Allow-Regel genehmigt die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves), nicht vorab; unter [Wie Berechtigungen ausgewertet werden](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) erfahren Sie, welche davon den Callback erreichen und was im Modus `dontAsk` und `auto` geschieht.

1355 1360 


2006* Ein Resume, das Claude Code stoppt, weil es [die Sitzung nicht zu ihrem Worktree zurückbringen kann](https://code.claude.com/docs/de/worktrees.md#the-session-resumes-outside-its-worktree), mit `worktree_unverified` oder `worktree_resume_refused`. Dieser Abschnitt sagt, welcher Fehler welchen Wert trägt.2011* Ein Resume, das Claude Code stoppt, weil es [die Sitzung nicht zu ihrem Worktree zurückbringen kann](https://code.claude.com/docs/de/worktrees.md#the-session-resumes-outside-its-worktree), mit `worktree_unverified` oder `worktree_resume_refused`. Dieser Abschnitt sagt, welcher Fehler welchen Wert trägt.

2007* Ein abgelehntes [`continue`](#options) einer Konversation, die eine Hintergrund-Sitzung hält, mit `session_held_by_background`. Für ein abgelehntes [`resume`](#options) einer solchen Konversation schreibt Claude Code das Ergebnis nur, wenn die Variable gesetzt ist.2012* Ein abgelehntes [`continue`](#options) einer Konversation, die eine Hintergrund-Sitzung hält, mit `session_held_by_background`. Für ein abgelehntes [`resume`](#options) einer solchen Konversation schreibt Claude Code das Ergebnis nur, wenn die Variable gesetzt ist.

2008* Ein Start, den Claude Code verweigert, weil [`failIfUnavailable`](#sandboxsettings) aktiviert ist und die Sandbox nicht starten kann, mit `sandbox_required_unavailable`.2013* Ein Start, den Claude Code verweigert, weil [`failIfUnavailable`](#sandboxsettings) aktiviert ist und die Sandbox nicht starten kann, mit `sandbox_required_unavailable`.

2014* Ein Start, den Claude Code verweigert, weil `~/.claude.json` kein gültiges JSON ist, mit `config_file_invalid`.

2009 2015 

2010Der Typ `SDKStartupFailureReason` listet die Werte auf, die `startup_failure_reason` annehmen kann:2016Der Typ `SDKStartupFailureReason` listet die Werte auf, die `startup_failure_reason` annehmen kann:

2011 2017 


2030 | "bypass_root"2036 | "bypass_root"

2031 | "org_config_required_unavailable"2037 | "org_config_required_unavailable"

2032 | "org_config_refused"2038 | "org_config_refused"

2033 | "sandbox_required_unavailable";2039 | "sandbox_required_unavailable"

2040 | "config_file_invalid";

2034```2041```

2035 2042 

2036Jeder Wert benennt eine Ablehnung:2043Jeder Wert benennt eine Ablehnung:


2057| `org_config_required_unavailable` | Die Sitzung benötigt die Richtlinien und verwalteten Einstellungen der Organisation, bevor sie starten kann, und diese konnten nicht geladen werden, etwa wegen eines Netzwerkfehlers oder eines Anthropic-Serverfehlers. Erfordert das Agent SDK v0.3.293 oder höher |2064| `org_config_required_unavailable` | Die Sitzung benötigt die Richtlinien und verwalteten Einstellungen der Organisation, bevor sie starten kann, und diese konnten nicht geladen werden, etwa wegen eines Netzwerkfehlers oder eines Anthropic-Serverfehlers. Erfordert das Agent SDK v0.3.293 oder höher |

2058| `org_config_refused` | Anthropic hat die Bereitstellung der Richtlinien und verwalteten Einstellungen der Organisation für diese Anmeldung verweigert, etwa weil die Anmeldung abgelaufen ist oder widerrufen wurde oder die Organisation Claude Code für dieses Konto nicht zulässt. Erfordert das Agent SDK v0.3.293 oder höher |2065| `org_config_refused` | Anthropic hat die Bereitstellung der Richtlinien und verwalteten Einstellungen der Organisation für diese Anmeldung verweigert, etwa weil die Anmeldung abgelaufen ist oder widerrufen wurde oder die Organisation Claude Code für dieses Konto nicht zulässt. Erfordert das Agent SDK v0.3.293 oder höher |

2059| `sandbox_required_unavailable` | [`failIfUnavailable`](#sandboxsettings) ist aktiviert, und die Sandbox kann nicht starten. Der Text in `errors` endet mit `Set sandbox.failIfUnavailable=false to allow unsandboxed execution.` Erfordert Agent SDK v0.3.314 oder höher |2066| `sandbox_required_unavailable` | [`failIfUnavailable`](#sandboxsettings) ist aktiviert, und die Sandbox kann nicht starten. Der Text in `errors` endet mit `Set sandbox.failIfUnavailable=false to allow unsandboxed execution.` Erfordert Agent SDK v0.3.314 oder höher |

2067| `config_file_invalid` | `~/.claude.json` ist kein gültiges JSON. Claude Code lässt die Datei unverändert, sodass ein erneuter Versuch auf dieselbe Weise fehlschlägt, bis jemand sie repariert. `errors` nennt die Datei und beschreibt, wie sie wiederhergestellt oder repariert werden kann. Siehe [Configuration error in \~/.claude.json](https://code.claude.com/docs/de/errors.md#configuration-error-in-claude-json). Erfordert TypeScript Agent SDK v0.3.318 oder höher und Claude Code v2.1.318 oder höher |

2060 2068 

2061### `SDKSystemMessage`2069### `SDKSystemMessage`

2062 2070 


6106 6114 

6107> [!NOTE]6115> [!NOTE]

6108>6116>

6109> Der integrierte Sandbox-Proxy erzwingt `allowedDomains` basierend auf dem angeforderten Hostnamen und beendet oder inspiziert keinen TLS-Verkehr, daher können Techniken wie [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) ihn möglicherweise umgehen. Siehe [Sandboxing-Sicherheitsbeschränkungen](https://code.claude.com/docs/de/sandboxing.md#security-limitations) für Details und [Sichere Bereitstellung](https://code.claude.com/docs/de/agent-sdk/secure-deployment.md#traffic-forwarding) für die Konfiguration eines TLS-terminierenden Proxys.6117> Der integrierte Sandbox-Proxy erzwingt `allowedDomains` basierend auf dem angeforderten Hostnamen. Standardmäßig beendet oder inspiziert der Proxy keinen TLS-Verkehr, daher können Techniken wie [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) `allowedDomains` möglicherweise umgehen. Siehe [Sandboxing-Sicherheitsbeschränkungen](https://code.claude.com/docs/de/sandboxing.md#security-limitations) für Details und [Sichere Bereitstellung](https://code.claude.com/docs/de/agent-sdk/secure-deployment.md#traffic-forwarding) für die Konfiguration eines TLS-terminierenden Proxys.

6110 6118 

6111### `SandboxFilesystemConfig`6119### `SandboxFilesystemConfig`

6112 6120 

Details

47Der Callback wird in zwei Fällen ausgelöst:47Der Callback wird in zwei Fällen ausgelöst:

48 48 

491. **Tool benötigt Genehmigung**: Claude möchte ein Tool verwenden, das nicht durch eine [Berechtigungsregel](https://code.claude.com/docs/de/agent-sdk/permissions.md) oder einen Berechtigungsmodus automatisch genehmigt wird. Überprüfen Sie `tool_name` auf das Tool (z. B. `"Bash"`, `"Write"`).491. **Tool benötigt Genehmigung**: Claude möchte ein Tool verwenden, das nicht durch eine [Berechtigungsregel](https://code.claude.com/docs/de/agent-sdk/permissions.md) oder einen Berechtigungsmodus automatisch genehmigt wird. Überprüfen Sie `tool_name` auf das Tool (z. B. `"Bash"`, `"Write"`).

502. **Claude stellt eine Frage**: Claude ruft das `AskUserQuestion`-Tool auf. Überprüfen Sie, ob `tool_name == "AskUserQuestion"`, um es anders zu behandeln. Wenn Sie ein `tools`-Array angeben, fügen Sie `AskUserQuestion` ein, damit dies funktioniert. Siehe [Klärungsfragen verarbeiten](#handle-clarifying-questions) für Details.502. **Claude stellt eine Frage**: Claude ruft das `AskUserQuestion`-Tool auf. Überprüfen Sie, ob `tool_name == "AskUserQuestion"`, um es anders zu behandeln. Wenn Sie ein `tools`-Array angeben, fügen Sie `AskUserQuestion` ein, damit dies funktioniert. Weitere Informationen finden Sie unter [Klärungsfragen verarbeiten](#handle-clarifying-questions).

51 51 

52> [!WARNING]52> [!WARNING]

53>53>

54> **Der Callback wird nie für automatisch genehmigte Tools ausgelöst.** Jede Genehmigung früher im [Berechtigungsevaluierungsfluss](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated), eine Zulassungsregel oder ein Modus wie `acceptEdits` oder `bypassPermissions`, löst den Aufruf auf, bevor `canUseTool` konsultiert wird. Wenn Sie ein Tool einfach in `allowed_tools` auflisten, wird eine `canUseTool`-Überprüfung für dieses Tool nur ausgeführt, wenn der [Evaluierungsfluss](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) den Aufruf zurück zu einer Eingabeaufforderung leitet, z. B. eine Ask-Regel oder der `plan`-Modus. Für Logik, die auf jeden Tool-Aufruf angewendet werden muss, verwenden Sie einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks), der vor dem Rest des Flusses ausgeführt wird und Anfragen zulassen, ablehnen oder ändern kann.54> **Ein früherer Schritt kann einen Aufruf zulassen oder ablehnen, bevor `canUseTool` ausgeführt wird.** Der [Ablauf der Berechtigungsauswertung](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated) prüft deny-Regeln, den Berechtigungsmodus und allow-Regeln vor Ihrem Callback.

55>55>

56> Eine Zulassungsregel genehmigt nicht vorab die [Aktionen, die kein Modus automatisch genehmigt](https://code.claude.com/docs/de/permission-modes.md#actions-no-mode-auto-approves); siehe [Wie Berechtigungen ausgewertet werden](https://code.claude.com/docs/de/agent-sdk/permissions.md#how-permissions-are-evaluated), um zu sehen, welche davon den Callback erreichen und was im `dontAsk`- und `auto`-Modus geschieht.56> Um Ihre Prüfungen auch für Aufrufe auszuführen, die eine Regel oder der Berechtigungsmodus bereits zugelassen hat, verwenden Sie einen [`PreToolUse`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks), der für diese Aufrufe ausgeführt wird und sie zulassen, ablehnen oder ändern kann.

57 57 

58Sie können auch den [`PermissionRequest`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks#available-hooks) verwenden, um externe Benachrichtigungen (Slack, E-Mail, Push) zu senden, wenn Claude auf Genehmigung wartet.58Sie können auch den [`PermissionRequest`-Hook](https://code.claude.com/docs/de/agent-sdk/hooks#available-hooks) verwenden, um externe Benachrichtigungen (Slack, E-Mail, Push) zu senden, wenn Claude auf Genehmigung wartet.

59 59 

agent-view.md +2 −2

Details

1020 1020 

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

1022 1022 

1023Mit dem nativen Installer wird der Eintrag als Claude Code angezeigt und die Berechtigung bleibt über Updates hinweg erhalten. Bei anderen Installationsmethoden wie Homebrew oder npm zeigt der Eintrag den Binärpfad an und muss möglicherweise nach dem Update erneut gewährt werden.1023Suchen Sie in beiden Listen nach einem Eintrag namens Claude Code oder nach einem Eintrag, der nach dem Pfad oder Dateinamen der `claude`-Binärdatei benannt ist. Dieser Dateiname kann eine Versionsnummer wie `2.1.316` sein. Wenn `Operation not permitted` nach einem Update von Claude Code erneut auftritt, suchen Sie nach einem neuen Eintrag, etwa einem, der nach der neuen Version benannt ist. Falls ein solcher vorhanden ist, gewähren Sie ihm Zugriff.

1024 1024 

1025### Hintergrund-Sitzungen können auf macOS keine lokalen Netzwerk-Hosts erreichen1025### Hintergrund-Sitzungen können auf macOS keine lokalen Netzwerk-Hosts erreichen

1026 1026 


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

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

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

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

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

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

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

Details

459export ANTHROPIC_BEDROCK_SERVICE_TIER=priority459export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

460```460```

461 461 

462Claude Code sendet dies als `X-Amzn-Bedrock-Service-Tier`-Header bei jeder Anfrage. Die Tier-Verfügbarkeit variiert je nach Modell und Region. Reservierte Kapazität verwendet einen [bereitgestellten Durchsatz](https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html)-ARN als Modell-ID statt dieser Einstellung.462Claude Code sendet dies als `X-Amzn-Bedrock-Service-Tier`-Header bei jeder [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)-Anfrage aus einer Sitzung, in der die Variable gesetzt ist, mit Ausnahme der [Prüfungen des Modellzugriffs](#startup-model-checks). Das Setzen hat keine Auswirkung auf Anfragen an den [Mantle-Endpunkt](#use-the-mantle-endpoint) oder über ein [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway). Die Tier-Verfügbarkeit variiert je nach Modell und Region. Reservierte Kapazität verwendet einen [bereitgestellten Durchsatz](https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html)-ARN als Modell-ID statt dieser Einstellung.

463 

464Um auch [Hintergrundsitzungen](https://code.claude.com/docs/de/agent-view.md#settings-and-provider) abzudecken, die Sie aus einem Terminal starten, legen Sie `ANTHROPIC_BEDROCK_SERVICE_TIER` im [`env`](https://code.claude.com/docs/de/settings-reference#env)-Block Ihrer Einstellungen fest. Diese Sitzungen erhalten den von Ihnen exportierten Wert nur, wenn die Shell, die den [Supervisor](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) gestartet hat, ihn exportiert hat.

463 465 

464## AWS Guardrails466## AWS Guardrails

465 467 


487 489 

488### Aktivieren Sie Mantle490### Aktivieren Sie Mantle

489 491 

490Mit bereits konfigurierten AWS-Anmeldedaten legen Sie `CLAUDE_CODE_USE_MANTLE` fest, um Anfragen zum Mantle-Endpunkt weiterzuleiten:492Mit bereits konfigurierten AWS-Anmeldedaten legen Sie `CLAUDE_CODE_USE_MANTLE` und Ihre AWS-Region fest:

491 493 

492```bash theme={null}494```bash theme={null}

493export CLAUDE_CODE_USE_MANTLE=1495export CLAUDE_CODE_USE_MANTLE=1


587 589 

588* Geben Sie das Modell als [Inferenzprofil](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)-ID an590* Geben Sie das Modell als [Inferenzprofil](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)-ID an

589 591 

590Claude Code verwendet die Amazon Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) und unterstützt die Converse API nicht.

591 

592### Streaming-Fehler hinter einem Gateway oder Proxy592### Streaming-Fehler hinter einem Gateway oder Proxy

593 593 

594Amazon Bedrock streamt `InvokeModelWithResponseStream`-Antworten in einem binären Event-Stream-Format mit dem Header `Content-Type: application/vnd.amazon.eventstream`. Ein Gateway oder Proxy zwischen Claude Code und Amazon Bedrock muss den Antwortkörper und seine Header, einschließlich `Content-Type`, so durchleiten, wie Amazon Bedrock sie gesendet hat.594Amazon Bedrock streamt `InvokeModelWithResponseStream`-Antworten in einem binären Event-Stream-Format mit dem Header `Content-Type: application/vnd.amazon.eventstream`. Ein Gateway oder Proxy zwischen Claude Code und Amazon Bedrock muss den Antwortkörper und seine Header, einschließlich `Content-Type`, so durchleiten, wie Amazon Bedrock sie gesendet hat.


618* Wenn der Fehler eine `bedrock-mantle:`-Aktion benennt, gewähren Sie Ihrer IAM-Identität diese Aktion.618* Wenn der Fehler eine `bedrock-mantle:`-Aktion benennt, gewähren Sie Ihrer IAM-Identität diese Aktion.

619* Wenn der Fehler keine Aktion benennt und Ihre Anmeldedaten gültig sind, wurde Ihrem AWS-Konto kein Zugriff auf das angeforderte Modell gewährt. Wenden Sie sich an Ihr AWS-Kontoteam, um Zugriff anzufordern.619* Wenn der Fehler keine Aktion benennt und Ihre Anmeldedaten gültig sind, wurde Ihrem AWS-Konto kein Zugriff auf das angeforderte Modell gewährt. Wenden Sie sich an Ihr AWS-Kontoteam, um Zugriff anzufordern.

620 620 

621Ein `400`, das die Modell-ID nennt, bedeutet, dass dieses Modell nicht auf Mantle bereitgestellt wird. Mantle hat sein eigenes Modell-Lineup, das vom Standard-Amazon Bedrock-Katalog getrennt ist, daher funktionieren Inferenzprofil-IDs wie `us.anthropic.claude-sonnet-4-6` nicht. Verwenden Sie eine Mantle-Format-ID, oder aktivieren Sie [beide Endpunkte](#run-mantle-alongside-the-invoke-api), damit Claude Code jede Anfrage zum Endpunkt weiterleitet, wo das Modell verfügbar ist.621Ein `400`, das die Modell-ID nennt, bedeutet, dass dieses Modell nicht auf Mantle bereitgestellt wird. Mantle hat sein eigenes Modell-Lineup, das vom Standard-Amazon Bedrock-Katalog getrennt ist, daher funktionieren Inferenzprofil-IDs wie `us.anthropic.claude-sonnet-4-6` nicht. Verwenden Sie eine Mantle-Format-ID, oder aktivieren Sie [beide Endpunkte](#run-mantle-alongside-the-invoke-api), damit Claude Code Inferenzprofil-IDs an die Invoke API sendet.

622 622 

623## Zusätzliche Ressourcen623## Zusätzliche Ressourcen

624 624 

Details

155- Integration tests need DATABASE_URL set, see .env.example155- Integration tests need DATABASE_URL set, see .env.example

156```156```

157 157 

158Führen Sie in einer Sitzung `/context` aus, um zu bestätigen, dass Claude die Datei geladen hat.158Führen Sie in einer Sitzung [`/context all`](https://code.claude.com/docs/de/commands#all-commands) aus, um zu bestätigen, dass Claude die Datei geladen hat.

159 159 

160Beachten Sie, dass die Typecheck-Zeile nur den Befehl enthält. Claude muss den Befehl kennen, um die eigene Arbeit unterwegs prüfen zu können. Wenn Claude Code außerdem einen bestandenen Typecheck *erzwingen* soll, bevor Claude fertig ist, ist das eine Aufgabe für einen [`Stop`-Hook](#enforce-the-check-with-a-stop-hook). Eine Zeile wie `Always typecheck before you finish` in dieser Datei funktioniert meistens, aber nicht jedes Mal.160Beachten Sie, dass die Typecheck-Zeile nur den Befehl enthält. Claude muss den Befehl kennen, um die eigene Arbeit unterwegs prüfen zu können. Wenn Claude Code außerdem einen bestandenen Typecheck *erzwingen* soll, bevor Claude fertig ist, ist das eine Aufgabe für einen [`Stop`-Hook](#enforce-the-check-with-a-stop-hook). Eine Zeile wie `Always typecheck before you finish` in dieser Datei funktioniert meistens, aber nicht jedes Mal.

161 161 


544In einem Skript möchten Sie fast immer ein paar weitere Flags:544In einem Skript möchten Sie fast immer ein paar weitere Flags:

545 545 

546* [`--bare`](https://code.claude.com/docs/de/headless#start-faster-with-bare-mode) überspringt Hooks, Skills, Plugins, MCP-Server und `CLAUDE.md`-Dateien, sowohl die des Repos als auch die des Rechners, sodass der Lauf überall dasselbe tut. Außerdem wird Ihre claude.ai-Anmeldung nie verwendet: Die Authentifizierung kommt aus `ANTHROPIC_API_KEY`, einem `apiKeyHelper` in der Datei, die Sie mit `--settings` übergeben, oder den Anmeldedaten Ihres Cloud-Anbieters.546* [`--bare`](https://code.claude.com/docs/de/headless#start-faster-with-bare-mode) überspringt Hooks, Skills, Plugins, MCP-Server und `CLAUDE.md`-Dateien, sowohl die des Repos als auch die des Rechners, sodass der Lauf überall dasselbe tut. Außerdem wird Ihre claude.ai-Anmeldung nie verwendet: Die Authentifizierung kommt aus `ANTHROPIC_API_KEY`, einem `apiKeyHelper` in der Datei, die Sie mit `--settings` übergeben, oder den Anmeldedaten Ihres Cloud-Anbieters.

547* `--append-system-prompt`, `--mcp-config` und `--settings` übergeben explizit, was der Lauf *tatsächlich* braucht.547* `--append-system-prompt`, `--mcp-config` und `--settings` übergeben explizit, was der Lauf *tatsächlich* braucht. Hooks, die Sie mit `--settings` übergeben, [laufen unter `--bare` nicht](https://code.claude.com/docs/de/headless#start-faster-with-bare-mode), verwenden Sie `--bare` also nicht für einen Lauf, der sie benötigt.

548* `--allowedTools` genehmigt seine Tools vorab, und [`--permission-mode dontAsk`](https://code.claude.com/docs/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) lehnt alles andere ab, das eine Abfrage ausgelöst hätte.548* `--allowedTools` genehmigt seine Tools vorab, und [`--permission-mode dontAsk`](https://code.claude.com/docs/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) lehnt alles andere ab, das eine Abfrage ausgelöst hätte.

549* `--output-format json` liefert Ihnen ein einzelnes Ergebnisobjekt zum Parsen, und `stream-json` mit `--verbose` streamt Ereignisse, während sie auftreten.549* `--output-format json` liefert Ihnen ein einzelnes Ergebnisobjekt zum Parsen, und `stream-json` mit `--verbose` streamt Ereignisse, während sie auftreten.

550 550 

Details

494 494 

495* Wenn STS ablehnt oder nicht erreichbar ist, sendet das Gateway die Anfrage nicht mit den eigenen Anmeldedaten des Upstreams. Es protokolliert den STS-Fehler zusammen mit dem, was zu prüfen ist, und versucht dann den nächsten aufgelisteten Upstream. [Upstream-Fehlermeldungen](#upstream-error-messages) beschreibt, was der Client erhält, wenn kein Upstream erfolgreich ist. Ein späterer Upstream ohne `assume_role` würde die Anfrage mit seinen eigenen Anmeldedaten bedienen, listen Sie einen solchen also nur auf, wenn Sie das wollen.495* Wenn STS ablehnt oder nicht erreichbar ist, sendet das Gateway die Anfrage nicht mit den eigenen Anmeldedaten des Upstreams. Es protokolliert den STS-Fehler zusammen mit dem, was zu prüfen ist, und versucht dann den nächsten aufgelisteten Upstream. [Upstream-Fehlermeldungen](#upstream-error-messages) beschreibt, was der Client erhält, wenn kein Upstream erfolgreich ist. Ein späterer Upstream ohne `assume_role` würde die Anfrage mit seinen eigenen Anmeldedaten bedienen, listen Sie einen solchen also nur auf, wenn Sie das wollen.

496* Das Gateway ruft den regionalen STS-Endpunkt `sts.<region>.amazonaws.com` auf, den sein Netzwerk erreichen muss. Für den FIPS-Endpunkt setzen Sie `AWS_USE_FIPS_ENDPOINT=true` in der Umgebung des Gateways statt `use_fips_endpoint` in einer AWS-Konfigurationsdatei.496* Das Gateway ruft den regionalen STS-Endpunkt `sts.<region>.amazonaws.com` auf, den sein Netzwerk erreichen muss. Für den FIPS-Endpunkt setzen Sie `AWS_USE_FIPS_ENDPOINT=true` in der Umgebung des Gateways statt `use_fips_endpoint` in einer AWS-Konfigurationsdatei.

497* `assume_role` gilt nur für `provider: bedrock` und benötigt SigV4-Quell-Anmeldedaten: Das Gateway weigert sich zu starten, wenn es neben `aws_bearer_token` gesetzt ist.497* `assume_role` benötigt SigV4-Quell-Anmeldedaten: Das Gateway startet nicht, wenn es zusammen mit `aws_bearer_token` gesetzt ist.

498* Ohne eine [`groups`-Liste](#send-each-team-to-its-own-upstream) kann jeder Entwickler, den das Gateway zulässt, diesen Upstream verwenden. Um einzuschränken, welche Modelle ein Entwickler verwenden kann, setzen Sie `availableModels` in einer [`managed`](#managed)-Richtlinie.498* Ohne eine [`groups`-Liste](#send-each-team-to-its-own-upstream) kann jeder Entwickler, den das Gateway zulässt, diesen Upstream verwenden. Um einzuschränken, welche Modelle ein Entwickler verwenden kann, setzen Sie `availableModels` in einer [`managed`](#managed)-Richtlinie.

499* Damit ein über die Rolle bereitgestelltes Modell nicht auch von einem anderen Konto bereitgestellt wird, geben Sie ihm eine benutzerdefinierte ID, deren `upstream_model`-Zuordnung nur den Namen dieses Upstreams enthält. Bei einer solchen ID überspringt das Gateway jeden anderen Upstream, sodass weder die Anfrage noch die Token-Zählung für eine abgebrochene Anfrage per Failover an ein anderes Konto gehen kann.499* Damit ein über die Rolle bereitgestelltes Modell nicht auch von einem anderen Konto bereitgestellt wird, geben Sie ihm eine benutzerdefinierte ID, deren `upstream_model`-Zuordnung nur den Namen dieses Upstreams enthält. Bei einer solchen ID überspringt das Gateway jeden anderen Upstream, sodass weder die Anfrage noch die Token-Zählung für eine abgebrochene Anfrage per Failover an ein anderes Konto gehen kann.

500* Eine Anfrage für einen integrierten Modellnamen kann diesen Upstream dennoch [erreichen](#multiple-upstreams), und das Gateway signiert sie mit derselben Rolle. Führen Sie diesen Upstream zuletzt auf, sofern sein Konto diese Modelle nicht ebenfalls bereitstellen soll.500* Eine Anfrage für einen integrierten Modellnamen kann diesen Upstream dennoch [erreichen](#multiple-upstreams), und das Gateway signiert sie mit derselben Rolle. Führen Sie diesen Upstream zuletzt auf, sofern sein Konto diese Modelle nicht ebenfalls bereitstellen soll.


556| `region` | Ja | AWS-Region. Das Gateway leitet den Endpunkt davon ab als `https://bedrock-mantle.<region>.api.aws/anthropic`. |556| `region` | Ja | AWS-Region. Das Gateway leitet den Endpunkt davon ab als `https://bedrock-mantle.<region>.api.aws/anthropic`. |

557| `models` | Ja | Die Modelle, für die Ihr AWS-Konto auf Mantle freigeschaltet ist, so benannt, wie Clients sie senden, etwa `claude-haiku-4-5`. Nur diese gehen an diesen Upstream, und jedes andere Modell springt zum nächsten weiter. |557| `models` | Ja | Die Modelle, für die Ihr AWS-Konto auf Mantle freigeschaltet ist, so benannt, wie Clients sie senden, etwa `claude-haiku-4-5`. Nur diese gehen an diesen Upstream, und jedes andere Modell springt zum nächsten weiter. |

558| `auth` | Nein | Akzeptiert dieselben Schlüssel wie der `auth`-Block des [Amazon Bedrock](#amazon-bedrock)-Upstreams, nach denselben Regeln. |558| `auth` | Nein | Akzeptiert dieselben Schlüssel wie der `auth`-Block des [Amazon Bedrock](#amazon-bedrock)-Upstreams, nach denselben Regeln. |

559| `assume_role` | Nein | Die Rolle, über die die Anfragen dieses Upstreams laufen, mit denselben Schlüsseln wie [bei einem `bedrock`-Upstream](#bedrock-in-another-aws-account), einschließlich `session_name` für die [Zuordnung pro Entwickler](#per-developer-aws-cost-attribution). Geben Sie der Rolle die IAM-Aktionen von Mantle. Erfordert ein Gateway mit Claude Code v2.1.318 oder höher. Ein früheres Gateway beendet sich beim Start mit `Unrecognized key(s) in object: 'assume_role'`. |

559| `base_url` | Nein | Überschreiben Sie den abgeleiteten Endpunkt. Behalten Sie den Pfad `/anthropic` am Ende bei. |560| `base_url` | Nein | Überschreiben Sie den abgeleiteten Endpunkt. Behalten Sie den Pfad `/anthropic` am Ende bei. |

560 561 

561Gewähren Sie der AWS-Identität des Upstreams die eigenen IAM-Aktionen von Mantle für Inference und Token-Zählung, die unter [Mantle-Endpunkt verwenden](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint) aufgeführt sind.562Gewähren Sie der AWS-Identität des Upstreams die eigenen IAM-Aktionen von Mantle für Inference und Token-Zählung, die unter [Mantle-Endpunkt verwenden](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint) aufgeführt sind.


565Die Einstellungen `guardrail` und `assume_role` eines `bedrock`-Upstreams erstrecken sich nicht auf die Anfragen, die Mantle bedient:566Die Einstellungen `guardrail` und `assume_role` eines `bedrock`-Upstreams erstrecken sich nicht auf die Anfragen, die Mantle bedient:

566 567 

567* **`guardrail`**: Das Gateway wendet keine [Bedrock-Guardrail](#apply-an-amazon-bedrock-guardrail) auf Anfragen an, die es an Mantle sendet, daher weigert es sich zu starten, wenn ein `mantle`-Upstream aufgelistet ist, während ein `bedrock`-Upstream `guardrail` setzt.568* **`guardrail`**: Das Gateway wendet keine [Bedrock-Guardrail](#apply-an-amazon-bedrock-guardrail) auf Anfragen an, die es an Mantle sendet, daher weigert es sich zu starten, wenn ein `mantle`-Upstream aufgelistet ist, während ein `bedrock`-Upstream `guardrail` setzt.

568* **`assume_role`**: Ein `mantle`-Upstream akzeptiert kein [`assume_role`](#bedrock-in-another-aws-account). Anfragen, die Mantle bedient, werden mit den eigenen `auth`-Anmeldedaten des `mantle`-Upstreams gesendet und nicht [pro Entwickler zugeordnet](#per-developer-aws-cost-attribution).569* **`assume_role`**: Setzen Sie es für den `mantle`-Upstream selbst. Ohne diese Einstellung werden von Mantle bediente Anfragen mit den eigenen `auth`-Anmeldedaten des `mantle`-Upstreams gesendet.

569 570 

570Was die eigenen Fehlerantworten von Mantle bedeuten, erfahren Sie unter [Mantle-Endpunkt-Fehler](https://code.claude.com/docs/de/amazon-bedrock.md#mantle-endpoint-errors).571Was die eigenen Fehlerantworten von Mantle bedeuten, erfahren Sie unter [Mantle-Endpunkt-Fehler](https://code.claude.com/docs/de/amazon-bedrock.md#mantle-endpoint-errors).

571 572 

Details

424| Log: `refresh failed request_id=<id>: invalid_token (…) (at userinfo_no_id_token, …)`, und Entwickler sehen `Cloud gateway session expired` alle `session.ttl_hours` | Der IdP hat das Refresh-Token akzeptiert, aber kein id\_token dazu zurückgegeben, daher hat das Gateway den Userinfo-Endpunkt des IdP nach den Claims des Benutzers gefragt. Der IdP hat dort das erneuerte Access-Token abgelehnt. Das Gateway antwortet mit `temporarily_unavailable`, sodass Claude Code das Refresh-Token behält, die Sitzung aber nicht erneuern kann. Gateway-Versionen vor v2.1.260 protokollieren dieselbe Zeile ohne das Detail `(at …)`. | Setzen Sie [`oidc.scope_on_refresh: true`](https://code.claude.com/docs/de/claude-apps-gateway-config#oidc), verfügbar ab Gateway v2.1.260, damit die Refresh-Anfrage erneut `openid` anfordert. Manche IdPs wie Okta geben beim Refresh nur dann ein id\_token zurück, wenn es angefordert wird. Aktivieren Sie bei PingFederate stattdessen **Return ID Token On Refresh Grant** unter **Applications > OAuth > OpenID Connect Policy Management**. Der Schlüssel ändert das Verhalten von PingFederate nicht. Prüfen Sie bei anderen IdPs, die es weiterhin weglassen, ob der Userinfo-Endpunkt Access-Tokens akzeptiert, die durch einen Refresh ausgestellt wurden. Erhöhen Sie als Übergangslösung [`session.ttl_hours`](https://code.claude.com/docs/de/claude-apps-gateway-config#session). Siehe [Einrichtung des Identitätsanbieters](#identity-provider-setup) für den Zielkonflikt beim Deprovisioning. |424| Log: `refresh failed request_id=<id>: invalid_token (…) (at userinfo_no_id_token, …)`, und Entwickler sehen `Cloud gateway session expired` alle `session.ttl_hours` | Der IdP hat das Refresh-Token akzeptiert, aber kein id\_token dazu zurückgegeben, daher hat das Gateway den Userinfo-Endpunkt des IdP nach den Claims des Benutzers gefragt. Der IdP hat dort das erneuerte Access-Token abgelehnt. Das Gateway antwortet mit `temporarily_unavailable`, sodass Claude Code das Refresh-Token behält, die Sitzung aber nicht erneuern kann. Gateway-Versionen vor v2.1.260 protokollieren dieselbe Zeile ohne das Detail `(at …)`. | Setzen Sie [`oidc.scope_on_refresh: true`](https://code.claude.com/docs/de/claude-apps-gateway-config#oidc), verfügbar ab Gateway v2.1.260, damit die Refresh-Anfrage erneut `openid` anfordert. Manche IdPs wie Okta geben beim Refresh nur dann ein id\_token zurück, wenn es angefordert wird. Aktivieren Sie bei PingFederate stattdessen **Return ID Token On Refresh Grant** unter **Applications > OAuth > OpenID Connect Policy Management**. Der Schlüssel ändert das Verhalten von PingFederate nicht. Prüfen Sie bei anderen IdPs, die es weiterhin weglassen, ob der Userinfo-Endpunkt Access-Tokens akzeptiert, die durch einen Refresh ausgestellt wurden. Erhöhen Sie als Übergangslösung [`session.ttl_hours`](https://code.claude.com/docs/de/claude-apps-gateway-config#session). Siehe [Einrichtung des Identitätsanbieters](#identity-provider-setup) für den Zielkonflikt beim Deprovisioning. |

425| Ein Entwickler meldet sich an, dann schlägt jede Anfrage aus dieser Sitzung mit einem `431`-Fehler fehl | Das Sitzungs-Token im `Authorization`-Header jeder Anfrage listet die IdP-Gruppen des Entwicklers auf, sodass die Header bei einem Entwickler in vielen Gruppen insgesamt mehr umfassen können, als das Gateway akzeptiert | Siehe [Request-Header nach der Anmeldung zu groß](#request-headers-too-large-after-sign-in), um zu erfahren, welches Limit gilt und was Sie ändern müssen |425| Ein Entwickler meldet sich an, dann schlägt jede Anfrage aus dieser Sitzung mit einem `431`-Fehler fehl | Das Sitzungs-Token im `Authorization`-Header jeder Anfrage listet die IdP-Gruppen des Entwicklers auf, sodass die Header bei einem Entwickler in vielen Gruppen insgesamt mehr umfassen können, als das Gateway akzeptiert | Siehe [Request-Header nach der Anmeldung zu groß](#request-headers-too-large-after-sign-in), um zu erfahren, welches Limit gilt und was Sie ändern müssen |

426| Jede Amazon Bedrock-Anfrage gibt 502 zurück; das Log zeigt `Could not load credentials from any providers` | Auf EC2 blockiert das standardmäßige Hop-Limit von 1 bei IMDSv2 die Instance-Metadata-Anfrage aus dem Container heraus. Start und `/readyz` sind trotzdem erfolgreich, weil das AWS SDK die Instanz-Anmeldedaten erst bei der ersten Anfrage auflöst, nicht beim Erstellen des Clients | Erhöhen Sie das Hop-Limit mit `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2` oder setzen Sie es im Launch Template. Die Änderung gilt für jeden Container auf der Instanz. Bevorzugen Sie nach Möglichkeit ECS-Task-Rollen, die Anmeldedaten vom ECS-Container-Credentials-Endpunkt lesen und die Änderung ganz vermeiden, oder nehmen Sie die Änderung auf einer dedizierten Gateway-Instanz vor, um die Angriffsfläche zu begrenzen. |426| Jede Amazon Bedrock-Anfrage gibt 502 zurück; das Log zeigt `Could not load credentials from any providers` | Auf EC2 blockiert das standardmäßige Hop-Limit von 1 bei IMDSv2 die Instance-Metadata-Anfrage aus dem Container heraus. Start und `/readyz` sind trotzdem erfolgreich, weil das AWS SDK die Instanz-Anmeldedaten erst bei der ersten Anfrage auflöst, nicht beim Erstellen des Clients | Erhöhen Sie das Hop-Limit mit `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2` oder setzen Sie es im Launch Template. Die Änderung gilt für jeden Container auf der Instanz. Bevorzugen Sie nach Möglichkeit ECS-Task-Rollen, die Anmeldedaten vom ECS-Container-Credentials-Endpunkt lesen und die Änderung ganz vermeiden, oder nehmen Sie die Änderung auf einer dedizierten Gateway-Instanz vor, um die Angriffsfläche zu begrenzen. |

427| Log: eine Warnung, die `upstream <name>: Google issued an access token that expires in <N>s` enthält, bei einem Upstream, dessen Google-Anmeldedatendatei den Typ `external_account` hat | Anfragen sind erfolgreich, bis dieses Access-Token abläuft, und schlagen dann fehl, sofern das Token, auf das `credential_source` verweist, nicht vorher erneuert wurde. | Wenn ein Prozess dieses Token in eine Datei schreibt, lassen Sie ihn mehr als fünf Minuten vor Ablauf des alten Tokens ein neues schreiben |

427| Bei Spitzenlast beginnen Antworten verzögert oder scheinen zu hängen, oder sie schlagen mit einem 502 `all upstreams failed` fehl, obwohl der Upstream fehlerfrei ist | Ein Replikat hat mehr Anfragen offen, als es gleichzeitig an den Upstream sendet, sodass die zusätzlichen Anfragen im Gateway warten. Bei einem `provider: anthropic`-Upstream gibt eine Anfrage, die länger als `timeouts.upstream_ttfb_ms` wartet, diesen Upstream auf, was den 502 erzeugt, wenn kein nachfolgender Upstream sie bedient. Das Log zeigt eine Warnung, die `client requests are open` enthält. | Fügen Sie Replikate hinzu oder erhöhen Sie das Limit für jedes Replikat. Siehe [Gleichzeitige Upstream-Anfragen](#concurrent-upstream-requests). |428| Bei Spitzenlast beginnen Antworten verzögert oder scheinen zu hängen, oder sie schlagen mit einem 502 `all upstreams failed` fehl, obwohl der Upstream fehlerfrei ist | Ein Replikat hat mehr Anfragen offen, als es gleichzeitig an den Upstream sendet, sodass die zusätzlichen Anfragen im Gateway warten. Bei einem `provider: anthropic`-Upstream gibt eine Anfrage, die länger als `timeouts.upstream_ttfb_ms` wartet, diesen Upstream auf, was den 502 erzeugt, wenn kein nachfolgender Upstream sie bedient. Das Log zeigt eine Warnung, die `client requests are open` enthält. | Fügen Sie Replikate hinzu oder erhöhen Sie das Limit für jedes Replikat. Siehe [Gleichzeitige Upstream-Anfragen](#concurrent-upstream-requests). |

428| Bei einem anderen Upstream als `provider: anthropic` schlägt ein Turn mit einer langen Denkpause fehl. Der Proxy vor dem Gateway protokolliert eine Anfrage, die etwa 12,5 Minuten offen bleibt, dann eine Reihe von `504`-Fehlern | Claude Code hat einen Stream beendet, der sein erstes Antwort-Event geliefert und danach nur noch Keepalive-Pings übertragen hatte. Es hat die Anfrage ohne Streaming erneut gesendet, und jede Antwort dauert länger als der Timeout des Proxys. | Erhöhen Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für Ihre Entwickler. Siehe [Langes Thinking endet in Proxy-Timeouts](#long-thinking-ends-in-proxy-timeouts). |429| Bei einem anderen Upstream als `provider: anthropic` schlägt ein Turn mit einer langen Denkpause fehl. Der Proxy vor dem Gateway protokolliert eine Anfrage, die etwa 12,5 Minuten offen bleibt, dann eine Reihe von `504`-Fehlern | Claude Code hat einen Stream beendet, der sein erstes Antwort-Event geliefert und danach nur noch Keepalive-Pings übertragen hatte. Es hat die Anfrage ohne Streaming erneut gesendet, und jede Antwort dauert länger als der Timeout des Proxys. | Erhöhen Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für Ihre Entwickler. Siehe [Langes Thinking endet in Proxy-Timeouts](#long-thinking-ends-in-proxy-timeouts). |

429| Bei `provider: anthropic` schlägt ein Turn mit einer langen Denkpause fehl. Der Proxy protokolliert eine Anfrage, die etwa 20 Minuten offen ist, dann `502`- oder `504`-Fehler | Claude Code hat einen Stream beendet, der sein erstes Antwort-Event geliefert und danach nur noch Keepalive-Pings übertragen hatte. Es hat die Anfrage ohne Streaming erneut gesendet, und jede Antwort dauert länger als die Wartezeit des Gateways auf den Upstream, `timeouts.upstream_ttfb_ms`, oder der Timeout des Proxys. | Erhöhen Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für Ihre Entwickler. Siehe [Langes Thinking bei einem Anthropic API-Upstream](#long-thinking-on-an-anthropic-api-upstream). |430| Bei `provider: anthropic` schlägt ein Turn mit einer langen Denkpause fehl. Der Proxy protokolliert eine Anfrage, die etwa 20 Minuten offen ist, dann `502`- oder `504`-Fehler | Claude Code hat einen Stream beendet, der sein erstes Antwort-Event geliefert und danach nur noch Keepalive-Pings übertragen hatte. Es hat die Anfrage ohne Streaming erneut gesendet, und jede Antwort dauert länger als die Wartezeit des Gateways auf den Upstream, `timeouts.upstream_ttfb_ms`, oder der Timeout des Proxys. | Erhöhen Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für Ihre Entwickler. Siehe [Langes Thinking bei einem Anthropic API-Upstream](#long-thinking-on-an-anthropic-api-upstream). |

Details

131| `session-env/` | Pro-Sitzungs-Umgebungsmetadaten |131| `session-env/` | Pro-Sitzungs-Umgebungsmetadaten |

132| `tasks/` | Aufgabenlisten, die von den Task-Tools geschrieben werden, ein Verzeichnis pro Liste |132| `tasks/` | Aufgabenlisten, die von den Task-Tools geschrieben werden, ein Verzeichnis pro Liste |

133| `shell-snapshots/` | Aliase, Funktionen und Shell-Optionen, die beim Start erfasst und vom [Bash-Tool](https://code.claude.com/docs/de/tools-reference.md#bash-tool-behavior) auf jeden Befehl angewendet werden. Wird bei sauberer Beendigung entfernt. Die Bereinigung löscht alle, die nach einem Absturz übrig bleiben. |133| `shell-snapshots/` | Aliase, Funktionen und Shell-Optionen, die beim Start erfasst und vom [Bash-Tool](https://code.claude.com/docs/de/tools-reference.md#bash-tool-behavior) auf jeden Befehl angewendet werden. Wird bei sauberer Beendigung entfernt. Die Bereinigung löscht alle, die nach einem Absturz übrig bleiben. |

134| `backups/` | Frühere Versionen von `~/.claude.json`, kopiert, wenn Claude Code die Datei umschreibt. Claude Code behält die fünf neuesten, plus eine Kopie jeder Version, die es nicht analysieren konnte. |134| `backups/` | Frühere Versionen von `~/.claude.json`, kopiert, wenn Claude Code die Datei umschreibt. Claude Code behält die fünf neuesten Kopien, plus eine Kopie jeder Version, die es nicht analysieren konnte. Nach Ablauf der Altersgrenze wird auch die letzte Kopie gelöscht, die Ihre Konfiguration enthält. Wenn die aktuelle Datei analysiert werden kann, Ihre Konfiguration enthält und kleiner als 8 MiB ist, bleibt Ihnen eine neue Kopie davon. |

135| `feedback-bundles/` | Redigierte Transkript-Archive, die von `/feedback` auf Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind geschrieben werden, um an Ihr Anthropic-Kontoteam gesendet zu werden |135| `feedback-bundles/` | Redigierte Transkript-Archive, die von `/feedback` auf Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind geschrieben werden, um an Ihr Anthropic-Kontoteam gesendet zu werden |

136| `feedback/drafts/` | Warteschlange [Claude-entworfener Feedback](https://code.claude.com/docs/de/tools-reference.md#sendfeedback-tool-behavior) in Erwartung Ihrer Überprüfung in `/feedback`. Bereinigt nach `cleanupPeriodDays` oder 30 Tagen, je nachdem, welcher Wert kürzer ist. Wenn die Warteschlange ihre Grenze von 10 Entwürfen erreicht, löscht Claude Code den ältesten Entwurf, um Platz zu schaffen. |136| `feedback/drafts/` | Warteschlange [Claude-entworfener Feedback](https://code.claude.com/docs/de/tools-reference.md#sendfeedback-tool-behavior) in Erwartung Ihrer Überprüfung in `/feedback`. Bereinigt nach `cleanupPeriodDays` oder 30 Tagen, je nachdem, welcher Wert kürzer ist. Wenn die Warteschlange ihre Grenze von 10 Entwürfen erreicht, löscht Claude Code den ältesten Entwurf, um Platz zu schaffen. |

137| `usage-data/` | `report.html` und zeitgestempelte Report-Kopien, die von [`/insights`](https://code.claude.com/docs/de/costs#analyze-your-usage-patterns) geschrieben werden, plus zwischengespeicherte Pro-Sitzungs-Analysedaten, die zu ihrer Erstellung verwendet werden |137| `usage-data/` | `report.html` und zeitgestempelte Report-Kopien, die von [`/insights`](https://code.claude.com/docs/de/costs#analyze-your-usage-patterns) geschrieben werden, plus zwischengespeicherte Pro-Sitzungs-Analysedaten, die zu ihrer Erstellung verwendet werden |


288| `~/.claude/tasks/` | Ihre [Aufgabenlisten](https://code.claude.com/docs/de/interactive-mode.md#task-list), einschließlich solcher, die noch verwendet werden |288| `~/.claude/tasks/` | Ihre [Aufgabenlisten](https://code.claude.com/docs/de/interactive-mode.md#task-list), einschließlich solcher, die noch verwendet werden |

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

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

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

292| `~/.claude/backups/` | Die früheren Kopien, aus denen Sie [`~/.claude.json` wiederherstellen können](https://code.claude.com/docs/de/errors#configuration-error-in-claude-json) |

292| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Nichts. Legacy-Verzeichnisse nicht von aktuellen Versionen geschrieben. |293| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Nichts. Legacy-Verzeichnisse nicht von aktuellen Versionen geschrieben. |

293 294 

294Löschen Sie nicht `~/.claude.json`, `~/.claude/settings.json` oder `~/.claude/plugins/`: Diese enthalten Ihre Kontodaten, Voreinstellungen und installierten Plugins.295Löschen Sie nicht `~/.claude.json`, `~/.claude/settings.json` oder `~/.claude/plugins/`: Diese enthalten Ihre Kontodaten, Voreinstellungen und installierten Plugins.

Details

480* **„Kann Ihr Repository nicht erreichen“**, berichtet von einem Thread, wenn sein Klon fehlschlägt: GitHub lehnte den Klon ab, das Repository wurde nicht unter dem Namen gefunden, den das Projekt hat, oder der Branch, von dem der Thread starten sollte, existiert nicht.480* **„Kann Ihr Repository nicht erreichen“**, berichtet von einem Thread, wenn sein Klon fehlschlägt: GitHub lehnte den Klon ab, das Repository wurde nicht unter dem Namen gefunden, den das Projekt hat, oder der Branch, von dem der Thread starten sollte, existiert nicht.

481* **„Claude kann nicht auf“ ein Repository zugreifen**, angezeigt, wenn Sie Repositories im Dialog **Neues Projekt** oder **Projekteinstellungen** speichern. Die Nachricht wird mit einem Install-Link und einem Reconnect-Link fortgesetzt. Verwenden Sie den Install-Link, wenn die Claude GitHub App nicht auf diesem Repository ist, und den Reconnect-Link, wenn sie es ist, da die GitHub App auf GitHub installiert sein kann, ohne mit dem Konto verknüpft zu sein, das Sie mit Claude verbunden haben. Wenn die Nachricht sagt, dass die GitHub App ausgesetzt ist oder dieses Repository nicht enthält, folgen Sie ihrem Link zu GitHub, um das zu beheben.481* **„Claude kann nicht auf“ ein Repository zugreifen**, angezeigt, wenn Sie Repositories im Dialog **Neues Projekt** oder **Projekteinstellungen** speichern. Die Nachricht wird mit einem Install-Link und einem Reconnect-Link fortgesetzt. Verwenden Sie den Install-Link, wenn die Claude GitHub App nicht auf diesem Repository ist, und den Reconnect-Link, wenn sie es ist, da die GitHub App auf GitHub installiert sein kann, ohne mit dem Konto verknüpft zu sein, das Sie mit Claude verbunden haben. Wenn die Nachricht sagt, dass die GitHub App ausgesetzt ist oder dieses Repository nicht enthält, folgen Sie ihrem Link zu GitHub, um das zu beheben.

482 482 

483Um eines von ihnen zu beheben, klicken Sie auf die Schaltfläche, die die Nachricht anbietet, wie z. B. **GitHub App installieren** oder **Repositories auf GitHub auswählen**, dann **Erneut überprüfen**. Wenn der Block auf der GitHub-Organisations-Seite ist, wie z. B. ein Besitzer, der die App nicht genehmigt hat, oder eine IP-Zulassungsliste, die Claude ausschließt, zeigt die Nachricht einen Link **Siehe wie zu beheben** statt. Wenn es keine Schaltfläche gibt, folgen Sie [GitHub-Zugriff einrichten](#set-up-github-access), dann senden Sie eine weitere Nachricht zum Wiederholen.483Um den GitHub-Zugriff bei „Konnte die Sitzung nicht starten“ oder „Kann Ihr Repository nicht erreichen“ zu beheben, klicken Sie auf die Schaltfläche, die die Nachricht anbietet, wie z. B. **Auf GitHub installieren** oder **Repositorys auswählen**. Wenn es keine Schaltfläche gibt, folgen Sie [GitHub-Zugriff einrichten](#set-up-github-access). Bitten Sie Claude nach der Behebung im Projektgespräch, einen neuen Thread für dieselbe Arbeit zu starten.

484 484 

485### Ein Thread hat das Nutzungslimit erreicht485### Ein Thread hat das Nutzungslimit erreicht

486 486 


505 505 

506| Nachricht | Was zu tun ist |506| Nachricht | Was zu tun ist |

507| :- | :- |507| :- | :- |

508| „Kann nicht mit Repository verbinden“ mit „Claude konnte nicht zu GitHub gehen, um Ihr Repository zu holen“ | Warten Sie einen Moment, dann senden Sie eine weitere Nachricht zum Wiederholen |508| „Kann nicht mit Repository verbinden“ mit „Claude konnte GitHub nicht erreichen, um Ihr Repository abzurufen“ | Warten Sie einen Moment und bitten Sie Claude dann im Projektgespräch, einen neuen Thread für dieselbe Arbeit zu starten |

509| „Kann nicht mit Repository verbinden“ mit „Claude konnte nicht auf Ihr Repository oder Ihre Umgebung zugreifen“ | Ihr GitHub-Konto benötigt Push-Zugriff auf das Repository, und die Umgebung muss immer noch existieren. Überprüfen Sie beide in **Projekteinstellungen > Umgebung**, dann wiederholen Sie |509| „Kann nicht mit Repository verbinden“ mit „Claude konnte nicht auf Ihr Repository oder Ihre Umgebung zugreifen“ | Ihr GitHub-Konto benötigt Push-Zugriff auf das Repository, und die Umgebung muss immer noch existieren. Überprüfen Sie beide in **Projekteinstellungen > Umgebung**, dann wiederholen Sie |

510| „Konnte die Setup-Vorschlag nicht anzeigen“ | Die App, die Sie offen haben, ist älter als die **Setup-Empfehlungen**, die Claude gesendet hat. Aktualisieren Sie die Seite oder starten Sie die Desktop-App neu, oder bitten Sie Claude, den Setup erneut vorzuschlagen |510| „Konnte die Setup-Vorschlag nicht anzeigen“ | Die App, die Sie offen haben, ist älter als die **Setup-Empfehlungen**, die Claude gesendet hat. Aktualisieren Sie die Seite oder starten Sie die Desktop-App neu, oder bitten Sie Claude, den Setup erneut vorzuschlagen |

511| „Die Umgebung des Projekts wurde entfernt“ | Wählen Sie eine andere Umgebung in **Projekteinstellungen > Umgebung**; die Änderung gilt für neue Threads |511| „Die Umgebung des Projekts wurde entfernt“ | Wählen Sie eine andere Umgebung in **Projekteinstellungen > Umgebung**; die Änderung gilt für neue Threads |

Details

12 12 

13## Sehen Sie, was in den Kontext geladen wurde13## Sehen Sie, was in den Kontext geladen wurde

14 14 

15Der Befehl `/context` zeigt alles, was das Kontextfenster für die aktuelle Sitzung belegt, aufgeschlüsselt nach Kategorie: Systemaufforderung, Systemtools, MCP-Tools, benutzerdefinierte Subagenten mit der Quelle, aus der jeder geladen wurde, Speicherdateien, Skills und Konversationsnachrichten. Führen Sie ihn zuerst aus, um zu bestätigen, ob Ihre `CLAUDE.md`, Regeln oder Skill-Beschreibungen überhaupt vorhanden sind. Der Skills-Bereich in `/context` enthält auch [gebündelte Skills](https://code.claude.com/docs/de/skills.md#bundled-skills), die `/skills` nicht auflistet.15Der Befehl `/context` zeigt alles, was das Kontextfenster für die aktuelle Sitzung belegt. Er schlüsselt dies nach Kategorie auf: System-Prompt, Systemtools, MCP-Tools, benutzerdefinierte Subagenten mit der Quelle, aus der jeder geladen wurde, Memory-Dateien, Skills und Konversationsnachrichten. Führen Sie ihn zuerst aus, um zu bestätigen, ob Ihre `CLAUDE.md`, Regeln oder Skill-Beschreibungen überhaupt vorhanden sind. Der Skills-Bereich in `/context` enthält auch [mitgelieferte Skills](https://code.claude.com/docs/de/skills.md#bundled-skills), die `/skills` nicht auflistet.

16 

17Im [Vollbildmodus](https://code.claude.com/docs/de/fullscreen.md) klappt `/context` die Aufschlüsselung pro Element ein. Führen Sie daher `/context all` aus, um sie zu erweitern.

16 18 

17Für Details zu einer bestimmten Kategorie folgen Sie mit dem dedizierten Befehl:19Für Details zu einer bestimmten Kategorie folgen Sie mit dem dedizierten Befehl:

18 20 

desktop.md +71 −14

Details

84 84 

85Berechtigungsmodi steuern, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, vor dem Ausführen von Befehlen oder vor beidem nachfragt. Sie können den Berechtigungsmodus jederzeit über die Modusauswahl in der Zeile unter dem Eingabefeld wechseln. Wenn Sie jede Änderung selbst genehmigen möchten, wechseln Sie zu Manual.85Berechtigungsmodi steuern, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, vor dem Ausführen von Befehlen oder vor beidem nachfragt. Sie können den Berechtigungsmodus jederzeit über die Modusauswahl in der Zeile unter dem Eingabefeld wechseln. Wenn Sie jede Änderung selbst genehmigen möchten, wechseln Sie zu Manual.

86 86 

87Um einen Standardmodus für neue lokale Sitzungen festzulegen, fügen Sie `permissions.defaultMode` zu Ihrer [Einstellungsdatei](https://code.claude.com/docs/de/settings.md#where-settings-live) hinzu. Die Desktop-App liest dieselben Einstellungsdateien wie die CLI. Ein Modus, den Sie in der Auswahl wählen, wird pro Ordner gespeichert und hat für diesen Ordner Vorrang vor `defaultMode`, mit Ausnahme von Plan, das nur für die aktuelle Sitzung gilt.87Um einen Standard-Berechtigungsmodus für neue lokale Sitzungen festzulegen, fügen Sie `permissions.defaultMode` zu Ihrer [Einstellungsdatei](https://code.claude.com/docs/de/settings.md#where-settings-live) hinzu. Ein Modus, den Sie in einer lokalen Sitzung wählen, wird pro Ordner gespeichert und hat Vorrang vor einem `defaultMode` in den `.claude/`-Einstellungen des Projekts. Eine neue lokale Sitzung kann dennoch in einem `defaultMode` aus `~/.claude/settings.json` oder aus verwalteten Einstellungen starten; prüfen Sie daher die Auswahl vor Ihrer ersten Nachricht. Wenn Sie Plan wählen, gilt dies nur für diese Sitzung.

88 88 

89| Modus | Einstellungsschlüssel | Verhalten |89| Modus | Einstellungsschlüssel | Verhalten |

90| - | - | - |90| - | - | - |


1289 1289 

1290> [!WARNING]1290> [!WARNING]

1291>1291>

1292> Wenn Sie sich mit einem Claude-Konto bei Desktop anmelden, verlassen Sie sich nicht darauf, dass eine Aufgabe über Nacht läuft. Desktop erneuert diese Anmeldung für die Aufgabe nur, solange Desktop läuft und verbunden ist. Daher kann die Anmeldung der Aufgabe ablaufen, nachdem Sie die Verbindung getrennt haben, und die Aufgabe stoppt dann. Wie viel Zeit beim Trennen noch verbleibt, variiert, und es können nur wenige Minuten sein.1292> Wenn Sie sich mit einem Claude-Konto bei Desktop anmelden, verlassen Sie sich nicht darauf, dass eine Aufgabe über Nacht läuft. Desktop erneuert diese Anmeldung für die Aufgabe nur, solange Desktop läuft, verbunden und angemeldet ist. Die Anmeldung der Aufgabe kann daher nach dem Trennen ablaufen, und die Aufgabe hält dann an. Wie viel Zeit beim Trennen noch bleibt, variiert und kann nur wenige Minuten betragen.

1293>1293>

1294> Die bisher erledigte Arbeit bleibt auf dem Remote-Computer, und Sie können nach Ihrer Rückkehr mit einer Nachricht fortfahren.1294> Die bisher erledigte Arbeit bleibt auf dem Remote-Computer, und Sie können nach Ihrer Rückkehr mit einer Nachricht fortfahren.

1295>1295>

1296> Wenn die Aufgabe die Nacht hindurch laufen muss:1296> Wenn die Aufgabe die Nacht hindurch laufen muss:

1297>1297>

1298> * [Halten Sie Ihren Computer wach](https://code.claude.com/docs/de/desktop-scheduled-tasks.md#how-scheduled-tasks-run) und online, mit geöffnetem Deckel und laufendem Desktop1298> * [Halten Sie Ihren Computer wach](https://code.claude.com/docs/de/desktop-scheduled-tasks.md#how-scheduled-tasks-run) und online, mit geöffnetem Deckel und laufendem, angemeldetem Desktop

1299> * Verwenden Sie für den Remote-Computer und für jeden Jump-Host auf dem Weg eine Anmeldung, die ohne Abfrage funktioniert, z. B. einen Schlüssel, den Ihr SSH-Agent hält. Desktop kann sich dann nach einem Verbindungsabbruch selbstständig wieder verbinden.1299> * Verwenden Sie für den Remote-Computer und für jeden Jump-Host auf dem Weg eine Anmeldung, die ohne Abfrage funktioniert, z. B. einen Schlüssel, den Ihr SSH-Agent hält. Desktop kann sich dann nach einem Verbindungsabbruch selbstständig wieder verbinden.

1300>1300>

1301> Für eine Aufgabe, die laufen muss, während Ihr Computer im Ruhezustand oder ausgeschaltet ist, starten Sie stattdessen eine [Cloud-Sitzung](#run-long-running-tasks-in-the-cloud).1301> Für eine Aufgabe, die laufen muss, während Ihr Computer im Ruhezustand oder ausgeschaltet ist, starten Sie stattdessen eine [Cloud-Sitzung](#run-long-running-tasks-in-the-cloud).


1303* **Nach Ruhezustand oder Netzwerkverlust**: Sie erhalten die laufende Aufgabe zurück, wenn der Prozess [noch läuft](#limits-while-desktop-is-disconnected) und Desktop sich ohne Abfrage anmelden kann. Wenn nicht, [senden Sie eine Nachricht](#reconnect-after-sleep-or-a-network-loss).1303* **Nach Ruhezustand oder Netzwerkverlust**: Sie erhalten die laufende Aufgabe zurück, wenn der Prozess [noch läuft](#limits-while-desktop-is-disconnected) und Desktop sich ohne Abfrage anmelden kann. Wenn nicht, [senden Sie eine Nachricht](#reconnect-after-sleep-or-a-network-loss).

1304* **Nach dem Beenden**: Die Aufgabe läuft weiter, aber Sie verlieren sie, wenn die Sitzung erneut geöffnet wird, es sei denn, Desktop kann sich wieder mit ihrem Prozess verbinden. Prüfen Sie vor dem Beenden, [wann Desktop sich wieder verbinden kann](#reopen-a-session-after-you-quit-desktop). Wenn Sie die Aufgabe verloren haben, senden Sie eine Nachricht, um fortzufahren.1304* **Nach dem Beenden**: Die Aufgabe läuft weiter, aber Sie verlieren sie, wenn die Sitzung erneut geöffnet wird, es sei denn, Desktop kann sich wieder mit ihrem Prozess verbinden. Prüfen Sie vor dem Beenden, [wann Desktop sich wieder verbinden kann](#reopen-a-session-after-you-quit-desktop). Wenn Sie die Aufgabe verloren haben, senden Sie eine Nachricht, um fortzufahren.

1305 1305 

1306Wenn Sie zurückkommen und die Aufgabe nicht erledigt ist, prüfen Sie, ob gemeldet wird, dass Desktop sich nicht wieder verbinden kann, ob ein Authentifizierungsfehler vorliegt oder ob eine Anfrage wartet:1306Wenn Sie zurückkommen und die Aufgabe nicht fertig ist, achten Sie auf die Anmeldeseite von Desktop, einen Hinweis, dass Desktop sich nicht erneut verbinden kann, einen Authentifizierungsfehler oder eine wartende Anfrage:

1307 1307 

1308* **Anmeldeseite**: Melden Sie sich an. Wenn die Aufgabe angehalten hat, senden Sie eine Nachricht, um fortzufahren. In einem Enterprise-Tarif kann Ihre Organisation [Sie nach einer festgelegten Anzahl von Tagen nach der Anmeldung abmelden](https://support.claude.com/en/articles/13163631-configuring-session-security-settings), unabhängig davon, wie aktiv Sie sind. Mit einem Claude-Konto erneuert Desktop die Anmeldung der Aufgabe nicht, solange Sie abgemeldet sind, sodass die Aufgabe anhalten kann.

1308* **Desktop kann sich nicht wieder verbinden**: Die Sitzung nennt den Grund, und möglicherweise auch eine Benachrichtigung. Eventuell [müssen Sie sich anmelden](#reconnect-after-sleep-or-a-network-loss).1309* **Desktop kann sich nicht wieder verbinden**: Die Sitzung nennt den Grund, und möglicherweise auch eine Benachrichtigung. Eventuell [müssen Sie sich anmelden](#reconnect-after-sleep-or-a-network-loss).

1309* **Authentifizierungsfehler**: Das [Anmelde-Token oder die Anmeldedaten](#limits-while-desktop-is-disconnected) sind möglicherweise abgelaufen. Mit einem Claude-Konto senden Sie eine Nachricht, um fortzufahren. Mit einem Drittanbieter siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1310* **Authentifizierungsfehler**: Das [Anmelde-Token oder die Anmeldedaten](#limits-while-desktop-is-disconnected) sind möglicherweise abgelaufen. Mit einem Claude-Konto senden Sie eine Nachricht, um fortzufahren. Mit einem Drittanbieter siehe [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).

1310* **Wartende Anfrage**: [Beantworten Sie sie](#handle-requests-that-arrive-while-you-are-away)1311* **Wartende Anfrage**: [Beantworten Sie sie](#handle-requests-that-arrive-while-you-are-away)


1602 1603 

1603> [!NOTE]1604> [!NOTE]

1604>1605>

1605> Verbindungen über einen Befehl erfordern Claude Desktop v3.6556.0 oder höher unter macOS oder Linux, angemeldet mit einem Claude-Konto. Administratoren können [Befehle an ein Team verteilen](#distribute-commands-to-your-team).1606> Verbindungen über einen Befehl erfordern Claude Desktop v3.6556.0 oder neuer unter macOS oder Linux bzw. v4.16336.0 oder neuer unter Windows, angemeldet mit einem Claude-Konto. Unter Windows muss Desktop außerdem [über den OpenSSH-Client verbinden](#use-your-ssh-configuration). Administratoren können [Befehle an ein Team verteilen](#distribute-commands-to-your-team).

1606 1607 

1607Desktop führt den Befehl nur aus, wenn Sie die Verbindung erstellen oder [einen weiteren Rechner erstellen](#create-another-machine), nicht bei jeder Verbindung. Jeder Eintrag ist eine Verbindung, die auf den Host zeigt, den Desktop zuletzt aus dem Befehl des Eintrags gespeichert hat.1608Desktop führt den Befehl nur aus, wenn Sie die Verbindung erstellen oder [einen weiteren Rechner erstellen](#create-another-machine), nicht bei jeder Verbindung. Jeder Eintrag ist eine Verbindung, die auf den Host zeigt, den Desktop zuletzt aus dem Befehl des Eintrags gespeichert hat.

1608 1609 


1632}1633}

1633```1634```

1634 1635 

1636Unter Windows funktioniert ein bloßer Name wie `acme-dev` nicht, [beginnen Sie den Befehl also mit dem vollständigen Pfad des Programms](#write-the-command-on-windows).

1637 

1635Jeder Eintrag akzeptiert diese Felder, wobei `id`, `name` und `command` erforderlich sind:1638Jeder Eintrag akzeptiert diese Felder, wobei `id`, `name` und `command` erforderlich sind:

1636 1639 

1637| Feld | Wert |1640| Feld | Wert |


1646 1649 

1647##### Den Befehl schreiben1650##### Den Befehl schreiben

1648 1651 

1649Desktop startet das Programm direkt, ohne Shell und ohne Terminal:1652Beginnen Sie unter Windows mit [Befehl unter Windows schreiben](#write-the-command-on-windows). Dort steht, welche dieser Regeln dort gelten.

1653 

1654Unter macOS und Linux startet Desktop das Programm direkt, ohne Shell und ohne Terminal:

1650 1655 

1651* **Programm**: Schreiben Sie seinen Namen oder seinen vollständigen Pfad ab `/`, ohne Leerzeichen. Desktop sucht einen reinen Namen im `PATH`, den Ihre Login-Shell exportiert. Relative Pfade wie `./acme-dev`, Pfade, die mit `~` beginnen, sowie Shell-Aliase und -Funktionen funktionieren nicht.1656* **Programm**: Schreiben Sie seinen Namen oder seinen vollständigen Pfad ab `/`. Desktop sucht einen bloßen Namen im `PATH`, den Ihre Login-Shell exportiert. Relative Pfade wie `./acme-dev`, Pfade, die mit `~` beginnen, sowie Shell-Aliase und -Funktionen funktionieren nicht.

1652* **Argumente**: Trennen Sie einfache Argumente durch Leerzeichen. Der Befehl darf nur Leerzeichen, ASCII-Buchstaben, Ziffern und die Zeichen `+,-./:=@_~` enthalten, und kein Wort darf mit `~` beginnen.1657* **Leerzeichen im Pfad**: Setzen Sie den vollständigen Pfad des Programms in einfache Anführungszeichen, z. B. `'/Users/you/My Tools/make-devbox' create`. Anführungszeichen, einfache oder doppelte, erfordern Claude Desktop v4.16336.0 oder neuer und funktionieren nur um den Pfad des Programms.

1653* **Skripte**: Wenn der Befehl etwas anderes benötigt, etwa Anführungszeichen, Pipes, Variablen oder eine URL mit `?` oder `&`, legen Sie ihn in ein Skript. Machen Sie das Skript ausführbar, beginnen Sie es mit einer `#!`-Zeile und setzen Sie `command` auf seinen vollständigen Pfad, etwa `/Users/you/bin/make-devbox`. Legen Sie das Skript unter macOS nicht in die Ordner Dokumente, Schreibtisch und Downloads, wo macOS es blockieren kann.1658* **Argumente**: Trennen Sie Argumente durch Leerzeichen. Außerhalb von Anführungszeichen darf der Befehl nur Leerzeichen, ASCII-Buchstaben, Ziffern und die Zeichen `+,-./:=@_~` enthalten, und kein Wort darf mit `~` beginnen. Ein Pfad in Anführungszeichen darf auch einige andere Zeichen enthalten, etwa `(`, `)` und `&`.

1659* **Skripte**: Wenn der Befehl etwas anderes benötigt, etwa Argumente in Anführungszeichen, Pipes, Variablen oder eine URL mit `?` oder `&`, legen Sie ihn in ein Skript. Machen Sie das Skript ausführbar, beginnen Sie es mit einer `#!`-Zeile und setzen Sie `command` auf seinen vollständigen Pfad, z. B. `/Users/you/bin/make-devbox`. Halten Sie das Skript unter macOS aus den Ordnern Dokumente, Schreibtisch und Downloads heraus, wo macOS es blockieren kann.

1654* **Eingabe**: Das Programm erhält keine Eingabe und kein Terminal, es kann Sie dort also nicht zu einer Eingabe auffordern. Wenn Ihr Tool Sie über einen Browser oder eine Abfrage anmeldet, melden Sie sich zuerst in einem Terminal an, und erneut, sobald diese Anmeldung abläuft.1660* **Eingabe**: Das Programm erhält keine Eingabe und kein Terminal, es kann Sie dort also nicht zu einer Eingabe auffordern. Wenn Ihr Tool Sie über einen Browser oder eine Abfrage anmeldet, melden Sie sich zuerst in einem Terminal an, und erneut, sobald diese Anmeldung abläuft.

1655* **Umgebung**: Das Programm läuft in Ihrem Home-Verzeichnis mit den Variablen, die Ihre Login-Shell exportiert. Desktop liest sie beim Start, wie bei [einem `ProxyCommand`](#use-variables-from-your-shell-in-a-proxycommand). Beenden Sie Desktop also und öffnen Sie es erneut, nachdem Sie sie geändert haben.1661* **Umgebung**: Das Programm läuft in Ihrem Home-Verzeichnis mit den Variablen, die Ihre Login-Shell exportiert. Desktop liest sie beim Start, wie bei [einem `ProxyCommand`](#use-variables-from-your-shell-in-a-proxycommand). Beenden Sie Desktop also und öffnen Sie es erneut, nachdem Sie sie geändert haben.

1656* **Zeitlimit**: Desktop stoppt ein Programm, das nach 10 Minuten noch läuft. Die Fortschrittsmeldung von Desktop zeigt die Ausgabe des Programms nicht an. Um das Programm früher zu stoppen, wählen Sie **Cancel** neben dieser Meldung.1662* **Zeitlimit**: Desktop stoppt ein Programm, das nach 10 Minuten noch läuft. Die Fortschrittsmeldung von Desktop zeigt die Ausgabe des Programms nicht an. Um das Programm früher zu stoppen, wählen Sie **Cancel** neben dieser Meldung.


1680 1686 

1681Wenn der Befehl fehlschlägt, zeigt **View details** in der Meldung von Desktop die letzte Zeile, die der Befehl auf die Standardfehlerausgabe geschrieben hat, falls vorhanden.1687Wenn der Befehl fehlschlägt, zeigt **View details** in der Meldung von Desktop die letzte Zeile, die der Befehl auf die Standardfehlerausgabe geschrieben hat, falls vorhanden.

1682 1688 

1689##### Befehl unter Windows schreiben

1690 

1691Beginnen Sie `command` unter Windows mit dem vollständigen Pfad einer `.exe`-, `.cmd`- oder `.bat`-Datei, ab dem Laufwerksbuchstaben. Desktop sucht einen bloßen Namen nicht in Ihrem `PATH`, daher ist ein Eintrag, dessen `command` `acme-dev create` lautet, [grau](#if-a-command-is-missing-or-gray).

1692 

1693Der folgende Eintrag in `%USERPROFILE%\.claude\settings.json` führt `C:\Program Files\Acme\acme-dev.exe` mit dem Argument `create` aus. Schreiben Sie in JSON jeden Backslash doppelt oder schreiben Sie stattdessen `/`. Die einfachen Anführungszeichen stehen dort, weil der Pfad ein Leerzeichen enthält:

1694 

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

1696{

1697 "sshHostCommands": [

1698 {

1699 "id": "devbox",

1700 "name": "Dev box",

1701 "command": "'C:\\Program Files\\Acme\\acme-dev.exe' create"

1702 }

1703 ]

1704}

1705```

1706 

1707Befolgen Sie die Regeln unter [Befehl schreiben](#write-the-command) zu Leerzeichen im Pfad, Eingabe, Zeitlimit und dem, was das Programm ausgibt. Befolgen Sie anstelle der übrigen Regeln diese:

1708 

1709* **Programm**: Verwenden Sie keinen Netzwerkpfad wie `\\server\share`, keine Variable wie `%USERPROFILE%` und keinen Buchstaben außerhalb von ASCII. Mit einem davon im Pfad ist der Eintrag grau. Wenn der Name Ihres Benutzerordners einen solchen Buchstaben enthält, legen Sie das Programm außerhalb dieses Ordners ab.

1710* **Argumente**: Befolgen Sie die Regel zu Argumenten unter Befehl schreiben. Der Befehl darf auch `\` enthalten, aber kein Wort darf damit enden.

1711* **Skripte**: Verwenden Sie eine `.cmd`- oder `.bat`-Datei, die Desktop über `cmd.exe` ausführt. Auch in Anführungszeichen darf der Pfad der Datei kein `&`, `^` oder `;` enthalten. Lesen Sie in einer Datei, die Sie schreiben, die Argumente mit `%*`, da `%1` bis `%9` ein Argument bei `,` und `=` aufteilen.

1712* **Umgebung**: Das Programm erhält die Umgebungsvariablen der Desktop-App, nicht die eines Shell-Profils. Beenden Sie Desktop nach dem Ändern einer Variablen und öffnen Sie es erneut.

1713* **Test**: Um die Ausgabe zu sehen, die Desktop liest, führen Sie den Befehl in der Eingabeaufforderung aus. Setzen Sie einen Pfad mit Leerzeichen in doppelte Anführungszeichen und verwenden Sie `NUL` für keine Eingabe, wie in `"C:\Program Files\Acme\acme-dev.exe" create < NUL > host.txt`. Die Datei darf nur den Host enthalten. Der Test erstellt ebenfalls einen Rechner, löschen Sie ihn also anschließend mit Ihrem Tool.

1714 

1715##### Ein Windows-Tool umschließen, das andere Zeilen ausgibt

1716 

1717Wenn Ihr Tool vor dem Host andere Zeilen ausgibt, etwa Fortschrittsmeldungen, umschließen Sie es mit einer Batchdatei, die nur den Host ausgibt. Die folgende Datei gibt die letzte Zeile der Ausgabe Ihres Tools aus und beendet mit dem Code Ihres Tools, wenn es fehlschlägt:

1718 

1719```batch make-devbox.cmd theme={null}

1720@echo off

1721setlocal

1722set "host="

1723set "out=%TEMP%\acme-dev-%RANDOM%.txt"

1724call "C:\Program Files\Acme\acme-dev.exe" create > "%out%"

1725set "code=%ERRORLEVEL%"

1726for /f "usebackq delims=" %%L in ("%out%") do set "host=%%L"

1727del "%out%"

1728if not "%code%"=="0" exit /b %code%

1729setlocal EnableDelayedExpansion

1730echo(!host!

1731```

1732 

1733Setzen Sie `command` auf den vollständigen Pfad der Datei, in JSON z. B. `C:\\tools\\make-devbox.cmd`. Lassen Sie ihre letzten beiden Zeilen unverändert, da sie den Host ausgeben, ohne ihn als Befehl auszuführen.

1734 

1683##### Eine Verbindung zu einem neuen Host herstellen1735##### Eine Verbindung zu einem neuen Host herstellen

1684 1736 

1685Beantworten Sie zwei Fragen, wenn Sie zum ersten Mal eine Verbindung zu einem neuen Host herstellen:1737Beantworten Sie zwei Fragen, wenn Sie zum ersten Mal eine Verbindung zu einem neuen Host herstellen:

1686 1738 

1687* **Host-Schlüssel**: Prüfen Sie bei der standardmäßigen Host-Schlüsselprüfung von OpenSSH den Fingerabdruck des Schlüssels und wählen Sie dann, ob eine Verbindung hergestellt werden soll. Um die Frage zu überspringen, lassen Sie Ihren Befehl den Schlüssel zu `~/.ssh/known_hosts` hinzufügen, bevor er den Host ausgibt, und zwar mit einem Schlüssel, den Ihr Tool beim Erstellen des Rechners erfahren hat. Für einen anderen Port als 22 beginnt diese Zeile mit `[host]:port`. Wenn Ihr Tool Hostnamen wiederverwendet, entfernen Sie auch die Zeile des alten Schlüssels.1739* **Host-Schlüssel**: Prüfen Sie bei der standardmäßigen Host-Schlüssel-Prüfung von OpenSSH den Fingerabdruck des Schlüssels und wählen Sie dann, ob verbunden werden soll. Um die Frage zu überspringen, lassen Sie Ihren Befehl den Schlüssel zu `~/.ssh/known_hosts` hinzufügen, unter Windows zu `%USERPROFILE%\.ssh\known_hosts`, bevor er den Host ausgibt:

1740 * Verwenden Sie einen Schlüssel, den Ihr Tool beim Erstellen des Rechners erhalten hat

1741 * Beginnen Sie die Zeile bei einem anderen Port als 22 mit `[host]:port`

1742 * Wenn Ihr Tool Hostnamen wiederverwendet, entfernen Sie auch die Zeile des alten Schlüssels

1688* **Ordner**: Wählen Sie, ob Sie dem Ordner vertrauen, den Sie dort öffnen1743* **Ordner**: Wählen Sie, ob Sie dem Ordner vertrauen, den Sie dort öffnen

1689 1744 

1690Lassen Sie die Host-Schlüsselprüfung für diese Hosts eingeschaltet und führen Sie für sie eine `known_hosts`-Datei. Wenn `StrictHostKeyChecking` auf `no` oder `accept-new` steht und `UserKnownHostsFile` zusätzlich `/dev/null` oder `none` ist, zeichnet nichts den Schlüssel auf. Wenn Ihr Tool dann einen Namen wiederverwendet, können Sie ohne Warnung eine Verbindung zu einem anderen Rechner herstellen.1745Lassen Sie die Host-Schlüsselprüfung für diese Hosts eingeschaltet und führen Sie für sie eine `known_hosts`-Datei. Wenn `StrictHostKeyChecking` auf `no` oder `accept-new` steht und `UserKnownHostsFile` zusätzlich `/dev/null` oder `none` ist, zeichnet nichts den Schlüssel auf. Wenn Ihr Tool dann einen Namen wiederverwendet, können Sie ohne Warnung eine Verbindung zu einem anderen Rechner herstellen.


1746 1801 

1747* **Wo der Schlüssel hingehört**: Wenn Ihre MDM-Richtlinie für Claude Code bereits einen [Richtlinienschlüssel](https://code.claude.com/docs/de/managed-settings.md#how-claude-code-combines-managed-sources) setzt, legen Sie ihn dort ab. Andernfalls legen Sie ihn in der Datei für verwaltete Einstellungen ab. Standardmäßig hat eine solche Richtlinie Vorrang vor der Datei, und Desktop ignoriert dann Einträge in der Datei. Setzen Sie ihn auf dem Computer, auch wenn [serververwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) gelten: Desktop ignoriert den Schlüssel dort sowie in Projekt- und lokalen Einstellungen.1802* **Wo der Schlüssel hingehört**: Wenn Ihre MDM-Richtlinie für Claude Code bereits einen [Richtlinienschlüssel](https://code.claude.com/docs/de/managed-settings.md#how-claude-code-combines-managed-sources) setzt, legen Sie ihn dort ab. Andernfalls legen Sie ihn in der Datei für verwaltete Einstellungen ab. Standardmäßig hat eine solche Richtlinie Vorrang vor der Datei, und Desktop ignoriert dann Einträge in der Datei. Setzen Sie ihn auf dem Computer, auch wenn [serververwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) gelten: Desktop ignoriert den Schlüssel dort sowie in Projekt- und lokalen Einstellungen.

1748* **Die `id`**: Wenn der `sshHostCommands`-Eintrag eines Benutzers Ihre `id` hat, funktioniert nur Ihrer. Wenn eine andere SSH-Verbindung sie hat, etwa eine in den `sshConfigs` eines Benutzers, ist Ihr Eintrag ausgegraut. Wählen Sie eine `id`, die Benutzer wahrscheinlich nicht wählen.1803* **Die `id`**: Wenn der `sshHostCommands`-Eintrag eines Benutzers Ihre `id` hat, funktioniert nur Ihrer. Wenn eine andere SSH-Verbindung sie hat, etwa eine in den `sshConfigs` eines Benutzers, ist Ihr Eintrag ausgegraut. Wählen Sie eine `id`, die Benutzer wahrscheinlich nicht wählen.

1749* **Das Programm**: Geben Sie seinen vollständigen Pfad an, da Desktop einen reinen Namen im eigenen `PATH` jedes Benutzers sucht. Das Programm läuft als der Benutzer, mit den Variablen, die dessen Login-Shell exportiert.1804* **Das Programm**: Geben Sie seinen vollständigen Pfad an, da Desktop unter macOS und Linux einen bloßen Namen im `PATH` jedes Benutzers nachschlägt und unter Windows ein Eintrag mit einem bloßen Namen grau ist. Das Programm läuft als der Benutzer, mit [den Variablen dieses Benutzers](#write-the-command).

1805* **Jede Plattform**: Stellen Sie einen Eintrag für Windows-Computer und einen anderen für macOS- und Linux-Computer bereit. Ein Eintrag mit einem [Windows-Pfad](#write-the-command-on-windows) ist unter macOS und Linux grau, und einer mit einem macOS- oder Linux-Pfad ist unter Windows grau.

1750* **Eigene Einträge der Benutzer**: Desktop behandelt den Eintrag eines Benutzers wie einen [Hook](https://code.claude.com/docs/de/hooks.md), da beide ein Programm auf dem Computer ausführen. Um nur Ihre Einträge zuzulassen, setzen Sie [`strictPluginOnlyCustomization`](https://code.claude.com/docs/de/settings-reference#strictpluginonlycustomization) auf `["hooks"]` oder fügen Sie `"hooks"` zu dessen Liste hinzu. Damit stoppen Sie auch Claude-Code-Hooks aus Benutzer-, Projekt- und lokalen Einstellungen, ohne Möglichkeit, sie beizubehalten. Wenn Sie stattdessen diesen Schlüssel oder [`allowManagedHooksOnly`](https://code.claude.com/docs/de/settings-reference#allowmanagedhooksonly) auf `true` setzen, blockieren Sie mehr, wie der Eintrag jedes Schlüssels auflistet.1806* **Eigene Einträge der Benutzer**: Desktop behandelt den Eintrag eines Benutzers wie einen [Hook](https://code.claude.com/docs/de/hooks.md), da beide ein Programm auf dem Computer ausführen. Um nur Ihre Einträge zuzulassen, setzen Sie [`strictPluginOnlyCustomization`](https://code.claude.com/docs/de/settings-reference#strictpluginonlycustomization) auf `["hooks"]` oder fügen Sie `"hooks"` zu dessen Liste hinzu. Damit stoppen Sie auch Claude-Code-Hooks aus Benutzer-, Projekt- und lokalen Einstellungen, ohne Möglichkeit, sie beizubehalten. Wenn Sie stattdessen diesen Schlüssel oder [`allowManagedHooksOnly`](https://code.claude.com/docs/de/settings-reference#allowmanagedhooksonly) auf `true` setzen, blockieren Sie mehr, wie der Eintrag jedes Schlüssels auflistet.

1751* **Jeder Eintrag**: Um auch Ihre Einträge auszuschalten, setzen Sie [`disableAllHooks`](https://code.claude.com/docs/de/settings-reference#disableallhooks) in den verwalteten Einstellungen. Wenn Sie [`disableDesktopLocalSessions`](https://code.claude.com/docs/de/settings-reference#disabledesktoplocalsessions) oder eine `sshHostAllowlist` setzen, die keinen Host zulässt, listet die Auswahl keine **Create**- oder **Create another**-Einträge.1807* **Jeder Eintrag**: Um auch Ihre Einträge auszuschalten, setzen Sie [`disableAllHooks`](https://code.claude.com/docs/de/settings-reference#disableallhooks) in den verwalteten Einstellungen. Wenn Sie [`disableDesktopLocalSessions`](https://code.claude.com/docs/de/settings-reference#disabledesktoplocalsessions) oder eine `sshHostAllowlist` setzen, die keinen Host zulässt, listet die Auswahl keine **Create**- oder **Create another**-Einträge.

1752* **Wo die Sperren gelten**: Für diese Einträge liest Desktop `allowManagedHooksOnly`, `strictPluginOnlyCustomization` und `disableAllHooks` aus den serververwalteten Einstellungen sowie aus der eigenen Datei oder Richtlinie des Computers und wendet das strengere Ergebnis an. Jeder Eintrag bleibt ausgegraut, bis Desktop claude.ai auf serververwaltete Einstellungen geprüft hat, selbst wenn Ihre Organisation keine hat.1808* **Wo die Sperren gelten**: Für diese Einträge liest Desktop `allowManagedHooksOnly`, `strictPluginOnlyCustomization` und `disableAllHooks` aus den serververwalteten Einstellungen sowie aus der eigenen Datei oder Richtlinie des Computers und wendet das strengere Ergebnis an. Jeder Eintrag bleibt ausgegraut, bis Desktop claude.ai auf serververwaltete Einstellungen geprüft hat, selbst wenn Ihre Organisation keine hat.


1759Die Umgebungsauswahl listet in diesen Fällen keinen **Create**- oder **Create another**-Eintrag:1815Die Umgebungsauswahl listet in diesen Fällen keinen **Create**- oder **Create another**-Eintrag:

1760 1816 

1761* **Die Datei**: `~/.claude/settings.json` enthält [ungültiges JSON oder einen Wert, den das Schema ablehnt](https://code.claude.com/docs/de/settings.md#fix-a-broken-settings-file), Sie haben den Schlüssel falsch geschrieben, oder Sie haben ihn in die Einstellungen eines Projekts eingetragen. Korrigieren Sie die Datei.1817* **Die Datei**: `~/.claude/settings.json` enthält [ungültiges JSON oder einen Wert, den das Schema ablehnt](https://code.claude.com/docs/de/settings.md#fix-a-broken-settings-file), Sie haben den Schlüssel falsch geschrieben, oder Sie haben ihn in die Einstellungen eines Projekts eingetragen. Korrigieren Sie die Datei.

1762* **Plattform und Konto**: Sie verwenden Windows oder einen [Drittanbieter](https://code.claude.com/docs/de/third-party-integrations.md) statt eines Claude-Kontos. Fügen Sie jeden Host selbst als [SSH-Verbindung](#ssh-sessions) hinzu.1818* **Konto**: Sie verwenden einen [Drittanbieter](https://code.claude.com/docs/de/third-party-integrations.md) statt eines Claude-Kontos. Fügen Sie jeden Host selbst als [SSH-Verbindung](#ssh-sessions) hinzu.

1819* **Windows**: Desktop ist älter als v4.16336.0 oder verbindet sich nicht über den OpenSSH-Client. Aktualisieren Sie Desktop und erfüllen Sie [die Anforderungen für den OpenSSH-Client](#use-your-ssh-configuration), beenden Sie dann Desktop und öffnen Sie es erneut.

1763* **Die Einstellungen Ihrer Organisation**: Ihr Administrator hat lokale Sitzungen oder SSH-Sitzungen ausgeschaltet. Fragen Sie ihn, ob Sie Befehle verwenden können.1820* **Die Einstellungen Ihrer Organisation**: Ihr Administrator hat lokale Sitzungen oder SSH-Sitzungen ausgeschaltet. Fragen Sie ihn, ob Sie Befehle verwenden können.

1764* **Kein `ssh`-Programm**: Desktop konnte den OpenSSH-Client auf Ihrem Computer nicht starten. Installieren Sie ihn oder bitten Sie Ihren Administrator, ihn zuzulassen, und starten Sie Desktop dann neu.1821* **Kein `ssh`-Programm**: Desktop konnte den OpenSSH-Client auf Ihrem Computer nicht starten. Installieren Sie ihn oder bitten Sie Ihren Administrator, ihn zuzulassen, und starten Sie Desktop dann neu.

1765 1822 

1766Ein Eintrag, den Sie nicht auswählen können, ist ausgegraut. Fahren Sie mit der Maus darüber, um den Grund zu sehen:1823Ein Eintrag, den Sie nicht auswählen können, ist ausgegraut. Fahren Sie mit der Maus darüber, um den Grund zu sehen:

1767 1824 

1768* **Ein Fehler im Eintrag**: Korrigieren Sie das Feld oder den Befehl, den die Meldung nennt. Wenn die `id` bereits verwendet wird, geben Sie dem Eintrag eine andere.1825* **Ein Fehler im Eintrag**: Korrigieren Sie das Feld oder den Befehl, den die Meldung nennt. Wenn die `id` bereits verwendet wird, geben Sie dem Eintrag eine andere. Unter Windows muss der Befehl [mit dem vollständigen Pfad des Programms beginnen](#write-the-command-on-windows).

1769* **Eine fehlerhafte Einstellungsdatei**: Solange Ihre eigene Einstellungsdatei fehlerhaft ist, können die Einträge Ihres Administrators ausgegraut sein, mit einer Meldung, die die Datei nennt. [Korrigieren Sie die Datei](https://code.claude.com/docs/de/settings.md#fix-a-broken-settings-file).1826* **Eine fehlerhafte Einstellungsdatei**: Solange Ihre eigene Einstellungsdatei fehlerhaft ist, können die Einträge Ihres Administrators ausgegraut sein, mit einer Meldung, die die Datei nennt. [Korrigieren Sie die Datei](https://code.claude.com/docs/de/settings.md#fix-a-broken-settings-file).

1770* **Ein neuer Host**: [**Create another**](#create-another-machine) ist eine Minute lang ausgegraut, nachdem Desktop einen Host gespeichert hat. Wählen Sie es nach dieser Minute aus. Vor Claude Desktop v4.4212.0 ist **Replace Dev box's host** 10 Minuten lang ausgegraut.1827* **Ein neuer Host**: [**Create another**](#create-another-machine) ist eine Minute lang ausgegraut, nachdem Desktop einen Host gespeichert hat. Wählen Sie es nach dieser Minute aus. Vor Claude Desktop v4.4212.0 ist **Replace Dev box's host** 10 Minuten lang ausgegraut.

1771* **Hooks sind ausgeschaltet oder eingeschränkt**: Ihre eigenen Einträge funktionieren nur dort, wo Ihre eigenen Hooks ausgeführt werden können. Entfernen Sie `disableAllHooks` aus Ihren Einstellungen oder fragen Sie Ihren Administrator.1828* **Hooks sind ausgeschaltet oder eingeschränkt**: Ihre eigenen Einträge funktionieren nur dort, wo Ihre eigenen Hooks ausgeführt werden können. Entfernen Sie `disableAllHooks` aus Ihren Einstellungen oder fragen Sie Ihren Administrator.


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

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

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

1943| `sshHostCommands` | stellen Sie Benutzern zusätzlich zu ihren eigenen [SSH-Verbindungen bereit, deren Host aus einem Befehl stammt](#distribute-commands-to-your-team). Desktop liest diesen Schlüssel aus der verwalteten Einstellungsdatei oder der MDM-Richtlinie auf dem Computer und ignoriert ihn in [Server-verwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md). Erfordert Claude Desktop v3.6556.0 oder später unter macOS oder Linux, angemeldet mit einem Claude-Konto. |2000| `sshHostCommands` | stellen Sie Benutzern zusätzlich zu ihren eigenen [SSH-Verbindungen bereit, deren Host aus einem Befehl stammt](#distribute-commands-to-your-team). Desktop liest diesen Schlüssel aus der verwalteten Einstellungsdatei oder der MDM-Richtlinie auf dem Computer und ignoriert ihn in [Server-verwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md). Erfordert Claude Desktop v3.6556.0 oder später unter macOS oder Linux bzw. v4.16336.0 oder später unter Windows, angemeldet mit einem Claude-Konto. Unter Windows muss Desktop außerdem [die Verbindung über den OpenSSH-Client herstellen](#use-your-ssh-configuration). |

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

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

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

env-vars.md +3 −2

Details

139| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreibt die Amazon Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway). Siehe [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) |139| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreibt die Amazon Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing über ein [LLM-Gateway](https://code.claude.com/docs/de/llm-gateway). Siehe [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md) |

140| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreibt die Endpunkt-URL von Amazon Bedrock Mantle. Siehe [Mantle-Endpunkt](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint) |140| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreibt die Endpunkt-URL von Amazon Bedrock Mantle. Siehe [Mantle-Endpunkt](https://code.claude.com/docs/de/amazon-bedrock.md#use-the-mantle-endpoint) |

141| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Präfix des regionsübergreifenden Inferenzprofils (`us`, `eu`, `apac`, `jp`, `au` oder `global`), das Claude Code zuerst versucht, anstelle des aus der AWS-Region abgeleiteten Präfixes. Wird in AWS-GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder höher. Siehe [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md#cross-region-inference-profile-prefixes) |141| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Präfix des regionsübergreifenden Inferenzprofils (`us`, `eu`, `apac`, `jp`, `au` oder `global`), das Claude Code zuerst versucht, anstelle des aus der AWS-Region abgeleiteten Präfixes. Wird in AWS-GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder höher. Siehe [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md#cross-region-inference-profile-prefixes) |

142| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock-[Service-Tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` oder `priority`). Wird als `X-Amzn-Bedrock-Service-Tier`-Header gesendet. Siehe [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md#service-tiers) |142| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock-[Service-Tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` oder `priority`). Siehe [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md#service-tiers) |

143| `ANTHROPIC_BETAS` | Kommagetrennte Liste zusätzlicher `anthropic-beta`-Header-Werte, die in API-Anfragen aufgenommen werden. Claude Code sendet bereits die Beta-Header, die es benötigt; verwenden Sie dies, um sich für eine [Anthropic-API-Beta](https://platform.claude.com/docs/en/api/beta-headers) anzumelden, bevor Claude Code native Unterstützung hinzufügt. Anders als das [`--betas`-Flag](https://code.claude.com/docs/de/cli-reference#cli-flags), das eine Authentifizierung per API-Schlüssel erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden, einschließlich eines Claude.ai-Abonnements |143| `ANTHROPIC_BETAS` | Kommagetrennte Liste zusätzlicher `anthropic-beta`-Header-Werte, die in API-Anfragen aufgenommen werden. Claude Code sendet bereits die Beta-Header, die es benötigt; verwenden Sie dies, um sich für eine [Anthropic-API-Beta](https://platform.claude.com/docs/en/api/beta-headers) anzumelden, bevor Claude Code native Unterstützung hinzufügt. Anders als das [`--betas`-Flag](https://code.claude.com/docs/de/cli-reference#cli-flags), das eine Authentifizierung per API-Schlüssel erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden, einschließlich eines Claude.ai-Abonnements |

144| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die Anfragen hinzugefügt werden (Format `Name: Value`, bei mehreren Headern durch Zeilenumbrüche getrennt). Wenn ein Name oder Wert ein Zeichen enthält, das ein HTTP-Header nicht transportieren kann, etwa ein typografisches Anführungszeichen oder ein Leerzeichen mit Nullbreite, schlägt die Anfrage mit einem Fehler fehl, der das Paar anhand seiner Position identifiziert. Erfordert Claude Code v2.1.227 oder höher. [Invalid request header value](https://code.claude.com/docs/de/errors.md#invalid-request-header-value) listet den genauen Zeichensatz auf und gibt an, wo die Prüfung erfolgt. Ein Wert, der einen Header für Anmeldedaten, Organisation oder Tenant, Routing oder API-Verhalten setzt, etwa `Authorization` oder `Host`, gilt als [genehmigungspflichtige Einstellung](https://code.claude.com/docs/de/server-managed-settings.md#environment-variables-and-the-approval-dialog), wenn serververwaltete Einstellungen ihn bereitstellen. Aus Projekt- oder lokalen Einstellungen folgt ein solcher Wert den [Regeln dafür, wann `env`-Werte gelten](https://code.claude.com/docs/de/settings-reference#when-claude-code-applies-env-values) |144| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die Anfragen hinzugefügt werden (Format `Name: Value`, bei mehreren Headern durch Zeilenumbrüche getrennt). Wenn ein Name oder Wert ein Zeichen enthält, das ein HTTP-Header nicht transportieren kann, etwa ein typografisches Anführungszeichen oder ein Leerzeichen mit Nullbreite, schlägt die Anfrage mit einem Fehler fehl, der das Paar anhand seiner Position identifiziert. Erfordert Claude Code v2.1.227 oder höher. [Invalid request header value](https://code.claude.com/docs/de/errors.md#invalid-request-header-value) listet den genauen Zeichensatz auf und gibt an, wo die Prüfung erfolgt. Ein Wert, der einen Header für Anmeldedaten, Organisation oder Tenant, Routing oder API-Verhalten setzt, etwa `Authorization` oder `Host`, gilt als [genehmigungspflichtige Einstellung](https://code.claude.com/docs/de/server-managed-settings.md#environment-variables-and-the-approval-dialog), wenn serververwaltete Einstellungen ihn bereitstellen. Aus Projekt- oder lokalen Einstellungen folgt ein solcher Wert den [Regeln dafür, wann `env`-Werte gelten](https://code.claude.com/docs/de/settings-reference#when-claude-code-applies-env-values) |

145| `ANTHROPIC_CUSTOM_MODEL_OPTION` | Modell-ID, die als benutzerdefinierter Eintrag zur `/model`-Auswahl hinzugefügt wird. Verwenden Sie dies, um ein nicht standardmäßiges oder gatewayspezifisches Modell auswählbar zu machen, ohne integrierte Aliasse zu ersetzen. Siehe [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md#add-a-custom-model-option) |145| `ANTHROPIC_CUSTOM_MODEL_OPTION` | Modell-ID, die als benutzerdefinierter Eintrag zur `/model`-Auswahl hinzugefügt wird. Verwenden Sie dies, um ein nicht standardmäßiges oder gatewayspezifisches Modell auswählbar zu machen, ohne integrierte Aliasse zu ersetzen. Siehe [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md#add-a-custom-model-option) |


238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie `1`, um die Prüfung zu überspringen, ob eine [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md)-Streaming-Antwort den Content-Type `application/vnd.amazon.eventstream` trägt. Ohne diese Variable lässt Claude Code die Anfrage, wenn eine Antwort einen anderen Content-Type trägt, mit einem Fehler fehlschlagen, der diesen Typ nennt; das bedeutet, dass ein [Gateway oder Proxy die Antwort umwandelt](https://code.claude.com/docs/de/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy). Konfigurieren Sie das Gateway so, dass es den `Content-Type`-Header und den Body unverändert weiterleitet, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher |238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie `1`, um die Prüfung zu überspringen, ob eine [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md)-Streaming-Antwort den Content-Type `application/vnd.amazon.eventstream` trägt. Ohne diese Variable lässt Claude Code die Anfrage, wenn eine Antwort einen anderen Content-Type trägt, mit einem Fehler fehlschlagen, der diesen Typ nennt; das bedeutet, dass ein [Gateway oder Proxy die Antwort umwandelt](https://code.claude.com/docs/de/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy). Konfigurieren Sie das Gateway so, dass es den `Content-Type`-Header und den Body unverändert weiterleitet, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher |

239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Auf `1` setzen, um die laufende Arbeit einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) zu beenden, wenn der [Supervisor](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Diese Arbeit umfasst die laufenden Hintergrund-Shell-Befehle der Sitzung, ab v2.1.198 außerdem Hintergrund-Subagenten. Betrifft nur diese Übergabe: Wenn Sie eine Sitzung mit `←` oder [`/background`](https://code.claude.com/docs/de/agent-view#from-inside-a-session) in den Hintergrund schicken, wird laufende Hintergrundarbeit weiterhin übernommen. Erfordert Claude Code v2.1.196 oder höher |239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Auf `1` setzen, um die laufende Arbeit einer [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) zu beenden, wenn der [Supervisor](https://code.claude.com/docs/de/agent-view.md#the-supervisor-process) den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Diese Arbeit umfasst die laufenden Hintergrund-Shell-Befehle der Sitzung, ab v2.1.198 außerdem Hintergrund-Subagenten. Betrifft nur diese Übergabe: Wenn Sie eine Sitzung mit `←` oder [`/background`](https://code.claude.com/docs/de/agent-view#from-inside-a-session) in den Hintergrund schicken, wird laufende Hintergrundarbeit weiterhin übernommen. Erfordert Claude Code v2.1.196 oder höher |

240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie `1`, damit Claude Code [Hintergrund-Shell-Befehle](https://code.claude.com/docs/de/interactive-mode.md#background-bash-commands) bei Speicherdruck nicht mehr beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang inaktiv war, ohne dass ein Turn oder Subagent läuft. Windows hat kein Signal für Speicherdruck, daher hat diese Variable dort keine Wirkung. Erfordert Claude Code v2.1.193 oder höher |240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie `1`, damit Claude Code [Hintergrund-Shell-Befehle](https://code.claude.com/docs/de/interactive-mode.md#background-bash-commands) bei Speicherdruck nicht mehr beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang inaktiv war, ohne dass ein Turn oder Subagent läuft. Windows hat kein Signal für Speicherdruck, daher hat diese Variable dort keine Wirkung. Erfordert Claude Code v2.1.193 oder höher |

241| `CLAUDE_CODE_DISABLE_BG_STABLE_PATH` | Setzen Sie unter macOS mit dem nativen Installer `1`, um den Host-Prozess jeder [Hintergrundsitzung](https://code.claude.com/docs/de/agent-view.md) aus dem installierten Binary statt aus `~/.local/share/claude/ClaudeCode.app` auszuführen. macOS fragt dann möglicherweise erneut nach Berechtigungen wie dem [Ordnerzugriff](https://code.claude.com/docs/de/agent-view.md#background-sessions-can’t-read-desktop-documents-or-downloads-on-macos), auch nach jedem Update. Setzen Sie dies im [`env`-Block](#in-settings-files) der Benutzereinstellungen, einer verwalteten Einstellungsdatei oder einer MDM-Richtlinie, nicht in Ihrer Shell. Um `ClaudeCode.app` zu entfernen, löschen Sie es selbst. Erfordert Claude Code v2.1.295 oder höher |

241| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie `1`, um die mit Claude Code gelieferten [Skills](https://code.claude.com/docs/de/skills.md) und Workflows zu deaktivieren: Mitgelieferte Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie `/init` weiterhin eingegeben werden können, aber vor dem Modell verborgen werden. `/doctor` bleibt wie die integrierten Befehle eingebbar; blenden Sie es stattdessen mit `DISABLE_DOCTOR_COMMAND` aus. Skills aus Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht der Einstellung [`disableBundledSkills`](https://code.claude.com/docs/de/settings-reference#disablebundledskills) |242| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie `1`, um die mit Claude Code gelieferten [Skills](https://code.claude.com/docs/de/skills.md) und Workflows zu deaktivieren: Mitgelieferte Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie `/init` weiterhin eingegeben werden können, aber vor dem Modell verborgen werden. `/doctor` bleibt wie die integrierten Befehle eingebbar; blenden Sie es stattdessen mit `DISABLE_DOCTOR_COMMAND` aus. Skills aus Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht der Einstellung [`disableBundledSkills`](https://code.claude.com/docs/de/settings-reference#disablebundledskills) |

242| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Für Hosts, die Claude Code einbetten und ihre eigenen Browser-Anweisungen bereitstellen. Setzen Sie `1`, um die Browser-Tools von [Claude in Chrome](https://code.claude.com/docs/de/chrome.md) verfügbar zu lassen, während der Chrome-Abschnitt des System-Prompts und der [mitgelieferte Skill](https://code.claude.com/docs/de/skills.md#bundled-skills) `/claude-in-chrome` weggelassen werden. In VS Code lässt die Erweiterung ab v2.1.314 außerdem die Claude in Chrome-Anweisungen aus den Nachrichten einer Sitzung weg. Erfordert Claude Code v2.1.257 oder höher |243| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Für Hosts, die Claude Code einbetten und ihre eigenen Browser-Anweisungen bereitstellen. Setzen Sie `1`, um die Browser-Tools von [Claude in Chrome](https://code.claude.com/docs/de/chrome.md) verfügbar zu lassen, während der Chrome-Abschnitt des System-Prompts und der [mitgelieferte Skill](https://code.claude.com/docs/de/skills.md#bundled-skills) `/claude-in-chrome` weggelassen werden. In VS Code lässt die Erweiterung ab v2.1.314 außerdem die Claude in Chrome-Anweisungen aus den Nachrichten einer Sitzung weg. Erfordert Claude Code v2.1.257 oder höher |

243| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie `1`, um das Laden jeglicher CLAUDE.md-Memory-Dateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und Auto-Memory-Dateien |244| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie `1`, um das Laden jeglicher CLAUDE.md-Memory-Dateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und Auto-Memory-Dateien |


312| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Auf `0` setzen, um die gzip-Komprimierung der Request-Bodys für die Claude API, Telemetrie und die Veröffentlichung von [Artefakten](https://code.claude.com/docs/de/artifacts.md) auszuschalten, die an `api.anthropic.com` gesendet werden. Standardmäßig komprimiert Claude Code große Request-Bodys bei direkten Verbindungen und überspringt die Komprimierung, wenn Sie Anfragen über einen Proxy senden, ein Clientzertifikat konfigurieren oder `NODE_EXTRA_CA_CERTS` setzen. Verwenden Sie `0`, wenn ein [TLS-inspizierender Proxy](https://code.claude.com/docs/de/network-config.md#ca-certificate-store), den Claude Code nicht erkennen kann, komprimierte Anfragen falsch verarbeitet |313| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Auf `0` setzen, um die gzip-Komprimierung der Request-Bodys für die Claude API, Telemetrie und die Veröffentlichung von [Artefakten](https://code.claude.com/docs/de/artifacts.md) auszuschalten, die an `api.anthropic.com` gesendet werden. Standardmäßig komprimiert Claude Code große Request-Bodys bei direkten Verbindungen und überspringt die Komprimierung, wenn Sie Anfragen über einen Proxy senden, ein Clientzertifikat konfigurieren oder `NODE_EXTRA_CA_CERTS` setzen. Verwenden Sie `0`, wenn ein [TLS-inspizierender Proxy](https://code.claude.com/docs/de/network-config.md#ca-certificate-store), den Claude Code nicht erkennen kann, komprimierte Anfragen falsch verarbeitet |

313| `CLAUDE_CODE_HIDE_CWD` | Auf `1` setzen, um das Arbeitsverzeichnis im Startlogo auszublenden. Nützlich für Bildschirmfreigaben oder Aufzeichnungen, bei denen der Pfad Ihren Betriebssystem-Benutzernamen preisgibt |314| `CLAUDE_CODE_HIDE_CWD` | Auf `1` setzen, um das Arbeitsverzeichnis im Startlogo auszublenden. Nützlich für Bildschirmfreigaben oder Aufzeichnungen, bei denen der Pfad Ihren Betriebssystem-Benutzernamen preisgibt |

314| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Überschreibt die Host-Adresse, die für die Verbindung zur IDE-Erweiterung verwendet wird. Standardmäßig erkennt Claude Code die richtige Adresse automatisch, einschließlich des Routings von WSL zu Windows |315| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Überschreibt die Host-Adresse, die für die Verbindung zur IDE-Erweiterung verwendet wird. Standardmäßig erkennt Claude Code die richtige Adresse automatisch, einschließlich des Routings von WSL zu Windows |

315| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Auf `1` setzen, um die automatische Installation von IDE-Erweiterungen zu überspringen. Entspricht dem Setzen von [`autoInstallIdeExtension`](https://code.claude.com/docs/de/settings-reference#autoinstallideextension) auf `false` |316| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Auf `1` setzen, damit `/ide` die IDE-Erweiterung nicht installiert. Entspricht dem Setzen von [`autoInstallIdeExtension`](https://code.claude.com/docs/de/settings-reference#autoinstallideextension) auf `false` |

316| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Auf `1` setzen, um die Validierung von IDE-Lockfile-Einträgen während der Verbindung zu überspringen. Verwenden Sie dies, wenn die automatische Verbindung Ihre IDE nicht findet, obwohl sie läuft |317| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Auf `1` setzen, um die Validierung von IDE-Lockfile-Einträgen während der Verbindung zu überspringen. Verwenden Sie dies, wenn die automatische Verbindung Ihre IDE nicht findet, obwohl sie läuft |

317| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | Kontextgröße in Token, ab der die [Komprimierung im Leerlauf](https://code.claude.com/docs/de/settings-reference.md#idlecompaction) auf eine Konversation angewendet wird (Standard: `200000`). Akzeptiert eine positive ganze Zahl; alles andere wird ignoriert. Werte unter `100000` werden auf `100000` angehoben, den niedrigsten Schwellenwert. Die Komprimierung im Leerlauf ist für Konversationen, die ihre Bedingungen erfüllen, standardmäßig aktiviert. Um sie zu deaktivieren, setzen Sie `idleCompaction` auf `false`. Erfordert Claude Code v2.1.290 oder höher |318| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | Kontextgröße in Token, ab der die [Komprimierung im Leerlauf](https://code.claude.com/docs/de/settings-reference.md#idlecompaction) auf eine Konversation angewendet wird (Standard: `200000`). Akzeptiert eine positive ganze Zahl; alles andere wird ignoriert. Werte unter `100000` werden auf `100000` angehoben, den niedrigsten Schwellenwert. Die Komprimierung im Leerlauf ist für Konversationen, die ihre Bedingungen erfüllen, standardmäßig aktiviert. Um sie zu deaktivieren, setzen Sie `idleCompaction` auf `false`. Erfordert Claude Code v2.1.290 oder höher |

318| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Wie viele [Subagenten](https://code.claude.com/docs/de/sub-agents.md#concurrent-subagent-limit) in einer Sitzung gleichzeitig laufen können, bevor das Agent-Tool das Starten eines weiteren verweigert (Standard: 20). Akzeptiert eine positive ganze Zahl in reinen Ziffern; alles andere wird ignoriert, sodass die Variable die Obergrenze anpassen, aber nicht deaktivieren kann. Erfordert Claude Code v2.1.217 oder höher |319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Wie viele [Subagenten](https://code.claude.com/docs/de/sub-agents.md#concurrent-subagent-limit) in einer Sitzung gleichzeitig laufen können, bevor das Agent-Tool das Starten eines weiteren verweigert (Standard: 20). Akzeptiert eine positive ganze Zahl in reinen Ziffern; alles andere wird ignoriert, sodass die Variable die Obergrenze anpassen, aber nicht deaktivieren kann. Erfordert Claude Code v2.1.217 oder höher |

errors.md +143 −3

Details

55| `spend limit reached` / `spend limit unavailable` | [Nutzungslimits](#spend-limit-reached) |55| `spend limit reached` / `spend limit unavailable` | [Nutzungslimits](#spend-limit-reached) |

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

59| `Your account or API key may still be in the config file. Run claude auth logout.` | [Authentifizierung](#your-account-or-api-key-may-still-be-in-the-config-file) |

58| `Authentication required · Sign in again to continue` | [Authentifizierung](#not-logged-in) |60| `Authentication required · Sign in again to continue` | [Authentifizierung](#not-logged-in) |

59| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |61| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |

60| `Invalid API key` | [Authentifizierung](#invalid-api-key) |62| `Invalid API key` | [Authentifizierung](#invalid-api-key) |


82| `Couldn't verify your organization's policy for remote control` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#couldnt-verify-your-organizations-policy-for-remote-control) |84| `Couldn't verify your organization's policy for remote control` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#couldnt-verify-your-organizations-policy-for-remote-control) |

83| `Remote Control is disabled by your organization's policy` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#remote-control-is-disabled-by-your-organizations-policy) |85| `Remote Control is disabled by your organization's policy` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#remote-control-is-disabled-by-your-organizations-policy) |

84| `Remote Control was turned off by your organization's policy` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#remote-control-was-turned-off-by-your-organizations-policy) |86| `Remote Control was turned off by your organization's policy` | [Fehlerbehebung für Remote Control](https://code.claude.com/docs/de/remote-control.md#remote-control-was-turned-off-by-your-organizations-policy) |

87| `Session failed: working folder not found:` | [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#working-folder-not-found) |

88| `The program file this Remote Control started from is gone` | [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#program-file-is-gone) |

89| `Session failed: spawn error:` gefolgt von einer `ENOENT`-Meldung | [Fehlerbehebung bei Remote Control](https://code.claude.com/docs/de/remote-control.md#program-file-is-gone) |

85| `OAuth token revoked` / `OAuth token has expired` | [Authentifizierung](#oauth-token-revoked-or-expired) |90| `OAuth token revoked` / `OAuth token has expired` | [Authentifizierung](#oauth-token-revoked-or-expired) |

86| `Failed to authenticate: OAuth token revoked` | [Authentifizierung](#oauth-token-revoked-or-expired) |91| `Failed to authenticate: OAuth token revoked` | [Authentifizierung](#oauth-token-revoked-or-expired) |

87| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentifizierung](#oauth-token-revoked-or-expired) |92| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentifizierung](#oauth-token-revoked-or-expired) |


165| `Request too large for the API's 32MB request limit` | [Anfragefehler](#request-too-large) |170| `Request too large for the API's 32MB request limit` | [Anfragefehler](#request-too-large) |

166| `Image was too large` | [Anfragefehler](#image-was-too-large) |171| `Image was too large` | [Anfragefehler](#image-was-too-large) |

167| `API Error: an image in the conversation could not be processed and was removed` | [Anfragefehler](#image-was-too-large) |172| `API Error: an image in the conversation could not be processed and was removed` | [Anfragefehler](#image-was-too-large) |

173| `An image in the conversation exceeds the dimension limit for many-image requests` | [Anfragefehler](#image-was-too-large) |

168| `Unable to resize image` | [Anfragefehler](#unable-to-resize-image) |174| `Unable to resize image` | [Anfragefehler](#unable-to-resize-image) |

169| `Request rejected as unprocessable by the model` | [Anfragefehler](#request-rejected-as-unprocessable-by-the-model) |175| `Request rejected as unprocessable by the model` | [Anfragefehler](#request-rejected-as-unprocessable-by-the-model) |

170| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Anfragefehler](#pdf-errors) |176| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Anfragefehler](#pdf-errors) |


229| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Befehlszeilenfehler](#invalid-agents-configuration) |235| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Befehlszeilenfehler](#invalid-agents-configuration) |

230| `Error: --agents file not found` | [Befehlszeilenfehler](#invalid-agents-configuration) |236| `Error: --agents file not found` | [Befehlszeilenfehler](#invalid-agents-configuration) |

231| `Error: Settings file exceeds the 2MiB limit` | [Befehlszeilenfehler](#settings-file-exceeds-the-2mib-limit) |237| `Error: Settings file exceeds the 2MiB limit` | [Befehlszeilenfehler](#settings-file-exceeds-the-2mib-limit) |

238| `Configuration error in` | [Befehlszeilenfehler](#configuration-error-in-claude-json) |

239| `Claude configuration file at <path> was empty and no backup holds anything: starting with defaults.` | [Befehlszeilenfehler](#claude-configuration-file-was-empty) |

232| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Befehlszeilenfehler](#the-current-directory-no-longer-exists) |240| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Befehlszeilenfehler](#the-current-directory-no-longer-exists) |

233| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |241| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |

234| `ENOSPC: no space left on device, mkdir '<dir>'` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |242| `ENOSPC: no space left on device, mkdir '<dir>'` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |


334| `cannot contain null bytes (\0)` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |342| `cannot contain null bytes (\0)` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |

335| `Path contains null bytes` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |343| `Path contains null bytes` | [Werkzeugfehler](#path-cannot-contain-null-bytes) |

336| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Tool-Fehler](#command-contains-an-invisible-character) |344| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Tool-Fehler](#command-contains-an-invisible-character) |

345| `This call was not run. The command was approved before Claude Code restarted` | [Tool-Fehler](#command-approved-before-a-restart-was-not-run) |

337| `File is too large to read as an image (the limit is 128MB)` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |346| `File is too large to read as an image (the limit is 128MB)` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |

338| `Cannot read this as an image: <path> is a pipe or a device` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |347| `Cannot read this as an image: <path> is a pipe or a device` | [Werkzeugfehler](#file-is-too-large-to-read-as-an-image) |

339| `subagent_type is required: the general-purpose agent is not available in this session` | [Werkzeugfehler](#subagent-type-is-required) |348| `subagent_type is required: the general-purpose agent is not available in this session` | [Werkzeugfehler](#subagent-type-is-required) |


420| `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) |429| `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) |

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

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

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

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

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

435| `Your organization requires remote managed settings to load, but they could not be loaded` | [Fail-Closed-Start erzwingen](https://code.claude.com/docs/de/server-managed-settings.md#enforce-fail-closed-startup) |

436| `Remote managed settings are still loading` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |

437| `Remote managed settings did not load` | [Konfigurationswarnungen](#remote-managed-settings-failed-to-load) |

438| `Claude Code couldn't load your organization's settings` / `Claude Code couldn't reach Anthropic to load your organization's settings` / `requires them before a session can start` | [Konfigurationswarnungen](#couldnt-load-your-organizations-settings) |

439| `Claude Code can't start this session yet` | [Konfigurationswarnungen](#couldnt-load-your-organizations-settings) |

440| `Your Claude session has expired. Sign in again to continue (claude auth login).` | [Konfigurationswarnungen](#couldnt-load-your-organizations-settings) |

425| `Managed settings were not approved; exiting without applying them.` | [Konfigurationswarnungen](#managed-settings-were-not-approved) |441| `Managed settings were not approved; exiting without applying them.` | [Konfigurationswarnungen](#managed-settings-were-not-approved) |

426| `Your organization's managed settings need your approval, which couldn't be asked for here.` | [Konfigurationswarnungen](#managed-settings-need-your-approval) |442| `Your organization's managed settings need your approval, which couldn't be asked for here.` | [Konfigurationswarnungen](#managed-settings-need-your-approval) |

427| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Konfigurationswarnungen](#managed-settings-block-the-default-model) |443| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Konfigurationswarnungen](#managed-settings-block-the-default-model) |


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

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

456| `Stale sandbox mask files left by a killed session` | [Konfigurationswarnungen](#stale-sandbox-mask-files-left-by-a-killed-session) |472| `Stale sandbox mask files left by a killed session` | [Konfigurationswarnungen](#stale-sandbox-mask-files-left-by-a-killed-session) |

473| `Ubuntu's AppArmor restriction on user namespaces stops bubblewrap here` | [Fehlerbehebung beim Sandboxing](https://code.claude.com/docs/de/sandboxing.md#apparmor-restriction-stops-bubblewrap) |

474| `bwrap: setting up uid map: Permission denied` / `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` | [Fehlerbehebung beim Sandboxing](https://code.claude.com/docs/de/sandboxing.md#bwrap-uid-map-permission-denied) |

457| Antworten scheinen von geringerer Qualität als üblich | [Antwortqualität](#responses-seem-lower-quality-than-usual) |475| Antworten scheinen von geringerer Qualität als üblich | [Antwortqualität](#responses-seem-lower-quality-than-usual) |

458 476 

459## Automatische Wiederholungsversuche477## Automatische Wiederholungsversuche


1031* Führen Sie `/login` aus, um sich mit Ihrem Claude-Abonnement oder Console-Konto zu authentifizieren1049* Führen Sie `/login` aus, um sich mit Ihrem Claude-Abonnement oder Console-Konto zu authentifizieren

1032* Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, prüfen Sie, ob `ANTHROPIC_API_KEY` in der Shell, in der Sie `claude` gestartet haben, gesetzt und exportiert ist1050* Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, prüfen Sie, ob `ANTHROPIC_API_KEY` in der Shell, in der Sie `claude` gestartet haben, gesetzt und exportiert ist

1033* Für CI oder Automatisierung, bei denen keine interaktive Anmeldung möglich ist, konfigurieren Sie ein [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft1051* Für CI oder Automatisierung, bei denen keine interaktive Anmeldung möglich ist, konfigurieren Sie ein [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft

1052* Wenn `claude -p`-Jobs mit dieser Meldung beendet werden, sobald sich jemand erneut bei demselben claude.ai-Konto und derselben Organisation anmeldet, aktualisieren Sie Claude Code dort, wo diese Anmeldung stattfindet. Vor v2.1.318 entfernte Claude Code während dieser Anmeldung die gespeicherte Anmeldung, bevor die neue gespeichert wurde.

1034* Unter [Vorrang der Authentifizierung](https://code.claude.com/docs/de/authentication.md#authentication-precedence) erfahren Sie, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind1053* Unter [Vorrang der Authentifizierung](https://code.claude.com/docs/de/authentication.md#authentication-precedence) erfahren Sie, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

1035 1054 

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


1441* Führen Sie auf anderen Plattformen erneut `/login` aus1460* Führen Sie auf anderen Plattformen erneut `/login` aus

1442* Wenn die Anmeldung weiterhin nicht gespeichert wird, finden Sie unter [Nicht angemeldet oder Token abgelaufen](https://code.claude.com/docs/de/troubleshoot-install.md#not-logged-in-or-token-expired) den Befehl zum Entsperren des Schlüsselbunds und weitere Schritte zur Wiederherstellung des Anmeldedatenspeichers1461* Wenn die Anmeldung weiterhin nicht gespeichert wird, finden Sie unter [Nicht angemeldet oder Token abgelaufen](https://code.claude.com/docs/de/troubleshoot-install.md#not-logged-in-or-token-expired) den Befehl zum Entsperren des Schlüsselbunds und weitere Schritte zur Wiederherstellung des Anmeldedatenspeichers

1443 1462 

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

1464 

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

1466 

1467```text theme={null}

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

1469```

1470 

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

1472 

1473**Vorgehensweise:**

1474 

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

1476 

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

1478 

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

1480 

1481```text theme={null}

1482Your account or API key may still be in the config file. Run claude auth logout.

1483```

1484 

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

1486 

1487**Vorgehensweise:**

1488 

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

1490 

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

1445 1492 

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


2420Image was too large. Double press esc to go back and try again with a smaller image.2467Image was too large. Double press esc to go back and try again with a smaller image.

2421API Error: 400 ... image dimensions exceed max allowed size2468API Error: 400 ... image dimensions exceed max allowed size

2422API Error: an image in the conversation could not be processed and was removed.2469API Error: an image in the conversation could not be processed and was removed.

2470An image in the conversation exceeds the dimension limit for many-image requests (3000px). Run /compact to remove old images from context, or start a new session.

2423```2471```

2424 2472 

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


2434 2482 

2435* Ändern Sie die Größe des Bildes vor dem Einfügen. Die API akzeptiert Bilder bis zu 8000 Pixeln an der längsten Kante für ein einzelnes Bild oder 3000 Pixel, wenn mehr als 20 Bilder im Kontext sind.2483* Ändern Sie die Größe des Bildes vor dem Einfügen. Die API akzeptiert Bilder bis zu 8000 Pixeln an der längsten Kante für ein einzelnes Bild oder 3000 Pixel, wenn mehr als 20 Bilder im Kontext sind.

2436* Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms2484* Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms

2485* Bei der Meldung `dimension limit for many-image requests` führen Sie `/compact` im Claude-Code-Prompt aus, wenn die Meldung es nennt, oder starten Sie eine neue Sitzung mit weniger Bildern

2486 

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

2437 2488 

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

2439 2490 


3223 3274 

3224* Verweisen Sie mit `--settings` auf eine reguläre JSON-Einstellungsdatei unter 2 MiB. Das Format finden Sie unter [Einstellungen](https://code.claude.com/docs/de/settings.md).3275* Verweisen Sie mit `--settings` auf eine reguläre JSON-Einstellungsdatei unter 2 MiB. Das Format finden Sie unter [Einstellungen](https://code.claude.com/docs/de/settings.md).

3225 3276 

3277### Configuration error in \~/.claude.json

3278 

3279Claude Code konnte `~/.claude.json` nicht parsen, die Datei, die Ihre Kontodaten, MCP-Server und den projektbezogenen Zustand enthält. Ihre Datei ist unverändert. Ein [nicht interaktiver](https://code.claude.com/docs/de/headless.md) Start wie `claude -p` beendet sich jedes Mal mit Exit-Code 1, bis Sie die Datei reparieren.

3280 

3281Wenn Claude Code ein [Backup](https://code.claude.com/docs/de/claude-directory.md#cleaned-up-automatically) findet, nennt die Ausgabe es und gibt eine `cp`-Zeile aus, die es zurückkopiert:

3282 

3283```text wrap theme={null}

3284Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>

3285The corrupted file has been backed up to: /home/user/.claude/backups/.claude.json.corrupted.1793664000000

3286A backup file exists at: /home/user/.claude/backups/.claude.json.backup.1793660400000

3287You can manually restore it by running: cp -f "/home/user/.claude/backups/.claude.json.backup.1793660400000" "/home/user/.claude.json"

3288 

3289Configuration error in /home/user/.claude.json: <JSON parser's message>

3290```

3291 

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

3293 

3294* **Die Ausgabe enthält eine `cp`-Zeile**: Führen Sie diese Zeile in Ihrem Terminal aus. Unter Windows führen Sie sie in PowerShell aus. Sie ersetzt die defekte Datei durch das Backup, eine frühere Version von `~/.claude.json`.

3295* **Die Ausgabe enthält keine `cp`-Zeile, oder der Fehler tritt nach dem Ausführen erneut auf**: Korrigieren Sie das JSON in `~/.claude.json`, kopieren Sie eine andere `.claude.json.backup.<timestamp>`-Datei aus [`~/.claude/backups/`](https://code.claude.com/docs/de/claude-directory#cleaned-up-automatically) darüber, falls vorhanden, oder benennen Sie die Datei um. Ohne Datei unter `~/.claude.json` startet Claude Code mit Standardeinstellungen und ohne den Inhalt der Datei.

3296 

3297Vor v2.1.318 blieben nach einem nicht interaktiven Start, der diesen Fehler ausgab, nur Standardwerte in `~/.claude.json` zurück, sodass der nächste Start ohne Ihre Konfiguration lief.

3298 

3299### Claude configuration file was empty and no backup holds anything

3300 

3301Diese Meldung beim Start bedeutet, dass die genannte Datei leer war und keine der [`.backup`-Kopien](https://code.claude.com/docs/de/claude-directory#cleaned-up-automatically) der Datei Inhalt hat. Claude Code ist für den Inhalt dieser Datei mit Standardwerten gestartet. Ihre `settings.json`-Dateien und `.mcp.json` sind separate Dateien.

3302 

3303```text wrap theme={null}

3304Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.

3305```

3306 

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

3308 

3309* Richten Sie erneut ein, was Sie in dieser Datei konfiguriert hatten. Fügen Sie beispielsweise Ihre [MCP-Server](https://code.claude.com/docs/de/mcp.md#mcp-installation-scopes) mit den Geltungsbereichen `user` und `local` mit `claude mcp add` aus Ihrem Terminal hinzu.

3310* Melden Sie sich erneut an, wenn Claude Code Sie dazu auffordert

3311 

3312Vor v2.1.318 meldete Claude Code eine leere Datei ohne Backup als [beschädigt](#configuration-error-in-claude-json).

3313 

3226### Das aktuelle Verzeichnis existiert nicht mehr3314### Das aktuelle Verzeichnis existiert nicht mehr

3227 3315 

3228Sie haben `claude` aus einem Verzeichnis gestartet, das gelöscht oder verschoben wurde, nachdem Ihre Shell es betreten hatte, zum Beispiel ein Worktree oder ein temporäres Verzeichnis, das eine andere Shell entfernt hat. Claude Code kann sein Arbeitsverzeichnis nicht lesen, daher beendet es sich mit Exit-Code 1, bevor die Sitzung startet, im interaktiven wie im [nicht interaktiven](https://code.claude.com/docs/de/headless.md) Modus. Vor v2.1.239 stürzte Claude Code ab und gab statt dieser Meldung minifizierten Bundle-Quellcode und einen rohen `ENOENT ... uv_cwd`-Stack auf stderr aus.3316Sie haben `claude` aus einem Verzeichnis gestartet, das gelöscht oder verschoben wurde, nachdem Ihre Shell es betreten hatte, zum Beispiel ein Worktree oder ein temporäres Verzeichnis, das eine andere Shell entfernt hat. Claude Code kann sein Arbeitsverzeichnis nicht lesen, daher beendet es sich mit Exit-Code 1, bevor die Sitzung startet, im interaktiven wie im [nicht interaktiven](https://code.claude.com/docs/de/headless.md) Modus. Vor v2.1.239 stürzte Claude Code ab und gab statt dieser Meldung minifizierten Bundle-Quellcode und einen rohen `ENOENT ... uv_cwd`-Stack auf stderr aus.


3626 3714 

3627Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:3715Verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:

3628 3716 

3629* `Shell command permission check failed for pattern "..."`: Die Berechtigungsprüfung des Befehls hat ihn nicht erlaubt. [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 zum Abbruch führen und wie Sie einen Befehl mit `allowed-tools` vorab genehmigen3717* `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 zum Abbruch führen und wie Sie einen Befehl mit `allowed-tools` vorab genehmigen

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

3631 3719 

3632**Vorgehensweise:**3720**Vorgehensweise:**

3633 3721 


4666* **Für einen Befehl, den Claude geschrieben hat**: Sie müssen nichts beheben. Die Nachricht teilt Claude mit, wie der Befehl umzuschreiben ist.4754* **Für einen Befehl, den Claude geschrieben hat**: Sie müssen nichts beheben. Die Nachricht teilt Claude mit, wie der Befehl umzuschreiben ist.

4667* **Für eine Skill- oder Befehlsdatei**: Die Nachricht folgt auf `No shell command in <name> was run`. Siehe [wo Sie das Zeichen finden und wie Sie es entfernen](#no-shell-command-was-run).4755* **Für eine Skill- oder Befehlsdatei**: Die Nachricht folgt auf `No shell command in <name> was run`. Siehe [wo Sie das Zeichen finden und wie Sie es entfernen](#no-shell-command-was-run).

4668 4756 

4757### Vor dem Neustart von Claude Code genehmigter Befehl wurde nicht ausgeführt

4758 

4759Ein Shell-Befehl, den Sie genehmigt haben, wurde nicht ausgeführt, und Claude erhält diese Nachricht als Ergebnis des Befehls:

4760 

4761```text wrap theme={null}

4762This call was not run. The command was approved before Claude Code restarted, and Claude Code could not confirm that the shell is back in the directory where it was approved. That directory may be gone or replaced, lie outside the directory where the session started, or be one that Claude Code needs approval to enter or is not allowed to examine. The shell's directory is <directory>. If the command still makes sense, cd to the directory it was meant for and make the call again; it may need approval again.

4763```

4764 

4765Der dritte Satz der Nachricht kann stattdessen `It does not keep track of that directory across a restart in a session that has been in a worktree.` lauten.

4766 

4767**Was zu tun ist:**

4768 

4769* Lassen Sie Claude fortfahren, und beantworten Sie die Berechtigungsabfrage, falls Sie gebeten werden, den Befehl erneut zu genehmigen.

4770 

4669### Datei ist zu groß, um als Bild gelesen zu werden4771### Datei ist zu groß, um als Bild gelesen zu werden

4670 4772 

4671Claude hat versucht, eine Datei mit dem [Read-Tool](https://code.claude.com/docs/de/tools-reference.md#read-tool-behavior) als Bild zu lesen, und die Datei ist größer als 128 MB, die maximale Größe, die Read aus einer Bilddatei lädt. Es wurde nichts gelesen, und Claude erhält diesen Fehler als Tool-Ergebnis:4773Claude hat versucht, eine Datei mit dem [Read-Tool](https://code.claude.com/docs/de/tools-reference.md#read-tool-behavior) als Bild zu lesen, und die Datei ist größer als 128 MB, die maximale Größe, die Read aus einer Bilddatei lädt. Es wurde nichts gelesen, und Claude erhält diesen Fehler als Tool-Ergebnis:


5818 5920 

5819### Remote verwaltete Einstellungen konnten nicht geladen werden5921### Remote verwaltete Einstellungen konnten nicht geladen werden

5820 5922 

5821Ihre Sitzung ist berechtigt für [servergesteuerte Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md), aber Claude Code konnte sie nicht abrufen oder konnte nicht anwenden, was der Server zurückgegeben hat, daher zeigt es diese Warnung in interaktiven Sitzungen an.5923Ihre Sitzung ist für [servergesteuerte Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) berechtigt, aber Claude Code konnte sie nicht abrufen oder konnte nicht anwenden, was der Server zurückgegeben hat, daher zeigt es diese Warnung in interaktiven Sitzungen und im Code-Tab von Claude Desktop an.

5822 5924 

5823Die eingeklammerte Ursache benennt, was fehlgeschlagen ist, z. B. `network error`, `request timed out` oder `authentication rejected (401)`. Die Ursache `no setting in the server response could be applied as written` bedeutet, dass der Server geantwortet hat, aber keine der Einstellungen, die er zurückgegeben hat, die [Validierung](https://code.claude.com/docs/de/server-managed-settings.md#invalid-entries-in-delivered-settings) bestanden hat. Vor v2.1.282 lautete diese Ursache `server returned invalid settings`.5925Die eingeklammerte Ursache benennt, was fehlgeschlagen ist, z. B. `network error`, `request timed out` oder `authentication rejected (401)`. Die Ursache `no setting in the server response could be applied as written` bedeutet, dass der Server geantwortet hat, aber keine der Einstellungen, die er zurückgegeben hat, die [Validierung](https://code.claude.com/docs/de/server-managed-settings.md#invalid-entries-in-delivered-settings) bestanden hat. Vor v2.1.282 lautete diese Ursache `server returned invalid settings`.

5824 5926 


5827* **Einstellungen aus einem früheren erfolgreichen Abruf zwischengespeichert**: Claude Code führt die Sitzung auf dieser zwischengespeicherten Richtlinie aus, außer den [zurückhaltenen Umgebungsvariablen](https://code.claude.com/docs/de/server-managed-settings.md#fetch-and-caching-behavior), und die Zeile liest `using cached policy`.5929* **Einstellungen aus einem früheren erfolgreichen Abruf zwischengespeichert**: Claude Code führt die Sitzung auf dieser zwischengespeicherten Richtlinie aus, außer den [zurückhaltenen Umgebungsvariablen](https://code.claude.com/docs/de/server-managed-settings.md#fetch-and-caching-behavior), und die Zeile liest `using cached policy`.

5828* **Kein Cache**: Claude Code führt die Sitzung ohne servergesteuerte Einstellungen aus, und die Zeile liest `no remote policy applied`.5930* **Kein Cache**: Claude Code führt die Sitzung ohne servergesteuerte Einstellungen aus, und die Zeile liest `no remote policy applied`.

5829 5931 

5932Im Code-Tab erscheint die Warnung als Zeile in der Konversation, wenn Sie eine Nachricht senden, und eine neue Zeile erscheint, wenn sich der Status des Abrufs ändert. Drei verwandte Meldungen erscheinen auf dieselbe Weise:

5933 

5934* `Remote managed settings are still loading`: Der Abruf lief noch, als die Sitzung fortgesetzt wurde

5935* `Remote managed settings did not load`: Der Abruf endete ohne Antwort

5936* `Remote managed settings have now loaded`: Die Einstellungen wurden nach einer dieser Warnungen geladen, und der Rest der Zeile gibt an, ob eine Remote-Richtlinie gilt

5937 

5830**Was zu tun ist:**5938**Was zu tun ist:**

5831 5939 

5832* Handeln Sie nach der Ursache, die die Meldung benennt: Überprüfen Sie für eine Netzwerkursache, dass dieser Computer `api.anthropic.com` erreichen kann; für eine Authentifizierungsursache überprüfen Sie Ihre Anmeldung mit `/status`5940* Handeln Sie nach der Ursache, die die Meldung benennt: Überprüfen Sie für eine Netzwerkursache, dass dieser Computer `api.anthropic.com` erreichen kann; für eine Authentifizierungsursache überprüfen Sie Ihre Anmeldung mit `/status`


5835 5943 

5836Vor v2.1.248 meldete Claude Code einen fehlgeschlagenen Einstellungsabruf nur im Debug-Protokoll.5944Vor v2.1.248 meldete Claude Code einen fehlgeschlagenen Einstellungsabruf nur im Debug-Protokoll.

5837 5945 

5946### Claude Code konnte die Einstellungen Ihrer Organisation nicht laden

5947 

5948Ihre Sitzung wurde nicht gestartet, weil die Einstellungen Ihrer Organisation, einschließlich ihrer [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md), zuerst geladen werden müssen und Claude Code sie nicht laden konnte. Zum Beispiel:

5949 

5950```text theme={null}

5951Claude Code couldn't reach Anthropic to load your organization's settings (could not connect). <Organization name> requires them before a session can start.

5952```

5953 

5954Wenn die Meldung in einem Dialog mit dem Titel `Claude Code can't start this session yet` erscheint, schließt sich der Dialog, und die Sitzung startet, sobald die Einstellungen geladen sind.

5955 

5956Im [nicht interaktiven Modus](https://code.claude.com/docs/de/headless.md) und in [Hintergrundsitzungen](https://code.claude.com/docs/de/agent-view.md) gibt Claude Code stattdessen die Meldung aus und wird mit Status 1 beendet.

5957 

5958**Was zu tun ist:**

5959 

5960* **`could not connect` oder `the reply came from a network proxy, not Anthropic`**: Überprüfen Sie Ihre Netzwerkverbindung, und bitten Sie in einem Unternehmensnetzwerk die IT, HTTPS zu `api.anthropic.com/api/claude_code/policy_limits` und `api.anthropic.com/api/claude_code/settings` zuzulassen. Wählen Sie dann **Retry now** aus, oder führen Sie Ihren Befehl erneut aus.

5961* **`timed out`, `Anthropic returned an error` oder `Anthropic asked it to retry shortly`**: Lassen Sie den Dialog es erneut versuchen, oder führen Sie Ihren Befehl später erneut aus. Prüfen Sie [status.anthropic.com](https://status.anthropic.com), wenn das Problem weiterhin auftritt.

5962* **`still loading` oder `couldn't verify your sign-in with Anthropic yet`**: Lassen Sie den Dialog es erneut versuchen, oder führen Sie Ihren Befehl erneut aus. Wenn die Anmeldemeldung immer wieder erscheint, melden Sie sich erneut an, indem Sie `claude auth login` in Ihrer Shell ausführen.

5963* **`Your Claude session has expired`**: Die auf diesem Computer gespeicherte Anmeldung ist nicht mehr gültig, daher hilft ein erneuter Versuch nicht. Wählen Sie im Dialog **Sign in again** aus, um Claude Code zu schließen; führen Sie dann in Ihrer Shell `claude auth login` aus, was auch funktioniert, solange Sitzungen nicht starten können.

5964* **`none of the settings the server returned could be applied as written`**: Bitten Sie Ihren Administrator, die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md#invalid-entries-in-delivered-settings) der Organisation zu korrigieren, und versuchen Sie es dann erneut.

5965 

5838### Verwaltete Einstellungen wurden nicht genehmigt5966### Verwaltete Einstellungen wurden nicht genehmigt

5839 5967 

5840Die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) Ihrer Organisation enthalten Einstellungen, die Ihre Genehmigung benötigen, und Sie haben den [Sicherheitsgenehmigungsdialog](https://code.claude.com/docs/de/server-managed-settings.md#security-approval-dialogs) abgelehnt, daher wird Claude Code beendet, ohne sie anzuwenden:5968Die [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) Ihrer Organisation enthalten Einstellungen, die Ihre Genehmigung benötigen, und Sie haben den [Sicherheitsgenehmigungsdialog](https://code.claude.com/docs/de/server-managed-settings.md#security-approval-dialogs) abgelehnt, daher wird Claude Code beendet, ohne sie anzuwenden:


6294 6422 

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

6296 6424 

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

6426 

6427Dieser 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:

6428 

6429```text theme={null}

6430Make this change again later: /home/user/.claude.json could not be updated, so it applies to this session only.

6431```

6432 

6433**Was zu tun ist:**

6434 

6435* Nehmen Sie die Änderung in einer späteren Sitzung erneut vor. Führen Sie zum Beispiel `/login` erneut aus oder beantworten Sie die Vertrauensabfrage erneut.

6436 

6297## Antworten scheinen von geringerer Qualität als üblich6437## Antworten scheinen von geringerer Qualität als üblich

6298 6438 

6299Wenn Claudes Antworten weniger leistungsfähig erscheinen als erwartet, aber kein Fehler angezeigt wird, liegt die Ursache normalerweise im Gesprächszustand und nicht im Modell selbst. Claude Code ändert nicht stillschweigend Modellversionen. Es kann in diesen Fällen zu einem Fallback-Modell wechseln:6439Wenn Claudes Antworten weniger leistungsfähig erscheinen als erwartet, aber kein Fehler angezeigt wird, liegt die Ursache normalerweise im Gesprächszustand und nicht im Modell selbst. Claude Code ändert nicht stillschweigend Modellversionen. Es kann in diesen Fällen zu einem Fallback-Modell wechseln:

headless.md +3 −1

Details

48 48 

49Im Bare-Modus liest Claude Code niemals OAuth-Anmeldedaten oder den System-Schlüsselbund. Für die Anthropic API setzen Sie `ANTHROPIC_API_KEY` in der Umgebung mit einem Schlüssel, der in der [Claude Console](https://platform.claude.com) erstellt wurde, oder geben Sie einen `apiKeyHelper` in der `--settings`-JSON an. Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry lesen weiterhin ihre eigenen Provider-Anmeldedaten wie gewohnt.49Im Bare-Modus liest Claude Code niemals OAuth-Anmeldedaten oder den System-Schlüsselbund. Für die Anthropic API setzen Sie `ANTHROPIC_API_KEY` in der Umgebung mit einem Schlüssel, der in der [Claude Console](https://platform.claude.com) erstellt wurde, oder geben Sie einen `apiKeyHelper` in der `--settings`-JSON an. Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry lesen weiterhin ihre eigenen Provider-Anmeldedaten wie gewohnt.

50 50 

51Im Bare-Modus hat Claude Zugriff auf die Bash-, Dateilese- und Dateibearbeitungs-Tools. Übergeben Sie jeden benötigten Kontext mit einem Flag:51Im Bare-Modus hat Claude Zugriff auf die Tools Bash, Datei lesen und Datei bearbeiten. Übergeben Sie den benötigten Kontext mit einem Flag:

52 52 

53| Zum Laden | Verwenden Sie |53| Zum Laden | Verwenden Sie |

54| - | - |54| - | - |


58| [Benutzerdefinierte Agenten](https://code.claude.com/docs/de/sub-agents.md#choose-the-subagent-scope) | `--agents <file-or-json>` |58| [Benutzerdefinierte Agenten](https://code.claude.com/docs/de/sub-agents.md#choose-the-subagent-scope) | `--agents <file-or-json>` |

59| Ein Plugin | `--plugin-dir <path>`, `--plugin-url <url>` |59| Ein Plugin | `--plugin-dir <path>`, `--plugin-url <url>` |

60 60 

61Hooks werden im Bare-Modus weiterhin nicht ausgeführt, wenn Sie sie mit `--settings` übergeben oder wenn sie in der [`hooks/hooks.json`](https://code.claude.com/docs/de/plugins/components#hooks) oder unter dem [Manifest-Schlüssel `hooks`](https://code.claude.com/docs/de/plugins/manifest-reference#hooks) eines Plugins stehen, das Sie mit einem Flag laden. Verwenden Sie den Bare-Modus nicht für eine Ausführung, die sie benötigt.

62 

61Der Bare-Modus schränkt außerdem ein, was während der Sitzung geschieht:63Der Bare-Modus schränkt außerdem ein, was während der Sitzung geschieht:

62 64 

63* **MCP-Server**: Es werden nur Server verbunden, die über die Befehlszeile übergeben werden, z. B. mit `--mcp-config`. In einer interaktiven Sitzung überspringt Claude Code außerdem die automatische IDE-Verbindung, sofern Sie nicht `--ide` übergeben.65* **MCP-Server**: Es werden nur Server verbunden, die über die Befehlszeile übergeben werden, z. B. mit `--mcp-config`. In einer interaktiven Sitzung überspringt Claude Code außerdem die automatische IDE-Verbindung, sofern Sie nicht `--ide` übergeben.

Details

96Bearbeiten Sie eine Migration niemals, nachdem sie gemergt wurde. Fügen Sie stattdessen eine neue Migration hinzu.96Bearbeiten Sie eine Migration niemals, nachdem sie gemergt wurde. Fügen Sie stattdessen eine neue Migration hinzu.

97```97```

98 98 

99Wenn Sie Claude von `packages/api/` starten, lädt es sowohl `packages/api/CLAUDE.md` als auch die Root `CLAUDE.md`. Claude sieht die lokalen Anweisungen neben den Repository-weiten Regeln, ohne Anweisungen von `packages/web/` im Kontext. Das Gleiche gilt für jedes Unterverzeichnis in einem Non-Monorepo-Baum. Um zu bestätigen, welche Dateien geladen wurden, führen Sie `/context` aus und überprüfen Sie die Liste unter **Memory-Dateien**.99Wenn Sie Claude von `packages/api/` starten, lädt es sowohl `packages/api/CLAUDE.md` als auch die Root `CLAUDE.md`. Claude sieht die lokalen Anweisungen neben den Repository-weiten Regeln, ohne Anweisungen von `packages/web/` im Kontext. Das Gleiche gilt für jedes Unterverzeichnis in einem Non-Monorepo-Baum. Um zu bestätigen, welche Dateien geladen wurden, führen Sie [`/context all`](https://code.claude.com/docs/de/commands#all-commands) aus und überprüfen Sie die Liste unter **Memory files**.

100 100 

101Ein paar Möglichkeiten, um die Dateien aktuell zu halten, während sich die Codebase und Modelle ändern:101Ein paar Möglichkeiten, um die Dateien aktuell zu halten, während sich die Codebase und Modelle ändern:

102 102 

memory.md +6 −4

Details

67 67 

68### Richten Sie eine Projekt-CLAUDE.md ein68### Richten Sie eine Projekt-CLAUDE.md ein

69 69 

70Eine Projekt-CLAUDE.md kann entweder in `./CLAUDE.md` oder `./.claude/CLAUDE.md` gespeichert werden. Erstellen Sie diese Datei und fügen Sie Anweisungen hinzu, die für jeden gelten, der am Projekt arbeitet: Build- und Test-Befehle, Codierungsstandards, architektonische Entscheidungen, Namenskonventionen und häufige Arbeitsabläufe. Diese Anweisungen werden über Versionskontrolle mit Ihrem Team geteilt, daher konzentrieren Sie sich auf projektweite Standards statt auf persönliche Voreinstellungen. Um zu bestätigen, dass die Datei geladen wurde, führen Sie `/context` in einer Sitzung aus und überprüfen Sie die Liste unter **Memory-Dateien**.70Eine Projekt-CLAUDE.md kann entweder in `./CLAUDE.md` oder `./.claude/CLAUDE.md` gespeichert werden. Erstellen Sie diese Datei und fügen Sie Anweisungen hinzu, die für jeden gelten, der am Projekt arbeitet: Build- und Test-Befehle, Codierungsstandards, architektonische Entscheidungen, Namenskonventionen und häufige Arbeitsabläufe. Diese Anweisungen werden über Versionskontrolle mit Ihrem Team geteilt, daher konzentrieren Sie sich auf projektweite Standards statt auf persönliche Voreinstellungen.

71 

72Um zu bestätigen, dass die Datei geladen wurde, führen Sie [`/context all`](https://code.claude.com/docs/de/commands#all-commands) in einer Sitzung aus und überprüfen Sie die Liste unter **Memory files**. Im [Vollbildmodus](https://code.claude.com/docs/de/fullscreen.md) klappt `/context` allein diese Liste zusammen.

71 73 

72> [!TIP]74> [!TIP]

73>75>


461* **Bearbeitung**: Claude liest `CLAUDE.md` durch den Link, aber die Edit- und Write-Tools [weigern sich, durch einen Symlink zu schreiben](https://code.claude.com/docs/de/errors.md#refusing-after-a-symlink-changed), und die Weigerung weist Claude an, stattdessen das Ziel des Links, `AGENTS.md`, zu bearbeiten463* **Bearbeitung**: Claude liest `CLAUDE.md` durch den Link, aber die Edit- und Write-Tools [weigern sich, durch einen Symlink zu schreiben](https://code.claude.com/docs/de/errors.md#refusing-after-a-symlink-changed), und die Weigerung weist Claude an, stattdessen das Ziel des Links, `AGENTS.md`, zu bearbeiten

462* **Windows**: Wenn Sie oder jemand, der das Repository klont, unter Windows arbeitet, verwenden Sie stattdessen den `@AGENTS.md`-Import. Das Erstellen eines Symlinks dort erfordert Administratorrechte oder den Entwicklermodus, und Git checkt einen committeten Symlink als Nur-Text-Datei aus, es sei denn, `core.symlinks` ist aktiviert, was diesen Klon mit einer einzeiligen `CLAUDE.md` anstelle Ihrer Anweisungen hinterlässt464* **Windows**: Wenn Sie oder jemand, der das Repository klont, unter Windows arbeitet, verwenden Sie stattdessen den `@AGENTS.md`-Import. Das Erstellen eines Symlinks dort erfordert Administratorrechte oder den Entwicklermodus, und Git checkt einen committeten Symlink als Nur-Text-Datei aus, es sei denn, `core.symlinks` ist aktiviert, was diesen Klon mit einer einzeiligen `CLAUDE.md` anstelle Ihrer Anweisungen hinterlässt

463 465 

464Führen Sie mit beiden Ansätzen `/context` in Ihrer nächsten Sitzung aus und bestätigen Sie, dass `CLAUDE.md` unter **Speicherdateien** angezeigt wird.466Führen Sie mit beiden Ansätzen `/context all` in Ihrer nächsten Sitzung aus und bestätigen Sie, dass `CLAUDE.md` unter **Speicherdateien** angezeigt wird.

465 467 

466### Migrieren Sie Anweisungen von anderen Tools468### Migrieren Sie Anweisungen von anderen Tools

467 469 


567 569 

568## Anzeigen und Bearbeiten mit `/memory`570## Anzeigen und Bearbeiten mit `/memory`

569 571 

570Der Befehl `/memory` listet Ihre CLAUDE.md, CLAUDE.local.md und andere Speicherdateien an verschiedenen Orten im Benutzer- und Projektbereich auf, einschließlich Benutzer- und Projekt-CLAUDE.md-Einträge für Dateien, die noch nicht existieren. Er ermöglicht es Ihnen auch, Auto-Memory ein- oder auszuschalten, und bietet eine Option zum Öffnen des Auto-Memory-Ordners. Wählen Sie eine beliebige Datei aus, um sie in Ihrem Editor zu öffnen; wenn Sie eine Datei auswählen, die noch nicht existiert, wird sie zuerst erstellt. Um zu überprüfen, welche `CLAUDE.md`- und Regeldateien beim Start geladen wurden, führen Sie `/context` aus.572Der Befehl `/memory` listet die Speicherorte Ihrer CLAUDE.md, CLAUDE.local.md und anderer Memory-Dateien im Benutzer- und Projekt-Geltungsbereich auf. Die Liste enthält Benutzer- und Projekt-CLAUDE.md-Einträge auch für Dateien, die noch nicht existieren. Der Befehl ermöglicht es Ihnen außerdem, Auto-Memory ein- oder auszuschalten, und bietet eine Option zum Öffnen des Auto-Memory-Ordners. Wählen Sie eine beliebige Datei aus, um sie in Ihrem Editor zu öffnen; wenn Sie eine Datei auswählen, die noch nicht existiert, wird sie zuerst erstellt.

571 573 

572GUI-Editoren wie VS Code öffnen die Datei in einem separaten Fenster, und Sie können die Sitzung weiterhin nutzen, während sie offen ist. Terminal-Editoren wie Vim übernehmen das Terminal, bis Sie es beenden.574GUI-Editoren wie VS Code öffnen die Datei in einem separaten Fenster, und Sie können die Sitzung weiterhin nutzen, während sie offen ist. Terminal-Editoren wie Vim übernehmen das Terminal, bis Sie es beenden.

573 575 


583 585 

584Zum Debuggen:586Zum Debuggen:

585 587 

586* Führen Sie `/context` aus und überprüfen Sie die Liste unter **Memory-Dateien**, um die CLAUDE.md- und CLAUDE.local.md-Dateien zu überprüfen, die beim Start geladen werden sollten. Wenn eine davon dort fehlt, kann Claude sie nicht sehen. Verwenden Sie `/memory`, um die Dateien zu öffnen und zu bearbeiten.588* Führen Sie `/context all` aus und überprüfen Sie die Liste unter **Memory-Dateien**, um die CLAUDE.md- und CLAUDE.local.md-Dateien zu überprüfen, die beim Start geladen werden sollten. Wenn eine davon dort fehlt, kann Claude sie nicht sehen. Verwenden Sie `/memory`, um die Dateien zu öffnen und zu bearbeiten.

587* Wenn ein Hinweis `Instruction file not loaded` erscheint, lesen Sie, [was er bedeutet und was Sie dagegen tun können](https://code.claude.com/docs/de/errors.md#instruction-file-not-loaded).589* Wenn ein Hinweis `Instruction file not loaded` erscheint, lesen Sie, [was er bedeutet und was Sie dagegen tun können](https://code.claude.com/docs/de/errors.md#instruction-file-not-loaded).

588* Eine `CLAUDE.md` in einem Unterverzeichnis Ihres Arbeitsverzeichnisses erscheint nicht unter **Memory-Dateien**, da sie bei Bedarf und nicht beim Start geladen wird. Wenn sie geladen wird, erscheint im Terminal eine `Loaded`-Zeile mit ihrem Pfad. Um eine neue zu testen, erstellen Sie sie über Ihre Shell, anstatt Claude zu bitten, sie zu schreiben, und bitten Sie Claude dann, eine Datei in diesem Unterverzeichnis zu lesen.590* Eine `CLAUDE.md` in einem Unterverzeichnis Ihres Arbeitsverzeichnisses erscheint nicht unter **Memory-Dateien**, da sie bei Bedarf und nicht beim Start geladen wird. Wenn sie geladen wird, erscheint im Terminal eine `Loaded`-Zeile mit ihrem Pfad. Um eine neue zu testen, erstellen Sie sie über Ihre Shell, anstatt Claude zu bitten, sie zu schreiben, und bitten Sie Claude dann, eine Datei in diesem Unterverzeichnis zu lesen.

589* Überprüfen Sie, dass die relevante CLAUDE.md an einem Ort ist, der für Ihre Sitzung geladen wird (siehe [Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen](#choose-where-to-put-claude-md-files)).591* Überprüfen Sie, dass die relevante CLAUDE.md an einem Ort ist, der für Ihre Sitzung geladen wird (siehe [Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen](#choose-where-to-put-claude-md-files)).

Details

245>245>

246> **Als Standard**: Setzen Sie `defaultMode` in [Einstellungen](https://code.claude.com/docs/de/settings.md#where-settings-live). Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI und wendet den Berechtigungsmodus auf neue lokale Sitzungen an.246> **Als Standard**: Setzen Sie `defaultMode` in [Einstellungen](https://code.claude.com/docs/de/settings.md#where-settings-live). Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI und wendet den Berechtigungsmodus auf neue lokale Sitzungen an.

247>247>

248> Ein Modus, den Sie im Moduswahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner. Plan ist die Ausnahme: Das Auswählen gilt nur für die aktuelle Sitzung.248> Ein Modus, den Sie in einer lokalen Sitzung im Moduswahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor einem `defaultMode` in den `.claude/`-Einstellungen des Projekts. Eine neue lokale Sitzung kann dennoch in einem `defaultMode` aus `~/.claude/settings.json` oder aus verwalteten Einstellungen starten; prüfen Sie daher den Wahlschalter vor Ihrer ersten Nachricht. Wenn Sie Plan auswählen, gilt dies nur für diese Sitzung.

249>249>

250> Wo `defaultMode` in einer Einstellungsdatei steht, sehen Sie im Beispiel unter [Starten Sie in einem anderen Berechtigungsmodus](#start-in-a-different-mode).250> Wo `defaultMode` in einer Einstellungsdatei steht, sehen Sie im Beispiel unter [Starten Sie in einem anderen Berechtigungsmodus](#start-in-a-different-mode).

251 251 


372 372 

373* **Eine direkte Verbindung zur Anthropic API**: in interaktiven Terminal-Sitzungen sowie in `-p`-, Agent SDK-, [VS Code-Erweiterungs](https://code.claude.com/docs/de/vs-code.md)- und [Desktop-App](https://code.claude.com/docs/de/desktop.md)-Sitzungen, unabhängig von Ihrem Plan oder Kontotyp, während Anthropic dies einführt. Gleichen Sie Ihren Sitzungstyp mit diesen Mindestversionen von Claude Code ab:373* **Eine direkte Verbindung zur Anthropic API**: in interaktiven Terminal-Sitzungen sowie in `-p`-, Agent SDK-, [VS Code-Erweiterungs](https://code.claude.com/docs/de/vs-code.md)- und [Desktop-App](https://code.claude.com/docs/de/desktop.md)-Sitzungen, unabhängig von Ihrem Plan oder Kontotyp, während Anthropic dies einführt. Gleichen Sie Ihren Sitzungstyp mit diesen Mindestversionen von Claude Code ab:

374 * In interaktiven Terminal-Sitzungen erfordert die Anfrage beim Server Claude Code v2.1.271 oder später bei Pro-, Max-, Ultra- und Team-Plänen. Bei Enterprise-Plänen und Claude API-Konten erfordern diese Sitzungen v2.1.278 oder später.374 * In interaktiven Terminal-Sitzungen erfordert die Anfrage beim Server Claude Code v2.1.271 oder später bei Pro-, Max-, Ultra- und Team-Plänen. Bei Enterprise-Plänen und Claude API-Konten erfordern diese Sitzungen v2.1.278 oder später.

375 * In `-p`-, Agent SDK-, VS Code-Erweiterungs- und Desktop-App-Sitzungen erfordert die Anfrage beim Server Claude Code v2.1.281 oder später375 * In `-p`- und VS Code-Erweiterungs-Sitzungen erfordert die Anfrage beim Server Claude Code v2.1.278 oder später

376 * In Agent SDK- und Desktop-App-Sitzungen erfordert die Anfrage beim Server Claude Code v2.1.281 oder später

376 * Ab v2.1.282 fragt eine Sitzung, die [keine Feature-Flags abruft](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching), zum Beispiel weil Sie die Telemetrie deaktiviert haben, in jeder Art von Sitzung standardmäßig beim Server an377 * Ab v2.1.282 fragt eine Sitzung, die [keine Feature-Flags abruft](https://code.claude.com/docs/de/env-vars.md#features-that-need-feature-flag-fetching), zum Beispiel weil Sie die Telemetrie deaktiviert haben, in jeder Art von Sitzung standardmäßig beim Server an

377* **Ein Cloud-Anbieter oder ein LLM-Gateway oder Proxy**: bei [Claude Platform auf AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, und wann immer Sie `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway oder einen Proxy](https://code.claude.com/docs/de/llm-gateway) verweisen lassen, unabhängig von Ihrem Plan. Das standardmäßige Anfragen erfordert Claude Code v2.1.278 oder später.378* **Ein Cloud-Anbieter oder ein LLM-Gateway oder Proxy**: bei [Claude Platform auf AWS](https://code.claude.com/docs/de/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, und wann immer Sie `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway oder einen Proxy](https://code.claude.com/docs/de/llm-gateway) verweisen lassen, unabhängig von Ihrem Plan. Das standardmäßige Anfragen erfordert Claude Code v2.1.278 oder später.

378* **Eine angemeldete [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzung**: erfordert Claude Code v2.1.280 oder später379* **Eine angemeldete [Claude-Apps-Gateway](https://code.claude.com/docs/de/claude-apps-gateway)-Sitzung**: erfordert Claude Code v2.1.280 oder später

permissions.md +1 −1

Details

69 69 

70## Genehmigungsmodi70## Genehmigungsmodi

71 71 

72Claude Code unterstützt mehrere Genehmigungsmodi, die steuern, wie es Werkzeugaufrufe genehmigt. Siehe [Genehmigungsmodi](https://code.claude.com/docs/de/permission-modes.md) für die Verwendung der einzelnen Modi. Um den Modus zu ändern, in dem Sitzungen starten, setzen Sie `defaultMode` in Ihren [Einstellungsdateien](https://code.claude.com/docs/de/settings.md#where-settings-live). [Welcher Modus eine Sitzung startet](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) behandelt den integrierten Standard für jeden Plan und was die VS Code-Erweiterung liest.72Claude Code unterstützt mehrere Berechtigungsmodi, die steuern, wie es Tool-Aufrufe genehmigt. Siehe [Berechtigungsmodi](https://code.claude.com/docs/de/permission-modes.md) für die Verwendung der einzelnen Modi. Um den Standard-Berechtigungsmodus für neue Sitzungen zu ändern, setzen Sie `defaultMode` in Ihren [Einstellungsdateien](https://code.claude.com/docs/de/settings.md#where-settings-live). [In welchem Modus eine Sitzung startet](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) behandelt den integrierten Standard für jeden Plan und was die VS Code-Erweiterung liest.

73 73 

74| Modus | Beschreibung |74| Modus | Beschreibung |

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

Details

571| :- | :- | :- |571| :- | :- | :- |

572| Hook-Befehle | Überall in `command` und `args` | `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA`, `CLAUDE_PROJECT_DIR` und `CLAUDE_PLUGIN_OPTION_<KEY>` |572| Hook-Befehle | Überall in `command` und `args` | `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA`, `CLAUDE_PROJECT_DIR` und `CLAUDE_PLUGIN_OPTION_<KEY>` |

573| Monitor-Befehle | Überall in `command` | Nicht exportiert |573| Monitor-Befehle | Überall in `command` | Nicht exportiert |

574| MCP-`stdio`-Server | `command`, `args`, `env` | `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA` |574| MCP-`stdio`-Server | `command`, `args`, `env` | `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA`, `CLAUDE_PROJECT_DIR` |

575| MCP-`http`-, `sse`-, `ws`-Server | `url`, `headers`, `headersHelper` | Nicht anwendbar |575| MCP-`http`-, `sse`-, `ws`-Server | `url`, `headers`, `headersHelper` | Nicht anwendbar |

576| LSP-Server | `command`, `args`, `env`, `workspaceFolder` | `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA`, `CLAUDE_PROJECT_DIR` |576| LSP-Server | `command`, `args`, `env`, `workspaceFolder` | `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA`, `CLAUDE_PROJECT_DIR` |

577| Skill-, Befehls- und Agent-Inhalt | Überall im Markdown-Text | Nicht anwendbar |577| Skill-, Befehls- und Agent-Inhalt | Überall im Markdown-Text | Nicht anwendbar |

Details

154| Event | Wird ausgelöst, wenn | Ein Hook kann zurückgeben |154| Event | Wird ausgelöst, wenn | Ein Hook kann zurückgeben |

155| :- | :- | :- |155| :- | :- | :- |

156| `agent.offer` | Claude ein Subagenten-Typ angeboten wird | `{ isOffered: false }`, um ihn zurückzuhalten |156| `agent.offer` | Claude ein Subagenten-Typ angeboten wird | `{ isOffered: false }`, um ihn zurückzuhalten |

157| `agent.spawn` | Ein Subagent oder ein Teammitglied eines [Agent-Teams](https://code.claude.com/docs/de/agent-teams.md) gleich startet. Bei einem Teammitglied ist `e.isTeammate` gleich `true`. | `next({ ...e, model })`, um sein Modell zu wählen, oder `{ deny: reason }` |157| `agent.spawn` | Ein Subagent oder ein Teammitglied eines [Agent-Teams](https://code.claude.com/docs/de/agent-teams.md) gleich startet oder ein Subagent, der fertig ist oder angehalten wurde, gleich erneut ausgeführt wird. Bei einem Teammitglied ist `e.isTeammate` gleich `true`. Bei einer fortgesetzten Ausführung ist `e.resume` gesetzt. | `next({ ...e, model })`, um das Modell eines startenden Subagenten oder Teammitglieds zu wählen, oder `{ deny: reason }` |

158 158 

159Wenn Claude einen Subagenten mit dem Tool [`SendMessage`](https://code.claude.com/docs/de/sub-agents#resume-subagents) fortsetzt, wird Ihr `agent.spawn`-Hook nicht erneut ausgeführt. Um die `SendMessage`-Aufrufe abzulehnen, die einen Subagenten fortsetzen, gleichen Sie dieses Tool in einem [`tool.call`](https://code.claude.com/docs/de/plugins/mods/events#guard-or-change-a-tool-call)-Hook ab.159Ihr `agent.spawn`-Hook wird auch ausgeführt, wenn ein Subagent, der fertig ist oder angehalten wurde, gleich erneut ausgeführt wird, etwa wenn Claude ihm mit dem Tool [`SendMessage`](https://code.claude.com/docs/de/sub-agents#resume-subagents) eine Nachricht sendet. Bei diesem Event ist `e.resume` gleich `{ agentId }`. Wenn Ihr Hook Subagenten zählt, überspringen Sie die Events, bei denen `e.resume` gesetzt ist, damit ein fortgesetzter Subagent nicht erneut gezählt wird.

160 

161Geben Sie `{ deny: reason }` zurück, um eine fortgesetzte Ausführung abzulehnen. Die Ausführung startet nicht, und der Subagent bleibt, wie er war. Wenn ein `SendMessage`-Aufruf die Ausführung angefordert hat, liest Claude `a plugin declined the resume:`, gefolgt von Ihrer Begründung, als Ergebnis dieses Aufrufs. Wenn Sie für eine fortgesetzte Ausführung ein geändertes Event an `next` übergeben, etwa ein anderes `model`, ignoriert Claude Code die Änderung.

162 

163> [!NOTE]

164>

165> Das Event für eine fortgesetzte Ausführung erfordert Claude Code v2.1.299 oder höher. Vor v2.1.299 wurde Ihr `agent.spawn`-Hook nicht ausgeführt, wenn ein Subagent fortgesetzt wurde. Um in diesen Versionen die `SendMessage`-Aufrufe abzulehnen, die einen Subagenten fortsetzen, gleichen Sie dieses Tool in einem [`tool.call`](https://code.claude.com/docs/de/plugins/mods/events#guard-or-change-a-tool-call)-Hook ab.

160 166 

161### Oberfläche167### Oberfläche

162 168 

Details

502* Netzwerk- oder Proxy-Problem: Eine Firewall oder ein Proxy blockiert möglicherweise die ausgehende HTTPS-Anfrage. Remote Control erfordert Zugriff auf die Anthropic API auf Port 443.502* Netzwerk- oder Proxy-Problem: Eine Firewall oder ein Proxy blockiert möglicherweise die ausgehende HTTPS-Anfrage. Remote Control erfordert Zugriff auf die Anthropic API auf Port 443.

503* Sitzungserstellung fehlgeschlagen: Wenn Sie auch `Session creation failed — see debug log` sehen, ist der Fehler früher beim Setup aufgetreten. Überprüfen Sie, dass Ihr Abonnement aktiv ist.503* Sitzungserstellung fehlgeschlagen: Wenn Sie auch `Session creation failed — see debug log` sehen, ist der Fehler früher beim Setup aufgetreten. Überprüfen Sie, dass Ihr Abonnement aktiv ist.

504 504 

505### "working folder not found"

506 

507Im Terminal, in dem [`claude remote-control`](#start-a-remote-control-session) läuft, bedeutet `Session failed: working folder not found:` gefolgt von einem Pfad in Anführungszeichen, dass eine Sitzung nicht starten konnte, weil unter diesem Pfad kein Ordner existiert.

508 

509* **Der Server läuft noch**: Stellen Sie den Ordner wieder her und starten Sie die Sitzung erneut, oder stoppen Sie den Server

510* **Der Server wurde beendet**: Führen Sie `claude remote-control` erneut in einem Ordner aus, der existiert

511 

512Vor v2.1.318 zeigte eine auf diese Weise fehlgeschlagene Sitzung `Session failed: spawn error:` und eine `ENOENT`-Meldung, die statt des fehlenden Ordners eine Programmdatei nannte.

513 

514### "The program file this Remote Control started from is gone"

515 

516Diese Warnung im Terminal, in dem [`claude remote-control`](#start-a-remote-control-session) läuft, bedeutet, dass die Programmdatei, von der aus der Server gestartet wurde, fehlt und neue Sitzungen die neuere Version ausführen, die sie ersetzt hat. Um auch den Server auf diese Version umzustellen, stoppen Sie ihn und führen Sie `claude remote-control` erneut aus. Wenn Claude Code auf Netzwerkspeicher installiert ist, starten Sie den Server jetzt neu und folgen Sie [Installation auf Netzwerkspeicher](https://code.claude.com/docs/de/setup.md#install-on-network-storage). Andernfalls starten neue Sitzungen ohne Neustart.

517 

518Wenn die Programmdatei fehlt und Claude Code keine neuere Version zum Ausführen findet, schlagen neue Sitzungen fehl. Das Terminal zeigt einen Fehler wie `Session failed: spawn error:` gefolgt von einer `ENOENT`-Meldung. Stoppen Sie den Server, [installieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#install-claude-code) erneut, wenn `claude` in Ihrer Shell nicht ausgeführt wird, und führen Sie `claude remote-control` erneut aus. Vor v2.1.318 schlugen neue Sitzungen auf diese Weise fehl, selbst wenn eine neuere Version installiert war.

519 

505### "Couldn't reconnect to your Remote Control session"520### "Couldn't reconnect to your Remote Control session"

506 521 

507Wenn Sie eine Konversation mit `claude --resume` oder `claude --continue` fortsetzen, verbindet sich Claude Code erneut mit der Remote-Control-Sitzung, die in dieser Konversation aufgezeichnet ist. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der möglicherweise vorübergehend ist, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist.522Wenn Sie eine Konversation mit `claude --resume` oder `claude --continue` fortsetzen, verbindet sich Claude Code erneut mit der Remote-Control-Sitzung, die in dieser Konversation aufgezeichnet ist. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der möglicherweise vorübergehend ist, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist.

sandboxing.md +59 −27

Details

71* **Overrides**: Legen Sie fest, ob Befehle, die in der Sandbox fehlschlagen, ersatzweise außerhalb der Sandbox ausgeführt werden dürfen. Dies ist die Einstellung [`allowUnsandboxedCommands`](https://code.claude.com/docs/de/settings-reference#sandbox-allowunsandboxedcommands)71* **Overrides**: Legen Sie fest, ob Befehle, die in der Sandbox fehlschlagen, ersatzweise außerhalb der Sandbox ausgeführt werden dürfen. Dies ist die Einstellung [`allowUnsandboxedCommands`](https://code.claude.com/docs/de/settings-reference#sandbox-allowunsandboxedcommands)

72* **Config**: Zeigen Sie die aufgelösten Sandbox-Einstellungen an72* **Config**: Zeigen Sie die aufgelösten Sandbox-Einstellungen an

73 73 

74Wenn das Panel nur einen Tab „Dependencies“ anzeigt, fehlt ein erforderliches Paket. Installieren Sie es wie unter [Linux und WSL2 einrichten](#set-up-linux-and-wsl2) beschrieben, starten Sie Claude Code neu und führen Sie `/sandbox` erneut aus.74Wenn das Panel nur einen Tab „Dependencies“ anzeigt, kann die Sandbox noch nicht starten. Beheben Sie, was der Tab meldet, wie unter [Linux und WSL2 einrichten](#set-up-linux-and-wsl2) beschrieben, starten Sie Claude Code neu und führen Sie `/sandbox` erneut aus.

75 75 

76**2. Einen Modus wählen**76**2. Einen Modus wählen**

77 77 


97 97 

98> [!WARNING]98> [!WARNING]

99>99>

100> Wenn die Sandbox nicht starten kann, weil eine Abhängigkeit fehlt oder die Plattform nicht unterstützt wird, führt Claude Code Befehle standardmäßig ohne Sandboxing aus. Damit Claude Code stattdessen beim Start beendet wird, setzen Sie [`sandbox.failIfUnavailable`](https://code.claude.com/docs/de/settings-reference#sandbox-failifunavailable) auf `true`. Verwaltete Bereitstellungen, die Sandboxing als Sicherheitsvoraussetzung verlangen, können diese Einstellung verwenden.100> Wenn die Plattform die Sandbox nicht unterstützt oder die Abhängigkeitsprüfung beim Start fehlschlägt, führt Claude Code Befehle standardmäßig ohne Sandboxing aus. Damit Claude Code stattdessen beim Start beendet wird, setzen Sie [`sandbox.failIfUnavailable`](https://code.claude.com/docs/de/settings-reference#sandbox-failifunavailable) auf `true`. Verwaltete Bereitstellungen, die Sandboxing als Sicherheitsvoraussetzung verlangen, können diese Einstellung verwenden.

101 101 

102### Prüfen, ob Befehle in der Sandbox ausgeführt werden102### Prüfen, ob Befehle in der Sandbox ausgeführt werden

103 103 


135 135 

136Ripgrep ist in der nativen Claude Code-Binärdatei enthalten. Der seccomp-Filter ist optional und ergänzt das Blockieren von Unix-Domain-Sockets. Installieren Sie ihn mit `npm install -g @anthropic-ai/sandbox-runtime`, falls er fehlt.136Ripgrep ist in der nativen Claude Code-Binärdatei enthalten. Der seccomp-Filter ist optional und ergänzt das Blockieren von Unix-Domain-Sockets. Installieren Sie ihn mit `npm install -g @anthropic-ai/sandbox-runtime`, falls er fehlt.

137 137 

138Wenn eine erforderliche Abhängigkeit fehlt, ist der Tab „Dependencies“ der einzige angezeigte Tab, bis Sie sie installieren. Wenn nur der optionale seccomp-Filter fehlt, erscheint der Tab „Dependencies“ neben den anderen Tabs. Die Abhängigkeitsprüfung läuft beim Start, starten Sie Claude Code daher nach der Installation von Paketen neu, damit `/sandbox` sie erkennt.138* **Dependencies ist der einzige Tab**: Die Sandbox kann nicht starten. Installieren Sie, was der Tab als fehlend auflistet, oder [fügen Sie ein AppArmor-Profil für bubblewrap hinzu](#add-an-apparmor-profile-for-bubblewrap), wenn er die AppArmor-Einschränkung von Ubuntu meldet

139* **Dependencies erscheint neben den anderen Tabs**: Der Tab listet ein fehlendes optionales Element auf, etwa den seccomp-Filter. Die Sandbox kann ohne dieses Element starten; installieren Sie es daher nur, wenn Sie die damit verbundene Funktion nutzen möchten

139 140 

140> [accordion] Ubuntu 24.04 und neuer: bubblewrap das Erstellen von User Namespaces erlauben141Die Abhängigkeitsprüfung läuft beim Start, starten Sie Claude Code daher nach der Installation von Paketen neu, damit `/sandbox` sie erkennt.

141>

142> Unter Ubuntu 24.04 und neuer verhindert die standardmäßige AppArmor-Richtlinie, dass bubblewrap die User Namespaces erstellt, die es für die Isolation benötigt.

143>

144> Um zu prüfen, ob Ihre Umgebung diese Einschränkung durchsetzt, auch innerhalb von WSL2, führen Sie `sysctl kernel.apparmor_restrict_unprivileged_userns` aus. Wenn der Befehl `0` zurückgibt, überspringen Sie diesen Schritt. Wenn er einen `No such file or directory`-Fehler ausgibt, existiert der Schlüssel nicht, und Sie können diesen Schritt überspringen. Wenn er `1` zurückgibt, fügen Sie ein AppArmor-Profil hinzu, das `bwrap` diese Fähigkeit gewährt:

145>

146> ```bash theme={null}

147> sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'

148> abi <abi/4.0>,

149> include <tunables/global>

150>

151> profile bwrap /usr/bin/bwrap flags=(unconfined) {

152> userns,

153> include if exists <local/bwrap>

154> }

155> EOF

156> ```

157>

158> Das Profil gilt nur für `bwrap` selbst, nicht für die Befehle, die es innerhalb der Sandbox ausführt. Laden Sie AppArmor neu, um es anzuwenden:

159>

160> ```bash theme={null}

161> sudo systemctl reload apparmor

162> ```

163 142 

164> [accordion] Hinweise zu WSL2143> [accordion] Hinweise zu WSL2

165>144>


167>146>

168> Unter WSL2 übergibt WSL den Start einer Windows-Binärdatei wie `cmd.exe`, `powershell.exe` oder von allem unter `/mnt/c/` über einen Unix-Socket an den Windows-Host. Ob ein Befehl in der Sandbox eine solche Datei starten kann, richtet sich daher nach den [Unix-Socket-Einstellungen](https://code.claude.com/docs/de/settings-reference.md#sandbox-network-allowunixsockets) der Sandbox: Der optionale seccomp-Filter muss installiert sein, damit der Socket überhaupt blockiert wird. Um diese Starts zu erlauben, setzen Sie `allowAllUnixSockets`, wodurch jeder Unix-Socket für Befehle in der Sandbox geöffnet wird.147> Unter WSL2 übergibt WSL den Start einer Windows-Binärdatei wie `cmd.exe`, `powershell.exe` oder von allem unter `/mnt/c/` über einen Unix-Socket an den Windows-Host. Ob ein Befehl in der Sandbox eine solche Datei starten kann, richtet sich daher nach den [Unix-Socket-Einstellungen](https://code.claude.com/docs/de/settings-reference.md#sandbox-network-allowunixsockets) der Sandbox: Der optionale seccomp-Filter muss installiert sein, damit der Socket überhaupt blockiert wird. Um diese Starts zu erlauben, setzen Sie `allowAllUnixSockets`, wodurch jeder Unix-Socket für Befehle in der Sandbox geöffnet wird.

169 148 

149#### Ein AppArmor-Profil für bubblewrap hinzufügen

150 

151Fügen Sie das Profil hinzu, wenn Claude Code `/usr/bin/bwrap` ausführt und einer der folgenden Fälle eintritt:

152 

153* Claude Code [meldet die AppArmor-Einschränkung von Ubuntu für User Namespaces](#apparmor-restriction-stops-bubblewrap)

154* Befehle in der Sandbox schlagen mit `bwrap: setting up uid map: Permission denied` oder `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` fehl, während [diese Einschränkung aktiv ist](#bwrap-uid-map-permission-denied)

155 

156Claude Code führt das erste `bwrap` im `PATH` aus, sofern verwaltete Einstellungen nicht in [`sandbox.bwrapPath`](https://code.claude.com/docs/de/settings-reference#sandbox-bwrappath) ein anderes festlegen. Um zu sehen, welches `bwrap` zuerst gefunden wird, führen Sie `which bwrap` in der Shell aus, aus der Sie Claude Code starten. Wenn Claude Code einen anderen Pfad als `/usr/bin/bwrap` ausführt, [heben Sie die Einschränkung stattdessen mit `sysctl` auf](#apparmor-restriction-stops-bubblewrap).

157 

158Um das Profil für `/usr/bin/bwrap` hinzuzufügen, führen Sie diesen Befehl aus:

159 

160```bash theme={null}

161sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'

162abi <abi/4.0>,

163include <tunables/global>

164 

165profile bwrap /usr/bin/bwrap flags=(unconfined) {

166 userns,

167 include if exists <local/bwrap>

168}

169EOF

170```

171 

172Laden Sie AppArmor neu, um es anzuwenden:

173 

174```bash theme={null}

175sudo systemctl reload apparmor

176```

177 

178Starten Sie Claude Code anschließend neu und [prüfen Sie, ob die Sandbox funktioniert](#confirm-commands-run-inside-the-sandbox).

179 

170### Sandbox-Modi180### Sandbox-Modi

171 181 

172Claude Code bietet zwei Sandbox-Modi. In beiden setzt die Sandbox dieselben Dateisystem- und Netzwerkeinschränkungen durch; der Unterschied besteht nur darin, ob Befehle in der Sandbox automatisch genehmigt werden oder eine ausdrückliche Berechtigung erfordern.182Claude Code bietet zwei Sandbox-Modi. In beiden setzt die Sandbox dieselben Dateisystem- und Netzwerkeinschränkungen durch; der Unterschied besteht nur darin, ob Befehle in der Sandbox automatisch genehmigt werden oder eine ausdrückliche Berechtigung erfordern.


716 726 

717Die beiden Schlüssel über `enabled` hinaus steuern, was passiert, wenn die Sandbox einen Befehl nicht ausführen kann:727Die beiden Schlüssel über `enabled` hinaus steuern, was passiert, wenn die Sandbox einen Befehl nicht ausführen kann:

718 728 

719* **`failIfUnavailable`**: Eine fehlende Abhängigkeit wie bubblewrap auf Linux verhindert den Start von Claude Code, anstatt auf eine Ausführung ohne Sandbox zurückzufallen729* **`failIfUnavailable`**: Wenn die Plattform die Sandbox nicht unterstützt oder die Abhängigkeitsprüfung beim Start fehlschlägt, verweigert Claude Code den Start, anstatt auf eine Ausführung ohne Sandbox zurückzufallen

720* **`allowUnsandboxedCommands: false`**: Claude Code ignoriert die `dangerouslyDisableSandbox`-Fluchtluke. Wenn ein Befehl unter der Sandbox fehlschlägt, kann Claude ihn daher nicht ohne Sandbox erneut versuchen730* **`allowUnsandboxedCommands: false`**: Claude Code ignoriert die `dangerouslyDisableSandbox`-Fluchtluke. Wenn ein Befehl unter der Sandbox fehlschlägt, kann Claude ihn daher nicht ohne Sandbox erneut versuchen

721 731 

722Erwägen Sie zusätzlich diese Ergänzungen:732Erwägen Sie zusätzlich diese Ergänzungen:


902 912 

903In einem unprivilegierten Container kann [bubblewrap](#os-level-enforcement) kein neues `/proc`-Dateisystem einhängen, daher schlagen in der Sandbox ausgeführte Befehle mit einem `bwrap`-Fehler wie `Can't mount proc on /newroot/proc: Operation not permitted` fehl. Setzen Sie [`enableWeakerNestedSandbox`](https://code.claude.com/docs/de/settings-reference#sandbox-enableweakernestedsandbox) auf `true`, damit die Sandbox stattdessen das vorhandene `/proc` des Containers per Bind-Mount einbindet. Verwenden Sie diese Einstellung nur, wenn der äußere Container bereits die Isolationsgrenze bietet, die Sie benötigen, da die Einstellung in der Sandbox ausgeführten Befehlen Prozessinformationen zugänglich macht, die ein neu eingehängtes `/proc` verbergen würde.913In einem unprivilegierten Container kann [bubblewrap](#os-level-enforcement) kein neues `/proc`-Dateisystem einhängen, daher schlagen in der Sandbox ausgeführte Befehle mit einem `bwrap`-Fehler wie `Can't mount proc on /newroot/proc: Operation not permitted` fehl. Setzen Sie [`enableWeakerNestedSandbox`](https://code.claude.com/docs/de/settings-reference#sandbox-enableweakernestedsandbox) auf `true`, damit die Sandbox stattdessen das vorhandene `/proc` des Containers per Bind-Mount einbindet. Verwenden Sie diese Einstellung nur, wenn der äußere Container bereits die Isolationsgrenze bietet, die Sie benötigen, da die Einstellung in der Sandbox ausgeführten Befehlen Prozessinformationen zugänglich macht, die ein neu eingehängtes `/proc` verbergen würde.

904 914 

915### Die AppArmor-Einschränkung von Ubuntu blockiert bubblewrap

916 

917Unter Linux und WSL2 bedeutet die Meldung `Ubuntu's AppArmor restriction on user namespaces stops bubblewrap here`, dass die AppArmor-Einschränkung von Ubuntu den Start der Sandbox verhindert.

918 

919Damit die Sandbox startet, heben Sie die Einschränkung auf eine dieser beiden Arten auf:

920 

921* [Fügen Sie ein AppArmor-Profil für bubblewrap hinzu](#add-an-apparmor-profile-for-bubblewrap), wenn Claude Code `/usr/bin/bwrap` ausführt

922* Führen Sie in Ihrer Shell `sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0` aus. Dadurch wird die Einschränkung für jedes Programm auf dem Rechner aufgehoben, bis Sie neu starten

923 

924Starten Sie dann Claude Code neu und [überprüfen Sie, ob die Sandbox funktioniert](#confirm-commands-run-inside-the-sandbox).

925 

926Bis Sie die Einschränkung aufheben, werden Befehle ohne Sandbox im regulären Berechtigungsablauf ausgeführt, oder Claude Code verweigert den Start, wenn [`sandbox.failIfUnavailable`](https://code.claude.com/docs/de/settings-reference#sandbox-failifunavailable) auf `true` gesetzt ist.

927 

928### In der Sandbox ausgeführte Befehle schlagen mit `bwrap: setting up uid map: Permission denied` fehl

929 

930Unter Linux und WSL2 können dieser Fehler oder `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` bedeuten, dass die AppArmor-Einschränkung von Ubuntu für User-Namespaces bubblewrap blockiert. Um dies zu prüfen, führen Sie `sysctl kernel.apparmor_restrict_unprivileged_userns` in Ihrer Shell aus:

931 

932* `kernel.apparmor_restrict_unprivileged_userns = 1`: Die Einschränkung ist aktiv. [Fügen Sie ein AppArmor-Profil hinzu](#add-an-apparmor-profile-for-bubblewrap), wenn Claude Code `/usr/bin/bwrap` ausführt, oder führen Sie `sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0` aus, wodurch die Einschränkung für jedes Programm aufgehoben wird, bis Sie neu starten. Starten Sie dann Claude Code neu und [überprüfen Sie, ob die Sandbox funktioniert](#confirm-commands-run-inside-the-sandbox)

933* Jede andere Ausgabe: Die Einschränkung ist nicht die Ursache. Um den Fehler zu melden, führen Sie [`/feedback`](https://code.claude.com/docs/de/commands#all-commands) an der Eingabeaufforderung von Claude Code aus

934 

935Vor v2.1.310 hat Claude Code beim Start nicht auf diese Einschränkung geprüft, daher hat `/sandbox` sie nicht gemeldet.

936 

905### Schreibgeschützte 0-Byte-Dateien erscheinen in `.claude`-Einstellungspfaden, und „Ja, und nicht mehr fragen“ wird nicht gespeichert937### Schreibgeschützte 0-Byte-Dateien erscheinen in `.claude`-Einstellungspfaden, und „Ja, und nicht mehr fragen“ wird nicht gespeichert

906 938 

907Unter Linux und WSL2 setzt die Sandbox eine Schreibsperre für eine noch nicht existierende Datei durch, indem sie dort einen schreibgeschützten 0-Byte-Platzhalter erstellt, während ein Befehl in der Sandbox ausgeführt wird. Die Sandbox entfernt den Platzhalter danach.939Unter Linux und WSL2 setzt die Sandbox eine Schreibsperre für eine noch nicht existierende Datei durch, indem sie dort einen schreibgeschützten 0-Byte-Platzhalter erstellt, während ein Befehl in der Sandbox ausgeführt wird. Die Sandbox entfernt den Platzhalter danach.

Details

472 472 

473Um zu bestätigen, dass der Trap funktioniert, fügen Sie direkt unter der `trap`-Zeile eine Zeile ein, die einen nicht existierenden Befehl aufruft, etwa `no-such-command`. Führen Sie die Hook-Datei aus Ihrer Shell aus und prüfen Sie, dass `echo $?` den Wert `1` ausgibt; entfernen Sie die Zeile anschließend.473Um zu bestätigen, dass der Trap funktioniert, fügen Sie direkt unter der `trap`-Zeile eine Zeile ein, die einen nicht existierenden Befehl aufruft, etwa `no-such-command`. Führen Sie die Hook-Datei aus Ihrer Shell aus und prüfen Sie, dass `echo $?` den Wert `1` ausgibt; entfernen Sie die Zeile anschließend.

474 474 

475#### Herausfinden, warum eine Spawn-Anfrage gesendet wurde

476 

477Ihr Hook erhält den Grund für jede Spawn-Anfrage in `CLAUDE_RUNNER_SPAWN_REASON`, sodass Sie zusammen mit `CLAUDE_RUNNER_SESSION_UUID` protokollieren können, warum der Hook ausgeführt wurde. Erfordert Claude Code v2.1.318 oder höher auf dem Orchestrator. Lesen Sie die Variable als `"${CLAUDE_RUNNER_SPAWN_REASON:-}"`, da sie nicht gesetzt sein kann, und starten Sie den Runner unabhängig vom Wert. Wenn Ihr Hook anhand des Werts verzweigt, behalten Sie einen Standardzweig bei, da Anthropic weitere Werte hinzufügen kann.

478 

479Um den Grund für frühere Anfragen zu finden, durchsuchen Sie das Log jeder Orchestrator-Replika nach `session=` und der `CLAUDE_RUNNER_SESSION_UUID` der Sitzung, nicht nach ihrer `session_...`-ID. Die Zeilen `ok session=` und `nack session=` zeigen den Wert von `CLAUDE_RUNNER_SPAWN_REASON` nach `reason=` oder `reason=-`, wenn er nicht gesetzt war:

480 

481* **`[runner:orchestrator] ok session=`**: Der Hook wurde mit 0 beendet

482* **`[runner:orchestrator] nack session=`**: Der Orchestrator meldet Anthropic eine fehlgeschlagene Spawn-Anfrage

483 

484Jeder Wert gibt nur die letzte Ursache an, die Anthropic für die Sitzung aufgezeichnet hat, nicht ihren Verlauf:

485 

486| Wert | Was passiert ist | Was zu prüfen ist |

487| :- | :- | :- |

488| `session_created` | Dies ist die erste Spawn-Anfrage für eine neue Sitzung | Nichts. Verlassen Sie sich nicht darauf, um die erste Anfrage einer Sitzung zu erkennen, da die erste Anfrage, die Ihr Hook sieht, `runner_lost` enthalten kann, nachdem ein Fixed-Fleet- oder Standby-Runner die Sitzung gehalten hat. |

489| `no_runner_registered` | Für die vorherige Anfrage hat sich innerhalb von `--expected-spawn-seconds` kein Runner registriert, und Anthropic hat dafür keinen Fehlerbericht aufgezeichnet | `stop: no nack for session=` oder `nack failed session=` unter den früheren Zeilen der Sitzung bedeutet, dass kein Fehlerbericht aufgezeichnet wurde. Lesen Sie einen etwaigen Hook-Fehler davor, und wenn der Orchestrator gerade gestoppt wurde, siehe [Orchestrator stoppen oder neu starten](#stop-or-restart-the-orchestrator). Prüfen Sie nach einer `ok session=`-Zeile, ob ihr Runner innerhalb von `--expected-spawn-seconds` gestartet ist und sich registriert hat. Wenn keine Replika die Anfrage protokolliert hat, prüfen Sie Ihre Orchestratoren auf Neustarts und `poll failed`-Zeilen. |

490| `hook_failed` | Ihr Orchestrator hat gemeldet, dass die vorherige Anfrage fehlgeschlagen ist und erneut versucht werden kann, zum Beispiel weil Ihr Hook mit 1 beendet wurde oder bei Ablauf von `--hook-timeout` noch lief. Der Wert ist derselbe, wenn Ihr Orchestrator eine Anfrage an Anthropic zurückgibt, ohne den Hook auszuführen, zum Beispiel während der Orchestrator gestoppt wird. | Suchen Sie die letzte `[runner:orchestrator] nack session=`- oder `stop: handing back session=`-Zeile der Sitzung vor dieser Anfrage. Der Spawn-Fehler, den der Orchestrator gesendet hat, folgt auf den `reason=`-Wert und kann sich über die folgenden Zeilen fortsetzen. Eine `handing back session=`-Zeile bedeutet, dass der Orchestrator gerade gestoppt wurde und den Hook nicht ausgeführt hat, sodass am Hook nichts zu beheben ist. |

491| `runner_lost` | Der Runner, der die Sitzung hielt, hat aufgehört, an Anthropic zu berichten, hat sich abgemeldet oder wurde gelöscht | Finden Sie heraus, was den Runner gestoppt oder von Anthropic getrennt hat, etwa eine Node-Eviction, ein Beenden wegen Speichermangels, eine Spot-Rückforderung oder Ihr eigenes Rollout oder Herunterskalieren |

492| `runner_reported_failure` | Der vorherige Runner hat gemeldet, dass die Sitzung auf ihm fehlgeschlagen ist, zum Beispiel beim Checkout | Lesen Sie das Log des vorherigen Runners. Wenn viele Sitzungen diesen Wert erhalten, prüfen Sie das Image und die Einrichtung des Repositorys. |

493| `resumed` | Die Sitzung war pausiert und benötigt jetzt wieder einen Runner. Zum Beispiel hat ihr Runner sie unter [`--release-idle-session-min`](#make-on-demand-runners-exit-when-idle) freigegeben, und später hat sie eine neue Nachricht erhalten. | Nichts |

494| `requeued` | Die Sitzung wurde wieder in die Warteschlange gestellt, zum Beispiel als ein Owner **Erneut versuchen** ausgewählt hat oder eine blockierte Sitzung eine neue Nachricht erhalten hat | Wenn dieselbe Sitzung diesen Wert immer wieder erhält, lesen Sie den Fehler auf ihren `nack session=`-Zeilen. Wenn ihr Hook mit 0 beendet wurde, lesen Sie das Log des Runners. |

495| `server_retry` | Anthropic hat die vorherige Anfrage oder das Starten der Sitzung auf ihrem Runner aufgegeben und versucht es erneut. Ihr Hook ist nicht fehlgeschlagen. | Nichts bei einer einzelnen Anfrage. Wenn der Wert immer wieder auftritt, bei einer Sitzung oder bei vielen, melden Sie ihn [Ihrem Anthropic-Account-Team](https://code.claude.com/docs/de/self-hosted-environments-deploy.md#report-an-issue). |

496| `prewarm` | Dies ist eine Pre-Warming-Anfrage, noch ohne Sitzung | Nichts |

497 

475### Orchestrator stoppen oder neu starten498### Orchestrator stoppen oder neu starten

476 499 

477Um den Orchestrator zu stoppen oder neu zu starten, ohne laufende `spawn-runner`-Hooks abzubrechen, starten Sie ihn mit [`--shutdown-drain-sec`](https://code.claude.com/docs/de/self-hosted-environments-reference#orchestrator-cli-flags). Bei `SIGTERM` gibt er laufenden Hooks dann bis zu der von Ihnen festgelegten Anzahl von Sekunden Zeit, um abzuschließen. Wie Sie den Wert wählen und Ihren Prozess-Supervisor passend einrichten, erfahren Sie unter [`--shutdown-drain-sec` und den Stopp-Timeout des Orchestrators bemessen](#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator).500Um den Orchestrator zu stoppen oder neu zu starten, ohne laufende `spawn-runner`-Hooks abzubrechen, starten Sie ihn mit [`--shutdown-drain-sec`](https://code.claude.com/docs/de/self-hosted-environments-reference#orchestrator-cli-flags). Bei `SIGTERM` gibt er laufenden Hooks dann bis zu der von Ihnen festgelegten Anzahl von Sekunden Zeit, um abzuschließen. Wie Sie den Wert wählen und Ihren Prozess-Supervisor passend einrichten, erfahren Sie unter [`--shutdown-drain-sec` und den Stopp-Timeout des Orchestrators bemessen](#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator).

Details

172 172 

173Ein Client, der über ein [Claude apps gateway](#platform-availability) angemeldet ist, ruft seine Einstellungen vom Gateway ab und wartet auf diesen Abruf, bevor die Sitzung beginnt. Der Abruf in den folgenden Listen gilt für ihn daher nicht. [Fail-Closed-Start erzwingen](#enforce-fail-closed-startup) beschreibt, was passiert, wenn dieser Abruf fehlschlägt.173Ein Client, der über ein [Claude apps gateway](#platform-availability) angemeldet ist, ruft seine Einstellungen vom Gateway ab und wartet auf diesen Abruf, bevor die Sitzung beginnt. Der Abruf in den folgenden Listen gilt für ihn daher nicht. [Fail-Closed-Start erzwingen](#enforce-fail-closed-startup) beschreibt, was passiert, wenn dieser Abruf fehlschlägt.

174 174 

175> [!NOTE]

176>

177> Bei einer auf dem Rechner gespeicherten claude.ai-Anmeldung für Team oder Enterprise kann Anthropic die Einstellungen Ihrer Organisation verlangen, bevor eine Sitzung beginnt. In diesem Fall kann ein Entwickler, unabhängig davon, was die folgenden Listen besagen, in Fällen wie diesen [keine Sitzung starten](https://code.claude.com/docs/de/errors.md#couldnt-load-your-organizations-settings):

178>

179> * Seine Anmeldung ist abgelaufen, bis er `claude auth login` ausführt

180> * Claude Code hat weder die Einstellungen noch eine aktuelle zwischengespeicherte Kopie. Prüfen Sie, ob der Rechner `api.anthropic.com` erreichen kann

181>

182> Eine Startmeldung mit `before a session can start` oder `Your Claude session has expired` bedeutet, dass diese Anforderung gilt.

183 

175**Erster Start ohne zwischengespeicherte Einstellungen:**184**Erster Start ohne zwischengespeicherte Einstellungen:**

176 185 

177* Wenn sich ein Entwickler beim Start anmeldet, etwa beim ersten Lauf oder nach `/logout`, wartet Claude Code bis zu fünf Sekunden auf den Abruf, bevor es die Sitzung öffnet. Trifft die Richtlinie rechtzeitig ein, setzt Claude Code sie ab dem ersten Bildschirm durch und zeigt dort Ihre [`companyAnnouncements`](https://code.claude.com/docs/de/settings-reference#companyannouncements) an. Benötigt die Payload eine [Sicherheitsgenehmigung](#security-approval-dialogs), beendet Claude Code das Warten und wendet die Payload an, sobald der Entwickler sie genehmigt186* Wenn sich ein Entwickler beim Start anmeldet, etwa beim ersten Lauf oder nach `/logout`, wartet Claude Code bis zu fünf Sekunden auf den Abruf, bevor es die Sitzung öffnet. Trifft die Richtlinie rechtzeitig ein, setzt Claude Code sie ab dem ersten Bildschirm durch und zeigt dort Ihre [`companyAnnouncements`](https://code.claude.com/docs/de/settings-reference#companyannouncements) an. Benötigt die Payload eine [Sicherheitsgenehmigung](#security-approval-dialogs), beendet Claude Code das Warten und wendet die Payload an, sobald der Entwickler sie genehmigt

178* Bei jedem anderen Start und wenn diese fünfsekündige Wartezeit abläuft, öffnet Claude Code die Sitzung, während der Abruf weiterläuft. Es vergeht also ein kurzer Zeitraum, bevor die Einstellungen geladen werden und die Einschränkungen wirksam werden187* Bei jedem anderen Start und wenn diese fünfsekündige Wartezeit abläuft, öffnet Claude Code die Sitzung, während der Abruf weiterläuft. Es vergeht also ein kurzer Zeitraum, bevor die Einstellungen geladen werden und die Einschränkungen wirksam werden

179* Schlägt der Abruf fehl, fährt Claude Code ohne servergesteuerte Einstellungen fort und warnt in interaktiven Sitzungen, dass keine Remote-Richtlinie gilt; endpunktgesteuerte Einstellungen gelten weiterhin. Wenn eine verwaltete Quelle [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) setzt, beendet sich Claude Code stattdessen188* Schlägt der Abruf fehl, fährt Claude Code ohne servergesteuerte Einstellungen fort und warnt in interaktiven Sitzungen und im [Code-Tab von Claude Desktop](https://code.claude.com/docs/de/desktop.md), dass keine Remote-Richtlinie gilt; endpunktgesteuerte Einstellungen gelten weiterhin. Wenn eine verwaltete Quelle [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) setzt, beendet sich Claude Code stattdessen

180 189 

181**Spätere Starts mit zwischengespeicherten Einstellungen:**190**Spätere Starts mit zwischengespeicherten Einstellungen:**

182 191 


186* Ein zwischengespeicherter Wert für [`prependPlugins`](https://code.claude.com/docs/de/settings-reference#prependplugins), [`appendPlugins`](https://code.claude.com/docs/de/settings-reference#appendplugins) oder [`enabledPlugins`](https://code.claude.com/docs/de/settings-reference#enabledplugins) kann den integrierten Wächter erst entfernen, umpositionieren oder ausschalten, wenn der Abruf der Sitzung die Payload bestätigt195* Ein zwischengespeicherter Wert für [`prependPlugins`](https://code.claude.com/docs/de/settings-reference#prependplugins), [`appendPlugins`](https://code.claude.com/docs/de/settings-reference#appendplugins) oder [`enabledPlugins`](https://code.claude.com/docs/de/settings-reference#enabledplugins) kann den integrierten Wächter erst entfernen, umpositionieren oder ausschalten, wenn der Abruf der Sitzung die Payload bestätigt

187* Auf einem Rechner, auf dem eine [endpunktgesteuerte Quelle](https://code.claude.com/docs/de/managed-settings.md#choose-a-delivery-mechanism) eigene Plugins auflistet oder aktiviert, gilt ein Plugin, das nur eine zwischengespeicherte Liste aktiviert, als [Plugin des Benutzers](https://code.claude.com/docs/de/plugins/mods/admin.md#install-your-organizations-mods) und nicht als Plugin Ihrer Organisation, bis der Abruf die Payload bestätigt196* Auf einem Rechner, auf dem eine [endpunktgesteuerte Quelle](https://code.claude.com/docs/de/managed-settings.md#choose-a-delivery-mechanism) eigene Plugins auflistet oder aktiviert, gilt ein Plugin, das nur eine zwischengespeicherte Liste aktiviert, als [Plugin des Benutzers](https://code.claude.com/docs/de/plugins/mods/admin.md#install-your-organizations-mods) und nicht als Plugin Ihrer Organisation, bis der Abruf die Payload bestätigt

188* Claude Code ruft im Hintergrund aktuelle Einstellungen ab197* Claude Code ruft im Hintergrund aktuelle Einstellungen ab

189* Zwischengespeicherte Einstellungen bleiben bei Netzwerkausfällen erhalten. Schlägt der Abruf beim Start fehl, warnt Claude Code in interaktiven Sitzungen, dass die zwischengespeicherte Richtlinie gilt198* Zwischengespeicherte Einstellungen bleiben bei Netzwerkausfällen erhalten. Schlägt der Abruf beim Start fehl, warnt Claude Code in interaktiven Sitzungen und im Code-Tab, dass die zwischengespeicherte Richtlinie gilt

190* Bis ein Abruf erfolgreich ist, bleiben die beim Start zurückgehaltenen Werte zurückgehalten199* Bis ein Abruf erfolgreich ist, bleiben die beim Start zurückgehaltenen Werte zurückgehalten

191 200 

192Claude Code hält mehrere Kategorien von Variablen im zwischengespeicherten `env`-Block zurück, bis der Server die Payload für die Sitzung bestätigt. Dadurch wird verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Einstellungsabruf, der die Payload bestätigt, umleitet, abfängt oder neu authentifiziert. Diese Absicherung gilt nur für den Cache der vom Server abgerufenen Einstellungen: [Endpunktgesteuerte Einstellungen](https://code.claude.com/docs/de/managed-settings.md#delivery-mechanisms), die über MDM oder `managed-settings.json` bereitgestellt werden, sind nicht betroffen. Zu den zurückgehaltenen Kategorien gehören:201Claude Code hält mehrere Kategorien von Variablen im zwischengespeicherten `env`-Block zurück, bis der Server die Payload für die Sitzung bestätigt. Dadurch wird verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Einstellungsabruf, der die Payload bestätigt, umleitet, abfängt oder neu authentifiziert. Diese Absicherung gilt nur für den Cache der vom Server abgerufenen Einstellungen: [Endpunktgesteuerte Einstellungen](https://code.claude.com/docs/de/managed-settings.md#delivery-mechanisms), die über MDM oder `managed-settings.json` bereitgestellt werden, sind nicht betroffen. Zu den zurückgehaltenen Kategorien gehören:


221 * Keine davon fällt auf einen strengeren Wert zurück.230 * Keine davon fällt auf einen strengeren Wert zurück.

222 * Die Payload enthält einen anderen Schlüssel als diese beiden Aufbewahrungsschlüssel.231 * Die Payload enthält einen anderen Schlüssel als diese beiden Aufbewahrungsschlüssel.

223 232 

224 Der Hinweis beim Start, `/status` und `claude doctor` melden dann den [fehlgeschlagenen Ladevorgang](https://code.claude.com/docs/de/errors.md#remote-managed-settings-failed-to-load) mit der Ursache `no setting in the server response could be applied as written`, und dieser Eintrag gibt an, mit welcher Richtlinie die Sitzung läuft. Clients, die einen [Fail-Closed-Start erzwingen](#enforce-fail-closed-startup), beenden sich stattdessen beim Start.233 Der Hinweis beim Start, `/status` und `claude doctor` melden dann den [fehlgeschlagenen Ladevorgang](https://code.claude.com/docs/de/errors.md#remote-managed-settings-failed-to-load) mit der Ursache `no setting in the server response could be applied as written`, und dieser Eintrag gibt an, mit welcher Richtlinie die Sitzung läuft. Clients, die einen [Fail-Closed-Start erzwingen](#enforce-fail-closed-startup), beenden sich stattdessen beim Start. Wenn der Start mit einer Meldung abbricht, dass Ihre Organisation ihre Einstellungen `before a session can start` benötigt, lesen Sie [Claude Code konnte die Einstellungen Ihrer Organisation nicht laden](https://code.claude.com/docs/de/errors.md#couldnt-load-your-organizations-settings).

225* Der [Dialog zur Sicherheitsgenehmigung](#security-approval-dialogs) bewertet die bereinigte Payload, sodass ein entfernter ungültiger Eintrag nie zur Genehmigung angezeigt und nie ausgeführt wird.234* Der [Dialog zur Sicherheitsgenehmigung](#security-approval-dialogs) bewertet die bereinigte Payload, sodass ein entfernter ungültiger Eintrag nie zur Genehmigung angezeigt und nie ausgeführt wird.

226 235 

227Um Probleme bei der Bereitstellung zu debuggen, führen Sie `claude --debug-file <path>` aus und durchsuchen Sie das Log nach `Remote settings`. Validieren Sie eine Änderung der Payload mit `claude doctor` auf einem Testrechner, bevor Sie sie in der Organisation ausrollen.236Um Probleme bei der Bereitstellung zu debuggen, führen Sie `claude --debug-file <path>` aus und durchsuchen Sie das Log nach `Remote settings`. Validieren Sie eine Änderung der Payload mit `claude doctor` auf einem Testrechner, bevor Sie sie in der Organisation ausrollen.

228 237 

229### Fail-Closed-Start erzwingen238### Fail-Closed-Start erzwingen

230 239 

231Wenn der Abruf der Remote-Einstellungen beim Start fehlschlägt, fährt die CLI standardmäßig mit den Einstellungen aus dem letzten erfolgreichen Abruf fort, mit Ausnahme der [Werte, die Claude Code zurückhält](#fetch-and-caching-behavior), bis ein Abruf erfolgreich ist. Auf einem Rechner, der sie noch nie abgerufen hat, fährt die CLI ohne servergesteuerte Einstellungen fort und wendet weiterhin alle [endpunktgesteuerten Einstellungen](https://code.claude.com/docs/de/managed-settings.md#delivery-mechanisms) auf dem Gerät an.240Wenn der Abruf der Remote-Einstellungen beim Start fehlschlägt, fährt die CLI standardmäßig mit den Einstellungen fort, die beim letzten erfolgreichen Abruf zwischengespeichert wurden. Die [Werte, die Claude Code zurückhält](#fetch-and-caching-behavior), bleiben zurückgehalten, bis ein Abruf erfolgreich ist. Auf einem Rechner, der sie noch nie abgerufen hat, fährt die CLI ohne servergesteuerte Einstellungen fort und wendet weiterhin alle [endpunktgesteuerten Einstellungen](https://code.claude.com/docs/de/managed-settings.md#delivery-mechanisms) auf dem Gerät an. Stattdessen [kann Anthropic die Einstellungen verlangen](#fetch-and-caching-behavior).

232 241 

233Um zu verhindern, dass Clients mit zwischengespeicherten oder fehlenden servergesteuerten Einstellungen starten, setzen Sie `forceRemoteSettingsRefresh: true` in Ihren verwalteten Einstellungen.242Um zu verhindern, dass Clients mit zwischengespeicherten oder fehlenden servergesteuerten Einstellungen starten, setzen Sie `forceRemoteSettingsRefresh: true` in Ihren verwalteten Einstellungen.

234 243 


370| Benutzer löscht die zwischengespeicherte Einstellungsdatei | [Verhalten beim ersten Start](#fetch-and-caching-behavior) tritt auf |379| Benutzer löscht die zwischengespeicherte Einstellungsdatei | [Verhalten beim ersten Start](#fetch-and-caching-behavior) tritt auf |

371| Benutzer führt eine modifizierte Claude Code-Binärdatei aus | Ein Benutzer, der einen modifizierten Client ausführen kann, kann jede clientseitige Kontrolle umgehen |380| Benutzer führt eine modifizierte Claude Code-Binärdatei aus | Ein Benutzer, der einen modifizierten Client ausführen kann, kann jede clientseitige Kontrolle umgehen |

372| Benutzer führt eine ältere Claude Code-Version aus | Versionen, die vor serververwalteten Einstellungen entstanden sind, rufen diese nicht ab oder wenden sie nicht an |381| Benutzer führt eine ältere Claude Code-Version aus | Versionen, die vor serververwalteten Einstellungen entstanden sind, rufen diese nicht ab oder wenden sie nicht an |

373| API ist nicht verfügbar | Zwischengespeicherte Einstellungen werden angewendet, falls verfügbar, außer für die [Werte, die Claude Code bis zu einem erfolgreichen Fetch zurückhält](#fetch-and-caching-behavior). Ohne einen Cache erzwingt Claude Code keine serververwalteten Einstellungen, bis der nächste erfolgreiche Fetch erfolgt, und wendet weiterhin alle [endpunktverwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md#delivery-mechanisms) auf dem Gerät an. Mit `forceRemoteSettingsRefresh: true` wird die CLI stattdessen beendet, außer für [`claude auth` Unterbefehle](#enforce-fail-closed-startup). Clients, die sich über ein [Claude Apps Gateway](#platform-availability) anmelden, werden beim Start ohne diese Einstellung beendet, mit der gleichen `claude auth`-Ausnahme |382| API ist nicht verfügbar | Zwischengespeicherte Einstellungen werden angewendet, falls verfügbar. Ohne einen Cache erzwingt Claude Code keine serververwalteten Einstellungen, bis der nächste erfolgreiche Fetch erfolgt. Unter [Fetch- und Caching-Verhalten](#fetch-and-caching-behavior) sind die Ausnahmen aufgeführt, einschließlich der Fälle, in denen Anthropic die Einstellungen voraussetzt. Mit `forceRemoteSettingsRefresh: true` wird die CLI beendet, anstatt fortzufahren, außer für [`claude auth` Unterbefehle](#enforce-fail-closed-startup). Clients, die sich über ein [Claude Apps Gateway](#platform-availability) anmelden, werden beim Start ohne diese Einstellung beendet, mit der gleichen `claude auth`-Ausnahme |

374| Benutzer authentifiziert sich mit einer anderen Organisation | Einstellungen werden nicht für Konten außerhalb der verwalteten Organisation bereitgestellt, einschließlich einer Sitzung, die sich mit einem [Console-API-Schlüssel](#platform-availability) authentifiziert |383| Benutzer authentifiziert sich mit einer anderen Organisation | Einstellungen werden nicht für Konten außerhalb der verwalteten Organisation bereitgestellt, einschließlich einer Sitzung, die sich mit einem [Console-API-Schlüssel](#platform-availability) authentifiziert |

375| Benutzer konfiguriert einen [Drittanbieter-Modellprovider](#platform-availability) | Serververwaltete Einstellungen werden umgangen. Dies umfasst das Setzen von `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` oder einer nicht standardmäßigen `ANTHROPIC_BASE_URL` |384| Benutzer konfiguriert einen [Drittanbieter-Modellprovider](#platform-availability) | Serververwaltete Einstellungen werden umgangen. Dies umfasst das Setzen von `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` oder einer nicht standardmäßigen `ANTHROPIC_BASE_URL` |

376| Netzwerkverkehr wird abgefangen oder umgeleitet | Deaktivierte TLS-Validierung oder abgefangener Verkehr kann die Einstellungen ändern, die der Client erhält |385| Netzwerkverkehr wird abgefangen oder umgeleitet | Deaktivierte TLS-Validierung oder abgefangener Verkehr kann die Einstellungen ändern, die der Client erhält |

settings.md +2 −2

Details

199* **Einstellungsfehler**: eine Benutzer-, Projekt- oder lokale Datei hat ungültiges JSON oder einen Wert, den das Schema ablehnt. Am Anfang einer interaktiven Sitzung zeigt Claude Code einen Dialog, der Ihnen erlaubt, die Datei mit Claudes Hilfe zu beheben, zu beenden oder ohne die fehlerhaften Einstellungen fortzufahren.199* **Einstellungsfehler**: eine Benutzer-, Projekt- oder lokale Datei hat ungültiges JSON oder einen Wert, den das Schema ablehnt. Am Anfang einer interaktiven Sitzung zeigt Claude Code einen Dialog, der Ihnen erlaubt, die Datei mit Claudes Hilfe zu beheben, zu beenden oder ohne die fehlerhaften Einstellungen fortzufahren.

200* **Einstellungswarnung**: nur einzelne Einträge schlagen fehl, wie eine fehlerhafte Berechtigungsregel oder ein unbekannter Hook-Ereignisname. Claude Code überspringt diese Werte und behält den Rest der Datei wirksam.200* **Einstellungswarnung**: nur einzelne Einträge schlagen fehl, wie eine fehlerhafte Berechtigungsregel oder ein unbekannter Hook-Ereignisname. Claude Code überspringt diese Werte und behält den Rest der Datei wirksam.

201* **Verwaltete Einstellungen**: Claude Code erzwingt weiterhin den Rest der Datei. [Ungültige Einträge in verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md#invalid-entries-in-managed-settings) sagt, was es ablegt und welche Schlüssel auf einen strengeren Wert zurückfallen, bis Sie sie beheben. Für ein verwaltetes Einstellungsdokument, das nicht gültiges JSON ist, siehe [Verwaltetes Einstellungsdokument konnte nicht analysiert werden](https://code.claude.com/docs/de/errors.md#managed-settings-document-could-not-be-parsed).201* **Verwaltete Einstellungen**: Claude Code erzwingt weiterhin den Rest der Datei. [Ungültige Einträge in verwalteten Einstellungen](https://code.claude.com/docs/de/managed-settings.md#invalid-entries-in-managed-settings) sagt, was es ablegt und welche Schlüssel auf einen strengeren Wert zurückfallen, bis Sie sie beheben. Für ein verwaltetes Einstellungsdokument, das nicht gültiges JSON ist, siehe [Verwaltetes Einstellungsdokument konnte nicht analysiert werden](https://code.claude.com/docs/de/errors.md#managed-settings-document-could-not-be-parsed).

202* **Konfigurationsfehler**: `~/.claude.json` kann nicht analysiert werden. Claude Code kopiert die fehlerhafte Datei zu `~/.claude/backups/.claude.json.corrupted.<timestamp>` und fragt, ob Sie beenden und sie von Hand beheben oder auf die Standardkonfiguration zurücksetzen möchten; ein `-p` Lauf druckt den Fehler und beendet. Um Ihren vorherigen Status wiederherzustellen, kopieren Sie eine der fünf neuesten `.claude.json.backup.<timestamp>` Dateien in `~/.claude/backups/` zurück, die Claude Code vor dem Schreiben der Datei speichert.202* **Configuration error**: [`~/.claude.json`](https://code.claude.com/docs/de/claude-directory#ce-claude-json) kann nicht analysiert werden. Ein `claude -p`-Lauf wird beendet, und Ihre Datei bleibt unverändert. Siehe [Configuration error in \~/.claude.json](https://code.claude.com/docs/de/errors.md#configuration-error-in-claude-json), um eine frühere Kopie wiederherzustellen. Claude Code kopiert die fehlerhafte Datei nach `~/.claude/backups/.claude.json.corrupted.<timestamp>` und fragt in einer interaktiven Sitzung, ob Sie beenden und sie beheben oder auf die Standardkonfiguration zurücksetzen möchten. Wenn die Datei leer ist und keine Sicherung zum Wiederherstellen vorhanden ist, startet Claude Code mit Standardeinstellungen.

203 203 

204Nachdem Sie fortfahren, führen Sie `/status` aus, um die betroffenen Dateien zu sehen, und `claude doctor` für die Details jedes Fehlers.204Nachdem Sie fortfahren, führen Sie `/status` aus, um die betroffenen Dateien zu sehen, und `claude doctor` für die Details jedes Fehlers.

205 205 

206Ein `-p` Lauf zeigt keinen Dialog. Es sei denn, [ein verwaltetes Einstellungsdokument kann nicht analysiert werden](https://code.claude.com/docs/de/errors.md#managed-settings-document-could-not-be-parsed), überspringt Claude Code die fehlerhafte Datei oder Werte und fährt mit dem Rest fort, sodass nach einem `-p` Lauf, der eine Einstellung ignoriert, `claude doctor` ausführen, um zu sehen, was es abgelegt hat.206Ein `-p`-Lauf zeigt keinen Dialog. Sofern nicht [ein verwaltetes Einstellungsdokument nicht analysiert werden kann](https://code.claude.com/docs/de/errors.md#managed-settings-document-could-not-be-parsed), überspringt Claude Code eine fehlerhafte Benutzer-, Projekt- oder lokale Datei bzw. deren fehlerhafte Werte und fährt mit dem Rest fort. Führen Sie nach einem `-p`-Lauf, der eine Einstellung ignoriert, `claude doctor` in Ihrem Terminal aus, um zu sehen, was verworfen wurde.

207 207 

208## Vorrang der Einstellungen208## Vorrang der Einstellungen

209 209 

Details

40| [`autoCompactWindow`](#autocompactwindow) | Legt fest, wie voll der Kontext werden darf, bevor Claude Code [komprimiert](https://code.claude.com/docs/de/context-window.md) | Memory und Kontext | Jede Datei |40| [`autoCompactWindow`](#autocompactwindow) | Legt fest, wie voll der Kontext werden darf, bevor Claude Code [komprimiert](https://code.claude.com/docs/de/context-window.md) | Memory und Kontext | Jede Datei |

41| [`autoConnectIde`](#autoconnectide) | Verbindet sich aus einem externen Terminal automatisch mit einer laufenden [VS Code](https://code.claude.com/docs/de/vs-code.md)- oder [JetBrains](https://code.claude.com/docs/de/jetbrains.md#from-external-terminals)-IDE | Einstellungen der globalen Konfiguration | Globale Konfiguration |41| [`autoConnectIde`](#autoconnectide) | Verbindet sich aus einem externen Terminal automatisch mit einer laufenden [VS Code](https://code.claude.com/docs/de/vs-code.md)- oder [JetBrains](https://code.claude.com/docs/de/jetbrains.md#from-external-terminals)-IDE | Einstellungen der globalen Konfiguration | Globale Konfiguration |

42| [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Wartet in der geöffneten Sitzung und [setzt die Aufgabe automatisch fort](https://code.claude.com/docs/de/interactive-mode.md#wait-for-a-usage-limit-to-reset), nachdem ein claude.ai-Nutzungslimit zurückgesetzt wurde | Oberfläche und Terminal | Benutzer oder verwaltet |42| [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Wartet in der geöffneten Sitzung und [setzt die Aufgabe automatisch fort](https://code.claude.com/docs/de/interactive-mode.md#wait-for-a-usage-limit-to-reset), nachdem ein claude.ai-Nutzungslimit zurückgesetzt wurde | Oberfläche und Terminal | Benutzer oder verwaltet |

43| [`autoInstallIdeExtension`](#autoinstallideextension) | Deaktiviert die automatische Installation der [IDE-Erweiterung](https://code.claude.com/docs/de/vs-code.md#install-the-extension) aus einem VS Code-Terminal heraus | Einstellungen der globalen Konfiguration | Globale Konfiguration |43| [`autoInstallIdeExtension`](#autoinstallideextension) | Erlaubt `/ide`, die [IDE-Erweiterung](https://code.claude.com/docs/de/vs-code.md#install-the-extension) aus einem externen Terminal zu installieren | Einstellungen der globalen Konfiguration | Globale Konfiguration |

44| [`autoMemoryDirectory`](#automemorydirectory) | Speichert [Auto-Memory](https://code.claude.com/docs/de/memory.md#auto-memory) in einem Verzeichnis Ihrer Wahl | Memory und Kontext | Jede Datei |44| [`autoMemoryDirectory`](#automemorydirectory) | Speichert [Auto-Memory](https://code.claude.com/docs/de/memory.md#auto-memory) in einem Verzeichnis Ihrer Wahl | Memory und Kontext | Jede Datei |

45| [`autoMemoryEnabled`](#automemoryenabled) | Schaltet [Auto-Memory](https://code.claude.com/docs/de/memory.md#auto-memory) aus oder ein | Memory und Kontext | Jede Datei |45| [`autoMemoryEnabled`](#automemoryenabled) | Schaltet [Auto-Memory](https://code.claude.com/docs/de/memory.md#auto-memory) aus oder ein | Memory und Kontext | Jede Datei |

46| [`autoMode`](#automode) | Fügt dem Klassifikator des [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) eigene allow- und deny-Regeln hinzu | Berechtigungseinstellungen | Benutzer oder verwaltet |46| [`autoMode`](#automode) | Fügt dem Klassifikator des [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) eigene allow- und deny-Regeln hinzu | Berechtigungseinstellungen | Benutzer oder verwaltet |


139| [`outputStyle`](#outputstyle) | Ändert Claudes Rolle, Ton und Ausgabeformat mit einem [Ausgabestil](https://code.claude.com/docs/de/output-styles.md) | Modell und Antworten | Jede Datei |139| [`outputStyle`](#outputstyle) | Ändert Claudes Rolle, Ton und Ausgabeformat mit einem [Ausgabestil](https://code.claude.com/docs/de/output-styles.md) | Modell und Antworten | Jede Datei |

140| [`parentSettingsBehavior`](#parentsettingsbehavior) | Wendet Einschränkungen, die ein [SDK- oder IDE-Host](https://code.claude.com/docs/de/managed-settings.md#let-an-embedding-host-add-policy) übergibt, an oder verwirft sie, wenn Sie [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereitstellen | Enterprise und verwaltete Einstellungen | Verwaltet |140| [`parentSettingsBehavior`](#parentsettingsbehavior) | Wendet Einschränkungen, die ein [SDK- oder IDE-Host](https://code.claude.com/docs/de/managed-settings.md#let-an-embedding-host-add-policy) übergibt, an oder verwirft sie, wenn Sie [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) bereitstellen | Enterprise und verwaltete Einstellungen | Verwaltet |

141| [`permissionExplainerEnabled`](#permissionexplainerenabled) | In v2.1.257 entfernt, zusammen mit der `Ctrl+E`-Befehlserklärung in Shell-Berechtigungsabfragen | Einstellungen der globalen Konfiguration | Globale Konfiguration |141| [`permissionExplainerEnabled`](#permissionexplainerenabled) | In v2.1.257 entfernt, zusammen mit der `Ctrl+E`-Befehlserklärung in Shell-Berechtigungsabfragen | Einstellungen der globalen Konfiguration | Globale Konfiguration |

142| [`permissions`](#permissions) | Legt allow-, ask- und deny-Regeln sowie den anfänglichen [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) fest | Berechtigungseinstellungen | Jede Datei |142| [`permissions`](#permissions) | Legt allow-, ask- und deny-Regeln sowie den Standard-[Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) fest | Berechtigungseinstellungen | Jede Datei |

143| [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Gewährt Claude Dateizugriff auf [Verzeichnisse außerhalb des aktuellen](https://code.claude.com/docs/de/permissions.md#working-directories) | Berechtigungseinstellungen | Jede Datei |143| [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Gewährt Claude Dateizugriff auf [Verzeichnisse außerhalb des aktuellen](https://code.claude.com/docs/de/permissions.md#working-directories) | Berechtigungseinstellungen | Jede Datei |

144| [`permissions.allow`](#permissions-allow) | Genehmigt aufgeführte [Tool-Verwendungen](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax) ohne Nachfrage | Berechtigungseinstellungen | Jede Datei |144| [`permissions.allow`](#permissions-allow) | Genehmigt aufgeführte [Tool-Verwendungen](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax) ohne Nachfrage | Berechtigungseinstellungen | Jede Datei |

145| [`permissions.ask`](#permissions-ask) | Fragt vor aufgeführten [Tool-Verwendungen](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax) immer nach | Berechtigungseinstellungen | Jede Datei |145| [`permissions.ask`](#permissions-ask) | Fragt vor aufgeführten [Tool-Verwendungen](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax) immer nach | Berechtigungseinstellungen | Jede Datei |

146| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Lässt die Datei-Tools in jedem Berechtigungsmodus Lesezugriffe außerhalb der [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories) verweigern | Berechtigungseinstellungen | Jede Datei |146| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Lässt die Datei-Tools in jedem Berechtigungsmodus Lesezugriffe außerhalb der [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories) verweigern | Berechtigungseinstellungen | Jede Datei |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Lässt die Tools `Write`, `Edit` und `NotebookEdit` in jedem Berechtigungsmodus Pfade außerhalb der [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories) verweigern, abgesehen von [einigen Dateien von Claude Code selbst](#what-the-write-block-refuses-and-what-stays-writable) | Berechtigungseinstellungen | Jede Datei |147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Lässt die Tools `Write`, `Edit` und `NotebookEdit` in jedem Berechtigungsmodus Pfade außerhalb der [Arbeitsverzeichnisse](https://code.claude.com/docs/de/permissions.md#working-directories) verweigern, abgesehen von [einigen Dateien von Claude Code selbst](#what-the-write-block-refuses-and-what-stays-writable) | Berechtigungseinstellungen | Jede Datei |

148| [`permissions.defaultMode`](#permissions-defaultmode) | Legt den [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) fest, in dem neue Sitzungen starten | Berechtigungseinstellungen | Jede Datei |148| [`permissions.defaultMode`](#permissions-defaultmode) | Legt den Standard-[Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) für neue Sitzungen fest | Berechtigungseinstellungen | Jede Datei |

149| [`permissions.deny`](#permissions-deny) | Blockiert aufgeführte [Tool-Verwendungen](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax), einschließlich des Lesens von Dateien mit Geheimnissen | Berechtigungseinstellungen | Jede Datei |149| [`permissions.deny`](#permissions-deny) | Blockiert aufgeführte [Tool-Verwendungen](https://code.claude.com/docs/de/permissions.md#permission-rule-syntax), einschließlich des Lesens von Dateien mit Geheimnissen | Berechtigungseinstellungen | Jede Datei |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Verhindert, dass jemand in den [bypassPermissions-Modus](https://code.claude.com/docs/de/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) wechselt | Berechtigungseinstellungen | Jede Datei |150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Verhindert, dass jemand in den [bypassPermissions-Modus](https://code.claude.com/docs/de/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) wechselt | Berechtigungseinstellungen | Jede Datei |

151| [`plansDirectory`](#plansdirectory) | Legt fest, wohin der [Plan-Modus](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode) Plandateien schreibt | Memory und Kontext | Jede Datei |151| [`plansDirectory`](#plansdirectory) | Legt fest, wohin der [Plan-Modus](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode) Plandateien schreibt | Memory und Kontext | Jede Datei |


804 804 

805## Berechtigungseinstellungen805## Berechtigungseinstellungen

806 806 

807Entscheiden Sie, was Claude ohne Nachfrage tun kann, in welchem Berechtigungsmodus eine Sitzung startet, und was der Klassifikator des Auto-Modus zulässt. Informationen zur Regelsyntax und zum Berechtigungsmodell finden Sie unter [Berechtigungen konfigurieren](https://code.claude.com/docs/de/permissions.md).807Entscheiden Sie, was Claude ohne Nachfrage tun kann, welcher Standard-Berechtigungsmodus für neue Sitzungen gilt und was der Klassifikator des Auto-Modus zulässt. Informationen zur Regelsyntax und zum Berechtigungsmodell finden Sie unter [Berechtigungen konfigurieren](https://code.claude.com/docs/de/permissions.md).

808 808 

809### `allowManagedPermissionRulesOnly`809### `allowManagedPermissionRulesOnly`

810 810 


899 899 

900### `permissions`900### `permissions`

901 901 

902Steuern Sie, welche Tools Claude ohne Nachfrage verwenden kann, bei welchen immer nachgefragt wird und welche blockiert sind, und legen Sie den [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) fest, in dem eine Sitzung startet. Jeder `permissions.*`-Schlüssel unten verschachtelt sich unter diesem Objekt.902Steuern Sie, welche Tools Claude ohne Nachfrage verwenden kann, bei welchen nachgefragt wird und welche blockiert sind. Legen Sie außerdem den Standard-[Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) für neue Sitzungen fest. Jeder `permissions.*`-Schlüssel unten verschachtelt sich unter diesem Objekt.

903 903 

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

905* **Typ**: Objekt mit `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` und `disableAutoMode`905* **Typ**: Objekt mit `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` und `disableAutoMode`


1137 1137 

1138### `permissions.defaultMode`1138### `permissions.defaultMode`

1139 1139 

1140Legen Sie den [Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) fest, in dem neue Sitzungen starten. Wenn Sie ihn nicht gesetzt lassen, starten Sitzungen im [integrierten Standard](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) für Ihre Oberfläche.1140Legen Sie den Standard-[Berechtigungsmodus](https://code.claude.com/docs/de/permission-modes.md) für neue Sitzungen fest. Wenn Sie ihn nicht setzen, gilt der [integrierte Standard](https://code.claude.com/docs/de/permission-modes.md#which-mode-a-session-starts-in) für Ihre Oberfläche.

1141 1141 

1142* **Geltungsbereich**: [`Any file`](#scopes). `auto` und `bypassPermissions` werden nicht aus Projekt- oder lokalen Einstellungen wirksam, daher setzen Sie sie stattdessen in `~/.claude/settings.json`. Vor v2.1.257 wurde `bypassPermissions` aus jeder Datei wirksam. Für Konversationen, die die VS Code-Erweiterung startet, liest Claude Code nur Benutzer-, verwaltete und `--settings`-Werte.1142* **Geltungsbereich**: [`Any file`](#scopes). `auto` und `bypassPermissions` werden nicht aus Projekt- oder lokalen Einstellungen wirksam, daher setzen Sie sie stattdessen in `~/.claude/settings.json`. Vor v2.1.257 wurde `bypassPermissions` aus jeder Datei wirksam. Für Konversationen, die die VS Code-Erweiterung startet, liest Claude Code nur Benutzer-, verwaltete und `--settings`-Werte.

1143* **Typ**: Zeichenfolge, eine von:1143* **Typ**: Zeichenfolge, eine von:


1267 1267 

1268### `sandbox.failIfUnavailable`1268### `sandbox.failIfUnavailable`

1269 1269 

1270Lassen Sie Claude Code beim Start mit einem Fehler beenden, wenn `sandbox.enabled` `true` ist, die Sandbox aber nicht starten kann, weil eine Abhängigkeit fehlt oder die Plattform nicht unterstützt wird. Ohne diesen Schlüssel führt Claude Code Befehle ohne Sandbox aus. Verwaltete Bereitstellungen, die Sandboxing als Sicherheitsschranke erfordern, können diese Einstellung verwenden.1270Lassen Sie Claude Code beim Start mit einem Fehler beenden, wenn `sandbox.enabled` auf `true` steht, die Sandbox aber nicht starten kann, weil die Plattform sie nicht unterstützt oder die Abhängigkeitsprüfung fehlschlägt. Ohne diesen Schlüssel führt Claude Code Befehle ohne Sandbox aus. Verwaltete Bereitstellungen, die Sandboxing als Sicherheitsschranke vorschreiben, können diese Einstellung verwenden.

1271 1271 

1272Auf einer Plattform, die die Sandbox nicht unterstützt, startet Claude Code nicht, wenn dieser Schlüssel aktiviert ist. Siehe [Enforce sandboxing with managed settings](https://code.claude.com/docs/de/sandboxing.md#enforce-sandboxing-with-managed-settings).1272Auf einer Plattform, die die Sandbox nicht unterstützt, startet Claude Code nicht, wenn dieser Schlüssel aktiviert ist. Siehe [Enforce sandboxing with managed settings](https://code.claude.com/docs/de/sandboxing.md#enforce-sandboxing-with-managed-settings).

1273 1273 


5087 5087 

5088### `sshHostCommands`5088### `sshHostCommands`

5089 5089 

5090Fügen Sie der [Desktop](https://code.claude.com/docs/de/desktop.md#create-an-ssh-connection-from-a-command)-Umgebungsauswahl SSH-Verbindungen hinzu, deren Host von einem Befehl stammt. Wenn Sie eine Verbindung erstellen oder ihren Host ersetzen, führt Desktop den Befehl des Eintrags auf Ihrem Computer aus und verbindet sich mit dem Host, den der Befehl ausgibt. Erfordert Claude Desktop v3.6556.0 oder später unter macOS oder Linux, angemeldet mit einem Claude-Konto.5090Fügen Sie der [Desktop](https://code.claude.com/docs/de/desktop.md#create-an-ssh-connection-from-a-command)-Umgebungsauswahl SSH-Verbindungen hinzu, deren Host von einem Befehl stammt. Wenn Sie eine Verbindung erstellen oder eine weitere Maschine dafür erstellen, führt Desktop den Befehl des Eintrags auf Ihrem Computer aus und verbindet sich mit dem Host, den der Befehl ausgibt.

5091 

5092Erfordert Claude Desktop v3.6556.0 oder später unter macOS oder Linux bzw. v4.16336.0 oder später unter Windows, angemeldet mit einem Claude-Konto. Unter Windows muss Desktop außerdem [über den OpenSSH-Client verbinden](https://code.claude.com/docs/de/desktop.md#use-your-ssh-configuration).

5091 5093 

5092* **Geltungsbereich**: [`User or managed`](#scopes). Nur die Desktop-App liest diesen Schlüssel. Sie liest verwaltete Einträge aus [einer verwalteten Einstellungsdatei oder MDM-Richtlinie](https://code.claude.com/docs/de/desktop.md#distribute-commands-to-your-team) auf dem Computer und ignoriert den Schlüssel in [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md).5094* **Geltungsbereich**: [`User or managed`](#scopes). Nur die Desktop-App liest diesen Schlüssel. Sie liest verwaltete Einträge aus [einer verwalteten Einstellungsdatei oder MDM-Richtlinie](https://code.claude.com/docs/de/desktop.md#distribute-commands-to-your-team) auf dem Computer und ignoriert den Schlüssel in [servergesteuerten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md).

5093* **Typ**: Array von Objekten, jedes mit erforderlichen `id`, `name` und `command` und optionalen `sshIdentityFile` und `startDirectory`. Desktop startet `command` ohne Shell, daher [schreiben Sie ihn als Programm mit einfachen Argumenten](https://code.claude.com/docs/de/desktop.md#write-the-command).5095* **Typ**: Array von Objekten, jedes mit erforderlichen `id`, `name` und `command` und optionalen `sshIdentityFile` und `startDirectory`. Desktop liest `command` nicht als Shell-Syntax, daher funktionieren Pipes und Variablen nicht: [Schreiben Sie ihn als Programm mit seinen Argumenten](https://code.claude.com/docs/de/desktop.md#write-the-command).

5094* **Standard**: nicht gesetzt5096* **Standard**: nicht gesetzt

5095 5097 

5096Dieses Beispiel fügt eine Verbindung namens `Dev box` hinzu, wobei `acme-dev create` für Ihr eigenes Tool steht:5098Dieses Beispiel fügt eine Verbindung namens `Dev box` hinzu, wobei `acme-dev create` für Ihr eigenes Tool steht:


5107}5109}

5108```5110```

5109 5111 

5112Unter Windows funktioniert ein bloßer Name wie `acme-dev` nicht, daher [beginnen Sie den Befehl mit dem vollständigen Pfad des Programms](https://code.claude.com/docs/de/desktop.md#write-the-command-on-windows).

5113 

5110Vor Claude Code v2.1.307 lehnte das Edit-Tool eine Änderung, die diesen Schlüssel zu einer gültigen Einstellungsdatei hinzufügte, mit dem Fehler `Unrecognized field: sshHostCommands` ab. Fügen Sie den Schlüssel bei diesen Versionen stattdessen in einem Texteditor hinzu; Claude Code lädt eine Datei, die den Schlüssel enthält. In Desktop ist die [Claude Code-Version der Code-Registerkarte](https://code.claude.com/docs/de/desktop.md#claude-code-version-in-the-code-tab) maßgeblich, nicht die Ihres Terminals.5114Vor Claude Code v2.1.307 lehnte das Edit-Tool eine Änderung, die diesen Schlüssel zu einer gültigen Einstellungsdatei hinzufügte, mit dem Fehler `Unrecognized field: sshHostCommands` ab. Fügen Sie den Schlüssel bei diesen Versionen stattdessen in einem Texteditor hinzu; Claude Code lädt eine Datei, die den Schlüssel enthält. In Desktop ist die [Claude Code-Version der Code-Registerkarte](https://code.claude.com/docs/de/desktop.md#claude-code-version-in-the-code-tab) maßgeblich, nicht die Ihres Terminals.

5111 5115 

5112## Authentifizierung und Anbieter5116## Authentifizierung und Anbieter


5583 5587 

5584Blockieren Sie den CLI-Start, bis Claude Code [vom Server verwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) neu abgerufen hat. Wenn der Abruf fehlschlägt, wird Claude Code beendet, anstatt mit zwischengespeicherten oder ohne Einstellungen fortzufahren. Setzen Sie dies, wenn Ihre Umgebung nicht einmal ein kurzes Fenster akzeptieren kann, in dem eine Sitzung ohne ihre verwaltete Richtlinie ausgeführt wird.5588Blockieren Sie den CLI-Start, bis Claude Code [vom Server verwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) neu abgerufen hat. Wenn der Abruf fehlschlägt, wird Claude Code beendet, anstatt mit zwischengespeicherten oder ohne Einstellungen fortzufahren. Setzen Sie dies, wenn Ihre Umgebung nicht einmal ein kurzes Fenster akzeptieren kann, in dem eine Sitzung ohne ihre verwaltete Richtlinie ausgeführt wird.

5585 5589 

5586Wenn der Schlüssel nicht gesetzt ist, blockiert Claude Code den Start nicht beim Abruf, obwohl es beim Anmelden des Entwicklers beim Start bis zu fünf Sekunden auf den Abruf wartet. Eine Cloud-Gateway-Sitzung wartet immer und wird beendet, wenn das Gateway nicht erreichbar ist.5590Wenn der Schlüssel nicht gesetzt ist, blockiert Claude Code den Start nicht beim Abruf, obwohl es beim Anmelden des Entwicklers beim Start bis zu fünf Sekunden auf den Abruf wartet. [Anthropic kann die Einstellungen verlangen](https://code.claude.com/docs/de/server-managed-settings.md#fetch-and-caching-behavior), was einen Start ohne sie tatsächlich blockiert. Eine Cloud gateway-Sitzung wartet und wird beendet, wenn das Gateway nicht erreichbar ist.

5587 5591 

5588* **Bereich**: [`Managed`](#scopes). Claude Code berücksichtigt ein `true` aus jeder admin-kontrollierten verwalteten Quelle, auch wenn es nicht die höchste Prioritätsquelle ist.5592* **Bereich**: [`Managed`](#scopes). Claude Code berücksichtigt ein `true` aus jeder admin-kontrollierten verwalteten Quelle, auch wenn es nicht die höchste Prioritätsquelle ist.

5589* **Typ**: Boolean5593* **Typ**: Boolean

5590 * `true`: Claude Code blockiert den Start, bis er vom Server verwaltete Einstellungen neu abgerufen hat, und wird beendet, wenn der Abruf fehlschlägt5594 * `true`: Claude Code blockiert den Start, bis er vom Server verwaltete Einstellungen neu abgerufen hat, und wird beendet, wenn der Abruf fehlschlägt

5591 * `false`: Claude Code blockiert den Start nicht beim Abruf, obwohl es bei einem Start mit Anmeldung bis zu fünf Sekunden auf den Abruf wartet5595 * `false`: Sofern Anthropic die Einstellungen nicht verlangt, blockiert Claude Code den Start nicht beim Abruf, obwohl es bei einem Start mit Anmeldung bis zu fünf Sekunden auf den Abruf wartet

5592* **Standard**: `false`5596* **Standard**: `false`

5593 5597 

5594```json managed-settings.json theme={null}5598```json managed-settings.json theme={null}


5823 5827 

5824### `autoInstallIdeExtension`5828### `autoInstallIdeExtension`

5825 5829 

5826Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie Claude Code von einem VS Code-Terminal aus ausführen. Erscheint in `/config` als **Auto-Install IDE-Erweiterung**, wenn Sie Claude Code innerhalb eines VS Code- oder JetBrains-Terminals ausführen.5830Lassen Sie [`/ide`](https://code.claude.com/docs/de/commands) die Claude Code IDE-Erweiterung in einer laufenden Instanz von VS Code, Cursor oder Devin Desktop installieren, wenn Sie den Befehl von einem externen Terminal aus ausführen. Claude Code installiert die Erweiterung nicht beim Start. Erscheint in `/config` als **Auto-Install IDE-Erweiterung**, wenn Sie Claude Code innerhalb eines VS Code- oder JetBrains-Terminals ausführen.

5827 5831 

5828* **Geltungsbereich**: [`Global config`](#scopes)5832* **Geltungsbereich**: [`Global config`](#scopes)

5829* **Typ**: Boolean5833* **Typ**: Boolean

5830 * `true`: Claude Code installiert die IDE-Erweiterung automatisch, wenn Sie es von einem VS Code-Terminal aus ausführen5834 * `true`: `/ide` installiert die Erweiterung

5831 * `false`: Claude Code installiert die Erweiterung nicht automatisch5835 * `false`: `/ide` installiert die Erweiterung nicht

5832* **Standard**: `true`5836* **Standard**: `true`

5833* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/de/env-vars) auf `1` gesetzt überspringt die Installation für eine Sitzung, auch wenn dieser Schlüssel `true` ist5837* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/de/env-vars) auf `1` gesetzt überspringt die Installation für eine Sitzung, auch wenn dieser Schlüssel `true` ist

5834 5838 

skills.md +1 −1

Details

404| `allowed-tools` | Nein | Tools, die Claude ohne Genehmigung während des Turns verwenden kann, der diese Fähigkeit aufruft. Die Genehmigung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. Siehe [Tools für eine Fähigkeit vorab genehmigen](#pre-approve-tools-for-a-skill). |404| `allowed-tools` | Nein | Tools, die Claude ohne Genehmigung während des Turns verwenden kann, der diese Fähigkeit aufruft. Die Genehmigung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. Siehe [Tools für eine Fähigkeit vorab genehmigen](#pre-approve-tools-for-a-skill). |

405| `disallowed-tools` | Nein | Tools, die aus Claudes verfügbarem Pool entfernt werden, während diese Fähigkeit aktiv ist. Verwenden Sie für autonome Fähigkeiten, die niemals bestimmte Tools aufrufen sollten, z. B. `AskUserQuestion` für eine Hintergrundschleife. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. Die Einschränkung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. Wie Ablehnungsregeln kann das Feld [`EndConversation`](https://code.claude.com/docs/de/tools-reference#endconversation-tool-behavior) nicht entfernen, während ein anderes Tool verfügbar bleibt. |405| `disallowed-tools` | Nein | Tools, die aus Claudes verfügbarem Pool entfernt werden, während diese Fähigkeit aktiv ist. Verwenden Sie für autonome Fähigkeiten, die niemals bestimmte Tools aufrufen sollten, z. B. `AskUserQuestion` für eine Hintergrundschleife. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. Die Einschränkung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. Wie Ablehnungsregeln kann das Feld [`EndConversation`](https://code.claude.com/docs/de/tools-reference#endconversation-tool-behavior) nicht entfernen, während ein anderes Tool verfügbar bleibt. |

406| `model` | Nein | Modell, das verwendet werden soll, wenn diese Fähigkeit aktiv ist. Die Außerkraftsetzung gilt für den Rest des aktuellen Turns und wird nicht in den Einstellungen gespeichert; das Sitzungsmodell wird bei Ihrer nächsten Eingabeaufforderung fortgesetzt. Akzeptiert die gleichen Werte wie [`/model`](https://code.claude.com/docs/de/model-config), oder `inherit`, um das aktive Modell beizubehalten. Ein Wert, der durch die [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation ausgeschlossen ist, wird nicht verwendet und die Sitzung behält ihr aktuelles Modell. Im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) und im [Plan-Modus, während der Klassifizierer Befehle überprüft](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode), wird ein Modell, das der Auto-Modus nicht unterstützt, auch nicht verwendet, und die Sitzung behält ihr aktuelles Modell. Mit `context: fork` setzt der Wert stattdessen das [Modell des verzweigten Subagents](#run-skills-in-a-subagent) und ein ausgeschlossener Wert folgt den [gleichen Regeln wie eine Subagent-Modellüberschreibung](https://code.claude.com/docs/de/model-config.md#restrict-model-selection). |406| `model` | Nein | Modell, das verwendet werden soll, wenn diese Fähigkeit aktiv ist. Die Außerkraftsetzung gilt für den Rest des aktuellen Turns und wird nicht in den Einstellungen gespeichert; das Sitzungsmodell wird bei Ihrer nächsten Eingabeaufforderung fortgesetzt. Akzeptiert die gleichen Werte wie [`/model`](https://code.claude.com/docs/de/model-config), oder `inherit`, um das aktive Modell beizubehalten. Ein Wert, der durch die [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation ausgeschlossen ist, wird nicht verwendet und die Sitzung behält ihr aktuelles Modell. Im [Auto-Modus](https://code.claude.com/docs/de/permission-modes.md#eliminate-prompts-with-auto-mode) und im [Plan-Modus, während der Klassifizierer Befehle überprüft](https://code.claude.com/docs/de/permission-modes.md#analyze-before-you-edit-with-plan-mode), wird ein Modell, das der Auto-Modus nicht unterstützt, auch nicht verwendet, und die Sitzung behält ihr aktuelles Modell. Mit `context: fork` setzt der Wert stattdessen das [Modell des verzweigten Subagents](#run-skills-in-a-subagent) und ein ausgeschlossener Wert folgt den [gleichen Regeln wie eine Subagent-Modellüberschreibung](https://code.claude.com/docs/de/model-config.md#restrict-model-selection). |

407| `effort` | Nein | [Effort-Stufe](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) für den Rest des aktuellen Turns. Überschreibt die Effort-Stufe der Sitzung, aber nicht die Umgebungsvariable [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/de/env-vars#variables). Mit `context: fork` setzt der Wert stattdessen die Effort-Stufe des verzweigten Subagenten. Wenn Sie das Feld weglassen, ergibt sich die Stufe aus der [Auflösungsreihenfolge für Effort](https://code.claude.com/docs/de/model-config.md#adjust-effort-level). Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. |407| `effort` | Nein | [Effort-Stufe](https://code.claude.com/docs/de/model-config.md#adjust-effort-level) für den Rest des aktuellen Turns. Überschreibt die Effort-Stufe der Sitzung, aber nicht die Umgebungsvariable [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/de/env-vars#variables). Mit `context: fork` setzt der Wert stattdessen die Effort-Stufe des verzweigten Subagenten. Wenn Sie das Feld weglassen, ergibt sich die Stufe aus der [Auflösungsreihenfolge für Effort](https://code.claude.com/docs/de/model-config.md#adjust-effort-level). Für einen Fork auf einem anderen Modell siehe [Effort-Stufe von Subagenten und Teammitgliedern](https://code.claude.com/docs/de/model-config.md#effort-level-of-subagents-and-teammates). Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. |

408| `context` | Nein | Setzen Sie auf `fork`, um in einem verzweigten Subagent-Kontext ausgeführt zu werden. Siehe [Fähigkeiten in einem Subagent ausführen](#run-skills-in-a-subagent). |408| `context` | Nein | Setzen Sie auf `fork`, um in einem verzweigten Subagent-Kontext ausgeführt zu werden. Siehe [Fähigkeiten in einem Subagent ausführen](#run-skills-in-a-subagent). |

409| `agent` | Nein | Welcher Subagent-Typ verwendet werden soll, wenn `context: fork` gesetzt ist. |409| `agent` | Nein | Welcher Subagent-Typ verwendet werden soll, wenn `context: fork` gesetzt ist. |

410| `background` | Nein | Gilt nur mit `context: fork`. Setzen Sie auf `false`, um auf das Ergebnis des verzweigten Subagenten im Turn zu warten, der den Skill aufgerufen hat, anstatt [ihn im Hintergrund auszuführen](#run-skills-in-a-subagent). Standard: `true`. |410| `background` | Nein | Gilt nur mit `context: fork`. Setzen Sie auf `false`, um auf das Ergebnis des verzweigten Subagenten im Turn zu warten, der den Skill aufgerufen hat, anstatt [ihn im Hintergrund auszuführen](#run-skills-in-a-subagent). Standard: `true`. |

Details

1264 1264 

1265Sobald der Keychain wieder beschreibbar ist, verschiebt Claude Code die Anmeldedaten beim nächsten Schreibzugriff zurück. Um dies jetzt zu erzwingen, führen Sie `/logout` und dann `/login` aus. Das Abmelden entfernt alle gespeicherten Anmeldedaten, einschließlich des Inhalts der Klartextdatei, gespeicherte MCP-Server-Anmeldungen und Plugin-Geheimnisse, daher sollten Sie damit rechnen, MCP-Server erneut zu autorisieren und Plugin-Geheimnisse danach erneut einzugeben. Das erneute Anmelden speichert Ihre Anmeldung im Keychain.1265Sobald der Keychain wieder beschreibbar ist, verschiebt Claude Code die Anmeldedaten beim nächsten Schreibzugriff zurück. Um dies jetzt zu erzwingen, führen Sie `/logout` und dann `/login` aus. Das Abmelden entfernt alle gespeicherten Anmeldedaten, einschließlich des Inhalts der Klartextdatei, gespeicherte MCP-Server-Anmeldungen und Plugin-Geheimnisse, daher sollten Sie damit rechnen, MCP-Server erneut zu autorisieren und Plugin-Geheimnisse danach erneut einzugeben. Das erneute Anmelden speichert Ihre Anmeldung im Keychain.

1266 1266 

1267#### Anmeldung schlägt bei einem Home-Verzeichnis im Netzwerk fehl

1268 

1269Wenn eine Anfrage mit `API Error: 401` fehlschlägt und Ihr [Konfigurationsverzeichnis](https://code.claude.com/docs/de/claude-directory.md) auf einem Netzwerkdateisystem liegt, prüfen Sie, ob dieses Dateisystem oder Ihr Kontingent darauf voll ist. Ohne freien Speicherplatz kann Claude Code eine neue oder erneuerte Anmeldung nicht in der Klartextdatei [`.credentials.json`](https://code.claude.com/docs/de/authentication#credential-management) speichern, und `claude auth login` kann trotzdem `Login successful.` ausgeben.

1270 

1271**1. Schaffen Sie Platz auf dem Dateisystem**

1272 

1273Löschen Sie nicht mehr benötigte Dateien auf dem Dateisystem, das `~/.claude` enthält, oder das Verzeichnis, das Sie in [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/de/env-vars) festgelegt haben.

1274 

1275**2. Melden Sie sich erneut an**

1276 

1277Führen Sie `/login` im Eingabefeld von Claude Code oder `claude auth login` in Ihrer Shell aus.

1278 

1279Vor v2.1.318 konnte Claude Code beim Speichern der Anmeldedatei auf einem vollen Netzwerkdateisystem eine noch gültige gespeicherte Anmeldung durch eine leere Datei ersetzen. Spätere Befehle meldeten dann `Not logged in`.

1280 

1267### Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen1281### Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen

1268 1282 

1269Wenn Sie Claude Code für die Verwendung eines Cloud-Anbieters konfiguriert haben und `Could not load credentials from any providers` auf Amazon Bedrock, `Could not load the default credentials` auf Google Cloud's Agent Platform oder `ChainedTokenCredential authentication failed` auf Microsoft Foundry sehen, ist Ihre Cloud-Anbieter-CLI wahrscheinlich nicht in der aktuellen Shell authentifiziert.1283Wenn Sie Claude Code für die Verwendung eines Cloud-Anbieters konfiguriert haben und `Could not load credentials from any providers` auf Amazon Bedrock, `Could not load the default credentials` auf Google Cloud's Agent Platform oder `ChainedTokenCredential authentication failed` auf Microsoft Foundry sehen, ist Ihre Cloud-Anbieter-CLI wahrscheinlich nicht in der aktuellen Shell authentifiziert.

vs-code.md +7 −2

Details

818 818 

819### CLI in VS Code ausführen819### CLI in VS Code ausführen

820 820 

821Um die CLI zu verwenden, ohne VS Code zu verlassen, drücken Sie `` Ctrl+` `` unter Windows/Linux oder `` Cmd+` `` auf dem Mac, um das integrierte Terminal zu öffnen, und führen Sie dann `claude` aus. Die CLI integriert sich automatisch in Ihre IDE, um Funktionen wie die Diff-Ansicht und das Teilen von Diagnosen bereitzustellen. Wenn Sie ein externes Terminal verwenden, führen Sie `/ide` innerhalb von Claude Code aus, um es mit VS Code zu verbinden.821Um die CLI zu verwenden, ohne VS Code zu verlassen, drücken Sie `` Ctrl+` `` unter Windows/Linux oder `` Cmd+` `` auf dem Mac, um das integrierte Terminal zu öffnen, und führen Sie dann `claude` aus. Durch das Starten von `claude` wird die Erweiterung nicht installiert. Ohne sie meldet `/ide` im integrierten Terminal „No available IDEs detected“, und `/status` zeigt die IDE als „Not connected“ an.

822 

823Um Funktionen wie die Diff-Ansicht und das Teilen von Diagnosen zu nutzen, verbinden Sie die CLI über das integrierte Terminal oder ein externes Terminal mit der Erweiterung:

824 

825* **Integriertes Terminal**: [Installieren Sie die Erweiterung](#install-the-extension) und starten Sie dann `claude`. Die CLI verbindet sich automatisch.

826* **Externes Terminal**: Führen Sie `/ide` innerhalb von Claude Code aus, um eine Verbindung zu VS Code herzustellen. Wenn VS Code ohne die Erweiterung ausgeführt wird, installiert `/ide` sie, es sei denn, Sie haben [`autoInstallIdeExtension`](https://code.claude.com/docs/de/settings-reference#autoinstallideextension) deaktiviert.

822 827 

823Durch die Installation der Erweiterung wird `claude` nicht in den PATH Ihrer Shell aufgenommen. Die Erweiterung enthält eine private Kopie der CLI für ihr Chat-Panel, aber um `claude` in einem Terminal einzugeben, ist die [eigenständige CLI-Installation](https://code.claude.com/docs/de/setup.md) erforderlich. Führen Sie die Installation einmal durch, und die Befehle auf dieser Seite, einschließlich `claude mcp add` und `claude --resume`, funktionieren in jedem Terminal. Wenn `claude` nach der Installation weiterhin nicht gefunden wird, [überprüfen Sie Ihren PATH](https://code.claude.com/docs/de/troubleshoot-install.md#verify-your-path).828Durch die Installation der Erweiterung wird `claude` nicht in den PATH Ihrer Shell aufgenommen. Die Erweiterung enthält eine private Kopie der CLI für ihr Chat-Panel, aber um `claude` in einem Terminal einzugeben, ist die [eigenständige CLI-Installation](https://code.claude.com/docs/de/setup.md) erforderlich. Führen Sie die Installation einmal durch, und die Befehle auf dieser Seite, einschließlich `claude mcp add` und `claude --resume`, funktionieren in jedem Terminal. Wenn `claude` nach der Installation weiterhin nicht gefunden wird, [überprüfen Sie Ihren PATH](https://code.claude.com/docs/de/troubleshoot-install.md#verify-your-path).

824 829 


10862. Suchen Sie nach „Claude Code“10912. Suchen Sie nach „Claude Code“

10873. Klicken Sie auf **Uninstall**10923. Klicken Sie auf **Uninstall**

1088 1093 

1089Wenn Sie `claude` in einem integrierten Terminal von VS Code ausführen, installiert Claude Code die Erweiterung automatisch neu. Damit sie deinstalliert bleibt, schalten Sie **Auto-install IDE extension** in `/config` aus oder setzen Sie [`autoInstallIdeExtension`](https://code.claude.com/docs/de/settings-reference#autoinstallideextension) auf `false`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/de/env-vars) auf `1` setzen.1094Die Erweiterung bleibt deinstalliert, wenn Sie `claude` starten. Wenn Sie `/ide` in einem externen Terminal ausführen, während VS Code läuft, installiert Claude Code sie neu. Um dies zu verhindern, setzen Sie [`autoInstallIdeExtension`](https://code.claude.com/docs/de/settings-reference#autoinstallideextension) in `~/.claude.json` auf `false` oder schalten Sie **Auto-install IDE extension** in `/config` im integrierten Terminal aus. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/de/env-vars) auf `1` setzen.

1090 1095 

1091Um zusätzlich die Daten der Erweiterung zu entfernen und alle Einstellungen zurückzusetzen, löschen Sie das Speicherverzeichnis der Erweiterung für Ihre Plattform.1096Um zusätzlich die Daten der Erweiterung zu entfernen und alle Einstellungen zurückzusetzen, löschen Sie das Speicherverzeichnis der Erweiterung für Ihre Plattform.

1092 1097