Documentation 2026-10-10 23:01 UTC to 2026-10-11 21:02 UTC

3261 Tool-Eingabetypen3261 Tool-Eingabetypen

3262</h2>3262</h2>

3263 3263 

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

3265 3265 

3266<h3 id="toolinputschemas">3266<h3 id="toolinputschemas">

3267 `ToolInputSchemas`3267 `ToolInputSchemas`

4077 Tool-Ausgabetypen4077 Tool-Ausgabetypen

4078</h2>4078</h2>

4079 4079 

4080Dokumentation von Ausgabeschemas für alle integrierten Claude Code-Tools. Diese Typen werden aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert und stellen die tatsächlichen Antwortdaten dar, die von jedem Tool zurückgegeben werden.4080Dokumentation von Ausgabeschemas für integrierte Claude Code-Tools. Diese Typen werden aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert und stellen die tatsächlichen Antwortdaten dar, die von jedem Tool zurückgegeben werden.

4081 4081 

4082<h3 id="tooloutputschemas">4082<h3 id="tooloutputschemas">

4083 `ToolOutputSchemas`4083 `ToolOutputSchemas`

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

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

302 302 

303Wenn Claude Code die Sitzung in den Hintergrund verschiebt, entweder nach etwa zehn Sekunden oder nachdem Sie `←` erneut gedrückt haben, stoppt es einen Shell-Befehl, den Claude noch im Vordergrund ausführt. Claude Code zeigt für diesen Befehl nicht den `Background this session?`-Dialog. In der Hintergrund-Sitzung hat Claude keine Aufzeichnung darüber, dass der Befehl gestartet wurde, daher führt Claude den Befehl möglicherweise erneut aus. Damit der Befehl weiterläuft, wenn die Sitzung verschoben wird, drücken Sie `Ctrl+B`, um [ihn in einen Hintergrundbefehl umzuwandeln](/docs/de/interactive-mode#background-bash-commands), solange Claude Code noch wartet.

304 

303Das Drücken von `←` erstellt die Zeile der Sitzung, auch wenn die Konversation noch keine Nachrichten hat, sodass `→` immer noch zu ihr zurückkehrt.305Das Drücken von `←` erstellt die Zeile der Sitzung, auch wenn die Konversation noch keine Nachrichten hat, sodass `→` immer noch zu ihr zurückkehrt.

304 306 

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

90 90 

91Wenn die Anfrage für Ihre Planlimits fehlschlägt, meistens weil der Nutzungs-Endpunkt Rate-Limited ist, zeigt `/usage` die letzten Nutzungsbalken an, die auf diesem Computer in den letzten 60 Minuten geladen wurden, zusammen mit einer Notiz `Showing last-known usage`, die angibt, wie lange diese Daten her sind. Drücken Sie `r`, um es erneut zu versuchen; ein erfolgreicher Versuch ersetzt die letzten bekannten Balken durch aktuelle Daten. Ohne einen Snapshot aus den letzten 60 Minuten meldet `/usage`, dass der Nutzungs-Endpunkt Rate-Limited ist, und bietet die gleiche Wiederholungsverknüpfung an. Vor v2.1.208 zeigte eine Rate-Limited-Anfrage in einer Sitzung, die noch keine Nutzung geladen hatte, immer den Fehler ohne Balken an.91Wenn die Anfrage für Ihre Planlimits fehlschlägt, meistens weil der Nutzungs-Endpunkt Rate-Limited ist, zeigt `/usage` die letzten Nutzungsbalken an, die auf diesem Computer in den letzten 60 Minuten geladen wurden, zusammen mit einer Notiz `Showing last-known usage`, die angibt, wie lange diese Daten her sind. Drücken Sie `r`, um es erneut zu versuchen; ein erfolgreicher Versuch ersetzt die letzten bekannten Balken durch aktuelle Daten. Ohne einen Snapshot aus den letzten 60 Minuten meldet `/usage`, dass der Nutzungs-Endpunkt Rate-Limited ist, und bietet die gleiche Wiederholungsverknüpfung an. Vor v2.1.208 zeigte eine Rate-Limited-Anfrage in einer Sitzung, die noch keine Nutzung geladen hatte, immer den Fehler ohne Balken an.

92 92 

93<h3 id="read-the-token-count-beside-the-spinner">

94 Lesen Sie die Token-Zahl neben dem Spinner

95</h3>

96 

97Während Claude in der Hauptkonversation arbeitet, kann die Zeile neben dem Spinner mit einer verstrichenen Zeit und einer Token-Zahl enden, wie in `Deciphering… (10m 27s · ↓ 5.5k tokens)`. Es handelt sich um eine laufend aktualisierte, ungefähre Zählung der Ausgabe, die der aktuelle Turn bisher erzeugt hat. Der Pfeil neben der Zahl zeigt nach unten, während Ausgabe eintrifft oder Tools ausgeführt werden.

98 

99* **Was sie umfasst**: Ausgabe, die der Turn erzeugt, etwa der Text und die Tool-Aufrufe, die Claude zurückstreamt, sein Thinking und die Ausgabe von Subagenten, die im [Vordergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background) laufen

100* **Was sie auslässt**: was Claude Code an das Modell sendet; Ihr Prompt, der Konversationsverlauf und der Rest Ihres Kontexts verändern sie daher nicht

101* **Wann sie zurückgesetzt wird**: zu Beginn jedes Turns und wenn Claude Code [die Konversation komprimiert](/docs/de/prompt-caching#compacting-the-conversation)

102* **Wann sie ausgeblendet bleibt**: bis Ausgabe zu kommen beginnt, wenn die Zeile zu schmal dafür ist, und im [Screenreader-Modus](/docs/de/accessibility)

103 

104Sie stimmt nicht mit den Ausgabe-Zahlen unter `Usage by model` im Session-Block von `/usage` überein, die die gesamte Sitzung statt eines einzelnen Turns addieren. Sie unterscheidet sich außerdem von der Token-Zahl, die [der ausführliche Modus hinzufügt](/docs/de/statusline#notifications-share-the-status-line-row), weil diese Zahl die Größe Ihres Kontexts misst statt der Ausgabe eines Turns.

105 

93<h3 id="analyze-your-usage-patterns">106<h3 id="analyze-your-usage-patterns">

94 Analysieren Sie Ihre Nutzungsmuster107 Analysieren Sie Ihre Nutzungsmuster

95</h3>108</h3>

98 98 

99Der abgesicherte Modus wendet immer noch verwaltete Hooks und die Einstellungsrichtlinie Ihrer Organisation an. Verwaltete Plugins, Skills, `CLAUDE.md` und MCP-Server sind ausgeschaltet.99Der abgesicherte Modus wendet immer noch verwaltete Hooks und die Einstellungsrichtlinie Ihrer Organisation an. Verwaltete Plugins, Skills, `CLAUDE.md` und MCP-Server sind ausgeschaltet.

100 100 

101Wenn das Problem im abgesicherten Modus bestehen bleibt oder Ihre Einstellungen selbst verdächtig sind, vergleichen Sie mit einer Sitzung, die nichts aus Ihrem üblichen Setup lädt. Zeigen Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) auf ein leeres Verzeichnis, um alles unter `~/.claude` zu umgehen, und starten Sie von einem Verzeichnis, das keinen `.claude`-Ordner, keine `.mcp.json` oder `CLAUDE.md` hat, damit die Projektkonfiguration auch übersprungen wird.101Wenn das Problem im abgesicherten Modus bestehen bleibt oder Ihre Einstellungen selbst verdächtig sind, starten Sie eine Sitzung ohne Ihre eigene Konfiguration und prüfen Sie, ob das Problem weiterhin auftritt.

102 102 

103```bash theme={null}103<Steps>

104cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude104 <Step title="Erstellen Sie ein leeres Verzeichnis und wechseln Sie hinein">

105```105 Erstellen Sie in Ihrer Shell, während keine Claude Code-Sitzung läuft, das Verzeichnis und wechseln Sie hinein:

106 106 

107Die saubere Sitzung hat keine Benutzer- oder Projekteinstellungen, Hooks, MCP-Server, Plugins oder Speicher. Beim ersten Start erwarten Sie die Bildschirme der Ersteinrichtung, beginnend mit der Designauswahl. Wenn Sie diese sehen, ist das saubere Konfigurationsverzeichnis wirksam. Spätere Starts mit demselben Verzeichnis überspringen diese Bildschirme, da Claude Code den Onboarding-Status dort speichert.107 <Tabs>

108 108 <Tab title="Bash oder Zsh">

109* Verwaltete Einstellungen gelten immer noch, wenn Ihre Organisation sie bereitstellt. Claude Code liest MDM-Profile, Registrierungsrichtlinien und `managed-settings.json` von Speicherorten außerhalb des Konfigurationsverzeichnisses und [ruft serververwaltete Einstellungen](/docs/de/server-managed-settings#fetch-and-caching-behavior) erneut für die saubere Sitzung ab, sobald sie Anmeldedaten hat109 ```bash theme={null}

110* Sie werden aufgefordert, sich erneut anzumelden110 mkdir -p ~/claude-clean/empty && cd ~/claude-clean/empty

111 111 ```

112Wenn das Problem hier verschwindet, liegt die Ursache irgendwo in Ihren echten `~/.claude`- oder Projekt-`.claude`-Dateien. Führen Sie sie einzeln wieder ein, indem Sie Dateien in das temporäre Verzeichnis kopieren oder von Ihrem Projekt aus starten, um herauszufinden, welche. Wenn es in der sauberen Sitzung bestehen bleibt, liegt die Ursache außerhalb Ihrer Benutzer- und Projektkonfiguration. Führen Sie `/status` aus, um zu überprüfen, ob verwaltete Einstellungen wirksam sind, suchen Sie nach [Umgebungsvariablen](/docs/de/env-vars), die Claude Code beeinflussen, und siehe dann [Troubleshooting](/docs/de/troubleshooting).112 </Tab>

113 

114 <Tab title="PowerShell">

115 ```powershell theme={null}

116 New-Item -ItemType Directory -Force "$HOME/claude-clean/empty" | Out-Null

117 Set-Location "$HOME/claude-clean/empty"

118 ```

119 </Tab>

120 </Tabs>

121 </Step>

122 

123 <Step title="Starten Sie Claude Code mit einem sauberen Konfigurationsverzeichnis">

124 Setzen Sie in derselben Shell [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) anstelle von `~/.claude` auf ein neues Verzeichnis und übergeben Sie [`--setting-sources user`](/docs/de/cli-reference#cli-flags), um die Projektkonfiguration wie `.claude/settings.json`, `CLAUDE.md` und `.mcp.json` auszuschalten:

125 

126 <Tabs>

127 <Tab title="Bash oder Zsh">

128 Die Variable gilt nur für diesen einen Start.

129 

130 ```bash theme={null}

131 CLAUDE_CONFIG_DIR=~/claude-clean/config claude --setting-sources user

132 ```

133 </Tab>

134 

135 <Tab title="PowerShell">

136 Die Variable bleibt für den Rest dieser PowerShell-Sitzung gesetzt, sodass spätere `claude`-Starts im selben Fenster weiterhin das saubere Verzeichnis verwenden. Um zu Ihrem üblichen Verzeichnis zurückzukehren, führen Sie vor dem nächsten Start `Remove-Item Env:CLAUDE_CONFIG_DIR` aus.

137 

138 ```powershell theme={null}

139 $env:CLAUDE_CONFIG_DIR = "$HOME/claude-clean/config"

140 claude --setting-sources user

141 ```

142 </Tab>

143 </Tabs>

144 

145 Beim ersten Start durchlaufen Sie erneut die Bildschirme der Ersteinrichtung – ein Zeichen dafür, dass das saubere Konfigurationsverzeichnis wirksam ist. Verwaltete Einstellungen gelten weiterhin, und [Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) werden weiterhin geladen, wenn Sie sich mit einem claude.ai-Konto anmelden.

146 </Step>

147 

148 <Step title="Reproduzieren Sie das Problem">

149 Wiederholen Sie in der sauberen Sitzung, was das Problem ausgelöst hat:

150 

151 * **Problem verschwunden**: Die Ursache liegt in Ihrer Benutzer- oder Projektkonfiguration. Kopieren Sie `~/.claude.json` und die Dateien in `~/.claude` einzeln nach `~/claude-clean/config`. Wenn keine davon das Problem zurückbringt, wechseln Sie in derselben Shell in Ihr Projektverzeichnis und starten Sie Claude Code ohne `--setting-sources user`. Führen Sie in Bash oder Zsh `CLAUDE_CONFIG_DIR=~/claude-clean/config claude` aus. In PowerShell ist die Variable noch gesetzt, führen Sie also `claude` aus.

152 * **Problem bleibt bestehen**: Die Ursache liegt außerhalb Ihrer Benutzer- und Projektkonfiguration. Führen Sie `/status` in der Sitzung aus, um nach verwalteten Einstellungen zu suchen, überprüfen Sie Ihre Shell auf [Umgebungsvariablen](/docs/de/env-vars) und lesen Sie dann [Fehlerbehebung](/docs/de/troubleshooting).

153 </Step>

154</Steps>

113 155 

114<h2 id="check-common-causes">156<h2 id="check-common-causes">

115 Überprüfen Sie häufige Ursachen157 Überprüfen Sie häufige Ursachen

127| Ein `settings.json`-Wert scheint ignoriert zu werden | Derselbe Schlüssel ist in `settings.local.json` gesetzt | `settings.local.json` überschreibt `settings.json`, und beide überschreiben `~/.claude/settings.json`. Siehe [Einstellungspriorität](/docs/de/settings#settings-precedence). |169| Ein `settings.json`-Wert scheint ignoriert zu werden | Derselbe Schlüssel ist in `settings.local.json` gesetzt | `settings.local.json` überschreibt `settings.json`, und beide überschreiben `~/.claude/settings.json`. Siehe [Einstellungspriorität](/docs/de/settings#settings-precedence). |

128| Skill erscheint nicht in `/skills` | Skill-Datei befindet sich unter `.claude/skills/name.md` statt in einem Ordner | Verwenden Sie einen Ordner mit `SKILL.md` darin: `.claude/skills/name/SKILL.md`. |170| Skill erscheint nicht in `/skills` | Skill-Datei befindet sich unter `.claude/skills/name.md` statt in einem Ordner | Verwenden Sie einen Ordner mit `SKILL.md` darin: `.claude/skills/name/SKILL.md`. |

129| Skill erscheint in `/skills`, aber Claude ruft ihn nie auf | Skill hat `disable-model-invocation: true` in seinem Frontmatter, oder seine Beschreibung stimmt nicht damit überein, wie Sie die Anfrage formulieren | Überprüfen Sie das Badge in `/skills`: Ein Label „user-only“ bedeutet, dass Claude es nicht von selbst auslöst. Siehe [Skill-Aufruf](/docs/de/skills). |171| Skill erscheint in `/skills`, aber Claude ruft ihn nie auf | Skill hat `disable-model-invocation: true` in seinem Frontmatter, oder seine Beschreibung stimmt nicht damit überein, wie Sie die Anfrage formulieren | Überprüfen Sie das Badge in `/skills`: Ein Label „user-only“ bedeutet, dass Claude es nicht von selbst auslöst. Siehe [Skill-Aufruf](/docs/de/skills). |

130| Anweisungen im Unterverzeichnis `CLAUDE.md` scheinen ignoriert zu werden | Unterverzeichnisdateien werden bei Bedarf geladen, nicht beim Sitzungsstart | Siehe [wann Unterverzeichnisdateien geladen werden](/docs/de/memory#how-claude-md-files-load). Vor v2.1.288 wurden sie nur durch das Read-Tool geladen. |172| Anweisungen im Unterverzeichnis `CLAUDE.md` scheinen ignoriert zu werden | Unterverzeichnisdateien werden bei Bedarf geladen, nicht beim Sitzungsstart | Um die `CLAUDE.md` eines Unterverzeichnisses zu laden, bitten Sie Claude, eine andere Datei in diesem Unterverzeichnis zu lesen. Siehe [wann Unterverzeichnisdateien geladen werden](/docs/de/memory#how-claude-md-files-load). |

131| Subagent ignoriert `CLAUDE.md`-Anweisungen | Die integrierten Explore- und Plan-Agenten überspringen `CLAUDE.md`. Ein benutzerdefinierter Subagent lädt es auf die gleiche Weise wie die Hauptkonversation, es sei denn, seine Definition setzt [`omitClaudeMd`](/docs/de/sub-agents#supported-frontmatter-fields) | Für Explore oder Plan wiederholen Sie die Anweisung in Ihrer delegierenden Aufforderung. Für einen Subagenten, der `omitClaudeMd` setzt, entfernen Sie das Feld. Für jeden anderen benutzerdefinierten Subagenten setzen Sie kritische Anweisungen in den Agent-Dateitext, der zur Systemaufforderung des Agenten wird. Siehe [was beim Start geladen wird](/docs/de/sub-agents#what-loads-at-startup). |173| Subagent ignoriert `CLAUDE.md`-Anweisungen | Die integrierten Explore- und Plan-Agenten überspringen `CLAUDE.md`. Ein benutzerdefinierter Subagent lädt es auf die gleiche Weise wie die Hauptkonversation, es sei denn, seine Definition setzt [`omitClaudeMd`](/docs/de/sub-agents#supported-frontmatter-fields) | Für Explore oder Plan wiederholen Sie die Anweisung in Ihrer delegierenden Aufforderung. Für einen Subagenten, der `omitClaudeMd` setzt, entfernen Sie das Feld. Für jeden anderen benutzerdefinierten Subagenten setzen Sie kritische Anweisungen in den Agent-Dateitext, der zur Systemaufforderung des Agenten wird. Siehe [was beim Start geladen wird](/docs/de/sub-agents#what-loads-at-startup). |

132| Cleanup-Logik wird am Sitzungsende nie ausgeführt | Kein `SessionEnd`-Hook konfiguriert | Fügen Sie einen `SessionEnd`-Hook in `settings.json` hinzu. Siehe die [Hook-Ereignisliste](/docs/de/hooks#hook-events). |174| Cleanup-Logik wird am Sitzungsende nie ausgeführt | Kein `SessionEnd`-Hook konfiguriert | Fügen Sie einen `SessionEnd`-Hook in `settings.json` hinzu. Siehe die [Hook-Ereignisliste](/docs/de/hooks#hook-events). |

133| MCP-Server in `.mcp.json` werden nie geladen | Datei befindet sich unter `.claude/`, oder ihre Server befinden sich unter einem Top-Level-Schlüssel `servers`, wie in VS Code's `mcp.json`, statt unter `mcpServers` | Projekt-MCP-Konfiguration geht an die Repository-Root als `.mcp.json`, nicht in `.claude/`, mit Servern unter dem Schlüssel `mcpServers`. Siehe [MCP-Konfiguration](/docs/de/mcp). |175| MCP-Server in `.mcp.json` werden nie geladen | Datei befindet sich unter `.claude/`, oder ihre Server befinden sich unter einem Top-Level-Schlüssel `servers`, wie in VS Code's `mcp.json`, statt unter `mcpServers` | Projekt-MCP-Konfiguration geht an die Repository-Root als `.mcp.json`, nicht in `.claude/`, mit Servern unter dem Schlüssel `mcpServers`. Siehe [MCP-Konfiguration](/docs/de/mcp). |

913 913 

914Jeder Eintrag erfordert `id`, `name` und `sshHost`. Die Felder `sshPort` und `sshIdentityFile` sind optional. Benutzer können auch `sshConfigs` zu ihrer eigenen `~/.claude/settings.json` hinzufügen.914Jeder Eintrag erfordert `id`, `name` und `sshHost`. Die Felder `sshPort` und `sshIdentityFile` sind optional. Benutzer können auch `sshConfigs` zu ihrer eigenen `~/.claude/settings.json` hinzufügen.

915 915 

916Wenn Sie `user@` in `sshHost` weglassen, verbindet sich Desktop als der `User`, den die `~/.ssh/config` des jeweiligen Entwicklers für den Host festlegt, oder andernfalls mit dessen Benutzernamen auf seinem eigenen Computer.

917 

916<h4 id="restrict-which-ssh-hosts-users-can-connect-to">918<h4 id="restrict-which-ssh-hosts-users-can-connect-to">

917 SSH-Hosts einschränken, mit denen Benutzer sich verbinden können919 SSH-Hosts einschränken, mit denen Benutzer sich verbinden können

918</h4>920</h4>

937 939 

938`sshHostAllowlist` wird nur aus verwalteten Einstellungen gelesen; Werte in Benutzer- oder Projekteinstellungen werden ignoriert. Nur die Claude Desktop-App berücksichtigt diese Einstellung; die Claude Code CLI und IDE-Erweiterungen lesen sie nicht, und sie beschränkt keine `ssh`-Befehle, die über das Bash-Tool ausgeführt werden. Sie regelt, mit welchen Hosts sich die Desktop-App verbindet, nicht den Netzwerk-Egress, daher kombinieren Sie sie mit den Netzwerk- oder Zero-Trust-Kontrollen Ihrer Organisation, wenn Sie eine harte Grenze benötigen.940`sshHostAllowlist` wird nur aus verwalteten Einstellungen gelesen; Werte in Benutzer- oder Projekteinstellungen werden ignoriert. Nur die Claude Desktop-App berücksichtigt diese Einstellung; die Claude Code CLI und IDE-Erweiterungen lesen sie nicht, und sie beschränkt keine `ssh`-Befehle, die über das Bash-Tool ausgeführt werden. Sie regelt, mit welchen Hosts sich die Desktop-App verbindet, nicht den Netzwerk-Egress, daher kombinieren Sie sie mit den Netzwerk- oder Zero-Trust-Kontrollen Ihrer Organisation, wenn Sie eine harte Grenze benötigen.

939 941 

942<h4 id="turn-off-local-sessions-and-distribute-ssh-connections">

943 Lokale Sitzungen ausschalten und SSH-Verbindungen verteilen

944</h4>

945 

946Um lokale Sitzungen auszuschalten und SSH-Sitzungen auf von Ihnen gewählte Hosts zu beschränken, stellen Sie [`disableDesktopLocalSessions`](/docs/de/settings-reference#disabledesktoplocalsessions), [`sshConfigs`](#pre-configure-ssh-connections-for-your-team) und [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to) gemeinsam bereit.

947 

948<Note>

949 Diese Konfiguration gilt für Benutzer, die sich mit einem Claude-Konto anmelden. Bei einem [Drittanbieter](/docs/de/third-party-integrations) sind SSH-Sitzungen standardmäßig ausgeschaltet, und das Setzen von `sshHostAllowlist` kann sie einschalten. Lesen Sie [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions), bevor Sie diese Schlüssel bereitstellen.

950</Note>

951 

952Das folgende Beispiel schaltet lokale Sitzungen aus, fügt eine Verbindung hinzu und beschränkt SSH-Sitzungen auf den Host dieser Verbindung:

953 

954```json managed-settings.json theme={null}

955{

956 "disableDesktopLocalSessions": true,

957 "sshConfigs": [

958 {

959 "id": "shared-dev-vm",

960 "name": "Shared Dev VM",

961 "sshHost": "dev.example.com"

962 }

963 ],

964 "sshHostAllowlist": ["dev.example.com"]

965}

966```

967 

968Die Schlüssel gelten für die Desktop-App. Andere Möglichkeiten, Claude Code auszuführen, bleiben davon unberührt, etwa die CLI, Cowork und Cloud-Sitzungen:

969 

970* **Die CLI**: Keiner der Schlüssel hindert einen Entwickler daran, die Claude Code CLI auf seinem eigenen Computer auszuführen

971* **Cowork**: Keiner der Schlüssel gilt für [Cowork](https://claude.com/docs/cowork/overview)-Sitzungen oder geplante Aufgaben in Cowork

972* **Cloud-Sitzungen**: Keiner der Schlüssel ändert, ob [Cloud-Sitzungen](#cloud-sessions) verfügbar sind. Um sie auszuschalten, verwenden Sie die Einstellung **Cloud sessions** unter [Admin console controls](#admin-console-controls).

973 

974Wenn Sie das Beispiel anpassen, prüfen Sie die Hostnamen und die Desktop-Version:

975 

976* **Hostnamen**: Stellen Sie sicher, dass ein Muster in `sshHostAllowlist` auf den Hostnamen jedes `sshConfigs`-Eintrags ohne `user@` passt, da sich Entwickler sonst nicht damit verbinden können. Wie Desktop einen Hostnamen abgleicht, erfahren Sie unter [SSH-Hosts einschränken, mit denen Benutzer sich verbinden können](#restrict-which-ssh-hosts-users-can-connect-to).

977* **Version**: `disableDesktopLocalSessions` erfordert Claude Desktop v1.37937.0 oder höher

978 

979Legen Sie die drei Schlüssel in einer einzigen [verwalteten Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources) ab, und zwar in der ranghöchsten, die Sie bereitstellen. Wenn Sie [serververwaltete Einstellungen](/docs/de/server-managed-settings) bereitstellen, hinterlegen Sie außerdem eine Kopie der drei Schlüssel in der ranghöchsten MDM-Richtlinie oder verwalteten Einstellungsdatei auf jedem Computer. Desktop ruft serververwaltete Einstellungen beim Start ab, und bis zu einem erfolgreichen Abruf gilt die Kopie auf dem Computer.

980 

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

982 

983<Steps>

984 <Step title="Umgebungs-Dropdown prüfen">

985 Beenden Sie Desktop, öffnen Sie es erneut und öffnen Sie dann das Umgebungs-Dropdown im Eingabefeld. **Lokal** ist ausgegraut, und **Shared Dev VM** erscheint unter **SSH**. Wenn **Lokal** weiterhin verfügbar ist, prüfen Sie die Desktop-Version, ob die Datei gültiges JSON ist und welche verwaltete Quelle der Computer liest.

986 </Step>

987 

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

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

990 </Step>

991</Steps>

992 

940<h2 id="enterprise-configuration">993<h2 id="enterprise-configuration">

941 Unternehmenskonfiguration994 Unternehmenskonfiguration

942</h2>995</h2>

256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie `1`, um alle Funktionen für Hintergrundaufgaben zu deaktivieren, einschließlich des Parameters `run_in_background` bei Bash- und Subagenten-Tools, des automatischen Verschiebens in den Hintergrund und der Tastenkombination Ctrl+B |256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie `1`, um alle Funktionen für Hintergrundaufgaben zu deaktivieren, einschließlich des Parameters `run_in_background` bei Bash- und Subagenten-Tools, des automatischen Verschiebens in den Hintergrund und der Tastenkombination Ctrl+B |

257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie `1`, damit Claude Code eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlendem oder leerem `Content-Type`-Header nicht mehr als binären Event-Stream von Amazon Bedrock behandelt. Standardmäßig nimmt Claude Code an, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort entfernt hat, und dekodiert daher den Body, sodass das Streaming weiter funktioniert. Setzen Sie dies nur für ein Gateway, das den Stream außerdem als Server-Sent Events neu ausgibt; Claude Code liest den Body ohne Header dann stattdessen als Server-Sent Events. Erfordert Claude Code v2.1.239 oder höher |257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie `1`, damit Claude Code eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlendem oder leerem `Content-Type`-Header nicht mehr als binären Event-Stream von Amazon Bedrock behandelt. Standardmäßig nimmt Claude Code an, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort entfernt hat, und dekodiert daher den Body, sodass das Streaming weiter funktioniert. Setzen Sie dies nur für ein Gateway, das den Stream außerdem als Server-Sent Events neu ausgibt; Claude Code liest den Body ohne Header dann stattdessen als Server-Sent Events. Erfordert Claude Code v2.1.239 oder höher |

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

259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie `1`, um die laufenden Hintergrund-Shell-Befehle, dynamischen Workflows und ab v2.1.198 die Hintergrund-Subagenten einer [Hintergrundsitzung](/docs/de/agent-view) zu beenden, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Beim Verschieben einer Sitzung in den Hintergrund mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) wird laufende Arbeit weiterhin übernommen, und `CLAUDE_DISABLE_ADOPT` schaltet beides aus. Erfordert Claude Code v2.1.196 oder höher |259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie `1`, um laufende Hintergrund-Shell-Befehle, dynamische Workflows und ab v2.1.198 Hintergrund-Subagenten einer [Hintergrundsitzung](/docs/de/agent-view) zu beenden, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, statt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Wenn Sie eine Sitzung mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) in den Hintergrund verschieben, wird laufende Hintergrundarbeit weiterhin übernommen, und `CLAUDE_DISABLE_ADOPT` schaltet beides aus. Erfordert Claude Code v2.1.196 oder neuer |

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

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

262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Setzen Sie `1`, um die Browser-Tools von [Claude in Chrome](/docs/de/chrome) verfügbar zu halten, während der Chrome-Abschnitt des System-Prompts und der [mitgelieferte Skill](/docs/de/skills#bundled-skills) `/claude-in-chrome` weggelassen werden. Für Hosts, die Claude Code einbetten und eigene Browser-Anleitungen bereitstellen. Erfordert Claude Code v2.1.257 oder höher |262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Setzen Sie `1`, um die Browser-Tools von [Claude in Chrome](/docs/de/chrome) verfügbar zu halten, während der Chrome-Abschnitt des System-Prompts und der [mitgelieferte Skill](/docs/de/skills#bundled-skills) `/claude-in-chrome` weggelassen werden. Für Hosts, die Claude Code einbetten und eigene Browser-Anleitungen bereitstellen. Erfordert Claude Code v2.1.257 oder höher |

4039 4039 

4040**Was zu tun ist:**4040**Was zu tun ist:**

4041 4041 

4042* Führen Sie `claude plugin marketplace remove <name>` aus. Dies deinstalliert auch die von dem Marketplace installierten Plugins und löscht ihre gespeicherten Daten4042* Um einen Marketplace zu behalten, den eine Einstellungsdatei inline mit `"source": "settings"` deklariert, benennen Sie ihn um, bevor Sie den alten Namen entfernen, denn das Entfernen des Marketplace löscht auch seinen Eintrag aus Ihren Einstellungsdateien. Claude Code v2.1.292 oder neuer listet diese Schritte in der Meldung auf:

4043* Um den Marketplace stattdessen zu behalten, warten Sie, bis sein Verwalter ihn umbenennt, und führen Sie dann `claude plugin marketplace update <name>` aus4043 1. Geben Sie in jeder Einstellungsdatei, die den Marketplace unter `extraKnownMarketplaces` aufführt, dem Schlüssel des Eintrags und seinem `source.name` einen gemeinsamen neuen Namen in reinem ASCII, der nicht wie ein offizieller Name aussieht. Wenn ein Administrator den Marketplace über die verwalteten Einstellungen Ihrer Organisation hinzufügt, führt der Administrator diesen Schritt aus

4044 2. Führen Sie `claude plugin marketplace remove <old-name>` aus, oder entfernen Sie den alten Namen auf der Registerkarte **Marketplaces** in `/plugin`. Dadurch werden auch seine Plugins deinstalliert und ihre Daten, Optionen und Geheimnisse gelöscht

4045 3. Starten Sie Claude Code erneut, im Ordner des Projekts, falls die Datei eine Projekteinstellungsdatei ist. Installieren Sie dann die Plugins aus dem umbenannten Marketplace

4046* Um einen anderen Marketplace zu behalten, warten Sie, bis sein Verwalter ihn umbenennt, und führen Sie dann `claude plugin marketplace update <name>` aus

4047* Um den Marketplace zu entfernen, führen Sie `claude plugin marketplace remove <name>` aus. Dadurch werden auch die aus dem Marketplace installierten Plugins deinstalliert und ihre Daten, Optionen und Geheimnisse gelöscht

4044* Wenn Sie den Marketplace veröffentlichen, benennen Sie ihn in Ihrer `marketplace.json` um; Benutzer aktualisieren dann den Marketplace, anstatt ihn zu entfernen4048* Wenn Sie den Marketplace veröffentlichen, benennen Sie ihn in Ihrer `marketplace.json` um; Benutzer aktualisieren dann den Marketplace, anstatt ihn zu entfernen

4045 4049 

4046<h3 id="marketplace-is-already-added-from-a-different-source">4050<h3 id="marketplace-is-already-added-from-a-different-source">

3321 WorktreeCreate3321 WorktreeCreate

3322</h3>3322</h3>

3323 3323 

3324Wird ausgeführt, wenn ein Worktree erstellt wird, sei es über `claude --worktree`, über einen [Subagenten mit `isolation: "worktree"`](/docs/de/sub-agents#choose-the-subagent-scope) oder für eine [Hintergrundsitzung](/docs/de/agent-view#how-file-edits-are-isolated), die Claude Code in einem eigenen Worktree isoliert. Standardmäßig erstellt Claude Code die isolierte Arbeitskopie mit `git worktree`. Wenn Sie einen WorktreeCreate-Hook konfigurieren, ersetzt dieser das standardmäßige Git-Verhalten, sodass Sie ein anderes Versionskontrollsystem wie SVN, Perforce oder Mercurial verwenden können.3324Wird ausgeführt, wenn Claude Code einen Worktree erstellt, etwa in diesen Fällen:

3325 

3326* Sie starten eine Sitzung mit `claude --worktree`

3327* Claude erstellt während einer Sitzung einen Worktree und wechselt mit dem Tool [`EnterWorktree`](/docs/de/tools-reference) hinein

3328* Ein [Subagent verwendet `isolation: "worktree"`](/docs/de/sub-agents#choose-the-subagent-scope)

3329* Ein [Workflow](/docs/de/workflows#migrate-many-files-in-parallel) führt einen Agenten in einem eigenen Worktree aus

3330* Claude Code isoliert eine [Hintergrundsitzung](/docs/de/agent-view#how-file-edits-are-isolated) in einem eigenen Worktree

3331* [`claude remote-control`](/docs/de/remote-control#start-a-remote-control-session) startet im `worktree`-Modus eine Sitzung in einem eigenen Worktree

3332 

3333Wenn Claude `git worktree add` über das Bash-Tool ausführt, statt `EnterWorktree` aufzurufen, wird Ihr WorktreeCreate-Hook nicht ausgeführt. Um diesen Befehl zu prüfen oder zu blockieren, fügen Sie einen [`PreToolUse`](#pretooluse)-Hook mit dem Matcher `Bash` hinzu.

3334 

3335Standardmäßig erstellt Claude Code die isolierte Arbeitskopie mit `git worktree`. Wenn Sie einen WorktreeCreate-Hook konfigurieren, ersetzt dieser das standardmäßige Git-Verhalten, sodass Sie ein anderes Versionskontrollsystem wie SVN, Perforce oder Mercurial verwenden können.

3325 3336 

3326Da der Hook das Standardverhalten vollständig ersetzt, wird [`.worktreeinclude`](/docs/de/worktrees#copy-gitignored-files-into-worktrees) nicht verarbeitet. Wenn Sie lokale Konfigurationsdateien wie `.env` in den neuen Worktree kopieren müssen, tun Sie dies in Ihrem Hook-Skript.3337Da der Hook das Standardverhalten vollständig ersetzt, wird [`.worktreeinclude`](/docs/de/worktrees#copy-gitignored-files-into-worktrees) nicht verarbeitet. Wenn Sie lokale Konfigurationsdateien wie `.env` in den neuen Worktree kopieren müssen, tun Sie dies in Ihrem Hook-Skript.

3327 3338 

3390* Sie eine interaktive [Worktree-Sitzung](/docs/de/worktrees#start-claude-in-a-worktree) beenden und sich dafür entscheiden, den Worktree zu entfernen, wenn Claude Code Sie danach fragt3401* Sie eine interaktive [Worktree-Sitzung](/docs/de/worktrees#start-claude-in-a-worktree) beenden und sich dafür entscheiden, den Worktree zu entfernen, wenn Claude Code Sie danach fragt

3391* Sie eine interaktive Worktree-Sitzung beenden, die Sie nicht [benannt](/docs/de/sessions#name-your-sessions) haben, Claude Code keine geänderten oder nicht verfolgten Dateien findet und den Worktree ohne Nachfrage entfernt3402* Sie eine interaktive Worktree-Sitzung beenden, die Sie nicht [benannt](/docs/de/sessions#name-your-sessions) haben, Claude Code keine geänderten oder nicht verfolgten Dateien findet und den Worktree ohne Nachfrage entfernt

3392* Sie eine [Hintergrundsitzung](/docs/de/agent-view#what-deleting-a-session-removes) löschen, die im Worktree läuft3403* Sie eine [Hintergrundsitzung](/docs/de/agent-view#what-deleting-a-session-removes) löschen, die im Worktree läuft

3404* Sie Claude während einer Sitzung bitten, den Worktree zu verlassen und zu entfernen, und Claude ihn mit dem Tool [`ExitWorktree`](/docs/de/tools-reference) entfernt

3405* Eine Sitzung, die [`claude remote-control`](/docs/de/remote-control#start-a-remote-control-session) im `worktree`-Modus gestartet hat, ohne Absturz endet und Claude Code in ihrem Worktree keine geänderten oder nicht verfolgten Dateien und keine neuen Commits findet

3406* Sie `claude remote-control` stoppen, während von ihm im `worktree`-Modus gestartete Sitzungen noch laufen, und Claude Code in deren Worktrees keine geänderten oder nicht verfolgten Dateien und keine neuen Commits findet

3407 

3408Wenn ein Subagent oder ein Workflow-Agent fertig ist, behält Claude Code den Worktree, den Ihr WorktreeCreate-Hook dafür erstellt hat, und führt Ihren WorktreeRemove-Hook nicht aus. Entfernen Sie diese Worktrees selbst, wenn die Arbeit erledigt ist.

3409 

3410Claude Code fragt Sie nicht, bevor Ihr Hook für einen `ExitWorktree`-Aufruf oder eine Bereinigung durch `claude remote-control` ausgeführt wird. `ExitWorktree` weigert sich, einen vom Hook erstellten Worktree zu entfernen, sofern der Aufruf nicht [`discard_changes: true`](/docs/de/agent-sdk/typescript#exitworktree) übergibt, wodurch Ihr Hook auf diesem Weg die letzte Prüfung ist.

3393 3411 

3394Claude Code verwendet Git, um nach geänderten oder nicht verfolgten Dateien zu suchen, und findet daher keine in einem Worktree, der kein Git-Checkout ist oder sich nicht in einem befindet, selbst wenn das Verzeichnis nicht committete Arbeit enthält. Prüfen Sie in Ihrem WorktreeRemove-Hook auf solche Arbeit, bevor er etwas löscht.3412Claude Code verwendet Git, um nach geänderten oder nicht verfolgten Dateien zu suchen, und findet daher keine in einem Worktree, der kein Git-Checkout ist oder sich nicht in einem befindet, selbst wenn das Verzeichnis nicht committete Arbeit enthält. Prüfen Sie in Ihrem WorktreeRemove-Hook auf solche Arbeit, bevor er etwas löscht.

3395 3413 

3396Bei Git-basierten Worktrees übernimmt Claude Code die Bereinigung automatisch mit `git worktree remove`. Wenn Sie einen WorktreeCreate-Hook konfiguriert haben, kombinieren Sie ihn mit einem WorktreeRemove-Hook, um die Bereinigung der von ihm erstellten Worktrees zu steuern:3414Bei Git-basierten Worktrees übernimmt Claude Code die Bereinigung automatisch mit `git worktree remove`. Wenn Sie einen WorktreeCreate-Hook konfiguriert haben, kombinieren Sie ihn mit einem WorktreeRemove-Hook, um die Bereinigung zu steuern:

3397 3415 

3398* **Kein WorktreeRemove-Hook**: Wenn Claude Code den Worktree beim Beenden einer Worktree-Sitzung entfernt, greift es ersatzweise auf `git worktree remove --force` für den Pfad zurück, den Ihr WorktreeCreate-Hook zurückgegeben hat, sodass ein Worktree, den Git erkennt, entfernt wird. Ein Worktree, den Git nicht erkennt, zum Beispiel einer, den Ihr Hook mit einem anderen Versionskontrollsystem als Git erstellt hat, bleibt auf der Festplatte. Was das Löschen einer [Hintergrundsitzung](/docs/de/agent-view#what-deleting-a-session-removes) mit einem vom Hook erstellten Worktree bewirkt, entnehmen Sie den Löschregeln der Agent-Ansicht.3416* **Kein WorktreeRemove-Hook**: Claude Code greift für ein Entfernen beim Beenden oder über `ExitWorktree` ersatzweise auf Git zurück und behält den Worktree, wenn `claude remote-control` bereinigt:

3417 * **Sie beenden eine Worktree-Sitzung, oder Claude ruft `ExitWorktree` auf**: Claude Code entfernt den von Ihrem WorktreeCreate-Hook zurückgegebenen Pfad so, wie `git worktree remove --force` es tun würde, sodass ein Worktree, den Git erkennt, entfernt wird. Ein Worktree, den Git nicht erkennt, zum Beispiel einer, den Ihr Hook mit einem anderen Versionskontrollsystem als Git erstellt hat, bleibt auf dem Datenträger.

3418 * **`claude remote-control` bereinigt den Worktree einer Sitzung**: Der Worktree bleibt auf dem Datenträger, und das Terminal, in dem `claude remote-control` läuft, zeigt `worktree removal failed, kept: <path>` an.

3419 * **Sie löschen eine Hintergrundsitzung**: siehe [Was das Löschen einer Sitzung entfernt](/docs/de/agent-view#what-deleting-a-session-removes).

3399* **Hook wird mit 0 beendet**: Der Worktree gilt als entfernt. Claude Code liest nichts weiter vom Hook, stellen Sie also sicher, dass Ihr Hook das Verzeichnis gelöscht hat.3420* **Hook wird mit 0 beendet**: Der Worktree gilt als entfernt. Claude Code liest nichts weiter vom Hook, stellen Sie also sicher, dass Ihr Hook das Verzeichnis gelöscht hat.

3400* **Hook wird mit einem anderen Code als 0 beendet**: Das Entfernen schlägt fehl, wenn das Verzeichnis unter `worktree_path` danach noch existiert, und der Worktree bleibt ohne Git-Fallback auf der Festplatte. Ein Hook, der das Verzeichnis vor dem Beenden mit einem anderen Code als 0 gelöscht hat, gilt als entfernt. Wie der Fehler gemeldet wird, erfahren Sie unter [WorktreeRemove-Eingabe](#worktreeremove-input).3421* **Hook wird mit einem anderen Code als 0 beendet**: Das Entfernen schlägt fehl, wenn das Verzeichnis unter `worktree_path` danach noch existiert, und der Worktree bleibt ohne Git-Fallback auf der Festplatte. Ein Hook, der das Verzeichnis vor dem Beenden mit einem anderen Code als 0 gelöscht hat, gilt als entfernt. Wie der Fehler gemeldet wird, erfahren Sie unter [WorktreeRemove-Eingabe](#worktreeremove-input).

3401 3422 

3403 3424 

3404Claude Code verwirft die [JSON-Ausgabefelder](#json-output) eines WorktreeRemove-Hooks, etwa `systemMessage` und `continue`.3425Claude Code verwirft die [JSON-Ausgabefelder](#json-output) eines WorktreeRemove-Hooks, etwa `systemMessage` und `continue`.

3405 3426 

3406Beim Löschen einer Hintergrundsitzung überprüft Claude Code den gespeicherten Worktree-Pfad, bevor der Hook ausgeführt wird, und lehnt einen Pfad ab, der ein Symlink ist oder unterhalb des Repository-Stammverzeichnisses durch einen führt. Für einen Worktree, der noch Dateien enthält, wird der Hook nur ausgeführt, wenn Sie das Löschen in der [Agent-Ansicht](/docs/de/agent-view#what-deleting-a-session-removes) bestätigen; für einen solchen Worktree behält [`claude rm`](/docs/de/agent-view#manage-sessions-from-the-shell) stattdessen die Sitzung und den Worktree bei. Vor v2.1.216 wurde der Hook ohne diese Prüfungen für den gespeicherten Pfad ausgeführt.3427Beim Löschen einer Hintergrundsitzung überprüft Claude Code den gespeicherten Worktree-Pfad, bevor der Hook ausgeführt wird, und lehnt einen Pfad ab, der ein Symlink ist oder unterhalb des Repository-Stammverzeichnisses durch einen führt. Auf diesem Weg wird der Hook für einen Worktree, der noch Dateien enthält, nur ausgeführt, wenn Sie das Löschen in der [Agentenansicht](/docs/de/agent-view#what-deleting-a-session-removes) bestätigen; bei einem solchen Worktree behält [`claude rm`](/docs/de/agent-view#manage-sessions-from-the-shell) stattdessen die Sitzung und den Worktree. Vor v2.1.216 wurde der Hook ohne diese Prüfungen auf dem gespeicherten Pfad ausgeführt.

3407 3428 

3408Claude Code übergibt den von WorktreeCreate zurückgegebenen Pfad als `worktree_path` in der Hook-Eingabe. Dieses Beispiel liest diesen Pfad und entfernt das Verzeichnis:3429Claude Code übergibt den von WorktreeCreate zurückgegebenen Pfad als `worktree_path` in der Hook-Eingabe. Dieses Beispiel liest diesen Pfad und entfernt das Verzeichnis:

3409 3430 

3444 3465 

3445* Der Worktree bleibt auf der Festplatte, und der Befehl sowie die stderr-Ausgabe des Hooks werden in das [Debug-Log](#debug-hooks) geschrieben.3466* Der Worktree bleibt auf der Festplatte, und der Befehl sowie die stderr-Ausgabe des Hooks werden in das [Debug-Log](#debug-hooks) geschrieben.

3446* Wenn Sie eine Hintergrundsitzung gelöscht haben, bleibt auch die Sitzung erhalten. Die Ablehnungsmeldung in der [Agent-Ansicht](/docs/de/agent-view#what-deleting-a-session-removes) gibt an, wie der Hook beendet wurde, etwa `exited 1`, zitiert den Anfang seiner stderr-Ausgabe und gibt an, ob ein erneutes Löschen der Sitzung das Verzeichnis trotzdem entfernt.3467* Wenn Sie eine Hintergrundsitzung gelöscht haben, bleibt auch die Sitzung erhalten. Die Ablehnungsmeldung in der [Agent-Ansicht](/docs/de/agent-view#what-deleting-a-session-removes) gibt an, wie der Hook beendet wurde, etwa `exited 1`, zitiert den Anfang seiner stderr-Ausgabe und gibt an, ob ein erneutes Löschen der Sitzung das Verzeichnis trotzdem entfernt.

3468* Wenn `claude remote-control` den Worktree einer Sitzung bereinigt hat, zeigt das Terminal, in dem es läuft, `worktree removal failed, kept: <path>` an.

3447 3469 

3448<h3 id="precompact">3470<h3 id="precompact">

3449 PreCompact3471 PreCompact

55| Sie möchten | Starten Sie mit | Isolation erforderlich | Notizen |55| Sie möchten | Starten Sie mit | Isolation erforderlich | Notizen |

56| :- | :- | :- | :- |56| :- | :- | :- | :- |

57| Jede Aktion selbst überprüfen | Manual-Modus: `claude --permission-mode default` | Keine | Sensible Arbeiten, unbekannter Code |57| Jede Aktion selbst überprüfen | Manual-Modus: `claude --permission-mode default` | Keine | Sensible Arbeiten, unbekannter Code |

58| Lokal mit weniger Aufforderungen iterieren, ohne einen Klassifizierer | Manual-Modus plus die Bash-Sandbox im [Auto-Allow-Modus](/docs/de/sandboxing#sandbox-modes): `claude --permission-mode default`, dann `/sandbox` ausführen und Auto-Allow auswählen | Die integrierte Bash-Sandbox, auf macOS, Linux und WSL2 | Deny-Regeln gelten weiterhin, und Ask-Regeln, die einen Befehl benennen, wie `Bash(git push *)`, fordern weiterhin auf. Um die Sandbox stattdessen aus einer Einstellungsdatei zu aktivieren, setzen Sie [`sandbox.enabled`](/docs/de/settings-reference#sandbox-enabled) auf `true` |58| Lokal mit weniger Berechtigungsabfragen iterieren, ohne einen Klassifikator | Manual-Modus plus die Bash-Sandbox im [Auto-Allow-Modus](/docs/de/sandboxing#sandbox-modes): `claude --permission-mode default`, dann `/sandbox` ausführen und Auto-Allow auswählen | Die integrierte Bash-Sandbox, auf macOS, Linux und WSL2 | Deny-Regeln gelten weiterhin, und Ask-Regeln, die einen Befehl benennen, wie `Bash(git push *)`, fragen weiterhin nach. Der [Auto-Allow-Modus](/docs/de/sandboxing#auto-allow-mode) behandelt andere Befehle, die nachfragen können. Um die Sandbox stattdessen aus einer Einstellungsdatei zu aktivieren, setzen Sie [`sandbox.enabled`](/docs/de/settings-reference#sandbox-enabled) auf `true` |

59| Erkunden Sie, bevor Sie etwas ändern | `claude --permission-mode plan` | Keine | Claude Code blockiert Bearbeitungen, bis Sie einen Plan [genehmigen](#review-and-approve-a-plan) |59| Erkunden Sie, bevor Sie etwas ändern | `claude --permission-mode plan` | Keine | Claude Code blockiert Bearbeitungen, bis Sie einen Plan [genehmigen](#review-and-approve-a-plan) |

60| Arbeiten Sie freihändig im Auto-Modus | `claude --permission-mode auto`, der [integrierte Standard-Berechtigungsmodus](#which-mode-a-session-starts-in) mit v2.1.283 oder später | Keine; eine Sandbox oder ein Container fügt Verteidigungstiefe hinzu | Erfordert ein [unterstütztes Modell](#eliminate-prompts-with-auto-mode), und Ihre Organisation kann [Auto-Modus ausschalten](#eliminate-prompts-with-auto-mode) |60| Arbeiten Sie freihändig im Auto-Modus | `claude --permission-mode auto`, der [integrierte Standard-Berechtigungsmodus](#which-mode-a-session-starts-in) mit v2.1.283 oder später | Keine; eine Sandbox oder ein Container fügt Verteidigungstiefe hinzu | Erfordert ein [unterstütztes Modell](#eliminate-prompts-with-auto-mode), und Ihre Organisation kann [Auto-Modus ausschalten](#eliminate-prompts-with-auto-mode) |

61| Führen Sie in CI mit einer genauen Allowlist aus | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Keine über das hinaus, was Ihr CI-Runner bietet | [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) ignorieren `dontAsk` aus Einstellungsdateien |61| Führen Sie in CI mit einer genauen Allowlist aus | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Keine über das hinaus, was Ihr CI-Runner bietet | [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) ignorieren `dontAsk` aus Einstellungsdateien |

744* Inhaltsgebundene Ask-Regeln wie `Bash(git push *)` erzwingen weiterhin eine Aufforderung744* Inhaltsgebundene Ask-Regeln wie `Bash(git push *)` erzwingen weiterhin eine Aufforderung

745* Explizite Deny-Regeln gelten weiterhin745* Explizite Deny-Regeln gelten weiterhin

746* `rm`- oder `rmdir`-Befehle, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) abzielen, durchlaufen weiterhin den regulären Berechtigungsfluss746* `rm`- oder `rmdir`-Befehle, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) abzielen, durchlaufen weiterhin den regulären Berechtigungsfluss

747* Auch andere Befehle in der Sandbox können den regulären Berechtigungsablauf durchlaufen, wie unter [Auto-allow-Modus](/docs/de/sandboxing#auto-allow-mode) beschrieben

747 748 

748Befehle, die nicht sandboxed ausgeführt werden können, wie ausgeschlossene Befehle, respektieren die einfache `Bash` Ask-Regel wie gewöhnlich. Siehe [Sandbox-Modi](/docs/de/sandboxing#sandbox-modes), um dieses Verhalten zu ändern.749Befehle, die nicht sandboxed ausgeführt werden können, wie ausgeschlossene Befehle, respektieren die einfache `Bash` Ask-Regel wie gewöhnlich. Siehe [Sandbox-Modi](/docs/de/sandboxing#sandbox-modes), um dieses Verhalten zu ändern.

749 750 

55* **Namen, die mit `claudeai-` beginnen**: reserviert für Marketplaces, die auf claude.ai gehostet werden. `claude plugin marketplace add` lehnt jeden anderen Marketplace ab, der einen mit `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai` verwendet.55* **Namen, die mit `claudeai-` beginnen**: reserviert für Marketplaces, die auf claude.ai gehostet werden. `claude plugin marketplace add` lehnt jeden anderen Marketplace ab, der einen mit `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai` verwendet.

56* **Der Download-Ordner eines registrierten GitHub-Marketplace, `<owner>-<repo>`**: Claude Code lädt einen Marketplace, der aus einer `github`-Quelle wie `acme/x-tools` hinzugefügt wurde, über einen Ordner namens `acme-x-tools` herunter, unabhängig davon, welchen `name` dieser Marketplace selbst hat. Solange dieser Marketplace unter einem anderen Namen als `acme-x-tools` registriert ist, lehnt `claude plugin marketplace add` einen anderen Marketplace namens `acme-x-tools` nach dem Herunterladen ab und meldet `Can't use the marketplace name "acme-x-tools"`. Diese Überprüfung erfordert Claude Code v2.1.290 oder später.56* **Der Download-Ordner eines registrierten GitHub-Marketplace, `<owner>-<repo>`**: Claude Code lädt einen Marketplace, der aus einer `github`-Quelle wie `acme/x-tools` hinzugefügt wurde, über einen Ordner namens `acme-x-tools` herunter, unabhängig davon, welchen `name` dieser Marketplace selbst hat. Solange dieser Marketplace unter einem anderen Namen als `acme-x-tools` registriert ist, lehnt `claude plugin marketplace add` einen anderen Marketplace namens `acme-x-tools` nach dem Herunterladen ab und meldet `Can't use the marketplace name "acme-x-tools"`. Diese Überprüfung erfordert Claude Code v2.1.290 oder später.

57 57 

58Wenn ein registrierter Marketplace nicht mehr geladen wird, weil sein Name einen offiziellen imitiert, melden `claude plugin list` und `/plugin` `Claude Code refuses the marketplace name "<name>"`. Die Meldung teilt Ihnen mit, den Marketplace zu entfernen. Das Entfernen deinstalliert auch seine Plugins und löscht ihre gespeicherten Daten. Diese benannte Ablehnungsmeldung erfordert Claude Code v2.1.282 oder später.58Wenn ein registrierter Marketplace nicht mehr geladen wird, weil sein Name einen offiziellen imitiert, melden `claude plugin list` und `/plugin` `Claude Code refuses the marketplace name "<name>"`. Die Meldung teilt Ihnen mit, den Marketplace zu entfernen. Das Entfernen deinstalliert auch seine Plugins und löscht deren Daten, Optionen und Secrets. Diese benannte Ablehnungsmeldung erfordert Claude Code v2.1.282 oder später.

59 

60Wenn eine Einstellungsdatei den Marketplace inline deklariert, teilt Ihnen die Meldung mit, dessen Eintrag umzubenennen, bevor Sie den alten Namen entfernen. Die einzelnen Schritte finden Sie unter [Claude Code refuses the marketplace name](/docs/de/errors#claude-code-refuses-the-marketplace-name). Die Meldung führt sie ab Claude Code v2.1.292 auf.

59 61 

60<h2 id="top-level-fields">62<h2 id="top-level-fields">

61 Top-Level-Felder63 Top-Level-Felder

88| [`prompt.submit`](/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Ein Prompt abgeschickt wird | `next({ ...e, text })`, `next({ ...e, context })` oder `{ drop: reason }` |88| [`prompt.submit`](/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Ein Prompt abgeschickt wird | `next({ ...e, text })`, `next({ ...e, context })` oder `{ drop: reason }` |

89| `prompt.fill`, `prompt.suggest` | Text gleich als Entwurf oder als abgeblendeter Vorschlag in das Eingabefeld eingefügt wird | `next(e)` mit geändertem Text |89| `prompt.fill`, `prompt.suggest` | Text gleich als Entwurf oder als abgeblendeter Vorschlag in das Eingabefeld eingefügt wird | `next(e)` mit geändertem Text |

90| `prompt.edit` | Der Benutzer das Eingabefeld bearbeitet | `next(e)` |90| `prompt.edit` | Der Benutzer das Eingabefeld bearbeitet | `next(e)` |

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

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

92| [`prompt.section`](/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Einmal für jeden benannten Abschnitt des System-Prompts. `e.name` ist die `id` des Abschnitts in `prompt.compose`. | `{ text }` oder `{ text: null }`, um den Abschnitt auszulassen |93| [`prompt.section`](/docs/de/plugins/mods/events#rewrite-or-add-to-a-prompt) | Einmal für jeden benannten Abschnitt des System-Prompts. `e.name` ist die `id` des Abschnitts in `prompt.compose`. | `{ text }` oder `{ text: null }`, um den Abschnitt auszulassen |

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

64 | `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte Sitzungsnamen, wenn kein expliziter Name festgelegt ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Setzen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für denselben Effekt. |64 | `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte Sitzungsnamen, wenn kein expliziter Name festgelegt ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Setzen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für denselben Effekt. |

65 | `-c`, `--continue` | Bringen Sie die Sitzung zurück, die der letzte Server in diesem Verzeichnis gestartet hat, anstatt eine neue zu erstellen. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |65 | `-c`, `--continue` | Bringen Sie die Sitzung zurück, die der letzte Server in diesem Verzeichnis gestartet hat, anstatt eine neue zu erstellen. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |

66 | `--session-id <id>` | Bringen Sie eine Sitzung anhand ihrer ID zurück. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |66 | `--session-id <id>` | Bringen Sie eine Sitzung anhand ihrer ID zurück. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |

67 | `--spawn <mode>` | Wie der Server Sitzungen erstellt.<br />• `same-dir` (Standard): Alle Sitzungen teilen sich das aktuelle Arbeitsverzeichnis, sodass sie in Konflikt geraten können, wenn dieselben Dateien bearbeitet werden.<br />• `worktree`: Jede On-Demand-Sitzung erhält ihren eigenen [git worktree](/docs/de/worktrees). Erfordert ein Git-Repository.<br />• `session`: Single-Session-Modus. Bedient genau eine Sitzung und lehnt zusätzliche Verbindungen ab. Wird nur beim Start festgelegt.<br />Drücken Sie `w` zur Laufzeit, um zwischen `same-dir` und `worktree` umzuschalten. |67 | `--spawn <mode>` | Wie der Server Sitzungen erstellt.<br />• `same-dir` (Standard): Alle Sitzungen teilen sich das aktuelle Arbeitsverzeichnis, sodass sie in Konflikt geraten können, wenn dieselben Dateien bearbeitet werden.<br />• `worktree`: Jede On-Demand-Sitzung erhält ihren eigenen [git worktree](/docs/de/worktrees). Erfordert ein Git-Repository oder einen [`WorktreeCreate`-Hook](/docs/de/hooks#worktreecreate).<br />• `session`: Single-Session-Modus. Bedient genau eine Sitzung und lehnt zusätzliche Verbindungen ab. Wird nur beim Start festgelegt.<br />Drücken Sie `w` zur Laufzeit, um zwischen `same-dir` und `worktree` umzuschalten. |

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

69 | `--[no-]create-session-in-dir` | Erstellen Sie vorab eine Sitzung im aktuellen Verzeichnis, wenn der Server startet, damit Sie sofort einen Ort zum Eingeben haben. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert. Wenn Sie `--no-create-session-in-dir` übergeben, um ohne zu starten, archiviert Claude Code die Sitzungen des Servers, wenn Sie ihn stoppen, sodass es nichts zum [Fortsetzen](#resume-sessions-after-stopping-the-server) gibt. |69 | `--[no-]create-session-in-dir` | Erstellen Sie vorab eine Sitzung im aktuellen Verzeichnis, wenn der Server startet, damit Sie sofort einen Ort zum Eingeben haben. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert. Wenn Sie `--no-create-session-in-dir` übergeben, um ohne zu starten, archiviert Claude Code die Sitzungen des Servers, wenn Sie ihn stoppen, sodass es nichts zum [Fortsetzen](#resume-sessions-after-stopping-the-server) gibt. |

70 | `--permission-mode <mode>` | Legen Sie den Startmodus für [Berechtigungen](/docs/de/permission-modes) für die Sitzungen des Servers fest, z. B. `acceptEdits`. Akzeptiert `manual` als Alias für `default`; ein nicht erkannter Modus stoppt den Server beim Start und listet die gültigen Modi auf. |70 | `--permission-mode <mode>` | Legen Sie den Startmodus für [Berechtigungen](/docs/de/permission-modes) für die Sitzungen des Servers fest, z. B. `acceptEdits`. Akzeptiert `manual` als Alias für `default`; ein nicht erkannter Modus stoppt den Server beim Start und listet die gültigen Modi auf. |

202* Ausdrückliche [Verweigerungsregeln](/docs/de/permissions) werden immer beachtet202* Ausdrückliche [Verweigerungsregeln](/docs/de/permissions) werden immer beachtet

203* `rm`- oder `rmdir`-Befehle, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) zielen, durchlaufen weiterhin den regulären Berechtigungsablauf203* `rm`- oder `rmdir`-Befehle, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) zielen, durchlaufen weiterhin den regulären Berechtigungsablauf

204* Inhaltsbezogene [Nachfrageregeln](/docs/de/permissions) wie `Bash(git push *)` erzwingen weiterhin eine Nachfrage, auch für Befehle in der Sandbox204* Inhaltsbezogene [Nachfrageregeln](/docs/de/permissions) wie `Bash(git push *)` erzwingen weiterhin eine Nachfrage, auch für Befehle in der Sandbox

205* Eine einfache `Bash`-Nachfrageregel oder die gleichwertige Form `Bash(*)` wird für Befehle, die in der Sandbox ausgeführt werden, übersprungen; sie gilt weiterhin für Befehle, die auf den regulären Berechtigungsablauf zurückfallen. Im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) wird die Regel nicht übersprungen: Sie fragt auch bei Befehlen in der Sandbox nach, einschließlich nur lesender Befehle205* Eine einfache `Bash`-Nachfrageregel oder die gleichwertige Form `Bash(*)` wird für Befehle, die in der Sandbox ausgeführt werden, übersprungen; sie gilt weiterhin für Befehle, die außerhalb der Sandbox ausgeführt werden. Im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) wird die Regel nicht übersprungen: Sie fragt auch bei Befehlen in der Sandbox nach, einschließlich nur lesender Befehle

206* Befehle des [Monitor-Tools](/docs/de/tools-reference#monitor-tool) werden nicht automatisch genehmigt, obwohl sie weiterhin in der Sandbox ausgeführt werden. Um die Nachfrage zu überspringen, fügen Sie eine [Erlaubnisregel](/docs/de/permissions#bash) hinzu, die auf den Befehl passt, etwa `Bash(npm run *)`206* Befehle des [Monitor-Tools](/docs/de/tools-reference#monitor-tool) werden nicht automatisch genehmigt, obwohl sie weiterhin in der Sandbox ausgeführt werden. Um die Nachfrage zu überspringen, fügen Sie eine [Erlaubnisregel](/docs/de/permissions#bash) hinzu, die auf den Befehl passt, etwa `Bash(npm run *)`

207 207 

208Einige Befehle in der Sandbox durchlaufen ebenfalls den regulären [Berechtigungsablauf](/docs/de/permissions), statt automatisch genehmigt zu werden. Das betrifft Befehle wie `FOO=bar npm test`, bei denen eine vor einem Befehl gesetzte Variable ändern kann, welches Programm ausgeführt wird, sowie `make CC=clang` oder `eval "ls"`. Ihre Erlaubnisregeln und Ihr Berechtigungsmodus entscheiden dann, ob Sie eine Nachfrage sehen, und der Befehl wird weiterhin innerhalb der Sandbox ausgeführt.

209 

210Für diese drei Befehle verhindert eine [Erlaubnisregel](/docs/de/permissions#bash), die auf den Befehl passt, eine wiederkehrende Nachfrage. Diese Regeln zeigen das Muster:

211 

212* `Bash(make *)` genehmigt `make CC=clang`

213* `Bash(FOO=bar npm *)` genehmigt `FOO=bar npm test`. Wenn der Befehl mit einer Variablenzuweisung beginnt, nehmen Sie die Zuweisung in die Regel auf

214* `Bash(eval "ls")` genehmigt `eval "ls"`. Eine Platzhalterregel wie `Bash(eval *)` verhindert diese Nachfrage nicht; schreiben Sie daher eine Regel, die auf den gesamten Befehl passt

215 

216Eine Erlaubnisregel, die auf einen Befehl passt, genehmigt auch einen [Wiederholungsversuch ohne Sandbox](#the-unsandboxed-retry-escape-hatch) dieses Befehls, sodass er ohne Nachfrage außerhalb der Sandbox ausgeführt werden kann.

217 

208<Info>218<Info>

209 Der Auto-Allow-Modus funktioniert unabhängig von Ihrer Einstellung für den Berechtigungsmodus, mit drei Ausnahmen: dem [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode), einem Befehl im Auto-Modus mit [befehlsspezifisch erlaubten Domains](#per-command-allowed-domains-in-auto-mode) und der [serverseitigen Prüfung durch den Klassifikator](/docs/de/permission-modes#how-the-classifier-evaluates-actions) für Befehle in der Sandbox im Auto-Modus. Auch wenn Sie sich nicht im „accept edits“-Modus befinden, werden Bash-Befehle in der Sandbox automatisch ausgeführt, wenn Auto-Allow aktiviert ist. Das bedeutet, dass Bash-Befehle, die Dateien innerhalb der Sandbox-Grenzen ändern, ohne Nachfrage ausgeführt werden, selbst im Manual-Modus, in dem die Tools zur Dateibearbeitung nachfragen würden.219 Der Auto-Allow-Modus funktioniert unabhängig von Ihrer Einstellung für den Berechtigungsmodus, mit drei Ausnahmen: dem [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode), einem Befehl im Auto-Modus mit [befehlsspezifisch erlaubten Domains](#per-command-allowed-domains-in-auto-mode) und der [serverseitigen Prüfung durch den Klassifikator](/docs/de/permission-modes#how-the-classifier-evaluates-actions) für Befehle in der Sandbox im Auto-Modus. Auch wenn Sie sich nicht im „accept edits“-Modus befinden, werden Bash-Befehle in der Sandbox automatisch ausgeführt, wenn Auto-Allow aktiviert ist. Das bedeutet, dass Bash-Befehle, die Dateien innerhalb der Sandbox-Grenzen ändern, ohne Nachfrage ausgeführt werden, selbst im Manual-Modus, in dem die Tools zur Dateibearbeitung nachfragen würden.

210 220 

191 Jitter191 Jitter

192</h3>192</h3>

193 193 

194Eine geplante Aufgabe kann zu einer anderen Zeit ausgeführt werden, als ihr Zeitplan angibt. Würden die Aufgaben aller Sitzungen exakt nach Zeitplan laufen, würden viele von ihnen die API im selben Moment aufrufen. Deshalb verschiebt Claude Code die Ausführungszeit jeder Aufgabe. Wiederkehrende Aufgaben laufen später, und einmalige Aufgaben, die zur vollen oder halben Stunde geplant sind, laufen etwas früher.194Eine geplante Aufgabe kann zu einer anderen Zeit ausgeführt werden, als ihr Zeitplan angibt. Würden die Aufgaben aller Sitzungen exakt nach Zeitplan laufen, würden viele von ihnen die API im selben Moment aufrufen. Deshalb verschiebt Claude Code die Ausführungszeit jeder Aufgabe. Wiederkehrende Aufgaben laufen später, mit Ausnahme einer Aufgabe, die alle fünf Minuten läuft, geschrieben als `*/5 * * * *`. Einmalige Aufgaben, die zur vollen oder halben Stunde geplant sind, laufen etwas früher.

195 195 

196<h4 id="how-late-a-recurring-task-runs">196<h4 id="how-late-a-recurring-task-runs">

197 Wie viel später eine wiederkehrende Aufgabe läuft197 Wie viel später eine wiederkehrende Aufgabe läuft

198</h4>198</h4>

199 199 

200Wenn Sie eine wiederkehrende Aufgabe erstellen, weist Claude Code ihr eine feste Verzögerung zu und addiert diese Verzögerung zu jeder Ausführung. Die Verzögerung wird aus der ID der Aufgabe berechnet, sodass dieselbe Aufgabe jedes Mal um dieselbe Anzahl von Minuten später läuft, auch wenn die Sitzung untätig ist und nichts anderes ausgeführt wird.200Sofern sie nicht alle fünf Minuten läuft, startet eine wiederkehrende Aufgabe jede Ausführung um bis zur Hälfte des Abstands zur nächsten Ausführung später, höchstens jedoch um 30 Minuten. Ihre Aufgabe fällt in einen dieser drei Fälle:

201 201 

202Aufgaben, die häufiger laufen, erhalten kürzere Verzögerungen, und 30 Minuten ist die längste Verzögerung, die eine Aufgabe erhalten kann. Dies sind die Verzögerungsbereiche für einige gängige Zeitpläne:202* **Gleichmäßig verteilte Ausführungen**: Eine Aufgabe mit gleichen Abständen, etwa stündlich, täglich oder alle 10 Minuten, läuft jedes Mal um dieselbe Anzahl von Minuten später, auch wenn die Sitzung untätig ist.

203* **Ungleichmäßig verteilte Ausführungen**: Eine Aufgabe mit ungleichen Abständen, etwa eine, die jede Stunde für `:00` und `:15` geplant ist, kann bei jeder Ausführung um eine andere Anzahl von Minuten später laufen.

204* **Alle fünf Minuten**: Eine Aufgabe, die als `*/5 * * * *` geschrieben ist, wird nicht verzögert. Eine Ausführung genau fünf Minuten nach der letzten würde erst starten, nachdem ein fünfminütiger [Prompt-Cache](/docs/de/prompt-caching#which-ttl-each-request-gets) abgelaufen ist. Deshalb startet jede Ausführung 15 Sekunden früher.

203 205 

204| Aufgabe läuft | Verzögerung liegt zwischen |206Suchen Sie Ihren Zeitplan in der ersten Spalte dieser Tabelle, um zu sehen, wann jede seiner Ausführungen startet.

207 

208| Zeitplan | Wann jede Ausführung startet |

205| :- | :- |209| :- | :- |

206| Alle 10 Minuten | 0 und 5 Minuten |210| Alle 5 Minuten, geschrieben als `*/5 * * * *`, was `/loop 5m` erstellt | 4 Minuten 45 Sekunden nach der vorherigen Ausführung |

207| Alle 30 Minuten | 0 und 15 Minuten |211| Alle 10 Minuten | 0 bis 5 Minuten später |

208| Stündlich oder seltener, etwa täglich | 0 und 30 Minuten |212| Alle 30 Minuten | 0 bis 15 Minuten später |

213| Stündlich oder seltener, etwa täglich | 0 bis 30 Minuten später |

209 214 

210Zum Beispiel plant `7,37 * * * *` eine Aufgabe für `:07` und `:37`, die 30 Minuten auseinanderliegen, daher liegt ihre Verzögerung irgendwo zwischen 0 und 15 Minuten. Beträgt die Verzögerung dieser Aufgabe 14 Minuten, läuft sie jede Stunde um `:21` und `:51`. Wenn Sie den Zeitplan auf eine andere Minute ändern, verschiebt sich die Ausführungszeit, und es wird weiterhin eine Verzögerung hinzugefügt.215Zum Beispiel plant `7,37 * * * *` eine Aufgabe für `:07` und `:37`, die 30 Minuten auseinanderliegen, daher liegt ihre Verzögerung irgendwo zwischen 0 und 15 Minuten. Beträgt die Verzögerung dieser Aufgabe 14 Minuten, läuft sie jede Stunde um `:21` und `:51`. Wenn Sie den Zeitplan auf eine andere Minute ändern, verschiebt sich die Ausführungszeit, und es wird weiterhin eine Verzögerung hinzugefügt.

211 216 

1931 1931 

1932* **Bereich**: [`Any file`](#scopes)1932* **Bereich**: [`Any file`](#scopes)

1933* **Typ**: Boolescher Wert1933* **Typ**: Boolescher Wert

1934 * `true`: Claude Code führt Bash-Befehle in der Sandbox ohne Berechtigungsabfrage aus, vorbehaltlich `deny`-Regeln und inhaltsbezogener `ask`-Regeln; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` deaktiviert die automatische Freigabe1934 * `true`: Claude Code führt Bash-Befehle in der Sandbox ohne Berechtigungsabfrage aus, außer in den Fällen, die [Auto-allow mode](/docs/de/sandboxing#auto-allow-mode) beschreibt; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` deaktiviert die automatische Freigabe

1935 * `false`: Befehle in der Sandbox durchlaufen den regulären Berechtigungsfluss, daher entscheiden Ihre allow-Regeln und Ihr Berechtigungsmodus. Die **Mode**-Registerkarte von `/sandbox` nennt dies regulären Berechtigungsmodus1935 * `false`: Befehle in der Sandbox durchlaufen den regulären Berechtigungsfluss, daher entscheiden Ihre allow-Regeln und Ihr Berechtigungsmodus. Die **Mode**-Registerkarte von `/sandbox` nennt dies regulären Berechtigungsmodus

1936* **Standard**: `true`1936* **Standard**: `true`

1937 1937 

1946}1946}

1947```1947```

1948 1948 

1949Siehe [Sandbox modes](/docs/de/sandboxing#sandbox-modes) dafür, wobei der Modus mit automatischer Freigabe weiterhin nachfragt und wie er sich im Plan-Modus verhält.1949Siehe [Auto-allow mode](/docs/de/sandboxing#auto-allow-mode) dafür, wobei der Modus mit automatischer Freigabe weiterhin nachfragt und wie er sich im Plan-Modus verhält.

1950 1950 

1951<h3 id="sandbox-excludedcommands">1951<h3 id="sandbox-excludedcommands">

1952 `sandbox.excludedCommands`1952 `sandbox.excludedCommands`

1308Außerhalb des [Vollbildmodus](/docs/de/fullscreen) zeigt Claude Code Benachrichtigungen in der gleichen Zeile wie Ihre Statuszeile an. Im Vollbildmodus gibt Claude Code Benachrichtigungen eine eigene Zeile.1308Außerhalb des [Vollbildmodus](/docs/de/fullscreen) zeigt Claude Code Benachrichtigungen in der gleichen Zeile wie Ihre Statuszeile an. Im Vollbildmodus gibt Claude Code Benachrichtigungen eine eigene Zeile.

1309 1309 

1310* Systembenachrichtigungen wie MCP-Serverfehler und automatische Updates werden auf der rechten Seite der Zeile angezeigt. Vorübergehende Benachrichtigungen wie die Kontext-niedrig-Warnung zirkulieren auch durch diesen Bereich.1310* Systembenachrichtigungen wie MCP-Serverfehler und automatische Updates werden auf der rechten Seite der Zeile angezeigt. Vorübergehende Benachrichtigungen wie die Kontext-niedrig-Warnung zirkulieren auch durch diesen Bereich.

1311* Das Aktivieren des ausführlichen Modus fügt einen Token-Zähler zu diesem Bereich hinzu1311* Das Aktivieren des ausführlichen Modus fügt diesem Bereich einen Token-Zähler hinzu, der die Größe Ihres Kontexts so anzeigt, wie die letzte API-Antwort sie gemeldet hat, nicht die [Zählung pro Turn neben dem Spinner](/docs/de/costs#read-the-token-count-beside-the-spinner)

1312* Auf schmalen Terminals können diese Benachrichtigungen Ihre Statuszeilen-Ausgabe abschneiden1312* Auf schmalen Terminals können diese Benachrichtigungen Ihre Statuszeilen-Ausgabe abschneiden

431 431 

432Setzen Sie eine unterbrochene Ausführung von `/workflows` fort, indem Sie sie auswählen und `p` drücken. Für eine Ausführung, die Sie gestoppt haben, bitten Sie Claude, den Workflow mit dem gleichen Skript erneut zu starten. Wenn Agenten aus der gestoppten Ausführung noch nicht beendet wurden, weigert sich Claude Code, den Neustart durchzuführen, bis sie beendet sind, sodass keine zweite Kopie dieser Agenten neben ihnen laufen kann.432Setzen Sie eine unterbrochene Ausführung von `/workflows` fort, indem Sie sie auswählen und `p` drücken. Für eine Ausführung, die Sie gestoppt haben, bitten Sie Claude, den Workflow mit dem gleichen Skript erneut zu starten. Wenn Agenten aus der gestoppten Ausführung noch nicht beendet wurden, weigert sich Claude Code, den Neustart durchzuführen, bis sie beendet sind, sodass keine zweite Kopie dieser Agenten neben ihnen laufen kann.

433 433 

434<h4 id="which-agents-run-again">

435 Welche Agenten erneut ausgeführt werden

436</h4>

437 

434Claude Code spielt die Ausführung in der Reihenfolge ab, in der die Agenten gestartet wurden, und jeder Agent gibt entweder sein gespeichertes Ergebnis zurück oder wird erneut ausgeführt:438Claude Code spielt die Ausführung in der Reihenfolge ab, in der die Agenten gestartet wurden, und jeder Agent gibt entweder sein gespeichertes Ergebnis zurück oder wird erneut ausgeführt:

435 439 

436* **Abgeschlossen**: gibt sein gespeichertes Ergebnis zurück. Der erste Agent, dessen Eingabeaufforderung sich vom vorherigen Durchlauf unterscheidet, weil Sie das Skript bearbeitet haben oder ein früherer Agent etwas anderes zurückgegeben hat, wird erneut ausgeführt, und ebenso jeder Agent danach, auch solche, die abgeschlossen wurden.440* **Abgeschlossen**: gibt sein gespeichertes Ergebnis zurück. Der erste Agent, dessen Eingabeaufforderung sich vom vorherigen Durchlauf unterscheidet, weil Sie das Skript bearbeitet haben oder ein früherer Agent etwas anderes zurückgegeben hat, wird erneut ausgeführt, und ebenso jeder Agent danach, auch solche, die abgeschlossen wurden.

439 443 

440Der letzte Fall bedeutet, dass ein Fehler in der Mitte eines Fan-out-Durchlaufs Arbeit erneut ausführt, die bereits abgeschlossen war. Wenn ein Skript A, B, C und D in dieser Reihenfolge startet und B fehlschlägt, gibt das erneute Starten A aus dem Cache zurück und führt B, C und D erneut aus.444Der letzte Fall bedeutet, dass ein Fehler in der Mitte eines Fan-out-Durchlaufs Arbeit erneut ausführt, die bereits abgeschlossen war. Wenn ein Skript A, B, C und D in dieser Reihenfolge startet und B fehlschlägt, gibt das erneute Starten A aus dem Cache zurück und führt B, C und D erneut aus.

441 445 

446Wenn Sie ein Skript, das A, B, C und D gestartet hat, so bearbeiten, dass es A, C, B und D startet, ist der zweite gestartete Agent nun C, während die vorherige Ausführung an dieser Stelle B gestartet hat. Das erneute Starten gibt A aus dem Cache zurück und führt C, B und D erneut aus.

447 

448<h4 id="resume-after-you-leave-the-session">

449 Fortsetzen, nachdem Sie die Sitzung verlassen haben

450</h4>

451 

442Sie können eine Ausführung innerhalb derselben Claude Code-Sitzung fortsetzen. Was mit einem laufenden Workflow geschieht, wenn Sie die Sitzung verlassen, hängt davon ab, wie Sie sie verlassen:452Sie können eine Ausführung innerhalb derselben Claude Code-Sitzung fortsetzen. Was mit einem laufenden Workflow geschieht, wenn Sie die Sitzung verlassen, hängt davon ab, wie Sie sie verlassen:

443 453 

444* Wenn Sie [die Sitzung in den Hintergrund verschieben](/docs/de/agent-view#what-carries-over-when-you-background), spielt Claude Code die Ausführung auf die gleiche Weise in der Hintergrund-Sitzung ab und setzt sie fort.454* Wenn Sie [die Sitzung in den Hintergrund verschieben](/docs/de/agent-view#what-carries-over-when-you-background), spielt Claude Code die Ausführung auf die gleiche Weise in der Hintergrund-Sitzung ab und setzt sie fort.

129and report the results.129and report the results.

130```130```

131 131 

132Jeder Subagent erhält einen temporären Worktree, den Claude Code automatisch entfernt, wenn der Subagent ohne Änderungen beendet wird; ein Worktree mit Änderungen bleibt auf der Festplatte, bis die [periodische Bereinigung unten](#clean-up-subagent-and-background-session-worktrees) ihn entfernen kann, ohne Arbeit zu verlieren.132Jeder Subagent erhält einen temporären Worktree, den Claude Code automatisch entfernt, wenn der Subagent ohne Änderungen beendet wird; ein Worktree mit Änderungen bleibt auf der Festplatte, bis die [periodische Bereinigung unten](#clean-up-subagent-and-background-session-worktrees) ihn entfernen kann, ohne Arbeit zu verlieren. Für einen Worktree, den Ihr [WorktreeCreate-Hook](/docs/de/hooks#worktreecreate) erstellt hat, lesen Sie stattdessen [WorktreeRemove](/docs/de/hooks#worktreeremove).

133 133 

134Subagent-Worktrees verwenden den gleichen [Basis-Branch](#choose-the-base-branch) wie `--worktree`, sodass sie von dem Standard-Branch Ihres Repositories verzweigen, es sei denn, `worktree.baseRef` ist auf `"head"` gesetzt.134Subagent-Worktrees verwenden den gleichen [Basis-Branch](#choose-the-base-branch) wie `--worktree`, sodass sie von dem Standard-Branch Ihres Repositories verzweigen, es sei denn, `worktree.baseRef` ist auf `"head"` gesetzt.

135 135