Documentation — Spybara

accessibility.md +1 −1

Details

111 Menüs und Eingabeaufforderungen beantworten111 Menüs und Eingabeaufforderungen beantworten

112</h2>112</h2>

113 113

114Im Bildschirmleser-Modus werden Menüs, die Sie normalerweise mit den Pfeiltasten navigieren würden, einschließlich Berechtigungsaufforderungen, zu nummerierten Listen. Claude Code kündigt jede Option als nummerierte Zeile an, gefolgt von einer Eingabeaufforderung `Enter selection`, die den gültigen Bereich benennt. Geben Sie die Nummer der gewünschten Option ein und drücken Sie die Eingabetaste.114Im Bildschirmleser-Modus werden Menüs, die Sie normalerweise mit den Pfeiltasten navigieren würden, einschließlich Berechtigungsaufforderungen, zu nummerierten Listen. Claude Code kündigt jede Option als nummerierte Zeile an, gefolgt von einer Eingabeaufforderung `Select with numbers`, die den gültigen Bereich benennt. Geben Sie die Nummer der gewünschten Option ein und drücken Sie die Eingabetaste.

115 115

116* Drücken Sie Escape, um ein Menü abzubrechen, dessen Eingabeaufforderung mit `or Escape to cancel` endet.116* Drücken Sie Escape, um ein Menü abzubrechen, dessen Eingabeaufforderung mit `or Escape to cancel` endet.

117* Wenn Sie eine Nummer eingeben, die nicht auf der Liste steht, kündigt Claude Code den gültigen Bereich an und lässt Sie es erneut versuchen.117* Wenn Sie eine Nummer eingeben, die nicht auf der Liste steht, kündigt Claude Code den gültigen Bereich an und lässt Sie es erneut versuchen.

admin-setup.md +2 −2

Details

97| :- | :- | :- |97| :- | :- | :- |

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

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

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

102| [Verwaltete Richtlinie CLAUDE.md](/docs/de/memory#deploy-organization-wide-claude-md) | Organisationsweite Anweisungen, die in jeder Sitzung geladen werden, können nicht ausgeschlossen werden | Datei im verwalteten Richtlinienpfad |102| [Verwaltete Richtlinie CLAUDE.md](/docs/de/memory#deploy-organization-wide-claude-md) | Organisationsweite Anweisungen, die in jeder Sitzung geladen werden, können nicht ausgeschlossen werden | Datei im verwalteten Richtlinienpfad |

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

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

106| [Claude.ai-Synchronisierung deaktivieren](/docs/de/settings-reference#syncclaudeaiskills) | Verhindern Sie, dass Claude Code die [Skills](/docs/de/skills#how-synced-skills-behave) und [Plugins](/docs/de/plugins/loading#synced-plugins) lädt, die Ihre Entwickler auf claude.ai aktivieren. Wenn Sie Skills für Ihre Organisation auf claude.ai ausschalten, stoppt Claude Code die Synchronisierung beider, und in v2.1.273 oder später entfernt es auch die bereits synchronisierten. Um eines davon zu stoppen, ohne Skills auszuschalten, setzen Sie seinen Schlüssel in verwalteten Einstellungen auf `false` | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |106| [Claude.ai-Synchronisierung deaktivieren](/docs/de/settings-reference#syncclaudeaiskills) | Verhindern Sie, dass Claude Code die [Skills](/docs/de/skills#how-synced-skills-behave) und [Plugins](/docs/de/plugins/loading#synced-plugins) lädt, die Ihre Entwickler auf claude.ai aktivieren. Wenn Sie Skills für Ihre Organisation auf claude.ai ausschalten, stoppt Claude Code die Synchronisierung beider, und in v2.1.273 oder später entfernt es auch die bereits synchronisierten. Um eines davon zu stoppen, ohne Skills auszuschalten, setzen Sie seinen Schlüssel in verwalteten Einstellungen auf `false` | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

107| [Hook-Einschränkungen](/docs/de/settings-reference#allowmanagedhooksonly) | Einschränken, welche Hooks ausgeführt werden, und HTTP-Hook-URLs einschränken; siehe [was unter `allowManagedHooksOnly` ausgeführt wird](/docs/de/settings-reference#what-runs-under-allowmanagedhooksonly) für die vollständige Effektliste | `allowManagedHooksOnly`, `allowedHttpHookUrls` |107| [Hook-Einschränkungen](/docs/de/settings-reference#allowmanagedhooksonly) | Einschränken, welche Hooks ausgeführt werden, und HTTP-Hook-URLs einschränken; siehe [was unter `allowManagedHooksOnly` ausgeführt wird](/docs/de/settings-reference#what-runs-under-allowmanagedhooksonly) für die vollständige Effektliste | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

108| [Anmeldung erzwingen](/docs/de/settings-reference#forceloginmethod) | Anmeldung auf eine bestimmte Methode oder Anthropic-Organisation beschränken. Die Methodenbeschränkung gilt über die VS Code-Erweiterung, Agent SDK, `claude setup-token` und `/install-github-app` hinweg, und der Terminal-Bildschirm für interaktive Anmeldung, erreichbar durch `/login` oder Onboarding beim ersten Start, wählt die Methode vor, ohne sie zu erzwingen; Claude Code überprüft die Organisation für claude.ai-Kontoanmeldungen im Terminal, VS Code-Erweiterung und Agent SDK, und überprüft sie nicht für Claude Console-Anmeldungen oder für [Gateway](/docs/de/claude-apps-gateway)-Anmeldung. Vor v2.1.212 galten nur Terminal-Anmeldungen für beide Schlüssel. Wenn festgelegt, werden Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, beim Start blockiert; Cloud-Provider-Sitzungen sind nicht betroffen | `forceLoginMethod`, `forceLoginOrgUUID` |108| [Anmeldung erzwingen](/docs/de/settings-reference#forceloginmethod) | Anmeldung auf eine bestimmte Methode oder Anthropic-Organisation beschränken. Die Methodenbeschränkung gilt über die VS Code-Erweiterung, Agent SDK, `claude setup-token` und `/install-github-app` hinweg, und der Terminal-Bildschirm für interaktive Anmeldung, erreichbar durch `/login` oder Onboarding beim ersten Start, wählt die Methode vor, ohne sie zu erzwingen; Claude Code überprüft die Organisation für claude.ai-Kontoanmeldungen im Terminal, VS Code-Erweiterung und Agent SDK, und überprüft sie nicht für Claude Console-Anmeldungen oder für [Gateway](/docs/de/claude-apps-gateway)-Anmeldung. Vor v2.1.212 galten nur Terminal-Anmeldungen für beide Schlüssel. Wenn festgelegt, werden Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, beim Start blockiert; Cloud-Provider-Sitzungen sind nicht betroffen, es sei denn, eines dieser Anmeldedaten oder ein API-Schlüssel, der durch eine frühere Claude Console-Anmeldung gespeichert wurde, ist ebenfalls vorhanden | `forceLoginMethod`, `forceLoginOrgUUID` |

109| [Agent-Ansicht deaktivieren](/docs/de/agent-view#how-background-sessions-are-hosted) | Schalten Sie `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor aus | `disableAgentView` |109| [Agent-Ansicht deaktivieren](/docs/de/agent-view#how-background-sessions-are-hosted) | Schalten Sie `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor aus | `disableAgentView` |

110| [Corporate Launcher konfigurieren](/docs/de/corporate-launcher) | Präfix des [Background-Agent-Supervisors](/docs/de/agent-view#how-background-sessions-are-hosted), seiner Worker und der [anderen abgedeckten Background-Prozesse](/docs/de/corporate-launcher#what-the-launcher-covers) mit einem erforderlichen Corporate Launcher, anstatt die Agent-Ansicht auszuschalten | `processWrapper` |110| [Corporate Launcher konfigurieren](/docs/de/corporate-launcher) | Präfix des [Background-Agent-Supervisors](/docs/de/agent-view#how-background-sessions-are-hosted), seiner Worker und der [anderen abgedeckten Background-Prozesse](/docs/de/corporate-launcher#what-the-launcher-covers) mit einem erforderlichen Corporate Launcher, anstatt die Agent-Ansicht auszuschalten | `processWrapper` |

111| [Modelleinschränkungen](/docs/de/model-config#restrict-model-selection) | `availableModels` filtert, welche Modelle in der Auswahl angezeigt werden. Das Hinzufügen von `enforceAvailableModels` beschränkt auch das automatisch ausgewählte Standardmodell. Siehe [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) für die Erreichbarkeit dieser Einstellung in CLI, Web und IDE | `availableModels`, `enforceAvailableModels` |111| [Modelleinschränkungen](/docs/de/model-config#restrict-model-selection) | `availableModels` filtert, welche Modelle in der Auswahl angezeigt werden. Das Hinzufügen von `enforceAvailableModels` beschränkt auch das automatisch ausgewählte Standardmodell. Siehe [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) für die Erreichbarkeit dieser Einstellung in CLI, Web und IDE | `availableModels`, `enforceAvailableModels` |

advisor.md +3 −2

Details

101| - | - | - |101| - | - | - |

103| Sonnet 4.6 | Fable, Opus, Sonnet | |103| Sonnet 4.6 | Fable, Opus, Sonnet | |

161 161

162* **Reviewed**: Die Zeile bestätigt, dass der Advisor das Gespräch überprüft hat. Wenn der Advisor lesbare Anleitung gegeben hat, drücken Sie `Ctrl+O`, um sie zu lesen.162* **Reviewed**: Die Zeile bestätigt, dass der Advisor das Gespräch überprüft hat. Wenn der Advisor lesbare Anleitung gegeben hat, drücken Sie `Ctrl+O`, um sie zu lesen.

163* **Declined**: Die Zeile lautet `Advisor declined to advise on this request`. Wenn der Advisor einen Grund angegeben hat, drücken Sie `Ctrl+O`, um ihn zu lesen.163* **Declined**: Die Zeile lautet `Advisor declined to advise on this request`. Wenn der Advisor einen Grund angegeben hat, drücken Sie `Ctrl+O`, um ihn zu lesen.

164* **Unavailable**: Der Advisor-Aufruf ist fehlgeschlagen, und die Zeile lautet `Advisor unavailable (<error_code>)`, wobei `<error_code>` der Code ist, den der Aufruf zurückgegeben hat.

164 165

165Claude folgt im Allgemeinen der Anleitung des Advisors, passt sich aber an, wenn seine eigenen Erkenntnisse einer spezifischen Aussage widersprechen: Wenn ein empfohlener Schritt beim Versuch fehlschlägt oder der Dateiinhalt der Anleitung widerspricht, zeigt Claude den Konflikt auf, anstatt die Anleitung bedingungslos zu befolgen.166Claude folgt im Allgemeinen der Anleitung des Advisors, passt sich aber an, wenn seine eigenen Erkenntnisse einer spezifischen Aussage widersprechen: Wenn ein empfohlener Schritt beim Versuch fehlschlägt oder der Dateiinhalt der Anleitung widerspricht, zeigt Claude den Konflikt auf, anstatt die Anleitung bedingungslos zu befolgen.

166 167

agent-sdk/custom-tools.md +9 −8

Details

129Siehe die [`tool()`](/docs/de/agent-sdk/typescript#tool) TypeScript-Referenz oder die [`@tool`](/docs/de/agent-sdk/python#tool) Python-Referenz für vollständige Parameterdetails, einschließlich JSON Schema Input-Formate und Rückgabewertstruktur.129Siehe die [`tool()`](/docs/de/agent-sdk/typescript#tool) TypeScript-Referenz oder die [`@tool`](/docs/de/agent-sdk/python#tool) Python-Referenz für vollständige Parameterdetails, einschließlich JSON Schema Input-Formate und Rückgabewertstruktur.

130 130

131<Tip>131<Tip>

132 Um einen Parameter optional zu machen: Fügen Sie in TypeScript `.default()` zum Zod-Feld hinzu. In Python behandelt das Dict-Schema jeden Schlüssel als erforderlich, daher lassen Sie den Parameter aus dem Schema weg, erwähnen Sie ihn in der Beschreibungszeichenkette und lesen Sie ihn mit `args.get()` im Handler. Das [`get_precipitation_chance` Tool unten](#add-more-tools) zeigt beide Muster.132 Um einen Parameter optional zu machen: Fügen Sie in TypeScript `.optional()` zum Zod-Feld hinzu und wenden Sie den Standard im Handler an. In Python behandelt das Dict-Schema jeden Schlüssel als erforderlich, daher lassen Sie den Parameter aus dem Schema weg, erwähnen Sie ihn in der Beschreibungszeichenkette und lesen Sie ihn mit `args.get()` im Handler. Das [`get_precipitation_chance` Tool unten](#add-more-tools) zeigt beide Muster.

133</Tip>133</Tip>

134 134

135<h3 id="call-a-custom-tool">135<h3 id="call-a-custom-tool">

248 .int()248 .int()

249 .min(1)249 .min(1)

250 .max(24)250 .max(24)

251 .default(12) // .default() makes the parameter optional251 .optional() // .optional() lets Claude omit the parameter

252 .describe("How many hours of forecast to return")252 .describe("How many hours of forecast to return")

253 },253 },

254 async (args) => {254 async (args) => {

255 const hours = args.hours ?? 12; // Apply the default in the handler

255 const response = await fetch(256 const response = await fetch(

256 `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&hourly=precipitation_probability&forecast_days=1`257 `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&hourly=precipitation_probability&forecast_days=1`

257 );258 );

258 const data: any = await response.json();259 const data: any = await response.json();

259 const chances = data.hourly.precipitation_probability.slice(0, args.hours);260 const chances = data.hourly.precipitation_probability.slice(0, hours);

260 261

261 return {262 return {

262 content: [{ type: "text", text: `Next ${args.hours} hours: ${chances.join("%, ")}%` }]263 content: [{ type: "text", text: `Next ${hours} hours: ${chances.join("%, ")}%` }]

263 };264 };

264 }265 }

265 );266 );

469 Bilder470 Bilder

470</h3>471</h3>

471 472

472Ein Bild-Block enthält die Bild-Bytes inline, kodiert als Base64. Es gibt kein URL-Feld. Um ein Bild zurückzugeben, das sich unter einer URL befindet, rufen Sie es im Handler ab, lesen Sie die Antwort-Bytes und kodieren Sie sie mit Base64, bevor Sie sie zurückgeben. Das Ergebnis wird als visuelle Eingabe verarbeitet.473Ein Bild-Block enthält die Bild-Bytes inline, kodiert als Base64. Es gibt kein URL-Feld. Um ein Bild zurückzugeben, das sich unter einer URL befindet, rufen Sie es im Handler ab, lesen Sie die Antwort-Bytes und kodieren Sie sie mit Base64, bevor Sie sie zurückgeben. Ein PNG-, JPEG-, GIF- oder WebP-Bild erreicht Claude als visuelle Eingabe; ein Bild eines anderen Typs wird auf der Festplatte gespeichert und Claude erhält seinen Dateipfad als Text statt dessen.

473 474

474| Feld | Typ | Hinweise |475| Feld | Typ | Hinweise |

475| :- | :- | :- |476| :- | :- | :- |

538 Ressourcen539 Ressourcen

539</h3>540</h3>

540 541

541Ein Ressourcen-Block bettet ein Stück Inhalt ein, das durch eine URI identifiziert wird. Die URI ist ein Label für Claude zum Referenzieren; der tatsächliche Inhalt befindet sich im `text`- oder `blob`-Feld des Blocks. Verwenden Sie dies, wenn Ihr Tool etwas erzeugt, das später sinnvoll ist, um es nach Name zu adressieren, wie z. B. eine generierte Datei oder einen Datensatz aus einem externen System.542Ein Ressourcen-Block bettet ein Stück Inhalt ein, das durch eine URI identifiziert wird. Der tatsächliche Inhalt befindet sich im `text`- oder `blob`-Feld des Blocks. Verwenden Sie dies, wenn Ihr Tool eine generierte Datei oder einen Datensatz aus einem externen System erzeugt.

542 543

543| Feld | Typ | Hinweise |544| Feld | Typ | Hinweise |

544| :- | :- | :- |545| :- | :- | :- |

548| `resource.blob` | `string` | Der Inhalt Base64-kodiert, falls er binär ist. Nur TypeScript: Das Python SDK verwirft binäre Ressourcen aus dem Tool-Ergebnis und protokolliert eine Warnung |549| `resource.blob` | `string` | Der Inhalt Base64-kodiert, falls er binär ist. Nur TypeScript: Das Python SDK verwirft binäre Ressourcen aus dem Tool-Ergebnis und protokolliert eine Warnung |

550 551

551Dieses Beispiel zeigt einen Ressourcen-Block, der von innerhalb eines Tool-Handlers zurückgegeben wird. Die URI `file:///tmp/report.md` ist ein Label, auf das Claude später verweisen kann; das SDK liest nicht aus diesem Pfad.552Dieses Beispiel zeigt einen Ressourcen-Block, der von innerhalb eines Tool-Handlers zurückgegeben wird. Das SDK liest nicht aus dem URI des Beispiels, `file:///tmp/report.md`.

552 553

553<CodeGroup>554<CodeGroup>

554 ```typescript TypeScript theme={null}555 ```typescript TypeScript theme={null}

572 {573 {

573 "type": "resource",574 "type": "resource",

574 "resource": {575 "resource": {

575 "uri": "file:///tmp/report.md", # Label for Claude to reference, not a path the SDK reads576 "uri": "file:///tmp/report.md", # Not a path the SDK reads

576 "mimeType": "text/markdown",577 "mimeType": "text/markdown",

577 "text": "# Report\n...", # The actual content, inline578 "text": "# Report\n...", # The actual content, inline

578 },579 },

agent-sdk/examples.md +4 −4

Details

6 6

7> Finden Sie ein vollständiges, ausführbares Agent SDK-Projekt oder ein geführtes Rezept aus dem Claude Cookbook, das zu dem passt, was Sie erstellen möchten.7> Finden Sie ein vollständiges, ausführbares Agent SDK-Projekt oder ein geführtes Rezept aus dem Claude Cookbook, das zu dem passt, was Sie erstellen möchten.

8 8

9Diese Seite leitet Sie zu vollständigen, ausführbaren Agent SDK-Projekten und geführten Claude Cookbook-Rezepten weiter. TypeScript-Anwendungen befinden sich im Repository [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos), und Python-Rezepte befinden sich im [Claude Cookbook](https://platform.claude.com/cookbook).9Diese Seite leitet Sie zu vollständigen, ausführbaren Agent SDK-Projekten und geführten Claude Cookbook-Rezepten weiter. Die Anwendungen befinden sich im Repository [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos), und Python-Rezepte befinden sich im [Claude Cookbook](https://platform.claude.com/cookbook).

10 10

11<h2 id="run-a-minimal-agent-first">11<h2 id="run-a-minimal-agent-first">

12 Führen Sie zuerst einen minimalen Agent aus12 Führen Sie zuerst einen minimalen Agent aus

18 18

19* [Hello World](https://github.com/anthropics/claude-agent-sdk-demos/tree/main/hello-world): ein minimales TypeScript-Projekt zum Klonen, wenn Sie von Repository-Code aus starten möchten19* [Hello World](https://github.com/anthropics/claude-agent-sdk-demos/tree/main/hello-world): ein minimales TypeScript-Projekt zum Klonen, wenn Sie von Repository-Code aus starten möchten

20 20

~~21<h2 id="explore-a-typescript-application">~~21<h2 id="explore-a-demo-application">

~~22 Erkunden Sie eine TypeScript-Anwendung~~22 Erkunden Sie eine Demo-Anwendung

23</h2>23</h2>

24 24

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

26 26

27<h2 id="work-through-a-python-recipe">27<h2 id="work-through-a-python-recipe">

28 Arbeiten Sie ein Python-Rezept durch28 Arbeiten Sie ein Python-Rezept durch

agent-sdk/file-checkpointing.md +8 −127

Details

6 6

7> Verfolgen Sie Dateiänderungen während Agent-Sitzungen und stellen Sie Dateien in jeden vorherigen Zustand wieder her7> Verfolgen Sie Dateiänderungen während Agent-Sitzungen und stellen Sie Dateien in jeden vorherigen Zustand wieder her

8 8

9File Checkpointing verfolgt Dateiänderungen, die während einer Agent-Sitzung durch die Tools Write, Edit und NotebookEdit vorgenommen werden, und ermöglicht es Ihnen, Dateien in jeden vorherigen Zustand zurückzusetzen. Möchten Sie es ausprobieren? Springen Sie zum [interaktiven Beispiel](#try-it-out).9File Checkpointing verfolgt Dateiänderungen, die während einer Agent-Sitzung durch die Tools [Write](/docs/de/tools-reference#write-tool-behavior), [Edit](/docs/de/tools-reference#edit-tool-behavior) und [NotebookEdit](/docs/de/tools-reference#notebookedit-tool-behavior) vorgenommen werden, und ermöglicht es Ihnen, Dateien in jeden vorherigen Zustand zurückzusetzen. Um zu sehen, wie ein Rewind eine Datei wiederherstellt, springen Sie zum [interaktiven Beispiel](#try-it-out).

~~11Mit Checkpointing können Sie:~~

~~13* **Unerwünschte Änderungen rückgängig machen**, indem Sie Dateien in einen bekannten guten Zustand zurücksetzen~~

~~14* **Alternativen erkunden**, indem Sie zu einem Checkpoint zurückkehren und einen anderen Ansatz versuchen~~

~~15* **Von Fehlern wiederherstellen**, wenn der Agent fehlerhafte Änderungen vornimmt~~

16 10

17<Warning>11<Warning>

18 Nur Änderungen, die durch die Tools Write, Edit und NotebookEdit vorgenommen werden, werden verfolgt. Änderungen, die durch Bash-Befehle vorgenommen werden (wie `echo > file.txt` oder `sed -i`), werden vom Checkpoint-System nicht erfasst, und auch nicht die Änderungen, die ein [Subagent](/docs/de/agent-sdk/subagents) vornimmt, mit Ausnahme eines [Skills mit `context: fork`](/docs/de/skills#run-skills-in-a-subagent), der im Vordergrund ausgeführt wird.12 Nur Änderungen, die durch die Tools Write, Edit und NotebookEdit vorgenommen werden, werden verfolgt. Änderungen, die durch Bash-Befehle vorgenommen werden (wie `echo > file.txt` oder `sed -i`), werden vom Checkpoint-System nicht erfasst, und auch nicht die Änderungen, die ein [Subagent](/docs/de/agent-sdk/subagents) vornimmt, mit Ausnahme eines [Skills mit `context: fork`](/docs/de/skills#run-skills-in-a-subagent), der im Vordergrund ausgeführt wird.

36 30

37Um File Checkpointing zu verwenden, aktivieren Sie es in Ihren Optionen, erfassen Sie Checkpoint-UUIDs aus dem Response-Stream und rufen Sie `rewindFiles()` (TypeScript) oder `rewind_files()` (Python) auf, wenn Sie Dateien wiederherstellen müssen.31Um File Checkpointing zu verwenden, aktivieren Sie es in Ihren Optionen, erfassen Sie Checkpoint-UUIDs aus dem Response-Stream und rufen Sie `rewindFiles()` (TypeScript) oder `rewind_files()` (Python) auf, wenn Sie Dateien wiederherstellen müssen.

38 32

39Das folgende Beispiel zeigt den vollständigen Ablauf: Aktivieren Sie Checkpointing, erfassen Sie die Checkpoint-UUID und Session-ID aus dem Response-Stream, und setzen Sie die Sitzung später fort, um Dateien zurückzuspulen. Jeder Schritt wird unten im Detail erläutert. Die Beispiele in diesem Abschnitt verwenden die Eingabeaufforderung „Refactor the authentication module". Führen Sie sie in einem Projekt aus, das ein Authentifizierungsmodul enthält, oder ändern Sie die Eingabeaufforderung, um Dateien zu benennen, die in Ihrem Projekt vorhanden sind, damit Sie Dateiänderungen beobachten und sehen können, wie das Zurückspulen sie wiederherstellt.33Die Beispiele in diesem Abschnitt verwenden die Eingabeaufforderung „Refactor the authentication module". Führen Sie sie in einem Projekt aus, das ein Authentifizierungsmodul enthält, oder ändern Sie die Eingabeaufforderung, um Dateien zu benennen, die in Ihrem Projekt vorhanden sind, damit Sie Dateiänderungen beobachten und sehen können, wie das Zurückspulen sie wiederherstellt.

35Dieses Beispiel aktiviert Checkpointing, erfasst die Checkpoint-UUID und Session-ID aus dem Response-Stream und setzt die Sitzung später fort, um Dateien zurückzuspulen. Die nummerierten Kommentare des Beispiels entsprechen den folgenden Schritten.

40 36

41<CodeGroup>37<CodeGroup>

42 ```python Python theme={null}38 ```python Python theme={null}

154 | Checkpoint-UUIDs erhalten | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | Erforderlich, um Benutzermeldungs-UUIDs im Stream zu erhalten |150 | Checkpoint-UUIDs erhalten | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | Erforderlich, um Benutzermeldungs-UUIDs im Stream zu erhalten |

155 151

156 <CodeGroup>152 Das führende Beispiel unter [Checkpointing implementieren](#implement-checkpointing) setzt auch den Berechtigungsmodus auf `acceptEdits`, was die Dateibearbeitungen des Agenten ohne Eingabeaufforderung genehmigt. Weitere Informationen finden Sie unter [Berechtigungsmodi](/docs/de/agent-sdk/permissions#permission-modes).

157 ```python Python theme={null}

158 options = ClaudeAgentOptions(

159 enable_file_checkpointing=True,

160 permission_mode="acceptEdits",

161 extra_args={"replay-user-messages": None},

162 )

~~163~~

164 async with ClaudeSDKClient(options) as client:

165 await client.query("Refactor the authentication module")

166 ```

~~167~~

168 ```typescript TypeScript theme={null}

169 const response = query({

170 prompt: "Refactor the authentication module",

171 options: {

172 enableFileCheckpointing: true,

173 permissionMode: "acceptEdits" as const,

174 extraArgs: { "replay-user-messages": null }

175 }

176 });

177 ```

178 </CodeGroup>

179 </Step>153 </Step>

180 154

181 <Step title="Checkpoint-UUID und Session-ID erfassen">155 <Step title="Checkpoint-UUID und Session-ID erfassen">

184 Für die meisten Anwendungsfälle erfassen Sie die UUID der ersten Benutzermeldung (`message.uuid`); das Zurückspulen zu ihr stellt alle Dateien in ihren ursprünglichen Zustand wieder her. Um mehrere Checkpoints zu speichern und zu Zwischenzuständen zurückzuspulen, siehe [Mehrere Wiederherstellungspunkte](#multiple-restore-points).158 Für die meisten Anwendungsfälle erfassen Sie die UUID der ersten Benutzermeldung (`message.uuid`); das Zurückspulen zu ihr stellt alle Dateien in ihren ursprünglichen Zustand wieder her. Um mehrere Checkpoints zu speichern und zu Zwischenzuständen zurückzuspulen, siehe [Mehrere Wiederherstellungspunkte](#multiple-restore-points).

185 159

186 Das Erfassen der Session-ID (`message.session_id`) ist optional; Sie benötigen sie nur, wenn Sie später zurückspulen möchten, nachdem der Stream abgeschlossen ist. Wenn Sie `rewindFiles()` sofort aufrufen, während Sie noch Meldungen verarbeiten (wie das Beispiel in [Checkpoint vor riskanten Operationen](#checkpoint-before-risky-operations) zeigt), können Sie das Erfassen der Session-ID überspringen.160 Das Erfassen der Session-ID (`message.session_id`) ist optional; Sie benötigen sie nur, wenn Sie später zurückspulen möchten, nachdem der Stream abgeschlossen ist. Wenn Sie `rewindFiles()` sofort aufrufen, während Sie noch Meldungen verarbeiten (wie das Beispiel in [Checkpoint vor riskanten Operationen](#checkpoint-before-risky-operations) zeigt), können Sie das Erfassen der Session-ID überspringen.

~~187~~

188 <CodeGroup>

189 ```python Python theme={null}

190 checkpoint_id = None

191 session_id = None

~~192~~

193 async for message in client.receive_response():

194 # Capture the first user message UUID as the checkpoint

195 if isinstance(message, UserMessage) and message.uuid and checkpoint_id is None:

196 checkpoint_id = message.uuid

197 # Capture session ID from the result message

198 if isinstance(message, ResultMessage):

199 session_id = message.session_id

200 ```

~~201~~

202 ```typescript TypeScript theme={null}

203 let checkpointId: string | undefined;

204 let sessionId: string | undefined;

~~205~~

206 for await (const message of response) {

207 // Capture the first user message UUID as the checkpoint

208 if (message.type === "user" && message.uuid && !checkpointId) {

209 checkpointId = message.uuid;

210 }

211 // Capture session ID from any message that has it

212 if ("session_id" in message) {

213 sessionId = message.session_id;

214 }

215 }

216 ```

217 </CodeGroup>

218 </Step>161 </Step>

219 162

220 <Step title="Dateien zurückspulen">163 <Step title="Dateien zurückspulen">

221 Um nach Abschluss des Streams zurückzuspulen, setzen Sie die Sitzung mit einer leeren Eingabeaufforderung fort und rufen Sie `rewind_files()` (Python) oder `rewindFiles()` (TypeScript) mit Ihrer Checkpoint-UUID auf. Sie können auch während des Streams zurückspulen; siehe [Checkpoint vor riskanten Operationen](#checkpoint-before-risky-operations) für dieses Muster.164 Um nach Abschluss des Streams zurückzuspulen, setzen Sie die Sitzung mit einer leeren Eingabeaufforderung fort und rufen Sie `rewind_files()` (Python) oder `rewindFiles()` (TypeScript) mit Ihrer Checkpoint-UUID auf. Aktivieren Sie Checkpointing auch in den Optionen der fortgesetzten Sitzung und rufen Sie rewind aus der Response-Schleife auf. Sie können auch während des Streams zurückspulen. Siehe [Checkpoint vor riskanten Operationen](#checkpoint-before-risky-operations) für dieses Muster.

222 165

223 <CodeGroup>166 Wenn Sie die Session-ID und Checkpoint-ID erfassen, können Sie auch von der CLI aus zurückspulen. Dieser Befehl erfordert die ausführbare Datei `claude`, die von der [Installation von Claude Code](/docs/de/setup) stammt. Das SDK aktiviert Checkpointing für Sie, aber wenn Sie `claude -p` direkt ausführen, müssen Sie die Umgebungsvariable `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING` setzen:

224 ```python Python theme={null}

225 async with ClaudeSDKClient(

226 ClaudeAgentOptions(enable_file_checkpointing=True, resume=session_id)

227 ) as client:

228 await client.query("") # Empty prompt to open the connection

229 async for message in client.receive_response():

230 if checkpoint_id:

231 await client.rewind_files(checkpoint_id)

232 break

233 ```

~~234~~

235 ```typescript TypeScript theme={null}

236 const rewindQuery = query({

237 prompt: "", // Empty prompt to open the connection

238 options: { ...opts, resume: sessionId }

239 });

~~240~~

241 for await (const msg of rewindQuery) {

242 if (checkpointId) {

243 await rewindQuery.rewindFiles(checkpointId);

244 }

245 break;

246 }

247 ```

248 </CodeGroup>

~~249~~

250 Wenn Sie die Session-ID und Checkpoint-ID erfassen, können Sie auch von der CLI aus zurückspulen. Dieser Befehl erfordert die ausführbare Datei `claude`, die von der [Installation von Claude Code](/docs/de/setup) stammt und nicht vom SDK-Paket installiert wird. Das SDK aktiviert Checkpointing für Sie, aber wenn Sie `claude -p` direkt ausführen, müssen Sie die Umgebungsvariable `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING` setzen:

251 167

252 ```bash theme={null}168 ```bash theme={null}

253 CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>169 CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>

783 699

784Dieser Fehler tritt auf, wenn Sie `rewindFiles()` oder `rewind_files()` aufrufen, nachdem Sie die Iteration durch die Antwort abgeschlossen haben. Die Verbindung zum CLI-Prozess wird geschlossen, wenn die Schleife abgeschlossen ist.700Dieser Fehler tritt auf, wenn Sie `rewindFiles()` oder `rewind_files()` aufrufen, nachdem Sie die Iteration durch die Antwort abgeschlossen haben. Die Verbindung zum CLI-Prozess wird geschlossen, wenn die Schleife abgeschlossen ist.

785 701

786**Lösung**: Setzen Sie die Sitzung mit einer leeren Eingabeaufforderung fort und rufen Sie dann rewind auf der neuen Abfrage auf:702**Lösung**: Setzen Sie die Sitzung mit einer leeren Eingabeaufforderung fort und rufen Sie dann rewind auf der neuen Abfrage auf. Das führende Beispiel unter [Implement checkpointing](#implement-checkpointing) zeigt den Resume-and-Rewind-Aufruf in beiden Sprachen, bei dem Kommentar mit der Bezeichnung Step 3.

~~787~~

788<CodeGroup>

789 ```python Python theme={null}

790 # Resume session with empty prompt, then rewind

791 async with ClaudeSDKClient(

792 ClaudeAgentOptions(enable_file_checkpointing=True, resume=session_id)

793 ) as client:

794 await client.query("")

795 async for message in client.receive_response():

796 if checkpoint_id:

797 await client.rewind_files(checkpoint_id)

798 break

799 ```

~~800~~

801 ```typescript TypeScript theme={null}

802 // Resume session with empty prompt, then rewind

803 const rewindQuery = query({

804 prompt: "",

805 options: { ...opts, resume: sessionId }

806 });

~~807~~

808 try {

809 for await (const msg of rewindQuery) {

810 if (checkpointId) {

811 await rewindQuery.rewindFiles(checkpointId);

812 }

813 break;

814 }

815 } catch (error) {

816 // An error here means the rewind didn't complete, for example the checkpoint

817 // wasn't found or the session couldn't be resumed.

818 console.error(`Rewind session ended with an error: ${error}`);

819 }

820 ```

821</CodeGroup>

822 703

823<h2 id="next-steps">704<h2 id="next-steps">

824 Nächste Schritte705 Nächste Schritte

agent-sdk/hosting.md +6 −1

Details

127 127

128Beispielworkloads umfassen einen E-Mail-Agenten, der eingehende Post sortiert und beantwortet, einen Website-Builder, der eine pro Benutzer bearbeitbare Website über Container-Ports hostet, und einen Chatbot, der kontinuierlichen Datenverkehr von einer Plattform wie Slack verarbeitet.128Beispielworkloads umfassen einen E-Mail-Agenten, der eingehende Post sortiert und beantwortet, einen Website-Builder, der eine pro Benutzer bearbeitbare Website über Container-Ports hostet, und einen Chatbot, der kontinuierlichen Datenverkehr von einer Plattform wie Slack verarbeitet.

129 129

130Der Container stellt einen HTTP- oder WebSocket-Endpunkt bereit und ordnet jede aktive Sitzung einer langlebigen Abfrage und dem dahinter stehenden Unterprozess zu. In TypeScript verwenden Sie [`streamInput()`](/docs/de/agent-sdk/typescript#query-object), um Züge zu einer aktiven Sitzung hinzuzufügen, und [`startup()`](/docs/de/agent-sdk/typescript#startup), um Unterprozesse vor eingehendem Datenverkehr vorzuwärmen. In Python verwenden Sie [`ClaudeSDKClient`](/docs/de/agent-sdk/python#claudesdkclient), um eine Sitzung über Züge hinweg offen zu halten. Dimensionieren Sie den Container so, dass er die maximale Anzahl gleichzeitiger Sitzungen im Speicher halten kann.130Der Container stellt einen HTTP- oder WebSocket-Endpunkt bereit und ordnet jede aktive Sitzung einer langlebigen Abfrage und dem dahinter stehenden Unterprozess zu. Die Aufrufe, die Sitzungen offen und warm halten, unterscheiden sich zwischen den SDKs:

131

132* **TypeScript**: Verwenden Sie [`streamInput()`](/docs/de/agent-sdk/typescript#query-object), um Züge zu einer aktiven Sitzung hinzuzufügen. Rufen Sie [`startup()`](/docs/de/agent-sdk/typescript#startup) auf, um Unterprozesse vor eingehendem Datenverkehr vorzuwärmen. Wenn Sie das Arbeitsverzeichnis einer Sitzung erst bei Ankunft der ersten Anfrage kennen, wärmen Sie stattdessen mit [`prewarm()`](/docs/de/agent-sdk/typescript#prewarm) vor.

133* **Python**: Verwenden Sie [`ClaudeSDKClient`](/docs/de/agent-sdk/python#claudesdkclient), um eine Sitzung über Züge hinweg offen zu halten.

134

135Dimensionieren Sie den Container so, dass er die maximale Anzahl gleichzeitiger Sitzungen im Speicher halten kann.

131 136

132<h3 id="hybrid-sessions">137<h3 id="hybrid-sessions">

133 Hybrid-Sitzungen138 Hybrid-Sitzungen

agent-sdk/mcp.md +1 −1

Details

162| :- | :- | :- |162| :- | :- | :- |

163| Stdio-Server oder HTTP/SSE-Server ohne zwischengespeicherte Werkzeugliste | Ja, bis zur Verbindung | [`MCP_TIMEOUT`](/docs/de/env-vars), standardmäßig 30 Sekunden; die Verbindung schlägt bei dieser Frist fehl |163| Stdio-Server oder HTTP/SSE-Server ohne zwischengespeicherte Werkzeugliste | Ja, bis zur Verbindung | [`MCP_TIMEOUT`](/docs/de/env-vars), standardmäßig 30 Sekunden; die Verbindung schlägt bei dieser Frist fehl |

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

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

166 166

167Server, die aus [Konfigurationsdateien](#from-a-config-file) wie `.mcp.json` oder aus Plugins geladen werden, zeigen häufig `pending` in der Init-Nachricht an. Wenn `options.mcpServers` einen Stdio-, HTTP- oder SSE-Server enthält, wartet die erste Runde auch auf diese ausstehenden Server, bis zu `MCP_TIMEOUT`. Wenn `options.mcpServers` leer ist oder nur SDK-Server enthält, wartet die erste Runde stattdessen bis zu 2 Sekunden:167Server, die aus [Konfigurationsdateien](#from-a-config-file) wie `.mcp.json` oder aus Plugins geladen werden, zeigen häufig `pending` in der Init-Nachricht an. Wenn `options.mcpServers` einen Stdio-, HTTP- oder SSE-Server enthält, wartet die erste Runde auch auf diese ausstehenden Server, bis zu `MCP_TIMEOUT`. Wenn `options.mcpServers` leer ist oder nur SDK-Server enthält, wartet die erste Runde stattdessen bis zu 2 Sekunden:

168 168

agent-sdk/modifying-system-prompts.md +123 −8

Details

14 14

15Eine Systemaufforderung ist der anfängliche Anweisungssatz, der definiert, wie sich Claude während eines Gesprächs verhält. Das Agent SDK hat drei Ausgangspunkte dafür:15Eine Systemaufforderung ist der anfängliche Anweisungssatz, der definiert, wie sich Claude während eines Gesprächs verhält. Das Agent SDK hat drei Ausgangspunkte dafür:

16 16

17* **Minimale Standardeinstellung**: Wenn Sie `systemPrompt` in TypeScript oder `system_prompt` in Python nicht festlegen, verwendet das SDK eine minimale Aufforderung, die Werkzeugaufrufe abdeckt, aber den Rest des `claude_code`-Presets auslässt, einschließlich seiner Sicherheits- und Sicherheitsanweisungen sowie seines Kontexts zum Arbeitsverzeichnis und zur Umgebung. Dies unterscheidet sich von `claude -p`, das standardmäßig die Claude Code-Systemaufforderung verwendet. Wenn Sie von der CLI migrieren und ein übereinstimmendes Verhalten wünschen, legen Sie das `claude_code`-Preset fest.17* **Minimale Standardeinstellung**: Wenn Sie `systemPrompt` in TypeScript oder `system_prompt` in Python nicht festlegen, verwendet das SDK eine minimale Aufforderung, die Werkzeugaufrufe abdeckt, aber den Rest des `claude_code`-Presets auslässt, einschließlich seiner Sicherheits- und Sicherheitsanweisungen. Dies unterscheidet sich von `claude -p`, das standardmäßig die Claude Code-Systemaufforderung verwendet. Wenn Sie von der CLI migrieren und ein übereinstimmendes Verhalten wünschen, legen Sie das `claude_code`-Preset fest.

18* **`claude_code`-Preset**: die Systemaufforderung, die die Claude Code CLI verwendet, mit Werkzeugnutzungsanweisungen, Sicherheits- und Sicherheitsanweisungen sowie Kontext zum Arbeitsverzeichnis und zur Umgebung. Legen Sie `systemPrompt: { type: "preset", preset: "claude_code" }` in TypeScript oder `system_prompt={"type": "preset", "preset": "claude_code"}` in Python fest, optional mit `append`, um Ihre eigenen Anweisungen am Ende hinzuzufügen.18* **`claude_code`-Preset**: die Systemaufforderung, die die Claude Code CLI verwendet, mit Werkzeugnutzungsanweisungen und Sicherheits- und Sicherheitsanweisungen. Legen Sie `systemPrompt: { type: "preset", preset: "claude_code" }` in TypeScript oder `system_prompt={"type": "preset", "preset": "claude_code"}` in Python fest, optional mit `append`, um Ihre eigenen Anweisungen am Ende hinzuzufügen.

19* **Benutzerdefinierte Zeichenkette**: eine Aufforderung, die Sie selbst schreiben. Das SDK sendet nur das, was Sie bereitstellen.19* **Benutzerdefinierte Zeichenkette**: eine Aufforderung, die Sie selbst schreiben. Das SDK sendet nur das, was Sie bereitstellen.

20 20

21<h3 id="decide-on-a-starting-point">21<h3 id="decide-on-a-starting-point">

26 26

28| :- | :- | :- |28| :- | :- | :- |

29| Ein CLI- oder IDE-ähnliches Codierungswerkzeug, bei dem ein Mensch beobachtet und lenkt, und Claude Code's Standardeinstellungen sind das, was Sie wünschen | `claude_code`-Preset | Die Claude Code-Aufforderung, einschließlich Werkzeuganleitung, Sicherheitsregeln und Umgebungskontext |29| Ein CLI- oder IDE-ähnliches Codierungswerkzeug, bei dem ein Mensch beobachtet und lenkt, und Claude Code's Standardeinstellungen sind das, was Sie wünschen | `claude_code`-Preset | Die Claude Code-Aufforderung, einschließlich Werkzeuganleitung und Sicherheitsregeln |

30| Das gleiche Werkzeug plus produktspezifische Regeln wie Codierungsstandards, Ausgabeformat oder Domänenkontext | `claude_code`-Preset mit `append` | Alles oben Genannte, mit Ihren Anweisungen nach dem Preset hinzugefügt. Nichts wird entfernt, daher ist dies die Anpassung mit dem niedrigsten Risiko |30| Das gleiche Werkzeug plus produktspezifische Regeln wie Codierungsstandards, Ausgabeformat oder Domänenkontext | `claude_code`-Preset mit `append` | Alles oben Genannte, mit Ihren Anweisungen nach dem Preset hinzugefügt. Nichts wird entfernt, daher ist dies die Anpassung mit dem niedrigsten Risiko |

31| Ein Agent mit einer anderen Oberfläche, Identität oder Berechtigungsmodell, oder ein Nicht-Codierungs-Agent | Benutzerdefinierte Aufforderungszeichenkette | Nur das, was Sie schreiben. Sie tragen die Verantwortung für das Ersetzen der Werkzeuganleitung und Sicherheitsanweisungen, die Ihr Agent noch benötigt |31| Ein Agent mit einer anderen Oberfläche, Identität oder Berechtigungsmodell, oder ein Nicht-Codierungs-Agent | Benutzerdefinierte Aufforderungszeichenkette | Nur das, was Sie schreiben. Sie tragen die Verantwortung für das Ersetzen der Werkzeuganleitung und Sicherheitsanweisungen, die Ihr Agent noch benötigt |

32| Eine dünne Werkzeugaufrufs-Schleife ohne Agent-Persona, bei der Sie alles Verhalten in der Benutzeraufforderung bereitstellen | Keine `systemPrompt`-Option | Die minimale Standardeinstellung: Werkzeugaufrufs-Unterstützung und nichts anderes |32| Eine dünne Werkzeugaufrufs-Schleife ohne Agent-Persona, bei der Sie alles Verhalten in der Benutzeraufforderung bereitstellen | Keine `systemPrompt`-Option | Die minimale Standardeinstellung: Werkzeugaufrufs-Unterstützung und nichts anderes |

225 Prompt-Caching über Benutzer und Maschinen verbessern225 Prompt-Caching über Benutzer und Maschinen verbessern

226</h4>226</h4>

227 227

228Standardmäßig können zwei Sitzungen, die die gleiche `claude_code`-Voreinstellung und den gleichen `append`-Text verwenden, keinen Prompt-Cache-Eintrag teilen, wenn sie von verschiedenen Arbeitsverzeichnissen aus ausgeführt werden. Dies liegt daran, dass die Voreinstellung sitzungsspezifischen Kontext in die Systemaufforderung vor Ihrem `append`-Text einbettet: das Arbeitsverzeichnis, ob es sich um ein Git-Repository handelt, die Plattform, die aktive Shell, die Betriebssystemversion und Auto-Memory-Pfade. Jeder Unterschied in diesem Kontext erzeugt eine andere Systemaufforderung und einen Cache-Miss. CLAUDE.md-Inhalt beeinflusst den Systemaufforderungs-Cache nicht, da das SDK ihn in die Konversation injiziert, nicht in die Systemaufforderung.228Standardmäßig können zwei Sitzungen, die die gleiche `claude_code`-Voreinstellung und den gleichen `append`-Text verwenden, keinen Prompt-Cache-Eintrag teilen, wenn sich ihre Auto-Memory-Speicherorte unterscheiden. Die Voreinstellung bettet diesen Speicherort in die Systemaufforderung vor Ihrem `append`-Text ein. Der Speicherort ist standardmäßig ein absoluter Pfad unter `~/.claude/projects/`, benannt nach dem Pfad des Repositorys auf der Festplatte, daher unterscheidet er sich zwischen Benutzern, Maschinen und Checkouts.

229 229

230Um die Systemaufforderung über Sitzungen hinweg identisch zu machen, setzen Sie `excludeDynamicSections: true` in TypeScript oder `"exclude_dynamic_sections": True` in Python. Der sitzungsspezifische Kontext wird in die erste Benutzernachricht verschoben, sodass nur die statische Voreinstellung und Ihr `append`-Text in der Systemaufforderung verbleiben, damit identische Konfigurationen einen Cache-Eintrag über Benutzer und Maschinen hinweg teilen können.230CLAUDE.md-Inhalt und Umgebungsdetails wie das Arbeitsverzeichnis, die Plattform, die Shell und die Betriebssystemversion beeinflussen den Systemaufforderungs-Cache nicht, da Claude Code sie in der Konversation bereitstellt, nicht in der Systemaufforderung.

231

232Um die Systemaufforderung über Sitzungen hinweg identisch zu machen, setzen Sie `excludeDynamicSections: true` in TypeScript oder `"exclude_dynamic_sections": True` in Python. Der Pro-Benutzer-Kontext wird in die erste Benutzernachricht verschoben, sodass nur die statische Voreinstellung und Ihr `append`-Text in der Systemaufforderung verbleiben, damit identische Konfigurationen einen Cache-Eintrag über Benutzer und Maschinen hinweg teilen können.

231 233

232<Note>234<Note>

233 `excludeDynamicSections` erfordert `@anthropic-ai/claude-agent-sdk` v0.2.98 oder später oder `claude-agent-sdk` v0.1.58 oder später für Python. Setzen Sie es nur auf der Voreinstellungsobjektform. Das SDK ignoriert es, wenn Sie eine benutzerdefinierte Eingabeaufforderung statt der Voreinstellung übergeben; um die statischen Anweisungen einer benutzerdefinierten Eingabeaufforderung im TypeScript SDK zwischengespeichert zu halten, siehe [Cache the static part of a custom prompt](#cache-the-static-part-of-a-custom-prompt).235 `excludeDynamicSections` erfordert `@anthropic-ai/claude-agent-sdk` v0.2.98 oder später oder `claude-agent-sdk` v0.1.58 oder später für Python. Setzen Sie es nur auf der Voreinstellungsobjektform. Das SDK ignoriert es, wenn Sie eine benutzerdefinierte Eingabeaufforderung statt der Voreinstellung übergeben; um die statischen Anweisungen einer benutzerdefinierten Eingabeaufforderung im TypeScript SDK zwischengespeichert zu halten, siehe [Cache the static part of a custom prompt](#cache-the-static-part-of-a-custom-prompt).

234</Note>236</Note>

235 237

236Das folgende Beispiel kombiniert einen gemeinsamen `append`-Block mit `excludeDynamicSections`, sodass eine Flotte von Agenten, die von verschiedenen Verzeichnissen aus ausgeführt werden, die gleiche zwischengespeicherte Systemaufforderung wiederverwenden können:238Das folgende Beispiel kombiniert einen gemeinsamen `append`-Block mit `excludeDynamicSections`, sodass eine Flotte von Agenten die gleiche zwischengespeicherte Systemaufforderung über Benutzer und Maschinen hinweg wiederverwenden können:

237 239

238<CodeGroup>240<CodeGroup>

239 ```typescript TypeScript theme={null}241 ```typescript TypeScript theme={null}

279 ```281 ```

280</CodeGroup>282</CodeGroup>

281 283

282**Kompromisse:** Das Arbeitsverzeichnis, das Git-Repo-Flag, die Plattform, die aktive Shell, die Betriebssystemversion und Auto-Memory-Pfade erreichen Claude immer noch, aber als Teil der ersten Benutzernachricht statt der Systemaufforderung. Anweisungen in der Benutzernachricht haben etwas weniger Gewicht als der gleiche Text in der Systemaufforderung, daher kann Claude sich bei der Überlegung zum aktuellen Verzeichnis oder zu Auto-Memory-Pfaden weniger stark auf sie verlassen. Aktivieren Sie diese Option, wenn die Wiederverwendung des Cross-Session-Cache wichtiger ist als maximal autoritative Umgebungskontexte.284**Kompromisse:** Der Text, der aus der Systemaufforderung verschoben wird, erreicht Claude immer noch, aber in einer Benutzernachricht. Dieser Text ist mindestens der Speicherort des Auto-Memory-Verzeichnisses und oft der gesamte Auto-Memory-Abschnitt. Anweisungen in einer Benutzernachricht haben etwas weniger Gewicht als der gleiche Text in der Systemaufforderung, daher kann Claude seine Auto-Memory-Leitlinien weniger konsistent befolgen. Aktivieren Sie diese Option, wenn die Wiederverwendung des Cross-Session-Cache wichtiger ist als das.

283 285

284Für das entsprechende Flag im nicht-interaktiven CLI-Modus siehe [`--exclude-dynamic-system-prompt-sections`](/docs/de/cli-reference).286Für das entsprechende Flag im nicht-interaktiven CLI-Modus siehe [`--exclude-dynamic-system-prompt-sections`](/docs/de/cli-reference).

285 287

418 420

419Das Aufzeichnen einer `append` oder benutzerdefinierten Eingabeaufforderung standardmäßig erfordert Claude Code v2.1.265 oder später, das das TypeScript Agent SDK ab v0.3.265 und das Python Agent SDK ab v0.2.153 bündelt. Vor Claude Code v2.1.268 erstellten Sitzungen, die keine [Funktionsflags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), einschließlich Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, die Eingabeaufforderung bei jeder Anfrage neu und `snapshot` hatte keine Auswirkung.421Das Aufzeichnen einer `append` oder benutzerdefinierten Eingabeaufforderung standardmäßig erfordert Claude Code v2.1.265 oder später, das das TypeScript Agent SDK ab v0.3.265 und das Python Agent SDK ab v0.2.153 bündelt. Vor Claude Code v2.1.268 erstellten Sitzungen, die keine [Funktionsflags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), einschließlich Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, die Eingabeaufforderung bei jeder Anfrage neu und `snapshot` hatte keine Auswirkung.

420 422

423<h2 id="context-claude-code-adds-outside-the-system-prompt">

424 Kontext, den Claude Code außerhalb des System-Prompts hinzufügt

425</h2>

426

427System-Erinnerungen sind Nachrichten, die Claude Code während einer Sitzung zur Konversation hinzufügt, um Claude Kontext zu geben, wie z. B. den Inhalt Ihrer CLAUDE.md-Dateien oder einen Hinweis, dass sich eine Datei auf der Festplatte geändert hat. Claude Code sendet sie in der Konversation, nicht im System-Prompt, sodass sie Claude erreichen, unabhängig davon, ob Sie die `claude_code`-Voreinstellung verwenden oder Ihren eigenen String als `systemPrompt` übergeben.

428

429Dieser Abschnitt behandelt die [Erinnerungen, die am ehesten das Verhalten Ihres Agenten ändern](#reminders-claude-code-adds-to-the-conversation), wie Sie [die Erinnerungen deaktivieren, die Ihr Agent ersetzt](#turn-off-the-context-your-agent-replaces), und wie Sie [sehen, was Claude erhalten hat](#see-what-claude-received) in einer bestimmten Anfrage.

430

431<h3 id="reminders-claude-code-adds-to-the-conversation">

432 Erinnerungen, die Claude Code zur Konversation hinzufügt

433</h3>

434

435System-Erinnerungen sind Text, den Claude Code zusammen mit den Prompts, die Ihr Code sendet, zur Konversation hinzufügt. Die folgenden Erinnerungen sind diejenigen, die am ehesten das Verhalten Ihres Agenten ändern:

436

437* **Projektanweisungen**: die CLAUDE.md-Dateien, die Ihre [`settingSources`](#claude-md-files-for-project-level-instructions)-Option lädt

438* **Ausgabestil-Anweisungen**: die Anweisungen des aktiven [Ausgabestils](#output-styles-for-persistent-configurations) in der Hauptkonversation

439* **Commit- und Pull-Request-Zuordnung**: der `Co-Authored-By`-Trailer und die Pull-Request-Fußzeile aus der [`attribution`](/docs/de/settings-reference#attribution)-Einstellung

440* **Hook-Ausgabe**: Text, den Ihre [Hooks](/docs/de/agent-sdk/hooks#outputs) als `additionalContext` zurückgeben

441* **Verfügbare Skills**: die Namen und Beschreibungen der [Skills](/docs/de/agent-sdk/skills), die Claude aufrufen kann

442* **Verfügbare Subagenten**: die Namen und Beschreibungen der [Subagenten](/docs/de/agent-sdk/subagents), die Claude starten kann

443* **Task-List-Hinweise**: in einer [Sitzung, die die Task-Tracking-Tools hat](/docs/de/agent-sdk/todo-tracking#model-availability), ein Prompt zum Aktualisieren der Task-Liste, wenn Claude sie mehrere Züge lang nicht berührt hat

444* **Datei-geändert-Hinweise**: ein Hinweis, dass sich eine Datei, die Claude zuvor gelesen hat, auf der Festplatte geändert hat

445

446Claude Code führt Ihre CLAUDE.md-Dateien mit einer Zeile ein, die Claude mitteilt, dass die Anweisungen das Standardverhalten überschreiben.

447

448Wenn Sie Ihren eigenen String als `systemPrompt` übergeben, fügen Sie einen Satz hinzu, der erklärt, was eine System-Erinnerung ist. Die `claude_code`-Voreinstellung hat einen, und Ihr String ersetzt die gesamte Voreinstellung. Ohne ihn teilt nichts in Ihrem Prompt Claude mit, dass Erinnerungen wie CLAUDE.md-Inhalte und Hook-Ausgabe von der Anwendung stammen und nicht vom Benutzer. Zum Beispiel:

449

450```text theme={null}

451The application adds system reminders to this conversation. Treat them as context from the application, not as messages from the user.

452```

453

454<h3 id="turn-off-the-context-your-agent-replaces">

455 Deaktivieren Sie den Kontext, den Ihr Agent ersetzt

456</h3>

457

458Deaktivieren Sie ein Stück eingebauten Kontexts, wenn Ihr Agent seine eigene Version derselben Anleitung bereitstellt. Wenn Ihr Prompt Claude beispielsweise anweist, Commit-Nachrichten als `PROJ-142: fix login redirect` ohne Trailer zu schreiben, teilt Claude Code Claude immer noch mit, jede Commit-Nachricht mit einem `Co-Authored-By`-Trailer zu beenden, sodass Claude zwei widersprüchliche Anweisungen für denselben Commit erhält.

459

460Übergeben Sie Einstellungsschlüssel durch die [`settings`](/docs/de/agent-sdk/typescript#options)-Option in TypeScript oder [`settings`](/docs/de/agent-sdk/python#claudeagentoptions) in Python, und Umgebungsvariablen durch die `env`-Option. In TypeScript ersetzt [`env`](/docs/de/agent-sdk/typescript#options) die geerbte Umgebung, daher verteilen Sie `process.env` darin.

461

462| Eingebauter Kontext | So deaktivieren Sie ihn |

463| :- | :- |

464| Die eingebauten Commit- und Pull-Request-Anweisungen und der Git-Status-Snapshot | Setzen Sie [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions) auf `false`, oder `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1` |

465| Der `Co-Authored-By`-Trailer und die Pull-Request-Fußzeile | Setzen Sie [`attribution.commit`](/docs/de/settings-reference#attribution-commit) und [`attribution.pr`](/docs/de/settings-reference#attribution-pr) auf Ihren eigenen Text, oder auf leere Strings, um sie zu entfernen |

466| Die Benutzer- oder Projekteinstellungsquelle, einschließlich ihrer CLAUDE.md | Lassen Sie `'user'` oder `'project'` aus [`settingSources`](/docs/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) weg |

467| Jede CLAUDE.md-Datei | Setzen Sie `CLAUDE_CODE_DISABLE_CLAUDE_MDS=1` |

468| Task-List-Hinweise, Datei-geändert-Hinweise und die Skill-Liste | Setzen Sie `CLAUDE_CODE_DISABLE_ATTACHMENTS=1` |

469

470Claude Codes eingebaute Commit- und Pull-Request-Anweisungen sind keine Erinnerung. Sie sind Teil der Beschreibung des Bash-Tools, daher erreichen sie Claude auch, wenn Sie einen benutzerdefinierten `systemPrompt` übergeben.

471

472Wenn Sie `CLAUDE_CODE_DISABLE_ATTACHMENTS` setzen, sendet Claude Code auch `@`-Dateierweiterungen als Klartext statt sie in Dateiinhalte zu erweitern. Die Liste der verfügbaren Subagenten und Hintergrund-Task-Benachrichtigungen treffen immer noch ein.

473

474Das folgende Beispiel ist für einen Agenten, der seine eigenen Commit-Regeln in `append` trägt. Es setzt beide `attribution`-Schlüssel auf leere Strings, um den Trailer und die Fußzeile zu entfernen, und deaktiviert `includeGitInstructions`, damit Claude Codes eigene Commit-Workflow-Anweisungen nicht mit Ihren konkurrieren:

475

476<CodeGroup>

477 ```typescript TypeScript theme={null}

478 import { query } from "@anthropic-ai/claude-agent-sdk";

479

480 for await (const message of query({

481 prompt: "Commit the staged changes for ticket PROJ-142",

482 options: {

483 systemPrompt: {

484 type: "preset",

485 preset: "claude_code",

486 append: "Write commit messages as: <ticket id>: <summary>. Add no trailers."

487 },

488 settings: {

489 includeGitInstructions: false,

490 attribution: { commit: "", pr: "" }

491 },

492 allowedTools: ["Bash(git *)"]

493 }

494 })) {

495 if (message.type === "result") console.log(message.subtype);

496 }

497 ```

498

499 ```python Python theme={null}

500 import asyncio

501 from claude_agent_sdk import query, ClaudeAgentOptions

502

503

504 async def main():

505 async for message in query(

506 prompt="Commit the staged changes for ticket PROJ-142",

507 options=ClaudeAgentOptions(

508 system_prompt={

509 "type": "preset",

510 "preset": "claude_code",

511 "append": "Write commit messages as: <ticket id>: <summary>. Add no trailers.",

512 },

513 settings='{"includeGitInstructions": false, "attribution": {"commit": "", "pr": ""}}',

514 allowed_tools=["Bash(git *)"],

515 ),

516 ):

517 print(message)

518

519

520 asyncio.run(main())

521 ```

522</CodeGroup>

523

524Um die Änderung zu bestätigen, führen Sie das Beispiel in einem Repository mit bereitgestellten Änderungen aus und überprüfen Sie den neuen Commit mit `git log -1`. Die Nachricht endet ohne einen `Co-Authored-By`-Trailer.

525

526<h3 id="see-what-claude-received">

527 Sehen Sie, was Claude erhalten hat

528</h3>

529

530Der SDK-Nachrichtenstrom enthält keine System-Erinnerungen, daher zeigt das Lesen der Nachrichten, die Ihr Code empfängt, nicht, was Claude sah. Um sie zu sehen, protokollieren Sie die Anfragen, die Claude Code sendet:

531

532* **Rohes Request-Logging**: Setzen Sie [`OTEL_LOG_RAW_API_BODIES`](/docs/de/monitoring-usage#api-request-body-event) auf `file:<dir>`. Claude Code schreibt jeden Request-Body in dieses Verzeichnis.

533* **Ein Gateway, das Sie kontrollieren**: Zeigen Sie [`ANTHROPIC_BASE_URL`](/docs/de/llm-gateway) auf einen Proxy, der Request-Bodies protokolliert.

534

535In einer protokollierten Anfrage schauen Sie im `messages`-Array. Eine Erinnerung erscheint in einer Benutzernachricht, die in `<system-reminder>`-Tags eingewickelt ist, oder auf einigen Modellen als separate Nachricht mit der `system`-Rolle.

536

421<h2 id="compare-the-four-approaches">537<h2 id="compare-the-four-approaches">

422 Vergleich der vier Ansätze538 Vergleich der vier Ansätze

423</h2>539</h2>

agent-sdk/observability.md +2 −2

Details

248| Variable | Fügt hinzu |248| Variable | Fügt hinzu |

249| - | - |249| - | - |

250| `OTEL_LOG_USER_PROMPTS=1` | Prompt-Text auf `claude_code.user_prompt`-Events und auf dem `claude_code.interaction`-Span |250| `OTEL_LOG_USER_PROMPTS=1` | Prompt-Text auf `claude_code.user_prompt`-Events und auf dem `claude_code.interaction`-Span |

251| `OTEL_LOG_TOOL_DETAILS=1` | Tool-Eingabeargumente (Dateipfade, Shell-Befehle, Suchmuster) auf `claude_code.tool_result`-Events |251| `OTEL_LOG_TOOL_DETAILS=1` | Tool-Eingabeargumente wie Dateipfade, Shell-Befehle und Suchmuster auf `claude_code.tool_result`-Events und echte Agent-, Skill-, Plugin- und MCP-Servernamen auf den [Kosten- und Token-Metriken](/docs/de/monitoring-usage#cost-counter) |

252| `OTEL_LOG_TOOL_CONTENT=1` | Ein [`tool.output`-Span-Event](/docs/de/monitoring-usage#tool-output-span-event) auf `claude_code.tool` mit Dateiinhalten und Bash-Ausgabe, gekürzt auf 60 KB standardmäßig, konfigurierbar über `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, was Claude Code v2.1.214 oder später erfordert. Erfordert, dass [Tracing](#read-agent-traces) aktiviert ist. Span-Attribute tragen Tool-Inhalte unter [ihren eigenen Gates](/docs/de/monitoring-usage#new-context-gates) |252| `OTEL_LOG_TOOL_CONTENT=1` | Ein [`tool.output`-Span-Event](/docs/de/monitoring-usage#tool-output-span-event) auf `claude_code.tool` mit Dateiinhalten, Bash-Ausgabe und dem, was MCP-Tools, WebFetch und WebSearch zurückgeben, gekürzt auf 60 KB standardmäßig, konfigurierbar über `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, was Claude Code v2.1.214 oder später erfordert. Ergebnisse von MCP-Tools, WebFetch und WebSearch erfordern Claude Code v2.1.283 oder später. Erfordert, dass [Tracing](#read-agent-traces) aktiviert ist. Span-Attribute tragen Tool-Inhalte unter [ihren eigenen Gates](/docs/de/monitoring-usage#new-context-gates) |

253| `OTEL_LOG_RAW_API_BODIES` | Vollständige Anthropic Messages API-Anfrage und Antwort JSON als `claude_code.api_request_body` und `claude_code.api_response_body` Log-Events. Setzen Sie auf `1` für Inline-Texte gekürzt auf 60 KB standardmäßig, oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Pfad im Event. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` konfiguriert das Inline-Kürzungslimit, und erfordert Claude Code v2.1.214 oder später. Texte enthalten die gesamte Gesprächshistorie und haben erweiterte Denkinhalte redigiert. Das Aktivieren davon impliziert Zustimmung zu allem, was die drei obigen Variablen offenbaren würden |253| `OTEL_LOG_RAW_API_BODIES` | Vollständige Anthropic Messages API-Anfrage und Antwort JSON als `claude_code.api_request_body` und `claude_code.api_response_body` Log-Events. Setzen Sie auf `1` für Inline-Texte gekürzt auf 60 KB standardmäßig, oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Pfad im Event. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` konfiguriert das Inline-Kürzungslimit, und erfordert Claude Code v2.1.214 oder später. Texte enthalten die gesamte Gesprächshistorie und haben erweiterte Denkinhalte redigiert. Das Aktivieren davon impliziert Zustimmung zu allem, was die drei obigen Variablen offenbaren würden |

254 254

255Lassen Sie diese ungesetzt, es sei denn, Ihre Observability-Pipeline ist genehmigt, um die Daten zu speichern, die Ihr Agent verarbeitet. Siehe [Sicherheit und Datenschutz](/docs/de/monitoring-usage#security-and-privacy) in der Überwachungsreferenz für die vollständige Liste der Attribute und des Redaktionsverhaltens.255Lassen Sie diese ungesetzt, es sei denn, Ihre Observability-Pipeline ist genehmigt, um die Daten zu speichern, die Ihr Agent verarbeitet. Siehe [Sicherheit und Datenschutz](/docs/de/monitoring-usage#security-and-privacy) in der Überwachungsreferenz für die vollständige Liste der Attribute und des Redaktionsverhaltens.

agent-sdk/permissions.md +6 −2

Details

41 </Step>41 </Step>

42 42

43 <Step title="Allow-Regeln">43 <Step title="Allow-Regeln">

44 Prüfen Sie `allow` Regeln (aus `allowed_tools` und settings.json). Wenn eine Regel zutrifft, wird das Tool genehmigt. Ein Aufruf, den das Tool selbst genehmigt, wird auch in diesem Schritt aufgelöst, ohne dass eine Regel erforderlich ist: zum Beispiel ein Dateilesezugriff in Ihren Arbeitsverzeichnissen oder ein [schreibgeschützter Bash-Befehl](/docs/de/permissions#read-only-commands). `rm` und `rmdir` Entfernungen, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) abzielen, werden niemals durch eine Allow-Regel genehmigt: sie erreichen Ihren Callback in den Modi, die auffordern, gehen zum [Klassifizierer](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) im `auto` Modus auf Claude Code v2.1.218 oder später, und werden im `dontAsk` Modus abgelehnt.44 Prüfen Sie `allow` Regeln (aus `allowed_tools` und settings.json). Wenn eine Regel zutrifft, wird das Tool genehmigt. Ein Aufruf, den das Tool selbst genehmigt, wird auch in diesem Schritt aufgelöst, ohne dass eine Regel erforderlich ist: zum Beispiel ein Dateilesezugriff in Ihren Arbeitsverzeichnissen oder ein [schreibgeschützter Bash-Befehl](/docs/de/permissions#read-only-commands).

46 `rm` und `rmdir` Entfernungen, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) abzielen, werden niemals durch eine Allow-Regel genehmigt. Ob sie dann Ihren Callback erreichen, hängt vom Berechtigungsmodus ab: in einer Agent SDK Sitzung im `auto` Modus lehnt Claude Code sie beispielsweise standardmäßig ab, ohne ihn aufzurufen. Die Tabelle [Kritische Pfade](/docs/de/permission-modes#critical-paths) Modus listet auf, was jeder Modus mit ihnen tut.

45 </Step>47 </Step>

46 48

47 <Step title="canUseTool Callback">49 <Step title="canUseTool Callback">

89Verwenden 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](/docs/de/permissions#read-and-edit) für die vier Ankerformen und wie Regeln aus Einstellungsdateien aufgelöst werden.91Verwenden 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](/docs/de/permissions#read-and-edit) für die vier Ankerformen und wie Regeln aus Einstellungsdateien aufgelöst werden.

90 92

91<Warning>93<Warning>

92 **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. `AskUserQuestion`, MCP-Tools, die mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), und `rm`- und `rmdir`-Entfernungen, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) abzielen, erreichen immer noch den Callback, auch wenn eine Allow-Regel passt. Im `auto`-Modus gehen kritische-Pfad-Entfernungen zum [Klassifizierer](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) statt zum Callback, während die anderen hier aufgelisteten Aufrufe ihn immer noch erreichen; das Klassifizierer-Routing erfordert Claude Code v2.1.218 oder später. Im `dontAsk`-Modus werden diese Aufrufe stattdessen abgelehnt, ohne den Callback aufzurufen.94 **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 Eine Allow-Regel genehmigt niemals automatisch `AskUserQuestion`, MCP-Tools, die mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), oder `rm`- und `rmdir`-Entfernungen, die auf einen [kritischen Pfad](/docs/de/permission-modes#critical-paths) abzielen. Im `dontAsk`-Modus lehnt Claude Code diese Aufrufe ab, ohne den Callback aufzurufen. In anderen Modi erreichen die ersten drei den Callback. Je nach [Genehmigungsmodus](/docs/de/permission-modes#critical-paths) erreicht eine kritische-Pfad-Entfernung den Callback auch oder Claude Code lehnt sie ab, ohne sie aufzurufen, wie es standardmäßig für eine Agent SDK-Sitzung im `auto`-Modus der Fall ist.

93 97

94 Die Abdeckung hängt von der Form des Eintrags ab: ein bloßer Name wie `Read` oder `mcp__github__get_issue` genehmigt automatisch jeden Aufruf dieses Tools außer den oben genannten Ausnahmen, während eine begrenzte Regel wie `Bash(npm test *)` nur übereinstimmende Aufrufe automatisch genehmigt, und andere `Bash`-Aufrufe, die Genehmigung benötigen, fallen immer noch durch zum Callback. Für Prüfungen, die bei jedem Tool-Aufruf ausgeführt werden müssen, verwenden Sie einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks): Hooks werden vor jedem anderen Schritt ausgeführt, und eine Hook-Ablehnung gilt auch im `bypassPermissions`-Modus.98 Die Abdeckung hängt von der Form des Eintrags ab: ein bloßer Name wie `Read` oder `mcp__github__get_issue` genehmigt automatisch jeden Aufruf dieses Tools außer den oben genannten Ausnahmen, während eine begrenzte Regel wie `Bash(npm test *)` nur übereinstimmende Aufrufe automatisch genehmigt, und andere `Bash`-Aufrufe, die Genehmigung benötigen, fallen immer noch durch zum Callback. Für Prüfungen, die bei jedem Tool-Aufruf ausgeführt werden müssen, verwenden Sie einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks): Hooks werden vor jedem anderen Schritt ausgeführt, und eine Hook-Ablehnung gilt auch im `bypassPermissions`-Modus.

95</Warning>99</Warning>

agent-sdk/plugins.md +1 −1

Details

331 Plugin wird nicht geladen331 Plugin wird nicht geladen

332</h3>332</h3>

333 333

334Wenn Ihr Plugin nicht in der Init-Meldung angezeigt wird:334Wenn Ihr Plugin nicht in der Init-Meldung angezeigt wird, überprüfen Sie sein [`plugin_errors`](/docs/de/agent-sdk/typescript#sdksystemmessage)-Feld auf den Grund und arbeiten Sie dann diese Überprüfungen durch:

335 335

3361. **Überprüfen Sie den Pfad**: Stellen Sie sicher, dass der Pfad auf das Plugin-Root-Verzeichnis verweist, das übergeordnete Verzeichnis von `skills/`, `agents/`, `hooks/`, `commands/` oder `.claude-plugin/`3361. **Überprüfen Sie den Pfad**: Stellen Sie sicher, dass der Pfad auf das Plugin-Root-Verzeichnis verweist, das übergeordnete Verzeichnis von `skills/`, `agents/`, `hooks/`, `commands/` oder `.claude-plugin/`

3372. **Validieren Sie plugin.json**: Wenn Ihr Plugin ein Manifest enthält, stellen Sie sicher, dass es eine gültige JSON-Syntax hat3372. **Validieren Sie plugin.json**: Wenn Ihr Plugin ein Manifest enthält, stellen Sie sicher, dass es eine gültige JSON-Syntax hat

agent-sdk/python.md +4 −2

Details

875 include_partial_messages: bool = False875 include_partial_messages: bool = False

876 include_hook_events: bool = False876 include_hook_events: bool = False

877 forward_subagent_text: bool = False877 forward_subagent_text: bool = False

878 verbatim_prompts: bool = False

878 fork_session: bool = False879 fork_session: bool = False

879 resume_session_at: str | None = None880 resume_session_at: str | None = None

880 resume_drops_turn: str | None = None881 resume_drops_turn: str | None = None

930| `forward_subagent_text` | `bool` | `False` | Leiten Sie Subagenten-Text und Thinking-Blöcke im Nachrichtenstrom weiter. Ohne diese Option gibt Claude Code nur Subagenten-`tool_use`- und `tool_result`-Blöcke aus, aber keinen Text oder Thinking. Erfordert Python Agent SDK 0.2.140 oder später |931| `forward_subagent_text` | `bool` | `False` | Leiten Sie Subagenten-Text und Thinking-Blöcke im Nachrichtenstrom weiter. Ohne diese Option gibt Claude Code nur Subagenten-`tool_use`- und `tool_result`-Blöcke aus, aber keinen Text oder Thinking. Erfordert Python Agent SDK 0.2.140 oder später |

932| `verbatim_prompts` | `bool` | `False` | Liefern Sie jeden Prompt wie geschrieben. Das SDK sendet jede Benutzernachricht mit `client_composed` auf `True` gesetzt. Siehe [`client_composed`](/docs/de/agent-sdk/typescript#sdkusermessage) für das, was Claude Code bei diesen Nachrichten überspringt. Verwenden Sie diese Option, wenn Ihr Prompt-Text Inhalte enthält, die der Endbenutzer nicht eingegeben hat. Für Pro-Turn-Kontrolle lassen Sie es aus und setzen Sie stattdessen `"client_composed": True` auf einzelnen gestreamten Nachrichten. Während die Option an ist, überschreibt das SDK jeden `client_composed`-Wert, den Sie setzen. Erfordert Python Agent SDK 0.2.158 oder später und Claude Code v2.1.248 oder später; die mit diesen SDK-Versionen gebündelte CLI erfüllt die Claude Code-Anforderung |

932| `resume_session_at` | `str \| None` | `None` | Beim Fortsetzen laden Sie die Konversation nur bis zu und einschließlich der Nachricht mit dieser UUID. Verwenden Sie mit `resume`, und normalerweise `fork_session`, um von einem früheren Punkt zu verzweigen. Erfordert Python Agent SDK 0.2.137 oder später |934| `resume_session_at` | `str \| None` | `None` | Beim Fortsetzen laden Sie die Konversation nur bis zu und einschließlich der Nachricht mit dieser UUID. Verwenden Sie mit `resume`, und normalerweise `fork_session`, um von einem früheren Punkt zu verzweigen. Erfordert Python Agent SDK 0.2.137 oder später |

933| `resume_drops_turn` | `str \| None` | `None` | UUID der Benutzereingabe, deren Umdrehung eine `resume_session_at`-Kürzung verwirft. Wenn gesetzt, weigert sich die CLI, die Wiederaufnahme durchzuführen, wenn der verworfene Bereich Einträge enthält, die nicht dieser Umdrehung zugeordnet werden können. Erfordert Python Agent SDK 0.2.137 oder später und Claude Code v2.1.223 oder später; die mit diesen SDK-Versionen gebündelte CLI erfüllt die Claude Code-Anforderung |935| `resume_drops_turn` | `str \| None` | `None` | UUID der Benutzereingabe, deren Umdrehung eine `resume_session_at`-Kürzung verwirft. Wenn gesetzt, weigert sich die CLI, die Wiederaufnahme durchzuführen, wenn der verworfene Bereich Einträge enthält, die nicht dieser Umdrehung zugeordnet werden können. Erfordert Python Agent SDK 0.2.137 oder später und Claude Code v2.1.223 oder später; die mit diesen SDK-Versionen gebündelte CLI erfüllt die Claude Code-Anforderung |

1221 "plan", # Planning mode - explore without editing1223 "plan", # Planning mode - explore without editing

1222 "dontAsk", # Deny anything not pre-approved instead of prompting1224 "dontAsk", # Deny anything not pre-approved instead of prompting

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

1224 "auto", # Model classifier approves or denies permission prompts1226 "auto", # A model classifier reviews actions such as shell commands and network requests

1225]1227]

1226```1228```

1227 1229

3789<Warning>3791<Warning>

3790 Befehle, die mit `dangerouslyDisableSandbox: True` ausgeführt werden, haben vollständigen Systemzugriff. Stellen Sie sicher, dass Ihr `can_use_tool`-Handler diese Anfragen sorgfältig validiert.3792 Befehle, die mit `dangerouslyDisableSandbox: True` ausgeführt werden, haben vollständigen Systemzugriff. Stellen Sie sicher, dass Ihr `can_use_tool`-Handler diese Anfragen sorgfältig validiert.

3791 3793

3792 Wenn `permission_mode` auf `bypassPermissions` gesetzt ist und `allow_unsandboxed_commands` aktiviert ist, kann das Modell autonom Befehle außerhalb der Sandbox ausführen, ohne Genehmigungsaufforderungen, abgesehen von den [Aktionen, die der No-Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves). Diese Kombination ermöglicht dem Modell effektiv, die Sandbox-Isolation stillschweigend zu verlassen.3794 Wenn `permission_mode` auf `bypassPermissions` gesetzt ist und `allowUnsandboxedCommands` aktiviert ist, kann das Modell autonom Befehle außerhalb der Sandbox ausführen, ohne Genehmigungsaufforderungen, abgesehen von den [Aktionen, die der No-Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves). Diese Kombination ermöglicht dem Modell effektiv, die Sandbox-Isolation stillschweigend zu verlassen.

3793</Warning>3795</Warning>

3794 3796

3795<h2 id="see-also">3797<h2 id="see-also">

agent-sdk/streaming-output.md +1 −1

Details

330 Bekannte Einschränkungen330 Bekannte Einschränkungen

331</h2>331</h2>

332 332

333* **Strukturierte Ausgabe**: Das JSON-Ergebnis erscheint nur in der finalen `ResultMessage.structured_output`, nicht als Streaming-Deltas. Weitere Informationen finden Sie unter [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs).333* **Strukturierte Ausgabe**: Bei aktivierten Teilnachrichten wird das JSON als unkontrollierte `input_json_delta`-Chunks eines Tool-Aufrufs gestreamt, und nur das validierte Ergebnis erreicht die finale `ResultMessage.structured_output`. Weitere Informationen finden Sie unter [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs).

334 334

335<h2 id="next-steps">335<h2 id="next-steps">

336 Nächste Schritte336 Nächste Schritte

agent-sdk/troubleshooting.md +1 −1

Details

162 structured\_output ist None, aber das Ergebnis sagt Erfolg162 structured\_output ist None, aber das Ergebnis sagt Erfolg

163</h3>163</h3>

164 164

165Eine Ergebnismeldung kann mit `subtype: "success"` enden, während `structured_output` in Python `None` oder in TypeScript `undefined` ist. Der Lauf wird abgeschlossen, aber es existiert keine validierte Ausgabe. Eine Möglichkeit, dies zu erreichen, ist ein Schema, das keine Ausgabe erfüllen kann, z. B. widersprüchliche Längenbeschränkungen. Der Lauf endet ohne Validierungsfehler, und das einzige Signal ist die fehlende `structured_output`.165Eine Ergebnismeldung kann mit `subtype: "success"` enden, während `structured_output` in Python `None` oder in TypeScript `undefined` ist. Der Lauf wird abgeschlossen, aber es existiert keine validierte Ausgabe. Eine Möglichkeit, dies zu erreichen, ist ein Schema, das keine Ausgabe erfüllen kann, z. B. widersprüchliche Längenbeschränkungen.

166 166

167Behandeln Sie dieses Ergebnis als Fehler im Anwendungscode. Überprüfen Sie sowohl, dass `subtype` `success` ist, als auch dass `structured_output` vorhanden ist, bevor Sie es verwenden. Der Abschnitt [Fehlerbehandlung](/docs/de/agent-sdk/structured-outputs#error-handling) zeigt dieses Muster für beide SDKs.167Behandeln Sie dieses Ergebnis als Fehler im Anwendungscode. Überprüfen Sie sowohl, dass `subtype` `success` ist, als auch dass `structured_output` vorhanden ist, bevor Sie es verwenden. Der Abschnitt [Fehlerbehandlung](/docs/de/agent-sdk/structured-outputs#error-handling) zeigt dieses Muster für beide SDKs.

168 168

agent-sdk/typescript.md +261 −38

Details

19<Note>19<Note>

20 Das SDK bündelt eine native Claude Code-Binärdatei für Ihre Plattform als optionale Abhängigkeit wie `@anthropic-ai/claude-agent-sdk-darwin-arm64`. Die meisten Installationen benötigen keine separate Claude Code-Installation. Die SDK-Version verfolgt die gebündelte Claude Code-Version. SDK v0.3.191 bündelt Claude Code v2.1.191, daher benötigt eine Funktion auf dieser Seite, die eine Claude Code-Version erfordert, die SDK-Version mit der gleichen Patch-Nummer oder später. Wenn Ihr Paketmanager optionale Abhängigkeiten überspringt, wirft das SDK `Native CLI binary for <platform>-<arch> not found`; setzen Sie stattdessen [`pathToClaudeCodeExecutable`](#options) auf eine separat installierte `claude`-Binärdatei.20 Das SDK bündelt eine native Claude Code-Binärdatei für Ihre Plattform als optionale Abhängigkeit wie `@anthropic-ai/claude-agent-sdk-darwin-arm64`. Die meisten Installationen benötigen keine separate Claude Code-Installation. Die SDK-Version verfolgt die gebündelte Claude Code-Version. SDK v0.3.191 bündelt Claude Code v2.1.191, daher benötigt eine Funktion auf dieser Seite, die eine Claude Code-Version erfordert, die SDK-Version mit der gleichen Patch-Nummer oder später. Wenn Ihr Paketmanager optionale Abhängigkeiten überspringt, wirft das SDK `Native CLI binary for <platform>-<arch> not found`; setzen Sie stattdessen [`pathToClaudeCodeExecutable`](#options) auf eine separat installierte `claude`-Binärdatei.

21 21

22 Wenn Ihr Paketmanager das `libc`-Feld von npm nicht anwendet, wie Yarn 1.x nicht, erhalten Sie unter Linux sowohl die glibc- als auch die musl-Plattformpakete, was die Installationsgröße ungefähr verdoppelt. Bei Agent SDK v0.2.141 oder später startet das SDK immer noch die richtige Variante. Um den Speicherplatz in einem Container-Image freizugeben, löschen Sie das Plattformpaket, das nicht mit der libc übereinstimmt, wo Ihre App ausgeführt wird; für eine glibc-Laufzeit auf x64 ist das `rm -rf node_modules/@anthropic-ai/claude-agent-sdk-linux-x64-musl`. Auf einem Entwicklungscomputer ist das Löschen vorübergehend, da Yarn das Paket bei der nächsten Abhängigkeitsänderung neu installiert.22 Wenn Ihr Paketmanager das npm-Feld `libc` nicht anwendet, wie Yarn 1.x nicht, erhalten Sie auf Linux sowohl die glibc- als auch die musl-Plattformpakete, was die Installationsgröße ungefähr verdoppelt. Bei Agent SDK v0.2.141 oder später startet das SDK immer noch die richtige Variante. Um den Speicherplatz in einem Container-Image freizugeben, löschen Sie das Plattformpaket, das nicht mit der libc übereinstimmt, wo Ihre App ausgeführt wird; für eine glibc-Laufzeit auf x64 ist das `rm -rf node_modules/@anthropic-ai/claude-agent-sdk-linux-x64-musl`. Auf einem Entwicklungscomputer ist das Löschen vorübergehend, da Yarn das Paket bei der nächsten Abhängigkeitsänderung neu installiert.

23</Note>23</Note>

24 24

25<h3 id="compile-to-a-single-executable">25<h3 id="compile-to-a-single-executable">

28 28

29Wenn Sie Ihre Anwendung mit `bun build --compile` in eine einzelne ausführbare Datei kompilieren, kann das SDK die gebündelte CLI-Binärdatei zur Laufzeit nicht auflösen. `require.resolve` funktioniert nicht innerhalb des virtuellen Dateisystems `$bunfs` der kompilierten ausführbaren Datei, daher wirft das SDK `Native CLI binary for <platform>-<arch> not found`.29Wenn Sie Ihre Anwendung mit `bun build --compile` in eine einzelne ausführbare Datei kompilieren, kann das SDK die gebündelte CLI-Binärdatei zur Laufzeit nicht auflösen. `require.resolve` funktioniert nicht innerhalb des virtuellen Dateisystems `$bunfs` der kompilierten ausführbaren Datei, daher wirft das SDK `Native CLI binary for <platform>-<arch> not found`.

30 30

31Um dieses Problem zu umgehen, betten Sie die Plattform-Binärdatei als Datei-Asset ein, extrahieren Sie sie beim Start mit `extractFromBunfs()` in einen echten Pfad und übergeben Sie diesen Pfad an [`pathToClaudeCodeExecutable`](#options).31Um dies zu umgehen, betten Sie die Plattform-Binärdatei als Datei-Asset ein, extrahieren Sie sie beim Start mit `extractFromBunfs()` in einen echten Pfad und übergeben Sie diesen Pfad an [`pathToClaudeCodeExecutable`](#options).

32 32

33Der `extractFromBunfs()`-Helfer erfordert `@anthropic-ai/claude-agent-sdk` v0.3.144 oder später. Das folgende Beispiel erstellt für macOS auf Apple Silicon:33Der `extractFromBunfs()`-Helfer erfordert `@anthropic-ai/claude-agent-sdk` v0.3.144 oder später. Das folgende Beispiel erstellt für macOS auf Apple Silicon:

34 34

47}47}

48```48```

49 49

50`extractFromBunfs()` kopiert die eingebettete Binärdatei aus dem virtuellen Dateisystem der kompilierten ausführbaren Datei in ein benutzerabhängiges temporäres Verzeichnis und gibt den echten Pfad zurück. Außerhalb einer kompilierten ausführbaren Datei gibt es den Eingabepfad unverändert zurück, sodass derselbe Code in der Entwicklung ohne Änderungen ausgeführt wird.50`extractFromBunfs()` kopiert die eingebettete Binärdatei aus dem virtuellen Dateisystem der kompilierten ausführbaren Datei in ein benutzerabhängiges temporäres Verzeichnis und gibt den echten Pfad zurück. Außerhalb einer kompilierten ausführbaren Datei gibt es den Eingabepfad unverändert zurück, sodass derselbe Code in der Entwicklung ohne Änderung ausgeführt wird.

51 51

~~52Jede kompilierte ausführbare Datei bettelt eine einzelne Plattform-Binärdatei ein. Stimmen Sie das Plattformpaket im Import mit Ihrem `--target` ab:~~52Jede kompilierte ausführbare Datei bettet eine einzelne Plattform-Binärdatei ein. Stimmen Sie das Plattformpaket im Import mit Ihrem `--target` ab:

53 53

54* Zum Cross-Kompilieren installieren Sie das nicht übereinstimmende Plattformpaket, beispielsweise `npm install @anthropic-ai/claude-agent-sdk-linux-x64 --force`.54* Zum Cross-Kompilieren installieren Sie das nicht übereinstimmende Plattformpaket, beispielsweise `npm install @anthropic-ai/claude-agent-sdk-linux-x64 --force`.

55* Unter Windows ist der Binär-Unterpfad `claude.exe`, beispielsweise `@anthropic-ai/claude-agent-sdk-win32-x64/claude.exe`.55* Unter Windows ist der Binär-Unterpfad `claude.exe`, beispielsweise `@anthropic-ai/claude-agent-sdk-win32-x64/claude.exe`.

56 56

57<h3 id="import-the-/core-entry-when-you-bundle-the-agent-sdk">

58 Importieren Sie den `/core`-Eintrag, wenn Sie das Agent SDK bündeln

59</h3>

61Wenn Ihre Anwendung das Agent SDK zusammen mit ihren eigenen Abhängigkeiten bündelt, importieren Sie von `@anthropic-ai/claude-agent-sdk/core` statt vom Paket-Root. Der `/core`-Eintrag erfordert TypeScript Agent SDK v0.3.282 oder später, und seine Typen erfordern TypeScript 5.0 oder später.

63Der `/core`-Eintrag exportiert dieselben `query()`, `startup()`, `tool()`, `createSdkMcpServer()` und `resolveSettings()` wie der Root-Eintrag, zusammen mit den Funktionen, die Sitzungen umbenennen, taggen und löschen, `AbortError`, die Laufzeitkonstanten und jeden Typ. Es fügt keine eigenen Namen hinzu. Um den Code, den Ihre Anwendung lädt, klein zu halten, lässt `/core` einige Root-Exporte weg, einschließlich `prewarm()`, die `InMemorySessionStore`-Klasse und die Helfer, die Sitzungen auflisten, lesen, forken, importieren und zusammenfassen. Wenn Sie einen davon benötigen, verwenden Sie stattdessen den Root-Eintrag.

65Der Root-Eintrag inliniert seine eigenen Kopien von `zod` und `@modelcontextprotocol/sdk`. Der `/core`-Eintrag importiert sie aus Ihrem `node_modules` in den Bereichen, die die `peerDependencies` des Agent SDK deklarieren, sodass ein Bundle, das sie bereits enthält, keine zweite Kopie trägt. Importieren Sie in einem bestimmten Prozess entweder vom Root oder von `/core`, nicht von beiden: Sie sind separate Bundles, und das Laden beider gibt Ihnen zwei Kopien der Klassen und des Zustands des Agent SDK.

57<h2 id="functions">67<h2 id="functions">

58 Funktionen68 Funktionen

59</h2>69</h2>

93 `startup()`103 `startup()`

94</h3>104</h3>

95 105

96Wärmt die CLI-Subprozess vor, indem sie ihn spawnt und den Initialize-Handshake abschließt, bevor eine Eingabeaufforderung verfügbar ist. Das zurückgegebene [`WarmQuery`](#warmquery)-Handle akzeptiert später eine Eingabeaufforderung und schreibt sie in einen bereits bereiten Prozess, sodass der erste `query()`-Aufruf aufgelöst wird, ohne die Kosten für Subprozess-Spawn und Initialisierung inline zu zahlen.106Wärmt die CLI-Subprozess vor, indem sie ihn spawnt und den Initialize-Handshake abschließt, bevor eine Eingabeaufforderung verfügbar ist. Das zurückgegebene [`WarmQuery`](#warmquery)-Handle akzeptiert später eine Eingabeaufforderung und schreibt sie in einen bereits bereiten Prozess, sodass der erste `query()`-Aufruf aufgelöst wird, ohne die Kosten für Subprozess-Spawn und Initialisierung inline zu zahlen. Wenn Sie das Arbeitsverzeichnis der Sitzung noch nicht kennen, verwenden Sie stattdessen [`prewarm()`](#prewarm).

97 107

98```typescript theme={null}108```typescript theme={null}

99function startup(params?: {109function startup(params?: {

135}145}

136```146```

137 147

148<h3 id="prewarm">

149 `prewarm()`

150</h3>

151

152*Alpha.* Startet einen Claude Code-Prozess als Reserve, bevor Sie wissen, welche Sitzung er bedienen wird, sodass Sie ihn später mit [`claim()`](#spareprocess) an eine Sitzung binden können. Verwenden Sie es in einer Anwendung, die startet, bevor der Benutzer einen Ordner auswählt. Erfordert TypeScript Agent SDK v0.3.282 oder später.

153

154`prewarm()` führt denselben Initialize-Handshake wie [`startup()`](#startup) durch, wobei der Prozess in `options.cwd` wartet, wenn Sie ihn setzen, und ansonsten in einem privaten temporären Verzeichnis unter Ihrem Claude Code-Konfigurationsverzeichnis. Das Arbeitsverzeichnis der Sitzung, ihre `SessionStart`-Hooks, ihre stdio-MCP-Server und ihr CLAUDE.md- und Git-Kontext warten auf die Beanspruchung. Eine Reserve belegt ungefähr 230 bis 260 MB Speicher, während sie wartet. Wenn Ihr [`spawnClaudeCodeProcess`](#options) Claude Code auf einem anderen Computer oder in einem Container ausführt, setzen Sie `options.cwd` auf ein Verzeichnis, das dort existiert, damit die Reserve darin wartet.

155

156```typescript theme={null}

157function prewarm(params?: {

158 options?: Options;

159 initializeTimeoutMs?: number;

160}): Promise<SpareProcess>;

161```

162

163`options` und `initializeTimeoutMs` bedeuten dasselbe wie für `startup()`, außer dass `options.cwd` nur das Verzeichnis setzt, in dem die Reserve wartet. Das Promise wird mit einem [`SpareProcess`](#spareprocess) aufgelöst, sobald der Prozess seinen Initialize-Handshake abgeschlossen hat. `prewarm()` wirft einen Fehler, wenn `options` `resume`, `continue` oder `forkSession` setzt, da eine Reserve noch keine Sitzung hat. Alles, was ein Claim nicht setzen kann, wie `mcpServers`, `hooks`, `canUseTool`, `settingSources`, `systemPrompt` und `plugins`, ist für die Lebensdauer der Reserve festgelegt, daher halten Sie eine Reserve pro unterschiedlichem Satz dieser Optionen und wärmen Sie erneut vor, wenn sie sich ändern.

164

165<h4 id="example-2">

166 Beispiel

167</h4>

168

169Wärmen Sie beim Anwendungsstart vor, dann beanspruchen Sie die Reserve, wenn der Benutzer eine Sitzung startet:

170

171```typescript theme={null}

172import { prewarm } from "@anthropic-ai/claude-agent-sdk";

173

174// Beim Anwendungsstart, bevor der Ordner der Sitzung bekannt ist

175const spare = await prewarm({ options: { maxTurns: 3 } });

176

177// Später, wenn der Benutzer eine Sitzung in einem Ordner startet

178const claimedQuery = spare.claim({

179 prompt: "What files are here?",

180 options: { cwd: "/path/to/project" },

181});

182

183spare.claimed.catch((error: Error) => {

184 // Wenn die Nachricht nicht mit "option_not_applied" beginnt, wurde die Eingabeaufforderung nicht ausgeführt:

185 // starten Sie diese Sitzung stattdessen mit query()

186 console.error("Claim failed:", error.message);

187});

188

189for await (const message of claimedQuery) {

190 console.log(message);

191}

192```

193

138<h3 id="tool">194<h3 id="tool">

139 `tool()`195 `tool()`

140</h3>196</h3>

261 317

262<h4 id="example-2">318<h4 id="example-3">

263 Beispiel319 Beispiel

264</h4>320</h4>

265 321

312| `parent_tool_use_id` | `string \| null` | Für Subagenten-Nachrichten die `tool_use_id` des `Agent`- oder `Skill`-Tool-Aufrufs, der den Subagenten gestartet hat. `null` für Hauptsitzungs-Nachrichten und ältere Sitzungen |368| `parent_tool_use_id` | `string \| null` | Für Subagenten-Nachrichten die `tool_use_id` des `Agent`- oder `Skill`-Tool-Aufrufs, der den Subagenten gestartet hat. `null` für Hauptsitzungs-Nachrichten und ältere Sitzungen |

313| `parent_agent_id` | `string \| null` | Für Nachrichten von einem [verschachtelten Subagenten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) die `agentId` des Subagenten, der ihn gespawnt hat. `null` für Hauptsitzungs-Nachrichten, Nachrichten von Top-Level-Subagenten und ältere Sitzungen. Erfordert Claude Code v2.1.202 oder später |369| `parent_agent_id` | `string \| null` | Für Nachrichten von einem [verschachtelten Subagenten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) die `agentId` des Subagenten, der ihn gespawnt hat. `null` für Hauptsitzungs-Nachrichten, Nachrichten von Top-Level-Subagenten und ältere Sitzungen. Erfordert Claude Code v2.1.202 oder später |

314 370

315<h4 id="example-3">371<h4 id="example-4">

316 Beispiel372 Beispiel

317</h4>373</h4>

318 374

453| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Pro-Quelle rohe Einstellungen, geordnet von niedrigster zu höchster Vorrangordnung |509| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Pro-Quelle rohe Einstellungen, geordnet von niedrigster zu höchster Vorrangordnung |

454 510

455<h4 id="example-4">511<h4 id="example-5">

456 Beispiel512 Beispiel

457</h4>513</h4>

458 514

547| `toolAliases` | `Record<string, string>` | `undefined` | Ordnen Sie integrierte Tool-Namen MCP-Tool-Namen zu, damit Claude Ihre MCP-Implementierung anstelle der integrierten aufruft. Zum Beispiel `{ Bash: 'mcp__workspace__bash' }` |603| `toolAliases` | `Record<string, string>` | `undefined` | Ordnen Sie integrierte Tool-Namen MCP-Tool-Namen zu, damit Claude Ihre MCP-Implementierung anstelle der integrierten aufruft. Zum Beispiel `{ Bash: 'mcp__workspace__bash' }` |

549| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Tool-Konfiguration. Übergeben Sie ein Array von Tool-Namen oder verwenden Sie die Voreinstellung, um Claude Codes Standard-Tools zu erhalten |605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Tool-Konfiguration. Übergeben Sie ein Array von Tool-Namen oder verwenden Sie die Voreinstellung, um Claude Codes Standard-Tools zu erhalten |

606| `verbatimPrompts` | `boolean` | `false` | Liefern Sie jede Eingabeaufforderung wie geschrieben. Das SDK sendet jede Benutzernachricht mit `client_composed: true`. Siehe [`client_composed`](#sdkusermessage), um zu sehen, was Claude Code bei diesen Nachrichten überspringt. Verwenden Sie diese Option, wenn Ihr Eingabeaufforderungstext Inhalte enthält, die der Endbenutzer nicht eingegeben hat. Für Pro-Turn-Steuerung lassen Sie es aus und setzen Sie stattdessen `client_composed` auf einzelnen gestreamten Nachrichten. Erfordert TypeScript Agent SDK v0.3.280 oder später und Claude Code v2.1.248 oder später; die mit diesen SDK-Versionen gebündelte Claude Code-Version erfüllt die Claude Code-Anforderung |

550 607

551<h4 id="handle-slow-or-stalled-api-responses">608<h4 id="handle-slow-or-stalled-api-responses">

552 Langsame oder steckengebliebene API-Antworten behandeln609 Langsame oder steckengebliebene API-Antworten behandeln

617 path: string,674 path: string,

618 options?: { maxBytes?: number; encoding?: 'utf-8' | 'base64' }675 options?: { maxBytes?: number; encoding?: 'utf-8' | 'base64' }

619 ): Promise<SDKControlReadFileResponse | null>;676 ): Promise<SDKControlReadFileResponse | null>;

677 reloadPlugins(options?: {

678 holdOnCacheImpact?: boolean;

679 }): Promise<SDKControlReloadPluginsResponse>;

620 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;680 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;

681 reloadOutputStyles(): Promise<SDKControlReloadOutputStylesResponse>;

621 accountInfo(): Promise<AccountInfo>;682 accountInfo(): Promise<AccountInfo>;

622 reconnectMcpServer(serverName: string): Promise<void>;683 reconnectMcpServer(serverName: string): Promise<void>;

623 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;684 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;

651| `getContextUsage(opts?)` | Gibt eine [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) zurück, die die Kontextfenster-Nutzung der Sitzung nach Kategorie, Fähigkeit und Tool aufschlüsselt. Mit dem Standard `detail` ist es die gleichen Daten, die `/context` in einer interaktiven Sitzung anzeigt. Die [`detail`-Option](#sdkcontrolgetcontextusageresponse) erfordert Agent SDK v0.3.257 oder später |712| `getContextUsage(opts?)` | Gibt eine [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) zurück, die die Kontextfenster-Nutzung der Sitzung nach Kategorie, Fähigkeit und Tool aufschlüsselt. Mit dem Standard `detail` ist es die gleichen Daten, die `/context` in einer interaktiven Sitzung anzeigt. Die [`detail`-Option](#sdkcontrolgetcontextusageresponse) erfordert Agent SDK v0.3.257 oder später |

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

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

653| `reloadSkills()` | Lädt Fähigkeiten von der Festplatte neu, sodass Fähigkeiten, die Sie mid-session hinzufügen oder bearbeiten, der laufenden Sitzung zur Verfügung stehen. Wird mit einer [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) aufgelöst, die die nach dem Neuladen verfügbaren Fähigkeiten auflistet. Erfordert Agent SDK v0.3.163 oder später |715| `reloadSkills()` | Lädt Fähigkeiten von der Festplatte neu, sodass Fähigkeiten, die Sie mid-session hinzufügen oder bearbeiten, der laufenden Sitzung zur Verfügung stehen. Wird mit einer [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) aufgelöst, die die nach dem Neuladen verfügbaren Fähigkeiten auflistet. Erfordert Agent SDK v0.3.163 oder später |

716| `reloadOutputStyles()` | Re-liest [Ausgabestile](/docs/de/output-styles) von der Festplatte, sodass eine Stildatei, die Sie mid-session hinzufügen oder bearbeiten, der laufenden Sitzung zur Verfügung steht. Wird mit einer [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) aufgelöst, die die nach dem Neuladen verfügbaren Stilnamen auflistet. Erfordert Agent SDK v0.3.261 oder später |

655| `reconnectMcpServer(serverName)` | Verbinden Sie einen MCP-Server nach Name erneut. Wenn der Name auch einem Eintrag in einer Einstellungsdatei wie `.mcp.json` oder `~/.claude.json` entspricht, verbindet Claude Code den Server, den Sie über [`mcpServers`](#options) oder `setMcpServers()` konfiguriert haben, nicht den Einstellungsdatei-Eintrag. Diese Auflösungsreihenfolge erfordert Claude Code v2.1.257 oder später |718| `reconnectMcpServer(serverName)` | Verbinden Sie einen MCP-Server nach Name erneut. Wenn der Name auch einem Eintrag in einer Einstellungsdatei wie `.mcp.json` oder `~/.claude.json` entspricht, verbindet Claude Code den Server, den Sie über [`mcpServers`](#options) oder `setMcpServers()` konfiguriert haben, nicht den Einstellungsdatei-Eintrag. Diese Auflösungsreihenfolge erfordert Claude Code v2.1.257 oder später |

656| `toggleMcpServer(serverName, enabled)` | Aktivieren oder deaktivieren Sie einen MCP-Server nach Name, mit der gleichen Namensauflösung wie `reconnectMcpServer()`. Das Deaktivieren trennt den Server |719| `toggleMcpServer(serverName, enabled)` | Aktivieren oder deaktivieren Sie einen MCP-Server nach Name, mit der gleichen Namensauflösung wie `reconnectMcpServer()`. Das Deaktivieren trennt den Server |

672* **Während der aktuellen Umdrehung angewendet**: `model`. Wenn Sie `model` wechseln, während Claude an einer Umdrehung arbeitet, wird die Antwort, die Claude bereits generiert, auf dem alten Modell beendet, und der Rest der Umdrehung, beginnend mit dem nächsten Aufruf, den Claude Code an das Modell macht, verwendet das neue. Subagenten behalten ihr eigenes Modell. Vor v2.1.212 wartete ein Mid-Turn-Wechsel auf die nächste Umdrehung.735* **Während der aktuellen Umdrehung angewendet**: `model`. Wenn Sie `model` wechseln, während Claude an einer Umdrehung arbeitet, wird die Antwort, die Claude bereits generiert, auf dem alten Modell beendet, und der Rest der Umdrehung, beginnend mit dem nächsten Aufruf, den Claude Code an das Modell macht, verwendet das neue. Subagenten behalten ihr eigenes Modell. Vor v2.1.212 wartete ein Mid-Turn-Wechsel auf die nächste Umdrehung.

673* **Keine Auswirkung mid-session**: die Systemprompt-Optionen. Diese werden einmal beim Start aufgelöst, daher behält die laufende Sitzung den ursprünglichen Wert, auch wenn der Aufruf erfolgreich ist. Um sie zu ändern, starten Sie eine neue Sitzung.736* **Keine Auswirkung mid-session**: die Systemprompt-Optionen. Diese werden einmal beim Start aufgelöst, daher behält die laufende Sitzung den ursprünglichen Wert, auch wenn der Aufruf erfolgreich ist. Um sie zu ändern, starten Sie eine neue Sitzung.

674 737

675`effortLevel` akzeptiert einen [Anstrengungsstufen](/docs/de/model-config#adjust-effort-level)-Namen. Es akzeptiert auch `"ultracode"`, das `xhigh`-Anstrengung mit [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) anfordert. `applyFlagSettings()` deklariert `effortLevel` ohne diesen Wert, daher übergeben Sie das Äquivalent `{ ultracode: true }` in TypeScript. Der `ultracode`-Wert erfordert Claude Code v2.1.203 oder später und wird nur von `applyFlagSettings()` akzeptiert, nicht vom `effortLevel`-Schlüssel in einer Einstellungsdatei.738`effortLevel` akzeptiert einen [Anstrengungsstufen](/docs/de/model-config#adjust-effort-level)-Namen. Es akzeptiert auch `"ultracode"`, das `xhigh`-Anstrengung mit [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) anfordert. `applyFlagSettings()` deklariert `effortLevel` ohne diesen Wert, daher übergeben Sie in TypeScript `{ ultracode: true, effortLevel: "xhigh" }` für das gleiche Ergebnis, oder den [`ultracode`](/docs/de/settings-reference#ultracode)-Schlüssel allein, um ultracode auf der aktuellen Anstrengungsstufe der Sitzung einzuschalten. Der `ultracode`-Wert erfordert Claude Code v2.1.203 oder später und wird nur von `applyFlagSettings()` akzeptiert, nicht vom `effortLevel`-Schlüssel in einer Einstellungsdatei. Vor v2.1.284 setzte der `ultracode`-Schlüssel allein auch die Stufe auf `xhigh`.

676 739

677Die Werte werden in die Flag-Einstellungsebene geschrieben, die gleiche Ebene, die die Inline-`settings`-Option von `query()` beim Start füllt. Dies ist die gleiche Ebene, die der [On-Page-Rangfolge-Abschnitt](#settings-precedence) programmatische Optionen nennt.740Die Werte werden in die Flag-Einstellungsebene geschrieben, die gleiche Ebene, die die Inline-`settings`-Option von `query()` beim Start füllt. Dies ist die gleiche Ebene, die der [On-Page-Rangfolge-Abschnitt](#settings-precedence) programmatische Optionen nennt.

678 741

741 804

742`WarmQuery` implementiert `AsyncDisposable`, daher kann es mit `await using` für automatische Bereinigung verwendet werden.805`WarmQuery` implementiert `AsyncDisposable`, daher kann es mit `await using` für automatische Bereinigung verwendet werden.

743 806

807<h3 id="spareprocess">

808 `SpareProcess`

809</h3>

810

811*Alpha.* Handle, das von [`prewarm()`](#prewarm) zurückgegeben wird: ein gestarteter Claude Code-Prozess, der noch nicht an eine Sitzung gebunden ist und einmal beansprucht werden kann. Erfordert TypeScript Agent SDK v0.3.282 oder später.

812

813```typescript theme={null}

814interface SpareProcess extends AsyncDisposable {

815 claim(params: {

816 prompt: string | AsyncIterable<SDKUserMessage>;

817 options: ClaimOptions;

818 }): Query;

819 readonly claimed: Promise<{ cwd: string; sessionId: string; parkedMs?: number; sdkMcpSettled: boolean }>;

820 readonly exited: Promise<void>;

821 close(): void;

822}

823```

824

825<h4 id="members">

826 Mitglieder

827</h4>

828

829| Mitglied | Beschreibung |

830| :- | :- |

831| `claim({ prompt, options })` | Binden Sie die Spare an eine Sitzung in `options.cwd` und senden Sie ihre erste Nachricht. Gibt eine [`Query`](#query-object) synchron zurück, wie `query()` es tut. Kann nur einmal aufgerufen werden |

832| `claimed` | Wird mit dem Arbeitsverzeichnis und der ID der Sitzung aufgelöst, sobald Claude Code die Beanspruchung akzeptiert. Lehnt ab, wenn Claude Code die Beanspruchung verweigert, wenn der Prozess beendet wurde oder zuerst geschlossen wurde, und, mit einer Nachricht, die mit `option_not_applied` beginnt, wenn die Sitzung ohne das `model` oder `maxThinkingTokens` läuft, das Sie angefordert haben |

833| `exited` | Wird beigelegt, wenn der Prozess beendet wird, beansprucht oder nicht. Ersetzen Sie eine Spare, die beendet wird, bevor Sie sie beanspruchen |

834| `close()` | Beenden Sie den Prozess. Vor einer Beanspruchung verwerfen Sie die Spare und lehnen `claimed` ab |

835

836`options.cwd` ist erforderlich. Eine Beanspruchung kann auch `additionalDirectories`, `model`, `permissionMode`, `maxThinkingTokens`, eine Flag-Einstellungs-Überlagerung in `settings`, `appendSystemPrompt`, `title`, `agents` und sitzungsspezifische Token in `env` setzen.

837

838Claude Code kann eine Beanspruchung verweigern, z. B. für einen Ordner, der nicht existiert, oder einen, dessen Projekteinstellungen `env`, `agent` oder `model` setzen. Wenn `claimed` mit einer Nachricht ablehnt, die mit `option_not_applied` beginnt, läuft die Sitzung ohne das `model` oder `maxThinkingTokens`, das Sie angefordert haben. Nach jeder anderen Ablehnung ist Ihre Eingabeaufforderung nicht gelaufen, daher starten Sie die Sitzung stattdessen mit `query()`.

839

744<h3 id="sdkcontrolinitializeresponse">840<h3 id="sdkcontrolinitializeresponse">

745 `SDKControlInitializeResponse`841 `SDKControlInitializeResponse`

746</h3>842</h3>

824 tokens: number;920 tokens: number;

825 color: string;921 color: string;

826 isDeferred?: boolean;922 isDeferred?: boolean;

923 kind: "used" | "free" | "buffer" | "deferred";

827 }[];924 }[];

828 totalTokens: number;925 totalTokens: number;

829 maxTokens: number;926 maxTokens: number;

913 1010

914Lesen Sie Token-Zuordnung aus den Sammlungsfeldern:1011Lesen Sie Token-Zuordnung aus den Sammlungsfeldern:

915 1012

916* `categories` enthält die Pro-Kategorie-Summen.1013* `categories` enthält die Pro-Kategorie-Summen. Jeder Eintrag's `kind` klassifiziert die Zeile mit den gleichen Werten wie [`SDKContextUsageCategory`](#sdkcontextusagecategory). Klassifizieren Sie Zeilen darauf, anstatt auf dem Anzeige-`name`. Das Feld erfordert Agent SDK v0.3.268 oder später.

917* `mcpTools` und `agents` ordnen Token einzelnen MCP-Tools und Subagenten zu.1014* `mcpTools` und `agents` ordnen Token einzelnen MCP-Tools und Subagenten zu.

918* `memoryFiles` listet jede geladene Speicherdatei mit ihren Kosten auf.1015* `memoryFiles` listet jede geladene Speicherdatei mit ihren Kosten auf.

919* `skills.skillFrontmatter` ordnet die Token der Fähigkeitsliste jeder eingeschlossenen Fähigkeit zu. Die Pro-Fähigkeit-Zählungen messen jeden Fähigkeitslisten-Eintrag, wie Claude Code ihn tatsächlich sendet, was kürzer als die vollständige Frontmatter der Fähigkeit sein kann. Vergleichen Sie `skills.totalSkills` mit `skills.includedSkills`, um zu sehen, ob jede entdeckte Fähigkeit in die Liste aufgenommen wurde.1016* `skills.skillFrontmatter` ordnet die Token der Fähigkeitsliste jeder eingeschlossenen Fähigkeit zu. Die Pro-Fähigkeit-Zählungen messen jeden Fähigkeitslisten-Eintrag, wie Claude Code ihn tatsächlich sendet, was kürzer als die vollständige Frontmatter der Fähigkeit sein kann. Vergleichen Sie `skills.totalSkills` mit `skills.includedSkills`, um zu sehen, ob jede entdeckte Fähigkeit in die Liste aufgenommen wurde.

950 1047

951`Read`-Deny- und Ask-Regeln blockieren immer noch einen übereinstimmenden Pfad, und eine breite `Read`-Allow-Regel öffnet nicht den Rest des Dateisystems für `readFile()`. Für alles andere wird der Aufruf mit `null` aufgelöst.1048`Read`-Deny- und Ask-Regeln blockieren immer noch einen übereinstimmenden Pfad, und eine breite `Read`-Allow-Regel öffnet nicht den Rest des Dateisystems für `readFile()`. Für alles andere wird der Aufruf mit `null` aufgelöst.

952 1049

1050<h3 id="sdkcontrolreloadpluginsresponse">

1051 `SDKControlReloadPluginsResponse`

1052</h3>

1053

1054Rückgabetyp von [`reloadPlugins()`](#query-object).

1055

1056```typescript theme={null}

1057type SDKControlReloadPluginsResponse = {

1058 commands: SlashCommand[];

1059 agents: AgentInfo[];

1060 plugins: {

1061 name: string;

1062 path: string;

1063 source?: string;

1064 version?: string;

1065 }[];

1066 mcpServers: McpServerStatus[];

1067 error_count: number;

1068 held?: boolean;

1069 cache_impact?: {

1070 mcp_servers_added: string[];

1071 mcp_servers_removed: string[];

1072 lsp_tool_change: ("adds" | "may-add" | "removes" | "may-remove") | null;

1073 };

1074};

1075```

1076

1077Die Sammlungsfelder beschreiben die Sitzung nach dem Aufruf:

1078

1079* `commands`, `agents` und `mcpServers`: die Befehle, Subagenten und MCP-Server-Status der Sitzung, in den gleichen Formen, die `supportedCommands()`, `supportedAgents()` und `mcpServerStatus()` zurückgeben. `supportedAgents()` gibt weiterhin die Liste zurück, die bei der Initialisierung erfasst wurde, daher lesen Sie `agents` hier für die Menge nach einem Neuladen

1080* `plugins`: jedes geladene Plugin mit seinem `name` und Install-`path`. `version` wiederholt, was das Manifest des Plugins deklariert, und ist vom Plugin-Autor kontrolliert, daher validieren Sie es, bevor Sie es vertrauen. Es wird weggelassen, wenn das Manifest keines deklariert

1081* `error_count`: die Anzahl der Fehler beim Laden von Plugins

1082

1083Übergeben Sie `{ holdOnCacheImpact: true }` an `reloadPlugins()`, um ein Neuladen zu halten, das den Prompt-Cache des Gesprächs ungültig machen würde, anstatt es anzuwenden. Claude Code führt die Prüfung durch, die der interaktive `/reload-plugins`-Befehl macht, bevor er [vor den Cache-Kosten warnt](/docs/de/prompt-caching#enabling-or-disabling-a-plugin). Die Option erfordert Agent SDK v0.3.268 oder später. Eine Claude Code-Ausführungsdatei älter als v2.1.268, z. B. eine, auf die Sie `pathToClaudeCodeExecutable` verweisen, ignoriert die Option und wendet das Neuladen an.

1084

1085Wenn Sie die Option übergeben, lesen Sie `held`, um zu erfahren, was passiert ist:

1086

1087* `true`: das Neuladen wurde nicht angewendet, und die Sammlungsfelder beschreiben die Sitzung, wie sie immer noch ist. `cache_impact` sagt, was das Anwenden ändern würde. Um es trotzdem anzuwenden, rufen Sie `reloadPlugins()` erneut ohne die Option auf.

1088* `false`: die Prüfung fand keine Cache-Auswirkung, und das Neuladen wurde angewendet.

1089* Abwesend: Sie haben die Option nicht übergeben, oder die Claude Code-Ausführungsdatei ist älter als v2.1.268 und hat das Neuladen angewendet.

1090

1091`cache_impact` ist nur neben `held: true` vorhanden. `mcp_servers_added` und `mcp_servers_removed` nennen die Plugin-MCP-Server, die das Neuladen registrieren oder ablegen würde, als scoped `plugin:<plugin>:<server>`-Namen. Die Namen sind vom Plugin-Autor, daher validieren Sie sie, bevor Sie sie anzeigen. `lsp_tool_change` sagt, ob das Anwenden das LSP-Tool hinzufügen oder entfernen würde, oder `null`, wenn es keines von beiden tun würde. Die `may-`-Formen bedeuten, dass die Prüfung die ausstehende Plugin-Menge nicht vollständig sehen konnte.

1092

953<h3 id="sdkcontrolreloadskillsresponse">1093<h3 id="sdkcontrolreloadskillsresponse">

954 `SDKControlReloadSkillsResponse`1094 `SDKControlReloadSkillsResponse`

955</h3>1095</h3>

964 1104

965`skills` listet die nach dem Neuladen verfügbaren Fähigkeiten in der gleichen [`SlashCommand`](#slashcommand)-Form auf, die `supportedCommands()` zurückgibt.1105`skills` listet die nach dem Neuladen verfügbaren Fähigkeiten in der gleichen [`SlashCommand`](#slashcommand)-Form auf, die `supportedCommands()` zurückgibt.

966 1106

1107<h3 id="sdkcontrolreloadoutputstylesresponse">

1108 `SDKControlReloadOutputStylesResponse`

1109</h3>

1110

1111Rückgabetyp von [`reloadOutputStyles()`](#query-object).

1112

1113```typescript theme={null}

1114type SDKControlReloadOutputStylesResponse = {

1115 available_output_styles: string[];

1116};

1117```

1118

1119`available_output_styles` listet die Namen der integrierten und benutzerdefinierten Ausgabestile auf, die nach dem Neuladen verfügbar sind.

1120

967<h3 id="sdkcontrolmcpreadresourceresponse">1121<h3 id="sdkcontrolmcpreadresourceresponse">

968 `SDKControlMcpReadResourceResponse`1122 `SDKControlMcpReadResourceResponse`

969</h3>1123</h3>

984 1138

985Übergeben Sie `readMcpResource()` den Server-Namen, wie `mcpServerStatus()` ihn meldet, und eine `ui://`-URI, z. B. die `ui.resourceUri`, die ein Tool in seinen [`_meta`](#mcpserverstatus) deklariert. Der Aufruf lehnt für jedes andere URI-Schema ab, für einen [SDK MCP-Server](#createsdkmcpserver), den Ihre Anwendung selbst hostet, und für einen Server, der nicht verbunden ist. Es ist verfügbar, wenn die Init-Nachricht [`capabilities`](#sdksystemmessage) `mcp_read_resource_v1` enthalten.1139Übergeben Sie `readMcpResource()` den Server-Namen, wie `mcpServerStatus()` ihn meldet, und eine `ui://`-URI, z. B. die `ui.resourceUri`, die ein Tool in seinen [`_meta`](#mcpserverstatus) deklariert. Der Aufruf lehnt für jedes andere URI-Schema ab, für einen [SDK MCP-Server](#createsdkmcpserver), den Ihre Anwendung selbst hostet, und für einen Server, der nicht verbunden ist. Es ist verfügbar, wenn die Init-Nachricht [`capabilities`](#sdksystemmessage) `mcp_read_resource_v1` enthalten.

986 1140

987Jeder `contents`-Eintrag ist ein Inhalts-Element, wie der Server es gesendet hat. `blob` enthält Base64-Daten für ein binäres Element, und `_meta` ist das `_meta` des Elements selbst, wo ein MCP Apps-Server die `ui.csp` und `ui.permissions` der Ressource ablegt. Der Inhalt ist nicht vertrauenswürdiges HTML von Drittanbietern, daher rendern Sie ihn in einer Sandbox.1141Jeder `contents`-Eintrag ist ein Inhalts-Element, wie der Server es gesendet hat, minus jedes `_meta`-Schlüssel unter dem `com.anthropic/`-Präfix, das für Claude Code reserviert ist. `blob` enthält Base64-Daten für ein binäres Element, und `_meta` ist das `_meta` des Elements selbst, wo ein MCP Apps-Server die `ui.csp` und `ui.permissions` der Ressource ablegt.

1142

1143Die Inhalte sind nicht vertrauenswürdiges HTML von Drittanbietern, daher rendern Sie sie in einer Sandbox.

988 1144

989<h3 id="agentdefinition">1145<h3 id="agentdefinition">

990 `AgentDefinition`1146 `AgentDefinition`

1142 blockedPath?: string;1298 blockedPath?: string;

1143 mcpServer?: { name: string; source: string };1299 mcpServer?: { name: string; source: string };

1144 decisionReason?: string;1300 decisionReason?: string;

1301 defaultToNo?: boolean;

1302 suppressAlwaysAllowRule?: boolean;

1145 toolUseID: string;1303 toolUseID: string;

1146 agentID?: string;1304 agentID?: string;

1147 requestId: string;1305 requestId: string;

1157| `mcpServer` | `{ name: string; source: string }` | Für ein `mcp__*`-Tool, der MCP-Server, der es bedient, und woher diese Server-Definition kam, mit den Feldern von [`McpServerProvenance`](#mcpserverprovenance). Abwesend für andere Tools. Erfordert Agent SDK v0.3.274 oder später |1315| `mcpServer` | `{ name: string; source: string }` | Für ein `mcp__*`-Tool, der MCP-Server, der es bedient, und woher diese Server-Definition kam, mit den Feldern von [`McpServerProvenance`](#mcpserverprovenance). Abwesend für andere Tools. Erfordert Agent SDK v0.3.274 oder später |

1317| `defaultToNo` | `boolean` | Wenn `true`, muss ein einzelner Tippfehler diese Anfrage nicht genehmigen: öffnen Sie Ihre Eingabeaufforderung auf ihrer Ablehnungsoption, wählen Sie nicht vorab genehmigen, und bieten Sie keine Eintasten-Genehmigungsverknüpfung. Erfordert Agent SDK v0.3.268 oder später |

1318| `suppressAlwaysAllowRule` | `boolean` | Wenn `true`, bieten Sie keine persistente Always-Allow-Wahl für diese Anfrage, da die Regel, die sie schreiben würde, mehr als die Aktion der Anfrage selbst gewährt. Erfordert Agent SDK v0.3.268 oder später |

1161| `requestId` | `string` | Die `request_id` des `control_request`-Umschlags. Eine `control_response`, die Ihre Anwendung außerhalb des SDK sendet, z. B. ein signierter HTTP POST, muss diesen Wert widerspiegeln, damit der Claude Code-Prozess die Antwort mit der Anfrage abgleichen kann |1321| `requestId` | `string` | Die `request_id` des `control_request`-Umschlags. Eine `control_response`, die Ihre Anwendung außerhalb des SDK sendet, z. B. ein signierter HTTP POST, muss diesen Wert widerspiegeln, damit der Claude Code-Prozess die Antwort mit der Anfrage abgleichen kann |

1380 context_usage?: SDKContextUsage;1540 context_usage?: SDKContextUsage;

1381 user_message_uuid?: string;1541 user_message_uuid?: string;

1382 user_message_uuids?: string[];1542 user_message_uuids?: string[];

1543 resume_reason?: string;

1383};1544};

1384```1545```

1385 1546

1386Das `message`-Feld ist eine [`BetaMessage`](https://platform.claude.com/docs/de/api/messages/create) aus dem Anthropic SDK. Es enthält Felder wie `id`, `content`, `model`, `stop_reason` und `usage`.1547Das `message`-Feld ist eine [`BetaMessage`](https://platform.claude.com/docs/en/api/messages/create) aus dem Anthropic SDK. Es enthält Felder wie `id`, `content`, `model`, `stop_reason` und `usage`.

1387 1548

1388`SDKAssistantMessageError` ist einer von: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_found'`, `'server_error'`, `'max_output_tokens'`, `'cloud_credential_error'` oder `'unknown'`. Vier dieser Werte bedeuten mehr als ihre Namen aussagen:1549`SDKAssistantMessageError` ist einer von: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_found'`, `'server_error'`, `'max_output_tokens'`, `'cloud_credential_error'` oder `'unknown'`. Vier dieser Werte bedeuten mehr als ihre Namen aussagen:

1389 1550

1394 1555

1395`aborted` ist `true`, wenn ein Interrupt oder Abbruch die Assistenten-Nachricht vor Abschluss des Streams abgeschnitten hat: Die Nachricht hat keinen `stop_reason` und der Inhalt kann mitten im Wort enden. Das Feld fehlt bei normal abgeschlossenen Nachrichten. Es erfordert Agent SDK v0.3.214 oder später.1556`aborted` ist `true`, wenn ein Interrupt oder Abbruch die Assistenten-Nachricht vor Abschluss des Streams abgeschnitten hat: Die Nachricht hat keinen `stop_reason` und der Inhalt kann mitten im Wort enden. Das Feld fehlt bei normal abgeschlossenen Nachrichten. Es erfordert Agent SDK v0.3.214 oder später.

1396 1557

1397Claude Code setzt `user_message_uuid` und `user_message_uuids` auf die erste Assistenten-Nachricht des Turns unter den Bedingungen in [`user_message_uuid`](#user_message_uuid).1558Claude Code setzt `user_message_uuid` und `user_message_uuids` auf die erste Assistenten-Nachricht des Turns unter den Bedingungen in [`user_message_uuid`](#user_message_uuid). Wenn Claude Code einen Turn erneut ausführt, den ein Neustart unterbrochen hat, tragen die Assistenten-Nachrichten des erneuten Durchlaufs, die diese Felder tragen, auch [`resume_reason`](#resume_reason).

1398 1559

1399`timestamp` ist die ISO-8601-Zeit, wenn die Generierung des Nachrichteninhalts auf dem Prozess, der ihn erzeugt hat, beendet wurde. Der Wert stammt von der Uhr dieser Maschine, daher verwenden Sie ihn nur zur Anzeige und ordnen Sie Nachrichten nicht danach. Ein API-Turn kann mehrere Assistenten-Nachrichten erzeugen, die eine `message.id` teilen, jede mit ihrem eigenen `timestamp`. Wenn das Feld fehlt, greifen Sie auf die Zeit zurück, zu der Sie die Nachricht erhalten haben.1560`timestamp` ist die ISO-8601-Zeit, wenn die Generierung des Nachrichteninhalts auf dem Prozess, der ihn erzeugt hat, beendet wurde. Der Wert stammt von der Uhr dieser Maschine, daher verwenden Sie ihn nur zur Anzeige und ordnen Sie Nachrichten nicht danach. Ein API-Turn kann mehrere Assistenten-Nachrichten erzeugen, die eine `message.id` teilen, jede mit ihrem eigenen `timestamp`. Wenn das Feld fehlt, greifen Sie auf die Zeit zurück, zu der Sie die Nachricht erhalten haben.

1400 1561

1416 parent_tool_use_id: string | null;1577 parent_tool_use_id: string | null;

1417 isSynthetic?: boolean;1578 isSynthetic?: boolean;

1418 shouldQuery?: boolean;1579 shouldQuery?: boolean;

1580 client_composed?: true;

1419 tool_use_result?: unknown;1581 tool_use_result?: unknown;

1420 origin?: SDKMessageOrigin;1582 origin?: SDKMessageOrigin;

1421 inline_pastes?: string[];1583 inline_pastes?: string[];

1424 1586

1425Setzen Sie `pasted_content`, um Inhalte zu senden, die der Benutzer in Ihre Eingabeaufforderungs-Benutzeroberfläche eingefügt hat, anstatt sie einzugeben, einen Eintrag pro Einfügung, jeder ein String oder ein Array von Inhaltsblöcken. Claude Code fügt den Text jedes Eintrags nach dem eingegebenen Text an, in Reihenfolge, und kann jede Einfügung in `<pasted_content>`-Tags einwickeln. Blöcke außer Text werden ignoriert, daher senden Sie Bilder und Dokumente in `message.content`. Erfordert Agent SDK v0.3.277 oder später.1587Setzen Sie `pasted_content`, um Inhalte zu senden, die der Benutzer in Ihre Eingabeaufforderungs-Benutzeroberfläche eingefügt hat, anstatt sie einzugeben, einen Eintrag pro Einfügung, jeder ein String oder ein Array von Inhaltsblöcken. Claude Code fügt den Text jedes Eintrags nach dem eingegebenen Text an, in Reihenfolge, und kann jede Einfügung in `<pasted_content>`-Tags einwickeln. Blöcke außer Text werden ignoriert, daher senden Sie Bilder und Dokumente in `message.content`. Erfordert Agent SDK v0.3.277 oder später.

1426 1588

1427Setzen Sie `shouldQuery` auf `false`, um die Nachricht zum Transkript hinzuzufügen, ohne einen Assistenten-Turn auszulösen. Die Nachricht wird gehalten und in die nächste Benutzer-Nachricht zusammengeführt, die einen Turn auslöst. Verwenden Sie dies, um Kontext einzufügen, z. B. die Ausgabe eines Befehls, den Sie außerhalb des Bands ausgeführt haben, ohne einen Modell-Aufruf dafür auszugeben.1589Setzen Sie `shouldQuery` oder `client_composed`, um zu ändern, wie Claude Code eine Nachricht handhabt, die Sie senden:

1590

1591* `shouldQuery`: Setzen Sie es auf `false`, um die Nachricht zum Transkript hinzuzufügen, ohne einen Assistenten-Turn auszulösen. Die Nachricht wird gehalten und in die nächste Benutzer-Nachricht zusammengeführt, die einen Turn auslöst. Verwenden Sie dies, um Kontext einzufügen, z. B. die Ausgabe eines Befehls, den Sie außerhalb des Bands ausgeführt haben, ohne einen Modell-Aufruf dafür auszugeben.

1592* `client_composed`: Setzen Sie es auf `true`, um Claude Code die Nachricht so zu liefern, wie sie geschrieben ist. Claude Code erweitert dann nicht `@path` oder [`@server:resource`](/docs/de/mcp#use-mcp-resources)-Erwähnungen und führt keinen Text aus, der mit `/` beginnt, als Befehl aus. Während die [`verbatimPrompts`](#options)-Option aktiv ist, setzt das SDK das Feld auf jede Nachricht. Erfordert TypeScript Agent SDK v0.3.280 oder später und Claude Code v2.1.248 oder später.

1428 1593

1429Auf einer Nachricht, die einen `tool_result`-Block trägt, ist `tool_use_result` das strukturierte Ausgabeobjekt des Tools und nicht der Text, der an das Modell gesendet wird. Seine Form hängt vom Tool ab, das durch den entsprechenden `tool_use`-Block benannt wird, daher ist das Feld als `unknown` typisiert; die integrierten Formen sind unter [Tool-Ausgabetypen](#tool-output-types) aufgelistet.1594Auf einer Nachricht, die einen `tool_result`-Block trägt, ist `tool_use_result` das strukturierte Ausgabeobjekt des Tools und nicht der Text, der an das Modell gesendet wird. Seine Form hängt vom Tool ab, das durch den entsprechenden `tool_use`-Block benannt wird, daher ist das Feld als `unknown` typisiert; die integrierten Formen sind unter [Tool-Ausgabetypen](#tool-output-types) aufgelistet.

1430 1595

1448 message: MessageParam;1613 message: MessageParam;

1449 parent_tool_use_id: string | null;1614 parent_tool_use_id: string | null;

1450 isSynthetic?: boolean;1615 isSynthetic?: boolean;

1616 client_composed?: true;

1451 tool_use_result?: unknown;1617 tool_use_result?: unknown;

1452 origin?: SDKMessageOrigin;1618 origin?: SDKMessageOrigin;

1453 isReplay: true;1619 isReplay: true;

1480 ttft_stream_ms?: number;1646 ttft_stream_ms?: number;

1481 user_message_uuid?: string;1647 user_message_uuid?: string;

1482 user_message_uuids?: string[];1648 user_message_uuids?: string[];

1649 resume_reason?: string;

1650 local_command?: string;

1483 request_sent_wall_ms?: number;1651 request_sent_wall_ms?: number;

1484 first_content_frame_ms?: number;1652 first_content_frame_ms?: number;

1485 first_stream_post_ms?: number;1653 first_stream_post_ms?: number;

1493 structured_output?: unknown;1661 structured_output?: unknown;

1494 deferred_tool_use?: { id: string; name: string; input: Record<string, unknown> };1662 deferred_tool_use?: { id: string; name: string; input: Record<string, unknown> };

1495 terminal_reason?: TerminalReason;1663 terminal_reason?: TerminalReason;

1664 result_index?: number;

1496 fast_mode_state?: FastModeState;1665 fast_mode_state?: FastModeState;

1497 fast_mode_disabled_reason?: FastModeDisabledReason;1666 fast_mode_disabled_reason?: FastModeDisabledReason;

1498 origin?: SDKMessageOrigin;1667 origin?: SDKMessageOrigin;

1520 startup_failure_reason?: SDKStartupFailureReason;1689 startup_failure_reason?: SDKStartupFailureReason;

1521 user_message_uuid?: string;1690 user_message_uuid?: string;

1522 user_message_uuids?: string[];1691 user_message_uuids?: string[];

1692 resume_reason?: string;

1523 terminal_reason?: TerminalReason;1693 terminal_reason?: TerminalReason;

1694 result_index?: number;

1524 fast_mode_state?: FastModeState;1695 fast_mode_state?: FastModeState;

1525 fast_mode_disabled_reason?: FastModeDisabledReason;1696 fast_mode_disabled_reason?: FastModeDisabledReason;

1526 origin?: SDKMessageOrigin;1697 origin?: SDKMessageOrigin;

1534* `ttft_stream_ms`: Zeit in Millisekunden bis zum ersten `message_start`-Stream-Ereignis, wenn der Response-Stream öffnet. Niedriger als `ttft_ms`; die Lücke zwischen den beiden ist die Zeit, die zum Streamen der ersten Nachricht benötigt wird. Nur auf dem Success-Arm vorhanden.1705* `ttft_stream_ms`: Zeit in Millisekunden bis zum ersten `message_start`-Stream-Ereignis, wenn der Response-Stream öffnet. Niedriger als `ttft_ms`; die Lücke zwischen den beiden ist die Zeit, die zum Streamen der ersten Nachricht benötigt wird. Nur auf dem Success-Arm vorhanden.

1535* `user_message_uuid`: Die `uuid` der Nachricht, die Sie gesendet haben und diesen Turn beantwortet hat. Siehe [`user_message_uuid`](#user_message_uuid) für welche Ergebnisse sie tragen.1706* `user_message_uuid`: Die `uuid` der Nachricht, die Sie gesendet haben und diesen Turn beantwortet hat. Siehe [`user_message_uuid`](#user_message_uuid) für welche Ergebnisse sie tragen.

1536* `user_message_uuids`: Die `uuid`s jeder Nachricht, die Sie gesendet haben und die Claude Code in diesem Turn beantwortet hat. Siehe [`user_message_uuids`](#user_message_uuids).1707* `user_message_uuids`: Die `uuid`s jeder Nachricht, die Sie gesendet haben und die Claude Code in diesem Turn beantwortet hat. Siehe [`user_message_uuids`](#user_message_uuids).

1708* `resume_reason`: Warum Claude Code diesen Turn nach einem Neustart erneut ausgeführt hat, der ihn unterbrochen hat. Vorhanden auf beiden Armen und nur bei einem solchen erneuten Durchlauf. Siehe [`resume_reason`](#resume_reason).

1709* `local_command`: Der Name des Befehls, den der Turn versendet hat, auf dem Success-Ergebnis eines Turns, den ein Befehl abgeschlossen hat, ohne die Agent-Schleife zu betreten, wie `/compact`. Der Name wird auf Kleinbuchstaben und Unterstriche gefaltet, daher meldet `/reload-plugins` `reload_plugins`. Ein Befehl, den ein MCP-Server bereitstellt, und das integrierte `/mcp`, melden `mcp`. Ein Befehl, den Sie selbst definiert haben, meldet `custom`. Die Argumente sind nie enthalten. Fehlt bei jedem Turn, der die Agent-Schleife betreten hat, und bei Sends, die keinen Befehl ausgeführt haben. Erfordert Agent SDK v0.3.268 oder später.

1537* `request_sent_wall_ms`: Epoch-Millisekunden, zu denen Claude Code die API-Anfrage versendet hat, für Joins gegen Server-seitige Zeitstempel. Nur zusammen mit [`user_message_uuid`](#user_message_uuid) vorhanden, auf einem Success-Ergebnis mit `is_error` false, dessen Turn eine API-Anfrage versendet hat.1710* `request_sent_wall_ms`: Epoch-Millisekunden, zu denen Claude Code die API-Anfrage versendet hat, für Joins gegen Server-seitige Zeitstempel. Nur zusammen mit [`user_message_uuid`](#user_message_uuid) vorhanden, auf einem Success-Ergebnis mit `is_error` false, dessen Turn eine API-Anfrage versendet hat.

1538*1711* `first_content_frame_ms`: Zeit in Millisekunden bis zum ersten `content_block_start`- oder `content_block_delta`-Stream-Ereignis, wobei Thinking-Blöcke als Inhalt gezählt werden. Nur auf dem Success-Arm vorhanden, wenn `is_error` false ist. Erfordert Agent SDK v0.3.260 oder später.

~~1539~~ 1712* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: Zeitangaben zum Hochladen des ersten Stream-Ereignisses des Turns. Claude Code zeichnet sie nur in Sitzungen auf, die es zu claude.ai streamt, wie [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), und die Ergebnisse, die `query()` liefert, enthalten sie nicht. Erfordert Agent SDK v0.3.260 oder später.

1540`first_content_frame_ms`: Zeit in Millisekunden bis zum ersten `content_block_start`- oder `content_block_delta`-Stream-Ereignis, wobei Thinking-Blöcke als Inhalt gezählt werden. Nur auf dem Success-Arm vorhanden, wenn `is_error` false ist. Erfordert Agent SDK v0.3.260 oder später.

~~1541~~

1542*

~~1543~~

1544`first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: Zeitangaben zum Hochladen des ersten Stream-Ereignisses des Turns. Claude Code zeichnet sie nur in Sitzungen auf, die es zu claude.ai streamt, wie [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), und die Ergebnisse, die `query()` liefert, enthalten sie nicht. Erfordert Agent SDK v0.3.260 oder später.

~~1545~~

1546* `usage`: Nur Hauptagenten-Schleife. Schließt Subagenten- und Hilfmodell-Aufrufe aus und ist pro Turn in Streaming-Input-Sitzungen. Bevorzugen Sie `modelUsage` für Token-/Kostenabrechnung.1713* `usage`: Nur Hauptagenten-Schleife. Schließt Subagenten- und Hilfmodell-Aufrufe aus und ist pro Turn in Streaming-Input-Sitzungen. Bevorzugen Sie `modelUsage` für Token-/Kostenabrechnung.

1547* `modelUsage`: Pro-Modell-Summen für jeden Modell-Aufruf, der während dieses `query()`-Aufrufs durch die Abfrage-Pipeline gemacht wurde, einschließlich der Hauptschleife, Subagenten und interner Aufrufe wie Komprimierung und Workflow-Agenten. Hilfaufrufe außerhalb dieser Pipeline, wie der Berechtigungsklassifizierer und Token-Zählungsanfragen, sind ausgeschlossen. Ein Aufruf, der eine Sitzung fortgesetzt, zählt auch die [Pro-Modell-Summen, die aus den früheren Aufrufen der Sitzung wiederhergestellt wurden](/docs/de/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). In Streaming-Input-Sitzungen sind die Summen kumulativ über Turns, daher lesen Sie das neueste Ergebnis, anstatt über Ergebnisse zu summieren. Siehe [Kosten im Streaming-Input-Modus verfolgen](/docs/de/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) für Zurückstellungen und [Summen nach einem Sitzungsabsturz wiederherstellen](/docs/de/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) für zurückgesetzte Ergebnisse.1714* `modelUsage`: Pro-Modell-Summen für jeden Modell-Aufruf, der während dieses `query()`-Aufrufs durch die Abfrage-Pipeline gemacht wurde, einschließlich der Hauptschleife, Subagenten und interner Aufrufe wie Komprimierung und Workflow-Agenten. Hilfaufrufe außerhalb dieser Pipeline, wie der Berechtigungsklassifizierer und Token-Zählungsanfragen, sind ausgeschlossen. Ein Aufruf, der eine Sitzung fortgesetzt, zählt auch die [Pro-Modell-Summen, die aus den früheren Aufrufen der Sitzung wiederhergestellt wurden](/docs/de/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). In Streaming-Input-Sitzungen sind die Summen kumulativ über Turns, daher lesen Sie das neueste Ergebnis, anstatt über Ergebnisse zu summieren. Siehe [Kosten im Streaming-Input-Modus verfolgen](/docs/de/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) für Zurückstellungen und [Summen nach einem Sitzungsabsturz wiederherstellen](/docs/de/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) für zurückgesetzte Ergebnisse.

1548* `total_cost_usd`: Kumulativer geschätzter Kosten in USD, abdeckend die gleichen Aufrufe wie `modelUsage` und Zurückstellung an den gleichen Punkten. Ein Aufruf, der eine Sitzung fortgesetzt, zählt auch die [Summen, die aus den früheren Aufrufen der Sitzung wiederhergestellt wurden](/docs/de/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Es ist eine Schätzung, keine Abrechnungsaussage. Siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Genauigkeitsvorbehalt.1715* `total_cost_usd`: Kumulativer geschätzter Kosten in USD, abdeckend die gleichen Aufrufe wie `modelUsage` und Zurückstellung an den gleichen Punkten. Ein Aufruf, der eine Sitzung fortgesetzt, zählt auch die [Summen, die aus den früheren Aufrufen der Sitzung wiederhergestellt wurden](/docs/de/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Es ist eine Schätzung, keine Abrechnungsaussage. Siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Genauigkeitsvorbehalt.

1549* `queued_turn_count`: Die Anzahl der Nachrichten, die Sie mit `origin: { kind: "human" }` gesendet haben und die noch warten, wenn Claude Code das Ergebnis erzeugt hat. Siehe [`queued_turn_count`](#queued_turn_count) für was `0` und ein fehlendes Feld Ihnen sagen.1716* `queued_turn_count`: Die Anzahl der Nachrichten, die Sie mit `origin: { kind: "human" }` gesendet haben und die noch warten, wenn Claude Code das Ergebnis erzeugt hat. Siehe [`queued_turn_count`](#queued_turn_count) für was `0` und ein fehlendes Feld Ihnen sagen.

1550*1717* `result_index`: Wo dieses Ergebnis in der Lieferreihenfolge des Durchlaufs fällt, gezählt von 0 über jedes Ergebnis, das der Prozess schreibt. Vorhanden auf beiden Armen. Ein Ergebnis, dessen Schreiben fehlschlägt, verbraucht immer noch seine Nummer, daher bedeutet eine Lücke in der Sequenz, dass ein Ergebnis verloren ging. Erfordert Agent SDK v0.3.268 oder später.

~~1551~~ 1718* `startup_failure_reason`: Warum Claude Code sich weigerte zu starten, auf dem `error_during_execution`-Ergebnis, das es vor dem Beenden bei einem bekannten Startfehler schreibt. Siehe [`startup_failure_reason`](#startup_failure_reason) für die Werte und welche Fehler es tragen. Erfordert Agent SDK v0.3.274 oder später.

1552`startup_failure_reason`: Warum Claude Code sich weigerte zu starten, auf dem `error_during_execution`-Ergebnis, das es vor dem Beenden bei einem bekannten Startfehler schreibt. Siehe [`startup_failure_reason`](#startup_failure_reason) für die Werte und welche Fehler es tragen. Erfordert Agent SDK v0.3.274 oder später.

~~1553~~

1554* `terminal_reason`: Warum die Schleife endete. Einer von `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"` oder `"turn_setup_failed"`.1719* `terminal_reason`: Warum die Schleife endete. Einer von `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"` oder `"turn_setup_failed"`.

1555* `fast_mode_state`: Einer von `"on"`, `"off"` oder `"cooldown"`.1720* `fast_mode_state`: Einer von `"on"`, `"off"` oder `"cooldown"`.

1556* `fast_mode_disabled_reason`: Warum [Fast Mode](/docs/de/fast-mode) gerade nicht verfügbar ist. Fehlt, wenn nichts Fast Mode blockiert, obwohl eine Anfrage möglicherweise immer noch mit Standardgeschwindigkeit ausgeführt wird. Während der Abkühlung nach einem Fast Mode Rate Limit meldet Claude Code `fast_mode_state: "cooldown"` ohne Grund-Code und reaktiviert Fast Mode, wenn die Abkühlung abläuft. Erfordert Claude Code v2.1.219 oder später.1721* `fast_mode_disabled_reason`: Warum [Fast Mode](/docs/de/fast-mode) gerade nicht verfügbar ist. Fehlt, wenn nichts Fast Mode blockiert, obwohl eine Anfrage möglicherweise immer noch mit Standardgeschwindigkeit ausgeführt wird. Während der Abkühlung nach einem Fast Mode Rate Limit meldet Claude Code `fast_mode_state: "cooldown"` ohne Grund-Code und reaktiviert Fast Mode, wenn die Abkühlung abläuft. Erfordert Claude Code v2.1.219 oder später.

1590 1755

1591* **Eine reguläre Nachricht, die Sie gesendet haben**, d. h. eine ohne `isSynthetic: true`: Der Turn beantwortet diese Nachricht für seinen gesamten Lauf. Wenn Sie mehrere Nachrichten dicht beieinander senden, kann Claude Code sie in einen Turn zusammenführen, und das Feld trägt dann nur die `uuid` der letzten Nachricht. Um die Antwort mit einer der zusammengeführten Nachrichten abzugleichen, verwenden Sie [`user_message_uuids`](#user_message_uuids).1756* **Eine reguläre Nachricht, die Sie gesendet haben**, d. h. eine ohne `isSynthetic: true`: Der Turn beantwortet diese Nachricht für seinen gesamten Lauf. Wenn Sie mehrere Nachrichten dicht beieinander senden, kann Claude Code sie in einen Turn zusammenführen, und das Feld trägt dann nur die `uuid` der letzten Nachricht. Um die Antwort mit einer der zusammengeführten Nachrichten abzugleichen, verwenden Sie [`user_message_uuids`](#user_message_uuids).

1592* **Eine Nachricht, die Sie mit `isSynthetic: true` gesendet haben**: Der Turn beantwortet diese Nachricht zunächst. Wenn Claude Code eine reguläre Nachricht von Ihnen zwischen Tool-Aufrufen aufgreift, beantwortet der Turn die aufgegriffene Nachricht von da an. Das Wiederholen einer synthetischen Nachricht `uuid` erfordert Agent SDK v0.3.265 oder später; frühere Versionen wiederholen nichts bei synthetischen Turns.1757* **Eine Nachricht, die Sie mit `isSynthetic: true` gesendet haben**: Der Turn beantwortet diese Nachricht zunächst. Wenn Claude Code eine reguläre Nachricht von Ihnen zwischen Tool-Aufrufen aufgreift, beantwortet der Turn die aufgegriffene Nachricht von da an. Das Wiederholen einer synthetischen Nachricht `uuid` erfordert Agent SDK v0.3.265 oder später; frühere Versionen wiederholen nichts bei synthetischen Turns.

1593* **Eine Eingabeaufforderung, die Claude Code selbst generiert hat**, wie der Turn, der unterbrochene Arbeit nach einem Sitzungsneustart fortsetzt: Der Turn beantwortet zunächst keine Nachricht von Ihnen und seine Frames tragen keine Wiederholung. Wenn Claude Code eine reguläre Nachricht von Ihnen zwischen Tool-Aufrufen aufgreift, beantwortet der Turn diese Nachricht von da an. Die Aufgreif-Wiederholung erfordert Agent SDK v0.3.265 oder später; frühere Versionen wiederholen nichts bei diesen Turns.1758* **Die Eingabeaufforderung, die Claude Code generiert, um einen unterbrochenen Turn unter [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/de/env-vars) erneut auszuführen**: Wenn die letzte Eingabeaufforderung des unterbrochenen Turns eine reguläre Nachricht ist, die Sie gesendet haben, ob sie den Turn öffnete oder Claude Code sie während des Turns aufgriff, beantwortet der erneute Durchlauf diese Nachricht zunächst. [`resume_reason`](#resume_reason) sagt die Frames des erneuten Durchlaufs vom unterbrochenen Versuch. Wenn die letzte Eingabeaufforderung keine reguläre Nachricht von Ihnen ist, beantwortet der erneute Durchlauf zunächst keine Nachricht von Ihnen. Wenn Claude Code eine reguläre Nachricht von Ihnen zwischen Tool-Aufrufen aufgreift, beantwortet der Turn die aufgegriffene Nachricht von da an. Das Wiederholen der Eingabeaufforderung des unterbrochenen Turns erfordert Agent SDK v0.3.268 oder später.

1759* **Jede andere Eingabeaufforderung, die Claude Code selbst generiert hat**: Der Turn beantwortet zunächst keine Nachricht von Ihnen und seine Frames tragen keine Wiederholung. Wenn Claude Code eine reguläre Nachricht von Ihnen zwischen Tool-Aufrufen aufgreift, beantwortet der Turn diese Nachricht von da an. Die Aufgreif-Wiederholung erfordert Agent SDK v0.3.265 oder später; frühere Versionen wiederholen nichts bei diesen Turns.

1594 1760

1595Claude Code wiederholt die `uuid` der beantworteten Nachricht auf drei Arten von Frames:1761Claude Code wiederholt die `uuid` der beantworteten Nachricht auf drei Arten von Frames:

1596 1762

1617 1783

1618Wenn eine erste Antwort oder ein Ergebnis `user_message_uuid` ohne die Liste trägt, kam es von einer früheren Claude Code-Version, daher greifen Sie auf das einzelne Feld zurück.1784Wenn eine erste Antwort oder ein Ergebnis `user_message_uuid` ohne die Liste trägt, kam es von einer früheren Claude Code-Version, daher greifen Sie auf das einzelne Feld zurück.

1619 1785

1786<h4 id="resume_reason">

1787 `resume_reason`

1788</h4>

1789

1790Warum Claude Code diesen Turn nach einem Neustart erneut ausgeführt hat. Claude Code setzt dieses Feld auf einen Turn, den es unter [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/de/env-vars) erneut ausgeführt hat, damit Sie die Frames des erneuten Durchlaufs vom unterbrochenen Versuch unterscheiden können. Erfordert Agent SDK v0.3.268 oder später.

1791

1792Claude Code setzt das Feld auf zwei Arten von Frames:

1793

1794* **Das Ergebnis des erneuten Durchlaufs**: auf den Success- und Error-Armen gleichermaßen, unabhängig davon, ob das Ergebnis `user_message_uuid` trägt.

1795* **Die Antwort-Frames des erneuten Durchlaufs**: diejenigen, die [`user_message_uuid`](#user_message_uuid) tragen.

1796

1797Der Wert ist ein kurzes Kleinbuchstaben-Token, das benennt, warum der Turn erneut ausgeführt wurde, wie `interrupted_turn`. Das Feld fehlt bei jedem anderen Turn.

1798

1620<h4 id="queued_turn_count">1799<h4 id="queued_turn_count">

1621 `queued_turn_count`1800 `queued_turn_count`

1622</h4>1801</h4>

1666| `org_pin_api_key_conflict` | Verwaltete Einstellungen [erfordern eine First-Party- oder Cloud-Gateway-Anmeldung](/docs/de/authentication#restrict-login-to-your-organization), und ein Anthropic API-Schlüssel, Auth-Token oder `apiKeyHelper` ist stattdessen konfiguriert |1845| `org_pin_api_key_conflict` | Verwaltete Einstellungen [erfordern eine First-Party- oder Cloud-Gateway-Anmeldung](/docs/de/authentication#restrict-login-to-your-organization), und ein Anthropic API-Schlüssel, Auth-Token oder `apiKeyHelper` ist stattdessen konfiguriert |

1667| `org_verify_failed` | Die Anmeldungs-Organisation konnte nicht gegen die PIN verifiziert werden, z. B. wegen eines Netzwerkfehlers oder eines widerrufenen Tokens |1846| `org_verify_failed` | Die Anmeldungs-Organisation konnte nicht gegen die PIN verifiziert werden, z. B. wegen eines Netzwerkfehlers oder eines widerrufenen Tokens |

1669| `managed_settings_invalid` | Verwaltete Richtlinien-Einstellungen konnten nicht gelesen werden, oder die PIN benennt keine Organisation |1848| `managed_settings_invalid` | Verwaltete Richtlinien-Einstellungen konnten nicht gelesen werden, die PIN benennt keine Organisation, oder [verwaltete Modellbeschränkungen](/docs/de/errors#managed-settings-block-the-default-model) lassen kein zulässiges Modell für die Standard-Option |

1670| `remote_settings_required_unavailable` | Verwaltete Einstellungen, die die Organisation erfordert, konnten nicht geladen werden |1849| `remote_settings_required_unavailable` | Verwaltete Einstellungen, die die Organisation erfordert, konnten nicht geladen werden |

1672| `gateway_access_denied` | Die verwaltete Einstellungs-Anfrage an das Cloud-Gateway kam mit einem 403 zurück, das die [Fehlerbehebungs-Tabelle](/docs/de/claude-apps-gateway-deploy#troubleshooting) des Gateways abdeckt |1851| `gateway_access_denied` | Die verwaltete Einstellungs-Anfrage an das Cloud-Gateway kam mit einem 403 zurück, das die [Fehlerbehebungs-Tabelle](/docs/de/claude-apps-gateway-deploy#troubleshooting) des Gateways abdeckt |

1710 output_style: string;1889 output_style: string;

1711 skills: string[];1890 skills: string[];

1712 plugins: { name: string; path: string }[];1891 plugins: { name: string; path: string }[];

1892 plugin_errors?: {

1893 plugin: string;

1894 type: string;

1895 message: string;

1896 path?: string;

1897 }[];

1713 fast_mode_state?: FastModeState;1898 fast_mode_state?: FastModeState;

1714 fast_mode_disabled_reason?: FastModeDisabledReason;1899 fast_mode_disabled_reason?: FastModeDisabledReason;

1736| `interrupt_receipt_v1` | [`interrupt()`](#query-object) wird mit einer [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse)-Quittung aufgelöst, die die Nachrichten benennt, die ausstanden, als der Interrupt ankam |1921| `interrupt_receipt_v1` | [`interrupt()`](#query-object) wird mit einer [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse)-Quittung aufgelöst, die die Nachrichten benennt, die ausstanden, als der Interrupt ankam |

1737| `interrupt_cancel_queued_v1` | Die `interrupt`-Steueranfrage ehrt `cancel_queued: true`, bricht die Nachrichten ab, die die Quittung sonst unter `still_queued` auflisten würde, und listet sie stattdessen unter `cancelled` auf. Siehe [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Erfordert Claude Code v2.1.219 oder später |1922| `interrupt_cancel_queued_v1` | Die `interrupt`-Steueranfrage ehrt `cancel_queued: true`, bricht die Nachrichten ab, die die Quittung sonst unter `still_queued` auflisten würde, und listet sie stattdessen unter `cancelled` auf. Siehe [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Erfordert Claude Code v2.1.219 oder später |

1738 1923

1924Das `plugin_errors`-Array listet Plugin-Ladefehler auf. Ein Eintrag beschreibt entweder ein Plugin, das nicht geladen wurde und in `plugins` fehlt, oder ein Plugin, das ohne einen seiner Teile geladen wurde, wie seine Hooks-Datei. Der Schlüssel wird weggelassen, wenn nichts fehlgeschlagen ist. `SDKSystemMessage` erklärt `plugin_errors` in Agent SDK v0.3.283 oder später.

1925

1926Wenn ein Verzeichnis oder Archiv aus Ihrer [`plugins`-Option](#options) selbst nicht geladen wird, hält das `plugin`-Feld des Eintrags ein Positions-Tag wie `inline[0]` anstelle eines Plugin-Namens. Dies geschieht beispielsweise, wenn der Pfad nicht existiert oder das Manifest ungültig ist. Gleichen Sie einen solchen Eintrag mit Ihrer Option durch sein `path`-Feld ab.

1927

1928Die Tabelle unten listet die Felder jedes `plugin_errors`-Eintrags auf.

1929

1930| Feld | Typ | Beschreibung |

1931| - | - | - |

1932| `plugin` | `string` | Die ID des fehlgeschlagenen Plugins, oder ein Positions-Tag wie `inline[0]`, wenn das Plugin-Verzeichnis oder -Archiv selbst nicht geladen wurde |

1933| `type` | `string` | Fehler-Kategorie aus einem offenen Set, wie `path-not-found` oder `manifest-validation-error`. Behandeln Sie einen Wert, den Sie nicht erkennen, als generischen Fehler |

1934| `message` | `string` | Anzeigetext, der den Fehler beschreibt |

1935| `path` | `string` | Nur vorhanden, wenn das Plugin-Verzeichnis oder -Archiv selbst nicht geladen wurde. Sein absoluter Pfad, mit einem relativen Pfad aus Ihrer `plugins`-Option gegen die [`cwd`](#options)-Option aufgelöst |

1936

1739<h3 id="sdkpartialassistantmessage">1937<h3 id="sdkpartialassistantmessage">

1740 `SDKPartialAssistantMessage`1938 `SDKPartialAssistantMessage`

1741</h3>1939</h3>

1752 ttft_ms?: number; // Zeit bis zum ersten Token in ms, nur bei message_start-Ereignissen vorhanden1950 ttft_ms?: number; // Zeit bis zum ersten Token in ms, nur bei message_start-Ereignissen vorhanden

1753 user_message_uuid?: string;1951 user_message_uuid?: string;

1754 user_message_uuids?: string[];1952 user_message_uuids?: string[];

1953 resume_reason?: string;

1755};1954};

1756```1955```

1757 1956

1758Claude Code setzt `user_message_uuid` und `user_message_uuids` auf das erste nicht-ping-Stream-Ereignis des Turns und erneut, wenn sich die Nachricht, die der Turn beantwortet, ändert, unter den Bedingungen in [`user_message_uuid`](#user_message_uuid).1957Claude Code setzt `user_message_uuid` und `user_message_uuids` auf das erste nicht-ping-Stream-Ereignis des Turns und erneut, wenn sich die Nachricht, die der Turn beantwortet, ändert, unter den Bedingungen in [`user_message_uuid`](#user_message_uuid). Wenn Claude Code einen Turn erneut ausführt, den ein Neustart unterbrochen hat, tragen die Stream-Ereignisse des erneuten Durchlaufs, die diese Felder tragen, auch [`resume_reason`](#resume_reason).

1759 1958

1760<h3 id="sdkcompactboundarymessage">1959<h3 id="sdkcompactboundarymessage">

1761 `SDKCompactBoundaryMessage`1960 `SDKCompactBoundaryMessage`

1780 `SDKInformationalMessage`1979 `SDKInformationalMessage`

1781</h3>1980</h3>

1782 1981

1783Generisches Text-Banner, das von der Schleife ausgegeben wird. Enthält nicht-fehlerhafte Statuszeilen, Hook-Feedback wie ein Block-Grund eines `UserPromptSubmit`-Hooks und Befehlsausgabe. Auf Claude Code v2.1.227 oder später kann die [`systemMessage`](/docs/de/hooks#json-output) eines Hooks als diese Nachricht ankommen, mit jeder Zeile mit dem Namen des Hooks vorangestellt, wie `PostToolUse:Bash says:`. Ob die `systemMessage` eines Hooks als diese Nachricht ankommt, hängt vom Ereignis ab. Jeder [Ereignisabschnitt](/docs/de/hooks#hook-events) auf der Hooks-Seite sagt, wie die Ausgabe angezeigt wird. Rendern Sie `content` als Klartext auf der angegebenen `level`.1982Generisches Text-Banner, das von der Schleife ausgegeben wird. Enthält Warnungen, Hinweise und andere nicht-fehlerhafte Statuszeilen, die Claude Code auslöst, und Hook-Feedback wie ein Block-Grund eines `UserPromptSubmit`-Hooks.

1983

1984Auf Claude Code v2.1.227 oder später kann die [`systemMessage`](/docs/de/hooks#json-output) eines Hooks als diese Nachricht ankommen, mit jeder Zeile mit dem Namen des Hooks vorangestellt, wie `PostToolUse:Bash says:`. Jeder [Ereignisabschnitt](/docs/de/hooks#hook-events) auf der Hooks-Seite sagt, wie die Ausgabe angezeigt wird.

1985

1986Rendern Sie `content` als Klartext auf der angegebenen `level`.

1784 1987

1785```typescript theme={null}1988```typescript theme={null}

1786type SDKInformationalMessage = {1989type SDKInformationalMessage = {

1836Stream-Ereignis, das ausgegeben wird, wenn das Berechtigungssystem einen Tool-Aufruf ablehnt, ohne eine interaktive Eingabeaufforderung anzuzeigen. Verwenden Sie es, um die Ablehnung in Ihrer Benutzeroberfläche zu rendern, während sie geschieht, anstatt nur das `is_error`-Tool-Ergebnis zu beobachten, das folgt. Welche Ablehnungen es meldet, hängt davon ab, wie der Lauf Berechtigungsaufforderungen handhabt:2039Stream-Ereignis, das ausgegeben wird, wenn das Berechtigungssystem einen Tool-Aufruf ablehnt, ohne eine interaktive Eingabeaufforderung anzuzeigen. Verwenden Sie es, um die Ablehnung in Ihrer Benutzeroberfläche zu rendern, während sie geschieht, anstatt nur das `is_error`-Tool-Ergebnis zu beobachten, das folgt. Welche Ablehnungen es meldet, hängt davon ab, wie der Lauf Berechtigungsaufforderungen handhabt:

1837 2040

1838* **Mit einem [`canUseTool`](#canusetool)-Callback** und dem Standard [`permissionPrompts: 'host'`](#options): Berechtigungsaufforderungen gehen an Ihren Callback, und dieses Ereignis meldet die Ablehnungen, die Claude Code auf eigene Faust entscheidet, ohne es aufzurufen.2041* **Mit einem [`canUseTool`](#canusetool)-Callback** und dem Standard [`permissionPrompts: 'host'`](#options): Berechtigungsaufforderungen gehen an Ihren Callback, und dieses Ereignis meldet die Ablehnungen, die Claude Code auf eigene Faust entscheidet, ohne es aufzurufen.

1839* **Mit keinem**: ein bloßer `-p`-Lauf, oder `query()`, das weder `canUseTool` noch `permissionPromptToolName` setzt, lehnt jeden Tool-Aufruf ab, der aufgefordert hätte, und dieses Ereignis meldet diese Ablehnungen sowie die, die Claude Code auf eigene Faust entscheidet. Vor v2.1.223 gab Claude Code dieses Ereignis nicht in Läufen ohne Callback aus.2042*

2043

2044**Mit keinem**: ein bloßer `-p`-Lauf, oder `query()`, das weder `canUseTool` noch `permissionPromptToolName` setzt, lehnt jeden Tool-Aufruf ab, der aufgefordert hätte, und dieses Ereignis meldet diese Ablehnungen sowie die, die Claude Code auf eigene Faust entscheidet. Vor v2.1.223 gab Claude Code dieses Ereignis nicht in Läufen ohne Callback aus.

2045

1840* **Mit einem MCP-Aufforderungs-Tool**, gesetzt mit `permissionPromptToolName` oder dem [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Flag, und dem Standard `permissionPrompts: 'host'`: Claude Code gibt dieses Ereignis überhaupt nicht aus, nicht einmal für die Regel-Ablehnungen, die es auf eigene Faust entscheidet.2046* **Mit einem MCP-Aufforderungs-Tool**, gesetzt mit `permissionPromptToolName` oder dem [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Flag, und dem Standard `permissionPrompts: 'host'`: Claude Code gibt dieses Ereignis überhaupt nicht aus, nicht einmal für die Regel-Ablehnungen, die es auf eigene Faust entscheidet.

1841* **Mit [`permissionPrompts: 'none'`](#options)**: Claude Code lehnt die Aufrufe ab, die aufgefordert hätten, auch wenn `canUseTool` oder ein MCP-Aufforderungs-Tool auch gesetzt ist, und dieses Ereignis meldet diese Ablehnungen sowie die, die Claude Code auf eigene Faust entscheidet. Erfordert Claude Code v2.1.259 oder später.2047*

2048

2049**Mit [`permissionPrompts: 'none'`](#options)**: Claude Code lehnt die Aufrufe ab, die aufgefordert hätten, auch wenn `canUseTool` oder ein MCP-Aufforderungs-Tool auch gesetzt ist, und dieses Ereignis meldet diese Ablehnungen sowie die, die Claude Code auf eigene Faust entscheidet. Erfordert Claude Code v2.1.259 oder später.

1842 2050

1843In jeder Konfiguration überspringt dieses Ereignis jede Ablehnung, die auf dem `PreToolUse`-Hook-Pfad entschieden wurde, ob der Hook den Aufruf selbst ablehnte oder eine Deny-Regel die Allow- oder Ask-Entscheidung des Hooks überschrieb. Das Ereignis ist auch Best-Effort: Gelegentlich zeichnet Claude Code eine Ablehnung auf, ohne dieses Ereignis auszugeben, daher ist `permission_denials` auf der [Ergebnis-Nachricht](#sdkresultmessage) der maßgebliche Datensatz.2051In jeder Konfiguration überspringt dieses Ereignis jede Ablehnung, die auf dem `PreToolUse`-Hook-Pfad entschieden wurde, ob der Hook den Aufruf selbst ablehnte oder eine Deny-Regel die Allow- oder Ask-Entscheidung des Hooks überschrieb. Das Ereignis ist auch Best-Effort: Gelegentlich zeichnet Claude Code eine Ablehnung auf, ohne dieses Ereignis auszugeben, daher ist `permission_denials` auf der [Ergebnis-Nachricht](#sdkresultmessage) der maßgebliche Datensatz.

1844 2052

2887 Tool-Eingabetypen3095 Tool-Eingabetypen

2888</h2>3096</h2>

2889 3097

2890Dokumentation von Eingabeschemas für alle integrierten Claude Code-Tools. Diese Typen werden aus `@anthropic-ai/claude-agent-sdk` exportiert und können für typsichere Tool-Interaktionen verwendet werden.3098Dokumentation 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.

2891 3099

2892<h3 id="toolinputschemas">3100<h3 id="toolinputschemas">

2893 `ToolInputSchemas`3101 `ToolInputSchemas`

2894</h3>3102</h3>

2895 3103

2896Union von Tool-Eingabetypen, exportiert aus `@anthropic-ai/claude-agent-sdk`; Mitglieder umfassen:3104Union von Tool-Eingabetypen, exportiert aus `@anthropic-ai/claude-agent-sdk/sdk-tools`; Mitglieder umfassen:

2897 3105

2898```typescript theme={null}3106```typescript theme={null}

2899type ToolInputSchemas =3107type ToolInputSchemas =

3695 Tool-Ausgabetypen3903 Tool-Ausgabetypen

3696</h2>3904</h2>

3697 3905

3698Dokumentation von Ausgabeschemas für alle integrierten Claude Code-Tools. Diese Typen werden aus `@anthropic-ai/claude-agent-sdk` exportiert und stellen die tatsächlichen Antwortdaten dar, die von jedem Tool zurückgegeben werden.3906Dokumentation 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.

3699 3907

3700<h3 id="tooloutputschemas">3908<h3 id="tooloutputschemas">

3701 `ToolOutputSchemas`3909 `ToolOutputSchemas`

3702</h3>3910</h3>

3703 3911

3704Union von Tool-Ausgabetypen, die aus `@anthropic-ai/claude-agent-sdk` exportiert werden; Mitglieder umfassen:3912Union von Tool-Ausgabetypen, die aus `@anthropic-ai/claude-agent-sdk/sdk-tools` exportiert werden; Mitglieder umfassen:

3705 3913

3706```typescript theme={null}3914```typescript theme={null}

3707type ToolOutputSchemas =3915type ToolOutputSchemas =

5539 `SDKTaskProgressMessage`5747 `SDKTaskProgressMessage`

5540</h3>5748</h3>

5541 5749

5542Wird regelmäßig ausgegeben, während ein Subagent oder eine Hintergrund-Aufgabe läuft. Das `summary`-Feld wird nur ausgefüllt, wenn [`agentProgressSummaries`](#options) aktiviert ist.5750Wird regelmäßig ausgegeben, während ein Subagent oder eine Hintergrund-Aufgabe läuft.

5751

5752Für eine Subagenten-Aufgabe trägt das `summary`-Feld eine modellgenerierte Fortschritts-Zusammenfassung und wird nur ausgefüllt, wenn [`agentProgressSummaries`](#options) aktiviert ist. Für einen [backgrounded MCP-Tool-Aufruf](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) trägt `summary` den neuesten gemeldeten Fortschritt des MCP-Servers und hängt nicht von dieser Option ab.

5543 5753

5544```typescript theme={null}5754```typescript theme={null}

5545type SDKTaskProgressMessage = {5755type SDKTaskProgressMessage = {

5702 5912

5703Wird ausgegeben, wenn sich die Menge der verfügbaren Befehle während einer Sitzung ändert, z. B. wenn Claude Code Skills entdeckt, wenn der Agent ein Unterverzeichnis betritt. Das `commands`-Array ist die vollständig aktualisierte Liste, daher ersetzen Sie alle zwischengespeicherten Befehlslisten durch diese Nutzlast. Das Aufrufen von [`supportedCommands()`](#query-object) nach dieser Nachricht gibt die gleiche aktualisierte Liste zurück, weil die Methode den neuesten Push verfolgt; dies erfordert Agent SDK v0.3.216 oder später. In früheren SDK-Versionen gibt `supportedCommands()` den bei der Initialisierung erfassten Snapshot zurück und spiegelt nie Änderungen während der Sitzung wider.5913Wird ausgegeben, wenn sich die Menge der verfügbaren Befehle während einer Sitzung ändert, z. B. wenn Claude Code Skills entdeckt, wenn der Agent ein Unterverzeichnis betritt. Das `commands`-Array ist die vollständig aktualisierte Liste, daher ersetzen Sie alle zwischengespeicherten Befehlslisten durch diese Nutzlast. Das Aufrufen von [`supportedCommands()`](#query-object) nach dieser Nachricht gibt die gleiche aktualisierte Liste zurück, weil die Methode den neuesten Push verfolgt; dies erfordert Agent SDK v0.3.216 oder später. In früheren SDK-Versionen gibt `supportedCommands()` den bei der Initialisierung erfassten Snapshot zurück und spiegelt nie Änderungen während der Sitzung wider.

5704 5914

5915Claude Code gibt diese Nachricht auch aus, wenn die [Prompts](/docs/de/mcp#use-mcp-prompts-as-commands) eines MCP-Servers der Liste beitreten oder sie verlassen, z. B. wenn ein Server nach dem Sitzungsstart die Verbindung herstellt. Dies erfordert Claude Code v2.1.281 oder später.

5916

5705```typescript theme={null}5917```typescript theme={null}

5706type SDKCommandsChangedMessage = {5918type SDKCommandsChangedMessage = {

5707 type: "system";5919 type: "system";

5739 new_conversation_id: UUID;5951 new_conversation_id: UUID;

5740 uuid: UUID;5952 uuid: UUID;

5741 session_id: string;5953 session_id: string;

5954 trigger?: "clear" | "plan_mode_exit" | "fresh_session" | "onboarding";

5955 user_message_uuid?: string;

5956 timestamp?: string;

5742};5957};

5743```5958```

5744 5959

5960Die optionalen Felder beschreiben den Reset:

5961

5962* `trigger`: was die Konversation verworfen hat. Setzen Sie Ihr Transkript bei jeder `conversation_reset`-Nachricht zurück, einschließlich einer, bei der dieses Feld fehlt oder einen Wert trägt, den Sie nicht erkennen.

5963* `user_message_uuid`: die `uuid` der Benutzer-Nachricht, die `/clear` trug. Verwenden Sie sie, um den Reset mit dieser Nachricht abzugleichen.

5964* `timestamp`: wann der Reset stattfand, als ISO-8601-Zeichenkette in UTC. Verwenden Sie sie zur Anzeige, nicht zur Reihenfolge von Nachrichten.

5965

5966Die Felder `trigger`, `user_message_uuid` und `timestamp` erfordern Claude Code v2.1.281 oder später.

5967

5745Die veröffentlichten Typings des SDK deklarieren `SDKConversationResetMessage` in Claude Code v2.1.203 und später. Vor v2.1.203 referenzierte `SDKMessage` den Typ, ohne ihn zu deklarieren, daher schlug die Eingrenzung auf `type === "conversation_reset"` fehl, wenn `skipLibCheck` deaktiviert war.5968Die veröffentlichten Typings des SDK deklarieren `SDKConversationResetMessage` in Claude Code v2.1.203 und später. Vor v2.1.203 referenzierte `SDKMessage` den Typ, ohne ihn zu deklarieren, daher schlug die Eingrenzung auf `type === "conversation_reset"` fehl, wenn `skipLibCheck` deaktiviert war.

5746 5969

5747<h3 id="aborterror">5970<h3 id="aborterror">

5860| `strictAllowlist` | `boolean` | `false` | Verweigern Sie sandboxed Befehlen den Zugriff auf Hosts außerhalb der [Netzwerk-Allowlist](/docs/de/sandboxing#network-isolation), anstatt zu fragen. Nur für sandboxed Befehle erzwungen; In-Process-Tools wie WebFetch werden nicht dadurch blockiert. Nur von Benutzer-, verwalteten oder CLI `--settings` Einstellungen berücksichtigt; Projekteinstellungen werden ignoriert. Erfordert Claude Code v2.1.219 oder später |6083| `strictAllowlist` | `boolean` | `false` | Verweigern Sie sandboxed Befehlen den Zugriff auf Hosts außerhalb der [Netzwerk-Allowlist](/docs/de/sandboxing#network-isolation), anstatt zu fragen. Nur für sandboxed Befehle erzwungen; In-Process-Tools wie WebFetch werden nicht dadurch blockiert. Nur von Benutzer-, verwalteten oder CLI `--settings` Einstellungen berücksichtigt; Projekteinstellungen werden ignoriert. Erfordert Claude Code v2.1.219 oder später |

5861| `allowManagedDomainsOnly` | `boolean` | `false` | Nur verwaltete Einstellungen. Wenn in [verwalteten Einstellungen](/docs/de/managed-settings) gesetzt, werden nur `allowedDomains`-Einträge und `WebFetch(domain:...)`-Zulassungsregeln aus verwalteten Einstellungen berücksichtigt, und Zulassungseinträge aus Benutzer-, Projekt- oder lokalen Einstellungen werden ignoriert. Hat keine Auswirkung, wenn über SDK-Optionen gesetzt |6084| `allowManagedDomainsOnly` | `boolean` | `false` | Nur verwaltete Einstellungen. Wenn in [verwalteten Einstellungen](/docs/de/managed-settings) gesetzt, werden nur `allowedDomains`-Einträge und `WebFetch(domain:...)`-Zulassungsregeln aus verwalteten Einstellungen berücksichtigt, und Zulassungseinträge aus Benutzer-, Projekt- oder lokalen Einstellungen werden ignoriert. Vom SDK aus übergeben Sie es über die [`managedSettings`](#options)-Option |

agent-sdk/user-input.md +2 −0

Details

296 <Tab title="Genehmigen und merken">296 <Tab title="Genehmigen und merken">

297 Der Benutzer genehmigt und möchte nicht erneut gefragt werden für diese Art von Aufruf. Das dritte Callback-Argument enthält `suggestions`, ein Array von vorgefertigten [`PermissionUpdate`](/docs/de/agent-sdk/typescript#permissionupdate)-Einträgen. Geben Sie einen in `updatedPermissions` zurück, um ihn anzuwenden. Ein Vorschlag mit dem `localSettings`-Ziel schreibt die Regel in `.claude/settings.local.json`, damit zukünftige Sitzungen die Aufforderung für übereinstimmende Aufrufe überspringen.297 Der Benutzer genehmigt und möchte nicht erneut gefragt werden für diese Art von Aufruf. Das dritte Callback-Argument enthält `suggestions`, ein Array von vorgefertigten [`PermissionUpdate`](/docs/de/agent-sdk/typescript#permissionupdate)-Einträgen. Geben Sie einen in `updatedPermissions` zurück, um ihn anzuwenden. Ein Vorschlag mit dem `localSettings`-Ziel schreibt die Regel in `.claude/settings.local.json`, damit zukünftige Sitzungen die Aufforderung für übereinstimmende Aufrufe überspringen.

298 298

299 In TypeScript überspringen Sie die Wahl „Immer zulassen" für eine Anfrage, deren Optionen [`suppressAlwaysAllowRule: true`](/docs/de/agent-sdk/typescript#canusetool) enthalten. Der Hinweis erfordert Agent SDK v0.3.268 oder später, und der Python-`context` enthält ihn nicht.

300

299 Das Python-Beispiel erfordert `claude-agent-sdk` 0.1.80 oder später.301 Das Python-Beispiel erfordert `claude-agent-sdk` 0.1.80 oder später.

300 302

301 <CodeGroup>303 <CodeGroup>

agent-teams.md +3 −1

Details

333 Kontext und Kommunikation333 Kontext und Kommunikation

334</h3>334</h3>

335 335

336Jeder Teammate hat sein eigenes Kontextfenster. Beim Erzeugen lädt ein Teammate denselben Projektkontext wie eine reguläre Sitzung: CLAUDE.md, MCP-Server und Skills. Er erhält auch den Spawn-Prompt vom Lead. Die Gesprächshistorie des Leads wird nicht übertragen.336Jeder Teammate hat sein eigenes Kontextfenster. Beim Erzeugen lädt ein Teammate denselben Projektkontext wie eine reguläre Sitzung: CLAUDE.md, MCP-Server und Skills. Wenn Sie den Lead mit [`--setting-sources`](/docs/de/cli-reference#cli-flags) starten, laden Teammates aus der gleichen eingeschränkten Liste von Quellen. Vor v2.1.281 luden [Split-Pane](#choose-a-display-mode)-Teammates jede Einstellungsquelle.

337

338Ein Teammate erhält auch den Spawn-Prompt vom Lead. Die Gesprächshistorie des Leads wird nicht übertragen.

337 339

338**Wie Teammates Informationen teilen:**340**Wie Teammates Informationen teilen:**

339 341

agent-view.md +22 −6

Details

260 260

261Wenn Sie `←` drücken, wird die Sitzungszeile erstellt, auch wenn die Konversation noch keine Nachrichten hat, sodass `→` immer noch zu ihr zurückkehrt.261Wenn Sie `←` drücken, wird die Sitzungszeile erstellt, auch wenn die Konversation noch keine Nachrichten hat, sodass `→` immer noch zu ihr zurückkehrt.

262 262

263Sie können diese Verknüpfung mit der `leftArrowOpensAgents`-Einstellung in `/config` ausschalten.263Sie können diese Verknüpfung mit der [`leftArrowOpensAgents`](/docs/de/settings-reference#leftarrowopensagents)-Einstellung in `/config` ausschalten.

264 264

265<h3 id="organize-the-list">265<h3 id="organize-the-list">

266 Liste organisieren266 Liste organisieren

454 454

455* `--mcp-config` und `--strict-mcp-config`455* `--mcp-config` und `--strict-mcp-config`

456* `--settings`456* `--settings`

457* `--setting-sources`

457* `--add-dir`458* `--add-dir`

458* `--plugin-dir`459* `--plugin-dir`

459* `--fallback-model`460* `--fallback-model`

473 474

474Die Eingabeaufforderung ist das Positionsargument, nicht ein `-p`-Wert. Claude Code lehnt `--bg` kombiniert mit `-p` oder `--print` ab, bevor eine Sitzung erstellt wird, da `--print` niemals die interaktive Sitzung startet, an die `claude agents` anhängt.475Die Eingabeaufforderung ist das Positionsargument, nicht ein `-p`-Wert. Claude Code lehnt `--bg` kombiniert mit `-p` oder `--print` ab, bevor eine Sitzung erstellt wird, da `--print` niemals die interaktive Sitzung startet, an die `claude agents` anhängt.

475 476

477Wenn Sie `claude --bg` aus einem Terminal in einem Verzeichnis ausführen, das Sie nicht [vertraut](/docs/de/permissions#project-allow-rules-and-workspace-trust) haben, wird der Workspace-Vertrauensdialog zuerst angezeigt und die Sitzung startet, sobald Sie akzeptieren. Wenn Sie ablehnen, wird Claude Code beendet, ohne eine Sitzung zu starten. Wo kein Dialog angezeigt werden kann, z. B. in einem Skript, wird der Befehl stattdessen mit einem [`Workspace not trusted`](/docs/de/errors#workspace-not-trusted-when-dispatching-a-background-session)-Fehler beendet.

478

476Um einen bestimmten [Subagenten](/docs/de/sub-agents), den Sie definiert haben, wie einen `code-reviewer`, als Hauptagent der Sitzung auszuführen, kombinieren Sie `--bg` mit `--agent`:479Um einen bestimmten [Subagenten](/docs/de/sub-agents), den Sie definiert haben, wie einen `code-reviewer`, als Hauptagent der Sitzung auszuführen, kombinieren Sie `--bg` mit `--agent`:

477 480

478```bash theme={null}481```bash theme={null}

593* Ein Worktree, den Git nicht mehr erkennt, z. B. nach `git worktree prune`, blockiert das Löschen nicht. Claude Code löscht die Sitzung und lässt das Verzeichnis auf der Festplatte.596* Ein Worktree, den Git nicht mehr erkennt, z. B. nach `git worktree prune`, blockiert das Löschen nicht. Claude Code löscht die Sitzung und lässt das Verzeichnis auf der Festplatte.

594* Wenn Git oder Ihr [`WorktreeRemove`-Hook](/docs/de/hooks#worktreeremove) fehlschlägt, den Worktree zu entfernen, behält Claude Code den Worktree und die Sitzung, und die Nachricht benennt die Ursache. Für einen Hook sagt die Nachricht, wie er endete, z. B. `exited 1`, und zitiert den Anfang seines stderr. Die Nachricht sagt Ihnen auch, welche dieser Aktionen Sie als nächstes tun sollten:597* Wenn Git oder Ihr [`WorktreeRemove`-Hook](/docs/de/hooks#worktreeremove) fehlschlägt, den Worktree zu entfernen, behält Claude Code den Worktree und die Sitzung, und die Nachricht benennt die Ursache. Für einen Hook sagt die Nachricht, wie er endete, z. B. `exited 1`, und zitiert den Anfang seines stderr. Die Nachricht sagt Ihnen auch, welche dieser Aktionen Sie als nächstes tun sollten:

595 598

596 * Löschen Sie die Sitzung erneut, um das Verzeichnis trotzdem zu entfernen, indem Sie `Ctrl+X` zweimal auf ihrer Zeile in der Agenten-Ansicht drücken oder den `claude rm <id> --force-remove-worktree <worktree-id>`-Befehl ausführen, den die `claude rm`-Ablehnung druckte. Claude Code bietet dies nur an, wenn es bestätigen kann, dass das Verzeichnis einer der verknüpften Worktrees des Repositories unter `.claude/worktrees/` ist, ohne nicht committete Änderungen an verfolgten Dateien, ohne verschachteltes Repository darin und ohne Aufzeichnung einer anderen Sitzung, die es benennt. Der Branch des Worktrees bleibt im Repository.599 * Löschen Sie die Sitzung erneut, um das Verzeichnis trotzdem zu entfernen, indem Sie `Ctrl+X` zweimal auf ihrer Zeile in der Agenten-Ansicht drücken oder den `claude rm <id> --force-remove-worktree <worktree-id>`-Befehl ausführen, den die `claude rm`-Ablehnung druckte. Der Worktree's Branch bleibt im Repository.

597 * Beheben Sie, was im Weg steht, z. B. indem Sie nicht committete Änderungen committen oder stashen, schließen Sie, was das Verzeichnis verwendet, oder beheben Sie den Hook, dann löschen Sie die Sitzung erneut.600

601 Claude Code bietet dies nur an, wenn es bestätigen kann, dass alle folgenden Bedingungen erfüllt sind:

602

603 * Das Verzeichnis ist einer der verknüpften Worktrees des Repositories unter `.claude/worktrees/`

604 * Weder der Worktree noch ein ausgechecktes Submodul hat nicht committete Änderungen an verfolgten Dateien

605 * Keine andere Sitzung's Aufzeichnung benennt ihn

606

607 Wenn Claude Code den Zustand eines Submodul-Checkouts nicht überprüfen kann, z. B. einen, der durch ein separates Git-Repository ersetzt wurde, bietet es dies auch nicht an.

608 * Beheben Sie, was im Weg steht, z. B. indem Sie nicht committete Änderungen committen oder stashen, ein separates Git-Repository aus dem Worktree verschieben, schließen Sie, was das Verzeichnis verwendet, oder beheben Sie den Hook, dann löschen Sie die Sitzung erneut.

598 * Entfernen Sie das Verzeichnis selbst, dann löschen Sie die Sitzung erneut.609 * Entfernen Sie das Verzeichnis selbst, dann löschen Sie die Sitzung erneut.

599 610

600Ein Worktree, den Sie selbst erstellt haben und in dem Sie die Sitzung gestartet haben, wird in jedem Fall beibehalten.611Ein Worktree, den Sie selbst erstellt haben und in dem Sie die Sitzung gestartet haben, wird in jedem Fall beibehalten.

639 Einstellungen und Provider650 Einstellungen und Provider

640</h4>651</h4>

641 652

642Eine Hintergrund-Sitzung liest ihre [Einstellungen](/docs/de/settings) aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie `claude` dort gestartet hätten. Dies umfasst [`env`-Werte](/docs/de/settings-reference#env) in Projekteinstellungen, sodass ein dort gesetzter `ANTHROPIC_MODEL` oder Provider-Variable auf jede Hintergrund-Sitzung in diesem Verzeichnis angewendet wird.653Eine Hintergrund-Sitzung liest ihre [Einstellungen](/docs/de/settings) aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie `claude` dort mit den [Konfigurationsflags, die sie trägt](#what-carries-over-when-you-background) gestartet hätten. Dies umfasst [`env`-Werte](/docs/de/settings-reference#env) in Projekteinstellungen, sodass ein dort gesetzter `ANTHROPIC_MODEL` oder Provider-Variable auf jede Hintergrund-Sitzung in diesem Verzeichnis angewendet wird.

643 654

644Eine Hintergrund-Sitzung läuft auch mit dem `PATH` der Shell, von der Sie sie versendet haben, sodass die Befehle, die sie ausführt, die gleichen Tools finden wie Ihr Terminal. Sie behält auch die Cloud-Provider-Auswahl dieser Shell, wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX`, zusammen mit ihren `ANTHROPIC_DEFAULT_*_MODEL`-Aliasen und jeder [`CLAUDE_CODE_EXTRA_BODY`](/docs/de/env-vars)-Überschreibung, die Sie dort exportiert haben.655Eine Hintergrund-Sitzung läuft auch mit dem `PATH` der Shell, von der Sie sie versendet haben, sodass die Befehle, die sie ausführt, die gleichen Tools finden wie Ihr Terminal. Sie behält auch die Cloud-Provider-Auswahl dieser Shell, wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX`, zusammen mit ihren `ANTHROPIC_DEFAULT_*_MODEL`-Aliasen und jeder [`CLAUDE_CODE_EXTRA_BODY`](/docs/de/env-vars)-Überschreibung, die Sie dort exportiert haben.

645 656

718 Einstellungen, Plugins und MCP-Server729 Einstellungen, Plugins und MCP-Server

719</h3>730</h3>

720 731

721Die Agenten-Ansicht akzeptiert die gleichen Konfigurationsflags wie `claude` zum Laden von Einstellungen, Plugins, MCP-Servern und zusätzlichen Verzeichnissen. Die Agenten-Ansicht wendet `--settings` und `--plugin-dir` auf sich selbst an und leitet jeden Konfigurationsflags an jede Sitzung weiter, die Sie daraus versenden, sodass ein Plugin oder MCP-Server, den Sie auf diese Weise laden, auch in diesen Sitzungen verfügbar ist.732Die Agenten-Ansicht akzeptiert die gleichen Konfigurationsflags wie `claude` zum Laden von Einstellungen, Plugins, MCP-Servern und zusätzlichen Verzeichnissen. Die Agenten-Ansicht wendet `--settings`, `--setting-sources` und `--plugin-dir` auf sich selbst an und leitet jeden Konfigurationsflags an jede Sitzung weiter, die Sie daraus versenden, sodass ein Plugin oder MCP-Server, den Sie auf diese Weise laden, auch in diesen Sitzungen verfügbar ist.

722 733

723| Flag | Effekt |734| Flag | Effekt |

724| :- | :- |735| :- | :- |

725| [`--settings <file-or-json>`](/docs/de/settings) | Einstellungen für Agenten-Ansicht und versendete Sitzungen überschreiben |736| [`--settings <file-or-json>`](/docs/de/settings) | Einstellungen für Agenten-Ansicht und versendete Sitzungen überschreiben |

737| [`--setting-sources <sources>`](/docs/de/cli-reference#cli-flags) | Nur die benannten Einstellungsquellen laden, in Agenten-Ansicht und versendeten Sitzungen |

726| [`--add-dir <path>`](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) | Dateizugriff auf ein zusätzliches Verzeichnis gewähren |738| [`--add-dir <path>`](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) | Dateizugriff auf ein zusätzliches Verzeichnis gewähren |

727| [`--plugin-dir <path>`](/docs/de/plugins/create#load-a-directory-or-archive-for-one-session) | Ein Plugin aus einem lokalen Verzeichnis laden |739| [`--plugin-dir <path>`](/docs/de/plugins/create#load-a-directory-or-archive-for-one-session) | Ein Plugin aus einem lokalen Verzeichnis laden |

730 742

731Wiederholen Sie `--add-dir`, `--plugin-dir` oder `--mcp-config` einmal pro Wert. `claude agents` unterstützt die durch Leerzeichen getrennte Form nicht, wie `--add-dir a b c`.743Wiederholen Sie `--add-dir`, `--plugin-dir` oder `--mcp-config` einmal pro Wert. `claude agents` unterstützt die durch Leerzeichen getrennte Form nicht, wie `--add-dir a b c`.

732 744

733Sie können `--settings` und `--plugin-dir` vor oder nach `agents` platzieren. Halten Sie `--add-dir` und `--mcp-config` nach `agents`: Wenn Sie eines davon vor `agents` platzieren, schlägt [`claude agents --json`](#manage-sessions-from-the-shell) mit einem `unknown option`-Fehler fehl.745Sie können `--settings`, `--setting-sources` und `--plugin-dir` vor oder nach `agents` platzieren. Halten Sie `--add-dir` und `--mcp-config` nach `agents`: Wenn Sie eines davon vor `agents` platzieren, schlägt [`claude agents --json`](#manage-sessions-from-the-shell) mit einem `unknown option`-Fehler fehl.

734 746

735Das folgende Beispiel öffnet die Agenten-Ansicht mit einer Einstellungsüberschreibung und einem zusätzlichen Verzeichnis:747Das folgende Beispiel öffnet die Agenten-Ansicht mit einer Einstellungsüberschreibung und einem zusätzlichen Verzeichnis:

736 748

1048 1060

1049| Version | Änderung |1061| Version | Änderung |

1050| - | - |1062| - | - |

1063| v2.1.281 | Eine [`--setting-sources`](/docs/de/cli-reference#cli-flags)-Einschränkung [überträgt sich](#what-carries-over-when-you-background) auf eine Sitzung, die Sie mit `←` oder `/bg` in den Hintergrund verschieben, und auf die Sitzungen, die Sie aus der Agenten-Ansicht versenden. Vor dieser Version lud die erzeugte Sitzung jede Einstellungsquelle. |

1064| v2.1.281 | `claude --bg` und die Befehle, die eine Sitzung neu starten, überprüfen zuerst die Workspace-Vertrauenswürdigkeit für das Verzeichnis der Sitzung. Aus einem Terminal in diesem Verzeichnis [erscheint der Vertrauensdialog](#from-your-shell), wenn Sie ihn noch nicht akzeptiert haben; wo kein Dialog erscheinen kann, wie in einem Skript, beendet sich der Befehl mit einem [`Workspace not trusted`](/docs/de/errors#workspace-not-trusted-when-dispatching-a-background-session)-Fehler. |

1065| v2.1.274 | Nach einer automatischen Aktualisierung kann sich eine Agenten-Ansicht, von der Sie etwa eine Stunde weg waren, auf den neuen Build neu starten. Wenn dies geschieht, behält sie die [Versand-Standardwerte](#dispatch-defaults), mit denen Sie sie öffneten: `--model`, `--effort`, `--permission-mode`, `--allow-dangerously-skip-permissions` und `--agent`. Vor dieser Version behielt die neu gestartete Ansicht nur `--cwd` und Konfigurationsflags wie `--settings` und `--mcp-config`, sodass Sitzungen, die Sie danach versendeten, ohne diese Standardwerte starteten. |

1066| v2.1.274 | Wenn ein [Löschen abgelehnt wird](#what-deleting-a-session-removes), weil Git oder Ihr `WorktreeRemove`-Hook den Worktree nicht entfernen konnte, blockiert ein ausgechecktes Submodul, das Claude Code überprüft hat, keine nicht committeten Änderungen an verfolgten Dateien, das Angebot zum erneuten Löschen und zum Entfernen des Verzeichnisses trotzdem nicht. Nicht committete Arbeit in einem ausgecheckten Submodul zählt als nicht committete Änderungen, und die Nachricht benennt das Submodul. Vor dieser Version blockierte jeder Submodul-Checkout im Worktree das Angebot, mit einer Nachricht, die besagt, dass der Worktree ein verschachteltes Repository enthält. |

1051| v2.1.268 | Wenn ein [Löschen abgelehnt wird](#what-deleting-a-session-removes), weil Git oder Ihr `WorktreeRemove`-Hook den Worktree nicht entfernen konnte, benennt die Nachricht die Ursache, einschließlich wie ein Hook endete und der Anfang seiner Stderr. Für einen verknüpften Worktree unter dem Repository-Verzeichnis `.claude/worktrees/` ohne nicht committete Änderungen an verfolgten Dateien, kein verschachteltes Repository darin und kein anderer Sitzungs-Datensatz, der ihn benennt, entfernt das erneute Löschen der Sitzung das Verzeichnis trotzdem, aus der Agenten-Ansicht oder mit `claude rm <id> --force-remove-worktree <worktree-id>`. Vor dieser Version zeigte die Zeile nur `worktree could not be removed (WorktreeRemove hook failed)` oder Gits Fehler, die Stderr des Hooks ging nur ins Debug-Protokoll, und das erneute Löschen wurde auf die gleiche Weise abgelehnt. |1067| v2.1.268 | Wenn ein [Löschen abgelehnt wird](#what-deleting-a-session-removes), weil Git oder Ihr `WorktreeRemove`-Hook den Worktree nicht entfernen konnte, benennt die Nachricht die Ursache, einschließlich wie ein Hook endete und der Anfang seiner Stderr. Für einen verknüpften Worktree unter dem Repository-Verzeichnis `.claude/worktrees/` ohne nicht committete Änderungen an verfolgten Dateien, kein verschachteltes Repository darin und kein anderer Sitzungs-Datensatz, der ihn benennt, entfernt das erneute Löschen der Sitzung das Verzeichnis trotzdem, aus der Agenten-Ansicht oder mit `claude rm <id> --force-remove-worktree <worktree-id>`. Vor dieser Version zeigte die Zeile nur `worktree could not be removed (WorktreeRemove hook failed)` oder Gits Fehler, die Stderr des Hooks ging nur ins Debug-Protokoll, und das erneute Löschen wurde auf die gleiche Weise abgelehnt. |

1052| v2.1.268 | Nachdem der erste `←` `Press ← again to open agents` oder `Press ← again to go back to agents` in einer angehängten Sitzung zeigt, [wechselt der erste Druck, der mindestens eine Sekunde später kommt](#switch-sessions-without-leaving-the-terminal), auch wenn schnellere Drücke dazwischen ignoriert wurden. Vor dieser Version startete jeder ignorierte Druck das Warten neu, sodass das Drücken von `←` in einem gleichmäßigen Tempo nicht wechselte, bis Sie über eine Sekunde pausiert haben. |1068| v2.1.268 | Nachdem der erste `←` `Press ← again to open agents` oder `Press ← again to go back to agents` in einer angehängten Sitzung zeigt, [wechselt der erste Druck, der mindestens eine Sekunde später kommt](#switch-sessions-without-leaving-the-terminal), auch wenn schnellere Drücke dazwischen ignoriert wurden. Vor dieser Version startete jeder ignorierte Druck das Warten neu, sodass das Drücken von `←` in einem gleichmäßigen Tempo nicht wechselte, bis Sie über eine Sekunde pausiert haben. |

1053| v2.1.260 | Wenn Sie [eine Sitzung in den Hintergrund verschieben](#from-inside-a-session), zeigt die [Agenten-Auflistung](/docs/de/cross-session-messaging#see-which-sessions-claude-can-reach) Ihrer anderen Sitzungen die Unterhaltung einmal als ihre Hintergrund-Sitzung an, und ihre Nachrichten daran erreichen das Terminal nicht mehr, von dem Sie sie verschoben haben. Vor dieser Version konnte das Terminal als zweite interaktive Sitzung unter dem Namen der Unterhaltung aufgelistet bleiben, und eine Sitzung, die die Unterhaltung vor dem Verschieben benachrichtigt hatte, lieferte weiterhin an dieses Terminal. |1069| v2.1.260 | Wenn Sie [eine Sitzung in den Hintergrund verschieben](#from-inside-a-session), zeigt die [Agenten-Auflistung](/docs/de/cross-session-messaging#see-which-sessions-claude-can-reach) Ihrer anderen Sitzungen die Unterhaltung einmal als ihre Hintergrund-Sitzung an, und ihre Nachrichten daran erreichen das Terminal nicht mehr, von dem Sie sie verschoben haben. Vor dieser Version konnte das Terminal als zweite interaktive Sitzung unter dem Namen der Unterhaltung aufgelistet bleiben, und eine Sitzung, die die Unterhaltung vor dem Verschieben benachrichtigt hatte, lieferte weiterhin an dieses Terminal. |

agents.md +1 −1

Details

13| [Subagenten](/docs/de/sub-agents) | Delegierte Mitarbeiter in einer Sitzung, die eine Nebenaufgabe in ihrem eigenen Kontext ausführen und eine Zusammenfassung zurückgeben | Eine Nebenaufgabe würde Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten, auf die Sie nicht mehr verweisen werden |13| [Subagenten](/docs/de/sub-agents) | Delegierte Mitarbeiter in einer Sitzung, die eine Nebenaufgabe in ihrem eigenen Kontext ausführen und eine Zusammenfassung zurückgeben | Eine Nebenaufgabe würde Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten, auf die Sie nicht mehr verweisen werden |

14| [Agent-Ansicht](/docs/de/agent-view) | Ein Bildschirm zum Versenden und Überwachen von Sitzungen, die im Hintergrund ausgeführt werden, geöffnet mit `claude agents`. Forschungsvorschau | Sie haben mehrere unabhängige Aufgaben und möchten diese delegieren, den Status auf einen Blick überprüfen und nur eingreifen, wenn eine Aufgabe Sie benötigt |14| [Agent-Ansicht](/docs/de/agent-view) | Ein Bildschirm zum Versenden und Überwachen von Sitzungen, die im Hintergrund ausgeführt werden, geöffnet mit `claude agents`. Forschungsvorschau | Sie haben mehrere unabhängige Aufgaben und möchten diese delegieren, den Status auf einen Blick überprüfen und nur eingreifen, wenn eine Aufgabe Sie benötigt |

15| [Agent-Teams](/docs/de/agent-teams) | Mehrere koordinierte Sitzungen mit einer gemeinsamen Aufgabenliste und Messaging zwischen Agenten, verwaltet von einem Lead. Experimentell und standardmäßig deaktiviert | Sie möchten, dass Claude ein Projekt in Teile aufteilt, diese zuweist und die Mitarbeiter synchron hält |15| [Agent-Teams](/docs/de/agent-teams) | Mehrere koordinierte Sitzungen mit einer gemeinsamen Aufgabenliste und Messaging zwischen Agenten, verwaltet von einem Lead. Experimentell und standardmäßig deaktiviert | Sie möchten, dass Claude ein Projekt in Teile aufteilt, diese zuweist und die Mitarbeiter synchron hält |

16| [Projekte](/docs/de/claude-projects) | Eine laufende Konversation auf claude.ai/code oder in der Desktop-App. Claude startet parallele Cloud-Sitzungen namens Threads, gibt jedem die Repositories, Anweisungen und den Speicher des Projekts und zeigt Ihnen, welche Sie benötigen. Öffentliche Beta auf Pro und Max | Die Arbeit erstreckt sich über viele Aufgaben über Tage oder Wochen, sollte weiterlaufen, wenn Ihr Computer ausgeschaltet ist, und Sie möchten sie lieber einmal beschreiben, als jede Sitzung zu versenden und zu verfolgen |16| [Projekte](/docs/de/claude-projects) | Eine laufende Konversation auf claude.ai/code oder in der Desktop-App. Claude startet parallele Sitzungen namens Threads in der Cloud oder, wenn Sie es anfordern, auf Ihrem Computer über Remote Control, gibt jedem die Anweisungen des Projekts und zeigt Ihnen, welche Sie benötigen. Öffentliche Beta auf Pro und Max | Die Arbeit erstreckt sich über viele Aufgaben über Tage oder Wochen, sollte weiterlaufen, wenn Ihr Computer ausgeschaltet ist, und Sie möchten sie lieber einmal beschreiben, als jede Sitzung zu versenden und zu verfolgen |

17| [Dynamische Workflows](/docs/de/workflows) | Ein Skript, das viele Subagenten ausführt und deren Ergebnisse überprüft, für einen Job, der zu groß ist, um ihn in einem Durchgang zu koordinieren, oder der mehr als einen einzelnen Durchgang benötigt | Ein Job wächst über eine Handvoll Subagenten hinaus, oder Sie möchten, dass Ergebnisse gegeneinander überprüft werden: ein codebase-weites Audit, eine 500-Datei-Migration, überprüfte Recherche oder ein Plan, der aus mehreren Blickwinkeln entworfen wurde |17| [Dynamische Workflows](/docs/de/workflows) | Ein Skript, das viele Subagenten ausführt und deren Ergebnisse überprüft, für einen Job, der zu groß ist, um ihn in einem Durchgang zu koordinieren, oder der mehr als einen einzelnen Durchgang benötigt | Ein Job wächst über eine Handvoll Subagenten hinaus, oder Sie möchten, dass Ergebnisse gegeneinander überprüft werden: ein codebase-weites Audit, eine 500-Datei-Migration, überprüfte Recherche oder ein Plan, der aus mehreren Blickwinkeln entworfen wurde |

18 18

19In jedem Ansatz sind die Mitarbeiter Claude-Sitzungen. Um ein anderes Tool einzubeziehen, stellen Sie es Claude als [MCP-Server](/docs/de/mcp) zur Verfügung.19In jedem Ansatz sind die Mitarbeiter Claude-Sitzungen. Um ein anderes Tool einzubeziehen, stellen Sie es Claude als [MCP-Server](/docs/de/mcp) zur Verfügung.

artifacts.md +39 −12

Details

51Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.51Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

52```52```

53 53

54Sofern Sie keinen Speicherort angeben, schreibt Claude die Seite in eine HTML- oder Markdown-Datei in einem temporären Verzeichnis außerhalb Ihres Projekts und veröffentlicht sie dann. Das Veröffentlichen eines neuen Artefakts erfolgt über den [Berechtigungsmodus](/docs/de/permission-modes) Ihrer Sitzung:54Sofern Sie keinen Speicherort angeben, schreibt Claude die Seite in eine HTML- oder Markdown-Datei in einem temporären Verzeichnis außerhalb Ihres Projekts und veröffentlicht sie dann. Außerhalb des [Plan Mode](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) wird ein neues Artefakt, das Claude als Reaktion auf einen von Ihnen eingegebenen Prompt veröffentlicht, ohne eine Genehmigungsaufforderung oder Klassifizierer-Überprüfung veröffentlicht, es sei denn, diese Veröffentlichung deklariert Laufzeitfähigkeiten für die Seite, wie [Konnektor-Aufrufe](#pull-live-data-with-mcp-connectors) oder [Datei-Downloads](#offer-a-file-download). Im Plan Mode fragt Claude Code Sie vor der ersten Veröffentlichung jedes Artefakts.

55 55

56* **Auto-Modus**: Der Klassifizierer überprüft die Veröffentlichung, anstatt Sie zu fragen, sodass Claude eine Seite veröffentlichen kann, ohne dass Sie eine Aufforderung sehen. Welcher Modus Ihre Sitzungen starten, hängt von Ihrem Plan ab; siehe [Der Startberechtigungsmodus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode).56Das Artefakt bleibt privat für Sie, bis Sie es [freigeben](#share-an-artifact). Nachdem Sie es öffentlich freigegeben haben, fragt Claude Code Sie einmal pro Konversation um Genehmigung, bevor es geändert wird, oder im [Auto Mode](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) lässt der Klassifizierer die Änderung überprüfen.

57* **Manueller Modus und Bearbeitungen akzeptieren-Modus**: Claude Code fragt um Genehmigung; es könnte etwa sagen: `Claude wants to publish deploy-failures.html, uploading it to claude.ai (Anthropic's servers) to host as the page "Deploy failures by service", private to you until you share it`. Wählen Sie **Ja**, um zu veröffentlichen.

58 57

~~59Nachdem Sie ein Artefakt einmal genehmigt haben, veröffentlicht Claude Code es erneut, ohne zu fragen, und fragt in einigen Fällen erneut, einschließlich wenn:~~58Wenn Sie das [Abrufen von Feature-Flags](/docs/de/env-vars#features-that-need-feature-flag-fetching) deaktiviert haben, fragt Claude Code vor der ersten Veröffentlichung jedes Artefakts, oder im Auto Mode lässt der Klassifizierer es überprüfen.

~~61* Claude deklariert eine Laufzeitfähigkeit für die Seite, wie [Konnektor-Aufrufe](#pull-live-data-with-mcp-connectors) oder [Datei-Downloads](#offer-a-file-download)~~

~~62* Sie haben es seitdem [öffentlich freigegeben](#share-an-artifact)~~

~~63* Sie haben es seitdem mit bestimmten Personen oder Ihrer Organisation freigegeben, wobei die neueste Version als die Version ausgewählt ist, die Betrachter sehen~~

64 59

65Nach der ersten Veröffentlichung druckt Claude die URL aus, und Ihr Browser öffnet die neue Seite. Wenn Sie die Aufforderung über [Remote Control](/docs/de/remote-control) von claude.ai, Claude Desktop oder der Claude Mobile-App gesendet haben, öffnet sich auf dem Computer, auf dem die Sitzung läuft, keine Registerkarte. Der Browser öffnet sich dort beim nächsten Mal, wenn Claude das Artefakt aus einer Aufforderung veröffentlicht, die Sie im Terminal eingeben. Drücken Sie `Ctrl+]` jederzeit, um das neueste Artefakt der Sitzung erneut zu öffnen.60Nach der ersten Veröffentlichung druckt Claude die URL aus, und Ihr Browser öffnet die neue Seite. Wenn Sie die Aufforderung über [Remote Control](/docs/de/remote-control) von claude.ai, Claude Desktop oder der Claude Mobile-App gesendet haben, öffnet sich auf dem Computer, auf dem die Sitzung läuft, keine Registerkarte. Der Browser öffnet sich dort beim nächsten Mal, wenn Claude das Artefakt aus einer Aufforderung veröffentlicht, die Sie im Terminal eingeben. Drücken Sie `Ctrl+]` jederzeit, um das neueste Artefakt der Sitzung erneut zu öffnen.

66 61

305 300

306Für Typografie kann Claude eine Schriftart von Google Fonts laden, der einzigen externen Schriftquelle, die eine Artefakt-Seite laden kann. Claude inline jede andere Schriftart als `@font-face` Data-URI und gibt jeder Schriftart einen Fallback-Stack, sodass die Seite immer noch gerendert wird, wenn eine Schriftart nicht geladen wird. Um eine bestimmte Schriftart zu verwenden, nennen Sie sie in Ihrem Prompt oder Ihrem Design-System.301Für Typografie kann Claude eine Schriftart von Google Fonts laden, der einzigen externen Schriftquelle, die eine Artefakt-Seite laden kann. Claude inline jede andere Schriftart als `@font-face` Data-URI und gibt jeder Schriftart einen Fallback-Stack, sodass die Seite immer noch gerendert wird, wenn eine Schriftart nicht geladen wird. Um eine bestimmte Schriftart zu verwenden, nennen Sie sie in Ihrem Prompt oder Ihrem Design-System.

307 302

308<h2 id="draft-a-design-canvas">303<h2 id="start-from-a-slides-design-or-docs-template">

309 Entwerfen Sie eine Design-Canvas304 Beginnen Sie mit einer Slides-, Design- oder Docs-Vorlage

310</h2>305</h2>

311 306

312Um eine Benutzeroberfläche, einen Bildschirmfluss, eine Landing Page oder ein Poster zu skizzieren, anstatt eine Seite zu erstellen, führen Sie `/design` mit einer kurzen Beschreibung aus. Claude entwirft das Design als Artboards auf einer Canvas und veröffentlicht die Canvas als Design-Artefakt. Die Beschreibung nennt, was Sie gezeichnet haben möchten:307Anstatt eine Seite von Grund auf zu erstellen, kann Claude ein Artefakt aus einer der Vorlagen auf Ihrem claude.ai-Konto starten: [Claude Slides](https://support.claude.com/en/articles/17153992-what-are-artifacts-and-how-do-i-use-them#h_11d5a9a5fa) für eine Präsentation, [Claude Design](https://support.claude.com/en/articles/14604416-get-started-with-claude-design) für ein visuelles Design oder [Claude Docs](https://support.claude.com/en/articles/16923645-get-started-with-claude-docs) für ein Dokument, das andere Personen lesen und bearbeiten werden. Jedes öffnet sich in seinem eigenen Editor auf claude.ai, wo Sie und Ihre Teamkollegen es direkt ändern oder Claude bitten können, dies zu tun, und es in Formate wie PowerPoint, PDF oder Word exportieren.

308

309Um von einer Vorlage zu beginnen, beschreiben Sie, was Sie möchten, z. B. „Wandeln Sie die Migrationsnoten in ein Deck für die Überprüfung am Donnerstag um" oder „Schreiben Sie diesen Plan als Dokument für das Team auf". Claude wählt die passende Vorlage aus, füllt sie aus Ihrer Anfrage und aus dem aus, was die Sitzung bereits hat, und gibt Ihnen den Link. Für ein Deck oder ein Design können Sie auch `/slides` oder `/design` mit einer kurzen Beschreibung ausführen.

310

311<Note>

312 Vorlagen befinden sich in der Beta-Phase. Sie sind standardmäßig in Pro-, Max- und Team-Plänen aktiviert. Bei Enterprise-Plänen aktiviert ein Besitzer [jede Vorlage](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) unter **Organisationseinstellungen > Artefakte**. Wenn Ihre Organisation die Slides-Vorlage deaktiviert hat, wird `/slides` nicht angezeigt; wenn sie die Design-Vorlage deaktiviert hat, entwirft `/design` keine Designs. Beide Befehle erfordern Claude Code v2.1.265 oder später und eine Sitzung, in der [Artefakte verfügbar sind](#availability).

313</Note>

314

315<h3 id="make-a-slide-deck">

316 Erstellen Sie ein Slide-Deck

317</h3>

318

319Führen Sie `/slides` mit einer kurzen Beschreibung aus, die angibt, was das Deck abdeckt und für wen es bestimmt ist:

320

321```text wrap theme={null}

322/slides a quarterly review of the platform team's reliability work, for the engineering all-hands

323```

324

325Claude erstellt ein Claude Slides-Artefakt und gibt Ihnen den Link. Öffnen Sie es in einem Desktop-Browser, um das Deck zu bearbeiten oder zu präsentieren. Wenn Sie `/slides` ohne eine kurze Beschreibung ausführen, fragt Claude, worum es bei dem Deck gehen soll, bevor etwas erstellt wird.

326

327<h3 id="draft-a-design-canvas">

328 Entwerfen Sie eine Design-Canvas

329</h3>

330

331Um eine Benutzeroberfläche, einen Bildschirmfluss, eine Landing Page oder ein Poster zu skizzieren, anstatt eine Seite zu erstellen, führen Sie `/design` mit einer kurzen Beschreibung aus. Claude entwirft das Design als Artboards auf einer Canvas und veröffentlicht die Canvas als Claude Design-Artefakt. Die Beschreibung nennt, was Sie gezeichnet haben möchten:

313 332

314```text wrap theme={null}333```text wrap theme={null}

315/design a settings screen for a mobile banking app334/design a settings screen for a mobile banking app

317 336

318Öffnen Sie das veröffentlichte Artefakt in einem Desktop-Browser, um die Artboards zu überprüfen. Wählen Sie ein Element auf einem Artboard aus und ändern Sie es, und Ihre Änderungen werden automatisch gespeichert. Sie können jedes Artboard als PNG oder PDF exportieren.337Öffnen Sie das veröffentlichte Artefakt in einem Desktop-Browser, um die Artboards zu überprüfen. Wählen Sie ein Element auf einem Artboard aus und ändern Sie es, und Ihre Änderungen werden automatisch gespeichert. Sie können jedes Artboard als PNG oder PDF exportieren.

319 338

320`/design` erfordert eine Sitzung, in der [Artefakte verfügbar sind](#availability), und Claude Code v2.1.265 oder später.339<h3 id="write-a-document-with-claude-docs">

340 Schreiben Sie ein Dokument mit Claude Docs

341</h3>

342

343Claude Docs erreicht Claude Code als einen claude.ai [Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai) anstelle eines Befehls. Wenn es verbunden ist, listet `/mcp` es als `claude.ai Claude Docs` auf. Eine Anfrage für ein Dokument, das für andere Personen bestimmt ist, geht dann zu Claude Docs anstelle einer Artefaktseite: eine Spezifikation, ein Vorschlag oder eine Zusammenfassung des Plans, den Sie in der Sitzung durchgearbeitet haben. Claude gibt Ihnen den Link des Dokuments, wenn es entworfen ist.

344

345Ein Dokument, das zum Codebase gehört, z. B. eine README, bleibt eine Datei. Um eine Datei für etwas zu erhalten, das Claude sonst in Claude Docs ablegen würde, geben Sie das Format an, z. B. `.docx` oder eine Markdown-Datei im Repository.

346

347Um den Connector auszuschalten, fügen Sie `claude.ai Claude Docs` zu `deniedMcpServers` hinzu oder verwenden Sie den `/mcp`-Umschalter, beide beschrieben in [Deaktivieren Sie claude.ai Connectors](/docs/de/mcp#disable-claude-ai-connectors).

321 348

322<h2 id="page-constraints">349<h2 id="page-constraints">

323 Seitenbeschränkungen350 Seitenbeschränkungen

authentication.md +47 −21

Details

32 32

33Um sich abzumelden und sich erneut zu authentifizieren, geben Sie `/logout` an der Claude Code-Eingabeaufforderung ein. Das Abmelden setzt auch Ihren Einrichtungsstatus beim ersten Start zurück, sodass Claude Code Sie beim nächsten Ausführen von `claude` erneut durch die Anmeldung und Einrichtung führt.33Um sich abzumelden und sich erneut zu authentifizieren, geben Sie `/logout` an der Claude Code-Eingabeaufforderung ein. Das Abmelden setzt auch Ihren Einrichtungsstatus beim ersten Start zurück, sodass Claude Code Sie beim nächsten Ausführen von `claude` erneut durch die Anmeldung und Einrichtung führt.

34 34

35Um sich gleichzeitig bei mehreren Konten angemeldet zu halten, z. B. bei Arbeits- und persönlichen Konten, geben Sie jedem Konto sein eigenes Konfigurationsverzeichnis. Wenn Sie `claude` starten, legen Sie die Umgebungsvariable [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars#variables) auf das Verzeichnis für das Konto fest, das Sie verwenden möchten. Jedes Verzeichnis hat seine eigenen Einstellungen, Sitzungsverlauf und claude.ai-Anmeldung oder API-Schlüssel. Beispielsweise können Sie in Bash oder Zsh diesen Alias zu `~/.bashrc` oder `~/.zshrc` hinzufügen, damit `claude-work` Ihr Arbeitskonto verwendet, während `claude` Ihr persönliches Konto behält:

37```bash theme={null}

38alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

39```

41Nachdem Sie ein neues Terminal öffnen und `claude-work` zum ersten Mal ausführen, führt Claude Code Sie durch die Anmeldung und Einrichtung für das neue Verzeichnis. Separate Verzeichnisse halten zwei Claude Console-Anmeldungen [ohne API-Schlüssel](#sign-in-without-an-api-key) nicht auseinander, da Claude Code diese Art der Anmeldung außerhalb des Konfigurationsverzeichnisses speichert.

35Wenn Sie Probleme beim Anmelden haben, siehe [Authentifizierungsfehlersuche](/docs/de/troubleshoot-install#login-and-authentication).43Wenn Sie Probleme beim Anmelden haben, siehe [Authentifizierungsfehlersuche](/docs/de/troubleshoot-install#login-and-authentication).

36 44

37<h2 id="set-up-team-authentication">45<h2 id="set-up-team-authentication">

122* Eine beliebige Einstellungsdatei setzt [`forceLoginOrgUUID`](#restrict-login-to-your-organization) oder setzt `forceLoginMethod` auf `"claudeai"` oder `"console"`130* Eine beliebige Einstellungsdatei setzt [`forceLoginOrgUUID`](#restrict-login-to-your-organization) oder setzt `forceLoginMethod` auf `"claudeai"` oder `"console"`

123* Eine verwaltete Einstellungsquelle auf Ihrem Computer, z. B. die verwaltete Einstellungsdatei, ein MDM-Profil oder die zwischengespeicherten serverseitig verwalteten Einstellungen, existiert, aber Claude Code [kann sie nicht lesen](/docs/de/managed-settings#invalid-entries-in-managed-settings) und keine andere verwaltete Quelle liefert eine Richtlinie131* Eine verwaltete Einstellungsquelle auf Ihrem Computer, z. B. die verwaltete Einstellungsdatei, ein MDM-Profil oder die zwischengespeicherten serverseitig verwalteten Einstellungen, existiert, aber Claude Code [kann sie nicht lesen](/docs/de/managed-settings#invalid-entries-in-managed-settings) und keine andere verwaltete Quelle liefert eine Richtlinie

124 132

125Heben Sie `ANTHROPIC_API_KEY` auf, bevor Sie sich ohne Schlüssel anmelden. Ein Profil, das von Claude Code's eigener Console-Anmeldung oder von der Claude Platform CLI's `ant auth login` geschrieben wird, ist die gleiche Art von Anmeldedaten, daher ersetzt die erneute Anmeldung es.133Heben Sie `ANTHROPIC_API_KEY` auf, bevor Sie sich ohne Schlüssel anmelden.

126 134

127Nach der Anmeldung ohne Schlüssel haben Sie ein Profil anstelle eines gespeicherten API-Schlüssels:135Nach der Anmeldung ohne Schlüssel haben Sie ein Profil anstelle eines gespeicherten API-Schlüssels:

128 136

160 168

161Um zu verlangen, dass die claude.ai-Anmeldungen von Entwicklern zu einer bestimmten Anthropic-Organisation gehören, setzen Sie [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) und [`forceLoginOrgUUID`](/docs/de/settings-reference#forceloginorguuid) in [verwalteten Einstellungen](/docs/de/managed-settings). Setzen Sie `forceLoginOrgUUID` auf Ihre Organisations-ID, die in [claude.ai Admin-Einstellungen](https://claude.ai/admin-settings/organization) für Claude for Teams oder Enterprise-Organisationen angezeigt wird. Claude Code meldet einen Fehler für eine claude.ai-Anmeldung bei einer anderen Organisation und beendet sich beim Start, wenn die verwendete claude.ai-Anmeldedaten zu einer Organisation gehört, die nicht aufgelistet ist.169Um zu verlangen, dass die claude.ai-Anmeldungen von Entwicklern zu einer bestimmten Anthropic-Organisation gehören, setzen Sie [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) und [`forceLoginOrgUUID`](/docs/de/settings-reference#forceloginorguuid) in [verwalteten Einstellungen](/docs/de/managed-settings). Setzen Sie `forceLoginOrgUUID` auf Ihre Organisations-ID, die in [claude.ai Admin-Einstellungen](https://claude.ai/admin-settings/organization) für Claude for Teams oder Enterprise-Organisationen angezeigt wird. Claude Code meldet einen Fehler für eine claude.ai-Anmeldung bei einer anderen Organisation und beendet sich beim Start, wenn die verwendete claude.ai-Anmeldedaten zu einer Organisation gehört, die nicht aufgelistet ist.

162 170

163Für Claude Console-Anmeldungen verwendet Claude Code `forceLoginOrgUUID`, um die Organisation auf der Console-Anmeldeseite vorauszuwählen, wenn Sie sie auf eine einzelne Console-Organisations-ID setzen, die unter [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization) angezeigt wird. Es überprüft nicht, zu welcher Organisation die resultierende Console-Anmeldedaten gehört, weder bei der Anmeldung noch beim Start, und ein Entwickler, der sich mit einem Console-Konto angemeldet hat, bevor Sie die Schlüssel bereitgestellt haben, bleibt angemeldet.171Für Claude Console-Anmeldungen verwendet Claude Code `forceLoginOrgUUID`, um die Organisation auf der Console-Anmeldeseite vorauszuwählen, wenn Sie sie auf eine einzelne Console-Organisations-ID setzen, die unter [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization) angezeigt wird. Es überprüft nicht, zu welcher Organisation die resultierende Console-Anmeldedaten gehört, weder bei der Anmeldung noch beim Start. Ein Entwickler, der sich mit einem Console-Konto angemeldet hat, bevor Sie die Schlüssel bereitgestellt haben, bleibt angemeldet, und dieser gespeicherte Schlüssel wird auf einem Computer blockiert, der auch die [Gateway](/docs/de/claude-apps-gateway)-Anmeldung erfordert, oder in einer Sitzung, die einen Cloud-Anbieter auswählt.

164 172

165Wenn Sie `forceLoginOrgUUID` in einer beliebigen Einstellungsdatei setzen, stoppt Claude Code das Angebot der [schlüssellosen Console-Anmeldung](#sign-in-without-an-api-key) in den Sitzungen, auf die diese Datei zutrifft, und erstellt stattdessen einen API-Schlüssel. Um Entwickler zur claude.ai-Anmeldung zu leiten, setzen Sie `forceLoginMethod` auf `"claudeai"`.173Wenn Sie `forceLoginOrgUUID` in einer beliebigen Einstellungsdatei setzen, stoppt Claude Code das Angebot der [schlüssellosen Console-Anmeldung](#sign-in-without-an-api-key) in den Sitzungen, auf die diese Datei zutrifft, und erstellt stattdessen einen API-Schlüssel. Um Entwickler zur claude.ai-Anmeldung zu leiten, setzen Sie `forceLoginMethod` auf `"claudeai"`.

166 174

167Entwickler können sich von mehreren Pfaden aus anmelden: der Terminal-`/login`-Fluss, die [VS Code-Erweiterung](/docs/de/vs-code), das Agent SDK, `claude setup-token`, `/install-github-app` und [Gateway](/docs/de/claude-apps-gateway)-Anmeldung für Organisationen, die über ein Cloud-Gateway weiterleiten. Auf Claude Code v2.1.212 oder später wendet jeder Pfad `forceLoginMethod` an; vor v2.1.212 wendeten nur Terminal-Anmeldungen einen der Schlüssel an. Auf dem interaktiven Anmeldebildschirm des Terminals, der durch `/login` oder Onboarding beim ersten Start erreicht wird, wählt Claude Code eine `claudeai`- oder `console`-Methode vor, ohne sie zu erzwingen, daher kann ein Entwickler auch mit `forceLoginMethod` auf `"claudeai"` gesetzt immer noch eine Console-Anmeldung dort abschließen. Die Pfade unterscheiden sich bei `forceLoginOrgUUID`:175Auf Claude Code v2.1.212 oder später wendet jeder hier aufgelistete Anmeldepfad `forceLoginMethod` an. Auf dem interaktiven Anmeldebildschirm des Terminals, der durch `/login` oder Onboarding beim ersten Start erreicht wird, wählt Claude Code eine `claudeai`- oder `console`-Methode vor, ohne sie zu erzwingen, daher kann ein Entwickler auch mit `forceLoginMethod` auf `"claudeai"` gesetzt immer noch eine Console-Anmeldung dort abschließen.

168 176

169* **Terminal-, VS Code-Erweiterungs- und Agent SDK-Anmeldungen**: Überprüfen Sie `forceLoginOrgUUID` für claude.ai-Kontoanmeldungen177Die Pfade unterscheiden sich bei `forceLoginOrgUUID`:

178

179* **Terminal-, [VS Code-Erweiterungs-](/docs/de/vs-code) und Agent SDK-Anmeldungen**: Überprüfen Sie `forceLoginOrgUUID` für claude.ai-Kontoanmeldungen

170* **`claude setup-token` und `/install-github-app`**: Erzwingen Sie nur `forceLoginMethod`, daher können sie ein Token in einer anderen Organisation prägen180* **`claude setup-token` und `/install-github-app`**: Erzwingen Sie nur `forceLoginMethod`, daher können sie ein Token in einer anderen Organisation prägen

171* **[Gateway](/docs/de/claude-apps-gateway)-Anmeldung**: Wird durch `forceLoginMethod: "gateway"` ausgewählt, anstatt dadurch eingeschränkt zu werden, und authentifiziert sich nicht gegen eine Anthropic-Organisation, daher gilt `forceLoginOrgUUID` nicht; verwenden Sie Ihren Gateway-Identitätsanbieter, um den Zugriff einzuschränken181* **[Gateway](/docs/de/claude-apps-gateway)-Anmeldung**: Wird durch `forceLoginMethod: "gateway"` ausgewählt, anstatt dadurch eingeschränkt zu werden, und authentifiziert sich nicht gegen eine Anthropic-Organisation, daher gilt `forceLoginOrgUUID` nicht; verwenden Sie Ihren Gateway-Identitätsanbieter, um den Zugriff einzuschränken

172 182

173Stellen Sie die Schlüssel über Ihre Geräteverwaltungstools bereit. [Serverseitig verwaltete Einstellungen](/docs/de/server-managed-settings) erreichen nur Konten, die bereits bei Ihrer Organisation authentifiziert sind, daher können sie die erste Anmeldung eines Entwicklers nicht umleiten. Wenn Ihre Organisation auch serverseitig verwaltete Einstellungen verteilt, setzen Sie die Schlüssel an beiden Orten: Verwaltete Einstellungsquellen [werden nicht zusammengeführt](/docs/de/server-managed-settings#settings-precedence), und zwischengespeicherte serverseitig verwaltete Einstellungen ersetzen die geräteverwaltete Datei, mit Ausnahme von einigen [pro-Schlüssel-Ausnahmen](/docs/de/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` und die `"claudeai"`- und `"console"`-Werte von `forceLoginMethod` sind nicht unter diesen Ausnahmen, daher behalten Sie sie an beiden Orten.183Stellen Sie die Schlüssel über Ihre Geräteverwaltungstools bereit. [Serverseitig verwaltete Einstellungen](/docs/de/server-managed-settings) erreichen nur Konten, die bereits bei Ihrer Organisation authentifiziert sind, daher können sie die erste Anmeldung eines Entwicklers nicht umleiten. Wenn Ihre Organisation auch serverseitig verwaltete Einstellungen verteilt, setzen Sie die Schlüssel an beiden Orten: Verwaltete Einstellungsquellen [werden nicht zusammengeführt](/docs/de/server-managed-settings#settings-precedence), und zwischengespeicherte serverseitig verwaltete Einstellungen ersetzen die geräteverwaltete Datei, mit Ausnahme von einigen [pro-Schlüssel-Ausnahmen](/docs/de/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` und die `"claudeai"`- und `"console"`-Werte von `forceLoginMethod` sind nicht unter diesen Ausnahmen, daher behalten Sie sie an beiden Orten.

174 184

185In einer [Gateway](/docs/de/claude-apps-gateway)-Bereitstellung behalten Sie auch `forceLoginMethod` und `forceLoginOrgUUID` aus den [Einstellungen, die das Gateway bereitstellt](/docs/de/claude-apps-gateway-config#managed).

186

175Die Schlüssel entscheiden auch, ob eine Sitzung, die keine Anmeldedaten verwendet, gestartet werden kann. Siehe [`forceLoginOrgUUID`](/docs/de/settings-reference#forceloginorguuid) in der Einstellungsreferenz für das vollständige Verhalten.187Die Schlüssel entscheiden auch, ob eine Sitzung, die keine Anmeldedaten verwendet, gestartet werden kann. Siehe [`forceLoginOrgUUID`](/docs/de/settings-reference#forceloginorguuid) in der Einstellungsreferenz für das vollständige Verhalten.

176 188

177* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`**: Beim Start blockiert, da die Organisationszugehörigkeit für eine Umgebungsanmeldedaten nicht überprüft werden kann189* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`**: Beim Start blockiert. Unter `forceLoginOrgUUID` kann die Organisationszugehörigkeit für eine Umgebungsanmeldedaten nicht überprüft werden, und unter `forceLoginMethod` würde die Anmeldedaten an Stelle der erforderlichen Anmeldung stehen. Wenn die verwalteten Einstellungen auch die [Gateway](/docs/de/claude-apps-gateway)-Anmeldung erfordern, blockiert Claude Code einen API-Schlüssel, der von einer früheren Claude Console-Anmeldung gespeichert wurde, auf die gleiche Weise. Siehe [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in)

178* **Cloud-Anbieter-Sitzungen wie Amazon Bedrock**: Nicht blockiert, da sie sich gegen Ihren Cloud-Anbieter authentifizieren. Beschränken Sie diese durch Ihre Cloud-IAM-Richtlinien190* **Cloud-Anbieter-Sitzungen wie Amazon Bedrock**: Blockiert nur, während eine `ANTHROPIC_API_KEY`-, `ANTHROPIC_AUTH_TOKEN`- oder `apiKeyHelper`-Anmeldedaten oder ein API-Schlüssel, der von einer früheren Claude Console-Anmeldung gespeichert wurde, noch auf dem Computer vorhanden ist. Entfernen Sie ihn und die Sitzung startet. Diese Sitzungen authentifizieren sich gegen Ihren Cloud-Anbieter, dessen Zugriffrichtlinien sie regeln

179* **[Anthropic-Profil oder Verbundanmeldedaten](#anthropic-profiles-and-federation-credentials)**: Nicht blockiert, und die Schlüssel überprüfen nicht, zu welcher Organisation das Profil gehört191* **[Anthropic-Profil oder Verbundanmeldedaten](#anthropic-profiles-and-federation-credentials)**: Nicht blockiert, es sei denn, eine `ANTHROPIC_API_KEY`-, `ANTHROPIC_AUTH_TOKEN`- oder `apiKeyHelper`-Anmeldedaten oder ein API-Schlüssel, der von einer früheren Claude Console-Anmeldung gespeichert wurde, ist auch auf dem Computer vorhanden. Die Schlüssel überprüfen nicht, zu welcher Organisation das Profil gehört

180 192

181<h2 id="credential-management">193<h2 id="credential-management">

182 Verwaltung von Anmeldedaten194 Verwaltung von Anmeldedaten

192 * Claude Code verwaltet `.credentials.json` über `/login` und `/logout`. Um Anfragen über einen benutzerdefinierten API-Endpunkt zu leiten, legen Sie stattdessen die Umgebungsvariable [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) fest.204 * Claude Code verwaltet `.credentials.json` über `/login` und `/logout`. Um Anfragen über einen benutzerdefinierten API-Endpunkt zu leiten, legen Sie stattdessen die Umgebungsvariable [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) fest.

193* **Unterstützte Authentifizierungstypen**: Claude.ai-Anmeldedaten, Claude API-Anmeldedaten, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, Anthropic-Profil und [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) Anmeldedaten sowie [Claude Apps Gateway](/docs/de/claude-apps-gateway) Sitzungs-Tokens.205* **Unterstützte Authentifizierungstypen**: Claude.ai-Anmeldedaten, Claude API-Anmeldedaten, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, Anthropic-Profil und [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) Anmeldedaten sowie [Claude Apps Gateway](/docs/de/claude-apps-gateway) Sitzungs-Tokens.

194* **Benutzerdefinierte Anmeldedaten-Skripte**: Konfigurieren Sie die Einstellung [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper), um ein Shell-Skript auszuführen, das einen API-Schlüssel zurückgibt.206* **Benutzerdefinierte Anmeldedaten-Skripte**: Konfigurieren Sie die Einstellung [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper), um ein Shell-Skript auszuführen, das einen API-Schlüssel zurückgibt.

195* **Aktualisierungsintervalle**: Claude Code führt `apiKeyHelper` standardmäßig nach fünf Minuten erneut aus. Legen Sie die Umgebungsvariable `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` für benutzerdefinierte Aktualisierungsintervalle fest. Siehe [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper) für die anderen Fälle, in denen Claude Code das Hilfsprogramm erneut ausführt.207* **Aktualisierungsintervalle**: siehe [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper) für die Fälle, in denen Claude Code das Hilfsprogramm erneut ausführt.

196* **Warnung bei langsamen Hilfsprogrammen**: Wenn `apiKeyHelper` länger als 10 Sekunden benötigt, um einen Schlüssel zurückzugeben, zeigt Claude Code eine Warnmitteilung in der Eingabeaufforderungsleiste an, die die verstrichene Zeit anzeigt. Wenn Sie diese Mitteilung regelmäßig sehen, überprüfen Sie, ob Ihr Anmeldedaten-Skript optimiert werden kann.208* **Warnung bei langsamen Hilfsprogrammen**: Wenn `apiKeyHelper` länger als 10 Sekunden benötigt, um einen Schlüssel zurückzugeben, zeigt Claude Code eine Warnmitteilung in der Eingabeaufforderungsleiste an, die die verstrichene Zeit anzeigt. Wenn Sie diese Mitteilung regelmäßig sehen, überprüfen Sie, ob Ihr Anmeldedaten-Skript optimiert werden kann.

197* **Fehler bei Hilfsprogrammen**: Wenn das Skript mit einem Fehler beendet wird, das Zeitlimit überschreitet oder nichts ausgibt, schlagen Anfragen mit [`Your apiKeyHelper script is failing`](/docs/de/errors#your-apikeyhelper-script-is-failing) innerhalb von drei Versuchen fehl. Vor v2.1.208 wurden Fehler bei Hilfsprogrammen nach etwa zehn stillen Wiederholungen als generischer 401-Fehler angezeigt.209* **Fehler bei Hilfsprogrammen**: Wenn das Skript mit einem Fehler beendet wird, das Zeitlimit überschreitet oder nichts ausgibt, schlagen Anfragen mit [`Your apiKeyHelper script is failing`](/docs/de/errors#your-apikeyhelper-script-is-failing) innerhalb von drei Versuchen fehl.

198 210

199`apiKeyHelper`, `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` gelten für die CLI und die Oberflächen, die sie umhüllen, einschließlich der VS Code-Erweiterung, des Agent SDK und GitHub Actions. Claude Desktop und Cloud-Sitzungen rufen `apiKeyHelper` nicht auf oder lesen diese Umgebungsvariablen nicht: Sie verwenden OAuth, außer Desktop-Sitzungen, die eine [Inferenzkonfiguration eines Drittanbieters](/docs/de/llm-gateway-connect#desktop-app) ausführen, die sich mit den Anmeldedaten dieser Konfiguration authentifizieren.211`apiKeyHelper`, `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` gelten für die CLI und die Oberflächen, die sie umhüllen, einschließlich der VS Code-Erweiterung, des Agent SDK und GitHub Actions. Claude Desktop und Cloud-Sitzungen rufen `apiKeyHelper` nicht auf oder lesen diese Umgebungsvariablen nicht: Sie verwenden OAuth, außer Desktop-Sitzungen, die eine [Inferenzkonfiguration eines Drittanbieters](/docs/de/llm-gateway-connect#desktop-app) ausführen, die sich mit den Anmeldedaten dieser Konfiguration authentifizieren.

200 212

202 Ablauf einer Anmeldung erneuern214 Ablauf einer Anmeldung erneuern

203</h3>215</h3>

204 216

205Wenn die Anmeldung, die Sie mit `/login` erstellt haben, innerhalb von drei Tagen abläuft, zeigt Claude Code beim Start eine Warnung an: `Your login expires in 3 days · run /login to renew`. Erfordert Claude Code v2.1.203 oder später. Vor v2.1.217 erschien die Warnung fünf Tage vorher.217Wenn die Anmeldung, die Sie mit `/login` erstellt haben, innerhalb von drei Tagen abläuft, zeigt Claude Code beim Start eine Warnung an: `Your login expires in 3 days · run /login to renew`.

206 218

207Führen Sie `/login` aus, um zu erneuern. Die Warnung ist informativ und blockiert niemals eine Anfrage: Die Authentifizierung funktioniert weiterhin, bis die Anmeldung tatsächlich abläuft. Die Anmeldelebensdauer selbst bleibt unverändert; die Vorauswarnung ist das, was v2.1.203 hinzufügt.219Führen Sie `/login` aus, um zu erneuern. Die Warnung ist informativ und blockiert niemals eine Anfrage: Die Authentifizierung funktioniert weiterhin, bis die Anmeldung tatsächlich abläuft.

208 220

209Sobald die gespeicherte Anmeldung abläuft und nicht aktualisiert werden kann, schlägt jede Modellanfrage mit [`Login expired · Please run /login`](/docs/de/errors#login-expired) fehl, bis Sie sich erneut anmelden. Vor v2.1.206 wurde eine abgelaufene Anmeldung stattdessen als Modellfehler angezeigt.221Sobald die gespeicherte Anmeldung abläuft und nicht aktualisiert werden kann, schlägt jede Modellanfrage mit [`Login expired · Please run /login`](/docs/de/errors#login-expired) fehl, bis Sie sich erneut anmelden.

210 222

211Sie können diesen Zustand vor einem Anfragefehler überprüfen: [`/status`](/docs/de/commands) zeigt eine Zeile `Login` an, die `Expired — log in again` liest, plus die Organisation und E-Mail, die es für die abgelaufene Anmeldung gespeichert hat. Die Zeile wird nur angezeigt, wenn die gespeicherte claude.ai- oder Claude Console-Anmeldung die aktive Anmeldedaten ist. Die Zeile erfordert Claude Code v2.1.210 oder später.223Sie können diesen Zustand vor einem Anfragefehler überprüfen: [`/status`](/docs/de/commands) zeigt eine Zeile `Login` an, die `Expired — log in again` liest, plus die Organisation und E-Mail, die es für die abgelaufene Anmeldung gespeichert hat. Die Zeile wird nur angezeigt, wenn die gespeicherte claude.ai-Anmeldung die aktive Anmeldedaten ist. Die Zeile erfordert Claude Code v2.1.210 oder später.

212 224

213Die Warnung wird nur angezeigt, wenn eine claude.ai- oder Claude Console-Anmeldung die aktive Anmeldedaten ist, und nicht, wenn ein Cloud-Anbieter, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` die Anmeldedaten bereitstellt.225Die Warnung wird nur angezeigt, wenn eine claude.ai-Anmeldung die aktive Anmeldedaten ist, und nicht, wenn ein Cloud-Anbieter, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` die Anmeldedaten bereitstellt.

214 226

215Eine frühzeitige Erneuerung ist am wichtigsten für Sitzungen, die unbeaufsichtigt ausgeführt werden. Eine [Hintergrundsitzung in der Agent-Ansicht](/docs/de/agent-view) oder eine [Remote Control](/docs/de/remote-control) Sitzung, die länger als die Anmeldung läuft, stoppt den Fortschritt, sobald die Anmeldedaten ablaufen, und kann sich nicht erholen, bis Sie sich erneut anmelden.227Eine frühzeitige Erneuerung ist am wichtigsten für Sitzungen, die unbeaufsichtigt ausgeführt werden. Eine [Hintergrundsitzung in der Agent-Ansicht](/docs/de/agent-view) oder eine [Remote Control](/docs/de/remote-control) Sitzung, die länger als die Anmeldung läuft, stoppt den Fortschritt, sobald die Anmeldedaten ablaufen, und kann sich nicht erholen, bis Sie sich erneut anmelden.

216 228

230 242

231Eine angemeldete [Claude Apps Gateway](/docs/de/claude-apps-gateway) Sitzung steht außerhalb dieser Liste: Sie ist eine Anbieterauswahl wie Amazon Bedrock oder Google Cloud's Agent Platform und hat Vorrang vor ihnen. Wenn eine Gateway-Sitzung vorhanden ist, authentifiziert sich die CLI mit dem Gateway-Token, auch wenn `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` oder `CLAUDE_CODE_USE_FOUNDRY` gesetzt ist, und Anmeldequellen oben wie der Bearer-Token, API-Schlüssel, `apiKeyHelper` und Profile werden nicht verwendet.243Eine angemeldete [Claude Apps Gateway](/docs/de/claude-apps-gateway) Sitzung steht außerhalb dieser Liste: Sie ist eine Anbieterauswahl wie Amazon Bedrock oder Google Cloud's Agent Platform und hat Vorrang vor ihnen. Wenn eine Gateway-Sitzung vorhanden ist, authentifiziert sich die CLI mit dem Gateway-Token, auch wenn `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` oder `CLAUDE_CODE_USE_FOUNDRY` gesetzt ist, und Anmeldequellen oben wie der Bearer-Token, API-Schlüssel, `apiKeyHelper` und Profile werden nicht verwendet.

232 244

233Wenn die [verwalteten Einstellungen](/docs/de/managed-settings) Ihres Computers [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) auf `"gateway"` setzen oder [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl) setzen, und Sie keinen Cloud-Anbieter durch eine Variable wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX` auswählen, verwendet Ihre Sitzung nur die Gateway-Anmeldung. Claude Code überspringt die anderen Anmeldequellen und fordert Sie auf, sich mit `/login` anzumelden. Siehe [Administrator policy requires a Cloud gateway sign-in](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) für das, was Sie mit jeder verbleibenden Anmeldedaten sehen. Vor v2.1.261 oder vor v2.1.265 auf einem Computer, der nur `forceLoginGatewayUrl` setzt, verwendete Claude Code eine verbleibende gespeicherte Anmeldung auf diesen Computern, bis Sie sich beim Gateway anmeldeten.245Wenn die [verwalteten Einstellungen](/docs/de/managed-settings) Ihres Computers [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) auf `"gateway"` setzen oder [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl) setzen, und Sie keinen Cloud-Anbieter durch eine Variable wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX` auswählen, verwendet Ihre Sitzung nur die Gateway-Anmeldung. Claude Code überspringt die anderen Anmeldequellen und fordert Sie auf, sich mit `/login` anzumelden. Siehe [Administrator policy requires a Cloud gateway sign-in](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) für das, was Sie mit jeder verbleibenden Anmeldedaten sehen. Erfordert Claude Code v2.1.261 oder später, oder v2.1.265 oder später auf einem Computer, der nur `forceLoginGatewayUrl` setzt.

234 246

235Wenn Sie ein aktives Claude-Abonnement haben, aber auch `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt haben, verwendet Claude Code den API-Schlüssel, sobald Sie ihn genehmigen. Dies kann zu Authentifizierungsfehlern führen, wenn der Schlüssel zu einer deaktivierten oder abgelaufenen Organisation gehört.247Wenn Sie ein aktives Claude-Abonnement haben, aber auch `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt haben, verwendet Claude Code den API-Schlüssel, sobald Sie ihn genehmigen. Dies kann zu Authentifizierungsfehlern führen, wenn der Schlüssel zu einer deaktivierten oder abgelaufenen Organisation gehört.

236 248

255| Aktives Profil | Die [`active_config` Datei](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) in Ihrem Konfigurationsverzeichnis oder ein Profil namens `default` | Oben, wenn sein Authentifizierungsmodus `oidc_federation` ist; unten einer funktionierenden `/login` Anmeldedaten, wenn sein Authentifizierungsmodus `user_oauth` ist |267| Aktives Profil | Die [`active_config` Datei](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) in Ihrem Konfigurationsverzeichnis oder ein Profil namens `default` | Oben, wenn sein Authentifizierungsmodus `oidc_federation` ist; unten einer funktionierenden `/login` Anmeldedaten, wenn sein Authentifizierungsmodus `user_oauth` ist |

256 268

257Die `user_oauth` Regel verhindert, dass ein verwaistes `ant auth login` Profil Ihre Anfragen vom Konto weg verschiebt, bei dem Sie sich mit `/login` angemeldet haben. Für die Verbundsvariablen liest Claude Code auch die anderen Variablen in der [WIF-Referenz](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), wie `ANTHROPIC_IDENTITY_TOKEN_FILE`, wenn es Ihr Identitäts-Token austauscht. Für das Profildateiformat siehe die [WIF-Referenz](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).269Für die Verbundsvariablen liest Claude Code auch die anderen Variablen in der [WIF-Referenz](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), wie `ANTHROPIC_IDENTITY_TOKEN_FILE`, wenn es Ihr Identitäts-Token austauscht. Für das Profildateiformat siehe die [WIF-Referenz](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

258 270

259Um zu bestätigen, welche Quelle Claude Code gewählt hat, führen Sie `/status` aus. Eine `Profile` Zeile benennt die Quelle anstelle der `Login method` Zeile. Wenn die Anmeldedaten die verwendete Anmeldedaten sind, zeigen die Zeilen `Organization` und `Email` ihr Konto an.271Um zu bestätigen, welche Quelle Claude Code gewählt hat, führen Sie `/status` aus. Eine `Profile` Zeile benennt die Quelle anstelle der `Login method` Zeile. Wenn die Anmeldedaten die verwendete Anmeldedaten sind, zeigen die Zeilen `Organization` und `Email` ihr Konto an.

260 272

261Wenn Sie Claude Code mit `--debug` starten, schreibt es auch eine `Using Anthropic profile auth` Zeile mit dem Quellnamen in das Debug-Protokoll unter `~/.claude/debug/<session-id>.txt`. Wenn Claude Code ein `user_oauth` aktives Profil überspringt, weil Sie eine funktionierend `/login` Anmeldedaten haben, schreibt es eine Warnung in das Debug-Protokoll, dass es stattdessen die claude.ai-Anmeldung verwendet.

~~262~~

263Wenn die Anmeldung eines `user_oauth` Profils abgelaufen ist und Claude Code sie nicht erneuern kann, schlagen Anfragen mit [Anthropic profile login expired](/docs/de/errors#anthropic-profile-login-expired) fehl.273Wenn die Anmeldung eines `user_oauth` Profils abgelaufen ist und Claude Code sie nicht erneuern kann, schlagen Anfragen mit [Anthropic profile login expired](/docs/de/errors#anthropic-profile-login-expired) fehl.

264 274

265Funktionen, die Ihre claude.ai-Anmeldung benötigen, wie [claude.ai Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) und [`/schedule`](/docs/de/routines), sind nicht verfügbar, während eine dieser Quellen ausgewählt ist. Um Claude Code davon abzuhalten, eine Quelle auszuwählen:275Funktionen, die Ihre claude.ai-Anmeldung benötigen, wie [claude.ai Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) und [`/schedule`](/docs/de/routines), sind nicht verfügbar, während eine dieser Quellen ausgewählt ist. Um Claude Code davon abzuhalten, eine Quelle auszuwählen:

279 289

280Der Befehl öffnet den gleichen Browser-Autorisierungsfluss wie `/login`, und das Token wird im Terminal ausgegeben, nachdem Sie den Zugriff im Browser genehmigt haben. Es speichert das Token nirgendwo; kopieren Sie es und legen Sie es als `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable überall dort fest, wo Sie sich authentifizieren möchten:290Der Befehl öffnet den gleichen Browser-Autorisierungsfluss wie `/login`, und das Token wird im Terminal ausgegeben, nachdem Sie den Zugriff im Browser genehmigt haben. Es speichert das Token nirgendwo; kopieren Sie es und legen Sie es als `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable überall dort fest, wo Sie sich authentifizieren möchten:

281 291

282```bash theme={null}292<Tabs>

283export CLAUDE_CODE_OAUTH_TOKEN=your-token293 <Tab title="macOS, Linux, WSL">

284```294 ```bash theme={null}

295 export CLAUDE_CODE_OAUTH_TOKEN=your-token

296 ```

297 </Tab>

298

299 <Tab title="Windows PowerShell">

300 ```powershell theme={null}

301 $env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

302 ```

303 </Tab>

304

305 <Tab title="Windows CMD">

306 ```batch theme={null}

307 set CLAUDE_CODE_OAUTH_TOKEN=your-token

308 ```

309 </Tab>

310</Tabs>

285 311

286Dieses Token authentifiziert sich mit Ihrem Claude-Abonnement und erfordert einen Pro-, Max-, Team- oder Enterprise-Plan. Es kann nur Modellanfragen stellen, daher kann es keine [Remote Control](/docs/de/remote-control) Sitzungen einrichten oder [claude.ai Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) abrufen. MCP-Server, die Sie lokal konfigurieren, funktionieren weiterhin.312Dieses Token authentifiziert sich mit Ihrem Claude-Abonnement und erfordert einen Pro-, Max-, Team- oder Enterprise-Plan. Es kann nur Modellanfragen stellen, daher kann es keine [Remote Control](/docs/de/remote-control) Sitzungen einrichten oder [claude.ai Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) abrufen. MCP-Server, die Sie lokal konfigurieren, funktionieren weiterhin.

287 313

auto-mode-config.md +22 −38

Details

9[Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) ermöglicht es Claude Code, ohne routinemäßige Berechtigungsaufforderungen zu laufen, indem Werkzeugaufrufe durch einen Klassifizierer geleitet werden, der alles blockiert, das irreversibel, destruktiv oder außerhalb Ihrer Umgebung ausgerichtet ist. Deny- und explizite Ask-Regeln werden vor dem Klassifizierer ausgewertet und blockieren oder fordern weiterhin auf. Verwenden Sie den `autoMode`-Einstellungsblock, um diesem Klassifizierer mitzuteilen, welche Repos, Buckets und Domains Ihre Organisation vertraut, damit er routinemäßige interne Operationen nicht mehr blockiert.9[Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) ermöglicht es Claude Code, ohne routinemäßige Berechtigungsaufforderungen zu laufen, indem Werkzeugaufrufe durch einen Klassifizierer geleitet werden, der alles blockiert, das irreversibel, destruktiv oder außerhalb Ihrer Umgebung ausgerichtet ist. Deny- und explizite Ask-Regeln werden vor dem Klassifizierer ausgewertet und blockieren oder fordern weiterhin auf. Verwenden Sie den `autoMode`-Einstellungsblock, um diesem Klassifizierer mitzuteilen, welche Repos, Buckets und Domains Ihre Organisation vertraut, damit er routinemäßige interne Operationen nicht mehr blockiert.

10 10

11<Note>11<Note>

12 Auto-Modus ist für alle Benutzer auf jedem Anbieter verfügbar, einschließlich der Anthropic API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeter [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen. Wenn Claude Code Auto-Modus als nicht verfügbar für Ihr Konto meldet, überprüfen Sie die [vollständigen Anforderungen](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), die auch die unterstützten Modelle und die Kontrolle auf Organisationsebene in Team- und Enterprise-Plänen abdecken. In v2.1.158 bis v2.1.206 erforderte Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude apps gateway-Sitzungen das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.12 Diese Seite ist die Konfigurationsreferenz. Das Aktivieren und Deaktivieren des Auto-Modus wird auf der Seite „Berechtigungsmodi" behandelt:

14 * **Wechseln Sie während einer Sitzung zum Auto-Modus oder kehren Sie aus ihm zurück**: siehe [Berechtigungsmodi wechseln](/docs/de/permission-modes#switch-permission-modes)

15 * **Starten Sie eine Sitzung im Auto-Modus**: siehe [In einem anderen Berechtigungsmodus starten](/docs/de/permission-modes#start-in-a-different-mode)

13</Note>16</Note>

14 17

15Standardmäßig vertraut der Klassifizierer nur dem Arbeitsverzeichnis und den konfigurierten Remotes des aktuellen Repos. Aktionen wie das Pushen zu Ihrer Unternehmens-Quellcode-Org oder das Schreiben in einen Team-Cloud-Bucket werden blockiert, bis Sie sie zu `autoMode.environment` hinzufügen.18Auto-Modus ist für alle Benutzer auf jedem Anbieter verfügbar, einschließlich der Anthropic API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeter [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen. Wenn Claude Code Auto-Modus als nicht verfügbar für Ihr Konto meldet, überprüfen Sie die [vollständigen Anforderungen](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), die auch die unterstützten Modelle und die Kontrolle auf Organisationsebene in Team- und Enterprise-Plänen abdecken.

16 19

17Informationen dazu, wie Sitzungen in Auto-Modus landen und was der Klassifizierer standardmäßig blockiert, finden Sie unter [Auto-Modus auf der Seite „Berechtigungsmodi"](/docs/de/permission-modes#eliminate-prompts-with-auto-mode). Diese Seite ist die Konfigurationsreferenz.20Standardmäßig vertraut der Klassifizierer nur dem Arbeitsverzeichnis und den konfigurierten Remotes des aktuellen Repos. Aktionen wie das Pushen zu Ihrer Unternehmens-Quellcode-Org oder das Schreiben in einen Team-Cloud-Bucket werden blockiert, bis Sie sie zu `autoMode.environment` hinzufügen.

18 21

19Diese Seite behandelt, wie Sie:22Diese Seite behandelt, wie Sie:

20 23

21* [Einen menschlichen Checkpoint](#add-a-human-checkpoint) für Pushes und Pull Requests mit `permissions.ask` hinzufügen24* [Einen menschlichen Checkpoint](#add-a-human-checkpoint) für Pushes und Pull Requests mit `permissions.ask` hinzufügen

~~22* [Wählen Sie, wo Sie Regeln festlegen](#where-the-classifier-reads-configuration) über CLAUDE.md, Benutzereinstellungen und verwaltete Einstellungen~~

23* [Definieren Sie vertrauenswürdige Infrastruktur](#define-trusted-infrastructure) mit `autoMode.environment`25* [Definieren Sie vertrauenswürdige Infrastruktur](#define-trusted-infrastructure) mit `autoMode.environment`

24* [Generieren Sie Umgebungseinträge](#generate-environment-entries) mit `/auto-mode-setup`26* [Generieren Sie Umgebungseinträge](#generate-environment-entries) mit `/auto-mode-setup`

~~25* [Überschreiben Sie die Block- und Allow-Regeln](#override-the-block-and-allow-rules), wenn die Standardwerte nicht zu Ihrer Pipeline passen~~

~~26* [Bearbeiten Sie Regeln von `/permissions`](#edit-rules-from-permissions) ohne eine Einstellungsdatei zu öffnen~~

~~27* [Leiten Sie alle Shell-Befehle durch den Klassifizierer](#route-all-shell-commands-through-the-classifier) mit `autoMode.classifyAllShell`~~

~~28* [Überprüfen Sie Ihre effektive Konfiguration](#inspect-the-defaults-and-your-effective-config) mit den `claude auto-mode`-Unterbefehlen~~

29* [Überprüfen Sie Ablehnungen](#review-denials), damit Sie wissen, was Sie als Nächstes hinzufügen müssen27* [Überprüfen Sie Ablehnungen](#review-denials), damit Sie wissen, was Sie als Nächstes hinzufügen müssen

30 28

31<h2 id="common-boundaries">29<h2 id="common-boundaries">

34 32

35Der Auto-Modus ermöglicht standardmäßig Pushes zu jedem Zweig des Repositorys, in dem Sie arbeiten, einschließlich des Standard-Zweigs, und die Erstellung von Pull Requests. Ein Nicht-Standard-Zweig, dessen Name ihn als Deploy- oder Veröffentlichungsziel kennzeichnet, wie `production`, `release` oder `gh-pages`, wird von diesem Standard nicht abgedeckt: Der Klassifizierer beurteilt einen Push dorthin nach seinen eigenen Bedingungen, einschließlich als Production-Deploy. Der Inhalt des Push wird ebenfalls noch überprüft, sodass ein Force Push, ein Geheimnis, das in den Commit eintritt, oder eine Änderung, die Geheimnisse außerhalb des Repositorys senden würde, wenn CI oder eine Deploy-Pipeline es ausführt, blockiert bleibt.33Der Auto-Modus ermöglicht standardmäßig Pushes zu jedem Zweig des Repositorys, in dem Sie arbeiten, einschließlich des Standard-Zweigs, und die Erstellung von Pull Requests. Ein Nicht-Standard-Zweig, dessen Name ihn als Deploy- oder Veröffentlichungsziel kennzeichnet, wie `production`, `release` oder `gh-pages`, wird von diesem Standard nicht abgedeckt: Der Klassifizierer beurteilt einen Push dorthin nach seinen eigenen Bedingungen, einschließlich als Production-Deploy. Der Inhalt des Push wird ebenfalls noch überprüft, sodass ein Force Push, ein Geheimnis, das in den Commit eintritt, oder eine Änderung, die Geheimnisse außerhalb des Repositorys senden würde, wenn CI oder eine Deploy-Pipeline es ausführt, blockiert bleibt.

36 34

~~37<Info>Vor v2.1.211 erlaubte der Klassifizierer Pushes nur zu Ihrem Arbeitszweig, von Claude erstellten Zweigen und regelmäßigen Pushes zum Standard-Zweig.</Info>~~

39Wenn Sie vor jedem Push und Pull Request einen menschlichen Checkpoint wünschen, fügen Sie Berechtigungsregeln hinzu: Die [Rezepte unten](#add-a-human-checkpoint) halten den Auto-Modus für alles andere aktiviert.35Wenn Sie vor jedem Push und Pull Request einen menschlichen Checkpoint wünschen, fügen Sie Berechtigungsregeln hinzu: Die [Rezepte unten](#add-a-human-checkpoint) halten den Auto-Modus für alles andere aktiviert.

40 36

41<h3 id="add-a-human-checkpoint">37<h3 id="add-a-human-checkpoint">

81 77

82Der Klassifizierer liest `autoMode` nicht aus Projekteinstellungen in `.claude/settings.json` oder `.claude/settings.local.json`. Beide Dateien befinden sich im Repository-Verzeichnis, sodass ein eingechecktes Repository oder ein Build-Schritt sonst seine eigenen Allow-Regeln injizieren könnte. Vor v2.1.207 las der Klassifizierer auch `.claude/settings.local.json`; verschiebe alle `autoMode`-Blöcke in dieser Datei zu `~/.claude/settings.json`. Das Ausschließen von `.claude/settings.local.json` schließt auch den Fall, in dem ein Repository die Datei committed oder ein lokales Tool oder Build-Schritt sie schreibt.78Der Klassifizierer liest `autoMode` nicht aus Projekteinstellungen in `.claude/settings.json` oder `.claude/settings.local.json`. Beide Dateien befinden sich im Repository-Verzeichnis, sodass ein eingechecktes Repository oder ein Build-Schritt sonst seine eigenen Allow-Regeln injizieren könnte. Verschiebe alle `autoMode`-Blöcke in `.claude/settings.local.json` zu `~/.claude/settings.json`.

83 79

84Einträge aus jedem Bereich werden kombiniert. Ein Entwickler kann `environment`, `allow`, `soft_deny` und `hard_deny` mit persönlichen Einträgen erweitern, kann aber Einträge, die verwaltete Einstellungen bereitstellen, nicht entfernen. Da Allow-Regeln als Ausnahmen zu Soft-Block-Regeln innerhalb des Klassifizierers fungieren, kann ein von einem Entwickler hinzugefügter `allow`-Eintrag einen organisatorischen `soft_deny`-Eintrag überschreiben: Die Kombination ist additiv, keine harte Richtliniengrenze.80Einträge aus jedem Bereich werden kombiniert. Ein Entwickler kann `environment`, `allow`, `soft_deny` und `hard_deny` mit persönlichen Einträgen erweitern, kann aber Einträge, die verwaltete Einstellungen bereitstellen, nicht entfernen. Da Allow-Regeln als Ausnahmen zu Soft-Block-Regeln innerhalb des Klassifizierers fungieren, kann ein von einem Entwickler hinzugefügter `allow`-Eintrag einen organisatorischen `soft_deny`-Eintrag überschreiben: Die Kombination ist additiv, keine harte Richtliniengrenze.

85 81

93 89

94Für die meisten Organisationen ist `autoMode.environment` das einzige Feld, das Sie festlegen müssen. Es teilt dem Klassifizierer mit, welche Repos, Buckets und Domains vertrauenswürdig sind: Der Klassifizierer nutzt dies, um zu entscheiden, was „extern" bedeutet, sodass jedes Ziel, das nicht aufgelistet ist, ein potenzielles Exfiltrationsziel darstellt.90Für die meisten Organisationen ist `autoMode.environment` das einzige Feld, das Sie festlegen müssen. Es teilt dem Klassifizierer mit, welche Repos, Buckets und Domains vertrauenswürdig sind: Der Klassifizierer nutzt dies, um zu entscheiden, was „extern" bedeutet, sodass jedes Ziel, das nicht aufgelistet ist, ein potenzielles Exfiltrationsziel darstellt.

95 91

~~96Ab Claude Code v2.1.198 gibt `claude auto-mode defaults` drei Arten von Umgebungseinträgen aus. Versionen vor v2.1.195 geben nur die ersten fünf Vertrauensplätze aus.~~92`claude auto-mode defaults` gibt drei Arten von Umgebungseinträgen aus.

97 93

98* **Kontextplätze**: beschreiben Ihre Organisation, Ihren Stack und Ihre Sicherheitslage, damit der Klassifizierer die anderen Regeln in Ihrem Kontext liest. Jeder hat standardmäßig den Wert `None configured` oder die neben ihm genannte konservative Annahme:94* **Kontextplätze**: beschreiben Ihre Organisation, Ihren Stack und Ihre Sicherheitslage, damit der Klassifizierer die anderen Regeln in Ihrem Kontext liest. Jeder hat standardmäßig den Wert `None configured` oder die neben ihm genannte konservative Annahme:

99 * **Organisation**95 * **Organisation**

101 * **Cloud-Anbieter**97 * **Cloud-Anbieter**

102 * **Repository-Sichtbarkeit**: Ein Repository wird als privat angenommen, es sei denn, sein Remote-Host und Name deuten darauf hin, dass es anders ist, oder der Klassifizierer liest eine Sichtbarkeitsprüfung früher im Gespräch, die zeigt, dass es öffentlich ist.98 * **Repository-Sichtbarkeit**: Ein Repository wird als privat angenommen, es sei denn, sein Remote-Host und Name deuten darauf hin, dass es anders ist, oder der Klassifizierer liest eine Sichtbarkeitsprüfung früher im Gespräch, die zeigt, dass es öffentlich ist.

103 99

104 In den Klassifizierer-Anfragen, die Claude Code selbst sendet, liest der Klassifizierer Ihre Nachrichten und die Befehle, die Claude ausführt, nicht deren Ausgabe. Der Beweis muss etwas sein, das der Klassifizierer lesen kann, wie Ihre eigene Nachricht, die das Repository als öffentlich benennt; die Ausgabe eines `gh repo view` allein erreicht ihn nicht. Die Transkript-Beweis-Prüfung erfordert Claude Code v2.1.200 oder später100 In den Klassifizierer-Anfragen, die Claude Code selbst sendet, liest der Klassifizierer Ihre Nachrichten und die Befehle, die Claude ausführt, nicht deren Ausgabe. Der Beweis muss etwas sein, das der Klassifizierer lesen kann, wie Ihre eigene Nachricht, die das Repository als öffentlich benennt; die Ausgabe eines `gh repo view` allein erreicht ihn nicht.

105 * **Interne Freigabe / Snippet-Hosting**: öffentliche Paste- und Gist-Services werden als außerhalb der Vertrauensgrenze behandelt, bis Sie einen benennen101 * **Interne Freigabe / Snippet-Hosting**: öffentliche Paste- und Gist-Services werden als außerhalb der Vertrauensgrenze behandelt, bis Sie einen benennen

106 * **Organisations-spezifische CLIs**102 * **Organisations-spezifische CLIs**

107 * **Secrets-Management**103 * **Secrets-Management**

110 * **Host-Containment**: standardmäßig ein gewöhnlicher Entwickler-Rechner oder CI-Runner mit offenem Internet. Wenn Claude Code in einem Container, einer VM oder einem Pod mit einer Egress-Allow-Liste oder Nachbarn läuft, die es nicht berühren darf, benennen Sie die zulässigen Hosts, ob der Cloud-Metadaten-Endpunkt erreichbar sein sollte, und welches Cloud-Projekt, Cluster oder Registry die Aufgabe nutzt und unter welcher Identität. Bis dieser Eintrag diese Identität benennt, [blockiert](/docs/de/permission-modes#what-the-classifier-blocks-by-default) der Klassifizierer Anfragen für die eigenen Anmeldedaten des Hosts. Erfordert Claude Code v2.1.257 oder später106 * **Host-Containment**: standardmäßig ein gewöhnlicher Entwickler-Rechner oder CI-Runner mit offenem Internet. Wenn Claude Code in einem Container, einer VM oder einem Pod mit einer Egress-Allow-Liste oder Nachbarn läuft, die es nicht berühren darf, benennen Sie die zulässigen Hosts, ob der Cloud-Metadaten-Endpunkt erreichbar sein sollte, und welches Cloud-Projekt, Cluster oder Registry die Aufgabe nutzt und unter welcher Identität. Bis dieser Eintrag diese Identität benennt, [blockiert](/docs/de/permission-modes#what-the-classifier-blocks-by-default) der Klassifizierer Anfragen für die eigenen Anmeldedaten des Hosts. Erfordert Claude Code v2.1.257 oder später

111 * **Geschützte Bereitstellungs-Namespaces / Umgebungen**: fällt auf die Heuristik für sensible Remote-Ziele zurück, bis Sie diese benennen107 * **Geschützte Bereitstellungs-Namespaces / Umgebungen**: fällt auf die Heuristik für sensible Remote-Ziele zurück, bis Sie diese benennen

112 * **Datenspeicherung / Deklassifizierung**108 * **Datenspeicherung / Deklassifizierung**

113* **Vertrauensplätze**: benennen, was der Klassifizierer als innerhalb Ihrer Grenze behandelt. Die Plätze sind Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services und Internal package registry. Die Repo- und Source-Control-Einträge haben standardmäßig das funktionierende Repository und seine konfigurierten Remotes. Jeder andere Vertrauensplatz hat standardmäßig den Wert `None configured`, sodass nichts anderes vertrauenswürdig ist, bis Sie es hinzufügen. Die Sichtbarkeit eines Repositorys bezieht sich nur auf vertrauliches Material: Ein privates Repository ist ein akzeptables Ziel für vertrauliches Material, aber das Privatmachen eines Repositorys ermöglicht niemals das Verschieben von Secrets oder persönlichen oder anvertrauten Daten in dieses Repository, und der Klassifizierer behandelt Inhalte, die von außerhalb des funktionierenden Repositorys portiert, umgeleitet oder erstmals gelesen werden, als nicht das eigene Werk dieses Repositorys. Diese Scoping-Anforderung erfordert Claude Code v2.1.203 oder später.109* **Vertrauensplätze**: benennen, was der Klassifizierer als innerhalb Ihrer Grenze behandelt. Die Plätze sind Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services und Internal package registry. Die Repo- und Source-Control-Einträge haben standardmäßig das funktionierende Repository und seine konfigurierten Remotes. Jeder andere Vertrauensplatz hat standardmäßig den Wert `None configured`, sodass nichts anderes vertrauenswürdig ist, bis Sie es hinzufügen. Die Sichtbarkeit eines Repositorys bezieht sich nur auf vertrauliches Material: Ein privates Repository ist ein akzeptables Ziel für vertrauliches Material, aber das Privatmachen eines Repositorys ermöglicht niemals das Verschieben von Secrets oder persönlichen oder anvertrauten Daten in dieses Repository, und der Klassifizierer behandelt Inhalte, die von außerhalb des funktionierenden Repositorys portiert, umgeleitet oder erstmals gelesen werden, als nicht das eigene Werk dieses Repositorys.

114* **Sensibilitätsplätze**: benennen, was die Schutzregeln als hochriskant behandeln. Die Plätze sind Sensitive data locations & audiences, Sensitive remote targets und Protected IaC scopes. Jeder hat standardmäßig eine breite Heuristik, wie das Behandeln eines beliebigen Hosts oder Namespace, dessen Name `prod` oder `production` trägt, als sensibles Remote-Ziel, sodass die Schutzregeln aktiv sind, bevor Sie etwas konfigurieren. Das Benennen konkreter Ziele in einem Sensibilitätsplatz lässt diese Regeln stattdessen auf die benannten Ziele angewendet werden.110* **Sensibilitätsplätze**: benennen, was die Schutzregeln als hochriskant behandeln. Die Plätze sind Sensitive data locations & audiences, Sensitive remote targets und Protected IaC scopes. Jeder hat standardmäßig eine breite Heuristik, wie das Behandeln eines beliebigen Hosts oder Namespace, dessen Name `prod` oder `production` trägt, als sensibles Remote-Ziel, sodass die Schutzregeln aktiv sind, bevor Sie etwas konfigurieren. Das Benennen konkreter Ziele in einem Sensibilitätsplatz lässt diese Regeln stattdessen auf die benannten Ziele angewendet werden.

115 111

116<Info>Vor v2.1.211 enthielten die Kontextplätze auch einen Eintrag für Standard / geschützte Branches, der `main` und `master` als geschützt behandelte, bis Sie andere benannten. v2.1.211 entfernte ihn: [Pushes zu jedem Branch des Repositorys, an dem Sie arbeiten](#common-boundaries) sind standardmäßig zulässig, sodass es keinen geschützten-Branch-Standard zu konfigurieren gibt.</Info>

~~117~~

118Um Ihre eigenen Einträge neben den Standardwerten hinzuzufügen, fügen Sie die wörtliche Zeichenkette `"$defaults"` in das Array ein. Die Standardeinträge werden an dieser Position eingefügt, sodass Ihre benutzerdefinierten Einträge vor oder nach ihnen stehen können.112Um Ihre eigenen Einträge neben den Standardwerten hinzuzufügen, fügen Sie die wörtliche Zeichenkette `"$defaults"` in das Array ein. Die Standardeinträge werden an dieser Position eingefügt, sodass Ihre benutzerdefinierten Einträge vor oder nach ihnen stehen können.

119 113

120Das folgende Beispiel behält die Standardeinträge bei und fügt die Repos, Buckets, Domains und Services einer Organisation hinzu.114Das folgende Beispiel behält die Standardeinträge bei und fügt die Repos, Buckets, Domains und Services einer Organisation hinzu.

143* **Vertrauenswürdige interne Domains**: Hostnamen für APIs, Dashboards und Services in Ihrem Netzwerk, wie `*.internal.example.com`137* **Vertrauenswürdige interne Domains**: Hostnamen für APIs, Dashboards und Services in Ihrem Netzwerk, wie `*.internal.example.com`

144* **Wichtige interne Services**: CI, Artifact-Registries, interne Paketindizes, Incident-Tools138* **Wichtige interne Services**: CI, Artifact-Registries, interne Paketindizes, Incident-Tools

145* **Interne Paket-Registry**: die private npm-, PyPI- oder andere Registry, durch die Installationen laufen sollten, sodass Installationen, die sie für eine öffentliche Registry umgehen, blockiert werden139* **Interne Paket-Registry**: die private npm-, PyPI- oder andere Registry, durch die Installationen laufen sollten, sodass Installationen, die sie für eine öffentliche Registry umgehen, blockiert werden

146* **Sensible Datenspeicherorte & Zielgruppen**: die Buckets, Datenbanken oder Pfade, die persönliche Daten, vertrauliche Geschäftsdaten, Anmeldedaten, regulierte Daten oder ähnlich sensibles Material enthalten, und die Zielgruppen, mit denen Daten an jedem Speicherort geteilt werden dürfen, sodass der Klassifizierer diese Speicherorte schützt, anstatt vom Inhalt zu raten. Claude Code v2.1.195 bis v2.1.197 nennt diesen Eintrag PII / regulated-data locations und deckt nur Speicherorte ab, die persönliche oder regulierte Daten enthalten, ohne die Zielgruppen-Dimension140* **Sensible Datenspeicherorte & Zielgruppen**: die Buckets, Datenbanken oder Pfade, die persönliche Daten, vertrauliche Geschäftsdaten, Anmeldedaten, regulierte Daten oder ähnlich sensibles Material enthalten, und die Zielgruppen, mit denen Daten an jedem Speicherort geteilt werden dürfen, sodass der Klassifizierer diese Speicherorte schützt, anstatt vom Inhalt zu raten.

147* **Sensible Remote-Ziele**: die Namespaces, Hosts oder Container, die als Produktion zählen, sodass Remote-Shells und Port-Forwards in diese Ihre explizite Genehmigung benötigen141* **Sensible Remote-Ziele**: die Namespaces, Hosts oder Container, die als Produktion zählen, sodass Remote-Shells und Port-Forwards in diese Ihre explizite Genehmigung benötigen

148* **Geschützte IaC-Bereiche**: die Infrastruktur-Ressourcen, deren Apply oder Destroy immer erfordern sollte, dass Sie die Änderung benennen142* **Geschützte IaC-Bereiche**: die Infrastruktur-Ressourcen, deren Apply oder Destroy immer erfordern sollte, dass Sie die Änderung benennen

149* **Zusätzlicher Kontext**: Constraints für regulierte Industrien, Multi-Tenant-Infrastruktur oder Compliance-Anforderungen, die beeinflussen, was der Klassifizierer als riskant behandeln sollte143* **Zusätzlicher Kontext**: Constraints für regulierte Industrien, Multi-Tenant-Infrastruktur oder Compliance-Anforderungen, die beeinflussen, was der Klassifizierer als riskant behandeln sollte

150 144

151Die Einträge Internal package registry, Sensitive data locations & audiences, Sensitive remote targets und Protected IaC scopes erfordern Claude Code v2.1.195 oder später. Frühere Versionen lesen sie immer noch als einfachen Kontext, haben aber nicht die integrierten Regeln, die auf sie abzielen.

~~152~~

153Eine nützliche Startvorlage: Füllen Sie die eingeklammerten Felder aus und entfernen Sie alle Zeilen, die nicht zutreffen.145Eine nützliche Startvorlage: Füllen Sie die eingeklammerten Felder aus und entfernen Sie alle Zeilen, die nicht zutreffen.

154 146

155```json theme={null}147```json theme={null}

169}161}

170```162```

171 163

172Je spezifischer der Kontext ist, den Sie geben, desto besser kann der Klassifizierer Routine-Internaloperationen von Exfiltrationversuchen unterscheiden.

~~173~~

174Sie müssen nicht alles auf einmal ausfüllen. Ein angemessener Rollout: Beginnen Sie mit den Standardwerten und fügen Sie Ihre Source-Control-Organisation und wichtige interne Services hinzu, was die häufigsten falschen Positive wie das Pushen in Ihre eigenen Repos behebt. Fügen Sie als nächstes vertrauenswürdige Domains und Cloud-Buckets hinzu. Füllen Sie den Rest aus, wenn Blockierungen auftreten.164Sie müssen nicht alles auf einmal ausfüllen. Ein angemessener Rollout: Beginnen Sie mit den Standardwerten und fügen Sie Ihre Source-Control-Organisation und wichtige interne Services hinzu, was die häufigsten falschen Positive wie das Pushen in Ihre eigenen Repos behebt. Fügen Sie als nächstes vertrauenswürdige Domains und Cloud-Buckets hinzu. Füllen Sie den Rest aus, wenn Blockierungen auftreten.

175 165

176<h2 id="generate-environment-entries">166<h2 id="generate-environment-entries">

309 299

310Standardmäßig ermöglichen enge Bash- und PowerShell-Regeln wie `Bash(npm test)`, dass sie im Auto-Modus wirksam bleiben, und Claude Code löst sie auf, bevor der Klassifizierer ausgeführt wird, es sei denn, der Befehl trägt [pro-Befehl zulässige Domänen](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode). Claude Code setzt nur die breiten Regeln aus, die beliebige Code-Ausführung ermöglichen, wie `Bash(*)` oder Wildcards-Interpreter, zusammen mit jeder Regel, die [`Monitor`](/docs/de/tools-reference#monitor-tool) benennt, da Monitor-Befehle durch die Shell laufen. Dies bedeutet, dass eine enge Regel immer noch ein destruktives Argument durchlassen kann, ohne dass der Klassifizierer es sieht, beispielsweise einen Skriptpfad oder ein Flag, das das Präfix der Regel nicht vorgesehen hat.300Standardmäßig ermöglichen enge Bash- und PowerShell-Regeln wie `Bash(npm test)`, dass sie im Auto-Modus wirksam bleiben, und Claude Code löst sie auf, bevor der Klassifizierer ausgeführt wird, es sei denn, der Befehl trägt [pro-Befehl zulässige Domänen](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode). Claude Code setzt nur die breiten Regeln aus, die beliebige Code-Ausführung ermöglichen, wie `Bash(*)` oder Wildcards-Interpreter, zusammen mit jeder Regel, die [`Monitor`](/docs/de/tools-reference#monitor-tool) benennt, da Monitor-Befehle durch die Shell laufen. Dies bedeutet, dass eine enge Regel immer noch ein destruktives Argument durchlassen kann, ohne dass der Klassifizierer es sieht, beispielsweise einen Skriptpfad oder ein Flag, das das Präfix der Regel nicht vorgesehen hat.

311 301

312Setzen Sie `autoMode.classifyAllShell` auf `true`, um jede Bash- und PowerShell-Erlaubnisregel auszusetzen, während der Auto-Modus aktiv ist, damit der Klassifizierer jeden Shell-Befehl unabhängig von Ihrer Erlaubnisliste evaluiert.302Setzen Sie `autoMode.classifyAllShell` auf `true`, um jede Bash- und PowerShell-Erlaubnisregel auszusetzen, während der Auto-Modus aktiv ist, damit der Klassifizierer jeden Shell-Befehl unabhängig von Ihrer Erlaubnisliste evaluiert, außer [kritische-Pfad-Entfernungen](/docs/de/permission-modes#critical-paths).

313 303

314```json theme={null}304```json theme={null}

315{305{

323 313

324Die Einstellung gilt nur, während der Auto-Modus aktiv ist, und Ihre Erlaubnisregeln verhalten sich in anderen Berechtigungsmodi normal.314Die Einstellung gilt nur, während der Auto-Modus aktiv ist, und Ihre Erlaubnisregeln verhalten sich in anderen Berechtigungsmodi normal.

325 315

326<Note>

327 `autoMode.classifyAllShell` erfordert Claude Code v2.1.193 oder später. Frühere Versionen ignorieren den Schlüssel und setzen weiterhin enge Shell-Erlaubnisregeln in den Auto-Modus um.

328</Note>

~~329~~

330<h2 id="inspect-the-defaults-and-your-effective-config">316<h2 id="inspect-the-defaults-and-your-effective-config">

331 Überprüfen Sie die Standardwerte und Ihre effektive Konfiguration317 Überprüfen Sie die Standardwerte und Ihre effektive Konfiguration

332</h2>318</h2>

375claude auto-mode critique361claude auto-mode critique

376```362```

377 363

378Führen Sie `claude auto-mode config` nach dem Speichern Ihrer Einstellungen aus, um zu bestätigen, dass die effektiven Regeln Ihren Erwartungen entsprechen, wobei `"$defaults"` an Ort und Stelle erweitert wird. Wenn Sie benutzerdefinierte Regeln geschrieben haben, überprüft `claude auto-mode critique` diese und kennzeichnet Einträge, die mehrdeutig, redundant oder wahrscheinlich zu falsch positiven Ergebnissen führen.364Wenn Sie benutzerdefinierte Regeln geschrieben haben, überprüft `claude auto-mode critique` diese und kennzeichnet Einträge, die mehrdeutig, redundant oder wahrscheinlich zu falsch positiven Ergebnissen führen.

379 365

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

381 367

389 Ablehnungen überprüfen375 Ablehnungen überprüfen

390</h2>376</h2>

391 377

392Um Aktionen zu überprüfen und erneut zu versuchen, die der Auto-Modus-Klassifizierer abgelehnt hat, öffnen Sie `/permissions` und wählen Sie die Registerkarte **Kürzlich abgelehnt**, in der Claude Code jede Ablehnung aufzeichnet. Drücken Sie `r` auf einer abgelehnten Aktion, um sie zum Wiederholen zu markieren: Wenn Sie den Dialog beenden, sendet Claude Code eine Nachricht, die dem Modell mitteilt, dass es diesen Tool-Aufruf wiederholen darf, und setzt das Gespräch fort.378Um Aktionen zu überprüfen und erneut zu versuchen, die der Auto-Modus-Klassifizierer abgelehnt hat, öffnen Sie `/permissions` und wählen Sie die Registerkarte **Recently denied** (Kürzlich abgelehnt), wo Claude Code jede Ablehnung aufzeichnet. Drücken Sie `r` auf einer abgelehnten Aktion, um sie zum Wiederholen zu markieren: Wenn Sie den Dialog beenden, sendet Claude Code eine Nachricht, die dem Modell mitteilt, dass es diesen Tool-Aufruf wiederholen darf, und setzt das Gespräch fort.

393 379

394Wenn der Klassifizierer [keine Entscheidung zur Aktion trifft](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action), weil eine Sicherheitsprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers selbst oder dessen Antwort nicht analysiert hat, lehnt Claude Code die Aktion ab, ohne sie unter **Kürzlich abgelehnt** aufzuzeichnen. Der verlinkte Fehlereintrag behandelt, was Claude mitgeteilt wird, und wie die Aktion ausgeführt wird, falls Sie sie benötigen.380Wenn der Klassifizierer [kein Urteil über die Aktion fällt](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action), weil eine Sicherheitsprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers abgelehnt hat oder dessen Antwort nicht analysiert wurde, lehnt Claude Code die Aktion ab, ohne sie unter **Recently denied** (Kürzlich abgelehnt) aufzuzeichnen. Der verlinkte Fehlereintrag behandelt, was Claude mitgeteilt wird, und wie die Aktion ausgeführt wird, falls Sie sie benötigen.

395 381

396<h3 id="fix-a-denial-with-an-allow-rule-an-environment-entry-or-a-retry">382<h3 id="fix-a-denial-with-an-allow-rule-an-environment-entry-or-a-retry">

397 Eine Ablehnung mit einer Erlaubnisregel, einem Umgebungseintrag oder einem Wiederholungsversuch beheben383 Eine Ablehnung mit einer Allow-Regel, einem Umgebungseintrag oder einem Wiederholungsversuch beheben

398</h3>384</h3>

399 385

400Um zu sehen, was der Klassifizierer blockiert hat, suchen Sie den Tool-Aufruf im Gespräch. Wenn der Aufruf verkürzt oder in eine Zusammenfassungszeile wie `Ran 3 shell commands` eingeklappt angezeigt wird, drücken Sie `Ctrl+O`, um den [Transcript-Viewer](/docs/de/interactive-mode#transcript-viewer) zu öffnen, der ihn erweitert.386Um zu sehen, was der Klassifizierer blockiert hat, suchen Sie den Tool-Aufruf im Gespräch. Wenn der Aufruf verkürzt oder in eine Zusammenfassungszeile wie `Ran 3 shell commands` eingeklappt angezeigt wird, drücken Sie `Ctrl+O`, um den [Transcript Viewer](/docs/de/interactive-mode#transcript-viewer) zu öffnen, der ihn erweitert.

401 387

402Zwei weitere Stellen auf dem Bildschirm, die Ablehnungen melden, lassen den Befehl oder die URL aus: Die Benachrichtigung neben dem Eingabefeld, z. B. `bash denied by auto mode · [Data Exfiltration] · /permissions`, gibt das Tool und den Grund an, und die Registerkarte **Kürzlich abgelehnt** listet einen Shell-Befehl nach der Beschreibung auf, die Claude dafür geschrieben hat. Um die genaue Eingabe dieser Ablehnungen programmgesteuert zu erfassen, fügen Sie einen [`PermissionDenied`-Hook](/docs/de/hooks#permissiondenied) hinzu, der sie als `tool_input` empfängt.388Zwei weitere Stellen auf dem Bildschirm, die Ablehnungen melden, lassen den Befehl oder die URL aus: Die Benachrichtigung neben dem Eingabefeld, z. B. `bash denied by auto mode · [Data Exfiltration] · /permissions`, gibt das Tool und den Grund an, und die Registerkarte **Recently denied** (Kürzlich abgelehnt) listet einen Shell-Befehl nach der Beschreibung auf, die Claude dafür geschrieben hat. Um die genaue Eingabe dieser Ablehnungen programmgesteuert zu erfassen, fügen Sie einen [`PermissionDenied` Hook](/docs/de/hooks#permissiondenied) hinzu, der sie als `tool_input` empfängt.

403 389

404Der Text unter dem Aufruf teilt Ihnen mit, ob es etwas zu beheben gibt. Text, der ein Problem mit dem Klassifizierer selbst meldet, z. B. ein Modell, das `is temporarily unavailable` ist, oder ein Klassifizierer-Fehler, bedeutet, dass Claude Code den Aufruf ohne endgültige Entscheidung des Klassifizierers blockiert hat; siehe [Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) für weitere Informationen. Andernfalls bedeutet eine Zeile, die `Denied by auto mode classifier` mit einem Grund wie `[Production Deploy]` oder `Blocked by classifier` liest, dass der Klassifizierer den Aufruf für unsicher befunden hat. Wählen Sie daher die Behebung aus dem aus, was der Aufruf erreichen oder tun wollte:390Der Text unter dem Aufruf teilt Ihnen mit, ob es etwas zu beheben gibt. Text, der ein Problem mit dem Klassifizierer selbst meldet, z. B. ein Modell, das `is temporarily unavailable` ist, oder ein Klassifizierer-Fehler, bedeutet, dass Claude Code den Aufruf ohne ein endgültiges Urteil des Klassifizierers blockiert hat; siehe [Auto mode cannot determine the safety of an action](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) für weitere Informationen. Andernfalls bedeutet eine Zeile, die `Denied by auto mode classifier` mit einem Grund wie `[Production Deploy]` oder `Blocked by classifier` liest, dass der Klassifizierer den Aufruf für unsicher befunden hat. Wählen Sie daher die Behebung basierend auf dem aus, was der Aufruf erreichen oder tun wollte:

405 391

406* Ein Ziel, das Claude während der gesamten Aufgabe benötigt, z. B. eine Paket-Registry, eine interne Domäne oder einen Repository-Host: Fügen Sie es zu `autoMode.environment` hinzu.392* Ein Ziel, das Claude während der gesamten Aufgabe benötigt, z. B. eine Paket-Registry, eine interne Domäne oder einen Repository-Host: Fügen Sie es zu `autoMode.environment` hinzu.

407* Ein Befehl, den Sie von nun an ohne Überprüfung ausführen möchten: Fügen Sie eine `allow`-Regel hinzu.393* Ein Befehl, den Sie von nun an ohne Überprüfung ausführen möchten: Fügen Sie eine `allow`-Regel hinzu.

408* Eine einmalige Aktion, die Sie beabsichtigt haben: Geben Sie diese Absicht in Ihrer nächsten Nachricht an und lassen Sie Claude erneut versuchen.394* Eine einmalige Aktion, die Sie beabsichtigt haben: Geben Sie diese Absicht in Ihrer nächsten Nachricht an und lassen Sie Claude es erneut versuchen.

409 395

410Sie können den Umgebungseintrag oder die `allow`-Regel aus der Registerkarte [**Auto-Modus**](#edit-rules-from-permissions) des Dialogs `/permissions` hinzufügen.396Sie können den Umgebungseintrag oder die `allow`-Regel aus der Registerkarte [**Auto mode**](#edit-rules-from-permissions) des Dialogs `/permissions` hinzufügen.

411 397

412In den meisten Sitzungen benennt der Grund die Regel, die der Klassifizierer abgeglichen hat, in eckigen Klammern, z. B. `[Data Exfiltration]` oder `[Production Deploy]`, und einige Sitzungen führen ein Klassifizierer-Modell aus, das eine kurze Erklärung hinzufügt. Claude Code wählt das Klassifizierer-Modell aus, daher ist es nicht etwas, das Sie konfigurieren können, welche Form Sie sehen.398Der Text in eckigen Klammern, z. B. `[Data Exfiltration]`, ist der Name der Regel, die der Klassifizierer gefunden hat. Um die vollständige Formulierung dieser Regel zu lesen, siehe [Inspect the defaults and your effective config](#inspect-the-defaults-and-your-effective-config).

413 399

414<h3 id="fix-repeated-denials">400<h3 id="fix-repeated-denials">

415 Wiederholte Ablehnungen beheben401 Wiederholte Ablehnungen beheben

417 403

418Wiederholte Ablehnungen für dasselbe Ziel bedeuten normalerweise, dass dem Klassifizierer der Kontext fehlt. Fügen Sie dieses Ziel zu `autoMode.environment` hinzu, oder [führen Sie `/auto-mode-setup`](#generate-environment-entries) aus, damit Claude Code die Einträge entwirft, und führen Sie dann `claude auto-mode config` aus, um zu bestätigen, dass die Änderung wirksam wurde.404Wiederholte Ablehnungen für dasselbe Ziel bedeuten normalerweise, dass dem Klassifizierer der Kontext fehlt. Fügen Sie dieses Ziel zu `autoMode.environment` hinzu, oder [führen Sie `/auto-mode-setup`](#generate-environment-entries) aus, damit Claude Code die Einträge entwirft, und führen Sie dann `claude auto-mode config` aus, um zu bestätigen, dass die Änderung wirksam wurde.

419 405

420Um programmgesteuert auf Ablehnungen zu reagieren, verwenden Sie den [`PermissionDenied`-Hook](/docs/de/hooks#permissiondenied).

~~421~~

422<h2 id="see-also">406<h2 id="see-also">

423 Siehe auch407 Siehe auch

424</h2>408</h2>

best-practices.md +3 −3

Details

46 46

47* **In einer Eingabeaufforderung**: Bitten Sie Claude, die Überprüfung auszuführen und in derselben Nachricht zu iterieren, wie in der Tabelle oben.47* **In einer Eingabeaufforderung**: Bitten Sie Claude, die Überprüfung auszuführen und in derselben Nachricht zu iterieren, wie in der Tabelle oben.

48* **Über eine Sitzung**: Legen Sie die Überprüfung als [`/goal`-Bedingung](/docs/de/goal) fest. Ein separater Evaluator überprüft sie nach jedem Zug erneut und Claude arbeitet weiter, bis die Bedingung erfüllt ist. Wenn Claude steckenbleibt, beendet Claude Code den Lauf schließlich mit der noch gesetzten Bedingung — siehe [wie /goal-Evaluierung funktioniert](/docs/de/goal#how-evaluation-works).48* **Über eine Sitzung**: Legen Sie die Überprüfung als [`/goal`-Bedingung](/docs/de/goal) fest. Ein separater Evaluator überprüft sie nach jedem Zug erneut und Claude arbeitet weiter, bis die Bedingung erfüllt ist. Wenn Claude steckenbleibt, beendet Claude Code den Lauf schließlich mit der noch gesetzten Bedingung — siehe [wie /goal-Evaluierung funktioniert](/docs/de/goal#how-evaluation-works).

49* **Als deterministisches Gate**: Ein [Stop-Hook](/docs/de/hooks#stop) führt Ihre Überprüfung als Skript aus und blockiert das Ende des Zugs, bis er bestanden ist. Claude Code überschreibt den Hook und beendet den Zug nach 8 aufeinanderfolgenden Blockierungen.49* **Als deterministisches Gate**: Ein [Stop-Hook](/docs/de/hooks#stop) führt Ihre Überprüfung als Skript aus und blockiert das Ende des Zugs, bis er bestanden ist. [Stop-Eingabe](/docs/de/hooks#stop-input) behandelt die Obergrenze für aufeinanderfolgende Blockierungen.

50* **Durch eine zweite Meinung**: Ein [Überprüfungs-Subagent](/docs/de/sub-agents) oder ein [dynamischer Workflow](/docs/de/workflows), der seine eigenen Erkenntnisse überprüft, lässt ein frisches Modell versuchen, das Ergebnis zu widerlegen, sodass der Agent, der die Arbeit verrichtet, nicht derjenige ist, der sie bewertet.50* **Durch eine zweite Meinung**: Ein [Überprüfungs-Subagent](/docs/de/sub-agents) oder ein [dynamischer Workflow](/docs/de/workflows), der seine eigenen Erkenntnisse überprüft, lässt ein frisches Modell versuchen, das Ergebnis zu widerlegen, sodass der Agent, der die Arbeit verrichtet, nicht derjenige ist, der sie bewertet.

51 51

52Jeder Schritt tauscht Setup gegen Aufmerksamkeit. Die Eingabeaufforderungsversion funktioniert heute bei jeder Aufgabe. Die `/goal`- und Stop-Hook-Versionen sind das, was einen unbeaufsichtigten Lauf ermöglicht, um korrekt zu beenden, ohne dass Sie eingreifen müssen.52Jeder Schritt tauscht Setup gegen Aufmerksamkeit. Die Eingabeaufforderungsversion funktioniert heute bei jeder Aufgabe. Die `/goal`- und Stop-Hook-Versionen sind das, was einen unbeaufsichtigten Lauf ermöglicht, um korrekt zu beenden, ohne dass Sie eingreifen müssen.

209 Um weniger Aufforderungen zu erhalten, ohne die Kontrolle aufzugeben, genehmigen Sie die Tools, denen Sie mit `/permissions` vertrauen, im Voraus und lassen Sie Sandbox-Befehle mit `/sandbox` ohne Nachfrage ausführen. Wechseln Sie zum manuellen Modus, wenn Sie Bearbeitungen und Befehle selbst genehmigen möchten.209 Um weniger Aufforderungen zu erhalten, ohne die Kontrolle aufzugeben, genehmigen Sie die Tools, denen Sie mit `/permissions` vertrauen, im Voraus und lassen Sie Sandbox-Befehle mit `/sandbox` ohne Nachfrage ausführen. Wechseln Sie zum manuellen Modus, wenn Sie Bearbeitungen und Befehle selbst genehmigen möchten.

210</Tip>210</Tip>

211 211

212Bei Pro-, Max- und Team-Plänen ist der automatische Modus der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) für interaktive Terminal- und VS Code-Sessions: ein separates Klassifizierer-Modell überprüft die meisten Aktionen statt Ihnen und blockiert nur das, was riskant aussieht, wie Scope-Eskalation, unbekannte Infrastruktur oder feindselige-Inhalts-getriebene Aktionen.212Mit Claude Code v2.1.283 oder später ist der automatische Modus der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) für interaktive Terminal- und VS Code-Sessions: ein separates Klassifizierer-Modell überprüft die meisten Aktionen statt Ihnen und blockiert nur das, was riskant aussieht, wie Scope-Eskalation, unbekannte Infrastruktur oder feindselige-Inhalts-getriebene Aktionen. Bei früheren Versionen ist der automatische Modus der integrierte Standard-Berechtigungsmodus nur bei Pro-, Max- und Team-Plänen.

213 213

214Im manuellen Modus, dem integrierten Standard-Berechtigungsmodus bei anderen Plänen, fragt Claude Code vor Aktionen, die Ihr System ändern könnten: Dateischreibvorgänge, Bash-Befehle, MCP-Tools. Das ist sicher, aber mühsam. Nach der zehnten Genehmigung überprüfen Sie nicht wirklich mehr, Sie klicken einfach durch. Zwei Tools reduzieren diese Unterbrechungen im manuellen Modus und gelten auch im automatischen Modus:214Im manuellen Modus fragt Claude Code vor Aktionen, die Ihr System ändern könnten: Dateischreibvorgänge, Bash-Befehle, MCP-Tools. Das ist sicher, aber mühsam. Nach der zehnten Genehmigung überprüfen Sie nicht wirklich mehr, Sie klicken einfach durch. Zwei Tools reduzieren diese Unterbrechungen im manuellen Modus und gelten auch im automatischen Modus:

215 215

216* **Berechtigungs-Whitelists**: erlauben Sie spezifische Tools, die Sie kennen und die sicher sind, wie `npm run lint` oder `git commit`216* **Berechtigungs-Whitelists**: erlauben Sie spezifische Tools, die Sie kennen und die sicher sind, wie `npm run lint` oder `git commit`

217* **Sandboxing**: aktivieren Sie Isolation auf Betriebssystemebene, die Dateisystem- und Netzwerkzugriff einschränkt und Claude ermöglicht, freier innerhalb definierter Grenzen zu arbeiten217* **Sandboxing**: aktivieren Sie Isolation auf Betriebssystemebene, die Dateisystem- und Netzwerkzugriff einschränkt und Claude ermöglicht, freier innerhalb definierter Grenzen zu arbeiten

channels-reference.md +1 −1

Details

804 804

805Um Ihren Channel installierbar und teilbar zu machen, wickeln Sie ihn in ein [Plugin](/docs/de/plugins/overview) ein und veröffentlichen Sie ihn auf einem [Marketplace](/docs/de/plugins/overview). Benutzer installieren ihn mit `/plugin install`, dann aktivieren ihn pro Sitzung mit `--channels plugin:<name>@<marketplace>`.805Um Ihren Channel installierbar und teilbar zu machen, wickeln Sie ihn in ein [Plugin](/docs/de/plugins/overview) ein und veröffentlichen Sie ihn auf einem [Marketplace](/docs/de/plugins/overview). Benutzer installieren ihn mit `/plugin install`, dann aktivieren ihn pro Sitzung mit `--channels plugin:<name>@<marketplace>`.

806 806

807Ein Channel, der auf Ihrem eigenen Marketplace veröffentlicht wird, benötigt immer noch `--dangerously-load-development-channels` zum Ausführen, da er nicht auf der [genehmigten Allowlist](/docs/de/channels#supported-channels) ist. Die Standard-Allowlist ist die Channel-Plugins in `claude-plugins-official`. Die [In-App-Einreichungsformulare](/docs/de/plugins/publish#submit-to-the-community-marketplace) fügen Plugins zum Community-Marketplace hinzu, der nicht auf der Channel-Allowlist ist.807Ein Channel, der auf Ihrem eigenen Marketplace veröffentlicht wird, benötigt immer noch `--dangerously-load-development-channels` zum Ausführen, da er nicht auf der [genehmigten Allowlist](/docs/de/channels#supported-channels) ist. Die Standard-Allowlist ist die Channel-Plugins in `claude-plugins-official`. Der Community-Marketplace ist nicht auf der Channel-Allowlist.

808 808

809Wenn Sie mit einem Anthropic-Partner-Kontakt arbeiten, wenden Sie sich an diese Person, um eine offizielle Marketplace-Auflistung zu koordinieren. Bei Team- und Enterprise-Plänen kann ein Admin stattdessen Ihr Plugin in die [`allowedChannelPlugins`](/docs/de/channels#restrict-which-channel-plugins-can-run)-Liste der Organisation aufnehmen, die die Standard-Anthropic-Allowlist ersetzt.809Wenn Sie mit einem Anthropic-Partner-Kontakt arbeiten, wenden Sie sich an diese Person, um eine offizielle Marketplace-Auflistung zu koordinieren. Bei Team- und Enterprise-Plänen kann ein Admin stattdessen Ihr Plugin in die [`allowedChannelPlugins`](/docs/de/channels#restrict-which-channel-plugins-can-run)-Liste der Organisation aufnehmen, die die Standard-Anthropic-Allowlist ersetzt.

810 810

checkpointing.md +1 −1

Details

114 Nachrichten, die während eines Zuges gesendet werden, werden nicht als Checkpoint erstellt114 Nachrichten, die während eines Zuges gesendet werden, werden nicht als Checkpoint erstellt

115</h3>115</h3>

116 116

117Wenn eine Nachricht, die Sie [in die Warteschlange einreihen, während Claude arbeitet](/docs/de/interactive-mode#queue-messages-while-claude-works), Claude innerhalb des laufenden Zuges erreicht, wird sie in diesen Zug integriert, anstatt einen neuen zu starten. Die Nachricht wird in der Unterhaltung angezeigt, aber Claude Code erstellt keinen Checkpoint dafür, und das Zurückspulen-Menü listet sie nicht auf. Eine in die Warteschlange eingereihte Nachricht, die Claude Code als eigenen Zug sendet, erhält wie gewohnt einen Checkpoint.117Wenn eine Nachricht, die Sie [in die Warteschlange einreihen, während Claude arbeitet](/docs/de/interactive-mode#queue-messages-while-claude-works), Claude innerhalb des laufenden Zuges erreicht, wird sie in diesen Zug integriert, anstatt einen neuen zu starten. Die Nachricht wird in der Unterhaltung angezeigt, aber Claude Code erstellt keinen Checkpoint dafür, und das Zurückspulen-Menü listet sie nicht auf. Eine in die Warteschlange eingereihte Nachricht, die Claude Code als eigenen Zug sendet, erhält wie gewohnt einen Checkpoint, einschließlich wenn mehrere in die Warteschlange eingereihte Nachrichten [diesen Zug teilen](/docs/de/interactive-mode#when-claude-code-sends-what-you-queued).

118 118

119Um eine solche Nachricht zu entfernen oder die Bearbeitungen rückgängig zu machen, die Claude nach ihr vorgenommen hat, spulen Sie zu dem Prompt zurück, der den Zug gestartet hat. Dies spult den gesamten Zug zurück, einschließlich der Arbeit, die Claude vor dem Eintreffen Ihrer Nachricht geleistet hat.119Um eine solche Nachricht zu entfernen oder die Bearbeitungen rückgängig zu machen, die Claude nach ihr vorgenommen hat, spulen Sie zu dem Prompt zurück, der den Zug gestartet hat. Dies spult den gesamten Zug zurück, einschließlich der Arbeit, die Claude vor dem Eintreffen Ihrer Nachricht geleistet hat.

120 120

claude-apps-gateway.md +3 −3

Details

77| OpenID Connect (OIDC)-Identitätsanbieter | Okta, Microsoft Entra ID, Google Workspace, Keycloak oder Dex, oder ein anderer OIDC-konformer IdP wie PingFederate. Das Gateway führt Standard-OIDC-Erkennung und den Authorization-Code-Flow dagegen aus. SAML und LDAP werden nicht unterstützt. |77| OpenID Connect (OIDC)-Identitätsanbieter | Okta, Microsoft Entra ID, Google Workspace, Keycloak oder Dex, oder ein anderer OIDC-konformer IdP wie PingFederate. Das Gateway führt Standard-OIDC-Erkennung und den Authorization-Code-Flow dagegen aus. SAML und LDAP werden nicht unterstützt. |

78| PostgreSQL 14 oder später | Unterstützt den Geräte-Anmeldungsfluss, bei dem der Browser-Callback schreibt und die Polling-CLI liest, sowie Rate-Limit-Zähler. Jedes verwaltete Postgres funktioniert, einschließlich der kleinsten Stufe. Ohne konfigurierte Ausgabenlimits speichert das Gateway einige KB kurzlebigen Auth-Status; mit [Ausgabenlimits](/docs/de/claude-apps-gateway-spend-limits) enthält es auch dauerhafte Ausgaben-, Audit- und Identitätstabellen, die gesichert werden sollten. TLS über `?sslmode=require` wird empfohlen. |78| PostgreSQL 14 oder später | Unterstützt den Geräte-Anmeldungsfluss, bei dem der Browser-Callback schreibt und die Polling-CLI liest, sowie Rate-Limit-Zähler. Jedes verwaltete Postgres funktioniert, einschließlich der kleinsten Stufe. Ohne konfigurierte Ausgabenlimits speichert das Gateway einige KB kurzlebigen Auth-Status; mit [Ausgabenlimits](/docs/de/claude-apps-gateway-spend-limits) enthält es auch dauerhafte Ausgaben-, Audit- und Identitätstabellen, die gesichert werden sollten. TLS über `?sslmode=require` wird empfohlen. |

79| Modell-Upstream | Amazon-Bedrock-Anmeldedaten, Claude Platform auf AWS Anmeldedaten, Google-Cloud-Anmeldedaten, eine Microsoft-Foundry-Ressource oder einen Anthropic-API-Schlüssel. Mehrere Upstreams werden mit Failover unterstützt. |79| Modell-Upstream | Amazon-Bedrock-Anmeldedaten, Claude Platform auf AWS Anmeldedaten, Google-Cloud-Anmeldedaten, eine Microsoft-Foundry-Ressource oder einen Anthropic-API-Schlüssel. Mehrere Upstreams werden mit Failover unterstützt. |

80| HTTPS | Das Gateway muss über `https://` von Entwickler-Laptops und von jedem Browser, der für die Anmeldung verwendet wird, erreichbar sein; das Gateway bedient die Geräteüberprüfungsseite auf dem gleichen Listener. Stellen Sie entweder ein TLS-Zertifikat über `listen.tls` bereit, oder führen Sie hinter einem TLS-terminierenden Ingress aus und setzen Sie `listen.public_url` auf den externen Ursprung in beiden Fällen. Ein einfacher `http://`-Ursprung wird nur akzeptiert, wenn der Gateway-Host Loopback ist: `localhost`, `127.0.0.1` oder `::1`. |80| HTTPS | Das Gateway muss über `https://` von Entwickler-Laptops und von jedem Browser, der für die Anmeldung verwendet wird, erreichbar sein; das Gateway bedient die Geräteüberprüfungsseite auf dem gleichen Listener. Stellen Sie entweder ein TLS-Zertifikat über `listen.tls` bereit, oder führen Sie hinter einem TLS-terminierenden Ingress aus und setzen Sie `listen.public_url` auf den externen Ursprung in beiden Fällen. Bei `/login` akzeptiert Claude Code einen einfachen `http://`-Ursprung nur, wenn der Gateway-Host Loopback ist: `localhost`, `127.0.0.1` oder `::1`. |

81| Private-Netzwerk-Adresse | Bei `/login` erfordert Claude Code, dass der Hostname oder die IP-Adresse des Gateways nur zu privaten Adressen aufgelöst wird: RFC 1918, Link-lokal, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` oder Loopback. Für ein von Ihnen gehostetes Gateway wird jede öffentliche Adresse außerhalb eines Blocks, den Sie deklarieren, abgelehnt; siehe das [Bedrohungsmodell](/docs/de/claude-apps-gateway-deploy#threat-model-summary) im Bereitstellungsleitfaden. Wenn Entwicklermaschinen HTTPS über einen Unternehmens-Proxy leiten, erfordert die Anmeldung auch, dass der Proxy-Host zu privaten Adressen aufgelöst wird; wenn nicht, fügen Sie den Gateway-Host zu `NO_PROXY` hinzu, damit die CLI direkt verbunden wird. Wenn Ihr internes Netzwerk aus öffentlichem IPv4-Adressraum nummeriert ist, den Ihre Organisation besitzt, [deklarieren Sie diese Blöcke](#allow-a-gateway-on-public-address-space-you-own), damit `/login` ein Gateway dort akzeptiert. |81| Private-Netzwerk-Adresse | Bei `/login` erfordert Claude Code, dass der Hostname oder die IP-Adresse des Gateways nur zu privaten Adressen aufgelöst wird: RFC 1918, Link-lokal, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` oder Loopback. Für ein von Ihnen gehostetes Gateway wird jede öffentliche Adresse außerhalb eines Blocks, den Sie deklarieren, abgelehnt; siehe das [Bedrohungsmodell](/docs/de/claude-apps-gateway-deploy#threat-model-summary) im Bereitstellungsleitfaden. Wenn Entwicklermaschinen HTTPS über einen Unternehmens-Proxy leiten, erfordert die Anmeldung auch, dass der Proxy-Host zu privaten Adressen aufgelöst wird; wenn nicht, fügen Sie den Gateway-Host zu `NO_PROXY` hinzu, damit die CLI direkt verbunden wird. Wenn Ihr internes Netzwerk aus öffentlichem IPv4-Adressraum nummeriert ist, den Ihre Organisation besitzt, [deklarieren Sie diese Blöcke](#allow-a-gateway-on-public-address-space-you-own), damit `/login` ein Gateway dort akzeptiert. |

82| Linux-Laufzeit | Der Gateway-Server läuft nur auf der nativen Linux-Binärdatei. macOS funktioniert für lokale Entwicklung. Windows wird nicht als Serverplattform unterstützt. |82| Linux-Laufzeit | Der Gateway-Server läuft nur auf der nativen Linux-Binärdatei. macOS funktioniert für lokale Entwicklung. Windows wird nicht als Serverplattform unterstützt. |

83 83

448 448

449Sechs übergeordnete Einstellungen passieren den Filter auch mit allen fünf Sperren gesetzt. Unter der Standard-First-Wins-Einstellung ist der Admin-Wert, der den übergeordneten blockiert, der in der höchsten Prioritäts-Admin-Quelle, außer für `allowedMcpServers` während die [MCP-Server-Sperre](#lock-behavior-across-sources) aktiv ist. Unter der Merge-Opt-in `managedSourcesBehavior` sagt [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources), welcher Quellenwert stattdessen gilt.449Sechs übergeordnete Einstellungen passieren den Filter auch mit allen fünf Sperren gesetzt. Unter der Standard-First-Wins-Einstellung ist der Admin-Wert, der den übergeordneten blockiert, der in der höchsten Prioritäts-Admin-Quelle, außer für `allowedMcpServers` während die [MCP-Server-Sperre](#lock-behavior-across-sources) aktiv ist. Unter der Merge-Opt-in `managedSourcesBehavior` sagt [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources), welcher Quellenwert stattdessen gilt.

450 450

451* **`forceLoginOrgUUID`**: Claude Code ehrt einen übergeordneten Wert, wenn die höchste Prioritäts-Admin-Quelle keine Organisations-UUID setzt. Gateway-Anmeldung überprüft diesen Schlüssel nicht, daher ist er nur für Flotten wichtig, die auch First-Party-Anthropic-Anmeldungen verwenden. Eine Organisations-UUID in der höchsten Prioritäts-Admin-Quelle blockiert den übergeordneten Wert und ist der, den Claude Code erzwingt, daher setzen Sie `forceLoginOrgUUID` dort.451* **`forceLoginOrgUUID`**: Claude Code ehrt einen übergeordneten Wert, wenn die höchste Prioritäts-Admin-Quelle keine Organisations-UUID setzt. Gateway-Anmeldung überprüft diesen Schlüssel nicht. Eine Organisations-UUID in der höchsten Prioritäts-Admin-Quelle blockiert den übergeordneten Wert und ist der, den Claude Code erzwingt.

452* **`allowedMcpServers`**: Claude Code ehrt eine übergeordnete Zulassungsliste, wenn keine Admin-Liste in Kraft ist. `allowManagedMcpServersOnly` blockiert sie nicht, da die Sperre erzwingt, welche Liste auch immer gewinnt, als verwalteter Wert, einschließlich einer übergeordneten Liste, wenn keine Admin-Quelle eine Liste liefert. Eine Liste in der höchsten Prioritäts-Admin-Quelle blockiert die übergeordnete und ist die Liste, die Claude Code erzwingt, daher setzen Sie `allowedMcpServers` dort, neben der Sperre. Vor v2.1.223 blockierte ein Wert für einen der beiden Schlüssel in jeder Admin-Quelle den übergeordneten.452* **`allowedMcpServers`**: Claude Code ehrt eine übergeordnete Zulassungsliste, wenn keine Admin-Liste in Kraft ist. `allowManagedMcpServersOnly` blockiert sie nicht, da die Sperre erzwingt, welche Liste auch immer gewinnt, als verwalteter Wert, einschließlich einer übergeordneten Liste, wenn keine Admin-Quelle eine Liste liefert. Eine Liste in der höchsten Prioritäts-Admin-Quelle blockiert die übergeordnete und ist die Liste, die Claude Code erzwingt, daher setzen Sie `allowedMcpServers` dort, neben der Sperre. Vor v2.1.223 blockierte ein Wert für einen der beiden Schlüssel in jeder Admin-Quelle den übergeordneten.

453* **`availableModels`**: Claude Code ehrt eine übergeordnete Modelliste, wenn die Gewinnerquelle für verwaltete Einstellungen keine setzt. Wenn Ihre Flotte Modelle einschränkt, setzen Sie `availableModels` in der Gewinnerquelle.453* **`availableModels`**: Claude Code ehrt eine übergeordnete Modelliste, wenn die Gewinnerquelle für verwaltete Einstellungen keine setzt. Wenn Ihre Flotte Modelle einschränkt, setzen Sie `availableModels` in der Gewinnerquelle.

454* **`strictKnownMarketplaces`**: Claude Code ehrt eine übergeordnete Plugin-Marketplace-Zulassungsliste, wenn die Gewinnerquelle für verwaltete Einstellungen keine setzt. Wenn Ihre Flotte Marketplaces einschränkt, setzen Sie `strictKnownMarketplaces` in der Gewinnerquelle. Erfordert Claude Code v2.1.282 oder später.454* **`strictKnownMarketplaces`**: Claude Code ehrt eine übergeordnete Plugin-Marketplace-Zulassungsliste, wenn die Gewinnerquelle für verwaltete Einstellungen keine setzt. Wenn Ihre Flotte Marketplaces einschränkt, setzen Sie `strictKnownMarketplaces` in der Gewinnerquelle. Erfordert Claude Code v2.1.282 oder später.

486 * In den eingebetteten Sitzungen, die [Claude Desktop startet](#connect-claude-desktop), sendet die CLI ihre Exporte an den konfigurierten `OTEL_EXPORTER_OTLP_ENDPOINT`. Die CLI hängt das Gateway-Sitzungstoken an diese Exporte nur an, wenn dieser Endpunkt auf das Gateway selbst zeigt.486 * In den eingebetteten Sitzungen, die [Claude Desktop startet](#connect-claude-desktop), sendet die CLI ihre Exporte an den konfigurierten `OTEL_EXPORTER_OTLP_ENDPOINT`. Die CLI hängt das Gateway-Sitzungstoken an diese Exporte nur an, wenn dieser Endpunkt auf das Gateway selbst zeigt.

487 * Ohne konfiguriertes Ziel für ein Signal akzeptiert das Gateway es und verwirft es.487 * Ohne konfiguriertes Ziel für ein Signal akzeptiert das Gateway es und verwirft es.

488 * Wenn Sie bereits Claude Code-Telemetrie direkt erfassen, fügen Sie Ihren Collector als `forward_to`-Ziel hinzu, oder benennen Sie ihn in einer Richtlinie, um das Relay zu überspringen.488 * Wenn Sie bereits Claude Code-Telemetrie direkt erfassen, fügen Sie Ihren Collector als `forward_to`-Ziel hinzu, oder benennen Sie ihn in einer Richtlinie, um das Relay zu überspringen.

489* **Anmeldedaten**: Das Gateway-Token ist die einzige Anmeldedaten der Sitzung. [Anthropic-Profile](/docs/de/authentication#anthropic-profiles-and-federation-credentials) und jede frühere claude.ai-Anmeldung werden ignoriert, während angemeldet, daher müssen sich Entwickler nicht zuerst von claude.ai abmelden. Für einen konfigurierten `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`-Anmeldedaten siehe [Administratorrichtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in).489* **Anmeldedaten**: Das Gateway-Token ist die einzige Anmeldedaten der Sitzung. [Anthropic-Profile](/docs/de/authentication#anthropic-profiles-and-federation-credentials) und jede frühere claude.ai-Anmeldung werden ignoriert, während angemeldet, daher müssen sich Entwickler nicht zuerst von claude.ai abmelden. Für einen konfigurierten `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`-Anmeldedaten oder einen API-Schlüssel, der durch eine frühere Claude Console-Anmeldung gespeichert wurde, siehe [Administratorrichtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in).

490* **Verwaltete Einstellungen**: Gesperrte Schlüssel können nicht lokal überschrieben werden. Die CLI wendet die Richtlinie beim Start an und wendet Änderungen bei jeder stündlichen Abfrage an, abgesehen von den [Änderungen, die nur beim nächsten Start angewendet werden](/docs/de/server-managed-settings#fetch-and-caching-behavior).490* **Verwaltete Einstellungen**: Gesperrte Schlüssel können nicht lokal überschrieben werden. Die CLI wendet die Richtlinie beim Start an und wendet Änderungen bei jeder stündlichen Abfrage an, abgesehen von den [Änderungen, die nur beim nächsten Start angewendet werden](/docs/de/server-managed-settings#fetch-and-caching-behavior).

491* **Startup mit dem Gateway unerreichbar**: Angemeldete Sitzungen beenden sich beim Start mit einem Fehler nach etwa 10 Sekunden, anstatt ohne ihre Einstellungen zu starten.491* **Startup mit dem Gateway unerreichbar**: Angemeldete Sitzungen beenden sich beim Start mit einem Fehler nach etwa 10 Sekunden, anstatt ohne ihre Einstellungen zu starten.

492* **Startup nach dem Gateway beendet die Sitzung**: siehe [Fail-Closed-Startup erzwingen](/docs/de/server-managed-settings#enforce-fail-closed-startup) für die Starts, die abgemeldet vom Gateway öffnen, und die, die beenden, wenn das Gateway mit einem `401` antwortet.492* **Startup nach dem Gateway beendet die Sitzung**: siehe [Fail-Closed-Startup erzwingen](/docs/de/server-managed-settings#enforce-fail-closed-startup) für die Starts, die abgemeldet vom Gateway öffnen, und die, die beenden, wenn das Gateway mit einem `401` antwortet.

claude-apps-gateway-config.md +40 −3

Details

949* `OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>`949* `OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>`

950* `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`950* `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`

951 951

952Wenn Sie [Ihre eigenen Labels hinzufügen](#add-your-own-labels), drückt das Gateway auch `OTEL_RESOURCE_ATTRIBUTES`.

953

952Vor Claude Code v2.1.265 auf dem Gateway-Server drückte das Gateway alle drei Exporter-Selektoren als `otlp`, einschließlich für Signale, die kein Ziel aktiviert hat.954Vor Claude Code v2.1.265 auf dem Gateway-Server drückte das Gateway alle drei Exporter-Selektoren als `otlp`, einschließlich für Signale, die kein Ziel aktiviert hat.

953 955

954Der gepushte Endpunkt wird aus der öffentlichen URL erstellt, sodass Metriken und Protokolle keine OTEL-Konfiguration von Entwicklern oder Richtlinien benötigen.956Der gepushte Endpunkt wird aus der öffentlichen URL erstellt, sodass Metriken und Protokolle keine OTEL-Konfiguration von Entwicklern oder Richtlinien benötigen.

966 968

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

968 970

971<h4 id="add-your-own-labels">

972 Ihre eigenen Labels hinzufügen

973</h4>

974

975Um feste Labels wie `service.namespace` oder `deployment.environment.name` auf die Telemetrie von Sitzungen zu legen, die sich durch das Gateway anmelden, setzen Sie `telemetry.resource_attributes`. Jedes Label ist ein OpenTelemetry-Ressourcenattribut, und jedes Ziel erhält die gleichen Labels.

976

977Sitzungen erhalten die Labels nur, wenn Sie auch `telemetry.forward_to` und `listen.public_url` setzen. Dieses Beispiel fügt zwei Labels hinzu:

978

979```yaml theme={null}

980telemetry:

981 forward_to:

982 - url: https://otel-collector.internal.example.com

983 resource_attributes:

984 service.namespace: claude

985 deployment.environment.name: prod

986```

987

988Das Gateway weigert sich zu starten, wenn ein Label eine dieser Regeln bricht, und der Startup-Fehler benennt das Label:

989

990* Namen verwenden nur Buchstaben, Ziffern, `.`, `_` und `-`

991* Namen sind nicht reserviert. Verglichen in jeder Schreibweise sind die reservierten Namen alles, das mit `user.`, `enduser.` oder `identity.` beginnt, plus `service.name`, `service.version`, `claude.deployment_mode`, `host.arch`, `os.type`, `os.version` und `wsl.version`

992* Werte sind nicht leere druckbare ASCII ohne Leerzeichen und keine von `, ; = \ " %`

993* Werte sind höchstens 255 Zeichen, wie das Gateway sie nach prozentualem Kodieren zählt, sodass `/`, `:` und `@` jeweils als drei zählen

994* Werte sind Text, daher zitieren Sie eine Zahl, `true` oder `false`

995

996Sie benötigen Claude Code v2.1.281 oder später auf dem Gateway-Server, um `telemetry.resource_attributes` zu setzen. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Schlüssel hinzufügen, und entfernen Sie den Schlüssel, bevor Sie zu einer früheren Version zurückrollen.

997

998Terminal-Sitzungen, die sich durch `/login` anmelden, erhalten die Labels als `OTEL_RESOURCE_ATTRIBUTES`, gepusht mit den anderen [Telemetrie-Variablen](#telemetry). Wenn Sie `OTEL_RESOURCE_ATTRIBUTES` im `env`-Block einer Richtlinie setzen, erhalten Terminal-Sitzungen, die diese Richtlinie abgleichen, diesen Wert statt der Labels. Claude Desktop erhält die Labels vom Gateway neben `user.email` und den anderen Identitätsattributen.

999

1000Claude Code kopiert auch jedes Label auf jeden Metrik-Datenpunkt, sodass Sie Metriken in einem Backend, das Ressourcenattribute nicht indiziert, danach filtern können. Um diese Kopie auszuschalten, siehe [Metriken-Kardinalitätskontrolle](/docs/de/monitoring-usage#metrics-cardinality-control).

1001

969<h4 id="export-directly-to-your-collector">1002<h4 id="export-directly-to-your-collector">

970 Direkt an Ihren Collector exportieren1003 Direkt an Ihren Collector exportieren

971</h4>1004</h4>

1036 1069

1037Der `load_test_mode`-Block ermöglicht es Ihnen, ein Gateway zu laden, ohne einen Modell-Anbieter aufzurufen. Während es aktiviert ist, erstellt das Gateway jede Anbieter-Anfrage wie gewohnt, verwirft sie statt sie zu senden, und streamt eine vorgefertigte Antwort durch seinen normalen Antwortpfad zurück. Die Antwort ist Fülltext, der mit einem Satz beginnt, der besagt, dass er vorgefertigt ist.1070Der `load_test_mode`-Block ermöglicht es Ihnen, ein Gateway zu laden, ohne einen Modell-Anbieter aufzurufen. Während es aktiviert ist, erstellt das Gateway jede Anbieter-Anfrage wie gewohnt, verwirft sie statt sie zu senden, und streamt eine vorgefertigte Antwort durch seinen normalen Antwortpfad zurück. Die Antwort ist Fülltext, der mit einem Satz beginnt, der besagt, dass er vorgefertigt ist.

1038 1071

1039Erfordert v2.1.283 oder später. Frühere Versionen weigern sich zu starten, wenn der Schlüssel gesetzt ist, daher aktualisieren Sie jedes Replikat, bevor Sie den Block hinzufügen, und entfernen Sie ihn, bevor Sie zurückrollen.1072Erfordert Claude Code v2.1.282 oder später auf dem Gateway-Server. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Block hinzufügen, und entfernen Sie den Block, bevor Sie zurückrollen.

1040 1073

1041Das Beispiel unten schaltet den Modus mit den Standardwerten ein, eine Antwort von 750 Ausgabe-Token, die über etwa 10 Sekunden gestreamt werden:1074Das Beispiel unten schaltet den Modus mit den Standardwerten ein, eine Antwort von ungefähr 750 Token Text, die über etwa 10 Sekunden gestreamt werden:

1042 1075

1043```yaml theme={null}1076```yaml theme={null}

1044load_test_mode:1077load_test_mode:

1055 1088

1056Ein Lasttest in diesem Modus deckt das Gateway, Ihre Postgres und alles vor dem Gateway ab. Es deckt die Grenzen, Geschwindigkeit oder den Netzwerkpfad des Anbieters nicht ab.1089Ein Lasttest in diesem Modus deckt das Gateway, Ihre Postgres und alles vor dem Gateway ab. Es deckt die Grenzen, Geschwindigkeit oder den Netzwerkpfad des Anbieters nicht ab.

1057 1090

1058Während der Modus aktiviert ist, kann eine Anfrage einen `x-load-test-user`-Header tragen, der eine ganze Zahl von bis zu sieben Ziffern hält, und das Gateway zählt jede Zahl als einen separaten Entwickler mit der E-Mail und den Gruppen des Entwicklers, dessen Token mit der Anfrage kam. Geben Sie der Load-Test-Bereitstellung ihre eigene leere Datenbank, da das Gateway sich weigert zu starten, wenn der Modus gegen eine Datenbank aktiviert ist, in der ein Entwickler bereits etwas ausgegeben hat.1091Keine Modell-Anfrage wird an den Anbieter gesendet, daher ist die CPU pro Anfrage eines Replikats eine Schätzung und liest niedriger als Produktion, die auch ihren Datenverkehr zum Anbieter verschlüsselt. Bestätigen Sie eine Replikat-Anzahl mit einem kleinen Piloten gegen den echten Anbieter. Vor v2.1.283 liest die Schätzung viel niedriger.

1092

1093Während der Modus aktiviert ist, kann eine Anfrage einen `x-load-test-user`-Header tragen, der eine ganze Zahl von bis zu sieben Ziffern hält. Das Gateway zählt jede Zahl als einen separaten Entwickler mit der E-Mail und den Gruppen des Entwicklers, dessen Token mit der Anfrage kam.

1094

1095Geben Sie der Load-Test-Bereitstellung ihre eigene leere Datenbank, da das Gateway sich weigert zu starten, wenn der Modus gegen eine Datenbank aktiviert ist, in der ein Entwickler bereits etwas ausgegeben hat.

1059 1096

1060<Warning>1097<Warning>

1061 Schalten Sie dies niemals für ein Gateway ein, das Entwickler verwenden. Jede Anfrage erhält die vorgefertigte Antwort und kein Modell wird aufgerufen. Das Gateway protokolliert eine `load_test_mode is on`-Warnung beim Start und markiert jedes `inference`-[Audit-Ereignis](/docs/de/claude-apps-gateway-deploy#logs) mit `load_test: true`, während der Modus aktiviert ist.1098 Schalten Sie dies niemals für ein Gateway ein, das Entwickler verwenden. Jede Anfrage erhält die vorgefertigte Antwort und kein Modell wird aufgerufen. Das Gateway protokolliert eine `load_test_mode is on`-Warnung beim Start und markiert jedes `inference`-[Audit-Ereignis](/docs/de/claude-apps-gateway-deploy#logs) mit `load_test: true`, während der Modus aktiviert ist.

claude-apps-gateway-deploy.md +16 −4

Details

181 Integrität181 Integrität

182</h3>182</h3>

183 183

184Das Gateway bedient `GET /healthz` als Liveness-Probe und `GET /readyz` als Readiness-Probe; `/readyz` überprüft, dass der Store erreichbar ist. Beide sind von `access_control.allow_cidrs` ausgenommen, daher funktionieren Proben auf einem abgesperrten Listener.184Das Gateway bedient `GET /healthz` als Liveness-Probe und `GET /readyz` als Readiness-Probe. `/readyz` überprüft, dass der Store erreichbar ist. Wenn Sie [`store.readiness_grace_seconds`](/docs/de/claude-apps-gateway-config#store) setzen, meldet `/readyz` bis zu so viele Sekunden lang bereit, nachdem der Store nicht mehr antwortet.

185

186Beide Endpunkte sind von `access_control.allow_cidrs` ausgenommen, daher funktionieren Proben auf einem abgesperrten Listener.

185 187

186Das OAuth-Discovery-Dokument unter `/.well-known/oauth-authorization-server` gibt auch `200` nur zurück, nachdem Konfigurationslast, OIDC-Erkennung, Upstream-Client-Konstruktion und Postgres-Migration alle erfolgreich sind, daher dient es auch als End-to-End-Boot-Prüfung.188Das OAuth-Discovery-Dokument unter `/.well-known/oauth-authorization-server` gibt auch `200` nur zurück, nachdem Konfigurationslast, OIDC-Erkennung, Upstream-Client-Konstruktion und Postgres-Migration alle erfolgreich sind, daher dient es auch als End-to-End-Boot-Prüfung.

187 189

217* **Bestehende Sitzungen**: Bearer-Tokens validieren lokal mit dem JWT-Geheimnis, Sitzungs-Refreshes berühren den Store nicht, und der Gateway-Prozess kann immer noch Inferenz bedienen219* **Bestehende Sitzungen**: Bearer-Tokens validieren lokal mit dem JWT-Geheimnis, Sitzungs-Refreshes berühren den Store nicht, und der Gateway-Prozess kann immer noch Inferenz bedienen

218* **Neue Anmeldungen**: schlagen fehl, bis Postgres wiederhergestellt ist, da der Device-Flow und seine Rate-Limit-Zähler in Postgres leben220* **Neue Anmeldungen**: schlagen fehl, bis Postgres wiederhergestellt ist, da der Device-Flow und seine Rate-Limit-Zähler in Postgres leben

219* **[Spend-Limit-Durchsetzung](/docs/de/claude-apps-gateway-spend-limits#postgres-availability)**: schlägt während des Ausfalls offen fehl, daher fließt Inferenz weiterhin; schalten Sie es auf Fail-Closed um, wenn Sie lieber blockieren als ungemessen laufen möchten221* **[Spend-Limit-Durchsetzung](/docs/de/claude-apps-gateway-spend-limits#postgres-availability)**: schlägt während des Ausfalls offen fehl, daher fließt Inferenz weiterhin; schalten Sie es auf Fail-Closed um, wenn Sie lieber blockieren als ungemessen laufen möchten

220* **Readiness**: `/readyz` meldet während des Ausfalls nicht bereit, daher entfernen Orchestratoren, die Verkehr auf Readiness gating, jede Replikation auf einmal aus der Rotation. In dieser Topologie schlägt der gesamte Verkehr, einschließlich Inferenz, die das Gateway immer noch bedienen könnte, beim Load Balancer fehl, bis Postgres wiederhergestellt ist. Die Liveness-Probe auf `/healthz` bleibt bestehen, daher werden Replikationen nicht neu gestartet. Zeigen Sie die Readiness-Probe statt auf `/healthz`, wenn Sie lieber möchten, dass angemeldete Entwickler durch einen Store-Ausfall weiterarbeiten; die Kosten sind, dass neue Anmeldungen gegen eine Replikation fehlschlagen, die immer noch bereit meldet.222* **Readiness**: standardmäßig meldet `/readyz` nicht bereit, sobald Postgres unerreichbar ist, daher schlägt jede Replikation ihre Readiness-Prüfung auf einmal fehl. Wo Verkehr nur Replikationen erreicht, die die Prüfung bestehen, schlägt der gesamte Verkehr, einschließlich Inferenz, die das Gateway immer noch bedienen könnte, beim Load Balancer fehl, bis Postgres wiederhergestellt ist. Die Liveness-Probe auf `/healthz` bleibt bestehen.

223

224Wenn Ihr IdP ausfällt, funktionieren bestehende Sitzungen bis `ttl_hours` und neue Anmeldungen schlagen fehl. Eine Sitzungs-Aktualisierung erhält eine Wiederholungsantwort und funktioniert, sobald der IdP wieder verfügbar ist. Setzen Sie eine längere `ttl_hours`, wenn Ihr IdP häufige Wartungsfenster hat.

225

226<h4 id="readiness-grace-period">

227 Readiness-Grace-Periode

228</h4>

229

230Um angemeldete Entwickler durch einen kurzen Postgres-Ausfall wie ein Datenbank-Failover arbeiten zu lassen, setzen Sie [`store.readiness_grace_seconds`](/docs/de/claude-apps-gateway-config#store) länger als das Failover dauert, zum Beispiel `300`. Mit Spend-Limits an und dem Standard-Fail-Open-Verhalten sind Anfragen durch eine Replikation, die bereit bleibt, ungemessen, bis Postgres wiederhergestellt ist, daher halten Sie den Wert so niedrig, wie er Ihr Failover abdeckt. Wenn Sie [`enforcement.fail_closed_on_error: true`](/docs/de/claude-apps-gateway-config#enforcement) setzen, weigert sich das Gateway, angemeldete Entwickler-Inferenz mit der `429` `spend limit unavailable`-Nachricht zu bedienen, bis Postgres wiederhergestellt ist, auch während Replikationen immer noch ihre Readiness-Prüfung bestehen.

231

232Die Einstellung erfordert Claude Code v2.1.282 oder später auf dem Gateway-Server. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet, daher aktualisieren Sie jede Replikation, bevor Sie ihn hinzufügen. [Upgrades](#upgrades) behandelt das Rollback.

221 233

222Wenn Ihr IdP ausfällt, funktionieren bestehende Sitzungen bis `ttl_hours`, neue Anmeldungen schlagen fehl, und eine Sitzungs-Aktualisierung erhält eine Wiederholungsantwort und funktioniert, sobald der IdP wieder verfügbar ist. Setzen Sie eine längere `ttl_hours`, wenn Ihr IdP häufige Wartungsfenster hat.234Wenn Sie die Readiness-Probe statt auf `/healthz` zeigen, bestehen Replikationen auch ihre Prüfung durch einen Ausfall, aber `/healthz` meldet nie nicht bereit, daher bleibt eine Replikation, deren Postgres-Verbindung sich nicht erholt, auch bestehen.

223 235

224<h3 id="jwt-secret-rotation">236<h3 id="jwt-secret-rotation">

225 JWT-Geheimnisrotation237 JWT-Geheimnisrotation

357| Die Anfragen eines Entwicklers schlagen mit `Not signed in to the Cloud gateway — run /login.` fehl | Die verwalteten Einstellungen der Maschine setzen `forceLoginMethod: "gateway"` oder `forceLoginGatewayUrl`, und die Sitzung hat keine Gateway-Anmeldung. Eine verbleibende claude.ai-Anmeldung erfüllt die Anforderung nicht. | Lassen Sie den Entwickler `/login` ausführen und die Gateway-Anmeldung abschließen. Siehe auch [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |369| Die Anfragen eines Entwicklers schlagen mit `Not signed in to the Cloud gateway — run /login.` fehl | Die verwalteten Einstellungen der Maschine setzen `forceLoginMethod: "gateway"` oder `forceLoginGatewayUrl`, und die Sitzung hat keine Gateway-Anmeldung. Eine verbleibende claude.ai-Anmeldung erfüllt die Anforderung nicht. | Lassen Sie den Entwickler `/login` ausführen und die Gateway-Anmeldung abschließen. Siehe auch [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |

358| Claude Desktop meldet, dass seine Bootstrap-Konfiguration nicht abgerufen werden konnte | `/user/bootstrap` gab 404 zurück: die Richtlinie, die dem Benutzer entspricht, trägt keinen `desktop`-Schlüssel, oder es wurde keine Richtlinie gefunden. Das Gateway-Audit-Protokoll zeichnet jede Ablehnung als `desktop_bootstrap.denied` mit dem Grund auf. | Fügen Sie einen `desktop`-Block zur Richtlinie hinzu, die dem Benutzer entspricht, oder zur `match: {}`-Basisebene; ein leeres `desktop: {}` reicht aus. Siehe [Claude-Desktop-Overlay](/docs/de/claude-apps-gateway-config#claude-desktop-overlay). |370| Claude Desktop meldet, dass seine Bootstrap-Konfiguration nicht abgerufen werden konnte | `/user/bootstrap` gab 404 zurück: die Richtlinie, die dem Benutzer entspricht, trägt keinen `desktop`-Schlüssel, oder es wurde keine Richtlinie gefunden. Das Gateway-Audit-Protokoll zeichnet jede Ablehnung als `desktop_bootstrap.denied` mit dem Grund auf. | Fügen Sie einen `desktop`-Block zur Richtlinie hinzu, die dem Benutzer entspricht, oder zur `match: {}`-Basisebene; ein leeres `desktop: {}` reicht aus. Siehe [Claude-Desktop-Overlay](/docs/de/claude-apps-gateway-config#claude-desktop-overlay). |

359| Startup zeigt `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | Der installierte Claude-Code-Build ist älter als die Gateway-Unterstützung | Lassen Sie den Entwickler Claude Code auf eine Version aktualisieren, die Cloud-Gateway-Unterstützung enthält |371| Startup zeigt `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | Der installierte Claude-Code-Build ist älter als die Gateway-Unterstützung | Lassen Sie den Entwickler Claude Code auf eine Version aktualisieren, die Cloud-Gateway-Unterstützung enthält |

360| Startup beendet mit `Administrator policy requires a Cloud gateway sign-in on this machine` | Die Umgebung des Entwicklers setzt `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN`, ihre Einstellungen konfigurieren einen [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper), oder ein API-Schlüssel aus einer früheren Claude-Console-Anmeldung ist noch gespeichert | Lassen Sie den Entwickler jeden löschen, der zutrifft: die Variable aufheben, den `apiKeyHelper`-Eintrag entfernen, oder `claude auth logout` ausführen, um den gespeicherten Schlüssel zu entfernen. Dann lassen Sie ihn `claude` starten und sich mit `/login` anmelden. Siehe auch [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |372| Startup beendet mit `Administrator policy requires a Cloud gateway sign-in on this machine` | Die Umgebung des Entwicklers setzt `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN`, ihre Einstellungen konfigurieren einen [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper), oder ein API-Schlüssel aus einer früheren Claude-Console-Anmeldung ist noch gespeichert | Lassen Sie den Entwickler jeden löschen, der zutrifft: die Variable aufheben, den `apiKeyHelper`-Eintrag entfernen, oder `claude auth logout` ausführen, um den gespeicherten Schlüssel zu entfernen. Eine Sitzung, die einen Cloud-Provider mit `CLAUDE_CODE_USE_*` auswählt, startet dann ohne Anmeldung; für jede andere Sitzung lassen Sie ihn `claude` starten und sich mit `/login` anmelden. Siehe auch [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |

361| Startup oder `/login` meldet `Claude Code may not be enabled for your organization` nach einer 403 beim Laden der verwalteten Einstellungen | Das Gateway oder etwas davor hat die `/managed/settings`-Anfrage mit 403 beantwortet. Die Gateway-eigene Einstellungsroute antwortet niemals mit 403. Der Status stammt von den [`access_control`](/docs/de/claude-apps-gateway-config#http-tuning)-IP-Überprüfungen oder von einem Proxy oder WAF vor dem Gateway. Das Audit-Protokoll zeichnet eine IP-Überprüfungs-Ablehnung als `access.denied` mit dem Grund auf. Der Entwickler bleibt angemeldet. | Überprüfen Sie das Audit-Protokoll auf `access.denied` zum Zeitpunkt des Fehlers und beheben Sie die `access_control`-Listen oder das Front-End, dann lassen Sie den Entwickler `claude` erneut starten |373| Startup oder `/login` meldet `Claude Code may not be enabled for your organization` nach einer 403 beim Laden der verwalteten Einstellungen | Das Gateway oder etwas davor hat die `/managed/settings`-Anfrage mit 403 beantwortet. Die Gateway-eigene Einstellungsroute antwortet niemals mit 403. Der Status stammt von den [`access_control`](/docs/de/claude-apps-gateway-config#http-tuning)-IP-Überprüfungen oder von einem Proxy oder WAF vor dem Gateway. Das Audit-Protokoll zeichnet eine IP-Überprüfungs-Ablehnung als `access.denied` mit dem Grund auf. Der Entwickler bleibt angemeldet. | Überprüfen Sie das Audit-Protokoll auf `access.denied` zum Zeitpunkt des Fehlers und beheben Sie die `access_control`-Listen oder das Front-End, dann lassen Sie den Entwickler `claude` erneut starten |

362| CLI `/login`: `The gateway is limiting sign-in attempts right now`, oder `Request failed with status code 429` bei älteren Versionen. Die `/device`-Seite kann `Too many attempts` für Entwickler anzeigen, die es noch nicht versucht haben | Das Pro-IP-Anmeldungs-Ratenlimit wurde erreicht. Entweder deckt `listen.trusted_proxies` den Load-Balancer nicht ab, daher teilen alle Entwickler seine Adresse, oder viele Entwickler teilen eine NAT- oder VPN-Ausgangsadresse. Audit-Ereignisse mit `result: rate_limited` zeigen dieselbe eine oder wenige `client_ip`-Werte. | Setzen Sie `listen.trusted_proxies` zuerst auf die Quellbereiche des Load-Balancers, dann erhöhen Sie `rate_limits`, wenn Entwickler immer noch Adressen teilen. Siehe [Große Rollouts](#large-rollouts). |374| CLI `/login`: `The gateway is limiting sign-in attempts right now`, oder `Request failed with status code 429` bei älteren Versionen. Die `/device`-Seite kann `Too many attempts` für Entwickler anzeigen, die es noch nicht versucht haben | Das Pro-IP-Anmeldungs-Ratenlimit wurde erreicht. Entweder deckt `listen.trusted_proxies` den Load-Balancer nicht ab, daher teilen alle Entwickler seine Adresse, oder viele Entwickler teilen eine NAT- oder VPN-Ausgangsadresse. Audit-Ereignisse mit `result: rate_limited` zeigen dieselbe eine oder wenige `client_ip`-Werte. | Setzen Sie `listen.trusted_proxies` zuerst auf die Quellbereiche des Load-Balancers, dann erhöhen Sie `rate_limits`, wenn Entwickler immer noch Adressen teilen. Siehe [Große Rollouts](#large-rollouts). |

363| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Der Gateway-Hostname wird zu mindestens einer öffentlichen IP-Adresse aufgelöst. Claude Code überprüft jede aufgelöste Adresse und erfordert, dass jede privat ist. Eine häufige Ursache ist ein Dual-Stack-Name, bei dem eine Familie zu einer öffentlichen Adresse aufgelöst wird, einschließlich AWS-interner Dual-Stack-Load-Balancer, die öffentliche AAAA-Adressen zurückgeben. | Lassen Sie den Gateway-Namen nur zu privaten Adressen auf Entwicklermaschinen auflösen. Für einen Dual-Stack-Namen löschen Sie den öffentlichen Datensatz oder bedienen Sie einen separaten internen DNS-Namen. Siehe die [Private-Network-Voraussetzung](/docs/de/claude-apps-gateway#prerequisites). Wenn die Adresse öffentlicher Adressraum ist, den Ihre Organisation besitzt und intern nutzt, [deklarieren Sie diesen Block](/docs/de/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) stattdessen. |375| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Der Gateway-Hostname wird zu mindestens einer öffentlichen IP-Adresse aufgelöst. Claude Code überprüft jede aufgelöste Adresse und erfordert, dass jede privat ist. Eine häufige Ursache ist ein Dual-Stack-Name, bei dem eine Familie zu einer öffentlichen Adresse aufgelöst wird, einschließlich AWS-interner Dual-Stack-Load-Balancer, die öffentliche AAAA-Adressen zurückgeben. | Lassen Sie den Gateway-Namen nur zu privaten Adressen auf Entwicklermaschinen auflösen. Für einen Dual-Stack-Namen löschen Sie den öffentlichen Datensatz oder bedienen Sie einen separaten internen DNS-Namen. Siehe die [Private-Network-Voraussetzung](/docs/de/claude-apps-gateway#prerequisites). Wenn die Adresse öffentlicher Adressraum ist, den Ihre Organisation besitzt und intern nutzt, [deklarieren Sie diesen Block](/docs/de/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) stattdessen. |

claude-apps-gateway-on-aws.md +3 −1

Details

255 255

256 store:256 store:

257 postgres_url: ${GATEWAY_POSTGRES_URL} # EKS: ${file:/secrets/postgres-url}257 postgres_url: ${GATEWAY_POSTGRES_URL} # EKS: ${file:/secrets/postgres-url}

258 # readiness_grace_seconds: 300 # halten Sie den Health-Check

259 # durch ein RDS-Failover bestehen

258 260

259 upstreams:261 upstreams:

260 - provider: bedrock262 - provider: bedrock

423 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"425 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"

424 ```426 ```

425 427

426 Die 60-Sekunden-Gnadenfrist gibt einer kalten Task Zeit, das Image zu ziehen, sich mit dem Store zu verbinden und seinen ersten Health-Check zu beantworten, bevor ECS beginnt, Fehler gegen die Bereitstellung zu zählen. Der Health-Check der Zielgruppe auf `GET /readyz` überprüft, ob der Store erreichbar ist, daher kommt eine Task, die Postgres nicht erreichen kann, nie in Rotation; siehe [Ausfallverhalten](/docs/de/claude-apps-gateway-deploy#outage-behavior) für den Tradeoff und die `/healthz` Alternative.428 Die 60-Sekunden-Gnadenfrist gibt einer kalten Task Zeit, das Image zu ziehen, sich mit dem Store zu verbinden und seinen ersten Health-Check zu beantworten, bevor ECS beginnt, Fehler gegen die Bereitstellung zu zählen. Der Health-Check der Zielgruppe auf `GET /readyz` überprüft, ob der Store erreichbar ist, daher kommt eine Task, die Postgres nicht erreichen kann, nie in Rotation. Um Tasks durch einen kurzen Datenbankausfall wie ein RDS-Failover hindurch den Health-Check bestehen zu lassen, setzen Sie `store.readiness_grace_seconds` wie in [Ausfallverhalten](/docs/de/claude-apps-gateway-deploy#outage-behavior) beschrieben, das auch die `/healthz` Alternative abdeckt.

427 429

428 Die Tasks laufen in privaten Subnetzen ohne öffentliche IP, daher geht der gesamte Egress (zu Bedrock, Ihrem IdP, Secrets Manager, ECR und CloudWatch Logs) durch das NAT-Gateway. Um Bedrock-Verkehr vom öffentlichen Pfad zu halten, erstellen Sie einen `bedrock-runtime` Interface VPC-Endpunkt und zeigen Sie die `base_url` des Upstream darauf, wie in der [Bedrock Upstream-Referenz](/docs/de/claude-apps-gateway-config#amazon-bedrock) gezeigt; der IdP benötigt immer noch Internet-Egress.430 Die Tasks laufen in privaten Subnetzen ohne öffentliche IP, daher geht der gesamte Egress (zu Bedrock, Ihrem IdP, Secrets Manager, ECR und CloudWatch Logs) durch das NAT-Gateway. Um Bedrock-Verkehr vom öffentlichen Pfad zu halten, erstellen Sie einen `bedrock-runtime` Interface VPC-Endpunkt und zeigen Sie die `base_url` des Upstream darauf, wie in der [Bedrock Upstream-Referenz](/docs/de/claude-apps-gateway-config#amazon-bedrock) gezeigt; der IdP benötigt immer noch Internet-Egress.

429 431

claude-apps-gateway-on-gcp.md +2 −0

Details

179 179

180 store:180 store:

181 postgres_url: ${GATEWAY_POSTGRES_URL} # GKE: ${file:/secrets/postgres-url}181 postgres_url: ${GATEWAY_POSTGRES_URL} # GKE: ${file:/secrets/postgres-url}

182 # readiness_grace_seconds: 300 # keep passing the readiness probe

183 # through a Cloud SQL failover

182 184

183 upstreams:185 upstreams:

184 - provider: vertex186 - provider: vertex

claude-apps-gateway-spend-limits.md +19 −17

Details

55 Wie die Durchsetzung funktioniert55 Wie die Durchsetzung funktioniert

56</h2>56</h2>

57 57

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

59 59

60Die Nachricht benennt den Zeitraum und die Rücksetzeit, z. B. `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, gefolgt von Ihrer [`admin.blocked_message`](/docs/de/claude-apps-gateway-config#admin), falls gesetzt. Wenn ein Entwickler mehrere Limits gleichzeitig überschreitet, benennt die Nachricht das Limit, das zuletzt zurückgesetzt wird. Die Antwort enthält auch einen `retry-after`-Header mit den Sekunden bis zu diesem Zurücksetzen. Vor v2.1.225 auf dem Gateway-Server war die Nachricht `spend limit reached` ohne Zeitraum, Rücksetzeit oder `retry-after`-Header.60Die Nachricht nennt den Zeitraum und die Rücksetzeit, z. B. `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, gefolgt von Ihrer [`admin.blocked_message`](/docs/de/claude-apps-gateway-config#admin), falls gesetzt. Wenn ein Entwickler mehrere Limits gleichzeitig überschreitet, nennt die Nachricht das Limit, das zuletzt zurückgesetzt wird. Die Antwort enthält auch einen `retry-after`-Header mit den Sekunden bis zu diesem Zurücksetzen. Vor v2.1.225 auf dem Gateway-Server war die Nachricht `spend limit reached` ohne Zeitraum, Rücksetzeit oder `retry-after`-Header.

61 61

~~62Bei v2.1.227 oder später listet die Protokollreferenz unter `<public_url>/protocol` auch die genauen Response-Header für Nutzungslimits und den `429`-Body auf.~~62Ab v2.1.227 listet die Protokollreferenz unter `<public_url>/protocol` auch die genauen Antwortheader für Nutzungslimits und den `429`-Body auf.

63 63

64Limits werden an UTC-Kalendergrenzen zurückgesetzt: täglich um 00:00 UTC, wöchentlich am Montag und monatlich am ersten. Das Gateway blockiert niemals `/v1/messages/count_tokens`, da Token-Zählung kostenlos ist.64Limits werden an UTC-Kalendergrenzen zurückgesetzt: täglich um 00:00 UTC, wöchentlich am Montag und monatlich am ersten. Das Gateway blockiert `/v1/messages/count_tokens` nie, da Token-Zählung kostenlos ist.

65 65

66<h3 id="how-requests-are-priced">66<h3 id="how-requests-are-priced">

67 Wie Anfragen bepreist werden67 Wie Anfragen bepreist werden

68</h3>68</h3>

69 69

70Nach jeder Antwort liest ein Nutzungsmesser die Token-Zählungen und addiert die Kosten zu den täglichen, wöchentlichen und monatlichen Zählern. Er berührt niemals die an den Client gesendeten Bytes, daher kann ein Messfehler eine Antwort nicht unterbrechen. Die Beträge sind USD-Schätzungen, ein Schutzschalter statt einer Rechnung; für die Abrechnung gleichen Sie gegen die Nutzungsberichterstattung Ihres Anbieters ab.70Nach jeder Antwort liest ein Nutzungszähler die Token-Anzahlen und addiert die Kosten zu den täglichen, wöchentlichen und monatlichen Zählern. Er berührt nie die an den Client gesendeten Bytes, daher kann ein Messfehler eine Antwort nicht unterbrechen. Die Beträge sind USD-Schätzungen, ein Schutzschalter statt einer Rechnung; für die Abrechnung gleichen Sie gegen die Nutzungsberichte Ihres Anbieters ab.

71 71

~~72Der Messer wählt die Sätze jeder Anfrage in dieser Reihenfolge:~~72Der Zähler wählt die Sätze jeder Anfrage in dieser Reihenfolge:

73 73

741. Eine passende [`pricing.overrides`](/docs/de/claude-apps-gateway-config#pricing)-Zeile für den Upstream, der die Anfrage bedient hat. Erfordert v2.1.227 oder später.741. Eine passende [`pricing.overrides`](/docs/de/claude-apps-gateway-config#pricing)-Zeile für den Upstream, der die Anfrage bedient hat. Erfordert v2.1.227 oder später.

752. Listenpreis für die Upstream-Modell-ID, die Zeichenkette, die das Gateway an den Anbieter sendet, wenn die Claude Code-Kostenentabelle sie erkennt. Die Tabelle akzeptiert Anthropic-, Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-ID-Formen.752. Listenpreis für die Upstream-Modell-ID, die Zeichenkette, die das Gateway an den Anbieter sendet, wenn die Claude Code-Kostentabelle sie erkennt. Die Tabelle akzeptiert Anthropic-, Amazon Bedrock-, Google Cloud Agent Platform- und Microsoft Foundry-ID-Formate.

763. Listenpreis für die [`models[].id`](/docs/de/claude-apps-gateway-config#models), die Sie dieser Upstream-ID zugeordnet haben, für Upstream-Zeichenketten, die keinen Modellnamen enthalten, wie ein Amazon Bedrock-Anwendungs-Inferenz-Profil-ARN oder ein Microsoft Foundry-Bereitstellungsname. Erfordert v2.1.218 oder später.763. Listenpreis für die [`models[].id`](/docs/de/claude-apps-gateway-config#models), die Sie dieser Upstream-ID zugeordnet haben, für Upstream-Zeichenketten, die keinen Modellnamen enthalten, z. B. ein Amazon Bedrock-Application-Inference-Profile-ARN oder einen Microsoft Foundry-Bereitstellungsnamen. Erfordert v2.1.218 oder später.

774. Die Tier für unbekannte Modelle von \$5/\$25 pro Million Input-/Output-Token, daher ist eine ID, die der Messer nicht einordnen kann, niemals kostenlos. Das Gateway warnt beim Start und einmal pro ID zur Laufzeit, wenn es diese Tier verwendet.774. Die Stufe für unbekannte Modelle von \$5/\$25 pro Million Input-/Output-Token, sodass eine ID, die der Zähler nicht einordnen kann, nie kostenlos ist. Das Gateway warnt beim Start und einmal pro ID zur Laufzeit, wenn es diese Stufe verwendet.

78 78

~~79Welcher Satz auch immer gilt, multipliziert der Messer den Betrag dann mit [`pricing.multiplier`](/docs/de/claude-apps-gateway-config#pricing), Standard `1`.~~79Welcher Satz auch gilt, der Zähler multipliziert den Betrag dann mit [`pricing.multiplier`](/docs/de/claude-apps-gateway-config#pricing), Standard `1`.

80 80

81Client-Abbrüche werden auch abgerechnet. Wenn ein Stream ohne den finalen Nutzungs-Frame des Upstream endet, rechnet der Messer eine Untergrenze von etwa vier Zeichen pro Output-Token für den bereits an den Client gesendeten Text ab, daher vermeiden Anfragen, die früh abgebrochen werden, nicht die Einhaltung eines Limits.81Client-Abbrüche werden ebenfalls berechnet. Wenn ein Stream ohne den finalen Nutzungsrahmen des Upstream endet, berechnet der Zähler eine Untergrenze von etwa vier Zeichen pro Output-Token für den bereits an den Client gesendeten Text, sodass das vorzeitige Abbrechen von Anfragen ein Limit nicht umgeht.

82 82

83<h3 id="postgres-availability">83<h3 id="postgres-availability">

84 Postgres-Verfügbarkeit84 Postgres-Verfügbarkeit

85</h3>85</h3>

86 86

87Die Vorabprüfung fragt Postgres mit einem Zwei-Sekunden-Timeout ab. Wenn der Speicher nicht erreichbar ist oder das Timeout überschreitet, schlägt die Durchsetzung standardmäßig offen fehl: Die Anfrage wird fortgesetzt, das Gateway protokolliert eine Warnung, und die Antwort enthält keine `anthropic-ratelimit-unified-*`-Header. Setzen Sie [`enforcement.fail_closed_on_error: true`](/docs/de/claude-apps-gateway-config#enforcement), um stattdessen geschlossen fehlzuschlagen, was den gleichen `429 billing_error` mit der Nachricht `spend limit unavailable` und ohne Zeitraum, Rücksetzeit oder `retry-after`-Header zurückgibt. Fail-Open verhindert, dass ein Speicherausfall zu einem Inferenzausfall wird; Fail-Closed garantiert keine nicht gemessenen Ausgaben.87Die Vorabprüfung fragt Postgres mit einem Zwei-Sekunden-Timeout ab. Wenn der Speicher nicht erreichbar ist oder das Timeout überschreitet, schlägt die Durchsetzung standardmäßig offen fehl: Die Anfrage wird fortgesetzt, das Gateway protokolliert eine Warnung, und die Antwort enthält keine `anthropic-ratelimit-unified-*`-Header. Setzen Sie [`enforcement.fail_closed_on_error: true`](/docs/de/claude-apps-gateway-config#enforcement), um stattdessen geschlossen fehlzuschlagen, was denselben `429 billing_error` zurückgibt, aber mit der Nachricht `spend limit unavailable` und ohne Zeitraum, Rücksetzeit oder `retry-after`-Header. Offen-Fehler verhindert, dass ein Speicherausfall zu einem Inferenz-Ausfall wird; geschlossen-Fehler garantiert keine ungemessenen Ausgaben.

89Offen-Fehler hilft nur, während Ihr Load Balancer oder Orchestrator noch Traffic zum Gateway leitet. Siehe [Outage behavior](/docs/de/claude-apps-gateway-deploy#outage-behavior) für `store.readiness_grace_seconds`, das Replikas durch einen kurzen Ausfall hindurch ihren Readiness-Check bestehen lässt.

88 90

89<h3 id="usage-warnings-in-claude-code">91<h3 id="usage-warnings-in-claude-code">

90 Nutzungswarnungen in Claude Code92 Nutzungswarnungen in Claude Code

91</h3>93</h3>

92 94

93Claude Code warnt einen Entwickler, wenn er sich seinem Limit nähert: sobald die Auslastung 75% überschreitet, und erneut über 95% seines am meisten verbrauchten Limits. Wenn das Gateway eine Anfrage blockiert, zeigt Claude Code die `429`-Nachricht des Gateways unverändert an, einschließlich Ihrer `admin.blocked_message`.95Claude Code warnt einen Entwickler, wenn er sich seinem Limit nähert: sobald die Auslastung 75 % überschreitet, und erneut über 95 % seines am meisten verbrauchten Limits. Wenn das Gateway eine Anfrage blockiert, zeigt Claude Code die `429`-Nachricht des Gateways wie sie ist, einschließlich Ihrer `admin.blocked_message`.

94 96

~~95Die Warnung funktioniert mit Response-Headern:~~97Die Warnung funktioniert über Antwortheader:

96 98

97* Mit v2.1.225 oder später auf dem Gateway-Server trägt jede erfolgreiche `/v1/messages`-Antwort für einen Entwickler, der ein Limit hat, seine eigene Limit-Auslastung und Rücksetzeit in den `anthropic-ratelimit-unified-*`-Headern.99* Mit v2.1.225 oder später auf dem Gateway-Server trägt jede erfolgreiche `/v1/messages`-Antwort für einen Entwickler, der ein Limit hat, seine eigene Limit-Auslastung und Rücksetzeit in den `anthropic-ratelimit-unified-*`-Headern.

~~98* Mit v2.1.225 oder später auch auf der Maschine des Entwicklers liest Claude Code die Header und zeigt die Warnung an.~~100* Mit v2.1.225 oder später auch auf der Maschine des Entwicklers liest Claude Code die Header und zeigt die Warnung.

99 101

100Die Header beschreiben immer das eigene Limit des Entwicklers: Das Gateway entfernt die Rate-Limit-Header des Upstream-Anbieters, die Ihre gemeinsame Quote beschreiben, und leitet sie niemals weiter.102Die Header beschreiben immer das eigene Limit des Entwicklers: Das Gateway entfernt die Rate-Limit-Header des Upstream-Anbieters, die Ihre gemeinsame Quote beschreiben, und leitet sie nie weiter.

101 103

102Mit v2.1.251 oder später auf der Maschine des Entwicklers liest Claude Code auch die gleichen Header, um einen **Spend limit**-Balken in `/usage` anzuzeigen, mit dem Prozentsatz ihres verwendeten Limits und wann es zurückgesetzt wird, und um ein `rate_limits.spend_limit`-Objekt zur [Statuszeile](/docs/de/statusline#rate-limit-usage)-Eingabe hinzuzufügen. Claude Code zeigt beide als Prozentsatz statt als Dollarbetrag an und benötigt nichts Neueres als v2.1.225 auf dem Gateway-Server.104Mit v2.1.251 oder später auf der Maschine des Entwicklers liest Claude Code auch dieselben Header, um eine **Spend limit**-Leiste in `/usage` anzuzeigen, mit dem Prozentsatz ihres verwendeten Limits und wann es zurückgesetzt wird, und um ein `rate_limits.spend_limit`-Objekt zur [Statuszeile](/docs/de/statusline#rate-limit-usage)-Eingabe hinzuzufügen. Claude Code zeigt beide als Prozentsatz statt als Dollarbetrag an und benötigt nichts Neueres als v2.1.225 auf dem Gateway-Server.

103 105

104<h2 id="admin-api-reference">106<h2 id="admin-api-reference">

105 Admin-API-Referenz107 Admin-API-Referenz

claude-code-on-the-web.md +6 −3

Details

4 4

5# Claude Code in der Cloud verwenden5# Claude Code in der Cloud verwenden

6 6

7> Führen Sie Claude Code-Sitzungen in der Cloud aus Ihrem Browser, Telefon, Desktop-App oder Terminal aus, verschieben Sie sie mit --cloud und --teleport, und beheben Sie Pull Requests automatisch.7> Führen Sie Claude Code-Sitzungen in der Cloud aus Ihrem Browser, Telefon, Desktop-App oder Terminal aus, verschieben Sie sie mit `--cloud` und `--teleport`, und beheben Sie Pull Requests automatisch.

8 8

9<Note>9<Note>

10 Cloud-Sitzungen sind in Pro-, Max- und Team-Plänen sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen verfügbar.10 Cloud-Sitzungen sind in Pro-, Max- und Team-Plänen sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen verfügbar.

59 59

60Die Installation der Claude GitHub App auf einem Repository ermöglicht auch [Auto-fix](#auto-fix-pull-requests) für Pull Requests darin.60Die Installation der Claude GitHub App auf einem Repository ermöglicht auch [Auto-fix](#auto-fix-pull-requests) für Pull Requests darin.

61 61

62Threads in einem [Projekt](/docs/de/claude-projects) benötigen die App auf jedem Repository, das sie klonen, unabhängig davon, welche Methode Sie zum Verbinden verwendet haben. Siehe [GitHub-Zugriff einrichten](/docs/de/claude-projects#set-up-github-access).62Threads in einem [Projekt](/docs/de/claude-projects) benötigen die Claude GitHub App auf jedem Repository, das sie klonen, unabhängig davon, welche Methode Sie zum Verbinden verwendet haben. Siehe [GitHub-Zugriff einrichten](/docs/de/claude-projects#set-up-github-access).

64In von Anthropic gehosteten Umgebungen bleiben Ihre GitHub-Anmeldedaten verschlüsselt auf Anthropic-Servern und gelangen niemals in die VM einer Sitzung. GitHub-Operationen von der VM gehen durch den [GitHub-Proxy](/docs/de/cloud-environments#github-proxy), der die Anmeldedaten auf der Serverseite anfügt.

63 65

64Informationen dazu, wie `/schedule` den Repository-Zugriff überprüft, bevor eine Routine erstellt wird, finden Sie unter [Repositories und Branch-Berechtigungen](/docs/de/routines#repositories-and-branch-permissions). Siehe [Vom Terminal verbinden](/docs/de/web-quickstart#connect-from-your-terminal) für die `/web-setup`-Anleitung, einschließlich dessen, was `/web-setup` speichert und wie Sie es entfernen.66Informationen dazu, wie `/schedule` den Repository-Zugriff überprüft, bevor eine Routine erstellt wird, finden Sie unter [Repositories und Branch-Berechtigungen](/docs/de/routines#repositories-and-branch-permissions). Siehe [Vom Terminal verbinden](/docs/de/web-quickstart#connect-from-your-terminal) für die `/web-setup`-Anleitung, einschließlich dessen, was `/web-setup` speichert und wie Sie es entfernen.

65 67

135 137

136Wenn Sie `claude --cloud` aus einem Repository ausführen, das kein Git-Remote hat, oder aus einem github.com-Repository, auf dem die Claude GitHub App nicht installiert ist, bündelt Claude Code Ihr lokales Repository und lädt es direkt in die Cloud-Sitzung hoch. Dies gilt auch, wenn Sie GitHub mit `/web-setup` verbunden haben. Das Bündel enthält Ihre vollständige Repository-Historie über alle Branches hinweg, plus nicht committete Änderungen an verfolgten Dateien.138Wenn Sie `claude --cloud` aus einem Repository ausführen, das kein Git-Remote hat, oder aus einem github.com-Repository, auf dem die Claude GitHub App nicht installiert ist, bündelt Claude Code Ihr lokales Repository und lädt es direkt in die Cloud-Sitzung hoch. Dies gilt auch, wenn Sie GitHub mit `/web-setup` verbunden haben. Das Bündel enthält Ihre vollständige Repository-Historie über alle Branches hinweg, plus nicht committete Änderungen an verfolgten Dateien.

137 139

138Auf macOS, Linux und WSL lässt Claude Code nicht committete Änderungen an Dateien, die wie Anmeldedaten oder Schlüssel benannt sind, aus dem Upload weg und benennt die Dateien, die es weggelassen hat. Dies umfasst `.env`-Dateien, Terraform `*.tfvars`-Dateien und Schlüsseldateien wie `id_rsa` und `*.pem`. Die Sitzung startet mit der committeten Version jeder Datei oder ohne die Datei, wenn keine committiert ist. In einem verknüpften Worktree, Submodul oder ähnlichem Layout lädt Claude Code diese Änderungen mit dem Rest hoch und benennt die Dateien, die es hochlädt.140Auf macOS, Linux und WSL lässt Claude Code nicht committete Änderungen an Dateien, die wie Anmeldedaten oder Schlüssel benannt sind, aus dem Upload weg und benennt die Dateien, die es weggelassen hat. Dies umfasst `.env`-Dateien, Terraform `*.tfvars`-Dateien und Schlüsseldateien wie `id_rsa` und `*.pem`. Die Sitzung startet mit der committeten Version jeder Datei oder ohne die Datei, wenn keine committiert ist.

139 141

140Um ein Bündel hochzuladen, auch wenn Claude Code andernfalls vom Remote klonen würde, setzen Sie `CCR_FORCE_BUNDLE=1`:142Um ein Bündel hochzuladen, auch wenn Claude Code andernfalls vom Remote klonen würde, setzen Sie `CCR_FORCE_BUNDLE=1`:

141 143

429Bevor Sie Cloud-Sitzungen für einen Workflow verwenden, berücksichtigen Sie diese Einschränkungen:431Bevor Sie Cloud-Sitzungen für einen Workflow verwenden, berücksichtigen Sie diese Einschränkungen:

430 432

431* **Ratenlimits**: Cloud-Sitzungen teilen Ratenlimits mit allen anderen Claude- und Claude Code-Nutzungen in Ihrem Konto. Das Ausführen mehrerer Aufgaben parallel verbraucht proportional mehr Ratenlimits. Es gibt keine separate Compute-Gebühr für die Cloud-VM.433* **Ratenlimits**: Cloud-Sitzungen teilen Ratenlimits mit allen anderen Claude- und Claude Code-Nutzungen in Ihrem Konto. Das Ausführen mehrerer Aufgaben parallel verbraucht proportional mehr Ratenlimits. Es gibt keine separate Compute-Gebühr für die Cloud-VM.

434* **Zeitlimits**: Befehle, die Claude ausführt, und SessionStart-Hooks haben Standard-Timeouts, die Sie ändern können, und ein Setup-Skript wird nur zwischengespeichert, wenn es in etwa fünf Minuten abgeschlossen wird. Siehe [Zeitlimits](/docs/de/cloud-environments#time-limits)

432* **Repository-Authentifizierung**: Sie können eine Cloud-Sitzung nur in Ihr Terminal ziehen, wenn Sie sich bei demselben Konto authentifizieren435* **Repository-Authentifizierung**: Sie können eine Cloud-Sitzung nur in Ihr Terminal ziehen, wenn Sie sich bei demselben Konto authentifizieren

433* **Plattformbeschränkungen**: Repository-Klonen und Pull Request-Erstellung erfordern GitHub. Selbstgehostete [GitHub Enterprise Server](/docs/de/github-enterprise-server)-Instanzen werden für Team- und Enterprise-Pläne unterstützt. Sie können GitLab, Bitbucket oder andere Nicht-GitHub-Repositories als [lokales Bündel](#send-local-repositories-without-github) zu einer Cloud-Sitzung senden, indem Sie `CCR_FORCE_BUNDLE=1` setzen, aber die Sitzung kann die Ergebnisse nicht zurück zum Remote pushen436* **Plattformbeschränkungen**: Repository-Klonen und Pull Request-Erstellung erfordern GitHub. Selbstgehostete [GitHub Enterprise Server](/docs/de/github-enterprise-server)-Instanzen werden für Team- und Enterprise-Pläne unterstützt. Sie können GitLab, Bitbucket oder andere Nicht-GitHub-Repositories als [lokales Bündel](#send-local-repositories-without-github) zu einer Cloud-Sitzung senden, indem Sie `CCR_FORCE_BUNDLE=1` setzen, aber die Sitzung kann die Ergebnisse nicht zurück zum Remote pushen

434* **Organisations-IP-Allowlist**: Cloud-Sitzungen rufen die Anthropic API von von Anthropic verwalteter Infrastruktur auf, nicht von Ihrem Netzwerk, während Sitzungen in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) sie von Ihrem eigenen Netzwerk aufrufen. Wenn Ihre Organisation [IP-Allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) aktiviert hat, schlägt jede von Anthropic gehostete Cloud-Sitzung mit einem Authentifizierungsfehler fehl. Das gleiche gilt für [Code Review](/docs/de/code-review) und [Routines](/docs/de/routines), die auf von Anthropic gehosteten Umgebungen ausgeführt werden; eine Routine, die zu einer selbstgehosteten Umgebung geleitet wird, ruft die API von Ihrem eigenen Netzwerk auf. Kontaktieren Sie [Anthropic Support](https://support.claude.com/), um von Anthropic gehostete Services von der IP-Allowlist Ihrer Organisation auszunehmen.437* **Organisations-IP-Allowlist**: Cloud-Sitzungen rufen die Anthropic API von von Anthropic verwalteter Infrastruktur auf, nicht von Ihrem Netzwerk, während Sitzungen in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) sie von Ihrem eigenen Netzwerk aufrufen. Wenn Ihre Organisation [IP-Allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) aktiviert hat, schlägt jede von Anthropic gehostete Cloud-Sitzung mit einem Authentifizierungsfehler fehl. Das gleiche gilt für [Code Review](/docs/de/code-review) und [Routines](/docs/de/routines), die auf von Anthropic gehosteten Umgebungen ausgeführt werden; eine Routine, die zu einer selbstgehosteten Umgebung geleitet wird, ruft die API von Ihrem eigenen Netzwerk auf. Kontaktieren Sie [Anthropic Support](https://support.claude.com/), um von Anthropic gehostete Services von der IP-Allowlist Ihrer Organisation auszunehmen.

claude-directory.md +26 −4

Details

1541 Anwendungsdaten1541 Anwendungsdaten

1542</h2>1542</h2>

1543 1543

1544Über die Konfiguration, die Sie erstellen, hinaus, enthält `~/.claude` Daten, die Claude Code während Sitzungen schreibt. Diese Dateien sind Klartext. Alles, das durch ein Tool läuft, landet in einem Transkript auf der Festplatte: Dateiinhalte, Befehlsausgabe, eingefügter Text.1544Über die Konfiguration, die Sie erstellen, hinaus, enthält `~/.claude` Daten, die Claude Code während Sitzungen schreibt. Diese Dateien sind Klartext. Alles, das durch ein Tool läuft, wird in einem Transkript auf der Festplatte geschrieben: Dateiinhalte, Befehlsausgabe, eingefügter Text.

1545 1545

1546<h3 id="cleaned-up-automatically">1546<h3 id="cleaned-up-automatically">

1547 Automatisch bereinigt1547 Automatisch bereinigt

1554| `projects/<project>/<session>.jsonl` | Vollständiges Gesprächstranskript: jede Nachricht, jeder Tool-Aufruf und jedes Tool-Ergebnis |1554| `projects/<project>/<session>.jsonl` | Vollständiges Gesprächstranskript: jede Nachricht, jeder Tool-Aufruf und jedes Tool-Ergebnis |

1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Ein vorheriges Transkript für die Sitzung, das Claude Code beiseite gelegt hat, anstatt es zu überschreiben oder zu löschen. Es wird nicht in der Sitzungsauswahl angezeigt |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Ein vorheriges Transkript für die Sitzung, das Claude Code beiseite gelegt hat, anstatt es zu überschreiben oder zu löschen. Es wird nicht in der Sitzungsauswahl angezeigt |

1556| `projects/<project>/<session>/subagents/` | [Subagent](/docs/de/sub-agents) Gesprächstranskripte, entfernt mit dem übergeordneten Sitzungstranskript, wenn es veraltet |1556| `projects/<project>/<session>/subagents/` | [Subagent](/docs/de/sub-agents) Gesprächstranskripte, entfernt mit dem übergeordneten Sitzungstranskript, wenn es veraltet |

1557| `projects/<project>/<session>/tool-results/` | Große Tool-Ausgaben, die in separate Dateien verschoben werden |1557| `projects/<project>/<session>/tool-results/` | Große Tool-Ausgaben, die in separate Dateien verschoben werden, und vollständige Kopien von [Bildern, die MCP-Tools zurückgeben](/docs/de/mcp#images-in-tool-results) |

1558| `file-history/<session>/` | Vor-Bearbeitungs-Snapshots von Dateien, die Claude geändert hat, verwendet für [Checkpoint-Wiederherstellung](/docs/de/checkpointing). Enthält Snapshots für die 100 neuesten Checkpoints; Snapshot-Dateien, auf die kein beibehaltener Checkpoint verweist, werden gelöscht, außer dem ersten Snapshot jeder Datei |1558| `file-history/<session>/` | Vor-Bearbeitungs-Snapshots von Dateien, die Claude geändert hat, verwendet für [Checkpoint-Wiederherstellung](/docs/de/checkpointing). Enthält Snapshots für die 100 neuesten Checkpoints; Snapshot-Dateien, auf die kein beibehaltener Checkpoint verweist, werden gelöscht, außer dem ersten Snapshot jeder Datei |

1559| `plans/` | Plan-Dateien, die während des [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) geschrieben werden |1559| `plans/` | Plan-Dateien, die während des [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) geschrieben werden |

1560| `debug/` | Pro-Sitzungs-Debug-Logs, geschrieben während Debug-Logging aktiviert ist, z. B. wenn Sie mit [`--debug`](/docs/de/cli-reference#cli-flags) starten oder `/debug` ausführen |1560| `debug/` | Pro-Sitzungs-Debug-Logs, geschrieben während Debug-Logging aktiviert ist, z. B. wenn Sie mit [`--debug`](/docs/de/cli-reference#cli-flags) starten oder `/debug` ausführen |

1582* **Bare-Modus**: Wenn Sie `claude -p` mit [`--bare`](/docs/de/headless#start-faster-with-bare-mode) ausführen, führt Claude Code den Durchlauf in dieser Sitzung nicht aus.1582* **Bare-Modus**: Wenn Sie `claude -p` mit [`--bare`](/docs/de/headless#start-faster-with-bare-mode) ausführen, führt Claude Code den Durchlauf in dieser Sitzung nicht aus.

1583* **Angehaltener Durchlauf**: Wenn Claude Code die Aufbewahrungsfrist nicht sicher bestimmen kann, hält es den Aufbewahrungsbereinigungsdurchlauf an; das [`retention_sweep` Ereignis](/docs/de/monitoring-usage#retention-sweep-event) listet jede Konfiguration auf, die es anhält. Wenn die Ursache eine Einstellungsdatei ist, die nicht gelesen oder analysiert werden kann, oder Einstellungsfehler mit `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` explizit gesetzt, zeigt Claude Code auch eine Warnung in `/status` an, bis Sie die Einstellungsfehler beheben. Wenn [verwaltete Einstellungen](/docs/de/server-managed-settings) `cleanupPeriodDays` bereitstellen, führt Claude Code den Durchlauf in jedem Fall mit dem verwalteten Wert aus.1583* **Angehaltener Durchlauf**: Wenn Claude Code die Aufbewahrungsfrist nicht sicher bestimmen kann, hält es den Aufbewahrungsbereinigungsdurchlauf an; das [`retention_sweep` Ereignis](/docs/de/monitoring-usage#retention-sweep-event) listet jede Konfiguration auf, die es anhält. Wenn die Ursache eine Einstellungsdatei ist, die nicht gelesen oder analysiert werden kann, oder Einstellungsfehler mit `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` explizit gesetzt, zeigt Claude Code auch eine Warnung in `/status` an, bis Sie die Einstellungsfehler beheben. Wenn [verwaltete Einstellungen](/docs/de/server-managed-settings) `cleanupPeriodDays` bereitstellen, führt Claude Code den Durchlauf in jedem Fall mit dem verwalteten Wert aus.

1584 1584

1585<h3 id="session-scratchpad-directory">

1586 Sitzungs-Scratchpad-Verzeichnis

1587</h3>

1588

1589Das Scratchpad ist ein Pro-Sitzungs-Verzeichnis, das Claude Code Claude für temporäre Dateien bereitstellt: Zwischenergebnisse, Hilfsskripte und Entwürfe, die nicht in Ihr Projekt gehören. Wenn Claude sagt, dass es etwas „in das Scratchpad" gespeichert hat, befindet sich die Datei dort. Claude verwendet es anstelle von `/tmp` und kann Dateien darin erstellen, bearbeiten und lesen, ohne eine Berechtigungsaufforderung.

1590

1591Das Scratchpad befindet sich unter Claude Codes temporärem Verzeichnis statt unter `~/.claude`. Finden Sie den aktuellen Sitzungspfad für Ihre Plattform:

1592

1593* **macOS**: `/private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`

1594* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, oder die gleiche Form unter `$TMPDIR`, wenn Ihr System eine setzt

1595* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`

1596

1597`<project>` ist Ihr Arbeitsverzeichnispfad mit jedem Zeichen außer Buchstaben und Ziffern durch `-` ersetzt, z. B. `-Users-you-my-project`. Wenn Sie [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) setzen, bewegt sich der Baum stattdessen unter dieses Verzeichnis. Hooks erhalten den aktuellen Sitzungspfad als [`scratchpad_dir`](/docs/de/hooks#common-input-fields).

1598

1599Scratchpad-Dateien halten so lange wie das Transkript der Sitzung: Der [Aufbewahrungsdurchlauf](#cleaned-up-automatically) löscht das Verzeichnis, wenn es das Transkript löscht, und [`claude project purge`](#clear-local-data) berührt das temporäre Verzeichnis nicht. Da sich das Verzeichnis unter dem System-Temp-Speicherort befindet, kann Ihr Betriebssystem es auch löschen, z. B. beim Neustart. Um etwas zu behalten, das Claude dort geschrieben hat, bitten Sie Claude, es in Ihr Projekt zu verschieben.

1600

1601Eine Sitzung hat ein Scratchpad nur, wenn alle diese Bedingungen erfüllt sind:

1602

1603* Sie sind mit einem claude.ai-Konto angemeldet, nicht mit einem API-Schlüssel

1604* Die Sitzung verwendet die Anthropic API, nicht Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry

1605* [`enableArtifact`](/docs/de/settings-reference#enableartifact) ist nicht auf `false` gesetzt

1606

1585<h3 id="kept-until-you-delete-them">1607<h3 id="kept-until-you-delete-them">

1586 Behalten, bis Sie sie löschen1608 Behalten, bis Sie sie löschen

1587</h3>1609</h3>

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

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

1597| `policy-limits.json` | Zwischengespeicherte Feature-Policy-Einstellungen für Ihre Organisation. Nur für einige Kontotypen vorhanden. Automatisch aktualisiert. Ein `policy-limits.json.stamp.json` Sidecar-Datei zeichnet auf, welches Konto oder API-Schlüssel der Cache gehört. Claude Code löscht beide Dateien beim Abmelden. |1619| `policy-limits.json` | Zwischengespeicherte Feature-Policy-Einstellungen für Ihre Organisation. Nur für einige Kontotypen vorhanden. Automatisch aktualisiert. Eine `policy-limits.json.stamp.json` Sidecar-Datei zeichnet auf, welches Konto oder API-Schlüssel der Cache gehört. Claude Code löscht beide Dateien beim Abmelden. |

1598 1620

1599<span id="state-files-to-keep" />1621<span id="state-files-to-keep" />

1600 1622

1626* Übereinstimmende Prompt-Zeilen in `history.jsonl`1648* Übereinstimmende Prompt-Zeilen in `history.jsonl`

1627* Der Projekteintrag in `~/.claude.json`1649* Der Projekteintrag in `~/.claude.json`

1628 1650

1629Bilder, die Sie in den Sitzungen des Projekts eingefügt oder angehängt haben, werden unter dem temporären Verzeichnis von Claude Code gespeichert, anstatt unter `~/.claude`, daher entfernt der Purge sie nicht. Der [Aufbewahrungsdurchlauf](#cleaned-up-automatically) löscht sie, sobald sie älter als `cleanupPeriodDays` sind.1651Bilder, die Sie in den Sitzungen des Projekts eingefügt oder angehängt haben, und das [Scratchpad](#session-scratchpad-directory) jeder Sitzung werden unter Claude Codes temporärem Verzeichnis gespeichert, anstatt unter `~/.claude`, daher entfernt der Purge sie nicht. Der [Aufbewahrungsdurchlauf](#cleaned-up-automatically) löscht die Bilder, sobald sie älter als `cleanupPeriodDays` sind; das Scratchpad einer bereinigten Sitzung bleibt, bis Sie es löschen oder Ihr Betriebssystem das temporäre Verzeichnis löscht.

1630 1652

1631Der Befehl gibt den vollständigen Löschplan aus und fordert zur Bestätigung auf, bevor etwas entfernt wird.1653Der Befehl gibt den vollständigen Löschplan aus und fordert zur Bestätigung auf, bevor etwas entfernt wird.

1632 1654

claude-projects.md +47 −5

Details

12 12

13Ein Projekt ist ein laufendes Gespräch, in dem Claude einen Strom zusammenhängender Arbeiten für Sie koordiniert. Sie teilen ihm mit, was getan werden muss, und er startet einen Thread für jede Aufgabe.13Ein Projekt ist ein laufendes Gespräch, in dem Claude einen Strom zusammenhängender Arbeiten für Sie koordiniert. Sie teilen ihm mit, was getan werden muss, und er startet einen Thread für jede Aufgabe.

14 14

15Jeder Thread ist normalerweise eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web): Claude Code, das in der Cloud statt auf Ihrem Computer ausgeführt wird. Wenn eine Aufgabe etwas benötigt, das nur Ihr Computer hat, können Sie Claude bitten, diesen Thread stattdessen auf Ihrem Computer durch [Remote Control](/docs/de/remote-control) auszuführen. Threads laufen parallel und Sie können sie von Ihrem Telefon aus überprüfen und steuern. Cloud-Threads laufen weiter, nachdem Sie den Laptop schließen.15Jeder Thread ist normalerweise eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web): Claude Code, das in der Cloud statt auf Ihrem Computer ausgeführt wird. Wenn eine Aufgabe etwas benötigt, das nur Ihr Computer hat, können Sie Claude bitten, [diesen Thread stattdessen auf Ihrem Computer auszuführen](#run-a-thread-on-your-own-computer) durch [Remote Control](/docs/de/remote-control). Threads laufen parallel und Sie können sie von Ihrem Telefon aus überprüfen und steuern. Cloud-Threads laufen weiter, nachdem Sie den Laptop schließen, während ein Thread auf Ihrem Computer nur läuft, während dieser Computer aktiv ist.

16 16

17Ohne ein Projekt bedeutet das Ausführen mehrerer Sitzungen, dass Sie die Koordination selbst übernehmen: Sie entscheiden, woran jede arbeitet, wiederholen denselben Hintergrund am Anfang jeder Sitzung und überprüfen, welche abgeschlossen ist oder eine Antwort benötigt. Mit einem Projekt tun Sie stattdessen:17Ohne ein Projekt bedeutet das Ausführen mehrerer Sitzungen, dass Sie die Koordination selbst übernehmen: Sie entscheiden, woran jede arbeitet, wiederholen denselben Hintergrund am Anfang jeder Sitzung und überprüfen, welche abgeschlossen ist oder eine Antwort benötigt. Mit einem Projekt tun Sie stattdessen:

18 18

39 Wann etwas anderes besser passt39 Wann etwas anderes besser passt

40</h3>40</h3>

41 41

42Cloud-Threads funktionieren auf GitHub-Repositories und auf Dateien, Ordnern und Google Drive-Ordnern, die Sie in das Projekt hochladen, nicht auf Dateien oder Tools, die nur auf Ihrem Computer vorhanden sind. Wenn eine Aufgabe Ihren Computer benötigt, bitten Sie Claude, seinen Thread dort über [Remote Control](/docs/de/remote-control) auszuführen. [Einschränkungen](#limitations) listet auf, was dafür erforderlich ist. Etwas anderes passt besser in diesen Fällen:42Ein Projekt passt immer noch, wenn nur einige Aufgaben Ihren Computer benötigen. Cloud-Threads funktionieren auf GitHub-Repositories und auf Dateien, Ordnern und Google Drive-Ordnern, die Sie in das Projekt hochladen, und für die gelegentliche Aufgabe, die eine lokale Datenbank oder ein Tool auf Ihrem Computer benötigt, können Sie Claude bitten, [diesen Thread des Projekts auf Ihrem Computer auszuführen](#run-a-thread-on-your-own-computer). Etwas anderes passt besser in diesen Fällen:

43 43

44* **Eine Aufgabe, die in eine Sitzung passt**: „Reparieren Sie den instabilen Login-Test." Starten Sie selbst eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web).44* **Eine Aufgabe, die in eine Sitzung passt**: „Reparieren Sie den instabilen Login-Test." Starten Sie selbst eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web).

45* **Arbeit, bei der jede Aufgabe Ihren Computer benötigt**: eine lokale Datenbank, einen Geräteemulator oder eine API hinter Ihrem VPN. Verwenden Sie eine lokale Sitzung oder [Agent-Ansicht](/docs/de/agent-view), um mehrere gleichzeitig auszuführen. Wenn die Arbeit nur lokale Dateien benötigt, laden Sie sie stattdessen in das Projekt hoch.45* **Arbeit, bei der jede Aufgabe Ihren Computer benötigt**: eine lokale Datenbank, einen Geräteemulator oder eine API hinter Ihrem VPN. Verwenden Sie eine lokale Sitzung oder [Agent-Ansicht](/docs/de/agent-view), um mehrere gleichzeitig auszuführen. Wenn die Arbeit nur lokale Dateien benötigt, laden Sie sie stattdessen in das Projekt hoch.

267* „Sagen Sie mir, was in diesen Repositories falsch ist, und reparieren Sie nichts", wenn Sie die Erkenntnisse durchgehen möchten, bevor einer von ihnen ein Thread wird267* „Sagen Sie mir, was in diesen Repositories falsch ist, und reparieren Sie nichts", wenn Sie die Erkenntnisse durchgehen möchten, bevor einer von ihnen ein Thread wird

268* „Beantworten Sie das hier stattdessen, anstatt einen Thread zu starten", wenn Claude einen Thread für etwas startet, das Sie als schnelle Frage gemeint haben268* „Beantworten Sie das hier stattdessen, anstatt einen Thread zu starten", wenn Claude einen Thread für etwas startet, das Sie als schnelle Frage gemeint haben

269 269

270Claude speichert Voreinstellungen wie diese auf [Projektgedächtnis](#give-a-project-standing-context) selbst und folgt ihnen in späteren Threads. Sie sind Anweisungen, die Claude befolgt, nicht erzwungene Einstellungen, daher ist ein Thread-Limit, das Sie auf diese Weise geben, keine harte Obergrenze. Fügen Sie eines zu Projektanweisungen hinzu, wenn Sie es genau formuliert und auf jeden Thread von Anfang an angewendet haben möchten.270Claude speichert Voreinstellungen wie diese auf [Projektgedächtnis](#give-a-project-standing-context) selbst und folgt ihnen in späteren Cloud-Threads. Sie sind Anweisungen, die Claude befolgt, nicht erzwungene Einstellungen, daher ist ein Thread-Limit, das Sie auf diese Weise geben, keine harte Obergrenze. Fügen Sie eines zu Projektanweisungen hinzu, wenn Sie es genau formuliert und auf jeden Thread von Anfang an angewendet haben möchten.

271 271

272<h3 id="unblock-a-thread-waiting-on-approval">272<h3 id="unblock-a-thread-waiting-on-approval">

273 Entsperren Sie einen Thread, der auf Genehmigung wartet273 Entsperren Sie einen Thread, der auf Genehmigung wartet

277 277

278Jede Genehmigung deckt diese Aufforderung oder den Rest dieses Threads ab, wenn Sie die breitere Option wählen. Um jeden Thread bestimmte Befehle ohne Fragen ausführen zu lassen, oder um einige zu blockieren, fügen Sie [Berechtigungsregeln](/docs/de/permissions) zur `.claude/settings.json` des Repositories hinzu. Threads wenden sie nur in einem Projekt mit einem Repository an; siehe [Was Threads aus Ihren Repositories aufgreifen](#what-threads-pick-up-from-your-repositories).278Jede Genehmigung deckt diese Aufforderung oder den Rest dieses Threads ab, wenn Sie die breitere Option wählen. Um jeden Thread bestimmte Befehle ohne Fragen ausführen zu lassen, oder um einige zu blockieren, fügen Sie [Berechtigungsregeln](/docs/de/permissions) zur `.claude/settings.json` des Repositories hinzu. Threads wenden sie nur in einem Projekt mit einem Repository an; siehe [Was Threads aus Ihren Repositories aufgreifen](#what-threads-pick-up-from-your-repositories).

279 279

280<h3 id="run-a-thread-on-your-own-computer">

281 Führen Sie einen Thread auf Ihrem eigenen Computer aus

282</h3>

283

284Wenn eine Aufgabe etwas benötigt, das nur Ihr Computer hat, wie z. B. eine lokale Datenbank, einen Geräteemulator oder eine API hinter Ihrem VPN, bitten Sie Claude, den Thread für diese Aufgabe auf Ihrem Computer statt in der Cloud auszuführen. Wenn Sie im Projektgespräch fragen, ist der Thread eine Claude Code-Sitzung in einem Ordner auf Ihrem Computer, verbunden über [Remote Control](/docs/de/remote-control). Die anderen Threads des Projekts laufen weiterhin in der Cloud. Im Vergleich zu einem Cloud-Thread arbeitet ein Thread auf Ihrem Computer:

285

286* Mit den Dateien, Tools, MCP-Servern und Claude Code-Einstellungen auf diesem Computer statt mit der Cloud-Umgebung des Projekts

287* Startet mit den Anweisungen des Projekts, aber nicht mit seinen Speicherdateien geladen

288* Läuft nur, während dieser Computer wach ist und Remote Control eingeschaltet ist

289

290<Steps>

291 <Step title="Verbinden Sie den Ordner">

292 Machen Sie auf dem Computer, der den Ordner hat, den die Aufgabe benötigt, ihn auf eine von zwei Arten über Remote Control verfügbar. Beide benötigen Claude Code v2.1.280 oder später auf diesem Computer.

293

294 * **In der Claude Desktop-App**: Öffnen Sie **Einstellungen > Claude Code**, schalten Sie **Diesen Computer von Ihrem Telefon und claude.ai aus verwenden** ein, und fügen Sie den Ordner zur Liste unter diesem Schalter hinzu. Threads können auf diesem Computer ausgeführt werden, während die App offen ist.

295 * **In einem Terminal**: Führen Sie `claude remote-control` im Ordner aus und lassen Sie es laufen.

296 </Step>

297

298 <Step title="Fragen Sie nach der Aufgabe mit „Lokal arbeiten"">

299 Wählen Sie im Projektgespräch **Lokal arbeiten** aus dem **+**-Menü neben dem Nachrichtenfeld, das Ihre Nachricht mit **Lokal** kennzeichnet, und schreiben Sie, was Sie erledigt haben möchten. Zu sagen in der Nachricht, dass die Aufgabe auf Ihrem Computer ausgeführt werden soll, funktioniert auch.

300 </Step>

301

302 <Step title="Erlauben Sie es auf der Karte">

303 Claude antwortet mit einer Karte **Claude erlauben, in einem Ordner auf Ihrem Gerät zu arbeiten**. Wählen Sie den Ordner, wenn Sie mehrere verbunden haben. Klicken Sie dann auf **Einmal erlauben**.

304 </Step>

305</Steps>

306

307Der Thread läuft im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), daher führt Claude Befehle aus und bearbeitet Dateien in diesem Ordner aus, ohne Sie jedes Mal zu fragen. Wenn Auto-Modus auf diesem Computer nicht verfügbar oder ausgeschaltet ist, läuft der Thread ohne ihn, und jede Berechtigungsaufforderung, die er auslöst, wartet auf Ihre Antwort im Thread, wie [Entsperren Sie einen Thread, der auf Genehmigung wartet](#unblock-a-thread-waiting-on-approval) beschreibt.

308

309Während der Thread läuft, zeigt ein Laptop-Symbol in seiner Kopfzeile, ob Ihr Computer verbunden ist. Klicken Sie darauf, um zu sehen, welchen Ordner der Thread verwendet, oder um die Verbindung auszuschalten. Der Thread wird unterbrochen, während dieser Computer schläft, und stoppt, wenn die Desktop-App oder `claude remote-control` beendet wird. [Kontakt zu Ihrem Ordner verloren](#lost-contact-with-your-folder) behandelt, wie Sie es wieder zum Laufen bringen. Schalten Sie in der Desktop-App **Diesen Computer für Remote Control wach halten** unter **Einstellungen > Claude Code** ein, um zu verhindern, dass der Computer von selbst einschläft.

310

311Ein Projekt kann keinen Thread auf Ihrem Computer ausführen, während [**Vertrauenswürdige Geräte erforderlich**](/docs/de/remote-control#trusted-devices) für Ihr Konto aktiviert ist.

312

280<h2 id="give-a-project-standing-context">313<h2 id="give-a-project-standing-context">

281 Einem Projekt Kontext geben314 Einem Projekt Kontext geben

282</h2>315</h2>

441* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) ist Claude in den Slack-Kanälen Ihres Teams, auf Team- und Enterprise-Plänen. Jeder in einem Kanal kann ihm Arbeit geben, jeder im Kanal sieht und lenkt es, und es nutzt Verbindungen, die ein Admin für diesen Kanal eingerichtet hat. Ein Projekt ist nur Ihres: Sie sind der Einzige, der ihm Arbeit gibt oder seine Threads sieht, es nutzt Ihren eigenen GitHub-Zugriff und Connectors, und es ist auf Pro und Max. [Wie sich Claude Tag von Cowork und Claude Code unterscheidet](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) hat die Seite-an-Seite.474* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) ist Claude in den Slack-Kanälen Ihres Teams, auf Team- und Enterprise-Plänen. Jeder in einem Kanal kann ihm Arbeit geben, jeder im Kanal sieht und lenkt es, und es nutzt Verbindungen, die ein Admin für diesen Kanal eingerichtet hat. Ein Projekt ist nur Ihres: Sie sind der Einzige, der ihm Arbeit gibt oder seine Threads sieht, es nutzt Ihren eigenen GitHub-Zugriff und Connectors, und es ist auf Pro und Max. [Wie sich Claude Tag von Cowork und Claude Code unterscheidet](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) hat die Seite-an-Seite.

442* **Cloud-Sitzungen**: Jeder Thread ist eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web), es sei denn, Sie bitten Claude, ihn auf Ihrem Computer auszuführen. In beiden Fällen startet und verfolgt Claude ihn statt Ihnen. Eine Cloud-Sitzung, die Sie selbst gestartet haben, kann ein Projekt werden oder einen durch [**Als Projekt fortfahren** oder **In Projekt verschieben**](#start-from-an-existing-cloud-session) füttern.475* **Cloud-Sitzungen**: Jeder Thread ist eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web), es sei denn, Sie bitten Claude, ihn auf Ihrem Computer auszuführen. In beiden Fällen startet und verfolgt Claude ihn statt Ihnen. Eine Cloud-Sitzung, die Sie selbst gestartet haben, kann ein Projekt werden oder einen durch [**Als Projekt fortfahren** oder **In Projekt verschieben**](#start-from-an-existing-cloud-session) füttern.

443* **Routinen**: Wenn Sie geplante Arbeit in einem Projekt anfordern, erstellt Claude eine [Routine](/docs/de/routines), die als Threads in diesem Projekt läuft und auf seiner Registerkarte **Routinen** angezeigt wird. Routinen, die Sie außerhalb eines Projekts erstellen, laufen weiter auf ihre eigene Weise.476* **Routinen**: Wenn Sie geplante Arbeit in einem Projekt anfordern, erstellt Claude eine [Routine](/docs/de/routines), die als Threads in diesem Projekt läuft und auf seiner Registerkarte **Routinen** angezeigt wird. Routinen, die Sie außerhalb eines Projekts erstellen, laufen weiter auf ihre eigene Weise.

444* **Lokale Sitzungen und Agent-Ansicht**: Eine Sitzung, die Sie selbst in Ihrem Terminal, IDE oder der lokalen Umgebung der Desktop-App starten, kann nicht zu einem Projekt hinzugefügt werden. Ein Projekt erreicht Ihren Computer nur, indem es einen Thread dort durch [Remote Control](/docs/de/remote-control) ausführt. [Agent-Ansicht](/docs/de/agent-view) ist ein Bildschirm zum Verfolgen mehrerer lokaler Sitzungen, die Sie selbst gestartet haben; es hat keinen Koordinator.477* **Remote Control**: [Remote Control](/docs/de/remote-control) verbindet claude.ai mit einer Claude Code-Sitzung, die auf Ihrem Computer läuft. Wenn Sie Claude in einem Projekt bitten, einen Thread auf Ihrem Computer auszuführen, nutzt das Projekt [Remote Control, um dies zu tun](#run-a-thread-on-your-own-computer).

478* **Lokale Sitzungen und Agent-Ansicht**: Eine Sitzung, die Sie selbst in Ihrem Terminal, IDE oder der lokalen Umgebung der Desktop-App starten, kann nicht zu einem Projekt hinzugefügt werden. [Agent-Ansicht](/docs/de/agent-view) ist ein Bildschirm zum Verfolgen mehrerer lokaler Sitzungen nebeneinander, und Sie starten immer noch jede selbst und geben ihr ihre Aufgabe selbst.

445* **Worktrees**: Ein [Worktree](/docs/de/worktrees) gibt jeder lokalen Sitzung ihre eigene Arbeitskopie eines Repositories, daher überschreiben sich parallele Sitzungen auf Ihrem Computer nicht gegenseitig. Cloud-Threads benötigen sie nicht: Jeder klont seine Repositories in seine eigene Cloud-Sandbox und arbeitet auf seinem eigenen Branch.479* **Worktrees**: Ein [Worktree](/docs/de/worktrees) gibt jeder lokalen Sitzung ihre eigene Arbeitskopie eines Repositories, daher überschreiben sich parallele Sitzungen auf Ihrem Computer nicht gegenseitig. Cloud-Threads benötigen sie nicht: Jeder klont seine Repositories in seine eigene Cloud-Sandbox und arbeitet auf seinem eigenen Branch.

446* **Agent-Teams**: Ein [Agent-Team](/docs/de/agent-teams) ist eine Sitzung, die Teammate-Sitzungen für eine einzelne Aufgabe startet, auf Ihrem Computer oder in einer Cloud-Sitzung, und endet mit dieser Aufgabe.480* **Agent-Teams**: Ein [Agent-Team](/docs/de/agent-teams) ist eine Sitzung, die Teammate-Sitzungen für eine einzelne Aufgabe startet, auf Ihrem Computer oder in einer Cloud-Sitzung, und endet mit dieser Aufgabe.

447* **Projekte in claude.ai-Chat und Cowork**: Die [frühere Projekte-Erfahrung](https://support.claude.com/en/articles/9517075-what-are-projects), die Gespräche und Referenzdateien ohne Threads oder einen Koordinator gruppiert. Diese Projekte funktionieren weiterhin wie heute, bis die neu gestaltete Erfahrung sie erreicht.481* **Projekte in claude.ai-Chat und Cowork**: Die [frühere Projekte-Erfahrung](https://support.claude.com/en/articles/9517075-what-are-projects), die Gespräche und Referenzdateien ohne Threads oder einen Koordinator gruppiert. Diese Projekte funktionieren weiterhin wie heute, bis die neu gestaltete Erfahrung sie erreicht.

454 488

455* Projekte sind unter claude.ai/code, in der Desktop-App und in der Claude Mobile-App verfügbar, nicht im Terminal CLI oder über Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry. Der Befehl [`claude project`](/docs/de/cli-reference) der CLI, der den lokalen Claude Code-Status für ein Verzeichnis verwaltet, ist nicht verwandt.489* Projekte sind unter claude.ai/code, in der Desktop-App und in der Claude Mobile-App verfügbar, nicht im Terminal CLI oder über Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry. Der Befehl [`claude project`](/docs/de/cli-reference) der CLI, der den lokalen Claude Code-Status für ein Verzeichnis verwaltet, ist nicht verwandt.

456* Projekt-Threads sind [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) oder Sitzungen auf Ihrem eigenen Computer über [Remote Control](/docs/de/remote-control), wobei Anthropic in beiden Fällen der Modell-Provider ist. [Sicherheit](/docs/de/security) und [Datennutzung](/docs/de/data-usage) erläutern, wie Cloud-Sitzungen isoliert sind und was beibehalten wird, und [Verbindung und Sicherheit](/docs/de/remote-control#connection-and-security) erläutert, wie ein Thread auf Ihrem Computer verbunden ist und was gespeichert wird.490* Projekt-Threads sind [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) oder Sitzungen auf Ihrem eigenen Computer über [Remote Control](/docs/de/remote-control), wobei Anthropic in beiden Fällen der Modell-Provider ist. [Sicherheit](/docs/de/security) und [Datennutzung](/docs/de/data-usage) erläutern, wie Cloud-Sitzungen isoliert sind und was beibehalten wird, und [Verbindung und Sicherheit](/docs/de/remote-control#connection-and-security) erläutert, wie ein Thread auf Ihrem Computer verbunden ist und was gespeichert wird.

457* Sie können eine Sitzung, die Sie selbst auf Ihrem Computer gestartet haben, nicht zu einem Projekt hinzufügen. Um einem Projekt zu ermöglichen, einen Thread auf Ihrem Computer auszuführen, verbinden Sie den Ordner, in dem es funktionieren soll, über [Remote Control](/docs/de/remote-control#requirements): Aktivieren Sie Remote Control unter **Einstellungen > Claude Code** in der Claude Desktop-App, oder führen Sie `claude remote-control` im Ordner aus und lassen Sie es laufen. Dieser Computer benötigt Claude Code v2.1.280 oder später. Ein Projekt kann auch keinen Thread auf Ihrem Computer ausführen, während **Vertrauenswürdige Geräte erforderlich** in Ihren claude.ai-Einstellungen aktiviert ist.491* Sie können eine Sitzung, die Sie selbst auf Ihrem Computer gestartet haben, nicht zu einem Projekt hinzufügen. Ein Projekt erreicht Ihren Computer nur durch [Ausführung eines Threads dort über Remote Control](#run-a-thread-on-your-own-computer), und dieser Abschnitt listet auf, was dafür erforderlich ist.

458* Ein Cloud-Thread-Sandbox wird zwischen Turns unterbrochen und wird fortgesetzt, wenn der Thread weitergeht. Wenn die Sandbox nicht fortgesetzt werden kann, wird der Thread von einem frischen Klon aus fortgesetzt, sodass nicht committete Änderungen verloren gehen können. Bei langen Aufgaben bitten Sie Claude, Work in Progress zu committen und zu pushen.492* Ein Cloud-Thread-Sandbox wird zwischen Turns unterbrochen und wird fortgesetzt, wenn der Thread weitergeht. Wenn die Sandbox nicht fortgesetzt werden kann, wird der Thread von einem frischen Klon aus fortgesetzt, sodass nicht committete Änderungen verloren gehen können. Bei langen Aufgaben bitten Sie Claude, Work in Progress zu committen und zu pushen.

459* Ein Projekt gehört einem Benutzer. Sie können ein Projekt oder seine Threads nicht mit einem anderen Benutzer teilen, und Thread-Transkripte haben nicht die Share-Option, die andere Cloud-Sitzungen haben. Es gibt keine Kontrollen auf Organisationsebene für Projekte während der Beta.493* Ein Projekt gehört einem Benutzer. Sie können ein Projekt oder seine Threads nicht mit einem anderen Benutzer teilen, und Thread-Transkripte haben nicht die Share-Option, die andere Cloud-Sitzungen haben. Es gibt keine Kontrollen auf Organisationsebene für Projekte während der Beta.

460* Ein Thread gehört dem einen Projekt, das ihn gestartet hat. Sie können einen Thread nicht zu einem anderen Projekt verschieben oder kopieren, oder ihn als eigenständig verschieben. [**In Projekt verschieben**](#start-from-an-existing-cloud-session) funktioniert nur in die andere Richtung: Es bringt die Arbeit einer Cloud-Sitzung in ein Projekt.494* Ein Thread gehört dem einen Projekt, das ihn gestartet hat. Sie können einen Thread nicht zu einem anderen Projekt verschieben oder kopieren, oder ihn als eigenständig verschieben. [**In Projekt verschieben**](#start-from-an-existing-cloud-session) funktioniert nur in die andere Richtung: Es bringt die Arbeit einer Cloud-Sitzung in ein Projekt.

513 547

514Ein Thread oder das Projektgespräch machte eine Anfrage, die Ihr Plan nur mit Nutzungsguthaben abdeckt, wie z. B. eine zu einem Modell oder einer Kontextgröße, die Ihr Plan nicht enthält, und Nutzungsguthaben sind nicht für Ihr Konto aktiviert. [Fügen Sie Nutzungsguthaben zu Ihrem Abonnement hinzu](/docs/de/costs#add-usage-credits-to-your-subscription) behandelt, wer sie auf jedem Plan aktivieren oder kaufen kann. Sobald Guthaben verfügbar sind, senden Sie eine weitere Nachricht zum Wiederholen.548Ein Thread oder das Projektgespräch machte eine Anfrage, die Ihr Plan nur mit Nutzungsguthaben abdeckt, wie z. B. eine zu einem Modell oder einer Kontextgröße, die Ihr Plan nicht enthält, und Nutzungsguthaben sind nicht für Ihr Konto aktiviert. [Fügen Sie Nutzungsguthaben zu Ihrem Abonnement hinzu](/docs/de/costs#add-usage-credits-to-your-subscription) behandelt, wer sie auf jedem Plan aktivieren oder kaufen kann. Sobald Guthaben verfügbar sind, senden Sie eine weitere Nachricht zum Wiederholen.

515 549

550<h3 id="lost-contact-with-your-folder">

551 Kontakt zu Ihrem Ordner verloren

552</h3>

553

554Ein Thread, der auf Ihrem Computer läuft, zeigt dies an, wenn die Claude Code-Sitzung dort nicht mehr reagiert, normalerweise weil der Computer in den Ruhezustand versetzt wurde oder die Desktop-App oder `claude remote-control` beendet wurde. Wecken Sie den Computer auf, und wenn die Desktop-App oder `claude remote-control` dort nicht mehr läuft, starten Sie sie erneut: Öffnen Sie die App erneut und bestätigen Sie, dass **Diesen Computer von Ihrem Telefon und claude.ai aus verwenden** unter **Einstellungen > Claude Code** immer noch aktiviert ist, oder führen Sie `claude remote-control` erneut im gleichen Ordner aus.

555

516<h3 id="context-limit">556<h3 id="context-limit">

517 Andere Nachrichten557 Andere Nachrichten

518</h3>558</h3>

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

528| „Setup-Skript fehlgeschlagen" | Klicken Sie auf **Setup-Skript bearbeiten** auf dem Fehler, reparieren Sie das Skript in der Umgebung, dann senden Sie eine weitere Nachricht. [Setup-Skript fehlgeschlagen](/docs/de/web-quickstart#setup-script-failed) listet häufige Ursachen auf |568| „Setup-Skript fehlgeschlagen" | Klicken Sie auf **Setup-Skript bearbeiten** auf dem Fehler, reparieren Sie das Skript in der Umgebung, dann senden Sie eine weitere Nachricht. [Setup-Skript fehlgeschlagen](/docs/de/web-quickstart#setup-script-failed) listet häufige Ursachen auf |

529| „Claude ist auf diesem Zug aus dem Kontext gelaufen" | Der Thread hat sein Kontextfenster gefüllt. Wenn die Nachricht sagt, dass der Thread in einer frischen Sitzung fortgesetzt wird, wird er von selbst fortgesetzt; andernfalls bitten Sie Claude im Projektgespräch, einen neuen Thread für die verbleibende Arbeit zu starten |569| „Claude ist auf diesem Zug aus dem Kontext gelaufen" | Der Thread hat sein Kontextfenster gefüllt. Wenn die Nachricht sagt, dass der Thread in einer frischen Sitzung fortgesetzt wird, wird er von selbst fortgesetzt; andernfalls bitten Sie Claude im Projektgespräch, einen neuen Thread für die verbleibende Arbeit zu starten |

570| „Couldn't start in" gefolgt von Ihrem Ordnernamen | Sie erlaubten einem Thread, auf Ihrem Computer zu laufen, aber die Sitzung konnte dort nicht gestartet werden. Wenn eine Zeile unter der Nachricht den Grund angibt, beheben Sie das, dann bitten Sie Claude, die Aufgabe erneut auszuführen |

571| „Claude is out of date on your device" | Der Computer, den Sie zum Ausführen eines Threads ausgewählt haben, hat eine Claude Code-Version älter als v2.1.280. Aktualisieren Sie Claude Code dort, oder aktualisieren Sie die Desktop-App, wenn das das ist, was den Ordner verbindet, dann bitten Sie Claude, die Aufgabe erneut auszuführen |

530| „Erreichte das Zug-Limit" | Der Thread erreichte die Obergrenze für agentic Turns, die [`CLAUDE_CODE_MAX_TURNS`](/docs/de/env-vars) setzt. Senden Sie eine weitere Nachricht zum Fortfahren, oder erhöhen oder entfernen Sie diese Variable, wo sie gesetzt ist |572| „Erreichte das Zug-Limit" | Der Thread erreichte die Obergrenze für agentic Turns, die [`CLAUDE_CODE_MAX_TURNS`](/docs/de/env-vars) setzt. Senden Sie eine weitere Nachricht zum Fortfahren, oder erhöhen oder entfernen Sie diese Variable, wo sie gesetzt ist |

531 573

532<h2 id="related-resources">574<h2 id="related-resources">

cli-reference.md +60 −60

Details

26| `claude install [version]` | Installieren oder neu installieren Sie die native Binärdatei. Akzeptiert eine Version wie `2.1.118`, oder `stable` oder `latest`. Siehe [Installieren Sie eine bestimmte Version](/docs/de/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Installieren oder neu installieren Sie die native Binärdatei. Akzeptiert eine Version wie `2.1.118`, oder `stable` oder `latest`. Siehe [Installieren Sie eine bestimmte Version](/docs/de/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Melden Sie sich bei Ihrem Anthropic-Konto an. Verwenden Sie `--email`, um Ihre E-Mail-Adresse vorauszufüllen, `--sso`, um SSO-Authentifizierung zu erzwingen, und `--console`, um sich mit der Anthropic Console für API-Nutzungsabrechnung anstelle eines Claude-Abonnements anzumelden | `claude auth login --console` |27| `claude auth login` | Melden Sie sich bei Ihrem Anthropic-Konto an. Verwenden Sie `--email`, um Ihre E-Mail-Adresse vorauszufüllen, `--sso`, um SSO-Authentifizierung zu erzwingen, und `--console`, um sich mit der Anthropic Console für API-Nutzungsabrechnung anstelle eines Claude-Abonnements anzumelden | `claude auth login --console` |

29| `claude auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht | `claude auth status` |29| `claude auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht. Die JSON enthält ein `configDirectory` Feld, das das [Konfigurationsverzeichnis](/docs/de/claude-directory) benennt, das die CLI verwendet. Das Feld erfordert Claude Code v2.1.268 oder später | `claude auth status` |

30| `claude agents` | Öffnen Sie die [Agent-Ansicht](/docs/de/agent-view), um parallele Hintergrundsitzungen zu überwachen und zu versenden. Verwenden Sie `--cwd <path>`, um nur Sitzungen anzuzeigen, die in diesem Verzeichnis gestartet wurden, oder `--json`, um Live-Sitzungen als JSON-Array zum Scripting auszugeben (`--json --all` schließt auch abgeschlossene Hintergrundsitzungen ein). Übergeben Sie `--permission-mode`, `--model`, `--effort` oder `--agent`, um [Standardwerte für versendete Sitzungen](/docs/de/agent-view#permission-mode-model-and-effort) festzulegen. Akzeptiert `--settings`, `--add-dir`, `--plugin-dir` und `--mcp-config` wie der oberste `claude`-Befehl. Das Öffnen der Agent-Ansicht erfordert ein interaktives Terminal | `claude agents --json` |30| `claude agents` | Öffnen Sie die [Agent-Ansicht](/docs/de/agent-view), um parallele Hintergrundsitzungen zu überwachen und zu versenden. Verwenden Sie `--cwd <path>`, um nur Sitzungen anzuzeigen, die in diesem Verzeichnis gestartet wurden, oder `--json`, um Live-Sitzungen als JSON-Array zum Scripting auszugeben (`--json --all` schließt auch abgeschlossene Hintergrundsitzungen ein). Übergeben Sie `--permission-mode`, `--model`, `--effort` oder `--agent`, um [Standardwerte für versendete Sitzungen](/docs/de/agent-view#permission-mode-model-and-effort) festzulegen. Akzeptiert `--settings`, `--add-dir`, `--plugin-dir` und `--mcp-config` wie der oberste `claude`-Befehl. Das Öffnen der Agent-Ansicht erfordert ein interaktives Terminal | `claude agents --json` |

32| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifiziererregeln als JSON. Verwenden Sie `claude auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen. `--label <prefix>` druckt nur die Regeln, deren Bezeichnung mit diesem Präfix beginnt, Groß- und Kleinschreibung wird nicht beachtet. Erfordert Claude Code v2.1.208 oder später | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifiziererregeln als JSON. Verwenden Sie `claude auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen. `--label <prefix>` druckt nur die Regeln, deren Bezeichnung mit diesem Präfix beginnt, Groß- und Kleinschreibung wird nicht beachtet. Erfordert Claude Code v2.1.208 oder später | `claude auto-mode defaults --label 'Git Destructive'` |

57 CLI-Flags57 CLI-Flags

58</h2>58</h2>

59 59

60Passen Sie das Verhalten von Claude Code mit diesen Befehlszeilenflaggen an. `claude --help` listet nicht alle Flaggen auf, daher bedeutet das Fehlen einer Flagge in `--help` nicht, dass sie nicht verfügbar ist.60Passen Sie das Verhalten von Claude Code mit diesen Befehlszeilenflags an. `claude --help` listet nicht jeden Flag auf, daher bedeutet das Fehlen eines Flags in `--help` nicht, dass er nicht verfügbar ist.

61 61

63| :- | :- | :- |63| :- | :- | :- |

64| `--add-dir` | Fügen Sie zusätzliche Arbeitsverzeichnisse hinzu, damit Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; Claude Code [erkennt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) die meisten `.claude/`-Konfigurationen aus diesen Verzeichnissen nicht automatisch. Validiert, dass jeder Pfad als Verzeichnis existiert. Sie können die meisten [Netzwerkpfade](/docs/de/errors#working-directory-is-a-network-path) nicht hinzufügen, z. B. `\\server\share`. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, legen Sie [`permissions.additionalDirectories`](/docs/de/settings-reference#permissions-additionaldirectories) in den Einstellungen fest | `claude --add-dir ../apps ../lib` |64| `--add-dir` | Fügen Sie zusätzliche Arbeitsverzeichnisse hinzu, in denen Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; Claude Code [erkennt die meisten `.claude/`-Konfigurationen aus diesen Verzeichnissen nicht](/docs/de/permissions#additional-directories-grant-file-access-not-configuration). Validiert, dass jeder Pfad als Verzeichnis existiert. Sie können die meisten [Netzwerkpfade](/docs/de/errors#working-directory-is-a-network-path) nicht hinzufügen, wie z. B. `\\server\share`. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, legen Sie [`permissions.additionalDirectories`](/docs/de/settings-reference#permissions-additionaldirectories) in den Einstellungen fest | `claude --add-dir ../apps ../lib` |

65| `--advisor <model>` | Aktivieren Sie das serverseitige [Advisor-Tool](/docs/de/advisor) für diese Sitzung mit einem Modellalias, `fable`, `opus` oder `sonnet`, oder einer vollständigen Modell-ID. Hat Vorrang vor der `advisorModel`-Einstellung für die Sitzung. `fable` erfordert [Fable-Zugriff](/docs/de/advisor#choose-an-advisor-model) | `claude --advisor opus` |65| `--advisor <model>` | Aktivieren Sie das serverseitige [Advisor-Tool](/docs/de/advisor) für diese Sitzung mit einem Modellalias, `fable`, `opus` oder `sonnet`, oder einer vollständigen Modell-ID. Hat Vorrang vor der `advisorModel`-Einstellung für die Sitzung. `fable` erfordert [Fable-Zugriff](/docs/de/advisor#choose-an-advisor-model) | `claude --advisor opus` |

67| `--agents` | Definieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Akzeptiert die [für CLI-definierte Subagenten aufgelisteten Felder](/docs/de/sub-agents#choose-the-subagent-scope). Claude Code validiert das JSON beim Start und beendet sich bei einem ungültigen Wert; siehe [`Invalid --agents configuration`](/docs/de/errors#invalid-agents-configuration) für die Nachricht und für die Flaggen und Umgebungsvariablen, die die Validierung überspringen. Die Validierung erfordert Claude Code v2.1.242 oder später | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |67| `--agents` | Definieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Akzeptiert die [für CLI-definierte Subagenten aufgelisteten Felder](/docs/de/sub-agents#choose-the-subagent-scope). Mit `--print` kann der Wert stattdessen der Pfad zu einer JSON-Datei sein, die das Objekt enthält; die Dateiform erfordert Claude Code v2.1.281 oder später. Claude Code validiert das JSON beim Start und beendet sich bei einem ungültigen Wert; siehe [`Invalid --agents configuration`](/docs/de/errors#invalid-agents-configuration) für die Meldung und für die Flags und Umgebungsvariablen, die die Validierung überspringen. Die Validierung erfordert Claude Code v2.1.242 oder später | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

68| `--allow-dangerously-skip-permissions` | Fügen Sie `bypassPermissions` zum `Shift+Tab`-Moduszyklus hinzu, ohne darin zu starten. Ermöglicht es Ihnen, in einem anderen Modus wie `plan` zu beginnen und später zu `bypassPermissions` zu wechseln. Siehe [Berechtigungsmodi](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |68| `--allow-dangerously-skip-permissions` | Fügen Sie `bypassPermissions` zum `Shift+Tab`-Moduszyklus hinzu, ohne darin zu starten. Ermöglicht es Ihnen, in einem anderen Modus wie `plan` zu beginnen und später zu `bypassPermissions` zu wechseln. Siehe [Berechtigungsmodi](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

69| `--allowedTools`, `--allowed-tools` | Tools, die ohne Berechtigungsaufforderung ausgeführt werden. Siehe [Berechtigungsregelsyntax](/docs/de/settings-reference#permission-rule-syntax) für Musterabgleich. Um einzuschränken, welche Tools verfügbar sind, verwenden Sie stattdessen `--tools`. Wenn Sie eines der [Task-Tracking-Tools](/docs/de/tools-reference#task-tool-availability) hier benennen, aktiviert Claude Code die Sitzung auch dafür | `"Bash(git log *)" "Bash(git diff *)" "Read"` |69| `--allowedTools`, `--allowed-tools` | Tools, die ohne Berechtigungsaufforderung ausgeführt werden. Siehe [Berechtigungsregelsyntax](/docs/de/settings-reference#permission-rule-syntax) für Musterabgleich. Um einzuschränken, welche Tools verfügbar sind, verwenden Sie stattdessen `--tools`. Wenn Sie eines der [Task-Tracking-Tools](/docs/de/tools-reference#task-tool-availability) hier benennen, aktiviert Claude Code die Sitzung auch | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

70| `--append-subagent-system-prompt` | Fügen Sie benutzerdefinierten Text am Ende des System-Prompts jedes [Subagenten](/docs/de/sub-agents) an, einschließlich verschachtelter Subagenten, mit Ausnahme eines [abgespaltenen Subagenten](/docs/de/sub-agents#fork-the-current-conversation), der den eigenen Prompt der Konversation wiederverwendet. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Claude Code v2.1.205 oder später | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |70| `--append-subagent-system-prompt` | Hängen Sie benutzerdefinierten Text an das Ende des System-Prompts jedes [Subagenten](/docs/de/sub-agents) an, einschließlich verschachtelter Subagenten, mit Ausnahme eines [abgespaltenen Subagenten](/docs/de/sub-agents#fork-the-current-conversation), der den eigenen Prompt der Konversation wiederverwendet. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Claude Code v2.1.205 oder später | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

71| `--append-subagent-system-prompt-file` | Laden Sie Text aus einer Datei und fügen Sie ihn an [Subagenten](/docs/de/sub-agents)-System-Prompts an. Eine Alternative zu `--append-subagent-system-prompt` für Text, der zu lang ist, um ihn in der Befehlszeile zu übergeben. Die beiden Flaggen können nicht kombiniert werden. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Claude Code v2.1.261 oder später | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |71| `--append-subagent-system-prompt-file` | Laden Sie Text aus einer Datei und hängen Sie ihn an [Subagenten](/docs/de/sub-agents)-System-Prompts an. Eine Alternative zu `--append-subagent-system-prompt` für Text, der zu lang ist, um ihn in der Befehlszeile zu übergeben. Die beiden Flags können nicht kombiniert werden. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Claude Code v2.1.261 oder später | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |

~~73| `--append-system-prompt-file` | Laden Sie zusätzlichen System-Prompt-Text aus einer Datei und fügen Sie ihn an den Standard-Prompt an | `claude --append-system-prompt-file ./extra-rules.txt` |~~73| `--append-system-prompt-file` | Laden Sie zusätzlichen System-Prompt-Text aus einer Datei und hängen Sie ihn an den Standard-Prompt an | `claude --append-system-prompt-file ./extra-rules.txt` |

74| `--autocompact <auto\|tokens>` | Legen Sie das [Auto-Compact-Fenster](/docs/de/model-config#set-the-auto-compact-window) für diese Sitzung fest, ohne Ihre gespeicherten Einstellungen zu ändern. Akzeptiert die gleichen Werte wie `/autocompact`; dieser Abschnitt behandelt die Wertformen und was die Flagge überschreibt. Erfordert Claude Code v2.1.221 oder später | `claude --autocompact 500k` |74| `--autocompact <auto\|tokens>` | Legen Sie das [Auto-Compact-Fenster](/docs/de/model-config#set-the-auto-compact-window) für diese Sitzung fest, ohne Ihre gespeicherten Einstellungen zu ändern. Akzeptiert die gleichen Werte wie `/autocompact`; dieser Abschnitt behandelt die Wertformen und was den Flag überschreibt. Erfordert Claude Code v2.1.221 oder später | `claude --autocompact 500k` |

75| `--ax-screen-reader` | Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, daher hat die [`tui`](/docs/de/settings-reference#tui)-Einstellung keine Auswirkung; angehängte [Hintergrund-Sitzungen](/docs/de/agent-view) werden immer noch im Vollbildmodus gerendert. Hat Vorrang vor [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars) und der [`axScreenReader`](/docs/de/settings-reference#axscreenreader)-Einstellung. Erfordert Claude Code v2.1.181 oder später | `claude --ax-screen-reader` |75| `--ax-screen-reader` | Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, daher hat die [`tui`](/docs/de/settings-reference#tui)-Einstellung keine Auswirkung; angehängte [Hintergrund-Sitzungen](/docs/de/agent-view) werden immer noch im Vollbildmodus gerendert. Hat Vorrang vor [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars) und der [`axScreenReader`](/docs/de/settings-reference#axscreenreader)-Einstellung. Erfordert Claude Code v2.1.181 oder später | `claude --ax-screen-reader` |

76| `--bare` | Minimalmodus: Überspringen Sie die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagenten, Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit Skriptaufrufe schneller starten. Skills in einem Verzeichnis, das Sie mit `--add-dir` übergeben, werden immer noch geladen. Claude hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungstools. Setzt [`CLAUDE_CODE_SIMPLE`](/docs/de/env-vars). Siehe [Bare-Modus](/docs/de/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |76| `--bare` | Minimaler Modus: Überspringen Sie die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagenten, installierten Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit skriptgesteuerte Aufrufe schneller starten. Skills in einem Verzeichnis, das Sie mit `--add-dir` übergeben, werden immer noch geladen. Claude hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungs-Tools. Setzt [`CLAUDE_CODE_SIMPLE`](/docs/de/env-vars). Siehe [Bare-Modus](/docs/de/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

78| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/docs/de/agent-view) und kehren Sie sofort zurück. Gibt die Sitzungs-ID und Verwaltungsbefehle aus. Kombinieren Sie mit `--exec`, um einen Shell-Befehl als Hintergrund-Job statt einer Claude-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/docs/de/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |78| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/docs/de/agent-view) und kehren Sie sofort zurück. Gibt die Sitzungs-ID und Verwaltungsbefehle aus. Kombinieren Sie mit `--exec`, um einen Shell-Befehl als Hintergrund-Job statt einer Claude-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. Überprüft [Workspace-Vertrauen](/docs/de/permissions#project-allow-rules-and-workspace-trust) für das Verzeichnis, bevor es startet. Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/docs/de/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

79| `--channels` | (Forschungsvorschau) MCP-Server, deren [Kanal](/docs/de/channels)-Benachrichtigungen Claude in dieser Sitzung abhören sollte. Durch Leerzeichen getrennte Liste von `plugin:<name>@<marketplace>`-Einträgen. Erfordert Anthropic-Authentifizierung über claude.ai oder einen Console-API-Schlüssel | `claude --channels plugin:my-notifier@my-marketplace` |79| `--channels` | (Forschungsvorschau) MCP-Server, deren [Kanal](/docs/de/channels)-Benachrichtigungen Claude in dieser Sitzung abhören sollte. Durch Leerzeichen getrennte Liste von `plugin:<name>@<marketplace>`-Einträgen. Erfordert Anthropic-Authentifizierung über claude.ai oder einen Console-API-Schlüssel | `claude --channels plugin:my-notifier@my-marketplace` |

81| `--cloud` | Mit einer Aufgabenbeschreibung erstellen Sie eine neue [Cloud-Sitzung](/docs/de/claude-code-on-the-web). Mit einer Sitzungs-ID (`session_...` oder `cse_...`) oder einer claude.ai/code-URL fügen Sie stattdessen eine Nachricht in diese vorhandene Sitzung ein, mit `-p`. Siehe [Folgenachricht senden](/docs/de/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |81| `--cloud` | Mit einer Task-Beschreibung erstellen Sie eine neue [Cloud-Sitzung](/docs/de/claude-code-on-the-web). Mit einer Sitzungs-ID (`session_...` oder `cse_...`) oder einer claude.ai/code-URL, reihen Sie stattdessen eine Nachricht in diese bestehende Sitzung ein, mit `-p`. Siehe [Senden Sie eine Folgenachricht](/docs/de/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |

82| `--continue`, `-c` | Laden Sie die neueste Konversation im aktuellen Verzeichnis, einschließlich einer [Hintergrund-Sitzung, die beendet wurde](/docs/de/sessions#resume-a-session); das Öffnen beendeter Hintergrund-Sitzungen erfordert Claude Code v2.1.257 oder später. Überspringt Sitzungen, die mit `claude -p` oder dem Agent SDK erstellt wurden, und Sitzungen, deren erster Prompt `/loop` war. `claude -p --continue` umfasst `-p`-, SDK- und `/loop`-Sitzungen. Umfasst Sitzungen, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben | `claude --continue` |82| `--continue`, `-c` | Laden Sie die neueste Konversation im aktuellen Verzeichnis, einschließlich einer [Hintergrund-Sitzung, die beendet wurde](/docs/de/sessions#resume-a-session); das Öffnen beendeter Hintergrund-Sitzungen erfordert Claude Code v2.1.257 oder später. Überspringt Sitzungen, die mit `claude -p` oder dem Agent SDK erstellt wurden, und Sitzungen, deren erster Prompt `/loop` war. `claude -p --continue` umfasst `-p`-, SDK- und `/loop`-Sitzungen. Umfasst Sitzungen, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben | `claude --continue` |

83| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/docs/de/channels-reference#test-during-the-research-preview), die nicht auf der genehmigten Zulassungsliste stehen, für die lokale Entwicklung. Akzeptiert `plugin:<name>@<marketplace>`- und `server:<name>`-Einträge. Fordert zur Bestätigung auf | `claude --dangerously-load-development-channels server:webhook` |83| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/docs/de/channels-reference#test-during-the-research-preview), die sich nicht auf der genehmigten Zulassungsliste befinden, für die lokale Entwicklung. Akzeptiert `plugin:<name>@<marketplace>`- und `server:<name>`-Einträge. Fordert zur Bestätigung auf | `claude --dangerously-load-development-channels server:webhook` |

84| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt. Für Sitzungen, die mit `--bg` gestartet wurden, [bleibt der Modus bestehen, wenn der Supervisor die Sitzung neu startet](/docs/de/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt. Für Sitzungen, die mit `--bg` gestartet wurden, [bleibt der Modus bestehen, wenn der Supervisor die Sitzung neu startet](/docs/de/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Aktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung, z. B. `--debug='mcp,startup'` oder `--debug='!1p'`. Der Filter bindet nur in der `=`-Form; ein durch Leerzeichen getrennter Filter aktiviert den Debug-Modus ohne Filterung | `claude --debug='mcp,startup'` |85| `--debug` | Aktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung, wie z. B. `--debug='mcp,startup'` oder `--debug='!1p'`. Der Filter bindet nur in der `=`-Form; ein durch Leerzeichen getrennter Filter aktiviert den Debug-Modus ohne Filterung | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | Schreiben Sie Debug-Protokolle in einen bestimmten Dateipfad. Aktiviert implizit den Debug-Modus. Hat Vorrang vor `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | Schreiben Sie Debug-Protokolle in einen bestimmten Dateipfad. Aktiviert implizit den Debug-Modus. Hat Vorrang vor `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

88| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus Claudes Kontext: `"Edit"` entfernt Edit, `"*"` entfernt alle Tools, und `"mcp__*"` entfernt alle MCP-Tools. Eine bereicherte Regel wie `Bash(rm *)` lässt das Tool verfügbar und lehnt nur Aufrufe ab, die [wie geschrieben](/docs/de/permissions#bash-rule-limits) übereinstimmen. Eine Regel, die [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) benennt, kann es nicht entfernen, während ein anderes Tool verbleibt | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |88| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus Claudes Kontext: `"Edit"` entfernt Edit, `"*"` entfernt jedes Tool, und `"mcp__*"` entfernt jedes MCP-Tool. Eine scoped-Regel wie `Bash(rm *)` lässt das Tool verfügbar und lehnt nur Aufrufe ab, die [wie geschrieben](/docs/de/permissions#bash-rule-limits) übereinstimmen. Eine Regel, die [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) benennt, kann es nicht entfernen, während ein anderes Tool verbleibt | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | Legen Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) für die aktuelle Sitzung fest. Optionen: `low`, `medium`, `high`, `xhigh`, `max`, oder `ultracode`. Verfügbare Stufen hängen vom Modell ab. `ultracode` fordert `xhigh`-Anstrengung mit [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) an und erfordert Claude Code v2.1.203 oder später. Überschreibt die [`modelSettings`](/docs/de/settings-reference#modelsettings)- und [`effortLevel`](/docs/de/settings-reference#effortlevel)-Einstellungen für diese Sitzung und bleibt nicht bestehen | `claude --effort high` |89| `--effort` | Legen Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) für die aktuelle Sitzung fest. Optionen: `low`, `medium`, `high`, `xhigh`, `max`, oder `ultracode`. Verfügbare Stufen hängen vom Modell ab. `ultracode` fordert `xhigh`-Anstrengung mit [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) an, und erfordert Claude Code v2.1.203 oder später. Überschreibt die [`modelSettings`](/docs/de/settings-reference#modelsettings)- und [`effortLevel`](/docs/de/settings-reference#effortlevel)-Einstellungen für diese Sitzung und bleibt nicht bestehen | `claude --effort high` |

90| `--enable-auto-mode` | Entfernt in v2.1.111. Der Auto-Modus ist jetzt standardmäßig im `Shift+Tab`-Zyklus; verwenden Sie `--permission-mode auto`, um darin zu starten | `claude --permission-mode auto` |90| `--enable-auto-mode` | Entfernt in v2.1.111. Der Auto-Modus ist jetzt standardmäßig im `Shift+Tab`-Zyklus; verwenden Sie `--permission-mode auto`, um darin zu starten | `claude --permission-mode auto` |

91| `--environment <environment-id>` | Erstellen Sie eine neue Cloud-Sitzung, die in der [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) mit der angegebenen ID ausgeführt wird. Umgebungs-IDs beginnen mit `ccpool_`. Siehe [Dispatch-Verhalten von `--environment`](/docs/de/self-hosted-environments-testing#environment-dispatch-behavior) für Dispatch-Verhalten und die Flaggenkombinationen, die es ablehnt. Erfordert Claude Code v2.1.224 oder später | `claude -p "Fix the login bug" --environment ccpool_abc123` |91| `--environment <environment-id>` | Erstellen Sie eine neue Cloud-Sitzung, die in der [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) mit der angegebenen ID ausgeführt wird. Umgebungs-IDs beginnen mit `ccpool_`. Siehe [`--environment`-Dispatch-Verhalten](/docs/de/self-hosted-environments-testing#environment-dispatch-behavior) für Dispatch-Verhalten und die Flag-Kombinationen, die es ablehnt. Erfordert Claude Code v2.1.224 oder später | `claude -p "Fix the login bug" --environment ccpool_abc123` |

92| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie maschinenspezifische Abschnitte aus dem System-Prompt (Arbeitsverzeichnis, Umgebungsinformationen, Speicherpfade, Git-Repo-Flag) in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über verschiedene Benutzer und Maschinen hinweg, die die gleiche Aufgabe ausführen. Gilt nur mit dem Standard-System-Prompt; wird ignoriert, wenn `--system-prompt` oder `--system-prompt-file` gesetzt ist. Verwenden Sie mit `-p` für Skript-, Multi-Benutzer-Workloads | `claude -p --exclude-dynamic-system-prompt-sections "query"` |92| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie benutzerspezifische Kontexte, wie z. B. den Speicherort des automatischen Speichers, aus dem System-Prompt in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über verschiedene Benutzer und Maschinen, die die gleiche Task ausführen. Gilt nur mit dem Standard-System-Prompt; wird ignoriert, wenn `--system-prompt` oder `--system-prompt-file` gesetzt ist. Verwenden Sie mit `-p` für skriptgesteuerte, Multi-Benutzer-Workloads | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

93| `--exec` | Führen Sie einen Shell-Befehl als PTY-gestützten Hintergrund-Job statt einer Claude-Sitzung aus. Verwenden Sie mit `--bg`, um von der Shell aus zu starten | `claude --bg --exec 'pytest -x'` |93| `--exec` | Führen Sie einen Shell-Befehl als PTY-gestützten Hintergrund-Job statt einer Claude-Sitzung aus. Verwenden Sie mit `--bg`, um von der Shell aus zu starten | `claude --bg --exec 'pytest -x'` |

94| `--fallback-model` | Aktivieren Sie automatisches Fallback auf das angegebene Modell oder die angegebenen Modelle, wenn das primäre Modell überlastet oder nicht verfügbar ist, z. B. ein veraltetes Modell. Akzeptiert eine durch Kommas getrennte Liste, die der Reihe nach versucht wird. Siehe [Fallback-Modellketten](/docs/de/model-config#fallback-model-chains). Um eine Kette über Sitzungen hinweg beizubehalten, verwenden Sie die [`fallbackModel`-Einstellung](/docs/de/settings-reference#fallbackmodel), die diese Flagge überschreibt | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | Aktivieren Sie automatisches Fallback auf das angegebene Modell oder die angegebenen Modelle, wenn das primäre Modell überlastet oder nicht verfügbar ist, z. B. ein veraltetes Modell. Akzeptiert eine durch Kommas getrennte Liste, die der Reihe nach versucht wird. Siehe [Fallback-Modellketten](/docs/de/model-config#fallback-model-chains). Um eine Kette über Sitzungen hinweg beizubehalten, verwenden Sie die [`fallbackModel`-Einstellung](/docs/de/settings-reference#fallbackmodel), die dieser Flag überschreibt | `claude --fallback-model sonnet,haiku` |

95| `--fork-session` | Erstellen Sie beim Fortsetzen eine neue Sitzungs-ID, anstatt die ursprüngliche wiederzuverwenden (verwenden Sie mit `--resume` oder `--continue`) | `claude --resume abc123 --fork-session` |95| `--fork-session` | Erstellen Sie beim Fortsetzen eine neue Sitzungs-ID, anstatt die ursprüngliche wiederzuverwenden (verwenden Sie mit `--resume` oder `--continue`) | `claude --resume abc123 --fork-session` |

96| `--forward-subagent-text` | Geben Sie [Subagenten](/docs/de/sub-agents)-Text und Thinking-Blöcke im Ausgabestrom als `assistant`- und `user`-Nachrichten mit `parent_tool_use_id` gesetzt aus, damit Sie das Transkript jedes Subagenten rekonstruieren können. Ohne diese Flagge lässt Claude Code den Text und die Thinking-Blöcke eines Subagenten weg, der im [Vordergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background) ausgeführt wird. Erfordert `--print` und `--output-format stream-json`. Claude Code leitet auch Nachrichten von [verschachtelten Subagenten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) weiter und setzt `parent_tool_use_id` auf die ID des Agent- oder Skill-Tool-Aufrufs, der jeden spawnt; dies erfordert Claude Code v2.1.219 oder später, und Nachrichten von Subagenten, die ein abgespaltener Skill spawnt, und von verschachtelten abgespaltenen Skills erfordern v2.1.275 oder später. Die [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/de/env-vars)-Umgebungsvariable aktiviert das gleiche Verhalten. Erfordert Claude Code v2.1.211 oder später | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |96| `--forward-subagent-text` | Geben Sie [Subagenten](/docs/de/sub-agents)-Text und Thinking-Blöcke im Ausgabestrom als `assistant`- und `user`-Nachrichten mit `parent_tool_use_id` gesetzt aus, damit Sie das Transkript jedes Subagenten rekonstruieren können. Ohne diesen Flag lässt Claude Code den Text und die Thinking-Blöcke eines Subagenten weg, der im [Vordergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background) läuft. Erfordert `--print` und `--output-format stream-json`. Claude Code leitet auch Nachrichten von [verschachtelten Subagenten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) weiter, wobei `parent_tool_use_id` auf die ID des Agent- oder Skill-Tool-Aufrufs gesetzt wird, der jeden startet; dies erfordert Claude Code v2.1.219 oder später, und Nachrichten von Subagenten, die ein abgespaltener Skill spawnt, und von verschachtelten abgespaltenen Skills, erfordern v2.1.275 oder später. Die [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/de/env-vars)-Umgebungsvariable aktiviert das gleiche Verhalten. Erfordert Claude Code v2.1.211 oder später | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

97| `--from-pr` | Öffnen Sie die Sitzungsauswahl gefiltert nach Sitzungen, die mit einem bestimmten Pull Request verknüpft sind. Akzeptiert eine PR-Nummer, eine GitHub- oder GitHub Enterprise-PR-URL, eine GitLab-Merge-Request-URL oder eine Bitbucket-Pull-Request-URL. Sitzungen werden automatisch verknüpft, wenn Claude den Pull Request erstellt | `claude --from-pr 123` |97| `--from-pr` | Öffnen Sie die Sitzungsauswahl gefiltert auf Sitzungen, die mit einem bestimmten Pull Request verknüpft sind. Akzeptiert eine PR-Nummer, eine GitHub- oder GitHub Enterprise-PR-URL, eine GitLab-Merge-Request-URL oder eine Bitbucket-Pull-Request-URL. Sitzungen werden automatisch verknüpft, wenn Claude den Pull Request erstellt | `claude --from-pr 123` |

~~98| `--ide` | Verbinden Sie sich automatisch beim Start mit der IDE, wenn genau eine gültige IDE verfügbar ist | `claude --ide` |~~98| `--ide` | Verbinden Sie sich automatisch mit der IDE beim Start, wenn genau eine gültige IDE verfügbar ist | `claude --ide` |

100| `--init-only` | Führen Sie [Setup](/docs/de/hooks#setup)- und `SessionStart`-Hooks aus und beenden Sie sich dann, ohne eine Konversation zu starten | `claude --init-only` |100| `--init-only` | Führen Sie [Setup](/docs/de/hooks#setup)- und `SessionStart`-Hooks aus und beenden Sie sich dann, ohne eine Konversation zu starten | `claude --init-only` |

101| `--include-hook-events` | Beziehen Sie Hook-Lebenszyklusereignisse in den Ausgabestrom ein. `SessionStart`- und `Setup`-Hook-Ereignisse sind immer enthalten und benötigen diese Flagge nicht. Einige Hook-Ereignisse wie `Notification`, `SessionEnd`, `PreCompact` und `PostCompact` erzeugen niemals ein `hook_started`-Ereignis, auch nicht mit dieser Flagge. Für diese Ereignisse gibt Claude Code immer noch `hook_progress` aus, während ein Command-Hook, der länger als eine Sekunde läuft, Ausgabe erzeugt, und gibt `hook_response` nur aus, wenn ein [Hook, der im Hintergrund läuft](/docs/de/hooks#run-hooks-in-the-background), beendet wird. Erfordert `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |101| `--include-hook-events` | Beziehen Sie Hook-Lebenszyklusereignisse in den Ausgabestrom ein. `SessionStart`- und `Setup`-Hook-Ereignisse sind immer enthalten und benötigen diesen Flag nicht. Einige Hook-Ereignisse, wie `Notification`, `SessionEnd`, `PreCompact` und `PostCompact`, erzeugen niemals ein `hook_started`-Ereignis, auch nicht mit diesem Flag. Für diese Ereignisse gibt Claude Code immer noch `hook_progress` aus, während ein Command-Hook, der länger als eine Sekunde läuft, Ausgabe erzeugt, und gibt `hook_response` nur aus, wenn ein [Hook, der im Hintergrund läuft](/docs/de/hooks#run-hooks-in-the-background), beendet wird. Erfordert `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

102| `--include-partial-messages` | Beziehen Sie partielle Streaming-Ereignisse in die Ausgabe ein. Erfordert `--print` und `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |102| `--include-partial-messages` | Beziehen Sie partielle Streaming-Ereignisse in die Ausgabe ein. Erfordert `--print` und `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

103| `--input-format` | Geben Sie das Eingabeformat für den Print-Modus an (Optionen: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |103| `--input-format` | Geben Sie das Eingabeformat für den Print-Modus an (Optionen: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

104| `--json-schema` | Erhalten Sie validierte JSON-Ausgabe, die einem JSON-Schema entspricht, nachdem der Agent seinen Workflow abgeschlossen hat (nur Print-Modus). Siehe [strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs). Claude Code beendet sich mit einem Fehler bei einem ungültigen Schema und akzeptiert das `format`-Schlüsselwort als Anmerkung ohne clientseitige Validierung | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |104| `--json-schema` | Erhalten Sie validierte JSON-Ausgabe, die einem JSON-Schema entspricht, nachdem der Agent seinen Workflow abgeschlossen hat (nur Print-Modus). Siehe [strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs). Claude Code beendet sich mit einem Fehler bei einem ungültigen Schema und akzeptiert das `format`-Schlüsselwort als Anmerkung ohne clientseitige Validierung | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

105| `--maintenance` | Führen Sie [Setup-Hooks](/docs/de/hooks#setup) mit dem `maintenance`-Matcher vor der Sitzung aus (nur Print-Modus) | `claude -p --maintenance "query"` |105| `--maintenance` | Führen Sie [Setup-Hooks](/docs/de/hooks#setup) mit dem `maintenance`-Matcher vor der Sitzung aus (nur Print-Modus) | `claude -p --maintenance "query"` |

106| `--max-budget-usd` | Maximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden soll, bevor gestoppt wird (nur Print-Modus). Ausgaben von [Subagenten](/docs/de/sub-agents) zählen zur Obergrenze. Wenn Sie zu einer Konversation mit `--continue` oder `--resume` zurückkehren, zählen Gesamtsummen [wiederhergestellt aus früheren Läufen](/docs/de/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) nicht dazu. Sobald die Ausgaben die Obergrenze erreichen, schlägt das Spawnen eines anderen Subagenten mit `Budget limit reached` fehl, und Claude Code stoppt Hintergrund-Subagenten, die noch laufen; die Obergrenzendurchsetzungsverhalten erfordern Claude Code v2.1.217 oder später | `claude -p --max-budget-usd 5.00 "query"` |106| `--max-budget-usd` | Maximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden soll, bevor gestoppt wird (nur Print-Modus). Ausgaben von [Subagenten](/docs/de/sub-agents) zählen zur Obergrenze. Wenn Sie zu einer Konversation mit `--continue` oder `--resume` zurückkehren, zählen Gesamtsummen [aus früheren Läufen wiederhergestellt](/docs/de/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) nicht zur Obergrenze. Sobald die Ausgaben die Obergrenze erreichen, schlägt das Spawnen eines weiteren Subagenten mit `Budget limit reached` fehl, und Claude Code stoppt Hintergrund-Subagenten, die noch laufen; die Obergrenzendurchsetzungsverhalten erfordern Claude Code v2.1.217 oder später | `claude -p --max-budget-usd 5.00 "query"` |

107| `--max-turns` | Begrenzen Sie die Anzahl der agentengesteuerten Turns (nur Print-Modus). Beendet sich mit einem Fehler, wenn die Grenze erreicht wird. Standardmäßig keine Grenze. Mit `--input-format stream-json` bleibt eine Nachricht, die noch in die Warteschlange eingereiht ist, wenn die Grenze einen Turn beendet, in der Warteschlange und startet einen neuen Turn mit seiner eigenen Grenze | `claude -p --max-turns 3 "query"` |107| `--max-turns` | Begrenzen Sie die Anzahl der agentengesteuerten Turns (nur Print-Modus). Beendet sich mit einem Fehler, wenn die Grenze erreicht wird. Standardmäßig keine Grenze. Mit `--input-format stream-json` bleibt eine Nachricht, die noch in die Warteschlange eingereiht ist, wenn die Grenze einen Turn beendet, in der Warteschlange und startet einen neuen Turn mit seiner eigenen Grenze | `claude -p --max-turns 3 "query"` |

108| `--mcp-config` | Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt). Wenn Sie diese Flagge mit `-p` übergeben, wartet Claude Code darauf, dass noch ausstehende Server verbunden werden, bevor der erste Turn ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars)-Starttimeout, standardmäßig 30 Sekunden; ein Server mit einer [zwischengespeicherten Tool-Liste](/docs/de/mcp#managing-your-servers) überspringt das Warten und verbindet sich bei der ersten Verwendung. Das Warten erfordert Claude Code v2.1.221 oder später | `claude --mcp-config ./mcp.json` |108| `--mcp-config` | Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt). Wenn Sie diesen Flag mit `-p` übergeben, wartet Claude Code darauf, dass noch ausstehende Server verbunden werden, bevor der erste Turn ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars)-Startup-Timeout, standardmäßig 30 Sekunden; ein Server mit einer [zwischengespeicherten Tool-Liste](/docs/de/mcp#managing-your-servers) überspringt das Warten und verbindet sich bei der ersten Verwendung. Das Warten erfordert Claude Code v2.1.221 oder später | `claude --mcp-config ./mcp.json` |

109| `--model` | Legt das Modell für die aktuelle Sitzung mit einem [Modellalias](/docs/de/model-config#model-aliases) wie `sonnet`, `opus`, `haiku` oder `fable` oder einem vollständigen Modellnamen fest. Überschreibt die [`model`](/docs/de/settings-reference#model)-Einstellung und [`ANTHROPIC_MODEL`](/docs/de/model-config#environment-variables) | `claude --model claude-sonnet-5` |109| `--model` | Legt das Modell für die aktuelle Sitzung mit einem [Modellalias](/docs/de/model-config#model-aliases) wie `sonnet`, `opus`, `haiku` oder `fable` oder einem vollständigen Modellnamen fest. Überschreibt die [`model`](/docs/de/settings-reference#model)-Einstellung und [`ANTHROPIC_MODEL`](/docs/de/model-config#environment-variables) | `claude --model claude-sonnet-5` |

110| `--name`, `-n` | Legen Sie einen Anzeigenamen für die Sitzung fest, der in `/resume` und der Terminalleiste angezeigt wird. Sie können eine benannte Sitzung mit `claude --resume <name>` fortsetzen. In einer interaktiven Sitzung, wenn eine andere Live-Sitzung auf dieser Maschine bereits den Namen verwendet, wendet Claude Code [eine Variante davon](/docs/de/sessions#name-your-sessions) an. <br /><br />[`/rename`](/docs/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `claude -n "my-feature-work"` |110| `--name`, `-n` | Legen Sie einen Anzeigenamen für die Sitzung fest, der in `/resume` und der Terminalleiste angezeigt wird. Sie können eine benannte Sitzung mit `claude --resume <name>` fortsetzen. In einer interaktiven Sitzung, wenn eine andere Live-Sitzung auf dieser Maschine bereits den Namen verwendet, wendet Claude Code [eine Variante davon](/docs/de/sessions#name-your-sessions) an. <br /><br />[`/rename`](/docs/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `claude -n "my-feature-work"` |

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

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

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

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

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

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

119| `--print`, `-p` | Drucken Sie die Antwort ohne interaktiven Modus (siehe [Agent SDK-Dokumentation](/docs/de/agent-sdk/overview) für Details zur programmatischen Verwendung) | `claude -p "query"` |119| `--print`, `-p` | Geben Sie die Antwort ohne interaktiven Modus aus (siehe [Agent SDK-Dokumentation](/docs/de/agent-sdk/overview) für Details zur programmatischen Verwendung) | `claude -p "query"` |

120| `--prompt-suggestions` | Geben Sie eine `prompt_suggestion`-Nachricht mit einem vorhergesagten nächsten Benutzer-Prompt nach jedem Turn aus, der einen erzeugt; sehr kurze Konversationen können keine erzeugen. Erfordert `--print`, `--output-format stream-json` und `--verbose`. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |120| `--prompt-suggestions` | Geben Sie eine `prompt_suggestion`-Nachricht mit einem vorhergesagten nächsten Benutzer-Prompt nach jedem Turn aus, der einen erzeugt; sehr kurze Konversationen können keine erzeugen. Erfordert `--print`, `--output-format stream-json` und `--verbose`. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | Mit `--environment` basieren Sie den Checkout der neuen Sitzung auf einer benannten Ref anstelle des lokalen `HEAD` | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |121| `--ref <branch>` | Mit `--environment` basieren Sie den Checkout der neuen Sitzung auf einer benannten Ref anstelle des lokalen `HEAD` | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

123| `--remote-control`, `--rc` | Starten Sie eine interaktive Sitzung mit [Remote Control](/docs/de/remote-control#start-a-remote-control-session) aktiviert, damit Sie sie auch von claude.ai oder der Claude-App aus steuern können. Übergeben Sie optional einen Namen für die Sitzung | `claude --remote-control "My Project"` |123| `--remote-control`, `--rc` | Starten Sie eine interaktive Sitzung mit [Remote Control](/docs/de/remote-control#start-a-remote-control-session) aktiviert, damit Sie sie auch von claude.ai oder der Claude-App aus steuern können. Übergeben Sie optional einen Namen für die Sitzung | `claude --remote-control "My Project"` |

124| `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte [Remote Control](/docs/de/remote-control)-Sitzungsnamen, wenn kein expliziter Name gesetzt ist. Standardmäßig der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` erzeugt. Legen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für den gleichen Effekt fest | `claude remote-control --remote-control-session-name-prefix dev-box` |124| `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte [Remote Control](/docs/de/remote-control)-Sitzungsnamen, wenn kein expliziter Name gesetzt ist. Standardmäßig der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` erzeugt. Legen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für den gleichen Effekt fest | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | Geben Sie Benutzernachrichten von stdin auf stdout zurück zur Bestätigung aus. Erfordert `--input-format stream-json` und `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |125| `--replay-user-messages` | Geben Sie Benutzernachrichten von stdin zur Bestätigung auf stdout aus. Erfordert `--input-format stream-json` und `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | Starten Sie im eingeschränkten Modus. Verwenden Sie ihn, wenn ein Evaluierungs-Harness `claude` auf einer gemeinsamen Maschine antreibt und Claude Code keine Befehle ausführen oder die Benutzer- und Projekteinstellungen dieser Maschine lesen darf. Claude Code entfernt die integrierten Tools, die Befehle oder Code ausführen, und WebFetch, es sei denn, Sie benennen sie einzeln in `--tools`, nicht durch die `default`-Voreinstellung. Es beschränkt auch die integrierten Datei-Tools auf die [Arbeitsverzeichnisse](/docs/de/permissions#working-directories), lädt nur [verwaltete Einstellungen](/docs/de/managed-settings) und `--settings`, lehnt [`bypassPermissions`](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) ab, und [lehnt ab, Cloud-Sitzungen zu erstellen](/docs/de/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Erfordert Claude Code v2.1.248 oder später | `claude --restricted -p "query"` |126| `--restricted` | Starten Sie im eingeschränkten Modus. Verwenden Sie ihn, wenn ein Evaluierungs-Harness `claude` auf einer gemeinsamen Maschine antreibt und Claude Code keine Befehle ausführen oder die Benutzer- und Projekteinstellungen dieser Maschine lesen darf. Claude Code entfernt die integrierten Tools, die Befehle oder Code ausführen, und WebFetch, es sei denn, Sie benennen sie einzeln in `--tools`, nicht durch die `default`-Voreinstellung. Es beschränkt auch die integrierten Datei-Tools auf die [Arbeitsverzeichnisse](/docs/de/permissions#working-directories), lädt nur [verwaltete Einstellungen](/docs/de/managed-settings) und `--settings`, lehnt [`bypassPermissions`](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) ab, und [lehnt ab, Cloud-Sitzungen zu erstellen](/docs/de/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Erfordert Claude Code v2.1.248 oder später | `claude --restricted -p "query"` |

127| `--resume`, `-r` | Setzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung zu wählen. Anstelle einer ID können Sie den absoluten Pfad zur [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) einer Sitzung übergeben. Die Auswahl und Namenssuche umfassen Sitzungen, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben. Wenn Sie eine Sitzungs-ID übergeben, durchsucht Claude Code das aktuelle Projektverzeichnis und seine Git-Worktrees, dann jedes andere Projekt auf dieser Maschine. Vor v2.1.223 deckte die ID-Suche nur das aktuelle Projektverzeichnis und seine Git-Worktrees ab. [Hintergrund-Sitzungen](/docs/de/agent-view) erscheinen in der Auswahl mit `bg` gekennzeichnet | `claude --resume auth-refactor` |127| `--resume`, `-r` | Setzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung zu wählen. Anstelle einer ID können Sie den absoluten Pfad zur [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) einer Sitzung `.jsonl` übergeben. Die Auswahl und Namenssuche umfassen Sitzungen, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben. Wenn Sie eine Sitzungs-ID übergeben, durchsucht Claude Code das aktuelle Projektverzeichnis und seine Git-Worktrees, dann jedes andere Projekt auf dieser Maschine. Vor v2.1.223 deckte die ID-Suche nur das aktuelle Projektverzeichnis und seine Git-Worktrees ab. [Hintergrund-Sitzungen](/docs/de/agent-view) erscheinen in der Auswahl mit `bg` gekennzeichnet | `claude --resume auth-refactor` |

128| `--safe-mode` | Starten Sie mit allen Anpassungen deaktiviert, um eine fehlerhafte Konfiguration zu beheben: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenbindungen, Statusleisten- und Dateivorschlagsbefehle, LSP-Server und automatischer Speicher werden nicht geladen. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal, was sich von [`--bare`](/docs/de/headless#start-faster-with-bare-mode) unterscheidet. Die Richtlinie für verwaltete Einstellungen gilt immer noch, einschließlich richtliniengesteuerter Hooks, Statusleiste und Dateivorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server nicht. Nützlich, um zu überprüfen, ob eine Anpassung das auslöst, was [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auslöst. Setzt [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars) | `claude --safe-mode` |128| `--safe-mode` | Starten Sie mit allen Anpassungen deaktiviert, um eine fehlerhafte Konfiguration zu beheben: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenbindungen, Status-Zeile und Datei-Vorschlagsbefehle, LSP-Server und automatischer Speicher werden nicht geladen. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal, was sich von [`--bare`](/docs/de/headless#start-faster-with-bare-mode) unterscheidet. Die Richtlinie für verwaltete Einstellungen gilt immer noch, einschließlich richtliniengesteuerter Hooks, Status-Zeile und Datei-Vorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server werden nicht geladen. Nützlich, um zu überprüfen, ob eine Anpassung das auslöst, was [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auslöst. Setzt [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars) | `claude --safe-mode` |

129| `--session-id` | Verwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |129| `--session-id` | Verwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | Durch Kommas getrennte Liste von Einstellungsquellen zum Laden (`user`, `project`, `local`) | `claude --setting-sources user,project` |130| `--setting-sources` | Durch Kommas getrennte Liste von Einstellungsquellen zum Laden (`user`, `project`, `local`). Siehe [Agent-Ansicht](/docs/de/agent-view#what-carries-over-when-you-background) und [Agent-Teams](/docs/de/agent-teams#context-and-communication) für die Sitzungen, die Sie von dieser aus starten und die Liste erben | `claude --setting-sources user,project` |

131| `--settings` | Pfad zu einer Einstellungs-JSON-Datei oder ein Inline-JSON-String. Werte, die Sie hier setzen, überschreiben die gleichen Schlüssel in Ihren `settings.json`-Dateien für diese Sitzung. Schlüssel, die Sie weglassen, behalten ihre dateigestützten Werte. Die Datei muss eine reguläre Datei sein, nicht größer als 2 MiB. Siehe [Einstellungspriorität](/docs/de/settings#settings-precedence) | `claude --settings ./settings.json` |131| `--settings` | Pfad zu einer Einstellungs-JSON-Datei oder ein Inline-JSON-String. Werte, die Sie hier setzen, überschreiben die gleichen Schlüssel in Ihren `settings.json`-Dateien für diese Sitzung. Schlüssel, die Sie weglassen, behalten ihre dateigestützten Werte. Die Datei muss eine reguläre Datei sein, nicht größer als 2 MiB. Siehe [Einstellungspriorität](/docs/de/settings#settings-precedence) | `claude --settings ./settings.json` |

132| `--strict-mcp-config` | Verwenden Sie nur MCP-Server aus `--mcp-config`, ignorieren Sie alle anderen MCP-Konfigurationen. Siehe [Exklusive Kontrolle mit managed-mcp.json](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json) für das, was die Flagge unter einer verwalteten MCP-Datei tut | `claude --strict-mcp-config --mcp-config ./mcp.json` |132| `--strict-mcp-config` | Verwenden Sie nur MCP-Server aus `--mcp-config`, ignorieren Sie alle anderen MCP-Konfigurationen. Siehe [Exklusive Kontrolle mit managed-mcp.json](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json) für das, was der Flag unter einer verwalteten MCP-Datei tut | `claude --strict-mcp-config --mcp-config ./mcp.json` |

135| `--system-prompt-snapshot` | Übergeben Sie `off`, um den System-Prompt bei jeder Anfrage neu zu erstellen, anstatt den Prompt [aufgezeichnet bei der ersten Anfrage der Konversation](#system-prompt-flags-in-resumed-conversations) wiederzuverwenden, z. B. während Sie die Formulierung über `--continue`-Läufe hinweg iterieren. Erfordert Claude Code v2.1.257 oder später | `claude --system-prompt-snapshot off` |135| `--system-prompt-snapshot` | Übergeben Sie `off`, um den System-Prompt bei jeder Anfrage neu zu erstellen, anstatt den Prompt [aufgezeichnet bei der ersten Anfrage der Konversation](#system-prompt-flags-in-resumed-conversations) wiederzuverwenden, z. B. während Sie den `--append-system-prompt`-Text über `--continue`-Läufe hinweg iterieren. Erfordert Claude Code v2.1.257 oder später | `claude --system-prompt-snapshot off` |

137| `--teammate-mode` | Legen Sie fest, wie [Agent-Team](/docs/de/agent-teams)-Teamkollegen angezeigt werden: `in-process` (Standard), `auto`, `tmux`, oder `iterm2`. Überschreibt die [`teammateMode`](/docs/de/settings-reference#teammatemode)-Einstellung für diese Sitzung. Siehe [Anzeigemodus wählen](/docs/de/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |137| `--teammate-mode` | Legen Sie fest, wie [Agent-Team](/docs/de/agent-teams)-Teamkollegen angezeigt werden: `in-process` (Standard), `auto`, `tmux` oder `iterm2`. Überschreibt die [`teammateMode`](/docs/de/settings-reference#teammatemode)-Einstellung für diese Sitzung. Siehe [Wählen Sie einen Anzeigemodus](/docs/de/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

138| `--tmux` | Erstellen Sie eine Tmux-Sitzung für den Worktree. Erfordert `--worktree`. Verwendet native iTerm2-Bereiche, wenn verfügbar; übergeben Sie `--tmux=classic` für traditionelles Tmux | `claude -w feature-auth --tmux` |138| `--tmux` | Erstellen Sie eine Tmux-Sitzung für den Worktree. Erfordert `--worktree`. Verwendet native iTerm2-Panes, wenn verfügbar; übergeben Sie `--tmux=classic` für traditionelles Tmux | `claude -w feature-auth --tmux` |

139| `--tools` | Beschränken Sie, welche integrierten Tools Claude verwenden kann. Verwenden Sie `""`, um alle zu deaktivieren, `"default"` für den Standard-Satz, oder Tool-Namen wie `"Bash,Edit,Read"`. Auf macOS, Linux und WSL lässt der Standard-Satz `Glob` und `Grep` weg, wie unter [Glob-Tool-Verhalten](/docs/de/tools-reference#glob-tool-behavior) beschrieben. Wenn Sie eines der [Task-Tracking-Tools](/docs/de/tools-reference#task-tool-availability) hier benennen, aktiviert Claude Code die Sitzung auch dafür. Die Flagge beeinflusst MCP-Tools nicht; um diese auch zu verweigern, verwenden Sie `--disallowedTools "mcp__*"`. Eine Liste, die [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) auslässt, entfernt es nicht; `""` entfernt es nur, wenn keine MCP-Tools verbleiben | `claude --tools "Bash,Edit,Read"` |139| `--tools` | Beschränken Sie, welche integrierten Tools Claude verwenden kann. Verwenden Sie `""`, um alle zu deaktivieren, `"default"` für den Standard-Satz, oder Tool-Namen wie `"Bash,Edit,Read"`. Auf macOS, Linux und WSL lässt der Standard-Satz `Glob` und `Grep` weg, wie unter [Glob-Tool-Verhalten](/docs/de/tools-reference#glob-tool-behavior) beschrieben. Wenn Sie eines der [Task-Tracking-Tools](/docs/de/tools-reference#task-tool-availability) hier benennen, aktiviert Claude Code die Sitzung auch. Der Flag beeinflusst nicht MCP-Tools; um diese auch zu verweigern, verwenden Sie `--disallowedTools "mcp__*"`. Eine Liste, die [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) auslässt, entfernt es nicht; `""` entfernt es nur, wenn keine MCP-Tools verbleiben | `claude --tools "Bash,Edit,Read"` |

140| `--verbose` | Aktivieren Sie ausführliches Logging, zeigt vollständige Turn-by-Turn-Ausgabe. Überschreibt die [`viewMode`](/docs/de/settings-reference#viewmode)-Einstellung für diese Sitzung | `claude --verbose` |140| `--verbose` | Aktivieren Sie ausführliches Logging, zeigt vollständige Turn-für-Turn-Ausgabe. Überschreibt die [`viewMode`](/docs/de/settings-reference#viewmode)-Einstellung für diese Sitzung | `claude --verbose` |

142| `--worktree`, `-w` | Starten Sie Claude in einem isolierten [Git-Worktree](/docs/de/worktrees) unter `<repo>/.claude/worktrees/<name>`. Wenn Sie keinen Namen angeben, generiert Claude Code einen. Übergeben Sie `#<number>`, eine GitHub-Pull-Request-URL oder eine GitLab-Merge-Request-URL, um [diesen PR oder MR von `origin` abzurufen und den Worktree davon zu verzweigen](/docs/de/worktrees#branch-from-a-pull-request). Das Verzweigen von einer GitLab-Merge-Request erfordert Claude Code v2.1.233 oder später | `claude -w feature-auth` |142| `--worktree`, `-w` | Starten Sie Claude in einem isolierten [Git-Worktree](/docs/de/worktrees) bei `<repo>/.claude/worktrees/<name>`. Wenn Sie keinen Namen angeben, generiert Claude Code einen. Übergeben Sie `#<number>`, eine GitHub-Pull-Request-URL oder eine GitLab-Merge-Request-URL, um [diesen PR oder MR von `origin` zu holen und den Worktree davon zu verzweigen](/docs/de/worktrees#branch-from-a-pull-request). Das Verzweigen von einem GitLab-Merge-Request erfordert Claude Code v2.1.233 oder später | `claude -w feature-auth` |

143 143

144<h3 id="system-prompt-flags">144<h3 id="system-prompt-flags">

145 System-Prompt-Flaggen145 System-Prompt-Flags

146</h3>146</h3>

147 147

148Claude Code bietet fünf Flaggen zum Anpassen des System-Prompts. Vier setzen seinen Text, und mit `--system-prompt-snapshot` kontrollieren Sie, ob eine Konversation den Text behält, mit dem sie begonnen hat. Alle fünf funktionieren sowohl im interaktiven als auch im nicht-interaktiven Modus.148Claude Code bietet fünf Flags zum Anpassen des System-Prompts. Vier setzen seinen Text, und mit `--system-prompt-snapshot` steuern Sie, ob eine Konversation den Text behält, mit dem sie gestartet wurde. Alle fünf funktionieren sowohl im interaktiven als auch im nicht-interaktiven Modus.

149 149

151| :- | :- | :- |151| :- | :- | :- |

156| `--system-prompt-snapshot` | Mit `off` wird der Prompt bei jeder Anfrage neu erstellt. Mit `on`, dem Standard, wird ein aufgezeichneter Prompt wiederverwendet, wo [Aufzeichnung gilt](#system-prompt-flags-in-resumed-conversations) | `claude --append-system-prompt "Draft rules" --system-prompt-snapshot off` |156| `--system-prompt-snapshot` | Mit `off` wird der Prompt bei jeder Anfrage neu erstellt. Mit `on`, dem Standard, wird ein aufgezeichneter Prompt wiederverwendet, wo [Aufzeichnung anwendbar ist](#system-prompt-flags-in-resumed-conversations) | `claude --append-system-prompt "Draft rules" --system-prompt-snapshot off` |

157 157

158`--system-prompt` und `--system-prompt-file` schließen sich gegenseitig aus. Die Append-Flaggen können mit einer der Ersetzungsflaggen kombiniert werden.158`--system-prompt` und `--system-prompt-file` schließen sich gegenseitig aus. Die Append-Flags können mit einem der Ersetzungs-Flags kombiniert werden.

159 159

160Wenn der Ersetzungstext Anweisungen kombiniert, die bei jedem Lauf gleich sind, mit Kontext, der sich pro Lauf ändert, fügen Sie eine Zeile ein, die nur `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` enthält, zwischen den Anweisungen und dem Kontext. Claude Code teilt den Prompt an der ersten solchen Zeile auf und entfernt diese Zeile, sodass der Teil darüber zwischengespeichert bleibt, während sich der Teil darunter ändert. Erfordert Claude Code v2.1.275 oder später. [Zwischengespeichern Sie den statischen Teil eines benutzerdefinierten Prompts](/docs/de/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) listet die Konfigurationen auf, wo die Aufteilung gilt.160Wenn der Ersetzungstext Anweisungen kombiniert, die bei jedem Lauf gleich sind, mit Kontext, der sich pro Lauf ändert, fügen Sie eine Zeile ein, die nur `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` enthält, zwischen den Anweisungen und dem Kontext. Claude Code teilt den Prompt an der ersten solchen Zeile und entfernt diese Zeile, sodass der Teil darüber zwischengespeichert bleibt, während der Teil darunter sich ändert. Erfordert Claude Code v2.1.275 oder später. [Zwischenspeichern Sie den statischen Teil eines benutzerdefinierten Prompts](/docs/de/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) listet die Konfigurationen auf, wo die Aufteilung anwendbar ist.

161 161

162Wählen Sie basierend darauf, ob Claudes Standard-Identität immer noch zu Ihrer Aufgabe passt. Verwenden Sie eine Append-Flagge, wenn Claude ein Coding-Assistent bleiben sollte, der auch Ihre zusätzlichen Regeln befolgt: Pro-Aufruf-Anweisungen, Ausgabeformatierung oder Domänenkontext für ein `-p`-Skript. Das Anhängen bewahrt die Standard-Tool-Anleitung, Sicherheitsanweisungen und Coding-Konventionen, daher müssen Sie nur das liefern, was sich unterscheidet. Verwenden Sie eine Ersetzungsflagge, wenn sich die Oberfläche, Identität oder das Berechtigungsmodell von Claude Code unterscheidet, wie ein nicht-Coding-Agent in einer Pipeline, die kein Mensch überwacht. Das Ersetzen lässt den gesamten Standard-Prompt fallen, einschließlich Tool-Anleitung und Sicherheitsanweisungen, daher übernehmen Sie die Verantwortung für das, was Ihre Aufgabe noch benötigt.162Wählen Sie basierend darauf, ob Claudes Standard-Identität immer noch zu Ihrer Task passt. Verwenden Sie ein Append-Flag, wenn Claude ein Coding-Assistent bleiben sollte, der auch Ihre zusätzlichen Regeln befolgt: Pro-Aufruf-Anweisungen, Ausgabeformatierung oder Domain-Kontext für ein `-p`-Skript. Das Anhängen bewahrt die Standard-Tool-Anleitung, Sicherheitsanweisungen und Coding-Konventionen, daher liefern Sie nur das, was sich unterscheidet. Verwenden Sie ein Ersetzungs-Flag, wenn sich die Oberfläche, Identität oder das Berechtigungsmodell von Claudes unterscheidet, wie ein Non-Coding-Agent in einer Pipeline, die kein Mensch beobachtet. Das Ersetzen lässt den gesamten Standard-Prompt fallen, einschließlich Tool-Anleitung und Sicherheitsanweisungen, daher übernehmen Sie die Verantwortung für das, was Ihre Task noch benötigt.

163 163

164Für persistente Personas, die Sie zwischen ihnen wechseln und über ein Projekt hinweg teilen können, verwenden Sie [Ausgabestile](/docs/de/output-styles). Für Projektkonventionen, die Claude immer befolgen sollte, verwenden Sie [CLAUDE.md](/docs/de/memory). Der [Agent SDK-Leitfaden zu System-Prompts](/docs/de/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) behandelt die gleiche Entscheidung ausführlicher.164Für persistente Personas, die Sie zwischen verschiedenen Personas wechseln und über ein Projekt hinweg teilen können, verwenden Sie [Ausgabestile](/docs/de/output-styles). Für Projektkonventionen, die Claude immer befolgen sollte, verwenden Sie [CLAUDE.md](/docs/de/memory). Der [Agent SDK-Leitfaden zu System-Prompts](/docs/de/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) behandelt die gleiche Entscheidung ausführlicher.

165 165

166<h4 id="system-prompt-flags-in-resumed-conversations">166<h4 id="system-prompt-flags-in-resumed-conversations">

167 System-Prompt-Flaggen in fortgesetzten Konversationen167 System-Prompt-Flags in fortgesetzten Konversationen

168</h4>168</h4>

169 169

170Standardmäßig erstellt Claude Code den System-Prompt einmal, bei der ersten Anfrage einer Konversation, mit dem Text aus allen angewendeten System-Prompt-Flaggen, und zeichnet ihn in der Sitzung auf. Bis die Konversation komprimiert wird, verwendet jede spätere Anfrage diesen aufgezeichneten Prompt, auch nachdem Sie zur Konversation mit `--resume` oder `--continue` zurückkehren. Wenn Sie beim späteren Start unterschiedlichen System-Prompt-Flag-Text übergeben oder keinen, tritt er in Kraft, sobald die Konversation komprimiert wird oder wenn Sie eine neue Konversation starten.170Standardmäßig erstellt Claude Code den System-Prompt einmal, bei der ersten Anfrage einer Konversation, mit dem Text aus allen angewendeten System-Prompt-Flags, und zeichnet ihn in der Sitzung auf. Bis die Konversation komprimiert wird, verwendet jede spätere Anfrage diesen aufgezeichneten Prompt, auch nachdem Sie zur Konversation mit `--resume` oder `--continue` zurückkehren. Wenn Sie bei diesem späteren Start unterschiedlichen System-Prompt-Flag-Text oder keinen übergeben, tritt er in Kraft, sobald die Konversation komprimiert wird oder wenn Sie eine neue Konversation starten.

171 171

172Außerhalb von [Cloud-Sitzungen](/docs/de/cloud-environments) startet Claude Code im [Bare-Modus](/docs/de/headless#start-faster-with-bare-mode) durch Übergabe von `--bare` oder Setzen von `CLAUDE_CODE_SIMPLE=1`, die Aufzeichnung bleibt aus, es sei denn, Sie übergeben `--system-prompt-snapshot on`. Vor v2.1.268 erstellten Sitzungen, die [Feature-Flags nicht abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), einschließlich Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, den Prompt bei jeder Anfrage neu und `--system-prompt-snapshot` hatte keine Auswirkung.172Außerhalb von [Cloud-Sitzungen](/docs/de/cloud-environments), wenn Sie Claude Code im [Bare-Modus](/docs/de/headless#start-faster-with-bare-mode) starten, indem Sie `--bare` übergeben oder `CLAUDE_CODE_SIMPLE=1` setzen, bleibt die Aufzeichnung aus, es sei denn, Sie übergeben `--system-prompt-snapshot on`. Vor v2.1.268 bauten Sitzungen, die keine [Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), einschließlich Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, den Prompt bei jeder Anfrage neu auf und `--system-prompt-snapshot` hatte keine Auswirkung.

173 173

174Um den Prompt bei jeder Anfrage neu zu erstellen, z. B. während Sie seine Formulierung über `--continue`-Läufe hinweg iterieren, übergeben Sie `--system-prompt-snapshot off`. Vor v2.1.265 schaltete das Übergeben einer der System-Prompt-Flaggen auch die Aufzeichnung aus, es sei denn, Sie übergaben `--system-prompt-snapshot on`.174Um den Prompt bei jeder Anfrage neu zu erstellen, z. B. während Sie seine Formulierung über `--continue`-Läufe hinweg iterieren, übergeben Sie `--system-prompt-snapshot off`. Vor v2.1.265 schaltete das Übergeben eines der System-Prompt-Flags auch die Aufzeichnung aus, es sei denn, Sie übergeben `--system-prompt-snapshot on`.

175 175

176<h2 id="see-also">176<h2 id="see-also">

177 Siehe auch177 Siehe auch

cloud-environments.md +49 −35

Details

78DATABASE_URL=postgres://localhost:5432/myapp78DATABASE_URL=postgres://localhost:5432/myapp

79```79```

80 80

81Jede Sitzung kopiert die Werte der Umgebung einmal beim Start in gewöhnliche Umgebungsvariablen, die jeder Befehl, den Claude ausführt, lesen kann. Da laufende Sitzungen die Konfiguration nicht erneut lesen, wirken sich Änderungen oder das Hinzufügen von Variablen auf Sitzungen aus, die Sie danach starten; Sitzungen, die bereits laufen, behalten die Werte, mit denen sie gestartet wurden.81Jede Sitzung kopiert die Werte der Umgebung einmal beim Start in gewöhnliche Umgebungsvariablen, die jeder Befehl, den Claude ausführt, lesen kann, außer `OTEL_*`-Variablen. Claude Code verwendet diese für seinen eigenen [Telemetrie-Export](/docs/de/monitoring-usage#telemetry-from-cloud-sessions-and-claude-tag) und übergibt sie nicht an die Befehle, die es ausführt. Da laufende Sitzungen die Konfiguration nicht erneut lesen, wirken sich Änderungen oder das Hinzufügen von Variablen auf Sitzungen aus, die Sie danach starten; Sitzungen, die bereits laufen, behalten die Werte, mit denen sie gestartet wurden.

82 82

83Eine Cloud-Sitzung setzt auch einige Variablen selbst, wenn sie startet. Für [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/de/claude-code-on-the-web#manage-context) überschreibt der Wert, den die Sitzung setzt, einen, den Sie hier hinzufügen, daher hat das Hinzufügen dieses Schlüssels hier keine Auswirkung.83Eine Cloud-Sitzung setzt auch einige Variablen selbst, wenn sie startet. Für [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/de/claude-code-on-the-web#manage-context) überschreibt der Wert, den die Sitzung setzt, einen, den Sie hier hinzufügen, daher hat das Hinzufügen dieses Schlüssels hier keine Auswirkung.

84 84

149* **GitHub**: der [GitHub-Proxy](#github-proxy) authentifiziert stattdessen Anfragen an GitHub, daher benötigen Sie keine API-Anmeldedaten dafür149* **GitHub**: der [GitHub-Proxy](#github-proxy) authentifiziert stattdessen Anfragen an GitHub, daher benötigen Sie keine API-Anmeldedaten dafür

150* **Die Anthropic API und öffentliche Paketregistrierungen**: `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io` und `proxy.golang.org`150* **Die Anthropic API und öffentliche Paketregistrierungen**: `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io` und `proxy.golang.org`

151* **Setup-Skript-Anfragen**: Claude Code verbindet sich mit dem Agent-Proxy, wenn er startet, nachdem das [Setup-Skript](#setup-scripts) ausgeführt wurde151* **Setup-Skript-Anfragen**: Claude Code verbindet sich mit dem Agent-Proxy, wenn er startet, nachdem das [Setup-Skript](#setup-scripts) ausgeführt wurde

152* **Claude Code's Telemetrie-Export**: Claude Code sendet seinen [Telemetrie-Export](/docs/de/monitoring-usage#telemetry-from-cloud-sessions-and-claude-tag) selbst, anstatt durch einen Befehl, den es ausführt, und diese Anfrage geht nicht durch den Agent-Proxy

152 153

153<h3 id="select-an-environment-from-the-cli">154<h3 id="select-an-environment-from-the-cli">

154 Wählen Sie eine Umgebung aus der CLI155 Wählen Sie eine Umgebung aus der CLI

179 180

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

181 182

182Gemeinsame Umgebungen erscheinen im [Umgebungswähler](#organization-shared-environments) jedes Mitglieds unter einer **Organisation**-Überschrift, nach den eigenen Umgebungen des Mitglieds unter **Persönlich**, damit ein Team sich auf eine Konfiguration standardisieren kann, statt dass jedes Mitglied sie neu erstellt. Das Auswählen des Einstellungssymbols einer gemeinsamen Umgebung dort öffnet eine schreibgeschützte Zusammenfassung ihrer Konfiguration für jedes Mitglied, einschließlich Owner.183Gemeinsame Umgebungen erscheinen im [Umgebungswähler](#configure-your-environment) jedes Mitglieds unter einer **Organisation**-Überschrift, nach den eigenen Umgebungen des Mitglieds unter **Persönlich**, damit ein Team sich auf eine Konfiguration standardisieren kann, statt dass jedes Mitglied sie neu erstellt. Das Auswählen des Einstellungssymbols einer gemeinsamen Umgebung dort öffnet eine schreibgeschützte Zusammenfassung ihrer Konfiguration für jedes Mitglied, einschließlich Owner.

183 184

184Ein Owner macht eine Umgebung der Organisation auf eine von zwei Arten verfügbar:185Ein Owner macht eine Umgebung der Organisation auf eine von zwei Arten verfügbar:

185 186

203 Netzwerkzugriff204 Netzwerkzugriff

204</h2>205</h2>

205 206

206Jede Umgebung setzt eine Netzwerkzugriffsstufe, die die ausgehenden Verbindungen steuert, die ihre Sitzungen herstellen können. Die Standard-Stufe, **Trusted**, erlaubt Paketregistrierungen und andere [auf die Whitelist gesetzte Domänen](#default-allowed-domains); **Custom** nimmt Ihre eigene Domänenliste.207Jede Umgebung legt eine Netzwerkzugriffsstufe fest, die steuert, welche ausgehenden Verbindungen ihre Sitzungen herstellen können. Die Standardstufe, **Vertraut**, ermöglicht Paketregistrierungen und andere [zulässige Domänen](#default-allowed-domains); **Benutzerdefiniert** verwendet Ihre eigene Domänenliste.

207 208

208Um die Netzwerkzugriffsstufe einer Umgebung zu ändern, [öffnen Sie sie zur Bearbeitung](#configure-your-environment) und verwenden Sie den **Network access**-Selector im Dialog. Eine [gemeinsame Umgebung](#organization-shared-environments) öffnet sich dort schreibgeschützt, daher ändert ein Owner seinen Netzwerkzugriff stattdessen von der Seite **Cloud environments** in den [Admin-Einstellungen](https://claude.ai/admin-settings). Das Cloud-Symbol, das den Selector öffnet, erscheint auf den App-Oberflächen, die unter [Die Standard-Umgebung](#the-default-environment) aufgelistet sind, und im [Routine-Editor](/docs/de/routines#environments-and-network-access); persönliche Umgebungen haben keine separate Seite in Ihren claude.ai-Kontoeinstellungen.209Um den Netzwerkzugriff einer Umgebung zu ändern, [öffnen Sie sie zum Bearbeiten](#configure-your-environment) und verwenden Sie den Selektor **Netzwerkzugriff** im Dialog. Eine [gemeinsam genutzte Umgebung](#organization-shared-environments) wird dort schreibgeschützt geöffnet, daher ändert ein Besitzer ihren Netzwerkzugriff stattdessen auf der Seite **Cloud-Umgebungen** in den [Admin-Einstellungen](https://claude.ai/admin-settings). Das Cloud-Symbol, das den Selektor öffnet, wird auf den App-Oberflächen angezeigt, die unter [Die Standardumgebung](#the-default-environment) aufgelistet sind, und im [Routine-Editor](/docs/de/routines#environments-and-network-access); persönliche Umgebungen haben keine separate Seite in Ihren claude.ai-Kontoeinstellungen.

209 210

210<Note>211<Note>

211 MCP-Konnektoren, die Sie auf einer Sitzung oder Routine aktivieren, funktionieren, ohne ihre Hosts zu **Allowed domains** hinzuzufügen, da der Konnektoren-Verkehr über Anthropic-Server verläuft, anstatt über das Netzwerk der Sitzung. Dies beruht auf dem gleichen Anthropic-gebundenen Kanal, der unter [Security and isolation](/docs/de/claude-code-on-the-web#security-and-isolation) erwähnt wird. Schalten Sie alle Konnektoren aus, die Sie nicht benötigen, um zu begrenzen, welche Tools Claude erreichen kann.212 MCP-Konnektoren, die Sie in einer Sitzung oder Routine aktivieren, funktionieren, ohne ihre Hosts zu **Zulässigen Domänen** hinzuzufügen, da der Konnektordatenverkehr über die Server von Anthropic verläuft und nicht über das Netzwerk der Sitzung. Dies basiert auf demselben Anthropic-gebundenen Kanal, der unter [Sicherheit und Isolation](/docs/de/claude-code-on-the-web#security-and-isolation) erwähnt wird. Deaktivieren Sie alle Konnektoren, die Sie nicht benötigen, um einzuschränken, auf welche Tools Claude zugreifen kann.

212</Note>213</Note>

213 214

214<h3 id="access-levels">215<h3 id="access-levels">

215 Zugriffsstufen216 Zugriffsstufen

216</h3>217</h3>

217 218

218Das Feld **Network access** im [Umgebungs-Dialog](#configure-your-environment) nimmt eine von vier Stufen:219Das Feld **Netzwerkzugriff** im [Umgebungsdialog](#configure-your-environment) akzeptiert eine von vier Stufen:

219 220

220| Stufe | Ausgehende Verbindungen |221| Stufe | Ausgehende Verbindungen |

221| :- | :- |222| :- | :- |

222| **None** | Kein ausgehender Netzwerkzugriff über das Netzwerk der Sitzung |223| **Keine** | Kein ausgehender Netzwerkzugriff über das Netzwerk der Sitzung |

223| **Trusted** | Nur [auf die Whitelist gesetzte Domänen](#default-allowed-domains): Paketregistrierungen, GitHub, Cloud-SDKs |224| **Vertraut** | Nur [zulässige Domänen](#default-allowed-domains): Paketregistrierungen, GitHub, Cloud-SDKs |

224| **Full** | Jede Domäne |225| **Vollständig** | Jede Domäne |

225| **Custom** | Ihre eigene Whitelist, optional einschließlich der Standards |226| **Benutzerdefiniert** | Ihre eigene Zulassungsliste, optional einschließlich der Standardwerte |

226 227

227Welche Stufe Sie auch wählen, Sitzungen können diese immer noch erreichen, da jede einen Pfad nimmt, der nicht durch die Netzwerk-Whitelist der Sitzung geht:228Unabhängig davon, welche Stufe Sie wählen, können Sitzungen diese trotzdem erreichen, da jede einen Pfad nimmt, der nicht durch die Zulassungsliste des Netzwerks der Sitzung verläuft:

228 229

229* GitHub, durch seinen [separaten Proxy](#github-proxy)230* GitHub, über seinen [separaten Proxy](#github-proxy)

230* [MCP-Konnektoren](#network-access), die Sie aktivieren, deren Verkehr über Anthropic-Server verläuft231* [MCP-Konnektoren](#network-access), die Sie aktivieren, deren Datenverkehr über die Server von Anthropic verläuft

231* Die Hosts, die Sie auf den [API-Anmeldedaten](#add-api-credentials) der Umgebung aufgelistet haben, außer den [Hosts, die der Agent-Proxy überspringt](#requests-that-never-get-the-credential)232* Die Hosts, die Sie in den [API-Anmeldedaten](#add-api-credentials) der Umgebung aufgelistet haben, außer den [Hosts, die die Anmeldedaten niemals erhalten](#requests-that-never-get-the-credential)

232* Die Anthropic-API, für Claude Code-eigene Anfragen, auch bei **None**, wie unter [Security and isolation](/docs/de/claude-code-on-the-web#security-and-isolation) erwähnt233* Die Anthropic-API für die eigenen Anfragen von Claude Code, auch bei **Keine**, wie unter [Sicherheit und Isolation](/docs/de/claude-code-on-the-web#security-and-isolation) erwähnt

233 234

234<h3 id="allow-specific-domains">235<h3 id="allow-specific-domains">

235 Erlauben Sie bestimmte Domänen236 Bestimmte Domänen zulassen

236</h3>237</h3>

237 238

238Um Domänen zu erlauben, die nicht in der Trusted-Liste sind, wählen Sie **Custom** in den Netzwerkzugriff-Einstellungen der Umgebung, dann listen Sie eine Domäne pro Zeile im Feld **Allowed domains** auf. Dieses Beispiel erlaubt drei Hosts, die ein internes Projekt benötigen könnte.239Um Domänen zuzulassen, die nicht in der Liste „Vertraut" enthalten sind, wählen Sie **Benutzerdefiniert** in den Netzwerkzugriffseinstellungen der Umgebung aus und listen Sie dann eine Domäne pro Zeile im Feld **Zulässige Domänen** auf. Dieses Beispiel ermöglicht drei Hosts, die ein internes Projekt möglicherweise benötigt.

239 240

240```text theme={null}241```text theme={null}

241api.example.com242api.example.com

243registry.example.com244registry.example.com

244```245```

245 246

246Sitzungen in dieser Umgebung können jetzt `api.example.com`, jede Subdomain von `internal.example.com` und `registry.example.com` erreichen, und keine anderen Domänen über das Netzwerk der Sitzung. [GitHub-Verkehr](#github-proxy), [MCP-Konnektoren-Verkehr](#network-access) und Anfragen an die Hosts der [API-Anmeldedaten](#add-api-credentials) der Umgebung, außer den [Hosts, die der Agent-Proxy überspringt](#requests-that-never-get-the-credential), gehen nicht durch diese Whitelist. Ein führendes `*.` passt zu jeder Subdomain. Um die [Trusted-Domänen](#default-allowed-domains) auch zu behalten, aktivieren Sie **Also include default list of common package managers**; lassen Sie es deaktiviert, um nur das zu erlauben, was Sie auflisten.247Sitzungen in dieser Umgebung können jetzt auf `api.example.com`, jede Subdomäne von `internal.example.com` und `registry.example.com` zugreifen, und auf keine anderen Domänen über das Netzwerk der Sitzung. [GitHub-Datenverkehr](#github-proxy), [MCP-Konnektordatenverkehr](#network-access) und Anfragen an die Hosts der [API-Anmeldedaten](#add-api-credentials) der Umgebung, außer den [Hosts, die die Anmeldedaten niemals erhalten](#requests-that-never-get-the-credential), gehen nicht durch diese Zulassungsliste. Ein führendes `*.` entspricht jeder Subdomäne. Um die [vertrauten Domänen](#default-allowed-domains) ebenfalls zu behalten, aktivieren Sie **Auch Standardliste häufiger Paketmanager einschließen**; lassen Sie es deaktiviert, um nur das zuzulassen, was Sie auflisten.

247 248

248Wenn Ihre Organisation [Artifacts](/docs/de/artifacts#availability) verwendet, benötigen Sie `*.frame.claudeusercontent.com` nicht in der Liste, damit Sitzungen sie lesen können. Wenn die Liste diesen Host auslässt, liest Claude Code Artifact-Inhalte stattdessen über die Verbindung der Sitzung zu Anthropic. Behalten Sie den Host in einer Whitelist in zwei Situationen:249Wenn Ihre Organisation [Artefakte](/docs/de/artifacts#availability) verwendet, benötigen Sie `*.frame.claudeusercontent.com` nicht in der Liste, damit Sitzungen diese lesen können. Wenn die Liste diesen Host auslässt, liest Claude Code Artefaktinhalte stattdessen über die Verbindung der Sitzung zu Anthropic. Behalten Sie den Host in einer Zulassungsliste in zwei Situationen:

249 250

250* **Sitzungen in dieser Umgebung öffnen öffentliche Artifacts einer anderen Organisation**: Claude Code ruft diese direkt vom Host ab, daher fügen Sie ihn zu dieser Liste hinzu.251* **Sitzungen in dieser Umgebung öffnen öffentliche Artefakte einer anderen Organisation**: Claude Code ruft diese direkt vom Host ab, daher fügen Sie ihn dieser Liste hinzu.

251* **Sie konfigurieren die lokale CLI oder einen selbstgehosteten Runner**: behalten Sie den Host in dieser Whitelist. Siehe [Netzwerkzugriff-Anforderungen](/docs/de/network-config#network-access-requirements) und die selbstgehosteten [Netzwerk-Anforderungen](/docs/de/self-hosted-environments-deploy#network-requirements).252* **Sie konfigurieren die lokale CLI oder einen selbstgehosteten Runner**: Behalten Sie den Host in dieser Zulassungsliste. Siehe [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) und die [Netzwerkanforderungen](/docs/de/self-hosted-environments-deploy#network-requirements) des selbstgehosteten Runners.

252 253

253Jede Umgebung hat ihre eigene Whitelist für zulässige Domänen; es gibt keine Organisations-Whitelist, die Administratoren an die Umgebungen jedes Mitglieds pushen können. [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) gelten immer noch in Cloud-Sitzungen, aber keine von ihnen fügt Domänen zur Netzwerk-Whitelist der Umgebung hinzu. Um einem Team eine Standard-Liste zu geben, kann ein Owner eine [organisationsweite gemeinsame Umgebung](#organization-shared-environments) mit **Custom**-Netzwerkzugriff und dieser Liste erstellen.254Jede Umgebung hat ihre eigene Liste zulässiger Domänen; es gibt keine Zulassungsliste auf Organisationsebene, die Administratoren an die Umgebungen jedes Mitglieds übertragen können. Auch keine [serverseitig verwaltete Einstellung](/docs/de/server-managed-settings) fügt Domänen zur Netzwerkzulassungsliste einer Umgebung hinzu. Um einem Team eine Standardliste zu geben, kann ein Besitzer eine [gemeinsam genutzte Organisationsumgebung](#organization-shared-environments) mit **Benutzerdefiniertem** Netzwerkzugriff und dieser Liste erstellen.

254 255

255<h3 id="github-proxy">256<h3 id="github-proxy">

256 GitHub-Proxy257 GitHub-Proxy

257</h3>258</h3>

258 259

259In von Anthropic gehosteten Umgebungen gehen alle GitHub-Operationen durch einen dedizierten Proxy, der Ihre echten GitHub-Anmeldedaten außerhalb der Sitzungs-VM hält, unabhängig von der [Zugriffsstufe](#access-levels) der Umgebung. Sitzungen in einer selbstgehosteten Umgebung authentifizieren Git-Operationen mit Anmeldedaten, die Ihre Bereitstellung bereitstellt; [Configure git](/docs/de/self-hosted-environments-deploy#configure-git) behandelt die Optionen, einschließlich pro-Sitzung geprägter Anmeldedaten und eines Opt-in zu diesem gleichen Proxy. Der Proxy bietet:260In von Anthropic gehosteten Umgebungen gehen alle GitHub-Operationen durch einen dedizierten Proxy, der Ihre echten GitHub-Anmeldedaten außerhalb der VM der Sitzung hält, unabhängig von der [Zugriffsstufe](#access-levels) der Umgebung. Sitzungen in einer selbstgehosteten Umgebung authentifizieren Git-Operationen mit Anmeldedaten, die Ihre Bereitstellung bereitstellt; [Git konfigurieren](/docs/de/self-hosted-environments-deploy#configure-git) behandelt die Optionen, einschließlich pro-Sitzung ausgegebener Anmeldedaten und einer Opt-in zu diesem gleichen Proxy. Der Proxy bietet:

260 261

261* **Git-Anmeldedaten**: Der Git-Client in der VM verwendet eine begrenzte Anmeldedaten, die der Proxy überprüft und gegen Ihren echten GitHub-Token austauscht.262* **Git-Anmeldedaten**: Der Git-Client in der VM verwendet eine begrenzte Anmeldedaten, die der Proxy überprüft und gegen Ihr echtes GitHub-Token austauscht.

262* **API-Anfragen**: Anfragen von den integrierten GitHub-Tools und von `gh` unter dem [`proxy-injected`-Platzhalter](#work-with-github-issues-and-pull-requests) gehen mit Ihren echten Anmeldedaten aus.263* **API-Anfragen**: Anfragen von den integrierten GitHub-Tools und von `gh` unter dem [`proxy-injected` Platzhalter](#work-with-github-issues-and-pull-requests) gehen mit Ihren echten Anmeldedaten aus.

263* **Push-Schutz**: `git push` funktioniert nur gegen den aktuellen Arbeitszweig der Sitzung; Klonen, Abrufen und PR-Operationen funktionieren normal.264* **Push-Schutz**: `git push` funktioniert nur gegen den aktuellen Arbeitszweig der Sitzung; Klonen, Abrufen und PR-Operationen funktionieren normal.

264* **Repository-Bereich**: GitHub-API und Release-Asset-Anfragen erreichen nur Repositories, die an die Sitzung angehängt sind, daher erhält ein Setup-Skript, das Release-Assets aus einem nicht angehängten Repository herunterlädt, einen 403.265* **Repository-Bereich**: GitHub-API und Release-Asset-Anfragen erreichen nur Repositories, die an die Sitzung angehängt sind, daher erhält ein Setup-Skript, das Release-Assets aus einem nicht angehängten Repository herunterlädt, einen 403.

265* **GraphQL-Einschränkungen**: der Proxy bedient nur einen angehefteten Satz von GraphQL-Operationen für Pull-Request-Workflows. Der Proxy lehnt alles andere auf dem GraphQL-Endpunkt mit einem 403 ab, der sagt `This GraphQL query is not enabled for this session` und nennt den REST-Fallback, `gh api repos/{owner}/{repo}/...`. Die Einschränkung gilt für jede Anfrage durch den Proxy, unabhängig von den Anmeldedaten, die Sie bereitstellen, daher erhält ein `GH_TOKEN`, den Sie setzen, den gleichen 403. Claude kann GitHub-APIs, die nur in GraphQL existieren, wie Projects v2, nicht durch den Proxy erreichen.266* **GraphQL-Einschränkungen**: Der Proxy bedient nur einen festgelegten Satz von GraphQL-Operationen für Pull-Request-Workflows. Der Proxy lehnt alles andere auf dem GraphQL-Endpunkt mit einem 403 ab, der besagt `This GraphQL query is not enabled for this session` und nennt den REST-Fallback, `gh api repos/{owner}/{repo}/...`. Die Einschränkung gilt für jede Anfrage durch den Proxy, unabhängig von den Anmeldedaten, die Sie bereitstellen, daher erhält ein `GH_TOKEN`, das Sie setzen, den gleichen 403. Claude kann nicht auf GitHub-APIs zugreifen, die nur in GraphQL vorhanden sind, wie Projects v2, über den Proxy.

266 267

267Committed-Dateien aus öffentlichen Repositories kommen über `raw.githubusercontent.com` an, das der [Sicherheits-Proxy](#security-proxy) stattdessen handhabt. Diese Domäne ist in der Standard-[Trusted-Liste](#default-allowed-domains), daher bleiben diese Dateien erreichbar, es sei denn, die [Zugriffsstufe](#access-levels) der Umgebung schließt sie aus.268Committete Dateien aus öffentlichen Repositories kommen über `raw.githubusercontent.com` an, das der [Sicherheitsproxy](#security-proxy) stattdessen verarbeitet. Diese Domäne befindet sich in der Standard-[Vertraut-Liste](#default-allowed-domains), daher bleiben diese Dateien erreichbar, es sei denn, die [Zugriffsstufe](#access-levels) der Umgebung schließt sie aus.

268 269

269<h3 id="security-proxy">270<h3 id="security-proxy">

270 Sicherheits-Proxy271 Sicherheitsproxy

271</h3>272</h3>

272 273

273Cloud-Sitzungen in von Anthropic gehosteten Umgebungen laufen hinter einem HTTP/HTTPS-Netzwerk-Proxy für Sicherheits- und Missbrauchspräventionszwecke; in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments-deploy#default-deny-egress) verläuft ausgehender Verkehr stattdessen durch Ihre eigene Netzwerk-Grenze. Der gesamte ausgehende Internet-Verkehr aus einer von Anthropic gehosteten Sitzung verläuft durch diesen Proxy, der Folgendes bietet:274Cloud-Sitzungen in von Anthropic gehosteten Umgebungen laufen hinter einem HTTP/HTTPS-Netzwerk-Proxy für Sicherheits- und Missbrauchspräventionszwecke; in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments-deploy#default-deny-egress) verläuft ausgehender Datenverkehr stattdessen über Ihre eigene Netzwerkgrenze. Der gesamte ausgehende Internetdatenverkehr aus einer von Anthropic gehosteten Sitzung verläuft durch diesen Proxy, der Folgendes bietet:

274 275

275* Schutz vor böswilligen Anfragen276* Schutz vor böswilligen Anfragen

276* Ratenbegrenzung und Missbrauchsprävention277* Ratenbegrenzung und Missbrauchsprävention

281 Was ist in Cloud-Sitzungen verfügbar282 Was ist in Cloud-Sitzungen verfügbar

282</h2>283</h2>

283 284

284In von Anthropic gehosteten Umgebungen erhält jede Sitzung eine frische virtuelle Maschine (VM) mit Ubuntu 24.04 auf x86\_64, unabhängig von Ihrem eigenen Betriebssystem und CPU-Architektur, mit Ihrem geklonten Repository und vorinstallierten gängigen Toolchains. Wenn eine Abhängigkeit vorkompilierte Binärdateien bereitstellt, wie Ruby-Gems mit nativen Erweiterungen oder vorgefertigte Python-Wheels, verwenden Sie seinen x86\_64 Linux-Build, um die VM zu entsprechen. Dieser Abschnitt behandelt die von Anthropic gehosteten Standardeinstellungen, die integrierten GitHub-Tools, wie man [Tests und Services ausführt](#run-tests-start-services-and-add-packages) und die [Ressourcenlimits](#resource-limits), die jede VM erhält.285In von Anthropic gehosteten Umgebungen erhält jede Sitzung eine frische virtuelle Maschine (VM) mit Ubuntu 24.04 auf x86\_64, unabhängig von Ihrem eigenen Betriebssystem und CPU-Architektur, mit Ihrem geklonten Repository und vorinstallierten gängigen Toolchains. Wenn eine Abhängigkeit vorkompilierte Binärdateien bereitstellt, wie Ruby-Gems mit nativen Erweiterungen oder vorgefertigte Python-Wheels, verwenden Sie seinen x86\_64 Linux-Build, um die VM zu entsprechen. Dieser Abschnitt behandelt die von Anthropic gehosteten Standardeinstellungen, die integrierten GitHub-Tools, wie man [Tests und Services ausführt](#run-tests-start-services-and-add-packages), die [Ressourcenlimits](#resource-limits), die jede VM erhält, und die [Zeitlimits](#time-limits) für langfristige Arbeiten.

285 286

286<Note>287<Note>

287 Sitzungen, die Ihre Organisation zu einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) leitet, laufen stattdessen auf Ihren eigenen Runnern mit den Tools, die Ihr Runner-Image bereitstellt.288 Sitzungen, die Ihre Organisation zu einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) leitet, laufen stattdessen auf Ihren eigenen Runnern mit den Tools, die Ihr Runner-Image bereitstellt.

301| Das `.claude/rules/` Ihres Repos | Ja | Teil des Klons |302| Das `.claude/rules/` Ihres Repos | Ja | Teil des Klons |

302| Die `.claude/skills/`, `.claude/agents/`, `.claude/commands/` Ihres Repos | Ja | Teil des Klons |303| Die `.claude/skills/`, `.claude/agents/`, `.claude/commands/` Ihres Repos | Ja | Teil des Klons |

303| Plugins und Marketplaces, die in der `.claude/settings.json` Ihres Repos deklariert sind | Nein | Eine Cloud-Sitzung installiert nicht die Plugins, die ein Repository unter [`enabledPlugins`](/docs/de/settings-reference#enabledplugins) aktiviert, einschließlich solcher aus den Marketplaces, die es unter [`extraKnownMarketplaces`](/docs/de/settings-reference#extraknownmarketplaces) auflistet |304| Plugins und Marketplaces, die in der `.claude/settings.json` Ihres Repos deklariert sind | Nein | Eine Cloud-Sitzung installiert nicht die Plugins, die ein Repository unter [`enabledPlugins`](/docs/de/settings-reference#enabledplugins) aktiviert, einschließlich solcher aus den Marketplaces, die es unter [`extraKnownMarketplaces`](/docs/de/settings-reference#extraknownmarketplaces) auflistet |

304| Die [Server-verwalteten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation | Ja | Abgerufen von Anthropic-Servern, wenn die Sitzung startet. Siehe [Surface coverage](/docs/de/model-config#surface-coverage) für die Durchsetzung von `availableModels` in Cloud-Sitzungen. Einstellungen, die auf Ihrem Gerät über MDM oder verwaltete Einstellungsdateien bereitgestellt werden, gelten nicht, da die Sitzung auf einer von Anthropic verwalteten VM läuft; in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) lesen Sitzungen auch die verwaltete Einstellungsdatei im Runner-Image, pro [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) |305| Die [Server-verwalteten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation | Ja, außer in [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen | Abgerufen von Anthropic-Servern, wenn die Sitzung startet. Siehe [Surface coverage](/docs/de/model-config#surface-coverage) für die Durchsetzung von `availableModels` in Cloud-Sitzungen. Einstellungen, die auf Ihrem Gerät über MDM oder verwaltete Einstellungsdateien bereitgestellt werden, gelten nicht, da die Sitzung auf einer von Anthropic verwalteten VM läuft; in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) lesen Sitzungen auch die verwaltete Einstellungsdatei im Runner-Image, pro [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) |

306| Ihre Benutzer `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Nein | Leben auf Ihrem Computer, nicht im Repo. Committen Sie sie stattdessen in das Verzeichnis `.claude/` des Repos. Cloud-Sitzungen laden automatisch Skills, die Sie auf claude.ai aktivieren |307| Ihre Benutzer `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Nein | Leben auf Ihrem Computer, nicht im Repo. Committen Sie sie stattdessen in das Verzeichnis `.claude/` des Repos. Cloud-Sitzungen laden automatisch Skills, die Sie auf claude.ai aktivieren |

421 422

422Die VM kann Aufgaben stoppen, die erheblich mehr Speicher benötigen, wie große Build-Jobs oder speicherintensive Tests. Für Workloads jenseits dieser Limits verwenden Sie [Remote Control](/docs/de/remote-control), um Claude Code auf Ihrer eigenen Hardware auszuführen, oder führen Sie Cloud-Sitzungen in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) auf Compute aus, die Ihre Organisation betreibt.423Die VM kann Aufgaben stoppen, die erheblich mehr Speicher benötigen, wie große Build-Jobs oder speicherintensive Tests. Für Workloads jenseits dieser Limits verwenden Sie [Remote Control](/docs/de/remote-control), um Claude Code auf Ihrer eigenen Hardware auszuführen, oder führen Sie Cloud-Sitzungen in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) auf Compute aus, die Ihre Organisation betreibt.

423 424

425<h3 id="time-limits">

426 Zeitlimits

427</h3>

428

429In von Anthropic gehosteten Umgebungen gelten diese Zeitlimits für langfristige Arbeiten in einer Cloud-Sitzung, wie ein Build, eine Installation oder ein Test-Lauf. Jeder Eintrag verlinkt auf den Abschnitt, der das Limit definiert.

430

431* **Befehle, die Claude ausführt**: Eine Cloud-Umgebung setzt kein eigenes Befehls-Timeout, daher gelten die Standardeinstellungen des Bash-Tools. Claude wartet standardmäßig 2 Minuten auf einen Befehl und kann bis zu 10 Minuten anfordern. Wenn ein Befehl sein [Timeout](/docs/de/tools-reference#timeout-and-output-limits) erreicht, [verschiebt Claude Code ihn in den Hintergrund](/docs/de/tools-reference#background-commands), anstatt ihn zu stoppen, es sei denn, der Befehl beginnt mit `sleep`.

432* **SessionStart-Hooks**: Claude Code bricht einen `command`-Hook nach 600 Sekunden ab, es sei denn, Sie setzen [`timeout`](/docs/de/hooks#common-fields) in Sekunden auf dem Hook-Eintrag. Claude Code erzwingt das Timeout nicht auf einem Hook, den Sie mit [`async: true`](/docs/de/hooks#run-hooks-in-the-background) ausführen.

433* **Setup-Skript**: Ein Skript, das länger als ungefähr fünf Minuten dauert, wird nicht gecacht. [Script-Anforderungen](#script-requirements) behandelt, wie Sie darunter bleiben.

434* **Untätige Sitzungen**: Eine Sitzung stoppt nach einer Inaktivitätsperiode und ihre VM wird freigegeben. [Environment expired](/docs/de/claude-code-on-the-web#environment-expired) behandelt, was als inaktiv zählt und wie Sie die Sitzung erneut öffnen.

435

436Um die Befehls-Timeouts für die Sitzungen einer Umgebung zu erhöhen, fügen Sie [`BASH_DEFAULT_TIMEOUT_MS` und `BASH_MAX_TIMEOUT_MS`](/docs/de/env-vars#variables) zu ihren [Umgebungsvariablen](#set-environment-variables) hinzu. Beide nehmen Millisekunden. Zum Beispiel macht `BASH_DEFAULT_TIMEOUT_MS=600000` 10 Minuten zur Standardeinstellung.

437

424<h2 id="setup-scripts">438<h2 id="setup-scripts">

425 Setup-Skripte439 Setup-Skripte

426</h2>440</h2>

445Ein Setup-Skript hat drei Einschränkungen, die Sie beachten müssen:459Ein Setup-Skript hat drei Einschränkungen, die Sie beachten müssen:

446 460

447* **Mit Null beenden**: Wenn das Skript mit einem Nicht-Null-Wert beendet wird, schlägt der Sitzungsstart fehl. Fügen Sie `|| true` an nicht kritische Befehle an, damit ein gelegentlicher Installationsfehler die Sitzung nicht blockiert.461* **Mit Null beenden**: Wenn das Skript mit einem Nicht-Null-Wert beendet wird, schlägt der Sitzungsstart fehl. Fügen Sie `|| true` an nicht kritische Befehle an, damit ein gelegentlicher Installationsfehler die Sitzung nicht blockiert.

448* **Innerhalb von fünf Minuten fertig**: Halten Sie die Gesamtlaufzeit des Skripts unter etwa fünf Minuten, damit der [Umgebungs-Cache](#environment-caching) erstellt werden kann. Führen Sie unabhängige Installationen parallel mit `&` und `wait` aus, und verschieben Sie jeden einzelnen Download, der nicht passt, in einen [SessionStart-Hook](#setup-scripts-vs-sessionstart-hooks), der ihn im Hintergrund startet.462* **Innerhalb von fünf Minuten fertig**: Halten Sie die Gesamtlaufzeit des Skripts unter etwa fünf Minuten, damit der [Umgebungs-Cache](#environment-caching) erstellt werden kann. Wenn Setup länger dauert, wird die Umgebung nicht zwischengespeichert. Führen Sie unabhängige Installationen parallel mit `&` und `wait` aus, und verschieben Sie jeden einzelnen Download, der nicht passt, in einen [SessionStart-Hook](#setup-scripts-vs-sessionstart-hooks), der ihn im Hintergrund startet. Wenn neue Sitzungen während des Setups hängen bleiben oder zeitüberschreitung auftreten, siehe [Neue Sitzungen hängen oder zeitüberschreitung während des Setups](/docs/de/web-quickstart#new-sessions-hang-or-time-out-during-setup).

449* **Netzwerkzugriff für Installationen**: Paketinstallationen müssen Registries erreichen. Die Standard-Stufe **Vertraut** deckt [häufige Paket-Registries](#default-allowed-domains) ab, einschließlich npm, PyPI, RubyGems und crates.io; mit **Keine** Netzwerkzugriff schlagen Installationen fehl.463* **Netzwerkzugriff für Installationen**: Paketinstallationen müssen Registries erreichen. Die Standard-Stufe **Vertraut** deckt [häufige Paket-Registries](#default-allowed-domains) ab, einschließlich npm, PyPI, RubyGems und crates.io; mit **Keine** Netzwerkzugriff schlagen Installationen fehl.

450 464

451<h3 id="environment-caching">465<h3 id="environment-caching">

452 Umgebungs-Caching466 Umgebungs-Caching

453</h3>467</h3>

454 468

455Das Setup-Skript wird beim ersten Mal ausgeführt, wenn Sie eine Sitzung in einer Umgebung starten. Nach Abschluss erstellt Anthropic einen Snapshot des Dateisystems und verwendet diesen Snapshot als Ausgangspunkt für spätere Sitzungen. Neue Sitzungen starten mit Ihren Abhängigkeiten, Tools und Docker-Images bereits auf der Festplatte und überspringen den Setup-Skript-Schritt. Dies hält den Start schnell, auch wenn das Skript große Toolchains installiert oder Container-Images abruft.469Das Setup-Skript wird beim ersten Mal ausgeführt, wenn Sie eine Sitzung in einer Umgebung starten. Wenn das Setup innerhalb von [etwa fünf Minuten](#script-requirements) abgeschlossen ist, erstellt Anthropic einen Snapshot des Dateisystems und verwendet diesen Snapshot als Ausgangspunkt für spätere Sitzungen. Neue Sitzungen starten mit Ihren Abhängigkeiten, Tools und Docker-Images bereits auf der Festplatte und überspringen den Setup-Skript-Schritt. Dies hält den Start schnell, auch wenn das Skript große Toolchains installiert oder Container-Images abruft. Wenn Setup länger als etwa fünf Minuten dauert, wird die Umgebung nicht zwischengespeichert.

456 470

457Der Cache ist ein Dateisystem-Snapshot, daher behält er, was das Setup-Skript auf die Festplatte schreibt, und verliert alles, das nur ausgeführt wurde. Pakete, die Sie installieren, Docker-Images, die Sie abrufen, und Dateien, die Sie schreiben, werden alle übertragen. Eine Datenbank, die das Skript gestartet hat, ein `docker compose up`-Stack oder ein anderer Hintergrundprozess nicht; starten Sie diese pro Sitzung, indem Sie Claude fragen oder einen [SessionStart-Hook](#setup-scripts-vs-sessionstart-hooks) verwenden.471Der Cache ist ein Dateisystem-Snapshot, daher behält er, was das Setup-Skript auf die Festplatte schreibt, und verliert alles, das nur ausgeführt wurde. Pakete, die Sie installieren, Docker-Images, die Sie abrufen, und Dateien, die Sie schreiben, werden alle übertragen. Eine Datenbank, die das Skript gestartet hat, ein `docker compose up`-Stack oder ein anderer Hintergrundprozess nicht; starten Sie diese pro Sitzung, indem Sie Claude fragen oder einen [SessionStart-Hook](#setup-scripts-vs-sessionstart-hooks) verwenden.

458 472

476 490

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

478 492

479* **Von Anthropic gehostete Umgebung**: Claude Code führt Hooks aus dem Repository und aus den [servergesteuerten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation aus.493* **Von Anthropic gehostete Umgebung**: Claude Code führt Hooks aus dem Repository und aus den [servergesteuerten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation aus. [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen erhalten keine servergesteuerten Einstellungen, daher werden Hooks aus servergesteuerten Einstellungen dort nicht ausgeführt.

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

481 495

482<h3 id="install-dependencies-with-a-sessionstart-hook">496<h3 id="install-dependencies-with-a-sessionstart-hook">

808* [Remote Control](/docs/de/remote-control): Führen Sie Sitzungen auf dem Netzwerk und den Dateien Ihres eigenen Computers aus822* [Remote Control](/docs/de/remote-control): Führen Sie Sitzungen auf dem Netzwerk und den Dateien Ihres eigenen Computers aus

809* [Selbstgehostete Umgebungen](/docs/de/self-hosted-environments): Führen Sie Cloud-Sitzungen auf der eigenen Infrastruktur Ihrer Organisation aus823* [Selbstgehostete Umgebungen](/docs/de/self-hosted-environments): Führen Sie Cloud-Sitzungen auf der eigenen Infrastruktur Ihrer Organisation aus

810* [SessionStart Hooks](/docs/de/hooks#sessionstart): Repo-committed Setup, das in lokalen und Cloud-Sitzungen ausgeführt wird824* [SessionStart Hooks](/docs/de/hooks#sessionstart): Repo-committed Setup, das in lokalen und Cloud-Sitzungen ausgeführt wird

811* [Server-verwaltete Einstellungen](/docs/de/server-managed-settings): Organisations-Richtlinie, die Cloud-Sitzungen erreicht825* [Server-verwaltete Einstellungen](/docs/de/server-managed-settings): Organisations-Richtlinie, die von der Admin-Konsole bereitgestellt wird

code-review.md +3 −3

Details

48| 🟡 | Nit | Ein kleineres Problem, das behoben werden sollte, aber nicht blockierend ist |48| 🟡 | Nit | Ein kleineres Problem, das behoben werden sollte, aber nicht blockierend ist |

49| 🟣 | Bereits vorhanden | Ein Fehler, der in der Codebasis vorhanden ist, aber nicht durch diesen PR eingeführt wurde |49| 🟣 | Bereits vorhanden | Ein Fehler, der in der Codebasis vorhanden ist, aber nicht durch diesen PR eingeführt wurde |

50 50

51Erkenntnisse enthalten einen ausklappbaren erweiterten Reasoning-Bereich, den Sie erweitern können, um zu verstehen, warum Claude das Problem gekennzeichnet hat und wie es das Problem überprüft hat.51Erkenntnisse enthalten einen ausklappbaren Bereich **Warum dies gekennzeichnet wurde**, den Sie erweitern können, um zu verstehen, warum Claude das Problem gekennzeichnet hat und wie es das Problem überprüft hat.

52 52

53<h3 id="rate-and-reply-to-findings">53<h3 id="rate-and-reply-to-findings">

54 Bewertung und Antwort auf Erkenntnisse54 Bewertung und Antwort auf Erkenntnisse

297 Fehlerbehebung297 Fehlerbehebung

298</h2>298</h2>

299 299

300Review-Ausführungen sind Best-Effort. Eine fehlgeschlagene Ausführung blockiert Ihren PR niemals, aber sie wird auch nicht automatisch erneut versucht. Dieser Abschnitt behandelt, wie Sie sich von einer fehlgeschlagenen Ausführung erholen und wo Sie nachschauen können, wenn die Check-Run Probleme meldet, die Sie nicht finden können.300Review-Ausführungen sind Best-Effort, und eine fehlgeschlagene Ausführung blockiert Ihren PR niemals. Code Review wiederholt einige unterbrochene Reviews automatisch. Dieser Abschnitt behandelt, wie Sie eine Überprüfung selbst erneut ausführen und wo Sie nachschauen können, wenn die Check-Run Probleme meldet, die Sie nicht finden können.

301 301

302<h3 id="retrigger-a-failed-or-timed-out-review">302<h3 id="retrigger-a-failed-or-timed-out-review">

303 Auslösen einer fehlgeschlagenen oder abgelaufenen Überprüfung erneut303 Auslösen einer fehlgeschlagenen oder abgelaufenen Überprüfung erneut

304</h3>304</h3>

305 305

306Wenn die Review-Infrastruktur auf einen internen Fehler trifft oder ihr Zeitlimit überschreitet, wird die Check-Run mit einem Titel von **Code review encountered an error** oder **Code review timed out** abgeschlossen. Die Schlussfolgerung ist immer noch neutral, sodass nichts Ihre Zusammenführung blockiert, aber keine Erkenntnisse werden veröffentlicht.306Wenn eine Überprüfung fehlschlägt oder ihr Zeitlimit überschreitet, wird die Check-Run mit einem Titel wie **Code review failed** oder **Code review timed out** abgeschlossen. Die Schlussfolgerung ist immer noch neutral, sodass nichts Ihre Zusammenführung blockiert. Sofern die Zusammenfassung der Check-Run nicht besagt, dass eine neue Überprüfung des Commits automatisch in die Warteschlange eingereiht wurde, führen Sie die Überprüfung selbst erneut aus.

307 307

308Um die Überprüfung erneut auszuführen, kommentieren Sie `@claude review` auf dem PR. Dies startet eine neue Überprüfung, ohne den PR für zukünftige Pushes zu abonnieren. Wenn der PR nicht [von einem Fork](#review-pull-requests-from-forks) stammt, können Sie stattdessen auf **Re-run** in der **Claude Code Review** Check-Run in Githubs Checks-Registerkarte klicken. Ein erneuter Durchlauf startet auch eine neue Überprüfung, ohne den PR zu abonnieren.308Um die Überprüfung erneut auszuführen, kommentieren Sie `@claude review` auf dem PR. Dies startet eine neue Überprüfung, ohne den PR für zukünftige Pushes zu abonnieren. Wenn der PR nicht [von einem Fork](#review-pull-requests-from-forks) stammt, können Sie stattdessen auf **Re-run** in der **Claude Code Review** Check-Run in Githubs Checks-Registerkarte klicken. Ein erneuter Durchlauf startet auch eine neue Überprüfung, ohne den PR zu abonnieren.

309 309

commands.md +4 −3

Details

79| `/dataviz [request]` | **[Skill](/docs/de/skills#bundled-skills).** Designanleitung für Diagramme, Grafiken und Dashboards. Claude wählt die Diagrammform für die Daten, weist Farbe nach Rolle zu, validiert die Palette auf Farbenblindheit-Sicherheit und Kontrast mit einem gebündelten Skript und wendet Mark-, Interaktions- und Barrierefreiheitsregeln an. Verwendet eine markenfreie Platzhalterpalette, die Sie durch Ihre eigene ersetzen. Erfordert Claude Code v2.1.198 oder später |79| `/dataviz [request]` | **[Skill](/docs/de/skills#bundled-skills).** Designanleitung für Diagramme, Grafiken und Dashboards. Claude wählt die Diagrammform für die Daten, weist Farbe nach Rolle zu, validiert die Palette auf Farbenblindheit-Sicherheit und Kontrast mit einem gebündelten Skript und wendet Mark-, Interaktions- und Barrierefreiheitsregeln an. Verwendet eine markenfreie Platzhalterpalette, die Sie durch Ihre eigene ersetzen. Erfordert Claude Code v2.1.198 oder später |

80| `/debug [description]` | **[Skill](/docs/de/skills#bundled-skills).** Aktivieren Sie Debug-Protokollierung für die aktuelle Sitzung und beheben Sie Probleme durch Lesen des Sitzungs-Debug-Protokolls. Debug-Protokollierung ist standardmäßig deaktiviert, es sei denn, Sie haben mit `claude --debug` gestartet, daher startet das Ausführen von `/debug` in der Mitte der Sitzung die Erfassung von Protokollen ab diesem Punkt. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |80| `/debug [description]` | **[Skill](/docs/de/skills#bundled-skills).** Aktivieren Sie Debug-Protokollierung für die aktuelle Sitzung und beheben Sie Probleme durch Lesen des Sitzungs-Debug-Protokolls. Debug-Protokollierung ist standardmäßig deaktiviert, es sei denn, Sie haben mit `claude --debug` gestartet, daher startet das Ausführen von `/debug` in der Mitte der Sitzung die Erfassung von Protokollen ab diesem Punkt. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |

81| `/deep-research <question>` | **[Workflow](/docs/de/workflows#bundled-workflows).** Verteilen Sie Web-Suchen zu einer Frage, rufen Sie Quellen ab und überprüfen Sie sie, und synthetisieren Sie einen zitierten Bericht |81| `/deep-research <question>` | **[Workflow](/docs/de/workflows#bundled-workflows).** Verteilen Sie Web-Suchen zu einer Frage, rufen Sie Quellen ab und überprüfen Sie sie, und synthetisieren Sie einen zitierten Bericht |

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

83| `/design-login` | Autorisieren Sie Design-System-Zugriff für `/design-sync` mit Ihrem claude.ai-Konto |83| `/design-login` | Autorisieren Sie Design-System-Zugriff für `/design-sync` mit Ihrem claude.ai-Konto |

84| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertieren Sie das React-Design-System Ihres Repos und laden Sie es zu [Claude Design](https://claude.ai/design) hoch, damit die Designs, die es produziert, Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, z. B. `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann auf einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API. Es benötigt claude.ai, das die CLI nicht auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS kontaktiert, oder durch ein [Claude Apps Gateway](/docs/de/claude-apps-gateway#availability-and-limitations), daher ist der Befehl dort nicht verfügbar |84| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertieren Sie das React-Design-System Ihres Repos und laden Sie es zu [Claude Design](https://claude.ai/design) hoch, damit die Designs, die es produziert, Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, z. B. `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann auf einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API. Es benötigt claude.ai, das die CLI nicht auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS kontaktiert, oder durch ein [Claude Apps Gateway](/docs/de/claude-apps-gateway#availability-and-limitations), daher ist der Befehl dort nicht verfügbar |

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

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

87| `/doctor` | **[Skill](/docs/de/skills#bundled-skills).** Führen Sie eine Setup-Überprüfung aus, die Probleme diagnostiziert und beheben kann. Überprüft die Installationsintegrität, einschließlich doppelter oder verbleibender Installationen, `PATH`-Problemen und nicht analysierbaren Einstellungsdateien. Findet ungenutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten, kennzeichnet langsame [Hooks](/docs/de/hooks) und überprüft auf eine neuere Version auf Ihrem [Release-Kanal](/docs/de/setup#configure-release-channel). Dedupliziert lokale `CLAUDE.md`-Dateien gegen eingecheckte, trimmt eingecheckte [`CLAUDE.md`](/docs/de/memory#my-claude-md-is-too-large)-Dateien, indem Inhalte gekürzt werden, die Claude aus der Codebasis ableiten könnte, und migriert die immer geladene Anleitung, die bleibt, in [Skills](/docs/de/skills) und verschachtelte `CLAUDE.md`-Dateien, die bei Bedarf geladen werden. Bietet auch an, [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte schreibgeschützte Befehle [vorab zu genehmigen](/docs/de/permissions). Meldet Erkenntnisse zuerst und fragt um Bestätigung, bevor etwas geändert wird. Vom Terminal aus druckt `claude doctor` schreibgeschützte Installationsdiagnostiken, ohne eine Sitzung zu starten. Alias: `/checkup`. Die `CLAUDE.md`-Trimm-Überprüfung erfordert Claude Code v2.1.206 oder später. Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnose-Bildschirm und das Drücken von `f` sendete den Bericht an Claude |87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/de/skills#bundled-skills).** Führen Sie eine Setup-Überprüfung aus, die Probleme diagnostiziert und beheben kann. Überprüft die Installationsintegrität, einschließlich doppelter oder verbleibender Installationen, `PATH`-Problemen und nicht analysierbaren Einstellungsdateien. Findet ungenutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten, kennzeichnet langsame [Hooks](/docs/de/hooks) und überprüft auf eine neuere Version auf Ihrem [Release-Kanal](/docs/de/setup#configure-release-channel). Dedupliziert lokale `CLAUDE.md`-Dateien gegen eingecheckte, trimmt eingecheckte [`CLAUDE.md`](/docs/de/memory#my-claude-md-is-too-large)-Dateien, indem Inhalte gekürzt werden, die Claude aus der Codebasis ableiten könnte, und migriert die immer geladene Anleitung, die bleibt, in [Skills](/docs/de/skills) und verschachtelte `CLAUDE.md`-Dateien, die bei Bedarf geladen werden. Bietet auch an, [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte schreibgeschützte Befehle [vorab zu genehmigen](/docs/de/permissions). Meldet Erkenntnisse zuerst und fragt um Bestätigung, bevor etwas geändert wird. Vom Terminal aus druckt `claude doctor` schreibgeschützte Installationsdiagnostiken, ohne eine Sitzung zu starten. Alias: `/checkup`. Führen Sie `/doctor prompt-audit` aus, um Claude [Ihre `CLAUDE.md`-Dateien, Skills und andere Konfiguration](/docs/de/memory#write-effective-instructions) auf veraltete oder widersprüchliche Anweisungen zu überprüfen, anstatt die Überprüfung auszuführen. Der Subbefehl `prompt-audit` erfordert Claude Code v2.1.283 oder später. Die `CLAUDE.md`-Trimm-Überprüfung erfordert Claude Code v2.1.206 oder später. Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnose-Bildschirm und das Drücken von `f` sendete den Bericht an Claude |

88| `/effort [level\|auto\|status]` | Legen Sie die [Aufwandsebene](/docs/de/model-config#adjust-effort-level) fest: `low` bis `xhigh`, `max`, [`ultracode`](/docs/de/workflows#let-claude-decide-with-ultracode) oder `auto`; `status` druckt sie. `max` und `ultracode` sind nur für Sitzungen; der [`ultracode`](/docs/de/settings-reference#ultracode)-Schlüssel bleibt bestehen. Führen Sie ihn aus, während Claude antwortet, und sobald Sie die [Cache-Warnung](/docs/de/prompt-caching#changing-effort-level) bestätigen, wenn Claude Code eine anzeigt, wendet Claude Code die neue Ebene auf die nächste Anfrage in dieser Runde an. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder in der Warteschlange bis zum Ende der Runde ausgeführt werden sollte, und stellte ihn immer in die Warteschlange in einer Sitzung, die [Feature-Flags nicht abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), wie auf einem [Drittanbieter](/docs/de/third-party-integrations). Funktioniert in `-p` |88| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Legen Sie die [Aufwandsebene](/docs/de/model-config#adjust-effort-level) fest: `low` bis `xhigh`, `max` oder `auto`; `status` druckt sie. `ultracode` oder `ultracode on` schaltet [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) für die Sitzung auf der aktuellen Ebene ein, und `ultracode off` schaltet es aus; der [`ultracode`](/docs/de/settings-reference#ultracode)-Schlüssel bleibt bestehen. `max` ist nur für Sitzungen. Die `on`- und `off`-Argumente und das Beibehalten der aktuellen Ebene erfordern Claude Code v2.1.284 oder später. Vor v2.1.284 setzte `/effort ultracode` die Sitzung auf `xhigh`, und `/effort ultracode off` schlug mit `Invalid argument` fehl. Führen Sie ihn aus, während Claude antwortet, und sobald Sie die [Cache-Warnung](/docs/de/prompt-caching#changing-effort-level) bestätigen, wenn Claude Code eine anzeigt, wendet Claude Code die neue Ebene auf die nächste Anfrage in dieser Runde an. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder in der Warteschlange bis zum Ende der Runde ausgeführt werden sollte, und stellte ihn immer in die Warteschlange in einer Sitzung, die [Feature-Flags nicht abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), wie auf einem [Drittanbieter](/docs/de/third-party-integrations). Funktioniert in `-p` |

89| `/exit` | Beenden Sie die CLI. In einer angehängten [Hintergrund-Sitzung](/docs/de/agent-view#attach-to-a-session) trennt dies ab und die Sitzung läuft weiter. Alias: `/quit` |89| `/exit` | Beenden Sie die CLI. In einer angehängten [Hintergrund-Sitzung](/docs/de/agent-view#attach-to-a-session) trennt dies ab und die Sitzung läuft weiter. Alias: `/quit` |

90| `/export [filename]` | Exportieren Sie die aktuelle Konversation als Klartext. Mit einem Dateinamen schreibt direkt in diese Datei. Ohne öffnet einen Dialog zum Kopieren in die Zwischenablage oder Speichern in einer Datei |90| `/export [filename]` | Exportieren Sie die aktuelle Konversation als Klartext. Mit einem Dateinamen schreibt direkt in diese Datei. Ohne öffnet einen Dialog zum Kopieren in die Zwischenablage oder Speichern in einer Datei |

91| `/fast [on\|off]` | Schalten Sie [Schnellmodus](/docs/de/fast-mode) ein oder aus. Führen Sie ihn aus, während Claude antwortet, und Claude Code schaltet den Schnellmodus um, ohne auf das Ende der Runde zu warten, obwohl die laufende Runde mit ihrer ursprünglichen Geschwindigkeit endet. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder in der Warteschlange bis zum Ende der Runde ausgeführt werden sollte, und stellte ihn immer in die Warteschlange in einer Sitzung, die [Feature-Flags nicht abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Die Verfügbarkeit im nicht-interaktiven Modus mit `-p` ist begrenzt; siehe [Schnellmodus umschalten](/docs/de/fast-mode#toggle-fast-mode). Erfordert Claude Code v2.1.205 oder später |91| `/fast [on\|off]` | Schalten Sie [Schnellmodus](/docs/de/fast-mode) ein oder aus. Führen Sie ihn aus, während Claude antwortet, und Claude Code schaltet den Schnellmodus um, ohne auf das Ende der Runde zu warten, obwohl die laufende Runde mit ihrer ursprünglichen Geschwindigkeit endet. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder in der Warteschlange bis zum Ende der Runde ausgeführt werden sollte, und stellte ihn immer in die Warteschlange in einer Sitzung, die [Feature-Flags nicht abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Die Verfügbarkeit im nicht-interaktiven Modus mit `-p` ist begrenzt; siehe [Schnellmodus umschalten](/docs/de/fast-mode#toggle-fast-mode). Erfordert Claude Code v2.1.205 oder später |

143| `/simplify [target]` | **[Skill](/docs/de/skills#bundled-skills).** Überprüfen Sie den geänderten Code auf Bereinigungsmöglichkeiten und wenden Sie die Fixes an. Vier Überprüfungs-[Agenten](/docs/de/sub-agents) laufen parallel und decken Wiederverwendung vorhandener Helfer, Vereinfachung, Effizienz und ob die Änderung auf der richtigen Abstraktionsebene ist, ab. Die Überprüfung sucht nicht nach Korrektheitsfehler. Verwenden Sie `/code-review`, um Fehler zu finden. Übergeben Sie einen Pfad oder PR-Referenz, um ein bestimmtes Ziel zu überprüfen |143| `/simplify [target]` | **[Skill](/docs/de/skills#bundled-skills).** Überprüfen Sie den geänderten Code auf Bereinigungsmöglichkeiten und wenden Sie die Fixes an. Vier Überprüfungs-[Agenten](/docs/de/sub-agents) laufen parallel und decken Wiederverwendung vorhandener Helfer, Vereinfachung, Effizienz und ob die Änderung auf der richtigen Abstraktionsebene ist, ab. Die Überprüfung sucht nicht nach Korrektheitsfehler. Verwenden Sie `/code-review`, um Fehler zu finden. Übergeben Sie einen Pfad oder PR-Referenz, um ein bestimmtes Ziel zu überprüfen |

144| `/skill-doctor` | Zeigen Sie, was jeder Ihrer [Skills](/docs/de/skills) in Kontext kostet und wie oft er verwendet wird, damit Sie [Skills finden können, die Sie ausschalten können](/docs/de/skills#find-unused-skills). Erfordert Claude Code v2.1.252 oder später und [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) |144| `/skill-doctor` | Zeigen Sie, was jeder Ihrer [Skills](/docs/de/skills) in Kontext kostet und wie oft er verwendet wird, damit Sie [Skills finden können, die Sie ausschalten können](/docs/de/skills#find-unused-skills). Erfordert Claude Code v2.1.252 oder später und [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) |

145| `/skills` | Listet verfügbare [Skills](/docs/de/skills) auf. Geben Sie ein, um die Liste nach Name, Beschreibung oder Quelle zu filtern. Drücken Sie `t`, um nach Token-Anzahl zu sortieren, `Space` oder `Enter`, um die [Sichtbarkeit eines Skills für Claude und das `/`-Menü zu zyklisieren](/docs/de/skills#override-skill-visibility-from-settings), und `Esc`, um zu speichern und zu schließen. Sie können Plugin-Skills, Skills, deren Frontmatter `disable-model-invocation: true` setzt, oder Skills mit einem `skillOverrides`-Eintrag in verwalteten Einstellungen oder dem `--settings`-Flag nicht zyklisieren |145| `/skills` | Listet verfügbare [Skills](/docs/de/skills) auf. Geben Sie ein, um die Liste nach Name, Beschreibung oder Quelle zu filtern. Drücken Sie `t`, um nach Token-Anzahl zu sortieren, `Space` oder `Enter`, um die [Sichtbarkeit eines Skills für Claude und das `/`-Menü zu zyklisieren](/docs/de/skills#override-skill-visibility-from-settings), und `Esc`, um zu speichern und zu schließen. Sie können Plugin-Skills, Skills, deren Frontmatter `disable-model-invocation: true` setzt, oder Skills mit einem `skillOverrides`-Eintrag in verwalteten Einstellungen oder dem `--settings`-Flag nicht zyklisieren |

146| `/slides [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Erstellen Sie eine neue Präsentation als Claude Slides-[Artefakt](/docs/de/artifacts#make-a-slide-deck), das aus Ihrem Brief gefüllt ist, z. B. `/slides a quarterly review of the platform team`. Erfordert Claude Code v2.1.265 oder später, eine Sitzung, in der [Artefakte verfügbar](/docs/de/artifacts#availability) sind, und ein Konto, auf dem die [Slides-Vorlage verfügbar](/docs/de/artifacts#start-from-a-slides-design-or-docs-template) ist; andernfalls wird der Befehl nicht angezeigt. Verfügbar auf der Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |

147| `/status` | Öffnen Sie die Einstellungsschnittstelle auf der Registerkarte Status, die Version, Modell, Konto und Konnektivität anzeigt. Eine `Session kind`-Zeile liest `background job · attached` oder `background job · unattended` in einer [Hintergrund-Sitzung](/docs/de/agent-view), je nachdem, ob ein Terminal angehängt ist, und `interactive` in jeder anderen Sitzung. Vor v2.1.221 zeigte `/status` diese Zeile nicht. Funktioniert, während Claude antwortet |148| `/status` | Öffnen Sie die Einstellungsschnittstelle auf der Registerkarte Status, die Version, Modell, Konto und Konnektivität anzeigt. Eine `Session kind`-Zeile liest `background job · attached` oder `background job · unattended` in einer [Hintergrund-Sitzung](/docs/de/agent-view), je nachdem, ob ein Terminal angehängt ist, und `interactive` in jeder anderen Sitzung. Vor v2.1.221 zeigte `/status` diese Zeile nicht. Funktioniert, während Claude antwortet |

148| `/statusline` | Konfigurieren Sie Claude Code's [Statuszeile](/docs/de/statusline). Beschreiben Sie, was Sie möchten, oder führen Sie ohne Argumente aus, um automatisch aus Ihrer Shell-Eingabeaufforderung zu konfigurieren |149| `/statusline` | Konfigurieren Sie Claude Code's [Statuszeile](/docs/de/statusline). Beschreiben Sie, was Sie möchten, oder führen Sie ohne Argumente aus, um automatisch aus Ihrer Shell-Eingabeaufforderung zu konfigurieren |

communications-kit.md +20 −20

Details

65 65

66 Versuchen Sie dann eines davon im Repo, an dem Sie bereits arbeiten:66 Versuchen Sie dann eines davon im Repo, an dem Sie bereits arbeiten:

67 67

~~68 - 'Der Test in [Datei] ist flaky. Finde heraus, warum und behebe es"~~68 - „Der Test in [Datei] ist flaky. Finde heraus, warum und behebe es"

69 - „Zeige mir, wie [Modul] [X] handhabt"69 - „Zeige mir, wie [Modul] [X] handhabt"

70 - „Schau dir meinen funktionierenden Diff an und sag mir, was riskant ist,70 - „Schau dir meinen funktionierenden Diff an und sag mir, was riskant ist,

71 bevor ich pushe"71 bevor ich pushe"

231 231

232Opus zu verwenden, um einen Tippfehler zu beheben, verschwendet Rechenleistung. Haiku für ein 12-Datei-Refactoring zu verwenden, ist eine Wiederholung verlangen.232Opus zu verwenden, um einen Tippfehler zu beheben, verschwendet Rechenleistung. Haiku für ein 12-Datei-Refactoring zu verwenden, ist eine Wiederholung verlangen.

233 233

234Claude Code läuft auf denselben Modellen wie die Claude-App, und Sie können mid-session wechseln. *Sonnet* ist der zuverlässige Standard für alltägliche Feature-Arbeit, Bugs, Tests und Reviews. Greifen Sie zu *Opus* bei großen Refactorings, kniffligem Debugging oder allem mit hohem Einsatz. Fallen Sie auf *Haiku* für schnelle Fragen, Formatierung und mechanische Bearbeitungen, bei denen Geschwindigkeit gewinnt. *Fable* ist das fähigste Modell für Ihre schwierigsten, längsten Aufgaben; es ist nicht der Standard, also wählen Sie es mit `/model fable` aus, und beachten Sie, dass Cybersicherheits- und Biologieinhalte automatisch auf Opus zurückfallen. Opus 5.5 und Opus 5 führen ihre eigenen Überprüfungen durch: gekennzeichnete Inhalte wechseln zu einem früheren Opus, außer dass gekennzeichnete Biologieinhalte auf Opus 5 abgelehnt werden.234Claude Code läuft auf denselben Modellen wie die Claude-App, und Sie können mid-session wechseln. *Sonnet* ist der zuverlässige Standard für alltägliche Feature-Arbeit, Bugs, Tests und Reviews. Greifen Sie zu *Opus* bei großen Refactorings, kniffligem Debugging oder allem mit hohem Einsatz. Fallen Sie auf *Haiku* für schnelle Fragen, Formatierung und mechanische Bearbeitungen, bei denen Geschwindigkeit gewinnt. *Fable* ist das fähigste Modell für Ihre schwierigsten, längsten Aufgaben; es ist nicht der Standard, also wählen Sie es mit `/model fable` aus, und beachten Sie, dass Cybersicherheits- und Biologieinhalte automatisch auf Opus zurückfallen. Opus 5.5, Sonnet 5.5 und Opus 5 führen ihre eigenen Überprüfungen durch: gekennzeichnete Inhalte wechseln zu einem früheren Modell in derselben Familie, außer dass gekennzeichnete Biologieinhalte auf Opus 5 oder Sonnet 5.5 abgelehnt werden.

235 235

236*Probieren Sie es jetzt:* Geben Sie `/model` ein und wählen Sie Sonnet, wenn Sie es noch nicht getan haben. Es ist der richtige Standard für die meisten Aufgaben.236*Probieren Sie es jetzt:* Geben Sie `/model` ein und wählen Sie Sonnet, wenn Sie es noch nicht getan haben. Es ist der richtige Standard für die meisten Aufgaben.

237 237

242| - | - |242| - | - |

243| Fable | Die schwierigsten, längsten Aufgaben. Nur auf Opt-in-Basis: Wählen Sie es mit `/model fable` aus. Cybersicherheits- oder Biologieinhalte [fallen automatisch auf Opus zurück](/docs/de/model-config#automatic-model-fallback) |243| Fable | Die schwierigsten, längsten Aufgaben. Nur auf Opt-in-Basis: Wählen Sie es mit `/model fable` aus. Cybersicherheits- oder Biologieinhalte [fallen automatisch auf Opus zurück](/docs/de/model-config#automatic-model-fallback) |

244| Opus | Großflächige Refactorings, komplexes Debugging, Architekturentscheidungen, hochriskante Änderungen. Bei Opus 5.5 und Opus 5 lösen Cybersicherheits- oder Biologieinhalte [automatisches Modell-Fallback oder eine Ablehnung](/docs/de/model-config#automatic-model-fallback) aus |244| Opus | Großflächige Refactorings, komplexes Debugging, Architekturentscheidungen, hochriskante Änderungen. Bei Opus 5.5 und Opus 5 lösen Cybersicherheits- oder Biologieinhalte [automatisches Modell-Fallback oder eine Ablehnung](/docs/de/model-config#automatic-model-fallback) aus |

245| Sonnet | Alltägliche Feature-Arbeit, Bug-Fixes, Tests, Dokumentation, Code-Review. Empfohlener Standard. |245| Sonnet | Alltägliche Feature-Arbeit, Bug-Fixes, Tests, Dokumentation, Code-Review. Empfohlener Standard. Bei Sonnet 5.5 lösen Cybersicherheits- oder Biologieinhalte [automatisches Modell-Fallback oder eine Ablehnung](/docs/de/model-config#automatic-model-fallback) aus |

246| Haiku | Schnelle Fragen, Formatierung, mechanische Bearbeitungen, schnelle Iteration |246| Haiku | Schnelle Fragen, Formatierung, mechanische Bearbeitungen, schnelle Iteration |

247 247

248**Schnelle Gewinne zum ersten Ausprobieren**248**Schnelle Gewinne zum ersten Ausprobieren**

473 FAQ-Antworten473 FAQ-Antworten

474</h3>474</h3>

475 475

476Einzeilige Antworten für die Fragen, die Sie am häufigsten gestellt bekommen.476Einzeilige Antworten auf die Fragen, die dir am häufigsten gestellt werden.

477 477

478| Frage | Antwort |478| Frage | Antwort |

479| - | - |479| - | - |

480| „Funktioniert es in VS Code?" | Ja. Es gibt eine VS Code-Erweiterung und ein JetBrains-Plugin mit denselben Features, eingebettet in Ihrem Editor. [VS Code →](/docs/de/vs-code) |480| "Funktioniert es in VS Code?" | Ja. Es gibt eine VS Code-Erweiterung und ein JetBrains-Plugin mit den gleichen Funktionen, eingebettet in deinem Editor. [VS Code →](/docs/de/vs-code) |

481| „Muss ich vorher etwas konfigurieren?" | Nein. Installieren Sie, führen Sie dann `claude` in einem beliebigen Repo aus. Führen Sie `/init` einmal aus und Sie sind fertig. [Schnellstart →](/docs/de/quickstart) |481| "Muss ich vorher etwas konfigurieren?" | Nein. Installiere und führe dann `claude` in einem beliebigen Repository aus. Führe `/init` einmal aus und du bist fertig. [Schnellstart →](/docs/de/quickstart) |

482| „Wo geht mein Code hin?" | Die CLI läuft in Ihrem Terminal und sendet Kontext an Anthropics API für Inferenz, ohne dritte Server. Unter Ihrem Enterprise-Plan werden Ihr Code und Prompts nicht zum Trainieren von Modellen verwendet. [Datennutzung →](/docs/de/data-usage) |482| "Wohin geht mein Code?" | Die CLI läuft in deinem Terminal und sendet Kontext an Anthropics API zur Inferenz, ohne Server von Drittanbietern. Bei einem Team- oder Enterprise-Plan werden dein Code und deine Prompts nicht zum Trainieren von Modellen verwendet. [Datennutzung →](/docs/de/data-usage) |

483| „Kann es mein ganzes Repo sehen?" | Es liest, worauf Sie ihm Zugriff geben. Dateilesevorgänge in Ihrem Arbeitsverzeichnis erfordern keine Aufforderung; Berechtigungsaufforderungen kontrollieren Bearbeitungen, Shell-Befehle und alles außerhalb dieses Verzeichnisses. Ein integrierter Satz von schreibgeschützten Shell-Befehlen wie `ls` und `cat` wird ohne Aufforderung ausgeführt; beschränken Sie ihn mit [Sandbox-`denyRead`-Regeln](/docs/de/sandboxing#filesystem-isolation). [Berechtigungen →](/docs/de/permissions) |483| "Kann es mein ganzes Repository sehen?" | Es liest das, worauf du ihm Zugriff gibst. Dateilesevorgänge in deinem Arbeitsverzeichnis erfordern keine Aufforderung; Berechtigungsaufforderungen kontrollieren Bearbeitungen, nicht schreibgeschützte Shell-Befehle und Datei-Tool-Lesevorgänge außerhalb dieses Verzeichnisses. Ein integrierter Satz von schreibgeschützten Shell-Befehlen wie `ls` und `cat` wird ohne Aufforderung ausgeführt; beschränke ihn mit [Sandbox-`denyRead`-Regeln](/docs/de/sandboxing#filesystem-isolation). [Berechtigungen →](/docs/de/permissions) |

484| „Wie unterscheidet sich das von Copilot?" | Copilot vervollständigt Zeilen. Claude Code ist ein Agent, der Dateien liest, Befehle ausführt und mehrdatei-Bearbeitungen macht. [Übersicht →](/docs/de/overview) |484| "Wie unterscheidet sich das von Copilot?" | Copilot vervollständigt Zeilen. Claude Code ist ein Agent, der Dateien liest, Befehle ausführt und mehrdatei-Bearbeitungen vornimmt. [Übersicht →](/docs/de/overview) |

485| „Was sollte ich zuerst ausprobieren?" | Ein Bug, den Sie aufgeschoben haben, weil er mühsam ist. „Der Test in \[Datei] ist flaky, finde heraus, warum." [Schnellstart →](/docs/de/quickstart) |485| "Was sollte ich zuerst versuchen?" | Ein Fehler, den du aufgeschoben hast, weil er mühsam ist. "Der Test in \[Datei] ist instabil, finde heraus, warum." [Schnellstart →](/docs/de/quickstart) |

486 486

487<h3 id="prompt-templates">487<h3 id="prompt-templates">

488 Prompt-Vorlagen488 Prompt-Vorlagen

489</h3>489</h3>

490 490

491Teilen Sie diese Starter-Prompts mit Engineers, die installiert haben, aber nicht sicher sind, was sie fragen sollen. Jeder ist so formuliert, wie er in einer echten Sitzung eingegeben würde; ersetzen Sie die eingeklammerten Teile durch Dateien aus Ihrem eigenen Repo.491Teile diese Starter-Prompts mit Ingenieuren, die installiert haben, aber nicht sicher sind, was sie fragen sollen. Jeder ist so formuliert, wie er in einer echten Sitzung eingegeben würde; ersetze die eingeklammerten Teile durch Dateien aus deinem eigenen Repository.

492 492

493| Aufgabe | Prompt |493| Aufgabe | Prompt |

494| - | - |494| - | - |

495| Beheben Sie einen Bug | „Die Tests in \[Datei] schlagen fehl, finde heraus, warum und behebe es" |495| Fehler beheben | "die Tests in \[Datei] schlagen fehl, finde heraus, warum und behebe es" |

496| Verstehen Sie Code | „Zeige mir, wie \[Modul] funktioniert, dann sag mir, wo der Einstiegspunkt ist" |496| Code verstehen | "erkläre mir, wie \[Modul] funktioniert, und sag mir dann, wo der Einstiegspunkt ist" |

497| Sicheres Refactoring | „Refaktoriere \[Modul] zu \[Ziel], verwende Plan-Modus, damit ich zuerst überprüfen kann" |497| Sichere Umgestaltung | "refaktoriere \[Modul] zu \[Ziel], verwende Plan Mode, damit ich es zuerst überprüfen kann" |

498| Schreiben Sie Tests | „Schreibe Tests für \[Datei], die die Edge Cases um \[Szenario] abdecken" |498| Tests schreiben | "schreibe Tests für \[Datei], die die Grenzfälle um \[Szenario] abdecken" |

499| Überprüfen Sie vor dem Commit | „Schau dir meinen funktionierenden Diff an und sag mir, was riskant aussieht" |499| Vor dem Commit überprüfen | "schau dir meinen Working Diff an und sag mir, was riskant aussieht" |

500| Öffnen Sie einen PR | „Behebe \[Issue], schreibe einen konventionellen Commit und öffne einen PR mit einer Zusammenfassung" |500| PR öffnen | "behebe \[Problem], schreibe einen konventionellen Commit und öffne einen PR mit einer Zusammenfassung" |

501| Erstellen Sie einen Skill | „Machen Sie mir einen /ship Skill, der Tests und Lint vor dem Commit ausführt" |501| Skill erstellen | "erstelle mir einen /ship Skill, der Tests und Lint vor dem Commit ausführt" |

502| Debuggen Sie einen Stack Trace | „Hier ist der Stack Trace, finde die Grundursache, papiere es nicht einfach über" |502| Stack Trace debuggen | "hier ist der Stack Trace, finde die Grundursache, überdecke sie nicht einfach" |

503 503

504<Tip>504<Tip>

505 Claude Code wird häufig aktualisiert. Überprüfen Sie versionsspezifische Details gegen die [Dokumentationsstartseite](/docs/de/overview), bevor Sie intern verteilen.505 Claude Code wird häufig aktualisiert. Überprüfe versionsspezifische Details auf der [Dokumentationsstartseite](/docs/de/overview), bevor du sie intern verteilst.

506</Tip>506</Tip>

context-window.md +2 −2

Details

1632* **Zwischen Aufgaben löschen**: Führen Sie `/clear` aus, wenn Sie zu nicht verwandter Arbeit wechseln. Alte Konversationen verdrängen die Dateien, die Sie als nächstes benötigen, und kosten Token bei jeder Nachricht.1632* **Zwischen Aufgaben löschen**: Führen Sie `/clear` aus, wenn Sie zu nicht verwandter Arbeit wechseln. Alte Konversationen verdrängen die Dateien, die Sie als nächstes benötigen, und kosten Token bei jeder Nachricht.

1633* **Große Lesevorgänge delegieren**: Senden Sie Recherche an einen [Subagent](/docs/de/sub-agents), sodass die Dateiinhalte in seinem Kontextfenster bleiben, nicht in Ihrem.1633* **Große Lesevorgänge delegieren**: Senden Sie Recherche an einen [Subagent](/docs/de/sub-agents), sodass die Dateiinhalte in seinem Kontextfenster bleiben, nicht in Ihrem.

1634 1634

1635Wenn Sie ein größeres Fenster benötigen, anstatt ein kleineres Gespräch zu führen, unterstützen Fable-Modelle, Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 ein Kontextfenster mit 1 Million Token. Siehe [Erweiterter Kontext](/docs/de/model-config#extended-context) für die Verfügbarkeit nach Plan und wie Sie eine `[1m]` Modellvariante auswählen. Die Komprimierung funktioniert auf die gleiche Weise bei der größeren Grenze.1635Wenn Sie ein größeres Fenster benötigen, anstatt ein kleineres Gespräch zu führen, unterstützen Fable-Modelle, Sonnet 5 und später, Opus 4.6 und später sowie Sonnet 4.6 ein Kontextfenster mit 1 Million Token. Siehe [Erweiterter Kontext](/docs/de/model-config#extended-context) für die Verfügbarkeit nach Plan und wie Sie eine `[1m]` Modellvariante auswählen. Die Komprimierung funktioniert auf die gleiche Weise bei der größeren Grenze.

1636 1636

1637Sonnet 5 läuft mit dem 1M-Kontextfenster und hat keine `[1m]`-Variante zur Auswahl. Siehe [Sonnet 5 Kontextfenster](/docs/de/model-config#sonnet-5-context-window) für seine automatischen Kompressionsschwellen und die LLM-Gateway-Ausnahme.1637Sonnet 5.5 und Sonnet 5 laufen mit dem 1M-Kontextfenster und haben keine `[1m]`-Variante zur Auswahl. Siehe [Sonnet 5.5 und Sonnet 5 Kontextfenster](/docs/de/model-config#sonnet-5-5-and-sonnet-5-context-window) für ihre automatischen Kompressionsschwellen und die LLM-Gateway-Ausnahme.

1638 1638

1639Der Punkt, an dem die automatische Komprimierung ausgeführt wird, hängt von Ihrem Modell und Ihrer Konfiguration ab. Siehe [Standardschwellen für automatische Komprimierung](/docs/de/model-config#default-auto-compact-thresholds) für die Grenzen pro Modell, und [Fenster für ein Gateway oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id), wenn Claude Code das falsche Fenster für Ihre Modell-ID annimmt, wie z. B. einen [LLM-Gateway](/docs/de/llm-gateway)-Alias.1639Der Punkt, an dem die automatische Komprimierung ausgeführt wird, hängt von Ihrem Modell und Ihrer Konfiguration ab. Siehe [Standardschwellen für automatische Komprimierung](/docs/de/model-config#default-auto-compact-thresholds) für die Grenzen pro Modell, und [Fenster für ein Gateway oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id), wenn Claude Code das falsche Fenster für Ihre Modell-ID annimmt, wie z. B. einen [LLM-Gateway](/docs/de/llm-gateway)-Alias.

1640 1640

corporate-launcher.md +12 −12

Details

8 8

9Einige Organisationen erfordern, dass jeder Prozess auf einer Workstation durch einen obligatorischen Launcher gestartet wird. Der Launcher wendet die Sandbox, Netzwerkkontrollen oder Credential-Injection an, auf die die Sicherheitsposition des Unternehmens angewiesen ist, und eine Binärdatei, die ohne diese startet, ist ein Verstoß gegen die Richtlinie.9Einige Organisationen erfordern, dass jeder Prozess auf einer Workstation durch einen obligatorischen Launcher gestartet wird. Der Launcher wendet die Sandbox, Netzwerkkontrollen oder Credential-Injection an, auf die die Sicherheitsposition des Unternehmens angewiesen ist, und eine Binärdatei, die ohne diese startet, ist ein Verstoß gegen die Richtlinie.

10 10

11`CLAUDE_CODE_PROCESS_WRAPPER` startet jeden Prozess, den Claude Code von seiner eigenen Binärdatei aus startet, durch Ihren Launcher: den Hintergrunddienst, jede Sitzung, die er in [Agent View](/docs/de/agent-view) hostet, und Claude Codes Neustarts nach einem Update. Setzen Sie es auf den absoluten Pfad Ihres Launchers, und Claude Code führt den Launcher mit dem Claude-Code-Befehl als seine Argumente aus.11`CLAUDE_CODE_PROCESS_WRAPPER` startet jeden Prozess, den Claude Code von seiner eigenen Binärdatei aus startet, durch Ihren Launcher: den Hintergrunddienst, jede Sitzung, die er in [Agent View](/docs/de/agent-view) hostet, und Claude Codes Neustarts nach einem Update. Setzen Sie es auf den absoluten Pfad Ihres Launchers, und Claude Code führt den Launcher mit dem Claude-Code-Befehl als seine Argumente aus.

12 12

13Ein Launcher, der den `claude`-Befehl auf Ihrem `PATH` umhüllt, kann diese Prozesse nicht erreichen, da sie vom direkten Pfad der Binärdatei aus starten, ohne `claude` nachzuschlagen.13Ein Launcher, der den `claude`-Befehl auf Ihrem `PATH` umhüllt, kann diese Prozesse nicht erreichen, da sie vom direkten Pfad der Binärdatei aus starten, ohne `claude` nachzuschlagen.

14 14

24 24

25Mit `CLAUDE_CODE_PROCESS_WRAPPER` gesetzt startet Claude Code jeden der folgenden Prozesse durch Ihren Launcher:25Mit `CLAUDE_CODE_PROCESS_WRAPPER` gesetzt startet Claude Code jeden der folgenden Prozesse durch Ihren Launcher:

26 26

~~27* Der Hintergrunddienst, den `claude agents` und Hintergrundsitzungen bei Bedarf starten.~~27* Der Hintergrunddienst, den `claude agents` und Hintergrundsitzungen bei Bedarf starten.

28* Der Terminal-Host und die Claude-Code-Sitzung in jeder Agent-View-Zeile, einschließlich der Warm-Standby-Sitzungen, die der Dienst bereit hält.28* Der Terminal-Host und die Claude-Code-Sitzung in jeder Agent-View-Zeile, einschließlich der Warm-Standby-Sitzungen, die der Dienst bereit hält.

29* Sitzungen, die der Dienst nach einem Update oder Absturz neu startet.29* Sitzungen, die der Dienst nach einem Update oder Absturz neu startet.

30* Der Neustart, den Claude Code durchführt, um die Installation eines Updates abzuschließen, einschließlich der Restart-for-Update-Aktion von Agent View.30* Der Neustart, den Claude Code durchführt, um die Installation eines Updates abzuschließen, einschließlich der Restart-for-Update-Aktion von Agent View.

31* Die Sitzungsprozesse, die [Remote Control](/docs/de/remote-control) startet. Erfordert Claude Code v2.1.210 oder später.31* Die Sitzungsprozesse, die [Remote Control](/docs/de/remote-control) startet. Erfordert Claude Code v2.1.210 oder später.

32* Die Split-Pane-Teammate-Sitzungen, die [Agent Teams](/docs/de/agent-teams) in tmux oder iTerm2 starten. Teammate-Panes sind interaktiv statt Hintergrundprozesse, aber Claude Code startet sie aus seiner eigenen Binärdatei, daher deckt der Launcher sie ab. Erfordert Claude Code v2.1.210 oder später.32* Die Split-Pane-Teammate-Sitzungen, die [Agent Teams](/docs/de/agent-teams) in tmux oder iTerm2 starten. Teammate-Panes sind interaktiv statt Hintergrundprozesse, aber Claude Code startet sie aus seiner eigenen Binärdatei, daher deckt der Launcher sie ab. Erfordert Claude Code v2.1.210 oder später.

33 33

34Unter Windows wird die Variable ignoriert: Der Launcher-Vertrag hängt von `exec` ab, das Windows nicht unterstützt. Ein Windows-Computer mit der gesetzten Variable führt jeden Prozess unwrapped aus und funktioniert weiterhin, und das einzige Signal ist eine Warnung im [Debug-Protokoll](/docs/de/troubleshooting). Wenn Ihre Launcher-Richtlinie Windows abdeckt, erfüllt die Variable sie dort nicht: Zählen Sie Windows-Computer als unwrapped, wenn Sie den Rollout planen.34Unter Windows wird die Variable ignoriert: Der Launcher-Vertrag hängt von `exec` ab, das Windows nicht unterstützt. Ein Windows-Computer mit der gesetzten Variable führt jeden Prozess unwrapped aus und funktioniert weiterhin, und das einzige Signal ist eine Warnung im [Debug-Protokoll](/docs/de/troubleshooting). Wenn Ihre Launcher-Richtlinie Windows abdeckt, erfüllt die Variable sie dort nicht: Zählen Sie Windows-Computer als unwrapped, wenn Sie den Rollout planen.

35 35

39 39

40Die folgenden Prozesse starten nicht durch den Launcher:40Die folgenden Prozesse starten nicht durch den Launcher:

41 41

42* Ein [installierter Hintergrunddienst](/docs/de/agent-view#the-supervisor-process), dessen Unit vor der Launcher-Konfiguration geschrieben wurde: `launchd` oder `systemd` startet diesen Prozess aus seiner Unit-Datei. `/status` und `claude daemon status` warnen, wenn der laufende Dienst und der konfigurierte Launcher nicht übereinstimmen, und die Sitzungen, die der Dienst startet, starten immer noch durch den Launcher, sobald der Dienst mit der Variable in seinen Einstellungen neu startet.42* Ein [installierter Hintergrunddienst](/docs/de/agent-view#the-supervisor-process), dessen Unit vor der Launcher-Konfiguration geschrieben wurde: `launchd` oder `systemd` startet diesen Prozess aus seiner Unit-Datei. `/status` und `claude daemon status` warnen, wenn der laufende Dienst und der konfigurierte Launcher nicht übereinstimmen, und die Sitzungen, die der Dienst startet, starten immer noch durch den Launcher, sobald der Dienst mit der Variable in seinen Einstellungen neu startet.

43* Eine Sitzung, die Sie selbst in einem Terminal starten, die so ausgeführt wird, wie Sie sie aufgerufen haben. Um diese Sitzungen abzudecken, legen Sie ein Skript namens `claude` in ein Verzeichnis früher auf `PATH`, das Ihren Launcher mit der echten Binärdatei ausführt; ersetzen Sie nicht den verwalteten Symlink. Der Hintergrunddienst und seine Sitzungen starten ohne `PATH`-Lookup, daher stapeln sich die beiden Launcher dort nicht.43* Eine Sitzung, die Sie selbst in einem Terminal starten, die so ausgeführt wird, wie Sie sie aufgerufen haben. Um diese Sitzungen abzudecken, legen Sie ein Skript namens `claude` in ein Verzeichnis früher auf `PATH`, das Ihren Launcher mit der echten Binärdatei ausführt; ersetzen Sie nicht den verwalteten Symlink. Der Hintergrunddienst und seine Sitzungen starten ohne `PATH`-Lookup, daher stapeln sich die beiden Launcher dort nicht.

44* Der erste Prozess eines `claude-cli://` Deep Links, den der Protokoll-Handler des Betriebssystems direkt startet. Alles, das diese Sitzung danach im Hintergrund startet, läuft durch den Launcher. Um diesen Pfad vollständig zu schließen, [verhindern Sie die Handler-Registrierung](/docs/de/deep-links#registration-and-supported-platforms) mit der Einstellung `disableDeepLinkRegistration`.44* Der erste Prozess eines `claude-cli://` Deep Links, den der Protokoll-Handler des Betriebssystems direkt startet. Alles, das diese Sitzung danach im Hintergrund startet, läuft durch den Launcher. Um diesen Pfad vollständig zu schließen, [verhindern Sie die Handler-Registrierung](/docs/de/deep-links#registration-and-supported-platforms) mit der Einstellung `disableDeepLinkRegistration`.

45* Der Neustart, den `--worktree` kombiniert mit `--tmux` durchführt: Der Terminal-Multiplexer startet diesen Pane, nicht die Binärdatei von Claude Code.45* Der Neustart, den `--worktree` kombiniert mit `--tmux` durchführt: Der Terminal-Multiplexer startet diesen Pane, nicht die Binärdatei von Claude Code.

46* Der Native-Messaging-Host, den [Claude in Chrome](/docs/de/chrome) registriert: Der Browser startet ihn, nicht die Binärdatei von Claude Code.46* Der Native-Messaging-Host, den [Claude in Chrome](/docs/de/chrome) registriert: Der Browser startet ihn, nicht die Binärdatei von Claude Code.

69 Machen Sie es mit `chmod +x` ausführbar. Der Einrichtungsteil ist das, was Ihr Launcher tun muss, bevor Claude Code ausgeführt wird; [der Launcher-Vertrag](#the-launcher-contract) unten listet die Regeln auf, die das Skript befolgen muss.69 Machen Sie es mit `chmod +x` ausführbar. Der Einrichtungsteil ist das, was Ihr Launcher tun muss, bevor Claude Code ausgeführt wird; [der Launcher-Vertrag](#the-launcher-contract) unten listet die Regeln auf, die das Skript befolgen muss.

70 70

71 <Note>71 <Note>

72 Wenn Sie zuvor den Symlink `~/.local/bin/claude` durch Ihren Launcher ersetzt haben, stellen Sie den ursprünglichen Symlink in derselben Änderung wieder her. Ein ersetzter Symlink führt dazu, dass die erste umhüllte Sitzung den Hintergrunddienst gleichzeitig durch beide Launcher startet, und es versetzt die Installation in einen extern verwalteten Zustand: `/doctor` meldet dies, Auto-Update lässt die Datei an Ort und Stelle, und die Bereinigung alter Versionen bleibt deaktiviert, bis das Installationsprogramm diesen Pfad erneut verwaltet.72 Wenn Sie zuvor den Symlink `~/.local/bin/claude` durch Ihren Launcher ersetzt haben, stellen Sie den ursprünglichen Symlink in derselben Änderung wieder her. Ein ersetzter Symlink führt dazu, dass die erste umhüllte Sitzung den Hintergrunddienst gleichzeitig durch beide Launcher startet, und es versetzt die Installation in einen extern verwalteten Zustand: `/doctor` meldet dies, Auto-Update lässt die Datei an Ort und Stelle, und die Bereinigung alter Versionen bleibt deaktiviert, bis das Installationsprogramm diesen Pfad erneut verwaltet.

73 </Note>73 </Note>

74 </Step>74 </Step>

75 75

76 <Step title="Setzen Sie CLAUDE_CODE_PROCESS_WRAPPER in den Einstellungen">76 <Step title="Setzen Sie CLAUDE_CODE_PROCESS_WRAPPER in den Einstellungen">

77 Setzen Sie die Variable im `env`-Block einer Einstellungsdatei, damit der abgelöste Hintergrunddienst sie erbt. Ein Shell-`export` reicht nicht aus: Der Hintergrunddienst startet bei Bedarf, überlebt Ihre Shell und liest Shell-Profile nie erneut.77 Setzen Sie die Variable im `env`-Block einer Einstellungsdatei, damit der abgelöste Hintergrunddienst sie erbt. Ein Shell-`export` reicht nicht aus: Der Hintergrunddienst startet bei Bedarf, überlebt Ihre Shell und liest Shell-Profile nie erneut.

78 78

79 Für einen Computer fügen Sie es zu `~/.claude/settings.json` hinzu. Um es auf jedem Computer in Ihrer Organisation bereitzustellen, legen Sie denselben Block in [verwaltete Einstellungen](/docs/de/managed-settings):79 Für einen Computer fügen Sie es zu `~/.claude/settings.json` hinzu. Um es auf jedem Computer in Ihrer Organisation bereitzustellen, legen Sie denselben Block in [verwaltete Einstellungen](/docs/de/managed-settings):

80 80

103 Projekt- und lokale Einstellungen können den Launcher nicht konfigurieren. Eine Datei, die in ein Repository committed wird, darf nicht in der Lage sein, eine Binärdatei vor jedem Claude-Code-Prozess auf dem Computer zu platzieren, daher ignoriert Claude Code `CLAUDE_CODE_PROCESS_WRAPPER` in `.claude/settings.json` oder `.claude/settings.local.json` mit einer Warnung im [Debug-Protokoll](/docs/de/troubleshooting), und liest den `processWrapper`-Schlüssel nie aus diesen Dateien.103 Projekt- und lokale Einstellungen können den Launcher nicht konfigurieren. Eine Datei, die in ein Repository committed wird, darf nicht in der Lage sein, eine Binärdatei vor jedem Claude-Code-Prozess auf dem Computer zu platzieren, daher ignoriert Claude Code `CLAUDE_CODE_PROCESS_WRAPPER` in `.claude/settings.json` oder `.claude/settings.local.json` mit einer Warnung im [Debug-Protokoll](/docs/de/troubleshooting), und liest den `processWrapper`-Schlüssel nie aus diesen Dateien.

104 </Step>104 </Step>

105 105

106 <Step title="Starten Sie den Hintergrunddienst und Ihre Sitzungen neu">106 <Step title="Starten Sie den Hintergrunddienst und Ihre Sitzungen neu">

107 Ein laufender Hintergrunddienst und alle offenen `claude`-Sitzungen lesen die Variable einmal beim Start, daher starten sie weiterhin Prozesse ohne Umhüllung, bis sie neu gestartet werden. Führen Sie `claude daemon stop --any` aus, um den On-Demand-Dienst zu stoppen; der nächste Befehl, der ihn benötigt, z. B. `claude agents`, startet einen umhüllten. Ein [installierter Dienst](/docs/de/agent-view#the-supervisor-process) nimmt `claude daemon stop` ohne `--any`. Starten Sie dann Ihre offenen `claude`-Sitzungen neu.107 Ein laufender Hintergrunddienst und alle offenen `claude`-Sitzungen lesen die Variable einmal beim Start, daher starten sie weiterhin Prozesse ohne Umhüllung, bis sie neu gestartet werden. Führen Sie `claude daemon stop --any` aus, um den On-Demand-Dienst zu stoppen; der nächste Befehl, der ihn benötigt, z. B. `claude agents`, startet einen umhüllten. Ein [installierter Dienst](/docs/de/agent-view#the-supervisor-process) nimmt `claude daemon stop` ohne `--any`. Starten Sie dann Ihre offenen `claude`-Sitzungen neu.

108 108

109 Auf Computern, die Sie nicht von Hand neu starten können, zieht die erste Sitzung, die nach dem Einstellungs-Push gestartet wird, automatisch einen verbleibenden On-Demand-Dienst ohne Umhüllung zurück. Ein Computer, auf dem keine neue Sitzung startet, behält seinen Dienst ohne Umhüllung, bis eine startet, und ein installierter Dienst benötigt immer den Neustart in diesem Schritt.109 Auf Computern, die Sie nicht von Hand neu starten können, zieht die erste Sitzung, die nach dem Einstellungs-Push gestartet wird, automatisch einen verbleibenden On-Demand-Dienst ohne Umhüllung zurück. Ein Computer, auf dem keine neue Sitzung startet, behält seinen Dienst ohne Umhüllung, bis eine startet, und ein installierter Dienst benötigt immer den Neustart in diesem Schritt.

110 </Step>110 </Step>

111 111

112 <Step title="Überprüfen">112 <Step title="Überprüfen">

113 Führen Sie `/status` in einer Sitzung aus: Der Self-exec-Eintrag zeigt den aufgelösten Startbefehl und warnt, wenn der laufende Hintergrunddienst nicht damit übereinstimmt. `claude daemon status` gibt dieselben Informationen aus der Shell aus, auch nachdem Sie die Variable aufgehoben haben, wenn `/status` den Eintrag nicht mehr anzeigt.113 Führen Sie `/status` in einer Sitzung aus: Der Self-exec-Eintrag zeigt den aufgelösten Startbefehl und warnt, wenn der laufende Hintergrunddienst nicht damit übereinstimmt. `claude daemon status` gibt dieselben Informationen aus der Shell aus, auch nachdem Sie die Variable aufgehoben haben, wenn `/status` den Eintrag nicht mehr anzeigt.

114 </Step>114 </Step>

115</Steps>115</Steps>

116 116

120 120

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

122 122

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

124* **Ordnen Sie Argumente nicht neu an, absorbieren oder stellen Sie ihnen voran**. Das erste Argument ist die Claude-Code-Binärdatei und alles danach ist sein argv.124* **Ordnen Sie Argumente nicht neu an, absorbieren oder stellen Sie ihnen voran**. Das erste Argument ist die Claude-Code-Binärdatei und alles danach ist sein argv.

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

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

153 Verwandte Ressourcen153 Verwandte Ressourcen

154</h2>154</h2>

155 155

156* [Agent View](/docs/de/agent-view): die Hintergrundsitzungen und der Supervisor-Prozess, den der Launcher abdeckt156* [Agent View](/docs/de/agent-view): die Hintergrundsitzungen und der Supervisor-Prozess, den der Launcher abdeckt

157* [Umgebungsvariablen](/docs/de/env-vars): der `CLAUDE_CODE_PROCESS_WRAPPER`-Referenzeintrag157* [Umgebungsvariablen](/docs/de/env-vars): der `CLAUDE_CODE_PROCESS_WRAPPER`-Referenzeintrag

158* [Verwaltete Einstellungen](/docs/de/permissions#managed-settings): Liefern Sie den `env`-Block über eine Flotte158* [Verwaltete Einstellungen](/docs/de/permissions#managed-settings): Liefern Sie den `env`-Block über eine Flotte

159* [Launcher-Fehlerreferenz](/docs/de/errors#claude_code_process_wrapper-launcher-errors): die Verweigerungsmeldungen und wie man sich erholt159* [Launcher-Fehlerreferenz](/docs/de/errors#claude_code_process_wrapper-launcher-errors): die Verweigerungsmeldungen und wie man sich erholt

costs.md +4 −1

Details

359 359

360Erweitertes Denken ist standardmäßig aktiviert, da es die Leistung bei komplexen Planungs- und Denkaufgaben erheblich verbessert. Thinking-Token werden als Output-Token abgerechnet, und das Standard-Budget kann je nach Modell Zehntausende Token pro Anfrage betragen.360Erweitertes Denken ist standardmäßig aktiviert, da es die Leistung bei komplexen Planungs- und Denkaufgaben erheblich verbessert. Thinking-Token werden als Output-Token abgerechnet, und das Standard-Budget kann je nach Modell Zehntausende Token pro Anfrage betragen.

361 361

362Für einfachere Aufgaben, bei denen tiefes Denken nicht erforderlich ist, können Sie Kosten reduzieren, indem Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) mit `/effort` senken oder in `/model`, oder indem Sie Denken in `/config` deaktivieren. Sie können Denken auf Opus 5.5 oder den Fable-Modellen nicht ausschalten, die immer erweitertes Denken verwenden.362Für einfachere Aufgaben, bei denen tiefes Denken nicht erforderlich ist, können Sie Kosten reduzieren, indem Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) mit `/effort` senken oder in `/model`, oder indem Sie Denken in `/config` deaktivieren. Sie können Denken auf Opus 5.5, Sonnet 5.5 oder den Fable-Modellen nicht ausschalten, die immer erweitertes Denken verwenden.

363 363

364Auf Modellen mit einem [festen Thinking-Budget](/docs/de/model-config#adaptive-reasoning-and-fixed-thinking-budgets) können Sie das Budget auch senken, indem Sie die `MAX_THINKING_TOKENS` [Umgebungsvariable](/docs/de/env-vars) setzen, beispielsweise `MAX_THINKING_TOKENS=8000`. Adaptive-Reasoning-Modelle ignorieren Budgets ungleich Null, daher verwenden Sie stattdessen Anstrengungsstufen.364Auf Modellen mit einem [festen Thinking-Budget](/docs/de/model-config#adaptive-reasoning-and-fixed-thinking-budgets) können Sie das Budget auch senken, indem Sie die `MAX_THINKING_TOKENS` [Umgebungsvariable](/docs/de/env-vars) setzen, beispielsweise `MAX_THINKING_TOKENS=8000`. Adaptive-Reasoning-Modelle ignorieren Budgets ungleich Null, daher verwenden Sie stattdessen Anstrengungsstufen.

365 365

369 369

370Das Ausführen von Tests, das Abrufen von Dokumentation oder das Verarbeiten von Protokolldateien kann erheblichen Kontext verbrauchen. Delegieren Sie diese an [Subagents](/docs/de/sub-agents#isolate-high-volume-operations), sodass die ausführliche Ausgabe im Kontext des Subagent bleibt, während nur eine Zusammenfassung zu Ihrem Hauptgespräch zurückkehrt.370Das Ausführen von Tests, das Abrufen von Dokumentation oder das Verarbeiten von Protokolldateien kann erheblichen Kontext verbrauchen. Delegieren Sie diese an [Subagents](/docs/de/sub-agents#isolate-high-volume-operations), sodass die ausführliche Ausgabe im Kontext des Subagent bleibt, während nur eine Zusammenfassung zu Ihrem Hauptgespräch zurückkehrt.

371 371

372Die eigenen Anfragen des Subagent werden immer noch auf Ihre Nutzung angerechnet. Um weniger dafür auszugeben, [wählen Sie ein kleineres Modell für einen Subagent](/docs/de/sub-agents#choose-a-model) oder [führen Sie jeden Subagent auf einem Modell aus](/docs/de/sub-agents#run-every-subagent-on-one-model).

373

372<h3 id="manage-agent-team-costs">374<h3 id="manage-agent-team-costs">

373 Verwalten Sie Agent-Team-Kosten375 Verwalten Sie Agent-Team-Kosten

374</h3>376</h3>

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

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

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

421* **Subagenten und Workflows**: Jeder Subagent und jeder Agent, den ein [dynamischer Workflow](/docs/de/workflows#cost) erzeugt, sendet seine eigenen Anfragen zusätzlich zur Konversation des Hauptagenten. Die [Attributionsaufschlüsselung](#plan-usage-breakdown) zeigt den Subagenten-Anteil

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

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

421 424

cross-session-messaging.md +17 −54

Details

14 14

15Eine Nachricht ist ein Textabschnitt, den ein Claude an einen anderen schreibt, niemals die Gesprächsverlauf oder Dateien des Absenders. Um ein ganzes Gespräch oder seinen Kontext zu verschieben, [setzen Sie die Sitzung statt dessen fort](/docs/de/sessions#resume-a-session).15Eine Nachricht ist ein Textabschnitt, den ein Claude an einen anderen schreibt, niemals die Gesprächsverlauf oder Dateien des Absenders. Um ein ganzes Gespräch oder seinen Kontext zu verschieben, [setzen Sie die Sitzung statt dessen fort](/docs/de/sessions#resume-a-session).

16 16

17Claude verwendet zwei Tools für dies: `ListAgents` um zu entdecken, welche Agenten es erreichen kann, und `SendMessage` um eine Nachricht an einen von ihnen nach Name zu übermitteln. Mit demselben `SendMessage` Tool kann Claude auch [Subagenten](/docs/de/sub-agents#resume-subagents) und [Agent-Team](/docs/de/agent-teams) Teamkollegen innerhalb einer einzelnen Sitzung oder eines Teams anschreiben. Diese Seite behandelt Nachrichten zwischen Ihren unabhängigen Sitzungen.

19<h2 id="when-to-use-cross-session-messaging">17<h2 id="when-to-use-cross-session-messaging">

20 Wann Cross-Session-Messaging verwendet werden sollte18 Wann Cross-Session-Messaging verwendet werden sollte

21</h2>19</h2>

27* **Status von langfristiger Arbeit abrufen**: Lassen Sie eine Migration oder einen Test-Lauf an die Sitzung berichten, die Sie beobachten, oder fragen Sie selbst danach. Wenn diese Sitzung auf diesem Computer ist, kann Claude auch [sie fragen, um eine Benachrichtigung zu erhalten, wenn sie das nächste Mal untätig wird oder beendet wird](#get-a-notice-when-another-session-goes-idle).25* **Status von langfristiger Arbeit abrufen**: Lassen Sie eine Migration oder einen Test-Lauf an die Sitzung berichten, die Sie beobachten, oder fragen Sie selbst danach. Wenn diese Sitzung auf diesem Computer ist, kann Claude auch [sie fragen, um eine Benachrichtigung zu erhalten, wenn sie das nächste Mal untätig wird oder beendet wird](#get-a-notice-when-another-session-goes-idle).

28* **Nachrichten über Computer hinweg**: Erreichen Sie eine Ihrer Sitzungen auf einem anderen Computer oder im Web.26* **Nachrichten über Computer hinweg**: Erreichen Sie eine Ihrer Sitzungen auf einem anderen Computer oder im Web.

29 27

30Verwenden Sie Messaging zwischen unabhängigen Sitzungen, die Sie selbst starten und steuern. Claude Code hat eine dedizierte Funktion für jede der anderen Möglichkeiten, mehrere Sitzungen auszuführen oder zu erreichen, verwenden Sie also die für das, was Sie tun, gebaute:

~~32* Um ein Gespräch in einem anderen Terminal fortzusetzen oder seinen Kontext mit einer neuen Sitzung zu teilen, [setzen Sie die Sitzung fort](/docs/de/sessions#resume-a-session)~~

~~33* Für ein koordiniertes Team von Sitzungen, die Claude spawnt und beaufsichtigt, verwenden Sie [Agent-Teams](/docs/de/agent-teams)~~

~~34* Um viele Sitzungen von einem Ort aus zu beobachten und zu steuern, verwenden Sie [Agent-Ansicht](/docs/de/agent-view)~~

35* Um eine Sitzung selbst von Ihrem Telefon oder einem anderen Gerät aus zu steuern, anstatt dass Sitzungen sich gegenseitig benachrichtigen, verwenden Sie [Remote Control](/docs/de/remote-control)

~~36* Um externe Ereignisse wie CI-Ergebnisse oder Chat-Nachrichten in eine Sitzung zu pushen, verwenden Sie [Kanäle](/docs/de/channels)~~

38<h2 id="message-another-session">28<h2 id="message-another-session">

39 Eine andere Sitzung benachrichtigen29 Eine andere Sitzung benachrichtigen

40</h2>30</h2>

74 64

75Die empfangende Claude liest die Nachricht zwischen Werkzeugaufrufen während eines aktiven Zugs, sodass ein laufendes Werkzeug nie unterbrochen wird. Wenn die empfangende Sitzung untätig ist, startet Claude Code einen neuen Zug mit der Nachricht.65Die empfangende Claude liest die Nachricht zwischen Werkzeugaufrufen während eines aktiven Zugs, sodass ein laufendes Werkzeug nie unterbrochen wird. Wenn die empfangende Sitzung untätig ist, startet Claude Code einen neuen Zug mit der Nachricht.

76 66

77Eine Nachricht von einer anderen Sitzung kommt als Klartext an. Wenn sie eine Datei oder eine [MCP-Ressource](/docs/de/mcp#use-mcp-resources) mit `@` erwähnt, sieht Claude die Erwähnung wie geschrieben und Claude Code fügt nichts an, unabhängig davon, ob die Nachricht einen neuen Zug startet oder während eines ankommt. Claude kann einen erwähnten Pfad auf der empfangenden Maschine immer noch mit seinen eigenen Werkzeugen öffnen, vorbehaltlich der Berechtigungen dieser Sitzung. Vor v2.1.251 hat eine `@`-Erwähnung in einer Nachricht, die einen neuen Zug startete, die Datei oder MCP-Ressource auf der Empfängerseite angehängt.67Eine Nachricht von einer anderen Sitzung kommt als Klartext an. Wenn sie eine Datei oder eine [MCP-Ressource](/docs/de/mcp#use-mcp-resources) mit `@` erwähnt, sieht Claude die Erwähnung wie geschrieben und Claude Code fügt nichts an, unabhängig davon, ob die Nachricht einen neuen Zug startet oder während eines ankommt. Claude kann einen erwähnten Pfad auf der empfangenden Maschine immer noch mit seinen eigenen Werkzeugen öffnen, vorbehaltlich der Berechtigungen dieser Sitzung.

78 68

79Claude Code lehnt eine Nachricht in den folgenden Fällen ab:69Claude Code lehnt eine Nachricht in den folgenden Fällen ab:

80 70

81* Die Nachricht überschreitet die [Größenbeschränkung](#limitations). Claude Code lehnt sie in der sendenden Sitzung ab, bevor sie versendet wird.71* Die Nachricht überschreitet die [Größenbeschränkung](#limitations). Claude Code lehnt sie in der sendenden Sitzung ab, bevor sie versendet wird.

82* Ein schneller Nachrichtenstoß zu einer Sitzung auf diesem Computer hat erreicht, was [diese Sitzung akzeptiert](#limitations). Claude Code lehnt weitere Nachrichten an diese Sitzung ab.72* Ein schneller Nachrichtenstoß zu einer Sitzung auf diesem Computer hat erreicht, was [diese Sitzung akzeptiert](#limitations). Claude Code lehnt weitere Nachrichten an diese Sitzung ab.

83* Das Antwortziel auf diesem Computer besteht einen Sicherheitscheck nicht, z. B. ein symbolisch verknüpftes Ziel oder ein Endpunkt, der nicht der erwartete Prozess ist. [Ablehnung zum Senden einer sitzungsübergreifenden Nachricht](/docs/de/errors#refusing-to-send-a-cross-session-message) listet diese Checks auf.73* Das Antwortziel auf diesem Computer besteht einen Sicherheitscheck nicht, z. B. ein symbolisch verknüpftes Ziel. [Ablehnung zum Senden einer sitzungsübergreifenden Nachricht](/docs/de/errors#refusing-to-send-a-cross-session-message) listet diese Checks auf.

~~84* Claude adressiert die Nachricht an den Namen dieser Sitzung selbst, wie unter [Sehen Sie, welche Sitzungen Claude erreichen kann](#see-which-sessions-claude-can-reach) beschrieben.~~

85 74

86Die empfangende Sitzung überprüft jede ankommende Nachricht gegen ihre eigenen [Eingangskontrollen](#control-inbound-messages), und die Überprüfung endet in einem von drei Ergebnissen:75Die empfangende Sitzung überprüft jede ankommende Nachricht gegen ihre eigenen [Eingangskontrollen](#control-inbound-messages), und die Überprüfung endet in einem von drei Ergebnissen:

87 76

121 Limits110 Limits

122</h4>111</h4>

123 112

124Die Benachrichtigung ist einmalig: Claude Code sendet sie einmal von der beobachteten Sitzung, und keine der beiden Sitzungen fragt die andere ab. Wenn innerhalb von 12 Stunden keine Benachrichtigung ankommt, verwirft Claude Code das Abonnement und teilt Claude dies mit, sodass es nicht weiter wartet.113Wenn innerhalb von 12 Stunden keine Benachrichtigung ankommt, verwirft Claude Code das Abonnement und teilt Claude dies mit, sodass es nicht weiter wartet.

125 114

126Die [Eingangskontrollen](#control-inbound-messages) jeder Seite gelten für eine Benachrichtigung wie eine Nachricht:115Die [Eingangskontrollen](#control-inbound-messages) jeder Seite gelten für eine Benachrichtigung wie eine Nachricht:

127 116

128* **`refuse` auf einer Seite**: nichts kommt an. Die beobachtete Sitzung verwirft die Anfrage, ohne sie aufzuzeichnen oder zu beantworten, sodass das Abonnement nach 12 Stunden unantwortlich abläuft, und eine anfragende Sitzung mit `refuse` abonniert nie.117* **`refuse` auf einer Seite**: nichts kommt an. Die beobachtete Sitzung verwirft die Anfrage, ohne sie aufzuzeichnen oder zu beantworten, sodass das Abonnement nach 12 Stunden unantwortlich abläuft, und eine anfragende Sitzung mit `refuse` abonniert nie.

129* **`hold` auf einer Seite**: die Benachrichtigung kommt mit weniger an. Die beobachtete Sitzung lässt den einzeiligen Status weg, und die anfragende Sitzung zeigt die Benachrichtigung in Ihrem Transkript an, ohne sie an Claude zu liefern.118* **`hold` auf einer Seite**: die Benachrichtigung kommt mit weniger an. Die beobachtete Sitzung lässt den einzeiligen Status weg, und die anfragende Sitzung zeigt die Benachrichtigung in Ihrem Transkript an, ohne sie an Claude zu liefern.

130 119

131Nur die Claude in Ihrer Hauptkonversation kann abonnieren, und nur zu Ihren Sitzungen auf diesem Computer. Wenn ein Subagent oder ein Agent-Team-Kollege `notify_when_idle` setzt, macht Claude Code kein Abonnement und teilt ihm dies mit. Wenn Claude eine Benachrichtigung von einem anderen Agenten anfordert, z. B. einem Kollegen, einem Subagenten oder einer Sitzung außerhalb dieses Computers, lehnt Claude Code den gesamten Aufruf ab, einschließlich jeder daran angehängten Nachricht, und meldet die Ablehnung Claude, damit es die Nachricht ohne die Anfrage erneut senden kann.120Nur die Claude in Ihrer Hauptkonversation kann abonnieren, und nur zu Ihren Sitzungen auf diesem Computer. Wenn Claude eine Benachrichtigung von einem anderen Ziel anfordert, z. B. einem Kollegen, einem Subagenten oder einer Sitzung außerhalb dieses Computers, lehnt Claude Code den gesamten Aufruf ab, einschließlich jeder daran angehängten Nachricht.

132 121

133<h3 id="see-which-sessions-claude-can-reach">122<h3 id="see-which-sessions-claude-can-reach">

134 Sehen Sie, welche Sitzungen Claude erreichen kann123 Sehen Sie, welche Sitzungen Claude erreichen kann

137Claude findet das Ziel einer Nachricht selbst, sodass Sie nichts ausführen müssen, bevor Sie es auffordern zu senden. Um selbst zu sehen, welche Sitzungen Claude erreichen kann, führen Sie den Befehl `/list-agents` aus. Die erste Zeile ist, wenn vorhanden, der Name dieser Sitzung selbst, den Ihre anderen Sitzungen verwenden, um sie zu benachrichtigen. Die Zeilen darunter sind die Sitzungen, die Claude erreichen kann:126Claude findet das Ziel einer Nachricht selbst, sodass Sie nichts ausführen müssen, bevor Sie es auffordern zu senden. Um selbst zu sehen, welche Sitzungen Claude erreichen kann, führen Sie den Befehl `/list-agents` aus. Die erste Zeile ist, wenn vorhanden, der Name dieser Sitzung selbst, den Ihre anderen Sitzungen verwenden, um sie zu benachrichtigen. Die Zeilen darunter sind die Sitzungen, die Claude erreichen kann:

138 127

139* **Subagenten**: Agenten, die in der aktuellen Sitzung ausgeführt werden.128* **Subagenten**: Agenten, die in der aktuellen Sitzung ausgeführt werden.

140* **Kollegen**: die [Agent-Team](/docs/de/agent-teams)-Kollegen dieser Sitzung. Vor v2.1.239 erschienen Kollegen nicht in der Auflistung, obwohl Claude sie bereits nach Name benachrichtigen konnte.129* **Kollegen**: die [Agent-Team](/docs/de/agent-teams)-Kollegen dieser Sitzung.

141* **Ihre anderen lokalen Sitzungen**: Claude-Code-Sitzungen, die auf demselben Computer ausgeführt werden, einschließlich [Hintergrundsitzungen](/docs/de/agent-view). Eine Sitzung wird nur angezeigt, wenn sie einen [Inbox-Socket](#the-sessions-inbox-socket) bindet.130* **Ihre anderen lokalen Sitzungen**: Claude-Code-Sitzungen, die auf demselben Computer ausgeführt werden, einschließlich [Hintergrundsitzungen](/docs/de/agent-view). Eine Sitzung wird nur angezeigt, wenn sie einen [Inbox-Socket](#the-sessions-inbox-socket) bindet.

142* **Ihre Cloud-Sitzungen**: Ihre [Claude Code im Web](/docs/de/claude-code-on-the-web)-Sitzungen, angezeigt, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist. Claude Code kennzeichnet sie in der Auflistung als `cloud`.131* **Ihre [Cloud-Sitzungen](/docs/de/claude-code-on-the-web)**: angezeigt, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist.

143* **Ihre Remote-Control-Sitzungen auf anderen Computern**: angezeigt, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist, und gekennzeichnet als `Remote Control`. Claude Code zeigt `offline` als Status einer Sitzung an, deren Remote-Control-Verbindung unterbrochen wurde.132* **Ihre Remote-Control-Sitzungen auf anderen Computern**: angezeigt, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist, und gekennzeichnet als `Remote Control`. Claude Code zeigt `offline` als Status einer Sitzung an, deren Remote-Control-Verbindung unterbrochen wurde.

144 133

145Diese Sitzung ist keine der Zeilen. Wenn Claude eine Nachricht an den Namen dieser Sitzung selbst adressiert, lehnt Claude Code sie ab und teilt Claude mit, dass das Ziel die aktuelle Sitzung ist. Vor v2.1.239 zeigte die Auflistung nicht den Namen dieser Sitzung an, und Claude Code meldete eine an sie gesendete Nachricht als einen Agenten, den es nicht finden konnte.

~~146~~

147Während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist, behält Claude Code einige Details Ihrer lokalen Sitzungen aus der `/list-agents`-Ausgabe zurück, ohne zu ändern, was Claude selbst sieht, wenn es nach einer Sitzung zum Benachrichtigen sucht:134Während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist, behält Claude Code einige Details Ihrer lokalen Sitzungen aus der `/list-agents`-Ausgabe zurück, ohne zu ändern, was Claude selbst sieht, wenn es nach einer Sitzung zum Benachrichtigen sucht:

148 135

149* **Arbeitsverzeichnisse**: Es lässt das Arbeitsverzeichnis jeder lokalen Sitzung weg.136* **Arbeitsverzeichnisse**: Es lässt das Arbeitsverzeichnis jeder lokalen Sitzung weg.

152 139

153Wenn die Ausgabe etwas auflistet, endet sie mit einer Notiz, die besagt, dass Details zurückgehalten wurden. Das Ausführen von `/rename` gefolgt von einem ungenutzten Namen an der eigenen Tastatur einer Sitzung gibt dieser Sitzung einen Namen, der in der Ausgabe angezeigt wird.140Wenn die Ausgabe etwas auflistet, endet sie mit einer Notiz, die besagt, dass Details zurückgehalten wurden. Das Ausführen von `/rename` gefolgt von einem ungenutzten Namen an der eigenen Tastatur einer Sitzung gibt dieser Sitzung einen Namen, der in der Ausgabe angezeigt wird.

154 141

155Claude Code liest Ihre Cloud- und Remote-Control-Sitzungslisten von neuesten zuerst und stoppt nach einer begrenzten Anzahl von Seiten für jede. Wenn Ihr Konto mehr dieser Sitzungen hat, als passen, listet Claude Code die älteren nicht auf, und Claude kann sie nicht nach Name benachrichtigen. Wenn dies geschieht, teilt Claude Code dies in der Auflistung mit, und Claude sieht die gleiche Notiz, wenn es eine Nachricht sendet.

~~156~~

157Claude adressiert eine Sitzung außerhalb dieses Computers nach Name, genauso wie eine lokale Sitzung. Siehe [Benachrichtigung von Sitzungen auf anderen Computern](#message-sessions-on-other-machines) für die Reise dieser Nachrichten.

~~158~~

159Eine Sitzung antwortet auf den Namen, den Sie mit dem Befehl [`/rename`](/docs/de/commands) oder dem Flag [`--name`](/docs/de/cli-reference#cli-flags) setzen. Wenn Sie keinen setzen, benennt Claude Code die Sitzung selbst. Für eine interaktive Sitzung ist dies der Name, der in [Auflistungen laufender Sitzungen](/docs/de/sessions#name-your-sessions) angezeigt wird.142Eine Sitzung antwortet auf den Namen, den Sie mit dem Befehl [`/rename`](/docs/de/commands) oder dem Flag [`--name`](/docs/de/cli-reference#cli-flags) setzen. Wenn Sie keinen setzen, benennt Claude Code die Sitzung selbst. Für eine interaktive Sitzung ist dies der Name, der in [Auflistungen laufender Sitzungen](/docs/de/sessions#name-your-sessions) angezeigt wird.

160 143

161Wenn Sie eine Sitzung umbenennen, aktualisiert Claude Code auch den gemeinsamen Datensatz, den Ihre anderen Sitzungen verwenden, um den Namen der Sitzung nachzuschlagen. Wenn es diesen Datensatz nicht aktualisieren kann, warnt es Sie in der `/rename`-Ausgabe, dass andere Sitzungen möglicherweise immer noch den alten Namen anzeigen. Führen Sie die Sitzung mit [`--debug`](/docs/de/cli-reference#cli-flags) aus, und Claude Code protokolliert die Ursache des fehlgeschlagenen Updates.

~~162~~

163Wenn Sie eine Sitzung umbenennen oder eine interaktive mit einem Namen starten oder fortsetzen, den eine andere aktive Sitzung auf diesem Computer bereits verwendet, behält Claude Code den Namen bei der Sitzung, die ihn bereits hat, und [benennt Ihren in eine Variante um](/docs/de/sessions#name-your-sessions). Sitzungen können immer noch einen Namen teilen, z. B. wenn eine von ihnen eine frühere Version von Claude Code ausführt oder der gemeinsame Name einer ist, die Claude Code generiert hat. Es sei denn, diese Sitzung ist mit Remote Control verbunden. Claude Code zeigt das Arbeitsverzeichnis jeder lokalen Sitzung in der `/list-agents`-Ausgabe an, sodass Sie gleichnamige Sitzungen unterscheiden können, wenn sie in verschiedenen Verzeichnissen ausgeführt werden. Claude adressiert die Nachricht auf eine von zwei Arten, je nachdem, wie viele aktive Sitzungen auf den Namen antworten:144Wenn Sie eine Sitzung umbenennen oder eine interaktive mit einem Namen starten oder fortsetzen, den eine andere aktive Sitzung auf diesem Computer bereits verwendet, behält Claude Code den Namen bei der Sitzung, die ihn bereits hat, und [benennt Ihren in eine Variante um](/docs/de/sessions#name-your-sessions). Sitzungen können immer noch einen Namen teilen, z. B. wenn eine von ihnen eine frühere Version von Claude Code ausführt oder der gemeinsame Name einer ist, die Claude Code generiert hat. Es sei denn, diese Sitzung ist mit Remote Control verbunden. Claude Code zeigt das Arbeitsverzeichnis jeder lokalen Sitzung in der `/list-agents`-Ausgabe an, sodass Sie gleichnamige Sitzungen unterscheiden können, wenn sie in verschiedenen Verzeichnissen ausgeführt werden. Claude adressiert die Nachricht auf eine von zwei Arten, je nachdem, wie viele aktive Sitzungen auf den Namen antworten:

164 145

165* **Eine Sitzung antwortet auf den Namen**: Claude Code liefert die Nachricht nur auf dem Namen.146* **Eine Sitzung antwortet auf den Namen**: Claude Code liefert die Nachricht nur auf dem Namen.

177| Auf einem anderen Ihrer Computer | Durch Anthropic-Server, ankommend über die [Remote Control](/docs/de/remote-control)-Verbindung dieses Computers |158| Auf einem anderen Ihrer Computer | Durch Anthropic-Server, ankommend über die [Remote Control](/docs/de/remote-control)-Verbindung dieses Computers |

178| Auf [Claude Code im Web](/docs/de/claude-code-on-the-web) | Durch Anthropic-Server, direkt zur Cloud-Sitzung |159| Auf [Claude Code im Web](/docs/de/claude-code-on-the-web) | Durch Anthropic-Server, direkt zur Cloud-Sitzung |

179 160

180Das Starten einer Konversation mit einer Sitzung auf einem anderen Ihrer Computer erfordert Claude Code v2.1.225 oder später und ein Ziel, das [in der Auflistung angezeigt wird](#see-which-sessions-claude-can-reach). Vor v2.1.225 konnte Claude nur auf eine Nachricht antworten, die von einer ankam.161Das Starten einer Konversation mit einer Sitzung auf einem anderen Ihrer Computer erfordert Claude Code v2.1.225 oder später und ein Ziel, das [in der Auflistung angezeigt wird](#see-which-sessions-claude-can-reach).

~~181~~

182Sie können eine Sitzung benachrichtigen, die als `offline` in [der Auflistung](#see-which-sessions-claude-can-reach) angezeigt wird, eine, deren Remote-Control-Verbindung unterbrochen wurde. Der Versand geht durch, aber die Nachricht kommt nur an, nachdem die Maschine dieser Sitzung sich erneut verbunden hat. Claude wird darüber informiert, wenn es sendet.

183 162

184Same-Machine-Lieferung funktioniert überall dort, wo die Funktion aktiviert ist. Jede Sitzung registriert sich in Dateien auf der Festplatte. Wenn Claude Ihre lokalen Sitzungen auflistet oder benachrichtigt, liest Claude Code diese Dateien, um die Sitzungen zu finden, sodass zwei Sitzungen sich nur erreichen können, wenn sie die gleichen Dateien sehen können.163Sie können eine Sitzung benachrichtigen, die als `offline` in [der Auflistung](#see-which-sessions-claude-can-reach) angezeigt wird, eine, deren Remote-Control-Verbindung unterbrochen wurde. Der Versand geht durch, aber die Nachricht kommt nur an, nachdem die Maschine dieser Sitzung sich erneut verbunden hat.

185 164

186Ein Container hat sein eigenes Dateisystem, sodass eine Sitzung darin und eine Sitzung auf dem Host sich nicht erreichen können. Zwei Sitzungen im gleichen Container können sich immer noch gegenseitig benachrichtigen, einschließlich auf einem [selbstgehosteten Runner](/docs/de/self-hosted-environments). Eine Sitzung in WSL 2 und eine native Windows-Sitzung auf demselben Computer können sich auch nicht erreichen, da sie sich unter verschiedenen Home-Verzeichnissen registrieren und auf verschiedene Socket-Typen abhören.165Eine Sitzung in einem Container und eine Sitzung auf dem Host können sich nicht erreichen. Zwei Sitzungen im gleichen Container können sich immer noch gegenseitig benachrichtigen, einschließlich auf einem [selbstgehosteten Runner](/docs/de/self-hosted-environments). Eine Sitzung in WSL 2 und eine native Windows-Sitzung auf demselben Computer können sich auch nicht erreichen.

187 166

188Während diese Sitzung mit Remote Control verbunden ist, zeigt Claude Code die Nachricht in der Konversation dieser Sitzung unter dem Remote-Control-Namen dieser Sitzung an, wenn Sie eine Sitzung auf einem anderen Ihrer Computer benachrichtigen. Die Claude auf diesem Computer kann auf diesen Namen antworten. Wenn diese Sitzung beispielsweise mit Remote Control als `laptop-graceful-unicorn` verbunden ist und Sie Ihren Desktop benachrichtigen, sehen Sie die Nachricht in der Desktop-Sitzung unter `laptop-graceful-unicorn`.167Wenn diese Sitzung nicht mit Remote Control verbunden ist, wenn Claude an eine Sitzung außerhalb dieses Computers sendet, geht die Nachricht immer noch durch, aber ohne eine [Antwortwort](#what-a-message-looks-like), sodass die empfangende Claude nicht antworten kann.

~~189~~

190Wenn diese Sitzung nicht mit Remote Control verbunden ist, wenn Claude an eine Sitzung außerhalb dieses Computers sendet, geht die Nachricht immer noch durch, aber ohne eine [Antwortwort](#what-a-message-looks-like), sodass die empfangende Claude nicht antworten kann. Claude wird darüber informiert, wenn es sendet.

191 168

192Um Ihre Genehmigung zu verlangen, bevor eine Nachricht außerhalb dieses Computers geht, setzen Sie [`isolatePeerMachines`](#require-approval-for-cross-machine-messages).169Um Ihre Genehmigung zu verlangen, bevor eine Nachricht außerhalb dieses Computers geht, setzen Sie [`isolatePeerMachines`](#require-approval-for-cross-machine-messages).

193 170

206 Wie eine Nachricht aussieht183 Wie eine Nachricht aussieht

207</h3>184</h3>

208 185

209Wenn eine Nachricht ankommt, zeigt Claude Code sie im Gespräch als eine schwache einzeilige Vorschau an, und die Vorschauzeile bleibt danach im Gespräch. Die Vorschau trägt den Namen des Absenders und die erste Zeile der Nachricht, abgeschnitten mit `…`, wenn sie lang ist, wie `› Message from @api-worker: Schema migration finished (ctrl+o to expand)`. Vor v2.1.247 zeigte Claude Code die ankommende Nachricht vollständig anstelle einer Vorschau an.186Wenn eine Nachricht ankommt, zeigt Claude Code sie im Gespräch als eine schwache einzeilige Vorschau an, und die Vorschauzeile bleibt danach im Gespräch. Die Vorschau trägt den Namen des Absenders und die erste Zeile der Nachricht, abgeschnitten mit `…`, wenn sie lang ist, wie `› Message from @api-worker: Schema migration finished (ctrl+o to expand)`.

210 187

211Jede dieser zeigt Ihnen den vollständigen Text:188Jede dieser zeigt Ihnen den vollständigen Text:

212 189

215 192

216Die Vorschau verkürzt nur das, was Sie sehen. Ob Sie es erweitern oder nicht, Claude liest die vollständige Nachricht.193Die Vorschau verkürzt nur das, was Sie sehen. Ob Sie es erweitern oder nicht, Claude liest die vollständige Nachricht.

217 194

218Claude empfängt die Nachricht mit dem Namen des Absenders und einer Antwortwort, außer für eine [einseitige Cross-Computer-Nachricht](#message-sessions-on-other-machines), die keine Antwortwort trägt. Über den Namen und die Antwortwort hinaus erhält der empfangende Claude den Text der Nachricht, niemals die Gesprächshistorie oder Dateien des Absenders. [Nachrichtenübermittlung](#message-delivery) behandelt `@`-Erwähnungen im Text.195Claude empfängt die Nachricht mit dem Namen des Absenders und einer Antwortwort, außer für eine [einseitige Cross-Computer-Nachricht](#message-sessions-on-other-machines), die keine Antwortwort trägt.

~~219~~

220Eine Nachricht, die ein [Subagent](/docs/de/sub-agents) schrieb, kommt unter dem Namen der sendenden Sitzung an, mit dem Subagenten im Nachrichtentext identifiziert. Eine Antwort darauf erreicht das Hauptgespräch dieser Sitzung, nicht den Subagenten.

221 196

222Dieses Beispiel ist eine Nachricht, die ein Claude an einen anderen schrieb, wie sein vollständiger Text liest, wenn Sie ihn erweitern:197Dieses Beispiel ist eine Nachricht, die ein Claude an einen anderen schrieb, wie sein vollständiger Text liest, wenn Sie ihn erweitern:

223 198

254* Wenn der Dialog über die [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry)-Frist hinaus unantwortlich bleibt, schließt Claude Code ihn und verwirft die Nachricht. Die Frist beträgt standardmäßig fünf Minuten.229* Wenn der Dialog über die [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry)-Frist hinaus unantwortlich bleibt, schließt Claude Code ihn und verwirft die Nachricht. Die Frist beträgt standardmäßig fünf Minuten.

255* Während kein Terminal an eine [Hintergrund-Sitzung](/docs/de/agent-view) angehängt ist, lässt Claude Code den Dialog über die Frist hinaus offen. Nachdem Sie angehängt haben, schließt Claude Code den Dialog und verwirft die Nachricht nur, wenn sie für einen vollständigen Fristzeitraum unantwortlich bleibt.230* Während kein Terminal an eine [Hintergrund-Sitzung](/docs/de/agent-view) angehängt ist, lässt Claude Code den Dialog über die Frist hinaus offen. Nachdem Sie angehängt haben, schließt Claude Code den Dialog und verwirft die Nachricht nur, wenn sie für einen vollständigen Fristzeitraum unantwortlich bleibt.

256* Wenn sich die Berechtigungsmodus-Klasse dieser Sitzung ändert, während Nachrichten gehalten werden, wendet Claude Code die Inbound-Regeln erneut an, übermittelt die Nachrichten, die sie jetzt akzeptieren, und zeigt eine Benachrichtigung an.231* Wenn sich die Berechtigungsmodus-Klasse dieser Sitzung ändert, während Nachrichten gehalten werden, wendet Claude Code die Inbound-Regeln erneut an, übermittelt die Nachrichten, die sie jetzt akzeptieren, und zeigt eine Benachrichtigung an.

257* Wenn eine Einstellungsänderung `refuse` anwendbar macht, während Nachrichten gehalten werden, verwirft Claude Code jede gehaltene Nachricht und meldet eine Ablehnung an jeden Absender, den es erreichen kann.

~~258~~

259Wenn der Absender eine Sitzung auf dem gleichen Computer ist, sendet Claude Code eine Benachrichtigung zurück an ihn, wenn der Empfänger die Nachricht hält, und eine Nachverfolgung, wenn der Empfänger sie später übermittelt, ablehnt oder ablaufen lässt. Die Benachrichtigung erreicht den sendenden Claude, sodass er weiß, nicht weiter auf eine Nachricht zu warten, die die andere Sitzung nicht gelesen hat.

~~260~~

261In einer interaktiven sendenden Sitzung erscheint die Benachrichtigung im Transkript. Ein [`claude -p`](/docs/de/headless)-Absender erhält sie in [gestreamter Ausgabe](/docs/de/headless#stream-responses) als eine [informative `system`-Nachricht](/docs/de/agent-sdk/typescript#sdkinformationalmessage). Benachrichtigungen an `claude -p`-Absender erfordern Claude Code v2.1.271 oder später.

262 232

263Wenn der Empfänger die Nachricht ablehnt, sagt die Benachrichtigung des Absenders, dass der Empfänger keine Cross-Session-Nachrichten akzeptiert, und teilt dem Claude des Absenders mit, nicht zu warten oder erneut zu senden.233Claude Code hält höchstens 100 Nachrichten, und verwirft danach die ältesten.

~~264~~

265Claude Code hält höchstens 100 Nachrichten, getrennt von der Übermittlungswarteschlange, und verwirft danach die ältesten.

266 234

267<h3 id="non-interactive-sessions">235<h3 id="non-interactive-sessions">

268 Nicht-interaktive Sitzungen236 Nicht-interaktive Sitzungen

277 245

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

279 247

280Wenn die Sitzung mit noch gehaltenen Nachrichten endet, meldet Claude Code sie als abgelaufen an jeden Absender, den es erreichen kann. Vor v2.1.225 galt keine Frist in einer `-p`-Sitzung: Eine gehaltene Nachricht blieb gehalten, es sei denn, eine Berechtigungsmodus-Änderung während des Laufs übermittelte sie, und eine Sitzung, die mit gehaltenen Nachrichten endete, meldete nichts an ihre Absender.

~~281~~

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

283 249

284<h3 id="the-sessions-inbox-socket">250<h3 id="the-sessions-inbox-socket">

294* `/status` zeigt ihn in der Zeile `Peer address`. Der Pfad ist mit `uds:` vorangestellt.260* `/status` zeigt ihn in der Zeile `Peer address`. Der Pfad ist mit `uds:` vorangestellt.

295* Claude Code exportiert ihn zu [Hooks](/docs/de/hooks) und Bash-Befehlen als die Umgebungsvariable [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/de/env-vars#variables):261* Claude Code exportiert ihn zu [Hooks](/docs/de/hooks) und Bash-Befehlen als die Umgebungsvariable [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/de/env-vars#variables):

296 * In einer Sitzung, die mit aktiviertem Messaging startet, exportiert Claude Code die Variable, bevor ein Hook läuft, einschließlich `SessionStart`.262 * In einer Sitzung, die mit aktiviertem Messaging startet, exportiert Claude Code die Variable, bevor ein Hook läuft, einschließlich `SessionStart`.

297 * Jede Sitzung exportiert ihren eigenen Socket, niemals einen, der von einer übergeordneten Sitzung geerbt wird.

298 263

299Auf macOS und Linux beschränkt Claude Code den Socket auf Ihren Betriebssystem-Benutzer. Auf nativem Windows erfordert es stattdessen, dass jede Verbindung sich zuerst mit einem Schlüssel authentifiziert, den nur Ihr Betriebssystem-Benutzer lesen kann. Auf jeden Fall kann auf einem gemeinsamen Computer die Sitzung eines anderen Benutzers nicht an ihn übermitteln.264Auf macOS und Linux beschränkt Claude Code den Socket auf Ihren Betriebssystem-Benutzer. Auf nativem Windows erfordert es stattdessen, dass jede Verbindung sich zuerst mit einem Schlüssel authentifiziert, den nur Ihr Betriebssystem-Benutzer lesen kann. Auf jeden Fall kann auf einem gemeinsamen Computer die Sitzung eines anderen Benutzers nicht an ihn übermitteln.

300 265

307 272

308Öffnen Sie die Verbindung nur, wenn die Nachricht, die Sie posten, bereit ist. Claude Code schließt eine Verbindung, die innerhalb von 30 Sekunden keine vollständige Zeile gesendet hat, sodass erfassen Sie zuerst die Ausgabe eines langsamen Befehls und öffnen Sie dann die Verbindung, um sie zu senden.273Öffnen Sie die Verbindung nur, wenn die Nachricht, die Sie posten, bereit ist. Claude Code schließt eine Verbindung, die innerhalb von 30 Sekunden keine vollständige Zeile gesendet hat, sodass erfassen Sie zuerst die Ausgabe eines langsamen Befehls und öffnen Sie dann die Verbindung, um sie zu senden.

309 274

310Die [Eigene-Kind-Regeln](#own-child-messages) unten sagen, wann Claude Code das Token konsultiert und wie es eine Nachricht behandelt, die es nicht verifizieren kann.

~~311~~

312<span id="own-child-messages" />Claude Code führt Nachrichten, die auf dem Socket ankommen, durch die gleichen [Inbound-Kontrollen](#control-inbound-messages) wie jede andere Peer-Nachricht, mit einer Ausnahme und einer Voraussetzung:275<span id="own-child-messages" />Claude Code führt Nachrichten, die auf dem Socket ankommen, durch die gleichen [Inbound-Kontrollen](#control-inbound-messages) wie jede andere Peer-Nachricht, mit einer Ausnahme und einer Voraussetzung:

313 276

314* **Eigene-Kind-Nachrichten**: Wenn kein `crossSessionInbound`-Wert gilt, übermittelt Claude Code eine Nachricht, die es verifiziert, kam von den eigenen Kind-Prozessen der Sitzung, wie ein Hook oder Bash-Befehl, der an seinen eigenen Socket der Sitzung zurückpostet.277* **Eigene-Kind-Nachrichten**: Wenn kein `crossSessionInbound`-Wert gilt, übermittelt Claude Code eine Nachricht, die es verifiziert, kam von den eigenen Kind-Prozessen der Sitzung, wie ein Hook oder Bash-Befehl, der an seinen eigenen Socket der Sitzung zurückpostet.

382 * **Cloud-Sitzung fehlt**: eine Cloud-Sitzung erscheint nur, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist.345 * **Cloud-Sitzung fehlt**: eine Cloud-Sitzung erscheint nur, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist.

383 * **Sitzung auf anderem Computer fehlt**: eine Sitzung auf einem anderen Ihrer Computer erscheint nur, wenn sie mit [Remote Control](/docs/de/remote-control) läuft und diese Sitzung auch verbunden ist.346 * **Sitzung auf anderem Computer fehlt**: eine Sitzung auf einem anderen Ihrer Computer erscheint nur, wenn sie mit [Remote Control](/docs/de/remote-control) läuft und diese Sitzung auch verbunden ist.

384 * **Sitzung auf anderem Computer `offline`**: eine Nachricht an eine Sitzung, die als `offline` aufgelistet ist, wird durchgeleitet, kommt aber [erst an, nachdem sich der Computer dieser Sitzung wieder verbindet](#message-sessions-on-other-machines).347 * **Sitzung auf anderem Computer `offline`**: eine Nachricht an eine Sitzung, die als `offline` aufgelistet ist, wird durchgeleitet, kommt aber [erst an, nachdem sich der Computer dieser Sitzung wieder verbindet](#message-sessions-on-other-machines).

385 * **Ältere Cloud- oder Sitzung auf anderem Computer fehlt**: Claude Code [liest diese Sitzungslisten neueste zuerst und stoppt nach einer begrenzten Anzahl von Seiten](#see-which-sessions-claude-can-reach), sodass Claude eine Sitzung, die über sie hinausfiel, nicht nach Name benachrichtigen kann.348 * **Ältere Cloud- oder Sitzung auf anderem Computer fehlt**: Claude Code liest diese Sitzungslisten neueste zuerst und stoppt nach einer begrenzten Anzahl von Seiten, sodass Claude eine Sitzung, die über sie hinausfiel, nicht nach Name benachrichtigen kann.

386 * **Ein Gespräch starten**: [Nachrichten an Sitzungen auf anderen Computern](#message-sessions-on-other-machines) behandelt das Starten eines Gesprächs mit einer Sitzung jenseits dieses Computers.

387 349

388In einer Sitzung mit Messaging zeigt `/status` auch eine Zeile `Peer address` mit der eigenen Inbox-Adresse der Sitzung, oder `unavailable` und den Grund, wenn Claude Code [einen Inbox nicht einrichten konnte](#the-sessions-inbox-socket).350In einer Sitzung mit Messaging zeigt `/status` auch eine Zeile `Peer address` mit der eigenen Inbox-Adresse der Sitzung, oder `unavailable` und den Grund, wenn Claude Code [einen Inbox nicht einrichten konnte](#the-sessions-inbox-socket).

389 351

395 357

396* **Nur Klartext**: Claude sendet nur Klartext über Sitzungen. Strukturierte [Agent-Team](/docs/de/agent-teams)-Protokoll-Nachrichten bleiben in einem Team.358* **Nur Klartext**: Claude sendet nur Klartext über Sitzungen. Strukturierte [Agent-Team](/docs/de/agent-teams)-Protokoll-Nachrichten bleiben in einem Team.

397* **Same-Machine-Nachrichtengröße ist begrenzt**: Claude Code lehnt eine Nachricht an eine Sitzung auf diesem Computer ab, sobald ihre serialisierte Form etwa eine Million Zeichen überschreitet. Die Ablehnung [benennt die genauen Größen](/docs/de/errors#message-too-large-for-cross-session-delivery). Nichts erreicht die empfangende Sitzung.359* **Same-Machine-Nachrichtengröße ist begrenzt**: Claude Code lehnt eine Nachricht an eine Sitzung auf diesem Computer ab, sobald ihre serialisierte Form etwa eine Million Zeichen überschreitet. Die Ablehnung [benennt die genauen Größen](/docs/de/errors#message-too-large-for-cross-session-delivery). Nichts erreicht die empfangende Sitzung.

398* **Schnelle Bursts an eine Sitzung werden beim Absender abgelehnt**: Sobald ein schneller Burst von Nachrichten an eine Sitzung auf diesem Computer erreicht, was diese Sitzung akzeptiert, lehnt Claude Code weitere Sends in der sendenden Sitzung ab. Die [Ablehnung benennt den Burst](/docs/de/errors#too-many-messages-to-this-session-just-now) und teilt Claude mit, den Rest in eine Nachricht zu packen oder zu warten. Vor v2.1.236 meldete Claude Code diese Sends als gesendet, während die empfangende Sitzung sie verwarf.360* **Schnelle Bursts an eine Sitzung werden beim Absender abgelehnt**: Sobald ein schneller Burst von Nachrichten an eine Sitzung auf diesem Computer erreicht, was diese Sitzung akzeptiert, lehnt Claude Code weitere Sends in der sendenden Sitzung ab. Die [Ablehnung benennt den Burst](/docs/de/errors#too-many-messages-to-this-session-just-now) und teilt Claude mit, den Rest in eine Nachricht zu packen oder zu warten.

399* **Nachrichtenschleifen werden gedrosselt**: In der empfangenden Sitzung drosselt Claude Code wiederholte Nachrichten pro Absender, verwirft identische Wiederholungen, die in einem kurzen Fenster ankommen, und reiht höchstens 50 akzeptierte Nachrichten für Claude zum Lesen ein. Eine Nachrichtenschleife zwischen zwei Sitzungen stoppt daher von selbst. Wenn die Ratenbegrenzung, Wiederholungsprüfung oder Warteschlangen-Obergrenze eine Nachricht von einer interaktiven Sitzung auf diesem Computer verwirft, teilt Claude Code dieser Sitzung mit, welche verwirft wurde, und teilt ihrem Claude mit, nicht sofort erneut zu senden.361* **Nachrichtenschleifen werden gedrosselt**: In der empfangenden Sitzung drosselt Claude Code wiederholte Nachrichten pro Absender, verwirft identische Wiederholungen, die in einem kurzen Fenster ankommen, und reiht höchstens 50 akzeptierte Nachrichten für Claude zum Lesen ein. Eine Nachrichtenschleife zwischen zwei Sitzungen stoppt daher von selbst.

400 362

401<h2 id="related-resources">363<h2 id="related-resources">

402 Verwandte Ressourcen364 Verwandte Ressourcen

405* [Subagenten](/docs/de/sub-agents#resume-subagents) und [Agent-Teams](/docs/de/agent-teams#messages-between-agents): Messaging innerhalb einer einzelnen Sitzung oder eines Teams367* [Subagenten](/docs/de/sub-agents#resume-subagents) und [Agent-Teams](/docs/de/agent-teams#messages-between-agents): Messaging innerhalb einer einzelnen Sitzung oder eines Teams

406* [Hintergrund-Agenten](/docs/de/agent-view): Versenden und überwachen Sie die parallelen Sitzungen, die Sie möglicherweise benachrichtigen368* [Hintergrund-Agenten](/docs/de/agent-view): Versenden und überwachen Sie die parallelen Sitzungen, die Sie möglicherweise benachrichtigen

407* [Remote Control](/docs/de/remote-control): Verbinden Sie diese Sitzung, um Ihre Sitzungen auf anderen Computern zu erreichen369* [Remote Control](/docs/de/remote-control): Verbinden Sie diese Sitzung, um Ihre Sitzungen auf anderen Computern zu erreichen

370* [Kanäle](/docs/de/channels): Externe Ereignisse wie CI-Ergebnisse oder Chat-Nachrichten in eine Sitzung einbinden

408* [Einstellungen](/docs/de/settings-reference#all-settings): `crossSessionInbound`, `isolatePeerMachines` und `dialogExpiry`371* [Einstellungen](/docs/de/settings-reference#all-settings): `crossSessionInbound`, `isolatePeerMachines` und `dialogExpiry`

409* [Berechtigungsmodi](/docs/de/permission-modes): die Modi hinter den zwei Klassen des Inbound-Standards372* [Berechtigungsmodi](/docs/de/permission-modes): die Modi hinter den zwei Klassen des Inbound-Standards

410* [Tools-Referenz](/docs/de/tools-reference): die Zeilen `ListAgents` und `SendMessage` in der Tools-Tabelle373* [Tools-Referenz](/docs/de/tools-reference): die Zeilen `ListAgents` und `SendMessage` in der Tools-Tabelle

data-usage.md +2 −2

Details

110 110

111[Cloud-Sitzungen](/docs/de/claude-code-on-the-web) werden standardmäßig in von Anthropic verwalteten virtuellen Maschinen statt lokal ausgeführt. Sitzungen, die Ihre Organisation an eine [selbstgehostete Umgebung](/docs/de/self-hosted-environments) leitet, werden auf einer Infrastruktur ausgeführt, die Sie kontrollieren; für Details darüber, was auf Ihren Maschinen bleibt und was noch an Anthropic geht, siehe [What stays on your infrastructure](/docs/de/self-hosted-environments#what-stays-on-your-infrastructure). In von Anthropic gehosteten Cloud-Sitzungen:111[Cloud-Sitzungen](/docs/de/claude-code-on-the-web) werden standardmäßig in von Anthropic verwalteten virtuellen Maschinen statt lokal ausgeführt. Sitzungen, die Ihre Organisation an eine [selbstgehostete Umgebung](/docs/de/self-hosted-environments) leitet, werden auf einer Infrastruktur ausgeführt, die Sie kontrollieren; für Details darüber, was auf Ihren Maschinen bleibt und was noch an Anthropic geht, siehe [What stays on your infrastructure](/docs/de/self-hosted-environments#what-stays-on-your-infrastructure). In von Anthropic gehosteten Cloud-Sitzungen:

112 112

113* **Code- und Datenspeicherung:** Ihr Repository wird auf eine isolierte VM geklont. Code und Sitzungsdaten unterliegen den Aufbewahrungs- und Nutzungsrichtlinien für Ihren Kontotyp (siehe Abschnitt Datenspeicherung oben)113* **Code- und Datenspeicherung:** Ihr Repository wird auf eine isolierte VM geklont. Anthropic speichert das Sitzungstranskript, damit Sie später zur Sitzung zurückkehren können. Code und Sitzungsdaten unterliegen den [Aufbewahrungs- und Nutzungsrichtlinien](#data-retention) für Ihren Kontotyp

114* **Anmeldedaten:** Die GitHub-Authentifizierung wird über einen sicheren Proxy durchgeführt; Ihre GitHub-Anmeldedaten gelangen niemals in die Sandbox114* **Anmeldedaten:** GitHub-Anmeldedaten werden verschlüsselt auf Anthropic-Servern gespeichert und gelangen niemals in die VM. GitHub-Datenverkehr von der VM wird über einen Anthropic-Proxy geleitet, der sie auf der Serverseite anfügt

115* **Netzwerkverkehr:** Der gesamte ausgehende Datenverkehr wird über einen Sicherheitsproxy für Audit-Protokollierung und Missbrauchsprävention geleitet115* **Netzwerkverkehr:** Der gesamte ausgehende Datenverkehr wird über einen Sicherheitsproxy für Audit-Protokollierung und Missbrauchsprävention geleitet

116* **Sitzungsdaten:** Eingabeaufforderungen, Codeänderungen und Ausgaben folgen den gleichen Datenrichtlinien wie die lokale Claude Code-Nutzung116* **Sitzungsdaten:** Eingabeaufforderungen, Codeänderungen und Ausgaben folgen den gleichen Datenrichtlinien wie die lokale Claude Code-Nutzung

117 117

debug-your-config.md +1 −1

Details

110| Hook wird nie ausgelöst | `matcher` verwendet `,` als Trennzeichen in einer Version vor v2.1.191 | Claude Code v2.1.191 oder später behandelt `,` als Listentrennzeichen wie `\|`. Frühere Versionen bewerten ein Komma als Literalzeichen, daher entspricht `"Edit,Write"` nichts. Verwenden Sie stattdessen `\|`, oder aktualisieren Sie Claude Code. |110| Hook wird nie ausgelöst | `matcher` verwendet `,` als Trennzeichen in einer Version vor v2.1.191 | Claude Code v2.1.191 oder später behandelt `,` als Listentrennzeichen wie `\|`. Frühere Versionen bewerten ein Komma als Literalzeichen, daher entspricht `"Edit,Write"` nichts. Verwenden Sie stattdessen `\|`, oder aktualisieren Sie Claude Code. |

111| Hook wird nie ausgelöst | `matcher`-Wert ist Kleinbuchstaben, z. B. `"bash"` | Matching ist Groß-/Kleinschreibung-empfindlich. Tool-Namen werden großgeschrieben: `Bash`, `Edit`, `Write`, `Read`. |111| Hook wird nie ausgelöst | `matcher`-Wert ist Kleinbuchstaben, z. B. `"bash"` | Matching ist Groß-/Kleinschreibung-empfindlich. Tool-Namen werden großgeschrieben: `Bash`, `Edit`, `Write`, `Read`. |

112| Hook wird nie ausgelöst | Hooks befinden sich in einer eigenständigen Datei statt in `settings.json` | Es gibt keine eigenständige Hooks-Datei für Projekt- oder Benutzerkonfiguration. Definieren Sie Hooks unter dem Schlüssel `"hooks"` in `settings.json`. Nur [Plugins](/docs/de/plugins/components#hooks) laden eine separate `hooks/hooks.json`. Siehe [Hook-Konfiguration](/docs/de/hooks). |112| Hook wird nie ausgelöst | Hooks befinden sich in einer eigenständigen Datei statt in `settings.json` | Es gibt keine eigenständige Hooks-Datei für Projekt- oder Benutzerkonfiguration. Definieren Sie Hooks unter dem Schlüssel `"hooks"` in `settings.json`. Nur [Plugins](/docs/de/plugins/components#hooks) laden eine separate `hooks/hooks.json`. Siehe [Hook-Konfiguration](/docs/de/hooks). |

113| Berechtigungen, Hooks oder global gesetzte Umgebungsvariablen werden ignoriert | Konfiguration wurde zu `~/.claude.json` hinzugefügt | `~/.claude.json` enthält App-Status und UI-Umschalter. `permissions`, `hooks` und `env` gehören zu `~/.claude/settings.json`. Dies sind zwei verschiedene Dateien. |113| Berechtigungen oder Hooks, die global gesetzt sind, werden ignoriert | Konfiguration wurde zu `~/.claude.json` hinzugefügt | `~/.claude.json` enthält App-Status und UI-Umschalter. `permissions`, `hooks` und `env` gehören zu `~/.claude/settings.json`. Dies sind zwei verschiedene Dateien. |

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

115| 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`. |115| 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`. |

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

desktop.md +12 −4

Details

735 735

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

737 737

738[Erweitertes Denken](/docs/de/model-config#extended-thinking) ist standardmäßig aktiviert, was die Leistung bei komplexen Denkaufgaben verbessert, aber zusätzliche Token verwendet. Auf der Anthropic API setzen Sie `MAX_THINKING_TOKENS` auf `0` im lokalen Umgebungs-Editor, um das Denken auszuschalten; dies hat keine Auswirkung auf Opus 5.5 oder die Fable-Modelle, die immer erweitertes Denken verwenden. Bei ausgeschaltetem Denken auf der Anthropic API sendet Claude Code stattdessen den Aufwand `high` an Modelle, von denen es weiß, dass sie [diese Kombination nicht akzeptieren](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5.738[Erweitertes Denken](/docs/de/model-config#extended-thinking) ist standardmäßig aktiviert, was die Leistung bei komplexen Denkaufgaben verbessert, aber zusätzliche Token verwendet. Auf der Anthropic API setzen Sie `MAX_THINKING_TOKENS` auf `0` im lokalen Umgebungs-Editor, um das Denken auszuschalten; dies hat keine Auswirkung auf Opus 5.5, Sonnet 5.5 oder die Fable-Modelle, die immer erweitertes Denken verwenden. Bei ausgeschaltetem Denken auf der Anthropic API sendet Claude Code stattdessen den Aufwand `high` an Modelle, von denen es weiß, dass sie [diese Kombination nicht akzeptieren](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5.

739 739

740Bei Modellen mit [adaptiver Argumentation](/docs/de/model-config#adjust-effort-level) werden `MAX_THINKING_TOKENS`-Werte außer `0` ignoriert, da adaptive Argumentation die Denktiefe steuert. Bei Opus 4.6 und Sonnet 4.6 setzen Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` auf `1`, um ein festes Denk-Budget zu verwenden; Fable-Modelle, Sonnet 5 und Opus 4.7 und später verwenden immer adaptive Argumentation und haben keinen Modus mit festem Budget.740Bei Modellen mit [adaptiver Argumentation](/docs/de/model-config#adjust-effort-level) werden `MAX_THINKING_TOKENS`-Werte außer `0` ignoriert, da adaptive Argumentation die Denktiefe steuert. Bei Opus 4.6 und Sonnet 4.6 setzen Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` auf `1`, um ein festes Denk-Budget zu verwenden; Fable-Modelle, Sonnet 5 und später sowie Opus 4.7 und später verwenden immer adaptive Argumentation und haben keinen Modus mit festem Budget.

741 741

742<h4 id="local-sessions-on-managed-devices">742<h4 id="local-sessions-on-managed-devices">

743 Lokale Sitzungen auf verwalteten Geräten743 Lokale Sitzungen auf verwalteten Geräten

932 Authentifizierung und SSO932 Authentifizierung und SSO

933</h3>933</h3>

934 934

935Enterprise-Organisationen können SSO für alle Benutzer verlangen. Siehe [Authentifizierung](/docs/de/authentication) für Plan-Level-Details und [Einrichten von SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) für SAML-Konfiguration; OIDC-Setup wird im [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) behandelt.935Team- und Enterprise-Organisationen können SSO für alle Benutzer verlangen. Siehe [Authentifizierung](/docs/de/authentication) für Plan-Level-Details und [Einrichten von SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) für SAML-Konfiguration; OIDC-Setup wird im [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) behandelt.

936 936

937<h3 id="data-handling">937<h3 id="data-handling">

938 Datenbehandlung938 Datenbehandlung

961 961

962Um eine CLI-Sitzung in Desktop zu verschieben, führen Sie `/desktop` im Terminal aus. Claude speichert Ihre Sitzung und öffnet sie in der Desktop-App, dann beendet die CLI. Dieser Befehl ist auf macOS und x64 Windows verfügbar, wenn Sie mit einem Claude-Abonnement angemeldet sind. Er ist nicht mit API-Schlüssel-Authentifizierung oder auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar.962Um eine CLI-Sitzung in Desktop zu verschieben, führen Sie `/desktop` im Terminal aus. Claude speichert Ihre Sitzung und öffnet sie in der Desktop-App, dann beendet die CLI. Dieser Befehl ist auf macOS und x64 Windows verfügbar, wenn Sie mit einem Claude-Abonnement angemeldet sind. Er ist nicht mit API-Schlüssel-Authentifizierung oder auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar.

963 963

964Um eine CLI-Sitzung von innen in Desktop aufzugreifen, geben Sie stattdessen `/resume` in das Eingabefeld ein. Desktop listet die Sitzungen auf, die Sie von der CLI gestartet haben, und Sie können sie nach Titel, Ordner oder Branch durchsuchen und eine Vorschau sehen, wo jede endete. Wählen Sie eine Sitzung aus und sie wird in der App mit ihrer vollständigen Konversation und ihrem Kontext fortgesetzt.964Sie können auch eine CLI-Sitzung von innen in Desktop aufgreifen mit `/resume`. Der Befehl ist in lokalen Sitzungen verfügbar, nicht in SSH-, WSL- oder Cloud-Sitzungen.

965

966Um eine Terminal-Sitzung in Desktop fortzusetzen:

967

9681. Schließen Sie die Sitzung im Terminal.

9692. Geben Sie im Desktop-Eingabefeld `/resume` ein. Desktop listet die Sitzungen auf, die Sie von der CLI auf diesem Computer gestartet haben. Suchen Sie nach Titel, Ordner oder Branch und sehen Sie eine Vorschau, wo jede endete.

9703. Wählen Sie die Sitzung aus. Sie wird in der App mit ihrer vollständigen Konversation und ihrem Kontext fortgesetzt.

971

972Desktop setzt dieselbe Sitzung fort, nicht eine Kopie, daher findet `claude --resume` im Terminal sie danach immer noch.

965 973

966<Tip>974<Tip>

967 Wann Desktop vs CLI verwendet werden: Verwenden Sie Desktop, wenn Sie parallele Sitzungen in einem Fenster verwalten, Panes nebeneinander anordnen oder Änderungen visuell überprüfen möchten. Verwenden Sie die CLI, wenn Sie Scripting, Automatisierung oder einen Terminal-Workflow bevorzugen.975 Wann Desktop vs CLI verwendet werden: Verwenden Sie Desktop, wenn Sie parallele Sitzungen in einem Fenster verwalten, Panes nebeneinander anordnen oder Änderungen visuell überprüfen möchten. Verwenden Sie die CLI, wenn Sie Scripting, Automatisierung oder einen Terminal-Workflow bevorzugen.

desktop-ios-simulator.md +21 −19

Details

23* Claude Desktop v1.24012.0 oder später23* Claude Desktop v1.24012.0 oder später

24* Einen Mac, da Apples iOS-Simulator nur auf macOS läuft24* Einen Mac, da Apples iOS-Simulator nur auf macOS läuft

25* [Xcode](https://developer.apple.com/xcode/) mit installierter iOS-Plattform, die die Simulator-Geräte bereitstellt. Wenn Xcode noch keine Simulatoren auflistet, siehe [Der Simulator-Bereich sagt, dass keine Simulatoren gefunden wurden](#the-simulator-pane-says-no-simulators-were-found)25* [Xcode](https://developer.apple.com/xcode/) mit installierter iOS-Plattform, die die Simulator-Geräte bereitstellt. Wenn Xcode noch keine Simulatoren auflistet, siehe [Der Simulator-Bereich sagt, dass keine Simulatoren gefunden wurden](#the-simulator-pane-says-no-simulators-were-found)

26 * Verwenden Sie Xcode 26.x. Der Bereich funktioniert noch nicht mit Xcode 27, das die Simulator-App durch Device Hub ersetzt. Wenn `xcode-select` auf Ihrem Mac auf Xcode 27 verweist, siehe [Der Simulator-Bereich schlägt mit Xcode 27 fehl](#the-simulator-pane-fails-with-xcode-27)26 * Xcode 26.x oder Xcode 27 wird empfohlen, und der Bereich funktioniert mit beiden. Wenn Sie mehr als ein Xcode installiert haben, siehe [Wählen Sie, welches Xcode der Simulator-Bereich verwendet](#choose-which-xcode-the-simulator-pane-uses)

27 27

28<Note>28<Note>

29 Auf dieser Seite bezieht sich „Gerät" auf ein simuliertes iPhone oder iPad, eines der gleichen Simulator-Geräte, die Sie in Xcode unter **Window → Devices and Simulators** verwalten, nicht auf physische Hardware.29 Auf dieser Seite bezieht sich „Gerät" auf ein simuliertes iPhone oder iPad, eines der gleichen Simulator-Geräte, die Sie in Xcode unter **Window → Devices and Simulators** verwalten, nicht auf physische Hardware.

31 31

32Der Simulator-Bereich ist nur in lokalen Sitzungen verfügbar. In [Cloud-](/docs/de/desktop#run-long-running-tasks-in-the-cloud) und [SSH-](/docs/de/desktop#ssh-sessions) Sitzungen läuft Claude auf einem Computer, der die Simulatoren auf Ihrem Mac nicht erreichen kann.32Der Simulator-Bereich ist nur in lokalen Sitzungen verfügbar. In [Cloud-](/docs/de/desktop#run-long-running-tasks-in-the-cloud) und [SSH-](/docs/de/desktop#ssh-sessions) Sitzungen läuft Claude auf einem Computer, der die Simulatoren auf Ihrem Mac nicht erreichen kann.

33 33

34<h3 id="choose-which-xcode-the-simulator-pane-uses">

35 Wählen Sie, welches Xcode der Simulator-Bereich verwendet

36</h3>

38Wenn Sie mehr als ein Xcode installiert haben, z. B. Xcode 26.x neben Xcode 27, verwendet der Bereich dasjenige, auf das `xcode-select` verweist. Um eine andere Installation zu verwenden, wählen Sie sie nach ihrem Pfad aus.

40Wenn sich das gewünschte Xcode beispielsweise unter `/Applications/Xcode-26.4.app` befindet, führen Sie dies im Terminal aus:

42```bash theme={null}

43sudo xcode-select -s /Applications/Xcode-26.4.app

44```

46Beenden Sie dann Claude Desktop und öffnen Sie es erneut, damit der Bereich das neu ausgewählte Xcode verwendet.

48Um zu überprüfen, welche Installation ausgewählt ist, führen Sie `xcode-select -p` aus. Es gibt den Developer-Ordner der ausgewählten Installation aus, z. B. `/Applications/Xcode-26.4.app/Contents/Developer`.

34<h2 id="run-your-app-in-the-simulator">50<h2 id="run-your-app-in-the-simulator">

35 Führen Sie Ihre App im Simulator aus51 Führen Sie Ihre App im Simulator aus

36</h2>52</h2>

59 75

60Der Simulator-Bereich zeigt das Gerät, auf dem die App tatsächlich gestartet wurde. Um auf einem bestimmten Gerät zu testen, nennen Sie es in Ihrer Anfrage, zum Beispiel „führe es auf dem iPhone SE Simulator aus", und Claude zielt auf dieses Gerät ab, wenn es erstellt und startet.76Der Simulator-Bereich zeigt das Gerät, auf dem die App tatsächlich gestartet wurde. Um auf einem bestimmten Gerät zu testen, nennen Sie es in Ihrer Anfrage, zum Beispiel „führe es auf dem iPhone SE Simulator aus", und Claude zielt auf dieses Gerät ab, wenn es erstellt und startet.

61 77

~~62Ein Gerät, das Claude startet, erscheint auch in Apples Simulator-App, und Claude kann die App auf einem Gerät installieren, das Sie bereits gestartet haben.~~78Ein Gerät, das Claude startet, erscheint auch in Apples Simulator-App oder in Device Hub auf Xcode 27. Claude kann die App auf einem Gerät installieren, das Sie bereits gestartet haben.

63 79

64Sie können den Simulator-Bereich auch selbst öffnen. Sobald die Sitzung einen Simulator angehängt hat oder Swift-Dateien bearbeitet hat, zeigt das Menü **Views** in der Sitzungs-Symbolleiste einen Eintrag **iOS Simulator**. Wenn der Bereich noch kein Gerät anzeigt, klicken Sie auf **Attach simulator** oder wählen Sie ein bestimmtes Gerät aus dem Geräte-Menü daneben; wenn Sie ein ausgeschaltetes Gerät auswählen, wird es gestartet. Wenn Xcode oder seine Simulatoren fehlen, zeigt der Bereich stattdessen die Einrichtungsschritte an und markiert sie, wenn Sie sie abschließen.80Sie können den Simulator-Bereich auch selbst öffnen. Sobald die Sitzung einen Simulator angehängt hat oder Swift-Dateien bearbeitet hat, zeigt das Menü **Views** in der Sitzungs-Symbolleiste einen Eintrag **iOS Simulator**. Wenn der Bereich noch kein Gerät anzeigt, klicken Sie auf **Attach simulator** oder wählen Sie ein bestimmtes Gerät aus dem Geräte-Menü daneben; wenn Sie ein ausgeschaltetes Gerät auswählen, wird es gestartet. Wenn Xcode oder seine Simulatoren fehlen, zeigt der Bereich stattdessen die Einrichtungsschritte an und markiert sie, wenn Sie sie abschließen.

65 81

86 102

87Jedes Gerät gehört der Sitzung, die es gestartet hat, daher teilen sich [parallele Sitzungen](/docs/de/desktop#work-in-parallel-with-sessions) kein Gerät: Was Sie im Bereich einer Sitzung sehen, spiegelt die Arbeit dieser Sitzung wider, nicht die einer anderen. Das Wechseln von Sitzungen in der Seitenleiste wechselt die Simulator-Ansicht zusammen mit der Unterhaltung, und das Zurückwechseln setzt das gleiche Gerät fort, wo es aufgehört hat. Wenn Claude mit mehr als einem Gerät arbeitet, öffnet jedes seinen eigenen Bereich, bis zu 4 pro Sitzung.103Jedes Gerät gehört der Sitzung, die es gestartet hat, daher teilen sich [parallele Sitzungen](/docs/de/desktop#work-in-parallel-with-sessions) kein Gerät: Was Sie im Bereich einer Sitzung sehen, spiegelt die Arbeit dieser Sitzung wider, nicht die einer anderen. Das Wechseln von Sitzungen in der Seitenleiste wechselt die Simulator-Ansicht zusammen mit der Unterhaltung, und das Zurückwechseln setzt das gleiche Gerät fort, wo es aufgehört hat. Wenn Claude mit mehr als einem Gerät arbeitet, öffnet jedes seinen eigenen Bereich, bis zu 4 pro Sitzung.

88 104

89Claude Code Desktop fährt die Simulatoren herunter, die es gestartet hat, sobald sie nicht mehr verwendet werden: wenn Sie die App beenden, wenn Sie die Sitzung archivieren, oder 10 Minuten, nachdem Sie ein Gerät von seinem Bereich trennen. Geräte, die Sie selbst starten, ob vom Bereich oder in Apples Simulator-App, werden niemals automatisch heruntergefahren. Um das angehängte Gerät sofort herunterzufahren, verwenden Sie die Schaltfläche zum Herunterfahren im Bereich.105Claude Code Desktop fährt die Simulatoren herunter, die es gestartet hat, sobald sie nicht mehr verwendet werden: wenn Sie die App beenden, wenn Sie die Sitzung archivieren, oder 10 Minuten, nachdem Sie ein Gerät von seinem Bereich trennen. Geräte, die Sie außerhalb von Claude Code Desktop starten, etwa in Apples Simulator-App oder in Device Hub, werden niemals automatisch heruntergefahren. Um das angehängte Gerät sofort herunterzufahren, verwenden Sie die Schaltfläche zum Herunterfahren im Bereich.

90 106

91<h2 id="grant-claude-access-to-a-device">107<h2 id="grant-claude-access-to-a-device">

92 Claude Zugriff auf ein Gerät gewähren108 Claude Zugriff auf ein Gerät gewähren

141Claude hat möglicherweise nicht erkannt, dass Sie die App ausführen oder testen möchten, oder die Simulator-Tools fehlen möglicherweise. Überprüfen Sie folgende Punkte:157Claude hat möglicherweise nicht erkannt, dass Sie die App ausführen oder testen möchten, oder die Simulator-Tools fehlen möglicherweise. Überprüfen Sie folgende Punkte:

142 158

143* Geben Sie das Ziel explizit an, zum Beispiel „führe die App im iOS-Simulator aus und tippe durch den Signup-Flow".159* Geben Sie das Ziel explizit an, zum Beispiel „führe die App im iOS-Simulator aus und tippe durch den Signup-Flow".

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

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

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

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

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

151</h3>167</h3>

152 168

153Wenn `xcode-select` auf Xcode 27 verweist, kann der Bereich melden, dass keine Simulatoren gefunden wurden, obwohl Geräte vorhanden sind; siehe [Der Simulator-Bereich schlägt mit Xcode 27 fehl](#the-simulator-pane-fails-with-xcode-27). Andernfalls ist Xcode installiert, hat aber keine iOS-Simulatoren zum Auflisten. Der Simulator-Bereich zeigt die zu befolgenden Einrichtungsschritte an und markiert sie, wenn jeder abgeschlossen ist. Um das fehlende Teil manuell zu installieren, laden Sie die iOS-Simulator-Laufzeit aus den Einstellungen von Xcode herunter, oder führen Sie `xcodebuild -downloadPlatform iOS` aus.169Xcode ist installiert, hat aber keine iOS-Simulatoren zum Auflisten. Der Simulator-Bereich zeigt die zu befolgenden Einrichtungsschritte an und markiert sie, wenn jeder abgeschlossen ist. Um das fehlende Teil manuell zu installieren, laden Sie die iOS-Simulator-Laufzeit aus den Einstellungen von Xcode herunter, oder führen Sie `xcodebuild -downloadPlatform iOS` aus.

~~154~~

155<h3 id="the-simulator-pane-fails-with-xcode-27">

156 Der Simulator-Bereich schlägt mit Xcode 27 fehl

157</h3>

~~158~~

159Der Bereich funktioniert noch nicht mit Xcode 27, das die Simulator-App durch Device Hub ersetzt. Mit Xcode 27 ausgewählt schlägt das Angehängen eines Geräts fehl, oder der Bereich meldet, dass keine Simulatoren gefunden wurden, obwohl Geräte vorhanden sind.

~~160~~

161Der Bereich nutzt das Xcode, auf das `xcode-select` verweist. Wenn Xcode 27 Ihre einzige Installation ist, installieren Sie zuerst Xcode 26.x daneben. Wählen Sie dann die 26.x-Installation nach ihrem Pfad aus. Wenn es beispielsweise als `/Applications/Xcode-26.4.app` installiert ist:

~~162~~

163```bash theme={null}

164sudo xcode-select -s /Applications/Xcode-26.4.app

165```

~~166~~

167Führen Sie `xcode-select -p` aus, um zu überprüfen, welche Installation ausgewählt ist.

168 170

169<h2 id="see-also">171<h2 id="see-also">

170 Siehe auch172 Siehe auch

desktop-linux.md +1 −1

Details

158* Alle fehlenden Abhängigkeiten zeigen `not installable` mit einem `:amd64`- oder `:arm64`-Suffix: Sie haben die `.deb` für eine andere Architektur heruntergeladen als die Ihres Computers. Führen Sie `dpkg --print-architecture` aus und laden Sie die entsprechende `.deb` herunter, oder [installieren Sie aus dem apt-Repository](#install), das das Paket für Ihre Architektur auswählt.158* Alle fehlenden Abhängigkeiten zeigen `not installable` mit einem `:amd64`- oder `:arm64`-Suffix: Sie haben die `.deb` für eine andere Architektur heruntergeladen als die Ihres Computers. Führen Sie `dpkg --print-architecture` aus und laden Sie die entsprechende `.deb` herunter, oder [installieren Sie aus dem apt-Repository](#install), das das Paket für Ihre Architektur auswählt.

159 159

160<h3 id="running-as-root-without-no-sandbox-is-not-supported">160<h3 id="running-as-root-without-no-sandbox-is-not-supported">

161 Ausführung als root ohne --no-sandbox wird nicht unterstützt161 Ausführung als root ohne `--no-sandbox` wird nicht unterstützt

162</h3>162</h3>

163 163

164Wenn `claude-desktop` mit dieser Meldung beendet wird, haben Sie es als root gestartet. Melden Sie sich als normaler Benutzer an und starten Sie es von dort aus.164Wenn `claude-desktop` mit dieser Meldung beendet wird, haben Sie es als root gestartet. Melden Sie sich als normaler Benutzer an und starten Sie es von dort aus.

desktop-quickstart.md +8 −7

Details

4 4

5# Erste Schritte mit der Desktop-App5# Erste Schritte mit der Desktop-App

6 6

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

8 8

9Die Desktop-App bietet Ihnen Claude Code mit einer grafischen Benutzeroberfläche, die für die Ausführung mehrerer Sitzungen nebeneinander konzipiert ist: eine Seitenleiste zur Verwaltung paralleler Arbeit, ein Drag-and-Drop-Layout mit integriertem Terminal und Datei-Editor, visuelle Diff-Überprüfung, Live-App-Vorschau, GitHub-PR-Überwachung mit automatischem Merge und geplante Aufgaben. Kein Terminal erforderlich.9Die Desktop-App bietet Ihnen Claude Code mit einer grafischen Benutzeroberfläche, sodass Sie Claude bitten können, an dem Code in einem Ordner auf Ihrem Computer zu arbeiten und seine Änderungen zu überprüfen, ohne ein Terminal zu verwenden. Diese Seite führt Sie durch die Installation der App und den Start Ihrer ersten Sitzung in der Registerkarte **Code**. Claude Code erfordert ein [Pro-, Max-, Team- oder Enterprise-Abonnement](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).

10 10

11<CardGroup cols={3}>11<CardGroup cols={3}>

12 <Card title="Für macOS herunterladen" icon="apple" href="https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code&utm_medium=docs">12 <Card title="Für macOS herunterladen" icon="apple" href="https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code&utm_medium=docs">

25Für Windows ARM64 laden Sie das [ARM64-Installationsprogramm](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs) herunter. Unter Linux installieren Sie mit apt; siehe [Claude Desktop unter Linux](/docs/de/desktop-linux).25Für Windows ARM64 laden Sie das [ARM64-Installationsprogramm](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs) herunter. Unter Linux installieren Sie mit apt; siehe [Claude Desktop unter Linux](/docs/de/desktop-linux).

26 26

27<Note>27<Note>

~~28 Claude Code erfordert ein [Pro-, Max-, Team- oder Enterprise-Abonnement](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).~~28 Diese Fälle werden auf anderen Seiten behandelt:

~~29</Note>~~

30 29

31Diese Seite führt Sie durch die Installation der App und den Start Ihrer ersten Sitzung. Wenn Sie bereits eingerichtet sind, siehe [Claude Code Desktop verwenden](/docs/de/desktop) für die vollständige Referenz.30 * **Bereits eingerichtet**: siehe [Claude Code Desktop verwenden](/docs/de/desktop) für alles, was die Registerkarte Code kann

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

32</Note>

32 33

33Die Desktop-App hat drei Registerkarten:34Die Desktop-App hat drei Registerkarten:

34 35

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

36* **Cowork**: Ein autonomer Hintergrund-Agent, der an Aufgaben in einer Sandbox-VM mit eigener Umgebung arbeitet und unabhängig läuft, während Sie andere Dinge tun. On-Device-Cowork-Sitzungen führen die VM auf Ihrem Computer aus; Remote-Cowork-Sitzungen führen stattdessen auf einer von Anthropic verwalteten VM aus.37* **Cowork**: Ein autonomer Hintergrund-Agent, der an Aufgaben unabhängig arbeitet, während Sie andere Dinge tun.

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

38 39

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

52 </Step>53 </Step>

53</Steps>54</Steps>

54 55

55Die Desktop-App enthält Claude Code. Sie müssen Node.js oder die CLI nicht separat installieren. Um `claude` vom Terminal aus zu verwenden, installieren Sie die CLI separat. Siehe [Erste Schritte mit der CLI](/docs/de/quickstart).56Die Desktop-App enthält Claude Code, daher müssen Sie Node.js oder die CLI nicht installieren, um die Registerkarte „Code" zu verwenden.

56 57

57<h2 id="start-your-first-session">58<h2 id="start-your-first-session">

58 Starten Sie Ihre erste Sitzung59 Starten Sie Ihre erste Sitzung

desktop-scheduled-tasks.md +1 −1

Details

61 61

62* **Manuell**: kein Zeitplan, wird nur ausgeführt, wenn Sie auf **Jetzt ausführen** klicken. Nützlich zum Speichern einer Eingabeaufforderung, die Sie bei Bedarf auslösen62* **Manuell**: kein Zeitplan, wird nur ausgeführt, wenn Sie auf **Jetzt ausführen** klicken. Nützlich zum Speichern einer Eingabeaufforderung, die Sie bei Bedarf auslösen

63* **Stündlich**: wird jede Stunde ausgeführt63* **Stündlich**: wird jede Stunde ausgeführt

~~64* **Täglich**: zeigt eine Zeitauswahl an, Standard ist 9:00 Uhr Ortszeit~~64* **Täglich**: wird jeden Tag zur lokalen Zeit ausgeführt, die Sie auswählen

65* **Wochentage**: wie täglich, aber überspringt Samstag und Sonntag65* **Wochentage**: wie täglich, aber überspringt Samstag und Sonntag

66* **Wöchentlich**: zeigt eine Zeitauswahl und eine Tagesauswahl an66* **Wöchentlich**: zeigt eine Zeitauswahl und eine Tagesauswahl an

67 67

env-vars.md +238 −236

Details

124 Variablen124 Variablen

125</h2>125</h2>

126 126

127Numerische Variablen wie Timeouts, Token-Budgets und Wiederholungsanzahlen akzeptieren wissenschaftliche Notation und Ziffern-Trennzeichen-Schreibweisen zusätzlich zu einfachen Ziffern, außer wo die Zeile einer Variablen anmerkt, dass sie nur einfache Ziffern akzeptiert. Zum Beispiel liest Claude Code `2e3` als 2000 und `64_000` als 64000. Vor v2.1.211 konnten diese Schreibweisen stillschweigend einen viel kleineren Wert setzen, wie `1e6` das Timeout auf 1 setzen.127Numerische Variablen wie Timeouts, Token-Budgets und Wiederholungsanzahlen akzeptieren wissenschaftliche Notation und Zifferntrennzeichen zusätzlich zu einfachen Ziffern, außer wo in der Zeile einer Variablen vermerkt ist, dass sie nur einfache Ziffern akzeptiert. Zum Beispiel liest Claude Code `2e3` als 2000 und `64_000` als 64000. Vor v2.1.211 konnten diese Schreibweisen stillschweigend einen viel kleineren Wert setzen, wie `1e6` das Timeout auf 1 setzen.

128 128

129<Note>129<Note>

130 Für Variablen, die ein Verhalten ein- oder ausschalten, setzen Sie `1` oder `true`, um es einzuschalten, und `0` oder `false`, um es auszuschalten, in beliebiger Groß-/Kleinschreibung.130 Für Variablen, die ein Verhalten ein- oder ausschalten, setzen Sie `1` oder `true`, um es einzuschalten, und `0` oder `false`, um es auszuschalten, in beliebiger Schreibweise.

131 131

132 Einige Variablen lesen nur, ob Sie sie überhaupt gesetzt haben, daher schaltet jeder nicht-leere Wert einschließlich `0` das Verhalten ein, und Sie schalten das Verhalten aus, indem Sie die Variable nicht setzen oder auf einen leeren Wert setzen. Diese Variablen funktionieren auf diese Weise:132 Einige Variablen lesen nur, ob Sie sie überhaupt gesetzt haben, daher schaltet jeder nicht-leere Wert einschließlich `0` das Verhalten ein, und Sie schalten das Verhalten aus, indem Sie die Variable nicht setzen oder auf einen leeren Wert setzen. Diese Variablen funktionieren so:

133 133

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`

138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140

141 Eine andere Variable hat ihre eigene Regel: `FORCE_HYPERLINK` liest eine Zahl, daher schaltet nur `0` sie aus. Jede Variablenzeile gibt auch ihre eigene Regel an.141 Eine andere Variable hat ihre eigene Regel: `FORCE_HYPERLINK` liest eine Zahl, daher schaltet nur `0` sie aus. Jede Zeile einer Variablen gibt auch ihre eigene Regel an.

142</Note>142</Note>

143 143

144| Variable | Zweck |144| Variable | Zweck |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | API-Schlüssel, der als `X-Api-Key`-Header gesendet wird. Wenn gesetzt, wird dieser Schlüssel statt Ihres Claude Pro-, Max-, Team- oder Enterprise-Abonnements verwendet, auch wenn Sie angemeldet sind. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn vorhanden. Im interaktiven Modus werden Sie aufgefordert, den Schlüssel einmalig zu genehmigen, bevor er Ihr Abonnement überschreibt. Um stattdessen Ihr Abonnement zu verwenden, führen Sie `unset ANTHROPIC_API_KEY` aus |146| `ANTHROPIC_API_KEY` | API-Schlüssel, der als `X-Api-Key`-Header gesendet wird. Wenn gesetzt, wird dieser Schlüssel anstelle Ihres Claude Pro-, Max-, Team- oder Enterprise-Abonnements verwendet, auch wenn Sie angemeldet sind. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist. Im interaktiven Modus werden Sie aufgefordert, den Schlüssel einmalig zu genehmigen, bevor er Ihr Abonnement überschreibt. Um stattdessen Ihr Abonnement zu verwenden, führen Sie `unset ANTHROPIC_API_KEY` aus |

147| `ANTHROPIC_AUTH_TOKEN` | Benutzerdefinierter Wert für den `Authorization`-Header (der Wert, den Sie hier setzen, wird mit `Bearer ` vorangestellt) |147| `ANTHROPIC_AUTH_TOKEN` | Benutzerdefinierter Wert für den `Authorization`-Header (der Wert, den Sie hier setzen, wird mit `Bearer ` vorangestellt) |

148| `ANTHROPIC_AWS_API_KEY` | Workspace-API-Schlüssel für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), generiert in der AWS-Konsole. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | Workspace-API-Schlüssel für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), generiert in der AWS-Konsole. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Überschreiben Sie die [Claude Platform on AWS](/docs/de/claude-platform-on-aws) Endpunkt-URL. Verwenden Sie für benutzerdefinierte Regionen oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Standard ist `https://aws-external-anthropic.{region}.api.aws`. Claude Code löst die Region mit der [gleichen Priorität wie auf Amazon Bedrock](/docs/de/amazon-bedrock#3-configure-claude-code) auf |149| `ANTHROPIC_AWS_BASE_URL` | Überschreiben Sie die [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Regionen oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Standardmäßig `https://aws-external-anthropic.{region}.api.aws`. Claude Code löst die Region mit der [gleichen Priorität wie auf Amazon Bedrock](/docs/de/amazon-bedrock#3-configure-claude-code) auf |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |

151| `ANTHROPIC_BASE_URL` | Überschreiben Sie den API-Endpunkt, um Anfragen durch einen Proxy oder ein Gateway zu leiten. Wenn auf einen Host eines Drittanbieters gesetzt, ist [MCP-Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. Ab v2.1.196 ist [Remote Control](/docs/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` zeigt, was seinem Verhalten auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry entspricht |151| `ANTHROPIC_BASE_URL` | Überschreiben Sie den API-Endpunkt, um Anfragen durch einen Proxy oder ein Gateway zu leiten. Wenn auf einen Nicht-First-Party-Host gesetzt, ist [MCP-Toolsuche](/docs/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. Ab v2.1.196 ist [Remote Control](/docs/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` zeigt, was seinem Verhalten auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry entspricht |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreiben Sie die Amazon Bedrock Endpunkt-URL. Verwenden Sie für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Amazon Bedrock](/docs/de/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreiben Sie die Amazon Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Amazon Bedrock](/docs/de/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Amazon Bedrock Mantle Endpunkt-URL. Siehe [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Amazon Bedrock Mantle-Endpunkt-URL. Siehe [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Präfix für regionsübergreifendes Inferenzprofil (`us`, `eu`, `apac`, `jp`, `au` oder `global`), das Claude Code zuerst versucht, anstelle eines aus der AWS-Region abgeleiteten. Wird in AWS GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder später. Siehe [Amazon Bedrock](/docs/de/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Präfix für regionsübergreifendes Inferenzprofil (`us`, `eu`, `apac`, `jp`, `au` oder `global`), das Claude Code zuerst versucht, anstelle des aus der AWS-Region abgeleiteten. Wird in AWS GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder später. Siehe [Amazon Bedrock](/docs/de/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `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](/docs/de/amazon-bedrock#service-tiers) |155| `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](/docs/de/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Komma-getrennte Liste zusätzlicher `anthropic-beta`-Header-Werte, die in API-Anfragen eingebunden werden. Claude Code sendet bereits die Beta-Header, die es benötigt; verwenden Sie dies, um sich für ein [Anthropic API Beta](https://platform.claude.com/docs/en/api/beta-headers) anzumelden, bevor Claude Code native Unterstützung hinzufügt. Im Gegensatz zum [`--betas`-Flag](/docs/de/cli-reference#cli-flags), das API-Schlüssel-Authentifizierung erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden einschließlich Claude.ai-Abonnement |156| `ANTHROPIC_BETAS` | Komma-getrennte Liste zusätzlicher `anthropic-beta`-Header-Werte, die in API-Anfragen einzubeziehen sind. Claude Code sendet bereits die Beta-Header, die es benötigt; verwenden Sie dies, um sich für ein [Anthropic API Beta](https://platform.claude.com/docs/en/api/beta-headers) anzumelden, bevor Claude Code native Unterstützung hinzufügt. Im Gegensatz zum [`--betas`-Flag](/docs/de/cli-reference#cli-flags), das API-Schlüssel-Authentifizierung erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden einschließlich Claude.ai-Abonnement |

157| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die zu Anfragen hinzugefügt werden (Format `Name: Value`, zeilengetrennt für mehrere Header). Wenn ein Name oder Wert ein Zeichen enthält, das ein HTTP-Header nicht tragen kann, wie ein gekrümmtes Anführungszeichen oder ein Leerzeichen mit Nullbreite, schlägt die Anfrage mit einem Fehler fehl, der das Paar nach Position identifiziert. Erfordert Claude Code v2.1.227 oder später. [Ungültiger Request-Header-Wert](/docs/de/errors#invalid-request-header-value) listet den genauen Zeichensatz auf und wo die Prüfung läuft. Ein Wert, der einen Credential-, Org- oder Tenant-, Routing- oder API-Verhaltens-Header setzt, wie `Authorization` oder `Host`, zählt als [Einstellung, die Genehmigung benötigt](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog), wenn Server-verwaltete Einstellungen sie liefern. Aus Projekt- oder lokalen Einstellungen folgt ein solcher Wert den [Regeln für wann `env`-Werte gelten](/docs/de/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die zu Anfragen hinzugefügt werden (Format `Name: Value`, zeilengetrennt für mehrere Header). Wenn ein Name oder Wert ein Zeichen enthält, das ein HTTP-Header nicht tragen kann, wie ein gekrümmtes Anführungszeichen oder ein Leerzeichen mit Nullbreite, schlägt die Anfrage mit einem Fehler fehl, der das Paar nach Position identifiziert. Erfordert Claude Code v2.1.227 oder später. [Ungültiger Request-Header-Wert](/docs/de/errors#invalid-request-header-value) listet den genauen Zeichensatz auf und wo die Prüfung läuft. Ein Wert, der einen Credential-, Org- oder Tenant-, Routing- oder API-Verhaltens-Header setzt, wie `Authorization` oder `Host`, zählt als [Einstellung, die Genehmigung benötigt](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog), wenn Server-verwaltete Einstellungen sie liefern. Aus Projekt- oder lokalen Einstellungen folgt ein solcher Wert den [Regeln für wann `env`-Werte gelten](/docs/de/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | Modell-ID, die als benutzerdefinierter Eintrag in der `/model`-Auswahl hinzugefügt werden soll. Verwenden Sie dies, um ein nicht-standardisiertes oder Gateway-spezifisches Modell auswählbar zu machen, ohne integrierte Aliase zu ersetzen. Siehe [Modellkonfiguration](/docs/de/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | Modell-ID, die als benutzerdefinierter Eintrag in der `/model`-Auswahl hinzugefügt werden soll. Verwenden Sie dies, um ein nicht-standardisiertes oder Gateway-spezifisches Modell auswählbar zu machen, ohne integrierte Aliase zu ersetzen. Siehe [Modellkonfiguration](/docs/de/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Anzeigebeschreibung für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Standard ist `Custom model (<model-id>)`, wenn nicht gesetzt |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Anzeigebeschreibung für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Standardmäßig `Custom model (<model-id>)`, wenn nicht gesetzt |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Anzeigename für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt der Eintrag den Namen des Modells an, wenn Claude Code die ID [erkennt](/docs/de/model-config#customize-pinned-model-display-and-capabilities), und die Modell-ID andernfalls |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Anzeigename für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt der Eintrag den Namen des Modells an, wenn Claude Code die [ID erkennt](/docs/de/model-config#customize-pinned-model-display-and-capabilities), und die Modell-ID andernfalls |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Komma-getrennte Liste von [Fähigkeiten](/docs/de/model-config#customize-pinned-model-display-and-capabilities), die das benutzerdefinierte Modell unterstützt, zum Beispiel `effort,thinking`. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Komma-getrennte Liste von [Fähigkeiten](/docs/de/model-config#customize-pinned-model-display-and-capabilities), die das benutzerdefinierte Modell unterstützt, zum Beispiel `effort,thinking`. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Modell-ID, zu der der `fable`-Alias aufgelöst wird, und die ID, die Claude Code als Fable-Modell für [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) bei Drittanbieter-Providern erkennt. Siehe [Modellkonfiguration](/docs/de/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Modell-ID, zu der der `fable`-Alias aufgelöst wird, und die ID, die Claude Code als Fable-Modell für [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) bei Drittanbieter-Providern erkennt. Siehe [Modellkonfiguration](/docs/de/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Anzeigebeschreibung für das angeheftete Fable-Modell in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit `Custom Fable model` beginnt. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Anzeigebeschreibung für das angeheftete Fable-Modell in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit `Custom Fable model` beginnt. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Anzeigebeschreibung für das angeheftete Sonnet-Modell in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit `Custom Sonnet model` beginnt. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Anzeigebeschreibung für das angeheftete Sonnet-Modell in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit `Custom Sonnet model` beginnt. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Anzeigename für das angeheftete Sonnet-Modell in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells an, wenn Claude Code die angeheftete ID erkennt, und die angeheftete ID andernfalls. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Anzeigename für das angeheftete Sonnet-Modell in der `/model`-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells an, wenn Claude Code die angeheftete ID erkennt, und die angeheftete ID andernfalls. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Komma-getrennte Liste von [Fähigkeiten](/docs/de/model-config#customize-pinned-model-display-and-capabilities), die das angeheftete Sonnet-Modell unterstützt, zum Beispiel `effort,thinking`. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Komma-getrennte Liste von [Fähigkeiten](/docs/de/model-config#customize-pinned-model-display-and-capabilities), die das angeheftete Sonnet-Modell unterstützt, zum Beispiel `effort,thinking`. Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | Föderations-Regel-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Wenn Sie es zusammen mit `ANTHROPIC_ORGANIZATION_ID` setzen, wählt Claude Code Föderations-Anmeldedaten aus, die über Ihre `/login`-Anmeldedaten rangieren. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | Föderations-Regel-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Wenn Sie sie zusammen mit `ANTHROPIC_ORGANIZATION_ID` setzen, wählt Claude Code Föderations-Credentials, die über Ihrem `/login`-Credential rangieren. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | API-Schlüssel für Microsoft Foundry-Authentifizierung (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | API-Schlüssel für Microsoft Foundry-Authentifizierung (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer-Token für Microsoft Foundry-Authentifizierung, wie ein Microsoft Entra-Zugriffstoken. Claude Code sendet es als `Authorization: Bearer`-Header. Hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY` und vor der Azure-Standard-Anmeldedaten-Kette. Siehe [Microsoft Foundry](/docs/de/microsoft-foundry). Erfordert Claude Code v2.1.203 oder später |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer-Token für Microsoft Foundry-Authentifizierung, wie ein Microsoft Entra-Zugriffstoken. Claude Code sendet es als `Authorization: Bearer`-Header. Hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY` und vor der Azure-Standard-Credential-Kette. Siehe [Microsoft Foundry](/docs/de/microsoft-foundry). Erfordert Claude Code v2.1.203 oder später |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Vollständige Basis-URL für die Microsoft Foundry-Ressource (zum Beispiel `https://my-resource.services.ai.azure.com/anthropic`). Alternative zu `ANTHROPIC_FOUNDRY_RESOURCE` (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Vollständige Basis-URL für die Microsoft Foundry-Ressource (zum Beispiel `https://my-resource.services.ai.azure.com/anthropic`). Alternative zu `ANTHROPIC_FOUNDRY_RESOURCE` (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry-Ressourcenname (zum Beispiel `my-resource`). Erforderlich, wenn `ANTHROPIC_FOUNDRY_BASE_URL` nicht gesetzt ist (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry-Ressourcenname (zum Beispiel `my-resource`). Erforderlich, wenn `ANTHROPIC_FOUNDRY_BASE_URL` nicht gesetzt ist (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Name der zu verwendenden Modelleinstellung (siehe [Modellkonfiguration](/docs/de/model-config#environment-variables)) |184| `ANTHROPIC_MODEL` | Name der zu verwendenden Modelleinstellung (siehe [Modellkonfiguration](/docs/de/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | Organisations-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie es zusammen mit `ANTHROPIC_FEDERATION_RULE_ID`. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | Organisations-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie sie zusammen mit `ANTHROPIC_FEDERATION_RULE_ID`. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Name des Anthropic-Profils, mit dem authentifiziert werden soll, wie eines, das von [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) erstellt wurde, oder durch [Anmeldung bei einem Console-Konto ohne API-Schlüssel](/docs/de/authentication#sign-in-without-an-api-key). Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | Name des Anthropic-Profils, mit dem authentifiziert werden soll, wie eines, das von [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) erstellt wurde, oder durch [Anmeldung bei einem Console-Konto ohne API-Schlüssel](/docs/de/authentication#sign-in-without-an-api-key). Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Überschreiben Sie die AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle. Bei Amazon Bedrock hat dies nur Auswirkungen, wenn `ANTHROPIC_DEFAULT_HAIKU_MODEL` oder das veraltete `ANTHROPIC_SMALL_FAST_MODEL` auch gesetzt ist, da Amazon Bedrock andernfalls Hintergrundaufgaben auf dem [Standard-Sonnet-Modell oder dem primären Modell](/docs/de/amazon-bedrock#4-pin-model-versions) in der Sitzungsregion ausführt |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Überschreiben Sie die AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle. Bei Amazon Bedrock tritt dies nur in Kraft, wenn `ANTHROPIC_DEFAULT_HAIKU_MODEL` oder das veraltete `ANTHROPIC_SMALL_FAST_MODEL` auch gesetzt ist, da Amazon Bedrock andernfalls Hintergrundaufgaben auf dem [Standard-Sonnet-Modell oder dem primären Modell](/docs/de/amazon-bedrock#4-pin-model-versions) in der Sitzungsregion ausführt |

189| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Google Cloud's Agent Platform Endpunkt-URL. Verwenden Sie für benutzerdefinierte Google Cloud's Agent Platform-Endpunkte oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Google Cloud's Agent Platform-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Google Cloud's Agent Platform-Endpunkte oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID, an die Google Cloud's Agent Platform-Anfragen adressiert werden. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID, an die Google Cloud's Agent Platform-Anfragen adressiert werden. Siehe [GCP-Credentials konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | Workspace-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie dies, wenn Ihre Föderations-Regel auf mehr als einen Workspace begrenzt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |191| `ANTHROPIC_WORKSPACE_ID` | Workspace-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie dies, wenn Ihre Föderations-Regel auf mehr als einen Workspace begrenzt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |

192| `API_FORCE_IDLE_TIMEOUT` | Überschreiben Sie das 5-Minuten-Body-Idle-Timeout, das eine Streaming-Modell-Antwort abbricht, wenn keine Bytes ankommen. Setzen Sie auf `0`, um das Timeout auszuschalten, zum Beispiel wenn ein langsames [Gateway](/docs/de/llm-gateway) oder lokales Modell länger als 5 Minuten zwischen Chunks pausiert, oder `1`, um es für jeden Provider einzuschalten. Wenn nicht gesetzt, ist das Timeout bei Providern außer der direkten Anthropic API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws) aktiv. Die [Stream-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) laufen unabhängig davon und brechen eine lange stille Pause ab, auch wenn Sie hier `0` setzen |192| `API_FORCE_IDLE_TIMEOUT` | Überschreiben Sie das 5-Minuten-Body-Idle-Timeout, das eine Streaming-Modell-Antwort abbricht, wenn keine Bytes ankommen. Setzen Sie auf `0`, um das Timeout auszuschalten, zum Beispiel wenn ein langsames [Gateway](/docs/de/llm-gateway) oder lokales Modell länger als 5 Minuten zwischen Chunks pausiert, oder `1`, um es für jeden Provider einzuschalten. Wenn nicht gesetzt, ist das Timeout bei Providern außer der direkten Anthropic API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws) aktiv. Die [Stream-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) laufen unabhängig davon und brechen eine lange stille Pause ab, auch wenn Sie hier `0` setzen |

193| `API_TIMEOUT_MS` | Timeout für API-Anfragen in Millisekunden (Standard: 600000 oder 10 Minuten; Maximum: 2147483647). Erhöhen Sie dies, wenn Anfragen bei langsamen Netzwerken oder beim Routing durch einen Proxy timeout. Werte über dem Maximum führen zu Überläufen des zugrunde liegenden Timers und verursachen, dass Anfragen sofort fehlschlagen |193| `API_TIMEOUT_MS` | Timeout für API-Anfragen in Millisekunden (Standard: 600000 oder 10 Minuten; Maximum: 2147483647). Erhöhen Sie dies, wenn Anfragen bei langsamen Netzwerken oder beim Routing durch einen Proxy timeout. Werte über dem Maximum führen zu Überläufen des zugrunde liegenden Timers und verursachen, dass Anfragen sofort fehlschlagen |

196| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen der Bash-Ausgabe, die Claude Code in das Ergebnis eines Befehls zurückliest (Standard: 30000; Maximum: 150000). Wenn Sie die [`bashOutputMaxChars`](/docs/de/settings-reference#bashoutputmaxchars)-Einstellung setzen, ignoriert Claude Code diese Variable. Siehe [Ausgabebegrenzungen](/docs/de/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen der Bash-Ausgabe, die Claude Code in das Ergebnis eines Befehls zurückliest (Standard: 30000; Maximum: 150000). Wenn Sie die [`bashOutputMaxChars`](/docs/de/settings-reference#bashoutputmaxchars)-Einstellung setzen, ignoriert Claude Code diese Variable. Siehe [Ausgabebegrenzungen](/docs/de/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Maximales Timeout, das das Modell für lang laufende Bash-Befehle setzen kann (Standard: 600000 oder 10 Minuten). Die effektive Obergrenze ist die größere von dieser und `BASH_DEFAULT_TIMEOUT_MS` |197| `BASH_MAX_TIMEOUT_MS` | Maximales Timeout, das das Modell für lang laufende Bash-Befehle setzen kann (Standard: 600000 oder 10 Minuten). Die effektive Obergrenze ist die größere von dieser und `BASH_DEFAULT_TIMEOUT_MS` |

198| `BETA_TRACING_ENDPOINT` | OTLP-Endpunkt für [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta): mit `ENABLE_BETA_TRACING_DETAILED=1` gehen Logs und Traces dorthin statt zu den konfigurierten Exportern. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |198| `BETA_TRACING_ENDPOINT` | OTLP-Endpunkt für [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta): mit `ENABLE_BETA_TRACING_DETAILED=1` gehen Logs und Traces dorthin anstatt zu den konfigurierten Exportern. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

199| `CCR_FORCE_BUNDLE` | Setzen Sie auf `1`, um [`claude --cloud`](/docs/de/claude-code-on-the-web#send-local-repositories-without-github) zu zwingen, Ihr lokales Repository zu bündeln und hochzuladen, anstatt es von seinem Remote zu klonen |199| `CCR_FORCE_BUNDLE` | Setzen Sie auf `1`, um [`claude --cloud`](/docs/de/claude-code-on-the-web#send-local-repositories-without-github) zu zwingen, Ihr lokales Repository zu bündeln und hochzuladen, anstatt es von seinem Remote zu klonen |

200| `CLAUDECODE` | Setzen Sie auf `1` in Subprozessen, die Claude Code spawnt (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/docs/de/hooks)-Befehle, [Status-Zeile](/docs/de/statusline)-Befehle, stdio [MCP-Server](/docs/de/mcp)-Subprozesse). IDE-Erweiterungen setzen dies auch in ihren integrierten Terminals. Verwenden Sie, um zu erkennen, wenn ein Skript in einem Subprocess läuft, der von Claude Code spawnt wurde. Um zu überprüfen, ob der aktuelle Prozess direkt von einem Tool-Aufruf oder Hook spawnt wurde, anstatt in einem stdio MCP-Server, den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |200| `CLAUDECODE` | Setzen Sie auf `1` in Subprozessen, die Claude Code spawnt (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/docs/de/hooks)-Befehle, [Status-Zeile](/docs/de/statusline)-Befehle, stdio [MCP-Server](/docs/de/mcp)-Subprozesse). IDE-Erweiterungen setzen dies auch in ihren integrierten Terminals. Verwenden Sie dies, um zu erkennen, wenn ein Skript in einem Subprocess läuft, der von Claude Code spawnt wurde. Um zu überprüfen, ob der aktuelle Prozess direkt von einem Tool-Aufruf oder Hook spawnt wurde, anstatt in einem stdio MCP-Server, den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Wie viele Millisekunden vor Auto-Continue der Countdown auf dem Bildschirm auf einem unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog erscheint. Standard `20000` (20 Sekunden), begrenzt durch das Auto-Continue-Timeout. Hat keine Auswirkung, wenn Auto-Continue nicht eingeschaltet ist; siehe die [`askUserQuestionTimeout`](/docs/de/settings-reference#askuserquestiontimeout)-Einstellung und `CLAUDE_AFK_TIMEOUT_MS`. Erfordert Claude Code v2.1.198 oder später |201| `CLAUDE_AFK_COUNTDOWN_MS` | Wie viele Millisekunden vor Auto-Continue der Countdown auf dem Bildschirm auf einem unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog erscheint. Standard `20000` (20 Sekunden), begrenzt durch das Auto-Continue-Timeout. Hat keine Auswirkung, wenn Auto-Continue nicht eingeschaltet ist; siehe die [`askUserQuestionTimeout`](/docs/de/settings-reference#askuserquestiontimeout)-Einstellung und `CLAUDE_AFK_TIMEOUT_MS`. Erfordert Claude Code v2.1.198 oder später |

202| `CLAUDE_AFK_TIMEOUT_MS` | Wie viele Millisekunden Leerlaufzeit vor einem unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog Auto-Continue ohne Sie. Auto-Continue ist standardmäßig aus; aktivieren Sie es mit der [`askUserQuestionTimeout`](/docs/de/settings-reference#askuserquestiontimeout)-Einstellung. Diese Variable ist ein Override für Demos und automatisierte Tests: wenn gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet Auto-Continue ein, auch wenn die Einstellung nicht gesetzt oder `never` ist. Das Setzen von `0` schaltet das Timeout nicht aus; es schließt den Dialog sofort. In v2.1.198 und v2.1.199 war Auto-Continue standardmäßig mit einem `60000` (60 Sekunden) Timeout eingeschaltet. Erfordert Claude Code v2.1.198 oder später |202| `CLAUDE_AFK_TIMEOUT_MS` | Wie viele Millisekunden Leerlaufzeit, bevor ein unbeantworteter [`AskUserQuestion`](/docs/de/tools-reference)-Dialog ohne Sie auto-continues. Auto-Continue ist standardmäßig aus; aktivieren Sie es mit der [`askUserQuestionTimeout`](/docs/de/settings-reference#askuserquestiontimeout)-Einstellung. Diese Variable ist ein Override für Demos und automatisierte Tests: wenn gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet Auto-Continue ein, auch wenn die Einstellung nicht gesetzt oder `never` ist. Das Setzen von `0` schaltet das Timeout nicht aus; es schließt den Dialog sofort. In v2.1.198 und v2.1.199 war Auto-Continue standardmäßig mit einem `60000` (60 Sekunden)-Timeout eingeschaltet. Erfordert Claude Code v2.1.198 oder später |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie auf `1`, um alle integrierten [Subagent](/docs/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht-interaktiven Modus (das `-p`-Flag). Nützlich für SDK-Benutzer, die eine leere Tafel wünschen. Dies entfernt auch `general-purpose`, den Subagent, den Claude Code ausführt, wenn ein Agent-Tool-Aufruf `subagent_type` auslässt. Ein solcher Aufruf schlägt dann mit [`subagent_type is required`](/docs/de/errors#subagent-type-is-required) fehl |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie auf `1`, um alle integrierten [Subagent](/docs/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht-interaktiven Modus (das `-p`-Flag). Nützlich für SDK-Benutzer, die eine leere Tafel wünschen. Dies entfernt auch `general-purpose`, den Subagent, den Claude Code ausführt, wenn ein Agent-Tool-Aufruf `subagent_type` auslässt. Ein solcher Aufruf schlägt dann mit [`subagent_type is required`](/docs/de/errors#subagent-type-is-required) fehl |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie auf `1`, um das `mcp__<server>__`-Präfix bei Tool-Namen von SDK-erstellten MCP-Servern zu überspringen. Tools verwenden ihre ursprünglichen Namen. Nur SDK-Verwendung |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie auf `1`, um das `mcp__<server>__`-Präfix bei Tool-Namen von SDK-erstellten MCP-Servern zu überspringen. Tools verwenden ihre ursprünglichen Namen. Nur SDK-Verwendung |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Subagents. Standard `600000` (10 Minuten); wenn Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standard mit ihm, wie [Langsame oder steckengebliebene API-Antworten handhaben](/docs/de/agent-sdk/typescript#handle-slow-or-stalled-api-responses) beschreibt. Der Timer setzt sich bei jedem Streaming-Fortschrittsereignis zurück; wenn kein Fortschritt innerhalb des Fensters ankommt, bricht Claude Code den Subagent ab und meldet den Stall dem übergeordneten |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Subagents. Standard `600000` (10 Minuten); wenn Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standard mit ihm, wie [Langsame oder steckengebliebene API-Antworten handhaben](/docs/de/agent-sdk/typescript#handle-slow-or-stalled-api-responses) beschreibt. Der Timer setzt sich bei jedem Streaming-Fortschrittsereignis zurück; wenn kein Fortschritt innerhalb des Fensters ankommt, bricht Claude Code den Subagent ab und meldet den Stall dem übergeordneten |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Setzen Sie den Prozentsatz (1-100) des Auto-Compact-Fensters, bei dem Auto-Compaction ausgelöst wird. Verwenden Sie niedrigere Werte wie `50`, um früher zu komprimieren; die Variable kann die Schwelle nicht erhöhen, daher werden Werte über dem Standard-Prozentsatz ignoriert. Sie gilt nur in Sitzungen, die [vor dem Kontext-Limit des Modells komprimieren](/docs/de/model-config#context-window-and-auto-compaction). Gilt für Hauptkonversationen und Subagents |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Setzen Sie den Prozentsatz (1-100) des Auto-Compact-Fensters, bei dem Auto-Compaction ausgelöst wird. Verwenden Sie niedrigere Werte wie `50`, um früher zu komprimieren; die Variable kann die Schwelle nicht erhöhen, daher werden Werte über dem Standard-Prozentsatz ignoriert. Sie gilt nur in Sitzungen, die [vor dem Kontext-Limit des Modells komprimieren](/docs/de/model-config#context-window-and-auto-compaction). Gilt für Hauptkonversationen und Subagents |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Setzen Sie auf `1`, um die automatische Hintergrund-Verschiebung von lang laufenden Agent-Aufgaben zu erzwingen. Wenn aktiviert, werden Subagents nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben. Aktiviert auch [automatische Hintergrund-Verschiebung von langen MCP-Tool-Aufrufen](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) im nicht-interaktiven Modus auf Claude Code v2.1.212 oder später |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Setzen Sie auf `1`, um automatisches Backgrounding von lang laufenden Agent-Aufgaben zu erzwingen. Wenn aktiviert, werden Subagents nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben. Aktiviert auch [automatisches Backgrounding von langen MCP-Tool-Aufrufen](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) im nicht-interaktiven Modus auf Claude Code v2.1.212 oder später |

208| `CLAUDE_AX_PREPARK_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility#what-your-screen-reader-hears) wartet Claude Code mit dem Cursor am Anfang der Zeile, bevor es eine neue oder geänderte Zeile schreibt, für diese viele Millisekunden. Standard `50`. Setzen Sie `0`, um sofort zu schreiben. Claude Code begrenzt das Warten auf `5000`. Erfordert Claude Code v2.1.233 oder später |208| `CLAUDE_AX_PREPARK_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility#what-your-screen-reader-hears) wie viele Millisekunden Claude Code wartet, mit dem Cursor am Anfang der Zeile, bevor es eine neue oder geänderte Zeile schreibt. Standard `50`. Setzen Sie `0`, um sofort zu schreiben. Claude Code begrenzt das Warten auf `5000`. Erfordert Claude Code v2.1.233 oder später |

209| `CLAUDE_AX_SCREEN_READER` | Setzen Sie auf `1`, um Screen-Reader-freundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie auf `0`, um den Screen-Reader-Modus zu erzwingen, auch wenn [`axScreenReader`](/docs/de/settings-reference#axscreenreader) `true` ist. Das [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags)-Flag hat Vorrang. Erfordert Claude Code v2.1.181 oder später |209| `CLAUDE_AX_SCREEN_READER` | Setzen Sie auf `1`, um Screen-Reader-freundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie auf `0`, um Screen-Reader-Modus zu erzwingen, auch wenn [`axScreenReader`](/docs/de/settings-reference#axscreenreader) `true` ist. Das [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags)-Flag hat Vorrang. Erfordert Claude Code v2.1.181 oder später |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility) hält Claude Code das erste Interface-Rendering nach der Startup-Bestätigungszeile für diese viele Millisekunden, damit Ihr Screen Reader die Zeile vollständig sprechen kann, bevor neue Ausgabe sie unterbricht. Standard `3000`. Setzen Sie `0`, um sofort zu rendern. Claude Code begrenzt das Halten auf `600000` (10 Minuten). Ihr erster Tastendruck beendet das Halten früh. Erfordert Claude Code v2.1.217 oder später |210| `CLAUDE_AX_STARTUP_QUIET_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility) wie viele Millisekunden Claude Code das erste Interface-Rendering nach der Startup-Bestätigungszeile hält, damit Ihr Screen Reader die Zeile vollständig sprechen kann, bevor neue Ausgabe sie unterbricht. Standard `3000`. Setzen Sie `0`, um sofort zu rendern. Claude Code begrenzt das Halten auf `600000` (10 Minuten). Ihr erster Tastendruck beendet das Halten früh. Erfordert Claude Code v2.1.217 oder später |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Kehren Sie nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Kehren Sie nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden für den Byte-Level-Streaming-Idle-Watchdog; wenn gesetzt, hat es Vorrang vor `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für diesen Watchdog und lässt den Event-Level-Watchdog unverändert. Claude Code begrenzt diese Variable auf zwischen 10 Sekunden und 30 Minuten. Erfordert Claude Code v2.1.210 oder später |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden für den Byte-Level-Streaming-Idle-Watchdog; wenn gesetzt, hat er Vorrang vor `CLAUDE_STREAM_IDLE_TIMEOUT_MS` für diesen Watchdog und lässt den Event-Level-Watchdog unverändert. Claude Code begrenzt diese Variable auf zwischen 10 Sekunden und 30 Minuten. Erfordert Claude Code v2.1.210 oder später |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Pfad zu einer Datei, die ein externes Tool, wie ein Screen-Lock-Listener, erstellt, wenn Sie Ihren Bildschirm entsperren, und löscht, wenn Sie ihn sperren. Während die Datei existiert, überspringt Claude Code [Remote Control Mobile Push-Benachrichtigungen](/docs/de/remote-control#mobile-push-notifications), daher erhalten Sie keine Pushes, während Sie den Computer aktiv nutzen. Wenn die Datei abwesend oder unlesbar ist, werden Benachrichtigungen normal gesendet. Claude Code prüft die Datei einmal pro Push-auslösendes Ereignis, anstatt sie abzufragen. Erfordert Claude Code v2.1.181 oder später |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Pfad zu einer Datei, die ein externes Tool, wie ein Screen-Lock-Listener, erstellt, wenn Sie Ihren Bildschirm entsperren, und löscht, wenn Sie ihn sperren. Während die Datei existiert, überspringt Claude Code [Remote Control Mobile Push-Benachrichtigungen](/docs/de/remote-control#mobile-push-notifications), daher erhalten Sie keine Pushes mehr, während Sie den Computer aktiv nutzen. Wenn die Datei abwesend oder unlesbar ist, werden Benachrichtigungen normal gesendet. Claude Code prüft die Datei einmal pro Push-auslösendem Ereignis, anstatt sie abzufragen. Erfordert Claude Code v2.1.181 oder später |

214| `CLAUDE_CODE_ACCESSIBILITY` | Setzen Sie auf `1`, um den nativen Terminal-Cursor sichtbar zu halten und den invertierten Text-Cursor-Indikator zu deaktivieren. Ermöglicht Screen-Magnifier wie macOS Zoom, die Cursor-Position zu verfolgen |214| `CLAUDE_CODE_ACCESSIBILITY` | Setzen Sie auf `1`, um den nativen Terminal-Cursor sichtbar zu halten und den invertierten Text-Cursor-Indikator zu deaktivieren. Ermöglicht Screen-Magnifiern wie macOS Zoom, die Cursor-Position zu verfolgen |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Setzen Sie auf `1`, um Memory-Dateien aus Verzeichnissen zu laden, die mit `--add-dir` angegeben sind. Lädt `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` und `CLAUDE.local.md`. Standardmäßig laden zusätzliche Verzeichnisse keine Memory-Dateien |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Setzen Sie auf `1`, um Memory-Dateien aus Verzeichnissen zu laden, die mit `--add-dir` angegeben sind. Lädt `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` und `CLAUDE.local.md`. Standardmäßig laden zusätzliche Verzeichnisse keine Memory-Dateien |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Setzen Sie auf `1`, um den gesamten Bildschirm bei jedem Frame im [Vollbild-Rendering](/docs/de/fullscreen) neu zu zeichnen, anstatt inkrementelle Updates zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Text-Fragmente zeigt. Claude Code aktiviert dies automatisch für Hintergrund-Sitzungen und [Agent-Ansicht](/docs/de/agent-view) unter Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Setzen Sie auf `1`, um den gesamten Bildschirm bei jedem Frame im [Vollbild-Rendering](/docs/de/fullscreen) neu zu zeichnen, anstatt inkrementelle Updates zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Text-Fragmente zeigt. Claude Code aktiviert dies automatisch für Hintergrund-Sitzungen und [Agent-Ansicht](/docs/de/agent-view) unter Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Setzen Sie auf `1`, um den [Effort](/docs/de/model-config#adjust-effort-level)-Parameter mit jeder Anfrage zu senden, auch wenn Claude Code die Modell-ID nicht als Effort-fähig erkennt. Verwenden Sie dies beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway) oder Drittanbieter-Provider, der Modelle unter benutzerdefinierten Identifiern bereitstellt. Modelle, die den Effort-Parameter bei der API ablehnen, einschließlich Claude 3-Modelle, Sonnet 4.0 und 4.5, Opus 4.0 und 4.1 und Haiku 4.5, sind immer noch ausgeschlossen, damit Anfragen nicht fehlschlagen |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Setzen Sie auf `1`, um den [Effort](/docs/de/model-config#adjust-effort-level)-Parameter bei jeder Anfrage zu senden, auch wenn Claude Code die Modell-ID nicht als Effort-fähig erkennt. Verwenden Sie dies beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway) oder Drittanbieter-Provider, der Modelle unter benutzerdefinierten Identifiern bereitstellt. Modelle, die den Effort-Parameter bei der API ablehnen, einschließlich Claude 3-Modelle, Sonnet 4.0 und 4.5, Opus 4.0 und 4.1 und Haiku 4.5, sind immer noch ausgeschlossen, damit Anfragen nicht fehlschlagen |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollten (bei Verwendung von [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervall in Millisekunden, in dem Credentials aktualisiert werden sollten (bei Verwendung von [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Setzen Sie auf `0`, um Claude Code daran zu hindern, den Browser automatisch zu öffnen, wenn ein neues [Artifact](/docs/de/artifacts#create-an-artifact) veröffentlicht wird |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Setzen Sie auf `0`, um Claude Code davon abzuhalten, den Browser automatisch zu öffnen, wenn ein neues [Artifact](/docs/de/artifacts#create-an-artifact) veröffentlicht wird |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Setzen Sie auf `0`, um Claude daran zu hindern, [Kommentare auf einem Artifact](/docs/de/artifacts#collect-comments-on-an-artifact) zu lesen und zu beantworten. Hat keine Auswirkung, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [Artifacts ausgeschaltet hat](/docs/de/artifacts#availability). Erfordert Claude Code v2.1.221 oder später |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Setzen Sie auf `0`, um Claude davon abzuhalten, [Kommentare auf einem Artifact](/docs/de/artifacts#collect-comments-on-an-artifact) zu lesen und zu beantworten. Hat keine Auswirkung, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [Artifacts ausgeschaltet hat](/docs/de/artifacts#availability). Erfordert Claude Code v2.1.221 oder später |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Setzen Sie auf `0`, um Claude daran zu hindern, [auf Kommentare auf eigene Faust zu antworten](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own). Erfordert Claude Code v2.1.228 oder später |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Setzen Sie auf `0`, um Claude davon abzuhalten, [auf Kommentare, die an es gesendet werden, selbst zu antworten](/docs/de/artifacts#let-claude-reply-to-comments-on-its-own). Erfordert Claude Code v2.1.228 oder später |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Setzen Sie auf `0`, um den [Attributions-Block](/docs/de/llm-gateway-protocol#system-prompt-attribution-block), der die Client-Version und einen Prompt-Fingerabdruck trägt, vom Anfang des System-Prompts auszulassen. Caching bei einer direkten Verbindung zur Anthropic API ist in jedem Fall unbeeinträchtigt. In einigen direkten Verbindungs-Setups behält Claude Code den Block bei [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer-Anfragen, auch wenn Sie `0` setzen. In [System-Prompt-Attributions-Block](/docs/de/llm-gateway-protocol#system-prompt-attribution-block) überprüfen Sie, welche Verbindungen und Anmeldedaten dies abdeckt. Vor v2.1.181 enthielt der Block ein Pro-Request-Token bei benutzerdefinierten Basis-URLs und Microsoft Foundry-Verbindungen, daher setzen Sie auf diesen Versionen `0`, wenn Ihr LLM-Gateway auf dem Request-Body zwischenspeichert oder Anfragen an einen Drittanbieter-Provider weiterleitet, oder wenn Sie sich direkt mit Microsoft Foundry verbinden |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Setzen Sie auf `0`, um den [Attributionsblock](/docs/de/llm-gateway-protocol#system-prompt-attribution-block), der die Client-Version und einen Prompt-Fingerabdruck trägt, vom Anfang des System-Prompts auszulassen. Caching bei einer direkten Verbindung zur Anthropic API ist in jedem Fall unbeeinträchtigt. In einigen direkten Verbindungssetups behält Claude Code den Block bei [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer-Anfragen, auch wenn Sie `0` setzen. In [System-Prompt-Attributionsblock](/docs/de/llm-gateway-protocol#system-prompt-attribution-block) überprüfen Sie, welche Verbindungen und Credentials dies abdeckt. Vor v2.1.181 enthielt der Block ein Pro-Request-Token bei benutzerdefinierten Basis-URLs und Microsoft Foundry-Verbindungen, daher setzen Sie auf diesen Versionen `0`, wenn Ihr LLM-Gateway auf dem Request-Body zwischenspeichert oder Anfragen an einen Drittanbieter-Provider weiterleitet, oder wenn Sie sich direkt mit Microsoft Foundry verbinden |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Wenn `CLAUDE_AUTO_BACKGROUND_TASKS` aktiviert ist, Sekunden zwischen Erinnerungen an Claude, um [Hintergrund-Subagents](/docs/de/sub-agents#run-subagents-in-foreground-or-background) zu überprüfen, die noch laufen. Akzeptiert nur eine einfache Ganzzahl von `1` bis `86400`; jeder andere Wert oder jede andere Schreibweise wird als nicht gesetzt gelesen. Wenn nicht gesetzt, gibt es keine Check-in-Erinnerungen. Erfordert Claude Code v2.1.248 oder später |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Wenn `CLAUDE_AUTO_BACKGROUND_TASKS` aktiviert ist, Sekunden zwischen Erinnerungen an Claude, um [Hintergrund-Subagents](/docs/de/sub-agents#run-subagents-in-foreground-or-background) zu überprüfen, die noch laufen. Akzeptiert nur eine einfache Ganzzahl von `1` bis `86400`; jeder andere Wert oder jede andere Schreibweise wird als nicht gesetzt gelesen. Wenn nicht gesetzt, gibt es keine Check-in-Erinnerungen. Erfordert Claude Code v2.1.248 oder später |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Setzen Sie das [Auto-Compact-Fenster](/docs/de/model-config#set-the-auto-compact-window) in Tokens, von `100000` bis `1000000`. Akzeptiert nur eine einfache Ganzzahl wie `500000`: ein Wert wie `500k` wird als `500` gelesen und auf das 100K-Minimum begrenzt. Das effektive Fenster ist auch auf das Kontext-Fenster des Modells begrenzt. Hat Vorrang vor dem `/autocompact`-Befehl, dem `--autocompact`-Flag und der `autoCompactWindow`-Einstellung. Die `used_percentage` der Status-Zeile misst sich immer gegen das vollständige Kontext-Fenster des Modells, daher zeigt dieser Prozentsatz nicht mehr an, wann Compaction läuft, sobald diese Variable gesetzt ist |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Setzen Sie das [Auto-Compact-Fenster](/docs/de/model-config#set-the-auto-compact-window) in Tokens von `100000` bis `1000000`. Akzeptiert nur eine einfache Ganzzahl wie `500000`: ein Wert wie `500k` wird als `500` gelesen und auf das 100K-Minimum begrenzt. Das effektive Fenster ist auch auf das Kontext-Fenster des Modells begrenzt. Hat Vorrang vor dem `/autocompact`-Befehl, dem `--autocompact`-Flag und der `autoCompactWindow`-Einstellung. Die Status-Zeile's `used_percentage` misst immer gegen das vollständige Kontext-Fenster des Modells, daher zeigt dieser Prozentsatz nicht mehr an, wenn Compaction läuft, sobald diese Variable gesetzt ist |

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

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Steuert, ob Claude Code den Server bittet, [Auto-Mode-Aktionen zu überprüfen](/docs/de/permission-modes#server-side-classifier-review). Setzen Sie auf `0`, um stattdessen Claude Code's eigene Klassifizierer-Anfragen zu verwenden. Bei einer direkten Verbindung zur Anthropic API erfordert v2.1.281 oder später. Der verlinkte Abschnitt listet auf, welche Sitzungen den Server fragen, wenn die Variable nicht gesetzt ist, und ab welcher Version. Erfordert Claude Code v2.1.271 oder später |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Steuert, ob Claude Code den Server bittet, [Auto-Mode-Aktionen zu überprüfen](/docs/de/permission-modes#server-side-classifier-review). Setzen Sie auf `0`, um stattdessen Claude Code's eigene Klassifizierer-Anfragen zu verwenden. Bei einer direkten Verbindung zur Anthropic API erfordert dies v2.1.281 oder später. Der verlinkte Abschnitt listet auf, welche Sitzungen den Server fragen, wenn die Variable nicht gesetzt ist, und ab welcher Version. Erfordert Claude Code v2.1.271 oder später |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Zeit in Millisekunden, die Claude Code auf die AWS-Standard-Anmeldedaten-Provider-Kette wartet, um Anmeldedaten zu produzieren, bevor die Anfrage mit [`AWS default-chain credential resolve timed out`](/docs/de/errors#aws-default-chain-credential-resolve-timed-out) fehlschlägt (Standard: `60000`). Erhöhen Sie dies, wenn ein Schritt in Ihrer Kette legitim länger braucht, wie eine Browser-basierte SSO-Anmeldung mit MFA durch einen Wrapper wie `aws-vault`. Gilt überall dort, wo Claude Code mit der Standard-Kette signiert: [Amazon Bedrock](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und der [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Erfordert Claude Code v2.1.207 oder später |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Zeit in Millisekunden, die Claude Code auf die AWS-Standard-Credential-Provider-Kette wartet, um Credentials zu produzieren, bevor die Anfrage mit [`AWS default-chain credential resolve timed out`](/docs/de/errors#aws-default-chain-credential-resolve-timed-out) fehlschlägt (Standard: `60000`). Erhöhen Sie dies, wenn ein Schritt in Ihrer Kette legitim länger braucht, wie eine Browser-basierte SSO-Anmeldung mit MFA durch einen Wrapper wie `aws-vault`. Gilt überall dort, wo Claude Code mit der Standard-Kette signiert: [Amazon Bedrock](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und der [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Erfordert Claude Code v2.1.207 oder später |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Setzen Sie auf `0`, um das [Diff der Dateien, die sich geändert haben, während ein Bash-Befehl lief](/docs/de/hooks#bash), auszuschalten, oder `1`, um es in jedem Permission-Modus zu erfassen. Hat Vorrang vor der [`bashEditDiffEnabled`](/docs/de/settings-reference#basheditdiffenabled)-Einstellung. Erfordert Claude Code v2.1.269 oder später |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Setzen Sie auf `0`, um das [Diff der Dateien, die sich geändert haben, während ein Bash-Befehl lief](/docs/de/hooks#bash), auszuschalten, oder `1`, um es in jedem Permission-Modus zu erfassen. Hat Vorrang vor der [`bashEditDiffEnabled`](/docs/de/settings-reference#basheditdiffenabled)-Einstellung. Erfordert Claude Code v2.1.269 oder später |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Setzen Sie auf `0`, um eine nicht-interaktive Sitzung dazu zu bringen, einen Idle-Status an ihren Host bei jedem Turn-Ende zu melden, auch während Hintergrundarbeit noch läuft. Standardmäßig meldet die Sitzung einen Running-Status über das Turn-Ende hinaus, während Hintergrundarbeit wie ein Hintergrund-Agent oder ein [Workflow](/docs/de/workflows)-Lauf noch aktiv ist. Dies hält einen Host, der den Status beobachtet, wie eine Remote-Sitzungsliste, davon ab, anzukündigen, dass Claude auf Ihre Eingabe wartet, während Arbeit läuft. Hintergrund-Shell-Befehle, wie ein Dev-Server, halten nicht den Running-Status. Der Running-Status-Standard und das `0`-Opt-out erfordern Claude Code v2.1.269 oder später; auf früheren Versionen setzen Sie `1`, um den Running-Status zu halten |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Setzen Sie auf `0`, um eine nicht-interaktive Sitzung einen Idle-Status an ihren Host bei jedem Turn-Ende zu melden, auch während Hintergrundarbeit noch läuft. Standardmäßig meldet die Sitzung einen laufenden Status über das Turn-Ende hinaus, während Hintergrundarbeit wie ein Hintergrund-Agent oder ein [Workflow](/docs/de/workflows)-Lauf noch aktiv ist. Dies hält einen Host, der den Status beobachtet, wie eine Remote-Sitzungsliste, davon ab, anzukündigen, dass Claude auf Ihre Eingabe wartet, während Arbeit läuft. Hintergrund-Shell-Befehle, wie ein Dev-Server, halten nicht den laufenden Status. Der laufende Status-Standard und das `0`-Opt-out erfordern Claude Code v2.1.269 oder später; auf früheren Versionen setzen Sie `1`, um den laufenden Status zu halten |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Wird automatisch in Bash-Tool- und [Hook-Befehls](/docs/de/hooks)-Subprozessen gesetzt, während die Sitzung eine aktive [Remote Control](/docs/de/remote-control)-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die Sitzungs-ID in `session_`-Form, der gleiche Identifikator, der in der `claude.ai/code`-URL der Sitzung erscheint, daher kann ein Skript zurück zur Sitzung verlinken, die es ausgeführt hat. Erfordert Claude Code v2.1.199 oder später. In [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) lesen Sie stattdessen `CLAUDE_CODE_REMOTE_SESSION_ID` |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Wird automatisch in Bash-Tool- und [Hook-Befehl](/docs/de/hooks)-Subprozessen gesetzt, während die Sitzung eine aktive [Remote Control](/docs/de/remote-control)-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die Sitzungs-ID in `session_`-Form, der gleiche Identifier, der in der Sitzungs-`claude.ai/code`-URL erscheint, daher kann ein Skript zurück zur Sitzung verlinken, die es ausgeführt hat. Erfordert Claude Code v2.1.199 oder später. In [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) lesen Sie stattdessen `CLAUDE_CODE_REMOTE_SESSION_ID` |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Setzen Sie auf `0`, um Claude Code das `0x08`-Byte, auch geschrieben `^H`, als einfaches Backspace zu lesen, oder `1`, um es als Ctrl+Backspace zu lesen. Jeder Wert ersetzt den Plattform-Standard. Standardmäßig liest Claude Code es als Ctrl+Backspace unter Windows, außer wenn `TERM_PROGRAM` `mintty` oder `TERM` `cygwin` ist, und als einfaches Backspace auf macOS und Linux. Setzen Sie `0` in einem Windows-Terminal, wo [Backspace ein ganzes Wort löscht](/docs/de/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Setzen Sie auf `0`, um Claude Code das `0x08`-Byte, auch geschrieben `^H`, als einfaches Backspace zu lesen, oder `1`, um es als Ctrl+Backspace zu lesen. Jeder Wert ersetzt den Plattform-Standard. Standardmäßig liest Claude Code es als Ctrl+Backspace unter Windows, außer wenn `TERM_PROGRAM` `mintty` oder `TERM` `cygwin` ist, und als einfaches Backspace auf macOS und Linux. Setzen Sie `0` in einem Windows-Terminal, wo [Backspace ein ganzes Wort löscht](/docs/de/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `CLAUDE_CODE_CERT_STORE` | Komma-getrennte Liste von CA-Zertifikat-Quellen für TLS-Verbindungen. `bundled` ist der Mozilla CA-Satz, der mit Claude Code ausgeliefert wird. `system` ist der Betriebssystem-Vertrauensspeicher, nur auf Runtimes mit `tls.getCACertificates` lesbar: die native Binärdatei oder Node 22.15 oder später für npm-Installationen. Siehe [CA-Zertifikat-Speicher](/docs/de/network-config#ca-certificate-store). Standard ist `bundled,system` |232| `CLAUDE_CODE_CERT_STORE` | Komma-getrennte Liste von CA-Zertifikat-Quellen für TLS-Verbindungen. `bundled` ist der Mozilla CA-Satz, der mit Claude Code ausgeliefert wird. `system` ist der Betriebssystem-Vertrauensspeicher, nur auf Runtimes mit `tls.getCACertificates` lesbar: die native Binärdatei oder Node 22.15 oder später für npm-Installationen. Siehe [CA-Zertifikat-Speicher](/docs/de/network-config#ca-certificate-store). Standard ist `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Wird auf `1` in Subprozessen gesetzt, die Claude Code über die Bash-, PowerShell- und Monitor-Tools spawnt, [Hook](/docs/de/hooks)-Befehle und [Status-Zeilen](/docs/de/statusline)-Befehle. Nicht gesetzt für stdio [MCP-Server](/docs/de/mcp)-Subprozesse, die langlebig sind und die Sitzung, die sie spawnt hat, überleben. Im Gegensatz zu `CLAUDECODE` wird dies nur von Claude Code selbst gesetzt, wenn es einen Subprocess startet, und nicht von IDE-Erweiterungen, daher unterscheidet es zuverlässig eine verschachtelte Sitzung von einem Top-Level-`claude`, das in einem IDE-integrierten Terminal gestartet wird. Eine verschachtelte interaktive `claude` TUI, die auf diese Weise gestartet wird, wird automatisch von `--resume`, `--continue`, Up-Arrow-Verlauf und der `claude agents`-Liste ausgeschlossen. Nicht-interaktive `claude -p`-Sitzungen bleiben bestehen. Setzen Sie `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, um diesen Ausschluss zu überschreiben. Erfordert Claude Code v2.1.172 oder später |233| `CLAUDE_CODE_CHILD_SESSION` | Wird auf `1` in Subprozessen gesetzt, die Claude Code über die Bash-, PowerShell- und Monitor-Tools, [Hook](/docs/de/hooks)-Befehle und [Status-Zeile](/docs/de/statusline)-Befehle spawnt. Nicht gesetzt für stdio [MCP-Server](/docs/de/mcp)-Subprozesse, die langlebig sind und die Sitzung, die sie spawnt hat, überleben. Im Gegensatz zu `CLAUDECODE` wird dies nur von Claude Code selbst gesetzt, wenn es einen Subprocess startet, und nicht von IDE-Erweiterungen, daher unterscheidet es zuverlässig eine verschachtelte Sitzung von einem Top-Level-`claude`, das in einem IDE-integrierten Terminal gestartet wird. Eine verschachtelte interaktive `claude` TUI, die auf diese Weise gestartet wird, wird automatisch von `--resume`, `--continue`, Up-Arrow-Verlauf und der `claude agents`-Liste ausgeschlossen. Nicht-interaktive `claude -p`-Sitzungen bleiben bestehen. Setzen Sie `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, um diesen Ausschluss zu überschreiben. Erfordert Claude Code v2.1.172 oder später |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Entfernt in v2.1.186 und jetzt ein No-Op. Setzte zuvor ein separates Timeout für die Connect-, TLS- und Response-Header-Phase einer Streaming-API-Anfrage. Verwenden Sie `API_TIMEOUT_MS` für das Pro-Request-Timeout. Für die Response-Header-Phase einer Streaming-Anfrage siehe `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Entfernt in v2.1.186 und jetzt ein No-Op. Setzte zuvor ein separates Timeout für die Connect-, TLS- und Response-Header-Phase einer Streaming-API-Anfrage. Verwenden Sie `API_TIMEOUT_MS` für das Pro-Request-Timeout. Für die Response-Header-Phase einer Streaming-Anfrage siehe `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Überschreiben Sie den Debug-Log-Dateipfad. Trotz des Namens ist dies ein Dateipfad, keine Verzeichnis. Erfordert, dass der Debug-Modus separat über `--debug`, `/debug` oder die `DEBUG`-Umgebungsvariable aktiviert wird: Das Setzen dieser Variable allein aktiviert keine Protokollierung. Das [`--debug-file`](/docs/de/cli-reference#cli-flags)-Flag macht beides auf einmal. Standard ist `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Überschreiben Sie den Debug-Log-Dateipfad. Trotz des Namens ist dies ein Dateipfad, keine Verzeichnis. Erfordert, dass der Debug-Modus separat über `--debug`, `/debug` oder die `DEBUG`-Umgebungsvariable aktiviert wird: Das Setzen dieser Variable allein aktiviert keine Protokollierung. Das [`--debug-file`](/docs/de/cli-reference#cli-flags)-Flag macht beides auf einmal. Standardmäßig `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Minimale Log-Ebene, die in die Debug-Log-Datei geschrieben wird. Werte: `verbose`, `debug` (Standard), `info`, `warn`, `error`. Setzen Sie auf `verbose`, um hochvolumige Diagnostiken wie vollständige Status-Zeilen-Befehls-Ausgabe einzuschließen, oder erhöhen Sie auf `error`, um Rauschen zu reduzieren |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Minimale Log-Ebene, die in die Debug-Log-Datei geschrieben wird. Werte: `verbose`, `debug` (Standard), `info`, `warn`, `error`. Setzen Sie auf `verbose`, um hochvolumige Diagnostiken wie vollständige Status-Zeilen-Befehlsausgabe einzubeziehen, oder erhöhen Sie auf `error`, um Rauschen zu reduzieren |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Setzen Sie auf `1`, um die Unterstützung des [1M-Kontext-Fensters](/docs/de/model-config#extended-context) zu deaktivieren. Wenn gesetzt, sind 1M-Modell-Varianten im Modell-Picker nicht verfügbar, und Claude Code hält Sitzungen auf Modellen mit einem nativen 1M-Fenster, wie [Sonnet 5](/docs/de/model-config#sonnet-5-context-window) und die Fable-Modelle, auf ein 200K-Fenster; siehe [Extended Context](/docs/de/model-config#extended-context) für wie die Begrenzung durchgesetzt wird. Nützlich für Unternehmensumgebungen mit Compliance-Anforderungen. Für seine Rolle bei der Korrektur des Fensters für eine nicht erkannte `[1m]`-Modell-ID siehe [Fenster für eine Gateway- oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Setzen Sie auf `1`, um die Unterstützung des [1M-Kontext-Fensters](/docs/de/model-config#extended-context) zu deaktivieren. Wenn gesetzt, sind 1M-Modell-Varianten im Modell-Picker nicht verfügbar, und Claude Code hält Sitzungen auf Modellen mit einem nativen 1M-Fenster, wie [Sonnet 5.5](/docs/de/model-config#sonnet-5-5-and-sonnet-5-context-window) und die Fable-Modelle, auf ein 200K-Fenster; siehe [Extended Context](/docs/de/model-config#extended-context) für wie das Halten durchgesetzt wird. Nützlich für Enterprise-Umgebungen mit Compliance-Anforderungen. Für seine Rolle bei der Korrektur des Fensters für eine nicht erkannte `[1m]`-Modell-ID siehe [Fenster für eine Gateway- oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Setzen Sie auf `1`, um [adaptives Denken](/docs/de/model-config#adjust-effort-level) auf Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Denk-Budget zurückzufallen, das von `MAX_THINKING_TOKENS` gesteuert wird. Hat keine Auswirkung auf [Fable-Modelle](/docs/de/model-config#extended-thinking), Sonnet 5 oder Opus 4.7 und später, die immer adaptives Denken verwenden |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Setzen Sie auf `1`, um [adaptives Reasoning](/docs/de/model-config#adjust-effort-level) auf Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Thinking-Budget zurückzufallen, das von `MAX_THINKING_TOKENS` gesteuert wird. Hat keine Auswirkung auf [Fable-Modelle](/docs/de/model-config#extended-thinking), Sonnet 5 oder Opus 4.7 und später, die immer adaptives Reasoning verwenden |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Setzen Sie auf `1`, um Claude Code daran zu hindern, [verwaltete Einstellungen](/docs/de/managed-settings#precedence-within-the-managed-tier) `env`-Blöcke pro Schlüssel über Admin-Quellen zu mergen, daher gilt nur der `env`-Block der höchsten Prioritäts-Quelle, wie vor v2.1.223. Setzen Sie es in der Umgebung, die Claude Code startet, da Claude Code eine Kopie ignoriert, die durch einen Einstellungs-`env`-Block geliefert wird. Erfordert Claude Code v2.1.223 oder später |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, [verwaltete Einstellungen](/docs/de/managed-settings#precedence-within-the-managed-tier) `env`-Blöcke pro Schlüssel über Admin-Quellen zu mergen, daher gilt nur der `env`-Block der höchsten Prioritätsquelle, wie vor v2.1.223. Setzen Sie es in der Umgebung, die Claude Code startet, da Claude Code eine Kopie ignoriert, die durch einen Einstellungs-`env`-Block geliefert wird. Erfordert Claude Code v2.1.223 oder später |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Setzen Sie auf `1`, um das [Advisor-Tool](/docs/de/advisor) zu deaktivieren. Der `/advisor`-Befehl wird nicht verfügbar, jedes konfigurierte `advisorModel` wird ignoriert, und das `--advisor`-Flag wird akzeptiert, hat aber keine Auswirkung, daher funktionieren bestehende Skripte, die es übergeben, weiterhin ohne Fehler |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Setzen Sie auf `1`, um das [Advisor-Tool](/docs/de/advisor) zu deaktivieren. Der `/advisor`-Befehl wird nicht verfügbar, jedes konfigurierte `advisorModel` wird ignoriert, und das `--advisor`-Flag wird akzeptiert, hat aber keine Auswirkung, daher funktionieren bestehende Skripte, die es übergeben, weiterhin ohne Fehler |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Setzen Sie auf `1`, um [Hintergrund-Agents und Agent-Ansicht](/docs/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor. Entspricht der [`disableAgentView`](/docs/de/settings-reference#disableagentview)-Einstellung |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Setzen Sie auf `1`, um [Hintergrund-Agents und Agent-Ansicht](/docs/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor. Äquivalent zur [`disableAgentView`](/docs/de/settings-reference#disableagentview)-Einstellung |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie auf `1`, um [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren und den klassischen Hauptbildschirm-Renderer zu verwenden. Die Konversation bleibt in Ihrem Terminal-nativen Scrollback, daher funktionieren `Cmd+f` und tmux-Kopier-Modus wie gewohnt. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der [`tui`](/docs/de/settings-reference#tui)-Einstellung. Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrund-Sitzungen, die von [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, die immer Vollbild-Rendering verwenden |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie auf `1`, um [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren und den klassischen Main-Screen-Renderer zu verwenden. Die Konversation bleibt in Ihrem Terminal's nativen Scrollback, daher funktionieren `Cmd+f` und tmux Copy-Modus wie gewohnt. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der [`tui`](/docs/de/settings-reference#tui)-Einstellung. Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrund-Sitzungen, die von [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, die immer Vollbild-Rendering verwenden |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Setzen Sie auf `1`, um das [Artifact](/docs/de/artifacts)-Tool auszuschalten, das Sitzungs-Ausgabe als private Webseite auf claude.ai veröffentlicht. Sobald Sie es setzen, schaltet keine Einstellungsdatei das Tool wieder ein. Um das Tool stattdessen aus einer Einstellungsdatei auszuschalten, setzen Sie [`enableArtifact`](/docs/de/settings-reference#enableartifact) auf `false`; der veraltete [`disableArtifact`](/docs/de/settings-reference#disableartifact)-Schlüssel schaltet es auch aus |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Setzen Sie auf `1`, um das [Artifact](/docs/de/artifacts)-Tool auszuschalten, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Sobald Sie es setzen, schaltet keine Einstellungsdatei das Tool wieder ein. Um das Tool stattdessen aus einer Einstellungsdatei auszuschalten, setzen Sie [`enableArtifact`](/docs/de/settings-reference#enableartifact) auf `false`; der veraltete [`disableArtifact`](/docs/de/settings-reference#disableartifact)-Schlüssel schaltet es auch aus |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Anhang-Verarbeitung zu deaktivieren. Datei-Erwähnungen mit `@`-Syntax werden als einfacher Text gesendet, anstatt in Datei-Inhalt erweitert zu werden |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Anhang-Verarbeitung zu deaktivieren. Datei-Erwähnungen mit `@`-Syntax werden als einfacher Text gesendet, anstatt in Dateiinhalt erweitert zu werden |

248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [Auto-Memory](/docs/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um Auto-Memory zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/docs/de/settings-reference#automemoryenabled) es andernfalls deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine Auto-Memory-Dateien |248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [Auto-Memory](/docs/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um Auto-Memory zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/docs/de/settings-reference#automemoryenabled) es andernfalls deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine Auto-Memory-Dateien |

249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrund-Task-Funktionalität zu deaktivieren, einschließlich des `run_in_background`-Parameters auf Bash- und Subagent-Tools, Auto-Backgrounding und der Ctrl+B-Verknüpfung |249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrund-Task-Funktionalität zu deaktivieren, einschließlich des `run_in_background`-Parameters auf Bash- und Subagent-Tools, Auto-Backgrounding und der Ctrl+B-Verknüpfung |

250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie auf `1`, um Claude Code daran zu hindern, eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlendem oder leerem `Content-Type`-Header als Amazon Bedrock's binären Event-Stream zu behandeln. Standardmäßig geht Claude Code davon aus, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort gelöscht hat, daher dekodiert es den Body und Streaming funktioniert weiter. Setzen Sie dies nur für ein Gateway, das den Stream auch als Server-Sent-Events erneut aussendet; Claude Code liest dann den Header-losen Body als Server-Sent-Events statt. Erfordert Claude Code v2.1.239 oder später |250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlender oder leerer `Content-Type`-Header als Amazon Bedrock's binären Event-Stream zu behandeln. Standardmäßig geht Claude Code davon aus, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort gelöscht hat, daher dekodiert es den Body und Streaming funktioniert weiter. Setzen Sie dies nur für ein Gateway, das den Stream auch als Server-Sent-Events erneut ausgibt; Claude Code liest dann den Header-losen Body als Server-Sent-Events statt. Erfordert Claude Code v2.1.239 oder später |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie auf `1`, um die Prüfung zu überspringen, dass eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort den `application/vnd.amazon.eventstream`-Content-Type trägt. Ohne diese Variable schlägt Claude Code die Anfrage mit einem Fehler fehl, der diesen Typ benennt, wenn eine Antwort einen anderen Content-Type trägt, was bedeutet, dass ein [Gateway oder Proxy die Antwort transformiert](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Konfigurieren Sie das Gateway, um den `Content-Type`-Header und Body unverändert weiterzuleiten, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder später |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie auf `1`, um die Prüfung zu überspringen, dass eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort den `application/vnd.amazon.eventstream`-Content-Type trägt. Ohne diese Variable schlägt Claude Code die Anfrage mit einem Fehler fehl, der diesen Typ benennt, wenn eine Antwort einen anderen Content-Type trägt, was bedeutet, dass ein [Gateway oder Proxy die Antwort transformiert](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Konfigurieren Sie das Gateway, um den `Content-Type`-Header und Body unverändert weiterzuleiten, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder später |

252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie auf `1`, um zu verhindern, dass die laufenden Hintergrund-Shell-Befehle einer [Hintergrund-Sitzung](/docs/de/agent-view), dynamische Workflows, und ab v2.1.198 Hintergrund-Subagents, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) diese Sitzung stoppt, neu startet oder aktualisiert, an den nächsten Prozess der Sitzung übergeben werden. Betrifft nur diese Übergabe: Das Hintergrund-Verschieben einer Sitzung mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) trägt immer noch laufende Arbeit über, und `CLAUDE_DISABLE_ADOPT` schaltet beides aus. Erfordert Claude Code v2.1.196 oder später |252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie auf `1`, um zu verhindern, dass die laufenden Hintergrund-Shell-Befehle einer [Hintergrund-Sitzung](/docs/de/agent-view), dynamische Workflows, und ab v2.1.198 Hintergrund-Subagents, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) diese Sitzung's Prozess stoppt, neu startet oder aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Das Backgrounding einer Sitzung mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) trägt immer noch laufende Arbeit über, und `CLAUDE_DISABLE_ADOPT` schaltet beides aus. Erfordert Claude Code v2.1.196 oder später |

253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie auf `1`, um Claude Code daran zu hindern, [Hintergrund-Shell-Befehle](/docs/de/interactive-mode#background-bash-commands) unter Speicherdruck zu beenden. Standardmäßig beendet Claude Code auf macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang untätig war, ohne dass ein Turn oder Subagent läuft. Windows hat kein Speicherdruck-Signal, daher hat diese Variable dort keine Auswirkung. Erfordert Claude Code v2.1.193 oder später |253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, [Hintergrund-Shell-Befehle](/docs/de/interactive-mode#background-bash-commands) unter Speicherdruck zu beenden. Standardmäßig beendet Claude Code auf macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang untätig war, ohne dass ein Turn oder Subagent läuft. Windows hat kein Speicherdruck-Signal, daher hat diese Variable dort keine Auswirkung. Erfordert Claude Code v2.1.193 oder später |

254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie auf `1`, um die [Skills](/docs/de/skills) und Workflows zu deaktivieren, die mit Claude Code enthalten sind: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie `/init` tippbar bleiben, aber vom Modell verborgen sind. `/doctor` bleibt tippbar wie die integrierten Befehle; verstecken Sie es mit `DISABLE_DOCTOR_COMMAND` statt. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht der [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills)-Einstellung |254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie auf `1`, um die [Skills](/docs/de/skills) und Workflows zu deaktivieren, die mit Claude Code enthalten sind: Bundled Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie `/init` tippbar bleiben, aber vom Modell verborgen sind. `/doctor` bleibt tippbar wie die integrierten Befehle; verstecken Sie es mit `DISABLE_DOCTOR_COMMAND` statt. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Äquivalent zur [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills)-Einstellung |

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Setzen Sie auf `1`, um die [Claude in Chrome](/docs/de/chrome)-Browser-Tools verfügbar zu halten, während Sie den Chrome-Abschnitt des System-Prompts und die `/claude-in-chrome` [gebündelte Skill](/docs/de/skills#bundled-skills) auslassen. Für Hosts, die Claude Code einbetten und ihre eigene Browser-Anleitung bereitstellen. Erfordert Claude Code v2.1.257 oder später |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Setzen Sie auf `1`, um die [Claude in Chrome](/docs/de/chrome)-Browser-Tools verfügbar zu halten, während Sie den Chrome-Abschnitt des System-Prompts und die `/claude-in-chrome` [Bundled Skill](/docs/de/skills#bundled-skills) auslassen. Für Hosts, die Claude Code einbetten und ihre eigene Browser-Anleitung bereitstellen. Erfordert Claude Code v2.1.257 oder später |

256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie auf `1`, um zu verhindern, dass CLAUDE.md-Memory-Dateien in den Kontext geladen werden, einschließlich Benutzer-, Projekt- und Auto-Memory-Dateien |256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie auf `1`, um zu verhindern, dass CLAUDE.md-Memory-Dateien in den Kontext geladen werden, einschließlich Benutzer-, Projekt- und Auto-Memory-Dateien |

257| `CLAUDE_CODE_DISABLE_CRON` | Setzen Sie auf `1`, um [geplante Aufgaben](/docs/de/scheduled-tasks) zu deaktivieren. Der `/loop`-Skill und Cron-Tools werden nicht verfügbar, und alle bereits geplanten Aufgaben stoppen, einschließlich Aufgaben, die bereits mid-session laufen |257| `CLAUDE_CODE_DISABLE_CRON` | Setzen Sie auf `1`, um [geplante Aufgaben](/docs/de/scheduled-tasks) zu deaktivieren. Der `/loop`-Skill und Cron-Tools werden nicht verfügbar, und alle bereits geplanten Aufgaben stoppen, einschließlich Aufgaben, die bereits mid-session laufen |

258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Setzen Sie auf `1`, um Anthropic-spezifische `anthropic-beta`-Request-Header und Beta-Tool-Schema-Felder (wie `defer_loading` und `eager_input_streaming`) aus API-Anfragen zu entfernen. Verwenden Sie dies, wenn ein Proxy-Gateway Anfragen mit Fehlern wie "Unexpected value(s) for the `anthropic-beta` header" oder "Extra inputs are not permitted" ablehnt. Standard-Felder (`name`, `description`, `input_schema`, `cache_control`) werden beibehalten. [MCP-Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) ist deaktiviert und alle MCP-Tools laden upfront, auch wenn Sie `ENABLE_TOOL_SEARCH` setzen. Auf Claude Code v2.1.227 oder später können [verwaltete Einstellungen](/docs/de/managed-settings) Tool-Suche eingeschaltet halten. [Pre-Release-Fähigkeiten deaktivieren](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) behandelt, wo der Override gilt |258| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Setzen Sie auf `1`, um die Zeitbegrenzung auf [Critical-Path-Removal](/docs/de/permission-modes#critical-paths)-Prompts auszuschalten. Im `auto`-Modus sendet Claude Code diese Removals dann zum Klassifizierer, und im `bypassPermissions`-Modus wartet der Prompt auf Ihre Antwort. Setzen Sie es in der Umgebung, die Claude Code startet, da Claude Code eine Kopie ignoriert, die durch einen Einstellungs-`env`-Block geliefert wird. Erfordert Claude Code v2.1.281 oder später |

259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Setzen Sie auf `1`, um die integrierten [Explore- und Plan-Subagents](/docs/de/sub-agents#built-in-subagents) zu deaktivieren. Claude erkundet stattdessen mit seinen Such-Tools oder dem General-Purpose-Subagent, und [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) liest Dateien direkt, anstatt Explore- und Plan-Agents zu starten. Benutzerdefinierte Subagents mit dem Namen `Explore` oder `Plan` sind nicht betroffen. Um jeden integrierten Subagent-Typ im Agent SDK oder nicht-interaktiven Modus zu entfernen, verwenden Sie stattdessen `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Erfordert Claude Code v2.1.198 oder später |259| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Setzen Sie auf `1`, um Anthropic-spezifische `anthropic-beta`-Request-Header und Beta-Tool-Schema-Felder (wie `defer_loading` und `eager_input_streaming`) aus API-Anfragen zu entfernen. Verwenden Sie dies, wenn ein Proxy-Gateway Anfragen mit Fehlern wie "Unexpected value(s) for the `anthropic-beta` header" oder "Extra inputs are not permitted" ablehnt. Standard-Felder (`name`, `description`, `input_schema`, `cache_control`) bleiben erhalten. [MCP-Toolsuche](/docs/de/mcp#scale-with-mcp-tool-search) ist deaktiviert und alle MCP-Tools laden upfront, auch wenn Sie `ENABLE_TOOL_SEARCH` setzen. Auf Claude Code v2.1.227 oder später können [verwaltete Einstellungen](/docs/de/managed-settings) die Toolsuche eingeschaltet halten. [Pre-Release-Fähigkeiten deaktivieren](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) behandelt, wo der Override gilt |

260| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Setzen Sie auf `1`, um die integrierten [Explore und Plan Subagents](/docs/de/sub-agents#built-in-subagents) zu deaktivieren. Claude erkundet stattdessen mit seinen Such-Tools oder dem General-Purpose-Subagent, und [Plan Mode](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) liest Dateien direkt, anstatt Explore- und Plan-Agents zu starten. Benutzerdefinierte Subagents mit dem Namen `Explore` oder `Plan` sind nicht betroffen. Um jeden integrierten Subagent-Typ im Agent SDK oder nicht-interaktiven Modus zu entfernen, verwenden Sie stattdessen `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Erfordert Claude Code v2.1.198 oder später |

261| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Setzen Sie auf `1`, um die "How is Claude doing?"-Sitzungsqualitäts-Umfragen zu deaktivieren. Umfragen sind auch deaktiviert, wenn `DISABLE_TELEMETRY`, `DO_NOT_TRACK` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist, es sei denn, `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` meldet sich wieder an. Um stattdessen eine Sample-Rate zu setzen, verwenden Sie die [`feedbackSurveyRate`](/docs/de/settings-reference#feedbacksurveyrate)-Einstellung. Siehe [Sitzungsqualitäts-Umfragen](/docs/de/data-usage#session-quality-surveys) |262| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Setzen Sie auf `1`, um die "How is Claude doing?"-Sitzungsqualitäts-Umfragen zu deaktivieren. Umfragen sind auch deaktiviert, wenn `DISABLE_TELEMETRY`, `DO_NOT_TRACK` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist, es sei denn, `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` meldet sich wieder an. Um stattdessen eine Sample-Rate zu setzen, verwenden Sie die [`feedbackSurveyRate`](/docs/de/settings-reference#feedbacksurveyrate)-Einstellung. Siehe [Sitzungsqualitäts-Umfragen](/docs/de/data-usage#session-quality-surveys) |

262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Setzen Sie auf `1`, um Datei-[Checkpointing](/docs/de/checkpointing) zu deaktivieren. Der `/rewind`-Befehl kann Code-Änderungen nicht wiederherstellen. Überschreibt die [`fileCheckpointingEnabled`](/docs/de/settings-reference#filecheckpointingenabled)-Einstellung |263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Setzen Sie auf `1`, um Datei-[Checkpointing](/docs/de/checkpointing) zu deaktivieren. Der `/rewind`-Befehl kann Code-Änderungen nicht wiederherstellen. Überschreibt die [`fileCheckpointingEnabled`](/docs/de/settings-reference#filecheckpointingenabled)-Einstellung |

263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Setzen Sie auf `1`, um integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot aus Claude's Kontext zu entfernen. Nützlich, wenn Sie Ihre eigenen Git-Workflow-Skills verwenden. Hat Vorrang vor der [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions)-Einstellung, wenn gesetzt |264| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Setzen Sie auf `1`, um integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot aus Claude's Kontext zu entfernen. Nützlich bei Verwendung Ihrer eigenen Git-Workflow-Skills. Hat Vorrang vor der [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions)-Einstellung, wenn gesetzt |

264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Setzen Sie auf `1`, um die automatische Neuzuordnung von Opus 4.0 und 4.1 zur aktuellen Opus-Version auf der Anthropic API zu verhindern. Verwenden Sie, wenn Sie absichtlich ein älteres Modell anheften möchten. Die Neuzuordnung läuft nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry |265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Setzen Sie auf `1`, um die automatische Neuzuordnung von Opus 4.0 und 4.1 zur aktuellen Opus-Version auf der Anthropic API zu verhindern. Verwenden Sie dies, wenn Sie absichtlich ein älteres Modell anheften möchten. Die Neuzuordnung läuft nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry |

265| `CLAUDE_CODE_DISABLE_MOUSE` | Setzen Sie auf `1`, um die Maus-Verfolgung im [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren. Tastatur-Scrollen mit `PgUp` und `PgDn` funktioniert immer noch. Verwenden Sie dies, um Ihr Terminal's natives Copy-on-Select-Verhalten zu behalten |266| `CLAUDE_CODE_DISABLE_MOUSE` | Setzen Sie auf `1`, um die Mausverfolgung im [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren. Tastatur-Scrolling mit `PgUp` und `PgDn` funktioniert immer noch. Verwenden Sie dies, um das native Copy-on-Select-Verhalten Ihres Terminals zu behalten |

266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Setzen Sie auf `1`, um Click-, Drag- und Hover-Handling im [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren, während Sie Maus-Rad-Scrollen behalten. Verwenden Sie dies, wenn Sie möchten, dass Rad-Scroll in Claude Code funktioniert, aber nicht möchten, dass Clicks den Cursor positionieren, Tool-Ausgabe erweitern oder Links öffnen. `CLAUDE_CODE_DISABLE_MOUSE` hat Vorrang, wenn beide gesetzt sind. Erfordert Claude Code v2.1.195 oder später |267| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Setzen Sie auf `1`, um Click-, Drag- und Hover-Handling im [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren, während Sie Mausrad-Scrolling behalten. Verwenden Sie dies, wenn Sie möchten, dass Rad-Scroll in Claude Code funktioniert, aber nicht möchten, dass Klicks den Cursor positionieren, Tool-Ausgabe erweitern oder Links öffnen. `CLAUDE_CODE_DISABLE_MOUSE` hat Vorrang, wenn beide gesetzt sind. Erfordert Claude Code v2.1.195 oder später |

267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Setzen Sie auf `1`, um Claude Code daran zu hindern, das [mTLS-Client-Zertifikat und den Schlüssel](/docs/de/network-config#mtls-authentication) erneut zu lesen, wenn eine API-Anfrage mit einem Verbindungs-Level-Fehler fehlschlägt, wie ein Verbindungs-Reset oder ein TLS-Handshake-Fehler. Mit dem Reload deaktiviert lädt Claude Code rotierte Dateien nur, wenn es nächstes Mal Einstellungen anwendet oder beim nächsten Startup. Erfordert Claude Code v2.1.232 oder später |268| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, das [mTLS-Client-Zertifikat und den Schlüssel](/docs/de/network-config#mtls-authentication) erneut zu lesen, wenn eine API-Anfrage mit einem Verbindungs-Level-Fehler fehlschlägt, wie ein Verbindungs-Reset oder ein TLS-Handshake-Fehler. Mit dem Reload deaktiviert lädt Claude Code rotierte Dateien nur, wenn es nächstes Mal Einstellungen anwendet oder beim nächsten Start. Erfordert Claude Code v2.1.232 oder später |

268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um nicht-wesentlichen Netzwerk-Traffic zu deaktivieren: Auto-Updates, Telemetrie, Fehlerberichterstattung, den `/feedback`-Befehl, [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior), Release-Notizen, die [PR- und MR-Status-Badge](/docs/de/interactive-mode#pr-review-status)-Checks und Verfügbarkeitsprüfungen wie die [Fast-Mode](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)-Prüfung. Es stoppt auch die [Hintergrund-Läufe von Plugin-`command`-Quellen](/docs/de/plugins/loading#when-a-command-source-re-runs), die lokale Befehle statt Netzwerk-Traffic sind, weil sie Abhängigkeits-Installationen auslösen können. **Das Setzen auf `0` oder `false` deaktiviert immer noch diesen Traffic**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um ihn wieder zu erlauben. Deaktiviert auch Feature-Flag-Abrufe, was [Remote Control](/docs/de/remote-control#requirements) und die anderen [Features, die Feature-Flag-Abrufe benötigen](#features-that-need-feature-flag-fetching) nicht verfügbar macht. Offizielle Plugin-Marketplace-Auto-Installation ist nicht abgedeckt; deaktivieren Sie sie mit `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Betrifft nicht [Gateway-Modell-Erkennung](/docs/de/llm-gateway-connect#add-gateway-models-to-the-model-picker), die ihr eigenes Opt-In hat |269| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um nicht-wesentlichen Netzwerk-Traffic zu deaktivieren: Auto-Updates, Telemetrie, Fehlerberichterstattung, den `/feedback`-Befehl, [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior), Release-Notizen, die [PR- und MR-Status-Badge](/docs/de/interactive-mode#pr-review-status)-Prüfungen und Verfügbarkeitsprüfungen wie die [Fast Mode](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)-Prüfung. Es stoppt auch die [Hintergrund-Läufe von Plugin-`command`-Quellen](/docs/de/plugins/loading#when-a-command-source-re-runs), die lokale Befehle sind, anstatt Netzwerk-Traffic, weil sie Abhängigkeits-Installationen auslösen können. **Das Setzen auf `0` oder `false` deaktiviert immer noch diesen Traffic**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Einstellung auf, um es wieder zu erlauben. Deaktiviert auch Feature-Flag-Abrufe, was [Remote Control](/docs/de/remote-control#requirements) und die anderen [Features, die Feature-Flag-Abrufe benötigen](#features-that-need-feature-flag-fetching) nicht verfügbar macht. Offizieller Plugin-Marketplace Auto-Install ist nicht abgedeckt; deaktivieren Sie ihn mit `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Betrifft nicht [Gateway-Modell-Erkennung](/docs/de/llm-gateway-connect#add-gateway-models-to-the-model-picker), die ihr eigenes Opt-In hat |

269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Setzen Sie auf `1`, um das Non-Streaming-Fallback zu deaktivieren, wenn eine Streaming-Anfrage mid-stream fehlschlägt. Streaming-Fehler propagieren stattdessen zur Wiederholungs-Schicht. Nützlich, wenn ein Proxy oder Gateway das Fallback dazu bringt, doppelte Tool-Ausführung zu produzieren |270| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Setzen Sie auf `1`, um das Non-Streaming-Fallback zu deaktivieren, wenn eine Streaming-Anfrage mid-stream fehlschlägt. Streaming-Fehler propagieren stattdessen zur Retry-Schicht. Nützlich, wenn ein Proxy oder Gateway das Fallback verursacht, duplizierte Tool-Ausführung zu produzieren |

270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Setzen Sie auf `1`, um die Desktop-Benachrichtigung des `PushNotification`-Tools zu senden, auch während Sie im Terminal tippen oder es fokussiert haben. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch den [Mobile Push](/docs/de/remote-control#mobile-push-notifications), wenn es kürzliche Tastatur-Aktivität oder Terminal-Fokus erkennt. Diese Variable deaktiviert nur diese lokale Prüfung, daher kann der Server den Mobile Push immer noch unterdrücken, wenn er erkennt, dass Sie aktiv sind. Erfordert Claude Code v2.1.193 oder später |271| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Setzen Sie auf `1`, um die Desktop-Benachrichtigung des `PushNotification`-Tools zu senden, auch während Sie im Terminal tippen oder es fokussiert haben. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch den [Mobile Push](/docs/de/remote-control#mobile-push-notifications), wenn es kürzliche Tastaturaktivität oder Terminal-Fokus erkennt. Diese Variable deaktiviert nur diese lokale Prüfung, daher kann der Server den Mobile Push immer noch unterdrücken, wenn er erkennt, dass Sie aktiv sind. Erfordert Claude Code v2.1.193 oder später |

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Setzen Sie auf `1`, um die automatische Registrierung des offiziellen Plugin-Marketplace zu deaktivieren. Claude Code liest die Variable, wenn es den Marketplace registrieren soll, normalerweise beim ersten interaktiven Start einer Maschine. Wenn die Variable zu diesem Zeitpunkt gesetzt ist, überspringt Claude Code die Registrierung dauerhaft. Das Aufheben der Variable später macht den Skip nicht rückgängig. Führen Sie `claude plugin marketplace add anthropics/claude-plugins-official` aus, um den Marketplace jederzeit zu registrieren |272| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Setzen Sie auf `1`, um die automatische Registrierung des offiziellen Plugin-Marketplace zu deaktivieren. Claude Code liest die Variable, wenn es den Marketplace registrieren soll, normalerweise beim ersten interaktiven Start einer Maschine. Wenn die Variable zu diesem Zeitpunkt gesetzt ist, überspringt Claude Code die Registrierung dauerhaft. Das Aufheben der Variable später macht den Skip nicht rückgängig. Führen Sie `claude plugin marketplace add anthropics/claude-plugins-official` aus, um den Marketplace jederzeit zu registrieren |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Setzen Sie auf `1`, um Claude Code daran zu hindern, Ihre [`Notification`-Hooks für unbeantwortete Permission-Anfragen](/docs/de/hooks#notification) in Sitzungen auszuführen, in denen Claude Code sie an den Agent SDK's `canUseTool`-Callback sendet, was ist, wie Claude Desktop und die VS Code-Erweiterung Claude Code hosten. Hat keine Auswirkung in Terminal-Sitzungen. Erfordert Claude Code v2.1.233 oder später |273| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, Ihre [`Notification`-Hooks für unbeantwortete Permission-Anfragen](/docs/de/hooks#notification) in Sitzungen auszuführen, in denen Claude Code sie an den Agent SDK's `canUseTool`-Callback sendet, was ist, wie Claude Desktop und die VS Code-Erweiterung Claude Code hosten. Hat keine Auswirkung in Terminal-Sitzungen. Erfordert Claude Code v2.1.233 oder später |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Setzen Sie auf `1`, um das Laden von Skills aus dem systemweiten verwalteten Skills-Verzeichnis zu überspringen. Nützlich für Container- oder CI-Sitzungen, die keine Operator-bereitgestellten Skills laden sollten |274| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Setzen Sie auf `1`, um das Laden von Skills aus dem systemweiten verwalteten Skills-Verzeichnis zu überspringen. Nützlich für Container- oder CI-Sitzungen, die keine Operator-bereitgestellten Skills laden sollten |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Setzen Sie auf `1`, um automatische Terminal-Titel-Updates basierend auf Konversations-Kontext zu deaktivieren. Dies überspringt auch die Hintergrund-Small/Fast-Modell-Anfrage, die [eine Sitzungs-Titel generiert](/docs/de/sessions#name-your-sessions) |275| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Setzen Sie auf `1`, um die [PowerShell-Tool](/docs/de/tools-reference#powershell-tool)-Prüfung auszuschalten, die die `cmd`-Built-Ins `rd`, `rmdir`, `del` und `erase` auf einem [System-Pfad](/docs/de/permission-modes#remove-item-in-powershell), wie ein Laufwerk-Root oder Ihr Home-Verzeichnis, verweigert. Claude Code ignoriert diese Variable in einem Einstellungsdatei-`env`-Block. Erfordert Claude Code v2.1.283 oder später |

275| `CLAUDE_CODE_DISABLE_THINKING` | Setzen Sie auf `1`, um den `thinking`-Parameter vollständig aus API-Anfragen auszulassen. Dies ist eine Kompatibilitätsoption für Proxies und Gateways, die den Parameter ablehnen. Bei Modellen, die standardmäßig denken, bedeutet das Auslassen des Parameters, dass das Modell möglicherweise immer noch denkt. Um [Extended Thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) auf der Anthropic API explizit zu deaktivieren, verwenden Sie stattdessen `MAX_THINKING_TOKENS=0`. Keine Variable schaltet Denken auf Opus 5.5 oder den Fable-Modellen aus, die Denken nicht ausschalten können. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt `MAX_THINKING_TOKENS=0` ebenfalls den Parameter aus, daher verhalten sich die beiden Variablen dort gleich |276| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Setzen Sie auf `1`, um die [Critical-Path](/docs/de/permission-modes#critical-paths)-Prüfung für ein rekursives `rm` auszuschalten, dessen Ziel vollständig die Ausgabe einer Befehlsersetzung ist, wie `rm -rf "$(pwd)"`. Die anderen Critical-Path-Prüfungen laufen weiter. Setzen Sie es in der Umgebung, die Claude Code startet, da Claude Code eine Kopie ignoriert, die durch einen Einstellungs-`env`-Block geliefert wird. Erfordert Claude Code v2.1.281 oder später |

277| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Setzen Sie auf `1`, um automatische Terminal-Titel-Updates basierend auf Konversations-Kontext zu deaktivieren. Dies überspringt auch die Hintergrund-Small/Fast-Model-Anfrage, die [eine Sitzungs-Titel generiert](/docs/de/sessions#name-your-sessions) |

278| `CLAUDE_CODE_DISABLE_THINKING` | Setzen Sie auf `1`, um den `thinking`-Parameter vollständig aus API-Anfragen auszulassen. Dies ist eine Kompatibilitätsoption für Proxies und Gateways, die den Parameter ablehnen. Bei Modellen, die standardmäßig denken, bedeutet das Auslassen des Parameters, dass das Modell möglicherweise immer noch denkt. Um [Extended Thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) auf der Anthropic API explizit zu deaktivieren, verwenden Sie stattdessen `MAX_THINKING_TOKENS=0`. Keine Variable schaltet Thinking auf Opus 5.5, Sonnet 5.5 oder den Fable-Modellen aus, die Thinking nicht ausschalten können. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt `MAX_THINKING_TOKENS=0` ebenfalls den Parameter aus, daher verhalten sich die beiden Variablen dort gleich |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Setzen Sie auf `1`, um proaktive [Auto-Compaction](/docs/de/costs#reduce-token-usage) zu überspringen, wenn Claude Code die Modell-ID nicht erkennt, wie ein [LLM-Gateway](/docs/de/llm-gateway)-Alias. Ohne diese Variable komprimiert Claude Code bei dem Kontext-Fenster, das es für die ID annimmt. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` kann das angenommene Fenster stattdessen korrigieren; siehe [Fenster für eine Gateway- oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) für wann jede Variable gilt. Erfordert Claude Code v2.1.223 oder später |279| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Setzen Sie auf `1`, um proaktive [Auto-Compaction](/docs/de/costs#reduce-token-usage) zu überspringen, wenn Claude Code die Modell-ID nicht erkennt, wie ein [LLM-Gateway](/docs/de/llm-gateway)-Alias. Ohne diese Variable komprimiert Claude Code bei dem Kontext-Fenster, das es für die ID annimmt. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` kann das angenommene Fenster stattdessen korrigieren; siehe [Fenster für eine Gateway- oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id) für wann jede Variable gilt. Erfordert Claude Code v2.1.223 oder später |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Setzen Sie auf `1`, um virtuelles Scrollen im [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn Scrollen im Vollbildmodus leere Regionen zeigt, wo Nachrichten erscheinen sollten |280| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Setzen Sie auf `1`, um virtuelles Scrolling im [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn das Scrolling im Vollbildmodus leere Regionen zeigt, wo Nachrichten erscheinen sollten |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Setzen Sie auf `1`, um [PowerShell-Tool](/docs/de/tools-reference#powershell-tool)-Befehle unter Windows direkt zu starten, anstatt durch den `cmd.exe`-Launcher. Standardmäßig ermöglicht der Launcher einem PowerShell-Befehl, der [im Hintergrund läuft](/docs/de/tools-reference#background-commands), [zum nächsten Prozess der Sitzung zu wechseln](/docs/de/agent-view#the-supervisor-process), wie wenn Sie [die Sitzung hintergrund-verschieben](/docs/de/agent-view#from-inside-a-session). Wenn Sie die Variable setzen, stoppt ein hintergrund-verschobener PowerShell-Befehl, wenn der Prozess der Sitzung beendet wird. Bash-Befehle sind nicht betroffen. Erfordert Claude Code v2.1.269 oder später |281| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Setzen Sie auf `1`, um [PowerShell-Tool](/docs/de/tools-reference#powershell-tool)-Befehle unter Windows direkt zu starten, anstatt durch den `cmd.exe`-Launcher. Standardmäßig ermöglicht der Launcher einem PowerShell-Befehl, der [im Hintergrund läuft](/docs/de/tools-reference#background-commands), [zum nächsten Prozess der Sitzung zu wechseln](/docs/de/agent-view#the-supervisor-process), wie wenn Sie [die Sitzung backgrounden](/docs/de/agent-view#from-inside-a-session). Wenn Sie die Variable setzen, stoppt ein backgroundeter PowerShell-Befehl, wenn der Prozess der Sitzung beendet wird. Bash-Befehle sind nicht betroffen. Erfordert Claude Code v2.1.269 oder später |

279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Setzen Sie auf `1`, um [Workflows](/docs/de/workflows#turn-workflows-off) zu deaktivieren. Entspricht der [`disableWorkflows`](/docs/de/settings-reference#disableworkflows)-Einstellung |282| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Setzen Sie auf `1`, um [Workflows](/docs/de/workflows#turn-workflows-off) zu deaktivieren. Äquivalent zur [`disableWorkflows`](/docs/de/settings-reference#disableworkflows)-Einstellung |

280| `CLAUDE_CODE_EFFORT_LEVEL` | Setzen Sie die Effort-Ebene für unterstützte Modelle. Werte: `low`, `medium`, `high`, `xhigh`, `max` oder `auto`, um den Modell-Standard zu verwenden. Verfügbare Ebenen hängen vom Modell ab. Hat Vorrang vor `--effort`, `/effort` und den `modelSettings`- und `effortLevel`-Einstellungen. Eine [`maxEffortLevel`](/docs/de/settings-reference#maxeffortlevel)-Obergrenze gilt immer noch. Siehe [Effort-Ebene anpassen](/docs/de/model-config#adjust-effort-level) |283| `CLAUDE_CODE_EFFORT_LEVEL` | Setzen Sie die Effort-Ebene für unterstützte Modelle. Werte: `low`, `medium`, `high`, `xhigh`, `max` oder `auto`, um den Modell-Standard zu verwenden. Verfügbare Ebenen hängen vom Modell ab. Hat Vorrang vor `--effort`, `/effort` und den `modelSettings`- und `effortLevel`-Einstellungen. Eine [`maxEffortLevel`](/docs/de/settings-reference#maxeffortlevel)-Obergrenze gilt immer noch. Siehe [Effort-Ebene anpassen](/docs/de/model-config#adjust-effort-level) |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Akzeptiert für Kompatibilität mit älteren Versionen und hat keine Auswirkung. Auto-Modus ist standardmäßig auf jedem Provider verfügbar, einschließlich Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzungen. In v2.1.158 bis v2.1.206 war das Setzen auf `1` erforderlich, um [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) auf diesen Providern verfügbar zu machen |284| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Akzeptiert für Kompatibilität mit älteren Versionen und hat keine Auswirkung. Auto Mode ist standardmäßig auf jedem Provider verfügbar, einschließlich Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzungen. In v2.1.158 bis v2.1.206 war das Setzen auf `1` erforderlich, um [Auto Mode](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) auf diesen Providern verfügbar zu machen |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Überschreiben Sie die Verfügbarkeit von [Sitzungs-Zusammenfassung](/docs/de/interactive-mode#session-recap). Setzen Sie auf `0`, um Zusammenfassungen unabhängig vom `/config`-Toggle auszuschalten. Setzen Sie auf `1`, um Zusammenfassungen zu erzwingen, wenn [`awaySummaryEnabled`](/docs/de/settings-reference#awaysummaryenabled) `false` ist. Hat Vorrang vor der Einstellung und dem `/config`-Toggle |285| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Überschreiben Sie die Verfügbarkeit von [Sitzungs-Recap](/docs/de/interactive-mode#session-recap). Setzen Sie auf `0`, um Recaps unabhängig vom `/config`-Toggle auszuschalten. Setzen Sie auf `1`, um Recaps einzuschalten, wenn [`awaySummaryEnabled`](/docs/de/settings-reference#awaysummaryenabled) `false` ist. Hat Vorrang vor der Einstellung und dem `/config`-Toggle |

283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Setzen Sie auf `1`, um den Plugin-Status bei Turn-Grenzen im [nicht-interaktiven Modus](/docs/de/headless) zu aktualisieren, nachdem eine Hintergrund-Installation abgeschlossen ist. Standardmäßig aus, weil die Aktualisierung den System-Prompt mid-session ändert, was [Prompt-Caching](/docs/de/prompt-caching) für diesen Turn ungültig macht |286| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Setzen Sie auf `1`, um den Plugin-Status bei Turn-Grenzen im [nicht-interaktiven Modus](/docs/de/headless) zu aktualisieren, nachdem eine Hintergrund-Installation abgeschlossen ist. Standardmäßig aus, weil die Aktualisierung den System-Prompt mid-session ändert, was [Prompt Caching](/docs/de/prompt-caching) für diesen Turn ungültig macht |

284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Setzen Sie auf `1`, um die "How is Claude doing?"-Sitzungsqualitäts-Umfrage zu Ihrem eigenen [OpenTelemetry-Collector](/docs/de/monitoring-usage) zu leiten, wenn Anthropic-gebundener nicht-wesentlicher Traffic blockiert ist. Umfrage-Bewertungen werden nur als OTEL-Events zu Ihrem konfigurierten Collector emittiert. Keine Umfrage-Daten werden in diesem Modus an Anthropic gesendet. Gilt, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, und hat sonst keine Auswirkung. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` und die Organisations-Produkt-Feedback-Richtlinie haben Vorrang |287| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Setzen Sie auf `1`, um die "How is Claude doing?"-Sitzungsqualitäts-Umfrage zu Ihrem eigenen [OpenTelemetry-Collector](/docs/de/monitoring-usage) zu leiten, wenn Anthropic-gebundener nicht-wesentlicher Traffic blockiert ist. Umfrage-Bewertungen werden nur als OTEL-Events zu Ihrem konfigurierten Collector emittiert. Keine Umfrage-Daten werden in diesem Modus an Anthropic gesendet. Gilt, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, und hat sonst keine Auswirkung. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` und die Organisations-Produktfeedback-Richtlinie haben Vorrang |

285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Tool-Aufruf-Eingaben von der API streamen, während Claude sie generiert. Mit diesem aus kommt eine große Tool-Eingabe wie ein langer Datei-Schreib-Vorgang erst an, nachdem Claude sie fertig generiert hat, was aussehen kann, als würde es hängen. Standardmäßig auf der Anthropic API aktiviert. Bei Amazon Bedrock und Google Cloud's Agent Platform pro Modell aktiviert, wo der bereitgestellte Container es unterstützt. Setzen Sie auf `0`, um zu deaktivieren. Setzen Sie auf `1`, um zu erzwingen, wenn Routing durch einen Proxy über `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_BEDROCK_BASE_URL`. Standardmäßig aus bei Microsoft Foundry und [Gateway](/docs/de/llm-gateway)-Verbindungen |288| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Tool-Call-Eingaben von der API streamen, während Claude sie generiert. Mit diesem aus kommt eine große Tool-Eingabe wie ein langer Datei-Write erst an, nachdem Claude sie fertig generiert hat, was aussehen kann, als würde es hängen. Standardmäßig auf der Anthropic API aktiviert. Bei Amazon Bedrock und Google Cloud's Agent Platform pro Modell aktiviert, wo der bereitgestellte Container es unterstützt. Setzen Sie auf `0`, um zu deaktivieren. Setzen Sie auf `1`, um zu erzwingen, wenn Sie durch einen Proxy über `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_BEDROCK_BASE_URL` routen. Standardmäßig bei Microsoft Foundry und [Gateway](/docs/de/llm-gateway)-Verbindungen aus |

286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Setzen Sie auf `1`, um den `/model`-Picker von Ihrem Gateway's `/v1/models`-Endpunkt zu füllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy zeigt. Standardmäßig aus, weil Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, andernfalls jedem Benutzer jedes Modell zeigen würden, das der Schlüssel zugreifen kann. Erkannte Modelle werden immer noch durch eine [`availableModels`](/docs/de/settings-reference#availablemodels)-Allowlist gefiltert, die die Sitzung erhält; liefern Sie die Liste durch [MDM oder eine verwaltete Einstellungsdatei](/docs/de/managed-settings#delivery-mechanisms), da [Server-verwaltete Lieferung bei Gateway-Konfigurationen nicht verfügbar ist](/docs/de/server-managed-settings#platform-availability) |289| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Setzen Sie auf `1`, um die `/model`-Auswahl von Ihrem Gateway's `/v1/models`-Endpunkt zu füllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy zeigt. Standardmäßig aus, weil Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, andernfalls jedem Benutzer jedes Modell zeigen würden, das der Schlüssel zugreifen kann. Entdeckte Modelle werden immer noch durch eine [`availableModels`](/docs/de/settings-reference#availablemodels)-Allowlist gefiltert, die die Sitzung erhält; liefern Sie die Liste durch [MDM oder eine verwaltete Einstellungsdatei](/docs/de/managed-settings#delivery-mechanisms), da [Server-verwaltete Lieferung bei Gateway-Konfigurationen nicht verfügbar ist](/docs/de/server-managed-settings#platform-availability) |

287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Entfernt in v2.1.142, als der [Fast-Mode](/docs/de/fast-mode)-Standard von Opus 4.6 zu Opus 4.7 wechselte |290| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Entfernt in v2.1.142, als der [Fast Mode](/docs/de/fast-mode)-Standard von Opus 4.6 zu Opus 4.7 wechselte |

288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Setzen Sie auf `false`, um Prompt-Vorschläge auszuschalten, die ausgegraut angezeigten Vorhersagen, die in Ihrer Prompt-Eingabe erscheinen. Hat Vorrang vor der [`promptSuggestionEnabled`](/docs/de/settings-reference#promptsuggestionenabled)-Einstellung, die ist, was der **Prompt suggestions**-Toggle in `/config` schreibt. Claude Code [pausiert auch Vorschläge, während Ihr Konto nahe oder bei seinem Nutzungslimit ist](/docs/de/interactive-mode#when-claude-code-skips-suggestions). Setzen Sie auf `true`, um sie eingeschaltet zu halten, bis Sie das Limit erreichen. Erfordert Claude Code v2.1.238 oder später. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) |291| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Setzen Sie auf `false`, um Prompt-Vorschläge auszuschalten, die ausgegraut Vorhersagen, die in Ihrer Prompt-Eingabe erscheinen. Hat Vorrang vor der [`promptSuggestionEnabled`](/docs/de/settings-reference#promptsuggestionenabled)-Einstellung, die ist, was der **Prompt suggestions**-Toggle in `/config` schreibt. Claude Code [pausiert auch Vorschläge, während Ihr Konto nahe oder bei seinem Nutzungslimit ist](/docs/de/interactive-mode#when-claude-code-skips-suggestions). Setzen Sie auf `true`, um sie eingeschaltet zu halten, bis Sie das Limit erreichen. Erfordert Claude Code v2.1.238 oder später. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) |

289| `CLAUDE_CODE_ENABLE_TASKS` | Wählt, welche Task-Tracking-Tools Claude Code in [Sitzungen bereitstellt, die sie haben](/docs/de/tools-reference#task-tool-availability). Standardmäßig stellt Claude Code die Task-Tools `TaskCreate`, `TaskUpdate`, `TaskGet` und `TaskList` bereit. Setzen Sie auf `0`, um stattdessen das Legacy-`TodoWrite`-Tool zu erhalten. Siehe [Task-Liste](/docs/de/interactive-mode#task-list) |292| `CLAUDE_CODE_ENABLE_TASKS` | Wählt, welche Task-Tracking-Tools Claude Code in [Sitzungen bereitstellt, die sie haben](/docs/de/tools-reference#task-tool-availability). Standardmäßig stellt Claude Code die Task-Tools `TaskCreate`, `TaskUpdate`, `TaskGet` und `TaskList` bereit. Setzen Sie auf `0`, um stattdessen das Legacy-`TodoWrite`-Tool zu erhalten. Siehe [Task-Liste](/docs/de/interactive-mode#task-list) |

290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Setzen Sie auf `1`, um OpenTelemetry-Datenerfassung für Metriken und Protokollierung zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Siehe [Monitoring](/docs/de/monitoring-usage) |293| `CLAUDE_CODE_ENABLE_TELEMETRY` | Setzen Sie auf `1`, um OpenTelemetry-Datenerfassung für Metriken und Protokollierung zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Siehe [Monitoring](/docs/de/monitoring-usage) |

291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Setzen Sie auf `1`, um die Task-Tracking-Tools auf jedem Modell zu erhalten. Ohne sie stellt Claude Code sie standardmäßig nur auf den Modellen bereit, die unter [Task-Tool-Verfügbarkeit](/docs/de/tools-reference#task-tool-availability) aufgelistet sind. `CLAUDE_CODE_ENABLE_TASKS` wählt immer noch die Task-Tools oder `TodoWrite`. Erfordert Claude Code v2.1.233 oder später |294| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Setzen Sie auf `1`, um die Task-Tracking-Tools auf jedem Modell zu erhalten. Ohne dies stellt Claude Code sie standardmäßig nur auf den Modellen bereit, die unter [Task-Tool-Verfügbarkeit](/docs/de/tools-reference#task-tool-availability) aufgelistet sind. `CLAUDE_CODE_ENABLE_TASKS` wählt immer noch die Task-Tools oder `TodoWrite`. Erfordert Claude Code v2.1.233 oder später |

292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Zeit in Millisekunden zum Warten, nachdem die Query-Schleife untätig wird, bevor automatisch beendet wird. Nützlich für automatisierte Workflows und Skripte, die SDK-Modus verwenden |295| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Zeit in Millisekunden zum Warten, nachdem die Query-Schleife untätig wird, bevor automatisch beendet wird. Nützlich für automatisierte Workflows und Skripte, die SDK-Modus verwenden |

293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Setzen Sie auf `1`, um [Agent-Teams](/docs/de/agent-teams) zu aktivieren. Agent-Teams sind experimentell und standardmäßig deaktiviert |296| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Setzen Sie auf `1`, um [Agent Teams](/docs/de/agent-teams) zu aktivieren. Agent Teams sind experimentell und standardmäßig deaktiviert |

294| `CLAUDE_CODE_EXTRA_BODY` | JSON-Objekt, das in die oberste Ebene jedes API-Request-Body zusammengeführt wird. Nützlich zum Übergeben von Provider-spezifischen Parametern, die Claude Code nicht direkt verfügbar macht. Ein Wert, der in Ihrer Shell exportiert wird, gilt auch für die [Hintergrund-Sitzungen](/docs/de/agent-view), die Sie mit `claude agents` oder `--bg` versenden. Vor v2.1.206 ignorierten Hintergrund-Sitzungen einen Shell-exportierten Wert und verwendeten, was die Hintergrund-Supervisor-Prozess geerbt hatte |297| `CLAUDE_CODE_EXTRA_BODY` | JSON-Objekt, das in die oberste Ebene jedes API-Request-Body zusammengeführt werden soll. Nützlich zum Übergeben von Provider-spezifischen Parametern, die Claude Code nicht direkt verfügbar macht. Ein Wert, der in Ihrer Shell exportiert wird, gilt auch für die [Hintergrund-Sitzungen](/docs/de/agent-view), die Sie mit `claude agents` oder `--bg` dispatchen. Vor v2.1.206 ignorierten Hintergrund-Sitzungen einen Shell-exportierten Wert und verwendeten, was die Hintergrund-Supervisor-Prozess erbte |

295| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Überschreiben Sie das Standard-Token-Limit für Datei-Lesevorgänge. Nützlich, wenn Sie größere Dateien vollständig lesen müssen |298| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Überschreiben Sie das Standard-Token-Limit für Datei-Lesevorgänge. Nützlich, wenn Sie größere Dateien vollständig lesen müssen |

296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Setzen Sie auf `1`, um Transkript-Persistenz, Prompt-Verlauf und `claude agents`-Registrierung zu erzwingen, auch wenn dieser `claude` von innen in einer anderen Claude Code-Sitzung gestartet wurde. Verwenden Sie, wenn ein geerbter `CLAUDE_CODE_CHILD_SESSION`-Wert, zum Beispiel von einer `screen`-Sitzung oder einem Hintergrund-Launcher, der zuerst von Claude Code's Bash-Tool gestartet wurde, eine echte Top-Level-Sitzung falsch klassifiziert. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert den geerbten Marker, daher braucht tmux diese Variable nicht mehr. Auch auf v2.1.169 und früher geehrt; hat keine Auswirkung auf v2.1.170 und v2.1.171, wo die verschachtelte Sitzungs-Erkennung, die es überschreibt, entfernt wurde |299| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Setzen Sie auf `1`, um Transkript-Persistenz, Prompt-Verlauf und `claude agents`-Registrierung zu erzwingen, auch wenn dieser `claude` von innen in einer anderen Claude Code-Sitzung gestartet wurde. Verwenden Sie, wenn ein vererbter `CLAUDE_CODE_CHILD_SESSION`-Wert, zum Beispiel von einer `screen`-Sitzung oder einem Hintergrund-Launcher, der zuerst von Claude Code's Bash-Tool gestartet wurde, verursacht, dass eine echte Top-Level-Sitzung als verschachtelt fehlklassifiziert wird. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert den vererbten Marker, daher braucht tmux diese Variable nicht mehr. Auch auf v2.1.169 und früher geehrt; hat keine Auswirkung auf v2.1.170 und v2.1.171, wo die verschachtelte Sitzungs-Erkennung, die es überschreibt, entfernt wurde |

297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Setzen Sie auf `1`, um Durchstreichungs-Rendering für `~~text~~` in Claude's Antworten zu erzwingen, wenn Ihr Terminal es unterstützt, aber nicht auto-erkannt wird, wie über SSH ohne `TERM_PROGRAM` weitergeleitet. Ohne dies zeigen nicht erkannte Terminals die wörtlichen `~~`-Marker statt den Text als Durchstreichung zu rendern. Erfordert Claude Code v2.1.186 oder später |300| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Setzen Sie auf `1`, um Durchstreichungs-Rendering für `~~text~~` in Claude's Antworten zu erzwingen, wenn Ihr Terminal es unterstützt, aber nicht auto-erkannt wird, wie über SSH ohne `TERM_PROGRAM` weitergeleitet. Ohne dies zeigen nicht erkannte Terminals die wörtlichen `~~`-Marker, anstatt den Text als Durchstreichung zu rendern. Erfordert Claude Code v2.1.186 oder später |

298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Setzen Sie auf `1`, um DEC-Privatmodus 2026 [synchronisierte Ausgabe](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) zu erzwingen, wenn Ihr Terminal es unterstützt, aber nicht auto-erkannt wird. Nützlich für Emulatoren wie Emacs `eat`, die BSU/ESU implementieren, aber nicht auf die Fähigkeits-Sonde antworten. Hat keine Auswirkung unter tmux. Im Gegensatz zu `CLAUDE_CODE_NO_FLICKER`, das zu [Vollbild-Rendering](/docs/de/fullscreen) wechselt, ändert dies nicht den Renderer |301| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Setzen Sie auf `1`, um DEC Private Mode 2026 [Synchronized Output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) zu erzwingen, wenn Ihr Terminal es unterstützt, aber nicht auto-erkannt wird. Nützlich für Emulatoren wie Emacs `eat`, die BSU/ESU implementieren, aber nicht auf die Capability-Probe antworten. Hat keine Auswirkung unter tmux. Im Gegensatz zu `CLAUDE_CODE_NO_FLICKER`, das zu [Vollbild-Rendering](/docs/de/fullscreen) wechselt, ändert dies nicht den Renderer |

299| `CLAUDE_CODE_FORK_SUBAGENT` | Steuert [Fork-Modus](/docs/de/sub-agents#turn-fork-mode-on-or-off), der Claude ermöglicht, [gegabelte Subagents](/docs/de/sub-agents#fork-the-current-conversation) selbst zu spawnen, und ist standardmäßig nur in interaktiven Sitzungen eingeschaltet. Setzen Sie auf `1`, um es auch in `claude -p` und dem Agent SDK einzuschalten, oder `0`, um es in jeder Art von Sitzung auszuschalten. Sie können `/subtask` ausführen, ob Fork-Modus eingeschaltet ist oder nicht. Der interaktive Standard erfordert Claude Code v2.1.232 oder später; auf früheren Versionen setzen Sie die Variable auf `1`, um Fork-Modus einzuschalten |302| `CLAUDE_CODE_FORK_SUBAGENT` | Steuert [Fork Mode](/docs/de/sub-agents#turn-fork-mode-on-or-off), das Claude [Forked Subagents](/docs/de/sub-agents#fork-the-current-conversation) selbst spawnen lässt und standardmäßig nur in interaktiven Sitzungen eingeschaltet ist. Setzen Sie auf `1`, um es auch in `claude -p` und dem Agent SDK einzuschalten, oder `0`, um es in jeder Art von Sitzung auszuschalten. Sie können `/subtask` ausführen, ob Fork Mode eingeschaltet ist oder nicht. Der interaktive Standard erfordert Claude Code v2.1.232 oder später; auf früheren Versionen setzen Sie die Variable auf `1`, um Fork Mode einzuschalten |

300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Setzen Sie auf `1`, um [Subagent](/docs/de/sub-agents)-Text- und Denk-Blöcke in `claude -p --output-format stream-json`-Ausgabe zu emittieren, das gleiche Verhalten wie das [`--forward-subagent-text`](/docs/de/cli-reference#cli-flags)-Flag. Verwenden Sie die Variable, wenn ein Harness `claude` aufruft und das Flag selbst nicht übergeben kann. Im Gegensatz zum Flag, das außerhalb des nicht-interaktiven Modus mit Stream-JSON-Ausgabe mit einem Fehler beendet wird, wird die Variable dort ignoriert, daher funktionieren verschachtelte Aufrufe weiter, wenn sie prozessweit gesetzt ist. Erfordert Claude Code v2.1.211 oder später |303| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Setzen Sie auf `1`, um [Subagent](/docs/de/sub-agents)-Text- und Thinking-Blöcke in `claude -p --output-format stream-json`-Ausgabe zu emittieren, das gleiche Verhalten wie das [`--forward-subagent-text`](/docs/de/cli-reference#cli-flags)-Flag. Verwenden Sie die Variable, wenn ein Harness `claude` aufruft und das Flag selbst nicht übergeben kann. Im Gegensatz zum Flag, das außerhalb des nicht-interaktiven Modus mit Stream-JSON-Ausgabe mit einem Fehler beendet wird, wird die Variable dort ignoriert, daher funktionieren verschachtelte Aufrufe weiter, wenn sie prozessweit gesetzt ist. Erfordert Claude Code v2.1.211 oder später |

301| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Setzen Sie auf `1`, um die [Gateway-Hint-Header](/docs/de/llm-gateway-protocol#gateway-hint-headers), wie `x-claude-code-request-class` und `x-claude-code-compaction`, auf einem benutzerdefinierten Proxy oder einem Drittanbieter-Provider wie Amazon Bedrock oder Claude Platform on AWS zu senden. Setzen Sie auf `0`, um sie auf jeder Verbindung zu stoppen, einschließlich einer direkten Verbindung zur Anthropic API, wo Claude Code sie standardmäßig sendet. Erfordert Claude Code v2.1.273 oder später |304| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Setzen Sie auf `1`, um die [Gateway-Hint-Header](/docs/de/llm-gateway-protocol#gateway-hint-headers), wie `x-claude-code-request-class` und `x-claude-code-compaction`, auf einem benutzerdefinierten Proxy oder einem Drittanbieter-Provider wie Amazon Bedrock oder Claude Platform on AWS zu senden. Setzen Sie auf `0`, um sie auf jeder Verbindung zu stoppen, einschließlich einer direkten Verbindung zur Anthropic API, wo Claude Code sie standardmäßig sendet. Erfordert Claude Code v2.1.273 oder später |

302| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in Millisekunden für die [Gateway-Modell-Erkennungs](/docs/de/llm-gateway-protocol#model-discovery)-Anfrage, die `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` einschaltet (Standard: `3000`). Erhöhen Sie es, wenn Ihr Gateway länger als drei Sekunden braucht, um `/v1/models` beim Startup zu beantworten. Akzeptiert nur einfache Ziffern; `0`, negative Werte und andere Schreibweisen behalten den Standard. Erfordert Claude Code v2.1.269 oder später |305| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in Millisekunden für die [Gateway-Modell-Erkennungs](/docs/de/llm-gateway-protocol#model-discovery)-Anfrage, die `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` einschaltet (Standard: `3000`). Erhöhen Sie dies, wenn Ihr Gateway länger als drei Sekunden braucht, um `/v1/models` beim Start zu beantworten. Akzeptiert nur einfache Ziffern; `0`, negative Werte und andere Schreibweisen behalten den Standard. Erfordert Claude Code v2.1.269 oder später |

303| `CLAUDE_CODE_GIT_BASH_PATH` | Nur Windows: Pfad zur Git Bash-Ausführungsdatei (`bash.exe`). Verwenden Sie, wenn Git Bash installiert ist, aber nicht in Ihrem PATH. Wenn der Pfad nicht existiert oder die Datei nicht `bash.exe`, `sh.exe`, `bash` oder `sh` heißt, ignoriert Claude Code die Variable und auto-erkennt Git Bash, als ob sie nicht gesetzt wäre, und protokolliert eine Warnung, die mit `--debug` sichtbar ist. Vor v2.1.219 beendete Claude Code beim Startup, wenn der Pfad nicht existierte, und verwendete jede existierende Datei als Shell, ohne zu überprüfen, dass sie bash oder sh war. Siehe [Windows-Setup](/docs/de/setup#set-up-on-windows) |306| `CLAUDE_CODE_GIT_BASH_PATH` | Nur Windows: Pfad zur Git Bash-Ausführungsdatei (`bash.exe`). Verwenden Sie, wenn Git Bash installiert ist, aber nicht in Ihrem PATH. Wenn der Pfad nicht existiert oder die Datei nicht `bash.exe`, `sh.exe`, `bash` oder `sh` heißt, ignoriert Claude Code die Variable und auto-erkennt Git Bash, als ob sie nicht gesetzt wäre, und protokolliert eine Warnung, die mit `--debug` sichtbar ist. Vor v2.1.219 beendete Claude Code beim Start, wenn der Pfad nicht existierte, und verwendete jede existierende Datei als Shell, ohne zu überprüfen, dass sie bash oder sh war. Siehe [Windows-Setup](/docs/de/setup#set-up-on-windows) |

304| `CLAUDE_CODE_GLOB_HIDDEN` | Setzen Sie auf `false`, um Dotfiles aus Ergebnissen auszuschließen, wenn Claude das [Glob-Tool](/docs/de/tools-reference#glob-tool-behavior) aufruft. Standardmäßig enthalten. Betrifft nicht `@`-Datei-Autovervollständigung, `ls`, Grep oder Read |307| `CLAUDE_CODE_GLOB_HIDDEN` | Setzen Sie auf `false`, um Dotfiles aus Ergebnissen auszuschließen, wenn Claude das [Glob-Tool](/docs/de/tools-reference#glob-tool-behavior) aufruft. Standardmäßig enthalten. Betrifft nicht `@`-Datei-Autovervollständigung, `ls`, Grep oder Read |

305| `CLAUDE_CODE_GLOB_NO_IGNORE` | Setzen Sie auf `false`, um das [Glob-Tool](/docs/de/tools-reference#glob-tool-behavior) `.gitignore`-Muster respektieren zu lassen. Standardmäßig gibt Glob alle übereinstimmenden Dateien zurück, einschließlich gitignorierter. Betrifft nicht `@`-Datei-Autovervollständigung, die ihre eigene [`respectGitignore`-Einstellung](/docs/de/settings-reference#respectgitignore) hat |308| `CLAUDE_CODE_GLOB_NO_IGNORE` | Setzen Sie auf `false`, um das [Glob-Tool](/docs/de/tools-reference#glob-tool-behavior) `.gitignore`-Muster respektieren zu lassen. Standardmäßig gibt Glob alle übereinstimmenden Dateien zurück, einschließlich gitignorierter. Betrifft nicht `@`-Datei-Autovervollständigung, die ihre eigene [`respectGitignore`-Einstellung](/docs/de/settings-reference#respectgitignore) hat |

306| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in Sekunden für Glob-Tool-Datei-Erkennung. Standard 20 Sekunden auf den meisten Plattformen und 60 Sekunden auf WSL |309| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in Sekunden für Glob-Tool-Datei-Erkennung. Standardmäßig 20 Sekunden auf den meisten Plattformen und 60 Sekunden auf WSL |

307| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Wie viele Minuten Hintergrundarbeit ein aktives Ziel warten lassen kann, bevor Claude Code [Claude bittet, es zu überprüfen](/docs/de/goal#background-work-defers-evaluation). Standard `30`. Setzen Sie `0`, um Check-ins auszuschalten. Geben Sie ganze Minuten in einfachen Ziffern an, höchstens `10080`, was eine Woche ist. Claude Code behandelt jeden anderen Wert als nicht gesetzt und verwendet den Standard. Erfordert Claude Code v2.1.234 oder später |310| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Wie viele Minuten Hintergrundarbeit ein aktives Ziel warten lassen kann, bevor Claude Code [Claude bittet, es zu überprüfen](/docs/de/goal#background-work-defers-evaluation). Standard `30`. Setzen Sie `0`, um Check-Ins auszuschalten. Geben Sie ganze Minuten in einfachen Ziffern an, höchstens `10080`, was eine Woche ist. Claude Code behandelt jeden anderen Wert als nicht gesetzt und verwendet den Standard. Erfordert Claude Code v2.1.234 oder später |

308| `CLAUDE_CODE_HIDE_CWD` | Setzen Sie auf `1`, um das Arbeitsverzeichnis im Startup-Logo zu verbergen. Nützlich für Screenshares oder Aufzeichnungen, wo der Pfad Ihren OS-Benutzernamen offenlegt |311| `CLAUDE_CODE_HIDE_CWD` | Setzen Sie auf `1`, um das Arbeitsverzeichnis im Startup-Logo zu verbergen. Nützlich für Screenshares oder Aufzeichnungen, wo der Pfad Ihren OS-Benutzernamen offenlegt |

309| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Überschreiben Sie die Host-Adresse, die zum Verbinden mit der IDE-Erweiterung verwendet wird. Standardmäßig auto-erkennt Claude Code die richtige Adresse, einschließlich WSL-zu-Windows-Routing |312| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Überschreiben Sie die Host-Adresse, die zum Verbinden mit der IDE-Erweiterung verwendet wird. Standardmäßig auto-erkennt Claude Code die richtige Adresse, einschließlich WSL-zu-Windows-Routing |

310| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Setzen Sie auf `1`, um die Auto-Installation von IDE-Erweiterungen zu überspringen. Entspricht dem Setzen von [`autoInstallIdeExtension`](/docs/de/settings-reference#autoinstallideextension) auf `false` |313| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Setzen Sie auf `1`, um die Auto-Installation von IDE-Erweiterungen zu überspringen. Äquivalent zum Setzen von [`autoInstallIdeExtension`](/docs/de/settings-reference#autoinstallideextension) auf `false` |

311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Setzen Sie auf `1`, um die Validierung von IDE-Lockfile-Einträgen während der Verbindung zu überspringen. Verwenden Sie, wenn Auto-Connect Ihre IDE nicht findet, obwohl sie läuft |314| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Setzen Sie auf `1`, um die Validierung von IDE-Lockfile-Einträgen während der Verbindung zu überspringen. Verwenden Sie, wenn Auto-Connect Ihre IDE nicht findet, obwohl sie läuft |

312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Wie viele [Subagents](/docs/de/sub-agents#concurrent-subagent-limit) in einer Sitzung laufen können, bevor das Agent-Tool sich weigert, einen anderen zu spawnen (Standard: 20). Akzeptiert eine positive ganze Zahl in einfachen Ziffern; alles andere wird ignoriert, daher kann die Variable die Obergrenze anpassen, aber nicht deaktivieren. Erfordert Claude Code v2.1.217 oder später |315| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Wie viele [Subagents](/docs/de/sub-agents#concurrent-subagent-limit) in einer Sitzung laufen können, bevor das Agent-Tool sich weigert, einen anderen zu spawnen (Standard: 20). Akzeptiert eine positive ganze Zahl in einfachen Ziffern; alles andere wird ignoriert, daher kann die Variable die Obergrenze anpassen, aber nicht deaktivieren. Erfordert Claude Code v2.1.217 oder später |

313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreiben Sie die Kontext-Fenster-Größe, die Claude Code für das aktive Modell annimmt. Ab v2.1.193 hängt, wie es angewendet wird, davon ab, wie Claude Code die Modell-ID auflöst; siehe [Fenster für eine Gateway- oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Verwenden Sie dies beim Routing zu einem Modell durch `ANTHROPIC_BASE_URL`, dessen Kontext-Fenster nicht der integrierten Größe für seinen Namen entspricht |316| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreiben Sie die Kontext-Fenster-Größe, die Claude Code für das aktive Modell annimmt. Ab v2.1.193 hängt, wie es angewendet wird, davon ab, wie Claude Code die Modell-ID auflöst; siehe [Fenster für eine Gateway- oder benutzerdefinierte Modell-ID korrigieren](/docs/de/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Verwenden Sie dies beim Routing zu einem Modell durch `ANTHROPIC_BASE_URL`, dessen Kontext-Fenster nicht der integrierten Größe für seinen Namen entspricht |

314| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Maximale Länge in Zeichen jeder MCP-Tool-Beschreibung und jeder MCP-Server-Anweisungen, die Claude Code an das Modell sendet (Standard: 2048). Claude Code [kürzt längeren Text](/docs/de/mcp#for-mcp-server-authors). Akzeptiert eine positive ganze Zahl in einfachen Ziffern. Alles andere wird ignoriert und der Standard gilt. Erfordert Claude Code v2.1.280 oder später |317| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Maximale Länge in Zeichen jeder MCP-Tool-Beschreibung und jeder MCP-Server-Anweisungen, die Claude Code an das Modell sendet (Standard: 2048). Claude Code [kürzt längeren Text](/docs/de/mcp#for-mcp-server-authors). Akzeptiert eine positive ganze Zahl in einfachen Ziffern. Alles andere wird ignoriert und der Standard gilt. Erfordert Claude Code v2.1.280 oder später |

315| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Setzen Sie die maximale Anzahl von Output-Tokens für die meisten Anfragen. Standardwerte und Obergrenzen variieren je nach Modell; siehe [Max Output Tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code setzt den Standard auf 32000 für Modell-IDs, die es nicht erkennt, wie Gateway-spezifische Namen, und senkt Werte über einer Modell-Obergrenze auf die Obergrenze. Das Erhöhen dieses Wertes reduziert das verfügbare effektive Kontext-Fenster, bevor [Auto-Compaction](/docs/de/costs#reduce-token-usage) ausgelöst wird |318| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Setzen Sie die maximale Anzahl von Output-Tokens für die meisten Anfragen. Standardwerte und Obergrenzen variieren je nach Modell; siehe [Max Output Tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code standardmäßig auf 32000 für Modell-IDs, die es nicht erkennt, wie Gateway-spezifische Namen, und senkt Werte über einer Modell-Obergrenze auf die Obergrenze. Das Erhöhen dieses Wertes reduziert das verfügbare effektive Kontext-Fenster, bevor [Auto-Compaction](/docs/de/costs#reduce-token-usage) ausgelöst wird |

316| `CLAUDE_CODE_MAX_RETRIES` | Überschreiben Sie die Anzahl der Wiederholungen fehlgeschlagener API-Anfragen (Standard: 10). Begrenzt auf 15 ab v2.1.186; ab v2.1.199 hebt `CLAUDE_CODE_RETRY_WATCHDOG` den Standard an und entfernt die Obergrenze. Für unbeaufsichtigte Sitzungen, die längere Ausfallzeiten abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |319| `CLAUDE_CODE_MAX_RETRIES` | Überschreiben Sie die Anzahl der Versuche, fehlgeschlagene API-Anfragen zu wiederholen (Standard: 10). Begrenzt auf 15 ab v2.1.186; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standard und entfernt die Obergrenze. Für unbeaufsichtigte Sitzungen, die längere Ausfallzeiten abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |

317| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Entfernt in v2.1.224 und jetzt ein No-Op. Begrenzte zuvor die Gesamtzahl der [Subagents](/docs/de/sub-agents), die Claude mit dem Agent-Tool in einer Sitzung spawnen konnte (Standard: 200); Spawning über die Obergrenze hinaus schlägt mit `Subagent spawn limit reached` fehl. Die [gleichzeitige Subagent-Obergrenze](/docs/de/sub-agents#concurrent-subagent-limit) und die [Tiefenbegrenzung](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) gelten immer noch |320| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Entfernt in v2.1.224 und jetzt ein No-Op. Begrenzte zuvor die Gesamtzahl der [Subagents](/docs/de/sub-agents), die Claude mit dem Agent-Tool in einer Sitzung spawnen konnte (Standard: 200); Spawning über die Obergrenze hinaus schlägt mit `Subagent spawn limit reached` fehl. Die [Concurrent Subagent Limit](/docs/de/sub-agents#concurrent-subagent-limit) und die [Depth Limit](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) gelten immer noch |

318| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Anzahl der [Subagent-Schichten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) unter der Hauptkonversation (Standard: 3). Bei dem Standard können Subagents ihre eigenen spawnen, und ein Subagent in der dritten Schicht kann nicht weiter spawnen; setzen Sie `1`, um Verschachtelung auszuschalten. In v2.1.217 bis v2.1.218 war der Standard 1, daher konnte ein Subagent sein eigenes nicht spawnen, es sei denn, Sie erhöhten die Obergrenze; v2.1.219 erhöhte den Standard auf 3. Akzeptiert eine positive ganze Zahl in einfachen Ziffern; alles andere wird ignoriert, daher kann die Obergrenze angepasst, aber nicht entfernt werden. Erfordert Claude Code v2.1.217 oder später |321| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Anzahl der [Subagent-Schichten](/docs/de/sub-agents#let-subagents-spawn-their-own-subagents) unter der Hauptkonversation (Standard: 3). Bei dem Standard können Subagents ihre eigenen spawnen, und ein Subagent in der dritten Schicht kann nicht weiter spawnen; setzen Sie `1`, um Verschachtelung auszuschalten. In v2.1.217 bis v2.1.218 war der Standard 1, daher konnte ein Subagent nicht sein eigenes spawnen, es sei denn, Sie erhöhten die Obergrenze; v2.1.219 erhöhte den Standard auf 3. Akzeptiert eine positive ganze Zahl in einfachen Ziffern; alles andere wird ignoriert, daher kann die Obergrenze angepasst, aber nicht entfernt werden. Erfordert Claude Code v2.1.217 oder später |

319| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl von Read-Only-Tools und Subagents, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen Parallelismus, verbrauchen aber mehr Ressourcen |322| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl von Read-Only-Tools und Subagents, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen Parallelismus, verbrauchen aber mehr Ressourcen |

320| `CLAUDE_CODE_MAX_TURNS` | Begrenzen Sie die Anzahl der agentic Turns, wenn keine explizite Obergrenze übergeben wird. Entspricht dem Übergeben von [`--max-turns`](/docs/de/cli-reference#cli-flags), das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive Ganzzahl ist, wird beim Startup mit einem Fehler abgelehnt, anstatt als keine Obergrenze behandelt zu werden |323| `CLAUDE_CODE_MAX_TURNS` | Begrenzen Sie die Anzahl der Agentic Turns, wenn keine explizite Obergrenze übergeben wird. Äquivalent zum Übergeben von [`--max-turns`](/docs/de/cli-reference#cli-flags), das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive Ganzzahl ist, wird beim Start mit einem Fehler abgelehnt, anstatt als keine Obergrenze behandelt zu werden |

321| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Obergrenze für die Gesamtzahl der [WebSearch](/docs/de/tools-reference#websearch-tool-behavior)-Aufrufe, die eine Sitzung machen kann (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe eine Mitteilung zurück, die Claude sagt, mit den Informationen fortzufahren, die es bereits gesammelt hat. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert und der Standard gilt, daher kann die Obergrenze erhöht, aber nicht ausgeschaltet werden. Erfordert Claude Code v2.1.212 oder später |324| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Obergrenze für die Gesamtzahl der [WebSearch](/docs/de/tools-reference#websearch-tool-behavior)-Aufrufe, die eine Sitzung machen kann (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe eine Benachrichtigung zurück, die Claude sagt, mit den Informationen fortzufahren, die es bereits gesammelt hat. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert und der Standard gilt, daher kann die Obergrenze erhöht, aber nicht ausgeschaltet werden. Erfordert Claude Code v2.1.212 oder später |

322| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Setzen Sie auf `1`, um stdio MCP-Server mit nur einer sicheren Baseline-Umgebung plus der konfigurierten `env` des Servers zu spawnen, anstatt Ihre Shell-Umgebung zu erben |325| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Setzen Sie auf `1`, um stdio MCP-Server mit nur einer sicheren Baseline-Umgebung plus der konfigurierten `env` des Servers zu spawnen, anstatt Ihre Shell-Umgebung zu erben |

323| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Verstrichene Zeit in Millisekunden, bevor ein noch laufender MCP-Tool-Aufruf [zu einer Hintergrund-Aufgabe wechselt](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) (Standard: 120000 oder 2 Minuten). Setzen Sie auf `0`, um automatisches Backgrounding auszuschalten. Erfordert Claude Code v2.1.212 oder später |326| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Verstrichene Zeit in Millisekunden, bevor ein noch laufender MCP-Tool-Aufruf [zu einer Hintergrund-Aufgabe wechselt](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) (Standard: 120000 oder 2 Minuten). Setzen Sie auf `0`, um automatisches Backgrounding auszuschalten. Erfordert Claude Code v2.1.212 oder später |

324| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Wie lange in Millisekunden der erste Turn einer [nicht-interaktiven](/docs/de/headless)-Sitzung auf MCP-Server wartet, die noch verbinden, anstelle des Standard-[First-Turn-Waits](/docs/de/agent-sdk/mcp#connection-timing). Wenn gesetzt, deckt das Warten jeden ausstehenden Server ab. Setzen Sie auf `0`, um das Warten zu überspringen. Ein [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Server behält sein eigenes `MCP_TIMEOUT`-Warten unabhängig vom Wert. Erfordert Claude Code v2.1.274 oder später |327| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Wie lange in Millisekunden der erste Turn einer [nicht-interaktiven](/docs/de/headless)-Sitzung auf MCP-Server wartet, die noch verbinden, anstelle des Standard-[First-Turn-Waits](/docs/de/agent-sdk/mcp#connection-timing). Wenn gesetzt, deckt das Warten jeden ausstehenden Server ab. Setzen Sie auf `0`, um das Warten zu überspringen. Ein [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Server behält sein eigenes `MCP_TIMEOUT`-Warten unabhängig vom Wert. Erfordert Claude Code v2.1.274 oder später |

325| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Idle-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai)-MCP-Server für diese lange keine Antwort und keine Fortschritts-Benachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, anstatt auf das gesamte `MCP_TOOL_TIMEOUT` zu warten. Überschreibt die Pro-Transport-Standards von 300000 (5 Minuten) für Netzwerk-Server und 1800000 (30 Minuten) für stdio-Server. Setzen Sie auf `0`, um die Idle-Prüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde erhöht, und der Wert ist auf das effektive `MCP_TOOL_TIMEOUT` begrenzt. Ein Pro-Server-`timeout` in `.mcp.json` von mindestens 1000 erhöht das Idle-Fenster dieses Servers auf mindestens den `timeout`-Wert. Gilt nicht für IDE-Server oder SDK In-Process-Server. Erfordert Claude Code v2.1.187 oder später. Vor v2.1.203 waren stdio-Server von dem Idle-Timeout ausgenommen |328| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Idle-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai)-MCP-Server diese lange keine Antwort und keine Fortschritts-Benachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, anstatt auf das Gesamt-`MCP_TOOL_TIMEOUT` zu warten. Überschreibt die Pro-Transport-Standards von 300000 (5 Minuten) für Netzwerk-Server und 1800000 (30 Minuten) für stdio-Server. Setzen Sie auf `0`, um die Idle-Prüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde erhöht, und der Wert ist auf das effektive `MCP_TOOL_TIMEOUT` begrenzt. Ein Pro-Server-`timeout` in `.mcp.json` von mindestens 1000 erhöht das Idle-Fenster dieses Servers auf mindestens den `timeout`-Wert. Gilt nicht für IDE-Server oder SDK In-Process-Server. Erfordert Claude Code v2.1.187 oder später. Vor v2.1.203 waren stdio-Server von dem Idle-Timeout ausgenommen |

326| `CLAUDE_CODE_MESSAGING_SOCKET` | Wird von Claude Code gesetzt, nicht von Ihnen: in Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code den Pfad dieses Sockets zu Hooks und Bash-Befehlen, wenn es den Socket bindet. In einer Sitzung, die mit Messaging startet, bindet Claude Code den Socket, bevor ein Hook läuft. Andere Sitzungen auf der Maschine liefern Nachrichten an diesen Pfad. Jede Sitzung exportiert ihren eigenen Socket, anstatt einen von einem übergeordneten zu erben, und Nachrichten, die darauf ankommen, gehen durch die [Inbound-Kontrollen](/docs/de/cross-session-messaging#control-inbound-messages) der Sitzung. Einstellungs-`env`-Blöcke können es nicht setzen. Erfordert Claude Code v2.1.224 oder später |329| `CLAUDE_CODE_MESSAGING_SOCKET` | Wird von Claude Code gesetzt, nicht von Ihnen: in Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code den Pfad dieses Sockets zu Hooks und Bash-Befehlen, wenn es den Socket bindet. In einer Sitzung, die mit Messaging startet, bindet Claude Code den Socket, bevor ein Hook läuft. Andere Sitzungen auf der Maschine liefern Nachrichten an diesen Pfad. Jede Sitzung exportiert ihren eigenen Socket, anstatt einen von einem übergeordneten zu erben, und Nachrichten, die auf ihm ankommen, gehen durch die [Inbound-Kontrollen](/docs/de/cross-session-messaging#control-inbound-messages) der Sitzung. Einstellungs-`env`-Blöcke können es nicht setzen. Erfordert Claude Code v2.1.224 oder später |

327| `CLAUDE_CODE_MESSAGING_TOKEN` | Wird von Claude Code gesetzt, nicht von Ihnen: in Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code diesen Pro-Sitzungs-Token zu Hooks und Bash-Befehlen neben `CLAUDE_CODE_MESSAGING_SOCKET`. Ein Skript, das zum Socket postet, kann `{"type":"auth","token":"<token>"}` als erste Zeile senden, um zu beweisen, dass es zur Sitzung gehört. Auf nativem Windows erfordert Claude Code diese Zeile und schließt jede Verbindung, die nicht mit einer gültigen öffnet. Die [Own-Child-Regeln](/docs/de/cross-session-messaging#the-sessions-inbox-socket) sagen, wann Claude Code den Token konsultiert. Jede Sitzung exportiert ihren eigenen Token, nie einen von einer übergeordneten Sitzung geerbt. Einstellungs-`env`-Blöcke können es nicht setzen. Erfordert Claude Code v2.1.228 oder später |330| `CLAUDE_CODE_MESSAGING_TOKEN` | Wird von Claude Code gesetzt, nicht von Ihnen: in Sitzungen, die einen [Inbox-Socket](/docs/de/cross-session-messaging#the-sessions-inbox-socket) binden, exportiert Claude Code diesen Pro-Sitzungs-Token zu Hooks und Bash-Befehlen neben `CLAUDE_CODE_MESSAGING_SOCKET`. Ein Skript, das zum Socket postet, kann `{"type":"auth","token":"<token>"}` als erste Zeile senden, um zu beweisen, dass es zur Sitzung gehört. Auf nativem Windows erfordert Claude Code diese Zeile und schließt jede Verbindung, die nicht mit einem gültigen öffnet. Die [Own-Child-Regeln](/docs/de/cross-session-messaging#the-sessions-inbox-socket) sagen, wann Claude Code den Token konsultiert. Jede Sitzung exportiert ihren eigenen Token, nie einen von einer übergeordneten Sitzung geerbt. Einstellungs-`env`-Blöcke können es nicht setzen. Erfordert Claude Code v2.1.228 oder später |

328| `CLAUDE_CODE_NATIVE_CURSOR` | Setzen Sie auf `1`, um den eigenen Cursor des Terminals an der Eingabe-Einfügemarke anzuzeigen, anstatt eines gezeichneten Blocks. Der Cursor respektiert die Blink-, Form- und Fokus-Einstellungen des Terminals |331| `CLAUDE_CODE_NATIVE_CURSOR` | Setzen Sie auf `1`, um den eigenen Cursor des Terminals bei der Eingabe-Einfügemarke anzuzeigen, anstatt eines gezeichneten Blocks. Der Cursor respektiert die Blink-, Form- und Fokus-Einstellungen des Terminals |

329| `CLAUDE_CODE_NEW_INIT` | Setzen Sie auf `1`, um `/init` einen interaktiven Setup-Flow ausführen zu lassen. Der Flow fragt, welche Dateien generiert werden sollen, einschließlich CLAUDE.md, Skills und Hooks, bevor die Codebasis erkundet und sie geschrieben werden. Ohne diese Variable generiert `/init` automatisch eine CLAUDE.md ohne zu fragen |332| `CLAUDE_CODE_NEW_INIT` | Setzen Sie auf `1`, um `/init` einen interaktiven Setup-Flow ausführen zu lassen. Der Flow fragt, welche Dateien generiert werden sollen, einschließlich CLAUDE.md, Skills und Hooks, bevor die Codebasis erkundet und geschrieben wird. Ohne diese Variable generiert `/init` automatisch eine CLAUDE.md ohne zu fragen |

330| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Setzen Sie auf `1`, um Terminal-Ausgabe durch einen zweiten nicht-blockierenden Datei-Deskriptor zu schreiben, daher kann ein Terminal, das aufhört zu lesen, wie ein pausierter tmux-Control-Mode-Pane oder eine steckengebliebene SSH-Verbindung, Claude Code nicht mid-session einfrieren. Gilt auf macOS, Linux und WSL, wenn stdout ein Terminal ist. Erfordert Claude Code v2.1.261 oder später |333| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Setzen Sie auf `1`, um Terminal-Ausgabe durch einen zweiten nicht-blockierenden Datei-Deskriptor zu schreiben, daher kann ein Terminal, das nicht mehr liest, wie ein pausierter tmux Control-Mode-Pane oder eine steckengebliebene SSH-Verbindung, Claude Code nicht mid-session einfrieren. Gilt auf macOS, Linux und WSL, wenn stdout ein Terminal ist. Erfordert Claude Code v2.1.261 oder später |

331| `CLAUDE_CODE_NO_FLICKER` | Setzen Sie auf `1`, um [Vollbild-Rendering](/docs/de/fullscreen) zu aktivieren, eine Forschungs-Vorschau, die Flimmern reduziert und Speicher in langen Konversationen flach hält. Überschreibt die [`tui`](/docs/de/settings-reference#tui)-Einstellung; Sie können auch mit `/tui fullscreen` wechseln |334| `CLAUDE_CODE_NO_FLICKER` | Setzen Sie auf `1`, um [Vollbild-Rendering](/docs/de/fullscreen) zu aktivieren, eine Forschungsvorschau, die Flimmern reduziert und den Speicher in langen Konversationen flach hält. Überschreibt die [`tui`](/docs/de/settings-reference#tui)-Einstellung; Sie können auch mit `/tui fullscreen` wechseln |

332| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth-Refresh-Token für Claude.ai-Authentifizierung. Wenn gesetzt, tauscht `claude auth login` diesen Token direkt aus, anstatt einen Browser zu öffnen. Erfordert `CLAUDE_CODE_OAUTH_SCOPES`. Nützlich für die Bereitstellung von Authentifizierung in automatisierten Umgebungen |335| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth-Refresh-Token für Claude.ai-Authentifizierung. Wenn gesetzt, tauscht `claude auth login` diesen Token direkt aus, anstatt einen Browser zu öffnen. Erfordert `CLAUDE_CODE_OAUTH_SCOPES`. Nützlich für die Bereitstellung von Authentifizierung in automatisierten Umgebungen |

333| `CLAUDE_CODE_OAUTH_SCOPES` | Leerzeichen-getrennte OAuth-Scopes, mit denen der Refresh-Token ausgestellt wurde, wie `"user:profile user:inference user:sessions:claude_code"`. Erforderlich, wenn `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` gesetzt ist |336| `CLAUDE_CODE_OAUTH_SCOPES` | Leerzeichen-getrennte OAuth-Scopes, mit denen der Refresh-Token ausgestellt wurde, wie `"user:profile user:inference user:sessions:claude_code"`. Erforderlich, wenn `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` gesetzt ist |

334| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth-Zugriffstoken für claude.ai-Authentifizierung. Alternative zu `/login` für SDK und automatisierte Umgebungen. Hat Vorrang vor Keychain-gespeicherten Anmeldedaten. Generieren Sie eines mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token). Wenn Sie nicht [`/login`](/docs/de/authentication#authentication-precedence) ausführen, verwendet Claude Code das Token, das Sie für die ganze Sitzung setzen. Um ein abgelaufenes Token zu ersetzen, generieren Sie ein neues und starten Sie neu |337| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth-Zugriffstoken für claude.ai-Authentifizierung. Alternative zu `/login` für SDK und automatisierte Umgebungen. Hat Vorrang vor Keychain-gespeicherten Credentials. Generieren Sie eines mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token). Wenn Sie nicht [`/login`](/docs/de/authentication#authentication-precedence) ausführen, verwendet Claude Code das Token, das Sie für die ganze Sitzung setzen. Um ein abgelaufenes Token zu ersetzen, generieren Sie ein neues und starten Sie neu |

335| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Entfernt in v2.1.160 und jetzt ein No-Op. Heftete zuvor [Fast Mode](/docs/de/fast-mode) auf Claude Opus 4.6 statt des aktuellen Standards. Opus 4.6 unterstützt Fast Mode nicht mehr |338| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Entfernt in v2.1.160 und jetzt ein No-Op. Heftete zuvor [Fast Mode](/docs/de/fast-mode) auf Claude Opus 4.6 an, anstelle des aktuellen Standards. Opus 4.6 unterstützt Fast Mode nicht mehr |

336| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Maximale Länge von Content-tragenden OpenTelemetry-Attributen (Modell-Antworten, Tool-Inhalt, System-Prompts, rohe API-Bodies), Kürzungs-Marker enthalten, in UTF-16-Code-Einheiten (Standard: 61440, d.h. 60 KB). Erhöhen Sie es nur, wenn Ihr Telemetrie-Backend Attribut-Werte größer als 64 KB akzeptiert, oder senken Sie es, um Telemetrie-Volumen zu reduzieren. Erfordert Claude Code v2.1.214 oder später. Siehe [Monitoring](/docs/de/monitoring-usage) |339| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Maximale Länge von Content-tragenden OpenTelemetry-Attributen (Modell-Antworten, Tool-Inhalt, System-Prompts, rohe API-Bodies), Kürzungs-Marker enthalten, in UTF-16-Code-Einheiten (Standard: 61440, d.h. 60 KB). Erhöhen Sie es nur, wenn Ihr Telemetrie-Backend Attribut-Werte größer als 64 KB akzeptiert, oder senken Sie es, um Telemetrie-Volumen zu reduzieren. Erfordert Claude Code v2.1.214 oder später. Siehe [Monitoring](/docs/de/monitoring-usage) |

337| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Setzen Sie auf `1`, um OpenTelemetry-Exporter-Diagnose-Fehler auf stderr zu schreiben. Standardmäßig erscheinen diese Fehler nur mit `--debug`, daher schlägt ein falsch konfigurierter Exporter wie eine Prometheus-Port-Kollision andernfalls stillschweigend fehl. Erfordert Claude Code v2.1.179 oder später. Siehe [Monitoring](/docs/de/monitoring-usage) |340| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Setzen Sie auf `1`, um OpenTelemetry-Exporter-Diagnose-Fehler zu stderr zu schreiben. Standardmäßig erscheinen diese Fehler nur mit `--debug`, daher schlägt ein fehlkonfigurierter Exporter wie eine Prometheus-Port-Kollision andernfalls stillschweigend fehl. Erfordert Claude Code v2.1.179 oder später. Siehe [Monitoring](/docs/de/monitoring-usage) |

338| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in Millisekunden zum Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe [Monitoring](/docs/de/monitoring-usage) |341| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in Millisekunden zum Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe [Monitoring](/docs/de/monitoring-usage) |

339| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer OpenTelemetry-Header in Millisekunden (Standard: 1740000 / 29 Minuten). Siehe [Dynamische Header](/docs/de/monitoring-usage#dynamic-headers) |342| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer OpenTelemetry-Header in Millisekunden (Standard: 1740000 / 29 Minuten). Siehe [Dynamic Headers](/docs/de/monitoring-usage#dynamic-headers) |

340| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in Millisekunden für den OpenTelemetry-Exporter zum Beenden beim Herunterfahren (Standard: 2000). Erhöhen Sie, wenn Metriken beim Beenden gelöscht werden. Siehe [Monitoring](/docs/de/monitoring-usage) |343| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in Millisekunden für den OpenTelemetry-Exporter zum Beenden beim Herunterfahren (Standard: 2000). Erhöhen Sie, wenn Metriken beim Beenden gelöscht werden. Siehe [Monitoring](/docs/de/monitoring-usage) |

341| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Setzen Sie auf `1`, um Claude Code Ihren Package-Manager's Upgrade-Befehl im Hintergrund ausführen zu lassen, wenn eine neue Version verfügbar ist. Gilt für Homebrew- und WinGet-Installationen. Andere Package-Manager zeigen weiterhin den Upgrade-Befehl ohne Ausführung. Siehe [Auto-Updates](/docs/de/setup#auto-updates) |344| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Setzen Sie auf `1`, um Claude Code Ihren Package Manager's Upgrade-Befehl im Hintergrund ausführen zu lassen, wenn eine neue Version verfügbar ist. Gilt für Homebrew und WinGet-Installationen. Andere Package Manager zeigen weiterhin den Upgrade-Befehl ohne Ausführung. Siehe [Auto-Updates](/docs/de/setup#auto-updates) |

342| `CLAUDE_CODE_PERFORCE_MODE` | Setzen Sie auf `1`, um Perforce-bewussten Schreib-Schutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit mit einem `p4 edit <file>`-Hinweis fehl, wenn die Zieldatei das Owner-Write-Bit nicht hat, das Perforce bei synced Dateien löscht, bis `p4 edit` sie öffnet. Dies verhindert, dass Claude Code Perforce-Change-Tracking umgeht |345| `CLAUDE_CODE_PERFORCE_MODE` | Setzen Sie auf `1`, um Perforce-bewussten Schreibschutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit mit einem `p4 edit <file>`-Hinweis fehl, wenn die Zieldatei das Owner-Write-Bit nicht hat, das Perforce bei synced Dateien löscht, bis `p4 edit` sie öffnet. Dies verhindert, dass Claude Code Perforce-Change-Tracking umgeht |

343| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Überschreiben Sie das Plugins-Root-Verzeichnis. Trotz des Namens setzt dies das übergeordnete Verzeichnis, nicht den Cache selbst: Marketplaces und der Plugin-Cache leben in Unterverzeichnissen unter diesem Pfad. Standard ist `~/.claude/plugins` |346| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Überschreiben Sie das Plugins-Root-Verzeichnis. Trotz des Namens setzt dies das übergeordnete Verzeichnis, nicht den Cache selbst: Marketplaces und der Plugin-Cache leben in Unterverzeichnissen unter diesem Pfad. Standardmäßig `~/.claude/plugins` |

344| `CLAUDE_CODE_PLUGIN_DIRS` | Plugin-Verzeichnisse zum Laden für die Sitzung, jedes geladen wie ein [`--plugin-dir`](/docs/de/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)-Flag es lädt. Trennen Sie mehrere Pfade mit `:` auf Unix oder `;` auf Windows. Geben Sie jeden Pfad als absoluten Pfad an oder starten Sie ihn mit `~`, weil Claude Code relative Pfade überspringt. Erfordert Claude Code v2.1.280 oder später. Siehe [Plugin für eine Sitzung laden](/docs/de/plugins/create#load-a-directory-or-archive-for-one-session) |347| `CLAUDE_CODE_PLUGIN_DIRS` | Plugin-Verzeichnisse zum Laden für die Sitzung, jedes geladen wie ein [`--plugin-dir`](/docs/de/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)-Flag es lädt. Trennen Sie mehrere Pfade mit `:` auf Unix oder `;` auf Windows. Geben Sie jeden Pfad als absoluten Pfad an oder starten Sie ihn mit `~`, weil Claude Code relative Pfade überspringt. Erfordert Claude Code v2.1.280 oder später. Siehe [Plugin für eine Sitzung laden](/docs/de/plugins/create#load-a-directory-or-archive-for-one-session) |

345| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in Millisekunden zum Klonen oder Aktualisieren eines Plugin-Marketplace (Standard: 120000). Erhöhen Sie diesen Wert für große Repositories oder langsame Netzwerk-Verbindungen. Siehe [Git-Klon timeout nach 120s](/docs/de/plugins/troubleshooting#git-clone-timed-out-after-120s) |348| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in Millisekunden zum Klonen oder Aktualisieren eines Plugin-Marketplace (Standard: 120000). Erhöhen Sie diesen Wert für große Repositories oder langsame Netzwerk-Verbindungen. Siehe [Git Clone Timeout](/docs/de/plugins/troubleshooting#git-clone-timed-out-after-120s) |

346| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Setzen Sie auf `1`, um den Re-Klon-Versuch zu überspringen und den bestehenden Marketplace-Checkout zu behalten, wenn eine Marketplace-Aktualisierung das Remote nicht erreichen oder sich authentifizieren kann. Nützlich in Offline- oder Airgapped-Umgebungen, wo Re-Klonen auf die gleiche Weise fehlschlagen würde. Siehe [Marketplace-Updates schlagen in Offline-Umgebungen fehl](/docs/de/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |349| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Setzen Sie auf `1`, um den Re-Clone-Versuch zu überspringen und den bestehenden Marketplace-Checkout zu behalten, wenn ein Marketplace-Refresh das Remote nicht erreichen oder authentifizieren kann. Nützlich in Offline- oder Airgapped-Umgebungen, wo Re-Cloning auf die gleiche Weise fehlschlagen würde. Siehe [Marketplace-Updates schlagen in Offline-Umgebungen fehl](/docs/de/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

347| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Setzen Sie auf `1`, um GitHub `owner/repo`-Shorthand-Quellen über HTTPS statt SSH zu klonen. Gilt für Plugin-Installation und Update, und für `/plugin marketplace add` und `update`. Nützlich in CI-Runnern, Containern oder jeder Umgebung ohne konfigurierten SSH-Schlüssel für `github.com` |350| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Setzen Sie auf `1`, um GitHub `owner/repo`-Shorthand-Quellen über HTTPS statt SSH zu klonen. Gilt für Plugin-Installation und Update, und für `/plugin marketplace add` und `update`. Nützlich in CI-Runnern, Containern oder jeder Umgebung ohne konfigurierten SSH-Schlüssel für `github.com` |

348| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Pfad zu einem oder mehreren Read-Only-Plugin-Seed-Verzeichnissen, getrennt durch `:` auf Unix oder `;` auf Windows. Verwenden Sie dies, um ein vorpopuliertes Plugins-Verzeichnis in ein Container-Image zu bündeln. Claude Code registriert Marketplaces aus diesen Verzeichnissen beim Startup und verwendet vorgespeicherte Plugins ohne Re-Klonen. Siehe [Plugins für Container vorpopulieren](/docs/de/plugins/org#seed-containers-and-ci) |351| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Pfad zu einem oder mehreren Read-Only-Plugin-Seed-Verzeichnissen, getrennt durch `:` auf Unix oder `;` auf Windows. Verwenden Sie dies, um ein vorpopuliertes Plugins-Verzeichnis in ein Container-Image zu bündeln. Claude Code registriert Marketplaces aus diesen Verzeichnissen beim Start und verwendet vorgespeicherte Plugins ohne Re-Cloning. Siehe [Plugins für Container vorpopulieren](/docs/de/plugins/org#seed-containers-and-ci) |

349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Setzen Sie auf `1`, um Claude Code daran zu hindern, `-ExecutionPolicy Bypass` beim Spawnen von PowerShell für Tool-Aufrufe, Hooks und Status-Zeilen-Befehle zu übergeben, und respektieren Sie stattdessen die effektive Ausführungs-Richtlinie der Maschine. Standardmäßig umgeht Claude Code die Ausführungs-Richtlinie auf Prozess-Ebene, daher funktionieren `.ps1`-Skripte und Modul-Importe auf Standard-Restricted-Windows-Installationen. Prozess-Ebene-Bypass überschreibt nie Group Policy `MachinePolicy` oder `UserPolicy`, unabhängig von dieser Einstellung |352| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, `-ExecutionPolicy Bypass` beim Spawnen von PowerShell für Tool-Aufrufe, Hooks und Status-Zeilen-Befehle zu übergeben, und respektieren Sie stattdessen die effektive Ausführungs-Richtlinie der Maschine. Standardmäßig umgeht Claude Code die Ausführungs-Richtlinie auf Prozess-Ebene, daher funktionieren `.ps1`-Skripte und Modul-Importe auf Standard-Restricted-Windows-Installationen. Prozess-Ebene-Bypass überschreibt niemals Group Policy `MachinePolicy` oder `UserPolicy`, unabhängig von dieser Einstellung |

350| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Obergrenze in Millisekunden auf Idle-Warten auf Hintergrund-Subagents und Workflows nach dem finalen Turn im [nicht-interaktiven Modus](/docs/de/headless#background-tasks-at-exit) mit dem `-p`-Flag. Idle-Warten startet jedes Mal neu, wenn Claude einen Turn nimmt, um ein Hintergrund-Ergebnis zu handhaben. Standard: `600000` oder 10 Minuten. Wenn Idle-Warten die Obergrenze erreicht, stoppt Claude Code das Warten auf die verbleibenden Hintergrund-Aufgaben und beendet. Setzen Sie auf `0`, um unbegrenzt zu warten. Diese Obergrenze ist separat von der fünf-Sekunden-Gnadenfrist, die auf einfache Hintergrund-Shells gilt. Erfordert Claude Code v2.1.182 oder später |353| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Obergrenze in Millisekunden auf Idle-Warten für Hintergrund-Subagents und Workflows nach dem finalen Turn im [nicht-interaktiven Modus](/docs/de/headless#background-tasks-at-exit) mit dem `-p`-Flag. Idle-Warten startet neu, jedes Mal wenn Claude einen Turn nimmt, um ein Hintergrund-Ergebnis zu handhaben. Standard: `600000` oder 10 Minuten. Wenn Idle-Warten die Obergrenze erreicht, stoppt Claude Code das Warten auf die verbleibenden Hintergrund-Aufgaben und beendet. Setzen Sie auf `0`, um unbegrenzt zu warten. Diese Obergrenze ist separat von der fünf-Sekunden-Gnadenfrist, die auf einfache Hintergrund-Shells gilt. Erfordert Claude Code v2.1.182 oder später |

351| `CLAUDE_CODE_PROCESS_WRAPPER` | Starten Sie die Prozesse, die Claude Code von seiner eigenen Binärdatei startet, wie der Hintergrund-Service, der [Agent-Ansicht](/docs/de/agent-view)-Sitzungen hostet, durch einen Unternehmens-Launcher, der als argv-Präfix wie `/opt/corp/launcher` gegeben ist. Setzen Sie es im `env`-Block von Benutzer- oder [verwalteten Einstellungen](/docs/de/managed-settings), nicht als Shell-Export, daher erbt der abgelöste Hintergrund-Service es; Projekt- und lokale Einstellungen können es nicht setzen. Entspricht der [`processWrapper`-Einstellung](/docs/de/settings-reference#processwrapper), die Claude Code v2.1.210 oder später erfordert; diese Variable hat Vorrang, wenn beide gesetzt sind. Die VS Code-Erweiterung konfiguriert ihren eigenen Launcher separat durch ihre `claudeProcessWrapper`-Einstellung. Wird unter Windows ignoriert. Siehe [Claude Code hinter einem Unternehmens-Launcher ausführen](/docs/de/corporate-launcher) für das Wert-Format, was der Launcher abdeckt, und den Vertrag, den der Launcher erfüllen muss. Erfordert Claude Code v2.1.208 oder später |354| `CLAUDE_CODE_PROCESS_WRAPPER` | Starten Sie die Prozesse, die Claude Code von seiner eigenen Binärdatei startet, wie der Hintergrund-Service, der [Agent-Ansicht](/docs/de/agent-view)-Sitzungen hostet, durch einen Corporate-Launcher, der als argv-Präfix wie `/opt/corp/launcher` gegeben ist. Setzen Sie es im `env`-Block von Benutzer- oder [verwalteten Einstellungen](/docs/de/managed-settings), nicht als Shell-Export, daher erbt der abgelöste Hintergrund-Service es; Projekt- und lokale Einstellungen können es nicht setzen. Äquivalent zur [`processWrapper`-Einstellung](/docs/de/settings-reference#processwrapper), die Claude Code v2.1.210 oder später erfordert; diese Variable hat Vorrang, wenn beide gesetzt sind. Die VS Code-Erweiterung konfiguriert ihren eigenen Launcher separat durch ihre `claudeProcessWrapper`-Einstellung. Wird unter Windows ignoriert. Siehe [Claude Code hinter einem Corporate-Launcher ausführen](/docs/de/corporate-launcher) für das Wert-Format, was der Launcher abdeckt, und den Vertrag, den der Launcher erfüllen muss. Erfordert Claude Code v2.1.208 oder später |

352| `CLAUDE_CODE_PROJECT_DIR_NAME` | Setzen Sie zusammen mit `CLAUDE_CONFIG_DIR`, um den `projects/`-Verzeichnis-Namen zu wählen, unter dem Claude Code die Transkripte und Auto-Memory dieser Sitzung speichert, anstelle eines aus dem Arbeitsverzeichnis-Pfad abgeleiteten. Zum Beispiel startet Claude Code mit `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` speichert sie unter `/srv/tenant-a/projects/work/`. Claude Code ignoriert diese Variable, wenn `CLAUDE_CONFIG_DIR` nicht gesetzt ist, und liest sie nur aus der Umgebung, die Sie `claude` von starten, nie aus einem [Einstellungsdatei-`env`-Block](#in-settings-files). Siehe [Projekt-Verzeichnis selbst benennen](/docs/de/sessions#name-the-project-directory-yourself). Erfordert Claude Code v2.1.234 oder später |355| `CLAUDE_CODE_PROJECT_DIR_NAME` | Setzen Sie zusammen mit `CLAUDE_CONFIG_DIR`, um den `projects/`-Verzeichnis-Namen zu wählen, unter dem Claude Code die Transkripte und Auto-Memory dieser Sitzung speichert, anstelle eines aus dem Arbeitsverzeichnis-Pfad abgeleiteten. Zum Beispiel startet Claude Code mit `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` speichert sie unter `/srv/tenant-a/projects/work/`. Claude Code ignoriert diese Variable, wenn `CLAUDE_CONFIG_DIR` nicht gesetzt ist, und liest sie nur aus der Umgebung, die Sie `claude` von starten, nie aus einem [Einstellungsdatei-`env`-Block](#in-settings-files). Siehe [Projekt-Verzeichnis-Namen selbst wählen](/docs/de/sessions#name-the-project-directory-yourself). Erfordert Claude Code v2.1.234 oder später |

353| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Setzen Sie `5m` oder `1h`, die einzigen Werte, die Claude Code akzeptiert, um die [Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) für die Hauptkonversation zu wählen: Ihre interaktiven, `-p` und SDK-Turns, plus die Helfer, die inline mit ihnen laufen. Hat Vorrang vor der `promptCacheTtl`-Einstellung und über `ENABLE_PROMPT_CACHING_1H`, und `FORCE_PROMPT_CACHING_5M` überschreibt es. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einer höheren Rate. Erfordert Claude Code v2.1.242 oder später |356| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Setzen Sie `5m` oder `1h`, die einzigen Werte, die Claude Code akzeptiert, um die [Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) für die Hauptkonversation zu wählen: Ihre interaktiven, `-p` und SDK-Turns, plus die Helfer, die inline mit ihnen laufen. Hat Vorrang vor der `promptCacheTtl`-Einstellung und über `ENABLE_PROMPT_CACHING_1H`, und `FORCE_PROMPT_CACHING_5M` überschreibt es. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einer höheren Rate. Erfordert Claude Code v2.1.242 oder später |

354| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Setzen Sie auf `1`, um W3C-Trace-Kontext zu propagieren, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy zeigt. Propagation deckt den `traceparent`-Header auf Modell- und HTTP-MCP-Anfragen und die `TRACEPARENT`-Umgebungsvariable für Bash-, PowerShell- und Hook-Subprozesse ab. Standardmäßig ist Propagation nur aktiviert, wenn direkt mit der Anthropic API verbunden. Hinzugefügt in v2.1.152. Siehe [Traces (Beta)](/docs/de/monitoring-usage#traces-beta) |357| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Setzen Sie auf `1`, um W3C-Trace-Kontext zu propagieren, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy zeigt. Propagation deckt den `traceparent`-Header auf Modell- und HTTP-MCP-Anfragen und die `TRACEPARENT`-Umgebungsvariable für Bash-, PowerShell- und Hook-Subprozesse ab. Standardmäßig ist Propagation nur aktiviert, wenn direkt mit der Anthropic API verbunden. Hinzugefügt in v2.1.152. Siehe [Traces (Beta)](/docs/de/monitoring-usage#traces-beta) |

355| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und Model-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, ignoriert Claude Code Provider-Auswahl-, Endpunkt- und Authentifizierungs-Variablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien, daher können Benutzereinstellungen das Host-Routing nicht überschreiben. Claude Code ignoriert auch Modell-Auswahl-Schlüssel wie `model`, `fallbackModel` und `modelOverrides` in [verwalteten Einstellungen](/docs/de/managed-settings), welche verwaltete Quelle sie liefert, daher hat die Host-Modell-Konfiguration Vorrang vor einer veralteten verwalteten Modell-Anheftung. Claude Code ignoriert auch Modell-Auswahl-Variablen wie `ANTHROPIC_MODEL` und die `ANTHROPIC_DEFAULT_*_MODEL`-Familie in einem verwalteten `env`-Block; eine [`availableModels`](/docs/de/model-config#restrict-model-selection)-Allowlist in verwalteten Einstellungen gilt immer noch, es sei denn, der Host liefert seine eigene. Claude Code überspringt auch die automatische Telemetrie-Opt-Out, die es andernfalls auf Drittanbieter-Providern wie Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry anwendet, daher folgt Telemetrie dem Standard-`DISABLE_TELEMETRY`-Opt-Out. Siehe [Standard-Verhaltensweisen nach API-Provider](/docs/de/data-usage#default-behaviors-by-api-provider) |358| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und Model-Provider-Routing in dessen Namen verwalten. Wenn gesetzt, ignoriert Claude Code Provider-Auswahl-, Endpunkt- und Authentifizierungs-Variablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien, daher können Benutzereinstellungen das Routing des Hosts nicht überschreiben. Claude Code ignoriert auch Modell-Auswahl-Schlüssel wie `model`, `fallbackModel` und `modelOverrides` in [verwalteten Einstellungen](/docs/de/managed-settings), welche verwaltete Quelle sie liefert, daher hat die Modell-Konfiguration des Hosts Vorrang vor einer veralteten verwalteten Modell-Anheftung. Claude Code ignoriert auch Modell-Auswahl-Variablen wie `ANTHROPIC_MODEL` und die `ANTHROPIC_DEFAULT_*_MODEL`-Familie in einem verwalteten `env`-Block; eine [`availableModels`](/docs/de/model-config#restrict-model-selection)-Allowlist in verwalteten Einstellungen gilt immer noch, es sei denn, der Host liefert seine eigene. Claude Code überspringt auch das automatische Telemetrie-Opt-Out, das es andernfalls auf Drittanbieter-Providern wie Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry anwendet, daher folgt Telemetrie dem Standard-`DISABLE_TELEMETRY`-Opt-Out. Siehe [Standard-Verhaltensweisen nach API-Provider](/docs/de/data-usage#default-behaviors-by-api-provider) |

356| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Setzen Sie auf `1`, um dem Proxy zu erlauben, DNS-Auflösung durchzuführen, anstatt des Aufrufers. Opt-In für Umgebungen, in denen der Proxy Hostname-Auflösung handhaben sollte |359| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Setzen Sie auf `1`, um dem Proxy zu erlauben, DNS-Auflösung anstelle des Aufrufers durchzuführen. Opt-In für Umgebungen, in denen der Proxy Hostname-Auflösung handhaben sollte |

357| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](/docs/de/claude-code-on-the-web) läuft. Lesen Sie dies aus einem Hook oder Setup-Skript, um zu erkennen, ob Sie in einer Cloud-Sitzung sind |360| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](/docs/de/claude-code-on-the-web) läuft. Lesen Sie dies aus einem Hook oder Setup-Skript, um zu erkennen, ob Sie in einer Cloud-Sitzung sind |

358| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird automatisch in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) auf die aktuelle Sitzungs-ID gesetzt. Lesen Sie dies, um einen Link zurück zum Sitzungs-Transkript zu konstruieren. Siehe [Ausgabe zurück zur Sitzung verlinken](/docs/de/cloud-environments#link-output-back-to-the-session) |361| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird automatisch in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) auf die aktuelle Sitzungs-ID gesetzt. Lesen Sie dies, um einen Link zurück zum Sitzungs-Transkript zu konstruieren. Siehe [Ausgabe zurück zur Sitzung verlinken](/docs/de/cloud-environments#link-output-back-to-the-session) |

359| `CLAUDE_CODE_RESTRICTED` | Setzen Sie auf `1`, um die Sitzung im eingeschränkten Modus zu starten, das gleiche wie das Übergeben von [`--restricted`](/docs/de/cli-reference#cli-flags). Claude Code ignoriert diese Variable in einem Einstellungsdatei-`env`-Block. Erfordert Claude Code v2.1.248 oder später |362| `CLAUDE_CODE_RESTRICTED` | Setzen Sie auf `1`, um die Sitzung im eingeschränkten Modus zu starten, das gleiche wie das Übergeben von [`--restricted`](/docs/de/cli-reference#cli-flags). Claude Code ignoriert diese Variable in einem Einstellungsdatei-`env`-Block. Erfordert Claude Code v2.1.248 oder später |

360| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Setzen Sie auf `1`, um automatisch fortzufahren, wenn die vorherige Sitzung mid-turn endete. Wird im SDK-Modus verwendet, daher setzt das Modell fort, ohne dass das SDK den Prompt erneut senden muss. Um dies auszuschalten, heben Sie die Variable auf oder setzen Sie sie auf `0`. Vor v2.1.221 ignorierte Claude Code `0` und andere falsy-Werte, daher löste das Setzen von `0` immer noch die Wiederaufnahme im nicht-interaktiven Modus aus und das Aufheben der Variable war die einzige Möglichkeit, es auszuschalten |363| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Setzen Sie auf `1`, um automatisch fortzufahren, wenn die vorherige Sitzung mid-turn endete. Wird im SDK-Modus verwendet, daher setzt das Modell fort, ohne dass das SDK den Prompt erneut senden muss. Um dies auszuschalten, heben Sie die Variable auf oder setzen Sie sie auf `0`. Vor v2.1.221 ignorierte Claude Code `0` und andere falsy-Werte, daher setzte `0` immer noch die Wiederaufnahme im nicht-interaktiven Modus aus und das Aufheben der Variable war die einzige Möglichkeit, es auszuschalten |

361| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Maximales Alter in Millisekunden der letzten Transkript-Nachricht für eine Sitzung, die mid-turn endete, um automatisch bei Wiederaufnahme fortzufahren. Wenn die letzte Nachricht älter als diese Grenze ist, überspringt Claude Code die `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`-automatische Wiederaufnahme und ihre `CLAUDE_CODE_RESUME_PROMPT`-Fortsetzungs-Nachricht, und die Sitzung startet untätig, daher fahren Sie explizit fort. Nicht gesetzt oder `0` bedeutet keine Grenze, außer dass ein Turn, dessen letzte Anfrage mit einem API-Fehler fehlschlägt, nur fortgesetzt wird, während dieser Fehler weniger als sechs Stunden alt ist. Ein positiver Wert begrenzt jeden Turn, einschließlich dieser; ein negativer oder nicht-numerischer Wert wendet eine einstündige Grenze an. Spawn-Skripte für lang laufende Agents können dies setzen, daher startet eine Wiederaufnahme gegen ein altes Transkript nicht einen veralteten Prompt erneut. Claude Code setzt selbst eine einstündige Grenze, wenn es eine abgestürzte [Agent-Ansicht](/docs/de/agent-view)-Sitzung neu startet, die ihre Konversation von einer interaktiven Sitzung geerbt hat. Erfordert Claude Code v2.1.211 oder später |364| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Maximales Alter in Millisekunden der letzten Transkript-Nachricht für eine Sitzung, die mid-turn endete, um automatisch bei Wiederaufnahme fortzufahren. Wenn die letzte Nachricht älter als diese Grenze ist, überspringt Claude Code die `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`-automatische Wiederaufnahme und ihre `CLAUDE_CODE_RESUME_PROMPT`-Fortsetzungs-Nachricht, und die Sitzung startet untätig, daher fahren Sie explizit fort. Nicht gesetzt oder `0` bedeutet keine Grenze, außer dass ein Turn, dessen letzte Anfrage mit einem API-Fehler fehlschlägt, nur fortgesetzt wird, während dieser Fehler weniger als sechs Stunden alt ist. Ein positiver Wert begrenzt jeden Turn, einschließlich dieser; ein negativer oder nicht-numerischer Wert wendet eine einstündige Grenze an. Spawn-Skripte für lang laufende Agents können dies setzen, daher startet eine Wiederaufnahme gegen ein altes Transkript nicht einen veralteten Prompt erneut. Claude Code setzt selbst eine einstündige Grenze, wenn es eine abgestürzte [Agent-Ansicht](/docs/de/agent-view)-Sitzung neu startet, die ihre Konversation von einer interaktiven Sitzung geerbt hat. Erfordert Claude Code v2.1.211 oder später |

362| `CLAUDE_CODE_RESUME_PROMPT` | Überschreiben Sie die Fortsetzungs-Nachricht, die Claude Code an Claude sendet, wenn `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` einen unterbrochenen Turn fortsetzt, anstatt seinen Prompt erneut zu senden, oder wenn Sie einen [aufgeschobenen Tool-Aufruf](/docs/de/hooks#defer-a-tool-call-for-later) mit `-p` fortsetzen. Standard ist `Continue from where you left off.`. Ein leerer String verwendet den Standard |365| `CLAUDE_CODE_RESUME_PROMPT` | Überschreiben Sie die Fortsetzungs-Nachricht, die Claude Code an Claude sendet, wenn `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` einen unterbrochenen Turn fortsetzt, anstatt seinen Prompt erneut zu senden, oder wenn Sie einen [aufgeschobenen Tool-Aufruf](/docs/de/hooks#defer-a-tool-call-for-later) mit `-p` fortsetzen. Standardmäßig `Continue from where you left off.`. Ein leerer String verwendet den Standard |

363| `CLAUDE_CODE_RETRY_WATCHDOG` | Setzen Sie auf `1` für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Wiederholt `429`- und `529`-Kapazitäts-Fehler unbegrenzt, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen zu fehlschlagen. Claude Code schlägt sofort fehl, wenn eine Standard-Speed-Anfrage einen `429` erhält, der ein Ausgabenlimit oder erschöpfte Nutzungs-Credits meldet, auch einen von einem [Gateway-Ausgabenlimit](/docs/de/errors#spend-limit-reached), das nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 wiederholte der Watchdog diese unbegrenzt. Für Fast-Mode-Anfragen siehe [Rate-Limits handhaben](/docs/de/fast-mode#handle-rate-limits). Der Watchdog sichert sich bis zu 5 Minuten zwischen Versuchen ab, oder bis das Limit zurückgesetzt wird, wenn die Antwort eine Rate-Limit-Reset-Zeit trägt, daher wartet eine Sitzung, die ein Nutzungslimit trifft, das verbleibende Fenster ab. Auf v2.1.199 oder später erhöht es auch die Standard-Wiederholungs-Anzahl für andere transiente Fehler, wie Server-Fehler, Timeouts und gelöschte Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf `CLAUDE_CODE_MAX_RETRIES`, wenn Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder später |366| `CLAUDE_CODE_RETRY_WATCHDOG` | Setzen Sie auf `1` für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Wiederholt `429`- und `529`-Kapazitäts-Fehler unbegrenzt, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen zu fehlschlagen. Claude Code schlägt sofort fehl, wenn eine Standard-Speed-Anfrage einen `429` erhält, der ein Ausgabenlimit oder erschöpfte Nutzungs-Credits meldet, auch einen von einem [Gateway-Ausgabenlimit](/docs/de/errors#spend-limit-reached), das nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 wiederholte der Watchdog diese unbegrenzt. Für Fast-Mode-Anfragen siehe [Rate Limits handhaben](/docs/de/fast-mode#handle-rate-limits). Der Watchdog sichert sich bis zu 5 Minuten zwischen Versuchen ab, oder bis das Limit zurückgesetzt wird, wenn die Antwort eine Rate-Limit-Reset-Zeit trägt, daher wartet eine Sitzung, die ein Nutzungslimit trifft, das verbleibende Fenster ab. Auf v2.1.199 oder später erhöht es auch den Standard-Wiederholungs-Zähler für andere transiente Fehler, wie Server-Fehler, Timeouts und gelöschte Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf `CLAUDE_CODE_MAX_RETRIES`, wenn Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder später |

364| `CLAUDE_CODE_SAFE_MODE` | Setzen Sie auf `1`, um im sicheren Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agents, Ausgabe-Stile, Workflows, benutzerdefinierte Themes, benutzerdefinierte Tastenbindungen, Status-Zeilen- und Datei-Vorschlag-Befehle, LSP-Server und Auto-Memory laden nicht, zur Fehlerbehebung einer kaputten Konfiguration. Verwaltete Einstellungs-Richtlinie gilt immer noch, einschließlich Richtlinie-konfigurierter Hooks, Status-Zeile und Datei-Vorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und Richtlinie-konfigurierte MCP-Server laden nicht. Entspricht dem Übergeben von [`--safe-mode`](/docs/de/cli-reference#cli-flags). Direkt gespawnte Kind-Prozesse erben die Variable |367| `CLAUDE_CODE_SAFE_MODE` | Setzen Sie auf `1`, um im sicheren Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agents, Output-Stile, Workflows, benutzerdefinierte Themes, benutzerdefinierte Keybindings, Status-Zeile und Datei-Vorschlag-Befehle, LSP-Server und Auto-Memory laden nicht zur Fehlerbehebung einer kaputten Konfiguration. Verwaltete Einstellungs-Richtlinie gilt immer noch, einschließlich Richtlinie-konfigurierter Hooks, Status-Zeile und Datei-Vorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und Richtlinie-konfigurierte MCP-Server laden nicht. Äquivalent zum Übergeben von [`--safe-mode`](/docs/de/cli-reference#cli-flags). Direkt gespawnte Child-Prozesse erben die Variable |

365| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft spezifische Skripte pro Sitzung aufgerufen werden können, wenn `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` gesetzt ist. Schlüssel sind Substrings, die gegen den Befehls-Text abgeglichen werden; Werte sind Ganzzahl-Aufrufs-Limits. Zum Beispiel erlaubt `{"deploy.sh": 2}` `deploy.sh`, höchstens zweimal aufgerufen zu werden. Matching ist Substring-basiert, daher zählen Shell-Expansion-Tricks wie `./scripts/deploy.sh $(evil)` immer noch gegen die Obergrenze. Runtime-Fan-Out über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Kontrolle |368| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft spezifische Skripte pro Sitzung aufgerufen werden können, wenn `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` gesetzt ist. Schlüssel sind Substrings, die gegen den Befehlstext abgeglichen werden; Werte sind Ganzzahl-Aufruflimits. Zum Beispiel erlaubt `{"deploy.sh": 2}` `deploy.sh`, höchstens zweimal aufgerufen zu werden. Matching ist Substring-basiert, daher zählen Shell-Expansion-Tricks wie `./scripts/deploy.sh $(evil)` immer noch gegen die Obergrenze. Runtime-Fan-Out über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Kontrolle |

366| `CLAUDE_CODE_SCROLL_SPEED` | Setzen Sie den Maus-Rad-Scroll-Multiplikator im [Vollbild-Rendering](/docs/de/fullscreen#mouse-wheel-scrolling). Akzeptiert jeden positiven Wert bis zu 20, einschließlich Bruch-Werte unter 1 wie `0.5`, um beschleunigtes Trackpad- und Rad-Scrollen in Terminals zu verlangsamen, die Rad-Events bereits verstärken. Setzen Sie auf `3`, um `vim` zu entsprechen, wenn Ihr Terminal ein Rad-Event pro Kerbe ohne Verstärkung sendet. Wird im JetBrains IDE-Terminal ignoriert, wo Claude Code sein eigenes Scroll-Handling verwendet |369| `CLAUDE_CODE_SCROLL_SPEED` | Setzen Sie den Mausrad-Scroll-Multiplikator im [Vollbild-Rendering](/docs/de/fullscreen#mouse-wheel-scrolling). Akzeptiert jeden positiven Wert bis zu 20, einschließlich Bruch-Werte unter 1 wie `0.5`, um beschleunigtes Trackpad- und Rad-Scrolling in Terminals zu verlangsamen, die Rad-Ereignisse bereits verstärken. Setzen Sie auf `3`, um `vim` zu entsprechen, wenn Ihr Terminal ein Rad-Ereignis pro Kerbe ohne Verstärkung sendet. Wird im JetBrains IDE-Terminal ignoriert, wo Claude Code sein eigenes Scroll-Handling verwendet |

367| `CLAUDE_CODE_SEND_FEEDBACK` | Setzen Sie auf `0`, um [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) für eine Sitzung auszuschalten. Setzen Sie auf `1`, um es einzuschalten, wo Ihr Konto bereits Zugriff hat; die Variable kann Zugriff selbst nicht gewähren, und die anderen Schalter, die Feedback ausschalten, wie `DISABLE_FEEDBACK_COMMAND` und der [`feedbackDrafts`](/docs/de/settings-reference#feedbackdrafts)-Einstellung's `off`-Wert, gelten immer noch |370| `CLAUDE_CODE_SEND_FEEDBACK` | Setzen Sie auf `0`, um [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) für eine Sitzung auszuschalten. Setzen Sie auf `1`, um es einzuschalten, wo Ihr Konto bereits Zugriff hat; die Variable kann Zugriff nicht selbst gewähren, und die anderen Schalter, die Feedback ausschalten, wie `DISABLE_FEEDBACK_COMMAND` und der [`feedbackDrafts`](/docs/de/settings-reference#feedbackdrafts)-Einstellung's `off`-Wert, gelten immer noch |

368| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Überschreiben Sie das Zeit-Budget in Millisekunden für [SessionEnd](/docs/de/hooks#sessionend)-Hooks. Der Wert ist auch das Timeout für jeden Hook, der sein eigenes `timeout` nicht setzt. Gilt für Sitzungs-Beendigung, `/clear` und Sitzungs-Wechsel über interaktives `/resume`. Standardmäßig ist das Budget 1,5 Sekunden, automatisch erhöht auf das höchste Pro-Hook-`timeout`, das in Einstellungsdateien konfiguriert ist, bis zu 60 Sekunden. Timeouts auf Plugin-bereitgestellten Hooks erhöhen das Budget nicht |371| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Überschreiben Sie das Zeit-Budget in Millisekunden für [SessionEnd](/docs/de/hooks#sessionend)-Hooks. Der Wert ist auch das Timeout für jeden Hook, der kein eigenes `timeout` setzt. Gilt für Sitzungs-Exit, `/clear` und Sitzungs-Wechsel über interaktives `/resume`. Standardmäßig ist das Budget 1,5 Sekunden, automatisch erhöht auf das höchste Pro-Hook-`timeout`, das in Einstellungsdateien konfiguriert ist, bis zu 60 Sekunden. Timeouts auf Plugin-bereitgestellten Hooks erhöhen das Budget nicht |

369| `CLAUDE_CODE_SESSION_ID` | Wird automatisch auf die aktuelle Sitzungs-ID in Bash- und PowerShell-Tool-Subprozessen, [Hook-Befehls](/docs/de/hooks)-Subprozessen und stdio [MCP-Server](/docs/de/mcp)-Subprozessen gesetzt. Für Bash, PowerShell und Hooks entspricht dies dem `session_id`-Feld in der Hook-JSON-Eingabe und wird bei `/clear` aktualisiert. Ein MCP-Server-Subprocess behält die ID, mit der er spawnt wurde. Bei `--resume <session-id>` erhält er die fortgesetzte ID, was Hooks und Bash entspricht. Bei `--continue` oder `--resume` ohne explizite ID kann er stattdessen die anfängliche Startup-ID erhalten. Verwenden Sie, um Skripte und externe Tools mit der Claude Code-Sitzung zu korrelieren, die sie gestartet hat |372| `CLAUDE_CODE_SESSION_ID` | Wird automatisch auf die aktuelle Sitzungs-ID in Bash- und PowerShell-Tool-Subprozessen, [Hook-Befehl](/docs/de/hooks)-Subprozessen und stdio [MCP-Server](/docs/de/mcp)-Subprozessen gesetzt. Für Bash, PowerShell und Hooks entspricht dies dem `session_id`-Feld in der Hook-JSON-Eingabe und wird bei `/clear` aktualisiert. Ein MCP-Server-Subprocess behält die ID, mit der er spawnt wurde. Bei `--resume <session-id>` erhält er die fortgesetzte ID, was Hooks und Bash entspricht. Bei `--continue` oder `--resume` ohne explizite ID kann er stattdessen die anfängliche Startup-ID erhalten. Verwenden Sie, um Skripte und externe Tools mit der Claude Code-Sitzung zu korrelieren, die sie startet |

370| `CLAUDE_CODE_SHELL` | Setzen Sie die Shell, die Claude Code zum Ausführen von Bash-Tool-Befehlen verwendet. Akzeptiert einen Pfad zu einer `bash`- oder `zsh`-Binärdatei, zum Beispiel `/opt/homebrew/bin/bash`. Andere Shells wie `fish` werden nicht unterstützt. Wenn der Wert kein funktionierender `bash`- oder `zsh`-Pfad ist, ignoriert Claude Code ihn und fällt auf Auto-Erkennung zurück. Auto-Erkennung verwendet Ihre `$SHELL`, wenn sie auf `bash` oder `zsh` zeigt, andernfalls wählt sie die erste funktionierende `zsh` dann `bash`, die auf Ihrem `PATH` und Standard-Installationsorten gefunden wird |373| `CLAUDE_CODE_SHELL` | Setzen Sie die Shell, die Claude Code zum Ausführen von Bash-Tool-Befehlen verwendet. Akzeptiert einen Pfad zu einer `bash`- oder `zsh`-Binärdatei, zum Beispiel `/opt/homebrew/bin/bash`. Andere Shells wie `fish` werden nicht unterstützt. Wenn der Wert kein funktionierender `bash`- oder `zsh`-Pfad ist, ignoriert Claude Code ihn und fällt auf Auto-Erkennung zurück. Auto-Erkennung verwendet Ihren `$SHELL`, wenn er auf `bash` oder `zsh` zeigt, andernfalls wählt es die erste funktionierende `zsh` dann `bash`, die auf Ihrem `PATH` und Standard-Installationsorten gefunden wird |

371| `CLAUDE_CODE_SHELL_PREFIX` | Befehls-Präfix, der Shell-Befehle umhüllt, die Claude Code spawnt: Bash-Tool-Aufrufe, [Hook](/docs/de/hooks)-Befehle, [Status-Zeilen](/docs/de/statusline)-Befehle und stdio [MCP-Server](/docs/de/mcp)-Startup-Befehle. PowerShell-Hooks und Exec-Form-Hooks laufen ohne das Präfix. Nützlich zum Protokollieren oder Auditing. Das Setzen eines bloßen ausführbaren Pfads wie `/path/to/logger.sh` führt jeden Befehl als `/path/to/logger.sh '<command>'` aus. Der Wrapper erhält die Befehlszeile als ein einzelnes Shell-zitiertes Argument in `$1`, daher muss der Wrapper `$1` mit einer Shell erneut auswerten, zum Beispiel `exec bash -c "$1"`. Das Behandeln von `$1` als bloßer ausführbarer Pfad bricht stdio MCP-Server, die Argumente wie `npx -y <package>` übergeben. Für Bash-Tool-Aufrufe enthält `$1` die vollständige Shell-Aufrufe, die Claude Code zusammensetzt, einschließlich Umgebungs-Setup, nicht nur den Befehl, den Claude ausgeführt hat |374| `CLAUDE_CODE_SHELL_PREFIX` | Befehlspräfix, das Shell-Befehle umhüllt, die Claude Code spawnt: Bash-Tool-Aufrufe, [Hook](/docs/de/hooks)-Befehle, [Status-Zeile](/docs/de/statusline)-Befehle und stdio [MCP-Server](/docs/de/mcp)-Startup-Befehle. PowerShell-Hooks und Exec-Form-Hooks laufen ohne das Präfix. Nützlich zum Protokollieren oder Auditing. Das Setzen eines bloßen ausführbaren Pfads wie `/path/to/logger.sh` führt jeden Befehl als `/path/to/logger.sh '<command>'` aus. Der Wrapper erhält die Befehlszeile als ein einzelnes Shell-zitiertes Argument in `$1`, daher muss der Wrapper `$1` mit einer Shell neu evaluieren, zum Beispiel `exec bash -c "$1"`. Das Behandeln von `$1` als bloßer ausführbarer Pfad bricht stdio MCP-Server, die Argumente übergeben, wie `npx -y <package>`. Für Bash-Tool-Aufrufe enthält `$1` die vollständige Shell-Invokation, die Claude Code zusammensetzt, einschließlich Umgebungs-Setup, nicht nur den Befehl, den Claude ausgeführt hat |

372| `CLAUDE_CODE_SIMPLE` | Setzen Sie auf `1`, um mit einem minimalen System-Prompt und nur den Bash-, Datei-Lese- und Datei-Bearbeitungs-Tools zu laufen. MCP-Tools von `--mcp-config` sind immer noch verfügbar. Deaktiviert Auto-Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagents, installierten Plugins, MCP-Servern, Auto-Memory und CLAUDE.md. Skills in einem Verzeichnis, das Sie mit `--add-dir` übergeben, laden immer noch. OAuth-Tokens und Keychain-Anmeldedaten werden nicht gelesen, daher muss Anthropic-Authentifizierung von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in `--settings` kommen. Entspricht dem Übergeben von [`--bare`](/docs/de/headless#start-faster-with-bare-mode) |375| `CLAUDE_CODE_SIMPLE` | Setzen Sie auf `1`, um mit einem minimalen System-Prompt und nur den Bash-, Datei-Lese- und Datei-Edit-Tools zu laufen. MCP-Tools von `--mcp-config` sind immer noch verfügbar. Deaktiviert Auto-Discovery von Hooks, Skills, benutzerdefinierten Befehlen, Subagents, installierten Plugins, MCP-Servern, Auto-Memory und CLAUDE.md. Skills in einem Verzeichnis, das Sie mit `--add-dir` übergeben, laden immer noch. OAuth-Tokens und Keychain-Credentials werden nicht gelesen, daher muss Anthropic-Authentifizierung von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in `--settings` kommen. Äquivalent zum Übergeben von [`--bare`](/docs/de/headless#start-faster-with-bare-mode) |

373| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Setzen Sie auf `1`, um einen kürzeren System-Prompt und abgekürzte Tool-Beschreibungen auf jedem Modell zu verwenden. Setzen Sie auf `0`, `false`, `no` oder `off`, um zu deaktivieren, auch wenn das Experiment oder die Server-Konfiguration es andernfalls aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und CLAUDE.md-Erkennung bleiben aktiviert |376| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Setzen Sie auf `1`, um einen kürzeren System-Prompt und abgekürzte Tool-Beschreibungen auf jedem Modell zu verwenden. Setzen Sie auf `0`, `false`, `no` oder `off`, um zu deaktivieren, auch wenn das Experiment oder die Server-Konfiguration es andernfalls aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und CLAUDE.md-Discovery bleiben aktiviert |

374| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Überspringen Sie die Client-seitige Authentifizierung für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), für Gateways, die Anfragen selbst signieren |377| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Überspringen Sie die Client-seitige Authentifizierung für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), für Gateways, die Anfragen selbst signieren |

375| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Setzen Sie auf `1`, um den In-Process-Cache von Anmeldedaten, die von der AWS-Standard-Anmeldedaten-Provider-Kette aufgelöst werden, auszuschalten, daher löst Claude Code die Kette bei jeder API-Anfrage auf. Mit dem Cache aus fordert ein SSO-gestütztes Profil Anmeldedaten von IAM Identity Center bei jeder Anfrage an. Siehe [Anmeldedaten-Caching und Auflösungs-Timeout](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout). Erfordert Claude Code v2.1.207 oder später |378| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Setzen Sie auf `1`, um den In-Process-Cache von Credentials, die von der AWS-Standard-Credential-Provider-Kette aufgelöst werden, auszuschalten, daher löst Claude Code die Kette bei jeder API-Anfrage auf. Mit dem Cache aus fordert ein SSO-gestütztes Profil Credentials von IAM Identity Center bei jeder Anfrage an. Siehe [Credential-Caching und Auflösungs-Timeout](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout). Erfordert Claude Code v2.1.207 oder später |

376| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Überspringen Sie AWS-Authentifizierung für Amazon Bedrock (zum Beispiel, wenn Sie ein LLM-Gateway verwenden) |379| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Überspringen Sie AWS-Authentifizierung für Amazon Bedrock (zum Beispiel, wenn Sie ein LLM-Gateway verwenden) |

377| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Setzen Sie auf `1`, um eine fehlgeschlagene [Fast-Mode](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)-Verfügbarkeitsprüfung als verfügbar zu behandeln, für Netzwerke, die die Prüfungs-direkte Anfrage an `api.anthropic.com` blockieren. Claude Code ehrt immer noch eine "disabled by your organization"-Antwort |380| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Setzen Sie auf `1`, um einen fehlgeschlagenen [Fast Mode](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)-Verfügbarkeitsprüfung als verfügbar zu behandeln, für Netzwerke, die die Prüfung's direkte Anfrage an `api.anthropic.com` blockieren. Claude Code ehrt immer noch eine "disabled by your organization"-Antwort |

378| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Setzen Sie auf `1`, um die Client-seitige [Fast-Mode](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)-Verfügbarkeitsprüfung zu überspringen, für Proxies, die die Prüfungs-Anfrage abfangen, anstatt sie zu weigern. Die API lehnt immer noch Fast-Mode-Anfragen ab, wenn Ihre Organisation Fast Mode deaktiviert hat |381| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Setzen Sie auf `1`, um die Client-seitige [Fast Mode](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)-Verfügbarkeitsprüfung zu überspringen, für Proxies, die die Prüfung's Anfrage abfangen, anstatt sie zu verweigern. Die API lehnt immer noch Fast-Mode-Anfragen ab, wenn Ihre Organisation Fast Mode deaktiviert hat |

379| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Überspringen Sie Azure-Authentifizierung für Microsoft Foundry, für einen Proxy oder ein Gateway, das seinen eigenen `Authorization`-Header injiziert. Claude Code sendet Anfragen ohne Azure-Anmeldedaten und bewahrt den `Authorization`-Header, den Sie liefern, zum Beispiel durch `ANTHROPIC_CUSTOM_HEADERS`. Wird ignoriert, wenn `ANTHROPIC_FOUNDRY_API_KEY` oder `ANTHROPIC_FOUNDRY_AUTH_TOKEN` gesetzt ist. Vor v2.1.203 ließ diese Variable den Microsoft Foundry-Client unfähig, Anfragen zu senden, es sei denn, ein API-Schlüssel war auch gesetzt |382| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Überspringen Sie Azure-Authentifizierung für Microsoft Foundry, für einen Proxy oder ein Gateway, das seinen eigenen `Authorization`-Header injiziert. Claude Code sendet Anfragen ohne Azure-Credential und bewahrt den `Authorization`-Header, den Sie liefern, zum Beispiel durch `ANTHROPIC_CUSTOM_HEADERS`. Wird ignoriert, wenn `ANTHROPIC_FOUNDRY_API_KEY` oder `ANTHROPIC_FOUNDRY_AUTH_TOKEN` gesetzt ist. Vor v2.1.203 ließ diese Variable den Microsoft Foundry-Client unfähig, Anfragen zu senden, es sei denn, ein API-Schlüssel war auch gesetzt |

380| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie AWS-Authentifizierung für Amazon Bedrock Mantle (zum Beispiel, wenn Sie ein LLM-Gateway verwenden) |383| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie AWS-Authentifizierung für Amazon Bedrock Mantle (zum Beispiel, wenn Sie ein LLM-Gateway verwenden) |

381| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Setzen Sie auf `1`, um das Schreiben von Prompt-Verlauf und Sitzungs-Transkripten auf die Festplatte zu überspringen. Sitzungen, die mit dieser Variable gesetzt gestartet werden, erscheinen nicht in `--resume`, `--continue` oder Up-Arrow-Verlauf. Nützlich für ephemere Skript-Sitzungen |384| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Setzen Sie auf `1`, um das Schreiben von Prompt-Verlauf und Sitzungs-Transkripten auf die Festplatte zu überspringen. Sitzungen, die mit dieser Variable gesetzt gestartet werden, erscheinen nicht in `--resume`, `--continue` oder Up-Arrow-Verlauf. Nützlich für ephemere Skript-Sitzungen |

382| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Überspringen Sie Google-Authentifizierung für Google Cloud's Agent Platform (zum Beispiel, wenn Sie ein LLM-Gateway verwenden) |385| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Überspringen Sie Google-Authentifizierung für Google Cloud's Agent Platform (zum Beispiel, wenn Sie ein LLM-Gateway verwenden) |

383| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Setzen Sie auf `1`, um eine Sitzung, die mit `--output-format stream-json` gestartet wird, eine [Result-Nachricht zu schreiben, die benennt, warum Claude Code sich weigerte zu starten](/docs/de/agent-sdk/typescript#startup_failure_reason) für Startup-Fehler, die andernfalls nur mit stderr enden. Erfordert Claude Code v2.1.274 oder später |386| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Setzen Sie auf `1`, um eine Sitzung, die mit `--output-format stream-json` gestartet wird, eine [Result-Nachricht zu schreiben, die benennt, warum Claude Code sich weigerte zu starten](/docs/de/agent-sdk/typescript#startup_failure_reason) für Startup-Fehler, die andernfalls nur mit stderr enden. Erfordert Claude Code v2.1.274 oder später |

384| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Maximale Anzahl aufeinanderfolgender Male, die ein [Stop](/docs/de/hooks#stop)- oder [SubagentStop](/docs/de/hooks#subagentstop)-Hook den Turn-Ende blockieren kann, bevor Claude Code es überschreibt und den Turn trotzdem beendet (Standard: 8). Setzen Sie auf `0`, um die Obergrenze zu deaktivieren. Erhöhen Sie dies, wenn Ihr Hook legitim mehr Iterationen braucht, um sich zu lösen |387| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Maximale Anzahl aufeinanderfolgender Male, die ein [Stop](/docs/de/hooks#stop)- oder [SubagentStop](/docs/de/hooks#subagentstop)-Hook den Turn vom Beenden blockieren kann, bevor Claude Code es überschreibt und den Turn trotzdem beendet (Standard: 8). Setzen Sie auf `0`, um die Obergrenze zu deaktivieren. Erhöhen Sie dies, wenn Ihr Hook legitim mehr Iterationen braucht, um sich zu lösen |

385| `CLAUDE_CODE_SUBAGENT_MODEL` | Das Standard-Modell für [Subagents](/docs/de/sub-agents#choose-a-model), [Agent-Team](/docs/de/agent-teams#specify-teammates-and-models)-Teammates und [Workflow](/docs/de/workflows)-Agents, die nicht auf andere Weise ein Modell zugewiesen bekommen. Akzeptiert einen Alias wie `haiku` oder einen vollständigen Modell-Namen. Zwei Quellen haben Vorrang vor ihm: ein Modell, das Claude beim Spawnen des Agents übergibt, und ein `model`-Feld in der Agent-Definition, einschließlich `inherit`. Um das zu ändern, setzen Sie [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/de/sub-agents#run-every-subagent-on-one-model). Siehe [Modell wählen](/docs/de/sub-agents#choose-a-model) für die vollständige Reihenfolge. Das Setzen auf `inherit` ist das gleiche wie das Nicht-Setzen. Vor v2.1.251 überschrieb diese Variable sowohl das Pro-Aufrufs-Modell als auch das `model`-Feld der Definition |388| `CLAUDE_CODE_SUBAGENT_MODEL` | Das Standard-Modell für [Subagents](/docs/de/sub-agents#choose-a-model), [Agent Team](/docs/de/agent-teams#specify-teammates-and-models)-Teammates und [Workflow](/docs/de/workflows)-Agents, die nicht auf andere Weise ein Modell zugewiesen bekommen. Akzeptiert einen Alias wie `haiku` oder einen vollständigen Modell-Namen. Zwei Quellen haben Vorrang vor ihm: ein Modell, das Claude beim Spawnen des Agents übergibt, und ein `model`-Feld in der Agent-Definition, einschließlich `inherit`. Um das zu ändern, setzen Sie [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/de/sub-agents#run-every-subagent-on-one-model). Siehe [Modell wählen](/docs/de/sub-agents#choose-a-model) für die vollständige Reihenfolge. Das Setzen auf `inherit` ist das gleiche wie das Nicht-Setzen. Vor v2.1.251 überschrieb diese Variable sowohl das Pro-Invokation-Modell als auch das `model`-Feld der Definition |

386| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Setzen Sie auf `1`, um ein Modell auf Subagents, Teammates und Workflow-Agents zu erzwingen. [Jeden Subagent auf einem Modell ausführen](/docs/de/sub-agents#run-every-subagent-on-one-model) sagt, welches Modell das ist. Erfordert Claude Code v2.1.257 oder später |389| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Setzen Sie auf `1`, um ein Modell auf Subagents, Teammates und Workflow-Agents zu erzwingen. [Jeden Subagent auf einem Modell ausführen](/docs/de/sub-agents#run-every-subagent-on-one-model) sagt, welches Modell das ist. Erfordert Claude Code v2.1.257 oder später |

387| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Setzen Sie `5m` oder `1h`, die einzigen Werte, die Claude Code akzeptiert, um die [Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) für Anfragen außerhalb der Hauptkonversation zu wählen, wie [Subagents](/docs/de/sub-agents), Workflows und Hintergrundarbeit. Hat Vorrang vor der `subagentPromptCacheTtl`-Einstellung und über `ENABLE_PROMPT_CACHING_1H`, und `FORCE_PROMPT_CACHING_5M` überschreibt es. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einer höheren Rate. Erfordert Claude Code v2.1.242 oder später |390| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Setzen Sie `5m` oder `1h`, die einzigen Werte, die Claude Code akzeptiert, um die [Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) für Anfragen außerhalb der Hauptkonversation zu wählen, wie [Subagents](/docs/de/sub-agents), Workflows und Hintergrundarbeit. Hat Vorrang vor der `subagentPromptCacheTtl`-Einstellung und über `ENABLE_PROMPT_CACHING_1H`, und `FORCE_PROMPT_CACHING_5M` überschreibt es. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einer höheren Rate. Erfordert Claude Code v2.1.242 oder später |

388| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Setzen Sie auf `1`, um Anmeldedaten aus Subprocess-Umgebungen zu entfernen (Bash-Tool, Hooks, MCP-Stdio-Server): Anthropic- und Cloud-Provider-Anmeldedaten, jede andere Variable, die Claude Code als Anmeldedaten erkennt, und Anmeldedaten, die in Package-Registry-URLs eingebettet sind. Der übergeordnete Claude-Prozess behält diese Anmeldedaten für API-Aufrufe, aber Kind-Prozesse können sie nicht lesen, was die Exposition gegenüber Prompt-Injection-Angriffen reduziert, die versuchen, Geheimnisse über Shell-Expansion zu exfiltrieren. Auf v2.1.251 oder später entfernt der Scrub auch Claude Code's eigene Konfigurationsspeicher-Pointer-Variablen (wie `CLAUDE_CONFIG_DIR`), daher kann ein Kind-Prozess ein verlegtes Konfigurationsverzeichnis nicht lokalisieren. Lassen Sie den Scrub nicht gesetzt, wenn ein Subprocess diese Variablen braucht. Auf Linux führt dies auch Bash-Subprozesse in einem isolierten PID-Namespace aus, daher können sie Host-Prozess-Umgebungen über `/proc` nicht lesen; als Nebeneffekt können `ps`, `pgrep` und `kill` Host-Prozesse nicht sehen oder signalisieren. `claude-code-action` setzt dies automatisch, wenn `allowed_non_write_users` konfiguriert ist |391| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Setzen Sie auf `1`, um Credentials aus Subprocess-Umgebungen zu entfernen (Bash-Tool, Hooks, MCP-Stdio-Server): Anthropic- und Cloud-Provider-Credentials, jede andere Variable, die Claude Code als Credential erkennt, und Credentials, die in Package-Registry-URLs eingebettet sind. Der übergeordnete Claude-Prozess behält diese Credentials für API-Aufrufe, aber Child-Prozesse können sie nicht lesen, was die Exposition gegenüber Prompt-Injection-Angriffen reduziert, die versuchen, Secrets über Shell-Expansion zu exfiltrieren. Auf v2.1.251 oder später entfernt die Scrub auch Claude Code's eigene Konfigurationsspeicher-Pointer-Variablen (wie `CLAUDE_CONFIG_DIR`), daher kann ein Child-Prozess ein verlegtes Konfigurationsverzeichnis nicht lokalisieren. Lassen Sie die Scrub nicht gesetzt, wenn ein Subprocess diese Variablen braucht. Auf Linux führt dies auch Bash-Subprozesse in einem isolierten PID-Namespace aus, daher können sie Host-Prozess-Umgebungen über `/proc` nicht lesen; als Nebeneffekt können `ps`, `pgrep` und `kill` Host-Prozesse nicht sehen oder signalisieren. `claude-code-action` setzt dies automatisch, wenn `allowed_non_write_users` konfiguriert ist |

389| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Setzen Sie auf `1` im nicht-interaktiven Modus (das `-p`-Flag), um auf die Fertigstellung der Plugin-Installation zu warten, bevor die erste Query. Ohne dies installieren sich Plugins im Hintergrund und sind möglicherweise nicht beim ersten Turn verfügbar. Kombinieren Sie mit `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, um das Warten zu begrenzen |392| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Setzen Sie auf `1` im nicht-interaktiven Modus (das `-p`-Flag), um auf die Fertigstellung der Plugin-Installation zu warten, bevor die erste Query. Ohne dies installieren sich Plugins im Hintergrund und sind möglicherweise nicht beim ersten Turn verfügbar. Kombinieren Sie mit `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, um das Warten zu begrenzen |

390| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für synchrone Plugin-Installation. Wenn überschritten, fährt Claude Code ohne Plugins fort und protokolliert einen Fehler. Kein Standard: ohne diese Variable wartet synchrone Installation bis zur Fertigstellung |393| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für synchrone Plugin-Installation. Wenn überschritten, fährt Claude Code ohne Plugins fort und protokolliert einen Fehler. Kein Standard: ohne diese Variable wartet synchrone Installation bis zur Fertigstellung |

391| `CLAUDE_CODE_SYNC_SKILLS` | Setzen Sie auf `1` im nicht-interaktiven Modus mit dem `-p`-Flag, um Claude Code die Skills herunterladen zu lassen, die für Ihr claude.ai-Konto in diesem Lauf aktiviert sind, und auf die Liste von ihnen zu warten, bis zu `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, bevor es die erste Query ausführt. Die Downloads selbst beenden sich im Hintergrund, und Claude wartet auf den Download eines Skills, wenn er diesen Skill aufruft. Erfordert claude.ai-Authentifizierung. Terminal-Sitzungen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden, [laden diese Skills](/docs/de/skills#where-synced-skills-load) in `~/.claude/skills/synced/` herunter und resynchronisieren etwa alle 10 Minuten ohne diese Variable, daher setzen Sie es nur, wenn ein `-p`-Lauf Ihre aktuellen Skills bei seiner ersten Query braucht. Vor v2.1.273 luden Terminal-Sitzungen sie nur in einem `-p`-Lauf mit dieser Variable gesetzt herunter. Der `synced`-Ordner-Name ist [für diesen Download reserviert](/docs/de/skills#where-skills-live). Vor v2.1.227 luden die Skills in `~/.claude/skills/` direkt herunter. Claude Code wendet [zusätzliche Regeln auf die heruntergeladenen Skills](/docs/de/skills#how-synced-skills-behave) an, wie das Nicht-Ausführen ihrer `!`-Befehle auf Ihrer Maschine |394| `CLAUDE_CODE_SYNC_SKILLS` | Setzen Sie auf `1` im nicht-interaktiven Modus mit dem `-p`-Flag, um Claude Code die Skills herunterladen zu lassen, die für Ihr claude.ai-Konto in diesem Lauf aktiviert sind, und auf die Liste von ihnen zu warten, bis zu `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, bevor es die erste Query ausführt. Die Downloads selbst beenden sich im Hintergrund, und Claude wartet auf den Download eines Skills, wenn er diesen Skill aufruft. Erfordert claude.ai-Authentifizierung. Terminal-Sitzungen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden, [laden diese Skills](/docs/de/skills#where-synced-skills-load) in `~/.claude/skills/synced/` herunter und resynchronisieren etwa alle 10 Minuten ohne diese Variable, daher setzen Sie es nur, wenn ein `-p`-Lauf Ihre aktuellen Skills bei seiner ersten Query braucht. Vor v2.1.273 luden Terminal-Sitzungen sie nur in einem `-p`-Lauf mit dieser Variable gesetzt herunter. Der `synced`-Ordner-Name ist [für diesen Download reserviert](/docs/de/skills#where-skills-live). Vor v2.1.227 luden die Skills in `~/.claude/skills/` direkt herunter. Claude Code wendet [Extra-Regeln auf die heruntergeladenen Skills](/docs/de/skills#how-synced-skills-behave) an, wie das Nicht-Ausführen ihrer `!`-Befehle auf Ihrer Maschine |

392| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für die Skills-Resynchronisierung, die mid-session läuft, wenn eine App, die auf dem [Agent SDK](/docs/de/agent-sdk/typescript#query-object) gebaut ist, Skills neu lädt (Standard: 30000). Wenn überschritten, fährt das Neuladen mit welchen Skills auch immer angekommen sind fort, und die verbleibenden Downloads beenden sich im Hintergrund |395| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für die Skills-Resynchronisierung, die mid-session läuft, wenn eine App, die auf dem [Agent SDK](/docs/de/agent-sdk/typescript#query-object) gebaut ist, Skills neu lädt (Standard: 30000). Wenn überschritten, fährt das Reload mit welchen Skills auch immer angekommen sind fort, und die verbleibenden Downloads beenden sich im Hintergrund |

393| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in Millisekunden für die erste Query zum Warten auf die anfängliche Skill-Liste, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 5000). Wenn überschritten, läuft die erste Query mit welchen Skills auch immer angekommen sind. Die Downloads beenden sich im Hintergrund in jedem Fall, und Claude wartet auf den Download eines Skills, wenn er diesen Skill aufruft |396| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in Millisekunden für die erste Query zum Warten auf die anfängliche Skill-Liste, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 5000). Wenn überschritten, läuft die erste Query mit welchen Skills auch immer angekommen sind. Die Downloads beenden sich im Hintergrund in jedem Fall, und Claude wartet auf den Download eines Skills, wenn er diesen Skill aufruft |

394| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Setzen Sie auf `false`, um Syntax-Highlighting in Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihr Terminal-Setup stören. Um Highlighting auch in Code-Blöcken und Datei-Vorschauen zu deaktivieren, verwenden Sie die [`syntaxHighlightingDisabled`](/docs/de/settings-reference#syntaxhighlightingdisabled)-Einstellung |397| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Setzen Sie auf `false`, um Syntax-Highlighting in Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihr Terminal-Setup stören. Um Highlighting auch in Code-Blöcken und Datei-Vorschauen zu deaktivieren, verwenden Sie die [`syntaxHighlightingDisabled`](/docs/de/settings-reference#syntaxhighlightingdisabled)-Einstellung |

395| `CLAUDE_CODE_TASK_LIST_ID` | Teilen Sie eine Task-Liste über Sitzungen. Setzen Sie die gleiche ID in mehreren Claude Code-Instanzen, um an einer gemeinsamen Task-Liste zu koordinieren, in [Sitzungen, die die Task-Tools haben](/docs/de/tools-reference#task-tool-availability). Siehe [Task-Liste](/docs/de/interactive-mode#task-list) |398| `CLAUDE_CODE_TASK_LIST_ID` | Teilen Sie eine Task-Liste über Sitzungen. Setzen Sie die gleiche ID in mehreren Claude Code-Instanzen, um an einer gemeinsamen Task-Liste zu koordinieren, in [Sitzungen, die die Task-Tools haben](/docs/de/tools-reference#task-tool-availability). Siehe [Task-Liste](/docs/de/interactive-mode#task-list) |

396| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Überschreiben Sie, in Millisekunden, wie lange eine nicht-interaktive Sitzung beim Beenden auf ihr [Agent-Team](/docs/de/agent-teams) wartet, um sich abzubauen. Akzeptiert 1000 bis 60000; ein Out-of-Range-Wert wird ignoriert und der Standard von 10000 gilt. Erfordert Claude Code v2.1.206 oder später |399| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Überschreiben Sie in Millisekunden, wie lange eine nicht-interaktive Sitzung beim Exit auf ihr [Agent Team](/docs/de/agent-teams) wartet, um sich abzubauen. Akzeptiert 1000 bis 60000; ein Out-of-Range-Wert wird ignoriert und der Standard von 10000 gilt. Erfordert Claude Code v2.1.206 oder später |

397| `CLAUDE_CODE_TMPDIR` | Überschreiben Sie das Temp-Verzeichnis, das für interne Temp-Dateien verwendet wird. Claude Code hängt `/claude-{uid}/` auf Unix oder `/claude/` auf Windows an diesen Pfad an. Standard: `/tmp` auf macOS, `os.tmpdir()` auf Linux und Windows. Auf macOS und Linux erhalten [Sandboxed](/docs/de/sandboxing)-Bash-Subprozesse einen kurzen Fallback-`$TMPDIR` unter dem System-Standard, wenn Ihr Override ein langer Pfad ist, da einige Tools fehlschlagen, wenn Temp-Pfade zu lang werden. Nicht-Sandboxed-Bash-Befehle erben Ihren Shell-`$TMPDIR`, wenn er gesetzt ist. Claude Code's eigene Temp-Dateien verwenden immer Ihren Override. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |400| `CLAUDE_CODE_TMPDIR` | Überschreiben Sie das Temp-Verzeichnis, das für interne Temp-Dateien verwendet wird. Claude Code hängt `/claude-{uid}/` auf Unix oder `/claude/` auf Windows an diesen Pfad an. Standard: `/tmp` auf macOS, `os.tmpdir()` auf Linux und Windows. Auf macOS und Linux erhalten [Sandboxed](/docs/de/sandboxing)-Bash-Subprozesse einen kurzen Fallback-`$TMPDIR` unter dem System-Standard, wenn Ihr Override ein langer Pfad ist, da einige Tools fehlschlagen, wenn Temp-Pfade zu lang werden. Nicht-Sandboxed-Bash-Befehle erben Ihren Shell's `$TMPDIR`, wenn es gesetzt ist. Claude Code's eigene Temp-Dateien verwenden immer Ihren Override. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

398| `CLAUDE_CODE_TMUX_TRUECOLOR` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um 24-Bit-Truecolor-Ausgabe in tmux zu erlauben. **Das Setzen auf `0` oder `false` erlaubt immer noch Truecolor**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um die 256-Farben-Begrenzung wiederherzustellen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, weil tmux Truecolor-Escape-Sequenzen nicht durchleitet, es sei denn, es ist konfiguriert. Setzen Sie dies nach dem Hinzufügen von `set -ga terminal-overrides ',*:Tc'` zu Ihrer `~/.tmux.conf`. Siehe [Terminal-Konfiguration](/docs/de/terminal-config) für andere tmux-Einstellungen |401| `CLAUDE_CODE_TMUX_TRUECOLOR` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um 24-Bit-Truecolor-Ausgabe in tmux zu erlauben. **Das Setzen auf `0` oder `false` erlaubt immer noch Truecolor**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um die 256-Farben-Begrenzung wiederherzustellen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, weil tmux Truecolor-Escape-Sequenzen nicht durchleitet, es sei denn, es ist konfiguriert. Setzen Sie dies nach dem Hinzufügen von `set -ga terminal-overrides ',*:Tc'` zu Ihrer `~/.tmux.conf`. Siehe [Terminal-Konfiguration](/docs/de/terminal-config) für andere tmux-Einstellungen |

399| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Auf Linux und WSL setzen Sie auf eine komma-getrennte Liste der Arten von Prozessen, die Claude Code [von der Tool-Memory-Obergrenze ausschließt](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), wie `mcp` oder `lsp`. Setzen Sie `none`, um jeden Kind zu deckeln, oder `all-new`, um nur Bash-, PowerShell- und Monitor-Tool-Befehle zu deckeln. Claude Code hält Bash-, PowerShell- und Monitor-Tool-Befehle unter der Obergrenze, was auch immer Sie auflisten. Erfordert Claude Code v2.1.246 oder später |402| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Auf Linux und WSL setzen Sie auf eine komma-getrennte Liste der Arten von Prozessen, die Claude Code [von der Tool-Memory-Obergrenze ausschließt](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), wie `mcp` oder `lsp`. Setzen Sie `none`, um jeden Kind zu begrenzen, oder `all-new`, um nur Bash-, PowerShell- und Monitor-Tool-Befehle zu begrenzen. Claude Code hält Bash-, PowerShell- und Monitor-Tool-Befehle unter der Obergrenze, was auch immer Sie auflisten. Erfordert Claude Code v2.1.246 oder später |

400| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Auf Linux und WSL setzen Sie auf eine Größe wie `4G`, um [den Speicher, den Bash- und PowerShell-Tool-Befehle verwenden können, zu deckeln](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), und Monitor-Tool-Befehle auf v2.1.246 oder später. Schreiben Sie die Größe in einfachen Ziffern, allein für eine Anzahl von Bytes oder mit einem `K`-, `M`-, `G`- oder `T`-Suffix. Setzen Sie `0` oder `off`, um die Obergrenze auszuschalten. Sobald der erste Prozess, den Claude Code startet, die Obergrenze ein- oder ausgeschaltet hat, hat ein geänderter Wert Auswirkung, wenn Sie `claude` nächstes Mal starten. Erfordert Claude Code v2.1.233 oder später |403| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Auf Linux und WSL setzen Sie auf eine Größe wie `4G`, um [den Speicher zu begrenzen, den Bash- und PowerShell-Tool-Befehle verwenden können](/docs/de/tools-reference#memory-limit-on-linux-and-wsl), und Monitor-Tool-Befehle auf v2.1.246 oder später. Schreiben Sie die Größe in einfachen Ziffern, allein für eine Anzahl von Bytes oder mit einem `K`-, `M`-, `G`- oder `T`-Suffix. Setzen Sie `0` oder `off`, um die Obergrenze auszuschalten. Sobald der erste Prozess, den Claude Code startet, die Obergrenze ein- oder ausgeschaltet hat, tritt ein geänderter Wert in Kraft, wenn Sie `claude` nächstes Mal starten. Erfordert Claude Code v2.1.233 oder später |

401| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Frist in Millisekunden, bevor Claude Code einen Dialog abbricht, den es an einen Remote-Client wie einen [Remote Control](/docs/de/remote-control) oder SDK-Host weiterleitet, oder den Genehmigungsdialog für eine [gehaltene Cross-Session-Nachricht](/docs/de/cross-session-messaging#control-inbound-messages); Permission-Prompts und `AskUserQuestion`-Fragen verwenden ihre eigenen Flows und werden nicht dadurch gesteuert. Auf Claude Code v2.1.236 oder später begrenzt es auch den Mid-Session-[Fable-Nutzungs-Credits-Zustimmungs-Prompt](/docs/de/model-config#fable-and-usage-credits) in einer Sitzung, die möglicherweise unbeaufsichtigt läuft. [Inbound-Nachrichten steuern](/docs/de/cross-session-messaging#control-inbound-messages) und [nicht-interaktive Sitzungen](/docs/de/cross-session-messaging#non-interactive-sessions) decken die vollständigen gehaltenen-Nachrichten-Ablauf-Regeln ab, einschließlich der Fälle, wo die Frist nicht gilt. Überschreibt die [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry)-Einstellung. `0` oder ein negativer Wert deaktiviert die Frist |404| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Deadline in Millisekunden, bevor Claude Code einen Dialog abbricht, den es an einen Remote-Client wie einen [Remote Control](/docs/de/remote-control) oder SDK-Host weiterleitet, oder den Genehmigungsdialog für eine [gehaltene Cross-Session-Nachricht](/docs/de/cross-session-messaging#control-inbound-messages); Permission-Prompts und `AskUserQuestion`-Fragen verwenden ihre eigenen Flows und werden nicht dadurch gesteuert. Auf Claude Code v2.1.236 oder später begrenzt es auch den Mid-Session-[Fable-Nutzungs-Credits-Zustimmungs-Prompt](/docs/de/model-config#fable-and-usage-credits) in einer Sitzung, die möglicherweise unbeaufsichtigt läuft. [Inbound-Nachrichten steuern](/docs/de/cross-session-messaging#control-inbound-messages) und [nicht-interaktive Sitzungen](/docs/de/cross-session-messaging#non-interactive-sessions) decken die vollständigen gehaltenen Nachricht-Ablauf-Regeln ab, einschließlich der Fälle, wo die Deadline nicht gilt. Überschreibt die [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry)-Einstellung. `0` oder ein negativer Wert deaktiviert die Deadline |

405| `CLAUDE_CODE_USE_MANTLE` | Verwenden Sie den Amazon Bedrock [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |408| `CLAUDE_CODE_USE_MANTLE` | Verwenden Sie den Amazon Bedrock [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |

406| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Setzen Sie auf `1`, um benutzerdefinierte Befehle, Subagents und Ausgabe-Stile mit Node.js-Datei-APIs statt ripgrep zu entdecken. Setzen Sie dies, wenn die gebündelte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Betrifft nicht die Grep- oder Datei-Such-Tools |409| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Setzen Sie auf `1`, um benutzerdefinierte Befehle, Subagents und Output-Stile mit Node.js-Datei-APIs statt ripgrep zu entdecken. Setzen Sie dies, wenn die gebündelte ripgrep-Binärdatei nicht verfügbar oder blockiert ist in Ihrer Umgebung. Betrifft nicht die Grep- oder Datei-Such-Tools |

407| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Auf Windows ohne Git Bash ist das Tool automatisch aktiviert; setzen Sie auf `0`, um es zu deaktivieren. Auf Windows mit Git Bash installiert ist das Tool standardmäßig für claude.ai und Console-Konten eingeschaltet; setzen Sie auf `1`, um es in Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-Sitzungen zu aktivieren, oder `0`, um es auszuschalten. Auf Linux, macOS und WSL setzen Sie auf `1`, um es zu aktivieren, was `pwsh` auf Ihrem `PATH` erfordert. Wenn aktiviert auf Windows, kann Claude PowerShell-Befehle nativ ausführen, anstatt durch Git Bash zu leiten. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) |410| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Auf Windows ohne Git Bash ist das Tool automatisch aktiviert; setzen Sie auf `0`, um es zu deaktivieren. Auf Windows mit Git Bash installiert ist das Tool standardmäßig für claude.ai und Console-Konten aktiviert; setzen Sie auf `1`, um es in Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-Sitzungen zu aktivieren, oder `0`, um es auszuschalten. Auf Linux, macOS und WSL setzen Sie auf `1`, um es zu aktivieren, was `pwsh` auf Ihrem `PATH` erfordert. Wenn aktiviert auf Windows, kann Claude PowerShell-Befehle nativ ausführen, anstatt durch Git Bash zu routen. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) |

409| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Setzen Sie auf die Anzahl der Millisekunden, die [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) jede abgerufene URL's Antwort zwischenspeichert. Der Standard ist `900000`, was 15 Minuten ist. Akzeptiert nur einfache Ziffern; `0`, ein Dezimal oder jede andere Schreibweise behält den Standard. Claude Code liest den Wert einmal pro Start, daher gilt eine Änderung in einem Einstellungs-`env`-Block, wenn Sie `claude` nächstes Mal starten. Erfordert Claude Code v2.1.233 oder später |412| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Setzen Sie auf die Anzahl der Millisekunden, die [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) jede abgerufene URL's Antwort zwischenspeichert. Der Standard ist `900000`, was 15 Minuten ist. Akzeptiert nur einfache Ziffern; `0`, eine Dezimalzahl oder jede andere Schreibweise behält den Standard. Claude Code liest den Wert einmal pro Start, daher gilt eine Änderung in einem Einstellungs-`env`-Block, wenn Sie `claude` nächstes Mal starten. Erfordert Claude Code v2.1.233 oder später |

410| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Obergrenze in Millisekunden, wie lange [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) auf das Herunterladen einer Seite wartet, einschließlich aller Umleitungen, denen es folgt. Ein Download, der bis dahin nicht abgeschlossen ist, schlägt mit einem Deadline-Fehler fehl. Der Standard ist `300000`, was fünf Minuten ist. Setzen Sie auf `0`, um die Obergrenze zu entfernen. Akzeptiert nur einfache Ziffern; ein Dezimal oder jede andere Schreibweise behält den Standard. Erfordert Claude Code v2.1.268 oder später |413| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Obergrenze in Millisekunden, wie lange [WebFetch](/docs/de/tools-reference#webfetch-tool-behavior) auf das Herunterladen einer Seite wartet, einschließlich aller Umleitungen, die es folgt. Ein Download, der bis dahin nicht abgeschlossen ist, schlägt mit einem Deadline-Fehler fehl. Der Standard ist `300000`, was fünf Minuten ist. Setzen Sie auf `0`, um die Obergrenze zu entfernen. Akzeptiert nur einfache Ziffern; eine Dezimalzahl oder jede andere Schreibweise behält den Standard. Erfordert Claude Code v2.1.268 oder später |

411| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Wie viele Agents ein einzelner [Workflow](/docs/de/workflows)-Lauf gleichzeitig ausführt, von `1` bis `256`. Standardmäßig führt ein Lauf bis zu 16 Agents gleichzeitig aus, weniger, wenn Claude Code weniger CPUs verfügbar hat; wartende `agent()`-Aufrufe warten auf einen freien Slot. Das Transkript jedes laufenden Agents bleibt in Claude Code's Speicher, daher erhöhen höhere Werte die Speichernutzung. Akzeptiert nur einfache Ziffern; Out-of-Range-Werte und andere Schreibweisen behalten den Standard. Erfordert Claude Code v2.1.269 oder später |414| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Wie viele Agents ein einzelner [Workflow](/docs/de/workflows)-Lauf gleichzeitig ausführt, von `1` bis `256`. Standardmäßig führt ein Lauf bis zu 16 Agents gleichzeitig aus, weniger, wenn Claude Code weniger CPUs verfügbar hat; wartende `agent()`-Aufrufe warten auf einen freien Slot. Jeder laufende Agent's Transkript bleibt in Claude Code's Speicher, daher erhöhen höhere Werte die Speichernutzung. Akzeptiert nur einfache Ziffern; Out-of-Range-Werte und andere Schreibweisen behalten den Standard. Erfordert Claude Code v2.1.269 oder später |

412| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Obergrenze in Millisekunden, wie lange ein [Workflow](/docs/de/workflows)-Agent auf die erste Antwort eines gleich-Präfix-Siblings wartet, bevor er seine eigene erste Anfrage sendet. Wenn ein Fan-Out mehrere Agents startet, die einen [Prompt-Cache-Präfix](/docs/de/workflows#prompt-caching-in-a-fan-out) teilen, hält Claude Code alle außer dem ersten Agent für bis zu diese lange, daher lesen die restlichen den zwischengespeicherten Präfix, anstatt ihn jeweils nicht zwischengespeichert zu verarbeiten. Standard `5000`. Setzen Sie auf `0`, um das Warten zu deaktivieren. Wenn `DISABLE_PROMPT_CACHING` gesetzt ist, warten Agents nie. Erfordert Claude Code v2.1.229 oder später |415| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Obergrenze in Millisekunden, wie lange ein [Workflow](/docs/de/workflows)-Agent auf die erste Antwort eines gleich-Präfix-Siblings wartet, bevor er seine eigene erste Anfrage sendet. Wenn ein Fan-Out mehrere Agents startet, die einen [Prompt-Cache-Präfix](/docs/de/workflows#prompt-caching-in-a-fan-out) teilen, hält Claude Code alle außer dem ersten Agent für bis zu diese lange, daher lesen die restlichen den zwischengespeicherten Präfix, anstatt ihn jeweils unkomprimiert zu verarbeiten. Standard `5000`. Setzen Sie auf `0`, um das Warten zu deaktivieren. Wenn `DISABLE_PROMPT_CACHING` gesetzt ist, warten Agents nie. Erfordert Claude Code v2.1.229 oder später |

413| `CLAUDE_CONFIG_DIR` | Überschreiben Sie das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, Sitzungs-Verlauf und Plugins werden unter diesem Pfad gespeichert. Für Anmeldedaten siehe [wo Claude Code Anmeldedaten speichert](/docs/de/authentication#credential-management). Nützlich zum Ausführen mehrerer Konten nebeneinander: zum Beispiel `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |416| `CLAUDE_CONFIG_DIR` | Überschreiben Sie das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, Sitzungs-Verlauf und Plugins werden unter diesem Pfad gespeichert. Für Credentials siehe [wo Claude Code Credentials speichert](/docs/de/authentication#credential-management). Nützlich zum Ausführen mehrerer Konten nebeneinander: zum Beispiel `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

414| `CLAUDE_DISABLE_ADOPT` | Setzen Sie auf `1`, um laufende Hintergrundarbeit zu stoppen, anstatt sie zu tragen, wenn Sie eine Sitzung durch Drücken von `←` oder mit [`/background`](/docs/de/agent-view#from-inside-a-session) hintergrund-verschieben. Claude Code fragt Sie, um zu bestätigen, bevor Sie hintergrund-verschieben, dann stoppt die Aufgaben, die andernfalls getragen würden. Erfordert Claude Code v2.1.195 oder später |417| `CLAUDE_DISABLE_ADOPT` | Setzen Sie auf `1`, um laufende Hintergrundarbeit zu stoppen, anstatt sie zu tragen, wenn Sie eine Sitzung backgrounden, indem Sie `←` drücken oder [`/background`](/docs/de/agent-view#from-inside-a-session) verwenden. Claude Code fragt Sie zur Bestätigung auf, bevor Sie backgrounden, dann stoppt die Aufgaben, die andernfalls getragen würden. Erfordert Claude Code v2.1.195 oder später |

415| `CLAUDE_EFFORT` | Wird automatisch in Bash-Tool-Subprozessen und Hook-Befehlen auf die [Effort-Ebene](/docs/de/model-config#adjust-effort-level) gesetzt, die in Kraft ist, wenn der Subprocess startet: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine unterschiedliche Ebene und meldet sich als `xhigh`. Entspricht dem `effort.level`-Feld, das an [Hooks](/docs/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |418| `CLAUDE_EFFORT` | Wird automatisch in Bash-Tool-Subprozessen und Hook-Befehlen auf die [Effort-Ebene](/docs/de/model-config#adjust-effort-level) gesetzt, die in Kraft ist, wenn der Subprocess startet: `low`, `medium`, `high`, `xhigh` oder `max`. Entspricht dem `effort.level`-Feld, das an [Hooks](/docs/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |

416| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog zu erzwingen, oder setzen Sie auf `0`, um ihn zu erzwingen-deaktivieren. `0` schaltet auch die [First-Byte-Frist](/docs/de/network-config#streaming-idle-watchdogs) auf den Verbindungen aus, wo diese Frist läuft. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Anthropic API- und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Verbindungen aktiviert, und für Streaming-Antworten auf [Gateway](/docs/de/gateways)-Verbindungen, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht werden; vor v2.1.222 lief er nicht auf diesen Gateway-Verbindungen, daher konnte der Event-Level-Watchdog dort einen Stall melden, auch während Keep-Alive-Pings ankamen. Für Timeouts und wie die Timer interagieren, siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |419| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog zu erzwingen, oder setzen Sie auf `0`, um ihn zu erzwingen-deaktivieren. `0` schaltet auch die [First-Byte-Deadline](/docs/de/network-config#streaming-idle-watchdogs) auf den Verbindungen aus, wo diese Deadline läuft. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Anthropic API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Verbindungen aktiviert, und für Streaming-Antworten auf [Gateway](/docs/de/gateways)-Verbindungen, die durch `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht werden; vor v2.1.222 lief er nicht auf diesen Gateway-Verbindungen, daher konnte der Event-Level-Watchdog einen Stall dort melden, auch während Keep-Alive-Pings ankamen. Für Timeouts und wie die Timer interagieren, siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |

417| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog auf Amazon Bedrock `vnd.amazon.eventstream`-Antworten zu aktivieren, was auch die [First-Byte-Frist](/docs/de/network-config#streaming-idle-watchdogs) auf Bedrock-Streaming-Anfragen aktiviert. Standardmäßig aus. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |420| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog auf Amazon Bedrock `vnd.amazon.eventstream`-Antworten zu aktivieren, was auch die [First-Byte-Deadline](/docs/de/network-config#streaming-idle-watchdogs) auf Bedrock-Streaming-Anfragen aktiviert. Standardmäßig aus. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

418| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Setzen Sie auf `0`, um den Event-Level-Streaming-Idle-Watchdog zu erzwingen-deaktivieren, oder setzen Sie auf `1`, um ihn zu erzwingen-aktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Provider eingeschaltet. Vor v2.1.196 war der nicht-gesetzte Standard Server-gesteuert auf der direkten Anthropic API und aus auf anderen Providern. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; für die anderen Stall-Timer, die neben diesem laufen, siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |421| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Setzen Sie auf `0`, um den Event-Level-Streaming-Idle-Watchdog zu erzwingen-deaktivieren, oder setzen Sie auf `1`, um ihn zu erzwingen-aktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Provider eingeschaltet. Vor v2.1.196 war der nicht gesetzte Standard Server-gesteuert auf der direkten Anthropic API und aus auf anderen Providern. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; für die anderen Stall-Timer, die neben diesem laufen, siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |

419| `CLAUDE_ENV_FILE` | Pfad zu einem Shell-Skript, dessen Inhalt Claude Code vor jedem Bash-Befehl im gleichen Shell-Prozess ausführt, daher sind Exports in der Datei für den Befehl sichtbar. Verwenden Sie, um virtualenv- oder Conda-Aktivierung über Befehle hinweg zu persistieren. Wird auch dynamisch von [SessionStart](/docs/de/hooks#persist-environment-variables), [Setup](/docs/de/hooks#setup), [CwdChanged](/docs/de/hooks#cwdchanged) und [FileChanged](/docs/de/hooks#filechanged)-Hooks gefüllt |422| `CLAUDE_ENV_FILE` | Pfad zu einem Shell-Skript, dessen Inhalt Claude Code vor jedem Bash-Befehl im gleichen Shell-Prozess ausführt, daher sind Exports in der Datei für den Befehl sichtbar. Verwenden Sie, um virtualenv- oder Conda-Aktivierung über Befehle hinweg zu persistieren. Wird auch dynamisch von [SessionStart](/docs/de/hooks#persist-environment-variables), [Setup](/docs/de/hooks#setup), [CwdChanged](/docs/de/hooks#cwdchanged) und [FileChanged](/docs/de/hooks#filechanged)-Hooks gefüllt |

420| `CLAUDE_JOB_DIR` | Wird von Claude Code in jeder [Hintergrund-Sitzung](/docs/de/agent-view) auf das `~/.claude/jobs/<id>`-Verzeichnis dieser Sitzung gesetzt. Shell-Befehle, die die Sitzung ausführt, erben es. Schreiben Sie Scratch-Dateien zu [`$CLAUDE_JOB_DIR/tmp`](/docs/de/agent-view#where-state-is-stored). Claude's `Write`- und `Edit`-Aufrufe dort fragen nicht nach Genehmigung, und das Verzeichnis wird entfernt, wenn die Sitzung gelöscht wird |423| `CLAUDE_JOB_DIR` | Wird von Claude Code in jeder [Hintergrund-Sitzung](/docs/de/agent-view) auf das `~/.claude/jobs/<id>`-Verzeichnis dieser Sitzung gesetzt. Shell-Befehle, die die Sitzung ausführt, erben es. Schreiben Sie Scratch-Dateien zu [`$CLAUDE_JOB_DIR/tmp`](/docs/de/agent-view#where-state-is-stored). Claude's `Write`- und `Edit`-Aufrufe dort fordern keine Permission an, und das Verzeichnis wird entfernt, wenn die Sitzung gelöscht wird |

421| `CLAUDE_PID` | Claude Code setzt dies auf seine eigene Prozess-ID in den Subprozessen, die es spawnt: Bash- und PowerShell-Tool-Befehle und Hook-Befehle. Auf Linux verwendet die Bash-Tool's Shell-Integration es, um ein `pkill`-Muster zu weigern, das den Claude Code-Prozess selbst entsprechen würde; siehe [die Fehler-Referenz](/docs/de/errors#pkill-pattern-matches-the-claude-code-process). Lesen Sie es aus Ihren eigenen Skripten, um den übergeordneten Claude Code-Prozess absichtlich zu identifizieren oder zu signalisieren. Erfordert Claude Code v2.1.214 oder später |424| `CLAUDE_PID` | Claude Code setzt dies auf seine eigene Prozess-ID in den Subprozessen, die es spawnt: Bash- und PowerShell-Tool-Befehle und Hook-Befehle. Auf Linux verwendet die Bash-Tool's Shell-Integration es, um ein `pkill`-Muster zu verweigern, das den Claude Code-Prozess selbst entsprechen würde; siehe [die Fehler-Referenz](/docs/de/errors#pkill-pattern-matches-the-claude-code-process). Lesen Sie es aus Ihren eigenen Skripten, um den übergeordneten Claude Code-Prozess absichtlich zu identifizieren oder zu signalisieren. Erfordert Claude Code v2.1.214 oder später |

422| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Präfix für Auto-generierte [Remote Control](/docs/de/remote-control)-Sitzungs-Namen, wenn kein expliziter Name bereitgestellt wird. Standard ist der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` produziert. Das `--remote-control-session-name-prefix`-CLI-Flag setzt den gleichen Wert für einen einzelnen Aufruf |425| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Präfix für Auto-generierte [Remote Control](/docs/de/remote-control)-Sitzungs-Namen, wenn kein expliziter Name bereitgestellt wird. Standardmäßig der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` produziert. Das `--remote-control-session-name-prefix`-CLI-Flag setzt den gleichen Wert für einen einzelnen Aufruf |

423| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Frist in Millisekunden für das erste Response-Byte einer Streaming-Anfrage, auf den Verbindungen, wo die [First-Byte-Frist](/docs/de/network-config#streaming-idle-watchdogs) läuft. Für wie Claude Code es begrenzt, die zusätzliche Zeit, die es für große Request-Bodies hinzufügt, und wie es die Frist wählt, wenn Sie dies nicht gesetzt lassen, siehe [Keine Antwort von API](/docs/de/errors#no-response-from-api). Erfordert Claude Code v2.1.242 oder später |426| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Deadline in Millisekunden für das erste Response-Byte einer Streaming-Anfrage, auf den Verbindungen, wo die [First-Byte-Deadline](/docs/de/network-config#streaming-idle-watchdogs) läuft. Für wie Claude Code es begrenzt, die Extra-Zeit, die es für große Request-Bodies hinzufügt, und wie es die Deadline wählt, wenn Sie dies nicht gesetzt lassen, siehe [Keine Antwort von API](/docs/de/errors#no-response-from-api). Erfordert Claude Code v2.1.242 oder später |

424| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden, bevor die Event- und Byte-Level-Streaming-Idle-Watchdogs eine steckengebliebene Verbindung schließen. Wenn Sie diese Variable explizit setzen, ist das Minimum `300000` (5 Minuten); niedrigere Werte werden stillschweigend auf die Obergrenze begrenzt, um Extended-Thinking-Pausen und Proxy-Buffering zu absorbieren, und der Byte-Level-Watchdog begrenzt den Wert auf 30 Minuten. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` hat Vorrang über diese Variable für den Byte-Level-Watchdog. Für die Pro-Watchdog-nicht-gesetzten Standards siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |427| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden, bevor die Event- und Byte-Level-Streaming-Idle-Watchdogs eine steckengebliebene Verbindung schließen. Wenn Sie diese Variable explizit setzen, ist das Minimum `300000` (5 Minuten); niedrigere Werte werden stillschweigend auf die Obergrenze erhöht, um Extended-Thinking-Pausen und Proxy-Buffering zu absorbieren, und der Byte-Level-Watchdog begrenzt den Wert auf 30 Minuten. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` hat Vorrang über diese Variable für den Byte-Level-Watchdog. Für die Pro-Watchdog-nicht-gesetzten Standards siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) |

425| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Entfernt in v2.1.260 und jetzt ein No-Op. Begrenzte zuvor, wie lange ein [Hintergrund-Shell-Befehl](/docs/de/interactive-mode#background-bash-commands), den ein [Subagent](/docs/de/sub-agents) gestartet hat, in Millisekunden laufen konnte, mit einem 60-Minuten-Standard. Siehe [die Hintergrund-Befehls-Lebenszyklusregeln](/docs/de/tools-reference#background-commands) |428| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Entfernt in v2.1.260 und jetzt ein No-Op. Begrenzte zuvor, wie lange ein [Hintergrund-Shell-Befehl](/docs/de/interactive-mode#background-bash-commands), den ein [Subagent](/docs/de/sub-agents) gestartet hat, in Millisekunden laufen konnte, mit einem 60-Minuten-Standard. Siehe [die Hintergrund-Befehl-Lebensdauer-Regeln](/docs/de/tools-reference#background-commands) |

426| `DEBUG` | Setzen Sie auf `1`, um Debug-Modus zu aktivieren, entsprechend dem Start mit [`--debug`](/docs/de/cli-reference#cli-flags). Debug-Logs werden zu `~/.claude/debug/<session-id>.txt` geschrieben, oder zum Pfad, der von `CLAUDE_CODE_DEBUG_LOGS_DIR` gesetzt wird. Nur die Truthy-Werte `1`, `true`, `yes` und `on` aktivieren Debug-Modus, daher triggern Namespace-Muster wie `DEBUG=express:*`, die für andere Tools gesetzt sind, es nicht |429| `DEBUG` | Setzen Sie auf `1`, um Debug-Modus zu aktivieren, äquivalent zum Starten mit [`--debug`](/docs/de/cli-reference#cli-flags). Debug-Logs werden zu `~/.claude/debug/<session-id>.txt` geschrieben, oder zum Pfad, der von `CLAUDE_CODE_DEBUG_LOGS_DIR` gesetzt ist. Nur die Truthy-Werte `1`, `true`, `yes` und `on` aktivieren Debug-Modus, daher triggern Namespace-Muster wie `DEBUG=express:*`, die für andere Tools gesetzt sind, es nicht |

427| `DISABLE_AUTOUPDATER` | Setzen Sie auf `1`, um automatische Hintergrund-Updates zu deaktivieren. Manuelles `claude update` funktioniert immer noch. Verwenden Sie `DISABLE_UPDATES`, um beides zu blockieren |430| `DISABLE_AUTOUPDATER` | Setzen Sie auf `1`, um automatische Hintergrund-Updates zu deaktivieren. Manuelles `claude update` funktioniert immer noch. Verwenden Sie `DISABLE_UPDATES`, um beides zu blockieren |

428| `DISABLE_AUTO_COMPACT` | Setzen Sie auf `1`, um automatische Compaction zu deaktivieren, wenn sich dem Kontext-Limit nähert. Der manuelle `/compact`-Befehl bleibt verfügbar. Verwenden Sie, wenn Sie explizite Kontrolle darüber möchten, wann Compaction auftritt. Überschreibt die [`autoCompactEnabled`](/docs/de/settings-reference#autocompactenabled)-Einstellung |431| `DISABLE_AUTO_COMPACT` | Setzen Sie auf `1`, um automatische Compaction zu deaktivieren, wenn sich dem Kontext-Limit nähert. Der manuelle `/compact`-Befehl bleibt verfügbar. Verwenden Sie, wenn Sie explizite Kontrolle darüber möchten, wann Compaction auftritt. Überschreibt die [`autoCompactEnabled`](/docs/de/settings-reference#autocompactenabled)-Einstellung |

429| `DISABLE_COMPACT` | Setzen Sie auf `1`, um alle Compaction zu deaktivieren: sowohl automatische Compaction als auch den manuellen `/compact`-Befehl |432| `DISABLE_COMPACT` | Setzen Sie auf `1`, um alle Compaction zu deaktivieren: sowohl automatische Compaction als auch den manuellen `/compact`-Befehl |

431| `DISABLE_DOCTOR_COMMAND` | Setzen Sie auf `1`, um den [`/doctor`](/docs/de/commands#all-commands)-Setup-Checkup-Skill und seinen `/checkup`-Alias zu verbergen. Nützlich für verwaltete Deployments, wo Benutzer Setup-Diagnostiken nicht von einer Sitzung ausführen sollten. Betrifft nicht den `claude doctor`-Terminal-Befehl. Vor v2.1.205 verbarg diese Variable den `/doctor`-Diagnostik-Bildschirm-Befehl |434| `DISABLE_DOCTOR_COMMAND` | Setzen Sie auf `1`, um den [`/doctor`](/docs/de/commands#all-commands)-Setup-Checkup-Skill und seinen `/checkup`-Alias zu verbergen. Nützlich für verwaltete Deployments, wo Benutzer Setup-Diagnostiken nicht von einer Sitzung ausführen sollten. Betrifft nicht den `claude doctor`-Terminal-Befehl. Vor v2.1.205 verbarg diese Variable den `/doctor`-Diagnostik-Bildschirm-Befehl |

432| `DISABLE_ERROR_REPORTING` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um sich von Fehlerberichterstattung abzumelden. **Das Setzen auf `0` oder `false` meldet sich immer noch ab**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um Fehlerberichterstattung wieder einzuschalten |435| `DISABLE_ERROR_REPORTING` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um sich von Fehlerberichterstattung abzumelden. **Das Setzen auf `0` oder `false` meldet sich immer noch ab**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um Fehlerberichterstattung wieder einzuschalten |

433| `DISABLE_EXTRA_USAGE_COMMAND` | Setzen Sie auf `1`, um den `/usage-credits`-Befehl zu verbergen, der Benutzern ermöglicht, zusätzliche Nutzung über Rate-Limits zu kaufen |436| `DISABLE_EXTRA_USAGE_COMMAND` | Setzen Sie auf `1`, um den `/usage-credits`-Befehl zu verbergen, der Benutzern ermöglicht, zusätzliche Nutzung über Rate Limits zu kaufen |

434| `DISABLE_FEEDBACK_COMMAND` | Setzen Sie auf `1`, um den `/feedback`-Befehl und [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) zu deaktivieren. Deaktiviert auch `/bug` und `/share`, die über den gleichen Pfad berichten; vor v2.1.212 waren sie Aliase von `/feedback`, daher war der Befehl unter jedem Namen deaktiviert. Der ältere Name `DISABLE_BUG_COMMAND` wird auch akzeptiert |437| `DISABLE_FEEDBACK_COMMAND` | Setzen Sie auf `1`, um den `/feedback`-Befehl und [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) zu deaktivieren. Deaktiviert auch `/bug` und `/share`, die durch den gleichen Pfad berichten; vor v2.1.212 waren sie Aliase von `/feedback`, daher war der Befehl unter jedem Namen deaktiviert. Der ältere Name `DISABLE_BUG_COMMAND` wird auch akzeptiert |

435| `DISABLE_GROWTHBOOK` | Setzen Sie auf `1` oder `true`, um GrowthBook-Feature-Flag-Abrufe zu deaktivieren und Code-Standards für jedes Flag zu verwenden. Dies macht [Remote Control](/docs/de/remote-control#requirements) und die anderen [Features, die Feature-Flag-Abrufe benötigen](#features-that-need-feature-flag-fetching) nicht verfügbar. Das Setzen auf `0` oder `false` lässt Abrufe eingeschaltet. Telemetrie-Event-Protokollierung bleibt eingeschaltet, es sei denn, `DISABLE_TELEMETRY` ist auch gesetzt |438| `DISABLE_GROWTHBOOK` | Setzen Sie auf `1` oder `true`, um GrowthBook-Feature-Flag-Abrufe zu deaktivieren und Code-Standards für jedes Flag zu verwenden. Dies macht [Remote Control](/docs/de/remote-control#requirements) und die anderen [Features, die Feature-Flag-Abrufe benötigen](#features-that-need-feature-flag-fetching) nicht verfügbar. Das Setzen auf `0` oder `false` lässt Abrufe eingeschaltet. Telemetrie-Event-Protokollierung bleibt eingeschaltet, es sei denn, `DISABLE_TELEMETRY`ist auch gesetzt |

436| `DISABLE_INSTALLATION_CHECKS` | Setzen Sie auf `1`, um Installationswarnungen zu deaktivieren. Verwenden Sie nur, wenn Sie den Installationsort manuell verwalten, da dies Probleme mit Standard-Installationen maskieren kann |439| `DISABLE_INSTALLATION_CHECKS` | Setzen Sie auf `1`, um Installations-Warnungen zu deaktivieren. Verwenden Sie nur, wenn Sie den Installations-Ort manuell verwalten, da dies Probleme mit Standard-Installationen maskieren kann |

437| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Setzen Sie auf `1`, um den `/install-github-app`-Befehl zu verbergen. Bereits verborgen, wenn Sie Drittanbieter-Provider verwenden (Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry) |440| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Setzen Sie auf `1`, um den `/install-github-app`-Befehl zu verbergen. Bereits verborgen bei Verwendung von Drittanbieter-Providern (Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry) |

438| `DISABLE_INTERLEAVED_THINKING` | Setzen Sie auf `1`, um zu verhindern, dass der Interleaved-Thinking-Beta-Header gesendet wird. Nützlich, wenn Ihr LLM-Gateway oder Provider [Interleaved Thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) nicht unterstützt |441| `DISABLE_INTERLEAVED_THINKING` | Setzen Sie auf `1`, um das Senden des Interleaved-Thinking-Beta-Headers zu verhindern. Nützlich, wenn Ihr LLM-Gateway oder Provider [Interleaved Thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) nicht unterstützt |

439| `DISABLE_LOGIN_COMMAND` | Setzen Sie auf `1`, um den `/login`-Befehl zu verbergen. Nützlich, wenn Authentifizierung extern über API-Schlüssel oder `apiKeyHelper` gehandhabt wird |442| `DISABLE_LOGIN_COMMAND` | Setzen Sie auf `1`, um den `/login`-Befehl zu verbergen. Nützlich, wenn Authentifizierung extern über API-Schlüssel oder `apiKeyHelper` gehandhabt wird |

441| `DISABLE_PROMPT_CACHING` | Setzen Sie auf `1`, um [Prompt-Caching](/docs/de/prompt-caching#disable-prompt-caching) für alle Modelle zu deaktivieren (hat Vorrang vor Pro-Modell-Einstellungen) |444| `DISABLE_PROMPT_CACHING` | Setzen Sie auf `1`, um [Prompt Caching](/docs/de/prompt-caching#disable-prompt-caching) für alle Modelle zu deaktivieren (hat Vorrang vor Pro-Modell-Einstellungen) |

443| `DISABLE_PROMPT_CACHING_HAIKU` | Setzen Sie auf `1`, um Prompt-Caching für Haiku-Modelle zu deaktivieren |446| `DISABLE_PROMPT_CACHING_HAIKU` | Setzen Sie auf `1`, um Prompt Caching für das [Standard-Haiku-Modell](/docs/de/prompt-caching#disable-prompt-caching) zu deaktivieren, überall wo es läuft |

446| `DISABLE_TELEMETRY` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um sich von Telemetrie abzumelden. **Das Setzen auf `0` oder `false` meldet sich immer noch ab**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um Telemetrie wieder einzuschalten. Telemetrie-Events enthalten keine Benutzerdaten wie Code, Dateipfade oder Bash-Befehle. Deaktiviert auch Feature-Flag-Abrufe mit der gleichen Auswirkung wie `DISABLE_GROWTHBOOK`, was [Remote Control](/docs/de/remote-control#requirements) und die anderen [Features, die Feature-Flag-Abrufe benötigen](#features-that-need-feature-flag-fetching) nicht verfügbar macht. Siehe [Telemetrie für Ihre Organisation ausschalten](/docs/de/managed-settings#turn-telemetry-off-for-your-organization) |449| `DISABLE_TELEMETRY` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um sich von Telemetrie abzumelden. **Das Setzen auf `0` oder `false` meldet sich immer noch ab**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um Telemetrie wieder einzuschalten. Telemetrie-Events enthalten keine Benutzerdaten wie Code, Dateipfade oder Bash-Befehle. Deaktiviert auch [Feature-Flag-Abrufe](#features-that-need-feature-flag-fetching). Siehe [Telemetrie für Ihre Organisation ausschalten](/docs/de/managed-settings#turn-telemetry-off-for-your-organization) |

447| `DISABLE_UPDATES` | Setzen Sie auf `1`, um alle Updates zu blockieren, einschließlich manuelles `claude update` und `claude install`. Strenger als `DISABLE_AUTOUPDATER`. Verwenden Sie, wenn Sie Claude Code über Ihre eigenen Kanäle verteilen und Benutzer sich nicht selbst aktualisieren sollten |450| `DISABLE_UPDATES` | Setzen Sie auf `1`, um alle Updates zu blockieren, einschließlich manuelles `claude update` und `claude install`. Strenger als `DISABLE_AUTOUPDATER`. Verwenden Sie, wenn Sie Claude Code über Ihre eigenen Kanäle verteilen und Benutzer sich nicht selbst aktualisieren sollten |

449| `DO_NOT_TRACK` | Setzen Sie auf `1`, um sich von Telemetrie abzumelden, mit der gleichen Auswirkung wie `DISABLE_TELEMETRY`, einschließlich der Nicht-Verfügbarkeit von [Remote Control](/docs/de/remote-control#requirements) und den anderen [Features, die Feature-Flag-Abrufe benötigen](#features-that-need-feature-flag-fetching). Claude Code liest diese Variable als Standard-Boolean, daher lässt `0` Telemetrie eingeschaltet, und ehrt sie als die Cross-Tool-Konvention, die von vielen Developer-CLIs erkannt wird |452| `DO_NOT_TRACK` | Setzen Sie auf `1`, um sich von Telemetrie abzumelden, mit der gleichen Auswirkung wie `DISABLE_TELEMETRY`, einschließlich auf [Feature-Flag-Abrufe](#features-that-need-feature-flag-fetching). Claude Code liest diese Variable als Standard-Boolean, daher lässt `0` Telemetrie eingeschaltet, und ehrt sie als die Cross-Tool-Konvention, die von vielen Developer CLIs erkannt wird |

450| `ENABLE_BETA_TRACING_DETAILED` | Setzen Sie auf `1`, zusammen mit `BETA_TRACING_ENDPOINT`, um [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta) einzuschalten, das Content-tragende Span-Attribute und den `claude_code.hook`-Span hinzufügt. Interaktive CLI-Sitzungen erfordern auch, dass Ihre Organisation für das Beta auf die Allowlist gesetzt ist. Beide Variablen werden in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |453| `ENABLE_BETA_TRACING_DETAILED` | Setzen Sie auf `1`, zusammen mit `BETA_TRACING_ENDPOINT`, um [detailliertes Beta-Tracing](/docs/de/monitoring-usage#traces-beta) einzuschalten, das Content-tragende Span-Attribute und den `claude_code.hook`-Span hinzufügt. Interaktive CLI-Sitzungen erfordern auch, dass Ihre Organisation für das Beta auf die Allowlist gesetzt ist. Beide Variablen werden in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert |

451| `ENABLE_CLAUDEAI_MCP_SERVERS` | Setzen Sie auf `false`, um Claude Code daran zu hindern, [claude.ai MCP-Server](/docs/de/mcp#use-mcp-servers-from-claude-ai) zu fetchen. Standardmäßig für angemeldete Benutzer aktiviert. Um Pro-Projekt oder Pro-Org zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) in Einstellungen |454| `ENABLE_CLAUDEAI_MCP_SERVERS` | Setzen Sie auf `false`, um Claude Code davon abzuhalten, [claude.ai MCP-Server](/docs/de/mcp#use-mcp-servers-from-claude-ai) zu fetchen. Standardmäßig für angemeldete Benutzer aktiviert. Um Pro-Projekt oder Pro-Org zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/docs/de/settings-reference#disableclaudeaiconnectors) in Einstellungen |

452| `ENABLE_PROMPT_CACHING_1H` | Setzen Sie auf `1`, um eine 1-Stunden-[Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) statt der Standard-5-Minuten anzufordern. Gedacht für API-Schlüssel-, [Amazon Bedrock](/docs/de/amazon-bedrock)-, [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)-, [Microsoft Foundry](/docs/de/microsoft-foundry)- und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Benutzer. Abonnement-Benutzer innerhalb der enthaltenen Nutzung erhalten die 1-Stunden-TTL automatisch auf der [Hauptkonversation](/docs/de/prompt-caching#which-ttl-each-request-gets). Abonnement-Benutzer, die auf [Nutzungs-Credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) zeichnen, können es setzen, um die 1-Stunden-TTL zu behalten. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate berechnet. Um die TTL statt pro Request-Bucket zu wählen, verwenden Sie `CLAUDE_CODE_PROMPT_CACHE_TTL` und `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, die Vorrang vor dieser Variable haben |455| `ENABLE_PROMPT_CACHING_1H` | Setzen Sie auf `1`, um eine 1-Stunden-[Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) anstelle der Standard-5-Minuten anzufordern. Gedacht für API-Schlüssel-, [Amazon Bedrock](/docs/de/amazon-bedrock)-, [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)-, [Microsoft Foundry](/docs/de/microsoft-foundry)- und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Benutzer. Abonnement-Benutzer innerhalb der enthaltenen Nutzung erhalten die 1-Stunden-TTL automatisch auf der [Hauptkonversation](/docs/de/prompt-caching#which-ttl-each-request-gets). Abonnement-Benutzer, die auf [Nutzungs-Credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) zeichnen, können es setzen, um die 1-Stunden-TTL zu behalten. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate berechnet. Um die TTL stattdessen Pro-Request-Bucket zu wählen, verwenden Sie `CLAUDE_CODE_PROMPT_CACHE_TTL` und `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, die Vorrang vor dieser Variable haben |

454| `ENABLE_TOOL_SEARCH` | Steuert [MCP-Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt, Claude Code verschiebt alle MCP-Tools standardmäßig. Es lädt sie immer noch upfront auf Google Cloud's Agent Platform-Modellen früher als die Claude 4.5-Generation, auf einer Microsoft Foundry-Bereitstellung, die auf Azure gehostet wird, und wenn `ANTHROPIC_BASE_URL` auf einen Host eines Drittanbieters zeigt. `true` verschiebt immer und sendet den Beta-Header, außer auf diesen gleichen Agent Platform-Modellen und Microsoft Foundry-Bereitstellungen; Anfragen schlagen auf Proxies fehl, die `tool_reference` nicht unterstützen. `auto` lädt upfront, wenn Tool-Definitionen in 10% des Kontexts passen. `auto:N` setzt einen benutzerdefinierten Schwellenwert, wie `auto:5` für 5%. `false` lädt alle Tools upfront. Ein Wert, den Sie selbst setzen, wird ignoriert, wenn `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` gesetzt ist. Vor v2.1.221 deaktivierte Claude Code Tool-Suche für alle Modelle auf Google Cloud's Agent Platform, es sei denn, Sie setzen diese Variable auf `true` |457| `ENABLE_TOOL_SEARCH` | Steuert [MCP-Toolsuche](/docs/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt, Claude Code verschiebt alle MCP-Tools standardmäßig. Es lädt sie immer noch upfront auf Google Cloud's Agent Platform-Modellen früher als die Claude 4.5-Generation, auf einer Microsoft Foundry-Deployment auf Azure gehostet, und wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host zeigt. `true` verschiebt immer und sendet den Beta-Header, außer auf diesen gleichen Agent Platform-Modellen und Microsoft Foundry-Deployments; Anfragen schlagen auf Proxies fehl, die `tool_reference` nicht unterstützen. `auto` lädt upfront, wenn Tool-Definitionen in 10% des Kontexts passen. `auto:N` setzt einen benutzerdefinierten Schwellenwert, wie `auto:5` für 5%. `false` lädt alle Tools upfront. Ein Wert, den Sie selbst setzen, wird ignoriert, wenn `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` gesetzt ist. Vor v2.1.221 deaktivierte Claude Code die Toolsuche für alle Modelle auf Google Cloud's Agent Platform, es sei denn, Sie setzen diese Variable auf `true` |

455| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um Claude Code zu veranlassen, bei wiederholten Überladungs-Fehlern für jedes Modell zu stoppen, wenn kein Fallback-Modell konfiguriert ist. **Das Setzen auf `0` oder `false` aktiviert dies immer noch**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um das Standard-Wiederholungs-Verhalten wiederherzustellen. Ohne es stoppt Claude Code das Wiederholen auf diese Weise auf Modellen, die es als Opus-, Fable- oder Mythos-Modelle erkennt, wenn Sie sich mit einem API-Schlüssel oder einem [Drittanbieter-Provider](/docs/de/third-party-integrations) statt einem Claude-Abonnement authentifizieren. Auf Claude Code v2.1.160 oder später wechselt Claude Code zu Ihrer konfigurierten [Fallback-Modell-Kette](/docs/de/model-config#fallback-model-chains) bei wiederholten Überladungs-Fehlern für jedes primäre Modell, daher betrifft diese Variable nicht den Wechsel zu einem Fallback-Modell |458| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um Claude Code zu veranlassen, bei wiederholten Overload-Fehlern für jedes Modell zu stoppen, wenn kein Fallback-Modell konfiguriert ist. **Das Setzen auf `0` oder `false` aktiviert dies immer noch**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um das Standard-Retry-Verhalten wiederherzustellen. Ohne dies stoppt Claude Code das Retry auf diese Weise auf Modellen, die es als Opus-, Fable- oder Mythos-Modelle erkennt, wenn Sie sich mit einem API-Schlüssel oder einem [Drittanbieter-Provider](/docs/de/third-party-integrations) authentifizieren, anstelle eines Claude-Abonnements. Auf Claude Code v2.1.160 oder später wechselt Claude Code zu Ihrer konfigurierten [Fallback-Modell-Kette](/docs/de/model-config#fallback-model-chains) bei wiederholten Overload-Fehlern für jedes primäre Modell, daher betrifft diese Variable nicht den Wechsel zu einem Fallback-Modell |

456| `FORCE_AUTOUPDATE_PLUGINS` | Setzen Sie auf `1`, um Plugin-Auto-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |459| `FORCE_AUTOUPDATE_PLUGINS` | Setzen Sie auf `1`, um Plugin-Auto-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |

457| `FORCE_HYPERLINK` | Setzen Sie auf `1`, um klickbare OSC 8-Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, aber nicht auto-erkannt wird, oder `0`, um sie zu deaktivieren. Wenn nicht gesetzt, aktiviert Claude Code Hyperlinks nur, wenn es Terminal-Unterstützung erkennt. Claude Code analysiert diesen Wert als Zahl, nicht als Boolean, daher aktiviert ein Wert wie `false`, `no` oder `off` Hyperlinks, anstatt sie zu deaktivieren. Der Footer [PR- oder Merge-Request-Badge](/docs/de/interactive-mode#pr-review-status) wird als Hyperlink gerendert, auch wenn Claude Code Terminal-Unterstützung nicht erkennen kann, wie über SSH. Setzen Sie `0`, um den Badge als einfachen Text zu rendern |460| `FORCE_HYPERLINK` | Setzen Sie auf `1`, um klickbare OSC 8-Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, aber nicht auto-erkannt wird, oder `0`, um sie zu deaktivieren. Wenn nicht gesetzt, aktiviert Claude Code Hyperlinks nur, wenn es Terminal-Unterstützung erkennt. Claude Code parst diesen Wert als Zahl, nicht als Boolean, daher aktiviert ein Wert wie `false`, `no` oder `off` Hyperlinks, anstatt sie zu deaktivieren. Der Footer [PR- oder Merge-Request-Badge](/docs/de/interactive-mode#pr-review-status) wird als Hyperlink gerendert, auch wenn Claude Code Terminal-Unterstützung nicht erkennen kann, wie über SSH. Setzen Sie `0`, um den Badge als einfachen Text zu rendern |

458| `FORCE_PROMPT_CACHING_5M` | Setzen Sie auf `1`, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn 1-Stunden-TTL andernfalls gelten würde. Überschreibt `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` und die `promptCacheTtl`- und `subagentPromptCacheTtl`-Einstellungen |461| `FORCE_PROMPT_CACHING_5M` | Setzen Sie auf `1`, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn 1-Stunden-TTL andernfalls gelten würde. Überschreibt `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` und die `promptCacheTtl`- und `subagentPromptCacheTtl`-Einstellungen |

461| `IS_DEMO` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um Demo-Modus zu aktivieren: verbirgt Ihre E-Mail und Organisations-Namen aus dem Header und `/status`-Ausgabe, und überspringt Onboarding. **Das Setzen auf `0` oder `false` aktiviert immer noch Demo-Modus**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um ihn auszuschalten. Nützlich beim Streamen oder Aufzeichnen einer Sitzung |464| `IS_DEMO` | Setzen Sie auf einen beliebigen nicht-leeren Wert, wie `1`, um Demo-Modus zu aktivieren: verbirgt Ihre E-Mail und Organisations-Namen aus dem Header und `/status`-Ausgabe, und überspringt Onboarding. **Das Setzen auf `0` oder `false` aktiviert immer noch Demo-Modus**, im Gegensatz zu den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um es auszuschalten. Nützlich beim Streamen oder Aufzeichnen einer Sitzung |

462| `MAX_MCP_OUTPUT_TOKENS` | Maximale Anzahl von Tokens, die in MCP-Tool-Antworten erlaubt sind. Claude Code zeigt eine Warnung an, wenn die Ausgabe 10.000 Tokens überschreitet. Tools, die [`anthropic/maxResultSizeChars`](/docs/de/mcp#raise-the-limit-for-a-specific-tool) deklarieren, verwenden stattdessen dieses Zeichen-Limit für Text-Inhalt, aber Bild-Inhalt von diesen Tools unterliegt immer noch dieser Variable (Standard: 25000) |465| `MAX_MCP_OUTPUT_TOKENS` | Maximale Anzahl von Tokens, die in MCP-Tool-Antworten erlaubt sind. Claude Code zeigt eine Warnung an, wenn die Ausgabe 10.000 Tokens überschreitet. Tools, die [`anthropic/maxResultSizeChars`](/docs/de/mcp#raise-the-limit-for-a-specific-tool) deklarieren, verwenden stattdessen dieses Zeichen-Limit für Text-Inhalt, aber Bild-Inhalt von diesen Tools unterliegt immer noch dieser Variable (Standard: 25000) |

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Anzahl der Versuche, die Claude Code erlaubt, wenn die Antwort des Modells die Validierung gegen das [`--json-schema`](/docs/de/cli-reference#cli-flags) im nicht-interaktiven Modus mit dem `-p`-Flag fehlschlägt; nach so vielen fehlgeschlagenen Versuchen ohne gültige Ausgabe schlägt der Lauf fehl. Die gleiche Obergrenze gilt, wenn die strukturierte Ausgabe eines [Workflow](/docs/de/workflows)-Subagents die Validierung fehlschlägt. Standard 5, ein erster Versuch plus vier Wiederholungen |466| `MAX_STRUCTURED_OUTPUT_RETRIES` | Anzahl der Versuche, die Claude Code erlaubt, wenn die Antwort des Modells die Validierung gegen das [`--json-schema`](/docs/de/cli-reference#cli-flags) im nicht-interaktiven Modus mit dem `-p`-Flag fehlschlägt; nach so vielen fehlgeschlagenen Versuchen ohne gültige Ausgabe schlägt der Lauf fehl. Die gleiche Obergrenze gilt, wenn die strukturierte Ausgabe eines [Workflow](/docs/de/workflows)-Subagents die Validierung fehlschlägt. Standardmäßig 5, ein erster Versuch plus vier Wiederholungen |

464| `MAX_THINKING_TOKENS` | Festes Token-Budget für [Extended Thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code begrenzt es auf ein Token unter den Max-Output-Tokens der Anfrage und nie unter 1.024. Siehe `CLAUDE_CODE_MAX_OUTPUT_TOKENS` für wie dieses Limit gesetzt wird. Wenn nicht gesetzt und Denken aktiviert ist, wählen Modelle mit [adaptivem Denken](/docs/de/model-config#adjust-effort-level) ihre eigene Denk-Tiefe, und andere Modelle verwenden die Obergrenze. Setzen Sie auf `0`, um Denken auf der Anthropic API zu deaktivieren, außer auf Opus 5.5 und den Fable-Modellen, die Denken nicht ausschalten können. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt `0` den `thinking`-Parameter aus statt. Mit Denken auf der Anthropic API ausgeschaltet sendet Claude Code Effort `high` statt einer höheren Ebene an Modelle, die es weiß, [akzeptieren diese Kombination nicht](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5. Claude Code ignoriert nicht-Null-Werte auf adaptiven Denk-Modellen, außer auf den Modellen, wo `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` adaptives Denken ausschaltet |467| `MAX_THINKING_TOKENS` | Festes Token-Budget für [Extended Thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code begrenzt es auf ein Token unter den Max-Output-Tokens der Anfrage und nie unter 1.024. Siehe `CLAUDE_CODE_MAX_OUTPUT_TOKENS` für wie dieses Limit gesetzt wird. Wenn nicht gesetzt und Thinking aktiviert ist, wählen Modelle mit [Adaptive Reasoning](/docs/de/model-config#adjust-effort-level) ihre eigene Thinking-Tiefe, und andere Modelle verwenden die Obergrenze. Setzen Sie auf `0`, um Thinking auf der Anthropic API zu deaktivieren, außer auf Opus 5.5, Sonnet 5.5 und den Fable-Modellen, die Thinking nicht ausschalten können. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt `0` den `thinking`-Parameter aus statt. Mit Thinking auf der Anthropic API ausgeschaltet sendet Claude Code Effort `high` statt einer höheren Ebene zu Modellen, die es weiß, [akzeptieren diese Kombination nicht](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5. Claude Code ignoriert nicht-Null-Werte auf Adaptive-Reasoning-Modellen, außer auf den Modellen, wo `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` Adaptive Reasoning ausschaltet |

465| `MCP_CLIENT_SECRET` | OAuth-Client-Secret für MCP-Server, die [vorkonfigurierte Anmeldedaten](/docs/de/mcp#use-pre-configured-oauth-credentials) erfordern. Vermeidet den interaktiven Prompt beim Hinzufügen eines Servers mit `--client-secret` |468| `MCP_CLIENT_SECRET` | OAuth-Client-Secret für MCP-Server, die [vorkonfigurierte Credentials](/docs/de/mcp#use-pre-configured-oauth-credentials) erfordern. Vermeidet den interaktiven Prompt beim Hinzufügen eines Servers mit `--client-secret` |

466| `MCP_CONNECTION_NONBLOCKING` | Steuert, ob Startup auf MCP-Server wartet, um sich zu verbinden, bevor die erste Query. MCP-Startup ist standardmäßig nicht-blockierend: Server verbinden sich im Hintergrund und ihre Tools werden verfügbar, wenn sie fertig sind. Setzen Sie auf `0`, um Claude Code auf Server-Verbindung vor der ersten Query zu warten. Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) konfiguriert sind, machen Startup immer noch warten, außer wenn sie vom [Discovery-Cache](/docs/de/mcp#server-status-detail) bedient werden, da ihre Tools vorhanden sein müssen, wenn der erste Prompt gebaut wird. Im nicht-interaktiven Modus (`-p`) ohne `--input-format stream-json` wartet Claude Code auch auf noch ausstehende Server vor dem ersten Turn, unabhängig von dieser Variable. Wenn Sie [`--mcp-config`](/docs/de/cli-reference#cli-flags) explizit übergeben, hat das Warten eine längere Frist; siehe diesen Flag-Eintrag für die Cached-Server-Ausnahme |469| `MCP_CONNECTION_NONBLOCKING` | Steuert, ob Startup auf MCP-Server wartet, um sich zu verbinden, bevor die erste Query. MCP-Startup ist standardmäßig nicht-blockierend: Server verbinden sich im Hintergrund und ihre Tools werden verfügbar, wenn sie fertig sind. Setzen Sie auf `0`, um Claude Code auf Server-Verbindung vor der ersten Query zu warten. Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) konfiguriert sind, machen Startup immer noch warten, außer wenn sie vom [Discovery-Cache](/docs/de/mcp#server-status-detail) serviert werden, da ihre Tools vorhanden sein müssen, wenn der erste Prompt gebaut wird. Im nicht-interaktiven Modus (`-p`) ohne `--input-format stream-json` wartet Claude Code auch auf noch ausstehende Server vor dem ersten Turn, unabhängig von dieser Variable. Wenn Sie [`--mcp-config`](/docs/de/cli-reference#cli-flags) explizit übergeben, hat das Warten eine längere Deadline; siehe diesen Flag's Eintrag für die Cached-Server-Ausnahme |

467| `MCP_CONNECT_TIMEOUT_MS` | Wie lange blockierendes MCP-Startup wartet, in Millisekunden, auf den Verbindungs-Batch, bevor die Tool-Liste snapshot wird (Standard: 5000). Gilt, wenn `MCP_CONNECTION_NONBLOCKING=0` oder für Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) markiert sind. Server, die immer noch ausstehend sind, wenn die Frist abläuft, verbinden sich weiter im Hintergrund. Unterschiedlich von `MCP_TIMEOUT`, das einen einzelnen Server's Verbindungs-Versuch begrenzt |470| `MCP_CONNECT_TIMEOUT_MS` | Wie lange blockierendes MCP-Startup wartet, in Millisekunden, auf den Verbindungs-Batch, bevor die Tool-Liste snapshot wird (Standard: 5000). Gilt, wenn `MCP_CONNECTION_NONBLOCKING=0` oder für Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) markiert sind. Server, die immer noch ausstehend sind, wenn die Deadline erreicht wird, verbinden sich weiter im Hintergrund. Unterschiedlich von `MCP_TIMEOUT`, das einen einzelnen Server's Verbindungs-Versuch begrenzt |

468| `MCP_DISCOVERY_CACHE` | Schaltet den [MCP-Discovery-Cache](/docs/de/mcp#server-status-detail) ein oder aus. Mit dem Cache ein kann ein Remote-HTTP- oder SSE-Server, den Sie zuvor verwendet haben, den [`cached`-Status](/docs/de/mcp#server-status-detail) zeigen, und Claude Code verbindet ihn beim ersten Tool-Aufruf statt beim Startup. Der Cache ist standardmäßig aus, es sei denn, ein gradueller Rollout hat ihn für Ihr Konto aktiviert. Setzen Sie auf `1`, um ihn einzuschalten, oder `0`, um ihn ausgeschaltet zu halten, auch wenn der Rollout ihn aktiviert hat. Vor v2.1.238 war der Cache standardmäßig ein. Der `cached`-Status erfordert Claude Code v2.1.221 oder später |471| `MCP_DISCOVERY_CACHE` | Schaltet den [MCP-Discovery-Cache](/docs/de/mcp#server-status-detail) ein oder aus. Mit dem Cache ein kann ein Remote-HTTP- oder SSE-Server, den Sie zuvor verwendet haben, den [`cached`-Status](/docs/de/mcp#server-status-detail) zeigen, und Claude Code verbindet ihn bei seinem ersten Tool-Aufruf, anstatt beim Startup. Der Cache ist standardmäßig aus, es sei denn, ein gradueller Rollout hat ihn für Ihr Konto aktiviert. Setzen Sie auf `1`, um ihn einzuschalten, oder `0`, um ihn ausgeschaltet zu halten, auch wenn der Rollout ihn aktiviert hat. Vor v2.1.238 war der Cache standardmäßig ein. Der `cached`-Status erfordert Claude Code v2.1.221 oder später |

469| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Maximales Alter, in Sekunden, eines [Discovery-Cache](/docs/de/mcp#server-status-detail)-Eintrags (Standard: 14400 oder 4 Stunden). Bei einem Start, wo der Eintrag älter als das ist, verwirft Claude Code ihn und verbindet den Server beim Startup, wie es mit dem Cache aus tut. Claude Code begrenzt den Wert auf 7 Tage. Vor v2.1.238 war der Standard 86400 oder 24 Stunden, und Claude Code begrenzte den Wert nicht |472| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Maximales Alter in Sekunden eines [Discovery-Cache](/docs/de/mcp#server-status-detail)-Eintrags (Standard: 14400 oder 4 Stunden). Bei einem Start, wo der Eintrag älter als das ist, verwirft Claude Code ihn und verbindet den Server beim Startup, wie es mit dem Cache aus tut. Claude Code begrenzt den Wert auf 7 Tage. Vor v2.1.238 war der Standard 86400 oder 24 Stunden, und Claude Code begrenzte den Wert nicht |

470| `MCP_DISCOVERY_CACHE_STRIKES` | Bei einem Start, wo ein [Discovery-Cache](/docs/de/mcp#server-status-detail)-Eintrag älter als `MCP_DISCOVERY_CACHE_TTL_S` ist, aktualisiert Claude Code ihn im Hintergrund. Diese Variable setzt, wie viele Aktualisierungen hintereinander fehlschlagen können, bevor Claude Code den Eintrag verwirft und den Server beim nächsten Start statt verbindet (Standard: 1). Erhöhen Sie es, wenn Ihre Netzwerk-Verbindung gelegentlich ausfällt, daher verwirft eine fehlgeschlagene Aktualisierung nicht den Eintrag. Erfordert Claude Code v2.1.238 oder später |473| `MCP_DISCOVERY_CACHE_STRIKES` | Bei einem Start, wo ein [Discovery-Cache](/docs/de/mcp#server-status-detail)-Eintrag älter als `MCP_DISCOVERY_CACHE_TTL_S` ist, aktualisiert Claude Code ihn im Hintergrund. Diese Variable setzt, wie viele Aktualisierungen hintereinander fehlschlagen können, bevor Claude Code den Eintrag verwirft und den Server beim nächsten Start stattdessen verbindet (Standard: 1). Erhöhen Sie es, wenn Ihre Netzwerk-Verbindung gelegentlich ausfällt, daher verwirft eine fehlgeschlagene Aktualisierung nicht den Eintrag. Erfordert Claude Code v2.1.238 oder später |

471| `MCP_DISCOVERY_CACHE_TTL_S` | Sekunden, für die Claude Code einen [Discovery-Cache](/docs/de/mcp#server-status-detail)-Eintrag verwendet, ohne ihn zu aktualisieren (Standard: 900). Bei einem Start, wo der Eintrag älter als das ist, verwendet Claude Code ihn immer noch, aber aktualisiert ihn im Hintergrund. Sobald der Eintrag älter als `MCP_DISCOVERY_CACHE_MAX_STALE_S` ist, verwirft Claude Code ihn statt. Claude Code begrenzt den Wert auf `MCP_DISCOVERY_CACHE_MAX_STALE_S`, was 4 Stunden standardmäßig ist. Vor v2.1.238 begrenzte Claude Code den Wert nicht |474| `MCP_DISCOVERY_CACHE_TTL_S` | Sekunden, für die Claude Code einen [Discovery-Cache](/docs/de/mcp#server-status-detail)-Eintrag verwendet, ohne ihn zu aktualisieren (Standard: 900). Bei einem Start, wo der Eintrag älter als das ist, verwendet Claude Code ihn immer noch, aktualisiert ihn aber im Hintergrund. Sobald der Eintrag älter als `MCP_DISCOVERY_CACHE_MAX_STALE_S` ist, verwirft Claude Code ihn stattdessen. Claude Code begrenzt den Wert auf `MCP_DISCOVERY_CACHE_MAX_STALE_S`, was 4 Stunden standardmäßig ist. Vor v2.1.238 begrenzte Claude Code den Wert nicht |

472| `MCP_OAUTH_CALLBACK_PORT` | Fester Port für den OAuth-Redirect-Callback, als Alternative zu `--callback-port`, wenn ein MCP-Server mit [vorkonfigurierten Anmeldedaten](/docs/de/mcp#use-pre-configured-oauth-credentials) hinzugefügt wird |475| `MCP_OAUTH_CALLBACK_PORT` | Fester Port für den OAuth-Redirect-Callback, als Alternative zu `--callback-port`, wenn ein MCP-Server mit [vorkonfigurierten Credentials](/docs/de/mcp#use-pre-configured-oauth-credentials) hinzugefügt wird |

473| `MCP_PROTOCOL_NEGOTIATION` | Nur auf der [v2 MCP-Client-Runtime](/docs/de/mcp#mcp-client-runtimes), ob Claude Code Server für MCP-Protokoll-Revision 2026-07-28 prüft. Setzen Sie `auto`, um HTTP-, claude.ai-Connector- und Stdio-Server zu prüfen; ein Server, der nicht auf die Prüfung antwortet, verbindet sich auf dem früheren Protokoll statt, wie SSE- und WebSocket-Server immer tun. Setzen Sie `legacy`, um die Prüfung für jeden Server zu überspringen. Ohne die Variable prüft Claude Code HTTP-Server, und prüft auch claude.ai-Connector-Server in Sitzungen, wo es [Feature-Flags fetcht](#features-that-need-feature-flag-fetching). Jeder andere Wert wird mit einer Warnung im Debug-Log ignoriert. Erfordert Claude Code v2.1.221 oder später |476| `MCP_PROTOCOL_NEGOTIATION` | Nur auf der [v2 MCP-Client-Runtime](/docs/de/mcp#mcp-client-runtimes), ob Claude Code Server für MCP-Protokoll-Revision 2026-07-28 prüft. Setzen Sie `auto`, um HTTP-, claude.ai-Connector- und Stdio-Server zu prüfen; ein Server, der nicht auf die Prüfung antwortet, verbindet sich auf dem früheren Protokoll statt, wie SSE- und WebSocket-Server immer tun. Setzen Sie `legacy`, um die Prüfung für jeden Server zu überspringen. Ohne die Variable prüft Claude Code HTTP-Server, und prüft auch claude.ai-Connector-Server in Sitzungen, wo es [Feature-Flags fetcht](#features-that-need-feature-flag-fetching). Jeder andere Wert wird mit einer Warnung im Debug-Log ignoriert. Erfordert Claude Code v2.1.221 oder später |

474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), um parallel beim Startup zu verbinden (Standard: 20) |477| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), um parallel beim Startup zu verbinden (Standard: 20) |

475| `MCP_SDK_GENERATION` | Heften Sie, welche [MCP-Client-Runtime](/docs/de/mcp#mcp-client-runtimes) dieser Prozess mit MCP-Servern verbindet: `v1`, gebaut auf MCP TypeScript SDK 1.x, oder `v2`, gebaut auf [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Ohne die Variable verwendet Claude Code v2, ab den Versionen, die in diesem Abschnitt aufgelistet sind. Auf Claude Code v2.1.221 oder später prüft die v2-Runtime den Aussteller, den ein MCP-OAuth-Server in seiner Autorisierungs-Antwort zurückgibt, und schlägt die Anmeldung mit einem Fehler fehl, der mit `Issuer mismatch in authorization response` beginnt, wenn er nicht passt. Die v1-Runtime führt diese Prüfung nicht aus. Wenn Sie einen nicht erkannten Wert setzen, ignoriert Claude Code ihn und schreibt eine Warnung in das Debug-Log. Claude Code liest den Wert einmal pro Prozess. Erfordert Claude Code v2.1.218 oder später |478| `MCP_SDK_GENERATION` | Heften Sie an, welche [MCP-Client-Runtime](/docs/de/mcp#mcp-client-runtimes) dieser Prozess mit MCP-Servern verbindet: `v1`, gebaut auf MCP TypeScript SDK 1.x, oder `v2`, gebaut auf [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Ohne die Variable verwendet Claude Code v2, ab den Versionen, die in diesem Abschnitt aufgelistet sind. Auf Claude Code v2.1.221 oder später prüft die v2-Runtime den Issuer, den ein MCP-OAuth-Server in seiner Autorisierungs-Antwort zurückgibt, und schlägt die Anmeldung mit einem Fehler fehl, der mit `Issuer mismatch in authorization response` beginnt, wenn er nicht übereinstimmt. Die v1-Runtime führt diese Prüfung nicht aus. Wenn Sie einen nicht erkannten Wert setzen, ignoriert Claude Code ihn und schreibt eine Warnung zum Debug-Log. Claude Code liest den Wert einmal pro Prozess. Erfordert Claude Code v2.1.218 oder später |

476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von lokalen MCP-Servern (Stdio), um parallel beim Startup zu verbinden (Standard: 3) |479| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von lokalen MCP-Servern (Stdio), um parallel beim Startup zu verbinden (Standard: 3) |

478| `MCP_TOOL_TIMEOUT` | Timeout in Millisekunden für MCP-Tool-Ausführung (Standard: 100000000, etwa 28 Stunden). Für einen HTTP-, SSE- oder claude.ai-Connector-Server timeout jede Anfrage auch nach 60 Sekunden standardmäßig; setzen Sie diese Variable oder den Pro-Server-`timeout` über 60000, um dieses Pro-Request-Limit zu erhöhen. Ein niedrigerer Wert verkürzt immer noch das gesamte Tool-Ausführungs-Timeout, lässt aber das Pro-Request-Limit bei 60 Sekunden. Stdio- und WebSocket-Server haben keinen Pro-Request-Timer. Ein Pro-Server-`timeout`-Feld in `.mcp.json` überschreibt dies für diesen Server. Ein Pro-Server-`timeout` von mindestens 1000 setzt auch das minimale Idle-Fenster für die Tool-Aufrufe dieses Servers, daher bricht `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` sie nie früher ab; diese Untergrenze erfordert Claude Code v2.1.203 oder später. Für die Env-Variable werden Werte unter 1000 auf eine Sekunde begrenzt; für das Pro-Server-Feld werden Werte unter 1000 ignoriert |481| `MCP_TOOL_TIMEOUT` | Timeout in Millisekunden für MCP-Tool-Ausführung (Standard: 100000000, etwa 28 Stunden). Für einen HTTP-, SSE- oder claude.ai-Connector-Server hat jede Anfrage auch ein Timeout von 60 Sekunden standardmäßig; setzen Sie diese Variable oder den Pro-Server-`timeout` über 60000, um dieses Pro-Request-Limit zu erhöhen. Ein niedrigerer Wert verkürzt immer noch das Gesamt-Tool-Ausführungs-Timeout, lässt aber das Pro-Request-Limit bei 60 Sekunden. Stdio- und WebSocket-Server haben keinen Pro-Request-Timer. Ein Pro-Server-`timeout`-Feld in `.mcp.json` überschreibt dies für diesen Server. Ein Pro-Server-`timeout` von mindestens 1000 setzt auch das Minimum-Idle-Fenster für die Tool-Aufrufe dieses Servers, daher bricht `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` sie nie früher ab; diese Untergrenze erfordert Claude Code v2.1.203 oder später. Für die Env-Variable werden Werte unter 1000 auf eine Sekunde begrenzt; für das Pro-Server-Feld werden Werte unter 1000 ignoriert |

480| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Standard-OpenTelemetry-SDK-Limit auf Attribut-Wert-Länge. Claude Code begrenzt Content-tragende Telemetrie-Attribute auf das kleinere von diesem und `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, daher bleibt der Kürzungs-Marker innerhalb des SDK-Limits. Claude Code liest die `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT`- und `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`-Varianten auf die gleiche Weise, und der kleinste gesetzte Wert gilt für alle Signale. Erfordert Claude Code v2.1.214 oder später. Siehe [Monitoring](/docs/de/monitoring-usage#common-configuration-variables) |483| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Standard-OpenTelemetry-SDK-Limit auf Attribut-Wert-Länge. Claude Code begrenzt Content-tragende Telemetrie-Attribute auf das kleinere von diesem und `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, daher bleibt der Kürzungs-Marker innerhalb des SDK-Limits. Claude Code liest die `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT`- und `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`-Varianten auf die gleiche Weise, und der kleinste gesetzte Wert gilt für alle Signale. Erfordert Claude Code v2.1.214 oder später. Siehe [Monitoring](/docs/de/monitoring-usage#common-configuration-variables) |

481| `OTEL_LOG_ASSISTANT_RESPONSES` | Setzen Sie auf `1`, um den Text der Modell-Antwort auf `assistant_response`-OpenTelemetry-Log-Events einzuschließen. Wenn nicht gesetzt, verwendet Claude Code den Wert von `OTEL_LOG_USER_PROMPTS` statt. Setzen Sie auf `0`, um Antworten redaktiert zu halten, auch wenn `OTEL_LOG_USER_PROMPTS` gesetzt ist. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Erfordert Claude Code v2.1.193 oder später. Siehe [Monitoring](/docs/de/monitoring-usage#assistant-response-event) |484| `OTEL_LOG_ASSISTANT_RESPONSES` | Setzen Sie auf `1`, um den Text der Modell-Antwort auf `assistant_response`-OpenTelemetry-Log-Events einzubeziehen. Wenn nicht gesetzt, verwendet Claude Code den Wert von `OTEL_LOG_USER_PROMPTS` statt. Setzen Sie auf `0`, um Antworten redaktiert zu halten, auch wenn `OTEL_LOG_USER_PROMPTS` gesetzt ist. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Erfordert Claude Code v2.1.193 oder später. Siehe [Monitoring](/docs/de/monitoring-usage#assistant-response-event) |

482| `OTEL_LOG_MANAGED_SETTINGS` | Setzen Sie auf `1`, um die redaktierten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor Redaktion zu `managed_settings_resolved`-OpenTelemetry-Log-Events hinzuzufügen. Standardmäßig deaktiviert. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen; ein Wert in Projekt- oder lokalen Einstellungen schaltet es nicht ein. Erfordert Claude Code v2.1.274 oder später. Siehe [Monitoring](/docs/de/monitoring-usage#managed-settings-resolved-event) |485| `OTEL_LOG_MANAGED_SETTINGS` | Setzen Sie auf `1`, um die redaktierten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor Redaktion zu `managed_settings_resolved`-OpenTelemetry-Log-Events hinzuzufügen. Standardmäßig deaktiviert. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen; ein Wert in Projekt- oder lokalen Einstellungen schaltet es nicht ein. Erfordert Claude Code v2.1.274 oder später. Siehe [Monitoring](/docs/de/monitoring-usage#managed-settings-resolved-event) |

483| `OTEL_LOG_RAW_API_BODIES` | Emittieren Sie Anthropic Messages API Request- und Response-JSON als `api_request_body` / `api_response_body`-Log-Events. Setzen Sie auf `1` für Inline-Bodies, die auf dem Content-Limit gekürzt sind, oder `file:<dir>`, um nicht gekürzte Bodies auf die Festplatte zu schreiben und statt einen `body_ref`-Pfad zu emittieren. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` konfiguriert das Content-Limit, 60 KB standardmäßig. Standardmäßig deaktiviert; Bodies enthalten die gesamte Konversations-Historie. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Siehe [Monitoring](/docs/de/monitoring-usage#api-request-body-event) |486| `OTEL_LOG_RAW_API_BODIES` | Emittieren Sie Anthropic Messages API Request- und Response-JSON als `api_request_body` / `api_response_body`-Log-Events. Setzen Sie auf `1` für Inline-Bodies, die beim Content-Limit gekürzt werden, oder `file:<dir>`, um unkürzte Bodies auf die Festplatte zu schreiben und einen `body_ref`-Pfad statt zu emittieren. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` konfiguriert das Content-Limit, 60 KB standardmäßig. Standardmäßig deaktiviert; Bodies enthalten die gesamte Konversations-Historie. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Siehe [Monitoring](/docs/de/monitoring-usage#api-request-body-event) |

484| `OTEL_LOG_TOOL_CONTENT` | Setzen Sie auf `1`, um Tool-Inhalt in das `tool.output`-OpenTelemetry-Span-Event einzuschließen. Span-Attribute tragen Tool-Inhalt unter [ihren eigenen Gates](/docs/de/monitoring-usage#new-context-gates). Erfordert [Tracing](/docs/de/monitoring-usage#traces-beta). Standardmäßig deaktiviert zum Schutz sensibler Daten. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert, außer den Off-Werten, die dieser Abschnitt beschreibt. Siehe [Monitoring](/docs/de/monitoring-usage#tool-output-span-event) |487| `OTEL_LOG_TOOL_CONTENT` | Setzen Sie auf `1`, um Tool-Inhalt in das `tool.output`-OpenTelemetry-Span-Event einzubeziehen. Span-Attribute tragen Tool-Inhalt unter [ihren eigenen Gates](/docs/de/monitoring-usage#new-context-gates). Erfordert [Tracing](/docs/de/monitoring-usage#traces-beta). Standardmäßig deaktiviert zum Schutz sensibler Daten. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert, außer den Off-Werten, die dieser Abschnitt beschreibt. Siehe [Monitoring](/docs/de/monitoring-usage#tool-output-span-event) |

485| `OTEL_LOG_TOOL_DETAILS` | Setzen Sie auf `1`, um Tool-Input-Argumente, MCP-Server-Namen, Benutzer-erstellte Workflow-Namen, rohe Error-Strings bei Tool-Fehlern, die Refusal-`category` auf `api_refusal`-Events und andere Tool-Details in OpenTelemetry-Traces und Logs einzuschließen. Standardmäßig deaktiviert zum Schutz von PII. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert, außer den Off-Werten, die dieser Abschnitt beschreibt. Siehe [Monitoring](/docs/de/monitoring-usage) |488| `OTEL_LOG_TOOL_DETAILS` | Setzen Sie auf `1`, um Tool-Input-Argumente, MCP-Server-Namen, Benutzer-erstellte Workflow-Namen, rohe Error-Strings bei Tool-Fehlern, die Refusal-`category` auf `api_refusal`-Events, reale Agent-, Skill-, Plugin- und MCP-Server-Namen auf [Cost- und Token-Metriken](/docs/de/monitoring-usage#cost-counter) und andere Tool-Details in OpenTelemetry-Traces und Logs einzubeziehen. Standardmäßig deaktiviert zum Schutz von PII. Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert, außer den Off-Werten, die dieser Abschnitt beschreibt. Siehe [Monitoring](/docs/de/monitoring-usage) |

486| `OTEL_LOG_USER_PROMPTS` | Setzen Sie auf `1`, um Benutzer-Prompt-Text in OpenTelemetry-Traces und Logs einzuschließen. Standardmäßig deaktiviert (Prompts sind redaktiert). Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert, außer den Off-Werten, die dieser Abschnitt beschreibt. Siehe [Monitoring](/docs/de/monitoring-usage) |489| `OTEL_LOG_USER_PROMPTS` | Setzen Sie auf `1`, um Benutzer-Prompt-Text in OpenTelemetry-Traces und Logs einzubeziehen. Standardmäßig deaktiviert (Prompts sind redaktiert). Setzen Sie es in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert, außer den Off-Werten, die dieser Abschnitt beschreibt. Siehe [Monitoring](/docs/de/monitoring-usage) |

487| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Setzen Sie auf `false`, um Account-UUID aus Metriken-Attributen auszuschließen (Standard: enthalten). Siehe [Monitoring](/docs/de/monitoring-usage) |490| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Setzen Sie auf `false`, um Account-UUID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Monitoring](/docs/de/monitoring-usage) |

488| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Setzen Sie auf `true`, um den Sitzungs-Entrypoint in Metriken-Attributen einzuschließen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe [Monitoring](/docs/de/monitoring-usage) |491| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Setzen Sie auf `true`, um den Sitzungs-Entrypoint in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe [Monitoring](/docs/de/monitoring-usage) |

489| `OTEL_METRICS_INCLUDE_REPOSITORY` | Setzen Sie auf `true`, um OpenTelemetry-Metriken und Events mit `vcs.*`-Attributen zu taggen, die das Repository der Sitzung identifizieren (Standard: ausgeschlossen). Erfordert Claude Code v2.1.269 oder später. Siehe [Repository-Attribute](/docs/de/monitoring-usage#repository-attributes) |492| `OTEL_METRICS_INCLUDE_REPOSITORY` | Setzen Sie auf `true`, um OpenTelemetry-Metriken und Events mit `vcs.*`-Attributen zu taggen, die das Repository der Sitzung identifizieren (Standard: ausgeschlossen). Erfordert Claude Code v2.1.269 oder später. Siehe [Repository-Attribute](/docs/de/monitoring-usage#repository-attributes) |

490| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Ab v2.1.161 hängt Claude Code `OTEL_RESOURCE_ATTRIBUTES`-Schlüssel an Metriken-Datenpunkt-Labels an. Setzen Sie auf `false`, um sie auszuschließen (Standard: enthalten). Siehe [Monitoring](/docs/de/monitoring-usage#multi-team-organization-support) |493| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Ab v2.1.161 hängt Claude Code `OTEL_RESOURCE_ATTRIBUTES`-Schlüssel an Metrik-Datenpunkt-Labels an. Setzen Sie auf `false`, um sie auszuschließen (Standard: enthalten). Siehe [Monitoring](/docs/de/monitoring-usage#multi-team-organization-support) |

491| `OTEL_METRICS_INCLUDE_SESSION_ID` | Setzen Sie auf `false`, um Sitzungs-ID aus Metriken-Attributen auszuschließen (Standard: enthalten). Siehe [Monitoring](/docs/de/monitoring-usage) |494| `OTEL_METRICS_INCLUDE_SESSION_ID` | Setzen Sie auf `false`, um Sitzungs-ID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Monitoring](/docs/de/monitoring-usage) |

492| `OTEL_METRICS_INCLUDE_VERSION` | Setzen Sie auf `true`, um Claude Code-Version in Metriken-Attributen einzuschließen (Standard: ausgeschlossen). Siehe [Monitoring](/docs/de/monitoring-usage) |495| `OTEL_METRICS_INCLUDE_VERSION` | Setzen Sie auf `true`, um Claude Code-Version in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Siehe [Monitoring](/docs/de/monitoring-usage) |

493| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Überschreiben Sie das Zeichen-Budget für Skill-Metadaten, die dem [Skill-Tool](/docs/de/skills#control-who-invokes-a-skill) gezeigt werden. Das Budget skaliert dynamisch bei 1% des Kontext-Fensters, mit einem Fallback von 8.000 Zeichen. Legacy-Name behalten für Rückwärts-Kompatibilität |496| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Überschreiben Sie das Zeichen-Budget für Skill-Metadaten, die dem [Skill-Tool](/docs/de/skills#control-who-invokes-a-skill) gezeigt werden. Das Budget skaliert dynamisch bei 1% des Kontext-Fensters, mit einem Fallback von 8.000 Zeichen. Legacy-Name behalten für Rückwärts-Kompatibilität |

494| `TASK_MAX_OUTPUT_LENGTH` | Entfernt in v2.1.277 und jetzt ein No-Op, zusammen mit dem `TaskOutput`-Tool, das es dimensioniert. Setzte zuvor die maximale Anzahl von Zeichen der [Hintergrund-Task](/docs/de/tools-reference#background-commands)-Ausgabe, die das `TaskOutput`-Tool behielt. Claude liest die Ausgabedatei einer Hintergrund-Task mit `Read` statt |497| `TASK_MAX_OUTPUT_LENGTH` | Entfernt in v2.1.277 und jetzt ein No-Op, zusammen mit dem `TaskOutput`-Tool, das es dimensioniert. Setzte zuvor die maximale Anzahl von Zeichen der [Hintergrund-Task](/docs/de/tools-reference#background-commands)-Ausgabe, die das `TaskOutput`-Tool behielt. Claude liest die Ausgabe einer Hintergrund-Task mit `Read` statt |

495| `USE_BUILTIN_RIPGREP` | Setzen Sie auf `0`, um System-installiertes `rg` statt `rg` zu verwenden, das mit Claude Code enthalten ist |498| `USE_BUILTIN_RIPGREP` | Setzen Sie auf `0`, um System-installiertes `rg` anstelle von `rg`, das mit Claude Code enthalten ist, zu verwenden |

496| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Überschreiben Sie Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform |499| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Überschreiben Sie die Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform |

497| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Überschreiben Sie Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform |500| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Überschreiben Sie die Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform |

498| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Überschreiben Sie Region für Claude 3.7 Sonnet bei Verwendung von Google Cloud's Agent Platform |501| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Überschreiben Sie die Region für Claude 3.7 Sonnet bei Verwendung von Google Cloud's Agent Platform |

499| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Überschreiben Sie Region für Claude 4.0 Opus bei Verwendung von Google Cloud's Agent Platform |502| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Überschreiben Sie die Region für Claude 4.0 Opus bei Verwendung von Google Cloud's Agent Platform |

500| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Überschreiben Sie Region für Claude 4.0 Sonnet bei Verwendung von Google Cloud's Agent Platform |503| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Überschreiben Sie die Region für Claude 4.0 Sonnet bei Verwendung von Google Cloud's Agent Platform |

501| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Überschreiben Sie Region für Claude 4.1 Opus bei Verwendung von Google Cloud's Agent Platform |504| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Überschreiben Sie die Region für Claude 4.1 Opus bei Verwendung von Google Cloud's Agent Platform |

502| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Überschreiben Sie Region für Claude Opus 4.5 bei Verwendung von Google Cloud's Agent Platform |505| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Überschreiben Sie die Region für Claude Opus 4.5 bei Verwendung von Google Cloud's Agent Platform |

503| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Überschreiben Sie Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform |506| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform |

504| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Überschreiben Sie Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform |507| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Überschreiben Sie die Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform |

505| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Überschreiben Sie Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform |508| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform |

506| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Überschreiben Sie Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform |509| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Überschreiben Sie die Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform |

507| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Überschreiben Sie Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform |510| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Überschreiben Sie die Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform |

508| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Überschreiben Sie Region für Claude Opus 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.280 |511| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Überschreiben Sie die Region für Claude Opus 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.280 |

509| `VERTEX_REGION_CLAUDE_5_OPUS` | Überschreiben Sie Region für Claude Opus 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.219 |512| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.284 |

510| `VERTEX_REGION_CLAUDE_5_SONNET` | Überschreiben Sie Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |513| `VERTEX_REGION_CLAUDE_5_OPUS` | Überschreiben Sie die Region für Claude Opus 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.219 |

511| `VERTEX_REGION_CLAUDE_FABLE_5` | Überschreiben Sie Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |514| `VERTEX_REGION_CLAUDE_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |

512| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Überschreiben Sie Region für Claude Fable 5.1 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.257 |515| `VERTEX_REGION_CLAUDE_FABLE_5` | Überschreiben Sie die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |

513| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreiben Sie Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |516| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Überschreiben Sie die Region für Claude Fable 5.1 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.257 |

517| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreiben Sie die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |

514 518

515Standard-OpenTelemetry-Exporter-Variablen (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` und Signal-spezifische Varianten) werden auch unterstützt. Siehe [Monitoring](/docs/de/monitoring-usage) für Konfigurationsdetails.519Standard-OpenTelemetry-Exporter-Variablen (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` und Signal-spezifische Varianten) werden auch unterstützt. Siehe [Monitoring](/docs/de/monitoring-usage) für Konfigurationsdetails.

516 520

517Setzen Sie `CLAUDE_CODE_ENABLE_TELEMETRY` und die OpenTelemetry-Variablen, die Export einschalten, sein Ziel wählen oder Inhalt erfassen, in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Claude Code [ignoriert sie in Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env), außer den Off-Werten, die dieser Abschnitt beschreibt. `OTEL_RESOURCE_ATTRIBUTES` und die Export-Intervall-, Timeout- und Komprimierungs-Variablen, wie `OTEL_METRIC_EXPORT_INTERVAL`, gelten immer noch aus Projekt- und lokalen Einstellungen.521Setzen Sie `CLAUDE_CODE_ENABLE_TELEMETRY` und die OpenTelemetry-Variablen, die Export einschalten, sein Ziel wählen oder Inhalt erfassen, in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Claude Code [ignoriert sie in Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env), außer den Off-Werten, die dieser Abschnitt beschreibt. `OTEL_RESOURCE_ATTRIBUTES` und die Export-Intervall-, Timeout- und Kompressions-Variablen, wie `OTEL_METRIC_EXPORT_INTERVAL`, gelten immer noch aus Projekt- und lokalen Einstellungen.

518 522

519<h2 id="features-that-need-feature-flag-fetching">523<h2 id="features-that-need-feature-flag-fetching">

520 Funktionen, die das Abrufen von Feature-Flags erfordern524 Funktionen, die das Abrufen von Feature-Flags erfordern

528 532

529Wenn das Abrufen deaktiviert ist, können Sie nicht:533Wenn das Abrufen deaktiviert ist, können Sie nicht:

530 534

531* [Sitzungen standardmäßig im Auto-Modus starten](/docs/de/permission-modes#which-mode-a-session-starts-in) auf Pro-, Max- und Team-Plänen

532* Die VS Code-Erweiterung [Einstellungsdateien für den Startberechtigungsmodus lesen lassen](/docs/de/permission-modes#switch-permission-modes)

533* [`/auto-mode-setup`](/docs/de/auto-mode-config#generate-environment-entries) ausführen, um `autoMode.environment`-Einträge zu entwerfen535* [`/auto-mode-setup`](/docs/de/auto-mode-config#generate-environment-entries) ausführen, um `autoMode.environment`-Einträge zu entwerfen

534* [Remote Control](/docs/de/remote-control#requirements) verwenden536* [Remote Control](/docs/de/remote-control) mit `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` verwenden. Für `DISABLE_TELEMETRY` und `DO_NOT_TRACK` siehe die [Remote Control-Anforderungen](/docs/de/remote-control#requirements)

535* [Sitzungen über diese Maschine hinaus Nachrichten senden](/docs/de/cross-session-messaging#message-sessions-on-other-machines); das Messaging zwischen Sitzungen auf dieser Maschine funktioniert mit deaktiviertem Abrufen537* [Sitzungen über diese Maschine hinaus Nachrichten senden](/docs/de/cross-session-messaging#message-sessions-on-other-machines), wenn [Remote Control](/docs/de/remote-control#requirements) nicht verfügbar ist. Das Messaging zwischen Sitzungen auf dieser Maschine funktioniert mit deaktiviertem Abrufen

536* [`claude import` oder den `/import`-Befehl](/docs/de/cli-reference#cli-commands) ausführen538* [`claude import` oder den `/import`-Befehl](/docs/de/cli-reference#cli-commands) ausführen

537* [`/skill-doctor`](/docs/de/skills#find-unused-skills) ausführen oder seinen Bericht in der `/plugin` **Stats**-Registerkarte öffnen539* [`/skill-doctor`](/docs/de/skills#find-unused-skills) ausführen oder seinen Bericht in der `/plugin` **Stats**-Registerkarte öffnen

538* Die [Skills](/docs/de/skills#where-synced-skills-load) und [Plugins](/docs/de/plugins/loading#synced-plugins) synchronisieren, die für Ihr claude.ai-Konto aktiviert sind, in Ihre Terminal-Sitzungen540* Die [Skills](/docs/de/skills#where-synced-skills-load) und [Plugins](/docs/de/plugins/loading#synced-plugins) synchronisieren, die für Ihr claude.ai-Konto aktiviert sind, in Ihre Terminal-Sitzungen

548 Erste Sitzung nach einer Installation oder einem Upgrade550 Erste Sitzung nach einer Installation oder einem Upgrade

549</h3>551</h3>

550 552

551In Ihrer ersten Sitzung nach der Installation von Claude Code oder dem Upgrade auf eine Version, die eine Funktion hinzufügt, kann eine [Flag-gesteuerte Funktion](#features-that-need-feature-flag-fetching) fehlen, und die Sitzung kann im manuellen Modus auf einem Plan starten, der ansonsten im Auto-Modus startet. Claude Code ruft die Flags während dieser Sitzung ab, sodass beide in Ihrer nächsten Sitzung vorhanden sind.553In Ihrer ersten Sitzung nach der Installation von Claude Code oder dem Upgrade auf eine Version, die eine Funktion hinzufügt, kann eine [Flag-gesteuerte Funktion](#features-that-need-feature-flag-fetching) fehlen. Diese Sitzung kann auch in einem anderen [Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) starten als Ihre späteren Sitzungen. Claude Code ruft die Flags während dieser Sitzung ab, sodass Ihre nächste Sitzung die Funktion und den üblichen Startberechtigungsmodus hat.

552 554

553Nach einer Neuinstallation kann Claude Code in einer nicht-interaktiven Sitzung wie `claude -p`, dem Agent SDK oder der VS Code-Erweiterung die Flags immer noch abrufen, bevor es [den Startberechtigungsmodus wählt](/docs/de/permission-modes#which-mode-a-session-starts-in).555Nach einer Neuinstallation kann Claude Code in einer nicht-interaktiven Sitzung wie `claude -p`, dem Agent SDK oder der VS Code-Erweiterung die Flags immer noch abrufen, bevor es [den Startberechtigungsmodus wählt](/docs/de/permission-modes#which-mode-a-session-starts-in).

554 556

errors.md +762 −377

Details

6 6

7> Schlagen Sie Claude Code-Laufzeitfehlermeldungen nach und erfahren Sie, was jede bedeutet und wie Sie sie beheben.7> Schlagen Sie Claude Code-Laufzeitfehlermeldungen nach und erfahren Sie, was jede bedeutet und wie Sie sie beheben.

8 8

9Diese Seite listet Laufzeitfehler auf, die Claude Code anzeigt, und wie Sie sich von jedem erholen können. Außerdem erfahren Sie, was Sie überprüfen sollten, wenn Antworten ohne Fehler seltsam wirken. Für Installationsfehler wie `command not found` oder TLS-Fehler während des Setups siehe [Troubleshoot installation and login](/docs/de/troubleshoot-install).9Diese Seite listet Laufzeitfehler auf, die Claude Code anzeigt, und wie Sie sich von jedem erholen können, sowie was Sie überprüfen sollten, wenn Antworten ohne Fehler seltsam wirken. Für Installationsfehler wie `command not found` oder TLS-Fehler während des Setups siehe [Troubleshoot installation and login](/docs/de/troubleshoot-install).

10 10

11Mit Ausnahme von [Wrapper and IDE errors](#wrapper-and-ide-errors), die das startende Programm ausgibt und nicht Claude Code selbst, gelten diese Fehler und Wiederherstellungsbefehle über die CLI, die [Desktop-App](/docs/de/desktop) und [Claude Code im Web](/docs/de/claude-code-on-the-web), da alle drei die gleiche Claude Code CLI verwenden. Für andere oberflächenspezifische Probleme siehe den Abschnitt zur Fehlerbehebung auf der Seite dieser Oberfläche.11Mit Ausnahme von [Wrapper and IDE errors](#wrapper-and-ide-errors), die das startende Programm ausgibt und nicht Claude Code selbst, gelten diese Fehler und Wiederherstellungsbefehle über die CLI, die [Desktop-App](/docs/de/desktop) und [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), da alle drei die gleiche Claude Code CLI verwenden. Für andere oberflächenspezifische Probleme siehe den Abschnitt zur Fehlerbehebung auf der Seite dieser Oberfläche.

12 12

13<Note>13<Note>

14 Claude Code ruft die Claude API für Modellantworten auf, daher werden die meisten Laufzeitfehler einem zugrunde liegenden API-Fehlercode zugeordnet. Diese Seite behandelt, was jeder Fehler in Claude Code bedeutet und wie Sie sich davon erholen. Für die rohen HTTP-Statuscode-Definitionen siehe die [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).14 Claude Code ruft die Claude API für Modellantworten auf, daher werden die meisten Laufzeitfehler einem zugrunde liegenden API-Fehlercode zugeordnet. Diese Seite behandelt, was jeder Fehler in Claude Code bedeutet und wie Sie sich davon erholen. Für die rohen HTTP-Statuscode-Definitionen siehe die [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).

24| :- | :- |24| :- | :- |

25| `API Error: 500 Internal server error` | [Serverfehler](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Serverfehler](#api-error-500-internal-server-error) |

26| `API Error: Repeated 529 Overloaded errors` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |

27| `Opus is experiencing high load` / `Fable is experiencing high load` | [Serverfehler](#api-error-repeated-529-overloaded-errors) |

27| `Request timed out` | [Serverfehler](#request-timed-out), oder [Netzwerk](#unable-to-connect-to-api), wenn die Meldung Ihre Internetverbindung erwähnt |28| `Request timed out` | [Serverfehler](#request-timed-out), oder [Netzwerk](#unable-to-connect-to-api), wenn die Meldung Ihre Internetverbindung erwähnt |

28| `API Error: No response from API` | [Serverfehler](#no-response-from-api) |29| `API Error: No response from API` | [Serverfehler](#no-response-from-api) |

29| `Server error mid-response. The response above may be incomplete.` | [Serverfehler](#the-response-above-may-be-incomplete) |30| `Server error mid-response. The response above may be incomplete.` | [Serverfehler](#the-response-above-may-be-incomplete) |

30| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Serverfehler](#the-response-above-may-be-incomplete) |31| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Serverfehler](#the-response-above-may-be-incomplete) |

31| `Connection closed mid-response` / `Response stalled mid-stream` | [Serverfehler](#the-response-above-may-be-incomplete) |32| `Connection closed mid-response` / `Response stalled mid-stream` | [Serverfehler](#the-response-above-may-be-incomplete) |

33| `Part of the response never arrived` / `The response stream was malformed` | [Serverfehler](#the-response-above-may-be-incomplete) |

34| `API Error: Content block not found` / `API Error: Content block already closed` / `API Error: Stream event unreadable` | [Serverfehler](#the-response-above-may-be-incomplete) |

32| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatische Wiederholungen](#automatic-retries) |35| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatische Wiederholungen](#automatic-retries) |

33| `Connection closed while thinking` / `Response stalled while thinking` | [Automatische Wiederholungen](#automatic-retries) |36| `Connection closed while thinking` / `Response stalled while thinking` | [Automatische Wiederholungen](#automatic-retries) |

34| `Connection lost while your computer was asleep` | [Automatische Wiederholungen](#automatic-retries) |37| `Connection lost while your computer was asleep` | [Automatische Wiederholungen](#automatic-retries) |

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

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

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

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

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

52| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |57| `Could not resolve authentication method` | [Authentifizierung](#could-not-resolve-authentication-method) |

53| `Invalid API key` | [Authentifizierung](#invalid-api-key) |58| `Invalid API key` | [Authentifizierung](#invalid-api-key) |

54| `Your apiKeyHelper script is failing` | [Authentifizierung](#your-apikeyhelper-script-is-failing) |59| `Your apiKeyHelper script is failing` | [Authentifizierung](#your-apikeyhelper-script-is-failing) |

69| `signed-in claude.ai account or organization changed on this machine` | [Authentifizierung](#remote-control-stopped-because-the-signed-in-account-changed) |74| `signed-in claude.ai account or organization changed on this machine` | [Authentifizierung](#remote-control-stopped-because-the-signed-in-account-changed) |

70| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentifizierung](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentifizierung](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

71| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentifizierung](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |76| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentifizierung](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

77| `Couldn't verify your organization's policy for remote control` | [Fehlerbehebung für Remote Control](/docs/de/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |

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

73| `API Error: 401 Invalid authentication credentials` | [Authentifizierung](#api-error-401-invalid-authentication-credentials) |79| `API Error: 401 Invalid authentication credentials` | [Authentifizierung](#api-error-401-invalid-authentication-credentials) |

74| `Login expired · Please run /login` | [Authentifizierung](#login-expired) |80| `Login expired · Please run /login` | [Authentifizierung](#login-expired) |

81| `Failed to start OAuth callback server` | [Authentifizierung](#failed-to-start-oauth-callback-server) |

75| `Claude login not accepted · Run /login, then try again` | [Authentifizierung](#claude-login-not-accepted) |82| `Claude login not accepted · Run /login, then try again` | [Authentifizierung](#claude-login-not-accepted) |

76| `Artifacts need a claude.ai login` | [Authentifizierung](#artifacts-need-a-claude-ai-login) |83| `Artifacts need a claude.ai login` | [Authentifizierung](#artifacts-need-a-claude-ai-login) |

77| `Not signed in to the Cloud gateway — run /login.` | [Authentifizierung](#administrator-policy-requires-a-cloud-gateway-sign-in) |84| `Not signed in to the Cloud gateway — run /login.` | [Authentifizierung](#administrator-policy-requires-a-cloud-gateway-sign-in) |

78| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentifizierung](#administrator-policy-requires-a-cloud-gateway-sign-in) |85| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentifizierung](#administrator-policy-requires-a-cloud-gateway-sign-in) |

79| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentifizierung](#login-expired) |86| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentifizierung](#login-expired) |

87| `Could not refresh your login because another Claude Code process is refreshing it` | [Authentifizierung](#could-not-refresh-your-login) |

88| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Authentifizierung](#could-not-refresh-your-login) |

80| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentifizierung](#your-account-is-on-hold) |89| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentifizierung](#your-account-is-on-hold) |

81| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentifizierung](#your-account-is-on-hold) |90| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentifizierung](#your-account-is-on-hold) |

82| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentifizierung](#anthropic-profile-login-expired) |91| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentifizierung](#anthropic-profile-login-expired) |

121| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Netzwerk](#sessions-ended-while-this-machine-was-offline) |130| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Netzwerk](#sessions-ended-while-this-machine-was-offline) |

132| `Couldn't send feedback` | [Netzwerk](#couldnt-send-feedback) |

125| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Anfragefehler](#prompt-is-too-long) |135| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Anfragefehler](#prompt-is-too-long) |

131| `all upstreams failed (N attempted)` auf einer Claude-Apps-Gateway-Sitzung | [Upstream-Fehlermeldungen](/docs/de/claude-apps-gateway-config#upstream-error-messages) |141| `all upstreams failed (N attempted)` auf einer Claude-Apps-Gateway-Sitzung | [Upstream-Fehlermeldungen](/docs/de/claude-apps-gateway-config#upstream-error-messages) |

132| `Claude Code may not be enabled for your organization` nach einer Claude-Apps-Gateway-Anmeldung | [Fehlerbehebung für Claude-Apps-Gateway](/docs/de/claude-apps-gateway-deploy#troubleshooting) |142| `Claude Code may not be enabled for your organization` nach einer Claude-Apps-Gateway-Anmeldung | [Fehlerbehebung für Claude-Apps-Gateway](/docs/de/claude-apps-gateway-deploy#troubleshooting) |

133| `Context exceeds the ...-token limit by ... tokens` in `/context`-Ausgabe | [Anfragefehler](#context-exceeds-the-token-limit) |143| `Context exceeds the ...-token limit by ... tokens` in `/context`-Ausgabe | [Anfragefehler](#context-exceeds-the-token-limit) |

134| `Error during compaction: Conversation too long` | [Anfragefehler](#error-during-compaction-conversation-too-long) |

141| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Anfragefehler](#tool-input-schema-is-invalid) |150| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Anfragefehler](#tool-input-schema-is-invalid) |

151| `tool_use.name: String should have at most 200 characters` | [Anfragefehler](#tool-use-name-over-200-characters) |

155| `API error: ... · model not changed` | [Anfragefehler](#api-error-model-not-changed) |

145| `Claude Opus is not available with the Claude Pro plan` | [Anfragefehler](#claude-opus-is-not-available-with-the-claude-pro-plan) |156| `Claude Opus is not available with the Claude Pro plan` | [Anfragefehler](#claude-opus-is-not-available-with-the-claude-pro-plan) |

146| `Claude Code ... does not support this model; version ... or newer is required` | [Anfragefehler](#claude-code-does-not-support-this-model) |157| `Claude Code ... does not support this model; version ... or newer is required` | [Anfragefehler](#claude-code-does-not-support-this-model) |

147| `Claude Code ... is older than the minimum version required by your organization's policy` | [Anfragefehler](#claude-code-does-not-support-this-model) |158| `Claude Code ... is older than the minimum version required by your organization's policy` | [Anfragefehler](#claude-code-does-not-support-this-model) |

148| `Model ... is restricted by your organization's settings` | [Anfragefehler](#model-is-restricted-by-your-organizations-settings) |159| `Model ... is restricted by your organization's settings` | [Anfragefehler](#model-is-restricted-by-your-organizations-settings) |

160| `Model ... is not available. Your organization restricts model selection.` | [Anfragefehler](#model-is-restricted-by-your-organizations-settings) |

149| `Model switch ... blocked by a PreModelSwitch hook` | [Anfragefehler](#model-switch-was-blocked-by-a-premodelswitch-hook) |161| `Model switch ... blocked by a PreModelSwitch hook` | [Anfragefehler](#model-switch-was-blocked-by-a-premodelswitch-hook) |

150| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Anfragefehler](#couldnt-save-it-as-your-default) |162| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Anfragefehler](#couldnt-save-it-as-your-default) |

151| `thinking.type.enabled is not supported for this model` | [Anfragefehler](#thinking-type-enabled-is-not-supported-for-this-model) |163| `thinking.type.enabled is not supported for this model` | [Anfragefehler](#thinking-type-enabled-is-not-supported-for-this-model) |

170| `Invalid data in redacted_thinking block` | [Anfragefehler](#invalid-data-in-redacted-thinking-block) |

160| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Anfragefehler](#invalid-encrypted-content-in-search-result-block) |173| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Anfragefehler](#invalid-encrypted-content-in-search-result-block) |

174| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Anfragefehler](#invalid-encrypted-content-in-search-result-block) |

161| `server_tool_use.name: Input should be` auf jedem Turn einer fortgesetzten Sitzung | [Anfragefehler](#unsupported-tool-content-removed) |175| `server_tool_use.name: Input should be` auf jedem Turn einer fortgesetzten Sitzung | [Anfragefehler](#unsupported-tool-content-removed) |

163| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Anfragefehler](#usage-policy-refusal) |177| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Anfragefehler](#usage-policy-refusal) |

166| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Anfragefehler](#safety-measures-flagged-a-cybersecurity-topic) |180| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Anfragefehler](#safety-measures-flagged-a-cybersecurity-topic) |

167| `Installation was killed before it could finish (exit code 137)` | [Installationsfehler](#installation-was-killed-before-it-could-finish) |181| `Installation was killed before it could finish (exit code 137)` | [Installationsfehler](#installation-was-killed-before-it-could-finish) |

168| `The connection dropped while downloading the update` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |182| `The connection dropped while downloading the update` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |

169| `Download timed out: exceeded the total deadline` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |183| `Download timed out: exceeded the total deadline` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |

171| `Cloud sessions cannot be created from a --restricted session` | [Befehlszeilenfehler](#cloud-sessions-cannot-be-created-from-a-restricted-session) |185| `Cloud sessions cannot be created from a --restricted session` | [Befehlszeilenfehler](#cloud-sessions-cannot-be-created-from-a-restricted-session) |

172| `Cloud sessions are disabled by your organization's policy` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |186| `Cloud sessions are disabled by your organization's policy` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |

173| `Couldn't verify your organization's policy for cloud sessions` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |187| `Couldn't verify your organization's policy for cloud sessions` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |

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

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

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

178| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |194| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Befehlszeilenfehler](#temp-directory-refused-or-cannot-be-created) |

209| `No conversation found with session ID: <session-id>` | [Befehlszeilenfehler](#no-conversation-found-with-the-session-id) |225| `No conversation found with session ID: <session-id>` | [Befehlszeilenfehler](#no-conversation-found-with-the-session-id) |

226| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [Befehlszeilenfehler](#windows-reported-an-error-ebadf) |

211| `Cannot switch renderers while work is running in the background` | [Befehlszeilenfehler](#cannot-switch-renderers-in-this-session) |228| `Cannot switch renderers while work is running in the background` | [Befehlszeilenfehler](#cannot-switch-renderers-in-this-session) |

218| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Befehlszeilenfehler](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |235| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Befehlszeilenfehler](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

219| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin-Fehler](#plugin-eval-is-currently-in-early-access) |236| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin-Fehler](#plugin-eval-is-currently-in-early-access) |

220| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |237| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |

238| `Claude Code refuses the marketplace name "<name>"` | [Plugin-Fehler](#claude-code-refuses-the-marketplace-name) |

239| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin-Fehler](#claude-code-refuses-the-marketplace-name) |

221| `Marketplace "<name>" is already added from a different source` | [Plugin-Fehler](#marketplace-is-already-added-from-a-different-source) |240| `Marketplace "<name>" is already added from a different source` | [Plugin-Fehler](#marketplace-is-already-added-from-a-different-source) |

222| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin-Fehler](#marketplace-name-is-another-spelling-of-a-reserved-name) |241| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin-Fehler](#marketplace-name-is-another-spelling-of-a-reserved-name) |

223| `references ${user_config.*} in a shell-form command` | [Plugin-Fehler](#plugin-command-references-user-config) |242| `references ${user_config.*} in a shell-form command` | [Plugin-Fehler](#plugin-command-references-user-config) |

233| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin-Fehler](#plugin-is-required-by-your-organization) |252| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin-Fehler](#plugin-is-required-by-your-organization) |

253| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [Plugin-Fehler](#plugin-was-not-uninstalled) |

254| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Plugin-Fehler](#plugin-was-not-uninstalled) |

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

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

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

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

237| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Werkzeugfehler](#memory-index-is-over-its-read-limit) |260| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Werkzeugfehler](#memory-index-is-over-its-read-limit) |

241| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Werkzeugfehler](#teammate-agent-definition-not-restored) |264| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Werkzeugfehler](#teammate-agent-definition-not-restored) |

267| `Cross-session message was dropped at the recipient session's inbox` | [Werkzeugfehler](#cross-session-message-dropped-at-the-inbox) |

244| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Werkzeugfehler](#refusing-to-send-a-cross-session-message) |268| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Werkzeugfehler](#refusing-to-send-a-cross-session-message) |

245| `Refusing to send: connected endpoint is not the expected process` / `Refusing to send: connected endpoint identity could not be read` | [Werkzeugfehler](#refusing-to-send-a-cross-session-message) |

246| `Refusing to send: connected endpoint is not owned by this user` / `Refusing to send: connected endpoint owner could not be read` | [Werkzeugfehler](#refusing-to-send-a-cross-session-message) |

247| `Refusing to send: connected endpoint is a different process with the expected pid` | [Werkzeugfehler](#refusing-to-send-a-cross-session-message) |

248| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |269| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |

249| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |270| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |

250| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |271| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |

272| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |

251| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |273| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |

252| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |274| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Werkzeugfehler](#refusing-after-a-symlink-changed) |

254| `Command killed: its output file was replaced or could no longer be verified` | [Werkzeugfehler](#task-output-swap-refused) |276| `Command killed: its output file was replaced or could no longer be verified` | [Werkzeugfehler](#task-output-swap-refused) |

277| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

278| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

279| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Werkzeugfehler](#disk-quota-or-temp-filesystem-is-full) |

255| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |280| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Werkzeugfehler](#the-source-file-is-not-valid-utf-8-text) |

257| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |282| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Werkzeugfehler](#reading-a-local-file-from-outside-the-connected-folders) |

279| `EACCES: permission denied, posix_spawn` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |304| `EACCES: permission denied, posix_spawn` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |

280| `exited before it became reachable` | [Fehler in Hintergrund-Sitzungen](#background-service-exited-before-it-became-reachable) |305| `exited before it became reachable` | [Fehler in Hintergrund-Sitzungen](#background-service-exited-before-it-became-reachable) |

281| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Fehler in Hintergrund-Sitzungen](#working-directory-no-longer-exists-when-starting-a-background-session) |306| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Fehler in Hintergrund-Sitzungen](#working-directory-no-longer-exists-when-starting-a-background-session) |

307| `Workspace not trusted.` beim Starten oder Neustarten einer Hintergrund-Sitzung | [Fehler in Hintergrund-Sitzungen](#workspace-not-trusted-when-dispatching-a-background-session) |

282| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |308| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Fehler in Hintergrund-Sitzungen](#eacces-when-starting-a-background-session) |

284| `The connection to Claude Code ended before this message completed` | [Wrapper- und IDE-Fehler](#the-connection-to-claude-code-ended-before-this-message-completed) |310| `The connection to Claude Code ended before this message completed` | [Wrapper- und IDE-Fehler](#the-connection-to-claude-code-ended-before-this-message-completed) |

291| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Konfigurationswarnungen](#fullscreen-failed-start-notice) |317| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Konfigurationswarnungen](#fullscreen-failed-start-notice) |

292| `Claude Code exited after an unrecoverable interface error (...)` | [Konfigurationswarnungen](#exited-after-an-unrecoverable-interface-error) |318| `Claude Code exited after an unrecoverable interface error (...)` | [Konfigurationswarnungen](#exited-after-an-unrecoverable-interface-error) |

293| `Agent descriptions are over the 15.0k-token limit` | [Konfigurationswarnungen](#agent-descriptions-are-over-the-15000-token-limit) |319| `Agent descriptions are over the 15.0k-token limit` | [Konfigurationswarnungen](#agent-descriptions-are-over-the-15000-token-limit) |

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

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

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

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

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

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

298| `MCP server <name> is blocked by enterprise managed policy` | [Konfigurationswarnungen](#mcp-server-is-blocked-by-enterprise-managed-policy) |326| `MCP server <name> is blocked by enterprise managed policy` | [Konfigurationswarnungen](#mcp-server-is-blocked-by-enterprise-managed-policy) |

299| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Konfigurationswarnungen](#managed-settings-document-could-not-be-parsed) |327| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Konfigurationswarnungen](#managed-settings-document-could-not-be-parsed) |

300| `Managed settings drop-in directory could not be read` | [Konfigurationswarnungen](#managed-settings-document-could-not-be-parsed) |328| `Managed settings drop-in directory could not be read` | [Konfigurationswarnungen](#managed-settings-document-could-not-be-parsed) |

313 Automatische Wiederholungen341 Automatische Wiederholungen

314</h2>342</h2>

315 343

316Claude Code wiederholt vorübergehende Fehler bis zu 10-mal mit exponentiellem Backoff, bevor dir ein Fehler angezeigt wird. Es wiederholt nicht immer einen Fehler, der während einer unvollständigen Antwort von Claude auftritt. Wenn du einen der Fehler auf dieser Seite siehst, hat Claude Code bereits alle anwendbaren Wiederholungen für diesen Fehler durchgeführt; die Listen unten zeigen, welche Fehler das volle Budget erhalten, welche ein kleineres erhalten, und welche keines erhalten.344Claude Code wiederholt vorübergehende Fehler bis zu 10-mal mit exponentiellem Backoff, bevor dir ein Fehler angezeigt wird. Es wiederholt nicht immer einen Fehler, der während einer unvollständigen Antwort von Claude auftritt. Wenn du einen der Fehler auf dieser Seite siehst, hat Claude Code bereits alle anwendbaren Wiederholungen für diesen Fehler durchgeführt.

317 345

318Claude Code wiederholt diese Fehler:346Claude Code wiederholt diese Fehler:

319 347

390 418

391Der abschließende Satz nennt den Ort, an dem die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen nennen die Servicestatuseite dieses Anbieters. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.419Der abschließende Satz nennt den Ort, an dem die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen nennen die Servicestatuseite dieses Anbieters. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.

392 420

393Dies zeigt einen unerwarteten Fehler innerhalb der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.421Ein 5xx von der API selbst zeigt einen unerwarteten Fehler innerhalb der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.

422

423Wenn ein Proxy, Load Balancer oder Gateway mit einer HTML-Fehlerseite antwortet, zeigt die Nachricht den Statuscode und den Titel der Seite an, wie z. B. `API Error: 502 Bad Gateway`. Für eine Seite ohne Titel zeigt die Nachricht den Statuscode und seinen Standardnamen stattdessen an. Vor v2.1.281 wurde der Statuscode gelöscht, wenn die Seite einen Titel hatte, und das rohe Markup der Seite wurde gedruckt, wenn sie keinen hatte.

394 424

395**Was zu tun ist:**425**Was zu tun ist:**

396 426

402 API-Fehler: Wiederholte 529 Overloaded-Fehler432 API-Fehler: Wiederholte 529 Overloaded-Fehler

403</h3>433</h3>

404 434

405Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat bereits mehrmals versucht, diese Nachricht anzuzeigen, bevor sie angezeigt wird:435Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat bereits mehrmals versucht, bevor diese Nachricht angezeigt wird:

406 436

407```text theme={null}437```text theme={null}

408API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.438API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

410 440

411Der abschließende Satz variiert je nach Anbieter auf die gleiche Weise wie der 500-Fehler oben.441Der abschließende Satz variiert je nach Anbieter auf die gleiche Weise wie der 500-Fehler oben.

412 442

413Ein 529-Fehler ist nicht Ihr Nutzungslimit und wird nicht auf Ihr Kontingent angerechnet.443Ein 529 ist nicht Ihr Nutzungslimit und wird nicht auf Ihr Kontingent angerechnet.

414 444

415**Was zu tun ist:**445**Was zu tun ist:**

416 446

417* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die im Fehler genannte Anbieter-Statusseite auf Kapazitätsmitteilungen447* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die im Fehler genannte Anbieter-Statusseite auf Kapazitätsmitteilungen

418* Versuchen Sie es in ein paar Minuten erneut448* Versuchen Sie es in ein paar Minuten erneut

419* Führen Sie `/model` aus und wechseln Sie zu einem anderen Modell, um weiterarbeiten zu können, da die Kapazität pro Modell verfolgt wird. Claude Code fordert Sie dazu auf, wenn ein Modell unter besonders hoher Last steht, z. B. `Opus is experiencing high load, please use /model to switch to Sonnet`.449* Führen Sie `/model` aus und wechseln Sie zu einem anderen Modell, um weiterarbeiten zu können, da die Kapazität pro Modell verfolgt wird. Claude Code fordert Sie dazu auf, wenn ein Modell unter besonders hoher Last steht, z. B. `Opus is experiencing high load, please use /model to switch to Sonnet`. Bei Fable-Modellen nennt die Nachricht Fable.

450

451 In einer Sitzung, die die Claude Desktop-App ausführt, wie z. B. die Registerkarte Code oder Cowork, lautet die Nachricht `Opus is experiencing high load. Switch to Sonnet.` und Sie wechseln Modelle mit der Modellauswahl der App.

420 452

421<h3 id="request-timed-out">453<h3 id="request-timed-out">

422 Anfrage hat das Zeitlimit überschritten454 Anfrage hat das Zeitlimit überschritten

433**Was zu tun ist:**465**Was zu tun ist:**

434 466

435* Wiederholen Sie die Anfrage467* Wiederholen Sie die Anfrage

436* Teilen Sie die Arbeit bei langwierigen Aufgaben in kleinere Prompts auf

437* Wenn eine langsame Netzwerk- oder Proxy-Verbindung die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben468* Wenn eine langsame Netzwerk- oder Proxy-Verbindung die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben

438* Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten469* Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten

439 470

457**Was zu tun ist:**488**Was zu tun ist:**

458 489

459* Senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.490* Senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.

460* Wenn es sich wiederholt, behandeln Sie es als [Netzwerk- oder Proxy-Problem](#unable-to-connect-to-api). Ein Proxy, der die Verbindung akzeptiert und die Anfrage nie weiterleitet, erzeugt diesen Fehler bei jedem Versuch.491* Wenn es sich wiederholt, behandeln Sie es als [Netzwerk- oder Proxy-Problem](#unable-to-connect-to-api).

461* Wenn ein Proxy oder Gateway in Ihrem Netzwerk Antworten bis zum Abschluss hält, erhöhen Sie `API_TIMEOUT_MS`, damit die Wiederholung länger wartet. Bei Amazon Bedrock erhöhen Sie auch `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.492* Wenn ein Proxy oder Gateway in Ihrem Netzwerk Antworten bis zum Abschluss hält, erhöhen Sie `API_TIMEOUT_MS`, damit die Wiederholung länger wartet. Bei Amazon Bedrock erhöhen Sie auch `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.

462* Wenn der erste Versuch immer das Zeitlimit überschreitet und die Wiederholung dann erfolgreich ist, erhöhen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, damit der erste Versuch auch lange genug wartet.493* Wenn der erste Versuch immer das Zeitlimit überschreitet und die Wiederholung dann erfolgreich ist, erhöhen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, damit der erste Versuch auch lange genug wartet.

463 494

474API Error: Connection lost mid-response. The response above may be incomplete.505API Error: Connection lost mid-response. The response above may be incomplete.

475API Error: Your computer went to sleep mid-response. The response above may be incomplete.506API Error: Your computer went to sleep mid-response. The response above may be incomplete.

476API Error: The response stopped arriving. The response above may be incomplete.507API Error: The response stopped arriving. The response above may be incomplete.

508API Error: Part of the response never arrived. The response above may be incomplete.

509API Error: The response stream was malformed. The response above may be incomplete.

477```510```

478 511

479* `Server error mid-response`: ein Mid-Stream-Overload- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die Teilausgabe und meldete den gesamten Zug als Fehler.512* `Server error mid-response`: ein Mid-Stream-Overload- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die Teilausgabe und meldete den gesamten Zug als Fehler.

480* `Connection lost mid-response`: die Verbindung wurde unterbrochen.513* `Connection lost mid-response`: die Verbindung wurde unterbrochen. Sie sehen diese Variante auch, wenn ein Proxy oder Gateway die Antworttexte sauber beendet, bevor die Antwort abgeschlossen ist.

481* `Your computer went to sleep mid-response`: Claude Code hat erkannt, dass Ihr Computer in den Ruhezustand gegangen ist, während die Antwort gestreamt wurde. Sobald Ihr Computer aufwacht, behandelt Claude Code die Verbindung als unterbrochen und stoppt das Lesen von ihr.514* `Your computer went to sleep mid-response`: Claude Code hat erkannt, dass Ihr Computer in den Ruhezustand gegangen ist, während die Antwort gestreamt wurde. Sobald Ihr Computer aufwacht, behandelt Claude Code die Verbindung als unterbrochen und stoppt das Lesen von ihr.

515* `Part of the response never arrived`: ein Stream-Ereignis wurde zwischen der API und Claude Code gelöscht, sodass ein späteres Ereignis auf Inhalte verwies, die nie ankamen. Vor v2.1.281 endete dieser Fall den Zug mit `API Error: Content block not found`.

516* `The response stream was malformed`: ein Ereignis kam für einen Inhaltsblock an, der bereits abgeschlossen war, oder ein Ereignis kam beschädigt an. Ein beschädigtes Ereignis ist eines, dessen Daten kein gültiges JSON sind, dessen Inhalt fehlt oder dessen Inhalt nicht dem Ereignistyp entspricht. Vor v2.1.284 erschien der Fehler des Parsers, wie z. B. einer, der mit `API Error: JSON Parse error` beginnt, stattdessen, wenn ein Ereignis mit ungültigem JSON ankam, nachdem Claude sein Denken, einen Textblock oder einen Toolaufruf abgeschlossen hatte.

482* `The response stopped arriving`: die Verbindung blieb offen, aber stoppte die Datenlieferung, sodass der Streaming-Idle-Watchdog sie abgebrochen hat. Vor v2.1.222 konnte Claude Code diesen Fehler auch auf [Gateway](/docs/de/gateways)-Verbindungen melden, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht wurden, während die Keep-Alive-Pings des Servers noch ankamen, da es dort nur geparste Antwortereignisse zählte; ein Upgrade stoppt diese falschen Zeitüberschreitungen auf diesen Routen. Gateways, die über eine Anbieter-Basis-URL wie `ANTHROPIC_BEDROCK_BASE_URL` erreicht werden, sind nicht vom Byte-Watchdog umhüllt; siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs).517* `The response stopped arriving`: die Verbindung blieb offen, aber stoppte die Datenlieferung, sodass der Streaming-Idle-Watchdog sie abgebrochen hat. Vor v2.1.222 konnte Claude Code diesen Fehler auch auf [Gateway](/docs/de/gateways)-Verbindungen melden, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht wurden, während die Keep-Alive-Pings des Servers noch ankamen, da es dort nur geparste Antwortereignisse zählte; ein Upgrade stoppt diese falschen Zeitüberschreitungen auf diesen Routen. Gateways, die über eine Anbieter-Basis-URL wie `ANTHROPIC_BEDROCK_BASE_URL` erreicht werden, sind nicht vom Byte-Watchdog umhüllt; siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs).

483 518

484Vor v2.1.227 las `Connection lost mid-response` `Connection closed mid-response` und `The response stopped arriving` las `Response stalled mid-stream`.519Vor v2.1.227 las `Connection lost mid-response` `Connection closed mid-response` und `The response stopped arriving` las `Response stalled mid-stream`.

485 520

521Wenn ein gelöschtes, dupliziertes oder beschädigtes Stream-Ereignis ankommt, bevor Claude mit Text oder Toolaufruf begonnen hat, sehen Sie diese Mitteilung nicht:

522

523* Wenn Claude nur sein Denken abgeschlossen hatte, gibt Claude Code die Anfrage erneut aus. Wenn die erneut ausgegebenen Streams auf die gleiche Weise unterbrochen werden, endet der Zug mit `Part of the response never arrived and no response was produced. Try again.` oder `The response stream was malformed and no response was produced. Try again.`

524* Wenn nichts abgeschlossen war, sendet Claude Code die Anfrage stattdessen ohne Streaming erneut. Wenn Sie diesen Fallback mit [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/de/env-vars) deaktiviert haben, endet der Zug mit `API Error: Content block not found` für ein gelöschtes Ereignis oder `API Error: Content block already closed` für ein dupliziertes. Für ein beschädigtes Ereignis mit deaktiviertem Fallback endet der Zug mit `API Error: Stream event unreadable` oder dem Fehler des Parsers.

525

486In vier Fällen behandelt Claude Code den Fehler, ohne diese Mitteilung sofort anzuzeigen:526In vier Fällen behandelt Claude Code den Fehler, ohne diese Mitteilung sofort anzuzeigen:

487 527

488* Früher in der Antwort versucht Claude Code entweder, den Fehler erneut zu versuchen, oder beendet den Zug mit einem anderen Fehler. Siehe [Automatische Wiederholungen](#automatic-retries).528* Früher in der Antwort versucht Claude Code entweder, den Fehler erneut zu versuchen, oder beendet den Zug mit einem anderen Fehler. Siehe [Automatische Wiederholungen](#automatic-retries).

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

513```553```

514 554

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

516 556

517Wenn keine Kategorie passt, wird die Nachricht ohne Kategorie in Klammern angezeigt; mehr als ein Fehler erzeugt diese Form. Bei [Amazon Bedrock](/docs/de/amazon-bedrock), einschließlich des [Mantle-Endpunkts](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wird es auch angezeigt, wenn Ihr AWS-Konto das im Fehler genannte Modell nicht aufrufen kann, und dieser Fehler wiederholt sich bei jedem Wiederholungsversuch, bis Ihrem Konto Zugriff auf das Modell gewährt wird.557Wenn keine Kategorie passt, wird die Nachricht ohne Kategorie in Klammern angezeigt; mehr als ein Fehler erzeugt diese Form. Bei [Amazon Bedrock](/docs/de/amazon-bedrock), einschließlich des [Mantle-Endpunkts](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wird es auch angezeigt, wenn Ihr AWS-Konto das im Fehler genannte Modell nicht aufrufen kann, und dieser Fehler wiederholt sich bei jedem Wiederholungsversuch, bis Ihrem Konto Zugriff auf das Modell gewährt wird.

518 558

533**Was zu tun ist:**573**Was zu tun ist:**

534 574

535* Versuchen Sie die Aktion erneut; dies ist normalerweise beim nächsten Versuch erfolgreich575* Versuchen Sie die Aktion erneut; dies ist normalerweise beim nächsten Versuch erfolgreich

536* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion, um die zugrunde liegende Klassifiziererantwort im Debug-Protokoll zu sehen576* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion für Details im Debug-Protokoll

537 577

538Wenn eine separate API-Sicherheitsprüfung die Klassifiziereranfrage aufgrund früherer Konversationsinhalte blockiert hat:578Wenn eine separate API-Sicherheitsprüfung die Klassifiziereranfrage aufgrund früherer Konversationsinhalte blockiert hat:

539 579

668API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context708API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

669```709```

670 710

671Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenkontingente noch Kapazität haben. Siehe [Extended context](/docs/de/model-config#extended-context) für die Pläne, die 1M-Kontext direkt enthalten, und welche Nutzungsguthaben erfordern. Claude Code führt diese Prüfung durch, wenn Sie das Modell mit `/model` auswählen, und nur bei einer direkten Verbindung zur Anthropic-API; wenn Sie `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](/docs/de/llm-gateway) verweisen, erlaubt `/model` die `[1m]`-Auswahl und das Gateway entscheidet, ob die Anfrage erfolgreich ist.711In einer Sitzung, die die Claude Desktop-App ausführt, nennt der Hinweis keine Befehle: Er verweist auf die claude.ai-Nutzungseinstellungsseite, oder bei Team- und Enterprise-Plänen sagt er, dass Nutzungsguthaben unter claude.ai/admin-settings/usage aktiviert werden sollen, oder dass Sie Ihren Administrator fragen sollen.

712

713Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenkontingente noch Kapazität haben. Siehe [Extended context](/docs/de/model-config#extended-context) für die Pläne, die 1M-Kontext direkt enthalten, und welche Nutzungsguthaben erfordern.

672 714

673Wenn dieser Fehler mitten in einem Gespräch auftritt, weil der Kontext über 200K Token gewachsen ist, komprimiert Claude Code das Gespräch automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, daher ist keine Aktion erforderlich. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` auf diesen Versionen aus, um die Wiederherstellung durchzuführen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.715Wenn dieser Fehler mitten in einem Gespräch auftritt, weil der Kontext über 200K Token gewachsen ist, komprimiert Claude Code das Gespräch automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, daher ist keine Aktion erforderlich. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` auf diesen Versionen aus, um die Wiederherstellung durchzuführen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.

674 716

675**Was zu tun ist:**717**Was zu tun ist:**

676 718

677* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzufallen719* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzufallen

678* Wo die Meldung `/usage-credits` nennt, führen Sie es aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder um Nutzungsguthaben von Ihrem Administrator auf Team und Enterprise anzufordern. Starten Sie Claude Code neu, sobald Nutzungsguthaben aktiviert sind. Bis Sie neu starten, bleibt die Sitzung auf dem Standard-Kontextlimit.720* Wo die Meldung `/usage-credits` nennt, führen Sie es aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder um Nutzungsguthaben von Ihrem Administrator auf Team und Enterprise anzufordern. Sobald Nutzungsguthaben aktiviert sind, starten Sie Claude Code neu oder starten Sie eine neue Sitzung, je nachdem, was die Meldung sagt. Bis dahin bleibt die Sitzung auf dem Standard-Kontextlimit.

679* Wenn der Fehler nach `/model` weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle gesetzt sein. Siehe [Setting your model](/docs/de/model-config#setting-your-model) für die zu überprüfenden Konfigurationsorte in Prioritätsreihenfolge.721* Wenn der Fehler nach `/model` weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle gesetzt sein. Siehe [Setting your model](/docs/de/model-config#setting-your-model) für die zu überprüfenden Konfigurationsorte in Prioritätsreihenfolge.

680* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars)722* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars)

681 723

733 775

734Der nachfolgende Satz nennt, wo die Dienststabilität überprüft werden soll, und variiert je nach Anbieter. Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry-Konfigurationen nennen stattdessen die Dienststatus-Seite dieses Anbieters anstelle der Anthropic-Statusseite. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.776Der nachfolgende Satz nennt, wo die Dienststabilität überprüft werden soll, und variiert je nach Anbieter. Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry-Konfigurationen nennen stattdessen die Dienststatus-Seite dieses Anbieters anstelle der Anthropic-Statusseite. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.

735 777

778Wenn ein Proxy, Load Balancer oder Gateway zwischen Claude Code und der API mit seiner eigenen HTML-429-Seite antwortet, ist der Text nach dem `·` der Titel dieser Seite, wenn sie einen hat, wie z. B. `Too Many Requests`. Vor v2.1.281 wurde das gesamte Markup der Seite nach dem `·` gedruckt.

779

736**Was zu tun ist:**780**Was zu tun ist:**

737 781

738* Führen Sie `/status` aus und bestätigen Sie, dass die aktive Anmeldedaten die sind, die Sie erwarten. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen durch einen Low-Tier-Schlüssel statt durch Ihr Abonnement leiten.782* Führen Sie `/status` aus und bestätigen Sie, dass die aktive Anmeldedaten die sind, die Sie erwarten. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen durch einen Low-Tier-Schlüssel statt durch Ihr Abonnement leiten.

839Not logged in · Please run /login883Not logged in · Please run /login

840```884```

841 885

886In einer Sitzung, die die Claude Desktop-App ausführt, z. B. auf der Registerkarte „Code" oder in Cowork, lautet die Meldung `Authentication required · Sign in again to continue`, und Sie melden sich erneut über die App an.

887

842**Was zu tun ist:**888**Was zu tun ist:**

843 889

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

845* Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, bestätigen Sie, dass `ANTHROPIC_API_KEY` in der Shell gesetzt und exportiert ist, in der Sie `claude` gestartet haben891* Wenn Sie erwartet haben, dass eine Umgebungsvariable Sie authentifiziert, bestätigen Sie, dass `ANTHROPIC_API_KEY` in der Shell, in der Sie `claude` gestartet haben, gesetzt und exportiert ist

846* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft892* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft

847* Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind893* Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

848 894

849Wenn Sie wiederholt aufgefordert werden, sich anzumelden, siehe [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr-Überprüfungen und macOS-Wiederherstellungsschritte für die Anmeldedatenspeicherung.895Wenn Sie wiederholt aufgefordert werden, sich anzumelden, siehe [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr-Überprüfungen und macOS-Wiederherstellungsschritte für die Anmeldedatenverwaltung.

850 896

851<h3 id="could-not-resolve-authentication-method">897<h3 id="could-not-resolve-authentication-method">

852 Authentifizierungsmethode konnte nicht aufgelöst werden898 Authentifizierungsmethode konnte nicht aufgelöst werden

858Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted904Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

859```905```

860 906

861In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten verfügbar waren. Vor v2.1.174 konnte eine Hintergrundsitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Vor v2.1.176 konnte auch eine Cloud-Sitzung, die untätig war, bevor sie beansprucht wurde, dies tun. Führen Sie ein Upgrade durch, um dies zu beheben.907In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten zur Verfügung standen. Vor v2.1.174 konnte eine Hintergrundsitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Vor v2.1.176 konnte auch eine Cloud-Sitzung, die untätig war, bevor sie beansprucht wurde, fehlschlagen. Führen Sie ein Upgrade durch, um dies zu beheben.

862 908

863**Was zu tun ist:**909**Was zu tun ist:**

864 910

877Invalid API key · Fix external API key923Invalid API key · Fix external API key

878```924```

879 925

880Wenn die Meldung nach `Fix external API key` mit einer Beschreibung wie `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).` fortgesetzt wird, hat die API den Schlüssel nie gesehen. Claude Code hat ein Zeichen gefunden, das HTTP-Header nicht tragen können, und die Anfrage gestoppt, bevor sie gesendet wurde. Siehe [Ungültiger Request-Header-Wert](#invalid-request-header-value), um zu erfahren, wie Sie die Beschreibung lesen und den Wert korrigieren.926Wenn die Meldung nach `Fix external API key` mit einer Beschreibung wie `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).` fortgesetzt wird, hat die API den Schlüssel nie gesehen. Claude Code hat ein Zeichen gefunden, das HTTP-Header nicht tragen können, und die Anfrage gestoppt, bevor sie gesendet wurde. Siehe [Ungültiger Anforderungs-Header-Wert](#invalid-request-header-value), um zu erfahren, wie Sie die Beschreibung lesen und den Wert korrigieren.

881 927

882**Was zu tun ist:**928**Was zu tun ist:**

883 929

901Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output947Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

902```948```

903 949

904In [nicht-interaktivem Modus](/docs/de/headless) trägt stderr auch den spezifischen Grund, mit dem Präfix `apiKeyHelper failed:`.950Im [nicht-interaktiven Modus](/docs/de/headless) trägt stderr auch den spezifischen Grund, mit dem Präfix `apiKeyHelper failed:`.

905 951

906Claude Code führt das Skript erneut aus und versucht die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, sodass der Fehler innerhalb von drei Versuchen auftritt. Vor v2.1.208 hat Claude Code das gesamte [Wiederholungsbudget](#automatic-retries) aufgewendet, um die Anfrage mit der Platzhalter-Anmeldedaten erneut zu senden, und dann einen generischen `401`-Authentifizierungsfehler statt des Skriptfehlers gemeldet.952Claude Code führt das Skript erneut aus und versucht die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, sodass der Fehler innerhalb von drei Versuchen auftaucht. Vor v2.1.208 hat Claude Code das vollständige [Wiederholungsbudget](#automatic-retries) aufgewendet, um die Anfrage mit der Platzhalter-Anmeldedaten erneut zu senden, und dann einen generischen `401`-Authentifizierungsfehler statt des Skriptfehlers gemeldet.

907 953

908Das Ausführen von `/login` hilft hier nicht: die Ausgabe des Helpers [hat Vorrang](/docs/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.954Das Ausführen von `/login` hilft hier nicht: die Ausgabe des Helpers [hat Vorrang](/docs/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.

909 955

910**Was zu tun ist:**956**Was zu tun ist:**

911 957

912* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren958* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren

913* Wenn der Befehl von einer abgelaufenen Sitzung berichtet, authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Provider, z. B. indem Sie sich erneut bei Ihrem SSO oder Ihrem Secrets-Tresor anmelden959* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Provider, z. B. durch erneutes Anmelden bei Ihrem SSO oder Ihrem Secrets Vault

914* Korrigieren Sie den Befehl so, dass er nur den Schlüssel auf stdout ausgibt, als ein einzelnes Token aus druckbarem ASCII bis zu 16.384 Zeichen, und mit Code 0 beendet wird. Siehe [Anmeldedaten mit apiKeyHelper rotieren](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) für eine funktionierende Einrichtung.960* Korrigieren Sie den Befehl so, dass er nur den Schlüssel auf stdout ausgibt, als ein einzelnes Token aus druckbarem ASCII bis zu 16.384 Zeichen, und mit Code 0 beendet wird. Siehe [Anmeldedaten mit apiKeyHelper rotieren](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) für eine funktionierende Einrichtung.

915* Führen Sie `/status` aus, um zu bestätigen, dass `apiKeyHelper` die aktive Anmeldedatenquelle ist. Die `apiKeyHelper`-Zeile zeigt `Failing` mit dem Detail des letzten Fehlers, z. B. dem Exit-Code und der Fehlerausgabe des Befehls, und verschwindet nach der nächsten erfolgreichen Ausführung. Vor v2.1.274 zeigte `/status` nur die Anmeldedatenquelle, nicht den Fehler.961* Führen Sie `/status` aus, um den Fehler zu sehen und zu bestätigen, dass `apiKeyHelper` die aktive Anmeldedatenquelle ist. Die `apiKeyHelper`-Zeile zeigt `Failing` mit dem Detail des letzten Fehlers, z. B. dem Exit-Code und der Fehlerausgabe des Befehls, und verschwindet nach der nächsten erfolgreichen Ausführung. Vor v2.1.274 zeigte `/status` nur die Anmeldedatenquelle, nicht den Fehler.

916* Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und die Fehlerausgabe auch in einem `Authentication`-Panel im Terminal. Vor v2.1.212 war das Panel mit `Cloud authentication` betitelt.962* Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und seine Fehlerausgabe auch in einem `Authentication`-Panel im Terminal. Vor v2.1.212 war das Panel mit `Cloud authentication` betitelt.

917 963

918<h3 id="invalid-request-header-value">964<h3 id="invalid-request-header-value">

919 Ungültiger Request-Header-Wert965 Ungültiger Anforderungs-Header-Wert

920</h3>966</h3>

921 967

922Ein Wert, den Claude Code als Request-Header senden wollte, enthält ein Zeichen, das HTTP-Header nicht tragen können: einen Zeilenumbruch, ein NUL-Byte oder ein Zeichen über `U+00FF`, z. B. ein gekrümmtes Anführungszeichen oder ein Leerzeichen mit Nullbreite. Claude Code stoppt die Anfrage, bevor etwas gesendet wird, und benennt die Variable oder Einstellung, die korrigiert werden muss. Die übliche Ursache ist eine Anmeldedaten, die aus einem Dokument oder Chat eingefügt wurde und ein unsichtbares Zeichen oder einen verirrten Zeilenumbruch trug.968Ein Wert, den Claude Code als Anforderungs-Header senden wollte, enthält ein Zeichen, das HTTP-Header nicht tragen können: einen Zeilenumbruch, ein NUL-Byte oder ein Zeichen über `U+00FF`, z. B. ein gekrümmtes Anführungszeichen oder ein Leerzeichen mit Nullbreite. Claude Code stoppt die Anfrage, bevor etwas gesendet wird, und benennt die Variable oder Einstellung, die korrigiert werden muss. Die übliche Ursache ist eine Anmeldedaten, die aus einem Dokument oder Chat eingefügt wurde und ein unsichtbares Zeichen oder einen Zeilenumbruch trug.

923 969

924Claude Code führt diese Überprüfung durch, wenn es Anfragen direkt an die Claude API oder durch ein [LLM-Gateway](/docs/de/llm-gateway) sendet. Bei einem Drittanbieter-Cloud-Provider wie [Amazon Bedrock](/docs/de/amazon-bedrock) führt Claude Code dies nicht vor dem Senden durch.970Claude Code führt diese Überprüfung durch, wenn es Anfragen direkt an die Claude API oder durch ein [LLM-Gateway](/docs/de/llm-gateway) sendet. Bei einem Cloud-Provider eines Drittanbieters wie [Amazon Bedrock](/docs/de/amazon-bedrock) führt Claude Code dies nicht vor dem Senden durch.

925 971

926```text theme={null}972```text theme={null}

927Invalid auth token · Fix external auth token973Invalid auth token · Fix external auth token

933 979

934* `Invalid auth token`: ein Bearer-Token von [`ANTHROPIC_AUTH_TOKEN`](/docs/de/env-vars) oder [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars)980* `Invalid auth token`: ein Bearer-Token von [`ANTHROPIC_AUTH_TOKEN`](/docs/de/env-vars) oder [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars)

935* `Invalid ANTHROPIC_CUSTOM_HEADERS`: ein Header-Name oder -Wert, den Sie in [`ANTHROPIC_CUSTOM_HEADERS`](/docs/de/env-vars) gesetzt haben. Die Beschreibung zählt, welches `Name: Value`-Paar fehlerhaft ist, z. B. `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, ohne den Namen oder Wert zu wiederholen, da Sie beide gewählt haben.981* `Invalid ANTHROPIC_CUSTOM_HEADERS`: ein Header-Name oder -Wert, den Sie in [`ANTHROPIC_CUSTOM_HEADERS`](/docs/de/env-vars) gesetzt haben. Die Beschreibung zählt, welches `Name: Value`-Paar fehlerhaft ist, z. B. `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, ohne den Namen oder Wert zu wiederholen, da Sie beide gewählt haben.

936* `Invalid request header from the environment`: ein Wert, den Claude Code aus einer anderen Umgebungsvariable in einen Request-Header kopiert, z. B. `CLAUDE_AGENT_SDK_CLIENT_APP`. Die Beschreibung benennt die Variable, die korrigiert werden muss.982* `Invalid request header from the environment`: ein Wert, den Claude Code aus einer anderen Umgebungsvariable in einen Anforderungs-Header kopiert, z. B. `CLAUDE_AGENT_SDK_CLIENT_APP`. Die Beschreibung benennt die Variable, die korrigiert werden muss.

937 983

938Claude Code meldet einen fehlerhaften `ANTHROPIC_API_KEY`, der von dieser Überprüfung erfasst wird, als [Ungültiger API-Schlüssel](#invalid-api-key), mit derselben nachfolgenden Beschreibung. Es meldet eine fehlerhafte gespeicherte `/login`-Anmeldedaten als [Nicht angemeldet](#not-logged-in) statt; führen Sie `/login` aus, um eine neue zu speichern. Die Ausgabe eines [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skripts erreicht diese Überprüfung nie: Claude Code validiert sie, wenn das Skript ausgeführt wird, und die Ausgabe, die ein HTTP-Header nicht tragen kann, schlägt mit [Ihr apiKeyHelper-Skript schlägt fehl](#your-apikeyhelper-script-is-failing) fehl.984Claude Code meldet einen fehlerhaften `ANTHROPIC_API_KEY`, der von dieser Überprüfung erfasst wird, als [Ungültiger API-Schlüssel](#invalid-api-key), mit derselben nachfolgenden Beschreibung. Es meldet eine fehlerhafte gespeicherte `/login`-Anmeldedaten als [Nicht angemeldet](#not-logged-in) statt; führen Sie `/login` aus, um eine neue zu speichern. Die Ausgabe eines [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skripts erreicht diese Überprüfung nie: Claude Code validiert sie, wenn das Skript ausgeführt wird, und die Ausgabe, die ein HTTP-Header nicht tragen kann, schlägt mit [Ihr apiKeyHelper-Skript schlägt fehl](#your-apikeyhelper-script-is-failing) fehl.

939 985

947 993

948**Was zu tun ist:**994**Was zu tun ist:**

949 995

950* Setzen Sie die Variable oder Einstellung, die die Meldung benennt, neu, indem Sie die Zeichen um die gemeldete Position neu eingeben, anstatt aus derselben Quelle erneut einzufügen996* Setzen Sie die Variable oder Einstellung, die die Meldung benennt, neu, indem Sie die Zeichen um die gemeldete Position neu eingeben, anstatt sie aus derselben Quelle erneut einzufügen

951* Für `ANTHROPIC_CUSTOM_HEADERS` behalten Sie ein `Name: Value`-Paar pro Zeile und schreiben Sie das Paar neu, das die Meldung zählt997* Für `ANTHROPIC_CUSTOM_HEADERS` behalten Sie ein `Name: Value`-Paar pro Zeile und schreiben Sie das Paar neu, das die Meldung zählt

952* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle aktiv ist998* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle aktiv ist

953 999

969 1015

970**Was zu tun ist:**1016**Was zu tun ist:**

971 1017

972* Heben Sie `ANTHROPIC_API_KEY` in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil, dann starten Sie `claude` neu1018* Heben Sie `ANTHROPIC_API_KEY` in der aktuellen Shell auf und entfernen Sie ihn aus Ihrem Shell-Profil, dann starten Sie `claude` neu

973* Wenn die Meldung `Update or unset` sagt, haben Sie keine gespeicherte Anmeldung, auf die Sie zurückgreifen können. Heben Sie den Schlüssel auf und führen Sie `/login` aus, oder ersetzen Sie den Schlüssel durch einen von einer aktiven Console-Organisation.1019* Wenn die Meldung `Update or unset` sagt, haben Sie keine gespeicherte Anmeldung, auf die Sie zurückgreifen können. Heben Sie den Schlüssel auf und führen Sie `/login` aus, oder ersetzen Sie den Schlüssel durch einen von einer aktiven Console-Organisation.

974* Führen Sie `/status` danach aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement ist1020* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement ist

975* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin besteht, ist die deaktivierte Organisation diejenige, die an Ihre `/login` gebunden ist. Kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.1021* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin besteht, kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.

976 1022

977<h3 id="your-organization-has-disabled-api-key-authentication">1023<h3 id="your-organization-has-disabled-api-key-authentication">

978 Ihre Organisation hat die API-Schlüssel-Authentifizierung deaktiviert1024 Ihre Organisation hat die API-Schlüssel-Authentifizierung deaktiviert

985Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead1031Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead

986Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account1032Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account

987Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account1033Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

1034Your organization has disabled API key authentication · Sign in again with your claude.ai account

988```1035```

989 1036

1037Die letzte Form erscheint in einer Sitzung, die die Claude Desktop-App ausführt, z. B. die Registerkarte „Code" oder Cowork, wo Sie sich erneut über die App anmelden.

1038

990Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, sodass das alleinige Ausführen von `/login` nicht hilft, während einer von ihnen noch einen Schlüssel liefert. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence).1039Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, sodass das alleinige Ausführen von `/login` nicht hilft, während einer von ihnen noch einen Schlüssel liefert. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence).

991 1040

992**Was zu tun ist:**1041**Was zu tun ist:**

994* Wenn die Meldung `ANTHROPIC_API_KEY` benennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder `.env`-Datei, dann starten Sie `claude` neu1043* Wenn die Meldung `ANTHROPIC_API_KEY` benennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder `.env`-Datei, dann starten Sie `claude` neu

995* Wenn die Meldung `apiKeyHelper` benennt, entfernen Sie die [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Einstellung aus Ihrer `settings.json`1044* Wenn die Meldung `apiKeyHelper` benennt, entfernen Sie die [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Einstellung aus Ihrer `settings.json`

996* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden1045* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden

997* Führen Sie `/status` danach aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement ist, nicht ein API-Schlüssel1046* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement statt eines API-Schlüssels ist

998* Wenn Sie die API-Schlüssel-Authentifizierung für Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren1047* Wenn Sie die API-Schlüssel-Authentifizierung für die Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren

999 1048

1000<h3 id="your-organization-has-disabled-claude-subscription-access">1049<h3 id="your-organization-has-disabled-claude-subscription-access">

1001 Ihre Organisation hat den Claude-Abonnement-Zugriff deaktiviert1050 Ihre Organisation hat den Claude-Abonnement-Zugriff deaktiviert

1007Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1056Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

1008```1057```

1009 1058

1010Dies ist eine serverseitige Organisations-Einstellung, sodass sie nicht von lokalen Einstellungen, Umgebungsvariablen oder CLI-Flags außer Kraft gesetzt werden kann.1059Dies ist eine serverseitige Organisations-Einstellung, sodass sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden kann.

1011 1060

1012Das Agent SDK und der `-p` nicht-interaktive Modus zeigen dies als den `oauth_org_not_allowed`-Fehlercode.1061Das Agent SDK und der `-p`-nicht-interaktive Modus zeigen dies als den Fehlercode `oauth_org_not_allowed`.

1013 1062

1014**Was zu tun ist:**1063**Was zu tun ist:**

1015 1064

1021 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert1070 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert

1022</h3>1071</h3>

1023 1072

1024Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisations-Ebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, z. B. aus der [Routinen](/docs/de/routines)-Benutzeroberfläche auf claude.ai/code. In Claude Code v2.1.227 oder später [verbirgt die gleiche Einstellung auch `/schedule`](/docs/de/routines#troubleshooting) in der CLI.1073Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisations-Ebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, z. B. über die [Routinen](/docs/de/routines)-Benutzeroberfläche auf claude.ai/code. Auf Claude Code v2.1.227 oder später [verbirgt die gleiche Einstellung auch `/schedule`](/docs/de/routines#troubleshooting) in der CLI.

1025 1074

1026```text theme={null}1075```text theme={null}

1027Routines are disabled by your organization's policy.1076Routines are disabled by your organization's policy.

1028```1077```

1029 1078

1030Dies ist eine serverseitige Einstellung, sodass sie nicht von lokalen Einstellungen, Umgebungsvariablen oder CLI-Flags außer Kraft gesetzt werden kann.1079Dies ist eine serverseitige Einstellung, sodass sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden kann.

1031 1080

1032**Was zu tun ist:**1081**Was zu tun ist:**

1033 1082

1034* Bitten Sie einen Eigentümer in Ihrer Organisation, den **Routinen**-Schalter unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren1083* Bitten Sie einen Eigentümer in Ihrer Organisation, den **Routines**-Schalter unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren

1035* Für einmalige geplante Arbeiten, die keine Organisations-Routinen erfordern, siehe [geplante Aufgaben](/docs/de/scheduled-tasks)1084* Für einmalige geplante Arbeiten, die keine Organisations-Ebenen-Routinen erfordern, siehe [geplante Aufgaben](/docs/de/scheduled-tasks)

1036 1085

1037<h3 id="remote-control-requires-the-anthropic-api">1086<h3 id="remote-control-requires-the-anthropic-api">

1038 Remote Control erfordert die Anthropic API1087 Remote Control erfordert die Anthropic API

1039</h3>1088</h3>

1040 1089

1041Die Sitzung spricht nicht direkt mit der Anthropic API, sodass es kein claude.ai-Backend für [Remote Control](/docs/de/remote-control) gibt, mit dem es sich verbinden kann.1090Die Sitzung spricht nicht direkt mit der Anthropic API, was [Remote Control](/docs/de/remote-control) erfordert.

1042 1091

1043```text theme={null}1092```text theme={null}

1044Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1093Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

1047Ein zweiter Satz erklärt, was die Sitzung von der Anthropic API weg geleitet hat; vor v2.1.219 war die Meldung nur der erste Satz. Je nach Ursache benennt die Meldung:1096Ein zweiter Satz erklärt, was die Sitzung von der Anthropic API weg geleitet hat; vor v2.1.219 war die Meldung nur der erste Satz. Je nach Ursache benennt die Meldung:

1048 1097

1049* Eine `CLAUDE_CODE_USE_*`-Provider-Variable, z. B. `CLAUDE_CODE_USE_BEDROCK` für [Amazon Bedrock](/docs/de/amazon-bedrock) oder `CLAUDE_CODE_USE_VERTEX` für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)1098* Eine `CLAUDE_CODE_USE_*`-Provider-Variable, z. B. `CLAUDE_CODE_USE_BEDROCK` für [Amazon Bedrock](/docs/de/amazon-bedrock) oder `CLAUDE_CODE_USE_VERTEX` für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)

1050* [`ANTHROPIC_BASE_URL`](/docs/de/env-vars), die auf einen anderen Host als `api.anthropic.com` zeigt, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, selbst wenn Sie sich mit claude.ai anmelden; vor v2.1.196 blockierte eine benutzerdefinierte Basis-URL Remote Control nicht1099* [`ANTHROPIC_BASE_URL`](/docs/de/env-vars), das auf einen anderen Host als `api.anthropic.com` zeigt, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, selbst wenn Sie sich mit claude.ai anmelden; vor v2.1.196 blockierte eine benutzerdefinierte Basis-URL Remote Control nicht

1051* `ANTHROPIC_UNIX_SOCKET` gesetzt, sodass die Sitzung ihre Anfragen durch einen lokalen Socket statt an `api.anthropic.com` sendet1100* `ANTHROPIC_UNIX_SOCKET` gesetzt, sodass die Sitzung ihre Anfragen durch einen lokalen Socket statt an `api.anthropic.com` sendet

1052* Eine Enterprise-[Cloud-Gateway](/docs/de/claude-apps-gateway)-Anmeldung, die durch `/login` erfolgt ist, die Remote Control nicht unterstützt und keine Variable zum Aufheben hat1101* Eine Enterprise-[Cloud-Gateway](/docs/de/claude-apps-gateway)-Anmeldung, die über `/login` erfolgt ist, die Remote Control nicht unterstützt und keine Variable zum Aufheben hat

1053 1102

1054**Was zu tun ist:**1103**Was zu tun ist:**

1055 1104

1056* Heben Sie die Variable auf, die die Meldung benennt, z. B. `CLAUDE_CODE_USE_BEDROCK` oder `ANTHROPIC_BASE_URL`, und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung, die direkt mit der Anthropic API spricht1105* Heben Sie die Variable auf, die die Meldung benennt, z. B. `CLAUDE_CODE_USE_BEDROCK` oder `ANTHROPIC_BASE_URL`, und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht

1057* Wenn die Variable nicht in Ihrer Shell gesetzt ist, überprüfen Sie den `env`-Schlüssel in Ihren [Einstellungsdateien](/docs/de/settings#where-settings-live), die Umgebungsvariablen auf jede Sitzung anwenden1106* Wenn die Variable nicht in Ihrer Shell gesetzt ist, überprüfen Sie den `env`-Schlüssel in Ihren [Einstellungsdateien](/docs/de/settings#where-settings-live), die Umgebungsvariablen auf jede Sitzung anwenden

1058* Für diese und die anderen Remote Control-Startup-Meldungen siehe [Remote Control beheben](/docs/de/remote-control#troubleshooting)1107* Für diese und die anderen Remote Control-Startup-Meldungen siehe [Remote Control beheben](/docs/de/remote-control#troubleshooting)

1059 1108

1061 Remote Control konnte Ihre Anmeldung nicht aktualisieren1110 Remote Control konnte Ihre Anmeldung nicht aktualisieren

1062</h3>1111</h3>

1063 1112

1064Claude Code führt eine Live-[Remote Control](/docs/de/remote-control)-Verbindung auf kurzlebigen Anmeldedaten aus, die es mit Ihrer gespeicherten claude.ai-Anmeldung erhält und erneuert. Wenn claude.ai diese Anmeldung nicht mehr akzeptiert oder Claude Code keine gespeicherte Anmeldung mehr hat, stoppt Claude Code Remote Control und benötigt Sie, sich erneut anzumelden. Jeder Fehler kann auftreten, während Claude Code noch verbunden wird, oder später, wenn es die Anmeldedaten erneuert.1113Claude Code führt eine Live-[Remote Control](/docs/de/remote-control)-Verbindung auf kurzlebigen Anmeldedaten aus, die es mit Ihrer gespeicherten claude.ai-Anmeldung erhält und erneuert. Wenn claude.ai diese Anmeldung nicht mehr akzeptiert oder Claude Code keine gespeicherte Anmeldung mehr hat, stoppt Claude Code Remote Control und benötigt Sie, um sich erneut anzumelden. Jeder Fehler kann auftreten, während Claude Code noch verbunden wird, oder später, wenn es die Anmeldedaten erneuert.

1065 1114

1066Wenn Claude Code den Anmeldedienst auffordert, Ihre gespeicherte Anmeldung zu aktualisieren, und keine Antwort erhält, hält es Remote Control am Laufen und versucht die Aktualisierung erneut, während die Anmeldedaten der Verbindung noch gültig sind. Eine Aktualisierung erhält keine Antwort, wenn Claude Code den Anmeldedienst nicht erreichen kann, die Anfrage das Zeitlimit überschreitet oder der Dienst fehlschlägt, ohne Ihre Anmeldung abzulehnen. Wenn der Anmeldedienst immer noch nicht antwortet, wenn diese Anmeldedaten ablaufen, stoppt Claude Code Remote Control und meldet `OAuth token refresh failed`.1115Wenn Claude Code den Login-Service auffordert, Ihre gespeicherte Anmeldung zu aktualisieren, und keine Antwort erhält, behält es Remote Control am Laufen und versucht die Aktualisierung erneut, während die Anmeldedaten der Verbindung noch gültig sind. Eine Aktualisierung erhält keine Antwort, wenn Claude Code den Login-Service nicht erreichen kann, die Anfrage das Zeitlimit überschreitet oder der Service fehlschlägt, ohne Ihre Anmeldung abzulehnen. Wenn der Login-Service immer noch nicht antwortet, wenn diese Anmeldedaten ablaufen, stoppt Claude Code Remote Control und meldet `OAuth token refresh failed`.

1067 1116

1068Wenn Claude Code Remote Control stoppt, zeigt es den Grund in einer Warnung und in einer Transkriptzeile an, die mit `Remote Control disconnected` beginnt. Ihre lokale Sitzung läuft ohne Remote Control weiter. Dieser Abschnitt behandelt diese Zeilen:1117Wenn Claude Code Remote Control stoppt, zeigt es den Grund in einer Warnung und in einer Transkriptzeile an, die mit `Remote Control disconnected` beginnt. Ihre lokale Sitzung läuft ohne Remote Control weiter. Dieser Abschnitt behandelt diese Zeilen:

1069 1118

1079 1128

1080Claude Code benennt die Ursache in der Mitte der Meldung:1129Claude Code benennt die Ursache in der Mitte der Meldung:

1081 1130

1082* `Claude.ai login expired` und `Claude.ai login was rejected`: claude.ai akzeptiert Ihr gespeichertes Anmelde-Token nicht mehr, weil es abgelaufen oder widerrufen wurde1131* `Claude.ai login expired` und `Claude.ai login was rejected`: claude.ai akzeptiert Ihren gespeicherten Login-Token nicht mehr, weil er abgelaufen oder widerrufen wurde

1083* `OAuth token unavailable`: Claude Code hatte kein gespeichertes Anmelde-Token, als die Anmeldedaten der Verbindung zur Erneuerung fällig wurden1132* `OAuth token unavailable`: Claude Code hatte keinen gespeicherten Login-Token, als die Anmeldedaten der Verbindung zur Erneuerung fällig wurden

1084* `OAuth token refresh failed`: claude.ai lehnte Ihr gespeichertes Anmelde-Token ab, während Claude Code sich erneut verbunden hat, und das Aktualisieren des Tokens hat kein neues produziert1133* `OAuth token refresh failed`: claude.ai lehnte Ihren gespeicherten Login-Token ab, während Claude Code sich erneut verbunden hat, und das Aktualisieren des Tokens hat keinen neuen erzeugt

1085* `JWT refresh failed: no OAuth token`: Claude Code hat kein gespeichertes Anmelde-Token zum Erneuern gefunden1134* `JWT refresh failed: no OAuth token`: Claude Code hat keinen gespeicherten Login-Token zum Erneuern gefunden

1086* `Signed out of Claude`: Sie haben sich auf diesem Computer abgemeldet, z. B. durch Ausführung von `/logout` in einem anderen Terminal, sodass Claude Code keine gespeicherte Anmeldung mehr hat, um die Verbindung mit zu erneuern1135* `Signed out of Claude`: Sie haben sich auf dieser Maschine abgemeldet, z. B. durch Ausführung von `/logout` in einem anderen Terminal, sodass Claude Code keine gespeicherte Anmeldung mehr hat, um die Verbindung zu erneuern

1087 1136

1088**Was zu tun ist:**1137**Was zu tun ist:**

1089 1138

1092 1141

1093Vor v2.1.224 las `OAuth token refresh failed — run /login to re-authenticate` `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, und `JWT refresh failed: no OAuth token — run /login` las `no OAuth token available for recovery (code <N>)`. Die Meldungen `Claude.ai login expired`, `Claude.ai login was rejected` und `OAuth token unavailable` wurden in v2.1.225 hinzugefügt.1142Vor v2.1.224 las `OAuth token refresh failed — run /login to re-authenticate` `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, und `JWT refresh failed: no OAuth token — run /login` las `no OAuth token available for recovery (code <N>)`. Die Meldungen `Claude.ai login expired`, `Claude.ai login was rejected` und `OAuth token unavailable` wurden in v2.1.225 hinzugefügt.

1094 1143

1095Vor v2.1.238 meldete Claude Code die Fälle, die jetzt `Signed out of Claude` sagen, als `JWT refresh failed: no OAuth token — run /login`, und stoppt Remote Control mit `Claude.ai login expired — run /login to restore Remote Control`, sobald eine Anmelde-Aktualisierung keine Antwort erhielt.1144Vor v2.1.238 meldete Claude Code die Fälle, die jetzt `Signed out of Claude` sagen, als `JWT refresh failed: no OAuth token — run /login`, und stoppt Remote Control mit `Claude.ai login expired — run /login to restore Remote Control`, sobald eine Login-Aktualisierung keine Antwort erhielt.

1096 1145

1097<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1146<h3 id="remote-control-stopped-because-the-signed-in-account-changed">

1098 Remote Control wurde gestoppt, weil sich das angemeldete Konto geändert hat1147 Remote Control wurde gestoppt, weil sich das angemeldete Konto geändert hat

1099</h3>1148</h3>

1100 1149

1101Claude Code zeigt diese Zeile während einer [Remote Control](/docs/de/remote-control)-Sitzung an, wenn Sie sich auf diesem Computer bei einem anderen claude.ai-Konto oder einer anderen Organisation anmelden. Sie haben den Wechsel außerhalb der Claude Code-Sitzung vorgenommen, z. B. durch Ausführung von `/login` in einem anderen Terminal.1150Claude Code zeigt diese Zeile während einer [Remote Control](/docs/de/remote-control)-Sitzung an, wenn Sie sich auf dieser Maschine bei einem anderen claude.ai-Konto oder einer anderen Organisation anmelden. Sie haben den Wechsel außerhalb der Claude Code-Sitzung vorgenommen, z. B. durch Ausführung von `/login` in einem anderen Terminal.

1102 1151

1103Eine Remote Control-Sitzung, die Sie gestartet haben, während Sie sich durch `/login` angemeldet haben, gehört zum claude.ai-Konto und zur Organisation, die zum Zeitpunkt des Starts angemeldet waren.1152Eine Remote Control-Sitzung, die Sie gestartet haben, während Sie über `/login` angemeldet waren, gehört zum claude.ai-Konto und zur Organisation, die zum Zeitpunkt des Starts angemeldet waren.

1104 1153

1105```text theme={null}1154```text theme={null}

1106Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1155Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

1111**Was zu tun ist:**1160**Was zu tun ist:**

1112 1161

1113* Führen Sie `/remote-control` aus, um eine neue Remote Control-Sitzung unter dem aktuellen Konto oder der aktuellen Organisation zu starten1162* Führen Sie `/remote-control` aus, um eine neue Remote Control-Sitzung unter dem aktuellen Konto oder der aktuellen Organisation zu starten

1114* Um zurückzuwechseln, führen Sie `/login` aus und melden Sie sich erneut bei dem vorherigen Konto oder der vorherigen Organisation an. Führen Sie dann `/remote-control` aus.1163* Um zurückzuwechseln, führen Sie `/login` aus und melden Sie sich erneut bei dem vorherigen Konto oder der vorherigen Organisation an. Dann führen Sie `/remote-control` aus.

1115 1164

1116Vor v2.1.234 bemerkte Claude Code nicht, wenn Sie außerhalb der Claude Code-Sitzung zu einem anderen Konto oder einer anderen Organisation wechselten. Claude Code hielt die Remote Control-Sitzung verbunden, bis eine spätere Anfrage an den Remote Control-Server mit `Remote Control server rejected the request (HTTP 404)` fehlschlug. Dieser Fehler konnte Stunden nach dem Wechsel auftreten.1165Vor v2.1.234 bemerkte Claude Code nicht, wenn Sie sich außerhalb der Claude Code-Sitzung bei einem anderen Konto oder einer anderen Organisation anmeldeten. Claude Code behielt die Remote Control-Sitzung verbunden, bis eine spätere Anfrage an den Remote Control-Server mit `Remote Control server rejected the request (HTTP 404)` fehlschlug. Dieser Fehler konnte Stunden nach dem Wechsel auftreten.

1117 1166

1118<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1167<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">

1119 Remote Control wurde gestoppt, weil sich die App, die die Sitzung ausführt, abgemeldet oder Konten gewechselt hat1168 Remote Control wurde gestoppt, weil sich die App, die die Sitzung ausführt, abgemeldet oder Konten gewechselt hat

1120</h3>1169</h3>

1121 1170

1122Wenn die Claude-Desktop-App oder eine IDE Ihre Sitzung hostet, erhält Claude Code sein Anmelde-Token von dieser App statt von `/login`. Wenn claude.ai dieses Token ablehnt, fordert Claude Code die App auf, ein neues zu erhalten. Wenn die App antwortet, dass sie abgemeldet ist, oder dass sie jetzt bei einem anderen Claude-Konto angemeldet ist, beendet Claude Code die [Remote Control](/docs/de/remote-control)-Sitzung und sendet der App eine dieser Zeilen:1171Wenn die Claude Desktop-App oder eine IDE Ihre Sitzung hostet, erhält Claude Code seinen Login-Token von dieser App statt von `/login`. Wenn claude.ai diesen Token ablehnt, fragt Claude Code die App nach einem neuen. Wenn die App antwortet, dass sie abgemeldet ist, oder dass sie jetzt bei einem anderen Claude-Konto angemeldet ist, beendet Claude Code die [Remote Control](/docs/de/remote-control)-Sitzung und sendet der App eine dieser Zeilen:

1123 1172

1124```text theme={null}1173```text theme={null}

1125Remote Control stopped — the app running this session is now signed in to a different Claude account1174Remote Control stopped — the app running this session is now signed in to a different Claude account

1130 1179

1131**Was zu tun ist:**1180**Was zu tun ist:**

1132 1181

1133* Wenn die App abgemeldet ist, melden Sie sich erneut an und schalten Sie Remote Control dann wieder ein1182* Wenn die App abgemeldet ist, melden Sie sich erneut an und schalten Sie Remote Control in der App wieder ein

1134* Wenn die App Konten gewechselt hat, kann Claude Code die beendete Sitzung nicht unter dem neuen Konto fortsetzen. Starten Sie eine neue Remote Control-Sitzung unter diesem Konto.1183* Wenn die App Konten gewechselt hat, kann Claude Code die beendete Sitzung unter dem neuen Konto nicht fortsetzen. Starten Sie eine neue Remote Control-Sitzung unter diesem Konto.

1135 1184

1136Vor v2.1.238 sendete Claude Code der App die unter [Remote Control konnte Ihre Anmeldung nicht aktualisieren](#remote-control-couldnt-refresh-your-login) aufgelisteten `run /login`-Meldungen in beiden Fällen.1185Vor v2.1.238 sendete Claude Code der App die unter [Remote Control konnte Ihre Anmeldung nicht aktualisieren](#remote-control-couldnt-refresh-your-login) aufgelisteten `run /login`-Meldungen in beiden Fällen.

1137 1186

1139 OAuth-Token widerrufen oder abgelaufen1188 OAuth-Token widerrufen oder abgelaufen

1140</h3>1189</h3>

1141 1190

1142Ihre gespeicherte Anmeldung ist nicht mehr gültig. Ein widerrufenes Token bedeutet, dass Sie sich überall abgemeldet haben oder ein Administrator den Zugriff entfernt hat; ein abgelaufenes Token bedeutet, dass die automatische Aktualisierung während der Sitzung fehlgeschlagen ist.1191Ihre gespeicherte Anmeldung ist nicht mehr gültig. Ein widerrufener Token bedeutet, dass Sie sich überall abgemeldet haben oder ein Administrator den Zugriff entfernt hat; ein abgelaufener Token bedeutet, dass die automatische Aktualisierung während der Sitzung fehlgeschlagen ist.

1143 1192

1144Beide Meldungen melden eine Ablehnung, die die API für eine Anfrage zurückgegeben hat, die Claude Code gesendet hat. Wenn die gespeicherte Anmeldung bereits nach einer fehlgeschlagenen Aktualisierung gelöscht wurde, sehen Sie stattdessen [Anmeldung abgelaufen](#login-expired). Wenn Sie sich mit einem langlebigen Token in [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) authentifizieren, sehen Sie die gleichen Meldungen, wenn dieses Token abläuft oder widerrufen wird.1193Beide Meldungen melden eine Ablehnung, die die API für eine Anfrage zurückgegeben hat, die Claude Code gesendet hat. Wenn die gespeicherte Anmeldung nach einer fehlgeschlagenen Aktualisierung bereits gelöscht wurde, sehen Sie stattdessen [Anmeldung abgelaufen](#login-expired). Wenn Sie sich mit einem langlebigen Token in [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) authentifizieren, sehen Sie die gleichen Meldungen, wenn dieser Token abläuft oder widerrufen wird.

1145 1194

1146```text theme={null}1195```text theme={null}

1147OAuth token revoked · Please run /login1196OAuth token revoked · Please run /login

1151**Was zu tun ist:**1200**Was zu tun ist:**

1152 1201

1153* Führen Sie `/login` aus, um sich erneut anzumelden1202* Führen Sie `/login` aus, um sich erneut anzumelden

1154* Wenn der Fehler nach der erneuten Authentifizierung in derselben Sitzung zurückkehrt, führen Sie zuerst `/logout` aus, um das gespeicherte Token vollständig zu löschen, dann `/login`1203* Wenn Sie sich mit der Umgebungsvariable `CLAUDE_CODE_OAUTH_TOKEN` authentifizieren, sendet Claude Code weiterhin den Wert, den Sie gesetzt haben, nachdem eine Anfrage mit einem 401 fehlschlägt, anstatt zu einem Token einer gespeicherten Anmeldung zu wechseln. [`/status`](/docs/de/commands) zeigt diese Anmeldedaten als eine `Auth token`-Zeile an, die `CLAUDE_CODE_OAUTH_TOKEN` liest. Generieren Sie einen neuen Token mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) und starten Sie damit neu, oder heben Sie die Variable auf und führen Sie `/login` aus. Vor v2.1.225 konnte Claude Code den Wert der Variablen während der Sitzung durch den kurzlebigen Zugriffs-Token aus einer gespeicherten Anmeldung ersetzen, und die Sitzung schlägt erneut mit 401-Fehlern fehl, sobald dieser Token abläuft.

1155* Wenn Sie sich mit der Umgebungsvariable `CLAUDE_CODE_OAUTH_TOKEN` authentifizieren, sendet Claude Code weiterhin den Wert, den Sie nach einem Anfragefehler mit 401 gesetzt haben, anstatt zu einem gespeicherten Anmelde-Token zu wechseln. [`/status`](/docs/de/commands) zeigt diese Anmeldedaten als eine `Auth token`-Zeile an, die `CLAUDE_CODE_OAUTH_TOKEN` liest. Generieren Sie ein frisches Token mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) und starten Sie damit neu, oder heben Sie die Variable auf und führen Sie `/login` aus. Vor v2.1.225 konnte Claude Code den Wert der Variable während der Sitzung durch das kurzlebige Zugriffs-Token aus einer gespeicherten Anmeldung ersetzen, und die Sitzung schlug mit 401-Fehlern erneut fehl, sobald dieses Token abgelaufen war.1204* Für wiederholte Aufforderungen zum Anmelden über Starts hinweg siehe die Systemuhr-Überprüfungen und macOS-Wiederherstellungsschritte für die Anmeldedatenverwaltung in [Fehlerbehebung](/docs/de/troubleshoot-install#not-logged-in-or-token-expired)

1156* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr-Überprüfungen und macOS-Wiederherstellungsschritte in [Fehlerbehebung](/docs/de/troubleshoot-install#not-logged-in-or-token-expired)

1157* Für andere Fehler, einschließlich `403 Forbidden` und OAuth-Browser-Probleme, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)1205* Für andere Fehler, einschließlich `403 Forbidden` und OAuth-Browser-Probleme, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)

1158 1206

1159<h3 id="api-error-401-invalid-authentication-credentials">1207<h3 id="api-error-401-invalid-authentication-credentials">

1160 API-Fehler: 401 Ungültige Authentifizierungsanmeldedaten1208 API-Fehler: 401 Ungültige Authentifizierungsanmeldedaten

1161</h3>1209</h3>

1162 1210

1163Die API erkannte das Format Ihrer Anmeldedaten, lehnte aber das Konto oder die Organisation dahinter ab. Anthropic gibt diese Meldung zurück, wenn eine Anmeldedaten kürzlich widerrufen wurde, wenn eine Organisation deaktiviert wurde oder Ihren Zugriff entfernt hat, oder wenn das Konto selbst deaktiviert wurde, sodass ein abgelaufenes Token nicht die Ursache ist. Die Anmeldedaten können Ihre gespeicherte Anmeldung oder ein genehmigter `ANTHROPIC_API_KEY` sein, und die Behebung unterscheidet sich, also beginnen Sie mit dem Ausführen von `/status`, um zu sehen, welche aktiv ist.1211Die API erkannte das Format Ihrer Anmeldedaten, lehnte aber das Konto oder die Organisation dahinter ab. Anthropic gibt diese Meldung zurück, wenn eine Anmeldedaten kürzlich widerrufen wurde, wenn eine Organisation deaktiviert wurde oder Ihren Zugriff entfernt hat, oder wenn das Konto selbst deaktiviert wurde, sodass ein abgelaufener Token nicht die Ursache ist. Die Anmeldedaten können Ihre gespeicherte Anmeldung oder ein genehmigter `ANTHROPIC_API_KEY` sein, und die Behebung unterscheidet sich, also beginnen Sie mit dem Ausführen von `/status`, um zu sehen, welche aktiv ist.

1164 1212

1165```text theme={null}1213```text theme={null}

1166Please run /login · API Error: 401 Invalid authentication credentials1214Please run /login · API Error: 401 Invalid authentication credentials

1168 1216

1169**Was zu tun ist:**1217**Was zu tun ist:**

1170 1218

1171* Wenn `/status` eine `API key`-Zeile zeigt, die nicht als nicht in Gebrauch markiert ist, ist ein genehmigter [`ANTHROPIC_API_KEY`](/docs/de/authentication#authentication-precedence) die aktive Anmeldedaten und hat Vorrang vor Ihrer Anmeldung, sodass `/login` ihn nicht ersetzt. Rotieren Sie den Schlüssel in der Claude Console, oder greifen Sie auf Ihr Abonnement zurück, indem Sie `unset ANTHROPIC_API_KEY` ausführen, oder in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.1219* Wenn `/status` eine `API key`-Zeile zeigt, die nicht als nicht in Verwendung markiert ist, ist ein genehmigter [`ANTHROPIC_API_KEY`](/docs/de/authentication#authentication-precedence) die aktive Anmeldedaten und hat Vorrang vor Ihrer Anmeldung, sodass `/login` ihn nicht ersetzt. Rotieren Sie den Schlüssel in der Claude Console, oder greifen Sie auf Ihr Abonnement zurück, indem Sie `unset ANTHROPIC_API_KEY` ausführen, oder in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.

1172* Wenn `/status` nur Ihre Anmeldung zeigt, führen Sie `/login` einmal aus. Wenn die Anmeldedaten widerrufen wurden, ersetzt eine frische Anmeldung sie.1220* Wenn `/status` nur Ihre Anmeldung zeigt, führen Sie `/login` einmal aus. Wenn die Anmeldedaten widerrufen wurden, ersetzt eine neue Anmeldung sie.

1173* Wenn die gleiche Meldung für das gleiche Anmeldekonto zurückkehrt, ist das Konto oder die Organisation nicht mehr aktiv. Überprüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie Ihren Organisations-Administrator, den Zugriff wiederherzustellen.1221* Wenn die gleiche Meldung für das gleiche Anmeldekonto zurückkommt, ist das Konto oder die Organisation nicht mehr aktiv. Überprüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie Ihren Organisations-Administrator, den Zugriff wiederherzustellen.

1174* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) zeigt, ist der Text nach `401` die Meldung Ihres Gateways statt Anthropic's, und `/login` ändert ihn nicht. Korrigieren Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.1222* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) zeigt, ist der Text nach `401` die Meldung Ihres Gateways statt Anthropic's, und `/login` ändert ihn nicht. Beheben Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.

1175 1223

1176<h3 id="login-expired">1224<h3 id="login-expired">

1177 Anmeldung abgelaufen1225 Anmeldung abgelaufen

1178</h3>1226</h3>

1179 1227

1180Claude Code versuchte, Ihre gespeicherte claude.ai- oder Claude Console-Anmeldung zu erneuern, und der OAuth-Dienst lehnte das gespeicherte Aktualisierungs-Token ab, sodass Claude Code die gespeicherten Anmeldedaten gelöscht hat. Danach stoppt jede Modellanfrage lokal mit dieser Meldung, bevor sie die API erreicht, weil nur `/login` neue Anmeldedaten erstellen kann.1228Claude Code versuchte, Ihre gespeicherte claude.ai-Anmeldung zu erneuern, und der OAuth-Service lehnte den gespeicherten Aktualisierungs-Token ab, sodass Claude Code die gespeicherten Anmeldedaten gelöscht hat. Danach stoppt jede Modellanfrage lokal mit dieser Meldung, bevor sie die API erreicht, weil nur `/login` neue Anmeldedaten erstellen kann.

1181 1229

1182Vor v2.1.206 sendete Claude Code die Modellanfrage trotzdem mit allen verbleibenden Anmeldedaten in der Umgebung, und jedes Modell schlug dann mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 statt einer Aufforderung zur Anmeldung fehl.1230Vor v2.1.206 hat Claude Code die Modellanfrage trotzdem mit allen verbleibenden Anmeldedaten in der Umgebung gesendet, und jedes Modell ist dann mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 statt einer Aufforderung zum Anmelden fehlgeschlagen.

1183 1231

1184```text theme={null}1232```text theme={null}

1185Login expired · Please run /login1233Login expired · Please run /login

1186```1234```

1187 1235

1188Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) liest sich die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:1236Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:

1189 1237

1190```text theme={null}1238```text theme={null}

1191Failed to authenticate: OAuth session expired and could not be refreshed1239Failed to authenticate: OAuth session expired and could not be refreshed

1192```1240```

1193 1241

1194Dies ist nicht der gleiche Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Diese Meldungen melden eine Ablehnung, die die API zurückgegeben hat. Claude Code selbst produziert `Login expired` für eine Anmeldung, die es bereits nicht erneuern konnte, sodass es keine Anfrage sendet. Wenn die Erneuerung fehlschlägt, weil das Konto selbst ausgesetzt ist, statt dass die Anmeldung veraltet ist, zeigt Claude Code stattdessen [Ihr Konto ist gesperrt](#your-account-is-on-hold).1242Dies ist nicht der gleiche Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Diese Meldungen melden eine Ablehnung, die die API zurückgegeben hat. Claude Code selbst erzeugt `Login expired` für eine Anmeldung, die es bereits nicht erneuern konnte, sodass es keine Anfrage sendet. Wenn die Erneuerung fehlschlägt, weil das Konto selbst ausgesetzt ist, statt dass die Anmeldung veraltet ist, zeigt Claude Code stattdessen [Ihr Konto ist gesperrt](#your-account-is-on-hold).

1195 1243

1196Sitzungen, die sich mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter-Provider authentifizieren, verwenden nicht die gespeicherte Anmeldung und sehen diese Meldung nie.1244Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter-Provider authentifiziert sind, verwenden die gespeicherte Anmeldung nicht und sehen diese Meldung nie.

1197 1245

1198Sie können diesen Zustand vor einem Anfragefehler überprüfen: [`/status`](/docs/de/commands) zeigt eine `Login`-Zeile an, die `Expired — log in again` liest, plus die Organisation und E-Mail, die sie für die abgelaufene Anmeldung gespeichert hat. Die Zeile erscheint nur, wenn die gespeicherte Anmeldung Ihre aktive Anmeldedaten ist und nicht mehr erneuert werden kann. Sitzungen, die sich auf andere Weise authentifizieren, zeigen die Zeile nicht, selbst wenn eine abgelaufene Anmeldung gespeichert bleibt. Vor v2.1.210 gab `/status` in diesem Zustand keinen Hinweis darauf, dass eine Anmeldung jemals existiert hatte, weil die gelöschte Anmeldedaten es nichts zu melden ließ.1246Sie können diesen Zustand vor einem Anfragefehler überprüfen: [`/status`](/docs/de/commands) zeigt eine `Login`-Zeile an, die `Expired — log in again` liest, plus die Organisation und E-Mail, die sie für die abgelaufene Anmeldung gespeichert hat. Die Zeile erscheint nur, wenn die gespeicherte Anmeldung Ihre aktive Anmeldedaten ist und nicht mehr erneuert werden kann. Sitzungen, die sich auf andere Weise authentifizieren, zeigen die Zeile nicht, selbst wenn eine abgelaufene Anmeldung gespeichert bleibt. Vor v2.1.210 gab `/status` in diesem Zustand keinen Hinweis darauf, dass eine Anmeldung jemals existiert hatte, weil die gelöschte Anmeldedaten ihr nichts zum Melden ließ.

1199 1247

1200**Was zu tun ist:**1248**Was zu tun ist:**

1201 1249

1202* Führen Sie `/login` aus, um sich erneut anzumelden. Das Wiederholen ohne Anmeldung zeigt die gleiche Meldung bei jeder Anfrage.1250* Führen Sie `/login` aus, um sich erneut anzumelden. Das Wiederholen ohne Anmeldung zeigt die gleiche Meldung bei jeder Anfrage.

1203* Im nicht-interaktiven Modus führen Sie `claude` in der gleichen Umgebung aus, führen Sie `/login` aus, dann führen Sie Ihren Befehl erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [generieren Sie ein langlebiges Token mit `claude setup-token`](/docs/de/authentication#generate-a-long-lived-token).1251* Im nicht-interaktiven Modus führen Sie `claude` in der gleichen Umgebung aus, führen Sie `/login` aus, dann führen Sie Ihren Befehl erneut aus. Für die Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [generieren Sie einen langlebigen Token mit `claude setup-token`](/docs/de/authentication#generate-a-long-lived-token).

1204* Wenn die Anmeldung weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)1252* Wenn das Anmelden weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)

1253

1254<h3 id="could-not-refresh-your-login">

1255 Ihre Anmeldung konnte nicht aktualisiert werden, weil ein anderer Claude Code-Prozess sie aktualisiert

1256</h3>

1257

1258Diese Meldung bedeutet nicht, dass Ihre Anmeldung abgelehnt wurde. Ihre gespeicherte claude.ai-Anmeldung war abgelaufen und musste erneuert werden. Ein anderer Claude Code-Prozess auf der gleichen Maschine hielt die gemeinsame Aktualisierungs-Sperre, oder verließ sie und ließ sie zurück, und die Aktualisierung machte keinen Fortschritt, während diese Sitzung wartete. Claude Code stoppt die Anfrage, bevor sie gesendet wird:

1259

1260```text theme={null}

1261Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

1262```

1263

1264Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `server_error`:

1265

1266```text theme={null}

1267Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

1268```

1269

1270Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter-Provider authentifiziert sind, verwenden die gespeicherte Anmeldung nicht und sehen diese Meldung nie.

1271

1272**Was zu tun ist:**

1273

1274* Versuchen Sie es in einer Minute erneut. Wenn ein anderer Prozess die Aktualisierung zuerst abschließt, verwendet diese Sitzung die erneuerte Anmeldung.

1275* Wenn die Meldung weiterhin zurückkommt, schließen Sie andere Claude Code-Fenster und -Prozesse, dann versuchen Sie es erneut.

1276* Wenn es mit keinem anderen Claude Code-Prozess zurückkommt, führen Sie `/login` aus. Das erneute Anmelden wartet nicht auf die Aktualisierungs-Sperre.

1277

1278<h3 id="couldnt-save-your-login">

1279 Ihre Anmeldung konnte nicht gespeichert werden

1280</h3>

1281

1282Sie haben sich mit claude.ai angemeldet, aber Claude Code konnte die Anmeldung nicht in seinem Anmeldedaten-Speicher speichern, sodass die Anmeldung nicht abgeschlossen wurde. Auf macOS kann dies passieren, wenn der Anmeldungs-Schlüsselbund sperrt, z. B. beim Ruhezustand oder bei Untätigkeit, nachdem Claude Code bereits Anmeldedaten darin während der gleichen Sitzung gelesen oder gespeichert hat.

1283

1284```text theme={null}

1285Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.

1286Couldn't save your login. Try logging in again.

1287```

1288

1289Die erste Form erscheint auf macOS und die zweite überall sonst. Ein vorübergehender Anmeldedaten-Speicher-Fehler, z. B. ein Timeout oder ein unlesbarer Speicher, erzeugt die gleiche Meldung.

1290

1291**Was zu tun ist:**

1292

1293* Auf macOS entsperren Sie den Anmeldungs-Schlüsselbund, dann führen Sie `/login` erneut aus

1294* Auf anderen Plattformen führen Sie `/login` erneut aus

1295* Wenn die Anmeldung immer noch nicht gespeichert wird, siehe [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) für den Schlüsselbund-Entsperr-Befehl und andere Wiederherstellungsschritte für die Anmeldedaten-Verwaltung

1296

1297<h3 id="failed-to-start-oauth-callback-server">

1298 OAuth-Callback-Server konnte nicht gestartet werden

1299</h3>

1300

1301Wenn `/login`, `claude auth login` oder `claude setup-token` Sie durch den Browser anmeldet, öffnet Claude Code einen Listening-Port auf `127.0.0.1`, damit Ihr Browser das Anmeldeergebnis dorthin zurückgeben kann. Diese Meldung bedeutet, dass Claude Code diesen Port nicht öffnen konnte, und die Anmeldung stoppt, bevor ein Browser-Fenster oder eine Anmelde-URL erscheint:

1302

1303```text theme={null}

1304Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

1305```

1306

1307Wenn Ihre Meldung mit `Is port 0 in use?` endet, ist der Versuch, auf der IPv4-Loopback-Adresse `127.0.0.1` zu lauschen, sofort fehlgeschlagen. Weil der Fehler passiert, bevor eine Anmelde-URL existiert, ist der `Paste code here if prompted`-Fluss nicht als Workaround verfügbar.

1308

1309**Was zu tun ist:**

1310

1311* Um sich sofort ohne den lokalen Listener anzumelden: Wenn Sie ein claude.ai-Abonnement verwenden, führen Sie [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) auf einer Maschine aus, wo die Anmeldung funktioniert, und setzen Sie den Token, den es ausgibt, als `CLAUDE_CODE_OAUTH_TOKEN` auf dieser Maschine. Andernfalls setzen Sie `ANTHROPIC_API_KEY` auf einen Schlüssel aus der [Claude Console](https://platform.claude.com/settings/keys). [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) erklärt, wie Claude Code zwischen Anmeldedaten wählt.

1312* Um stattdessen Browser-Anmeldung auf dieser Maschine zu verwenden, muss Claude Code auf `127.0.0.1` lauschen können. Wenn es in einer Sandbox läuft, überprüfen Sie, dass die Sandbox-Richtlinie das Lauschen auf lokalen Ports erlaubt, dann führen Sie `/login` erneut aus. Wenn es sollte und immer noch fehlschlägt, führen Sie `/feedback` aus, damit der Bericht Ihre Umgebungsdetails enthält.

1205 1313

1206<h3 id="claude-login-not-accepted">1314<h3 id="claude-login-not-accepted">

1207 Claude-Anmeldung nicht akzeptiert1315 Claude-Anmeldung nicht akzeptiert

1208</h3>1316</h3>

1209 1317

1210Sie versuchten, eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zu starten, und der Server weigerte sich, sie mit einem 401 zu erstellen: er akzeptierte die Claude-Anmeldung, die dieser Computer gesendet hat, nicht, normalerweise weil die Anmeldung abgelaufen oder widerrufen wurde.1318Sie versuchten, eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zu starten, und der Server weigerte sich, sie mit einem 401 zu erstellen: er akzeptierte die Claude-Anmeldung, die diese Maschine gesendet hat, nicht, normalerweise weil die Anmeldung abgelaufen oder widerrufen wurde.

1211 1319

1212Der erste Teil der Zeile ist der eigene Grund des Servers, wenn er einen gibt. Andernfalls liest sich die Zeile:1320Der erste Teil der Zeile ist der eigene Grund des Servers, wenn er einen gibt. Andernfalls lautet die Zeile:

1213 1321

1214```text theme={null}1322```text theme={null}

1215Claude login not accepted · Run /login, then try again1323Claude login not accepted · Run /login, then try again

1223 Artefakte benötigen eine claude.ai-Anmeldung1331 Artefakte benötigen eine claude.ai-Anmeldung

1224</h3>1332</h3>

1225 1333

1226Claude Code weigerte sich, ein [Artefakt](/docs/de/artifacts) zu veröffentlichen oder zu lesen, weil die Sitzung keine claude.ai-Anmeldung hat, die es für Artefakte verwenden kann.1334Claude Code weigerte sich, ein [Artefakt](/docs/de/artifacts) zu veröffentlichen oder zu lesen, weil die Sitzung keine claude.ai-Anmeldung hat, die sie für Artefakte verwenden kann.

1227 1335

1228Jede Form der Meldung beginnt mit den gleichen Worten, gefolgt von einem Mittel, das davon abhängt, wie sich Ihre Sitzung authentifiziert. Ohne konkurrierende Anmeldedaten liest es sich:1336Jede Form der Meldung beginnt mit den gleichen Worten, gefolgt von einem Mittel, das davon abhängt, wie sich Ihre Sitzung authentifiziert. Ohne konkurrierende Anmeldedaten lautet sie:

1229 1337

1230```text theme={null}1338```text theme={null}

1231Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1339Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

1234**Was zu tun ist:**1342**Was zu tun ist:**

1235 1343

1236* Führen Sie `/login` aus und wählen Sie **Claude account with subscription**. Die Option **Anthropic Console account** bietet keine claude.ai-Anmeldedaten.1344* Führen Sie `/login` aus und wählen Sie **Claude account with subscription**. Die Option **Anthropic Console account** bietet keine claude.ai-Anmeldedaten.

1237* Wenn die Meldung eine Anmeldedaten benennt, die Vorrang hat, z. B. `ANTHROPIC_API_KEY`, eine `apiKeyHelper`-Einstellung oder einen Console-Schlüssel, der durch eine vorherige `/login` gespeichert wurde, entfernen Sie ihn auf die Weise, die die Meldung sagt, dann führen Sie `/login` aus1345* Wenn die Meldung eine Anmeldedaten benennt, die Vorrang hat, z. B. `ANTHROPIC_API_KEY`, eine `apiKeyHelper`-Einstellung oder einen Console-Schlüssel, der von einem vorherigen `/login` gespeichert wurde, entfernen Sie ihn wie die Meldung sagt, dann führen Sie `/login` aus

1238* Wenn die Meldung sagt, dass diese Remote-Sitzung sich durch den Computer authentifiziert, der sie gestartet hat, melden Sie sich auf diesem Computer bei claude.ai an, dann verbinden Sie die Sitzung erneut1346* Wenn die Meldung sagt, dass sich diese Remote-Sitzung durch die Maschine authentifiziert, die sie gestartet hat, melden Sie sich auf dieser Maschine bei claude.ai an, dann verbinden Sie die Sitzung erneut

1239* Wenn die Meldung sagt, dass die Anmeldedaten von der Sitzungs-Host-Umgebung injiziert werden, können Sie sie in dieser Sitzung nicht ändern; starten Sie eine Sitzung, die bei claude.ai angemeldet ist1347* Wenn die Meldung sagt, dass die Anmeldedaten von der Sitzungs-Host-Umgebung injiziert werden, können Sie sie in dieser Sitzung nicht ändern; starten Sie eine Sitzung, die bei claude.ai angemeldet ist

1240* Siehe [Verfügbarkeit](/docs/de/artifacts#availability) für die anderen Anforderungen, die Artefakte haben, z. B. Plan, Modell-Provider und Organisations-Richtlinie1348* Siehe [Verfügbarkeit](/docs/de/artifacts#availability) für die anderen Anforderungen, die Artefakte haben, z. B. Plan, Modell-Provider und Organisations-Richtlinie

1241 1349

1243 Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung1351 Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung

1244</h3>1352</h3>

1245 1353

1246Ein Administrator's [verwaltete Einstellungen](/docs/de/managed-settings) auf diesem Computer setzen [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) auf `"gateway"` oder setzen [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl). Sofern Sie nicht einen Cloud-Provider durch eine Variable wie `CLAUDE_CODE_USE_BEDROCK` auswählen, akzeptiert Claude Code dann nur die [Claude apps gateway](/docs/de/claude-apps-gateway)-Anmeldung. Sie sehen eine von zwei Meldungen:1354Die [verwalteten Einstellungen](/docs/de/managed-settings) eines Administrators auf dieser Maschine setzen [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) auf `"gateway"` oder setzen [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl). Sofern Sie keinen Cloud-Provider durch eine Variable wie `CLAUDE_CODE_USE_BEDROCK` auswählen, akzeptiert Claude Code dann nur die [Claude apps gateway](/docs/de/claude-apps-gateway)-Anmeldung. Sie sehen eine von zwei Meldungen:

1247 1355

1248```text theme={null}1356```text theme={null}

1249Not signed in to the Cloud gateway — run /login.1357Not signed in to the Cloud gateway — run /login.

1250```1358```

1251 1359

1252Modellanfragen schlagen mit dieser Meldung fehl, wenn die Sitzung keine Gateway-Anmeldung hat, z. B. weil Sie `/login` nicht seit der Ankunft der Richtlinie auf dem Computer ausgeführt haben.1360Modellanfragen schlagen mit dieser Meldung fehl, wenn die Sitzung keine Gateway-Anmeldung hat, z. B. weil Sie `/login` nicht seit der Ankunft der Richtlinie auf der Maschine ausgeführt haben.

1253 1361

1254Wenn Sie auch einen `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`-Anmeldedaten konfiguriert haben und die verwalteten Einstellungen `forceLoginMethod` setzen, beendet Claude Code beim Start statt mit einer Meldung, die beginnt:1362Wenn die Maschine auch eine von Anthropic ausgegebene Anmeldedaten hält und die verwalteten Einstellungen `forceLoginMethod` oder `forceLoginOrgUUID` setzen, beendet Claude Code stattdessen beim Start. Diese Anmeldedaten kann eine `ANTHROPIC_API_KEY`- oder `ANTHROPIC_AUTH_TOKEN`-Variable, eine `apiKeyHelper`-Einstellung oder ein API-Schlüssel sein, der von einer früheren Claude Console-Anmeldung gespeichert wurde. Die Meldung beginnt:

1255 1363

1256```text theme={null}1364```text theme={null}

1257Administrator policy requires a Cloud gateway sign-in on this machine; the1365Administrator policy requires a Cloud gateway sign-in on this machine; the

1262**Was zu tun ist:**1370**Was zu tun ist:**

1263 1371

1264* Führen Sie `/login` aus und schließen Sie die Anmeldung auf dem **Cloud gateway**-Bildschirm ab1372* Führen Sie `/login` aus und schließen Sie die Anmeldung auf dem **Cloud gateway**-Bildschirm ab

1265* Für die Startup-Meldung entfernen Sie die `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`-Einstellung, die Sie konfiguriert haben, starten Sie dann `claude` und führen Sie `/login` aus1373* Für die Startup-Meldung entfernen Sie die `ANTHROPIC_API_KEY`-, `ANTHROPIC_AUTH_TOKEN`- oder `apiKeyHelper`-Einstellung, die Sie konfiguriert haben. Um einen gespeicherten Console-API-Schlüssel zu entfernen, führen Sie `claude auth logout` aus, das auch eine gespeicherte claude.ai-Anmeldung entfernt. Wenn Sie einen Cloud-Provider mit `CLAUDE_CODE_USE_*` auswählen, startet die Sitzung dann ohne Anmeldung. Andernfalls starten Sie `claude` und führen Sie `/login` aus

1266* Wenn Sie glauben, dass der Computer das Gateway nicht erfordern sollte, bitten Sie den Administrator, der ihn verwaltet, `forceLoginMethod` und `forceLoginGatewayUrl` aus seinen verwalteten Einstellungen zu entfernen1374* Wenn Sie glauben, dass die Maschine das Gateway nicht erfordern sollte, bitten Sie den Administrator, der sie verwaltet, `forceLoginMethod` und `forceLoginGatewayUrl` aus ihren verwalteten Einstellungen zu entfernen

1267 1375

1268In v2.1.265 zeigte eine Regression auch die erste Meldung in einigen LLM-Gateway- und Proxy-Konfigurationen, die sich mit einem API-Schlüssel, `apiKeyHelper` oder benutzerdefinierten Headern authentifizieren, selbst ohne Administrator-Anforderung auf dem Computer. Aktualisieren Sie auf v2.1.266 oder später. Sie müssen Ihre Konfiguration nicht ändern.1376Auf v2.1.265 zeigte eine Regression auch die erste Meldung in einigen LLM-Gateway- und Proxy-Konfigurationen, die sich mit einem API-Schlüssel, `apiKeyHelper` oder benutzerdefinierten Headern authentifizieren, selbst ohne Administrator-Anforderung auf der Maschine. Aktualisieren Sie auf v2.1.266 oder später. Sie müssen Ihre Konfiguration nicht ändern.

1269 1377

1270Vor v2.1.261 verwendete Claude Code auf Computern, die `forceLoginMethod` auf `"gateway"` setzen, eine verbleibende gespeicherte Anmeldung statt Modellanfragen fehlschlagen zu lassen, und meldete eine konfigurierte Umgebungs-Anmeldedaten mit `This machine's managed settings require a first-party login` statt der Startup-Meldung. Vor v2.1.265 erforderte ein Computer, dessen verwaltete Einstellungen nur `forceLoginGatewayUrl` setzen, nicht die Gateway-Anmeldung, und Claude Code verwendete eine verbleibende Anmeldedaten dort.1378Vor v2.1.261 verwendete Claude Code auf Maschinen, die `forceLoginMethod` auf `"gateway"` setzen, eine verbleibende gespeicherte Anmeldung statt Modellanfragen fehlschlagen zu lassen, und meldete eine konfigurierte Umgebungs-Anmeldedaten mit `This machine's managed settings require a first-party login` statt der Startup-Meldung. Vor v2.1.265 erforderte eine Maschine, deren verwaltete Einstellungen nur `forceLoginGatewayUrl` setzen, nicht die Gateway-Anmeldung, und Claude Code verwendete eine verbleibende Anmeldedaten dort.

1271 1379

1272<h3 id="your-account-is-on-hold">1380<h3 id="your-account-is-on-hold">

1273 Ihr Konto ist gesperrt1381 Ihr Konto ist gesperrt

1274</h3>1382</h3>

1275 1383

1276Das Claude-Konto hinter Ihrer Anmeldung wurde ausgesetzt. Claude Code zeigt die erste Meldung, wenn es versucht, Ihre gespeicherte Anmeldung zu erneuern und von der Sperrung erfährt, und die zweite, wenn eine Anmeldung, die Sie im Browser abschließen, dies meldet:1384Das Claude-Konto hinter Ihrer Anmeldung wurde ausgesetzt. Claude Code zeigt die erste Meldung, wenn es versucht, Ihre gespeicherte Anmeldung zu erneuern und von der Sperrung erfährt, und die zweite, wenn eine Anmeldung, die Sie im Browser abschließen, sie meldet:

1277 1385

1278```text theme={null}1386```text theme={null}

1279Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1387Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted

1280Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1388Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

1281```1389```

1282 1390

1283Die erneute Anmeldung mit dem gleichen Konto löscht die Meldung nicht, weil die Sperrung auf dem Konto liegt, nicht auf der Anmeldung. Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) ist der strukturierte Fehlercode `account_on_hold`. Vor v2.1.235 meldete Claude Code ein gesperrtes Konto als [Anmeldung abgelaufen · Bitte führen Sie /login aus](#login-expired), dessen Wiederherstellungsschritte eine Sperrung nicht löschen können.1391Das erneute Anmelden mit dem gleichen Konto löscht die Meldung nicht, weil die Sperrung auf dem Konto statt auf der Anmeldung ist. Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) ist der strukturierte Fehlercode `account_on_hold`. Vor v2.1.235 meldete Claude Code ein gesperrtes Konto als [Anmeldung abgelaufen · Bitte führen Sie /login aus](#login-expired), dessen Wiederherstellungsschritte eine Sperrung nicht löschen können.

1284 1392

1285**Was zu tun ist:**1393**Was zu tun ist:**

1286 1394

1287* Öffnen Sie den Link in der Meldung, um die Details der Sperrung anzuzeigen oder dagegen Einspruch zu erheben1395* Öffnen Sie den Link in der Meldung, um die Details der Sperrung anzusehen oder dagegen Einspruch zu erheben

1288* Wenn Sie ein anderes Claude-Konto oder einen API-Schlüssel haben, der von der Sperrung nicht betroffen ist, können Sie weiterarbeiten, während die Sperrung gelöst wird: führen Sie `/login` mit diesem Konto aus, oder setzen Sie den Schlüssel mit `ANTHROPIC_API_KEY`1396* Wenn Sie ein anderes Claude-Konto oder einen API-Schlüssel haben, der von der Sperrung nicht betroffen ist, können Sie weiterarbeiten, während die Sperrung gelöst wird: führen Sie `/login` mit diesem Konto aus, oder setzen Sie den Schlüssel mit `ANTHROPIC_API_KEY`

1289 1397

1290<h3 id="anthropic-profile-login-expired">1398<h3 id="anthropic-profile-login-expired">

1291 Anthropic-Profil-Anmeldung abgelaufen1399 Anthropic-Profil-Anmeldung abgelaufen

1292</h3>1400</h3>

1293 1401

1294Claude Code authentifiziert sich durch ein Anthropic-Anmeldedaten-Profil, dessen gespeicherte Anmeldungs-Anmeldedaten abgelaufen ist, und das Profil hält keine Aktualisierungs-Anmeldedaten, die Claude Code verwenden kann, um sie zu erneuern. Claude Code stoppt jede Anfrage lokal, ohne zu wiederholen, weil eine Wiederholung die gleiche abgelaufene Anmeldedaten lesen würde.1402Claude Code authentifiziert sich durch ein Anthropic-Anmeldedaten-Profil, dessen gespeicherte Anmeldungs-Anmeldedaten abgelaufen ist, und das Profil hält keine Aktualisierungs-Anmeldedaten, die Claude Code zum Erneuern verwenden kann. Claude Code stoppt jede Anfrage lokal ohne Wiederholung, weil eine Wiederholung die gleiche abgelaufene Anmeldedaten lesen würde.

1295 1403

1296```text theme={null}1404```text theme={null}

1297Anthropic profile login expired · Re-authenticate your Anthropic profile1405Anthropic profile login expired · Re-authenticate your Anthropic profile

1298Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1406Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile

1299```1407```

1300 1408

1301Dies erscheint nur, wenn die aktive Anmeldedaten von einem Anthropic-Anmeldedaten-Profil stammt, das Sie mit der Umgebungsvariable `ANTHROPIC_PROFILE` auswählen, das Claude Code als das aktive Profil in Ihrem Anthropic-Konfigurationsverzeichnis entdeckt, oder das Claude Code schrieb, als Sie sich [ohne API-Schlüssel anmeldeten](/docs/de/authentication#sign-in-without-an-api-key). Sitzungen, die sich mit der claude.ai-Option von `/login`, einem API-Schlüssel, einem Bearer-Token wie `ANTHROPIC_AUTH_TOKEN` oder einem Drittanbieter-Provider authentifizieren, sehen diese Meldung nie.1409Dies erscheint nur, wenn die aktive Anmeldedaten von einem Anthropic-Anmeldedaten-Profil stammt, einem, das Sie mit der Umgebungsvariable `ANTHROPIC_PROFILE` auswählen, das Claude Code als das aktive Profil in Ihrem Anthropic-Konfigurationsverzeichnis entdeckt, oder das Claude Code schrieb, als Sie sich [ohne API-Schlüssel anmeldeten](/docs/de/authentication#sign-in-without-an-api-key). Sitzungen, die sich mit einem API-Schlüssel, einem Bearer-Token wie `ANTHROPIC_AUTH_TOKEN` oder einem Drittanbieter-Provider authentifizieren, sehen diese Meldung nie.

1302 1410

1303Auf einem Computer, der [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus, wählen Sie das Anthropic Console-Konto und melden Sie sich erneut an, um ein Profil zu erneuern, das die schlüssellose Console-Anmeldung oder die Claude Platform CLI's `ant auth login` schrieb. Claude Code ersetzt die abgelaufene Anmeldedaten in diesem Profil. Für ein Verbund-Profil oder eines, das ein anderes Tool erstellt hat, erneuert `/login` die Anmeldedaten nicht. Welche Form Sie sehen, hängt davon ab, ob Sie das Profil ausgewählt haben oder Claude Code es entdeckt hat:1411Auf einer Maschine, die [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus, wählen Sie das Anthropic Console-Konto, und melden Sie sich erneut an, um ein Profil zu erneuern, das die schlüssellose Console-Anmeldung oder die Claude Platform CLI's `ant auth login` schrieb. Claude Code ersetzt die abgelaufene Anmeldedaten in diesem Profil. Für ein Verbund-Profil oder eines, das ein anderes Tool erstellt hat, erneuert `/login` die Anmeldedaten nicht. Welche Form Sie sehen, hängt davon ab, ob Sie das Profil ausgewählt haben oder Claude Code es entdeckt hat:

1304 1412

1305* Wenn Sie `ANTHROPIC_PROFILE` explizit setzen, endet die Meldung mit `Re-authenticate your Anthropic profile`.1413* Wenn Sie `ANTHROPIC_PROFILE` explizit setzen, endet die Meldung mit `Re-authenticate your Anthropic profile`.

1306* Wenn Claude Code das Profil aus Ihrem Konfigurationsverzeichnis entdeckt hat, bietet die Meldung `/login` an, weil Claude Code einer funktionierenden `/login` Vorrang vor dem entdeckten Profil gibt und sich dann stattdessen mit Ihrem claude.ai- oder Console-Konto authentifiziert. Vor v2.1.234 zeigte Claude Code in diesem Fall auch die Form `Re-authenticate your Anthropic profile`.1414* Wenn Claude Code das Profil aus Ihrem Konfigurationsverzeichnis entdeckt hat, bietet die Meldung `/login` an, weil Claude Code einer funktionierenden `/login` Vorrang vor dem entdeckten Profil gibt und sich dann stattdessen mit Ihrem claude.ai- oder Console-Konto authentifiziert. Vor v2.1.234 zeigte Claude Code in diesem Fall auch die `Re-authenticate your Anthropic profile`-Form.

1307 1415

1308**Was zu tun ist:**1416**Was zu tun ist:**

1309 1417

1310* Melden Sie sich erneut bei dem Profil an, dann versuchen Sie es erneut: Auf einem Computer, der [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus und wählen Sie das Anthropic Console-Konto für ein Profil, das die schlüssellose Console-Anmeldung oder die Claude Platform CLI's `ant auth login` schrieb; für andere Profile verwenden Sie das Tool, das sie erstellt hat1418* Melden Sie sich erneut bei dem Profil an, dann versuchen Sie es erneut: auf einer Maschine, die [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus und wählen Sie das Anthropic Console-Konto für ein Profil, das die schlüssellose Console-Anmeldung oder die Claude Platform CLI's `ant auth login` schrieb; für andere Profile verwenden Sie das Tool, das sie erstellt hat

1311* Wenn ein Administrator das Profil-Anmeldedaten bereitgestellt hat, bitten Sie ihn, ein neues auszustellen1419* Wenn ein Administrator das Profil-Anmeldedaten bereitgestellt hat, bitten Sie ihn, ein neues auszugeben

1312* Führen Sie `/status` aus, um die aktive Anmeldedatenquelle und den Profilnamen zu bestätigen1420* Führen Sie `/status` aus, um die aktive Anmeldedatenquelle und den Profilnamen zu bestätigen

1313* Um die Verwendung des Profils zu beenden, heben Sie `ANTHROPIC_PROFILE` auf, wenn Sie es gesetzt haben, dann authentifizieren Sie sich auf andere Weise, z. B. `/login` oder `ANTHROPIC_API_KEY`1421* Um die Verwendung des Profils zu beenden, heben Sie `ANTHROPIC_PROFILE` auf, wenn Sie es setzen, dann authentifizieren Sie sich auf andere Weise, z. B. `/login` oder `ANTHROPIC_API_KEY`

1314 1422

1315<h3 id="oauth-scope-requirement">1423<h3 id="oauth-scope-requirement">

1316 OAuth-Bereichsanforderung1424 OAuth-Bereichs-Anforderung

1317</h3>1425</h3>

1318 1426

1319Das gespeicherte Token stammt von vor einem Berechtigungsbereich, den ein neueres Feature benötigt. Sie sehen dies am häufigsten von `/usage` und dem Nutzungsindikator der Statuszeile:1427Das gespeicherte Token stammt aus einer Zeit vor einem Berechtigungs-Bereich, den ein neueres Feature benötigt:

1320 1428

1321```text theme={null}1429```text theme={null}

1322OAuth token does not meet scope requirement: user:profile1430OAuth token does not meet scope requirement: user:profile

1324 1432

1325**Was zu tun ist:**1433**Was zu tun ist:**

1326 1434

1327* Führen Sie `/login` aus, um ein neues Token mit den aktuellen Bereichen zu erhalten. Sie müssen sich nicht zuerst abmelden.1435* Führen Sie `/login` aus, um einen neuen Token mit den aktuellen Bereichen zu erhalten. Sie müssen sich nicht zuerst abmelden.

1328 1436

1329<h3 id="claude-ai-rejected-the-session-token">1437<h3 id="claude-ai-rejected-the-session-token">

1330 claude.ai lehnte das Sitzungs-Token ab1438 claude.ai lehnte den Sitzungs-Token ab

1331</h3>1439</h3>

1332 1440

1333Eine [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai)-Anfrage schlug fehl, weil claude.ai das Token aus Ihrer Claude Code-Anmeldung ablehnte, normalerweise eine Anmeldung, die abgelaufen ist und nicht erneuert werden konnte. Das abgelehnte Token ist Ihre Anmeldung, nicht die eigene Autorisierung des Connectors in claude.ai, sodass die erneute Autorisierung des Connectors es nicht behebt. In `/mcp` zeigt der Connector als `connected · session token rejected` und seine Detailansicht liest:1441Eine [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai)-Anfrage schlägt fehl, weil claude.ai den Token von Ihrer Claude Code-Anmeldung ablehnt. Der abgelehnte Token ist Ihre Anmeldung, nicht die eigene Autorisierung des Connectors in claude.ai, sodass das erneute Autorisieren des Connectors es nicht behebt. In `/mcp` zeigt der Connector `session token rejected` an, und seine Detailansicht liest:

1334 1442

1335```text theme={null}1443```text theme={null}

1336claude.ai rejected the session token. Run /login, then reconnect.1444claude.ai rejected the session token. Run /login, then reconnect.

1339**Was zu tun ist:**1447**Was zu tun ist:**

1340 1448

1341* Führen Sie `/login` aus, um sich erneut anzumelden1449* Führen Sie `/login` aus, um sich erneut anzumelden

1342* Verbinden Sie den Connector von `/mcp` erneut, oder führen Sie `/mcp reconnect <server>` aus. Das Erneute Verbinden, bevor Sie sich erneut anmelden, lässt den Connector im gleichen Zustand. Die Option **Reconnect** des `/mcp`-Panels meldet `your claude.ai session token was rejected`; das eingegebene `/mcp reconnect <server>`-Formular meldet eine erfolgreiche Wiederverbindung, obwohl das Token immer noch abgelehnt wird.1450* Verbinden Sie den Connector von `/mcp` erneut, oder führen Sie `/mcp reconnect <server>` aus. Das erneute Verbinden, bevor Sie sich erneut anmelden, lässt den Connector im gleichen Zustand. Die **Reconnect**-Option des `/mcp`-Panels meldet `your claude.ai session token was rejected`; die eingegebene `/mcp reconnect <server>`-Form meldet eine erfolgreiche Wiederverbindung, obwohl der Token immer noch abgelehnt wird.

1343 1451

1344Vor v2.1.222 markierte Claude Code den Connector als Authentifizierung erforderlich, was Sie auf den Autorisierungsfluss des Connectors hinwies, obwohl das Abschließen ihn nicht behob.1452Vor v2.1.222 markierte Claude Code den Connector als Authentifizierung benötigend statt, was Sie auf den Authentifizierungs-Fluss des Connectors hinwies, obwohl das Abschließen ihn nicht behebt.

1345 1453

1346<h3 id="mcp-server-needs-you-to-sign-in-again">1454<h3 id="mcp-server-needs-you-to-sign-in-again">

1347 MCP-Server benötigt Sie, sich erneut anzumelden1455 MCP-Server benötigt Sie, um sich erneut anzumelden

1348</h3>1456</h3>

1349 1457

1350Ein Remote-[MCP-Server](/docs/de/mcp) lehnte die Anmeldedaten bei einem Tool-Aufruf während der Sitzung ab, normalerweise weil eine Anmeldung oder ein Token abgelaufen ist oder weil das Token einen Berechtigungsbereich fehlt, den das Tool benötigt. Der Tool-Aufruf schlägt fehl, und `/mcp` markiert den Server als [Authentifizierung erforderlich](/docs/de/mcp#authenticate-with-remote-mcp-servers).1458Ein Remote-[MCP-Server](/docs/de/mcp) lehnte die Anmeldedaten bei einem Tool-Aufruf während der Sitzung ab, normalerweise weil eine Anmeldung oder ein Token abgelaufen ist oder weil der Token eine Berechtigung fehlt, die das Tool benötigt. Der Tool-Aufruf schlägt fehl, und `/mcp` markiert den Server als [Authentifizierung benötigend](/docs/de/mcp#authenticate-with-remote-mcp-servers).

1351 1459

1352Für einen Server, bei dem Sie sich von Claude Code aus anmelden, einschließlich eines claude.ai-Connectors, ist die Anmeldung abgelaufen oder wurde widerrufen:1460Für einen Server, bei dem Sie sich von Claude Code aus anmelden, einschließlich eines claude.ai-Connectors, ist die Anmeldung abgelaufen oder wurde widerrufen:

1353 1461

1355MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1463MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

1356```1464```

1357 1465

1358Führen Sie `/mcp` aus, wählen Sie den Server und melden Sie sich erneut von seinem Menü an.1466Führen Sie `/mcp` aus, wählen Sie den Server, und melden Sie sich erneut von seinem Menü an.

1359 1467

1360Für einen Server, der mit einem [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication)-Skript konfiguriert ist, hat Claude Code das Helper-Skript bereits erneut ausgeführt und den Aufruf einmal erneut versucht, bevor dies angezeigt wird:1468Für einen Server, der mit einem [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication)-Skript konfiguriert ist, hat Claude Code das Helper bereits erneut ausgeführt und den Aufruf einmal erneut versucht, bevor dies angezeigt wird:

1361 1469

1362```text theme={null}1470```text theme={null}

1363MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1471MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

1364```1472```

1365 1473

1366Überprüfen Sie, dass der Helper eine Anmeldedaten zurückgibt, die der Server akzeptiert, dann verbinden Sie sich von `/mcp` erneut, das den Helper erneut ausführt.1474Überprüfen Sie, dass der Helper eine Anmeldedaten zurückgibt, die der Server akzeptiert, dann verbinden Sie von `/mcp` erneut, das den Helper erneut ausführt.

1367 1475

1368Für einen Server mit einem statischen `Authorization`-Header in seiner Konfiguration:1476Für einen Server mit einem statischen `Authorization`-Header in seiner Konfiguration:

1369 1477

1371MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1479MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

1372```1480```

1373 1481

1374Aktualisieren Sie den Header-Wert, wo der Server konfiguriert ist, dann verbinden Sie sich von `/mcp` erneut.1482Aktualisieren Sie den Header-Wert, wo der Server konfiguriert ist, dann verbinden Sie von `/mcp` erneut.

1375 1483

1376Vor v2.1.273 zeigten alle drei Fälle `MCP server "<name>" requires re-authorization (token expired)`.1484Vor v2.1.273 zeigten die abgelaufene Anmeldung, `headersHelper` und `Authorization`-Header-Fälle alle `MCP server "<name>" requires re-authorization (token expired)`.

1377 1485

1378Ein Server kann auch einen Tool-Aufruf mit HTTP 403 `insufficient_scope` ablehnen, um Sie aufzufordern, einen Bereich zu autorisieren, manchmal einen, den Ihr Token bereits auflistet. Die Meldung benennt diesen Bereich:1486Ein Server kann auch einen Tool-Aufruf mit HTTP 403 `insufficient_scope` ablehnen, um Sie aufzufordern, einen Bereich zu autorisieren, manchmal einen, den Ihr Token bereits auflistet. Die Meldung benennt diesen Bereich:

1379 1487

1381MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1489MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

1382```1490```

1383 1491

1384Führen Sie `/mcp` aus, wählen Sie den Server und authentifizieren Sie sich erneut von seinem Menü.1492Führen Sie `/mcp` aus, wählen Sie den Server, und authentifizieren Sie sich erneut von seinem Menü.

1385 1493

1386Wenn die Konfiguration des Servers weder [`oauth.scopes`](/docs/de/mcp#restrict-oauth-scopes) noch [`authServerMetadataUrl`](/docs/de/mcp#override-oauth-metadata-discovery) setzt, fordert Claude Code den Bereich an, den der Server benannt hat. Mit einer der beiden Einstellungen fordert Claude Code stattdessen die Bereiche dieser Einstellung an. Wenn Sie `oauth.scopes` angeheftet haben, fügen Sie den fehlenden Bereich zu dieser Liste hinzu, bevor Sie sich erneut authentifizieren.1494Wenn die Konfiguration des Servers weder [`oauth.scopes`](/docs/de/mcp#restrict-oauth-scopes) noch [`authServerMetadataUrl`](/docs/de/mcp#override-oauth-metadata-discovery) setzt, fordert Claude Code den Bereich an, den der Server benannt hat. Mit einer der beiden Einstellungen fordert Claude Code stattdessen die Bereiche dieser Einstellung an. Wenn Sie `oauth.scopes` angeheftet haben, fügen Sie den fehlenden Bereich zu dieser Liste hinzu, bevor Sie sich erneut authentifizieren.

1387 1495

1388Vor v2.1.274 zeigte dieser Fall die `needs you to sign in again`-Meldung, und vor v2.1.273 zeigte er `requires re-authorization (token expired)` wie die anderen Fälle.1496Vor v2.1.274 zeigte dieser Fall die `needs you to sign in again`-Meldung, und vor v2.1.273 zeigte er `requires re-authorization (token expired)` wie die anderen Fälle.

1389 1497

1390<h3 id="issuer-mismatch-in-authorization-response">1498<h3 id="issuer-mismatch-in-authorization-response">

1391 Aussteller-Nichtübereinstimmung in der Autorisierungsantwort1499 Aussteller-Nichtübereinstimmung in Autorisierungs-Antwort

1392</h3>1500</h3>

1393 1501

1394Während einer [MCP OAuth-Anmeldung](/docs/de/mcp#authenticate-with-remote-mcp-servers) leitete der Autorisierungsserver mit einem `iss`-Parameter zu Claude Code zurück, der nicht den Aussteller benennt, den Claude Code aus den OAuth-Metadaten des Servers erwartet. Ein falscher Aussteller in diesem Schritt ist, wie ein Autorisierungsserver-Mix-up-Angriff aussieht, sodass Claude Code die Anmeldung fehlschlägt, statt den Autorisierungscode auszutauschen. Claude Code zeigt den Fehler im `/mcp`-Server-Menü nach der Browser-Anmeldung:1502Während einer [MCP OAuth-Anmeldung](/docs/de/mcp#authenticate-with-remote-mcp-servers) leitete der Autorisierungs-Server zu Claude Code mit einem `iss`-Parameter um, der nicht den Aussteller benennt, den Claude Code von den OAuth-Metadaten des Servers erwartet. Ein falscher Aussteller in diesem Schritt ist, wie ein Autorisierungs-Server-Mix-up-Angriff aussieht, sodass Claude Code die Anmeldung fehlschlägt, statt den Autorisierungs-Code auszutauschen. Claude Code zeigt den Fehler im `/mcp`-Server-Menü nach der Browser-Anmeldung:

1395 1503

1396```text theme={null}1504```text theme={null}

1397Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1505Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

1402**Was zu tun ist:**1510**Was zu tun ist:**

1403 1511

1404* Versuchen Sie die Anmeldung erneut von `/mcp`1512* Versuchen Sie die Anmeldung erneut von `/mcp`

1405* Wenn der Fehler wiederholt wird, melden Sie ihn dem Server-Betreiber. Die Behebung ist serverseitig: Der Autorisierungsserver muss den gleichen Aussteller im `iss`-Parameter zurückgeben, den er in seinen Metadaten bewirbt1513* Wenn der Fehler wiederholt wird, melden Sie ihn dem Server-Betreiber. Die Behebung ist serverseitig: der Autorisierungs-Server muss den gleichen Aussteller im `iss`-Parameter zurückgeben, den er in seinen Metadaten bewirbt

1406* Um eine Verbindung herzustellen, während der Server behoben wird, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](/docs/de/env-vars), dessen [Runtime](/docs/de/mcp#mcp-client-runtimes) diese Überprüfung nicht ausführt. Dies entfernt einen Schutz vor Mix-up-Angriffen, daher bevorzugen Sie die serverseitige Behebung1514* Um eine Verbindung herzustellen, während der Server behoben wird, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](/docs/de/env-vars), dessen [Runtime](/docs/de/mcp#mcp-client-runtimes) diese Überprüfung nicht ausführt. Dies entfernt einen Schutz vor Mix-up-Angriffen, daher bevorzugen Sie die serverseitige Behebung

1407 1515

1408Vor v2.1.232 verwendete Claude Code die v2-Runtime nur in einem schrittweisen Rollout oder wenn Sie `MCP_SDK_GENERATION=v2` setzten.1516Vor v2.1.232 verwendete Claude Code die v2-Runtime nur in einem schrittweisen Rollout oder wenn Sie `MCP_SDK_GENERATION=v2` setzen.

1409 1517

1410<h3 id="aws-credentials-expired-or-invalid">1518<h3 id="aws-credentials-expired-or-invalid">

1411 AWS-Anmeldedaten abgelaufen oder ungültig1519 AWS-Anmeldedaten abgelaufen oder ungültig

1412</h3>1520</h3>

1413 1521

1414Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt. Diese Meldung erscheint auf einem 401 von [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wie diese Provider ein abgelaufenes Sicherheits-Token melden.1522Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt. Diese Meldung erscheint bei einem 401 von [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wie diese Provider ein abgelaufenes Sicherheits-Token melden.

1415 1523

1416Der Aktionshinweis in der Mitte variiert mit Ihrem Setup. Der stabile Teil ist der führende `AWS credentials expired or invalid`:1524Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `AWS credentials expired or invalid`:

1417 1525

1418```text theme={null}1526```text theme={null}

1419AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...1527AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

1423 1531

1424**Was zu tun ist:**1532**Was zu tun ist:**

1425 1533

1426* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1534* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator

1427* Wenn [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration) gesetzt ist, führen Sie den in der Meldung benannten Befehl aus, z. B. `aws sso login --profile myprofile`, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut. Andernfalls aktualisieren Sie die AWS-Anmeldedaten, die Sie selbst verwenden: Ihre SSO-Anmeldung, Zugriffschlüssel, API-Schlüssel oder Proxy-Token1535* Wenn [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration) gesetzt ist, führen Sie den in der Meldung benannten Befehl aus, z. B. `aws sso login --profile myprofile`, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut. Andernfalls aktualisieren Sie die AWS-Anmeldedaten, die Sie selbst verwenden: Ihre SSO-Anmeldung, Zugriffs-Schlüssel, API-Schlüssel oder Proxy-Token

1428* Mit `awsAuthRefresh` in einer interaktiven Sitzung können Sie stattdessen `/login` ausführen, **3rd-party platform** wählen, dann **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms** wählen, um den gleichen Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/docs/de/claude-platform-on-aws#1-configure-aws-credentials)1536* Mit `awsAuthRefresh` in einer interaktiven Sitzung können Sie stattdessen `/login` ausführen, **3rd-party platform** wählen, dann **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms** wählen, um den gleichen Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/docs/de/claude-platform-on-aws#1-configure-aws-credentials)

1429* Wenn der Fehler nach dem erfolgreichen Aktualisierungsbefehl wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `aws sts get-caller-identity` in der gleichen Shell und dem gleichen Profil gültig ist1537* Wenn der Fehler nach dem erfolgreichen Aktualisierungs-Befehl wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `aws sts get-caller-identity` in der gleichen Shell und dem gleichen Profil gültig ist

1430 1538

1431<h3 id="aws-authentication-failed">1539<h3 id="aws-authentication-failed">

1432 AWS-Authentifizierung fehlgeschlagen1540 AWS-Authentifizierung fehlgeschlagen

1434 1542

1435Ihr AWS-Provider hat einen 403 zurückgegeben, oder [Amazon Bedrock](/docs/de/amazon-bedrock) hat einen 401 zurückgegeben.1543Ihr AWS-Provider hat einen 403 zurückgegeben, oder [Amazon Bedrock](/docs/de/amazon-bedrock) hat einen 401 zurückgegeben.

1436 1544

1437Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch, wie es eine Autorisierungsverweigerung meldet, z. B. eine `AccessDeniedException` von einer fehlenden IAM-Berechtigung. Claude Code kann diese beiden Ursachen nicht unterscheiden.1545Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch, wie es eine Autorisierungs-Ablehnung meldet, z. B. eine `AccessDeniedException` von einer fehlenden IAM-Berechtigung. Claude Code kann diese beiden Ursachen nicht unterscheiden.

1438 1546

1439Ein 401 von Amazon Bedrock landet auch hier statt unter [AWS-Anmeldedaten abgelaufen oder ungültig](#aws-credentials-expired-or-invalid), weil Amazon Bedrock ein abgelaufenes Token nicht als 401 meldet. Ein 401 von diesem Endpunkt kommt normalerweise von etwas anderem im Anfragepfad, z. B. einem Unternehmens-Proxy.1547Ein 401 von Amazon Bedrock landet auch hier statt unter [AWS-Anmeldedaten abgelaufen oder ungültig](#aws-credentials-expired-or-invalid), weil Amazon Bedrock ein abgelaufenes Token nicht als 401 meldet. Ein 401 von diesem Endpunkt kommt normalerweise von etwas anderem im Anfrage-Pfad, z. B. einem Unternehmens-Proxy.

1440 1548

1441Eine Anmeldedaten-Aktualisierung behebt ein abgelaufenes Token und kann die anderen Ursachen nicht beheben, sodass die Meldung beide anbietet:1549Eine Anmeldedaten-Aktualisierung behebt ein abgelaufenes Token und kann die anderen Ursachen nicht beheben, sodass die Meldung beide anbietet:

1442 1550

1444AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...1552AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

1445```1553```

1446 1554

1447Der Aktionshinweis in der Mitte variiert mit Ihrem Setup. Der stabile Teil ist der führende `AWS authentication failed`.1555Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `AWS authentication failed`.

1448 1556

1449Wenn der 403 Amazon Bedrock's Antwort ist, dass Sie keinen Zugriff auf das Modell mit der angegebenen Modell-ID haben, sagt der Hinweis stattdessen, dass Sie das Modell für Ihr Konto und Ihre Region in der Amazon Bedrock-Konsole aktivieren.1557Wenn der 403 Amazon Bedrock's Antwort ist, dass Sie keinen Zugriff auf das Modell mit der angegebenen Modell-ID haben, sagt der Hinweis stattdessen, dass Sie das Modell für Ihr Konto und Ihre Region in der Amazon Bedrock-Konsole aktivieren.

1450 1558

1452 1560

1453**Was zu tun ist:**1561**Was zu tun ist:**

1454 1562

1455* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1563* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator

1456* Aktualisieren Sie Ihre AWS-Anmeldedaten, falls ein abgelaufenes Anmeldedaten die Ursache ist: führen Sie den [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration)-Befehl aus, der in der Meldung benannt ist, wenn einer gesetzt ist, oder aktualisieren Sie Ihre SSO-Anmeldung, Zugriffschlüssel, API-Schlüssel oder Proxy-Token selbst1564* Aktualisieren Sie Ihre AWS-Anmeldedaten für den Fall, dass ein abgelaufenes Anmeldedaten die Ursache ist: führen Sie den [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration)-Befehl aus, der in der Meldung benannt wird, wenn einer gesetzt ist, oder aktualisieren Sie Ihre SSO-Anmeldung, Zugriffs-Schlüssel, API-Schlüssel oder Proxy-Token selbst

1457* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie die IAM-Berechtigungen in [IAM-Konfiguration](/docs/de/amazon-bedrock#iam-configuration), die an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist1565* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie die IAM-Berechtigungen in [IAM-Konfiguration](/docs/de/amazon-bedrock#iam-configuration), die an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist

1458* Führen Sie `aws sts get-caller-identity` aus, um zu bestätigen, welche Identität Ihre Anfragen verwenden; ein veraltetes `AWS_PROFILE` oder Standardprofil ist eine häufige Ursache für eine Berechtigungsnichtübereinstimmung1566* Führen Sie `aws sts get-caller-identity` aus, um zu bestätigen, welche Identität Ihre Anfragen verwenden

1459 1567

1460<h3 id="google-cloud-credentials-expired-or-invalid">1568<h3 id="google-cloud-credentials-expired-or-invalid">

1461 Google Cloud-Anmeldedaten abgelaufen oder ungültig1569 Google Cloud-Anmeldedaten abgelaufen oder ungültig

1463 1571

1464Ihre Google Cloud-Anmeldedaten für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) sind abgelaufen oder wurden abgelehnt: die Anfrage hat einen 401 zurückgegeben, wie Agent Platform Anmeldedaten-Ablauf meldet.1572Ihre Google Cloud-Anmeldedaten für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) sind abgelaufen oder wurden abgelehnt: die Anfrage hat einen 401 zurückgegeben, wie Agent Platform Anmeldedaten-Ablauf meldet.

1465 1573

1466Der Aktionshinweis in der Mitte variiert mit Ihrem Setup. Der stabile Teil ist der führende `Google Cloud credentials expired or invalid`:1574Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `Google Cloud credentials expired or invalid`:

1467 1575

1468```text theme={null}1576```text theme={null}

1469Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1577Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

1471 1579

1472**Was zu tun ist:**1580**Was zu tun ist:**

1473 1581

1474* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1582* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator

1475* Wenn Sie sich mit Anwendungsstandardanmeldedaten authentifizieren, führen Sie den [`gcpAuthRefresh`](/docs/de/google-vertex-ai#advanced-credential-configuration)-Befehl aus, der in der Meldung benannt ist, oder `gcloud auth application-default login`, und schließen Sie die Anmeldung ab, dann versuchen Sie es erneut1583* Wenn Sie sich mit Standard-Anwendungs-Anmeldedaten authentifizieren, führen Sie den [`gcpAuthRefresh`](/docs/de/google-vertex-ai#advanced-credential-configuration)-Befehl aus, der in der Meldung benannt wird, oder `gcloud auth application-default login`, und schließen Sie die Anmeldung ab, dann versuchen Sie es erneut

1476* Wenn Sie durch ein [LLM-Gateway](/docs/de/llm-gateway) mit `CLAUDE_CODE_SKIP_VERTEX_AUTH` gesetzt leiten, aktualisieren Sie das Gateway-Token in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_CUSTOM_HEADERS`, dann versuchen Sie es erneut1584* Wenn Sie durch ein [LLM-Gateway](/docs/de/llm-gateway) mit `CLAUDE_CODE_SKIP_VERTEX_AUTH` gesetzt leiten, aktualisieren Sie das Gateway-Token in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_CUSTOM_HEADERS`, dann versuchen Sie es erneut

1477* Wenn Sie sich mit einer Service-Account-Schlüsseldatei authentifizieren, bestätigen Sie, dass `GOOGLE_APPLICATION_CREDENTIALS` auf einen gültigen Schlüssel zeigt. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials)1585* Wenn Sie sich mit einer Service-Account-Schlüsseldatei authentifizieren, bestätigen Sie, dass `GOOGLE_APPLICATION_CREDENTIALS` auf einen gültigen Schlüssel zeigt. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials)

1478* Wenn der Fehler nach einer Aktualisierung wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `gcloud auth application-default print-access-token` in der gleichen Shell funktioniert1586* Wenn der Fehler nach einer Aktualisierung wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `gcloud auth application-default print-access-token` in der gleichen Shell funktioniert

1483 Google Cloud-Authentifizierung fehlgeschlagen1591 Google Cloud-Authentifizierung fehlgeschlagen

1484</h3>1592</h3>

1485 1593

1486[Google Cloud's Agent Platform](/docs/de/google-vertex-ai) hat einen 403 zurückgegeben, den es für Autorisierungsverweigerungen statt abgelaufener Anmeldedaten verwendet. Normalerweise fehlt der Identität, mit der Sie sich authentifizieren, eine IAM-Berechtigung, oder das Modell ist nicht für Ihr Projekt aktiviert.1594[Google Cloud's Agent Platform](/docs/de/google-vertex-ai) hat einen 403 zurückgegeben, den es für Autorisierungs-Ablehnungen statt abgelaufener Anmeldedaten verwendet. Normalerweise fehlt der Identität, mit der Sie sich authentifizieren, eine IAM-Berechtigung, oder das Modell ist nicht für Ihr Projekt aktiviert.

1487 1595

1488Der Aktionshinweis in der Mitte variiert mit Ihrem Setup. Der stabile Teil ist der führende `Google Cloud authentication failed`:1596Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `Google Cloud authentication failed`:

1489 1597

1490```text theme={null}1598```text theme={null}

1491Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1599Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

1493 1601

1494**Was zu tun ist:**1602**Was zu tun ist:**

1495 1603

1496* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1604* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator

1497* Bestätigen Sie die Rollen in [IAM-Konfiguration](/docs/de/google-vertex-ai#iam-configuration), die der Identität gewährt sind, mit der Sie sich authentifizieren1605* Bestätigen Sie, dass die Rollen in [IAM-Konfiguration](/docs/de/google-vertex-ai#iam-configuration) der Identität gewährt sind, mit der Sie sich authentifizieren

1498* Bestätigen Sie, dass das Modell für Ihr Projekt aktiviert ist. Siehe [Modellzugriff anfordern](/docs/de/google-vertex-ai#2-request-model-access)1606* Bestätigen Sie, dass das Modell für Ihr Projekt aktiviert ist. Siehe [Modell-Zugriff anfordern](/docs/de/google-vertex-ai#2-request-model-access)

1499 1607

1500Vor v2.1.273 zeigte ein 403 von Agent Platform die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Google Cloud-Anmeldedaten nicht aktualisieren kann.1608Vor v2.1.273 zeigte ein 403 von Agent Platform die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Google Cloud-Anmeldedaten nicht aktualisieren kann.

1501 1609

1503 Microsoft Foundry-Authentifizierung fehlgeschlagen1611 Microsoft Foundry-Authentifizierung fehlgeschlagen

1504</h3>1612</h3>

1505 1613

1506[Microsoft Foundry](/docs/de/microsoft-foundry) hat einen 401 oder 403 zurückgegeben: die Azure-Anmeldedaten auf der Anfrage wurden abgelehnt, oder die Identität dahinter hat keinen Zugriff auf die Foundry-Ressource. `/login` kann keine Azure-Anmeldedaten prägen. Der Aktionshinweis in der Mitte variiert mit Ihrem Setup. Der stabile Teil ist der führende `Microsoft Foundry authentication failed`:1614[Microsoft Foundry](/docs/de/microsoft-foundry) hat einen 401 oder 403 zurückgegeben: die Azure-Anmeldedaten in der Anfrage wurden abgelehnt, oder die Identität dahinter hat keinen Zugriff auf die Foundry-Ressource. `/login` kann keine Azure-Anmeldedaten prägen. Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `Microsoft Foundry authentication failed`:

1507 1615

1508```text theme={null}1616```text theme={null}

1509Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1617Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

1511 1619

1512**Was zu tun ist:**1620**Was zu tun ist:**

1513 1621

1514* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1622* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator

1515* Aktualisieren Sie die Anmeldedaten, die Sie in [Azure-Anmeldedaten konfigurieren](/docs/de/microsoft-foundry#2-configure-azure-credentials) konfiguriert haben: rotieren Sie `ANTHROPIC_FOUNDRY_API_KEY`, prägen Sie ein frisches `ANTHROPIC_FOUNDRY_AUTH_TOKEN`, oder führen Sie `az login` aus, damit die Standard-Microsoft Entra-Anmeldedaten-Chain sich erneut anmelden kann1623* Aktualisieren Sie die Anmeldedaten, die Sie in [Azure-Anmeldedaten konfigurieren](/docs/de/microsoft-foundry#2-configure-azure-credentials) konfiguriert haben: rotieren Sie `ANTHROPIC_FOUNDRY_API_KEY`, prägen Sie ein neues `ANTHROPIC_FOUNDRY_AUTH_TOKEN`, oder führen Sie `az login` aus, damit die Standard-Microsoft Entra-Anmeldedaten-Kette sich erneut anmelden kann

1516* Wenn die Anmeldedaten aktuell sind, bestätigen Sie, dass die Identität Zugriff auf die Foundry-Ressource hat. Siehe [Azure RBAC-Konfiguration](/docs/de/microsoft-foundry#azure-rbac-configuration)1624* Wenn die Anmeldedaten aktuell sind, bestätigen Sie, dass die Identität Zugriff auf die Foundry-Ressource hat. Siehe [Azure RBAC-Konfiguration](/docs/de/microsoft-foundry#azure-rbac-configuration)

1517 1625

1518Vor v2.1.273 zeigte ein 401 oder 403 von Microsoft Foundry die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Azure-Anmeldedaten nicht aktualisieren kann.1626Vor v2.1.273 zeigte ein 401 oder 403 von Microsoft Foundry die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Azure-Anmeldedaten nicht aktualisieren kann.

1521 AWS- oder Google Cloud-Anmeldedaten konnten nicht geladen werden1629 AWS- oder Google Cloud-Anmeldedaten konnten nicht geladen werden

1522</h3>1630</h3>

1523 1631

1524Claude Code konnte keine verwendbaren Anmeldedaten aus der AWS-Anmeldedaten-Provider-Chain oder aus Ihren Google-Anwendungsstandardanmeldedaten auf dem Computer, auf dem es ausgeführt wird, erhalten, sodass keine Anfrage Ihren Cloud-Provider erreichte. Claude Code löscht seine zwischengespeicherten Anmeldedaten und versucht zweimal erneut, bevor diese Meldung angezeigt wird. Das Detail nach dem `·` benennt die spezifische Ursache, z. B. eine abgelaufene SSO-Sitzung, fehlende Anwendungsstandardanmeldedaten, die als `Could not load the default credentials` gemeldet werden, oder eine widerrufene Anmeldung, die als `invalid_grant` gemeldet wird:1632Claude Code konnte keine verwendbaren Anmeldedaten von der AWS-Anmeldedaten-Provider-Kette oder von Ihren Google-Standard-Anwendungs-Anmeldedaten auf der Maschine, auf der es läuft, erhalten, sodass keine Anfrage Ihren Cloud-Provider erreichte. Claude Code löscht seine zwischengespeicherten Anmeldedaten und versucht zweimal erneut, bevor diese Meldung angezeigt wird. Das Detail nach dem `·` benennt die spezifische Ursache, z. B. eine abgelaufene SSO-Sitzung, fehlende Standard-Anwendungs-Anmeldedaten, die als `Could not load the default credentials` gemeldet werden, oder eine widerrufene Anmeldung, die als `invalid_grant` gemeldet wird:

1525 1633

1526```text theme={null}1634```text theme={null}

1527API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1635API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.

1532 1640

1533**Was zu tun ist:**1641**Was zu tun ist:**

1534 1642

1535* Führen Sie den Anmeldungsbefehl Ihres Providers aus, z. B. `aws sso login --profile myprofile` oder `gcloud auth application-default login`, dann versuchen Sie es erneut. [Bedrock, Agent Platform oder Foundry-Anmeldedaten werden nicht geladen](/docs/de/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) zeigt, wie Sie die Anmeldedaten außerhalb von Claude Code bestätigen1643* Führen Sie Ihren Provider-Anmeldungs-Befehl aus, z. B. `aws sso login --profile myprofile` oder `gcloud auth application-default login`, dann versuchen Sie es erneut. [Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen](/docs/de/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) zeigt, wie Sie die Anmeldedaten außerhalb von Claude Code bestätigen

1536* Wenn das Detail `AWS default-chain credential resolve timed out` liest, hat die Chain gehangen statt fehlgeschlagen, also folgen Sie stattdessen [AWS-Standard-Chain-Anmeldedaten-Auflösung hat das Zeitlimit überschritten](#aws-default-chain-credential-resolve-timed-out)1644* Wenn das Detail `AWS default-chain credential resolve timed out` liest, ist die Kette hängen geblieben statt fehlgeschlagen, also folgen Sie stattdessen [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)

1537 1645

1538<h3 id="aws-default-chain-credential-resolve-timed-out">1646<h3 id="aws-default-chain-credential-resolve-timed-out">

1539 AWS-Standard-Chain-Anmeldedaten-Auflösung hat das Zeitlimit überschritten1647 AWS default-chain credential resolve timed out

1540</h3>1648</h3>

1541 1649

1542Die AWS-Standard-Anmeldedaten-Provider-Chain hat Anmeldedaten nicht innerhalb von 60 Sekunden produziert, sodass Claude Code die Auflösung gestoppt und die Anfrage fehlgeschlagen hat. Dieses Zeitlimit ist eine Ursache von [AWS- oder Google Cloud-Anmeldedaten konnten nicht geladen werden](#could-not-load-aws-or-google-cloud-credentials). Der Fehler ist lokale Anmeldedaten-Auflösung: die Anfrage erreichte nie [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Claude Code löscht seinen [Anmeldedaten-Cache](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout) und versucht es erneut, bevor dieser Fehler auftritt, sodass die Chain bei wiederholten Versuchen steckengeblieben ist, wenn Sie ihn sehen.1650Die AWS-Standard-Anmeldedaten-Provider-Kette hat keine Anmeldedaten innerhalb von 60 Sekunden erzeugt, sodass Claude Code die Auflösung gestoppt und die Anfrage fehlgeschlagen hat. Dieses Timeout ist eine Ursache von [AWS- oder Google Cloud-Anmeldedaten konnten nicht geladen werden](#could-not-load-aws-or-google-cloud-credentials). Der Fehler ist lokale Anmeldedaten-Auflösung: die Anfrage erreichte nie [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Claude Code löscht seinen [Anmeldedaten-Cache](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout) und versucht erneut, bevor dieser Fehler auftaucht, sodass die Kette zu dem Zeitpunkt, an dem Sie ihn sehen, auf wiederholten Versuchen stecken geblieben ist.

1543 1651

1544```text theme={null}1652```text theme={null}

1545API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1653API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

1546```1654```

1547 1655

1548Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf Eingabe wartet, die er nicht erhalten kann, und ein Container oder eine VM, deren Instance-Metadaten-Dienst (IMDS) nie auf die Probe der Chain antwortet.1656Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf Eingabe wartet, die er nicht erhalten kann, und ein Container oder eine VM, deren Instance-Metadaten-Service (IMDS) die Probe der Kette nie beantwortet.

1549 1657

1550Vor v2.1.267 lautete die Meldung `API Error: AWS default-chain credential resolve timed out`.1658Vor v2.1.267 lautet die Meldung `API Error: AWS default-chain credential resolve timed out`.

1551Vor v2.1.207 ließ eine steckengebliebene Chain die Anfrage auf unbestimmte Zeit warten, statt mit dieser Meldung fehlzuschlagen.1659Vor v2.1.207 ließ eine stecken gebliebene Kette die Anfrage auf unbestimmte Zeit warten statt zu fehlschlagen.

1552 1660

1553**Was zu tun ist:**1661**Was zu tun ist:**

1554 1662

1555* Führen Sie `aws sts get-caller-identity` in der gleichen Shell mit dem gleichen `AWS_PROFILE` aus. Wenn es auch hängt, beheben Sie das Profil; ein `credential_process`-Befehl, der interaktiv auffordert, ist eine häufige Ursache.1663* Führen Sie `aws sts get-caller-identity` in der gleichen Shell mit dem gleichen `AWS_PROFILE` aus. Wenn es auch hängen bleibt, beheben Sie das Profil; ein `credential_process`-Befehl, der interaktiv auffordert, ist eine häufige Ursache.

1556* Schließen Sie den Anmeldeschritt ab, bevor Sie Claude Code starten, z. B. `aws sso login --profile myprofile`, sodass die Chain aus dem lokalen SSO-Cache aufgelöst wird, statt auf einen Browser-Flow zu warten1664* Schließen Sie den Anmeldungs-Schritt ab, bevor Sie Claude Code starten, z. B. `aws sso login --profile myprofile`

1557* Wenn Ihre Chain eine interaktive Anmeldung ausführt, die legitim mehr als 60 Sekunden benötigt, z. B. SSO mit MFA durch einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)1665* Wenn Ihre Kette eine interaktive Anmeldung ausführt, die legitim länger als 60 Sekunden benötigt, z. B. SSO mit MFA durch einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)

1558 1666

1559<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1667<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">

1560 Bedrock-Setup-Verifizierung hat das Zeitlimit überschritten, während auf AWS gewartet wurde1668 Bedrock-Einrichtungs-Überprüfung timed out beim Warten auf AWS

1561</h3>1669</h3>

1562 1670

1563Ein Aufruf an AWS während des [Bedrock-Setup-Assistenten](/docs/de/amazon-bedrock#sign-in-with-bedrock)'s Anmeldedaten-Verifizierung, z. B. die Anmeldedaten-Suche oder die Identitätsprüfung, hat nicht innerhalb der 60-Sekunden-Grenze beendet. Der Assistent stoppt das Warten und schlägt den Verifizierungsschritt fehl:1671Ein Aufruf an AWS während des [Bedrock-Einrichtungs-Assistenten](/docs/de/amazon-bedrock#sign-in-with-bedrock)'s Anmeldedaten-Überprüfung, z. B. die Anmeldedaten-Suche oder die Identitäts-Überprüfung, hat nicht innerhalb des 60-Sekunden-Limits beendet. Der Assistent stoppt das Warten und schlägt den Überprüfungs-Schritt fehl:

1564 1672

1565```text theme={null}1673```text theme={null}

1566Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1674Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

1570 1678

1571Häufige Ursachen sind ein Netzwerk oder Proxy, das Anfragen an AWS staut, einschließlich der SSO-Token-Aktualisierung, und ein Anmeldedaten-Helper, der immer noch auf Eingabe wartet, die Sie nicht sehen können. Erhöhen Sie das Limit nur, wenn der Helper legitim mehr Zeit benötigt.1679Häufige Ursachen sind ein Netzwerk oder Proxy, das Anfragen an AWS staut, einschließlich der SSO-Token-Aktualisierung, und ein Anmeldedaten-Helper, der immer noch auf Eingabe wartet, die Sie nicht sehen können. Erhöhen Sie das Limit nur, wenn der Helper legitim mehr Zeit benötigt.

1572 1680

1573Eine einzelne steckengebliebene Anfrage an AWS kann auch auf ihrem eigenen Pro-Anfrage-Zeitlimit fehlschlagen, das eine kürzere Meldung auf dem gleichen Schritt zeigt:1681Ein einzelner stecken gebliebener Aufruf an AWS kann auch auf seinem eigenen Pro-Anfrage-Timeout fehlschlagen, das eine kürzere Meldung auf dem gleichen Schritt zeigt:

1574 1682

1575```text theme={null}1683```text theme={null}

1576A request to AWS timed out. Check your network and proxy settings, then try again.1684A request to AWS timed out. Check your network and proxy settings, then try again.

1577```1685```

1578 1686

1579Wenn die gleichen Zeitüberschreitungen auf dem Modell-Pin-Schritt auftreten, markiert der Assistent ein Modell als `unreachable` statt eine der beiden Meldungen zu zeigen.1687Wenn die gleichen Timeouts auf dem Modell-Pin-Schritt auftreten, markiert der Assistent ein Modell als `unreachable` statt eine der beiden Meldungen zu zeigen.

1580 1688

1581**Was zu tun ist:**1689**Was zu tun ist:**

1582 1690

1583* Führen Sie `aws sts get-caller-identity` in der gleichen Shell aus. Wenn es auch hängt, ist die Stagnation außerhalb von Claude Code, in Ihrem Netzwerk, Ihrem Proxy oder dem Anmeldedaten-Helper in Ihrem AWS-Profil; beheben Sie das zuerst.1691* Führen Sie `aws sts get-caller-identity` in der gleichen Shell aus. Wenn es auch hängen bleibt, ist der Stau außerhalb von Claude Code, in Ihrem Netzwerk, Ihrem Proxy oder dem Anmeldedaten-Helper in Ihrem AWS-Profil; beheben Sie das zuerst.

1584* Schließen Sie jede interaktive Anmeldung ab, bevor Sie den Assistenten öffnen, z. B. `aws sso login --profile myprofile`1692* Schließen Sie jede interaktive Anmeldung ab, bevor Sie den Assistenten öffnen, z. B. `aws sso login --profile myprofile`

1585* Wenn ein Anmeldedaten-Helper in Ihrem AWS-Profil legitim länger als 60 Sekunden benötigt, um Sie aufzufordern, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)1693* Wenn ein Anmeldedaten-Helper in Ihrem AWS-Profil legitim länger als 60 Sekunden benötigt, um Sie aufzufordern, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)

1586 1694

1588 Cloud-Gateway-Sitzung abgelaufen1696 Cloud-Gateway-Sitzung abgelaufen

1589</h3>1697</h3>

1590 1698

1591Sie haben sich durch ein [Claude apps gateway](/docs/de/claude-apps-gateway) angemeldet, und die auf diesem Computer gespeicherte Gateway-Sitzung ist abgelaufen und konnte nicht erneuert werden, oder das Gateway akzeptiert sie nicht mehr, z. B. nachdem das Gateway's [JWT-Geheimnis rotiert wurde](/docs/de/claude-apps-gateway-deploy#jwt-secret-rotation). Wenn Sie diese Zeile sehen, wenn Sie `claude` interaktiv starten, hat die Sitzung ohne Gateway-Anmeldung geöffnet:1699Sie haben sich durch ein [Claude apps gateway](/docs/de/claude-apps-gateway) angemeldet, und die auf dieser Maschine gespeicherte Gateway-Sitzung ist abgelaufen und konnte nicht erneuert werden, oder das Gateway akzeptiert sie nicht mehr, z. B. nachdem das Gateway's [JWT-Geheimnis rotiert wurde](/docs/de/claude-apps-gateway-deploy#jwt-secret-rotation). Wenn Sie diese Zeile sehen, wenn Sie `claude` interaktiv starten, hat die Sitzung ohne Gateway-Anmeldung geöffnet:

1592 1700

1593```text theme={null}1701```text theme={null}

1594Cloud gateway session expired — run /login to reconnect.1702Cloud gateway session expired — run /login to reconnect.

1596 1704

1597Die gleiche Zeile kann während der Sitzung erscheinen, wenn die Gateway-Anmeldedaten ablaufen und Claude Code sie nicht erneuern kann.1705Die gleiche Zeile kann während der Sitzung erscheinen, wenn die Gateway-Anmeldedaten ablaufen und Claude Code sie nicht erneuern kann.

1598 1706

1599In einem [nicht-interaktiven](/docs/de/headless) Lauf, einer Hintergrund- oder anderen unbeaufsichtigten Sitzung oder einem `claude`-Unterbefehl außer `claude auth` beendet Claude Code statt mit dieser Meldung:1707In einem [nicht-interaktiven](/docs/de/headless) Lauf, einer Hintergrund- oder anderen unbeaufsichtigten Sitzung oder einem `claude`-Unterbefehl außer `claude auth` beendet Claude Code stattdessen mit dieser Meldung, wenn das Gateway die Sitzung nicht mehr akzeptiert:

1600 1708

1601```text theme={null}1709```text theme={null}

1602Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1710Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

1608* Für einen nicht-interaktiven Start starten Sie `claude` in der gleichen Umgebung, führen Sie `/login` aus, dann führen Sie Ihren Befehl erneut aus1716* Für einen nicht-interaktiven Start starten Sie `claude` in der gleichen Umgebung, führen Sie `/login` aus, dann führen Sie Ihren Befehl erneut aus

1609 1717

1610<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1718<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">

1611 Anmeldung hat das Zeitlimit überschritten, während auf Ihre Bestätigung gewartet wurde1719 Anmeldung timed out beim Warten auf Sie, um fortzufahren

1612</h3>1720</h3>

1613 1721

1614Während einer [Claude apps gateway](/docs/de/claude-apps-gateway)-Anmeldung benannte das Gateway das Konto, das sich angemeldet hat, und Claude Code forderte Sie auf, es zu bestätigen, bevor die Anmeldedaten gespeichert wurden. Sie ließen die Bestätigung offen, nachdem die Anmeldung selbst abgelaufen war, und das Gateway gab kein Aktualisierungs-Token aus, das es erneuern konnte, sodass Claude Code nichts speicherte, als Sie fortfuhren:1722Während einer [Claude apps gateway](/docs/de/claude-apps-gateway)-Anmeldung benannte das Gateway das Konto, das sich angemeldet hat, und Claude Code fragte Sie, es zu bestätigen, bevor die Anmeldedaten gespeichert wurden. Sie ließen die Bestätigung offen, nachdem die Anmeldung selbst abgelaufen war, und das Gateway gab keinen Aktualisierungs-Token aus, der sie erneuern konnte, sodass Claude Code nichts speicherte, als Sie fortfuhren:

1615 1723

1616```text theme={null}1724```text theme={null}

1617Sign-in timed out while waiting for you to continue. Try again.1725Sign-in timed out while waiting for you to continue. Try again.

1625 Gateway lehnte die Anfrage ab1733 Gateway lehnte die Anfrage ab

1626</h3>1734</h3>

1627 1735

1628Sie sind durch ein [Claude apps gateway](/docs/de/claude-apps-gateway) angemeldet, und eine Anfrage hat einen 403 zurückgegeben: das Gateway oder das Upstream dahinter hat sie abgelehnt. Die erneute Anmeldung ändert eine Ablehnung nicht, sodass die Meldung auf Ihren Gateway-Administrator zeigt:1736Sie sind über ein [Claude apps gateway](/docs/de/claude-apps-gateway) angemeldet, und eine Anfrage hat einen 403 zurückgegeben: das Gateway, oder das Upstream dahinter, lehnte sie ab. Sich erneut anzumelden ändert eine Ablehnung nicht, sodass die Meldung auf Ihren Gateway-Administrator zeigt:

1629 1737

1630```text theme={null}1738```text theme={null}

1631Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1739Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

1634**Was zu tun ist:**1742**Was zu tun ist:**

1635 1743

1636* Bitten Sie Ihren Gateway-Administrator, die Anfrage nachzuschlagen. Der `API Error:`-Schwanz trägt die Ablehnung, die das Gateway zurückgegeben hat1744* Bitten Sie Ihren Gateway-Administrator, die Anfrage nachzuschlagen. Der `API Error:`-Schwanz trägt die Ablehnung, die das Gateway zurückgegeben hat

1637* Für Administratoren: eine [Zugriffskontrollregel](/docs/de/claude-apps-gateway-config#http-tuning) auf dem Gateway gibt einen 403 zurück, den das [Audit-Protokoll](/docs/de/claude-apps-gateway-deploy#logs) mit seinem Grund aufzeichnet, und eine Upstream-Autorisierungsverweigerung wird pro [Upstream-Fehlermeldungen](/docs/de/claude-apps-gateway-config#upstream-error-messages) weitergeleitet1745* Für Administratoren: eine [Zugriffs-Kontroll-Regel](/docs/de/claude-apps-gateway-config#http-tuning) auf dem Gateway gibt einen 403 zurück, den das [Audit-Protokoll](/docs/de/claude-apps-gateway-deploy#logs) mit seinem Grund aufzeichnet, und eine Upstream-Autorisierungs-Ablehnung wird pro [Upstream-Fehler-Meldungen](/docs/de/claude-apps-gateway-config#upstream-error-messages) weitergeleitet

1638 1746

1639Vor v2.1.273 zeigte ein 403 auf einer Gateway-Sitzung die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, und die erneute Anmeldung löscht die Ablehnung nicht.1747Vor v2.1.273 zeigte ein 403 auf einer Gateway-Sitzung die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, und sich erneut anzumelden löscht die Ablehnung nicht.

1640 1748

1641<h2 id="network-and-connection-errors">1749<h2 id="network-and-connection-errors">

1642 Netzwerk- und Verbindungsfehler1750 Netzwerk- und Verbindungsfehler

1657No internet route — check your connection or VPN (EHOSTUNREACH)1765No internet route — check your connection or VPN (EHOSTUNREACH)

1658Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host1766Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host

1659Connection dropped (ECONNRESET)1767Connection dropped (ECONNRESET)

1660fetch failed

1661Request timed out. Check your internet connection and proxy settings1768Request timed out. Check your internet connection and proxy settings

1662```1769```

1663 1770

1677 1784

1678Wenn `curl` erfolgreich ist, aber Claude Code immer noch fehlschlägt, liegt die Ursache normalerweise in etwas zwischen der Laufzeit und dem Netzwerk, nicht im Netzwerk selbst:1785Wenn `curl` erfolgreich ist, aber Claude Code immer noch fehlschlägt, liegt die Ursache normalerweise in etwas zwischen der Laufzeit und dem Netzwerk, nicht im Netzwerk selbst:

1679 1786

1787* Überprüfen Sie, ob `ANTHROPIC_BASE_URL` gesetzt ist, indem Sie `echo $ANTHROPIC_BASE_URL` ausführen, oder `echo $env:ANTHROPIC_BASE_URL` in PowerShell, und suchen Sie danach im `env`-Block Ihrer [Einstellungsdateien](/docs/de/settings). Wenn es gesetzt ist, sendet Claude Code Modellanfragen an diese Adresse statt an `api.anthropic.com`, daher erzeugt ein veralteter Wert, der auf einen lokalen Proxy oder ein Gateway verweist, das nicht mehr läuft, `Connection refused`, obwohl `curl` die API erreicht. Entfernen Sie ihn aus Ihrem Shell-Profil oder den Einstellungen und starten Sie Claude Code aus einem neuen Terminal.

1680* Unter Linux und WSL überprüfen Sie `/etc/resolv.conf` auf einen unerreichbaren Nameserver. WSL kann insbesondere einen fehlerhaften Resolver vom Host erben.1788* Unter Linux und WSL überprüfen Sie `/etc/resolv.conf` auf einen unerreichbaren Nameserver. WSL kann insbesondere einen fehlerhaften Resolver vom Host erben.

1681* Unter macOS kann ein VPN-Client, der getrennt oder deinstalliert wurde, eine Tunnel-Schnittstelle oder Routing-Regel hinterlassen. Überprüfen Sie `ifconfig` auf veraltete `utun`-Schnittstellen und entfernen Sie die Netzwerkerweiterung des VPN in den Systemeinstellungen.1789* Unter macOS kann ein VPN-Client, der getrennt oder deinstalliert wurde, eine Tunnel-Schnittstelle oder Routing-Regel hinterlassen. Überprüfen Sie `ifconfig` auf veraltete `utun`-Schnittstellen und entfernen Sie die Netzwerkerweiterung des VPN in den Systemeinstellungen.

1682* Docker Desktop und ähnliche Container-Laufzeiten können ausgehenden Datenverkehr abfangen. Beenden Sie diese und versuchen Sie es erneut, um dies auszuschließen.1790* Docker Desktop und ähnliche Container-Laufzeiten können ausgehenden Datenverkehr abfangen. Beenden Sie diese und versuchen Sie es erneut, um dies auszuschließen.

1702 1810

1703* Wenn die Nachricht eine Proxy-Variable benennt, überprüfen Sie, dass ihr Wert auf den richtigen Proxy verweist, und bitten Sie Ihr Netzwerk-Team, HTTPS-Verbindungen durch ihn zum Host in der Nachricht zuzulassen. Siehe [Netzwerkkonfiguration](/docs/de/network-config).1811* Wenn die Nachricht eine Proxy-Variable benennt, überprüfen Sie, dass ihr Wert auf den richtigen Proxy verweist, und bitten Sie Ihr Netzwerk-Team, HTTPS-Verbindungen durch ihn zum Host in der Nachricht zuzulassen. Siehe [Netzwerkkonfiguration](/docs/de/network-config).

1704* Arbeiten Sie die Überprüfungen in [Unable to connect to API](#unable-to-connect-to-api) durch. Der `curl`-Test und die Firewall-Anleitung dort gelten auch für diese Überprüfung.1812* Arbeiten Sie die Überprüfungen in [Unable to connect to API](#unable-to-connect-to-api) durch. Der `curl`-Test und die Firewall-Anleitung dort gelten auch für diese Überprüfung.

1705* Wenn sich Ihre Organisation über ein [Cloud-Gateway](/docs/de/claude-apps-gateway) anmeldet und dieser Fehler beim ersten Ausführen angezeigt wird, aktualisieren Sie auf Claude Code v2.1.247 oder später.

1706* Wenn Ihr Netzwerk offen ist und der Fehler weiterhin besteht, ist Claude Code möglicherweise nicht [in Ihrem Land verfügbar](https://www.anthropic.com/supported-countries)1813* Wenn Ihr Netzwerk offen ist und der Fehler weiterhin besteht, ist Claude Code möglicherweise nicht [in Ihrem Land verfügbar](https://www.anthropic.com/supported-countries)

1707 1814

1708<h3 id="socket-is-closed">1815<h3 id="socket-is-closed">

1744* Lesen Sie die `Response:`-Klausel, um zu sehen, welches System geantwortet hat. Ein HTML-Text, keine Anthropic-Anfrage-ID oder ein benannter Server wie `nginx` oder `cloudflare` bedeutet, dass etwas zwischen Claude Code und der API an seiner Stelle geantwortet hat1851* Lesen Sie die `Response:`-Klausel, um zu sehen, welches System geantwortet hat. Ein HTML-Text, keine Anthropic-Anfrage-ID oder ein benannter Server wie `nginx` oder `cloudflare` bedeutet, dass etwas zwischen Claude Code und der API an seiner Stelle geantwortet hat

1745* Wenn Sie über ein [LLM-Gateway](/docs/de/llm-gateway-connect#troubleshoot-gateway-errors) weiterleiten, testen Sie die Route mit einer direkten Anfrage und beheben Sie den Hop, der die Nicht-API-Antwort zurückgibt1852* Wenn Sie über ein [LLM-Gateway](/docs/de/llm-gateway-connect#troubleshoot-gateway-errors) weiterleiten, testen Sie die Route mit einer direkten Anfrage und beheben Sie den Hop, der die Nicht-API-Antwort zurückgibt

1746* Führen Sie in einem Netzwerk mit einer Anmeldungsseite, wie z. B. Gast-Wi-Fi, die Anmeldung in einem Browser durch und versuchen Sie es erneut1853* Führen Sie in einem Netzwerk mit einer Anmeldungsseite, wie z. B. Gast-Wi-Fi, die Anmeldung in einem Browser durch und versuchen Sie es erneut

1747* Wenn nur die Nicht-Streaming-Route durch Ihr Gateway fehlerhaft ist, setzen Sie [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](/docs/de/env-vars#variables), damit eine Anfrage, die mitten im Stream fehlschlägt, zum normalen Wiederholungspfad geht, anstatt zu diesem Fallback, außer wenn der Streaming-Endpunkt selbst `404` zurückgibt, wo Claude Code immer noch zurückfällt1854* Wenn nur die Nicht-Streaming-Route durch Ihr Gateway fehlerhaft ist, setzen Sie [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](/docs/de/env-vars#variables), um diesen Fallback auszuschalten, außer wenn der Streaming-Endpunkt selbst `404` zurückgibt, wo Claude Code immer noch zurückfällt

1748 1855

1749<h3 id="streaming-response-ended-before-any-complete-data-was-received">1856<h3 id="streaming-response-ended-before-any-complete-data-was-received">

1750 Streaming response ended before any complete data was received1857 Streaming response ended before any complete data was received

1897* Starten Sie eine neue Sitzung mit `claude --remote-control`, um eine neue Remote Control-Sitzung zu erstellen2004* Starten Sie eine neue Sitzung mit `claude --remote-control`, um eine neue Remote Control-Sitzung zu erstellen

1898* Für andere Remote Control-Startup-Meldungen siehe [Remote Control beheben](/docs/de/remote-control#troubleshooting)2005* Für andere Remote Control-Startup-Meldungen siehe [Remote Control beheben](/docs/de/remote-control#troubleshooting)

1899 2006

1900Wenn der Server stattdessen meldet, dass die vorherige Sitzung weg ist, sehen Sie diese Nachricht nicht. Claude Code startet eine neue Sitzung an ihrer Stelle oder zeigt [`Previous session is unavailable — run /remote-control to start a new one`](/docs/de/remote-control#previous-session-is-unavailable), je nach [dem Wiederverbindungsdatensatz der Konversation](/docs/de/remote-control#resume-outcomes). Von v2.1.227 bis v2.1.231 zeigte Claude Code stattdessen eine Nachricht, die mit `Remote Control could not resume the previous session under the current login` beginnt, und [frühere Versionen verhielten sich wieder anders](/docs/de/remote-control#reconnect-history).2007Wenn der Server stattdessen meldet, dass die vorherige Sitzung weg ist, sehen Sie diese Nachricht nicht. Claude Code startet eine neue Sitzung an ihrer Stelle oder zeigt [`Previous session is unavailable — run /remote-control to start a new one`](/docs/de/remote-control#previous-session-is-unavailable).

1901 2008

1902<h3 id="sessions-ended-while-this-machine-was-offline">2009<h3 id="sessions-ended-while-this-machine-was-offline">

1903 Sessions ended while this machine was offline2010 Sessions ended while this machine was offline

1931* Führen Sie `/feedback` aus, um das Transkript mit einer Beschreibung dessen zu senden, was passiert ist. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist2038* Führen Sie `/feedback` aus, um das Transkript mit einer Beschreibung dessen zu senden, was passiert ist. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist

1932* Wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api)2039* Wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api)

1933 2040

2041<h3 id="couldnt-send-feedback">

2042 Couldn't send feedback

2043</h3>

2044

2045Sie haben einen Bericht aus dem [`/feedback`, `/bug` oder `/share`-Dialog](/docs/de/commands#all-commands) gesendet und der Upload zu Anthropic ist fehlgeschlagen. Der Dialog behält Ihren Text, damit Sie es erneut versuchen können.

2046

2047```text theme={null}

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

2049```

2050

2051Der Text nach dem Präfix benennt, was fehlgeschlagen ist:

2052

2053* **`: not signed in. Run /login, then retry.`**: Der Dialog lädt nur hoch, wenn Claude Code beim Öffnen Anthropic-Anmeldedaten gefunden hat, und keine waren zu dem Zeitpunkt, als Sie gesendet haben, nutzbar. Zum Beispiel haben Sie sich auf dieser Maschine in der Zwischenzeit abgemeldet, oder Ihre Anmeldung konnte nicht mehr aktualisiert werden.

2054* **Eine Klammer**: `(server returned <status>)` ist der Antwortcode des Dienstes; `(request timed out)` und `(couldn't reach the service)` sind Netzwerkfehler. Wenn Claude Code keinen Grund benennen kann, fehlt die Klammer.

2055

2056In der [Feedback-Entwurfswarteschlange](/docs/de/tools-reference#sendfeedback-tool-behavior) endet der gleiche Fehler mit `The draft is still queued. Try again later.` statt, und der Entwurf bleibt in der Warteschlange für einen weiteren Versuch.

2057

2058**Was zu tun ist:**

2059

2060* Für die nicht-angemeldete Formulierung führen Sie `/login` aus und senden Sie erneut

2061* Andernfalls senden Sie erneut; wenn auch andere Anfragen fehlschlagen, überprüfen Sie Ihre Netzwerkverbindung und siehe [Unable to connect to API](#unable-to-connect-to-api)

2062* Wenn es weiterhin fehlschlägt, reichen Sie den Bericht unter [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) ein, wie die Nachricht sagt

2063

2064Vor v2.1.281 schlug jeder Versand mit dieser Nachricht fehl, sobald ein Remote Control **Stop** oder eine dringende sitzungsübergreifende Nachricht angekommen war, während der Dialog offen war. Schließen Sie auf diesen Versionen den Dialog, öffnen Sie ihn erneut und senden Sie erneut.

2065

1934<h2 id="request-errors">2066<h2 id="request-errors">

1935 Anfragefehler2067 Anfragefehler

1936</h2>2068</h2>

1937 2069

1938Diese Fehler beziehen sich auf den Inhalt Ihrer Anfrage. Die meisten werden von der API zurückgegeben, nachdem sie die Anfrage abgelehnt hat; einige werden lokal von Claude Code erzeugt, bevor eine Anfrage gesendet wird.2070Diese Fehler beziehen sich auf den Inhalt Ihrer Anfrage. Die meisten kommen von der API zurück, nachdem sie die Anfrage abgelehnt hat; einige werden lokal von Claude Code erzeugt, bevor eine Anfrage gesendet wird.

1939 2071

1940<h3 id="prompt-is-too-long">2072<h3 id="prompt-is-too-long">

1941 Eingabeaufforderung ist zu lang2073 Eingabeaufforderung ist zu lang

1955 2087

1956Die Zeile nennt nur `/clear`, wenn [`DISABLE_COMPACT`](/docs/de/env-vars) gesetzt ist. Längere Formen des Fehlers, wie die unten aufgeführte Komprimierungsfehlform, behalten die Formulierung `Prompt is too long ·` bei. In der `-p`-Ausgabe und dem Transkript bleibt der Text `Prompt is too long`.2088Die Zeile nennt nur `/clear`, wenn [`DISABLE_COMPACT`](/docs/de/env-vars) gesetzt ist. Längere Formen des Fehlers, wie die unten aufgeführte Komprimierungsfehlform, behalten die Formulierung `Prompt is too long ·` bei. In der `-p`-Ausgabe und dem Transkript bleibt der Text `Prompt is too long`.

1957 2089

1958Wenn Sie die automatische Komprimierung in Ihren [Benutzereinstellungen](/docs/de/settings-reference#autocompactenabled) deaktiviert haben, sagt die Zeile auch:2090Wenn Sie die automatische Komprimierung in Ihren [Benutzereinstellungen](/docs/de/settings-reference#autocompactenabled) ausgeschaltet haben, sagt die Zeile auch:

1959 2091

1960```text theme={null}2092```text theme={null}

1961Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on2093Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

1962```2094```

1963 2095

1964Der Schalter **Auto-compact** in `/config` schreibt `autoCompactEnabled` in die Benutzereinstellungen. Der Hinweis wird nur angezeigt, wenn eine `/config`-Änderung wirksam wird. Beispielsweise wird er nicht angezeigt, wenn [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) oder [`DISABLE_COMPACT`](/docs/de/env-vars) die automatische Komprimierung deaktiviert haben. Er wird auch nicht angezeigt, wenn ein Bereich mit höherer Priorität, wie Projekt- oder verwaltete Einstellungen, `autoCompactEnabled` auf `false` setzt. Vor v2.1.235 enthielt die Zeile keinen Hinweis zur automatischen Komprimierung.2096Der Schalter **Auto-compact** in `/config` schreibt `autoCompactEnabled` in die Benutzereinstellungen. Der Hinweis wird nur angezeigt, wenn eine `/config`-Änderung wirksam wird. Beispielsweise wird er nicht angezeigt, wenn [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) oder [`DISABLE_COMPACT`](/docs/de/env-vars) die automatische Komprimierung ausgeschaltet haben. Er wird auch nicht angezeigt, wenn ein höherer Bereich, wie Projekt- oder verwaltete Einstellungen, `autoCompactEnabled` auf `false` setzen. Vor v2.1.235 enthielt die Zeile keinen Hinweis zur automatischen Komprimierung.

1965 2097

1966Amazon Bedrock meldet diese Bedingung als `Input is too long for requested model.`, was Claude Code auf die gleiche Weise behandelt. Vor v2.1.217 erkannte Claude Code die Bedrock-Formulierung nicht, daher wurde die automatische Komprimierung nie ausgelöst und `/compact` schlug mit demselben Fehler fehl.2098Amazon Bedrock meldet diese Bedingung als `Input is too long for requested model.`, was Claude Code auf die gleiche Weise behandelt. Vor v2.1.217 erkannte Claude Code die Bedrock-Formulierung nicht, daher wurde die automatische Komprimierung nie ausgelöst und `/compact` schlug mit dem gleichen Fehler fehl.

1967 2099

1968Ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway-config#upstream-error-messages) meldet diese Bedingung als `capability_rejected: prompt_too_long`, wenn ein Cloud-Upstream die Anfrage in der eigenen Fehlerform des Anbieters ablehnt. Claude Code behandelt das Token genauso wie `Prompt is too long`. Vor v2.1.228 erkannte Claude Code das Token nicht, daher wurde die automatische Komprimierung nicht ausgelöst.2100Ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway-config#upstream-error-messages) meldet diese Bedingung als `capability_rejected: prompt_too_long`, wenn ein Cloud-Upstream die Anfrage in der eigenen Fehlerform des Anbieters ablehnt. Claude Code behandelt das Token gleich wie `Prompt is too long`. Vor v2.1.228 erkannte Claude Code das Token nicht, daher wurde die automatische Komprimierung nicht ausgelöst.

1969 2101

1970Wenn die automatische Komprimierung in dieser Runde ausgeführt wurde und bei einem zugrunde liegenden Fehler fehlgeschlagen ist, wie z. B. ein nicht verfügbares Modell oder ein Authentifizierungsfehler, wird dieser Fehler nach einem Trennzeichen benannt:2102Wenn die automatische Komprimierung in diesem Durchgang ausgeführt wurde und bei einem zugrunde liegenden Fehler fehlgeschlagen ist, wie z. B. ein nicht verfügbares Modell oder ein Authentifizierungsfehler, benennt die Nachricht diesen Fehler nach einem Trennzeichen:

1971 2103

1972```text theme={null}2104```text theme={null}

1973Prompt is too long · automatic compaction failed: <the underlying error>2105Prompt is too long · automatic compaction failed: <the underlying error>

1974```2106```

1975 2107

1976Beheben Sie zunächst den benannten Fehler; `/compact` schlägt mit demselben Fehler fehl, bis Sie dies tun. Vor v2.1.229 zeigte eine fehlgeschlagene automatische Komprimierung `Prompt is too long` ohne die Ursache an.2108Beheben Sie zunächst den benannten Fehler; `/compact` schlägt mit dem gleichen Fehler fehl, bis Sie dies tun. Vor v2.1.229 zeigte eine fehlgeschlagene automatische Komprimierung `Prompt is too long` ohne die Ursache.

1977 2109

1978Wenn die automatische Komprimierung bei diesem Fehler ausgeführt wird, fasst sie normalerweise Ihre ältesten Austausche zusammen und behält die neuesten. Als letzter Ausweg fasst Claude Code anders zusammen:2110Wenn die automatische Komprimierung bei diesem Fehler ausgeführt wird, fasst sie normalerweise Ihre ältesten Austausche zusammen und behält die neuesten. Als letzter Ausweg komprimiert Claude Code anders:

1979 2111

1980* Wenn es keinen ganzen Austausch zusammenfassen kann, behält Claude Code Ihre neueste Eingabeaufforderung wörtlich und fasst alles davor zusammen.2112* Wenn es keinen ganzen Austausch zusammenfassen kann, behält Claude Code Ihre neueste Eingabeaufforderung wörtlich und fasst alles davor zusammen.

1981* In diesem Fall, wenn das Gespräch nicht mit Ihrer Eingabeaufforderung endet, fasst Claude Code stattdessen das gesamte Gespräch zusammen.2113* In diesem Fall fasst Claude Code das gesamte Gespräch zusammen, wenn das Gespräch nicht mit Ihrer Eingabeaufforderung endet.

1982 2114

1983Claude Code überspringt diese Wiederherstellung, wenn der Inhalt, den es weitergeben würde, keine Modellantworte enthält und weniger als etwa 1.000 Token Ihres eigenen Textes, wie z. B. eine kurze Wiederholung nach einem übergroßen Einfügen. Führen Sie `/clear` aus, um neu zu beginnen. Vor v2.1.269 schlug die Komprimierung fehl, wenn sie keinen ganzen Austausch zusammenfassen konnte, daher traf eine Sitzung in diesem Zustand bei jedem Durchgang diesen Fehler erneut.2115Claude Code überspringt diese Wiederherstellung, wenn der Inhalt, den es weitergeben würde, keine Modellantwort enthält und weniger als etwa 1.000 Token Ihres eigenen Textes, wie z. B. einen kurzen erneuten Versuch nach einem zu großen Einfügen. Führen Sie `/clear` aus, um neu zu beginnen. Vor v2.1.269 schlug die Komprimierung fehl, wenn sie keinen ganzen Austausch zusammenfassen konnte, daher traf eine Sitzung in diesem Zustand bei jedem Durchgang diesen Fehler erneut.

1984 2116

1985Ein Gespräch mit nur einem Austausch hat keine früheren Runden zum Zusammenfassen. Wenn die automatische Komprimierung auf einem ausgeführt worden wäre, überspringt Claude Code den Versuch und erklärt stattdessen, was die Anfrage ausfüllt. Wenn die API keine Token-Zählungen in ihrem Fehler meldet, lautet die Meldung:2117Ein Gespräch mit einem einzelnen Austausch hat keine früheren Durchgänge zum Zusammenfassen. Wenn die automatische Komprimierung bei einem ausgeführt würde, überspringt Claude Code den Versuch und erklärt, was stattdessen die Anfrage ausfüllt. Wenn die API keine Token-Zählungen in ihrem Fehler meldet, lautet die Nachricht:

1986 2118

1987```text theme={null}2119```text theme={null}

1988Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.2120Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

1989```2121```

1990 2122

1991Wenn die API Token-Zählungen in ihrem Fehler meldet, vergleicht Claude Code diese mit seiner eigenen Schätzung der Gesprächsgröße, um zu bestimmen, welcher Teil die meiste Anfrage ausmacht: der Inhalt des Gesprächs selbst oder die Systemaufforderung, Werkzeugdefinitionen und Anhang-Inhalte, die Claude Code damit sendet. Wenn der Inhalt des Gesprächs selbst die meiste Anfrage ausmacht, lautet die Meldung:2123Wenn die API Token-Zählungen in ihrem Fehler meldet, vergleicht Claude Code diese mit seiner eigenen Schätzung der Gesprächsgröße, um zu bestimmen, was den größten Teil der Anfrage ausmacht: der eigene Inhalt des Gesprächs oder der System-Prompt, die Tool-Definitionen und der Anhang-Inhalt, den Claude Code damit sendet. Wenn der eigene Inhalt des Gesprächs den größten Teil der Anfrage ausmacht, lautet die Nachricht:

1992 2124

1993```text theme={null}2125```text theme={null}

1994Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).2126Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

1995```2127```

1996 2128

1997Wenn die meiste Anfrage außerhalb des Gesprächs liegt, lautet die Meldung:2129Wenn der größte Teil der Anfrage außerhalb des Gesprächs liegt, lautet die Nachricht:

1998 2130

1999```text theme={null}2131```text theme={null}

2000Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.2132Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

2001```2133```

2002 2134

2003Vor v2.1.162 versuchte Claude Code die Komprimierung trotzdem und zeigte das bloße `Prompt is too long` an, wenn es fehlschlug.2135Vor v2.1.162 versuchte Claude Code die Komprimierung trotzdem und zeigte das bloße `Prompt is too long`, wenn es fehlschlug.

2004 2136

2005**Was zu tun ist:**2137**Was zu tun ist:**

2006 2138

2007* Führen Sie `/compact` aus, um frühere Runden zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen. Wenn `/compact` mit `Not enough messages to compact.` antwortet, ist das Gespräch ein einzelner Austausch ohne frühere Inhalte zum Zusammenfassen, daher wird der Platz von dieser einen Eingabeaufforderung und dem, was Claude Code mit jeder Anfrage sendet, verbraucht: Führen Sie `/clear` aus und senden Sie erneut mit weniger eingefügtem Text oder kleineren Anhängen, oder reduzieren Sie die Werkzeugdefinitionen und Speicherdateien mit den folgenden Schritten2139* Führen Sie `/compact` aus, um frühere Durchgänge zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen. Wenn `/compact` mit `Not enough messages to compact.` antwortet, ist das Gespräch ein einzelner Austausch ohne früheres zum Zusammenfassen, daher wird der Platz von dieser einen Eingabeaufforderung und dem, was Claude Code mit jeder Anfrage sendet, beansprucht: Führen Sie `/clear` aus und senden Sie erneut mit weniger eingefügtem Text oder kleineren Anhängen, oder reduzieren Sie die Tool-Definitionen und Speicherdateien mit den folgenden Schritten

2008* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: Systemaufforderung, Werkzeuge, Speicherdateien und Nachrichten2140* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: System-Prompt, Tools, Speicherdateien und Nachrichten

2009* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Werkzeugdefinitionen aus dem Kontext zu entfernen2141* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Tool-Definitionen aus dem Kontext zu entfernen

2010* Kürzen Sie große `CLAUDE.md`-Speicherdateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/docs/de/memory#path-specific-rules), die nur bei Bedarf geladen werden2142* Kürzen Sie große `CLAUDE.md`-Speicherdateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/docs/de/memory#path-specific-rules), die nur bei Bedarf geladen werden

2011* Subagenten erben jede MCP-Werkzeugdefinition von der übergeordneten Sitzung, was ihr Kontextfenster ausfüllen kann, bevor die erste Runde beginnt. Deaktivieren Sie MCP-Server, die Sie nicht verwenden, bevor Sie Subagenten spawnen.2143* Die automatische Komprimierung ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie sie in `/config` oder mit [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) ausgeschaltet haben, schalten Sie sie wieder ein. Wenn Sie sie ausgeschaltet lassen, führen Sie `/compact` selbst aus, bevor das Fenster voll wird.

2012* Die automatische Komprimierung ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie sie in `/config` oder mit [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) deaktiviert haben, schalten Sie sie wieder ein. Wenn Sie sie deaktiviert lassen, führen Sie `/compact` selbst aus, bevor das Fenster voll wird.

2013 2144

2014Siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window) für eine interaktive Ansicht, wie sich der Kontext ausfüllt.2145Siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.

2015 2146

2016<h3 id="context-exceeds-the-token-limit">2147<h3 id="context-exceeds-the-token-limit">

2017 Kontext überschreitet das Token-Limit2148 Kontext überschreitet das Token-Limit

2018</h3>2149</h3>

2019 2150

2020`/context` zeigt diese Warnung oben in seiner Ausgabe an, wenn das Gespräch das Kontextfenster des Modells überschritten hat. Anfragen schlagen mit [`Prompt is too long`](#prompt-is-too-long) fehl, bis Sie Platz freigeben. Eine interaktive Sitzung zeigt diesen Fehler als die Zeile `Context limit reached` an.2151`/context` zeigt diese Warnung oben in seiner Ausgabe an, wenn das Gespräch das Kontextfenster des Modells überschritten hat. Anfragen schlagen mit [`Prompt is too long`](#prompt-is-too-long) fehl, bis Sie Platz freigeben. Eine interaktive Sitzung zeigt diesen Fehler als die Zeile `Context limit reached`.

2021 2152

2022```text theme={null}2153```text theme={null}

2023Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.2154Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

2024```2155```

2025 2156

2026Wenn das Limit, das Sie überschritten haben, ein Komprimierungsfenster ist, das kleiner als das Kontextfenster des Modells ist, wie z. B. die 200K-Grenze bei 1M-Kontext-Modellen, lautet die Warnung anders. Ein Komprimierungsfenster kann unter dem Kontextfenster des Modells liegen, daher können Anfragen über ihm noch erfolgreich sein.2157Wenn das Limit, das Sie überschritten haben, ein Komprimierungsfenster ist, wie die 200K-Grenze bei 1M-Kontext-Modellen, lautet die Warnung anders. Ein Komprimierungsfenster kann unter dem Kontextfenster des Modells liegen, daher können Anfragen danach immer noch erfolgreich sein.

2027 2158

2028```text theme={null}2159```text theme={null}

2029Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.2160Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

2033 2164

2034**Was zu tun ist:**2165**Was zu tun ist:**

2035 2166

2036* Führen Sie in einem Gespräch mit mehreren Runden `/compact` aus, um frühere Runden zusammenzufassen und Platz freizugeben. Um stattdessen neu zu beginnen, führen Sie `/clear` aus2167* Führen Sie in einem mehrteiligen Gespräch `/compact` aus, um frühere Durchgänge zusammenzufassen und Platz freizugeben. Um stattdessen neu zu beginnen, führen Sie `/clear` aus

2037* Weitere Möglichkeiten zur Reduzierung der Nutzung finden Sie unter [Prompt is too long](#prompt-is-too-long)2168* Weitere Möglichkeiten zur Reduzierung der Nutzung finden Sie unter [Prompt is too long](#prompt-is-too-long)

2038 2169

2039Vor v2.1.216 zeigte `/context` die Nutzung über 100% ohne Warnzeile an, die erklärte, was das bedeutet oder wie man sich erholt.2170Vor v2.1.216 zeigte `/context` die Nutzung über 100% ohne Warnzeile an, die erklärte, was das bedeutet oder wie man sich erholt.

2040 2171

2041<h3 id="error-during-compaction-conversation-too-long">

2042 Fehler während der Komprimierung: Gespräch zu lang

2043</h3>

~~2044~~

2045`/compact` selbst ist fehlgeschlagen, weil nicht genug freier Kontext vorhanden ist, um die Zusammenfassung zu halten, die es erzeugt.

~~2046~~

2047```text theme={null}

2048Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

2049```

~~2050~~

2051Dies kann passieren, wenn das Fenster bereits voll ist, wenn die automatische Komprimierung ausgelöst wird, oder wenn Sie `/compact` ausführen, nachdem Sie [`Prompt is too long`](#prompt-is-too-long) gesehen haben. In einer interaktiven Sitzung ist dieser Fehler die Zeile `Context limit reached`.

~~2052~~

2053**Was zu tun ist:**

~~2054~~

2055* Drücken Sie zweimal Esc, um die Nachrichtenliste zu öffnen und mehrere Runden zurückzugehen. Dies entfernt die neuesten Nachrichten aus dem Kontext. Führen Sie dann `/compact` erneut aus.

2056* Wenn das Zurückgehen nicht genug Platz freigeben kann, führen Sie `/clear` aus, um eine neue Sitzung zu starten. Ihr vorheriges Gespräch wird beibehalten und kann mit `/resume` erneut geöffnet werden.

~~2057~~

2058Diese Meldung und andere `/compact`-Fehler werden in Fehlerformatierung angezeigt. Vor v2.1.216 wurden sie im gleichen schwachen Stil wie erfolgreiche Befehlsausgabe gerendert, daher könnten Sie eine fehlgeschlagene Komprimierung als Erfolg lesen.

~~2059~~

2060<h3 id="request-too-large">2172<h3 id="request-too-large">

2061 Anfrage zu groß2173 Anfrage zu groß

2062</h3>2174</h3>

2063 2175

2064Der rohe Anfragekörper überschritt das 32-MB-Limit der API vor der Tokenisierung, normalerweise wegen großer eingefügter Inhalte, Werkzeugergebnisse oder Anhänge. Dieses Limit ist separat vom [Kontextfenster](#prompt-is-too-long).2176Der rohe Anfragekörper überschritt das 32-MB-Limit der API vor der Tokenisierung, normalerweise wegen großer eingefügter Inhalte, Tool-Ergebnisse oder Anhänge. Dieses Limit ist separat vom [Kontextfenster](#prompt-is-too-long).

2065 2177

2066```text theme={null}2178```text theme={null}

2067Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.2179Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

2068```2180```

2069 2181

2070Wenn die Anfrage direkt zur Claude-API ging und die API selbst sie ablehnte, misst Claude Code das Gespräch und formuliert die Meldung danach, ob die Wiederherstellung funktionieren kann. Über einen Proxy, ein Gateway oder einen Cloud-Anbieter erhalten Sie die allgemeine Meldung. Die gemessenen Formen:2182Wenn die Anfrage direkt zur Claude API ging und die API selbst sie ablehnte, misst Claude Code das Gespräch und formuliert die Nachricht danach, ob die Wiederherstellung funktionieren kann. Über einen Proxy, ein Gateway oder einen Cloud-Anbieter erhalten Sie die allgemeine Nachricht. Die gemessenen Formen:

2071 2183

2072* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: Bilder oder Dokumente haben die Anfrage über das Limit hinausgetrieben. Claude Code versucht es erneut, ohne sie.2184* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: Bilder oder Dokumente haben die Anfrage über das Limit hinausgetrieben. Claude Code versucht es erneut, ohne sie.

2073* `Request too large for the API's 32MB request limit`: Die Nachrichten allein sind über dem Limit, daher sagt die Meldung `compacting cannot make it fit` und Claude Code versucht es nicht erneut. Im [nicht-interaktiven Modus](/docs/de/headless) sagt die Meldung Ihnen, die Eingabe zu reduzieren oder stattdessen eine neue Sitzung zu starten.2185* `Request too large for the API's 32MB request limit`: Die Nachrichten allein sind über dem Limit, daher sagt die Nachricht `compacting cannot make it fit` und Claude Code versucht es nicht erneut. Im [nicht-interaktiven Modus](/docs/de/headless) sagt die Nachricht Ihnen, die Eingabe zu reduzieren oder stattdessen eine neue Sitzung zu starten.

2074 2186

2075Vor v2.1.212 schlugen Gespräche mit genug angesammelten Bildern bei jedem Durchgang mit `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` fehl. Vor v2.1.229 zeigte Claude Code den Anhang-Rat für jede Ablehnung an, auch wenn die Komprimierung nicht helfen konnte.2187Vor v2.1.212 schlugen Gespräche mit genug angesammelten Bildern bei jedem Durchgang mit `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` fehl. Vor v2.1.229 zeigte Claude Code den Anhang-Rat für jede Ablehnung, auch wenn die Komprimierung nicht helfen konnte.

2076 2188

2077**Was zu tun ist:**2189**Was zu tun ist:**

2078 2190

2079* Wenn die Meldung sagt `compacting cannot make it fit`, drücken Sie zweimal Esc, um über die Runde zurückzugehen, die den großen Inhalt hinzugefügt hat, oder führen Sie `/clear` aus, um neu zu beginnen2191* Wenn die Nachricht sagt `compacting cannot make it fit`, drücken Sie zweimal Esc, um zum Durchgang vor dem zurückzugehen, der den großen Inhalt hinzugefügt hat, oder führen Sie `/clear` aus, um neu zu beginnen

2080* Führen Sie andernfalls `/compact` aus, das angesammelte Bilder und Anhänge entfernt2192* Führen Sie andernfalls `/compact` aus, was angesammelte Bilder und Anhänge entfernt

2081* Referenzieren Sie große Dateien nach Pfad, anstatt ihren Inhalt einzufügen, damit Claude sie in Chunks lesen kann2193* Referenzieren Sie große Dateien nach Pfad, anstatt ihren Inhalt einzufügen, damit Claude sie in Chunks lesen kann

2082* Für Bilder siehe [Bild war zu groß](#image-was-too-large) unten2194* Für Bilder siehe [Bild war zu groß](#image-was-too-large) unten

2083 2195

2092API Error: 400 ... image dimensions exceed max allowed size2204API Error: 400 ... image dimensions exceed max allowed size

2093```2205```

2094 2206

2095Claude Code ersetzt das nicht verarbeitbare Bild durch einen Textplatzhalter und versucht es erneut, daher sind nachfolgende Nachrichten erfolgreich. In Versionen vor 2.1.142 konnte ein eingefügtes Bild im Gespräch bleiben und denselben Fehler bei jeder nachfolgenden Nachricht wiederholen. Um sich auf diesen Versionen zu erholen, drücken Sie zweimal Esc und gehen Sie über die Runde zurück, in der das Bild hinzugefügt wurde.2207Claude Code ersetzt das nicht verarbeitbare Bild durch einen Text-Platzhalter und versucht es erneut, daher sind nachfolgende Nachrichten erfolgreich. In Versionen vor 2.1.142 konnte ein eingefügtes Bild im Gespräch bleiben und denselben Fehler bei jeder nachfolgenden Nachricht wiederholen. Um sich auf diesen Versionen zu erholen, drücken Sie zweimal Esc und gehen Sie zum Durchgang zurück, in dem das Bild hinzugefügt wurde.

2096 2208

2097**Was zu tun ist:**2209**Was zu tun ist:**

2098 2210

2099* Ändern Sie die Größe des Bildes, bevor Sie es einfügen. Die API akzeptiert Bilder bis zu 8000 Pixeln auf der längsten Kante für ein einzelnes Bild oder 2000 Pixel, wenn viele Bilder im Kontext sind.2211* Ändern Sie die Größe des Bildes vor dem Einfügen. Die API akzeptiert Bilder bis zu 8000 Pixeln auf der längsten Kante für ein einzelnes Bild oder 2000 Pixel, wenn viele Bilder im Kontext sind.

2100* Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms2212* Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms

2101 2213

2102<h3 id="unable-to-resize-image">2214<h3 id="unable-to-resize-image">

2103 Bild konnte nicht in der Größe geändert werden2215 Bild konnte nicht verkleinert werden

2104</h3>2216</h3>

2105 2217

2106Claude Code konnte ein angehängtes Bild nicht herunterskalieren, bevor es zur API gesendet wurde.2218Claude Code konnte ein angehängtes Bild nicht herunterskalieren, bevor es zur API gesendet wurde.

2115Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.2227Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

2116```2228```

2117 2229

2118Claude Code ändert normalerweise die Größe großer Bilder automatisch. Diese Fehler bedeuten, dass das Bild nicht dekodiert oder in der Größe geändert werden konnte, um in die API-Limits zu passen.2230Claude Code verkleinert normalerweise große Bilder automatisch. Diese Fehler bedeuten, dass das Bild nicht dekodiert oder verkleinert werden konnte, um in die API-Limits zu passen.

2119 2231

2120**Was zu tun ist:**2232**Was zu tun ist:**

2121 2233

2122* Wenn die Meldung Sie auffordert, das Bild zu konvertieren, konvertieren Sie es in PNG, JPEG, GIF oder WebP und hängen Sie es erneut an. Claude Code kann Dimensionen für diese Formate überprüfen, ohne das Bild zu dekodieren.2234* Wenn die Nachricht Sie auffordert, das Bild zu konvertieren, konvertieren Sie es zu PNG, JPEG, GIF oder WebP und hängen Sie es erneut an. Claude Code kann Dimensionen für diese Formate aus dem Datei-Header überprüfen, ohne das Bild zu dekodieren.

2123* Wenn die Meldung ein Dimensions- oder Größenlimit meldet, ändern Sie die Größe oder komprimieren Sie das Bild unter diesem Limit, bevor Sie es anhängen.2235* Wenn die Nachricht ein Dimensions- oder Größenlimit meldet, ändern Sie die Größe oder komprimieren Sie das Bild unter diesem Limit, bevor Sie es anhängen.

2124* Wenn die Meldung eine Ursache nennt, wie z. B. ein CMYK JPEG, ein animiertes WebP oder eine möglicherweise beschädigte Datei, speichern Sie das Bild in dem Format, das die Meldung vorschlägt, und hängen Sie es erneut an.2236* Wenn die Nachricht eine Ursache benennt, wie z. B. ein CMYK JPEG, ein animiertes WebP oder eine möglicherweise beschädigte Datei, speichern Sie das Bild im Format, das die Nachricht vorschlägt, und hängen Sie es erneut an.

2125 2237

2126<h3 id="pdf-errors">2238<h3 id="pdf-errors">

2127 PDF-Fehler2239 PDF-Fehler

2128</h3>2240</h3>

2129 2241

2130Das PDF, das Sie angehängt haben, konnte nicht verarbeitet werden. Die Meldungen werden hier in ihrer nicht-interaktiven Form angezeigt; in einer interaktiven Sitzung fordern sie Sie stattdessen auf, zweimal Esc zu drücken und es erneut zu versuchen.2242Das PDF, das Sie angehängt haben, konnte nicht verarbeitet werden. Die Nachrichten werden hier in ihrer nicht-interaktiven Form angezeigt; in einer interaktiven Sitzung fordern sie Sie stattdessen auf, zweimal Esc zu drücken und es erneut zu versuchen.

2131 2243

2132```text theme={null}2244```text theme={null}

2133PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).2245PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).

2137 2249

2138**Was zu tun ist:**2250**Was zu tun ist:**

2139 2251

2140* Für übergroße PDFs bitten Sie Claude, einen Seitenbereich mit dem Read-Werkzeug zu lesen, anstatt die ganze Datei anzuhängen, oder extrahieren Sie Text mit einem Werkzeug wie `pdftotext` und referenzieren Sie die Ausgabedatei nach Pfad2252* Für zu große PDFs bitten Sie Claude, einen Seitenbereich mit dem Read-Tool zu lesen, anstatt die ganze Datei anzuhängen, oder extrahieren Sie Text mit einem Tool wie `pdftotext` und referenzieren Sie die Ausgabedatei nach Pfad

2141* Für geschützte oder ungültige PDFs entfernen Sie das Passwort oder exportieren Sie die Datei erneut aus ihrer Quellanwendung, dann versuchen Sie es erneut2253* Für geschützte oder ungültige PDFs entfernen Sie das Passwort oder exportieren Sie die Datei erneut aus ihrer Quellanwendung, dann versuchen Sie es erneut

2142 2254

2255Wenn Claude einen Seitenbereich aus einem PDF mit dem Read-Tool liest, kann der Lesevorgang mit einer anderen Nachricht fehlschlagen:

2256

2257```text theme={null}

2258pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.

2259```

2260

2261Seitenbereich-Lesevorgänge rendern Seiten mit `pdftoppm`. Installieren Sie poppler-utils mit dem Befehl, den die Nachricht gibt, oder auf anderen Plattformen einen poppler-Build, der `pdftoppm` auf Ihren `PATH` setzt. Siehe [Read-Tool-Verhalten](/docs/de/tools-reference#read-tool-behavior) für welche PDFs nach Seitenbereich gelesen werden.

2262

2143<h3 id="extra-inputs-are-not-permitted">2263<h3 id="extra-inputs-are-not-permitted">

2144 Zusätzliche Eingaben sind nicht zulässig2264 Zusätzliche Eingaben sind nicht zulässig

2145</h3>2265</h3>

2146 2266

2147Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den `anthropic-beta`-Anfragekopf entfernt, daher lehnte die API Felder ab, die davon abhängen.2267Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den `anthropic-beta`-Request-Header entfernt, daher lehnte die API Felder ab, die davon abhängen.

2148 2268

2149```text theme={null}2269```text theme={null}

2150API Error: 400 ... Extra inputs are not permitted ... context_management2270API Error: 400 ... Extra inputs are not permitted ... context_management

2151API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

2152```2271```

2153 2272

2154Claude Code sendet Beta-only-Felder wie `context_management` und `effort` zusammen mit einem `anthropic-beta`-Kopf, der sie aktiviert. Wenn ein Gateway den Körper weiterleitet, aber den Kopf entfernt, sieht die API Felder, die sie nicht erkennt.2273Claude Code sendet Beta-only-Felder wie `context_management` und `effort` zusammen mit einem `anthropic-beta`-Header, der sie aktiviert. Wenn ein Gateway den Body weiterleitet, aber den Header entfernt, sieht die API Felder, die sie nicht erkennt.

2155 2274

2156**Was zu tun ist:**2275**Was zu tun ist:**

2157 2276

2158* Konfigurieren Sie Ihr Gateway, um den `anthropic-beta`-Kopf weiterzuleiten. Siehe [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through) für das, was Gateways weiterleiten müssen.2277* Konfigurieren Sie Ihr Gateway, um den `anthropic-beta`-Header weiterzuleiten. Siehe [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through) für das, was Gateways weiterleiten müssen.

2159* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/de/env-vars) vor dem Start. [Deaktivieren Sie Pre-Release-Funktionen](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) behandelt den genauen Umfang.2278* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/de/env-vars) vor dem Start. [Deaktivieren Sie Pre-Release-Funktionen](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) behandelt den genauen Umfang.

2160 2279

2161<h3 id="tool-input-schema-is-invalid">2280<h3 id="tool-input-schema-is-invalid">

2162 Werkzeug-Eingabeschema ist ungültig2281 Tool-Input-Schema ist ungültig

2163</h3>2282</h3>

2164 2283

2165Ein Werkzeug in der Anfrage deklarierte ein `input_schema`, das die JSON-Schema-Validierung der API nicht besteht, daher lehnte die API die ganze Anfrage ab. Die Nummer nach `tools.` ist die Position des fehlgeschlagenen Werkzeugs in der Werkzeugliste der Anfrage, nicht ein Name, den Sie nachschlagen können.2284Ein Tool in der Anfrage deklarierte ein `input_schema`, das die JSON-Schema-Validierung der API nicht besteht, daher lehnte die API die gesamte Anfrage ab. Die Nummer nach `tools.` ist die Position des fehlgeschlagenen Tools in der Tool-Liste der Anfrage, nicht ein Name, den Sie nachschlagen können.

2166 2285

2167```text theme={null}2286```text theme={null}

2168API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid2287API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid

2169API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'2288API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'

2170```2289```

2171 2290

2172Die erste Form bedeutet, dass das Schema nicht gültiges JSON Schema draft 2020-12 ist. Die zweite bedeutet, dass ein Eigenschaftsname auf oberster Ebene nicht dem Muster entspricht, das die Meldung zitiert.2291Die erste Form bedeutet, dass das Schema kein gültiges JSON Schema Draft 2020-12 ist. Die zweite bedeutet, dass ein Name einer Top-Level-Eigenschaft nicht dem Muster entspricht, das die Nachricht angibt.

2173 2292

2174Claude Code [schließt MCP-Werkzeuge aus, deren Eingabeschema diese Validierung nicht bestehen würde](/docs/de/mcp#tools-with-invalid-input-schemas), wenn es die Werkzeuge eines Servers lädt, daher enthalten Anfragen normalerweise nie eines.2293Claude Code [schließt MCP-Tools aus, deren Input-Schema diese Validierung nicht bestehen würde](/docs/de/mcp#tools-with-invalid-input-schemas), wenn es die Tools eines Servers lädt, daher enthalten Anfragen normalerweise nie eines.

2175 2294

2176Auf einer [Bereitstellung, bei der das Flag-Abrufen ausgeschaltet ist](/docs/de/env-vars#features-that-need-feature-flag-fetching), oder auf einer Maschine, deren Flags nie angekommen sind, zeichnet Claude Code im Serverprotokoll auf, welches Werkzeug abgelehnt würde, sendet es aber trotzdem, daher kann dieser Fehler immer noch auftreten.2295Bei einer [Bereitstellung, bei der das Flag-Abrufen ausgeschaltet ist](/docs/de/env-vars#features-that-need-feature-flag-fetching), oder auf einem Computer, dessen Flags nie angekommen sind, zeichnet Claude Code im Server-Log auf, welches Tool abgelehnt würde, sendet es aber trotzdem, daher kann dieser Fehler immer noch auftreten.

2177 2296

2178Der Fehler kann auch für ein Werkzeug auftreten, dessen Schema ein JSON-Schema-Dialekt deklariert, der nicht draft 2020-12 in `$schema` ist. Claude Code überprüft diese Schemas nicht gegen das JSON-Schema-Meta-Schema, obwohl die Überprüfung des Eigenschaftsnamens auf oberster Ebene immer noch gilt.2297Der Fehler kann auch für ein Tool auftreten, dessen Schema einen anderen JSON-Schema-Dialekt als Draft 2020-12 in `$schema` deklariert. Claude Code überprüft diese Schemas nicht gegen die JSON-Schema-Meta-Schema, obwohl die Top-Level-Eigenschaftsnamen-Überprüfung immer noch gilt.

2179 2298

2180Vor v2.1.216 führte keine Bereitstellung die Ausschlussüberprüfungen durch.2299Vor v2.1.216 führte keine Bereitstellung die Ausschluss-Überprüfungen durch.

2181 2300

2182**Was zu tun ist:**2301**Was zu tun ist:**

2183 2302

2184* Wenn Ihre Claude-Code-Version älter als v2.1.216 ist, führen Sie `claude update` aus.2303* Wenn Ihre Claude Code-Version älter als v2.1.216 ist, führen Sie `claude update` aus.

2185* Entfernen oder [deaktivieren](/docs/de/mcp#disable-a-server-without-removing-it) Sie den MCP-Server, der das ungültige Schema deklariert. Der Fehler nennt das Werkzeug nur nach Position. Auf v2.1.216 oder später überprüfen Sie das Protokoll jedes Servers auf eine Zeile, die ein Werkzeug nennt, dessen Eingabeschema abgelehnt würde. Wenn kein Protokoll eines nennt, deaktivieren Sie Server nacheinander.2304* Entfernen oder [deaktivieren](/docs/de/mcp#disable-a-server-without-removing-it) Sie den MCP-Server, der das ungültige Schema deklariert. Der Fehler benennt das Tool nur nach Position. Auf v2.1.216 oder später überprüfen Sie das Log jedes Servers auf eine Zeile, die ein Tool benennt, dessen Input-Schema abgelehnt würde. Wenn kein Log eines benennt, deaktivieren Sie Server nacheinander.

2186* Wenn Sie den Server verwalten, beheben Sie das `input_schema` des Werkzeugs. Das Schema muss gültiges JSON-Schema sein, und Eigenschaftsnamen auf oberster Ebene müssen 1 bis 64 Zeichen lang sein und nur ASCII-Buchstaben und Ziffern, `_`, `.` und `-` verwenden. Siehe [Werkzeuge mit ungültigen Eingabeschemas](/docs/de/mcp#tools-with-invalid-input-schemas).2305* Wenn Sie den Server verwalten, beheben Sie das `input_schema` des Tools. Das Schema muss gültiges JSON Schema sein, und Top-Level-Eigenschaftsnamen müssen 1 bis 64 Zeichen lang sein und nur ASCII-Buchstaben und Ziffern, `_`, `.` und `-` verwenden. Siehe [Tools mit ungültigen Input-Schemas](/docs/de/mcp#tools-with-invalid-input-schemas).

2306

2307<h3 id="tool-use-name-over-200-characters">

2308 tool\_use.name über 200 Zeichen

2309</h3>

2310

2311Ein Tool-Aufruf in der Gesprächshistorie trägt einen Namen, der länger als die 200 Zeichen ist, die die API in einer Anfrage akzeptiert:

2312

2313```text theme={null}

2314API Error: 400 ... tool_use.name: String should have at most 200 characters

2315```

2316

2317Claude Code kürzt solch einen Namen auf 200 Zeichen, wenn die Antwort ankommt und wenn es ein gespeichertes Gespräch lädt, daher schlägt der Aufruf mit einem gewöhnlichen `No such tool available`-Tool-Fehler fehl und das Gespräch wird ohne diesen API-Fehler fortgesetzt.

2318

2319**Was zu tun ist:**

2320

2321* Führen Sie `claude update` aus, dann setzen Sie das Gespräch fort. Die aktualisierte Version repariert den übergroßen Namen, wenn sie das Transkript lädt, daher funktioniert ein Gespräch, das steckengeblieben war, wieder.

2322

2323Vor v2.1.281 blieb der übergroße Name in der Historie und die API lehnte jede Anfrage ab, die das Gespräch erneut sendete, einschließlich `/compact` und `--resume`, daher wiederholte sich dieser Fehler und das Gespräch war steckengeblieben.

2187 2324

2188<h3 id="theres-an-issue-with-the-selected-model">2325<h3 id="theres-an-issue-with-the-selected-model">

2189 Es gibt ein Problem mit dem ausgewählten Modell2326 Es gibt ein Problem mit dem ausgewählten Modell

2199 2336

2200* **Interaktive CLI**: Führen Sie `/model` aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.2337* **Interaktive CLI**: Führen Sie `/model` aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.

2201* **Nicht-interaktiver Modus (`-p`)**: Übergeben Sie `--model` mit einem gültigen Alias oder einer ID, oder setzen Sie [`ANTHROPIC_MODEL`](/docs/de/env-vars). Der Fehlertext zeigt `Run --model` auf dieser Oberfläche.2338* **Nicht-interaktiver Modus (`-p`)**: Übergeben Sie `--model` mit einem gültigen Alias oder einer ID, oder setzen Sie [`ANTHROPIC_MODEL`](/docs/de/env-vars). Der Fehlertext zeigt `Run --model` auf dieser Oberfläche.

2202* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/docs/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/docs/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihre eigene Wiederholung oder Modellauswahl anzuzeigen.2339* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/docs/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/docs/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.

2203* Verwenden Sie einen Alias wie `sonnet` oder `opus` statt einer vollständigen versionierten ID. Aliase werden zu einem verwalteten Standard aufgelöst, daher werden sie nicht veraltet. Siehe [Modellkonfiguration](/docs/de/model-config).2340* Verwenden Sie einen Alias wie `sonnet` oder `opus` statt einer vollständigen versionierten ID. Aliase werden zu einem verwalteten Standard aufgelöst, daher werden sie nicht veraltet. Siehe [Modellkonfiguration](/docs/de/model-config).

2204* Wenn das falsche Modell in der CLI immer wieder zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie die Orte, an denen Sie ein Modell in [Prioritätsreihenfolge](/docs/de/model-config#setting-your-model) setzen können, und entfernen Sie den veralteten Wert.2341* Wenn das falsche Modell in der CLI immer wieder zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie die Orte, an denen Sie ein Modell in [Prioritätsreihenfolge](/docs/de/model-config#setting-your-model) setzen können, und entfernen Sie den veralteten Wert.

2205* Ein neu gestartetes Modell kann auf der Anthropic-API verfügbar sein, bevor Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry es anbietet. Wenn Sie eine neue Modell-ID auf einem dieser Anbieter angeheftet haben und diesen Fehler sehen, überprüfen Sie den Modellkatalog Ihres Anbieters auf Verfügbarkeit in Ihrer Region, und behalten Sie die vorherige Version angeheftet, bis die neue dort erscheint.

2206* Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als dieser Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das auf einer älteren Version sehen.2342* Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als dieser Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das auf einer älteren Version sehen.

2207* Für Google Clouds Agent Platform-Bereitstellungen siehe [Google Cloud Agent Platform-Fehlerbehebung](/docs/de/google-vertex-ai#troubleshooting).2343* Für Google Clouds Agent Platform-Bereitstellungen siehe [Google Clouds Agent Platform-Fehlerbehebung](/docs/de/google-vertex-ai#troubleshooting).

2208 2344

2209<h3 id="model-is-not-a-recognized-model-id">2345<h3 id="model-is-not-a-recognized-model-id">

2210 Modell ist keine erkannte Modell-ID2346 Modell ist keine erkannte Modell-ID

2211</h3>2347</h3>

2212 2348

2213Die Modellzeichenkette, die Sie an einen Modellwechsel übergeben haben, ist kein Modellalias, keine Modell-ID, die diese Claude-Code-Version kennt, oder keine ID, die mit `claude-` beginnt. Die üblichen Ursachen sind ein Tippfehler in der ID, ein Anzeigename wie `Sonnet 5`, bei dem die ID `claude-sonnet-5` erwartet wird, oder ein Alias, den nur neuere Claude-Code-Versionen erkennen. Claude Code lehnt den Wechsel sofort ab. Vor v2.1.200 speicherte Claude Code die Zeichenkette und schlug bei der nächsten Anfrage mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) fehl.2349Die Modellzeichenkette, die Sie an einen Modellwechsel übergeben haben, ist kein Modellalias, keine Modell-ID, die diese Claude Code-Version kennt, oder keine ID, die mit `claude-` beginnt. Die üblichen Ursachen sind ein Tippfehler in der ID, ein Anzeigename wie `Sonnet 5`, wo die ID `claude-sonnet-5` erwartet wird, oder ein Alias, den nur neuere Claude Code-Versionen erkennen. Claude Code lehnt den Wechsel sofort ab. Vor v2.1.200 speicherte Claude Code die Zeichenkette und schlug bei der nächsten Anfrage mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) fehl.

2214 2350

2215```text theme={null}2351```text theme={null}

2216Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2352Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2217```2353```

2218 2354

2219Der nachfolgende Hinweis nennt den nächsten passenden Alias oder die nächste Modell-ID. Wenn nichts nah genug ist, lautet es stattdessen `Run /model to see available models.`2355Der nachfolgende Hinweis benennt den nächsten passenden Alias oder die nächste Modell-ID. Wenn nichts nah genug ist, lautet er stattdessen `Run /model to see available models.` In einer Sitzung, die die [Desktop-App](/docs/de/desktop) für Sie startet, lautet der Hinweis ohne Übereinstimmung `Switch to a different model.`

2220 2356

2221Claude Code erzeugt diesen Fehler lokal in dem Moment, in dem der Wechsel angefordert wird, bevor eine API-Anfrage gestellt wird. Er gilt, wenn ein Modell durch die [Agent SDK](/docs/de/agent-sdk/typescript) `setModel()`-Methode, durch eine App wie die [Desktop-App](/docs/de/desktop), die die Claude-Code-CLI für Sie ausführt, oder wenn Sie ein Modell von einem Gerät auswählen, das über [Remote Control](/docs/de/remote-control) verbunden ist, gesetzt wird. Vor v2.1.260 deckte die Überprüfung Remote Control-Auswahlen nicht ab, daher wendete Claude Code die Auswahl an und die nächste Anfrage schlug mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) fehl.2357Claude Code erzeugt diesen Fehler lokal in dem Moment, in dem der Wechsel angefordert wird, bevor eine API-Anfrage gestellt wird. Er gilt, wenn ein Modell durch die [Agent SDK](/docs/de/agent-sdk/typescript) `setModel()`-Methode gesetzt wird, durch eine App wie die [Desktop-App](/docs/de/desktop), die die Claude Code CLI für Sie ausführt, oder wenn Sie ein Modell von einem Gerät auswählen, das über [Remote Control](/docs/de/remote-control) verbunden ist. Vor v2.1.260 deckte die Überprüfung Remote Control-Auswahlen nicht ab, daher wendete Claude Code die Auswahl an und die nächste Anfrage schlug mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) fehl.

2222 2358

2223**Was zu tun ist:**2359**Was zu tun ist:**

2224 2360

2225* Führen Sie `/model` ohne Argument aus, um die Auswahl zu öffnen und aus den Modellen auszuwählen, die für Ihr Konto verfügbar sind, dann übergeben Sie den dort angezeigten Alias oder die ID2361* Führen Sie `/model` ohne Argument aus, um den Wähler zu öffnen und aus den Modellen auszuwählen, die für Ihr Konto verfügbar sind, dann übergeben Sie den dort angezeigten Alias oder die ID

2226* Wenn Sie einen Alias verwendet haben, den eine neuere Claude-Code-Version unterstützt, führen Sie `claude update` aus. Eine vollständige ID, die mit `claude-` beginnt, besteht diese lokale Überprüfung, auch wenn das Modell neuer als Ihre Claude-Code-Version ist. Der Server kann immer noch eine Mindestversion für dieses Modell erfordern; siehe [Claude Code unterstützt dieses Modell nicht](#claude-code-does-not-support-this-model).2362* Wenn Sie einen Alias verwendet haben, den eine neuere Claude Code-Version unterstützt, führen Sie `claude update` aus. Eine vollständige ID, die mit `claude-` beginnt, besteht diese lokale Überprüfung, auch wenn das Modell neuer als Ihre Claude Code-Version ist. Der Server kann immer noch eine Mindestversion für dieses Modell erfordern; siehe [Claude Code unterstützt dieses Modell nicht](#claude-code-does-not-support-this-model).

2227* Ein Modell, das vor v2.1.200 gespeichert wurde, wird durch diese Überprüfung nicht repariert. Wenn ein veralteter Wert immer wieder zurückkommt, entfernen Sie ihn aus den unter [Setzen Sie Ihr Modell](/docs/de/model-config#setting-your-model) aufgelisteten Orten.2363* Ein Modell, das vor v2.1.200 gespeichert wurde, wird durch diese Überprüfung nicht repariert. Wenn ein veralteter Wert immer wieder zurückkommt, entfernen Sie ihn aus den unter [Setzen Sie Ihr Modell](/docs/de/model-config#setting-your-model) aufgelisteten Orten.

2228* Die Überprüfung wird nur auf der Anthropic-API ausgeführt. Auf jedem anderen Anbieter oder Gateway, einschließlich eines benutzerdefinierten `ANTHROPIC_BASE_URL`, definiert der Anbieter die Modellnamen, daher akzeptiert Claude Code jede Zeichenkette und leitet sie durch. Claude Code kann immer noch die [nicht erkannte Modell-Diagnosezeile](#unrecognized-model-id-on-a-request) zur Anfragetime auf jedem Anbieter schreiben.2364* Die Überprüfung wird nur auf der Anthropic API ausgeführt. Bei jedem anderen Anbieter oder Gateway, einschließlich einer benutzerdefinierten `ANTHROPIC_BASE_URL`, definiert der Anbieter die Modellnamen, daher akzeptiert Claude Code jede Zeichenkette und leitet sie durch. Claude Code kann immer noch die [nicht erkannte Modell-Diagnosezeile](#unrecognized-model-id-on-a-request) zur Anfragzeit auf jedem Anbieter schreiben.

2229 2365

2230<h3 id="model-not-found">2366<h3 id="model-not-found">

2231 Modell nicht gefunden2367 Modell nicht gefunden

2232</h3>2368</h3>

2233 2369

2234Sie haben ein Modell mit `/model <name>` ausgewählt und Claude Code konnte nicht bestätigen, dass ein Modell mit diesem Namen existiert. Wenn der Name kein [Modellalias](/docs/de/model-config#model-aliases) oder eine andere Schreibweise ist, die Claude Code lokal akzeptiert, überprüft `/model` ihn mit einer minimalen API-Anfrage, und dieser Fehler ist normalerweise die Antwort Ihres API-Endpunkts. Ein Name, der überhaupt keine Modell-ID sein kann, wie einer mit Leerzeichen, erhält die gleiche Meldung.2370Sie haben ein Modell mit `/model <name>` ausgewählt und Claude Code konnte nicht bestätigen, dass ein Modell mit diesem Namen existiert. Wenn der Name kein [Modellalias](/docs/de/model-config#model-aliases) oder eine andere Schreibweise ist, die Claude Code lokal akzeptiert, überprüft `/model` es mit einer minimalen API-Anfrage, und dieser Fehler ist normalerweise die Antwort Ihres API-Endpunkts. Ein Name, der überhaupt keine Modell-ID sein kann, wie einer mit Leerzeichen, erhält die gleiche Nachricht.

2235 2371

2236```text theme={null}2372```text theme={null}

2237Model 'claude-opus-9' not found2373Model 'claude-opus-9' not found

2238```2374```

2239 2375

2240Bei Anbietern mit anbieterspezifischen Modell-IDs kann die Meldung einen `Try '...' instead`-Vorschlag hinzufügen, der die ID Ihres Anbieters für ein Fallback-Modell nennt.2376Bei Anbietern mit anbieter-spezifischen Modell-IDs kann die Nachricht einen `Try '...' instead`-Vorschlag hinzufügen, der die ID Ihres Anbieters für ein Fallback-Modell benennt.

2241 2377

2242**Was zu tun ist:**2378**Was zu tun ist:**

2243 2379

2244* Führen Sie `/model` ohne Argument aus und wählen Sie aus den Modellen, die für Ihr Konto verfügbar sind, oder verwenden Sie einen [Modellalias](/docs/de/model-config#model-aliases) wie `sonnet`, der zu einem verwalteten Standard aufgelöst wird2380* Führen Sie `/model` ohne Argument aus und wählen Sie aus den Modellen, die für Ihr Konto verfügbar sind, oder verwenden Sie einen [Modellalias](/docs/de/model-config#model-aliases) wie `sonnet`, der zu einem verwalteten Standard aufgelöst wird

2245* Wenn Sie eine vollständige ID eingegeben haben, überprüfen Sie sie gegen den Modellkatalog Ihres Anbieters. Ein neu gestartetes Modell kann auf der Anthropic-API verfügbar sein, bevor Ihr Anbieter oder Ihre Region es anbietet.2381* Wenn Sie eine vollständige ID eingegeben haben, überprüfen Sie sie gegen den Modellkatalog Ihres Anbieters. Ein neu gestartetes Modell kann auf der Anthropic API verfügbar sein, bevor Ihr Anbieter oder Ihre Region es anbietet.

2246* Vor v2.1.265 lehnte `/model` auch die `opusplan[1m]`-Alias-Schreibweise mit diesem Fehler ab. Auf diesen Versionen aktualisieren Sie Claude Code, oder setzen Sie das Modell in [Einstellungen](/docs/de/model-config#setting-your-model) oder mit `--model` statt.2382* Vor v2.1.265 lehnte `/model` auch die `opusplan[1m]`-Alias-Schreibweise mit diesem Fehler ab. Auf diesen Versionen aktualisieren Sie Claude Code, oder setzen Sie das Modell in [Einstellungen](/docs/de/model-config#setting-your-model) oder mit `--model` statt.

2247 2383

2384<h3 id="api-error-model-not-changed">

2385 API-Fehler beim Überprüfen des ausgewählten Modells

2386</h3>

2387

2388Sie haben ein Modell mit `/model <name>` ausgewählt, oder eine mit der Sitzung verbundene App hat den Wechsel angefordert. Die API lehnte die minimale Anfrage ab, die Claude Code sendet, um das Modell zu überprüfen, aus einem Grund, der keinen eigenen Eintrag hat, wie z. B. ein Ratenlimit oder ein Serverfehler. Die Sitzung behält ihr aktuelles Modell, und die Nachricht endet damit, dass dies gesagt wird:

2389

2390```text theme={null}

2391API error: 429 <the server's explanation> · model not changed

2392```

2393

2394Die Mitte der Nachricht ist der HTTP-Status und die eigene Erklärung des Servers.

2395

2396**Was zu tun ist:**

2397

2398* Handeln Sie nach der Erklärung des Servers; bei einem Ratenlimit oder einem 5xx-Status warten Sie und wählen Sie das Modell erneut

2399* Die Ablehnungen mit ihrer eigenen Formulierung werden durch die umgebenden Einträge behandelt, wie [Modell nicht gefunden](#model-not-found) und [Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt](#model-is-restricted-by-your-organizations-settings)

2400

2248<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">2401<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

2249 Claude Opus ist nicht mit dem Claude Pro-Plan verfügbar2402 Claude Opus ist nicht mit dem Claude Pro-Plan verfügbar

2250</h3>2403</h3>

2251 2404

2252Ihr aktiver Abonnementplan enthält nicht das Modell, das Sie ausgewählt haben.2405Ihr aktiver Abonnementplan beinhaltet nicht das Modell, das Sie ausgewählt haben.

2253 2406

2254```text theme={null}2407```text theme={null}

2255Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.2408Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

2256```2409```

2257 2410

2411In einer Sitzung, die die Claude Desktop-App ausführt, sagt die Nachricht stattdessen, dass Sie sich `abmelden und erneut anmelden` sollen, anstatt die Befehle zu benennen.

2412

2258**Was zu tun ist:**2413**Was zu tun ist:**

2259 2414

2260* Führen Sie `/model` aus und wählen Sie ein Modell, das Ihr Plan enthält2415* Führen Sie `/model` aus und wählen Sie ein Modell, das Ihr Plan beinhaltet

2261* Wenn Sie Ihren Plan kürzlich aktualisiert haben und dies immer noch sehen, führen Sie `/logout` und dann `/login` aus. Das gespeicherte Token spiegelt Ihren Plan zum Zeitpunkt der Anmeldung wider, daher wird ein Upgrade im Web erst wirksam, wenn Sie sich in einer bestehenden Sitzung erneut authentifizieren.2416* Wenn Sie Ihren Plan kürzlich aktualisiert haben und dies immer noch sehen, führen Sie `/logout` dann `/login` aus. Das gespeicherte Token spiegelt Ihren Plan zum Zeitpunkt der Anmeldung wider, daher wird ein Upgrade auf claude.ai in einer bestehenden Sitzung erst wirksam, wenn Sie sich erneut authentifizieren.

2262* Siehe [claude.com/pricing](https://claude.com/pricing) für die Modelle, die jeder Plan enthält2417* Siehe [claude.com/pricing](https://claude.com/pricing) für die Modelle, die jeder Plan beinhaltet

2263 2418

2264<h3 id="claude-code-does-not-support-this-model">2419<h3 id="claude-code-does-not-support-this-model">

2265 Claude Code unterstützt dieses Modell nicht2420 Claude Code unterstützt dieses Modell nicht

2266</h3>2421</h3>

2267 2422

2268Die API lehnte die Anfrage mit einem 400 ab, weil Ihre Claude-Code-Version unter einem erforderlichen Minimum liegt. Entweder erfordert das Modell, das Sie ausgewählt haben, eine neuere Version, die der Server pro Modell überprüft, oder die Richtlinie Ihrer Organisation erfordert eine. Der 400 trägt den Fehlercode `claude_code_version_too_old`, und die Meldung sagt, welches Minimum gilt.2423Die API lehnte die Anfrage mit einem 400 ab, weil Ihre Claude Code-Version unter einem erforderlichen Minimum liegt. Entweder erfordert das Modell, das Sie ausgewählt haben, eine neuere Version, die der Server pro Modell überprüft, oder die Richtlinie Ihrer Organisation erfordert eine. Der 400 trägt den Fehlercode `claude_code_version_too_old`, und die Nachricht sagt, welches Minimum gilt.

2269 2424

2270```text theme={null}2425```text theme={null}

2271API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.2426API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.

2272```2427```

2273 2428

2274Die Richtlinien-Formulierung der Organisation lautet:2429Die Formulierung der Organisationsrichtlinie lautet:

2275 2430

2276```text theme={null}2431```text theme={null}

2277API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.2432API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

2279 2434

2280**Was zu tun ist:**2435**Was zu tun ist:**

2281 2436

2282* Führen Sie `claude update` aus, oder aktualisieren Sie die Claude-Desktop-App, dann starten Sie eine neue Sitzung2437* Führen Sie `claude update` aus, oder aktualisieren Sie die Claude Desktop-App, dann starten Sie eine neue Sitzung

2283* Für die Pro-Modell-Formulierung können Sie in der aktuellen Sitzung weitermachen, indem Sie mit `/model` zu einem anderen Modell wechseln2438* Für die Formulierung pro Modell können Sie in der aktuellen Sitzung weiterarbeiten, indem Sie mit `/model` zu einem anderen Modell wechseln

2284* Für die Organisationsrichtlinien-Formulierung aktualisieren Sie, bevor Sie fortfahren2439* Für die Formulierung der Organisationsrichtlinie aktualisieren Sie, bevor Sie fortfahren

2285 2440

2286<h3 id="model-is-restricted-by-your-organizations-settings">2441<h3 id="model-is-restricted-by-your-organizations-settings">

2287 Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt2442 Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt

2288</h3>2443</h3>

2289 2444

2290Ihr Organisationsadministrator hat dieses Modell in der claude.ai-Administratorkonsole deaktiviert, oder es ist durch eine [`availableModels`](/docs/de/model-config#restrict-model-selection)-Zulassungsliste in verwalteten Einstellungen ausgeschlossen. Wenn das eingeschränkte Modell mit `--model`, `ANTHROPIC_MODEL` oder der `model`-Einstellung gesetzt wurde, ersetzt Claude Code ein zulässiges Modell und fährt fort. Das Eingeben von `/model <name>` für ein eingeschränktes Modell wird mit `Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell. Die Ersetzungsmitteilung kann auch mid-session nach einem Admin-Deaktivieren des Modells, auf dem eine Sitzung läuft, in der claude.ai-Administratorkonsole angezeigt werden.2445Ihr Organisationsadministrator hat dieses Modell in der claude.ai-Administratorkonsole deaktiviert, oder verwaltete Einstellungen schließen es durch eine [`availableModels`](/docs/de/model-config#restrict-model-selection)-Zulassungsliste oder eine [`deniedModels`](/docs/de/model-config#block-specific-models-or-versions)-Liste aus. Der Hinweis wird beim Start angezeigt, wenn `--model`, `ANTHROPIC_MODEL` oder die `model`-Einstellung das eingeschränkte Modell benannt haben, und er benennt das Modell, das die Sitzung stattdessen verwendet. Wenn verwaltete Einstellungen kein zulässiges Modell für die Sitzung hinterlassen, siehe [Verwaltete Einstellungen blockieren das Standardmodell](#managed-settings-block-the-default-model). Der Substitutionshinweis kann auch während der Sitzung angezeigt werden, nachdem ein Administrator das Modell, auf dem eine Sitzung läuft, in der claude.ai-Administratorkonsole deaktiviert hat.

2291 2446

2292```text theme={null}2447```text theme={null}

2293Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.2448Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

2294```2449```

2295 2450

2296Ein Hinweis mit dem Präfix eines Agenten, einer Fähigkeit oder eines Befehls bedeutet, dass die Einschränkung auf das [angeforderte Modell des Subagenten](/docs/de/sub-agents#choose-a-model) angewendet wurde: Der Subagent wird auf dem ersetzten Modell ausgeführt und das Modell Ihrer Sitzung ist unverändert. Vor v2.1.223 zeigte Claude Code den Hinweis nur für Subagenten, die mit dem Agent-Werkzeug gestartet wurden.2451Das Eingeben von `/model <name>` für ein eingeschränktes Modell wird abgelehnt und die Sitzung behält ihr aktuelles Modell. Für ein in der Administratorkonsole deaktiviertes Modell lautet die Ablehnung `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` Für ein Modell, das verwaltete Einstellungen ausschließen, lautet es `Model '<name>' is not available. Your organization restricts model selection.`

2452

2453Ein Hinweis mit dem Präfix eines Agenten, einer Fähigkeit oder eines Befehls bedeutet, dass die Einschränkung auf das [angeforderte Modell des Subagenten](/docs/de/sub-agents#choose-a-model) angewendet wurde: Der Subagent läuft auf dem ersetzten Modell und das Modell Ihrer Sitzung ist unverändert. Vor v2.1.223 zeigte Claude Code den Hinweis nur für Subagenten, die mit dem Agent-Tool gestartet wurden.

2297 2454

2298Claude Code behandelt einen Modellfamilien-Alias, einen von `opus`, `sonnet`, `haiku` oder `fable`, als Anfrage für diese Familie statt für ihre neueste Version. Auf der Anthropic-API und auf [Claude Platform on AWS](/docs/de/claude-platform-on-aws) wird ein eingeschränkter Familien-Alias zur neuesten Version der Familie aufgelöst, die Ihre Organisation und die `availableModels`-Zulassungsliste zulassen, und der Ersetzungshinweis nennt diese Version. Claude Code lehnt `/model <alias>` nur ab, wenn jede Version der Familie eingeschränkt ist. Vor v2.1.205 wurde ein Familien-Alias basierend auf seiner neuesten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version derselben Familie zulässig war.2455Claude Code behandelt einen Modell-Familie-Alias, einen von `opus`, `sonnet`, `haiku` oder `fable`, als eine Anfrage für diese Familie statt für ihre neueste Version. Auf der Anthropic API und auf [Claude Platform on AWS](/docs/de/claude-platform-on-aws) wird ein eingeschränkter Familie-Alias zu der neuesten Version der Familie aufgelöst, die die Einstellungen Ihrer Organisation zulassen, und der Substitutionshinweis benennt diese Version. Claude Code lehnt `/model <alias>` nur ab, wenn jede Version der Familie eingeschränkt ist. Vor v2.1.205 wurde ein Familie-Alias basierend auf seiner neuesten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version der gleichen Familie zulässig war.

2299 2456

2300**Was zu tun ist:**2457**Was zu tun ist:**

2301 2458

2302* Führen Sie `/model` aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind in der Auswahl verborgen.2459* Führen Sie `/model` aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind im Wähler verborgen.

2303* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL`, dem `model`-Feld einer Einstellungsdatei oder dem `model`-Frontmatter eines [Subagenten](/docs/de/sub-agents#choose-a-model), einer Fähigkeit oder eines Befehls gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, damit der Hinweis nicht erneut auftritt2460* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL`, dem `model`-Feld einer Einstellungsdatei oder dem `model`-Frontmatter eines [Subagenten](/docs/de/sub-agents#choose-a-model), einer Fähigkeit oder eines Befehls gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, damit der Hinweis nicht erneut auftritt

2304* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe [Organisationsmodell-Einschränkungen](/docs/de/model-config#organization-model-restrictions).2461* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe [Organisationsmodell-Einschränkungen](/docs/de/model-config#organization-model-restrictions).

2305 2462

2307 Modellwechsel wurde durch einen PreModelSwitch-Hook blockiert2464 Modellwechsel wurde durch einen PreModelSwitch-Hook blockiert

2308</h3>2465</h3>

2309 2466

2310Ein [PreModelSwitch-Hook](/docs/de/hooks#premodelswitch) hat den Modellwechsel, den Sie oder ein Client angefordert haben, nicht genehmigt, daher behält die Sitzung ihr aktuelles Modell. Wenn der Wechsel von einem [Agent SDK](/docs/de/agent-sdk/overview)-Host oder [Remote Control](/docs/de/remote-control) statt von einem Befehl kam, den Sie eingegeben haben, lautet die Meldung `Model switch blocked by a PreModelSwitch hook` ohne Nennung des Zielmodells.2467Ein [PreModelSwitch-Hook](/docs/de/hooks#premodelswitch) hat den Modellwechsel, den Sie oder ein Client angefordert haben, nicht genehmigt, daher behält die Sitzung ihr aktuelles Modell. Wenn der Wechsel von einem [Agent SDK](/docs/de/agent-sdk/overview)-Host oder [Remote Control](/docs/de/remote-control) statt von einem Befehl kam, den Sie eingegeben haben, lautet die Nachricht `Model switch blocked by a PreModelSwitch hook` ohne Benennung des Zielmodells.

2311 2468

2312```text theme={null}2469```text theme={null}

2313Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.2470Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.

2314```2471```

2315 2472

2316Der Grund nach dem Doppelpunkt sagt, was den Wechsel ablehnte:2473Der Grund nach dem Doppelpunkt sagt, was den Wechsel abgelehnt hat:

2317 2474

2318* **Ein Grund, den ein Hook geschrieben hat**: Ein PreModelSwitch-Hook lieferte diesen Grund, wenn er [den Wechsel ablehnte oder um Bestätigung bat](/docs/de/hooks#premodelswitch-decision-control). Beheben Sie, was er verlangt, oder wählen Sie ein Modell, das Ihre Hooks zulassen.2475* **Ein Grund, den ein Hook geschrieben hat**: Ein PreModelSwitch-Hook lieferte diesen Grund, wenn er [den Wechsel ablehnte oder um Bestätigung bat](/docs/de/hooks#premodelswitch-decision-control). Beheben Sie, was er fragt, oder wählen Sie ein Modell, das Ihre Hooks zulassen.

2319* **`PreModelSwitch hook <name> did not respond before its timeout`**: Ein Hook, der nicht vor seinem [Timeout](/docs/de/hooks#timeouts) antwortet, blockiert den Wechsel. Beheben Sie den hängenden Befehl oder erhöhen Sie das `timeout` dieses Hooks, dann wechseln Sie erneut.2476* **`PreModelSwitch hook <name> did not respond before its timeout`**: Ein Hook, der nicht vor seinem [Timeout](/docs/de/hooks#timeouts) antwortet, blockiert den Wechsel. Beheben Sie den hängenden Befehl oder erhöhen Sie das `timeout` dieses Hooks, dann wechseln Sie erneut.

2320* **`confirmation required, and this session cannot ask`**: Ein Hook antwortete `ask` ohne Grund, und eine Kontrollabfrage hat keine Möglichkeit, die Bestätigungsaufforderung anzuzeigen. Ein `/model`-Befehl in einem [`-p`-Lauf](/docs/de/headless) meldet die gleiche Bedingung mit `(run /model interactively to confirm)` nach dem Grund. Machen Sie den Wechsel von einer interaktiven Sitzung, oder ändern Sie die Entscheidung des Hooks für dieses Modell.2477* **`confirmation required, and this session cannot ask`**: Ein Hook antwortete `ask` ohne Grund, und eine Kontrollabfrage hat keine Möglichkeit, die Bestätigungsaufforderung anzuzeigen. Ein `/model`-Befehl in einem [`-p`-Lauf](/docs/de/headless) meldet die gleiche Bedingung mit `(run /model interactively to confirm)` nach dem Grund. Machen Sie den Wechsel aus einer interaktiven Sitzung, oder ändern Sie die Entscheidung des Hooks für dieses Modell.

2321* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code konnte nicht sagen, welche PreModelSwitch-Hooks Ihre Organisation [verwaltete Plugins](/docs/de/settings-reference#enabledplugins) liefern, zum Beispiel weil ein verwaltetes Plugin nicht geladen werden konnte. Einer dieser Hooks könnte den Wechsel blockieren, daher weigert sich Claude Code, statt den Wechsel unkontrolliert anzuwenden. Der Anfang des Grundes nennt, was fehlgeschlagen ist. Claude Code überprüft bei jedem Wechselversuch erneut, daher stoppt ein Fehler, der seitdem geklärt wurde, das Blockieren; wenn es weiterhin fehlschlägt, führen Sie `claude --debug` aus und wechseln Sie erneut, um die Details zu erfassen, dann beheben Sie das Plugin oder bitten Sie Ihren Admin, es zu beheben.2478* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code konnte nicht feststellen, welche PreModelSwitch-Hooks Ihre Organisation [verwaltete Plugins](/docs/de/settings-reference#enabledplugins) liefern, beispielsweise weil ein verwaltetes Plugin nicht geladen werden konnte. Einer dieser Hooks könnte den Wechsel blockieren, daher weigert sich Claude Code, statt den Wechsel ungeprüft anzuwenden. Der Anfang des Grundes benennt, was fehlgeschlagen ist. Claude Code überprüft bei jedem Wechselversuch erneut, daher stoppt ein Fehler, der seitdem behoben wurde, das Blockieren; wenn es weiterhin fehlschlägt, führen Sie `claude --debug` aus und wechseln Sie erneut, um die Details zu erfassen, dann beheben Sie das Plugin oder bitten Sie Ihren Administrator, es zu beheben.

2322* **`a PreModelSwitch hook failed before answering`** oder **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: Der Hook-Lauf endete ohne Urteil, und Claude Code behandelt das nicht als Genehmigung. Führen Sie `claude --debug` aus, um zu sehen, was fehlgeschlagen ist, dann wechseln Sie erneut.2479* **`a PreModelSwitch hook failed before answering`** oder **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: Der Hook-Lauf endete ohne Urteil, und Claude Code behandelt das nicht als Genehmigung. Führen Sie `claude --debug` aus, um zu sehen, was fehlgeschlagen ist, dann wechseln Sie erneut.

2323 2480

2324Vor v2.1.260 lautete die verwaltete Plugin-Ablehnung `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code wiederholte das Plugin-Laden einmal und lehnte dann später Wechsel in der Sitzung ab, auch wenn Ihre Organisation keine Plugins verwaltete. Starten Sie die Sitzung auf diesen Versionen neu, um das Plugin-Laden erneut auszuführen.2481Vor v2.1.260 lautete die Ablehnung des verwalteten Plugins `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code wiederholte das Plugin-Laden einmal und lehnte dann später Wechsel in der Sitzung ab, auch wenn Ihre Organisation keine Plugins verwaltete. Starten Sie die Sitzung auf diesen Versionen neu, um das Plugin-Laden erneut auszuführen.

2325 2482

2326<h3 id="couldnt-save-it-as-your-default">2483<h3 id="couldnt-save-it-as-your-default">

2327 Konnte es nicht als Standard speichern2484 Konnte es nicht als Ihren Standard speichern

2328</h3>2485</h3>

2329 2486

2330Sie haben ein Modell ausgewählt, um es als Standard zu speichern, zum Beispiel mit `/model <name>` oder `Enter` in der `/model`-Auswahl, und Claude Code konnte die Auswahl nicht in Ihre Benutzereinstellungsdatei `~/.claude/settings.json` schreiben. Der Wechsel selbst wurde angewendet, daher läuft die aktuelle Sitzung auf dem Modell, das Sie ausgewählt haben, aber Ihr Standard ist unverändert und die nächste Sitzung startet auf dem alten Wert.2487Sie haben ein Modell ausgewählt, um es als Ihren Standard zu speichern, beispielsweise mit `/model <name>` oder `Enter` im `/model`-Wähler, und Claude Code konnte die Auswahl nicht in Ihre Benutzereinstellungsdatei `~/.claude/settings.json` schreiben. Der Wechsel selbst wurde angewendet, daher läuft die aktuelle Sitzung auf dem Modell, das Sie ausgewählt haben, aber Ihr Standard ist unverändert und die nächste Sitzung startet auf dem alten Wert.

2331 2488

2332```text theme={null}2489```text theme={null}

2333Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)2490Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)

2335 2492

2336Der Grund nach dem Dateipfad sagt, was fehlgeschlagen ist:2493Der Grund nach dem Dateipfad sagt, was fehlgeschlagen ist:

2337 2494

2338* **`can't be written (<code>)`**: Der Schreibvorgang schlug mit dem Betriebssystemfehlercode in Klammern fehl, wie `EROFS`, wenn die Datei oder die Datei, auf die sie verweist, auf einem Dateisystem sitzt, das Schreibvorgänge ablehnt. Machen Sie die Datei beschreibbar und wechseln Sie erneut. Wenn ein anderes Werkzeug die Datei erzeugt, setzen Sie stattdessen den `model`-Schlüssel in diesem Werkzeug; siehe [Eine Änderung, die Sie in Claude Code gemacht haben, geht in neuen Sitzungen verloren](/docs/de/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).2495* **`can't be written (<code>)`**: Der Schreibvorgang schlug mit dem Betriebssystem-Fehlercode in Klammern fehl, wie `EROFS`, wenn die Datei oder die Datei, auf die sie verweist, auf einem Dateisystem sitzt, das Schreibvorgänge ablehnt. Machen Sie die Datei beschreibbar und wechseln Sie erneut. Wenn ein anderes Tool die Datei generiert, setzen Sie stattdessen den `model`-Schlüssel in diesem Tool; siehe [Eine Änderung, die Sie in Claude Code vorgenommen haben, geht in neuen Sitzungen verloren](/docs/de/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

2339* **`isn't valid JSON`**: Die Datei auf der Festplatte wird nicht geparst, und Claude Code lässt sie unverändert, statt Inhalte zu überschreiben, die es nicht zurücklesen kann. Beheben Sie den Syntaxfehler, dann wechseln Sie erneut; siehe [Beheben Sie eine kaputte Einstellungsdatei](/docs/de/settings#fix-a-broken-settings-file).2496* **`isn't valid JSON`**: Die Datei auf der Festplatte wird nicht geparst, und Claude Code lässt sie unverändert, anstatt Inhalt zu überschreiben, den es nicht zurücklesen kann. Beheben Sie den Syntaxfehler, dann wechseln Sie erneut; siehe [Beheben Sie eine beschädigte Einstellungsdatei](/docs/de/settings#fix-a-broken-settings-file).

2340 2497

2341Ein Hinweis, der mit `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` endet, bedeutet, dass der Schreibvorgang nach drei Sekunden nicht beendet war. Er wird im Hintergrund fortgesetzt, daher kann der Standard immer noch gespeichert werden; überprüfen Sie, mit welchem Modell Ihre nächste Sitzung startet, oder führen Sie `/model <name>` erneut aus.2498Ein Hinweis, der mit `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` endet, bedeutet, dass der Schreibvorgang nach drei Sekunden nicht beendet war. Er wird im Hintergrund fortgesetzt, daher kann der Standard immer noch gespeichert werden; überprüfen Sie, mit welchem Modell Ihre nächste Sitzung startet, oder führen Sie `/model <name>` erneut aus.

2342 2499

2343Vor v2.1.265 sagte der Hinweis, das Modell sei `saved as your default for new sessions`, auch wenn der Schreibvorgang fehlgeschlagen war.2500Vor v2.1.265 sagte der Hinweis, dass das Modell `saved as your default for new sessions` war, auch wenn der Schreibvorgang fehlschlug.

2344 2501

2345<h3 id="thinking-type-enabled-is-not-supported-for-this-model">2502<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

2346 thinking.type.enabled wird für dieses Modell nicht unterstützt2503 thinking.type.enabled wird für dieses Modell nicht unterstützt

2347</h3>2504</h3>

2348 2505

2349Ihre Claude-Code-Version ist älter als das Minimum für das ausgewählte Modell. Die CLI hat eine Thinking-Konfiguration gesendet, die das Modell nicht mehr akzeptiert.2506Ihre Claude Code-Version ist älter als das Minimum für das ausgewählte Modell. Die CLI sendete eine Denk-Konfiguration, die das Modell nicht mehr akzeptiert.

2350 2507

2351```text theme={null}2508```text theme={null}

2352API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.2509API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

2354 2511

2355**Was zu tun ist:**2512**Was zu tun ist:**

2356 2513

2357* Führen Sie `claude update` aus und starten Sie Claude Code neu. Opus 4.7 benötigt v2.1.111 oder später. Opus 4.8 benötigt v2.1.154 oder später. Sonnet 5 benötigt v2.1.197 oder später. Opus 5 benötigt v2.1.219 oder später. Opus 5.5 benötigt v2.1.280 oder später2514* Führen Sie `claude update` aus und starten Sie Claude Code neu. Opus 4.7 benötigt v2.1.111 oder später. Opus 4.8 benötigt v2.1.154 oder später. Sonnet 5 benötigt v2.1.197 oder später. Opus 5 benötigt v2.1.219 oder später. Opus 5.5 benötigt v2.1.280 oder später. Sonnet 5.5 benötigt v2.1.284 oder später

2358* Wenn Sie nicht aktualisieren können, führen Sie `/model` aus und wählen Sie stattdessen Opus 4.6 oder Sonnet 4.62515* Wenn Sie nicht aktualisieren können, führen Sie `/model` aus und wählen Sie stattdessen Opus 4.6 oder Sonnet 4.6

2359* Wenn Sie dies im [Agent SDK](/docs/de/agent-sdk/overview) treffen, aktualisieren Sie stattdessen das SDK-Paket. Opus 4.8 benötigt TypeScript SDK v0.3.154 oder später und Python SDK v0.2.88 oder später. Sonnet 5 benötigt TypeScript SDK v0.3.197 oder später. Opus 5 benötigt TypeScript SDK v0.3.219 oder später. Opus 5.5 benötigt TypeScript SDK v0.3.280 oder später2516* Wenn Sie dies im [Agent SDK](/docs/de/agent-sdk/overview) treffen, aktualisieren Sie stattdessen das SDK-Paket. Opus 4.8 benötigt TypeScript SDK v0.3.154 oder später und Python SDK v0.2.88 oder später. Sonnet 5 benötigt TypeScript SDK v0.3.197 oder später. Opus 5 benötigt TypeScript SDK v0.3.219 oder später. Opus 5.5 benötigt TypeScript SDK v0.3.280 oder später. Sonnet 5.5 benötigt TypeScript SDK v0.3.284 oder später

2360 2517

2361<h3 id="effort-isnt-available-with-thinking-turned-off">2518<h3 id="effort-isnt-available-with-thinking-turned-off">

2362 Effort ist nicht verfügbar, wenn Thinking ausgeschaltet ist2519 Anstrengung ist nicht verfügbar, wenn das Denken ausgeschaltet ist

2363</h3>2520</h3>

2364 2521

2365Sie haben [erweitertes Thinking](/docs/de/model-config#extended-thinking) ausgeschaltet und führen auf einer [Effort-Stufe](/docs/de/model-config#adjust-effort-level) über `high` aus. Das Modell akzeptiert diese Kombination nicht, daher lehnte die API die Anfrage ab.2522Sie haben [erweitertes Denken](/docs/de/model-config#extended-thinking) ausgeschaltet und laufen auf einer [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) über `high`. Das Modell akzeptiert diese Kombination nicht, daher lehnte die API die Anfrage ab.

2366 2523

2367```text theme={null}2524```text theme={null}

2368API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)2525API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

2369```2526```

2370 2527

2528Der Hinweis nach dem `·` variiert je nach Sitzung: In einer nicht-interaktiven Sitzung lautet er `use --effort high (or the effortLevel setting)`, und in einer Sitzung, die die Claude Desktop-App ausführt, lautet er `you can lower effort to High`.

2529

2371**Was zu tun ist:**2530**Was zu tun ist:**

2372 2531

2373* [Senken Sie die Effort-Stufe](/docs/de/model-config#set-the-effort-level) auf `high` oder darunter.2532* [Senken Sie die Anstrengungsstufe](/docs/de/model-config#set-the-effort-level) auf `high` oder darunter.

2374* Schalten Sie Thinking wieder ein, z. B. durch Aufheben von [`MAX_THINKING_TOKENS`](/docs/de/env-vars) oder Entfernen von [`"alwaysThinkingEnabled": false`](/docs/de/settings-reference#alwaysthinkingenabled) aus Ihren Einstellungen.2533* Schalten Sie das Denken wieder ein, beispielsweise durch Aufheben von [`MAX_THINKING_TOKENS`](/docs/de/env-vars) oder Entfernen von [`"alwaysThinkingEnabled": false`](/docs/de/settings-reference#alwaysthinkingenabled) aus Ihren Einstellungen.

2375 2534

2376Vor v2.1.242 zeigte Claude Code die eigene Meldung der API: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` Vor v2.1.251 sendete Claude Code die Anfrage auf der Effort-Stufe, die Sie gesetzt haben, daher lehnte Opus 5 jede Anfrage über `high` mit ausgeschaltetem Thinking ab. Claude Code sendet jetzt Effort `high` stattdessen an Modelle, von denen es weiß, dass sie die Kombination ablehnen, wie Opus 5, daher erreicht dieser Fehler Sie auf v2.1.251 oder später nur von einem Modell, das Claude Code nicht kennt, das es ablehnt.2535Vor v2.1.242 zeigte Claude Code die eigene Nachricht der API: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` Vor v2.1.251 sendete Claude Code die Anfrage auf der Anstrengungsstufe, die Sie gesetzt haben, daher lehnte Opus 5 jede Anfrage über `high` mit ausgeschaltetem Denken ab. Claude Code sendet jetzt stattdessen Anstrengung `high` an Modelle, von denen es weiß, dass sie die Kombination ablehnen, wie Opus 5.

2377 2536

2378<h3 id="thinking-budget-exceeds-output-limit">2537<h3 id="thinking-budget-exceeds-output-limit">

2379 Thinking-Budget überschreitet Ausgabelimit2538 Denk-Budget überschreitet Ausgabelimit

2380</h3>2539</h3>

2381 2540

2382Das konfigurierte erweiterte Thinking-Budget überschreitet die maximale Antwortlänge, daher bleibt kein Platz für die tatsächliche Antwort.2541Das konfigurierte erweiterte Denk-Budget überschreitet die maximale Antwortlänge, daher bleibt kein Platz für die eigentliche Antwort.

2383 2542

2384```text theme={null}2543```text theme={null}

2385API Error: 400 ... max_tokens must be greater than thinking.budget_tokens2544API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

2386```2545```

2387 2546

2388Claude Code passt diese Werte automatisch auf der Anthropic-API an. Sie sehen diesen Fehler normalerweise auf Amazon Bedrock oder Google Clouds Agent Platform, wenn [`MAX_THINKING_TOKENS`](/docs/de/env-vars) höher als das Ausgabelimit des Anbieters gesetzt ist, oder wenn der Plan-Modus das Thinking-Budget erhöht.

~~2389~~

2390**Was zu tun ist:**2547**Was zu tun ist:**

2391 2548

2392* Senken Sie `MAX_THINKING_TOKENS`, oder erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/de/env-vars) über das Thinking-Budget2549* Erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/de/env-vars) über das Denk-Budget

2393* Siehe [Erweitertes Thinking](/docs/de/model-config#extended-thinking) für die Interaktion des Budgets mit der Ausgabelänge2550* Siehe [Erweitertes Denken](/docs/de/model-config#extended-thinking) für die Interaktion des Budgets mit der Ausgabelänge

2394 2551

2395<h3 id="tool-use-or-thinking-block-mismatch">2552<h3 id="tool-use-or-thinking-block-mismatch">

2396 Werkzeugverwendung oder Thinking-Block-Nichtübereinstimmung2553 Tool-Verwendung oder Denk-Block-Nichtübereinstimmung

2397</h3>2554</h3>

2398 2555

2399Die Gesprächshistorie erreichte die API in einem inkonsistenten Zustand, normalerweise nachdem ein Werkzeugaufruf unterbrochen oder eine Runde während des Streams bearbeitet wurde.2556Die Gesprächshistorie erreichte die API in einem inkonsistenten Zustand.

2400 2557

2401```text theme={null}2558```text theme={null}

2402API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2559API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.

2406API Error: 400 ... thinking blocks ... cannot be modified2563API Error: 400 ... thinking blocks ... cannot be modified

2407```2564```

2408 2565

2409Alle Varianten bedeuten dasselbe: Die Abfolge von `tool_use`-, `tool_result`- und `thinking`-Blöcken in der Historie stimmt nicht mehr mit dem überein, was die API erwartet.2566Alle Varianten bedeuten das Gleiche: Die Abfolge der `tool_use`-, `tool_result`- und `thinking`-Blöcke in der Historie stimmt nicht mehr mit dem überein, was die API erwartet.

2567

2568**Was zu tun ist:**

2569

2570* Wenn Sie Opus 4.7 oder Opus 4.8 verwenden, führen Sie zuerst `claude update` aus. Versionen vor v2.1.156 können diesen Fehler während normaler Tool-Verwendung auslösen, und `/rewind` löscht ihn nicht.

2571* Führen Sie `/rewind` aus, oder drücken Sie zweimal Esc, um zu einem Checkpoint vor dem beschädigten Durchgang zurückzugehen und von dort aus fortzufahren. Siehe [Checkpointing](/docs/de/checkpointing) für die Erstellung und Wiederherstellung von Checkpoints.

2572

2573<h3 id="invalid-data-in-redacted-thinking-block">

2574 Ungültige Daten im redacted\_thinking-Block

2575</h3>

2576

2577Die API lehnte die Anfrage mit einem 400 ab, weil sie einen `redacted_thinking`-Block, den ein früherer Durchgang in der Gesprächshistorie trägt, nicht akzeptieren konnte.

2578

2579```text theme={null}

2580API Error: 400 ... Invalid `data` in `redacted_thinking` block

2581```

2582

2583Claude Code lässt das frühere Denken des Gesprächs aus der Anfrage weg und versucht es einmal erneut, daher wird die Sitzung ohne Anzeige des Fehlers fortgesetzt. Vor v2.1.282 behielt Claude Code den abgelehnten Block, und jeder spätere Durchgang schlug mit dem gleichen Fehler fehl.

2410 2584

2411**Was zu tun ist:**2585**Was zu tun ist:**

2412 2586

2413* Wenn Sie Opus 4.7 oder Opus 4.8 verwenden, führen Sie zuerst `claude update` aus. Versionen vor v2.1.156 können diesen Fehler während normaler Werkzeugverwendung auslösen, und `/rewind` löscht ihn nicht.2587* Wenn Sie auf v2.1.281 oder früher sind und jeder Durchgang mit diesem Fehler fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung fort

2414* Führen Sie `/rewind` aus, oder drücken Sie zweimal Esc, um zu einem Checkpoint vor der beschädigten Runde zurückzugehen und von dort aus fortzufahren. Siehe [Checkpointing](/docs/de/checkpointing) für die Erstellung und Wiederherstellung von Checkpoints.2588* Wenn der Fehler anhält, führen Sie `/clear` aus, um ein Gespräch zu starten, das den Block nicht trägt

2415 2589

2416<h3 id="unsupported-tool-content-removed">2590<h3 id="unsupported-tool-content-removed">

2417 Nicht unterstützter Werkzeuginhalt entfernt2591 Nicht unterstützter Tool-Inhalt entfernt

2418</h3>2592</h3>

2419 2593

2420Wenn Claude Code direkt mit der Anthropic-API verbunden ist und eine gespeicherte Sitzung lädt oder in der Vorschau anzeigt, entfernt es Werkzeuginhalte, die die Anthropic-API nicht akzeptiert, und lässt diese Zeile dort, wo entfernter Inhalt zwischen zwei Thinking-Blöcken saß:2594Wenn Claude Code direkt mit der Anthropic API verbunden ist und eine gespeicherte Sitzung lädt oder in der Vorschau anzeigt, entfernt es Tool-Inhalt, den die Anthropic API nicht akzeptiert, und lässt diese Zeile, wo entfernter Inhalt zwischen zwei Denk-Blöcken saß:

2421 2595

2422```text theme={null}2596```text theme={null}

2423[Unsupported tool content removed]2597[Unsupported tool content removed]

2424```2598```

2425 2599

2426Solcher Inhalt erreicht eine Sitzungsdatei, wenn etwas anderes als die Anthropic-API im Format der API antwortet, normalerweise ein Drittanbieter-Proxy, der durch [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) gesetzt ist und die Werkzeugaufrufe eines anderen Anbieters übersetzt. Claude Code entfernt ihn nur, wenn die Sitzung direkt mit der Anthropic-API verbunden ist, und lädt die gespeicherte Historie, wie sie ist, wenn die Sitzung über einen Proxy oder auf einem anderen Anbieter läuft. Vor v2.1.246 sendete Claude Code die Werkzeugverwendung und ihr Ergebnis zurück zur API, und jede Runde der wiederaufgenommenen Sitzung schlug mit einem 400-Fehler wie `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...` fehl.2600Solcher Inhalt erreicht eine Sitzungsdatei, wenn etwas anderes als die Anthropic API in der API-Format antwortet, typischerweise ein Drittanbieter-Proxy, der durch [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) gesetzt ist und Tool-Aufrufe eines anderen Anbieters übersetzt. Claude Code entfernt ihn nur, wenn die Sitzung direkt mit der Anthropic API verbunden ist, und lädt die gespeicherte Historie, wie sie ist, wenn die Sitzung durch einen Proxy oder auf einem anderen Anbieter läuft. Vor v2.1.246 sendete Claude Code die Tool-Verwendung und ihr Ergebnis zurück zur API, und jeder Durchgang der wiederaufgenommenen Sitzung schlug mit einem 400-Fehler wie `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...` fehl.

2427 2601

2428**Was zu tun ist:**2602**Was zu tun ist:**

2429 2603

2430* Keine Aktion erforderlich, wenn Sie die Platzhalterzeile sehen. Die Sitzung wird ohne den entfernten Inhalt fortgesetzt.2604* Keine Aktion erforderlich, wenn Sie die Platzhalter-Zeile sehen. Die Sitzung wird ohne den entfernten Inhalt fortgesetzt.

2431* Wenn jede Runde einer wiederaufgenommenen Sitzung stattdessen mit dem 400-Fehler fehlschlägt, führen Sie `claude update` aus und nehmen Sie die Sitzung erneut auf. Versionen vor v2.1.246 entfernen den Inhalt nicht.2605* Wenn jeder Durchgang einer wiederaufgenommenen Sitzung stattdessen mit dem 400-Fehler fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung erneut fort. Versionen vor v2.1.246 entfernen den Inhalt nicht.

2432 2606

2433<h3 id="role-system-must-precede-an-assistant-message">2607<h3 id="role-system-must-precede-an-assistant-message">

2434 role 'system' must precede an 'assistant' message2608 Rolle 'system' muss einer 'assistant'-Nachricht vorangehen

2435</h3>2609</h3>

2436 2610

2437Die API lehnte die Anfrage mit einem 400 ab, weil eine Systemnachricht an einer Position im Gespräch sitzt, die sie nicht akzeptiert:2611Die API lehnte die Anfrage mit einem 400 ab, weil eine System-Nachricht an einer Position im Gespräch sitzt, die sie nicht akzeptiert:

2438 2612

2439```text theme={null}2613```text theme={null}

2440API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...2614API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...

2441```2615```

2442 2616

2443Claude Code sendet einige seiner Erinnerungs- und Anhang-Texte als Systemnachrichten innerhalb des Gesprächs. Wenn die API die Position einer ablehnt, versucht Claude Code die Anfrage einmal erneut mit diesem Text, der stattdessen als gewöhnliche Benutzernachrichten gesendet wird. Die Geschwister-Platzierungs-Formulierungen der API, wie `use the top-level 'system' parameter for the initial system prompt`, erhalten die gleiche Wiederherstellung.2617Claude Code sendet einen Teil seines Erinnerungs- und Anhang-Textes als System-Nachrichten innerhalb des Gesprächs. Wenn die API die Position einer ablehnt, versucht Claude Code die Anfrage einmal erneut mit diesem Text, der stattdessen als gewöhnliche Benutzer-Nachrichten gesendet wird. Die Geschwister-Platzierungs-Formulierungen der API, wie `use the top-level 'system' parameter for the initial system prompt`, erhalten die gleiche Wiederherstellung.

2444 2618

2445Wenn der Fehler angezeigt wird, ist die abgelehnte Systemnachricht nicht eine, die Claude Code entfernen kann. Das bedeutet normalerweise, dass ein Proxy oder [LLM-Gateway](/docs/de/llm-gateway) zwischen Claude Code und der API eine Systemnachricht hinzugefügt oder das Gespräch neu angeordnet hat.2619Wenn der Fehler angezeigt wird, ist die abgelehnte System-Nachricht nicht eine, die Claude Code entfernen kann. Das bedeutet normalerweise, dass ein Proxy oder [LLM-Gateway](/docs/de/llm-gateway) zwischen Claude Code und der API eine System-Nachricht hinzugefügt hat.

2446 2620

2447**Was zu tun ist:**2621**Was zu tun ist:**

2448 2622

2449* Führen Sie `/clear` aus, um ein neues Gespräch zu starten. Wenn der Fehler dort auch zurückkommt, ist die Ursache auf dem Anfragepfad, nicht im gespeicherten Gespräch.2623* Wenn der Fehler bei jedem Durchgang hinter einem Proxy oder Gateway, der durch [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) konfiguriert ist, wiederholt wird, verbinden Sie sich ohne den Proxy, um die Quelle zu bestätigen, und melden Sie den Fehler an denjenigen, der ihn betreibt

2450* Wenn der Fehler sich bei jedem Durchgang hinter einem Proxy oder Gateway wiederholt, das durch [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) konfiguriert ist, verbinden Sie sich ohne den Proxy, um die Quelle zu bestätigen, und melden Sie den Fehler demjenigen, der ihn betreibt2624* Führen Sie `/clear` aus, um ein frisches Gespräch zu starten. Wenn der Fehler dort auch zurückkommt, liegt die Ursache auf dem Anfragepfad, nicht in der gespeicherten Gesprächshistorie.

2451 2625

2452Vor v2.1.280 erkannte Claude Code diese Formulierung nicht, daher erschien der Fehler auch, wenn die abgelehnte Systemnachricht eine war, die Claude Code selbst sendete, und jeder spätere Durchgang des Gesprächs schlug auf die gleiche Weise fehl.2626Vor v2.1.280 erkannte Claude Code diese Formulierung nicht, daher trat der Fehler auch auf, wenn die abgelehnte System-Nachricht eine war, die Claude Code selbst sendete, und jeder spätere Durchgang des Gesprächs schlug auf die gleiche Weise fehl.

2453 2627

2454<h3 id="invalid-encrypted-content-in-search-result-block">2628<h3 id="invalid-encrypted-content-in-search-result-block">

2455 Invalid encrypted\_content in search\_result block2629 Ungültiger encrypted\_content im search\_result-Block

2456</h3>2630</h3>

2457 2631

2458Die API lehnte die Anfrage mit einem 400 ab, weil die Gesprächshistorie gehostete Web-Such-Inhalte enthält, die sie nicht entschlüsseln kann. Die Formulierung nennt das Feld, das sie nicht lesen kann:2632Die API lehnte die Anfrage mit einem 400 ab, weil die Gesprächshistorie gehostete Web-Such-Inhalte enthält, die sie nicht entschlüsseln kann. Die Formulierung benennt das Feld, das sie nicht lesen kann:

2459 2633

2460```text theme={null}2634```text theme={null}

2461API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block2635API Error: 400 ... Invalid `encrypted_content` in `search_result` block

2462API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block2636API Error: 400 ... Invalid `encrypted_index` in `text` block

2463API Error: 400 Failed to decrypt web search result content2637API Error: 400 ... Failed to decrypt web search result content

2638API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block

2464```2639```

2465 2640

2466Ergebnisse aus dem gehosteten [Web-Such-Werkzeug](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) der API enthalten verschlüsselte Felder, die nur die API lesen kann. Die API lehnt eine Anfrage ab, die Inhalte wiederholt, die sie nicht entschlüsseln kann, wie Inhalte, die für eine andere Organisation erzeugt wurden.2641Ergebnisse aus dem gehosteten [Web-Such-Tool](/docs/de/tools-reference#websearch-tool-behavior) der API tragen verschlüsselte Felder, die nur die API lesen kann. Die `encrypted_stdout`-Formulierung benennt die Ausgabe eines gehosteten Code-Ausführungs-Programms, das solche Ergebnisse las, die die API ebenfalls verschlüsselt. Die API lehnt eine Anfrage ab, die Inhalt erneut sendet, den sie nicht entschlüsseln kann, wie Inhalt, der für eine andere Organisation produziert wurde.

2467 2642

2468Das eigene [WebSearch-Werkzeug](/docs/de/tools-reference#websearch-tool-behavior) von Claude Code zeichnet Suchergebnisse als Klartext auf, daher erreichen diese Blöcke ein Gespräch normalerweise über einen Proxy oder [LLM-Gateway](/docs/de/llm-gateway), der selbst gehostete Web-Suche ausgeführt hat.2643Das eigene [WebSearch-Tool](/docs/de/tools-reference#websearch-tool-behavior) von Claude Code zeichnet Suchergebnisse als Klartext auf, daher erreichen diese Blöcke normalerweise ein Gespräch durch einen Proxy oder [LLM-Gateway](/docs/de/llm-gateway), der selbst gehostete Web-Suche ausführte.

2469 2644

2470Die abgelehnten Blöcke bleiben in der Gesprächshistorie, daher schlagen jeder spätere Durchgang und `/compact` auf die gleiche Weise fehl.2645Für die drei Web-Such-Formulierungen lässt Claude Code die Such-Aufrufe, Ergebnisse und Zitate aus dem weg, was es sendet, und versucht die Anfrage einmal erneut, daher wird die Sitzung ohne Anzeige des Fehlers fortgesetzt. Die `encrypted_stdout`-Formulierung hat keine solche Wiederherstellung, daher erreicht diese Nachricht Sie immer noch. Vor v2.1.282 behielt Claude Code die abgelehnten Web-Such-Blöcke auch, und jeder spätere Durchgang und `/compact` schlug auf die gleiche Weise fehl.

2471 2646

2472**Was zu tun ist:**2647**Was zu tun ist:**

2473 2648

2474* Führen Sie `/clear` aus oder starten Sie eine neue Sitzung; das neue Gespräch trägt nicht die abgelehnten Blöcke2649* Wenn Sie auf v2.1.281 oder früher sind und jeder Durchgang mit einer der Web-Such-Formulierungen fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung fort

2475* Wenn Sie Claude Code hinter einem Proxy oder Gateway ausführen, melden Sie den Fehler demjenigen, der ihn betreibt2650* Wenn der Fehler anhält, oder die Nachricht benennt `encrypted_stdout`, führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Durchgang zurückzugehen, der den Inhalt hinzugefügt hat, oder führen Sie `/clear` aus, um ein Gespräch zu starten, das ihn nicht trägt

2651* Wenn Sie Claude Code hinter einem Proxy oder Gateway ausführen, melden Sie den Fehler an denjenigen, der ihn betreibt

2476 2652

2477<h3 id="usage-policy-refusal">2653<h3 id="usage-policy-refusal">

2478 Nutzungsrichtlinie-Ablehnung2654 Richtlinienverletzung

2479</h3>2655</h3>

2480 2656

2481Die API lehnte es ab zu antworten, da Inhalte im Gespräch eine [Nutzungsrichtlinie](https://www.anthropic.com/legal/aup)-Überprüfung auslösten. Die Meldung enthält eine Anfrage-ID, die Sie dem Support zitieren können, wenn Sie glauben, dass die Ablehnung falsch ist.2657Die API lehnte eine Antwort ab, weil Inhalt im Gespräch eine [Nutzungsrichtlinie](https://www.anthropic.com/legal/aup)-Überprüfung auslöste.

2658

2659Die Nachricht enthält eine Request-ID und eine Message-ID, die Sie dem Support zitieren können, wenn Sie glauben, dass die Ablehnung falsch ist.

2482 2660

2483```text theme={null}2661```text theme={null}

2484API Error: Opus 4.6 can't help with this. Start a new session to continue.2662API Error: Opus 4.6 can't help with this. Start a new session to continue.

2486Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup2664Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup

2487```2665```

2488 2666

2489Die Meldung nennt das Modell, das ablehnte, oder `Claude`, wenn kein Modell aufgezeichnet ist.2667Die Nachricht benennt das Modell, das ablehnte, oder `Claude`, wenn kein Modell aufgezeichnet ist.

2490 2668

2491Die Überprüfung bewertet das gesamte Gespräch, nicht nur Ihre neueste Eingabeaufforderung, daher führt das Senden einer neuen Nachricht in derselben Sitzung normalerweise zur gleichen Ablehnung. Dasselbe gilt nach dem Beenden und erneuten Öffnen der Sitzung mit `--continue` oder `--resume`, da das Transkript auf der Festplatte immer noch den auslösenden Inhalt enthält. Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Clouds Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) behandelt diese Meldung auch Anfragen, die die Sicherheitsmaßnahmen des Modells als Cybersicherheitsthema gekennzeichnet haben. Siehe [Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet](#safety-measures-flagged-a-cybersecurity-topic).2669Die Überprüfung bewertet das gesamte Gespräch, nicht nur Ihre neueste Eingabeaufforderung, daher führt das Senden einer neuen Nachricht in der gleichen Sitzung normalerweise zur gleichen Ablehnung. Das Gleiche gilt nach dem Beenden und erneuten Öffnen der Sitzung mit `--continue` oder `--resume`, da das Transkript auf der Festplatte immer noch den auslösenden Inhalt enthält. Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Clouds Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) deckt diese Nachricht auch Anfragen ab, die die Sicherheitsmaßnahmen des Modells als Cybersicherheitsthema gekennzeichnet haben. Siehe [Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet](#safety-measures-flagged-a-cybersecurity-topic).

2492 2670

2493Vor v2.1.219 lautete die Meldung `Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.`2671Vor v2.1.219 lautete die Nachricht `Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.`

2494 2672

2495**Was zu tun ist:**2673**Was zu tun ist:**

2496 2674

2497* Drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um zu einem Checkpoint vor der Runde zurückzugehen, die die Ablehnung auslöste, dann formulieren Sie um oder versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/docs/de/checkpointing).2675* Drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Durchgang zurückzugehen, der die Ablehnung auslöste, dann umformulieren oder versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/docs/de/checkpointing).

2498* Wenn Sie nicht identifizieren können, welche Runde es verursacht hat, führen Sie `/clear` aus, um ein neues Gespräch im selben Projekt zu starten. Ihr vorheriges Gespräch wird auf der Festplatte beibehalten und bleibt in `/resume` verfügbar.2676* Wenn Sie nicht identifizieren können, welcher Durchgang es verursacht hat, führen Sie `/clear` aus, um ein frisches Gespräch im gleichen Projekt zu starten. Ihr vorheriges Gespräch wird auf der Festplatte gespeichert und bleibt in `/resume` verfügbar.

2499* Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`), wo Rewind nicht verfügbar ist, versuchen Sie es erneut mit einer umformulierten Eingabeaufforderung in einer neuen Sitzung ohne `--continue`. Richtlinienüberprüfungen variieren je nach Modell, daher kann ein Wechsel zu einem anderen Modell mit `--model` die Ablehnung in einigen Fällen auch beheben.2677* Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`), wo Rewind nicht verfügbar ist, versuchen Sie es erneut mit einer umformulierten Eingabeaufforderung in einer neuen Sitzung ohne `--continue`. Richtlinien-Überprüfungen variieren je nach Modell, daher kann ein Wechsel zu einem anderen Modell mit `--model` die Ablehnung in einigen Fällen auch beheben.

2500 2678

2501<h3 id="safety-measures-flagged-a-cybersecurity-topic">2679<h3 id="safety-measures-flagged-a-cybersecurity-topic">

2502 Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet2680 Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet

2503</h3>2681</h3>

2504 2682

2505Die Sicherheitsmaßnahmen des Modells haben Inhalte im Gespräch als Cybersicherheitsthema gekennzeichnet. Die Meldung nennt das Modell, das die Anfrage gekennzeichnet hat:2683Die Sicherheitsmaßnahmen des Modells haben Inhalt im Gespräch als Cybersicherheitsthema gekennzeichnet. Die Nachricht benennt das Modell, das die Anfrage gekennzeichnet hat:

2506 2684

2507```text theme={null}2685```text theme={null}

2508API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2686API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2509```2687```

2510 2688

2511Die Meldung verlinkt auf das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), das Zugriff für legitime Cybersicherheitsarbeit gewährt. Auf Opus 5.5, das v2.1.280 oder später erfordert, beginnt die Meldung mit `Opus 5.5's safeguards flagged this session` statt. Wenn die gekennzeichnete Kategorie ein verfügbares Fallback-Modell hat, [wechselt Claude Code Modelle](/docs/de/model-config#automatic-model-fallback), statt diesen Fehler anzuzeigen.2689Die Nachricht verweist auf das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), das Zugriff für legitime Cybersicherheitsarbeit gewährt. Auf Opus 5.5 und Sonnet 5.5 öffnet sich die Nachricht mit `<model>'s safeguards flagged this session` statt. Wenn die gekennzeichnete Kategorie ein verfügbares Fallback-Modell hat, [wechselt Claude Code Modelle](/docs/de/model-config#automatic-model-fallback), anstatt diesen Fehler anzuzeigen.

2512 2690

2513Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Clouds Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) erzeugt eine Cybersicherheits-Kennzeichnung stattdessen die [Nutzungsrichtlinie-Ablehnung](#usage-policy-refusal)-Meldung.2691Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Clouds Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) erzeugt eine Cybersicherheits-Kennzeichnung stattdessen die [Richtlinienverletzungs-Nachricht](#usage-policy-refusal).

2514 2692

2515Die Sicherheitsmaßnahme selbst ist serverseitig und stammt vor v2.1.203; Client-Releases seitdem haben nur die Formulierung der Meldung geändert.2693Die Schutzmaßnahme selbst ist serverseitig und geht dem v2.1.203 voraus; Client-Releases seitdem haben nur die Formulierung der Nachricht geändert.

2516Von v2.1.203 bis v2.1.218 lautete die Meldung `<model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` gefolgt vom gleichen Help-Center-Link, und interaktive Sitzungen hängten `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.` an.2694Von v2.1.203 bis v2.1.218 lautete die Nachricht `<model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` gefolgt vom gleichen Help-Center-Link, und interaktive Sitzungen hängten `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.` an.

2517Vor v2.1.203 lautete es `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` gefolgt von einem Ausnahmeantragsformular-Link.2695Vor v2.1.203 lautete es `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` gefolgt von einem Ausnahmeantragsformular-Link.

2518 2696

2519**Was zu tun ist:**2697**Was zu tun ist:**

2520 2698

2521* Wenn Ihre Arbeit diesen Inhalt erfordert, beantragen Sie Zugriff durch das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)2699* Wenn Ihre Arbeit diesen Inhalt erfordert, beantragen Sie Zugriff durch das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

2522* Wenn Ihre Anfrage nicht über ein Cybersicherheitsthema war, führen Sie `/feedback` aus, um das falsch positive Ergebnis zu melden2700* Wenn Ihre Anfrage nicht über ein Cybersicherheitsthema war, führen Sie `/feedback` aus, um das falsch positive zu melden

2523* Um in derselben Sitzung weiterzuarbeiten, drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um zu einem Checkpoint vor der Runde zurückzugehen, die die Kennzeichnung auslöste, dann versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/docs/de/checkpointing).2701* Um in der gleichen Sitzung weiterzuarbeiten, drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Durchgang zurückzugehen, der die Kennzeichnung auslöste, dann versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/docs/de/checkpointing).

2524 2702

2525<h2 id="installation-errors">2703<h2 id="installation-errors">

2526 Installationsfehler2704 Installationsfehler

2550 Die Verbindung wurde unterbrochen, während die Aktualisierung heruntergeladen wurde2728 Die Verbindung wurde unterbrochen, während die Aktualisierung heruntergeladen wurde

2551</h3>2729</h3>

2552 2730

2553Die Verbindung zum Download-Server wurde geschlossen, während `claude install`, `claude update` oder der [automatische Updater](/docs/de/setup#auto-updates) die Claude Code-Binärdatei abrief, und die Wiederholungen konnten sich nicht erholen. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung steckenbleibt oder die heruntergeladene Datei ihre Prüfsumme nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, wie z. B. ein 404, wird nicht wiederholt, da der Server bereits geantwortet hat. Vor v2.1.202 führte eine einzelne unterbrochene Verbindung sofort zum Fehlschlag des Downloads mit dem bloßen Fehler `aborted` statt zu wiederholen.2731Die Verbindung zum Download-Server wurde geschlossen, während `claude install` oder `claude update` die Claude Code-Binärdatei abrief, und die Wiederholungen konnten sich nicht erholen. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung steckenbleibt oder die heruntergeladene Datei ihre Prüfsumme nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, wie z. B. ein 404, wird nicht wiederholt, da der Server bereits geantwortet hat. Vor v2.1.202 führte eine einzelne unterbrochene Verbindung sofort zum Fehlschlag des Downloads mit dem bloßen Fehler `aborted` statt zu wiederholen.

2554 2732

2555```text theme={null}2733```text theme={null}

2556The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.2734The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

2560 2738

2561Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten abgeschlossen wird, schlägt mit `Download timed out: exceeded the total deadline` fehl. Claude Code wiederholt einen abgelaufenen Download nicht, da eine Verbindung, die zu langsam ist, um innerhalb der Frist abgeschlossen zu werden, auch bei einer sofortigen Wiederholung nicht abgeschlossen wird. Die folgenden Schritte gelten für beide Meldungen.2739Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten abgeschlossen wird, schlägt mit `Download timed out: exceeded the total deadline` fehl. Claude Code wiederholt einen abgelaufenen Download nicht, da eine Verbindung, die zu langsam ist, um innerhalb der Frist abgeschlossen zu werden, auch bei einer sofortigen Wiederholung nicht abgeschlossen wird. Die folgenden Schritte gelten für beide Meldungen.

2562 2740

2563Die häufigste Ursache ist ein Proxy oder Gateway, das eine lange Übertragung beendet, bevor sie abgeschlossen ist. Die Claude Code-Binärdatei ist ein großer Download, daher kann eine Proxy-Verbindungsbegrenzung, die normalen API-Verkehr nie beeinflusst, sie dennoch unterbrechen.2741Ein Proxy oder Gateway kann eine lange Übertragung beenden, bevor sie abgeschlossen ist, und die Claude Code-Binärdatei ist ein großer Download.

2564 2742

2565**Was zu tun ist:**2743**Was zu tun ist:**

2566 2744

2576Diese Fehler stammen aus dem `claude`-Befehl und seinen Unterbefehlen, aus einem Befehlsnamen, den Sie an der Eingabeaufforderung eingeben, und aus Befehlen wie `/security-review`, die Kontext durch Ausführung von Shell-Befehlen sammeln, bevor ihre Eingabeaufforderung ausgeführt wird. Sie stammen auch von `/tui`, das die CLI neu startet.2754Diese Fehler stammen aus dem `claude`-Befehl und seinen Unterbefehlen, aus einem Befehlsnamen, den Sie an der Eingabeaufforderung eingeben, und aus Befehlen wie `/security-review`, die Kontext durch Ausführung von Shell-Befehlen sammeln, bevor ihre Eingabeaufforderung ausgeführt wird. Sie stammen auch von `/tui`, das die CLI neu startet.

2577 2755

2578<h3 id="conflict-between-bg-and-print">2756<h3 id="conflict-between-bg-and-print">

2579 Konflikt zwischen --bg und --print2757 Konflikt zwischen `--bg` und `--print`

2580</h3>2758</h3>

2581 2759

2582Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben `--bg` mit `-p` oder `--print` in derselben `claude`-Invokation kombiniert. `--bg` startet eine [Hintergrund-Sitzung](/docs/de/agent-view#from-your-shell), die Sie später mit `claude agents` anfügen, während `--print` [nicht interaktiv](/docs/de/headless) ausgeführt wird und nie die interaktive Sitzung startet, die `claude agents` anfügt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der nie angefügt werden konnte.2760Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben `--bg` mit `-p` oder `--print` in derselben `claude`-Invokation kombiniert. `--bg` startet eine [Hintergrund-Sitzung](/docs/de/agent-view#from-your-shell), die Sie später mit `claude agents` anfügen, während `--print` [nicht interaktiv](/docs/de/headless) ausgeführt wird und nie die interaktive Sitzung startet, die `claude agents` anfügt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der nie angefügt werden konnte.

2591* Um die Eingabeaufforderung nicht interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrund-Sitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus2769* Um die Eingabeaufforderung nicht interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrund-Sitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus

2592 2770

2593<h3 id="invalid-agents-configuration">2771<h3 id="invalid-agents-configuration">

2594 Ungültige --agents-Konfiguration2772 Ungültige `--agents`-Konfiguration

2595</h3>2773</h3>

2596 2774

2597Der Wert, den Sie an `--agents` übergeben haben, ist ungültig, daher beendet `claude` mit Code 1, anstatt die Sitzung zu starten. Wenn Sie `--safe-mode`, `--resume` oder `--continue` übergeben oder [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars#variables) setzen, überprüft Claude Code den Wert nicht und startet die Sitzung. Vor v2.1.242 hat Claude Code die Sitzung trotzdem gestartet und die Definitionen weggelassen, die nicht geladen werden konnten.2775Der Wert, den Sie an `--agents` übergeben haben, ist ungültig, daher beendet `claude` mit Code 1, anstatt die Sitzung zu starten. Wenn Sie `--safe-mode` übergeben oder [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars#variables) setzen, ignoriert Claude Code `--agents` vollständig. Mit `--resume` oder `--continue` wird ein Inline-JSON-Wert nicht überprüft und die Sitzung startet; ein Wert, der aus einer Datei gelesen wird, wird bei jedem Start überprüft. Vor v2.1.242 hat Claude Code die Sitzung trotzdem gestartet.

2598 2776

2599```text theme={null}2777```text theme={null}

2600Error: Invalid --agents configuration:2778Error: Invalid --agents configuration:

2603 2781

2604Was nach der ersten Zeile folgt, hängt davon ab, wie der Wert fehlgeschlagen ist. Claude Code führt diese Überprüfungen der Reihe nach aus und stoppt bei der ersten, die fehlschlägt. Wenn Ihr Wert zwei Arten von Problemen hat, sehen Sie die zweite erst, nachdem Sie die erste behoben haben:2782Was nach der ersten Zeile folgt, hängt davon ab, wie der Wert fehlgeschlagen ist. Claude Code führt diese Überprüfungen der Reihe nach aus und stoppt bei der ersten, die fehlschlägt. Wenn Ihr Wert zwei Arten von Problemen hat, sehen Sie die zweite erst, nachdem Sie die erste behoben haben:

2605 2783

26061. Wenn der Wert nicht als JSON analysiert wird, druckt Claude Code eine `invalid JSON:`-Zeile mit der eigenen Meldung des JSON-Parsers27841. Wenn der Wert mit `{` beginnt, aber nicht als JSON analysiert wird, oder der Inhalt einer `--agents`-Datei nicht analysiert wird, druckt Claude Code eine `invalid JSON:`-Zeile mit der eigenen Meldung des JSON-Parsers

26072. Wenn er analysiert wird, aber eine Agent-Definition nicht dem Schema für [CLI-definierte Subagenten](/docs/de/sub-agents#choose-the-subagent-scope) entspricht, druckt Claude Code eine Zeile pro Problem27852. Wenn er analysiert wird, aber eine Agent-Definition nicht dem Schema für [CLI-definierte Subagenten](/docs/de/sub-agents#choose-the-subagent-scope) entspricht, druckt Claude Code eine Zeile pro Problem

26083. Wenn ein Agent-Name mit `-` beginnt, druckt Claude Code `<name>: agent names must not start with '-'`27863. Wenn ein Agent-Name mit `-` beginnt, druckt Claude Code `<name>: agent names must not start with '-'`

2609 2787

2610Wenn es mehr als 20 Problemzeilen gibt, druckt Claude Code die ersten 20 und ersetzt den Rest mit `…and N more`.2788Wenn es mehr als 20 Problemzeilen gibt, druckt Claude Code die ersten 20 und ersetzt den Rest mit `…and N more`.

2611 2789

2790Mit `--print` akzeptiert `--agents` auch [den Pfad zu einer JSON-Datei](/docs/de/sub-agents#choose-the-subagent-scope) anstelle des Inline-Objekts. Vor v2.1.281 akzeptierte `--agents` nur Inline-JSON und behandelte einen Dateipfad als ungültiges JSON. Die Dateiform hat ihre eigenen Ablehnungen, die anstelle dieser Meldung gedruckt werden, einschließlich dieser:

2791

2792* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code hat den Wert als Dateipfad in einer interaktiven Sitzung gelesen. Übergeben Sie die Definitionen als Inline-JSON, oder fügen Sie `-p` hinzu, um sie aus einer Datei zu lesen.

2793* **`Error: --agents file not found: <path>`**: Es existiert keine Datei unter diesem Pfad. Ein Wert, der nicht mit `{` beginnt und kein gültiges JSON ist, wird als Pfad gelesen, daher kann Inline-JSON, das Ihre Shell beschädigt hat, auf diese Weise fehlschlagen. Überprüfen Sie den Pfad oder die Anführungszeichen und führen Sie den Befehl erneut aus.

2794

2612**Was zu tun ist:**2795**Was zu tun ist:**

2613 2796

2614* Beheben Sie jedes Problem, das die Meldung auflistet, und führen Sie dann den Befehl erneut aus. Siehe [die Felder, die ein CLI-definierter Subagent benötigt](/docs/de/sub-agents#choose-the-subagent-scope).2797* Beheben Sie jedes Problem, das die Meldung auflistet, und führen Sie dann den Befehl erneut aus. Siehe [die Felder, die ein CLI-definierter Subagent benötigt](/docs/de/sub-agents#choose-the-subagent-scope).

2615 2798

2616<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2799<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">

2617 Cloud-Sitzungen können nicht aus einer --restricted-Sitzung erstellt werden2800 Cloud-Sitzungen können nicht aus einer `--restricted`-Sitzung erstellt werden

2618</h3>2801</h3>

2619 2802

2620Wenn Sie eine Sitzung mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten, weigert sich Claude Code, [Cloud-Sitzungen](/docs/de/claude-code-on-the-web#from-terminal-to-cloud) daraus zu erstellen, da die neue Sitzung außerhalb des eingeschränkten Prozesses ausgeführt würde und den eingeschränkten Modus nicht erzwingen würde. Claude Code weigert sich auf der Client-Seite, bevor der Server kontaktiert wird, daher wird keine Cloud-Sitzung erstellt:2803Wenn Sie eine Sitzung mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten, weigert sich Claude Code, [Cloud-Sitzungen](/docs/de/claude-code-on-the-web#from-terminal-to-cloud) daraus zu erstellen, da die neue Sitzung außerhalb des eingeschränkten Prozesses ausgeführt würde und den eingeschränkten Modus nicht erzwingen würde. Claude Code weigert sich auf der Client-Seite, bevor der Server kontaktiert wird, daher wird keine Cloud-Sitzung erstellt:

2652* Wenn die Meldung besagt, dass die Richtlinie nicht überprüft werden konnte, überprüfen Sie Ihre Netzwerkverbindung, starten Sie Claude Code neu und versuchen Sie es erneut2835* Wenn die Meldung besagt, dass die Richtlinie nicht überprüft werden konnte, überprüfen Sie Ihre Netzwerkverbindung, starten Sie Claude Code neu und versuchen Sie es erneut

2653 2836

2654<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2837<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

2655 Der --json-schema-Wert ist kein gültiges JSON-Schema2838 Der `--json-schema`-Wert ist kein gültiges JSON-Schema

2656</h3>2839</h3>

2657 2840

2658Das Schema, das Sie an [`--json-schema`](/docs/de/cli-reference#cli-flags) in [nicht interaktivem Modus](/docs/de/headless#get-structured-output) übergeben haben, ist bei der JSON-Schema-Kompilierung fehlgeschlagen, daher beendet `claude` mit Code 1, anstatt die Eingabeaufforderung auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das `format`-Schlüsselwort verwendet hat, wurde als ungültig behandelt.2841Das Schema, das Sie an [`--json-schema`](/docs/de/cli-reference#cli-flags) in [nicht interaktivem Modus](/docs/de/headless#get-structured-output) übergeben haben, ist bei der JSON-Schema-Kompilierung fehlgeschlagen, daher beendet `claude` mit Code 1, anstatt die Eingabeaufforderung auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das `format`-Schlüsselwort verwendet hat, wurde als ungültig behandelt.

2668**Was zu tun ist:**2851**Was zu tun ist:**

2669 2852

2670* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus2853* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus

2671* Wenn die Diagnose `schema too large` ist, reduzieren Sie die Verschachtelung und `$ref`-Wiederverwendung des Schemas

2672* Siehe [Strukturierte Ausgabe abrufen](/docs/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl2854* Siehe [Strukturierte Ausgabe abrufen](/docs/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl

2673 2855

2674<h3 id="settings-file-exceeds-the-2mib-limit">2856<h3 id="settings-file-exceeds-the-2mib-limit">

2675 Einstellungsdatei überschreitet das 2-MiB-Limit2857 Einstellungsdatei überschreitet das 2-MiB-Limit

2676</h3>2858</h3>

2677 2859

2678Die Datei, die Sie an [`--settings`](/docs/de/cli-reference#cli-flags) übergeben haben, ist größer als 2 MiB, daher beendet `claude` mit Code 1 beim Start, anstatt sie zu laden. Eine Einstellungsdatei ist ein kleines JSON-Dokument, daher bedeutet eine Datei dieser Größe normalerweise, dass der Pfad auf die falsche Datei zeigt. Vor v2.1.214 hat Claude Code die Datei ohne Größenprüfung gelesen, und eine mehrere Gigabyte große Datei oder eine Gerätedatei wie `/dev/zero` hat den Speicher unbegrenzt vergrößert.2860Die Datei, die Sie an [`--settings`](/docs/de/cli-reference#cli-flags) übergeben haben, ist größer als 2 MiB, daher beendet `claude` mit Code 1 beim Start, anstatt sie zu laden. Vor v2.1.214 hat Claude Code die Datei ohne Größenprüfung gelesen, und eine mehrere Gigabyte große Datei oder eine Gerätedatei wie `/dev/zero` hat den Speicher unbegrenzt vergrößert.

2679 2861

2680```text theme={null}2862```text theme={null}

2681Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2863Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

2756 Arbeitsbereich nicht vertraut beim Starten der Remote-Steuerung2938 Arbeitsbereich nicht vertraut beim Starten der Remote-Steuerung

2757</h3>2939</h3>

2758 2940

2759Sie haben den [Remote-Steuerungs](/docs/de/remote-control)-Servermodus mit `claude remote-control` oder seinem `claude rc`-Alias in einem Verzeichnis gestartet, das Sie nicht vertraut haben. Der Befehl zeigt den Dialog zur Arbeitsbereichsvertrauenswürdigkeit selbst nicht an, daher beendet er mit Code 1 und benennt die Lösung:2941Sie haben den [Remote-Steuerungs](/docs/de/remote-control)-Servermodus mit `claude remote-control` oder seinem `claude rc`-Alias in einem Verzeichnis gestartet, das Sie nicht vertraut haben, und der Befehl konnte Sie nicht fragen, ob Sie ihm vertrauen. Zum Beispiel ist die Standardeingabe oder Standardausgabe des Befehls kein Terminal, weil eine von ihnen umgeleitet oder gepipet wird. Der Befehl beendet sich mit Code 1:

2760 2942

2761```text theme={null}2943```text theme={null}

2762Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.2944Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

2763```2945```

2764 2946

2947Zwei Varianten, die auch mit `Error: Workspace not trusted.` beginnen, werden auch in einem Terminal angezeigt, das zu klein ist, um anzuzeigen, was das Vertrauen in das Verzeichnis aktiviert, oder eines, das seine Größe nicht gemeldet hat. Vergrößern Sie das Fenster oder wechseln Sie zu einem normalen Terminal-Fenster, dann führen Sie `claude rc` erneut aus.

2948

2765In Ihrem Home-Verzeichnis ist die Meldung anders, da der Dialog zur Arbeitsbereichsvertrauenswürdigkeit nie Vertrauen für das Home-Verzeichnis speichert, daher kann das Akzeptieren dort diese Überprüfung nicht erfüllen. Vor v2.1.214 zeigte das Home-Verzeichnis die obige Meldung, deren Rat dort nicht erfolgreich sein kann.2949In Ihrem Home-Verzeichnis ist die Meldung anders, da der Dialog zur Arbeitsbereichsvertrauenswürdigkeit nie Vertrauen für das Home-Verzeichnis speichert, daher kann das Akzeptieren dort diese Überprüfung nicht erfüllen. Vor v2.1.214 zeigte das Home-Verzeichnis die obige Meldung, deren Rat dort nicht erfolgreich sein kann.

2766 2950

2767```text theme={null}2951```text theme={null}

2768Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).2952Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

2769```2953```

2770 2954

2955Wenn Sie `n` antworten oder die Eingabetaste bei der [`Trust <directory>?`-Frage](/docs/de/remote-control#requirements) drücken, druckt der Befehl eine `Remote Control did not start`-Meldung, die das Verzeichnis benennt, und beendet sich mit Code 1. Führen Sie `claude rc` erneut aus, um `y` zu antworten.

2956

2771**Was zu tun ist:**2957**Was zu tun ist:**

2772 2958

2773* Führen Sie `claude` im Verzeichnis aus, akzeptieren Sie den [Dialog zur Arbeitsbereichsvertrauenswürdigkeit](/docs/de/permissions#project-allow-rules-and-workspace-trust), und führen Sie dann `claude remote-control` erneut aus2959* Vertrauen Sie dem Verzeichnis zuerst von einem Terminal aus: Führen Sie `claude rc` dort aus und antworten Sie `y`, oder führen Sie `claude` dort aus und akzeptieren Sie den [Dialog zur Arbeitsbereichsvertrauenswürdigkeit](/docs/de/permissions#project-allow-rules-and-workspace-trust), dann führen Sie Ihren ursprünglichen Befehl erneut aus

2774* Wechseln Sie in Ihrem Home-Verzeichnis zu einem Projektverzeichnis und starten Sie die Remote-Steuerung dort2960* Wechseln Sie in Ihrem Home-Verzeichnis zu einem Projektverzeichnis und starten Sie die Remote-Steuerung dort

2775 2961

2962Vor v2.1.284 fragte der Befehl nie, auch nicht in einem Terminal.

2963

2776<h3 id="not-carried-over-to-the-sessions-remote-control-starts">2964<h3 id="not-carried-over-to-the-sessions-remote-control-starts">

2777 Nicht übertragen auf die Sitzungen, die Remote-Steuerung startet2965 Nicht übertragen auf die Sitzungen, die Remote-Steuerung startet

2778</h3>2966</h3>

2834 Server konnte nicht aus Claude Desktop importiert werden3022 Server konnte nicht aus Claude Desktop importiert werden

2835</h3>3023</h3>

2836 3024

2837Claude Code konnte einen der Server, die Sie in `claude mcp add-from-claude-desktop` ausgewählt haben, nicht hinzufügen. Der Befehl importiert immer noch die anderen ausgewählten Server und druckt eine Zeile pro Server, den er nicht hinzufügen konnte. Vor v2.1.205 hat der erste Server, der fehlgeschlagen ist, den Import gestoppt und keiner der ausgewählten Server wurde hinzugefügt.3025Claude Code konnte einen der Server, die Sie in `claude mcp add-from-claude-desktop` ausgewählt haben, nicht hinzufügen. Der Befehl importiert immer noch die anderen ausgewählten Server und druckt eine Zeile pro Server, den er nicht hinzufügen konnte. Vor v2.1.205 hat der erste Server, der fehlgeschlagen ist, den Import gestoppt.

2838 3026

2839```text theme={null}3027```text theme={null}

2840Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3028Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

2918 MCP-Berechtigungsaufforderungs-Tool nicht gefunden3106 MCP-Berechtigungsaufforderungs-Tool nicht gefunden

2919</h3>3107</h3>

2920 3108

2921Das Tool, das Sie an [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) übergeben haben, war nicht unter den verbundenen MCP-Tools, als der Lauf zuerst eine Berechtigungsentscheidung benötigte, entweder weil sein Server nie verbunden wurde oder weil kein verbundener Server ein Tool mit diesem Namen verfügbar macht. Claude Code sendet Ihre Eingabeaufforderung immer noch: Der [nicht interaktive](/docs/de/headless) Lauf beendet sich mit diesem Fehler und Exit-Code 1 beim ersten Tool-Aufruf, der Genehmigung benötigt, daher erzeugt er keine Antwort, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zu dem pro-Server-Verbindungs-Timeout von 30 Sekunden, der durch [`MCP_TIMEOUT`](/docs/de/env-vars) gesetzt ist, damit dieser Server verbunden wird. Vor v2.1.206 wartete der Start nicht, bis der Server die Verbindung beendete, daher erzeugte ein langsam startender, aber gesunder Server auch diesen Fehler.3109Das Tool, das Sie an [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) übergeben haben, war nicht unter den verbundenen MCP-Tools, als der Lauf zuerst eine Berechtigungsentscheidung benötigte, entweder weil sein Server nie verbunden wurde oder weil kein verbundener Server ein Tool mit diesem Namen verfügbar macht. Claude Code sendet Ihre Eingabeaufforderung immer noch: Der [nicht interaktive](/docs/de/headless) Lauf beendet sich mit diesem Fehler und Exit-Code 1 beim ersten Tool-Aufruf, daher erzeugt er keine Antwort, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zu dem pro-Server-Verbindungs-Timeout von 30 Sekunden, der durch [`MCP_TIMEOUT`](/docs/de/env-vars) gesetzt ist, damit dieser Server verbunden wird. Vor v2.1.206 wartete der Start nicht, bis der Server die Verbindung beendete, daher erzeugte ein langsam startender, aber gesunder Server auch diesen Fehler.

2922 3110

2923```text theme={null}3111```text theme={null}

2924Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3112Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

2998* Wenn das Repository keinen Remote hat, fügen Sie einen mit `git remote add origin <url>` hinzu und rufen Sie ab, bevor Sie die Ref erstellen. Wenn der Remote leer ist, pushen Sie Ihren Branch zuerst mit `git push -u origin HEAD` und benennen Sie diesen Branch im set-head-Befehl; `origin/HEAD` zeigt dann auf den Branch, den Sie gerade gepusht haben, daher sieht `/security-review` einen leeren Diff, bis der Branch von ihm abweicht.3186* Wenn das Repository keinen Remote hat, fügen Sie einen mit `git remote add origin <url>` hinzu und rufen Sie ab, bevor Sie die Ref erstellen. Wenn der Remote leer ist, pushen Sie Ihren Branch zuerst mit `git push -u origin HEAD` und benennen Sie diesen Branch im set-head-Befehl; `origin/HEAD` zeigt dann auf den Branch, den Sie gerade gepusht haben, daher sieht `/security-review` einen leeren Diff, bis der Branch von ihm abweicht.

2999 3187

3000<h3 id="input-must-be-provided-when-using-print">3188<h3 id="input-must-be-provided-when-using-print">

3001 Eingabe muss bereitgestellt werden, wenn --print verwendet wird3189 Eingabe muss bereitgestellt werden, wenn `--print` verwendet wird

3002</h3>3190</h3>

3003 3191

3004Bare `claude` benötigt stdout, um ein Terminal zu sein, um die interaktive UI zu starten. Wenn stdout umgeleitet wird oder die Konsole kein echtes Terminal ist, wie PowerShell ISE und einige IDE-Ausgabebereiche, führt `claude` stattdessen [nicht interaktiv](/docs/de/headless) aus. Das ist derselbe Modus wie `claude -p`, der eine Eingabeaufforderung erfordert, daher benennt die Meldung `--print`, auch wenn Sie das Flag nicht übergeben haben. Das Übergeben von `-p`/`--print` ohne Eingabeaufforderung und nichts auf stdin erzeugt überall denselben Fehler.3192Bare `claude` benötigt stdout, um ein Terminal zu sein, um die interaktive UI zu starten. Wenn stdout umgeleitet wird oder die Konsole kein echtes Terminal ist, wie PowerShell ISE und einige IDE-Ausgabebereiche, führt `claude` stattdessen [nicht interaktiv](/docs/de/headless) aus. Das ist derselbe Modus wie `claude -p`, der eine Eingabeaufforderung erfordert, daher benennt die Meldung `--print`, auch wenn Sie das Flag nicht übergeben haben. Das Übergeben von `-p`/`--print` ohne Eingabeaufforderung und nichts auf stdin erzeugt überall denselben Fehler.

3269* Für eine interaktive Sitzung öffnen Sie die [Sitzungsauswahl](/docs/de/sessions#use-the-session-picker) mit `claude --resume` und drücken Sie `Ctrl+A`, um sie auf jedes Projekt auf dieser Maschine zu erweitern, dann wählen Sie die Sitzung3457* Für eine interaktive Sitzung öffnen Sie die [Sitzungsauswahl](/docs/de/sessions#use-the-session-picker) mit `claude --resume` und drücken Sie `Ctrl+A`, um sie auf jedes Projekt auf dieser Maschine zu erweitern, dann wählen Sie die Sitzung

3270* Sitzungen, die mit `claude -p` oder dem [Agent SDK](/docs/de/agent-sdk/overview) erstellt wurden, erscheinen nicht in der Auswahl, daher überprüfen Sie die ID erneut gegen die `session_id`, die Ihr ursprünglicher Lauf gedruckt hat3458* Sitzungen, die mit `claude -p` oder dem [Agent SDK](/docs/de/agent-sdk/overview) erstellt wurden, erscheinen nicht in der Auswahl, daher überprüfen Sie die ID erneut gegen die `session_id`, die Ihr ursprünglicher Lauf gedruckt hat

3271 3459

3460<h3 id="windows-reported-an-error-ebadf">

3461 Windows meldete einen Fehler (EBADF), als Claude Code diese Sitzungs-Transkriptdatei las

3462</h3>

3463

3464Sie haben eine Sitzung unter Windows fortgesetzt, ihre gespeicherte [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) wurde normal geöffnet, und das Lesen schlug dann mit dem Systemfehler EBADF fehl. Der Systemfehler sagt nicht, warum das Lesen fehlgeschlagen ist, daher schlägt die Meldung wahrscheinliche Ursachen und was zu versuchen ist vor:

3465

3466```text theme={null}

3467Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

3468```

3469

3470Die Meldung folgt der Fehlerleitung des Befehls selbst, wie `Failed to resume session <session-id>`. Ein `claude --resume` oder [`claude -p`](/docs/de/headless)-Befehl beendet sich mit Code 1 nach Anzeige. Nach `/resume` in einer Sitzung läuft Ihre aktuelle Sitzung weiter.

3471

3472**Was zu tun ist:**

3473

3474* Schließen Sie den Ordner aus, der Ihre Sitzungs-Transkripte enthält, von Software aus, die Dateilesevorgänge scannt oder abfängt, wie Sicherheits-, Verschlüsselungs- oder Endpoint-Management-Tools. Transkripte befinden sich standardmäßig unter `%USERPROFILE%\.claude\projects` oder unter dem Verzeichnis, das [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) benennt

3475* Wenn Sie keine Ausschlussmöglichkeit hinzufügen können, fügen Sie Claude Code stattdessen zu den zulässigen Anwendungen dieser Software hinzu

3476* Setzen Sie die Sitzung erneut fort

3477

3478Vor v2.1.282 kam der Fehler ohne Erklärung: `claude --resume <session-id>` endete bei `Failed to resume session <session-id>`, und ein `-p`-Lauf druckte nur den Systemfehlertext, wie `Failed to resume session: EBADF: bad file descriptor, read`.

3479

3272<h3 id="cannot-switch-renderers-in-this-session">3480<h3 id="cannot-switch-renderers-in-this-session">

3273 Renderer können in dieser Sitzung nicht gewechselt werden3481 Renderer können in dieser Sitzung nicht gewechselt werden

3274</h3>3482</h3>

3417 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert3625 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert

3418</h3>3626</h3>

3419 3627

3420Der Marketplace ist unter einem Namen registriert, der [für offizielle Anthropic-Marketplaces reserviert ist](/docs/de/plugins/marketplace-reference#marketplace-file), aber seine registrierte Quelle ist kein `anthropics` GitHub-Repository. Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marketplace lädt oder aktualisiert, sodass der Marketplace und die von ihm installierten Plugins nicht mehr geladen werden. Vor v2.1.205 wurde der Name nur überprüft, wenn der Marketplace hinzugefügt wurde, sodass ein Eintrag, der registriert wurde, bevor sein Name reserviert wurde, weiterhin geladen wurde.3628Der Marketplace ist unter einem Namen registriert, der [für offizielle Anthropic-Marketplaces reserviert ist](/docs/de/plugins/marketplace-reference#marketplace-file), aber seine registrierte Quelle ist kein `anthropics` GitHub-Repository. Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marketplace lädt oder aktualisiert, sodass der Marketplace und die von ihm installierten Plugins nicht mehr geladen werden. Vor v2.1.205 wurde ein Eintrag, der registriert wurde, bevor sein Name reserviert wurde, weiterhin geladen.

3421 3629

3422```text theme={null}3630```text theme={null}

3423Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.3631Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

3454* Benennen Sie den Marketplace in einen Namen um, der keine reservierte Schreibweise darstellt, und fügen Sie ihn erneut hinzu3662* Benennen Sie den Marketplace in einen Namen um, der keine reservierte Schreibweise darstellt, und fügen Sie ihn erneut hinzu

3455* Für die Warnung zu ignoriertem Eintrag führen Sie den `claude plugin marketplace remove`-Befehl aus, den sie angibt, oder entfernen Sie den Eintrag aus `~/.claude/plugins/known_marketplaces.json`3663* Für die Warnung zu ignoriertem Eintrag führen Sie den `claude plugin marketplace remove`-Befehl aus, den sie angibt, oder entfernen Sie den Eintrag aus `~/.claude/plugins/known_marketplaces.json`

3456 3664

3665<h3 id="claude-code-refuses-the-marketplace-name">

3666 Claude Code lehnt den Marketplace-Namen ab

3667</h3>

3668

3669Ein registrierter Marketplace-Name [gibt sich als offizieller Anthropic-Marketplace aus](/docs/de/plugins/marketplace-reference#reserved-names) nach den Regeln, die dieser Abschnitt auflistet.

3670

3671Wenn ein Marketplace unter einem solchen Namen registriert wurde, bevor die Überprüfung ihn blockierte, werden der Marketplace und die von ihm installierten Plugins nicht mehr geladen, da Claude Code den Namen jedes Mal überprüft, wenn es den Katalog des Marketplace liest. Wenn der Name einen offiziellen Namen imitiert, melden `claude plugin list` und die `/plugin` **Fehler**-Registerkarte jedes betroffene Plugin mit einer Meldung, die beginnt mit:

3672

3673```text theme={null}

3674Claude Code refuses the marketplace name "anthropic-plugins-v2"

3675```

3676

3677Für einen imitierenden Namen lautet die Fehlermeldung des Marketplace selbst `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` statt dessen. `claude plugin marketplace add` lehnt jeden imitierenden Namen mit `Marketplace name impersonates an official Anthropic/Claude marketplace` ab.

3678

3679Vor v2.1.282 meldeten `claude plugin list` und `/plugin` die Plugins eines imitierenden Namens als fehlgeschlagen beim Laden, ohne den Namen des Marketplace als Ursache zu nennen.

3680

3681**Was zu tun ist:**

3682

3683* Führen Sie `claude plugin marketplace remove <name>` aus. Dies deinstalliert auch die von dem Marketplace installierten Plugins und löscht ihre gespeicherten Daten

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

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

3686

3457<h3 id="marketplace-is-already-added-from-a-different-source">3687<h3 id="marketplace-is-already-added-from-a-different-source">

3458 Marketplace ist bereits von einer anderen Quelle hinzugefügt3688 Marketplace ist bereits von einer anderen Quelle hinzugefügt

3459</h3>3689</h3>

3656 3886

3657* Bitten Sie einen Administrator Ihrer claude.ai-Organisation, den erforderlichen Status des Plugins auf claude.ai zu ändern3887* Bitten Sie einen Administrator Ihrer claude.ai-Organisation, den erforderlichen Status des Plugins auf claude.ai zu ändern

3658 3888

3889<h3 id="plugin-was-not-uninstalled">

3890 Plugin wurde nicht deinstalliert

3891</h3>

3892

3893Sie haben [`claude plugin uninstall`](/docs/de/plugins/cli-reference#plugin-uninstall) ausgeführt oder **Deinstallieren** in der `/plugin` **Installiert**-Registerkarte gewählt, und die Deinstallation wurde mit einer Meldung gestoppt, die mit `"<plugin>" was not uninstalled:` beginnt.

3894

3895Wenn Claude Code den Plugin-Eintrag aus `enabledPlugins` entfernte und die Einstellungsdateien dieses Bereichs erneut las, war das Plugin entweder immer noch dort eingeschaltet, oder eine Datei, die es einschalten könnte, konnte nicht gelesen oder überprüft werden. Das Löschen der gespeicherten Optionen, Geheimnisse und Daten des Plugins, während ein Einstellungseintrag es wieder einschalten könnte, würde sie verlieren, daher wird die Deinstallation stattdessen gestoppt: Das Plugin bleibt installiert und nichts, das es gespeichert hat, wird gelöscht.

3896

3897```text theme={null}

3898✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.

3899```

3900

3901Die Mitte der Meldung benennt die Datei und die Ursache:

3902

3903* `it is still switched on in <file>, although the settings change reported no error`: Der Einstellungsschreib-Vorgang meldete Erfolg, aber der Eintrag ist immer noch dort, wenn die Datei erneut gelesen wird

3904* `it is still switched on in <file>, and the settings change failed (<error>)`: Die Datei konnte nicht gespeichert werden, aus dem Grund in Klammern

3905* `<file> is there and could not be read`: Die Datei existiert, aber konnte nicht als Einstellungen gelesen werden, z. B. weil sie kein gültiges JSON ist, daher könnte sie das Plugin immer noch aktivieren

3906* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code hat die Projekt- oder lokale Einstellungsdatei nicht gelesen, weil die Datei oder der `.claude`-Ordner, der sie enthält, ein Link ist, der zu einem Netzwerkort führt, oder weil dieser Pfad nicht untersucht werden konnte

3907

3908`claude plugin uninstall` beendet mit Exit-Code 1, und mit `--json` trägt das Ergebnis `failureCode: "settings_still_on"`. `/plugin` zeigt die gleiche Meldung.

3909

3910**Was zu tun ist:**

3911

3912* Folgen Sie dem letzten Satz der Meldung: Reparieren oder ersetzen Sie die Einstellungsdatei, die sie benennt, oder entfernen Sie den Plugin-Eintrag aus `enabledPlugins` in dieser Datei selbst, und führen Sie dann die Deinstallation erneut aus

3913

3659<h2 id="tool-errors">3914<h2 id="tool-errors">

3660 Tool-Fehler3915 Tool-Fehler

3661</h2>3916</h2>

3705* Wenn Claude die Datei ändern können sollte, entfernen oder verengen Sie die `Read`-Ablehnungsregel in `/permissions` oder in [Einstellungen](/docs/de/settings-reference#permission-settings)3960* Wenn Claude die Datei ändern können sollte, entfernen oder verengen Sie die `Read`-Ablehnungsregel in `/permissions` oder in [Einstellungen](/docs/de/settings-reference#permission-settings)

3706* Wenn die Datei unverändert bleiben muss, behalten Sie die Regel und fügen Sie eine `Edit`-Ablehnungsregel für denselben Pfad hinzu, um auch das NotebookEdit-Tool zu blockieren3961* Wenn die Datei unverändert bleiben muss, behalten Sie die Regel und fügen Sie eine `Edit`-Ablehnungsregel für denselben Pfad hinzu, um auch das NotebookEdit-Tool zu blockieren

3707 3962

3963<h3 id="path-cannot-contain-null-bytes">

3964 Pfad kann keine Null-Bytes enthalten

3965</h3>

3966

3967Ein Datei-Tool-Aufruf mit Pfad- oder Muster-Argument enthielt ein Null-Byte, das Dateisysteme und Such-Tools nicht akzeptieren können. Read, Write, Edit, NotebookEdit, Glob und Grep überprüfen dies, und die Nachricht benennt das Tool und das Argument:

3968

3969```text theme={null}

3970Read file_path kann keine Null-Bytes (\0) enthalten. Entfernen Sie das Null-Byte und versuchen Sie es erneut.

3971```

3972

3973Der Tool-Aufruf schlägt fehl, Claude sieht den Fehler, und der Zug wird fortgesetzt.

3974

3975**Was zu tun ist:**

3976

3977* Nichts auf Ihrer Seite: Der Fehler wird an Claude als Ergebnis des Tools zurückgegeben, und die Nachricht selbst teilt Claude mit, das Null-Byte zu entfernen und es erneut zu versuchen

3978

3979Vor v2.1.281 endete ein Null-Byte in einem Read-, Write-, Edit- oder NotebookEdit-Pfad den ganzen Zug mit einem Fehler, der `Pfad enthält Null-Bytes` benannte, und das Tool wurde nie ausgeführt.

3980

3708<h3 id="subagent-type-is-required">3981<h3 id="subagent-type-is-required">

3709 subagent\_type ist erforderlich3982 subagent\_type ist erforderlich

3710</h3>3983</h3>

3841 4114

3842Vor v2.1.236 meldete Claude Code diese Sends als gesendet. Die empfangende Sitzung ließ sie ungelesen fallen.4115Vor v2.1.236 meldete Claude Code diese Sends als gesendet. Die empfangende Sitzung ließ sie ungelesen fallen.

3843 4116

4117<h3 id="cross-session-message-dropped-at-the-inbox">

4118 Sitzungsübergreifende Nachricht wurde am Posteingang der Empfänger-Sitzung gelöscht

4119</h3>

4120

4121Claude sendete eine [sitzungsübergreifende Nachricht](/docs/de/cross-session-messaging) an eine andere Ihrer Sitzungen auf dieser Maschine, und die Inbox dieser Sitzung verwarf sie, bevor Claude in dieser Sitzung sie las. Die Zeile benennt die Adresse des Empfängers und, wenn der Empfänger einen Grund angab, fügt den Grund nach einem Bindestrich hinzu:

4122

4123```text wrap theme={null}

4124Sitzungsübergreifende Nachricht wurde am Posteingang der Empfänger-Sitzung gelöscht (Empfänger: uds:/tmp/cc-socks/13605.sock) und nicht zugestellt — ihre Warteschlange von unzugestellten Peer-Nachrichten war voll. Claude wurde mitgeteilt, nicht sofort erneut zu senden.

4125```

4126

4127Eine Zeile kann mehrere gelöschte Nachrichten abdecken. Sie beginnt dann im Plural, zum Beispiel `Sitzungsübergreifende Nachrichten (12) wurden am Posteingang gelöscht`. Um zu finden, welche Sitzung eine Adresse gehört, vergleichen Sie sie mit der [`Peer address`-Zeile](/docs/de/cross-session-messaging#the-sessions-inbox-socket), die `/status` in jeder Sitzung anzeigt.

4128

4129Nach dem Bindestrich gibt die Zeile einen oder mehrere dieser Gründe an:

4130

4131* `ihre Warteschlange von unzugestellten Peer-Nachrichten war voll`: Der Empfänger hielt bereits so viele unzugestellte Nachrichten von anderen Sitzungen, wie seine Warteschlange zulässt

4132* `Sie sendeten schneller als diese Sitzung akzeptiert`: Die Nachrichten der sendenden Sitzung kamen schneller an, als der Empfänger von einem Absender akzeptiert

4133* `es wiederholte Ihre vorherige Nachricht`: Die Nachricht war identisch mit einer, die die sendende Sitzung diesem Empfänger kurz zuvor sendete

4134* `eine Relay-Schleife zwischen Sitzungen wurde unterbrochen`: Die Nachricht setzte eine Kette von Sitzungen fort, die sich gegenseitig kontaktierten, und die Kette war zu viele Male durch den Empfänger gegangen oder zu lang geworden

4135

4136**Was zu tun ist:**

4137

4138* Gehen Sie davon aus, dass der Empfänger die gelöschten Nachrichten nie sah. Claude Code teilt Claude dasselbe mit, und teilt ihm mit, alles, das immer noch wichtig ist, stattdessen in eine spätere Nachricht einzubeziehen, anstatt sofort erneut zu senden

4139* Wenn Ihre Sitzungen sich häufig gegenseitig Updates senden, bitten Sie Claude, weniger, größere Nachrichten zu senden, wie einen Bericht, wenn eine Sitzung ihre Arbeit beendet

4140* Für `eine Relay-Schleife zwischen Sitzungen wurde unterbrochen`, geben Sie die nächste Anweisung selbst in eine der Sitzungen ein. Eine Nachricht, die Claude als Antwort auf Ihre eigene Eingabeaufforderung sendet, beginnt eine neue Kette

4141

4142Vor v2.1.238 erhielt die sendende Sitzung keinen Bericht, wenn die Inbox des Empfängers eine Nachricht verwarf.

4143

3844<h3 id="refusing-to-send-a-cross-session-message">4144<h3 id="refusing-to-send-a-cross-session-message">

3845 Weigerung, eine sitzungsübergreifende Nachricht zu senden4145 Weigerung, eine sitzungsübergreifende Nachricht zu senden

3846</h3>4146</h3>

3855 4155

3856* `Antwortziel ist ein Symlink`: Ein symbolischer Link sitzt am Socket-Pfad der Ziel-Sitzung. Claude Code liefert nicht durch ihn, weil ein Link dort die Nachricht zu einem Endpunkt umleiten könnte, den die Ziel-Sitzung nicht erstellt hat.4156* `Antwortziel ist ein Symlink`: Ein symbolischer Link sitzt am Socket-Pfad der Ziel-Sitzung. Claude Code liefert nicht durch ihn, weil ein Link dort die Nachricht zu einem Endpunkt umleiten könnte, den die Ziel-Sitzung nicht erstellt hat.

3857* `Antwortziel kann nicht überprüft werden`: Claude Code konnte den Zielpfad überhaupt nicht überprüfen, zum Beispiel weil das Lesen mit einem Berechtigungsfehler fehlschlug.4157* `Antwortziel kann nicht überprüft werden`: Claude Code konnte den Zielpfad überhaupt nicht überprüfen, zum Beispiel weil das Lesen mit einem Berechtigungsfehler fehlschlug.

3858* `Verbundener Endpunkt ist nicht der erwartete Prozess`: Der Prozess, der den Socket hält, ist nicht die Sitzung, an die die Nachricht adressiert wurde, daher ist die Adresse veraltet oder ein anderer Prozess hat den Socket ersetzt.

3859* `Verbundene Endpunkt-Identität konnte nicht gelesen werden`: Claude Code verbunden, konnte aber nicht lesen, welcher Prozess das andere Ende hält, daher konnte es das Ziel nicht bestätigen. Dies kann vorübergehend sein.

3860* `Verbundener Endpunkt wird nicht von diesem Benutzer besessen`: Der Prozess, der den Socket hält, läuft unter einem anderen Benutzerkonto, daher ist es nicht eine Ihrer Sitzungen.

3861* `Verbundene Endpunkt-Besitzer konnte nicht gelesen werden`: Claude Code verbunden, konnte aber nicht lesen, welches Benutzerkonto das andere Ende besitzt, daher konnte es nicht bestätigen, dass der Endpunkt Ihnen gehört.

3862* `Verbundener Endpunkt ist ein anderer Prozess mit der erwarteten PID`: Die Prozess-ID stimmt mit der überein, an die die Nachricht adressiert wurde, aber Claude Code konnte nicht bestätigen, dass es derselbe Prozess ist. Normalerweise hat diese Sitzung beendet und das Betriebssystem hat ihre Prozess-ID wiederverwendet, daher ist die Adresse veraltet.

3863 4158

3864**Was zu tun ist:**4159**Was zu tun ist:**

3865 4160

3866* Normalerweise nichts: Die Überprüfungen verhindern, dass eine Nachricht einen anderen Endpunkt als die Sitzung erreicht, an die sie adressiert wurde, und nichts wurde gesendet4161* Normalerweise nichts: Die Überprüfungen verhindern, dass eine Nachricht einen anderen Endpunkt als die Sitzung erreicht, an die sie adressiert wurde, und nichts wurde gesendet

3867* Bitten Sie Claude, Ihre Sitzungen erneut aufzulisten und erneut zu senden; eine Weigerung, die durch eine veraltete Adresse verursacht wird, wird gelöscht, sobald Claude an die aktuelle sendet

3868* Wenn `Antwortziel ist ein Symlink` für eine Sitzung wiederholt wird, überprüfen Sie, was einen Link am Socket-Pfad dieser Sitzung erstellt hat, angezeigt in ihrem `/status` unter `Peer address`4162* Wenn `Antwortziel ist ein Symlink` für eine Sitzung wiederholt wird, überprüfen Sie, was einen Link am Socket-Pfad dieser Sitzung erstellt hat, angezeigt in ihrem `/status` unter `Peer address`

3869* Für `Verbundene Endpunkt-Identität konnte nicht gelesen werden`, erneut senden; die Bedingung kann vorübergehend sein

3870* Wenn `Verbundener Endpunkt wird nicht von diesem Benutzer besessen` auf einer gemeinsamen Maschine erscheint, läuft die Sitzung unter diesem Endpunkt unter einem anderen Benutzerkonto, daher kann Claude sie nicht von Ihrem aus kontaktieren

~~3871~~

3872Vor v2.1.248 überprüfte Claude Code nicht den Besitzer des Endpunkts oder die Prozess-Startzeit, daher erscheinen die Verweigerungen, die diese Überprüfungen benennen, nicht auf früheren Versionen.

3873 4163

3874<h3 id="refusing-after-a-symlink-changed">4164<h3 id="refusing-after-a-symlink-changed">

3875 Weigerung, einen Pfad zu lesen, zu schreiben oder zu durchsuchen4165 Weigerung, einen Pfad zu lesen, zu schreiben oder zu durchsuchen

3885 4175

3886* `Seine Symlink-Auflösung änderte sich nach der Berechtigungsprüfung`: Ein Symlink entlang des Pfads, oder bei einer Grep- oder Glob-Suchwurzel, wurde zwischen der Berechtigungsprüfung und der Operation ersetzt. In einer Leseverweigerung benennt der eingeklammerte Satz, welcher Vergleich fehlschlug.4176* `Seine Symlink-Auflösung änderte sich nach der Berechtigungsprüfung`: Ein Symlink entlang des Pfads, oder bei einer Grep- oder Glob-Suchwurzel, wurde zwischen der Berechtigungsprüfung und der Operation ersetzt. In einer Leseverweigerung benennt der eingeklammerte Satz, welcher Vergleich fehlschlug.

3887* `Seine Symlink-Auflösung des übergeordneten Verzeichnisses änderte sich nach der Berechtigungsprüfung`: Ein Verzeichnis, das der Schreibpfad durchläuft, wird nicht mehr zu dem genehmigten Ort aufgelöst4177* `Seine Symlink-Auflösung des übergeordneten Verzeichnisses änderte sich nach der Berechtigungsprüfung`: Ein Verzeichnis, das der Schreibpfad durchläuft, wird nicht mehr zu dem genehmigten Ort aufgelöst

4178* `Wo es auf der Festplatte führt, konnte nicht bestimmt werden (ein Link auf dem Weg konnte nicht untersucht werden, oder die Links werden nicht aufgelöst)`: Claude Code konnte dem Pfad nicht zu einem endgültigen Ort auf der Festplatte folgen, zum Beispiel weil Symlinks darauf eine Schleife bilden

3888* `Es ist ein symbolischer Link. Schreiben Sie stattdessen zum Ziel-Pfad des Links`: Ein Symlink sitzt am genehmigten Schreibort selbst, zum Beispiel eine `CLAUDE.md`, die ein Symlink zu `AGENTS.md` ist; die Nachricht leitet Claude zum Ziel des Links4179* `Es ist ein symbolischer Link. Schreiben Sie stattdessen zum Ziel-Pfad des Links`: Ein Symlink sitzt am genehmigten Schreibort selbst, zum Beispiel eine `CLAUDE.md`, die ein Symlink zu `AGENTS.md` ist; die Nachricht leitet Claude zum Ziel des Links

3889* `Weigerung, durch Symlink zu schreiben: <path>. Lösen Sie den Symlink auf und übergeben Sie den echten Ziel-Pfad explizit.`: dieselbe Bedingung, die erfasst wird, wenn ein anderer Schreiber die Datei öffnet, wie ein Schreiben zu einer verlinkten `.mcp.json`4180* `Weigerung, durch Symlink zu schreiben: <path>. Lösen Sie den Symlink auf und übergeben Sie den echten Ziel-Pfad explizit.`: dieselbe Bedingung, die erfasst wird, wenn ein anderer Schreiber die Datei öffnet, wie ein Schreiben zu einer verlinkten `.mcp.json`

3890* `Weigerung, in ein verlinktes Verzeichnis zu schreiben: <path>`: Das Verzeichnis, das die Datei hält, ist selbst ein symbolischer Link, zum Beispiel das `.claude/`-Verzeichnis eines Projekts, das mit einem anderen Ort verlinkt ist4181* `Weigerung, in ein verlinktes Verzeichnis zu schreiben: <path>`: Das Verzeichnis, das die Datei hält, ist selbst ein symbolischer Link, zum Beispiel das `.claude/`-Verzeichnis eines Projekts, das mit einem anderen Ort verlinkt ist

3903 4194

3904Vor v2.1.251 überprüfte Claude Code die Auflösung eines Pfads nur für Dateischreibvorgänge erneut, daher konnte ein Link, der nach der Berechtigungsprüfung ersetzt wurde, eine Lese- oder Suche zu einem anderen Ort umleiten, ohne eine Nachricht. Von diesen Verweigerungen erscheint nur die Schreibverweigerung des übergeordneten Verzeichnisses auf früheren Versionen.4195Vor v2.1.251 überprüfte Claude Code die Auflösung eines Pfads nur für Dateischreibvorgänge erneut, daher konnte ein Link, der nach der Berechtigungsprüfung ersetzt wurde, eine Lese- oder Suche zu einem anderen Ort umleiten, ohne eine Nachricht. Von diesen Verweigerungen erscheint nur die Schreibverweigerung des übergeordneten Verzeichnisses auf früheren Versionen.

3905 4196

4197Vor v2.1.280 erschien die `Wo es auf der Festplatte führt, konnte nicht bestimmt werden`-Weigerung nicht.

4198

3906<h3 id="task-output-swap-refused">4199<h3 id="task-output-swap-refused">

3907 Task-Ausgabe-Swap abgelehnt4200 Task-Ausgabe-Swap abgelehnt

3908</h3>4201</h3>

3928* Oder überprüfen Sie Ihr Projektverzeichnis unter dem Claude Code-Temp-Verzeichnis, `/private/tmp/claude-501/-Users-you-my-project` in der Beispielnachricht. Wenn dieser Pfad ein Symlink ist, oder ein Verzeichnis, das nicht dort sein sollte, entfernen Sie den Link oder das Verzeichnis selbst, anstatt das Ziel des Links, und starten Sie Claude Code neu4221* Oder überprüfen Sie Ihr Projektverzeichnis unter dem Claude Code-Temp-Verzeichnis, `/private/tmp/claude-501/-Users-you-my-project` in der Beispielnachricht. Wenn dieser Pfad ein Symlink ist, oder ein Verzeichnis, das nicht dort sein sollte, entfernen Sie den Link oder das Verzeichnis selbst, anstatt das Ziel des Links, und starten Sie Claude Code neu

3929* Wenn die Weigerung wiederholt wird, ersetzt, verlinkt oder entfernt ein Prozess Einträge unter Claudes Temp-Verzeichnis, während die Sitzung läuft. Setzen Sie [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) auf ein Verzeichnis, das nichts anderes verwaltet, und starten Sie neu4222* Wenn die Weigerung wiederholt wird, ersetzt, verlinkt oder entfernt ein Prozess Einträge unter Claudes Temp-Verzeichnis, während die Sitzung läuft. Setzen Sie [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) auf ein Verzeichnis, das nichts anderes verwaltet, und starten Sie neu

3930 4223

4224<h3 id="disk-quota-or-temp-filesystem-is-full">

4225 Festplattenquote oder Temp-Dateisystem ist voll

4226</h3>

4227

4228Claude Code speichert die Ausgabe jedes Bash- und PowerShell-Befehls in einer Datei unter seinem Temp-Verzeichnis. Wenn ein Befehl mit einem Nicht-Null-Code beendet wird und überhaupt keine Ausgabe hat, überprüft Claude Code, ob das Dateisystem, das diese Datei hält, keinen Speicherplatz oder Inodes hat, oder ob Ihre Festplattenquota darauf aufgebraucht ist. Wenn ja, erscheint eine Diagnose im Befehlsergebnis anstelle der leeren Ausgabe:

4229

4230```text wrap theme={null}

4231Ihre Festplattenquota ist voll auf dem Dateisystem mit Claudes Temp-Verzeichnis /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), daher ging jede Ausgabe, die dieser Befehl druckte, verloren, und er könnte fehlgeschlagen sein, weil er nicht schreiben konnte. Löschen Sie Dateien, die Sie nicht mehr brauchen, oder starten Sie Claude Code mit CLAUDE_CODE_TMPDIR neu, das auf ein Verzeichnis auf einem anderen Dateisystem gesetzt ist.

4232```

4233

4234Die Nachricht benennt, was aufgebraucht ist:

4235

4236* `Ihre Festplattenquota ist voll ... (EDQUOT)`: Ihre eigene Quote auf diesem Dateisystem ist aufgebraucht. Eine Quote kann voll sein, während das Dateisystem immer noch freien Speicherplatz zeigt

4237* `Das Dateisystem mit Claudes Temp-Verzeichnis ..., oder Ihre Festplattenquota darauf, ist voll (ENOSPC)`: Das Dateisystem, oder Ihre Quote darauf, hat keinen Speicherplatz mehr

4238* `Befehlsausgabe ging verloren: Das Temp-Dateisystem bei ... ist voll` oder `... hat keine Inodes mehr`: Das Dateisystem hat fast keinen freien Speicherplatz mehr, oder läuft aus Inodes

4239

4240**Was zu tun ist:**

4241

4242* Löschen Sie Dateien, die Sie nicht mehr brauchen, auf dem Dateisystem, das Claudes Temp-Verzeichnis hält. Für `EDQUOT`, löschen Sie Dateien, die gegen Ihre eigene Quote zählen. Für `keine Inodes mehr`, löschen Sie viele Dateien anstelle von wenigen großen, da jede Datei einen Inode nimmt, egal wie groß sie ist

4243* Oder starten Sie Claude Code mit [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) neu, das auf ein Verzeichnis auf einem Dateisystem mit Platz gesetzt ist

4244* Dann lassen Sie Claude den Befehl erneut ausführen. Die Ausgabe, die er druckte, ging verloren, nicht gekürzt

4245

3931<h3 id="the-source-file-is-not-valid-utf-8-text">4246<h3 id="the-source-file-is-not-valid-utf-8-text">

3932 Die Quelldatei ist kein gültiger UTF-8-Text4247 Die Quelldatei ist kein gültiger UTF-8-Text

3933</h3>4248</h3>

3989 Fehler in Hintergrund-Sitzungen4304 Fehler in Hintergrund-Sitzungen

3990</h2>4305</h2>

3991 4306

3992[Hintergrund-Sitzungen](/docs/de/agent-view) laufen ohne eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, im Terminal, das sich an eine angehängt, in der Sitzung oder Shell, von der Sie sie entsenden, oder für die [worktree-guard-Einträge](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) unten in jeder Sitzung, die in einem Worktree isoliert ist oder einen Worktree-isolierten Subagenten ausführt; wenn eine Meldung spezifisch für eine Oberfläche ist, gibt ihr Eintrag das an.4307[Hintergrund-Sitzungen](/docs/de/agent-view) laufen ohne eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, im Terminal, das sich an eine angehängt, in der Sitzung oder Shell, von der Sie sie entsenden, oder für die [Worktree-Guard-Einträge](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) unten in jeder Sitzung, die in einem Worktree isoliert ist oder einen Worktree-isolierten Subagenten ausführt; wenn eine Meldung spezifisch für eine Oberfläche ist, gibt ihr Eintrag das an.

3993 4308

3994<h3 id="commands-refused-in-a-background-session">4309<h3 id="commands-refused-in-a-background-session">

3995 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden4310 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden

3996</h3>4311</h3>

3997 4312

3998Befehle, die einen interaktiven Dialog öffnen, können dies nicht tun, während kein Terminal an eine Hintergrund-Sitzung angehängt ist. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü antworten mit einer Meldung, und die Sitzung wird unter **Needs input** in der [Agent-Ansicht](/docs/de/agent-view) angezeigt, damit Sie sie finden, anhängen und den Befehl erneut ausführen können. Während ein Terminal angehängt ist, funktionieren diese Befehle normal.4313Befehle, die einen interaktiven Dialog öffnen, können dies nicht tun, während kein Terminal an eine Hintergrund-Sitzung angehängt ist. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü antworten mit einer Meldung. Für `/install-github-app` und die `/mcp`-Einstellungsliste wird die Sitzung auch unter **Needs input** in der [Agent-Ansicht](/docs/de/agent-view) angezeigt, damit Sie sie finden, anhängen und den Befehl erneut ausführen können. Während ein Terminal angehängt ist, funktionieren diese Befehle normal.

3999 4314

4000Vor v2.1.216 wurde die Sitzung nach einer dieser Ablehnungen nicht unter **Needs input** angezeigt. In v2.1.213 bis v2.1.215 funktionieren die Befehle weiterhin, während ein Terminal angehängt ist, und die Ablehnungsmeldung sagte Ihnen, dass Sie anhängen und den Befehl erneut ausführen sollen. Von v2.1.208 bis v2.1.212 lehnte Claude Code sie sogar ab, während ein Terminal angehängt war, mit einer Meldung wie `Can't open MCP settings in a background session`; auf diesen Versionen führen Sie den Befehl stattdessen aus einer regulären `claude`-Sitzung aus oder aktualisieren. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung. In v2.1.208 nur lehnte Claude Code auch die `/model`-Auswahl in einer Hintergrund-Sitzung ab, und `/upgrade` druckte die Upgrade-URL aus, anstatt einen Browser zu öffnen.4315Vor v2.1.216 wurde die Sitzung nach `/install-github-app` oder der `/mcp`-Einstellungsliste nicht unter **Needs input** angezeigt. In v2.1.213 bis v2.1.215 funktionieren die Befehle weiterhin, während ein Terminal angehängt ist, und die Ablehnungsmeldung sagte Ihnen, dass Sie anhängen und den Befehl erneut ausführen sollen. Von v2.1.208 bis v2.1.212 lehnte Claude Code sie sogar ab, während ein Terminal angehängt war, mit einer Meldung wie `Can't open MCP settings in a background session`; auf diesen Versionen führen Sie den Befehl stattdessen aus einer regulären `claude`-Sitzung aus oder aktualisieren. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung. In v2.1.208 nur lehnte Claude Code auch die `/model`-Auswahl in einer Hintergrund-Sitzung ab, und `/upgrade` druckte die Upgrade-URL aus, anstatt einen Browser zu öffnen.

4001 4316

4002Die Formulierung nennt den Befehl. Die `/mcp`-Einstellungsliste meldet:4317Die Formulierung nennt den Befehl. Die `/mcp`-Einstellungsliste meldet:

4003 4318

4007 4322

4008**Was zu tun ist:**4323**Was zu tun ist:**

4009 4324

4010* Hängen Sie sich von der Agent-Ansicht an die Sitzung an, wo sie unter **Needs input** aufgelistet ist, und führen Sie den Befehl erneut aus4325* Hängen Sie sich von der Agent-Ansicht an die Sitzung an und führen Sie den Befehl erneut aus

4011* Oder verwenden Sie das Formular, das die Meldung nennt, wie `/mcp reconnect <server>`, `/mcp enable` oder `/mcp disable`, die ohne Anhängen funktionieren4326* Oder verwenden Sie das Formular, das die Meldung nennt, wie `/mcp reconnect <server>`, `/mcp enable` oder `/mcp disable`, die ohne Anhängen funktionieren

4012 4327

4013<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4328<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">

4042**Was zu tun ist:**4357**Was zu tun ist:**

4043 4358

4044* Normalerweise nichts: Claude versucht es erneut mit der lokalen Schreibweise, die die Meldung verlangt4359* Normalerweise nichts: Claude versucht es erneut mit der lokalen Schreibweise, die die Meldung verlangt

4045* Wenn sich die Datei auf einer Netzwerkfreigabe befindet, anstatt eine lokale Datei mit einem Netzwerkpfad zu schreiben, befindet sie sich außerhalb des lokalen Arbeitsbereichs der Sitzung; bearbeiten Sie sie stattdessen aus einer regulären interaktiven Sitzung

4046 4360

4047<h3 id="command-blocked-by-the-worktree-isolation-checks">4361<h3 id="command-blocked-by-the-worktree-isolation-checks">

4048 Befehl blockiert durch die Worktree-Isolationsprüfungen4362 Befehl blockiert durch die Worktree-Isolationsprüfungen

4231 Sitzungs-Agent nicht mehr verfügbar4545 Sitzungs-Agent nicht mehr verfügbar

4232</h3>4546</h3>

4233 4547

4234Sie haben eine Sitzung fortgesetzt, die einen [benutzerdefinierten Agent](/docs/de/sub-agents#invoke-subagents-explicitly) ausführte, gestartet mit `--agent` oder der `agent`-Einstellung, und Claude Code hat keinen Agent mit diesem Namen gefunden. Es durchsucht zuerst das ursprüngliche Verzeichnis der Sitzung, wenn Sie [diesen Arbeitsbereich vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), dann das Verzeichnis, von dem aus Sie fortsetzen. Die Sitzung wird immer noch fortgesetzt, aber mit den Standard-Tools und der Standard-Systemaufforderung, daher gelten die Tool-Einschränkungen des Agenten nicht mehr:4548Sie haben eine Sitzung fortgesetzt, die einen [benutzerdefinierten Agent](/docs/de/sub-agents#invoke-subagents-explicitly) ausführte, gestartet mit `--agent` oder der `agent`-Einstellung, und Claude Code hat keinen Agent mit diesem Namen gefunden. Es durchsucht zuerst das ursprüngliche Verzeichnis der Sitzung, wenn Sie [diesen Arbeitsbereich vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), dann das Verzeichnis, von dem aus Sie fortsetzen. Die Sitzung wird immer noch fortgesetzt, aber mit den Standard-Tools, so dass die Tool-Einschränkungen des Agenten nicht mehr gelten:

4235 4549

4236```text theme={null}4550```text theme={null}

4237This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4551This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.

4277 4591

4278Bei einigen Konten sagt die Meldung `daemon` anstelle von `background service`.4592Bei einigen Konten sagt die Meldung `daemon` anstelle von `background service`.

4279 4593

4280Bei einer npm-Installation hat ein `EUNKNOWN`, das erscheint, während `npm install -g @anthropic-ai/claude-code` die Binärdatei ersetzt, die gleiche Ursache wie [`EACCES` beim Neustart einer Hintergrund-Sitzung](#eacces-when-starting-a-background-session) und wird gelöscht, wenn Sie nach Abschluss der Installation erneut versuchen.4594Bei einer npm-Installation hat ein `EUNKNOWN`, das erscheint, während `npm install -g @anthropic-ai/claude-code` die Binärdatei ersetzt, die gleiche Ursache wie [`EACCES` beim Starten einer Hintergrund-Sitzung](#eacces-when-starting-a-background-session) und wird gelöscht, wenn Sie nach Abschluss der Installation erneut versuchen.

4281 4595

4282Claude Code startet den Hintergrund-Service über PowerShell, damit der Service das Schließen des Terminals überlebt, wobei PowerShell 7 verwendet wird, wenn es installiert ist, und Windows PowerShell 5.1 ansonsten. Wenn weder PowerShell laufen kann, startet Claude Code den Service stattdessen direkt, daher verursacht eine Richtlinie, die nur PowerShell blockiert, diesen Fehler nicht. Wenn Sie ihn sehen, während keine npm-Installation läuft, blockiert die Richtlinie die Claude Code-Ausführungsdatei selbst.4596Claude Code startet den Hintergrund-Service über PowerShell, damit der Service das Schließen des Terminals überlebt, wobei PowerShell 7 verwendet wird, wenn es installiert ist, und Windows PowerShell 5.1 ansonsten. Wenn weder PowerShell laufen kann, startet Claude Code den Service stattdessen direkt, daher verursacht eine Richtlinie, die nur PowerShell blockiert, diesen Fehler nicht.

4283 4597

4284Vor v2.1.212 verwendete Claude Code nur Windows PowerShell 5.1, um den Service zu starten, daher schlugen alle Maschinen fehl, auf denen Gruppenrichtlinie PowerShell 5.1 blockierte, mit `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, sogar mit PowerShell 7 installiert.4598Vor v2.1.212 verwendete Claude Code nur Windows PowerShell 5.1, um den Service zu starten, daher schlugen alle Maschinen fehl, auf denen Gruppenrichtlinie PowerShell 5.1 blockierte, mit `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, sogar mit PowerShell 7 installiert.

4285 4599

4287 4601

4288* Wenn die Meldung `Couldn't start the session` liest, aktualisieren Sie auf v2.1.212 oder später. Auf früheren Versionen können Sie auch `claude daemon run` in einem separaten Terminal zuerst ausführen, dann die Hintergrund-Sitzung erneut starten. Dieser Befehl führt den Hintergrund-Service im Vordergrund des Terminals aus, daher dauert der Service nur so lange wie dieses Terminal offen bleibt.4602* Wenn die Meldung `Couldn't start the session` liest, aktualisieren Sie auf v2.1.212 oder später. Auf früheren Versionen können Sie auch `claude daemon run` in einem separaten Terminal zuerst ausführen, dann die Hintergrund-Sitzung erneut starten. Dieser Befehl führt den Hintergrund-Service im Vordergrund des Terminals aus, daher dauert der Service nur so lange wie dieses Terminal offen bleibt.

4289* Wenn eine npm-Installation die Binärdatei ersetzt, warten Sie, bis sie fertig ist, dann starten Sie die Hintergrund-Sitzung erneut4603* Wenn eine npm-Installation die Binärdatei ersetzt, warten Sie, bis sie fertig ist, dann starten Sie die Hintergrund-Sitzung erneut

4290* Wenn der Fehler auf v2.1.212 oder später erscheint, während keine npm-Installation läuft, bitten Sie Ihren Windows-Administrator, die Claude Code-Ausführungsdatei in der Beschränkungsrichtlinie zuzulassen4604* Wenn der Fehler auf v2.1.212 oder später erscheint, während keine npm-Installation läuft, überprüfen Sie mit Ihrem Windows-Administrator, ob eine Beschränkungsrichtlinie die Claude Code-Ausführungsdatei blockiert

4291* Wenn der Hintergrund-Service stoppt, wenn Sie das Terminal schließen, startete Claude Code ihn ohne PowerShell. Installieren Sie PowerShell 7, oder bitten Sie Ihren Administrator, PowerShell freizugeben, damit der Service das Terminal überleben kann.4605* Wenn der Hintergrund-Service stoppt, wenn Sie das Terminal schließen, startete Claude Code ihn ohne PowerShell. Installieren Sie PowerShell 7, oder bitten Sie Ihren Administrator, PowerShell freizugeben, damit der Service das Terminal überleben kann.

4292 4606

4293<h3 id="eacces-when-starting-a-background-session">4607<h3 id="eacces-when-starting-a-background-session">

4343 Arbeitsverzeichnis existiert nicht mehr beim Starten einer Hintergrund-Sitzung4657 Arbeitsverzeichnis existiert nicht mehr beim Starten einer Hintergrund-Sitzung

4344</h3>4658</h3>

4345 4659

4346Sie haben versucht, eine [Hintergrund-Sitzung](/docs/de/agent-view) in einem Verzeichnis zu starten, das nicht mehr existiert. Dies geschieht, wenn Sie aus der Agent-Ansicht entsenden oder `/background` ausführen, nachdem das Verzeichnis, in dem Sie arbeiten, gelöscht oder verschoben wurde. Es geschieht auch, wenn Sie sich an eine Sitzung anhängen oder eine neu starten, deren Prozess beendet wurde und deren Verzeichnis weg ist, da der neue Prozess in diesem gleichen Verzeichnis starten würde. Claude Code startet die Sitzung nicht, und die Meldung nennt das fehlende Verzeichnis:4660Das Verzeichnis, in dem Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) gestartet haben, wurde entfernt, während die Sitzung startete. Claude Code startet die Sitzung nicht, und die Meldung nennt das fehlende Verzeichnis:

4347 4661

4348```text theme={null}4662```text theme={null}

4349Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4663Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

4351 4665

4352Vor v2.1.257 schien die Sitzung zu starten und zeigte sich dann in der Agent-Ansicht als fehlgeschlagene Zeile mit dem gleichen Grund.4666Vor v2.1.257 schien die Sitzung zu starten und zeigte sich dann in der Agent-Ansicht als fehlgeschlagene Zeile mit dem gleichen Grund.

4353 4667

4668Vor v2.1.281 erschien diese Meldung auch, wenn das Verzeichnis bereits weg war, bevor Sie die Sitzung gestartet haben. Dieser Fall meldet [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).

4669

4354**Was zu tun ist:**4670**Was zu tun ist:**

4355 4671

4356* Erstellen Sie das Verzeichnis neu, das die Meldung nennt, oder entsenden Sie aus einem Verzeichnis, das existiert, dann versuchen Sie es erneut4672* Erstellen Sie das Verzeichnis neu, das die Meldung nennt, oder entsenden Sie aus einem Verzeichnis, das existiert, dann versuchen Sie es erneut

4357 4673

4674<h3 id="workspace-not-trusted-when-dispatching-a-background-session">

4675 Arbeitsbereich nicht vertraut beim Entsenden einer Hintergrund-Sitzung

4676</h3>

4677

4678Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) in einem Verzeichnis gestartet oder neu gestartet, das Sie nicht [vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), und der Arbeitsbereich-Vertrauensdialog konnte nicht erscheinen, um Sie zu fragen. Claude Code startet die Sitzung nicht:

4679

4680```text theme={null}

4681Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

4682```

4683

4684Aus einem Terminal im eigenen Verzeichnis der Sitzung zeigt der gleiche Befehl stattdessen den Vertrauensdialog und startet die Sitzung, sobald Sie akzeptieren. Diese Meldung erscheint, wo kein Dialog kann, wie in einem Skript, oder wenn Sie eine Sitzung von einem anderen Verzeichnis als ihrem eigenen neu starten.

4685

4686Zwei Varianten nennen eine andere Ursache:

4687

4688* **`The home directory is trusted one session at a time`**: Das Verzeichnis der Sitzung ist Ihr Home-Verzeichnis. Claude Code speichert niemals Vertrauen für das Home-Verzeichnis, daher zählt das Akzeptieren des Dialogs dort in einer früheren Sitzung nicht.

4689* **`<path> could not be resolved on disk`**: Claude Code konnte das Verzeichnis der Sitzung auf der Festplatte nicht finden.

4690

4691**Was zu tun ist:**

4692

4693* Führen Sie `claude` im Verzeichnis aus, das die Meldung nennt, und akzeptieren Sie den Vertrauensdialog, dann führen Sie den Befehl erneut aus

4694* Für die Home-Verzeichnis-Meldung führen Sie den Befehl aus einem Terminal in Ihrem Home-Verzeichnis aus, damit der Dialog erscheinen kann, oder starten Sie die Sitzung stattdessen von einem Projekt-Verzeichnis

4695* Für die `could not be resolved on disk`-Meldung erstellen Sie das Verzeichnis neu, oder starten Sie eine neue Sitzung von einem Verzeichnis, das existiert

4696

4358<h2 id="wrapper-and-ide-errors">4697<h2 id="wrapper-and-ide-errors">

4359 Fehler bei Wrapper und IDE4698 Fehler bei Wrapper und IDE

4360</h2>4699</h2>

4439 4778

4440* Identifizieren Sie, welche Dateien übersprungen wurden, damit Sie jede mit den folgenden Schritten behandeln können. Die Meldung gibt nur eine Anzahl an; das Debug-Protokoll unter `~/.claude/debug/<session-id>.txt` nennt jeden übersprungenen Pfad während der Wiederherstellung, also aktivieren Sie Debug-Protokollierung mit `/debug` vor Ihrer nächsten Wiederherstellung. Unter macOS oder Linux können Sie die Links stattdessen direkt finden: `find . -type l` für Symlinks und `find . -type f -links +1` für Hard-linked-Dateien.4779* Identifizieren Sie, welche Dateien übersprungen wurden, damit Sie jede mit den folgenden Schritten behandeln können. Die Meldung gibt nur eine Anzahl an; das Debug-Protokoll unter `~/.claude/debug/<session-id>.txt` nennt jeden übersprungenen Pfad während der Wiederherstellung, also aktivieren Sie Debug-Protokollierung mit `/debug` vor Ihrer nächsten Wiederherstellung. Unter macOS oder Linux können Sie die Links stattdessen direkt finden: `find . -type l` für Symlinks und `find . -type f -links +1` für Hard-linked-Dateien.

4441* Wenn eine übersprungene Datei ein Link ist, den Sie absichtlich erstellt haben, z. B. eine Konfigurationsdatei, die von einem Dotfile-Manager verwaltet wird, oder eine Datei, die von Tools wie pnpm Hard-linked ist, hat der Rewind ihren Inhalt allein gelassen. Um die Änderungen der Sitzung rückgängig zu machen, bitten Sie Claude, die Bearbeitung rückgängig zu machen oder bearbeiten Sie die Datei selbst4780* Wenn eine übersprungene Datei ein Link ist, den Sie absichtlich erstellt haben, z. B. eine Konfigurationsdatei, die von einem Dotfile-Manager verwaltet wird, oder eine Datei, die von Tools wie pnpm Hard-linked ist, hat der Rewind ihren Inhalt allein gelassen. Um die Änderungen der Sitzung rückgängig zu machen, bitten Sie Claude, die Bearbeitung rückgängig zu machen oder bearbeiten Sie die Datei selbst

4442* Wenn Sie den Link nicht erstellt haben, überprüfen Sie den Pfad, bevor Sie seinem Inhalt vertrauen: etwas hat die Datei nach dem Checkpoint ersetzt4781* Wenn Sie den Link nicht erstellt haben, überprüfen Sie den Pfad, bevor Sie seinem Inhalt vertrauen

4443 4782

4444<h3 id="no-files-were-restored">4783<h3 id="no-files-were-restored">

4445 No files were restored4784 No files were restored

4587* Kürzen Sie das `description`-Frontmatter Ihrer Agent-Dateien, oder bitten Sie Claude, diese für Sie zu kürzen.4926* Kürzen Sie das `description`-Frontmatter Ihrer Agent-Dateien, oder bitten Sie Claude, diese für Sie zu kürzen.

4588* Entfernen Sie Agent-Dateien, die Sie nicht mehr verwenden.4927* Entfernen Sie Agent-Dateien, die Sie nicht mehr verwenden.

4589 4928

4929<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">

4930 Eine Fähigkeit, ein Befehl oder ein Workflow wurde nicht geladen, weil sein Name reserviert ist

4931</h3>

4932

4933Ein Fähigkeitsordner, ein Frontmatter `name`, eine Datei oder ein Unterordner in `.claude/commands/` oder ein [gespeicherter Workflow](/docs/de/workflows#save-the-workflow-for-reuse) verwendet den Namen `anthropic-skills` oder einen Namen, der mit `anthropic-skills:` beginnt. Claude Code [reserviert diesen Namen für Fähigkeiten, die von claude.ai synchronisiert werden](/docs/de/skills#names-reserved-for-synced-skills) und lädt diesen Artikel nicht.

4934

4935Claude Code zeigt diese Warnung als Startnachricht in der Konversationsansicht statt auf stderr an:

4936

4937```text theme={null}

4938Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account

4939```

4940

4941Die Meldung benennt, was für den ersten Artikel geändert werden soll, den sie abgelehnt hat: einen Ordner oder eine Datei zum Umbenennen, eine `name:`-Zeile zum Bearbeiten oder einen Workflow zum Umbenennen. Wenn mehr als ein Artikel abgelehnt wurde, endet die Meldung mit einer Anzahl wie `· 2 more`, und das [Debug-Protokoll](/docs/de/debug-your-config) benennt jeden.

4942

4943**Was zu tun ist:**

4944

4945* Benennen Sie den Artikel um, den die Meldung benennt, oder bearbeiten Sie die `name:`-Zeile, auf die sie verweist, und starten Sie die Sitzung neu.

4946

4947Vor v2.1.282 lud Claude Code Fähigkeiten und Befehle mit diesen Namen.

4948

4590<h3 id="workspace-has-not-been-trusted">4949<h3 id="workspace-has-not-been-trusted">

4591 Arbeitsbereich wurde nicht vertraut4950 Arbeitsbereich wurde nicht vertraut

4592</h3>4951</h3>

4633 Remote verwaltete Einstellungen konnten nicht geladen werden4992 Remote verwaltete Einstellungen konnten nicht geladen werden

4634</h3>4993</h3>

4635 4994

4636Ihre Sitzung ist berechtigt für [servergesteuerte Einstellungen](/docs/de/server-managed-settings), aber Claude Code konnte sie nicht abrufen, daher zeigt es diese Warnung in interaktiven Sitzungen an. Die eingeklammerte Ursache benennt, was fehlgeschlagen ist, z. B. `network error`, `request timed out` oder `authentication rejected (401)`, und der Rest der Zeile sagt, welche Richtlinie die Sitzung ausführt:4995Ihre Sitzung ist berechtigt für [servergesteuerte Einstellungen](/docs/de/server-managed-settings), 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.

4996

4997Die 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](/docs/de/server-managed-settings#invalid-entries-in-delivered-settings) bestanden hat. Vor v2.1.282 lautete diese Ursache `server returned invalid settings`.

4998

4999Der Rest der Zeile sagt, welche Richtlinie die Sitzung ausführt:

4637 5000

4638* **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](/docs/de/server-managed-settings#fetch-and-caching-behavior), und die Zeile liest `using cached policy`.5001* **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](/docs/de/server-managed-settings#fetch-and-caching-behavior), und die Zeile liest `using cached policy`.

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

4641**Was zu tun ist:**5004**Was zu tun ist:**

4642 5005

4643* 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`5006* 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`

5007* Für `no setting in the server response could be applied as written` bitten Sie Ihren Administrator, die Einstellungen auf dem Server zu korrigieren

4644* Führen Sie `/status` oder `claude doctor` aus, um die vollständige Diagnose zu erhalten5008* Führen Sie `/status` oder `claude doctor` aus, um die vollständige Diagnose zu erhalten

4645 5009

4646Vor v2.1.248 meldete Claude Code einen fehlgeschlagenen Einstellungsabruf nur im Debug-Protokoll.5010Vor v2.1.248 meldete Claude Code einen fehlgeschlagenen Einstellungsabruf nur im Debug-Protokoll.

4660* Starten Sie Claude Code erneut und genehmigen Sie den Dialog, um unter den Einstellungen Ihrer Organisation fortzufahren. Ein abgelehnter Dialog wird nicht gespeichert, daher erscheint er beim nächsten Start erneut.5024* Starten Sie Claude Code erneut und genehmigen Sie den Dialog, um unter den Einstellungen Ihrer Organisation fortzufahren. Ein abgelehnter Dialog wird nicht gespeichert, daher erscheint er beim nächsten Start erneut.

4661* Wenn Sie sich über eine Einstellung unsicher sind, die der Dialog auflistet, fragen Sie denjenigen, der die verwalteten Einstellungen Ihrer Organisation verwaltet, bevor Sie genehmigen5025* Wenn Sie sich über eine Einstellung unsicher sind, die der Dialog auflistet, fragen Sie denjenigen, der die verwalteten Einstellungen Ihrer Organisation verwaltet, bevor Sie genehmigen

4662 5026

5027<h3 id="managed-settings-block-the-default-model">

5028 Verwaltete Einstellungen blockieren das Standardmodell

5029</h3>

5030

5031Die [verwalteten Einstellungen](/docs/de/managed-settings) Ihrer Organisation blockieren das Modell, zu dem die Standardoption aufgelöst wird, und jedes Modell, zu dem es herabgestuft werden könnte. Eine Sitzung, die auf der Standardoption starten würde, wird stattdessen beim Start beendet, anstatt ein blockiertes Modell auszuführen. Welche Meldung Sie sehen, hängt von der Einstellung ab, die es blockiert. Wenn eine [`deniedModels`](/docs/de/model-config#block-specific-models-or-versions)-Liste es blockiert, lautet die Meldung:

5032

5033```text theme={null}

5034Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

5035```

5036

5037Wenn eine `availableModels`-Liste mit [`availableModelsMatch`](/docs/de/settings-reference#availablemodelsmatch) auf `"exact"` gesetzt es auslässt, lautet die Meldung:

5038

5039```text theme={null}

5040Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".

5041```

5042

5043**Was zu tun ist:**

5044

5045* Wenn Sie die Einstellungen verwalten, fügen Sie ein Modell, das Ihre Benutzer ausführen können, zu `availableModels` hinzu, oder grenzen Sie die `deniedModels`-Einträge ein, die jeden Fallback blockieren. [Blockieren Sie bestimmte Modelle oder Versionen](/docs/de/model-config#block-specific-models-or-versions) beschreibt, wie die Standardoption herabgestuft wird

5046* Wenn Sie sie nicht verwalten, senden Sie die Meldung an Ihren Administrator. Ihre eigenen Einstellungsdateien können eine verwaltete `availableModels`- oder `deniedModels`-Liste nicht verbreitern

5047

4663<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5048<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

4664 MCP-Server wird durch Unternehmensrichtlinie blockiert5049 MCP-Server wird durch Unternehmensrichtlinie blockiert

4665</h3>5050</h3>

4929 5314

4930* Ein konfiguriertes [`--fallback-model`](/docs/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript5315* Ein konfiguriertes [`--fallback-model`](/docs/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript

4931* Eine Verfügbarkeitsprüfung von Amazon Bedrock oder Google Cloud's Agent Platform stellt fest, dass Ihr Standardmodell nicht verfügbar ist5316* Eine Verfügbarkeitsprüfung von Amazon Bedrock oder Google Cloud's Agent Platform stellt fest, dass Ihr Standardmodell nicht verfügbar ist

4932* [Automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auf Fable 5.1, Fable 5, Opus 5.5 und Opus 5 verschiebt die Sitzung zum Fallback-Modell der gekennzeichneten Kategorie, wenn diese Kategorie über einen verfügt, und zeigt eine Notiz im Transkript an5317* [Automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auf Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 und Opus 5 verschiebt die Sitzung zum Fallback-Modell der gekennzeichneten Kategorie, wenn diese Kategorie über einen verfügt, und zeigt eine Notiz im Transkript an

4933 5318

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

4935 5320

feature-availability.md +4 −4

Details

219</table>219</table>

220 220

221<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Auf Google Cloud's Agent Platform ist Web search für Claude 4-Modelle und später verfügbar.<br />221<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Auf Google Cloud's Agent Platform ist Web search für Claude 4-Modelle und später verfügbar.<br />

222<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Auf diesen Anbietern unterstützt Auto mode nur Claude Sonnet 5, Opus 4.7 oder später und die Fable-Modelle. Siehe [Auto mode configuration](/docs/de/auto-mode-config). Der integrierte Standard-Berechtigungsmodus auf diesen Anbietern ist Manual. Siehe [in welchem Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in). In v2.1.158 bis v2.1.206 erforderte Auto mode auf diesen Anbietern auch das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.<br />222<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Auf diesen Anbietern unterstützt Auto mode nur Claude Sonnet 5 oder später, Opus 4.7 oder später und die Fable-Modelle. Siehe [Auto mode configuration](/docs/de/auto-mode-config). Für den Berechtigungsmodus, in dem eine Sitzung auf diesen Anbietern startet, siehe [In welchem Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in). In v2.1.158 bis v2.1.206 erforderte Auto mode auf diesen Anbietern auch das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.<br />

223<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Unterliegt Ihrer Vereinbarung mit dem Cloud-Anbieter.<br />223<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Unterliegt Ihrer Vereinbarung mit dem Cloud-Anbieter.<br />

224<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Dashboard und API nur. [Contribution metrics](/docs/de/analytics#enable-contribution-metrics) erfordert eine claude.ai Team- oder Enterprise-Organisation.<br />224<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Dashboard und API nur. [Contribution metrics](/docs/de/analytics#enable-contribution-metrics) erfordert eine claude.ai Team- oder Enterprise-Organisation.<br />

225<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Erfordert Claude Code v2.1.224 oder später auf macOS und Linux, einschließlich Linux in WSL 2. Auf nativem Windows erfordert Claude Code v2.1.234 oder später. Mit API-Schlüssel-Authentifizierung ist Messaging nur auf dem gleichen Computer möglich. Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry ist Messaging nur auf dem gleichen Computer möglich und erfordert Claude Code v2.1.248 oder später. Claude kann Ihre [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und Ihre Sitzungen auf anderen Computern nur von einer Sitzung aus finden, die mit [Remote Control](/docs/de/remote-control) verbunden ist. Um eine Verbindung herzustellen, benötigen Sie eine claude.ai-Anmeldung und die anderen [Remote Control-Anforderungen](/docs/de/remote-control#requirements). Siehe [Sitzungen auf anderen Computern anschreiben](/docs/de/cross-session-messaging#message-sessions-on-other-machines).225<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Erfordert Claude Code v2.1.224 oder später auf macOS und Linux, einschließlich Linux in WSL 2. Auf nativem Windows erfordert Claude Code v2.1.234 oder später. Mit API-Schlüssel-Authentifizierung ist Messaging nur auf dem gleichen Computer möglich. Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry ist Messaging nur auf dem gleichen Computer möglich und erfordert Claude Code v2.1.248 oder später. Claude kann Ihre [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und Ihre Sitzungen auf anderen Computern nur von einer Sitzung aus finden, die mit [Remote Control](/docs/de/remote-control) verbunden ist. Um eine Verbindung herzustellen, benötigen Sie eine claude.ai-Anmeldung und die anderen [Remote Control-Anforderungen](/docs/de/remote-control#requirements). Siehe [Sitzungen auf anderen Computern anschreiben](/docs/de/cross-session-messaging#message-sessions-on-other-machines).

243 **Teilweise Unterstützung:**243 **Teilweise Unterstützung:**

244 244

245 * [Desktop](/docs/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)245 * [Desktop](/docs/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

246 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5, Opus 4.7 oder später und Fable-Modelle nur246 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5 oder später, Opus 4.7 oder später und Fable-Modelle nur

247 * [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): zwischen Ihren Sitzungen auf diesem Computer nur <sup><a href="#fn5">5</a></sup>247 * [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): zwischen Ihren Sitzungen auf diesem Computer nur <sup><a href="#fn5">5</a></sup>

248 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer AWS-Vereinbarung248 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer AWS-Vereinbarung

249 249

269 269

270 * [Desktop](/docs/de/desktop): über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) oder [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)270 * [Desktop](/docs/de/desktop): über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) oder [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

271 * [Web search](/docs/de/tools-reference#websearch-tool-behavior): Claude 4-Modelle und später271 * [Web search](/docs/de/tools-reference#websearch-tool-behavior): Claude 4-Modelle und später

272 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5, Opus 4.7 oder später und Fable-Modelle nur272 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5 oder später, Opus 4.7 oder später und Fable-Modelle nur

273 * [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): zwischen Ihren Sitzungen auf diesem Computer nur <sup><a href="#fn5">5</a></sup>273 * [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): zwischen Ihren Sitzungen auf diesem Computer nur <sup><a href="#fn5">5</a></sup>

274 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer Google Cloud-Vereinbarung274 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer Google Cloud-Vereinbarung

275 275

283 283

284 * [Desktop](/docs/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)284 * [Desktop](/docs/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

285 * [Web search](/docs/de/tools-reference#websearch-tool-behavior): [Bereitstellungen, die auf Anthropic gehostet werden](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) nur285 * [Web search](/docs/de/tools-reference#websearch-tool-behavior): [Bereitstellungen, die auf Anthropic gehostet werden](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) nur

286 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5, Opus 4.7 oder später und Fable-Modelle nur286 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5 oder später, Opus 4.7 oder später und Fable-Modelle nur

287 * [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): zwischen Ihren Sitzungen auf diesem Computer nur <sup><a href="#fn5">5</a></sup>287 * [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging): zwischen Ihren Sitzungen auf diesem Computer nur <sup><a href="#fn5">5</a></sup>

288 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer Azure-Vereinbarung288 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer Azure-Vereinbarung

289 289

fullscreen.md +3 −1

Details

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

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

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

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

107* **Klicken Sie auf ein reduziertes Werkzeugergebnis**, um es zu erweitern und die vollständige Ausgabe anzuzeigen. Klicken Sie erneut, um es zu reduzieren. Der Werkzeugaufruf und sein Ergebnis werden zusammen erweitert. Nur Nachrichten, die mehr zu zeigen haben, sind anklickbar.108* **Klicken Sie auf ein reduziertes Werkzeugergebnis**, um es zu erweitern und die vollständige Ausgabe anzuzeigen. Klicken Sie erneut, um es zu reduzieren. Der Werkzeugaufruf und sein Ergebnis werden zusammen erweitert. Nur Nachrichten, die mehr zu zeigen haben, sind anklickbar.

108 * Das Klicken erweitert auch die Ausgabe eines `!`-Shell-Befehls, ob ein älteres abgeschnittenes Ergebnis oder die Live-Fortschrittszeile während der Befehlsausführung. Erfordert Claude Code v2.1.257 oder später.109 * Das Klicken erweitert auch die Ausgabe eines `!`-Shell-Befehls, ob ein älteres abgeschnittenes Ergebnis oder die Live-Fortschrittszeile während der Befehlsausführung. Erfordert Claude Code v2.1.257 oder später.

110 * Das Klicken erweitert auch eine gedimmte `Message from @<sender>`-Zeile, wenn der Absender ein [Teamkollege](/docs/de/agent-teams) oder ein anderer Agent ist, der in Ihrer Sitzung läuft. Die Zeile für eine Nachricht von [einer Ihrer anderen Sitzungen](/docs/de/cross-session-messaging#what-a-message-looks-like) zeigt auch die erste Zeile der Nachricht an und ist nicht anklickbar. Drücken Sie daher `Ctrl+o`, um diese zu lesen.

109* **Halten Sie `Cmd` auf macOS oder `Ctrl` auf Linux und Windows, und klicken Sie auf eine URL oder einen Dateipfad**, um ihn zu öffnen. Einfache `http://`- und `https://`-URLs werden in Ihrem Browser geöffnet, und Dateipfade in der Werkzeugausgabe, wie die nach einem Edit oder Write gedruckten, werden in Ihrer Standardanwendung geöffnet. Ein einfacher Klick ohne den Modifikator öffnet keine Links und entspricht dem nativen Terminal-Verhalten.111* **Halten Sie `Cmd` auf macOS oder `Ctrl` auf Linux und Windows, und klicken Sie auf eine URL oder einen Dateipfad**, um ihn zu öffnen. Einfache `http://`- und `https://`-URLs werden in Ihrem Browser geöffnet, und Dateipfade in der Werkzeugausgabe, wie die nach einem Edit oder Write gedruckten, werden in Ihrer Standardanwendung geöffnet. Ein einfacher Klick ohne den Modifikator öffnet keine Links und entspricht dem nativen Terminal-Verhalten.

110 * Claude Code rendert einen Netzwerkpfad (UNC-Pfad), z. B. `\\server\share\file.ts`, als reinen Text ohne Link, da das Öffnen eines Netzwerkpfads Ihre Windows-Anmeldedaten an den Host senden kann, den er benennt.112 * Claude Code rendert einen Netzwerkpfad (UNC-Pfad), z. B. `\\server\share\file.ts`, als reinen Text ohne Link, da das Öffnen eines Netzwerkpfads Ihre Windows-Anmeldedaten an den Host senden kann, den er benennt.

111 * Einige macOS-Terminals leiten `Cmd`+Klick an die laufende App weiter, anstatt den Link selbst zu öffnen, und das Terminal-Mausprotokoll hat keine Möglichkeit, die `Cmd`-Taste zu codieren, daher empfängt Claude Code einen einfachen Klick. In Ghostty und in Warp auf macOS erkennt Claude Code dies und ermöglicht es, dass ein einfacher Klick auf einen Link ihn öffnet, und das Halten von `Cmd` funktioniert immer noch.113 * Einige macOS-Terminals leiten `Cmd`+Klick an die laufende App weiter, anstatt den Link selbst zu öffnen, und das Terminal-Mausprotokoll hat keine Möglichkeit, die `Cmd`-Taste zu codieren, daher empfängt Claude Code einen einfachen Klick. In Ghostty und in Warp auf macOS erkennt Claude Code dies und ermöglicht es, dass ein einfacher Klick auf einen Link ihn öffnet, und das Halten von `Cmd` funktioniert immer noch.

290CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude292CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude

291```293```

292 294

293Mit deaktivierter Mauserfassung funktioniert das Tastatur-Scrollen mit `PgUp`, `PgDn`, `Ctrl+Home` und `Ctrl+End` immer noch, und Ihr Terminal verwaltet die Auswahl nativ. Sie verlieren das Klicken zum Positionieren des Cursors, das Klicken zum Erweitern der Tool-Ausgabe, das URL-Klicken und das Rad-Scrollen innerhalb von Claude Code.295Mit deaktivierter Mauserfassung funktioniert das Tastatur-Scrollen mit `PgUp`, `PgDn`, `Ctrl+Home` und `Ctrl+End` immer noch, und Ihr Terminal verwaltet die Auswahl nativ. Sie verlieren das Klicken zum Positionieren des Cursors, das Klicken zum Erweitern, das URL-Klicken und das Rad-Scrollen innerhalb von Claude Code.

294 296

295Um das Rad-Scrollen zu behalten, aber das Klicken, Ziehen und Hover-Handling auszuschalten, setzen Sie stattdessen `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1`. Erfordert Claude Code v2.1.195 oder später. `CLAUDE_CODE_DISABLE_MOUSE` hat Vorrang, wenn beide Variablen gesetzt sind.297Um das Rad-Scrollen zu behalten, aber das Klicken, Ziehen und Hover-Handling auszuschalten, setzen Sie stattdessen `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1`. Erfordert Claude Code v2.1.195 oder später. `CLAUDE_CODE_DISABLE_MOUSE` hat Vorrang, wenn beide Variablen gesetzt sind.

296 298

github-enterprise-server.md +18 −18

Details

4 4

5# Claude Code mit GitHub Enterprise Server5# Claude Code mit GitHub Enterprise Server

6 6

~~7> Verbinden Sie Claude Code mit Ihrer selbstgehosteten GitHub Enterprise Server-Instanz für Web-Sitzungen, Code-Review und Plugin-Marktplätze.~~7> Verbinden Sie Claude Code mit Ihrer selbstgehosteten GitHub Enterprise Server-Instanz für Cloud-Sitzungen, Code-Review und Plugin-Marktplätze.

8 8

9<Note>9<Note>

10 Die Unterstützung für GitHub Enterprise Server ist für Team- und Enterprise-Pläne verfügbar.10 Die Unterstützung für GitHub Enterprise Server ist für Team- und Enterprise-Pläne verfügbar.

11</Note>11</Note>

12 12

13Die Unterstützung für GitHub Enterprise Server (GHES) ermöglicht es Ihrer Organisation, Claude Code mit Repositories zu verwenden, die auf Ihrer selbstverwalteten GitHub-Instanz gehostet werden, anstatt auf github.com. Sobald ein Administrator Ihre GHES-Instanz verbindet, können Entwickler Web-Sitzungen ausführen und automatisierte Code-Reviews erhalten, ohne dass eine Konfiguration pro Repository erforderlich ist. Plugin-Marktplätze, die auf Ihrer Instanz gehostet werden, werden ebenfalls unterstützt; die Anforderungen an Anmeldedaten variieren je nach Oberfläche, wie in [Plugin-Marktplätze auf GHES](#plugin-marketplaces-on-ghes) beschrieben.13Die Unterstützung für GitHub Enterprise Server (GHES) ermöglicht es Ihrer Organisation, Claude Code mit Repositories zu verwenden, die auf Ihrer selbstverwalteten GitHub-Instanz gehostet werden, anstatt auf github.com. Sobald ein Administrator Ihre GHES-Instanz verbindet, können Entwickler Cloud-Sitzungen ausführen und automatisierte Code-Reviews erhalten, ohne dass eine Konfiguration pro Repository erforderlich ist. Plugin-Marktplätze, die auf Ihrer Instanz gehostet werden, werden ebenfalls unterstützt; die Anforderungen an Anmeldedaten variieren je nach Oberfläche, wie in [Plugin-Marktplätze auf GHES](#plugin-marketplaces-on-ghes) beschrieben.

14 14

15Für Repositories auf github.com siehe [Claude Code im Web](/docs/de/claude-code-on-the-web) und [Code Review](/docs/de/code-review). Um Claude in Ihrer eigenen CI-Infrastruktur auszuführen, siehe [GitHub Actions](/docs/de/github-actions).15Für Repositories auf github.com siehe [Claude Code in der Cloud](/docs/de/claude-code-on-the-web) und [Code Review](/docs/de/code-review). Um Claude in Ihrer eigenen CI-Infrastruktur auszuführen, siehe [GitHub Actions](/docs/de/github-actions).

16 16

17<h2 id="what-works-with-github-enterprise-server">17<h2 id="what-works-with-github-enterprise-server">

18 Was mit GitHub Enterprise Server funktioniert18 Was mit GitHub Enterprise Server funktioniert

22 22

24| :- | :- | :- |24| :- | :- | :- |

~~25| Claude Code im Web | ✅ Unterstützt | Ein Owner verbindet die GHES-Instanz einmalig; Entwickler verwenden `claude --cloud` oder [claude.ai/code](https://claude.ai/code) wie gewohnt |~~25| Cloud-Sitzungen | ✅ Unterstützt | Ein Owner verbindet die GHES-Instanz einmalig; Entwickler verwenden `claude --cloud` oder [claude.ai/code](https://claude.ai/code) wie gewohnt |

65 GitHub App-Berechtigungen65 GitHub App-Berechtigungen

66</h3>66</h3>

67 67

68Das Manifest konfiguriert die GitHub App mit den Berechtigungen und Webhook-Ereignissen unten, die zusammen Web-Sitzungen, Code Review, Claude Security, Plugin-Marktplätze und Beitragskennzahlen abdecken:68Das Manifest konfiguriert die GitHub App mit den Berechtigungen und Webhook-Ereignissen unten, die zusammen Cloud-Sitzungen, Code Review, Claude Security, Plugin-Marktplätze und Beitragskennzahlen abdecken:

69 69

71| :- | :- | :- |71| :- | :- | :- |

78| Repository hooks | Lesen und Schreiben | Erstellen eines Webhooks auf einem Plugin-Marktplatz-Repository, wenn **Automatisch synchronisieren** für einen Marktplatz in [Organisationseinstellungen > Plugins](https://claude.ai/admin-settings/plugins) aktiviert ist |78| Repository hooks | Lesen und Schreiben | Erstellen eines Webhooks auf einem Plugin-Marktplatz-Repository, wenn **Automatisch synchronisieren** für einen Marktplatz in [**Organisationseinstellungen > Plugins & Skills**](https://claude.ai/admin-settings/skills?tab=marketplaces) aktiviert ist |

80| Organization members | Lesen | Abgleich der Claude GitHub App auf github.com, die dies verwendet, um die Organisationsrolle eines verbindenden Benutzers beim Verknüpfen einer Installation zu überprüfen |80| Organization members | Lesen | Abgleich der Claude GitHub App auf github.com, die dies verwendet, um die Organisationsrolle eines verbindenden Benutzers beim Verknüpfen einer Installation zu überprüfen |

81 81

110cd api-service110cd api-service

111```111```

112 112

113Starten Sie dann eine Web-Sitzung. Claude erkennt den GHES-Host aus Ihrem Git-Remote und leitet die Sitzung durch Ihre konfigurierte Organisationsinstanz:113Starten Sie dann eine Cloud-Sitzung. Claude erkennt den GHES-Host aus Ihrem Git-Remote und leitet die Sitzung durch Ihre konfigurierte Organisationsinstanz:

114 114

115```bash theme={null}115```bash theme={null}

116claude --cloud "Add retry logic to the payment webhook handler"116claude --cloud "Add retry logic to the payment webhook handler"

117```117```

118 118

119Die Sitzung klont Ihr Repository von GHES und pusht Änderungen zurück zu einem Branch. Überwachen Sie den Fortschritt unter [claude.ai/code](https://claude.ai/code). Siehe [Claude Code im Web](/docs/de/claude-code-on-the-web) für den vollständigen Cloud-Sitzungs-Workflow einschließlich Diff-Review, Auto-Fix und Routinen.119Die Sitzung klont Ihr Repository von GHES und pusht Änderungen zurück zu einem Branch. Überwachen Sie den Fortschritt unter [claude.ai/code](https://claude.ai/code). Siehe [Claude Code in der Cloud](/docs/de/claude-code-on-the-web) für den vollständigen Cloud-Sitzungs-Workflow einschließlich Diff-Review, Auto-Fix und Routinen.

120 120

121<h3 id="teleport-sessions-to-your-terminal">121<h3 id="teleport-sessions-to-your-terminal">

122 Teleport-Sitzungen zu Ihrem Terminal122 Teleport-Sitzungen zu Ihrem Terminal

123</h3>123</h3>

124 124

125Ziehen Sie eine Web-Sitzung mit `claude --teleport` in Ihr lokales Terminal. Teleport überprüft, ob Sie sich in einem Checkout des gleichen GHES-Repositories befinden, bevor der Branch abgerufen und die Sitzungshistorie geladen wird. Siehe [Teleport-Anforderungen](/docs/de/claude-code-on-the-web#teleport-requirements) für Details.125Ziehen Sie eine Cloud-Sitzung mit `claude --teleport` in Ihr lokales Terminal. Teleport überprüft, ob Sie sich in einem Checkout des gleichen GHES-Repositories befinden, bevor der Branch abgerufen und die Sitzungshistorie geladen wird. Siehe [Teleport-Anforderungen](/docs/de/claude-code-on-the-web#teleport-requirements) für Details.

126 126

127<h2 id="plugin-marketplaces-on-ghes">127<h2 id="plugin-marketplaces-on-ghes">

128 Plugin-Marktplätze auf GHES128 Plugin-Marktplätze auf GHES

136| Verwaltete Einstellungen (`extraKnownMarketplaces`) | Claude Code registriert den Eintrag und klont das Repository mit den vorhandenen Git-Anmeldedaten des Computers | Git-Zugriff auf Ihren GHES-Host von ihrem Computer |136| Verwaltete Einstellungen (`extraKnownMarketplaces`) | Claude Code registriert den Eintrag und klont das Repository mit den vorhandenen Git-Anmeldedaten des Computers | Git-Zugriff auf Ihren GHES-Host von ihrem Computer |

137| claude.ai-Organisationseinstellungen für Plugins | Ein Eigentümer wählt die GHES-Instanz als Quelle aus; Anthropics Backend ruft das Repository ab und synchronisiert es mit der GitHub App aus [Admin-Setup](#admin-setup) | Nichts pro Benutzer nach dem Hinzufügen. Der Eigentümer, der es hinzufügt, benötigt sein eigenes GitHub Enterprise-Konto als Zugriffsprüfung, und die GitHub App muss im Marktplatz-Repository installiert sein |137| claude.ai-Organisationseinstellungen für Plugins | Ein Eigentümer wählt die GHES-Instanz als Quelle aus; Anthropics Backend ruft das Repository ab und synchronisiert es mit der GitHub App aus [Admin-Setup](#admin-setup) | Nichts pro Benutzer nach dem Hinzufügen. Der Eigentümer, der es hinzufügt, benötigt sein eigenes GitHub Enterprise-Konto als Zugriffsprüfung, und die GitHub App muss im Marktplatz-Repository installiert sein |

138| claude.ai-Benutzereinstellungen | Anthropics Backend ruft das Repository mit der GitHub Enterprise-Verbindung des einreichenden Benutzers ab | Sein eigenes GitHub Enterprise-Konto, das mit Claude verbunden ist |138| claude.ai-Benutzereinstellungen | Anthropics Backend ruft das Repository mit der GitHub Enterprise-Verbindung des einreichenden Benutzers ab | Sein eigenes GitHub Enterprise-Konto, das mit Claude verbunden ist |

139| Claude Code im Web | Cloud-Sitzungen klonen Marktplätze innerhalb der Sitzungs-Sandbox. Die Sandbox kann Ihre GHES-Instanz nur erreichen, wenn sich das Repository der Sitzung auf derselben Instanz befindet, und ihre Git-Anmeldedaten sind auf die Repositories der Sitzung beschränkt | Nicht zuverlässig für GHES-gehostete Marktplätze: Ein anderer Host als das Repository der Sitzung ist nicht erreichbar, und selbst Installationen auf derselben Instanz können fehlschlagen. Verwenden Sie stattdessen die CLI, verwaltete Einstellungen oder claude.ai |139| Cloud-Sitzungen | Cloud-Sitzungen klonen Marktplätze innerhalb der Sitzungs-Sandbox. Die Sandbox kann Ihre GHES-Instanz nur erreichen, wenn sich das Repository der Sitzung auf derselben Instanz befindet, und ihre Git-Anmeldedaten sind auf die Repositories der Sitzung beschränkt | Nicht zuverlässig für GHES-gehostete Marktplätze: Ein anderer Host als das Repository der Sitzung ist nicht erreichbar, und selbst Installationen auf derselben Instanz können fehlschlagen. Verwenden Sie stattdessen die CLI, verwaltete Einstellungen oder claude.ai |

140 140

141<Warning>141<Warning>

142 GitHub Enterprise-Verbindungen auf claude.ai sind pro Benutzer, wenn ein Marktplatz aus den Benutzereinstellungen hinzugefügt wird. Das [Admin-Setup](#admin-setup) verbindet Ihre GHES-Instanz mit Ihrer Organisation, verbindet aber keine einzelnen Benutzerkonten: Jeder Benutzer, der einen GHES-Marktplatz aus seinen eigenen Einstellungen hinzufügt, muss zunächst sein eigenes GitHub Enterprise-Konto verbinden, und die Verbindung eines Benutzers, einschließlich des Eigentümers, deckt niemand anderen ab. Marktplätze, die von einem Eigentümer in den Organisationseinstellungen für Plugins hinzugefügt werden, stellen diese Anforderung nicht an Benutzer, da laufende Abrufe die GitHub App der Organisation verwenden. Der Eigentümer, der den Marktplatz hinzufügt, benötigt zum Zeitpunkt des Hinzufügens immer noch sein eigenes GitHub Enterprise-Konto.142 GitHub Enterprise-Verbindungen auf claude.ai sind pro Benutzer, wenn ein Marktplatz aus den Benutzereinstellungen hinzugefügt wird. Das [Admin-Setup](#admin-setup) verbindet Ihre GHES-Instanz mit Ihrer Organisation, verbindet aber keine einzelnen Benutzerkonten: Jeder Benutzer, der einen GHES-Marktplatz aus seinen eigenen Einstellungen hinzufügt, muss zunächst sein eigenes GitHub Enterprise-Konto verbinden, und die Verbindung eines Benutzers, einschließlich des Eigentümers, deckt niemand anderen ab. Marktplätze, die von einem Eigentümer in den Organisationseinstellungen für Plugins hinzugefügt werden, stellen diese Anforderung nicht an Benutzer, da laufende Abrufe die GitHub App der Organisation verwenden. Der Eigentümer, der den Marktplatz hinzufügt, benötigt zum Zeitpunkt des Hinzufügens immer noch sein eigenes GitHub Enterprise-Konto.

160 160

161Claude Code führt Git nicht interaktiv aus und lehnt SSH-Verbindungen zu Hosts ab, die sich nicht in der `known_hosts`-Datei des Computers befinden. Eine HTTPS-URL mit einem Git-Credential-Helper vermeidet die `known_hosts`-Anforderung.161Claude Code führt Git nicht interaktiv aus und lehnt SSH-Verbindungen zu Hosts ab, die sich nicht in der `known_hosts`-Datei des Computers befinden. Eine HTTPS-URL mit einem Git-Credential-Helper vermeidet die `known_hosts`-Anforderung.

162 162

163Siehe [Erstellen und Verteilen eines Plugin-Marktplatzes](/docs/de/plugin-marketplaces) für die vollständige Anleitung zum Erstellen von Marktplätzen.163Siehe [Erstellen und Verteilen eines Plugin-Marktplatzes](/docs/de/plugins/create-marketplace) für die vollständige Anleitung zum Erstellen von Marktplätzen.

164 164

165<h3 id="pre-register-ghes-marketplaces-with-managed-settings">165<h3 id="pre-register-ghes-marketplaces-with-managed-settings">

166 Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen166 Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen

220 Fehlerbehebung220 Fehlerbehebung

221</h2>221</h2>

222 222

223<h3 id="web-session-fails-to-clone-repository">223<h3 id="cloud-session-fails-to-clone-repository">

224 Web-Sitzung kann Repository nicht klonen224 Cloud-Sitzung kann Repository nicht klonen

225</h3>225</h3>

226 226

227Wenn `claude --cloud` mit einem Klonfehler fehlschlägt, überprüfen Sie, ob ein Owner die Einrichtung für Ihre GHES-Instanz abgeschlossen hat und ob die GitHub App auf dem Repository installiert ist, an dem Sie arbeiten. Bitten Sie den Owner, der die Instanz verbunden hat, zu bestätigen, dass der in den Claude-Einstellungen registrierte Hostname mit dem Hostnamen in Ihrem Git-Remote übereinstimmt.227Wenn `claude --cloud` mit einem Klonfehler fehlschlägt, überprüfen Sie, ob ein Owner die Einrichtung für Ihre GHES-Instanz abgeschlossen hat und ob die GitHub App auf dem Repository installiert ist, an dem Sie arbeiten. Bitten Sie den Owner, der die Instanz verbunden hat, zu bestätigen, dass der in den Claude-Einstellungen registrierte Hostname mit dem Hostnamen in Ihrem Git-Remote übereinstimmt.

246 GHES-Instanz nicht erreichbar246 GHES-Instanz nicht erreichbar

247</h3>247</h3>

248 248

249Wenn Reviews oder von Anthropic gehostete Web-Sitzungen zeitüberschritten werden, ist Ihre GHES-Instanz möglicherweise nicht von der Anthropic-Infrastruktur erreichbar. Bestätigen Sie, dass Ihre Firewall eingehende Verbindungen von Anthropics [ausgehenden IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) zulässt. Sitzungen in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) erreichen GHES von innerhalb Ihres Netzwerks, überprüfen Sie daher für diese den eigenen Netzwerkpfad des Runners und den [SCM-Connector](/docs/de/self-hosted-environments-reference#scm-connector-flags) stattdessen.249Wenn Reviews oder von Anthropic gehostete Cloud-Sitzungen zeitüberschritten werden, ist Ihre GHES-Instanz möglicherweise nicht von der Anthropic-Infrastruktur erreichbar. Bestätigen Sie, dass Ihre Firewall eingehende Verbindungen von Anthropics [ausgehenden IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) zulässt. Sitzungen in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) erreichen GHES von innerhalb Ihres Netzwerks, überprüfen Sie daher für diese den eigenen Netzwerkpfad des Runners und den [SCM-Connector](/docs/de/self-hosted-environments-reference#scm-connector-flags) stattdessen.

250 250

251<h3 id="session-start-fails-with-unable-to-get-organization-uuid">251<h3 id="session-start-fails-with-unable-to-get-organization-uuid">

252 Sitzungsstart schlägt mit `Unable to get organization UUID` fehl252 Sitzungsstart schlägt mit `Unable to get organization UUID` fehl

253</h3>253</h3>

254 254

255Web-Sitzungen erfordern eine Team- oder Enterprise-Organisation. Melden Sie sich mit `/login` mit Ihrem Organisationskonto an. Wenn Sie sich stattdessen mit einem API-Schlüssel authentifizieren, schlagen Web-Sitzungen früher fehl mit einer Nachricht, die Sie auffordert, `/login` auszuführen.255Claude Code konnte keine claude.ai-Organisation aus Ihren Anmeldedaten lesen. Melden Sie sich mit `/login` mit einem Konto in Ihrer Team- oder Enterprise-Organisation an, da die GitHub Enterprise Server-Unterstützung auf diese Pläne beschränkt ist. Siehe [Unable to get organization UUID](/docs/de/claude-code-on-the-web#unable-to-get-organization-uuid) für die Ursachen und die anderen Meldungen, die dieser Zustand erzeugt.

256 256

257<h2 id="related-resources">257<h2 id="related-resources">

258 Verwandte Ressourcen258 Verwandte Ressourcen

260 260

261Diese Seiten behandeln die in diesem Leitfaden referenzierten Funktionen ausführlicher:261Diese Seiten behandeln die in diesem Leitfaden referenzierten Funktionen ausführlicher:

262 262

263* [Claude Code im Web](/docs/de/claude-code-on-the-web): Führen Sie Claude Code-Sitzungen auf Cloud-Infrastruktur aus263* [Claude Code in der Cloud](/docs/de/claude-code-on-the-web): Führen Sie Claude Code-Sitzungen auf Cloud-Infrastruktur aus

264* [Code Review](/docs/de/code-review): Automatisierte PR-Reviews264* [Code Review](/docs/de/code-review): Automatisierte PR-Reviews

265* [Plugin-Marktplätze](/docs/de/plugin-marketplaces): Erstellen und Verteilen von Plugin-Katalogen265* [Plugin-Marktplätze](/docs/de/plugins/host-marketplace): Erstellen und Verteilen von Plugin-Katalogen

266* [Analytics](/docs/de/analytics): Verfolgen Sie Nutzung und Beitragskennzahlen266* [Analytics](/docs/de/analytics): Verfolgen Sie Nutzung und Beitragskennzahlen

267* [Verwaltete Einstellungen](/docs/de/settings): Organisationsweite Richtlinienkonfiguration267* [Verwaltete Einstellungen](/docs/de/settings): Organisationsweite Richtlinienkonfiguration

268* [Netzwerkkonfiguration](/docs/de/network-config): Firewall- und IP-Whitelist-Anforderungen268* [Netzwerkkonfiguration](/docs/de/network-config): Firewall- und IP-Whitelist-Anforderungen

glossary.md +38 −11

Details

16 AGENTS.md16 AGENTS.md

17</h3>17</h3>

18 18

19Eine Markdown-Datei mit Projektanweisungen, die Sie für KI-Coding-Agenten schreiben. Wenn Ihr Repository eine solche Datei hat und keine [CLAUDE.md](#claude-md), liest Claude sie als Ihre Projektanweisungen, ohne dass Sie eine zweite Datei hinzufügen müssen. Sie können die Einstellung **Projektanweisungen** in `/config` ändern, um Claude beide Dateien oder nur `CLAUDE.md` zu lesen. Das direkte Lesen von `AGENTS.md` erfordert Claude Code v2.1.277 oder später. In einigen Sitzungen kann Claude [`AGENTS.md` nicht lesen](/docs/de/memory#when-agents-md-support-is-unavailable), daher [importieren Sie sie stattdessen aus einer `CLAUDE.md`](/docs/de/memory#share-one-file-with-other-coding-tools).19Eine Markdown-Datei mit Projektanweisungen, die Sie für KI-Codierungs-Agenten schreiben. Wenn Ihr Repository eine solche Datei hat und keine [CLAUDE.md](#claude-md), liest Claude diese als Ihre Projektanweisungen, ohne dass Sie eine zweite Datei hinzufügen müssen. Sie können die Einstellung **Projektanweisungen** in `/config` ändern, um Claude beide Dateien oder nur `CLAUDE.md` lesen zu lassen. Das direkte Lesen von `AGENTS.md` erfordert Claude Code v2.1.277 oder später. In einigen Sitzungen [kann Claude `AGENTS.md` nicht lesen](/docs/de/memory#when-agents-md-support-is-unavailable), daher [importieren Sie sie stattdessen aus einer `CLAUDE.md`](/docs/de/memory#share-one-file-with-other-coding-tools).

20 20

21Weitere Informationen: [AGENTS.md](/docs/de/memory#agents-md)21Weitere Informationen: [AGENTS.md](/docs/de/memory#agents-md)

22 22

23<h3 id="agent-teams">23<h3 id="agent-teams">

~~24 Agent Teams~~24 Agent-Teams

25</h3>25</h3>

26 26

27Mehrere unabhängige Claude Code-Sitzungen, die von einem Team-Lead koordiniert werden, mit einer gemeinsamen Aufgabenliste und Peer-to-Peer-Messaging. Im Gegensatz zu [Subagenten](#subagent), die innerhalb einer einzelnen Sitzung ausgeführt werden und nur dem übergeordneten Element berichten, hat jedes Teammate sein eigenes Kontextfenster und Sie können direkt mit jedem von ihnen interagieren. Agent Teams sind experimentell und standardmäßig deaktiviert; siehe [Agent Teams aktivieren](/docs/de/agent-teams#enable-agent-teams).27Mehrere unabhängige Claude Code-Sitzungen, die von einem Team-Lead koordiniert werden, mit einer gemeinsamen Aufgabenliste und Peer-to-Peer-Messaging. Im Gegensatz zu [Subagenten](#subagent), die innerhalb einer einzelnen Sitzung ausgeführt werden und nur dem übergeordneten Element berichten, hat jedes Teammitglied sein eigenes Kontextfenster und Sie können direkt mit jedem von ihnen interagieren. Agent-Teams sind experimentell und standardmäßig deaktiviert; siehe [Agent-Teams aktivieren](/docs/de/agent-teams#enable-agent-teams).

28 28

~~29Weitere Informationen: [Agent Teams ausführen](/docs/de/agent-teams)~~29Weitere Informationen: [Agent-Teams ausführen](/docs/de/agent-teams)

30 30

31<h3 id="agentic-coding">31<h3 id="agentic-coding">

32 Agentic Coding32 Agentic Coding

33</h3>33</h3>

34 34

35Ein Workflow, bei dem die KI Dateien lesen, Befehle ausführen und Änderungen autonom vornehmen kann, während Sie zuschauen, umleiten oder sich entfernen, im Gegensatz zu Chat-basierten Assistenten, die nur Text antworten, den Sie selbst anwenden müssen. Claude Code ist agentic, weil es [Tools](#tool) hat, die es handeln lassen, nicht nur beraten.35Ein Workflow, bei dem die KI Dateien lesen, Befehle ausführen und Änderungen autonom vornehmen kann, während Sie zuschauen, umleiten oder sich zurückziehen, im Gegensatz zu chatgestützten Assistenten, die nur Text antworten, den Sie selbst anwenden müssen. Claude Code ist agentic, weil es [Tools](#tool) hat, die es handeln lassen, nicht nur beraten.

36 36

37Weitere Informationen: [Wie Claude Code funktioniert](/docs/de/how-claude-code-works)37Weitere Informationen: [Wie Claude Code funktioniert](/docs/de/how-claude-code-works)

38 38

40 Agentic Harness40 Agentic Harness

41</h3>41</h3>

42 42

43Die Tools, Kontextverwaltung und Ausführungsumgebung, die ein Sprachmodell in einen fähigen Coding-Agenten verwandeln. Claude Code ist das Harness; Claude ist das Modell darin. Das Harness bietet Dateizugriff, Shell-Ausführung, Berechtigungsverwaltung, Speicherladen und die Schleife, die Aktionen zusammenkettet.43Die Tools, Kontextverwaltung und Ausführungsumgebung, die ein Sprachmodell in einen fähigen Codierungs-Agenten verwandeln. Claude Code ist der Harness; Claude ist das Modell darin. Der Harness bietet Dateizugriff, Shell-Ausführung, Berechtigungsverwaltung, Speicherladen und die Schleife, die Aktionen miteinander verbindet.

44 44

45Weitere Informationen: [Wie Claude Code funktioniert](/docs/de/how-claude-code-works)45Weitere Informationen: [Wie Claude Code funktioniert](/docs/de/how-claude-code-works)

46 46

48 Agentic Loop48 Agentic Loop

49</h3>49</h3>

50 50

51Der Zyklus, den Claude für jede Aufgabe durchläuft: Kontext sammeln, Maßnahmen ergreifen, Ergebnisse überprüfen und wiederholen, bis fertig. Jede Tool-Nutzung gibt Informationen zurück, die den nächsten Schritt informieren. Sie können die Schleife jederzeit unterbrechen, um umzuleiten. Die meisten Erweiterungspunkte, einschließlich [Hooks](#hook), [Skills](#skill) und [MCP](#mcp-model-context-protocol), verbinden sich mit spezifischen Phasen dieser Schleife.51Der Zyklus, den Claude für jede Aufgabe durchläuft: Kontext sammeln, Maßnahmen ergreifen, Ergebnisse überprüfen und wiederholen, bis fertig. Jede Tool-Nutzung gibt Informationen zurück, die den nächsten Schritt informieren. Sie können die Schleife jederzeit unterbrechen, um umzuleiten. Die meisten Erweiterungspunkte, einschließlich [Hooks](#hook), [Skills](#skill) und [MCP](#mcp-model-context-protocol), verbinden sich mit bestimmten Phasen dieser Schleife.

52 52

53Weitere Informationen: [Wie Claude Code funktioniert](/docs/de/how-claude-code-works#the-agentic-loop)53Weitere Informationen: [Wie Claude Code funktioniert](/docs/de/how-claude-code-works#the-agentic-loop)

54 54

56 Artifact56 Artifact

57</h3>57</h3>

58 58

59Eine Live-, interaktive Webseite, die Claude Code aus Ihrer Sitzung auf einer privaten URL auf claude.ai veröffentlicht, damit Sie die Ausgabe visuell sehen oder teilen können, anstatt Terminaltext zu lesen. Die Seite wird aktualisiert, wenn die Sitzung erneut veröffentlicht wird. Artifacts, die Sie aus Claude Code erstellen, erscheinen in derselben Galerie wie Artifacts, die in claude.ai-Gesprächen erstellt wurden. Die Freigabe hängt von Ihrem Plan ab: Bei Pro und Max ein öffentlicher Link, den jeder öffnen kann; bei Team und Enterprise, Freigabe innerhalb Ihrer Organisation, plus öffentliche Links, sobald ein Owner diese aktiviert.59Eine Live-, interaktive Webseite, die Claude Code aus Ihrer Sitzung auf einer privaten URL auf claude.ai veröffentlicht, damit Sie die Ausgabe visuell sehen oder teilen können, anstatt Terminaltext zu lesen. Die Seite wird aktualisiert, wenn die Sitzung neu veröffentlicht wird. Artefakte, die Sie aus Claude Code erstellen, erscheinen in derselben Galerie wie Artefakte, die in claude.ai-Gesprächen erstellt wurden. Das Teilen hängt von Ihrem Plan ab: Bei Pro und Max ein öffentlicher Link, den jeder öffnen kann; bei Team und Enterprise, Teilen innerhalb Ihrer Organisation, plus öffentliche Links, sobald ein Owner diese aktiviert.

60 60

~~61Weitere Informationen: [Sitzungsausgabe als Artifacts teilen](/docs/de/artifacts)~~61Weitere Informationen: [Sitzungsausgabe als Artefakte teilen](/docs/de/artifacts)

62 62

63<h3 id="auto-memory">63<h3 id="auto-memory">

64 Auto Memory64 Auto Memory

72 Auto Mode72 Auto Mode

73</h3>73</h3>

74 74

75Ein [Berechtigungsmodus](#permission-mode), bei dem ein separates Klassifizierungsmodell Aktionen überprüft, anstatt Sie zu fragen, sodass Claude Code die meisten davon ohne Genehmigung ausführt. Claude Code fragt Sie weiterhin vor Aktionen, die Ihren expliziten Ask-Regeln entsprechen. Auf Pro-, Max- und Team-Plänen ist Auto Mode der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) für interaktive Terminal- und VS Code-Sitzungen. Der Klassifizierer blockiert Scope-Eskalation, nicht vertrauenswürdige Infrastruktur und [Prompt Injection](#prompt-injection). Tool-Ergebnisse werden aus dem entfernt, was er sieht, sodass bösartiger Inhalt in einer Datei oder Webseite ihn nicht direkt manipulieren kann.75Ein [Berechtigungsmodus](#permission-mode), bei dem ein separates Klassifizierungsmodell Aktionen überprüft, anstatt Sie zu fragen, sodass Claude Code die meisten von ihnen ausführt, ohne Sie zu fragen. Claude Code fragt Sie immer noch vor Aktionen, die Ihre expliziten Anfrageregelns entsprechen. Mit Claude Code v2.1.283 oder später ist Auto Mode der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) für interaktive Terminal- und VS Code-Sitzungen, und in früheren Versionen nur bei Pro-, Max- und Team-Plänen. Der Klassifizierer blockiert Scope-Eskalation, nicht vertrauenswürdige Infrastruktur und [Prompt Injection](#prompt-injection). Tool-Ergebnisse werden aus dem entfernt, was er sieht, sodass feindselige Inhalte in einer Datei oder Webseite ihn nicht direkt manipulieren können.

76 76

~~77Weitere Informationen: [Aufforderungen mit Auto Mode eliminieren](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)~~77Weitere Informationen: [Prompts mit Auto Mode eliminieren](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)

78 78

79<h2 id="b">79<h2 id="b">

80 B80 B

428 428

429Weitere Informationen: [Plattformen und Integrationen](/docs/de/platforms)429Weitere Informationen: [Plattformen und Integrationen](/docs/de/platforms)

430 430

431<h3 id="system-prompt">

432 System prompt

433</h3>

434

435Die Anweisungen, die Claude Code vor Ihrer Konversation bei jeder Anfrage sendet und die abdecken, wie Claude Tools nutzt, sich sicher verhält und seine Antworten formatiert. Sie können den System-Prompt mit `--append-system-prompt` ergänzen oder mit `--system-prompt` ersetzen. Der System-Prompt ist die erste Schicht des [Prompt Caching](/docs/de/prompt-caching#how-the-cache-is-organized).

436

437Ihre [CLAUDE.md](#claude-md)-Dateien und die Anweisungen Ihres [Output-Stils](#output-style) sind nicht Teil des System-Prompts. Claude Code liefert sie in der Konversation als [System-Erinnerungen](#system-reminder).

438

439Weitere Informationen: [System-Prompt-Flags](/docs/de/cli-reference#system-prompt-flags)

440

441<h3 id="system-reminder">

442 System reminder

443</h3>

444

445Eine Nachricht, die Claude Code als [Agentic Harness](#agentic-harness) zur Konversation hinzufügt, um Claude Kontext zu geben. Sie senden System-Erinnerungen nicht selbst. Claude Code fügt sie ein, während eine Sitzung läuft, zum Beispiel wenn die Sitzung startet, wenn ein Hook Text zurückgibt, oder wenn sich eine Datei auf der Festplatte ändert. Claude liest sie zusammen mit Ihren Nachrichten. Die folgenden erreichen Claude alle als System-Erinnerungen:

446

447* Ihre [CLAUDE.md](#claude-md)-Dateien

448* Die Anweisungen Ihres [Output-Stils](#output-style)

449* Text, den ein [Hook](#hook) als `additionalContext` zurückgibt

450* Die Liste der verfügbaren [Skills](#skill)

451* Ein Hinweis, dass eine Datei, die Claude früher gelesen hat, sich auf der Festplatte geändert hat

452* Die Commit- und Pull-Request-Attributionszeilen

453

454In einer protokollierten API-Anfrage erscheint eine System-Erinnerung in `<system-reminder>`-Tags innerhalb einer Benutzernachricht oder bei einigen Modellen als separate Nachricht mit der `system`-Rolle.

455

456Weitere Informationen: [Kontext, den Claude Code außerhalb des System-Prompts hinzufügt](/docs/de/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)

457

431<h2 id="t">458<h2 id="t">

432 T459 T

433</h2>460</h2>

goal.md +1 −1

Details

155 155

156Wenn ein Turn bei einem Fehler fehlschlägt, der nicht gelöscht wird, bis Sie ihn beheben, löscht Claude Code das Ziel und gibt eine Warnung aus, die die Ursache benennt. Die Warnung beginnt mit `Goal cleared after an unrecoverable error` und endet mit `Run /goal again to continue`. Beheben Sie die Ursache, dann [setzen Sie das Ziel erneut](#set-a-goal) mit `/goal <condition>`. Vier Arten von Fehlern löschen das Ziel:156Wenn ein Turn bei einem Fehler fehlschlägt, der nicht gelöscht wird, bis Sie ihn beheben, löscht Claude Code das Ziel und gibt eine Warnung aus, die die Ursache benennt. Die Warnung beginnt mit `Goal cleared after an unrecoverable error` und endet mit `Run /goal again to continue`. Beheben Sie die Ursache, dann [setzen Sie das Ziel erneut](#set-a-goal) mit `/goal <condition>`. Vier Arten von Fehlern löschen das Ziel:

157 157

158* Ein Authentifizierungsfehler, wenn Claude Code seine eigenen Anmeldedaten verwaltet. Wenn ein Host diese für Sie verwaltet, z. B. die Desktop-App, die VS Code-Erweiterung oder eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web), behält Claude Code das Ziel aktiv, da der Host den Zugriff selbst wiederherstellt.158* Ein Authentifizierungsfehler, wenn Claude Code seine eigenen Anmeldedaten verwaltet. Wenn ein Host diese für Sie verwaltet, z. B. die Desktop-App oder eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web), behält Claude Code das Ziel aktiv, da der Host den Zugriff selbst wiederherstellt.

159* Ein erschöpfter Guthabensaldo159* Ein erschöpfter Guthabensaldo

160* Ein Kontext-Overflow, den [Auto-Komprimierung](/docs/de/model-config#set-the-auto-compact-window) nicht löschen konnte160* Ein Kontext-Overflow, den [Auto-Komprimierung](/docs/de/model-config#set-the-auto-compact-window) nicht löschen konnte

161* Ein Modell, das nicht verfügbar ist161* Ein Modell, das nicht verfügbar ist

headless.md +26 −18

Details

20 Grundlegende Verwendung20 Grundlegende Verwendung

21</h2>21</h2>

22 22

23Fügen Sie das Flag `-p` (oder `--print`) zu jedem `claude`-Befehl hinzu, um ihn nicht interaktiv auszuführen. Nicht alle [CLI-Optionen](/docs/de/cli-reference) funktionieren mit `-p`. Claude Code lehnt `--bg` ab und lehnt `--cloud` mit einer Aufgabenbeschreibung mit einem Fehler ab, der den Konflikt benennt; `--cloud` mit einer Sitzungs-ID und `-p` [reiht stattdessen eine Nachricht in diese Cloud-Sitzung ein](/docs/de/claude-code-on-the-web#send-follow-ups-from-the-cli) und wird beendet. Optionen, die Sie häufig mit `-p` kombinieren, sind:23Fügen Sie das Flag `-p` (oder `--print`) zu jedem `claude`-Befehl hinzu, um ihn nicht-interaktiv auszuführen. Nicht jede [CLI-Option](/docs/de/cli-reference) kombiniert mit `-p`. Claude Code lehnt `--bg` ab und lehnt `--cloud` mit einer Aufgabenbeschreibung mit einem Fehler ab, der den Konflikt benennt; `--cloud` mit einer Sitzungs-ID und `-p` [reiht stattdessen eine Nachricht in diese Cloud-Sitzung ein](/docs/de/claude-code-on-the-web#send-follow-ups-from-the-cli) und beendet sich. Optionen, die Sie häufig mit `-p` kombinieren, sind:

24 24

25* `--continue` zum [Fortsetzen von Gesprächen](#continue-conversations)25* `--continue` zum [Fortsetzen von Gesprächen](#continue-conversations)

26* `--allowedTools` zum [automatischen Genehmigen von Tools](#auto-approve-tools)26* `--allowedTools` zum [automatischen Genehmigen von Tools](#auto-approve-tools)

32claude -p "What does the auth module do?"32claude -p "What does the auth module do?"

33```33```

34 34

35Claude Code wird mit Code 0 bei Erfolg und mit einem Code ungleich Null beendet, wenn die Ausführung fehlschlägt, sodass Ihre Skripte basierend auf dem Exit-Status verzweigen können. Wenn Sie ein ungültiges Flag übergeben, meldet Claude Code den Fehler an stderr, bevor die Ausführung beginnt. Wenn ein Fehler während der Ausführung auftritt, z. B. fehlende Authentifizierung, gibt Claude Code den Fehler als Ergebnis auf stdout aus.35Claude Code beendet sich mit Code 0 bei Erfolg und mit einem Code ungleich Null, wenn die Ausführung fehlschlägt, sodass Ihre Skripte basierend auf dem Exit-Status verzweigen können. Wenn Sie ein ungültiges Flag übergeben, meldet Claude Code den Fehler an stderr, bevor die Ausführung beginnt. Wenn ein Fehler während der Ausführung auftritt, z. B. fehlende Authentifizierung, gibt Claude Code den Fehler als Ergebnis auf stdout aus.

36 36

37<h3 id="start-faster-with-bare-mode">37<h3 id="start-faster-with-bare-mode">

38 Schneller starten mit Bare-Modus38 Schneller starten mit Bare-Modus

39</h3>39</h3>

40 40

41Fügen Sie `--bare` hinzu, um die Startzeit zu verkürzen, indem Sie die automatische Erkennung von hooks, skills, benutzerdefinierten Befehlen, [Subagenten](/docs/de/sub-agents), installierten Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md überspringen. Ohne diese Option lädt `claude -p` den gleichen [Kontext](/docs/de/how-claude-code-works#the-context-window), den eine interaktive Sitzung hätte, einschließlich alles, was im Arbeitsverzeichnis oder in `~/.claude` konfiguriert ist.41Fügen Sie `--bare` hinzu, um die Startzeit zu verkürzen, indem Sie die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, [Subagenten](/docs/de/sub-agents), installierten Plugins, MCP-Servern, automatischem Memory und CLAUDE.md überspringen. Ohne diese Option lädt `claude -p` denselben [Kontext](/docs/de/how-claude-code-works#the-context-window) wie eine interaktive Sitzung, einschließlich aller im Arbeitsverzeichnis oder in `~/.claude` konfigurierten Inhalte.

42 42

43Der Bare-Modus ist nützlich für CI und Skripte, bei denen Sie auf jedem Computer das gleiche Ergebnis benötigen. Ein hook in der `~/.claude` eines Teamkollegen oder ein MCP-Server in der `.mcp.json` des Projekts werden nicht ausgeführt, da der Bare-Modus diese nie liest. Ein Verzeichnis, das Sie mit `--add-dir` benennen, ist eine teilweise Ausnahme: Der Bare-Modus lädt Skills aus seinem `.claude/skills/`-Ordner, überspringt aber immer noch seine `.claude/commands/`- und `.claude/agents/`-Ordner. [Skills aus zusätzlichen Verzeichnissen](/docs/de/skills#skills-from-additional-directories) behandelt, was geladen wird und was nicht.43Der Bare-Modus ist nützlich für CI und Skripte, bei denen Sie auf jedem Computer das gleiche Ergebnis benötigen. Ein Hook in der `~/.claude` eines Teamkollegen oder ein MCP-Server in der `.mcp.json` des Projekts wird nicht ausgeführt, da der Bare-Modus diese nie liest. Ein Verzeichnis, das Sie mit `--add-dir` benennen, ist eine teilweise Ausnahme: Der Bare-Modus lädt Skills aus seinem `.claude/skills/`-Ordner, überspringt aber immer noch seine `.claude/commands/`- und `.claude/agents/`-Ordner. [Skills aus zusätzlichen Verzeichnissen](/docs/de/skills#skills-from-additional-directories) behandelt, was geladen wird und was nicht.

44 44

45Ohne `--bare` führt eine `-p`-Sitzung die Hooks in der `.claude/settings.json` eines Projekts aus und verbindet die Server in seiner `.mcp.json`, auch in einem Ordner, dem Sie nie vertraut haben. Eine `-p`-Sitzung zeigt keinen Workspace-Trust-Dialog und keine Pro-Server-Genehmigungsaufforderung an. [Was wird ausgeführt, bevor Sie einem Ordner vertrauen](/docs/de/permissions#what-runs-before-you-trust-a-folder) behandelt jede Art von Repository-Inhalt unter `-p` und wie Sie ihn fernhalten.45Ohne `--bare` führt eine `-p`-Sitzung die Hooks in der `.claude/settings.json` eines Projekts aus und verbindet die Server in seiner `.mcp.json`, auch in einem Ordner, dem Sie nie vertraut haben. Eine `-p`-Sitzung zeigt keinen Workspace-Trust-Dialog und keine Pro-Server-Genehmigungsaufforderung an. [Was vor dem Vertrauen in einen Ordner ausgeführt wird](/docs/de/permissions#what-runs-before-you-trust-a-folder) behandelt jede Art von Repository-Inhalt unter `-p` und wie Sie ihn fernhalten.

46 46

47Dieses Beispiel führt eine einmalige Zusammenfassungsaufgabe im Bare-Modus aus und genehmigt das Read-Tool vorab, damit der Aufruf ohne Berechtigungsaufforderung abgeschlossen wird. Setzen Sie `ANTHROPIC_API_KEY` vor dem Ausführen, da der Bare-Modus Ihren Abonnement-Login nicht verwendet:47Dieses Beispiel führt eine einmalige Zusammenfassungsaufgabe im Bare-Modus aus und genehmigt das Read-Tool im Voraus, sodass der Aufruf ohne Genehmigungsaufforderung abgeschlossen wird. Setzen Sie `ANTHROPIC_API_KEY` vor der Ausführung, da der Bare-Modus Ihren Abonnement-Login nicht verwendet:

48 48

49```bash theme={null}49```bash theme={null}

50claude --bare -p "Summarize README.md" --allowedTools "Read"50claude --bare -p "Summarize README.md" --allowedTools "Read"

51```51```

52 52

53Im Bare-Modus liest Claude Code niemals OAuth-Anmeldedaten oder den System-Keychain. 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 Cloud's Agent Platform und Microsoft Foundry lesen weiterhin ihre eigenen Anmeldedaten des Anbieters wie gewohnt.53Im 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.

54 54

~~55Im Bare-Modus hat Claude Zugriff auf die Bash-, Dateilesungs- und Dateibearbeitungstools. Übergeben Sie jeden Kontext, den Sie benötigen, mit einem Flag:~~55Im Bare-Modus hat Claude Zugriff auf die Bash-, Dateilesungs- und Dateibearbeitungs-Tools. Übergeben Sie jeden benötigten Kontext mit einem Flag:

56 56

57| Zum Laden | Verwenden Sie |57| Zum Laden | Verwenden Sie |

58| - | - |58| - | - |

60| Einstellungen | `--settings <file-or-json>` |60| Einstellungen | `--settings <file-or-json>` |

61| MCP-Server | `--mcp-config <file-or-json>` |61| MCP-Server | `--mcp-config <file-or-json>` |

62| Benutzerdefinierte Agenten | `--agents <json>` |62| Benutzerdefinierte Agenten | `--agents <json>` |

70 Hintergrundaufgaben beim Beenden70 Hintergrundaufgaben beim Beenden

71</h3>71</h3>

72 72

73Wenn Claude während einer `claude -p`-Ausführung eine [Hintergrund-Bash-Aufgabe](/docs/de/tools-reference#bash-tool-behavior) startet, beispielsweise einen Entwicklungsserver oder einen Watch-Build, wird diese Shell etwa fünf Sekunden nach der Rückgabe des endgültigen Ergebnisses durch Claude und dem Schließen von stdin beendet. Die Kulanzfrist ermöglicht es einer Aufgabe, die direkt nach dem Ergebnis endet, ihre Ausgabe noch zu liefern.73Wenn Claude während einer `claude -p`-Ausführung eine [Hintergrund-Bash-Aufgabe](/docs/de/tools-reference#bash-tool-behavior) startet, z. B. einen Dev-Server oder einen Watch-Build, wird diese Shell etwa fünf Sekunden nach der Rückgabe des Endergebnisses durch Claude und dem Schließen von stdin beendet. Die Kulanzfrist ermöglicht es einer Aufgabe, die kurz nach dem Ergebnis endet, ihre Ausgabe noch zu liefern.

74 74

75Wenn Claude einen Hintergrund-[Subagenten](/docs/de/sub-agents) oder Workflow startet, bleibt `claude -p` stattdessen offen, bis diese Arbeit abgeschlossen ist, da ihr Ergebnis Teil der endgültigen Ausgabe ist.75Wenn Claude einen Hintergrund-[Subagenten](/docs/de/sub-agents) oder Workflow startet, bleibt `claude -p` stattdessen offen, bis diese Arbeit abgeschlossen ist, da ihr Ergebnis Teil der endgültigen Ausgabe ist.

76 76

77Standardmäßig endet das Warten nach 10 Minuten kontinuierlichen Leerlauf-Wartens, sodass ein feststeckender Subagent oder Workflow den Prozess nicht auf unbestimmte Zeit offen halten kann. An diesem Punkt stoppt Claude Code, was noch läuft, und verwirft sein Teilergebnis. Um die Obergrenze zu ändern, setzen Sie [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/de/env-vars), oder setzen Sie sie auf `0`, um ohne Obergrenze zu warten.77Standardmäßig endet das Warten nach 10 Minuten kontinuierlichen Wartens im Leerlauf, sodass ein feststeckender Subagent oder Workflow den Prozess nicht unbegrenzt offen halten kann. An diesem Punkt stoppt Claude Code alles, was noch läuft, und verwirft sein Teilergebnis. Um das Limit zu ändern, setzen Sie [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/de/env-vars), oder setzen Sie es auf `0`, um ohne Limit zu warten.

78 78

79Wenn Claude einen [Monitor](/docs/de/tools-reference#monitor-tool)-Watch während einer `claude -p`-Ausführung startet, wartet Claude Code auf den Watch, bis er abläuft oder die Zehn-Minuten-Obergrenze das Warten beendet, je nachdem, was zuerst eintritt. Während es wartet, antwortet Claude weiterhin auf das, was der Watch meldet. Standardmäßig läuft ein Watch fünf Minuten ab, nachdem Claude ihn startet.79Wenn Claude während einer `claude -p`-Ausführung eine [Monitor](/docs/de/tools-reference#monitor-tool)-Watch startet, wartet Claude Code auf die Watch, bis sie abläuft oder die Zehn-Minuten-Obergrenze das Warten beendet, je nachdem, was zuerst eintritt. Während es wartet, antwortet Claude weiterhin auf das, was die Watch meldet. Standardmäßig läuft eine Watch fünf Minuten nach dem Start durch Claude ab.

80 80

81<h3 id="stop-a-run-with-sigterm">81<h3 id="stop-a-run-with-sigterm">

82 Beenden Sie eine Ausführung mit SIGTERM82 Beenden Sie eine Ausführung mit SIGTERM

83</h3>83</h3>

84 84

85Wenn Sie eine `claude -p`-Ausführung mit SIGTERM beenden, beispielsweise mit `kill` oder von einem Prozessüberwacher, wird Claude Code mit Code 143 beendet. Claude Code lässt den laufenden Turn unvollständig und zeichnet kein Ergebnis dafür auf. Um den Turn stattdessen zu beenden, senden Sie SIGINT oder rufen Sie `interrupt()` des Agent SDK auf, bevor Sie den Prozess stoppen.85Wenn Sie eine `claude -p`-Ausführung mit SIGTERM beenden, z. B. mit `kill` oder von einem Prozessüberwacher, beendet sich Claude Code mit Code 143. Claude Code lässt den laufenden Turn unvollständig und zeichnet kein Ergebnis dafür auf. Um den Turn stattdessen zu beenden, senden Sie SIGINT oder rufen Sie die `interrupt()`-Methode des Agent SDK auf, bevor Sie den Prozess stoppen.

86 86

87Bei SIGTERM beendet Claude Code den Prozessbaum aller noch laufenden Bash-Befehle. Claude Code führt dann [`SessionEnd`-Hooks](/docs/de/hooks#sessionend) aus und wird beendet. Während des Beendens startet Claude Code keinen neuen Tool-Aufruf, sendet keine neue Modellanfrage und führt keinen Hook außer `SessionEnd` aus. Wenn die Ausführung in der Mitte eines Befehls oder beim Warten auf eine Antwort auf eine Berechtigungsaufforderung war, als das Signal ankam, behandelt Claude Code diesen Schritt wie folgt:87Bei SIGTERM beendet Claude Code die Prozessstruktur aller noch laufenden Bash-Befehle. Claude Code führt dann [`SessionEnd`-Hooks](/docs/de/hooks#sessionend) aus und beendet sich. Beim Beenden startet Claude Code keinen neuen Tool-Aufruf, sendet keine neue Modellanfrage und führt keinen Hook außer `SessionEnd` aus. Wenn die Ausführung in der Mitte eines Befehls oder beim Warten auf eine Antwort auf eine Genehmigungsaufforderung war, als das Signal ankam, behandelt Claude Code diesen Schritt wie folgt:

88 88

89* **Ausführung eines Befehls**: Claude Code zeichnet den Befehl als beendet in der Sitzung auf.89* **Ausführung eines Befehls**: Claude Code zeichnet den Befehl als beendet in der Sitzung auf.

90* **Warten auf eine Antwort auf eine Berechtigungsaufforderung**: Wenn Sie SIGTERM an den Prozess senden, lässt Claude Code die Aufforderung unbeantwortet. Wenn Ihr Programm die Sitzung durch das Agent SDK schließt, beendet das SDK Claudes Eingabe, bevor es ein Signal sendet, und Claude Code bricht die Aufforderung ab, sobald die Eingabe endet.90* **Warten auf eine Antwort auf eine Genehmigungsaufforderung**: Wenn Sie SIGTERM an den Prozess senden, lässt Claude Code die Aufforderung unbeantwortet. Wenn Ihr Programm die Sitzung über das Agent SDK schließt, beendet das SDK Claude Codes Eingabe vor dem Senden eines Signals, und Claude Code bricht die Aufforderung auf, sobald die Eingabe endet.

91 91

~~92Wenn Sie die Sitzung [fortsetzen](#continue-conversations), setzt Claude Code den Turn fort, den SIGTERM unvollständig gelassen hat.~~92Wenn Sie [die Sitzung fortsetzen](#continue-conversations), lässt Claude Code den unterbrochenen Turn unverändert, und Ihre nächste Eingabe treibt das Gespräch voran. Um Claude Code stattdessen den unterbrochenen Turn beim Fortsetzen fortzusetzen, setzen Sie [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN=1`](/docs/de/env-vars).

94<h3 id="if-the-working-directory-is-deleted">

95 Wenn das Arbeitsverzeichnis gelöscht wird

96</h3>

98Wenn das Arbeitsverzeichnis einer `claude -p`- oder Agent SDK-Sitzung während der Sitzung gelöscht wird, läuft die Sitzung weiter. Wenn ein Turn beginnt, während das Verzeichnis fehlt, gibt Claude Code eine [Warnmeldung](/docs/de/agent-sdk/typescript#sdkinformationalmessage) in der `stream-json`-Ausgabe aus, und Shell-Befehle schlagen fehl, bis das Verzeichnis wieder vorhanden ist.

93 99

94<h2 id="examples">100<h2 id="examples">

95 Beispiele101 Beispiele

190 196

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

192 198

193Wenn Ihr Consumer den Stream langsam liest, wartet Claude Code darauf, dass die warteschlange Ausgabe abfließt, bevor es beendet wird, und skaliert das Warten mit der noch warteschlange Menge, begrenzt auf 30 Sekunden. Vor v2.1.214 war die Ausstiegswartzeit auf etwa zwei Sekunden begrenzt, was das Ende einer großen Antwort abschneiden konnte.199Wenn Ihr Consumer den Stream langsam liest, wartet Claude Code darauf, dass die warteschlangige Ausgabe abfließt, bevor es beendet wird, und skaliert das Warten mit der noch warteschlangigen Menge, begrenzt auf 30 Sekunden. Vor v2.1.214 war die Ausstiegswartzeit auf etwa zwei Sekunden begrenzt, was das Ende einer großen Antwort abschneiden konnte.

194 200

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

196 202

255| Feld | Typ | Beschreibung |261| Feld | Typ | Beschreibung |

256| - | - | - |262| - | - | - |

258| `plugin_errors` | Array | Plugin-Ladefehler, jeweils mit `plugin`, `type` und `message`. Umfasst nicht erfüllte Abhängigkeitsversionen und `--plugin-dir`-Ladefehler wie einen fehlenden Pfad oder ein ungültiges Archiv. Betroffene Plugins werden herabgestuft und fehlen in `plugins`. Der Schlüssel wird weggelassen, wenn es keine Fehler gibt |264| `plugin_errors` | Array | Plugin-Ladefehler, jeweils mit `plugin`, `type` und `message`. Umfasst nicht erfüllte Abhängigkeitsversionen und `--plugin-dir`-Ladefehler wie einen fehlenden Pfad oder ein ungültiges Archiv. Ein Plugin, das nicht geladen wurde, fehlt in `plugins`. Der Schlüssel wird weggelassen, wenn es keine Fehler gibt |

265

266Wenn ein `--plugin-dir`-Verzeichnis oder -Archiv selbst nicht geladen wird, enthält sein `plugin_errors`-Eintrag den aufgelösten absoluten Pfad als `path`. Verwenden Sie ihn, um zu erkennen, welcher von mehreren `--plugin-dir`-Werten fehlgeschlagen ist. Das Feld `path` erfordert Claude Code v2.1.283 oder später.

259 267

260Verwenden Sie die MCP-Server-Felder auf die gleiche Weise. Wenn Sie [`--mcp-config`](/docs/de/cli-reference#cli-flags) mit `-p` übergeben, wartet Claude Code auf noch ausstehende Server, bevor der erste Zug ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars)-Starttimeout, standardmäßig 30 Sekunden. Ein Remote-Server mit einer [zwischengespeicherten Tool-Liste](/docs/de/agent-sdk/mcp#connection-timing) überspringt das Warten, zeigt `pending` in `system/init` an und verbindet sich beim ersten Tool-Aufruf. Das Warten erfordert Claude Code v2.1.221 oder später.268Verwenden Sie die MCP-Server-Felder auf die gleiche Weise. Wenn Sie [`--mcp-config`](/docs/de/cli-reference#cli-flags) mit `-p` übergeben, wartet Claude Code auf noch ausstehende Server, bevor der erste Zug ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars)-Starttimeout, standardmäßig 30 Sekunden. Ein Remote-Server mit einer [zwischengespeicherten Tool-Liste](/docs/de/agent-sdk/mcp#connection-timing) überspringt das Warten, zeigt `pending` in `system/init` an und verbindet sich beim ersten Tool-Aufruf. Das Warten erfordert Claude Code v2.1.221 oder später.

261 269

hooks.md +288 −292

Details

420Jedes Objekt im inneren `hooks`-Array ist ein Hook-Handler: der Shell-Befehl, HTTP-Endpunkt, MCP-Tool, LLM-Prompt oder Agent, der ausgeführt wird, wenn der Matcher passt. Es gibt fünf Typen:420Jedes Objekt im inneren `hooks`-Array ist ein Hook-Handler: der Shell-Befehl, HTTP-Endpunkt, MCP-Tool, LLM-Prompt oder Agent, der ausgeführt wird, wenn der Matcher passt. Es gibt fünf Typen:

421 421

422* **[Command-Hooks](#command-hook-fields)** (`type: "command"`): Führen einen Shell-Befehl aus. Ihr Skript empfängt die [JSON-Eingabe](#hook-input-and-output) des Ereignisses auf stdin und kommuniziert Ergebnisse über Exit-Codes und stdout zurück.422* **[Command-Hooks](#command-hook-fields)** (`type: "command"`): Führen einen Shell-Befehl aus. Ihr Skript empfängt die [JSON-Eingabe](#hook-input-and-output) des Ereignisses auf stdin und kommuniziert Ergebnisse über Exit-Codes und stdout zurück.

423* **[HTTP-Hooks](#http-hook-fields)** (`type: "http"`): Senden Sie die [JSON-Eingabe](#hook-input-and-output) des Ereignisses als HTTP-POST-Anfrage an eine URL. Der Endpunkt kommuniziert Ergebnisse über den Antwortkörper mit dem gleichen [JSON-Ausgabeformat](#json-output) wie Command-Hooks zurück.423* **[HTTP-Hooks](#http-hook-fields)** (`type: "http"`): Senden Sie die JSON-Eingabe des Ereignisses als HTTP-POST-Anfrage an eine URL. Der Endpunkt kommuniziert Ergebnisse über den Antwortkörper mit dem gleichen [JSON-Ausgabeformat](#json-output) wie Command-Hooks zurück.

424* **[MCP-Tool-Hooks](#mcp-tool-hook-fields)** (`type: "mcp_tool"`): Rufen Sie ein Tool auf einem bereits verbundenen [MCP-Server](/docs/de/mcp) auf. Die Textausgabe des Tools wird wie Command-Hook-stdout behandelt.424* **[MCP-Tool-Hooks](#mcp-tool-hook-fields)** (`type: "mcp_tool"`): Rufen Sie ein Tool auf einem konfigurierten [MCP-Server](/docs/de/mcp) auf. Die Textausgabe des Tools wird wie Command-Hook-stdout behandelt.

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

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

427 427

474| `command` | ja | Shell-Befehl zum Ausführen. Mit `args` die Ausführungsdatei zum direkten Spawnen. Siehe [Exec-Form und Shell-Form](#exec-form-and-shell-form) |474| `command` | ja | Shell-Befehl zum Ausführen. Mit `args` die Ausführungsdatei zum direkten Spawnen. Siehe [Exec-Form und Shell-Form](#exec-form-and-shell-form) |

475| `args` | nein | Argumentliste. Wenn vorhanden, wird `command` als Ausführungsdatei aufgelöst und direkt mit `args` als Argumentvektor gespawnt, ohne Shell. Siehe [Exec-Form und Shell-Form](#exec-form-and-shell-form) |475| `args` | nein | Argumentliste. Wenn vorhanden, wird `command` als Ausführungsdatei aufgelöst und direkt mit `args` als Argumentvektor gespawnt, ohne Shell. Siehe [Exec-Form und Shell-Form](#exec-form-and-shell-form) |

477| `asyncRewake` | nein | Wenn `true`, wird im Hintergrund ausgeführt und weckt Claude bei Exit-Code 2 auf. Die stderr des Hooks oder stdout, wenn stderr leer ist, wird Claude als Systemerinnerung angezeigt, damit es auf einen langfristigen Hintergrund-Fehler reagieren kann |477| `asyncRewake` | nein | Wenn `true`, wird im Hintergrund ausgeführt und weckt Claude bei Exit-Code 2 auf. Die stderr des Hooks oder stdout, wenn stderr leer ist, wird Claude als [Systemerinnerung](/docs/de/glossary#system-reminder) angezeigt, damit es auf einen langfristigen Hintergrund-Fehler reagieren kann |

478| `shell` | nein | Shell, die für diesen Hook verwendet werden soll. Akzeptiert `"bash"` oder `"powershell"`. Standardmäßig `"bash"` oder `"powershell"` unter Windows, wenn Git Bash nicht installiert ist. Das Setzen von `"powershell"` führt den Befehl über PowerShell unter Windows aus. Erfordert nicht `CLAUDE_CODE_USE_POWERSHELL_TOOL`, da Hooks PowerShell direkt spawnen. Wird ignoriert, wenn `args` gesetzt ist |478| `shell` | nein | Shell, die für diesen Hook verwendet werden soll. Akzeptiert `"bash"` oder `"powershell"`. Standardmäßig `"bash"` oder `"powershell"` unter Windows, wenn Git Bash nicht installiert ist. Das Setzen von `"powershell"` führt den Befehl über PowerShell unter Windows aus. Erfordert nicht `CLAUDE_CODE_USE_POWERSHELL_TOOL`, da Hooks PowerShell direkt spawnen. Wird ignoriert, wenn `args` gesetzt ist |

479 479

480<a id="exec-form-and-shell-form" />480<a id="exec-form-and-shell-form" />

571 571

573| :- | :- | :- |573| :- | :- | :- |

574| `server` | ja | Name eines konfigurierten MCP-Servers. Für einen [Plugin-gebündelten Server](/docs/de/mcp#plugin-provided-mcp-servers) ist dies der bereichsbezogene Name `plugin:<plugin-name>:<server-name>`, z. B. `plugin:my-plugin:db`, nicht der bloße Server-Schlüssel. Der Server muss bereits verbunden sein; der Hook löst nie einen OAuth- oder Verbindungsfluss aus |574| `server` | ja | Name eines konfigurierten MCP-Servers. Für einen [Plugin-gebündelten Server](/docs/de/mcp#plugin-provided-mcp-servers) ist dies der bereichsbezogene Name `plugin:<plugin-name>:<server-name>`, z. B. `plugin:my-plugin:db`, nicht der bloße Server-Schlüssel |

575| `tool` | ja | Name des Tools, das auf diesem Server aufgerufen werden soll |575| `tool` | ja | Name des Tools, das auf diesem Server aufgerufen werden soll |

576| `input` | nein | Argumente, die an das Tool übergeben werden. Zeichenkettenwerte unterstützen `${path}`-Ersetzung aus der [JSON-Eingabe](#hook-input-and-output) des Hooks, z. B. `"${tool_input.file_path}"` |576| `input` | nein | Argumente, die an das Tool übergeben werden. Zeichenkettenwerte unterstützen `${path}`-Ersetzung aus der [JSON-Eingabe](#hook-input-and-output) des Hooks, z. B. `"${tool_input.file_path}"` |

577 577

578Claude Code liest den Textinhalt des Tools auf die gleiche Weise wie Command-Hook-stdout und folgt der [Parsing-Regel unter Exit-Code 0](#exit-code-0). Wenn der benannte Server nicht verbunden ist oder das Tool `isError: true` zurückgibt, erzeugt der Hook einen nicht blockierenden Fehler und die Ausführung wird fortgesetzt.

~~579~~

580Dieses Beispiel ruft das Tool `security_scan` auf dem MCP-Server `my_server` nach jedem `Write` oder `Edit` auf und übergibt den Pfad der bearbeiteten Datei:578Dieses Beispiel ruft das Tool `security_scan` auf dem MCP-Server `my_server` nach jedem `Write` oder `Edit` auf und übergibt den Pfad der bearbeiteten Datei:

581 579

582```json theme={null}580```json theme={null}

599}597}

600```598```

601 599

602Ein `mcp_tool`-Hook kann nur ausgeführt werden, nachdem Claude Code die MCP-Server der Sitzung für Hooks verfügbar gemacht hat. `SessionStart` und `Setup` können vor diesem Punkt ausgelöst werden:600<h5 id="how-the-tool’s-result-is-read">

601 Wie das Ergebnis des Tools gelesen wird

602</h5>

603 603

604* **Beim Start**: `SessionStart` wird ausgelöst, bevor die Server verfügbar sind, auch wenn Sie mit `--continue` oder `--resume` starten. Claude Code überspringt die `mcp_tool`-Hooks des Ereignisses, ohne ihre Tools aufzurufen, und das [Debug-Log](#debug-hooks) zeichnet `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)` auf.604Claude Code liest den Textinhalt des Tools auf die gleiche Weise wie Command-Hook-stdout und folgt der [Parsing-Regel unter Exit-Code 0](#exit-code-0). Wenn das Tool `isError: true` zurückgibt, erzeugt der Hook einen nicht blockierenden Fehler und die Ausführung wird fortgesetzt.

605* **Später in einer laufenden Sitzung**: Nach `/clear` oder einer Komprimierung wird `SessionStart` erneut ausgelöst, wobei die Server bereits verfügbar sind, und seine `mcp_tool`-Hooks werden ausgeführt.

606* **Bei `Setup`**: `Setup` wird immer ausgelöst, bevor die Server verfügbar sind, sodass Claude Code seine `mcp_tool`-Hooks jedes Mal überspringt und die gleiche Nachricht aufzeichnet, die `Setup` benennt.

607 605

608Zum Beispiel ruft diese Konfiguration das Tool `load_context` auf dem MCP-Server `my_server` aus einem `SessionStart`-Hook ohne Matcher auf, sodass es auf jede `SessionStart`-Quelle angewendet wird:606<h5 id="when-the-server-is-still-connecting">

607 Wenn der Server noch verbunden wird

608</h5>

609 609

610```json theme={null}610Bei Ereignissen, bei denen ein Hook blockieren oder das Ergebnis ändern kann, z. B. `PreToolUse` oder `Stop`, wartet Claude Code auf einen verbindenden Server, bevor es das Tool aufruft, für höchstens [`MCP_TIMEOUT`](/docs/de/env-vars) und innerhalb des [`timeout`](#common-fields) des Hooks. Bei Beobachtungsereignissen, z. B. `Notification` oder `SessionEnd`, wartet es nicht.

611{

612 "hooks": {

613 "SessionStart": [

614 {

615 "hooks": [

616 {

617 "type": "mcp_tool",

618 "server": "my_server",

619 "tool": "load_context"

620 }

621 ]

622 }

623 ]

624 }

625}

626```

627 611

628Wenn Sie `claude` ausführen, überspringt Claude Code diesen Hook, ruft `load_context` nie auf und schreibt die Nachricht `no MCP client context` in das Debug-Log. Führen Sie `/clear` in dieser gleichen Sitzung aus und der Hook wird ausgeführt und ruft `load_context` auf. Ein `type: "command"`-Hook auf `SessionStart` wird beim Start ausgeführt, verwenden Sie also einen für alles, das die Sitzung von ihrem ersten Turn benötigt.612Ein Server mit dem [`cached`-Status](/docs/de/mcp#server-status-detail) verbindet sich, wenn der Hook sein Tool aufruft. Wenn der Server zu diesem Zeitpunkt nicht verbunden ist, erzeugt der Hook einen nicht blockierenden Fehler und die Ausführung wird fortgesetzt. Der Hook startet nie einen OAuth-Fluss, also [authentifizieren Sie den Server von `/mcp`](/docs/de/mcp#authenticate-with-remote-mcp-servers) zuerst.

613

614<h5 id="events-that-fire-before-mcp-servers-are-available">

615 Ereignisse, die ausgelöst werden, bevor MCP-Server verfügbar sind

616</h5>

617

618`SessionStart` beim Start, einschließlich mit `--continue` oder `--resume`, und jedes `Setup`-Ereignis werden ausgelöst, bevor die MCP-Server der Sitzung für Hooks verfügbar sind. Claude Code überspringt ihre `mcp_tool`-Hooks ohne Aufruf des Tools, und das [Debug-Log](#debug-hooks) zeichnet `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)` auf, oder die gleiche Nachricht, die `Setup` benennt. Wenn `SessionStart` später in der Sitzung erneut ausgelöst wird, nach `/clear` oder einer Komprimierung, werden seine `mcp_tool`-Hooks ausgeführt. Für alles, das die Sitzung beim Start benötigt, verwenden Sie stattdessen einen `type: "command"`-Hook auf `SessionStart`.

629 619

630<h4 id="prompt-and-agent-hook-fields">620<h4 id="prompt-and-agent-hook-fields">

631 Prompt- und Agent-Hook-Felder621 Prompt- und Agent-Hook-Felder

637| :- | :- | :- |627| :- | :- | :- |

638| `prompt` | ja | Prompt-Text zum Senden an das Modell. Verwenden Sie `$ARGUMENTS` als Platzhalter für die Hook-Eingabe-JSON. Mit einem Backslash escapen, um wörtlichen Text einzuschließen: `\$1.00` wird als `$1.00` gerendert |628| `prompt` | ja | Prompt-Text zum Senden an das Modell. Verwenden Sie `$ARGUMENTS` als Platzhalter für die Hook-Eingabe-JSON. Mit einem Backslash escapen, um wörtlichen Text einzuschließen: `\$1.00` wird als `$1.00` gerendert |

640 630

641<h3 id="reference-scripts-by-path">631<h3 id="reference-scripts-by-path">

642 Skripte nach Pfad referenzieren632 Skripte nach Pfad referenzieren

791| `prompt_id` | UUID, die den aktuell verarbeiteten Benutzer-Prompt identifiziert. Stimmt mit dem [`prompt.id`-Attribut auf OpenTelemetry-Events](/docs/de/monitoring-usage#event-correlation-attributes) überein, sodass Sie Hook-Ausgabe mit Telemetrie für einen einzelnen Prompt korrelieren können. Nicht vorhanden bis zur ersten Benutzereingabe. Erfordert Claude Code v2.1.196 oder später |781| `prompt_id` | UUID, die den aktuell verarbeiteten Benutzer-Prompt identifiziert. Stimmt mit dem [`prompt.id`-Attribut auf OpenTelemetry-Events](/docs/de/monitoring-usage#event-correlation-attributes) überein, sodass Sie Hook-Ausgabe mit Telemetrie für einen einzelnen Prompt korrelieren können. Nicht vorhanden bis zur ersten Benutzereingabe. Erfordert Claude Code v2.1.196 oder später |

792| `transcript_path` | Pfad zur Konversations-JSON. Die Transkriptdatei wird asynchron geschrieben und kann der In-Memory-Konversation hinterherhinken, daher kann sie möglicherweise noch nicht die neuesten Nachrichten des aktuellen Turns enthalten, wenn ein Hook ausgelöst wird. Hooks, die den endgültigen Assistant-Text des aktuellen Turns benötigen, sollten `last_assistant_message` auf [Stop](#stop) und [SubagentStop](#subagentstop) verwenden, anstatt das Transkript zu lesen |782| `transcript_path` | Pfad zur Konversations-JSON. Die Transkriptdatei wird asynchron geschrieben und kann der In-Memory-Konversation hinterherhinken, daher kann sie möglicherweise noch nicht die neuesten Nachrichten des aktuellen Turns enthalten, wenn ein Hook ausgelöst wird. Hooks, die den endgültigen Assistant-Text des aktuellen Turns benötigen, sollten `last_assistant_message` auf [Stop](#stop) und [SubagentStop](#subagentstop) verwenden, anstatt das Transkript zu lesen |

793| `cwd` | Aktuelles Arbeitsverzeichnis, wenn der Hook aufgerufen wird |783| `cwd` | Aktuelles Arbeitsverzeichnis, wenn der Hook aufgerufen wird |

794| `scratchpad_dir` | Pfad zum Scratchpad-Verzeichnis der Session, in dem Claude temporäre Arbeitsdateien speichert. Nicht vorhanden, wenn die Session kein Scratchpad hat oder das Temp-Verzeichnis nicht verfügbar ist. Erfordert Claude Code v2.1.257 oder später |784| `scratchpad_dir` | Pfad zum [Scratchpad-Verzeichnis der Session](/docs/de/claude-directory#session-scratchpad-directory), in dem Claude temporäre Arbeitsdateien speichert. Nicht vorhanden, wenn die Session kein Scratchpad hat oder das Temp-Verzeichnis nicht verfügbar ist. Erfordert Claude Code v2.1.257 oder später |

795| `permission_mode` | Aktueller [Berechtigungsmodus](/docs/de/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` oder `"bypassPermissions"`. Der als **Manuell** bezeichnete Modus kommt als `"default"` an, nie als `"manual"`, sodass Skripte, die `"default"` abgleichen, weiterhin funktionieren. Nicht alle Events erhalten dieses Feld. Überprüfen Sie das JSON-Beispiel in jedem [Hook-Event](#hook-events)-Abschnitt |785| `permission_mode` | Aktueller [Berechtigungsmodus](/docs/de/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` oder `"bypassPermissions"`. Der als **Manuell** bezeichnete Modus kommt als `"default"` an, nie als `"manual"`, sodass Skripte, die `"default"` abgleichen, weiterhin funktionieren. Nicht alle Events erhalten dieses Feld. Überprüfen Sie das JSON-Beispiel in jedem [Hook-Event](#hook-events)-Abschnitt |

796| `effort` | Objekt mit einem `level`-Feld, das die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) enthält, die wirksam ist, wenn der Hook ausgeführt wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Wenn Sie eine Stufe festlegen, die das aktive Modell nicht unterstützt, meldet `level` die Stufe, die Claude Code stattdessen ausgeführt hat; [Effort-Stufe anpassen](/docs/de/model-config#adjust-effort-level) sagt, wie es diese Stufe auswählt. Ultracode ist keine separate Stufe und wird als `"xhigh"` gemeldet. Das Objekt stimmt mit dem [Status-Feld](/docs/de/statusline#available-data) `effort`-Feld überein. Vorhanden für Events, die innerhalb eines Tool-Use-Kontexts ausgelöst werden, wie `PreToolUse`, `PostToolUse`, `Stop` und `SubagentStop`, wenn das aktuelle Modell den Effort-Parameter unterstützt. Die Stufe ist auch für Hook-Befehle und das Bash-Tool als die `$CLAUDE_EFFORT`-Umgebungsvariable verfügbar. |786| `effort` | Objekt mit einem `level`-Feld, das die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) enthält, die wirksam ist, wenn der Hook ausgeführt wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Wenn Sie eine Stufe festlegen, die das aktive Modell nicht unterstützt, meldet `level` die Stufe, die Claude Code stattdessen ausgeführt hat; [Effort-Stufe anpassen](/docs/de/model-config#adjust-effort-level) sagt, wie es diese Stufe auswählt. Das Objekt stimmt mit dem [Status-Feld](/docs/de/statusline#available-data) `effort`-Feld überein. Vorhanden für Events, die innerhalb eines Tool-Use-Kontexts ausgelöst werden, wie `PreToolUse`, `PostToolUse`, `Stop` und `SubagentStop`, wenn das aktuelle Modell den Effort-Parameter unterstützt. Die Stufe ist auch für Hook-Befehle und das Bash-Tool als die `$CLAUDE_EFFORT`-Umgebungsvariable verfügbar. |

798 788

799Bei Ausführung mit `--agent` oder innerhalb eines Subagenten sind zwei zusätzliche Felder enthalten:789Bei Ausführung mit `--agent` oder innerhalb eines Subagenten sind zwei zusätzliche Felder enthalten:

1057 Kontext für Claude hinzufügen1047 Kontext für Claude hinzufügen

1058</h4>1048</h4>

1059 1049

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

1061 1051

1062Geben Sie `additionalContext` innerhalb von `hookSpecificOutput` neben dem Event-Namen zurück:1052Geben Sie `additionalContext` innerhalb von `hookSpecificOutput` neben dem Event-Namen zurück:

1063 1053

1179 Hook-Ereignisse1169 Hook-Ereignisse

1180</h2>1170</h2>

1181 1171

1182Jedes Ereignis entspricht einem Punkt im Lebenszyklus von Claude Code, an dem Hooks ausgeführt werden können. Die folgenden Abschnitte sind in der Reihenfolge des Lebenszyklus angeordnet: von der Sitzungseinrichtung über die agentengesteuerte Schleife bis zum Sitzungsende. Jeder Abschnitt beschreibt, wann das Ereignis ausgelöst wird, welche Matcher es unterstützt, welche JSON-Eingabe es empfängt, und wie das Verhalten durch die Ausgabe gesteuert wird.1172Jedes Ereignis entspricht einem Punkt im Lebenszyklus von Claude Code, an dem Hooks ausgeführt werden können. Die folgenden Abschnitte sind in der Reihenfolge des Lebenszyklus angeordnet: von der Sitzungseinrichtung über die agentengesteuerte Schleife bis zum Sitzungsende. Jeder Abschnitt beschreibt, wann das Ereignis ausgelöst wird, welche Matcher es unterstützt, welche JSON-Eingabe es empfängt und wie das Verhalten durch die Ausgabe gesteuert wird.

1183 1173

1184<h3 id="sessionstart">1174<h3 id="sessionstart">

1185 SessionStart1175 SessionStart

1189 1179

1190SessionStart wird bei jeder Sitzung ausgeführt, daher halten Sie diese Hooks schnell. Nur `type: "command"` und `type: "mcp_tool"` Hooks werden unterstützt. Siehe [MCP-Tool-Hook-Felder](#mcp-tool-hook-fields) für den Zeitpunkt der Ausführung von `mcp_tool` Hooks.1180SessionStart wird bei jeder Sitzung ausgeführt, daher halten Sie diese Hooks schnell. Nur `type: "command"` und `type: "mcp_tool"` Hooks werden unterstützt. Siehe [MCP-Tool-Hook-Felder](#mcp-tool-hook-fields) für den Zeitpunkt der Ausführung von `mcp_tool` Hooks.

1191 1181

1192Der Matcher-Wert entspricht der Art, wie die Sitzung eingeleitet wurde:1182Der Matcher-Wert entspricht der Art, wie die Sitzung initiiert wurde:

1193 1183

1194| Matcher | Wann wird es ausgelöst |1184| Matcher | Wann wird es ausgelöst |

1195| :- | :- |1185| :- | :- |

1203 1193

1204Wenn Sie eine interaktive Sitzung starten, ein Gespräch beim Start mit `--continue` oder `--resume` fortsetzen oder `/clear` ausführen, werden SessionStart-Hooks im Hintergrund ausgeführt. Sie können sofort tippen, und ein fortgesetztes Gespräch wird angezeigt, ohne auf die Hooks zu warten. Claudes erste Antwort wartet immer noch darauf, dass die Hooks fertig sind, damit ihr Kontext Claude erreicht.1194Wenn Sie eine interaktive Sitzung starten, ein Gespräch beim Start mit `--continue` oder `--resume` fortsetzen oder `/clear` ausführen, werden SessionStart-Hooks im Hintergrund ausgeführt. Sie können sofort tippen, und ein fortgesetztes Gespräch wird angezeigt, ohne auf die Hooks zu warten. Claudes erste Antwort wartet immer noch darauf, dass die Hooks fertig sind, damit ihr Kontext Claude erreicht.

1205 1195

1206Wenn Sie mit `/resume` innerhalb einer Sitzung zu Gesprächen wechseln, wartet der Wechsel darauf, dass die Hooks fertig sind. Wenn Sie `/clear` ausführen oder zu einem anderen Gespräch wechseln, während Hintergrund-Hooks noch laufen, gilt nichts, was sie zurückgeben, für die Sitzung.1196Wenn Sie ein Gespräch mit `/resume` innerhalb einer Sitzung wechseln, wartet der Wechsel darauf, dass die Hooks fertig sind. Wenn Sie `/clear` ausführen oder zu einem anderen Gespräch wechseln, während Hintergrund-Hooks noch laufen, gilt nichts, was sie zurückgeben, für die Sitzung.

1207 1197

1208Die gleiche Wartezeit gilt beim Start, einschließlich einer fortgesetzten Sitzung: eine Eingabeaufforderung, die Sie senden, während SessionStart-Hooks noch laufen, erreicht Claude nicht, bis sie fertig sind.1198Die gleiche Wartezeit gilt beim Start, einschließlich einer fortgesetzten Sitzung: eine Eingabeaufforderung, die Sie senden, während SessionStart-Hooks noch laufen, erreicht Claude nicht, bis sie fertig sind.

1209 1199

1210Während dieser Wartezeit drücken Sie `Esc`, um die Eingabeaufforderung zurück in die Eingabe zu nehmen, ohne sie zu senden. Die Hooks laufen weiter.1200Während des Wartens drücken Sie `Esc`, um die Eingabeaufforderung ohne Senden zurück in die Eingabe zu nehmen. Die Hooks laufen weiter.

1211 1201

1212<h4 id="sessionstart-input">1202<h4 id="sessionstart-input">

1213 SessionStart-Eingabe1203 SessionStart-Eingabe

1218| Feld | Beschreibung |1208| Feld | Beschreibung |

1219| :- | :- |1209| :- | :- |

1220| `source` | Wie die Sitzung gestartet wurde: `"startup"` für neue Sitzungen, `"resume"` für fortgesetzte Sitzungen, `"clear"` nach `/clear`, `"compact"` nach Komprimierung oder `"fork"` für eine neue Sitzung, die aus einer vorhandenen abgezweigt wurde |1210| `source` | Wie die Sitzung gestartet wurde: `"startup"` für neue Sitzungen, `"resume"` für fortgesetzte Sitzungen, `"clear"` nach `/clear`, `"compact"` nach Komprimierung oder `"fork"` für eine neue Sitzung, die aus einer vorhandenen abgezweigt wurde |

1221| `model` | Die aktive Modell-ID. Sie kann weggelassen werden, z. B. nach `/clear` oder wenn eine Sitzung durch Gesprächswiederherstellung wiederhergestellt wird, daher überprüfen Sie das Feld, bevor Sie es lesen |1211| `model` | Der aktive Modellbezeichner. Er kann weggelassen werden, z. B. nach `/clear` oder wenn eine Sitzung durch Gesprächswiederherstellung wiederhergestellt wird, daher überprüfen Sie das Feld vor dem Lesen |

1223| `session_title` | Der aktuelle Sitzungstitel, falls bereits gesetzt, z. B. über `--name` oder `/rename`. Ein Hook, der `sessionTitle` ausgibt, kann `session_title` zuerst überprüfen, um zu vermeiden, dass ein Titel überschrieben wird, den der Benutzer explizit gesetzt hat |1213| `session_title` | Der aktuelle Sitzungstitel, falls bereits gesetzt, z. B. über `--name` oder `/rename`. Ein Hook, der `sessionTitle` ausgibt, kann `session_title` zuerst überprüfen, um zu vermeiden, dass ein Titel überschrieben wird, den der Benutzer explizit gesetzt hat |

1224 1214

1227| Feld | Beschreibung |1217| Feld | Beschreibung |

1228| :- | :- |1218| :- | :- |

1231| `prompt_cache_likely_expired` | `true`, wenn die letzte Antwort älter ist als die [Prompt-Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime) der Sitzung oder eine spätere Komprimierung das zwischengespeicherte Gespräch ersetzt hat |1221| `prompt_cache_likely_expired` | `true`, wenn die letzte Antwort älter ist als die [Prompt-Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime) der Sitzung oder eine spätere Komprimierung das zwischengespeicherte Gespräch ersetzt hat |

1232| `estimated_cache_write_usd` | Geschätzte Kosten in US-Dollar für das Schreiben von `context_tokens` in den Prompt-Cache auf dem Modell der Sitzung, ohne die Antwort |1222| `estimated_cache_write_usd` | Geschätzte Kosten in US-Dollar für das Schreiben von `context_tokens` in den Prompt-Cache auf dem Modell der Sitzung, ohne die Antwort |

1233 1223

1256 1246

1257| Feld | Beschreibung |1247| Feld | Beschreibung |

1258| :- | :- |1248| :- | :- |

1259| `additionalContext` | String, der zu Claudes Kontext am Anfang des Gesprächs hinzugefügt wird, vor der ersten Eingabeaufforderung. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude), um zu erfahren, wie der Text bereitgestellt wird und was Sie darin einfügen sollten |1249| `additionalContext` | String, der zu Claudes Kontext am Anfang des Gesprächs hinzugefügt wird, vor der ersten Eingabeaufforderung. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) für die Lieferung des Textes und was darin enthalten sein sollte |

1260| `initialUserMessage` | String, der als erste Benutzernachricht der Sitzung verwendet wird. Gilt im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p` Flag, wo es zum ersten Zug wird, auch wenn keine Eingabeaufforderung bereitgestellt wird. Wenn eine Eingabeaufforderung bereitgestellt wird, folgt sie als nächster Zug. Im Gegensatz zu `additionalContext`, das an einen vorhandenen Zug angehängt wird, erstellt dies den Zug |1250| `initialUserMessage` | String, der als erste Benutzernachricht der Sitzung verwendet wird. Gilt im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p` Flag, wo es zum ersten Zug wird, auch wenn keine Eingabeaufforderung bereitgestellt wird. Wenn eine Eingabeaufforderung bereitgestellt wird, folgt sie als nächster Zug. Im Gegensatz zu `additionalContext`, das an einen vorhandenen Zug angehängt wird, erstellt dies den Zug |

1261| `sessionTitle` | Legt den Sitzungstitel fest, mit der gleichen Wirkung wie `/rename`. Verwenden Sie dies, um Sitzungen automatisch aus dem Start-Ordner, Git-Branch oder Worktree-Namen zu benennen. Gilt, wenn `source` `"startup"`, `"resume"` oder `"fork"` ist; wird bei `"clear"` und `"compact"` ignoriert |1251| `sessionTitle` | Legt den Sitzungstitel fest, mit der gleichen Wirkung wie `/rename`. Verwenden Sie dies, um Sitzungen automatisch aus dem Start-Ordner, Git-Branch oder Worktree-Namen zu benennen. Gilt, wenn `source` `"startup"`, `"resume"` oder `"fork"` ist; wird bei `"clear"` und `"compact"` ignoriert |

1262| `watchPaths` | Array von absoluten Pfaden zum Überwachen von [FileChanged](#filechanged) Ereignissen während dieser Sitzung |1252| `watchPaths` | Array von absoluten Pfaden zum Überwachen von [FileChanged](#filechanged) Ereignissen während dieser Sitzung |

1263| `reloadSkills` | Boolean. Wenn `true`, scannt Claude Code die [Skill](/docs/de/skills)- und Befehlsverzeichnisse erneut, nachdem die SessionStart-Hooks abgeschlossen sind, sodass Skills, die der Hook installiert hat, in der gleichen Sitzung verfügbar sind, beginnend mit der ersten Eingabeaufforderung |1253| `reloadSkills` | Boolean. Wenn `true`, scannt Claude Code die [Skill](/docs/de/skills) und Befehlsverzeichnisse erneut, nachdem die SessionStart-Hooks abgeschlossen sind, damit Skills, die der Hook installiert hat, in der gleichen Sitzung verfügbar sind, beginnend mit der ersten Eingabeaufforderung |

1264 1254

1265```json theme={null}1255```json theme={null}

1266{1256{

1272}1262}

1273```1263```

1274 1264

1275Da Klartext-stdout bereits dieses Ereignis für Claude erreicht, kann ein Hook, der nur Kontext lädt, direkt zu stdout drucken, ohne JSON zu erstellen. Verwenden Sie die JSON-Form, wenn Sie Kontext mit anderen Feldern wie `sessionTitle` kombinieren müssen.1265Da Klartext-stdout bereits dieses Ereignis für Claude erreicht, kann ein Hook, der nur Kontext lädt, direkt zu stdout drucken, ohne JSON zu erstellen. Verwenden Sie das JSON-Format, wenn Sie Kontext mit anderen Feldern wie `sessionTitle` kombinieren müssen.

1276 1266

1277Verwenden Sie `reloadSkills`, wenn ein SessionStart-Hook Skills installiert oder aktualisiert. Die Skill-Erkennung wird normalerweise ausgeführt, bevor SessionStart-Hooks fertig sind, daher würden Dateien, die der Hook in `~/.claude/skills/` oder `.claude/skills/` schreibt, sonst erst in der nächsten Sitzung angezeigt. Dieses Beispiel synchronisiert ein gemeinsames Skills-Repository und fordert die erneute Überprüfung an:1267Verwenden Sie `reloadSkills`, wenn ein SessionStart-Hook Skills installiert oder aktualisiert. Die Skill-Erkennung wird normalerweise ausgeführt, bevor SessionStart-Hooks fertig sind, daher würden Dateien, die der Hook in `~/.claude/skills/` oder `.claude/skills/` schreibt, sonst erst in der nächsten Sitzung angezeigt. Dieses Beispiel synchronisiert ein gemeinsames Skills-Repository und fordert die erneute Überprüfung an:

1278 1268

1347 1337

1348Wenn Sie ein Gespräch mit `-p` starten oder fortsetzen, müssen Sie auch eine Eingabeaufforderung bereitstellen, als Argument oder über stdin weitergeleitet. Sie können die Eingabeaufforderung überspringen, wenn ein `SessionStart` Hook [`initialUserMessage`](#sessionstart-decision-control) bereitstellt oder wenn Sie eine Sitzung mit einem [aufgeschobenen Tool-Aufruf](#defer-a-tool-call-for-later) fortsetzen.1338Wenn Sie ein Gespräch mit `-p` starten oder fortsetzen, müssen Sie auch eine Eingabeaufforderung bereitstellen, als Argument oder über stdin weitergeleitet. Sie können die Eingabeaufforderung überspringen, wenn ein `SessionStart` Hook [`initialUserMessage`](#sessionstart-decision-control) bereitstellt oder wenn Sie eine Sitzung mit einem [aufgeschobenen Tool-Aufruf](#defer-a-tool-call-for-later) fortsetzen.

1349 1339

1350Bei Erfolg druckt `--init-only` nichts auf das Terminal. Um zu bestätigen, dass die Hooks ausgeführt wurden, starten Sie mit `claude --debug-file <path> --init-only`, ersetzen Sie `<path>` durch einen Protokolldateispeicherort, und überprüfen Sie das Protokoll auf die Setup- und SessionStart-Hook-Einträge.1340Bei Erfolg druckt `--init-only` nichts auf dem Terminal. Um zu bestätigen, dass die Hooks ausgeführt wurden, starten Sie mit `claude --debug-file <path> --init-only`, ersetzen Sie `<path>` durch einen Protokolldateispeicherort, und überprüfen Sie das Protokoll auf die Setup- und SessionStart-Hook-Einträge.

1351 1341

1352Da Setup nicht bei jedem Start ausgeführt wird, kann sich ein Plugin, das eine Abhängigkeit installiert benötigt, nicht nur auf Setup verlassen. Das praktische Muster ist, die Abhängigkeit bei der ersten Verwendung zu überprüfen und bei Fehlen zu installieren, z. B. ein Hook oder Skill, der auf `${CLAUDE_PLUGIN_DATA}/node_modules` testet und `npm install` ausführt, wenn nicht vorhanden. Siehe das [persistente Datenverzeichnis](/docs/de/plugins/components#path-variables-and-persistent-data), um zu erfahren, wo installierte Abhängigkeiten gespeichert werden. Wenn Sie Ihr Plugin über einen Marketplace verteilen, benötigen Sie möglicherweise dieses Muster nicht: Claude Code [installiert automatisch berechtigte Node.js-Paketabhängigkeiten](/docs/de/plugins/loading#node-js-package-dependencies), wenn es das Plugin zwischenspeichert.1342Da Setup nicht bei jedem Start ausgeführt wird, kann sich ein Plugin, das eine Abhängigkeit installiert haben muss, nicht nur auf Setup verlassen. Das praktische Muster ist, die Abhängigkeit bei der ersten Verwendung zu überprüfen und bei Fehlen zu installieren, z. B. ein Hook oder Skill, der auf `${CLAUDE_PLUGIN_DATA}/node_modules` testet und `npm install` ausführt, wenn nicht vorhanden. Siehe das [Verzeichnis für persistente Daten](/docs/de/plugins/components#path-variables-and-persistent-data) für den Speicherort installierter Abhängigkeiten. Wenn Sie Ihr Plugin über einen Marketplace verteilen, benötigen Sie möglicherweise dieses Muster nicht: Claude Code [installiert automatisch berechtigte Node.js-Paketabhängigkeiten](/docs/de/plugins/loading#node-js-package-dependencies), wenn es das Plugin zwischenspeichert.

1353 1343

1354<h4 id="setup-input">1344<h4 id="setup-input">

1355 Setup-Eingabe1345 Setup-Eingabe

1373 1363

1374Setup-Hooks können nicht blockieren; die Ausführung wird bei jedem Exit-Code fortgesetzt. Bei jedem Exit-Code verwirft Claude Code die [JSON-Ausgabefelder](#json-output) eines Setup-Hooks, wie `systemMessage`, `continue` und `hookSpecificOutput.additionalContext`. Mit `-p` werden stdout, stderr und Exit-Code eines Setup-Hooks in der Ausgabe des Laufs nur als [`hook_response` Ereignisse](/docs/de/headless#read-session-metadata) angezeigt, wenn Sie mit `--output-format stream-json --verbose` starten.1364Setup-Hooks können nicht blockieren; die Ausführung wird bei jedem Exit-Code fortgesetzt. Bei jedem Exit-Code verwirft Claude Code die [JSON-Ausgabefelder](#json-output) eines Setup-Hooks, wie `systemMessage`, `continue` und `hookSpecificOutput.additionalContext`. Mit `-p` werden stdout, stderr und Exit-Code eines Setup-Hooks in der Ausgabe des Laufs nur als [`hook_response` Ereignisse](/docs/de/headless#read-session-metadata) angezeigt, wenn Sie mit `--output-format stream-json --verbose` starten.

1375 1365

1376Setup-Hooks haben Zugriff auf `CLAUDE_ENV_FILE`. Variablen, die in diese Datei geschrieben werden, bleiben in nachfolgenden Bash-Befehlen für die Sitzung bestehen, genau wie in [SessionStart-Hooks](#persist-environment-variables). Nur `type: "command"` Hooks werden auf `Setup` ausgeführt. Ein `type: "mcp_tool"` Hook auf `Setup` wird immer übersprungen, wie unter [MCP-Tool-Hook-Felder](#mcp-tool-hook-fields) beschrieben.1366Setup-Hooks haben Zugriff auf `CLAUDE_ENV_FILE`. Variablen, die in diese Datei geschrieben werden, bleiben in nachfolgenden Bash-Befehlen für die Sitzung erhalten, genau wie in [SessionStart-Hooks](#persist-environment-variables). Nur `type: "command"` Hooks werden auf `Setup` ausgeführt. Ein `type: "mcp_tool"` Hook auf `Setup` wird immer übersprungen, wie unter [MCP-Tool-Hook-Felder](#mcp-tool-hook-fields) beschrieben.

1377 1367

1378<h3 id="instructionsloaded">1368<h3 id="instructionsloaded">

1379 InstructionsLoaded1369 InstructionsLoaded

1380</h3>1370</h3>

1381 1371

1382Wird ausgeführt, wenn eine `CLAUDE.md` oder `.claude/rules/*.md` Datei in den Kontext geladen wird. Dieses Ereignis wird beim Sitzungsstart für eifrig geladene Dateien ausgeführt und später erneut, wenn Dateien träge geladen werden, z. B. wenn Claude auf ein Unterverzeichnis zugreift, das eine verschachtelte `CLAUDE.md` enthält, oder wenn bedingte Regeln mit `paths:` Frontmatter übereinstimmen. Der Hook unterstützt keine Blockierung oder Entscheidungskontrolle. Er wird asynchron zu Beobachtungszwecken ausgeführt.1372Wird ausgelöst, wenn eine `CLAUDE.md` oder `.claude/rules/*.md` Datei in den Kontext geladen wird. Dieses Ereignis wird beim Sitzungsstart für eifrig geladene Dateien ausgelöst und später erneut, wenn Dateien träge geladen werden, z. B. wenn Claude auf ein Unterverzeichnis zugreift, das eine verschachtelte `CLAUDE.md` enthält, oder wenn bedingte Regeln mit `paths:` Frontmatter übereinstimmen. Der Hook unterstützt keine Blockierung oder Entscheidungskontrolle. Er wird asynchron zu Beobachtungszwecken ausgeführt.

1383 1373

1384Dieses Ereignis wird nicht ausgeführt, wenn Claude [direkt `AGENTS.md` liest](/docs/de/memory#agents-md) über die Einstellung **Projektanweisungen**. Es wird ausgeführt, wenn eine `CLAUDE.md` Ihre `AGENTS.md` importiert, mit `load_reason` auf `include` gesetzt wie für jede andere importierte Datei, und wenn `CLAUDE.md` ein Symlink zu ihr ist, als normales `CLAUDE.md` Laden.1374Dieses Ereignis wird nicht ausgelöst, wenn Claude [direkt `AGENTS.md` liest](/docs/de/memory#agents-md) über die Einstellung **Projektanweisungen**. Es wird ausgelöst, wenn eine `CLAUDE.md` Ihre `AGENTS.md` importiert, mit `load_reason` auf `include` wie für jede andere importierte Datei, und wenn `CLAUDE.md` ein Symlink dazu ist, als normale `CLAUDE.md` Ladung.

1385 1375

1386Der Matcher wird gegen `load_reason` ausgeführt. Verwenden Sie beispielsweise `"matcher": "session_start"`, um nur für Dateien zu aktivieren, die beim Sitzungsstart geladen werden, oder `"matcher": "path_glob_match|nested_traversal"`, um nur für träge Ladevorgänge zu aktivieren.1376Der Matcher wird gegen `load_reason` ausgeführt. Verwenden Sie beispielsweise `"matcher": "session_start"`, um nur für Dateien zu aktivieren, die beim Sitzungsstart geladen werden, oder `"matcher": "path_glob_match|nested_traversal"`, um nur für träge Ladevorgänge zu aktivieren.

1387 1377

1395| :- | :- |1385| :- | :- |

1398| `load_reason` | Warum die Datei geladen wurde: `"session_start"`, `"nested_traversal"`, `"path_glob_match"`, `"include"` oder `"compact"`. Der `"compact"` Wert wird ausgeführt, wenn Anweisungsdateien nach einem Komprimierungsereignis erneut geladen werden |1388| `load_reason` | Warum die Datei geladen wurde: `"session_start"`, `"nested_traversal"`, `"path_glob_match"`, `"include"` oder `"compact"`. Der `"compact"` Wert wird ausgelöst, wenn Anweisungsdateien nach einem Komprimierungsereignis erneut geladen werden |

1399| `globs` | Pfad-Glob-Muster aus dem `paths:` Frontmatter der Datei, falls vorhanden. Nur für `path_glob_match` Ladevorgänge vorhanden |1389| `globs` | Pfad-Glob-Muster aus dem `paths:` Frontmatter der Datei, falls vorhanden. Nur für `path_glob_match` Ladevorgänge vorhanden |

1434 UserPromptSubmit-Eingabe1424 UserPromptSubmit-Eingabe

1435</h4>1425</h4>

1436 1426

1437Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten UserPromptSubmit-Hooks das `prompt` Feld mit dem Text, den der Benutzer eingereicht hat. Eingefügter Inhalt, der zu einem `[Pasted text #N]` Platzhalter zusammengefallen ist, kommt erweitert an seiner Stelle an. In Sitzungen, in denen Claude Code [eingefügten Text für Claude markiert](/docs/de/terminal-config#how-claude-treats-pasted-text), sitzt dieser erweiterte Inhalt zwischen einer `<pasted_content id="…">` Zeile und einer `</pasted_content id="…">` Zeile, daher berücksichtigen Sie diese Zeilen, wenn Ihr Hook die Eingabeaufforderung analysiert.1427Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten UserPromptSubmit-Hooks das `prompt` Feld mit dem Text, den der Benutzer eingereicht hat. Eingefügter Inhalt, der zu einem `[Pasted text #N]` Platzhalter zusammengefallen ist, kommt erweitert an Ort und Stelle an. In Sitzungen, in denen Claude Code [eingefügten Text für Claude markiert](/docs/de/terminal-config#how-claude-treats-pasted-text), sitzt dieser erweiterte Inhalt zwischen einer `<pasted_content id="…">` Zeile und einer `</pasted_content id="…">` Zeile, daher berücksichtigen Sie diese Zeilen, wenn Ihr Hook die Eingabeaufforderung analysiert.

1438 1428

1439```json theme={null}1429```json theme={null}

1440{1430{

1453 1443

1454`UserPromptSubmit` Hooks können steuern, ob eine Benutzereingabeaufforderung verarbeitet wird und Kontext hinzufügen. Alle [JSON-Ausgabefelder](#json-output) sind verfügbar.1444`UserPromptSubmit` Hooks können steuern, ob eine Benutzereingabeaufforderung verarbeitet wird und Kontext hinzufügen. Alle [JSON-Ausgabefelder](#json-output) sind verfügbar.

1455 1445

1456Es gibt zwei Möglichkeiten, Kontext zum Gespräch bei Exit-Code 0 hinzuzufügen:1446Es gibt zwei Möglichkeiten, Kontext zum Gespräch beim Exit-Code 0 hinzuzufügen:

1457 1447

1458* **Klartext-stdout**: Claude Code fügt stdout, das es [als Klartext behandelt](#exit-code-0), zu Claudes Kontext hinzu1448* **Klartext-stdout**: Claude Code fügt stdout, das es [als Klartext behandelt](#exit-code-0), zu Claudes Kontext hinzu

1459* **JSON mit `additionalContext`**: Verwenden Sie das JSON-Format unten für mehr Kontrolle. Das `additionalContext` Feld wird als Kontext hinzugefügt1449* **JSON mit `additionalContext`**: Verwenden Sie das JSON-Format unten für mehr Kontrolle. Das `additionalContext` Feld wird als Kontext hinzugefügt

1460 1450

1461Keiner der Kanäle erzeugt einen sichtbaren Transkript-Eintrag. Klartext-stdout und der `additionalContext` Wert werden jeweils als Systemerinnerung eingefügt, die mit dem Namen des Hooks beginnt; Claude liest beide. Um die Bereitstellung zu bestätigen, überprüfen Sie das [Debug-Protokoll](#debug-hooks).1451Keiner der Kanäle erzeugt einen sichtbaren Transkript-Eintrag. Klartext-stdout und der `additionalContext` Wert werden jeweils als Systemerinnerung eingefügt, die mit dem Namen des Hooks beginnt; Claude liest beide. Um die Lieferung zu bestätigen, überprüfen Sie das [Debug-Protokoll](#debug-hooks).

1462 1452

1463Um eine Eingabeaufforderung zu blockieren, geben Sie ein JSON-Objekt mit `decision` auf `"block"` zurück:1453Um eine Eingabeaufforderung zu blockieren, geben Sie ein JSON-Objekt mit `decision` auf `"block"` zurück:

1464 1454

1465| Feld | Beschreibung |1455| Feld | Beschreibung |

1466| :- | :- |1456| :- | :- |

1467| `decision` | `"block"` verhindert, dass die Eingabeaufforderung verarbeitet wird und löscht sie aus dem Kontext. Weglassen, um die Eingabeaufforderung fortzufahren |1457| `decision` | `"block"` verhindert, dass die Eingabeaufforderung verarbeitet wird und löscht sie aus dem Kontext. Weglassen, um die Eingabeaufforderung fortzusetzen |

1469| `additionalContext` | String, der zu Claudes Kontext neben der eingereichten Eingabeaufforderung hinzugefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |1459| `additionalContext` | String, der zu Claudes Kontext neben der eingereichten Eingabeaufforderung hinzugefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |

1470| `sessionTitle` | Legt den Sitzungstitel fest. Verwenden Sie dies, um Sitzungen automatisch basierend auf dem Inhalt der Eingabeaufforderung zu benennen |1460| `sessionTitle` | Legt den Sitzungstitel fest. Verwenden Sie dies, um Sitzungen automatisch basierend auf dem Inhalt der Eingabeaufforderung zu benennen |

1471| `suppressOriginalPrompt` | Wenn `true`, wenn `decision` `"block"` ist, wird der ursprüngliche Eingabeaufforderungstext aus der angezeigten Blockierungsmeldung weggelassen |1461| `suppressOriginalPrompt` | Wenn `true`, wenn `decision` `"block"` ist, wird der ursprüngliche Eingabeaufforderungstext aus der angezeigten Blockierungsnachricht weggelassen |

1472 1462

1473Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `reason` weitergeleitet: Die Blockierungsmeldung zeigt dem Benutzer den stderr-Text an, und er wird nicht zum Kontext hinzugefügt.1463Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `reason` weitergeleitet: Die Blockierungsnachricht zeigt dem Benutzer den stderr-Text an und wird nicht zum Kontext hinzugefügt.

1474 1464

1475```json theme={null}1465```json theme={null}

1476{1466{

1488 UserPromptExpansion1478 UserPromptExpansion

1489</h3>1479</h3>

1490 1480

1491Wird ausgeführt, wenn ein vom Benutzer eingegebener Befehl vor dem Erreichen von Claude in eine Eingabeaufforderung erweitert wird. Verwenden Sie dies, um bestimmte Befehle von direkter Aufrufen zu blockieren, Kontext für einen bestimmten Skill einzufügen oder zu protokollieren, welche Befehle Benutzer aufrufen. Beispielsweise kann ein Hook, der `deploy` abgleicht, `/deploy` blockieren, es sei denn, eine Genehmigungsdatei ist vorhanden, oder ein Hook, der einen Review-Skill abgleicht, kann die Review-Checkliste des Teams als `additionalContext` anhängen.1481Wird ausgeführt, wenn ein vom Benutzer eingegebener Befehl vor dem Erreichen von Claude in eine Eingabeaufforderung erweitert wird. Verwenden Sie dies, um bestimmte Befehle von direkter Aufrufe zu blockieren, Kontext für einen bestimmten Skill einzufügen oder zu protokollieren, welche Befehle Benutzer aufrufen. Beispielsweise kann ein Hook, der `deploy` abgleicht, `/deploy` blockieren, es sei denn, eine Genehmigungsdatei ist vorhanden, oder ein Hook, der einen Review-Skill abgleicht, kann die Review-Checkliste des Teams als `additionalContext` anhängen.

1492 1482

1493Dieses Ereignis deckt den Pfad ab, den `PreToolUse` nicht abdeckt: Ein `PreToolUse` Hook, der das `Skill` Tool abgleicht, wird nur ausgeführt, wenn Claude das Tool aufruft, aber das direkte Eingeben von `/skillname` umgeht `PreToolUse`. `UserPromptExpansion` wird auf diesem direkten Pfad ausgeführt.1483Dieses Ereignis deckt den Pfad ab, den `PreToolUse` nicht abdeckt: Ein `PreToolUse` Hook, der das `Skill` Tool abgleicht, wird nur ausgelöst, wenn Claude das Tool aufruft, aber das direkte Eingeben von `/skillname` umgeht `PreToolUse`. `UserPromptExpansion` wird auf diesem direkten Pfad ausgelöst.

1494 1484

1495Gleicht `command_name` ab. Lassen Sie den Matcher leer, um bei jedem Eingabeaufforderungs-Typ-Befehl zu aktivieren.1485Gleicht `command_name` ab. Lassen Sie den Matcher leer, um bei jedem Eingabeaufforderungs-Befehl zu aktivieren.

1496 1486

1497<h4 id="userpromptexpansion-input">1487<h4 id="userpromptexpansion-input">

1498 UserPromptExpansion-Eingabe1488 UserPromptExpansion-Eingabe

1523 1513

1524| Feld | Beschreibung |1514| Feld | Beschreibung |

1525| :- | :- |1515| :- | :- |

1528| `additionalContext` | String, der zu Claudes Kontext neben der erweiterten Eingabeaufforderung hinzugefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |1518| `additionalContext` | String, der zu Claudes Kontext neben der erweiterten Eingabeaufforderung hinzugefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |

1529 1519

1530Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `reason` weitergeleitet: Die Blockierungsmeldung zeigt dem Benutzer den stderr-Text an.1520Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `reason` weitergeleitet: Die Blockierungsnachricht zeigt dem Benutzer den stderr-Text an.

1531 1521

1532```json theme={null}1522```json theme={null}

1533{1523{

1544 MessageDisplay1534 MessageDisplay

1545</h3>1535</h3>

1546 1536

1547Wird ausgeführt, während eine Assistenten-Nachricht auf den Bildschirm gestreamt wird. Claude Code zeigt die Nachricht in Inkrementen an: Jedes Mal, wenn ein Batch neu fertiggestellter Zeilen zum Rendern bereit ist, wird der Hook einmal mit diesen Zeilen ausgeführt und Claude Code rendert den Ersatztext des Hooks an ihrer Stelle. Eine lange Nachricht erzeugt mehrere Aufrufe; eine kurze Nachricht kann nur einen erzeugen.1537Wird ausgeführt, während eine Assistenten-Nachricht auf den Bildschirm gestreamt wird. Claude Code zeigt die Nachricht in Schritten an: Jedes Mal, wenn ein Batch neu fertiggestellter Zeilen zum Rendern bereit ist, wird der Hook einmal mit diesen Zeilen ausgeführt und Claude Code rendert den Ersatztext des Hooks an ihrer Stelle. Eine lange Nachricht erzeugt mehrere Aufrufe; eine kurze Nachricht kann nur einen erzeugen.

1548 1538

1549Verwenden Sie MessageDisplay für:1539Verwenden Sie MessageDisplay für:

1550 1540

1552* Den Text transformieren, den eine Agent SDK Anwendung ihren Benutzern zeigt1542* Den Text transformieren, den eine Agent SDK Anwendung ihren Benutzern zeigt

1553* API-Schlüssel oder interne Hostnamen aus Claudes Antworten redigieren1543* API-Schlüssel oder interne Hostnamen aus Claudes Antworten redigieren

1554 1544

1555Claude Code hält jeden Batch, bis Ihr Hook zurückkommt, daher halten Sie den Hook schnell. Wenn der Hook fehlschlägt oder das Timeout überschreitet, zeigt Claude Code den ursprünglichen Text an. Das Standard-Timeout für dieses Ereignis beträgt 10 Sekunden; wenn Ihr Hook mehr Zeit benötigt, setzen Sie das `timeout` Feld im Hook-Eintrag.1545Claude Code hält jeden Batch, bis Ihr Hook zurückkehrt, daher halten Sie den Hook schnell. Wenn der Hook fehlschlägt oder das Timeout überschreitet, zeigt Claude Code den ursprünglichen Text an. Das Standard-Timeout für dieses Ereignis beträgt 10 Sekunden; wenn Ihr Hook mehr Zeit benötigt, setzen Sie das `timeout` Feld im Hook-Eintrag.

1556 1546

1557MessageDisplay ist nur für die Anzeige: Der Ersatztext ändert nur das, was auf dem Bildschirm gerendert wird. Das Transkript und das, was Claude sieht, behalten den ursprünglichen Text, daher sieht Claude den Ersatz nie, und der ausführliche Modus zeigt das Original. Der Hook empfängt nur Assistenten-Nachrichtentext, daher werden Tool-Ergebnisse und der Text, den Sie eingeben, unverändert gerendert.1547MessageDisplay ist nur für die Anzeige: Der Ersatztext ändert nur das, was auf dem Bildschirm gerendert wird. Das Transkript und was Claude sieht, behalten den ursprünglichen Text, daher sieht Claude den Ersatz nie, und der ausführliche Modus zeigt das Original. Der Hook empfängt nur Assistenten-Nachrichtentext, daher werden Tool-Ergebnisse und der Text, den Sie eingeben, unverändert gerendert.

1558 1548

1559MessageDisplay unterstützt keine Matcher und wird für jede Assistenten-Nachricht ausgeführt, die Text streamt; Nachrichten ohne Text, wie nur Tool-Aufrufe, lösen es nicht aus.1549MessageDisplay unterstützt keine Matcher und wird für jede Assistenten-Nachricht ausgelöst, die Text streamt; Nachrichten ohne Text, wie nur Tool-Aufrufe, lösen es nicht aus.

1560 1550

1561In nicht-interaktiven Läufen, einschließlich Agent SDK Abfragen und `claude -p`, wird MessageDisplay einmal pro Assistenten-Nachricht statt einmal pro Batch von Zeilen ausgeführt. Der einzelne Aufruf kommt nach Abschluss der Nachricht an und trägt den vollständigen Nachrichtentext: `index` ist `0`, `final` ist `true` und `delta` enthält die gesamte Nachricht. Ein Hook, der den `delta` Text für jede Nachricht sammelt, empfängt den gleichen Gesamttext in beiden Modi.1551In nicht-interaktiven Läufen, einschließlich Agent SDK Abfragen und `claude -p`, wird MessageDisplay einmal pro Assistenten-Nachricht statt einmal pro Batch von Zeilen ausgeführt. Der einzelne Aufruf kommt an, nachdem die Nachricht abgeschlossen ist und trägt den vollständigen Nachrichtentext: `index` ist `0`, `final` ist `true` und `delta` hält die gesamte Nachricht. Ein Hook, der den `delta` Text für jede Nachricht sammelt, empfängt den gleichen Gesamttext in beiden Modi.

1562 1552

1563<h4 id="messagedisplay-input">1553<h4 id="messagedisplay-input">

1564 MessageDisplay-Eingabe1554 MessageDisplay-Eingabe

1565</h4>1555</h4>

1566 1556

1567Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten MessageDisplay-Hooks Identifikatoren für den Zug und die Nachricht, die Position dieses Aufrufs innerhalb der Nachricht und den neuen Text in `delta`. Batch-Grenzen hängen davon ab, wie der Text streamt, daher verwenden Sie `index` und `final`, um den Fortschritt durch eine Nachricht zu verfolgen, anstatt zu erwarten, dass Zeilen auf eine bestimmte Weise gruppiert werden.1557Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten MessageDisplay-Hooks Bezeichner für den Zug und die Nachricht, die Position dieses Aufrufs innerhalb der Nachricht und den neuen Text in `delta`. Batch-Grenzen hängen davon ab, wie der Text streamt, daher verwenden Sie `index` und `final`, um den Fortschritt durch eine Nachricht zu verfolgen, anstatt zu erwarten, dass Zeilen auf eine bestimmte Weise gruppiert werden.

1568 1558

1569| Feld | Beschreibung |1559| Feld | Beschreibung |

1570| :- | :- |1560| :- | :- |

1572| `message_id` | UUID der angezeigten Assistenten-Nachricht. Stabil über jeden Batch der gleichen Nachricht. Dies ist nicht die API `msg_…` ID, daher kann sie nicht mit Transkript-Nachrichten-IDs korreliert werden |1562| `message_id` | UUID der Assistenten-Nachricht, die angezeigt wird. Stabil über jeden Batch der gleichen Nachricht. Dies ist nicht die API `msg_…` ID, daher kann sie nicht mit Transkript-Nachrichten-IDs korreliert werden |

1575| `delta` | Die neu fertiggestellten Zeilen seit dem vorherigen Batch, einschließlich abschließender Zeilenumbrüche. Immer ganze Zeilen, außer dem finalen Batch, der in der Mitte einer Zeile enden kann. In interaktiven Läufen ist das Delta des finalen Batches leer, wenn die Nachricht mit einem Zeilenumbruch endet, daher behandeln Sie `final`, nicht ein nicht-leeres Delta, als das End-of-Message-Signal. In Agent SDK und `claude -p` Läufen trägt der einzelne Aufruf die gesamte Nachricht |1565| `delta` | Die neu fertiggestellten Zeilen seit dem vorherigen Batch, einschließlich abschließender Zeilenumbrüche. Immer ganze Zeilen, außer dem finalen Batch, der möglicherweise mitten in einer Zeile endet. In interaktiven Läufen ist das Delta des finalen Batches leer, wenn die Nachricht auf einem Zeilenumbruch endet, daher behandeln Sie `final`, nicht ein nicht leeres Delta, als das End-of-Message-Signal. In Agent SDK und `claude -p` Läufen trägt der einzelne Aufruf die gesamte Nachricht |

1576 1566

1577```json theme={null}1567```json theme={null}

1578{1568{

1598| :- | :- |1588| :- | :- |

1600 1590

1601MessageDisplay-Hooks haben keine Entscheidungskontrolle. Sie können die Nachricht nicht blockieren oder ändern, was im Transkript gespeichert oder an Claude gesendet wird. Claude Code handelt `displayContent` aus ihrer JSON-Ausgabe und verwirft `systemMessage` und `continue`.1591MessageDisplay-Hooks haben keine Entscheidungskontrolle. Sie können die Nachricht nicht blockieren oder ändern, was im Transkript gespeichert oder an Claude gesendet wird. Claude Code handelt auf `displayContent` aus ihrer JSON-Ausgabe und verwirft `systemMessage` und `continue`.

1602 1592

1603Dieses Beispiel entfernt Markdown-Formatierung aus Claudes Antworten für eine Klartext-Anzeige. Das Skript liest jeden Batch von stdin, entfernt fette Marker und Inline-Code-Backticks aus `delta` und gibt das Ergebnis als `displayContent` zurück.1593Dieses Beispiel entfernt Markdown-Formatierung aus Claudes Antworten für eine Klartext-Anzeige. Das Skript liest jeden Batch von stdin, entfernt fette Marker und Inline-Code-Backticks aus `delta` und gibt das Ergebnis als `displayContent` zurück.

1604 1594

1633 </Tab>1623 </Tab>

1634 1624

1635 <Tab title="Windows (PowerShell)">1625 <Tab title="Windows (PowerShell)">

1636 Registrieren Sie einen Command-Hook, der das Skript durch PowerShell ausführt:1626 Registrieren Sie einen Command-Hook, der das Skript über PowerShell ausführt:

1637 1627

1638 ```json theme={null}1628 ```json theme={null}

1639 {1629 {

1684 1674

1685Wird ausgeführt, nachdem Claude Tool-Parameter erstellt hat und bevor der Tool-Aufruf verarbeitet wird. Gleicht jeden Tool-Namen außer `EndConversation` ab: integrierte Tools wie `Bash`, `PowerShell`, `Edit`, `Write`, `Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion` und `ExitPlanMode` sowie alle [MCP-Tool-Namen](#match-mcp-tools).1675Wird ausgeführt, nachdem Claude Tool-Parameter erstellt hat und bevor der Tool-Aufruf verarbeitet wird. Gleicht jeden Tool-Namen außer `EndConversation` ab: integrierte Tools wie `Bash`, `PowerShell`, `Edit`, `Write`, `Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion` und `ExitPlanMode` sowie alle [MCP-Tool-Namen](#match-mcp-tools).

1686 1676

1687Um einen Hook auszuführen, wenn sich eine bestimmte Datei auf der Festplatte ändert, unabhängig davon, wer sie schreibt, verwenden Sie stattdessen [FileChanged](#filechanged). Im Gegensatz zu PreToolUse führt Claude Code FileChanged-Hooks nach der Änderung aus, und sie haben keine Entscheidungskontrolle, daher können sie den Schreibvorgang nicht blockieren.1677Um einen Hook auszuführen, wenn sich eine bestimmte Datei auf der Festplatte ändert, unabhängig davon, was sie geschrieben hat, verwenden Sie stattdessen [FileChanged](#filechanged). Im Gegensatz zu PreToolUse führt Claude Code FileChanged-Hooks nach der Änderung aus und sie haben keine Entscheidungskontrolle, daher können sie den Schreibvorgang nicht blockieren.

1688 1678

1689<Warning>1679<Warning>

1690 PreToolUse wird nur ausgeführt, wenn Claude ein Tool aufruft. Dateien, die Sie [mit `@` in Ihrer Eingabeaufforderung referenzieren](/docs/de/common-workflows#reference-files-and-directories), werden hinzugefügt, ohne dass ein Tool-Aufruf erfolgt: Claude Code fügt ihren Inhalt beim Erstellen der Eingabeaufforderung ein, daher wird kein PreToolUse-Hook für sie ausgeführt, einschließlich Hooks, die `Read` abgleichen. Um bestimmte Pfade von `@` Referenzen zu blockieren, verwenden Sie stattdessen eine [`Read` Ablehnungsregel](/docs/de/permissions#read-and-edit).1680 PreToolUse wird nur ausgeführt, wenn Claude ein Tool aufruft. Dateien, auf die Sie [mit `@` in Ihrer Eingabeaufforderung verweisen](/docs/de/common-workflows#reference-files-and-directories), werden hinzugefügt, ohne dass ein Tool-Aufruf erfolgt: Claude Code fügt ihren Inhalt beim Erstellen der Eingabeaufforderung ein, daher wird kein PreToolUse-Hook für sie ausgelöst, einschließlich Hooks, die `Read` abgleichen. Um bestimmte Pfade von `@` Verweisen zu blockieren, verwenden Sie stattdessen eine [`Read` Ablehnungsregel](/docs/de/permissions#read-and-edit).

1691 1681

1692 PreToolUse wird auch nicht für [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) ausgeführt.1682 PreToolUse wird auch nicht für [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) ausgelöst.

1693</Warning>1683</Warning>

1694 1684

1695Verwenden Sie [PreToolUse-Entscheidungskontrolle](#pretooluse-decision-control), um den Tool-Aufruf zu erlauben, zu verweigern, zu fragen oder aufzuschieben.1685Verwenden Sie [PreToolUse-Entscheidungskontrolle](#pretooluse-decision-control), um den Tool-Aufruf zuzulassen, zu verweigern, zu fragen oder aufzuschieben.

1696 1686

1697Ein [Agent SDK Callback-Hook](/docs/de/agent-sdk/hooks) auf `PreToolUse`, der sein Timeout überschreitet, blockiert den Tool-Aufruf, und Claude erhält ein Fehlerergebnis, das das Timeout benennt. Eine explizite Ablehnung, die von einem anderen Hook zurückgegeben wird, hat immer noch Vorrang.1687Ein [Agent SDK Callback-Hook](/docs/de/agent-sdk/hooks) auf `PreToolUse`, der sein Timeout überschreitet, blockiert den Tool-Aufruf und Claude erhält ein Fehlerergebnis, das das Timeout benennt. Eine explizite Ablehnung, die von einem anderen Hook zurückgegeben wird, hat immer noch Vorrang.

1698 1688

1699<h4 id="pretooluse-input">1689<h4 id="pretooluse-input">

1700 PreToolUse-Eingabe1690 PreToolUse-Eingabe

1708 1698

1709* Claude Code erweitert `~` und relative Pfade, bevor Hooks ausgeführt werden, daher kann ein Hook, der auf Pfaden abgleicht, nicht durch `~` oder eine relative Schreibweise des gleichen Pfads umgangen werden1699* Claude Code erweitert `~` und relative Pfade, bevor Hooks ausgeführt werden, daher kann ein Hook, der auf Pfaden abgleicht, nicht durch `~` oder eine relative Schreibweise des gleichen Pfads umgangen werden

1710* Unter Windows kommt der Pfad mit Backslash-Trennzeichen an, auch wenn Ihr Hook unter Git Bash läuft, wo `$PWD` wie `/c/project` aussieht1700* Unter Windows kommt der Pfad mit Backslash-Trennzeichen an, auch wenn Ihr Hook unter Git Bash läuft, wo `$PWD` wie `/c/project` aussieht

1711* Ein Vergleich mit Schrägstrichen, wie eine `/src/` Überprüfung, gleicht nie einen Backslash-Pfad ab, und der Tool-Aufruf wird fortgesetzt, als hätte der Hook nichts zu blockieren1701* Ein Vergleich mit Schrägstrichen, wie eine `/src/` Überprüfung, gleicht niemals einen Backslash-Pfad ab, und der Tool-Aufruf wird fortgesetzt, als hätte der Hook nichts zu blockieren

1712* Normalisieren Sie Trennzeichen vor dem Vergleich: `FILE_PATH="${FILE_PATH//\\//}"` in Bash oder `file_path.replace("\\", "/")` in Python, dann gleichen Sie ein Pfad-Segment wie `/src/` ab, anstatt mit `^` zu verankern, da der Pfad absolut ist1702* Normalisieren Sie Trennzeichen vor dem Vergleich: `FILE_PATH="${FILE_PATH//\\//}"` in Bash oder `file_path.replace("\\", "/")` in Python, dann gleichen Sie ein Pfad-Segment wie `/src/` ab, anstatt mit `^` zu verankern, da der Pfad absolut ist

1713 1703

1714Ein `Write` Aufruf unter Windows liefert:1704Ein `Write` Aufruf unter Windows liefert:

1744 1734

1745Wenn ein Bash-Befehl Dateien in einem Git-Repository ändert, kann Claude Code aufzeichnen, was sich geändert hat. Es zeichnet die Änderungen in jedem Berechtigungsmodus auf, wenn die [`bashEditDiffEnabled`](/docs/de/settings-reference#basheditdiffenabled) Einstellung die Aufzeichnung aktiviert; der Eintrag dieser Einstellung sagt, welche Dateien sie setzen können. Andernfalls zeichnet es sie nur im Auto-Modus und `bypassPermissions` Modus auf, und nur wenn Claude Code Claude anweist, Dateien durch Bash zu bearbeiten. Setzen Sie `bashEditDiffEnabled` auf `false`, um die Aufzeichnung auszuschalten. Hintergrund-Befehle und schreibgeschützte Befehle tragen keinen Diff.1735Wenn ein Bash-Befehl Dateien in einem Git-Repository ändert, kann Claude Code aufzeichnen, was sich geändert hat. Es zeichnet die Änderungen in jedem Berechtigungsmodus auf, wenn die [`bashEditDiffEnabled`](/docs/de/settings-reference#basheditdiffenabled) Einstellung die Aufzeichnung aktiviert; der Eintrag dieser Einstellung sagt, welche Dateien sie setzen können. Andernfalls zeichnet es sie nur im Auto-Modus und `bypassPermissions` Modus auf und nur, wenn Claude Code Claude anweist, Dateien über Bash zu bearbeiten. Setzen Sie `bashEditDiffEnabled` auf `false`, um die Aufzeichnung auszuschalten. Hintergrund-Befehle und schreibgeschützte Befehle tragen keinen Diff.

1746 1736

1747Ihr [PostToolUse-Hook](#posttooluse) empfängt dann die geänderten Dateien in `tool_response.bashEditDiff`. Die Liste deckt ab, was sich im Repository geändert hat, während der Befehl lief. Dateien, die Git ignoriert, und Dateien in Submodulen werden nicht aufgelistet. Erfordert Claude Code v2.1.269 oder später.1737Ihr [PostToolUse-Hook](#posttooluse) empfängt dann die geänderten Dateien in `tool_response.bashEditDiff`. Die Liste deckt ab, was sich im Repository geändert hat, während der Befehl lief. Dateien, die Git ignoriert, und Dateien in Submodulen werden nicht aufgelistet. Erfordert Claude Code v2.1.269 oder später.

1748 1738

1754 1744

1755| Feld | Typ | Beispiel | Beschreibung |1745| Feld | Typ | Beispiel | Beschreibung |

1756| :- | :- | :- | :- |1746| :- | :- | :- | :- |

1758| `files` | array | `[{"filePath": "/path/to/src/app.ts", "hunks": [...]}]` | Diffs von bis zu 5 geänderten Dateien zur Anzeige. `created` oder `deleted` ist `true` für eine Datei, die der Befehl hinzugefügt oder entfernt hat |1748| `files` | array | `[{"filePath": "/path/to/src/app.ts", "hunks": [...]}]` | Diffs von bis zu 5 geänderten Dateien zur Anzeige. `created` oder `deleted` ist `true` für eine Datei, die der Befehl hinzugefügt oder entfernt hat |

1762| `shared` | boolean | `true` | Gesetzt, wenn ein anderer Bash-Tool-Aufruf, wie der eines Subagenten, im gleichen Repository zur gleichen Zeit lief, daher können einige aufgelistete Änderungen von diesem Befehl sein |1752| `shared` | boolean | `true` | Gesetzt, wenn ein anderer Bash-Tool-Aufruf, wie ein Subagent, im gleichen Repository zur gleichen Zeit lief, daher können einige aufgelistete Änderungen von diesem Befehl sein |

1763 1753

1764<a id="powershell" />1754<a id="powershell" />

1765 1755

1767 PowerShell1757 PowerShell

1768</h5>1758</h5>

1769 1759

1770Führt PowerShell-Befehle aus. Siehe das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) für Verfügbarkeit nach Plattform.1760Führt PowerShell-Befehle aus. Siehe das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) für die Verfügbarkeit nach Plattform.

1771 1761

1772Die Felder entsprechen dem Bash-Tool, mit der Befehlszeichenkette in `command`:1762Die Felder entsprechen dem Bash-Tool, mit der Befehlszeichenkette in `command`:

1773 1763

1780 1770

1781Gleichen Sie `Bash|PowerShell` in Hooks ab, die Shell-Befehle überprüfen, damit sie beide Tools abdecken:1771Gleichen Sie `Bash|PowerShell` in Hooks ab, die Shell-Befehle überprüfen, damit sie beide Tools abdecken:

1782 1772

1783* Unter Windows, überall wo das PowerShell-Tool aktiviert ist, behandelt Claude PowerShell als die primäre Shell und leitet Shell-Befehle durch sie.1773* Unter Windows, überall dort, wo das PowerShell-Tool aktiviert ist, behandelt Claude PowerShell als die primäre Shell und leitet Shell-Befehle durch sie.

1784* Unter Windows ohne Git Bash ist das Tool automatisch aktiviert und Claude Code registriert das Bash-Tool überhaupt nicht.1774* Unter Windows ohne Git Bash ist das Tool automatisch aktiviert und Claude Code registriert das Bash-Tool überhaupt nicht.

1785* Ein Hook, der nur `Bash` abgleicht, wird dort nie ausgeführt.1775* Ein Hook, der nur `Bash` abgleicht, wird dort nie ausgelöst.

1786 1776

1787<h5 id="write">1777<h5 id="write">

1788 Write1778 Write

1828 1818

1829| Feld | Typ | Beispiel | Beschreibung |1819| Feld | Typ | Beispiel | Beschreibung |

1830| :- | :- | :- | :- |1820| :- | :- | :- | :- |

1831| `pattern` | string | `"**/*.ts"` | Glob-Muster zum Abgleichen von Dateien |1821| `pattern` | string | `"**/*.ts"` | Glob-Muster zum Abgleich von Dateien |

1833 1823

1834<h5 id="grep">1824<h5 id="grep">

1835 Grep1825 Grep

1866| Feld | Typ | Beispiel | Beschreibung |1856| Feld | Typ | Beispiel | Beschreibung |

1867| :- | :- | :- | :- |1857| :- | :- | :- | :- |

1871 1861

1872<h5 id="agent">1862<h5 id="agent">

1873 Agent1863 Agent

1874</h5>1864</h5>

1875 1865

1876Spawnt einen [Subagenten](/docs/de/sub-agents).1866Erzeugt einen [Subagent](/docs/de/sub-agents).

1877 1867

1878| Feld | Typ | Beispiel | Beschreibung |1868| Feld | Typ | Beispiel | Beschreibung |

1879| :- | :- | :- | :- |1869| :- | :- | :- | :- |

1884 1874

1885Wenn ein Vordergrund-Agent-Aufruf abgeschlossen ist, empfängt Ihr [PostToolUse-Hook](#posttooluse) das Ergebnis des Subagenten und die Telemetrie des Laufs in `tool_response`. Lesen Sie diese Felder, um den Lauf zu überprüfen; für Token- und Kosten-Rollups über Subagenten verwenden Sie die [Token- und Kosten-Zähler](/docs/de/monitoring-usage#token-counter), gefiltert nach `query_source` `"subagent"`, da `totalTokens` und `usage` nur die letzte Anfrage abdecken:1875Wenn ein Vordergrund-Agent-Aufruf abgeschlossen ist, empfängt Ihr [PostToolUse-Hook](#posttooluse) das Ergebnis des Subagenten und die Telemetrie des Laufs in `tool_response`. Lesen Sie diese Felder, um den Lauf zu überprüfen; für Token- und Kosten-Rollups über Subagenten verwenden Sie die [Token- und Kosten-Zähler](/docs/de/monitoring-usage#token-counter), gefiltert nach `query_source` `"subagent"`, da `totalTokens` und `usage` nur die letzte Anfrage abdecken:

1886 1876

1887| Feld | Typ | Beispiel | Beschreibung |1877| Feld | Typ | Beispiel | Beschreibung |

1888| :- | :- | :- | :- |1878| :- | :- | :- | :- |

1889| `status` | string | `"completed"` | `"completed"` für Vordergrund-Subagenten, `"async_launched"` für Hintergrund-Subagenten. Ab v2.1.198 laufen Subagenten standardmäßig im Hintergrund, daher erzeugt ein weggelassenes `run_in_background` auch `"async_launched"` |1879| `status` | string | `"completed"` | `"completed"` für Vordergrund-Subagenten, `"async_launched"` für Hintergrund-Subagenten. Ab v2.1.198 laufen Subagenten standardmäßig im Hintergrund, daher erzeugt ein weggelassenes `run_in_background` auch `"async_launched"` |

1891| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Die finalen Textblöcke des Subagenten oder, für einen Subagenten, dessen Bericht durch `SubagentHandback` geht, eine kurze Notiz über diesen Handback an ihrer Stelle |1881| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Die finalen Textblöcke des Subagenten oder, für einen Subagenten, dessen Bericht durch `SubagentHandback` geht, eine kurze Notiz über diesen Handback an ihrer Stelle |

1893| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Verwendete Modelle in Reihenfolge, mit aufeinanderfolgenden Wiederholungen zusammengefasst; nur gesetzt, wenn das Modell während des Laufs gewechselt wurde. Erfordert Claude Code v2.1.212 oder später |1883| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Verwendete Modelle in Reihenfolge, mit aufeinanderfolgenden Wiederholungen zusammengefasst; nur gesetzt, wenn das Modell während des Laufs gewechselt wurde. Erfordert Claude Code v2.1.212 oder später |

1897| `usage` | object | `{"input_tokens": 8320, ...}` | Pro-Typ Token-Aufschlüsselung der letzten API-Anfrage: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |1887| `usage` | object | `{"input_tokens": 8320, ...}` | Pro-Typ Token-Aufschlüsselung der letzten API-Anfrage: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |

1898 1888

1899Auf Claude Code v2.1.271 oder später liefert ein Subagent, der mit dem [`SubagentHandback`](/docs/de/tools-reference) Tool läuft, das Claude Code im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) bereitstellt, seinen Bericht durch dieses Tool statt ihn als Text zurückzugeben. Das `content` Feld seines `completed` Ergebnisses trägt dann eine kurze Notiz über diesen Handback statt des Berichts selbst. Um den Bericht zu lesen, gleichen Sie einen `PreToolUse` oder `PostToolUse` Hook auf `SubagentHandback` ab und lesen Sie `tool_input.message`.1889Auf Claude Code v2.1.271 oder später liefert ein Subagent, der mit dem [`SubagentHandback`](/docs/de/tools-reference) Tool läuft, das Claude Code im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) bereitstellt, seinen Bericht über dieses Tool statt ihn als Text zurückzugeben. Das `content` Feld seines `completed` Ergebnisses trägt dann eine kurze Notiz über diesen Handback statt des Berichts selbst. Um den Bericht zu lesen, gleichen Sie einen `PreToolUse` oder `PostToolUse` Hook auf `SubagentHandback` ab und lesen Sie `tool_input.message`.

1900 1890

1901Für Hintergrund-Subagenten gibt das Tool zurück, wenn die Aufgabe in den Hintergrund geht, daher trägt `tool_response` keine Nutzungsfelder: Ein Hintergrund-Start gibt sofort zurück, und eine Vordergrund-Aufgabe, die Claude Code während des Laufs in den Hintergrund verschiebt, gibt bei diesem Übergang zurück. Es hat `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` und `resolvedModel`.1891Für Hintergrund-Subagenten kehrt das Tool zurück, wenn die Aufgabe in den Hintergrund geht, daher trägt `tool_response` keine Nutzungsfelder: Ein Hintergrund-Start kehrt sofort zurück und eine Vordergrund-Aufgabe, die Claude Code während des Laufs in den Hintergrund verschiebt, kehrt bei diesem Übergang zurück. Es hat `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` und `resolvedModel`.

1902 1892

1903Bei einem `completed` Ergebnis benennt `resolvedModel` das Modell, auf dem der Subagent gestartet wurde, das sich vom `model` Wert in `tool_input` unterscheiden kann, wie wenn `availableModels` oder ein anderer Override gilt. Bei einem `async_launched` Ergebnis benennt `resolvedModel` das Modell in Gebrauch, wenn der Agent in den Hintergrund ging, daher wird ein Wechsel, der vor dem Hintergrund-Gehen stattfand, dort widergespiegelt. `modelsUsed` und das Hintergrund-Zeit-`resolvedModel` Verhalten erfordern Claude Code v2.1.212 oder später.1893Bei einem `completed` Ergebnis benennt `resolvedModel` das Modell, auf dem der Subagent gestartet wurde, das sich vom `model` Wert in `tool_input` unterscheiden kann, wie wenn `availableModels` oder eine andere Überschreibung gilt. Bei einem `async_launched` Ergebnis benennt `resolvedModel` das Modell in Verwendung, wenn der Agent in den Hintergrund geht, daher wird ein Wechsel, der vor dem Backgrounding stattfand, dort widergespiegelt. `modelsUsed` und das Backgrounding-Zeit-`resolvedModel` Verhalten erfordern Claude Code v2.1.212 oder später.

1904 1894

1905<a id="askuserquestion" />1895<a id="askuserquestion" />

1906 1896

1912 1902

1913| Feld | Typ | Beispiel | Beschreibung |1903| Feld | Typ | Beispiel | Beschreibung |

1914| :- | :- | :- | :- |1904| :- | :- | :- | :- |

1915| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Zu stellende Fragen, jeweils mit einer `question` Zeichenkette, kurzem `header`, `options` Array und optionalem `multiSelect` Flag |1905| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Zu präsentierende Fragen, jeweils mit einer `question` Zeichenkette, kurzem `header`, `options` Array und optionalem `multiSelect` Flag |

1916| `answers` | object | `{"Which framework?": "React"}` | Optional. Ordnet Fragentext der ausgewählten Optionsbeschriftung zu. Multi-Select-Antworten verbinden Beschriftungen mit Kommas. Claude setzt dieses Feld nicht; liefern Sie es über `updatedInput`, um programmatisch zu antworten |1906| `answers` | object | `{"Which framework?": "React"}` | Optional. Ordnet Fragetext der ausgewählten Optionsbeschriftung zu. Multi-Select-Antworten verbinden Beschriftungen mit Kommas. Claude setzt dieses Feld nicht; liefern Sie es über `updatedInput`, um programmatisch zu antworten |

1917 1907

1918<h5 id="exitplanmode">1908<h5 id="exitplanmode">

1919 ExitPlanMode1909 ExitPlanMode

1925| :- | :- | :- | :- |1915| :- | :- | :- | :- |

1928| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Veraltet. Claude Code akzeptiert das Feld, ignoriert es aber. Vor v2.1.205 trug es eingabeaufforderungsbasierte Berechtigungen, die Claude anforderte, um den Plan zu implementieren |1918| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Veraltet. Claude Code akzeptiert das Feld, ignoriert es aber. Vor v2.1.205 trug es prompt-basierte Berechtigungen, die Claude anforderte, um den Plan zu implementieren |

1929 1919

1930In `PostToolUse` ist `tool_response` ein Objekt mit `plan` und `filePath` Feldern, die den genehmigten Plan enthalten, plus interne Status-Flags. Lesen Sie `tool_response.plan` für den Plan-Inhalt, anstatt die Datei von der Festplatte erneut zu lesen.1920In `PostToolUse` ist `tool_response` ein Objekt mit `plan` und `filePath` Feldern, die den genehmigten Plan enthalten, plus interne Status-Flags. Lesen Sie `tool_response.plan` für den Plan-Inhalt, anstatt die Datei von der Festplatte erneut zu lesen.

1931 1921

1933 PreToolUse-Entscheidungskontrolle1923 PreToolUse-Entscheidungskontrolle

1934</h4>1924</h4>

1935 1925

1936`PreToolUse` Hooks können steuern, ob ein Tool-Aufruf fortgesetzt wird. Im Gegensatz zu anderen Hooks, die ein Top-Level-`decision` Feld verwenden, gibt PreToolUse seine Entscheidung in einem `hookSpecificOutput` Objekt zurück. Dies gibt ihm reichere Kontrolle: vier Ergebnisse (erlauben, verweigern, fragen oder aufschieben) plus die Möglichkeit, Tool-Eingabe vor der Ausführung zu ändern.1926`PreToolUse` Hooks können steuern, ob ein Tool-Aufruf fortgesetzt wird. Im Gegensatz zu anderen Hooks, die ein Top-Level-`decision` Feld verwenden, gibt PreToolUse seine Entscheidung in einem `hookSpecificOutput` Objekt zurück. Dies gibt ihm reichere Kontrolle: vier Ergebnisse (zulassen, verweigern, fragen oder aufschieben) plus die Möglichkeit, Tool-Eingabe vor der Ausführung zu ändern.

1937 1927

1938| Feld | Beschreibung |1928| Feld | Beschreibung |

1939| :- | :- |1929| :- | :- |

1940| `permissionDecision` | `"allow"` überspringt die Berechtigungsaufforderung, außer für die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves) und für `AskUserQuestion` und `ExitPlanMode`, die [`updatedInput` gepaart damit benötigen](#allow-with-updatedinput). `"deny"` verhindert den Tool-Aufruf. `"ask"` fordert den Benutzer zur Bestätigung auf. `"defer"` beendet sich elegant, damit das Tool später fortgesetzt werden kann. [Ablehnungs- und Frageregel](/docs/de/permissions#manage-permissions) werden immer noch ausgewertet, unabhängig davon, was der Hook zurückgibt |1930| `permissionDecision` | `"allow"` überspringt die Berechtigungsaufforderung, außer für die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves) und für `AskUserQuestion` und `ExitPlanMode`, die [`updatedInput` gepaart damit benötigen](#allow-with-updatedinput). `"deny"` verhindert den Tool-Aufruf. `"ask"` fordert den Benutzer zur Bestätigung auf. `"defer"` beendet sich elegant, damit das Tool später fortgesetzt werden kann. [Ablehnungs- und Frage-Regeln](/docs/de/permissions#manage-permissions) werden immer noch ausgewertet, unabhängig davon, was der Hook zurückgibt |

1941| `permissionDecisionReason` | Für `"allow"` und `"ask"`, dem Benutzer angezeigt, aber nicht Claude. Für `"deny"`, Claude angezeigt. Für `"defer"`, ignoriert |1931| `permissionDecisionReason` | Für `"ask"`, dem Benutzer angezeigt, aber nicht Claude. Für `"deny"`, Claude angezeigt. Für `"allow"` und `"defer"`, nur ins [Debug-Protokoll](#debug-hooks) geschrieben |

1942| `updatedInput` | Ändert die Tool-Eingabeparameter vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, daher schließen Sie unveränderte Felder neben geänderten ein. Claude Code wertet Berechtigungsregeln und die [Auto-Background-Berechtigung](/docs/de/tools-reference#background-commands) eines Bash-Befehls gegen die Eingabe aus, die Ihr Hook zurückgibt, nicht die Eingabe, die Claude gesendet hat. Kombinieren Sie mit `"allow"`, um automatisch zu genehmigen, oder mit `"ask"`, um die geänderte Eingabe dem Benutzer zu zeigen. Für `"defer"`, ignoriert |1932| `updatedInput` | Ändert die Tool-Eingabeparameter vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, daher schließen Sie unveränderte Felder neben geänderten ein. Claude Code wertet Berechtigungsregeln und die [Auto-Background-Berechtigung](/docs/de/tools-reference#background-commands) eines Bash-Befehls gegen die Eingabe aus, die Ihr Hook zurückgibt, nicht die Eingabe, die Claude gesendet hat. Kombinieren Sie mit `"allow"`, um automatisch zu genehmigen, oder `"ask"`, um die geänderte Eingabe dem Benutzer zu zeigen. Für `"defer"`, ignoriert |

1943| `additionalContext` | String, der zu Claudes Kontext neben dem Tool-Ergebnis hinzugefügt wird. Ignoriert, wenn `permissionDecision` `"defer"` ist. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |1933| `additionalContext` | String, der zu Claudes Kontext neben dem Tool-Ergebnis hinzugefügt wird. Ignoriert, wenn `permissionDecision` `"defer"` ist. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |

1944 1934

1945Wenn mehrere PreToolUse-Hooks unterschiedliche Entscheidungen zurückgeben, ist die Priorität `deny` > `defer` > `ask` > `allow`.1935Wenn mehrere PreToolUse-Hooks unterschiedliche Entscheidungen zurückgeben, ist die Priorität `deny` > `defer` > `ask` > `allow`.

1946 1936

1947Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `"deny"` weitergeleitet: Claude sieht die stderr-Nachricht als Ablehnungsgrund.1937Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `"deny"` weitergeleitet: Claude sieht die stderr-Nachricht als Ablehnungsgrund.

1948 1938

1949Wenn ein Hook `"ask"` zurückgibt, enthält die dem Benutzer angezeigte Berechtigungsaufforderung ein Label, das angibt, woher der Hook stammt: `[settings]` für einen Hook aus einer beliebigen Einstellungsdatei oder aus Agent-Frontmatter, `[plugin:<name>]` für einen Hook eines Plugins oder `[skill]` für einen Hook aus Skill-Frontmatter. Dies hilft Benutzern zu verstehen, welche Konfigurationsquelle eine Bestätigung anfordert.1939Wenn ein Hook `"ask"` zurückgibt, enthält die dem Benutzer angezeigte Berechtigungsaufforderung ein Label, das angibt, woher der Hook stammt: `[settings]` für einen Hook aus einer beliebigen Einstellungsdatei oder Agent-Frontmatter, `[plugin:<name>]` für einen Plugin-Hook oder `[skill]` für einen Hook aus Skill-Frontmatter. Dies hilft Benutzern zu verstehen, welche Konfigurationsquelle Bestätigung anfordert.

1950 1940

1951Ein Hook-`"ask"` erzwingt auch eine Berechtigungsaufforderung im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): Der Klassifizierer kann den Tool-Aufruf immer noch verweigern, aber er kann den Aufruf nicht stillschweigend genehmigen. Vor v2.1.211 konnte der Klassifizierer einen Bash-Befehl, der außerhalb der [Sandbox](/docs/de/sandboxing) läuft, ohne die Aufforderung zu zeigen, die der Hook anforderte, genehmigen; der Klassifizierer wendete immer noch seine eigenen Sicherheitsregeln auf diesen Befehl an, und ein Hook `"deny"` wurde immer berücksichtigt.1941Ein Hook-`"ask"` erzwingt auch eine Berechtigungsaufforderung im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): Der Klassifizierer kann den Tool-Aufruf immer noch verweigern, kann ihn aber nicht stillschweigend genehmigen. Vor v2.1.211 konnte der Klassifizierer einen Bash-Befehl, der außerhalb der [Sandbox](/docs/de/sandboxing) läuft, ohne die Aufforderung zu zeigen, die der Hook anforderte, genehmigen; der Klassifizierer wendete immer noch seine eigenen Sicherheitsregeln auf diesen Befehl an, und ein Hook `"deny"` wurde immer berücksichtigt.

1952 1942

1953```json theme={null}1943```json theme={null}

1954{1944{

1966 1956

1967<span id="allow-with-updatedinput" />1957<span id="allow-with-updatedinput" />

1968 1958

1969Im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p` Flag bietet Claude Code `AskUserQuestion` und `ExitPlanMode` nur an, wenn der Lauf einen [Berechtigungshost](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs) hat, um die Aufforderung zu empfangen, wie einen Agent SDK `canUseTool` Callback. Diese Tools erfordern Benutzerinteraktion. Das Zurückgeben von `permissionDecision: "allow"` zusammen mit `updatedInput` erfüllt diese Anforderung: Der Hook liest die Tool-Eingabe von stdin, sammelt die Antwort über Ihre eigene Benutzeroberfläche und gibt sie in `updatedInput` zurück, damit das Tool ohne Aufforderung ausgeführt wird. Das Zurückgeben von `"allow"` allein ist nicht ausreichend für diese Tools. Für `AskUserQuestion` geben Sie das ursprüngliche `questions` Array zurück und fügen ein [`answers`](#askuserquestion) Objekt hinzu, das jede Frage des Textes der gewählten Antwort zuordnet.1959Im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p` Flag bietet Claude Code `AskUserQuestion` und `ExitPlanMode` nur an, wenn der Lauf einen [Berechtigungshost](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs) hat, um die Aufforderung zu empfangen, wie einen Agent SDK `canUseTool` Callback. Diese Tools erfordern Benutzerinteraktion. Das Zurückgeben von `permissionDecision: "allow"` zusammen mit `updatedInput` erfüllt diese Anforderung: Der Hook liest die Tool-Eingabe von stdin, sammelt die Antwort über Ihre eigene UI und gibt sie in `updatedInput` zurück, damit das Tool ohne Aufforderung läuft. Das Zurückgeben von `"allow"` allein ist nicht ausreichend für diese Tools. Für `AskUserQuestion` geben Sie das ursprüngliche `questions` Array zurück und fügen Sie ein [`answers`](#askuserquestion) Objekt hinzu, das jede Frage auf die gewählte Antwort abbildet.

1970 1960

1971Ab v2.1.199 ist ein MCP-Tool, dessen Server es mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) markiert, strenger: Ein Hook kann seine Genehmigungsaufforderung nicht mit `"allow"` überspringen, mit oder ohne `updatedInput`, da Claude Code nicht bestätigen kann, dass der Hook die Interaktion sammelte, die das Tool benötigt.1961Ab v2.1.199 ist ein MCP-Tool, dessen Server es mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) markiert, strenger: Ein Hook kann seine Genehmigungsaufforderung nicht mit `"allow"` überspringen, mit oder ohne `updatedInput`, da Claude Code nicht bestätigen kann, dass der Hook die Interaktion sammelte, die das Tool benötigt.

1972 1962

1973<Note>1963<Note>

1974 PreToolUse verwendete zuvor Top-Level-`decision` und `reason` Felder, aber diese sind für dieses Ereignis veraltet. Verwenden Sie stattdessen `hookSpecificOutput.permissionDecision` und `hookSpecificOutput.permissionDecisionReason`. Die veralteten Werte `"approve"` und `"block"` ordnen sich `"allow"` und `"deny"` zu. Andere Ereignisse wie PostToolUse und Stop verwenden weiterhin Top-Level-`decision` und `reason` als ihr aktuelles Format.1964 PreToolUse verwendete zuvor Top-Level-`decision` und `reason` Felder, aber diese sind für dieses Ereignis veraltet. Verwenden Sie stattdessen `hookSpecificOutput.permissionDecision` und `hookSpecificOutput.permissionDecisionReason`. Die veralteten Werte `"approve"` und `"block"` werden auf `"allow"` und `"deny"` abgebildet. Andere Ereignisse wie PostToolUse und Stop verwenden weiterhin Top-Level-`decision` und `reason` als ihr aktuelles Format.

1975</Note>1965</Note>

1976 1966

1977<h4 id="defer-a-tool-call-for-later">1967<h4 id="defer-a-tool-call-for-later">

1978 Einen Tool-Aufruf für später aufschieben1968 Tool-Aufruf für später aufschieben

1979</h4>1969</h4>

1980 1970

1981`"defer"` ist für Integrationen, die `claude -p` als Unterprozess ausführen und seine JSON-Ausgabe lesen, wie eine Agent SDK App oder eine benutzerdefinierte Benutzeroberfläche, die auf Claude Code aufgebaut ist. Es ermöglicht diesem aufrufenden Prozess, Claude bei einem Tool-Aufruf zu pausieren, Eingabe über seine eigene Schnittstelle zu sammeln und dort fortzufahren, wo er aufgehört hat. Claude Code berücksichtigt diesen Wert nur im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p` Flag. In interaktiven Sitzungen protokolliert es eine Warnung und ignoriert das Hook-Ergebnis.1971`"defer"` ist für Integrationen, die `claude -p` als Unterprozess ausführen und seine JSON-Ausgabe lesen, wie eine Agent SDK App oder eine benutzerdefinierte UI auf Basis von Claude Code. Es ermöglicht diesem aufrufenden Prozess, Claude bei einem Tool-Aufruf zu pausieren, Eingabe über seine eigene Schnittstelle zu sammeln und dort fortzufahren, wo er aufgehört hat. Claude Code berücksichtigt diesen Wert nur im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p` Flag. In interaktiven Sitzungen protokolliert es eine Warnung und ignoriert das Hook-Ergebnis.

1982 1972

1983Das `AskUserQuestion` Tool ist der typische Fall: Claude möchte den Benutzer etwas fragen, aber es gibt kein Terminal zum Antworten. Ein `-p` Lauf bietet `AskUserQuestion` nur an, wenn er einen [Berechtigungshost](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs) hat, wie ein MCP-Tool, das Sie mit `--permission-prompt-tool` übergeben, daher starten Sie den Lauf mit einem. Der Roundtrip funktioniert so:1973Das `AskUserQuestion` Tool ist der typische Fall: Claude möchte den Benutzer etwas fragen, aber es gibt kein Terminal zum Antworten. Ein `-p` Lauf bietet `AskUserQuestion` nur an, wenn er einen [Berechtigungshost](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs) hat, wie ein MCP-Tool, das Sie mit `--permission-prompt-tool` übergeben, daher starten Sie den Lauf mit einem. Der Roundtrip funktioniert so:

1984 1974

19851. Claude ruft `AskUserQuestion` auf. Der `PreToolUse` Hook wird ausgeführt.19751. Claude ruft `AskUserQuestion` auf. Der `PreToolUse` Hook wird ausgelöst.

19862. Der Hook gibt `permissionDecision: "defer"` zurück. Das Tool wird nicht ausgeführt. Der Prozess beendet sich mit `stop_reason: "tool_deferred"` und dem ausstehenden Tool-Aufruf, der im Transkript erhalten bleibt.19762. Der Hook gibt `permissionDecision: "defer"` zurück. Das Tool wird nicht ausgeführt. Der Prozess beendet sich mit `stop_reason: "tool_deferred"` und dem ausstehenden Tool-Aufruf, der im Transkript erhalten bleibt.

19873. Der aufrufende Prozess liest `deferred_tool_use` aus dem SDK-Ergebnis, zeigt die Frage in seiner eigenen Benutzeroberfläche an und wartet auf eine Antwort.19773. Der aufrufende Prozess liest `deferred_tool_use` aus dem SDK-Ergebnis, zeigt die Frage in seiner eigenen UI an und wartet auf eine Antwort.

19884. Der aufrufende Prozess führt `claude -p --resume <session-id>` mit dem gleichen Berechtigungshost aus. Der gleiche Tool-Aufruf wird `PreToolUse` erneut ausgeführt.19784. Der aufrufende Prozess führt `claude -p --resume <session-id>` mit dem gleichen Berechtigungshost aus. Der gleiche Tool-Aufruf löst `PreToolUse` erneut aus.

19895. Der Hook gibt `permissionDecision: "allow"` mit der Antwort in `updatedInput` zurück. Das Tool wird ausgeführt und Claude setzt fort.19795. Der Hook gibt `permissionDecision: "allow"` mit der Antwort in `updatedInput` zurück. Das Tool wird ausgeführt und Claude setzt fort.

1990 1980

1991Das `deferred_tool_use` Feld trägt die `id`, `name` und `input` des Tools. Die `input` sind die Parameter, die Claude für den Tool-Aufruf generiert hat, erfasst vor der Ausführung:1981Das `deferred_tool_use` Feld trägt die `id`, `name` und `input` des Tools. Die `input` sind die Parameter, die Claude für den Tool-Aufruf generiert hat, erfasst vor der Ausführung:

2004}1994}

2005```1995```

2006 1996

2007Es gibt kein Timeout oder Wiederholungslimit. Die Sitzung bleibt auf der Festplatte, bis Sie sie fortsetzen, unterliegt aber der [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays) Aufbewahrungssweep, die Sitzungsdateien nach 30 Tagen standardmäßig löscht, nach den [Aufbewahrungssweep-Regeln](/docs/de/claude-directory#cleaned-up-automatically). Wenn die Antwort nicht bereit ist, wenn Sie fortsetzen, kann der Hook `"defer"` erneut zurückgeben und der Prozess beendet sich auf die gleiche Weise. Der aufrufende Prozess steuert, wann die Schleife unterbrochen wird, indem er schließlich `"allow"` oder `"deny"` vom Hook zurückgibt.1997Es gibt kein Timeout oder Wiederholungslimit. Die Sitzung bleibt auf der Festplatte, bis Sie sie fortsetzen, unterliegt aber den [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays) Aufräumregeln, die Sitzungsdateien nach 30 Tagen standardmäßig löschen, nach den [Aufräumregeln](/docs/de/claude-directory#cleaned-up-automatically). Wenn die Antwort nicht bereit ist, wenn Sie fortsetzen, kann der Hook erneut `"defer"` zurückgeben und der Prozess beendet sich auf die gleiche Weise. Der aufrufende Prozess steuert, wann die Schleife unterbrochen wird, indem er schließlich `"allow"` oder `"deny"` vom Hook zurückgibt.

2008 1998

2009`"defer"` funktioniert nur, wenn Claude einen einzelnen Tool-Aufruf im Zug macht. Wenn Claude mehrere Tool-Aufrufe gleichzeitig macht, wird `"defer"` mit einer Warnung ignoriert und das Tool wird durch den normalen Berechtigungsfluss fortgesetzt. Die Einschränkung existiert, weil Resume nur ein Tool erneut ausführen kann: Es gibt keine Möglichkeit, einen Aufruf aus einem Batch aufzuschieben, ohne die anderen ungelöst zu lassen.1999`"defer"` funktioniert nur, wenn Claude einen einzelnen Tool-Aufruf im Zug macht. Wenn Claude mehrere Tool-Aufrufe gleichzeitig macht, wird `"defer"` mit einer Warnung ignoriert und das Tool geht durch den normalen Berechtigungsfluss. Die Einschränkung existiert, weil Resume nur ein Tool erneut ausführen kann: Es gibt keine Möglichkeit, einen Aufruf aus einem Batch aufzuschieben, ohne die anderen ungelöst zu lassen.

2010 2000

2011Wenn das aufgeschobene Tool nicht mehr verfügbar ist, wenn Sie fortsetzen, beendet sich der Prozess mit `stop_reason: "tool_deferred_unavailable"` und `is_error: true` bevor der Hook ausgeführt wird. Dies geschieht, wenn ein MCP-Server, der das Tool bereitgestellt hat, für die fortgesetzte Sitzung nicht verbunden ist. Die `deferred_tool_use` Nutzlast ist immer noch enthalten, damit Sie identifizieren können, welches Tool fehlte.2001Wenn das aufgeschobene Tool nicht mehr verfügbar ist, wenn Sie fortsetzen, beendet sich der Prozess mit `stop_reason: "tool_deferred_unavailable"` und `is_error: true` bevor der Hook ausgelöst wird. Dies geschieht, wenn ein MCP-Server, der das Tool bereitgestellt hat, für die fortgesetzte Sitzung nicht verbunden ist. Die `deferred_tool_use` Nutzlast ist immer noch enthalten, damit Sie identifizieren können, welches Tool fehlte.

2012 2002

2013<Note>2003<Note>

2014 Um eine aufgeschobene Sitzung im Plan-Modus fortzusetzen, übergeben Sie [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) zusammen mit `--resume`, damit Claude Code den Plan zur Genehmigung präsentieren kann. Ohne es stellt Claude Code den Plan-Modus nicht wieder her. Erfordert Claude Code v2.1.246 oder später.2004 Um eine aufgeschobene Sitzung im Plan-Modus fortzusetzen, übergeben Sie [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) zusammen mit `--resume`, damit Claude Code den Plan zur Genehmigung präsentieren kann. Wenn Sie bestimmte andere Start-Flags übergeben, kehrt der fortgesetzte Lauf nicht zum Plan-Modus zurück; siehe [Im Plan-Modus mit `-p` fortsetzen](/docs/de/sessions#resume-in-plan-mode-with-p). Erfordert Claude Code v2.1.246 oder später.

2015 2005

2016 Wenn Sie mit `-p` fortsetzen, stellt Claude Code keinen anderen gespeicherten Berechtigungsmodus wieder her. Es startet den Lauf im Berechtigungsmodus, den ein neuer `claude -p` Lauf starten würde, daher übergeben Sie `--permission-mode` oder `--dangerously-skip-permissions` erneut, wenn die aufgeschobene Sitzung einen verwendet hat. Wenn Sie mit `claude --resume <session-id>` ohne `-p` fortsetzen, stellt Claude Code den gespeicherten Berechtigungsmodus wieder her, mit den Ausnahmen, die in [Berechtigungsmodus bei Fortsetzen](/docs/de/sessions#permission-mode-on-resume) aufgelistet sind.2006 Wenn Sie mit `-p` fortsetzen, stellt Claude Code keinen anderen gespeicherten Berechtigungsmodus wieder her. Es startet den Lauf im Berechtigungsmodus, den ein neuer `claude -p` Lauf starten würde, daher übergeben Sie `--permission-mode` oder `--dangerously-skip-permissions` erneut, wenn die aufgeschobene Sitzung einen verwendet hat. Wenn Sie mit `claude --resume <session-id>` ohne `-p` fortsetzen, stellt Claude Code den gespeicherten Berechtigungsmodus wieder her, mit den Ausnahmen, die in [Berechtigungsmodus beim Fortsetzen](/docs/de/sessions#permission-mode-on-resume) aufgelistet sind.

2017</Note>2007</Note>

2018 2008

2019<h3 id="permissionrequest">2009<h3 id="permissionrequest">

2020 PermissionRequest2010 PermissionRequest

2021</h3>2011</h3>

2022 2012

2023Wird ausgeführt, wenn Claude Code Sie um Erlaubnis bitten möchte, ein Tool zu verwenden. In Sitzungen, die keine Aufforderung anzeigen können, wie Hintergrund-Subagenten im [nicht-interaktiven Modus](/docs/de/headless), führt Claude Code diese Hooks immer noch aus, und wenn kein Hook eine Entscheidung zurückgibt, verweigert es den Tool-Aufruf.2013Wird ausgeführt, wenn Claude Code Sie um Erlaubnis zur Verwendung eines Tools bitten wird. In Sitzungen, die keine Aufforderung anzeigen können, wie Hintergrund-Subagenten im [nicht-interaktiven Modus](/docs/de/headless), führt Claude Code diese Hooks immer noch aus, und wenn kein Hook eine Entscheidung zurückgibt, verweigert es den Tool-Aufruf.

2024Verwenden Sie [PermissionRequest-Entscheidungskontrolle](#permissionrequest-decision-control), um im Namen des Benutzers zu erlauben oder zu verweigern.2014Verwenden Sie [PermissionRequest-Entscheidungskontrolle](#permissionrequest-decision-control), um im Namen des Benutzers zuzulassen oder zu verweigern.

2025 2015

2026Verwenden Sie dieses Ereignis, wenn Sie ein Signal benötigen, in dem Moment, in dem Claude um Erlaubnis bittet, ein Tool zu verwenden. Claude Code führt einen [Notification](#notification) Hook mit dem `permission_prompt` Typ nur aus, nachdem die Aufforderung etwa sechs Sekunden gewartet hat.2016Verwenden Sie dieses Ereignis, wenn Sie ein Signal benötigen, in dem Moment, in dem Claude um Erlaubnis zur Verwendung eines Tools bittet. Claude Code führt einen [Notification](#notification) Hook mit dem `permission_prompt` Typ nur aus, nachdem die Aufforderung etwa sechs Sekunden gewartet hat.

2027 2017

2028Claude Code führt PermissionRequest-Hooks nicht für eine Sandbox-Anfrage eines Befehls aus [Netzwerkanfrage](/docs/de/sandboxing#network-isolation). Um ein Signal für diese Aufforderung zu erhalten, verwenden Sie den `permission_prompt` Benachrichtigungstyp.2018Claude Code führt PermissionRequest-Hooks nicht für eine Sandbox-Anfrage einer [Netzwerkanfrage](/docs/de/sandboxing#network-isolation) aus. Um ein Signal für diese Aufforderung zu erhalten, verwenden Sie den `permission_prompt` Benachrichtigungstyp.

2029 2019

2030Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.2020Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.

2031 2021

2033 PermissionRequest-Eingabe2023 PermissionRequest-Eingabe

2034</h4>2024</h4>

2035 2025

2036PermissionRequest-Hooks erhalten `tool_name` und `tool_input` Felder wie PreToolUse-Hooks, aber ohne `tool_use_id`. Für ein MCP-Tool erhalten sie auch das [`mcp_server`](#pretooluse-input) Objekt. Ein optionales `permission_suggestions` Array enthält die [Berechtigungsaktualisierungen](#permission-update-entries), die Claude Code für diese Anfrage vorschlägt, wie das Hinzufügen einer Erlaubnisregel oder das Ändern des Berechtigungsmodus.2026PermissionRequest-Hooks erhalten `tool_name` und `tool_input` Felder wie PreToolUse-Hooks, aber ohne `tool_use_id`. Für ein MCP-Tool erhalten sie auch das [`mcp_server`](#pretooluse-input) Objekt. Ein optionales `permission_suggestions` Array enthält die [Berechtigungsaktualisierungen](#permission-update-entries), die Claude Code für diese Anfrage vorschlägt, wie das Hinzufügen einer Zulassungsregel oder das Ändern des Berechtigungsmodus.

2037 2027

2038Das `permission_suggestions` Array ist keine genaue Liste der Optionen, die Sie sehen, da jeder Berechtigungsdialog seine eigenen Optionen erstellt. Einige Dialoge, wie der für Dateibearbeitungen, lesen das Array überhaupt nicht und leiten ihre Optionen aus der Anfrage selbst ab. Ein Dialog, der es liest, kann immer noch eine Option zurückhalten, deren Vorschlag im Array bleibt, z. B. wenn [`allowManagedPermissionRulesOnly`](/docs/de/settings-reference#allowmanagedpermissionrulesonly) Regel-Speicheroptionen verbirgt. Es kann auch Optionen anbieten, die keinen Vorschlagseintrag haben, wie [**Ja, und zum Auto-Modus wechseln**](/docs/de/permission-modes#switch-permission-modes), das den Berechtigungsmodus direkt ändert, anstatt durch eine Berechtigungsaktualisierung.2028Das `permission_suggestions` Array ist keine genaue Liste der Optionen, die Sie sehen, da jeder Berechtigungsdialog seine eigenen Optionen erstellt. Einige Dialoge, wie der für Dateibearbeitungen, lesen das Array überhaupt nicht und leiten ihre Optionen aus der Anfrage selbst ab. Ein Dialog, der es liest, kann immer noch eine Option zurückhalten, deren Vorschlag im Array bleibt, z. B. wenn [`allowManagedPermissionRulesOnly`](/docs/de/settings-reference#allowmanagedpermissionrulesonly) Regel-Speicheroptionen verbirgt. Es kann auch Optionen anbieten, die keinen Vorschlagseintrag haben, wie [**Ja, und zum Auto-Modus wechseln**](/docs/de/permission-modes#switch-permission-modes), das den Berechtigungsmodus direkt ändert, anstatt durch eine Berechtigungsaktualisierung.

2039 2029

2040PreToolUse-Hooks werden vor jedem Tool-Aufruf ausgeführt, unabhängig davon, ob er Berechtigung benötigt. PermissionRequest-Hooks werden nur ausgeführt, wenn Claude Code Sie um Erlaubnis bitten möchte, oder wenn es sonst einen Aufruf automatisch verweigern würde, der nicht auffordern kann. Keines der Ereignisse wird für [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) ausgeführt.2030PreToolUse-Hooks werden vor jedem Tool-Aufruf ausgeführt, unabhängig davon, ob er Berechtigung benötigt. PermissionRequest-Hooks werden nur ausgeführt, wenn Claude Code Sie um Erlaubnis bitten wird oder wenn es sonst einen Aufruf automatisch verweigern würde, der nicht aufforderbar ist. Keines der Ereignisse wird für [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior) ausgelöst.

2041 2031

2042```json theme={null}2032```json theme={null}

2043{2033{

2066 PermissionRequest-Entscheidungskontrolle2056 PermissionRequest-Entscheidungskontrolle

2067</h4>2057</h4>

2068 2058

2069`PermissionRequest` Hooks können Berechtigungsanfragen erlauben oder verweigern. Zusätzlich zu den [JSON-Ausgabefeldern](#json-output), die für alle Hooks verfügbar sind, kann Ihr Hook-Skript ein `decision` Objekt mit diesen ereignisspezifischen Feldern zurückgeben:2059`PermissionRequest` Hooks können Berechtigungsanfragen zulassen oder verweigern. Zusätzlich zu den [JSON-Ausgabefeldern](#json-output), die für alle Hooks verfügbar sind, kann Ihr Hook-Skript ein `decision` Objekt mit diesen ereignisspezifischen Feldern zurückgeben:

2070 2060

2071| Feld | Beschreibung |2061| Feld | Beschreibung |

2072| :- | :- |2062| :- | :- |

2073| `behavior` | `"allow"` gewährt die Berechtigung, `"deny"` verweigert sie. [Ablehnungs- und Frageregel](/docs/de/permissions#manage-permissions) werden immer noch ausgewertet, daher überschreibt ein Hook, der `"allow"` zurückgibt, keine übereinstimmende Ablehnungsregel |2063| `behavior` | `"allow"` gewährt die Berechtigung, `"deny"` verweigert sie. [Ablehnungs- und Frage-Regeln](/docs/de/permissions#manage-permissions) werden immer noch ausgewertet, daher überschreibt ein Hook, der `"allow"` zurückgibt, keine übereinstimmende Ablehnungsregel |

2074| `updatedInput` | Nur für `"allow"`: ändert die Tool-Eingabeparameter vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, daher schließen Sie unveränderte Felder neben geänderten ein. Die geänderte Eingabe wird erneut gegen Ablehnungs- und Frageregel ausgewertet |2064| `updatedInput` | Nur für `"allow"`: ändert die Tool-Eingabeparameter vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, daher schließen Sie unveränderte Felder neben geänderten ein. Die geänderte Eingabe wird gegen Ablehnungs- und Frage-Regeln erneut ausgewertet |

2075| `updatedPermissions` | Nur für `"allow"`: Array von [Berechtigungsaktualisierungseinträgen](#permission-update-entries) zum Anwenden, wie das Hinzufügen einer Erlaubnisregel oder das Ändern des Sitzungsberechtigungsmodus |2065| `updatedPermissions` | Nur für `"allow"`: Array von [Berechtigungsaktualisierungseinträgen](#permission-update-entries) zum Anwenden, wie das Hinzufügen einer Zulassungsregel oder das Ändern des Sitzungsberechtigungsmodus |

2078 2068

2079Ein Hook, der mit 2 beendet wird, ohne ein `decision` Objekt zu hinterlassen, lässt den Berechtigungsfluss unverändert, und sein stderr wird verworfen. Nur das `decision` Objekt kann die Anfrage gewähren oder verweigern.2069Ein Hook, der mit Code 2 beendet wird, ohne ein `decision` Objekt zu hinterlassen, lässt den Berechtigungsfluss unverändert, und sein stderr wird verworfen. Nur das `decision` Objekt kann die Anfrage gewähren oder verweigern.

2080 2070

2081```json theme={null}2071```json theme={null}

2082{2072{

2100 2090

2102| :- | :- | :- |2092| :- | :- | :- |

2103| `addRules` | `rules`, `behavior`, `destination` | Fügt Berechtigungsregeln hinzu. `rules` ist ein Array von `{toolName, ruleContent?}` Objekten. Weglassen `ruleContent`, um das ganze Tool abzugleichen. `behavior` ist `"allow"`, `"deny"` oder `"ask"` |2093| `addRules` | `rules`, `behavior`, `destination` | Fügt Berechtigungsregeln hinzu. `rules` ist ein Array von `{toolName, ruleContent?}` Objekten. Weglassen von `ruleContent`, um das ganze Tool abzugleichen. `behavior` ist `"allow"`, `"deny"` oder `"ask"` |

2106| `setMode` | `mode`, `destination` | Ändert den Berechtigungsmodus. Gültige Modi sind `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` und `manual` als Alias für `default`. Der `manual` Alias erfordert Claude Code v2.1.200 oder später |2096| `setMode` | `mode`, `destination` | Ändert den Berechtigungsmodus. Gültige Modi sind `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` und `manual` als Alias für `default`. Der `manual` Alias erfordert Claude Code v2.1.200 oder später |

2109 2099

2110<Note>2100<Note>

2111 `setMode` mit `bypassPermissions` wird nur wirksam, wenn Sie die Sitzung mit Bypass-Modus bereits verfügbar gestartet haben: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-dangerously-skip-permissions` oder `permissions.defaultMode: "bypassPermissions"` in [Benutzer-, `--settings`- oder verwalteten Einstellungen](/docs/de/settings-reference#permissions-defaultmode). Andernfalls ist die Aktualisierung ein No-Op. Die Aktualisierung ist auch ein No-Op, wenn [`permissions.disableBypassPermissionsMode`](/docs/de/permissions#managed-settings) den Modus deaktiviert oder die Sitzung im [eingeschränkten Modus](/docs/de/cli-reference#cli-flags) startet.2101 `setMode` mit `bypassPermissions` tritt nur in Kraft, wenn Sie die Sitzung mit Bypass-Modus bereits verfügbar gestartet haben: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-dangerously-skip-permissions` oder `permissions.defaultMode: "bypassPermissions"` in [Benutzer-, `--settings`- oder verwalteten Einstellungen](/docs/de/settings-reference#permissions-defaultmode). Andernfalls ist die Aktualisierung ein No-Op. Die Aktualisierung ist auch ein No-Op, wenn [`permissions.disableBypassPermissionsMode`](/docs/de/permissions#managed-settings) den Modus deaktiviert oder wenn die Sitzung im [eingeschränkten Modus](/docs/de/cli-reference#cli-flags) startet.

2112 2102

2113 `bypassPermissions` wird niemals als `defaultMode` beibehalten, unabhängig von `destination`.2103 `bypassPermissions` wird niemals als `defaultMode` beibehalten, unabhängig von `destination`.

2114</Note>2104</Note>

2124 2114

2125Ein Hook kann eines der `permission_suggestions` widerspiegeln, die er als seine eigene `updatedPermissions` Ausgabe erhalten hat.2115Ein Hook kann eines der `permission_suggestions` widerspiegeln, die er als seine eigene `updatedPermissions` Ausgabe empfangen hat.

2126 2116

2127<h3 id="posttooluse">2117<h3 id="posttooluse">

2128 PostToolUse2118 PostToolUse

2129</h3>2119</h3>

2130 2120

2131Wird sofort nach erfolgreichem Abschluss eines Tools ausgeführt.2121Wird sofort ausgeführt, nachdem ein Tool erfolgreich abgeschlossen ist.

2132 2122

2133Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.2123Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.

2134 2124

2135Gleichen Sie breiter ab, wenn der Tool-Name nicht der richtige Filter ist:2125Gleichen Sie breiter ab, wenn der Tool-Name nicht der richtige Filter ist:

2136 2126

2137* Um einen Hook nach jedem erfolgreichen Tool-Abschluss auszuführen, weglassen Sie den `matcher` oder setzen Sie ihn auf `"*"`. Ihr Hook kann dann selbst entdecken, was sich geändert hat, z. B. durch Ausführung von `git status --porcelain`, das auch nicht verfolgte Dateien auflistet, die `git diff` verpasst. Für Tool-Aufrufe, die fehlschlagen, fügen Sie den gleichen Hook unter [PostToolUseFailure](#posttoolusefailure) hinzu.2127* Um einen Hook nach jedem erfolgreichen Tool-Abschluss auszuführen, weglassen Sie den `matcher` oder setzen Sie ihn auf `"*"`. Ihr Hook kann dann selbst entdecken, was sich geändert hat, z. B. durch Ausführung von `git status --porcelain`, das auch nicht verfolgte Dateien auflistet, die `git diff` verpasst. Für fehlgeschlagene Tool-Aufrufe fügen Sie den gleichen Hook unter [PostToolUseFailure](#posttoolusefailure) hinzu.

2138* Um einen Hook auszuführen, wenn sich eine bestimmte Datei auf der Festplatte ändert, unabhängig davon, wer sie schreibt, verwenden Sie [FileChanged](#filechanged). Claude Code führt keinen `PostToolUse` Hook aus, der `Edit|Write` abgleicht, wenn ein `Bash` Befehl oder ein Prozess außerhalb von Claude Code die gleiche Datei umschreibt.2128* Um einen Hook auszuführen, wenn sich eine bestimmte Datei auf der Festplatte ändert, unabhängig davon, was sie geschrieben hat, verwenden Sie [FileChanged](#filechanged). Claude Code führt keinen `PostToolUse` Hook aus, der `Edit|Write` abgleicht, wenn ein `Bash` Befehl oder ein Prozess außerhalb von Claude Code die gleiche Datei umschreibt.

2139 2129

2140<h4 id="posttooluse-input">2130<h4 id="posttooluse-input">

2141 PostToolUse-Eingabe2131 PostToolUse-Eingabe

2142</h4>2132</h4>

2143 2133

2144`PostToolUse` Hooks werden ausgeführt, nachdem ein Tool bereits erfolgreich ausgeführt wurde. Die Eingabe umfasst sowohl `tool_input`, die an das Tool gesendeten Argumente, als auch `tool_response`, das Ergebnis, das es zurückgegeben hat. Das genaue Schema für beide hängt vom Tool ab. Datei-Tool-`tool_input` Pfade kommen im gleichen Format wie für [PreToolUse](#pretooluse-input) an: immer absolut, mit den nativen Trennzeichen der Plattform, daher Backslashes unter Windows. Für ein MCP-Tool trägt die Eingabe auch das [`mcp_server`](#pretooluse-input) Objekt.2134`PostToolUse` Hooks werden ausgelöst, nachdem ein Tool bereits erfolgreich ausgeführt wurde. Die Eingabe enthält sowohl `tool_input`, die an das Tool gesendeten Argumente, als auch `tool_response`, das Ergebnis, das es zurückgegeben hat. Das genaue Schema für beide hängt vom Tool ab. Datei-Tool-`tool_input` Pfade kommen im gleichen Format wie für [PreToolUse](#pretooluse-input) an: immer absolut, mit den nativen Trennzeichen der Plattform, daher Backslashes unter Windows. Für ein MCP-Tool trägt die Eingabe auch das [`mcp_server`](#pretooluse-input) Objekt.

2145 2135

2146```json theme={null}2136```json theme={null}

2147{2137{

2201```2191```

2202 2192

2203<Warning>2193<Warning>

2204 `updatedToolOutput` ändert nur das, was Claude sieht. Das Tool hat bereits ausgeführt, wenn der Hook ausgeführt wird, daher haben alle geschriebenen Dateien, ausgeführten Befehle oder gesendeten Netzwerkanfragen bereits Auswirkungen. Telemetrie wie OpenTelemetry-Tool-Spans und Analyseereignisse erfassen auch die ursprüngliche Ausgabe, bevor der Hook ausgeführt wird. Um einen Tool-Aufruf zu verhindern oder zu ändern, bevor er ausgeführt wird, verwenden Sie stattdessen einen [PreToolUse](#pretooluse) Hook.2194 `updatedToolOutput` ändert nur, was Claude sieht. Das Tool hat bereits ausgeführt, wenn der Hook ausgelöst wird, daher haben alle geschriebenen Dateien, ausgeführten Befehle oder gesendeten Netzwerkanfragen bereits Auswirkungen. Telemetrie wie OpenTelemetry-Tool-Spans und Analyseereignisse erfassen auch die ursprüngliche Ausgabe, bevor der Hook ausgelöst wird. Um einen Tool-Aufruf vor der Ausführung zu verhindern oder zu ändern, verwenden Sie stattdessen einen [PreToolUse](#pretooluse) Hook.

2205 2195

2206 Der Ersatzwert muss der Ausgabeform des Tools entsprechen. Integrierte Tools geben strukturierte Objekte statt einfacher Zeichenketten zurück. Beispielsweise gibt `Bash` ein Objekt mit `stdout`, `stderr`, `interrupted` und `isImage` Feldern zurück. Für integrierte Tools wird ein Wert, der nicht dem Ausgabeschema des Tools entspricht, ignoriert und die ursprüngliche Ausgabe wird verwendet. MCP-Tool-Ausgabe wird ohne Schema-Validierung durchgelassen. Das Entfernen von Fehlerdetails, die Claude benötigt, kann dazu führen, dass er bei einer falschen Annahme fortfährt.2196 Der Ersatzwert muss der Ausgabeform des Tools entsprechen. Integrierte Tools geben strukturierte Objekte statt Klartext zurück. Beispielsweise gibt `Bash` ein Objekt mit `stdout`, `stderr`, `interrupted` und `isImage` Feldern zurück. Für integrierte Tools wird ein Wert, der nicht dem Ausgabeschema des Tools entspricht, ignoriert und die ursprüngliche Ausgabe wird verwendet. MCP-Tool-Ausgabe wird ohne Schema-Validierung durchgelassen. Das Entfernen von Fehlerdetails, die Claude benötigt, kann dazu führen, dass er bei einer falschen Annahme fortfährt.

2207</Warning>2197</Warning>

2208 2198

2209<h4 id="annotate-a-result-for-the-auto-mode-classifier">2199<h4 id="annotate-a-result-for-the-auto-mode-classifier">

2210 Ergebnis für den Auto-Modus Klassifizierer annotieren2200 Ergebnis für den Auto-Modus Klassifizierer annotieren

2211</h4>2201</h4>

2212 2202

2213Geben Sie `classifierContext` zurück, um eine kurze Notiz über das Ergebnis des Tool-Aufrufs an den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifizierer statt an Claude zu senden. Der Klassifizierer [empfängt niemals Tool-Ergebnisse selbst](/docs/de/permission-modes#how-the-classifier-evaluates-actions), daher ist dieses Feld die unterstützte Methode, um ihm etwas über das, was ein Aufruf zurückgegeben hat, zu sagen, bevor er spätere Aktionen überprüft. Das Feld erfordert Claude Code v2.1.236 oder später.2203Geben Sie `classifierContext` zurück, um eine kurze Notiz über das Ergebnis des Tool-Aufrufs an den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifizierer zu senden, anstatt an Claude. Der Klassifizierer [empfängt niemals Tool-Ergebnisse selbst](/docs/de/permission-modes#how-the-classifier-evaluates-actions), daher ist dieses Feld die unterstützte Methode, um ihm etwas über das zu sagen, was ein Aufruf zurückgegeben hat, bevor er spätere Aktionen überprüft. Das Feld erfordert Claude Code v2.1.236 oder später.

2214 2204

2215Das Beispiel unten sagt dem Klassifizierer, woher die Ausgabe einer Abfrage stammt:2205Das Beispiel unten sagt dem Klassifizierer, woher die Ausgabe einer Abfrage stammt:

2216 2206

2225 2215

2226Wie viel Gewicht der Klassifizierer der Notiz gibt, hängt davon ab, wo Sie den Hook konfiguriert haben:2216Wie viel Gewicht der Klassifizierer der Notiz gibt, hängt davon ab, wo Sie den Hook konfiguriert haben:

2227 2217

2228* **Hooks, die in Claude Code konfiguriert sind**: Für Hooks aus Einstellungsdateien, Plugins, Skills und Agent-Frontmatter behandelt der Klassifizierer die Notiz als nicht verifizierten, von der Anwendung bereitgestellten Kontext. Die Notiz stellt niemals Benutzerabsicht fest, und wenn sie behauptet, Sie hätten etwas genehmigt oder angefordert, überprüft der Klassifizierer diese Behauptung gegen Ihre eigenen Nachrichten im Gespräch2218* **Hooks, die in Claude Code konfiguriert sind**: Für Hooks aus Einstellungsdateien, Plugins, Skills und Agent-Frontmatter behandelt der Klassifizierer die Notiz als nicht verifizierten, anwendungsbereitgestellten Kontext. Die Notiz stellt niemals Benutzerabsicht fest, und wenn sie behauptet, Sie hätten etwas genehmigt oder angefordert, überprüft der Klassifizierer diese Behauptung gegen Ihre eigenen Nachrichten im Gespräch

2229* **In-Process Agent SDK Callbacks**: Wenn eine Anwendung, die Claude Code einbettet, den Hook als [TypeScript SDK Callback](/docs/de/agent-sdk/hooks) registriert und die Notiz während der Live-Sitzung zurückgibt, kann der Klassifizierer eine Benutzeraussage, die in der Notiz weitergeleitet wird, als Benutzerabsicht gewichten. Eine solche Aussage kann eine Zustimmungsanforderung erfüllen, die der Klassifizierer von einer Nachricht akzeptieren würde, die Sie senden, aber sie hebt niemals einen Block auf, den Ihre eigene Nachricht auch nicht heben könnte. Nach einer Sitzungsfortsetzung behandelt Claude Code wiederhergestellte Notizen als nicht verifizierten Kontext. Wenn Hooks aus beiden Gruppen den gleichen Aufruf annotieren, behandelt der Klassifizierer die kombinierte Notiz als nicht verifizierten Kontext2219* **In-Process Agent SDK Callbacks**: Wenn eine Anwendung, die Claude Code einbettet, den Hook als [TypeScript SDK Callback](/docs/de/agent-sdk/hooks) registriert und die Notiz während der Live-Sitzung zurückgibt, kann der Klassifizierer eine Benutzeraussage, die in der Notiz weitergeleitet wird, als Benutzerabsicht gewichten. Eine solche Aussage kann eine Zustimmungsanforderung erfüllen, die der Klassifizierer von einer Nachricht akzeptieren würde, die Sie senden, aber sie hebt niemals einen Block auf, den Ihre eigene Nachricht nicht heben könnte. Nach einer Sitzungswiederaufnahme behandelt Claude Code wiederhergestellte Notizen als nicht verifizierten Kontext. Wenn Hooks aus beiden Gruppen den gleichen Aufruf annotieren, behandelt der Klassifizierer die kombinierte Notiz als nicht verifizierten Kontext

2230 2220

2231Claude Code wendet diese Grenzen an, wenn die Notiz bereitgestellt wird:2221Claude Code wendet diese Grenzen an, wenn die Notiz geliefert wird:

2232 2222

2233* **Länge**: Claude Code begrenzt die Notizen für einen Tool-Aufruf auf 2.000 Zeichen und schneidet den Rest ab. Die Grenze wird über jeden Hook geteilt, der auf diesen Aufruf antwortet2223* **Länge**: Claude Code begrenzt die Notizen für einen Tool-Aufruf auf 2.000 Zeichen und kürzt den Rest. Die Grenze wird über jeden Hook geteilt, der auf diesen Aufruf antwortet

2234* **Nur synchrone Antworten**: Claude Code ignoriert das Feld in der Antwort eines Hooks, der [im Hintergrund ausgeführt wird](#run-hooks-in-the-background), da diese Antwort nach der Aufzeichnung des Tool-Ergebnisses ankommt2224* **Nur synchrone Antworten**: Claude Code ignoriert das Feld in der Antwort eines Hooks, der [im Hintergrund läuft](#run-hooks-in-the-background), da diese Antwort ankommt, nachdem Claude Code das Tool-Ergebnis aufzeichnet

2235* **Aufrufe, die der Klassifizierer nicht aufzeichnet**: Das Transkript des Klassifizierers lässt schreibgeschützte Lookups wie Dateilesevorgänge und Suchen aus. Claude Code verwirft eine Notiz, die an einen dieser Aufrufe angehängt ist2225* **Aufrufe, die der Klassifizierer nicht aufzeichnet**: Das Transkript des Klassifizierers lässt schreibgeschützte Lookups wie Dateilesevorgänge und Suchen aus. Claude Code verwirft eine Notiz, die an einen dieser Aufrufe angehängt ist

2236* **Interaktion mit Umschreibungen**: Wenn die Notiz Ausgabe beschreibt, die Sie mit `updatedToolOutput` ersetzen, geben Sie beide Felder in der gleichen Hook-Antwort zurück. Claude Code löscht die Notiz, wenn diese Umschreibung abgelehnt wird oder eine andere Hook-Umschreibung sie ersetzt. Claude Code liefert eine Notiz, die Sie ohne Umschreibung zurückgeben, auch wenn ein anderer Hook die Ausgabe umschreibt2226* **Interaktion mit Umschreibungen**: Wenn die Notiz Ausgabe beschreibt, die Sie mit `updatedToolOutput` ersetzen, geben Sie beide Felder in der gleichen Hook-Antwort zurück. Claude Code lässt die Notiz fallen, wenn diese Umschreibung abgelehnt wird oder eine andere Hook-Umschreibung sie ersetzt. Claude Code liefert eine Notiz, die Sie ohne Umschreibung zurückgeben, auch wenn ein anderer Hook die Ausgabe umschreibt

2237 2227

2238<Warning>2228<Warning>

2239 Der Klassifizierer liest Inhalte, die Sie in `classifierContext` einfügen, als Informationen vom Anwendungshost der Sitzung, daher kopieren Sie nicht vertrauenswürdige Tool-Ausgabe oder Text von Drittanbietern hinein. Halten Sie die Notiz auf eine kurze Aussage über diesen einen Aufruf, wie eine Tatsache über seinen Ursprung oder eine Benutzeraussage darüber; verwenden Sie das Feld nicht, um nicht verwandte Nachrichten oder einen Strom von Ereignissen zu liefern.2229 Der Klassifizierer liest Inhalte, die Sie in `classifierContext` platzieren, als Informationen vom Anwendungshost der Sitzung, daher kopieren Sie nicht unvertrauenswürdige Tool-Ausgabe oder Text von Drittanbietern hinein. Halten Sie die Notiz auf eine kurze Aussage über diesen einen Aufruf, wie eine Tatsache über seinen Ursprung oder eine Benutzeraussage darüber; verwenden Sie das Feld nicht, um unabhängige Nachrichten oder einen Strom von Ereignissen zu liefern.

2240</Warning>2230</Warning>

2241 2231

2242<h3 id="posttoolusefailure">2232<h3 id="posttoolusefailure">

2248Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.2238Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.

2249 2239

2250<Note>2240<Note>

2251 Dieses Ereignis wird nicht für Tool-Aufrufe ausgeführt, die vor der Ausführung abgelehnt werden: Ein unbekannter Tool-Name, Eingabe, die Schema- oder Tool-spezifische Validierung fehlschlägt, oder eine Berechtigungsverweigerung. Validierungsablehnungen werden als `tool_use_error` Ergebnisse zurückgegeben und treten auf, bevor Hooks ausgeführt werden, daher werden weder `PreToolUse` noch dieses Ereignis ausgeführt. Berechtigungsverweigerungen führen `PreToolUse` aus, aber nicht dieses Ereignis; siehe [PermissionDenied](#permissiondenied).2241 Dieses Ereignis wird nicht für Tool-Aufrufe ausgelöst, die vor der Ausführung abgelehnt werden: Ein unbekannter Tool-Name, Eingabe, die Schema- oder Tool-spezifische Validierung nicht besteht, oder eine Berechtigungsverweigerung. Validierungsablehnungen werden als `tool_use_error` Ergebnisse zurückgegeben und treten auf, bevor Hooks ausgeführt werden, daher lösen sie weder `PreToolUse` noch dieses Ereignis aus. Berechtigungsablehnungen lösen `PreToolUse` aus, aber nicht dieses Ereignis; siehe [PermissionDenied](#permissiondenied).

2252</Note>2242</Note>

2253 2243

2254<h4 id="posttoolusefailure-input">2244<h4 id="posttoolusefailure-input">

2278 2268

2279| Feld | Beschreibung |2269| Feld | Beschreibung |

2280| :- | :- |2270| :- | :- |

2282| `is_interrupt` | Optionaler Boolean. True, wenn der Fehler Claude Code als Abbruch erreichte, anstatt als Fehler, den das Tool meldete. Das Abbrechen eines laufenden Tools führt nicht zu diesem Hook; das Tool-Ergebnis trägt stattdessen die Abbruchmeldung |2272| `is_interrupt` | Optionaler Boolean. True, wenn der Fehler Claude Code als Abbruch erreichte, anstatt als Fehler, den das Tool meldete. Das Abbrechen eines laufenden Tools löst diesen Hook nicht aus; das Tool-Ergebnis trägt die Abbruchnachricht statt |

2283| `duration_ms` | Optional. Tool-Ausführungszeit in Millisekunden. Schließt Zeit aus, die in Berechtigungsaufforderungen und PreToolUse-Hooks verbracht wird |2273| `duration_ms` | Optional. Tool-Ausführungszeit in Millisekunden. Schließt Zeit aus, die in Berechtigungsaufforderungen und PreToolUse-Hooks verbracht wird |

2284 2274

2285Die `error` Zeichenkette ist im Allgemeinen der gleiche Text, den Claude als Ergebnis des fehlgeschlagenen Tools empfängt. Sein Format variiert je nach Tool und Fehler. Schlüsseln Sie Ihren Hook auf `tool_name`, `is_interrupt` und die erste Zeile `Exit code N`; behandeln Sie den Rest der Zeichenkette als Anzeigetext, nicht als stabiles Format.2275Die `error` Zeichenkette ist im Allgemeinen der gleiche Text, den Claude als Ergebnis des fehlgeschlagenen Tools empfängt. Sein Format variiert je nach Tool und Fehler. Schlüsseln Sie Ihren Hook auf `tool_name`, `is_interrupt` und die erste Zeile `Exit code N`; behandeln Sie den Rest der Zeichenkette als Anzeigetext, nicht als stabiles Format.

2286 2276

2287* Für Bash und PowerShell erzeugt ein Befehl, der lief und beendet wurde, eine erste Zeile `Exit code N`, dann jede Ausgabe, die der Befehl als einen Block mit stdout und stderr vermischt erzeugte2277* Für Bash und PowerShell erzeugt ein Befehl, der lief und beendet wurde, eine erste Zeile `Exit code N`, dann jede Ausgabe, die der Befehl als einen Block mit stdout und stderr vermischt erzeugte

2288* Eine Nutzlast kann auch eine bloße Fehlermeldung ohne Exit-Code-Zeile tragen, wenn Claude Code den Shell-Prozess selbst nicht starten konnte2278* Eine Nutzlast kann auch eine bloße Fehlernachricht ohne Exit-Code-Zeile tragen, wenn Claude Code den Shell-Prozess selbst nicht starten konnte

2289* Claude Code schneidet lange Zeichenketten in der Mitte um einen `... [N characters truncated] ...` Marker ab und kann Zeilen von sich selbst einfügen, wie `Command timed out after 2m 0s`2279* Claude Code kürzt lange Zeichenketten in der Mitte um einen `... [N characters truncated] ...` Marker und kann Zeilen einfügen, wie `Command timed out after 2m 0s`

2290 2280

2291<h4 id="posttoolusefailure-decision-control">2281<h4 id="posttoolusefailure-decision-control">

2292 PostToolUseFailure-Entscheidungskontrolle2282 PostToolUseFailure-Entscheidungskontrolle

2311 PostToolBatch2301 PostToolBatch

2312</h3>2302</h3>

2313 2303

2314Wird einmal ausgeführt, nachdem jeder Tool-Aufruf in einem Batch aufgelöst wurde, bevor Claude Code die nächste Anfrage an das Modell sendet. `PostToolUse` wird einmal pro Tool ausgeführt, was bedeutet, dass es gleichzeitig ausgeführt wird, wenn Claude parallele Tool-Aufrufe macht. `PostToolBatch` wird genau einmal mit dem vollständigen Batch ausgeführt, daher ist es der richtige Ort, um Kontext einzufügen, der vom Satz von Tools abhängt, die liefen, statt von einem einzelnen Tool. Es gibt keinen Matcher für dieses Ereignis.2304Wird einmal ausgeführt, nachdem jeder Tool-Aufruf in einem Batch aufgelöst wurde, bevor Claude Code die nächste Anfrage an das Modell sendet. `PostToolUse` wird einmal pro Tool ausgeführt, was bedeutet, dass es gleichzeitig ausgeführt wird, wenn Claude parallele Tool-Aufrufe macht. `PostToolBatch` wird genau einmal mit dem vollständigen Batch ausgeführt, daher ist es der richtige Ort, um Kontext einzufügen, der von der Menge der Tools abhängt, die liefen, anstatt von einem einzelnen Tool. Es gibt keinen Matcher für dieses Ereignis.

2315 2305

2316<h4 id="posttoolbatch-input">2306<h4 id="posttoolbatch-input">

2317 PostToolBatch-Eingabe2307 PostToolBatch-Eingabe

2331 "tool_name": "Read",2321 "tool_name": "Read",

2332 "tool_input": {"file_path": "/.../ledger/accounts.py"},2322 "tool_input": {"file_path": "/.../ledger/accounts.py"},

2333 "tool_use_id": "toolu_01...",2323 "tool_use_id": "toolu_01...",

2334 "tool_response": " 1\tfrom __future__ import annotations\n 2\t..."2324 "tool_response": "1\tfrom __future__ import annotations\n2\t..."

2335 },2325 },

2336 {2326 {

2337 "tool_name": "Read",2327 "tool_name": "Read",

2338 "tool_input": {"file_path": "/.../ledger/transactions.py"},2328 "tool_input": {"file_path": "/.../ledger/transactions.py"},

2339 "tool_use_id": "toolu_02...",2329 "tool_use_id": "toolu_02...",

2340 "tool_response": " 1\tfrom __future__ import annotations\n 2\t..."2330 "tool_response": "1\tfrom __future__ import annotations\n2\t..."

2341 }2331 }

2342 ]2332 ]

2343}2333}

2346`tool_response` enthält den gleichen Inhalt, den das Modell im entsprechenden `tool_result` Block empfängt. Der Wert ist eine serialisierte Zeichenkette oder ein Content-Block-Array, genau wie das Tool es ausgegeben hat. Für `Read` bedeutet das Zeilennummern-Präfix-Text statt rohe Dateiinhalte. Antworten können groß sein, daher analysieren Sie nur die Felder, die Sie benötigen.2336`tool_response` enthält den gleichen Inhalt, den das Modell im entsprechenden `tool_result` Block empfängt. Der Wert ist eine serialisierte Zeichenkette oder ein Content-Block-Array, genau wie das Tool es ausgegeben hat. Für `Read` bedeutet das Zeilennummern-Präfix-Text statt rohe Dateiinhalte. Antworten können groß sein, daher analysieren Sie nur die Felder, die Sie benötigen.

2347 2337

2348<Note>2338<Note>

2349 Die `tool_response` Form unterscheidet sich von der von `PostToolUse`. `PostToolUse` übergibt das strukturierte `Output` Objekt des Tools, wie `{filePath: "...", type: "create"}` für `Write`; `PostToolBatch` übergibt den serialisierten `tool_result` Inhalt, den das Modell sieht.2339 Die `tool_response` Form unterscheidet sich von `PostToolUse`. `PostToolUse` übergibt das strukturierte `Output` Objekt des Tools, wie `{filePath: "...", type: "create"}` für `Write`; `PostToolBatch` übergibt den serialisierten `tool_result` Inhalt, den das Modell sieht.

2350</Note>2340</Note>

2351 2341

2352<h4 id="posttoolbatch-decision-control">2342<h4 id="posttoolbatch-decision-control">

2357 2347

2358| Feld | Beschreibung |2348| Feld | Beschreibung |

2359| :- | :- |2349| :- | :- |

2360| `additionalContext` | Kontext-Zeichenkette, die einmal vor dem nächsten Modell-Aufruf eingefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) für Bereitstellungsdetails, was Sie darin einfügen sollten und wie fortgesetzte Sitzungen mit vergangenen Werten umgehen |2350| `additionalContext` | Kontext-String, der einmal vor dem nächsten Modell-Aufruf eingefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) für Lieferdetails, was darin enthalten sein sollte und wie fortgesetzte Sitzungen mit vergangenen Werten umgehen |

2361 2351

2362```json theme={null}2352```json theme={null}

2363{2353{

2368}2358}

2369```2359```

2370 2360

2371Das Zurückgeben von `decision: "block"` oder `continue: false` stoppt die agentengesteuerte Schleife vor dem nächsten Modell-Aufruf. Die Blockierungsmeldung kommt aus dem JSON `reason` oder `stopReason` oder aus stderr bei Beendigung mit 2. Sie sehen sie als Warnung im Transkript, und sie bleibt im Gespräch, daher sieht Claude sie, wenn das Gespräch fortgesetzt wird.2361Das Zurückgeben von `decision: "block"` oder `continue: false` stoppt die agentengesteuerte Schleife vor dem nächsten Modell-Aufruf. Die Blockierungsnachricht kommt aus dem JSON `reason` oder `stopReason` oder aus stderr bei Exit 2. Sie sehen sie als Warnung im Transkript, und sie bleibt im Gespräch, daher sieht Claude sie, wenn das Gespräch fortgesetzt wird.

2372 2362

2373<h3 id="permissiondenied">2363<h3 id="permissiondenied">

2374 PermissionDenied2364 PermissionDenied

2375</h3>2365</h3>

2376 2366

2377Wird ausgeführt, wenn [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) einen Tool-Aufruf verweigert, einschließlich wenn er verweigert, ohne ein Klassifizierer-Urteil zu haben, weil [eine Sicherheitsprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers selbst verweigerte](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) oder seine Antwort nicht analysiert wurde. Dieser Hook wird nur im Auto-Modus ausgeführt: Er wird nicht ausgeführt, wenn Sie einen Berechtigungsdialog manuell verweigern, wenn ein `PreToolUse` Hook einen Aufruf blockiert oder wenn eine `deny` Regel übereinstimmt. Verwenden Sie ihn, um Verweigerungen zu protokollieren, die Konfiguration anzupassen oder dem Modell zu sagen, dass es den Tool-Aufruf möglicherweise erneut versuchen kann.2367Wird ausgeführt, wenn [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) einen Tool-Aufruf verweigert, einschließlich wenn er verweigert, ohne ein Klassifizierer-Urteil zu haben, weil [eine Sicherheitsprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers selbst verweigerte](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) oder seine Antwort nicht analysiert wurde. Dieser Hook wird nur im Auto-Modus ausgeführt: Er wird nicht ausgeführt, wenn Sie einen Berechtigungsdialog manuell verweigern, wenn ein `PreToolUse` Hook einen Aufruf blockiert oder wenn eine `deny` Regel übereinstimmt. Verwenden Sie ihn, um Ablehnungen zu protokollieren, die Konfiguration anzupassen oder dem Modell zu sagen, dass es den Tool-Aufruf möglicherweise erneut versuchen kann.

2378 2368

2379Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.2369Gleicht Tool-Namen ab, gleiche Werte wie PreToolUse.

2380 2370

2403 2393

2404| Feld | Beschreibung |2394| Feld | Beschreibung |

2405| :- | :- |2395| :- | :- |

2406| `reason` | Der Verweigerungsgrund. Für ein Klassifizierer-Urteil benennt es in den meisten Sitzungen die übereinstimmende Regel in eckigen Klammern, wie `[Data Exfiltration]`; siehe [Verweigerungen überprüfen](/docs/de/auto-mode-config#review-denials) für die anderen Formen. Für eine [Verweigerung ohne Urteil](#permissiondenied-decision-control) beginnt sie mit `Auto mode could not evaluate this action and is blocking it for safety`. Für eine Verweigerung, weil das Klassifizierer-Modell nicht verfügbar war, ist es der feste Text `Classifier unavailable` |2396| `reason` | Der Ablehnungsgrund. Für ein Klassifizierer-Urteil benennt es in den meisten Sitzungen die übereinstimmende Regel in eckigen Klammern, wie `[Data Exfiltration]`; siehe [Ablehnungen überprüfen](/docs/de/auto-mode-config#review-denials) für die anderen Formen. Für eine [Ablehnungen ohne Urteil](#permissiondenied-decision-control) beginnt sie mit `Auto mode could not evaluate this action and is blocking it for safety`. Für eine Ablehnung, weil das Klassifizierer-Modell nicht verfügbar war, ist es der feste Text `Classifier unavailable` |

2407 2397

2408<h4 id="permissiondenied-decision-control">2398<h4 id="permissiondenied-decision-control">

2409 PermissionDenied-Entscheidungskontrolle2399 PermissionDenied-Entscheidungskontrolle

2420}2410}

2421```2411```

2422 2412

2423Wenn `retry` `true` ist, fügt Claude Code eine Nachricht zum Gespräch hinzu, die dem Modell sagt, dass es den Tool-Aufruf möglicherweise erneut versuchen kann. Claude Code kehrt die Verweigerung selbst nicht um. Wenn Ihr Hook kein JSON zurückgibt oder `retry: false` zurückgibt, bleibt die Verweigerung bestehen und das Modell empfängt die ursprüngliche Ablehnungsmeldung.2413Wenn `retry` `true` ist, fügt Claude Code eine Nachricht zum Gespräch hinzu, die dem Modell sagt, dass es den Tool-Aufruf möglicherweise erneut versuchen kann. Claude Code kehrt die Ablehnung selbst nicht um. Wenn Ihr Hook kein JSON zurückgibt oder `retry: false` zurückgibt, bleibt die Ablehnung bestehen und das Modell empfängt die ursprüngliche Ablehnungsnachricht.

2424 2414

2425Claude Code ignoriert `retry: true`, wenn der Klassifizierer [kein Urteil über die Aktion erzeugt hat](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action): Seine Antwort wurde nicht analysiert oder eine Sicherheitsprüfung, die vom Auto-Modus getrennt ist, verweigerte die Anfrage des Klassifizierers. Für diese Verweigerungen sagt Claude Code dem Modell in der Ablehnungsmeldung bereits, ob es später erneut versuchen oder weitermachen soll.2415Claude Code ignoriert `retry: true`, wenn der Klassifizierer [kein Urteil über die Aktion erzeugt hat](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action): Seine Antwort analysierte nicht oder eine Sicherheitsprüfung, die vom Auto-Modus getrennt ist, verweigerte die Anfrage des Klassifizierers. Für diese Ablehnungen sagt Claude Code dem Modell bereits in der Ablehnungsnachricht, ob es später erneut versuchen oder weitermachen soll.

2426 2416

2427<h3 id="notification">2417<h3 id="notification">

2428 Notification2418 Notification

2429</h3>2419</h3>

2430 2420

2431Wird ausgeführt, wenn Claude Code Benachrichtigungen sendet. Gleicht Benachrichtigungstyp ab. Weglassen Sie den Matcher, um Hooks für alle Benachrichtigungstypen auszuführen.2421Wird ausgeführt, wenn Claude Code Benachrichtigungen sendet. Gleicht Benachrichtigungstyp ab. Weglassen des Matchers, um Hooks für alle Benachrichtigungstypen auszuführen.

2432 2422

2433Sie erhalten diese Hook-Ereignisse auch mit ausgeschalteten Desktop-Benachrichtigungen: Die `preferredNotifChannel` Einstellung, einschließlich `notifications_disabled`, ändert nur, wie Sie benachrichtigt werden, nicht ob Ihr Hook ausgeführt wird.2423Sie erhalten diese Hook-Ereignisse auch mit ausgeschalteten Desktop-Benachrichtigungen: Die `preferredNotifChannel` Einstellung, einschließlich `notifications_disabled`, ändert nur, wie Sie benachrichtigt werden, nicht ob Ihr Hook ausgeführt wird.

2434 2424

2435| Matcher | Wann wird es ausgelöst |2425| Matcher | Wann wird es ausgelöst |

2436| :- | :- |2426| :- | :- |

2437| `permission_prompt` | Claude benötigt Ihre Genehmigung für einen Tool-Aufruf oder eine Netzwerkanfrage eines Sandbox-Befehls, und die Aufforderung hat etwa sechs Sekunden gewartet |2427| `permission_prompt` | Claude benötigt Ihre Genehmigung für einen Tool-Aufruf oder eine Sandbox-Anfrage einer [Netzwerkanfrage](/docs/de/sandboxing#network-isolation), und die Aufforderung hat etwa sechs Sekunden gewartet |

2440| `elicitation_dialog` | Ein MCP-Server öffnet ein Elicitierungsformular und Sie haben etwa sechs Sekunden nicht eingegeben |2430| `elicitation_dialog` | Ein MCP-Server öffnet ein Elicitation-Formular und Sie haben etwa sechs Sekunden nicht eingegeben |

2441| `elicitation_url_dialog` | Ein MCP-Server fordert Sie auf, eine Browser-URL zu öffnen und Sie haben etwa sechs Sekunden nicht eingegeben |2431| `elicitation_url_dialog` | Ein MCP-Server fordert Sie auf, eine Browser-URL zu öffnen und Sie haben etwa sechs Sekunden nicht eingegeben |

2442| `elicitation_complete` | Ein MCP-Server meldet, dass eine [URL-Modus-Elicitierung](#elicitation-input) abgeschlossen ist |2432| `elicitation_complete` | Ein MCP-Server meldet, dass eine [URL-Modus-Elicitation](#elicitation-input) abgeschlossen ist |

2444| `agent_needs_input` | Eine Hintergrund-Sitzung beginnt, auf Ihre Eingabe zu warten, während [Agent-Ansicht](/docs/de/agent-view) in einem Terminal offen ist, oder die aktuelle Sitzung stellt Ihnen eine [Agent-Team-Teamkollegen-Terminal-Setup-Frage](/docs/de/agent-teams#choose-a-display-mode) und Sie haben etwa sechs Sekunden nicht eingegeben |2434| `agent_needs_input` | Eine Hintergrund-Sitzung beginnt, auf Ihre Eingabe zu warten, während [Agent-Ansicht](/docs/de/agent-view) in einem Terminal offen ist, oder die aktuelle Sitzung fragt Sie eine [Agent-Team-Teamkollegen-Terminal-Setup-Frage](/docs/de/agent-teams#choose-a-display-mode) und Sie haben etwa sechs Sekunden nicht eingegeben |

2445| `agent_completed` | Eine Hintergrund-Sitzung wird beendet oder schlägt fehl. Wird nur ausgeführt, während [Agent-Ansicht](/docs/de/agent-view) in einem Terminal offen ist |2435| `agent_completed` | Eine Hintergrund-Sitzung wird beendet oder schlägt fehl. Wird nur ausgelöst, während [Agent-Ansicht](/docs/de/agent-view) in einem Terminal offen ist |

2446| `quota_auto_resume_fired` | Claude Code setzt Ihre Aufgabe nach einer claude.ai Nutzungslimit-Pause fort: beim Reset oder früher, wenn Sie etwas in Claude Code tun, während Sie warten, wie das Hinzufügen von Nutzungsguthaben, das Upgrade Ihres Plans oder das Wechseln von Modellen, macht Nutzung wieder verfügbar, mit der [Modell-Einstellung Ausnahme](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) |2436| `quota_auto_resume_fired` | Claude Code setzt Ihre Aufgabe fort, nachdem ein claude.ai Nutzungslimit sie pausiert hat: beim Reset oder früher, wenn Sie etwas in Claude Code tun, während Sie warten, wie das Hinzufügen von Nutzungsguthaben, das Upgrade Ihres Plans oder das Wechseln von Modellen, was Nutzung wieder verfügbar macht, mit der [Modell-Einstellung Ausnahme](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset) |

2447| `quota_auto_resume_stale` | Ein claude.ai Nutzungslimit wurde zurückgesetzt, während Ihr Computer für mehr als etwa 30 Minuten schlief. Claude Code wartet darauf, dass Sie `Enter` drücken, anstatt fortzufahren. Nach einem kürzeren Schlaf wird es fortgesetzt und wird stattdessen `quota_auto_resume_fired` ausgeführt |2437| `quota_auto_resume_stale` | Ein claude.ai Nutzungslimit wurde zurückgesetzt, während Ihr Computer für mehr als etwa 30 Minuten schlief. Claude Code wartet darauf, dass Sie `Enter` drücken, anstatt fortzufahren. Nach einem kürzeren Schlaf wird es fortgesetzt und löst stattdessen `quota_auto_resume_fired` aus |

2448| `quota_auto_resume_disabled` | Claude Code beendet sein Warten auf ein claude.ai Nutzungslimit, ohne Ihre Aufgabe fortzusetzen: [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) wurde ausgeschaltet oder der Reset rückte während eines Wartens, das Claude Code selbst gestartet hat, mehr als 24 Stunden in die Zukunft, die fortgesetzte Aufgabe traf immer wieder das Limit oder die Fortsetzung wurde blockiert, bevor sie das Modell erreichte. Wird nicht ausgeführt, wenn Sie `Esc` oder `Ctrl+C` drücken oder **Nicht automatisch fortsetzen** wählen |2438| `quota_auto_resume_disabled` | Claude Code beendet sein Warten auf ein claude.ai Nutzungslimit, ohne Ihre Aufgabe fortzusetzen: [`autoContinueAtUsageLimit`](/docs/de/settings-reference#autocontinueatusagelimit) wurde ausgeschaltet oder der Reset rückte während eines Wartens, das Claude Code selbst gestartet hat, mehr als 24 Stunden in die Zukunft, die fortgesetzte Aufgabe traf weiterhin das Limit oder die Fortsetzung wurde blockiert, bevor sie das Modell erreichte. Wird nicht ausgelöst, wenn Sie `Esc` oder `Ctrl+C` drücken oder **Nicht automatisch fortsetzen** wählen |

2449 2439

2450Die `agent_needs_input` und `agent_completed` Typen erfordern Claude Code v2.1.198 oder später.2440Die `agent_needs_input` und `agent_completed` Typen erfordern Claude Code v2.1.198 oder später.

2451 2441

2452Die `quota_auto_resume_fired`, `quota_auto_resume_stale` und `quota_auto_resume_disabled` Typen erfordern Claude Code v2.1.234 oder später.2442Die `quota_auto_resume_fired`, `quota_auto_resume_stale` und `quota_auto_resume_disabled` Typen erfordern Claude Code v2.1.234 oder später.

2453 2443

2454In Terminal-Sitzungen erfordert `permission_prompt` für eine Netzwerkanfrage eines Sandbox-Befehls Claude Code v2.1.246 oder später.2444In Terminal-Sitzungen erfordert `permission_prompt` für eine Sandbox-Anfrage einer Netzwerkanfrage Claude Code v2.1.246 oder später.

2455 2445

2456`agent_needs_input` für eine Teamkollegen-Terminal-Setup-Frage erfordert Claude Code v2.1.248 oder später.2446`agent_needs_input` für eine Teamkollegen-Terminal-Setup-Frage erfordert Claude Code v2.1.248 oder später.

2457 2447

2458<Note>2448<Note>

2459 Die `permission_prompt`, `idle_prompt`, `elicitation_dialog` und `elicitation_url_dialog` Typen teilen ihr Timing mit Desktop-Benachrichtigungen, daher sehen Sie sie in Terminal-Sitzungen nur, wenn Sie vom Terminal entfernt zu sein scheinen:2449 Die `permission_prompt`, `idle_prompt`, `elicitation_dialog` und `elicitation_url_dialog` Typen teilen ihr Timing mit Desktop-Benachrichtigungen, daher sehen Sie sie in Terminal-Sitzungen nur, wenn Sie vom Terminal weg zu sein scheinen:

2460 2450

2461 * Erwarten Sie `permission_prompt`, sobald Sie etwa sechs Sekunden nicht eingegeben haben. Der Timer startet, wenn die Berechtigungsaufforderung erscheint, und jeder Tastendruck verschiebt ihn. Um einen Hook sofort auszuführen, wenn Claude um Erlaubnis bittet, ein Tool zu verwenden, verwenden Sie stattdessen [PermissionRequest](#permissionrequest).2451 * Erwarten Sie `permission_prompt`, sobald Sie etwa sechs Sekunden nicht eingegeben haben. Der Timer startet, wenn die Berechtigungsaufforderung erscheint, und jeder Tastendruck verschiebt ihn. Um einen Hook sofort auszuführen, wenn Claude um Erlaubnis zur Verwendung eines Tools bittet, verwenden Sie stattdessen [PermissionRequest](#permissionrequest).

2462 * Erwarten Sie `idle_prompt` etwa 60 Sekunden, nachdem Claude geantwortet hat, und nur wenn Sie seitdem nicht eingegeben haben. Claude Code sendet `idle_prompt` nicht, während es auf einen claude.ai Nutzungslimit-Reset wartet. Wenn das Warten von selbst endet, wird stattdessen einer der `quota_auto_resume_*` Typen ausgeführt.2452 * Erwarten Sie `idle_prompt` etwa 60 Sekunden, nachdem Claude geantwortet hat, und nur wenn Sie seitdem nicht eingegeben haben. Claude Code sendet `idle_prompt` nicht, während es auf einen claude.ai Nutzungslimit-Reset wartet. Wenn das Warten auf eigene Faust endet, wird stattdessen einer der `quota_auto_resume_*` Typen ausgelöst.

2463 * Erwarten Sie `elicitation_dialog` für ein Elicitierungsformular oder `elicitation_url_dialog` für eine Browser-URL-Anfrage, sobald Sie etwa sechs Sekunden nicht eingegeben haben. Beide teilen das gleiche Sechs-Sekunden-Gate wie `permission_prompt`: Der Timer startet, wenn der Dialog erscheint, und jeder Tastendruck verschiebt ihn.2453 * Erwarten Sie `elicitation_dialog` für ein Elicitation-Formular oder `elicitation_url_dialog` für eine Browser-URL-Anfrage, sobald Sie etwa sechs Sekunden nicht eingegeben haben. Beide teilen das gleiche Sechs-Sekunden-Gate wie `permission_prompt`: Der Timer startet, wenn der Dialog erscheint, und jeder Tastendruck verschiebt ihn.

2464 2454

2465 Eine Berechtigungsanfrage oder Elicitierung, die ankommt, während ein anderer Dialog auf dem Bildschirm ist, behält das gleiche Sechs-Sekunden-Gate, zeitlich von wenn die Anfrage ankommt. Seine Benachrichtigung kann Sie erreichen, während die Anfrage immer noch hinter dem offenen Dialog wartet.2455 Eine Berechtigungsanfrage oder Elicitation, die ankommt, während ein anderer Dialog auf dem Bildschirm ist, behält das gleiche Sechs-Sekunden-Gate, zeitlich von wenn die Anfrage ankommt. Seine Benachrichtigung kann Sie erreichen, während die Anfrage immer noch hinter dem offenen Dialog wartet.

2466</Note>2456</Note>

2467 2457

2468Claude Code zeitlich `permission_prompt` unterschiedlich in Sitzungen, in denen es Berechtigungsanfragen an den Agent SDK [`canUseTool` Callback](/docs/de/agent-sdk/user-input) sendet, was ist, wie Claude Desktop und die VS Code Erweiterung Claude Code hosten:2458Claude Code zeitlich `permission_prompt` unterschiedlich in Sitzungen, in denen es Berechtigungsanfragen an den Agent SDK [`canUseTool` Callback](/docs/de/agent-sdk/user-input) sendet, was ist, wie Claude Desktop und die VS Code Erweiterung Claude Code hosten:

2471* Wenn Sie oder ein [PermissionRequest](#permissionrequest) Hook früher antworten, führt Claude Code `permission_prompt` nicht aus.2461* Wenn Sie oder ein [PermissionRequest](#permissionrequest) Hook früher antworten, führt Claude Code `permission_prompt` nicht aus.

2472* Setzen Sie [`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`](/docs/de/env-vars) auf `1`, um `permission_prompt` in diesen Sitzungen auszuschalten.2462* Setzen Sie [`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`](/docs/de/env-vars) auf `1`, um `permission_prompt` in diesen Sitzungen auszuschalten.

2473 2463

2474Vor v2.1.233 wurde `permission_prompt` in diesen Sitzungen nicht ausgeführt.2464Vor v2.1.233 wurde `permission_prompt` in diesen Sitzungen nicht ausgelöst.

2475 2465

2476Verwenden Sie separate Matcher, um verschiedene Handler je nach Benachrichtigungstyp auszuführen. Diese Konfiguration löst ein Berechtigungs-spezifisches Warnungsskript aus, wenn Claude Berechtigungsgenehmigung benötigt, und eine andere Benachrichtigung, wenn Claude untätig war:2466Verwenden Sie separate Matcher, um verschiedene Handler je nach Benachrichtigungstyp auszuführen. Diese Konfiguration löst ein Berechtigungs-spezifisches Warnungsskript aus, wenn Claude Genehmigung benötigt, und eine andere Benachrichtigung, wenn Claude untätig war:

2477 2467

2478```json theme={null}2468```json theme={null}

2479{2469{

2506 Notification-Eingabe2496 Notification-Eingabe

2507</h4>2497</h4>

2508 2498

2509Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten Notification-Hooks `message` mit dem Benachrichtigungstext, ein optionaler `title` und `notification_type`, das angibt, welcher Typ ausgeführt wurde.2499Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten Notification-Hooks `message` mit dem Benachrichtigungstext, einen optionalen `title` und `notification_type`, der angibt, welcher Typ ausgelöst wurde.

2510 2500

2511```json theme={null}2501```json theme={null}

2512{2502{

2526 SubagentStart2516 SubagentStart

2527</h3>2517</h3>

2528 2518

2529Wird ausgeführt, wenn Claude einen Subagenten mit dem Agent-Tool spawnt, wenn Claude [einen Subagenten fortsetzt](/docs/de/sub-agents#resume-subagents) und jedes Mal, wenn ein In-Process [Agent-Team](/docs/de/agent-teams) Teamkollege eine neue Nachricht verarbeitet. Unterstützt Matcher zum Filtern nach Agent-Typ-Name. Für integrierte Agenten ist dies der Agent-Name wie `general-purpose`, `Explore` oder `Plan`. Für [benutzerdefinierte Subagenten](/docs/de/sub-agents) ist dies das `name` Feld aus dem Agent-Frontmatter, nicht der Dateiname.2519Wird ausgeführt, wenn Claude einen Subagent mit dem Agent-Tool erzeugt, wenn Claude [einen Subagent fortsetzt](/docs/de/sub-agents#resume-subagents) und jedes Mal, wenn ein In-Process [Agent-Team](/docs/de/agent-teams) Teamkollege eine neue Nachricht verarbeitet. Unterstützt Matcher zum Filtern nach Agent-Typ-Name. Für integrierte Agenten ist dies der Agent-Name wie `general-purpose`, `Explore` oder `Plan`. Für [benutzerdefinierte Subagenten](/docs/de/sub-agents) ist dies das `name` Feld aus dem Agent-Frontmatter, nicht der Dateiname.

2530 2520

2531Für Subagenten, die von einem [Plugin](/docs/de/plugins/overview) versendet werden, ist der Agent-Typ der Plugin-scoped Identifikator wie `my-plugin:reviewer`, nicht der bloße Frontmatter-Name. Der Doppelpunkt platziert einen Plugin-scoped Namen auf dem regulären Ausdruckspfad, daher verankern Sie den Matcher mit `^` und `$` für einen genauen Treffer: `^my-plugin:reviewer$`.2521Für Subagenten, die von einem [Plugin](/docs/de/plugins/overview) versendet werden, ist der Agent-Typ der Plugin-scoped Bezeichner wie `my-plugin:reviewer`, nicht der bloße Frontmatter-Name. Der Doppelpunkt platziert einen Plugin-scoped Namen auf dem regulären Ausdruckspfad, daher verankern Sie den Matcher mit `^` und `$` für einen genauen Treffer: `^my-plugin:reviewer$`.

2532 2522

2533<h4 id="subagentstart-input">2523<h4 id="subagentstart-input">

2534 SubagentStart-Eingabe2524 SubagentStart-Eingabe

2535</h4>2525</h4>

2536 2526

2537Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten SubagentStart-Hooks `agent_id` mit dem eindeutigen Identifikator für den Subagenten und `agent_type` mit dem Agent-Namen, den der Matcher filtert.2527Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten SubagentStart-Hooks `agent_id` mit dem eindeutigen Bezeichner für den Subagent und `agent_type` mit dem Agent-Namen, den der Matcher filtert.

2538 2528

2539```json theme={null}2529```json theme={null}

2540{2530{

2547}2537}

2548```2538```

2549 2539

2550SubagentStart-Hooks können die Erstellung von Subagenten nicht blockieren, aber sie können Kontext in den Subagenten einfügen. Zusätzlich zu den [JSON-Ausgabefeldern](#json-output), die für alle Hooks verfügbar sind, können Sie zurückgeben:2540SubagentStart-Hooks können die Subagent-Erstellung nicht blockieren, aber sie können Kontext in den Subagent einfügen. Zusätzlich zu den [JSON-Ausgabefeldern](#json-output), die für alle Hooks verfügbar sind, können Sie zurückgeben:

2551 2541

2552| Feld | Beschreibung |2542| Feld | Beschreibung |

2553| :- | :- |2543| :- | :- |

2562}2552}

2563```2553```

2564 2554

2565Wenn der Hook erneut für den gleichen Subagenten ausgeführt wird, injiziert Claude Code den zurückgegebenen Kontext nur, wenn der Kontext des Subagenten nicht bereits die Kopie aus einem früheren Lauf enthält. Die beim Start eingefügte Kopie bleibt bestehen, wobei der [Prompt-Cache](/docs/de/prompt-caching#subagents-and-the-cache) des Subagenten intakt bleibt. Nach [Auto-Komprimierung](/docs/de/sub-agents#auto-compaction) verwirft diese Kopie, injiziert Claude Code den Kontext des nächsten Laufs erneut.2555Wenn der Hook erneut für den gleichen Subagent ausgeführt wird, injiziert Claude Code den zurückgegebenen Kontext nur, wenn der Kontext des Subagenten nicht bereits die Kopie aus einem früheren Lauf hält. Die beim Start eingefügte Kopie bleibt an Ort und Stelle, wobei der [Prompt-Cache](/docs/de/prompt-caching#subagents-and-the-cache) des Subagenten intakt bleibt. Nach [Auto-Komprimierung](/docs/de/sub-agents#auto-compaction) verwirft diese Kopie, injiziert Claude Code den Kontext des nächsten Laufs erneut.

2566 2556

2567<h3 id="subagentstop">2557<h3 id="subagentstop">

2568 SubagentStop2558 SubagentStop

2569</h3>2559</h3>

2570 2560

2571Wird ausgeführt, wenn ein Claude Code Subagent mit dem Antworten fertig ist. Gleicht Agent-Typ ab, gleiche Werte wie SubagentStart.2561Wird ausgeführt, wenn ein Claude Code Subagent mit der Antwort fertig ist. Gleicht Agent-Typ ab, gleiche Werte wie SubagentStart.

2572 2562

2573<h4 id="subagentstop-input">2563<h4 id="subagentstop-input">

2574 SubagentStop-Eingabe2564 SubagentStop-Eingabe

2576 2566

2577Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten SubagentStop-Hooks `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` und `last_assistant_message`. Das `agent_type` Feld ist der Wert, der zum Filtern des Matchers verwendet wird. Der `transcript_path` ist das Transkript der Hauptsitzung, während `agent_transcript_path` das eigene Transkript des Subagenten ist, das in einem verschachtelten `subagents/` Ordner gespeichert ist. Das `last_assistant_message` Feld enthält den Textinhalt der letzten Antwort des Subagenten, daher können Hooks darauf zugreifen, ohne die Transkript-Datei zu analysieren.2567Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten SubagentStop-Hooks `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` und `last_assistant_message`. Das `agent_type` Feld ist der Wert, der zum Filtern des Matchers verwendet wird. Der `transcript_path` ist das Transkript der Hauptsitzung, während `agent_transcript_path` das eigene Transkript des Subagenten ist, das in einem verschachtelten `subagents/` Ordner gespeichert ist. Das `last_assistant_message` Feld enthält den Textinhalt der letzten Antwort des Subagenten, daher können Hooks darauf zugreifen, ohne die Transkript-Datei zu analysieren.

2578 2568

2579Nicht jedes SubagentStop-Ereignis kommt von einem Subagenten, den Claude spawnt. Claude Code führt auch interne Agenten für einige seiner eigenen Funktionen aus, wie [Eingabeaufforderungsvorschläge](/docs/de/interactive-mode#prompt-suggestions) und [`/btw` Seitenfragen](/docs/de/interactive-mode#side-questions-with-%2Fbtw), und SubagentStop wird ausgeführt, wenn einer davon fertig ist. Für diese Ereignisse ist `agent_type` der Agent-Name, den die Sitzung selbst ausführt, wie einer, der mit [`--agent`](/docs/de/cli-reference#cli-flags) oder der [`agent` Einstellung](/docs/de/settings-reference#agent) gesetzt ist, und eine leere Zeichenkette, wenn die Sitzung ohne einen läuft.2569Nicht jedes SubagentStop-Ereignis kommt von einem Subagent, den Claude erzeugt hat. Claude Code führt auch interne Agenten für einige seiner eigenen Funktionen aus, wie [Eingabeaufforderungs-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) und [`/btw` Seitenfragen](/docs/de/interactive-mode#side-questions-with-%2Fbtw), und SubagentStop wird ausgelöst, wenn einer davon fertig ist. Für diese Ereignisse ist `agent_type` der Agent-Name, den die Sitzung selbst ausführt, wie einer, der mit [`--agent`](/docs/de/cli-reference#cli-flags) oder der [`agent` Einstellung](/docs/de/settings-reference#agent) gesetzt ist, und eine leere Zeichenkette, wenn die Sitzung ohne einen läuft.

2580 2570

2581Ein `matcher`, der Agent-Typen benennt, gleicht keine leere `agent_type` ab. Ein Hook, dessen Matcher weggelassen, `""` oder `"*"` ist oder ein regulärer Ausdruck, der eine leere Zeichenkette abgleicht, wird auch für Ereignisse mit einer leeren `agent_type` ausgeführt.2571Ein `matcher`, der Agent-Typen benennt, gleicht keine leere `agent_type` ab. Ein Hook, dessen Matcher weggelassen, `""` oder `"*"` ist oder ein regulärer Ausdruck, der eine leere Zeichenkette abgleicht, wird auch für Ereignisse mit einer leeren `agent_type` ausgeführt.

2582 2572

2583Auf Claude Code v2.1.271 oder später liefert ein Subagent, der mit dem [`SubagentHandback`](/docs/de/tools-reference) Tool läuft, seinen Bericht durch dieses Tool, bevor er stoppt. Das `last_assistant_message` Feld enthält dann den Schließungstext des Subagenten, falls vorhanden, das ist nicht der gelieferte Bericht. Der Bericht ist die `message` Eingabe dieses Aufrufs, die ein `PreToolUse` oder `PostToolUse` Hook, der auf `SubagentHandback` abgleicht, als `tool_input.message` empfängt.2573Auf Claude Code v2.1.271 oder später liefert ein Subagent, der mit dem [`SubagentHandback`](/docs/de/tools-reference) Tool läuft, seinen Bericht über dieses Tool, bevor er stoppt. Das `last_assistant_message` Feld hält dann den abschließenden Text des Subagenten, falls vorhanden, das ist nicht der gelieferte Bericht. Der Bericht ist die `message` Eingabe dieses Aufrufs, die ein `PreToolUse` oder `PostToolUse` Hook, der auf `SubagentHandback` abgleicht, als `tool_input.message` empfängt.

2584 2574

2585SubagentStop-Hooks erhalten auch die `background_tasks` und `session_crons` Arrays, die unter [Stop-Eingabe](#stop-input) beschrieben sind. Beide Arrays sind auf die Eltern-Sitzung scoped, nicht den Subagenten.2575SubagentStop-Hooks erhalten auch die `background_tasks` und `session_crons` Arrays, die unter [Stop-Eingabe](#stop-input) beschrieben sind. Beide Arrays sind auf die übergeordnete Sitzung begrenzt, nicht auf den Subagent.

2586 2576

2587```json theme={null}2577```json theme={null}

2588{2578{

2601}2591}

2602```2592```

2603 2593

2604SubagentStop-Hooks verwenden das gleiche Entscheidungskontrollformat wie [Stop-Hooks](#stop-decision-control), einschließlich `hookSpecificOutput.additionalContext` mit `hookEventName` auf `"SubagentStop"` gesetzt, für Fehler-freies Feedback, das den Subagenten laufen lässt. Das Zurückgeben von `decision: "block"` mit einem `reason` lässt den Subagenten laufen und liefert `reason` an den Subagenten als seine nächste Anweisung. Ein Hook, der durch Beendigung mit 2 blockiert, liefert seine stderr-Nachricht auf die gleiche Weise. Um Kontext in die Eltern-Sitzung einzufügen, nachdem ein Subagent zurückkommt, verwenden Sie stattdessen einen [`PostToolUse`](#posttooluse) Hook auf dem `Agent` Tool.2594SubagentStop-Hooks verwenden das gleiche Entscheidungskontrollformat wie [Stop-Hooks](#stop-decision-control), einschließlich `hookSpecificOutput.additionalContext` mit `hookEventName` auf `"SubagentStop"` gesetzt, für Fehler-freies Feedback, das den Subagent laufen lässt. Das Zurückgeben von `decision: "block"` mit einem `reason` lässt den Subagent laufen und liefert `reason` an den Subagent als seine nächste Anweisung. Ein Hook, der durch Beendigung mit 2 blockiert, liefert seine stderr-Nachricht auf die gleiche Weise. Um Kontext in die übergeordnete Sitzung einzufügen, nachdem ein Subagent zurückkehrt, verwenden Sie einen [`PostToolUse`](#posttooluse) Hook auf dem `Agent` Tool statt.

2605 2595

2606<h3 id="taskcreated">2596<h3 id="taskcreated">

2607 TaskCreated2597 TaskCreated

2608</h3>2598</h3>

2609 2599

2610Wird ausgeführt, wenn eine Aufgabe über das `TaskCreate` Tool erstellt wird. Verwenden Sie dies, um Benennungskonventionen durchzusetzen, Aufgabenbeschreibungen zu erfordern oder zu verhindern, dass bestimmte Aufgaben erstellt werden. In einer [Sitzung ohne die Task-Tools](/docs/de/tools-reference#task-tool-availability) wird dieses Ereignis nicht ausgeführt.2600Wird ausgeführt, wenn eine Aufgabe über das `TaskCreate` Tool erstellt wird. Verwenden Sie dies, um Benennungskonventionen durchzusetzen, Aufgabenbeschreibungen zu erfordern oder zu verhindern, dass bestimmte Aufgaben erstellt werden. In einer [Sitzung ohne die Task-Tools](/docs/de/tools-reference#task-tool-availability) wird dieses Ereignis nicht ausgelöst.

2611 2601

2612TaskCreated-Hooks unterstützen keine Matcher und werden bei jedem Vorkommen ausgeführt.2602TaskCreated-Hooks unterstützen keine Matcher und werden bei jedem Vorkommen ausgelöst.

2613 2603

2614<h4 id="taskcreated-input">2604<h4 id="taskcreated-input">

2615 TaskCreated-Eingabe2605 TaskCreated-Eingabe

2633 2623

2634| Feld | Beschreibung |2624| Feld | Beschreibung |

2635| :- | :- |2625| :- | :- |

2648* **Exit-Code 2**: Claude Code gibt den stderr-Text als die Nachricht zurück.2638* **Exit-Code 2**: Claude Code gibt den stderr-Text als die Nachricht zurück.

2649* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code gibt `reason` als die Nachricht zurück.2639* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code gibt `reason` als die Nachricht zurück.

2650 2640

2651Dieses Beispiel blockiert Aufgaben, deren Betreff nicht dem erforderlichen Format folgt:2641Dieses Beispiel blockiert Aufgaben, deren Betreff nicht dem erforderlichen Format entspricht:

2652 2642

2653```bash theme={null}2643```bash theme={null}

2654#!/bin/bash2644#!/bin/bash

2667 TaskCompleted2657 TaskCompleted

2668</h3>2658</h3>

2669 2659

2670Wird ausgeführt, wenn eine Aufgabe als abgeschlossen markiert wird. Dies wird in zwei Situationen ausgeführt: wenn ein Agent eine Aufgabe explizit durch das TaskUpdate-Tool als abgeschlossen markiert oder wenn ein [Agent-Team](/docs/de/agent-teams) Teamkollege seinen Zug mit laufenden Aufgaben beendet. Verwenden Sie dies, um Abschluss-Kriterien wie bestandene Tests oder Lint-Überprüfungen durchzusetzen, bevor eine Aufgabe geschlossen werden kann.2660Wird ausgeführt, wenn eine Aufgabe als abgeschlossen markiert wird. Dies wird in zwei Situationen ausgelöst: wenn ein Agent eine Aufgabe explizit über das TaskUpdate-Tool als abgeschlossen markiert oder wenn ein [Agent-Team](/docs/de/agent-teams) Teamkollege seinen Zug mit laufenden Aufgaben beendet. Verwenden Sie dies, um Abschluss-Kriterien wie bestandene Tests oder Lint-Überprüfungen durchzusetzen, bevor eine Aufgabe geschlossen werden kann.

2671 2661

2672TaskCompleted-Hooks unterstützen keine Matcher und werden bei jedem Vorkommen ausgeführt.2662TaskCompleted-Hooks unterstützen keine Matcher und werden bei jedem Vorkommen ausgelöst.

2673 2663

2674<h4 id="taskcompleted-input">2664<h4 id="taskcompleted-input">

2675 TaskCompleted-Eingabe2665 TaskCompleted-Eingabe

2694 2684

2695| Feld | Beschreibung |2685| Feld | Beschreibung |

2696| :- | :- |2686| :- | :- |

2729 Stop2719 Stop

2730</h3>2720</h3>

2731 2721

2732Wird ausgeführt, wenn der Haupt-Claude Code Agent mit dem Antworten fertig ist. Wird nicht ausgeführt, wenn der Stopp aufgrund einer Benutzerunterbrechung auftrat. API-Fehler führen stattdessen [StopFailure](#stopfailure) aus.2722Wird ausgeführt, wenn der Haupt-Claude Code Agent mit der Antwort fertig ist. Wird nicht ausgeführt, wenn der Stopp aufgrund einer Benutzerunterbrechung auftrat. API-Fehler lösen stattdessen [StopFailure](#stopfailure) aus.

2733 2723

2734<Tip>2724<Tip>

2735 Der [`/goal`](/docs/de/goal) Befehl ist eine integrierte Abkürzung für einen Sitzungs-scoped Eingabeaufforderungs-basierten Stop-Hook. Verwenden Sie ihn, wenn Sie möchten, dass Claude auf eine Bedingung hinarbeitet, ohne Hook-Konfiguration zu schreiben.2725 Der [`/goal`](/docs/de/goal) Befehl ist eine integrierte Verknüpfung für einen Sitzungs-scoped Eingabeaufforderungs-basierten Stop-Hook. Verwenden Sie ihn, wenn Sie Claude weiterarbeiten lassen möchten, bis eine Bedingung erfüllt ist, ohne Hook-Konfiguration zu schreiben.

2736</Tip>2726</Tip>

2737 2727

2738<h4 id="stop-input">2728<h4 id="stop-input">

2739 Stop-Eingabe2729 Stop-Eingabe

2740</h4>2730</h4>

2741 2731

2742Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten Stop-Hooks `stop_hook_active`, `last_assistant_message`, `background_tasks` und `session_crons`. Das `stop_hook_active` Feld ist `true`, wenn Claude Code bereits als Ergebnis eines Stop-Hooks fortgesetzt wird. Überprüfen Sie diesen Wert oder verarbeiten Sie das Transkript, um zu vermeiden, auf einer Bedingung zu blockieren, die sich nie auflösen wird. Claude Code überschreibt den Hook und beendet den Zug nach 8 aufeinanderfolgenden Blockierungen.2732Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten Stop-Hooks `stop_hook_active`, `last_assistant_message`, `background_tasks` und `session_crons`. Das `stop_hook_active` Feld ist `true`, wenn Claude Code bereits aufgrund eines Stop-Hooks fortgesetzt wird. Überprüfen Sie diesen Wert oder verarbeiten Sie das Transkript, um zu vermeiden, auf einer Bedingung zu blockieren, die sich nie auflösen wird. Claude Code wendet eine 8-aufeinanderfolgende-Fortsetzungs-Obergrenze an: Nach Stop-Hooks, die den Zug achtmal hintereinander fortgesetzt haben, überschreibt Claude Code den nächsten Block und beendet den Zug. Um die Obergrenze zu erhöhen, setzen Sie [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/de/env-vars).

2743 2733

2744Das `last_assistant_message` Feld enthält den Textinhalt von Claudes letzter Antwort, daher können Hooks darauf zugreifen, ohne die Transkript-Datei zu analysieren. Für Hooks, die auf dem gerade abgeschlossenen Zug handeln, wie Vorlesen oder Benachrichtigungs-Hooks, verwenden Sie dieses Feld statt `transcript_path` zu lesen: Die Transkript-Datei ist nicht garantiert, die letzte Nachricht bei Stop-Zeit auf allen Versionen einzuschließen.2734Das `last_assistant_message` Feld enthält den Textinhalt von Claudes letzter Antwort, daher können Hooks darauf zugreifen, ohne die Transkript-Datei zu analysieren. Für Hooks, die auf dem gerade abgeschlossenen Zug handeln, wie Vorlesen oder Benachrichtigungs-Hooks, verwenden Sie dieses Feld statt `transcript_path` zu lesen: Die Transkript-Datei ist nicht garantiert, die letzte Nachricht zu diesem Stop-Zeitpunkt auf allen Versionen einzuschließen.

2745 2735

2746Die `background_tasks` und `session_crons` Arrays ermöglichen es Hooks, "Sitzung ist fertig" von "Sitzung ist pausiert und wartet auf Hintergrund-Arbeit, um sie aufzuwecken" zu unterscheiden. Beide Arrays sind vorhanden, wenn die Task-Registry erreichbar ist und sind leer, wenn nichts in Flug oder geplant ist.2736Die `background_tasks` und `session_crons` Arrays ermöglichen es Hooks, "Sitzung ist fertig" von "Sitzung ist pausiert und wartet auf Hintergrund-Arbeit, um sie aufzuwecken" zu unterscheiden. Beide Arrays sind vorhanden, wenn die Task-Registry erreichbar ist und sind leer, wenn nichts in Flug oder geplant ist.

2747 2737

2749 2739

2750| Feld | Beschreibung |2740| Feld | Beschreibung |

2751| :- | :- |2741| :- | :- |

2752| `id` | Aufgaben-Identifikator |2742| `id` | Aufgaben-Bezeichner |

2753| `type` | Freundliche Aufgaben-Typ-Beschriftung wie `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session` oder `MCP task`. Jede Beschriftung identifiziert, welche Claude Code Funktion die Aufgabe erstellt hat. Fällt auf den rohen Diskriminanten für unbekannte Typen zurück |2743| `type` | Freundliches Aufgaben-Typ-Label wie `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session` oder `MCP task`. Jedes Label identifiziert, welche Claude Code Funktion die Aufgabe erstellt hat. Fällt auf den rohen Diskriminanten für unbekannte Typen zurück |

2755| `description` | Freitext-Beschreibung, begrenzt auf 1000 Zeichen mit einem In-String `… [+N chars]` Marker, wenn gekürzt |2745| `description` | Freitext-Beschreibung, begrenzt auf 1000 Zeichen mit einem In-String `… [+N chars]` Marker, wenn gekürzt |

2761 2751

2762Jeder Eintrag in `session_crons` beschreibt einen Sitzungs-scoped geplanten Aufweck, stammt von `CronCreate`, `ScheduleWakeup` und `/loop`:2752Jeder Eintrag in `session_crons` beschreibt einen Sitzungs-scoped geplanten Aufwach-Aufruf, stammt von `CronCreate`, `ScheduleWakeup` und `/loop`:

2763 2753

2764| Feld | Beschreibung |2754| Feld | Beschreibung |

2765| :- | :- |2755| :- | :- |

2766| `id` | Cron-Aufgaben-Identifikator |2756| `id` | Cron-Aufgaben-Bezeichner |

2768| `recurring` | `false` für einmalige Aufwecke, deren Zeitplan eine einzelne Feuerzeit kodiert, `true` für Aufgaben, die bei jedem Treffer erneut feuern |2758| `recurring` | `false` für einmalige Aufwach-Aufrufe, deren Schedule eine einzelne Feuerzeit kodiert, `true` für Aufgaben, die bei jedem Treffer erneut feuern |

2769| `prompt` | Eingabeaufforderung, die eingereicht wird, wenn der Cron feuert, begrenzt auf 1000 Zeichen mit dem gleichen `… [+N chars]` Marker |2759| `prompt` | Eingabeaufforderung, die eingereicht wird, wenn der Cron feuert, begrenzt auf 1000 Zeichen mit dem gleichen `… [+N chars]` Marker |

2770 2760

2771Dieses Beispiel zeigt eine Stop-Eingabe mit einer laufenden Shell-Aufgabe und einem wiederkehrenden Cron:2761Dieses Beispiel zeigt eine Stop-Eingabe mit einer laufenden Shell-Aufgabe und einem wiederkehrenden Cron:

2812| `hookSpecificOutput.additionalContext` | Fehler-freies Feedback für Claude. Das Gespräch wird fortgesetzt, damit Claude darauf handeln kann, aber im Gegensatz zu `decision: "block"` wird es im Transkript als Hook-Feedback statt als Hook-Fehler angezeigt |2802| `hookSpecificOutput.additionalContext` | Fehler-freies Feedback für Claude. Das Gespräch wird fortgesetzt, damit Claude darauf handeln kann, aber im Gegensatz zu `decision: "block"` wird es im Transkript als Hook-Feedback statt als Hook-Fehler angezeigt |

2813 2803

2814Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `reason` weitergeleitet: Claude empfängt die stderr-Nachricht als Erklärung, warum es fortgesetzt werden sollte.2804Ein Hook, der durch Beendigung mit 2 blockiert, wird auf die gleiche Weise wie `reason` weitergeleitet: Claude empfängt die stderr-Nachricht als die Erklärung, warum es fortgesetzt werden sollte.

2815 2805

2816```json theme={null}2806```json theme={null}

2817{2807{

2820}2810}

2821```2811```

2822 2812

2823Verwenden Sie `additionalContext`, wenn der Hook wie beabsichtigt funktioniert und Claude Anleitung gibt, wie "führe die Test-Suite vor dem Beenden aus". Es hält das Gespräch durch die gleichen Loop-Schutzmaßnahmen wie `decision: "block"` am Laufen, nämlich die `stop_hook_active` Eingabe und die 8-aufeinanderfolgende-Fortsetzungs-Kappe, aber das Transkript kennzeichnet es als `Stop hook feedback` und es wird keine Hook-Fehler-Benachrichtigung angezeigt:2813Verwenden Sie `additionalContext`, wenn der Hook wie beabsichtigt funktioniert und Claude Anleitung gibt, wie "Führen Sie die Test-Suite aus, bevor Sie fertig sind". Es lässt das Gespräch durch die gleichen Loop-Schutzmaßnahmen wie `decision: "block"` gehen, nämlich die `stop_hook_active` Eingabe und die 8-aufeinanderfolgende-Fortsetzungs-Obergrenze, aber das Transkript kennzeichnet es als `Stop hook feedback` und es wird keine Hook-Fehler-Benachrichtigung angezeigt:

2824 2814

2825```json theme={null}2815```json theme={null}

2826{2816{

2835 StopFailure2825 StopFailure

2836</h3>2826</h3>

2837 2827

2838Wird statt [Stop](#stop) ausgeführt, wenn der Zug aufgrund eines API-Fehlers endet. Claude Code ignoriert die Ausgabe und den Exit-Code des Hooks, abgesehen von [`terminalSequence`](#emit-terminal-notifications). Verwenden Sie dies, um Fehler zu protokollieren, Warnungen zu senden oder Wiederherstellungsmaßnahmen zu ergreifen, wenn Claude aufgrund von Ratenlimits, Authentifizierungsproblemen oder anderen API-Fehlern keine Antwort abschließen kann.2828Wird statt [Stop](#stop) ausgeführt, wenn der Zug aufgrund eines API-Fehlers endet. Claude Code ignoriert die Ausgabe und den Exit-Code des Hooks, abgesehen von [`terminalSequence`](#emit-terminal-notifications). Verwenden Sie dies, um Fehler zu protokollieren, Warnungen zu senden oder Wiederherstellungsmaßnahmen zu ergreifen, wenn Claude aufgrund von Rate Limits, Authentifizierungsproblemen oder anderen API-Fehlern keine Antwort abschließen kann.

2839 2829

2840<h4 id="stopfailure-input">2830<h4 id="stopfailure-input">

2841 StopFailure-Eingabe2831 StopFailure-Eingabe

2842</h4>2832</h4>

2843 2833

2844Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten StopFailure-Hooks `error`, optional `error_details` und optional `last_assistant_message`. Das `error` Feld identifiziert den Fehlertyp und wird zum Filtern des Matchers verwendet.2834Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten StopFailure-Hooks `error`, optionalen `error_details` und optionalen `last_assistant_message`. Das `error` Feld identifiziert den Fehlertyp und wird zum Filtern des Matchers verwendet.

2845 2835

2846| Feld | Beschreibung |2836| Feld | Beschreibung |

2847| :- | :- |2837| :- | :- |

2848| `error` | Fehlertyp: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error` oder `unknown` |2838| `error` | Fehlertyp: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error` oder `unknown` |

2850| `last_assistant_message` | Der gerenderte Fehlertext, der im Gespräch angezeigt wird. Im Gegensatz zu `Stop` und `SubagentStop`, wo dieses Feld Claudes Gesprächsausgabe enthält, enthält es für `StopFailure` die API-Fehler-Zeichenkette selbst, wie `"API Error: Rate limit reached"` |2840| `last_assistant_message` | Der gerenderte Fehlertext, der im Gespräch angezeigt wird. Im Gegensatz zu `Stop` und `SubagentStop`, wo dieses Feld Claudes Gesprächsausgabe hält, enthält es für `StopFailure` die API-Fehler-Zeichenkette selbst, wie `"API Error: Rate limit reached"` |

2851 2841

2852```json theme={null}2842```json theme={null}

2853{2843{

2867 TeammateIdle2857 TeammateIdle

2868</h3>2858</h3>

2869 2859

2870Wird ausgeführt, wenn ein [Agent-Team](/docs/de/agent-teams) Teamkollege nach Abschluss seines Zugs untätig wird. Verwenden Sie dies, um Qualitäts-Gates durchzusetzen, bevor ein Teamkollege die Arbeit einstellt, wie das Erfordern bestandener Lint-Überprüfungen oder das Überprüfen, dass Ausgabe-Dateien existieren.2860Wird ausgeführt, wenn ein [Agent-Team](/docs/de/agent-teams) Teamkollege nach Beendigung seines Zugs untätig wird. Verwenden Sie dies, um Qualitäts-Gates durchzusetzen, bevor ein Teamkollege aufhört zu arbeiten, wie das Erfordern bestandener Lint-Überprüfungen oder das Überprüfen, dass Ausgabe-Dateien existieren.

2871 2861

2872TeammateIdle-Hooks unterstützen keine Matcher und werden bei jedem Vorkommen ausgeführt.2862TeammateIdle-Hooks unterstützen keine Matcher und werden bei jedem Vorkommen ausgelöst.

2873 2863

2874<h4 id="teammateidle-input">2864<h4 id="teammateidle-input">

2875 TeammateIdle-Eingabe2865 TeammateIdle-Eingabe

2922 2912

2923Wird ausgeführt, wenn sich eine Konfigurationsdatei während einer Sitzung ändert. Verwenden Sie dies, um Einstellungs-Änderungen zu überprüfen, Sicherheitsrichtlinien durchzusetzen oder nicht autorisierte Änderungen an Konfigurationsdateien zu blockieren.2913Wird ausgeführt, wenn sich eine Konfigurationsdatei während einer Sitzung ändert. Verwenden Sie dies, um Einstellungs-Änderungen zu überprüfen, Sicherheitsrichtlinien durchzusetzen oder nicht autorisierte Änderungen an Konfigurationsdateien zu blockieren.

2924 2914

2925Claude Code führt ConfigChange-Hooks aus, wenn sich eine Einstellungsdatei, eine verwaltete Richtlinien-Datei oder eine Skill-Datei ändert. Für verwaltete Richtlinien wird es nur ausgeführt, wenn `managed-settings.json` oder eine Datei in `managed-settings.d/` sich ändert. Es wendet [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) und Änderungen an macOS verwalteten Einstellungen oder Windows Registry-Richtlinien ohne Ausführung an. Auf WSL mit [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) wendet es auch eine geänderte Windows-seitige verwaltete Einstellungsdatei bei seiner Richtlinien-Abfrage ohne Ausführung an.2915Claude Code führt ConfigChange-Hooks aus, wenn sich eine Einstellungsdatei, eine verwaltete Richtlinien-Datei oder eine Skill-Datei ändert. Für verwaltete Richtlinien führt es sie nur aus, wenn sich `managed-settings.json` oder eine Datei in `managed-settings.d/` ändert. Es wendet [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) und Änderungen an macOS verwalteten Einstellungen oder Windows Registry-Richtlinien ohne Ausführung an. Auf WSL mit [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) wendet es auch eine geänderte Windows-seitige verwaltete Einstellungsdatei bei seiner Richtlinien-Abfrage ohne Ausführung an.

2926 2916

2927Der Matcher filtert auf die Konfigurationsquelle:2917Der Matcher filtert auf die Konfigurationsquelle:

2928 2918

2936 2926

2937Dieses Beispiel protokolliert alle Konfigurationsänderungen für Sicherheits-Audits:2927Dieses Beispiel protokolliert alle Konfigurationsänderungen für Sicherheits-Auditing:

2938 2928

2939```json theme={null}2929```json theme={null}

2940{2930{

2958 ConfigChange-Eingabe2948 ConfigChange-Eingabe

2959</h4>2949</h4>

2960 2950

2961Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten ConfigChange-Hooks `source` und optional `file_path`. Das `source` Feld gibt an, welcher Konfigurationstyp sich geändert hat, und `file_path` stellt den Pfad zur spezifischen Datei bereit, die geändert wurde.2951Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten ConfigChange-Hooks `source` und optional `file_path`. Das `source` Feld gibt an, welcher Konfigurationstyp sich geändert hat, und `file_path` gibt den Pfad zur spezifischen Datei an, die geändert wurde.

2962 2952

2963```json theme={null}2953```json theme={null}

2964{2954{

2979 2969

2980| Feld | Beschreibung |2970| Feld | Beschreibung |

2981| :- | :- |2971| :- | :- |

2982| `decision` | `"block"` verhindert, dass die Konfigurationsänderung angewendet wird. Weglassen, um die Änderung zu erlauben |2972| `decision` | `"block"` verhindert, dass die Konfigurationsänderung angewendet wird. Weglassen, um die Änderung zuzulassen |

2984 2974

2985```json theme={null}2975```json theme={null}

2989}2979}

2990```2980```

2991 2981

2992`policy_settings` Änderungen können nicht blockiert werden. Hooks werden immer noch für `policy_settings` Quellen ausgeführt, wenn sich eine verwaltete Einstellungsdatei auf der Maschine ändert, daher können Sie sie verwenden, um diese Bearbeitungen zu protokollieren, aber jede Blockierungs-Entscheidung wird ignoriert. Dies stellt sicher, dass unternehmens-verwaltete Einstellungen immer wirksam werden. Claude Code führt `ConfigChange` Hooks nicht aus, wenn [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) ankommen oder aktualisiert werden.2982`policy_settings` Änderungen können nicht blockiert werden. Hooks werden immer noch für `policy_settings` Quellen ausgelöst, wenn sich eine verwaltete Einstellungsdatei auf der Maschine ändert, daher können Sie sie verwenden, um diese Bearbeitungen zu protokollieren, aber jede Blockierungs-Entscheidung wird ignoriert. Dies stellt sicher, dass unternehmens-verwaltete Einstellungen immer wirksam werden. Claude Code führt `ConfigChange` Hooks nicht aus, wenn [Server-verwaltete Einstellungen](/docs/de/server-managed-settings) ankommen oder aktualisiert werden.

2993 2983

2994Claude Code handelt die Blockierungs-Entscheidung aus der JSON-Ausgabe eines ConfigChange-Hooks und verwirft `systemMessage` und `continue`. Eine blockierte Änderung zeigt keine Nachricht für Sie oder Claude, ob Sie mit `reason` oder mit stderr bei Beendigung mit 2 blockieren. Claude Code schreibt nur eine Zeile in das Debug-Protokoll.2984Claude Code handelt auf die Blockierungs-Entscheidung aus der JSON-Ausgabe eines ConfigChange-Hooks und verwirft `systemMessage` und `continue`. Eine blockierte Änderung zeigt keine Nachricht für Sie oder Claude, ob Sie mit `reason` oder mit stderr bei Exit 2 blockieren. Claude Code schreibt nur eine Zeile ins Debug-Protokoll.

2995 2985

2996<h3 id="cwdchanged">2986<h3 id="cwdchanged">

2997 CwdChanged2987 CwdChanged

2998</h3>2988</h3>

2999 2989

3000Wird ausgeführt, wenn ein Shell-Befehl in der Hauptkonversation das Arbeitsverzeichnis ändert, z. B. wenn Claude einen `cd` Befehl ausführt. Verwenden Sie dies, um auf Verzeichniswechsel zu reagieren: Umgebungsvariablen neu laden, projektspezifische Toolchains aktivieren oder Setup-Skripte automatisch ausführen. Paart mit [FileChanged](#filechanged) für Tools wie [direnv](https://direnv.net/), die Pro-Verzeichnis-Umgebung verwalten.2990Wird ausgeführt, wenn ein Shell-Befehl in der Hauptkonversation das Arbeitsverzeichnis ändert, z. B. wenn Claude einen `cd` Befehl ausführt. Verwenden Sie dies, um auf Verzeichnis-Änderungen zu reagieren: Umgebungsvariablen neu laden, projekt-spezifische Toolchains aktivieren oder Setup-Skripte automatisch ausführen. Paart mit [FileChanged](#filechanged) für Tools wie [direnv](https://direnv.net/), die pro-Verzeichnis-Umgebung verwalten.

3001 2991

3002CwdChanged-Hooks haben Zugriff auf [`CLAUDE_ENV_FILE`](#persist-environment-variables). Variablen, die in diese Datei geschrieben werden, bleiben in nachfolgenden Bash-Befehlen bestehen, bis zum nächsten CwdChanged-Ereignis, wenn Claude Code sie löscht.2992CwdChanged-Hooks haben Zugriff auf [`CLAUDE_ENV_FILE`](#persist-environment-variables). Variablen, die in diese Datei geschrieben werden, bleiben in nachfolgenden Bash-Befehlen bis zum nächsten CwdChanged-Ereignis erhalten, wenn Claude Code sie löscht.

3003 2993

3004CwdChanged unterstützt keine Matcher und wird bei jedem Vorkommen ausgeführt.2994CwdChanged unterstützt keine Matcher und wird bei jedem Vorkommen ausgelöst.

3005 2995

3006<h4 id="cwdchanged-input">2996<h4 id="cwdchanged-input">

3007 CwdChanged-Eingabe2997 CwdChanged-Eingabe

3030| :- | :- |3020| :- | :- |

3031| `watchPaths` | Array von absoluten Pfaden. Ersetzt die aktuelle dynamische Überwachungsliste. Pfade aus Ihrer `matcher` Konfiguration werden immer überwacht. Das Zurückgeben eines leeren Arrays löscht die dynamische Liste, was typisch ist, wenn ein neues Verzeichnis betreten wird |3021| `watchPaths` | Array von absoluten Pfaden. Ersetzt die aktuelle dynamische Überwachungsliste. Pfade aus Ihrer `matcher` Konfiguration werden immer überwacht. Das Zurückgeben eines leeren Arrays löscht die dynamische Liste, was typisch ist, wenn ein neues Verzeichnis betreten wird |

3032 3022

3033CwdChanged-Hooks haben keine Entscheidungskontrolle. Sie können den Verzeichniswechsel nicht blockieren.3023CwdChanged-Hooks haben keine Entscheidungskontrolle. Sie können die Verzeichnis-Änderung nicht blockieren.

3034 3024

3035Claude Code liest `watchPaths` und `systemMessage` aus ihrer JSON-Ausgabe und verwirft `continue`. In interaktiven Sitzungen zeigt es die `systemMessage` als kurze Terminal-Benachrichtigung. Die Nachricht erreicht nicht den SDK-Nachrichtenstrom.3025Claude Code liest `watchPaths` und `systemMessage` aus ihrer JSON-Ausgabe und verwirft `continue`. In interaktiven Sitzungen zeigt es die `systemMessage` als kurze Terminal-Benachrichtigung. Die Nachricht erreicht nicht den SDK-Nachrichtenstrom.

3036 3026

3040 3030

3041Wird ausgeführt, nachdem Sie ein Arbeitsverzeichnis während einer Sitzung mit dem `/add-dir` Befehl hinzufügen oder nachdem ein SDK-Client eines mit der `register_repo_root` Kontroll-Anfrage hinzufügt. Verwenden Sie dies, um ein neu hinzugefügtes Repository vorzubereiten, z. B. durch Installation seiner Abhängigkeiten.3031Wird ausgeführt, nachdem Sie ein Arbeitsverzeichnis während einer Sitzung mit dem `/add-dir` Befehl hinzufügen oder nachdem ein SDK-Client eines mit der `register_repo_root` Kontroll-Anfrage hinzufügt. Verwenden Sie dies, um ein neu hinzugefügtes Repository vorzubereiten, z. B. durch Installation seiner Abhängigkeiten.

3042 3032

3043Claude Code führt dieses Ereignis nicht aus, wenn:3033Claude Code löst dieses Ereignis nicht aus, wenn:

3044 3034

3045* Sie ein Verzeichnis mit dem `--add-dir` Start-Flag übergeben; [SessionStart](#sessionstart) deckt diese Verzeichnisse ab3035* Sie ein Verzeichnis mit dem `--add-dir` Start-Flag übergeben; [SessionStart](#sessionstart) deckt diese Verzeichnisse ab

3046* Sie ein Verzeichnis auf der `/permissions` Workspace-Registerkarte hinzufügen3036* Sie ein Verzeichnis auf der `/permissions` Workspace-Registerkarte hinzufügen

3047* Sie ein Verzeichnis hinzufügen, das bereits ein Arbeitsverzeichnis ist oder in einem liegt3037* Sie ein Verzeichnis hinzufügen, das bereits ein Arbeitsverzeichnis ist oder sich in einem befindet

3048 3038

3049Claude Code führt DirectoryAdded aus, nachdem Sandbox- und Berechtigungsstatus aktualisiert wurden, daher sehen Sandbox-Tools das neue Verzeichnis bereits, wenn Ihr Hook ausgeführt wird. Hook-Befehle selbst werden unsandboxed ausgeführt.3039Claude Code führt DirectoryAdded aus, nachdem Sandbox- und Berechtigungsstatus aktualisiert wurden, daher sehen Sandbox-Tools das neue Verzeichnis bereits, wenn Ihr Hook läuft. Hook-Befehle selbst laufen unsandboxed.

3050 3040

3051Claude Code wartet nicht auf den Hook: Das Hinzufügen wird sofort abgeschlossen und der Hook wird im Hintergrund mit dem 600-Sekunden-Standard-Timeout ausgeführt.3041Claude Code wartet nicht auf den Hook: Das Hinzufügen wird sofort abgeschlossen und der Hook läuft im Hintergrund mit dem 600-Sekunden-Standard-Timeout.

3052 3042

3053Der Matcher filtert, wie das Verzeichnis hinzugefügt wurde:3043Der Matcher filtert, wie das Verzeichnis hinzugefügt wurde:

3054 3044

3079}3069}

3080```3070```

3081 3071

3082DirectoryAdded-Hooks haben keine Entscheidungskontrolle. Sie können das Hinzufügen nicht blockieren, das bereits abgeschlossen ist, wenn der Hook ausgeführt wird. Claude Code verwirft das `continue` Feld aus ihrer JSON-Ausgabe und zeigt den Rest unterschiedlich pro Quelle:3072DirectoryAdded-Hooks haben keine Entscheidungskontrolle. Sie können das Hinzufügen nicht blockieren, das bereits abgeschlossen ist, wenn der Hook läuft. Claude Code verwirft das `continue` Feld aus ihrer JSON-Ausgabe und zeigt den Rest unterschiedlich pro Quelle:

3083 3073

3084* `slash_command`: Claude Code liefert den `systemMessage` des Hooks an Claude als Kontext beim nächsten Gesprächszug, anstatt ihn Ihnen zu zeigen. Eine Anzahl fehlgeschlagener Hooks erscheint im Transkript. Vollständige Fehlerausgabe geht zum Debug-Protokoll3074* `slash_command`: Claude Code liefert die `systemMessage` des Hooks an Claude als Kontext beim nächsten Gesprächszug, anstatt sie Ihnen zu zeigen. Eine Anzahl fehlgeschlagener Hooks erscheint im Transkript. Vollständige Fehlerausgabe geht ins Debug-Protokoll

3085* `register_repo_root`: Claude Code schreibt `systemMessage` Ausgabe und Fehlerausgabe nur zum Debug-Protokoll3075* `register_repo_root`: Claude Code schreibt `systemMessage` Ausgabe und Fehlerausgabe nur ins Debug-Protokoll

3086 3076

3087<h3 id="filechanged">3077<h3 id="filechanged">

3088 FileChanged3078 FileChanged

3089</h3>3079</h3>

3090 3080

3091Wird ausgeführt, wenn sich eine überwachte Datei auf der Festplatte ändert. Claude Code erkennt Änderungen mit einem Dateisystem-Watcher, nicht durch Überprüfung von Tool-Aufrufen, daher wird der Hook unabhängig davon ausgeführt, was die Datei geändert hat: ein `Edit` oder `Write` Tool-Aufruf, ein Skript, das Claude mit `Bash` ausführt, oder ein Prozess außerhalb von Claude Code. Ein häufiger Anwendungsfall ist das Neuladen von Umgebungsvariablen, wenn sich Projekt-Konfigurationsdateien ändern.3081Wird ausgeführt, wenn sich eine überwachte Datei auf der Festplatte ändert. Claude Code erkennt Änderungen mit einem Dateisystem-Watcher, nicht durch Überprüfung von Tool-Aufrufen, daher führt es den Hook aus, egal was die Datei geändert hat: Ein `Edit` oder `Write` Tool-Aufruf, ein Skript, das Claude mit `Bash` ausführt, oder ein Prozess außerhalb von Claude Code. Ein häufiger Anwendungsfall ist das Neuladen von Umgebungsvariablen, wenn sich Projekt-Konfigurationsdateien ändern.

3092 3082

3093Der `matcher` für dieses Ereignis dient zwei Rollen:3083Der `matcher` für dieses Ereignis dient zwei Rollen:

3094 3084

3095* **Erstelle die Überwachungsliste**: Der Wert wird auf `|` aufgeteilt und jedes Segment wird als wörtlicher Dateiname im Arbeitsverzeichnis registriert, daher überwacht `".envrc|.env"` genau diese zwei Dateien. Regex-Muster sind hier nicht nützlich: Ein Wert wie `^\.env` würde eine Datei wörtlich namens `^\.env` überwachen.3085* **Überwachungsliste erstellen**: Der Wert wird auf `|` aufgeteilt und jedes Segment wird als wörtlicher Dateiname im Arbeitsverzeichnis registriert, daher überwacht `".envrc|.env"` genau diese zwei Dateien. Regex-Muster sind hier nicht nützlich: Ein Wert wie `^\.env` würde eine Datei wörtlich namens `^\.env` überwachen.

3096* **Filtere, welche Hooks ausgeführt werden**: Wenn sich eine überwachte Datei ändert, wird der gleiche Wert verwendet, um zu filtern, welche Hook-Gruppen mit den Standard-[Matcher-Regeln](#matcher-patterns) gegen den Dateinamen der geänderten Datei ausgeführt werden.3086* **Filtern, welche Hooks laufen**: Wenn sich eine überwachte Datei ändert, filtert der gleiche Wert, welche Hook-Gruppen mit den Standard-[Matcher-Regeln](#matcher-patterns) gegen den Basis-Namen der geänderten Datei laufen.

3097 3087

3098Dieses Beispiel normalisiert Zeilenumbrüche in `data.csv` nach jeder Änderung, einschließlich eines `Bash` Befehls oder eines externen Skripts, das die Datei umschreibt:3088Dieses Beispiel normalisiert Zeilenumbrüche in `data.csv` nach jeder Änderung, einschließlich eines `Bash` Befehls oder eines externen Skripts, das die Datei umschreibt:

3099 3089

3115}3105}

3116```3106```

3117 3107

3118Der Hook liest den geänderten Dateipfad aus dem `file_path` Feld der [JSON-Eingabe](#filechanged-input) von stdin. Seine `grep` Wache testet auf das gleiche, das `perl` entfernt, einen CR am Ende einer Zeile, daher wird der Lauf nach einer Normalisierung beendet, ohne die Datei zu berühren. Eine lockere Wache schleift für immer, weil `perl -i` die Datei umschreibt, auch wenn es nichts ersetzt und Claude Code den Hook nach jedem Umschreiben erneut ausführt. Speichern Sie dieses Skript unter `/path/to/normalize-line-endings.sh` und machen Sie es ausführbar:3108Der Hook liest den geänderten Dateipfad aus dem `file_path` Feld der [JSON-Eingabe](#filechanged-input) von stdin. Seine `grep` Wache testet auf das gleiche, das `perl` entfernt, ein CR am Ende einer Zeile, daher beendet sich der Lauf nach einer Normalisierung, ohne die Datei zu berühren. Eine lockere Wache schleift für immer, weil `perl -i` die Datei umschreibt, auch wenn es nichts ersetzt und Claude Code den Hook nach jedem Umschreiben erneut ausführt. Speichern Sie dieses Skript unter `/path/to/normalize-line-endings.sh` und machen Sie es ausführbar:

3119 3109

3120```bash theme={null}3110```bash theme={null}

3121#!/bin/bash3111#!/bin/bash

3127 3117

3128Um zu bestätigen, dass der Hook funktioniert, bitten Sie Claude, eine CRLF-Zeile mit einem `Bash` Befehl zu `data.csv` anzuhängen. Claude Code führt den Hook aus und die Datei endet mit LF-Umbrüchen.3118Um zu bestätigen, dass der Hook funktioniert, bitten Sie Claude, eine CRLF-Zeile mit einem `Bash` Befehl zu `data.csv` anzuhängen. Claude Code führt den Hook aus und die Datei endet mit LF-Umbrüchen.

3129 3119

3130Um Dateien zu überwachen, die Sie nicht im Voraus benennen können, geben Sie [`watchPaths`](#filechanged-output) von einem Hook zurück, um die Überwachungsliste dynamisch zu aktualisieren. Claude Code startet den Watcher nur, wenn etwas eine Datei zum Überwachen benennt, daher seeden Sie die Liste mit einer FileChanged-Gruppe, deren Matcher mindestens eine Datei benennt, oder mit einem [SessionStart](#sessionstart-decision-control) oder [CwdChanged](#cwdchanged) Hook, der `watchPaths` zurückgibt. Der Matcher filtert immer noch, welche Hook-Gruppen ausgeführt werden, wenn sich eine überwachte Datei ändert, daher geben Sie der Gruppe, die dynamische Pfade verarbeitet, einen weggelassenen Matcher, der jede überwachte Datei abgleicht und nichts zur Überwachungsliste hinzufügt. Ein `"*"` Matcher gleicht auch jede Datei ab, aber Claude Code registriert ihn in der Überwachungsliste wie jeden anderen Wert, als wörtliche Datei namens `*`.3120Um Dateien zu überwachen, die Sie nicht im Voraus benennen können, geben Sie [`watchPaths`](#filechanged-output) von einem Hook zurück, um die Überwachungsliste dynamisch zu aktualisieren. Claude Code startet den Watcher nur, wenn etwas eine Datei zum Überwachen benennt, daher säen Sie die Liste mit einer FileChanged-Gruppe, deren Matcher mindestens eine Datei benennt, oder mit einem [SessionStart](#sessionstart-decision-control) oder [CwdChanged](#cwdchanged) Hook, der `watchPaths` zurückgibt. Der Matcher filtert immer noch, welche Hook-Gruppen laufen, wenn sich eine überwachte Datei ändert, daher geben Sie der Gruppe, die dynamische Pfade verarbeitet, einen weggelassenen Matcher, der jede überwachte Datei abgleicht und nichts zur Überwachungsliste hinzufügt. Ein `"*"` Matcher gleicht auch jede Datei ab, aber Claude Code registriert ihn in der Überwachungsliste wie jeden anderen Wert, als wörtliche Datei namens `*`.

3131 3121

3132FileChanged-Hooks haben Zugriff auf [`CLAUDE_ENV_FILE`](#persist-environment-variables). Variablen, die in diese Datei geschrieben werden, bleiben in nachfolgenden Bash-Befehlen bestehen, bis zum nächsten [CwdChanged](#cwdchanged) Ereignis, wenn Claude Code sie löscht.3122FileChanged-Hooks haben Zugriff auf [`CLAUDE_ENV_FILE`](#persist-environment-variables). Variablen, die in diese Datei geschrieben werden, bleiben in nachfolgenden Bash-Befehlen bis zum nächsten [CwdChanged](#cwdchanged) Ereignis erhalten, wenn Claude Code sie löscht.

3133 3123

3134<h4 id="filechanged-input">3124<h4 id="filechanged-input">

3135 FileChanged-Eingabe3125 FileChanged-Eingabe

3163| :- | :- |3153| :- | :- |

3164| `watchPaths` | Array von absoluten Pfaden. Ersetzt die aktuelle dynamische Überwachungsliste. Pfade aus Ihrer `matcher` Konfiguration werden immer überwacht. Verwenden Sie dies, wenn Ihr Hook-Skript basierend auf der geänderten Datei zusätzliche Dateien zum Überwachen entdeckt |3154| `watchPaths` | Array von absoluten Pfaden. Ersetzt die aktuelle dynamische Überwachungsliste. Pfade aus Ihrer `matcher` Konfiguration werden immer überwacht. Verwenden Sie dies, wenn Ihr Hook-Skript basierend auf der geänderten Datei zusätzliche Dateien zum Überwachen entdeckt |

3165 3155

3166FileChanged-Hooks haben keine Entscheidungskontrolle. Sie können die Dateiänderung nicht blockieren.3156FileChanged-Hooks haben keine Entscheidungskontrolle. Sie können die Datei-Änderung nicht blockieren.

3167 3157

3168Claude Code liest `watchPaths` und `systemMessage` aus ihrer JSON-Ausgabe und verwirft `continue`. In interaktiven Sitzungen zeigt es die `systemMessage` als kurze Terminal-Benachrichtigung. Die Nachricht erreicht nicht den SDK-Nachrichtenstrom.3158Claude Code liest `watchPaths` und `systemMessage` aus ihrer JSON-Ausgabe und verwirft `continue`. In interaktiven Sitzungen zeigt es die `systemMessage` als kurze Terminal-Benachrichtigung. Die Nachricht erreicht nicht den SDK-Nachrichtenstrom.

3169 3159

3171 WorktreeCreate3161 WorktreeCreate

3172</h3>3162</h3>

3173 3163

3174Wird ausgeführt, wenn ein Worktree erstellt wird, ob von `claude --worktree`, von einem [Subagenten mit `isolation: "worktree"`](/docs/de/sub-agents#choose-the-subagent-scope) oder für eine [Hintergrund-Sitzung](/docs/de/agent-view#how-file-edits-are-isolated), die Claude Code in ihrem eigenen Worktree isoliert. Standardmäßig erstellt Claude Code die isolierte Arbeitskopie mit `git worktree`. Das Konfigurieren eines WorktreeCreate-Hooks ersetzt dieses Standard-Git-Verhalten, sodass Sie ein anderes Versionskontrollsystem wie SVN, Perforce oder Mercurial verwenden können.3164Wird ausgeführt, wenn ein Worktree erstellt wird, ob von `claude --worktree`, von einem [Subagent mit `isolation: "worktree"`](/docs/de/sub-agents#choose-the-subagent-scope) oder für eine [Hintergrund-Sitzung](/docs/de/agent-view#how-file-edits-are-isolated), die Claude Code in ihrem eigenen Worktree isoliert. Standardmäßig erstellt Claude Code die isolierte Arbeitskopie mit `git worktree`. Das Konfigurieren eines WorktreeCreate-Hooks ersetzt dieses Standard-Git-Verhalten und ermöglicht es Ihnen, ein anderes Versionskontrollsystem wie SVN, Perforce oder Mercurial zu verwenden.

3175 3165

3176Da der Hook das Standard-Verhalten 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.3166Da der Hook das Standard-Verhalten vollständig ersetzt, wird [`.worktreeinclude`](/docs/de/worktrees#copy-gitignored-files-into-worktrees) nicht verarbeitet. Wenn Sie lokale Konfigurationsdateien wie `.env` in das neue Worktree kopieren müssen, tun Sie dies in Ihrem Hook-Skript.

3177 3167

3178Der Hook muss den Pfad zum erstellten Worktree-Verzeichnis zurückgeben. Claude Code verwendet diesen Pfad als Arbeitsverzeichnis für die isolierte Sitzung. Siehe [WorktreeCreate-Ausgabe](#worktreecreate-output), wie jeder Hook-Typ den Pfad zurückgibt.3168Der Hook muss den Pfad zum erstellten Worktree-Verzeichnis zurückgeben. Claude Code verwendet diesen Pfad als Arbeitsverzeichnis für die isolierte Sitzung. Siehe [WorktreeCreate-Ausgabe](#worktreecreate-output) für wie jeder Hook-Typ den Pfad zurückgibt.

3179 3169

3180Claude Code handelt den Erfolg des Hooks und den zurückgegebenen Pfad und verwirft `systemMessage` und `continue`.3170Claude Code handelt auf den Erfolg des Hooks und den zurückgegebenen Pfad und verwirft `systemMessage` und `continue`.

3181 3171

3182Dieses Beispiel erstellt eine SVN-Arbeitskopie und druckt den Pfad für Claude Code zur Verwendung. Ersetzen Sie die Repository-URL durch Ihre eigene:3172Dieses Beispiel erstellt eine SVN-Arbeitskopie und druckt den Pfad für Claude Code zur Verwendung. Ersetzen Sie die Repository-URL durch Ihre eigene:

3183 3173

3198}3188}

3199```3189```

3200 3190

3201Der Hook liest den Worktree `name` aus der JSON-Eingabe von stdin, checkt eine frische Kopie in ein neues Verzeichnis aus und druckt den Verzeichnispath. Das `echo` auf der letzten Zeile ist das, was Claude Code als Worktree-Pfad liest. Leiten Sie jede andere Ausgabe zu stderr um, damit sie nicht mit dem Pfad interferiert.3191Der Hook liest den Worktree `name` aus der JSON-Eingabe von stdin, checkt eine frische Kopie in ein neues Verzeichnis aus und druckt den Verzeichnis-Pfad. Das `echo` auf der letzten Zeile ist das, was Claude Code als Worktree-Pfad liest. Leiten Sie jede andere Ausgabe zu stderr um, damit sie nicht mit dem Pfad interferiert.

3202 3192

3203<h4 id="worktreecreate-input">3193<h4 id="worktreecreate-input">

3204 WorktreeCreate-Eingabe3194 WorktreeCreate-Eingabe

3205</h4>3195</h4>

3206 3196

3207Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten WorktreeCreate-Hooks das `name` Feld. Dies ist ein Slug-Identifikator für den neuen Worktree, entweder vom Benutzer angegeben oder automatisch generiert, z. B. `bold-oak-a3f2`.3197Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten WorktreeCreate-Hooks das `name` Feld. Dies ist ein Slug-Bezeichner für das neue Worktree, entweder vom Benutzer angegeben oder automatisch generiert, z. B. `bold-oak-a3f2`.

3208 3198

3209```json theme={null}3199```json theme={null}

3210{3200{

3220 WorktreeCreate-Ausgabe3210 WorktreeCreate-Ausgabe

3221</h4>3211</h4>

3222 3212

3223WorktreeCreate-Hooks verwenden nicht das Standard-Erlauben/Blockieren-Entscheidungsmodell. Stattdessen bestimmt der Erfolg oder Fehler des Hooks das Ergebnis. Der Hook muss den Pfad zum erstellten Worktree-Verzeichnis zurückgeben:3213WorktreeCreate-Hooks verwenden nicht das Standard-Zulassen/Blockieren-Entscheidungsmodell. Stattdessen bestimmt der Erfolg oder Fehler des Hooks das Ergebnis. Der Hook muss den Pfad zum erstellten Worktree-Verzeichnis zurückgeben:

3224 3214

3225* **Command-Hooks** (`type: "command"`): Drucken Sie den Pfad als letzte nicht-leere Zeile von stdout. Claude Code entfernt ANSI-Escape-Codes, bevor diese Zeile gelesen wird, daher werden Shell-Start-Banner, die vor Ihrem `echo` gedruckt werden, ignoriert. Leiten Sie jede andere Hook-Ausgabe zu stderr um.3215* **Command-Hooks** (`type: "command"`): Drucken Sie den Pfad als letzte nicht-leere Zeile von stdout. Claude Code entfernt ANSI-Escape-Codes, bevor diese Zeile gelesen wird, daher werden Shell-Start-Banner, die vor Ihrem `echo` gedruckt werden, ignoriert. Leiten Sie jede andere Hook-Ausgabe zu stderr um.

3226* **HTTP-Hooks** (`type: "http"`): Geben Sie `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` im Antwort-Body zurück.3216* **HTTP-Hooks** (`type: "http"`): Geben Sie `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` im Antwort-Body zurück.

3227 3217

3228Wenn der Hook fehlschlägt oder keinen Pfad erzeugt, schlägt die Worktree-Erstellung mit einem Fehler fehl.3218Wenn der Hook fehlschlägt oder keinen Pfad erzeugt, schlägt die Worktree-Erstellung mit einem Fehler fehl.

3229 3219

3230Claude Code löst einen relativen Pfad gegen das Verzeichnis auf, in dem der Hook lief, und bricht alle `.` oder `..` Segmente darin zusammen. Wenn der resultierende Pfad kein Verzeichnis ist, das Claude Code betreten kann, druckt die Sitzung einen Fehler, der den Pfad benennt, und beendet sich mit Code 1.3220Claude Code löst einen relativen Pfad gegen das Verzeichnis auf, in dem der Hook lief, und bricht alle `.` oder `..` Segmente darin zusammen. Wenn der resultierende Pfad kein Verzeichnis ist, das Claude Code betreten kann, druckt die Sitzung einen Fehler, der den Pfad benennt und beendet sich mit Code 1.

3231 3221

3232Claude Code lehnt einen absoluten Pfad ab, der `.` oder `..` Segmente enthält, und jeden Pfad, der durch einen Symlink unterhalb der Repository-Root geht, da ein Symlink, der zum Repository committed ist, den Worktree außerhalb davon umleiten könnte. Der Fehler benennt die abgelehnte Komponente. Geben Sie einen normalisierten Pfad zurück, der nicht durch einen Symlink im Repository geht. Vor v2.1.216 folgte die Worktree-Erstellung dem Pfad des Hooks ohne diese Überprüfung.3222Claude Code lehnt einen absoluten Pfad ab, der `.` oder `..` Segmente enthält, und jeden Pfad, der unter dem Repository-Root durch einen Symlink geht, da ein Symlink, der im Repository committed ist, das Worktree außerhalb davon umleiten könnte. Der Fehler benennt die abgelehnte Komponente. Geben Sie einen normalisierten Pfad zurück, der nicht durch einen Symlink im Repository geht. Vor v2.1.216 folgte die Worktree-Erstellung dem Pfad des Hooks ohne diese Überprüfung.

3233 3223

3234<h3 id="worktreeremove">3224<h3 id="worktreeremove">

3235 WorktreeRemove3225 WorktreeRemove

3236</h3>3226</h3>

3237 3227

3238Wird ausgeführt, wenn ein Worktree entfernt wird. Dies ist das Bereinigungsgegenüber zu [WorktreeCreate](#worktreecreate). Das Ereignis wird ausgeführt, wenn:3228Wird ausgeführt, wenn ein Worktree entfernt wird. Dies ist das Aufräum-Gegenstück zu [WorktreeCreate](#worktreecreate). Das Ereignis wird ausgelöst, wenn:

3239 3229

3240* Sie eine `--worktree` Sitzung beenden und wählen, sie zu entfernen3230* Sie eine `--worktree` Sitzung beenden und wählen, sie zu entfernen

3241* Ein Subagent mit `isolation: "worktree"` beendet3231* Ein Subagent mit `isolation: "worktree"` beendet wird

3242* Sie eine [Hintergrund-Sitzung](/docs/de/agent-view#what-deleting-a-session-removes) löschen, deren Worktree der Hook erstellt hat3232* Sie eine [Hintergrund-Sitzung](/docs/de/agent-view#what-deleting-a-session-removes) löschen, deren Worktree der Hook erstellt hat

3243 3233

3244Für Git-basierte Worktrees verarbeitet Claude Code die Bereinigung automatisch mit `git worktree remove`. Wenn Sie einen WorktreeCreate-Hook für ein nicht-Git-Versionskontrollsystem konfiguriert haben, paaren Sie ihn mit einem WorktreeRemove-Hook, um die Bereinigung zu verarbeiten. Ohne einen wird das Worktree-Verzeichnis auf der Festplatte gelassen.3234Für Git-basierte Worktrees verarbeitet Claude Code das Aufräumen automatisch mit `git worktree remove`. Wenn Sie einen WorktreeCreate-Hook konfiguriert haben, paaren Sie ihn mit einem WorktreeRemove-Hook, um das Aufräumen der Worktrees zu steuern, die er erstellt:

3235

3236* **Kein WorktreeRemove-Hook**: Wenn Sie eine `--worktree` Sitzung beenden und Entfernung wählen, fällt Claude Code auf `git worktree remove --force` auf dem Pfad zurück, den Ihr WorktreeCreate-Hook zurückgegeben hat, daher wird ein Worktree, das Git erkennt, entfernt. Ein Worktree, das Git nicht erkennt, z. B. einer, den Ihr Hook mit einem nicht-Git-Versionskontrollsystem erstellt hat, bleibt auf der Festplatte. Für was das Löschen einer [Hintergrund-Sitzung](/docs/de/agent-view#what-deleting-a-session-removes) mit einem Hook-erstellten Worktree tut, siehe die Lösch-Regeln der Agent-Ansicht.

3237* **Hook beendet sich mit 0**: Das Worktree wird als entfernt gezählt. Claude Code liest nichts anderes vom Hook, daher stellen Sie sicher, dass Ihr Hook das Verzeichnis gelöscht hat.

3238* **Hook beendet sich mit nicht-Null**: Das Entfernen schlägt fehl, wenn das Verzeichnis bei `worktree_path` immer noch danach existiert, und das Worktree bleibt auf der Festplatte ohne Git-Fallback. Ein Hook, der das Verzeichnis vor dem Beenden mit nicht-Null gelöscht hat, wird als entfernt gezählt. Für wie der Fehler gemeldet wird, siehe [WorktreeRemove-Eingabe](#worktreeremove-input).

3239

3240Claude Code löscht niemals einen Branch, der zu einem Hook-erstellten Worktree gehört, da es nur den Pfad kennt, den Ihr WorktreeCreate-Hook zurückgegeben hat. Wenn Ihr WorktreeCreate-Hook einen Branch erstellt, löschen Sie ihn in Ihrem WorktreeRemove-Hook.

3245 3241

3246Claude Code verwirft die [JSON-Ausgabefelder](#json-output) eines WorktreeRemove-Hooks, wie `systemMessage` und `continue`.3242Claude Code verwirft die [JSON-Ausgabefelder](#json-output) eines WorktreeRemove-Hooks, wie `systemMessage` und `continue`.

3247 3243

3248Für einen Hintergrund-Sitzungs-Löschung überprüft Claude Code den gespeicherten Worktree-Pfad, bevor der Hook ausgeführt wird, und lehnt einen Pfad ab, der ein Symlink ist oder durch einen unterhalb der Repository-Root geht. Der Hook wird für einen Worktree, der immer noch Dateien enthält, nur ausgeführt, wenn Sie den Löschvorgang in [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) die Sitzung und den Worktree statt. Vor v2.1.216 wurde der Hook auf dem gespeicherten Pfad ohne diese Überprüfungen ausgeführt.3244Für ein Hintergrund-Sitzungs-Löschen überprüft Claude Code den gespeicherten Worktree-Pfad, bevor der Hook ausgeführt wird und lehnt einen Pfad ab, der ein Symlink ist oder unter dem Repository-Root durch einen geht. Der Hook wird für ein Worktree, das immer noch Dateien enthält, 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 ein solches Worktree behält [`claude rm`](/docs/de/agent-view#manage-sessions-from-the-shell) die Sitzung und das Worktree statt. Vor v2.1.216 wurde der Hook auf dem gespeicherten Pfad ohne diese Überprüfungen ausgeführt.

3249 3245

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

3251 3247

3252```json theme={null}3248```json theme={null}

3253{3249{

3270 WorktreeRemove-Eingabe3266 WorktreeRemove-Eingabe

3271</h4>3267</h4>

3272 3268

3273Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten WorktreeRemove-Hooks das `worktree_path` Feld, das der absolute Pfad zum entfernten Worktree ist.3269Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten WorktreeRemove-Hooks das `worktree_path` Feld, das der absolute Pfad zum Worktree ist, das entfernt wird.

3274 3270

3275```json theme={null}3271```json theme={null}

3276{3272{

3282}3278}

3283```3279```

3284 3280

3285Der Exit-Code eines WorktreeRemove-Hooks entscheidet das Ergebnis. Wenn ein Hook mit nicht-Null beendet wird und das Verzeichnis bei `worktree_path` immer noch danach existiert, schlägt die Entfernung fehl:3281Der Exit-Code eines WorktreeRemove-Hooks entscheidet das Ergebnis. Wenn ein Hook mit nicht-Null beendet wird und das Verzeichnis bei `worktree_path` danach immer noch existiert, schlägt das Entfernen fehl:

3286 3282

3287* Der Worktree bleibt auf der Festplatte, und der Hook-Befehl und stderr gehen zum [Debug-Protokoll](#debug-hooks).3283* Das Worktree bleibt auf der Festplatte, und der Hook-Befehl und stderr gehen ins [Debug-Protokoll](#debug-hooks).

3288* Wenn Sie eine Hintergrund-Sitzung löschten, bleibt die Sitzung auch. Die Verweigerungsmeldung in [Agent-Ansicht](/docs/de/agent-view#what-deleting-a-session-removes) meldet, wie der Hook endete, wie `exited 1`, zitiert den Anfang seines stderr und sagt, ob das Löschen der Sitzung erneut das Verzeichnis trotzdem entfernt.3284* Wenn Sie eine Hintergrund-Sitzung löschen, bleibt die Sitzung auch. Die Verweigerungs-Nachricht in der [Agent-Ansicht](/docs/de/agent-view#what-deleting-a-session-removes) meldet, wie der Hook endete, wie `exited 1`, zitiert den Anfang seines stderr und sagt, ob das Löschen der Sitzung erneut das Verzeichnis entfernt.

3289 3285

3290<h3 id="precompact">3286<h3 id="precompact">

3291 PreCompact3287 PreCompact

3292</h3>3288</h3>

3293 3289

3294Wird ausgeführt, bevor Claude Code einen Komprimierungsvorgang ausführen möchte.3290Wird ausgeführt, bevor Claude Code eine Komprimierungs-Operation ausführen wird.

3295 3291

3296Der Matcher-Wert gibt an, ob die Komprimierung manuell oder automatisch ausgelöst wurde:3292Der Matcher-Wert gibt an, ob die Komprimierung manuell oder automatisch ausgelöst wurde:

3297 3293

3302 3298

3303Beenden Sie mit Code 2, um die Komprimierung zu blockieren. Für ein manuelles `/compact` wird die stderr-Nachricht dem Benutzer angezeigt. Sie können auch blockieren, indem Sie JSON mit `"decision": "block"` zurückgeben.3299Beenden Sie mit Code 2, um die Komprimierung zu blockieren. Für ein manuelles `/compact` wird die stderr-Nachricht dem Benutzer angezeigt. Sie können auch blockieren, indem Sie JSON mit `"decision": "block"` zurückgeben.

3304 3300

3305Das Blockieren der automatischen Komprimierung hat unterschiedliche Auswirkungen, je nachdem, wann es ausgeführt wird. Wenn die Komprimierung proaktiv ausgelöst wurde, bevor das Kontext-Limit erreicht wurde, überspringt Claude Code sie und das Gespräch wird unkomprimiert fortgesetzt. Wenn die Komprimierung ausgelöst wurde, um sich von einem Kontext-Limit-Fehler zu erholen, der bereits von der API zurückgegeben wurde, zeigt sich der zugrunde liegende Fehler und die aktuelle Anfrage schlägt fehl.3301Das Blockieren der automatischen Komprimierung hat unterschiedliche Auswirkungen, je nachdem, wann es ausgelöst wird. Wenn die Komprimierung proaktiv ausgelöst wurde, bevor das Kontext-Limit erreicht wurde, überspringt Claude Code sie und das Gespräch wird unkomprimiert fortgesetzt. Wenn die Komprimierung ausgelöst wurde, um sich von einem Kontext-Limit-Fehler zu erholen, der bereits von der API zurückgegeben wurde, zeigt sich der zugrunde liegende Fehler und die aktuelle Anfrage schlägt fehl.

3306 3302

3307Claude Code verwirft die `systemMessage` und `continue` Felder eines PreCompact-Hooks.3303Claude Code verwirft die `systemMessage` und `continue` Felder eines PreCompact-Hooks.

3308 3304

3327 PostCompact3323 PostCompact

3328</h3>3324</h3>

3329 3325

3330Wird ausgeführt, nachdem Claude Code einen Komprimierungsvorgang abgeschlossen hat. Verwenden Sie dieses Ereignis, um auf den neuen komprimierten Zustand zu reagieren, z. B. um die generierte Zusammenfassung zu protokollieren oder externen Zustand zu aktualisieren. Claude Code verwirft die `systemMessage` und `continue` Felder eines PostCompact-Hooks.3326Wird ausgeführt, nachdem Claude Code eine Komprimierungs-Operation abgeschlossen hat. Verwenden Sie dieses Ereignis, um auf den neuen komprimierten Zustand zu reagieren, z. B. um die generierte Zusammenfassung zu protokollieren oder externen Zustand zu aktualisieren. Claude Code verwirft die `systemMessage` und `continue` Felder eines PostCompact-Hooks.

3331 3327

3332Die gleichen Matcher-Werte gelten wie für `PreCompact`:3328Die gleichen Matcher-Werte gelten wie für `PreCompact`:

3333 3329

3340 PostCompact-Eingabe3336 PostCompact-Eingabe

3341</h4>3337</h4>

3342 3338

3343Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten PostCompact-Hooks `trigger` und `compact_summary`. Das `compact_summary` Feld enthält die Gesprächs-Zusammenfassung, die vom Komprimierungsvorgang generiert wurde.3339Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten PostCompact-Hooks `trigger` und `compact_summary`. Das `compact_summary` Feld enthält die Gesprächs-Zusammenfassung, die von der Komprimierungs-Operation generiert wurde.

3344 3340

3345```json theme={null}3341```json theme={null}

3346{3342{

3359 PreModelSwitch3355 PreModelSwitch

3360</h3>3356</h3>

3361 3357

3362Wird ausgeführt, bevor Claude Code einen Modell-Wechsel anwendet, den Sie oder ein Client angefordert haben. Verwenden Sie ihn, um einen Wechsel zu blockieren, eine Bestätigung zu erfordern oder zu zeigen, was der Wechsel kostet, bevor er passiert.3358Wird ausgeführt, bevor Claude Code einen Modell-Wechsel anwendet, den Sie oder ein Client angefordert haben. Verwenden Sie ihn, um einen Wechsel zu blockieren, Bestätigung zu erfordern oder zu zeigen, was der Wechsel kostet, bevor er passiert.

3363 3359

3364PreModelSwitch erfordert Claude Code v2.1.251 oder später. Claude Code führt ihn für diese Anfragen aus:3360PreModelSwitch erfordert Claude Code v2.1.251 oder später. Claude Code führt ihn für diese Anfragen aus:

3365 3361

3366* `/model <name>` und der `/model` Picker3362* `/model <name>` und der `/model` Picker

3367* Der `Option+P` oder `Alt+P` Modell-Picker3363* Der `Option+P` oder `Alt+P` Modell-Picker

3368* Die Modell-Einstellung in `/config`3364* Die Modell-Einstellung in `/config`

3369* Das Aktivieren des [Fast-Modus](/docs/de/fast-mode), wenn das das Modell der Sitzung ändert3365* Das Einschalten des [Fast-Modus](/docs/de/fast-mode), wenn das die Sitzungs-Modell ändert

3370* Eine `set_model` Anfrage oder eine Modell-Änderung in einer `apply_flag_settings` Anfrage von einem [Agent SDK](/docs/de/agent-sdk/typescript#query-object) Host oder [Remote Control](/docs/de/remote-control)3366* Eine `set_model` Anfrage oder eine Modell-Änderung in einer `apply_flag_settings` Anfrage von einem [Agent SDK](/docs/de/agent-sdk/typescript#query-object) Host oder [Remote Control](/docs/de/remote-control)

3371 3367

3372Claude Code führt PreModelSwitch-Hooks nicht für Wechsel aus, die es selbst macht, wie ein [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) oder das Wiederherstellen des Modells, wenn Sie eine Sitzung fortsetzen. Diese Änderungen erreichen [PostModelSwitch](#postmodelswitch) nur.3368Claude Code führt PreModelSwitch-Hooks nicht für Wechsel aus, die es selbst macht, wie ein [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) oder das Wiederherstellen des Modells, wenn Sie eine Sitzung fortsetzen. Diese Änderungen erreichen [PostModelSwitch](#postmodelswitch) nur.

3373 3369

3374Claude Code vergleicht den Matcher gegen den kanonischen Namen des Modells, zu dem die Sitzung wechselt, und ignoriert jeden `[1m]` Suffix. Ein Alias wie `opus`, eine datierte Modell-ID und eine Provider-spezifische ID wie eine Amazon Bedrock Modell-ID gleichen alle den einen kanonischen Namen ab, den sie auflösen, daher deckt `claude-opus-5` jede Schreibweise von Opus 5 ab.3370Claude Code vergleicht den Matcher gegen den kanonischen Namen des Modells, zu dem die Sitzung wechselt, ignoriert jeden `[1m]` Suffix. Ein Alias wie `opus`, eine datierte Modell-ID und eine Provider-spezifische ID wie eine Amazon Bedrock Modell-ID gleichen alle den einen kanonischen Namen ab, den sie auflösen, daher deckt `claude-opus-5` jede Schreibweise von Opus 5 ab.

3375 3371

3376Wenn Claude Code einen kanonischen Namen für das Ziel nicht bestimmen kann, z. B. eine benutzerdefinierte Modell-ID, die nur Ihr [LLM-Gateway](/docs/de/llm-gateway) kennt, führt es jeden PreModelSwitch-Hook unabhängig vom Matcher aus. Ein Hook, der blockiert, sollte daher `to_model` aus seiner Eingabe überprüfen, anstatt sich nur auf den Matcher zu verlassen.3372Wenn Claude Code einen kanonischen Namen für das Ziel nicht bestimmen kann, z. B. eine benutzerdefinierte Modell-ID, die nur Ihr [LLM-Gateway](/docs/de/llm-gateway) kennt, führt es jeden PreModelSwitch-Hook unabhängig vom Matcher aus. Ein Hook, der blockiert, sollte daher `to_model` aus seiner Eingabe überprüfen, anstatt sich nur auf den Matcher zu verlassen.

3377 3373

3378Schreiben Sie den Matcher als genauen Namen, eine `|`-getrennte Liste wie `claude-opus-4-6|claude-opus-5` oder einen regulären Ausdruck wie `.*opus.*`. Dieses Beispiel verwendet einen genauen Namen-Matcher und überprüft auch `to_model` aus der Hook-Eingabe, daher verweigert es einen Wechsel zu Opus 4.6 durch Beendigung mit Code 2 und lässt jedes andere Ziel durch:3374Schreiben Sie den Matcher als genauen Namen, eine `|`-getrennte Liste wie `claude-opus-4-6|claude-opus-5` oder einen regulären Ausdruck wie `.*opus.*`. Dieses Beispiel verwendet einen genauen Namen-Matcher und überprüft auch `to_model` aus der Hook-Eingabe, daher lehnt es einen Wechsel zu Opus 4.6 ab, indem es mit Code 2 beendet wird und lässt jedes andere Ziel durch:

3379 3375

3380<Tabs>3376<Tabs>

3381 <Tab title="macOS/Linux">3377 <Tab title="macOS/Linux">

3401 </Tab>3397 </Tab>

3402 3398

3403 <Tab title="Windows (PowerShell)">3399 <Tab title="Windows (PowerShell)">

3404 Registrieren Sie einen Command-Hook, der ein Skript durch PowerShell ausführt:3400 Registrieren Sie einen Command-Hook, der ein Skript über PowerShell ausführt:

3405 3401

3406 ```json theme={null}3402 ```json theme={null}

3407 {3403 {

3451 3447

3452| Feld | Typ | Beschreibung |3448| Feld | Typ | Beschreibung |

3453| :- | :- | :- |3449| :- | :- | :- |

3456| `requested_model` | string oder `null` | Das Modell, das die Anfrage benannt hat: ein Alias wie `opus`, eine vollständige Modell-ID oder `null`, wenn die Anfrage für das Standard-Modell war |3452| `requested_model` | string oder `null` | Das Modell, das die Anfrage benannt hat: ein Alias wie `opus`, eine vollständige Modell-ID oder `null`, wenn die Anfrage für das Standard-Modell war |

3457| `source` | string | Woher die Anfrage kam: `"command"` für `/model <name>`, die Modell-Einstellung in `/config` oder das Aktivieren des Fast-Modus; `"picker"` für einen Modell-Picker; `"sdk"` für eine `set_model` Anfrage oder eine Modell-Änderung in einer `apply_flag_settings` Anfrage von einem Agent SDK Host oder Remote Control |3453| `source` | string | Woher die Anfrage kam: `"command"` für `/model <name>`, die Modell-Einstellung in `/config` oder das Einschalten des Fast-Modus; `"picker"` für einen Modell-Picker; `"sdk"` für eine `set_model` Anfrage oder eine Modell-Änderung in einer `apply_flag_settings` Anfrage von einem Agent SDK Host oder Remote Control |

3458| `context_tokens` | number | Tokens, die die nächste Anfrage als ihre Eingabeaufforderung erneut sendet: die Eingabe-, Cache-Lese-, Cache-Erstellungs- und Ausgabe-Tokens der letzten Antwort im Hauptgespräch, kombiniert. `0` vor der ersten Antwort |3454| `context_tokens` | number | Token, die die nächste Anfrage erneut sendet als ihre Eingabeaufforderung: die Eingabe-, Cache-Lese-, Cache-Erstellungs- und Ausgabe-Token der letzten Antwort im Hauptgespräch, kombiniert. `0` vor der ersten Antwort |

3461| `estimated_cache_write_usd` | number | Geschätzte Kosten in US-Dollar für das Schreiben von `context_tokens` in den Prompt-Cache auf `to_model` bei der `cache_ttl` Rate, ohne die nächste Antwort. Der Server muss möglicherweise nicht den ganzen Kontext erneut zwischenspeichern, daher behandeln Sie es als Schätzung |3457| `estimated_cache_write_usd` | number | Geschätzte Kosten in US-Dollar für das Schreiben von `context_tokens` in den Prompt-Cache auf `to_model` bei der `cache_ttl` Rate, ohne die nächste Antwort. Der Server muss möglicherweise nicht den ganzen Kontext erneut zwischenspeichern, daher behandeln Sie es als Schätzung |

3462| `pricing` | string | Wie Claude Code `estimated_cache_write_usd` bepreist: `"configured"` bei den Raten Ihrer Organisation, wenn sie konfiguriert hat, `"catalog"` bei Listenpreis oder `"default"`, wenn `to_model` keinen bekannten Preis hat und Claude Code einen Standard-Satz annahm |3458| `pricing` | string | Wie Claude Code `estimated_cache_write_usd` bepreist: `"configured"` bei den eigenen Sätzen Ihrer Organisation, wenn sie sie konfiguriert hat, `"catalog"` bei Listenpreis oder `"default"`, wenn `to_model` keinen bekannten Preis hat und Claude Code einen Standard-Satz annahm |

3463 3459

3464Dieses Beispiel zeigt die Eingabe für `/model opus` in einer Sitzung, die Sonnet 5 ausführt:3460Dieses Beispiel zeigt die Eingabe für `/model opus` in einer Sitzung, die Sonnet 5 ausführt:

3465 3461

3491 3487

3492| Feld | Beschreibung |3488| Feld | Beschreibung |

3493| :- | :- |3489| :- | :- |

3494| `permissionDecision` | `"allow"` fährt fort und überspringt die [Bestätigung, die Claude Code zeigt, während der Prompt-Cache warm ist](/docs/de/prompt-caching#switching-models). `"deny"` bricht den Wechsel ab. `"ask"` fordert den Benutzer zur Bestätigung auf |3490| `permissionDecision` | `"allow"` geht weiter und überspringt die [Bestätigung, die Claude Code zeigt, während der Prompt-Cache warm ist](/docs/de/prompt-caching#switching-models). `"deny"` bricht den Wechsel ab. `"ask"` fordert den Benutzer zur Bestätigung auf |

3495| `permissionDecisionReason` | Für `"deny"`, dem Benutzer als Grund angezeigt, warum der Wechsel blockiert wurde, oder als Fehler für eine `set_model` Anfrage zurückgegeben. Für `"ask"`, in der Bestätigungs-Aufforderung angezeigt. Ignoriert für `"allow"` |3491| `permissionDecisionReason` | Für `"deny"`, dem Benutzer als Grund angezeigt, warum der Wechsel blockiert wurde, oder als Fehler für eine `set_model` Anfrage zurückgegeben. Für `"ask"`, in der Bestätigungs-Aufforderung angezeigt. Ignoriert für `"allow"` |

3496 3492

3497Nur `/model` in einer interaktiven Sitzung kann die `"ask"` Aufforderung anzeigen. Auf jeder anderen Oberfläche, einschließlich nicht-interaktivem Modus mit dem `-p` Flag, `/config` und `set_model` Anfragen, behandelt Claude Code `"ask"` als Verweigerung.3493Nur `/model` in einer interaktiven Sitzung kann die `"ask"` Aufforderung anzeigen. Auf jeder anderen Oberfläche, einschließlich nicht-interaktivem Modus mit dem `-p` Flag, `/config` und `set_model` Anfragen, behandelt Claude Code `"ask"` als Verweigerung.

3514 3510

3515Ein PreModelSwitch-Hook, der nicht vor seinem Timeout antwortet, blockiert den Wechsel. Bei [PreToolUse](#timeouts) lässt ein Timeout-Command-Hook den Tool-Aufruf dagegen fortgesetzt. Das Standard-Timeout für dieses Ereignis beträgt 30 Sekunden. `PreModelSwitch` führt nur `command`, `http` und `mcp_tool` Hooks aus, daher gelten die `prompt` und `agent` Standards nicht.3511Ein PreModelSwitch-Hook, der nicht vor seinem Timeout antwortet, blockiert den Wechsel. Bei [PreToolUse](#timeouts) lässt ein Timeout-Command-Hook den Tool-Aufruf dagegen fortgesetzt. Das Standard-Timeout für dieses Ereignis beträgt 30 Sekunden. `PreModelSwitch` führt nur `command`, `http` und `mcp_tool` Hooks aus, daher gelten die `prompt` und `agent` Standards nicht.

3516 3512

3517Ein Hook, der mit einem Code anderen als 0 oder 2 beendet und keine JSON-Entscheidung druckt, blockiert nicht: Claude Code zeigt sein stderr und wendet den Wechsel an, wie unter [Andere Exit-Codes](#other-exit-codes) beschrieben.3513Ein Hook, der mit einem Code außer 0 oder 2 beendet wird und keine JSON-Entscheidung druckt, blockiert nicht: Claude Code zeigt sein stderr und wendet den Wechsel an, wie unter [Andere Exit-Codes](#other-exit-codes) beschrieben.

3518 3514

3519<h3 id="postmodelswitch">3515<h3 id="postmodelswitch">

3520 PostModelSwitch3516 PostModelSwitch

3525PostModelSwitch erfordert Claude Code v2.1.251 oder später. Es kann nicht blockieren, da sich das Modell bereits geändert hat. Claude Code führt PostModelSwitch-Hooks nach jeder dieser Änderungen aus:3521PostModelSwitch erfordert Claude Code v2.1.251 oder später. Es kann nicht blockieren, da sich das Modell bereits geändert hat. Claude Code führt PostModelSwitch-Hooks nach jeder dieser Änderungen aus:

3526 3522

3527* Ein Wechsel, den Sie oder ein Client angefordert haben3523* Ein Wechsel, den Sie oder ein Client angefordert haben

3528* Ein [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback), das das Modell der Sitzung ändert3524* Ein [automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback), das das Sitzungs-Modell ändert

3529* Eine Einstellung wie [`opusplan`](/docs/de/model-config#opusplan-model-setting), die den Plan-Modus betritt oder verlässt3525* Eine Einstellung wie [`opusplan`](/docs/de/model-config#opusplan-model-setting), die den Plan-Modus betritt oder verlässt

3530* Claude Code stellt das Modell wieder her, wenn Sie eine Sitzung fortsetzen3526* Claude Code stellt das Modell wieder her, wenn Sie eine Sitzung fortsetzen

3531 3527

3532Claude Code führt PostModelSwitch-Hooks nicht aus, wenn ein Modell aus einer [Fallback-Modell-Kette](/docs/de/model-config#fallback-model-chains) einen Zug bedient, da diese Substitution einen Zug dauert und das Modell der Sitzung unverändert lässt.3528Claude Code führt PostModelSwitch-Hooks nicht aus, wenn ein Modell aus einer [Fallback-Modell-Kette](/docs/de/model-config#fallback-model-chains) einen Zug bedient, da diese Substitution einen Zug dauert und das Sitzungs-Modell unverändert lässt.

3533 3529

3534Der Matcher folgt den gleichen Regeln wie [PreModelSwitch](#premodelswitch): Claude Code vergleicht ihn gegen den kanonischen Namen des Modells, zu dem die Sitzung wechselt.3530Der Matcher folgt den gleichen Regeln wie [PreModelSwitch](#premodelswitch): Claude Code vergleicht ihn gegen den kanonischen Namen des Modells, zu dem die Sitzung wechselt.

3535 3531

3536Dieses Beispiel fügt Anleitung hinzu, wenn sich das Modell der Sitzung zu einem Opus-Modell ändert:3532Dieses Beispiel fügt Anleitung hinzu, wenn sich das Sitzungs-Modell zu einem Opus-Modell ändert:

3537 3533

3538```json theme={null}3534```json theme={null}

3539{3535{

3567 PostModelSwitch-Entscheidungskontrolle3563 PostModelSwitch-Entscheidungskontrolle

3568</h4>3564</h4>

3569 3565

3570Claude Code nimmt Ihren Hook-[Klartext-stdout](#exit-code-0) bei Beendigung mit 0 oder `additionalContext` aus JSON-Ausgabe und liefert es an Claude mit der nächsten Anfrage nach dem Wechsel. Zusätzlich zu den [JSON-Ausgabefeldern](#json-output), die für alle Hooks verfügbar sind, können Sie zurückgeben:3566Claude Code nimmt Ihren Hook-[Klartext-stdout](#exit-code-0) bei Exit 0 oder `additionalContext` aus JSON-Ausgabe und liefert es an Claude mit der nächsten Anfrage nach dem Wechsel. Zusätzlich zu den [JSON-Ausgabefeldern](#json-output), die für alle Hooks verfügbar sind, können Sie zurückgeben:

3571 3567

3572| Feld | Beschreibung |3568| Feld | Beschreibung |

3573| :- | :- |3569| :- | :- |

3574| `additionalContext` | String, der zu Claudes Kontext mit der nächsten Anfrage hinzugefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |3570| `additionalContext` | String, der zu Claudes Kontext mit der nächsten Anfrage hinzugefügt wird. Siehe [Kontext für Claude hinzufügen](#add-context-for-claude) |

3575 3571

3576Wenn der Hook nicht innerhalb von fünf Sekunden nach dem Senden der nächsten Eingabeaufforderung fertig ist, sendet Claude Code diese Anfrage ohne die Ausgabe und hängt sie stattdessen an die folgende Anfrage an. Wenn sich das Modell mehrmals ändert, bevor die nächste Anfrage erfolgt, liefert Claude Code nur die Ausgabe für den letzten Wechsel zum Ziel-Modell.3572Wenn der Hook nicht innerhalb von fünf Sekunden nach dem Senden der nächsten Eingabeaufforderung fertig wird, sendet Claude Code diese Anfrage ohne die Ausgabe und hängt sie stattdessen an die folgende Anfrage an. Wenn sich das Modell mehrmals ändert, bevor die nächste Anfrage erfolgt, liefert Claude Code nur die Ausgabe für den letzten Wechsel zum Ziel-Modell.

3577 3573

3578<h3 id="sessionend">3574<h3 id="sessionend">

3579 SessionEnd3575 SessionEnd

3580</h3>3576</h3>

3581 3577

3582Wird ausgeführt, wenn eine Claude Code Sitzung endet. Nützlich für Bereinigungsaufgaben, Protokollierung von Sitzungs-Statistiken oder Speicherung des Sitzungs-Zustands. Unterstützt Matcher zum Filtern nach Exit-Grund.3578Wird ausgeführt, wenn eine Claude Code Sitzung endet. Nützlich für Aufräum-Aufgaben, Protokollierung von Sitzungs-Statistiken oder Speicherung von Sitzungs-Zustand. Unterstützt Matcher zum Filtern nach Exit-Grund.

3583 3579

3584Das `reason` Feld in der Hook-Eingabe gibt an, warum die Sitzung endete:3580Das `reason` Feld in der Hook-Eingabe gibt an, warum die Sitzung endete:

3585 3581

3608}3604}

3609```3605```

3610 3606

3611SessionEnd-Hooks haben keine Entscheidungskontrolle. Sie können die Sitzungs-Beendigung nicht blockieren, können aber Bereinigungsaufgaben ausführen. Claude Code verwirft ihre [JSON-Ausgabefelder](#json-output), wie `systemMessage`.3607SessionEnd-Hooks haben keine Entscheidungskontrolle. Sie können die Sitzungs-Beendigung nicht blockieren, können aber Aufräum-Aufgaben ausführen. Claude Code verwirft ihre [JSON-Ausgabefelder](#json-output), wie `systemMessage`.

3612 3608

3613SessionEnd-Hooks haben ein Standard-Timeout von 1,5 Sekunden. Es gilt, wenn Sie beenden, `/clear` ausführen oder mit interaktivem `/resume` zu Sitzungen wechseln. Sie können einem Hook auf zwei Wegen mehr Zeit geben:3609SessionEnd-Hooks haben ein Standard-Timeout von 1,5 Sekunden. Es gilt, wenn Sie beenden, `/clear` ausführen oder Sitzungen mit interaktivem `/resume` wechseln. Sie können einem Hook auf zwei Wegen mehr Zeit geben:

3614 3610

3615* **Pro-Hook `timeout`**: Setzen Sie `timeout` in der Konfiguration dieses Hooks. Das Gesamt-Budget steigt automatisch, um das höchste Pro-Hook-`timeout` in Ihren Einstellungsdateien zu entsprechen, bis zu 60 Sekunden. Wenn Sie das Budget auf diese Weise erhöhen, behält ein Hook ohne sein eigenes `timeout` immer noch den Standard. Timeouts, die auf Plugin-bereitgestellten Hooks gesetzt sind, erhöhen das Budget nicht.3611* **Pro-Hook `timeout`**: Setzen Sie `timeout` in der Konfiguration dieses Hooks. Das Gesamt-Budget steigt automatisch, um das höchste Pro-Hook-`timeout` in Ihren Einstellungsdateien zu entsprechen, bis zu 60 Sekunden. Wenn Sie das Budget auf diese Weise erhöhen, behält ein Hook ohne sein eigenes `timeout` immer noch den Standard. Timeouts, die auf Plugin-bereitgestellten Hooks gesetzt sind, erhöhen das Budget nicht.

3616* **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`**: Setzen Sie diese Umgebungsvariable in Millisekunden, um das Budget explizit zu überschreiben. Der Wert, den Sie setzen, wird auch zum Timeout für jeden Hook ohne sein eigenes `timeout`.3612* **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`**: Setzen Sie diese Umgebungsvariable in Millisekunden, um das Budget explizit zu überschreiben. Der Wert, den Sie setzen, wird auch zum Timeout für jeden Hook ohne sein eigenes `timeout`.

3621CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 claude3617CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 claude

3622```3618```

3623 3619

3624Vor v2.1.268 erhöhte `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` nur das Gesamt-Budget, und ein Hook ohne sein eigenes `timeout` wurde immer noch nach 1,5 Sekunden abgebrochen.3620Vor v2.1.268 erhöhte `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` nur das Gesamt-Budget und ein Hook ohne sein eigenes `timeout` wurde immer noch nach 1,5 Sekunden abgebrochen.

3625 3621

3626<h3 id="elicitation">3622<h3 id="elicitation">

3627 Elicitation3623 Elicitation

3628</h3>3624</h3>

3629 3625

3630Wird ausgeführt, wenn ein MCP-Server Benutzereingabe während einer Aufgabe anfordert. Standardmäßig zeigt Claude Code einen interaktiven Dialog für den Benutzer zum Antworten. Hooks können diese Anfrage abfangen und programmatisch antworten, wobei der Dialog vollständig übersprungen wird.3626Wird ausgeführt, wenn ein MCP-Server Benutzer-Eingabe während einer Aufgabe anfordert. Standardmäßig zeigt Claude Code einen interaktiven Dialog für den Benutzer zum Antworten. Hooks können diese Anfrage abfangen und programmatisch antworten, wobei der Dialog vollständig übersprungen wird.

3631 3627

3632Das Matcher-Feld gleicht gegen den MCP-Server-Namen ab.3628Das Matcher-Feld gleicht gegen den MCP-Server-Namen ab.

3633 3629

3637 3633

3638Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten Elicitation-Hooks `mcp_server_name`, `message` und optionale `mode`, `url`, `elicitation_id` und `requested_schema` Felder.3634Zusätzlich zu den [allgemeinen Eingabefeldern](#common-input-fields) erhalten Elicitation-Hooks `mcp_server_name`, `message` und optionale `mode`, `url`, `elicitation_id` und `requested_schema` Felder.

3639 3635

3640Für Form-Modus-Elicitierung, der häufigste Fall:3636Für Form-Modus-Elicitation, der häufigste Fall:

3641 3637

3642```json theme={null}3638```json theme={null}

3643{3639{

3657}3653}

3658```3654```

3659 3655

3660Für URL-Modus-Elicitierung, verwendet für Browser-basierte Authentifizierung:3656Für URL-Modus-Elicitation, verwendet für Browser-basierte Authentifizierung:

3661 3657

3662```json theme={null}3658```json theme={null}

3663{3659{

3676 Elicitation-Ausgabe3672 Elicitation-Ausgabe

3677</h4>3673</h4>

3678 3674

3679Um programmatisch ohne Anzeige des Dialogs zu antworten, geben Sie ein JSON-Objekt mit `hookSpecificOutput` zurück:3675Um programmatisch ohne Dialog zu antworten, geben Sie ein JSON-Objekt mit `hookSpecificOutput` zurück:

3680 3676

3681```json theme={null}3677```json theme={null}

3682{3678{

3694| :- | :- | :- |3690| :- | :- | :- |

3697 3693

3698Exit-Code 2 verweigert die Elicitierung. Claude Code zeigt Ihre stderr-Nachricht nirgendwo an.3694Exit-Code 2 lehnt die Elicitation ab. Claude Code zeigt Ihre stderr-Nachricht nirgendwo an.

3699 3695

3700Claude Code handelt `hookSpecificOutput` aus der JSON-Ausgabe eines Elicitation-Hooks und verwirft `systemMessage` und `continue`.3696Claude Code handelt auf `hookSpecificOutput` aus einer Elicitation-Hook-JSON-Ausgabe und verwirft `systemMessage` und `continue`.

3701 3697

3702<h3 id="elicitationresult">3698<h3 id="elicitationresult">

3703 ElicitationResult3699 ElicitationResult

3704</h3>3700</h3>

3705 3701

3706Wird ausgeführt, nachdem ein Benutzer auf eine MCP-Elicitierung antwortet. Hooks können die Antwort beobachten, ändern oder blockieren, bevor sie an den MCP-Server zurückgesendet wird.3702Wird ausgeführt, nachdem ein Benutzer auf eine MCP-Elicitation antwortet. Hooks können die Antwort beobachten, ändern oder blockieren, bevor sie an den MCP-Server zurückgesendet wird.

3707 3703

3708Das Matcher-Feld gleicht gegen den MCP-Server-Namen ab.3704Das Matcher-Feld gleicht gegen den MCP-Server-Namen ab.

3709 3705

3747| :- | :- | :- |3743| :- | :- | :- |

3750 3746

3751Exit-Code 2 blockiert die Antwort und ändert die effektive Aktion zu `decline`. Claude Code zeigt Ihre stderr-Nachricht nirgendwo an.3747Exit-Code 2 blockiert die Antwort, ändert die effektive Aktion zu `decline`. Claude Code zeigt Ihre stderr-Nachricht nirgendwo an.

3752 3748

3753Claude Code handelt `hookSpecificOutput` aus der JSON-Ausgabe eines ElicitationResult-Hooks und verwirft `systemMessage` und `continue`.3749Claude Code handelt auf `hookSpecificOutput` aus einer ElicitationResult-Hook-JSON-Ausgabe und verwirft `systemMessage` und `continue`.

3754 3750

3755<h2 id="prompt-based-hooks">3751<h2 id="prompt-based-hooks">

3756 Prompt-basierte Hooks3752 Prompt-basierte Hooks

3804 3800

3805Anstatt einen Bash-Befehl auszuführen, Prompt-basierte Hooks:3801Anstatt einen Bash-Befehl auszuführen, Prompt-basierte Hooks:

3806 3802

38071. Senden die Hook-Eingabe und Ihren Prompt an ein Claude-Modell, standardmäßig Haiku38031. Senden die Hook-Eingabe und Ihren Prompt an ein Claude-Modell, standardmäßig das Modell, das Claude Code für [Hintergrundfunktionalität](/docs/de/costs#background-token-usage) verwendet

38082. Das LLM antwortet mit strukturiertem JSON, das eine Entscheidung enthält38042. Das LLM antwortet mit strukturiertem JSON, das eine Entscheidung enthält

38093. Claude Code verarbeitet die Entscheidung automatisch38053. Claude Code verarbeitet die Entscheidung automatisch

3810 3806

3837| :- | :- | :- |3833| :- | :- | :- |

3838| `type` | ja | Muss `"prompt"` sein |3834| `type` | ja | Muss `"prompt"` sein |

3839| `prompt` | ja | Der Prompt-Text zum Senden an das LLM. Verwenden Sie `$ARGUMENTS` als Platzhalter für die Hook-Eingabe JSON. Wenn `$ARGUMENTS` nicht vorhanden ist, wird die Eingabe JSON an den Prompt angehängt |3835| `prompt` | ja | Der Prompt-Text zum Senden an das LLM. Verwenden Sie `$ARGUMENTS` als Platzhalter für die Hook-Eingabe JSON. Wenn `$ARGUMENTS` nicht vorhanden ist, wird die Eingabe JSON an den Prompt angehängt |

3842| `continueOnBlock` | nein | Bei den Ereignissen, auf die es zutrifft, speist `true` einen `ok: false` Grund an Claude zurück und setzt den Turn fort, anstatt ihn zu beenden. Standard: `false`. Siehe [Response-Schema](#response-schema) für ereignisspezifisches Verhalten |3838| `continueOnBlock` | nein | Bei den Ereignissen, auf die es zutrifft, speist `true` einen `ok: false` Grund an Claude zurück und setzt den Turn fort, anstatt ihn zu beenden. Standard: `false`. Siehe [Response-Schema](#response-schema) für ereignisspezifisches Verhalten |

3843 3839

hooks-guide.md +2 −2

Details

880 Prompt-basierte Hooks880 Prompt-basierte Hooks

881</h2>881</h2>

882 882

883Für Entscheidungen, die Urteilsvermögen erfordern, anstatt deterministischer Regeln, verwenden Sie `type: "prompt"`-Hooks. Anstatt einen Shell-Befehl auszuführen, sendet Claude Code Ihren Prompt und die Hook-Eingabedaten an ein Claude-Modell (standardmäßig Haiku), um die Entscheidung zu treffen. Sie können ein anderes Modell mit dem Feld `model` angeben, wenn Sie mehr Leistung benötigen.883Für Entscheidungen, die Urteilsvermögen erfordern, anstatt deterministischer Regeln, verwenden Sie `type: "prompt"`-Hooks. Anstatt einen Shell-Befehl auszuführen, sendet Claude Code Ihren Prompt und die Hook-Eingabedaten an ein Claude-Modell, um die Entscheidung zu treffen. Sie können ein anderes Modell mit dem Feld `model` angeben, wenn Sie mehr Leistung benötigen.

884 884

885Die einzige Aufgabe des Modells ist, seine Entscheidung als JSON zurückzugeben:885Die einzige Aufgabe des Modells ist, seine Entscheidung als JSON zurückzugeben:

886 886

995 995

996Beachten Sie diese Einschränkungen beim Entwerfen von Hooks:996Beachten Sie diese Einschränkungen beim Entwerfen von Hooks:

997 997

998* Command Hooks kommunizieren nur über stdout, stderr und Exit-Codes. Sie können keine `/`-Befehle oder Tool-Aufrufe auslösen. Text, der über `additionalContext` zurückgegeben wird, wird als Systemhinweis eingefügt, den Claude als Klartext liest. HTTP Hooks kommunizieren stattdessen über den Response-Body.998* Command Hooks kommunizieren nur über stdout, stderr und Exit-Codes. Sie können keine `/`-Befehle oder Tool-Aufrufe auslösen. Text, der über `additionalContext` zurückgegeben wird, wird als [Systemhinweis](/docs/de/glossary#system-reminder) eingefügt, den Claude als Klartext liest. HTTP Hooks kommunizieren stattdessen über den Response-Body.

999* Hook-Timeouts variieren je nach Typ. Überschreiben Sie pro Hook mit dem Feld `timeout` in Sekunden.999* Hook-Timeouts variieren je nach Typ. Überschreiben Sie pro Hook mit dem Feld `timeout` in Sekunden.

1000 * `command`, `http`, `mcp_tool`: 10 Minuten. Claude Code senkt diesen Standard auf 30 Sekunden für `UserPromptSubmit`-, `PreModelSwitch`- und `PostModelSwitch`-Hooks und auf 10 Sekunden für `MessageDisplay`-Hooks.1000 * `command`, `http`, `mcp_tool`: 10 Minuten. Claude Code senkt diesen Standard auf 30 Sekunden für `UserPromptSubmit`-, `PreModelSwitch`- und `PostModelSwitch`-Hooks und auf 10 Sekunden für `MessageDisplay`-Hooks.

1001 * `prompt`: 30 Sekunden.1001 * `prompt`: 30 Sekunden.

how-claude-code-works.md +14 −1

Details

144 144

145Für eine interaktive Anleitung zu dem, was geladen wird und wann, siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window).145Für eine interaktive Anleitung zu dem, was geladen wird und wann, siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window).

146 146

147<h4 id="context-claude-code-adds-on-its-own">

148 Kontext, den Claude Code selbst hinzufügt

149</h4>

150

151Wenn Claude eine Regel befolgt, die Sie nicht geschrieben haben, wie das Hinzufügen eines `Co-Authored-By`-Trailers zu einem Commit, kann die Regel von einer [Systemanmerkung](/docs/de/glossary#system-reminder) stammen. Während Sie arbeiten, fügt Claude Code seinen eigenen Kontext zur Konversation neben Ihren Nachrichten hinzu:

152

153* Ihre CLAUDE.md-Dateien

154* Die Anweisungen Ihres [Ausgabestils](/docs/de/output-styles)

155* Eine Notiz, wenn sich eine Datei, die Claude zuvor gelesen hat, auf der Festplatte ändert

156* Die Commit- und Pull-Request-Attributionszeilen

157

158Um die Attributionszeilen zu ändern oder zu entfernen, setzen Sie [`attribution`](/docs/de/settings-reference#attribution). Um Claudes integrierte Commit- und Pull-Request-Anweisungen zu entfernen, setzen Sie [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions) auf `false`. Für die anderen Schalter siehe [Deaktivieren Sie den Kontext, den Ihr Agent ersetzt](/docs/de/agent-sdk/modifying-system-prompts#turn-off-the-context-your-agent-replaces).

159

147<h4 id="when-context-fills-up">160<h4 id="when-context-fills-up">

148 Wenn der Kontext voll wird161 Wenn der Kontext voll wird

149</h4>162</h4>

188 201

189Wählen Sie einen Berechtigungsmodus, um festzulegen, was Claude ohne Nachfrage tun kann. Drücken Sie `Shift+Tab`, um durch die Berechtigungsmodi zu wechseln:202Wählen Sie einen Berechtigungsmodus, um festzulegen, was Claude ohne Nachfrage tun kann. Drücken Sie `Shift+Tab`, um durch die Berechtigungsmodi zu wechseln:

190 203

191* **Auto**: Ein Klassifizierer überprüft die meisten Aktionen im Hintergrund und blockiert die riskanten, anstatt Sie zu fragen. In Pro-, Max- und Team-Plänen ist es der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) für interaktive Terminal- und VS Code-Sitzungen204* **Auto**: Ein Klassifizierer überprüft die meisten Aktionen im Hintergrund und blockiert die riskanten, anstatt Sie zu fragen. Mit Claude Code v2.1.283 oder später ist es der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) für interaktive Terminal- und VS Code-Sitzungen, und in früheren Versionen nur in Pro-, Max- und Team-Plänen

192* **Manual**: Claude fragt vor Dateibearbeitungen und Shell-Befehlen205* **Manual**: Claude fragt vor Dateibearbeitungen und Shell-Befehlen

193* **Accept edits**: Claude bearbeitet Dateien und führt häufige Dateisystem-Befehle wie `mkdir` und `mv` ohne Nachfrage aus, fragt aber immer noch nach anderen Befehlen206* **Accept edits**: Claude bearbeitet Dateien und führt häufige Dateisystem-Befehle wie `mkdir` und `mv` ohne Nachfrage aus, fragt aber immer noch nach anderen Befehlen

194* **Plan**: Claude erkundet und schlägt einen Plan vor, ohne Ihre Quelldateien zu bearbeiten207* **Plan**: Claude erkundet und schlägt einen Plan vor, ohne Ihre Quelldateien zu bearbeiten

interactive-mode.md +12 −4

Details

34| `Ctrl+T` | Claudes Aufgabenliste umschalten | Zeigen oder verbergen Sie [Claudes To-Do-Liste](#task-list) im Statusbereich. Dies ist nicht die Hintergrund-Aufgabenansicht; verwenden Sie [`/tasks`](/docs/de/commands), um laufende Shells und Subagenten anzuzeigen |34| `Ctrl+T` | Claudes Aufgabenliste umschalten | Zeigen oder verbergen Sie [Claudes To-Do-Liste](#task-list) im Statusbereich. Dies ist nicht die Hintergrund-Aufgabenansicht; verwenden Sie [`/tasks`](/docs/de/commands), um laufende Shells und Subagenten anzuzeigen |

35| `Ctrl+S` | Eingabeaufforderung speichern oder wiederherstellen | Mit Text in der Eingabe speichert es diesen und löscht die Eingabeaufforderung. Erneut auf einer leeren Eingabeaufforderung gedrückt, stellt es den gespeicherten Text, die Cursorposition, eingefügte Inhalte und den Eingabemodus wieder her, sodass ein gespeicherter `!` [Shell-Befehl](#shell-mode-with-prefix) im Shell-Modus zurückkommt |35| `Ctrl+S` | Eingabeaufforderung speichern oder wiederherstellen | Mit Text in der Eingabe speichert es diesen und löscht die Eingabeaufforderung. Erneut auf einer leeren Eingabeaufforderung gedrückt, stellt es den gespeicherten Text, die Cursorposition, eingefügte Inhalte und den Eingabemodus wieder her, sodass ein gespeicherter `!` [Shell-Befehl](#shell-mode-with-prefix) im Shell-Modus zurückkommt |

~~37| `Pfeiltasten links/rechts` | Durch Dialog-Registerkarten navigieren | Navigieren Sie zwischen Registerkarten in Berechtigungsdialogen und Menüs |~~37| `Pfeiltasten links/rechts` | Durch Dialog-Registerkarten navigieren | Navigieren Sie zwischen Registerkarten in Berechtigungsdialogen und Menüs. In einem Dialog mit Registerkarten wechseln die Tasten die Registerkarten, während die Registerkartenzeile den Fokus hat. Siehe [Aktionen für Registerkarten](/docs/de/keybindings#tabs-actions), um zu erfahren, wie sich der Fokus bewegt |

38| `Tab` | Einen Autovervollständigungsvorschlag akzeptieren oder einen Kommentar zu einer Berechtigungsantwort hinzufügen | Während Autovervollständigungsvorschläge in der Eingabeaufforderung angezeigt werden, akzeptiert dies den ausgewählten Vorschlag. Bei den meisten Berechtigungsaufforderungen öffnet dies mit **Ja** oder **Nein** fokussiert ein Kommentarfeld für diese Option, und das erneute Drücken schließt das Feld. Siehe [Kommentar hinzufügen, wenn Sie eine Berechtigungsaufforderung beantworten](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt) |38| `Tab` | Einen Autovervollständigungsvorschlag akzeptieren oder einen Kommentar zu einer Berechtigungsantwort hinzufügen | Während Autovervollständigungsvorschläge in der Eingabeaufforderung angezeigt werden, akzeptiert dies den ausgewählten Vorschlag. Bei den meisten Berechtigungsaufforderungen öffnet dies mit **Ja** oder **Nein** fokussiert ein Kommentarfeld für diese Option, und das erneute Drücken schließt das Feld. Siehe [Kommentar hinzufügen, wenn Sie eine Berechtigungsaufforderung beantworten](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

39| `Pfeiltasten oben/unten` oder `Ctrl+P`/`Ctrl+N` | Cursor verschieben oder Befehlsverlauf navigieren | Wenn sich die Eingabe über mehr als eine visuelle Zeile erstreckt, ob umgebrochen oder mehrzeilig, verschiebt dies zunächst den Cursor in der Eingabeaufforderung. Sobald sich der Cursor in der ersten oder letzten visuellen Zeile befindet, navigiert das erneute Drücken durch den Befehlsverlauf. Während Sie Nachrichten in der Warteschlange haben, [nimmt Oben aus der ersten Zeile diese stattdessen zurück](#take-back-what-you-queued) |39| `Pfeiltasten oben/unten` oder `Ctrl+P`/`Ctrl+N` | Cursor verschieben oder Befehlsverlauf navigieren | Wenn sich die Eingabe über mehr als eine visuelle Zeile erstreckt, ob umgebrochen oder mehrzeilig, verschiebt dies zunächst den Cursor in der Eingabeaufforderung. Sobald sich der Cursor in der ersten oder letzten visuellen Zeile befindet, navigiert das erneute Drücken durch den Befehlsverlauf. Während Sie Nachrichten in der Warteschlange haben, [nimmt Oben aus der ersten Zeile diese stattdessen zurück](#take-back-what-you-queued) |

40| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Werkzeugaufruf in der Mitte des Zuges, damit Sie umleiten können. Claude behält die bisherige Arbeit bei. Wenn Sie [Nachrichten in der Warteschlange haben](#queue-messages-while-claude-works), sendet Claude Code diese als nächstes. Wenn ein Dialog offen ist, schließt `Esc` den Dialog. Bei einer Berechtigungsaufforderung lehnt `Esc` die Aktion ab, genauso wie [**Nein** ohne Kommentar](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt) |40| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Werkzeugaufruf in der Mitte des Zuges, damit Sie umleiten können. Claude behält die bisherige Arbeit bei. Wenn Sie [Nachrichten in der Warteschlange haben](#queue-messages-while-claude-works), sendet Claude Code diese als nächstes. Wenn ein Dialog offen ist, schließt `Esc` den Dialog. Während ein Fußzeilenelement ausgewählt ist, wie eine Zeile im [Subagenten-Panel](/docs/de/sub-agents#run-subagents-in-foreground-or-background) unter der Eingabeaufforderung, [hebt `Esc` die Auswahl auf](/docs/de/keybindings#footer-actions), anstatt zu unterbrechen. Bei einer Berechtigungsaufforderung lehnt `Esc` die Aktion ab, genauso wie [**Nein** ohne Kommentar](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

41| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Eingabeaufforderung Text enthält, löscht doppeltes `Esc` diesen und speichert den Entwurf im Verlauf, damit `Oben` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](/docs/de/checkpointing), um Code und Gespräch von einem früheren Punkt wiederherzustellen oder zusammenzufassen |41| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Eingabeaufforderung Text enthält, löscht doppeltes `Esc` diesen und speichert den Entwurf im Verlauf, damit `Oben` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](/docs/de/checkpointing), um Code und Gespräch von einem früheren Punkt wiederherzustellen oder zusammenzufassen |

42| `Ctrl+Enter` oder `Ctrl+X Ctrl+S` | Warteschlangen-Nachrichten jetzt senden | Sendet Ihre [Nachrichten in der Warteschlange](#queue-messages-while-claude-works) und Ihren Entwurf mit ihnen sofort. [Wenn Claude Code das sendet, das Sie in die Warteschlange eingereiht haben](#when-claude-code-sends-what-you-queued) behandelt, was mit dem Zug passiert, an dem Claude arbeitet. Im [Shell-Modus](#shell-mode-with-prefix) reiht der Schlüssel Ihren Befehl nur in die Warteschlange ein. In Terminals, die erweiterte Tasten nicht melden, kommt `Ctrl+Enter` als einfaches `Enter` an; `Ctrl+X Ctrl+S` funktioniert in jedem Terminal. Erfordert Claude Code v2.1.275 oder später |42| `Ctrl+Enter` oder `Ctrl+X Ctrl+S` | Warteschlangen-Nachrichten jetzt senden | Sendet Ihre [Nachrichten in der Warteschlange](#queue-messages-while-claude-works) und Ihren Entwurf mit ihnen sofort. [Wenn Claude Code das sendet, das Sie in die Warteschlange eingereiht haben](#when-claude-code-sends-what-you-queued) behandelt, was mit dem Zug passiert, an dem Claude arbeitet. Im [Shell-Modus](#shell-mode-with-prefix) reiht der Schlüssel Ihren Befehl nur in die Warteschlange ein. In Terminals, die erweiterte Tasten nicht melden, kommt `Ctrl+Enter` als einfaches `Enter` an; `Ctrl+X Ctrl+S` funktioniert in jedem Terminal. Erfordert Claude Code v2.1.275 oder später |

43| `Shift+Tab` oder `Alt+M` unter Windows, wenn die Node- oder Bun-Laufzeit den VT-Eingabemodus nicht aktiviert | Berechtigungsmodi durchlaufen | Durchlaufen Sie `default` (im Modusindikator als Manuell gekennzeichnet), `acceptEdits`, `plan` und, falls verfügbar, `bypassPermissions` und dann `auto`. Von `auto` wechselt der erste Druck zu `default`. Siehe [Berechtigungsmodi](/docs/de/permission-modes). Bei einer Dateiberechtigungsaufforderung schließt dieselbe Taste ein offenes [Kommentarfeld](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt). Ohne offenes Feld wählt es die Option aus, die die Aktion für den Rest der Sitzung ermöglicht, wenn die Aufforderung diese Option anbietet |43| `Shift+Tab` oder `Alt+M` unter Windows, wenn die Node- oder Bun-Laufzeit den VT-Eingabemodus nicht aktiviert | Berechtigungsmodi durchlaufen | Durchlaufen Sie `default` (im Modusindikator als Manuell gekennzeichnet), `acceptEdits`, `plan` und, falls verfügbar, `bypassPermissions` und dann `auto`. Von `auto` wechselt der erste Druck zu `default`. Siehe [Berechtigungsmodi](/docs/de/permission-modes). Bei einer Dateiberechtigungsaufforderung schließt dieselbe Taste ein offenes [Kommentarfeld](/docs/de/permissions#add-a-comment-when-you-answer-a-permission-prompt). Ohne offenes Feld wählt es die Option aus, die die Aktion für den Rest der Sitzung ermöglicht, wenn die Aufforderung diese Option anbietet |

45| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Erweitertes Denken umschalten | Aktivieren oder deaktivieren Sie den erweiterten Denkmodus. Hat keine Auswirkung auf Opus 5.5 oder die Fable-Modelle, die immer erweitertes Denken verwenden. Funktioniert auf macOS ohne Konfiguration von Option als Meta |45| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Erweitertes Denken umschalten | Aktivieren oder deaktivieren Sie den erweiterten Denkmodus. Hat keine Auswirkung auf Opus 5.5, Sonnet 5.5 oder die Fable-Modelle, die immer erweitertes Denken verwenden. Funktioniert auf macOS ohne Konfiguration von Option als Meta |

47 47

48<h3 id="text-editing">48<h3 id="text-editing">

235| Befehl | Aktion |235| Befehl | Aktion |

236| :- | :- |236| :- | :- |

237| `x` | Zeichen löschen |237| `x` | Zeichen löschen |

238| `r{char}` | Zeichen unter dem Cursor durch `{char}` ersetzen |

238| `dd` | Zeile löschen |239| `dd` | Zeile löschen |

239| `D` | Bis zum Ende der Zeile löschen |240| `D` | Bis zum Ende der Zeile löschen |

241| `df{char}`/`dt{char}` | Bis zum nächsten Vorkommen eines Zeichens löschen und einschließen, oder bis dahin |242| `df{char}`/`dt{char}` | Bis zum nächsten Vorkommen eines Zeichens löschen und einschließen, oder bis dahin |

243| `dj`/`dk` | Die aktuelle Zeile und die Zeile darunter oder darüber löschen |

244| `dgg`/`dG` | Von der aktuellen Zeile bis zur ersten oder letzten Zeile löschen |

245| `d0`/`c0`/`y0` | Vom Cursor bis zum Anfang der Zeile löschen, ändern oder yanken. Erfordert Claude Code v2.1.281 oder später |

242| `cc` | Zeile ändern |246| `cc` | Zeile ändern |

243| `C` | Bis zum Ende der Zeile ändern |247| `C` | Bis zum Ende der Zeile ändern |

342* Claude Code auffordern, einen Befehl im Hintergrund auszuführen346* Claude Code auffordern, einen Befehl im Hintergrund auszuführen

343* `Ctrl+B` drücken, um eine reguläre Bash-Tool-Invokation in den Hintergrund zu verschieben. Tmux-Benutzer müssen `Ctrl+B` zweimal drücken, da Tmux eine Präfixaste hat.347* `Ctrl+B` drücken, um eine reguläre Bash-Tool-Invokation in den Hintergrund zu verschieben. Tmux-Benutzer müssen `Ctrl+B` zweimal drücken, da Tmux eine Präfixaste hat.

344 348

349Wenn ein Befehl sein Timeout erreicht, bevor er abgeschlossen ist, verschiebt Claude Code ihn automatisch [in den Hintergrund](/docs/de/tools-reference#background-commands), anstatt ihn zu stoppen, es sei denn, der Befehl beginnt mit `sleep`. Um zu ändern, wie lange Befehle ausgeführt werden, bevor dies geschieht, stellen Sie die [Bash-Timeout-Umgebungsvariablen](/docs/de/tools-reference#timeout-and-output-limits) ein.

350

345**Wichtigste Funktionen:**351**Wichtigste Funktionen:**

346 352

347* Die Ausgabe wird in eine Datei geschrieben und Claude kann sie mit dem Read-Tool abrufen353* Die Ausgabe wird in eine Datei geschrieben und Claude kann sie mit dem Read-Tool abrufen

395 Nachrichten in die Warteschlange einreihen, während Claude arbeitet401 Nachrichten in die Warteschlange einreihen, während Claude arbeitet

396</h2>402</h2>

397 403

398Geben Sie eine Nachricht ein und drücken Sie `Enter`, während Claude arbeitet. Claude Code reiht die Nachricht in die Warteschlange ein, anstatt den Zug zu unterbrechen, und listet die eingereihten Einträge über dem Eingabefeld auf, bis sie gesendet werden. Sie können `!` [Shell-Befehle](#shell-mode-with-prefix) und die meisten [Befehle](/docs/de/commands) auf die gleiche Weise einreihen, mit Ausnahme von Befehlen wie `/status`, die Claude Code sofort nach dem Senden ausführt.404Geben Sie eine Nachricht ein und drücken Sie `Enter`, während Claude arbeitet. Claude Code reiht die Nachricht in die Warteschlange ein, anstatt den Zug zu unterbrechen, und listet die eingereihten Einträge in der Konversation auf, bis sie gesendet werden. Sie können `!` [Shell-Befehle](#shell-mode-with-prefix) und die meisten [Befehle](/docs/de/commands) auf die gleiche Weise einreihen, mit Ausnahme von Befehlen wie `/status`, die Claude Code sofort nach dem Senden ausführt.

399 405

400Gesendete und eingereihte Nachrichten werden grau angezeigt, bis Claude mit der Antwort beginnt, sodass Sie sehen können, welche Nachrichten Claude noch nicht bearbeitet hat.406Gesendete und eingereihte Nachrichten werden grau angezeigt, bis Claude mit der Antwort beginnt, sodass Sie sehen können, welche Nachrichten Claude noch nicht bearbeitet hat.

401 407

408Wenn Sie eine Nachricht mit einer Auswahl aus einer [verbundenen IDE](/docs/de/vs-code#the-built-in-ide-mcp-server) oder dem [Diff-Panel](#diff-panel) einreihen, behält sie die Auswahl bei, die Sie hatten, als Sie `Enter` drückten, unabhängig davon, was Sie danach auswählen.

409

402<h3 id="when-claude-code-sends-what-you-queued">410<h3 id="when-claude-code-sends-what-you-queued">

403 Wann Claude Code das Eingereihte sendet411 Wann Claude Code das Eingereihte sendet

404</h3>412</h3>

jetbrains.md +5 −1

Details

249 249

250Der Server heißt `ide` und ist in `/mcp` verborgen, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen [`PreToolUse` Hook](/docs/de/hooks#pretooluse) verwendet, um MCP-Tools auf eine Zulassungsliste zu setzen, müssen Sie wissen, dass er existiert.250Der Server heißt `ide` und ist in `/mcp` verborgen, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen [`PreToolUse` Hook](/docs/de/hooks#pretooluse) verwendet, um MCP-Tools auf eine Zulassungsliste zu setzen, müssen Sie wissen, dass er existiert.

251 251

252**Auswahl und Kontext der offenen Datei.** Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine `⧉ Selected N lines from <file>` Zeile, wenn dies geschieht. Um eine sensible Datei wie `.env` auszuschließen, fügen Sie eine [`Read` Ablehnungsregel](/docs/de/permissions#read-and-edit) für ihren Pfad hinzu. Eine entsprechende Ablehnungsregel verhindert, dass sowohl der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.252**Auswahl und Kontext der offenen Datei.** Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine `⧉ Selected N lines from <file>` Zeile, wenn dies geschieht.

253

254Wenn Sie [eine Nachricht in die Warteschlange einreihen, während Claude arbeitet](/docs/de/interactive-mode#queue-messages-while-claude-works), behält es die Auswahl, die Sie beim Drücken von `Enter` hatten, unabhängig davon, was Sie danach auswählen.

255

256Um eine sensible Datei wie `.env` auszuschließen, fügen Sie eine [`Read` Ablehnungsregel](/docs/de/permissions#read-and-edit) für ihren Pfad hinzu. Eine entsprechende Ablehnungsregel verhindert, dass sowohl der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.

253 257

254**Transport und Authentifizierung.** Der Server lauscht auf einem vom Betriebssystem zugewiesenen kurzlebigen Port, und der Port ist nicht konfigurierbar. Der Transport ist unverschlüsseltes `ws://`; auf Loopback kann jeder Prozess, der den Datenverkehr erfassen kann, auch das Token aus der Lock-Datei lesen, daher würde TLS keinen Schutz gegen einen lokalen Angreifer bieten. Jeder IDE-Start generiert ein neues zufälliges Auth-Token, schreibt es in eine Lock-Datei unter `~/.claude/ide/<port>.lock`, und die CLI muss es als `X-Claude-Code-Ide-Authorization` Header präsentieren, um sich zu verbinden. Wenn `CLAUDE_CONFIG_DIR` gesetzt ist, wird die Lock-Datei stattdessen in `$CLAUDE_CONFIG_DIR/ide/` geschrieben.258**Transport und Authentifizierung.** Der Server lauscht auf einem vom Betriebssystem zugewiesenen kurzlebigen Port, und der Port ist nicht konfigurierbar. Der Transport ist unverschlüsseltes `ws://`; auf Loopback kann jeder Prozess, der den Datenverkehr erfassen kann, auch das Token aus der Lock-Datei lesen, daher würde TLS keinen Schutz gegen einen lokalen Angreifer bieten. Jeder IDE-Start generiert ein neues zufälliges Auth-Token, schreibt es in eine Lock-Datei unter `~/.claude/ide/<port>.lock`, und die CLI muss es als `X-Claude-Code-Ide-Authorization` Header präsentieren, um sich zu verbinden. Wenn `CLAUDE_CONFIG_DIR` gesetzt ist, wird die Lock-Datei stattdessen in `$CLAUDE_CONFIG_DIR/ide/` geschrieben.

255 259

keybindings.md +49 −28

Details

22| `$docs` | Optionale Dokumentations-URL |22| `$docs` | Optionale Dokumentations-URL |

23| `bindings` | Array von Binding-Blöcken nach Kontext |23| `bindings` | Array von Binding-Blöcken nach Kontext |

24 24

~~25Dieses Beispiel bindet `Ctrl+E` zum Öffnen eines externen Editors im Chat-Kontext und hebt die Bindung von `Ctrl+U` auf:~~25Dieses Beispiel bindet `Ctrl+E` zum Öffnen eines externen Editors im Chat-Kontext und hebt die Bindung von `Ctrl+S` auf:

26 26

27```json theme={null}27```json theme={null}

28{28{

33 "context": "Chat",33 "context": "Chat",

34 "bindings": {34 "bindings": {

35 "ctrl+e": "chat:externalEditor",35 "ctrl+e": "chat:externalEditor",

~~36 "ctrl+u": null~~36 "ctrl+s": null

37 }37 }

38 }38 }

39 ]39 ]

44 Kontexte44 Kontexte

45</h2>45</h2>

46 46

~~47Jeder Binding-Block gibt einen **Kontext** an, in dem die Bindings gelten:~~47Jeder Bindungsblock gibt einen **Kontext** an, in dem die Bindungen gelten:

48 48

49| Kontext | Beschreibung |49| Kontext | Beschreibung |

50| :- | :- |50| :- | :- |

51| `Global` | Gilt überall in der App |51| `Global` | Gilt überall in der App |

52| `Chat` | Haupteingabebereich für Chat |52| `Chat` | Haupteingabebereich für Chat |

54| `Settings` | Einstellungsmenü |54| `Settings` | Einstellungsmenü |

55| `Confirmation` | Berechtigungs- und Bestätigungsdialoge |55| `Confirmation` | Berechtigungs- und Bestätigungsdialoge |

56| `Tabs` | Tab-Navigationskomponenten |56| `Tabs` | Tab-Navigationskomponenten |

57| `Help` | Hilfemenü ist sichtbar |57| `Help` | Hilfemenü ist sichtbar |

58| `Transcript` | Transkript-Viewer |58| `Transcript` | Transkript-Viewer |

62| `Attachments` | Bildanhang-Navigation in Auswahldialogen |62| `Attachments` | Bildanhang-Navigation in Auswahldialogen |

65| `DiffDialog` | Diff-Viewer-Navigation |65| `DiffDialog` | Diff-Viewer-Navigation |

66| `DiffPanel` | Das [Diff-Panel](/docs/de/interactive-mode#diff-panel) ist offen |66| `DiffPanel` | Das [Diff-Panel](/docs/de/interactive-mode#diff-panel) ist offen |

70| `Plugin` | Plugin-Dialog (durchsuchen, entdecken, verwalten) |70| `Plugin` | Plugin-Dialog (durchsuchen, entdecken, verwalten) |

71| `Agents` | [Agent-Ansicht](/docs/de/agent-view) (`claude agents`) |71| `Agents` | [Agent-Ansicht](/docs/de/agent-view) (`claude agents`) |

72| `Scroll` | Konversations-Scrolling und Textauswahl im Vollbildmodus |72| `Scroll` | Konversations-Scrolling und Textauswahl im Vollbildmodus |

73 73

~~74Vor v2.1.205 existierten ein `Doctor`-Kontext und eine `doctor:fix`-Aktion für den `/doctor`-Diagnose-Bildschirm.~~74Vor v2.1.205 existierten ein `Doctor`-Kontext und eine `doctor:fix`-Aktion für den `/doctor`-Diagnosebildschirm.

75 75

76<h2 id="available-actions">76<h2 id="available-actions">

77 Verfügbare Aktionen77 Verfügbare Aktionen

168 168

169Dialoge verwenden `confirm:yes` und `confirm:no`, um zu akzeptieren und abzubrechen, auch wenn sie keine Ja-oder-Nein-Frage stellen. Wenn Sie einen bloßen Buchstaben wie `y` oder `n` in diesem Kontext binden, wirkt sich der Buchstabe auch auf Dialoge aus, die ihn nie als Taste anzeigen. Ein Dialog, der `y` und `n` als seine Tasten anzeigt, liest diese Buchstaben selbst und benötigt keine Bindung.169Dialoge verwenden `confirm:yes` und `confirm:no`, um zu akzeptieren und abzubrechen, auch wenn sie keine Ja-oder-Nein-Frage stellen. Wenn Sie einen bloßen Buchstaben wie `y` oder `n` in diesem Kontext binden, wirkt sich der Buchstabe auch auf Dialoge aus, die ihn nie als Taste anzeigen. Ein Dialog, der `y` und `n` als seine Tasten anzeigt, liest diese Buchstaben selbst und benötigt keine Bindung.

170 170

171In den meisten Dialogen schließt das Drücken von `Ctrl+C` oder `Ctrl+D` zweimal den Dialog, anstatt Claude Code zu beenden. Der Hinweis nach dem ersten Drücken sagt, ob das zweite Drücken den Dialog schließt oder Claude Code beendet. Beide Tasten sind [reserviert](#reserved-shortcuts) und können nicht neu gebunden werden.

172

171Dieses Beispiel bindet `y` an `confirm:yes` und `n` an `confirm:no`:173Dieses Beispiel bindet `y` an `confirm:yes` und `n` an `confirm:no`:

172 174

173```json theme={null}175```json theme={null}

270 272

273In einem Tabbed-Dialog wechseln `tabs:next` und `tabs:previous` die Tabs, während die Tab-Zeile den Fokus hat. In einigen Dialogen, wie `/help` und `/sandbox`, funktionieren die Tab-Wechsel-Tasten auch von innerhalb des Tab-Inhalts.

274

275`Oben` und `Unten` verschieben den Fokus zwischen der Tab-Zeile und dem Tab-Inhalt, und eine Liste im Inhalt reagiert nur auf Tasten, wenn sie den Fokus hat.

276

271<h3 id="attachments-actions">277<h3 id="attachments-actions">

272 Anhänge-Aktionen278 Anhänge-Aktionen

273</h3>279</h3>

298| `footer:dismiss` | Rücktaste, Löschen | Ausgewählten [Artefakt](/docs/de/artifacts)-Link aus der Fußzeile entfernen; das veröffentlichte Artefakt selbst ist nicht betroffen. Bei anderen Fußzeilenzeilen haben diese Tasten keine Auswirkung. Erfordert v2.1.217 oder später |304| `footer:dismiss` | (nicht gebunden) | In v2.1.281 entfernt. Eine `keybindings.json`, die die Aktion noch benennt, bleibt gültig, und die Bindung tut nichts. Vor v2.1.281 schließen Rücktaste und Löschen den ausgewählten Artefakt-Link aus der Fußzeile |

299 305

300Während ein Fußzeilen-Element ausgewählt ist, wie eine Zeile im Agent-Panel unter der Eingabeaufforderung, öffnet `Enter` es auch, wenn Sie `Enter` im `Chat`-Kontext zu `chat:queueSubmit` oder `chat:newline` neu binden.306Während ein Fußzeilen-Element ausgewählt ist, wie eine Zeile im Agent-Panel unter der Eingabeaufforderung, öffnet `Enter` es auch, wenn Sie `Enter` im `Chat`-Kontext zu `chat:queueSubmit` oder `chat:newline` neu binden.

301 307

305 Nachrichtenauswahl-Aktionen311 Nachrichtenauswahl-Aktionen

306</h3>312</h3>

307 313

308Aktionen verfügbar im `MessageSelector`-Kontext:314In der Nachrichtenliste des [Rewind-Menüs](/docs/de/checkpointing) bewegen Sie sich durch Nachrichten und wählen eine mit den [Select-Aktionen](#select-actions) und ihren Standardtasten aus. Ihre `Select`-Bindungen für diese Aktionen gelten auch dort. Der `MessageSelector`-Kontext hat keine eigenen Aktionen oder Standardbindungen. Verwenden Sie ihn, um einen Schlüssel nur für diese Liste zu ändern, indem Sie eine Select-Aktion wie `select:accept` in einem `MessageSelector`-Block binden.

309 315

310| Aktion | Standard | Beschreibung |316Dieses Beispiel bindet `o` zum Auswählen der hervorgehobenen Nachricht im Rewind-Menü, ohne andere Listen zu ändern:

311| :- | :- | :- |317

312| `messageSelector:up` | Oben, K, Ctrl+P | In der Liste nach oben bewegen |318```json theme={null}

313| `messageSelector:down` | Unten, J, Ctrl+N | In der Liste nach unten bewegen |319{

314| `messageSelector:top` | Ctrl+Oben, Shift+Oben, Meta+Oben, Shift+K | Zum Anfang springen |320 "bindings": [

315| `messageSelector:bottom` | Ctrl+Unten, Shift+Unten, Meta+Unten, Shift+J | Zum Ende springen |321 {

316| `messageSelector:select` | Enter | Nachricht auswählen |322 "context": "MessageSelector",

323 "bindings": {

324 "o": "select:accept"

325 }

326 }

327 ]

328}

329```

330

331Vor v2.1.283 ignorierte diese Liste `Select`-Bindungen und hatte ihre eigenen Aktionen: `messageSelector:up`, `messageSelector:down`, `messageSelector:top`, `messageSelector:bottom` und `messageSelector:select`. Wenn Ihre `keybindings.json` einen dieser Namen bindet, bleibt die Bindung in dieser Liste als Select-Aktion wirksam, die dasselbe tut. `Home` und `End` springen zu beiden Enden der Liste; vor v2.1.283 taten das Tasten wie `Shift+K` und `Shift+J` standardmäßig.

317 332

318<h3 id="diff-actions">333<h3 id="diff-actions">

319 Diff-Aktionen334 Diff-Aktionen

331| `diff:viewDetails` | Enter | Diff-Details anzeigen |

332| `diff:back` | (nicht gebunden) | Im Diff-Viewer zurückgehen. Escape führt die Zurück-Aktion über `diff:dismiss` aus. Der vorherige Standard von Links in der Detailansicht wurde in v2.1.203 entfernt |346| `diff:back` | (nicht gebunden) | Im Diff-Viewer zurückgehen. Escape führt die Zurück-Aktion über `diff:dismiss` aus. Der vorherige Standard von Links in der Detailansicht wurde in v2.1.203 entfernt |

333 347

334Die Detailansicht des Diff bindet auch Pager-ähnliche Tasten an die Standard-[Scroll-Aktionen](#scroll-actions). Diese Bindungen sind Teil des `DiffDialog`-Kontexts und gelten nur in der Detailansicht; die `Scroll`-Kontext-Standards, die unter [Scroll-Aktionen](#scroll-actions) aufgelistet sind, bleiben unverändert.348Die Dateiliste reagiert auch auf die [Select-Aktionen](#select-actions), durch ihre Standardtasten und Ihre `Select`-Bindungen. `select:previous` und `select:next` bewegen sich zur vorherigen und nächsten Datei, und `Enter` öffnet den Diff der ausgewählten Datei über `select:accept`. Um einen dieser Schlüssel nur für die Dateiliste zu ändern, binden Sie die Select-Aktion in einem `DiffDialog`-Block.

349

350Vor v2.1.283 ignorierte die Dateiliste `Select`-Bindungen, und `Enter` öffnete den Diff der ausgewählten Datei über eine separate `diff:viewDetails`-Aktion. Wenn Ihre `keybindings.json` `diff:viewDetails` bindet, bleibt die Bindung in der Dateiliste als `select:accept` wirksam.

351

352Die Diff-Detailansicht bindet auch Pager-ähnliche Tasten an die Standard-[Scroll-Aktionen](#scroll-actions). Diese Bindungen sind Teil des `DiffDialog`-Kontexts und gelten nur in der Detailansicht; die `Scroll`-Kontext-Standards, die unter [Scroll-Aktionen](#scroll-actions) aufgelistet sind, bleiben unverändert.

335 353

337| :- | :- | :- |355| :- | :- | :- |

373 Effort-Schieberegler-Aktionen391 Effort-Schieberegler-Aktionen

374</h3>392</h3>

375 393

376Aktionen verfügbar im `EffortSlider`-Kontext, dem Schieberegler, der sich öffnet, wenn Sie `/effort` ohne Argumente ausführen. Die Tasten Links, Rechts, Enter und Escape des Schiebereglers können nicht neu gebunden werden.394Aktionen verfügbar im `EffortSlider`-Kontext, dem Schieberegler, der sich öffnet, wenn Sie `/effort` ohne Argumente ausführen. Die Tasten Enter und Escape des Schiebereglers können nicht neu gebunden werden.

377 395

379| :- | :- | :- |397| :- | :- | :- |

398| `effortSlider:decreaseEffort` | Links | Schieberegler zur nächsten niedrigeren Aufwandsstufe verschieben. Erfordert v2.1.284 oder später |

399| `effortSlider:increaseEffort` | Rechts | Schieberegler zur nächsten höheren Aufwandsstufe verschieben. Erfordert v2.1.284 oder später |

400| `effortSlider:toggleUltracode` | Tab | [Ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) für diese Sitzung ein- oder ausschalten, wenn der Schieberegler [es anbietet](/docs/de/model-config#when-ultracode-is-available). Erfordert v2.1.284 oder später |

380| `effortSlider:thisSessionOnly` | s | Wenden Sie die fokussierte [Aufwandsstufe](/docs/de/model-config#adjust-effort-level) nur auf diese Sitzung an. Erfordert v2.1.257 oder später |401| `effortSlider:thisSessionOnly` | s | Wenden Sie die fokussierte [Aufwandsstufe](/docs/de/model-config#adjust-effort-level) nur auf diese Sitzung an. Erfordert v2.1.257 oder später |

381 402

382<h3 id="select-actions">403<h3 id="select-actions">

398 419

399Claude Code wendet Ihre `select:pageUp`-, `select:pageDown`-, `select:first`- und `select:last`-Bindungen im `/skills`-Menü an. In den meisten anderen Listen, wie dem `/model`-Picker, gelten Ihre `select:first`- und `select:last`-Bindungen. Bild-Auf und Bild-Ab blättern durch die Optionen in diesen Listen unabhängig von Ihren Bindungen.420Claude Code wendet Ihre `select:pageUp`-, `select:pageDown`-, `select:first`- und `select:last`-Bindungen in Listenpanels wie `/skills` und `/mcp` an. In den meisten anderen Listen, wie dem `/model`-Picker, gelten Ihre `select:first`- und `select:last`-Bindungen. Bild-Auf und Bild-Ab blättern durch die Optionen in diesen Listen unabhängig von Ihren Bindungen.

400 421

401Vor v2.1.280 ignorierten diese anderen Listen Pos1, Ende und Ihre `select:first`- und `select:last`-Bindungen.422Vor v2.1.280 ignorierten diese anderen Listen Pos1, Ende und Ihre `select:first`- und `select:last`-Bindungen.

402 423

668 Validierung689 Validierung

669</h2>690</h2>

670 691

671Claude Code validiert Ihre Keybindings und zeigt Warnungen für:692Claude Code validiert Ihre Keybindings und schreibt eine Warnung in das Debug-Protokoll für:

672 693

673* Parse-Fehler (ungültiges JSON oder Struktur)694* Parse-Fehler (ungültiges JSON oder Struktur)

674* Ungültige Kontextnamen695* Ungültige Kontextnamen

677* Reservierte Kürzel-Konflikte698* Reservierte Kürzel-Konflikte

678* Doppelte Bindings im selben Kontext699* Doppelte Bindings im selben Kontext

679 700

680Claude Code meldet Warnungen, wenn die Datei geladen wird, und schreibt jede einzelne in das Debug-Protokoll. Starten Sie Claude Code mit [`--debug`](/docs/de/cli-reference#cli-flags), um die Details zu sehen.701Starten Sie Claude Code mit [`--debug`](/docs/de/cli-reference#cli-flags), um die Details zu sehen.

llm-gateway.md +1 −1

Details

49 Abonnements und Gateways49 Abonnements und Gateways

50</h2>50</h2>

51 51

52Während eine [Gateway-Anmeldedaten-Variable](/docs/de/llm-gateway-connect#set-the-credential-variable) oder `apiKeyHelper` aktiv ist, wird das claude.ai-Abonnement eines Entwicklers nicht verwendet: Das Anmeldedaten ersetzt die Abonnement-Anmeldung für diese Sitzung, und die Nutzungslimits des Abonnements gelten nicht. Dieser Verkehr wird pro Token dem Besitzer des Anmeldedaten, das das Gateway weiterleitet, wie Ihr Anthropic Console-Konto der Organisation oder Ihr Bedrock-, Agent Platform- oder Foundry-Konto, wenn das Gateway dorthin leitet, in Rechnung gestellt.52Während eine [Gateway-Anmeldedaten-Variable](/docs/de/llm-gateway-connect#set-the-credential-variable) oder `apiKeyHelper` aktiv ist, werden Anfragen mit dieser Anmeldedaten anstelle der claude.ai-Abonnement-Anmeldung eines Entwicklers übermittelt, und die Nutzungslimits des Abonnements gelten nicht für sie. Claude Code speichert eine claude.ai-Anmeldung auf dem Computer, sendet sie aber nicht mit diesen Anfragen. Dieser Datenverkehr wird pro Token dem Besitzer der Anmeldedaten, die das Gateway weiterleitet, wie Ihr Anthropic Console-Konto der Organisation oder Ihr Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Konto, wenn das Gateway dorthin leitet, in Rechnung gestellt.

53 53

54[`ANTHROPIC_BASE_URL`](/docs/de/llm-gateway-connect#set-the-base-url-and-credential) ist die Variable, die Claude Code auf das Gateway verweist. Das Setzen nur dieser Variable ohne Gateway-Anmeldedaten ersetzt das Abonnement nicht. Anfragen werden immer noch über das Gateway geleitet, aber eine gespeicherte claude.ai-Anmeldung bleibt das aktive Anmeldedaten, daher gelten seine Nutzungslimits und Abrechnung. Gateways, die diesen Verkehr an Anthropic weitergeben, müssen die OAuth-Fähigkeit in `anthropic-beta` weiterleiten; siehe die [Request-Header-Referenz](/docs/de/llm-gateway-protocol#request-headers).54[`ANTHROPIC_BASE_URL`](/docs/de/llm-gateway-connect#set-the-base-url-and-credential) ist die Variable, die Claude Code auf das Gateway verweist. Das Setzen nur dieser Variable ohne Gateway-Anmeldedaten ersetzt das Abonnement nicht. Anfragen werden immer noch über das Gateway geleitet, aber eine gespeicherte claude.ai-Anmeldung bleibt das aktive Anmeldedaten, daher gelten seine Nutzungslimits und Abrechnung. Gateways, die diesen Verkehr an Anthropic weitergeben, müssen die OAuth-Fähigkeit in `anthropic-beta` weiterleiten; siehe die [Request-Header-Referenz](/docs/de/llm-gateway-protocol#request-headers).

55 55

llm-gateway-connect.md +2 −2

Details

140<Tabs>140<Tabs>

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

142 ```bash theme={null}142 ```bash theme={null}

143 curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \143 curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \

144 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \144 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \

145 -H "anthropic-version: 2023-06-01" \145 -H "anthropic-version: 2023-06-01" \

146 -H "content-type: application/json" \146 -H "content-type: application/json" \

594| `/fast` meldet `Fast mode has been disabled by your organization` in einer Sitzung, die mit `ANTHROPIC_AUTH_TOKEN` authentifiziert ist, obwohl die Organisation Fast-Mode aktiviert hat | Die Verfügbarkeitsprüfung erfordert einen claude.ai-Login oder einen Anthropic-API-Schlüssel; mit nur einem Bearer-Token behandelt Claude Code Fast-Mode als deaktiviert, ohne die Prüfung zu senden | Legen Sie `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` fest; siehe [Fast-Mode hinter Proxys und LLM-Gateways verwenden](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |594| `/fast` meldet `Fast mode has been disabled by your organization` in einer Sitzung, die mit `ANTHROPIC_AUTH_TOKEN` authentifiziert ist, obwohl die Organisation Fast-Mode aktiviert hat | Die Verfügbarkeitsprüfung erfordert einen claude.ai-Login oder einen Anthropic-API-Schlüssel; mit nur einem Bearer-Token behandelt Claude Code Fast-Mode als deaktiviert, ohne die Prüfung zu senden | Legen Sie `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` fest; siehe [Fast-Mode hinter Proxys und LLM-Gateways verwenden](/docs/de/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

595| Claude Code fordert Sie auf, sich anzumelden, obwohl der [curl-Test](#verify-the-connection) erfolgreich ist | Die CLI hat keine eigene Anmeldedaten: Eine erreichbare Basis-URL ist keine, und in einer interaktiven Sitzung gilt ein `env`-Block in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` nur nach dem First-Run-Wizard und der [Vertrauensaufforderung](/docs/de/permissions#what-runs-before-you-trust-a-folder) | Legen Sie `ANTHROPIC_AUTH_TOKEN` irgendwo fest, wo Claude Code vor dem First-Run-Setup liest: ein Shell-Export, der `env`-Block in `~/.claude/settings.json` oder verwaltete Einstellungen |595| Claude Code fordert Sie auf, sich anzumelden, obwohl der [curl-Test](#verify-the-connection) erfolgreich ist | Die CLI hat keine eigene Anmeldedaten: Eine erreichbare Basis-URL ist keine, und in einer interaktiven Sitzung gilt ein `env`-Block in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` nur nach dem First-Run-Wizard und der [Vertrauensaufforderung](/docs/de/permissions#what-runs-before-you-trust-a-folder) | Legen Sie `ANTHROPIC_AUTH_TOKEN` irgendwo fest, wo Claude Code vor dem First-Run-Setup liest: ein Shell-Export, der `env`-Block in `~/.claude/settings.json` oder verwaltete Einstellungen |

596| `ANTHROPIC_API_KEY` ist festgelegt, wird aber ignoriert, ohne Aufforderung | Der Schlüssel benötigt eine einmalige Genehmigung in interaktiven Sitzungen, und ein zuvor abgelehnter Schlüssel wird ohne erneute Frage ignoriert | Aktivieren Sie ihn unter `/config` mit der Option `Use custom API key` |596| `ANTHROPIC_API_KEY` ist festgelegt, wird aber ignoriert, ohne Aufforderung | Der Schlüssel benötigt eine einmalige Genehmigung in interaktiven Sitzungen, und ein zuvor abgelehnter Schlüssel wird ohne erneute Frage ignoriert | Aktivieren Sie ihn unter `/config` mit der Option `Use custom API key` |

597| `This machine's managed settings require a first-party login` | Verwaltete Einstellungen enthalten `forceLoginMethod` oder `forceLoginOrgUUID`, die nicht mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` koexistieren können | Ihr Administrator muss `forceLoginMethod` und `forceLoginOrgUUID` aus verwalteten Einstellungen entfernen, um Gateway-Anmeldedaten zu verwenden, oder die Gateway-Anmeldedaten entfernen, um First-Party-Login zu verwenden. Die beiden können nicht kombiniert werden |597| `This machine's managed settings require a first-party login`, oder [`Administrator policy requires a Cloud gateway sign-in`](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) wenn verwaltete Einstellungen `forceLoginMethod` auf `"gateway"` setzen oder auch `forceLoginGatewayUrl` setzen | Verwaltete Einstellungen enthalten `forceLoginMethod` oder `forceLoginOrgUUID`, die nicht mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` koexistieren können | Ihr Administrator muss `forceLoginMethod`, `forceLoginOrgUUID` und `forceLoginGatewayUrl` aus verwalteten Einstellungen entfernen, um Gateway-Anmeldedaten zu verwenden, oder die Gateway-Anmeldedaten entfernen und die Anmeldung verwenden, die die verwalteten Einstellungen erfordern. Die beiden können nicht kombiniert werden |

598| `403` mit einem HTML-Body wie `403 Forbidden`, wenn die eigenen Logs des Gateways zeigen, dass keine Anfrage empfangen wurde | Eine Web-Anwendungs-Firewall oder ein Reverse-Proxy vor dem Gateway blockierte den Anfrage-Body, bevor er das Gateway erreichte. Claude Code-Eingabeaufforderungen enthalten XML-ähnliche Tags und Quellcode, die Cross-Site-Scripting-Body-Regeln entsprechen, daher besteht ein kurzer curl-Test, während eine echte Sitzung nicht besteht | Befreien Sie den `/v1/messages`-Pfad des Gateways von der Anfrage-Body-Inspektion. Auf AWS WAF ist dies die verwaltete Regel `CrossSiteScripting_Body`; auf nginx mit ModSecurity sind dies die äquivalenten OWASP CRS-Body-Regeln |598| `403` mit einem HTML-Body wie `403 Forbidden`, wenn die eigenen Logs des Gateways zeigen, dass keine Anfrage empfangen wurde | Eine Web-Anwendungs-Firewall oder ein Reverse-Proxy vor dem Gateway blockierte den Anfrage-Body, bevor er das Gateway erreichte. Claude Code-Eingabeaufforderungen enthalten XML-ähnliche Tags und Quellcode, die Cross-Site-Scripting-Body-Regeln entsprechen, daher besteht ein kurzer curl-Test, während eine echte Sitzung nicht besteht | Befreien Sie den `/v1/messages`-Pfad des Gateways von der Anfrage-Body-Inspektion. Auf AWS WAF ist dies die verwaltete Regel `CrossSiteScripting_Body`; auf nginx mit ModSecurity sind dies die äquivalenten OWASP CRS-Body-Regeln |

599| Zertifikat- oder TLS-Fehler wie `SSL certificate verification failed` oder `Self-signed certificate detected`, wenn der [curl-Test](#verify-the-connection) erfolgreich ist | Die Runtime von Claude Code vertraut nicht der gleichen Zertifizierungsstelle, die `curl` verwendet. Häufig hinter Unternehmens-TLS-Inspektions-Proxys | Legen Sie `NODE_EXTRA_CA_CERTS` auf den CA-Bundle-Pfad fest; siehe [CA-Zertifikat-Speicher](/docs/de/network-config#ca-certificate-store) |599| Zertifikat- oder TLS-Fehler wie `SSL certificate verification failed` oder `Self-signed certificate detected`, wenn der [curl-Test](#verify-the-connection) erfolgreich ist | Die Runtime von Claude Code vertraut nicht der gleichen Zertifizierungsstelle, die `curl` verwendet. Häufig hinter Unternehmens-TLS-Inspektions-Proxys | Legen Sie `NODE_EXTRA_CA_CERTS` auf den CA-Bundle-Pfad fest; siehe [CA-Zertifikat-Speicher](/docs/de/network-config#ca-certificate-store) |

600 600

llm-gateway-protocol.md +10 −3

Details

73 73

74Streamen Sie Inferenzantworten. Claude Code liest den Stream, während er ankommt, also wenn Ihr Gateway vollständige Antworten puffert, bevor es sie weiterleitet, stellt Claude Code fest.74Streamen Sie Inferenzantworten. Claude Code liest den Stream, während er ankommt, also wenn Ihr Gateway vollständige Antworten puffert, bevor es sie weiterleitet, stellt Claude Code fest.

75 75

76Liefern Sie die vollständige Ereignissequenz jeder Antwort, ohne Ereignisse zu verwerfen, zu duplizieren oder neu zu ordnen. Wenn ein Ereignis auf einen Inhaltsblock verweist, dessen `content_block_start` nie angekommen ist, oder auf einen Block, dessen `content_block_stop` bereits angekommen ist, stoppt Claude Code das Lesen des Streams bei diesem Ereignis, anstatt es anzuwenden, sodass ein dupliziertes `content_block_stop` denselben Tool-Aufruf nicht zweimal ausführen kann. [Die obige Antwort kann unvollständig sein](/docs/de/errors#the-response-above-may-be-incomplete) beschreibt, was der Benutzer sieht, unter den Varianten `Part of the response never arrived` und `The response stream was malformed`.

78Leiten Sie jede Antwort durch ihre endgültigen `message_delta` und `message_stop` Ereignisse weiter, bevor Sie den Body beenden. Ein Body, der nach einem `message_delta` mit einem `stop_reason` endet, ohne dass noch ein Inhaltsblock offen ist und kein Inhaltsblock-Ereignis nach diesem Frame folgt, zählt als vollständig, auch wenn `message_stop` fehlt. Ein Body, den Ihr Gateway sauberer beendet, sobald ein Inhaltsblock gestartet hat, wird genauso behandelt wie eine unterbrochene Verbindung: [Automatische Wiederholungen](/docs/de/errors#automatic-retries) sagt, wann Claude Code die Anfrage erneut stellt, und [Die obige Antwort kann unvollständig sein](/docs/de/errors#the-response-above-may-be-incomplete) behandelt, was es behält, sobald sichtbarer Inhalt angekommen ist. Claude Code behält den `stop_reason`, den ein `message_delta` liefert, bei, sodass ein späteres nur-Nutzungs-`message_delta`, dessen `delta` `stop_reason: null` oder keinen `stop_reason` Schlüssel hat, ihn nicht löscht.

76Wenn der Client das Amazon Bedrock-Format spricht, leiten Sie den `InvokeModelWithResponseStream` Response-Body und seinen Header `Content-Type: application/vnd.amazon.eventstream` unverändert weiter, und konvertieren Sie den Stream nicht in Server-Sent Events. Siehe [Streaming-Fehler hinter einem Gateway oder Proxy](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).80Wenn der Client das Amazon Bedrock-Format spricht, leiten Sie den `InvokeModelWithResponseStream` Response-Body und seinen Header `Content-Type: application/vnd.amazon.eventstream` unverändert weiter, und konvertieren Sie den Stream nicht in Server-Sent Events. Siehe [Streaming-Fehler hinter einem Gateway oder Proxy](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

77 81

78Leiten Sie auch Keep-Alive-Pings weiter. Bei Verbindungen über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` zählt Claude Code jedes Byte, das Ihr Gateway weiterleitet, einschließlich SSE `ping` Events und Kommentarzeilen, und bricht einen Stream ab, der standardmäßig 300 Sekunden lang stumm ist. Die Pings des Upstream sind der einzige Traffic während langer Denkpausen, also wenn Ihr Gateway sie entfernt oder puffert, bricht Claude Code den Stream während dieser Pausen ab; [Automatische Wiederholungen](/docs/de/errors#automatic-retries) behandelt, was ein abgebrochener Stream basierend darauf meldet, wie weit die Antwort fortgeschritten war. Ein Upstream, der überhaupt keine Pings sendet, wie Amazon Bedrocks binärer Event-Stream, lässt diese Pausen ohne etwas zum Weiterleiten. Beim Übersetzen von einem solchen Upstream geben Sie Ihre eigenen `ping` Events während stiller Lücken aus. Gateways, die über `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_FOUNDRY_BASE_URL` erreicht werden, sind nicht von dieser Byte-Level-Überwachung umgeben, auch wenn sie das Anthropic Messages-Format weitergeleitet; dort bricht ein [5-Minuten-Idle-Timeout](/docs/de/env-vars) einen stummen Stream statt ab, und bei `ANTHROPIC_BEDROCK_BASE_URL` Verbindungen können Sie die Byte-Überwachung mit [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/de/env-vars) hinzufügen.82Leiten Sie auch Keep-Alive-Pings weiter. Bei Verbindungen über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` zählt Claude Code jedes Byte, das Ihr Gateway weiterleitet, einschließlich SSE `ping` Events und Kommentarzeilen, und bricht einen Stream ab, der standardmäßig 300 Sekunden lang stumm ist. Die Pings des Upstream sind der einzige Traffic während langer Denkpausen, also wenn Ihr Gateway sie entfernt oder puffert, bricht Claude Code den Stream während dieser Pausen ab; [Automatische Wiederholungen](/docs/de/errors#automatic-retries) behandelt, was ein abgebrochener Stream basierend darauf meldet, wie weit die Antwort fortgeschritten war. Ein Upstream, der überhaupt keine Pings sendet, wie Amazon Bedrocks binärer Event-Stream, lässt diese Pausen ohne etwas zum Weiterleiten. Beim Übersetzen von einem solchen Upstream geben Sie Ihre eigenen `ping` Events während stiller Lücken aus. Gateways, die über `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_FOUNDRY_BASE_URL` erreicht werden, sind nicht von dieser Byte-Level-Überwachung umgeben, auch wenn sie das Anthropic Messages-Format weitergeleitet; dort bricht ein [5-Minuten-Idle-Timeout](/docs/de/env-vars) einen stummen Stream statt ab, und bei `ANTHROPIC_BEDROCK_BASE_URL` Verbindungen können Sie die Byte-Überwachung mit [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/de/env-vars) hinzufügen.

158 162

159Das Setzen von `CLAUDE_CODE_GATEWAY_HINT_HEADERS` auf `0` stoppt die Header bei jeder Verbindung.163Das Setzen von `CLAUDE_CODE_GATEWAY_HINT_HEADERS` auf `0` stoppt die Header bei jeder Verbindung.

160 164

161Die Header enthalten nur das, was die folgenden Zeilen auflisten: feste Vokabulare, Tool-Namen und Dauern, niemals Prompt-Text oder Dateiinhalte. Jeder Wert ist druckbares ASCII.165Die Header enthalten nur das, was die folgenden Zeilen auflisten: feste Vokabulare, Tool-Namen, Dauern und eine zufällige Prompt-Kennung, niemals Prompt-Text oder Dateiinhalte. Jeder Wert ist druckbares ASCII.

162 166

163| Header | Beschreibung |167| Header | Beschreibung |

164| :- | :- |168| :- | :- |

167| `x-claude-code-compaction` | Vorhanden bei der Anfrage, die das Gespräch während einer [Komprimierung](/docs/de/prompt-caching#compacting-the-conversation) zusammenfasst. Der Wert sagt, was sie ausgelöst hat: `auto`, wenn sich das Kontextfenster der Kapazität näherte, `manual` für `/compact`, oder `reactive`, wenn die API eine Anfrage als zu lang ablehnte. Abwesend bei jeder anderen Anfrage |171| `x-claude-code-compaction` | Vorhanden bei der Anfrage, die das Gespräch während einer [Komprimierung](/docs/de/prompt-caching#compacting-the-conversation) zusammenfasst. Der Wert sagt, was sie ausgelöst hat: `auto`, wenn sich das Kontextfenster der Kapazität näherte, `manual` für `/compact`, oder `reactive`, wenn die API eine Anfrage als zu lang ablehnte. Abwesend bei jeder anderen Anfrage |

168| `x-claude-code-context-compacted` | Vorhanden einmal, bei der ersten Hauptgesprächs-Anfrage nach einer Komprimierung, mit den gleichen Werten wie `x-claude-code-compaction`. Das Gesprächspräfix vor dieser Anfrage wird nicht mehr verwendet, daher kann ein Cache, der darauf basiert, gelöscht werden |172| `x-claude-code-context-compacted` | Vorhanden einmal, bei der ersten Hauptgesprächs-Anfrage nach einer Komprimierung, mit den gleichen Werten wie `x-claude-code-compaction`. Das Gesprächspräfix vor dieser Anfrage wird nicht mehr verwendet, daher kann ein Cache, der darauf basiert, gelöscht werden |

169| `x-claude-code-prev-tool-durations` | Gemessene Laufzeit der Tool-Aufrufe, deren Ergebnisse diese Anfrage trägt, als `<name>=<ms>;<name>=<ms>`, zum Beispiel `Bash=742;Read=9`. Wird bei der nächsten Anfrage desselben Gesprächs nach einem Batch von Tool-Aufrufen gesendet, von der Hauptsitzung oder einem Subagenten |173| `x-claude-code-prev-tool-durations` | Gemessene Laufzeit der Tool-Aufrufe, deren Ergebnisse diese Anfrage trägt, als `<name>=<ms>;<name>=<ms>`, zum Beispiel `Bash=742;Read=9`. Wird bei der nächsten Anfrage desselben Gesprächs nach einem Batch von Tool-Aufrufen gesendet, von der Hauptsitzung oder einem Subagenten |

174| `x-claude-code-prompt-id` | Zufällige UUID, die den Benutzer-Prompt identifiziert, dem eine Anfrage dient. Anfragen, die einen Prompt bedienen, teilen den Wert, einschließlich der Züge von Subagenten, die der Prompt gestartet hat. Anfragen, die nicht einem Prompt zugeordnet sind, lassen ihn weg. Verwenden Sie ihn, um die Anfragen einer Sitzung nach Prompt zu gruppieren. Erfordert Claude Code v2.1.283 oder später |

170 175

171Bevor Sie `x-claude-code-prev-tool-durations` analysieren, überprüfen Sie, wie Claude Code den Wert erstellt und was es auslässt:176Bevor Sie `x-claude-code-prev-tool-durations` analysieren, überprüfen Sie, wie Claude Code den Wert erstellt und was es auslässt:

172 177

265 Deaktivieren Sie Pre-Release-Funktionen270 Deaktivieren Sie Pre-Release-Funktionen

266</h3>271</h3>

267 272

268`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` stoppt Claude Code vom Senden von Pre-Release-Funktionen und ihren Body-Feldern auf jedem Provider, einschließlich Kontextverwaltung und der Beta-Tool-Felder. Die Variable beeinflusst nicht adaptive Reasoning, das nach Modell ausgewählt wird, nicht nach Beta. Sie unterdrückt nie die OAuth-Funktion, die die Abonnement-Authentifizierung benötigt.273`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` stoppt Claude Code vom Senden von Pre-Release-Funktionen und ihren Body-Feldern, einschließlich Kontextverwaltung und der Beta-Tool-Felder. Die Variable beeinflusst nicht adaptive Reasoning, das nach Modell ausgewählt wird, nicht nach Beta. Sie unterdrückt nie die OAuth-Funktion, die die Abonnement-Authentifizierung benötigt.

274

275Wenn eine Host-Plattform, die Claude Code einbettet, [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) setzt, stoppt `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` nicht Auto-Mode-Sitzungen auf Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry oder einem [Claude Apps Gateway](/docs/de/claude-apps-gateway) davon, den Server um [Classifier Review](/docs/de/permission-modes#server-side-classifier-review) zu bitten. Diese Überprüfung fügt einen `anthropic-beta` Wert und ein `safeguards` Request-Feld hinzu. Setzen Sie `CLAUDE_CODE_AUTO_MODE_SERVER=0`, um es dort zu stoppen.

269 276

270Auf Claude Code v2.1.227 oder später kann Ihre Organisation [MCP Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) unter dieser Variable durch [verwaltete Einstellungen](/docs/de/managed-settings) aktiviert halten. Was Claude Code mit dieser Außerkraftsetzung sendet, hängt davon ab, wie Sie sich verbinden:277Auf Claude Code v2.1.227 oder später kann Ihre Organisation [MCP Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) unter dieser Variable durch [verwaltete Einstellungen](/docs/de/managed-settings) aktiviert halten. Was Claude Code mit dieser Außerkraftsetzung sendet, hängt davon ab, wie Sie sich verbinden:

271 278

340Eine ermittelte ID erhält keine eigene Zeile, wenn sie einer Zeile in der Auswahl bereits entspricht:347Eine ermittelte ID erhält keine eigene Zeile, wenn sie einer Zeile in der Auswahl bereits entspricht:

341 348

342* Gleiche ID: die ermittelte ID entspricht genau der ID einer vorhandenen Zeile, oder die beiden IDs sind Schreibweisen derselben [Fable](/docs/de/model-config#work-with-fable) Version.349* Gleiche ID: die ermittelte ID entspricht genau der ID einer vorhandenen Zeile, oder die beiden IDs sind Schreibweisen derselben [Fable](/docs/de/model-config#work-with-fable) Version.

343* Gleiches Modell wie ein eingebauter Alias: wenn eine ermittelte explizite ID das Modell benennt, zu dem ein eingebauter Alias derzeit aufgelöst wird, zeigt die Auswahl nur die Alias-Zeile. Zum Beispiel, während `sonnet` zu `claude-sonnet-5` aufgelöst wird, wird eine ermittelte `claude-sonnet-5` in die `sonnet` Zeile zusammengefasst, und eine ermittelte `claude-sonnet-4-6` erhält immer noch ihre eigene Zeile. Vor v2.1.197 faltete Claude Code diese IDs nicht in eingebaute Zeilen, daher erhielt `claude-sonnet-5` auch ihre eigene „From gateway" Zeile.350* Gleiches Modell wie ein eingebauter Alias: wenn eine ermittelte explizite ID das Modell benennt, zu dem ein eingebauter Alias derzeit aufgelöst wird, zeigt die Auswahl nur die Alias-Zeile. Zum Beispiel, während `sonnet` zu `claude-sonnet-5-5` aufgelöst wird, wird eine ermittelte `claude-sonnet-5-5` in die `sonnet` Zeile zusammengefasst, und eine ermittelte `claude-sonnet-5` erhält immer noch ihre eigene Zeile. Vor v2.1.197 faltete Claude Code diese IDs nicht in eingebaute Zeilen, daher erhielt die ID, zu der ein Alias aufgelöst wurde, auch ihre eigene „From gateway" Zeile.

344 351

345Ergebnisse werden in `~/.claude/cache/gateway-models.json` oder `%USERPROFILE%\.claude\cache\gateway-models.json` unter Windows zwischengespeichert und bei jedem Startup aktualisiert. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, lebt der Cache stattdessen unter diesem Verzeichnis. Wenn die Anfrage fehlschlägt oder das Gateway `/v1/models` nicht implementiert, fällt die Auswahl auf die zwischengespeicherte Liste aus dem vorherigen Startup oder auf die eingebaute Modelliste zurück. Wenn Ihr Gateway Claude-Modelle unter Aliasen bereitstellt, die nicht dem Ermittlungsfilter entsprechen, können Entwickler diese Aliase manuell mit den [Modellkonfigurationsvariablen](/docs/de/model-config) hinzufügen.352Ergebnisse werden in `~/.claude/cache/gateway-models.json` oder `%USERPROFILE%\.claude\cache\gateway-models.json` unter Windows zwischengespeichert und bei jedem Startup aktualisiert. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, lebt der Cache stattdessen unter diesem Verzeichnis. Wenn die Anfrage fehlschlägt oder das Gateway `/v1/models` nicht implementiert, fällt die Auswahl auf die zwischengespeicherte Liste aus dem vorherigen Startup oder auf die eingebaute Modelliste zurück. Wenn Ihr Gateway Claude-Modelle unter Aliasen bereitstellt, die nicht dem Ermittlungsfilter entsprechen, können Entwickler diese Aliase manuell mit den [Modellkonfigurationsvariablen](/docs/de/model-config) hinzufügen.

346 353

llm-gateway-rollout.md +1 −1

Details

208 208

209Fügen Sie die bedingten Variablen aus der Tabelle zum gleichen `env`-Block hinzu. Ein verwalteter `ANTHROPIC_BASE_URL` wird erzwungen und kann nicht durch einen Shell-Export eines Entwicklers überschrieben werden, da Claude Code ihn über die Prozessumgebung und niedrigere Prioritätseinstellungen anwendet.209Fügen Sie die bedingten Variablen aus der Tabelle zum gleichen `env`-Block hinzu. Ein verwalteter `ANTHROPIC_BASE_URL` wird erzwungen und kann nicht durch einen Shell-Export eines Entwicklers überschrieben werden, da Claude Code ihn über die Prozessumgebung und niedrigere Prioritätseinstellungen anwendet.

210 210

211Fügen Sie `forceLoginMethod` oder `forceLoginOrgUUID` nicht in verwalteten Einstellungen neben einer Gateway-Anmeldedaten ein. Jeder Schlüssel mit einem beliebigen Wert blockiert `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` und `apiKeyHelper` beim Start, und Entwickler können nicht fortfahren. Sie sehen `This machine's managed settings require a first-party login`, oder [`Administrator policy requires a Cloud gateway sign-in`](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) unter einem `"gateway"`-Wert.211Fügen Sie `forceLoginMethod`, `forceLoginOrgUUID` oder `forceLoginGatewayUrl` nicht in verwalteten Einstellungen neben einer Gateway-Anmeldedaten ein. `forceLoginMethod` oder `forceLoginOrgUUID`, mit einem beliebigen Wert, blockiert `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` und `apiKeyHelper` beim Start, und Entwickler können nicht fortfahren. Sie sehen `This machine's managed settings require a first-party login`, oder [`Administrator policy requires a Cloud gateway sign-in`](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) wenn die Datei `forceLoginMethod` auf `"gateway"` setzt oder `forceLoginGatewayUrl` setzt.

212 212

213[Server-verwaltete Einstellungen](/docs/de/server-managed-settings#platform-availability) Lieferung erfordert eine direkte Verbindung zu `api.anthropic.com`, daher erreicht sie keine Gateway-gerouteten Sitzungen. Gateway-Bereitstellungen verwenden diesen dateigestützten verwalteten Einstellungspfad, der die gleichen Schlüssel erzwingt.213[Server-verwaltete Einstellungen](/docs/de/server-managed-settings#platform-availability) Lieferung erfordert eine direkte Verbindung zu `api.anthropic.com`, daher erreicht sie keine Gateway-gerouteten Sitzungen. Gateway-Bereitstellungen verwenden diesen dateigestützten verwalteten Einstellungspfad, der die gleichen Schlüssel erzwingt.

214 214

managed-mcp.md +1 −1

Details

526 Überwachen Sie die MCP-Nutzung526 Überwachen Sie die MCP-Nutzung

527</h2>527</h2>

528 528

529Wenn [OpenTelemetry-Export](/docs/de/monitoring-usage) konfiguriert ist, kann Claude Code aufzeichnen, welche MCP-Server und Tools Benutzer aufrufen. Setzen Sie `OTEL_LOG_TOOL_DETAILS=1`, um MCP-Server- und Tool-Namen in Tool-Events einzubeziehen, und aggregieren Sie sie dann in Ihrem Collector, um zu sehen, welche Server Ihre Benutzer tatsächlich verbinden. Siehe [Überwachung](/docs/de/monitoring-usage), um den Exporter einzurichten und das vollständige Event-Schema zu erhalten.529Wenn Sie [OpenTelemetry-Export](/docs/de/monitoring-usage) konfigurieren, kann Claude Code aufzeichnen, welche MCP-Server und Tools Benutzer aufrufen. Setzen Sie `OTEL_LOG_TOOL_DETAILS=1`, um MCP-Server- und Tool-Namen in Tool-Events und auf den [Kosten- und Token-Zählern](/docs/de/monitoring-usage#cost-counter) einzubeziehen, und aggregieren Sie sie dann in Ihrem Collector, um zu sehen, welche Server Ihre Benutzer tatsächlich verbinden. Siehe [Überwachung](/docs/de/monitoring-usage), um den Exporter einzurichten und das vollständige Event-Schema zu erhalten.

530 530

531<h2 id="configuration-summary">531<h2 id="configuration-summary">

532 Konfigurationszusammenfassung532 Konfigurationszusammenfassung

managed-settings.md +72 −36

Details

75| [Serververwaltete Einstellungen](/docs/de/server-managed-settings) | In der claude.ai-Verwaltungskonsole oder auf einem selbstgehosteten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) | Beim Start abgerufen und stündlich abgefragt; siehe [Änderungen, die Genehmigung benötigen](#where-and-when-a-policy-applies) | Sie möchten einen Ort, um die Richtlinie für eine claude.ai-Organisation zu ändern, ohne jeden Rechner zu berühren |75| [Serververwaltete Einstellungen](/docs/de/server-managed-settings) | In der claude.ai-Verwaltungskonsole oder auf einem selbstgehosteten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) | Beim Start abgerufen und stündlich abgefragt; siehe [Änderungen, die Genehmigung benötigen](#where-and-when-a-policy-applies) | Sie möchten einen Ort, um die Richtlinie für eine claude.ai-Organisation zu ändern, ohne jeden Rechner zu berühren |

76| MDM oder Richtlinie auf Betriebssystemebene | Als macOS-Konfigurationsprofil oder Windows-`HKLM`-Registrierungswert, über Jamf, Intune, Gruppenrichtlinie oder ein ähnliches Tool; siehe [wo jeder Mechanismus die Richtlinie speichert](#where-each-mechanism-stores-the-policy) | Beim Start gelesen und alle 30 Minuten auf Änderungen überprüft | Sie verwalten bereits Geräte mit MDM oder Gruppenrichtlinie |76| MDM oder Richtlinie auf Betriebssystemebene | Als macOS-Konfigurationsprofil oder Windows-`HKLM`-Registrierungswert, über Jamf, Intune, Gruppenrichtlinie oder ein ähnliches Tool; siehe [wo jeder Mechanismus die Richtlinie speichert](#where-each-mechanism-stores-the-policy) | Beim Start gelesen und alle 30 Minuten auf Änderungen überprüft | Sie verwalten bereits Geräte mit MDM oder Gruppenrichtlinie |

77| Dateibasiert | Als `managed-settings.json` in einem Systemverzeichnis auf jedem Rechner; siehe [wo jeder Mechanismus die Richtlinie speichert](#where-each-mechanism-stores-the-policy) | Beim Start gelesen und neu geladen, wenn sich eine Datei ändert | Rechner ohne MDM, Linux-Hosts oder Images, die Sie selbst erstellen |77| Dateibasiert | Als `managed-settings.json` in einem Systemverzeichnis auf jedem Rechner; siehe [wo jeder Mechanismus die Richtlinie speichert](#where-each-mechanism-stores-the-policy) | Beim Start gelesen und neu geladen, wenn sich eine Datei ändert | Rechner ohne MDM, Linux-Hosts oder Images, die Sie selbst erstellen |

78| HKCU-Registrierung, Windows und WSL | Als Windows-`HKCU`-Registrierungswert; siehe [wo jeder Mechanismus die Richtlinie speichert](#where-each-mechanism-stores-the-policy) | Beim Start gelesen und alle 30 Minuten auf Änderungen überprüft; Claude Code verwendet ihn nur, wenn keine andere verwaltete Quelle einen Richtlinienschlüssel bereitstellt und keine [vom Host bereitgestellten übergeordneten Einstellungen](#let-an-embedding-host-add-policy) einen restriktiven Schlüssel liefern | Sie können den Schlüssel auf Maschinenebene `HKLM` nicht schreiben |78| HKCU-Registrierung, Windows und WSL | Als Windows-`HKCU`-Registrierungswert; siehe [wo jeder Mechanismus die Richtlinie speichert](#where-each-mechanism-stores-the-policy) | Beim Start gelesen und alle 30 Minuten auf Änderungen überprüft; Claude Code verwendet ihn nur, wenn [kein Admin-Dokument darüber vorhanden ist](#present-admin-documents) und keine [vom Host bereitgestellten übergeordneten Einstellungen](#let-an-embedding-host-add-policy) einen restriktiven Schlüssel liefern | Sie können den Schlüssel auf Maschinenebene `HKLM` nicht schreiben |

79 79

80Starter-Vorlagen für Jamf, Iru, Intune und Gruppenrichtlinie befinden sich im [MDM-Beispiel-Repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm).80Starter-Vorlagen für Jamf, Iru, Intune und Gruppenrichtlinie befinden sich im [MDM-Beispiel-Repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm).

81 81

89 89

90* **Oberflächen**: Auf dem Rechner des Entwicklers lesen das Terminal, die VS Code- und JetBrains-Erweiterungen, die Registerkarte „Code" der Desktop-App und [Agent SDK](/docs/de/agent-sdk/typescript)-Sitzungen alle diese Quellen. Agent SDK-Sitzungen laden verwaltete Einstellungen auch dann, wenn `settingSources` die Benutzer-, Projekt- und lokalen Dateien ausschließt.90* **Oberflächen**: Auf dem Rechner des Entwicklers lesen das Terminal, die VS Code- und JetBrains-Erweiterungen, die Registerkarte „Code" der Desktop-App und [Agent SDK](/docs/de/agent-sdk/typescript)-Sitzungen alle diese Quellen. Agent SDK-Sitzungen laden verwaltete Einstellungen auch dann, wenn `settingSources` die Benutzer-, Projekt- und lokalen Dateien ausschließt.

91* **Cloud-Sitzungen**: Eine Sitzung in einer von Anthropic gehosteten Umgebung liest kein MDM-Profil oder keine Datei eines Geräts, daher muss die Richtlinie dafür aus serververwalteten Einstellungen stammen. Eine Sitzung in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image, standardmäßig nur wenn serververwaltete Einstellungen keinen Richtlinienschlüssel bereitstellen, mit Ausnahme der [Schlüssel, die Claude Code aus jeder Admin-Quelle liest](#keys-read-from-every-admin-source). [Wie Claude Code verwaltete Quellen kombiniert](#how-claude-code-combines-managed-sources) behandelt das Opt-in, das beide anwendet.91* **Cloud-Sitzungen**: Eine Sitzung in einer von Anthropic gehosteten Umgebung liest kein MDM-Profil oder keine Datei eines Geräts, daher muss die Richtlinie dafür aus serververwalteten Einstellungen stammen. Eine Sitzung in einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image, standardmäßig nur wenn serververwaltete Einstellungen keinen Richtlinienschlüssel bereitstellen, mit Ausnahme der [Schlüssel, die Claude Code aus jeder Admin-Quelle liest](#keys-read-from-every-admin-source). [Wie Claude Code verwaltete Quellen kombiniert](#how-claude-code-combines-managed-sources) behandelt das Opt-in, das beide anwendet.

92* **Claude Tag-Sitzungen**: [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen werden in Cloud-Umgebungen ausgeführt, erhalten aber keine serververwalteten Einstellungen. In einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments) lesen sie immer noch die verwaltete Einstellungsdatei im Runner-Image. Konfigurieren Sie Claude Tag selbst in den [Claude Tag-Administratoreinstellungen](https://claude.com/docs/claude-tag/admins/customize).

92* **Cowork-Sitzungen**: [Cowork](https://claude.com/docs/cowork/overview) in der Claude Desktop-App führt ihre Sitzungen auf Claude Code aus. In einer Cowork-Sitzung ruft Claude Code niemals serververwaltete Einstellungen aus der claude.ai-Verwaltungskonsole ab, auch wenn sich der Benutzer mit einem Team- oder Enterprise-Konto anmeldet, daher hängt die angewendete Richtlinie davon ab, wo die Sitzung ausgeführt wird:93* **Cowork-Sitzungen**: [Cowork](https://claude.com/docs/cowork/overview) in der Claude Desktop-App führt ihre Sitzungen auf Claude Code aus. In einer Cowork-Sitzung ruft Claude Code niemals serververwaltete Einstellungen aus der claude.ai-Verwaltungskonsole ab, auch wenn sich der Benutzer mit einem Team- oder Enterprise-Konto anmeldet, daher hängt die angewendete Richtlinie davon ab, wo die Sitzung ausgeführt wird:

93 94

94 * **Auf dem Rechner des Benutzers**: Standardmäßig liest Claude Code in einer Cowork-Sitzung die MDM- oder Richtlinie auf Betriebssystemebene und die verwaltete Einstellungsdatei auf diesem Gerät, daher stellen Sie die Richtlinie dort bereit.95 * **Auf dem Rechner des Benutzers**: Standardmäßig liest Claude Code in einer Cowork-Sitzung die MDM- oder Richtlinie auf Betriebssystemebene und die verwaltete Einstellungsdatei auf diesem Gerät, daher stellen Sie die Richtlinie dort bereit.

1561. Remote-Einstellungen, bereitgestellt von claude.ai als [servergesteuerte Einstellungen](/docs/de/server-managed-settings) oder durch ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway). Claude Code ruft diese Quelle nur ab, wenn die Sitzung sich direkt mit einem [berechtigten Login oder Schlüssel](/docs/de/server-managed-settings#platform-availability) bei der API von Anthropic authentifiziert oder sich mit `/login` bei einem Gateway anmeldet. Bei anderen Anbietern oder wenn `ANTHROPIC_BASE_URL` auf etwas anderes als die API von Anthropic verweist, beginnt es bei der nächsten Quelle1571. Remote-Einstellungen, bereitgestellt von claude.ai als [servergesteuerte Einstellungen](/docs/de/server-managed-settings) oder durch ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway). Claude Code ruft diese Quelle nur ab, wenn die Sitzung sich direkt mit einem [berechtigten Login oder Schlüssel](/docs/de/server-managed-settings#platform-availability) bei der API von Anthropic authentifiziert oder sich mit `/login` bei einem Gateway anmeldet. Bei anderen Anbietern oder wenn `ANTHROPIC_BASE_URL` auf etwas anderes als die API von Anthropic verweist, beginnt es bei der nächsten Quelle

1572. MDM- oder Betriebssystem-Richtlinien: der macOS-plist oder der HKLM-Registrierungsschlüssel1582. MDM- oder Betriebssystem-Richtlinien: der macOS-plist oder der HKLM-Registrierungsschlüssel

1583. Verwaltete Einstellungsdateien, `managed-settings.d/*.json` und `managed-settings.json` zusammengeführt1593. Verwaltete Einstellungsdateien, `managed-settings.d/*.json` und `managed-settings.json` zusammengeführt

1594. Die HKCU-Registrierung unter Windows und unter WSL, sobald der HKLM-Registrierungsschlüssel oder die Windows-Verwaltungsdatei [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) aktiviert und der HKCU-Wert es auch setzt. Claude Code liest sie nur, wenn keine Quelle darüber einen Richtlinienschlüssel bereitstellt und keine [vom Host bereitgestellten übergeordneten Einstellungen](#let-an-embedding-host-add-policy) einen restriktiven Schlüssel liefern1604. Die HKCU-Registrierung unter Windows und unter WSL, sobald der HKLM-Registrierungsschlüssel oder die Windows-Verwaltungsdatei [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) aktiviert und der HKCU-Wert es auch setzt. Claude Code liest sie nur, wenn keine Admin-Quelle darüber einen Richtlinienschlüssel bereitstellt und keine [vom Host bereitgestellten übergeordneten Einstellungen](#let-an-embedding-host-add-policy) einen restriktiven Schlüssel liefern

161

162<span id="present-admin-documents" />

163

164Claude Code wendet die vom Benutzer beschreibbare HKCU-Registrierung niemals unter einem Admin-Dokument an, das vorhanden ist. Ein Dokument ist vorhanden, wenn es einen Richtlinienschlüssel auf einen Wert setzt, der nicht `null` ist, selbst wenn Claude Code diesen Wert nicht lesen kann. Ein HKLM-Wert, eine verwaltete Einstellungsdatei oder ein `managed-settings.d` Verzeichnis, das vorhanden ist, aber nicht gelesen werden kann, ist auch vorhanden. Unter WSL ist `/etc/claude-code` auch vom Benutzer beschreibbar, und der [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) Eintrag sagt, wann die Windows-Dokumente darüber stehen.

160 165

161Dieses Diagramm zeigt die Rangfolge mit Beispielen der Schlüssel zwischen Quellen, die Claude Code aus den ersten drei Quellen unter einer der beiden Einstellungen liest:166Dieses Diagramm zeigt die Rangfolge mit Beispielen der Schlüssel zwischen Quellen, die Claude Code aus den ersten drei Quellen unter einer der beiden Einstellungen liest:

162 167

208 213

210| :- | :- | :- |215| :- | :- | :- |

212| Sperren | Wendet den strengsten Wert an, den eine Quelle setzt; ein lockererer Wert gilt nur aus der höchstrangigen Quelle | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound` |217| Sperren | Wendet den strengsten Wert an, den eine Quelle setzt; ein lockererer Wert gilt nur aus der höchstrangigen Quelle | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound`, `availableModelsMatch` |

213| Restriktions-Zulassungslisten | Nimmt die Liste ganz aus der höchstrangigen Quelle, die sie setzt, ohne Einträge aus niedrigeren Quellen hinzuzufügen | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins` und die `fallbackModel` Kette |218| Restriktions-Zulassungslisten | Nimmt die Liste ganz aus der höchstrangigen Quelle, die sie setzt, ohne Einträge aus niedrigeren Quellen hinzuzufügen | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins` und die `fallbackModel` Kette |

214| Werte, die ganz genommen werden | Nimmt den Wert ganz aus der höchstrangigen Quelle, die ihn setzt, ohne Einträge oder Felder aus niedrigeren Quellen zu kombinieren | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |219| Werte, die ganz genommen werden | Nimmt den Wert ganz aus der höchstrangigen Quelle, die ihn setzt, ohne Einträge oder Felder aus niedrigeren Quellen zu kombinieren | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |

215| Bereitgestellte MCP-Server | Kombiniert die Servernamen aus jeder Quelle; wenn zwei Quellen denselben Namen setzen, wendet den gesamten Eintrag der höherrangigen Quelle an | `managedMcpServers` |220| Bereitgestellte MCP-Server | Kombiniert die Servernamen aus jeder Quelle; wenn zwei Quellen denselben Namen setzen, wendet den gesamten Eintrag der höherrangigen Quelle an | `managedMcpServers` |

323 328

324 Wenn Sie eine verwaltete Einstellungsdatei bereitgestellt haben, überprüfen Sie, dass sie sich im Pfad für das Betriebssystem befindet und dass sie einen [Richtlinienschlüssel](#how-claude-code-combines-managed-sources) enthält, nicht nur die Steuerschlüssel. Eine Datei, die kein gültiges JSON ist, führt nicht zu diesem Zustand; Claude Code [weigert sich zu starten](#find-entries-claude-code-dropped) stattdessen.329 Wenn Sie eine verwaltete Einstellungsdatei bereitgestellt haben, überprüfen Sie, dass sie sich im Pfad für das Betriebssystem befindet und dass sie einen [Richtlinienschlüssel](#how-claude-code-combines-managed-sources) enthält, nicht nur die Steuerschlüssel. Eine Datei, die kein gültiges JSON ist, führt nicht zu diesem Zustand; Claude Code [weigert sich zu starten](#find-entries-claude-code-dropped) stattdessen.

325 330

326 Wenn Sie stattdessen über servergesteuerte Einstellungen bereitgestellt haben, führen Sie `claude doctor` aus, das das [Abrufergebnis](/docs/de/server-managed-settings#verify-settings-delivery) meldet.331 Wenn Sie stattdessen über servergesteuerte Einstellungen bereitgestellt haben, führen Sie `claude doctor` aus, das das [Abruf-Ergebnis](/docs/de/server-managed-settings#verify-settings-delivery) meldet.

327* **Die Zeile benennt eine Quelle, die nicht die ist, die Sie bereitgestellt haben**: eine höher priorisierte Quelle ist vorhanden und Claude Code hat die Ihre ignoriert, und `Skipped sources` listet sie auf. [Wie Claude Code verwaltete Quellen kombiniert](#how-claude-code-combines-managed-sources) gibt die Reihenfolge an.332* **Die Zeile benennt eine andere Quelle als die, die Sie bereitgestellt haben**: Eine höher priorisierte Quelle ist vorhanden und Claude Code hat die Ihre ignoriert, und `Skipped sources` listet sie auf. [Wie Claude Code verwaltete Quellen kombiniert](#how-claude-code-combines-managed-sources) gibt die Reihenfolge an.

328 333

329<span id="invalid-entries-in-managed-settings" />334<span id="invalid-entries-in-managed-settings" />

330 335

332 Finden Sie Einträge, die Claude Code verworfen hat337 Finden Sie Einträge, die Claude Code verworfen hat

333</h3>338</h3>

334 339

335Wenn eine verwaltete Einstellungsdatei, ein MDM-Profil, ein Registrierungswert oder eine servergesteuerte Nutzlast die Schemavalidierung nicht besteht, überspringt Claude Code zunächst die einzelnen Einträge, die es reparieren kann, wie z. B. eine ungültige Berechtigungsregel, mit einer Warnung für jeden, und verwirft dann jeden Top-Level-Schlüssel, dessen Wert immer noch fehlschlägt, und setzt die Durchsetzung aller verbleibenden gültigen Schlüssel fort.340Wenn Ihre verwaltete Einstellungsdatei, ein MDM-Profil, ein Registrierungswert oder eine servergesteuerte Nutzlast die Schemavalidierung nicht besteht, überspringt Claude Code zunächst jeden einzelnen Eintrag, den es reparieren kann, z. B. eine ungültige Berechtigungsregel, und warnt vor jedem. Claude Code verwirft dann jeden Wert, der immer noch fehlschlägt, es sei denn, der Wert gehört zu einem der Schlüssel, die stattdessen [fehlgeschlossen](#keys-that-fail-closed) sind.

336 341

337Claude Code ist strenger mit den `managedSettings`, die ein [`policyHelper`](/docs/de/settings-reference#policyhelper) ausgibt: Es führt die gleichen Eintragsreparaturen durch, aber jede Schemaverletzung, die überlebt, schlägt den gesamten Helper-Lauf fehl, und beim Start weigert sich Claude Code zu starten, das gleiche wie für einen Helper, der mit einem Nicht-Null-Wert beendet wird.342Claude Code ist strenger mit den `managedSettings`, die ein [`policyHelper`](/docs/de/settings-reference#policyhelper) ausgibt: Es führt die gleichen Eintragsreparaturen durch, aber jede Schemaverletzung, die überlebt, schlägt den gesamten Helper-Lauf fehl, und beim Start weigert sich Claude Code zu starten, genauso wie bei einem Helper, der mit einem Nicht-Null-Wert beendet wird.

338 343

339Wenn eine verwaltete Einstellungsdatei, eine Drop-in-Datei, ein MDM-plist oder ein HKLM-Registrierungswert vorhanden ist, aber nicht als JSON-Objekt analysiert werden kann, weigert sich Claude Code zu starten und gibt [einen Fehler aus, der die Quelle benennt](/docs/de/errors#managed-settings-document-could-not-be-parsed), auch wenn eine andere Admin-Quelle eine gültige Richtlinie bereitstellt. Jede Quelle schlägt auf diese Weise fehl, wenn:344Wenn eine verwaltete Einstellungsdatei, Drop-in-Datei, MDM-plist oder HKLM-Registrierungswert vorhanden ist, aber nicht als JSON-Objekt analysiert werden kann, weigert sich Claude Code zu starten und gibt [einen Fehler aus, der die Quelle benennt](/docs/de/errors#managed-settings-document-could-not-be-parsed), auch wenn eine andere Admin-Quelle eine gültige Richtlinie bereitstellt. Jede Quelle schlägt auf diese Weise fehl, wenn:

340 345

341* **Verwaltete Einstellungsdatei oder Drop-in-Datei**: Die Datei ist kein gültiges JSON, oder ihre oberste Ebene ist kein Objekt346* **Verwaltete Einstellungsdatei oder Drop-in-Datei**: Die Datei ist kein gültiges JSON, oder ihre oberste Ebene ist kein Objekt

342* **MDM plist**: macOS's `plutil` meldet die plist als fehlerhaft, oder ihr konvertierter Inhalt ist kein JSON-Objekt347* **MDM-plist**: macOS's `plutil` meldet die plist als fehlerhaft, oder ihr konvertierter Inhalt ist kein JSON-Objekt

343* **HKLM-Registrierungswert**: Der `Settings`-Wert ist keine Zeichenkette, ist leer oder enthält kein JSON-Objekt348* **HKLM-Registrierungswert**: Der `Settings`-Wert ist keine Zeichenkette, ist leer oder enthält kein JSON-Objekt

344 349

345Drei Quellzustände verursachen diese Weigerung nicht:350Drei Quellzustände verursachen diese Weigerung nicht:

346 351

347* Eine fehlende Datei, ein Profil oder ein Registrierungswert ist kein Fehler; Claude Code läuft ohne diese Quelle.352* Eine fehlende Datei, ein fehlendes Profil oder ein fehlender Registrierungswert ist kein Fehler; Claude Code läuft ohne diese Quelle.

348* Eine leere verwaltete Einstellungsdatei zählt als `{}`.353* Eine leere verwaltete Einstellungsdatei zählt als `{}`.

349* Ein fehlerhafter Wert im benutzergeschriebenen HKCU-Registrierungsschlüssel blockiert niemals den Start. Claude Code meldet ihn stattdessen als Hinweis in `/status` und `claude doctor`.354* Ein fehlerhafter Wert im benutzergeschriebenen HKCU-Registrierungsschlüssel blockiert niemals den Start. Claude Code meldet ihn stattdessen als Hinweis in `/status` und `claude doctor`.

350 355

351Wenn eine verwaltete Einstellungsdatei, eine Drop-in-Datei oder ein `managed-settings.d/`-Verzeichnis nicht gelesen werden kann und keine Admin-Quelle eine Richtlinie bereitstellt, beenden Sitzungen, die mit claude.ai- oder Claude Console-Anmeldedaten angemeldet sind, beim Start mit einer Nachricht, um einen Administrator zu kontaktieren.356Wenn eine verwaltete Einstellungsdatei, Drop-in-Datei oder `managed-settings.d/`-Verzeichnis nicht gelesen werden kann und keine Admin-Quelle eine Richtlinie bereitstellt, beenden Sitzungen, die mit claude.ai- oder Claude Console-Anmeldedaten angemeldet sind, beim Start mit einer Nachricht, um einen Administrator zu kontaktieren.

352 357

353Um einen verworfenen Eintrag zu finden, schauen Sie an einer von drei Stellen nach:358Um einen verworfenen Eintrag zu finden, schauen Sie an einer von drei Stellen nach:

354 359

357* [`claude doctor`](/docs/de/debug-your-config) listet jeden ungültigen Eintrag mit seiner Quelle und seinem Feld auf.362* [`claude doctor`](/docs/de/debug-your-config) listet jeden ungültigen Eintrag mit seiner Quelle und seinem Feld auf.

358 363

359<h4 id="keys-that-fail-closed">364<h4 id="keys-that-fail-closed">

360 Schlüssel, die geschlossen fehlschlagen365 Schlüssel, die fehlgeschlossen sind

361</h4>366</h4>

362 367

363Einige Durchsetzungsschlüssel werden nicht verworfen, wenn sie ungültig sind. Claude Code setzt einen strengeren Fallback durch, bis der Wert behoben ist; die Tabelle zeigt, was es für jeden Schlüssel durchsetzt:368Wenn eine verwaltete Quelle einen Schlüssel auf oberster Ebene setzt, der einen einzelnen restriktiven Wert hat, z. B. `allowManagedPermissionRulesOnly`, `disableAutoMode` oder `skipDangerousModePermissionPrompt`, auf etwas, das Claude Code nicht lesen kann, liest der Schlüssel diesen Wert, bis Sie ihn beheben. Der Bericht besagt, dass der Schlüssel `was present but invalid` war, und benennt den Wert, den Claude Code behandelt. Für einen Schlüssel in `sandbox` siehe [Ungültige Werte in `sandbox`](#invalid-values-inside-sandbox).

369

370Diese Fälle schlagen nicht fehlgeschlossen fehl:

371

372* Ein `null` entfernt den Schlüssel.

373* Ein ungültiges `disableAllHooks`, auch ein in Anführungszeichen gesetzter boolescher Wert, wird mit einer Warnung verworfen, da die Durchsetzung von `true` auch die Hooks entladen würde, die Ihre eigenen verwalteten Einstellungen bereitstellen.

374* Für jeden anderen booleschen Schlüssel, den die Regel abdeckt, liest die Zeichenkette `"true"` oder `"false"` als dieser boolesche Wert, mit einem Hinweis in `/status`, der Sie auffordert, die Anführungszeichen zu entfernen.

375

376Claude Code repariert die Blöcke `permissions`, `autoMode`, `worktree` und `attribution` pro Feld, anstatt sie ganz zu verwerfen:

377

378* Ein Lock in einem, z. B. `permissions.disableBypassPermissionsMode`, liest als sein restriktiver Wert.

379* Ein ungültiges `permissions.defaultMode` liest als `default`.

380* Während eine `deny`- oder `ask`-Liste in `permissions` überhaupt nicht gelesen werden kann, behält Claude Code `allow` und `additionalDirectories` zurück, sodass die Zuschüsse ohne die daneben geschriebenen Einschränkungen nicht angewendet werden. Der Bericht benennt jeden zurückgehaltenen Zuschuss und die Liste, die nicht gelesen werden konnte.

381* In `autoMode` behält eine `soft_deny`- oder `hard_deny`-Liste, die nicht gelesen werden kann oder die einen ungültigen Eintrag verloren hat, `allow` und `environment` auf die gleiche Weise zurück.

382

383Die fehlgeschlossene Regel für Schlüssel mit einem einzelnen restriktiven Wert und die Pro-Feld-Reparaturen erfordern Claude Code v2.1.282 oder später.

364 384

365| Feld | Verhalten bei Vorhandensein, aber ungültig |385Diese Schlüssel haben ihr eigenes Fallback:

386

387| Feld | Verhalten, wenn vorhanden, aber ungültig |

366| :- | :- |388| :- | :- |

367| `allowedMcpServers` | Wird als leere Zulassungsliste durchgesetzt, bis der Wert behoben ist, sodass keine MCP-Server, die Benutzer hinzufügen, zugelassen werden. Server, die Ihre Organisation über [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) bereitstellt, werden weiterhin geladen, und `managed-mcp.json`-Server werden gemäß [Wie ein Server bewertet wird](/docs/de/managed-mcp#how-a-server-is-evaluated) geladen. Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. |389| `allowedMcpServers` | Wird als leere Zulassungsliste durchgesetzt, bis der Wert behoben ist, sodass keine MCP-Server, die Benutzer hinzufügen, zugelassen werden. Server, die Ihre Organisation über [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) bereitstellt, werden weiterhin geladen, und `managed-mcp.json`-Server werden pro [Wie ein Server bewertet wird](/docs/de/managed-mcp#how-a-server-is-evaluated) geladen. Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. |

368| `allowedHttpHookUrls` | Claude Code setzt eine leere verwaltete [Zulassungsliste](/docs/de/settings-reference#allowedhttphookurls) durch, bis Sie den Wert beheben, sodass ein HTTP-Hook nur ausgeführt wird, wenn eine andere Einstellungsdatei seine URL auflistet. Wenn nur ein einzelner Eintrag ungültig ist, entfernt Claude Code diesen Eintrag und setzt den Rest durch. |390| `allowedHttpHookUrls` | Claude Code erzwingt eine leere verwaltete [Zulassungsliste](/docs/de/settings-reference#allowedhttphookurls), bis Sie den Wert beheben, sodass ein HTTP-Hook nur ausgeführt wird, wenn eine andere Einstellungsdatei seine URL auflistet. Wenn nur ein einzelner Eintrag ungültig ist, entfernt Claude Code diesen Eintrag und erzwingt den Rest. |

369| `httpHookAllowedEnvVars` | Claude Code setzt eine leere verwaltete [Zulassungsliste](/docs/de/settings-reference#httphookallowedenvvars) durch, bis Sie den Wert beheben, sodass eine Header-Variable nur interpoliert wird, wenn eine andere Einstellungsdatei sie benennt. Wenn nur ein einzelner Eintrag ungültig ist, entfernt Claude Code diesen Eintrag und setzt den Rest durch. |391| `httpHookAllowedEnvVars` | Claude Code erzwingt eine leere verwaltete [Zulassungsliste](/docs/de/settings-reference#httphookallowedenvvars), bis Sie den Wert beheben, sodass eine Header-Variable nur interpoliert wird, wenn eine andere Einstellungsdatei sie benennt. Wenn nur ein einzelner Eintrag ungültig ist, entfernt Claude Code diesen Eintrag und erzwingt den Rest. |

370| `allowedChannelPlugins` | Claude Code setzt eine leere Zulassungsliste durch, bis Sie den Wert beheben, sodass kein an `--channels` übergebenes Channel-Plugin zugelassen wird. Wenn nur ein einzelner Eintrag ungültig ist, entfernt es diesen Eintrag und setzt den Rest durch. |392| `allowedChannelPlugins` | Claude Code erzwingt eine leere Zulassungsliste, bis Sie den Wert beheben, sodass kein an `--channels` übergebenes Channel-Plugin zugelassen wird. Wenn nur ein einzelner Eintrag ungültig ist, entfernt es diesen Eintrag und erzwingt den Rest. |

371| `strictKnownMarketplaces` | Wird als leere Zulassungsliste durchgesetzt, bis der Wert behoben ist, sodass keine [Marketplace-Quelle](/docs/de/plugins/org#restrict-what-users-can-install) zugelassen wird. Ein einzelner Eintrag, der ungültig ist oder nicht durchgesetzt werden kann, wie z. B. ein `hostPattern`-Regex, der nicht kompiliert wird, wird entfernt und die gültige Teilmenge wird durchgesetzt. |393| `strictKnownMarketplaces` | Wird als leere Zulassungsliste durchgesetzt, bis der Wert behoben ist, sodass keine [Marketplace-Quelle](/docs/de/plugins/org#restrict-what-users-can-install) zugelassen wird. Ein einzelner Eintrag, der ungültig ist oder nicht durchgesetzt werden kann, z. B. ein `hostPattern`-Regex, der nicht kompiliert wird, wird entfernt und die gültige Teilmenge wird durchgesetzt. |

372| `allowManagedHooksOnly` | Wird als `true` behandelt, bis behoben: Die [Hook-Einschränkungen](/docs/de/settings-reference#allowmanagedhooksonly) gelten und, sofern `disableCommandPluginSources` nicht explizit `false` ist, sind befehlsgesteuerte Plugins deaktiviert. |394| `availableModels` | Wird als leere Zulassungsliste durchgesetzt, bis behoben, sodass nur das Standardmodell verfügbar ist; ein Nicht-String-Eintrag wird entfernt und die gültige Teilmenge durchgesetzt. |

374| `disableCommandPluginSources` | Wird als `true` behandelt, sodass befehlsgesteuerte Plugins deaktiviert bleiben, bis der Wert behoben ist. |

375| `disableSideloadFlags` | Wird als `true` behandelt, bis der Wert behoben ist, mit den für [`disableSideloadFlags`](/docs/de/settings-reference#disablesideloadflags) aufgelisteten Auswirkungen. |

376| `availableModels` | Wird als leere Zulassungsliste durchgesetzt, bis behoben, sodass nur das Standardmodell verfügbar ist; ein Nicht-String-Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. |

377| `enforceAvailableModels` | Wird als `true` behandelt. |

378| `syncClaudeAiPlugins` | Wird als `false` behandelt, sodass die Synchronisierung von [claude.ai-Plugins](/docs/de/settings-reference#syncclaudeaiplugins) deaktiviert ist, bis der Wert behoben ist. |

380| `gatewayInternalNetworks` | Wenn der ungültige Wert von der höchsten verwalteten Quelle auf dem Computer stammt, weigert sich `/login`, jede neue [Cloud-Gateway](/docs/de/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)-Anmeldung auf diesem Computer, bis der Wert behoben ist. |397| `gatewayInternalNetworks` | Wenn der ungültige Wert von der höchsten verwalteten Quelle auf dem Computer stammt, weigert sich `/login`, jede neue [Cloud-Gateway](/docs/de/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)-Anmeldung auf diesem Computer, bis der Wert behoben ist. |

381| `crossSessionInbound` | Wird als `refuse`, der restriktivste Wert, behandelt, sodass eingehende [Cross-Session-Nachrichten](/docs/de/cross-session-messaging#control-inbound-messages) abgelehnt werden, bis der Wert behoben ist. Der Entwickler sieht [eine Warnung](/docs/de/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |398| `crossSessionInbound` | Wird als `refuse`, der restriktivste Wert, behandelt, sodass eingehende [Cross-Session-Nachrichten](/docs/de/cross-session-messaging#control-inbound-messages) abgelehnt werden, bis der Wert behoben ist. Der Entwickler sieht [eine Warnung](/docs/de/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

382| `deniedMcpServers` | Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen, da das Ablehnen aller Server Server blockieren würde, die die Richtlinie nie benannt hat. |399| `deniedMcpServers` | Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen, da das Ablehnen aller Server Server blockieren würde, die die Richtlinie nie benannt hat. |

383| `blockedMarketplaces` | Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. Ein Eintrag, der analysiert wird, aber nie übereinstimmen kann, wie z. B. ein `hostPattern`-Regex, der nicht kompiliert wird, wird mit einer Warnung beibehalten. Es blockiert nichts, bis behoben, aber [Marketplace-Einschränkungen](/docs/de/plugins/org#restrict-what-users-can-install) bleiben aktiv. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen, da das Blockieren aller Marketplaces Quellen blockieren würde, die die Richtlinie nie benannt hat. |400| [`deniedModels`](/docs/de/settings-reference#deniedmodels) | Ein Nicht-String-Eintrag wird entfernt und der Rest der Liste wird durchgesetzt. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen und blockiert keine Modelle, bis er behoben ist. |

384| `sandbox.credentials` | Ein behebbarer ungültiger Eintrag wird zu `mode: "deny"` mit einer Warnung herabgestuft; ein nicht behebbarer wird entfernt; gültige Einträge bleiben durchgesetzt. Siehe [ungültige Credential-Einträge](/docs/de/settings-reference#invalid-credential-entries-in-managed-settings) |401| `blockedMarketplaces` | Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird durchgesetzt. Ein Eintrag, der analysiert wird, aber nie übereinstimmen kann, z. B. ein `hostPattern`-Regex, der nicht kompiliert wird, wird mit einer Warnung beibehalten. Es blockiert nichts, bis behoben, aber [Marketplace-Einschränkungen](/docs/de/plugins/org#restrict-what-users-can-install) bleiben aktiv. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen, da das Blockieren aller Marketplaces Quellen blockieren würde, die die Richtlinie nie benannt hat. |

402| `sandbox` | Wenn ein Wert in dem Block ungültig ist, verwirft Claude Code den gesamten Block nicht. Für das, was mit jedem Typ ungültigen Feldes geschieht, siehe [Ungültige Werte in `sandbox`](#invalid-values-inside-sandbox). |

403| `sandbox.credentials` | Ein wiederherstellbarer ungültiger Eintrag wird zu `mode: "deny"` mit einer Warnung herabgestuft; ein nicht wiederherstellbarer wird entfernt; gültige Einträge bleiben durchgesetzt. Siehe [ungültige Credential-Einträge](/docs/de/settings-reference#invalid-credential-entries-in-managed-settings). |

404| `strictPluginOnlyCustomization` | Wird als `true` behandelt, wobei alle vier Oberflächen gesperrt werden, wenn der Wert weder ein boolescher Wert noch ein Array ist. Ein Array-Eintrag, den diese Version nicht als Oberfläche erkennt, sperrt nichts; eine Statusnotiz zählt solche Einträge, damit Sie sie auf Tippfehler überprüfen können. |

405| `enabledPlugins` | Ein ungültiger Eintrag wird mit einer Warnung verworfen und die anderen Einträge bleiben durchgesetzt. Ein Wert, der keine Zuordnung von Plugin-IDs ist, oder dessen jeder Eintrag ungültig ist, wird ganz mit einer Warnung verworfen. |

385 406

386`allowedHttpHookUrls` und `httpHookAllowedEnvVars` werden über Einstellungsdateien zusammengeführt, sodass Einträge in Ihren Benutzer-, Projekt- oder lokalen Einstellungen weiterhin gelten, während die verwaltete Liste leer ist.407`allowedHttpHookUrls` und `httpHookAllowedEnvVars` werden über Einstellungsdateien zusammengeführt, sodass Einträge in Ihren Benutzer-, Projekt- oder lokalen Einstellungen weiterhin gelten, während die verwaltete Liste leer ist.

387 408

388Die Fallbacks für diese beiden Schlüssel und für `allowedChannelPlugins` erfordern Claude Code v2.1.267 oder später; frühere Versionen verwerfen den gesamten Schlüssel, wenn sein Wert oder ein Eintrag ungültig ist. Die Fallbacks für `strictKnownMarketplaces`, `blockedMarketplaces` und `disableSideloadFlags` erfordern Claude Code v2.1.277 oder später; frühere Versionen verwerfen den gesamten Schlüssel, wenn sein Wert oder ein Eintrag ungültig ist.409Die Fallbacks für diese beiden Schlüssel und für `allowedChannelPlugins` erfordern Claude Code v2.1.267 oder später; frühere Versionen verwerfen den gesamten Schlüssel, wenn sein Wert oder ein Eintrag ungültig ist. Die Fallbacks für `strictKnownMarketplaces` und `blockedMarketplaces` erfordern Claude Code v2.1.277 oder später; frühere Versionen verwerfen den gesamten Schlüssel, wenn sein Wert oder ein Eintrag ungültig ist. Die Fallbacks für `strictPluginOnlyCustomization` und `enabledPlugins` erfordern Claude Code v2.1.282 oder später.

410

411`requiredMinimumVersion` und `requiredMaximumVersion` schlagen offen fehl, wie beabsichtigt: Ein ungültiger Wert wird verworfen, anstatt durchgesetzt zu werden.

412

413Diese Toleranz gilt nur für verwaltete Einstellungen. Benutzer-, Projekt- und lokale Einstellungsdateien bleiben streng: Eine Datei, deren JSON oder oberste Ebene die Validierung nicht besteht, wird als Ganzes abgelehnt und gemeldet, und ein einzelner Eintrag, der fehlschlägt, z. B. eine fehlerhafte Berechtigungsregel, wird mit einer Warnung übersprungen, während der Rest der Datei angewendet wird.

414

415<h4 id="invalid-values-inside-sandbox">

416 Ungültige Werte in `sandbox`

417</h4>

418

419Wenn ein Wert in Ihrem verwalteten `sandbox`-Block ungültig ist, verwirft Claude Code den gesamten Block nicht, da es jedes Feld unabhängig validiert. Diese Pro-Feld-Behandlung erfordert Claude Code v2.1.283 oder später. In Versionen vor v2.1.283 verwirft Claude Code jedes `sandbox`-Feld außer [`credentials`](/docs/de/settings-reference#invalid-credential-entries-in-managed-settings), wenn ein Wert außerhalb von `credentials` ungültig ist.

389 420

390`requiredMinimumVersion` und `requiredMaximumVersion` schlagen absichtlich offen fehl: Ein ungültiger Wert wird verworfen, anstatt durchgesetzt zu werden.421Die Warnung, die Sie für ein ungültiges Feld erhalten, benennt das Feld und teilt Ihnen mit, was damit geschieht. Was geschieht, hängt davon ab, was das Feld steuert:

391 422

392Diese Toleranz gilt nur für verwaltete Einstellungen. Benutzer-, Projekt- und lokale Einstellungsdateien bleiben streng: Eine Datei, deren JSON oder Top-Level-Form die Validierung nicht besteht, wird als Ganzes abgelehnt und gemeldet, und ein einzelner Eintrag, der fehlschlägt, wie z. B. eine fehlerhafte Berechtigungsregel, wird mit einer Warnung übersprungen, während der Rest der Datei angewendet wird.423* Wenn Sie einen booleschen Schlüssel auf ein in Anführungszeichen gesetztes `"true"` oder `"false"` setzen, zählt der Wert als dieser boolesche Wert. Anstelle einer Warnung zeigt `/status` einen Hinweis an, der Sie auffordert, die Anführungszeichen zu entfernen.

424* Wenn `failIfUnavailable` ungültig ist, verwirft Claude Code den Wert, anstatt ihn als `true` zu behandeln, sodass ein unlesbarer Wert Sitzungen niemals daran hindert, in Ihrer gesamten Flotte zu starten.

425* Claude Code behandelt jeden anderen ungültigen booleschen Wert als den Wert, der die Sandbox am strengsten hält, bis Sie ihn beheben. Ein Schlüssel, der die Sandbox oder eine ihrer Einschränkungen einschaltet, z. B. `enabled` oder `network.allowManagedDomainsOnly`, zählt als `true`. Ein Schlüssel, der sie lockert, z. B. `allowUnsandboxedCommands`, zählt als `false`.

426* In einer Liste außerhalb von `credentials`, z. B. `excludedCommands` oder `network.allowedDomains`, verwirft Claude Code einen ungültigen Eintrag und behält den Rest der Liste. Eine Liste, die kein Array ist, oder die keinen gültigen Eintrag hat, wird überhaupt nicht angewendet.

427* Während `network.deniedDomains` oder ein Eintrag darin ungültig ist, behält Claude Code auch `network.allowedDomains` zurück, sodass die verwaltete Zulassungsliste nichts gewährt, bis Sie die Ablehnungsliste beheben.

428* Während `filesystem.denyRead`, `filesystem.denyWrite` oder ein Eintrag in einem von beiden ungültig ist, behält Claude Code auch beide `filesystem.allowRead` und `filesystem.allowWrite` zurück, bis Sie die Ablehnungsliste beheben.

393 429

394<span id="managed-only-settings" />430<span id="managed-only-settings" />

395 431

401 437

402Die meisten sind Sperren: Der Wert, den eine Sperre regelt, wie Berechtigungsregeln oder `sandbox.network.allowedDomains`, ist ein gewöhnlicher Schlüssel, den jede Ebene setzen kann, und die Sperre sagt Claude Code, nur den verwalteten Wert zu beachten.438Die meisten sind Sperren: Der Wert, den eine Sperre regelt, wie Berechtigungsregeln oder `sandbox.network.allowedDomains`, ist ein gewöhnlicher Schlüssel, den jede Ebene setzen kann, und die Sperre sagt Claude Code, nur den verwalteten Wert zu beachten.

403 439

404Die Tabelle behandelt die Berechtigungs-, Plugin- und Liefersteuerelemente. Für jeden Schlüssel, der hier nicht aufgelistet ist, sagt die Spalte „Scope" der [Einstellungsreferenz](/docs/de/settings-reference#all-settings) Index, ob er nur verwaltet ist; die verbleibenden nur verwalteten Schlüssel dort umfassen die Gateway-Anmelde-URL, Version, Browser, Mobile-Simulator, SSH-Host, Desktop-Lokalsitzung, Sandbox-Binärpfad, Modellpreisgestaltung und CLAUDE.md-Steuerelemente.440Die Tabelle behandelt die Berechtigungs-, Plugin- und Liefersteuerelemente. Für jeden Schlüssel, der hier nicht aufgelistet ist, sagt die Spalte „Scope" der [Einstellungsreferenz](/docs/de/settings-reference#all-settings) Index, ob er nur verwaltet ist; die verbleibenden nur verwalteten Schlüssel dort umfassen die Gateway-Anmelde-URL, Version, Browser, Mobile-Simulator, SSH-Host, Desktop-Lokalsitzung, Sandbox-Binärpfad, Modellpreisgestaltung, Modelleinschränkung und CLAUDE.md-Steuerelemente.

405 441

406| Einstellung | Beschreibung |442| Einstellung | Beschreibung |

407| :- | :- |443| :- | :- |

425| [`sandbox.network.allowManagedDomainsOnly`](/docs/de/settings-reference#sandbox-network-allowmanageddomainsonly) | Beachten Sie nur verwaltete `allowedDomains` und `WebFetch(domain:...)`-Zulassungsregeln; blockieren Sie andere Domänen ohne Eingabeaufforderung |461| [`sandbox.network.allowManagedDomainsOnly`](/docs/de/settings-reference#sandbox-network-allowmanageddomainsonly) | Beachten Sie nur verwaltete `allowedDomains` und `WebFetch(domain:...)`-Zulassungsregeln; blockieren Sie andere Domänen ohne Eingabeaufforderung |

426| [`strictKnownMarketplaces`](/docs/de/settings-reference#strictknownmarketplaces) | Steuert, welche Plugin-Marktplatzquellen Benutzer hinzufügen und Plugins installieren können. Siehe [verwaltete Marktplatz-Einschränkungen](/docs/de/plugins/org#restrict-what-users-can-install) |462| [`strictKnownMarketplaces`](/docs/de/settings-reference#strictknownmarketplaces) | Steuert, welche Plugin-Marktplatzquellen Benutzer hinzufügen und Plugins installieren können. Siehe [verwaltete Marktplatz-Einschränkungen](/docs/de/plugins/org#restrict-what-users-can-install) |

427| [`strictPluginOnlyCustomization`](/docs/de/settings-reference#strictpluginonlycustomization) | Blockieren Sie Skills, Agents, Hooks und MCP-Server aus Benutzer- und Projektquellen; `true` sperrt alle vier, ein Array nennt, welche |463| [`strictPluginOnlyCustomization`](/docs/de/settings-reference#strictpluginonlycustomization) | Blockieren Sie Skills, Agents, Hooks und MCP-Server aus Benutzer- und Projektquellen; `true` sperrt alle vier, ein Array nennt, welche |

428| [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) | Wenn im HKLM-Registrierungsschlüssel oder einer Datei unter `C:\Program Files\ClaudeCode` gesetzt, lassen Sie WSL die Windows-Richtlinienkette lesen und lesen Sie `/etc/claude-code` nur, wenn keine verwaltete Einstellungsdatei oder Drop-in unter diesem Verzeichnis einen [Richtlinienschlüssel](#how-claude-code-combines-managed-sources) bereitstellt; der Eintrag gibt die Reihenfolge |464| [`wslInheritsWindowsSettings`](/docs/de/settings-reference#wslinheritswindowssettings) | Wenn im HKLM-Registrierungsschlüssel oder einer Datei unter `C:\Program Files\ClaudeCode` gesetzt, lassen Sie WSL die Windows-Richtlinienkette lesen, und lesen Sie `/etc/claude-code` nur, wenn [kein Windows-Admin-Dokument vorhanden ist](#present-admin-documents); der Eintrag gibt die Reihenfolge |

429 465

430<Note>466<Note>

431 Auf Team- und Enterprise-Plänen aktiviert oder deaktiviert ein Owner [Remote Control](/docs/de/remote-control) und [Web-Sitzungen](/docs/de/claude-code-on-the-web) organisationsweit in [Claude Code-Verwaltungseinstellungen](https://claude.ai/admin-settings/claude-code). Remote Control kann zusätzlich pro Gerät mit der Einstellung [`disableRemoteControl`](/docs/de/settings-reference#disableremotecontrol) deaktiviert werden. Web-Sitzungen haben keinen verwalteten Einstellungsschlüssel pro Gerät.467 Auf Team- und Enterprise-Plänen aktiviert oder deaktiviert ein Owner [Remote Control](/docs/de/remote-control) und [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) organisationsweit in [Claude Code-Verwaltungseinstellungen](https://claude.ai/admin-settings/claude-code). Remote Control kann zusätzlich pro Gerät mit der Einstellung [`disableRemoteControl`](/docs/de/settings-reference#disableremotecontrol) deaktiviert werden. Cloud-Sitzungen haben keinen verwalteten Einstellungsschlüssel pro Gerät.

432 468

433 Um zu überprüfen, ob diese Organisationseinstellungen einen bestimmten Rechner erreicht haben, führen Sie dort `claude doctor` aus und lesen Sie die Zeile `Organization policy`, die sagt, wo Claude Code die Richtlinie geladen hat oder warum es nicht geladen wurde. Erfordert Claude Code v2.1.261 oder später. In einer laufenden Sitzung zeigt `/status` die gleiche Zeile, wenn die Richtlinie nicht geladen wurde.469 Um zu überprüfen, ob diese Organisationseinstellungen einen bestimmten Rechner erreicht haben, führen Sie dort `claude doctor` aus und lesen Sie die Zeile `Organization policy`, die sagt, wo Claude Code die Richtlinie geladen hat oder warum es nicht geladen wurde. Erfordert Claude Code v2.1.261 oder später. In einer laufenden Sitzung zeigt `/status` die gleiche Zeile, wenn die Richtlinie nicht geladen wurde.

434</Note>470</Note>

449 485

450Claude Code wendet einen Wert von `1` an, ohne dem Benutzer den [Genehmigungsdialog](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog) zu zeigen.486Claude Code wendet einen Wert von `1` an, ohne dem Benutzer den [Genehmigungsdialog](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog) zu zeigen.

451 487

452Wenn Sie Telemetrie ausschalten, stoppt Claude Code das Senden der Nutzungsdaten, die Ihr Organisations-[Analyse-Dashboard](/docs/de/analytics) für die Entwickler speist, die die Richtlinie erreicht. Die Variable schaltet auch das Abrufen von Feature-Flags aus, was [Features, die Feature-Flag-Abrufen benötigen](/docs/de/env-vars#features-that-need-feature-flag-fetching), für diese Entwickler nicht verfügbar macht.488Wenn Sie Telemetrie ausschalten, stoppt Claude Code das Senden der Nutzungsdaten, die Ihr Organisations-[Analyse-Dashboard](/docs/de/analytics) für die Entwickler speist, die die Richtlinie erreicht. Die Variable schaltet auch das [Abrufen von Feature-Flags](/docs/de/env-vars#features-that-need-feature-flag-fetching) für diese Entwickler aus. Für Remote Control siehe die [Remote Control-Anforderungen](/docs/de/remote-control#requirements).

453 489

454[Wo und wann eine Richtlinie angewendet wird](#where-and-when-a-policy-applies) sagt, welcher Bereitstellungsmechanismus jede Oberfläche erreicht, und [Plattformverfügbarkeit](/docs/de/server-managed-settings#platform-availability) sagt, welche Sitzungen den Abruf von serververwalteten Einstellungen überspringen.490[Wo und wann eine Richtlinie angewendet wird](#where-and-when-a-policy-applies) sagt, welcher Bereitstellungsmechanismus jede Oberfläche erreicht, und [Plattformverfügbarkeit](/docs/de/server-managed-settings#platform-availability) sagt, welche Sitzungen den Abruf von serververwalteten Einstellungen überspringen.

455 491

mcp.md +30 −13

Details

92 92

93Ein JSON-Eintrag, der eine `url` hat, aber keinen `type`, ist ein Konfigurationsfehler, da Claude Code einen Eintrag ohne `type` als Stdio-Server liest. Claude Code überspringt diesen Server und meldet `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. Vor v2.1.202 meldete Claude Code diese Fehlkonfiguration als `command: expected string, received undefined`.93Ein JSON-Eintrag, der eine `url` hat, aber keinen `type`, ist ein Konfigurationsfehler, da Claude Code einen Eintrag ohne `type` als Stdio-Server liest. Claude Code überspringt diesen Server und meldet `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. Vor v2.1.202 meldete Claude Code diese Fehlkonfiguration als `command: expected string, received undefined`.

94 94

95Nur eine SDK-Host-Anwendung, wie eine [Agent SDK](/docs/de/agent-sdk/mcp)-Anwendung oder die [Desktop-App](/docs/de/desktop), kann einen In-Process-Server mit `"type": "sdk"` registrieren. Claude Code überspringt einen `"type": "sdk"`-Eintrag in `.mcp.json`, `~/.claude.json` oder Einstellungen und meldet `Skipped — MCP server "<name>" declares type "sdk", which only an SDK host application can register`.

95Bei `--output-format stream-json`-Läufen meldet Claude Code auch einen übersprungenen `--mcp-config`-Eintrag im [`mcp_server_errors`-Feld](/docs/de/headless#stream-responses) des `system/init`-Ereignisses, sodass Skripte erkennen können, dass der Server nie geladen wurde. Dies erfordert Claude Code v2.1.219 oder später.97Bei `--output-format stream-json`-Läufen meldet Claude Code auch einen übersprungenen `--mcp-config`-Eintrag im [`mcp_server_errors`-Feld](/docs/de/headless#stream-responses) des `system/init`-Ereignisses, sodass Skripte erkennen können, dass der Server nie geladen wurde. Dies erfordert Claude Code v2.1.219 oder später.

96 98

97<h3 id="option-2-add-a-remote-sse-server">99<h3 id="option-2-add-a-remote-sse-server">

297 299

298Der Discovery-Cache ist standardmäßig deaktiviert, es sei denn, ein schrittweiser Rollout hat ihn für Ihr Konto aktiviert. Setzen Sie [`MCP_DISCOVERY_CACHE=1`](/docs/de/env-vars), um ihn einzuschalten, oder `0`, um ihn ausgeschaltet zu halten, auch wenn der Rollout ihn aktiviert hat. Vor v2.1.238 war der Cache standardmäßig aktiviert.300Der Discovery-Cache ist standardmäßig deaktiviert, es sei denn, ein schrittweiser Rollout hat ihn für Ihr Konto aktiviert. Setzen Sie [`MCP_DISCOVERY_CACHE=1`](/docs/de/env-vars), um ihn einzuschalten, oder `0`, um ihn ausgeschaltet zu halten, auch wenn der Rollout ihn aktiviert hat. Vor v2.1.238 war der Cache standardmäßig aktiviert.

299 301

300Zwei Aktionen im Menü eines Servers in `/mcp` beeinflussen auch den Cache-Eintrag dieses Servers:302Wenn Sie **Disable** oder **Clear authentication** aus dem Menü eines Servers in `/mcp` auswählen, verwirft Claude Code auch den Cache-Eintrag dieses Servers. **Reconnect** verwirft ihn auch bei einem verbundenen oder fehlgeschlagenen Server; bei einem `cached`-Server verbindet **Reconnect** den Server jetzt und behält den Eintrag. Das nächste Mal, wenn Claude Code sich mit dem Server verbindet, nachdem der Eintrag verworfen wurde, ruft es die Tool-Liste vom Server ab, anstatt aus dem Cache.

~~301~~

302* **Reconnect**: Bei einem `cached`-Server verbindet Claude Code ihn jetzt statt beim ersten Tool-Aufruf und behält den Eintrag. Bei einem verbundenen oder fehlgeschlagenen Server verbindet Claude Code ihn erneut und verwirft auch den Eintrag.

303* **Clear authentication**: Claude Code widerruft die Authentifizierung des Servers und verwirft auch den Eintrag.

~~304~~

305Nach dem Verwerfen des Eintrags ruft Claude Code die Tool-Liste des Servers vom Server ab, anstatt aus dem Cache.

306 303

307Wenn der Status eines Servers `✘ Failed to connect` ist, hängt `claude mcp list` das Fehlerdetail an diese Statuszeile an, und `claude mcp get <name>` zeigt es auf einer `Issue:`-Zeile: der HTTP-Status oder Fehlercode, plus jeder Fehlertext, den der Server zurückgegeben hat. Die Detailansicht des Servers in `/mcp` enthält den gleichen vom Server gemeldeten Text in ihrer `Issue:`-Zeile. Claude Code redigiert Credential-ähnlichen Text aus diesem Detail und enthält niemals die erweiterte Server-URL, die Geheimnisse tragen kann. Claude Code hängt keinen Detail an einen `✘ Connection error`-Status an, da der Exception-Text, den es dort drucken würde, diese URL einbetten kann. Vor v2.1.219 zeigten beide Befehle nur den bloßen Fehlerstatus ohne Statuscode oder Fehlertext des Servers.304Wenn der Status eines Servers `✘ Failed to connect` ist, hängt `claude mcp list` das Fehlerdetail an diese Statuszeile an, und `claude mcp get <name>` zeigt es auf einer `Issue:`-Zeile: der HTTP-Status oder Fehlercode, plus jeder Fehlertext, den der Server zurückgegeben hat. Die Detailansicht des Servers in `/mcp` enthält den gleichen vom Server gemeldeten Text in ihrer `Issue:`-Zeile. Claude Code redigiert Credential-ähnlichen Text aus diesem Detail und enthält niemals die erweiterte Server-URL, die Geheimnisse tragen kann. Claude Code hängt keinen Detail an einen `✘ Connection error`-Status an, da der Exception-Text, den es dort drucken würde, diese URL einbetten kann. Vor v2.1.219 zeigten beide Befehle nur den bloßen Fehlerstatus ohne Statuscode oder Fehlertext des Servers.

308 305

6694. [Von Plugins bereitgestellte Server](/docs/de/plugins/components#mcp-servers)6664. [Von Plugins bereitgestellte Server](/docs/de/plugins/components#mcp-servers)

6705. [claude.ai-Connectoren](#use-mcp-servers-from-claude-ai)6675. [claude.ai-Connectoren](#use-mcp-servers-from-claude-ai)

671 668

672Die drei Bereiche stimmen Duplikate nach Name ab. Plugins und Connectoren stimmen nach Endpunkt ab, daher wird einer, der auf die gleiche URL oder den gleichen Befehl wie ein Server oben verweist, als Duplikat behandelt.669Claude Code stimmt Duplikate in den drei Bereichen nach Name ab. Plugins und Connectoren stimmen nach Endpunkt ab, daher wird einer, der auf die gleiche URL oder den gleichen Befehl wie ein Server oben verweist, als Duplikat behandelt.

670

671Zwei URL-Schreibweisen zählen als derselbe Endpunkt, wenn sie sich nur im Großbuchstaben des Schemas oder Hosts unterscheiden, dem Standardport des Schemas, wie `:443` auf `https`, oder einem nachgestellten Schrägstrich. Ein anderer Pfad, eine Abfragezeichenfolge, Benutzerinformationen oder ein nicht standardmäßiger Port machen zwei Server unterschiedlich.

673 672

674Ein Server, den Ihre Organisation über die verwaltete Einstellung [`managedMcpServers`](/docs/de/managed-mcp#provide-servers-through-managed-settings) bereitstellt, hat Vorrang vor all diesen, daher verbindet sich Claude Code mit der Definition der Organisation, wenn einer von ihnen ihn dupliziert. Erfordert Claude Code v2.1.259 oder später.673Ein Server, den Ihre Organisation über die verwaltete Einstellung [`managedMcpServers`](/docs/de/managed-mcp#provide-servers-through-managed-settings) bereitstellt, hat Vorrang vor all diesen, daher verbindet sich Claude Code mit der Definition der Organisation, wenn einer von ihnen ihn dupliziert. Erfordert Claude Code v2.1.259 oder später.

675 674

915 <Step title="Registrieren Sie eine OAuth-App beim Server">914 <Step title="Registrieren Sie eine OAuth-App beim Server">

916 Erstellen Sie eine App über das Entwicklerportal des Servers und notieren Sie sich Ihre Client-ID und Ihren Client-Secret.915 Erstellen Sie eine App über das Entwicklerportal des Servers und notieren Sie sich Ihre Client-ID und Ihren Client-Secret.

917 916

918 Viele Server erfordern auch einen Redirect-URI. Wenn ja, wählen Sie einen Port und registrieren Sie einen Redirect-URI im Format `http://localhost:PORT/callback`. Verwenden Sie denselben Port mit `--callback-port` im nächsten Schritt.917 Wenn das Registrierungsformular nach einem Redirect-URI fragt, wählen Sie einen verfügbaren Port und geben Sie `http://localhost:PORT/callback` mit diesem Port ein. Sie werden denselben Port im nächsten Schritt verwenden.

919 918

920 In v2.1.229 sendete Claude Code `http://127.0.0.1:PORT/callback` stattdessen, und Server, die den registrierten Redirect-URI exakt abgleichen, lehnten die Anmeldung mit einem Redirect-URI-Mismatch ab. Claude Code v2.1.231 stellte die `localhost`-Form wieder her. Um auf v2.1.229 zu beheben, aktualisieren Sie Claude Code, oder fügen Sie vorübergehend die `http://127.0.0.1:PORT/callback`-Form zu den registrierten Redirect-URIs des Servers hinzu.919 In v2.1.229 sendete Claude Code `http://127.0.0.1:PORT/callback` stattdessen, und Server, die den registrierten Redirect-URI exakt abgleichen, lehnten die Anmeldung mit einem Redirect-URI-Mismatch ab. Claude Code v2.1.231 stellte die `localhost`-Form wieder her. Um auf v2.1.229 zu beheben, aktualisieren Sie Claude Code, oder fügen Sie vorübergehend die `http://127.0.0.1:PORT/callback`-Form zu den registrierten Redirect-URIs des Servers hinzu.

921 </Step>920 </Step>

922 921

923 <Step title="Fügen Sie den Server mit Ihren Anmeldedaten hinzu">922 <Step title="Fügen Sie den Server mit Ihren Anmeldedaten hinzu">

924 Wählen Sie eine der folgenden Methoden. Der für `--callback-port` verwendete Port kann ein beliebiger verfügbarer Port sein. Er muss dem Redirect-URI entsprechen, den Sie im vorherigen Schritt registriert haben.923 Die Registerkarten behandeln beide Befehle: `claude mcp add` nimmt Ihre Client-ID und Ihren Callback-Port als Flags, und `claude mcp add-json` nimmt sie in einem `oauth`-Objekt. Wenn Sie einen Redirect-URI registriert haben, setzen Sie den Callback-Port auf den Port in diesem URI.

925 924

926 <Tabs>925 <Tabs>

927 <Tab title="claude mcp add">926 <Tab title="claude mcp add">

945 </Tab>944 </Tab>

946 945

947 <Tab title="claude mcp add-json (nur Callback-Port)">946 <Tab title="claude mcp add-json (nur Callback-Port)">

948 Verwenden Sie `--callback-port` ohne Client-ID, um den Port zu fixieren und gleichzeitig die dynamische Client-Registrierung zu verwenden:947 Um nur den Callback-Port zu fixieren und Claude Code die Client automatisch registrieren zu lassen, setzen Sie `callbackPort` allein:

949 948

950 ```bash theme={null}949 ```bash theme={null}

951 claude mcp add-json my-server \950 claude mcp add-json my-server \

1039 Verwenden Sie dynamische Header für benutzerdefinierte Authentifizierung1038 Verwenden Sie dynamische Header für benutzerdefinierte Authentifizierung

1040</h3>1039</h3>

1041 1040

1042Wenn Ihr MCP-Server ein anderes Authentifizierungsschema verwendet als OAuth (wie Kerberos, kurzlebige Token oder ein internes SSO), verwenden Sie `headersHelper`, um Request-Header zur Verbindungszeit zu generieren. Claude Code führt den Befehl aus und fügt seine Ausgabe in die Verbindungs-Header ein.1041Wenn Ihr MCP-Server ein anderes Authentifizierungsschema verwendet als OAuth, wie Kerberos, kurzlebige Token oder ein internes SSO, verwenden Sie `headersHelper`, um Request-Header zur Verbindungszeit zu generieren. Claude Code führt den Befehl aus und fügt seine Ausgabe in die Verbindungs-Header ein.

1043 1042

1044```json theme={null}1043```json theme={null}

1045{1044{

1235 </Step>1234 </Step>

1236</Steps>1235</Steps>

1237 1236

1237Anthropic stellt auch einige Connectors selbst bereit, ohne dass Sie oder ein Administrator sie hinzufügen. Bei Konten, auf denen [Claude Docs](/docs/de/artifacts#write-a-document-with-claude-docs) verfügbar ist, listet `/mcp` `claude.ai Claude Docs` ohne Setup auf, und Claude verwendet es, wenn Sie um ein Dokument für andere Personen bitten. Um es auszuschalten, fügen Sie einen `serverName`-Eintrag von `"claude.ai Claude Docs"` zu `deniedMcpServers` hinzu oder verwenden Sie den `/mcp`-Umschalter, beide beschrieben in [claude.ai-Connectors deaktivieren](#disable-claude-ai-connectors).

1238

1238Claude Code markiert einen Connector als `managed` in `/mcp` und im [`/plugin`](/docs/de/plugins/install)-Manager, wenn Ihre Organisation dessen Authentifizierung in claude.ai verwaltet. Der Status „Managed" ändert nicht, wie Claude Code sich mit dem Connector verbindet oder wie die [Tool-Kontrollen](#organization-controls-on-connector-tools) Ihrer Organisation angewendet werden.1239Claude Code markiert einen Connector als `managed` in `/mcp` und im [`/plugin`](/docs/de/plugins/install)-Manager, wenn Ihre Organisation dessen Authentifizierung in claude.ai verwaltet. Der Status „Managed" ändert nicht, wie Claude Code sich mit dem Connector verbindet oder wie die [Tool-Kontrollen](#organization-controls-on-connector-tools) Ihrer Organisation angewendet werden.

1239 1240

1240Connectors, bei denen Sie sich noch nie angemeldet haben, werden hinter einer Zeile `Show unused connectors` am Ende des claude.ai-Abschnitts ausgeblendet, damit eine von der Organisation bereitgestellte Liste das Panel nicht ausfüllt. Wählen Sie die Zeile aus, um sie zu erweitern. Ein Connector, bei dem Sie sich zuvor angemeldet haben, bleibt sichtbar, auch wenn er derzeit eine erneute Authentifizierung benötigt.1241Connectors, bei denen Sie sich noch nie angemeldet haben, werden hinter einer Zeile `Show unused connectors` am Ende des claude.ai-Abschnitts ausgeblendet, damit eine von der Organisation bereitgestellte Liste das Panel nicht ausfüllt. Wählen Sie die Zeile aus, um sie zu erweitern. Ein Connector, bei dem Sie sich zuvor angemeldet haben, bleibt sichtbar, auch wenn er derzeit eine erneute Authentifizierung benötigt.

1250 1251

1251Wenn ein temporäres Netzwerkproblem verhindert, dass die Connector-Liste beim Start Ihrer Sitzung geladen wird, versucht Claude Code den Abruf bis zu dreimal im Hintergrund erneut, und die Connectors werden angezeigt, sobald ein erneuter Versuch erfolgreich ist. Wenn sie immer noch nicht angezeigt werden, starten Sie Claude Code neu, um die Liste erneut abzurufen.1252Wenn ein temporäres Netzwerkproblem verhindert, dass die Connector-Liste beim Start Ihrer Sitzung geladen wird, versucht Claude Code den Abruf bis zu dreimal im Hintergrund erneut, und die Connectors werden angezeigt, sobald ein erneuter Versuch erfolgreich ist. Wenn sie immer noch nicht angezeigt werden, starten Sie Claude Code neu, um die Liste erneut abzurufen.

1252 1253

1253Wenn `/mcp` einen Connector als `connected · session token rejected` anzeigt oder seine Detailansicht [`claude.ai rejected the session token`](/docs/de/errors#claude-ai-rejected-the-session-token) anzeigt, hat claude.ai das Token aus Ihrem Claude Code-Login abgelehnt, normalerweise weil das Login abgelaufen ist und nicht aktualisiert werden konnte. Die erneute Autorisierung des Connectors löscht diesen Status nicht, da die eigene Autorisierung des Connectors in claude.ai nicht das ist, was abgelehnt wurde. Um dies zu beheben:1254Wenn `/mcp` einen Connector als `session token rejected` anzeigt oder seine Detailansicht [`claude.ai rejected the session token`](/docs/de/errors#claude-ai-rejected-the-session-token) anzeigt, hat claude.ai das Token aus Ihrem Claude Code-Login abgelehnt. Die erneute Autorisierung des Connectors löscht diesen Status nicht, da die eigene Autorisierung des Connectors in claude.ai nicht das ist, was abgelehnt wurde. Um dies zu beheben:

1254 1255

12551. Führen Sie `/login` aus, um sich erneut anzumelden.12561. Führen Sie `/login` aus, um sich erneut anzumelden.

12562. Verbinden Sie den Connector erneut von `/mcp`.12572. Verbinden Sie den Connector erneut von `/mcp`.

1416 Wenn Sie häufig Ausgabewarnungen bei bestimmten MCP-Servern erhalten, die Sie nicht kontrollieren, sollten Sie die Begrenzung `MAX_MCP_OUTPUT_TOKENS` erhöhen. Sie können auch den Server-Autor bitten, die Anmerkung `anthropic/maxResultSizeChars` hinzuzufügen oder seine Antworten zu paginieren. Die Anmerkung hat keine Auswirkung auf Tools, die Bildinhalte zurückgeben; für diese ist das Erhöhen von `MAX_MCP_OUTPUT_TOKENS` die einzige Option.1417 Wenn Sie häufig Ausgabewarnungen bei bestimmten MCP-Servern erhalten, die Sie nicht kontrollieren, sollten Sie die Begrenzung `MAX_MCP_OUTPUT_TOKENS` erhöhen. Sie können auch den Server-Autor bitten, die Anmerkung `anthropic/maxResultSizeChars` hinzuzufügen oder seine Antworten zu paginieren. Die Anmerkung hat keine Auswirkung auf Tools, die Bildinhalte zurückgeben; für diese ist das Erhöhen von `MAX_MCP_OUTPUT_TOKENS` die einzige Option.

1417</Warning>1418</Warning>

1418 1419

1420<h3 id="images-in-tool-results">

1421 Bilder in Tool-Ergebnissen

1422</h3>

1423

1424Wenn ein MCP-Tool ein PNG-, JPEG-, GIF- oder WebP-Bild zurückgibt, sieht Claude das Bild inline im Gespräch. Die Inline-Kopie kann verkleinert oder komprimiert werden, um die Bildgrößenlimits des Modells einzuhalten. Claude Code speichert auch die ursprünglichen Bytes in einer Datei im Verzeichnis `tool-results` der Sitzung unter [`~/.claude/projects/`](/docs/de/claude-directory#cleaned-up-automatically) und gibt Claude den Pfad. Claude kann dann die Datei mit vollständiger Auflösung mit Tools wie Bash zuschneiden, konvertieren oder wiederverwenden.

1425

1426Wenn Sie die Sitzungspersistenz mit [`--no-session-persistence`](/docs/de/cli-reference#cli-flags) oder [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/de/env-vars) deaktivieren, schreibt Claude Code keine Bilddatei und Claude erhält nur die Inline-Kopie.

1427

1428Das Speichern von MCP-Bildergebnissen in einer Datei erfordert Claude Code v2.1.283 oder später.

1429

1419<h2 id="tool-input-schemas-with-a-root-level-combinator">1430<h2 id="tool-input-schemas-with-a-root-level-combinator">

1420 Tool-Eingabeschemas mit einem Kombinator auf Root-Ebene1431 Tool-Eingabeschemas mit einem Kombinator auf Root-Ebene

1421</h2>1432</h2>

1487Server können Eingaben auf zwei Arten anfordern:1498Server können Eingaben auf zwei Arten anfordern:

1488 1499

1489* **Formularmodus**: Claude Code zeigt einen Dialog mit Formularfeldern an, die vom Server definiert werden (beispielsweise eine Aufforderung für Benutzernamen und Passwort). Füllen Sie die Felder aus und senden Sie sie ab.1500* **Formularmodus**: Claude Code zeigt einen Dialog mit Formularfeldern an, die vom Server definiert werden (beispielsweise eine Aufforderung für Benutzernamen und Passwort). Füllen Sie die Felder aus und senden Sie sie ab.

1490* **URL-Modus**: Claude Code öffnet eine Browser-URL für Authentifizierung oder Genehmigung. Schließen Sie den Ablauf im Browser ab und bestätigen Sie dann in der CLI.1501* **URL-Modus**: Claude Code fragt, ob ein Link in Ihrem Browser geöffnet werden soll, und öffnet ihn, wenn Sie zustimmen. Server verwenden diesen Modus für einen Ablauf, der außerhalb des Terminals abgeschlossen wird, z. B. für die Anmeldung.

1491 1502

1492Im URL-Modus übergibt Claude Code die URL als Befehlszeilenargument an den URL-Handler Ihres Systems und begrenzt die Länge dieses Arguments. Wenn die URL nach der Escape-Sequenz für die Befehlszeile diese Grenze überschreitet, können Sie die Anfrage nur ablehnen. Jedes Zeichen, das Escape-Sequenzen benötigt, wie `%` oder `&`, zählt vierfach zur Grenze: sein eigenes Zeichen plus drei Escape-Zeichen. Eine URL ohne diese Zeichen erreicht die Grenze bei etwa 8.000 Zeichen. Eine URL, die größtenteils aus Prozentzeichen-Escape-Sequenzen besteht, bei denen jedes dritte Zeichen ein `%` ist, erreicht sie bei etwa 4.000.1503Im URL-Modus übergibt Claude Code die URL als Befehlszeilenargument an den URL-Handler Ihres Systems und begrenzt die Länge dieses Arguments. Wenn die URL nach der Escape-Sequenz für die Befehlszeile diese Grenze überschreitet, können Sie die Anfrage nur ablehnen. Jedes Zeichen, das Escape-Sequenzen benötigt, wie `%` oder `&`, zählt vierfach zur Grenze: sein eigenes Zeichen plus drei Escape-Zeichen. Eine URL ohne diese Zeichen erreicht die Grenze bei etwa 8.000 Zeichen. Eine URL, die größtenteils aus Prozentzeichen-Escape-Sequenzen besteht, bei denen jedes dritte Zeichen ein `%` ist, erreicht sie bei etwa 4.000.

1493 1504

1495 1506

1496Wenn Sie einen MCP-Server erstellen, der Elicitierung verwendet, lesen Sie die [MCP-Elicitierungsspezifikation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) für Protokolldetails und Schemabeispiele.1507Wenn Sie einen MCP-Server erstellen, der Elicitierung verwendet, lesen Sie die [MCP-Elicitierungsspezifikation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) für Protokolldetails und Schemabeispiele.

1497 1508

1509Bei Verbindungen, die [Protokollrevision 2026-07-28](#mcp-client-runtimes) verwenden, deklariert Claude Code `elicitation: {form: {}, url: {}}` in seinen Client-Funktionen, sodass ein Server dort beide Modi über die Standard-Elicitierungsanfrage des Protokolls anfordern kann.

1510

1498<h2 id="use-mcp-resources">1511<h2 id="use-mcp-resources">

1499 MCP-Ressourcen verwenden1512 MCP-Ressourcen verwenden

1500</h2>1513</h2>

1540 * Ressourcen können jeden Inhaltstyp enthalten, den der MCP-Server bereitstellt (Text, JSON, strukturierte Daten usw.)1553 * Ressourcen können jeden Inhaltstyp enthalten, den der MCP-Server bereitstellt (Text, JSON, strukturierte Daten usw.)

1541</Tip>1554</Tip>

1542 1555

1556MCP Apps UI-Ressourcen sind Einträge mit einem `ui://` URI oder dem `text/html;profile=mcp-app` Medientyp: Seiten für eine Host-Anwendung zum Rendern statt Inhalte für Claude zum Lesen. Sie werden nicht in den `@` Vorschlägen oder in den Ergebnissen des Ressourcenlisten-Tools angezeigt, und ein Server, der nur UI-Ressourcen anbietet, zeigt eine leere Ressourcenliste an. Das Lesen einer UI-Ressource über ihren URI funktioniert dennoch.

1557

1543<h2 id="scale-with-mcp-tool-search">1558<h2 id="scale-with-mcp-tool-search">

1544 Mit MCP-Tool-Suche skalieren1559 Mit MCP-Tool-Suche skalieren

1545</h2>1560</h2>

1643 1658

1644MCP-Server können Prompts bereitstellen, die als Befehle in Claude Code verfügbar werden.1659MCP-Server können Prompts bereitstellen, die als Befehle in Claude Code verfügbar werden.

1645 1660

1661Prompts von einem Server namens `anthropic-skills` werden nicht angezeigt, da Claude Code [diesen Namen für mit claude.ai synchronisierte Skills reserviert](/docs/de/skills#names-reserved-for-synced-skills). Die Tools des Servers funktionieren weiterhin. Benennen Sie den Server in Ihrer MCP-Konfiguration um, um seine Prompts aufzulisten.

1662

1646<h3 id="execute-mcp-prompts">1663<h3 id="execute-mcp-prompts">

1647 MCP-Prompts ausführen1664 MCP-Prompts ausführen

1648</h3>1665</h3>

memory.md +9 −0

Details

103 103

104**Konsistenz**: Wenn zwei Regeln sich widersprechen, kann Claude eine willkürlich auswählen. Überprüfen Sie Ihre CLAUDE.md-Dateien, verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen und [`.claude/rules/`](#organize-rules-with-claude/rules/) regelmäßig, um veraltete oder widersprüchliche Anweisungen zu entfernen. In Monorepos verwenden Sie [`claudeMdExcludes`](#exclude-specific-claude-md-files), um CLAUDE.md-Dateien von anderen Teams zu überspringen, die für Ihre Arbeit nicht relevant sind.104**Konsistenz**: Wenn zwei Regeln sich widersprechen, kann Claude eine willkürlich auswählen. Überprüfen Sie Ihre CLAUDE.md-Dateien, verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen und [`.claude/rules/`](#organize-rules-with-claude/rules/) regelmäßig, um veraltete oder widersprüchliche Anweisungen zu entfernen. In Monorepos verwenden Sie [`claudeMdExcludes`](#exclude-specific-claude-md-files), um CLAUDE.md-Dateien von anderen Teams zu überspringen, die für Ihre Arbeit nicht relevant sind.

105 105

106Um Claude diese Dateien auf veraltete oder widersprüchliche Anweisungen überprüfen zu lassen, führen Sie `/doctor prompt-audit` in einer Sitzung aus. Claude liest Ihre CLAUDE.md-, CLAUDE.local.md- und AGENTS.md-Dateien sowie die Regeln, Skills, Befehle, Subagenten und Ausgabestile unter `.claude/` und `~/.claude/`. Es sucht nach Problemen wie Anweisungen, die für ältere Modelle geschrieben wurden, Verweise auf Dateien oder Befehle, die nicht existieren, und Dateien, die sich widersprechen. Sie erhalten einen Bericht mit Erkenntnissen und einen Satz vorgeschlagener Änderungen, und nichts in Ihren Dateien ändert sich, bis Sie Claude bitten, sie anzuwenden.

107

108Um stattdessen eine Datei oder ein Verzeichnis zu überprüfen, übergeben Sie seinen Pfad, zum Beispiel `/doctor prompt-audit .claude/skills/deploy`. Die Überprüfung wird durch den gebündelten `/claude-api`-Skill ausgeführt, daher ist sie nicht verfügbar, während dieser Skill in [`skillOverrides`](/docs/de/skills#override-skill-visibility-from-settings) ausgeschaltet ist oder mit [`disableBundledSkills`](/docs/de/settings-reference#disablebundledskills). `/doctor prompt-audit` erfordert Claude Code v2.1.283 oder später.

109

106<h3 id="import-additional-files">110<h3 id="import-additional-files">

107 Importieren Sie zusätzliche Dateien111 Importieren Sie zusätzliche Dateien

108</h3>112</h3>

273ln -s ~/company-standards/security.md .claude/rules/security.md277ln -s ~/company-standards/security.md .claude/rules/security.md

274```278```

275 279

280Wenn Sie einen `.claude/rules/`- oder `CLAUDE.md`-Symlink auf einen Netzwerkpfad wie die UNC-Freigabe `\\server\share` oder einen Pfad unter `/net` oder `/Network` zeigen, werden die verlinkten Anweisungen nicht geladen. Claude Code folgt dem Link nicht, da das Nachschlagen eines solchen Pfads den Host kontaktieren kann, den er benennt. `\\wsl$`-Pfade zählen nicht als Netzwerkpfade.

281

276<h4 id="user-level-rules">282<h4 id="user-level-rules">

277 Benutzerweite Regeln283 Benutzerweite Regeln

278</h4>284</h4>

620* Ü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)).626* Ü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)).

621* Machen Sie Anweisungen spezifischer. „Verwenden Sie 2-Leerzeichen-Einrückung" funktioniert besser als „formatieren Sie Code schön".627* Machen Sie Anweisungen spezifischer. „Verwenden Sie 2-Leerzeichen-Einrückung" funktioniert besser als „formatieren Sie Code schön".

622* Suchen Sie nach widersprüchlichen Anweisungen über CLAUDE.md-Dateien hinweg. Wenn zwei Dateien unterschiedliche Anleitungen für das gleiche Verhalten geben, kann Claude eine willkürlich auswählen.628* Suchen Sie nach widersprüchlichen Anweisungen über CLAUDE.md-Dateien hinweg. Wenn zwei Dateien unterschiedliche Anleitungen für das gleiche Verhalten geben, kann Claude eine willkürlich auswählen.

629* Überprüfen Sie, ob Ihre Anweisung mit Anleitungen konkurriert, die Claude Code von selbst hinzufügt. Wenn Ihre CLAUDE.md Commit- oder Pull-Request-Regeln setzt, schalten Sie die integrierten mit [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions) aus und legen Sie den Attributionstext mit [`attribution`](/docs/de/settings-reference#attribution) fest.

623 630

624Wenn die Anweisung etwas ist, das an einem bestimmten Punkt ausgeführt werden muss, z. B. vor jedem Commit oder nach jeder Dateibearbeitung, schreiben Sie sie stattdessen als [Hook](/docs/de/hooks-guide). Hooks werden als Shell-Befehle bei festen Lebenszyklusereignissen ausgeführt und gelten unabhängig davon, was Claude entscheidet zu tun.631Wenn die Anweisung etwas ist, das an einem bestimmten Punkt ausgeführt werden muss, z. B. vor jedem Commit oder nach jeder Dateibearbeitung, schreiben Sie sie stattdessen als [Hook](/docs/de/hooks-guide). Hooks werden als Shell-Befehle bei festen Lebenszyklusereignissen ausgeführt und gelten unabhängig davon, was Claude entscheidet zu tun.

625 632

657 664

658Dateien über 200 Zeilen verbrauchen mehr Kontext und können die Einhaltung reduzieren. Claude Code überspringt eine Datei über 4 MiB. Verwenden Sie [pfadgebundene Regeln](#path-specific-rules), um Anweisungen nur zu laden, wenn Claude mit übereinstimmenden Dateien arbeitet, oder trimmen Sie Inhalte, die nicht in jeder Sitzung benötigt werden. Das Aufteilen in [`@path`-Importe](#import-additional-files) hilft bei der Organisation, reduziert aber nicht den Kontext, da importierte Dateien beim Start geladen werden.665Dateien über 200 Zeilen verbrauchen mehr Kontext und können die Einhaltung reduzieren. Claude Code überspringt eine Datei über 4 MiB. Verwenden Sie [pfadgebundene Regeln](#path-specific-rules), um Anweisungen nur zu laden, wenn Claude mit übereinstimmenden Dateien arbeitet, oder trimmen Sie Inhalte, die nicht in jeder Sitzung benötigt werden. Das Aufteilen in [`@path`-Importe](#import-additional-files) hilft bei der Organisation, reduziert aber nicht den Kontext, da importierte Dateien beim Start geladen werden.

659 666

667Wenn eine Ihrer Anweisungsdateien länger als die empfohlene Länge ist, sehen Sie beim Start und wenn Sie `/status` ausführen eine Warnung. Sie sehen auch eine Warnung, wenn Dateien, die jeweils innerhalb dieser Länge liegen, zusammen eine kombinierte Grenze beim Sitzungsstart überschreiten. Jede CLAUDE.md, Regeldatei und `@path`-Import zählt als separate Datei.

668

660Die [`/doctor`](/docs/de/commands#all-commands)-Überprüfung schlägt Kürzungen für eine eingecheckte CLAUDE.md vor: Sie entfernt Inhalte, die Claude aus der Codebasis ableiten kann, wie Verzeichnislayouts, Abhängigkeitslisten und Architekturübersichten, und behält Fallstricke, Begründungen und Konventionen, die sich von Tool-Standardwerten unterscheiden. Die Trim-Überprüfung erfordert Claude Code v2.1.206 oder später.669Die [`/doctor`](/docs/de/commands#all-commands)-Überprüfung schlägt Kürzungen für eine eingecheckte CLAUDE.md vor: Sie entfernt Inhalte, die Claude aus der Codebasis ableiten kann, wie Verzeichnislayouts, Abhängigkeitslisten und Architekturübersichten, und behält Fallstricke, Begründungen und Konventionen, die sich von Tool-Standardwerten unterscheiden. Die Trim-Überprüfung erfordert Claude Code v2.1.206 oder später.

661 670

662<h3 id="instructions-seem-lost-after-/compact">671<h3 id="instructions-seem-lost-after-/compact">

mobile.md +1 −1

Details

44| :- | :- | :- |44| :- | :- | :- |

45| [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) | Eine Sitzung auf Cloud-Infrastruktur, standardmäßig von Anthropic verwaltet | Ihr Repository befindet sich auf GitHub und die Aufgabe sollte weiterhin ausgeführt werden, nachdem Sie Ihr Telefon weglegen. Siehe [Cloud-Schnellstart](/docs/de/web-quickstart), um die Einrichtung durchzuführen. |45| [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) | Eine Sitzung auf Cloud-Infrastruktur, standardmäßig von Anthropic verwaltet | Ihr Repository befindet sich auf GitHub und die Aufgabe sollte weiterhin ausgeführt werden, nachdem Sie Ihr Telefon weglegen. Siehe [Cloud-Schnellstart](/docs/de/web-quickstart), um die Einrichtung durchzuführen. |

46| [Projekte](/docs/de/claude-projects) | Eine Unterhaltung, in der Claude parallele Cloud-Sitzungen als Threads koordiniert | Sie haben einen Strom zusammenhängender Arbeit statt einer einzelnen Aufgabe und möchten sehen, welche Threads beendet wurden oder Sie benötigen. |46| [Projekte](/docs/de/claude-projects) | Eine Unterhaltung, in der Claude parallele Arbeitsstränge koordiniert und Bericht erstattet | Sie haben einen Strom zusammenhängender Arbeit statt einer einzelnen Aufgabe und möchten sehen, welche Stränge beendet wurden oder Sie benötigen. |

48| [Dispatch](/docs/de/desktop#sessions-from-dispatch) | Die Desktop-App auf Ihrem Computer | Sie möchten eine Aufgabe anschreiben und Dispatch entscheiden lassen, wie sie ausgeführt wird. Erfordert einen Pro- oder Max-Plan. |48| [Dispatch](/docs/de/desktop#sessions-from-dispatch) | Die Desktop-App auf Ihrem Computer | Sie möchten eine Aufgabe anschreiben und Dispatch entscheiden lassen, wie sie ausgeführt wird. Erfordert einen Pro- oder Max-Plan. |

49 49

model-config.md +175 −101

Details

12 12

13Für die `model`-Einstellung in Claude Code können Sie entweder konfigurieren:13Für die `model`-Einstellung in Claude Code können Sie entweder konfigurieren:

14 14

~~15* Einen **Modell-Alias**~~15* Einen **Modellalias**

16* Einen **Modellnamen**16* Einen **Modellnamen**

17 * Anthropic API: einen vollständigen **[Modellnamen](https://platform.claude.com/docs/en/about-claude/models/overview)**17 * Anthropic API: einen vollständigen **[Modellnamen](https://platform.claude.com/docs/en/about-claude/models/overview)**

18 * Amazon Bedrock: ein Inference-Profil-ARN18 * Amazon Bedrock: ein Inference-Profil-ARN

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

~~29 Modell-Aliase~~29 Modellaliase

30</h3>30</h3>

31 31

~~32Verwenden Sie einen Modell-Alias, um Modelleinstellungen auszuwählen, ohne sich genaue Versionsnummern merken zu müssen:~~32Verwenden Sie einen Modellalias, um Modelleinstellungen auszuwählen, ohne sich genaue Versionsnummern merken zu müssen:

33 33

~~34| Modell-Alias | Verhalten |~~34| Modellalias | Verhalten |

35| - | - |35| - | - |

~~36| **`default`** | Spezialwert, der jeden Modell-Override löscht und auf den [Laufzeit-Standard für Ihr Konto](#default-model-setting) zurückgesetzt wird. Ist selbst kein Modell-Alias |~~36| **`default`** | Spezialwert, der jeden Modellüberschreibung löscht und auf den [Laufzeit-Standard für Ihr Konto](#default-model-setting) zurückgesetzt wird. Ist selbst kein Modellalias |

~~37| **`best`** | Verwendet das Modell, zu dem der Alias [`fable`](#fable-alias-resolution) aufgelöst wird, wo Fable für Sie verfügbar ist, andernfalls das gleiche Modell wie `opus` |~~37| **`best`** | Verwendet das Modell, zu dem der [`fable`-Alias aufgelöst wird](#fable-alias-resolution), wenn Fable für Sie verfügbar ist, andernfalls das gleiche Modell wie `opus` |

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

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

41| **`haiku`** | Verwendet das schnelle und effiziente Haiku-Modell für einfache Aufgaben |41| **`haiku`** | Verwendet das schnelle und effiziente Haiku-Modell für einfache Aufgaben |

42| **`sonnet[1m]`** | Verwendet Sonnet mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen. Keine Auswirkung, wenn `sonnet` bereits zu Sonnet 5 mit seinem nativen 1M-Fenster aufgelöst wird; hinter einem [LLM-Gateway](/docs/de/llm-gateway) wählt es das 1M-Fenster für Sonnet 5 |42| **`sonnet[1m]`** | Verwendet Sonnet mit einem [Kontextfenster von 1 Million Token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen. Keine Auswirkung, wenn `sonnet` bereits zu Sonnet 5.5 oder Sonnet 5 mit ihrem nativen 1M-Fenster aufgelöst wird; hinter einem [LLM-Gateway](/docs/de/llm-gateway) wählt das 1M-Fenster für dieses Modell aus |

43| **`opus[1m]`** | Verwendet Opus mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen |43| **`opus[1m]`** | Verwendet Opus mit einem [Kontextfenster von 1 Million Token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen |

~~44| **`opusplan`** | Spezialmodell, das `opus` während des Plan Mode verwendet und dann zu `sonnet` für die Ausführung wechselt |~~44| **`opusplan`** | Spezialmodell, das `opus` während des Plan-Modus verwendet und dann zu `sonnet` für die Ausführung wechselt |

45 45

46Die Version, zu der die Aliase `opus` und `sonnet` aufgelöst werden, hängt vom Anbieter ab:46Die Version, zu der die Aliase `opus` und `sonnet` aufgelöst werden, hängt vom Anbieter ab:

47 47

49| :- | :- | :- |49| :- | :- | :- |

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56

57Sofern Sie `ANTHROPIC_DEFAULT_FABLE_MODEL` nicht setzen, wird der Alias `fable` zu Fable 5.1 aufgelöst, außer in [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen, wo `fable` und `best` zu Fable 5 aufgelöst werden. Vor v2.1.257 wurde `fable` auf jedem Anbieter zu Fable 5 aufgelöst.57Sofern Sie `ANTHROPIC_DEFAULT_FABLE_MODEL` nicht festlegen, wird der `fable`-Alias zu Fable 5.1 aufgelöst, außer in [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen, wo `fable` und `best` zu Fable 5 aufgelöst werden.

58 58

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

60 60

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

62 62

63Vor v2.1.280 wurde `opus` zu Opus 5 auf der Anthropic API, Claude Platform on AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.219 aufgelöst. Vor v2.1.219 wurde `opus` zu Opus 4.8 auf der Anthropic API ab v2.1.154 und auf Claude Platform on AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.207 aufgelöst. Vor v2.1.207 wurde `opus` zu Opus 4.7 auf Claude Platform on AWS und zu Opus 4.6 auf Amazon Bedrock und Google Cloud's Agent Platform aufgelöst.63Frühere Versionen lösen diese Aliase zu älteren Modellen auf. Für die Version, in der sich jeder Alias geändert hat, siehe [Versionsverlauf](#version-history).

64 64

65Aliase verweisen auf die empfohlene Version für Ihren Anbieter und werden im Laufe der Zeit aktualisiert. Um eine bestimmte Version zu fixieren, verwenden Sie den vollständigen Modellnamen, z. B. `claude-opus-5-5`, oder setzen Sie die entsprechende Umgebungsvariable wie `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Aliase verweisen auf die empfohlene Version für Ihren Anbieter und werden im Laufe der Zeit aktualisiert. Um eine bestimmte Version zu fixieren, verwenden Sie den vollständigen Modellnamen, z. B. `claude-opus-5-5`, oder legen Sie die entsprechende Umgebungsvariable wie `ANTHROPIC_DEFAULT_OPUS_MODEL` fest.

66 66

67<Note>67<Note>

~~68 Opus 5.5 erfordert Claude Code v2.1.280 oder später. Opus 5 erfordert v2.1.219 oder später. Sonnet 5 erfordert v2.1.197 oder später. Führen Sie `claude update` aus, um zu aktualisieren.~~68 Sonnet 5.5 erfordert Claude Code v2.1.284 oder später, und Opus 5.5 erfordert v2.1.280 oder später. Führen Sie `claude update` aus, um zu aktualisieren.

69</Note>69</Note>

70 70

71<h3 id="work-with-fable">71<h3 id="work-with-fable">

76 76

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

78 78

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

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

81 81

82Wenn Sie sich direkt mit der Anthropic API verbinden und Ihre Benutzereinstellungen `claude-fable-5` oder `claude-fable-5[1m]` als Modell enthalten, z. B. weil Sie Fable in der `/model`-Auswahl vor v2.1.257 ausgewählt haben, ändert Claude Code diesen gespeicherten Wert beim ersten Ausführen von v2.1.257 oder später zu dem Alias `fable` oder `fable[1m]`, und die Startmodellzeile zeigt `(auto-updated)` einmal an. Ein `claude-fable-5`-Wert in Projekt-, lokalen oder verwalteten Einstellungen wird unverändert gelassen.82Wenn Sie sich direkt mit der Anthropic API verbinden und Ihre Benutzereinstellungen `claude-fable-5` oder `claude-fable-5[1m]` als Modell enthalten, z. B. weil Sie Fable in der `/model`-Auswahl vor v2.1.257 ausgewählt haben, ändert Claude Code diesen gespeicherten Wert beim ersten Ausführen von v2.1.257 oder später in den `fable`- oder `fable[1m]`-Alias. Die Startmodellzeile zeigt `(auto-updated)` einmal an. Ein `claude-fable-5`-Wert in Projekt-, Lokal- oder verwalteten Einstellungen bleibt unverändert.

83 83

84Anfragen, die die Sicherheitsklassifizierer eines Fable-Modells kennzeichnen, meist in Cybersicherheits- und Biologie-Bereichen, lösen [automatisches Modell-Fallback](#automatic-model-fallback) aus.84Anfragen, die die Sicherheitsklassifizierer eines Fable-Modells kennzeichnen, meist in Cybersicherheits- und Biologie-Bereichen, lösen [automatisches Modell-Fallback](#automatic-model-fallback) aus.

85 85

86Um das Beste aus Fable herauszuholen:86Um das Beste aus Fable herauszuholen:

87 87

88* **Beschreiben Sie das Ergebnis, nicht die Schritte**: Geben Sie ihm das Ergebnis, das Sie möchten, und lassen Sie es den Weg planen. Um es auf dieses Ergebnis hinzuarbeiten, [setzen Sie ein Ziel](/docs/de/goal).88* **Beschreiben Sie das Ergebnis, nicht die Schritte**: Geben Sie ihm das Ergebnis, das Sie möchten, und lassen Sie es den Weg planen. Um es auf dieses Ergebnis hinzuarbeiten, [setzen Sie ein Ziel](/docs/de/goal).

89* **Geben Sie ihm mehrdeutige Probleme**: Root-Cause-Untersuchungen, Ausfalldebugging und Architekturentscheidungen sind Bereiche, in denen die zusätzliche Untersuchung und Überprüfung sich auszahlt.89* **Geben Sie ihm mehrdeutige Probleme**: Ursachenuntersuchungen, Ausfalldebugging und Architekturentscheidungen sind Bereiche, in denen die zusätzliche Untersuchung und Überprüfung sich auszahlt.

~~90* **Überspringen Sie die Überprüfungserinnerungen**: Es überprüft seine eigene Arbeit mit weniger Aufforderungen, daher sind Erinnerungen zum Testen oder Überprüfen normalerweise unnötig.~~90* **Überspringen Sie die Überprüfungserinnerungen**: Es überprüft seine eigene Arbeit mit weniger Aufforderung, daher sind Erinnerungen zum Testen oder Überprüfen normalerweise unnötig.

91* **Größere Aufgaben einschätzen**: Geben Sie ihm Arbeit, die Sie normalerweise in Teile aufteilen würden. Es hält lange Sitzungen, ohne den Faden zu verlieren.91* **Größere Aufgaben einschätzen**: Geben Sie ihm Arbeit, die Sie normalerweise in Teile aufteilen würden. Es hält lange Sitzungen, ohne den Faden zu verlieren.

92 92

93<Note>93<Note>

94 Fable 5.1 erfordert Claude Code v2.1.257 oder später. Wenn eine Anfrage dafür von einer älteren Version fehlschlägt, siehe [Claude Code does not support this model](/docs/de/errors#claude-code-does-not-support-this-model). Führen Sie `claude update` aus, um zu aktualisieren. Zur Verfügbarkeit unter Zero Data Retention siehe [Model availability under ZDR](/docs/de/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 erfordert Claude Code v2.1.257 oder später. Wenn eine Anfrage dafür von einer älteren Version fehlschlägt, siehe [Claude Code does not support this model](/docs/de/errors#claude-code-does-not-support-this-model). Führen Sie `claude update` aus, um zu aktualisieren. Zur Verfügbarkeit unter Null-Datenspeicherung siehe [Model availability under ZDR](/docs/de/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96

97Auf der Anthropic API wird ein Fable-Modell in der `/model`-Auswahl aufgelistet, es sei denn, [`availableModels`](#restrict-model-selection) oder [Organisations-Modellbeschränkungen](#organization-model-restrictions) schließen es aus. Wenn Ihre Organisation Fable überhaupt nicht verwenden kann, z. B. unter [Zero Data Retention](/docs/de/zero-data-retention#model-availability-under-zdr), bleibt die Zeile in der Auswahl ausgegraut, mit einer Notiz darüber, warum.97Auf der Anthropic API wird ein Fable-Modell in der `/model`-Auswahl angezeigt, sofern [`availableModels`](#restrict-model-selection) oder [Organisationsmodellbeschränkungen](#organization-model-restrictions) es nicht ausschließen. Wenn Ihre Organisation Fable überhaupt nicht verwenden kann, z. B. unter [Null-Datenspeicherung](/docs/de/zero-data-retention#model-availability-under-zdr), bleibt die Zeile in der Auswahl ausgegraut mit einer Notiz zum Grund.

98 98

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable und Nutzungsguthaben100 Fable und Nutzungsguthaben

101</h4>101</h4>

102 102

103Je nach Ihrem Plan und Seat-Tier kann die Fable-Nutzung zu [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) abgerechnet werden, anstatt auf die in Ihrem Plan enthaltenen Limits zu ziehen. Wenn dies der Fall ist, zeigt die `/model`-Auswahl „Requires usage credits" in der Fable-Zeile an. Um Nutzungsguthaben zu verwalten, siehe [Add usage credits to your subscription](/docs/de/costs#add-usage-credits-to-your-subscription).103Je nach Plan und Seat-Tier kann die Fable-Nutzung zu [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) abgerechnet werden, anstatt auf die im Plan enthaltenen Limits zu ziehen. Wenn dies der Fall ist, zeigt die `/model`-Auswahl „Requires usage credits" in der Fable-Zeile an. Um Nutzungsguthaben zu verwalten, siehe [Add usage credits to your subscription](/docs/de/costs#add-usage-credits-to-your-subscription).

104 104

105In interaktiven Sitzungen zeigt Claude Code eine Zustimmungsaufforderung an, bevor eine Fable-Anfrage Nutzungsguthaben abrechnet. Mitglieder von Enterprise-Plänen mit Organisationsabrechnung sehen die Aufforderung nicht. Sie können auf Fable mit Nutzungsguthaben fortfahren oder zu Ihrem Standardmodell wechseln. Sie können die Aufforderung auch ablehnen:105In interaktiven Sitzungen zeigt Claude Code eine Zustimmungsaufforderung an, bevor eine Fable-Anfrage Nutzungsguthaben abrechnet. Mitglieder von Enterprise-Plänen mit Organisationsabrechnung sehen die Aufforderung nicht. Sie können auf Fable mit Nutzungsguthaben fortfahren oder zu Ihrem Standardmodell wechseln. Sie können die Aufforderung auch verwerfen:

106 106

107* In der `/model`-Auswahl behalten Sie Ihr aktuelles Modell.107* In der `/model`-Auswahl behalten Sie Ihr aktuelles Modell.

108* Während der Sitzung setzt Claude Code den Zug auf Ihrem Standardmodell fort.108* Während der Sitzung setzt Claude Code den Zug auf Ihrem Standardmodell fort.

109 109

110Nachdem Sie sich entschieden haben, auf Fable mit Nutzungsguthaben fortzufahren, zeigt Claude Code die Aufforderung nicht erneut an.110Nachdem Sie sich entschieden haben, auf Fable mit Nutzungsguthaben fortzufahren, zeigt Claude Code die Aufforderung nicht erneut an.

111 111

112In einer Sitzung mit verbundenem [Remote Control](/docs/de/remote-control), einer [Hintergrund-Sitzung](/docs/de/agent-view) oder einer Sitzung eines [Agent-Team](/docs/de/agent-teams)-Teamkollegen kann niemand am Terminal sein, daher hält Claude Code die Zustimmungsaufforderung während der Sitzung bis zur [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry)-Frist, standardmäßig fünf Minuten. Wenn bis zur Frist niemand geantwortet hat, beendet Claude Code den Zug ohne Senden der Anfrage und fügt eine Notiz zum Transkript hinzu, die der Remote-Control-Client auch anzeigt. Ihre Modellauswahl ist unverändert, und Claude Code fragt beim nächsten Mal nach Zustimmung.112In einer Sitzung mit [Remote Control](/docs/de/remote-control) verbunden, einer [Hintergrund-Sitzung](/docs/de/agent-view) oder einer [Agent-Team](/docs/de/agent-teams)-Kollegensitzung kann niemand am Terminal sein, daher hält Claude Code die Zustimmungsaufforderung während der Sitzung für die [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry)-Frist, standardmäßig fünf Minuten. Wenn bis zur Frist niemand geantwortet hat, beendet Claude Code den Zug ohne Senden der Anfrage und fügt eine Notiz zum Transkript hinzu, die der Remote-Control-Client auch anzeigt. Ihre Modellauswahl ist unverändert, und Claude Code fragt beim nächsten Mal nach Zustimmung.

113 113

114Was Sie tun können, während die Aufforderung wartet, hängt von der Sitzung ab:114Was Sie tun können, während die Aufforderung wartet, hängt von der Sitzung ab:

115 115

116* Mit verbundenem Remote Control oder in einer Teamkollegen-Sitzung drücken Sie eine beliebige Taste am Terminal, um die Frist zu stornieren, und Claude Code wartet auf Ihre Antwort.116* Mit Remote Control verbunden oder in einer Kollegensitzung drücken Sie eine beliebige Taste am Terminal, um die Frist zu stornieren, und Claude Code wartet auf Ihre Antwort.

117* In einer Hintergrund-Sitzung antworten Sie vor der Frist.117* In einer Hintergrund-Sitzung antworten Sie vor der Frist.

118* Wenn Sie eine neue Nachricht vom Remote-Client senden, bevor jemand am Terminal eingegeben hat, beendet Claude Code den Zug auf die gleiche Weise, und Ihre neue Nachricht startet den nächsten Zug. Nachdem jemand am Terminal eingegeben hat, wartet Claude Code weiter auf die Antwort und reiht Ihre neue Nachricht dahinter ein.118* Wenn Sie eine neue Nachricht vom Remote-Client senden, bevor jemand am Terminal eingegeben hat, beendet Claude Code den Zug auf die gleiche Weise, und Ihre neue Nachricht startet den nächsten Zug. Nachdem jemand am Terminal eingegeben hat, wartet Claude Code weiter auf die Antwort und reiht Ihre neue Nachricht dahinter ein.

119 119

127 127

1281. **Während der Sitzung**: Verwenden Sie `/model <alias|name>`, um sofort zu wechseln, oder führen Sie `/model` ohne Argument aus, um die Auswahl zu öffnen. Siehe [wenn Claude Code Sie auffordert, den Wechsel zu bestätigen](/docs/de/prompt-caching#switching-models)1281. **Während der Sitzung**: Verwenden Sie `/model <alias|name>`, um sofort zu wechseln, oder führen Sie `/model` ohne Argument aus, um die Auswahl zu öffnen. Siehe [wenn Claude Code Sie auffordert, den Wechsel zu bestätigen](/docs/de/prompt-caching#switching-models)

1292. **Beim Start**: Starten Sie mit `claude --model <alias|name>`1292. **Beim Start**: Starten Sie mit `claude --model <alias|name>`

1303. **Umgebungsvariable**: Setzen Sie `ANTHROPIC_MODEL=<alias|name>`1303. **Umgebungsvariable**: Legen Sie `ANTHROPIC_MODEL=<alias|name>` fest

1314. **Einstellungen**: Konfigurieren Sie dauerhaft in Ihrer Einstellungsdatei mit dem Feld `model`1314. **Einstellungen**: Konfigurieren Sie dauerhaft in Ihrer Einstellungsdatei mit dem `model`-Feld

1325. **[Standard für neue Sitzungen](#set-a-default-model-for-new-sessions)**: Setzen Sie `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1325. **[Standard für neue Sitzungen](#set-a-default-model-for-new-sessions)**: Legen Sie `ANTHROPIC_DEFAULT_MODEL=<alias|name>` fest

133 133

134`/model` speichert Ihre Auswahl als Standard für neue Sitzungen, indem das Feld `model` in Ihren Benutzereinstellungen geschrieben wird. In der Auswahl:134`/model` speichert Ihre Auswahl als Standard für neue Sitzungen, indem das `model`-Feld in Ihren Benutzereinstellungen geschrieben wird. In der Auswahl:

135 135

136* `Enter`: Modell wechseln und als Standard speichern136* `Enter`: Modell wechseln und als Standard speichern

137* `s`: Modell nur für diese Sitzung wechseln und Ihren Standard unverändert lassen. Um eine andere Taste zu verwenden, binden Sie [`modelPicker:thisSessionOnly`](/docs/de/keybindings#model-picker-actions) neu.137* `s`: Modell nur für diese Sitzung wechseln und Standard unverändert lassen. Um einen anderen Schlüssel zu verwenden, binden Sie [`modelPicker:thisSessionOnly`](/docs/de/keybindings#model-picker-actions) neu

138 138

139Die direkte Eingabe von `/model <name>` verhält sich wie `Enter`. Um nur für diese Sitzung zu wechseln, öffnen Sie die Auswahl mit `/model` und drücken Sie `s` auf der Zeile des Modells.139Wenn Sie `/model <name>` direkt eingeben, verhält es sich wie `Enter`. Um nur für diese Sitzung zu wechseln, öffnen Sie die Auswahl mit `/model` und drücken Sie `s` in der Modellzeile.

140 140

141Wenn Sie Modelle mit `/model` wechseln, erreicht der Wechsel auch [Subagenten, die das Modell der Hauptkonversation erben](/docs/de/sub-agents#choose-a-model), da Claude Code ihr Modell aus dem auflöst, das Ihre Sitzung verwendet, wenn Claude sie startet. Wechseln Sie zu Opus, bevor Claude Forschung oder Test-Läufe an einen von ihnen delegiert, und diese Arbeit läuft auch auf Opus. Um einen benutzerdefinierten Subagenten auf einem kleineren Modell zu halten, setzen Sie `model` in seiner Definition.141Auf einem Enterprise-Plan, wenn Sie mit Ihrem claude.ai-Konto angemeldet sind und einen Standard mit `/model` speichern, zeichnet Claude Code die Auswahl auch auf diesem Konto auf. Dies erfordert Claude Code v2.1.280 oder später.

142 142

143Wenn Sie ein Modell mit `/model` im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p`-Flag setzen, gilt Ihre Auswahl nur für die aktuelle Sitzung und wird nicht als Standard gespeichert; `/model` in diesem Modus erfordert Claude Code v2.1.205 oder später. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. Ein [Organisations-Standard-Modell](#organization-default-model), das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.143* Wenn Ihr Administrator kein [Organisationsstandardmodell](#organization-default-model) festgelegt hat, kann die [Standard-Option](#default-model-setting) zu dem aufgezeichneten Modell aufgelöst werden, und wenn dies der Fall ist, zeigt die Standard-Zeile des Pickers den Namen dieses Modells.

144* Wenn [Modellbeschränkungen](#restrict-model-selection) das aufgezeichnete Modell ausschließen oder es nicht für Ihr Konto verfügbar ist, und Ihr Administrator kein Organisationsstandardmodell festgelegt hat, wird die Standard-Option aufgelöst, als ob nichts aufgezeichnet worden wäre.

145* Wenn Sie Standard oder `opusplan` in `/model` auswählen, ändert sich die aufgezeichnete Auswahl nicht.

146

147Wenn Sie Modelle mit `/model` wechseln, erreicht der Wechsel auch [Subagenten, die das Modell der Hauptkonversation erben](/docs/de/sub-agents#choose-a-model), da Claude Code ihr Modell von dem auflöst, das Ihre Sitzung verwendet, wenn Claude sie startet. Wechseln Sie zu Opus, bevor Claude Forschung oder Testläufe an einen delegiert, und diese Arbeit läuft auch auf Opus. Um einen benutzerdefinierten Subagenten auf einem kleineren Modell zu halten, legen Sie `model` in seiner Definition fest.

148

149Wenn Sie ein Modell mit `/model` im [nicht-interaktiven Modus](/docs/de/headless) festlegen, mit dem `-p`-Flag, gilt Ihre Auswahl nur für die aktuelle Sitzung und wird nicht als Standard gespeichert; `/model` in diesem Modus erfordert Claude Code v2.1.205 oder später. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. Ein [Organisationsstandardmodell](#organization-default-model), das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.

144 150

145In v2.1.144 bis v2.1.152 galt `/model` nur für die aktuelle Sitzung und `d` in der Auswahl speicherte einen Standard.151In v2.1.144 bis v2.1.152 galt `/model` nur für die aktuelle Sitzung und `d` in der Auswahl speicherte einen Standard.

146 152

147Das Flag `--model` und die Umgebungsvariable `ANTHROPIC_MODEL` gelten nur für die Sitzung, mit der Sie sie starten. Um verschiedene Modelle in verschiedenen Terminals gleichzeitig auszuführen, starten Sie jedes mit seinem eigenen `--model`-Flag, anstatt mit `/model` zu wechseln.153Das `--model`-Flag und die `ANTHROPIC_MODEL`-Umgebungsvariable gelten nur für die Sitzung, mit der Sie sie starten. Um verschiedene Modelle in verschiedenen Terminals gleichzeitig auszuführen, starten Sie jedes mit seinem eigenen `--model`-Flag, anstatt mit `/model` zu wechseln.

148 154

149Preise in der `/model`-Auswahl werden angezeigt, wenn Claude Code mit der Anthropic API spricht, direkt oder über ein [LLM-Gateway](/docs/de/llm-gateway), das es proxiert, und der Preis in einer Zeile ist der Preis des Modells, das diese Zeile auswählt. Bei [Drittanbieter-Anbietern](/docs/de/third-party-integrations) wie Amazon Bedrock und beim [Claude apps gateway](/docs/de/claude-apps-gateway) bestimmt Ihr Anbieter oder Gateway, was Sie zahlen, daher zeigen Auswahl-Zeilen keinen Preis. Der Preis ist nur ein Anzeigelabel; er beeinflusst nicht, welches Modell eine Zeile auswählt oder was Ihr Anbieter abrechnet. Vor v2.1.206 zeigten [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und Gateway-Sitzungen Anthropic-Listenpreise, und eine Zeile könnte den Preis eines anderen Modells als dem, das sie auswählte, anzeigen.155Preise in der `/model`-Auswahl werden angezeigt, wenn Claude Code mit der Anthropic API spricht, direkt oder über ein [LLM-Gateway](/docs/de/llm-gateway), das sie proxiert, und der Preis in einer Zeile ist der Preis des Modells, das diese Zeile auswählt. Bei [Drittanbieter-Anbietern](/docs/de/third-party-integrations) wie Amazon Bedrock und im [Claude apps gateway](/docs/de/claude-apps-gateway) bestimmt Ihr Anbieter oder Gateway, was Sie zahlen, daher zeigen Auswahlzeilen keinen Preis. Der Preis ist nur ein Anzeigelabel; er beeinflusst nicht, welches Modell eine Zeile auswählt oder was Ihr Anbieter abrechnet. Vor v2.1.206 zeigten [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und Gateway-Sitzungen Anthropic-Listenpreise, und eine Zeile könnte den Preis eines anderen Modells als dem anzeigen, das sie auswählte.

150 156

151Wiederaufgenommene Sitzungen, die mit `claude --resume`, `--continue` oder der `/resume`-Auswahl gestartet wurden, behalten das Modell, das sie beim Speichern des Transkripts verwendeten, unabhängig von der aktuellen `model`-Einstellung. Wenn das wiederhergestellte Modell eingestellt wurde oder von [`availableModels`](#restrict-model-selection) ausgeschlossen wird, fällt die Sitzung auf die normale Prioritätsreihenfolge zurück. Dies verhindert, dass die `/model`-Auswahl einer anderen Sitzung das Modell beim Fortsetzen ändert. Bei Anbietern, die anbieter-spezifische Bereitstellungs-IDs anstelle von Anthropic-Modell-IDs verwenden, wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, wird das Transkript-Modell überhaupt nicht wiederhergestellt und die Sitzung löst ihr Modell durch die normale Prioritätsreihenfolge auf.157Fortgesetzte Sitzungen, die mit `claude --resume`, `--continue` oder der `/resume`-Auswahl gestartet wurden, behalten das Modell, das sie beim Speichern des Transkripts verwendeten, unabhängig von der aktuellen `model`-Einstellung. Wenn das wiederhergestellte Modell eingestellt wurde oder von [`availableModels`](#restrict-model-selection) ausgeschlossen wird, fällt die Sitzung auf die normale Prioritätsreihenfolge zurück. Dies verhindert, dass die `/model`-Auswahl einer anderen Sitzung das Modell beim Fortsetzen ändert. Bei Anbietern, die anbieter-spezifische Bereitstellungs-IDs anstelle von Anthropic-Modell-IDs verwenden, wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, wird das Transkriptmodell überhaupt nicht wiederhergestellt und die Sitzung löst ihr Modell durch die normale Prioritätsreihenfolge auf.

152 158

153Ein Modell, das Sie für den neuen Start mit `--model` oder `ANTHROPIC_MODEL` auswählen, hat weiterhin Vorrang vor dem wiederhergestellten Modell. Ab v2.1.195 gilt dies auch für eine [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables)-Familienvariable. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) kann dies auch unter den in seinem Abschnitt aufgelisteten Bedingungen tun.159Ein Modell, das Sie für den neuen Start mit `--model` oder `ANTHROPIC_MODEL` auswählen, hat weiterhin Vorrang vor dem wiederhergestellten Modell. Ab v2.1.195 gilt dies auch für eine [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables)-Familienvariable. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) kann dies auch unter den in seinem Abschnitt aufgelisteten Bedingungen tun.

154 160

155Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen statt aus Ihrer eigenen Auswahl stammt, zeigt der Start-Header, welche Einstellungsdatei es gesetzt hat. Führen Sie `/model` aus, um zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet. Auf Plattformen, die Claude Code einbetten und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete `availableModels`-Zulassungsliste in Kraft bleibt, es sei denn, der Host liefert seine eigene; [Exceptions to managed settings precedence](/docs/de/settings#exceptions-to-managed-settings-precedence) sagt, welche Schlüssel und Variablen der Host überschreibt.161Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen statt aus Ihrer eigenen Auswahl stammt, zeigt der Startheader, welche Einstellungsdatei es festgelegt hat. Führen Sie `/model` aus, um zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet. Auf Plattformen, die Claude Code einbetten und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) festlegen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete `availableModels`-Zulassungsliste in Kraft bleibt, sofern der Host nicht seine eigene bereitstellt; [Exceptions to managed settings precedence](/docs/de/settings#exceptions-to-managed-settings-precedence) sagt, welche Schlüssel und Variablen der Host überschreibt.

156 162

157Wenn Sie oder Ihre Organisation [PreModelSwitch-Hooks](/docs/de/hooks#premodelswitch) konfigurieren, werden sie ausgeführt, bevor ein angefordeter Wechsel angewendet wird, und können ihn blockieren oder Sie auffordern, ihn zu bestätigen.163Wenn Sie oder Ihre Organisation [PreModelSwitch-Hooks](/docs/de/hooks#premodelswitch) konfigurieren, werden sie vor einem angeforderten Wechsel ausgeführt und können ihn blockieren oder Sie auffordern, ihn zu bestätigen.

158 164

159Wenn Claude Code nicht feststellen kann, welche PreModelSwitch-Hooks Ihre Organisation's [verwaltete Plugins](/docs/de/settings-reference#enabledplugins) bereitstellen, z. B. weil ein verwaltetes Plugin nicht geladen werden konnte, lehnt es den Wechsel ab, anstatt ihn unkontrolliert anzuwenden, und prüft ihn bei jedem neuen Versuch erneut. Siehe [Model switch was blocked by a PreModelSwitch hook](/docs/de/errors#model-switch-was-blocked-by-a-premodelswitch-hook) für die Nachricht und Wiederherstellung.165Wenn Claude Code nicht feststellen kann, welche PreModelSwitch-Hooks Ihre Organisation's [verwaltete Plugins](/docs/de/settings-reference#enabledplugins) bereitstellen, z. B. weil ein verwaltetes Plugin nicht geladen werden konnte, lehnt es den Wechsel ab, anstatt ihn ungeprüft anzuwenden, und prüft ihn bei jedem neuen Versuch erneut. Siehe [Model switch was blocked by a PreModelSwitch hook](/docs/de/errors#model-switch-was-blocked-by-a-premodelswitch-hook) für die Nachricht und Wiederherstellung.

160 166

161Wenn Sie Modelle über die [Agent SDK](/docs/de/agent-sdk/overview)-Methode `setModel()` wechseln oder von einem Gerät, das über [Remote Control](/docs/de/remote-control) verbunden ist, oder eine App wie die [Desktop-App](/docs/de/desktop), die die Claude Code CLI für Sie ausführt, Claude Code wechselt, prüft Claude Code, dass die Zeichenkette eine ist, die es erkennt, bevor es sie speichert. Diese Prüfung erfordert Claude Code v2.1.200 oder später. Das Überprüfen einer Remote-Control-Auswahl erfordert Claude Code v2.1.260 oder später auf Ihrem Computer. Auf der Anthropic API erkennt Claude Code:167Wenn Sie Modelle über die [Agent SDK](/docs/de/agent-sdk/overview) `setModel()`-Methode wechseln oder von einem Gerät, das über [Remote Control](/docs/de/remote-control) verbunden ist, oder eine App wie die [Desktop-App](/docs/de/desktop), die die Claude Code CLI ausführt, für Sie wechselt, prüft Claude Code, dass die Zeichenkette eine ist, die es erkennt, bevor es sie speichert. Diese Prüfung erfordert Claude Code v2.1.200 oder später. Das Überprüfen einer Remote-Control-Auswahl erfordert Claude Code v2.1.260 oder später auf Ihrem Computer. Auf der Anthropic API erkennt Claude Code:

162 168

163* einen Modell-Alias169* einen Modellalias

164* einen Eintrag aus der `/model`-Auswahl170* einen Eintrag aus der `/model`-Auswahl

165* jeden Namen, der mit `claude-` beginnt171* jeden Namen, der mit `claude-` beginnt

166* einen Wert, den Sie selbst als [benutzerdefinierte Modelloption](#add-a-custom-model-option) oder in [`modelOverrides`](#override-model-ids-per-version) konfiguriert haben172* einen Wert, den Sie selbst als [benutzerdefinierte Modelloption](#add-a-custom-model-option) oder in [`modelOverrides`](#override-model-ids-per-version) konfiguriert haben

167 173

168Claude Code lehnt eine unbekannte Zeichenkette mit `Model "<name>" is not a recognized model id.` ab und die Sitzung behält ihr aktuelles Modell, anstatt die Zeichenkette zu speichern und beim nächsten Request fehlzuschlagen. Siehe [die Fehlerreferenz](/docs/de/errors#model-is-not-a-recognized-model-id) für Wiederherstellungsschritte.174Claude Code lehnt eine unbekannte Zeichenkette mit `Model "<name>" is not a recognized model id.` ab und die Sitzung behält ihr aktuelles Modell, anstatt die Zeichenkette zu speichern und beim nächsten Request zu fehlschlagen. Siehe [die Fehlerreferenz](/docs/de/errors#model-is-not-a-recognized-model-id) für Wiederherstellungsschritte.

169 175

170Die Prüfung läuft nur auf der Anthropic API. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/docs/de/llm-gateway) oder einem benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, daher gibt Claude Code jede Zeichenkette ohne Prüfung durch. Die Prüfung deckt auch nicht das Flag `--model`, die Umgebungsvariable `ANTHROPIC_MODEL` oder die Einstellung `model` ab; ein Tippfehler dort erzeugt [There's an issue with the selected model](/docs/de/errors#theres-an-issue-with-the-selected-model) beim ersten Request statt. Claude Code kann immer noch die [unrecognized-model-Diagnosezeile](/docs/de/errors#unrecognized-model-id-on-a-request) zur Request-Zeit auf jedem Anbieter schreiben.176Die Prüfung läuft nur auf der Anthropic API. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/docs/de/llm-gateway) oder einem benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, daher gibt Claude Code jede Zeichenkette ohne Prüfung durch. Die Prüfung deckt auch nicht das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable oder die `model`-Einstellung ab; ein Tippfehler dort erzeugt [There's an issue with the selected model](/docs/de/errors#theres-an-issue-with-the-selected-model) beim ersten Request statt. Claude Code kann immer noch die [unrecognized-model Diagnosezeile](/docs/de/errors#unrecognized-model-id-on-a-request) zur Request-Zeit auf jedem Anbieter schreiben.

171 177

172Wenn das angeforderte Modell ein geplantes Pensionierungsdatum hat oder automatisch zu einer neueren Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Start-Notiz. Ab v2.1.182 wird die gleiche Warnung im [nicht-interaktiven Modus](/docs/de/headless) bei Verwendung des Standard-Textausgabeformats auf stderr geschrieben. Die Prüfung deckt auch ein in [Subagent-Frontmatter](/docs/de/sub-agents) gesetztes `model` ab. Die stderr-Warnung wird für `--output-format json` und `stream-json` unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem Feld `modelUsage` der [Ergebnisnachricht](/docs/de/headless#get-structured-output).178Wenn das angeforderte Modell ein geplantes Ruhestandsdatum hat oder automatisch zu einer neueren Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Startnotiz. Ab v2.1.182 wird die gleiche Warnung in [nicht-interaktivem Modus](/docs/de/headless) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Prüfung deckt auch ein `model`, das in [Subagenten-Frontmatter](/docs/de/sub-agents) festgelegt ist. Die stderr-Warnung wird für `--output-format json` und `stream-json` unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem `modelUsage`-Feld der [Ergebnisnachricht](/docs/de/headless#get-structured-output).

173 179

174Beispiel: Starten Sie eine Sitzung auf Opus:180Beispiel: Starten Sie eine Sitzung auf Opus:

175 181

195```201```

196 202

197<h4 id="set-a-default-model-for-new-sessions">203<h4 id="set-a-default-model-for-new-sessions">

198 Einen Standard-Modell für neue Sitzungen setzen204 Einen Standardmodell für neue Sitzungen festlegen

199</h4>205</h4>

200 206

201Setzen Sie `ANTHROPIC_DEFAULT_MODEL=<alias|name>`, um das Modell auszuwählen, auf dem Ihre Sitzungen standardmäßig starten. Erfordert Claude Code v2.1.236 oder später.207Legen Sie `ANTHROPIC_DEFAULT_MODEL=<alias|name>` fest, um das Modell auszuwählen, auf dem Ihre Sitzungen standardmäßig starten. Erfordert Claude Code v2.1.236 oder später.

202 208

203Claude Code startet eine neue Sitzung auf dem Modell der Variablen nur, wenn keines dieser Modelle auswählt:209Claude Code startet eine neue Sitzung auf dem Modell der Variablen nur, wenn keines dieser Modelle auswählt:

204 210

205* Das Flag `--model`211* Das `--model`-Flag

206* `ANTHROPIC_MODEL`212* `ANTHROPIC_MODEL`

207* Ein `model`-Wert in einer beliebigen Einstellungsdatei, einschließlich der Auswahl, die Sie mit `/model` speichern213* Ein `model`-Wert in einer beliebigen Einstellungsdatei, einschließlich der Auswahl, die Sie mit `/model` speichern

208* Ein [Organisations-Standard-Modell](#organization-default-model)214* Ein [Organisationsstandardmodell](#organization-default-model)

209 215

210Eine Auswahl, die Sie mit `/model` speichern, hat auch bei späteren Starts Vorrang vor der Variablen. Mit stattdessen gesetztem `ANTHROPIC_MODEL` kehrt Claude Code beim nächsten Start zu dem Modell der Variablen zurück, unabhängig davon, was Sie mit `/model` gespeichert haben.216Eine Auswahl, die Sie mit `/model` speichern, hat auch bei späteren Starts Vorrang vor der Variablen. Mit `ANTHROPIC_MODEL` stattdessen gesetzt, kehrt Claude Code beim nächsten Start zu dem Modell dieser Variablen zurück, was auch immer Sie mit `/model` gespeichert haben.

211 217

212Claude Code löst auch die Option „Standard" zu dem Modell der Variablen auf, es sei denn, es gilt ein Organisations-Standard-Modell. Wenn die Option „Standard" zu dem Modell der Variablen aufgelöst wird, zeigt die Zeile „Standard" in der `/model`-Auswahl das Label „Set by ANTHROPIC\_DEFAULT\_MODEL".218Claude Code löst auch die Standard-Option zu dem Modell der Variablen auf, sofern kein Organisationsstandardmodell gilt. Wenn die Standard-Option zu dem Modell der Variablen aufgelöst wird, zeigt die Standard-Zeile in der `/model`-Auswahl das Label Set by ANTHROPIC\_DEFAULT\_MODEL.

213 219

214Claude Code ignoriert die Variable in diesen Fällen, und die Option „Standard" wird aufgelöst, als hätten Sie sie nicht gesetzt:220Claude Code ignoriert die Variable in diesen Fällen, und die Standard-Option wird aufgelöst, als hätten Sie sie nicht festgelegt:

215 221

216* Sie setzen sie auf `default`, `inherit`, `opusplan` oder `haiku`222* Sie legen sie auf `default`, `inherit`, `opusplan` oder `haiku` fest

217* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) ist aktiviert223* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) ist aktiviert

218* [`availableModels`](#restrict-model-selection) oder [Organisations-Modellbeschränkungen](#organization-model-restrictions) schließen das Modell aus224* Die [Modellbeschränkungen](#restrict-model-selection) Ihrer Organisation schließen das Modell aus

219* Das Modell ist nicht für Ihr Konto verfügbar225* Das Modell ist nicht für Ihr Konto verfügbar

220 226

221Wenn eine neue Sitzung auf dem Modell der Variablen starten würde, startet auch eine Sitzung, die Sie mit `claude --resume`, `--continue` oder der `/resume`-Auswahl fortsetzen, auf ihm. Claude Code stellt das in dem Transkript dieser Sitzung gespeicherte Modell nicht wieder her. Andernfalls verwendet Claude Code die Variable nicht, wenn Sie [eine Sitzung fortsetzen](#setting-your-model).227Wenn eine neue Sitzung auf dem Modell der Variablen starten würde, startet eine Sitzung, die Sie mit `claude --resume`, `--continue` oder der `/resume`-Auswahl fortsetzen, auch auf ihm. Claude Code stellt das in dem Transkript dieser Sitzung gespeicherte Modell nicht wieder her. Andernfalls verwendet Claude Code die Variable nicht, wenn Sie [eine Sitzung fortsetzen](#setting-your-model).

222 228

223<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">229<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

224 Eine neue Sitzung startet auf einem anderen Modell als Sie ausgewählt haben230 Eine neue Sitzung startet auf einem anderen Modell als Sie ausgewählt haben

227Wenn Sie ein Modell mit `/model` auswählen und Ihre nächste Sitzung auf etwas anderem startet, sind dies die üblichen Ursachen:233Wenn Sie ein Modell mit `/model` auswählen und Ihre nächste Sitzung auf etwas anderem startet, sind dies die üblichen Ursachen:

228 234

229* **Sie haben es für eine Sitzung ausgewählt.** Das Drücken von `s` in der Auswahl, das Starten mit `--model` und das Ausführen von `/model` im nicht-interaktiven Modus gelten alle für die aktuelle Sitzung und lassen Ihren gespeicherten Standard unverändert.235* **Sie haben es für eine Sitzung ausgewählt.** Das Drücken von `s` in der Auswahl, das Starten mit `--model` und das Ausführen von `/model` im nicht-interaktiven Modus gelten alle für die aktuelle Sitzung und lassen Ihren gespeicherten Standard unverändert.

230* **Etwas mit höherer Priorität setzt das Modell.** Ein `model`-Wert in Projekt- oder verwalteten Einstellungen, `ANTHROPIC_MODEL` in Ihrer Shell oder ein [Organisations-Standard](#organization-default-model), den Ihr Administrator gesetzt hat, um Benutzerauswahlen zu überschreiben, gilt wieder bei jedem Start. Ihre `/model`-Auswahl ist immer noch gespeichert; sie wird übertroffen. Wenn Projekt- oder verwaltete Einstellungen das Modell setzen, benennt der Start-Header die Datei.236* **Etwas mit höherer Priorität legt das Modell fest.** Ein `model`-Wert in Projekt- oder verwalteten Einstellungen, `ANTHROPIC_MODEL` in Ihrer Shell oder ein [Organisationsstandardmodell](#organization-default-model), das Ihr Administrator festgelegt hat, um Benutzerauswahlen zu überschreiben, gilt wieder bei jedem Start. Ihre `/model`-Auswahl wird immer noch gespeichert; sie wird übertroffen. Wenn Projekt- oder verwaltete Einstellungen das Modell festlegen, benennt der Startheader die Datei.

231* **Claude Code konnte Ihre Auswahl nicht speichern.** `/model` schreibt `model` zu `~/.claude/settings.json`. Wenn Sie nicht in diese Datei schreiben können, z. B. weil ein anderes Tool sie generiert oder mit einer schreibgeschützten Kopie verlinkt, dauert das Modell, das Sie ausgewählt haben, für die Sitzung an und der nächste Start liest den alten Wert. Setzen Sie `model` in dem Tool, das die Datei generiert, oder machen Sie die Datei beschreibbar. Siehe [A change you made in Claude Code is lost in new sessions](/docs/de/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).237* **Claude Code konnte Ihre Auswahl nicht speichern.** `/model` schreibt `model` zu `~/.claude/settings.json`. Wenn Sie nicht in diese Datei schreiben können, z. B. weil ein anderes Tool sie generiert oder mit einer schreibgeschützten Kopie verlinkt, dauert das Modell, das Sie ausgewählt haben, für die Sitzung und der nächste Start liest den alten Wert. Legen Sie `model` in dem Tool fest, das die Datei generiert, oder machen Sie die Datei beschreibbar. Siehe [A change you made in Claude Code is lost in new sessions](/docs/de/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

232* **Sie haben eine Sitzung fortgesetzt.** Eine Sitzung, die Sie mit `claude --resume` oder `--continue` fortsetzen, [behält normalerweise das Modell, das sie verwendete](#setting-your-model), anstatt Ihren aktuellen Standard.238* **Sie haben eine Sitzung fortgesetzt.** Eine Sitzung, die Sie mit `claude --resume` oder `--continue` fortsetzen, [behält normalerweise das Modell, das sie verwendete](#setting-your-model), anstatt Ihren aktuellen Standard.

233 239

234<h2 id="restrict-model-selection">240<h2 id="restrict-model-selection">

235 Modellauswahl einschränken241 Modellauswahl einschränken

236</h2>242</h2>

237 243

238Unternehmensadministratoren können `availableModels` in [verwalteten oder Richtlinieneinstellungen](/docs/de/managed-settings) verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Einträge entsprechen einer Modellfamilie wie `sonnet`, einem Versionspräfix wie `claude-sonnet-4-5` oder einer vollständigen Modell-ID wie `claude-sonnet-4-5-20250929`. Ein Versionspräfix entspricht auch späteren Modell-IDs, die es um ein weiteres Segment erweitern, sodass `claude-fable-5` sowohl Fable 5 als auch Fable 5.1 zulässt, während `claude-fable-5-1` nur Fable 5.1 zulässt.244Unternehmensadministratoren können `availableModels` in [verwalteten oder Richtlinieneinstellungen](/docs/de/managed-settings) verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Einträge entsprechen einer Modellfamilie wie `sonnet`, einem Versionspräfix wie `claude-sonnet-4-5` oder einer vollständigen Modell-ID wie `claude-sonnet-4-5-20250929`. Ein Versionspräfix entspricht auch späteren Modell-IDs, die es um ein weiteres Segment erweitern, sodass `claude-fable-5` sowohl Fable 5 als auch Fable 5.1 zulässt, während `claude-fable-5-1` nur Fable 5.1 zulässt. Um ein Modell zu blockieren, das die Liste zulässt, oder um jede Modell-ID in der Liste nur die Version zuzulassen, die sie benennt, siehe [Spezifische Modelle oder Versionen blockieren](#block-specific-models-or-versions).

239 245

240Auf Plattformen, die Claude Code einbetten und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete `availableModels`-Allowlist in Kraft bleibt, es sei denn, der Host stellt seine eigene bereit; [Ausnahmen von der Vorrangigkeit verwalteter Einstellungen](/docs/de/settings#exceptions-to-managed-settings-precedence) gibt an, welche Schlüssel und Variablen der Host überschreibt.246Auf Plattformen, die Claude Code einbetten und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) setzen, hat die Modellkonfiguration des Hosts Vorrang vor verwalteten Modelleinstellungen, während eine verwaltete `availableModels`-Allowlist in Kraft bleibt, es sei denn, der Host stellt seine eigene bereit; [Ausnahmen von der Vorrangigkeit verwalteter Einstellungen](/docs/de/settings#exceptions-to-managed-settings-precedence) gibt an, welche Schlüssel und Variablen der Host überschreibt.

241 247

291 297

293| :- | :- | :- | :- | :- | :- |299| :- | :- | :- | :- | :- | :- |

295| [MDM oder verwaltete Einstellungsdateien](/docs/de/managed-settings#delivery-mechanisms) | Erzwungen | Erzwungen | Nicht bereitgestellt in von Anthropic gehosteten Umgebungen; in [selbst gehosteten Umgebungen](/docs/de/self-hosted-environments) erzwungen aus dem Runner-Image gemäß [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) | Erzwungen | Erzwungen, wo bereitgestellt |301| [MDM oder verwaltete Einstellungsdateien](/docs/de/managed-settings#delivery-mechanisms) | Erzwungen | Erzwungen | Nicht bereitgestellt in von Anthropic gehosteten Umgebungen; in [selbst gehosteten Umgebungen](/docs/de/self-hosted-environments) erzwungen aus dem Runner-Image gemäß [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) | Erzwungen | Erzwungen, wo bereitgestellt |

296 302

297* Cloud-Sitzungen auf [Claude Code im Web](/docs/de/claude-code-on-the-web), einschließlich derjenigen, die Sie aus der Desktop-App starten, laufen standardmäßig auf von Anthropic verwalteten VMs: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Allowlist über server-verwaltete Einstellungen bereit. Sitzungen, die Ihre Organisation zu einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments) leitet, laufen auf Ihrem eigenen Compute und lesen auch die verwaltete Einstellungsdatei im Runner-Image. [Wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) gibt an, wann diese Datei gilt. Ein Modellwechsel in der Mitte einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Allowlist ausgeschlossen ist. Wenn die `availableModels`-Liste in Ihren server-verwalteten Einstellungen nicht leer ist, lehnt der Server eine Anfrage des Benutzers ab, eine Cloud-Sitzung auf einem Modell zu starten, das die Liste ausschließt.303* [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), einschließlich derjenigen, die Sie aus der Desktop-App starten, laufen standardmäßig auf von Anthropic verwalteten VMs: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Allowlist über server-verwaltete Einstellungen bereit. Sitzungen, die Ihre Organisation zu einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments) leitet, laufen auf Ihrem eigenen Compute und lesen auch die verwaltete Einstellungsdatei im Runner-Image. [Wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) gibt an, wann diese Datei gilt. Ein Modellwechsel in der Mitte einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Allowlist ausgeschlossen ist. Wenn die `availableModels`-Liste in Ihren server-verwalteten Einstellungen nicht leer ist, lehnt der Server eine Anfrage ab, eine Cloud-Sitzung auf claude.ai/code oder aus der Desktop-App auf einem Modell zu starten, das die Liste ausschließt.

304* [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen laufen in Cloud-Umgebungen, erhalten aber keine server-verwalteten Einstellungen; in einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments) lesen sie immer noch die verwaltete Einstellungsdatei im Runner-Image. Um das Modell für diese Sitzungen festzulegen, siehe [Modell für einen Bereich auswählen](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) im Claude Tag-Administratorhandbuch.

298* Cowork, die agentengesteuerte Arbeit-Registerkarte in der Claude Desktop-App, führt ihre Sitzungen auf Claude Code aus, erhält aber absichtlich keine server-verwalteten Einstellungen aus der Admin-Konsole von claude.ai. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung läuft; Remote-Cowork-Sitzungen laufen auf von Anthropic verwalteten VMs, wo eine auf dem Gerät bereitgestellte Datei nicht vorhanden ist.305* Cowork, die agentengesteuerte Arbeit-Registerkarte in der Claude Desktop-App, führt ihre Sitzungen auf Claude Code aus, erhält aber absichtlich keine server-verwalteten Einstellungen aus der Admin-Konsole von claude.ai. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung läuft; Remote-Cowork-Sitzungen laufen auf von Anthropic verwalteten VMs, wo eine auf dem Gerät bereitgestellte Datei nicht vorhanden ist.

299* Sitzungen auf [Drittanbieter-Providern](/docs/de/server-managed-settings#platform-availability) wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Claude Platform on AWS](/docs/de/claude-platform-on-aws) erhalten keine server-verwalteten Einstellungen, daher stellen Sie die Allowlist dort über MDM oder verwaltete Einstellungsdateien bereit.306* Sitzungen auf [Drittanbieter-Providern](/docs/de/server-managed-settings#platform-availability) wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Claude Platform on AWS](/docs/de/claude-platform-on-aws) erhalten keine server-verwalteten Einstellungen, daher stellen Sie die Allowlist dort über MDM oder verwaltete Einstellungsdateien bereit.

300* Server-verwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem [zulässigen Login oder Schlüssel](/docs/de/server-managed-settings#platform-availability) authentifiziert. Flotten, die Schlüssel nur über ein [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript generieren, sollten die Allowlist über MDM oder verwaltete Einstellungsdateien bereitstellen.307* Server-verwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem [zulässigen Login oder Schlüssel](/docs/de/server-managed-settings#platform-availability) authentifiziert. Flotten, die Schlüssel nur über ein [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript generieren, sollten die Allowlist über MDM oder verwaltete Einstellungsdateien bereitstellen.

305 Standardmodell-Verhalten312 Standardmodell-Verhalten

306</h3>313</h3>

307 314

308Für sich allein lässt `availableModels` die Option Standard auf dem [Laufzeit-Standard](#default-model-setting) des Systems für das Konto, bis Sie auch [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) setzen. Wenn dieser Standard ein Modell ist, das Sie einschränken möchten, setzen Sie auch `enforceAvailableModels`.315Mit dem Standard-Präfix-Matching lässt `availableModels` allein die Option Standard auf dem [Laufzeit-Standard](#default-model-setting) des Systems für das Konto, bis Sie auch [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) setzen. Wenn dieser Standard ein Modell ist, das Sie einschränken möchten, setzen Sie auch `enforceAvailableModels`, oder [blockieren Sie dieses Modell](#block-specific-models-or-versions).

309 316

310Ein leeres `availableModels`-Array aktiviert niemals die Erzwingung des Standardmodells: Mit `availableModels: []` werden benannte Modellauswahlen blockiert, aber das Standardmodell für den Kontotyp bleibt unabhängig von `enforceAvailableModels` nutzbar.317Mit `availableModels: []` werden benannte Modellauswahlen blockiert und `enforceAvailableModels` hat keine Auswirkung.

311 318

312<h3 id="enforce-the-allowlist-for-the-default-model">319<h3 id="enforce-the-allowlist-for-the-default-model">

313 Allowlist für das Standardmodell erzwingen320 Allowlist für das Standardmodell erzwingen

322}329}

323```330```

324 331

325Die Option Standard wird zu dem Kontotyp-Standard aufgelöst, oder zu dem [Organisationsstandardmodell](#organization-default-model), wenn ein Administrator eines gesetzt hat. Wenn dieses Modell nicht in der Allowlist ist, wird die Option Standard stattdessen zu dem ersten `availableModels`-Eintrag aufgelöst, der ein zulässiges, verfügbares Modell benennt, und die Zeile Standard der Auswahl `/model` zeigt dieses Modell. Dies gilt überall dort, wo der Standard erreicht wird: Sitzungsstart, Auswahl von Standard in `/model`, das Schlüsselwort `"default"` in [Fallback-Modellketten](#fallback-model-chains) und der Fallback, der verwendet wird, wenn eine ausgeschlossene Auswahl gelöscht wird.332Für ein Mitglied ohne Modell [auf ihrem Konto aufgezeichnet](#setting-your-model) wird die Option Standard zu dem Kontotyp-Standard aufgelöst, oder zu dem [Organisationsstandardmodell](#organization-default-model), wenn ein Administrator eines gesetzt hat. Wenn dieses Modell nicht in der Allowlist ist, wird die Option Standard stattdessen zu dem ersten `availableModels`-Eintrag aufgelöst, der ein zulässiges, verfügbares Modell benennt, und die Zeile Standard der Auswahl `/model` zeigt dieses Modell. Dies gilt überall dort, wo der Standard erreicht wird: Sitzungsstart, Auswahl von Standard in `/model`, das Schlüsselwort `"default"` in [Fallback-Modellketten](#fallback-model-chains) und der Fallback, der verwendet wird, wenn eine ausgeschlossene Auswahl gelöscht wird. Ein auf dem Konto eines Mitglieds aufgezeichnetes Modell wird auch gegen `availableModels` überprüft; [Einstellung Ihres Modells](#setting-your-model) beschreibt, wie die Option Standard es behandelt.

326 333

327`enforceAvailableModels` ordnet die Option Standard nur neu zu, wenn `availableModels` nicht leer ist. Mit `availableModels: []` bleibt das Standardmodell für den Kontotyp nutzbar, sodass die Einstellung Benutzer nicht von jedem Modell ausschließen kann. Wenn `availableModels` nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung übersprungen und Standard wird zu dem Kontotyp-Standard aufgelöst, mit einer Warnung, die nur unter `--debug` sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.334`enforceAvailableModels` ordnet die Option Standard nur neu zu, wenn `availableModels` nicht leer ist. Wenn `availableModels` nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung übersprungen und eine Warnung wird angezeigt, die nur unter `--debug` sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.

328 335

329Stellen Sie beide Schlüssel zusammen in der höchstrangigen verwalteten Quelle bereit, die Sie bereitstellen. Standardmäßig liest Claude Code nur diese Quelle, daher wird ein Paar, das in einer verwalteten Einstellungsdatei platziert ist, ignoriert, wenn die Admin-Konsole Einstellungen bereitstellt; unter dem Opt-in-Merge in [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) ignoriert Claude Code immer noch eine `modelOverrides`-Map aus einer Quelle, die unter der Quelle rangiert, die `availableModels` setzt.336Stellen Sie beide Schlüssel zusammen in der höchstrangigen verwalteten Quelle bereit, die Sie bereitstellen. Standardmäßig liest Claude Code nur diese Quelle, daher wird ein Paar, das in einer verwalteten Einstellungsdatei platziert ist, ignoriert, wenn die Admin-Konsole Einstellungen bereitstellt; unter dem Opt-in-Merge in [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) ignoriert Claude Code immer noch eine `modelOverrides`-Map aus einer Quelle, die unter der Quelle rangiert, die `availableModels` setzt.

330 337

332 Kontrollieren Sie das Modell, auf dem Benutzer laufen339 Kontrollieren Sie das Modell, auf dem Benutzer laufen

333</h3>340</h3>

334 341

335Die Einstellung `model` ist eine anfängliche Auswahl, keine Erzwingung. Sie legt fest, welches Modell aktiv ist, wenn eine Sitzung startet, aber Benutzer können immer noch `/model` öffnen und Standard auswählen, das zu dem [Laufzeit-Standard](#default-model-setting) des Systems aufgelöst wird, unabhängig davon, was `model` gesetzt ist, es sei denn, [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) leitet es um.342Die Einstellung `model` ist eine anfängliche Auswahl, keine Erzwingung. Sie legt fest, welches Modell aktiv ist, wenn eine Sitzung startet, aber Benutzer können immer noch `/model` öffnen und Standard auswählen, das zu dem [Laufzeit-Standard](#default-model-setting) des Systems aufgelöst wird, unabhängig davon, was `model` gesetzt ist, es sei denn, [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) oder die [Schlüssel, die spezifische Versionen blockieren](#block-specific-models-or-versions) wenden sich darauf an.

336 343

337Um die Modellerfahrung vollständig zu kontrollieren, kombinieren Sie diese Einstellungen:344Um die Modellerfahrung vollständig zu kontrollieren, kombinieren Sie diese Einstellungen:

338 345

339* **`availableModels`**: schränkt ein, welche benannten Modelle Benutzer wechseln können346* **`availableModels`**: schränkt ein, welche benannten Modelle Benutzer wechseln können

340* **`enforceAvailableModels`**: erweitert die `availableModels`-Allowlist auf die Option Standard, sodass Standard nicht zu einem Modell außerhalb der Liste aufgelöst werden kann347* **`enforceAvailableModels`**: erweitert die `availableModels`-Allowlist auf die Option Standard, sodass Standard nicht zu einem Modell außerhalb der Liste aufgelöst werden kann

348* **`deniedModels`** und **`availableModelsMatch`**: [blockieren Sie spezifische Versionen](#block-specific-models-or-versions), die ein `availableModels`-Eintrag sonst zulassen würde

341* **`model`**: legt die anfängliche Modellauswahl fest, wenn eine Sitzung startet349* **`model`**: legt die anfängliche Modellauswahl fest, wenn eine Sitzung startet

342* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: kontrollieren, zu welchen Modellen die Aliase `sonnet`, `opus`, `haiku` und `fable` aufgelöst werden, und welche Version der [Kontotyp-Standard](#default-model-setting) verwendet350* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: kontrollieren, zu welchen Modellen die Aliase `sonnet`, `opus`, `haiku` und `fable` aufgelöst werden, und welche Version der [Kontotyp-Standard](#default-model-setting) verwendet

343 351

370 378

371Wenn der [Amazon Bedrock Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) aktiviert ist, werden Einträge in `availableModels`, die mit `anthropic.` beginnen, als benutzerdefinierte Optionen zur Auswahl `/model` hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme von der Alias-Zuordnung, die in [Modelle für Drittanbieter-Bereitstellungen festlegen](#pin-models-for-third-party-deployments) beschrieben ist. Die Einstellung schränkt die Auswahl immer noch auf aufgelistete Einträge ein, und eine Mantle-ID bettet einen Familiennamen ein, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Neben allen Mantle-IDs listen Sie die Versionspräfixe oder vollständigen IDs auf, die Sie auswählbar behalten möchten. Siehe [Merge-Verhalten](#merge-behavior).379Wenn der [Amazon Bedrock Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) aktiviert ist, werden Einträge in `availableModels`, die mit `anthropic.` beginnen, als benutzerdefinierte Optionen zur Auswahl `/model` hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme von der Alias-Zuordnung, die in [Modelle für Drittanbieter-Bereitstellungen festlegen](#pin-models-for-third-party-deployments) beschrieben ist. Die Einstellung schränkt die Auswahl immer noch auf aufgelistete Einträge ein, und eine Mantle-ID bettet einen Familiennamen ein, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Neben allen Mantle-IDs listen Sie die Versionspräfixe oder vollständigen IDs auf, die Sie auswählbar behalten möchten. Siehe [Merge-Verhalten](#merge-behavior).

372 380

381<h3 id="block-specific-models-or-versions">

382 Spezifische Modelle oder Versionen blockieren

383</h3>

384

385Ein `availableModels`-Eintrag wie `claude-opus-5` zulässt auch spätere Versionen, die ihn erweitern, wie Opus 5.5, sobald Claude Code sie unterstützt. Zwei verwaltete Einstellungen ermöglichen es Ihnen, eine Veröffentlichung zurückzuhalten, und beide erfordern Claude Code v2.1.283 oder später:

386

387* [`deniedModels`](/docs/de/settings-reference#deniedmodels): listen Sie die zu blockierenden Modelle auf. Ein aufgelistetes Modell wird blockiert, auch wenn `availableModels` es zulässt, und der Schlüssel funktioniert auch ohne Allowlist. Eine Veröffentlichung, die kein Eintrag blockiert, bleibt zulässig

388* [`availableModelsMatch`](/docs/de/settings-reference#availablemodelsmatch): setzen Sie es auf `"exact"`, sodass jede Modell-ID in `availableModels` nur die Version zulässt, die sie benennt. Eine neuere Version einer aufgelisteten Modell-ID bleibt dann blockiert, bis Sie sie zur Liste hinzufügen

389

390Frühere Versionen ignorieren beide Schlüssel, daher setzen Sie auch [`requiredMinimumVersion`](/docs/de/settings-reference#requiredminimumversion), um zu verhindern, dass diese Versionen starten.

391

392Dieses Beispiel zulässt Opus- und Sonnet-Modelle und blockiert Opus 5.5 in jeder Schreibweise, einschließlich datierter und Provider-spezifischer IDs:

393

394```json theme={null}

395{

396 "availableModels": ["opus", "sonnet"],

397 "deniedModels": ["claude-opus-5-5"]

398}

399```

400

401Ein blockiertes Modell, ob `deniedModels` es benennt oder eine `"exact"`-Liste es auslässt, wird überall dort als blockierte Auswahl behandelt, wo [die Allowlist gilt](#restrict-model-selection). Es ist in der Auswahl `/model` verborgen, und `/model <name>` lehnt es ab. Wenn Sie eine blockierte Modell-ID mit `--model`, `ANTHROPIC_MODEL` oder der Einstellung `model` benennen, löscht Claude Code sie beim Start und löst stattdessen die Option Standard auf. Wenn ein [Hook](/docs/de/hooks) oder eine Hintergrundanfrage ein Modell benennt, das `deniedModels` blockiert, wie das Feld `model` eines Agent-Hooks, wird diese Anfrage stattdessen auf dem Sitzungsmodell ausgeführt.

402

403Die Option Standard folgt beiden Schlüsseln auch, unabhängig davon, ob Sie [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) setzen. Wenn Sie es mit einem nicht leeren `availableModels` setzen, zählt ein blockierter Standard als ein Modell außerhalb der Allowlist. Andernfalls wird eine Option Standard, die zu einem blockierten Modell aufgelöst würde, in dieser Reihenfolge herabgestuft:

404

4051. Die neueste zulässige Version der gleichen Familie

4062. Das neueste zulässige Modell jeder Familie mit niedrigeren Kosten der Reihe nach: Sonnet, dann Haiku

4073. Der erste `availableModels`-Eintrag, der ein zulässiges Modell benennt

408

409Wenn keines davon zulässig ist, [weigert sich eine Sitzung, die auf der Option Standard startet](/docs/de/errors#managed-settings-block-the-default-model), mit einem Fehler zu starten, der den zu behebenden Schlüssel benennt. Eine `"exact"`-Liste wirkt sich auf die Option Standard nur aus, wenn die verwaltete `availableModels`-Liste mindestens ein Modell oder eine Familie benennt.

410

411Claude Code liest beide Schlüssel nur aus verwalteten Einstellungen. Wenn Sie einen davon in Benutzer-, Projekt- oder lokalen Einstellungen oder mit `--settings` setzen, ignoriert Claude Code ihn mit einer Warnung.

412

373<h3 id="organization-model-restrictions">413<h3 id="organization-model-restrictions">

374 Organisationsmodellbeschränkungen414 Organisationsmodellbeschränkungen

375</h3>415</h3>

419 459

420* [`availableModels`](#restrict-model-selection) allein gilt nicht für das Organisationsstandardmodell, daher wird ein Organisationsstandardmodell außerhalb der Zulassungsliste trotzdem angewendet. Wenn auch [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) festgelegt ist, wird ein Organisationsstandardmodell außerhalb der Zulassungsliste wie jedes andere Standardmodell zum ersten Eintrag der Zulassungsliste neu zugeordnet460* [`availableModels`](#restrict-model-selection) allein gilt nicht für das Organisationsstandardmodell, daher wird ein Organisationsstandardmodell außerhalb der Zulassungsliste trotzdem angewendet. Wenn auch [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) festgelegt ist, wird ein Organisationsstandardmodell außerhalb der Zulassungsliste wie jedes andere Standardmodell zum ersten Eintrag der Zulassungsliste neu zugeordnet

421* ein Organisationsstandardmodell, das [Organisationsmodellbeschränkungen](#organization-model-restrictions) für Ihr Konto verweigern, wird durch das neueste zulässige Modell in seiner Familie ersetzt, oder durch eine kostengünstigere Familie, wenn jede Version davon eingeschränkt ist461* ein Organisationsstandardmodell, das [Organisationsmodellbeschränkungen](#organization-model-restrictions) für Ihr Konto verweigern, wird durch das neueste zulässige Modell in seiner Familie ersetzt, oder durch eine kostengünstigere Familie, wenn jede Version davon eingeschränkt ist

462* für ein Organisationsstandardmodell, das `deniedModels` oder eine `"exact"`-Liste blockiert, siehe [Spezifische Modelle oder Versionen blockieren](#block-specific-models-or-versions)

422* ein Organisationsstandardmodell, das für Ihr Konto überhaupt nicht verfügbar ist, wird übersprungen, und die Option „Standard" wird aufgelöst, wie es [ohne ein Organisationsstandardmodell](#default-model-setting) der Fall wäre463* ein Organisationsstandardmodell, das für Ihr Konto überhaupt nicht verfügbar ist, wird übersprungen, und die Option „Standard" wird aufgelöst, wie es [ohne ein Organisationsstandardmodell](#default-model-setting) der Fall wäre

423 464

424Ab v2.1.199 behält die `/model`-Auswahl eine separate Zeile für die übliche Familie bei, wenn das Organisationsstandardmodell eine andere Modellfamilie ist als die übliche Standard des Kontotyps, sodass Sie für eine Sitzung trotzdem zu ihr wechseln können. In v2.1.196 bis v2.1.198 fehlt diese Zeile in der Auswahl.465Ab v2.1.199 behält die `/model`-Auswahl eine separate Zeile für die übliche Familie bei, wenn das Organisationsstandardmodell eine andere Modellfamilie ist als die übliche Standard des Kontotyps, sodass Sie für eine Sitzung trotzdem zu ihr wechseln können. In v2.1.196 bis v2.1.198 fehlt diese Zeile in der Auswahl.

451 492

452Vor v2.1.280 wurde `default` auf Pro und Team Standard zu Sonnet 5 aufgelöst und auf Max, Team Premium, Enterprise, der Anthropic API, Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.219 zu Opus 5. Vor v2.1.219 wurde `default` auf der Anthropic API zu Opus 4.8 aufgelöst, auf Max, Team Premium und Enterprise Pay-as-you-go ab v2.1.154 und auf Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.207. Vor v2.1.207 wurde `default` auf Claude Platform auf AWS zu Opus 4.7 aufgelöst und auf Amazon Bedrock und Google Cloud's Agent Platform zu Sonnet 4.5.493Vor v2.1.280 wurde `default` auf Pro und Team Standard zu Sonnet 5 aufgelöst und auf Max, Team Premium, Enterprise, der Anthropic API, Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.219 zu Opus 5. Vor v2.1.219 wurde `default` auf der Anthropic API zu Opus 4.8 aufgelöst, auf Max, Team Premium und Enterprise Pay-as-you-go ab v2.1.154 und auf Claude Platform auf AWS, Amazon Bedrock und Google Cloud's Agent Platform ab v2.1.207. Vor v2.1.207 wurde `default` auf Claude Platform auf AWS zu Opus 4.7 aufgelöst und auf Amazon Bedrock und Google Cloud's Agent Platform zu Sonnet 4.5.

453 494

454Wenn ein Administrator ein [Organisationsstandardmodell](#organization-default-model) festgelegt hat, wird `default` stattdessen zu diesem Modell aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Erfordert Claude Code v2.1.196 oder später. `default` kann auch zu dem Modell aufgelöst werden, das Sie mit [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) festlegen, unter den in dessen Abschnitt aufgelisteten Bedingungen.495Wenn ein Administrator ein [Organisationsstandardmodell](#organization-default-model) festgelegt hat, wird `default` stattdessen zu diesem Modell aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Erfordert Claude Code v2.1.196 oder später. `default` kann auch zu dem Modell aufgelöst werden, das Sie mit [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) festlegen, unter den in dessen Abschnitt aufgelisteten Bedingungen, oder zu dem Modell, das [auf Ihrem Konto aufgezeichnet ist](#setting-your-model).

455 496

456Wenn verwaltete Einstellungen [die Zulassungsliste für das Standardmodell erzwingen](#enforce-the-allowlist-for-the-default-model) und der Kontotyp-Standard nicht in `availableModels` enthalten ist, wird `default` zum erzwungenen Standard aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Wenn beide zutreffen, ersetzt der Organisationsstandard zuerst den Kontotyp-Standard und die Erzwingung wird dann darauf angewendet: Ein auf der Zulassungsliste befindlicher Organisationsstandard wird beibehalten, während einer außerhalb der Liste zum erzwungenen Standard aufgelöst wird.497Wenn auf Ihrem Konto nichts aufgezeichnet ist, erzwingen verwaltete Einstellungen [die Zulassungsliste für das Standardmodell](#enforce-the-allowlist-for-the-default-model), und der Kontotyp-Standard ist nicht in `availableModels` enthalten, wird `default` zum erzwungenen Standard aufgelöst, anstatt zum oben genannten Kontotyp-Standard. Wenn ein Organisationsstandard und eine Erzwingung beide zutreffen, ersetzt der Organisationsstandard zuerst den Kontotyp-Standard und die Erzwingung wird dann darauf angewendet: Ein auf der Zulassungsliste befindlicher Organisationsstandard wird beibehalten, während einer außerhalb der Liste zum erzwungenen Standard aufgelöst wird.

457 498

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

459 500

513 Automatisches Modell-Fallback554 Automatisches Modell-Fallback

514</h3>555</h3>

515 556

516Dieser Abschnitt behandelt inhaltsbasiertes Fallback von Fable-Modellen, Opus 5.5 und Opus 5. Für verfügbarkeitsbasiertes Fallback, wenn ein Modell überlastet oder nicht verfügbar ist, siehe [Fallback-Modellketten](#fallback-model-chains).557Dieser Abschnitt behandelt inhaltsbasiertes Fallback von Fable-Modellen, Opus 5.5, Sonnet 5.5 und Opus 5. Für verfügbarkeitsbasiertes Fallback, wenn ein Modell überlastet oder nicht verfügbar ist, siehe [Fallback-Modellketten](#fallback-model-chains).

517 558

518Fable-Modelle, Opus 5.5 und Opus 5 werden mit Sicherheitsklassifizierern ausgeführt, die am häufigsten Cybersicherheits- und Biologie-Inhalte kennzeichnen. Wenn ein Klassifizierer eine Anfrage kennzeichnet und die gekennzeichnete Kategorie ein Fallback-Modell hat, führt Claude Code die Anfrage auf diesem Modell erneut aus und zeigt eine Benachrichtigung im Transkript an. Für diese beiden Kategorien hängt das Fallback-Modell davon ab, welches Modell abgelehnt hat:559Fable-Modelle, Opus 5.5, Sonnet 5.5 und Opus 5 werden mit Sicherheitsklassifizierern ausgeführt, die am häufigsten Cybersicherheits- und Biologie-Inhalte kennzeichnen. Wenn ein Klassifizierer eine Anfrage kennzeichnet und die gekennzeichnete Kategorie ein Fallback-Modell hat, führt Claude Code die Anfrage auf diesem Modell erneut aus und zeigt eine Benachrichtigung im Transkript an. Für diese beiden Kategorien hängt das Fallback-Modell davon ab, welches Modell abgelehnt hat:

519 560

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

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

521* **Opus 5**: Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Opus 5 seine eigenen Biologie-Klassifizierer mit keinem Fallback-Modell ausführt.563* **Opus 5**: Cybersicherheits-gekennzeichnete Anfragen werden auf Opus 4.8 erneut ausgeführt. Biologie-gekennzeichnete Anfragen enden stattdessen mit einer Ablehnung, da Opus 5 seine eigenen Biologie-Klassifizierer mit keinem Fallback-Modell ausführt.

522 564

523Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry löst Claude Code diese Ziele stattdessen durch Ihre Bereitstellung auf, und wenn Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` setzen, werden Kategorien, die ein Fallback haben, auf dem angehefteten Modell erneut ausgeführt; siehe [Fallback auf Bedrock, Agent Platform und Foundry aktivieren](#enable-fallback-on-bedrock-agent-platform-and-foundry).565Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry löst Claude Code diese Ziele stattdessen durch die Modell-IDs Ihrer Bereitstellung auf. Siehe [Fallback auf Bedrock, Agent Platform und Foundry aktivieren](#enable-fallback-on-bedrock-agent-platform-and-foundry).

524 566

525Nach einem Fallback wird die Sitzung auf dem Fallback-Modell fortgesetzt. Um zu Ihrem ursprünglichen Modell zurückzukehren, führen Sie [`/model`](#setting-your-model) aus.567Nach einem Fallback wird die Sitzung auf dem Fallback-Modell fortgesetzt. Um zu Ihrem ursprünglichen Modell zurückzukehren, führen Sie [`/model`](#setting-your-model) aus.

526 568

544 586

545Einige Fälle verhalten sich anders:587Einige Fälle verhalten sich anders:

546 588

547* Wenn die gekennzeichnete Kategorie kein Fallback-Modell hat, wie eine Biologie-Kennzeichnung auf Opus 5, zeigt Claude Code die Eingabeaufforderung nicht an und die Anfrage endet mit der Ablehnung.589* Wenn die gekennzeichnete Kategorie kein Fallback-Modell hat, wie eine Biologie-Kennzeichnung auf Opus 5 oder Sonnet 5.5, zeigt Claude Code die Eingabeaufforderung nicht an und die Anfrage endet mit der Ablehnung.

548* Wenn beide Modelle die gleiche Anfrage kennzeichnen, können Sie die Eingabeaufforderung bearbeiten und erneut versuchen oder eine neue Sitzung starten.590* Wenn beide Modelle die gleiche Anfrage kennzeichnen, können Sie die Eingabeaufforderung bearbeiten und erneut versuchen oder eine neue Sitzung starten.

549* Auf mobilen [Claude Code im Web](/docs/de/claude-code-on-the-web) Sitzungen wird das Bearbeiten und erneute Versuchen nicht unterstützt. Wechseln Sie Modelle oder setzen Sie die Sitzung in einem Desktop-Browser oder der Desktop-App fort.591* Auf mobilen [Claude Code im Web](/docs/de/claude-code-on-the-web) Sitzungen wird das Bearbeiten und erneute Versuchen nicht unterstützt. Wechseln Sie Modelle oder setzen Sie die Sitzung in einem Desktop-Browser oder der Desktop-App fort.

550* Im [nicht-interaktiven Modus](/docs/de/cli-reference#cli-flags) und SDK-Integrationen, die die Eingabeaufforderung nicht anzeigen können, endet eine gekennzeichnete Anfrage den Zug mit einer Ablehnung.592* Im [nicht-interaktiven Modus](/docs/de/cli-reference#cli-flags) und SDK-Integrationen, die die Eingabeaufforderung nicht anzeigen können, endet eine gekennzeichnete Anfrage den Zug mit einer Ablehnung.

556 598

557Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) sind Modell-IDs Provider-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:599Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) sind Modell-IDs Provider-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:

558 600

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

560* Das Fallback-Modell muss in Ihrer Bereitstellung aufgelöst werden. Wenn Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` setzen, werden gekennzeichnete Anfragen für jede Kategorie, die ein Fallback hat, auf diesem Modell erneut ausgeführt; eine Biologie-Kennzeichnung auf Opus 5 endet immer noch mit einer Ablehnung. Wenn Sie es nicht setzen, werden Cybersicherheits-gekennzeichnete Anfragen auf einem Opus 4.8-Eintrag in der Modelliste des Providers erneut ausgeführt, und Biologie-gekennzeichnete Anfragen von einem Fable-Modell oder Opus 5.5 auf einem Opus 5-Eintrag.602* Ein Opus-Ziel muss in Ihrer Bereitstellung aufgelöst werden, unabhängig davon, welches Modell abgelehnt hat: setzen Sie `ANTHROPIC_DEFAULT_OPUS_MODEL`, oder behalten Sie einen Opus 4.8-Eintrag in der Modelliste des Providers. Ohne einen wird Fallback für jedes Quellmodell ausgeschaltet, einschließlich Sonnet 5.5, und gekennzeichnete Anfragen enden mit einer Ablehnung.

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

604

605Wenn eines der Modelle nicht identifiziert werden kann, wechselt Claude Code nicht automatisch. Die gekennzeichnete Anfrage endet mit einer Ablehnungsmeldung, und Sie können Modelle mit [`/model`](#setting-your-model) wechseln und erneut versuchen. Um beide Modelle identifizierbar zu machen, setzen Sie die Angeheftungen für Ihr Quellmodell:

561 606

562Wenn eines der Modelle nicht identifiziert werden kann, wechselt Claude Code nicht automatisch. Die gekennzeichnete Anfrage endet mit einer Ablehnungsmeldung, und Sie können Modelle mit [`/model`](#setting-your-model) wechseln und erneut versuchen. Das Setzen von `ANTHROPIC_DEFAULT_FABLE_MODEL` auf Ihre Fable-Modell-ID ermöglicht die Fable-Erkennung. Das Setzen von `ANTHROPIC_DEFAULT_OPUS_MODEL` auf eine Opus-Modell-ID gibt den gekennzeichneten Kategorien ein Fallback-Ziel, es sei denn, die Angeheftung benennt ein Modell außerhalb der Opus-Familie oder das Modell, das abgelehnt hat; dann wechselt Claude Code nicht und die Ablehnung bleibt bestehen.607* **Fable-Modelle**: setzen Sie `ANTHROPIC_DEFAULT_FABLE_MODEL` auf Ihre Fable-Modell-ID, damit Claude Code sie als Fallback-Quelle erkennt.

608* **Jedes Quellmodell**: setzen Sie `ANTHROPIC_DEFAULT_OPUS_MODEL` auf eine Opus-Modell-ID, um Fallback einzuschalten und den gekennzeichneten Kategorien ein Ziel zu geben. Eine Angeheftung, die ein Modell außerhalb der Opus-Familie benennt, oder das Modell, das abgelehnt hat, lässt die Ablehnung bestehen.

609* **Sonnet 5.5**: zusätzlich zur Opus-Angeheftung setzen Sie `ANTHROPIC_DEFAULT_SONNET_MODEL` oder behalten Sie einen Sonnet 5-Eintrag in der Modelliste des Providers, um das Modell bereitzustellen, auf dem die Anfrage erneut ausgeführt wird. Eine Sonnet-Angeheftung, die ein Modell außerhalb der Sonnet-Familie benennt, oder Sonnet 5.5 selbst, lässt die Ablehnung bestehen.

563 610

564<h4 id="security-research-and-biology-workloads">611<h4 id="security-research-and-biology-workloads">

565 Sicherheitsforschung und Biologie-Workloads612 Sicherheitsforschung und Biologie-Workloads

566</h4>613</h4>

567 614

568Workloads in offensiver Sicherheit oder Biologie, einschließlich Penetrationstests, Capture the Flag (CTF) Übungen und Biologie-nahe Codebases, lösen häufig Fallback aus, oft bei der ersten Anfrage. Für substantive Biologie-Arbeit auf Fable 5.1, Fable 5 oder Opus 5.5 verschiebt Claude Code die Sitzung bei der ersten gekennzeichneten Anfrage zu Opus 5, und später Biologie-gekennzeichnete Anfragen enden dort in Ablehnungen, da Opus 5 kein Biologie-Fallback hat. Auf Opus 5 erhalten Sie diese Ablehnungen von der ersten gekennzeichneten Anfrage an.615Workloads in offensiver Sicherheit oder Biologie, einschließlich Penetrationstests, Capture the Flag (CTF) Übungen und Biologie-nahe Codebases, lösen häufig Fallback aus, oft bei der ersten Anfrage. Für substantive Biologie-Arbeit auf Fable 5.1, Fable 5 oder Opus 5.5 verschiebt Claude Code die Sitzung bei der ersten gekennzeichneten Anfrage zu Opus 5, und später Biologie-gekennzeichnete Anfragen enden dort in Ablehnungen, da Opus 5 kein Biologie-Fallback hat. Auf Opus 5 und Sonnet 5.5 erhalten Sie diese Ablehnungen von der ersten gekennzeichneten Anfrage an.

569 616

570Dies ist erwartetes Routing für diese Domänen, keine Kontoflagge. Wenn Ihre Organisation Fable-Klasse-Fähigkeit für diese Arbeit benötigt, wenden Sie sich an Ihr Anthropic-Kontoteam bezüglich vertrauenswürdiger Zugriffsprogramme.617Dies ist erwartetes Routing für diese Domänen, keine Kontoflagge. Wenn Ihre Organisation Fable-Klasse-Fähigkeit für diese Arbeit benötigt, wenden Sie sich an Ihr Anthropic-Kontoteam bezüglich vertrauenswürdiger Zugriffsprogramme.

571 618

580| Modell | Stufen |627| Modell | Stufen |

581| :- | :- |628| :- | :- |

585 632

586Wenn Sie eine Stufe setzen, die das aktive Modell nicht unterstützt, fällt Claude Code auf die höchste unterstützte Stufe bei oder unter der von Ihnen gesetzten zurück. Zum Beispiel wird `xhigh` auf Opus 4.6 als `high` ausgeführt. Ihre Organisation oder Ihre eigenen Einstellungen können auch begrenzen, welche Stufen ein Modell anbietet; siehe [Organisationsanstrengungsgrenzen](#organization-effort-limits).633Wenn Sie eine Stufe setzen, die das aktive Modell nicht unterstützt, fällt Claude Code auf die höchste unterstützte Stufe bei oder unter der von Ihnen gesetzten zurück. Zum Beispiel wird `xhigh` auf Opus 4.6 als `high` ausgeführt. Ihre Organisation oder Ihre eigenen Einstellungen können auch begrenzen, welche Stufen ein Modell anbietet; siehe [Organisationsanstrengungsgrenzen](#organization-effort-limits).

587 634

588Mit der [`ultracode`](/docs/de/settings-reference#ultracode) Einstellung aus löst Claude Code die Anstrengungsstufe der Sitzung in dieser Reihenfolge auf und nimmt die erste, die zutrifft:635Claude Code löst die Anstrengungsstufe der Sitzung in dieser Reihenfolge auf und nimmt die erste, die zutrifft:

589 636

5901. Eine explizite Wahl: die [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars#variables) Umgebungsvariable, Start mit `--effort` oder `/effort` in der Sitzung ([ein nicht-interaktives `/effort` hat engere Auswirkungen](#non-interactive-effort))6371. Eine explizite Wahl: die [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars#variables) Umgebungsvariable, Start mit `--effort` oder `/effort` in der Sitzung ([ein nicht-interaktives `/effort` hat engere Auswirkungen](#non-interactive-effort))

5912. Ihre Einstellungen: die Stufe, die Sie für das Modell gespeichert haben, oder ein [`effortLevel`](/docs/de/settings-reference#effortlevel) Schlüssel, mit der Vorrangigkeit zwischen ihnen und über Einstellungsdateien hinweg, die unter [`modelSettings`](/docs/de/settings-reference#modelsettings) angegeben ist6382. Ihre Einstellungen: die Stufe, die Sie für das Modell gespeichert haben, oder ein [`effortLevel`](/docs/de/settings-reference#effortlevel) Schlüssel, mit der Vorrangigkeit zwischen ihnen und über Einstellungsdateien hinweg, die unter [`modelSettings`](/docs/de/settings-reference#modelsettings) angegeben ist

5923. Die Standard-Anstrengung des Modells: `high` auf jedem Modell, das Anstrengung unterstützt, außer dass Opus 5.5 auf `medium` standardmäßig ist, Opus 4.7 auf `xhigh` standardmäßig ist und, wenn Ihre Organisation eine Standard-Anstrengungsstufe für sein [Organisationsstandardmodell](#organization-default-model) setzt, diese Stufe der Standard ist, wenn Sie dieses Modell ausführen6393. Die Standard-Anstrengung des Modells: `high` auf jedem Modell, das Anstrengung unterstützt, außer dass Opus 5.5 und Sonnet 5.5 auf `medium` standardmäßig sind, Opus 4.7 auf `xhigh` standardmäßig ist und, wenn Ihre Organisation eine Standard-Anstrengungsstufe für sein [Organisationsstandardmodell](#organization-default-model) setzt, diese Stufe der Standard ist, wenn Sie dieses Modell ausführen

593 640

594Opus 5.5 startet bei `medium`, es sei denn, eine der oben genannten Quellen setzt eine Stufe dafür, und ein Top-Level `effortLevel` in Ihrer Benutzereinstellungsdatei zählt nicht für Opus 5.5. Dieser Schlüssel ist die ältere Form, die `/effort` vor Claude Code schrieb, das Stufen pro Modell speicherte: er wird weiterhin angewendet, wo er zuvor angewendet wurde, auf Opus 5, Fable 5.1 und frühere Modelle, während Opus 5.5 und Modelle, die nach ihm veröffentlicht wurden, bei ihrem eigenen Standard starten, bis Sie eine Stufe dafür mit `/effort` oder dem `/model` Picker wählen. Ein Top-Level `effortLevel` in Projekt-, Lokal- oder verwalteten Einstellungen oder einer, die mit `--settings` übergeben wird, gilt für jedes Modell.641Opus 5.5 startet bei `medium`, es sei denn, eine der oben genannten Quellen setzt eine Stufe dafür, und ein Top-Level `effortLevel` in Ihrer Benutzereinstellungsdatei zählt nicht für Opus 5.5. Dieser Schlüssel ist die ältere Form, die `/effort` vor Claude Code schrieb, das Stufen pro Modell speicherte: er wird weiterhin angewendet, wo er zuvor angewendet wurde, auf Opus 5, Fable 5.1 und frühere Modelle, während Opus 5.5 und Modelle, die nach ihm veröffentlicht wurden, bei ihrem eigenen Standard starten, bis Sie eine Stufe dafür mit `/effort` oder dem `/model` Picker wählen. Ein Top-Level `effortLevel` in Projekt-, Lokal- oder verwalteten Einstellungen oder einer, die mit `--settings` übergeben wird, gilt für jedes Modell.

595 642

610 657

611Wenn Sie eine Stufe mit `/effort` in einer [`-p` Ausführung](/docs/de/headless) setzen, wendet Claude Code sie nur auf diese Sitzung an und speichert sie nicht als Ihren Standard.658Wenn Sie eine Stufe mit `/effort` in einer [`-p` Ausführung](/docs/de/headless) setzen, wendet Claude Code sie nur auf diese Sitzung an und speichert sie nicht als Ihren Standard.

612 659

613Das `/effort` Menü bietet auch `ultracode`. Ultracode ist eine Claude Code-Einstellung statt einer Modell-Anstrengungsstufe: es sendet `xhigh` an das Modell und hat zusätzlich Claude, um [dynamische Workflows](/docs/de/workflows) für substantive Aufgaben zu orchestrieren. Für wo es persistent gesetzt werden kann, siehe die [`ultracode`](/docs/de/settings-reference#ultracode) Einstellung.660Das `/effort` Menü bietet auch einen **Ultracode** Umschalter. Ultracode ist eine Claude Code-Einstellung statt einer Modell-Anstrengungsstufe: mit ihm an orchestriert Claude [dynamische Workflows](/docs/de/workflows) für substantive Aufgaben, auf welcher Anstrengungsstufe auch immer die Sitzung läuft. Für wo es persistent gesetzt werden kann, siehe die [`ultracode`](/docs/de/settings-reference#ultracode) Einstellung.

661

662Das Einschalten oder Ausschalten von Ultracode mit `/effort` oder der `ultracode` Einstellung lässt die Anstrengungsstufe unverändert. Das `--effort ultracode` Flag und der Agent SDK `effortLevel: "ultracode"` Wert schalten es an und setzen auch die Stufe auf `xhigh`. Das Auswählen einer Stufe im `/effort` Schieber oder dem `/model` Picker lässt Ultracode so, wie es war.

614 663

615Sie können Ultracode durch eine der folgenden Methoden aktivieren:664Sie können Ultracode durch eine der folgenden Methoden aktivieren:

616 665

617* **`/effort`**: führen Sie `/effort ultracode` aus oder wählen Sie es aus dem Menü666* **`/effort`**: führen Sie `/effort ultracode` aus, um es für die aktuelle Sitzung einzuschalten, oder `/effort ultracode off`, um es auszuschalten. Im `/effort` Schieber drücken Sie `Tab`, um den **Ultracode** Umschalter umzuschalten, dann `Enter`, um es anzuwenden

618* **`--effort` Flag**: starten Sie mit `claude --effort ultracode`, das die Sitzung mit `xhigh` Anstrengung und Ultracode an startet667* **`--effort` Flag**: starten Sie mit `claude --effort ultracode`, das die Sitzung mit `xhigh` Anstrengung und Ultracode an startet

619* **`ultracode` Einstellung**: setzen Sie [`"ultracode": true`](/docs/de/settings-reference#ultracode) in einer Einstellungsdatei, mit `--settings` oder in einer Agent SDK-Steueranfrage. Eine [`applyFlagSettings()`](/docs/de/agent-sdk/typescript#applyflagsettings) Anfrage akzeptiert auch `effortLevel: "ultracode"`668* **`ultracode` Einstellung**: setzen Sie [`"ultracode": true`](/docs/de/settings-reference#ultracode) in einer Einstellungsdatei, mit `--settings` oder in einer Agent SDK-Steueranfrage. Eine [`applyFlagSettings()`](/docs/de/agent-sdk/typescript#applyflagsettings) Anfrage akzeptiert auch `effortLevel: "ultracode"`, das es anschaltet und die Anstrengungsstufe auf `xhigh` setzt

620* **`/model` Picker**: bewegen Sie den Anstrengungsschieber mit den Pfeiltasten zu `ultracode`, während Sie ein Modell auswählen. Claude Code schaltet es für die aktuelle Sitzung ein, auch wenn Sie dieses Modell als Ihren Standard speichern669

670Das `/effort ultracode off` Formular, der Schieber-Umschalter und das Halten von Ultracode an Anstrengungsstufen außer `xhigh` erfordern Claude Code v2.1.284 oder später. Vor v2.1.284 setzte das Einschalten von Ultracode die Sitzung auf `xhigh` Anstrengung, das Auswählen einer anderen Stufe schaltete es aus, und eine Anstrengungsgrenze unter `xhigh` machte es nicht verfügbar.

621 671

622Das Übergeben von `ultracode` an das `--effort` Flag oder den Agent SDK `effortLevel` Wert erfordert Claude Code v2.1.203 oder später. Vor v2.1.203 druckte `--effort ultracode` `Unknown --effort value 'ultracode'` und die Sitzung startete mit der Standard-Anstrengung.672Das Übergeben von `ultracode` an das `--effort` Flag oder den Agent SDK `effortLevel` Wert erfordert Claude Code v2.1.203 oder später. Vor v2.1.203 druckte `--effort ultracode` `Unknown --effort value 'ultracode'` und die Sitzung startete mit der Standard-Anstrengung.

623 673

624Die persistierte `effortLevel` Einstellung und die `CLAUDE_CODE_EFFORT_LEVEL` Umgebungsvariable akzeptieren nicht `ultracode`. Wenn `CLAUDE_CODE_EFFORT_LEVEL` auf eine andere Stufe als `xhigh` gesetzt ist, werden Anfragen auf dieser Stufe ausgeführt und die Workflow-Orchestrierung von Ultracode bleibt inaktiv. Das Auswählen von Ultracode zeigt dann eine Warnung an, dass die Umgebungsvariable die Anstrengung für die Sitzung überschreibt.674Die persistierte `effortLevel` Einstellung und die `CLAUDE_CODE_EFFORT_LEVEL` Umgebungsvariable akzeptieren nicht `ultracode`. Wenn `CLAUDE_CODE_EFFORT_LEVEL` oder eine [Anstrengungsgrenze](#organization-effort-limits) die Sitzungsstufe setzt, bleibt Ultracode an dieser Stufe an.

625 675

626<span id="when-ultracode-is-available" />676<span id="when-ultracode-is-available" />

627 677

629 679

630* [Workflows sind ausgeschaltet](/docs/de/workflows#turn-workflows-off)680* [Workflows sind ausgeschaltet](/docs/de/workflows#turn-workflows-off)

631* Das Modell unterstützt `xhigh` Anstrengung nicht681* Das Modell unterstützt `xhigh` Anstrengung nicht

632* Eine [Anstrengungsgrenze](#organization-effort-limits) unter `xhigh` gilt für das Modell

633 682

634In diesen Fällen startet `--effort ultracode` die Sitzung mit Ultracode aus, auf der höchsten Anstrengungsstufe, die das Modell und jede Grenze zulassen, bis zu `xhigh`.683In diesen Fällen startet `--effort ultracode` die Sitzung mit Ultracode aus, auf der höchsten Anstrengungsstufe, die das Modell und jede Grenze zulassen, bis zu `xhigh`.

635 684

641 690

642| Stufe | Wann man sie verwendet |691| Stufe | Wann man sie verwendet |

643| :- | :- |692| :- | :- |

644| `low` | Reservieren Sie für kurze, begrenzte, latenzempfindliche Aufgaben, die nicht intelligenzempfindlich sind |693| `low` | Schnelle Austausche, bei denen Sie jedes Ergebnis überprüfen, wie Brainstorming, eine erste Skizze oder eine kleine Änderung wie eine Umbenennung |

645| `medium` | Reduziert die Token-Nutzung für kostensensitive Arbeit, die etwas Intelligenz opfern kann. Der Standard auf Opus 5.5 |694| `medium` | Der Standard auf Opus 5.5 und Sonnet 5.5, wo er zur alltäglichen Ingenieurarbeit mit klarem Umfang passt, wie die Implementierung einer neuen Funktion. Bei anderen Modellen reduziert die Token-Nutzung für kostensensitive Arbeit, die etwas Intelligenz opfern kann |

646| `high` | Balanciert Token-Nutzung und Intelligenz. Der Standard auf jedem Modell außer Opus 5.5 und Opus 4.7 |695| `high` | Arbeit, bei der Überprüfung wichtig ist oder Grenzfälle wahrscheinlich sind, wie das Beheben eines Fehlers in einer bestehenden Codebasis. Der Standard auf jedem Modell außer Opus 5.5, Sonnet 5.5 und Opus 4.7 |

648| `max` | Kann die Leistung bei anspruchsvollen Aufgaben verbessern, kann aber abnehmende Erträge zeigen und ist anfällig für Überdenken. Testen Sie vor breiter Übernahme |697| `max` | Schwierige Probleme, die Sie Claude ohne Sie durcharbeiten möchten, wie das Finden von Sicherheitslücken. `max` kann abnehmende Erträge zeigen und ist anfällig für Überdenken, daher testen Sie vor breiter Übernahme |

649| `ultracode` | Eine Claude Code-Einstellung, die für jede substantive Aufgabe einen [dynamischen Workflow](/docs/de/workflows) mit `xhigh` pro-Nachricht-Überlegungen plant |698| `ultracode` | Eine Claude Code-Einstellung statt einer Stufe: plant einen [dynamischen Workflow](/docs/de/workflows) für jede substantive Aufgabe auf jeder Anstrengungsstufe |

699

700In Tests auf Opus 5.5 und Fable 5.1 testete Claude auf einer höheren Stufe mehr Grenzfälle und überprüfte mehr seiner Arbeit, bevor er antwortete. Es traf auch mehr Entscheidungen auf eigene Faust. Auf einer niedrigeren Stufe gab Claude einen Ausgangspunkt schneller zurück, was zu Arbeit passt, bei der Sie jedes Ergebnis überprüfen und den nächsten Schritt steuern. Um die gleichen Aufgaben auf jeder Stufe ausgeführt zu sehen, lesen Sie [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) auf dem Blog.

650 701

651Die Anstrengungsskala ist pro Modell kalibriert, daher stellt der gleiche Stufenname nicht den gleichen zugrunde liegenden Wert über Modelle hinweg dar.702Die Anstrengungsskala ist pro Modell kalibriert, daher stellt der gleiche Stufenname nicht den gleichen zugrunde liegenden Wert über Modelle hinweg dar.

652 703

704Opus 5.5 [standardmäßig zu `medium`](#adjust-effort-level), eine Stufe unter Opus 5's Standard von `high`. In Anthropic's Tests entspricht Opus 5.5 bei `medium` oder übertrifft Opus 5 bei `high` bei Codierungs- und Wissenarbeit-Evaluierungen. Auf einer gegebenen Stufe denkt Opus 5.5 tendenziell mehr pro Zug als Opus 5. Wenn Sie von Opus 5 zu Opus 5.5 wechseln, starten Sie bei `medium`, anstatt die Stufe zu übertragen, die Sie auf Opus 5 verwendet haben. Um Stufen gegen Ihre eigene Arbeit zu testen, siehe [Anstrengung kalibrieren](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) im Opus 5.5 Prompting-Leitfaden.

705

653<h4 id="use-ultrathink-for-one-off-deep-reasoning">706<h4 id="use-ultrathink-for-one-off-deep-reasoning">

654 Verwenden Sie Ultrathink für einmalige tiefe Überlegungen707 Verwenden Sie Ultrathink für einmalige tiefe Überlegungen

655</h4>708</h4>

682 735

683Adaptive Überlegungen machen Denken bei jedem Schritt optional, sodass Claude schneller auf Routine-Eingabeaufforderungen reagieren und tiefere Überlegungen für Schritte reservieren kann, die davon profitieren. Wenn Sie möchten, dass Claude häufiger oder seltener denkt, als die aktuelle Stufe produziert, können Sie dies direkt in Ihrer Eingabeaufforderung oder in `CLAUDE.md` sagen; das Modell reagiert auf diese Anleitung innerhalb seiner Anstrengungseinstellung.736Adaptive Überlegungen machen Denken bei jedem Schritt optional, sodass Claude schneller auf Routine-Eingabeaufforderungen reagieren und tiefere Überlegungen für Schritte reservieren kann, die davon profitieren. Wenn Sie möchten, dass Claude häufiger oder seltener denkt, als die aktuelle Stufe produziert, können Sie dies direkt in Ihrer Eingabeaufforderung oder in `CLAUDE.md` sagen; das Modell reagiert auf diese Anleitung innerhalb seiner Anstrengungseinstellung.

684 737

685Fable-Modelle, Sonnet 5 und Opus 4.7 und später verwenden immer adaptive Überlegungen. Der Modus mit festem Denk-Budget und `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` gelten nicht für sie.738Fable-Modelle, Sonnet 5 und später, und Opus 4.7 und später verwenden immer adaptive Überlegungen. Der Modus mit festem Denk-Budget und `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` gelten nicht für sie.

686 739

687Auf Opus 4.6 und Sonnet 4.6 können Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen, um zum vorherigen Modus mit festem Denk-Budget zurückzukehren, der von `MAX_THINKING_TOKENS` gesteuert wird. Siehe [Umgebungsvariablen](/docs/de/env-vars).740Auf Opus 4.6 und Sonnet 4.6 können Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen, um zum vorherigen Modus mit festem Denk-Budget zurückzukehren, der von `MAX_THINKING_TOKENS` gesteuert wird. Siehe [Umgebungsvariablen](/docs/de/env-vars).

688 741

696| :- | :- |749| :- | :- |

698| Setzen Sie den globalen Standard | Führen Sie `/config` aus und schalten Sie den Denkmodus um. Gespeichert als `alwaysThinkingEnabled` in `~/.claude/settings.json` |751| Setzen Sie den globalen Standard | Führen Sie `/config` aus und schalten Sie den Denkmodus um. Gespeichert als `alwaysThinkingEnabled` in `~/.claude/settings.json` |

699| Deaktivieren Sie über eine Umgebungsvariable | Setzen Sie [`MAX_THINKING_TOKENS=0`](/docs/de/env-vars), das Denken auf der Anthropic API außer auf Opus 5.5 und Fable-Modellen ausschaltet. Auf [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt dies den `thinking` Parameter stattdessen weg, und adaptive-Überlegungs-Modelle können immer noch denken. Andere Werte gelten nur mit einem [festem Denk-Budget](#adaptive-reasoning-and-fixed-thinking-budgets) |752| Deaktivieren Sie über eine Umgebungsvariable | Setzen Sie [`MAX_THINKING_TOKENS=0`](/docs/de/env-vars), das Denken auf der Anthropic API außer auf Opus 5.5, Sonnet 5.5 und Fable-Modellen ausschaltet. Auf [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt dies den `thinking` Parameter stattdessen weg, und adaptive-Überlegungs-Modelle können immer noch denken. Andere Werte gelten nur mit einem [festem Denk-Budget](#adaptive-reasoning-and-fixed-thinking-budgets) |

700 753

701Denken kann auf Opus 5.5 oder den Fable-Modellen nicht ausgeschaltet werden. Der Sitzungs-Umschalter, `alwaysThinkingEnabled` und `MAX_THINKING_TOKENS=0` haben dort keine Auswirkung, und das Modell entscheidet pro Schritt, wie viel es denken soll, basierend auf der Anstrengungsstufe.754Denken kann auf Opus 5.5, Sonnet 5.5 oder den Fable-Modellen nicht ausgeschaltet werden. Der Sitzungs-Umschalter, `alwaysThinkingEnabled` und `MAX_THINKING_TOKENS=0` haben dort keine Auswirkung, und das Modell entscheidet pro Schritt, wie viel es denken soll, basierend auf der Anstrengungsstufe.

702 755

703Claude Code bricht Denk-Ausgabe standardmäßig zusammen. Drücken Sie `Ctrl+O`, um den ausführlichen Modus umzuschalten und die Überlegung als grauer kursiver Text zu sehen. Interaktive Sitzungen auf der Anthropic API erhalten standardmäßig redigierte Denk-Blöcke, daher setzen Sie `showThinkingSummaries: true` in [Einstellungen](/docs/de/settings), wenn Sie die vollständigen Zusammenfassungen verfügbar haben möchten, wenn Sie erweitern. Ihnen werden alle generierten Denk-Token berechnet, auch wenn sie zusammengeklappt oder redigiert sind.756Claude Code bricht Denk-Ausgabe standardmäßig zusammen. Drücken Sie `Ctrl+O`, um den ausführlichen Modus umzuschalten und die Überlegung als grauer kursiver Text zu sehen. Interaktive Sitzungen auf der Anthropic API erhalten standardmäßig redigierte Denk-Blöcke, daher setzen Sie `showThinkingSummaries: true` in [Einstellungen](/docs/de/settings), wenn Sie die vollständigen Zusammenfassungen verfügbar haben möchten, wenn Sie erweitern. Ihnen werden alle generierten Denk-Token berechnet, auch wenn sie zusammengeklappt oder redigiert sind.

704 757

758<a id="extended-context-with-1m" />

759

705<h3 id="extended-context">760<h3 id="extended-context">

706 Erweiterter Kontext761 Erweiterter Kontext

707</h3>762</h3>

708 763

709Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen ein [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen mit großen Codebases.764Fable 5.1, Fable 5, Sonnet 5 und später, Opus 4.6 und später, und Sonnet 4.6 unterstützen ein [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen mit großen Codebases.

710 765

711Auf der Anthropic API werden Fable 5.1, Fable 5, Sonnet 5 und Opus 4.7 und später standardmäßig mit dem 1M-Fenster ausgeführt. Sie wählen keine `[1m]` Variante aus und schalten keine Nutzungsguthaben für das 1M-Fenster auf diesen Modellen ein. Fable-Nutzung selbst kann auf einigen Plänen zu Nutzungsguthaben abgerechnet werden; siehe [Fable und Nutzungsguthaben](#fable-and-usage-credits).766Auf der Anthropic API werden Fable 5.1, Fable 5, Sonnet 5 und später sowie Opus 4.7 und später standardmäßig mit dem 1M-Fenster ausgeführt. Sie wählen keine `[1m]` Variante aus und schalten keine Nutzungsguthaben für das 1M-Fenster auf diesen Modellen ein. Fable-Nutzung selbst kann auf einigen Plänen zu Nutzungsguthaben abgerechnet werden; siehe [Fable und Nutzungsguthaben](#fable-and-usage-credits).

712 767

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

714 769

742/model claude-opus-4-8[1m]797/model claude-opus-4-8[1m]

743```798```

744 799

745<h4 id="sonnet-5-context-window">800<h4 id="sonnet-5-5-and-sonnet-5-context-window">

746 Sonnet 5 Kontextfenster801 Sonnet 5.5 und Sonnet 5 Kontextfenster

747</h4>802</h4>

748 803

749Auf der Anthropic API wird Sonnet 5 immer mit dem 1M-Kontextfenster ausgeführt. Es gibt keine 200K-Variante, kein `[1m]` Suffix zum Auswählen und keine erforderlichen Nutzungsguthaben auf einem Plan. Sitzungen komprimieren automatisch, bevor das Fenster sich füllt, bei etwa 967K Token standardmäßig; setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars), um einen anderen Schwellenwert zu wählen.804Auf der Anthropic API werden Sonnet 5.5 und Sonnet 5 immer mit dem 1M-Kontextfenster ausgeführt. Es gibt keine 200K-Variante, kein `[1m]` Suffix zum Auswählen und keine erforderlichen Nutzungsguthaben auf einem Plan. Sitzungen komprimieren automatisch, bevor das Fenster sich füllt, bei etwa 967K Token standardmäßig; setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars), um einen anderen Schwellenwert zu wählen.

750 805

751Zwei Konfigurationen budgetieren das Fenster stattdessen bei 200K:806Zwei Konfigurationen budgetieren das Fenster stattdessen bei 200K:

752 807

753* **LLM-Gateway**: wenn `ANTHROPIC_BASE_URL` auf ein [Gateway](/docs/de/llm-gateway) verweist, kann Claude Code 1M-Unterstützung nicht überprüfen. Um das vollständige Fenster zu verwenden, wählen Sie Sonnet 5 (1M context) im Modell-Picker, das zu `sonnet[1m]` zugeordnet wird.808* **LLM-Gateway**: wenn `ANTHROPIC_BASE_URL` auf ein [Gateway](/docs/de/llm-gateway) verweist, kann Claude Code 1M-Unterstützung nicht überprüfen. Um das vollständige Fenster zu verwenden, wählen Sie Sonnet 5.5 (1M context) im Modell-Picker, das zu `sonnet[1m]` zugeordnet wird, oder führen Sie `/model claude-sonnet-5[1m]` für Sonnet 5 aus.

754* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: hält Sitzungen auf jedem Modell mit einem nativen 1M-Fenster bei einem 200K-Fenster; siehe [Erweiterter Kontext](#extended-context) für wie der Halt durchgesetzt wird. Nützlich für Bereitstellungen, die den Kontext begrenzen müssen.809* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: hält Sitzungen auf jedem Modell mit einem nativen 1M-Fenster bei einem 200K-Fenster; siehe [Erweiterter Kontext](#extended-context) für wie der Halt durchgesetzt wird. Nützlich für Bereitstellungen, die den Kontext begrenzen müssen.

755 810

756<h2 id="context-window-and-auto-compaction">811<h2 id="context-window-and-auto-compaction">

786* [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) komprimieren, wenn sich die Konversation dem Limit des Modells nähert841* [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) komprimieren, wenn sich die Konversation dem Limit des Modells nähert

787* Sonnet 4.6 und Opus 4.6 ohne [erweiterter Kontext](#extended-context) komprimieren bei der 200K-Grenze, ebenso wie Opus 4.8 und später, wenn sie mit einem 200K-Kontextfenster laufen, z. B. auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry842* Sonnet 4.6 und Opus 4.6 ohne [erweiterter Kontext](#extended-context) komprimieren bei der 200K-Grenze, ebenso wie Opus 4.8 und später, wenn sie mit einem 200K-Kontextfenster laufen, z. B. auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry

788* Wenn Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars) setzen, komprimieren Modelle mit einem nativen 1M-Fenster, wie Sonnet 5 und die Fable-Modelle, bei der 200K-Grenze843* Wenn Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars) setzen, komprimieren Modelle mit einem nativen 1M-Fenster, wie Sonnet 5 und die Fable-Modelle, bei der 200K-Grenze

789* Modelle, die mit einem nativen 1M-Fenster laufen, wie Sonnet 5, die Fable-Modelle und Opus 4.7 und später auf der Anthropic API, komprimieren, bevor das Fenster voll wird, standardmäßig bei etwa 967K Token. Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry gibt [Modelle für Bereitstellungen von Drittanbietern anheften](#pin-models-for-third-party-deployments) an, welche Modelle mit diesem Fenster laufen; für die Konfigurationen, die Sonnet 5 stattdessen mit 200K budgetieren, siehe [Sonnet 5 Kontextfenster](#sonnet-5-context-window)844* Modelle, die mit einem nativen 1M-Fenster laufen, wie Sonnet 5, die Fable-Modelle und Opus 4.7 und später auf der Anthropic API, komprimieren, bevor das Fenster voll wird, standardmäßig bei etwa 967K Token. Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry gibt [Modelle für Bereitstellungen von Drittanbietern anheften](#pin-models-for-third-party-deployments) an, welche Modelle mit diesem Fenster laufen; für die Konfigurationen, die Sonnet 5.5 und Sonnet 5 stattdessen mit 200K budgetieren, siehe [Sonnet 5.5 und Sonnet 5 Kontextfenster](#sonnet-5-5-and-sonnet-5-context-window)

790* Sitzungen auf einer Modell-ID, die Claude Code nicht erkennt, z. B. ein [LLM-Gateway](/docs/de/llm-gateway)-Alias, komprimieren bei dem Kontextfenster, das Claude Code für die ID annimmt; siehe [Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](#correct-the-window-for-a-gateway-or-custom-model-id)845* Sitzungen auf einer Modell-ID, die Claude Code nicht erkennt, z. B. ein [LLM-Gateway](/docs/de/llm-gateway)-Alias, komprimieren bei dem Kontextfenster, das Claude Code für die ID annimmt; siehe [Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren](#correct-the-window-for-a-gateway-or-custom-model-id)

791 846

792<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">847<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

861| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Das Modell, das für `haiku` verwendet werden soll, oder [Hintergrundfunktionalität](/docs/de/costs#background-token-usage) |916| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Das Modell, das für `haiku` verwendet werden soll, oder [Hintergrundfunktionalität](/docs/de/costs#background-token-usage) |

862| `CLAUDE_CODE_SUBAGENT_MODEL` | Das Standard-Modell für [Subagents](/docs/de/sub-agents#choose-a-model), [Agent-Team](/docs/de/agent-teams#specify-teammates-and-models)-Kollegen und [Workflow](/docs/de/workflows)-Agenten, denen auf andere Weise kein Modell zugewiesen ist. Akzeptiert einen Alias wie `haiku` oder einen vollständigen Modellnamen. Ein Modell pro Aufruf oder das `model`-Feld einer Definition, einschließlich `inherit`, hat Vorrang. Um das zu ändern, setzen Sie [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/de/sub-agents#run-every-subagent-on-one-model) |917| `CLAUDE_CODE_SUBAGENT_MODEL` | Das Standard-Modell für [Subagents](/docs/de/sub-agents#choose-a-model), [Agent-Team](/docs/de/agent-teams#specify-teammates-and-models)-Kollegen und [Workflow](/docs/de/workflows)-Agenten, denen auf andere Weise kein Modell zugewiesen ist. Akzeptiert einen Alias wie `haiku` oder einen vollständigen Modellnamen. Ein Modell pro Aufruf oder das `model`-Feld einer Definition, einschließlich `inherit`, hat Vorrang. Um das zu ändern, setzen Sie [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/de/sub-agents#run-every-subagent-on-one-model) |

863 918

919Bei Drittanbieter-Anbietern beschreibt [Anzeige und Funktionen des fixierten Modells anpassen](#customize-pinned-model-display-and-capabilities), was eine fixierte Modell-Zeile in der `/model`-Auswahl anzeigt.

920

864Hinweis: `ANTHROPIC_SMALL_FAST_MODEL` ist veraltet zugunsten von `ANTHROPIC_DEFAULT_HAIKU_MODEL`.921Hinweis: `ANTHROPIC_SMALL_FAST_MODEL` ist veraltet zugunsten von `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

865 922

866<h3 id="pin-models-for-third-party-deployments">923<h3 id="pin-models-for-third-party-deployments">

995| Umgebungsvariable | Beschreibung |1052| Umgebungsvariable | Beschreibung |

996| - | - |1053| - | - |

997| `DISABLE_PROMPT_CACHING` | Setzen Sie auf `1`, um Prompt-Caching für alle Modelle zu deaktivieren. Hat Vorrang vor den modellspezifischen Einstellungen |1054| `DISABLE_PROMPT_CACHING` | Setzen Sie auf `1`, um Prompt-Caching für alle Modelle zu deaktivieren. Hat Vorrang vor den modellspezifischen Einstellungen |

998| `DISABLE_PROMPT_CACHING_HAIKU` | Setzen Sie auf `1`, um Prompt-Caching nur für Haiku-Modelle zu deaktivieren |1055| `DISABLE_PROMPT_CACHING_HAIKU` | Setzen Sie auf `1`, um Prompt-Caching für das [Standard-Haiku-Modell](/docs/de/prompt-caching#disable-prompt-caching) zu deaktivieren |

1002 1059

1003Um die Cache-TTL für das Hauptgespräch und für Subagents separat auszuwählen, siehe [wählen Sie die TTL selbst](/docs/de/prompt-caching#choose-the-ttl-yourself). Für das, was einen Cache-Miss auslöst, siehe [Wie Claude Code Prompt-Caching verwendet](/docs/de/prompt-caching).1060Um die Cache-TTL für das Hauptgespräch und für Subagents separat auszuwählen, siehe [wählen Sie die TTL selbst](/docs/de/prompt-caching#choose-the-ttl-yourself). Für das, was einen Cache-Miss auslöst, siehe [Wie Claude Code Prompt-Caching verwendet](/docs/de/prompt-caching).

1061

1062<h2 id="version-history">

1063 Versionsverlauf

1064</h2>

1065

1066Diese Tabelle listet die Claude Code-Version auf, in der jeder Modellalias das Modell geändert hat, zu dem er aufgelöst wird, neueste zuerst.

1067

1068| Version | Änderung |

1069| :- | :- |

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

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

1072| v2.1.257 | `fable` wird zu Fable 5.1 aufgelöst, außer in Claude Apps Gateway-Sitzungen |

1073| v2.1.219 | `opus` wird zu Opus 5 auf der Anthropic API, Claude Platform auf AWS, Amazon Bedrock und Agent Platform aufgelöst |

1074| v2.1.207 | `opus` wird zu Opus 4.8 auf Claude Platform auf AWS, Amazon Bedrock und Agent Platform aufgelöst |

1075| v2.1.197 | `sonnet` wird zu Sonnet 5 auf der Anthropic API aufgelöst |

1076| v2.1.154 | `opus` wird zu Opus 4.8 auf der Anthropic API aufgelöst |

1077| Früher | `opus` wird zu Opus 4.7 auf Claude Platform auf AWS und zu Opus 4.6 auf Amazon Bedrock und Agent Platform aufgelöst. `fable` wird zu Fable 5 auf jedem Anbieter aufgelöst |

monitoring-usage.md +316 −272

Details

39 39

40Um eine Einrichtung zu überprüfen, die Metriken exportiert, suchen Sie in Ihrem Backend nach der Metrik `claude_code.session.count`, die Claude Code beim Start einer Sitzung ausgibt. Um eine reine Logs-Einrichtung zu überprüfen, senden Sie eine Eingabeaufforderung und suchen Sie nach dem Ereignis `claude_code.user_prompt`.40Um eine Einrichtung zu überprüfen, die Metriken exportiert, suchen Sie in Ihrem Backend nach der Metrik `claude_code.session.count`, die Claude Code beim Start einer Sitzung ausgibt. Um eine reine Logs-Einrichtung zu überprüfen, senden Sie eine Eingabeaufforderung und suchen Sie nach dem Ereignis `claude_code.user_prompt`.

41 41

42Wenn nichts ankommt, führen Sie `claude --debug` aus und überprüfen Sie das Debug-Protokoll. Claude Code meldet Fehler von den konfigurierten Exportern als `[3P telemetry]`-Fehler, wobei 3P für Drittanbieter steht. Zeilen mit dem Präfix `[Anthropic telemetry]` beschreiben [Anthropics separate operative Telemetrie](/docs/de/data-usage#telemetry-services) und deuten nicht auf ein Problem mit Ihrer Einrichtung hin.42Wenn nichts ankommt, führen Sie Claude Code mit `claude --debug-file <path>` aus und überprüfen Sie das Protokoll, das es in diesen Pfad schreibt. Claude Code meldet Fehler von den konfigurierten Exportern als `[3P telemetry]`-Fehler, wobei 3P für Drittanbieter steht. Zeilen mit dem Präfix `[Anthropic telemetry]` beschreiben [Anthropics separate operative Telemetrie](/docs/de/data-usage#telemetry-services) und deuten nicht auf ein Problem mit Ihrer Einrichtung hin.

43 43

44Für vollständige Konfigurationsoptionen siehe die [OpenTelemetry-Spezifikation](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).44Für vollständige Konfigurationsoptionen siehe die [OpenTelemetry-Spezifikation](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).

45 45

72 Wie verwaltete Einstellungen das OTLP-Ziel sperren72 Wie verwaltete Einstellungen das OTLP-Ziel sperren

73</h3>73</h3>

74 74

75Wenn Sie eine `OTEL_EXPORTER_OTLP_*` Variable in verwalteten Einstellungen setzen, entfernt Claude Code bei der Initialisierung konfligierende von Entwicklern gesetzte Variablen und protokolliert eine Warnung, die Sie mit `claude --debug` sehen können. Was entfernt wird, hängt davon ab, welche Variable Sie setzen:75Wenn Sie eine `OTEL_EXPORTER_OTLP_*` Variable in verwalteten Einstellungen setzen, entfernt Claude Code bei der Initialisierung konfligierende von Entwicklern gesetzte Variablen und protokolliert eine Warnung im Debug-Protokoll. Was entfernt wird, hängt davon ab, welche Variable Sie setzen:

76 76

77* **Endpunkte**: Wenn Sie `OTEL_EXPORTER_OTLP_ENDPOINT` setzen, entfernt Claude Code jeden von Entwicklern gesetzten signalspezifischen Endpunkt. Entwickler können ein Signal nicht auf einen anderen Collector verweisen, daher müssen Sie die signalspezifischen Endpunkt-Variablen nicht auch in verwalteten Einstellungen setzen.77* **Endpunkte**: Wenn Sie `OTEL_EXPORTER_OTLP_ENDPOINT` setzen, entfernt Claude Code jeden von Entwicklern gesetzten signalspezifischen Endpunkt. Entwickler können ein Signal nicht auf einen anderen Collector verweisen, daher müssen Sie die signalspezifischen Endpunkt-Variablen nicht auch in verwalteten Einstellungen setzen.

78* **Protokolle**: Wenn Sie `OTEL_EXPORTER_OTLP_PROTOCOL` setzen, entfernt Claude Code jeden von Entwicklern gesetzten signalspezifischen Protokoll.78* **Protokolle**: Wenn Sie `OTEL_EXPORTER_OTLP_PROTOCOL` setzen, entfernt Claude Code jeden von Entwicklern gesetzten signalspezifischen Protokoll.

105 105

106Diese Variablen konfigurieren Exporter, Endpunkte und Exportverhalten für alle Bereitstellungen.106Diese Variablen konfigurieren Exporter, Endpunkte und Exportverhalten für alle Bereitstellungen.

107 107

108Wenn Sie eine signalspezifische Endpunkt- oder Protokollvariable wie `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` setzen, verwendet Claude Code diese statt der generischen Variablen für dieses Signal. Wenn Sie eine signalspezifische Header-Variable wie `OTEL_EXPORTER_OTLP_METRICS_HEADERS` setzen, führt Claude Code diese mit der generischen `OTEL_EXPORTER_OTLP_HEADERS` für dieses Signal zusammen.108Wenn Sie eine signalspezifische Endpunkt- oder Protokollvariable wie `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` setzen, verwendet Claude Code diese statt der generischen Variable für dieses Signal. Wenn Sie eine signalspezifische Header-Variable wie `OTEL_EXPORTER_OTLP_METRICS_HEADERS` setzen, führt Claude Code diese mit dem generischen `OTEL_EXPORTER_OTLP_HEADERS` für dieses Signal zusammen.

109 109

110Auf Maschinen mit verwalteten Einstellungen siehe [Wie verwaltete Einstellungen das OTLP-Ziel sperren](#how-managed-settings-lock-the-otlp-destination), um zu sehen, was Claude Code entfernt.110Auf Maschinen mit verwalteten Einstellungen siehe [Wie verwaltete Einstellungen das OTLP-Ziel sperren](#how-managed-settings-lock-the-otlp-destination), um zu erfahren, was Claude Code entfernt.

111 111

113| - | - | - |113| - | - | - |

114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Aktiviert die Telemetrieerfassung (erforderlich) | `1` |114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Aktiviert Telemetrieerfassung (erforderlich) | `1` |

117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Protokoll für OTLP-Exporter, gilt für alle Signale. Claude Code hat kein Standardprotokoll, daher setzen Sie dies oder die signalspezifische Protokollvariable für jeden `otlp`-Exporter, den Sie aktivieren | `grpc`, `http/json`, `http/protobuf` |117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Protokoll für OTLP-Exporter, gilt für alle Signale. Claude Code hat kein Standardprotokoll, daher setzen Sie dies oder die signalspezifische Protokollvariable für jeden aktivierten `otlp`-Exporter | `grpc`, `http/json`, `http/protobuf` |

126| `OTEL_METRIC_EXPORT_INTERVAL` | Exportintervall in Millisekunden (Standard: 60000) | `5000`, `60000` |126| `OTEL_METRIC_EXPORT_INTERVAL` | Exportintervall in Millisekunden (Standard: 60000) | `5000`, `60000` |

127| `OTEL_LOGS_EXPORT_INTERVAL` | Logs-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |127| `OTEL_LOGS_EXPORT_INTERVAL` | Protokoll-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |

129| `OTEL_LOG_ASSISTANT_RESPONSES` | Aktiviert die Protokollierung von Assistent-Antworttext bei `assistant_response`-Ereignissen (Standard: deaktiviert). Wenn nicht gesetzt, wird auf den Wert von `OTEL_LOG_USER_PROMPTS` zurückgegriffen. Erfordert Claude Code v2.1.193 oder später | `1` zum Aktivieren, `0` zum Beibehalten von Redaktionen |129| `OTEL_LOG_ASSISTANT_RESPONSES` | Aktiviert Protokollierung von Assistent-Antworttext bei `assistant_response`-Ereignissen (Standard: deaktiviert). Wenn nicht gesetzt, wird auf den Wert von `OTEL_LOG_USER_PROMPTS` zurückgegriffen. Erfordert Claude Code v2.1.193 oder später | `1` zum Aktivieren, `0` zum Beibehalten von Redaktion |

130| `OTEL_LOG_TOOL_DETAILS` | Aktiviert die Protokollierung von Tool-Parametern und Eingabeargumenten in Tool-Ereignissen und Trace-Span-Attributen: Bash-Befehle, MCP-Server- und Tool-Namen, Skill-Namen, benutzerdefinierte Workflow-Namen und Tool-Eingabe. Aktiviert auch benutzerdefinierte, Plugin- und MCP-Befehlsnamen bei `user_prompt`-Ereignissen (Standard: deaktiviert). Für Claude Desktop's integrierte Server, in Sitzungen, die Claude Desktop besitzt, werden `mcp_server_name`/`mcp_tool_name` bei `tool_decision`/`tool_result` auch mit ausgeschaltetem Flag ausgegeben. Die Ausnahme erfordert Claude Code v2.1.214 oder später | `1` zum Aktivieren |130| `OTEL_LOG_TOOL_DETAILS` | Aktiviert Protokollierung von Tool-Parametern und Eingabeargumenten in Tool-Ereignissen und Span-Attributen: Bash-Befehle, MCP-Server- und Tool-Namen, Skill-Namen, benutzerdefinierte Workflow-Namen und Tool-Eingabe. Aktiviert auch benutzerdefinierte, Plugin- und MCP-Befehlsnamen bei `user_prompt`-Ereignissen und echte Agent-, Skill-, Plugin- und MCP-Server- und Tool-Namen bei den [Kosten- und Token-Zählern](#cost-counter) (Standard: deaktiviert). Für Claudes integrierte Server in Sitzungen, die Claude Desktop besitzt, geben `mcp_server_name`/`mcp_tool_name` bei `tool_decision`/`tool_result` aus, auch wenn das Flag aus ist. Die Ausnahme erfordert Claude Code v2.1.214 oder später | `1` zum Aktivieren |

131| `OTEL_LOG_TOOL_CONTENT` | Aktiviert die Protokollierung von Tool-Inhalten im [`tool.output` Span-Ereignis](#tool-output-span-event) (Standard: deaktiviert). Span-Attribute tragen Tool-Inhalte unter [ihren eigenen Gates](#new-context-gates). Erfordert [Tracing](#traces-beta). Der Inhalt wird bei der Inhaltsbegrenzung gekürzt (Standard: 60 KB) | `1` zum Aktivieren |131| `OTEL_LOG_TOOL_CONTENT` | Aktiviert Protokollierung von Tool-Inhalten im [`tool.output` Span-Ereignis](#tool-output-span-event) (Standard: deaktiviert). Span-Attribute tragen Tool-Inhalte unter [ihren eigenen Gates](#new-context-gates). Erfordert [Tracing](#traces-beta). Inhalte werden auf das Inhaltslimit gekürzt (Standard 60 KB) | `1` zum Aktivieren |

132| `OTEL_LOG_MANAGED_SETTINGS` | Fügt die redigierten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor der Redaktion zu [verwaltete Einstellungen aufgelöst](#managed-settings-resolved-event) Ereignissen hinzu (Standard: deaktiviert). Ein Wert in Projekt- oder lokalen Einstellungen schaltet ihn nicht ein. Erfordert Claude Code v2.1.274 oder später | `1` zum Aktivieren |132| `OTEL_LOG_MANAGED_SETTINGS` | Fügt die redigierten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor Redaktion zu [verwaltete Einstellungen aufgelöst](#managed-settings-resolved-event)-Ereignissen hinzu (Standard: deaktiviert). Ein Wert in Projekt- oder lokalen Einstellungen schaltet dies nicht ein. Erfordert Claude Code v2.1.274 oder später | `1` zum Aktivieren |

133| `OTEL_LOG_RAW_API_BODIES` | Gibt die vollständige Anthropic Messages API-Anfrage und Antwort JSON als `api_request_body` / `api_response_body` Log-Ereignisse aus (Standard: deaktiviert). Texte enthalten die gesamte Konversationshistorie. Das Aktivieren impliziert Zustimmung zu allem, was `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` und `OTEL_LOG_TOOL_CONTENT` offenbaren würden | `1` für Inline-Texte gekürzt bei der Inhaltsbegrenzung (Standard: 60 KB), oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |133| `OTEL_LOG_RAW_API_BODIES` | Gibt den vollständigen Anthropic Messages API-Request und Response JSON als `api_request_body` / `api_response_body` Log-Ereignisse aus (Standard: deaktiviert). Bodies enthalten die gesamte Konversationshistorie. Das Aktivieren impliziert Zustimmung zu allem, was `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` und `OTEL_LOG_TOOL_CONTENT` offenbaren würden | `1` für Inline-Bodies gekürzt auf das Inhaltslimit (Standard 60 KB), oder `file:<dir>` für ungekürzte Bodies auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |

134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Inhaltsbegrenzung: die maximale Länge von inhaltsführenden Attributen wie Modellreaktionen, Tool-Inhalten, Systemprompts und rohen API-Texten, Kürzungsmarkierung eingeschlossen, in UTF-16-Codeeinheiten (Standard: 61440, d. h. 60 KB). Der Standard ist für Backends ausgelegt, die Attributwerte auf 64 KB begrenzen; erhöhen Sie ihn nur, wenn Ihr Backend größere Werte akzeptiert, oder senken Sie ihn, um das Telemetrie-Volumen zu reduzieren. Wenn ein OpenTelemetry SDK-Attributlimit, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` oder eine seiner Logrecord- und Span-Varianten, auf einen niedrigeren Wert gesetzt ist, kürzt Claude Code bei diesem kleineren Wert, damit die `[TRUNCATED ...]`-Markierung innerhalb des SDK-Limits bleibt. Erfordert Claude Code v2.1.214 oder später | `262144` |134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Inhaltslimit: die maximale Länge von inhaltstragenden Attributen wie Modellresponses, Tool-Inhalten, Systemprompts und Raw API Bodies, Kürzungsmarker eingeschlossen, in UTF-16-Codeeinheiten (Standard: 61440, d.h. 60 KB). Der Standard ist für Backends ausgelegt, die Attributwerte auf 64 KB begrenzen; erhöhen Sie ihn nur, wenn Ihr Backend größere Werte akzeptiert, oder senken Sie ihn, um das Telemetrievolumen zu reduzieren. Wenn ein OpenTelemetry SDK-Attributlimit, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` oder eine seiner Logrecord- und Span-Varianten, auf einen niedrigeren Wert gesetzt ist, kürzt Claude Code auf diesen kleineren Wert, damit der `[TRUNCATED ...]`-Marker innerhalb des SDK-Limits bleibt. Erfordert Claude Code v2.1.214 oder später | `262144` |

135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Metriken-Temporalitätspräferenz (Standard: `delta`). Setzen Sie auf `cumulative`, wenn Ihr Backend kumulative Temporalität erwartet | `delta`, `cumulative` |135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Metriken-Temporalitätspräferenz (Standard: `delta`). Setzen Sie auf `cumulative`, wenn Ihr Backend kumulative Temporalität erwartet | `delta`, `cumulative` |

136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer Header (Standard: 1740000ms / 29 Minuten) | `900000` |136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer Header (Standard: 1740000ms / 29 Minuten) | `900000` |

137 137

138Für die Protokolle `http/protobuf` und `http/json` sendet Claude Code jede Exportanfrage mit einem `Content-Length`-Header. Vor v2.1.212 sendeten Claude Code-Versionen ab v2.1.191 diese Anfragen mit Chunked-Transfer-Codierung; Azure Monitor und andere Endpunkte, die eine deklarierte Länge erfordern, lehnten sie mit `411 Length Required` oder `400` Fehlern ab.138Für die Protokolle `http/protobuf` und `http/json` sendet Claude Code jede Exportanfrage mit einem `Content-Length`-Header. Vor v2.1.212 sendeten Claude Code-Versionen ab v2.1.191 diese Anfragen mit Chunked-Transfer-Codierung; Azure Monitor und andere Endpunkte, die eine deklarierte Länge erfordern, lehnten sie mit `411 Length Required` oder `400`-Fehlern ab.

139 139

140<h3 id="mtls-authentication">140<h3 id="mtls-authentication">

141 mTLS-Authentifizierung141 mTLS-Authentifizierung

142</h3>142</h3>

143 143

144Wie Sie Client-Zertifikate für den OTLP-Exporter konfigurieren, hängt vom OTLP-Protokoll ab, das für dieses Signal verwendet wird, das über `OTEL_EXPORTER_OTLP_PROTOCOL` oder die Pro-Signal-Überschreibung gesetzt wird. Die gleiche Konfiguration gilt für Metriken, Logs und Traces.144Wie Sie Client-Zertifikate für den OTLP-Exporter konfigurieren, hängt vom OTLP-Protokoll ab, das für dieses Signal verwendet wird, gesetzt über `OTEL_EXPORTER_OTLP_PROTOCOL` oder die signalspezifische Überschreibung. Die gleiche Konfiguration gilt für Metriken, Protokolle und Traces.

145 145

147| :- | :- | :- |147| :- | :- | :- |

148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` und optional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Siehe [Netzwerkkonfiguration](/docs/de/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` und optional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Siehe [Netzwerkkonfiguration](/docs/de/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` und `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, oder die Pro-Signal-Varianten wie `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`, um ein anderes Zertifikat pro Signal zu verwenden | `OTEL_EXPORTER_OTLP_CERTIFICATE` |149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` und `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, oder die signalspezifischen Varianten wie `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`, um ein anderes Zertifikat pro Signal zu verwenden | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

150 150

151Für `grpc` liest das OpenTelemetry SDK die Standard-OTLP-Variablen direkt, daher funktionieren bestehende Konfigurationen, die die signalspezifischen Metriken-Variablen setzen, weiterhin. Auf Maschinen mit verwalteten Einstellungen kann Claude Code [signalspezifische Anmeldedaten und Endpunkte, die von Entwicklern gesetzt wurden, beim Start entfernen](#how-managed-settings-lock-the-otlp-destination).151Für `grpc` liest das OpenTelemetry SDK die Standard-OTLP-Variablen direkt, daher funktionieren bestehende Konfigurationen, die die signalspezifischen Metriken-Variablen setzen, weiterhin. Auf Maschinen mit verwalteten Einstellungen kann Claude Code [entwickler-gesetzte signalspezifische Anmeldedaten und Endpunkte beim Start entfernen](#how-managed-settings-lock-the-otlp-destination).

152 152

153<h3 id="metrics-cardinality-control">153<h3 id="metrics-cardinality-control">

154 Metriken-Kardinalitätskontrolle154 Metriken-Kardinalitätskontrolle

158 158

160| - | - | - | - |160| - | - | - | - |

166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Schließen Sie `vcs.*` [Repository-Identitätsattribute](#repository-attributes) in Metriken und Ereignissen ein. Erfordert Claude Code v2.1.269 oder später | `false` | `true` |166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Schließt `vcs.*` [Repository-Identitätsattribute](#repository-attributes) auf Metriken und Ereignissen ein. Erfordert Claude Code v2.1.269 oder später | `false` | `true` |

167 167

168Eine niedrigere Kardinalität bedeutet in der Regel bessere Leistung und niedrigere Speicherkosten, aber weniger granulare Daten für die Analyse.168Niedrigere Kardinalität bedeutet im Allgemeinen bessere Leistung und niedrigere Speicherkosten, aber weniger granulare Daten für die Analyse.

169 169

170<h3 id="traces-beta">170<h3 id="traces-beta">

171 Traces (Beta)171 Traces (Beta)

172</h3>172</h3>

173 173

174Verteiltes Tracing exportiert Spans, die jeden Benutzer-Prompt mit den API-Anfragen und Tool-Ausführungen verknüpfen, die er auslöst, sodass Sie eine vollständige Anfrage als einzelnen Trace in Ihrem Tracing-Backend anzeigen können.174Verteiltes Tracing exportiert Spans, die jeden Benutzer-Prompt mit den API-Anfragen und Tool-Ausführungen verknüpfen, die er auslöst, damit Sie eine vollständige Anfrage als einzelnen Trace in Ihrem Tracing-Backend anzeigen können.

175 175

176Tracing ist standardmäßig deaktiviert. Um es zu aktivieren, setzen Sie sowohl `CLAUDE_CODE_ENABLE_TELEMETRY=1` als auch `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, und setzen Sie dann `OTEL_TRACES_EXPORTER`, um auszuwählen, wohin Spans gesendet werden. Traces verwenden die [allgemeine OTLP-Konfiguration](#common-configuration-variables) für Endpunkt, Protokoll, Header und [mTLS](#mtls-authentication) erneut. Auf Maschinen mit verwalteten Einstellungen kann Claude Code [signalspezifische Anmeldedaten und Endpunkte, die von Entwicklern gesetzt wurden, beim Start entfernen](#how-managed-settings-lock-the-otlp-destination).176Tracing ist standardmäßig deaktiviert. Um es zu aktivieren, setzen Sie sowohl `CLAUDE_CODE_ENABLE_TELEMETRY=1` als auch `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, dann setzen Sie `OTEL_TRACES_EXPORTER`, um zu wählen, wohin Spans gesendet werden. Traces verwenden die [allgemeine OTLP-Konfiguration](#common-configuration-variables) für Endpunkt, Protokoll, Header und [mTLS](#mtls-authentication) wieder. Auf Maschinen mit verwalteten Einstellungen kann Claude Code [entwickler-gesetzte signalspezifische Anmeldedaten und Endpunkte beim Start entfernen](#how-managed-settings-lock-the-otlp-destination).

177 177

179| - | - | - |179| - | - | - |

180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Aktiviert Span-Tracing (erforderlich). `ENABLE_ENHANCED_TELEMETRY_BETA` wird auch akzeptiert | `1` |180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Aktiviert Span-Tracing (erforderlich). `ENABLE_ENHANCED_TELEMETRY_BETA` wird auch akzeptiert | `1` |

185| `OTEL_TRACES_EXPORT_INTERVAL` | Span-Batch-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |185| `OTEL_TRACES_EXPORT_INTERVAL` | Span-Batch-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |

186 186

187Spans schwärzen Benutzer-Prompt-Text, Tool-Eingabedetails und Tool-Inhalte standardmäßig. Setzen Sie `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1` und `OTEL_LOG_TOOL_CONTENT=1`, um sie einzubeziehen.187Spans redigieren standardmäßig Benutzer-Prompt-Text, Tool-Eingabedetails und Tool-Inhalte. Setzen Sie `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1` und `OTEL_LOG_TOOL_CONTENT=1`, um diese einzuschließen.

188 188

189Wenn Tracing aktiv ist, erben Bash- und PowerShell-Subprozesse automatisch eine `TRACEPARENT`-Umgebungsvariable, die den W3C-Trace-Kontext des aktiven Tool-Ausführungs-Spans enthält. Dies ermöglicht jedem Subprozess, der `TRACEPARENT` liest, seine eigenen Spans unter demselben Trace zu verschachteln, was eine End-to-End-verteilte Tracing durch Skripte und Befehle ermöglicht, die Claude ausführt.189Wenn Tracing aktiv ist, erben Bash- und PowerShell-Subprozesse automatisch eine `TRACEPARENT`-Umgebungsvariable, die den W3C-Trace-Kontext des aktiven Tool-Ausführungs-Spans enthält. Dies ermöglicht jedem Subprozess, der `TRACEPARENT` liest, seine eigenen Spans unter demselben Trace zu platzieren, was End-to-End-verteiltes Tracing durch Scripts und Befehle ermöglicht, die Claude ausführt.

190 190

191Wenn Tracing aktiv ist und Claude Code direkt mit der Anthropic API verbunden ist, trägt jede Modellanfrage einen W3C `traceparent` Header, der auf den Kontext des `claude_code.llm_request` Spans gesetzt ist, und der `traceresponse` Header der API wird als Span-Link aufgezeichnet. Zusammen verbinden diese Claude Code's clientseitige Spans mit dem serverseitigen Trace durch jeden konformen Vermittler. Der Header wird nicht an Drittanbieter gesendet.191Wenn Tracing aktiv ist und Claude Code direkt mit der Anthropic API verbunden ist, trägt jede Modellanfrage einen W3C-`traceparent`-Header, der auf den Kontext des `claude_code.llm_request`-Spans gesetzt ist, und der `traceresponse`-Header der API wird als Span-Link aufgezeichnet. Zusammen verbinden diese Claude Codes clientseitige Spans mit dem serverseitigen Trace durch jeden konformen Vermittler. Ausgehende HTTP-MCP-Anfragen tragen `traceparent` auf die gleiche Weise. Der Header wird nicht an Drittanbieter gesendet.

192 192

193Standardmäßig wird der `traceparent` Header bei Model- und HTTP MCP-Anfragen nur gesendet, wenn `ANTHROPIC_BASE_URL` nicht gesetzt ist oder auf die Anthropic API verweist, da einige Proxys unbekannte Header ablehnen. Die Subprozess-`TRACEPARENT`-Variable wird durch denselben Schalter aus Konsistenzgründen gesteuert. Wenn Sie Claude Code durch einen benutzerdefinierten `ANTHROPIC_BASE_URL` Proxy ausführen und Trace-Kontext propagiert werden soll, setzen Sie `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.193Standardmäßig wird der `traceparent`-Header bei Modell- und HTTP-MCP-Anfragen nur gesendet, wenn `ANTHROPIC_BASE_URL` nicht gesetzt ist oder auf die Anthropic API verweist, da einige Proxys unbekannte Header ablehnen. Die Subprocess-`TRACEPARENT`-Variable wird aus Konsistenzgründen durch denselben Schalter gesteuert. Wenn Sie Claude Code durch einen benutzerdefinierten `ANTHROPIC_BASE_URL`-Proxy ausführen und Trace-Kontext propagieren möchten, setzen Sie `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.

194 194

195In Agent SDK und nicht-interaktiven Sitzungen, die mit `-p` gestartet werden, liest Claude Code auch `TRACEPARENT` und `TRACESTATE` aus seiner eigenen Umgebung, wenn jeder Interaktions-Span gestartet wird. Dies ermöglicht einem Embedding-Prozess, seinen aktiven W3C-Trace-Kontext in den Subprozess zu übergeben, sodass Claude Code's Spans als untergeordnete Elemente des Aufrufers verteilter Trace erscheinen. Interaktive Sitzungen ignorieren eingehende `TRACEPARENT`, um zu vermeiden, dass versehentlich Umgebungswerte aus CI oder Container-Umgebungen geerbt werden.195In Agent SDK und nicht-interaktiven Sitzungen, die mit `-p` gestartet werden, liest Claude Code auch `TRACEPARENT` und `TRACESTATE` aus seiner eigenen Umgebung, wenn es jeden Interaktions-Span startet. Dies ermöglicht einem Einbettungsprozess, seinen aktiven W3C-Trace-Kontext in den Subprozess zu übergeben, damit Claude Codes Spans als Kinder des Aufrufers verteilter Trace erscheinen. Interaktive Sitzungen ignorieren eingehende `TRACEPARENT`, um zu vermeiden, dass versehentlich Umgebungswerte von CI oder Container-Umgebungen geerbt werden.

196 196

197Der eingehende Trace-Kontext gilt auch für [Ereignisse](#events). In Agent SDK und `-p` Sitzungen mit `TRACEPARENT` gesetzt, trägt jeder OTLP-Ereignis-Log-Datensatz `trace_id` und `span_id` Werte, die ihn mit Ihrem Anwendungs-Trace verbinden, auch wenn der Traces-Exporter nicht konfiguriert ist, sodass Ihr Logging-Backend Ereignisse mit dem Rest des Trace korrelieren kann.197Der eingehende Trace-Kontext gilt auch für [Ereignisse](#events). In Agent SDK und `-p`-Sitzungen mit gesetztem `TRACEPARENT` trägt jeder OTLP-Ereignis-Log-Record `trace_id` und `span_id`-Werte, die ihn mit Ihrem Anwendungs-Trace verbinden, auch wenn der Traces-Exporter nicht konfiguriert ist, damit Ihr Logging-Backend Ereignisse mit dem Rest des Traces korrelieren kann.

198 198

199Ein Datensatz, der ausgegeben wird, während eine Interaktion aktiv ist, trägt die IDs des Interaktions-Spans, auch wenn Claude Code ihn außerhalb des asynchronen Kontexts des Spans ausgibt, wie in einem Berechtigungsprompt-Callback oder für einen Datensatz, der während des Starts gepuffert und später exportiert wird. Ein Datensatz, der ohne aktiven Interaktions-Span ausgegeben wird, trägt die eingehenden `TRACEPARENT` IDs direkt. Vor v2.1.214 trugen Datensätze, die außerhalb des asynchronen Kontexts des Spans ausgegeben wurden, die eingehenden `TRACEPARENT` IDs statt der Span-IDs. Vor v2.1.212 trugen Ereignis-Datensätze, die außerhalb eines aktiven Spans ausgegeben wurden, keine `trace_id` oder `span_id`.199Ein Record, der ausgegeben wird, während eine Interaktion aktiv ist, trägt die IDs des Interaktions-Spans, auch wenn Claude Code ihn außerhalb des asynchronen Kontexts des Spans ausgibt, z.B. in einem Berechtigungsprompt-Callback oder für einen Record, der während des Starts gepuffert und später exportiert wird. Ein Record, der ohne aktiven Interaktions-Span ausgegeben wird, trägt die eingehenden `TRACEPARENT`-IDs direkt. Vor v2.1.214 trugen Records, die außerhalb des asynchronen Kontexts des Spans ausgegeben wurden, stattdessen die eingehenden `TRACEPARENT`-IDs. Vor v2.1.212 trugen Ereignis-Records, die außerhalb eines aktiven Spans ausgegeben wurden, keine `trace_id` oder `span_id`.

200 200

201<h4 id="span-hierarchy">201<h4 id="span-hierarchy">

202 Span-Hierarchie202 Span-Hierarchie

203</h4>203</h4>

204 204

205Jeder Benutzer-Prompt startet einen `claude_code.interaction` Root-Span. API-Aufrufe, Tool-Aufrufe und Hook-Ausführungen werden als untergeordnete Elemente aufgezeichnet. Tool-Spans haben zwei untergeordnete Spans: einen für die Zeit, die auf eine Berechtigungsentscheidung gewartet wird, und einen für die Ausführung selbst. Wenn das Agent-Tool oder das veraltete Task-Tool einen Subagenten erzeugt, werden die API- und Tool-Spans des Subagenten unter dem `claude_code.tool`-Span des übergeordneten Elements verschachtelt.205Jeder Benutzer-Prompt startet einen `claude_code.interaction`-Root-Span. API-Aufrufe, Tool-Aufrufe und Hook-Ausführungen werden als seine Kinder aufgezeichnet. Tool-Spans haben zwei untergeordnete Spans: einen für die Zeit, die auf eine Berechtigungsentscheidung gewartet wird, und einen für die Ausführung selbst. Wenn das Agent-Tool oder das Legacy-Task-Tool einen Subagenten spawnt, verschachteln sich die API- und Tool-Spans des Subagenten unter dem `claude_code.tool`-Span des Elternteils.

206 206

207```text theme={null}207```text theme={null}

208claude_code.interaction208claude_code.interaction

209├── claude_code.llm_request209├── claude_code.llm_request

210├── claude_code.hook (erfordert detailliertes Beta-Tracing)210├── claude_code.hook (requires detailed beta tracing)

211└── claude_code.tool211└── claude_code.tool

212 ├── claude_code.tool.blocked_on_user212 ├── claude_code.tool.blocked_on_user

213 ├── claude_code.tool.execution213 ├── claude_code.tool.execution

214 └── (Agent-Tool) Subagent claude_code.llm_request / claude_code.tool Spans214 └── (Agent tool) subagent claude_code.llm_request / claude_code.tool spans

215```215```

216 216

217In Agent SDK und `claude -p` Sitzungen wird `claude_code.interaction` selbst ein untergeordnetes Element des Aufrufers-Spans, wenn `TRACEPARENT` in der Umgebung gesetzt ist.217In Agent SDK und `claude -p`-Sitzungen wird `claude_code.interaction` selbst ein Kind des Aufrufers-Spans, wenn `TRACEPARENT` in der Umgebung gesetzt ist.

218 218

219Wenn ein `PreToolUse` Hook [einen Tool-Aufruf aufschiebt](/docs/de/hooks#defer-a-tool-call-for-later), speichert Claude Code den Trace-Kontext des Durchgangs, der ihn aufgeschoben hat. Wenn Sie die Sitzung fortsetzen und das Tool erneut ausgeführt wird, treten die Spans des Tools diesem früheren Durchgang's Trace als untergeordnete Elemente des Durchgangs's `claude_code.interaction` Spans bei.219Wenn ein `PreToolUse`-Hook [einen Tool-Aufruf aufschiebt](/docs/de/hooks#defer-a-tool-call-for-later), speichert Claude Code den Trace-Kontext des Turns, der ihn aufgeschoben hat. Wenn Sie die Sitzung fortsetzen und das Tool erneut ausgeführt wird, verbinden sich die Spans des Tools mit dem früheren Turn-Trace als Kinder des `claude_code.interaction`-Spans des Turns.

220 220

221<h4 id="span-attributes">221<h4 id="span-attributes">

222 Span-Attribute222 Span-Attribute

223</h4>223</h4>

224 224

225Jeder Span trägt die [Standardattribute](#standard-attributes) plus ein `span.type`-Attribut, das seinem Namen entspricht. Die folgenden Tabellen listen die zusätzlichen Attribute auf, die auf jedem Span gesetzt sind. Die Spans `llm_request`, `tool.execution` und `hook` setzen OpenTelemetry-Status `ERROR`, wenn sie einen Fehler aufzeichnen; die anderen Spans enden immer mit Status `UNSET`.225Jeder Span trägt die [Standard-Attribute](#standard-attributes) plus ein `span.type`-Attribut, das seinem Namen entspricht. Die folgenden Tabellen listen die zusätzlichen Attribute auf, die auf jedem Span gesetzt sind. Die `llm_request`-, `tool.execution`- und `hook`-Spans setzen OpenTelemetry-Status `ERROR`, wenn sie einen Fehler aufzeichnen; die anderen Spans enden immer mit Status `UNSET`.

226 226

227**`claude_code.interaction`**227**`claude_code.interaction`**

228 228

230| - | - | - |230| - | - | - |

233| `interaction.sequence` | 1-basierter Zähler von Interaktionen, gezählt pro Claude Code Prozess statt pro Sitzung, wie für [`event.sequence`](#event-correlation-attributes) beschrieben | |233| `interaction.sequence` | 1-basierter Zähler von Interaktionen, gezählt pro Claude Code-Prozess statt pro Sitzung, wie für [`event.sequence`](#event-correlation-attributes) beschrieben | |

234| `parent.source` | Wie der Span seinen Trace-Parent erhielt: `env`, wenn er unter einem eingehenden `TRACEPARENT` verschachtelt wurde, `none`, wenn er seine eigene Trace gestartet hat. Erfordert Claude Code v2.1.268 oder später | |234| `parent.source` | Wie der Span seinen Trace-Parent bekam: `env`, wenn er unter einem eingehenden `TRACEPARENT` übergeordnet war, `none`, wenn er seine eigene Trace startete. Erfordert Claude Code v2.1.268 oder später | |

236 236

237**`claude_code.llm_request`**237**`claude_code.llm_request`**

238 238

240| - | - | - |240| - | - | - |

245| `query_source_safe` | Begrenzte Form von `query_source`, ausgegeben, ob detailliertes Beta-Tracing aktiv ist oder nicht, mit Werten wie `repl_main_thread` oder `agent.builtin.general-purpose`. `:` wird zu `.` und benutzerdefinierte Agenten erscheinen als `agent.custom`. Erfordert Claude Code v2.1.268 oder später | |245| `query_source_safe` | Begrenzte Form von `query_source`, ausgegeben, ob detailliertes Beta-Tracing aktiv ist oder nicht, mit Werten wie `repl_main_thread` oder `agent.builtin.general-purpose`. `:` wird zu `.` und benutzerdefinierte Agenten erscheinen als `agent.custom`. Erfordert Claude Code v2.1.268 oder später | |

247| `parent_agent_id` | Kennung des Agenten, der diesen erzeugt hat. Fehlt für die Hauptsitzung und für Agenten, die direkt von ihr erzeugt wurden | |247| `parent_agent_id` | Kennung des Agenten, der diesen spawnt hat. Fehlt bei der Hauptsitzung und für Agenten, die direkt von ihr spawnt wurden | |

248| `workflow.run_id` | Run-Kennung des [Workflow](/docs/de/workflows) Tool-Durchlaufs, der diesen Agenten erzeugt hat, mit dem Präfix `wf_`. Fehlt für Agenten, die nicht durch einen Workflow erzeugt wurden | |248| `workflow.run_id` | Run-Kennung des [Workflow](/docs/de/workflows)-Tool-Runs, der diesen Agenten spawnt hat, mit Präfix `wf_`. Fehlt für Agenten, die nicht von einem Workflow spawnt wurden | |

249| `workflow.name` | Name des Workflows, der diesen Agenten erzeugt hat. Benutzerdefinierte Namen werden durch `custom` ersetzt, es sei denn, das Gate ist gesetzt | `OTEL_LOG_TOOL_DETAILS` |249| `workflow.name` | Name des Workflows, der diesen Agenten spawnt hat. Benutzerdefinierte Namen werden durch `custom` ersetzt, es sei denn, das Gate ist gesetzt | `OTEL_LOG_TOOL_DETAILS` |

251| `effort` | [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) auf die Anfrage angewendet: `low`, `medium`, `high`, `xhigh` oder `max`. Fehlt, wenn Claude Code keine Anstrengungsstufe sendet, zum Beispiel auf einem Modell, das Anstrengung nicht unterstützt. Erfordert Claude Code v2.1.274 oder später | |251| `effort` | [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `low`, `medium`, `high`, `xhigh` oder `max`. Fehlt, wenn Claude Code keine Anstrengungsstufe sendet, z.B. bei einem Modell, das Anstrengung nicht unterstützt. Erfordert Claude Code v2.1.274 oder später | |

255| `first_content_ms` | Zeit vom Anfrageanfang bis zum ersten Inhaltsblock des erfolgreichen Versuchs, in Millisekunden. Fehlt bei Anfragen, die auf den nicht-Streaming-Pfad zurückgegriffen haben. Erfordert Claude Code v2.1.268 oder später | |255| `first_content_ms` | Zeit vom Anfrageanfang bis zum ersten Inhaltsblock des erfolgreichen Versuchs in Millisekunden. Fehlt bei Anfragen, die auf den nicht-Streaming-Pfad zurückfielen. Erfordert Claude Code v2.1.268 oder später | |

267| `error_class` | Kurzes Fehlerklassen-Token, wenn die Anfrage fehlgeschlagen ist, wie `api_timeout` oder `server_overload`. Erfordert Claude Code v2.1.268 oder später | |267| `error_class` | Kurzes Fehlerklassen-Token, wenn die Anfrage fehlgeschlagen ist, z.B. `api_timeout` oder `server_overload`. Erfordert Claude Code v2.1.268 oder später | |

269| `stop_reason` | API-Antwort `stop_reason`, wie `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` oder `refusal` | |269| `stop_reason` | API-Response `stop_reason`, z.B. `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` oder `refusal` | |

270| `gen_ai.response.finish_reasons` | Gleicher Wert wie `stop_reason`, in einem String-Array verpackt. OpenTelemetry GenAI semantische Konvention | |270| `gen_ai.response.finish_reasons` | Gleicher Wert wie `stop_reason`, in einem String-Array verpackt. OpenTelemetry GenAI-Semantik-Konvention | |

271 271

272Jeder Wiederholungsversuch wird auch als `gen_ai.request.attempt` Span-Ereignis mit `attempt` und `client_request_id` Attributen aufgezeichnet.272Jeder Wiederholungsversuch wird auch als `gen_ai.request.attempt` Span-Ereignis mit `attempt` und `client_request_id`-Attributen aufgezeichnet.

273 273

274**`claude_code.tool`**274**`claude_code.tool`**

275 275

277| - | - | - |277| - | - | - |

279| `tool_name_safe` | Form von `tool_name`, die keine benutzerdefinierte Namen trägt. Integrierte Tool-Namen werden wörtlich weitergegeben. MCP-Tool-Namen erscheinen als `mcp_other`, außer Tool-Namen, die bestimmte feste Formen entsprechen, wie `playwright` Tools mit dem Namen `browser_*`, die wörtlich weitergegeben werden. Erfordert Claude Code v2.1.268 oder später | |279| `tool_name_safe` | Form von `tool_name`, die keine benutzerdefinierte Namen trägt. Integrierte Tool-Namen werden wörtlich weitergegeben. MCP-Tool-Namen erscheinen als `mcp_other`, außer Tool-Namen, die bestimmte feste Formen entsprechen, wie `playwright`-Tools mit Namen `browser_*`, die wörtlich weitergegeben werden. Erfordert Claude Code v2.1.268 oder später | |

280| `bash_command_class` | Für das Bash-Tool: Kategorie des ersten Programms des Befehls aus einer festen Liste, wie `vcs` oder `package_manager`. `other` für ein Programm außerhalb der Liste, `unparsed`, wenn die Zeile nicht geparst werden kann. Erfordert Claude Code v2.1.268 oder später | |280| `bash_command_class` | Für das Bash-Tool: Kategorie des ersten Programms des Befehls aus einer festen Liste, z.B. `vcs` oder `package_manager`. `other` für ein Programm außerhalb der Liste, `unparsed`, wenn die Zeile nicht geparst werden kann. Erfordert Claude Code v2.1.268 oder später | |

281| `bash_argv0` | Für das Bash-Tool: das erste Programm des Befehls, wenn es sich auf der gleichen festen Liste befindet, wie `git` oder `npm`. `other` für jedes Programm außerhalb der Liste. Erfordert Claude Code v2.1.268 oder später | |281| `bash_argv0` | Für das Bash-Tool: das erste Programm des Befehls, wenn es auf der gleichen festen Liste ist, z.B. `git` oder `npm`. `other` für jedes Programm außerhalb der Liste. Erfordert Claude Code v2.1.268 oder später | |

285| `parent_agent_id` | Kennung des Agenten, der diesen erzeugt hat. Fehlt für die Hauptsitzung und für Agenten, die direkt von ihr erzeugt wurden | |285| `parent_agent_id` | Kennung des Agenten, der diesen spawnt hat. Fehlt bei der Hauptsitzung und für Agenten, die direkt von ihr spawnt wurden | |

286| `workflow.run_id` | Run-Kennung des Workflow-Tool-Durchlaufs, der diesen Agenten erzeugt hat, mit dem Präfix `wf_`. Fehlt für Agenten, die nicht durch einen Workflow erzeugt wurden | |286| `workflow.run_id` | Run-Kennung des Workflow-Tool-Runs, der diesen Agenten spawnt hat, mit Präfix `wf_`. Fehlt für Agenten, die nicht von einem Workflow spawnt wurden | |

287| `workflow.name` | Name des Workflows, der diesen Agenten erzeugt hat. Benutzerdefinierte Namen werden durch `custom` ersetzt, es sei denn, das Gate ist gesetzt | `OTEL_LOG_TOOL_DETAILS` |287| `workflow.name` | Name des Workflows, der diesen Agenten spawnt hat. Benutzerdefinierte Namen werden durch `custom` ersetzt, es sei denn, das Gate ist gesetzt | `OTEL_LOG_TOOL_DETAILS` |

288| `tool_use_id` | Die Modell-`tool_use` Block-ID für diesen Aufruf. Entspricht der `tool_use_id` bei den [tool\_result](#tool-result-event) und [tool\_decision](#tool-decision-event) Ereignissen und in Hook-Payloads, sodass Sie den Span mit diesen Datensätzen verknüpfen können | |288| `tool_use_id` | Die Modell-`tool_use`-Block-ID für diesen Aufruf. Entspricht der `tool_use_id` bei den [tool\_result](#tool-result-event) und [tool\_decision](#tool-decision-event)-Ereignissen und in Hook-Payloads, damit Sie den Span mit diesen Records verbinden können | |

294 294

295<span id="tool-output-span-event" />**`tool.output` Span-Ereignis auf `claude_code.tool`**295<span id="tool-output-span-event" />**`tool.output` Span-Ereignis auf `claude_code.tool`**

296 296

297Wenn Sie `OTEL_LOG_TOOL_CONTENT=1` setzen, können Read- und Bash-Aufrufe ein `tool.output` Span-Ereignis auf dem `claude_code.tool` Span aufzeichnen. Edit- und Write-Aufrufe zeichnen eines nur auf, wenn Sie auch `OTEL_LOG_TOOL_DETAILS=1` setzen. Diese Variable ist nicht auf diese beiden Tools beschränkt, daher überprüfen Sie ihre [Zeile in der Konfigurationstabelle](#common-configuration-variables) für die Argumente, die sie an anderer Stelle hinzufügt.297Wenn Sie `OTEL_LOG_TOOL_CONTENT=1` setzen, können Read- und Bash-Aufrufe ein `tool.output` Span-Ereignis auf dem `claude_code.tool` Span aufzeichnen. Edit- und Write-Aufrufe zeichnen eines nur auf, wenn Sie auch `OTEL_LOG_TOOL_DETAILS=1` setzen. Diese Variable ist nicht auf diese beiden Tools beschränkt, daher überprüfen Sie ihre [Zeile in der Konfigurationstabelle](#common-configuration-variables) für die Argumente, die sie an anderer Stelle hinzufügt.

298 298

299Claude Code schreibt dieses Ereignis aus einer erfolgreichen Rückgabe eines Tool-Aufrufs, daher zeichnet ein Aufruf, der einen Fehler auslöst, nichts auf, unabhängig vom Tool. Unter den Aufrufen, die zurückgeben, zeichnet es kein `tool.output` Ereignis auf für:299MCP-Tools, WebFetch und WebSearch zeichnen dieses Ereignis auch auf, auf Claude Code v2.1.283 oder später.

300 300

301* Ein Aufruf an ein anderes Tool als Read, Edit, Write und Bash, einschließlich MCP-Tools und WebFetch301Claude Code schreibt dieses Ereignis aus einer erfolgreichen Rückkehr eines Tool-Aufrufs, daher zeichnet ein Aufruf, der einen Fehler auslöst, nichts auf, unabhängig vom Tool. Unter den Aufrufen, die zurückkehren, zeichnet es kein `tool.output`-Ereignis auf für:

302* Ein Read, das etwas anderes als Dateitext zurückgibt, wie ein Bild, ein PDF oder ein erneutes Lesen einer Datei, deren Inhalte sich nicht geändert haben302

303* Ein Aufruf an ein anderes Tool als Read, Edit, Write, Bash, WebFetch, WebSearch und MCP-Tools

304* Ein Read, das etwas anderes als Dateitext zurückgibt, z.B. ein Bild, ein PDF oder ein erneutes Lesen einer Datei, deren Inhalte sich nicht geändert haben

303* Ein Edit- oder Write-Aufruf, es sei denn, Sie setzen auch `OTEL_LOG_TOOL_DETAILS=1`305* Ein Edit- oder Write-Aufruf, es sei denn, Sie setzen auch `OTEL_LOG_TOOL_DETAILS=1`

306* Ein WebFetch- oder WebSearch-Aufruf, den Claude Code in den Hintergrund verschoben hat, weil Sie den Turn unterbrochen haben, um [Ihre warteschlangen Nachrichten sofort zu senden](/docs/de/interactive-mode#when-claude-code-sends-what-you-queued), während der Aufruf lief. Claude erhält dieses Ergebnis später, nachdem der Tool-Span beendet wurde

304 307

305Das Ereignis trägt diese Attribute, jeweils gekürzt bei der Inhaltsbegrenzung (Standard: 60 KB). `Gated durch` nennt die Variable, die ein Attribut zusätzlich zu `OTEL_LOG_TOOL_CONTENT=1` benötigt, und für Edit und Write gated diese Variable das Ereignis selbst statt des Attributs.308Das Ereignis trägt diese Attribute, jeweils gekürzt auf das Inhaltslimit (Standard 60 KB). `Gated by` nennt die Variable, die ein Attribut zusätzlich zu `OTEL_LOG_TOOL_CONTENT=1` benötigt, und für Edit und Write gated diese Variable das Ereignis selbst statt des Attributs.

306 309

308| - | - | - |311| - | - | - |

309| `content` | Text, den das Read-Tool zurückgegeben hat, oder Text, den ein Write-Aufruf aufgefordert wurde zu schreiben | `OTEL_LOG_TOOL_DETAILS` für das Write-Tool |312| `content` | Text, den das Read-Tool zurückgegeben hat, oder Text, den ein Write-Aufruf aufgefordert wurde zu schreiben | `OTEL_LOG_TOOL_DETAILS` für das Write-Tool |

310| `output` | Kombinierte Ausgabe eines Bash-Befehls, mit stderr in stdout verschachtelt | |313| `output` | Für das Bash-Tool die kombinierte Ausgabe des Befehls mit Stderr in Stdout verschachtelt. Für ein MCP-Tool, WebFetch oder WebSearch das Ergebnis, das das Tool zurückgegeben hat: Text-Blöcke durch Zeilenumbrüche verbunden, mit einem Bild oder Dokument ersetzt durch einen Platzhalter wie `[image]` | |

314 317

315Das `tool_name` Attribut des übergeordneten Spans sagt Ihnen, von welchem Tool ein Ereignis stammt. Ein Attribut, das bei der Inhaltsbegrenzung gekürzt wird, wird von `<attribute>_truncated` und `<attribute>_original_length` begleitet.318Das `tool_name`-Attribut des übergeordneten Spans sagt Ihnen, von welchem Tool ein Ereignis kam. Ein Attribut, das auf das Inhaltslimit gekürzt ist, wird von `<attribute>_truncated` und `<attribute>_original_length` begleitet.

316 319

317**`claude_code.tool.blocked_on_user`**320**`claude_code.tool.blocked_on_user`**

318 321

320| - | - | - |323| - | - | - |

324 327

325**`claude_code.tool.execution`**328**`claude_code.tool.execution`**

326 329

328| - | - | - |331| - | - | - |

333| `error` | Fehler-Kategoriezeichenkette, wenn die Ausführung fehlgeschlagen ist, wie `Error:ENOENT` oder `ShellError`. Enthält die vollständige Fehlermeldung, wenn das Gate gesetzt ist | `OTEL_LOG_TOOL_DETAILS` |336| `error` | Fehler-Kategorie-String, wenn die Ausführung fehlgeschlagen ist, z.B. `Error:ENOENT` oder `ShellError`. Enthält die vollständige Fehlermeldung statt, wenn das Gate gesetzt ist | `OTEL_LOG_TOOL_DETAILS` |

334| `error_class` | Die Fehlerklasse in Identifierform, mit Zeichen außerhalb von Buchstaben, Ziffern und Unterstrichen ersetzt durch `_`, wie `Error_ENOENT` oder `ShellError`. Trägt die Kategorie auch, wenn `error` die vollständige Meldung trägt. Erfordert Claude Code v2.1.268 oder später | |337| `error_class` | Die Fehler-Kategorie in Identifikator-Form, mit Zeichen außerhalb von Buchstaben, Ziffern und Unterstrichen ersetzt durch `_`, z.B. `Error_ENOENT` oder `ShellError`. Trägt die Kategorie auch, wenn `error` die vollständige Meldung trägt. Erfordert Claude Code v2.1.268 oder später | |

335 338

336**`claude_code.hook`**339**`claude_code.hook`**

337 340

338Dieser Span wird nur ausgegeben, wenn detailliertes Beta-Tracing aktiv ist, was `ENABLE_BETA_TRACING_DETAILED=1` und `BETA_TRACING_ENDPOINT` erfordert, ein Paar, das auch [ändert, wohin Ihre Logs und Traces gehen](/docs/de/env-vars#variables). Setzen Sie das Paar in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen; beide Variablen werden in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` allein erzeugt es nicht.341Dieser Span erscheint nur, wenn detailliertes Beta-Tracing aktiv ist, was `ENABLE_BETA_TRACING_DETAILED=1` und `BETA_TRACING_ENDPOINT` erfordert, ein Paar, das auch [ändert, wohin Ihre Protokolle und Traces gehen](/docs/de/env-vars#variables). Setzen Sie das Paar in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen; beide Variablen werden in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` allein produziert es nicht.

339 342

340In interaktiven CLI-Sitzungen erfordert detailliertes Beta-Tracing auch, dass Ihre Organisation für die Funktion auf die Whitelist gesetzt ist. Agent SDK und nicht-interaktive `-p` Sitzungen erfordern keine Whitelist.343In interaktiven CLI-Sitzungen erfordert detailliertes Beta-Tracing auch, dass Ihre Organisation für die Funktion auf die Whitelist gesetzt ist. Agent SDK und nicht-interaktive `-p`-Sitzungen erfordern keine Whitelist.

341 344

343| - | - | - |346| - | - | - |

354<span id="new-context-gates" />357<span id="new-context-gates" />

355 358

356<Note>359<Note>

357 Zusätzliche inhaltshaltige Attribute wie `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` und `response.model_output` werden nur ausgegeben, wenn detailliertes Beta-Tracing aktiv ist. Sie sind nicht Teil des stabilen Span-Schemas.360 Zusätzliche inhaltstragende Attribute wie `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` und `response.model_output` werden nur ausgegeben, wenn detailliertes Beta-Tracing aktiv ist. Sie sind nicht Teil des stabilen Span-Schemas.

358 361

359 Das Gate auf `new_context` hängt davon ab, welcher Span es trägt, und jede Kopie wird bei der Inhaltsbegrenzung gekürzt (Standard: 60 KB). Auf dem `claude_code.tool` Span trägt es das Ergebnis dieses Tool-Aufrufs, unabhängig vom Tool, und erfordert `OTEL_LOG_TOOL_CONTENT=1`. Auf dem `claude_code.interaction` Span trägt es den Benutzer-Prompt, und auf dem `claude_code.llm_request` Span die neuen Benutzer-Nachrichten und Tool-Ergebnisse dieser Anfrage. Beide erfordern `OTEL_LOG_USER_PROMPTS=1`.362 Das Gate auf `new_context` hängt davon ab, welcher Span es trägt, und jede Kopie wird auf das Inhaltslimit gekürzt (Standard 60 KB). Auf dem `claude_code.tool` Span trägt es das Ergebnis dieses Tool-Aufrufs, unabhängig vom Tool, und erfordert `OTEL_LOG_TOOL_CONTENT=1`. Auf dem `claude_code.interaction` Span trägt es den Benutzer-Prompt, und auf dem `claude_code.llm_request` Span die neuen Benutzer-Nachrichten und Tool-Ergebnisse dieser Anfrage. Beide erfordern `OTEL_LOG_USER_PROMPTS=1`.

360 363

361 `user_system_prompt` erfordert zusätzlich `OTEL_LOG_USER_PROMPTS=1`. Es trägt nur den System-Prompt-Text, den Sie über die `systemPrompt` SDK-Option oder die Flags `--system-prompt` und `--append-system-prompt` bereitstellen, gekürzt bei der Inhaltsbegrenzung (Standard: 60 KB), und wird einmal pro Sitzung statt pro Anfrage ausgegeben.364 `user_system_prompt` erfordert zusätzlich `OTEL_LOG_USER_PROMPTS=1`. Es trägt nur den System-Prompt-Text, den Sie über die `systemPrompt` SDK-Option oder `--system-prompt` und `--append-system-prompt`-Flags bereitstellen, gekürzt auf das Inhaltslimit (Standard 60 KB), und wird einmal pro Sitzung statt pro Anfrage ausgegeben.

362</Note>365</Note>

363 366

364<h3 id="dynamic-headers">367<h3 id="dynamic-headers">

365 Dynamische Header368 Dynamische Header

366</h3>369</h3>

367 370

368Für Unternehmensumgebungen, die eine dynamische Authentifizierung erfordern, können Sie ein Skript konfigurieren, um Header dynamisch zu generieren. Dynamische Header gelten nur für die Protokolle `http/protobuf` und `http/json`. Mit dem `grpc` Protokoll verwendet Claude Code nur die statischen Header-Variablen, `OTEL_EXPORTER_OTLP_HEADERS` und seine signalspezifischen Varianten.371Für Unternehmensumgebungen, die dynamische Authentifizierung erfordern, können Sie ein Script konfigurieren, um Header dynamisch zu generieren. Dynamische Header gelten nur für die Protokolle `http/protobuf` und `http/json`. Mit dem `grpc`-Protokoll verwendet Claude Code nur die statischen Header-Variablen, `OTEL_EXPORTER_OTLP_HEADERS` und ihre signalspezifischen Varianten.

369 372

370<h4 id="settings-configuration">373<h4 id="settings-configuration">

371 Einstellungskonfiguration374 Einstellungskonfiguration

372</h4>375</h4>

373 376

374Fügen Sie zu Ihrer `.claude/settings.json` hinzu, ersetzen Sie den Pfad durch Ihren eigenen Skript:377Fügen Sie zu Ihrer `.claude/settings.json` hinzu, ersetzen Sie den Pfad durch Ihren eigenen Script:

375 378

376```json theme={null}379```json theme={null}

377{380{

382Der Wert kann der Pfad zu einer ausführbaren Datei sein, einschließlich eines Pfads, der Leerzeichen enthält, oder eine Shell-Befehlszeile mit Argumenten. Unter Windows wird der Wert immer durch die Shell ausgeführt, daher setzen Sie einen Pfad, der Leerzeichen enthält, in Anführungszeichen innerhalb des JSON-Werts.385Der Wert kann der Pfad zu einer ausführbaren Datei sein, einschließlich eines Pfads, der Leerzeichen enthält, oder eine Shell-Befehlszeile mit Argumenten. Unter Windows wird der Wert immer durch die Shell ausgeführt, daher setzen Sie einen Pfad, der Leerzeichen enthält, in Anführungszeichen innerhalb des JSON-Werts.

383 386

384<h4 id="script-requirements">387<h4 id="script-requirements">

385 Skriptanforderungen388 Script-Anforderungen

386</h4>389</h4>

387 390

388Das Skript muss gültiges JSON mit Zeichenketten-Schlüssel-Wert-Paaren ausgeben, die HTTP-Header darstellen:391Das Script muss gültiges JSON mit String-Schlüssel-Wert-Paaren ausgeben, die HTTP-Header darstellen:

389 392

390```bash theme={null}393```bash theme={null}

391#!/bin/bash394#!/bin/bash

393echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"396echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

394```397```

395 398

396Wenn das Helper-Skript fehlschlägt oder eine Ausgabe druckt, die diese Anforderungen nicht erfüllt, exportiert Claude Code nicht und Ihr Telemetrie-Backend erhält nichts aus der Sitzung, bis das Helper-Skript wieder funktioniert. Claude Code meldet den Fehler in:399Wenn der Helper fehlschlägt oder Ausgabe druckt, die diese Anforderungen nicht erfüllt, schlagen Exporte fehl und Ihr Telemetrie-Backend erhält nichts aus der Sitzung, bis der Helper wieder funktioniert. Claude Code meldet den Fehler in:

397 400

398* Eine Warnbenachrichtigung in interaktiven Sitzungen, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/de/errors#otelheadershelper-failed), wird einmal pro Sitzung angezeigt, wenn das Helper-Skript zuerst fehlschlägt401* Eine Warnbenachrichtigung in interaktiven Sitzungen, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/de/errors#otelheadershelper-failed), einmal pro Sitzung angezeigt, wenn der Helper zuerst fehlschlägt

399* `/status` Ausgabe402* `/status`-Ausgabe

400* Das Debug-Log, wenn Sie mit [`--debug`](/docs/de/cli-reference#cli-flags) ausführen oder nach dem Ausführen von `/debug` in der Sitzung403* Das Debug-Protokoll, wenn mit [`--debug`](/docs/de/cli-reference#cli-flags) ausgeführt oder nach Ausführung von `/debug` in der Sitzung

401* stderr, in nicht-interaktiven Sitzungen, die mit `-p` gestartet werden404* stderr, in nicht-interaktiven Sitzungen, die mit `-p` gestartet werden

402 405

403<h4 id="refresh-behavior">406<h4 id="refresh-behavior">

404 Aktualisierungsverhalten407 Aktualisierungsverhalten

405</h4>408</h4>

406 409

407Das Headers-Helper-Skript wird beim Start und danach regelmäßig ausgeführt, um Token-Aktualisierung zu unterstützen. Standardmäßig wird das Skript alle 29 Minuten ausgeführt. Passen Sie das Intervall mit der Umgebungsvariable `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` an.410Das Headers-Helper-Script wird beim Start und danach regelmäßig ausgeführt, um Token-Aktualisierung zu unterstützen. Standardmäßig wird das Script alle 29 Minuten ausgeführt. Passen Sie das Intervall mit der Umgebungsvariable `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` an.

408 411

409<h3 id="multi-team-organization-support">412<h3 id="multi-team-organization-support">

410 Unterstützung für Multi-Team-Organisationen413 Multi-Team-Organisationsunterstützung

411</h3>414</h3>

412 415

413Organisationen mit mehreren Teams oder Abteilungen können benutzerdefinierte Attribute hinzufügen, um zwischen verschiedenen Gruppen zu unterscheiden, indem sie die Umgebungsvariable `OTEL_RESOURCE_ATTRIBUTES` verwenden:416Organisationen mit mehreren Teams oder Abteilungen können benutzerdefinierte Attribute hinzufügen, um zwischen verschiedenen Gruppen zu unterscheiden, indem sie die Umgebungsvariable `OTEL_RESOURCE_ATTRIBUTES` verwenden:

414 417

415```bash theme={null}418```bash theme={null}

416# Benutzerdefinierte Attribute für Team-Identifikation hinzufügen419# Fügen Sie benutzerdefinierte Attribute für Team-Identifikation hinzu

417export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"420export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

418```421```

419 422

420Diese benutzerdefinierten Attribute werden in alle Metriken und Ereignisse einbezogen, sodass Sie:423Diese benutzerdefinierten Attribute sind in allen Metriken und Ereignissen enthalten, sodass Sie:

421 424

422* Metriken nach Team oder Abteilung filtern können425* Metriken nach Team oder Abteilung filtern können

423* Kosten pro Kostenstelle verfolgen können426* Kosten pro Kostenstelle verfolgen können

424* Team-spezifische Dashboards erstellen können427* Team-spezifische Dashboards erstellen können

425* Warnungen für bestimmte Teams einrichten können428* Warnungen für bestimmte Teams einrichten können

426 429

427Claude Code fügt diese Werte als Attribute auf jedem Metrik-Datenpunkt und Ereignisdatensatz an, zusätzlich zum Senden im OTLP-Ressourcenblock. Da die meisten Metriken-Backends Datenpunkt-Attribute als abfragbare Labels verfügbar machen, können Sie Metriken direkt nach Ihren benutzerdefinierten Schlüsseln gruppieren und filtern. Außer für die `vcs.*` [Repository-Attribute](#repository-attributes) überschreiben benutzerdefinierte Schlüssel niemals die [Standardattribute](#standard-attributes) wie `user.id` oder `session.id`: Wenn ein Schlüssel kollidiert, behält Claude Code den integrierten Wert.430Claude Code fügt diese Werte als Attribute auf jedem Metrik-Datenpunkt und Ereignis-Record an, zusätzlich zum Senden im OTLP-Ressourcenblock. Da die meisten Metriken-Backends Datenpunkt-Attribute als abfragbare Labels verfügbar machen, können Sie Metriken direkt nach Ihren benutzerdefinierten Schlüsseln gruppieren und filtern. Mit Ausnahme der `vcs.*` [Repository-Attribute](#repository-attributes) überschreiben benutzerdefinierte Schlüssel niemals die [Standard-Attribute](#standard-attributes) wie `user.id` oder `session.id`: wenn ein Schlüssel kollidiert, behält Claude Code den integrierten Wert.

428 431

429Jeder benutzerdefinierte Schlüssel wird zu einem Label auf jeder Metrik-Serie, daher erhöhen hochkardinalige Werte die Speicherkosten in Ihrem Metriken-Backend. Um benutzerdefinierte Attribute nur im Ressourcenblock zu senden und sie von Datenpunkt-Labels auszulassen, setzen Sie `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Siehe [Metriken-Kardinalitätskontrolle](#metrics-cardinality-control).432Jeder benutzerdefinierte Schlüssel wird zu einem Label auf jeder Metrik-Serie, daher erhöhen hochkardinalitäts-Werte die Speicherkosten in Ihrem Metriken-Backend. Um benutzerdefinierte Attribute nur im Ressourcenblock zu senden und sie von Datenpunkt-Labels auszulassen, setzen Sie `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Siehe [Metriken-Kardinalitätskontrolle](#metrics-cardinality-control).

430 433

431<Warning>434<Warning>

432 Die Umgebungsvariable `OTEL_RESOURCE_ATTRIBUTES` verwendet kommagetrennte Schlüssel=Wert-Paare mit strikten Formatierungsanforderungen:435 Die Umgebungsvariable `OTEL_RESOURCE_ATTRIBUTES` verwendet kommagetrennte Schlüssel=Wert-Paare mit strikten Formatierungsanforderungen:

433 436

434 * **Keine Leerzeichen erlaubt**: Werte dürfen keine Leerzeichen enthalten. Zum Beispiel ist `user.organizationName=My Company` ungültig437 * **Keine Leerzeichen erlaubt**: Werte können keine Leerzeichen enthalten. Zum Beispiel ist `user.organizationName=My Company` ungültig

435 * **Format**: Muss kommagetrennte Schlüssel=Wert-Paare sein: `key1=value1,key2=value2`438 * **Format**: muss kommagetrennte Schlüssel=Wert-Paare sein: `key1=value1,key2=value2`

436 * **Zulässige Zeichen**: Nur US-ASCII-Zeichen ohne Steuerzeichen, Leerzeichen, doppelte Anführungszeichen, Kommas, Semikola und Backslashes439 * **Erlaubte Zeichen**: nur US-ASCII-Zeichen ohne Steuerzeichen, Leerzeichen, doppelte Anführungszeichen, Kommas, Semikola und Backslashes

437 * **Sonderzeichen**: Zeichen außerhalb des zulässigen Bereichs müssen prozentcodiert sein440 * **Sonderzeichen**: Zeichen außerhalb des erlaubten Bereichs müssen prozentcodiert sein

438 441

439 Für einen Wert, der ein Leerzeichen benötigen würde, verwenden Sie stattdessen Unterstriche oder camelCase. Die folgenden Beispiele setzen `org.name` mit jeder Form:442 Für einen Wert, der ein Leerzeichen benötigen würde, verwenden Sie stattdessen Unterstriche oder camelCase. Die folgenden Beispiele setzen `org.name` mit jeder Form:

440 443

449 export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"452 export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

450 ```453 ```

451 454

452 Das Einschließen von Werten in Anführungszeichen entkommt keine Leerzeichen. Zum Beispiel führt `org.name="My Company"` zum Literalwert `"My Company"` mit den Anführungszeichen enthalten, nicht zu `My Company`.455 Das Umhüllen von Werten in Anführungszeichen entgeht nicht Leerzeichen. Zum Beispiel führt `org.name="My Company"` zum Literalwert `"My Company"` mit den Anführungszeichen enthalten, nicht `My Company`.

453</Warning>456</Warning>

454 457

455<h3 id="example-configurations">458<h3 id="example-configurations">

456 Beispielkonfigurationen459 Beispielkonfigurationen

457</h3>460</h3>

458 461

459Setzen Sie diese Umgebungsvariablen vor dem Ausführen von `claude`. Jedes Szenario unten zeigt eine vollständige Konfiguration, und jede Variable wird unter [Allgemeine Konfigurationsvariablen](#common-configuration-variables) beschrieben. Um zu bestätigen, dass eine Konfiguration wirksam wurde, überprüfen Sie Ihr Backend auf die `claude_code.session.count` Metrik nach dem Starten einer Sitzung; der [Schnellstart](#quick-start) behandelt Logs-only-Verifizierung und was zu überprüfen ist, wenn nichts ankommt.462Setzen Sie diese Umgebungsvariablen vor dem Ausführen von `claude`. Jedes Szenario unten zeigt eine vollständige Konfiguration, und jede Variable wird unter [Allgemeine Konfigurationsvariablen](#common-configuration-variables) beschrieben. Um zu bestätigen, dass eine Konfiguration wirksam wurde, überprüfen Sie Ihr Backend auf die `claude_code.session.count`-Metrik nach dem Starten einer Sitzung; der [Schnellstart](#quick-start) behandelt Protokoll-only-Verifizierung und was zu überprüfen ist, wenn nichts ankommt.

460 463

461Für Console-Debugging mit einem 1-Sekunden-Exportintervall:464Für Console-Debugging mit 1-Sekunden-Exportintervall:

462 465

463```bash theme={null}466```bash theme={null}

464export CLAUDE_CODE_ENABLE_TELEMETRY=1467export CLAUDE_CODE_ENABLE_TELEMETRY=1

482export OTEL_METRICS_EXPORTER=prometheus485export OTEL_METRICS_EXPORTER=prometheus

483```486```

484 487

485In einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments-reference#pass-through-session-child-metrics) bindet die Sitzung Port 9464 nur bei der Standard-Kapazität des Runners von eins. Bei höherer Kapazität stellt der Runner Sitzungszähler und Gauges stattdessen auf seinem eigenen `/metrics` Endpunkt erneut bereit.488In einer [selbstgehosteten Umgebung](/docs/de/self-hosted-environments-reference#pass-through-session-child-metrics) bindet die Sitzung Port 9464 nur bei der Standard-Kapazität des Runners von eins. Bei höherer Kapazität stellt der Runner Sitzungszähler und Gauges stattdessen auf seinem eigenen `/metrics`-Endpunkt erneut bereit.

486 489

487Um Metriken an mehrere Exporter zu senden:490Um Metriken an mehrere Exporter zu senden:

488 491

492export OTEL_EXPORTER_OTLP_PROTOCOL=http/json495export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

493```496```

494 497

495Um Metriken und Logs an verschiedene Endpunkte oder Backends zu senden:498Um Metriken und Protokolle an verschiedene Endpunkte oder Backends zu senden:

496 499

497```bash theme={null}500```bash theme={null}

498export CLAUDE_CODE_ENABLE_TELEMETRY=1501export CLAUDE_CODE_ENABLE_TELEMETRY=1

504export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317507export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

505```508```

506 509

507Um nur Metriken zu exportieren, ohne Ereignisse oder Logs:510Um nur Metriken zu exportieren, ohne Ereignisse oder Protokolle:

508 511

509```bash theme={null}512```bash theme={null}

510export CLAUDE_CODE_ENABLE_TELEMETRY=1513export CLAUDE_CODE_ENABLE_TELEMETRY=1

513export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317516export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

514```517```

515 518

516Um nur Ereignisse und Logs zu exportieren, ohne Metriken:519Um nur Ereignisse und Protokolle zu exportieren, ohne Metriken:

517 520

518```bash theme={null}521```bash theme={null}

519export CLAUDE_CODE_ENABLE_TELEMETRY=1522export CLAUDE_CODE_ENABLE_TELEMETRY=1

522export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317525export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

523```526```

524 527

528<h2 id="telemetry-from-cloud-sessions-and-claude-tag">

529 Telemetrie aus Cloud-Sitzungen und Claude Tag

530</h2>

531

532[Cloud-Sitzungen](/docs/de/claude-code-on-the-web), einschließlich [Claude Tag](https://claude.com/docs/claude-tag/overview)-Kanalsitzungen, werden in [Cloud-Umgebungen](/docs/de/cloud-environments) statt auf den Geräten Ihrer Benutzer ausgeführt, daher konfiguriert eine verwaltete Einstellungsdatei oder ein Shell-Profil auf diesen Geräten nicht deren Telemetrie. Für Sitzungen in von Anthropic gehosteten Umgebungen behandelt dieser Abschnitt, wo Sie die Telemetrie-Variablen festlegen, wie Sie Ihren Collector aus der Umgebung erreichbar machen und wie Sie Cloud- und Claude Tag-Sitzungen in den exportierten Daten unterscheiden.

533

534Um Telemetrie aus diesen Sitzungen zu exportieren, legen Sie `CLAUDE_CODE_ENABLE_TELEMETRY` und die `OTEL_*`-Variablen mit denselben Schlüsseln wie im Beispiel der [Administrator-Konfiguration](#administrator-configuration) an einem von zwei Orten fest:

535

536* **Vom Server verwaltete Einstellungen**: Fügen Sie sie zum `env`-Block der [vom Server verwalteten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation hinzu. Claude Code ruft diese Einstellungen beim Start überall dort ab, wo [vom Server verwaltete Einstellungen gelten](/docs/de/model-config#surface-coverage), was die Maschinen Ihrer Benutzer und Cloud-Sitzungen außer Claude Tag-Kanalsitzungen einschließt. Claude Tag-Sitzungen erhalten Ihre vom Server verwalteten Einstellungen nicht, daher konfiguriert diese Route sie nicht.

537* **Die Variablen der Umgebung**: Fügen Sie sie zu den [Umgebungsvariablen](/docs/de/cloud-environments#set-environment-variables) einer Cloud-Umgebung hinzu, um nur die Sitzungen zu konfigurieren, die in dieser Umgebung ausgeführt werden. Dies ist die Route, die Claude Tag-Sitzungen erreicht.

538

539Jeder, der eine Umgebung nutzt, kann ihre Variablen lesen, daher legen Sie dort keine Anmeldedaten ab, wie etwa ein Collector-Token in `OTEL_EXPORTER_OTLP_HEADERS`. Eine [API-Anmeldedaten](/docs/de/cloud-environments#add-api-credentials) in der Umgebung hilft auch nicht, da Claude Codes eigener Telemetrie-Export einer der [Anfragen ist, die niemals die Anmeldedaten erhalten](/docs/de/cloud-environments#requests-that-never-get-the-credential). Wenn Ihr Collector Anmeldedaten benötigt, konfigurieren Sie stattdessen den gesamten Export über vom Server verwaltete Einstellungen, da Claude Code, wenn Sie dort Anmeldedaten festlegen, [Endpunkt-Variablen entfernt, die außerhalb verwalteter Einstellungen festgelegt sind](#how-managed-settings-lock-the-otlp-destination).

540

541Beachten Sie diese Einschränkungen, wenn Sie Telemetrie für Cloud-Sitzungen konfigurieren:

542

543* **Lassen Sie Sitzungen den Collector erreichen**: Claude Code sendet den Export über das Netzwerk der Sitzung, daher hängt es davon ab, ob es den Host in Ihrem `OTEL_EXPORTER_OTLP_ENDPOINT` erreicht, von der [Netzwerkzugriffsstufe](/docs/de/cloud-environments#access-levels) der Umgebung ab. Wenn Sitzungen die Domäne des Collectors auf der von Ihnen gewählten Stufe nicht erreichen können, [fügen Sie die Domäne zur Zulassungsliste der Umgebung hinzu](/docs/de/cloud-environments#allow-specific-domains), da keine vom Server verwaltete Einstellung Domänen zur Netzwerk-Zulassungsliste einer Umgebung hinzufügt.

544* **Claude Tag-Kanäle verwenden Umgebungen auf Organisationsebene**: Kanalsitzungen werden in Umgebungen auf Organisationsebene statt in persönlichen Umgebungen von Mitgliedern ausgeführt, daher nehmen Sie Änderungen an der Zulassungsliste und an Umgebungsvariablen in der [gemeinsamen Umgebung](/docs/de/cloud-environments#organization-shared-environments) vor, die als Standard Ihrer Organisation festgelegt oder an den Kanal angeheftet ist.

545* **Cowork wird separat konfiguriert**: Cowork-Sitzungen erhalten keine vom Server verwalteten Einstellungen, wie die [Oberflächenabdeckungstabelle](/docs/de/model-config#surface-coverage) zeigt, daher konfiguriert der vom Server verwaltete `env`-Block nicht deren Telemetrie.

546

547<h3 id="attribute-telemetry-to-cloud-sessions">

548 Telemetrie Cloud-Sitzungen zuordnen

549</h3>

550

551Standardmäßig tragen Metriken und Ereignisse aus einer Cloud-Sitzung die [Standard-Attribute](#standard-attributes), einschließlich `session.id`, `ccr.session.id` und `organization.id`, mit sich, sodass Sie nach Sitzung oder Organisation filtern können, ohne zusätzliche Konfiguration. Der `ccr.session.id`-Wert ist die `CLAUDE_CODE_REMOTE_SESSION_ID` der Sitzung. Um ihn in die Transkript-URL der Sitzung umzuwandeln, siehe [Ausgabe zurück zur Sitzung verlinken](/docs/de/cloud-environments#link-output-back-to-the-session).

552

553Um Telemetrie detaillierter zuzuordnen, verwenden Sie diese Optionen:

554

555* **Claude Tag-Sitzungen identifizieren**: Legen Sie `OTEL_METRICS_INCLUDE_ENTRYPOINT=true` fest, wie unter [Metriken-Kardinalitätskontrolle](#metrics-cardinality-control) beschrieben. Metriken tragen dann `app.entrypoint`, dessen Wert `claude-in-slack` für Claude Tag-Sitzungen ist.

556* **Benutzerdefinierte Attribute hinzufügen**: Legen Sie [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) an derselben Stelle fest, an der Sie die anderen `OTEL_*`-Variablen für diese Sitzungen festlegen. Wenn Sie es stattdessen im [Setup-Skript](/docs/de/cloud-environments#setup-scripts) der Umgebung `export`ieren, erreicht der Wert Claude Code nicht: Das Setup-Skript ist ein separates Bash-Skript, das vor dem Start von Claude Code ausgeführt wird, und Variablen, die es exportiert, enden damit.

557

558In Claude Tag-Kanalsitzungen funktioniert Claude als [gemeinsame Identität](/docs/de/cloud-environments#set-the-environment-a-claude-tag-channel-uses) Ihrer Organisation statt als ein Mitglied, daher verlassen Sie sich nicht auf die `user.*`-Attribute, um zu identifizieren, wer Claude markiert hat.

559

525<h2 id="available-metrics-and-events">560<h2 id="available-metrics-and-events">

526 Verfügbare Metriken und Ereignisse561 Verfügbare Metriken und Ereignisse

527</h2>562</h2>

536| - | - | - |571| - | - | - |

573| `ccr.session.id` | Cloud-Sitzungskennung, der Wert von `CLAUDE_CODE_REMOTE_SESSION_ID`, bei Sitzungen, die in einer [Cloud-Umgebung](/docs/de/cloud-environments) ausgeführt werden | `OTEL_METRICS_INCLUDE_SESSION_ID` (Standard: true) |

539| `app.entrypoint` | Wie die Sitzung gestartet wurde, z. B. `cli`, `sdk-cli`, `sdk-ts`, `sdk-py` oder `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (Standard: false) |575| `app.entrypoint` | Wie die Sitzung gestartet wurde, z. B. `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-vscode` oder `claude-in-slack` für Claude Tag-Sitzungen | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (Standard: false) |

542| `user.account_id` | Konto-ID im getaggten Format, das Anthropic-Admin-APIs entspricht (wenn authentifiziert), z. B. `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (Standard: true) |578| `user.account_id` | Konto-ID im getaggten Format, das Anthropic-Admin-APIs entspricht (wenn authentifiziert), z. B. `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (Standard: true) |

543| `user.id` | Zufällige anonyme Kennung, die beim ersten Ausführen generiert und in `~/.claude.json` gespeichert wird. Sie enthält keine persönlichen Informationen und wird nicht von Ihrem Claude-Konto abgeleitet. Das Löschen der Datei erzeugt beim nächsten Ausführen einen neuen, nicht verwandten Wert. | Immer enthalten |579| `user.id` | Zufällige anonyme Kennung, die beim ersten Ausführen generiert und in `~/.claude.json` gespeichert wird. Sie enthält keine persönlichen Informationen und wird nicht von Ihrem Claude-Konto abgeleitet. Das Löschen der Datei erzeugt beim nächsten Ausführen einen neuen, nicht verwandten Wert. | Immer enthalten |

544| `user.email` | E-Mail-Adresse des Benutzers, von Ihrer Anmeldung oder in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) von den Anmeldedaten der Sitzung selbst | Immer enthalten, wenn verfügbar |580| `user.email` | E-Mail-Adresse des Benutzers, von Ihrer Anmeldung oder in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) von den Anmeldedaten der Sitzung | Immer enthalten, wenn verfügbar |

546| Schlüssel aus `OTEL_RESOURCE_ATTRIBUTES` | Benutzerdefinierte Attribute, die Sie festlegen, z. B. `department` oder `team.id`. Siehe [Unterstützung für Multi-Team-Organisationen](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (Standard: true) |582| Schlüssel aus `OTEL_RESOURCE_ATTRIBUTES` | Benutzerdefinierte Attribute, die Sie festlegen, z. B. `department` oder `team.id`. Siehe [Multi-Team-Organisationsunterstützung](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (Standard: true) |

547| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Die Identität des Sitzungs-Repositorys, abgeleitet von seinem `origin`-Remote. Siehe [Repository-Attribute](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (Standard: false). Erfordert Claude Code v2.1.269 oder später |583| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Die Identität des Sitzungs-Repositorys, abgeleitet von seinem `origin`-Remote. Siehe [Repository-Attribute](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (Standard: false). Erfordert Claude Code v2.1.269 oder später |

548 584

549Wenn Claude Code bei einem [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) angemeldet ist, versieht die CLI Exporte mit der authentifizierten Identität aus der Gateway-Sitzung: `user.id` ist das IdP-Subjekt statt einer anonymen Installationskennung, `user.email` ist die angemeldete E-Mail, und `user.groups` enthält die IdP-Gruppenmitgliedschaft als kommagetrennte Zeichenkette. Jeder Export enthält auch `identity.source: gateway-oidc`. Die Gateway-Identität wird zuletzt angewendet, daher werden `user.*`- und `identity.*`-Schlüssel, die über `OTEL_RESOURCE_ATTRIBUTES` festgelegt werden, bei Gateway-Sitzungen ignoriert.585Wenn Claude Code bei einem [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) angemeldet ist, versieht die CLI Exporte mit der authentifizierten Identität aus der Gateway-Sitzung: `user.id` ist der IdP-Betreff statt einer anonymen Installationskennung, `user.email` ist die angemeldete E-Mail, und `user.groups` enthält die IdP-Gruppenmitgliedschaft als kommagetrennte Zeichenkette. Jeder Export enthält auch `identity.source: gateway-oidc`. Die Gateway-Identität wird zuletzt angewendet, daher werden `user.*`- und `identity.*`-Schlüssel, die über `OTEL_RESOURCE_ATTRIBUTES` festgelegt werden, bei Gateway-Sitzungen ignoriert.

550 586

551Ereignisse enthalten zusätzlich die folgenden Attribute. Diese werden niemals an Metriken angehängt, da sie zu unbegrenzter Kardinalität führen würden:587Ereignisse enthalten zusätzlich die folgenden Attribute. Diese werden niemals an Metriken angehängt, da sie zu unbegrenzter Kardinalität führen würden:

552 588

553* `prompt.id`: UUID, die eine Benutzereingabeaufforderung mit allen nachfolgenden Ereignissen bis zur nächsten Eingabeaufforderung korreliert. Siehe [Ereigniskorrelationsattribute](#event-correlation-attributes).589* `prompt.id`: UUID, die eine Benutzereingabeaufforderung mit allen nachfolgenden Ereignissen bis zur nächsten Eingabeaufforderung korreliert. Siehe [Ereigniskorrelationsattribute](#event-correlation-attributes).

554* `workspace.host_paths`: Host-Arbeitsverzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array590* `workspace.host_paths`: Host-Arbeitsverzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array

555* `workflow.run_id`: Laufkennung mit dem Präfix `wf_` auf den API- und Tool-Ereignissen, die von Agenten ausgegeben werden, die zu einem [Workflow](/docs/de/workflows)-Tool-Lauf gehören. Das Filtern von Ereignissen nach einer `workflow.run_id` rekonstruiert die API-Anfragen und Tool-Ergebnisse dieses Laufs. Die Kennung umfasst die Agenten, die das Workflow-Skript erzeugt, und alle Agenten, die diese wiederum erzeugen, z. B. Skill-Aufrufe. Sie entspricht der Laufkennung, die im Workflow-Tool-Ergebnis gemeldet wird. Fehlt bei allen anderen Ereignissen. Erfordert Claude Code v2.1.202 oder später591* `workflow.run_id`: Laufkennung mit dem Präfix `wf_` auf der API und Tool-Ereignisse, die von Agenten ausgegeben werden, die zu einem [Workflow](/docs/de/workflows)-Tool-Lauf gehören. Das Filtern von Ereignissen nach einer `workflow.run_id` rekonstruiert die API-Anfragen und Tool-Ergebnisse dieses Laufs. Die Kennung umfasst die Agenten, die das Workflow-Skript erzeugt, und alle Agenten, die diese wiederum erzeugen, z. B. Skill-Aufrufe. Sie entspricht der Laufkennung, die im Workflow-Tool-Ergebnis gemeldet wird. Fehlt bei allen anderen Ereignissen. Erfordert Claude Code v2.1.202 oder später

556* `workflow.name`: Name des Workflows, das `meta.name` des Skripts, ausgegeben zusammen mit `workflow.run_id`. Integrierte Workflow-Namen werden wörtlich angezeigt, wenn der Lauf das unveränderte integrierte Skript ausführt. Benutzerdefinierte Namen, einschließlich bearbeiteter Kopien integrierter Skripte, werden durch `custom` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Erfordert Claude Code v2.1.202 oder später592* `workflow.name`: Name des Workflows, das `meta.name` des Skripts, ausgegeben zusammen mit `workflow.run_id`. Integrierte Workflow-Namen werden wörtlich angezeigt, wenn der Lauf das unveränderte integrierte Skript ausführt. Benutzerdefinierte Namen, einschließlich bearbeiteter Kopien integrierter Skripte, werden durch `custom` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Erfordert Claude Code v2.1.202 oder später

557 593

558<h4 id="repository-attributes">594<h4 id="repository-attributes">

561 597

562Setzen Sie `OTEL_METRICS_INCLUDE_REPOSITORY=true`, um Metriken und Ereignisse mit der Identität des Sitzungs-Repositorys zu taggen, damit ein gemeinsamer Collector die Nutzung pro Repository zuordnen kann. Erfordert Claude Code v2.1.269 oder später.598Setzen Sie `OTEL_METRICS_INCLUDE_REPOSITORY=true`, um Metriken und Ereignisse mit der Identität des Sitzungs-Repositorys zu taggen, damit ein gemeinsamer Collector die Nutzung pro Repository zuordnen kann. Erfordert Claude Code v2.1.269 oder später.

563 599

564Claude Code leitet diese Attribute einmal pro Sitzung vom `origin`-Remote des Repositorys ab. Die HTTPS- und SSH-Remotes eines Repositorys erzeugen identische Werte:600Claude Code leitet diese Attribute einmal pro Sitzung vom `origin`-Remote des Repositorys ab. Wenn die HTTPS- und SSH-Remotes eines Repositorys denselben Host und denselben Pfad benennen, wie auf GitHub, GitLab und Bitbucket Cloud, erzeugen beide identische Werte:

565 601

566| Attribut | Wert |602| Attribut | Wert |

567| - | - |603| - | - |

568| `vcs.repository.url.full` | Die Browser-URL des Repositorys ohne `.git`, z. B. `https://github.com/example-org/example-repo` |604| `vcs.repository.url.full` | Die Browser-URL des Repositorys ohne `.git`, z. B. `https://github.com/example-org/example-repo` |

569| `vcs.owner.name` | Der Besitzer oder Gruppenpfad, z. B. `example-org`; weggelassen, wenn der Remote-Pfad ein einzelnes Segment hat |605| `vcs.owner.name` | Der Besitzer oder Gruppenpfad, z. B. `example-org`; weggelassen, wenn der Remote-Pfad ein einzelnes Segment hat |

571| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` oder `gitea`, wenn Claude Code den Host oder die URL-Form des Remote als einen dieser Anbieter erkennt; andernfalls weggelassen |607| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` oder `gitea`, wenn Claude Code den Host oder die URL-Form des Remote als einen dieser Anbieter erkennt; andernfalls weggelassen |

572 608

573Werte werden in Kleinbuchstaben konvertiert, und Anmeldedaten, Abfragezeichenfolgen und Fragmente aus der Remote-URL erscheinen niemals darin. Die Attribute werden weggelassen, wenn die Sitzung keinen `origin`-Remote hat, wenn der Remote nicht URL-förmig ist, oder wenn das einzige umschließende Repository Ihr Home-Verzeichnis ist.609Werte werden in Kleinbuchstaben geschrieben, und Anmeldedaten, Abfragezeichenfolgen und Fragmente aus der Remote-URL erscheinen niemals darin. Die Attribute werden weggelassen, wenn die Sitzung keinen `origin`-Remote hat, wenn der Remote nicht URL-förmig ist, oder wenn das einzige umschließende Repository Ihr Home-Verzeichnis ist.

610

611Um diese Attribute aus einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zu erhalten, setzen Sie die Telemetrie-Variablen, einschließlich `OTEL_METRICS_INCLUDE_REPOSITORY`, in ihrer [Cloud-Umgebung](/docs/de/cloud-environments#set-environment-variables). Erlauben Sie auch die Domäne Ihres Collectors im [Netzwerkzugriff](/docs/de/cloud-environments#network-access) der Umgebung.

574 612

575Ein `vcs.*`-Schlüssel, den Sie in [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) deklarieren, ersetzt den abgeleiteten Wert für diesen Schlüssel. Wenn Sie `vcs.repository.url.full` deklarieren, liest Claude Code den Remote nie und meldet nur die Schlüssel, die Sie deklarieren.613Ein `vcs.*`-Schlüssel, den Sie in [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) deklarieren, ersetzt den abgeleiteten Wert für diesen Schlüssel. Wenn Sie `vcs.repository.url.full` deklarieren, liest Claude Code den Remote nie und meldet nur die Schlüssel, die Sie deklarieren.

576 614

577Die Attribute fließen nur zu Ihren eigenen Exportern; Anthropic's Telemetrie verwirft jeden `vcs.*`-Schlüssel.615Wenn HTTPS- und SSH-Klone eines Repositorys unterschiedliche Werte melden, z. B. bei einer selbstgehosteten Installation, deren HTTPS-Klon-URL ein Pfadpräfix hat, das die SSH-URL nicht hat, deklarieren Sie `vcs.repository.url.full` in `OTEL_RESOURCE_ATTRIBUTES` zusammen mit jedem anderen `vcs.*`-Schlüssel, den Sie melden möchten. Jeder Klon meldet dann die Identität, die Sie deklarieren.

616

617Die Attribute fließen nur zu Ihren eigenen Exportern; Anthropics Telemetrie lässt jeden `vcs.*`-Schlüssel fallen.

578 618

579<h3 id="metrics">619<h3 id="metrics">

580 Metriken620 Metriken

591| `claude_code.cost.usage` | Kosten der Claude Code-Sitzung | USD |631| `claude_code.cost.usage` | Kosten der Claude Code-Sitzung | USD |

594| `claude_code.active_time.total` | Gesamtaktive Zeit | s |634| `claude_code.active_time.total` | Gesamtaktive Zeit | s |

595 635

596Wenn `prometheus` der einzige in `OTEL_METRICS_EXPORTER` aufgelistete Exporter ist, lässt Claude Code die Einheiten `USD`, `tokens` und `s` aus den exportierten Metriken weg, damit der Scrape im gültigen Prometheus-Textformat bleibt. Metriknamen ändern sich nicht, und Konfigurationen, die Exporter kombinieren, z. B. `otlp,prometheus`, behalten die Einheiten. Vor v2.1.216 enthielt der Prometheus-Scrape OpenMetrics-only `# UNIT`-Zeilen, die einige Scraper ablehnten.636Wenn `prometheus` der einzige in `OTEL_METRICS_EXPORTER` aufgelistete Exporter ist, lässt Claude Code die Einheiten `USD`, `tokens` und `s` aus den exportierten Metriken weg, damit der Scrape im gültigen Prometheus-Textformat bleibt. Metriknamen ändern sich nicht, und Konfigurationen, die Exporter kombinieren, z. B. `otlp,prometheus`, behalten die Einheiten. Vor v2.1.216 enthielt der Prometheus-Scrape OpenMetrics-only `# UNIT`-Zeilen, die einige Scraper ablehnten.

605 Sitzungszähler645 Sitzungszähler

606</h4>646</h4>

607 647

608Wird zu Beginn jeder Sitzung erhöht.648Wird am Anfang jeder Sitzung erhöht.

609 649

610**Attribute**:650**Attribute**:

611 651

612* Alle [Standardattribute](#standard-attributes)652* Alle [Standardattribute](#standard-attributes)

613* `start_type`: Wie die Sitzung gestartet wurde. Einer von `"fresh"`, `"resume"`, `"continue"` oder `"agents_view"`. Der Wert `"agents_view"` identifiziert den `claude agents`-Dashboard-Prozess, eine von Benutzern gestartete lokale UI statt einer Gesprächssitzung. Filtern Sie nach diesem Wert, um UI-Prozessstartvorgänge von Gesprächssitzungen in Ihren Dashboards zu trennen.653* `start_type`: Wie die Sitzung gestartet wurde. Einer von `"fresh"`, `"resume"`, `"continue"` oder `"agents_view"`. Der Wert `"agents_view"` identifiziert den `claude agents`-Dashboard-Prozess, eine von Benutzern gestartete lokale Benutzeroberfläche statt einer Gesprächssitzung. Filtern Sie nach diesem Wert, um UI-Prozessstartvorgänge von Gesprächssitzungen in Ihren Dashboards zu trennen.

614 654

615<h4 id="lines-of-code-counter">655<h4 id="lines-of-code-counter">

616 Codezeilen-Zähler656 Codezeilen-Zähler

650 690

651Wird nach jeder API-Anfrage erhöht.691Wird nach jeder API-Anfrage erhöht.

652 692

693Die Attribute `agent.name`, `skill.name`, `plugin.name`, `mcp_server.name` und `mcp_tool.name` reduzieren standardmäßig einige Namen auf einen Platzhalter `"custom"` oder `"third-party"`. Wenn Sie `OTEL_LOG_TOOL_DETAILS=1` setzen, enthalten sie stattdessen die echten Namen. Vor v2.1.273 trugen die Kosten- und Token-Zähler sowie die Ereignisse `api_request`, `api_error` und `api_refusal` die reduzierten Werte auch mit `OTEL_LOG_TOOL_DETAILS=1` gesetzt.

694

653**Attribute**:695**Attribute**:

654 696

655* Alle [Standardattribute](#standard-attributes)697* Alle [Standardattribute](#standard-attributes)

657* `query_source`: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von `"main"`, `"subagent"` oder `"auxiliary"`699* `query_source`: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von `"main"`, `"subagent"` oder `"auxiliary"`

658* `speed`: `"fast"`, wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden700* `speed`: `"fast"`, wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden

659* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.701* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.

660* `agent.name`: Subagent-Typ, der die Anfrage gestellt hat. Integrierte Agent-Namen und Agenten aus offiziellen Marketplace-Plugins werden wörtlich angezeigt. Andere benutzerdefinierte Agent-Namen werden durch `"custom"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Nicht vorhanden, wenn die Anfrage nicht von einem benannten Subagent-Typ gestellt wurde.702* `agent.name`: Subagent-Typ, der die Anfrage gestellt hat. Integrierte Agent-Namen und Agenten aus offiziellen Marketplace-Plugins werden wörtlich angezeigt. Andere benutzerdefinierte Agent-Namen werden durch `"custom"` ersetzt. Nicht vorhanden, wenn die Anfrage nicht von einem benannten Subagent-Typ gestellt wurde.

661* `skill.name`: Skill, der für die Anfrage aktiv ist, gesetzt durch das Skill-Tool, einen `/`-Befehl oder geerbt von einem erzeugten Subagenten. Integrierte, gebündelte, benutzerdefinierte und offizielle Marketplace-Plugin-Skill-Namen werden wörtlich angezeigt. Skill-Namen von Drittanbieter-Plugins werden durch `"third-party"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Nicht vorhanden, wenn kein Skill aktiv ist.703* `skill.name`: Skill, der für die Anfrage aktiv ist, gesetzt durch das Skill-Tool oder einen `/`-Befehl, oder geerbt von einem erzeugten Subagenten. Integrierte, gebündelte, benutzerdefinierte und offizielle Marketplace-Plugin-Skill-Namen werden wörtlich angezeigt. Skill-Namen von Drittanbieter-Plugins werden durch `"third-party"` ersetzt. Nicht vorhanden, wenn kein Skill aktiv ist.

662* `plugin.name`: Besitzendes Plugin, wenn der aktive Skill oder Subagent von einem Plugin bereitgestellt wird. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Namen werden durch `"third-party"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Nicht vorhanden, wenn weder der Skill noch der Subagent ein besitzendes Plugin hat.704* `plugin.name`: Besitzendes Plugin, wenn der aktive Skill oder Subagent von einem Plugin bereitgestellt wird. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt. Plugin-Namen von Drittanbietern werden durch `"third-party"` ersetzt. Nicht vorhanden, wenn weder der Skill noch der Subagent ein besitzendes Plugin hat.

663* `marketplace.name`: Marketplace, von dem das besitzende Plugin installiert wurde. Nur für offizielle Marketplace-Plugins ausgegeben. Andernfalls nicht vorhanden.705* `marketplace.name`: Marketplace, von dem das besitzende Plugin installiert wurde. Nur für offizielle Marketplace-Plugins ausgegeben, auch mit `OTEL_LOG_TOOL_DETAILS=1` gesetzt. Andernfalls nicht vorhanden.

664* `mcp_server.name`: MCP-Server, dessen Tool-Ergebnis diese Anfrage verbraucht hat. Integrierte, claude.ai-proxied und offizielle Registry-Server-Namen werden wörtlich angezeigt. Benutzerkonfigurierte Server-Namen werden durch `"custom"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Nicht vorhanden, wenn die Anfrage kein MCP-Tool-Ergebnis verbraucht hat. Vor v2.1.222 setzte Claude Code dieses Attribut bei jeder Anfrage nach einem MCP-Tool-Aufruf, nicht nur bei Anfragen, die ein Tool-Ergebnis verbrauchten, daher zeigen Dashboards, die es aggregieren, einen Rückgang nach dem Upgrade.706* `mcp_server.name`: MCP-Server, dessen Tool-Ergebnis diese Anfrage verbraucht hat. Integrierte, claude.ai-proxied und offizielle Registry-Server-Namen werden wörtlich angezeigt. Benutzerkonfigurierte Server-Namen werden durch `"custom"` ersetzt. Nicht vorhanden, wenn die Anfrage kein MCP-Tool-Ergebnis verbraucht hat. Vor v2.1.222 setzte Claude Code dieses Attribut nach jedem MCP-Tool-Aufruf auf jede Anfrage, nicht nur auf Anfragen, die ein Tool-Ergebnis verbrauchten, daher zeigen Dashboards, die es aggregieren, einen Rückgang nach dem Upgrade.

665* `mcp_tool.name`: MCP-Tool, dessen Ergebnis diese Anfrage verbraucht hat, mit demselben Redaktions- und Versionsverhalten wie `mcp_server.name`. Nicht vorhanden, wenn die Anfrage kein MCP-Tool-Ergebnis verbraucht hat.707* `mcp_tool.name`: MCP-Tool, dessen Ergebnis diese Anfrage verbraucht hat, mit derselben Redaktion und Versionsverhaltensweise wie `mcp_server.name`. Nicht vorhanden, wenn die Anfrage kein MCP-Tool-Ergebnis verbraucht hat.

666 708

667<h4 id="token-counter">709<h4 id="token-counter">

668 Token-Zähler710 Token-Zähler

698 Aktive Zeit-Zähler740 Aktive Zeit-Zähler

699</h4>741</h4>

700 742

701Verfolgt die tatsächliche Zeit, die Claude Code aktiv verwendet wird, ausschließlich Leerlaufzeit. Diese Metrik wird während Benutzerinteraktionen wie Tippen und Lesen von Antworten sowie während CLI-Verarbeitung wie Tool-Ausführung und KI-Antworterzeugung erhöht.743Verfolgt die tatsächliche Zeit, die Claude Code aktiv verwendet wird, ausschließlich Leerlaufzeit. Diese Metrik wird während Benutzerinteraktionen wie Tippen und Lesen von Antworten sowie während CLI-Verarbeitung wie Tool-Ausführung und KI-Antwortgenerierung erhöht.

702 744

703**Attribute**:745**Attribute**:

704 746

721| - | - |763| - | - |

722| `prompt.id` | UUID v4-Kennung, die alle Ereignisse verknüpft, die während der Verarbeitung einer einzelnen Benutzereingabeaufforderung erzeugt werden |764| `prompt.id` | UUID v4-Kennung, die alle Ereignisse verknüpft, die während der Verarbeitung einer einzelnen Benutzereingabeaufforderung erzeugt werden |

724| `message.uuid` | UUID der Nachricht, wie sie im Sitzungstranskript gespeichert ist, die Dateien `~/.claude/projects/*/*.jsonl`. Vorhanden auf `assistant_response`, auf `api_response_body` und auf `user_prompt` außer für Befehlsverteilungen, die null oder viele Nachrichten erzeugen können. Auf `assistant_response` und `api_response_body` ist dies der endgültige Transkripteintrag der Antwort, von dem die `parentUuid` des nächsten Zuges verkettet wird. Erfordert Claude Code v2.1.214 oder später, oder v2.1.274 oder später auf `api_response_body` |766| `message.uuid` | UUID der Nachricht, wie sie in der Sitzungstranskription gespeichert ist, die `~/.claude/projects/*/*.jsonl`-Dateien. Vorhanden auf `assistant_response`, auf `api_response_body` und auf `user_prompt` außer für Befehlsdispatcher, die null oder viele Nachrichten erzeugen können. Auf `assistant_response` und `api_response_body` ist dies der letzte Transkriptionseintrag der Antwort, von dem die `parentUuid` des nächsten Zuges verkettet wird. Erfordert Claude Code v2.1.214 oder später, oder v2.1.274 oder später auf `api_response_body` |

725| `client_request_id` | Von Client generierte UUID, die als `x-client-request-id`-Request-Header gesendet wird. Vorhanden auf `api_request` und `api_error` bei First-Party-API-Verbindungen; nicht vorhanden bei Drittanbieter-Provider-Backends und wenn die Anfrage über den Fallback ohne Streaming erneut versucht wurde. Paart eine Anfrage mit ihrer Antwort und bleibt für Fehler wie Timeouts verfügbar, die nie eine Server-`request_id` erzeugt haben. Entspricht demselben Attribut auf der `llm_request`-Trace-Spanne. Erfordert Claude Code v2.1.214 oder später |767| `request_id` | Server-zugewiesene ID der API-Anfrage, gelesen aus dem `request-id`-Antwortheader, z. B. `req_011...`. Bei einer Antwort ohne `request-id`-Header, wie bei [Amazon Bedrock](/docs/de/amazon-bedrock), kommt der Wert stattdessen aus dem `x-amzn-requestid`-Header. Vorhanden auf `api_request`, `api_error`, `api_refusal`, `assistant_response` und `api_response_body`, wenn die Antwort einen der beiden Header trägt. Entspricht demselben Attribut auf der `llm_request`-Trace-Spanne. Die `x-amzn-requestid`-Quelle erfordert Claude Code v2.1.282 oder später |

768| `client_request_id` | Client-generierte UUID, die als `x-client-request-id`-Anfragekopfzeile gesendet wird. Vorhanden auf `api_request` und `api_error` bei Verbindungen mit Erstanbieter-API; nicht vorhanden bei Backends von Drittanbieter-Anbietern und wenn die Anfrage über den Fallback ohne Streaming erneut versucht wurde. Paart eine Anfrage mit ihrer Antwort und bleibt für Fehler wie Timeouts verfügbar, die nie eine Server-`request_id` erzeugt haben. Entspricht demselben Attribut auf der `llm_request`-Trace-Spanne. Erfordert Claude Code v2.1.214 oder später |

726 769

727Um alle Aktivitäten zu verfolgen, die durch eine einzelne Eingabeaufforderung ausgelöst werden, filtern Sie Ihre Ereignisse nach einem bestimmten `prompt.id`-Wert. Dies gibt das user\_prompt-Ereignis, alle api\_request-Ereignisse und alle tool\_result-Ereignisse zurück, die während der Verarbeitung dieser Eingabeaufforderung aufgetreten sind.770Um alle Aktivitäten zu verfolgen, die durch eine einzelne Eingabeaufforderung ausgelöst werden, filtern Sie Ihre Ereignisse nach einem bestimmten `prompt.id`-Wert. Dies gibt das user\_prompt-Ereignis, alle api\_request-Ereignisse und alle tool\_result-Ereignisse zurück, die während der Verarbeitung dieser Eingabeaufforderung aufgetreten sind.

728 771

729`event.sequence` beginnt bei 0 jedes Mal, wenn ein Claude Code-Prozess startet, und zählt für die Lebensdauer dieses Prozesses. Es zählt weiter über `/clear`, das eine neue `session.id` zuweist. Wenn Sie [eine Sitzung fortsetzen, ohne sie zu verzweigen](/docs/de/how-claude-code-works#resume-or-fork-sessions), behält die Sitzung ihre `session.id`, nimmt aber ihre `event.sequence`-Werte vom Prozess, der sie fortgesetzt hat, daher kann innerhalb einer Sitzung ein späteres Ereignis einen niedrigeren Wert als ein früheres tragen oder einen wiederholen. Um die Ereignisse einer Sitzung zu ordnen, sortieren Sie nach `event.timestamp` und verwenden Sie `event.sequence`, um Ereignisse zu ordnen, die einen Zeitstempel teilen.772`event.sequence` beginnt bei 0 jedes Mal, wenn ein Claude Code-Prozess startet, und zählt für die Lebensdauer dieses Prozesses. Es zählt weiter über `/clear`, das eine neue `session.id` zuweist. Wenn Sie [eine Sitzung fortsetzen, ohne sie zu verzweigen](/docs/de/how-claude-code-works#resume-or-fork-sessions), behält die Sitzung ihre `session.id`, nimmt aber ihre `event.sequence`-Werte vom Prozess, der sie fortgesetzt hat, daher kann innerhalb einer Sitzung ein späteres Ereignis einen niedrigeren Wert als ein früheres tragen oder einen wiederholen. Um die Ereignisse einer Sitzung zu ordnen, sortieren Sie nach `event.timestamp` und verwenden Sie `event.sequence`, um Ereignisse zu ordnen, die einen Zeitstempel teilen.

730 773

731Für die Rekonstruktion auf Nachrichtenebene trägt jede Ereignisklasse einen Schlüssel, der einem Feld im Sitzungstranskript entspricht. Das Transkript-Eintragsformat ist [intern für Claude Code](/docs/de/sessions#where-transcripts-are-stored) und ändert sich zwischen Versionen, daher kann eine Pipeline, die auf diesen Feldern verknüpft, bei jeder Veröffentlichung unterbrochen werden; behandeln Sie die Verknüpfungen als versionsspezifisch statt als stabilen Vertrag:774Für die Rekonstruktion auf Nachrichtenebene trägt jede Ereignisklasse einen Schlüssel, der einem Feld in der Sitzungstranskription entspricht. Das Transkriptionseintrag-Format ist [intern für Claude Code](/docs/de/sessions#where-transcripts-are-stored) und ändert sich zwischen Versionen, daher kann eine Pipeline, die auf diesen Feldern verknüpft, bei jeder Veröffentlichung unterbrochen werden; behandeln Sie die Verknüpfungen als versionsspezifisch statt als stabilen Vertrag:

732 775

733* `message.uuid` auf `user_prompt`, `assistant_response` und `api_response_body`776* `message.uuid` auf `user_prompt`, `assistant_response` und `api_response_body`

734* `request_id` auf den API-Ereignissen, gespeichert als `requestId` auf den Assistent-Einträgen des Transkripts777* `request_id` auf den API-Ereignissen, gespeichert als `requestId` auf den Assistent-Einträgen der Transkription

735* `tool_use_id` auf `tool_result`- und `tool_decision`-Ereignissen778* `tool_use_id` auf `tool_result`- und `tool_decision`-Ereignissen

736 779

737<h4 id="user-prompt-event">780<h4 id="user-prompt-event">

749* `event.timestamp`: ISO 8601-Zeitstempel792* `event.timestamp`: ISO 8601-Zeitstempel

750* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)793* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

751* `prompt_length`: Länge der Eingabeaufforderung794* `prompt_length`: Länge der Eingabeaufforderung

752* `prompt`: Inhalt der Eingabeaufforderung. Standardmäßig redaktioniert. Setzen Sie `OTEL_LOG_USER_PROMPTS=1`, um sie einzuschließen795* `prompt`: Inhalt der Eingabeaufforderung. Standardmäßig reduziert. Setzen Sie `OTEL_LOG_USER_PROMPTS=1`, um ihn einzuschließen

753* `message.uuid`: UUID der resultierenden Benutzernachricht, die dem gespeicherten Transkripteintrag entspricht. Nicht vorhanden bei Befehlsverteilungen, die null oder viele Nachrichten erzeugen können. Erfordert Claude Code v2.1.214 oder später796* `message.uuid`: UUID der resultierenden Benutzernachricht, die dem gespeicherten Transkriptionseintrag entspricht. Nicht vorhanden bei Befehlsdispatchern, die null oder viele Nachrichten erzeugen können. Erfordert Claude Code v2.1.214 oder später

754* `command_name`: Befehlsname, wenn die Eingabeaufforderung einen aufruft. Integrierte und gebündelte Befehlsnamen wie `compact` oder `debug` werden wie geschrieben ausgegeben; Aliase wie `reset` werden wie eingegeben statt des kanonischen Namens ausgegeben. Benutzerdefinierte, Plugin- und MCP-Befehlsnamen werden zu `custom` oder `mcp` zusammengefasst, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt797* `command_name`: Befehlsname, wenn die Eingabeaufforderung einen aufruft. Integrierte und gebündelte Befehlsnamen wie `compact` oder `debug` werden wie geschrieben ausgegeben; Aliase wie `reset` werden wie eingegeben statt des kanonischen Namens ausgegeben. Benutzerdefinierte, Plugin- und MCP-Befehlsnamen werden auf `custom` oder `mcp` reduziert, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt

755* `command_source`: Ursprung des Befehls, wenn vorhanden: `builtin`, `custom` oder `mcp`. Von Plugins bereitgestellte Befehle werden als `custom` gemeldet798* `command_source`: Ursprung des Befehls, wenn vorhanden: `builtin`, `custom` oder `mcp`. Von Plugins bereitgestellte Befehle werden als `custom` gemeldet

756 799

757<h4 id="assistant-response-event">800<h4 id="assistant-response-event">

758 Assistent-Antwort-Ereignis801 Assistent-Antwort-Ereignis

759</h4>802</h4>

760 803

761Protokolliert nach jeder API-Anfrage, die Textinhalte vom Modell zurückgibt. Nur die Textblöcke der Antwort sind enthalten; Thinking-Blöcke und Tool-Use-Blöcke sind ausgeschlossen. Erfordert Claude Code v2.1.193 oder später.804Protokolliert nach jeder API-Anfrage, die Textinhalte vom Modell zurückgibt. Nur die Textblöcke der Antwort sind enthalten; Denkblöcke und Tool-Use-Blöcke sind ausgeschlossen. Erfordert Claude Code v2.1.193 oder später.

762 805

763**Ereignisname**: `claude_code.assistant_response`806**Ereignisname**: `claude_code.assistant_response`

764 807

769* `event.timestamp`: ISO 8601-Zeitstempel812* `event.timestamp`: ISO 8601-Zeitstempel

770* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)813* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

771* `response_length`: Länge des Antworttexts in Zeichen814* `response_length`: Länge des Antworttexts in Zeichen

772* `response`: Antworttext, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Standardmäßig auf `<REDACTED>` redaktioniert. Setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=1`, um sie einzuschließen. Wenn `OTEL_LOG_ASSISTANT_RESPONSES` nicht gesetzt ist, steuert `OTEL_LOG_USER_PROMPTS` es stattdessen, daher setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=0`, um Antworten redaktioniert zu halten, während die Eingabeaufforderungs-Protokollierung aktiv ist815* `response`: Antworttext, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Standardmäßig auf `<REDACTED>` reduziert. Setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=1`, um ihn einzuschließen. Wenn `OTEL_LOG_ASSISTANT_RESPONSES` nicht gesetzt ist, steuert `OTEL_LOG_USER_PROMPTS` es stattdessen, daher setzen Sie `OTEL_LOG_ASSISTANT_RESPONSES=0`, um Antworten reduziert zu halten, während die Eingabeaufforderungs-Protokollierung aktiv ist

773* `model`: Modellkennung (z. B. „claude-sonnet-5")816* `model`: Modellkennung (z. B. „claude-sonnet-5")

774* `request_id`: Anthropic API-Anfrage-ID aus dem `request-id`-Header der Antwort. Nur vorhanden, wenn die API eine zurückgibt817* `request_id`: API-Anfrage-ID, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

775* `message.uuid`: UUID des endgültigen Transkripteintrags der Antwort. Eine API-Antwort wird als ein Transkripteintrag pro Inhaltsblock gespeichert; dies ist der letzte, von dem die `parentUuid` des nächsten Zuges verkettet wird. Erfordert Claude Code v2.1.214 oder später818* `message.uuid`: UUID des letzten Transkriptionseintrag der Antwort. Eine API-Antwort wird als ein Transkriptionseintrag pro Inhaltsblock gespeichert; dies ist der letzte, von dem die `parentUuid` des nächsten Zuges verkettet wird. Erfordert Claude Code v2.1.214 oder später

776* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name819* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

777 820

778<h4 id="tool-result-event">821<h4 id="tool-result-event">

795* `duration_ms`: Ausführungszeit in Millisekunden838* `duration_ms`: Ausführungszeit in Millisekunden

796* `error_type`: Fehler-Kategoriezeichenkette, wenn das Tool fehlgeschlagen ist, z. B. `"Error:ENOENT"` oder `"ShellError"`839* `error_type`: Fehler-Kategoriezeichenkette, wenn das Tool fehlgeschlagen ist, z. B. `"Error:ENOENT"` oder `"ShellError"`

797* `error` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Vollständige Fehlermeldung, wenn das Tool fehlgeschlagen ist840* `error` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Vollständige Fehlermeldung, wenn das Tool fehlgeschlagen ist

798* `decision_type`: Immer `"accept"`, da dieses Ereignis nur ausgegeben wird, nachdem das Tool ausgeführt wurde. Abgelehnte Aufrufe erzeugen kein Tool-Ergebnis841* `decision_type`: Immer `"accept"`, da dieses Ereignis nur nach der Tool-Ausführung ausgegeben wird. Abgelehnte Aufrufe erzeugen kein Tool-Ergebnis

799* `decision_source`: Woher die Genehmigungsentscheidung kam. Einer von `"config"`, `"hook"`, `"user_permanent"` oder `"user_temporary"`. Siehe das [Tool-Entscheidungsereignis](#tool-decision-event) für die Bedeutung jedes Wertes. Die nur-Ablehnung-Quellen `"user_abort"` und `"user_reject"` erscheinen niemals auf diesem Ereignis.842* `decision_source`: Woher die Berechtigungsentscheidung kam. Einer von `"config"`, `"hook"`, `"user_permanent"` oder `"user_temporary"`. Siehe das [Tool-Entscheidungsereignis](#tool-decision-event) für die Bedeutung jedes Wertes. Die nur-Ablehnung-Quellen `"user_abort"` und `"user_reject"` erscheinen niemals auf diesem Ereignis.

800* `tool_input_size_bytes`: Größe der JSON-serialisierten Tool-Eingabe in Bytes843* `tool_input_size_bytes`: Größe der JSON-serialisierten Tool-Eingabe in Bytes

801* `tool_result_size_bytes`: Größe des Tool-Ergebnisses in Bytes844* `tool_result_size_bytes`: Größe des Tool-Ergebnisses in Bytes

802* `mcp_server_scope`: MCP-Server-Scope-Kennung (für MCP-Tools)845* `mcp_server_scope`: MCP-Server-Bereichskennung (für MCP-Tools)

803* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (wenn `OTEL_LOG_TOOL_DETAILS=1`): die Commit-Identität eines erfolgreichen `git commit`-Laufs durch das Bash- oder PowerShell-Tool. `vcs.ref.head.revision` ist die Commit-SHA, `vcs.ref.head.name` ist der Branch, auf dem es committed wurde, und `vcs.ref.head.type` ist `branch`. Der Name und Typ werden weggelassen, wenn der Commit auf einem detached HEAD gemacht wurde. Erfordert Claude Code v2.1.269 oder später846* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (wenn `OTEL_LOG_TOOL_DETAILS=1`): die Commit-Identität eines erfolgreichen `git commit`-Laufs durch das Bash- oder PowerShell-Tool. `vcs.ref.head.revision` ist die Commit-SHA, `vcs.ref.head.name` ist der Branch, auf dem es committed wurde, und `vcs.ref.head.type` ist `branch`. Der Name und Typ werden weggelassen, wenn der Commit auf einem detached HEAD gemacht wurde. Erfordert Claude Code v2.1.269 oder später

804* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-Zeichenkette mit Tool-spezifischen Parametern. Für die integrierten Server von Claude Desktop in Sitzungen, die Claude Desktop besitzt, ist das Paar `mcp_server_name`/`mcp_tool_name` auch ohne das Flag enthalten, die gleiche Host-erstellte Ausnahme wie das [Tool-Entscheidungsereignis](#tool-decision-event), erfordert Claude Code v2.1.214 oder später. Die Parameter variieren je nach Tool:847* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-Zeichenkette mit Tool-spezifischen Parametern. Für die integrierten Server von Claude Desktop in Sitzungen, die Claude Desktop besitzt, ist das Paar `mcp_server_name`/`mcp_tool_name` auch ohne das Flag enthalten, die gleiche Host-erstellte Ausnahme wie das [Tool-Entscheidungsereignis](#tool-decision-event), erfordert Claude Code v2.1.214 oder später. Die Parameter variieren je nach Tool:

805 * Für Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description` und `dangerouslyDisableSandbox`, plus `git_commit_id` und `git_branch`, wenn ein `git commit`-Befehl erfolgreich ist. `git_commit_id` ist die vollständige Commit-SHA, wenn der Commit der HEAD der Arbeitsverzeichnis der Sitzung ist, und Gits abgekürzte SHA andernfalls. `git_branch` ist der Branch, auf dem es committed wurde, weggelassen auf einem detached HEAD848 * Für Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description` und `dangerouslyDisableSandbox`, plus `git_commit_id` und `git_branch`, wenn ein `git commit`-Befehl erfolgreich ist. `git_commit_id` ist die vollständige Commit-SHA, wenn der Commit der HEAD der Arbeitsverzeichnis der Sitzung ist, und Gits abgekürzte SHA andernfalls. `git_branch` ist der Branch, auf dem es committed wurde, weggelassen auf einem detached HEAD

831* `output_tokens`: Anzahl der Ausgabe-Token874* `output_tokens`: Anzahl der Ausgabe-Token

832* `cache_read_tokens`: Anzahl der aus dem Cache gelesenen Token875* `cache_read_tokens`: Anzahl der aus dem Cache gelesenen Token

833* `cache_creation_tokens`: Anzahl der für die Cache-Erstellung verwendeten Token876* `cache_creation_tokens`: Anzahl der für die Cache-Erstellung verwendeten Token

834* `request_id`: Anthropic API-Anfrage-ID aus dem `request-id`-Header der Antwort, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.877* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).

835* `client_request_id`: Von Client generierte UUID, die als `x-client-request-id`-Request-Header gesendet wird; siehe die Tabelle [Ereigniskorrelationsattribute](#event-correlation-attributes) für wann sie vorhanden ist. Erfordert Claude Code v2.1.214 oder später878* `client_request_id`: Client-generierte UUID, die als `x-client-request-id`-Anfragekopfzeile gesendet wird; siehe die Tabelle [Ereigniskorrelationsattribute](#event-correlation-attributes) für wann sie vorhanden ist. Erfordert Claude Code v2.1.214 oder später

836* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war879* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war

837* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name880* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

838* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.881* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.

857* `status_code`: HTTP-Statuscode als Zahl. Nicht vorhanden für Nicht-HTTP-Fehler wie Verbindungsfehler.900* `status_code`: HTTP-Statuscode als Zahl. Nicht vorhanden für Nicht-HTTP-Fehler wie Verbindungsfehler.

858* `duration_ms`: Anfrage-Dauer in Millisekunden901* `duration_ms`: Anfrage-Dauer in Millisekunden

859* `attempt`: Gesamtzahl der Versuche, einschließlich der ursprünglichen Anfrage (`1` bedeutet, dass keine Wiederholungen aufgetreten sind)902* `attempt`: Gesamtzahl der Versuche, einschließlich der ursprünglichen Anfrage (`1` bedeutet, dass keine Wiederholungen aufgetreten sind)

860* `request_id`: Anthropic API-Anfrage-ID aus dem `request-id`-Header der Antwort, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.903* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).

861* `client_request_id`: Von Client generierte UUID, die als `x-client-request-id`-Request-Header gesendet wird. Verfügbar auch wenn ein Fehler wie ein Timeout oder Verbindungsfehler nie eine Server-`request_id` erzeugt hat; siehe die Tabelle [Ereigniskorrelationsattribute](#event-correlation-attributes) für wann sie vorhanden ist. Erfordert Claude Code v2.1.214 oder später904* `client_request_id`: Client-generierte UUID, die als `x-client-request-id`-Anfragekopfzeile gesendet wird. Verfügbar auch wenn ein Fehler wie ein Timeout oder Verbindungsfehler nie eine Server-`request_id` erzeugt hat; siehe die Tabelle [Ereigniskorrelationsattribute](#event-correlation-attributes) für wann sie vorhanden ist. Erfordert Claude Code v2.1.214 oder später

862* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war905* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war

863* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name906* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

864* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.907* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.

868 API-Ablehnung-Ereignis911 API-Ablehnung-Ereignis

869</h4>912</h4>

870 913

871Protokolliert, wenn eine API-Anfrage `stop_reason: "refusal"` zurückgibt. Ablehnungen kommen auf einem erfolgreichen Response-Stream statt als HTTP-Fehler an, daher wird das `api_error`-Ereignis nicht für sie ausgelöst. Dieses Ereignis ermöglicht es Ihnen, die Ablehnungshäufigkeit zu verfolgen und Ablehnungen nach denselben Attributen wie `api_request` und `api_error` zu gruppieren.914Protokolliert, wenn eine API-Anfrage `stop_reason: "refusal"` zurückgibt. Ablehnungen kommen auf einem erfolgreichen Antwortstrom statt als HTTP-Fehler an, daher wird das `api_error`-Ereignis nicht für sie ausgelöst. Dieses Ereignis ermöglicht es Ihnen, die Ablehnungshäufigkeit zu verfolgen und Ablehnungen nach denselben Attributen wie `api_request` und `api_error` zu gruppieren.

872 915

873**Ereignisname**: `claude_code.api_refusal`916**Ereignisname**: `claude_code.api_refusal`

874 917

879* `event.timestamp`: ISO 8601-Zeitstempel922* `event.timestamp`: ISO 8601-Zeitstempel

880* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)923* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

881* `model`: Modellkennung aus der Anfrage924* `model`: Modellkennung aus der Anfrage

882* `request_id`: Anthropic API-Anfrage-ID aus dem `request-id`-Header der Antwort, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.925* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).

883* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name. Siehe [`api_request`](#api-request-event) für Definitionen.926* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name. Siehe [`api_request`](#api-request-event) für Definitionen.

884* `speed`: Entweder `"fast"`, wenn [Schneller Modus](/docs/de/fast-mode) aktiv ist, oder `"normal"`927* `speed`: Entweder `"fast"`, wenn [Schneller Modus](/docs/de/fast-mode) aktiv ist, oder `"normal"`

885* `attempt`: Wiederholungsversuch-Nummer. Der erste Versuch ist `1`.928* `attempt`: Wiederholungsversuch-Nummer. Der erste Versuch ist `1`.

886* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.929* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn Claude Code keine Anstrengungsstufe sendet, z. B. bei einem Modell, das Anstrengung nicht unterstützt.

887* `server_fallback_hop`: `true`, wenn das Server-seitige Modell-Fallback diesen Fehler bereits auf einem anderen Modell erneut versucht hat, daher hat der Benutzer diese bestimmte Ablehnung nicht gesehen. `false`, wenn die Anfrage in einer Ablehnung endete. Ein einzelner Zug kann sowohl ein `true`-Hop-Ereignis als auch ein späteres `false`-Finales Ereignis ausgeben, wenn das Fallback-Modell auch ablehnt.930* `server_fallback_hop`: `true`, wenn das API-seitige Modell-Fallback diese Ablehnung bereits auf einem anderen Modell erneut versucht hat, daher hat der Benutzer diese bestimmte Ablehnung nicht gesehen. `false`, wenn die Anfrage in einer Ablehnung endete. Ein einzelner Zug kann sowohl ein `true`-Hop-Ereignis als auch ein späteres `false`-Finales Ereignis ausgeben, wenn das Fallback-Modell auch ablehnt.

888* `has_category`: `true`, wenn die API-Antwort eine `stop_details.category` von `"cyber"`, `"bio"`, `"frontier_llm"` oder `"reasoning_extraction"` trug. `false`, wenn die Antwort keine Kategorie oder einen Wert außerhalb dieses Satzes trug. Nicht vorhanden, wenn `server_fallback_hop` `true` ist, da Hop-Blöcke keine `stop_details` tragen.931* `has_category`: `true`, wenn die API-Antwort eine `stop_details.category` von `"cyber"`, `"bio"`, `"frontier_llm"` oder `"reasoning_extraction"` trug. `false`, wenn die Antwort keine Kategorie oder einen Wert außerhalb dieses Satzes trug. Nicht vorhanden, wenn `server_fallback_hop` `true` ist, da Hop-Blöcke keine `stop_details` tragen.

889* `has_explanation`: `true`, wenn die API-Antwort eine `stop_details.explanation` trug, andernfalls `false`. Nicht vorhanden, wenn `server_fallback_hop` `true` ist.932* `has_explanation`: `true`, wenn die API-Antwort eine `stop_details.explanation` trug, andernfalls `false`. Nicht vorhanden, wenn `server_fallback_hop` `true` ist.

890* `category`: Der `stop_details.category`-Wert aus der API-Antwort. Einer von `"cyber"`, `"bio"`, `"frontier_llm"` oder `"reasoning_extraction"`. Nur vorhanden, wenn `OTEL_LOG_TOOL_DETAILS=1` gesetzt ist und `has_category` `true` ist.933* `category`: Der `stop_details.category`-Wert aus der API-Antwort. Einer von `"cyber"`, `"bio"`, `"frontier_llm"` oder `"reasoning_extraction"`. Nur vorhanden, wenn `OTEL_LOG_TOOL_DETAILS=1` gesetzt ist und `has_category` `true` ist.

904* `event.name`: `"api_request_body"`947* `event.name`: `"api_request_body"`

905* `event.timestamp`: ISO 8601-Zeitstempel948* `event.timestamp`: ISO 8601-Zeitstempel

906* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)949* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

907* `body`: JSON-serialisierte Messages API-Anfrage-Parameter, wie die System-Eingabeaufforderung, Nachrichten und Tools, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Extended-Thinking-Inhalte in vorherigen Assistent-Zügen sind redaktioniert. Nur im Inline-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=1`).950* `body`: JSON-serialisierte Messages API-Anfrage-Parameter, z. B. die System-Eingabeaufforderung, Nachrichten und Tools, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Erweiterter Denkinhalt in vorherigen Assistent-Zügen wird reduziert. Nur im Inline-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=1`).

908* `body_ref`: Absoluter Pfad zu einer `<dir>/<uuid>.request.json`-Datei, die den ungekürzte Body enthält. Nur im Datei-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).951* `body_ref`: Absoluter Pfad zu einer `<dir>/<uuid>.request.json`-Datei, die den ungekürzte Body enthält. Nur im Datei-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

909* `body_length`: Ungekürzte Body-Länge. UTF-8-Bytes, wenn `OTEL_LOG_RAW_API_BODIES=file:<dir>`, oder UTF-16-Code-Einheiten, wenn `=1`952* `body_length`: Ungekürzte Body-Länge. UTF-8-Bytes, wenn `OTEL_LOG_RAW_API_BODIES=file:<dir>`, oder UTF-16-Code-Einheiten, wenn `=1`

910* `body_truncated`: `"true"`, wenn Inline-Kürzung aufgetreten ist. Nicht vorhanden im Datei-Modus und wenn keine Kürzung aufgetreten ist.953* `body_truncated`: `"true"`, wenn Inline-Kürzung aufgetreten ist. Nicht vorhanden im Datei-Modus und wenn keine Kürzung aufgetreten ist.

911* `model`: Modellkennung aus den Anfrage-Parametern954* `model`: Modellkennung aus den Anfrage-Parametern

912* `query_source`: Subsystem, das die Anfrage gestellt hat (z. B. `"compact"`)955* `query_source`: Subsystem, das die Anfrage gestellt hat (z. B. `"compact"`)

913* `request_body_id`: UUID, die den Body dieses Versuchs identifiziert. Das [`api_response_body`-Ereignis](#api-response-body-event) für den Versuch, der erfolgreich ist, trägt denselben Wert, daher können Sie eine Antwort mit der genauen Anfrage, die sie erzeugt hat, paaren. Erfordert Claude Code v2.1.274 oder später956* `request_body_id`: UUID, die den Body dieser Anfrage identifiziert. Das [`api_response_body`-Ereignis](#api-response-body-event) für den Versuch, der erfolgreich ist, trägt denselben Wert, daher können Sie eine Antwort mit der genauen Anfrage, die sie erzeugt hat, paaren. Erfordert Claude Code v2.1.274 oder später

914 957

915<h4 id="api-response-body-event">958<h4 id="api-response-body-event">

916 API-Antwort-Body-Ereignis959 API-Antwort-Body-Ereignis

918 961

919Protokolliert für jede erfolgreiche API-Antwort, wenn `OTEL_LOG_RAW_API_BODIES` gesetzt ist.962Protokolliert für jede erfolgreiche API-Antwort, wenn `OTEL_LOG_RAW_API_BODIES` gesetzt ist.

920 963

921Im Datei-Modus (`OTEL_LOG_RAW_API_BODIES=file:<dir>`) hängt Claude Code auch eine JSON-Zeile an `<dir>/index.jsonl` für jede erfolgreiche Antwort an, mit den Feldern `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` und `response_file`. Lesen Sie es, um die Anfrage- und Antwort-Dateien hinter einer bestimmten Transkript-Nachricht zu finden, ohne Ihren Telemetrie-Backend abzufragen. Die Index-Datei erfordert Claude Code v2.1.274 oder später.964Im Datei-Modus (`OTEL_LOG_RAW_API_BODIES=file:<dir>`) hängt Claude Code auch eine JSON-Zeile an `<dir>/index.jsonl` für jede erfolgreiche Antwort an, mit den Feldern `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` und `response_file`. Lesen Sie sie, um die Anfrage- und Antwortdateien hinter einer bestimmten Transkript-Nachricht zu finden, ohne Ihren Telemetrie-Backend abzufragen. Die Index-Datei erfordert Claude Code v2.1.274 oder später.

922 965

923**Ereignisname**: `claude_code.api_response_body`966**Ereignisname**: `claude_code.api_response_body`

924 967

928* `event.name`: `"api_response_body"`971* `event.name`: `"api_response_body"`

929* `event.timestamp`: ISO 8601-Zeitstempel972* `event.timestamp`: ISO 8601-Zeitstempel

930* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)973* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

931* `body`: JSON-serialisierte Messages API-Antwort, einschließlich der ID, Inhaltsblöcke, Nutzung und Stop-Grund, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Extended-Thinking-Inhalte sind redaktioniert. Nur im Inline-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=1`).974* `body`: JSON-serialisierte Messages API-Antwort, einschließlich der ID, Inhaltsblöcke, Nutzung und Stop-Grund, gekürzt auf das Inhaltslimit (standardmäßig 60 KB). Erweiterter Denkinhalt wird reduziert. Nur im Inline-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=1`).

932* `body_ref`: Absoluter Pfad zu einer `<dir>/<request_id>.response.json`-Datei, die den ungekürzte Body enthält. Nur im Datei-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).975* `body_ref`: Absoluter Pfad zu einer `<dir>/<request_id>.response.json`-Datei, die den ungekürzte Body enthält. Nur im Datei-Modus ausgegeben (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

933* `body_length`: Ungekürzte Body-Länge. UTF-8-Bytes, wenn `OTEL_LOG_RAW_API_BODIES=file:<dir>`, oder UTF-16-Code-Einheiten, wenn `=1`976* `body_length`: Ungekürzte Body-Länge. UTF-8-Bytes, wenn `OTEL_LOG_RAW_API_BODIES=file:<dir>`, oder UTF-16-Code-Einheiten, wenn `=1`

934* `body_truncated`: `"true"`, wenn Inline-Kürzung aufgetreten ist. Nicht vorhanden im Datei-Modus und wenn keine Kürzung aufgetreten ist.977* `body_truncated`: `"true"`, wenn Inline-Kürzung aufgetreten ist. Nicht vorhanden im Datei-Modus und wenn keine Kürzung aufgetreten ist.

935* `model`: Modellkennung978* `model`: Modellkennung

936* `query_source`: Subsystem, das die Anfrage gestellt hat979* `query_source`: Subsystem, das die Anfrage gestellt hat

937* `request_id`: Anthropic API-Anfrage-ID aus dem `request-id`-Header der Antwort, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.980* `request_id`: API-Anfrage-ID, z. B. `"req_011..."`, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes).

938* `request_body_id`: Die `request_body_id` des [`api_request_body`-Ereignisses](#api-request-body-event), das diese Antwort beantwortet. Erfordert Claude Code v2.1.274 oder später981* `request_body_id`: Die `request_body_id` des [`api_request_body`-Ereignisses](#api-request-body-event), das diese Antwort beantwortet. Erfordert Claude Code v2.1.274 oder später

939* `message.id`: Nachrichten-ID, die die API der Antwort zugewiesen hat, das `id`-Feld des Response-Body. Erfordert Claude Code v2.1.274 oder später982* `message.id`: Nachrichten-ID, die die API der Antwort zugewiesen hat, das `id`-Feld des Antwortkörpers. Erfordert Claude Code v2.1.274 oder später

940* `message.uuid`: UUID des endgültigen Transkripteintrags der Antwort. Zusammen mit `request_body_id` verknüpft es eine Transkript-Nachricht mit den Anfrage- und Antwort-Bodies dahinter. Erfordert Claude Code v2.1.274 oder später983* `message.uuid`: UUID des letzten Transkriptionseintrag der Antwort. Zusammen mit `request_body_id` verknüpft es eine Transkript-Nachricht mit den Anfrage- und Antwortbodies dahinter. Erfordert Claude Code v2.1.274 oder später

941 984

942<h4 id="tool-decision-event">985<h4 id="tool-decision-event">

943 Tool-Entscheidungs-Ereignis986 Tool-Entscheidungs-Ereignis

944</h4>987</h4>

945 988

946Protokolliert, wenn eine Tool-Genehmigungsentscheidung getroffen wird (akzeptieren/ablehnen).989Protokolliert, wenn eine Tool-Berechtigungsentscheidung getroffen wird (akzeptieren/ablehnen).

947 990

948**Ereignisname**: `claude_code.tool_decision`991**Ereignisname**: `claude_code.tool_decision`

949 992

959* `tool_source`: Immer vorhanden. Die Herkunft des Tools als geschlossener Satz von CLI-erstellten Werten. Erfordert Claude Code v2.1.214 oder später1002* `tool_source`: Immer vorhanden. Die Herkunft des Tools als geschlossener Satz von CLI-erstellten Werten. Erfordert Claude Code v2.1.214 oder später

960 * `"builtin"`: die eigenen Tools der CLI1003 * `"builtin"`: die eigenen Tools der CLI

961 * `"mcp"`: MCP-Server allgemein1004 * `"mcp"`: MCP-Server allgemein

962 * `"sdk_host_builtin_mcp"`: ein In-Process-Server, der in Claude Desktop selbst integriert ist, in einer Sitzung, die Claude Desktop besitzt. Claude Desktop besitzt eine Sitzung, die es von einem seiner eigenen Einstiegspunkte gestartet hat, `claude-desktop`, `claude-desktop-3p` oder `local-agent`, wenn diese Sitzung kein verschachteltes Kind ist; verschachtelte Sitzungen, einschließlich Sitzungen, die Claude Code selbst erzeugt, melden diese Server als `"mcp"`1005 * `"sdk_host_builtin_mcp"`: ein In-Prozess-Server, der in Claude Desktop selbst integriert ist, in einer Sitzung, die Claude Desktop besitzt. Claude Desktop besitzt eine Sitzung, die es von einem seiner eigenen Einstiegspunkte gestartet hat, `claude-desktop`, `claude-desktop-3p` oder `local-agent`, wenn diese Sitzung kein verschachteltes Kind ist; verschachtelte Sitzungen, einschließlich Sitzungen, die Claude Code selbst erzeugt, melden diese Server als `"mcp"`

963* `source`: Woher die Entscheidung kam:1006* `source`: Woher die Entscheidung kam:

964 * `"config"`: Automatisch entschieden ohne Eingabeaufforderung, basierend auf Projekteinstellungen, Zulassungs- oder Ablehnungsregeln in den persönlichen Einstellungen des Benutzers, Unternehmensrichtlinie, `--allowedTools`- oder `--disallowedTools`-Flags, dem aktiven Genehmigungsmodus, einer Sitzungs-Zuschuss aus einer früheren Eingabeaufforderung in derselben interaktiven CLI-Sitzung, oder weil das Tool inhärent sicher ist. Das Ereignis zeigt nicht an, welche dieser Quellen übereinstimmte. Claude Code meldet auch `"config"`, wenn die Genehmigungsaufforderungs-Anfrage selbst fehlschlägt, z. B. wenn der [`canUseTool`](/docs/de/agent-sdk/typescript#canusetool)-Callback des Agent SDK oder das [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Tool ein ungültiges Ergebnis zurückgibt, oder wenn der Eingabestrom geschlossen wird, während die Anfrage ausstehend ist. Vor v2.1.216 meldete Claude Code diese Fehler als `"user_reject"`.1007 * `"config"`: Automatisch entschieden ohne Eingabeaufforderung, basierend auf Projekteinstellungen, Zulassungs- oder Ablehnungsregeln in den persönlichen Einstellungen des Benutzers, Unternehmensrichtlinie, `--allowedTools`- oder `--disallowedTools`-Flags, dem aktiven Berechtigungsmodus, einer Sitzungs-Zuschuss aus einer früheren Eingabeaufforderung in derselben interaktiven CLI-Sitzung, oder weil das Tool inhärent sicher ist. Das Ereignis gibt nicht an, welche dieser Quellen übereinstimmte. Claude Code meldet auch `"config"`, wenn die Berechtigungsaufforderungs-Anfrage selbst fehlschlägt, z. B. wenn der [`canUseTool`](/docs/de/agent-sdk/typescript#canusetool)-Callback des Agent SDK oder das [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)-Tool ein ungültiges Ergebnis zurückgibt, oder wenn der Eingabestrom geschlossen wird, während die Anfrage ausstehend ist. Vor v2.1.216 meldete Claude Code diese Fehler als `"user_reject"`.

965 * `"hook"`: Ein `PreToolUse`- oder `PermissionRequest`-Hook gab die Entscheidung zurück.1008 * `"hook"`: Ein `PreToolUse`- oder `PermissionRequest`-Hook gab die Entscheidung zurück.

966 * `"user_permanent"`: Ausgegeben, wenn der Benutzer „Ja, und nicht mehr fragen für ..." bei einer Genehmigungsaufforderung wählte, was eine Zulassungsregel in seinen persönlichen Einstellungen speichert. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; spätere Aufrufe, die die gespeicherte Regel erfüllen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben sowohl die ursprüngliche Wahl als auch spätere Regelübereinstimmungen `"user_permanent"` aus. Wird als Akzeptanz behandelt.1009 * `"user_permanent"`: Ausgegeben, wenn der Benutzer „Ja, und nicht mehr fragen für ..." bei einer Berechtigungsaufforderung wählte, was eine Zulassungsregel in seinen persönlichen Einstellungen speichert. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; spätere Aufrufe, die die gespeicherte Regel erfüllen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben sowohl die ursprüngliche Wahl als auch spätere Regelübereinstimmungen `"user_permanent"` aus. Wird als Akzeptanz behandelt.

967 * `"user_temporary"`: Ausgegeben, wenn der Benutzer „Ja" bei einer Genehmigungsaufforderung für eine einmalige Genehmigung wählte, oder eine Option wählte, die Zugriff für den Rest der Sitzung bei einer Datei-Bearbeitungs- oder Lese-Aufforderung gewährt. In der interaktiven CLI wird dies nur für die Wahl selbst ausgegeben; spätere Aufrufe, die durch diesen Sitzungs-Zuschuss erlaubt sind, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben sowohl die Wahl als auch spätere Übereinstimmungen `"user_temporary"` aus. Wird als Akzeptanz behandelt.1010 * `"user_temporary"`: Ausgegeben, wenn der Benutzer „Ja" bei einer Berechtigungsaufforderung für eine einmalige Genehmigung wählte, oder eine Option wählte, die Zugriff für den Rest der Sitzung bei einer Datei-Bearbeitungs- oder Leseanforderung gewährt. In der interaktiven CLI wird dies nur für die Wahl selbst ausgegeben; spätere Aufrufe, die durch diesen Sitzungs-Zuschuss erlaubt sind, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben sowohl die Wahl als auch spätere Übereinstimmungen `"user_temporary"` aus. Wird als Akzeptanz behandelt.

968 * `"user_abort"`: Ausgegeben, wenn der Benutzer die Genehmigungsaufforderung ohne Antwort schloss. In Agent SDK- und nicht-interaktiven `-p`-Sitzungen schließt dies das Unterbrechen des Zuges ein, während eine `canUseTool`- oder `--permission-prompt-tool`-Genehmigungsanfrage ausstehend ist; vor v2.1.216 meldete Claude Code diese Unterbrechung als `"user_reject"`. Wird als Ablehnung behandelt.1011 * `"user_abort"`: Ausgegeben, wenn der Benutzer die Berechtigungsaufforderung geschlossen hat, ohne zu antworten. In Agent SDK- und nicht-interaktiven `-p`-Sitzungen schließt dies auch das Unterbrechen des Zuges ein, während eine `canUseTool`- oder `--permission-prompt-tool`-Berechtigungsanfrage ausstehend ist; vor v2.1.216 meldete Claude Code diese Unterbrechung als `"user_reject"`. Wird als Ablehnung behandelt.

969 * `"user_reject"`: Ausgegeben, wenn der Benutzer „Nein" bei einer Aufforderung wählte. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; Aufrufe, die eine Ablehnungsregel in den persönlichen Einstellungen des Benutzers erfüllen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben Aufrufe, die eine Ablehnungsregel in persönlichen Einstellungen erfüllen, `"user_reject"` aus. Wird als Ablehnung behandelt.1012 * `"user_reject"`: Ausgegeben, wenn der Benutzer „Nein" bei einer Aufforderung wählte. In der interaktiven CLI wird dies nur für diese Wahl selbst ausgegeben; Aufrufe, die eine Ablehnungsregel in den persönlichen Einstellungen des Benutzers erfüllen, geben stattdessen `"config"` aus. In Agent SDK- oder nicht-interaktiven `-p`-Sitzungen geben Aufrufe, die eine Ablehnungsregel in persönlichen Einstellungen erfüllen, `"user_reject"` aus. Wird als Ablehnung behandelt.

970* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-Zeichenkette mit Tool-spezifischen Parametern. Gleiche Form wie das [Tool-Ergebnis-Ereignis](#tool-result-event), minus Post-Ausführungs-Felder wie `git_commit_id`. Werte können sich von `tool_result` für einen akzeptierten Aufruf unterscheiden, wenn die Genehmigungsentscheidung die Tool-Eingabe über `updatedInput` umschreibt. Verwenden Sie dieses Attribut, um zu sehen, welcher Befehl abgelehnt wurde, wenn `decision` `"reject"` ist.1013* `tool_parameters` (wenn `OTEL_LOG_TOOL_DETAILS=1`): JSON-Zeichenkette mit Tool-spezifischen Parametern. Gleiche Form wie das [Tool-Ergebnis-Ereignis](#tool-result-event), minus Post-Ausführungs-Felder wie `git_commit_id`. Werte können sich von `tool_result` für einen akzeptierten Aufruf unterscheiden, wenn die Berechtigungsentscheidung die Tool-Eingabe über `updatedInput` umschreibt. Verwenden Sie dieses Attribut, um zu sehen, welcher Befehl abgelehnt wurde, wenn `decision` `"reject"` ist.

971 * Für `"sdk_host_builtin_mcp"`-Tools: `mcp_server_name` und `mcp_tool_name` sind auch enthalten, wenn `OTEL_LOG_TOOL_DETAILS` aus ist, da die Host-Anwendung diese Namen definiert; ohne sie wäre ein abgelehnter Aufruf an einen dieser integrierten Server auf dem Standard-Stream nicht zuordenbar. Für benutzerkonfigurierte MCP-Server ist der `tool_name` des Ereignisses immer das Literal `"mcp_tool"`, und die Server- und Tool-Namen erscheinen nur in `tool_parameters` mit dem Flag an; Argument-Inhalte erfordern das Flag überall. Erfordert Claude Code v2.1.214 oder später1014 * Für `"sdk_host_builtin_mcp"`-Tools: `mcp_server_name` und `mcp_tool_name` sind auch enthalten, wenn `OTEL_LOG_TOOL_DETAILS` aus ist, da die Host-Anwendung diese Namen definiert; ohne sie wäre ein abgelehnter Aufruf an einen dieser integrierten Server auf dem Standard-Stream nicht zuordenbar. Für benutzerkonfigurierte MCP-Server ist der `tool_name` des Ereignisses immer das Literal `"mcp_tool"`, und die Server- und Tool-Namen erscheinen nur in `tool_parameters` mit dem Flag an; Argument-Inhalt erfordert das Flag überall. Erfordert Claude Code v2.1.214 oder später

972 * Für Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Das Workspace-Bash-Tool der Desktop-App meldet auch `tool_name` als `Bash`, enthält aber nur `bash_command`, `full_command` und `timeout`1015 * Für Bash-Tool: enthält `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Das Workspace-Bash-Tool der Desktop-App meldet auch `tool_name` als `Bash`, enthält aber nur `bash_command`, `full_command` und `timeout`

973 * Für MCP-Tools: enthält `mcp_server_name`, `mcp_tool_name`1016 * Für MCP-Tools: enthält `mcp_server_name`, `mcp_tool_name`

974 * Für Skill-Tool: enthält `skill_name`1017 * Für Skill-Tool: enthält `skill_name`

975 * Für Agent-Tool oder Legacy-Task-Tool: enthält `subagent_type`1018 * Für Agent-Tool oder Legacy-Task-Tool: enthält `subagent_type`

976 1019

977<h4 id="permission-mode-changed-event">1020<h4 id="permission-mode-changed-event">

978 Genehmigungsmodus-Änderungs-Ereignis1021 Berechtigungsmodus-Änderungs-Ereignis

979</h4>1022</h4>

980 1023

981Protokolliert, wenn sich der Genehmigungsmodus ändert, z. B. durch Shift+Tab-Zyklus, Beendigung des Plan-Modus oder eine Auto-Modus-Gate-Prüfung.1024Protokolliert, wenn sich der Berechtigungsmodus ändert, z. B. durch Shift+Tab-Zyklus, Beendigung des Plan-Modus oder eine Auto-Modus-Gate-Prüfung.

982 1025

983**Ereignisname**: `claude_code.permission_mode_changed`1026**Ereignisname**: `claude_code.permission_mode_changed`

984 1027

988* `event.name`: `"permission_mode_changed"`1031* `event.name`: `"permission_mode_changed"`

989* `event.timestamp`: ISO 8601-Zeitstempel1032* `event.timestamp`: ISO 8601-Zeitstempel

990* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1033* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

991* `from_mode`: Der vorherige Genehmigungsmodus, z. B. `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` oder `"bypassPermissions"`1034* `from_mode`: Der vorherige Berechtigungsmodus, z. B. `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` oder `"bypassPermissions"`

992* `to_mode`: Der neue Genehmigungsmodus1035* `to_mode`: Der neue Berechtigungsmodus

993* `trigger`: Was die Änderung verursacht hat. Einer von `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` oder `"auto_opt_in"`. Nicht vorhanden, wenn der Übergang vom SDK oder Bridge stammt1036* `trigger`: Was die Änderung verursacht hat. Einer von `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` oder `"auto_opt_in"`. Nicht vorhanden, wenn der Übergang vom SDK oder Bridge stammt

994 1037

995<h4 id="auth-event">1038<h4 id="auth-event">

1009* `action`: `"login"` oder `"logout"`1052* `action`: `"login"` oder `"logout"`

1010* `success`: `"true"` oder `"false"`1053* `success`: `"true"` oder `"false"`

1011* `auth_method`: Authentifizierungsmethode, z. B. `"oauth"`1054* `auth_method`: Authentifizierungsmethode, z. B. `"oauth"`

1012* `error_category`: Kategorische Fehlerart, wenn die Aktion fehlgeschlagen ist. Die rohe Fehlermeldung ist niemals enthalten1055* `error_category`: Kategorische Fehlerart, wenn die Aktion fehlgeschlagen ist. Die rohe Fehlermeldung ist nie enthalten

1013* `status_code`: HTTP-Statuscode als Zeichenkette, wenn die Aktion mit einem HTTP-Fehler fehlgeschlagen ist1056* `status_code`: HTTP-Statuscode als Zeichenkette, wenn die Aktion mit einem HTTP-Fehler fehlgeschlagen ist

1014 1057

1015<h4 id="mcp-server-connection-event">1058<h4 id="mcp-server-connection-event">

1016 MCP-Server-Verbindungs-Ereignis1059 MCP-Server-Verbindungs-Ereignis

1017</h4>1060</h4>

1018 1061

1019Protokolliert, wenn ein MCP-Server verbunden wird, die Verbindung trennt oder nicht verbunden werden kann.1062Protokolliert, wenn ein MCP-Server verbunden wird, getrennt wird oder keine Verbindung herstellen kann.

1020 1063

1021**Ereignisname**: `claude_code.mcp_server_connection`1064**Ereignisname**: `claude_code.mcp_server_connection`

1022 1065

1028* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1071* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1029* `status`: `"connected"`, `"failed"` oder `"disconnected"`1072* `status`: `"connected"`, `"failed"` oder `"disconnected"`

1030* `transport_type`: Server-Transport, z. B. `"stdio"`, `"sse"` oder `"http"`1073* `transport_type`: Server-Transport, z. B. `"stdio"`, `"sse"` oder `"http"`

1031* `server_scope`: Scope, auf dem der Server konfiguriert ist, z. B. `"user"`, `"project"` oder `"local"`1074* `server_scope`: Bereich, auf dem der Server konfiguriert ist, z. B. `"user"`, `"project"` oder `"local"`

1032* `duration_ms`: Verbindungsversuch-Dauer in Millisekunden1075* `duration_ms`: Verbindungsversuch-Dauer in Millisekunden

1033* `error_code`: Fehlercode, wenn die Verbindung fehlgeschlagen ist1076* `error_code`: Fehlercode, wenn die Verbindung fehlgeschlagen ist

1034* `is_plugin`: `true`, wenn der Server von einem Plugin bereitgestellt wird, `false` andernfalls1077* `is_plugin`: `true`, wenn der Server von einem Plugin bereitgestellt wird, `false` andernfalls

1035* `plugin_id_hash` (wenn `is_plugin` `true` ist): Stabiler Hash des Plugin-Namens und des Marketplace, zum Gruppieren von Ereignissen nach Plugin ohne Offenlegung des Namens. Claude Code berechnet ihn wie unter dem [Plugin-Laden-Ereignis](#plugin-loaded-event) beschrieben1078* `plugin_id_hash` (wenn `is_plugin` `true` ist): Stabiler Hash des Plugin-Namens und Marketplace, zum Gruppieren von Ereignissen nach Plugin, ohne den Namen freizulegen. Claude Code berechnet ihn wie unter dem [Plugin-Laden-Ereignis](#plugin-loaded-event) beschrieben

1036* `plugin.name` (wenn `is_plugin` `true` ist): Name des Plugins, das den Server bereitstellt. Für Drittanbieter-Plugins ist dieser die Literal-Zeichenkette `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`; dies schützt Drittanbieter-Plugin-Namen davor, standardmäßig in Protokollen zu erscheinen. Plugins aus offiziellen Anthropic-Quellen werden immer nach Name identifiziert. Die Attribute `plugin_id_hash` und `plugin.name` fließen zu Ihrem eigenen Monitoring-Backend und werden nicht an Anthropic gesendet1079* `plugin.name` (wenn `is_plugin` `true` ist): Name des Plugins, das den Server bereitstellt. Für Drittanbieter-Plugins ist dies das Literal `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`; dies schützt Drittanbieter-Plugin-Namen davor, standardmäßig in Protokollen zu erscheinen. Plugins aus offiziellen Anthropic-Quellen werden immer nach Name identifiziert. Die Attribute `plugin_id_hash` und `plugin.name` fließen zu Ihrem eigenen Monitoring-Backend und werden nicht an Anthropic gesendet

1037* `server_name` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Konfigurierter Server-Name1080* `server_name` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Konfigurierter Server-Name

1038* `error` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Vollständige Fehlermeldung, wenn die Verbindung fehlgeschlagen ist1081* `error` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Vollständige Fehlermeldung, wenn die Verbindung fehlgeschlagen ist

1039 1082

1041 Interner Fehler-Ereignis1084 Interner Fehler-Ereignis

1042</h4>1085</h4>

1043 1086

1044Protokolliert, wenn Claude Code einen unerwarteten internen Fehler abfängt. Nur der Fehlerklassen-Name und ein errno-ähnlicher Code werden aufgezeichnet. Die Fehlermeldung und Stack-Trace sind niemals enthalten. Dieses Ereignis wird nicht ausgegeben, wenn gegen Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry ausgeführt wird, oder wenn `DISABLE_ERROR_REPORTING` gesetzt ist.1087Protokolliert, wenn Claude Code einen unerwarteten internen Fehler abfängt. Nur der Fehlerklassen-Name und ein errno-ähnlicher Code werden aufgezeichnet. Die Fehlermeldung und Stack-Trace sind nie enthalten. Dieses Ereignis wird nicht ausgegeben, wenn gegen Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry ausgeführt wird, oder wenn `DISABLE_ERROR_REPORTING` gesetzt ist.

1045 1088

1046**Ereignisname**: `claude_code.internal_error`1089**Ereignisname**: `claude_code.internal_error`

1047 1090

1055* `error_code`: Node.js errno-Code wie `"ENOENT"`, wenn auf dem Fehler vorhanden1098* `error_code`: Node.js errno-Code wie `"ENOENT"`, wenn auf dem Fehler vorhanden

1056 1099

1057<h4 id="plugin-installed-event">1100<h4 id="plugin-installed-event">

1058 Plugin-Installiert-Ereignis1101 Plugin-Installation-Ereignis

1059</h4>1102</h4>

1060 1103

1061Protokolliert, wenn ein Plugin die Installation abgeschlossen hat, sowohl vom `claude plugin install`-CLI-Befehl als auch von der interaktiven `/plugin`-UI.1104Protokolliert, wenn ein Plugin die Installation abgeschlossen hat, sowohl vom `claude plugin install`-CLI-Befehl als auch von der interaktiven `/plugin`-Benutzeroberfläche.

1062 1105

1063**Ereignisname**: `claude_code.plugin_installed`1106**Ereignisname**: `claude_code.plugin_installed`

1064 1107

1075* `marketplace.name`: Marketplace, von dem das Plugin installiert wurde. Für Drittanbieter-Marketplaces ist dies nur enthalten, wenn `OTEL_LOG_TOOL_DETAILS=1`1118* `marketplace.name`: Marketplace, von dem das Plugin installiert wurde. Für Drittanbieter-Marketplaces ist dies nur enthalten, wenn `OTEL_LOG_TOOL_DETAILS=1`

1076 1119

1077<h4 id="plugin-loaded-event">1120<h4 id="plugin-loaded-event">

1078 Plugin-Geladen-Ereignis1121 Plugin-Laden-Ereignis

1079</h4>1122</h4>

1080 1123

1081Protokolliert einmal pro aktiviertem Plugin beim Sitzungsstart. Verwenden Sie dieses Ereignis, um zu inventarisieren, welche Plugins über Ihre Flotte aktiv sind, als Ergänzung zu `plugin_installed`, das die Installationsaktion selbst aufzeichnet.1124Protokolliert einmal pro aktiviertem Plugin beim Sitzungsstart. Verwenden Sie dieses Ereignis, um zu inventarisieren, welche Plugins über Ihre Flotte aktiv sind, als Ergänzung zu `plugin_installed`, das die Installationsaktion selbst aufzeichnet.

1089* `event.timestamp`: ISO 8601-Zeitstempel1132* `event.timestamp`: ISO 8601-Zeitstempel

1090* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1133* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1091* `plugin.name`: Name des Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`1134* `plugin.name`: Name des Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`

1092* `marketplace.name`: Marketplace, von dem das Plugin installiert wurde, wenn bekannt. Unter derselben Bedingung wie `plugin.name` auf `"third-party"` redaktioniert1135* `marketplace.name`: Marketplace, von dem das Plugin installiert wurde, wenn bekannt. Unter der gleichen Bedingung wie `plugin.name` auf `"third-party"` reduziert

1093* `plugin.version`: Version aus dem Plugin-Manifest. Nur enthalten, wenn der Name nicht redaktioniert ist und das Manifest eine Version deklariert1136* `plugin.version`: Version aus dem Plugin-Manifest. Nur enthalten, wenn der Name nicht reduziert ist und das Manifest eine Version deklariert

1094* `plugin.scope`: Herkunftskategorie für das Plugin: `"official"`, `"community"`, `"org"`, `"user-local"` oder `"default-bundle"`1137* `plugin.scope`: Herkunftskategorie für das Plugin: `"official"`, `"community"`, `"org"`, `"user-local"` oder `"default-bundle"`

1095* `enabled_via`: wie das Plugin aktiviert wurde: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` oder `"user-install"`. Der Wert `"admin-install"` bedeutet, dass das Plugin in [**Organisationseinstellungen > Plugins & Skills**](https://claude.ai/admin-settings/skills?tab=inventory) für Ihre Organisation erforderlich oder automatisch installiert ist. Vor v2.1.246 meldete Claude Code diese Plugins als `"user-install"` oder `"seed-mount"`1138* `enabled_via`: wie das Plugin aktiviert wurde: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` oder `"user-install"`. Der Wert `"admin-install"` bedeutet, dass das Plugin in [**Organisationseinstellungen > Plugins & Skills**](https://claude.ai/admin-settings/skills?tab=inventory) für Ihre Organisation erforderlich oder automatisch installiert ist. Vor v2.1.246 meldete Claude Code diese Plugins als `"user-install"` oder `"seed-mount"`

1096* `plugin_id_hash`: deterministischer Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, die unterschiedlichen Drittanbieter-Plugins, die über Ihre Flotte geladen werden, zu zählen, ohne ihre Namen aufzuzeichnen. Für [Plugins, die von claude.ai synchronisiert werden](/docs/de/plugins/loading#synced-plugins), hasht Claude Code den Plugin-Namen mit dem Marketplace-Namen, den claude.ai für das Plugin meldet, oder mit `synced` andernfalls. Vor v2.1.246 verwendete Claude Code den Marketplace-Namen, den claude.ai meldet, nicht im Hash1139* `plugin_id_hash`: deterministischer Hash des Plugin-Namens und Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, die unterschiedlichen Drittanbieter-Plugins, die über Ihre Flotte geladen werden, zu zählen, ohne ihre Namen aufzuzeichnen. Für [Plugins, die von claude.ai synchronisiert werden](/docs/de/plugins/loading#synced-plugins), hasht Claude Code den Plugin-Namen mit dem Marketplace-Namen, den claude.ai für das Plugin meldet, oder mit `synced` andernfalls. Vor v2.1.246 verwendete Claude Code den Marketplace-Namen, den claude.ai meldet, nicht im Hash

1097* `has_hooks`: ob das Plugin Hooks beiträgt1140* `has_hooks`: ob das Plugin Hooks beiträgt

1098* `has_mcp`: ob das Plugin MCP-Server beiträgt1141* `has_mcp`: ob das Plugin MCP-Server beiträgt

1099* `host_owned_mcp`: `true`, wenn der SDK-Host die MCP-Verbindungen dieses Plugins verwaltet und Claude Code das Lesen der MCP-Server-Konfiguration des Plugins übersprungen hat, `false` andernfalls. Erfordert Claude Code v2.1.172 oder später1142* `host_owned_mcp`: `true`, wenn der SDK-Host die MCP-Verbindungen dieses Plugins verwaltet und Claude Code das Lesen der MCP-Server-Konfiguration des Plugins übersprungen hat, `false` andernfalls. Erfordert Claude Code v2.1.172 oder später

1103* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Im sicheren Modus meldet dieses Ereignis nur konfigurierte Inventare; die Befehle, Skills, Hooks und MCP-Server des Plugins werden nicht geladen. Erfordert Claude Code v2.1.169 oder später1146* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Im sicheren Modus meldet dieses Ereignis nur konfigurierte Inventare; die Befehle, Skills, Hooks und MCP-Server des Plugins werden nicht geladen. Erfordert Claude Code v2.1.169 oder später

1104 1147

1105<h4 id="skill-activated-event">1148<h4 id="skill-activated-event">

1106 Skill-Aktiviert-Ereignis1149 Skill-Aktivierungs-Ereignis

1107</h4>1150</h4>

1108 1151

1109Protokolliert, wenn ein Skill aufgerufen wird, ob Claude ihn durch das Skill-Tool aufruft oder Sie ihn als `/`-Befehl ausführen.1152Protokolliert, wenn ein Skill aufgerufen wird, ob Claude ihn durch das Skill-Tool aufruft oder Sie ihn als `/`-Befehl ausführen.

1127 At-Mention-Ereignis1170 At-Mention-Ereignis

1128</h4>1171</h4>

1129 1172

1130Protokolliert, wenn Claude Code eine `@`-Erwähnung in einer Eingabeaufforderung auflöst. Nicht jede Erwähnung gibt ein Ereignis aus: Early-Exit-Pfade wie Genehmigungsablehnungen, übergroße Dateien, PDF-Referenz-Anhänge und Fehler beim Auflisten von Verzeichnissen geben zurück, ohne zu protokollieren.1173Protokolliert, wenn Claude Code eine `@`-Erwähnung in einer Eingabeaufforderung auflöst. Nicht jede Erwähnung gibt ein Ereignis aus: Early-Exit-Pfade wie Berechtigungsablehnungen, übergroße Dateien, PDF-Referenz-Anhänge und Fehler beim Auflisten von Verzeichnissen geben zurück, ohne zu protokollieren.

1131 1174

1132**Ereignisname**: `claude_code.at_mention`1175**Ereignisname**: `claude_code.at_mention`

1133 1176

1144 API-Wiederholungen-Erschöpft-Ereignis1187 API-Wiederholungen-Erschöpft-Ereignis

1145</h4>1188</h4>

1146 1189

1147Protokolliert einmal, wenn eine API-Anfrage nach mehr als einem Versuch fehlschlägt. Ausgegeben zusammen mit dem endgültigen `api_error`-Ereignis.1190Protokolliert einmal, wenn eine API-Anfrage nach mehr als einem Versuch fehlschlägt. Ausgegeben zusammen mit dem finalen `api_error`-Ereignis.

1148 1191

1149**Ereignisname**: `claude_code.api_retries_exhausted`1192**Ereignisname**: `claude_code.api_retries_exhausted`

1150 1193

1155* `event.timestamp`: ISO 8601-Zeitstempel1198* `event.timestamp`: ISO 8601-Zeitstempel

1156* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1199* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1157* `model`: Verwendetes Modell1200* `model`: Verwendetes Modell

1158* `error`: Endgültige Fehlermeldung1201* `error`: Letzte Fehlermeldung

1159* `status_code`: HTTP-Statuscode als Zahl. Nicht vorhanden für Nicht-HTTP-Fehler.1202* `status_code`: HTTP-Statuscode als Zahl. Nicht vorhanden für Nicht-HTTP-Fehler.

1160* `total_attempts`: Gesamtzahl der Versuche1203* `total_attempts`: Gesamtzahl der Versuche

1161* `total_retry_duration_ms`: Gesamte Wanduhr-Zeit über alle Versuche1204* `total_retry_duration_ms`: Gesamte Wanduhr-Zeit über alle Versuche

1162* `speed`: `"fast"` oder `"normal"`1205* `speed`: `"fast"` oder `"normal"`

1163 1206

1164<h4 id="hook-registered-event">1207<h4 id="hook-registered-event">

1165 Hook-Registriert-Ereignis1208 Hook-Registrierungs-Ereignis

1166</h4>1209</h4>

1167 1210

1168Protokolliert einmal pro konfiguriertem Hook beim Sitzungsstart. Verwenden Sie dieses Ereignis, um zu inventarisieren, welche Hooks über Ihre Flotte aktiv sind, als Ergänzung zu den Pro-Ausführungs-Ereignissen `hook_execution_start` und `hook_execution_complete`.1211Protokolliert einmal pro konfiguriertem Hook beim Sitzungsstart. Verwenden Sie dieses Ereignis, um zu inventarisieren, welche Hooks über Ihre Flotte aktiv sind, als Ergänzung zu den Pro-Ausführungs-Ereignissen `hook_execution_start` und `hook_execution_complete`.

1181* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später1224* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später

1182* `hook_matcher` (wenn `OTEL_LOG_TOOL_DETAILS=1`): die Matcher-Zeichenkette aus der Hook-Konfiguration, wenn eine gesetzt ist1225* `hook_matcher` (wenn `OTEL_LOG_TOOL_DETAILS=1`): die Matcher-Zeichenkette aus der Hook-Konfiguration, wenn eine gesetzt ist

1183* `plugin.name` (wenn `hook_source` `"pluginHook"` ist): Name des beitragenden Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`1226* `plugin.name` (wenn `hook_source` `"pluginHook"` ist): Name des beitragenden Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`

1184* `plugin_id_hash` (wenn `hook_source` `"pluginHook"` ist): deterministischer Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, unterschiedliche beitragende Plugins zu zählen, ohne ihre Namen aufzuzeichnen. Claude Code berechnet ihn wie unter dem [Plugin-Geladen-Ereignis](#plugin-loaded-event) beschrieben1227* `plugin_id_hash` (wenn `hook_source` `"pluginHook"` ist): deterministischer Hash des Plugin-Namens und Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, unterschiedliche beitragende Plugins zu zählen, ohne ihre Namen aufzuzeichnen. Claude Code berechnet ihn wie unter dem [Plugin-Laden-Ereignis](#plugin-loaded-event) beschrieben

1185 1228

1186<h4 id="hook-execution-start-event">1229<h4 id="hook-execution-start-event">

1187 Hook-Ausführungs-Start-Ereignis1230 Hook-Ausführungs-Start-Ereignis

1200* `hook_event`: Hook-Ereignistyp, z. B. `"PreToolUse"` oder `"PostToolUse"`1243* `hook_event`: Hook-Ereignistyp, z. B. `"PreToolUse"` oder `"PostToolUse"`

1201* `hook_name`: Vollständiger Hook-Name einschließlich Matcher, z. B. `"PreToolUse:Write"`1244* `hook_name`: Vollständiger Hook-Name einschließlich Matcher, z. B. `"PreToolUse:Write"`

1202* `num_hooks`: Anzahl der übereinstimmenden Hook-Befehle1245* `num_hooks`: Anzahl der übereinstimmenden Hook-Befehle

1203* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks zulässig sind1246* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks erlaubt sind

1204* `hook_source`: `"policySettings"` oder `"merged"`1247* `hook_source`: `"policySettings"` oder `"merged"`

1205* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später1248* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später

1206* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detaillierte Beta-Verfolgung als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind1249* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detaillierte Beta-Verfolgung als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind

1227* `num_non_blocking_error`: Anzahl, die fehlgeschlagen ist, ohne zu blockieren1270* `num_non_blocking_error`: Anzahl, die fehlgeschlagen ist, ohne zu blockieren

1228* `num_cancelled`: Anzahl, die vor Abschluss abgebrochen wurde1271* `num_cancelled`: Anzahl, die vor Abschluss abgebrochen wurde

1229* `total_duration_ms`: Wanduhr-Dauer aller übereinstimmenden Hooks1272* `total_duration_ms`: Wanduhr-Dauer aller übereinstimmenden Hooks

1230* `stdout_chars`: Gesamtzeichen von stdout über die übereinstimmenden Hooks, die erfolgreich waren. Erfordert Claude Code v2.1.280 oder später1273* `stdout_chars`: Gesamtzahl der Zeichen von stdout über die übereinstimmenden Hooks, die erfolgreich waren. Erfordert Claude Code v2.1.280 oder später

1231* `additional_context_chars`: Gesamtzeichen von `additionalContext`, die von den übereinstimmenden Hooks zurückgegeben wurden. Erfordert Claude Code v2.1.280 oder später1274* `additional_context_chars`: Gesamtzahl der Zeichen von `additionalContext`, die von den übereinstimmenden Hooks zurückgegeben wurden. Erfordert Claude Code v2.1.280 oder später

1232* `system_message_chars`: Gesamtzeichen von `systemMessage`, die von den übereinstimmenden Hooks zurückgegeben wurden. Erfordert Claude Code v2.1.280 oder später1275* `system_message_chars`: Gesamtzahl der Zeichen von `systemMessage`, die von den übereinstimmenden Hooks zurückgegeben wurden. Erfordert Claude Code v2.1.280 oder später

1233* `initial_user_message_chars`: Gesamtzeichen von `initialUserMessage`, die von den übereinstimmenden Hooks zurückgegeben wurden. Erfordert Claude Code v2.1.280 oder später1276* `initial_user_message_chars`: Gesamtzahl der Zeichen von `initialUserMessage`, die von den übereinstimmenden Hooks zurückgegeben wurden. Erfordert Claude Code v2.1.280 oder später

1234* `num_outputs_persisted`: Anzahl der Hook-Ausgaben über die [10.000-Zeichen-Obergrenze](/docs/de/hooks#json-output), die Claude Code in einer Datei gespeichert hat. Erfordert Claude Code v2.1.280 oder später1277* `num_outputs_persisted`: Anzahl der Hook-Ausgaben über die [10.000-Zeichen-Obergrenze](/docs/de/hooks#json-output), die Claude Code in einer Datei gespeichert hat. Erfordert Claude Code v2.1.280 oder später

1235* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks zulässig sind1278* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks erlaubt sind

1236* `hook_source`: `"policySettings"` oder `"merged"`1279* `hook_source`: `"policySettings"` oder `"merged"`

1237* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später1280* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später

1238* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detaillierte Beta-Verfolgung als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind1281* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detaillierte Beta-Verfolgung als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind

1241 Hook-Plugin-Metriken-Ereignis1284 Hook-Plugin-Metriken-Ereignis

1242</h4>1285</h4>

1243 1286

1244Protokolliert, wenn ein Hook eines offiziellen Marketplace-Plugins Pro-Aufruf-Metriken ausgibt. Nur Plugins, die von einem offiziellen Anthropic-Marketplace installiert wurden, können diese ausgeben. Drittanbieter-Marketplace-Plugins und benutzerkonfigurierte Hooks geben nicht an dieses Ereignis aus. Verwenden Sie dieses Ereignis, um Plugin-Verhalten wie Findungsraten, Kosten und Dauern aus Ihrem eigenen Observability-Stack zu überwachen.1287Protokolliert, wenn ein Hook eines offiziellen Marketplace-Plugins Pro-Aufruf-Metriken ausgibt. Nur Plugins, die aus einem offiziellen Anthropic-Marketplace installiert wurden, können diese ausgeben. Drittanbieter-Marketplace-Plugins und benutzerkonfigurierte Hooks geben nicht zu diesem Ereignis aus. Verwenden Sie dieses Ereignis, um Plugin-Verhalten wie Findungsraten, Kosten und Dauern aus Ihrem eigenen Observability-Stack zu überwachen.

1245 1288

1246**Ereignisname**: `claude_code.hook_plugin_metrics`1289**Ereignisname**: `claude_code.hook_plugin_metrics`

1247 1290

1253* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1296* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1254* `plugin_id`: Plugin-Kennung in `<name>@<marketplace>`-Form1297* `plugin_id`: Plugin-Kennung in `<name>@<marketplace>`-Form

1255* `hook_event`: Hook-Ereignistyp, der die Metriken ausgegeben hat1298* `hook_event`: Hook-Ereignistyp, der die Metriken ausgegeben hat

1256* Bis zu 20 Plugin-ausgegebene Metrik-Schlüssel. Namen entsprechen `^[a-z][a-z0-9_]{0,39}$`. Werte sind Boolean oder Zahl.1299* Bis zu 20 vom Plugin ausgegebene Metrik-Schlüssel. Namen entsprechen `^[a-z][a-z0-9_]{0,39}$`. Werte sind Boolean oder Zahl.

1257 1300

1258<h4 id="compaction-event">1301<h4 id="compaction-event">

1259 Kompaktierungs-Ereignis1302 Kompaktierungs-Ereignis

1278* `precompute_reuse`: Nur gesetzt, wenn `trigger` `"manual"` ist. Auto-Kompaktierung kann eine Zusammenfassung im Hintergrund vorbereiten, bevor das Kontextfenster voll wird, und dieses Attribut zeichnet auf, ob `/compact` diese vorbereitete Zusammenfassung wiederverwendet hat. `"hit"` bedeutet, dass sie wiederverwendet wurde; `"miss_custom_instructions"`, `"miss_hook"` und `"miss_not_ready"` geben den Grund an, warum stattdessen eine frische Zusammenfassung berechnet wurde. Erfordert Claude Code v2.1.153 oder später1321* `precompute_reuse`: Nur gesetzt, wenn `trigger` `"manual"` ist. Auto-Kompaktierung kann eine Zusammenfassung im Hintergrund vorbereiten, bevor das Kontextfenster voll wird, und dieses Attribut zeichnet auf, ob `/compact` diese vorbereitete Zusammenfassung wiederverwendet hat. `"hit"` bedeutet, dass sie wiederverwendet wurde; `"miss_custom_instructions"`, `"miss_hook"` und `"miss_not_ready"` geben den Grund an, warum stattdessen eine frische Zusammenfassung berechnet wurde. Erfordert Claude Code v2.1.153 oder später

1279 1322

1280<h4 id="subagent-completed-event">1323<h4 id="subagent-completed-event">

1281 Subagent-Abgeschlossen-Ereignis1324 Subagent-Abschluss-Ereignis

1282</h4>1325</h4>

1283 1326

1284Protokolliert, wenn ein [Subagent](/docs/de/sub-agents) fertig wird und sein Ergebnis an das Gespräch zurückgibt, das ihn gestartet hat. Verwenden Sie es, um Tool-Nutzung und Laufzeit nach Subagent-Typ zu aggregieren; für Token- oder Kosten-Aggregationen verwenden Sie den [Token-Zähler](#token-counter) und [Kostenzähler](#cost-counter), gefiltert nach `query_source` `"subagent"`, da das `total_tokens` dieses Ereignisses nur die endgültige Anfrage abdeckt. Die Kategorie `"subagent"` zählt auch Anfragen von Agent-basierten Hooks, die kein Subagent-Ereignis ausgeben.1327Protokolliert, wenn ein [Subagent](/docs/de/sub-agents) abgeschlossen ist und sein Ergebnis an das Gespräch zurückgibt, das ihn gestartet hat. Verwenden Sie es, um Tool-Nutzung und Laufzeit nach Subagent-Typ zu aggregieren; für Token- oder Kosten-Aggregationen verwenden Sie den [Token-Zähler](#token-counter) und [Kostenzähler](#cost-counter), gefiltert nach `query_source` `"subagent"`, da die `total_tokens` dieses Ereignisses nur die letzte Anfrage abdecken. Die Kategorie `"subagent"` zählt auch Anfragen von Agent-basierten Hooks, die kein Subagent-Ereignis ausgeben.

1285 1328

1286**Ereignisname**: `claude_code.subagent_completed`1329**Ereignisname**: `claude_code.subagent_completed`

1287 1330

1295* `agent.source`: Woher die Agent-Definition kam: `built-in`, `plugin` oder die Einstellungsquelle, die einen benutzerdefinierten Agent definierte, z. B. `userSettings` oder `projectSettings`1338* `agent.source`: Woher die Agent-Definition kam: `built-in`, `plugin` oder die Einstellungsquelle, die einen benutzerdefinierten Agent definierte, z. B. `userSettings` oder `projectSettings`

1296* `is_built_in`: Ob der Subagent ein integrierter Agent-Typ ist1339* `is_built_in`: Ob der Subagent ein integrierter Agent-Typ ist

1297* `is_async`: Ob der Subagent im [Hintergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background) ausgeführt wurde1340* `is_async`: Ob der Subagent im [Hintergrund](/docs/de/sub-agents#run-subagents-in-foreground-or-background) ausgeführt wurde

1298* `total_tokens`: Der Token-Fußabdruck der endgültigen API-Anfrage des Subagenten: dieser einen Anfrage's Eingabe-, Cache-Erstellungs-, Cache-Lese- und Ausgabe-Token, ungefähr die Kontextgröße des Subagenten beim Abschluss. Keine Summe über den Lauf1341* `total_tokens`: Der Token-Fußabdruck der finalen API-Anfrage des Subagenten: dieser einen Anfrage's Eingabe-, Cache-Erstellungs-, Cache-Lese- und Ausgabe-Token, ungefähr die Kontextgröße des Subagenten beim Abschluss. Keine Summe über den Lauf

1299* `total_tool_uses`: Anzahl der Tool-Aufrufe, die der Subagent über den ganzen Lauf hinweg gemacht hat1342* `total_tool_uses`: Anzahl der Tool-Aufrufe, die der Subagent über den ganzen Lauf gemacht hat

1300* `duration_ms`: Laufzeit in Millisekunden1343* `duration_ms`: Laufzeit in Millisekunden

1301* `model`: Das Modell, das der Subagent ausgeführt wurde1344* `model`: Das Modell, das der Subagent ausgeführt hat

1302* `final_model`: Das Modell, das die endgültige Antwort des Subagenten erzeugt hat, das sich von `model` nach einem Mid-Run-Wechsel wie einem Fallback unterscheidet. Erfordert Claude Code v2.1.212 oder später1345* `final_model`: Das Modell, das die letzte Antwort des Subagenten erzeugt hat, das sich von `model` nach einem Mid-Run-Wechsel wie einem Fallback unterscheidet. Erfordert Claude Code v2.1.212 oder später

1303* `model_swapped`: Ob mehr als ein Modell die Anfragen des Subagenten bedient hat. Erfordert Claude Code v2.1.212 oder später1346* `model_swapped`: Ob mehr als ein Modell die Anfragen des Subagenten bedient hat. Erfordert Claude Code v2.1.212 oder später

1304* `plugin_id_hash`, `plugin.name`: Vorhanden für Plugin-bereitgestellte Agenten. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt; andere Plugin-Namen werden durch `"third-party"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt1347* `plugin_id_hash`, `plugin.name`: Vorhanden für von Plugins bereitgestellte Agenten. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt; andere Plugin-Namen werden durch `"third-party"` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt

1305 1348

1306<h4 id="feedback-survey-event">1349<h4 id="feedback-survey-event">

1307 Feedback-Umfrage-Ereignis1350 Feedback-Umfrage-Ereignis

1308</h4>1351</h4>

1309 1352

1310Protokolliert, wenn eine Sitzungsqualitäts-Umfrage angezeigt oder beantwortet wird. Siehe [Sitzungsqualitäts-Umfragen](/docs/de/data-usage#session-quality-surveys) für was die Umfragen erfassen und wie Sie sie steuern.1353Protokolliert, wenn eine Sitzungsqualitäts-Umfrage angezeigt oder beantwortet wird. Siehe [Sitzungsqualitäts-Umfragen](/docs/de/data-usage#session-quality-surveys) für was die Umfragen sammeln und wie Sie sie steuern.

1311 1354

1312**Ereignisname**: `claude_code.feedback_survey`1355**Ereignisname**: `claude_code.feedback_survey`

1313 1356

1319* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1362* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1320* `event_type`: Umfrage-Lebenszyklusereignis, z. B. `"appeared"`, `"responded"` oder `"transcript_prompt_appeared"`1363* `event_type`: Umfrage-Lebenszyklusereignis, z. B. `"appeared"`, `"responded"` oder `"transcript_prompt_appeared"`

1321* `appearance_id`: Eindeutige ID, die die Ereignisse verknüpft, die für eine Umfrage-Instanz ausgegeben werden1364* `appearance_id`: Eindeutige ID, die die Ereignisse verknüpft, die für eine Umfrage-Instanz ausgegeben werden

1322* `survey_type`: Welche Umfrage das Ereignis erzeugt hat. `"session"` ist die Aufforderung „Wie macht Claude es?" Bewertung1365* `survey_type`: Welche Umfrage das Ereignis erzeugt hat. `"session"` ist die Eingabeaufforderung „Wie macht Claude es?"

1323* `response`: Die Auswahl des Benutzers auf `responded`-Ereignissen1366* `response`: Die Auswahl des Benutzers bei `responded`-Ereignissen

1324* `enabled_via_override`: `true`, wenn [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/de/env-vars) gesetzt ist. Ausgegeben als Boolean, nicht als Zeichenkette. Vorhanden auf `session`-Umfrage-Ereignissen. Filtern Sie nach diesem Attribut, um zu bestätigen, dass die Überschreibung über eine Flotte angewendet wird1367* `enabled_via_override`: `true`, wenn [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/de/env-vars) gesetzt ist. Ausgegeben als Boolean, nicht als Zeichenkette. Vorhanden bei `session`-Umfrage-Ereignissen. Filtern Sie nach diesem Attribut, um zu bestätigen, dass die Überschreibung über eine Flotte angewendet wird

1325 1368

1326<h4 id="retention-sweep-event">1369<h4 id="retention-sweep-event">

1327 Aufbewahrungslösch-Ereignis1370 Aufbewahrungslösch-Ereignis

1328</h4>1371</h4>

1329 1372

1330Protokolliert einmal pro Lauf des Aufbewahrungslösch-Sweeps, der [Sitzungstranskripte und andere Anwendungsdaten](/docs/de/claude-directory#cleaned-up-automatically) löscht, die älter als die Einstellung [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays) sind. Claude Code führt den Sweep im Hintergrund höchstens einmal pro Sitzung aus, und ein Lauf, der nichts löscht, gibt trotzdem das Ereignis aus. Wenn Claude Code den Sweep in einer Sitzung auf derselben Maschine in den letzten 24 Stunden ausgeführt hat, verzögert er den Sweep dieser Sitzung um mindestens 10 Minuten, daher gibt eine Sitzung, die früher beendet wird, nichts aus. Wenn Sie `claude -p` mit `--bare` ausführen, führt Claude Code den Sweep nicht aus und gibt nichts aus.1373Protokolliert einmal pro Lauf des Aufbewahrungslösch-Sweeps, der [Sitzungstranskripte und andere Anwendungsdaten](/docs/de/claude-directory#cleaned-up-automatically) löscht, die älter als die Einstellung [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays) sind. Claude Code führt den Sweep im Hintergrund höchstens einmal pro Sitzung aus, und ein Lauf, der nichts löscht, gibt trotzdem das Ereignis aus. Wenn Claude Code den Sweep in einer Sitzung auf derselben Maschine in den letzten 24 Stunden ausgeführt hat, verzögert es den Sweep dieser Sitzung um mindestens 10 Minuten, daher gibt eine Sitzung, die früher beendet wird, nichts aus. Wenn Sie `claude -p` mit `--bare` ausführen, führt Claude Code den Sweep nicht aus und gibt nichts aus.

1331 1374

1332Wie jedes OTel-Ereignis auf dieser Seite geht es nur an das Telemetrie-Backend, das Sie konfigurieren. Erfordert Claude Code v2.1.227 oder später.1375Wie jedes OTel-Ereignis auf dieser Seite geht es nur an das Telemetrie-Backend, das Sie konfigurieren. Erfordert Claude Code v2.1.227 oder später.

1333 1376

1334Wenn Claude Code die Aufbewahrungsfrist nicht sicher bestimmen kann, pausiert es den Sweep und gibt das Ereignis mit `result` auf `"skipped"` und einem `skip_reason` aus. Wenn [verwaltete Einstellungen](/docs/de/server-managed-settings) `cleanupPeriodDays` setzen, pinnt der verwaltete Wert die Aufbewahrungsfrist und der Sweep läuft auch wenn eine Einstellungsdatei in einem niedrigeren Prioritätsbereich unterbrochen oder ungültig ist. Wenn `managed-settings.json` selbst nicht gelesen werden kann, pausiert Claude Code den Sweep trotzdem nicht, es sei denn, die [verwaltete Ebene](/docs/de/managed-settings#how-claude-code-combines-managed-sources) liefert `cleanupPeriodDays` von anderswo, z. B. Server-verwaltete Einstellungen oder ein `managed-settings.d/`-Drop-In neben der unterbrochenen Datei. Die Lösch-Zähler-Attribute sind nur vorhanden, wenn `result` `"complete"` ist.1377Wenn Claude Code die Aufbewahrungsfrist nicht sicher bestimmen kann, pausiert es den Sweep und gibt das Ereignis mit `result` auf `"skipped"` und einem `skip_reason` aus. Wenn [verwaltete Einstellungen](/docs/de/server-managed-settings) `cleanupPeriodDays` setzen, pinnt der verwaltete Wert die Aufbewahrungsfrist und der Sweep läuft auch, wenn eine Einstellungsdatei in einem niedrigeren Prioritätsbereich unterbrochen oder ungültig ist. Wenn `managed-settings.json` selbst nicht gelesen werden kann, pausiert Claude Code trotzdem den Sweep, es sei denn, die [verwaltete Ebene](/docs/de/managed-settings#how-claude-code-combines-managed-sources) liefert `cleanupPeriodDays` von anderswo, z. B. Server-verwaltete Einstellungen oder ein `managed-settings.d/`-Drop-In neben der unterbrochenen Datei. Die Lösch-Zähler-Attribute sind nur vorhanden, wenn `result` `"complete"` ist.

1335 1378

1336**Ereignisname**: `claude_code.retention_sweep`1379**Ereignisname**: `claude_code.retention_sweep`

1337 1380

1341* `event.name`: `"retention_sweep"`1384* `event.name`: `"retention_sweep"`

1342* `event.timestamp`: ISO 8601-Zeitstempel1385* `event.timestamp`: ISO 8601-Zeitstempel

1343* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1386* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1344* `result`: `"complete"`, wenn der Sweep ausgeführt wurde, `"skipped"`, wenn Claude Code ihn pausierte1387* `result`: `"complete"`, wenn der Sweep ausgeführt wurde, `"skipped"`, wenn Claude Code ihn pausiert hat

1345* `period_days`: Der `cleanupPeriodDays`-Wert aus zusammengeführten Einstellungen, in Tagen, oder `30`, wenn keine Quelle ihn setzt. Bei übersprungenen Ereignissen der Wert, den der Sweep verwendet hätte, berechnet aus den Einstellungsquellen, die Claude Code lesen konnte1388* `period_days`: Der `cleanupPeriodDays`-Wert aus zusammengeführten Einstellungen, in Tagen, oder `30`, wenn keine Quelle ihn setzt. Bei übersprungenen Ereignissen der Wert, den der Sweep verwendet hätte, berechnet aus den Einstellungsquellen, die Claude Code lesen konnte

1346* `used_default`: `"true"`, wenn keine lesbare Einstellungsquelle `cleanupPeriodDays` setzt, `"false"` andernfalls. Bei abgeschlossenen Ereignissen bedeutet `"true"`, dass der 30-Tage-Standard angewendet wurde1389* `used_default`: `"true"`, wenn keine lesbare Einstellungsquelle `cleanupPeriodDays` setzt, `"false"` andernfalls. Bei abgeschlossenen Ereignissen bedeutet `"true"`, dass der 30-Tage-Standard angewendet wurde

1347* `skip_reason`: Warum Claude Code den Sweep pausierte. Nur vorhanden, wenn `result` `"skipped"` ist:1390* `skip_reason`: Warum Claude Code den Sweep pausiert hat. Nur vorhanden, wenn `result` `"skipped"` ist:

1348 * `"user_source_disabled"`: Benutzereinstellungen sind ausgeschlossen, z. B. durch das Flag [`--setting-sources`](/docs/de/cli-reference#cli-flags) oder die Option [`settingSources`](/docs/de/agent-sdk/typescript#options) des SDK, und keine aktivierte Quelle liefert `cleanupPeriodDays`1391 * `"user_source_disabled"`: Benutzereinstellungen sind ausgeschlossen, z. B. durch das Flag [`--setting-sources`](/docs/de/cli-reference#cli-flags) oder die Option [`settingSources`](/docs/de/agent-sdk/typescript#options) des SDK, und keine aktivierte Quelle liefert `cleanupPeriodDays`

1349 * `"settings_unknowable"`: Eine Einstellungsdatei konnte nicht gelesen oder geparst werden, daher kann `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` auf einen Wert gesetzt sein, den Claude Code nicht sehen kann1392 * `"settings_unknowable"`: Eine Einstellungsdatei konnte nicht gelesen oder geparst werden, daher kann `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` auf einen Wert gesetzt sein, den Claude Code nicht sehen kann

1350 * `"settings_invalid_key_set"`: Einstellungen haben Validierungsfehler und `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` ist explizit gesetzt, daher könnte ein Fallback auf den Standard Dateien gegen diese Einstellung löschen oder behalten1393 * `"settings_invalid_key_set"`: Einstellungen haben Validierungsfehler und `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` ist explizit gesetzt, daher könnte ein Fallback auf den Standard Dateien gegen diese Einstellung löschen oder behalten

1351* `transcripts_deleted`: Anzahl der Sitzungstranskripte, die Top-Level-Dateien `~/.claude/projects/*/*.jsonl`, die der Sweep gelöscht hat1394* `transcripts_deleted`: Anzahl der Sitzungstranskripte, die Top-Level-`~/.claude/projects/*/*.jsonl`-Dateien, die der Sweep gelöscht hat

1352* `transcripts_exempted_desktop`: Anzahl der Transkripte, die über die Aufbewahrungsfrist hinaus sind und die der Sweep unter der [Claude Desktop- und Cowork-Regel](/docs/de/claude-directory#cleaned-up-automatically) behalten hat. Diese zählen nicht zu `files_past_cutoff`. Erfordert Claude Code v2.1.248 oder später1395* `transcripts_exempted_desktop`: Anzahl der Transkripte nach der Aufbewahrungsfrist, die der Sweep unter der [Claude Desktop- und Cowork-Regel](/docs/de/claude-directory#cleaned-up-automatically) behalten hat. Diese zählen nicht zu `files_past_cutoff`. Erfordert Claude Code v2.1.248 oder später

1353* `session_files_deleted`: Anzahl der Artefakte, die der Sitzungs-Dateien-Sweep gelöscht hat: Transkripte plus Pro-Sitzungs-Begleitdateien wie Sidecars, Aufzeichnungen und Tool-Ergebnisse1396* `session_files_deleted`: Anzahl der Artefakte, die der Sitzungs-Dateien-Sweep gelöscht hat: Transkripte plus Pro-Sitzungs-Begleitdateien wie Sidecars, Aufzeichnungen und Tool-Ergebnisse

1354* `artifacts_deleted`: Gesamtzahl der Elemente, die der Sweep über die Datenverzeichnisse hinweg gelöscht hat, die er abdeckt, einschließlich der Sitzungsdateien. Einige Sweeps zählen einen ganzen entfernten Verzeichnisbaum als ein Element und ein paar Cleanup-Durchläufe tragen nicht zum Zähler bei, daher behandeln Sie den Wert als Untergrenze statt als genaue Dateianzahl1397* `artifacts_deleted`: Gesamtzahl der Elemente, die der Sweep über die Datenverzeichnisse gelöscht hat, die er abdeckt, einschließlich der Sitzungsdateien. Einige Sweeps zählen einen ganzen entfernten Verzeichnisbaum als ein Element und ein paar Cleanup-Durchläufe tragen nicht zum Zähler bei, daher behandeln Sie den Wert als Untergrenze statt als genaue Dateianzahl

1355* `files_retained_fresh`: Dateien, die inspiziert und behalten wurden, weil sie noch innerhalb der Aufbewahrungsfrist sind. Nur Pro-Datei-Sweeps zählen diese, daher ist der Wert eine Untergrenze; ein Wert ungleich Null ist der normale stabile Zustand1398* `files_retained_fresh`: Dateien, die überprüft und behalten wurden, weil sie noch innerhalb der Aufbewahrungsfrist sind. Nur Pro-Datei-Sweeps zählen diese, daher ist der Wert eine Untergrenze; ein Wert ungleich Null ist der normale stabile Zustand

1356* `files_past_cutoff`: Dateien, die älter als die Aufbewahrungsfrist sind und die der Sweep nicht löschen konnte, z. B. wegen eines Berechtigungsfehlers oder einer offenen Datei. Ein Wert über Null bedeutet, dass Dateien die konfigurierte Aufbewahrungsfrist überdauert haben; Null ist kein Beweis, dass keine, weil ein fehlgeschlagenes Entfernen eines ganzen Verzeichnisses zu `error_count` statt zählt1399* `files_past_cutoff`: Dateien älter als die Aufbewahrungsfrist, die der Sweep nicht löschen konnte, z. B. wegen eines Berechtigungsfehlers oder einer offenen Datei. Ein Wert über Null bedeutet, dass Dateien die konfigurierte Aufbewahrungsfrist überdauert haben; Null ist kein Beweis, dass keine, weil ein fehlgeschlagenes Entfernen eines ganzen Verzeichnisses zu `error_count` zählt

1357* `error_count`: Anzahl der Fehler, die der Sweep beim Auflisten oder Löschen von Dateien angetroffen hat1400* `error_count`: Anzahl der Fehler, die der Sweep beim Auflisten oder Löschen von Dateien angetroffen hat

1358 1401

1359<h4 id="managed-settings-resolved-event">1402<h4 id="managed-settings-resolved-event">

1360 Verwaltete Einstellungen Aufgelöst-Ereignis1403 Verwaltete Einstellungen aufgelöst-Ereignis

1361</h4>1404</h4>

1362 1405

1363Protokolliert mit den [verwalteten Einstellungen](/docs/de/managed-settings), die eine Sitzung aufgelöst hat: einmal beim Sitzungsstart, erneut wenn sich entweder die verwalteten Einstellungen oder der Zustand des [Policy-Helfers](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) während der Sitzung ändert, und wenn Claude Code sich weigert zu starten oder die Sitzung aus einem der Gründe beendet, die das Attribut `error.type` auflistet.1406Protokolliert mit den [verwalteten Einstellungen](/docs/de/managed-settings), die eine Sitzung aufgelöst hat: einmal beim Sitzungsstart, erneut, wenn sich entweder die verwalteten Einstellungen oder der Zustand des [Policy-Helpers](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) während der Sitzung ändert, und wenn Claude Code sich weigert zu starten oder die Sitzung aus einem der Gründe beendet, die das Attribut `error.type` auflistet.

1364Verwenden Sie dieses Ereignis, um Maschinen zu finden, die auf einer unerwarteten verwalteten Quelle laufen, Maschinen, deren Policy-Helfer fehlschlägt, und den Grund, warum eine Maschine sich weigert zu starten.1407Verwenden Sie dieses Ereignis, um Maschinen zu finden, die auf einer unerwarteten verwalteten Quelle ausgeführt werden, Maschinen, deren Policy-Helper fehlschlägt, und den Grund, warum eine Maschine sich weigert zu starten.

1365Erfordert Claude Code v2.1.274 oder später.1408Erfordert Claude Code v2.1.274 oder später.

1366 1409

1367Standardmäßig trägt das Ereignis die verwalteten Quellen und den Zustand des Policy-Helfers, aber nicht die Einstellungen selbst. Um das redaktionierte Attribut `managed_settings.settings` und die Zusammenfassung `managed_settings.resolved_sha256` hinzuzufügen, setzen Sie `OTEL_LOG_MANAGED_SETTINGS=1`:1410Standardmäßig trägt das Ereignis die verwalteten Quellen und den Zustand des Policy-Helpers, aber nicht die Einstellungen selbst. Um das reduzierte Attribut `managed_settings.settings` und die Zusammenfassung `managed_settings.resolved_sha256` hinzuzufügen, setzen Sie `OTEL_LOG_MANAGED_SETTINGS=1`:

1368 1411

1369* Setzen Sie es im `env`-Block von verwalteten Einstellungen, Benutzereinstellungen oder `--settings`, oder in der Umgebung, mit der Sie Claude Code starten. Ein Wert in Projekt- oder lokalen Einstellungen schaltet es nicht ein, da ein geklontes Repository sie schreiben kann.1412* Setzen Sie es im `env`-Block von verwalteten Einstellungen, Benutzereinstellungen oder `--settings` oder in der Umgebung, mit der Sie Claude Code starten. Ein Wert in Projekt- oder lokalen Einstellungen schaltet ihn nicht ein, da ein geklontes Repository sie schreiben kann.

1370* Server-verwaltete Einstellungen können es setzen, ohne den [Sicherheitsgenehmigungsdialog](/docs/de/server-managed-settings#security-approval-dialogs) anzuzeigen, da die Variable nur Ihre Organisationseigene redaktionierte Richtlinie zu einem Ereignis hinzufügt, das Ihre Organisation bereits erhält.1413* Server-verwaltete Einstellungen können ihn setzen, ohne den [Sicherheitsgenehmigungsdialog](/docs/de/server-managed-settings#security-approval-dialogs) anzuzeigen, da die Variable nur Ihre Organisationseigene reduzierte Richtlinie zu einem Ereignis hinzufügt, das Ihre Organisation bereits erhält.

1371 1414

1372In einer interaktiven Sitzung in einem Ordner, den Sie nicht [vertraut](/docs/de/permissions#what-runs-before-you-trust-a-folder) haben, exportiert Claude Code das Verweigerungs-Ereignis nicht.1415In einer interaktiven Sitzung in einem Ordner, den Sie nicht [vertraut](/docs/de/permissions#what-runs-before-you-trust-a-folder) haben, exportiert Claude Code das Ablehnungs-Ereignis nicht.

1373 1416

1374**Ereignisname**: `claude_code.managed_settings_resolved`1417**Ereignisname**: `claude_code.managed_settings_resolved`

1375 1418

1379* `event.name`: `"managed_settings_resolved"`1422* `event.name`: `"managed_settings_resolved"`

1380* `event.timestamp`: ISO 8601-Zeitstempel1423* `event.timestamp`: ISO 8601-Zeitstempel

1381* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)1424* `event.sequence`: Pro-Prozess-Zähler zum Ordnen von Ereignissen, beschrieben unter [Ereigniskorrelationsattribute](#event-correlation-attributes)

1382* `managed_settings.trigger`: `"startup"` für das Sitzungsstart-Ereignis, `"change"`, wenn sich die verwalteten Einstellungen oder der Zustand des Policy-Helfers später in der Sitzung ändert, oder `"refused"`, wenn eine verwaltete Einstellungsrichtlinie die Sitzung stoppte. Claude Code sendet ein `change`-Ereignis nur, wenn sich ein Attribut vom letzten Ereignis unterscheidet, das es gesendet hat, und ein geänderter Einstellungswert zählt auch wenn `OTEL_LOG_MANAGED_SETTINGS` aus ist1425* `managed_settings.trigger`: `"startup"` für das Sitzungsstart-Ereignis, `"change"`, wenn sich die verwalteten Einstellungen oder der Zustand des Policy-Helpers später in der Sitzung ändert, oder `"refused"`, wenn eine verwaltete Einstellungsrichtlinie die Sitzung gestoppt hat. Claude Code sendet ein `change`-Ereignis nur, wenn sich ein Attribut vom letzten Ereignis unterscheidet, das es gesendet hat, und ein geänderter Einstellungswert zählt auch, wenn `OTEL_LOG_MANAGED_SETTINGS` aus ist

1383* `error.type`: warum Claude Code die Sitzung stoppte. Nur vorhanden auf `refused`-Ereignissen:1426* `error.type`: warum Claude Code die Sitzung gestoppt hat. Nur vorhanden bei `refused`-Ereignissen:

1384 * `"helper_failed"`: ein [Policy-Helfer-Lauf fehlgeschlagen](/docs/de/settings-reference#helper-failures)1427 * `"helper_failed"`: ein [Policy-Helper-Lauf fehlgeschlagen](/docs/de/settings-reference#helper-failures)

1385 * `"policy_invalid"`: die verwalteten Einstellungen enthalten einen Fehler, der Claude Code vom Starten abhält, oder eine Admin-Quelle konnte nicht geladen werden, daher kann Claude Code die Organisations-Login-Erzwingung nicht prüfen1428 * `"policy_invalid"`: die verwalteten Einstellungen enthalten einen Fehler, der Claude Code vom Starten abhält, oder eine Admin-Quelle konnte nicht geladen werden, daher kann Claude Code die Durchsetzung der Organisationsanmeldung nicht überprüfen

1386 * `"consent_rejected"`: der Benutzer lehnte den [Sicherheitsgenehmigungsdialog](/docs/de/server-managed-settings#security-approval-dialogs) für Server-verwaltete Einstellungen ab1429 * `"consent_rejected"`: der Benutzer lehnte den [Sicherheitsgenehmigungsdialog](/docs/de/server-managed-settings#security-approval-dialogs) für Server-verwaltete Einstellungen ab

1387 * `"force_refresh_failed"`: der Einstellungs-Abruf, den [`forceRemoteSettingsRefresh`](/docs/de/settings-reference#forceremotesettingsrefresh) erfordert, fehlgeschlagen1430 * `"force_refresh_failed"`: der Einstellungs-Abruf, den [`forceRemoteSettingsRefresh`](/docs/de/settings-reference#forceremotesettingsrefresh) erfordert, fehlgeschlagen

1388 * `"gateway_rejected"`: ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) antwortete auf den verwalteten Einstellungs-Abruf mit HTTP 4031431 * `"gateway_rejected"`: ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) antwortete auf den Abruf der verwalteten Einstellungen mit HTTP 403

1389 * `"version_below_minimum"`: diese Version von Claude Code ist unter [`requiredMinimumVersion`](/docs/de/settings-reference#requiredminimumversion) oder über [`requiredMaximumVersion`](/docs/de/settings-reference#requiredmaximumversion)1432 * `"version_below_minimum"`: diese Version von Claude Code ist unter [`requiredMinimumVersion`](/docs/de/settings-reference#requiredminimumversion) oder über [`requiredMaximumVersion`](/docs/de/settings-reference#requiredmaximumversion)

1390 * `"_OTHER"`: der Claude-Apps-Gateway verwaltete Einstellungs-Abruf fehlgeschlagen aus einem anderen Grund1433 * `"_OTHER"`: der Abruf der verwalteten Einstellungen des Claude-Apps-Gateways fehlgeschlagen aus einem anderen Grund

1391* `managed_settings.sources`: jede verwaltete Quelle, die mindestens einen [Policy-Schlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) liefert, höchste Priorität zuerst, einschließlich Quellen, deren Schlüssel nicht unter `first-wins` wirksam werden. Werte sind `"remote"`, `"plist"` oder `"hklm"` für die MDM- oder OS-Level-Richtlinie, `"file"` für verwaltete Einstellungsdateien und Drop-Ins, `"parent"`, wenn ein [Embedding-Host](/docs/de/managed-settings#let-an-embedding-host-add-policy) Einstellungen liefert, und `"hkcu"` für den [Windows HKCU-Registry-Wert](/docs/de/managed-settings#where-each-mechanism-stores-the-policy), wenn Claude Code [ihn liest](/docs/de/managed-settings#how-claude-code-combines-managed-sources). Eine Quelle, die nur Kontrollschlüssel trägt, oder die Claude Code nicht lesen konnte, ist nicht aufgelistet. Ausgegeben als Array von Zeichenketten, leer wenn keine verwaltete Quelle einen Policy-Schlüssel liefert1434* `managed_settings.sources`: jede verwaltete Quelle, die mindestens einen [Policy-Schlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) liefert, höchste Priorität zuerst, einschließlich Quellen, deren Schlüssel unter `first-wins` nicht wirksam werden. Werte sind `"remote"`, `"plist"` oder `"hklm"` für die MDM- oder OS-Level-Richtlinie, `"file"` für verwaltete Einstellungsdateien und Drop-Ins, `"parent"`, wenn ein [Embedding-Host](/docs/de/managed-settings#let-an-embedding-host-add-policy) Einstellungen liefert, und `"hkcu"` für den [Windows HKCU-Registrierungswert](/docs/de/managed-settings#where-each-mechanism-stores-the-policy), wenn Claude Code [ihn liest](/docs/de/managed-settings#how-claude-code-combines-managed-sources). Eine Quelle, die nur Kontrollschlüssel trägt, oder die Claude Code nicht lesen konnte, ist nicht aufgelistet. Ausgegeben als Array von Zeichenketten, leer, wenn keine verwaltete Quelle einen Policy-Schlüssel liefert

1392* `managed_settings.source_behavior`: der [`managedSourcesBehavior`](/docs/de/settings-reference#managedsourcesbehavior)-Wert, den Claude Code las, `"first-wins"` oder `"merge"`. `"first-wins"`, wenn keine Quelle den Schlüssel setzt1435* `managed_settings.source_behavior`: der [`managedSourcesBehavior`](/docs/de/settings-reference#managedsourcesbehavior)-Wert, den Claude Code gelesen hat, `"first-wins"` oder `"merge"`. `"first-wins"`, wenn keine Quelle den Schlüssel setzt

1393* `managed_settings.helper.state`: Zustand des Policy-Helfers, den die ausgewählte MDM- oder Datei-Quelle konfiguriert:1436* `managed_settings.helper.state`: Zustand des Policy-Helpers, den die ausgewählte MDM- oder Datei-Quelle konfiguriert:

1394 * `"ok"`: die Ausgabe des Helfers dient als verwaltete Einstellungen1437 * `"ok"`: die Ausgabe des Helpers dient als verwaltete Einstellungen

1395 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"` oder `"schema_rejected"`: der letzte Lauf des Helfers fehlgeschlagen. [Helper-Fehler](/docs/de/settings-reference#helper-failures) beschreibt die Fälle1438 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"` oder `"schema_rejected"`: der letzte Lauf des Helpers fehlgeschlagen. [Helper-Fehler](/docs/de/settings-reference#helper-failures) beschreibt die Fälle

1396 * `"none"`: kein Helfer ist konfiguriert, oder die Quelle, die ihn konfiguriert, ist keine MDM-Richtlinie oder verwaltete Einstellungsdatei1439 * `"none"`: kein Helper ist konfiguriert, oder die Quelle, die ihn konfiguriert, ist keine MDM-Richtlinie oder verwaltete Einstellungsdatei

1397* `managed_settings.helper.applied`: `"output"`, während die eigene Ausgabe des Helfers als verwaltete Einstellungen dient, `"none"`, wenn sie nicht1440* `managed_settings.helper.applied`: `"output"`, während die eigene Ausgabe des Helpers als verwaltete Einstellungen dient, `"none"`, wenn sie nicht

1398* `managed_settings.helper.entry`: `"policyHelper"`, wenn Claude Code einen [`policyHelper`](/docs/de/settings-reference#policyhelper) ausgewählt hat. Nicht vorhanden, wenn es keinen Helfer ausgewählt hat1441* `managed_settings.helper.entry`: `"policyHelper"`, wenn Claude Code einen [`policyHelper`](/docs/de/settings-reference#policyhelper) ausgewählt hat. Nicht vorhanden, wenn es keinen Helper ausgewählt hat

1399* `managed_settings.helper.path`: der konfigurierte [`path`](/docs/de/settings-reference#policyhelper-path) des Helfers. Vorhanden, wenn Claude Code einen Helfer ausgewählt hat, ob `OTEL_LOG_MANAGED_SETTINGS` gesetzt ist oder nicht1442* `managed_settings.helper.path`: der konfigurierte [`path`](/docs/de/settings-reference#policyhelper-path) des Helpers. Vorhanden, wenn Claude Code einen Helper ausgewählt hat, ob `OTEL_LOG_MANAGED_SETTINGS` gesetzt ist oder nicht

1400* `managed_settings.resolved_sha256` (wenn `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 der aufgelösten verwalteten Einstellungen vor Redaktion, serialisiert als JSON mit rekursiv sortierten Schlüsseln und ohne Leerzeichen. Maschinen mit derselben Zusammenfassung führen dieselbe Richtlinie aus. Claude Code sendet die Zusammenfassung nur mit dem Opt-In, da eine kurze Richtlinie durch Hashing von Vermutungen wiederhergestellt werden kann. Nicht vorhanden, wenn keine verwalteten Einstellungen aufgelöst wurden, und auf `refused`-Ereignissen1443* `managed_settings.resolved_sha256` (wenn `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 der aufgelösten verwalteten Einstellungen vor Redaktion, serialisiert als JSON mit rekursiv sortierten Schlüsseln und ohne Leerzeichen. Maschinen mit derselben Zusammenfassung führen die gleiche Richtlinie aus. Claude Code sendet die Zusammenfassung nur mit dem Opt-In, da eine kurze Richtlinie durch Hashing von Vermutungen wiederhergestellt werden kann. Nicht vorhanden, wenn keine verwalteten Einstellungen aufgelöst wurden, und bei `refused`-Ereignissen

1401* `managed_settings.settings` (wenn `OTEL_LOG_MANAGED_SETTINGS=1`): die Namen und Form der aufgelösten verwalteten Einstellungen als JSON-Zeichenkette, mit den Werten redaktioniert. Nicht vorhanden auf `refused`-Ereignissen. Claude Code erstellt es aus seinem Einstellungsschema:1444* `managed_settings.settings` (wenn `OTEL_LOG_MANAGED_SETTINGS=1`): die Namen und Form der aufgelösten verwalteten Einstellungen als JSON-Zeichenkette, mit den Werten reduziert. Nicht vorhanden bei `refused`-Ereignissen. Claude Code erstellt es aus seinem Einstellungsschema:

1402 1445

1403 * Ein Einstellungsname, den das Schema deklariert, wird exportiert, und ein Schlüssel, den es nicht deklariert, wird weggelassen1446 * Ein Einstellungsname, den das Schema deklariert, wird exportiert, und ein Schlüssel, den es nicht deklariert, wird weggelassen

1404 * Booleans, Zahlen und String-Werte, die das Schema auf einen festen Satz von Optionen beschränkt, z. B. `permissions.defaultMode`, werden wie geschrieben exportiert. `sandbox.network.httpProxyPort` und `sandbox.network.socksProxyPort` werden als `"[REDACTED]"` exportiert1447 * Booleans, Zahlen und String-Werte, die das Schema auf einen festen Satz von Optionen beschränkt, z. B. `permissions.defaultMode`, werden wie geschrieben exportiert. `sandbox.network.httpProxyPort` und `sandbox.network.socksProxyPort` werden als `"[REDACTED]"` exportiert

1405 * Jede andere Zeichenkette, z. B. `model`, `apiKeyHelper`, jeder `env`-Wert, jede URL und jeder Befehl, wird als `"[REDACTED]"` exportiert1448 * Jeder andere String, z. B. `model`, `apiKeyHelper`, jeder `env`-Wert, jede URL und jeder Befehl, wird als `"[REDACTED]"` exportiert

1406 * Die Eintrags-Namen von Maps, z. B. `env`-Variablennamen und Plugin-IDs, werden wie geschrieben exportiert. Eine Einstellung, deren Einträge das Schema nicht typisiert, z. B. `vimInsertModeRemaps`, wird als ein einzelnes `"[REDACTED]"` exportiert, und `sandbox.ignoreViolations` wird als eine Liste seiner Pfad-Listen ohne die Befehlsmuster exportiert1449 * Die Eintrags-Namen von Maps, z. B. `env`-Variablennamen und Plugin-IDs, werden wie geschrieben exportiert. Eine Einstellung, deren Einträge das Schema nicht typisiert, z. B. `vimInsertModeRemaps`, wird als ein einzelnes `"[REDACTED]"` exportiert, und `sandbox.ignoreViolations` wird als eine Liste seiner Pfadlisten ohne die Befehlsmuster exportiert

1407 * Eine Liste behält ihre Länge, mit jedem Eintrag nach denselben Regeln redaktioniert1450 * Eine Liste behält ihre Länge, mit jedem Eintrag nach den gleichen Regeln reduziert

1408 * Eine `permissions.allow`-, `permissions.deny`- oder `permissions.ask`-Regel wird als ihr Tool-Name mit dem Inhalt redaktioniert exportiert, z. B. `Read([REDACTED])`, wenn das Tool in diese Version von Claude Code integriert ist oder ein `mcp__`-Verweis wie `mcp__jira__create_issue` ist. Jede andere Regel wird als `"[REDACTED]"` exportiert1451 * Eine `permissions.allow`-, `permissions.deny`- oder `permissions.ask`-Regel wird als ihr Tool-Name mit dem Inhalt reduziert exportiert, z. B. `Read([REDACTED])`, wenn das Tool in diese Version von Claude Code integriert ist oder ein `mcp__`-Verweis wie `mcp__jira__create_issue` ist. Jede andere Regel wird als `"[REDACTED]"` exportiert

1409 * Hooks folgen denselben Regeln, daher zeigen Fixed-Option- und numerische Felder wie `type` und `timeout`, während jeder Befehl, jede URL, `matcher` und `if`-Bedingung als `"[REDACTED]"` exportiert wird1452 * Hooks folgen den gleichen Regeln, daher zeigen fest-Option und numerische Felder wie `type` und `timeout`, während jeder Befehl, jede URL, `matcher` und `if`-Bedingung als `"[REDACTED]"` exportiert wird

1410 1453

1411 Zum Beispiel werden verwaltete Einstellungen mit `apiKeyHelper`, zwei `env`-Variablen und einer Ablehnungsregel als `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}` exportiert.1454 Zum Beispiel werden verwaltete Einstellungen mit `apiKeyHelper`, zwei `env`-Variablen und einer Ablehnungsregel als `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}` exportiert.

1412 1455

1413 Claude Code schneidet den Wert bei 8 KB UTF-8 ab, und der abgeschnittene Wert ist kein gültiges JSON1456 Claude Code schneidet den Wert bei 8 KB UTF-8 ab, und der abgeschnittene Wert ist kein gültiges JSON

1414* `managed_settings.settings_truncated` (wenn `managed_settings.settings` vorhanden ist): `true`, wenn Claude Code `managed_settings.settings` bei 8 KB abschnitt, `false` andernfalls. Ausgegeben als Boolean, nicht als Zeichenkette1457* `managed_settings.settings_truncated` (wenn `managed_settings.settings` vorhanden ist): `true`, wenn Claude Code `managed_settings.settings` bei 8 KB abgeschnitten hat, `false` andernfalls. Ausgegeben als Boolean, nicht als Zeichenkette

1415 1458

1416<h2 id="interpret-metrics-and-events-data">1459<h2 id="interpret-metrics-and-events-data">

1417 Interpretation von Metriken- und Ereignisdaten1460 Interpretation von Metriken- und Ereignisdaten

1499 1542

1500Die [Standardattribute](#standard-attributes) auf jedem Ereignis enthalten die Identität des authentifizierten Benutzers: `user.email`, `user.account_uuid`, `user.account_id` und `organization.id`, wenn mit einem Claude-Konto angemeldet oder in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web), wenn die Anmeldedaten der Sitzung selbst diese tragen, plus `user.id` und die pro-Sitzung `session.id`. `user.id` ist ein installationsbegrenzter Bezeichner, außer bei [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen, wo es das IdP-Subjekt aus dem vom Gateway ausgegebenen Token ist.1543Die [Standardattribute](#standard-attributes) auf jedem Ereignis enthalten die Identität des authentifizierten Benutzers: `user.email`, `user.account_uuid`, `user.account_id` und `organization.id`, wenn mit einem Claude-Konto angemeldet oder in einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web), wenn die Anmeldedaten der Sitzung selbst diese tragen, plus `user.id` und die pro-Sitzung `session.id`. `user.id` ist ein installationsbegrenzter Bezeichner, außer bei [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen, wo es das IdP-Subjekt aus dem vom Gateway ausgegebenen Token ist.

1501 1544

1502MCP-Tool-Aufrufe, Bash-Befehle und Dateibearbeitungen werden daher dem Entwickler zugeordnet, der die Sitzung gestartet hat. Claude Code handelt nicht unter einem separaten Service-Konto; die Identität, die auf jedem Ereignis aufgezeichnet wird, ist das Claude-Konto des Entwicklers selbst, oder die IdP-Identität des Entwicklers bei einer [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzung.1545In einer Sitzung, die ein Entwickler startet, werden MCP-Tool-Aufrufe, Bash-Befehle und Dateibearbeitungen daher diesem Entwickler zugeordnet. Claude Code handelt nicht unter einem separaten Service-Konto; die Identität, die auf jedem Ereignis aufgezeichnet wird, ist das Claude-Konto des Entwicklers selbst, oder die IdP-Identität des Entwicklers bei einer [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzung. In Claude Tag-Kanalsitzungen arbeitet Claude stattdessen als [gemeinsame Identität](/docs/de/cloud-environments#set-the-environment-a-claude-tag-channel-uses) Ihrer Organisation.

1503 1546

1504Wenn Claude Code sich mit einem direkten API-Schlüssel authentifiziert oder gegen Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, gibt es kein Claude-Konto in der Sitzung und nur `user.id` und `session.id` werden gefüllt. In diesen Bereitstellungen fügen Sie die Benutzeridentität selbst mit `OTEL_RESOURCE_ATTRIBUTES` hinzu, die pro Benutzer über die [verwaltete Einstellungsdatei](#administrator-configuration) oder einen Launch-Wrapper gesetzt wird. Claude apps gateway-Sitzungen benötigen nichts davon: Die CLI stempelt die IdP-Identität automatisch ab, wie in [Standardattribute](#standard-attributes) beschrieben.1547Wenn Claude Code sich mit einem direkten API-Schlüssel authentifiziert oder gegen Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, gibt es kein Claude-Konto in der Sitzung und nur `user.id` und `session.id` werden gefüllt. In diesen Bereitstellungen fügen Sie die Benutzeridentität selbst mit `OTEL_RESOURCE_ATTRIBUTES` hinzu, die pro Benutzer über die [verwaltete Einstellungsdatei](#administrator-configuration) oder einen Launch-Wrapper gesetzt wird. Claude apps gateway-Sitzungen benötigen nichts davon: Die CLI stempelt die IdP-Identität automatisch ab, wie in [Standardattribute](#standard-attributes) beschrieben.

1505 1548

1563}1606}

1564```1607```

1565 1608

1566Um zu bestätigen, dass Ereignisse ankommen, senden Sie eine Eingabeaufforderung in einer Sitzung, die unter dieser Konfiguration ausgeführt wird, und überprüfen Sie Ihr SIEM auf das `claude_code.user_prompt`-Ereignis. Wenn nichts ankommt, führen Sie `claude --debug` aus und überprüfen Sie das Debug-Protokoll auf `[3P telemetry]`-Exportfehler.1609Um zu bestätigen, dass Ereignisse ankommen, senden Sie eine Eingabeaufforderung in einer Sitzung, die unter dieser Konfiguration ausgeführt wird, und überprüfen Sie Ihr SIEM auf das `claude_code.user_prompt`-Ereignis. Wenn nichts ankommt, starten Sie Claude Code mit `claude --debug-file <path>` und überprüfen Sie dieses Protokoll auf `[3P telemetry]`-Exportfehler.

1567 1610

1568<h2 id="backend-considerations">1611<h2 id="backend-considerations">

1569 Backend-Überlegungen1612 Backend-Überlegungen

1633 * `tool_result`- und `tool_decision`-Ereignisse enthalten ein `tool_parameters`-Attribut mit Bash-Befehlen, MCP-Server- und Tool-Namen sowie Skill-Namen. Felder wie `full_command` werden ungekürzt ausgegeben1676 * `tool_result`- und `tool_decision`-Ereignisse enthalten ein `tool_parameters`-Attribut mit Bash-Befehlen, MCP-Server- und Tool-Namen sowie Skill-Namen. Felder wie `full_command` werden ungekürzt ausgegeben

1634 * `tool_result`-Ereignisse enthalten zusätzlich ein `tool_input`-Attribut mit Dateipfaden, URLs, Suchmustern und anderen Argumenten. Einzelne Werte über 512 Zeichen werden gekürzt und die Gesamtmenge ist auf etwa 4 K Zeichen begrenzt1677 * `tool_result`-Ereignisse enthalten zusätzlich ein `tool_input`-Attribut mit Dateipfaden, URLs, Suchmustern und anderen Argumenten. Einzelne Werte über 512 Zeichen werden gekürzt und die Gesamtmenge ist auf etwa 4 K Zeichen begrenzt

1635 * `user_prompt`-Ereignisse enthalten den wörtlichen `command_name` für benutzerdefinierte, Plugin- und MCP-Befehle1678 * `user_prompt`-Ereignisse enthalten den wörtlichen `command_name` für benutzerdefinierte, Plugin- und MCP-Befehle

1679 * Die [Kosten- und Token-Zähler](#cost-counter) und die Ereignisse `api_request`, `api_error` und `api_refusal` tragen echte Agent-, Skill-, Plugin- und MCP-Server- und Tool-Namen in ihren Attributionierungsattributen

1636 * Trace-Spans enthalten das gleiche `tool_input`-Attribut und eingabebezogene Attribute wie `file_path`, mit der gleichen Kürzung wie `tool_input`1680 * Trace-Spans enthalten das gleiche `tool_input`-Attribut und eingabebezogene Attribute wie `file_path`, mit der gleichen Kürzung wie `tool_input`

1637* Tool-Inhalte werden in Trace-Spans standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie `OTEL_LOG_TOOL_CONTENT=1`. Der `claude_code.tool`-Span trägt dann ein [`tool.output`-Span-Ereignis](#tool-output-span-event) mit rohen Dateiinhalten und Bash-Befehlsausgabe, gekürzt bei der Inhaltsbegrenzung (standardmäßig 60 KB) pro Attribut. Tool-Inhalte erreichen Spans auch durch [`new_context`, dessen Gate je nach Span unterschiedlich ist](#new-context-gates). Konfigurieren Sie Ihr Telemetrie-Backend, um diese Attribute nach Bedarf zu filtern oder zu schwärzen1681* Tool-Inhalte werden in Trace-Spans standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie `OTEL_LOG_TOOL_CONTENT=1`. Der `claude_code.tool`-Span trägt dann ein [`tool.output`-Span-Ereignis](#tool-output-span-event) mit rohen Dateiinhalten, Bash-Befehlsausgabe und dem, was MCP-Tools, WebFetch und WebSearch zurückgeben, gekürzt bei der Inhaltsbegrenzung (standardmäßig 60 KB) pro Attribut. Ergebnisse von MCP-Tools, WebFetch und WebSearch erfordern Claude Code v2.1.283 oder später. Tool-Inhalte erreichen Spans auch durch [`new_context`, dessen Gate je nach Span unterschiedlich ist](#new-context-gates). Konfigurieren Sie Ihr Telemetrie-Backend, um diese Attribute nach Bedarf zu filtern oder zu schwärzen

1638* Rohe Anthropic Messages API-Anfrage- und Antwort-Texte werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie `OTEL_LOG_RAW_API_BODIES` in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Es wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Die Texte enthalten die gesamte Konversationshistorie, einschließlich des Systemprompts, jedes vorherigen Benutzer- und Assistent-Durchgangs und Tool-Ergebnisse, daher impliziert das Aktivieren dies Zustimmung zu allem, was die anderen `OTEL_LOG_*`-Content-Flags offenbaren würden. Claude Code schwärzt immer Claudes Extended-Thinking-Inhalte aus diesen Texten, unabhängig von anderen Einstellungen. Der Wert, den Sie setzen, bestimmt, wie Claude Code die Texte bereitstellt:1682* Rohe Anthropic Messages API-Anfrage- und Antwort-Texte werden standardmäßig nicht protokolliert. Um sie einzubeziehen, setzen Sie `OTEL_LOG_RAW_API_BODIES` in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Es wird in [Projekt- und lokalen Einstellungen](/docs/de/settings-reference#variables-claude-code-ignores-in-env) ignoriert. Die Texte enthalten die gesamte Konversationshistorie, einschließlich des Systemprompts, jedes vorherigen Benutzer- und Assistent-Durchgangs und Tool-Ergebnisse, daher impliziert das Aktivieren dies Zustimmung zu allem, was die anderen `OTEL_LOG_*`-Content-Flags offenbaren würden. Claude Code schwärzt immer Claudes Extended-Thinking-Inhalte aus diesen Texten, unabhängig von anderen Einstellungen. Der Wert, den Sie setzen, bestimmt, wie Claude Code die Texte bereitstellt:

1639 * Mit `=1` gibt Claude Code `api_request_body`- und `api_response_body`-Log-Ereignisse für jeden API-Aufruf aus. Das `body`-Attribut der Ereignisse trägt die JSON-serialisierte Nutzlast, gekürzt bei der Inhaltsbegrenzung (standardmäßig 60 KB)1683 * Mit `=1` gibt Claude Code `api_request_body`- und `api_response_body`-Log-Ereignisse für jeden API-Aufruf aus. Das `body`-Attribut der Ereignisse trägt die JSON-serialisierte Nutzlast, gekürzt bei der Inhaltsbegrenzung (standardmäßig 60 KB)

1640 * Mit `=file:<dir>` schreibt Claude Code ungekürzte Texte unter diesem Verzeichnis in `.request.json`- und `.response.json`-Dateien, und die Ereignisse tragen einen `body_ref`-Pfad statt des Inline-Textes. Versenden Sie das Verzeichnis mit einem Log-Collector oder Sidecar statt über den Telemetrie-Stream.1684 * Mit `=file:<dir>` schreibt Claude Code ungekürzte Texte unter diesem Verzeichnis in `.request.json`- und `.response.json`-Dateien, und die Ereignisse tragen einen `body_ref`-Pfad statt des Inline-Textes. Versenden Sie das Verzeichnis mit einem Log-Collector oder Sidecar statt über den Telemetrie-Stream.

overview.md +3 −1

Details

18 <Tab title="Terminal">18 <Tab title="Terminal">

19 Das vollständig ausgestattete CLI für die Arbeit mit Claude Code direkt in Ihrem Terminal. Bearbeiten Sie Dateien, führen Sie Befehle aus und verwalten Sie Ihr gesamtes Projekt über die Befehlszeile.19 Das vollständig ausgestattete CLI für die Arbeit mit Claude Code direkt in Ihrem Terminal. Bearbeiten Sie Dateien, führen Sie Befehle aus und verwalten Sie Ihr gesamtes Projekt über die Befehlszeile.

20 20

~~21 Um Claude Code zu installieren, verwenden Sie eine der folgenden Methoden:~~21 Um Claude Code zu installieren, öffnen Sie ein Terminal und führen Sie den Befehl für Ihr System aus. Wenn Sie noch nie ein Terminal verwendet haben, zeigt der [Terminal-Leitfaden](/docs/de/terminal-guide), wie Sie eines öffnen und den Befehl einfügen.

22 22

23 <Tabs>23 <Tabs>

24 <Tab title="Native Installation (Empfohlen)">24 <Tab title="Native Installation (Empfohlen)">

40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41 ```41 ```

42 42

43 Wenn das Installationsprogramm fertig ist, öffnen Sie ein neues Terminal-Fenster und führen Sie `claude --version` aus. Eine funktionierende Installation gibt eine Versionsnummer aus. Wenn Ihre Shell sagt, dass `claude` nicht gefunden wird oder nicht erkannt wird, ist das Installationsverzeichnis noch nicht in Ihrem PATH: siehe [Beheben Sie Ihren PATH](/docs/de/troubleshoot-install#command-not-found-claude-after-installation).

43 Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell. Ihre Eingabeaufforderung zeigt `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.45 Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell. Ihre Eingabeaufforderung zeigt `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.

44 46

45 Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen curl-Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.47 Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen curl-Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.

permission-modes.md +147 −52

Details

8 8

9Ein Berechtigungsmodus legt fest, welche Aktionen Claude in einer Sitzung ausführen kann, ohne Sie vorher zu fragen. Im Manual-Modus hält Claude Code inne und fragt Sie, bevor die meisten Aktionen ausgeführt werden, die Dateien bearbeiten, Shell-Befehle ausführen oder das Netzwerk erreichen. Im [Auto-Modus](#eliminate-prompts-with-auto-mode) überprüft ein zweites Modell, der Klassifizierer, Aktionen statt Ihnen; [wie der Klassifizierer Aktionen bewertet](#how-the-classifier-evaluates-actions) listet auf, welche Aktionen er überprüft und welche er überspringt.9Ein Berechtigungsmodus legt fest, welche Aktionen Claude in einer Sitzung ausführen kann, ohne Sie vorher zu fragen. Im Manual-Modus hält Claude Code inne und fragt Sie, bevor die meisten Aktionen ausgeführt werden, die Dateien bearbeiten, Shell-Befehle ausführen oder das Netzwerk erreichen. Im [Auto-Modus](#eliminate-prompts-with-auto-mode) überprüft ein zweites Modell, der Klassifizierer, Aktionen statt Ihnen; [wie der Klassifizierer Aktionen bewertet](#how-the-classifier-evaluates-actions) listet auf, welche Aktionen er überprüft und welche er überspringt.

10 10

11Bei Pro-, Max- und Team-Plänen ist der integrierte Standard-Berechtigungsmodus Auto-Modus. [Welcher Modus eine Sitzung startet](#which-mode-a-session-starts-in) behandelt die Oberflächen und Einstellungen, die den Standard-Berechtigungsmodus ändern. Sie können auch den Berechtigungsmodus einer laufenden Sitzung jederzeit ändern.11Mit Claude Code v2.1.283 oder später ist der Auto-Modus der integrierte Standard-Berechtigungsmodus für interaktive Terminal- und VS Code-Sitzungen. Bei früheren Versionen ist er der integrierte Standard-Berechtigungsmodus nur bei Pro-, Max- und Team-Plänen. [Welcher Modus eine Sitzung startet](#which-mode-a-session-starts-in) behandelt die Oberflächen und Einstellungen, die den Standard-Berechtigungsmodus ändern. Sie können auch den Berechtigungsmodus einer laufenden Sitzung jederzeit ändern.

12 12

13<h2 id="available-modes">13<h2 id="available-modes">

14 Verfügbare Modi14 Verfügbare Modi

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

60| Arbeiten Sie freihändig im Auto-Modus | `claude --permission-mode auto`, der [integrierte Standard-Berechtigungsmodus](#which-mode-a-session-starts-in) bei Pro, Max und Team | 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 |

62| Führen Sie vollständig unbeaufsichtigt in einem Container aus | `claude -p "<prompt>" --dangerously-skip-permissions` | Erforderlich: ein Container, VM oder die [Sandbox-Laufzeit](/docs/de/sandbox-environments#sandbox-runtime); auf Linux und macOS, führen Sie es als [Nicht-Root-Benutzer](#skip-all-checks-with-bypasspermissions-mode) aus | Cloud-Sitzungen ignorieren diesen Modus aus Einstellungsdateien. In diesem `-p` Lauf werden die [wenigen Aufrufe, die weiterhin auffordern würden](#skip-all-checks-with-bypasspermissions-mode) stattdessen verweigert |62| Führen Sie vollständig unbeaufsichtigt in einem Container aus | `claude -p "<prompt>" --dangerously-skip-permissions` | Erforderlich: ein Container, VM oder die [Sandbox-Laufzeit](/docs/de/sandbox-environments#sandbox-runtime); auf Linux und macOS, führen Sie es als [Nicht-Root-Benutzer](#skip-all-checks-with-bypasspermissions-mode) aus | Cloud-Sitzungen ignorieren diesen Modus aus Einstellungsdateien. In diesem `-p` Lauf werden die [wenigen Aufrufe, die weiterhin auffordern würden](#skip-all-checks-with-bypasspermissions-mode) stattdessen verweigert |

63 63

81 81

82Der integrierte `auto` Standard erfordert Claude Code v2.1.228 oder später auf macOS, Linux und WSL, und v2.1.233 oder später auf nativem Windows. Bei früheren Versionen ist der integrierte Standard Manual.82Der integrierte `auto` Standard erfordert Claude Code v2.1.228 oder später auf macOS, Linux und WSL, und v2.1.233 oder später auf nativem Windows. Bei früheren Versionen ist der integrierte Standard Manual.

83 83

84Der integrierte Standard hängt davon ab, wie Sie Claude Code ausführen, von Ihrem Plan und davon, ob Claude Code seine Feature-Flags abrufen konnte. Die erste Zeile, die Ihrer Sitzung entspricht, gilt. Die Tabelle behandelt Sitzungen, die Sie in einem Terminal oder über die VS Code-Erweiterung starten; für die Desktop-App und claude.ai siehe die Desktop- und Web-Registerkarten in [Berechtigungsmodi wechseln](#switch-permission-modes).84Der integrierte Standard hängt davon ab, wie Sie Claude Code ausführen. Die erste Zeile, die Ihrer Sitzung entspricht, gilt. Die Tabelle behandelt Sitzungen, die Sie in einem Terminal oder über die VS Code-Erweiterung starten; für die Desktop-App und claude.ai siehe die Desktop- und Web-Registerkarten in [Berechtigungsmodi wechseln](#switch-permission-modes).

85 85

86| Wie Sie Claude Code ausführen | Integrierter Standard-Berechtigungsmodus |86| Wie Sie Claude Code ausführen | Integrierter Standard-Berechtigungsmodus |

87| :- | :- |87| :- | :- |

88| Eine Einstellungsdatei setzt `disableAutoMode` auf `"disable"` | `default` |88| Eine Einstellungsdatei setzt `disableAutoMode` auf `"disable"` | `default` |

~~89| [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) ist aus | `default` |~~

90| Ihre [erste Sitzung nach der Installation von Claude Code oder dem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade) auf eine Version, die diesen Standard hinzufügt, es sei denn, nach einer Neuinstallation ruft Claude Code die Flags rechtzeitig ab | `default` |

91| `claude -p` oder das [Agent SDK](/docs/de/agent-sdk/permissions) | `default` |89| `claude -p` oder das [Agent SDK](/docs/de/agent-sdk/permissions) | `default` |

92| Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder eine angemeldete [Claude Apps Gateway](/docs/de/claude-apps-gateway) Sitzung | `default` |90| In einem Terminal oder über die [VS Code-Erweiterung](/docs/de/vs-code) | `auto` mit Claude Code v2.1.283 oder später; bei früheren Versionen `auto` bei Pro-, Max- oder Team-Plänen in Sitzungen, die [Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching), und `default` andernfalls |

~~93| Ein Pro-, Max- oder Team-Plan, in einem Terminal oder über die [VS Code-Erweiterung](/docs/de/vs-code) | `auto` |~~

~~94| Ein Enterprise-Plan oder ein Claude Console API-Schlüssel | `default` |~~

95 91

96Wenn Feature-Flag-Abruf aus ist oder in einer [ersten Sitzung nach einer Installation oder einem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade), in der die Flags noch nicht angekommen sind, ignoriert die VS Code-Erweiterung jede Einstellungsdatei bei der Wahl des Standard-Berechtigungsmodus.92In Ihrer [ersten Sitzung nach einer Installation oder einem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade) kann Claude Code den Standard-Berechtigungsmodus wählen, bevor seine Feature-Flags ankommen. Diese Sitzung kann in einem anderen Berechtigungsmodus starten als die Tabelle angibt, und Ihre nächste Sitzung entspricht der Tabelle.

97 93

98Wenn das Flag, eine Einstellungsdatei oder der integrierte Standard `auto` auswählt, aber Auto-Modus nicht für die Sitzung verfügbar ist, startet Claude Code die Sitzung stattdessen im Manual-Modus. Auto-Modus ist nicht verfügbar, wenn die Sitzung die [Verfügbarkeitsanforderungen](#eliminate-prompts-with-auto-mode) nicht erfüllt, wie eine Einstellungsdatei, die ihn ausschaltet, oder ein Modell, das ihn nicht unterstützt, oder wenn Anthropic ihn vorübergehend serverseitig ausgeschaltet hat.94Wenn das Flag, eine Einstellungsdatei oder der integrierte Standard `auto` auswählt, aber Auto-Modus nicht für die Sitzung verfügbar ist, startet Claude Code die Sitzung stattdessen im Manual-Modus. Auto-Modus ist nicht verfügbar, wenn die Sitzung die [Verfügbarkeitsanforderungen](#eliminate-prompts-with-auto-mode) nicht erfüllt, wie eine Einstellungsdatei, die ihn ausschaltet, oder ein Modell, das ihn nicht unterstützt, oder wenn Anthropic ihn vorübergehend serverseitig ausgeschaltet hat.

99 95

177 173

178 1. `claudeCode.initialPermissionMode`174 1. `claudeCode.initialPermissionMode`

179 2. Der Modus, den Sie zuletzt aus dem Modusindikator gewählt haben, wenn er Manual, Edit automatically oder Auto war. Das Auswählen von Plan oder Bypass permissions gilt nur für diese Konversation175 2. Der Modus, den Sie zuletzt aus dem Modusindikator gewählt haben, wenn er Manual, Edit automatically oder Auto war. Das Auswählen von Plan oder Bypass permissions gilt nur für diese Konversation

180 3. `permissions.defaultMode` aus [verwalteten Einstellungen](/docs/de/managed-settings) oder `~/.claude/settings.json`, bei Pro-, Max- und Team-Plänen mit [Feature-Flag-Abruf](#which-mode-a-session-starts-in) verfügbar176 3. `permissions.defaultMode` aus [verwalteten Einstellungen](/docs/de/managed-settings) oder `~/.claude/settings.json`

181 4. Der [integrierte Standard](#which-mode-a-session-starts-in) für Ihren Plan, Anbieter und Organisationseinstellungen177 4. Der [integrierte Standard](#which-mode-a-session-starts-in) für Ihren Plan, Anbieter und Organisationseinstellungen

182 178

183 Die Erweiterung liest nie `.claude/settings.json` oder `.claude/settings.local.json` eines Projekts für den Standard-Berechtigungsmodus, und in Konversationen, die Punkt 3 nicht erfüllen, liest sie überhaupt keine Einstellungsdatei. Wenn `claudeCode.claudeProcessWrapper` gesetzt ist, gelten Punkte 3 und 4 auch nicht: Diese Konversationen starten im Manual-Modus, es sei denn, Punkt 1 oder Punkt 2 setzt einen Berechtigungsmodus.179 Die Erweiterung liest nie `.claude/settings.json` oder `.claude/settings.local.json` eines Projekts für den Standard-Berechtigungsmodus. Wenn `claudeCode.claudeProcessWrapper` gesetzt ist, gelten Punkte 3 und 4 nicht: Diese Konversationen starten im Manual-Modus, es sei denn, Punkt 1 oder Punkt 2 setzt einen Berechtigungsmodus.

180

181 Vor v2.1.283 galt Punkt 3 nur bei Pro-, Max- und Team-Plänen in Sitzungen, die [Feature-Flags abrufen](/docs/de/env-vars#features-that-need-feature-flag-fetching).

184 182

185 Auto wird im Modusindikator angezeigt, wenn [Auto-Modus verfügbar ist](#eliminate-prompts-with-auto-mode).183 Auto wird im Modusindikator angezeigt, wenn [Auto-Modus verfügbar ist](#eliminate-prompts-with-auto-mode).

186 184

213 <Tab title="Web and mobile">211 <Tab title="Web and mobile">

214 Verwenden Sie das Modusmenü neben dem Eingabefeld auf [claude.ai/code](https://claude.ai/code) oder in der mobilen App. Berechtigungsaufforderungen werden in claude.ai zur Genehmigung angezeigt. Welche Modi angezeigt werden, hängt davon ab, wo die Sitzung läuft:212 Verwenden Sie das Modusmenü neben dem Eingabefeld auf [claude.ai/code](https://claude.ai/code) oder in der mobilen App. Berechtigungsaufforderungen werden in claude.ai zur Genehmigung angezeigt. Welche Modi angezeigt werden, hängt davon ab, wo die Sitzung läuft:

215 213

216 * **Cloud-Sitzungen** auf [Claude Code im Web](/docs/de/claude-code-on-the-web): Bearbeitungen akzeptieren, Plan und Auto. Bearbeitungen akzeptieren entspricht dem `default` Modus: Cloud-Sitzungen genehmigen Dateibearbeitungen vorab, unabhängig vom Modus, daher zeigt das Menü Bearbeitungen akzeptieren statt Manual an. Cloud-Sitzungen respektieren weiterhin `defaultMode: "acceptEdits"` aus den Einstellungen. Der Auto-Modus wird nur angezeigt, wenn Ihre Organisation ihn zulässt und das ausgewählte Modell ihn unterstützt. Bypass permissions ist nicht verfügbar.214 * **[Cloud-Sitzungen](/docs/de/claude-code-on-the-web)**: Bearbeitungen akzeptieren, Plan und Auto. Bearbeitungen akzeptieren entspricht dem `default` Modus: Cloud-Sitzungen genehmigen Dateibearbeitungen vorab, unabhängig vom Modus, daher zeigt das Menü Bearbeitungen akzeptieren statt Manual an. Cloud-Sitzungen respektieren weiterhin `defaultMode: "acceptEdits"` aus den Einstellungen. Der Auto-Modus wird nur angezeigt, wenn Ihre Organisation ihn zulässt und das ausgewählte Modell ihn unterstützt. Bypass permissions ist nicht verfügbar.

217 * **[Remote Control](/docs/de/remote-control) Sitzungen** auf Ihrem lokalen Computer: Manual, Bearbeitungen akzeptieren und Plan. Sie können Auto oder Bypass permissions nicht aus der App auswählen.215 * **[Remote Control](/docs/de/remote-control) Sitzungen** auf Ihrem lokalen Computer: Manual, Bearbeitungen akzeptieren und Plan für eine Sitzung, die Sie selbst gestartet haben, und Sie können Auto oder Bypass permissions nicht aus der App auswählen. Für einen Projekt-Thread, der auf Ihrem Computer läuft, siehe [Führen Sie einen Thread auf Ihrem eigenen Computer aus](/docs/de/claude-projects#run-a-thread-on-your-own-computer).

218 * Außer für Bypass permissions zeigt das Menü den Berechtigungsmodus an, in dem sich die lokale Sitzung befindet, einschließlich eines vom Terminal aus festgelegten Modus. Es wird aktualisiert, wenn sich der Berechtigungsmodus in der App oder im Terminal ändert. Die Sitzung meldet Bypass permissions nie an claude.ai, daher ändert das Wechseln vom Terminal aus nicht, was das Menü anzeigt.216 * Außer für Bypass permissions zeigt das Menü den Berechtigungsmodus an, in dem sich die lokale Sitzung befindet, einschließlich eines vom Terminal aus festgelegten Modus. Es wird aktualisiert, wenn sich der Berechtigungsmodus in der App oder im Terminal ändert.

219 * Sitzungen, die von der [Desktop-App](/docs/de/desktop) oder der [VS Code-Erweiterung](/docs/de/vs-code) gehostet werden, melden Berechtigungsmodus-Änderungen an claude.ai, während sie passieren, genauso wie Sitzungen, die in einem Terminal gehostet werden.217 * Sitzungen, die von der [Desktop-App](/docs/de/desktop) oder der [VS Code-Erweiterung](/docs/de/vs-code) gehostet werden, melden Berechtigungsmodus-Änderungen an claude.ai, während sie passieren, genauso wie Sitzungen, die in einem Terminal gehostet werden.

220 * Vor v2.1.202 meldeten Sitzungen, die mit `/remote-control` oder `claude --remote-control` verbunden waren, ihren Berechtigungsmodus überhaupt nicht, daher konnten claude.ai und die mobile App einen Berechtigungsmodus anzeigen, in dem sich die Sitzung nicht befand. Die Nichtübereinstimmung betraf nur die Beschriftung. Claude Code generierte Berechtigungsaufforderungen aus dem tatsächlichen Berechtigungsmodus der Sitzung, und sie wurden weiterhin in der App zur Genehmigung angezeigt.218 * Vor v2.1.202 meldeten Sitzungen, die mit `/remote-control` oder `claude --remote-control` verbunden waren, ihren Berechtigungsmodus überhaupt nicht, daher konnten claude.ai und die mobile App einen Berechtigungsmodus anzeigen, in dem sich die Sitzung nicht befand. Die Nichtübereinstimmung betraf nur die Beschriftung. Claude Code generierte Berechtigungsaufforderungen aus dem tatsächlichen Berechtigungsmodus der Sitzung, und sie wurden weiterhin in der App zur Genehmigung angezeigt.

221 219

233 231

234Der `acceptEdits`-Modus ermöglicht es Claude, Dateien in Ihrem Arbeitsverzeichnis zu erstellen und zu bearbeiten, ohne Sie zu fragen. Die Statusleiste zeigt `⏵⏵ accept edits on` an, während dieser Modus aktiv ist.232Der `acceptEdits`-Modus ermöglicht es Claude, Dateien in Ihrem Arbeitsverzeichnis zu erstellen und zu bearbeiten, ohne Sie zu fragen. Die Statusleiste zeigt `⏵⏵ accept edits on` an, während dieser Modus aktiv ist.

235 233

236Zusätzlich zu Dateibearbeitungen genehmigt der `acceptEdits`-Modus automatisch häufige Bash-Befehle im Dateisystem: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` und `sed`. Diese Befehle werden auch automatisch genehmigt, wenn sie mit sicheren Umgebungsvariablen wie `LANG=C` oder `NO_COLOR=1` oder Prozess-Wrappern wie `timeout`, `nice` oder `nohup` vorangestellt sind. Wie bei Dateibearbeitungen gilt die automatische Genehmigung nur für Pfade in Ihrem Arbeitsverzeichnis oder `additionalDirectories`. Pfade außerhalb dieses Bereichs, Schreibvorgänge in [geschützte Pfade](#protected-paths), `rm` und `rmdir` Löschungen, die auf einen [kritischen Pfad](#critical-paths) abzielen, und alle anderen Bash-Befehle außer dem [integrierten schreibgeschützten Satz](/docs/de/permissions#read-only-commands) erfordern weiterhin eine Genehmigung.234Zusätzlich zu Dateibearbeitungen genehmigt der `acceptEdits`-Modus automatisch häufige Bash-Befehle im Dateisystem: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` und `sed`. Diese Befehle werden auch automatisch genehmigt, wenn sie mit sicheren Umgebungsvariablen wie `LANG=C` oder `NO_COLOR=1` oder Prozess-Wrappern wie `timeout`, `nice` oder `nohup` vorangestellt sind. Wie bei Dateibearbeitungen gilt die automatische Genehmigung nur für Pfade in Ihrem Arbeitsverzeichnis oder `additionalDirectories`.

235

236Jeder Pfad durchläuft auch die [Symlink-Prüfung](/docs/de/permissions#symlinks), daher wird ein Schreibvorgang, der außerhalb dieses Bereichs aufgelöst wird, ebenfalls nicht automatisch genehmigt. Pfade außerhalb dieses Bereichs, Schreibvorgänge in [geschützte Pfade](#protected-paths), `rm` und `rmdir` Löschungen, die auf einen [kritischen Pfad](#critical-paths) abzielen, und alle anderen Bash-Befehle außer dem [integrierten schreibgeschützten Satz](/docs/de/permissions#read-only-commands) erfordern weiterhin eine Genehmigung.

237 237

238Wenn das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aktiviert ist, genehmigt der `acceptEdits`-Modus auch automatisch `Set-Content`, `Add-Content`, `Clear-Content` und `Remove-Item` auf Pfaden im Gültigkeitsbereich, zusammen mit ihren häufigen Aliasen. Die gleichen Bereichs- und Schutzpfad-Regeln gelten, und `Remove-Item` erhält [seine eigene Prüfung](#remove-item-in-powershell). Ein Positionsargument, das ein Anführungszeichen enthält, wie das Apostroph in `Set-Content .\notes.txt "It's done"`, fordert weiterhin auf, auch auf Pfaden im Gültigkeitsbereich, da Claude Code ein Argument, dessen zitierte und unzitierte Lesarten unterschiedlich sind, nicht statisch validieren kann. Übergeben Sie den Inhalt durch einen benannten Parameter wie `-Value`, um die Aufforderung zu vermeiden.238Wenn das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aktiviert ist, genehmigt der `acceptEdits`-Modus auch automatisch `Set-Content`, `Add-Content`, `Clear-Content` und `Remove-Item` auf Pfaden im Gültigkeitsbereich, zusammen mit ihren häufigen Aliasen. Die gleichen Bereichs- und Schutzpfad-Regeln gelten, und `Remove-Item` erhält [seine eigene Prüfung](#remove-item-in-powershell). Ein Positionsargument, das ein Anführungszeichen enthält, wie das Apostroph in `Set-Content .\notes.txt "It's done"`, fordert weiterhin auf, auch auf Pfaden im Gültigkeitsbereich, da Claude Code ein Argument, dessen zitierte und unzitierte Lesarten unterschiedlich sind, nicht statisch validieren kann. Übergeben Sie den Inhalt durch einen benannten Parameter wie `-Value`, um die Aufforderung zu vermeiden.

239 239

251 251

252Der Plan-Modus weist Claude an, Änderungen zu recherchieren und vorzuschlagen, ohne sie vorzunehmen. Claude liest Dateien, führt Shell-Befehle aus, um zu erkunden, und schreibt einen Plan, bearbeitet aber nicht Ihre Quelle. Außer in interaktiven Terminal-Sitzungen mit [verfügbaren Bypass-Berechtigungen](#skip-all-checks-with-bypasspermissions-mode) bleiben Bearbeitungen blockiert, bis Sie den Plan genehmigen.252Der Plan-Modus weist Claude an, Änderungen zu recherchieren und vorzuschlagen, ohne sie vorzunehmen. Claude liest Dateien, führt Shell-Befehle aus, um zu erkunden, und schreibt einen Plan, bearbeitet aber nicht Ihre Quelle. Außer in interaktiven Terminal-Sitzungen mit [verfügbaren Bypass-Berechtigungen](#skip-all-checks-with-bypasspermissions-mode) bleiben Bearbeitungen blockiert, bis Sie den Plan genehmigen.

253 253

254Wenn [Auto-Modus](/docs/de/auto-mode-config) verfügbar ist und die `useAutoModeDuringPlan` Einstellung aktiviert ist, was die Standardeinstellung ist, überprüft der Klassifizierer Shell-Befehle während der Planung statt Sie zu fragen. Genehmigte Befehle laufen, und abgelehnte werden blockiert. Andernfalls fordern Befehle außerhalb des [integrierten schreibgeschützten Satzes](/docs/de/permissions#read-only-commands) zur Genehmigung auf, auch wenn der Sandbox-[Auto-Allow-Modus](/docs/de/sandboxing#sandbox-modes) aktiviert ist. In interaktiven Terminal-Sitzungen mit verfügbaren Bypass-Berechtigungen gelten weder der Klassifizierer noch eine Aufforderung für Planungsbefehle; [Alle Überprüfungen mit bypassPermissions-Modus überspringen](#skip-all-checks-with-bypasspermissions-mode) behandelt die wenigen Dinge, die dort weiterhin auffordern. In v2.1.212 bis v2.1.217 forderten Sitzungen ohne verfügbare Bypass-Berechtigungen für jeden Befehl außerhalb des schreibgeschützten Satzes auf, unabhängig davon, ob Auto-Modus verfügbar war.254Was mit einem Shell-Befehl während der Planung geschieht, hängt von der Sitzung ab, und der erste dieser Fälle, der zutrifft, gilt:

255

256* **Interaktive Terminal-Sitzungen mit verfügbaren Bypass-Berechtigungen**: Weder der Klassifizierer noch eine Aufforderung gilt für Planungsbefehle. [Alle Überprüfungen mit bypassPermissions-Modus überspringen](#skip-all-checks-with-bypasspermissions-mode) behandelt die wenigen Dinge, die dort weiterhin auffordern.

257* **[Auto-Modus](/docs/de/auto-mode-config) verfügbar und die `useAutoModeDuringPlan` Einstellung aktiviert**, was die Standardeinstellung ist: Der Klassifizierer überprüft Shell-Befehle außer [kritischen Pfad-Entfernungen](#critical-paths) statt Sie zu fragen. Genehmigte Befehle laufen, und abgelehnte werden blockiert.

258* **Auto-Modus nicht verfügbar oder `useAutoModeDuringPlan` deaktiviert**: Befehle außerhalb des [integrierten schreibgeschützten Satzes](/docs/de/permissions#read-only-commands) fordern zur Genehmigung auf, auch wenn der Sandbox-[Auto-Allow-Modus](/docs/de/sandboxing#sandbox-modes) aktiviert ist.

255 259

256Geben Sie den Plan-Modus ein, indem Sie `Shift+Tab` drücken oder einem einzelnen Prompt `/plan` voranstellen. Sie können auch vom CLI aus im Plan-Modus starten:260Geben Sie den Plan-Modus ein, indem Sie `Shift+Tab` drücken oder einem einzelnen Prompt `/plan` voranstellen. Sie können auch vom CLI aus im Plan-Modus starten:

257 261

289 293

290Der Auto-Modus ermöglicht Claude, ohne routinemäßige Genehmigungsaufforderungen auszuführen. Ein separates Klassifizierungsmodell überprüft Aktionen vor ihrer Ausführung und blockiert alles, das über Ihre Anfrage hinausgeht, auf nicht erkannte Infrastruktur abzielt oder von feindseligem Inhalt angetrieben zu sein scheint, den Claude gelesen hat. Explizite [Ask-Regeln](/docs/de/permissions#manage-permissions) erzwingen weiterhin eine Aufforderung.294Der Auto-Modus ermöglicht Claude, ohne routinemäßige Genehmigungsaufforderungen auszuführen. Ein separates Klassifizierungsmodell überprüft Aktionen vor ihrer Ausführung und blockiert alles, das über Ihre Anfrage hinausgeht, auf nicht erkannte Infrastruktur abzielt oder von feindseligem Inhalt angetrieben zu sein scheint, den Claude gelesen hat. Explizite [Ask-Regeln](/docs/de/permissions#manage-permissions) erzwingen weiterhin eine Aufforderung.

291 295

292In Pro-, Max- und Team-Plänen ist der Auto-Modus der [integrierte Standard-Genehmigungsmodus](#which-mode-a-session-starts-in).296Mit Claude Code v2.1.283 oder später ist der Auto-Modus der [integrierte Standard-Genehmigungsmodus](#which-mode-a-session-starts-in) für interaktive Terminal- und VS Code-Sitzungen auf jedem Plan und Anbieter. Bei früheren Versionen ist er der integrierte Standard-Genehmigungsmodus nur auf Pro-, Max- und Team-Plänen.

293 297

294Der Klassifizierer überprüft auch jede Nachricht, die Claude mit [`SendMessage`](/docs/de/tools-reference) an einen anderen Agent sendet, ob als Klartext oder als strukturierte [Agent-Team](/docs/de/agent-teams)-Nachricht, bevor Claude Code sie liefert, sowohl im Auto-Modus als auch im [Plan-Modus, während der Klassifizierer Befehle überprüft](#analyze-before-you-edit-with-plan-mode); die Sendungsüberprüfung erfordert Claude Code v2.1.222 oder später.298Der Klassifizierer überprüft auch jede Nachricht, die Claude mit [`SendMessage`](/docs/de/tools-reference) an einen anderen Agent sendet, ob als Klartext oder als strukturierte [Agent-Team](/docs/de/agent-teams)-Nachricht, bevor Claude Code sie liefert, sowohl im Auto-Modus als auch im [Plan-Modus, während der Klassifizierer Befehle überprüft](#analyze-before-you-edit-with-plan-mode); die Sendungsüberprüfung erfordert Claude Code v2.1.222 oder später.

295 299

296Der Klassifizierer überprüft und genehmigt oder blockiert auch `rm`- und `rmdir`-Löschungen, die auf einen [kritischen Pfad](#critical-paths) abzielen, wie `rm -rf /` und `rm -rf ~`, auch wenn die Löschung in einer Befehl- oder Prozessersetzung stattfindet.300Standardmäßig überprüft der Klassifizierer `rm`- und `rmdir`-Löschungen, die auf einen kritischen Pfad abzielen, wie `rm -rf /` oder `rm -rf ~`, nicht. [Kritische Pfade](#critical-paths) behandelt, was mit ihnen in jedem Genehmigungsmodus passiert.

297 301

298Der Auto-Modus ermutigt Claude auch, weiter zu arbeiten, ohne bei Klärungsfragen zu stoppen, obwohl Claude immer noch fragt, wenn Ihre Eingabeaufforderung oder eine Fähigkeit explizit darauf angewiesen ist. Für stärkeres autonomes Verhalten in einem Modus, der Sie immer noch auffordert, stellen Sie stattdessen den [Proaktiven Ausgabestil](/docs/de/output-styles) ein.302Der Auto-Modus ermutigt Claude auch, weiter zu arbeiten, ohne bei Klärungsfragen zu stoppen, obwohl Claude immer noch fragt, wenn Ihre Eingabeaufforderung oder eine Fähigkeit explizit darauf angewiesen ist. Für stärkeres autonomes Verhalten in einem Modus, der Sie immer noch auffordert, stellen Sie stattdessen den [Proaktiven Ausgabestil](/docs/de/output-styles) ein.

299 303

305 309

306* **Plan**: Alle Pläne.310* **Plan**: Alle Pläne.

307* **Organisation**: Bei Team und Enterprise ist der Auto-Modus standardmäßig verfügbar. Administratoren können ihn für die Organisation deaktivieren, indem sie `permissions.disableAutoMode` in [verwalteten Einstellungen](/docs/de/managed-settings) auf `"disable"` setzen.311* **Organisation**: Bei Team und Enterprise ist der Auto-Modus standardmäßig verfügbar. Administratoren können ihn für die Organisation deaktivieren, indem sie `permissions.disableAutoMode` in [verwalteten Einstellungen](/docs/de/managed-settings) auf `"disable"` setzen.

308* **Modell**: In der Anthropic API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws), Claude Opus 4.6 oder später, Sonnet 4.6 oder später, oder ein [Fable-Modell](/docs/de/model-config#work-with-fable). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzungen nur Claude Sonnet 5, Opus 4.7 oder später und die Fable-Modelle. Ältere Modelle, einschließlich Sonnet 4.5, Opus 4.5, Haiku und claude-3-Modelle, werden auf keinem Anbieter unterstützt.312* **Modell**: In der Anthropic API und [Claude Platform on AWS](/docs/de/claude-platform-on-aws), Claude Opus 4.6 oder später, Sonnet 4.6 oder später, oder ein [Fable-Modell](/docs/de/model-config#work-with-fable). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzungen nur Claude Sonnet 5 oder später, Opus 4.7 oder später und die Fable-Modelle. Ältere Modelle, einschließlich Sonnet 4.5, Opus 4.5, Haiku und claude-3-Modelle, werden auf keinem Anbieter unterstützt.

309* **Anbieter**: Standardmäßig verfügbar in der Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten Claude-Apps-Gateway-Sitzungen.313* **Anbieter**: Standardmäßig verfügbar in der Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten Claude-Apps-Gateway-Sitzungen.

310 314

311Wenn Claude Code meldet, dass der Auto-Modus nicht verfügbar ist, überprüfen Sie zunächst diese Anforderungen und ob eine Einstellungsdatei [`disableAutoMode`](/docs/de/settings-reference#disableautomode) setzt. Anthropic kann den Auto-Modus auch serverseitig deaktiviert haben, oder der Server kann den Auto-Modus für Ihr Konto abgelehnt haben. Eine Sitzung, die eine dieser Antworten erhalten hat, behält den Auto-Modus aus, bis die Sitzung endet. Starten Sie später eine neue Sitzung.315Wenn Claude Code meldet, dass der Auto-Modus nicht verfügbar ist, überprüfen Sie zunächst diese Anforderungen und ob eine Einstellungsdatei [`disableAutoMode`](/docs/de/settings-reference#disableautomode) setzt. Anthropic kann den Auto-Modus auch serverseitig deaktiviert haben, oder der Server kann den Auto-Modus für Ihr Konto abgelehnt haben. Eine Sitzung, die eine dieser Antworten erhalten hat, behält den Auto-Modus aus, bis die Sitzung endet. Starten Sie später eine neue Sitzung.

318 Auto-Modus auf Bedrock, Agent Platform oder Foundry322 Auto-Modus auf Bedrock, Agent Platform oder Foundry

319</h3>323</h3>

320 324

321Bei [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und angemeldeten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzungen wird der Auto-Modus standardmäßig im `Shift+Tab`-Zyklus angezeigt. Das Erscheinen im Zyklus ändert nicht den Genehmigungsmodus, in dem eine Sitzung startet: Bei diesen Anbietern starten Terminal-Sitzungen in Ihrem [`defaultMode`](/docs/de/settings-reference#permissions-defaultmode), der manuell ist, es sei denn, Sie ändern ihn, und Gespräche in der [VS Code-Erweiterung](/docs/de/vs-code) starten im manuellen Modus, es sei denn, `claudeCode.initialPermissionMode` oder ein Modus, den Sie in der Erweiterung ausgewählt haben, setzt einen. Nur Claude Sonnet 5, Opus 4.7 oder später und die Fable-Modelle werden auf diesen Anbietern unterstützt.325Bei [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und angemeldeten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Sitzungen ist der Auto-Modus standardmäßig verfügbar. Mit Claude Code v2.1.283 oder später ist er auch der [integrierte Standard-Genehmigungsmodus](#which-mode-a-session-starts-in) für interaktive Terminal- und [VS Code](/docs/de/vs-code)-Sitzungen. Um den Standard-Genehmigungsmodus selbst zu wählen, setzen Sie `permissions.defaultMode` wie [In einem anderen Genehmigungsmodus starten](#start-in-a-different-mode) beschreibt, oder wählen Sie einen Genehmigungsmodus aus dem Modusindikator der VS Code-Erweiterung.

322 326

323Um den Auto-Modus zum Standard-Startgenehmigungsmodus zu machen, setzen Sie `"permissions": {"defaultMode": "auto"}` in Benutzer- oder verwalteten Einstellungen. Wählen Sie in Sitzungen, die die VS Code-Erweiterung startet, stattdessen **Auto** aus dem Modusindikator. [Genehmigungsmodi wechseln](#switch-permission-modes) behandelt, was diese Auswahl übertrumpft.327Nur Claude Sonnet 5 oder später, Opus 4.7 oder später und die Fable-Modelle werden auf diesen Anbietern unterstützt. Bei jedem anderen Modell startet die Sitzung stattdessen im manuellen Modus.

~~324~~

325Die [`/doctor`](/docs/de/commands#all-commands)-Überprüfung schlägt diesen Benutzereinstellungs-Standard auf diesen Anbietern auf die gleiche Weise vor wie auf der Anthropic API.

326 328

327Um Entwickler daran zu hindern, den Auto-Modus zu verwenden, setzen Sie `disableAutoMode` in [verwalteten Einstellungen](/docs/de/managed-settings) auf `"disable"`. Dies entfernt `auto` aus dem `Shift+Tab`-Zyklus, und eine Sitzung, die mit `--permission-mode auto` gestartet wurde, startet stattdessen im manuellen Modus. Eine bereits im Auto-Modus laufende Sitzung verlässt ihn, wenn die Einstellung diese Sitzung von einer [von Admin bereitgestellten Quelle](/docs/de/managed-settings#which-managed-source-claude-code-uses) erreicht, und zeigt `auto mode disabled by settings`. Vor v2.1.251 behielt eine laufende Sitzung den Auto-Modus bis zum Ende.329Um Entwickler daran zu hindern, den Auto-Modus zu verwenden, setzen Sie `disableAutoMode` in [verwalteten Einstellungen](/docs/de/managed-settings) auf `"disable"`. Dies entfernt `auto` aus dem `Shift+Tab`-Zyklus, und eine Sitzung, die mit `--permission-mode auto` gestartet wurde, startet stattdessen im manuellen Modus. Eine bereits im Auto-Modus laufende Sitzung verlässt ihn, wenn die Einstellung diese Sitzung von einer [von Admin bereitgestellten Quelle](/docs/de/managed-settings#which-managed-source-claude-code-uses) erreicht, und zeigt `auto mode disabled by settings`. Vor v2.1.251 behielt eine laufende Sitzung den Auto-Modus bis zum Ende.

328 330

343* **Der Server überprüft die Sitzung nicht**: Eine Antwort wird ohne Überprüfungsergebnisse abgeschlossen, oder der Server antwortet, dass er diese Sitzung nicht überprüft. Die häufigsten Ursachen sind ein LLM-Gateway oder Proxy, der die Anfrage zur Überprüfung oder die Ergebnisse blockiert, und eine Plattform, Region oder Anmeldedaten, die noch keine serverseitigen Überprüfungen haben. Claude Code fällt auf seine eigenen Klassifizierer-Anfragen zurück. Sobald dieses Fallback für den Rest der Sitzung gilt, zeigt es eine [Mitteilung über Klassifizierer-Anfrage-Gebühren](/docs/de/auto-mode-classifier-billing) auf Konten, bei denen diese Anfragen abgerechnet werden.345* **Der Server überprüft die Sitzung nicht**: Eine Antwort wird ohne Überprüfungsergebnisse abgeschlossen, oder der Server antwortet, dass er diese Sitzung nicht überprüft. Die häufigsten Ursachen sind ein LLM-Gateway oder Proxy, der die Anfrage zur Überprüfung oder die Ergebnisse blockiert, und eine Plattform, Region oder Anmeldedaten, die noch keine serverseitigen Überprüfungen haben. Claude Code fällt auf seine eigenen Klassifizierer-Anfragen zurück. Sobald dieses Fallback für den Rest der Sitzung gilt, zeigt es eine [Mitteilung über Klassifizierer-Anfrage-Gebühren](/docs/de/auto-mode-classifier-billing) auf Konten, bei denen diese Anfragen abgerechnet werden.

344* **Der Server gibt kein Urteil für eine Aktion**: Claude Code verweigert die Aktion, anstatt sie unüberprüft auszuführen. Bei jeder Verbindung geschieht dies, wenn die Antwort endet, bevor die Überprüfungsergebnisse ankommen, oder die Ergebnisse in einer Form ankommen, die Claude Code nicht lesen kann. Ein LLM-Gateway oder Proxy, der Antworten kürzt oder die Ergebnisse umschreibt, kann beides verursachen. Bei einer direkten Verbindung zur Anthropic API geschieht es auch, wenn die Überprüfung des Servers für die Aktion fehlschlägt, zum Beispiel durch Timeout. [Der Server hat kein Sicherheitsurteil zurückgegeben](/docs/de/errors#the-server-returned-no-safety-verdict) behandelt die Verweigerungsmitteilung, was passiert, wenn Verweigerungen wiederholt werden, und was zu tun ist.346* **Der Server gibt kein Urteil für eine Aktion**: Claude Code verweigert die Aktion, anstatt sie unüberprüft auszuführen. Bei jeder Verbindung geschieht dies, wenn die Antwort endet, bevor die Überprüfungsergebnisse ankommen, oder die Ergebnisse in einer Form ankommen, die Claude Code nicht lesen kann. Ein LLM-Gateway oder Proxy, der Antworten kürzt oder die Ergebnisse umschreibt, kann beides verursachen. Bei einer direkten Verbindung zur Anthropic API geschieht es auch, wenn die Überprüfung des Servers für die Aktion fehlschlägt, zum Beispiel durch Timeout. [Der Server hat kein Sicherheitsurteil zurückgegeben](/docs/de/errors#the-server-returned-no-safety-verdict) behandelt die Verweigerungsmitteilung, was passiert, wenn Verweigerungen wiederholt werden, und was zu tun ist.

345 347

346Um das Fragen des Servers zu überspringen und immer Claude Codes eigene Klassifizierer-Anfragen zu verwenden, setzen Sie [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/de/env-vars). Bei einer direkten Verbindung zur Anthropic API erfordert die Variable Claude Code v2.1.281 oder später. Das Setzen auf `1` dort schaltet die Serverseitige Überprüfung in einer Sitzung ein, die sie noch nicht hat, wie eine `-p`- oder Agent SDK-Sitzung, es sei denn, Sie haben auch `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` gesetzt. Wenn Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` setzen und `CLAUDE_CODE_AUTO_MODE_SERVER` nicht gesetzt lassen, stoppt Claude Code auch das Fragen des Servers.348Um das Fragen des Servers zu überspringen und immer Claude Codes eigene Klassifizierer-Anfragen zu verwenden, setzen Sie [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/de/env-vars). Bei einer direkten Verbindung zur Anthropic API erfordert die Variable Claude Code v2.1.281 oder später. Das Setzen auf `1` dort schaltet die serverseitige Überprüfung in einer Sitzung ein, die sie noch nicht hat, wie eine `-p`- oder Agent SDK-Sitzung, es sei denn, Sie haben auch `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` gesetzt. Wenn Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` setzen und `CLAUDE_CODE_AUTO_MODE_SERVER` nicht gesetzt lassen, stoppt Claude Code auch das Fragen des Servers, außer wie [Deaktivieren Sie Pre-Release-Funktionen](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) beschreibt.

347 349

348<h3 id="what-the-classifier-blocks-by-default">350<h3 id="what-the-classifier-blocks-by-default">

349 Was der Klassifizierer standardmäßig blockiert351 Was der Klassifizierer standardmäßig blockiert

407Claude Code v2.1.205 und später blockieren diese standardmäßig auch:409Claude Code v2.1.205 und später blockieren diese standardmäßig auch:

408 410

409* Schreiben in Claude Code-Sitzungstranskripte, die `.jsonl`-Verlaufsdateien unter `~/.claude/projects/` oder Ihrem konfigurierten Konfigurationsverzeichnis, ob direkt oder durch einen Shell-Befehl. Die Regel umfasst auch die Metadatenzeilen, die Claude Code an jeden Transkripteintrag für seine eigenen Überprüfungen anhängt. Das Lesen eines Transkripts wird nicht blockiert411* Schreiben in Claude Code-Sitzungstranskripte, die `.jsonl`-Verlaufsdateien unter `~/.claude/projects/` oder Ihrem konfigurierten Konfigurationsverzeichnis, ob direkt oder durch einen Shell-Befehl. Die Regel umfasst auch die Metadatenzeilen, die Claude Code an jeden Transkripteintrag für seine eigenen Überprüfungen anhängt. Das Lesen eines Transkripts wird nicht blockiert

410* Eine rekursive erzwungene Löschung wie `rm -rf "$VAR"` oder `Remove-Item -Recurse -Force $dir`, deren Ziel eine Shell-Variable ist, oder ein Glob, der an einer verwurzelt ist, die nirgendwo in der Konversation zugewiesen ist, die der Klassifizierer sieht. Der Wert kam nur aus früherer Befehlsausgabe, die der Klassifizierer nie erhält, daher kann der Klassifizierer das Löschziel nicht gegen die anderen Löschregeln überprüfen. Der Block wird gelöscht, wenn Sie den genauen gelöschten Pfad benennen, oder wenn Claude die Löschung mit dem aufgelösten Literalpfad, der in den Befehl geschrieben ist, erneut ausführt. Löschungen, deren Ziel der Klassifizierer auflösen kann, sind nicht betroffen. `Remove-Item`-Ziele, die ein bloßes `*` sind oder auf `/*` oder `\*` enden, erreichen den Klassifizierer nie: Claude Code [lehnt sie direkt ab](#remove-item-in-powershell)412* Eine rekursive erzwungene Löschung wie `rm -rf "$VAR"` oder `Remove-Item -Recurse -Force $dir`, deren Ziel eine Shell-Variable ist, die nirgendwo in der Konversation zugewiesen ist, die der Klassifizierer sieht, oder ein Glob, der an einer verwurzelt ist. Der Wert kam nur aus früherer Befehlsausgabe, die der Klassifizierer nie erhält, daher kann der Klassifizierer das Löschziel nicht gegen die anderen Löschregeln überprüfen. Der Block wird gelöscht, wenn Sie den genauen gelöschten Pfad benennen, oder wenn Claude die Löschung mit dem aufgelösten Literalpfad, der in den Befehl geschrieben ist, erneut ausführt. Löschungen, deren Ziel der Klassifizierer auflösen kann, sind nicht betroffen.

413

414 Ein Glob direkt unter der Variable, wie in `rm -rf "$VAR"/*`, ist stattdessen ein [kritischer Pfad](#critical-paths). `Remove-Item`-Ziele, die ein bloßes `*` sind oder auf `/*` oder `\*` enden, erreichen den Klassifizierer nie: Claude Code [lehnt sie direkt ab](#remove-item-in-powershell).

411 415

412Claude Code v2.1.257 und später blockieren diese standardmäßig auch:416Claude Code v2.1.257 und später blockieren diese standardmäßig auch:

413 417

457* **Weiterhin erlauben**: Der Lesezugriff läuft, spätere Lesezugriffe außerhalb der Arbeitsverzeichnisse laufen wie zuvor, und Claude Code zeichnet Ihre Antwort auf, damit die Aufforderung nicht wieder angezeigt wird461* **Weiterhin erlauben**: Der Lesezugriff läuft, spätere Lesezugriffe außerhalb der Arbeitsverzeichnisse laufen wie zuvor, und Claude Code zeichnet Ihre Antwort auf, damit die Aufforderung nicht wieder angezeigt wird

458* **Von jetzt an blockieren**: Der Lesezugriff wird verweigert, und Claude Code setzt [`permissions.blockReadsOutsideWorkingDirectories`](/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) in Ihren Benutzereinstellungen auf `true`, was die Dateiwerkzeuge dazu bringt, solche Lesezugriffe in jeder späteren Sitzung und jedem Genehmigungsmodus zu verweigern. Um Claude später einen solchen Pfad lesen zu lassen, fügen Sie sein Verzeichnis mit `/add-dir` hinzu oder entfernen Sie die Einstellung.462* **Von jetzt an blockieren**: Der Lesezugriff wird verweigert, und Claude Code setzt [`permissions.blockReadsOutsideWorkingDirectories`](/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) in Ihren Benutzereinstellungen auf `true`, was die Dateiwerkzeuge dazu bringt, solche Lesezugriffe in jeder späteren Sitzung und jedem Genehmigungsmodus zu verweigern. Um Claude später einen solchen Pfad lesen zu lassen, fügen Sie sein Verzeichnis mit `/add-dir` hinzu oder entfernen Sie die Einstellung.

459* **Nächstes Mal erneut fragen**: Der Lesezugriff wird verweigert, und der nächste Lesezugriff außerhalb der Arbeitsverzeichnisse fordert erneut auf463* **Nächstes Mal erneut fragen**: Der Lesezugriff wird verweigert, und der nächste Lesezugriff außerhalb der Arbeitsverzeichnisse fordert erneut auf

464* **Ja, aber nächstes Mal erneut fragen**: Der Lesezugriff läuft, nichts wird gespeichert, und der nächste Lesezugriff außerhalb der Arbeitsverzeichnisse fordert erneut auf

460 465

461<h3 id="boundaries-you-state-in-conversation">466<h3 id="boundaries-you-state-in-conversation">

462 Grenzen, die Sie in der Konversation angeben467 Grenzen, die Sie in der Konversation angeben

482 487

483Wenn der Auto-Modus Ihre Sitzungsaktionen nicht genehmigen kann, hängt das, was passiert, vom Fall ab:488Wenn der Auto-Modus Ihre Sitzungsaktionen nicht genehmigen kann, hängt das, was passiert, vom Fall ab:

484 489

485* **Eine blockierte Aktion**: Claude Code zeigt eine Benachrichtigung und listet die Aktion in `/permissions` unter der Registerkarte **Kürzlich verweigert** auf, wo Sie `r` drücken können, um sie mit einer manuellen Genehmigung erneut zu versuchen. Wenn der Klassifizierer [kein Urteil über die Aktion](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) erzeugt, weil eine Sicherheitsüberprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers selbst verweigerte oder seine Antwort nicht geparst wurde, verweigert Claude Code die Aktion ohne die Benachrichtigung oder den Eintrag **Kürzlich verweigert**.490* **Eine blockierte Aktion**: Claude Code zeigt eine Benachrichtigung und listet die Aktion in `/permissions` unter der Registerkarte **Kürzlich verweigert** auf, wo Sie `r` drücken können, um sie mit einer manuellen Genehmigung erneut zu versuchen.

486* **Wiederholte Blöcke**: Wenn der Klassifizierer eine Aktion 3 Mal hintereinander oder 20 Mal insgesamt blockiert, pausiert der Auto-Modus und Claude Code setzt das Auffordern fort. Das Genehmigen der aufgeforderten Aktion setzt den Auto-Modus fort. Diese Schwellwerte sind nicht konfigurierbar. Jede erlaubte Aktion setzt den aufeinanderfolgenden Zähler zurück, während der Gesamtzähler für die Sitzung bestehen bleibt und nur zurückgesetzt wird, wenn sein eigenes Limit einen Fallback auslöst. Claude Code zählt eine Verweigerung nicht zu einem Schwellwert, wenn [eine Sicherheitsüberprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers verweigert](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action); der verlinkte Eintrag behandelt, wie Claude Code diese Verweigerungen handhabt.491* **Wiederholte Blöcke**: Wenn der Klassifizierer eine Aktion 3 Mal hintereinander oder 20 Mal insgesamt blockiert, pausiert der Auto-Modus und Claude Code setzt das Auffordern fort. Das Genehmigen der aufgeforderten Aktion setzt den Auto-Modus fort. Siehe [Wiederholte-Block-Schwellwerte](#repeated-block-thresholds) für die Zählung der Blöcke.

487* **Sitzungen, die nicht auffordern können**: Ein [nicht-interaktiver](/docs/de/headless) `-p`-Lauf ohne ein [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) hat keine Aufforderung, auf die zurückgegriffen werden kann. Wenn wiederholte Blöcke einen Schwellwert erreichen, läuft die Aktion nicht und Claude arbeitet weiter. Das gleiche gilt, wenn [eine Sicherheitsüberprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers verweigert](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code stoppt den Lauf in keinem Fall.492* **Kein Urteil vom Klassifizierer**: Wenn eine Sicherheitsüberprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers verweigert, oder die Antwort des Klassifizierers nicht geparst wird, verweigert Claude Code die Aktion ohne die Benachrichtigung oder den Eintrag **Kürzlich verweigert**. Siehe [Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action) für die Nachricht in jedem Fall und was zu tun ist.

488* **Kein Urteil vom Server**: Unter [serverseitiger Klassifizierer-Überprüfung](#server-side-classifier-review) verweigert Claude Code eine Aktion, für die der Server kein Urteil gibt, und stoppt die Runde nach zehn Antworten hintereinander ohne Urteil. Siehe [Der Server hat kein Sicherheitsurteil zurückgegeben](/docs/de/errors#the-server-returned-no-safety-verdict).493* **Kein Urteil vom Server**: Unter [serverseitiger Klassifizierer-Überprüfung](#server-side-classifier-review) verweigert Claude Code eine Aktion, für die der Server kein Urteil gibt, und stoppt die Runde nach zehn Antworten hintereinander ohne Urteil. Siehe [Der Server hat kein Sicherheitsurteil zurückgegeben](/docs/de/errors#the-server-returned-no-safety-verdict).

489* **Ein Modusschalter während einer Überprüfung**: Wenn Sie Genehmigungsmodi wechseln, während eine Klassifizierer-Überprüfung ausstehend ist, verwirft Claude Code ein Urteil, das der neue Modus nicht angefordert hätte, statt es anzuwenden: Sie werden stattdessen aufgefordert, oder die Aktion wird im [`dontAsk`-Modus](#allow-only-pre-approved-tools-with-dontask-mode) automatisch verweigert.494* **Ein Modusschalter während einer Überprüfung**: Wenn Sie Genehmigungsmodi wechseln, während eine Klassifizierer-Überprüfung ausstehend ist, verwirft Claude Code ein Urteil, das der neue Modus nicht angefordert hätte. Sie werden stattdessen aufgefordert, oder die Aktion wird im [`dontAsk`-Modus](#allow-only-pre-approved-tools-with-dontask-mode) automatisch verweigert.

495

496<h4 id="repeated-block-thresholds">

497 Wiederholte-Block-Schwellwerte

498</h4>

499

500Die Schwellwerte von 3 Blöcken hintereinander und 20 Blöcken insgesamt sind nicht konfigurierbar. Der Gesamtzähler bleibt für die Sitzung bestehen und wird nur zurückgesetzt, wenn sein eigenes Limit einen Fallback auslöst. Claude Code zählt eine Verweigerung nicht zu einem Schwellwert, wenn eine Sicherheitsüberprüfung, die vom Auto-Modus getrennt ist, die Anfrage des Klassifizierers verweigert.

501

502Ein [nicht-interaktiver](/docs/de/headless) `-p`-Lauf ohne ein [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) hat keine Aufforderung, auf die zurückgegriffen werden kann. Wenn wiederholte Blöcke einen Schwellwert erreichen, läuft die Aktion nicht und Claude arbeitet weiter. Claude Code stoppt den Lauf nicht.

490 503

491Wiederholte Blöcke bedeuten normalerweise, dass dem Klassifizierer Kontext über Ihre Infrastruktur fehlt. Verwenden Sie `/feedback`, um falsch positive zu melden, oder lassen Sie einen Administrator [vertrauenswürdige Infrastruktur konfigurieren](/docs/de/auto-mode-config).504Wiederholte Blöcke bedeuten normalerweise, dass dem Klassifizierer Kontext über Ihre Infrastruktur fehlt. Verwenden Sie `/feedback`, um falsch positive zu melden, oder lassen Sie einen Administrator [vertrauenswürdige Infrastruktur konfigurieren](/docs/de/auto-mode-config).

492 505

506<h3 id="how-auto-mode-evaluates-actions">

507 Wie Auto-Modus Aktionen bewertet

508</h3>

509

510Die folgenden Abschnitte behandeln die Reihenfolge, in der Claude Code eine Aktion bewertet, wie der Klassifizierer Subagenten-Arbeit überprüft, und welche Klassifizierer-Aufrufe in Kosten und Latenz hinzufügen.

511

493<span id="how-the-classifier-evaluates-actions" />512<span id="how-the-classifier-evaluates-actions" />

494 513

495<AccordionGroup>514<AccordionGroup>

497 Jede Aktion durchläuft eine feste Entscheidungsreihenfolge. Der erste passende Schritt gewinnt:516 Jede Aktion durchläuft eine feste Entscheidungsreihenfolge. Der erste passende Schritt gewinnt:

498 517

499 1. Aktionen, die Ihren [Allow-, Ask- oder Deny-Regeln](/docs/de/permissions#manage-permissions) entsprechen, werden sofort aufgelöst, mit diesen Ausnahmen:518 1. Aktionen, die Ihren [Allow-, Ask- oder Deny-Regeln](/docs/de/permissions#manage-permissions) entsprechen, werden sofort aufgelöst, mit diesen Ausnahmen:

500 * Schreibvorgänge zu [geschützten Pfaden](#protected-paths) werden zum Klassifizierer weitergeleitet, auch wenn eine Allow-Regel passt, und ebenso `rm`- und `rmdir`-Löschungen, die auf einen [kritischen Pfad](#critical-paths) in Claude Code v2.1.218 und später abzielen519 * Schreibvorgänge zu [geschützten Pfaden](#protected-paths) werden zum Klassifizierer weitergeleitet, auch wenn eine Allow-Regel passt

520 * Keine Allow-Regel genehmigt `rm`- und `rmdir`-Löschungen, die auf einen [kritischen Pfad](#critical-paths) abzielen

501 * MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) markiert sind, fordern Sie direkt auf, auch wenn eine Allow-Regel passt, und ebenso Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) in Sitzungen, in denen diese Einstellung Claude Code erreicht521 * MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) markiert sind, fordern Sie direkt auf, auch wenn eine Allow-Regel passt, und ebenso Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) in Sitzungen, in denen diese Einstellung Claude Code erreicht

502 * Ein Shell-Befehl, der [pro-Befehl erlaubte Domänen](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode) trägt, wird auch zum Klassifizierer weitergeleitet, auch wenn eine Allow-Regel passt, weil eine Regel den Befehl genehmigt, nicht seine Hosts522 * Ein Shell-Befehl, der [pro-Befehl erlaubte Domänen](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode) trägt, wird auch zum Klassifizierer weitergeleitet, auch wenn eine Allow-Regel passt, weil eine Regel den Befehl genehmigt, nicht seine Hosts

503 * Ask-Regeln, die auf Befehlsinhalte abgleichen, wie `Bash(git push *)`, fallen auf eine Genehmigungsaufforderung zurück523 * Ask-Regeln, die auf Befehlsinhalte abgleichen, wie `Bash(git push *)`, fallen auf eine Genehmigungsaufforderung zurück

524 * Ein Schreibvorgang, den die [Symlink-Überprüfung](/docs/de/permissions#symlinks) zu einem geschützten Pfad auflöst, fordert Sie auf, wenn der Pfad, den Claude angefordert hat, nicht selbst geschützt ist

504 2. Schreibgeschützte Aktionen und Dateieditierungen in Ihrem Arbeitsverzeichnis werden automatisch genehmigt, außer Schreibvorgänge zu [geschützten Pfaden](#protected-paths) und [dem ersten Lesezugriff außerhalb der Arbeitsverzeichnisse](#first-read-outside-the-working-directories), die Sie auffordern525 2. Schreibgeschützte Aktionen und Dateieditierungen in Ihrem Arbeitsverzeichnis werden automatisch genehmigt, außer Schreibvorgänge zu [geschützten Pfaden](#protected-paths) und [dem ersten Lesezugriff außerhalb der Arbeitsverzeichnisse](#first-read-outside-the-working-directories), die Sie auffordern

505 * In einer Sitzung mit [serverseitiger Klassifizierer-Überprüfung](#server-side-classifier-review) warten schreibgeschützte und [Sandbox](/docs/de/sandboxing#sandbox-modes)-Shell-Befehle auf diese Überprüfung und werden blockiert, wenn sie diese kennzeichnet526 * In einer Sitzung mit [serverseitiger Klassifizierer-Überprüfung](#server-side-classifier-review) warten schreibgeschützte und [Sandbox](/docs/de/sandboxing#sandbox-modes)-Shell-Befehle auf diese Überprüfung und werden blockiert, wenn sie diese kennzeichnet

506 3. Alles andere geht zum Klassifizierer. Die Connector-Tools und `requiresUserInteraction` MCP-Tools, die Sie direkt in Schritt 1 auffordern, erreichen den Klassifizierer nie, daher wird weder eine von der Organisation erforderliche Genehmigung noch ein Zustimmungsschritt automatisch genehmigt527 * Ein Schreibvorgang in Ihrem Arbeitsverzeichnis, den die [Symlink-Überprüfung](/docs/de/permissions#symlinks) zu einem Ort außerhalb davon auflöst, fordert Sie auf

528 3. Alles andere geht zum Klassifizierer, außer [kritischen Pfad-Löschungen](#critical-paths) unter ihrer Standard-Behandlung. Die Connector-Tools und `requiresUserInteraction` MCP-Tools, die Sie direkt in Schritt 1 auffordern, erreichen den Klassifizierer nie, daher wird weder eine von der Organisation erforderliche Genehmigung noch ein Zustimmungsschritt automatisch genehmigt

507 4. Wenn der Klassifizierer blockiert, erhält Claude den Grund und versucht eine Alternative. In den meisten Sitzungen benennt der Grund die Regel, die der Klassifizierer abgeglichen hat, wie `[Data Exfiltration]`, statt eine schriftliche Erklärung zu geben; siehe [Verweigerungen überprüfen](/docs/de/auto-mode-config#review-denials)529 4. Wenn der Klassifizierer blockiert, erhält Claude den Grund und versucht eine Alternative. In den meisten Sitzungen benennt der Grund die Regel, die der Klassifizierer abgeglichen hat, wie `[Data Exfiltration]`, statt eine schriftliche Erklärung zu geben; siehe [Verweigerungen überprüfen](/docs/de/auto-mode-config#review-denials)

508 530

509 Beim Eintritt in den Auto-Modus werden breite Allow-Regeln, die willkürliche Code-Ausführung gewähren, gelöscht:531 Beim Eintritt in den Auto-Modus werden breite Allow-Regeln, die willkürliche Code-Ausführung gewähren, gelöscht:

568 590

569Der `bypassPermissions`-Modus deaktiviert Berechtigungsaufforderungen und Sicherheitsüberprüfungen, sodass Tool-Aufrufe sofort ausgeführt werden, einschließlich Schreibvorgänge in [geschützte Pfade](#protected-paths).591Der `bypassPermissions`-Modus deaktiviert Berechtigungsaufforderungen und Sicherheitsüberprüfungen, sodass Tool-Aufrufe sofort ausgeführt werden, einschließlich Schreibvorgänge in [geschützte Pfade](#protected-paths).

570 592

571Die [Aktionen, die kein Modus automatisch genehmigt](#actions-no-mode-auto-approves) fordern weiterhin in diesem Modus auf.593Die [Aktionen, die kein Modus automatisch genehmigt](#actions-no-mode-auto-approves) fordern weiterhin in diesem Modus auf. Die [Remove-Item in PowerShell](#remove-item-in-powershell) Verweigerungen gelten auch in diesem Modus.

572 594

573Zwei [Cross-Session-Messaging](/docs/de/cross-session-messaging) Schutzmaßnahmen gelten weiterhin in diesem Modus und in interaktiven Terminal-Plan-Mode-Sitzungen, in denen Bypass-Berechtigungen verfügbar sind:595Zwei [Cross-Session-Messaging](/docs/de/cross-session-messaging) Schutzmaßnahmen gelten weiterhin in diesem Modus und in interaktiven Terminal-Plan-Mode-Sitzungen, in denen Bypass-Berechtigungen verfügbar sind:

574 596

593 615

594Claude Code verweigert `bypassPermissions` in einer Sitzung, die Sie mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten. `--restricted` erfordert Claude Code v2.1.248 oder später.616Claude Code verweigert `bypassPermissions` in einer Sitzung, die Sie mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten. `--restricted` erfordert Claude Code v2.1.248 oder später.

595 617

596Das erste Mal, wenn Sie eine interaktive Sitzung mit diesem Modus aktiviert starten, zeigt Claude Code einen Warnungsdialog, der Sie auffordert, Verantwortung für Aktionen ohne Berechtigungsprüfungen zu übernehmen. Claude Code speichert Ihre Akzeptanz in Benutzereinstellungen, sodass der Dialog nur einmal angezeigt wird. Wenn Sie ablehnen, beendet Claude Code. Im [nicht-interaktiven Modus](/docs/de/headless) wird kein Dialog angezeigt, und eine [Hintergrund-Sitzung](/docs/de/agent-view), die mit `--bg` gestartet wurde, wird verweigert, bis Sie den Dialog in einer interaktiven Sitzung akzeptiert haben.618Das erste Mal, wenn Sie eine interaktive Sitzung mit diesem Modus aktiviert starten, zeigt Claude Code einen Warnungsdialog, der Sie auffordert, Verantwortung für Aktionen ohne Berechtigungsprüfungen zu übernehmen:

619

620* **Wenn Sie akzeptieren**: Claude Code setzt `skipDangerousModePermissionPrompt` auf `true` in `~/.claude/settings.json`, sodass spätere Sitzungen den Dialog überspringen. Um den Dialog erneut zu sehen, entfernen Sie den Schlüssel aus dieser Datei oder setzen Sie ihn auf `false`. Die [`skipDangerousModePermissionPrompt` Referenz](/docs/de/settings-reference#skipdangerousmodepermissionprompt) listet die anderen Einstellungsdateien auf, in denen Sie oder Ihre Organisation ihn setzen können.

621* **Wenn Sie ablehnen**: Claude Code wird beendet.

622

623Im [nicht-interaktiven Modus](/docs/de/headless) wird kein Dialog angezeigt, und eine [Hintergrund-Sitzung](/docs/de/agent-view), die mit `--bg` gestartet wurde, wird verweigert, bis Sie den Dialog in einer interaktiven Sitzung akzeptiert haben.

597 624

598Auf Linux und macOS weigert sich Claude Code, in diesem Modus zu starten, wenn es als Root oder unter `sudo` ausgeführt wird:625Auf Linux und macOS weigert sich Claude Code, in diesem Modus zu starten, wenn es als Root oder unter `sudo` ausgeführt wird:

599 626

603 630

604Die Überprüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container zu laufen, verwenden Sie die [Dev-Container](/docs/de/devcontainer) Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.631Die Überprüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container zu laufen, verwenden Sie die [Dev-Container](/docs/de/devcontainer) Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.

605 632

606[Claude Code im Web](/docs/de/claude-code-on-the-web) berücksichtigt `defaultMode: "bypassPermissions"` oder `"dontAsk"` aus Ihren Einstellungsdateien nicht, daher können die eingecheckten Einstellungen eines Repositorys keine Cloud-Sitzung im Bypass-Permissions-Modus starten. Die Einstellung wird stillschweigend ignoriert und die Sitzung startet im Berechtigungsmodus, der im Modusmenü angezeigt wird. Siehe [Berechtigungsmodi wechseln](#switch-permission-modes), welche Modi Cloud-Sitzungen bieten.633[Cloud-Sitzungen](/docs/de/claude-code-on-the-web) berücksichtigen `defaultMode: "bypassPermissions"` oder `"dontAsk"` aus Ihren Einstellungsdateien nicht, daher können die eingecheckten Einstellungen eines Repositorys keine Cloud-Sitzung im Bypass-Permissions-Modus starten. Die Einstellung wird stillschweigend ignoriert und die Sitzung startet im Berechtigungsmodus, der im Modusmenü angezeigt wird. Siehe [Berechtigungsmodi wechseln](#switch-permission-modes), welche Modi Cloud-Sitzungen bieten.

607 634

608<Warning>635<Warning>

609 `bypassPermissions` bietet keinen Schutz vor Prompt-Injection oder unbeabsichtigten Aktionen. Verwenden Sie stattdessen den [Auto-Modus](#eliminate-prompts-with-auto-mode) für Hintergrund-Sicherheitsüberprüfungen mit deutlich weniger Berechtigungsaufforderungen. Administratoren können diesen Modus blockieren, indem sie `permissions.disableBypassPermissionsMode` auf `"disable"` in [verwalteten Einstellungen](/docs/de/managed-settings) setzen.636 `bypassPermissions` bietet keinen Schutz vor Prompt-Injection oder unbeabsichtigten Aktionen. Verwenden Sie stattdessen den [Auto-Modus](#eliminate-prompts-with-auto-mode) für Hintergrund-Sicherheitsüberprüfungen mit deutlich weniger Berechtigungsaufforderungen. Administratoren können diesen Modus blockieren, indem sie `permissions.disableBypassPermissionsMode` auf `"disable"` in [verwalteten Einstellungen](/docs/de/managed-settings) setzen.

625 652

626In einer Sitzung, die mit [`--restricted`](/docs/de/cli-reference#cli-flags) gestartet wurde, was Claude Code v2.1.248 oder später erfordert, kann der Klassifizierer Schreibvorgänge in geschützten Pfaden nicht genehmigen.653In einer Sitzung, die mit [`--restricted`](/docs/de/cli-reference#cli-flags) gestartet wurde, was Claude Code v2.1.248 oder später erfordert, kann der Klassifizierer Schreibvorgänge in geschützten Pfaden nicht genehmigen.

627 654

628[`permissions.allow`](/docs/de/permissions#manage-permissions) Regeln in Einstellungsdateien genehmigen Schreibvorgänge in geschützten Pfaden nicht im Voraus. Die Sicherheitsprüfung wird ausgeführt, bevor Claude Code die Allow-Regeln aus den Einstellungen auswertet, daher ändert ein Eintrag wie `Edit(.claude/**)` in `~/.claude/settings.json` oder `.claude/settings.json` das Ergebnis pro Modus in der obigen Tabelle nicht. In Modi, die abfragen, bietet die Eingabeaufforderung für einen `.claude/` Schreibvorgang **Ja, und Claude darf seine eigenen Einstellungen für diese Sitzung bearbeiten**, was spätere `.claude/` Schreibvorgänge in dieser Sitzung genehmigt, ohne erneut abzufragen.655In den Modi, die Schreibvorgänge in geschützten Pfaden zum Klassifizierer leiten, fordert ein Schreibvorgang, den die [Symlink-Prüfung](/docs/de/permissions#symlinks) in einen geschützten Pfad auflöst, Sie auf, wenn der Pfad, den Claude angefordert hat, selbst nicht geschützt ist.

656

657[`permissions.allow`](/docs/de/permissions#manage-permissions) Regeln in Einstellungsdateien genehmigen Schreibvorgänge in geschützten Pfaden nicht im Voraus. Die Sicherheitsprüfung wird ausgeführt, bevor Claude Code die Allow-Regeln aus den Einstellungen auswertet, daher ändert ein Eintrag wie `Edit(.claude/**)` in `~/.claude/settings.json` oder `.claude/settings.json` das Ergebnis pro Modus in der obigen Tabelle nicht. In Modi, die abfragen, bietet die Eingabeaufforderung für einen Schreibvorgang in den `.claude/`-Ordner des Projekts oder in `~/.claude/` eine dieser sitzungsbezogenen Optionen an:

658

659* Für den `.claude/`-Ordner des Projekts: **Ja, und Claude darf Dateien in diesem `.claude`-Ordner des Projekts für diese Sitzung bearbeiten**

660* Für `~/.claude/`: **Ja, und Claude darf Dateien in seinem `~/.claude/`-Ordner für diese Sitzung bearbeiten**

629 661

630Geschützte Verzeichnisse:662Geschützte Verzeichnisse:

631 663

656 Kritische Pfade688 Kritische Pfade

657</h2>689</h2>

658 690

691Kritische Pfade sind die Verzeichnisse, die Claude Code vor `rm`- und `rmdir`-Befehlen schützt, wie das Dateisystem-Root, Ihr Home-Verzeichnis und Ihr Arbeitsverzeichnis.

692

659Claude Code lässt niemals zu, dass eine [`permissions.allow`](/docs/de/permissions#manage-permissions)-Regel oder ein [`PreToolUse`-Hook](/docs/de/permissions#extend-permissions-with-hooks), der `"allow"` zurückgibt, einen `rm`- oder `rmdir`-Befehl genehmigt, der auf einen kritischen Pfad abzielt, auch nicht in Modi, die andere Eingabeaufforderungen überspringen. Dieser Schutzschalter schützt vor Modellfehlern. Eine entsprechende Deny-Regel blockiert den Befehl dennoch vollständig.693Claude Code lässt niemals zu, dass eine [`permissions.allow`](/docs/de/permissions#manage-permissions)-Regel oder ein [`PreToolUse`-Hook](/docs/de/permissions#extend-permissions-with-hooks), der `"allow"` zurückgibt, einen `rm`- oder `rmdir`-Befehl genehmigt, der auf einen kritischen Pfad abzielt, auch nicht in Modi, die andere Eingabeaufforderungen überspringen. Dieser Schutzschalter schützt vor Modellfehlern. Eine entsprechende Deny-Regel blockiert den Befehl dennoch vollständig.

660 694

661Was stattdessen geschieht, hängt von Ihrem Berechtigungsmodus ab:695Was stattdessen geschieht, [hängt von Ihrem Berechtigungsmodus ab](#critical-path-removals-in-each-permission-mode). `Remove-Item` und die `cmd`-Entfernungs-Built-ins haben ihre eigenen Überprüfungen, die in [Remove-Item in PowerShell](#remove-item-in-powershell) behandelt werden.

662 696

663| Modus | Was Claude Code mit einer Entfernung kritischer Pfade tut |697<h3 id="which-paths-are-critical">

664| :- | :- |698 Welche Pfade sind kritisch

665| `default`, `acceptEdits` | Fordert Sie auf, dies zu genehmigen |699</h3>

666| `plan` | Fordert Sie auf, dies zu genehmigen. Mit [Auto-Modus verfügbar während der Planung](#analyze-before-you-edit-with-plan-mode) und ohne verfügbare Bypass-Berechtigungen sendet es dies stattdessen an den Klassifizierer |

667| `auto` | Sendet es an den [Klassifizierer](#eliminate-prompts-with-auto-mode) |

668| `dontAsk` | Lehnt es ab |

669| `bypassPermissions` | Fordert Sie auf, dies zu genehmigen |

~~670~~

671Wenn eine explizite [Ask-Regel](/docs/de/permissions#manage-permissions) dem Befehl entspricht, fordert Claude Code Sie auch im `auto`-Modus auf. In Modi, die fragen, kann ein [`PermissionRequest`-Hook](/docs/de/hooks#permissionrequest) die Eingabeaufforderung auf die gleiche Weise beantworten wie jede andere.

672 700

673Claude Code behandelt ein `rm`- oder `rmdir`-Ziel als kritischen Pfad, wenn es eines der folgenden ist:701Claude Code behandelt ein `rm`- oder `rmdir`-Ziel als kritischen Pfad, wenn es eines der folgenden ist:

674 702

679* Ihr Arbeitsverzeichnis und seine übergeordneten Verzeichnisse707* Ihr Arbeitsverzeichnis und seine übergeordneten Verzeichnisse

680* Ihre zusätzlichen Arbeitsverzeichnisse und ihre übergeordneten Verzeichnisse, aber nur wenn die Entfernung ein Glob unter einem von ihnen ist, wie `rm -rf <dir>/*`. `rm -rf <dir>` im Verzeichnis selbst löst diese Überprüfung nicht aus708* Ihre zusätzlichen Arbeitsverzeichnisse und ihre übergeordneten Verzeichnisse, aber nur wenn die Entfernung ein Glob unter einem von ihnen ist, wie `rm -rf <dir>/*`. `rm -rf <dir>` im Verzeichnis selbst löst diese Überprüfung nicht aus

681 709

682Claude Code behandelt auch einen Glob oder einen nachgestellten Schrägstrich direkt unter einer Shell-Variable, wie `rm -rf "$DIR"/*`, als Entfernung eines kritischen Pfads, da der Befehl zu einer Entfernung vom Dateisystem-Root wird, wenn die Variable leer ist.710<h3 id="other-targets-that-count-as-critical-paths">

711 Andere Ziele, die als kritische Pfade zählen

712</h3>

713

714Claude Code behandelt auch die folgenden `rm`- und `rmdir`-Ziele als kritische Pfade. Die letzte Spalte sagt, warum jedes zählt.

683 715

684Die Eingabeaufforderung für diesen Variablenfall benennt den gekennzeichneten `rm` und sagt, wie Sie ihn umschreiben, damit die Überprüfung erfolgreich ist:716| Ziel | Beispiel | Warum es zählt |

717| :- | :- | :- |

718| Ein Glob oder nachgestellter Schrägstrich direkt unter einer Shell-Variable | `rm -rf "$DIR"/*` | Der Befehl wird zu einer Entfernung vom Dateisystem-Root, wenn die Variable leer ist |

719| Die gleiche Form unter einem Positionsparameter wie `$1` oder `$@`, wenn nichts im Befehl ihm einen Wert gibt | `rm -rf "$1"/*` | Der Befehl erweitert sich zu einer Entfernung vom Root |

720| Eine Shell-Variable gefolgt von einem häufigen Namen eines Verzeichnisses der obersten Ebene, wie `mnt`, `tmp`, `usr` oder `Users` | `rm -rf "$TMPDIR/mnt"` | Wenn die Variable leer erweitert wird, entfernt der Befehl `/mnt` |

721| Eine Variable, die derselbe Befehl aus einer Verzeichnis-Druck-Ersetzung zuweist, wie `$(pwd)` oder `$(git rev-parse --show-toplevel)` | `D=$(pwd); rm -rf "$D"` | Der Wert kann Ihr Arbeitsverzeichnis oder Repository-Root benennen |

722| Ein Ziel, das nur die Ausgabe einer Befehlsersetzung ist, wenn der `rm` rekursiv ist | `rm -rf "$(pwd)"` | Claude Code kann das Ziel nicht vor der Ausführung des Befehls überprüfen |

723| Eine nachgestellte Befehlsersetzung nach einem kritischen Pfad | `rm -rf ~/$(cmd)` | Claude Code überprüft den Pfad, der bleiben würde, wenn die Ersetzung leer erweitert wird, hier Ihr Home-Verzeichnis |

724| Ein Ziel, das nur Backslashes ist | `rm -rf "\\"` | Git Bash unter Windows liest einen einzelnen Backslash als Root des aktuellen Laufwerks, daher gilt die Überprüfung auf jeder Plattform |

725

726Um die Überprüfung auf einem Ziel auszuschalten, das nur Befehlsersetzungsausgabe ist, setzen Sie [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/de/env-vars#variables) in der Umgebung, die Claude Code startet.

727

728<h3 id="removals-inside-nested-commands-and-inline-scripts">

729 Entfernungen in verschachtelten Befehlen und Inline-Skripten

730</h3>

731

732Claude Code schaut auch in diese Konstrukte:

733

734* **Verschachtelte Befehle**: eine Subshell mit `(...)`, eine Brace-Gruppe mit `{ ...; }`, Befehlsersetzung mit `$(...)` oder Backticks, oder Prozessersetzung mit `<(...)`. Claude Code findet eine Entfernung eines kritischen Pfads, ob sie sich in der verschachtelten Form befindet, wie in `(rm -rf ~)` oder `echo "$(rm -rf ~)"`, oder anderswo im gleichen Befehl.

735* **Inline-Skripte**: Claude Code überprüft ein Skript, das an eine Shell wie `sh -c` oder `bash -c` übergeben wird, auf die Shell-Variable und Positionsparameter [Ziele](#other-targets-that-count-as-critical-paths).

736 * Wenn das Skript in doppelte Anführungszeichen gesetzt ist, erweitert die aufrufende Shell seine Variablen, bevor die innere Shell das Skript erhält. In `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;` erweitert sich der Befehl zu einer Entfernung vom Dateisystem-Root einmal pro Treffer, und Claude Code behandelt es als Entfernung eines kritischen Pfads.

737 * Ein einfach angeführtes Skript, das `$1` an einen echten Wert bindet, wie `sh -c 'rm -rf "$1"/*' _ {}` es tut, wird nicht gekennzeichnet.

738

739<h3 id="rewrite-a-flagged-command">

740 Einen gekennzeichneten Befehl umschreiben

741</h3>

685 742

686* Für eine Variable wie `$DIR` schützen Sie jede Erweiterung, damit die Shell mit einem Fehler stoppt, wenn die Variable nicht gesetzt oder leer ist, wie in `rm -rf "${DIR:?}"/*`, oder verwenden Sie einen literalen Pfad743Wie man einen Befehl umschreibt, damit er die Überprüfung besteht, hängt davon ab, welche der [anderen Ziele](#other-targets-that-count-as-critical-paths) er verwendet:

687* Für eine Variable, die normalerweise gesetzt ist, wie `$HOME`, verwenden Sie einen literalen Pfad

688 744

689Eine Entfernung, deren Erweiterungen auf diese Weise geschützt sind, ist keine Entfernung eines kritischen Pfads, daher wird sie im `bypassPermissions`-Modus ohne Eingabeaufforderung ausgeführt.745* **Ein Glob oder nachgestellter Schrägstrich unter einer Variable wie `$DIR`**: schützen Sie jede Erweiterung, damit die Shell mit einem Fehler stoppt, wenn die Variable nicht gesetzt oder leer ist, wie in `rm -rf "${DIR:?}"/*`, oder verwenden Sie einen literalen Pfad. Eine Entfernung, deren Erweiterungen auf diese Weise geschützt sind, besteht diese Überprüfung, daher wird sie im `bypassPermissions`-Modus ohne Eingabeaufforderung ausgeführt, es sei denn, eine andere [kritische Pfad](#critical-paths)-Überprüfung kennzeichnet sie.

746* **Ein Glob oder nachgestellter Schrägstrich unter einer Variable, die normalerweise gesetzt ist, wie `$HOME`**: verwenden Sie einen literalen Pfad.

747* **Eine Variable, die aus einer Verzeichnis-Druck-Ersetzung zugewiesen wird**: verwenden Sie einen literalen Pfad. Ein `"${D:?}"`-Schutz löscht diese Überprüfung nicht, da die Variable nicht leer ist.

748* **Ein Ziel, das nur Befehlsersetzungsausgabe ist**: führen Sie die Ersetzung zuerst selbst aus, dann entfernen Sie die literalen Pfade, die sie ausgibt. Die Eingabeaufforderung teilt Claude mit, dasselbe zu tun.

690 749

691Das Verstecken der Entfernung in einer Subshell mit `(...)`, einer Brace-Gruppe mit `{ ...; }`, einer Befehlsersetzung mit `$(...)` oder Backticks oder einer Prozessersetzung mit `<(...)` überspringt die Überprüfung nicht. Claude Code findet eine Entfernung eines kritischen Pfads, ob sie sich in der verschachtelten Form befindet, wie in `(rm -rf ~)` oder `echo "$(rm -rf ~)"`, oder anderswo im gleichen Befehl.750Für einen Glob oder nachgestellten Schrägstrich unter einer Variable benennt die Eingabeaufforderung den gekennzeichneten `rm` und sagt, wie man ihn umschreibt, damit die Überprüfung besteht.

751

752<h3 id="critical-path-removals-in-each-permission-mode">

753 Entfernungen kritischer Pfade in jedem Berechtigungsmodus

754</h3>

755

756Was Claude Code mit einer Entfernung eines kritischen Pfads tut, hängt von Ihrem Berechtigungsmodus ab:

757

758| Modus | Ergebnis |

759| :- | :- |

760| `default`, `acceptEdits` | Fordert Sie auf, dies zu genehmigen |

761| `plan` | Fordert Sie auf, dies zu genehmigen. Wenn [der Klassifizierer Befehle während der Planung überprüft](#analyze-before-you-edit-with-plan-mode) und keine Bypass-Berechtigungen verfügbar sind, behandelt er dies wie im `auto`-Modus |

762| `auto` | Fordert Sie auf, dies im Terminal zu genehmigen, mit einem [Zeitlimit](#time-limits-and-denials-in-auto-and-bypasspermissions-modes). Anderswo lehnt es ab |

763| `dontAsk` | Lehnt es ab |

764| `bypassPermissions` | Fordert Sie auf, dies zu genehmigen, mit einem Zeitlimit im Terminal |

765

766Wenn eine explizite [Ask-Regel](/docs/de/permissions#manage-permissions) dem Befehl entspricht, fordert Claude Code Sie stattdessen auf, auch im `auto`-Modus und ohne Zeitlimit. In Modi, die fragen, kann ein [`PermissionRequest`-Hook](/docs/de/hooks#permissionrequest) die Eingabeaufforderung beantworten.

767

768<h3 id="time-limits-and-denials-in-auto-and-bypasspermissions-modes">

769 Zeitlimits und Ablehnungen in `auto`- und `bypassPermissions`-Modi

770</h3>

771

772In `auto`- und `bypassPermissions`-Modi zeigt die Terminal-Eingabeaufforderung für eine Entfernung eines kritischen Pfads einen Countdown von zwei Minuten:

773

774* Wenn der Countdown abläuft, bevor Sie antworten, lehnt Claude Code den Befehl ab und teilt Claude mit, was stattdessen zu tun ist, damit eine unbeaufsichtigte Sitzung weiterarbeitet.

775* Drücken Sie eine beliebige Taste, während die Eingabeaufforderung offen ist, um den Countdown zu stoppen und die Eingabeaufforderung warten zu lassen, bis Sie antworten.

776* Nachdem drei dieser Eingabeaufforderungen in einer Sitzung unbeantwortet ablaufen, zeigt Claude Code sie nicht mehr an und lehnt weitere Entfernungen kritischer Pfade sofort ab. Das Senden einer neuen Nachricht setzt den Zähler zurück.

777

778Im `auto`-Modus lehnt Claude Code den Befehl sofort ab, wenn es Ihnen keine Terminal-Eingabeaufforderung anzeigen kann, beispielsweise in [nicht-interaktiven Ausführungen](/docs/de/headless) mit `-p`, in [Agent SDK](/docs/de/agent-sdk/permissions)-Sitzungen und im Chat-Panel der VS Code-Erweiterung und der Desktop-App. Die Ablehnung teilt Claude mit, was es löschen wollte, und überlässt die Entfernung Ihnen.

779

780Die Behandlung von `auto` und `bypassPermissions` erfordert Claude Code v2.1.281 oder später. Um dies auszuschalten, setzen Sie [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1`](/docs/de/env-vars#variables) in der Umgebung, die Claude Code startet. Im `auto`-Modus gehen Entfernungen kritischer Pfade dann stattdessen an den Klassifizierer, und im `bypassPermissions`-Modus hat die Eingabeaufforderung kein Zeitlimit.

692 781

693<h3 id="remove-item-in-powershell">782<h3 id="remove-item-in-powershell">

694 Remove-Item in PowerShell783 Remove-Item in PowerShell

695</h3>784</h3>

696 785

697Wenn Sie das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aktivieren, gibt Claude Code `Remove-Item` eine eigene Überprüfung, getrennt von der `rm`-Liste kritischer Pfade. Das Ergebnis hängt vom Ziel ab, und der erste passende Fall gilt:786Wenn Sie das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aktivieren, gibt Claude Code `Remove-Item` und den `cmd`-Built-ins `rd`, `rmdir`, `del` und `erase` ihre eigenen Überprüfungen, getrennt von der `rm`-Liste kritischer Pfade. Für `Remove-Item` hängt das Ergebnis vom Ziel ab, und der erste passende Fall gilt:

698 787

699* **Systempfade**: das Dateisystem-Root und seine Verzeichnisse der obersten Ebene, Laufwerk-Roots und ihre Verzeichnisse der obersten Ebene sowie Ihr Home-Verzeichnis. Claude Code lehnt den Befehl in jedem Modus ab, ohne Sie zu fragen.788* **Systempfade**: das Dateisystem-Root und seine Verzeichnisse der obersten Ebene, Laufwerk-Roots und ihre Verzeichnisse der obersten Ebene sowie Ihr Home-Verzeichnis. Claude Code lehnt den Befehl in jedem Modus ab, ohne Sie zu fragen.

700* **Platzhalter**: ein bloßes `*` oder ein beliebiges Ziel, das auf `/*` oder `\*` endet, einschließlich eines Globs unter einer Shell-Variable wie `$dir/*`. Claude Code lehnt den Befehl in jedem Modus ab, ohne Sie zu fragen, bevor der [Klassifizierer](#eliminate-prompts-with-auto-mode) ihn sieht.789* **Platzhalter**: ein bloßes `*` oder ein beliebiges Ziel, das auf `/*` oder `\*` endet, einschließlich eines Globs unter einer Shell-Variable wie `$dir/*`. Claude Code lehnt den Befehl in jedem Modus ab, ohne Sie zu fragen, bevor der [Klassifizierer](#eliminate-prompts-with-auto-mode) ihn sieht.

701* **Ihr Arbeitsverzeichnis oder eines seiner übergeordneten Verzeichnisse mit `-Recurse`**: Claude Code behandelt den Befehl wie jeden anderen, der in Ihrem Berechtigungsmodus genehmigt werden muss, daher fordert es Sie in Modi auf, die fragen, sendet es in `auto`-Modus an den Klassifizierer und lehnt es im `dontAsk`-Modus ab. Der `bypassPermissions`-Modus überspringt diese Überprüfung.790* **Ihr Arbeitsverzeichnis oder eines seiner übergeordneten Verzeichnisse mit `-Recurse`**: Claude Code behandelt den Befehl wie jeden anderen, der in Ihrem Berechtigungsmodus genehmigt werden muss, daher fordert es Sie in Modi auf, die fragen, sendet es in `auto`-Modus an den Klassifizierer und lehnt es im `dontAsk`-Modus ab. Der `bypassPermissions`-Modus überspringt diese Überprüfung.

702 791

792Der Fall der Systempfade gilt auch für `rd`, `rmdir`, `del` und `erase`, wenn Claude sie über `cmd` ausführt, wie in `cmd /c rd /s /q C:\Users`. Standardmäßig lehnt Claude Code einen solchen Befehl in jedem Modus ab, ohne Sie zu fragen. Diese `cmd`-Überprüfung erfordert Claude Code v2.1.283 oder später.

793

794Bei der Beurteilung eines `cmd`-Ziels behandelt Claude Code eine PowerShell-Variable, die auf literalen Text folgt, als leer. Das macht `cmd /c rd /s /q "C:\$name"` zu einer Entfernung von `C:\`, daher wird sie auch abgelehnt. Ein nachgestellter Platzhalter zählt als der Ordner, den er leert, daher wird `cmd /c del /q C:\*` abgelehnt und `cmd /c del /q dist\*` in Ihrem Projekt nicht.

795

796Um die `cmd`-Überprüfung auszuschalten, setzen Sie [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY=1`](/docs/de/env-vars#variables) in der Umgebung, die Claude Code startet. Claude Code ignoriert diese Variable in einem `env`-Block einer Einstellungsdatei. `Remove-Item` auf einem Systempfad bleibt in jedem Fall abgelehnt.

797

703<h2 id="see-also">798<h2 id="see-also">

704 Siehe auch799 Siehe auch

705</h2>800</h2>

permissions.md +37 −6

Details

457* Claude Code liest ein `!`-Muster relativ zum aktuellen Verzeichnis, auch wenn `/`, `~/` oder `//` dem `!` folgt, daher kann das Muster eine Regel, die mit einem dieser Präfixe verankert ist, nicht erreichen. `Read(!~/notes/public/**)` schneidet nichts aus `Read(~/notes/**)` aus.457* Claude Code liest ein `!`-Muster relativ zum aktuellen Verzeichnis, auch wenn `/`, `~/` oder `//` dem `!` folgt, daher kann das Muster eine Regel, die mit einem dieser Präfixe verankert ist, nicht erreichen. `Read(!~/notes/public/**)` schneidet nichts aus `Read(~/notes/**)` aus.

458* Ein Ausschnitt kann eine Datei innerhalb eines Verzeichnisses, das eine Regel als Ganzes blockiert, nicht wieder öffnen. Mit `Read(secrets/**)` und `Read(!secrets/public/**)` blockiert Claude Code immer noch `secrets/public` zusammen mit dem Rest von `secrets`.458* Ein Ausschnitt kann eine Datei innerhalb eines Verzeichnisses, das eine Regel als Ganzes blockiert, nicht wieder öffnen. Mit `Read(secrets/**)` und `Read(!secrets/public/**)` blockiert Claude Code immer noch `secrets/public` zusammen mit dem Rest von `secrets`.

459 459

460Wenn Claude auf einen Symlink zugreift, überprüfen Berechtigungsregeln zwei Pfade: den Symlink selbst und die Datei, auf die er verweist. Allow- und Deny-Regeln behandeln dieses Paar unterschiedlich: Allow-Regeln fallen auf Aufforderungen zurück, während Deny-Regeln direkt blockieren.460<h4 id="symlinks">

461 Symlinks

462</h4>

463

464Wenn ein Dateipfad, den Claude anfordert, durch einen Symlink führt, deckt die Berechtigungsprüfung zwei Pfade ab: den, den Claude anforderte, und die Datei, auf die er verweist. Dies gilt für symbolische Links auf macOS, Linux und Windows sowie für Verzeichnis-Junctions auf Windows.

465

466<h5 id="how-rules-match-a-symlinked-path">

467 Wie Regeln einen symverlinkten Pfad abgleichen

468</h5>

461 469

462* **Allow-Regeln**: gelten nur, wenn sowohl der Symlink-Pfad als auch sein Ziel übereinstimmen. Ein Symlink in einem zulässigen Verzeichnis, der außerhalb davon verweist, fordert Sie immer noch auf.470Allow- und Deny-Regeln behandeln den angeforderten Pfad und die Datei, auf die er verweist, unterschiedlich:

463* **Deny-Regeln**: gelten, wenn entweder der Symlink-Pfad oder sein Ziel übereinstimmt. Ein Symlink, der auf eine verweigerte Datei verweist, ist selbst verweigert. Zum Beispiel mit `Read(./project/**)` zulässig und `Read(~/.ssh/**)` verweigert, wird ein Symlink bei `./project/key`, der auf `~/.ssh/id_rsa` verweist, blockiert: Das Ziel schlägt die Allow-Regel fehl und passt zur Deny-Regel.471

472* **Allow-Regeln**: gelten nur, wenn sowohl der angeforderte Pfad als auch die Datei, auf die er verweist, übereinstimmen. Ein Lesevorgang durch einen Symlink innerhalb eines zulässigen Verzeichnisses, der außerhalb davon verweist, gleicht die Regel nicht ab.

473* **Deny-Regeln**: gelten, wenn entweder der angeforderte Pfad oder die Datei, auf die er verweist, übereinstimmt. Ein Symlink, der auf eine verweigerte Datei verweist, ist selbst verweigert. Zum Beispiel mit `Read(./project/**)` zulässig und `Read(~/.ssh/**)` verweigert, wird ein Symlink bei `./project/key`, der auf `~/.ssh/id_rsa` verweist, blockiert: Das Ziel schlägt die Allow-Regel fehl und passt zur Deny-Regel.

464 474

465Auf macOS und Linux gilt eine Deny- oder Ask-Regel, die durch ein symverlinktes Verzeichnis mit einem `//`, `~/` oder `/` Muster geschrieben wurde, auch am echten Ort des Verzeichnisses. Zum Beispiel auf macOS, wo `/etc` zu `/private/etc` aufgelöst wird, blockiert `Read(//etc/**)` auch `/private/etc/hosts`. Vor v2.1.268 galt eine Deny- oder Ask-Regel, die durch ein symverlinktes Verzeichnis geschrieben wurde, nicht für einen Pfad, der durch seinen echten Ort gegeben wurde.475Auf macOS und Linux gilt eine Deny- oder Ask-Regel, die durch ein symverlinktes Verzeichnis mit einem `//`, `~/` oder `/` Muster geschrieben wurde, auch am echten Ort des Verzeichnisses. Zum Beispiel auf macOS, wo `/etc` zu `/private/etc` aufgelöst wird, blockiert `Read(//etc/**)` auch `/private/etc/hosts`. Vor v2.1.268 galt eine Deny- oder Ask-Regel, die durch ein symverlinktes Verzeichnis geschrieben wurde, nicht für einen Pfad, der durch seinen echten Ort gegeben wurde.

466 476

467Wenn ein Werkzeug eine genehmigte Datei öffnet, [bestätigt Claude Code, dass der Pfad immer noch zum Ort aufgelöst wird, den die Berechtigungsprüfung genehmigt hat](/docs/de/errors#refusing-after-a-symlink-changed).477Grep und Glob suchen das Verzeichnis, auf das das `path`-Argument aufgelöst wird. Claude Code wendet `Read` Deny-Regeln auf dieses Verzeichnis an.

478

479<h5 id="writes-through-a-symlink">

480 Schreibvorgänge durch einen Symlink

481</h5>

482

483Wenn der Pfad, den Claude zum Bearbeiten oder Schreiben anfordert, selbst ein Symlink ist, [weigern sich die Edit- und Write-Werkzeuge, den Schreibvorgang durchzuführen, und leiten Claude zum Link-Ziel](/docs/de/errors#refusing-after-a-symlink-changed).

468 484

469Grep und Glob durchsuchen das Verzeichnis, zu dem das `path`-Argument aufgelöst wird. Claude Code wendet `Read` Deny-Regeln auf dieses Verzeichnis an.485Ein Schreibvorgang kann immer noch durch einen Symlink führen, wenn ein Verzeichnis auf dem Weg zur Datei ein Symlink ist, oder wenn ein Bash- oder PowerShell-Befehl den Schreibvorgang durchführt. Für diese Schreibvorgänge hängt das Ergebnis davon ab, wo die Datei, auf die der Schreibvorgang verweist, relativ zu Ihren [Arbeitsverzeichnissen](#working-directories) und den [geschützten Pfaden](/docs/de/permission-modes#protected-paths) sitzt:

486

487* **Verweist außerhalb der Arbeitsverzeichnisse**: Wenn der angeforderte Pfad innerhalb Ihrer Arbeitsverzeichnisse liegt und die Datei, auf die er verweist, nicht, wird der Schreibvorgang nicht automatisch genehmigt im [`acceptEdits`-Modus](/docs/de/permission-modes#auto-approve-file-edits-with-acceptedits-mode). Im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) werden Sie aufgefordert, es sei denn, eine Allow-Regel genehmigt den Schreibvorgang, anstatt dass der Klassifizierer entscheidet. Die Aufforderung benennt den Pfad, auf den der Schreibvorgang verweist.

488* **Verweist auf einen geschützten Pfad, den der angeforderte Pfad nicht benennt**: Die [Tabelle geschützter Pfade](/docs/de/permission-modes#protected-paths) gibt das Ergebnis für jeden Berechtigungsmodus an, außer dass, wo die Tabelle den Schreibvorgang zum Klassifizierer leitet, dieser Schreibvorgang Sie stattdessen auffordert.

489

490<h5 id="paths-that-can’t-be-resolved-or-that-change">

491 Pfade, die nicht aufgelöst werden können oder die sich ändern

492</h5>

493

494Wenn Claude Code nicht bestimmen kann, wohin ein Pfad auf der Festplatte führt, zum Beispiel weil Symlinks darauf eine Schleife bilden, [weigern sich die Read-, Edit- und Write-Werkzeuge, den Vorgang durchzuführen](/docs/de/errors#refusing-after-a-symlink-changed).

495

496Wenn ein Werkzeug dann die genehmigte Datei öffnet, [bestätigt Claude Code, dass der Pfad immer noch zum Ort aufgelöst wird, den die Berechtigungsprüfung genehmigt hat](/docs/de/errors#refusing-after-a-symlink-changed).

470 497

471<h3 id="webfetch">498<h3 id="webfetch">

472 WebFetch499 WebFetch

509}536}

510```537```

511 538

512Wenn Sie Claude bitten, eine Seite abzurufen, ruft es ab, ohne Sie aufzufordern. Wenn Sie es bitten, einen [sandboxed](/docs/de/sandboxing) `curl` gegen einen Host außerhalb der Sandbox-Allowlist auszuführen, fordert Claude Code Sie immer noch für diesen Host auf, da die bare Regel den Host nicht zur Allowlist hinzugefügt hat. Im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) benennt Claude stattdessen den Host in den [pro-Befehl zulässigen Domänen](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode) des Befehls für den Klassifizierer zur Überprüfung.539Wenn Sie Claude bitten, eine Seite abzurufen, ruft es ab, ohne Sie aufzufordern. Wenn Sie es bitten, einen [sandboxed](/docs/de/sandboxing) `curl` gegen einen Host außerhalb der Sandbox-Allowlist auszuführen, fordert Claude Code Sie immer noch für diesen Host auf, da die bare Regel den Host nicht zur Allowlist hinzugefügt hat.

540

541Im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) benennt Claude stattdessen den Host in den [pro-Befehl zulässigen Domänen](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode) des Befehls für den Klassifizierer zur Überprüfung.

513 542

514<h3 id="mcp">543<h3 id="mcp">

515 MCP544 MCP

703 732

704Claude Code zeigt den Vertrauensdialog nur in interaktiven Sitzungen an. Ein `claude -p`-Lauf oder eine SDK-Sitzung zeigt ihn nie an, und das Vertrauen in ein übergeordnetes Verzeichnis zählt nicht für diese Regeln, daher sagt [Was läuft ab, bevor Sie einem Ordner vertrauen](#what-runs-before-you-trust-a-folder), welche Repository-Inhalte Claude Code in jeder dieser beiden Situationen noch verwendet.733Claude Code zeigt den Vertrauensdialog nur in interaktiven Sitzungen an. Ein `claude -p`-Lauf oder eine SDK-Sitzung zeigt ihn nie an, und das Vertrauen in ein übergeordnetes Verzeichnis zählt nicht für diese Regeln, daher sagt [Was läuft ab, bevor Sie einem Ordner vertrauen](#what-runs-before-you-trust-a-folder), welche Repository-Inhalte Claude Code in jeder dieser beiden Situationen noch verwendet.

705 734

735Bevor Claude Code eine [Hintergrund-Sitzung](/docs/de/agent-view) startet oder neu startet, prüft Claude Code auch das Workspace-Vertrauen für das Verzeichnis, in dem die Sitzung läuft. Wenn Sie `claude --bg` von einem Terminal in einem Verzeichnis ausführen, dem Sie nicht vertraut haben, wird der Vertrauensdialog zuerst angezeigt und die Sitzung startet, sobald Sie ihn akzeptieren. Wo kein Dialog angezeigt werden kann, z. B. in einem Skript, beendet sich der Befehl stattdessen mit einem [`Workspace not trusted`](/docs/de/errors#workspace-not-trusted-when-dispatching-a-background-session)-Fehler.

736

706<h3 id="when-your-local-settings-file-needs-trust">737<h3 id="when-your-local-settings-file-needs-trust">

707 Wenn Ihre lokale Einstellungsdatei Vertrauen benötigt738 Wenn Ihre lokale Einstellungsdatei Vertrauen benötigt

708</h3>739</h3>

platforms.md +1 −1

Details

54| :- | :- | :- | :- | :- |54| :- | :- | :- | :- | :- |

55| [Dispatch](/docs/de/desktop#sessions-from-dispatch) | Senden Sie eine Aufgabe aus der Claude Mobile-App | Ihr Computer (Desktop) | [Koppeln Sie die Mobile-App mit Desktop](https://support.claude.com/en/articles/13947068) | Delegieren von Arbeit, wenn Sie weg sind, minimales Setup |55| [Dispatch](/docs/de/desktop#sessions-from-dispatch) | Senden Sie eine Aufgabe aus der Claude Mobile-App | Ihr Computer (Desktop) | [Koppeln Sie die Mobile-App mit Desktop](https://support.claude.com/en/articles/13947068) | Delegieren von Arbeit, wenn Sie weg sind, minimales Setup |

56| [Remote Control](/docs/de/remote-control) | Steuern Sie eine laufende Sitzung von [claude.ai/code](https://claude.ai/code) oder der Claude Mobile-App | Ihr Computer (CLI oder VS Code) | Führen Sie `claude remote-control` aus | Steuerung laufender Arbeiten von einem anderen Gerät |56| [Remote Control](/docs/de/remote-control) | Steuern Sie eine laufende Sitzung von [claude.ai/code](https://claude.ai/code) oder der Claude Mobile-App | Ihr Computer (CLI, Desktop oder VS Code) | Führen Sie [`claude remote-control` oder `/remote-control`](/docs/de/remote-control#start-a-remote-control-session) aus | Steuerung laufender Arbeiten von einem anderen Gerät |

57| [Channels](/docs/de/channels) | Pushen Sie Ereignisse aus einer Chat-App wie Telegram oder Discord oder Ihrem eigenen Server | Ihr Computer (CLI) | [Installieren Sie ein Channel-Plugin](/docs/de/channels#quickstart) oder [erstellen Sie Ihr eigenes](/docs/de/channels-reference) | Reagieren auf externe Ereignisse wie CI-Fehler oder Chat-Nachrichten |57| [Channels](/docs/de/channels) | Pushen Sie Ereignisse aus einer Chat-App wie Telegram oder Discord oder Ihrem eigenen Server | Ihr Computer (CLI) | [Installieren Sie ein Channel-Plugin](/docs/de/channels#quickstart) oder [erstellen Sie Ihr eigenes](/docs/de/channels-reference) | Reagieren auf externe Ereignisse wie CI-Fehler oder Chat-Nachrichten |

58| [Slack](/docs/de/slack) | Erwähnen Sie `@Claude` in einem Team-Kanal | Anthropic Cloud | [Installieren Sie die Slack-App](/docs/de/slack#setting-up-claude-code-in-slack) mit [Claude Code im Web](/docs/de/claude-code-on-the-web) aktiviert | PRs und Reviews aus Team-Chat |58| [Slack](/docs/de/slack) | Erwähnen Sie `@Claude` in einem Team-Kanal | Anthropic Cloud | [Installieren Sie die Slack-App](/docs/de/slack#setting-up-claude-code-in-slack) mit [Claude Code im Web](/docs/de/claude-code-on-the-web) aktiviert | PRs und Reviews aus Team-Chat |

59| [Self-hosted environments](/docs/de/self-hosted-environments) | Starten Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) und wählen Sie die Umgebung Ihrer Organisation | Infrastruktur Ihrer Organisation | [Stellen Sie Runner bereit](/docs/de/self-hosted-environments-quickstart), in Team- und Enterprise-Plänen | Cloud-Sitzungen, die in Ihrem Netzwerk ausgeführt werden müssen |59| [Self-hosted environments](/docs/de/self-hosted-environments) | Starten Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) und wählen Sie die Umgebung Ihrer Organisation | Infrastruktur Ihrer Organisation | [Stellen Sie Runner bereit](/docs/de/self-hosted-environments-quickstart), in Team- und Enterprise-Plänen | Cloud-Sitzungen, die in Ihrem Netzwerk ausgeführt werden müssen |

plugin-evals.md +18 −3

Details

16* Regressionen erkennen, wenn Sie das Plugin ändern oder ein neues Modell ausgeliefert wird16* Regressionen erkennen, wenn Sie das Plugin ändern oder ein neues Modell ausgeliefert wird

17* Sehen, was das Plugin im Vergleich zu keinem Plugin beiträgt17* Sehen, was das Plugin im Vergleich zu keinem Plugin beiträgt

18 18

19Diese Seite ist für Plugin- und Skill-Autoren, die ein funktionierendes Plugin haben und sein Verhalten testen möchten, sowie für Teams, die Plugin-Änderungen in CI gaten. Das Fallformat unterscheidet sich von der Datei `evals/evals.json`, die das [skill-creator Plugin](/docs/de/skills#run-evals-with-skill-creator) verwendet. Um ein Plugin zu erstellen, siehe [Plugin erstellen](/docs/de/plugins/create); um die Dateien eines Plugins auf Syntax- und Schemafehler zu überprüfen, anstatt sein Verhalten zu überprüfen, verwenden Sie [`claude plugin validate`](/docs/de/plugins/cli-reference#plugin-validate).19Diese Seite ist für Plugin- und Skill-Autoren, die ein funktionierendes Plugin haben und sein Verhalten testen möchten, sowie für Teams, die Plugin-Änderungen in CI gaten. Für die Iteration an einem einzelnen Skill innerhalb einer Claude Code Konversation führt das [skill-creator Plugin](/docs/de/skills#run-evals-with-skill-creator) einen ähnlichen Vergleich mit seinem eigenen `evals/evals.json`-Format durch, und keines der beiden Tools liest die Fallsdateien des anderen. Um ein Plugin zu erstellen, siehe [Plugin erstellen](/docs/de/plugins/create); um die Dateien eines Plugins auf Syntax- und Schemafehler zu überprüfen, anstatt sein Verhalten zu überprüfen, verwenden Sie [`claude plugin validate`](/docs/de/plugins/cli-reference#plugin-validate).

20 20

21<Note>21<Note>

22 Jeder Eval-Durchlauf und jeder Judge-Grader ist ein echter Modellaufruf auf Ihrem Konto, der gegen die Nutzung Ihres Plans oder Ihre API-Rechnung angerechnet wird. Überprüfen Sie daher zunächst die [Anforderungen](#requirements). Erstellen Sie dann Ihre [erste Eval-Suite](#create-your-first-eval-suite), oder gehen Sie zu [Evals in CI ausführen](#run-evals-in-ci), wenn Sie bereits eine haben.22 Jeder Eval-Durchlauf und jeder Judge-Grader ist ein echter Modellaufruf auf Ihrem Konto, der gegen die Nutzung Ihres Plans oder Ihre API-Rechnung angerechnet wird. Überprüfen Sie daher zunächst die [Anforderungen](#requirements). Erstellen Sie dann Ihre [erste Eval-Suite](#create-your-first-eval-suite), oder gehen Sie zu [Evals in CI ausführen](#run-evals-in-ci), wenn Sie bereits eine haben.

29Um Plugin-Evals auszuführen, benötigen Sie:29Um Plugin-Evals auszuführen, benötigen Sie:

30 30

31* Claude Code v2.1.269 oder später. Führen Sie `claude --version` aus, um zu überprüfen, und `claude update`, um zu aktualisieren.31* Claude Code v2.1.269 oder später. Führen Sie `claude --version` aus, um zu überprüfen, und `claude update`, um zu aktualisieren.

32* Git 2.31 oder später, falls Git installiert ist. Führen Sie `git --version` aus, um zu überprüfen. Mit einer älteren Git-Version [stoppt `claude plugin eval` vor dem Ausführen eines Falls](#git-is-too-old-for-claude-plugin-eval). Ohne Git wird es normal ausgeführt.

32* Ein Plugin-Verzeichnis mit einem `plugin.json` oder `.claude-plugin/plugin.json` Manifest, oder ein [Skills-Directory-Plugin](/docs/de/plugins/loading#plugins-shared-through-a-repository).33* Ein Plugin-Verzeichnis mit einem `plugin.json` oder `.claude-plugin/plugin.json` Manifest, oder ein [Skills-Directory-Plugin](/docs/de/plugins/loading#plugins-shared-through-a-repository).

33* Die gleiche Authentifizierung und den gleichen Modell-Provider, den Ihre normalen Claude Code Sitzungen verwenden. Eval-Durchläufe, Judge-bewertete Grader und `claude plugin eval init` rufen das Modell mit Ihren Anmeldedaten auf, daher werden sie gegen Ihre Plan-Nutzungslimits oder Ihre API-Rechnung angerechnet. Wenn der Befehl Kosten meldet, ist die Zahl eine [Listenpreis-Schätzung](/docs/de/costs) dieser Aufrufe.34* Die gleiche Authentifizierung und den gleichen Modell-Provider, den Ihre normalen Claude Code Sitzungen verwenden. Eval-Durchläufe, Judge-bewertete Grader und `claude plugin eval init` rufen das Modell mit Ihren Anmeldedaten auf, daher werden sie gegen Ihre Plan-Nutzungslimits oder Ihre API-Rechnung angerechnet. Wenn der Befehl Kosten meldet, ist die Zahl eine [Listenpreis-Schätzung](/docs/de/costs) dieser Aufrufe.

34 35

436| 130 | Unterbrochen. Teilergebnisse werden geschrieben |437| 130 | Unterbrochen. Teilergebnisse werden geschrieben |

437| 143 | Beendet, wie durch ein CI-Timeout |438| 143 | Beendet, wie durch ein CI-Timeout |

438 439

439Probleme beim Schreiben oder Veröffentlichen des HTML-Berichts ändern niemals den Exit-Code.440Das With-Minus-Without-Delta wird gemeldet, ändert aber niemals den Exit-Code, und auch Probleme beim Schreiben oder Veröffentlichen des HTML-Berichts tun dies nicht.

440 441

441Um zu sehen, warum ein Fall niedrig bewertet wurde, führen Sie ihn lokal ohne `--json` aus, damit die Pro-Durchlauf-Fortschritts- und Grader-Zeilen drucken.442Um zu sehen, warum ein Fall niedrig bewertet wurde, führen Sie ihn lokal ohne `--json` aus, damit die Pro-Durchlauf-Fortschritts- und Grader-Zeilen drucken.

442 443

443Ein CI-Runner benötigt auch diese:444Ein CI-Runner benötigt auch diese:

444 445

445* **Installation und Anmeldedaten**: Ein CI-Runner benötigt eine Claude Code Installation und [Anmeldedaten in der Umgebung](/docs/de/authentication) wie `ANTHROPIC_API_KEY`.446* **Installation und Anmeldedaten**: Ein CI-Runner benötigt eine Claude Code Installation und [Anmeldedaten in der Umgebung](/docs/de/authentication) wie `ANTHROPIC_API_KEY`.

446* **Vertrauen**: Ohne `--trust-plugin` wird ein Job, dessen Checkout-Verzeichnis Claude Code noch nicht vertraut, die [erste Vertrauens-Eingabeaufforderung](#security) benötigen, und ein Durchlauf, der nicht fragen kann, wird mit Exit 1 verweigert.447* **Vertrauen**: Ohne `--trust-plugin` wird ein Job, dessen Checkout-Verzeichnis Claude Code noch nicht vertraut, die [erste Vertrauens-Eingabeaufforderung](#trust-the-plugin-directory) benötigen, und ein Durchlauf, der nicht fragen kann, wird mit Exit 1 verweigert.

447* **`init` in CI**: `claude plugin eval init` benötigt ein Terminal, um Ihnen seine Fragen zu stellen; führen Sie in CI `claude plugin eval init --bare <name>` aus, um die leere Vorlage zu erhalten.448* **`init` in CI**: `claude plugin eval init` benötigt ein Terminal, um Ihnen seine Fragen zu stellen; führen Sie in CI `claude plugin eval init --bare <name>` aus, um die leere Vorlage zu erhalten.

448 449

449Um Kosten vorhersehbar zu halten, geben Sie schnelle Every-Change-Suites nur Grader, die keinen Judge aufrufen, verwenden Sie `--ablation none`, wo Sie `Δ` nicht benötigen, und lassen Sie `partial: true` Dokumente und Durchläufe mit `skippedPaidGraders` aus jedem Trend, den Sie kartieren.450Um Kosten vorhersehbar zu halten, geben Sie schnelle Every-Change-Suites nur Grader, die keinen Judge aufrufen, verwenden Sie `--ablation none`, wo Sie `Δ` nicht benötigen, und lassen Sie `partial: true` Dokumente und Durchläufe mit `skippedPaidGraders` aus jedem Trend, den Sie kartieren.

682 683

683Dies ist der erste Durchlauf gegen ein Verzeichnis, dem Claude Code noch nicht vertraut, und es kann Sie nicht fragen, da stdin oder stdout kein Terminal ist, Sie `--json` übergeben haben oder die Umgebungsvariable `CI` auf einen wahren Wert wie `true` gesetzt ist. Führen Sie `claude plugin eval <dir>` einmal in einem Terminal aus und beantworten Sie die Eingabeaufforderung, oder übergeben Sie `--trust-plugin`, wenn Sie dem Code und der Suite des Plugins vertrauen. Siehe [What a run can access](#security).684Dies ist der erste Durchlauf gegen ein Verzeichnis, dem Claude Code noch nicht vertraut, und es kann Sie nicht fragen, da stdin oder stdout kein Terminal ist, Sie `--json` übergeben haben oder die Umgebungsvariable `CI` auf einen wahren Wert wie `true` gesetzt ist. Führen Sie `claude plugin eval <dir>` einmal in einem Terminal aus und beantworten Sie die Eingabeaufforderung, oder übergeben Sie `--trust-plugin`, wenn Sie dem Code und der Suite des Plugins vertrauen. Siehe [What a run can access](#security).

684 685

686<h3 id="git-is-too-old-for-claude-plugin-eval">

687 „is too old for claude plugin eval"

688</h3>

689

690Das `git` auf Ihrem `PATH` ist älter als 2.31, daher hat `claude plugin eval` gestoppt, bevor es einen Fall ausgeführt hat, und ist mit 1 beendet worden mit einer Nachricht, die Ihre Version benennt:

691

692```text theme={null}

693git 2.30 is too old for claude plugin eval: it ignores the environment configuration (GIT_CONFIG_COUNT, added in git 2.31) that switches off the repository's git hooks and helper programs for the run. Install git 2.31 or newer.

694```

695

696Für jeden Durchlauf schaltet Claude Code Git-Hooks, Credential-Helper und andere Programme aus, die eine Git-Konfiguration eines Repositorys starten kann. Dies geschieht durch Umgebungskonfiguration, die Git nur ab Version 2.31 liest. Ein älteres Git ignoriert diese Konfiguration, daher stoppt die Suite, anstatt Durchläufe zu bewerten, bei denen diese Programme ausgeführt werden könnten. Installieren Sie Git 2.31 oder später und führen Sie die Suite erneut aus.

697

698Vor v2.1.283 überprüfte `claude plugin eval` nicht die Git-Version, und bei einem älteren Git lief die Suite mit diesen Programmen, die eingeschaltet waren.

699

685<h3 id="no-eval-cases-found">700<h3 id="no-eval-cases-found">

686 „No eval cases found"701 „No eval cases found"

687</h3>702</h3>

plugins/anthropic-marketplaces.md +105 −0 created

Details

1> ## Documentation Index

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

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

5# Anthropics Marktplätze

7> Anthropics offizielle, Community- und Demo-Plugin-Marktplätze für Claude Code: ihre Namen, Repositories, wie Sie jeden hinzufügen, und wo Sie ihre Plugins durchsuchen können.

9Anthropic veröffentlicht drei allgemeine Plugin-Marktplätze für Claude Code: [offiziell](https://github.com/anthropics/claude-plugins-official), [Community](https://github.com/anthropics/claude-plugins-community) und [Demo](https://github.com/anthropics/claude-code). Jeder ist ein Katalog von Plugins in seinem eigenen GitHub-Repository. Wenn Sie ein Plugin aus einem dieser Marktplätze in einer Claude Code-Sitzung installieren, geben Sie den Namen des Marktplatzes nach `@` ein, wie in `/plugin install commit-commands@claude-plugins-official`.

11Verwenden Sie diese Seite, um die drei Marktplätze zu unterscheiden und um zu überprüfen, ob der offizielle Marktplatz ein bestimmtes Plugin enthält.

13<Note>

14 Diese Fälle werden auf anderen Seiten behandelt:

16 * **Wie man ein Plugin installiert**: siehe [Plugins installieren](/docs/de/plugins/install)

17 * **Eine fehlgeschlagene Installation**: siehe [Plugins fehlerbeheben](/docs/de/plugins/troubleshooting)

18</Note>

20Gehen Sie zu dem Teil der Seite, den Sie benötigen:

22* Um die drei Marktplätze nach Repository, Marktplatzname und wie Sie jeden erhalten zu unterscheiden, siehe [Anthropics Marktplätze](#anthropic%E2%80%99s-marketplaces).

23* Um ein Plugin im offiziellen Marktplatz zu finden, siehe [Plugins im offiziellen Marktplatz finden](#find-plugins-in-the-official-marketplace).

25<h2 id="anthropic’s-marketplaces">

26 Anthropics Marktplätze

27</h2>

29Ein Marktplatz ist ein Katalog von Plugins, den ein Repository in seiner `.claude-plugin/marketplace.json`-Datei definiert. Die offiziellen, Community- und Demo-Marktplätze stammen jeweils aus ihrem eigenen GitHub-Repository. Anthropic veröffentlicht auch themenspezifische Marktplätze, wie `anthropics/skills` und `anthropics/knowledge-work-plugins`, die Sie in einer Claude Code-Sitzung mit `/plugin marketplace add <owner>/<repo>` hinzufügen.

31Diese Tabelle zeigt das Repository und den Marktplatznamen jedes Marktplatzes, den Sie nach `@` eingeben, wenn Sie ein Plugin aus diesem Marktplatz installieren. Der Name des Community-Marktplatzes ist `claude-community`, nicht sein Repository-Name.

34| :- | :- | :- | :- |

35| Repository | [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official) | [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) | [`anthropics/claude-code`](https://github.com/anthropics/claude-code/tree/main/plugins) |

37| Was ist darin | Plugins, die Anthropic verwaltet, plus Plugins von Partnern und anderen Autoren | Plugins von Drittanbietern, die ihre Autoren bei Anthropic eingereicht haben | Ein kleiner Satz von Beispiel-Plugins, die zeigen, was ein Plugin enthalten kann |

38| Wie Sie es erhalten | Claude Code fügt es beim ersten Start einer interaktiven Terminal-Sitzung hinzu, es sei denn, eine [verwaltete Richtlinie](/docs/de/plugins/org#allow-the-official-marketplace-and-your-own) oder `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` blockiert es. Siehe [Marktplatz `claude-plugins-official` nicht gefunden](/docs/de/plugins/troubleshooting#marketplace-claude-plugins-official-not-found), wenn er fehlt | Sie fügen ihn in einer Claude Code-Sitzung mit `/plugin marketplace add anthropics/claude-plugins-community` hinzu | Sie fügen ihn in einer Claude Code-Sitzung mit `/plugin marketplace add anthropics/claude-code` hinzu |

40Wenn Sie ein Plugin geschrieben haben und möchten, dass andere Personen es installieren, siehe [Ein Plugin veröffentlichen](/docs/de/plugins/publish), das Ihren eigenen Marktplatz und die Einreichung bei Anthropics Verzeichnis behandelt.

42<h3 id="the-demo-marketplace-in-anthropics/claude-code">

43 Der Demo-Marktplatz in `anthropics/claude-code`

44</h3>

46Wenn ein Tutorial oder ein älterer Satz von Anweisungen Ihnen sagt, `/plugin marketplace add anthropics/claude-code` auszuführen, wird der Demo-Marktplatz mit dem Namen `claude-code-plugins` hinzugefügt. Dies ist nicht der offizielle Marktplatz, den Claude Code bereits für Sie hinzugefügt hat.

48Die meisten Plugins des Demo-Marktplatzes befinden sich auch im offiziellen Marktplatz unter denselben Namen. Zum Beispiel sind `code-review`, `feature-dev`, `commit-commands` und `security-guidance` in beiden. Installieren Sie diese von `claude-plugins-official`, damit Sie nicht zwei Kopien installiert haben.

50<h2 id="find-plugins-in-the-official-marketplace">

51 Plugins im offiziellen Marktplatz finden

52</h2>

54Der offizielle Marktplatz, `claude-plugins-official`, ist derjenige, den Claude Code für Sie hinzufügt. Das meiste, was er auflistet, stammt von Partnern und anderen Autoren statt von Anthropic: Tool-Anbieter veröffentlichen Plugins, die Claude Code mit ihren Diensten verbinden, und Anthropic verwaltet einen kleineren Satz seiner eigenen, wie `commit-commands`, `code-review`, `feature-dev` und die [Language-Server-Plugins](/docs/de/plugins/code-intelligence). Der Katalog ändert sich häufig, daher listet diese Seite ihn nicht auf.

56Um zu sehen, was darin ist, verwenden Sie die Registerkarte **Discover** von `/plugin` in einer Claude Code-Sitzung, die Sie durchsuchen können, oder durchsuchen Sie [Claude Marketplace](https://claude.com/marketplace/plugins) im Web.

58<h2 id="browse-and-install-from-anthropic’s-marketplaces">

59 Durchsuchen und Installieren von Anthropics Marktplätzen

60</h2>

62Sie können Anthropics Marktplätze in Claude Code, im Web oder auf GitHub nach einem Plugin durchsuchen:

64* **In Claude Code, durch Durchsuchen**: Führen Sie `/plugin` in einer interaktiven Sitzung aus. Die Registerkarte **Discover** listet die Plugins aus den Marktplätzen auf, die Sie hinzugefügt haben.

65* **In Claude Code, nach Name**: Führen Sie `/plugin install <name>` in einer Sitzung aus, die den Namen in den Marktplätzen nachschlägt, die Sie hinzugefügt haben. Wenn sich das Plugin in einem von ihnen befindet, werden seine Details im `/plugin`-Panel geöffnet, und nichts wird installiert, bis Sie einen [Installationsbereich](/docs/de/plugins/install#install-a-plugin) wählen und dort bestätigen. Wenn nicht, sehen Sie `Plugin "<name>" not found in any marketplace`.

66* **Im Web**: Durchsuchen Sie den vollständigen Katalog auf [Claude Marketplace](https://claude.com/marketplace/plugins), das Installationszahlen anzeigt und einige Plugins als **Anthropic verified** markiert.

67* **Auf GitHub**: Öffnen Sie `.claude-plugin/marketplace.json` im Repository des Marktplatzes, wie [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official). Diese Datei ist der Katalog selbst.

69Anthropics Verzeichnis ist separat von diesen Marktplätzen. Das Verzeichnis ist der Katalog auf claude.ai, und `/plugin` listet es nicht auf. Ein Plugin, das Sie aus dem Verzeichnis auf claude.ai hinzufügen, erreicht Claude Code durch [Kontosynchronisierung](/docs/de/plugins/loading#synced-plugins). Um Ihr eigenes Plugin dort aufzulisten, siehe [Bei Anthropics Verzeichnis einreichen](/docs/de/plugins/publish#submit-to-anthropics-directory).

71Um von der Desktop-App oder von einem Skript zu installieren oder um zu sehen, was eine Cloud-Sitzung lädt, siehe [Plugins installieren](/docs/de/plugins/install).

73<h3 id="add-the-community-or-demo-marketplace">

74 Den Community- oder Demo-Marktplatz hinzufügen

75</h3>

77Die Community- und Demo-Marktplätze sind nicht registriert, bis Sie sie in einer Claude Code-Sitzung hinzufügen:

79* **Community**: Führen Sie `/plugin marketplace add anthropics/claude-plugins-community` aus, dann installieren Sie mit dem Suffix `@claude-community`.

80* **Demo**: Führen Sie `/plugin marketplace add anthropics/claude-code` aus, dann installieren Sie mit dem Suffix `@claude-code-plugins`.

82Wenn `claude-plugins-official` nicht auf der Registerkarte **Marketplaces** von `/plugin` vorhanden ist, fügen Sie ihn auf die gleiche Weise mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu.

84Für `not found`-Fehler und Marktplätze, die nicht hinzugefügt werden, siehe [Plugins fehlerbeheben](/docs/de/plugins/troubleshooting#install-a-plugin).

86<h2 id="third-party-marketplaces">

87 Marktplätze von Drittanbietern

88</h2>

90Viele beliebte Plugins befinden sich in keinem Anthropic-Marktplatz. Sie befinden sich in den Marktplätzen ihrer Autoren, normalerweise ein GitHub-Repository mit einer `.claude-plugin/marketplace.json` an seiner Wurzel.

92Anthropic überprüft Marktplätze von Drittanbietern nicht, daher lesen Sie [Plugin-Sicherheit und Vertrauen](/docs/de/plugins/security), bevor Sie einen hinzufügen.

94Um einen Marktplatz von Drittanbietern zu verwenden, fügen Sie sein Repository in einer Claude Code-Sitzung mit `/plugin marketplace add <owner>/<repo>` hinzu, dann installieren Sie mit `/plugin install <plugin>@<marketplace-name>`. Der Marktplatzname ist das Feld `name` dieser `marketplace.json`, und Claude Code gibt ihn aus, sobald es den Marktplatz hinzugefügt hat.

96Für andere Möglichkeiten, einen Marktplatz hinzuzufügen, siehe [Einen Marktplatz hinzufügen](/docs/de/plugins/install#add-a-marketplace).

98<h2 id="next-steps">

99 Nächste Schritte

100</h2>

101

102* [Plugins installieren und verwalten](/docs/de/plugins/install): Installieren Sie ein Plugin aus einem dieser Marktplätze und wählen Sie einen Bereich

103* [Plugin-Sicherheit und Vertrauen](/docs/de/plugins/security): Was ein Plugin auf Ihrem Computer tun kann und wie Sie eines überprüfen, bevor Sie es installieren

104* [Code-Intelligence-Plugins](/docs/de/plugins/code-intelligence): Installieren Sie eines der Language-Server-Plugins des offiziellen Marktplatzes

105* [Einen Marktplatz erstellen](/docs/de/plugins/create-marketplace): Führen Sie Ihren eigenen Marktplatz neben Anthropics aus

plugins/cli-hints.md +1 −1

Details

132 Nächste Schritte132 Nächste Schritte

133</h2>133</h2>

134 134

135* [Plugin veröffentlichen und verteilen](/docs/de/plugins/publish): die Routen in jeden Marketplace, einschließlich des offiziellen Marketplace, den der Hinweis benötigt135* [Plugin veröffentlichen und verteilen](/docs/de/plugins/publish): die Routen zum Verteilen eines Plugins, einschließlich des offiziellen Marketplace, den der Hinweis benötigt

136* [Plugin-Befehle-Referenz](/docs/de/plugins/cli-reference#plugin-install): der Shell-Befehl, der das gleiche Plugin außerhalb einer Sitzung installiert136* [Plugin-Befehle-Referenz](/docs/de/plugins/cli-reference#plugin-install): der Shell-Befehl, der das gleiche Plugin außerhalb einer Sitzung installiert

plugins/cli-reference.md +861 −0 created

Details

1> ## Documentation Index

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

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

5# Referenz für Plugin-Befehle

7> Vollständige Referenz für die Claude-Plugin-Shell-Befehle, /plugin und /reload-plugins in einer Sitzung, und die Flags, die ein Plugin für eine Sitzung laden.

9Sie führen Plugin-Befehle entweder als `claude plugin` aus Ihrer Shell oder einem Skript aus, oder als `/plugin` und `/reload-plugins` innerhalb einer Claude Code-Sitzung. Diese Referenz gibt die Flags, Standardwerte, Ausgabe und Exit-Codes jedes Befehls an, zusammen mit den zwei Flags, die ein Plugin für eine Sitzung laden.

11Führen Sie `claude plugin --help` auf Ihrem Build aus, um zu bestätigen, welche Unterbefehle Ihre Version hat.

13<Note>

14 Diese Fälle werden auf anderen Seiten behandelt:

16 * **Installieren und Verwalten von Schritten, und wo `/plugin` ausgeführt wird**: siehe [Plugins installieren und verwalten](/docs/de/plugins/install)

17 * **Was ein Befehl auf der Festplatte ändert und welcher Bereich Vorrang hat**: siehe [Plugin-Ladeverzeichnis](/docs/de/plugins/loading)

18 * **Was eine Fehlermeldung bedeutet**: siehe [Plugins beheben](/docs/de/plugins/troubleshooting)

19</Note>

21<h2 id="claude-plugin-commands">

22 claude plugin-Befehle

23</h2>

25Führen Sie `claude plugin <subcommand>` aus Ihrer Shell oder einem Skript aus, außerhalb einer Claude Code-Sitzung. Diese Unterbefehle installieren und verwalten Plugins, ohne das [`/plugin`](#plugin-in-a-session)-Panel zu öffnen.

27`claude plugins` ist ein Alias für `claude plugin`.

29Jeder Unterbefehl teilt diese Exit-Codes, Plugin-Argumente und Bereichswerte:

31* **Exit-Codes**: `0` bei Erfolg und `1` bei Fehler. `validate` fügt Exit `2` für einen unerwarteten Fehler hinzu, und `eval` fügt die in [seinem Abschnitt](#plugin-eval) aufgelisteten Codes hinzu.

32* **Plugin-Argumente**: ein `<plugin>`-Argument ist ein Plugin-`name` oder `name@marketplace`. Wenn zwei Marktplätze denselben Namen anbieten, verwenden Sie die qualifizierte Form.

33* **Bereiche**: `--scope` nimmt `user`, `project` oder `local` und benennt die Einstellungsdatei, in die der Befehl schreibt. `update` nimmt auch `managed`.

35<h3 id="plugin-init">

36 plugin init

37</h3>

39Gerüst für ein neues Plugin unter `~/.claude/skills/<name>/`. Es wird in Ihrer nächsten Sitzung als `<name>@skills-dir` ohne Installationsschritt geladen.

41`new` ist ein Alias für `init`.

43Für den Erstellen-, Test- und Bearbeitungs-Workflow, der mit diesem Befehl beginnt, siehe [Plugin erstellen](/docs/de/plugins/create).

45```bash theme={null}

46claude plugin init <name> [options]

47```

49`<name>` wird zum Verzeichnisnamen unter `~/.claude/skills/` und zum `name` des Plugins in seinem Manifest.

51Der Befehl hat kein Flag für einen anderen Ort. Um stattdessen innerhalb eines Projekts zu gerüsten, siehe [Plugin erstellen](/docs/de/plugins/create).

53| Flag | Beschreibung |

54| :- | :- |

55| `--description <text>` | Manifest-Beschreibung |

56| `--author <name>` | Autorname. Standardwert ist `git config user.name` |

57| `--author-email <email>` | Autor-E-Mail. Standardwert ist `git config user.email` |

58| `--with <components...>` | Auch Starter-Dateien für `skills`, `agents`, `hooks`, `mcp`, `lsp`, `output-style` oder `channel` gerüsten |

59| `-f, --force` | Überschreiben Sie ein vorhandenes `.claude-plugin/` am Ziel |

61Gerüst für ein Plugin mit Starter-Skill- und Hook-Dateien:

63```bash theme={null}

64claude plugin init my-helper --with skills hooks

65```

67Claude Code validiert, was es geschrieben hat, und druckt `Created plugin "my-helper" at ~/.claude/skills/my-helper`, gefolgt von der ID, unter der es geladen wird, und dem `claude plugin disable`-Befehl, der es ausschaltet.

69Claude Code beendet sich mit `1` ohne zu schreiben, wenn es nicht sicher gerüsten kann, und die Meldung nennt den Grund. Dies sind häufige Gründe:

71* Ein unbekannter `--with`-Wert

72* Ein vorhandenes Gerüst am Ziel ohne `--force`

73* Eine verwaltete Einstellung, die Skills-Verzeichnis-Plugins blockiert

75<h3 id="plugin-install">

76 plugin install

77</h3>

79Installieren Sie ein Plugin von einem Marktplatz, den Sie hinzugefügt haben. `i` ist ein Alias für `install`.

81```bash theme={null}

82claude plugin install <plugin> [options]

83```

85Die meisten Plugins werden ohne Eingabeaufforderung installiert. Für ein Plugin, dessen Marktplatz-Eintrag [einen Befehl zur Installation ausführt](/docs/de/plugins/host-marketplace) oder [einen `headersHelper` für seinen Download setzt](/docs/de/plugins/host-marketplace#how-users-accept-a-headershelper-command), druckt Claude Code zuerst den Befehl und fragt `Run this command now? [y/N]`.

87| Flag | Beschreibung |

88| :- | :- |

89| `-s, --scope <scope>` | Installationsbereich: `user`, `project` oder `local`. Standardwert ist `user` |

90| `--config <key=value>` | Legen Sie eine [`userConfig`](/docs/de/plugins/manifest-reference)-Option fest, die das Manifest des Plugins deklariert. Wiederholen Sie das Flag für jede Option. Erfordert Claude Code v2.1.147 oder später |

91| `-y, --yes` | Akzeptieren Sie den angezeigten Installationsbefehl ohne die `Run this command now?`-Eingabeaufforderung. Wird ignoriert, wenn der Befehl innerhalb einer Claude Code-Sitzung ausgeführt wird, z. B. vom Bash-Tool oder einem Hook. Erfordert Claude Code v2.1.229 oder später |

92| `--accept-command <sha256>` | Akzeptieren Sie den angezeigten Installationsbefehl, dessen `sha256` ein vorheriger [`--json`-Lauf](#plugin-json-result) in `shownCommand` gemeldet hat, anstelle von `-y`. Kann nicht mit `-y` kombiniert werden. Siehe [Angezeigten Installationsbefehl akzeptieren](#accept-a-displayed-install-command). Erfordert Claude Code v2.1.271 oder später |

93| `--json` | Drucken Sie das Ergebnis als ein JSON-Objekt in der letzten Zeile von stdout statt der benutzerfreundlichen Meldung, zur Verwendung in Skripten. Siehe [JSON-Ergebnisformat](#plugin-json-result). Erfordert Claude Code v2.1.268 oder später |

95Übergeben Sie `-y` von Ihrem eigenen Terminal, um den angezeigten Befehl ohne Eingabeaufforderung zu akzeptieren. Hier ist, was ohne TTY und wenn Claude den Befehl ausführt, passiert:

97* **stdin oder stdout ist keine TTY, und Sie übergeben weder `-y` noch `--accept-command`**: die Installation wird abgelehnt. Die Ausgabe besagt, dass der Befehl nur angezeigt wurde, und der Exit-Code ist `1`

98* **Claude führt den Befehl über sein Bash-Tool aus**: `-y` wird ignoriert. Führen Sie den Befehl stattdessen von Ihrem eigenen Terminal aus

100Installieren Sie ein Plugin für alle, die das Projekt klonen:

101

102```bash theme={null}

103claude plugin install formatter@my-marketplace --scope project

104```

105

106Claude Code druckt `Successfully installed plugin: formatter@my-marketplace (scope: project)`. Wenn nichts Neues installiert wird, besagt die Ausgabe warum:

107

108* **Bereits in diesem Bereich installiert**: die Ausgabe ist `Plugin "formatter@my-marketplace" is already installed (scope: project)` und der Exit-Code ist `0`

109* **Sie lehnen eine Befehlsquellen-Eingabeaufforderung ab**: die Ausgabe ist `Aborted.` und der Exit-Code ist `1`

110* **Sie lehnen eine `headersHelper`-Eingabeaufforderung ab, oder sie kann ohne TTY nicht bestätigt werden**: die Ausgabe ist `Aborted — the command was not run.` und der Exit-Code ist `1`

111

112<h4 id="plugin-json-result">

113 JSON-Ergebnisformat

114</h4>

115

116Wenn Sie `--json` an `plugin install` übergeben, ist die letzte Zeile von stdout ein JSON-Objekt. Analysieren Sie nur diese Zeile, da Claude Code jeden Befehl, den der Marktplatz deklariert, davor druckt.

117

118Drei Felder sind immer vorhanden:

119

120* `command`: der Unterbefehl, der ausgeführt wurde, z. B. `install`

121* `outcome`: `ok` oder `failed`

122* `message`: eine benutzerfreundliche Beschreibung des Ergebnisses

123

124Andere Felder, wie `pluginId`, `scope` und `failureCode`, erscheinen nur, wenn sie zutreffen.

125

126Die `--json`-Option auf `plugin uninstall`, `plugin update`, `plugin enable` und `plugin disable` druckt dasselbe Objekt mit den eigenen Feldern dieses Unterbefehls.

127

128Ein Nutzungsfehler, wie ein ungültiger `--scope`, druckt keine Ergebniszeile und beendet sich mit `1` mit dem Grund auf stderr.

129

130<h4 id="accept-a-displayed-install-command">

131 Angezeigten Installationsbefehl akzeptieren

132</h4>

133

134Wenn ein `--json`-Lauf einen vom Marktplatz deklarierten Befehl anzeigt und ihn nicht ausführt, trägt das `failed`-Ergebnis auch ein `shownCommand`-Objekt. Seine Felder enthalten den Befehl wie angezeigt, das Plugin, zu dem er gehört, und den `sha256` des Befehls.

135

136Um genau diesen Befehl zu akzeptieren, führen Sie ihn mit diesem `sha256` als `--accept-command` von Ihrem eigenen Terminal aus, da das Flag keine Auswirkung innerhalb einer Claude Code-Sitzung hat. Erfordert Claude Code v2.1.271 oder später.

137

138Der `sha256` zählt als Akzeptanz für genau diesen Befehl, Plugin und Marktplatz-Katalog. Wenn sich einer von ihnen seit der Anzeige des Befehls geändert hat, akzeptiert Claude Code den `sha256` nicht und zeigt den Befehl erneut an. Eine Änderung, die die Marktplatz-Aktualisierung des Laufs selbst abruft, zählt auch als solche Änderung.

139

140Wenn `shownCommand.acceptCommandMatched` `false` ist, stimmt der `sha256`, den Sie übergeben haben, nicht mit dem jetzt angezeigten Befehl überein. Überprüfen Sie diesen Befehl, bevor Sie ihn mit seinem `sha256` erneut ausführen.

141

142<h3 id="plugin-uninstall">

143 plugin uninstall

144</h3>

145

146Entfernen Sie ein installiertes Plugin aus einem Bereich. `remove` und `rm` sind Aliase für `uninstall`.

147

148```bash theme={null}

149claude plugin uninstall <plugin> [options]

150```

151

152| Flag | Beschreibung |

153| :- | :- |

154| `-s, --scope <scope>` | Deinstallieren Sie aus dem Bereich: `user`, `project` oder `local`. Standardwert ist `user` |

155| `--keep-data` | Bewahren Sie das Datenverzeichnis des Plugins, `~/.claude/plugins/data/<id>/` |

156| `--prune` | Entfernen Sie auch automatisch installierte [Abhängigkeiten](/docs/de/plugins/dependencies), die kein verbleibendes Plugin benötigt |

157| `-y, --yes` | Überspringen Sie die `--prune`-Bestätigungsaufforderung. Erforderlich mit `--prune`, wenn stdin oder stdout keine TTY ist |

158| `--json` | Drucken Sie das Ergebnis als ein JSON-Objekt in der letzten Zeile von stdout, im [gleichen Format wie `plugin install --json`](#plugin-json-result). Kann nicht mit `--prune` kombiniert werden. Erfordert Claude Code v2.1.268 oder später |

159

160Deinstallieren Sie ein Plugin aus dem Projektbereich:

161

162```bash theme={null}

163claude plugin uninstall formatter@my-marketplace --scope project

164```

165

166Claude Code druckt `Successfully uninstalled plugin: formatter (scope: project)`. Wenn das Plugin nicht in diesem Bereich installiert ist, druckt der Befehl eine Zeile, die mit `Failed to uninstall plugin "formatter@my-marketplace":` beginnt, und beendet sich mit `1`.

167

168Wenn die Fehlerzeile mit `"formatter" was not uninstalled:` fortfährt, konnte Claude Code nicht bestätigen, dass die Einstellungen des Bereichs das Plugin nicht mehr aktivieren, sodass das Plugin mit allem, was es gespeichert hat, installiert bleibt. Mit `--json` trägt das Ergebnis `failureCode: "settings_still_on"`. Diese Einstellungsprüfung erfordert Claude Code v2.1.282 oder später.

169

170<h4 id="what-an-uninstall-deletes-and-keeps">

171 Was eine Deinstallation löscht und behält

172</h4>

173

174Wenn Sie ein Plugin aus dem letzten Bereich deinstallieren, in dem es installiert ist, löscht Claude Code auch die gespeicherten [Optionen und Geheimnisse](/docs/de/plugins/manifest-reference#user-configuration) des Plugins und sein Datenverzeichnis, `~/.claude/plugins/data/<id>/`. Es gibt drei Ausnahmen:

175

176* Mit `--keep-data` bleibt das Datenverzeichnis

177* Wenn ein anderes installiertes Plugin denselben Ordner verwendet, z. B. eines, dessen ID sich von diesem nur in der Groß-/Kleinschreibung unterscheidet, bleibt das Datenverzeichnis

178* Wenn Claude Code die Liste der installierten Plugins nach dem Entfernen des Plugins aus diesem Bereich nicht zurücklesen kann, bleiben die Optionen, Geheimnisse und das Datenverzeichnis alle erhalten, da das Plugin möglicherweise noch in einem anderen Bereich installiert ist. Die Deinstallation ist trotzdem erfolgreich. Die Meldung listet auf, was geblieben ist und wie man es löscht, und mit `--json` trägt das Ergebnis `savedKept: "install_records_unreadable"`

179

180Mit `--json` meldet `keptData`, ob das Verzeichnis geblieben ist, und `/plugin` zeigt `· data preserved`, wenn es das tat. Für ein Verzeichnis, das ohne `--keep-data` bleibt, erfordert diese Meldung Claude Code v2.1.281 oder später. Das Feld `savedKept` erfordert Claude Code v2.1.282 oder später.

181

182<h3 id="plugin-enable">

183 plugin enable

184</h3>

185

186Aktivieren Sie ein deaktiviertes Plugin. Für ein [Plugin, das von claude.ai synchronisiert wird](/docs/de/plugins/loading#synced-plugins), übergeben Sie `<name>@synced` als Plugin.

187

188```bash theme={null}

189claude plugin enable <plugin> [options]

190```

191

192| Flag | Beschreibung |

193| :- | :- |

194| `-s, --scope <scope>` | Bereich zum Aktivieren: `user`, `project` oder `local`. Wird automatisch erkannt, wenn weggelassen |

195| `--json` | Drucken Sie das Ergebnis als ein JSON-Objekt in der letzten Zeile von stdout, im [gleichen Format wie `plugin install --json`](#plugin-json-result). Erfordert Claude Code v2.1.268 oder später |

196

197Ohne `--scope` prüft der Befehl Ihre Einstellungsdateien in der Reihenfolge lokal, Projekt, Benutzer, und verwendet den ersten Bereich, der das Plugin erwähnt.

198

199Wenn Sie einen `--scope` übergeben, wo das Plugin nicht deklariert ist, schreibt der Befehl entweder eine Überschreibung oder schlägt fehl:

200

201* **Ein Bereich, der [Vorrang](/docs/de/plugins/loading) vor dem deklarierenden hat**: Claude Code schreibt eine Überschreibung in dem Bereich, den Sie übergeben haben. Zum Beispiel deaktiviert `claude plugin disable formatter --scope local` ein projektaktiviertes Plugin nur für Sie

202* **Jeder andere Bereich**: der Befehl schlägt fehl mit `Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.`

203

204Wenn das Plugin bereits im aufgelösten Bereich aktiviert ist, druckt der Befehl `Plugin "formatter" is already enabled` und beendet sich mit `1`. Mit `--json` hat das Ergebnis `"failureCode": "already_in_goal_state"` und `"alreadyInGoalState": true`, sodass ein Skript diesen Fall als Erfolg behandeln kann.

205

206Wenn das Plugin [Abhängigkeiten](/docs/de/plugins/dependencies) deklariert, aktiviert Claude Code diese auch. Der Befehl schlägt in diesen Fällen fehl:

207

208* **Eine Abhängigkeit ist nicht installiert**: enable schlägt fehl und druckt den `claude plugin install`-Befehl für jede fehlende Abhängigkeit

209* **Eine Abhängigkeit wird durch die Plugin-Richtlinie Ihrer Organisation blockiert**: enable schlägt fehl und nennt die blockierte Abhängigkeit

210* **Eine Abhängigkeit ist auf `false` in einem Bereich mit höherem Vorrang als der Zielbereich gesetzt**: enable schlägt fehl. Aktivieren Sie die Abhängigkeit in diesem Bereich, oder übergeben Sie `--scope`, um dort zu schreiben

211

212Aktivieren Sie ein Plugin überall dort, wo es deklariert ist:

213

214```bash theme={null}

215claude plugin enable formatter

216```

217

218Claude Code druckt `Successfully enabled plugin: formatter (scope: project)` und nennt den erkannten Bereich.

219

220<h3 id="plugin-disable">

221 plugin disable

222</h3>

223

224Deaktivieren Sie ein Plugin, ohne es zu deinstallieren. Für ein [Plugin, das von claude.ai synchronisiert wird](/docs/de/plugins/loading#synced-plugins), übergeben Sie `<name>@synced` als Plugin.

225

226```bash theme={null}

227claude plugin disable [plugin] [options]

228```

229

230| Flag | Beschreibung |

231| :- | :- |

232| `-a, --all` | Deaktivieren Sie jedes aktivierte Plugin. Kann nicht mit einem Plugin-Namen oder `--scope` kombiniert werden |

233| `-s, --scope <scope>` | Bereich zum Deaktivieren: `user`, `project` oder `local`. Wird automatisch erkannt, wenn weggelassen |

234| `--json` | Drucken Sie das Ergebnis als ein JSON-Objekt in der letzten Zeile von stdout, im [gleichen Format wie `plugin install --json`](#plugin-json-result). Erfordert Claude Code v2.1.268 oder später |

235

236Ohne `--scope` wird der Bereich in der gleichen lokalen, Projekt-, Benutzer-Reihenfolge wie [`plugin enable`](#plugin-enable) automatisch erkannt.

237

238Wenn Sie weder einen Plugin-Namen noch `--all` übergeben, druckt Claude Code `Please specify a plugin name or use --all to disable all plugins` und beendet sich mit `1`. Das Deaktivieren eines Plugins, das bereits deaktiviert ist, druckt `Plugin "formatter" is already disabled` und beendet sich mit `1`, wie [`plugin enable`](#plugin-enable) für ein bereits aktiviertes Plugin.

239

240Der Befehl schlägt für ein Plugin fehl, das noch erforderlich ist:

241

242* **Ein anderes aktiviertes Plugin [hängt davon ab](/docs/de/plugins/dependencies)**: der Befehl schlägt fehl und nennt die Abhängigen, die zuerst deaktiviert werden sollen

243* **Ihre Organisation verlangt es als synchronisiertes Plugin**: der Befehl schlägt fehl und speichert nichts

244

245Deaktivieren Sie ein Plugin:

246

247```bash theme={null}

248claude plugin disable formatter

249```

250

251Claude Code druckt `Successfully disabled plugin: formatter (scope: project)`.

252

253<h3 id="plugin-update">

254 plugin update

255</h3>

256

257Aktualisieren Sie ein Plugin auf die neueste Version, die sein Marktplatz anbietet. Die neue Version wird in Ihrer nächsten Sitzung geladen, oder nachdem Sie `/reload-plugins` in einer laufenden ausführen.

258

259```bash theme={null}

260claude plugin update <plugin> [options]

261```

262

263| Flag | Beschreibung |

264| :- | :- |

265| `-s, --scope <scope>` | Bereich zum Aktualisieren: `user`, `project`, `local` oder `managed`. Wird automatisch erkannt, wenn weggelassen |

266| `-y, --yes` | Akzeptieren Sie einen geänderten Installationsbefehl von einem [Befehlsquellen](/docs/de/plugins/host-marketplace)-Plugin ohne die Eingabeaufforderung. Erforderlich, wenn stdin oder stdout keine TTY ist, es sei denn, Sie übergeben `--accept-command`. Erfordert Claude Code v2.1.229 oder später |

267| `--accept-command <sha256>` | Akzeptieren Sie den vom Marktplatz deklarierten Befehl, dessen `sha256` ein vorheriger [`--json`-Lauf](#plugin-json-result) in `shownCommand` gemeldet hat, anstelle von `-y`. Kann nicht mit `-y` kombiniert werden. Erfordert Claude Code v2.1.271 oder später |

268| `--json` | Drucken Sie das Ergebnis als ein JSON-Objekt in der letzten Zeile von stdout, im [gleichen Format wie `plugin install --json`](#plugin-json-result). Erfordert Claude Code v2.1.268 oder später |

269

270Wenn Sie `--scope` weglassen, aktualisiert der Befehl das Plugin im spezifischsten Bereich, in dem es für Ihr aktuelles Projekt installiert ist, und prüft lokal, Projekt, Benutzer, dann verwaltet.

271

272Vor v2.1.281 verwendete der Befehl `user`, wenn Sie `--scope` wegließen, sodass das Aktualisieren eines Plugins, das nur im Projekt- oder lokalen Bereich installiert ist, mit `Plugin "<name>" is not installed at scope user` fehlschlug. Übergeben Sie auf diesen Versionen `--scope`.

273

274`managed` ist der einzige Bereich, den Sie aktualisieren, aber nicht installieren können. Für von Administratoren installierte Plugins siehe [Plugins für Ihre Organisation verwalten](/docs/de/plugins/org).

275

276Aktualisieren Sie ein Plugin:

277

278```bash theme={null}

279claude plugin update formatter@my-marketplace

280```

281

282Claude Code druckt `Checking for updates for plugin "formatter@my-marketplace"…`, dann das Ergebnis. Wenn nichts neuer ist, druckt es `formatter is already at the latest version (1.0.0).` und beendet sich mit `0`.

283

284Sie können einen bloßen Plugin-Namen übergeben, den der Befehl gegen Ihre installierten Plugins abgleicht. Wenn installierte Plugins von verschiedenen Marktplätzen denselben Namen teilen, weigert sich der Befehl zu aktualisieren und listet die qualifizierten `plugin-name@marketplace-name`-Befehle auf, die stattdessen ausgeführt werden sollen. Das Aktualisieren nach bloßem Namen erfordert Claude Code v2.1.246 oder später.

285

286<h3 id="plugin-list">

287 plugin list

288</h3>

289

290Listet installierte Plugins mit ihrer Version, ihrem Bereich und ihrem Status auf.

291

292```bash theme={null}

293claude plugin list [options]

294```

295

296| Flag | Beschreibung |

297| :- | :- |

298| `--json` | Drucken Sie die Liste als JSON |

299| `--available` | Listet auch Plugins auf, die Ihre Marktplätze anbieten, die Sie nicht installiert haben. Hat keine Auswirkung ohne `--json` |

300

301Claude Code gruppiert die benutzerfreundliche Ausgabe nach dem Laden jedes Plugins:

302

303* **`Installed plugins:`**: Plugins, die Sie von einem Marktplatz installiert haben

304* **`Session-only plugins (--plugin-dir / --plugin-url):`**: Plugins, die von diesen Flags im gleichen Befehl geladen werden, wie in `claude --plugin-dir ./my-plugin plugin list`

305* **`Skills-directory plugins (.claude/skills/*):`**: Plugins, die Claude Code in einem Skills-Verzeichnis gefunden hat

306* **`Synced from claude.ai`**: [Plugins, die von Ihrem claude.ai-Konto synchronisiert werden](/docs/de/plugins/loading#synced-plugins)

307

308Wenn nichts in einer Gruppe vorhanden ist, druckt Claude Code ``No plugins installed. Use `claude plugin install` to install a plugin.``

309

310<h4 id="json-output">

311 JSON-Ausgabe

312</h4>

313

314Mit `--json` druckt Claude Code ein Array mit einem Objekt pro Installation. Jedes Objekt trägt die unten aufgelisteten Felder. `id`, `version`, `scope`, `enabled` und `installPath` sind immer vorhanden, und die anderen erscheinen nur, wenn sie zutreffen.

315

316| Feld | Typ | Beschreibung |

317| :- | :- | :- |

318| `id` | string | `name@marketplace` für Installationen, `name@inline` für Sitzungs-Plugins, `name@skills-dir` für Skills-Verzeichnis-Plugins, `name@synced` für Plugins, die von claude.ai synchronisiert werden |

319| `version` | string | Für eine Marktplatz-Installation die [Version, die Claude Code berechnet hat](/docs/de/plugins/loading#versions-and-updates) bei der Installation. Für ein Sitzungs-, Skills-Verzeichnis- oder synchronisiertes Plugin das `version` des Manifests, oder `unknown`, wenn es keines deklariert |

320| `scope` | string | `user`, `project`, `local` oder `managed` für Installationen; `user` oder `project` für Skills-Verzeichnis-Plugins; `session` für Sitzungs-Plugins; `synced` für Plugins, die von claude.ai synchronisiert werden |

321| `enabled` | boolean | Ob das Plugin in Ihren zusammengeführten Einstellungen aktiviert ist |

322| `installPath` | string | Verzeichnis, aus dem das Plugin geladen wird |

323| `installedAt` | string | ISO-Zeitstempel der Installation. Nur Marktplatz-Installationen |

324| `lastUpdated` | string | ISO-Zeitstempel der letzten Aktualisierung. Nur Marktplatz-Installationen |

325| `projectPath` | string | Projekt, zu dem die Installation gehört. Nur `project`- und `local`-Bereich |

326| `mcpServers` | object | Die MCP-Server-Definitionen des Plugins, wenn ein Marktplatz-installiertes Plugin welche hat |

327| `errors` | array of strings | Ladefehler, wenn das Plugin nicht geladen werden konnte |

328| `notes` | array of strings | Authoring-Warnungen für ein Plugin, das geladen wurde und funktioniert |

329| `errorDetails` | array of objects | Ein Objekt pro `errors`-Eintrag, das seinen diagnostischen `type` und die Namen angibt, auf die es sich bezieht, wie das Plugin, der Marktplatz, der Server oder die Datei. Erfordert Claude Code v2.1.268 oder später |

330| `noteDetails` | array of objects | Die gleichen Detail-Objekte für jeden `notes`-Eintrag. Erfordert Claude Code v2.1.268 oder später |

331

332Mit `--json --available` druckt Claude Code ein Objekt statt eines Arrays. Sein `installed`-Feld hält das Array von installierten-Plugin-Objekten, und sein `available`-Feld hält ein Objekt pro nicht installiertem Marktplatz-Plugin mit den unten aufgelisteten Feldern.

333

334| Feld | Typ | Beschreibung |

335| :- | :- | :- |

336| `pluginId` | string | `name@marketplace` |

337| `name` | string | Der Name des Plugins im Marktplatz |

338| `marketplaceName` | string | Der Marktplatz, der es anbietet |

339| `source` | string or object | Der [source](/docs/de/plugins/marketplace-reference) des Marktplatz-Eintrags: ein string für einen relativen Pfad, ein Objekt sonst |

340| `description` | string | Die Beschreibung des Eintrags, wenn er eine hat |

341| `version` | string | Die Version des Eintrags, wenn er eine deklariert |

342| `installCount` | number | Installationsanzahl, wenn Claude Code eine für das Plugin hat |

343

344<h3 id="plugin-details">

345 plugin details

346</h3>

347

348Zeigen Sie das Komponenten-Inventar eines Plugins und seine projizierte Token-Kosten an.

349

350Das Plugin muss geladen sein: installiert, in einem Skills-Verzeichnis gefunden, oder mit `--plugin-dir` oder `--plugin-url` im gleichen Befehl übergeben. Der `<name>` ist ein Plugin-`name` oder `name@marketplace`.

351

352```bash theme={null}

353claude plugin details <name>

354```

355

356Der Befehl nimmt keine Flags außer `--help`.

357

358Zeigen Sie, was ein installiertes Plugin beiträgt:

359

360```bash theme={null}

361claude plugin details formatter

362```

363

364Claude Code druckt den Namen, die Version, die Beschreibung und die Quelle des Plugins, dann diese Abschnitte:

365

366* **`Component inventory`**: die Skills, Agents, Hooks, MCP-Server und LSP-Server des Plugins

367* **`Projected token cost`**: die immer aktiven Token, die das Plugin zu jeder Sitzung hinzufügt

368* **`Per-component (rounded)`**: Schätzungen für immer aktiv und bei Aufruf für jeden Skill, Agent und Befehl. Weggelassen, wenn das Plugin keine hat

369

370Für die Bedeutung der beiden Kostenzahlen siehe [Plugin-Kosten und -Nutzung messen](/docs/de/plugins/measure).

371

372Für ein Plugin, das nicht geladen ist, druckt Claude Code ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` und beendet sich mit `1`.

373

374<h3 id="plugin-prune">

375 plugin prune

376</h3>

377

378Entfernen Sie automatisch installierte [Abhängigkeiten](/docs/de/plugins/dependencies), die kein installiertes Plugin mehr benötigt. Der Befehl entfernt niemals ein Plugin, das Sie selbst installiert haben. `autoremove` ist ein Alias für `prune`.

379

380```bash theme={null}

381claude plugin prune [options]

382```

383

384| Flag | Beschreibung |

385| :- | :- |

386| `-s, --scope <scope>` | Prune im Bereich: `user`, `project` oder `local`. Standardwert ist `user` |

387| `--dry-run` | Listet auf, was entfernt würde, ohne es zu entfernen |

388| `-y, --yes` | Überspringen Sie die Bestätigungsaufforderung. Erforderlich, wenn stdin oder stdout keine TTY ist |

389

390Zeigen Sie eine Vorschau, was ein Prune entfernen würde:

391

392```bash theme={null}

393claude plugin prune --dry-run

394```

395

396Claude Code listet die verwaisten Abhängigkeiten auf und endet mit `(dry run — nothing removed)`. Wenn es nichts zu entfernen gibt, druckt es eine Zeile, die mit `Nothing to prune` beginnt.

397

398Ohne `--dry-run` entfernt der Befehl die verwaisten Abhängigkeiten nur, nachdem Sie an der Eingabeaufforderung bestätigt oder `-y` übergeben haben.

399

400Der Exit-Code ist `0`, egal wie Sie an der Eingabeaufforderung antworten.

401

402Was `prune` tut, hängt davon ab, ob ein Terminal angehängt ist und ob Sie `-y` übergeben:

403

404| Terminal und Flags | Was passiert |

405| :- | :- |

406| Interaktives Terminal, kein `-y` | Listet die verwaisten Abhängigkeiten auf und fragt `Remove? [y/N]` |

407| Jedes Terminal, `-y` | Entfernt sie und druckt `Removed N auto-installed plugins: <names>` |

408| Non-TTY stdin oder stdout, kein `-y` | Druckt die Liste und ``Not a TTY — run `claude plugin prune -y` to remove.``, entfernt nichts |

409

410<h3 id="plugin-eval">

411 plugin eval

412</h3>

413

414Führen Sie die [eval-Fälle](/docs/de/plugin-evals) eines Plugins aus und melden Sie bewertete Ergebnisse. Erfordert Claude Code v2.1.269 oder später.

415

416Jeder Fall ist eine Eingabeaufforderung plus Bewerter. Claude Code führt ihn mehrmals in einer isolierten Sitzung mit nur dem Ziel-Plugin geladen aus, und standardmäßig auch ohne das Plugin, sodass der Bericht den Unterschied zeigt.

417

418Siehe [Plugins mit Evals testen](/docs/de/plugin-evals) für das Fallformat, Bewerter, Ergebnisse und CI-Nutzung.

419

420```bash theme={null}

421claude plugin eval [target] [options]

422```

423

424Das optionale `target` standardisiert auf das aktuelle Verzeichnis und nimmt jede dieser Formen:

425

426* Ein Plugin-Verzeichnis

427* Eine einzelne `prompt.md` oder `case.yaml`-Datei

428* Ein installiertes Plugin als `name` oder `name@marketplace`

429* `name@skills-dir`

430

431Setzen Sie das Ziel vor `--tag`, `--allow-tools` und `--json`. Jede dieser Optionen nimmt die Wörter, die ihr folgen, als ihren Wert, sodass ein Ziel, das nach einer von ihnen geschrieben wird, als ein Tag, ein Tool-Name oder der JSON-Ausgabepfad statt als Ziel gelesen wird.

432

433Diese Tabelle listet die Optionen auf, die die meisten Läufe verwenden. Führen Sie `claude plugin eval --help` für den vollständigen Satz aus, einschließlich `--case`, `--tag`, `--output-dir`, `--report`, `--allow-real-servers`, `--keep-temp` und `--verbose`.

434

435| Option | Beschreibung | Standard |

436| :- | :- | :- |

437| `--runs <n>` | Läufe pro Fall in jedem [Arm](/docs/de/plugin-evals#compare-against-a-no-plugin-baseline) | Jedes Falls `runs`, sonst 3 |

438| `-j, --concurrency <n>` | Agent-Sitzungen, die gleichzeitig ausgeführt werden, 1 bis 8. Sie teilen Ihr Ratenlimit | `1` |

439| `--model <model>` | Modell für den getesteten Agent | Jedes Falls `model`, sonst `ANTHROPIC_MODEL`, wenn gesetzt, sonst Claude Codes Standard |

440| `--judge-model <model>` | Modell für `llm`- und `baseline`-Bewerter | Ein kleines schnelles Modell |

441| `--ablation <mode>` | `none` oder `with-without`. Siehe [Mit einem No-Plugin-Baseline vergleichen](/docs/de/plugin-evals#compare-against-a-no-plugin-baseline) | `with-without`, wenn ein Plugin aufgelöst wird, sonst `none` |

442| `--threshold <0..1>` | Beenden Sie mit 1, wenn ein Fall unter diesem Wert bewertet wird | `1.0` |

443| `--max-cost-usd <usd>` | Stoppen Sie vor dem nächsten Lauf, sobald die Ausgaben diesen Wert erreichen, beenden Sie mit 2, und melden Sie Teilergebnisse | Kein Limit |

444| `--allow-tools <tools...>` | Gewähren Sie Tools über die schreibgeschützte Menge hinaus, wie `Bash`, `Write`, `Edit` oder `"mcp__plugin_<plugin>_<server>__*"`. Siehe [Tools gewähren](/docs/de/plugin-evals#grant-tools) | |

445| `--scaffold` | Führen Sie das [`scaffold_script`](/docs/de/plugin-evals#add-setup-or-history-with-case-yaml) jedes Falls aus | Aus |

446| `--trust-plugin` | Überspringen Sie die Vertrauensaufforderung beim ersten Lauf, für CI. Siehe [Was ein Lauf zugreifen kann](/docs/de/plugin-evals#security) | Aus |

447| `--mocks <mode>` | `record` oder `off`. Siehe [Mock MCP-Server](/docs/de/plugin-evals#mock-mcp-servers) | `record` |

448| `--eval-dir <dir>` | Verzeichnis unter dem Plugin, das die Fälle hält | Das `experimental.evals` des Manifests, sonst `evals` |

449| `--json [path]` | Drucken Sie das [Ergebnisdokument](/docs/de/plugin-evals#json-result) auf stdout, oder schreiben Sie es in einen `.json`-Pfad | |

450| `--no-publish` | Halten Sie den HTML-Bericht lokal | |

451

452Der Exit-Code meldet, wie der Lauf endete. Um darauf in einer Pipeline zu reagieren, siehe [Evals in CI ausführen](/docs/de/plugin-evals#run-evals-in-ci).

453

454| Exit-Code | Bedeutung |

455| :- | :- |

456| `0` | Jeder Fall erfüllt den Schwellenwert |

457| `1` | Ein fehlgeschlagener Fall, ein Ladefehler oder ein nicht vertrauenswürdiges Plugin-Verzeichnis |

458| `2` | Ein Teillauf |

459| `130` | Unterbrochen |

460| `143` | Beendet |

461

462<h3 id="plugin-eval-init">

463 plugin eval init

464</h3>

465

466Erstellen Sie eine Eval-Suite für das Plugin im aktuellen Verzeichnis. Erfordert Claude Code v2.1.269 oder später. Siehe [Erstellen Sie Ihre erste Eval-Suite](/docs/de/plugin-evals#create-your-first-eval-suite).

467

468```bash theme={null}

469claude plugin eval init [name] [options]

470```

471

472In einem Terminal öffnet der Befehl eine interaktive Claude Code-Sitzung für ein Authoring-Interview. Im Interview führt Claude Folgendes durch:

473

4741. Liest das Plugin

4752. Fragt Sie, was es gut tun sollte

4763. Schlägt Fälle und Bewerter vor

4774. Schreibt die Fallsdateien

4785. Führt die Fälle aus und überprüft die Noten mit Ihnen, um zu überprüfen, dass die Bewerter so bewerten, wie Sie es würden

479

480Mit `--bare` oder ohne Terminal schreibt der Befehl stattdessen eine leere Einzelfall-Vorlage. Wenn Claude den Befehl von innerhalb einer Claude Code-Sitzung ausführt, druckt der Befehl die Interview-Anweisungen für diese Sitzung, um sie zu befolgen, statt eine Vorlage zu schreiben.

481

482Der optionale `name` ist ein Fallname. Er ist erforderlich mit `--bare` oder ohne Terminal, da der Befehl die leere Vorlage für diesen Fall schreibt. Das Interview benötigt keinen.

483

484Der Befehl akzeptiert diese Optionen:

485

486| Option | Beschreibung | Standard |

487| :- | :- | :- |

488| `--bare` | Schreiben Sie ein leeres `prompt.md` und `graders/criteria.md` für `<name>` statt das Interview auszuführen | |

489| `-i, --interactive` | Erfordern Sie das Interview. Schlägt ohne Terminal fehl, statt eine Vorlage zu schreiben | |

490| `--eval-dir <dir>` | Verzeichnis unter dem aktuellen Verzeichnis, um Fälle hineinzuschreiben | Das `experimental.evals` des Manifests, sonst `evals` |

491

492<h3 id="plugin-tag">

493 plugin tag

494</h3>

495

496Erstellen Sie ein kommentiertes git-Tag mit dem Namen `<name>--v<version>` für eine Plugin-Veröffentlichung. Vor dem Tagging prüft der Befehl, dass das `plugin.json` des Plugins und jeder Marktplatz-Eintrag, der es auflistet, sich auf die Version einigen.

497

498Für wann ein Release getaggt werden soll, siehe [Plugin veröffentlichen](/docs/de/plugins/publish).

499

500```bash theme={null}

501claude plugin tag [path] [options]

502```

503

504Der `[path]` ist das Plugin-Verzeichnis, standardisiert auf das aktuelle Verzeichnis. Der Befehl findet den Marktplatz-Eintrag, indem er von diesem Verzeichnis bis zu einem `.claude-plugin/marketplace.json`, das das Plugin auflistet, hinaufgeht.

505

506| Flag | Beschreibung |

507| :- | :- |

508| `--push` | Pushen Sie das Tag zu `--remote` nach dem Erstellen |

509| `--dry-run` | Drucken Sie, was getaggt würde, ohne das Tag zu erstellen |

510| `-f, --force` | Überspringen Sie die Checks für schmutzigen Arbeitsbaum und bereits vorhandenes Tag |

511| `-m, --message <msg>` | Tag-Anmerkungsmeldung. `%s` steht für die Version. Standardwert ist `<name> <version>` |

512| `--remote <name>` | Remote zum Pushen mit `--push`. Standardwert ist `origin` |

513

514Zeigen Sie eine Vorschau des Tags für ein Plugin in einem Marktplatz-Checkout:

515

516```bash theme={null}

517claude plugin tag plugins/formatter --dry-run

518```

519

520Claude Code druckt den Plan:

521

522* Der Plugin-Name

523* Die Version und aus welcher Datei sie kommt

524* Der passende Marktplatz-Eintrag, wenn es einen gibt

525* Der Tag-Name

526* Die `git tag`- und `git push`-Befehle, die es ausführen würde

527

528Ohne `--dry-run` druckt Claude Code `Created tag formatter--v1.0.0` und entweder `Pushed to origin` oder den Push-Befehl, den Sie selbst ausführen müssen. Wenn der Push fehlschlägt, wird das Tag immer noch lokal erstellt und der Befehl beendet sich mit einem Fehler.

529

530Der Befehl beendet sich mit `1` und druckt den Grund, wenn er nicht sicher tagging kann. Häufige Gründe sind:

531

532* Keine `version` in `plugin.json` oder dem Marktplatz-Eintrag

533* Das Tag existiert bereits

534* Der Arbeitsbaum ist schmutzig

535

536<h3 id="plugin-validate">

537 plugin validate

538</h3>

539

540Validieren Sie ein Plugin-Manifest, ein Marktplatz-Manifest oder die Skills, Agents und Befehle in einem Verzeichnis, und beenden Sie mit einem Code, auf den ein CI-Job reagieren kann. Für den Erstellen-, Test- und Bearbeitungs-Workflow siehe [Plugin erstellen](/docs/de/plugins/create). Für das, was der Validator in jedem Manifest prüft, siehe die [Plugin-Manifest-Referenz](/docs/de/plugins/manifest-reference) und die [Marktplatz-Referenz](/docs/de/plugins/marketplace-reference).

541

542```bash theme={null}

543claude plugin validate <path> [options]

544```

545

546| Flag | Beschreibung |

547| :- | :- |

548| `--strict` | Behandeln Sie Warnungen als Fehler, sodass unerkannte Felder und fehlende Metadaten, die die Laufzeit toleriert, den Lauf fehlschlagen lassen. Erfordert Claude Code v2.1.145 oder später |

549| `--json` | Geben Sie den Validierungsbericht als ein JSON-Objekt mit den gleichen Exit-Codes aus. Erfordert Claude Code v2.1.259 oder später |

550

551Validieren Sie ein Plugin vor dem Commit:

552

553```bash theme={null}

554claude plugin validate ./my-plugin --strict

555```

556

557<h4 id="validate-a-directory">

558 Validieren Sie ein Verzeichnis

559</h4>

560

561Der `<path>` ist eine Manifest-Datei oder ein Verzeichnis. Gegeben ein Verzeichnis, wählt Claude Code, was validiert werden soll, nach dem, was es dort findet:

562

563* `.claude-plugin/marketplace.json`, wenn es existiert

564* Sonst `.claude-plugin/plugin.json`

565* Sonst die Komponentendateien, gewählt nach dem Namen des Verzeichnisses. Das Validieren von Komponentendateien ohne Manifest erfordert Claude Code v2.1.233 oder später:

566 * Ein Verzeichnis mit dem Namen `skills`, `agents` oder `commands`: die Dateien darin

567 * Ein Verzeichnis mit dem Namen `.claude`: die `skills`-, `agents`- und `commands`-Verzeichnisse darin

568 * Jedes andere Verzeichnis: diese drei Verzeichnisse unter seinem `.claude`

569

570Claude Code folgt nicht Symlinks innerhalb des Verzeichnisses, das Sie benennen. Was es tut, hängt davon ab, wo der Link ist:

571

572* **Ein verknüpftes `skills`-, `agents`- oder `commands`-Verzeichnis unter dem Plugin- oder `.claude`-Root**: Claude Code warnt, dass nichts darin gelesen wurde.

573* **Ein verknüpfter Eintrag innerhalb eines `skills`-, `agents`- oder `commands`-Verzeichnisses**: Claude Code überspringt ihn und warnt pro Verzeichnis, wie viele Einträge es übersprungen hat, die eine Sitzung laden würde.

574* **Das `skills`-, `agents`- oder `commands`-Verzeichnis, das Sie benennen, ist selbst ein Symlink, oder sein übergeordnetes `.claude`-Verzeichnis ist**: Claude Code meldet einen Fehler und prüft nichts darin. Benennen Sie stattdessen das echte Verzeichnis.

575

576Ein paar Dateien werden nicht von einem Validierungslauf gelesen:

577

578* **Eine `SKILL.md` am Plugin-Root**: wenn Sie `claude plugin validate` gegen ein Plugin-Verzeichnis ausführen, prüft Claude Code keine `SKILL.md` am Plugin-Root

579* **Eine `CLAUDE.md` am Plugin-Root**: in einem Plugin-Lauf warnt Claude Code auch vor einer `CLAUDE.md` am Plugin-Root

580* **Plugin-Dateien in einem Marktplatz-Lauf**: von einem Marktplatz-Verzeichnis öffnet Claude Code nicht die Skill-, Agent-, Befehls- oder Hook-Dateien der Plugins. Um Fehler in diesen Dateien zu finden, validieren Sie jedes Plugin-Verzeichnis

581

582<h4 id="output-and-exit-codes">

583 Ausgabe und Exit-Codes

584</h4>

585

586Claude Code druckt die Datei, die es validiert hat, alle Fehler und Warnungen mit ihren Pfaden, und eine Urteilszeile. Der Exit-Code folgt dem Urteil:

587

588| Exit-Code | Urteilszeile | Bedeutung |

589| :- | :- | :- |

590| `0` | `Validation passed` oder `Validation passed with warnings` | Das Manifest wird geladen. Mit `--strict` auch keine Warnungen |

591| `1` | `Validation failed` oder `Validation failed (--strict treats warnings as errors)` | Ein Fehler, oder eine Warnung unter `--strict` |

592| `2` | `Unexpected error during validation: <reason>` | Der Validator selbst ist fehlgeschlagen, wie bei einem unlesbaren Pfad |

593

594Mit `--json` schreibt Claude Code den Bericht auf stdout als ein JSON-Objekt mit diesen Top-Level-Feldern:

595

596* `success`: das gleiche Urteil, das der Exit-Code gibt

597* `strict`: ob der Lauf Warnungen als Fehler behandelt hat

598* `target`: der aufgelöste Pfad, den Claude Code validiert hat

599* `manifest`: das eigene Ergebnis des Manifests, oder `null` für einen Lauf ohne Manifest

600* `contents`: Pro-Datei-Ergebnisse, jede benennend ihre `file` und tragend `errors`-, `warnings`- und `notes`-Arrays

601

602Bei Exit `2` schreibt der Befehl nichts auf stdout. Die Fehlermeldung geht auf stderr.

603

604<h2 id="claude-plugin-marketplace-commands">

605 claude plugin marketplace-Befehle

606</h2>

607

608Führen Sie `claude plugin marketplace <subcommand>` aus Ihrer Shell aus, um die Marktplätze, von denen Sie Plugins installieren, hinzuzufügen, aufzulisten, zu aktualisieren und zu entfernen.

609

610* **Exit-Codes**: diese Unterbefehle folgen der [Exit-Code-Konvention](#claude-plugin-commands) der Plugin-Befehle

611* **Bereiche**: ihr `--scope`-Flag hat keine `-s`-Kurzform

612

613Für das, was ein Marktplatz ist und wie Claude Code ihn zwischenspeichert, siehe [Plugin-Ladeverzeichnis](/docs/de/plugins/loading).

614

615<h3 id="plugin-marketplace-add">

616 plugin marketplace add

617</h3>

618

619Fügen Sie einen Marktplatz von einem GitHub-Repository, einer git-URL, einem gehosteten `marketplace.json` oder einem lokalen Pfad hinzu, und deklarieren Sie ihn in einer Einstellungsdatei.

620

621Nachdem Sie ihn hinzugefügt haben, installiert Claude Code alle [Abhängigkeiten](/docs/de/plugins/dependencies), die Ihre installierten Plugins vermisst haben.

622

623```bash theme={null}

624claude plugin marketplace add <source> [options]

625```

626

627| Flag | Beschreibung |

628| :- | :- |

629| `--scope <scope>` | Einstellungsdatei zum Deklarieren des Marktplatzes: `user`, `project` oder `local`. Standardwert ist `user` |

630| `--sparse <paths...>` | Begrenzen Sie den git-Checkout auf diese Verzeichnisse, für Monorepos. Nur `github`- und `git`-Quellen |

631| `--claudeai` | Lesen Sie das Argument als den Namen eines [auf claude.ai gehosteten Marktplatzes](/docs/de/plugins/install#add-from-claude-ai) statt einer Quelle. Erfordert Claude Code v2.1.273 oder später |

632

633`<source>` nimmt jede der Formen in der Tabelle unten, und seine Form entscheidet den Quellentyp und wie Claude Code den Marktplatz abruft. Für das resultierende Quellobjekt siehe die [Marktplatz-Referenz](/docs/de/plugins/marketplace-reference).

634

635| Sie tippen | Quellentyp | Wie Claude Code ihn abruft |

636| :- | :- | :- |

637| `owner/repo`, `owner/repo#ref` oder `owner/repo@ref` | `github` | Klont das GitHub-Repository, angeheftet an `ref`, wenn gegeben. Besitzer und Repo müssen GitHub-Benennungsregeln folgen |

638| `user@host:path[.git][#ref]` | `git` | Klont über SSH |

639| `https://example.com/repo.git[#ref]` oder eine URL mit `/_git/` | `git` | Klont über HTTPS, einschließlich Azure DevOps-URLs |

640| `https://github.com/owner/repo` oder `https://gitlab.com/namespace/project` | `git` | Klont über HTTPS nach dem Anhängen von `.git` |

641| Jede andere `http://`- oder `https://`-URL, einschließlich eines selbstgehosteten git-Hosts ohne `.git` | `url` | Ruft die URL als `marketplace.json` ab. Um stattdessen ein Repository dort zu klonen, hängen Sie `.git` an |

642| `./path`, `../path`, `/path` oder `~/path` zu einem Verzeichnis | `directory` | Liest das Verzeichnis an Ort und Stelle. Unter Windows funktionieren auch `.\`, `..\` und `C:\`-Formen |

643| Die gleichen Pfadformen, zu einer `.json`-Datei | `file` | Liest die Datei an Ort und Stelle |

644

645Für einen Host, dessen Klon-URLs das `.git`-Suffix nicht tragen, wie AWS CodeCommit, fügen Sie den Marktplatz stattdessen als git-Eintrag in [`extraKnownMarketplaces`](/docs/de/settings-reference#extraknownmarketplaces) hinzu. Claude Code klont einen git-Eintrag, ob seine URL mit `.git` endet oder nicht.

646

647Claude Code klont auch eine `gitlab.com`-URL mit verschachtelten Untergruppen, wie `https://gitlab.com/group/subgroup/project`.

648

649Fügen Sie einen Marktplatz hinzu und teilen Sie ihn mit dem Projekt:

650

651```bash theme={null}

652claude plugin marketplace add your-org/your-marketplace --scope project

653```

654

655Claude Code druckt `Successfully added marketplace: your-marketplace (declared in project settings)`, wobei der `name` aus dem eigenen Manifest des Marktplatzes verwendet wird. Ein wiederholtes Hinzufügen oder eine ungültige Quelle druckt stattdessen eines dieser Ergebnisse:

656

657* **Marktplatz bereits auf der Festplatte**: die Ausgabe ist `Marketplace 'your-marketplace' already on disk — declared in project settings` und der Exit-Code ist `0`

658* **Unerkannte Quelle**: die Ausgabe ist `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` und der Exit-Code ist `1`

659* **Bloßer Host wie `gitlab.example.com/team/plugins`**: das Hinzufügen schlägt als ungültige `owner/repo`-Kurzform fehl, und die Meldung sagt Ihnen, `https://` hinzuzufügen oder einen lokalen Pfad zu verwenden

660

661Fügen Sie einen [auf claude.ai gehosteten Marktplatz](/docs/de/plugins/install#add-from-claude-ai) nach dem Namen hinzu, der im `From claude.ai:`-Abschnitt von `claude plugin marketplace list` gedruckt wird:

662

663```bash theme={null}

664claude plugin marketplace add --claudeai claudeai-organization-library

665```

666

667Mit `--claudeai` weigert sich der Befehl, `--scope` und `--sparse` zu akzeptieren. Der Marktplatz wird für Ihr Konto gehostet, nicht in einer Einstellungsdatei deklariert, sodass Sie ihn nicht durch das `.claude/settings.json` eines Projekts teilen können.

668

669<h3 id="plugin-marketplace-list">

670 plugin marketplace list

671</h3>

672

673Listet jeden Marktplatz auf, den Sie hinzugefügt haben, mit seiner Quelle.

674

675```bash theme={null}

676claude plugin marketplace list [options]

677```

678

679| Flag | Beschreibung |

680| :- | :- |

681| `--json` | Drucken Sie die Liste als JSON |

682

683Claude Code druckt `Configured marketplaces:` und eine `Source:`-Zeile pro Marktplatz, oder `No marketplaces configured`.

684

685Mit `--json` druckt Claude Code ein Array mit einem Objekt pro Marktplatz, tragend die unten aufgelisteten Felder. Jedes Feld ist ein string.

686

687| Feld | Beschreibung |

688| :- | :- |

689| `name` | Der Name des Marktplatzes |

690| `source` | `github`, `git`, `url`, `directory`, `file` oder `claudeai` |

691| `repo` | `owner/repo`. Nur `github`-Quellen |

692| `url` | Die Klon- oder Abruf-URL. Nur `git`- und `url`-Quellen |

693| `path` | Der lokale Pfad. Nur `directory`- und `file`-Quellen |

694| `ref` | Der angeheftete Branch oder Tag. Nur `github`- und `git`-Quellen, wenn angeheftet |

695| `installLocation` | Wo Claude Code den Marktplatz zwischengespeichert hat |

696

697Ein hinzugefügter [claude.ai-Marktplatz](/docs/de/plugins/install#add-from-claude-ai) hat keinen lokalen Klon, sodass sein Eintrag seine claude.ai-Identifikatoren, `marketplaceId` und `organizationUuid`, anstelle von `installLocation` trägt. Er trägt auch `scope`, wenn einer aufgezeichnet ist, und `status`.

698

699Wenn Ihre Terminal-Sitzungen [Plugins von Ihrem claude.ai-Konto synchronisieren](/docs/de/plugins/loading#synced-plugins), endet die Text-Auflistung mit einem `From claude.ai:`-Abschnitt. Dieser Abschnitt nennt die Marktplätze, die claude.ai für Ihr Konto auflistet, die Sie nicht hinzugefügt haben, sowohl git-basiert als auch gehostet. Er erfordert Claude Code v2.1.273 oder später.

700

701Um einen Marktplatz aus diesem Abschnitt hinzuzufügen, siehe [Marktplatz von claude.ai hinzufügen](/docs/de/plugins/install#add-from-claude-ai).

702

703Die `--json`-Ausgabe deckt nur konfigurierte Marktplätze ab und lässt den Abschnitt weg.

704

705<h3 id="plugin-marketplace-remove">

706 plugin marketplace remove

707</h3>

708

709Entfernen Sie die Deklaration eines Marktplatzes aus Ihren Einstellungen. `rm` ist ein Alias für `remove`.

710

711<Warning>

712 Wenn Sie einen Marktplatz aus dem letzten Bereich entfernen, der ihn deklariert, löscht Claude Code auch seinen Cache und deinstalliert jedes Plugin, das Sie von ihm installiert haben. Ohne `--scope` entfernt der Befehl die Deklaration aus jedem Bereich. Um einen Marktplatz zu aktualisieren, ohne seine Plugins zu verlieren, führen Sie stattdessen `plugin marketplace update` aus.

713</Warning>

714

715```bash theme={null}

716claude plugin marketplace remove <name> [options]

717```

718

719Der `<name>` ist der Marktplatz-Name, den `plugin marketplace list` zeigt, nicht die Quelle, die Sie an `add` übergeben haben.

720

721| Flag | Beschreibung |

722| :- | :- |

723| `--scope <scope>` | Entfernen Sie die Deklaration aus einem Einstellungsbereich: `user`, `project` oder `local`. Ohne ihn entfernt Claude Code die Deklaration aus jedem Bereich |

724

725Entfernen Sie einen Marktplatz aus jedem Bereich:

726

727```bash theme={null}

728claude plugin marketplace remove your-marketplace

729```

730

731Claude Code druckt `Successfully removed marketplace: your-marketplace`, fügt `(from project settings)` hinzu, wenn Sie ihn scoped haben. Wenn Sie einen Bereich scopen, der den Marktplatz nicht deklariert, schlägt der Befehl fehl mit `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`

732

733<h3 id="plugin-marketplace-update">

734 plugin marketplace update

735</h3>

736

737Aktualisieren Sie einen Marktplatz oder jeden Marktplatz von seiner Quelle, um neue Plugins und Versionen abzurufen. Ein Marktplatz, der mit einem Branch oder Tag `ref` hinzugefügt wurde, wird auf den neuesten Commit dieses Refs aktualisiert, nicht auf den Standard-Branch des Repositorys.

738

739```bash theme={null}

740claude plugin marketplace update [name]

741```

742

743Der Befehl nimmt keine Flags außer `--help`.

744

745Aktualisieren Sie einen Marktplatz:

746

747```bash theme={null}

748claude plugin marketplace update your-marketplace

749```

750

751Claude Code druckt `Successfully updated marketplace: your-marketplace`. Wenn Sie den Namen weglassen, druckt es eine Anzahl wie `Successfully updated 2 marketplaces`. Ohne hinzugefügte Marktplätze druckt es `No marketplaces configured` und beendet sich mit `0`.

752

753<h2 id="plugin-in-a-session">

754 /plugin in einer Sitzung

755</h2>

756

757Innerhalb einer interaktiven Sitzung öffnet `/plugin` das Plugin-Panel. Jeder Unterbefehl öffnet das Panel auf einem Tab, führt eine Aktion dort aus oder druckt ein Ergebnis inline. `/plugins` und `/marketplace` sind Aliase für `/plugin`.

758

759Sie können diese Befehle nur in einer interaktiven Terminal-Sitzung ausführen. In einem nicht-interaktiven Lauf wie `claude -p` antwortet Claude Code, dass `/plugin` in dieser Umgebung nicht verfügbar ist.

760

761Für welche Oberflächen `/plugin` haben, wie man ohne es installiert, und was jeder Panel-Tab zeigt, siehe [Plugins installieren und verwalten](/docs/de/plugins/install).

762

763Ein `<plugin>` ist ein Plugin-`name` oder `name@marketplace`.

764

765Die Tabelle unten listet jede Sitzungsform auf. Die Shell-Unterbefehle `init`, `update`, `details`, `prune`, `eval` und `eval init` haben keine Sitzungsform.

766

767| Befehl | Aliase | Was er tut |

768| :- | :- | :- |

769| `/plugin` | | Öffnet das Panel auf dem **Discover**-Tab. Jedes unerkannte erste Wort nach `/plugin` tut das gleiche |

770| `/plugin help` | `/plugin --help`, `/plugin -h` | Zeigt die Nutzungsliste der `/plugin`-Unterbefehle |

771| `/plugin list [--enabled\|--disabled]` | `ls` | Druckt Ihre Marktplatz-installierten Plugins inline, mit Version, Bereich und Status. Ein Filter-Flag zeigt nur diesen Status. Ein Plugin, dessen Aktivierungsstatus noch nicht angewendet wurde, ist mit `— run /reload-plugins to apply` gekennzeichnet. Erfordert Claude Code v2.1.163 oder später |

772| `/plugin install` | `i` | Öffnet den **Discover**-Tab |

773| `/plugin install <plugin>` | `i` | Öffnet die Details des Plugins im **Discover**-Tab. Mit `name@marketplace` öffnet sie in der Liste dieses Marktplatzes |

774| `/plugin install <plugin> --marketplace <source>` | `i` | Fügt den Marktplatz unter `<source>` hinzu, wenn Sie ihn noch nicht hinzugefügt haben, und fragt Sie zuerst zur Bestätigung auf, dann öffnet die Details des Plugins. Siehe [Marktplatz hinzufügen und in einem Befehl installieren](/docs/de/plugins/install#add-a-marketplace-and-install-in-one-command). Erfordert Claude Code v2.1.275 oder später |

775| `/plugin manage` | | Öffnet den **Installed**-Tab |

776| `/plugin stats` | | Öffnet den **Stats**-Tab, in Sitzungen, wo [`/skill-doctor`](/docs/de/skills#find-unused-skills) verfügbar ist. Überall sonst öffnet es das Panel auf dem **Discover**-Tab |

777| `/plugin enable <plugin>` | | Öffnet den **Installed**-Tab beim Plugin und aktiviert es |

778| `/plugin disable <plugin>` | | Öffnet den **Installed**-Tab beim Plugin und deaktiviert es |

779| `/plugin uninstall <plugin>` | | Öffnet den **Installed**-Tab beim Plugin und deinstalliert es |

780| `/plugin configure <plugin>` | `config` | Öffnet den [`userConfig`](/docs/de/plugins/manifest-reference)-Dialog des Plugins, oder meldet, dass das Plugin keinen deklariert. Erfordert Claude Code v2.1.147 oder später |

781| `/plugin validate <path>` | | Druckt den gleichen Bericht wie `claude plugin validate`, inline |

782| `/plugin tag [path] [--push] [--dry-run] [--force]` | | Erstellt das Release-Tag wie `claude plugin tag`. Akzeptiert `--push`, `--dry-run` und `--force` oder `-f`; mit jedem anderen Flag oder einem zusätzlichen Argument druckt Claude Code stattdessen die Nutzung |

783| `/plugin marketplace` | `market` | Tut nichts Sichtbares. Übergeben Sie `add`, `list`, `update` oder `remove` |

784| `/plugin marketplace add [source]` | `market add` | Mit einer Quelle fügt sie sie hinzu und meldet das Ergebnis. Ohne eine öffnet sie die **Add marketplace**-Eingabe |

785| `/plugin marketplace list` | `market list` | Druckt Ihre Marktplatz-Namen inline |

786| `/plugin marketplace update [name]` | `market update` | Öffnet den **Marketplaces**-Tab. Mit einem Namen aktualisiert sie diesen Marktplatz dort |

787| `/plugin marketplace remove [name]` | `market remove`, `market rm`, `marketplace rm` | Öffnet den **Marketplaces**-Tab. Mit einem Namen entfernt sie diesen Marktplatz dort |

788

789Wenn Sie ein Plugin benennen, das nicht im aktuellen Projekt installiert ist, in `/plugin enable`, `disable`, `uninstall` oder `configure`, druckt Claude Code stattdessen `Plugin "<plugin>" is not installed in this project`.

790

791<h2 id="reload-plugins">

792 /reload-plugins

793</h2>

794

795Wenden Sie ausstehende Plugin-Änderungen auf die laufende Sitzung an, ohne sie neu zu starten. Ausstehende Änderungen sind Plugins, die Sie seit dem Start der Sitzung installiert, aktualisiert, aktiviert, deaktiviert oder auf der Festplatte bearbeitet haben.

796

797Wenn Sie das `/plugin`-Panel mit ausstehenden Änderungen schließen, die Sie darin vorgenommen haben, führt Claude Code `/reload-plugins` für Sie aus. Führen Sie es selbst nach Plugin-Änderungen aus, die außerhalb des Panels stattfinden, wie ein `claude plugin`-Befehl, den Sie in einem anderen Terminal ausgeführt haben.

798

799```text theme={null}

800/reload-plugins [--force]

801```

802

803| Flag | Beschreibung |

804| :- | :- |

805| `--force` | Wenden Sie das Neuladen an, auch wenn es den Prompt-Cache ungültig machen würde. `force` ohne Bindestriche funktioniert auch |

806

807<h3 id="reload-summary">

808 Neuladen-Zusammenfassung

809</h3>

810

811Claude Code lädt jedes aktive Plugin neu und druckt eine Zusammenfassungszeile, `Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers`, wobei die Plugin-MCP-Server-Anzahl in einer Sitzung ohne interaktives Terminal weggelassen wird. Wenn ein Plugin fehlgeschlagen ist, fügt die Zusammenfassung `N errors during load. Run /plugin for details.` hinzu.

812

813Die Skills-Anzahl deckt jeden Skill ab, den ein Plugin bereitstellt, sowohl seine `commands/`-Einträge als auch seine SKILL.md-Skills. Die Agents-Anzahl ist die Anzahl der in der Sitzung geladenen Agents, einschließlich derjenigen, die nicht von Plugins stammen.

814

815Wenn die [Abhängigkeiten](/docs/de/plugins/dependencies) eines neu geladenen Plugins fehlen, installiert Claude Code sie, lädt erneut und hängt `(+ N dependencies: <names>) resolved` an die Zusammenfassung an.

816

817<h3 id="reloads-that-change-mcp-tools">

818 Neuladungen, die MCP-Tools ändern

819</h3>

820

821Wenn das Neuladen einen Plugin-MCP-Server oder das `LSP`-Tool hinzufügen oder entfernen würde, und diese Änderung würde den [Prompt-Cache](/docs/de/prompt-caching#enabling-or-disabling-a-plugin) ungültig machen, wendet Claude Code das Neuladen nicht an. Es druckt eine Zeile wie `This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.` Übergeben Sie `--force`, um es trotzdem anzuwenden.

822

823<h3 id="sessions-without-an-interactive-terminal">

824 Sitzungen ohne interaktives Terminal

825</h3>

826

827`/reload-plugins` läuft auch in Sitzungen ohne interaktives Terminal, wie die Desktop-App, das Agent SDK und [nicht-interaktiver Modus](/docs/de/headless) mit `-p`. Erfordert Claude Code v2.1.260 oder später.

828

829In diesen Sitzungen läuft der Befehl nur, wenn Sie ihn selbst in die Sitzung eingeben, wie in der `-p`-Eingabeaufforderung oder dem Eingabefeld der Desktop-App. Wenn er auf andere Weise ankommt, wie durch [Remote Control](/docs/de/remote-control) oder eine von Slack weitergeleitet Meldung, antwortet der Befehl `/reload-plugins isn't available over a remote connection in this session.` und lädt nichts neu.

830

831Das Neuladen in diesen Sitzungen verbindet oder trennt Plugin-MCP-Server nicht. Diese Änderungen treten in Ihrer nächsten Sitzung in Kraft.

832

833<h2 id="flags-that-load-a-plugin-for-one-session">

834 Flags, die ein Plugin für eine Sitzung laden

835</h2>

836

837Zwei `claude`-Flags laden ein Plugin für eine Sitzung nur, ohne es zu installieren. Beide sind wiederholbar.

838

839Plugin-Autoren verwenden sie, um ein Plugin vor der Veröffentlichung zu testen. Für den Laden-Bearbeiten-Neuladen-Workflow siehe [Entwickeln ohne einen Marktplatz](/docs/de/plugins/create#develop-without-a-marketplace).

840

841| Flag | Beschreibung | Beispiel |

842| :- | :- | :- |

843| `--plugin-dir <path>` | Laden Sie ein Plugin aus einem Verzeichnis oder einem `.zip`-Archiv davon. Ein Ordner von Plugins lädt jeden Unterordner, der ein `.claude-plugin/plugin.json` hält. Jedes Flag nimmt einen Pfad | `claude --plugin-dir ./my-plugin --plugin-dir ./other.zip` |

844| `--plugin-url <url>` | Rufen Sie ein Plugin `.zip`-Archiv von einer URL ab. Wiederholen Sie das Flag, oder übergeben Sie mehrere URLs durch Leerzeichen getrennt in einem angeführten Wert | `claude --plugin-url "https://example.com/a.zip https://example.com/b.zip"` |

845

846Ein Plugin, das eines dieser Flags lädt, ist ein Sitzungs-Plugin. `claude plugin list` zeigt es als `<name>@inline` mit Bereich `session`, aber nur wenn das gleiche Flag dem Unterbefehl vorausgeht. Zum Beispiel führen Sie `claude --plugin-dir ./my-plugin plugin list` aus.

847

848Wenn ein Sitzungs-Plugin einen Namen mit einem installierten Plugin teilt, lädt Claude Code die Sitzungs-Kopie für diese Sitzung und überspringt die installierte. Die installierte Kopie wird stattdessen geladen, wenn Sie die Sitzungs-Kopie mit `claude plugin disable <name>@inline` deaktiviert haben, oder wenn verwaltete Einstellungen diesen Plugin-Namen sperren. Für den Vorrang siehe [Plugin-Ladeverzeichnis](/docs/de/plugins/loading).

849

850Ein Administrator kann beide Flags und Ordner, die in der [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/de/env-vars#variables)-Variable benannt sind, mit der verwalteten [`disableSideloadFlags`](/docs/de/settings-reference#disablesideloadflags)-Einstellung ablehnen. Claude Code druckt dann, dass das Flag durch die verwalteten Einstellungen Ihrer Organisation deaktiviert ist, und beendet sich mit `1` ohne zu starten.

851

852Aus dem Agent SDK ist die [`plugins`](/docs/de/agent-sdk/plugins)-Option das Äquivalent von `--plugin-dir`.

853

854<h2 id="next-steps">

855 Nächste Schritte

856</h2>

857

858* [Plugins installieren und verwalten](/docs/de/plugins/install): die gleichen Operationen wie Schritte, mit dem, was Sie bei jedem sehen

859* [Plugin-Ladeverweis](/docs/de/plugins/loading): was jeder Befehl auf der Festplatte ändert und welcher Bereich wirksam wird

860* [Plugins Fehlerbehebung](/docs/de/plugins/troubleshooting): Installations-, Marketplace-, Lade- und Validierungsfehlermeldungen mit ihren Lösungen

861* [Plugin-Manifest-Verweis](/docs/de/plugins/manifest-reference): die Felder, die `claude plugin validate` überprüft

plugins/components.md +4 −4

Details

413 413

414 * **Ihr erstes Plugin erstellen**: Beginnen Sie mit [Plugin erstellen](/docs/de/plugins/create)414 * **Ihr erstes Plugin erstellen**: Beginnen Sie mit [Plugin erstellen](/docs/de/plugins/create)

415 * **Plugin von jemand anderem installieren**: Siehe [Plugins installieren](/docs/de/plugins/install)415 * **Plugin von jemand anderem installieren**: Siehe [Plugins installieren](/docs/de/plugins/install)

416 * **Ihre Plugin-Benutzer sind auf claude.ai oder in Cowork**: Ein anderer Satz von Komponenten wird dort geladen. Siehe [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview)416 * **Ihre Plugin-Benutzer sind auf claude.ai oder in Cowork**: Ein anderer Satz von Komponenten wird dort geladen. Siehe [Plugin-Struktur und Tests](https://claude.com/docs/plugins/build) und die [Komponentenunterstützungstabelle](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)

417</Note>417</Note>

418 418

419<h2 id="explore-the-plugin-directory">419<h2 id="explore-the-plugin-directory">

436 436

437<PluginExplorer>437<PluginExplorer>

438 <Piece id="manifest">438 <Piece id="manifest">

439 Das [Manifest](/docs/de/plugins/manifest-reference) ist die `plugin.json`-Datei im `.claude-plugin/`-Verzeichnis eines Plugins. Sie enthält die Metadaten des Plugins und die `userConfig`-Werte, die Claude Code den Benutzer fragt. Nur `name` ist erforderlich. In diesem Fall ist `description` der Text, den Benutzer für das Plugin in `/plugin` sehen, und `version` hält Benutzer auf dieser Version, bis Sie sie ändern:439 Das [Manifest](/docs/de/plugins/manifest-reference) ist die `plugin.json`-Datei im `.claude-plugin/`-Verzeichnis eines Plugins. Sie enthält die Metadaten des Plugins und die `userConfig`-Werte, die Claude Code den Benutzer fragt. Claude Code lädt ein Plugin ohne eines, aber [Anthropics Verzeichnis](/docs/de/plugins/publish#submit-to-anthropics-directory) erfordert es. In der Datei ist nur `name` erforderlich. In diesem Fall ist `description` der Text, den Benutzer für das Plugin in `/plugin` sehen, und `version` hält Benutzer auf dieser Version, bis Sie sie ändern:

440 440

441 ```json theme={null}441 ```json theme={null}

442 {442 {

838 Erreichen Sie Benutzer auf claude.ai und Cowork838 Erreichen Sie Benutzer auf claude.ai und Cowork

839</h4>839</h4>

840 840

841Ein lokaler Stdio-Server, wie der `db`-Server unter [MCP-Server](#mcp-servers), läuft in Claude Code und in einer Cowork-Sitzung, die auf Ihrem Computer in der Claude Desktop-App läuft, aber nicht auf claude.ai. Um Benutzer dort auch zu erreichen, referenzieren Sie einen Remote-Server durch seine `https://`-URL, die claude.ai und Cowork dem Benutzer als Connector anbieten.841Ein lokaler Stdio-Server, wie der `db`-Server unter [MCP-Server](#mcp-servers), läuft in Claude Code und in einer Cowork-Sitzung, die auf Ihrem Computer in der Claude Desktop-App läuft, aber nicht auf claude.ai. Um Benutzer dort auch zu erreichen, referenzieren Sie einen Remote-Server durch seine `https://`-URL, die claude.ai und Cowork dem Benutzer als Connector anbieten, wie [Bündeln Sie einen MCP-Connector mit seinem Skill](https://claude.com/docs/plugins/build#bundle-an-mcp-connector-with-its-skill) zeigt.

842 842

843<h4 id="server-names-tool-names-and-reloads">843<h4 id="server-names-tool-names-and-reloads">

844 Server-Namen, Tool-Namen und Neuladen844 Server-Namen, Tool-Namen und Neuladen

918 918

919Plugin-`bin/`-Verzeichnisse kommen nach den eigenen `PATH`-Einträgen des Benutzers, daher kann ein Plugin nicht `git`, `ls` oder einen anderen System-Befehl überschatten.919Plugin-`bin/`-Verzeichnisse kommen nach den eigenen `PATH`-Einträgen des Benutzers, daher kann ein Plugin nicht `git`, `ls` oder einen anderen System-Befehl überschatten.

920 920

921claude.ai und Cowork installieren kein Plugin, das ein Top-Level-`bin/`-Verzeichnis hat, einschließlich eines, das Sie [über claude.ai-Organisationseinstellungen verteilen](/docs/de/plugins/host-marketplace#distribute-through-organization-settings).921claude.ai und Cowork installieren kein Plugin, das ein Top-Level-`bin/`-Verzeichnis hat, einschließlich eines, das Sie [über claude.ai-Organisationseinstellungen verteilen](https://claude.com/docs/plugins/org-sync#keep-executables-out-of-the-top-level-bin-directory).

922 922

923<h3 id="default-settings">923<h3 id="default-settings">

924 Standard-Einstellungen924 Standard-Einstellungen

plugins/create.md +8 −4

Details

15 15

16 * **Installation eines Plugins von jemand anderem**: siehe [Plugins installieren](/docs/de/plugins/install)16 * **Installation eines Plugins von jemand anderem**: siehe [Plugins installieren](/docs/de/plugins/install)

17 * **Sie sind sich nicht sicher, ob Sie ein Plugin benötigen**: siehe [Entscheiden Sie, ob Sie ein Plugin benötigen](/docs/de/plugins/overview#decide-whether-you-need-a-plugin) in der Übersicht17 * **Sie sind sich nicht sicher, ob Sie ein Plugin benötigen**: siehe [Entscheiden Sie, ob Sie ein Plugin benötigen](/docs/de/plugins/overview#decide-whether-you-need-a-plugin) in der Übersicht

18 * **Die Benutzer Ihres Plugins sind auf claude.ai oder in Cowork**: derselbe Ordner wird dort mit einer anderen Teilmenge von Komponenten installiert. Siehe [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview)18 * **Die Benutzer Ihres Plugins sind auf claude.ai oder in Cowork**: derselbe Ordner wird dort mit einer anderen Teilmenge von Komponenten installiert. Siehe [Plugin-Struktur und Tests](https://claude.com/docs/plugins/build) und die [Komponentenunterstützungstabelle](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)

19</Note>19</Note>

20 20

21Beginnen Sie mit dem Abschnitt, der dem entspricht, was Sie bereits haben:21Beginnen Sie mit dem Abschnitt, der dem entspricht, was Sie bereits haben:

132 132

133Das Plugin wird nur in Sitzungen geladen, die Sie mit `--plugin-dir` starten. Um weiterhin daran zu arbeiten, ohne das Flag zu verwenden, oder um einen `.zip`-Build zu testen, siehe [Entwickeln Sie ohne einen Marketplace](#develop-without-a-marketplace).133Das Plugin wird nur in Sitzungen geladen, die Sie mit `--plugin-dir` starten. Um weiterhin daran zu arbeiten, ohne das Flag zu verwenden, oder um einen `.zip`-Build zu testen, siehe [Entwickeln Sie ohne einen Marketplace](#develop-without-a-marketplace).

134 134

135Um Claude ein größeres Plugin mit Ihnen zu erstellen, [installieren](/docs/de/plugins/install#install-a-plugin) Sie Anthropics `plugin-dev`-Plugin aus dem `claude-plugins-official`-Marketplace, das Skills und Agents zum Schreiben von Komponenten wie Skills, Hooks und MCP-Servern sowie zum Validieren des fertigen Plugins hinzufügt. Sobald es installiert ist, führen Sie `/plugin-dev:create-plugin` gefolgt von einer Beschreibung des Plugins aus, das Sie möchten, und Claude führt Sie durch das Entwerfen, Erstellen und Validieren.

136

135<h3 id="share-the-plugin">137<h3 id="share-the-plugin">

136 Teilen Sie Ihr Plugin138 Teilen Sie Ihr Plugin

137</h3>139</h3>

140 142

141* **Senden Sie es direkt an ein paar Personen**: geben Sie ihnen das Plugin-Verzeichnis oder eine `.zip` davon, und nichts muss veröffentlicht werden. Siehe [Teilen Sie ein Plugin ohne einen Marketplace](/docs/de/plugins/publish#share-a-plugin-without-a-marketplace).143* **Senden Sie es direkt an ein paar Personen**: geben Sie ihnen das Plugin-Verzeichnis oder eine `.zip` davon, und nichts muss veröffentlicht werden. Siehe [Teilen Sie ein Plugin ohne einen Marketplace](/docs/de/plugins/publish#share-a-plugin-without-a-marketplace).

142* **Listen Sie es in Ihrem eigenen Marketplace auf**: Teamkollegen fügen Ihren Marketplace einmal hinzu und installieren das Plugin nach Name, und sie erhalten Ihre Updates. Siehe [Veröffentlichen Sie über Ihren eigenen Marketplace](/docs/de/plugins/publish#publish-through-your-own-marketplace).144* **Listen Sie es in Ihrem eigenen Marketplace auf**: Teamkollegen fügen Ihren Marketplace einmal hinzu und installieren das Plugin nach Name, und sie erhalten Ihre Updates. Siehe [Veröffentlichen Sie über Ihren eigenen Marketplace](/docs/de/plugins/publish#publish-through-your-own-marketplace).

143* **Reichen Sie es bei Anthropics Community-Marketplace ein**: Sobald es aufgelistet ist, kann jeder, der diesen Marketplace hinzufügt, es installieren. Siehe [Reichen Sie beim Community-Marketplace ein](/docs/de/plugins/publish#submit-to-the-community-marketplace).145* **Reichen Sie es bei Anthropics Verzeichnis ein**: Nachdem es die Überprüfung bestanden hat, können Personen es auf claude.ai und in Cowork hinzufügen, und es erreicht Claude Code über ihr Konto. Siehe [Reichen Sie bei Anthropics Verzeichnis ein](/docs/de/plugins/publish#submit-to-anthropics-directory).

144 146

145<h3 id="plugin-layout">147<h3 id="plugin-layout">

146 Plugin-Layout148 Plugin-Layout

201 203

202Wenn der Ordner kein `.claude-plugin/`-Verzeichnis und keine Plugin-Komponenten auf seiner obersten Ebene hat, behandelt Claude Code ihn als einen Ordner mit Plugins. Jeder unmittelbare Unterordner, der ein `.claude-plugin/plugin.json`-Manifest hat, wird dann als separates Plugin geladen. Alles andere im Ordner wird ohne Fehler übersprungen, einschließlich eines Unterordners, der kein Manifest hat. Wenn ein Plugin im Ordner nicht geladen wird, überprüfen Sie, dass sein Unterordner ein `.claude-plugin/plugin.json` hat.204Wenn der Ordner kein `.claude-plugin/`-Verzeichnis und keine Plugin-Komponenten auf seiner obersten Ebene hat, behandelt Claude Code ihn als einen Ordner mit Plugins. Jeder unmittelbare Unterordner, der ein `.claude-plugin/plugin.json`-Manifest hat, wird dann als separates Plugin geladen. Alles andere im Ordner wird ohne Fehler übersprungen, einschließlich eines Unterordners, der kein Manifest hat. Wenn ein Plugin im Ordner nicht geladen wird, überprüfen Sie, dass sein Unterordner ein `.claude-plugin/plugin.json` hat.

203 205

206Sie können auch einen Ordner übergeben, der eine `.claude-plugin/marketplace.json` neben seinen Plugin-Ordnern behält. Solange dieses `.claude-plugin/`-Verzeichnis keine `plugin.json` enthält, werden die Plugin-Ordner weiterhin geladen. Nichts wird aus der Marketplace-Datei installiert oder aktiviert, da Claude Code sie nicht liest. Das Laden von Plugins aus einem solchen Ordner erfordert Claude Code v2.1.281 oder später.

207

204In einer interaktiven Sitzung können Sie auch Plugins im Ordner nach dem Start hinzufügen und entfernen:208In einer interaktiven Sitzung können Sie auch Plugins im Ordner nach dem Start hinzufügen und entfernen:

205 209

206* Ein Unterordner, den Sie hinzufügen, wird als neues Plugin geladen, sobald sein Manifest vorhanden ist.210* Ein Unterordner, den Sie hinzufügen, wird als neues Plugin geladen, sobald sein Manifest vorhanden ist.

417 421

418* [Plugin-Komponenten](/docs/de/plugins/components): fügen Sie Agents, Hooks, MCP-Server, LSP-Server und Benutzerkonfiguration zu Ihrem Plugin hinzu422* [Plugin-Komponenten](/docs/de/plugins/components): fügen Sie Agents, Hooks, MCP-Server, LSP-Server und Benutzerkonfiguration zu Ihrem Plugin hinzu

419* [Testen Sie Plugins mit Evals](/docs/de/plugin-evals): schreiben Sie Eval-Fälle und führen Sie sie mit `claude plugin eval` aus, um zu überprüfen, wie zuverlässig das Plugin Claudes Verhalten steuert423* [Testen Sie Plugins mit Evals](/docs/de/plugin-evals): schreiben Sie Eval-Fälle und führen Sie sie mit `claude plugin eval` aus, um zu überprüfen, wie zuverlässig das Plugin Claudes Verhalten steuert

420* [Veröffentlichen Sie ein Plugin](/docs/de/plugins/publish): versionieren Sie es, setzen Sie es in einen Marketplace und reichen Sie es beim Community-Marketplace ein424* [Veröffentlichen Sie ein Plugin](/docs/de/plugins/publish): versionieren Sie es, setzen Sie es in einen Marketplace und reichen Sie es zur Überprüfung ein

421* [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview): derselbe Plugin-Ordner wird auf claude.ai und in Cowork installiert. Einige Komponenten sind nur für Claude Code425* [Plugin-Struktur und Tests](https://claude.com/docs/plugins/build): derselbe Plugin-Ordner wird auf claude.ai und in Cowork installiert. Einige Komponenten sind nur für Claude Code verfügbar, und die [Komponentenunterstützungstabelle](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) listet auf, welche auf jeder Oberfläche geladen werden

422* [Plugin-Manifest-Referenz](/docs/de/plugins/manifest-reference): jedes `plugin.json`-Feld, jede Pfadregel und jedes Verzeichnis426* [Plugin-Manifest-Referenz](/docs/de/plugins/manifest-reference): jedes `plugin.json`-Feld, jede Pfadregel und jedes Verzeichnis

423* [Skills](/docs/de/skills): schreiben Sie die Skills, die Ihr Plugin bereitstellt427* [Skills](/docs/de/skills): schreiben Sie die Skills, die Ihr Plugin bereitstellt

424* [Anthropics Plugins im claude-code-Repository](https://github.com/anthropics/claude-code/tree/main/plugins): vollständige durchgearbeitete Beispiele des Layouts auf dieser Seite, z. B. `feature-dev` und `code-review`428* [Anthropics Plugins im claude-code-Repository](https://github.com/anthropics/claude-code/tree/main/plugins): vollständige durchgearbeitete Beispiele des Layouts auf dieser Seite, z. B. `feature-dev` und `code-review`

plugins/create-marketplace.md +1 −1

Details

14 Diese Fälle werden auf anderen Seiten behandelt:14 Diese Fälle werden auf anderen Seiten behandelt:

15 15

16 * **Ein Plugin mit wenigen Personen teilen**: Senden Sie ihnen das Plugin-Verzeichnis oder eine `.zip`-Datei davon. Siehe [Ein Plugin ohne Marketplace teilen](/docs/de/plugins/publish#share-a-plugin-without-a-marketplace).16 * **Ein Plugin mit wenigen Personen teilen**: Senden Sie ihnen das Plugin-Verzeichnis oder eine `.zip`-Datei davon. Siehe [Ein Plugin ohne Marketplace teilen](/docs/de/plugins/publish#share-a-plugin-without-a-marketplace).

17 * **Ein Plugin für alle anbieten**: Reichen Sie es im Community-Marketplace von Anthropic ein. Siehe [Im Community-Marketplace einreichen](/docs/de/plugins/publish#submit-to-the-community-marketplace).17 * **Ein Plugin für alle anbieten**: Reichen Sie es im Community-Marketplace von Anthropic ein. Siehe [Im Community-Marketplace einreichen](/docs/de/plugins/publish#submit-to-anthropics-directory).

18 * **Ein Plugin selbst verwenden**: Laden Sie es mit `--plugin-dir` oder speichern Sie es in Ihrem Skills-Verzeichnis. Siehe [Entwickeln ohne Marketplace](/docs/de/plugins/create#develop-without-a-marketplace).18 * **Ein Plugin selbst verwenden**: Laden Sie es mit `--plugin-dir` oder speichern Sie es in Ihrem Skills-Verzeichnis. Siehe [Entwickeln ohne Marketplace](/docs/de/plugins/create#develop-without-a-marketplace).

19</Note>19</Note>

20 20

plugins/host-marketplace.md +3 −3

Details

89Die Organisationssynchronisierung ist strenger in Bezug auf das Repository als `/plugin marketplace add`:89Die Organisationssynchronisierung ist strenger in Bezug auf das Repository als `/plugin marketplace add`:

90 90

91* **Marketplace-Repository**: Auf github.com und gitlab.com muss es privat oder intern sein91* **Marketplace-Repository**: Auf github.com und gitlab.com muss es privat oder intern sein

92* **Plugin-Quellen**: Jede Plugin-Quelle muss vom Typ `github`, `url` oder `git-subdir` sein, oder ein [relativer Pfad](/docs/de/plugins/marketplace-reference#relative-path-plugin-source), der mit `./` beginnt92* **Plugin-Quellen**: Die Organisationssynchronisierung akzeptiert nur einige [Quellentypen](/docs/de/plugins/marketplace-reference#plugin-sources)

93* **Top-Level `bin/`-Verzeichnis**: claude.ai lehnt ein Plugin ab, das eines hat, und synchronisiert den Rest des Marketplace. Die Fehlermeldung beginnt mit `Plugin contains a top-level bin/ directory`. Halten Sie ausführbare Dateien in einem anderen Verzeichnis, wie `scripts/`, und verweisen Sie auf sie als `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` aus Ihren Hooks oder MCP-Server-Konfigurationen93* **Top-Level `bin/`-Verzeichnis**: claude.ai lehnt ein Plugin ab, das eines hat, und synchronisiert den Rest des Marketplace. Die Fehlermeldung beginnt mit `Plugin contains a top-level bin/ directory`. Halten Sie ausführbare Dateien in einem anderen Verzeichnis, wie `scripts/`, und verweisen Sie auf sie als `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` aus Ihren Hooks oder MCP-Server-Konfigurationen

94 94

~~95Siehe [Verwalten Sie Plugins für Ihre Organisation](https://support.claude.com/en/articles/13837433) für den Admin-Workflow.~~95[Synchronisieren Sie die Plugins Ihrer Organisation aus einem Repository](https://claude.com/docs/plugins/org-sync) auf claude.com listet die akzeptierten Quellen, das GitLab-Setup und den `bin/`-Fehler auf, und [Verwalten Sie Plugins für Ihre Organisation](https://claude.com/docs/plugins/admin) behandelt den Admin-Workflow.

96 96

97<h2 id="grant-access-to-a-private-marketplace">97<h2 id="grant-access-to-a-private-marketplace">

98 Gewähren Sie Zugriff auf einen privaten Marketplace98 Gewähren Sie Zugriff auf einen privaten Marketplace

113 113

114Für einen GitHub Enterprise Server-Host benötigen Benutzer Git-Zugriff auf diesen Host von ihrer Maschine. Siehe [Plugin-Marketplaces auf GHES](/docs/de/github-enterprise-server#plugin-marketplaces-on-ghes) für das, was jede Claude Code-Oberfläche benötigt, um einen GHES-gehosteten Marketplace zu erreichen.114Für einen GitHub Enterprise Server-Host benötigen Benutzer Git-Zugriff auf diesen Host von ihrer Maschine. Siehe [Plugin-Marketplaces auf GHES](/docs/de/github-enterprise-server#plugin-marketplaces-on-ghes) für das, was jede Claude Code-Oberfläche benötigt, um einen GHES-gehosteten Marketplace zu erreichen.

115 115

116Wenn Sie stattdessen über **Organisationseinstellungen > Plugins & Skills** auf claude.ai verteilen, sind die Git-Anmeldedaten Ihrer Benutzer nicht beteiligt. Siehe [Verteilen Sie über Organisationseinstellungen](#distribute-through-organization-settings) für welche Plugin-Quellen dort privat sein können.116Wenn Sie stattdessen über **Organisationseinstellungen > Plugins & Skills** auf claude.ai verteilen, sind die Git-Anmeldedaten Ihrer Benutzer nicht beteiligt. Siehe [Verteilen Sie über Organisationseinstellungen](#distribute-through-organization-settings).

117 117

118<h3 id="serve-users-who-have-no-git-host-account">118<h3 id="serve-users-who-have-no-git-host-account">

119 Bedienen Sie Benutzer, die kein Git-Host-Konto haben119 Bedienen Sie Benutzer, die kein Git-Host-Konto haben

plugins/install.md +1 −1

Details

143Der Installationsbereich eines Plugins entscheidet, wer das Plugin erhält und welche Einstellungsdatei es als aktiviert aufzeichnet:143Der Installationsbereich eines Plugins entscheidet, wer das Plugin erhält und welche Einstellungsdatei es als aktiviert aufzeichnet:

144 144

145* **User scope**: Das Plugin ist für Sie in jedem Projekt auf diesem Computer aktiviert. Der Eintrag geht in `enabledPlugins` in `~/.claude/settings.json`.145* **User scope**: Das Plugin ist für Sie in jedem Projekt auf diesem Computer aktiviert. Der Eintrag geht in `enabledPlugins` in `~/.claude/settings.json`.

146* **Project scope**: Das Plugin ist für alle aktiviert, die in diesem Repository arbeiten. Der Eintrag geht in `.claude/settings.json`, das Sie committen.146* **Project scope**: Das Plugin ist für alle aktiviert, die in diesem Repository arbeiten. Der Eintrag geht in `.claude/settings.json`, das Sie committen. Das Committen dieses Eintrags aktiviert das Plugin für Ihre Mitarbeiter, lädt es aber nicht auf ihre Computer herunter, daher führt jeder Mitarbeiter auch `claude plugin install <name>@<marketplace> --scope project` einmal aus; siehe [In Projekteinstellungen aktiviert, aber nicht installiert](/docs/de/plugins/loading#enabled-in-project-settings-but-not-installed).

147* **Local scope**: Das Plugin ist für Sie nur in diesem Repository aktiviert. Der Eintrag geht in `.claude/settings.local.json`.147* **Local scope**: Das Plugin ist für Sie nur in diesem Repository aktiviert. Der Eintrag geht in `.claude/settings.local.json`.

148 148

149Einige Plugins sind vom Autor so eingestellt, dass sie standardmäßig ausgeschaltet sind, über das Feld [`defaultEnabled`](/docs/de/plugins/manifest-reference#defaultenabled). Ein solches Plugin wird installiert, bleibt aber aus, bis Sie es mit `claude plugin enable <name>` in Ihrer Shell oder von der Registerkarte **Installed** von `/plugin` in einer Sitzung aktivieren.149Einige Plugins sind vom Autor so eingestellt, dass sie standardmäßig ausgeschaltet sind, über das Feld [`defaultEnabled`](/docs/de/plugins/manifest-reference#defaultenabled). Ein solches Plugin wird installiert, bleibt aber aus, bis Sie es mit `claude plugin enable <name>` in Ihrer Shell oder von der Registerkarte **Installed** von `/plugin` in einer Sitzung aktivieren.

plugins/loading.md +424 −0 created

Details

1> ## Documentation Index

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

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

5# Plugin-Ladeverweis

7> Verfolgen Sie, von wo Claude Code jedes Plugin lädt, welche Einstellungsdatei entscheidet, ob es geladen wird, und warum ein Update nichts geändert hat.

9Verwenden Sie diese Seite, wenn ein Plugin nicht geladen wurde, eine andere Kopie als erwartet geladen wurde oder ein Update nicht aufgegriffen wurde, und Sie sehen möchten, welche Quelle, Einstellungsbereich oder Datei auf der Festplatte dies entschieden hat. Sie zeigt die Regeln, die Claude Code anwendet, wenn eine Sitzung startet und jedes Mal, wenn Sie `/reload-plugins` ausführen. Sie können Claude auch bitten, diese Seite zu lesen und Ihr Setup zu diagnostizieren.

11<Note>

12 Diese Fälle werden auf anderen Seiten behandelt:

14 * **Installations-, Aktivierungs-, Deaktivierungs- und Aktualisierungsschritte**: siehe [Plugins installieren und verwalten](/docs/de/plugins/install)

15 * **Sie haben eine spezifische Fehlermeldung**: siehe [Plugins fehlerbeheben](/docs/de/plugins/troubleshooting)

16</Note>

18Beginnen Sie mit [Überprüfen Sie, welche Phase ein Plugin erreicht hat](#check-which-stage-a-plugin-reached) für die drei Phasen, die ein installiertes Plugin durchläuft, oder gehen Sie zu dem Abschnitt, der dem entspricht, was Sie sehen:

20* Ein Plugin, das Sie ausgeschaltet haben, wird immer noch geladen: [Finden Sie heraus, wo ein Plugin aktiviert ist](#find-where-a-plugin-is-enabled)

21* Ein Update hat nichts geändert: [Versionen und Updates](#versions-and-updates)

22* Sie schauen sich die Dateien unter `~/.claude/plugins/` an: [Finden Sie Plugins auf der Festplatte](#find-plugins-on-disk)

23* Ein `--plugin-dir`-Plugin wurde nicht geladen, oder ein gleichnamiges Plugin wurde stattdessen geladen: [Namenskonflikte](#name-conflicts)

25<h2 id="check-which-stage-a-plugin-reached">

26 Überprüfen Sie, welche Phase ein Plugin erreicht hat

27</h2>

29Ein `enabledPlugins`-Eintrag wird zu einem Plugin, das Sie in Phasen verwenden können: Ihre Einstellungen deklarieren es, Claude Code ruft es auf die Festplatte ab, und die laufende Sitzung lädt es. Wenn sich ein Plugin nicht so verhält, wie eine Einstellungsdatei vermuten lässt, überprüfen Sie, welche Phase es erreicht hat:

31* **Deklariert, in Einstellungen**: `enabledPlugins` gibt an, welche Plugins aktiviert sein sollten, und `extraKnownMarketplaces` gibt an, welche Marktplätze vorhanden sein sollten. Wenn Sie `claude plugin marketplace add` ausführen, schreibt Claude Code den Marktplatz sowohl in `extraKnownMarketplaces` in Ihren Benutzereinstellungen als auch auf die Festplatte

32* **Abgerufen, auf der Festplatte unter `~/.claude/plugins/`**: die Aufzeichnungen darüber, was Claude Code abgerufen hat, und die abgerufenen Dateien selbst:

33 * `known_marketplaces.json` zeichnet jeden Marktplatz auf, den Claude Code abgerufen hat, mit seiner `source`, `installLocation`, `lastUpdated` und `autoUpdate`. Es gibt eine `known_marketplaces.json` pro Benutzer, daher ist ein Marktplatz, den Sie in einem Projekt hinzufügen, in jedem Projekt verfügbar

34 * `installed_plugins.json` zeichnet jede Installation mit ihrem `scope`, `installPath` und `version` auf

35 * `cache/` enthält die Plugin-Dateien

36* **Geladen, in der laufenden Sitzung**: die Plugin-Menge, die Claude Code beim Start oder beim letzten `/reload-plugins` geladen hat. Änderungen an Einstellungen oder auf der Festplatte erreichen diese Ebene erst, wenn Sie `/reload-plugins` ausführen oder eine neue Sitzung starten. Deshalb endet `claude plugin update` mit `Restart to apply changes.` und Hintergrund-Updates fordern Sie mit `Run /reload-plugins to apply` auf

38<h3 id="plugins-and-marketplaces-that-aren’t-on-disk-at-session-start">

39 Plugins und Marktplätze, die beim Sitzungsstart nicht auf der Festplatte vorhanden sind

40</h3>

42Plugins werden beim Sitzungsstart aus `installed_plugins.json` und dem Cache geladen, ohne das Netzwerk zu nutzen. Nach dem Sitzungsstart überprüft Claude Code die deklarierten Marktplätze im Hintergrund:

44* **Ein Marktplatz, den Einstellungen deklarieren, aber `known_marketplaces.json` fehlt**: Claude Code klont ihn, lädt dann Plugins neu und lädt aktivierte Plugins herunter, die noch nicht zwischengespeichert sind

45* **Ein deklarierter Marktplatz, dessen Quelle sich in den Einstellungen geändert hat**: Claude Code ruft ihn von der neuen Quelle ab und zeigt `Plugins changed. Run /reload-plugins to activate.` an

47Ein aktiviertes Plugin, das von keinem der beiden Pfade abgerufen wurde und das kein verwendbares Cache-Verzeichnis hat, zeigt `Plugin "<name>" not cached at <path>` auf der Registerkarte `/plugin` **Errors** an, und `claude plugin list` fügt `— run /plugin to refresh` auf derselben Zeile hinzu. Für die Behebung siehe [`Plugin "<name>" not cached at <path>`](/docs/de/plugins/troubleshooting#plugin-not-cached-at).

49<h2 id="find-where-a-plugin-came-from">

50 Finden Sie heraus, von wo ein Plugin kam

51</h2>

53Jedes Plugin hat eine ID der Form `<name>@<origin>`, die Sie in Einstellungsdateien und in `claude plugin list --json` sehen. Der Teil nach `@` sagt Ihnen, wo Claude Code das Plugin gefunden hat:

55| ID endet mit | Wie das Plugin dorthin kam | Wie Sie es aktivieren oder deaktivieren |

56| :- | :- | :- |

57| `@<marketplace>` | Sie haben es von einem Marktplatz installiert, den Sie hinzugefügt haben | `"<name>@<marketplace>": true` oder `false` unter `enabledPlugins` in einer Einstellungsdatei |

58| `@inline` | Sie haben Claude Code mit `--plugin-dir` oder `--plugin-url` gestartet, [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/de/env-vars#variables) gesetzt, oder eine Agent SDK-App hat die `plugins`-Option übergeben. Es wird nur für diese Sitzung geladen | Aktiviert für die Sitzung, es sei denn, das Manifest setzt `defaultEnabled: false` oder eine Einstellungsdatei setzt `"<name>@inline": false` |

59| `@skills-dir` | Sie haben ein Plugin-Verzeichnis mit einer `.claude-plugin/plugin.json` unter `~/.claude/skills/` oder dem `.claude/skills/` des Projekts gespeichert | Das Manifest's `defaultEnabled`, es sei denn, eine Einstellungsdatei setzt `"<name>@skills-dir"` auf `true` oder `false` |

60| `@synced` | Sie oder Ihre Organisation haben es für Ihr claude.ai-Konto aktiviert, und Claude Code hat es [heruntergeladen](#synced-plugins) | Aktiviert, es sei denn, das Manifest setzt `defaultEnabled: false` oder eine Einstellungsdatei setzt `"<name>@synced": false`. Ein Plugin, das Ihre Organisation als erforderlich markiert, wird unabhängig geladen |

62Für ein Marktplatz-Plugin ist `<name>` der Eintragsname in `marketplace.json`; für `@inline` und `@skills-dir` ist es der `name` im Plugin-Manifest.

64Die Ursprungsnamen in dieser Tabelle sind reserviert, daher kann kein Marktplatz `inline`, `skills-dir` oder `synced` genannt werden.

66<h3 id="entry-name-and-manifest-name">

67 Eintragsname und Manifest-Name

68</h3>

70Ein Marktplatz-Plugin hat zwei Namen, und sie können unterschiedlich sein:

72* **Der Eintragsname in `marketplace.json`**: der Installations- und Aktivierungsschlüssel. Es ist das, was Sie in `enabledPlugins` schreiben, worauf das Cache-Verzeichnis benannt ist, und was `claude plugin list` anzeigt

73* **Der `name` im Manifest**: worauf die Komponenten des Plugins namensraum sind, und was [Namenskonflikte](#name-conflicts) vergleichen

75<h3 id="plugins-shared-through-a-repository">

76 Plugins, die über ein Repository geteilt werden

77</h3>

79Um ein Plugin über ein Repository zu teilen, listen Sie es unter `enabledPlugins` in `.claude/settings.json` auf oder platzieren Sie es unter `.claude/skills/`. Claude Code scannt das `.claude/plugins/`-Verzeichnis eines Projekts nicht.

81Eine Cloud-Sitzung fügt die Marktplätze nicht hinzu, die ein Repository unter [`extraKnownMarketplaces`](/docs/de/settings-reference#extraknownmarketplaces) auflistet, da dies den Workspace-Vertrauensdialog erfordert, den eine Cloud-Sitzung nie anzeigt.

83Ein Plugin im Bereich Projekt-Fähigkeitsverzeichnis wird nur aus dem `.claude/skills/` des [primären Arbeitsverzeichnisses](/docs/de/permissions#working-directories) der Sitzung geladen und nur, nachdem Sie den [Workspace-Vertrauensdialog](/docs/de/permissions#what-runs-before-you-trust-a-folder) für diesen Ordner akzeptiert haben. Es [sucht nicht in übergeordneten Verzeichnissen bis zur Repository-Root](/docs/de/skills#discovery-from-parent-and-nested-directories) wie einfache Fähigkeiten und Befehle. Wenn Sie von einem Unterverzeichnis aus starten, wird ein Plugin in der Repository-Root nicht geladen. Starten Sie stattdessen von der Repository-Root, oder [verschieben Sie die Sitzung mit `/cd`](/docs/de/permissions#move-the-session-to-another-directory) auf v2.1.246 oder später dorthin.

85Ein Plugin im Projekt-Bereich wird in das Repository eingecheckt und erreicht jeden Mitarbeiter, der es klont. Da dieser Inhalt aus dem Repository und nicht von Ihnen stammt, wird er nur nach der gleichen Vertrauensprüfung geladen, die für Projekt-Allow-Regeln in `.claude/settings.json` gilt. Ein übergeordnetes Verzeichnis zu vertrauen oder mit `-p` auszuführen ist nicht ausreichend. Komponenten, die Code ausführen, sind weiter eingeschränkt:

87* MCP-Server, die es deklariert, durchlaufen die [gleiche Pro-Server-Genehmigung](/docs/de/mcp) wie ein Projekt `.mcp.json`

88* MCP-Server, die es als [MCP-Bundle](/docs/de/plugins/manifest-reference#mcpservers) deklariert, eine `.mcpb`- oder `.dxt`-Datei, oder aus einer Datei außerhalb des Plugin-Verzeichnisses werden übersprungen. Deklarieren Sie sie inline oder in einer `.mcp.json` im Plugin-Verzeichnis

89* [Hintergrund-Monitore](/docs/de/plugins/components#monitors) werden nicht geladen

91Plugins im persönlichen Bereich haben keine dieser Einschränkungen.

93Wie Sie `--plugin-dir`- und Fähigkeitsverzeichnis-Plugins schreiben, siehe [Plugins erstellen](/docs/de/plugins/create).

95<h3 id="synced-plugins">

96 Plugins, die von claude.ai synchronisiert werden

97</h3>

99Ein Plugin, das Sie für Ihr claude.ai-Konto aktivieren, wird auch in Claude Code geladen, neben den Plugins, die Sie von Marktplätzen installieren. Dies umfasst Plugins, die Ihre Organisation für ihre Mitglieder aktiviert. Jedes dieser Plugins wird als `<name>@synced` geladen, ohne Marktplatz und ohne [Installationsdatensatz](#check-which-stage-a-plugin-reached).

100

101In Terminal-Sitzungen werden die Fähigkeiten, Agenten, Hooks, MCP-Server und LSP-Server eines synchronisierten Plugins alle geladen, mit dem gleichen Vertrauen wie ein Marktplatz-Plugin, das Sie installiert haben.

102

103Für die Komponenten, die Cowork lädt, siehe die [Komponenten-Unterstützungstabelle](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) auf claude.com.

104

105Synchronisierte Plugins werden in Cowork-Sitzungen und in Terminal-Sitzungen geladen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden:

106

107* **[Cowork](https://claude.com/product/cowork)**: Claude Code lädt sie in die eigene Umgebung der Sitzung herunter, wenn die Sitzung startet

108* **Terminal-Sitzungen**: jedes Mal, wenn Sie Claude Code starten, wird es einmal im Hintergrund synchronisiert, neue und aktualisierte Plugins heruntergeladen und die Plugins entfernt, die Sie oder Ihre Organisation deaktiviert haben. Die Synchronisierung in Terminal-Sitzungen erfordert Claude Code v2.1.273 oder später

109

110<h4 id="sync-timing-in-terminal-sessions">

111 Synchronisierungszeitpunkt in Terminal-Sitzungen

112</h4>

113

114Da die Terminal-Synchronisierung im Hintergrund läuft, kann sie nach dem Start Ihrer Sitzung abgeschlossen sein. Wenn sie ein synchronisiertes Plugin in einer interaktiven Sitzung hinzufügt, aktualisiert oder entfernt, sehen Sie `Plugins changed. Run /reload-plugins to activate.` Führen Sie `/reload-plugins` aus, um die Änderung in dieser Sitzung zu laden, oder lassen Sie sie für das nächste Mal, wenn Sie Claude Code starten.

115

116Wenn Sie ein Plugin auf claude.ai aktivieren, während eine Sitzung läuft, wird das Plugin das nächste Mal heruntergeladen, wenn Sie Claude Code starten.

117

118<h4 id="sign-in-requirements-for-terminal-sync">

119 Anmeldeanforderungen für Terminal-Synchronisierung

120</h4>

121

122In Ihrem Terminal werden Plugins nur in Sitzungen synchronisiert, in denen Sie sich mit Ihrem claude.ai-Konto anmelden.

123

124Wenn Sie sich auf einer früheren Version von Claude Code angemeldet haben, deckt diese Anmeldung Plugins nicht ab, bis Claude Code sie im Hintergrund erneuert. Um schneller Zugriff zu erhalten, führen Sie `/login` erneut aus. Die Plugin-Synchronisierung startet dann das nächste Mal, wenn Sie Claude Code starten.

125

126<h4 id="control-which-synced-plugins-load">

127 Steuern Sie, welche synchronisierten Plugins geladen werden

128</h4>

129

130Sie können synchronisierte Plugins einzeln ausschalten, außer einem Plugin, das Ihre Organisation erfordert, oder alle synchronisierten Plugins auf dem Computer ausschalten:

131

132* **Ein Plugin**: `claude plugin disable <name>@synced` in Ihrer Shell und die `/plugin` **Installed**-Registerkarte in einer Sitzung speichern beide `"<name>@synced": false` in Ihrem Benutzer-Level [`enabledPlugins`](/docs/de/settings-reference#enabledplugins). Um das Plugin in einem Projekt in jeder Umgebung zu halten, setzen Sie den gleichen Schlüssel in der committed `.claude/settings.json` des Projekts

133* **Jedes synchronisierte Plugin auf einem Computer**: setzen Sie [`syncClaudeAiPlugins`](/docs/de/settings-reference#syncclaudeaiplugins) auf `false` in Ihren Benutzereinstellungen, oder Ihre Organisation setzt es in [verwalteten Einstellungen](/docs/de/managed-settings). Claude Code stoppt das Herunterladen, und das nächste Mal, wenn Sie es starten, verschiebt es die Plugins, die es bereits synchronisiert hat, zu `~/.claude/plugins/.trash/` und lädt sie nicht mehr. Wenn Ihre Organisation Skills auf claude.ai ausschaltet, stoppt auch die Plugin-Synchronisierung

134* **Ein Plugin, das Ihre Organisation erfordert**: ein Plugin, das Ihre Organisation auf claude.ai als erforderlich markiert, wird geladen, auch wenn Sie es zuvor deaktiviert haben. `claude plugin disable` weigert sich mit `Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.`, und `claude plugin list` markiert es `required by your org`

135

136Zum Entfernen eines Plugins auf claude.ai siehe [Installierte Plugins verwalten](/docs/de/plugins/install#manage-installed-plugins).

137

138<h2 id="find-where-a-plugin-is-enabled">

139 Finden Sie heraus, wo ein Plugin aktiviert ist

140</h2>

141

142Sie können einen `enabledPlugins`-Eintrag in einer von sechs Quellen setzen. Die Tabelle listet sie von niedrigster zu höchster Priorität auf und wer jede betrifft. Für die Einstellungsdateien selbst siehe [Einstellungsdateien und wer sie beeinflussen](/docs/de/settings#where-settings-live).

143

144| Quelle | Wo Sie es setzen | Erreicht |

145| :- | :- | :- |

146| `--add-dir` | `.claude/settings.json` oder `.claude/settings.local.json` in einem Verzeichnis, das Sie mit `--add-dir` übergeben | Nur diese Sitzung. Nur ein `true`-Wert hat eine Auswirkung, und jede andere Quelle überschreibt ihn |

147| `user` | `~/.claude/settings.json` | Sie, in jedem Projekt |

148| `project` | `.claude/settings.json` | Jeder, der das Repository klont |

149| `local` | `.claude/settings.local.json` | Sie, nur in diesem Repository |

150| `flag` | Der `--settings`-Wert, den Sie beim Start übergeben | Nur diese Sitzung |

151| `managed` | [Verwaltete Einstellungen](/docs/de/managed-settings) | Jeder Benutzer, den die Richtlinie abdeckt. `true` erzwingt Aktivierung und `false` blockiert, und keine andere Quelle überschreibt sie |

152

153Diese Quellen werden Schlüssel für Schlüssel zusammengeführt. Für jede Plugin-ID ist der Wert, der gilt, der aus der höchsten Prioritätsquelle, die die ID erwähnt. Eine Quelle, die die ID nicht erwähnt, lässt den Wert aus der niedrigeren Prioritätsquelle in Kraft.

154

155<h3 id="disabled-in-user-settings-but-still-loads">

156 In Benutzereinstellungen deaktiviert, wird aber immer noch geladen

157</h3>

158

159Wenn Sie ein Plugin in `~/.claude/settings.json` auf `false` setzen und es wird immer noch geladen, überschreibt ein `true` in einer höheren Prioritätsquelle es. Die Zeile des Plugins in `claude plugin list` und in `/plugin` zeigt `Disabled in ~/.claude/settings.json but still loads — project settings enable it, which overrides your user setting`. Die Nachricht nennt die Quelle, die Sie überschrieben hat: `project`, `project, gitignored` für `.claude/settings.local.json`, `cli flag`, oder `managed`.

160

161Um sich von einem Projekt-aktivierten Plugin auf Ihrem Computer abzumelden, setzen Sie die ID auf `false` in `.claude/settings.local.json`, die höhere Priorität als die Projektdatei hat.

162

163<h3 id="enabled-in-project-settings-but-not-installed">

164 In Projekteinstellungen aktiviert, aber nicht installiert

165</h3>

166

167Wenn das einzige `true` eines Plugins in der `.claude/settings.json` des Projekts ist, ruft Claude Code es nicht auf einem Computer ab, auf dem es nicht installiert ist, es sei denn, sein Marktplatz-Eintrag hat eine [relative-Pfad-Quelle](/docs/de/plugins/marketplace-reference#plugin-sources) oder ein [Seed-Verzeichnis](/docs/de/plugins/org#seed-containers-and-ci) hält es bereits. Stattdessen zeigt die `/plugin` **Errors**-Registerkarte `Plugin "<name>" is enabled in project settings but isn't installed here`.

168

169Ein Relative-Pfad-Plugin benötigt keinen Installationsdatensatz, da es vom Marktplatz selbst geladen wird.

170

171Claude Code ruft ein Plugin mit einer externen Quelle nur ab, wenn eine dieser Quellen es auf `true` setzt:

172

173* Ihre Benutzereinstellungen

174* Eine `.claude/settings.local.json`, die git nicht verfolgt

175* Das `--settings`-Flag

176* Verwaltete Einstellungen

177

178<h2 id="find-plugins-on-disk">

179 Finden Sie Plugins auf der Festplatte

180</h2>

181

182Claude Code behält Plugin-Dateien und Zustandsdatensätze unter einer Plugin-Root, die `~/.claude/plugins` ist, es sei denn, Sie setzen [`CLAUDE_CODE_PLUGIN_CACHE_DIR`](/docs/de/env-vars). Jeder Pfad in der Tabelle ist relativ zu dieser Root.

183

184| Pfad | Was er enthält |

185| :- | :- |

186| `cache/<marketplace>/<plugin>/<version>/` | Ein Verzeichnis pro installierte Version eines Marktplatz-Plugins. `<plugin>` ist der Marktplatz-Eintragsname und `<version>` ist die [aufgelöste Version](#versions-and-updates). `${CLAUDE_PLUGIN_ROOT}` zeigt auf dieses Verzeichnis |

187| `data/<plugin-id>/` | Das persistente Verzeichnis des Plugins, das als `${CLAUDE_PLUGIN_DATA}` verfügbar gemacht wird. Wie `<plugin-id>` gebildet wird, siehe [Pfadvariablen und persistente Daten](/docs/de/plugins/components#path-variables-and-persistent-data). Claude Code erstellt es, wenn eine Plugin-Komponente es zuerst verwendet, und behält es über Updates hinweg. Standardmäßig löscht Claude Code es, wenn Sie das Plugin aus seinem letzten Bereich deinstallieren. Für `--keep-data` und die anderen Fälle, in denen es erhalten bleibt, siehe [Plugin deinstallieren](/docs/de/plugins/cli-reference#plugin-uninstall) |

188| `marketplaces/<name>/` | Der Klon oder Download eines Marktplatzes, der von GitHub, einem anderen Git-Host oder einer URL hinzugefügt wurde. Ein Marktplatz, der von einer lokalen `file`- oder `directory`-Quelle hinzugefügt wurde, hat hier keine Kopie, und seine `installLocation` in `known_marketplaces.json` ist der Pfad, den Sie angegeben haben |

189| `synced/` | Die Plugins, die Claude Code [von Ihrem claude.ai-Konto synchronisiert hat](#synced-plugins) |

190| `.trash/` | Plugins, die die claude.ai-Synchronisierung entfernt hat, z. B. nachdem Sie eines auf claude.ai ausgeschaltet haben oder die Synchronisierung gestoppt haben |

191| `installed_plugins.json` und `known_marketplaces.json` | Die Datensätze darüber, was Claude Code installiert hat und welche Marktplätze es abgerufen hat, beschrieben unter [Überprüfen Sie, welche Phase ein Plugin erreicht hat](#check-which-stage-a-plugin-reached). Ein [auf claude.ai gehosteter Marktplatz](/docs/de/plugins/install#add-from-claude-ai) wird stattdessen in `known_marketplaces_claudeai.json` aufgezeichnet |

192| `flagged-plugins.json` | Plugins, die Claude Code deinstalliert hat, weil ihr Marktplatz sie delisted hat. Sie erscheinen im **Flagged**-Bereich von `/plugin`; siehe [Einen Marktplatz hosten](/docs/de/plugins/host-marketplace) |

193

194Da `${CLAUDE_PLUGIN_ROOT}` auf ein Versionsverzeichnis zeigt, ändert sich der Root-Pfad eines Plugins mit jeder Version. Behalten Sie die dauerhaften Dateien eines Plugins stattdessen in `${CLAUDE_PLUGIN_DATA}`.

195

196<h3 id="in-place-and-copied-plugins">

197 In-Place- und kopierte Plugins

198</h3>

199

200Claude Code lädt einige Plugins an Ort und Stelle von dort, wo Sie sie aufbewahren, und kopiert den Rest in den Cache, je nach ihrem Ursprung:

201

202* **`--plugin-dir`- und Fähigkeitsverzeichnis-Plugins**: das Verzeichnis wird an Ort und Stelle geladen und wird nie kopiert. Ein `--plugin-url`-Archiv oder eine `--plugin-dir` `.zip` wird zuerst in ein Sitzungs-Temp-Verzeichnis extrahiert

203* **Relative-Pfad-Plugins in einem Marktplatz, den Sie von einem lokalen Verzeichnis hinzugefügt haben**: das Plugin wird an Ort und Stelle von seinem Pfad im Marktplatz-Ordner geladen. Ihre Änderungen am Quellverzeichnis treten beim nächsten Sitzungsstart oder `/reload-plugins` in Kraft, und Sie müssen die Version nicht erhöhen. Die Hook-Prozesse des Plugins und MCP- und LSP-Server erhalten ein `CLAUDE_PLUGIN_ROOT`, das auf das Quellverzeichnis zeigt. Für seine Node.js-Paketabhängigkeiten siehe [Wenn die Abhängigkeitsinstallation läuft](#when-the-dependency-install-runs)

204* **`command`-Quellen-Plugins im [Link-Modus](/docs/de/plugins/marketplace-reference#command-plugin-source)**: das Verzeichnis, das der Befehl gedruckt hat, wird an Ort und Stelle geladen, durch Links im Cache-Eintrag

205* **Jedes andere Marktplatz-Plugin**: Claude Code kopiert das Plugin beim Installieren in `cache/<marketplace>/<plugin>/<version>/` und lädt diese Kopie. Dateien außerhalb des Plugin-Verzeichnisses werden nicht kopiert, daher findet ein Skript in einem kopierten Plugin, das einen Pfad über der Plugin-Root liest, wie `../shared`, sie nicht

206

207<h3 id="paths-that-escape-the-plugin-directory">

208 Pfade, die dem Plugin-Verzeichnis entkommen

209</h3>

210

211Ob ein Plugin an Ort und Stelle oder aus einer zwischengespeicherten Kopie geladen wird, Claude Code lässt es nicht zu, Komponenten außerhalb seines eigenen Verzeichnisses zu deklarieren. Es lehnt einen Komponentenpfad ab, der außerhalb der Plugin-Root aufgelöst wird, ob der Pfad in `plugin.json` oder in einem Marktplatz-Eintrag deklariert ist:

212

213* **Ein Pfad, der außerhalb des Plugins zeigt, wie geschrieben**, wie `../shared-utils`

214* **Ein Symlink, der außerhalb des Plugins führt**, außer [Links zwischen Plugins innerhalb eines Marktplatzes](/docs/de/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)

215* **Auf macOS und Linux, ein Pfad, der irgendwo einen Backslash enthält**, auch wenn der Pfad im Plugin bleibt. Komponenten, die mit Backslash-Pfaden deklariert werden, werden daher nur unter Windows geladen, daher schreiben Sie Komponentenpfade mit Schrägstrichen, wie `./commands/deploy.md`

216

217Ein abgelehnter Pfad erscheint als [`path escapes plugin directory`](/docs/de/errors#path-escapes-plugin-directory)-Fehler, und das Plugin wird ohne diese Komponente geladen.

218

219<h3 id="cleanup-of-previous-versions">

220 Bereinigung vorheriger Versionen

221</h3>

222

223Wenn Sie ein Plugin aktualisieren oder deinstallieren, schreibt Claude Code einen `.orphaned_at`-Marker in das vorherige Versionsverzeichnis. Es entfernt dieses Verzeichnis 14 Tage später in einer Hintergrund-Bereinigung, daher läuft eine Sitzung, die die alte Version bereits geladen hat, weiter.

224

225Der Sweep läuft nur, während `installed_plugins.json` mindestens eine Installation aufzeichnet. Nachdem Sie Ihr letztes Plugin deinstalliert haben, bleiben verwaiste Verzeichnisse, bis Sie ein anderes installieren.

226

227<h3 id="node-js-package-dependencies">

228 Node.js-Paketabhängigkeiten

229</h3>

230

231Wenn Claude Code ein Plugin in den Cache kopiert, installiert es auch die Node.js-Paketabhängigkeiten des Plugins dort, damit die Hooks und MCP-Server des Plugins sie laden können.

232

233Dieser Abschnitt behandelt die npm- und Bun-Pakete, die ein Plugin in seiner eigenen `package.json` deklariert. Für Plugins, die von anderen Plugins abhängen, siehe [Plugin-Abhängigkeitsversionen](/docs/de/plugins/dependencies).

234

235<h4 id="when-the-dependency-install-runs">

236 Wenn die Abhängigkeitsinstallation läuft

237</h4>

238

239Claude Code führt die Installation im kopierten Versionsverzeichnis jedes Mal aus, wenn es eines erstellt:

240

241* Wenn Sie ein Plugin installieren

242* Wenn Claude Code ein Plugin auf eine neue Version aktualisiert

243* Beim Sitzungsstart, wenn ein aktiviertes Plugin noch nicht zwischengespeichert ist, z. B. auf einem neuen Computer

244

245Für ein Relative-Pfad-Plugin, das [an Ort und Stelle geladen wird](#in-place-and-copied-plugins) von einem lokalen Verzeichnis-Marktplatz, installiert Claude Code die Abhängigkeiten nicht in das Quellverzeichnis. Installieren Sie sie dort selbst, oder von einem Hook in [`${CLAUDE_PLUGIN_DATA}`](/docs/de/plugins/components#path-variables-and-persistent-data).

246

247Die Installation läuft nur, wenn das Plugin-Root-Verzeichnis sowohl eine `package.json` als auch eine unterstützte Lockdatei enthält. Die Lockdatei entscheidet, welchen Befehl Claude Code ausführt:

248

249| Lockdatei | Befehl |

250| :- | :- |

251| `bun.lock` oder `bun.lockb` | `bun install --frozen-lockfile --ignore-scripts` |

252| `npm-shrinkwrap.json` oder `package-lock.json` | `npm ci --ignore-scripts` |

253

254Wenn ein Plugin mehr als eine dieser Lockdateien enthält, verwendet Claude Code die erste Übereinstimmung, Überprüfung in Reihenfolge: `bun.lock`, `bun.lockb`, `npm-shrinkwrap.json`, `package-lock.json`.

255

256Claude Code überspringt die Installation für Yarn- und pnpm-Lockdateien und für eine `bunfig.toml` neben der Bun-Lockdatei:

257

258* Wenn Ihr Plugin nur eine `yarn.lock` oder `pnpm-lock.yaml` hat, ersetzen Sie sie durch eine npm-Lockdatei

259* Wenn eine `bunfig.toml` im gleichen Verzeichnis wie die Bun-Lockdatei ist, entfernen Sie die `bunfig.toml`, oder ersetzen Sie die Bun-Lockdatei durch eine npm-Lockdatei

260

261Fügen Sie eine npm-Lockdatei ein, um die meisten Benutzer zu erreichen. Claude Code führt den Paketmanager der übereinstimmenden Lockdatei aus dem PATH des Benutzers aus und versucht nicht den anderen Lockdatei-Paketmanager, wenn dieser fehlt.

262

263Für ein Plugin, das über eine npm-Quelle verteilt wird, verwenden Sie `npm-shrinkwrap.json`, da npm `package-lock.json` aus veröffentlichten Paketen ausschließt.

264

265<h4 id="limits-on-the-dependency-install">

266 Grenzen der Abhängigkeitsinstallation

267</h4>

268

269Claude Code beschränkt diese Abhängigkeitsinstallation so, dass kein Code aus dem Plugin oder seinen Paketen während der Installation ausgeführt wird, und begrenzt, wie lange sie laufen kann:

270

271* **Gefrorene Auflösung**: Bun und npm installieren genau das, was die Lockdatei anheftet, und schlagen fehl, anstatt Versionen erneut aufzulösen, wenn `package.json` und die Lockdatei nicht übereinstimmen

272* **Keine Lifecycle-Skripte**: `--ignore-scripts` hält `preinstall`-, `install`- und `postinstall`-Skripte davon ab, zu laufen, daher laden Abhängigkeiten, die native Module in diesen Skripten erstellen, herunter, werden aber während dieser Installation nicht kompiliert

273* **60-Sekunden-Timeout**: Claude Code stoppt eine Installation, die länger läuft, und behandelt sie als fehlgeschlagen

274

275Claude Code ruft ein npm-Quellen-Plugin vor dieser Abhängigkeitsinstallation ab, und keines der Installationsskripte des Pakets selbst läuft während des Abrufs. Siehe [npm-Plugin-Quelle](/docs/de/plugins/marketplace-reference#npm-plugin-source).

276

277Sie können die automatische Installation nicht ausschalten. Keine Einstellung oder Umgebungsvariable deaktiviert sie.

278

279In eingeschränkten Netzwerken siehe die [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) für die Hosts, die Sie zulassen müssen.

280

281<h4 id="when-the-dependency-install-fails-or-is-skipped">

282 Wenn die Abhängigkeitsinstallation fehlschlägt oder übersprungen wird

283</h4>

284

285Eine fehlgeschlagene oder übersprungene Installation blockiert das Plugin nie, und jeder Fall hinterlässt ein anderes Zeichen:

286

287* Eine fehlgeschlagene Installation oder eine, die übersprungen wird, weil eine Yarn- oder pnpm-Lockdatei oder eine `bunfig.toml` vorhanden ist, erscheint als Warnung in der `claude --debug`-Ausgabe

288* Ein Plugin mit einer `package.json` und keiner Lockdatei wird ohne Logeintrag übersprungen

289* Eine Timeout-Installation kann einen teilweisen `node_modules`-Baum in der zwischengespeicherten Kopie hinterlassen

290

291Wenn die automatische Installation eine Abhängigkeit nicht bereitstellen kann, installieren Sie sie von einem Hook in das [persistente Datenverzeichnis](/docs/de/plugins/components#path-variables-and-persistent-data). Dies umfasst Pakete, die ihre Lifecycle-Skripte zum Erstellen benötigen, Python-Abhängigkeiten und Plugins, die mit Yarn oder pnpm gesperrt sind.

292

293<h2 id="versions-and-updates">

294 Versionen und Updates

295</h2>

296

297Wenn der Autor eines Plugins neue Commits gepusht hat und `claude plugin update` gibt `<name> is already at the latest version (<version>).` aus, bleibt die Version, die Claude Code für das Plugin berechnet, unverändert, sodass sich nichts auf der Festplatte ändert.

298

299Claude Code berechnet eine Version für jedes Plugin, das es installiert, und diese Version ist die Art und Weise, wie es ein Update erkennt. `claude plugin update` und die automatische Hintergrund-Aktualisierung berechnen die Version erneut und überspringen das Plugin, wenn sie mit dem übereinstimmt, was `installed_plugins.json` aufzeichnet.

300

301Die Version benennt auch das Cache-Verzeichnis des Plugins.

302

303Ein Manifest, das `"version"` festlegt, ist eine Möglichkeit, wie die berechnete Version über Commits hinweg gleich bleibt. Siehe [How Claude Code computes the version](#how-claude-code-computes-the-version) für die Auflösungsreihenfolge.

304

305Ein Plugin, das [in place](#in-place-and-copied-plugins) aus einem lokalen Marketplace-Verzeichnis geladen wird, lädt seine aktuellen Quelldateien bei jedem Sitzungsstart, unabhängig davon, was seine Versionsnummer sagt. Für ein Plugin aus einem [Marketplace, der auf claude.ai gehostet wird](/docs/de/plugins/install#add-from-claude-ai), ist die Version, die claude.ai für das Plugin aufzeichnet, seine Version, und das Manifest's `version` wird nicht gelesen.

306

307<h3 id="how-claude-code-computes-the-version">

308 How Claude Code computes the version

309</h3>

310

311Für einen Marketplace, den Sie nach Quelle hinzugefügt haben, wählt Claude Code die Regel nach dem `source`-Typ des Plugin-Marketplace-Eintrags. Die [Marketplace-Referenz](/docs/de/plugins/marketplace-reference#plugin-sources) listet die Quellentypen auf. Für jeden Quellentyp in dieser Liste außer `command`:

312

3131. Das `version`-Feld im Manifest des Plugins kommt zuerst

3142. Dann das `version`-Feld im Plugin-Marketplace-Eintrag

3153. Wenn keines gesetzt ist, kommt die Version vom Quellentyp:

316

317| Quellentyp | Version, wenn kein `version`-Feld gesetzt ist |

318| :- | :- |

319| `github`, `url` oder `git-subdir` | Der Commit-SHA der Quelle, gekürzt auf 12 Zeichen. Eine `git-subdir`-Version trägt auch einen Hash des Unterverzeichnispfads |

320| `archive` | Der SHA-256-Digest, gekürzt auf 12 Zeichen: der `sha256`-Pin im Marketplace-Eintrag oder der Digest der heruntergeladenen Datei, wenn kein Pin vorhanden ist |

321| Relativer Pfad in einem Git-gehosteten Marketplace | Der Commit-SHA des installierten Verzeichnisses |

322| Lokales Verzeichnis, wenn weder das Plugin-Verzeichnis noch sein Marketplace ein Git-Repository ist | `unknown` |

323| `npm` | `unknown` |

324

325Claude Code nimmt die Version nicht aus einem Repository, das den Installationspfad umschließt, wie z. B. ein Git-verwaltetes `~/.claude`.

326

327Für eine `command`-Quelle leitet Claude Code die Version immer von dem ab, was der Befehl produziert hat: ein 12-Zeichen-Hash allein oder `<manifest version>-<hash>`, wenn das Manifest einen setzt. Der `version`-Eintrag des Marketplace wird für Befehlsquellen ignoriert. Für das, was der Hash abdeckt, siehe [Copy mode and link mode](/docs/de/plugins/marketplace-reference#copy-mode-and-link-mode).

328

329Da das Manifest zuerst kommt, behält ein Manifest, das `"version": "1.0.0"` festlegt, jeden Benutzer auf der zwischengespeicherten Kopie, bis sein Autor die Zeichenkette ändert, egal wie viele Commits er pusht. Um Benutzern zu ermöglichen, stattdessen Commits zu verfolgen, lassen Sie `version` sowohl im Manifest als auch im Eintrag weg. [Host a marketplace](/docs/de/plugins/host-marketplace) behandelt, welche Wahl zu welchem Release-Setup passt.

330

331<h3 id="when-claude-code-refreshes-a-marketplace-before-an-install">

332 When Claude Code refreshes a marketplace before an install

333</h3>

334

335Wenn Sie ein Plugin installieren, sucht Claude Code es in seiner lokalen Kopie des Marketplace-Katalogs auf. Sie können `/plugin install` in einer Sitzung oder `claude plugin install` in Ihrer Shell ausführen und das Plugin mit oder ohne seinen Marketplace benennen. Die Tabelle zeigt, welche dieser Kombinationen die lokale Kopie aktualisieren.

336

337| Plugin-Name | Befehl | Was Claude Code aktualisiert |

338| :- | :- | :- |

339| `name@marketplace` | `/plugin install` oder `claude plugin install` | Der benannte Marketplace, vor der Suche |

340| `name` allein | `/plugin install` | Nur Marketplaces, die Auto-Update aktiviert haben, und nur nach der Suche fehlschlägt |

341| `name` allein | `claude plugin install` | Nichts. Es liest die zwischengespeicherten Kataloge ohne Aktualisierung |

342

343Die Aktualisierung vor einer `name@marketplace`-Installation hängt nicht von der Auto-Update-Einstellung des Marketplace oder von `DISABLE_AUTOUPDATER` ab.

344

345Wenn die Aktualisierung fehlschlägt, wird die Installation aus dem zwischengespeicherten Katalog fortgesetzt und `claude plugin install` meldet `marketplace not refreshed`.

346

347Claude Code überspringt die Aktualisierung vor einer `name@marketplace`-Installation, wenn:

348

349* Der Marketplace wurde aus einer lokalen `file`- oder `directory`-Quelle hinzugefügt oder ist inline in Einstellungen mit einer [`settings`-Quelle](/docs/de/settings-reference#extraknownmarketplaces) definiert

350* Ein [Seed-Verzeichnis](/docs/de/env-vars) stellt den Marketplace bereit

351* Claude Code hat den Marketplace in den letzten 30 Sekunden aktualisiert

352* Sie setzen `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

353* [Verwaltete Einstellungen](/docs/de/plugins/org#restrict-what-users-can-install) blockieren den Marketplace, in welchem Fall Claude Code auch die Installation verweigert

354

355<h3 id="when-auto-update-runs">

356 When auto-update runs

357</h3>

358

359In einer interaktiven Sitzung wartet Claude Code nach dem Senden Ihrer ersten Nachricht eine zufällige Verzögerung von bis zu zehn Minuten. Anschließend aktualisiert es jeden Marketplace mit aktiviertem Auto-Update und aktualisiert die von ihnen installierten Plugins auf der Festplatte.

360

361Die laufende Sitzung behält die Versionen, die sie geladen hat, und Sie sehen `Plugin updated: <name> · Run /reload-plugins to apply`. Unabhängig davon, ob Sie neu laden oder nicht, werden die neuen Versionen beim nächsten Start geladen.

362

363<h4 id="which-marketplaces-and-plugins-auto-update">

364 Which marketplaces and plugins auto-update

365</h4>

366

367Ob ein Marketplace automatisch aktualisiert wird, folgt dem ersten dieser Punkte, der gesetzt ist:

368

3691. **`autoUpdate` auf seinem `extraKnownMarketplaces`-Eintrag** in einer Einstellungsdatei

3702. **`autoUpdate` auf seinem `known_marketplaces.json`-Eintrag**, den der **Enable auto-update**-Schalter unter `/plugin` **Marketplaces** schreibt. Wenn eine Einstellungsdatei den Marketplace auch unter `extraKnownMarketplaces` deklariert, schreibt der Schalter `autoUpdate` auch in diesen Einstellungseintrag

3713. **Der Standard**: an für Anthropics offizielle Marketplaces wie `claude-plugins-official`, aus für `knowledge-work-plugins` und `first-party-plugins`, an für [Marketplaces, die von claude.ai hinzugefügt wurden](/docs/de/plugins/install#add-from-claude-ai), und aus für jeden anderen Marketplace

372

373Wenn Sie `DISABLE_UPDATES=1`, `DISABLE_AUTOUPDATER=1` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` setzen, ist der gesamte Durchgang aus und der **Enable auto-update**-Schalter ist verborgen, es sei denn, Sie setzen auch `FORCE_AUTOUPDATE_PLUGINS=1`. Die [Umgebungsvariablen-Referenz](/docs/de/env-vars) behandelt die breitere Auswirkung jeder Variablen.

374

375Auto-Update überspringt auch ein Plugin, dessen Marketplace-Eintrag einen `headersHelper` deklariert. [Installs and updates that refuse a command instead of asking](/docs/de/plugins/host-marketplace#installs-and-updates-that-refuse-the-command-instead-of-asking) erklärt, wann ein solches Plugin in der `/plugin` **Errors**-Registerkarte angezeigt wird und wie Sie es von dort aus aktualisieren.

376

377Wenn ein kopiertes Plugin während einer Sitzung aktualisiert wird, verwenden Hook-Befehle, Monitore, MCP-Server und LSP-Server weiterhin den Pfad der vorherigen Version. Führen Sie `/reload-plugins` aus, um Hooks, MCP-Server und LSP-Server zum neuen Pfad zu wechseln. Monitore erfordern einen Sitzungsneustart.

378

379<h3 id="when-a-command-source-re-runs">

380 When a command source re-runs

381</h3>

382

383Plugins mit einer `command`-Quelle warten nicht auf den [Auto-Update-Durchgang](#when-auto-update-runs). Das gedruckte Verzeichnis spiegelt den Zustand des Tools zum Zeitpunkt der Befehlsausführung wider, daher führt Claude Code den [Befehl aus, den Sie akzeptiert haben](/docs/de/plugins/host-marketplace#change-the-command-of-a-command-source) zu diesen Zeiten erneut aus:

384

385* Jedes Mal, wenn Sie das Plugin installieren oder aktualisieren

386* Einmal pro Sitzung für jedes aktivierte befehlsgesteuerte Plugin im Hintergrund, kurz nach dem Sitzungsstart. Dieser Durchgang hängt nicht von der Auto-Update-Einstellung des Marketplace oder von `DISABLE_AUTOUPDATER` ab

387* Beim Start oder auf `/reload-plugins`, wenn die installierte Version eines aktivierten Plugins im Plugin-Cache fehlt

388

389Claude Code überspringt die beiden Hintergrund-Durchgänge, wenn Sie [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/de/env-vars) setzen. Explizite Installationen und Updates führen den Befehl mit dieser Variablen gesetzt immer noch aus.

390

391Wenn sich die gehashte Ausgabe des Befehls geändert hat, installiert Claude Code das Ergebnis als neue Version und lädt es in der laufenden interaktiven Sitzung neu, wobei [die gleichen Komponenten gewechselt werden, die `/reload-plugins` wechselt](/docs/de/plugins/cli-reference#reload-plugins). Sie sehen eine Benachrichtigung, dass das Plugin neu geladen wurde.

392

393Wenn das Neuladen an Ort und Stelle den Prompt-Cache der Sitzung ungültig machen würde, fordert Claude Code Sie stattdessen auf, `/reload-plugins` auszuführen, das [vor den Cache-Kosten warnt und angewendet wird, wenn es mit `--force` erneut ausgeführt wird](/docs/de/prompt-caching#enabling-or-disabling-a-plugin).

394

395<h2 id="name-conflicts">

396 Namenskonflikte

397</h2>

398

399Wenn aktivierte Plugins aus verschiedenen Ursprüngen einen Manifest-Namen teilen, entscheidet diese Reihenfolge, welche geladen wird, von höchster zu niedrigster Priorität:

400

4011. Ein Plugin, dessen ID in verwalteten Einstellungen `enabledPlugins` erscheint, als `true` oder `false`. Eine `--plugin-dir`-Kopie, deren Manifest-Name dem Namen-Teil der ID entspricht, wird nicht geladen, und Sie sehen `--plugin-dir copy of "<name>" ignored: plugin is locked by managed settings`

4022. Ein aktiviertes `--plugin-dir`-, `--plugin-url`- oder `CLAUDE_CODE_PLUGIN_DIRS`-Plugin. Es ersetzt ein gleichnamiges installiertes Marktplatz-Plugin oder Fähigkeitsverzeichnis-Plugin:

403 * **Ein installiertes Marktplatz-Plugin**: stillschweigend ersetzt. `claude plugin list` zeigt die Marktplatz-Zeile immer noch als aktiviert, da diese Zeile Ihre Einstellungen widerspiegelt. Nur das Protokoll, das Claude Code unter `~/.claude/debug/` schreibt, wenn Sie mit `--debug` starten, zeichnet `Plugin "<name>" from --plugin-dir overrides installed version` auf

404 * **Ein Fähigkeitsverzeichnis-Plugin**: ersetzt mit einer `/plugin` **Errors**-Registerkarte-Zeile, die `Not loaded — the name "<name>" is already taken by a session-only plugin (--plugin-dir / --plugin-url), which takes precedence` liest

4053. Ein installiertes Marktplatz-Plugin. Ein Fähigkeitsverzeichnis-Plugin mit dem gleichen Namen erhält die gleiche `Not loaded`-Zeile, benennend das installierte Plugin

4064. Ein Fähigkeitsverzeichnis-Plugin. Zwischen zwei davon wird die Kopie unter `~/.claude/skills/` geladen und die Kopie des Projekts `.claude/skills/` wird gelöscht, mit einer Zeile, die sagt, welcher Pfad sie überschattet hat

4075. Ein Plugin, das [von claude.ai synchronisiert wird](#synced-plugins). Wenn ein aktiviertes Plugin aus einem anderen Ursprung seinen Namen entspricht, lädt Claude Code dieses Plugin und meldet die synchronisierte Kopie als nicht geladen. Um stattdessen die claude.ai-Kopie zu verwenden, deaktivieren Sie Ihre eigene Kopie

408

409Da die Reihenfolge Manifest-Namen vergleicht, ersetzt ein `--plugin-dir`-Plugin namens `hello-plugin` `hello@example-marketplace`, wenn das Plugin-Manifest auch `"name": "hello-plugin"` sagt.

410

411<h3 id="keep-a-session-only-plugin-from-loading">

412 Halten Sie ein Sitzungs-Only-Plugin davon ab, zu laden

413</h3>

414

415Um zu verhindern, dass ein `--plugin-dir`-Plugin etwas überschattet, oder um eines auszuschalten, wenn ein übergeordneter Prozess das Flag für Sie übergibt, setzen Sie seine ID auf `false` in einer beliebigen Einstellungsdatei. Für ein Plugin, dessen Manifest-Name `hello-plugin` ist, ist der Eintrag `"enabledPlugins": {"hello-plugin@inline": false}`. Ein deaktiviertes Sitzungs-Only-Plugin überschattet nicht, daher wird die Marktplatz- oder Fähigkeitsverzeichnis-Kopie stattdessen geladen.

416

417<h2 id="next-steps">

418 Nächste Schritte

419</h2>

420

421* [Plugins installieren und verwalten](/docs/de/plugins/install): die Installations-, Aktivierungs-, Deaktivierungs- und Aktualisierungsschritte selbst

422* [Plugins fehlerbeheben](/docs/de/plugins/troubleshooting): Fehlermeldungen nach der Phase, die sie produziert

423* [Plugin-Befehle-Referenz](/docs/de/plugins/cli-reference): die Flags und Befehle, die auf dieser Seite benannt werden

424* [Plugins für Ihre Organisation verwalten](/docs/de/plugins/org): die verwalteten Einstellungen, die Plugins erzwingen oder blockieren

plugins/manifest-reference.md +22 −13

Details

116* **`Validation passed with warnings`**: Das Manifest wird geladen, aber der Validator hat etwas gefunden, das zu beheben ist, z. B. ein unbekanntes Top-Level-Feld, das Claude Code entfernt, ein `name`, der nicht in Kebab-Case ist, oder ein fehlender `version`, `description` oder `author`. Übergeben Sie `--strict`, um Warnungen in CI in Fehler umzuwandeln116* **`Validation passed with warnings`**: Das Manifest wird geladen, aber der Validator hat etwas gefunden, das zu beheben ist, z. B. ein unbekanntes Top-Level-Feld, das Claude Code entfernt, ein `name`, der nicht in Kebab-Case ist, oder ein fehlender `version`, `description` oder `author`. Übergeben Sie `--strict`, um Warnungen in CI in Fehler umzuwandeln

117* **`Validation failed`**: Das Manifest hat einen Typ-Mismatch, einen Pfad, der fehlt oder den Plugin-Root verlässt, oder einen unbekannten Schlüssel in einer `userConfig`-Option, einem `channels`-Eintrag, einer `lspServers`-Konfiguration oder einem `monitors`-Eintrag. Claude Code meldet das gleiche Problem, wenn es das Plugin lädt117* **`Validation failed`**: Das Manifest hat einen Typ-Mismatch, einen Pfad, der fehlt oder den Plugin-Root verlässt, oder einen unbekannten Schlüssel in einer `userConfig`-Option, einem `channels`-Eintrag, einer `lspServers`-Konfiguration oder einem `monitors`-Eintrag. Claude Code meldet das gleiche Problem, wenn es das Plugin lädt

118 118

119Der Befehl überprüft auch jeden MCP-Server-Eintrag, den das Plugin in `.mcp.json`, in einer `.json`-Datei, die [`mcpServers`](#mcpservers) benennt, oder inline in `plugin.json` deklariert. Diese MCP-Überprüfungen erfordern Claude Code v2.1.281 oder später und umfassen:

120

121* **Fehler**: Ein Eintrag, den Claude Code beim Laden des Plugins löschen würde, eine `${user_config.KEY}`-Referenz auf eine Option, die das Manifest nicht deklariert, und eine Remote-`url`, die keine gültige absolute URL ist

122* **Warnungen**: Eine `http://`- oder `ws://`-URL zu einem Nicht-Loopback-Host und ein Header-Wert, der wie eine wörtliche Anmeldeinformation aussieht

123

119<h2 id="fields">124<h2 id="fields">

120 Felder125 Felder

121</h2>126</h2>

380 385

381Jeder Komponentenpfad in einem Manifest ist relativ zum Plugin-Root und muss mit `./` beginnen. Ein Pfad wie `commands/foo.md` schlägt die Validierung fehl. `skills` und `mcpServers` akzeptieren jeweils eine Form außerhalb dieser Regel:386Jeder Komponentenpfad in einem Manifest ist relativ zum Plugin-Root und muss mit `./` beginnen. Ein Pfad wie `commands/foo.md` schlägt die Validierung fehl. `skills` und `mcpServers` akzeptieren jeweils eine Form außerhalb dieser Regel:

382 387

383* **`skills`**: akzeptiert auch `"."`. Sowohl `"."` als auch `"./"` bezeichnen den Plugin-Root. Vor v2.1.221 schlugen `"."` die Manifest-Validierung fehl, daher verwenden Sie `"./"`, wenn das Plugin auf früheren Versionen geladen werden muss388* **`skills`**: akzeptiert auch `"."`. Sowohl `"."` als auch `"./"` bezeichnen den Plugin-Root. Vor v2.1.221 schlug `"."` die Manifest-Validierung fehl, daher verwenden Sie `"./"`, wenn das Plugin auf früheren Versionen geladen werden muss

384* **`mcpServers`**: akzeptiert auch eine `https://`-Bundle-URL389* **`mcpServers`**: akzeptiert auch eine `https://` Bundle-URL

385 390

386<h3 id="containment-and-existence">391<h3 id="containment-and-existence">

387 Eindämmung und Existenz392 Einschluss und Existenz

388</h3>393</h3>

389 394

390Jeder Komponentenpfad muss sich im Plugin-Root auflösen und muss existieren. `claude plugin validate` überprüft nicht die `outputStyles`-, `lspServers`-, `monitors`- oder `themes`-Pfade, daher schlägt ein schlechter Pfad in diesen Feldern nur fehl, wenn das Plugin geladen wird:395Jeder Komponentenpfad muss sich im Plugin-Root auflösen und muss existieren. `claude plugin validate` prüft die Pfade unter jedem Komponentenschlüssel:

391 396

392* **Eindämmung**: Ein Pfad, der sich außerhalb des Plugin-Root auflöst, wird nicht geladen, und die `/plugin`-Registerkarte **Errors** zeigt `<component> path escapes plugin directory: <path>`. Ein Pfad mit `..` ist der übliche Fall, und `claude plugin validate` meldet ihn als `Path contains ".." which could be a path traversal attempt`397* **Einschluss**: Ein Pfad, der sich außerhalb des Plugin-Root auflöst, wird nicht geladen, und die Registerkarte `/plugin` **Errors** zeigt `<component> path escapes plugin directory: <path>`. Ein Pfad mit `..` ist der übliche Fall, und `claude plugin validate` meldet den Fehler `Path contains ".." which could be a path traversal attempt`

393* **Existenz**: Ein Pfad, der nicht existiert, wird nicht geladen, und die `/plugin`-Registerkarte **Errors** zeigt `<component> path not found: <path>`. `claude plugin validate` meldet ihn als `Path not found`398* **Existenz**: Ein Pfad, der nicht existiert, wird nicht geladen, und die Registerkarte `/plugin` **Errors** zeigt `<component> path not found: <path>`. `claude plugin validate` meldet den Fehler `Path not found`

399

400Für `outputStyles`, `lspServers`, `monitors` und `themes` Pfade erfordert die `claude plugin validate` Prüfung Claude Code v2.1.283 oder später.

394 401

395<h3 id="how-each-key-combines-with-its-default-location">402<h3 id="how-each-key-combines-with-its-default-location">

396 Wie jeder Schlüssel mit seinem Standardort kombiniert wird403 Wie jeder Schlüssel mit seinem Standardort kombiniert wird

398 405

399Jeder Komponentenschlüssel ersetzt seinen Standardort, fügt zu ihm hinzu oder führt ihn zusammen:406Jeder Komponentenschlüssel ersetzt seinen Standardort, fügt zu ihm hinzu oder führt ihn zusammen:

400 407

401* **Ersetzt den Standard**: `commands`, `agents`, `outputStyles`, `workflows`, `experimental.themes`, `experimental.monitors`. Wenn Sie `commands` setzen, wird das Standard-`commands/`-Verzeichnis nicht gescannt. Um den Standard zu behalten und mehr hinzuzufügen, listen Sie ihn explizit auf: `"commands": ["./commands/", "./extras/"]`408* **Ersetzt den Standard**: `commands`, `agents`, `outputStyles`, `workflows`, `experimental.themes`, `experimental.monitors`. Wenn Sie `commands` setzen, wird das Standard-Verzeichnis `commands/` nicht gescannt. Um den Standard zu behalten und mehr hinzuzufügen, listen Sie ihn explizit auf: `"commands": ["./commands/", "./extras/"]`

402* **Fügt zum Standard hinzu**: `skills`. Das `skills/`-Verzeichnis wird immer noch gescannt, und die aufgelisteten Verzeichnisse werden zusammen mit ihm geladen409* **Fügt zum Standard hinzu**: `skills`. Das Verzeichnis `skills/` wird weiterhin gescannt, und die aufgelisteten Verzeichnisse werden zusammen mit ihm geladen

403* **Führt zusammen**: `hooks`, `mcpServers`, `lspServers`. Die Standarddatei wird zuerst geladen, und was das Manifest deklariert, wird zusammengeführt, wie unter [Komponentenpfadformen](#component-path-forms) beschrieben410* **Führt zusammen**: `hooks`, `mcpServers`, `lspServers`. Die Standard-Datei wird zuerst geladen, und das, was das Manifest deklariert, wird darin zusammengeführt, wie unter [Component path forms](#component-path-forms) beschrieben

404 411

405Wenn ein Plugin einen Standardordner wie `commands/` hat und auch den Manifest-Schlüssel setzt, der ihn ersetzt, lädt Claude Code die Manifest-Pfade und nicht den Ordner. `claude plugin list` und die `/plugin`-Schnittstelle zeigen dann die Warnung `Default <folder>/ folder is ignored because the manifest sets "<key>"`.412Wenn ein Plugin einen Standardordner wie `commands/` hat und auch den Manifest-Schlüssel setzt, der ihn ersetzt, lädt Claude Code die Manifest-Pfade und nicht den Ordner. `claude plugin list` und die `/plugin` Schnittstelle zeigen dann die Warnung `Default <folder>/ folder is ignored because the manifest sets "<key>"`.

406 413

407Um die Warnung zu vermeiden, setzen Sie den Schlüssel auf einen Pfad in diesem Ordner: `"commands": ["./commands/deploy.md"]` benennt eine Datei im Standardordner und erzeugt keine Warnung.414Um die Warnung zu vermeiden, setzen Sie den Schlüssel auf einen Pfad in diesem Ordner: `"commands": ["./commands/deploy.md"]` benennt eine Datei im Standard-Ordner und erzeugt keine Warnung.

408 415

409<h2 id="user-configuration">416<h2 id="user-configuration">

410 Benutzerkonfiguration417 Benutzerkonfiguration

561 568

562`${CLAUDE_PLUGIN_ROOT}` ändert sich, wenn das Plugin aktualisiert wird, daher schreiben Sie keinen Zustand dort. Für wo sich der Root bewegt und wann das alte Verzeichnis bereinigt wird, siehe die [Ladenseite](/docs/de/plugins/loading).569`${CLAUDE_PLUGIN_ROOT}` ändert sich, wenn das Plugin aktualisiert wird, daher schreiben Sie keinen Zustand dort. Für wo sich der Root bewegt und wann das alte Verzeichnis bereinigt wird, siehe die [Ladenseite](/docs/de/plugins/loading).

563 570

564Wenn Sie das Plugin von der letzten Stelle, an der es installiert ist, deinstallieren, wird das `${CLAUDE_PLUGIN_DATA}`-Verzeichnis gelöscht, es sei denn, Sie übergeben [`--keep-data`](/docs/de/plugins/cli-reference).571Standardmäßig löscht Claude Code das `${CLAUDE_PLUGIN_DATA}`-Verzeichnis, wenn Sie das Plugin von der letzten Stelle, an der es installiert ist, deinstallieren. Für `--keep-data` und die anderen Fälle, in denen es erhalten bleibt, siehe [Plugin deinstallieren](/docs/de/plugins/cli-reference#plugin-uninstall).

565 572

566<h3 id="where-each-variable-resolves">573<h3 id="where-each-variable-resolves">

567 Wo jede Variable sich auflöst574 Wo jede Variable sich auflöst

589* **Hook-Befehle**: Verwenden Sie [Exec-Form](/docs/de/hooks#exec-form-and-shell-form) mit `args`, damit jeder Pfad ein Argument ohne Anführungszeichen ist596* **Hook-Befehle**: Verwenden Sie [Exec-Form](/docs/de/hooks#exec-form-and-shell-form) mit `args`, damit jeder Pfad ein Argument ohne Anführungszeichen ist

590* **Shell-Form-Hooks und Monitor-Befehle**: Wickeln Sie die Variable in doppelte Anführungszeichen ein, damit ein Pfad mit Leerzeichen ein Wort bleibt597* **Shell-Form-Hooks und Monitor-Befehle**: Wickeln Sie die Variable in doppelte Anführungszeichen ein, damit ein Pfad mit Leerzeichen ein Wort bleibt

591 598

599Wenn Sie eine dieser Variablen außerhalb von Anführungszeichen in einem Shell-Form-Befehl in einer Hooks-Datei lassen, warnt `claude plugin validate` davor, es sei denn, der Hook setzt [`shell`](/docs/de/hooks#command-hook-fields) auf `"powershell"`.

600

592Dieser Shell-Form-Hook führt ein Skript aus, das mit dem Plugin gebündelt ist:601Dieser Shell-Form-Hook führt ein Skript aus, das mit dem Plugin gebündelt ist:

593 602

594```json theme={null}603```json theme={null}

632| Ausführbare Dateien | `bin/` | Dateien hier sind auf dem Bash-Tool's `PATH`, während das Plugin aktiviert ist, daher führt Claude sie als bloße Befehle aus. claude.ai und Cowork installieren kein Plugin, das dieses Verzeichnis hat, einschließlich eines, das Sie [durch claude.ai-Organisationseinstellungen verteilen](/docs/de/plugins/host-marketplace#distribute-through-organization-settings) |641| Ausführbare Dateien | `bin/` | Dateien hier sind auf dem Bash-Tool's `PATH`, während das Plugin aktiviert ist, daher führt Claude sie als bloße Befehle aus. claude.ai und Cowork installieren kein Plugin, das dieses Verzeichnis hat, einschließlich eines, das Sie [durch claude.ai-Organisationseinstellungen verteilen](https://claude.com/docs/plugins/org-sync#keep-executables-out-of-the-top-level-bin-directory) |

634 643

635Ein Plugin, das jeden Standardort verwendet, plus einen `scripts/`-Ordner, den seine Hooks aufrufen, ist wie folgt angeordnet:644Ein Plugin, das jeden Standardort verwendet, plus einen `scripts/`-Ordner, den seine Hooks aufrufen, ist wie folgt angeordnet:

plugins/marketplace-reference.md +3 −1

Details

47* **Offizielle Marketplace-Namen**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` und `claude-tag-plugins`. Reserviert, es sei denn, der Marketplace stammt von einer `github`- oder `git`-[Marketplace-Quelle](#marketplace-sources) unter `github.com/anthropics/`.47* **Offizielle Marketplace-Namen**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` und `claude-tag-plugins`. Reserviert, es sei denn, der Marketplace stammt von einer `github`- oder `git`-[Marketplace-Quelle](#marketplace-sources) unter `github.com/anthropics/`.

48* **Community-Marketplace-Namen**: `claude-community`, `claude-plugins-community` und `healthcare`. Reserviert nach der gleichen Regel wie die offiziellen Namen.48* **Community-Marketplace-Namen**: `claude-community`, `claude-plugins-community` und `healthcare`. Reserviert nach der gleichen Regel wie die offiziellen Namen.

49* **Plugin-Verzeichnisnamen**: `anthropic-plugin-directory` und `claude-plugin-directory`. Reserviert nach der gleichen Regel wie die offiziellen Namen.49* **Plugin-Verzeichnisnamen**: `anthropic-plugin-directory` und `claude-plugin-directory`. Reserviert nach der gleichen Regel wie die offiziellen Namen.

50* **Namen, die einen offiziellen Marketplace imitieren**: Namen wie `official-claude-plugins` oder `claude-plugins-v2` und jeder Name, der ein Nicht-ASCII-Zeichen enthält. Der Fehler ist `Marketplace name impersonates an official Anthropic/Claude marketplace`. Ein Steuerzeichen oder bidirektionales Formatierungszeichen in einem Namen meldet auch `Marketplace name cannot contain control or bidirectional-formatting characters`.50* **Namen, die einen offiziellen Marketplace imitieren**: Namen wie `official-claude-plugins` oder `claude-plugins-v2` und jeder Name, der ein Nicht-ASCII-Zeichen enthält. Der Fehler ist `Marketplace name impersonates an official Anthropic/Claude marketplace`. Ein Steuerzeichen oder bidirektionales Formatierungszeichen in einem Namen meldet auch `Marketplace name cannot contain control or bidirectional-formatting characters`. Ein bereits unter einem solchen Namen registrierter Marketplace wird nicht mehr geladen, zusammen mit seinen Plugins.

51* <span id="reserved-name-spellings" />**Eine andere Schreibweise eines reservierten Namens**: ein Name, der sich von einem reservierten Namen nur durch einen nachgestellten Punkt oder durch ein Symbol anstelle eines Bindestrichs unterscheidet, daher zählt `claude.code.plugins` als `claude-code-plugins`. `claude plugin validate` akzeptiert einen solchen Namen; das Hinzufügen des Marketplace schlägt mit [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/de/errors#marketplace-name-is-another-spelling-of-a-reserved-name) fehl, und ein bereits unter einem registrierter Marketplace wird nicht mehr geladen. Diese Überprüfung erfordert Claude Code v2.1.280 oder später.51* <span id="reserved-name-spellings" />**Eine andere Schreibweise eines reservierten Namens**: ein Name, der sich von einem reservierten Namen nur durch einen nachgestellten Punkt oder durch ein Symbol anstelle eines Bindestrichs unterscheidet, daher zählt `claude.code.plugins` als `claude-code-plugins`. `claude plugin validate` akzeptiert einen solchen Namen; das Hinzufügen des Marketplace schlägt mit [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/de/errors#marketplace-name-is-another-spelling-of-a-reserved-name) fehl, und ein bereits unter einem registrierter Marketplace wird nicht mehr geladen. Diese Überprüfung erfordert Claude Code v2.1.280 oder später.

52* **Namen, die Claude Code für Plugins verwendet, die nicht von einem Marketplace stammen**: `inline` für Plugins, die mit [`--plugin-dir`](/docs/de/cli-reference) geladen werden, `builtin` für integrierte Plugins, `skills-dir` für Plugins, die automatisch von [`.claude/skills/`](/docs/de/skills) geladen werden, und `synced` für Plugins, die von Ihrem claude.ai-Konto synchronisiert werden. `claude-plugin-test` ist ebenfalls reserviert. `skills-dir` erscheint auch als `{"source": "skills-dir"}` in `strictKnownMarketplaces` und `blockedMarketplaces`, beschrieben unter [Quellwerte, die nur in Richtlinienlisten gültig sind](#source-values-valid-only-in-policy-lists).52* **Namen, die Claude Code für Plugins verwendet, die nicht von einem Marketplace stammen**: `inline` für Plugins, die mit [`--plugin-dir`](/docs/de/cli-reference) geladen werden, `builtin` für integrierte Plugins, `skills-dir` für Plugins, die automatisch von [`.claude/skills/`](/docs/de/skills) geladen werden, und `synced` für Plugins, die von Ihrem claude.ai-Konto synchronisiert werden. `claude-plugin-test` ist ebenfalls reserviert. `skills-dir` erscheint auch als `{"source": "skills-dir"}` in `strictKnownMarketplaces` und `blockedMarketplaces`, beschrieben unter [Quellwerte, die nur in Richtlinienlisten gültig sind](#source-values-valid-only-in-policy-lists).

53* **`npm`, `pip`, `uv`, `cargo`, `github` und `gh`**: reserviert in jeder Schreibweise. Diese Überprüfung erfordert Claude Code v2.1.275 oder später.53* **`npm`, `pip`, `uv`, `cargo`, `github` und `gh`**: reserviert in jeder Schreibweise. Diese Überprüfung erfordert Claude Code v2.1.275 oder später.

54* **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.54* **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 55

56Wenn 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.

56<h2 id="top-level-fields">58<h2 id="top-level-fields">

57 Top-Level-Felder59 Top-Level-Felder

58</h2>60</h2>

plugins/measure.md +2 −0

Details

96* **Sie sind Teamkollegen, die Sie fragen können**: Claudes eigenes Claude Code zeigt jedem Benutzer, ob er das Plugin noch verwendet, an vier Stellen: das [`/plugin` Panel](#not-used-recently-in-/plugin), [`/skill-doctor`](#find-skills-that-never-run), [`/doctor`](#unused-plugins-in-/doctor) und [`/usage`](#usage-share-in-/usage). Alle vier sind Commands, die der Benutzer an der Claude Code-Eingabeaufforderung in einer Sitzung auf seinem eigenen Computer ausführt.96* **Sie sind Teamkollegen, die Sie fragen können**: Claudes eigenes Claude Code zeigt jedem Benutzer, ob er das Plugin noch verwendet, an vier Stellen: das [`/plugin` Panel](#not-used-recently-in-/plugin), [`/skill-doctor`](#find-skills-that-never-run), [`/doctor`](#unused-plugins-in-/doctor) und [`/usage`](#usage-share-in-/usage). Alle vier sind Commands, die der Benutzer an der Claude Code-Eingabeaufforderung in einer Sitzung auf seinem eigenen Computer ausführt.

97* **Keines von beiden**: Sie haben kein Nutzungssignal von Claude Code für dieses Plugin.97* **Keines von beiden**: Sie haben kein Nutzungssignal von Claude Code für dieses Plugin.

98 98

99Für die Nutzung eines Plugins, das in Anthropics Verzeichnis aufgelistet ist, siehe [Track published plugin usage](https://claude.com/docs/connectors/building/after-publishing#track-published-plugin-usage) auf claude.com.

100

99<h3 id="not-used-recently-in-/plugin">101<h3 id="not-used-recently-in-/plugin">

100 Nicht kürzlich verwendet in `/plugin`102 Nicht kürzlich verwendet in `/plugin`

101</h3>103</h3>

plugins/org.md +2 −1

Details

14 Diese Fälle werden auf anderen Seiten behandelt:14 Diese Fälle werden auf anderen Seiten behandelt:

15 15

16 * **Installieren von Plugins für sich selbst**: Beginnen Sie bei [Plugins installieren](/docs/de/plugins/install)16 * **Installieren von Plugins für sich selbst**: Beginnen Sie bei [Plugins installieren](/docs/de/plugins/install)

17 * **Kontrollieren, welche Plugins Mitglieder in claude.ai und Cowork verwenden können**: siehe [Verwalten Sie Plugins für Ihre Organisation](https://support.claude.com/en/articles/13837433) im Hilfecenter17 * **Kontrollieren, welche Plugins Mitglieder in claude.ai und Cowork verwenden können**: siehe [Verwalten Sie Plugins für Ihre Organisation](https://claude.com/docs/plugins/admin) auf claude.com

18 * **Rollout eines Plugins auf claude.ai, Cowork und Claude Code zusammen**: siehe [Wählen Sie eine Rollout-Route](https://claude.com/docs/plugins/org-rollout#choose-a-rollout-route) auf claude.com

18 * **Die Plugins-Seite in den Administratoreinstellungen von claude.ai**: [**Organisationseinstellungen > Plugins & Skills**](https://claude.ai/admin-settings/skills?tab=inventory) aktiviert Plugins für die claude.ai-Konten der Mitglieder, und diese erreichen Claude Code als [synchronisierte Plugins](/docs/de/plugins/loading#synced-plugins). Es werden keine der Schlüssel auf dieser Seite gesetzt19 * **Die Plugins-Seite in den Administratoreinstellungen von claude.ai**: [**Organisationseinstellungen > Plugins & Skills**](https://claude.ai/admin-settings/skills?tab=inventory) aktiviert Plugins für die claude.ai-Konten der Mitglieder, und diese erreichen Claude Code als [synchronisierte Plugins](/docs/de/plugins/loading#synced-plugins). Es werden keine der Schlüssel auf dieser Seite gesetzt

19</Note>20</Note>

20 21

plugins/overview.md +6 −3

Details

9Ein Claude Code-Plugin ist ein Verzeichnis von Skills, Agents, Hooks, MCP-Servern oder anderen Komponenten, die Claude Code als eine Einheit installiert und lädt. Die meisten Plugins stammen aus einem Marketplace, der ein Katalog ist, der Plugins auflistet und anzeigt, wo man sie abruft. Sie können auch ein Plugin aus einem Ordner laden, den Ihnen jemand gibt, oder [Ihr eigenes erstellen](/docs/de/plugins/create).9Ein Claude Code-Plugin ist ein Verzeichnis von Skills, Agents, Hooks, MCP-Servern oder anderen Komponenten, die Claude Code als eine Einheit installiert und lädt. Die meisten Plugins stammen aus einem Marketplace, der ein Katalog ist, der Plugins auflistet und anzeigt, wo man sie abruft. Sie können auch ein Plugin aus einem Ordner laden, den Ihnen jemand gibt, oder [Ihr eigenes erstellen](/docs/de/plugins/create).

10 10

11<Note>11<Note>

~~12 Wenn Sie claude.ai Chat oder Cowork verwenden und nicht Claude Code, siehe [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview).~~12 Starten Sie stattdessen auf claude.com, wenn einer dieser Punkte auf Sie zutrifft:

14 * **Sie verwenden claude.ai Chat oder Cowork und nicht Claude Code**: siehe [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview)

15 * **Sie haben einen MCP-Server erstellt und möchten ihn in Anthropics Verzeichnis**: siehe [Im Verzeichnis veröffentlichen](https://claude.com/docs/directory/publish)

13</Note>16</Note>

14 17

15Um jetzt ein Plugin auszuprobieren, führen Sie `/plugin` in einer Claude Code-Terminalsitzung aus und installieren Sie eines aus der Registerkarte **Discover**, die die Plugins aus Anthropics offiziellem Marketplace und jedem Marketplace auflistet, den Sie hinzugefügt haben. Von dort aus:18Um jetzt ein Plugin auszuprobieren, führen Sie `/plugin` in einer Claude Code-Terminalsitzung aus und installieren Sie eines aus der Registerkarte **Discover**, die die Plugins aus Anthropics offiziellem Marketplace und jedem Marketplace auflistet, den Sie hinzugefügt haben. Von dort aus:

122Eine Cloud-Sitzung, einschließlich einer im Browser unter claude.ai/code, lädt nicht die Plugins in Ihren lokalen Einstellungen. Für Installationsschritte im Terminal, VS Code und der Desktop-App sowie für das, was eine Cloud-Sitzung lädt, siehe [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin).125Eine Cloud-Sitzung, einschließlich einer im Browser unter claude.ai/code, lädt nicht die Plugins in Ihren lokalen Einstellungen. Für Installationsschritte im Terminal, VS Code und der Desktop-App sowie für das, was eine Cloud-Sitzung lädt, siehe [Ein Plugin installieren](/docs/de/plugins/install#install-a-plugin).

123 126

124<Note>127<Note>

125 Das gleiche Plugin-Format wird auch auf claude.ai und in Cowork installiert, wo ein anderer Satz von Komponenten geladen wird. Für diese Oberflächen siehe [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview) auf claude.com.128 Das gleiche Plugin-Format wird auch auf claude.ai und in Cowork installiert, wo ein anderer Satz von Komponenten geladen wird. Für diese Oberflächen siehe [Plugins auf claude.ai und in Cowork](https://claude.com/docs/plugins/overview) auf claude.com und seine [Komponentenunterstützungstabelle](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app).

126</Note>129</Note>

127 130

128<h2 id="next-steps">131<h2 id="next-steps">

135 138

136Sobald Sie ein Plugin installiert oder erstellt haben, behandeln diese Seiten das, was als Nächstes kommt:139Sobald Sie ein Plugin installiert oder erstellt haben, behandeln diese Seiten das, was als Nächstes kommt:

137 140

138* **Teilen Sie das, was Sie erstellt haben**: [Veröffentlichen und verteilen Sie ein Plugin](/docs/de/plugins/publish)141* **Teilen Sie das, was Sie erstellt haben**: [Veröffentlichen und verteilen Sie ein Plugin](/docs/de/plugins/publish), über Ihren eigenen Marketplace oder [Anthropics Verzeichnis](/docs/de/plugins/publish#submit-to-anthropics-directory)

139* **Überprüfen Sie, ob es funktioniert und verwendet wird**: [Testen Sie Plugins mit Evals](/docs/de/plugin-evals) und [Messen Sie Plugin-Kosten und -Nutzung](/docs/de/plugins/measure)142* **Überprüfen Sie, ob es funktioniert und verwendet wird**: [Testen Sie Plugins mit Evals](/docs/de/plugin-evals) und [Messen Sie Plugin-Kosten und -Nutzung](/docs/de/plugins/measure)

140* **Führen Sie einen Marketplace für Ihr Team aus**: [Erstellen Sie einen Marketplace](/docs/de/plugins/create-marketplace), dann [Hosten und verwalten Sie einen Marketplace](/docs/de/plugins/host-marketplace)143* **Führen Sie einen Marketplace für Ihr Team aus**: [Erstellen Sie einen Marketplace](/docs/de/plugins/create-marketplace), dann [Hosten und verwalten Sie einen Marketplace](/docs/de/plugins/host-marketplace)

141* **Legen Sie Plugin-Richtlinie für eine Organisation fest**: [Verwalten Sie Plugins für Ihre Organisation](/docs/de/plugins/org)144* **Legen Sie Plugin-Richtlinie für eine Organisation fest**: [Verwalten Sie Plugins für Ihre Organisation](/docs/de/plugins/org)

plugins/publish.md +21 −18

Details

4 4

5# Ein Plugin veröffentlichen und verteilen5# Ein Plugin veröffentlichen und verteilen

6 6

~~7> Veröffentlichen Sie ein Claude Code Plugin über Ihren eigenen Marketplace oder Anthropics Community Marketplace, mit einer Pre-Release-Checkliste und wie Benutzer Updates erhalten.~~7> Veröffentlichen Sie ein Claude Code Plugin über Ihren eigenen Marketplace oder Anthropics Verzeichnis, mit einer Pre-Release-Checkliste und wie Benutzer Updates erhalten.

8 8

9Ein Claude Code Plugin zu veröffentlichen bedeutet, es in einem Marketplace aufzulisten – einem JSON-Katalog, der Plugins auflistet und angibt, wo jedes abgerufen werden kann – damit andere Personen es nach Name installieren können und Ihre Updates erhalten. Sie können Ihren eigenen Marketplace betreiben oder Ihr Plugin bei Anthropics Community Marketplace einreichen. Um ein Plugin ohne Veröffentlichung zu teilen, senden Sie Personen das Plugin-Verzeichnis oder eine `.zip` davon zum selbst Laden.9Ein Claude Code Plugin zu veröffentlichen bedeutet, es in einem Marketplace aufzulisten – einem JSON-Katalog, der Plugins auflistet und angibt, wo jedes abgerufen werden kann – damit andere Personen es nach Name installieren können und Ihre Updates erhalten. Sie können Ihren eigenen Marketplace betreiben oder Ihr Plugin bei Anthropics Verzeichnis einreichen. Um ein Plugin ohne Veröffentlichung zu teilen, senden Sie Personen das Plugin-Verzeichnis oder eine `.zip` davon zum selbst Laden.

10 10

11Diese Seite ist für den Autor eines funktionierenden Plugins, der bereit ist, es zu teilen.11Diese Seite ist für den Autor eines funktionierenden Plugins, der bereit ist, es zu teilen.

12 12

29| :- | :- | :- | :- |29| :- | :- | :- | :- |

31| [Ihr eigener Marketplace](#publish-through-your-own-marketplace) | Jeder, der das Repository erreichen kann, das privat sein kann und Ihr Team klonen kann | Ein Git-Repository oder ein anderer Host mit einer `.claude-plugin/marketplace.json`, die Ihr Plugin auflistet | Aus |31| [Ihr eigener Marketplace](#publish-through-your-own-marketplace) | Jeder, der das Repository erreichen kann, das privat sein kann und Ihr Team klonen kann | Ein Git-Repository oder ein anderer Host mit einer `.claude-plugin/marketplace.json`, die Ihr Plugin auflistet | Aus |

32| [Anthropics Community Marketplace](#submit-to-the-community-marketplace) | Jeder, der `anthropics/claude-plugins-community` hinzufügt | Eine Einreichung über das Plugin-Verzeichnis-Einreichungsformular | Aus |32| [Anthropics Verzeichnis](#submit-to-anthropics-directory) | Personen, die es auf claude.ai oder in Cowork hinzufügen. Es wird auch in ihren Claude Code-Sitzungen durch [Kontosynchronisierung](/docs/de/plugins/loading#synced-plugins) geladen | Ein GitHub-Repository, das das Plugin enthält, und einen bezahlten claude.ai-Plan zum Einreichen | Ja, nachdem die Version, die Sie pushen, veröffentlicht wurde |

33 33

34Auto-Update ist eine Einstellung pro Marketplace auf der Benutzerseite, die neue Versionen im Hintergrund abruft.34Auto-Update ist eine Einstellung pro Marketplace auf der Benutzerseite, die neue Versionen im Hintergrund abruft.

35 35

141 141

142[Installieren Sie Plugins](/docs/de/plugins/install) behandelt die Befehle auf der Benutzerseite, und [wenn Auto-Update ausgeführt wird](/docs/de/plugins/loading#when-auto-update-runs) behandelt das Timing.142[Installieren Sie Plugins](/docs/de/plugins/install) behandelt die Befehle auf der Benutzerseite, und [wenn Auto-Update ausgeführt wird](/docs/de/plugins/loading#when-auto-update-runs) behandelt das Timing.

143 143

144<h2 id="submit-to-the-community-marketplace">144<h2 id="submit-to-anthropics-directory">

145 Reichen Sie beim Community Marketplace ein145 Bei Anthropics Verzeichnis einreichen

146</h2>146</h2>

147 147

148Anthropics Community Marketplace, `claude-community`, ist der öffentliche Marketplace, der Plugins auflistet, die über das Plugin-Verzeichnis-Einreichungsformular eingereicht wurden.148Anthropics Verzeichnis ist der Katalog, den Benutzer auf claude.ai und in Cowork durchsuchen, um Plugins und Connectors hinzuzufügen. Eine Auflistung dort erreicht Benutzer auf claude.ai, in Cowork und in Claude Code. Sie reichen über das Entwicklerportal unter [claude.ai/directory/manage](https://claude.ai/directory/manage) ein; [Vorbereitung auf die Überprüfung](https://claude.com/docs/directory/publish#prepare-for-review) auf claude.com beschreibt, was mit jeder Version vor der Veröffentlichung geschieht.

149 149

150Benutzer fügen den Community Marketplace in einer Claude Code-Sitzung mit `/plugin marketplace add anthropics/claude-plugins-community` hinzu und installieren davon als `@claude-community`.150Das Einreichen erfordert einen kostenpflichtigen claude.ai-Plan. Bei Pro und Max reichen Sie von Ihrem eigenen Konto ein. Bei Team und Enterprise kann ein Eigentümer einreichen, und bei Enterprise kann ein Eigentümer auch die **Directory**-Berechtigung anderen Mitgliedern durch eine benutzerdefinierte Rolle unter **Organization settings > Roles** gewähren. Siehe [Bestätigen Sie, dass Sie beim Verzeichnis einreichen können](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory).

151 151

152Für die Unterschiede zwischen dem Community Marketplace und dem offiziellen Marketplace siehe [Anthropics Marketplaces](/docs/de/plugins/anthropic-marketplaces).152Die Einreichungsschritte, die Überprüfungen, die jede Version bestehen muss, und was nach der Veröffentlichung geschieht, sind auf claude.com dokumentiert, da sie gleich sind, unabhängig davon, welche Oberfläche Ihre Benutzer verwenden:

153 153

154Um Ihr Plugin beim Community Marketplace einzureichen, verwenden Sie eines der In-App-Formulare:154* [Im Verzeichnis veröffentlichen](https://claude.com/docs/directory/publish#before-you-submit-to-the-directory): was Sie einreichen können und wer es einreichen kann

155* [Ein Plugin einreichen](https://claude.com/docs/plugins/submit#submit-a-plugin): die Portalschritte und [Aktualisierung eines veröffentlichten Plugins](https://claude.com/docs/plugins/submit#update-a-published-plugin)

156* [Plugin-Checkliste vor der Einreichung](https://claude.com/docs/plugins/pre-submission-checklist#run-the-checks-before-you-submit): die Überprüfungen, die Sie vor der Einreichung ausführen und beheben müssen

157* [Eine frühere Einreichung zum Entwicklerportal verschieben](https://claude.com/docs/directory/publish#move-an-earlier-submission-to-the-developer-portal): was zu tun ist, wenn Sie ein Plugin über eines der früheren Einreichungsformulare eingereicht haben, bevor das Portal existierte

155 158

156* **claude.ai**: [claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)159Bevor Sie das Portal öffnen, validieren Sie lokal und überprüfen Sie, welche Ihrer Komponenten außerhalb von Claude Code geladen werden:

157* **Console**: [platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

158 160

159Das claude.ai-Formular erfordert eine Team- oder Enterprise-Organisation und die Directory-Berechtigung, die Eigentümer standardmäßig haben. Einzelne Autoren, die nicht Teil einer Team- oder Enterprise-Organisation sind, können stattdessen das Console-Formular verwenden.161* **Führen Sie `claude plugin validate ./your-plugin --strict` in Ihrer Shell aus**: ersetzen Sie `./your-plugin` durch den Pfad zu Ihrem Plugin-Verzeichnis. Der Befehl erfasst Manifest-Fehler lokal; [plugin validate](/docs/de/plugins/cli-reference#plugin-validate) listet auf, welche Dateien jeder Durchlauf liest. Das Portal wendet zusätzliche Verzeichnisregeln an, die die CLI nicht überprüft, daher garantiert ein sauberer lokaler Durchlauf keine saubere Portal-Validierung.

162* **Überprüfen Sie, was wo geladen wird**: Einige Plugin-Komponenten sind nur für Claude Code und werden nicht auf claude.ai oder in Cowork geladen. Die [Komponentenunterstützungstabelle](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) listet jede Komponente nach App auf, damit Sie wissen, was Benutzer außerhalb von Claude Code erhalten.

160 163

161Führen Sie in Ihrer Shell `claude plugin validate ./your-plugin` lokal aus, bevor Sie einreichen, wobei Sie `./your-plugin` durch den Pfad zu Ihrem Plugin-Verzeichnis ersetzen. Wenn die Validierung erfolgreich ist, druckt Claude Code `✔ Validation passed`, oder `✔ Validation passed with warnings`, wenn es Warnungen gibt. Warnungen führen nicht zu Validierungsfehlern; fügen Sie `--strict` hinzu, um sie als Fehler zu behandeln.164Anthropics offizieller Marketplace, `claude-plugins-official`, akzeptiert keine Einreichungen über das Verzeichnisportal. Wenn Sie mit einem Anthropic-Partner-Kontakt zusammenarbeiten, fragen Sie ihn nach einer Auflistung im offiziellen Marketplace.

162 165

163Aufgelistete Plugins erscheinen im [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community)-Katalog, in fast jedem Fall an einen bestimmten Commit SHA angeheftet.166<h3 id="how-a-listed-plugin-reaches-claude-code-users">

~~164~~ 167 Wie ein aufgelistetes Plugin Claude Code-Benutzer erreicht

165Es kann eine Verzögerung zwischen der Einreichung und dem Erscheinen Ihres Plugins in `marketplace.json` geben. Um zu überprüfen, ob Ihr Plugin bereits installierbar ist, suchen Sie nach seinem Namen im [Community-Katalog](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json).168</h3>

166 169

167Der offizielle Marketplace, `claude-plugins-official`, akzeptiert keine Einreichungen über diese Formulare. Wenn Sie mit einem Anthropic-Partner-Kontakt zusammenarbeiten, fragen Sie ihn nach einer Auflistung im offiziellen Marketplace.170Eine Person, die Ihr Plugin aus dem Verzeichnis auf claude.ai installiert, hat es auf ihrem Konto, und Claude Code lädt es als `<name>@synced`. [Plugins, die von claude.ai synchronisiert werden](/docs/de/plugins/loading#synced-plugins) behandelt, was sie sehen und wie sie es ausschalten.

168 171

169<h2 id="ship-updates-renames-and-removals">172<h2 id="ship-updates-renames-and-removals">

170 Versenden Sie Updates, Umbenennungen und Entfernungen173 Versenden Sie Updates, Umbenennungen und Entfernungen

174 Veröffentlichen Sie eine neue Version177 Veröffentlichen Sie eine neue Version

175</h3>178</h3>

176 179

177Wenn Sie über Ihren eigenen Marketplace veröffentlichen und Ihre `plugin.json` `version` setzt, erhöhen Sie sie und pushen Sie. Benutzer, die `claude plugin update` ausführen oder Auto-Update aktiviert haben, erhalten dann die neue Version, wie unter [Versenden Sie Updates an Benutzer](#ship-updates-to-users) beschrieben.180Wenn Sie über Ihren eigenen Marketplace veröffentlichen und Ihre `plugin.json` `version` setzt, erhöhen Sie sie und pushen Sie. Benutzer, die `claude plugin update` ausführen oder Auto-Update aktiviert haben, erhalten dann die neue Version, wie unter [Versenden Sie Updates an Benutzer](#ship-updates-to-users) beschrieben. Für ein Verzeichnislisting siehe [Aktualisieren Sie ein veröffentlichtes Plugin](https://claude.com/docs/plugins/submit#update-a-published-plugin).

178 181

179<h3 id="tag-a-release">182<h3 id="tag-a-release">

180 Markieren Sie eine Veröffentlichung183 Markieren Sie eine Veröffentlichung

plugins/security.md +1 −1

Details

118 118

119Führen Sie in Ihrer Shell [`claude plugin uninstall <plugin>`](/docs/de/plugins/cli-reference#plugin-uninstall) mit dem `--scope` aus, in dem Sie es installiert haben. Überprüfen Sie dann, was die Deinstallation entfernt hat und was sie hinterlassen hat:119Führen Sie in Ihrer Shell [`claude plugin uninstall <plugin>`](/docs/de/plugins/cli-reference#plugin-uninstall) mit dem `--scope` aus, in dem Sie es installiert haben. Überprüfen Sie dann, was die Deinstallation entfernt hat und was sie hinterlassen hat:

120 120

121* **Persistente Daten**: wenn dies der letzte Scope war, in dem das Plugin installiert war, löscht die Deinstallation auch das Verzeichnis mit persistenten Daten des Plugins, es sei denn, Sie übergeben `--keep-data`.121* **Persistente Daten**: Standardmäßig wird beim Deinstallieren, wenn dies der letzte Scope war, in dem das Plugin installiert war, auch das Verzeichnis mit persistenten Daten des Plugins gelöscht. Für `--keep-data` und die anderen Fälle, in denen es bestehen bleibt, siehe [plugin uninstall](/docs/de/plugins/cli-reference#plugin-uninstall).

122* **Zwischengespeicherte Dateien**: die Dateien des Plugins bleiben auf der Festplatte unter `~/.claude/plugins/cache/` für 14 Tage, bevor ein [Hintergrund-Sweep sie entfernt](/docs/de/plugins/loading#cleanup-of-previous-versions). Nachdem Sie Ihr letztes Plugin deinstalliert haben, bleiben verwaiste Verzeichnisse bestehen, bis Sie ein anderes installieren. Um die Dateien jetzt zu löschen, entfernen Sie das Verzeichnis des Plugins unter `~/.claude/plugins/cache/<marketplace>/<plugin>/` selbst.122* **Zwischengespeicherte Dateien**: die Dateien des Plugins bleiben auf der Festplatte unter `~/.claude/plugins/cache/` für 14 Tage, bevor ein [Hintergrund-Sweep sie entfernt](/docs/de/plugins/loading#cleanup-of-previous-versions). Nachdem Sie Ihr letztes Plugin deinstalliert haben, bleiben verwaiste Verzeichnisse bestehen, bis Sie ein anderes installieren. Um die Dateien jetzt zu löschen, entfernen Sie das Verzeichnis des Plugins unter `~/.claude/plugins/cache/<marketplace>/<plugin>/` selbst.

123* **Der Marketplace**: wenn Sie dem Besitzer des Marketplace auch nicht vertrauen, [entfernen Sie auch den Marketplace](/docs/de/plugins/install#manage-marketplaces), was jedes Plugin deinstalliert, das Sie von ihm installiert haben.123* **Der Marketplace**: wenn Sie dem Besitzer des Marketplace auch nicht vertrauen, [entfernen Sie auch den Marketplace](/docs/de/plugins/install#manage-marketplaces), was jedes Plugin deinstalliert, das Sie von ihm installiert haben.

124 124

plugins/troubleshooting.md +11 −1

Details

676 `Failed to load hooks from <path>` und Hooks, die nicht ausgelöst werden676 `Failed to load hooks from <path>` und Hooks, die nicht ausgelöst werden

677</h3>677</h3>

678 678

679Die Hooks eines Plugins werden nicht ausgeführt. Entweder zeigt die Registerkarte **Errors** einen Ladefehler dafür, die Hooks laden und Sie sehen `<Event> hook error`-Hinweise im Transkript, oder ein Hook lädt ohne Fehler und wird nie ausgelöst.679Die Hooks eines Plugins werden nicht ausgeführt, oder einer blockiert eine Aktion. Entweder zeigt die Registerkarte **Errors** einen Ladefehler dafür, die Hooks laden und Sie sehen `<Event> hook error`-Hinweise oder einen blockierenden Fehler im Transkript, oder ein Hook lädt ohne Fehler und wird nie ausgelöst.

680 680

681<h4 id="hooks-fail-to-load">681<h4 id="hooks-fail-to-load">

682 Hooks können nicht geladen werden682 Hooks können nicht geladen werden

693 693

694Ein Hinweis der Form `... hook error: Failed with non-blocking status code: <stderr>` bedeutet, dass der Hook ausgeführt wurde und sein Befehl fehlgeschlagen ist. Beispielsweise bedeutet `Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found`, dass die Shell, die Claude Code erzeugt hat, `node` nicht finden konnte. Installieren Sie es, oder stellen Sie sicher, dass es sich auf dem `PATH` des Terminals befindet, von dem Sie `claude` starten.694Ein Hinweis der Form `... hook error: Failed with non-blocking status code: <stderr>` bedeutet, dass der Hook ausgeführt wurde und sein Befehl fehlgeschlagen ist. Beispielsweise bedeutet `Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found`, dass die Shell, die Claude Code erzeugt hat, `node` nicht finden konnte. Installieren Sie es, oder stellen Sie sicher, dass es sich auf dem `PATH` des Terminals befindet, von dem Sie `claude` starten.

695 695

696Wenn stderr den Pfad des Plugins bei einem Leerzeichen abgeschnitten zeigt, verwendet der Shell-Form-Befehl des Hooks `${CLAUDE_PLUGIN_ROOT}` außerhalb von Anführungszeichen und der Installationspfad enthält ein Leerzeichen. Wickeln Sie die Variable in doppelte Anführungszeichen ein oder verwenden Sie [exec-Form](/docs/de/hooks#exec-form-and-shell-form). Um die unquotierte Variable zu finden, führen Sie `claude plugin validate` im Plugin-Verzeichnis aus und suchen Sie nach seiner [Quoting-Warnung](/docs/de/plugins/manifest-reference#quoting-and-path-separators).

697

696Für jeden anderen Fehler führen Sie den Befehl des Hooks selbst aus dem Plugin-Verzeichnis aus, um die vollständige Ausgabe zu sehen, oder erfassen Sie den vollständigen stderr mit [Debug-Protokollierung](/docs/de/hooks#debug-hooks).698Für jeden anderen Fehler führen Sie den Befehl des Hooks selbst aus dem Plugin-Verzeichnis aus, um die vollständige Ausgabe zu sehen, oder erfassen Sie den vollständigen stderr mit [Debug-Protokollierung](/docs/de/hooks#debug-hooks).

697 699

700<h4 id="a-plugin-hook-blocks-a-tool-call-or-prompt">

701 Ein Plugin-Hook blockiert einen Tool-Aufruf oder eine Eingabeaufforderung

702</h4>

703

704Ein Hook, der mit Code 2 beendet wird, [blockiert die Aktion, für die er ausgeführt wurde](/docs/de/hooks#exit-code-2). Wenn ein Plugin-Hook auf diese Weise blockiert und sein stderr die blockierende Meldung ist, endet der Fehler mit `This hook comes from the <plugin> plugin.`, damit Sie wissen, welches Plugin Sie deaktivieren oder beheben müssen. Vor v2.1.281 benannte der Fehler das Plugin nicht.

705

706Wenn diese Meldung den Pfad des Plugins bei einem Leerzeichen abgeschnitten zeigt, wenden Sie die [unquotierte `${CLAUDE_PLUGIN_ROOT}`-Behebung](#hook-error-notices-in-the-transcript) an.

707

698<h4 id="hook-loads-but-never-fires">708<h4 id="hook-loads-but-never-fires">

699 Hook lädt, aber wird nie ausgelöst709 Hook lädt, aber wird nie ausgelöst

700</h4>710</h4>

prompt-caching.md +29 −17

Details

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

38 38

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

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

41 41

42<Tip>42<Tip>

43 Wählen Sie Ihr Modell und Ihre Aufwandsstufe am Anfang einer Sitzung aus, und speichern Sie dann `/compact` für natürliche Pausen zwischen Aufgaben. Je weniger Änderungen Sie während einer Aufgabe vornehmen, desto höher ist Ihre Cache-Hit-Rate.43 Wählen Sie Ihr Modell und Ihre Aufwandsstufe am Anfang einer Sitzung aus, und speichern Sie dann `/compact` für natürliche Pausen zwischen Aufgaben. Je weniger Änderungen Sie während einer Aufgabe vornehmen, desto höher ist Ihre Cache-Hit-Rate.

75* [Modelle wechseln](#switching-models)75* [Modelle wechseln](#switching-models)

76* [Anstrengungsstufe ändern](#changing-effort-level)76* [Anstrengungsstufe ändern](#changing-effort-level)

77* [Schnellmodus aktivieren](#turning-on-fast-mode)77* [Schnellmodus aktivieren](#turning-on-fast-mode)

~~78* [MCP-Server verbinden oder trennen](#connecting-or-disconnecting-an-mcp-server)~~78* [MCP-Server verbinden oder trennen](#connecting-or-removing-an-mcp-server)

79* [Plugin aktivieren oder deaktivieren](#enabling-or-disabling-a-plugin)79* [Plugin aktivieren oder deaktivieren](#enabling-or-disabling-a-plugin)

80* [Ein ganzes Tool verweigern](#denying-an-entire-tool)80* [Ein ganzes Tool verweigern](#denying-an-entire-tool)

81* [Konversation komprimieren](#compacting-the-conversation)81* [Konversation komprimieren](#compacting-the-conversation)

96 96

97Die [`opusplan` Modelleinstellung](/docs/de/model-config#opusplan-model-setting) wird während des Plan-Modus zu Opus und während der Ausführung zu Sonnet aufgelöst, sodass jeder Plan-Modus-Toggle ein Modellwechsel ist und einen frischen Cache startet.97Die [`opusplan` Modelleinstellung](/docs/de/model-config#opusplan-model-setting) wird während des Plan-Modus zu Opus und während der Ausführung zu Sonnet aufgelöst, sodass jeder Plan-Modus-Toggle ein Modellwechsel ist und einen frischen Cache startet.

98 98

99[Automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auf Fable-Modellen, Opus 5.5 und Opus 5 ist auch ein Modellwechsel. Wenn ein Sicherheitsklassifizierer eine Anfrage in einer Kategorie mit einem Fallback-Modell kennzeichnet, führt Claude Code die Anfrage auf diesem Modell erneut aus und die Sitzung wird dort fortgesetzt.99[Automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auf Fable-Modellen, Opus 5.5, Sonnet 5.5 und Opus 5 ist auch ein Modellwechsel. Wenn ein Sicherheitsklassifizierer eine Anfrage in einer Kategorie mit einem Fallback-Modell kennzeichnet, führt Claude Code die Anfrage auf diesem Modell erneut aus und die Sitzung wird dort fortgesetzt.

100 100

101Wenn die Frontmatter eines Skills oder Befehls ein [`model`](/docs/de/skills#frontmatter-reference) benennt, das nicht das aktuelle Modell der Sitzung ist, ist dieser Turn auch ein Modellwechsel: die nächste Anfrage liest die gesamte Konversationshistorie ohne Cache-Treffer. Das Sitzungsmodell wird bei Ihrer nächsten Eingabeaufforderung fortgesetzt. Ein `context: fork` Skill setzt stattdessen das [Modell des abgespaltenen Subagenten](/docs/de/skills#run-skills-in-a-subagent).101Wenn die Frontmatter eines Skills oder Befehls ein [`model`](/docs/de/skills#frontmatter-reference) benennt, das nicht das aktuelle Modell der Sitzung ist, ist dieser Turn auch ein Modellwechsel: die nächste Anfrage liest die gesamte Konversationshistorie ohne Cache-Treffer. Das Sitzungsmodell wird bei Ihrer nächsten Eingabeaufforderung fortgesetzt. Ein `context: fork` Skill setzt stattdessen das [Modell des abgespaltenen Subagenten](/docs/de/skills#run-skills-in-a-subagent).

102 102

106 106

107Bei den meisten Modellen bedeutet das Ändern der [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) während einer Sitzung, dass die nächste Anfrage die gesamte Konversationshistorie ohne Cache-Treffer liest. Während der Cache noch warm ist, fordert Claude Code Sie auf, die Änderung zuerst zu bestätigen.107Bei den meisten Modellen bedeutet das Ändern der [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) während einer Sitzung, dass die nächste Anfrage die gesamte Konversationshistorie ohne Cache-Treffer liest. Während der Cache noch warm ist, fordert Claude Code Sie auf, die Änderung zuerst zu bestätigen.

108 108

109Bei Opus 5.5 und Fable 5.1 mit einem API-Schlüssel oder Claude-Abonnement behält das Ändern der Anstrengung den Cache, und Claude Code wendet die neue Stufe ohne Nachfrage an. Dies gilt nicht für Amazon Bedrock, Google Cloud's Agent Platform oder ein [Claude Apps Gateway](/docs/de/claude-apps-gateway), oder wenn Sie [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) setzen oder Ihre Organisation eine HIPAA-Konfiguration hat.109Bei Opus 5.5, Sonnet 5.5 und Fable 5.1 mit einem API-Schlüssel oder Claude-Abonnement behält das Ändern der Anstrengung den Cache, und Claude Code wendet die neue Stufe ohne Nachfrage an. Dies gilt nicht für Amazon Bedrock, Google Cloud's Agent Platform oder ein [Claude Apps Gateway](/docs/de/claude-apps-gateway), oder wenn Sie [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/de/llm-gateway-protocol#disable-pre-release-capabilities) setzen oder Ihre Organisation eine HIPAA-Konfiguration hat.

110 110

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

112 112

118 118

119Die Kosten fallen einmal pro Konversation an. Nach dem ersten Schnellmodus-Turn sendet Claude Code weiterhin den Header und variiert nur die Geschwindigkeitseinstellung der Anfrage, die nicht Teil des Cache-Schlüssels ist. Das Ausschalten des Schnellmodus, das [automatische Fallback auf Standardgeschwindigkeit](/docs/de/fast-mode#handle-rate-limits) nach einem Rate Limit und das spätere Wiedereinschalten behalten alle den Cache. Wenn Sie [während einer Sitzung die Nutzungsguthaben aufbrauchen](/docs/de/fast-mode#handle-rate-limits), versucht Claude Code jeden abgelehnten Schnellmodus-Request auf die gleiche Weise mit Standardgeschwindigkeit erneut, sodass dieses Fallback auch den Cache behält. `/clear` und `/compact` setzen dies zurück, da sie den Cache an diesen Punkten ohnehin neu aufbauen.119Die Kosten fallen einmal pro Konversation an. Nach dem ersten Schnellmodus-Turn sendet Claude Code weiterhin den Header und variiert nur die Geschwindigkeitseinstellung der Anfrage, die nicht Teil des Cache-Schlüssels ist. Das Ausschalten des Schnellmodus, das [automatische Fallback auf Standardgeschwindigkeit](/docs/de/fast-mode#handle-rate-limits) nach einem Rate Limit und das spätere Wiedereinschalten behalten alle den Cache. Wenn Sie [während einer Sitzung die Nutzungsguthaben aufbrauchen](/docs/de/fast-mode#handle-rate-limits), versucht Claude Code jeden abgelehnten Schnellmodus-Request auf die gleiche Weise mit Standardgeschwindigkeit erneut, sodass dieses Fallback auch den Cache behält. `/clear` und `/compact` setzen dies zurück, da sie den Cache an diesen Punkten ohnehin neu aufbauen.

120 120

121<h3 id="connecting-or-disconnecting-an-mcp-server">121<h3 id="connecting-or-removing-an-mcp-server">

122 MCP-Server verbinden oder trennen122 MCP-Server verbinden oder trennen

123</h3>123</h3>

124 124

125Tool-Definitionen befinden sich in der System-Prompt-Schicht, sodass der Cache ungültig wird, wenn sich die Menge der Tool-Definitionen in der Anfrage zwischen Turns ändert. Das Umschalten des [Advisor-Tools](/docs/de/advisor) ist eine Ausnahme: seine Definition befindet sich nach dem Cache-Breakpoint, sodass das Aktivieren oder Deaktivieren von `/advisor` das zwischengespeicherte Präfix intakt hält. Ob eine [MCP-Server](/docs/de/mcp)-Änderung dies tut, hängt davon ab, ob ihre Tools durch [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) aufgeschoben oder in das Präfix geladen werden:125Tool-Definitionen befinden sich in der System-Prompt-Schicht, sodass der Cache ungültig wird, wenn sich die Menge der Tool-Definitionen in der Anfrage zwischen Turns ändert. Das Umschalten des [Advisor-Tools](/docs/de/advisor) ist eine Ausnahme: seine Definition befindet sich nach dem Cache-Breakpoint, sodass das Aktivieren oder Deaktivieren von `/advisor` das zwischengespeicherte Präfix intakt hält. Ob eine [MCP-Server](/docs/de/mcp)-Änderung dies tut, hängt davon ab, ob [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) die MCP-Tools der Sitzung aufschiebt, die Standardeinstellung auf unterstützten Modellen:

126 126

127* **Aufgeschobene Tools**, die Standardeinstellung auf unterstützten Modellen: Ein Server, der sich verbindet, trennt oder seine Tool-Liste ändert, hängt nur neue Inhalte an und stört nichts, das bereits zwischengespeichert ist.127* **Tools aufgeschoben**: Claude Code behält die Tool-Liste aus der ersten Anfrage der Konversation für die gesamte Konversation, sodass ein Server, der sich während einer Sitzung verbindet oder trennt, nichts stört, das bereits zwischengespeichert ist. Ein Server, der sich nach der ersten Anfrage verbindet, stellt seine Tools als aufgeschobene Definitionen bereit, die Claude bei Bedarf lädt.

128* **Tools, die in das Präfix geladen werden**: Jede Änderung daran macht den Cache ungültig. Dies geschieht, wenn [Tool-Suche nicht verfügbar oder deaktiviert ist](/docs/de/mcp#configure-tool-search), z. B. auf Google Cloud's Agent Platform-Modellen vor der Claude 4.5-Generation, mit einem benutzerdefinierten `ANTHROPIC_BASE_URL` Gateway oder auf einer Microsoft Foundry [auf Azure gehosteten Bereitstellung](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options), sobald Claude Code erkennt, dass die Bereitstellung Tool-Suche ablehnt. Es geschieht auch für einen Server oder ein Tool, das als [`alwaysLoad`](/docs/de/mcp#exempt-a-server-from-deferral) gekennzeichnet ist, und für Definitionen, die durch [schwellenwertbasiertes Laden](/docs/de/mcp#configure-tool-search) vorne gehalten werden.128* **Tools geladen im Voraus**: Das Hinzufügen einer Definition macht den Cache ungültig, und das Entfernen einer Definition auch. Dies gilt, wenn Tool-Suche [unter ihrem `auto`-Schwellenwert liegt, deaktiviert oder nicht verfügbar ist](/docs/de/mcp#configure-tool-search), z. B. auf Google Cloud's Agent Platform-Modellen vor der Claude 4.5-Generation, mit einem benutzerdefinierten `ANTHROPIC_BASE_URL` Gateway oder auf einer Microsoft Foundry [auf Azure gehosteten Bereitstellung](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options), sobald Claude Code erkennt, dass die Bereitstellung Tool-Suche ablehnt.

129 129

130Wenn Tools in das Präfix geladen werden, ist die häufigste Ursache einer Ungültigmachung ein Server, der sich während einer Sitzung verbindet oder trennt, was ohne Ihre Aktion geschehen kann: Der Prozess eines Stdio-Servers wird beendet, eine HTTP-Sitzung läuft ab oder ein Server [verbindet sich automatisch nach einem vorübergehenden Fehler wieder](/docs/de/mcp#automatic-reconnection). Ein verbundener Server kann auch ein [dynamisches Tool-Update](/docs/de/mcp#dynamic-tool-updates) pushen, das seine Tool-Liste ändert.130Ohne Tool-Suche hängt es davon ab, was sich geändert hat, ob eine Mid-Session-Server-Änderung den Cache ungültig macht. Für jede Änderung gibt diese Tabelle an, ob der Cache beibehalten wird und was mit den Tool-Definitionen in der nächsten Anfrage geschieht.

131

132| Mid-Session-Änderung | Cache | Tool-Definitionen in der nächsten Anfrage |

133| - | - | - |

134| Ein Server verbindet sich, oder ein [dynamisches Tool-Update](/docs/de/mcp#dynamic-tool-updates) fügt Tools hinzu | Ungültig gemacht | Die neuen Definitionen werden hinzugefügt |

135| Ein Server fällt ohne Aktion Ihrerseits aus, z. B. wenn der Prozess eines Stdio-Servers beendet wird | Beibehalten | Die Definitionen des Servers bleiben unverändert. Ein Aufruf eines seiner Tools gibt einen Fehler zurück, anstatt ausgeführt zu werden |

136| Ein Remote-Server [verbindet sich automatisch wieder](/docs/de/mcp#automatic-reconnection), nachdem seine Verbindung unterbrochen wurde | Beibehalten, es sei denn, ein Request, der gesendet wird, während sich der Server wieder verbindet, fügt das `WaitForMcpServers`-Tool hinzu, das den Cache einmal ungültig macht | Die Definitionen des Servers bleiben unverändert. Ein Request, der gesendet wird, während sich der Server wieder verbindet, kann `WaitForMcpServers` hinzufügen, wenn die Konversation es noch nicht aufgelistet hat, und das Tool bleibt dann für den Rest der Konversation aufgelistet |

137| Sie entfernen ein Tool absichtlich, z. B. mit einer [Deny-Regel](#denying-an-entire-tool) oder durch Deaktivieren seines Servers in `/mcp` | Ungültig gemacht | Die Definition wird entfernt |

138

139Wenn Sie eine Konversation fortsetzen, deren Tools in das Präfix geladen werden, kann sich einer ihrer MCP-Server noch verbinden, während die erste Anfrage rausgeht. Wenn das Transkript die Tool-Definitionen dieses Servers aufgezeichnet hat, enthält diese Anfrage sie wie aufgezeichnet, sodass sie sich nicht ändern, wenn sich der Server mit den gleichen Tools verbindet.

131 140

132Das Bearbeiten Ihrer MCP-Konfiguration ändert den Cache nicht von selbst. Die neue Konfiguration wird erst nach einem Neustart wirksam, wenn sich der Server verbindet oder trennt.141Das Bearbeiten Ihrer MCP-Konfiguration ändert den Cache nicht von selbst. Die neue Konfiguration wird erst nach einem Neustart wirksam, wenn sich der Server verbindet oder trennt.

133 142

147 Plugins, die MCP-Server bereitstellen156 Plugins, die MCP-Server bereitstellen

148</h4>157</h4>

149 158

150Wenn Sie ein Plugin aktivieren oder deaktivieren, das [MCP-Server](/docs/de/plugins/components#mcp-servers) bereitstellt, folgt Claude Code den gleichen Regeln wie beim [Verbinden oder Trennen eines MCP-Servers](#connecting-or-disconnecting-an-mcp-server):159Wenn Sie ein Plugin aktivieren oder deaktivieren, das [MCP-Server](/docs/de/plugins/components#mcp-servers) bereitstellt, folgt Claude Code den gleichen Regeln wie beim [Verbinden oder Trennen eines MCP-Servers](#connecting-or-removing-an-mcp-server).

~~151~~

152* Wenn Claude Code die Tools des Servers aufschiebt, behält es den Cache.

153* Wenn Claude Code sie in das Präfix lädt, liest die nächste Anfrage die gesamte Konversation erneut.

154 160

155<h4 id="code-intelligence-plugins">161<h4 id="code-intelligence-plugins">

156 Code-Intelligence-Plugins162 Code-Intelligence-Plugins

244 Bearbeiten von Dateien in Ihrem Repository250 Bearbeiten von Dateien in Ihrem Repository

245</h3>251</h3>

246 252

247Dateiinhalte werden nur dann in den Kontext aufgenommen, wenn Claude sie liest, und Lesevorgänge hängen sich an das Gespräch an. Das Bearbeiten einer Datei, die Claude zuvor gelesen hat, ändert nicht rückwirkend den früheren Lesevorgang in der Historie. Stattdessen hängt Claude Code eine `<system-reminder>` an, die notiert, dass sich die Datei geändert hat, und Claude liest sie bei Bedarf erneut.253Dateiinhalte werden nur dann in den Kontext aufgenommen, wenn Claude sie liest, und Lesevorgänge hängen sich an das Gespräch an. Das Bearbeiten einer Datei, die Claude zuvor gelesen hat, ändert nicht rückwirkend den früheren Lesevorgang in der Historie. Stattdessen hängt Claude Code eine [`<system-reminder>`](/docs/de/glossary#system-reminder) an, die notiert, dass sich die Datei geändert hat, und Claude liest sie bei Bedarf erneut.

248 254

249<h3 id="editing-claude-md-mid-session">255<h3 id="editing-claude-md-mid-session">

250 Bearbeiten von CLAUDE.md während der Sitzung256 Bearbeiten von CLAUDE.md während der Sitzung

354 Cache-Umfang360 Cache-Umfang

355</h2>361</h2>

356 362

357In Claude Code ist der Cache effektiv auf einen Computer und ein Verzeichnis beschränkt. Jede Konversation trägt das Arbeitsverzeichnis, die Plattform, die Shell und die OS-Version mit sich, und der System-Prompt benennt Ihre Auto-Memory-Pfade, daher bauen zwei Sessions in verschiedenen Verzeichnissen unterschiedliche Präfixe auf und verfehlen den Cache des anderen. Das schließt Worktrees desselben Repositorys ein, da jeder Worktree sein eigenes Arbeitsverzeichnis hat.363In Claude Code ist der Cache effektiv auf einen Computer und ein Verzeichnis beschränkt. Der System-Prompt bettetet Ihre Auto-Memory-Pfade ein, und die Konversation öffnet sich mit einer Ankündigung des Arbeitsverzeichnisses, der Plattform, der Shell und der OS-Version. Zwei Sessions in verschiedenen Verzeichnissen bauen daher unterschiedliche Präfixe auf und verfehlen den Cache des anderen.

358 364

359Sessions, die Sie parallel im selben Verzeichnis ausführen, bauen passende Präfixe auf und lesen den Cache des anderen. Sequenzielle Sessions teilen das Präfix nur, wenn der Git-Status-Snapshot beim Start übereinstimmt, da jede Konversation auch den Branch und aktuelle Commits aus diesem Snapshot trägt.365Sessions, die Sie parallel im selben Verzeichnis ausführen, bauen passende Präfixe auf und lesen den Cache des anderen. Sequenzielle Sessions teilen das Präfix nur, wenn der Git-Status-Snapshot beim Start übereinstimmt, da jede Konversation auch den Branch und aktuelle Commits aus diesem Snapshot trägt.

360 366

361Der zugrunde liegende API-Cache ist breiter. Caches sind zwischen Organisationen isoliert, und bei einigen Providern [zwischen Workspaces innerhalb einer Organisation](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-storage-and-sharing). Innerhalb dieser Grenzen lesen zwei Anfragen mit demselben Modell und Präfix denselben Cache. Für Agent SDK-Aufrufer, die Flotten automatisierter Prozesse ausführen, siehe [Prompt Caching über Benutzer und Maschinen verbessern](/docs/de/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines), um die Pro-Maschinen-Abschnitte des System-Prompts zu unterdrücken und den Cache über Maschinen zu teilen.367Der zugrunde liegende API-Cache ist breiter. Caches sind zwischen Organisationen isoliert, und bei einigen Providern [zwischen Workspaces innerhalb einer Organisation](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-storage-and-sharing). Innerhalb dieser Grenzen lesen zwei Anfragen mit demselben Modell und Präfix denselben Cache. Für Agent SDK-Aufrufer, die Flotten automatisierter Prozesse ausführen, siehe [Prompt Caching über Benutzer und Maschinen verbessern](/docs/de/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines), um die Auto-Memory-Position aus dem System-Prompt zu verschieben und den Cache-Eintrag des System-Prompts über Benutzer und Maschinen hinweg zu teilen.

362 368

363<h2 id="check-cache-performance">369<h2 id="check-cache-performance">

364 Cache-Leistung überprüfen370 Cache-Leistung überprüfen

405| Variable | Effekt |411| Variable | Effekt |

406| - | - |412| - | - |

412 418

419`DISABLE_PROMPT_CACHING_HAIKU` gilt für das Standard-Haiku-Modell, das Modell, zu dem der `haiku`-Alias aufgelöst wird. Es deaktiviert Caching überall dort, wo dieses Modell ausgeführt wird, einschließlich der Hauptkonversation, wenn es Ihr Hauptmodell ist. Die Abdeckung der Hauptkonversation erfordert Claude Code v2.1.283 oder später.

420

421Die Variable deckt auch ein Hintergrundmodell ab, das Sie mit der veralteten `ANTHROPIC_SMALL_FAST_MODEL`-Variable festlegen, wenn sich dieses Modell von Ihrem Hauptmodell unterscheidet.

422

423Eine andere Haiku-Version, die Sie als Ihr Hauptmodell festlegen, behält Caching bei; setzen Sie `DISABLE_PROMPT_CACHING`, um Caching dafür zu deaktivieren.

424

413Um die Caching-Richtlinie über eine Organisation hinweg festzulegen, setzen Sie eine dieser oder die [TTL-Variablen](#cache-lifetime) in den `env`-Block von [verwalteten Einstellungen](/docs/de/managed-settings). Für normale Nutzung lassen Sie Caching aktiviert.425Um die Caching-Richtlinie über eine Organisation hinweg festzulegen, setzen Sie eine dieser oder die [TTL-Variablen](#cache-lifetime) in den `env`-Block von [verwalteten Einstellungen](/docs/de/managed-settings). Für normale Nutzung lassen Sie Caching aktiviert.

414 426

415<h2 id="related-resources">427<h2 id="related-resources">

quickstart.md +4 −2

Details

27 Schritt 1: Claude Code installieren27 Schritt 1: Claude Code installieren

28</h2>28</h2>

29 29

~~30Um Claude Code zu installieren, verwenden Sie eine der folgenden Methoden:~~30Um Claude Code zu installieren, öffnen Sie ein Terminal und führen Sie den Befehl für Ihr System aus. Wenn Sie noch nie ein Terminal verwendet haben, zeigt der [Terminal-Leitfaden](/docs/de/terminal-guide), wie Sie eines öffnen und den Befehl einfügen.

31 31

32<Tabs>32<Tabs>

33 <Tab title="Native Installation (Empfohlen)">33 <Tab title="Native Installation (Empfohlen)">

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51

52 Wenn das Installationsprogramm fertig ist, öffnen Sie ein neues Terminal-Fenster und führen Sie `claude --version` aus. Eine funktionierende Installation gibt eine Versionsnummer aus. Wenn Ihre Shell sagt, dass `claude` nicht gefunden wird oder nicht erkannt wird, ist das Installationsverzeichnis noch nicht in Ihrem PATH: siehe [Beheben Sie Ihren PATH](/docs/de/troubleshoot-install#command-not-found-claude-after-installation).

52 Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell. Ihre Eingabeaufforderung zeigt `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.54 Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell. Ihre Eingabeaufforderung zeigt `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.

53 55

54 Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen curl-Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.56 Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen curl-Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.

187 189

188Claude Code findet die entsprechende Datei und zeigt Ihnen die Änderung. Wenn es Sie vor der Änderung fragt, wählen Sie **Ja** aus, um zuzustimmen.190Claude Code findet die entsprechende Datei und zeigt Ihnen die Änderung. Wenn es Sie vor der Änderung fragt, wählen Sie **Ja** aus, um zuzustimmen.

189 191

190Der Auto-Modus ist der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) für interaktive Terminalsitzungen in Pro-, Max- und Team-Plänen: Ein Klassifizierer überprüft Aktionen anstelle von Ihnen, und Claude bearbeitet die meisten Dateien und führt die meisten Befehle aus, ohne zu fragen. Bei anderen Plänen ist der manuelle Modus der integrierte Standard-Berechtigungsmodus. Für die Sitzung, die Sie direkt nach der Installation starten, siehe [Erste Sitzung nach einer Installation oder einem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade).192Mit Claude Code v2.1.283 oder später ist der Auto-Modus der [integrierte Standard-Berechtigungsmodus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) für interaktive Terminalsitzungen: Ein Klassifizierer überprüft Aktionen anstelle von Ihnen, und Claude bearbeitet die meisten Dateien und führt die meisten Befehle aus, ohne zu fragen. Bei früheren Versionen ist der Auto-Modus der integrierte Standard-Berechtigungsmodus nur bei Pro-, Max- und Team-Plänen. Für die Sitzung, die Sie direkt nach der Installation starten, siehe [Erste Sitzung nach einer Installation oder einem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade).

191 193

192<Note>194<Note>

193 Ihre Einstellungen oder Ihre Organisation können einen anderen Standard-Berechtigungsmodus festlegen. [Welcher Berechtigungsmodus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) listet auf, was dies tut. Drücken Sie `Shift+Tab` jederzeit, um den Berechtigungsmodus der Sitzung, in der Sie sich befinden, zu wechseln.195 Ihre Einstellungen oder Ihre Organisation können einen anderen Standard-Berechtigungsmodus festlegen. [Welcher Berechtigungsmodus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) listet auf, was dies tut. Drücken Sie `Shift+Tab` jederzeit, um den Berechtigungsmodus der Sitzung, in der Sie sich befinden, zu wechseln.

remote-control.md +129 −136

Details

6 6

7> Setzen Sie eine lokale Claude Code-Sitzung von Ihrem Telefon, Tablet oder einem beliebigen Browser aus mit Remote Control fort. Funktioniert mit claude.ai/code und der Claude-Mobile-App.7> Setzen Sie eine lokale Claude Code-Sitzung von Ihrem Telefon, Tablet oder einem beliebigen Browser aus mit Remote Control fort. Funktioniert mit claude.ai/code und der Claude-Mobile-App.

8 8

~~9<Note>~~

10 Remote Control ist auf allen Plänen verfügbar. Bei Team und Enterprise ist es standardmäßig deaktiviert, bis ein Inhaber den Remote Control-Schalter in den [Claude Code-Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) aktiviert.

~~11</Note>~~

13Remote Control verbindet [claude.ai/code](https://claude.ai/code) oder die Claude-App für [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) und [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) mit einer Claude Code-Sitzung, die auf Ihrem Computer ausgeführt wird. Starten Sie eine Aufgabe an Ihrem Schreibtisch und setzen Sie sie dann von Ihrem Telefon auf der Couch oder einem Browser auf einem anderen Computer fort.9Remote Control verbindet [claude.ai/code](https://claude.ai/code) oder die Claude-App für [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) und [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) mit einer Claude Code-Sitzung, die auf Ihrem Computer ausgeführt wird. Starten Sie eine Aufgabe an Ihrem Schreibtisch und setzen Sie sie dann von Ihrem Telefon auf der Couch oder einem Browser auf einem anderen Computer fort.

14 10

15Wenn Sie eine Remote Control-Sitzung auf Ihrem Computer starten, wird Claude die ganze Zeit lokal ausgeführt, sodass Ihre Code-Ausführung und Ihr Dateisystem-Zugriff auf Ihrem Computer bleiben. Mit Remote Control können Sie:11Wenn Sie eine Remote Control-Sitzung auf Ihrem Computer starten, wird Claude die ganze Zeit lokal ausgeführt, sodass Ihre Code-Ausführung und Ihr Dateisystem-Zugriff auf Ihrem Computer bleiben. Mit Remote Control können Sie:

17* **Ihre vollständige lokale Umgebung remote nutzen**: Ihr Dateisystem, [MCP servers](/docs/de/mcp), Tools und Projektkonfiguration bleiben verfügbar, und durch Eingabe von `@` werden Dateipfade aus Ihrem lokalen Projekt automatisch vervollständigt.13* **Ihre vollständige lokale Umgebung remote nutzen**: Ihr Dateisystem, [MCP servers](/docs/de/mcp), Tools und Projektkonfiguration bleiben verfügbar, und durch Eingabe von `@` werden Dateipfade aus Ihrem lokalen Projekt automatisch vervollständigt.

18* **Von beiden Oberflächen gleichzeitig arbeiten**: Das Gespräch und der Fortschritt von [Subagenten](/docs/de/sub-agents) und [dynamischen Workflows](/docs/de/workflows) bleiben auf allen verbundenen Geräten synchronisiert, sodass Sie Nachrichten von Ihrem Terminal, Browser und Telefon austauschbar senden können.14* **Von beiden Oberflächen gleichzeitig arbeiten**: Das Gespräch und der Fortschritt von [Subagenten](/docs/de/sub-agents) und [dynamischen Workflows](/docs/de/workflows) bleiben auf allen verbundenen Geräten synchronisiert, sodass Sie Nachrichten von Ihrem Terminal, Browser und Telefon austauschbar senden können.

19* **Bilder und Dateien von Ihrem Telefon oder Browser senden**: Fügen Sie ein Foto oder eine Datei in der Claude-App oder auf claude.ai/code an, mit oder ohne Beschriftung. Claude sieht angehängte Fotos direkt als Teil Ihrer Nachricht. Claude Code lädt andere Dateien auf Ihren Computer herunter und übergibt sie Claude als `@`-Dateireferenzen.15* **Bilder und Dateien von Ihrem Telefon oder Browser senden**: Fügen Sie ein Foto oder eine Datei in der Claude-App oder auf claude.ai/code an, mit oder ohne Beschriftung. Claude sieht angehängte Fotos direkt als Teil Ihrer Nachricht. Claude Code lädt andere Dateien auf Ihren Computer herunter und übergibt sie Claude als `@`-Dateireferenzen.

20* **Unterbrechungen überstehen**: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird Claude Code automatisch wiederhergestellt, wenn Ihr Computer wieder online ist. Während die Verbindung wiederhergestellt wird, stellt Claude Code Nachrichten, Berechtigungsaufforderungen und Status-Updates von Subagenten und Workflows in die Warteschlange und liefert sie, sobald die Verbindung wiederhergestellt ist.16* **Unterbrechungen überstehen**: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird Claude Code automatisch wiederhergestellt, wenn Ihr Computer wieder online ist.

22Im Gegensatz zu [Claude Code im Web](/docs/de/claude-code-on-the-web), das auf Cloud-Infrastruktur ausgeführt wird, werden Remote Control-Sitzungen direkt auf Ihrem Computer ausgeführt und interagieren mit Ihrem lokalen Dateisystem. Die Web- und Mobile-Schnittstellen sind ein Fenster in diese lokale Sitzung.

23 17

~~24Diese Seite behandelt die Einrichtung, das Starten und Verbinden mit Sitzungen sowie den Vergleich von Remote Control mit Claude Code im Web.~~18Im Gegensatz zu [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), die auf Cloud-Infrastruktur ausgeführt werden, werden Remote Control-Sitzungen direkt auf Ihrem Computer ausgeführt und interagieren mit Ihrem lokalen Dateisystem. Die Web- und Mobile-Schnittstellen sind ein Fenster in diese lokale Sitzung, sodass Ihr Computer eingeschaltet bleiben muss und der `claude`-Prozess weiterhin ausgeführt werden muss.

25 19

26<h2 id="requirements">20<h2 id="requirements">

27 Anforderungen21 Anforderungen

29 23

30Bevor Sie Remote Control verwenden, bestätigen Sie, dass Ihre Umgebung diese Bedingungen erfüllt:24Bevor Sie Remote Control verwenden, bestätigen Sie, dass Ihre Umgebung diese Bedingungen erfüllt:

31 25

32* **Abonnement**: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Owner zunächst den Remote Control-Schalter in den [Claude Code-Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) aktivieren.26* **Abonnement**: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Eigentümer zunächst den Remote Control-Schalter in den [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code) aktivieren.

33* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben. Ohne eine berechtigte Anmeldung wird `claude remote-control` mit einem Fehler beendet, während `claude --remote-control` weiterhin eine interaktive Sitzung startet und kurz nach dem Start eine Remote Control-Fehlerbenachrichtigung anzeigt.27* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben. Ohne eine berechtigte Anmeldung wird `claude remote-control` mit einem Fehler beendet, während `claude --remote-control` weiterhin eine interaktive Sitzung startet und kurz nach dem Start eine Remote Control-Fehlerbenachrichtigung anzeigt.

34* **API-Endpunkt**: nicht verfügbar in einer dieser Konfigurationen:28* **API-Endpunkt**: nicht verfügbar in einer dieser Konfigurationen:

35 * Sie verwenden Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry.29 * Sie verwenden Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry.

36 * Sie verweisen [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen anderen Host als `api.anthropic.com`, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder einen Proxy. Heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden. Vor v2.1.196 erlaubte Claude Code Remote Control mit einer benutzerdefinierten `ANTHROPIC_BASE_URL`.30 * Sie verweisen [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen anderen Host als `api.anthropic.com`, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder einen Proxy. Heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden.

37 * Sie melden sich über ein Enterprise-[Claude-Apps-Gateway](/docs/de/claude-apps-gateway) an.31 * Sie melden sich über ein Enterprise-[Claude-Apps-Gateway](/docs/de/claude-apps-gateway) an.

38* **Feature-Flag-Evaluierung**: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` und `DISABLE_GROWTHBOOK`](/docs/de/env-vars) deaktivieren jeweils die Feature-Flag-Evaluierung, von der die Remote Control-Verfügbarkeit abhängt. Heben Sie die Variablenzuweisung überall auf, wo sie gesetzt ist, in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings), um Remote Control zu verwenden.32* **Feature-Flag-Evaluierung**: Wenn Sie eine [Umgebungsvariable festlegen, die die Feature-Flag-Evaluierung deaktiviert](/docs/de/env-vars#features-that-need-feature-flag-fetching), hängt die Verfügbarkeit von Remote Control davon ab, welche Sie festlegen:

39* **Workspace-Vertrauen**: Führen Sie `claude` mindestens einmal in Ihrem Projektverzeichnis aus, um den Workspace-Vertrauensdialog zu akzeptieren. Der Startup-Vertrauensdialog speichert niemals Vertrauen für Ihr Home-Verzeichnis, daher starten Sie Remote Control aus einem Projektverzeichnis.33 * Wenn Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` festlegen, ist Remote Control nicht verfügbar. Heben Sie die Variablenzuweisung überall auf – in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings) – um Remote Control zu verwenden.

34 * Wenn Sie nur `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` festlegen, bleibt Remote Control verfügbar, es sei denn, Ihre Organisation erfordert [Vertrauenswürdige Geräte](#trusted-devices). Falls ja, heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden. Die Verwendung von Remote Control mit einer dieser Variablen erfordert Claude Code v2.1.283 oder später.

35* **Workspace-Vertrauen**: In einem Verzeichnis, das Sie noch nicht vertraut haben, gibt `claude remote-control` aus, was das Vertrauen aktiviert, und fragt `Trust <directory>? [y/N]` ab, bevor es startet. Die Antwort `y` speichert die Wahl, außer in Ihrem Home-Verzeichnis, wo Vertrauen niemals gespeichert wird und die Frage bei jedem Durchlauf erneut gestellt wird. Wenn die Standardeingabe oder -ausgabe kein Terminal ist, kann der Befehl nicht fragen und wird mit einem [`Workspace not trusted`](/docs/de/errors#workspace-not-trusted-when-starting-remote-control)-Fehler beendet.

40 36

41<h2 id="start-a-remote-control-session">37<h2 id="start-a-remote-control-session">

42 Starten Sie eine Remote Control-Sitzung38 Starten Sie eine Remote Control-Sitzung

43</h2>39</h2>

44 40

~~45Sie können eine Remote Control-Sitzung über die CLI oder die VS Code-Erweiterung starten. Die CLI bietet drei Aufrufmodi; VS Code verwendet den Befehl `/remote-control`.~~41Sie können eine Remote Control-Sitzung über die CLI, die [Claude Desktop-App](/docs/de/desktop) oder die VS Code-Erweiterung starten. Die CLI bietet drei Aufrufmodi; die Desktop-App und VS Code verwenden den Befehl `/remote-control`.

46 42

47<Tabs>43<Tabs>

48 <Tab title="Server-Modus">44 <Tab title="Server-Modus">

62 | - | - |58 | - | - |

63 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |59 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |

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

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; frühere Versionen lehnen das Flag als unbekanntes Argument ab. |61 | `-c`, `--continue` | Bringen Sie die Sitzung zurück, die der letzte Server in diesem Verzeichnis gestartet hat, anstatt eine neue zu erstellen. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |

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; frühere Versionen lehnen das Flag als unbekanntes Argument ab. |62 | `--session-id <id>` | Bringen Sie eine Sitzung anhand ihrer ID zurück. Siehe [Sitzungen nach dem Stoppen des Servers fortsetzen](#resume-sessions-after-stopping-the-server). Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später. |

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. |63 | `--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. |

68 | `--capacity <N>` | Maximale Anzahl gleichzeitiger Sitzungen. Standard ist 32. Kann nicht mit `--spawn=session` verwendet werden. |64 | `--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. |65 | `--[no-]create-session-in-dir` | Erstellen Sie vorab eine Sitzung im aktuellen Verzeichnis, wenn der Server startet, damit Sie sofort einen Ort zum Eingeben haben. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert. Wenn Sie `--no-create-session-in-dir` übergeben, um ohne zu starten, archiviert Claude Code die Sitzungen des Servers, wenn Sie ihn stoppen, sodass es nichts zum [Fortsetzen](#resume-sessions-after-stopping-the-server) gibt. |

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

67 | `--chrome` / `--no-chrome` | Schalten Sie die [Chrome-Integration](/docs/de/chrome) in den Sitzungen, die der Server erstellt, ein oder aus, damit Claude Chrome auf Ihrem Computer nutzen kann, während Sie von einem anderen Gerät aus arbeiten. Ohne eines der beiden Flags beginnen die Sitzung, die der Server vorab erstellt, und jede Sitzung, die Sie selbst von claude.ai/code oder der Claude-App aus starten, mit Chrome aus, auch wenn Sie [Chrome standardmäßig aktiviert haben](/docs/de/chrome#enable-chrome-by-default). Eine Sitzung, die der Server für einen Ihrer [Projekt](/docs/de/claude-projects)-Threads startet, folgt dieser Einstellung stattdessen, außer im `bypassPermissions`-Modus. Erfordert Claude Code v2.1.273 oder später. |

68 | `-d`, `--debug[=<filter>]` | Aktivieren Sie Debug-Protokollierung für den Server, optional gefiltert nach Kategorie. Übergeben Sie einen Filter nur in der `=`-Form, z. B. `--debug=api,hooks`. Erfordert Claude Code v2.1.282 oder später. |

71 | `--debug-file <path>` | Schreiben Sie Debug-Protokolle in die angegebene Datei. |69 | `--debug-file <path>` | Schreiben Sie Debug-Protokolle in die angegebene Datei. |

72 | `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |70 | `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |

73 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [Sandboxing](/docs/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |71 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [Sandboxing](/docs/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |

74 72

75 Geben Sie diese Flags nach `remote-control` an.73 Geben Sie diese Flags nach `remote-control` an.

76 74

77 Wenn Sie ein globales `claude`-Flag vor `remote-control` übergeben, oder ein Wrapper-Skript fügt eines hinzu, trägt Claude Code das Flag nicht auf die Sitzungen über, die der Server erstellt. Claude Code lässt das Flag nur durch, wenn bekannt ist, dass das Löschen nicht ändert, was diese Sitzungen tun können, z. B. `--verbose` oder `--model`. Für jedes andere Flag, z. B. `--settings`, [weigert sich Claude Code zu starten](/docs/de/errors#not-carried-over-to-the-sessions-remote-control-starts) und nennt das zu entfernende Flag. Vor v2.1.248 führte jede Option vor `remote-control` dazu, dass Claude Code die Flags danach mit einem `unknown option`-Fehler ablehnte.75 Wenn Sie ein globales `claude`-Flag vor `remote-control` übergeben, oder ein Wrapper-Skript fügt eines hinzu, trägt Claude Code das Flag nicht auf die Sitzungen über, die der Server erstellt. Claude Code lässt das Flag nur durch, wenn bekannt ist, dass das Löschen nicht ändert, was diese Sitzungen tun können, z. B. `--verbose` oder `--model`. Für jedes andere Flag, z. B. `--settings`, [weigert sich Claude Code zu starten](/docs/de/errors#not-carried-over-to-the-sessions-remote-control-starts) und nennt das zu entfernende Flag.

78 76

79 Claude Code überprüft die Remote Control-Berechtigung vor dem Drucken der Hilfe, daher gibt `claude remote-control --help` einen Fehler zurück, anstatt diese Flag-Liste anzuzeigen, wenn Sie nicht mit einem berechtigten Konto angemeldet sind.77 Claude Code überprüft die Remote Control-Berechtigung vor dem Drucken der Hilfe, daher gibt `claude remote-control --help` einen Fehler zurück, anstatt diese Flag-Liste anzuzeigen, wenn Sie nicht mit einem berechtigten Konto angemeldet sind.

80 </Tab>78 </Tab>

126 124

127 Im Gegensatz zur CLI akzeptiert der VS Code-Befehl kein Namensargument und zeigt keinen QR-Code an. Der Sitzungstitel wird aus Ihrem Gesprächsverlauf oder der ersten Eingabeaufforderung abgeleitet.125 Im Gegensatz zur CLI akzeptiert der VS Code-Befehl kein Namensargument und zeigt keinen QR-Code an. Der Sitzungstitel wird aus Ihrem Gesprächsverlauf oder der ersten Eingabeaufforderung abgeleitet.

128 </Tab>126 </Tab>

127

128 <Tab title="Desktop-App">

129 In einer lokalen Sitzung im [Code-Tab der Claude Desktop-App](/docs/de/desktop) geben Sie `/remote-control` oder `/rc` in das Eingabefeld ein.

130

131 ```text theme={null}

132 /remote-control

133 ```

134

135 Sobald sich die Sitzung verbindet, finden Sie sie in der Sitzungsliste unter [claude.ai/code](https://claude.ai/code). Um die Verbindung zu trennen, führen Sie `/remote-control` erneut aus.

136

137 Um Remote Control stattdessen standardmäßig für jede Sitzung zu aktivieren, siehe [Aktivieren Sie Remote Control für alle Sitzungen](#enable-remote-control-for-all-sessions).

138 </Tab>

129</Tabs>139</Tabs>

130 140

131<h3 id="check-connection-status">141<h3 id="check-connection-status">

140* **This session was ended or archived from another device or app**: Führen Sie `/remote-control` nur aus, wenn Sie sie zurück möchten. Claude Code öffnet eine archivierte Sitzung erneut.150* **This session was ended or archived from another device or app**: Führen Sie `/remote-control` nur aus, wenn Sie sie zurück möchten. Claude Code öffnet eine archivierte Sitzung erneut.

141* **The server no longer reports this session**: Sie wurde möglicherweise von einem anderen Gerät oder einer App gelöscht.151* **The server no longer reports this session**: Sie wurde möglicherweise von einem anderen Gerät oder einer App gelöscht.

142 152

143<h3 id="session-url-reminders">

144 Sitzungs-URL-Erinnerungen

145</h3>

~~146~~

147Während Remote Control verbunden ist, erinnert Claude Code Sie an die Sitzungs-URL, wenn der Wechsel zu Ihrem Telefon oder Browser am hilfreichsten ist, damit Sie den Link nicht in `/remote-control` suchen müssen. Eine Erinnerung wird über dem Eingabefeld in einem dieser Momente angezeigt:

~~148~~

149* **Lange Runde**: Wenn eine Runde länger als ein vom Server abgestimmter Schwellenwert läuft, zeigt Claude Code eine **Still working**-Benachrichtigung mit einem **Check in from your phone**-Link an, damit Sie die Runde von Ihrem Telefon oder Browser aus verfolgen können, anstatt am Terminal zu warten. Claude Code entfernt sie, wenn die Runde endet.

150* **Wiederholte Berechtigungsaufforderungen**: Nachdem Sie mehrere [Berechtigungsaufforderungen](/docs/de/permissions) in einer Sitzung beantwortet haben, wird eine **Approve tool calls from your phone**-Benachrichtigung mit der Sitzungs-URL angezeigt. Claude Code entfernt sie, wenn Ihre nächste Runde beginnt.

~~151~~

152Die Erinnerungen können in jeder verbundenen Sitzung angezeigt werden, einschließlich solcher, bei denen Remote Control [automatisch verbunden wird](#enable-remote-control-for-all-sessions). Sie werden nicht jedes Mal angezeigt, wenn diese Bedingungen auftreten, und jede wird insgesamt nur wenige Male über Sitzungen hinweg angezeigt. Sie können sie nicht konfigurieren oder ausschalten; jede wird von selbst gelöscht.

~~153~~

154<h3 id="connect-from-another-device">153<h3 id="connect-from-another-device">

155 Verbinden Sie sich von einem anderen Gerät154 Verbinden Sie sich von einem anderen Gerät

156</h3>155</h3>

1703. Die letzte aussagekräftige Nachricht im vorhandenen Gesprächsverlauf1693. Die letzte aussagekräftige Nachricht im vorhandenen Gesprächsverlauf

1714. Ein automatisch generierter Name wie `myhost-graceful-unicorn`, wobei `myhost` der Hostname Ihres Computers oder das Präfix ist, das Sie mit `--remote-control-session-name-prefix` festgelegt haben1704. Ein automatisch generierter Name wie `myhost-graceful-unicorn`, wobei `myhost` der Hostname Ihres Computers oder das Präfix ist, das Sie mit `--remote-control-session-name-prefix` festgelegt haben

172 171

173Wenn Sie keinen expliziten Namen festgelegt haben, aktualisiert Claude Code den Titel, um Ihre Eingabeaufforderung widerzuspiegeln, sobald Sie eine senden. Claude Code stimmt automatisch generierte Titel mit der Sprache Ihres Gesprächs oder der [`language`](/docs/de/settings-reference#language)-Einstellung ab, falls eine konfiguriert ist.172Wenn Sie keinen expliziten Namen festgelegt haben, aktualisiert Claude Code den Titel, um Ihre Eingabeaufforderung widerzuspiegeln, sobald Sie eine senden. Wenn Sie eine Sitzung von claude.ai oder der Claude-App aus umbenennen, aktualisiert Claude Code auch den lokalen Titel, der in `claude --resume` angezeigt wird.

~~174~~

175Wenn Sie eine Sitzung von claude.ai oder der Claude-App aus umbenennen, aktualisiert Claude Code auch den lokalen Titel, der in `claude --resume` angezeigt wird. Claude Code wendet dieselbe Umbenennung auf den Sitzungsnamen an, der in der Eingabeaufforderungsleiste angezeigt wird, und in der `claude agents`-Auflistung, wenn die Sitzung [im Hintergrund läuft](/docs/de/agent-view). Vor v2.1.221 aktualisierte die Umbenennung von der Sitzungsliste unter claude.ai oder in der Claude-App nur den Titel, und die CLI behielt ihren vorherigen Sitzungsnamen; `/rename`, das in der CLI selbst läuft, setzt den Namen auf jeder Version.

176 173

177Wenn Sie die Claude-App noch nicht haben, verwenden Sie den Befehl `/mobile` in Claude Code, um einen QR-Code für [claude.ai/mobile](https://claude.ai/mobile) anzuzeigen, das die richtige App-Store-Seite für Ihr Telefon öffnet.174Wenn Sie die Claude-App noch nicht haben, verwenden Sie den Befehl `/mobile` in Claude Code, um einen QR-Code für [claude.ai/mobile](https://claude.ai/mobile) anzuzeigen, das die richtige App-Store-Seite für Ihr Telefon öffnet.

178 175

185* **Komprimierung und `/clear`**: Während Claude Code [das Gespräch komprimiert](/docs/de/context-window#what-survives-compaction), zeigen verbundene Geräte den Fortschritt und dann an, wo das Gespräch komprimiert wurde. Wenn Sie `/clear` ausführen, wird das Gespräch auch auf verbundenen Geräten zurückgesetzt.182* **Komprimierung und `/clear`**: Während Claude Code [das Gespräch komprimiert](/docs/de/context-window#what-survives-compaction), zeigen verbundene Geräte den Fortschritt und dann an, wo das Gespräch komprimiert wurde. Wenn Sie `/clear` ausführen, wird das Gespräch auch auf verbundenen Geräten zurückgesetzt.

186* **Wechsel von Gesprächen mit `/resume`**: Das verbundene Gerät empfängt nicht den Titel oder die frühere Verlauf des gewechselten Gesprächs, aber neue Nachrichten in beide Richtungen gehen zu und von dem Gespräch, das in Ihrem Terminal offen ist. Um von dem Gerät aus wieder an dem ursprünglichen Gespräch zu arbeiten, führen Sie `/resume` in Ihrem Terminal aus und wechseln Sie zurück.183* **Wechsel von Gesprächen mit `/resume`**: Das verbundene Gerät empfängt nicht den Titel oder die frühere Verlauf des gewechselten Gesprächs, aber neue Nachrichten in beide Richtungen gehen zu und von dem Gespräch, das in Ihrem Terminal offen ist. Um von dem Gerät aus wieder an dem ursprünglichen Gespräch zu arbeiten, führen Sie `/resume` in Ihrem Terminal aus und wechseln Sie zurück.

187* **Ziehen Sie eine Sitzung mit `/teleport`**: Wenn Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) mit `/teleport` in Ihr Terminal ziehen, empfängt das verbundene Gerät nicht den früheren Verlauf des gezogenen Gesprächs. Neue Nachrichten in beide Richtungen gehen zu und von dem gezogenen Gespräch, das jetzt das in Ihrem Terminal offene ist.184* **Ziehen Sie eine Sitzung mit `/teleport`**: Wenn Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) mit `/teleport` in Ihr Terminal ziehen, empfängt das verbundene Gerät nicht den früheren Verlauf des gezogenen Gesprächs. Neue Nachrichten in beide Richtungen gehen zu und von dem gezogenen Gespräch, das jetzt das in Ihrem Terminal offene ist.

188* **Nachrichten von Ihren anderen Sitzungen**: Mit [sitzungsübergreifendem Messaging](/docs/de/cross-session-messaging) trägt dieselbe Verbindung Nachrichten zwischen Ihren eigenen Sitzungen auf verschiedenen Maschinen und von Ihren [Cloud-Sitzungen](/docs/de/claude-code-on-the-web), über Anthropic-Server wie der Rest des Remote Control-Verkehrs. [Nachrichtensitzungen auf anderen Maschinen](/docs/de/cross-session-messaging#message-sessions-on-other-machines) behandelt die Lieferregeln und [Kontrollieren Sie eingehende Nachrichten](/docs/de/cross-session-messaging#control-inbound-messages) behandelt die eingehenden Kontrollen. Erfordert Claude Code v2.1.224 oder später.185* **Nachrichten von Ihren anderen Sitzungen**: Mit [sitzungsübergreifendem Messaging](/docs/de/cross-session-messaging) trägt dieselbe Verbindung Nachrichten zwischen Ihren eigenen Sitzungen auf verschiedenen Maschinen und von Ihren [Cloud-Sitzungen](/docs/de/claude-code-on-the-web).

189* **Eingabeaufforderungen, die Sie während einer Runde senden**: Wenn Sie eine Eingabeaufforderung von einem verbundenen Gerät senden, bevor die aktuelle Runde endet, stellt Claude Code sie in die Warteschlange und behält sie im Transkript des Geräts, nachdem diese Runde endet.186* **Diff Ihrer Änderungen**: Wenn sich das Verzeichnis der Sitzung in einem Git-Repository befindet, zeigt der Diff-Bereich eines verbundenen Geräts Ihre Änderungen. Auf einem Branch, der Commits vor dem Standard-Branch des Repositories hat, zeigt der Bereich die Änderungen seit dem Abzweigen des Branches an, einschließlich Ihrer nicht committeten Änderungen. Auf dem Standard-Branch selbst oder auf einem Branch, der nicht vor ihm liegt, zeigt der Bereich nur Ihre nicht committeten Änderungen.

190* **Diff Ihrer Änderungen**: Wenn sich das Verzeichnis der Sitzung in einem Git-Repository befindet, zeigt der Diff-Bereich eines verbundenen Geräts Ihre Änderungen. Das Gerät fordert den Diff über die Verbindung an, und Claude Code berechnet ihn auf Ihrem Computer. Auf einem Branch, der Commits vor dem Standard-Branch des Repositories hat, zeigt der Bereich die Änderungen seit dem Abzweigen des Branches an, einschließlich Ihrer nicht committeten Änderungen. Auf dem Standard-Branch selbst oder auf einem Branch, der nicht vor ihm liegt, zeigt der Bereich nur Ihre nicht committeten Änderungen. Vor v2.1.247 meldete Claude Code den Diff an verbundene Geräte nur in Sitzungen, die von `claude remote-control` bedient wurden.187* **Modell**: Wenn Sie ein [Modell](/docs/de/model-config) von einem verbundenen Gerät aus auswählen, führt Claude Code die Sitzung auf diesem Modell aus. Erfordert Claude Code v2.1.238 oder später. Ein Modell, das Sie vom Modellsteuerelement des Geräts auswählen, gilt nur für die aktuelle Sitzung. Wenn Sie `/model <name>` vom Gerät an eine interaktive Sitzung senden, setzt Claude Code auch Ihren Standard für neue Sitzungen.

191* **Modell**: Wenn Sie ein [Modell](/docs/de/model-config) von einem verbundenen Gerät aus auswählen, führt Claude Code die Sitzung auf diesem Modell aus. Die Auswahl `/model` des Terminals, `/status` und `/config` zeigen dieses Modell. Erfordert Claude Code v2.1.238 oder später auf Ihrem Computer.188* **Anstrengungsstufe**: Wenn Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) von einem verbundenen Gerät aus mit `/effort` oder dem Anstrengungssteuerelement des Geräts einstellen, wendet Claude Code sie auf die Sitzung auf Ihrem Computer an. Wenn Sie eine Stufe mit `CLAUDE_CODE_EFFORT_LEVEL` angeheftet haben, behält die Sitzung diese Stufe, und Claude Code weigert sich, eine andere Auswahl vom Anstrengungssteuerelement zu treffen. Eine Stufe vom Anstrengungssteuerelement auszuwählen erfordert Claude Code v2.1.234 oder später auf Ihrem Computer.

192 * Ein Modell, das Sie vom Modellsteuerelement des Geräts auswählen, gilt nur für die aktuelle Sitzung. Wenn Sie `/model <name>` vom Gerät an eine interaktive Sitzung senden, setzt Claude Code auch Ihren Standard für neue Sitzungen.

193 * Wenn Sie einen Namen senden, den Claude Code nicht erkennt, z. B. einen Anzeigenamen, wenn eine Modell-ID erwartet wird, [weigert sich Claude Code, die Auswahl zu akzeptieren](/docs/de/errors#model-is-not-a-recognized-model-id) und die Sitzung behält ihr aktuelles Modell. Vor v2.1.260 speicherte Claude Code eine nicht erkannte Auswahl vom Modellsteuerelement des Geräts, und Ihre nächste Nachricht schlug fehl.

194* **Anstrengungsstufe**: Wenn Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) von einem verbundenen Gerät aus mit `/effort` oder dem Anstrengungssteuerelement des Geräts einstellen, wendet Claude Code sie auf die Sitzung auf Ihrem Computer an, und claude.ai/code zeigt die Stufe an, die die Sitzung verwendet. Wenn Sie eine Stufe mit `CLAUDE_CODE_EFFORT_LEVEL` angeheftet haben, behält die Sitzung diese Stufe, und Claude Code weigert sich, eine andere Auswahl vom Anstrengungssteuerelement zu treffen. Eine Stufe vom Anstrengungssteuerelement auszuwählen erfordert Claude Code v2.1.234 oder später auf Ihrem Computer.

195* **Erneute Verbindung nach einem Verbindungsfehler**: Führen Sie `/remote-control` aus, um erneut zu verbinden. Wenn die Komprimierung das Gespräch umgeschrieben hat oder Sie Gespräche mit `/resume` in der Zwischenzeit gewechselt haben, archiviert Claude Code die Server-Sitzung, die es verwendete, anstatt sie in der Sitzungsliste zu belassen. Sie können sie immer noch finden, indem Sie [nach archivierten Sitzungen filtern](/docs/de/claude-code-on-the-web#archive-sessions). Das Wechseln von Gesprächen, während ein Gerät noch verbunden ist, archiviert die Sitzung nicht.189* **Erneute Verbindung nach einem Verbindungsfehler**: Führen Sie `/remote-control` aus, um erneut zu verbinden. Wenn die Komprimierung das Gespräch umgeschrieben hat oder Sie Gespräche mit `/resume` in der Zwischenzeit gewechselt haben, archiviert Claude Code die Server-Sitzung, die es verwendete, anstatt sie in der Sitzungsliste zu belassen. Sie können sie immer noch finden, indem Sie [nach archivierten Sitzungen filtern](/docs/de/claude-code-on-the-web#archive-sessions). Das Wechseln von Gesprächen, während ein Gerät noch verbunden ist, archiviert die Sitzung nicht.

196 190

197<h3 id="enable-remote-control-for-all-sessions">191<h3 id="enable-remote-control-for-all-sessions">

207Derselbe Schalter wird außerhalb der CLI angezeigt:201Derselbe Schalter wird außerhalb der CLI angezeigt:

208 202

209* **Desktop-App**: **Einstellungen > Claude Code > Enable remote control by default**.203* **Desktop-App**: **Einstellungen > Claude Code > Enable remote control by default**.

210* **VS Code-Erweiterung**: **Enable Remote Control for all sessions** im Abschnitt „Einstellungen" des [Befehlsmenüs](/docs/de/vs-code#use-the-prompt-box). Erfordert Claude Code v2.1.203 oder später.204* **VS Code-Erweiterung**: **Enable Remote Control for all sessions** im Abschnitt „Einstellungen" des [Befehlsmenüs](/docs/de/vs-code#use-the-prompt-box).

211 205

212Um die automatische Verbindung stattdessen aus einer Einstellungsdatei zu aktivieren, setzen Sie [`remoteControlAtStartup`](/docs/de/settings-reference#remotecontrolatstartup) auf `true` in Ihrer Benutzer-`~/.claude/settings.json` oder in [verwalteten Einstellungen](/docs/de/managed-settings). In Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ehrt Claude Code ein `false` und schaltet die automatische Verbindung für dieses Repository aus, ignoriert aber ein `true`, sodass eine eingecheckte Datei Remote Control nicht für alle aktivieren kann, die das Repository öffnen.206Um die automatische Verbindung stattdessen aus einer Einstellungsdatei zu aktivieren, setzen Sie [`remoteControlAtStartup`](/docs/de/settings-reference#remotecontrolatstartup) auf `true` in Ihrer Benutzer-`~/.claude/settings.json` oder in [verwalteten Einstellungen](/docs/de/managed-settings). In Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ehrt Claude Code ein `false` und schaltet die automatische Verbindung für dieses Repository aus, ignoriert aber ein `true`, sodass eine eingecheckte Datei Remote Control nicht für alle aktivieren kann, die das Repository öffnen.

213 207

227 221

228Diese Befehle funktionieren etwa vier Stunden, nachdem der Server gestoppt wurde. Danach führen Sie `claude remote-control` aus, um eine neue Sitzung zu starten. Wenn Sie eine Sitzung in der Zwischenzeit archiviert haben, entarchivieren `--continue` und `--session-id` sie auf Claude Code v2.1.228 oder später.222Diese Befehle funktionieren etwa vier Stunden, nachdem der Server gestoppt wurde. Danach führen Sie `claude remote-control` aus, um eine neue Sitzung zu starten. Wenn Sie eine Sitzung in der Zwischenzeit archiviert haben, entarchivieren `--continue` und `--session-id` sie auf Claude Code v2.1.228 oder später.

229 223

230Um eine Sitzung zurückzubringen, die Sie mit `claude --remote-control` oder `/remote-control` gestartet haben, setzen Sie das Gespräch mit `claude --continue` oder `claude --resume` fort. Ob Claude Code erneut verbindet und zu welcher Sitzung, hängt vom [Wiederverbindungsdatensatz](#resume-outcomes) des Gesprächs ab.224Um eine Sitzung zurückzubringen, die Sie mit `claude --remote-control` oder `/remote-control` gestartet haben, setzen Sie das Gespräch mit `claude --continue` oder `claude --resume` fort. Wenn Remote Control nicht erneut verbunden wird, siehe [Konnte nicht erneut mit Ihrer Remote Control-Sitzung verbunden werden](#couldnt-reconnect-to-your-remote-control-session).

231 225

232Wenn Sie das Gespräch in einem zweiten Terminal fortsetzen, während das erste noch Remote Control aktiviert hat, druckt Claude Code eine Benachrichtigung im zweiten Terminal und lässt Remote Control dort stattdessen aus, anstatt die Sitzung vom ersten zu nehmen. Während Remote Control dort aus bleibt, sieht Claude in diesem Terminal nicht [Ihre Sitzungen auf anderen Maschinen](/docs/de/cross-session-messaging#see-which-sessions-claude-can-reach), und sie können es nicht erreichen. Führen Sie `/remote-control` im zweiten Terminal aus, um Remote Control dorthin zu verschieben.226Wenn Sie das Gespräch in einem zweiten Terminal fortsetzen, während das erste noch Remote Control aktiviert hat, druckt Claude Code eine `Remote Control not started here`-Benachrichtigung im zweiten Terminal und lässt Remote Control dort stattdessen aus, anstatt die Sitzung vom ersten zu nehmen. Führen Sie `/remote-control` im zweiten Terminal aus, um Remote Control dorthin zu verschieben.

233 227

234Wenn Sie ein Gespräch in Claude Desktop oder einer IDE-Erweiterung fortsetzen, die Remote Control aktiviert hatte, hängt Claude Code es erneut an die bestehende claude.ai-Sitzung an, anstatt eine neue zur Sitzungsliste hinzuzufügen.228Wenn Sie ein Gespräch in Claude Desktop oder einer IDE-Erweiterung fortsetzen, die Remote Control aktiviert hatte, hängt Claude Code es erneut an die bestehende claude.ai-Sitzung an, anstatt eine neue zur Sitzungsliste hinzuzufügen.

235 229

239 233

240Ihre lokale Claude Code-Sitzung stellt nur ausgehende HTTPS-Anfragen und öffnet niemals eingehende Ports auf Ihrem Computer. Wenn Sie Remote Control starten, registriert es sich bei der Anthropic-API und fragt nach Arbeit ab. Wenn Sie sich von einem anderen Gerät aus verbinden, leitet der Server Nachrichten zwischen dem Web- oder Mobile-Client und Ihrer lokalen Sitzung über eine Streaming-Verbindung weiter.234Ihre lokale Claude Code-Sitzung stellt nur ausgehende HTTPS-Anfragen und öffnet niemals eingehende Ports auf Ihrem Computer. Wenn Sie Remote Control starten, registriert es sich bei der Anthropic-API und fragt nach Arbeit ab. Wenn Sie sich von einem anderen Gerät aus verbinden, leitet der Server Nachrichten zwischen dem Web- oder Mobile-Client und Ihrer lokalen Sitzung über eine Streaming-Verbindung weiter.

241 235

242Der gesamte Datenverkehr verläuft über die Anthropic-API über TLS, die gleiche Transportsicherheit wie jede Claude Code-Sitzung. Die Verbindung verwendet mehrere kurzlebige Anmeldeinformationen, die jeweils auf einen einzelnen Zweck beschränkt sind und unabhängig ablaufen. Wenn die Registrierungsanmeldeinformation eines `claude remote-control`-Servers abläuft, registriert sich der Server erneut bei der Anthropic-API und bedient weiterhin seine Sitzungen.236Der gesamte Datenverkehr verläuft über die Anthropic-API über TLS, die gleiche Transportsicherheit wie jede Claude Code-Sitzung. Die Verbindung verwendet mehrere kurzlebige Anmeldeinformationen, die jeweils auf einen einzelnen Zweck beschränkt sind und unabhängig ablaufen.

243 237

244Während Remote Control verbunden ist, werden das Sitzungstranskript, einschließlich Ihrer Nachrichten, Claudes Antworten und Werkzeugaktivität, auf Anthropic-Servern gespeichert. Das gespeicherte Transkript hält die Konversation auf Ihren Geräten synchron und ermöglicht es der Sitzung, sich nach einem Netzwerkausfall erneut zu verbinden. Ausführung und Dateisystemzugriff bleiben auf Ihrem Computer, und gespeicherte Transkripte werden gemäß der [Datenutzungsrichtlinie](/docs/de/data-usage) beibehalten.238Während Remote Control verbunden ist, werden das Sitzungstranskript, einschließlich Ihrer Nachrichten, Claudes Antworten und Werkzeugaktivität, auf Anthropic-Servern gespeichert. Das gespeicherte Transkript hält die Konversation auf Ihren Geräten synchron und ermöglicht es der Sitzung, sich nach einem Netzwerkausfall erneut zu verbinden. Ausführung und Dateisystemzugriff bleiben auf Ihrem Computer, und gespeicherte Transkripte werden gemäß der [Datenutzungsrichtlinie](/docs/de/data-usage) beibehalten.

245 239

309Bei einem verlorenen oder gestohlenen Gerät entfernt das Mitglied es von dieser Seite. Wenn sich das Mitglied nicht anmelden kann, kann ein Administrator **Überall abmelden** in der Admin-Konsole verwenden, um alle Sitzungen und registrierten Geräte für dieses Mitglied zu widerrufen. Danach registriert sich das Mitglied die Geräte erneut, die es noch besitzt.303Bei einem verlorenen oder gestohlenen Gerät entfernt das Mitglied es von dieser Seite. Wenn sich das Mitglied nicht anmelden kann, kann ein Administrator **Überall abmelden** in der Admin-Konsole verwenden, um alle Sitzungen und registrierten Geräte für dieses Mitglied zu widerrufen. Danach registriert sich das Mitglied die Geräte erneut, die es noch besitzt.

310 304

311<h2 id="remote-control-vs-cloud-sessions">305<h2 id="remote-control-vs-cloud-sessions">

312 Remote Control vs. Cloud-Sitzungen306 Remote Control vs Cloud-Sitzungen

313</h2>307</h2>

314 308

315Remote Control und [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) verwenden beide die claude.ai/code-Schnittstelle. Der Hauptunterschied liegt darin, wo die Sitzung ausgeführt wird: Remote Control wird auf Ihrem Computer ausgeführt, sodass Ihre lokalen MCP-Server, Tools und Projektkonfiguration verfügbar bleiben. Eine Cloud-Sitzung wird in Cloud-Infrastruktur ausgeführt, standardmäßig von Anthropic verwaltet.309Remote Control und [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) verwenden beide die claude.ai/code-Schnittstelle. Der Hauptunterschied liegt darin, wo die Sitzung ausgeführt wird: Remote Control wird auf Ihrem Computer ausgeführt, sodass Ihre lokalen MCP-Server, Tools und Projektkonfiguration verfügbar bleiben. Eine Cloud-Sitzung wird auf Cloud-Infrastruktur ausgeführt, standardmäßig von Anthropic verwaltet.

310

311Verwenden Sie Remote Control, wenn Sie gerade an lokaler Arbeit sind und von einem anderen Gerät aus weitermachen möchten. Verwenden Sie eine Cloud-Sitzung, wenn Sie eine Aufgabe ohne lokales Setup starten möchten, an einem Repository arbeiten, das Sie nicht geklont haben, oder mehrere Aufgaben parallel ausführen möchten. Ein [Projekt](/docs/de/claude-projects) kombiniert die beiden: Seine Threads werden in der Cloud ausgeführt, und es verwendet Remote Control, um [einen Thread auf Ihrem Computer auszuführen](/docs/de/claude-projects#run-a-thread-on-your-own-computer), wenn Sie dies dort anfordern.

312

313Claude Code bietet mehrere Möglichkeiten, um zu arbeiten, wenn Sie nicht an Ihrem Terminal sind. Sie unterscheiden sich darin, was die Arbeit auslöst, wo Claude ausgeführt wird und wie viel Setup Sie benötigen.

316 314

317Verwenden Sie Remote Control, wenn Sie sich mitten in lokaler Arbeit befinden und von einem anderen Gerät aus weitermachen möchten. Verwenden Sie eine Cloud-Sitzung, wenn Sie eine Aufgabe ohne lokale Einrichtung starten möchten, an einem Repository arbeiten, das Sie nicht geklont haben, oder mehrere Aufgaben parallel ausführen möchten.315| | Auslöser | Claude wird ausgeführt auf | Setup | Am besten geeignet für |

316| :- | :- | :- | :- | :- |

318| [Remote Control](/docs/de/remote-control) | Steuern Sie eine laufende Sitzung von [claude.ai/code](https://claude.ai/code) oder der Claude Mobile-App | Ihr Computer (CLI, Desktop oder VS Code) | Führen Sie [`claude remote-control` oder `/remote-control`](/docs/de/remote-control#start-a-remote-control-session) aus | Steuerung laufender Arbeiten von einem anderen Gerät |

319| [Channels](/docs/de/channels) | Pushen Sie Ereignisse aus einer Chat-App wie Telegram oder Discord oder Ihrem eigenen Server | Ihr Computer (CLI) | [Installieren Sie ein Channel-Plugin](/docs/de/channels#quickstart) oder [erstellen Sie Ihr eigenes](/docs/de/channels-reference) | Reagieren auf externe Ereignisse wie CI-Fehler oder Chat-Nachrichten |

320| [Slack](/docs/de/slack) | Erwähnen Sie `@Claude` in einem Team-Kanal | Anthropic Cloud | [Installieren Sie die Slack-App](/docs/de/slack#setting-up-claude-code-in-slack) mit [Claude Code im Web](/docs/de/claude-code-on-the-web) aktiviert | PRs und Reviews aus Team-Chat |

321| [Self-hosted environments](/docs/de/self-hosted-environments) | Starten Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) und wählen Sie die Umgebung Ihrer Organisation | Infrastruktur Ihrer Organisation | [Stellen Sie Runner bereit](/docs/de/self-hosted-environments-quickstart), in Team- und Enterprise-Plänen | Cloud-Sitzungen, die in Ihrem Netzwerk ausgeführt werden müssen |

318 323

319<h2 id="mobile-push-notifications">324<h2 id="mobile-push-notifications">

320 Mobile Push-Benachrichtigungen325 Mobile Push-Benachrichtigungen

322 327

323Wenn Remote Control aktiv ist, kann Claude Push-Benachrichtigungen an Ihr Telefon senden.328Wenn Remote Control aktiv ist, kann Claude Push-Benachrichtigungen an Ihr Telefon senden.

324 329

325Claude entscheidet, wann eine Push-Benachrichtigung gesendet wird. Sie wird normalerweise gesendet, wenn eine lange laufende Aufgabe abgeschlossen ist oder wenn Claude eine Entscheidung von Ihnen benötigt, um fortzufahren. Sie können auch eine Push-Benachrichtigung in Ihrer Eingabeaufforderung anfordern, zum Beispiel `notify me when the tests finish`. Über die beiden Ein-/Aus-Schalter unten gibt es keine Pro-Event-Konfiguration.330Claude entscheidet, wann eine Push-Benachrichtigung gesendet wird. Normalerweise sendet er eine, wenn eine lange laufende Aufgabe abgeschlossen ist oder wenn er eine Entscheidung von Ihnen benötigt, um fortzufahren. Sie können auch eine Push-Benachrichtigung in Ihrer Eingabeaufforderung anfordern, zum Beispiel `notify me when the tests finish`. Über die beiden Ein-/Aus-Schalter unten hinaus gibt es keine Konfiguration pro Ereignis.

326 331

327So richten Sie Mobile Push-Benachrichtigungen ein:332So richten Sie Mobile Push-Benachrichtigungen ein:

328 333

329<Steps>334<Steps>

330 <Step title="Installieren Sie die Claude-Mobile-App">335 <Step title="Installieren Sie die Claude Mobile App">

331 Laden Sie die Claude-App für [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) oder [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) herunter.336 Laden Sie die Claude App für [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) oder [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) herunter.

332 </Step>337 </Step>

333 338

334 <Step title="Melden Sie sich mit Ihrem Claude Code-Konto an">339 <Step title="Melden Sie sich mit Ihrem Claude Code Konto an">

335 Verwenden Sie dasselbe Konto und die gleiche Organisation, die Sie für Claude Code im Terminal verwenden.340 Verwenden Sie dasselbe Konto und die gleiche Organisation, die Sie für Claude Code im Terminal verwenden.

336 </Step>341 </Step>

337 342

338 <Step title="Benachrichtigungen zulassen">343 <Step title="Benachrichtigungen zulassen">

339 Akzeptieren Sie die Benachrichtigungsberechtigungsaufforderung des Betriebssystems.344 Akzeptieren Sie die Benachrichtigungsgenehmigungsaufforderung des Betriebssystems.

340 </Step>345 </Step>

341 346

342 <Step title="Aktivieren Sie Push in Claude Code">347 <Step title="Aktivieren Sie Push in Claude Code">

343 Führen Sie in Ihrem Terminal `/config` aus und aktivieren Sie **Push when Claude decides** für proaktive Benachrichtigungen, **Push when actions required** für Berechtigungsaufforderungen und Fragen oder beides.348 Führen Sie in Ihrem Terminal `/config` aus und aktivieren Sie **Push when Claude decides** für proaktive Benachrichtigungen, **Push when actions required** für Genehmigungsaufforderungen und Fragen oder beides.

344 </Step>349 </Step>

345</Steps>350</Steps>

346 351

347Wenn Benachrichtigungen nicht ankommen:352Wenn Benachrichtigungen nicht ankommen:

348 353

349* Wenn `/config` **No mobile registered** anzeigt, öffnen Sie die Claude-App auf Ihrem Telefon, damit sie ihr Push-Token aktualisieren kann. Die Warnung wird beim nächsten Verbinden von Remote Control gelöscht.354* Wenn `/config` **No mobile registered** anzeigt, öffnen Sie die Claude App auf Ihrem Telefon, damit sie ihr Push-Token aktualisieren kann. Die Warnung wird beim nächsten Verbindungsaufbau von Remote Control gelöscht.

350* Auf iOS können Focus-Modi und Benachrichtigungszusammenfassungen Push-Benachrichtigungen unterdrücken oder verzögern. Überprüfen Sie Einstellungen → Benachrichtigungen → Claude.355* Auf iOS können Focus-Modi und Benachrichtigungszusammenfassungen Push-Benachrichtigungen unterdrücken oder verzögern. Überprüfen Sie Einstellungen → Benachrichtigungen → Claude.

351* Auf Android kann aggressive Batterieoptimierung die Zustellung verzögern. Befreien Sie die Claude-App von der Batterieoptimierung in den Systemeinstellungen.356* Auf Android kann aggressive Akkuoptimierung die Zustellung verzögern. Befreien Sie die Claude App von der Akkuoptimierung in den Systemeinstellungen.

352 357

353Claude Code überspringt Mobile Push-Benachrichtigungen, während Sie im verbundenen Terminal tippen oder sich darauf konzentrieren. Ab v2.1.181 können Sie [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/de/env-vars) auf einen Markierungsdateipfad setzen, um dies auf jede Zeit auszudehnen, in der Sie sich am Computer befinden, auch in einem anderen Fenster: Benachrichtigungen werden übersprungen, während die Datei vorhanden ist. Konfigurieren Sie einen Bildschirmsperr-Listener oder ein ähnliches Tool, um die Datei zu erstellen, wenn Ihr Bildschirm entsperrt wird, und löschen Sie sie, wenn Ihr Bildschirm gesperrt wird.358Claude Code überspringt Mobile Push-Benachrichtigungen, während Sie im verbundenen Terminal tippen oder sich darauf konzentrieren. Um dies auf jede Zeit auszudehnen, in der Sie sich an der Maschine befinden, auch in einem anderen Fenster, setzen Sie [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/de/env-vars) auf einen Markierungsdateipfad: Benachrichtigungen werden übersprungen, während die Datei vorhanden ist. Konfigurieren Sie einen Bildschirmsperr-Listener oder ein ähnliches Tool, um die Datei zu erstellen, wenn Ihr Bildschirm entsperrt wird, und löschen Sie sie, wenn Ihr Bildschirm gesperrt wird.

354 359

355<h2 id="limitations">360<h2 id="limitations">

356 Einschränkungen361 Einschränkungen

357</h2>362</h2>

358 363

359* **Eine Remote-Sitzung pro interaktivem Prozess**: Außerhalb des Server-Modus unterstützt jede Claude Code-Instanz jeweils eine Remote-Sitzung. Verwenden Sie den [Server-Modus](#start-a-remote-control-session), um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen.364* **Eine Remote-Sitzung pro interaktivem Prozess**: Außerhalb des Server-Modus unterstützt jede Claude Code-Instanz jeweils eine Remote-Sitzung. Verwenden Sie den [Server-Modus](#start-a-remote-control-session), um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen.

360* **Lokaler Prozess muss weiterhin ausgeführt werden**: Remote Control wird als lokaler Prozess ausgeführt. Wenn Sie das Terminal schließen, VS Code beenden oder den `claude`-Prozess anderweitig beenden, geht die Sitzung offline, bis Sie sie [wieder aktivieren](#resume-sessions-after-stopping-the-server). Sofern Claude nicht gerade eine Aufgabe ausführt, zeigen claude.ai und die Claude-App die Sitzung innerhalb von Sekunden nach dem Beenden des Prozesses als offline an. Um eine Sitzung auf einem Remote-Computer nach dem Trennen von SSH weiterhin auszuführen, starten Sie sie in `tmux` oder `screen`.365* **Lokaler Prozess muss weiterhin ausgeführt werden**: Remote Control wird als lokaler Prozess ausgeführt. Wenn Sie das Terminal schließen, die Desktop-App oder VS Code beenden oder den `claude`-Prozess anderweitig stoppen, geht die Sitzung offline, bis Sie sie [wiederherstellen](#resume-sessions-after-stopping-the-server). Um eine Sitzung auf einem Remote-Computer nach dem Trennen von SSH weiterhin auszuführen, starten Sie sie in `tmux` oder `screen`.

361* **Abgestürzte Sitzungen im Server-Modus**: Wenn eine von `claude remote-control` bereitgestellte Sitzung abstürzt, senden Sie ihr eine Nachricht von einem verbundenen Gerät. Claude Code stellt sie erneut bereit. Sie müssen den Server nicht neu starten. Erfordert Claude Code v2.1.238 oder später.366* **Abgestürzte Sitzungen im Server-Modus**: Wenn eine von `claude remote-control` bereitgestellte Sitzung abstürzt, senden Sie ihr eine Nachricht von einem verbundenen Gerät. Claude Code stellt sie erneut bereit. Sie müssen den Server nicht neu starten. Erfordert Claude Code v2.1.238 oder später.

362* **HTTP 403-Ablehnungen bei einer verbundenen Sitzung**: Sobald eine interaktive Sitzung verbunden ist, versucht Claude Code bis zu drei Minuten lang erneut, wenn etwas zwischen Ihrem Computer und den Servern von Anthropic mit HTTP 403 antwortet, was nach einem VPN- oder Netzwerkwechsel vorkommen kann. Wenn die Ablehnungen länger andauern, trennt Claude Code die Verbindung, und der Grund gibt an, was abgelehnt hat: ein Netzwerk-Edge, oder ein Proxy, VPN oder eine Firewall in Ihrem eigenen Netzwerk.367* **HTTP 403-Ablehnungen bei einer verbundenen Sitzung**: Sobald eine interaktive Sitzung verbunden ist, versucht Claude Code bis zu drei Minuten lang erneut, wenn etwas zwischen Ihrem Computer und den Servern von Anthropic mit HTTP 403 antwortet, was nach einer VPN- oder Netzwerkänderung vorkommen kann. Wenn die Ablehnungen länger andauern, trennt Claude Code die Verbindung, und der Grund gibt an, was abgelehnt hat: ein Netzwerk-Edge, oder ein Proxy, VPN oder eine Firewall in Ihrem eigenen Netzwerk.

363* **Längerer Netzwerkausfall**: Wenn Ihr Computer aktiv ist, aber das Netzwerk nicht erreichen kann, hängt das, was Sie als Nächstes tun, vom Modus ab:368* **Längerer Netzwerkausfall**: Wenn Ihr Computer aktiv ist, aber das Netzwerk nicht erreichen kann, hängt das, was Sie als Nächstes tun, vom Modus ab:

364 * **Server-Modus**: Claude Code gibt nach etwa 10 Minuten auf und der `claude remote-control`-Prozess wird beendet. Führen Sie `claude remote-control` erneut aus, um eine neue Sitzung zu starten.369 * **Server-Modus**: Claude Code gibt nach etwa 10 Minuten auf und der `claude remote-control`-Prozess wird beendet. Führen Sie `claude remote-control` erneut aus, um eine neue Sitzung zu starten.

365 * **Interaktive Sitzung**: Arbeiten Sie lokal weiter. Claude Code versucht es erneut, solange der Ausfall andauert, und verbindet sich automatisch wieder, wenn das Netzwerk zurückkommt.370 * **Interaktive Sitzung**: Arbeiten Sie lokal weiter. Claude Code versucht es erneut, solange der Ausfall andauert, und stellt die Verbindung automatisch wieder her, wenn das Netzwerk zurückkommt.

366* **Presence-Heartbeats schlagen fehl**: Wenn sich eine interaktive Sitzung mit `could not reach the Remote Control server for about 30 minutes` trennt, führen Sie `/remote-control` aus, um die Verbindung wiederherzustellen. Claude Code zeigt diese Nachricht nur an, wenn die Presence-Heartbeats der Sitzung fehlgeschlagen sind, während der Rest der Verbindung bestehen blieb; es registriert die Sitzung für etwa 30 Minuten erneut, bevor die Verbindung getrennt wird.371* **Presence-Heartbeats schlagen fehl**: Wenn eine interaktive Sitzung mit `could not reach the Remote Control server for about 30 minutes` getrennt wird, führen Sie `/remote-control` aus, um die Verbindung wiederherzustellen.

367* **Weitergeleitete Dialoge verfallen**: Claude Code hält Berechtigungsaufforderungen und `AskUserQuestion`-Fragen offen, bis Sie sie beantworten. Wenn Claude Code eine andere Art von Dialog an die Remote-Sitzung weiterleitet, z. B. die Modellauswahlmeldung, die nach einer Sicherheitsablehnung angezeigt wird, wartet es standardmäßig fünf Minuten, schließt dann den Dialog und fährt mit dem Standardwert „Keine Aktion" des Dialogs fort. Legen Sie [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry) fest, um die Frist anzupassen oder zu deaktivieren. Erfordert Claude Code v2.1.224 oder später.372* **Weitergeleitete Dialoge verfallen**: Claude Code hält Berechtigungsaufforderungen und `AskUserQuestion`-Fragen offen, bis Sie sie beantworten. Wenn Claude Code einen anderen Dialog an die Remote-Sitzung weiterleitet, z. B. die nach einer Sicherheitsablehnung angezeigte Modellauswahlabfrage, wartet es standardmäßig fünf Minuten, schließt dann den Dialog und fährt mit der Standardeinstellung „Keine Aktion" des Dialogs fort. Legen Sie [`dialogExpiry`](/docs/de/settings-reference#dialogexpiry) fest, um die Frist anzupassen oder zu deaktivieren. Erfordert Claude Code v2.1.224 oder später.

368* **Die Fable-Zustimmungsaufforderung für Nutzungsguthaben wird nicht weitergeleitet**: Claude Code zeigt die [Fable-Zustimmungsaufforderung für Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) in der Mitte der Sitzung nur dort an, wo die Sitzung ausgeführt wird, nicht auf Ihrem Gerät. Wenn die Sitzung in einem Terminal ausgeführt wird und niemand dort antwortet, bevor Claude Code die Aufforderung schließt, endet der Zug, ohne die Anfrage zu senden; siehe [Die Aufforderung zur Bestätigung blieb unbeantwortet](/docs/de/errors#the-prompt-to-confirm-went-unanswered).373* **Die Fable-Zustimmungsaufforderung für Nutzungsguthaben wird nicht weitergeleitet**: Claude Code zeigt die Mid-Session-[Fable-Zustimmungsaufforderung für Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) nur dort an, wo die Sitzung ausgeführt wird, nicht auf Ihrem Gerät. Wenn die Sitzung in einem Terminal ausgeführt wird und niemand dort antwortet, bevor Claude Code die Aufforderung schließt, endet der Zug ohne Senden der Anfrage; siehe [The prompt to confirm went unanswered](/docs/de/errors#the-prompt-to-confirm-went-unanswered).

369* **Einige Befehle sind nur lokal verfügbar**: Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie `/plugin` oder `/resume`, funktionieren nur über die lokale CLI, unabhängig davon, ob Sie ein Argument übergeben oder nicht. Die folgenden funktionieren von mobil und Web aus:374* **Einige Befehle sind nur lokal**: Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, z. B. `/plugin` oder `/resume`, funktionieren nur über die lokale CLI, unabhängig davon, ob Sie ein Argument übergeben oder nicht. Die folgenden funktionieren von Mobilgeräten und Web:

370 * Textausgabe-Befehle: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` und `/reload-plugins`. `/usage-credits` gibt die Abrechnungs-URL aus, anstatt einen Browser zu öffnen. `/reload-plugins` funktioniert nur, wenn die Sitzung in einem interaktiven Terminal ausgeführt wird; eine Sitzung ohne eines lehnt es ab.375 * Textausgabe-Befehle: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` und `/reload-plugins`. `/usage-credits` gibt die Abrechnungs-URL aus, anstatt einen Browser zu öffnen. `/reload-plugins` funktioniert nur, wenn die Sitzung in einem interaktiven Terminal ausgeführt wird; eine Sitzung ohne eines lehnt es ab.

371 * `/model`, `/effort`, `/fast`, `/color` und `/rename`: übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet` oder `/effort high`. Von mobil und Web aus akzeptieren `/model` und `/effort` das Argument anstelle der Terminal-Auswahl oder des Schiebereglers.376 * `/model`, `/effort`, `/fast`, `/color` und `/rename`: Übergeben Sie den Wert als Argument, z. B. `/model sonnet` oder `/effort high`. Von Mobilgeräten und Web aus nehmen `/model` und `/effort` das Argument anstelle der Terminal-Auswahl oder des Schiebereglers.

372 * `/mcp`: Von der mobilen App aus gibt es eine Textzusammenfassung des Server-Status zurück, anstatt die Auswahl zu öffnen. Im Web öffnet `/mcp` allein ein Verzeichnis von [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai), anstatt die Zusammenfassung zurückzugeben. Die `reconnect`-, `enable`- und `disable`-[Unterbefehle](/docs/de/commands#all-commands) funktionieren von beiden aus. Im Gegensatz zur lokalen CLI verbindet `/mcp reconnect` ohne Servernamen jeden Server wieder, der fehlgeschlagen ist oder eine Authentifizierung benötigt.377 * `/mcp`: Aus der mobilen App gibt es eine Textzusammenfassung des Serverstatus zurück, anstatt die Auswahl zu öffnen. Im Web öffnet `/mcp` allein ein Verzeichnis von [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) anstatt die Zusammenfassung zurückzugeben. Die [Unterbefehle](/docs/de/commands#all-commands) `reconnect`, `enable` und `disable` funktionieren von beiden. Im Gegensatz zur lokalen CLI verbindet `/mcp reconnect` ohne Servernamen jeden Server wieder, der fehlgeschlagen ist oder eine Authentifizierung benötigt.

373 * `/config`: Von der mobilen App aus übergeben Sie `key=value`, um eine Einstellung festzulegen, oder führen Sie es ohne Argument aus, um die Schlüssel aufzulisten, die Sie festlegen können. Im Web öffnet `/config` stattdessen den Claude Code-Bereich Ihrer Einstellungen und ignoriert Text nach dem Befehl.378 * `/config`: Aus der mobilen App übergeben Sie `key=value`, um eine Einstellung festzulegen, oder führen Sie sie ohne Argument aus, um die Schlüssel aufzulisten, die Sie festlegen können. Im Web öffnet `/config` stattdessen den Claude Code-Abschnitt Ihrer Einstellungen und ignoriert Text nach dem Befehl.

374 * Auf Team und Enterprise sendet `/usage-credits` von mobil oder Web keine [Anfrage für Nutzungsguthaben an Ihren Administrator](/docs/de/costs#add-usage-credits-to-your-subscription). Das Senden erfordert eine Bestätigung, die nur in der interaktiven CLI angezeigt wird, daher teilt Ihnen der Befehl mit, dass Sie ihn stattdessen dort ausführen sollen. Vor v2.1.211 sendete die Textform die Anfrage ohne Bestätigung.379 * Auf Team und Enterprise sendet `/usage-credits` von Mobilgeräten oder Web keine [Anfrage für Nutzungsguthaben an Ihren Administrator](/docs/de/costs#add-usage-credits-to-your-subscription). Das Senden erfordert eine Bestätigung, die nur in der interaktiven CLI angezeigt wird, daher teilt Ihnen der Befehl mit, ihn stattdessen dort auszuführen.

375 * `/autocompact`, ab v2.1.221: übergeben Sie die Fenstergröße als Argument, zum Beispiel `/autocompact 500k`. Ohne Argument gibt es die aktuelle Fenstergröße als Text aus, anstatt den Dialog zu öffnen, den der Befehl in einer Terminal-Sitzung anzeigt.380 * `/autocompact`, ab v2.1.221: Übergeben Sie die Fenstergröße als Argument, z. B. `/autocompact 500k`. Ohne Argument gibt es die aktuelle Fenstergröße als Text aus, anstatt den Dialog zu öffnen, den der Befehl in einer Terminal-Sitzung anzeigt.

376 * `/advisor`, ab v2.1.260: übergeben Sie das Modell als Argument, zum Beispiel `/advisor opus`, oder übergeben Sie `off`, um den Advisor auszuschalten. Beide Formen gelten nur für die aktuelle Sitzung und lassen Ihren gespeicherten Standard unverändert. Ohne Argument gibt es den aktuellen Advisor als Text aus, anstatt die Auswahl zu öffnen.381 * `/advisor`, ab v2.1.260: Übergeben Sie das Modell als Argument, z. B. `/advisor opus`, oder übergeben Sie `off`, um den Advisor auszuschalten. Beide Formen gelten nur für die aktuelle Sitzung und lassen Ihren gespeicherten Standard unverändert. Ohne Argument gibt es den aktuellen Advisor als Text aus, anstatt die Auswahl zu öffnen.

377 * `/output-style`, ab v2.1.269: übergeben Sie den Stilnamen als Argument, zum Beispiel `/output-style concise`, oder führen Sie es ohne Argument aus, um die Stile aufzulisten. Von mobil und Web aus können Sie nur [integrierte Stile](/docs/de/output-styles#built-in-output-styles) auflisten und auswählen. Um einen [benutzerdefinierten Stil](/docs/de/output-styles#create-a-custom-output-style) zu verwenden, wählen Sie ihn in der Sitzung selbst aus.382 * `/output-style`, ab v2.1.269: Übergeben Sie den Stilnamen als Argument, z. B. `/output-style concise`, oder führen Sie ihn ohne Argument aus, um die Stile aufzulisten. Von Mobilgeräten und Web aus können Sie nur [integrierte Stile](/docs/de/output-styles#built-in-output-styles) auflisten und auswählen. Um einen [benutzerdefinierten Stil](/docs/de/output-styles#create-a-custom-output-style) zu verwenden, wählen Sie ihn in der Sitzung selbst aus.

383 * `/focus`, ab v2.1.281: Übergeben Sie `on` oder `off` als Argument, z. B. `/focus on`, oder führen Sie ihn ohne Argument aus, um die [Fokusansicht](/docs/de/commands#all-commands) umzuschalten. Beide Formen gelten nur für die aktuelle Sitzung und lassen Ihre gespeicherte Auswahl unverändert.

378 384

379<h2 id="troubleshooting">385<h2 id="troubleshooting">

380 Fehlerbehebung386 Fehlerbehebung

388 394

389* Abgemeldet, von `/remote-control` oder `--remote-control`: `Remote Control requires a claude.ai subscription.` oder `/remote-control requires a claude.ai subscription.`395* Abgemeldet, von `/remote-control` oder `--remote-control`: `Remote Control requires a claude.ai subscription.` oder `/remote-control requires a claude.ai subscription.`

390* Abgemeldet, von `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`396* Abgemeldet, von `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`

391* Angemeldet, aber ein API-Schlüssel oder Token wird verwendet: `Remote Control requires claude.ai subscription auth.` gefolgt von der verwendeten Anmeldeinformation, wie `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Eine `apiKeyHelper`-Einstellung und `ANTHROPIC_AUTH_TOKEN` werden auf die gleiche Weise benannt.397* Angemeldet, aber ein API-Schlüssel oder Token wird verwendet: `Remote Control requires claude.ai subscription auth.` gefolgt von der verwendeten Anmeldeinformation, z. B. `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Eine `apiKeyHelper`-Einstellung und `ANTHROPIC_AUTH_TOKEN` werden auf die gleiche Weise benannt.

392 398

393Führen Sie `claude auth login` aus und wählen Sie die claude.ai-Option. Wenn die Meldung `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN` nennt, heben Sie die Festlegung überall dort auf, wo sie festgelegt ist: in Ihrer Shell-Umgebung oder im `env`-Block einer [Einstellungsdatei](/docs/de/settings-reference#env). Wenn sie `apiKeyHelper` nennt, entfernen Sie diese Einstellung.399Führen Sie `claude auth login` aus und wählen Sie die claude.ai-Option. Wenn die Meldung `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN` nennt, entfernen Sie diese überall dort, wo sie festgelegt sind: in Ihrer Shell-Umgebung oder im `env`-Block einer [Einstellungsdatei](/docs/de/settings-reference#env). Wenn sie `apiKeyHelper` nennt, entfernen Sie diese Einstellung.

~~394~~

395Vor v2.1.206 meldete das Ausführen von `/remote-control` während der Abmeldung `Unknown command: /remote-control` statt dieser Meldung.

396 400

397<h3 id="remote-control-requires-a-full-scope-login-token">401<h3 id="remote-control-requires-a-full-scope-login-token">

398 „Remote Control erfordert ein Token mit vollständigem Umfang"402 „Remote Control erfordert ein Token mit vollständigem Umfang"

399</h3>403</h3>

400 404

401Sie sind mit einem langlebigen Token von `claude setup-token` oder der Umgebungsvariable `CLAUDE_CODE_OAUTH_TOKEN` authentifiziert. Diese Token können nur Modellanfragen stellen, daher können sie keine Remote Control-Sitzungen einrichten. Führen Sie `claude auth login` aus, um sich stattdessen mit einem Token mit vollständigem Umfang zu authentifizieren.405Sie sind mit einem langlebigen Token von `claude setup-token` oder der Umgebungsvariablen `CLAUDE_CODE_OAUTH_TOKEN` authentifiziert. Diese Token können nur Modellanfragen stellen, daher können sie keine Remote-Control-Sitzungen einrichten. Führen Sie `claude auth login` aus, um sich stattdessen mit einem Token mit vollständigem Umfang zu authentifizieren.

402 406

403<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">407<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">

404 „Ihre Organisation für die Remote Control-Berechtigung konnte nicht bestimmt werden"408 „Ihre Organisation für die Remote-Control-Berechtigung konnte nicht bestimmt werden"

405</h3>409</h3>

406 410

407Ihre zwischengespeicherten Kontoinformationen sind veraltet oder unvollständig. Führen Sie `claude auth login` aus, um sie zu aktualisieren.411Ihre zwischengespeicherten Kontoinformationen sind veraltet oder unvollständig. Führen Sie `claude auth login` aus, um diese zu aktualisieren.

408 412

409<h3 id="remote-control-isn’t-enabled-for-this-account">413<h3 id="remote-control-isn’t-enabled-for-this-account">

410 „Remote Control ist für dieses Konto nicht aktiviert"414 „Remote Control ist für dieses Konto nicht aktiviert"

411</h3>415</h3>

412 416

413Claude Code hat die Remote Control-Verfügbarkeit für das Konto überprüft, mit dem Sie angemeldet sind, und die Überprüfung kam als deaktiviert zurück. Die übliche Ursache sind zwischengespeicherte Berechtigungen, die nach einer Planänderung veraltet sind. Führen Sie `claude auth logout` und dann `claude auth login` aus, um sie zu aktualisieren, und aktualisieren Sie Claude Code, wenn Sie eine alte Version verwenden.417Claude Code hat die Remote-Control-Verfügbarkeit für das Konto überprüft, mit dem Sie angemeldet sind, und die Überprüfung kam mit „aus" zurück. Die übliche Ursache sind zwischengespeicherte Berechtigungen, die nach einer Planänderung veraltet sind. Führen Sie `claude auth logout` und dann `claude auth login` aus, um diese zu aktualisieren, und aktualisieren Sie Claude Code, wenn Sie eine alte Version verwenden.

414 418

415Führen Sie `claude doctor` aus, um zu sehen, welche einzelne Berechtigungsprüfung fehlgeschlagen ist. Umgebungsvariablenkonflikte, unerreichbare Prüfungen und die Remote Control-Einstellung Ihrer Organisation erzeugen jeweils ihre eigene Meldung, daher bedeutet dieser Fehler die Kontoebenen-Prüfung selbst.419Führen Sie `claude doctor` aus, um zu sehen, welche einzelne Berechtigungsprüfung fehlgeschlagen ist. Umgebungsvariablenkonflikte, unerreichbare Prüfungen und die Remote-Control-Einstellung Ihrer Organisation erzeugen jeweils ihre eigene Meldung, daher bedeutet dieser Fehler, dass die Prüfung auf Kontoebene selbst fehlgeschlagen ist.

416 420

417Vor v2.1.239 lautete diese Meldung „Remote Control ist für Ihr Konto noch nicht aktiviert". Vor v2.1.154 erzeugte auch eine Variable, die die Feature-Flag-Auswertung deaktiviert, wie `DISABLE_TELEMETRY` oder `DO_NOT_TRACK`, diese Meldung; der Eintrag „Remote Control erfordert Feature-Flag-Auswertung" unten behandelt diese Konfiguration.421Vor v2.1.239 lautete diese Meldung „Remote Control is not yet enabled for your account".

418 422

419<h3 id="couldn’t-verify-remote-control-eligibility">423<h3 id="couldn’t-verify-remote-control-eligibility">

420 „Remote Control-Berechtigung konnte nicht überprüft werden"424 „Remote-Control-Berechtigung konnte nicht überprüft werden"

421</h3>425</h3>

422 426

423Claude Code konnte den Feature-Flag-Service nicht erreichen, um zu überprüfen, ob Remote Control für Ihr Konto aktiviert ist, normalerweise weil Sie offline sind oder ein Proxy die Anfrage blockiert. Versuchen Sie es erneut, wenn Sie Netzwerkzugriff haben, oder führen Sie `claude doctor` aus, um Details zu erhalten. Die zugehörige Meldung „Remote Control-Richtlinie Ihrer Organisation konnte nicht überprüft werden" bedeutet, dass Claude Code diese Richtlinie nicht lesen konnte, und hat die gleiche Lösung. Beide Meldungen wurden in v2.1.178 hinzugefügt.427Claude Code konnte den Feature-Flag-Service nicht erreichen, um zu überprüfen, ob Remote Control für Ihr Konto aktiviert ist, normalerweise weil Sie offline sind oder ein Proxy die Anfrage blockiert. Versuchen Sie es erneut, wenn Sie Netzwerkzugriff haben, oder führen Sie `claude doctor` aus, um Details zu erhalten. Die zugehörige Meldung „Couldn't verify your organization's Remote Control policy" bedeutet, dass Claude Code beim Lesen dieser Richtlinie auf einen Fehler gestoßen ist, und hat die gleiche Lösung.

424 428

425<h3 id="remote-control-requires-feature-flag-evaluation">429<h3 id="remote-control-requires-feature-flag-evaluation">

426 „Remote Control erfordert Feature-Flag-Auswertung"430 „Remote Control erfordert Feature-Flag-Evaluierung"

427</h3>431</h3>

428 432

429Eine dieser Variablen ist festgelegt: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK`](/docs/de/env-vars). Jede von ihnen deaktiviert die Feature-Flag-Auswertung, von der die Remote Control-Verfügbarkeit abhängt, und die vollständige Meldung nennt die Variable, die Claude Code gefunden hat. Heben Sie diese Variable überall dort auf, wo sie festgelegt ist, in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings). Bei Versionen vor 2.1.154 erzeugt die gleiche Konfiguration stattdessen „Remote Control ist für Ihr Konto noch nicht aktiviert".433Eine [Umgebungsvariable](/docs/de/env-vars#features-that-need-feature-flag-fetching), die die Feature-Flag-Evaluierung deaktiviert, ist festgelegt, und die vollständige Meldung nennt die Variable, die Claude Code gefunden hat. In Versionen vor 2.1.154 erzeugt die gleiche Konfiguration stattdessen „Remote Control is not yet enabled for your account". Was zu tun ist, hängt von der Variable ab, die die Meldung nennt:

434

435* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK`**: Heben Sie die Festlegung der Variable überall dort auf, wo sie festgelegt ist, in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/docs/de/settings-reference#all-settings).

436* **`DISABLE_TELEMETRY` oder `DO_NOT_TRACK`**: Bei einem Pro-, Max-, Team- oder Enterprise-Plan mit nicht festgelegtem `DISABLE_GROWTHBOOK` lassen diese Variablen Remote Control verfügbar, es sei denn, Ihre Organisation erfordert [Vertrauenswürdige Geräte](#trusted-devices). Wenn dies der Fall ist, heben Sie die Festlegung der Variable überall dort auf, wo sie festgelegt ist, um Remote Control zu verwenden. Von v2.1.154 bis v2.1.282 erzeugte jede Variable diese Meldung, daher aktualisieren Sie Claude Code auf v2.1.283 oder später.

430 437

431<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">438<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">

432 „Remote Control ist nur verfügbar, wenn Sie Claude über api.anthropic.com verwenden"439 „Remote Control ist nur verfügbar, wenn Claude über api.anthropic.com verwendet wird"

433</h3>440</h3>

434 441

435Die Sitzung kommuniziert nicht direkt mit der Anthropic-API, daher gibt es kein claude.ai-Backend zum Koppeln. Dies geschieht auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Dies geschieht auch, wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen Host verweist, der nicht `api.anthropic.com` ist, wie ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden. Vor v2.1.196 zeigte Claude Code diese Meldung nicht für eine benutzerdefinierte `ANTHROPIC_BASE_URL`. Siehe die [Fehlerreferenz](/docs/de/errors#remote-control-requires-the-anthropic-api) für die vollständige Ursachenliste.442Die Sitzung spricht nicht direkt mit der Anthropic API, was Remote Control erfordert. Dies geschieht bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Es geschieht auch, wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden. Siehe die [Fehlerreferenz](/docs/de/errors#remote-control-requires-the-anthropic-api) für die vollständige Ursachenliste.

436 443

437Die Meldung nennt, was die Sitzung von der Anthropic-API abgelenkt hat, wie `CLAUDE_CODE_USE_BEDROCK` oder eine benutzerdefinierte `ANTHROPIC_BASE_URL`. Wenn Sie eine berechtigte claude.ai-Anmeldung haben, heben Sie die genannte Variable auf, entfernen Sie sie aus dem `env`-Schlüssel in [Einstellungen](/docs/de/settings), wenn Sie sie dort festgelegt haben, und starten Sie die Sitzung neu. Vor v2.1.219 war die Meldung nur der Satz in der Kopfzeile dieses Abschnitts, daher überprüfen Sie bei älteren Versionen Ihre Umgebung selbst auf Provider-Variablen wie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX` sowie auf `ANTHROPIC_BASE_URL`.444Die Meldung nennt, was die Sitzung von der Anthropic API weg geleitet hat, z. B. `CLAUDE_CODE_USE_BEDROCK` oder eine benutzerdefinierte `ANTHROPIC_BASE_URL`. Wenn Sie eine berechtigte claude.ai-Anmeldung haben, heben Sie die genannte Variable auf, entfernen Sie sie aus dem `env`-Schlüssel in [Einstellungen](/docs/de/settings), wenn Sie sie dort festgelegt haben, und starten Sie die Sitzung neu.

438 445

439<h3 id="remote-control-is-disabled-by-your-organization’s-policy">446<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

440 „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"447 „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"

441</h3>448</h3>

442 449

443Eine Richtlinie blockiert Remote Control, oder Claude Code konnte die Richtlinie Ihrer Organisation auf diesem Computer nicht laden und hält Remote Control vorerst deaktiviert. Überprüfen Sie diese Ursachen in dieser Reihenfolge:450Eine Richtlinie blockiert Remote Control. Überprüfen Sie diese Ursachen in der angegebenen Reihenfolge:

451

452* **Der Fehler erwähnt `disableRemoteControl`**: Ihr IT-Administrator hat Remote Control auf diesem Gerät durch [verwaltete Einstellungen](/docs/de/managed-settings) deaktiviert, unabhängig vom organisationsweiten Umschalter und davon, wie Sie angemeldet sind.

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

454* **Die Meldung sagt nicht, dass Sie Ihren Organisationsadministrator kontaktieren sollen**: Ihre Organisation hat eine HIPAA-Konfiguration, die mit Remote Control nicht kompatibel ist, und `/status` listet `HIPAA` in seiner `Compliance`-Zeile auf. In diesem Zustand ist der Remote-Control-Umschalter im Admin-Panel ausgegraut, daher kann ein Eigentümer ihn dort nicht ändern. Kontaktieren Sie den Anthropic-Support, um Optionen zu besprechen. Vor v2.1.267 zeigte dieser Fall stattdessen „Remote Control isn't available for your organization due to its compliance policy".

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

456

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

458

459<h3 id="couldnt-verify-your-organizations-policy-for-remote-control">

460 „Die Richtlinie Ihrer Organisation für Remote Control konnte nicht überprüft werden"

461</h3>

462

463Claude Code konnte die Richtlinie Ihrer Organisation nicht abrufen und hat keine gespeicherte Kopie auf diesem Computer, um sie stattdessen zu verwenden, daher hält es Remote Control aus, bis es bestätigen kann, dass Ihre Organisation dies zulässt. Dies geschieht normalerweise, wenn Sie Claude Code offline starten oder bevor ein VPN verbunden wird, oder wenn ein Proxy die Anfrage beeinträchtigt. Bei einer langsamen Verbindung kann es auch erscheinen, während die erste Anfrage noch unterwegs ist.

444 464

445* **Der Fehler erwähnt `disableRemoteControl`**: Ihr IT-Administrator hat Remote Control auf diesem Gerät über [verwaltete Einstellungen](/docs/de/managed-settings) deaktiviert, unabhängig vom organisationsweiten Schalter und davon, wie Sie angemeldet sind.465Die Meldung nimmt eine dieser Formen an:

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

447* **Die Organisationsrichtlinie wurde auf diesem Computer nicht geladen**: Führen Sie `claude doctor` aus und lesen Sie die Zeile `Organization policy`. Wenn die Zeile zeigt, dass die Richtlinie nicht geladen ist, ist das das, was Remote Control deaktiviert hält. Vor v2.1.261 druckte `claude doctor` diese Zeile nicht.467* Von `/remote-control`, `claude remote-control` oder `claude --remote-control`: `Couldn't verify your organization's policy for remote control. Check your network connection and try again.`

448* **Die Meldung sagt nicht, dass Sie Ihren Organisationsadministrator kontaktieren sollen**: Ihre Organisation hat eine HIPAA-Konfiguration, die mit Remote Control nicht kompatibel ist, und `/status` listet `HIPAA` in seiner Zeile `Compliance` auf. In diesem Zustand ist der Schalter Remote Control im Admin-Panel ausgegraut, daher kann ein Inhaber ihn dort nicht ändern. Kontaktieren Sie den Anthropic-Support, um Optionen zu besprechen. Vor v2.1.267 zeigte dieser Fall „Remote Control ist für Ihre Organisation aufgrund ihrer Compliance-Richtlinie nicht verfügbar" statt.468* Von [Auto-Verbindung](#enable-remote-control-for-all-sessions), wenn eine Sitzung startet: `couldn't verify your organization's policy — check your network connection and try again`, mit dem Präfix `Remote Control failed` in der Benachrichtigung und `Remote Control disconnected` in der Konversation. Die Sitzung lässt Remote Control dann aus.

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

470Stellen Sie Ihre Netzwerkverbindung wieder her, und führen Sie dann `/remote-control` aus oder führen Sie den Befehl erneut aus. Jeder Versuch überprüft die Richtlinie erneut, daher müssen Sie Claude Code nicht neu starten. Wenn die Meldung weiterhin angezeigt wird, führen Sie `claude doctor` aus und lesen Sie die Zeile `Organization policy`, die angibt, warum die Richtlinie nicht geladen wurde.

471

472Vor v2.1.281 zeigte dieser Zustand stattdessen `Remote Control is disabled by your organization's policy`.

450 473

451<h3 id="remote-credentials-fetch-failed">474<h3 id="remote-credentials-fetch-failed">

452 „Remote credentials fetch failed"475 „Abruf von Remote-Anmeldeinformationen fehlgeschlagen"

453</h3>476</h3>

454 477

455Claude Code konnte keine kurzlebige Anmeldeinformation von der Anthropic-API abrufen, um die Verbindung herzustellen. Führen Sie erneut mit `--verbose` aus, um den vollständigen Fehler zu sehen:478Claude Code konnte keine kurzlebige Anmeldeinformation von der Anthropic API abrufen, um die Verbindung herzustellen. Führen Sie erneut mit `--verbose` aus, um den vollständigen Fehler zu sehen:

456 479

457```bash theme={null}480```bash theme={null}

458claude remote-control --verbose481claude remote-control --verbose

461Häufige Ursachen:484Häufige Ursachen:

462 485

463* Nicht angemeldet: Führen Sie `claude` aus und verwenden Sie `/login`, um sich mit Ihrem claude.ai-Konto zu authentifizieren. API-Schlüssel-Authentifizierung wird für Remote Control nicht unterstützt.486* Nicht angemeldet: Führen Sie `claude` aus und verwenden Sie `/login`, um sich mit Ihrem claude.ai-Konto zu authentifizieren. API-Schlüssel-Authentifizierung wird für Remote Control nicht unterstützt.

464* 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.487* 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.

465* Sitzungserstellung fehlgeschlagen: Wenn Sie auch `Session creation failed — see debug log` sehen, ist der Fehler früher in der Einrichtung aufgetreten. Überprüfen Sie, dass Ihr Abonnement aktiv ist.488* 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.

~~466~~

467Ein veraltetes Anmelde-Token verursacht diesen Fehler nicht. Wenn die Anthropic-API das gespeicherte Token ablehnt, beispielsweise weil ein anderer Claude Code-Prozess es bereits aktualisiert hat, aktualisiert Claude Code das Token und versucht es automatisch erneut. Vor v2.1.224 führte ein veraltetes Token zum Fehler beim Remote Control-Start mit dieser Meldung, daher konnten Sitzungen, die auf [automatische Verbindung](#enable-remote-control-for-all-sessions) eingestellt waren, beim Start intermittierend fehlschlagen.

468 489

469<h3 id="couldn’t-reconnect-to-your-remote-control-session">490<h3 id="couldnt-reconnect-to-your-remote-control-session">

470 „Konnte nicht erneut mit Ihrer Remote Control-Sitzung verbunden werden"491 „Konnte nicht erneut mit Ihrer Remote-Control-Sitzung verbunden werden"

471</h3>492</h3>

472 493

473Wenn Sie ein Gespräch mit `claude --resume` oder `claude --continue` fortsetzen, verbindet sich Claude Code erneut mit der Remote Control-Sitzung, die in diesem Gespräch aufgezeichnet wurde. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der möglicherweise vorübergehend ist, wie eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist.494Wenn 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.

~~474~~

475Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen, oder starten Sie eine neue Sitzung mit `claude --remote-control`, um eine neue Remote Control-Sitzung zu erstellen. Ihre lokale Sitzung läuft ohne Remote Control weiter.

~~476~~

477<span id="resume-outcomes" />Wenn Sie fortsetzen, können Sie auch eines dieser Ergebnisse statt dieser Meldung erhalten:

~~478~~

479* **Der Server meldet die aufgezeichnete Sitzung als weg, oder der Wiederverbindungsdatensatz nennt ein anderes Konto**: Claude Code geht nach dem aus, was der Wiederverbindungsdatensatz des Gesprächs sagt:

480 * **Der Datensatz nennt Ihr angemeldetes Konto**: Claude Code startet eine Ersatzsitzung mit einem automatisch generierten Namen und lässt die früheren Meldungen des Gesprächs aus. Sie erhalten dies, nachdem Sie die Sitzung von claude.ai oder der Claude-App gelöscht haben, zum Beispiel.

481 * **Der Datensatz nennt ein anderes Konto**: Claude Code startet eine neue Sitzung ohne die früheren Meldungen des Gesprächs und ohne eine Meldung anzuzeigen, unabhängig davon, ob die aufgezeichnete Sitzung noch vorhanden ist.

482 * **Der Datensatz sagt nicht, welches Konto die Sitzung besaß, oder Claude Code kann Ihre gespeicherte Anmeldung nicht lesen**: Claude Code zeigt stattdessen [`Previous session is unavailable — run /remote-control to start a new one`](#previous-session-is-unavailable), startet nichts und entfernt den Datensatz aus dem Gespräch.

483* **Sie haben Remote Control vor dem Fortsetzen ausgeschaltet**: Sofern die App, die Claude Code hostet, Claude Code nicht mitgeteilt hat, dass die App die claude.ai-Sitzung besitzt, entfernte Claude Code den Wiederverbindungsdatensatz, als Sie Remote Control vom CLI-[Statusbereich](#check-connection-status), der VS Code-Erweiterung oder einem Host, der auf dem [Agent SDK](/docs/de/agent-sdk/overview) basiert, ausschalteten, daher verbindet es sich nicht erneut. Wenn eine besitzende App es ausschaltete, behielt Claude Code den Datensatz und verbindet sich erneut.

484* **Ein anderer Claude Code auf diesem Computer hat immer noch die Sitzung**: Sie sehen einen Hinweis, der mit `Remote Control not started here` beginnt, und Claude Code [lässt Remote Control in der fortgesetzten Sitzung ausgeschaltet](#resume-sessions-after-stopping-the-server). Führen Sie dort `/remote-control` aus, um es zu verschieben.

485 495

486<span id="reconnect-history" />Vor v2.1.232 reagierte Claude Code anders, wenn der Server die aufgezeichnete Sitzung als weg meldete. Von v2.1.227 bis v2.1.231 weigerte sich Claude Code, eine Ersatzsitzung zu starten, auch wenn der Datensatz Ihrem Konto entsprach. Bis v2.1.226 startete Claude Code eine Ersatzsitzung, unabhängig davon, ob der Datensatz Ihrem Konto entsprach, und erstellte sie in v2.1.224 bis v2.1.226 unter dem auf diesem Computer angemeldeten Konto, niemals unter einem anderen Konto, ohne die früheren Meldungen des Gesprächs hochzuladen. Vor v2.1.200 erstellte Claude Code nach jedem Wiederverbindungsfehler eine neue Sitzung.496Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen, oder starten Sie eine neue Sitzung mit `claude --remote-control`, um eine neue Remote-Control-Sitzung zu erstellen. Ihre lokale Sitzung läuft in der Zwischenzeit ohne Remote Control weiter.

487 497

488<h3 id="previous-session-is-unavailable">498<h3 id="previous-session-is-unavailable">

489 „Previous session is unavailable — run /remote-control to start a new one"499 „Vorherige Sitzung ist nicht verfügbar — führen Sie /remote-control aus, um eine neue zu starten"

490</h3>500</h3>

491 501

492Claude Code konnte die vorherige Remote Control-Sitzung nicht zurückbringen und stoppte, anstatt von selbst eine neue zu starten. Sie können diese Meldung sehen, nachdem Sie ein Gespräch mit `claude --resume` oder `claude --continue` fortsetzen, oder nachdem Claude Code [sich selbst nach einer Trennung erneut verbindet](/docs/de/errors#remote-control-couldnt-refresh-your-login).502Claude Code konnte die vorherige Remote-Control-Sitzung nicht wiederherstellen und stoppte, anstatt von selbst eine neue zu starten. Sie können diese Meldung sehen, nachdem Sie eine Konversation mit `claude --resume` oder `claude --continue` fortsetzen, oder nachdem Claude Code [sich nach einer Trennung selbst erneut verbindet](/docs/de/errors#remote-control-couldnt-refresh-your-login).

493 503

494Führen Sie `/remote-control` aus, um eine neue Remote Control-Sitzung unter der aktuellen Anmeldung zu starten; Ihre lokale Sitzung läuft ohne Remote Control weiter. Die zugehörige Meldung `Remote Control could not verify the signed-in account — run /remote-control to reconnect` hat die gleiche Lösung; Claude Code zeigt sie, wenn sich das angemeldete Konto zwischen der Validierung und der Wiederverbindung geändert hat oder nicht gelesen werden konnte. Wenn Sie `/remote-control` nach `Previous session is unavailable` ausführen, ohne Claude Code zuerst neu zu starten, lässt Claude Code die früheren Meldungen des Gesprächs aus der neuen Sitzung aus.504Führen Sie `/remote-control` aus, um eine neue Remote-Control-Sitzung unter der aktuellen Anmeldung zu starten; Ihre lokale Sitzung läuft in der Zwischenzeit ohne Remote Control weiter. Die zugehörige Meldung `Remote Control could not verify the signed-in account — run /remote-control to reconnect` hat die gleiche Lösung. Wenn Sie `/remote-control` nach `Previous session is unavailable` ausführen, ohne Claude Code zuerst neu zu starten, lässt Claude Code die früheren Meldungen der Konversation aus der neuen Sitzung aus.

~~495~~

496Beim Fortsetzen startet Claude Code [eine neue Sitzung an seiner Stelle](#resume-outcomes) nur, wenn der Wiederverbindungsdatensatz des Gesprächs das Konto nennt, das die Sitzung besaß, weil der Server eine Sitzung, die Sie gelöscht haben, und eine Sitzung, die ein anderes Konto besitzt, auf die gleiche Weise meldet. Claude Code vor v2.1.227 zeichnete dieses Konto nicht auf, und Claude Code kann den Datensatz nicht überprüfen, wenn es Ihre gespeicherte Anmeldung nicht lesen kann. Claude Code vor v2.1.232 zeigte stattdessen `Remote Control could not resume the previous session under the current login — run /remote-control to start fresh` in [einem anderen Satz von Fällen](#reconnect-history).

497 505

498<h3 id="remote-control-got-an-unexpected-server-response">506<h3 id="remote-control-got-an-unexpected-server-response">

499 „Remote Control got an unexpected server response"507 „Remote Control erhielt eine unerwartete Serverantwort"

500</h3>508</h3>

501 509

502Der Remote Control-Server akzeptierte eine Anfrage, antwortete aber in einer Form, die diese Version von Claude Code nicht lesen konnte, während die Remote-Sitzung erstellt oder ihre Anmeldeinformationen abgerufen wurden. Das erneute Versuchen in der gleichen Version schlägt auf die gleiche Weise fehl. Führen Sie `claude update` aus und führen Sie dann `/remote-control` aus, um sich erneut zu verbinden. Diese Meldung wurde in v2.1.225 hinzugefügt.510Der Remote-Control-Server akzeptierte eine Anfrage, antwortete aber in einer Form, die diese Version von Claude Code nicht lesen konnte, während die Remote-Sitzung erstellt oder ihre Anmeldeinformationen abgerufen wurden. Das Wiederholen in der gleichen Version schlägt auf die gleiche Weise fehl. Führen Sie `claude update` aus, und führen Sie dann `/remote-control` aus, um erneut zu verbinden.

503 511

504<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">512<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

505 „Ihre Organisation erfordert vertrauenswürdige Geräte für Remote Control, aber dieses Gerät ist nicht registriert"513 „Ihre Organisation erfordert Vertrauenswürdige Geräte für Remote Control, aber dieses Gerät ist nicht registriert"

506</h3>514</h3>

507 515

508Ihre Organisation hat [Vertrauenswürdige Geräte](#trusted-devices) aktiviert und dieser Computer hat sich noch nicht registriert. Führen Sie `/login` in Claude Code aus. Die Registrierung erfolgt als Teil der Anmeldung, und es gibt keinen separaten Registrierungsbefehl.516Ihre Organisation hat [Vertrauenswürdige Geräte](#trusted-devices) aktiviert und dieser Computer hat sich noch nicht registriert. Führen Sie `/login` in Claude Code aus. Die Registrierung erfolgt als Teil der Anmeldung, und es gibt keinen separaten Registrierungsbefehl.

509 517

510<h3 id="session-expired-for-trusted-device-check">518<h3 id="session-expired-for-trusted-device-check">

511 „session expired for trusted-device check"519 „Sitzung abgelaufen für Vertrauenswürdige-Geräte-Prüfung"

512</h3>520</h3>

513 521

514Ihre Anmeldung ist mehr als 18 Stunden alt. Führen Sie `/login` in Claude Code aus, oder bestätigen Sie mit Face ID, Touch ID, Windows Hello oder einem Passkey, wenn claude.ai oder die Mobile-App Sie auffordert. Siehe [Vertrauenswürdige Geräte](#trusted-devices).522Ihre Anmeldung ist älter als 18 Stunden. Führen Sie `/login` in Claude Code aus, oder bestätigen Sie mit Face ID, Touch ID, Windows Hello oder einem Passkey, wenn claude.ai oder die mobile App Sie auffordert. Siehe [Vertrauenswürdige Geräte](#trusted-devices).

~~515~~

516<h2 id="choose-the-right-approach">

517 Wählen Sie den richtigen Ansatz

518</h2>

~~519~~

520Claude Code bietet mehrere Möglichkeiten, um zu arbeiten, wenn Sie nicht an Ihrem Terminal sind. Sie unterscheiden sich darin, was die Arbeit auslöst, wo Claude ausgeführt wird und wie viel Setup Sie benötigen.

~~521~~

523| :- | :- | :- | :- | :- |

525| [Remote Control](/docs/de/remote-control) | Steuern Sie eine laufende Sitzung von [claude.ai/code](https://claude.ai/code) oder der Claude Mobile-App | Ihr Computer (CLI oder VS Code) | Führen Sie `claude remote-control` aus | Steuerung laufender Arbeiten von einem anderen Gerät |

526| [Channels](/docs/de/channels) | Pushen Sie Ereignisse aus einer Chat-App wie Telegram oder Discord oder Ihrem eigenen Server | Ihr Computer (CLI) | [Installieren Sie ein Channel-Plugin](/docs/de/channels#quickstart) oder [erstellen Sie Ihr eigenes](/docs/de/channels-reference) | Reagieren auf externe Ereignisse wie CI-Fehler oder Chat-Nachrichten |

527| [Slack](/docs/de/slack) | Erwähnen Sie `@Claude` in einem Team-Kanal | Anthropic Cloud | [Installieren Sie die Slack-App](/docs/de/slack#setting-up-claude-code-in-slack) mit [Claude Code im Web](/docs/de/claude-code-on-the-web) aktiviert | PRs und Reviews aus Team-Chat |

528| [Self-hosted environments](/docs/de/self-hosted-environments) | Starten Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) und wählen Sie die Umgebung Ihrer Organisation | Infrastruktur Ihrer Organisation | [Stellen Sie Runner bereit](/docs/de/self-hosted-environments-quickstart), in Team- und Enterprise-Plänen | Cloud-Sitzungen, die in Ihrem Netzwerk ausgeführt werden müssen |

530 523

531<h2 id="related-resources">524<h2 id="related-resources">

532 Verwandte Ressourcen525 Verwandte Ressourcen

routines.md +3 −2

Details

59Wenn der Zeitplan der Routine oder **Jetzt ausführen** eine Ausführung startet, republiziert Claude ein vorhandenes Artefakt ohne Nachfrage nur, wenn alle diese Bedingungen erfüllt sind:59Wenn der Zeitplan der Routine oder **Jetzt ausführen** eine Ausführung startet, republiziert Claude ein vorhandenes Artefakt ohne Nachfrage nur, wenn alle diese Bedingungen erfüllt sind:

60 60

61* Sie können das Artefakt bearbeiten und es gehört zu Ihrer eigenen Organisation61* Sie können das Artefakt bearbeiten und es gehört zu Ihrer eigenen Organisation

~~62* Das Artefakt wird nicht öffentlich geteilt und nicht mit bestimmten Personen oder Ihrer Organisation geteilt, wobei die neueste Version als die Version ausgewählt ist, die Betrachter sehen~~62* Das Artefakt wird nicht öffentlich geteilt

63* Wenn das Artefakt mit bestimmten Personen oder Ihrer Organisation geteilt wird, sehen die Betrachter nicht automatisch jede neue Version

63* Die Veröffentlichung enthält nur die Seite, ohne unterstützende Dateien oder etwas anderes hinzugefügt, und erzwingt keine neuere Version64* Die Veröffentlichung enthält nur die Seite, ohne unterstützende Dateien oder etwas anderes hinzugefügt, und erzwingt keine neuere Version

64* Die Seite enthält keine Berechtigung, die über die Seite hinausgeht, wie z. B. [Konnektor-Aufrufe](/docs/de/artifacts#pull-live-data-with-mcp-connectors)65* Die Seite enthält keine Berechtigung, die über die Seite hinausgeht, wie z. B. [Konnektor-Aufrufe](/docs/de/artifacts#pull-live-data-with-mcp-connectors)

65 66

151 152

152Ein Schedule-Trigger führt die Routine nach einem wiederkehrenden Zeitplan oder einmalig zu einem bestimmten zukünftigen Zeitpunkt aus. Wählen Sie eine voreingestellte Häufigkeit im Abschnitt **Trigger auswählen**: stündlich, täglich, Wochentage oder wöchentlich. Zeiten werden in Ihrer lokalen Zone eingegeben und automatisch konvertiert, sodass die Routine zu dieser Wanduhr-Zeit unabhängig davon ausgeführt wird, wo sich die Cloud-Infrastruktur befindet.153Ein Schedule-Trigger führt die Routine nach einem wiederkehrenden Zeitplan oder einmalig zu einem bestimmten zukünftigen Zeitpunkt aus. Wählen Sie eine voreingestellte Häufigkeit im Abschnitt **Trigger auswählen**: stündlich, täglich, Wochentage oder wöchentlich. Zeiten werden in Ihrer lokalen Zone eingegeben und automatisch konvertiert, sodass die Routine zu dieser Wanduhr-Zeit unabhängig davon ausgeführt wird, wo sich die Cloud-Infrastruktur befindet.

153 154

154Ausführungen können aufgrund von Staffelung einige Minuten nach der geplanten Zeit beginnen. Der Offset ist für jede Routine konsistent.155Wenn Sie eine Ausführung genau zur vollen Stunde planen, z. B. 9:00, kann sie mehrere Minuten später starten. Um nahe zur geplanten Zeit zu starten, wählen Sie ein paar Minuten nach der vollen Stunde, z. B. 9:07.

155 156

156Für ein benutzerdefiniertes Intervall wie alle zwei Stunden oder den ersten jedes Monats wählen Sie die nächste Voreinstellung im Formular aus und führen dann `/schedule update` in der CLI aus, um einen spezifischen Cron-Ausdruck festzulegen. Das Mindestintervall beträgt eine Stunde; Ausdrücke, die häufiger ausgeführt werden, werden abgelehnt.157Für ein benutzerdefiniertes Intervall wie alle zwei Stunden oder den ersten jedes Monats wählen Sie die nächste Voreinstellung im Formular aus und führen dann `/schedule update` in der CLI aus, um einen spezifischen Cron-Ausdruck festzulegen. Das Mindestintervall beträgt eine Stunde; Ausdrücke, die häufiger ausgeführt werden, werden abgelehnt.

157 158

sandbox-environments.md +1 −1

Details

117Unter Linux und WSL2 wendet die Runtime Schreibzugriffe nur auf Pfade an, die bereits vorhanden sind. Erstellen Sie in einer frischen Umgebung Claude Codes Konfigurationspfade vor dem ersten Start:117Unter Linux und WSL2 wendet die Runtime Schreibzugriffe nur auf Pfade an, die bereits vorhanden sind. Erstellen Sie in einer frischen Umgebung Claude Codes Konfigurationspfade vor dem ersten Start:

118 118

119```bash theme={null}119```bash theme={null}

120mkdir -p ~/.claude && echo '{}' > ~/.claude.json120mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }

121```121```

122 122

123Sobald die Einstellungsdatei vorhanden ist, starten Sie Claude Code mit `npx` und übergeben Sie `claude` als den zu umhüllenden Befehl:123Sobald die Einstellungsdatei vorhanden ist, starten Sie Claude Code mit `npx` und übergeben Sie `claude` als den zu umhüllenden Befehl:

sandboxing.md +5 −4

Details

42 </Step>42 </Step>

43 43

44 <Step title="Führen Sie einen Bash-Befehl aus">44 <Step title="Führen Sie einen Bash-Befehl aus">

45 Bitten Sie Claude, einen Befehl auszuführen, z. B. einen Build oder eine Test-Suite. Standardmäßig können Befehle in der Sandbox in das Arbeitsverzeichnis, das Sitzungs-Temp-Verzeichnis und alle [Verzeichnisse schreiben, die Sie hinzugefügt haben](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories`.45 Bitten Sie Claude, einen Befehl auszuführen, z. B. einen Build oder eine Test-Suite. Standardmäßig können Befehle in der Sandbox in das Arbeitsverzeichnis, ein [Temp-Verzeichnis pro Benutzer](/docs/de/env-vars) und alle [Verzeichnisse schreiben, die Sie hinzugefügt haben](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories`.

46 46

47 Wenn ein Befehl zum ersten Mal eine neue Netzwerk-Domain benötigt, fordert Claude Code zur Genehmigung auf; im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) benennt Claude stattdessen die Hosts, die ein Befehl benötigt, [im Befehl selbst](#per-command-allowed-domains-in-auto-mode) für den Klassifizierer zur Überprüfung damit.47 Wenn ein Befehl zum ersten Mal eine neue Netzwerk-Domain benötigt, fordert Claude Code zur Genehmigung auf; im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) benennt Claude stattdessen die Hosts, die ein Befehl benötigt, [im Befehl selbst](#per-command-allowed-domains-in-auto-mode) für den Klassifizierer zur Überprüfung damit.

48 48

179 Temporäre Verzeichnisse179 Temporäre Verzeichnisse

180</h4>180</h4>

181 181

182Das Sitzungs-Temp-Verzeichnis ist standardmäßig in der Sandbox beschreibbar, zusammen mit dem Arbeitsverzeichnis. Sofern Sie nicht [Dateisystem-Isolation deaktivieren](#disable-filesystem-isolation), setzt Claude Code `$TMPDIR` auf dieses Verzeichnis für Sandbox-Befehle, sodass Tools, die temporäre Dateien schreiben, ohne zusätzliche Konfiguration funktionieren.182Ein Temp-Verzeichnis pro Benutzer ist standardmäßig in der Sandbox beschreibbar, zusammen mit dem Arbeitsverzeichnis. Sofern Sie nicht [Dateisystem-Isolation deaktivieren](#disable-filesystem-isolation), setzt Claude Code `$TMPDIR` auf dieses Verzeichnis für Sandbox-Befehle, sodass Tools, die temporäre Dateien schreiben, ohne zusätzliche Konfiguration funktionieren.

183 183

184Unsandboxed-Befehle erben Ihr Shell-`$TMPDIR`, wenn es gesetzt ist, daher lösen Sandbox- und Unsandboxed-Befehle `$TMPDIR` in verschiedene Verzeichnisse auf, während Dateisystem-Isolation aktiviert ist. Wenn Ihre Shell `$TMPDIR` nicht gesetzt oder leer lässt, erhält ein Unsandboxed-Befehl, der auf `$TMPDIR` verweist, Ihre [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars)-Überschreibung oder das Temp-Verzeichnis des Betriebssystems, wenn Sie keine gesetzt haben oder die Überschreibung ein langer Pfad ist, damit die Variable nicht zu einer leeren Zeichenkette expandiert. Um temporäre Dateien zwischen den beiden zu übergeben, schreiben Sie sie stattdessen unter das Arbeitsverzeichnis.184Unsandboxed-Befehle erben Ihr Shell-`$TMPDIR`, wenn es gesetzt ist, daher lösen Sandbox- und Unsandboxed-Befehle `$TMPDIR` in verschiedene Verzeichnisse auf, während Dateisystem-Isolation aktiviert ist. Wenn Ihre Shell `$TMPDIR` nicht gesetzt oder leer lässt, erhält ein Unsandboxed-Befehl, der auf `$TMPDIR` verweist, Ihre [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars)-Überschreibung oder das Temp-Verzeichnis des Betriebssystems, wenn Sie keine gesetzt haben oder die Überschreibung ein langer Pfad ist, damit die Variable nicht zu einer leeren Zeichenkette expandiert. Um temporäre Dateien zwischen den beiden zu übergeben, schreiben Sie sie stattdessen unter das Arbeitsverzeichnis.

185 185

528 528

529Das Sandboxed-Bash-Tool beschränkt den Dateisystem-Zugriff auf spezifische Verzeichnisse:529Das Sandboxed-Bash-Tool beschränkt den Dateisystem-Zugriff auf spezifische Verzeichnisse:

530 530

531* **Standard-Schreibverhalten**: Lese- und Schreibzugriff auf das aktuelle Arbeitsverzeichnis und seine Unterverzeichnisse, alle Verzeichnisse, die Sie mit `--add-dir`, `/add-dir` oder [`permissions.additionalDirectories`](/docs/de/settings-reference#permissions-additionaldirectories) hinzugefügt haben, plus das Session-Temp-Verzeichnis, auf das `$TMPDIR` verweist531* **Standard-Schreibverhalten**: Lese- und Schreibzugriff auf das aktuelle Arbeitsverzeichnis und seine Unterverzeichnisse, alle Verzeichnisse, die Sie mit `--add-dir`, `/add-dir` oder [`permissions.additionalDirectories`](/docs/de/settings-reference#permissions-additionaldirectories) hinzugefügt haben, plus das benutzerabhängige Temp-Verzeichnis, auf das `$TMPDIR` verweist

532* **Standard-Leseverhalten**: Lesezugriff auf den gesamten Computer, außer bestimmten blockierten Verzeichnissen. Beachten Sie, dass diese Standard-Einstellung immer noch das Lesen von Anmeldedatendateien wie `~/.aws/credentials` und `~/.ssh/` ermöglicht. Verwenden Sie [`sandbox.credentials`](#protect-credentials), um Lesezugriffe auf diese Dateien zu blockieren und geheime Umgebungsvariablen zu deaktivieren, oder fügen Sie die Pfade zu `denyRead` hinzu.532* **Standard-Leseverhalten**: Lesezugriff auf den gesamten Computer, außer bestimmten blockierten Verzeichnissen. Beachten Sie, dass diese Standard-Einstellung immer noch das Lesen von Anmeldedatendateien wie `~/.aws/credentials` und `~/.ssh/` ermöglicht. Verwenden Sie [`sandbox.credentials`](#protect-credentials), um Lesezugriffe auf diese Dateien zu blockieren und geheime Umgebungsvariablen zu deaktivieren, oder fügen Sie die Pfade zu `denyRead` hinzu.

533* **Blockierter Zugriff**: Kann Dateien außerhalb des Arbeitsverzeichnisses, hinzugefügter Verzeichnisse und des Session-Temp-Verzeichnisses nicht ohne explizite Genehmigung ändern, einschließlich Shell-Konfigurationsdateien wie `~/.bashrc` und System-Binärdateien in `/bin/`533* **Blockierter Lesezugriff**: Mit [`permissions.blockReadsOutsideWorkingDirectories`](/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) aktiviert, verlieren Sandbox-Befehle auch Lesezugriff auf Ihr Home-Verzeichnis und die anderen Verzeichnisse, die Benutzerdateien enthalten, außer den Pfaden, die [Sandboxed commands under the block](/docs/de/settings-reference#sandboxed-commands-under-the-block) auflistet. Dieser Abschnitt sagt auch, wann dieser Teil des Blocks nicht gilt.

534* **Blockierter Zugriff**: Kann Dateien außerhalb des Arbeitsverzeichnisses, hinzugefügter Verzeichnisse und des benutzerabhängigen Temp-Verzeichnisses nicht ohne explizite Genehmigung ändern, einschließlich Shell-Konfigurationsdateien wie `~/.bashrc` und System-Binärdateien in `/bin/`

534* **Git Worktrees**: Wenn das Arbeitsverzeichnis ein [verknüpftes Git Worktree](/docs/de/worktrees) ist, erlaubt die Sandbox auch Schreibzugriff auf das gemeinsame `.git`-Verzeichnis des Haupt-Repositorys, damit Befehle wie `git commit` Refs und den Index aktualisieren können. Schreibzugriffe auf `hooks/` und `config` in diesem Verzeichnis bleiben blockiert.535* **Git Worktrees**: Wenn das Arbeitsverzeichnis ein [verknüpftes Git Worktree](/docs/de/worktrees) ist, erlaubt die Sandbox auch Schreibzugriff auf das gemeinsame `.git`-Verzeichnis des Haupt-Repositorys, damit Befehle wie `git commit` Refs und den Index aktualisieren können. Schreibzugriffe auf `hooks/` und `config` in diesem Verzeichnis bleiben blockiert.

535* **Konfigurierbar**: Definieren Sie benutzerdefinierte zulässige und blockierte Pfade durch Einstellungen536* **Konfigurierbar**: Definieren Sie benutzerdefinierte zulässige und blockierte Pfade durch Einstellungen

536 537

security.md +2 −1

Details

128 128

129* **Isolierte virtuelle Maschinen**: Jede Cloud-Sitzung wird in einer isolierten, von Anthropic verwalteten VM ausgeführt129* **Isolierte virtuelle Maschinen**: Jede Cloud-Sitzung wird in einer isolierten, von Anthropic verwalteten VM ausgeführt

130* **Netzwerkzugriffskontrollen**: Der Netzwerkzugriff ist standardmäßig begrenzt und kann so konfiguriert werden, dass er deaktiviert ist oder nur bestimmte Domänen zulässt130* **Netzwerkzugriffskontrollen**: Der Netzwerkzugriff ist standardmäßig begrenzt und kann so konfiguriert werden, dass er deaktiviert ist oder nur bestimmte Domänen zulässt

131* **Anmeldedatenschutz**: Die Authentifizierung wird über einen sicheren Proxy durchgeführt, der einen scoped Credential in der Sandbox verwendet, der dann in Ihr tatsächliches GitHub-Authentifizierungstoken übersetzt wird131* **Anmeldedatenschutz**: GitHub-Anmeldedaten werden verschlüsselt auf Anthropic-Servern gespeichert und gelangen niemals in die Sitzungs-VM. Die VM enthält eine kurzlebige Anmeldedaten, die auf diese Sitzung begrenzt sind, und der GitHub-Datenverkehr wird über einen [Anthropic-Proxy](/docs/de/cloud-environments#github-proxy) geleitet, der die GitHub-Anmeldedaten auf der Serverseite anfügt. Siehe [GitHub-Authentifizierungsoptionen](/docs/de/claude-code-on-the-web#github-authentication-options), um zu erfahren, wie Sie Zugriff gewähren

132* **Branch-Einschränkungen**: Git-Push-Operationen sind auf den aktuellen Arbeitsbranch beschränkt132* **Branch-Einschränkungen**: Git-Push-Operationen sind auf den aktuellen Arbeitsbranch beschränkt

133* **Audit-Protokollierung**: Alle Operationen in Cloud-Sitzungen werden zu Compliance- und Audit-Zwecken protokolliert133* **Audit-Protokollierung**: Alle Operationen in Cloud-Sitzungen werden zu Compliance- und Audit-Zwecken protokolliert

134* **Automatische Bereinigung**: Sitzungs-VMs werden nach einer Phase der Inaktivität freigegeben134* **Automatische Bereinigung**: Sitzungs-VMs werden nach einer Phase der Inaktivität freigegeben

135* **Löschung**: Sie können [eine Sitzung löschen](/docs/de/claude-code-on-the-web#delete-sessions) jederzeit. Siehe [Cloud-Ausführungsdatenfluss](/docs/de/data-usage#cloud-execution-data-flow-and-dependencies), um zu erfahren, was Anthropic für eine Cloud-Sitzung speichert

135 136

136Weitere Details zur Cloud-Ausführung finden Sie unter [Claude Code im Web](/docs/de/claude-code-on-the-web); um den Netzwerkzugriff für Cloud-Sitzungen zu konfigurieren, siehe [Cloud-Umgebungen konfigurieren](/docs/de/cloud-environments#network-access).137Weitere Details zur Cloud-Ausführung finden Sie unter [Claude Code im Web](/docs/de/claude-code-on-the-web); um den Netzwerkzugriff für Cloud-Sitzungen zu konfigurieren, siehe [Cloud-Umgebungen konfigurieren](/docs/de/cloud-environments#network-access).

137 138

self-hosted-environments-configuration.md +31 −3

Details

222| Variable | Beschreibung |222| Variable | Beschreibung |

223| :- | :- |223| :- | :- |

224| `CLAUDE_RUNNER_WORK_ORDER_FILE` | Pfad zu einer Temp-Datei, die das signierte Arbeitsorder-JWT enthält, das der neue Runner registriert. Gelöscht nach dem Hook-Exit. Protokollieren Sie nicht den Inhalt der Datei. |224| `CLAUDE_RUNNER_WORK_ORDER_FILE` | Pfad zu einer Temp-Datei, die das signierte Arbeitsorder-JWT enthält, das der neue Runner registriert. Gelöscht nach dem Hook-Exit. Protokollieren Sie nicht den Inhalt der Datei. |

225| `CLAUDE_RUNNER_ORDER_ID` | Undurchsichtiger Idempotenz-Schlüssel, eindeutig pro Spawn-Anfrage und sicher für Kubernetes-Ressourcennamen. Verwenden Sie ihn als Dedup-Schlüssel Ihres Provisioners. |225| `CLAUDE_RUNNER_ORDER_ID` | Undurchsichtiger Idempotenz-Schlüssel, eindeutig pro Spawn-Anfrage und sicher für Kubernetes-Ressourcennamen. Verwenden Sie nur die Order-ID als Dedup-Schlüssel Ihres Provisioners. |

226| `CLAUDE_RUNNER_SESSION_ID` | Die Sitzung, für die diese Anfrage bestimmt ist. Leer für Pre-Warming-Anfragen, die einen Standby-Runner im Voraus starten, bevor eine bestimmte Sitzung, wenn [`--min-idle`](/docs/de/self-hosted-environments-reference#orchestrator-cli-flags) gesetzt ist, daher nehmen Sie nicht an, dass die Variable gesetzt ist. |226| `CLAUDE_RUNNER_SESSION_ID` | Die Sitzung, für die diese Anfrage bestimmt ist. Sie wiederholt sich bei jeder Neuanfrage für die Sitzung, daher verwenden Sie sie für Protokollierung und Routing, nicht als Dedup-Schlüssel. Leer für Pre-Warming-Anfragen, die einen Standby-Runner im Voraus starten, bevor eine bestimmte Sitzung, wenn [`--min-idle`](/docs/de/self-hosted-environments-reference#orchestrator-cli-flags) gesetzt ist, daher nehmen Sie nicht an, dass die Variable gesetzt ist. |

229| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | Server-Zeit aus dem HTTP-`Date`-Header der Poll-Antwort. Wenn der Hook das Arbeitsorder-JWT `exp` überprüft, vergleichen Sie gegen diesen Wert anstelle der lokalen Uhr, um Skew zu tolerieren. Leer, wenn das Gateway den Header weggelassen hat. |229| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | Server-Zeit aus dem HTTP-`Date`-Header der Poll-Antwort. Wenn der Hook das Arbeitsorder-JWT `exp` überprüft, vergleichen Sie gegen diesen Wert anstelle der lokalen Uhr, um Skew zu tolerieren. Leer, wenn das Gateway den Header weggelassen hat. |

245 245

246Der Vertrag hat vier Provisioner-agnostische Regeln:246Der Vertrag hat vier Provisioner-agnostische Regeln:

247 247

2481. **Seien Sie idempotent auf `CLAUDE_RUNNER_ORDER_ID`.** Neulieferung derselben Anfrage muss höchstens einen Runner spawnen. Leiten Sie einen deterministischen Ressourcennamen von der ID ab und lassen Sie Ihre Plattform das Duplikat ablehnen.2481. **Seien Sie idempotent auf `CLAUDE_RUNNER_ORDER_ID`.** Neulieferung derselben Anfrage muss höchstens einen Runner spawnen. Leiten Sie einen deterministischen Ressourcennamen von der Order-ID ab und lassen Sie Ihre Plattform das Duplikat ablehnen. Keying Sie nicht auf `CLAUDE_RUNNER_SESSION_ID` stattdessen. Jede Neuanfrage für eine Sitzung trägt dieselbe Sitzungs-ID mit einer neuen Order-ID, daher wird eine Workload, die nach der Sitzungs-ID benannt oder dedupliziert ist, einmal erstellt und nie wieder für diese Sitzung.

2492. **Versuchen Sie nicht, die Workload erneut zu versuchen.** Eine Order-ID bedeutet höchstens eine erstellte Workload. Wenn sich der Runner nie registriert, fordert Anthropic nach `--expected-spawn-seconds` mit einer frischen Order-ID erneut an.2492. **Versuchen Sie nicht, die Workload erneut zu versuchen.** Eine Order-ID bedeutet höchstens eine erstellte Workload. Wenn sich der Runner nie registriert, fordert Anthropic nach `--expected-spawn-seconds` mit einer frischen Order-ID erneut an.

2503. **Verwenden Sie den Exit-Code-Vertrag.** Exit 0 bedeutet eingereicht. Exit 1 bedeutet wiederholbarer Fehler; die Sitzung sichert sich ab und wird erneut angeboten. Exit 2 oder höher bedeutet nicht wiederholbar; die Sitzung wird blockiert, bis ein [Owner](/docs/de/cloud-environments#organization-shared-environments) auf der Registerkarte **Aktivität** der Umgebung **Erneut versuchen** auswählt. Bei Nicht-Null-Exit erscheint das Ende des Stderr des Hooks dort als Fehlergrund, daher schreiben Sie den umsetzbaren Fehler auf stderr und niemals Geheimnisse. Für eine Pre-Warming-Anfrage gibt es keine Sitzung zum Fehlschlag: Der Orchestrator protokolliert einen Nicht-Null-Exit lokal nur, und der Server fordert den Spawn nach dem Lease erneut an.2503. **Verwenden Sie den Exit-Code-Vertrag.** Exit 0 bedeutet eingereicht. Exit 1 bedeutet wiederholbarer Fehler; die Sitzung sichert sich ab und wird erneut angeboten. Exit 2 oder höher bedeutet nicht wiederholbar; die Sitzung wird blockiert, bis ein [Owner](/docs/de/cloud-environments#organization-shared-environments) auf der Registerkarte **Aktivität** der Umgebung **Erneut versuchen** auswählt. Bei Nicht-Null-Exit erscheint das Ende des Stderr des Hooks dort als Fehlergrund, daher schreiben Sie den umsetzbaren Fehler auf stderr und niemals Geheimnisse. Für eine Pre-Warming-Anfrage gibt es keine Sitzung zum Fehlschlag: Der Orchestrator protokolliert einen Nicht-Null-Exit lokal nur, und der Server fordert den Spawn nach dem Lease erneut an.

2514. **Setzen Sie `--expected-spawn-seconds` auf mindestens Ihre p99-Boot-Zeit.** Dies ist das serverseitige Lease. Alle Orchestrator-Replikas müssen denselben Wert verwenden.2514. **Setzen Sie `--expected-spawn-seconds` auf mindestens Ihre p99-Boot-Zeit.** Dies ist das serverseitige Lease. Alle Orchestrator-Replikas müssen denselben Wert verwenden.

252 252

253Alles, was der Hook auf stdout oder stderr schreibt, erscheint im Protokoll des Orchestrators mit automatisch redigierten Anmeldedaten. Wenn Sitzungen in der Warteschlange bleiben, überprüfen Sie den `/healthz`-Body des Orchestrators auf Warteschlangen-Zählungen, öffnen Sie dann die Registerkarte **Aktivität** Ihrer Umgebung auf der [**Cloud-Umgebungen**-Administratorseite](https://claude.ai/admin-settings/cloud-environments): Erweitern Sie eine fehlgeschlagene Sitzung dort für ihren Spawn-Fehler und wählen Sie **Erneut versuchen**, um sie erneut anzufordern.253Alles, was der Hook auf stdout oder stderr schreibt, erscheint im Protokoll des Orchestrators mit automatisch redigierten Anmeldedaten. Wenn Sitzungen in der Warteschlange bleiben, überprüfen Sie den `/healthz`-Body des Orchestrators auf Warteschlangen-Zählungen, öffnen Sie dann die Registerkarte **Aktivität** Ihrer Umgebung auf der [**Cloud-Umgebungen**-Administratorseite](https://claude.ai/admin-settings/cloud-environments): Erweitern Sie eine fehlgeschlagene Sitzung dort für ihren Spawn-Fehler und wählen Sie **Erneut versuchen**, um sie erneut anzufordern.

254 254

255Eine Sitzung, die in der Warteschlange bleibt, ohne dass ein Spawn-Fehler auf der Registerkarte **Aktivität** vorhanden ist, kann bedeuten, dass der Hook nach der Sitzungs-ID keyed ist. Um dies zu bestätigen, überprüfen Sie, ob Ihre Plattform eine Workload für die erste Spawn-Anfrage dieser Sitzung hat und keine für die Neuanfragen. Wenn ja, keying Sie die Workload auf `CLAUDE_RUNNER_ORDER_ID` stattdessen.

256

255<h2 id="mcp-servers">257<h2 id="mcp-servers">

256 MCP-Server258 MCP-Server

257</h2>259</h2>

277 279

278Sitzungen erben die Umgebung des Runners, daher setzen Sie [`ENABLE_TOOL_SEARCH`](/docs/de/mcp#scale-with-mcp-tool-search) dort, um die MCP-Tool-Suche für jede Sitzung zu steuern, die ein Runner spawnt; die MCP-Seite behandelt die Werte.280Sitzungen erben die Umgebung des Runners, daher setzen Sie [`ENABLE_TOOL_SEARCH`](/docs/de/mcp#scale-with-mcp-tool-search) dort, um die MCP-Tool-Suche für jede Sitzung zu steuern, die ein Runner spawnt; die MCP-Seite behandelt die Werte.

279 281

282<h3 id="turn-off-built-in-session-tools">

283 Integrierte Sitzungs-Tools ausschalten

284</h3>

285

286Anthropics Kontrolleben fügt seinen eigenen MCP-Server, benannt Claude Code Remote, an Cloud-Sitzungen an. Claude verwendet die Tools des Servers, um [Routinen](/docs/de/routines) zu planen, andere Cloud-Sitzungen zu starten und zu steuern, weitere Repositories anzuhängen und Pull-Request-Aktivitäten zu verfolgen.

287

288Um den ganzen Server auszuschalten, fügen Sie eine [Server-Level-Deny-Regel](/docs/de/permissions#mcp) zu Ihren Einstellungen hinzu. Die Kontrolleben registriert den Server unter einem von drei Namen, je nachdem, wie die Sitzung erstellt wurde. Claude Code stimmt den Namen in einer Regel genau ab, einschließlich Groß-/Kleinschreibung, daher schreiben Sie die Regel einmal pro Name wie gezeigt:

289

290```json theme={null}

291{

292 "permissions": {

293 "deny": [

294 "mcp__Claude_Code_Remote",

295 "mcp__claude-code-remote",

296 "mcp__bf7c680d-5fdc-5ef4-b4a0-abadb619bf0a"

297 ]

298 }

299}

300```

301

302Eine Regel, die den ganzen Server benennt, deckt auch Tools ab, die der Server später erhält. Um ein Tool auszuschalten und den Rest zu behalten, hängen Sie zwei weitere Unterstriche und den Tool-Namen an jede Regel an, wie in `mcp__Claude_Code_Remote__add_repo`. Um den Server daran zu hindern, sich überhaupt zu verbinden, anstatt seine Tools zu entfernen, fügen Sie die drei Namen ohne das Präfix `mcp__` stattdessen als `serverName`-Einträge unter [`deniedMcpServers`](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists) hinzu.

303

304Legen Sie die Regeln in [Server-verwalteten Einstellungen](/docs/de/server-managed-settings) ab, um jede Sitzung ohne Änderung am Runner zu erreichen, oder in `~/.claude/settings.json` auf dem Runner. [Berechtigungen und Tool-Genehmigung](#permissions-and-tool-approval) erklärt, wie Einstellungen auf dem Runner Sitzungen erreichen.

305

306Um zu bestätigen, dass die Regeln wirksam wurden, starten Sie eine Sitzung in der Umgebung und bitten Sie Claude, seine MCP-Tools aufzulisten. Claude Code entfernt ein verweigerte Tool aus Claudes Kontext, daher sind die verweigerten Tools in seiner Antwort abwesend.

307

280<h2 id="prompt-sessions-to-push-their-work">308<h2 id="prompt-sessions-to-push-their-work">

281 Fordern Sie Sitzungen auf, ihre Arbeit zu pushen309 Fordern Sie Sitzungen auf, ihre Arbeit zu pushen

282</h2>310</h2>

self-hosted-environments-deploy.md +6 −2

Details

220ENTRYPOINT ["claude"]220ENTRYPOINT ["claude"]

221```221```

222 222

223Tauschen Sie `linux-x64` gegen `linux-arm64` aus, wenn Ihre Knoten ARM sind, oder gegen `linux-x64-musl` oder `linux-arm64-musl` auf einem musl-basierten Image wie Alpine; siehe [Alpine Linux-Setup](/docs/de/setup#alpine-linux-and-musl-based-distributions) für die zusätzlichen Pakete, die musl-Images benötigen. Die URL ist der Standard-Claude-Code-Release-Ort, daher können Sie die heruntergeladene Binärdatei gegen das signierte Manifest des Release überprüfen, wie in [Binäre Integrität und Code-Signierung](/docs/de/setup#binary-integrity-and-code-signing) beschrieben. Erstellen Sie das Image mit Claude Code Version 2.1.224 oder später, pushen Sie es dann in Ihre Registry und referenzieren Sie es in den Rezepten unten:223Tauschen Sie `linux-x64` gegen `linux-arm64` aus, wenn Ihre Knoten ARM sind, oder gegen `linux-x64-musl` oder `linux-arm64-musl` auf einem musl-basierten Image wie Alpine; siehe [Alpine Linux-Setup](/docs/de/setup#alpine-linux-and-musl-based-distributions) für die zusätzlichen Pakete, die musl-Images benötigen. Die URL ist der Standard-Claude-Code-Release-Ort, daher können Sie die heruntergeladene Binärdatei gegen das signierte Manifest des Release überprüfen, wie in [Binäre Integrität und Code-Signierung](/docs/de/setup#binary-integrity-and-code-signing) beschrieben. Der Runner erfordert Claude Code Version 2.1.224 oder später. Erstellen Sie das Image, pushen Sie es dann in Ihre Registry und referenzieren Sie es in den Rezepten unten:

224 224

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .226docker build \

227 --build-arg CLAUDE_CODE_VERSION="$(curl -fsSL https://downloads.claude.ai/claude-code-releases/stable)" \

228 -t <your-registry>/claude-runner:latest .

227```229```

228 230

231Die Befehlsersetzung schlägt die aktuelle `stable`-Release-Nummer nach und übergibt sie als Build-Argument, daher wird das Image nach einer neuen stabilen Release durch Ausführung desselben Befehls mit der neueren Binärdatei neu erstellt. Um eine bestimmte Release für reproduzierbare Builds zu fixieren, übergeben Sie die Versionsnummer direkt als `CLAUDE_CODE_VERSION`. Ersetzen Sie `stable` durch `latest` in der Nachschlag-URL, wenn Sie eine Release benötigen, die neuer als der stabile Kanal ist, z. B. eine, die [ein neu gestartetes Modell erfordert](/docs/de/model-config).

232

229<h2 id="size-cpu-and-memory-for-sessions">233<h2 id="size-cpu-and-memory-for-sessions">

230 Dimensionieren Sie CPU und Speicher für Sitzungen234 Dimensionieren Sie CPU und Speicher für Sitzungen

231</h2>235</h2>

server-managed-settings.md +11 −2

Details

220 220

221Die serververwaltete Bereitstellung fügt diese Verhaltensweisen hinzu:221Die serververwaltete Bereitstellung fügt diese Verhaltensweisen hinzu:

222 222

223* Der Cache unter `~/.claude/remote-settings.json` speichert die gerettete Payload mit entfernten ungültigen Einträgen, abgesehen von ungültigen `cleanupPeriodDays` und `desktopSessionCleanupPeriodDays` Werten, die in der zwischengespeicherten Kopie bleiben und niemals angewendet werden.223* Ein Start, der auf dem Cache unter `~/.claude/remote-settings.json` läuft, behandelt ungültige Einträge so, wie der Abruf, der den Cache geschrieben hat:

224* Wenn kein Feld in der Payload gerettet werden kann und die Payload nicht nur diese Aufbewahrungsschlüssel ist, lehnt Claude Code die Payload ab, behält die zuletzt akzeptierten zwischengespeicherten Einstellungen bei und schreibt `Remote settings: Settings validation failed - no fields could be salvaged` in das Debug-Protokoll. Mit `forceRemoteSettingsRefresh` gesetzt, wird die CLI stattdessen beendet.224 * Einträge, die die Validierung nicht bestanden haben, bleiben entfernt.

225 * [Schlüssel, die fehlgeschlossen sind](/docs/de/managed-settings#keys-that-fail-closed), behalten ihre strengeren Werte.

226 * Ein ungültiger `cleanupPeriodDays` oder `desktopSessionCleanupPeriodDays` Wert bleibt in der zwischengespeicherten Kopie und wird niemals angewendet.

227* Claude Code wendet nichts aus einer Payload an und lässt den Cache unverändert, wenn alle drei dieser Bedingungen erfüllt sind:

228

229 * Jede Einstellung in der Payload schlägt die Validierung fehl.

230 * Keine von ihnen fällt auf einen strengeren Wert zurück.

231 * Die Payload enthält einen Schlüssel außer diesen beiden Aufbewahrungsschlüsseln.

232

233 Die Startup-Benachrichtigung, `/status` und `claude doctor` melden dann den [fehlgeschlagenen Ladevorgang](/docs/de/errors#remote-managed-settings-failed-to-load) mit der Ursache `no setting in the server response could be applied as written`, und dieser Eintrag sagt, welche Richtlinie die Sitzung ausführt. Clients, die [Fail-Closed-Start erzwingen](#enforce-fail-closed-startup), werden stattdessen beim Start beendet.

225* Der [Sicherheitsgenehmigungsdialog](#security-approval-dialogs) bewertet die gerettete Payload, daher wird ein entfernter ungültiger Eintrag niemals zur Genehmigung präsentiert und niemals ausgeführt.234* Der [Sicherheitsgenehmigungsdialog](#security-approval-dialogs) bewertet die gerettete Payload, daher wird ein entfernter ungültiger Eintrag niemals zur Genehmigung präsentiert und niemals ausgeführt.

226 235

227Um Bereitstellungsprobleme zu debuggen, führen Sie `claude --debug-file <path>` aus und suchen Sie im Protokoll nach `Remote settings`. Validieren Sie eine Payload-Änderung mit `claude doctor` auf einem Test-Computer, bevor Sie sie in der Organisation bereitstellen.236Um Bereitstellungsprobleme zu debuggen, führen Sie `claude --debug-file <path>` aus und suchen Sie im Protokoll nach `Remote settings`. Validieren Sie eine Payload-Änderung mit `claude doctor` auf einem Test-Computer, bevor Sie sie in der Organisation bereitstellen.

sessions.md +12 −5

Details

8 8

9Eine Sitzung ist ein gespeichertes Gespräch, das an ein Projektverzeichnis gebunden ist. Claude Code speichert es lokal während Sie arbeiten, sodass Sie dort weitermachen können, wo Sie aufgehört haben, zu einem anderen Ansatz verzweigen oder zwischen Aufgaben wechseln können.9Eine Sitzung ist ein gespeichertes Gespräch, das an ein Projektverzeichnis gebunden ist. Claude Code speichert es lokal während Sie arbeiten, sodass Sie dort weitermachen können, wo Sie aufgehört haben, zu einem anderen Ansatz verzweigen oder zwischen Aufgaben wechseln können.

10 10

11Die [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions), [Claude Code im Web](/docs/de/claude-code-on-the-web) und die [VS Code-Erweiterung](/docs/de/vs-code#resume-past-conversations) verwalten jeweils ihre eigene Sitzungsverlauf. Diese Seite behandelt die CLI.11Die [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions), [claude.ai/code](/docs/de/claude-code-on-the-web) und die [VS Code-Erweiterung](/docs/de/vs-code#resume-past-conversations) verwalten jeweils ihre eigene Sitzungsliste, und die Desktop-App kann auch [eine CLI-Sitzung fortsetzen](/docs/de/desktop#coming-from-the-cli). Diese Seite behandelt die CLI.

12 12

13<h2 id="resume-a-session">13<h2 id="resume-a-session">

14 Sitzung fortsetzen14 Sitzung fortsetzen

43* Berechtigungsmodus: Wenn Sie aus einem Terminal mit `claude --continue`, `claude --resume <session-id>` oder `claude --resume <name>` fortsetzen, wenn der Name einer Sitzung entspricht, ohne `-p`, stellt Claude Code den Berechtigungsmodus wieder her, in dem sich die Sitzung befand, außer in den Fällen in [Berechtigungsmodus beim Fortsetzen](#permission-mode-on-resume), die auch die Sitzungsauswahl, `/resume` und das Fortsetzen mit `claude -p` abdecken. Übergeben Sie `--permission-mode` oder `--dangerously-skip-permissions`, um den wiederhergestellten Modus zu überschreiben.43* Berechtigungsmodus: Wenn Sie aus einem Terminal mit `claude --continue`, `claude --resume <session-id>` oder `claude --resume <name>` fortsetzen, wenn der Name einer Sitzung entspricht, ohne `-p`, stellt Claude Code den Berechtigungsmodus wieder her, in dem sich die Sitzung befand, außer in den Fällen in [Berechtigungsmodus beim Fortsetzen](#permission-mode-on-resume), die auch die Sitzungsauswahl, `/resume` und das Fortsetzen mit `claude -p` abdecken. Übergeben Sie `--permission-mode` oder `--dangerously-skip-permissions`, um den wiederhergestellten Modus zu überschreiben.

44* Aktives Ziel: Ein [Ziel](/docs/de/goal#resume-with-an-active-goal), das noch aktiv war, als die Sitzung endete, wird übertragen; seine Rundenzahl, sein Timer und seine Token-Ausgaben-Baseline werden zurückgesetzt.44* Aktives Ziel: Ein [Ziel](/docs/de/goal#resume-with-an-active-goal), das noch aktiv war, als die Sitzung endete, wird übertragen; seine Rundenzahl, sein Timer und seine Token-Ausgaben-Baseline werden zurückgesetzt.

45* Geplante Aufgaben: [Aufgaben, die nicht abgelaufen sind](/docs/de/scheduled-tasks#limitations), werden wiederhergestellt. Hintergrund-Bash- und Monitor-Aufgaben nicht.45* Geplante Aufgaben: [Aufgaben, die nicht abgelaufen sind](/docs/de/scheduled-tasks#limitations), werden wiederhergestellt. Hintergrund-Bash- und Monitor-Aufgaben nicht.

46* Hintergrundarbeit: Ein [Hintergrund-Subagent](/docs/de/sub-agents#run-subagents-in-foreground-or-background), ein Hintergrund-Bash-Befehl oder ein [Workflow](/docs/de/workflows), der mit dem vorherigen Prozess endete, wird im fortgesetzten Transkript als Notiz angezeigt, dass er nicht beendet wurde. Claude Code startet keine Runde aus diesen Notizen; Claude liest sie mit Ihrer nächsten Eingabeaufforderung.

46 47

47Nicht jedes Konfigurationsflag aus dem ursprünglichen Start wird wiederhergestellt. Wenn die Sitzung von `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` oder mit `--add-dir` hinzugefügten Verzeichnissen abhängig war, übergeben Sie diese erneut, wenn Sie fortsetzen; mit `/add-dir` während der Sitzung hinzugefügte Verzeichnisse werden ebenfalls nicht wiederhergestellt, obwohl die Sitzungsauswahl sie weiterhin verwendet, um die Sitzung zu lokalisieren. Die Standard-Einstellungsdateien wie `settings.json` und `settings.local.json` werden beim Start erneut gelesen, sodass Konfigurationen, die sich darin befinden, nicht erneut übergeben werden müssen. Für `--system-prompt` und `--append-system-prompt` siehe [Systemaufforderungs-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations).48Nicht jedes Konfigurationsflag aus dem ursprünglichen Start wird wiederhergestellt. Wenn die Sitzung von `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` oder mit `--add-dir` hinzugefügten Verzeichnissen abhängig war, übergeben Sie diese erneut, wenn Sie fortsetzen; mit `/add-dir` während der Sitzung hinzugefügte Verzeichnisse werden ebenfalls nicht wiederhergestellt, obwohl die Sitzungsauswahl sie weiterhin verwendet, um die Sitzung zu lokalisieren. Die Standard-Einstellungsdateien wie `settings.json` und `settings.local.json` werden beim Start erneut gelesen, sodass Konfigurationen, die sich darin befinden, nicht erneut übergeben werden müssen. Für `--system-prompt` und `--append-system-prompt` siehe [Systemaufforderungs-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations).

48 49

74 Plan-Modus mit `-p` fortsetzen75 Plan-Modus mit `-p` fortsetzen

75</h5>76</h5>

76 77

~~77Ein `claude -p --resume`- oder `claude -p --continue`-Lauf wird nur im Plan-Modus fortgesetzt, wenn alle vier Bedingungen erfüllt sind:~~78Ein `claude -p --resume`- oder `claude -p --continue`-Lauf wird nur im Plan-Modus fortgesetzt, wenn alle diese Bedingungen erfüllt sind:

78 79

~~79* Sie übergeben [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags), damit Claude Code den Plan zur Genehmigung präsentieren kann~~80* Sie übergeben [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) und übergeben nicht [`--permission-prompts none`](/docs/de/headless#turn-off-permission-prompts-in-unattended-runs), damit Claude Code den Plan zur Genehmigung präsentieren kann

80* Sie übergeben nicht `--permission-mode` oder `--dangerously-skip-permissions`81* Sie übergeben nicht `--permission-mode` oder `--dangerously-skip-permissions`

81* Sie übergeben nicht `--fork-session`82* Sie übergeben nicht `--fork-session`

82* Der Lauf wird nicht über [Kanäle](/docs/de/channels) gestartet83* Der Lauf wird nicht über [Kanäle](/docs/de/channels) gestartet

134| Von claude.ai oder der Claude-App | Benennen Sie eine [Remote-Control-Sitzung](/docs/de/remote-control#connect-from-another-device) um; Claude Code wendet denselben Namen in der CLI an. Erfordert Claude Code v2.1.221 oder später |135| Von claude.ai oder der Claude-App | Benennen Sie eine [Remote-Control-Sitzung](/docs/de/remote-control#connect-from-another-device) um; Claude Code wendet denselben Namen in der CLI an. Erfordert Claude Code v2.1.221 oder später |

135| Von der Desktop-App | Benennen Sie eine Sitzung in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) um |136| Von der Desktop-App | Benennen Sie eine Sitzung in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) um |

136 137

137Sobald Sie eine Sitzung über eine CLI-Route oder von claude.ai aus benannt haben, kehren Sie mit `claude --resume <name>` oder `/resume <name>` zu ihr zurück; eine Desktop-App-Sitzung wird in der App fortgesetzt, die ihre eigene Sitzungshistorie führt. Siehe [Sitzung fortsetzen](#resume-a-session), um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.138Sobald Sie eine Sitzung über eine CLI-Route oder von claude.ai aus benannt haben, kehren Sie mit `claude --resume <name>` oder `/resume <name>` zu ihr zurück; eine Desktop-App-Sitzung wird in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) fortgesetzt. Siehe [Sitzung fortsetzen](#resume-a-session), um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.

138 139

139Wenn Sie eine interaktive Sitzung mit einem Namen starten oder fortsetzen, den bereits eine andere aktive Sitzung auf diesem Computer verwendet, oder eine Sitzung in einen solchen Namen umbenennen, behält Claude Code den Namen bei der Sitzung, die ihn bereits hat, benennt Ihre Sitzung in eine Variante mit einem zweistelligen Suffix um, z. B. `auth-refactor-graceful-unicorn`, und teilt Ihnen dies mit. Führen Sie `/rename` mit einem neuen Namen aus, wenn Sie lieber selbst einen auswählen möchten. Vor v2.1.232 behielten beide Sitzungen den Namen.140Wenn Sie eine interaktive Sitzung mit einem Namen starten oder fortsetzen, den bereits eine andere aktive Sitzung auf diesem Computer verwendet, oder eine Sitzung in einen solchen Namen umbenennen, behält Claude Code den Namen bei der Sitzung, die ihn bereits hat, benennt Ihre Sitzung in eine Variante mit einem zweistelligen Suffix um, z. B. `auth-refactor-graceful-unicorn`, und teilt Ihnen dies mit. Führen Sie `/rename` mit einem neuen Namen aus, wenn Sie lieber selbst einen auswählen möchten. Vor v2.1.232 behielten beide Sitzungen den Namen.

140 141

147Sitzungen, die Sie nicht benennen, erhalten immer noch zwei Bezeichnungen, die Claude Code zuweist. Nur der generierte Titel funktioniert als Resume-Handle:148Sitzungen, die Sie nicht benennen, erhalten immer noch zwei Bezeichnungen, die Claude Code zuweist. Nur der generierte Titel funktioniert als Resume-Handle:

148 149

149* Standard-Anzeigename: Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start einen Standard-Anzeigenamen. Erfordert Claude Code v2.1.196 oder später. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise `my-app-3f`, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. [Agent-Ansicht](/docs/de/agent-view) und `claude agents --json` Ausgabe. Der Standard ist kein Resume-Handle. Wenn Sie ihn an `claude --resume` oder `/resume` übergeben, findet Claude Code die Sitzung nicht. Das Benennen der Sitzung ersetzt den Standard in diesen Auflistungen, ebenso wie das Akzeptieren eines Plans.150* Standard-Anzeigename: Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start einen Standard-Anzeigenamen. Erfordert Claude Code v2.1.196 oder später. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise `my-app-3f`, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. [Agent-Ansicht](/docs/de/agent-view) und `claude agents --json` Ausgabe. Der Standard ist kein Resume-Handle. Wenn Sie ihn an `claude --resume` oder `/resume` übergeben, findet Claude Code die Sitzung nicht. Das Benennen der Sitzung ersetzt den Standard in diesen Auflistungen, ebenso wie das Akzeptieren eines Plans.

150* Generierter Titel: Wenn Sie eine Sitzung nicht benennen, generiert Claude Code einen Sitzungstitel für sie. Der Titel ist eine kurze Zusammenfassung Ihres ersten Prompts, geschrieben durch eine Hintergrundanfrage an das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Eine `claude -p`-Ausführung, die Sie direkt von einer Shell oder einem Skript aus starten, erhält keinen. Das Akzeptieren eines Plans ersetzt den generierten Titel durch einen Titel basierend auf dem Plan. Das Benennen der Sitzung ersetzt ihn ebenfalls. Sie sehen den Titel des ersten Prompts in der [Sitzungsauswahl](#use-the-session-picker) und im Statusline-Feld [`session_name`](/docs/de/statusline), wenn kein Name festgelegt ist. Der Plan-Titel wird an denselben zwei Stellen angezeigt und auch in den Auflistungen laufender Sitzungen, wo er den Platz des Standard-Anzeigenamens einnimmt. Sie können jeden Titel an `claude --resume` oder `/resume` übergeben, und Claude Code löst ihn auf dieselbe Weise auf wie einen Namen, den Sie festgelegt haben.151* Generierter Titel: Wenn Sie eine Sitzung nicht benennen, generiert Claude Code einen Sitzungstitel für sie. Der Titel ist eine kurze Zusammenfassung Ihres ersten Prompts, geschrieben durch eine Hintergrundanfrage an das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Eine `claude -p`-Ausführung, die Sie direkt von einer Shell oder einem Skript aus starten, erhält keinen.

152

153 Das Akzeptieren eines Plans ersetzt den generierten Titel durch einen Titel basierend auf dem Plan. Das Benennen der Sitzung ersetzt ihn ebenfalls.

154

155 Sie sehen den Titel des ersten Prompts in der [Sitzungsauswahl](#use-the-session-picker) und im Statusline-Feld [`session_name`](/docs/de/statusline), wenn kein Name festgelegt ist. Der Plan-Titel wird an denselben zwei Stellen angezeigt und auch in den Auflistungen laufender Sitzungen, wo er den Platz des Standard-Anzeigenamens einnimmt.

156

157 Sie können jeden Titel an `claude --resume` oder `/resume` übergeben, und Claude Code löst ihn auf dieselbe Weise auf wie einen Namen, den Sie festgelegt haben.

151 158

152<h2 id="use-the-session-picker">159<h2 id="use-the-session-picker">

153 Verwenden Sie die Sitzungsauswahl160 Verwenden Sie die Sitzungsauswahl

settings.md +1 −1

Details

809 809

810* **Gemeinsame Projekt-Einstellungen** (`.claude/settings.json`): werden in einer Sitzung mit einem Repository gelesen, da die Datei Teil des Klons ist und die Sitzung darin startet. Committen Sie eine Einstellung dort, um sie in diesen Sitzungen anzuwenden. Eine Sitzung mit mehreren Repositorys startet über den Klonen und liest aus jeder `.claude/settings.json` des Repositorys nur die Schlüssel `enabledPlugins` und `extraKnownMarketplaces`, nicht Berechtigungsregeln, Hooks, `env` oder andere Schlüssel. Die Marktplätze und Plugins, die diese beiden Schlüssel deklarieren, [werden immer noch nicht in einer Cloud-Sitzung geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).810* **Gemeinsame Projekt-Einstellungen** (`.claude/settings.json`): werden in einer Sitzung mit einem Repository gelesen, da die Datei Teil des Klons ist und die Sitzung darin startet. Committen Sie eine Einstellung dort, um sie in diesen Sitzungen anzuwenden. Eine Sitzung mit mehreren Repositorys startet über den Klonen und liest aus jeder `.claude/settings.json` des Repositorys nur die Schlüssel `enabledPlugins` und `extraKnownMarketplaces`, nicht Berechtigungsregeln, Hooks, `env` oder andere Schlüssel. Die Marktplätze und Plugins, die diese beiden Schlüssel deklarieren, [werden immer noch nicht in einer Cloud-Sitzung geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).

811* **Benutzer- und Projekt-lokale Einstellungen** (`~/.claude/settings.json` und `.claude/settings.local.json`): nicht gelesen. Beide bleiben auf Ihrer Maschine, und die lokale Datei ist nicht im Klon.811* **Benutzer- und Projekt-lokale Einstellungen** (`~/.claude/settings.json` und `.claude/settings.local.json`): nicht gelesen. Beide bleiben auf Ihrer Maschine, und die lokale Datei ist nicht im Klon.

812* **Verwaltete Einstellungen**: nur [serververwaltete Einstellungen](/docs/de/server-managed-settings) erreichen eine Cloud-Sitzung; eine `managed-settings.json` Datei oder MDM-Profil auf Ihrem Gerät nicht. Eine [selbstgehostete Umgebung](/docs/de/self-hosted-environments) liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image. [Wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) sagt, wann diese Datei angewendet wird.812* **Verwaltete Einstellungen**: eine `managed-settings.json` Datei oder MDM-Profil auf Ihrem Gerät erreicht eine Cloud-Sitzung nicht. Die [serververwalteten Einstellungen](/docs/de/server-managed-settings) Ihrer Organisation erreichen sie; [Oberflächenabdeckung](/docs/de/model-config#surface-coverage) listet auf, welche Cloud-Sitzungen sie erhalten. Eine [selbstgehostete Umgebung](/docs/de/self-hosted-environments) liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image. [Wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources) sagt, wann diese Datei angewendet wird.

813* **`/config`**: im Browser unter claude.ai/code öffnet die Claude Code-Sektion Ihrer claude.ai-Einstellungen statt einen Wert zu ändern. Um eine Einstellung für eine Cloud-Sitzung zu ändern, setzen Sie eine [Umgebungsvariable](/docs/de/cloud-environments#set-environment-variables) auf der Umgebung, oder committen Sie in einer Sitzung mit einem Repository den Schlüssel zu der `.claude/settings.json` dieses Repositorys.813* **`/config`**: im Browser unter claude.ai/code öffnet die Claude Code-Sektion Ihrer claude.ai-Einstellungen statt einen Wert zu ändern. Um eine Einstellung für eine Cloud-Sitzung zu ändern, setzen Sie eine [Umgebungsvariable](/docs/de/cloud-environments#set-environment-variables) auf der Umgebung, oder committen Sie in einer Sitzung mit einem Repository den Schlüssel zu der `.claude/settings.json` dieses Repositorys.

814 814

815[Was von Ihrem Setup überträgt](/docs/de/cloud-environments#what-carries-over-from-your-setup) listet den Rest auf: `CLAUDE.md`, Skills, MCP-Server, Plugins und Anmeldedaten.815[Was von Ihrem Setup überträgt](/docs/de/cloud-environments#what-carries-over-from-your-setup) listet den Rest auf: `CLAUDE.md`, Skills, MCP-Server, Plugins und Anmeldedaten.

settings-reference.md +21 −2

Details

693| [`managedMcpServers`](#managedmcpservers) | Stellen Sie Remote-[MCP-Server](/docs/de/managed-mcp#provide-servers-through-managed-settings) für jeden Benutzer zusammen mit den von ihm hinzugefügten bereit | MCP | Managed |693| [`managedMcpServers`](#managedmcpservers) | Stellen Sie Remote-[MCP-Server](/docs/de/managed-mcp#provide-servers-through-managed-settings) für jeden Benutzer zusammen mit den von ihm hinzugefügten bereit | MCP | Managed |

694| [`managedSourcesBehavior`](#managedsourcesbehavior) | Kombinieren Sie jede [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources), die Sie bereitstellen, anstatt nur die mit der höchsten Priorität zu verwenden | Enterprise and managed settings | Managed |694| [`managedSourcesBehavior`](#managedsourcesbehavior) | Kombinieren Sie jede [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources), die Sie bereitstellen, anstatt nur die mit der höchsten Priorität zu verwenden | Enterprise and managed settings | Managed |

1134 1135

1135| Feld | Typ | Was es tut |1136| Feld | Typ | Was es tut |

1136| :- | :- | :- |1137| :- | :- | :- |

1137| `options` | Array von Zeilen, jede mit einem erforderlichen `model` und einem optionalen `label` und `description` | Die Zeilen, die die Auswahl zeigt, in dieser Reihenfolge, außer dass eine ausgegraut Zeile nach unten verschoben wird. Ohne `label` betitelt Claude Code die Zeile mit dem integrierten Namen für ein Modell, das es kennt, oder der Modell-ID ansonsten, und ohne `description` schreibt es eine generische zweite Zeile |1138| `options` | Array von Zeilen, jede mit einem erforderlichen `model` und optionalen `label`, `description` und `behavesAs` | Die Zeilen, die die Auswahl zeigt, in dieser Reihenfolge, außer dass eine ausgegraut Zeile nach unten verschoben wird. Ohne `label` betitelt Claude Code die Zeile mit dem integrierten Namen für ein Modell, das es kennt, oder der Modell-ID ansonsten, und ohne `description` schreibt es eine generische zweite Zeile |

1138| `replaceBuiltInOptions` | Boolean, Standard `false` | Setzen Sie es auf `true`, um nur diese Zeilen, **Standard** und eine Zeile für das Modell anzuzeigen, das die Sitzung bereits verwendet. Lassen Sie es ungesetzt, um diese Zeilen nach der integrierten Auswahl hinzuzufügen |1139| `replaceBuiltInOptions` | Boolean, Standard `false` | Setzen Sie es auf `true`, um nur diese Zeilen, **Standard** und eine Zeile für das Modell anzuzeigen, das die Sitzung bereits verwendet. Lassen Sie es ungesetzt, um diese Zeilen nach der integrierten Auswahl hinzuzufügen |

1139 1140

1141Ein Eintrag in `options` kann auch ein optionales `behavesAs`-String neben seinem `model` tragen, das v2.1.257 oder später erfordert. Setzen Sie es auf die ID eines Modells, das Ihre Claude Code-Version bereits kennt, wie `claude-opus-4-8`, auf einem Eintrag, dessen `model` neuer ist als Ihre Version. Claude Code wendet dann die Fähigkeiten und Aufwands-Standards dieses bekannten Modells auf den Eintrag an, anstatt sein Modell als unbekannt zu behandeln. Die Bezeichnung des Eintrags und die Modell-ID, die Claude Code in Anfragen sendet, ändern sich nicht.

1142

1140Mit `replaceBuiltInOptions` an, versteckt Claude Code jede andere Zeile: die integrierte Auswahl, die Zeilen, die es für [`availableModels`](#availablemodels)-Einträge hinzufügt, die Modelle, die [Gateway-Erkennung](/docs/de/llm-gateway-protocol#model-discovery) gefunden hat, und [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/de/model-config#add-a-custom-model-option). Mit ihr aus, überspringt Claude Code ein aufgelistetes Modell, das die integrierte Auswahl bereits abdeckt. Ein Label ändert, was die Auswahl zeigt, nicht welches Modell Claude Code ausführt.1143Mit `replaceBuiltInOptions` an, versteckt Claude Code jede andere Zeile: die integrierte Auswahl, die Zeilen, die es für [`availableModels`](#availablemodels)-Einträge hinzufügt, die Modelle, die [Gateway-Erkennung](/docs/de/llm-gateway-protocol#model-discovery) gefunden hat, und [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/de/model-config#add-a-custom-model-option). Mit ihr aus, überspringt Claude Code ein aufgelistetes Modell, das die integrierte Auswahl bereits abdeckt. Ein Label ändert, was die Auswahl zeigt, nicht welches Modell Claude Code ausführt.

1141 1144

1142Eine [`availableModels`](#availablemodels)-Zulassungsliste gilt immer noch für diese Zeilen. Bevor Sie ein aufgelistetes Modell zur Zulassungsliste hinzufügen, lesen Sie [Zusammenführungsverhalten](/docs/de/model-config#merge-behavior): eine spezifische Modell-ID verengt den Wildcard-Eintrag ihrer Familie. Claude Code überprüft auch jede Zeile gegen die Sitzung, bevor es die Auswahl zeigt:1145Eine [`availableModels`](#availablemodels)-Zulassungsliste gilt immer noch für diese Zeilen. Bevor Sie ein aufgelistetes Modell zur Zulassungsliste hinzufügen, lesen Sie [Zusammenführungsverhalten](/docs/de/model-config#merge-behavior): eine spezifische Modell-ID verengt den Wildcard-Eintrag ihrer Familie. Claude Code überprüft auch jede Zeile gegen die Sitzung, bevor es die Auswahl zeigt:

1192| Feld | Typ | Was es tut |1195| Feld | Typ | Was es tut |

1193| :- | :- | :- |1196| :- | :- | :- |

1194| `multiplier` | Zahl größer als 0 und höchstens 10 | Skaliert jede Kosten, die Claude Code berechnet, ob oder ob nicht eine `overrides`-Zeile sie abdeckt. Unter 1 ist ein Rabatt, über 1 ein Aufschlag |1197| `multiplier` | Zahl größer als 0 und höchstens 10 | Skaliert jede Kosten, die Claude Code berechnet, ob oder ob nicht eine `overrides`-Zeile sie abdeckt. Unter 1 ist ein Rabatt, über 1 ein Aufschlag |

1195| `overrides` | Karte von Modell-ID zu einem Rateobjekt mit `input`, `output`, `cacheRead` und `cacheWrite`, jeweils 0 bis 10000 | Die USD-pro-Million-Token-Sätze für dieses Modell, alle vier erforderlich. `cacheWrite` deckt sowohl Fünf-Minuten- als auch Einstunden-Cache-Schreibvorgänge ab. Siehe [Welche Modelle eine Zeile `modelPricing` anwendet](#which-models-a-modelpricing-row-applies-to) |1198| `overrides` | Karte von Modell-ID zu einem Rateobjekt mit `input`, `output`, `cacheRead` und `cacheWrite`, jeweils 0 bis 10000 | Die USD-pro-Million-Token-Sätze für dieses Modell, alle vier erforderlich. `cacheWrite` deckt sowohl Fünf-Minuten- als auch Einstunden-Cache-Schreibvorgänge ab. Siehe [Welche Modelle eine `modelPricing`-Zeile anwendet](#which-models-a-modelpricing-row-applies-to) |

1196 1199

1197Claude Code verwendet die Sätze einer Zeile genau wie Sie sie schrieben, ohne den Schnellmodus-Aufschlag oder den [nur-US-Inferenz-Satz](https://platform.claude.com/docs/en/about-claude/pricing) hinzuzufügen. Wenn Sie auch `multiplier` setzen, wendet Claude Code ihn auf die Sätze der Zeile an. Claude Code löscht eine Zeile mit einem Satz, den es nicht analysieren kann, oder einen `multiplier`, den es nicht analysieren kann, und behält den Rest; siehe [Fehlerhafte Einstellungsdatei beheben](/docs/de/settings#fix-a-broken-settings-file).1200Claude Code verwendet die Sätze einer Zeile genau wie Sie sie schrieben, ohne den Schnellmodus-Aufschlag oder den [nur-US-Inferenz-Satz](https://platform.claude.com/docs/en/about-claude/pricing) hinzuzufügen. Wenn Sie auch `multiplier` setzen, wendet Claude Code ihn auf die Sätze der Zeile an. Claude Code löscht eine Zeile mit einem Satz, den es nicht analysieren kann, oder einen `multiplier`, den es nicht analysieren kann, und behält den Rest; siehe [Fehlerhafte Einstellungsdatei beheben](/docs/de/settings#fix-a-broken-settings-file).

1198 1201

3416* **Typ**: String, `"classic"` oder `"readline"`3419* **Typ**: String, `"classic"` oder `"readline"`

3417* **Standard**: nicht gesetzt3420* **Standard**: nicht gesetzt

3418 3421

3422<h3 id="maxprosewidth">

3423 `maxProseWidth`

3424</h3>

3425

3426Begrenzen Sie die Breite der Prosa in Claudes Antworten, damit Zeilen in einem breiten Terminal lesbar bleiben. Absätze, Überschriften, Listen und Blockzitate werden in dieser Anzahl von Spalten umgebrochen, während Tabellen und Code-Blöcke die volle Terminal-Breite behalten. Erfordert Claude Code v2.1.282 oder später.

3427

3428* **Bereich**: [`Beliebige Datei`](#scopes)

3429* **Typ**: Anzahl der Terminal-Spalten, eine ganze Zahl, Minimum `40`. Claude Code ignoriert jeden anderen Wert

3430* **Standard**: nicht gesetzt, daher wird Prosa am Terminal-Rand umgebrochen

3431

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

3433{

3434 "maxProseWidth": 80

3435}

3436```

3437

3419<h3 id="prefersreducedmotion">3438<h3 id="prefersreducedmotion">

3420 `prefersReducedMotion`3439 `prefersReducedMotion`

3421</h3>3440</h3>

setup.md +3 −3

Details

37 37

38<Tip>38<Tip>

39 Bevorzugen Sie eine grafische Benutzeroberfläche? Die [Desktop-App](/docs/de/desktop-quickstart) ermöglicht es Ihnen, Claude Code ohne das Terminal zu verwenden. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) oder [Linux](/docs/de/desktop-linux) herunter.39 Bevorzugen Sie eine grafische Benutzeroberfläche? Die [Desktop-App](/docs/de/desktop-quickstart) ermöglicht es Ihnen, Claude Code ohne das Terminal zu verwenden. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) oder [Linux](/docs/de/desktop-linux) herunter.

~~41 Neu im Terminal? Siehe die [Terminalanleitung](/docs/de/terminal-guide) für Schritt-für-Schritt-Anweisungen.~~

42</Tip>40</Tip>

43 41

~~44Um Claude Code zu installieren, verwenden Sie eine der folgenden Methoden:~~42Um Claude Code zu installieren, öffnen Sie ein Terminal und führen Sie den Befehl für Ihr System aus. Wenn Sie noch nie ein Terminal verwendet haben, zeigt der [Terminal-Leitfaden](/docs/de/terminal-guide), wie Sie eines öffnen und den Befehl einfügen.

45 43

46<Tabs>44<Tabs>

47 <Tab title="Native Installation (Empfohlen)">45 <Tab title="Native Installation (Empfohlen)">

63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd61 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

64 ```62 ```

65 63

64 Wenn das Installationsprogramm fertig ist, öffnen Sie ein neues Terminal-Fenster und führen Sie `claude --version` aus. Eine funktionierende Installation gibt eine Versionsnummer aus. Wenn Ihre Shell sagt, dass `claude` nicht gefunden wird oder nicht erkannt wird, ist das Installationsverzeichnis noch nicht in Ihrem PATH: siehe [Beheben Sie Ihren PATH](/docs/de/troubleshoot-install#command-not-found-claude-after-installation).

66 Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell. Ihre Eingabeaufforderung zeigt `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.66 Wenn Sie `The token '&&' is not a valid statement separator` sehen, befinden Sie sich in PowerShell, nicht in CMD. Wenn Sie `'irm' is not recognized as an internal or external command` sehen, befinden Sie sich in CMD, nicht in PowerShell. Ihre Eingabeaufforderung zeigt `PS C:\`, wenn Sie sich in PowerShell befinden, und `C:\` ohne `PS`, wenn Sie sich in CMD befinden.

67 67

68 Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen curl-Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.68 Wenn der Installationsbefehl mit `syntax error near unexpected token '<'`, einem `403` oder einem anderen curl-Fehler fehlschlägt, siehe [Installationsfehler beheben](/docs/de/troubleshoot-install#find-your-error), um den Fehler einer Lösung zuzuordnen und alternative Installationsmethoden zu finden.

skills.md +64 −45

Details

135Skill-Ordner folgen auch diesen Regeln:135Skill-Ordner folgen auch diesen Regeln:

136 136

137* **Symverlinkte Ordner**: Ein `<skill-name>`-Eintrag am Enterprise-, Personal- oder Projekt-Speicherort kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code liest `SKILL.md` aus dem Ziel und lädt den Skill einmal, auch wenn mehrere Speicherorte auf dasselbe Ziel verweisen. Plugin-Skills [handhaben Symlinks anders](/docs/de/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks).137* **Symverlinkte Ordner**: Ein `<skill-name>`-Eintrag am Enterprise-, Personal- oder Projekt-Speicherort kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code liest `SKILL.md` aus dem Ziel und lädt den Skill einmal, auch wenn mehrere Speicherorte auf dasselbe Ziel verweisen. Plugin-Skills [handhaben Symlinks anders](/docs/de/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks).

138* **Reservierter Name**: Benennen Sie einen Skill-Ordner nicht `synced`, in keiner Schreibweise. Claude Code verwendet `~/.claude/skills/synced/` für [Skills, die von claude.ai heruntergeladen werden](#where-synced-skills-load) und überspringt einen Skill, den Sie unter diesem Namen an den Enterprise-, Personal- und Projekt-Speicherorten erstellen.138* **Reservierter Name `synced`**: Benennen Sie einen Skill-Ordner nicht `synced`, in keiner Schreibweise. Claude Code verwendet `~/.claude/skills/synced/` für [Skills, die von claude.ai heruntergeladen werden](#where-synced-skills-load) und überspringt einen Skill, den Sie unter diesem Namen am Enterprise-, Personal- und Projekt-Speicherort erstellen.

139* **Reservierter Name `anthropic-skills`**: Außerhalb eines Plugins wird ein Skill-Ordner oder eine Befehlsdatei mit dem Namen `anthropic-skills` oder einem Namen, der mit `anthropic-skills:` beginnt, nicht geladen. Siehe [Namen, die für synchronisierte Skills reserviert sind](#names-reserved-for-synced-skills).

139* **Befehlsdateien**: Eine Markdown-Datei in `.claude/commands/` ist das ältere Format und funktioniert immer noch. Sie unterstützt dieselbe [Frontmatter](#frontmatter-reference) außer `name` und `paths`. Um den Namen zu finden, den Sie eingeben, um ihn aufzurufen, siehe [Wie ein Skill seinen Befehlsnamen erhält](#how-a-skill-gets-its-command-name). Bevorzugen Sie einen Skill für neue Arbeiten, da Skills auch [unterstützende Dateien](#add-supporting-files) unterstützen.140* **Befehlsdateien**: Eine Markdown-Datei in `.claude/commands/` ist das ältere Format und funktioniert immer noch. Sie unterstützt dieselbe [Frontmatter](#frontmatter-reference) außer `name` und `paths`. Um den Namen zu finden, den Sie eingeben, um ihn aufzurufen, siehe [Wie ein Skill seinen Befehlsnamen erhält](#how-a-skill-gets-its-command-name). Bevorzugen Sie einen Skill für neue Arbeiten, da Skills auch [unterstützende Dateien](#add-supporting-files) unterstützen.

140* **Skill-Ordner als Plugin**: Fügen Sie eine `.claude-plugin/plugin.json` zu einem Skill-Ordner hinzu und er wird als [Plugin](/docs/de/plugins/loading#plugins-shared-through-a-repository) mit dem Namen `<name>@skills-dir` geladen, sodass er Agents, Hooks und MCP-Server bündeln kann. In einem Projekt `.claude/skills/` ist dies erforderlich, um zuerst den Workspace-Trust-Dialog zu akzeptieren.141* **Skill-Ordner als Plugin**: Fügen Sie eine `.claude-plugin/plugin.json` zu einem Skill-Ordner hinzu und er wird als [Plugin](/docs/de/plugins/loading#plugins-shared-through-a-repository) mit dem Namen `<name>@skills-dir` geladen, sodass er Agents, Hooks und MCP-Server bündeln kann. In einem Projekt's `.claude/skills/` ist dies erforderlich, um zuerst das Workspace-Trust-Dialogfeld zu akzeptieren.

141 142

142<h3 id="discovery-from-parent-and-nested-directories">143<h3 id="discovery-from-parent-and-nested-directories">

143 Skills in Monorepos und Unterverzeichnissen laden144 Skills in Monorepos und Unterverzeichnissen laden

144</h3>145</h3>

145 146

146Claude Code lädt Projekt-Skills aus `.claude/skills/` in dem Verzeichnis, in dem Sie ihn starten, und in jedem übergeordneten Verzeichnis bis zur Repository-Root, sodass das Starten in `packages/frontend/` immer noch Skills aufgreift, die in der Root definiert sind. Wenn Sie [die Sitzung mit `/cd`](/docs/de/permissions#move-the-session-to-another-directory) auf v2.1.246 oder später verschieben, fügt Claude Code die Projekt-Skills des neuen Verzeichnisses hinzu.147Claude Code lädt Projekt-Skills aus `.claude/skills/` in dem Verzeichnis, in dem Sie ihn starten, und in jedem übergeordneten Verzeichnis bis zur Repository-Root, sodass das Starten in `packages/frontend/` immer noch Skills aufgreift, die in der Root definiert sind. Wenn Sie [die Sitzung mit `/cd` verschieben](/docs/de/permissions#move-the-session-to-another-directory) auf v2.1.246 oder später, fügt Claude Code die Projekt-Skills des neuen Verzeichnisses hinzu.

147 148

148In einer verknüpften [Git Worktree](/docs/de/worktrees) sucht Claude Code übergeordnete Verzeichnisse nur bis zur Worktree-Root. Auf Claude Code v2.1.277 oder später lädt Claude Code, wenn der Worktree-Checkout kein `.claude/skills`-Verzeichnis in seiner Root hat, stattdessen die Projekt-Skills des Haupt-Checkouts. Siehe [Was Worktrees mit dem Haupt-Checkout teilen](/docs/de/worktrees#what-worktrees-share-with-the-main-checkout).149In einer Sitzung, die in einem verknüpften [Git Worktree](/docs/de/worktrees) läuft, durchsucht Claude Code übergeordnete Verzeichnisse nur bis zur Worktree-Root. Auf Claude Code v2.1.277 oder später lädt Claude Code, wenn der Worktree-Checkout kein `.claude/skills`-Verzeichnis in seiner Root hat, stattdessen die Projekt-Skills des Haupt-Checkouts. Siehe [Was Worktrees mit dem Haupt-Checkout teilen](/docs/de/worktrees#what-worktrees-share-with-the-main-checkout).

149 150

150Skills in einem `.claude/skills/`-Verzeichnis unter dem Ort, an dem Sie gestartet haben, werden beim Start nicht geladen. Sie werden geladen, wenn Claude zum ersten Mal eine Datei in diesem Unterverzeichnis liest oder bearbeitet, und bleiben für den Rest der Sitzung verfügbar. Bis dahin erscheinen sie nicht im `/`-Menü und Sie können sie nicht nach Name aufrufen. Um sie früher zu laden, führen Sie `/add-dir` mit dem Pfad des Unterverzeichnisses aus, was Claude Code v2.1.257 oder später erfordert.151Skills in einem `.claude/skills/`-Verzeichnis unterhalb des Ortes, an dem Sie gestartet haben, werden beim Start nicht geladen. Sie werden geladen, wenn Claude zum ersten Mal eine Datei in diesem Unterverzeichnis liest oder bearbeitet, und bleiben für den Rest der Sitzung verfügbar. Bis dahin erscheinen sie nicht im `/`-Menü und Sie können sie nicht nach Name aufrufen. Um sie früher zu laden, führen Sie `/add-dir` mit dem Pfad des Unterverzeichnisses aus, was Claude Code v2.1.257 oder später erfordert.

151 152

152Wenn ein verschachtelter Skill denselben Namen wie ein anderer Skill hat, bleiben beide verfügbar. Mit einem `deploy`-Skill in der Repository-Root und einem anderen in `apps/web/.claude/skills/`:153Wenn ein verschachtelter Skill denselben Namen wie ein anderer Skill hat, bleiben beide verfügbar. Mit einem `deploy`-Skill in der Repository-Root und einem anderen in `apps/web/.claude/skills/`:

153 154

154* `/deploy` führt den Root-Skill aus. Claude Code listet auch die verzeichnisqualifizierten Varianten für Claude auf, mit einer Anweisung, den aufzurufen, dessen Verzeichnis die Dateien enthält, an denen es arbeitet, sodass der verschachtelte Skill immer noch auf Arbeiten in `apps/web/` angewendet wird.155* `/deploy` führt den Root-Skill aus. Claude Code listet auch die verzeichnisqualifizierten Varianten für Claude auf, mit einer Anweisung, denjenigen aufzurufen, dessen Verzeichnis die Dateien enthält, an denen es arbeitet, sodass der verschachtelte Skill immer noch auf Arbeiten in `apps/web/` angewendet wird.

155* `/apps/web:deploy` führt den verschachtelten Skill allein aus. Seine Beschreibung benennt das Verzeichnis, auf das es angewendet wird.156* `/apps/web:deploy` führt den verschachtelten Skill eigenständig aus. Seine Beschreibung benennt das Verzeichnis, auf das es angewendet wird.

156 157

157<h3 id="skills-from-additional-directories">158<h3 id="skills-from-additional-directories">

158 Skills aus einem Verzeichnis außerhalb des Projekts laden159 Skills aus einem Verzeichnis außerhalb des Projekts laden

160 161

161Wenn Sie ein Verzeichnis mit `--add-dir` oder `/add-dir` hinzufügen, lädt Claude Code die Skills in `.claude/skills/` dieses Verzeichnisses zusammen mit `.claude/commands/` und `.claude/agents/`. Verzeichnisse, die das Agent SDK durch [`additionalDirectories`](/docs/de/agent-sdk/typescript#options) in TypeScript oder [`add_dirs`](/docs/de/agent-sdk/python#claudeagentoptions) in Python hinzufügt, werden auf die gleiche Weise geladen, da das SDK sie als `--add-dir` übergibt. Die Einstellung `permissions.additionalDirectories` in `settings.json` gewährt nur Dateizugriff und lädt keine dieser.162Wenn Sie ein Verzeichnis mit `--add-dir` oder `/add-dir` hinzufügen, lädt Claude Code die Skills in `.claude/skills/` dieses Verzeichnisses zusammen mit `.claude/commands/` und `.claude/agents/`. Verzeichnisse, die das Agent SDK durch [`additionalDirectories`](/docs/de/agent-sdk/typescript#options) in TypeScript oder [`add_dirs`](/docs/de/agent-sdk/python#claudeagentoptions) in Python hinzufügt, werden auf die gleiche Weise geladen, da das SDK sie als `--add-dir` übergibt. Die Einstellung `permissions.additionalDirectories` in `settings.json` gewährt nur Dateizugriff und lädt keine dieser.

162 163

163Claude Code überwacht `.claude/skills/` in einem Verzeichnis, das Sie mit `--add-dir` beim Start übergeben, wie [Bearbeiten Sie einen Skill während einer Sitzung](#live-change-detection) beschreibt. Es überwacht nicht `.claude/commands/` oder `.claude/agents/` des hinzugefügten Verzeichnisses, daher starten Sie die Sitzung nach dem Ändern einer Datei dort neu.164Claude Code überwacht `.claude/skills/` in einem Verzeichnis, das Sie mit `--add-dir` beim Start übergeben, wie [Einen Skill während einer Sitzung bearbeiten](#live-change-detection) beschreibt. Es überwacht nicht das `.claude/commands/` oder `.claude/agents/` des hinzugefügten Verzeichnisses, daher starten Sie die Sitzung neu, nachdem Sie eine Datei dort geändert haben.

164 165

165Diese Ladevorgänge hängen von der `project` [Einstellungsquelle](/docs/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) ab, die standardmäßig aktiviert ist. Eine [`strictPluginOnlyCustomization`](/docs/de/settings-reference#strictpluginonlycustomization)-Richtlinie, [Bare Mode](/docs/de/headless#start-faster-with-bare-mode) und [`--safe-mode`](/docs/de/cli-reference#cli-flags) beschränken sie weiter, wie diese Seiten beschreiben. Siehe [Zusätzliche Verzeichnisse gewähren Dateizugriff, keine Konfiguration](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) für die vollständige Tabelle, was ein hinzugefügtes Verzeichnis lädt, einschließlich `CLAUDE.md` und Plugin-Einstellungen.166Diese Ladevorgänge hängen von der `project`-[Einstellungsquelle](/docs/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) ab, die standardmäßig aktiviert ist. Eine [`strictPluginOnlyCustomization`](/docs/de/settings-reference#strictpluginonlycustomization)-Richtlinie, [Bare Mode](/docs/de/headless#start-faster-with-bare-mode) und [`--safe-mode`](/docs/de/cli-reference#cli-flags) beschränken sie weiter, wie diese Seiten beschreiben. Siehe [Zusätzliche Verzeichnisse gewähren Dateizugriff, keine Konfiguration](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) für die vollständige Tabelle, was ein hinzugefügtes Verzeichnis lädt, einschließlich `CLAUDE.md` und Plugin-Einstellungen.

166 167

167<h3 id="resolve-skills-that-share-a-name">168<h3 id="resolve-skills-that-share-a-name">

168 Beheben Sie Skills, die denselben Namen haben169 Skills auflösen, die denselben Namen haben

169</h3>170</h3>

170 171

171Wenn zwei Skills denselben Namen haben, entscheidet, woher jeder kommt, welcher `/name` ausführt. Die Tabelle behandelt die Enterprise-, Personal-, Projekt-, verschachtelte, Plugin- und claude.ai-Speicherorte, gebündelte Skills und Befehlsdateien:172Wenn zwei Skills denselben Namen haben, entscheidet, woher jeder kam, welcher `/name` ausführt. Für einen Namen, der durch das Frontmatter-Feld `name` festgelegt wird, siehe [Wie ein Skill seinen Befehlsnamen erhält](#how-a-skill-gets-its-command-name). Die Tabelle behandelt die Enterprise-, Personal-, Projekt-, verschachtelte, Plugin- und claude.ai-Speicherorte, gebündelte Skills und Befehlsdateien:

172 173

173| Gleicher Name in | Welcher wird ausgeführt |174| Gleicher Name in | Welcher wird ausgeführt |

174| :- | :- |175| :- | :- |

175| Zwei von Enterprise, Personal und Projekt | Enterprise über Personal und Personal über Projekt. Mit `deploy` in beiden `~/.claude/skills/` und `.claude/skills/` des Projekts führt `/deploy` den Personal-Skill aus |176| Zwei von Enterprise, Personal und Projekt | Enterprise über Personal und Personal über Projekt. Mit `deploy` in beiden `~/.claude/skills/` und `.claude/skills/` des Projekts führt `/deploy` den persönlichen aus |

176| Einer dieser Speicherorte und ein [gebündelter Skill](#bundled-skills) | Ihr Skill ersetzt den gebündelten Befehl, aber nicht seine Aliase. Ein Projekt-`code-review`-Skill ersetzt `/code-review`, und der gebündelte Alias `/review` führt Ihren Skill nie aus |177| Einer dieser Speicherorte und ein [gebündelter Skill](#bundled-skills) | Ihr Skill ersetzt den gebündelten Befehl, aber nicht seine Aliase. Ein Projekt-`code-review`-Skill ersetzt `/code-review`, und der gebündelte Alias `/review` führt niemals Ihren Skill aus |

178| Ein Projekt-Root-Skill und ein verschachtelter Skill | Beide werden geladen. Siehe [Monorepos und Unterverzeichnisse](#discovery-from-parent-and-nested-directories) |179| Ein Projekt-Root-Skill und ein verschachtelter Skill | Beide werden geladen. Siehe [Monorepos und Unterverzeichnisse](#discovery-from-parent-and-nested-directories) |

179| Ein Plugin-Skill und ein Skill an einem der obigen Speicherorte | Beide werden geladen, da Plugin-Skills als `/plugin-name:skill-name` namensgebunden sind |180| Ein Plugin-Skill und ein Skill an einem der obigen Speicherorte | Beide werden geladen, da Plugin-Skills als `/plugin-name:skill-name` namensgebunden sind |

180| Einer der obigen und ein Skill [von Ihrem claude.ai-Konto synchronisiert](#how-synced-skills-behave) | Der andere Skill oder Befehl. Der synchronisierte Skill wird immer noch als `/anthropic-skills:<name>` ausgeführt. Siehe [Wenn ein synchronisierter Skill-Name mit einem anderen Befehl übereinstimmt](#when-a-synced-skill-name-matches-another-command) |181| Einer der obigen und der Kurzname eines Skills, der [von Ihrem claude.ai-Konto synchronisiert wird](#how-synced-skills-behave) | Der andere Skill oder Befehl. Der synchronisierte Skill wird dann aufgelistet und läuft nur unter seinem vollständigen Namen. Siehe [Wenn ein synchronisierter Skill-Name mit einem anderen Befehl übereinstimmt](#when-a-synced-skill-name-matches-another-command) |

181 182

182<h3 id="skills-in-cowork-and-cloud-sessions">183<h3 id="skills-in-cowork-and-cloud-sessions">

183 Verwenden Sie Skills in Cowork- und Cloud-Sitzungen184 Skills in Cowork- und Cloud-Sitzungen verwenden

184</h3>185</h3>

185 186

186[Cowork](https://claude.com/product/cowork)-Sitzungen und [Cloud-Sitzungen](/docs/de/cloud-environments#what-carries-over-from-your-setup), einschließlich [Routinen](/docs/de/routines), lesen nicht `~/.claude/skills/` auf Ihrer Maschine. Sowohl interaktive als auch geplante Cowork-Sitzungen laden die Skills, die für Ihr claude.ai-Konto aktiviert sind, synchronisiert beim Sitzungsstart; verwalten Sie sie über **Customize** in der Desktop-App-Seitenleiste oder in den Skill-Einstellungen auf claude.ai. Cloud-Sitzungen laden zusätzlich Projekt-Skills, die in `.claude/skills/` des geklonten Repositorys committet sind.187[Cowork](https://claude.com/product/cowork)-Sitzungen und [Cloud-Sitzungen](/docs/de/cloud-environments#what-carries-over-from-your-setup), einschließlich [Routinen](/docs/de/routines), lesen nicht `~/.claude/skills/` auf Ihrer Maschine. Sowohl interaktive als auch geplante Cowork-Sitzungen laden die Skills, die für Ihr claude.ai-Konto aktiviert sind, synchronisiert beim Sitzungsstart; verwalten Sie sie über **Customize** in der Desktop-App-Seitenleiste oder in den Skill-Einstellungen auf claude.ai. Cloud-Sitzungen laden zusätzlich Projekt-Skills, die in `.claude/skills/` des geklonten Repositorys committet sind.

188Wenn ein Skill nur in `~/.claude/skills/` auf Ihrer Maschine vorhanden ist, meldet Claude Code, dass der Skill nicht gefunden wurde, wenn eine [Routine](/docs/de/routines) ihn aufruft, da jede Routine-Ausführung als frische Cloud-Sitzung startet. Um einen persönlichen Skill in diesen Sitzungen verfügbar zu machen:189Wenn ein Skill nur in `~/.claude/skills/` auf Ihrer Maschine vorhanden ist, meldet Claude Code, dass der Skill nicht gefunden wurde, wenn eine [Routine](/docs/de/routines) ihn aufruft, da jede Routine-Ausführung als frische Cloud-Sitzung startet. Um einen persönlichen Skill in diesen Sitzungen verfügbar zu machen:

189 190

190* Für Cowork- und Cloud-Sitzungen aktivieren Sie den Skill für Ihr claude.ai-Konto.191* Für Cowork- und Cloud-Sitzungen aktivieren Sie den Skill für Ihr claude.ai-Konto.

191* Für Cloud-Sitzungen können Sie den Skill stattdessen in `.claude/skills/` des Repositorys committen. Plugins, die in `.claude/settings.json` des Repositorys deklariert sind, [werden beim Sitzungsstart geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup); Plugins, die nur in Ihren Benutzereinstellungen aktiviert sind, werden nicht übertragen.192* Für Cloud-Sitzungen können Sie den Skill stattdessen in `.claude/skills/` des Repositorys committen. Plugins, die in `.claude/settings.json` des Repositorys deklariert sind, und Plugins, die nur in Ihren Benutzereinstellungen aktiviert sind, [werden nicht in Cloud-Sitzungen geladen](/docs/de/cloud-environments#what-carries-over-from-your-setup).

192 193

193[Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) werden lokal auf Ihrer Maschine ausgeführt, daher laden sie `~/.claude/skills/`.194[Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) werden lokal auf Ihrer Maschine ausgeführt, daher laden sie `~/.claude/skills/`.

194 195

196 Skills, die von claude.ai synchronisiert werden197 Skills, die von claude.ai synchronisiert werden

197</h3>198</h3>

198 199

199Dieser Abschnitt gilt für Sie, wenn Sie Cowork- oder Cloud-Sitzungen verwenden oder sich in Ihrem Terminal mit einem claude.ai-Konto bei Claude Code anmelden. In diesen Sitzungen lädt Claude Code die Skills, die für Ihr claude.ai-Konto aktiviert sind, ohne Setup auf Ihrer Seite, wie [Wo synchronisierte Skills geladen werden](#where-synced-skills-load) beschreibt. Diese Skills umfassen die Skills, die Sie in Ihren claude.ai-Einstellungen erstellen oder aktivieren, Skills, die Ihre Organisation dort bereitstellt, und Anthropics integrierte Skills wie `pdf` und `xlsx`.200Dieser Abschnitt gilt für Sie, wenn Sie Cowork- oder Cloud-Sitzungen verwenden oder sich in Ihrem Terminal mit einem claude.ai-Konto bei Claude Code anmelden. In diesen Sitzungen lädt Claude Code die Skills, die für Ihr claude.ai-Konto aktiviert sind, ohne Setup auf Ihrer Seite, wie [Wo synchronisierte Skills geladen werden](#where-synced-skills-load) beschreibt. Diese Skills umfassen die, die Sie in Ihren claude.ai-Einstellungen erstellen oder aktivieren, Skills, die Ihre Organisation dort bereitstellt, und Anthropic's integrierte Skills wie `pdf` und `xlsx`.

200 201

201Claude Code lädt einen synchronisierten Skill von Ihrem Konto herunter, anstatt eine Datei zu lesen, die Sie auf der Maschine geschrieben haben, auf der die Sitzung läuft, daher wendet es Regeln auf synchronisierte Skills an, die nicht auf die Skills angewendet werden, die Sie in den [Skill-Speicherorten](#where-skills-live) speichern.202Claude Code lädt einen synchronisierten Skill von Ihrem Konto herunter, anstatt eine Datei zu lesen, die Sie auf der Maschine geschrieben haben, auf der die Sitzung läuft, daher wendet es Regeln auf synchronisierte Skills an, die nicht auf die Skills angewendet werden, die Sie in den [Skill-Speicherorten](#where-skills-live) speichern.

202 203

206 207

207In einer Cowork- oder Cloud-Sitzung lädt Claude Code die Skills, die für Ihr claude.ai-Konto aktiviert sind, und [Skills in Cowork- und Cloud-Sitzungen](#skills-in-cowork-and-cloud-sessions) sagt, wie Sie wählen, welche Skills diese Sitzungen erhalten.208In einer Cowork- oder Cloud-Sitzung lädt Claude Code die Skills, die für Ihr claude.ai-Konto aktiviert sind, und [Skills in Cowork- und Cloud-Sitzungen](#skills-in-cowork-and-cloud-sessions) sagt, wie Sie wählen, welche Skills diese Sitzungen erhalten.

208 209

209In Ihrem Terminal synchronisiert Claude Code diese Skills in Sitzungen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden. Wenn die Sitzung startet, lädt Claude Code Ihre Account-Skills im Hintergrund in `~/.claude/skills/synced/` herunter und prüft dann etwa alle 10 Minuten auf Änderungen auf claude.ai, während die Sitzung läuft. Wenn eine Überprüfung feststellt, dass ein Skill auf claude.ai hinzugefügt, bearbeitet oder deaktiviert wurde, fügt Claude Code ihn in der laufenden Sitzung hinzu, aktualisiert oder entfernt ihn ohne Neustart. Die Synchronisierung in Terminal-Sitzungen erfordert Claude Code v2.1.273 oder später.210In Ihrem Terminal synchronisiert Claude Code diese Skills in Sitzungen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden. Wenn die Sitzung startet, lädt Claude Code Ihre Account-Skills im Hintergrund in `~/.claude/skills/synced/` herunter und prüft dann etwa alle 10 Minuten auf Änderungen auf claude.ai, während die Sitzung läuft. Wenn eine Prüfung feststellt, dass ein Skill auf claude.ai hinzugefügt, bearbeitet oder deaktiviert wurde, fügt Claude Code ihn in der laufenden Sitzung hinzu, aktualisiert oder entfernt ihn ohne Neustart. Die Synchronisierung in Terminal-Sitzungen erfordert Claude Code v2.1.273 oder später.

210 211

211Die Synchronisierung verzögert niemals den Start, da Claude auf den Download eines Skills nur wartet, wenn es diesen Skill aufruft. Ein kurzer [nicht-interaktiver](/docs/de/headless) Lauf kann daher beendet werden, bevor ein neu hinzugefügter Skill heruntergeladen wird. In diesem Fall lädt eine spätere Sitzung ihn herunter. Um einen nicht-interaktiven Lauf dazu zu bringen, Ihre Skills herunterzuladen und auf die Liste zu warten, bevor er die Eingabeaufforderung beantwortet, setzen Sie [`CLAUDE_CODE_SYNC_SKILLS`](/docs/de/env-vars#variables) auf `1`.212Die Synchronisierung verzögert niemals den Start, da Claude auf den Download eines Skills nur wartet, wenn er diesen Skill aufruft. Ein kurzer [nicht-interaktiver](/docs/de/headless) Lauf kann daher beendet werden, bevor ein neu hinzugefügter Skill heruntergeladen wird. In diesem Fall lädt eine spätere Sitzung ihn herunter. Um einen nicht-interaktiven Lauf dazu zu bringen, Ihre Skills herunterzuladen und auf die Liste zu warten, bevor er die Eingabeaufforderung beantwortet, setzen Sie [`CLAUDE_CODE_SYNC_SKILLS`](/docs/de/env-vars#variables) auf `1`.

212 213

213Claude Code synchronisiert nur in einer Sitzung, die sich mit Ihrem claude.ai-Konto anmeldet und [Feature-Flags von Anthropic abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Es synchronisiert nicht in diesen Sitzungen:214Claude Code synchronisiert nur in einer Sitzung, die sich mit Ihrem claude.ai-Konto anmeldet und [Feature-Flags von Anthropic abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Es synchronisiert nicht in diesen Sitzungen:

214 215

215* Eine Sitzung, die keine von `/login` gespeicherte Anmeldung verwendet, wie eine, die sich mit einem API-Schlüssel authentifiziert, oder eine, bei der `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` oder ein `apiKeyHelper`-Skript die Anmeldedaten bereitstellt216* Eine Sitzung, die keine Anmeldung verwendet, die von `/login` gespeichert wurde, wie eine, die sich mit einem API-Schlüssel authentifiziert, oder eine, bei der `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` oder ein `apiKeyHelper`-Skript die Anmeldedaten bereitstellt

216* Eine Sitzung, die keine Feature-Flags abruft, wie eine auf Amazon Bedrock oder eine, bei der Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` setzen217* Eine Sitzung, die keine Feature-Flags abruft, wie eine auf Amazon Bedrock oder eine, bei der Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` setzen

217* Eine Sitzung im [Bare Mode](/docs/de/headless#start-faster-with-bare-mode) oder eine, die Sie mit `--safe-mode` starten218* Eine Sitzung in [Bare Mode](/docs/de/headless#start-faster-with-bare-mode) oder eine, die Sie mit `--safe-mode` starten

218* Eine Sitzung, bei der die verwalteten Einstellungen Ihrer Organisation [Skills auf Plugin-Quellen sperren](/docs/de/settings-reference#strictpluginonlycustomization-skills), oder eine, die Sie mit einer [`--setting-sources`](/docs/de/cli-reference#cli-flags)-Liste starten, die `user` auslässt219* Eine Sitzung, bei der die verwalteten Einstellungen Ihrer Organisation [Skills auf Plugin-Quellen sperren](/docs/de/settings-reference#strictpluginonlycustomization-skills), oder eine, die Sie mit einer [`--setting-sources`](/docs/de/cli-reference#cli-flags)-Liste starten, die `user` auslässt

219 220

220Wenn Sie sich während einer Sitzung mit `/login` anmelden, starten Sie Claude Code neu, um die Synchronisierung zu starten.221Wenn Sie sich während einer Sitzung mit `/login` anmelden, starten Sie Claude Code neu, um die Synchronisierung zu starten.

221 222

222Skills, die eine frühere Sitzung synchronisiert hat, bleiben auf der Festplatte. Claude Code lädt sie in späteren Sitzungen, die sich mit demselben Konto anmelden, auch wenn es claude.ai nicht erreichen kann.223Skills, die eine frühere Sitzung synchronisiert hat, bleiben auf der Festplatte. Claude Code lädt sie in späteren Sitzungen, die sich bei demselben Konto anmelden, auch wenn es claude.ai nicht erreichen kann.

223 224

224Claude Code lädt synchronisierte Skills herunter und lädt sie nie hoch. Wenn Sie oder Claude eine Datei unter `~/.claude/skills/synced/` bearbeiten, wird die Änderung nicht in Ihrem claude.ai-Konto gespeichert, und eine spätere Synchronisierung kann sie überschreiben oder entfernen. Um einen synchronisierten Skill zu ändern, aktualisieren Sie ihn auf claude.ai; die nächste Synchronisierung lädt die neue Version herunter.225Claude Code lädt synchronisierte Skills herunter und lädt sie niemals hoch. Wenn Sie oder Claude eine Datei unter `~/.claude/skills/synced/` bearbeiten, wird die Änderung nicht in Ihrem claude.ai-Konto gespeichert, und eine spätere Synchronisierung kann sie überschreiben oder entfernen. Um einen synchronisierten Skill zu ändern, aktualisieren Sie ihn auf claude.ai; die nächste Synchronisierung lädt die neue Version herunter.

225 226

226Um zu sehen, welche Skills synchronisiert wurden, führen Sie `/skills` aus. Das Menü listet sie unter `claude.ai sync` auf.227Um zu sehen, welche Skills synchronisiert wurden, führen Sie `/skills` aus. Das Menü listet sie unter `claude.ai sync` auf.

227 228

228Einige von Anthropics Skills, wie `pdf` und `xlsx`, werden immer synchronisiert. Für die übrigen aktivieren oder deaktivieren Sie einen Skill in Ihren Skill-Einstellungen auf claude.ai, um zu ändern, ob er synchronisiert wird.229Einige von Anthropic's Skills, wie `pdf` und `xlsx`, werden immer synchronisiert. Für die übrigen aktivieren oder deaktivieren Sie einen Skill in Ihren Skill-Einstellungen auf claude.ai, um zu ändern, ob er synchronisiert wird.

229 230

230Um die Synchronisierung auf einer Maschine zu beenden, setzen Sie [`syncClaudeAiSkills`](/docs/de/settings-reference#syncclaudeaiskills) in Ihren Benutzereinstellungen auf `false`. Claude Code stoppt das Herunterladen, und beim nächsten Start verschiebt es die Skills, die es bereits synchronisiert hat, in `~/.claude/skills/.trash/` und lädt sie nicht mehr. Ihre Organisation kann die Synchronisierung für alle ausschalten, indem sie Skills auf claude.ai ausschaltet. Um die Synchronisierung zu beenden und Skills eingeschaltet zu lassen, kann sie denselben Schlüssel in [verwalteten Einstellungen](/docs/de/managed-settings) setzen.231Um die Synchronisierung auf einer Maschine zu stoppen, setzen Sie [`syncClaudeAiSkills`](/docs/de/settings-reference#syncclaudeaiskills) in Ihren Benutzereinstellungen auf `false`. Claude Code stoppt das Herunterladen, und beim nächsten Start verschiebt es die Skills, die es bereits synchronisiert hat, in `~/.claude/skills/.trash/` und lädt sie nicht mehr. Ihre Organisation kann die Synchronisierung für alle ausschalten, indem sie Skills auf claude.ai ausschaltet. Um die Synchronisierung zu stoppen, während Skills eingeschaltet bleiben, kann sie denselben Schlüssel in [verwalteten Einstellungen](/docs/de/managed-settings) setzen.

231 232

232Wenn Ihre Organisation Skills auf claude.ai ausschaltet, entfernt Claude Code die heruntergeladenen Skills und sie werden nicht mehr geladen. Die entfernten Skills werden in `~/.claude/skills/.trash/` verschoben, wo Sie die Dateien wiederherstellen können, bis die [Aufbewahrungslöschung](/docs/de/claude-directory#cleaned-up-automatically) sie löscht. Sobald Ihre Organisation Skills wieder einschaltet, lädt Claude Code die Skills herunter, die Sie beim nächsten Synchronisierungsvorgang aktiviert haben.233Wenn Ihre Organisation Skills auf claude.ai ausschaltet, entfernt Claude Code die heruntergeladenen Skills und sie werden nicht mehr geladen. Die entfernten Skills werden in `~/.claude/skills/.trash/` verschoben, wo Sie die Dateien wiederherstellen können, bis die [Aufbewahrungslöschung](/docs/de/claude-directory#cleaned-up-automatically) sie löscht. Sobald Ihre Organisation Skills wieder einschaltet, lädt Claude Code die Skills herunter, die Sie bei der nächsten Synchronisierung aktiviert haben.

233 234

234<h4 id="when-a-synced-skill-name-matches-another-command">235<h4 id="when-a-synced-skill-name-matches-another-command">

235 Wenn ein synchronisierter Skill-Name mit einem anderen Befehl übereinstimmt236 Wenn ein synchronisierter Skill-Name mit einem anderen Befehl übereinstimmt

236</h4>237</h4>

237 238

238Sie können einen synchronisierten Skill mit seinem vollständigen Namen, `/anthropic-skills:<name>`, oder seinem Kurznamen, `/<name>`, aufrufen. Wenn ein anderer Befehl diesen Kurznamen verwendet, führt `/<name>` den anderen Befehl aus, und der synchronisierte Skill wird nur als `/anthropic-skills:<name>` ausgeführt. Mit einem lokalen `deploy`-Skill und einem synchronisierten `deploy` führt `/deploy` den lokalen Skill aus und `/anthropic-skills:deploy` führt den synchronisierten aus. Vor v2.1.269 hatte ein synchronisierter Skill nur seinen Kurznamen.239Sie können einen synchronisierten Skill mit seinem Kurznamen `/<name>` oder mit seinem vollständigen Namen `/anthropic-skills:<name>` aufrufen. Wenn ein anderer Befehl den Kurznamen verwendet, führt `/<name>` den anderen Befehl aus, und der synchronisierte Skill wird nur als `/anthropic-skills:<name>` ausgeführt. Mit einem lokalen `deploy`-Skill und einem synchronisierten `deploy` führt `/deploy` den lokalen Skill aus und `/anthropic-skills:deploy` führt den synchronisierten aus. Vor v2.1.269 hatte ein synchronisierter Skill nur seinen Kurznamen.

239 240

240Der andere Befehl kann einer dieser sein:241Im `/`-Menü, `/skills` und `/context` wird ein synchronisierter Skill unter seinem Kurznamen angezeigt, oder unter seinem vollständigen Namen, während ein anderer Befehl den Kurznamen verwendet. Führen Sie `/skills` in Ihrer Sitzung aus. Eine Notiz unter der Liste erklärt jeden synchronisierten Skill, der seinen Kurznamen verloren hat. Wenn einer Ihrer persönlichen Skills oder Befehlsdateien in `~/.claude/` den Namen verwendet, sagt die Notiz auch, was Sie umbenennen oder löschen müssen, um ihn freizugeben.

242

243Von v2.1.269 bis v2.1.280 zeigten diese Listen jeden synchronisierten Skill unter seinem vollständigen Namen an, und `/skills` hatte keine solche Notiz; beides änderte sich in v2.1.281.

244

245Der Befehl, der den Kurznamen verwendet, kann einer dieser sein:

241 246

242* Ein integrierter Befehl oder ein [gebündelter Skill](#bundled-skills), einschließlich eines, der in Ihrer Sitzung nicht verfügbar ist, zum Beispiel nachdem Sie gebündelte Skills ausschalten247* Ein integrierter Befehl oder ein [gebündelter Skill](#bundled-skills), einschließlich eines, der in Ihrer Sitzung nicht verfügbar ist, zum Beispiel nachdem Sie gebündelte Skills ausschalten

243* Ein Skill auf einer beliebigen [lokalen Ebene](#where-skills-live) oder eine Datei in `.claude/commands/`248* Ein Skill auf einer beliebigen [lokalen Ebene](#where-skills-live) oder eine Datei in `.claude/commands/`

244* Ein Plugin-Skill249* Ein Plugin-Skill

245* Ein [MCP-Prompt](/docs/de/mcp#use-mcp-prompts-as-commands)250* Eine [MCP-Eingabeaufforderung](/docs/de/mcp#use-mcp-prompts-as-commands)

251

252Claude Code kennzeichnet synchronisierte Skills, damit Sie sehen können, woher sie stammen. Das `/skills`-Menü und `/context` gruppieren synchronisierte Skills unter `claude.ai sync`, und das `/`-Befehlsmenü kennzeichnet sie als von claude.ai stammend.

253

254Beim Vergleich von Namen ignoriert Claude Code Groß-/Kleinschreibung, Abstände und unsichtbare Zeichen und behandelt Kompatibilitätsformen wie Vollbreitenbuchstaben und Bindestrich-Varianten als ihre einfachen Äquivalente. Zum Beispiel zählen ein synchronisierter Skill mit dem Namen `Commit` und ein lokaler Skill mit dem Namen `commit` als derselbe Name, daher führt `/commit` weiterhin Ihren lokalen Skill aus.

246 255

247Claude Code kennzeichnet synchronisierte Skills, damit Sie sehen können, woher sie kommen. Das `/skills`-Menü und `/context` gruppieren synchronisierte Skills unter `claude.ai sync`, und das `/`-Befehlsmenü kennzeichnet sie als von claude.ai kommend.256Ein Name, der sich nur durch einen ähnlich aussehenden Buchstaben aus einem anderen Alphabet unterscheidet, zählt als ein anderer Name, und die `claude.ai sync`-Kennzeichnung ist, wie Sie die beiden unterscheiden. Diese Prüfungen und Kennzeichnungen erfordern Claude Code v2.1.228 oder später.

248 257

249Beim Vergleich von Namen ignoriert Claude Code Groß-/Kleinschreibung, Abstände und unsichtbare Zeichen und behandelt Kompatibilitätsformen wie Vollbreitenbuchstaben und Bindestrich-Varianten als ihre einfachen Äquivalente. Zum Beispiel zählt ein synchronisierter Skill namens `Commit` und ein lokaler Skill namens `commit` als derselbe Name, daher führt `/commit` weiterhin Ihren lokalen Skill aus.258<h4 id="names-reserved-for-synced-skills">

259 Namen, die für synchronisierte Skills reserviert sind

260</h4>

261

262Claude Code reserviert den Namen `anthropic-skills` und jeden Namen in diesem Namespace wie `anthropic-skills:pdf` für Skills, die von claude.ai synchronisiert werden, daher führt der vollständige Name eines synchronisierten Skills niemals etwas anderes aus. Der Name ist in jeder Sitzung reserviert, unabhängig davon, ob Sie sich mit einem claude.ai-Konto anmelden oder nicht.

250 263

251Ein Name, der sich nur durch einen ähnlich aussehenden Buchstaben aus einem anderen Alphabet unterscheidet, zählt als ein anderer Name, und das `claude.ai sync`-Label ist, wie Sie die beiden unterscheiden. Diese Überprüfungen und Labels erfordern Claude Code v2.1.228 oder später.264* **Ein Skill-Ordner, eine Frontmatter `name`, eine Datei oder ein Unterordner in `.claude/commands/` oder ein [gespeicherter Workflow](/docs/de/workflows#save-the-workflow-for-reuse)**: er wird nicht geladen. Eine [Startup-Benachrichtigung](/docs/de/errors#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) benennt das erste Element zum Umbenennen oder Bearbeiten.

265* **Ein Plugin mit dem Namen `anthropic-skills`**: es wird geladen. Wenn einer seiner Skills und ein synchronisierter Skill beide `<name>` genannt werden, führt `/anthropic-skills:<name>` den synchronisierten Skill aus.

266* **Ein MCP-Server mit dem Namen `anthropic-skills`**: er verbindet sich und seine Tools funktionieren, aber [seine Eingabeaufforderungen erscheinen nicht als Befehle](/docs/de/mcp#use-mcp-prompts-as-commands). Benennen Sie den Server in Ihrer MCP-Konfiguration um, um sie aufzulisten.

252 267

253<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">268<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">

254 Wie Claude Code die Frontmatter eines synchronisierten Skills handhabt269 Wie Claude Code die Frontmatter eines synchronisierten Skills handhabt

257Claude Code wendet zwei Regeln auf die Frontmatter eines synchronisierten Skills an:272Claude Code wendet zwei Regeln auf die Frontmatter eines synchronisierten Skills an:

258 273

259* Claude Code respektiert die Frontmatter in jeder Art von Sitzung, daher geht eine `allowed-tools`-Gewährung durch den normalen [Berechtigungsfluss](/docs/de/permissions).274* Claude Code respektiert die Frontmatter in jeder Art von Sitzung, daher geht eine `allowed-tools`-Gewährung durch den normalen [Berechtigungsfluss](/docs/de/permissions).

260* Claude Code bereinigt den Anzeigetext, den der Skill liefert, wie seine Beschreibung. Es entfernt Steuerzeichen und in Text, der Claude erreicht, wie die Beschreibung, maskiert es auch spitzklammern, damit der Text nicht Claude Codes interne Formatierung imitieren kann. Diese Bereinigung erfordert Claude Code v2.1.228 oder später.275* Claude Code bereinigt den Anzeigetext, den der Skill bereitstellt, wie seine Beschreibung. Es entfernt Steuerzeichen, und in Text, der Claude erreicht, wie die Beschreibung, maskiert es auch spitzklammern, damit der Text Claude Code's interne Formatierung nicht imitieren kann. Diese Bereinigung erfordert Claude Code v2.1.228 oder später.

261 276

262<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">277<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">

263 Wie Claude Code den Body eines synchronisierten Skills handhabt278 Wie Claude Code den Body eines synchronisierten Skills handhabt

264</h4>279</h4>

265 280

266Was Claude Code mit dem Body eines synchronisierten Skills tut, hängt davon ab, wo die Sitzung läuft:281Was Claude Code mit dem Body eines synchronisierten Skills macht, hängt davon ab, wo die Sitzung läuft:

267 282

268* In einer Cloud-Sitzung behält der Body das Verhalten, das ein lokaler Skill hat, da die Sitzung in einem isolierten Container läuft.283* In einer Cloud-Sitzung behält der Body das Verhalten, das ein lokaler Skill hat, da die Sitzung in einem isolierten Container läuft.

269* In einer Cowork-Sitzung auf Ihrem Desktop behält der Body das Verhalten, das ein lokaler Skill hat, außer dass Claude Code jede `!`-Befehlszeile durch den [`disableSkillShellExecution`-Platzhalter](#inject-dynamic-context) ersetzt, wie es für jeden Skill tut, den Sie dort liefern.284* In einer Cowork-Sitzung auf Ihrem Desktop behält der Body das Verhalten, das ein lokaler Skill hat, außer dass Claude Code jede `!`-Befehlszeile durch den [`disableSkillShellExecution`-Platzhalter](#inject-dynamic-context) ersetzt, wie es für jeden Skill tut, den Sie dort bereitstellen.

270* In jeder anderen Sitzung auf Ihrer Maschine führt Claude Code keine [`!`-Befehle](#inject-dynamic-context) aus, hängt nicht die Dateien an, die `@`-Referenzen benennen, wie es für einen lokalen Skill tut, und ersetzt nicht die Platzhalter `${CLAUDE_PROJECT_DIR}` und `${CLAUDE_SESSION_ID}`, daher erreichen die `@`-Referenzen und beide Platzhalter Claude als wörtlicher Text. Eine `!`-Befehlszeile erreicht Claude auch als wörtlicher Text oder als dieser Platzhalter, wenn `disableSkillShellExecution` aktiviert ist. Diese Handhabung erfordert Claude Code v2.1.228 oder später.285* In jeder anderen Sitzung auf Ihrer Maschine führt Claude Code keine [`!`-Befehle](#inject-dynamic-context) aus, hängt nicht die Dateien an, die `@`-Referenzen benennen, wie es für einen lokalen Skill tut, und ersetzt nicht die Platzhalter `${CLAUDE_PROJECT_DIR}` und `${CLAUDE_SESSION_ID}`, daher erreichen die `@`-Referenzen und beide Platzhalter Claude als wörtlicher Text. Eine `!`-Befehlszeile erreicht Claude auch als wörtlicher Text oder als dieser Platzhalter, wenn `disableSkillShellExecution` aktiviert ist. Diese Handhabung erfordert Claude Code v2.1.228 oder später.

271 286

272<h3 id="live-change-detection">287<h3 id="live-change-detection">

273 Bearbeiten Sie einen Skill während einer Sitzung288 Einen Skill während einer Sitzung bearbeiten

274</h3>289</h3>

275 290

276Claude Code überwacht Skill-Verzeichnisse auf Dateiänderungen, außer im [Bare Mode](/docs/de/headless#start-faster-with-bare-mode). Wenn Sie einen Skill unter `~/.claude/skills/`, dem Projekt `.claude/skills/` oder einem `.claude/skills/` in einem `--add-dir`-Verzeichnis hinzufügen, bearbeiten oder entfernen, nimmt Claude Code die Änderung in der aktuellen Sitzung auf, ohne einen Neustart. Wenn Sie ein Top-Level-Skills-Verzeichnis erstellen, das beim Start der Sitzung nicht vorhanden war, starten Sie Claude Code neu, damit es das neue Verzeichnis überwachen kann.291Claude Code überwacht Skill-Verzeichnisse auf Dateiänderungen, außer in [Bare Mode](/docs/de/headless#start-faster-with-bare-mode). Wenn Sie einen Skill unter `~/.claude/skills/`, dem Projekt `.claude/skills/` oder einem `.claude/skills/` in einem `--add-dir`-Verzeichnis hinzufügen, bearbeiten oder entfernen, nimmt Claude Code die Änderung innerhalb der aktuellen Sitzung auf, ohne einen Neustart.

292

293Wenn Sie ein Top-Level-Skills-Verzeichnis erstellen, das beim Start der Sitzung nicht vorhanden war, führen Sie [`/reload-skills`](/docs/de/commands#all-commands) aus, um die Skills zu laden, die Sie dort eingefügt haben. Claude Code überwacht dieses Verzeichnis noch nicht, daher führen Sie `/reload-skills` erneut aus, nachdem Sie später Änderungen dort vornehmen.

277 294

278Die Live-Änderungserkennung deckt nur `SKILL.md`-Text ab. Für einen Skill-Ordner, der auch ein [Plugin](/docs/de/plugins/loading#plugins-shared-through-a-repository) ist, benötigen Änderungen an `hooks/`, `.mcp.json`, `agents/` und `output-styles/` `/reload-plugins`, um wirksam zu werden.295Die Live-Änderungserkennung deckt nur `SKILL.md`-Text ab. Für einen Skill-Ordner, der auch ein [Plugin](/docs/de/plugins/loading#plugins-shared-through-a-repository) ist, benötigen Änderungen an `hooks/`, `.mcp.json`, `agents/` und `output-styles/` `/reload-plugins`, um wirksam zu werden.

279 296

280<h3 id="remove-a-skill">297<h3 id="remove-a-skill">

281 Entfernen Sie einen Skill298 Einen Skill entfernen

282</h3>299</h3>

283 300

284Wie Sie einen Skill entfernen, hängt davon ab, woher er kommt:301Wie Sie einen Skill entfernen, hängt davon ab, woher er kam:

285 302

286* **Persönlicher oder Projekt-Skill**: Löschen Sie das Verzeichnis des Skills, `~/.claude/skills/<skill-name>/` oder `.claude/skills/<skill-name>/`. Claude Code [entfernt ihn aus `/skills` in der aktuellen Sitzung](#live-change-detection); Inhalte, die Claude Code bereits daraus geladen hat, folgen dem [Skill-Content-Lebenszyklus](#skill-content-lifecycle).303* **Persönlicher oder Projekt-Skill**: Löschen Sie das Verzeichnis des Skills, `~/.claude/skills/<skill-name>/` oder `.claude/skills/<skill-name>/`. Claude Code [entfernt ihn aus `/skills` in der aktuellen Sitzung](#live-change-detection); Inhalte, die Claude Code bereits daraus geladen hat, folgen dem [Skill-Content-Lebenszyklus](#skill-content-lifecycle).

287* **Enterprise-Skill**: Ein Administrator löscht das Verzeichnis des Skills aus `.claude/skills/` im [Verzeichnis für verwaltete Einstellungen](/docs/de/managed-settings#delivery-mechanisms), zum Beispiel `/etc/claude-code/.claude/skills/<skill-name>/` auf Linux.304* **Enterprise-Skill**: Ein Administrator löscht das Verzeichnis des Skills aus `.claude/skills/` im [Verzeichnis für verwaltete Einstellungen](/docs/de/managed-settings#delivery-mechanisms), zum Beispiel `/etc/claude-code/.claude/skills/<skill-name>/` auf Linux.

360 377

362| :- | :- | :- |379| :- | :- | :- |

363| `name` | Nein | Anzeigename, der in Fähigkeitsauflistungen angezeigt wird. Standardmäßig der Verzeichnisname. Siehe [Wie eine Fähigkeit ihren Befehlsnamen erhält](#how-a-skill-gets-its-command-name), um zu sehen, wie das Feld mit dem Namen interagiert, den Sie eingeben, um die Fähigkeit aufzurufen. |380| `name` | Nein | Befehlsname, der im `/`-Menü angezeigt wird. Standardmäßig der Verzeichnisname. Siehe [Wie eine Fähigkeit ihren Befehlsnamen erhält](#how-a-skill-gets-its-command-name), um zu sehen, wie das Feld mit dem Namen interagiert, den Sie eingeben, um die Fähigkeit aufzurufen. |

364| `description` | Empfohlen | Was die Fähigkeit tut und wann sie verwendet werden soll. Claude verwendet dies, um zu entscheiden, wann die Fähigkeit angewendet werden soll. Wenn weggelassen, wird die erste nicht leere Zeile des Markdown-Inhalts verwendet. Setzen Sie den wichtigsten Anwendungsfall zuerst: Der kombinierte `description`- und `when_to_use`-Text wird in der Fähigkeitsauflistung auf 1.536 Zeichen gekürzt, um die Kontextnutzung zu reduzieren. |381| `description` | Empfohlen | Was die Fähigkeit tut und wann sie verwendet werden soll. Claude verwendet dies, um zu entscheiden, wann die Fähigkeit angewendet werden soll. Wenn weggelassen, wird die erste nicht leere Zeile des Markdown-Inhalts verwendet. Setzen Sie den wichtigsten Anwendungsfall zuerst: Der kombinierte `description`- und `when_to_use`-Text wird in der Fähigkeitsauflistung auf 1.536 Zeichen gekürzt, um die Kontextnutzung zu reduzieren. |

365| `when_to_use` | Nein | Zusätzlicher Kontext für den Zeitpunkt, zu dem Claude die Fähigkeit aufrufen sollte, z. B. Trigger-Phrasen oder Beispielanfragen. An `description` in der Fähigkeitsauflistung angehängt und zählt zur 1.536-Zeichen-Obergrenze. |382| `when_to_use` | Nein | Zusätzlicher Kontext für den Zeitpunkt, zu dem Claude die Fähigkeit aufrufen sollte, z. B. Trigger-Phrasen oder Beispielanfragen. An `description` in der Fähigkeitsauflistung angehängt und zählt zur 1.536-Zeichen-Obergrenze. |

366| `argument-hint` | Nein | Hinweis, der während der Autovervollständigung angezeigt wird, um erwartete Argumente anzuzeigen. Beispiel: `[issue-number]` oder `[filename] [format]`. |383| `argument-hint` | Nein | Hinweis, der während der Autovervollständigung angezeigt wird, um erwartete Argumente anzuzeigen. Beispiel: `[issue-number]` oder `[filename] [format]`. |

406 Wie eine Fähigkeit ihren Befehlsnamen erhält423 Wie eine Fähigkeit ihren Befehlsnamen erhält

407</h4>424</h4>

408 425

409Der Befehl, den Sie eingeben, um eine Fähigkeit aufzurufen, kommt von dem Ort, an dem die Fähigkeitsdatei lebt, und für Plugin-Fähigkeiten auch vom Frontmatter-Feld `name`. In einer persönlichen oder Projektfähigkeit setzt `name` nur das Anzeigelabel, das in Fähigkeitsauflistungen angezeigt wird, und der Befehl kommt immer noch vom Verzeichnisnamen. In einer Plugin-Fähigkeit setzt `name` das letzte Segment des Befehls und das Plugin-Präfix bleibt bestehen.426Der Befehl, den Sie eingeben, um eine Fähigkeit aufzurufen, kommt von dem Ort, an dem die Fähigkeitsdatei lebt, und für Fähigkeitsverzeichnisse und Plugin-Fähigkeiten auch vom Frontmatter-Feld `name`. In einer persönlichen oder Projektfähigkeit setzt `name` den Befehl, den das `/`-Menü anzeigt und den Sie eingeben, es sei denn, ein anderer Befehl verwendet bereits diesen Namen. Der Verzeichnisname ruft auch die Fähigkeit auf. In einer Plugin-Fähigkeit setzt `name` das letzte Segment des Befehls und das Plugin-Präfix bleibt bestehen.

410 427

411Die folgende Tabelle zeigt, woher der Befehlsname für jedes Layout kommt:428Die folgende Tabelle zeigt, woher der Befehlsname für jedes Layout kommt:

412 429

414| :- | :- | :- |431| :- | :- | :- |

415| Fähigkeitsverzeichnis unter `~/.claude/skills/` oder `.claude/skills/` | Verzeichnisname | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |432| Fähigkeitsverzeichnis unter `~/.claude/skills/` oder `.claude/skills/` | Frontmatter `name` oder der Verzeichnisname | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging`, oder `/deploy` mit `name: deploy` |

416| [Verschachteltes](#where-skills-live) `.claude/skills/`-Verzeichnis, wenn der Name mit einer anderen Fähigkeit kollidiert | Unterverzzeichnisspfad relativ zum Arbeitsverzeichnis, dann der Fähigkeitsverzeichnisname | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |433| [Verschachteltes](#where-skills-live) `.claude/skills/`-Verzeichnis, wenn der Verzeichnisname mit einer anderen Fähigkeit kollidiert | Unterverzzeichnisspfad relativ zum Arbeitsverzeichnis, dann der Fähigkeitsverzeichnisname | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

418| Datei in einem Unterverzeichnis von `.claude/commands/` | Unterverzzeichnisspfad relativ zu `commands/` mit jedem `/` ersetzt durch `:`, dann der Dateiname ohne Erweiterung | `.claude/commands/frontend/component.md` → `/frontend:component` |435| Datei in einem Unterverzeichnis von `.claude/commands/` | Unterverzzeichnisspfad relativ zu `commands/` mit jedem `/` ersetzt durch `:`, dann der Dateiname ohne Erweiterung | `.claude/commands/frontend/component.md` → `/frontend:component` |

419| Plugin `skills/` Unterverzeichnis | Frontmatter `name` oder der Verzeichnisname, mit Namespace durch Plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`, oder `/my-plugin:fancy` mit `name: fancy` |436| Plugin `skills/` Unterverzeichnis | Frontmatter `name` oder der Verzeichnisname, mit Namespace durch Plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`, oder `/my-plugin:fancy` mit `name: fancy` |

439| `$N` | Kurzform für `$ARGUMENTS[N]`, z. B. `$0` für das erste Argument oder `$1` für das zweite. |456| `$N` | Kurzform für `$ARGUMENTS[N]`, z. B. `$0` für das erste Argument oder `$1` für das zweite. |

440| `$name` | Benanntes Argument, das in der [`arguments`](#frontmatter-reference)-Frontmatter-Liste deklariert ist. Namen werden in Reihenfolge Positionen zugeordnet, sodass mit `arguments: [issue, branch]` der Platzhalter `$issue` zum ersten Argument und `$branch` zum zweiten expandiert. |457| `$name` | Benanntes Argument, das in der [`arguments`](#frontmatter-reference)-Frontmatter-Liste deklariert ist. Namen werden in Reihenfolge Positionen zugeordnet, sodass mit `arguments: [issue, branch]` der Platzhalter `$issue` zum ersten Argument und `$branch` zum zweiten expandiert. |

441| `${CLAUDE_SESSION_ID}` | Die aktuelle Sitzungs-ID. Nützlich für Protokollierung, Erstellen von sitzungsspezifischen Dateien oder Korrelation von Fähigkeitsausgabe mit Sitzungen. |458| `${CLAUDE_SESSION_ID}` | Die aktuelle Sitzungs-ID. Nützlich für Protokollierung, Erstellen von sitzungsspezifischen Dateien oder Korrelation von Fähigkeitsausgabe mit Sitzungen. |

442| `${CLAUDE_EFFORT}` | Die aktuelle Aufwandsstufe: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Verwenden Sie dies, um Fähigkeitsanweisungen an die aktive Aufwandseinstellung anzupassen. |459| `${CLAUDE_EFFORT}` | Die aktuelle Aufwandsstufe: `low`, `medium`, `high`, `xhigh` oder `max`. Verwenden Sie dies, um Fähigkeitsanweisungen an die aktive Aufwandseinstellung anzupassen. |

443| `${CLAUDE_SKILL_DIR}` | Das Verzeichnis, das die `SKILL.md`-Datei der Fähigkeit enthält. Für Plugin-Fähigkeiten ist dies das Fähigkeitsunterverzeichnis innerhalb des Plugins, nicht die Plugin-Root. Verwenden Sie dies in Bash-Injektionsbefehlen, um auf Skripte oder Dateien zu verweisen, die mit der Fähigkeit gebündelt sind, unabhängig vom aktuellen Arbeitsverzeichnis. |460| `${CLAUDE_SKILL_DIR}` | Das Verzeichnis, das die `SKILL.md`-Datei der Fähigkeit enthält. Für Plugin-Fähigkeiten ist dies das Fähigkeitsunterverzeichnis innerhalb des Plugins, nicht die Plugin-Root. Verwenden Sie dies in Bash-Injektionsbefehlen, um auf Skripte oder Dateien zu verweisen, die mit der Fähigkeit gebündelt sind, unabhängig vom aktuellen Arbeitsverzeichnis. |

444| `${CLAUDE_PROJECT_DIR}` | Das Projektroot-Verzeichnis. Dies ist der gleiche Pfad, den [Hooks](/docs/de/hooks#reference-scripts-by-path) und MCP-Server als `CLAUDE_PROJECT_DIR` erhalten. Verwenden Sie dies, um auf projektlokale Skripte oder Dateien zu verweisen, z. B. `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, unabhängig davon, wo die Fähigkeit installiert ist. |461| `${CLAUDE_PROJECT_DIR}` | Das Projektroot-Verzeichnis. Dies ist der gleiche Pfad, den [Hooks](/docs/de/hooks#reference-scripts-by-path) und MCP-Server als `CLAUDE_PROJECT_DIR` erhalten. Verwenden Sie dies, um auf projektlokale Skripte oder Dateien zu verweisen, z. B. `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, unabhängig davon, wo die Fähigkeit installiert ist. |

445| `${CLAUDE_PLUGIN_ROOT}` | Das Installationsverzeichnis des Plugins. Wird nur in Plugin-Fähigkeiten ersetzt. Verwenden Sie dies, um auf Skripte oder Dateien zu verweisen, die überall im Plugin gebündelt sind, einschließlich Ressourcen, die zwischen den Plugin-Fähigkeiten geteilt werden. Siehe [Plugin-Umgebungsvariablen](/docs/de/plugins/manifest-reference#environment-variables). |462| `${CLAUDE_PLUGIN_ROOT}` | Das Installationsverzeichnis des Plugins. Wird nur in Plugin-Fähigkeiten ersetzt. Verwenden Sie dies, um auf Skripte oder Dateien zu verweisen, die überall im Plugin gebündelt sind, einschließlich Ressourcen, die zwischen den Plugin-Fähigkeiten geteilt werden. Siehe [Plugin-Umgebungsvariablen](/docs/de/plugins/manifest-reference#environment-variables). |

826Skill(deploy *)843Skill(deploy *)

827```844```

828 845

829Berechtigungssyntax: `Skill(name)` für exakte Übereinstimmung, `Skill(name *)` für Präfix-Übereinstimmung mit beliebigen Argumenten.846Berechtigungssyntax: `Skill(name)` für exakte Übereinstimmung, `Skill(name *)` für Präfix-Übereinstimmung mit beliebigen Argumenten. In einer `allow`-Regel stimmt ein Präfix außerhalb des [für synchronisierte Skills reservierten Namespace](#names-reserved-for-synced-skills) nicht mit den Namen darin überein: `Skill(anthropic *)` deckt nicht `anthropic-skills:pdf` ab.

830 847

831Wenn Ihre `deny`-Regel einen Alias oder einen unqualifizierten Namen anstelle des eigenen Namens des Skills benennt, blockiert Claude Code den Skill trotzdem: Mit `Skill(review)` blockiert es den gebündelten `/code-review` durch seinen `/review`-Alias, und mit `Skill(deploy)` blockiert es einen [verschachtelten Skill](#where-skills-live), der als `apps/web:deploy` aufgelistet ist, durch seinen unqualifizierten Namen. Vor v2.1.260 blockierte Claude Code einen verschachtelten Skill, der unter seinem qualifizierten Namen aufgelistet ist, nicht, wenn die deny-Regel nur den unqualifizierten Namen benannte.848Wenn Ihre `deny`-Regel einen Alias oder einen unqualifizierten Namen anstelle des eigenen Namens des Skills benennt, blockiert Claude Code den Skill trotzdem: Mit `Skill(review)` blockiert es den gebündelten `/code-review` durch seinen `/review`-Alias, und mit `Skill(deploy)` blockiert es einen [verschachtelten Skill](#where-skills-live), der als `apps/web:deploy` aufgelistet ist, durch seinen unqualifizierten Namen. Vor v2.1.260 blockierte Claude Code einen verschachtelten Skill, der unter seinem qualifizierten Namen aufgelistet ist, nicht, wenn die deny-Regel nur den unqualifizierten Namen benannte.

832 849

833Claude Code stimmt einer `allow`-Regel nur gegen den eigenen Namen des Skills und den Namen in Claudes Aufruf ab.850Claude Code stimmt einer `allow`-Regel nur gegen den eigenen Namen des Skills und den Namen in Claudes Aufruf ab.

834 851

852Um einen [synchronisierten Skill](#how-synced-skills-behave) ohne Aufforderung zu genehmigen, benennen Sie ihn in seinem [reservierten Namespace](#names-reserved-for-synced-skills): `Skill(anthropic-skills:pdf)` genehmigt den synchronisierten `pdf`-Skill, und `Skill(anthropic-skills *)` genehmigt jeden synchronisierten Skill.

853

835**Einzelne Skills ausblenden**, indem Sie `disable-model-invocation: true` zu ihrer Frontmatter hinzufügen. Dies entfernt den Skill vollständig aus Claudes Kontext.854**Einzelne Skills ausblenden**, indem Sie `disable-model-invocation: true` zu ihrer Frontmatter hinzufügen. Dies entfernt den Skill vollständig aus Claudes Kontext.

836 855

837<Note>856<Note>

statusline.md +3 −3

Details

175 175

176Claude Code erfasst die Ausgabe Ihres Skripts, anstatt sie direkt mit dem Terminal zu verbinden, daher können `tput cols` und sprachgestützte Breitenerkennung die Terminalgröße nicht von innerhalb des Skripts lesen. Lesen Sie stattdessen die Umgebungsvariablen `COLUMNS` und `LINES`. Claude Code setzt diese auf die aktuellen Terminaldimensionen, bevor Ihr Skript ausgeführt wird.176Claude Code erfasst die Ausgabe Ihres Skripts, anstatt sie direkt mit dem Terminal zu verbinden, daher können `tput cols` und sprachgestützte Breitenerkennung die Terminalgröße nicht von innerhalb des Skripts lesen. Lesen Sie stattdessen die Umgebungsvariablen `COLUMNS` und `LINES`. Claude Code setzt diese auf die aktuellen Terminaldimensionen, bevor Ihr Skript ausgeführt wird.

177 177

178<Note>Die Statuszeile wird lokal ausgeführt und verbraucht keine API-Token. Sie wird vorübergehend während bestimmter UI-Interaktionen ausgeblendet, einschließlich Autovervollständigungsvorschlägen, dem Hilfemenü und Berechtigungsaufforderungen.</Note>178<Note>Die Statuszeile wird lokal ausgeführt und verbraucht keine API-Token. Sie wird vorübergehend während bestimmter UI-Interaktionen ausgeblendet, einschließlich des Hilfemenüs und Berechtigungsaufforderungen.</Note>

179 179

180<h2 id="available-data">180<h2 id="available-data">

181 Verfügbare Daten181 Verfügbare Daten

202| `context_window.current_usage` | Token-Zählungen aus dem letzten API-Aufruf, beschrieben in [Kontextfenster-Felder](#context-window-fields) |202| `context_window.current_usage` | Token-Zählungen aus dem letzten API-Aufruf, beschrieben in [Kontextfenster-Felder](#context-window-fields) |

203| `exceeds_200k_tokens` | Ob die Gesamttoken-Zählung (Eingabe-, Cache- und Ausgabe-Token kombiniert) aus der letzten API-Antwort 200k überschreitet. Dies ist ein fester Schwellenwert unabhängig von der tatsächlichen Kontextfenstergröße. |203| `exceeds_200k_tokens` | Ob die Gesamttoken-Zählung (Eingabe-, Cache- und Ausgabe-Token kombiniert) aus der letzten API-Antwort 200k überschreitet. Dies ist ein fester Schwellenwert unabhängig von der tatsächlichen Kontextfenstergröße. |

205| `effort.level` | Aktueller Reasoning-Aufwand (`low`, `medium`, `high`, `xhigh` oder `max`). Spiegelt den Live-Sitzungswert wider, einschließlich Änderungen von `/effort` während der Sitzung. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Fehlt, wenn das aktuelle Modell den Effort-Parameter nicht unterstützt |205| `effort.level` | Aktueller Reasoning-Aufwand (`low`, `medium`, `high`, `xhigh` oder `max`). Spiegelt den Live-Sitzungswert wider, einschließlich Änderungen von `/effort` während der Sitzung. Fehlt, wenn das aktuelle Modell den Effort-Parameter nicht unterstützt |

207| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | Prozentsatz des 5-Stunden- oder 7-Tage-Ratenlimits verbraucht, von 0 bis 100 |207| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | Prozentsatz des 5-Stunden- oder 7-Tage-Ratenlimits verbraucht, von 0 bis 100 |

208| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Unix-Epochensekunden, wenn das 5-Stunden- oder 7-Tage-Ratenlimit-Fenster zurückgesetzt wird |208| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Unix-Epochensekunden, wenn das 5-Stunden- oder 7-Tage-Ratenlimit-Fenster zurückgesetzt wird |

1166* Unter Windows mit installiertem Git Bash werden Backslashes im `command`-Pfad wahrscheinlich als Escape-Zeichen verarbeitet, bevor das Skript ausgeführt wird. Verwenden Sie Schrägstriche im Pfad. Siehe [Windows-Konfiguration](#windows-configuration).1166* Unter Windows mit installiertem Git Bash werden Backslashes im `command`-Pfad wahrscheinlich als Escape-Zeichen verarbeitet, bevor das Skript ausgeführt wird. Verwenden Sie Schrägstriche im Pfad. Siehe [Windows-Konfiguration](#windows-configuration).

1167* Wenn `disableAllHooks` nach Anwendung der [Einstellungspriorität](/docs/de/hooks#disable-or-remove-hooks) außerhalb verwalteter Einstellungen auf `true` gesetzt ist, führt Claude Code nur eine `statusLine` aus verwalteten Einstellungen aus, und ohne verwaltete `statusLine` ist die Statuszeile deaktiviert. Entfernen Sie die Einstellung oder setzen Sie sie auf `false` in der Datei, die sie setzt, um sie erneut zu aktivieren. Siehe [`disableAllHooks`](/docs/de/settings-reference#disableallhooks).1167* Wenn `disableAllHooks` nach Anwendung der [Einstellungspriorität](/docs/de/hooks#disable-or-remove-hooks) außerhalb verwalteter Einstellungen auf `true` gesetzt ist, führt Claude Code nur eine `statusLine` aus verwalteten Einstellungen aus, und ohne verwaltete `statusLine` ist die Statuszeile deaktiviert. Entfernen Sie die Einstellung oder setzen Sie sie auf `false` in der Datei, die sie setzt, um sie erneut zu aktivieren. Siehe [`disableAllHooks`](/docs/de/settings-reference#disableallhooks).

1168* Wenn Ihre Organisation `allowManagedHooksOnly` in verwalteten Einstellungen setzt, verschwindet Ihre benutzerdefinierte Statuszeile ohne Warnung: Sie können nur eine Statuszeile aus einem `statusLine`-Wert in diesen verwalteten Einstellungen erhalten. Siehe [was unter `allowManagedHooksOnly` ausgeführt wird](/docs/de/settings-reference#what-runs-under-allowmanagedhooksonly) für das vollständige Verhalten, und fragen Sie Ihren Administrator, ob diese Einstellung für Sie gilt.1168* Wenn Ihre Organisation `allowManagedHooksOnly` in verwalteten Einstellungen setzt, verschwindet Ihre benutzerdefinierte Statuszeile ohne Warnung: Sie können nur eine Statuszeile aus einem `statusLine`-Wert in diesen verwalteten Einstellungen erhalten. Siehe [was unter `allowManagedHooksOnly` ausgeführt wird](/docs/de/settings-reference#what-runs-under-allowmanagedhooksonly) für das vollständige Verhalten, und fragen Sie Ihren Administrator, ob diese Einstellung für Sie gilt.

1169* Führen Sie `claude --debug` aus, um den Exit-Code und stderr aus der ersten Statuszeilen-Invokation in einer Sitzung zu protokollieren1169* Führen Sie `claude --debug` aus, um den stderr Ihres Skripts bei jeder Statuszeilen-Invokation zu protokollieren, und seinen Exit-Code bei der ersten Invokation in einer Sitzung

1170* Bitten Sie Claude, Ihre Einstellungsdatei zu lesen und den `statusLine`-Befehl direkt auszuführen, um Fehler zu finden1170* Bitten Sie Claude, Ihre Einstellungsdatei zu lesen und den `statusLine`-Befehl direkt auszuführen, um Fehler zu finden

1171 1171

1172**Statuszeile zeigt `--` oder leere Werte**1172**Statuszeile zeigt `--` oder leere Werte**

sub-agents.md +86 −82

Details

8 8

9Subagenten sind spezialisierte KI-Assistenten, die bestimmte Arten von Aufgaben bearbeiten. Verwenden Sie einen, wenn eine Nebenaufgabe Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten würde, auf die Sie nicht mehr verweisen werden: Der Subagent führt diese Arbeit in seinem eigenen Kontext durch und gibt nur die Zusammenfassung zurück. Definieren Sie einen benutzerdefinierten Subagenten, wenn Sie wiederholt denselben Typ von Worker mit denselben Anweisungen spawnen.9Subagenten sind spezialisierte KI-Assistenten, die bestimmte Arten von Aufgaben bearbeiten. Verwenden Sie einen, wenn eine Nebenaufgabe Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten würde, auf die Sie nicht mehr verweisen werden: Der Subagent führt diese Arbeit in seinem eigenen Kontext durch und gibt nur die Zusammenfassung zurück. Definieren Sie einen benutzerdefinierten Subagenten, wenn Sie wiederholt denselben Typ von Worker mit denselben Anweisungen spawnen.

10 10

11Jeder Subagent läuft in seinem eigenen Kontextfenster mit einem benutzerdefinierten Systemprompt, spezifischem Werkzeugzugriff und unabhängigen Berechtigungen. Wenn Claude auf eine Aufgabe trifft, die der Beschreibung eines Subagenten entspricht, delegiert es an diesen Subagenten, der unabhängig arbeitet und Ergebnisse zurückgibt. Um die Kontexteinsparungen in der Praxis zu sehen, zeigt die [Kontextfenster-Visualisierung](/docs/de/context-window) eine Sitzung, in der ein Subagent Recherchen in seinem eigenen separaten Fenster durchführt.11Jeder Subagent läuft in seinem eigenen Kontextfenster mit einem benutzerdefinierten Systemprompt, spezifischem Werkzeugzugriff und unabhängigen Berechtigungen. Er sendet auch seine eigenen Anfragen, die auf die gleichen [Nutzungslimits](/docs/de/costs#plan-usage-breakdown) wie Ihre Hauptkonversation angerechnet werden. Wenn Claude auf eine Aufgabe trifft, die der Beschreibung eines Subagenten entspricht, delegiert es an diesen Subagenten, der unabhängig arbeitet und Ergebnisse zurückgibt. Um die Kontexteinsparungen in der Praxis zu sehen, zeigt die [Kontextfenster-Visualisierung](/docs/de/context-window) eine Sitzung, in der ein Subagent Recherchen in seinem eigenen separaten Fenster durchführt.

12 12

13<Note>13<Note>

14 Subagenten arbeiten innerhalb einer einzelnen Sitzung. Um viele unabhängige Sitzungen parallel auszuführen und sie von einem Ort aus zu überwachen, siehe [Hintergrund-Agenten](/docs/de/agent-view). Für separate Sitzungen, die Nachrichten aneinander weitergeben, siehe [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging). Für ein koordiniertes Team von Sitzungen, das Claude spawnt und beaufsichtigt, siehe [Agent-Teams](/docs/de/agent-teams).14 Subagenten arbeiten innerhalb einer einzelnen Sitzung. Um viele unabhängige Sitzungen parallel auszuführen und sie von einem Ort aus zu überwachen, siehe [Hintergrund-Agenten](/docs/de/agent-view). Für separate Sitzungen, die Nachrichten aneinander weitergeben, siehe [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging). Für ein koordiniertes Team von Sitzungen, das Claude spawnt und beaufsichtigt, siehe [Agent-Teams](/docs/de/agent-teams).

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232

233Das `--agents`-Flag akzeptiert JSON mit einem `prompt`-Feld plus diese [Frontmatter](#supported-frontmatter-fields)-Felder: `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` und `isolation`. Verwenden Sie `prompt` für den Systemprompt, äquivalent zum Markdown-Body in dateibasierten Subagenten. `color` und `experimental` werden hier nicht akzeptiert und werden ignoriert statt abgelehnt.233Im [nicht-interaktiven Modus](/docs/de/headless) akzeptiert `--agents` auch den Pfad zu einer JSON-Datei, die das gleiche Objekt enthält, für Definitionen, die zu groß sind, um sie in der Befehlszeile zu übergeben. Zum Beispiel liest `claude -p --agents ./agents.json "Review my changes"` die Definitionen aus dieser Datei. In einer interaktiven Sitzung weigert sich Claude Code, einen Dateipfad zu akzeptieren. Die Dateiform erfordert Claude Code v2.1.281 oder später.

234 234

235Jeder Top-Level-Schlüssel im JSON ist der Name des Agenten. Starten Sie einen Namen nicht mit `-`.235Jeder Top-Level-Schlüssel im JSON ist ein Agent-Name, und sein Wert ist die Definition dieses Agenten. Starten Sie einen Namen nicht mit `-`. Eine Definition nimmt diese Felder auf:

236

237* **`prompt`**: Der Systemprompt des Agenten, äquivalent zum Markdown-Body in dateibasierten Subagenten. `prompt` kann leer sein. Wenn Sie einen Agent mit einem leeren `prompt` und ohne `memory`-Feld als Sitzungs-Agent mit `--agent` auswählen, bleibt der Systemprompt der Sitzung unverändert. Ein leerer `prompt` erfordert Claude Code v2.1.281 oder später.

238* **[Frontmatter-Felder](#supported-frontmatter-fields)**: `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` und `isolation`.

239* **Ignorierte Felder**: `color` und `experimental` werden hier nicht akzeptiert und werden ignoriert statt abgelehnt.

236 240

237Für das, was Claude Code mit einem Wert tut, den es nicht laden kann, und die Flags und Umgebungsvariable, die diese Überprüfung überspringen, siehe [`Invalid --agents configuration`](/docs/de/errors#invalid-agents-configuration).241Für das, was Claude Code mit einem Wert tut, den es nicht laden kann, und die Flags und Umgebungsvariable, die diese Überprüfung überspringen, siehe [`Invalid --agents configuration`](/docs/de/errors#invalid-agents-configuration).

238 242

587 Berechtigungsmodi591 Berechtigungsmodi

588</h4>592</h4>

589 593

590Setzen Sie `permissionMode`, um den Berechtigungsmodus zu wählen, in dem ein Subagent läuft. Verwenden Sie die Konfigurationswerte der Modi, daher ist der Manuelle Modus `default`. Wenn Sie ihn nicht setzen, erbt der Subagent den Modus der Hauptkonversation, der als [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) auf Pro-, Max- und Team-Plänen beginnt, es sei denn, Ihre Einstellungen oder Ihre Organisation ändern ihn.594Setzen Sie `permissionMode`, um den Berechtigungsmodus zu wählen, in dem ein Subagent läuft. Verwenden Sie die Konfigurationswerte der Modi, daher ist der Manuelle Modus `default`. Wenn Sie ihn nicht setzen, erbt der Subagent den [Berechtigungsmodus](/docs/de/permission-modes) der Hauptkonversation.

591 595

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

593 597

855</h2>859</h2>

856 860

857<h3 id="understand-automatic-delegation">861<h3 id="understand-automatic-delegation">

858 Automatische Delegierung verstehen862 Automatische Delegation verstehen

859</h3>863</h3>

860 864

861Claude delegiert Aufgaben automatisch basierend auf der Aufgabenbeschreibung in Ihrer Anfrage, dem Feld `description` in Subagenten-Konfigurationen und dem aktuellen Kontext. Um proaktive Delegierung zu fördern, fügen Sie Phrasen wie „use proactively" in das Beschreibungsfeld Ihres Subagenten ein.865Claude delegiert Aufgaben automatisch basierend auf der Aufgabenbeschreibung in Ihrer Anfrage, dem Feld `description` in Subagenten-Konfigurationen und dem aktuellen Kontext. Um proaktive Delegation zu fördern, fügen Sie Phrasen wie „use proactively" in das Beschreibungsfeld Ihres Subagenten ein.

862 866

863Halten Sie Beschreibungen kurz: Claude Code zeigt eine Startwarnmeldung an, wenn die kombinierten Beschreibungen Ihrer Subagenten das [Limit von 15.000 Token](/docs/de/errors#agent-descriptions-are-over-the-15000-token-limit) überschreiten, und lädt dennoch jeden Subagenten.867Halten Sie Beschreibungen kurz: Claude Code zeigt eine Startwarnmeldung an, wenn die kombinierten Beschreibungen Ihrer Subagenten das [Limit von 15.000 Token](/docs/de/errors#agent-descriptions-are-over-the-15000-token-limit) überschreiten, und lädt dennoch jeden Subagenten.

864 868

865Wenn der Subagent in einem [Plugin](/docs/de/plugins/overview) enthalten ist, können Sie messen, wie zuverlässig Claude ihn über realistische Eingabeaufforderungen hinweg delegiert, anstatt sie einzeln zu überprüfen: [`claude plugin eval`](/docs/de/plugin-evals) führt jede Eingabeaufforderung mit und ohne das Plugin aus und bewertet die Ergebnisse.869Wenn der Subagent in einem [Plugin](/docs/de/plugins/overview) enthalten ist, können Sie messen, wie zuverlässig Claude ihn über realistische Prompts hinweg delegiert, anstatt sie einzeln zu überprüfen: [`claude plugin eval`](/docs/de/plugin-evals) führt jeden Prompt mit und ohne das Plugin aus und bewertet die Ergebnisse.

866 870

867<h3 id="invoke-subagents-explicitly">871<h3 id="invoke-subagents-explicitly">

868 Subagenten explizit aufrufen872 Subagenten explizit aufrufen

869</h3>873</h3>

870 874

871Wenn automatische Delegierung nicht ausreicht, können Sie einen Subagenten selbst anfordern. Drei Muster eskalieren von einem einmaligen Vorschlag zu einem sitzungsweiten Standard:875Wenn automatische Delegation nicht ausreicht, können Sie einen Subagenten selbst anfordern. Drei Muster eskalieren von einem einmaligen Vorschlag zu einem sitzungsweiten Standard:

872 876

873* **Natürliche Sprache**: Nennen Sie den Subagenten in Ihrer Eingabeaufforderung; Claude entscheidet, ob delegiert werden soll877* **Natürliche Sprache**: Nennen Sie den Subagenten in Ihrem Prompt; Claude entscheidet, ob delegiert werden soll

874* **@-Erwähnung**: Garantiert, dass der Subagent für eine Aufgabe ausgeführt wird878* **@-Erwähnung**: Garantiert, dass der Subagent für eine Aufgabe ausgeführt wird

875* **Sitzungsweit**: Die gesamte Sitzung verwendet die Systemeingabeaufforderung, Werkzeugbeschränkungen und das Modell dieses Subagenten über das Flag `--agent` oder die Einstellung `agent`879* **Sitzungsweit**: Die gesamte Sitzung verwendet das System-Prompt, die Tool-Einschränkungen und das Modell dieses Subagenten über das Flag `--agent` oder die Einstellung `agent`

876 880

877Für natürliche Sprache gibt es keine spezielle Syntax. Nennen Sie den Subagenten und Claude delegiert normalerweise:881Für natürliche Sprache gibt es keine spezielle Syntax. Nennen Sie den Subagenten und Claude delegiert normalerweise:

878 882

881Have the code-reviewer subagent look at my recent changes885Have the code-reviewer subagent look at my recent changes

882```886```

883 887

884**Erwähnen Sie den Subagenten mit @.** Geben Sie `@` ein und wählen Sie den Subagenten aus der Typvorhersage aus, genauso wie Sie Dateien mit @ erwähnen. Dies stellt sicher, dass dieser spezifische Subagent ausgeführt wird, anstatt die Wahl Claude zu überlassen:888**@-Erwähnen Sie den Subagenten.** Geben Sie `@` ein und wählen Sie den Subagenten aus der Typeahead-Liste aus, genauso wie Sie Dateien @-erwähnen. Dies stellt sicher, dass dieser spezifische Subagent ausgeführt wird, anstatt die Wahl Claude zu überlassen:

885 889

886```text wrap theme={null}890```text wrap theme={null}

887@"code-reviewer (agent)" look at the auth changes891@"code-reviewer (agent)" look at the auth changes

888```892```

889 893

890Ihre vollständige Nachricht geht immer noch an Claude, der die Aufgabeneingabeaufforderung des Subagenten basierend auf Ihrer Anfrage schreibt. Die @-Erwähnung steuert, welcher Subagent Claude aufruft, nicht welche Eingabeaufforderung er erhält.894Ihre vollständige Nachricht geht immer noch an Claude, der das Task-Prompt des Subagenten basierend auf Ihrer Anfrage schreibt. Die @-Erwähnung steuert, welcher Subagent Claude aufruft, nicht welches Prompt er erhält.

891 895

892Subagenten, die von einem aktivierten [Plugin](/docs/de/plugins/overview) bereitgestellt werden, erscheinen in der Typvorhersage unter ihrem Bereichsnamen, z. B. `my-plugin:code-reviewer` oder `my-plugin:review:security`, wenn das Plugin [Agenten in Unterordnern organisiert](#choose-the-subagent-scope). Benannte Hintergrund-Subagenten, die derzeit in der Sitzung ausgeführt werden, erscheinen auch in der Typvorhersage und zeigen ihren Status neben dem Namen an.896Subagenten, die von einem aktivierten [Plugin](/docs/de/plugins/overview) bereitgestellt werden, erscheinen in der Typeahead-Liste unter ihrem scoped Namen, z. B. `my-plugin:code-reviewer` oder `my-plugin:review:security`, wenn das Plugin [Agenten in Unterordnern organisiert](#choose-the-subagent-scope). Benannte Hintergrund-Subagenten, die derzeit in der Sitzung ausgeführt werden, erscheinen auch in der Typeahead-Liste und zeigen ihren Status neben dem Namen.

893 897

894Sie können die Erwähnung auch manuell eingeben, ohne die Auswahl zu verwenden: `@agent-<name>` für lokale Subagenten oder `@agent-` gefolgt vom Bereichsnamen für Plugin-Subagenten, z. B. `@agent-my-plugin:code-reviewer`. Während Sie dieses Formular eingeben, zeigt die Typvorhersage Dateienübereinstimmungen anstelle von Agenten. Die Agent-Erwähnung wird trotzdem aufgelöst, wenn Sie absenden.898Sie können die Erwähnung auch manuell eingeben, ohne den Picker zu verwenden: `@agent-<name>` für lokale Subagenten oder `@agent-` gefolgt vom scoped Namen für Plugin-Subagenten, z. B. `@agent-my-plugin:code-reviewer`. Während Sie dieses Formular eingeben, zeigt die Typeahead-Liste Dateiübereinstimmungen anstelle von Agenten. Die Agent-Erwähnung wird trotzdem aufgelöst, wenn Sie absenden.

895 899

896**Führen Sie die gesamte Sitzung als Subagent aus.** Übergeben Sie [`--agent <name>`](/docs/de/cli-reference), um eine Sitzung zu starten, in der der Hauptthread selbst die Systemeingabeaufforderung, Werkzeugbeschränkungen und das Modell dieses Subagenten übernimmt:900**Führen Sie die gesamte Sitzung als Subagent aus.** Übergeben Sie [`--agent <name>`](/docs/de/cli-reference), um eine Sitzung zu starten, in der der Hauptthread selbst das System-Prompt, die Tool-Einschränkungen und das Modell dieses Subagenten annimmt:

897 901

898```bash theme={null}902```bash theme={null}

899claude --agent code-reviewer903claude --agent code-reviewer

900```904```

901 905

902Die Systemeingabeaufforderung des Subagenten ersetzt die Standard-Claude-Code-Systemeingabeaufforderung vollständig, genauso wie [`--system-prompt`](/docs/de/cli-reference) es tut. `CLAUDE.md`-Dateien und Projektgedächtnis werden immer noch durch den normalen Nachrichtenfluss geladen, auch wenn die Agent-Definition [`omitClaudeMd`](#supported-frontmatter-fields) setzt.906Sofern das Prompt des Agenten nicht [leer ist](#choose-the-subagent-scope), ersetzt das System-Prompt des Subagenten das Standard-Claude-Code-System-Prompt vollständig, genauso wie [`--system-prompt`](/docs/de/cli-reference) es tut. `CLAUDE.md`-Dateien und Projektgedächtnis werden immer noch durch den normalen Nachrichtenfluss geladen, auch wenn die Agent-Definition [`omitClaudeMd`](#supported-frontmatter-fields) setzt.

903 907

904Der Agent-Name erscheint als `@<name>` in der Startkopfzeile, damit Sie bestätigen können, dass er aktiv ist.908Der Agent-Name erscheint als `@<name>` in der Startup-Kopfzeile, damit Sie bestätigen können, dass er aktiv ist.

905 909

906Dies funktioniert mit integrierten und benutzerdefinierten Subagenten, und die Wahl bleibt bestehen, wenn Sie die Sitzung fortsetzen: Claude Code stellt die Werkzeugbeschränkungen und das Modell des Agenten zusammen mit der Konversation wieder her. Wenn der Agent nicht mehr vorhanden ist, wenn Sie fortsetzen, wird die Sitzung mit den Standardwerkzeugen fortgesetzt und zeigt eine [Warnung mit dem Namen des Agenten](/docs/de/errors#session-agent-no-longer-available). Für die Systemeingabeaufforderung in beiden Fällen siehe [Systemeingabeaufforderungs-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations).910Dies funktioniert mit integrierten und benutzerdefinierten Subagenten, und die Wahl bleibt bestehen, wenn Sie die Sitzung fortsetzen: Claude Code stellt die Tool-Einschränkungen und das Modell des Agenten zusammen mit der Konversation wieder her. Wenn der Agent nicht mehr vorhanden ist, wenn Sie fortsetzen, wird die Sitzung mit den Standard-Tools fortgesetzt und zeigt eine [Warnung mit dem Namen des Agenten](/docs/de/errors#session-agent-no-longer-available). Für das System-Prompt in beiden Fällen siehe [System-Prompt-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations).

907 911

908Für einen von einem Plugin bereitgestellten Subagenten können Sie nur den Agent-Namen übergeben und Claude Code findet ihn:912Für einen von einem Plugin bereitgestellten Subagenten können Sie nur den Agent-Namen übergeben und Claude Code findet ihn:

909 913

911claude --agent security-reviewer915claude --agent security-reviewer

912```916```

913 917

914Wenn mehrere Plugins Agenten mit demselben Namen bereitstellen, übergeben Sie den Bereichsnamen zur Disambiguierung:918Wenn mehrere Plugins Agenten mit demselben Namen bereitstellen, übergeben Sie den scoped Namen zur Disambiguierung:

915 919

916```bash theme={null}920```bash theme={null}

917claude --agent my-plugin:security-reviewer921claude --agent my-plugin:security-reviewer

918```922```

919 923

920Wenn das Plugin den Agenten in einem Unterordner seines `agents/`-Verzeichnisses platziert, fügen Sie den Unterordner in den Bereichsnamen ein, z. B. `claude --agent my-plugin:review:security`.924Wenn das Plugin den Agenten in einen Unterordner seines `agents/`-Verzeichnisses platziert, fügen Sie den Unterordner in den scoped Namen ein, z. B. `claude --agent my-plugin:review:security`.

921 925

922Um es zum Standard für jede Sitzung in einem Projekt zu machen, setzen Sie `agent` in `.claude/settings.json`:926Um es zum Standard für jede Sitzung in einem Projekt zu machen, setzen Sie `agent` in `.claude/settings.json`:

923 927

935 939

936Subagenten können im Vordergrund oder im Hintergrund ausgeführt werden:940Subagenten können im Vordergrund oder im Hintergrund ausgeführt werden:

937 941

938* **Vordergrund-Subagenten** blockieren die Hauptkonversation bis zur Fertigstellung. Genehmigungseingabeaufforderungen werden an Sie weitergeleitet, wenn sie auftauchen.942* **Vordergrund-Subagenten** blockieren die Hauptkonversation bis zur Fertigstellung. Genehmigungsprompts werden an Sie weitergeleitet, wenn sie auftauchen.

939* **Hintergrund-Subagenten** werden gleichzeitig ausgeführt, während Sie weiterarbeiten. Wenn ein Hintergrund-Subagent einen Werkzeugaufruf erreicht, der eine Genehmigung benötigt, zeigt Claude Code die Eingabeaufforderung in Ihrer Hauptsitzung an und nennt den Subagenten, der fragt. Genehmigen Sie, um den Subagenten fortsetzen zu lassen, oder drücken Sie Esc, um diesen einen Werkzeugaufruf zu verweigern, ohne den Subagenten zu stoppen.943* **Hintergrund-Subagenten** werden gleichzeitig ausgeführt, während Sie weiterarbeiten. Wenn ein Hintergrund-Subagent einen Tool-Aufruf erreicht, der Genehmigung benötigt, zeigt Claude Code das Prompt in Ihrer Hauptsitzung an und nennt den Subagenten, der fragt. Genehmigen Sie, um den Subagenten fortfahren zu lassen, oder drücken Sie Esc, um diesen einen Tool-Aufruf zu verweigern, ohne den Subagenten zu stoppen.

940 944

941Für jeden Subagenten, den Claude mit dem Agent-Werkzeug spawnt, wählt Claude Code Vordergrund oder Hintergrund aus dem ersten dieser Fälle, der zutrifft:945Für jeden Subagenten, den Claude mit dem Agent-Tool spawnt, wählt Claude Code Vordergrund oder Hintergrund aus dem ersten dieser Fälle, der zutrifft:

942 946

943* Wenn ein In-Process-[Agent-Team](/docs/de/agent-teams#limitations)-Teamkollege den Subagenten spawnte, führt Claude Code ihn im Vordergrund aus. Claude Code weigert sich mit einem Fehler, einen Teamkollegen-Subagenten zu spawnen, dessen Definition [`background: true`](#supported-frontmatter-fields) setzt. Wenn [Fork-Modus](#turn-fork-mode-on-or-off) aus ist und Sie [Hintergrund-Aufgaben nicht ausgeschaltet haben](/docs/de/env-vars), weigert sich Claude Code auch mit einem Fehler, wenn ein Teamkollege `run_in_background: true` setzt.947* Wenn ein In-Process-[Agent-Team](/docs/de/agent-teams#limitations)-Teamkollege den Subagenten spawnte, führt Claude Code ihn im Vordergrund aus. Claude Code weigert sich mit einem Fehler, einen Subagenten eines Teamkollegen zu spawnen, dessen Definition [`background: true`](#supported-frontmatter-fields) setzt. Wenn [Fork-Modus](#turn-fork-mode-on-or-off) aus ist und Sie [Hintergrund-Aufgaben nicht ausgeschaltet haben](/docs/de/env-vars), weigert sich Claude Code auch mit einem Fehler, wenn ein Teamkollege `run_in_background: true` setzt.

944* Wenn Sie [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/de/env-vars) auf `1` setzen, führt Claude Code den Subagenten im Vordergrund aus, in jeder Art von Sitzung und unabhängig davon, ob Fork-Modus an ist.948* Wenn Sie [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/de/env-vars) auf `1` setzen, führt Claude Code den Subagenten im Vordergrund aus, in jeder Art von Sitzung und unabhängig davon, ob Fork-Modus an ist.

945* Wenn [Fork-Modus](#turn-fork-mode-on-or-off) an ist, wie es standardmäßig in einer interaktiven Sitzung der Fall ist, führt Claude Code den Subagenten im Hintergrund aus, sowohl Fork- als auch Non-Fork-Subagenten, und Claude kann nicht den Vordergrund anfordern.949* Wenn [Fork-Modus](#turn-fork-mode-on-or-off) an ist, wie es standardmäßig in einer interaktiven Sitzung der Fall ist, führt Claude Code den Subagenten im Hintergrund aus, sowohl Fork- als auch Non-Fork-Subagenten, und Claude kann nicht den Vordergrund anfordern.

946* Wenn Fork-Modus aus ist, führt Claude den Subagenten standardmäßig im Hintergrund aus und im Vordergrund, wenn er das Ergebnis benötigt, bevor er fortfährt. Fork-Modus ist aus im [nicht-interaktiven Modus](/docs/de/headless) mit `-p` und im Agent SDK, es sei denn, Sie schalten ihn ein. Um einen bestimmten Subagenten im Hintergrund zu halten, auch wenn Claude das Ergebnis möchte, setzen Sie sein Frontmatter-Feld [`background`](#supported-frontmatter-fields) auf `true`.950* Wenn Fork-Modus aus ist, führt Claude den Subagenten standardmäßig im Hintergrund aus und im Vordergrund, wenn er das Ergebnis benötigt, bevor er fortfährt. Fork-Modus ist aus im [Non-Interactive-Modus](/docs/de/headless) mit `-p` und im Agent SDK, sofern Sie ihn nicht einschalten. Um einen bestimmten Subagenten im Hintergrund zu halten, auch wenn Claude das Ergebnis möchte, setzen Sie sein Frontmatter-Feld [`background`](#supported-frontmatter-fields) auf `true`.

947 951

948Für eine Skill mit `context: fork` folgt Claude Code stattdessen den Regeln in [Führen Sie Skills in einem Subagenten aus](/docs/de/skills#run-skills-in-a-subagent), unabhängig davon, ob Fork-Modus an ist.952Für eine Skill mit `context: fork` folgt Claude Code stattdessen den Regeln in [Skills in einem Subagenten ausführen](/docs/de/skills#run-skills-in-a-subagent), unabhängig davon, ob Fork-Modus an ist.

949 953

950Hintergrund-Subagenten werden mit einem [kleineren integrierten Werkzeugsatz](#available-tools) als Vordergrund-Subagenten ausgeführt, außer für Konversations-Forks und [fortgesetzte](#resume-subagents) Vordergrund-Subagenten.954Hintergrund-Subagenten werden mit einem [kleineren integrierten Tool-Set](#available-tools) als Vordergrund-Subagenten ausgeführt, außer für Konversations-Forks und [fortgesetzte](#resume-subagents) Vordergrund-Subagenten.

951 955

952Hintergrund-Subagenten zeigen jede Genehmigungseingabeaufforderung in Ihrer Hauptsitzung an. Wenn Sie eine dieser Eingabeaufforderungen mit einer Wahl beantworten, die über diesen einen Werkzeugaufruf hinausgeht, z. B. eine Genehmigung, die für den Rest der Sitzung gilt, wendet Claude Code Ihre Antwort auf die gesamte Sitzung an, einschließlich Ihrer Hauptkonversation.956Hintergrund-Subagenten zeigen jeden Genehmigungsprompt in Ihrer Hauptsitzung an. Wenn Sie einen dieser Prompts mit einer Wahl beantworten, die über diesen einen Tool-Aufruf hinausgeht, z. B. eine Genehmigung, die für den Rest der Sitzung gilt, wendet Claude Code Ihre Antwort auf die gesamte Sitzung an, einschließlich Ihrer Hauptkonversation.

953 957

954Ein Hintergrund-Subagent kann einen Hintergrund-[Bash- oder PowerShell-Befehl](/docs/de/tools-reference#background-commands) [über das Ende seines Zuges hinaus laufen lassen](/docs/de/interactive-mode#how-backgrounding-works). Wenn dieser Befehl endet, sendet Claude Code dem Subagenten eine Benachrichtigung.958Ein Hintergrund-Subagent kann einen Hintergrund-[Bash- oder PowerShell-Befehl](/docs/de/tools-reference#background-commands) [über das Ende seines Zuges hinaus laufen lassen](/docs/de/interactive-mode#how-backgrounding-works). Wenn dieser Befehl endet, sendet Claude Code dem Subagenten eine Benachrichtigung.

955 959

958Sie können dies auch selbst steuern:962Sie können dies auch selbst steuern:

959 963

960* Wenn Fork-Modus aus ist, bitten Sie Claude, eine Aufgabe im Hintergrund oder im Vordergrund auszuführen964* Wenn Fork-Modus aus ist, bitten Sie Claude, eine Aufgabe im Hintergrund oder im Vordergrund auszuführen

961* Drücken Sie **Strg+B**, um eine laufende Aufgabe in den Hintergrund zu verschieben965* Drücken Sie **Ctrl+B**, um eine laufende Aufgabe in den Hintergrund zu verschieben

962 966

963Claude Code löscht die Zeile eines Hintergrund-Subagenten aus dem Subagenten-Panel unter der Eingabeaufforderungseingabe auf eine von zwei Arten, je nachdem, wie der Subagent endete:967Claude Code löscht die Zeile eines Hintergrund-Subagenten aus dem Subagenten-Panel unter der Prompt-Eingabe auf eine von zwei Arten, je nachdem, wie der Subagent endete:

964 968

965* Wenn ein Subagent erfolgreich beendet wird, entfernt Claude Code seine Zeile sofort und zeigt außer im [Bildschirmlesemodus](/docs/de/accessibility) `/tasks to see subagents` in der Fußzeile für 30 Sekunden an. Führen Sie während dieser 30 Sekunden [`/tasks`](/docs/de/commands) aus und drücken Sie `Enter` auf dem Subagenten, um sein Transkript zu öffnen. Vor v2.1.232 behielt Claude Code die Zeile 30 Sekunden nach Beendigung des Subagenten, genauso wie eine fehlgeschlagene, und zeigte keinen Fußzeilentipp.969* Wenn ein Subagent erfolgreich beendet wird, entfernt Claude Code seine Zeile sofort und zeigt, außer im [Screen-Reader-Modus](/docs/de/accessibility), `/tasks to see subagents` in der Fußzeile für 30 Sekunden an. Während dieser 30 Sekunden führen Sie [`/tasks`](/docs/de/commands) aus und drücken `Enter` auf dem Subagenten, um sein Transkript zu öffnen. Vor v2.1.232 behielt Claude Code die Zeile 30 Sekunden nach Beendigung des Subagenten, genauso wie bei einem fehlgeschlagenen, und zeigte keinen Fußzeilentipp.

966* Wenn ein Subagent fehlschlägt oder Sie ihn stoppen, behält Claude Code seine Zeile 30 Sekunden lang. Um die Zeile schneller zu löschen, wählen Sie sie aus und drücken Sie `x`.970* Wenn ein Subagent fehlschlägt oder Sie ihn stoppen, behält Claude Code seine Zeile für 30 Sekunden. Um die Zeile schneller zu löschen, wählen Sie sie aus und drücken `x`.

967 971

968Ein Hintergrund-Subagent, der abgeschlossen ist, bleibt in [`/tasks`](/docs/de/commands) aufgelistet, als erledigt markiert und unter laufender Arbeit sortiert, für die gleichen 30 Sekunden wie der Fußzeilentipp. Seine Detailansicht bleibt offen, wenn der Subagent beendet wird. Subagenten, die fehlschlagen oder die Sie stoppen, verlassen die Liste. Vor v2.1.208 verließ ein abgeschlossener Subagent die Liste in dem Moment, in dem er beendet wurde, und seine Detailansicht schloss sich.972Ein Hintergrund-Subagent, der abgeschlossen ist, bleibt in [`/tasks`](/docs/de/commands) aufgelistet, als erledigt markiert und unter laufender Arbeit sortiert, für die gleichen 30 Sekunden wie der Fußzeilentipp. Seine Detailansicht bleibt offen, wenn der Subagent beendet wird. Subagenten, die fehlschlagen oder die Sie stoppen, verlassen die Liste. Vor v2.1.208 verließ ein abgeschlossener Subagent die Liste in dem Moment, in dem er beendet wurde, und seine Detailansicht schloss sich.

969 973

971 Subagenten-Namen975 Subagenten-Namen

972</h3>976</h3>

973 977

974Claude kann einem Subagenten einen Namen geben, indem er einen `name`-Parameter beim Agent-Werkzeugaufruf übergibt, und kann dies auch von selbst tun, ohne Sie zuerst zu fragen. Der Name macht den Subagenten adressierbar: Claude kann ihn [nach Abschluss nach Name ansprechen oder fortsetzen](#resume-subagents).978Claude kann einem Subagenten einen Namen geben, indem er einen `name`-Parameter beim Agent-Tool-Aufruf übergibt, und kann dies auch von selbst tun, ohne Sie zuerst zu fragen. Der Name macht den Subagenten adressierbar: Claude kann ihn [nach Abschluss nach Name ansprechen oder fortsetzen](#resume-subagents).

975 979

976In einer interaktiven Sitzung mit aktivierten [Agent-Teams](/docs/de/agent-teams) wird ein Subagent, den Claude aus der Hauptkonversation mit einem `name` spawnt, stattdessen als Teamkollege gestartet, es sei denn, der Aufruf ist ein [Fork](#fork-the-current-conversation) oder übergibt `isolation` beim Aufruf selbst. Ein `isolation`-Wert in der Frontmatter des Subagenten verhindert es nicht, und der Teamkollege wird dann im Arbeitsverzeichnis der Hauptsitzung ausgeführt. Siehe [Wie Claude Agent-Teams startet](/docs/de/agent-teams#how-claude-starts-agent-teams).980In einer interaktiven Sitzung mit aktivierten [Agent-Teams](/docs/de/agent-teams) wird ein Subagent, den Claude aus der Hauptkonversation mit einem `name` spawnt, stattdessen als Teamkollege gestartet, sofern der Aufruf kein [Fork](#fork-the-current-conversation) ist oder `isolation` beim Aufruf selbst übergibt. Ein `isolation`-Wert im Frontmatter des Subagenten verhindert es nicht, und der Teamkollege wird dann im Arbeitsverzeichnis der Hauptsitzung ausgeführt. Siehe [Wie Claude Agent-Teams startet](/docs/de/agent-teams#how-claude-starts-agent-teams).

977 981

978<h3 id="api-errors-in-subagents">982<h3 id="api-errors-in-subagents">

979 API-Fehler in Subagenten983 API-Fehler in Subagenten

980</h3>984</h3>

981 985

982Wenn etwas [die Antwort eines Subagenten mitten im Stream unterbricht](/docs/de/errors#the-response-above-may-be-incomplete), und die teilweise Antwort Text enthält, aber keine Werkzeugaufrufe, fordert Claude Code den Subagenten auf, fortzufahren, anstatt den Lauf zu beenden. Dies geschieht auch in interaktiven Sitzungen. Der Lauf endet beim Fehler nur, wenn diese Fortsetzungen aufgebraucht sind.986Wenn etwas [die Antwort eines Subagenten mitten im Stream unterbricht](/docs/de/errors#the-response-above-may-be-incomplete), und die teilweise Antwort Text enthält, aber keine Tool-Aufrufe, fordert Claude Code den Subagenten auf, fortzufahren, anstatt den Lauf zu beenden. Dies geschieht auch in interaktiven Sitzungen. Der Lauf endet beim Fehler nur, wenn diese Fortsetzungen aufgebraucht sind.

983 987

984Ab v2.1.199 meldet ein Subagent, dessen Lauf bei einem API-Fehler endet, z. B. bei einem Nutzungslimit oder wiederholtem Serverfehler, diesen Fehler an Claude zurück, anstatt den Fehlertext so zurückzugeben, als wären es die Erkenntnisse des Subagenten. Was Claude erhält, hängt davon ab, wo der Subagent lief:988Ab v2.1.199 meldet ein Subagent, dessen Lauf bei einem API-Fehler endet, z. B. bei einem Nutzungslimit oder wiederholtem Serverfehler, diesen Fehler an Claude zurück, anstatt den Fehlertext so zurückzugeben, als wären es die Erkenntnisse des Subagenten. Was Claude erhält, hängt davon ab, wo der Subagent lief:

985 989

986* **Vordergrund**: Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Textausgabe produziert hat, gibt das Agent-Werkzeug diese teilweise Ausgabe mit einer Notiz zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. Ein Subagent, der nichts produziert hat oder dessen einzige Ausgabe Werkzeugaufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/docs/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt von der Fehlerdetail. In v2.1.199 gab ein Ratenlimit, eine Überlastung oder ein Serverfehler, der die Form „nur Werkzeugaufrufe" unterbrach, ein leeres teilweises Ergebnis zurück, das nur die Unterbrechungsnotiz enthielt.990* **Vordergrund**: Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Textausgabe produziert hat, gibt das Agent-Tool diese teilweise Ausgabe mit einer Notiz zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. Ein Subagent, der nichts produziert hat oder dessen einzige Ausgabe Tool-Aufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/docs/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt von der Fehlerdetail. In v2.1.199 gab ein Ratenlimit, eine Überlastung oder ein Serverfehler, der die Form „nur Tool-Aufrufe" unterbrach, ein leeres teilweises Ergebnis zurück, das nur die Unterbrechungsnotiz enthielt.

987* **Hintergrund**: Der Subagent wird als fehlgeschlagen markiert, und die Nachricht, die Claude erhält, wenn er endet, nennt den API-Fehler und enthält die letzte Ausgabe des Subagenten, sodass teilweise Arbeit nicht verloren geht.991* **Hintergrund**: Der Subagent wird als fehlgeschlagen markiert, und die Nachricht, die Claude erhält, wenn er endet, nennt den API-Fehler und enthält die letzte Ausgabe des Subagenten, sodass teilweise Arbeit nicht verloren geht.

988 992

989Wenn Sie eine [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains) konfigurieren und ein Subagent auf einen Fehler trifft, den die Kette abdeckt, z. B. dass sein Modell nicht verfügbar ist, wechselt Claude Code den Subagenten zum ersten Modell in der Kette, das die Anfrage akzeptiert. Der Subagent arbeitet weiter, anstatt beim Fehler zu enden.993Wenn Sie eine [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains) konfigurieren und ein Subagent auf einen Fehler trifft, den die Kette abdeckt, z. B. dass sein Modell nicht verfügbar ist, wechselt Claude Code den Subagenten zum ersten Modell in der Kette, das die Anfrage akzeptiert. Der Subagent arbeitet weiter, anstatt beim Fehler zu enden.

994 Subagenten-Ausgabe-Scanning998 Subagenten-Ausgabe-Scanning

995</h3>999</h3>

996 1000

997Claude Code scannt den endgültigen Bericht jedes Subagenten, bevor Claude ihn liest. Ein Subagent kann Dateien, Webseiten oder Befehlsausgaben gelesen haben, die Sie nie überprüft haben, und Text aus diesen Quellen kann Anweisungen enthalten, die auf die Hauptkonversation abzielen. Der Scan entfernt oder umformuliert niemals etwas; er nimmt zwei Arten von Änderungen vor, die Sie möglicherweise in einem Bericht bemerken:1001Claude Code scannt den abschließenden Bericht jedes Subagenten, bevor Claude ihn liest. Ein Subagent kann Dateien, Webseiten oder Befehlsausgaben gelesen haben, die Sie nie überprüft haben, und Text aus diesen Quellen kann Anweisungen enthalten, die auf die Hauptkonversation abzielen. Der Scan entfernt oder umformuliert niemals etwas; er nimmt zwei Arten von Änderungen vor, die Sie in einem Bericht bemerken können:

998 1002

999* **Backslash-Einfügung**: Der Scan fügt einen Backslash in Text ein, der Claude Codes eigene Ausgabe imitiert, z. B. ein `<system-reminder>`-Tag oder eine Zeile, die mit `Human:` oder `Assistant:` beginnt, damit die Imitation als gewöhnlicher Text gelesen wird, anstatt als Teil der Konversation verwechselt zu werden.1003* **Backslash-Einfügung**: Der Scan fügt einen Backslash in Text ein, der die eigene Ausgabe von Claude Code imitiert, z. B. ein `<system-reminder>`-Tag oder eine Zeile, die mit `Human:` oder `Assistant:` beginnt, damit die Imitation als gewöhnlicher Text gelesen wird, anstatt als Teil der Konversation verwechselt zu werden.

1000* **Marker-Zeile**: Der Scan stellt eine Zeile voran, die mit `[harness: subagent output matched instruction-shaped pattern(s):` beginnt, wenn der Bericht ein Tag wie `<system-reminder>` imitiert oder Genehmigungseinstellungen wie `bypassPermissions` oder `--dangerously-skip-permissions` erwähnt. Genehmigungseinstellungs-Erwähnungen erhalten die Marker-Zeile, aber der Text selbst bleibt wie geschrieben.1004* **Marker-Zeile**: Der Scan stellt eine Zeile voran, die mit `[harness: subagent output matched instruction-shaped pattern(s):` beginnt, wenn der Bericht ein Tag wie `<system-reminder>` imitiert oder Genehmigungseinstellungen wie `bypassPermissions` oder `--dangerously-skip-permissions` erwähnt. Genehmigungseinstellungs-Erwähnungen erhalten die Marker-Zeile, aber der Text selbst bleibt wie geschrieben.

1001 1005

1002Der Scan beurteilt nicht, ob Inhalte bösartig sind, und er ändert nicht, was eine Anweisung in einem Bericht tun kann: Ein Werkzeugaufruf, zu dem der Bericht Claude führt, durchläuft immer noch die [Genehmigungsprüfungen](/docs/de/permissions) und [Sandboxing](/docs/de/sandboxing) der Sitzung. Es ist kein Ersatz für [Einschränkung, was ein Subagent erreichen kann](#control-subagent-capabilities).1006Der Scan beurteilt nicht, ob Inhalte bösartig sind, und er ändert nicht, was eine Anweisung in einem Bericht tun kann: Ein Tool-Aufruf, zu dem der Bericht Claude führt, durchläuft immer noch die [Genehmigungsprüfungen](/docs/de/permissions) und [Sandboxing](/docs/de/sandboxing) der Sitzung. Es ist kein Ersatz für [Einschränkung dessen, was ein Subagent erreichen kann](#control-subagent-capabilities).

1003 1007

1004Ein Bericht, der zu Claude als Ergebnis des Subagenten zurückkehrt, kommt auch unter einer Kopfzeile an, die ihn als Subagenten-Ausgabe kennzeichnet. Die Kopfzeile besagt, dass Anweisungen oder Genehmigungsansprüche im Bericht die Worte des Subagenten sind und keine Autorität von Ihnen tragen.1008Ein Bericht, der an Claude als Ergebnis des Subagenten zurückkommt, kommt auch unter einer Kopfzeile an, die ihn als Subagenten-Ausgabe kennzeichnet. Die Kopfzeile besagt, dass Anweisungen oder Genehmigungsansprüche im Bericht die Worte des Subagenten sind und keine Autorität von Ihnen tragen.

1005 1009

1006Ein [Hintergrund-Subagenten-Bericht](#run-subagents-in-foreground-or-background) kommt in einer Abschlussbenachrichtigung an, die als automatisiertes Ereignis gekennzeichnet ist, anstatt als Nachricht von Ihnen.1010Ein [Hintergrund-Subagenten-Bericht](#run-subagents-in-foreground-or-background) kommt in einer Abschlussbenachrichtigung an, die als automatisiertes Ereignis gekennzeichnet ist, anstatt als Nachricht von Ihnen.

1007 1011

1017 Isolieren Sie hochvolumige Operationen1021 Isolieren Sie hochvolumige Operationen

1018</h4>1022</h4>

1019 1023

1020Eine der effektivsten Verwendungen für Subagenten ist die Isolierung von Operationen, die große Mengen an Ausgabe produzieren. Das Ausführen von Tests, das Abrufen von Dokumentation oder das Verarbeiten von Protokolldateien kann erheblichen Kontext verbrauchen. Durch die Delegierung dieser an einen Subagenten bleibt die ausführliche Ausgabe im Kontext des Subagenten, während nur die relevante Zusammenfassung zu Ihrer Hauptkonversation zurückkehrt.1024Eine der effektivsten Verwendungen für Subagenten ist die Isolierung von Operationen, die große Mengen an Ausgabe produzieren. Das Ausführen von Tests, das Abrufen von Dokumentation oder die Verarbeitung von Protokolldateien kann erheblichen Kontext verbrauchen. Durch die Delegierung an einen Subagenten bleibt die ausführliche Ausgabe im Kontext des Subagenten, während nur die relevante Zusammenfassung zu Ihrer Hauptkonversation zurückkehrt.

1021 1025

1022```text wrap theme={null}1026```text wrap theme={null}

1023Use a subagent to run the test suite and report only the failing tests with their error messages1027Use a subagent to run the test suite and report only the failing tests with their error messages

1033Research the authentication, database, and API modules in parallel using separate subagents1037Research the authentication, database, and API modules in parallel using separate subagents

1034```1038```

1035 1039

1036Jeder Subagent erkundet seinen Bereich unabhängig, dann synthetisiert Claude die Erkenntnisse. Dies funktioniert am besten, wenn die Forschungspfade nicht voneinander abhängen.1040Jeder Subagent erkundet seinen Bereich unabhängig, dann synthetisiert Claude die Erkenntnisse. Dies funktioniert am besten, wenn die Recherchepfade nicht voneinander abhängen.

1037 1041

1038<Warning>1042<Warning>

1039 Wenn Subagenten abgeschlossen sind, kehren ihre Ergebnisse zu Ihrer Hauptkonversation zurück. Das Ausführen vieler Subagenten, die jeweils detaillierte Ergebnisse zurückgeben, kann erheblichen Kontext verbrauchen.1043 Wenn Subagenten abgeschlossen sind, kehren ihre Ergebnisse zu Ihrer Hauptkonversation zurück. Das Ausführen vieler Subagenten, die jeweils detaillierte Ergebnisse zurückgeben, kann erheblichen Kontext verbrauchen, und jeder Subagent gibt Token aus, während er läuft.

1040</Warning>1044</Warning>

1041 1045

1042Für Arbeit, die parallel weiterläuft oder nicht in ein Kontextfenster passt, führen Sie sie in [separaten Sitzungen](/docs/de/agents) aus und lassen Sie Claude [Erkenntnisse zwischen ihnen weitergeben](/docs/de/cross-session-messaging).1046Für Arbeit, die parallel laufen muss oder nicht in ein Kontextfenster passt, führen Sie sie in [separaten Sitzungen](/docs/de/agents) aus und lassen Sie Claude [Erkenntnisse zwischen ihnen weitergeben](/docs/de/cross-session-messaging).

1043 1047

1044<h4 id="chain-subagents">1048<h4 id="chain-subagents">

1045 Verketten Sie Subagenten1049 Verketten Sie Subagenten

1060* Die Aufgabe häufiges Hin und Her oder iterative Verfeinerung benötigt1064* Die Aufgabe häufiges Hin und Her oder iterative Verfeinerung benötigt

1061* Mehrere Phasen teilen erheblichen Kontext, z. B. Planung, Implementierung und Tests1065* Mehrere Phasen teilen erheblichen Kontext, z. B. Planung, Implementierung und Tests

1062* Sie eine schnelle, gezielte Änderung vornehmen1066* Sie eine schnelle, gezielte Änderung vornehmen

1063* Latenz wichtig ist. Ein Subagent, der kein [Fork](#fork-the-current-conversation) ist, startet von vorne und benötigt möglicherweise Zeit, um Kontext zu sammeln1067* Latenz ist wichtig. Ein Subagent, der kein [Fork](#fork-the-current-conversation) ist, startet von vorne und benötigt möglicherweise Zeit, um Kontext zu sammeln

1064 1068

1065Verwenden Sie **Subagenten**, wenn:1069Verwenden Sie **Subagenten**, wenn:

1066 1070

1067* Die Aufgabe ausführliche Ausgabe produziert, die Sie nicht in Ihrem Hauptkontext benötigen1071* Die Aufgabe ausführliche Ausgabe produziert, die Sie nicht in Ihrem Hauptkontext benötigen

1068* Sie spezifische Werkzeugbeschränkungen oder Genehmigungen erzwingen möchten1072* Sie spezifische Tool-Einschränkungen oder Genehmigungen durchsetzen möchten

1069* Die Arbeit in sich geschlossen ist und eine Zusammenfassung zurückgeben kann1073* Die Arbeit in sich geschlossen ist und eine Zusammenfassung zurückgeben kann

1070 1074

1071Erwägen Sie stattdessen [Skills](/docs/de/skills), wenn Sie wiederverwendbare Eingabeaufforderungen oder Workflows möchten, die im Hauptkonversationskontext ausgeführt werden, anstatt in isoliertem Subagenten-Kontext.1075Erwägen Sie stattdessen [Skills](/docs/de/skills), wenn Sie wiederverwendbare Prompts oder Workflows möchten, die im Hauptkonversations-Kontext ausgeführt werden, anstatt in isoliertem Subagenten-Kontext.

1072 1076

1073Für eine Frage zu etwas, das bereits in Ihrer Konversation vorhanden ist, verwenden Sie [`/btw`](/docs/de/interactive-mode#side-questions-with-%2Fbtw) anstelle eines Subagenten. Es sieht Ihren vollständigen Kontext, hat aber keinen Werkzeugzugriff, und die Antwort wird nicht zur Historie hinzugefügt.1077Für eine Frage zu etwas, das bereits in Ihrer Konversation ist, verwenden Sie stattdessen [`/btw`](/docs/de/interactive-mode#side-questions-with-%2Fbtw). Es sieht Ihren vollständigen Kontext, hat aber keinen Tool-Zugriff, und die Antwort wird nicht zur Historie hinzugefügt.

1074 1078

1075<h3 id="let-subagents-spawn-their-own-subagents">1079<h3 id="let-subagents-spawn-their-own-subagents">

1076 Lassen Sie Subagenten ihre eigenen Subagenten spawnen1080 Lassen Sie Subagenten ihre eigenen Subagenten spawnen

1077</h3>1081</h3>

1078 1082

1079Standardmäßig kann ein Subagent seine eigenen Subagenten spawnen, bis zu drei Ebenen unter der Hauptkonversation. Bei der Tiefengrenze entzieht Claude Code das `Agent`-Werkzeug jedem Subagenten außer einem [Fork](#fork-the-current-conversation), sodass ein Subagent bei der Grenze seine delegierte Arbeit selbst erledigt und eine Zusammenfassung zurückgibt. Ein Fork bei der Grenze behält `Agent` in seiner geerbten Werkzeugliste, aber das Werkzeug gibt stattdessen einen Fehler zurück.1083Standardmäßig kann ein Subagent seine eigenen Subagenten spawnen, bis zu drei Ebenen unter der Hauptkonversation. Bei der Tiefenbegrenzung entzieht Claude Code das `Agent`-Tool jedem Subagenten außer einem [Fork](#fork-the-current-conversation), sodass ein Subagent bei der Grenze seine delegierte Arbeit selbst erledigt und eine Zusammenfassung zurückgibt. Ein Fork bei der Grenze behält `Agent` in seiner geerbten Tool-Liste, aber das Tool gibt stattdessen einen Fehler zurück, anstatt zu spawnen.

1080 1084

1081Verschachtelte Subagenten eignen sich für eine delegierte Aufgabe, die sich selbst in parallele Unteraufgaben aufteilt, z. B. ein Reviewer-Subagent, der einen Verifizierer pro Befund versendet. In einer interaktiven Sitzung kehrt nur die Zusammenfassung des Top-Level-Subagenten zu Ihnen zurück und die Zwischenausgabe bleibt aus Ihrer Hauptkonversation: Ein Subagent, der Hintergrund-Subagenten startet, wartet auf deren Ergebnisse, bevor er beendet wird. Im [nicht-interaktiven Modus](/docs/de/headless) und dem Agent SDK wartet der startende Subagent nicht, sodass ein verschachtelter Hintergrund-Subagent, der beendet wird, nachdem sein Starter beendet wurde, stattdessen an Ihre Hauptkonversation meldet.1085Verschachtelte Subagenten eignen sich für eine delegierte Aufgabe, die sich selbst in parallele Unteraufgaben aufteilt, z. B. ein Reviewer-Subagent, der einen Verifier pro Befund versendet. In einer interaktiven Sitzung kehrt nur die Zusammenfassung des Top-Level-Subagenten zu Ihnen zurück und die Zwischenausgabe bleibt aus Ihrer Hauptkonversation: Ein Subagent, der Hintergrund-Subagenten startet, wartet auf deren Ergebnisse, bevor er beendet wird. Im [Non-Interactive-Modus](/docs/de/headless) und dem Agent SDK wartet der startende Subagent nicht, sodass ein verschachtelter Hintergrund-Subagent, der nach seinem Starter endet, stattdessen an Ihre Hauptkonversation meldet.

1082 1086

1083Um die Grenze zu ändern, setzen Sie [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/de/env-vars) auf die Anzahl der Subagenten-Ebenen, die Sie unter Ihrer Hauptkonversation möchten. Beispielsweise begrenzt dieser Eintrag in [`settings.json`](/docs/de/settings) die Verschachtelung auf zwei Ebenen:1087Um die Grenze zu ändern, setzen Sie [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/de/env-vars) auf die Anzahl der Subagenten-Ebenen, die Sie unter Ihrer Hauptkonversation möchten. Beispielsweise begrenzt dieser Eintrag in [`settings.json`](/docs/de/settings) die Verschachtelung auf zwei Ebenen:

1084 1088

1092 1096

1093Mit diesem Wert können Ihre Subagenten an eine zweite Ebene ihrer eigenen delegieren, und diese zweite Ebene kann nicht weiter delegieren. Setzen Sie `1`, um Verschachtelung auszuschalten.1097Mit diesem Wert können Ihre Subagenten an eine zweite Ebene ihrer eigenen delegieren, und diese zweite Ebene kann nicht weiter delegieren. Setzen Sie `1`, um Verschachtelung auszuschalten.

1094 1098

1095Ein verschachtelter Subagent wird genauso konfiguriert wie ein Top-Level-Subagent und wird aus denselben [Bereichen](#choose-the-subagent-scope) aufgelöst. Um zu verhindern, dass ein Subagent spawnt, während Verschachtelung an ist, z. B. ein Reviewer, der schreibgeschützt bleiben sollte, lassen Sie `Agent` aus seiner [`tools`](#available-tools)-Liste weg oder fügen Sie es zu `disallowedTools` hinzu.1099Ein verschachtelter Subagent wird genauso konfiguriert wie ein Top-Level-Subagent und wird aus denselben [Scopes](#choose-the-subagent-scope) aufgelöst. Um zu verhindern, dass ein Subagent spawnt, während Verschachtelung an ist, z. B. ein Reviewer, der schreibgeschützt bleiben sollte, lassen Sie `Agent` aus seiner [`tools`](#available-tools)-Liste weg oder fügen Sie es zu `disallowedTools` hinzu.

1096 1100

1097Claude Code zeigt verschachtelte Subagenten als Baum im Subagenten-Panel unter der Eingabeaufforderungseingabe an und markiert jede Zeile, die noch Nachkommen hat, mit einer `(+N)`-Anzahl von ihnen. Öffnen Sie eine Zeile, um die Geschwister und direkten Kinder dieses Subagenten mit einem Pfad zurück zu `main` zu sehen.1101Im Terminal zeigt Claude Code verschachtelte Subagenten als Baum im Subagenten-Panel unter der Prompt-Eingabe an und markiert jede Zeile, die immer noch Nachkommen im Panel hat, mit einer `(+N)`-Anzahl von ihnen. Öffnen Sie eine Zeile, um die Geschwister und direkten Kinder dieses Subagenten mit einem Pfad zurück zu `main` zu sehen.

1098 1102

1099<Note>1103<Note>

1100 Frühere Versionen verwendeten unterschiedliche Standards:1104 Frühere Versionen verwendeten unterschiedliche Standards:

1101 1105

1102 * **v2.1.172 bis v2.1.216**: Subagenten konnten standardmäßig verschachtelt werden, bis zu fünf Ebenen tief, und die Grenze konnte nicht geändert werden.1106 * **v2.1.172 bis v2.1.216**: Subagenten konnten standardmäßig verschachtelt werden, bis zu fünf Ebenen tief, und die Grenze konnte nicht geändert werden.

1103 * **v2.1.217 bis v2.1.218**: Die Grenze betrug standardmäßig eins, sodass ein Subagent nicht seine eigenen spawnen konnte, es sei denn, Sie erhöhten sie; v2.1.219 erhöhte den Standard auf drei.1107 * **v2.1.217 bis v2.1.218**: Die Grenze betrug standardmäßig eins, sodass ein Subagent nicht seine eigenen spawnen konnte, sofern Sie sie nicht erhöhten; v2.1.219 erhöhte den Standard auf drei.

1104</Note>1108</Note>

1105 1109

1106<h3 id="concurrent-subagent-limit">1110<h3 id="concurrent-subagent-limit">

1107 Gleichzeitiges Subagenten-Limit1111 Gleichzeitige Subagenten-Grenze

1108</h3>1112</h3>

1109 1113

1110Zwei Grenzen steuern die Subagenten-Nutzung, jede mit ihrer eigenen Variablen: Diese stoppt Claude daran, mehr Subagenten zu spawnen, während zu viele laufen, und die [Tiefengrenze](#let-subagents-spawn-their-own-subagents) begrenzt, wie tief Subagenten verschachtelt sind. Es gibt keine Grenze für die Gesamtzahl der Subagenten, die Claude über eine Sitzung spawnen kann.1114Zwei Grenzen steuern die Subagenten-Nutzung, jede mit ihrer eigenen Variablen: Diese stoppt Claude daran, mehr Subagenten zu spawnen, während zu viele laufen, und die [Tiefenbegrenzung](#let-subagents-spawn-their-own-subagents) begrenzt, wie tief Subagenten verschachtelt sind. Es gibt keine Grenze für die Gesamtzahl der Subagenten, die Claude über eine Sitzung hinweg spawnen kann.

1111 1115

1112Standardmäßig schlägt das Spawnen eines anderen mit dem Agent-Werkzeug fehl, wenn 20 Subagenten in einer Sitzung laufen, mit `Concurrent subagent limit reached`, und der Fehler teilt Claude mit, nicht zu wiederholen. Das Spawnen ist erfolgreich, wenn die laufende Anzahl unter die Grenze fällt. Um die Grenze zu ändern, setzen Sie [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/de/env-vars) auf eine beliebige positive ganze Zahl. Sitzungen mit aktivem [ultracode](/docs/de/model-config#adjust-effort-level) sind ausgenommen: Die Grenze wird dort nicht erzwungen. Erfordert Claude Code v2.1.217 oder später.1116Standardmäßig schlägt das Spawnen eines anderen mit dem Agent-Tool fehl mit `Concurrent subagent limit reached`, wenn 20 Subagenten in einer Sitzung laufen, und der Fehler teilt Claude mit, nicht zu wiederholen. Das Spawnen gelingt wieder, wenn die laufende Anzahl unter die Grenze fällt. Um die Grenze zu ändern, setzen Sie [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/de/env-vars) auf eine beliebige positive ganze Zahl. Sitzungen mit aktivem [ultracode](/docs/de/model-config#adjust-effort-level) sind ausgenommen: Die Grenze wird dort nicht durchgesetzt. Erfordert Claude Code v2.1.217 oder später.

1113 1117

1114Die Grenze blockiert nur Subagenten, die Claude mit dem Agent-Werkzeug spawnt, aber andere Läufe belegen die gleichen Slots:1118Die Grenze blockiert nur Subagenten, die Claude mit dem Agent-Tool spawnt, aber andere Läufe belegen die gleichen Slots:

1115 1119

1116* Ein In-Session-Fork, den Sie mit [`/subtask`](#fork-the-current-conversation) starten, belegt einen Slot während der Ausführung und wird niemals durch die Grenze blockiert.1120* Ein In-Session-Fork, den Sie mit [`/subtask`](#fork-the-current-conversation) starten, belegt einen Slot, während er läuft, und wird niemals durch die Grenze blockiert.

1117* [Fortsetzen eines Subagenten](#resume-subagents), der bereits beendet ist, belegt einen neuen Slot, ohne die Grenze zu überprüfen, sodass Fortsetzungen die laufende Anzahl über die Grenze hinaus drücken können.1121* [Fortsetzen eines Subagenten](#resume-subagents), der bereits beendet wurde, belegt einen frischen Slot, ohne die Grenze zu überprüfen, sodass Fortsetzungen die laufende Anzahl über sie hinaus drücken können.

1118 1122

1119Agenten, die andere Funktionen ausführen, z. B. [Workflow](/docs/de/workflows)-Agenten und [Agent-Team](/docs/de/agent-teams)-Teamkollegen, folgen stattdessen ihren eigenen Grenzen.1123Agenten, die andere Features ausführen, z. B. [Workflow](/docs/de/workflows)-Agenten und [Agent-Team](/docs/de/agent-teams)-Teamkollegen, folgen stattdessen ihren eigenen Grenzen.

1120 1124

1121<h3 id="manage-subagent-context">1125<h3 id="manage-subagent-context">

1122 Verwalten Sie den Subagenten-Kontext1126 Verwalten Sie den Subagenten-Kontext

1130 1134

1131Der anfängliche Kontext eines Non-Fork-Subagenten enthält:1135Der anfängliche Kontext eines Non-Fork-Subagenten enthält:

1132 1136

1133* **Systemeingabeaufforderung**: die eigene Eingabeaufforderung des Agenten plus Umgebungsdetails, die Claude Code anfügt, nicht die Claude-Code-Systemeingabeaufforderung. Benutzerdefinierte Subagenten definieren ihre im [Markdown-Body](#write-subagent-files) oder im Feld `prompt`. Integrierte Agenten haben vordefinierte Eingabeaufforderungen.1137* **System-Prompt**: das eigene Prompt des Agenten plus Umgebungsdetails, die Claude Code anfügt, nicht das Claude-Code-System-Prompt. Benutzerdefinierte Subagenten definieren ihres im [Markdown-Body](#write-subagent-files) oder im Feld `prompt`. Integrierte Agenten haben vordefinierte Prompts.

1134* **Aufgabennachricht**: die Delegierungseingabeaufforderung, die Claude schreibt, wenn es die Arbeit übergibt.1138* **Task-Nachricht**: das Delegierungs-Prompt, das Claude schreibt, wenn es die Arbeit übergibt.

1135* **CLAUDE.md-Dateien**: jede Ebene der [CLAUDE.md-Hierarchie](/docs/de/memory#how-claude-md-files-load), die die Hauptkonversation lädt, einschließlich `~/.claude/CLAUDE.md`, Projektregeln, `CLAUDE.local.md`, verwaltete Richtliniendateien und alle [`AGENTS.md`-Dateien](/docs/de/memory#agents-md), die als Projektanweisungen geladen werden. Die integrierten Explore- und Plan-Agenten überspringen dies. Ein Subagent, dessen Definition [`omitClaudeMd`](#supported-frontmatter-fields) setzt, lädt nur die verwalteten Richtliniendateien oder gar keine, wenn die Definition aus [verwalteten Einstellungen](#choose-the-subagent-scope) stammt.1139* **CLAUDE.md-Dateien**: jede Ebene der [CLAUDE.md-Hierarchie](/docs/de/memory#how-claude-md-files-load), die die Hauptkonversation lädt, einschließlich `~/.claude/CLAUDE.md`, Projektregeln, `CLAUDE.local.md`, verwaltete Richtliniendateien und alle [`AGENTS.md`-Dateien](/docs/de/memory#agents-md), die als Projektanweisungen geladen werden. Die integrierten Explore- und Plan-Agenten überspringen dies. Ein Subagent, dessen Definition [`omitClaudeMd`](#supported-frontmatter-fields) setzt, lädt nur die verwalteten Richtliniendateien oder gar keine, wenn die Definition aus [verwalteten Einstellungen](#choose-the-subagent-scope) kommt.

1136* **Git-Status**: Ein Snapshot, der zu Beginn der übergeordneten Sitzung aufgenommen wurde. Fehlt, wenn das Arbeitsverzeichnis kein Git-Repository ist oder wenn [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions) `false` ist. Explore und Plan überspringen es unabhängig davon.1140* **Git-Status**: Ein Snapshot, den Claude Code aus Ihrem Repository liest, wenn der Subagent startet. Abwesend außerhalb eines Git-Repositorys oder wenn der Snapshot ausgeschaltet ist; siehe [`includeGitInstructions`](/docs/de/settings-reference#includegitinstructions). Explore und Plan überspringen es unabhängig davon.

1137* **Vorgeladene Skills**: Vollständiger Inhalt jeder Skill, die im Feld [`skills`](#preload-skills-into-subagents) des Agenten benannt ist. Integrierte Agenten laden Skills nicht vor.1141* **Vorgeladene Skills**: Vollständiger Inhalt jeder Skill, die im Feld [`skills`](#preload-skills-into-subagents) des Agenten benannt ist. Integrierte Agenten laden Skills nicht vor.

1138* **Geschwister-Roster**: Eine Systemerinnerung, die `main` und jeden anderen benannten Agenten in der Sitzung auflistet, jeweils ein gültiger `to`-Wert für [`SendMessage`](#resume-subagents). Erfordert Claude Code v2.1.206 oder später. Das Roster erscheint nur, wenn die Tools des Subagenten `SendMessage` enthalten und mindestens ein anderer Agent einen Namen hat, ob Claude ihn beim Spawnen benannt hat oder er als [Agent-Team](/docs/de/agent-teams)-Teamkollege läuft. Es ist ein Snapshot, der aufgenommen wird, wenn der Subagent startet, sodass später benannte Agenten nicht erscheinen.1142* **Geschwister-Roster**: Eine [System-Erinnerung](/docs/de/glossary#system-reminder), die `main` und jeden anderen benannten Agenten in der Sitzung auflistet, jeweils ein gültiger `to`-Wert für [`SendMessage`](#resume-subagents). Erfordert Claude Code v2.1.206 oder später. Das Roster erscheint nur, wenn die Tools des Subagenten `SendMessage` enthalten und mindestens ein anderer Agent einen Namen hat, ob Claude ihn beim Spawnen benannt hat oder er als [Agent-Team](/docs/de/agent-teams)-Teamkollege läuft. Es ist ein Snapshot, der beim Start des Subagenten aufgenommen wird, sodass später benannte Agenten nicht erscheinen.

1139 1143

1140Um einen Ihrer eigenen Subagenten ohne die Benutzer-, Projekt- und lokalen CLAUDE.md-Dateien zu starten, setzen Sie [`omitClaudeMd: true`](#supported-frontmatter-fields) in seiner Frontmatter oder `--agents` JSON.1144Um einen Ihrer eigenen Subagenten ohne den Benutzer, das Projekt und die lokalen CLAUDE.md-Dateien zu starten, setzen Sie [`omitClaudeMd: true`](#supported-frontmatter-fields) in sein Frontmatter oder `--agents` JSON.

1141 1145

1142Die Hauptkonversation hat immer noch Ihre vollständige CLAUDE.md, wenn sie die Ergebnisse dieser Subagenten liest, sodass die meisten Regeln den Subagenten selbst nicht erreichen müssen. Wenn eine Regel dies muss, z. B. „ignorieren Sie das `vendor/`-Verzeichnis", wiederholen Sie sie in der Eingabeaufforderung, die Sie Claude geben, wenn Sie delegieren.1146Die Hauptkonversation hat immer noch Ihre vollständige CLAUDE.md, wenn sie die Ergebnisse dieser Subagenten liest, sodass die meisten Regeln nicht den Subagenten selbst erreichen müssen. Wenn eine Regel dies muss, z. B. „ignorieren Sie das `vendor/`-Verzeichnis", wiederholen Sie sie im Prompt, den Sie Claude geben, wenn Sie delegieren.

1143 1147

1144Sie können nicht ändern, welche Subagenten Git-Status erhalten. Nur Explore und Plan überspringen es.1148Sie können nicht ändern, welche Subagenten Git-Status erhalten. Nur Explore und Plan überspringen es.

1145 1149

1146Einige Hauptkonversationszustände erreichen niemals einen Non-Fork-Subagenten:1150Ein Teil des Hauptkonversations-Status erreicht niemals einen Non-Fork-Subagenten:

1147 1151

1148* **Ausgabestil**: Ein Subagent führt seine eigene Systemeingabeaufforderung aus, sodass Ihr [Ausgabestil](/docs/de/output-styles) seine Antworten nicht formt, außer in einem [Fork](#fork-the-current-conversation).1152* **Ausgabestil**: Ein Subagent führt sein eigenes System-Prompt aus, sodass Ihr [Ausgabestil](/docs/de/output-styles) seine Antworten nicht formt, außer in einem [Fork](#fork-the-current-conversation).

1149* **Auto-Gedächtnis**: Das [Auto-Gedächtnis](/docs/de/memory#auto-memory) der Hauptkonversation wird nicht geladen. Um einem Subagenten persistentes Gedächtnis seiner eigenen zu geben, verwenden Sie das Feld [`memory`](#enable-persistent-memory).1153* **Auto-Gedächtnis**: Das [Auto-Gedächtnis](/docs/de/memory#auto-memory) der Hauptkonversation wird nicht geladen. Um einem Subagenten sein eigenes persistentes Gedächtnis zu geben, verwenden Sie das Feld [`memory`](#enable-persistent-memory).

1150* **Kontextfenstergröße**: Das Kontextfenster eines Subagenten wird durch sein eigenes Modell dimensioniert, nicht das des übergeordneten. Die Delegierung an ein Modell mit einem kleineren Fenster gibt diesem Subagenten das kleinere Fenster.1154* **Kontextfenstergröße**: Das Kontextfenster eines Subagenten wird durch sein eigenes Modell dimensioniert, nicht das des übergeordneten. Die Delegierung an ein Modell mit einem kleineren Fenster gibt diesem Subagenten das kleinere Fenster.

1151 1155

1152<h4 id="resume-subagents">1156<h4 id="resume-subagents">

1153 Fortsetzen Sie Subagenten1157 Subagenten fortsetzen

1154</h4>1158</h4>

1155 1159

1156Jeder Subagenten-Aufruf erstellt eine neue Instanz, anstatt eine frühere fortzusetzen. Um die Arbeit eines bestehenden Subagenten fortzusetzen, anstatt von vorne zu beginnen, bitten Sie Claude, ihn fortzusetzen.1160Jeder Subagenten-Aufruf erstellt eine neue Instanz, anstatt eine frühere fortzusetzen. Um die Arbeit eines bestehenden Subagenten fortzusetzen, anstatt von vorne zu beginnen, bitten Sie Claude, ihn fortzusetzen.

1157 1161

1158Fortgesetzte Subagenten behalten ihre vollständige Konversationshistorie, einschließlich aller vorherigen Werkzeugaufrufe, Ergebnisse und Überlegungen. Wenn der Subagent [Hintergrund-Subagenten seiner eigenen](#let-subagents-spawn-their-own-subagents) spawnte, enthält diese Historie die Ergebnisse, die sie während der Ausführung lieferten. Der Subagent setzt genau dort an, wo er stoppte, anstatt von vorne zu beginnen.1162Fortgesetzte Subagenten behalten ihre vollständige Konversationshistorie, einschließlich aller vorherigen Tool-Aufrufe, Ergebnisse und Überlegungen. Wenn der Subagent [Hintergrund-Subagenten seiner eigenen](#let-subagents-spawn-their-own-subagents) spawnte, enthält diese Historie die Ergebnisse, die sie während des Laufs lieferten. Der Subagent setzt genau dort an, wo er stoppte, anstatt von vorne zu beginnen.

1159 1163

1160* Wenn ein Subagent abgeschlossen ist, erhält Claude seine Agent-ID.1164* Wenn ein Subagent abgeschlossen wird, erhält Claude seine Agent-ID.

1161* Die integrierten Explore- und Plan-Agenten sind einmalig und geben keine Agent-ID zurück, sodass Claude sie nicht fortsetzen kann. Verwenden Sie `general-purpose` oder einen benutzerdefinierten Subagenten, wenn Sie die Arbeit fortsetzen müssen.1165* Die integrierten Explore- und Plan-Agenten sind einmalig und geben keine Agent-ID zurück, sodass Claude sie nicht fortsetzen kann. Verwenden Sie `general-purpose` oder einen benutzerdefinierten Subagenten, wenn Sie die Arbeit fortsetzen müssen.

1162* Wenn ein Subagent bei seinem [`maxTurns`](#supported-frontmatter-fields)-Limit stoppt, markiert Claude Code die zurückgegebene Ausgabe als teilweise. Für Subagenten, die eine Agent-ID zurückgeben, vermerkt Claude Code auch im Ergebnis, dass Claude den Subagenten ansprechen kann, um von dort fortzufahren, wo er stoppte.1166* Wenn ein Subagent bei seiner [`maxTurns`](#supported-frontmatter-fields)-Grenze stoppt, markiert Claude Code die zurückgegebene Ausgabe als teilweise. Für Subagenten, die eine Agent-ID zurückgeben, vermerkt Claude Code auch im Ergebnis, dass Claude den Subagenten ansprechen kann, um von dort weiterzumachen, wo er stoppte.

1163 1167

1164Claude verwendet das `SendMessage`-Werkzeug mit der Agent-ID oder dem Namen des Agenten als `to`-Feld, um ihn fortzusetzen. `SendMessage` erfordert nicht, dass [Agent-Teams](/docs/de/agent-teams) aktiviert sind; nur strukturierte Team-Protokoll-Nachrichten wie `shutdown_request` und `plan_approval_response` tun dies. Über Subagenten und Teamkollegen hinaus können Claude in Sitzungen, in denen Cross-Session-Messaging aktiviert ist, mit demselben Werkzeug [Ihre anderen Claude-Code-Sitzungen](/docs/de/cross-session-messaging) ansprechen, auf dieser Maschine oder [darüber hinaus](/docs/de/cross-session-messaging#message-sessions-on-other-machines).1168Claude verwendet das `SendMessage`-Tool mit der Agent-ID oder dem Namen des Agenten als Feld `to`, um ihn fortzusetzen. `SendMessage` erfordert nicht, dass [Agent-Teams](/docs/de/agent-teams) aktiviert sind; nur strukturierte Team-Protokoll-Nachrichten wie `shutdown_request` und `plan_approval_response` tun dies. Über Subagenten und Teamkollegen hinaus können Claude in Sitzungen, in denen Cross-Session-Messaging aktiviert ist, mit demselben Tool [Ihre anderen Claude-Code-Sitzungen](/docs/de/cross-session-messaging) ansprechen, auf dieser Maschine oder [darüber hinaus](/docs/de/cross-session-messaging#message-sessions-on-other-machines).

1165 1169

1166Um einen Subagenten fortzusetzen, bitten Sie Claude, die vorherige Arbeit fortzusetzen:1170Um einen Subagenten fortzusetzen, bitten Sie Claude, die vorherige Arbeit fortzusetzen:

1167 1171

1173[Claude resumes the subagent with full context from previous conversation]1177[Claude resumes the subagent with full context from previous conversation]

1174```1178```

1175 1179

1176Wenn Claude einen abgeschlossenen Subagenten mit dem `SendMessage`-Werkzeug eine Nachricht sendet, wird der Subagent im Hintergrund ohne einen neuen `Agent`-Aufruf fortgesetzt. Das Gleiche gilt für einen Subagenten, den Claude mit dem `TaskStop`-Werkzeug gestoppt hat, sobald sein gestoppter Lauf beendet ist. Der fortgesetzte Lauf behält den [Werkzeugsatz von dort, wo der Subagent zuerst lief](#run-subagents-in-foreground-or-background), und kann weiterhin den [Prompt-Cache lesen, den der ursprüngliche Lauf aufgewärmt hat](/docs/de/prompt-caching#subagents-and-the-cache).1180Wenn Claude eine abgeschlossene Subagenten-Nachricht mit dem `SendMessage`-Tool sendet, wird der Subagent im Hintergrund ohne einen neuen `Agent`-Aufruf fortgesetzt. Das Gleiche gilt für einen Subagenten, den Claude mit dem `TaskStop`-Tool gestoppt hat, sobald sein gestoppter Lauf beendet ist. Der fortgesetzte Lauf behält das [Tool-Set von dort, wo der Subagent zuerst lief](#run-subagents-in-foreground-or-background), und kann weiterhin den [Prompt-Cache lesen, den der ursprüngliche Lauf aufgewärmt hat](/docs/de/prompt-caching#subagents-and-the-cache).

1177 1181

1178Ein Subagent, der das `SendMessage`-Werkzeug hat, kann diese Nachricht auch senden. In einer interaktiven Sitzung meldet der fortgesetzte Agent dann dem Subagenten, der ihn fortgesetzt hat, zurück, nicht zu Ihrer Hauptkonversation. Dieser Subagent wartet auf das Ergebnis, bevor er seine eigene Arbeit beendet. Wenn ein Subagent einen Agenten anspricht, dem er meldet, z. B. seinen eigenen Launcher, setzt Claude Code diesen Agenten fort, ohne seine Ergebnisse umzuleiten.1182Ein Subagent, der das `SendMessage`-Tool hat, kann diese Nachricht auch senden. In einer interaktiven Sitzung meldet der fortgesetzte Agent dann an den Subagenten zurück, der ihn fortgesetzt hat, nicht an Ihre Hauptkonversation. Dieser Subagent wartet auf das Ergebnis, bevor er seine eigene Arbeit beendet. Wenn ein Subagent einen Agenten anspricht, an den er meldet, z. B. seinen eigenen Starter, setzt Claude Code diesen Agenten fort, ohne seine Ergebnisse umzuleiten.

1179 1183

1180Ein Subagent, den Sie selbst gestoppt haben, mit `x` in `/tasks` oder einer SDK-`stop_task`-Anfrage, wird nicht automatisch fortgesetzt. Wenn Claude ihm eine Nachricht sendet, wird die Nachricht verweigert und Claude wird mitgeteilt, dass der Agent abgebrochen wurde.1184Ein Subagent, den Sie selbst gestoppt haben, mit `x` in `/tasks` oder einer SDK-`stop_task`-Anfrage, wird nicht automatisch fortgesetzt. Wenn Claude ihm eine Nachricht sendet, wird die Nachricht abgelehnt und Claude wird mitgeteilt, dass der Agent abgebrochen wurde.

1181 1185

1182Während [die Zeile dieses Subagenten immer noch im Subagenten-Panel ist](#run-subagents-in-foreground-or-background), geben Sie in sein Transkript ein, um ihn selbst fortzusetzen. Danach kann eine Nachricht von Claude ihn wieder automatisch fortsetzen.1186Während [die Zeile dieses Subagenten immer noch im Subagenten-Panel ist](#run-subagents-in-foreground-or-background), geben Sie in sein Transkript ein, um ihn selbst fortzusetzen. Danach kann eine Nachricht von Claude ihn wieder automatisch fortsetzen.

1183 1187

1184Das Fortsetzen startet einen neuen Lauf des Agenten unter derselben ID, sodass ein Subagent, der bereits fehlgeschlagen oder abgeschlossen war, in der Aufgabenliste und in den Task-Events des Agent SDK wieder als laufend angezeigt wird. Vor v2.1.205 zeigte er seinen früheren fehlgeschlagenen oder abgeschlossenen Status, während der fortgesetzte Lauf funktionierte.1188Das Fortsetzen startet einen neuen Lauf des Agenten unter derselben ID, sodass ein Subagent, der bereits fehlgeschlagen oder abgeschlossen war, wieder als laufend in der Task-Liste und in den Task-Events des Agent SDK angezeigt wird. Vor v2.1.205 zeigte er seinen früheren fehlgeschlagenen oder abgeschlossenen Status, während der fortgesetzte Lauf funktionierte.

1185 1189

1186Ab v2.1.199 überprüft `SendMessage`, dass ein Name immer noch auf denselben Agenten verweist, den er früher in der Konversation erreicht hat. Wenn ein neuerer Agent den Namen übernommen hat, z. B. ein neu gespawnter Hintergrund-Agent, der ihn wiederverwendet hat, weigert sich Claude Code, die Nachricht zu senden, anstatt sie an den falschen Agenten zu liefern, und der Fehler meldet, welcher Agent der Name jetzt erreicht, damit Claude neu ausrichten kann. Um den früheren Agenten zu erreichen, während er noch läuft, spricht Claude ihn nach der Agent-ID an, die er erhielt, als er diesen Agenten spawnte. Die Überprüfung ist auf die aktuelle Konversation beschränkt und wird bei `/clear` zurückgesetzt.1190Ab v2.1.199 überprüft `SendMessage`, dass ein Name immer noch auf denselben Agenten verweist, den er früher in der Konversation erreicht hat. Wenn ein neuerer Agent den Namen übernommen hat, z. B. ein neu gespawnter Hintergrund-Agent, der ihn wiederverwendet hat, weigert sich Claude Code, ihn zu senden, anstatt ihn an den falschen Agenten zu liefern, und der Fehler meldet, welcher Agent der Name jetzt erreicht, damit Claude ihn umleiten kann. Um den früheren Agenten zu erreichen, während er noch läuft, adressiert Claude ihn nach der Agent-ID, die er erhielt, als er diesen Agenten spawnte. Die Überprüfung ist auf die aktuelle Konversation beschränkt und setzt sich bei `/clear` zurück.

1187 1191

1188Ab v2.1.198 behandelt ein Subagent Nachrichten vom Agenten, der ihn gestartet hat, als normale Aufgabenrichtung, einschließlich Kurskorrektionen während der Aufgabe, und handelt nach ihnen innerhalb seiner eigenen Genehmigungseinstellungen. Zwei Grenzen gelten trotzdem unabhängig davon, wer die Nachricht gesendet hat: Keine Nachricht von einem Agenten zählt als Ihre Genehmigung für eine ausstehende Genehmigungseingabeaufforderung, und keine Agent-Nachricht kann die Genehmigungseinstellungen, `CLAUDE.md` oder Konfiguration eines Subagenten ändern. Nur das Genehmigungssystem oder Ihre eigenen Nachrichten können Genehmigung gewähren.1192Ab v2.1.198 behandelt ein Subagent Nachrichten vom Agenten, der ihn gestartet hat, als normale Task-Richtung, einschließlich Mid-Task-Kurskorektionen, und handelt danach innerhalb seiner eigenen Genehmigungseinstellungen. Zwei Grenzen gelten trotzdem unabhängig davon, wer die Nachricht gesendet hat: Keine Nachricht von einem Agenten zählt als Ihre Genehmigung für einen ausstehenden Genehmigungsprompt, und keine Agent-Nachricht kann die Genehmigungseinstellungen, `CLAUDE.md` oder Konfiguration eines Subagenten ändern. Nur das Genehmigungssystem oder Ihre eigenen Nachrichten können Genehmigung gewähren.

1189 1193

1190Sie können Claude auch nach der Agent-ID fragen, wenn Sie sie explizit referenzieren möchten, oder IDs in den Transkriptdateien unter `~/.claude/projects/{project}/{sessionId}/subagents/` finden. Jedes Transkript wird als `agent-{agentId}.jsonl` gespeichert.1194Sie können Claude auch nach der Agent-ID fragen, wenn Sie sie explizit referenzieren möchten, oder IDs in den Transkriptdateien unter `~/.claude/projects/{project}/{sessionId}/subagents/` finden. Jedes Transkript wird als `agent-{agentId}.jsonl` gespeichert.

1191 1195

1192Subagenten-Transkripte bleiben unabhängig von der Hauptkonversation bestehen:1196Subagenten-Transkripte bleiben unabhängig von der Hauptkonversation bestehen:

1193 1197

1194* **Hauptkonversations-Komprimierung**: Wenn die Hauptkonversation komprimiert wird, sind Subagenten-Transkripte nicht betroffen. Sie werden in separaten Dateien gespeichert.1198* **Hauptkonversations-Komprimierung**: Wenn die Hauptkonversation komprimiert wird, sind Subagenten-Transkripte nicht betroffen. Sie werden in separaten Dateien gespeichert.

1195* **Sitzungspersistenz**: Subagenten-Transkripte bleiben innerhalb ihrer Sitzung bestehen. Sie können [einen Subagenten fortsetzen](#resume-subagents), nachdem Sie Claude Code neu gestartet haben, indem Sie dieselbe Sitzung fortsetzen.1199* **Sitzungs-Persistenz**: Subagenten-Transkripte bleiben innerhalb ihrer Sitzung bestehen. Sie können [einen Subagenten fortsetzen](#resume-subagents), nachdem Sie Claude Code neu gestartet haben, indem Sie dieselbe Sitzung fortsetzen.

1196* **Automatische Bereinigung**: Claude Code löscht Subagenten-Transkripte nach der Aufbewahrungsfrist `cleanupPeriodDays`, standardmäßig 30 Tage, nach den [Aufbewahrungsfeger-Regeln](/docs/de/claude-directory#cleaned-up-automatically).1200* **Automatische Bereinigung**: Claude Code löscht Subagenten-Transkripte nach der Aufbewahrungsfrist `cleanupPeriodDays`, standardmäßig 30 Tage, nach den [Aufbewahrungsfeger-Regeln](/docs/de/claude-directory#cleaned-up-automatically).

1197 1201

1198<h4 id="auto-compaction">1202<h4 id="auto-compaction">

terminal-config.md +6 −0

Details

339 ```339 ```

340</CodeGroup>340</CodeGroup>

341 341

342<h2 id="cap-response-width-in-wide-terminals">

343 Antwortbreite in breiten Terminals begrenzen

344</h2>

345

346In einem breiten Terminal erstreckt sich jede Textzeile in Claudes Antworten über die volle Breite des Fensters. Um den Text stattdessen bei einer festgelegten Anzahl von Spalten umzubrechen, setzen Sie [`maxProseWidth`](/docs/de/settings-reference#maxprosewidth) in Ihren Einstellungen.

347

342<h2 id="paste-large-content">348<h2 id="paste-large-content">

343 Großen Inhalt einfügen349 Großen Inhalt einfügen

344</h2>350</h2>

tools-reference.md +8 −8

Details

13Um benutzerdefinierte Tools hinzuzufügen, verbinden Sie einen [MCP-Server](/docs/de/mcp). Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen [Skill](/docs/de/skills), der über das vorhandene `Skill`-Tool ausgeführt wird, anstatt einen neuen Tool-Eintrag hinzuzufügen.13Um benutzerdefinierte Tools hinzuzufügen, verbinden Sie einen [MCP-Server](/docs/de/mcp). Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen [Skill](/docs/de/skills), der über das vorhandene `Skill`-Tool ausgeführt wird, anstatt einen neuen Tool-Eintrag hinzuzufügen.

14 14

15<Info>15<Info>

16 Bei Pro-, Max- und Team-Plänen startet Claude Code Sitzungen im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), wobei ein Klassifizierer die meisten dieser Aufforderungen entscheidet, anstatt Sie. Die Spalte `Berechtigung erforderlich` zeigt, ob das Tool im [Manuellen Modus](/docs/de/permission-modes) für Pfade im Arbeitsverzeichnis auffordert. Datei-Zugriffs-Tools, die mit Nein gekennzeichnet sind, einschließlich `Read`, `Grep` und `Glob`, fordern weiterhin für Pfade außerhalb des [Arbeitsverzeichnisses und zusätzlicher Verzeichnisse](/docs/de/permissions#working-directories) auf. `Bash` ist mit Ja gekennzeichnet, führt aber einen integrierten Satz von [schreibgeschützten Befehlen](/docs/de/permissions#read-only-commands) ohne Aufforderung aus.16 Im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) entscheidet ein Klassifizierer die meisten Berechtigungsaufforderungen anstelle von Ihnen. Die Spalte `Berechtigung erforderlich` zeigt, ob das Tool im [Manuellen Modus](/docs/de/permission-modes) für Pfade im Arbeitsverzeichnis auffordert. Datei-Zugriffs-Tools, die mit Nein gekennzeichnet sind, einschließlich `Read`, `Grep` und `Glob`, fordern weiterhin für Pfade außerhalb des [Arbeitsverzeichnisses und zusätzlicher Verzeichnisse](/docs/de/permissions#working-directories) auf. `Bash` ist mit Ja gekennzeichnet, führt aber einen integrierten Satz von [schreibgeschützten Befehlen](/docs/de/permissions#read-only-commands) ohne Aufforderung aus.

17</Info>17</Info>

18 18

28| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Tool-Verhalten](#edit-tool-behavior) | Ja |28| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Tool-Verhalten](#edit-tool-behavior) | Ja |

29| `EndConversation` | Beendet die Sitzung in seltenen Fällen von anhaltendem missbräuchlichem Input oder wenn Sie Claude auffordern, das Tool zu demonstrieren. Erfordert Claude Code v2.1.213 oder später. Siehe [EndConversation-Tool-Verhalten](#endconversation-tool-behavior) | Nein |29| `EndConversation` | Beendet die Sitzung in seltenen Fällen von anhaltendem missbräuchlichem Input oder wenn Sie Claude auffordern, das Tool zu demonstrieren. Erfordert Claude Code v2.1.213 oder später. Siehe [EndConversation-Tool-Verhalten](#endconversation-tool-behavior) | Nein |

31| `EnterWorktree` | Erstellt einen isolierten [Git-Worktree](/docs/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repositorys sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. Ein `path` außerhalb von `.claude/worktrees/` fordert Ihre Genehmigung auf, bevor Sie eintreten, da er das Arbeitsverzeichnis und den Schreibzugriff der Sitzung an diesen Ort verschiebt. Die Erstellung neuer Worktrees und Pfade unter `.claude/worktrees/` fordern nicht auf. Vor v2.1.206 trat Claude Pfaden außerhalb von `.claude/worktrees/` ohne Aufforderung bei. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` des Repositorys der Sitzung liegen | Ja |31| `EnterWorktree` | Erstellt einen isolierten [Git-Worktree](/docs/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repositorys sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. Ein `path` außerhalb von `.claude/worktrees/` fordert Ihre Genehmigung auf, bevor Sie eintreten, da er das Arbeitsverzeichnis und den Schreibzugriff der Sitzung an diesen Ort verschiebt. Die Erstellung neuer Worktrees und Pfade unter `.claude/worktrees/` fordern nicht auf. Vor v2.1.206 trat Claude Pfaden außerhalb von `.claude/worktrees/` ohne Aufforderung bei. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` des Repositorys der Sitzung liegen | Ja |

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

33| `ExitWorktree` | Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht verfügbar für Subagenten, die bereits in ihrem eigenen Arbeitsverzeichnis ausgeführt werden, z. B. mit [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) | Nein |33| `ExitWorktree` | Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht verfügbar für Subagenten, die bereits in ihrem eigenen Arbeitsverzeichnis ausgeführt werden, z. B. mit [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) | Nein |

36| `ListAgents` | Listet die Agenten auf, die Claude mit `SendMessage` kontaktieren kann: Subagenten in der Sitzung, [Agent-Team](/docs/de/agent-teams)-Teamkollegen, Ihre anderen lokalen Claude-Code-Sitzungen und, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist, Ihre [Claude Code im Web](/docs/de/claude-code-on-the-web)-Sitzungen und Ihre Remote-Control-Sitzungen auf anderen Maschinen. Unterstützt den `/list-agents`-Befehl. Siehe [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging). Erfordert Claude Code v2.1.224 oder später und wird nur in Sitzungen angezeigt, in denen [sitzungsübergreifendes Messaging aktiviert ist](/docs/de/cross-session-messaging#availability). Teamkollegen-Zeilen und die erste Zeile, die den Namen dieser Sitzung zeigt, erfordern v2.1.239 oder später | Nein |36| `ListAgents` | Listet die Agenten auf, die Claude mit `SendMessage` kontaktieren kann: Subagenten in der Sitzung, [Agent-Team](/docs/de/agent-teams)-Teamkollegen, Ihre anderen lokalen Claude-Code-Sitzungen und, während diese Sitzung mit [Remote Control](/docs/de/remote-control) verbunden ist, Ihre [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und Ihre Remote-Control-Sitzungen auf anderen Maschinen. Unterstützt den `/list-agents`-Befehl. Siehe [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging). Erfordert Claude Code v2.1.224 oder später und wird nur in Sitzungen angezeigt, in denen [sitzungsübergreifendes Messaging aktiviert ist](/docs/de/cross-session-messaging#availability). Teamkollegen-Zeilen und die erste Zeile, die den Namen dieser Sitzung zeigt, erfordern v2.1.239 oder später | Nein |

~~37| `ListMcpResourcesTool` | Listet Ressourcen auf, die von verbundenen [MCP-Servern](/docs/de/mcp) bereitgestellt werden | Nein |~~37| `ListMcpResourcesTool` | Listet Ressourcen auf, die von verbundenen [MCP-Servern](/docs/de/mcp) bereitgestellt werden, wobei [MCP Apps UI-Ressourcen](/docs/de/mcp#reference-mcp-resources) ausgelassen werden, die Seiten für eine Host-Anwendung zum Rendern sind | Nein |

38| `LSP` | Code-Intelligenz über Sprachserver: Sprung zu Definitionen, Suche nach Referenzen, Meldung von Typfehlern und Warnungen. Siehe [LSP-Tool-Verhalten](#lsp-tool-behavior) | Nein |38| `LSP` | Code-Intelligenz über Sprachserver: Sprung zu Definitionen, Suche nach Referenzen, Meldung von Typfehlern und Warnungen. Siehe [LSP-Tool-Verhalten](#lsp-tool-behavior) | Nein |

39| `Monitor` | Führt einen Befehl im Hintergrund aus und speist jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status in der Mitte des Gesprächs reagieren kann. Kann auch einen WebSocket öffnen und jede eingehende Nachricht als Ereignis behandeln. Siehe [Monitor-Tool](#monitor-tool) | Ja |39| `Monitor` | Führt einen Befehl im Hintergrund aus und speist jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status in der Mitte des Gesprächs reagieren kann. Kann auch einen WebSocket öffnen und jede eingehende Nachricht als Ereignis behandeln. Siehe [Monitor-Tool](#monitor-tool) | Ja |

40| `NotebookEdit` | Ändert Jupyter-Notebook-Zellen. Siehe [NotebookEdit-Tool-Verhalten](#notebookedit-tool-behavior) | Ja |40| `NotebookEdit` | Ändert Jupyter-Notebook-Zellen. Siehe [NotebookEdit-Tool-Verhalten](#notebookedit-tool-behavior) | Ja |

506Read verarbeitet mehrere Dateitypen über reinen Text hinaus:506Read verarbeitet mehrere Dateitypen über reinen Text hinaus:

507 507

508* **Bilder**: PNG, JPG und andere Bildformate werden als visueller Inhalt zurückgegeben, den Claude sehen kann, nicht als Rohdaten. Claude Code ändert die Größe großer Bilder und komprimiert sie neu, um die Bildgrößenlimits des Modells einzuhalten, bevor sie gesendet werden, sodass Claude möglicherweise eine herunterskalierte Version eines großen Screenshots sieht. Ab v2.1.196 wird ein Bild, das nach dieser Größenänderung immer noch größer als 500 KB ist, als JPEG mit reduzierter Qualität mit seinen unveränderten Pixeldimensionen neu codiert. Wenn Claude feine Pixel-Details in einem großen Bild übersieht, bitten Sie es, zuerst die Region von Interesse zuzuschneiden, beispielsweise mit ImageMagick über Bash.508* **Bilder**: PNG, JPG und andere Bildformate werden als visueller Inhalt zurückgegeben, den Claude sehen kann, nicht als Rohdaten. Claude Code ändert die Größe großer Bilder und komprimiert sie neu, um die Bildgrößenlimits des Modells einzuhalten, bevor sie gesendet werden, sodass Claude möglicherweise eine herunterskalierte Version eines großen Screenshots sieht. Ab v2.1.196 wird ein Bild, das nach dieser Größenänderung immer noch größer als 500 KB ist, als JPEG mit reduzierter Qualität mit seinen unveränderten Pixeldimensionen neu codiert. Wenn Claude feine Pixel-Details in einem großen Bild übersieht, bitten Sie es, zuerst die Region von Interesse zuzuschneiden, beispielsweise mit ImageMagick über Bash.

509* **PDFs**: Claude liest kurze `.pdf`-Dateien vollständig. Für PDFs länger als 10 Seiten liest es in Bereichen mit einem `pages`-Parameter, wie `"1-5"`, bis zu 20 Seiten auf einmal.509* **PDFs**: Claude liest kurze `.pdf`-Dateien vollständig. Für PDFs länger als 10 Seiten liest es in Bereichen mit einem `pages`-Parameter, wie `"1-5"`, bis zu 20 Seiten auf einmal. Seitenbereich-Lesevorgänge rendern Seiten mit `pdftoppm` aus poppler-utils, daher installieren Sie es mit `brew install poppler` auf macOS oder `apt-get install poppler-utils` auf Debian und Ubuntu. Auf Windows und anderen Plattformen installieren Sie einen poppler-Build, der `pdftoppm` auf Ihrem `PATH` platziert. Ohne ihn schlägt ein Seitenbereich-Lesevorgang mit `pdftoppm is not installed` fehl.

510* **Jupyter-Notizbücher**: `.ipynb`-Dateien geben alle Zellen mit ihren Ausgaben zurück, einschließlich Code, Markdown und Visualisierungen. Claude Code weigert sich, eine Notizbuchdatei über 100 MB zu lesen; der Fehler teilt Claude mit, wie er stattdessen einen Teil des Notizbuchs liest, wie z. B. einen Ausschnitt von Zellen, mit einem Shell-Befehl.510* **Jupyter-Notizbücher**: `.ipynb`-Dateien geben alle Zellen mit ihren Ausgaben zurück, einschließlich Code, Markdown und Visualisierungen. Claude Code weigert sich, eine Notizbuchdatei über 100 MB zu lesen; der Fehler teilt Claude mit, wie er stattdessen einen Teil des Notizbuchs liest, wie z. B. einen Ausschnitt von Zellen, mit einem Shell-Befehl.

511 511

512Read liest nur Dateien, keine Verzeichnisse. Claude listet Verzeichnisinhalte mit einem Shell-Befehl wie `ls` auf.512Read liest nur Dateien, keine Verzeichnisse. Claude listet Verzeichnisinhalte mit einem Shell-Befehl wie `ls` auf.

troubleshoot-install.md +44 −2

Details

41| `running scripts is disabled on this system` oder `PSSecurityException` | [Erlauben Sie den npm-Shims zu laufen](#running-scripts-is-disabled-on-this-system) |41| `running scripts is disabled on this system` oder `PSSecurityException` | [Erlauben Sie den npm-Shims zu laufen](#running-scripts-is-disabled-on-this-system) |

42| `Error: claude native binary not installed` | [Schließen Sie die npm-Installation ab](#native-binary-not-found-after-npm-install) |42| `Error: claude native binary not installed` | [Schließen Sie die npm-Installation ab](#native-binary-not-found-after-npm-install) |

43| `npm error code ENOTEMPTY` während Update oder Neuinstallation | [Entfernen Sie das verbleibende Paketverzeichnis](#npm-enotempty-during-update-or-reinstall) |43| `npm error code ENOTEMPTY` während Update oder Neuinstallation | [Entfernen Sie das verbleibende Paketverzeichnis](#npm-enotempty-during-update-or-reinstall) |

44| `'claude' is not recognized` unmittelbar nach einem Update unter Windows | [Stellen Sie `claude.exe` aus seiner Sicherung wieder her](#claude-exe-missing-after-an-update-on-windows) |

44| Unter Windows druckt der Installationsbefehl Skripttext und nichts wird installiert | [Führen Sie den vollständigen Installationsbefehl aus](#wrong-install-command-on-windows) |45| Unter Windows druckt der Installationsbefehl Skripttext und nichts wird installiert | [Führen Sie den vollständigen Installationsbefehl aus](#wrong-install-command-on-windows) |

45| `App unavailable in region` | Claude Code ist in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries). |46| `App unavailable in region` | Claude Code ist in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries). |

46| `unable to get local issuer certificate` | [Konfigurieren Sie Unternehmens-CA-Zertifikate](#tls-or-ssl-connection-errors) |47| `unable to get local issuer certificate` | [Konfigurieren Sie Unternehmens-CA-Zertifikate](#tls-or-ssl-connection-errors) |

47| `OAuth error` oder `403 Forbidden` | [Beheben Sie die Authentifizierung](#login-and-authentication) |48| `OAuth error` oder `403 Forbidden` | [Beheben Sie die Authentifizierung](#login-and-authentication) |

49| `Claude Code access has not been granted for this account` | [Erhalten Sie eine Rolle, die Claude Code enthält](#claude-code-access-has-not-been-granted-for-this-account) |

48| `Unable to connect to Anthropic services` während der Einrichtung | Siehe [Unable to connect to Anthropic services](/docs/de/errors#unable-to-connect-to-anthropic-services) in der Fehlerreferenz |50| `Unable to connect to Anthropic services` während der Einrichtung | Siehe [Unable to connect to Anthropic services](/docs/de/errors#unable-to-connect-to-anthropic-services) in der Fehlerreferenz |

49| `Could not load the default credentials` oder `Could not load credentials from any providers` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |51| `Could not load the default credentials` oder `Could not load credentials from any providers` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

50| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |52| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

142 source ~/.zshrc144 source ~/.zshrc

143 ```145 ```

144 146

145 Für Bash, das Standard auf den meisten Linux-Distributionen:147 Für Bash auf Linux, wo es das Standard auf den meisten Distributionen ist:

146 148

147 ```bash theme={null}149 ```bash theme={null}

148 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc150 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

149 source ~/.bashrc151 source ~/.bashrc

150 ```152 ```

151 153

154 Für Bash auf macOS fügen Sie die Zeile stattdessen zu `~/.bash_profile` hinzu. Terminal auf macOS startet Bash als Login-Shell, die `~/.bashrc` ignoriert und nur die erste von `~/.bash_profile`, `~/.bash_login` oder `~/.profile` liest, die existiert. Wenn Sie bereits eine `~/.bash_login` oder `~/.profile` haben und keine `~/.bash_profile`, fügen Sie die Zeile in diese Datei ein, anstatt `~/.bash_profile` zu erstellen:

155

156 ```bash theme={null}

157 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile

158 source ~/.bash_profile

159 ```

160

152 Alternativ können Sie Ihr Terminal schließen und erneut öffnen.161 Alternativ können Sie Ihr Terminal schließen und erneut öffnen.

153 162

154 Für andere Shells wie fish oder Nushell fügen Sie `~/.local/bin` zu Ihrem PATH mit der eigenen Konfigurationssyntax Ihrer Shell hinzu und starten Sie dann Ihr Terminal neu.163 Für andere Shells wie fish oder Nushell fügen Sie `~/.local/bin` zu Ihrem PATH mit der eigenen Konfigurationssyntax Ihrer Shell hinzu und starten Sie dann Ihr Terminal neu.

512 Falscher Installationsbefehl unter Windows521 Falscher Installationsbefehl unter Windows

513</h3>522</h3>

514 523

515Wenn Sie `'irm' is not recognized`, `The token '&&' is not valid`, `A parameter cannot be found that matches parameter name 'fsSL'` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.524Wenn Sie `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.

516 525

517* **`irm` nicht erkannt**: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Optionen:526* **`irm` nicht erkannt**: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Optionen:

518 527

593irm https://claude.ai/install.ps1 | iex602irm https://claude.ai/install.ps1 | iex

594```603```

595 604

605<h3 id="claude-exe-missing-after-an-update-on-windows">

606 `claude.exe` fehlt nach einem Update unter Windows

607</h3>

608

609Wenn Ihr Terminal direkt nach einem Claude Code-Update unter Windows `'claude' is not recognized` meldet, überprüfen Sie, ob `%USERPROFILE%\.local\bin` immer noch `claude.exe` enthält. Wenn sich dieses Verzeichnis überhaupt nicht auf Ihrem PATH befindet, siehe [Beheben Sie Ihren PATH](#command-not-found-claude-after-installation) statt. Um unter Windows zu aktualisieren, benennt Claude Code die vorhandene `claude.exe` zur Seite in eine Sicherung um und verschiebt die neue Version an ihre Stelle. Wenn das Verschieben der neuen Version an ihre Stelle fehlschlägt und Claude Code die Sicherung auch nicht umbenennen kann, behält das Verzeichnis die Sicherung, hat aber keine `claude.exe`.

610

611Die Sicherung ist eine Datei im gleichen Verzeichnis, deren Name mit `claude.exe.old.` beginnt, gefolgt von einem numerischen Zeitstempel. Führen Sie Folgendes in PowerShell aus, um die neueste Sicherung zurück zu `claude.exe` umzubenennen:

612

613```powershell theme={null}

614Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

615```

616

617Führen Sie dann `claude --version` aus, um die Behebung zu bestätigen. Eine wiederhergestellte `claude.exe` gibt eine Versionsnummer aus.

618

619Wenn es keine `claude.exe.old.*` Datei gibt, oder `claude` schlägt immer noch nach der Umbenennung fehl, installieren Sie statt:

620

621```powershell theme={null}

622irm https://claude.ai/install.ps1 | iex

623```

624

625Vor v2.1.281 konnte Claude Code die Sicherung löschen, während `claude.exe` immer noch fehlte.

626

596<h3 id="install-killed-on-low-memory-linux-servers">627<h3 id="install-killed-on-low-memory-linux-servers">

597 Installation auf Linux-Servern mit wenig Speicher beendet628 Installation auf Linux-Servern mit wenig Speicher beendet

598</h3>629</h3>

992* **Anthropic Console-Benutzer**: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code" oder „Developer" hat. Admins weisen dies in der Anthropic Console unter Einstellungen → Mitglieder zu.1023* **Anthropic Console-Benutzer**: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code" oder „Developer" hat. Admins weisen dies in der Anthropic Console unter Einstellungen → Mitglieder zu.

993* **Hinter einem Proxy**: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe [Netzwerkkonfiguration](/docs/de/network-config) für Proxy-Einrichtung.1024* **Hinter einem Proxy**: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe [Netzwerkkonfiguration](/docs/de/network-config) für Proxy-Einrichtung.

994 1025

1026<h3 id="claude-code-access-has-not-been-granted-for-this-account">

1027 Claude Code-Zugriff wurde für dieses Konto nicht gewährt

1028</h3>

1029

1030Wenn die Anmeldungsseite `Authorization failed` mit der Nachricht `Claude Code access has not been granted for this account. Contact your administrator.` anzeigt, nachdem Sie sich von Claude Code aus anmelden, hat Ihre Claude Enterprise-Organisation Ihre Rolle auf „Custom" gesetzt und keine der [benutzerdefinierten Rollen](https://support.claude.com/en/articles/13930452), die Ihren Gruppen zugewiesen sind, gewährt Claude Code-Zugriff. Bei der benutzerdefinierten Rolle erhalten Sie Zugriff nur von diesen benutzerdefinierten Rollen, daher löst nichts, das Sie in Claude Code ändern, diesen Fehler.

1031

1032Um Zugriff zu erhalten:

1033

10341. Bitten Sie einen Eigentümer Ihrer Claude-Organisation, eine benutzerdefinierte Rolle, die Claude Code-Zugriff gewährt, einer Ihrer Gruppen zuzuweisen, oder ändern Sie Ihre Rolle von „Custom" zu einer Standardrolle wie „User". Eigentümer verwalten Rollen in den [Rolleneinstellungen](https://claude.ai/admin-settings/roles) der Organisation.

10352. Nachdem der Eigentümer die Änderung vorgenommen hat, führen Sie `claude` aus und melden Sie sich erneut an.

1036

995<h3 id="this-organization-has-been-disabled-with-an-active-subscription">1037<h3 id="this-organization-has-been-disabled-with-an-active-subscription">

996 Diese Organisation wurde mit einem aktiven Abonnement deaktiviert1038 Diese Organisation wurde mit einem aktiven Abonnement deaktiviert

997</h3>1039</h3>

troubleshooting.md +1 −0

Details

17| Sitzung wurde im Auto-Modus gestartet, oder Claude bearbeitet Dateien und führt Befehle aus, ohne zu fragen | [Welcher Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) |17| Sitzung wurde im Auto-Modus gestartet, oder Claude bearbeitet Dateien und führt Befehle aus, ohne zu fragen | [Welcher Modus eine Sitzung startet](/docs/de/permission-modes#which-mode-a-session-starts-in) |

18| `API Error: 5xx`, `529 Overloaded`, `429`, Request-Validierungsfehler | [Fehlerreferenz](/docs/de/errors) |18| `API Error: 5xx`, `529 Overloaded`, `429`, Request-Validierungsfehler | [Fehlerreferenz](/docs/de/errors) |

19| `model not found` oder `you may not have access to it` | [Fehlerreferenz](/docs/de/errors#theres-an-issue-with-the-selected-model) |19| `model not found` oder `you may not have access to it` | [Fehlerreferenz](/docs/de/errors#theres-an-issue-with-the-selected-model) |

20| Ein Befehl, den Claude ausführt, schlägt fehl mit `Your disk quota is full`, `is full (ENOSPC)` oder `Command output was lost` | [Fehlerreferenz](/docs/de/errors#disk-quota-or-temp-filesystem-is-full) |

20| VS Code-Erweiterung verbindet sich nicht oder erkennt Claude nicht | [VS Code-Integration](/docs/de/vs-code#fix-common-issues) |21| VS Code-Erweiterung verbindet sich nicht oder erkennt Claude nicht | [VS Code-Integration](/docs/de/vs-code#fix-common-issues) |

21| `Claude Code process exited with code 1` in VS Code oder einer SDK-App | [Fehlerreferenz](/docs/de/errors#claude-code-process-exited-with-code-n) |22| `Claude Code process exited with code 1` in VS Code oder einer SDK-App | [Fehlerreferenz](/docs/de/errors#claude-code-process-exited-with-code-n) |

22| JetBrains-Plugin oder IDE wird nicht erkannt | [JetBrains-Integration](/docs/de/jetbrains#troubleshooting) |23| JetBrains-Plugin oder IDE wird nicht erkannt | [JetBrains-Integration](/docs/de/jetbrains#troubleshooting) |

voice-dictation.md +7 −7

Details

30 Spracherfassung aktivieren30 Spracherfassung aktivieren

31</h2>31</h2>

32 32

33Führen Sie `/voice` aus, um die Erfassung zu aktivieren. Beim ersten Aktivieren führt Claude Code eine Mikrofonprüfung durch. Unter macOS wird dies die Systemmikrofonberechtigungsaufforderung für Ihr Terminal auslösen, falls diese noch nie gewährt wurde.33Führen Sie `/voice` aus, um die Erfassung zu aktivieren. Wenn Sie diese aktivieren, führt Claude Code eine Mikrofonprüfung durch. Auf macOS wird dadurch die Systemmikrofonberechtigungsaufforderung für Ihr Terminal ausgelöst, falls diese noch nie gewährt wurde.

34 34

35```35```

36/voice36/voice

42| Befehl | Effekt |42| Befehl | Effekt |

43| :- | :- |43| :- | :- |

44| `/voice` | Ein- oder ausschalten, aktuellen Modus beibehalten |44| `/voice` | Ein- oder ausschalten, aktuellen Modus beibehalten |

47| `/voice off` | Deaktivieren |47| `/voice off` | Deaktivieren |

48 48

~~49Die Spracherfassung bleibt über Sitzungen hinweg erhalten. Legen Sie sie direkt in Ihrer [Benutzereinstellungsdatei](/docs/de/settings) fest, anstatt `/voice` auszuführen:~~49Spracherfassung bleibt über Sitzungen hinweg erhalten. Legen Sie sie direkt in Ihrer [Benutzereinstellungsdatei](/docs/de/settings) fest, anstatt `/voice` auszuführen:

50 50

51```json theme={null}51```json theme={null}

52{52{

57}57}

58```58```

59 59

60Während die Spracherfassung aktiviert ist, zeigt die Eingabefußzeile einen `hold space to speak`-Hinweis an, wenn die Eingabeaufforderung leer ist. Der Hinweis spiegelt Ihre aktuelle `voice:pushToTalk`-Bindung wider und wird aktualisiert, wenn Sie [die Erfassungstaste neu zuordnen](#rebind-the-dictation-key). Der Hinweistext ist in beiden Modi gleich und wird nicht angezeigt, wenn Sie eine [benutzerdefinierte Statuszeile](/docs/de/statusline) konfiguriert haben.60In den ersten drei Sitzungen mit aktivierter Spracherfassung zeigt die Eingabefußzeile einen `hold space to speak`-Hinweis an, wenn die Eingabeaufforderung leer ist. Der Hinweis spiegelt Ihre aktuelle `voice:pushToTalk`-Bindung wider und wird aktualisiert, wenn Sie [die Erfassungstaste neu zuordnen](#rebind-the-dictation-key). Der Hinweistext ist in beiden Modi gleich, und er wird nicht angezeigt, wenn Sie eine [benutzerdefinierte Statuszeile](/docs/de/statusline) konfiguriert haben.

61 61

62Die Transkription ist in beiden Modi auf Codierungsvokabular abgestimmt. Häufige Entwicklungsbegriffe wie `regex`, `OAuth`, `JSON` und `localhost` werden korrekt erkannt, und Ihr aktueller Projektname und Git-Branch-Name werden automatisch als Erkennungshinweise hinzugefügt.62Die Transkription ist in beiden Modi auf Codierungsvokabular abgestimmt. Häufige Entwicklungsbegriffe wie `regex`, `OAuth`, `JSON` und `localhost` werden korrekt erkannt, und Ihr aktueller Projektname und Git-Branchname werden automatisch als Erkennungshinweise hinzugefügt.

63 63

64<h2 id="hold-to-record">64<h2 id="hold-to-record">

65 Halten zum Aufnehmen65 Halten zum Aufnehmen

190* **`Voice mode requires SoX for audio recording` unter Linux**: Das native Audiomodul konnte nicht geladen werden und kein Fallback ist installiert. Installieren Sie SoX mit dem im Fehlermeldung angezeigten Befehl, z. B. `sudo apt-get install sox`.190* **`Voice mode requires SoX for audio recording` unter Linux**: Das native Audiomodul konnte nicht geladen werden und kein Fallback ist installiert. Installieren Sie SoX mit dem im Fehlermeldung angezeigten Befehl, z. B. `sudo apt-get install sox`.

191* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX ist installiert, aber der Host hat kein Audioaufnahmegerät, z. B. einen Server ohne Kopfhörer oder einen Container. Führen Sie Claude Code auf einem Computer mit einem Mikrofon aus. Ab v2.1.195 meldet Claude Code unter Linux diese Meldung in dieser Situation; frühere Versionen forderten Sie auf, SoX zu installieren, auch wenn es bereits installiert war.191* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX ist installiert, aber der Host hat kein Audioaufnahmegerät, z. B. einen Server ohne Kopfhörer oder einen Container. Führen Sie Claude Code auf einem Computer mit einem Mikrofon aus. Ab v2.1.195 meldet Claude Code unter Linux diese Meldung in dieser Situation; frühere Versionen forderten Sie auf, SoX zu installieren, auch wenn es bereits installiert war.

192* **`Voice mode could not find a working audio recorder in WSL`**: WSLg leitet Audio über PulseAudio statt über ein ALSA-Gerät weiter, daher muss das PulseAudio-Backend von SoX explizit installiert werden. Führen Sie `sudo apt install sox libsox-fmt-pulse` aus. Die Installation von `sox` allein zieht das ALSA-Backend mit sich, das unter WSL nicht aufnehmen kann, da es kein `/dev/snd`-Gerät gibt.192* **`Voice mode could not find a working audio recorder in WSL`**: WSLg leitet Audio über PulseAudio statt über ein ALSA-Gerät weiter, daher muss das PulseAudio-Backend von SoX explizit installiert werden. Führen Sie `sudo apt install sox libsox-fmt-pulse` aus. Die Installation von `sox` allein zieht das ALSA-Backend mit sich, das unter WSL nicht aufnehmen kann, da es kein `/dev/snd`-Gerät gibt.

193* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung hat drei Aufnahmefehler innerhalb von 10 Sekunden erreicht. Claude Code pausiert die Erfassung, bis 10 Sekunden seit dem ersten dieser Fehler vergangen sind. Ein Fehler zählt, ob das Mikrofon nicht startet oder der Rekorder startet und dann stoppt, ohne Audio zu produzieren. Dies bedeutet normalerweise, dass das Mikrofon oder der Audiostapel auf diesem Host keinen Audio erfassen kann, z. B. ein Server ohne Kopfhörer, eine Remote-Shell ohne Audio-Durchleitung oder eine verweigerte Mikrofonberechtigung. Bestätigen Sie ein funktionierendes Eingabegerät, beheben Sie die zugrunde liegende Ursache aus den obigen Einträgen und lösen Sie dann die Spracherfassung erneut aus. Vor v2.1.202 zählten nur Start-Fehler zur Pause.193* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung hat drei Aufnahmefehler innerhalb von 10 Sekunden erreicht. Claude Code pausiert die Erfassung, bis 10 Sekunden seit dem ersten dieser Fehler vergangen sind. Dies bedeutet normalerweise, dass das Mikrofon oder der Audiostapel auf diesem Host keinen Audio erfassen kann, z. B. ein Server ohne Kopfhörer, eine Remote-Shell ohne Audio-Durchleitung oder eine verweigerte Mikrofonberechtigung. Bestätigen Sie ein funktionierendes Eingabegerät, beheben Sie die zugrunde liegende Ursache aus den obigen Einträgen und lösen Sie dann die Spracherfassung erneut aus. Vor v2.1.202 zählten nur Start-Fehler zur Pause.

194* **Nichts passiert, wenn Sie `Space` im Halten-Modus halten**: Beobachten Sie die Eingabeaufforderung, während Sie halten. Wenn sich Leerzeichen weiter ansammeln, ist die Spracherfassung wahrscheinlich aus; führen Sie `/voice hold` aus, um sie zu aktivieren. Wenn nur ein oder zwei Leerzeichen erscheinen und dann nichts, ist die Spracherfassung an, aber die Halten-Erkennung wird nicht ausgelöst. Die Halten-Erkennung erfordert, dass Ihr Terminal Tastenwiederholungsereignisse sendet, daher kann es eine gehaltene Taste nicht erkennen, wenn die Tastenwiederholung auf Betriebssystemebene deaktiviert ist. Wechseln Sie mit `/voice tap` zum Tippen-Modus, um die Tastenwiederholungsanforderung zu vermeiden.194* **Nichts passiert, wenn Sie `Space` im Halten-Modus halten**: Beobachten Sie die Eingabeaufforderung, während Sie halten. Wenn sich Leerzeichen weiter ansammeln, ist die Spracherfassung wahrscheinlich aus; führen Sie `/voice hold` aus, um sie zu aktivieren. Wenn nur ein oder zwei Leerzeichen erscheinen und dann nichts, ist die Spracherfassung an, aber die Halten-Erkennung wird nicht ausgelöst. Die Halten-Erkennung erfordert, dass Ihr Terminal Tastenwiederholungsereignisse sendet, daher kann es eine gehaltene Taste nicht erkennen, wenn die Tastenwiederholung auf Betriebssystemebene deaktiviert ist. Wechseln Sie mit `/voice tap` zum Tippen-Modus, um die Tastenwiederholungsanforderung zu vermeiden.

195* **Das Tippen auf `Space` gibt ein Leerzeichen ein, anstatt im Tippen-Modus aufzunehmen**: Das erste Tippen startet die Aufnahme nur, wenn die Eingabeaufforderung leer ist. Löschen Sie zuerst die Eingabe, oder überprüfen Sie, dass Sie im Tippen-Modus sind, indem Sie `/voice tap` ausführen.195* **Das Tippen auf `Space` gibt ein Leerzeichen ein, anstatt im Tippen-Modus aufzunehmen**: Das erste Tippen startet die Aufnahme nur, wenn die Eingabeaufforderung leer ist. Löschen Sie zuerst die Eingabe, oder überprüfen Sie, dass Sie im Tippen-Modus sind, indem Sie `/voice tap` ausführen.

196* **`No audio detected from microphone`**: Die Aufnahme wurde gestartet, aber es wurde Stille erfasst. Bestätigen Sie, dass das richtige Eingabegerät als Systemstandard eingestellt ist und dass sein Eingabepegel nicht stummgeschaltet oder nahe Null ist. Unter Windows öffnen Sie Einstellungen → System → Sound → Eingabe und wählen Sie Ihr Mikrofon aus. Unter macOS öffnen Sie Systemeinstellungen → Sound → Eingabe.196* **`No audio detected from microphone`**: Die Aufnahme wurde gestartet, aber es wurde Stille erfasst. Bestätigen Sie, dass das richtige Eingabegerät als Systemstandard eingestellt ist und dass sein Eingabepegel nicht stummgeschaltet oder nahe Null ist. Unter Windows öffnen Sie Einstellungen → System → Sound → Eingabe und wählen Sie Ihr Mikrofon aus. Unter macOS öffnen Sie Systemeinstellungen → Sound → Eingabe.

vs-code.md +36 −13

Details

109 109

110Das Eingabefeld unterstützt mehrere Funktionen:110Das Eingabefeld unterstützt mehrere Funktionen:

111 111

112* **Berechtigungsmodi**: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um zwischen Berechtigungsmodi zu wechseln. In den Pro-, Max- und Team-Plänen ist Auto der integrierte Startberechtigungsmodus. Siehe [wie die Erweiterung den Startberechtigungsmodus wählt](/docs/de/permission-modes#switch-permission-modes), um zu erfahren, was das ändert, und jeden Berechtigungsmodus, den der Indikator anbietet.112* **Berechtigungsmodi**: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um zwischen Berechtigungsmodi zu wechseln. Mit Claude Code v2.1.283 oder später ist Auto der integrierte Startberechtigungsmodus, und in früheren Versionen nur in Pro-, Max- und Team-Plänen. Siehe [wie die Erweiterung den Startberechtigungsmodus wählt](/docs/de/permission-modes#switch-permission-modes), um zu erfahren, was das ändert, und jeden Berechtigungsmodus, den der Indikator anbietet.

113 * **Auto**: Ein Klassifizierer überprüft die meisten Aktionen, anstatt Sie zu fragen. Siehe [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), um zu erfahren, was er überprüft und blockiert.113 * **Auto**: Ein Klassifizierer überprüft die meisten Aktionen, anstatt Sie zu fragen. Siehe [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), um zu erfahren, was er überprüft und blockiert.

114 * **Manuell**: Claude fragt vor Dateibearbeitungen und den meisten Shell-Befehlen um Genehmigung.114 * **Manuell**: Claude fragt vor Dateibearbeitungen und den meisten Shell-Befehlen um Genehmigung.

115 * **Plan**: Claude beschreibt, was es tun wird, und wartet auf Genehmigung, bevor Änderungen vorgenommen werden. VS Code öffnet den Plan automatisch als vollständiges Markdown-Dokument, in dem Sie Inline-Kommentare hinzufügen können, um Feedback zu geben, bevor Claude beginnt.115 * **Plan**: Claude beschreibt, was es tun wird, und wartet auf Genehmigung, bevor Änderungen vorgenommen werden. VS Code öffnet den Plan automatisch als vollständiges Markdown-Dokument, in dem Sie Inline-Kommentare hinzufügen können, um Feedback zu geben, bevor Claude beginnt.

123* **Modell**: Wählen Sie **Modell wechseln…** aus dem Befehlsmenü, um das Modell während einer Sitzung zu ändern. Sie können auch auf den Modellnamen am unteren Rand des Eingabefelds klicken, um die gleiche Auswahl zu öffnen.123* **Modell**: Wählen Sie **Modell wechseln…** aus dem Befehlsmenü, um das Modell während einer Sitzung zu ändern. Sie können auch auf den Modellnamen am unteren Rand des Eingabefelds klicken, um die gleiche Auswahl zu öffnen.

124 124

125 Wenn das aktuelle Modell [Anstrengungsstufen](/docs/de/model-config#adjust-effort-level) unterstützt, zeigt die Auswahl auch eine Zeile **Anstrengung** und die Schaltfläche für den Modellnamen zeigt die ausgewählte Stufe. Wenn Sie eine andere Stufe als `max` wählen, speichert Claude Code sie für das aktuelle Modell als Standard unter [`modelSettings`](/docs/de/settings-reference#modelsettings) in Ihren Benutzereinstellungen; `max` gilt nur für die aktuelle Sitzung. Die Schaltfläche für den Modellnamen und die Zeile **Anstrengung** erfordern Claude Code v2.1.257 oder später.125 Wenn das aktuelle Modell [Anstrengungsstufen](/docs/de/model-config#adjust-effort-level) unterstützt, zeigt die Auswahl auch eine Zeile **Anstrengung** und die Schaltfläche für den Modellnamen zeigt die ausgewählte Stufe. Wenn Sie eine andere Stufe als `max` wählen, speichert Claude Code sie für das aktuelle Modell als Standard unter [`modelSettings`](/docs/de/settings-reference#modelsettings) in Ihren Benutzereinstellungen; `max` gilt nur für die aktuelle Sitzung. Die Schaltfläche für den Modellnamen und die Zeile **Anstrengung** erfordern Claude Code v2.1.257 oder später.

126

127 Wenn [dynamische Workflows](/docs/de/workflows) aktiviert sind und das aktuelle Modell dies unterstützt, wird ein **Ultracode**-Schalter unter der Zeile **Anstrengung** angezeigt. Schalten Sie ihn ein, damit Claude für jede wesentliche Aufgabe in dieser Sitzung einen [Workflow](/docs/de/workflows#let-claude-decide-with-ultracode) auf der ausgewählten Anstrengungsstufe plant. Während er aktiviert ist, zeigt die Schaltfläche für den Modellnamen `· Ultracode` nach der Stufe. Der Schalter erfordert Claude Code v2.1.284 oder später.

126* **Befehlsmenü**: Klicken Sie auf `/` oder geben Sie `/` ein, um das Befehlsmenü zu öffnen. Die Optionen umfassen das Anhängen von Dateien, das Wechseln von Modellen und das Umschalten des erweiterten Denkens.128* **Befehlsmenü**: Klicken Sie auf `/` oder geben Sie `/` ein, um das Befehlsmenü zu öffnen. Die Optionen umfassen das Anhängen von Dateien, das Wechseln von Modellen und das Umschalten des erweiterten Denkens.

127 129

128 Der Abschnitt „Anpassen" bietet Zugriff auf MCP-Server, Befehle, Ausgabestile, Hooks, Speicher, Anweisungen, Berechtigungen und Plugins. Elemente mit einem Terminal-Symbol öffnen sich im integrierten Terminal.130 Der Abschnitt „Anpassen" bietet Zugriff auf MCP-Server, Befehle, Ausgabestile, Hooks, Speicher, Anweisungen, Berechtigungen und Plugins. Elemente mit einem Terminal-Symbol öffnen sich im integrierten Terminal.

150 152

151 Claudes neueste To-Do-Liste bleibt sichtbar, ebenso wie der Text einer ausstehenden Frage von Claude; dies erfordert Claude Code v2.1.225 oder später. Während Claude [Subagenten](/docs/de/sub-agents) ausführt, erscheinen Live-Fortschrittszeilen mit ihrer neuesten Aktivität unter der Werkzeugaufrufsgruppe, die sie gestartet hat. Dies erfordert Claude Code v2.1.269 oder später.153 Claudes neueste To-Do-Liste bleibt sichtbar, ebenso wie der Text einer ausstehenden Frage von Claude; dies erfordert Claude Code v2.1.225 oder später. Während Claude [Subagenten](/docs/de/sub-agents) ausführt, erscheinen Live-Fortschrittszeilen mit ihrer neuesten Aktivität unter der Werkzeugaufrufsgruppe, die sie gestartet hat. Dies erfordert Claude Code v2.1.269 oder später.

152 * Um sich von Ihrem Anthropic-Konto abzumelden, wählen Sie **Sign out** im Abschnitt „Einstellungen", oder geben Sie `/logout` ein. Bei einem [Drittanbieter](#use-third-party-providers) bietet das Menü keines von beiden. Erfordert Claude Code v2.1.277 oder später.154 * Um sich von Ihrem Anthropic-Konto abzumelden, wählen Sie **Sign out** im Abschnitt „Einstellungen", oder geben Sie `/logout` ein. Bei einem [Drittanbieter](#use-third-party-providers) bietet das Menü keines von beiden. Erfordert Claude Code v2.1.277 oder später.

153 * Um einen Fehler zu melden, klicken Sie auf **Report a problem** am unteren Rand des Menüs, oder geben Sie `/bug` oder `/feedback` mit einer optionalen Beschreibung ein, die den Bericht ausfüllt. Wenn Sie den Bericht einreichen und Sie bei Anthropic auf einer First-Party-Verbindung angemeldet sind, sendet Claude Code ihn an Anthropic. Bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten öffnet sich der Dialog trotzdem, aber das Einreichen zeigt einen Fehler und sendet nichts: Im Gegensatz zum CLI `/bug` schreibt die Erweiterung kein lokales Archiv. Erfordert Claude Code v2.1.229 oder später.155 * Um einen Fehler zu melden, klicken Sie auf **Report a problem** am unteren Rand des Menüs, oder geben Sie `/bug` oder `/feedback` mit einer optionalen Beschreibung ein, die den Bericht ausfüllt. Wenn Sie den Bericht einreichen und Sie bei Anthropic auf einer First-Party-Verbindung angemeldet sind, sendet Claude Code ihn an Anthropic. Erfordert Claude Code v2.1.229 oder später.

156

157 Bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten wird nichts gesendet. Der Dialog sagt dies, bevor Sie schreiben. Das Einreichen speichert den Bericht als [lokales Archiv unter `~/.claude/feedback-bundles/`](/docs/de/data-usage#telemetry-services) mit bekannten API-Schlüssel- und Token-Mustern redigiert. Senden Sie diese Datei an Ihren Anthropic-Kontorepräsentanten oder fügen Sie sie an eine Support-Anfrage an. Die Bestätigung nennt die Datei und enthält eine Schaltfläche **Show folder**. Das Speichern des Berichts auf Ihrem Computer erfordert Claude Code v2.1.284 oder später.

154 158

155 Wenn die Richtlinie Ihrer Organisation Produktfeedback deaktiviert, wird **Report a problem** nicht im Menü angezeigt, und `/bug` und `/feedback` zeigen stattdessen eine `Feedback is turned off by your organization's policy or this environment's settings.` Benachrichtigung an.159 Wenn die Richtlinie Ihrer Organisation Produktfeedback deaktiviert, wird **Report a problem** nicht im Menü angezeigt, und `/bug` und `/feedback` zeigen stattdessen eine `Feedback is turned off by your organization's policy or this environment's settings.` Benachrichtigung an. Mit Claude Code v2.1.284 oder später wird Feedback auch ausgeschaltet, wenn Sie die Umgebungsvariable `DISABLE_FEEDBACK_COMMAND` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` setzen, und das Öffnen des Berichts zeigt diese Benachrichtigung statt.

156* **Nebenfragen**: Geben Sie `/btw` gefolgt von einer Frage ein, um eine Frage zu Ihrer Sitzung zu stellen, [ohne sie zum Gespräch hinzuzufügen](/docs/de/interactive-mode#side-questions-with-%2Fbtw). Die Antwort öffnet sich in einem Panel neben dem Chat, in dem Sie Anschlussfragen stellen können. Der Thread bleibt bei Fenster-Neuladen erhalten. Claude Code behält die neuesten 20 Austausche und läuft gespeicherte Threads nach dem [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays)-Plan ab, solange Claude Code [sicher die Aufbewahrungsfrist bestimmen kann](/docs/de/claude-directory#cleaned-up-automatically). Um einen Thread zu löschen, klicken Sie auf das Papierkorbsymbol im Panel. Erfordert Claude Code v2.1.227 oder später.160* **Nebenfragen**: Geben Sie `/btw` gefolgt von einer Frage ein, um eine Frage zu Ihrer Sitzung zu stellen, [ohne sie zum Gespräch hinzuzufügen](/docs/de/interactive-mode#side-questions-with-%2Fbtw). Die Antwort öffnet sich in einem Panel neben dem Chat, in dem Sie Anschlussfragen stellen können. Der Thread bleibt bei Fenster-Neuladen erhalten. Claude Code behält die neuesten 20 Austausche und läuft gespeicherte Threads nach dem [`cleanupPeriodDays`](/docs/de/settings-reference#cleanupperioddays)-Plan ab, solange Claude Code [sicher die Aufbewahrungsfrist bestimmen kann](/docs/de/claude-directory#cleaned-up-automatically). Um einen Thread zu löschen, klicken Sie auf das Papierkorbsymbol im Panel. Erfordert Claude Code v2.1.227 oder später.

157* **Antwort kopieren**: Bewegen Sie den Mauszeiger über eine Antwort und klicken Sie auf **Copy response**, um sie in die Zwischenablage zu kopieren, oder geben Sie `/copy` ein, um die neueste Antwort zu kopieren. `/copy 2` kopiert die vorletzte. Erfordert Claude Code v2.1.277 oder später.161* **Antwort kopieren**: Bewegen Sie den Mauszeiger über eine Antwort und klicken Sie auf **Copy response**, um sie in die Zwischenablage zu kopieren, oder geben Sie `/copy` ein, um die neueste Antwort zu kopieren. `/copy 2` kopiert die vorletzte. Erfordert Claude Code v2.1.277 oder später.

158* **Kontextindikator**: Das Eingabefeld zeigt, wie viel von Claudes Kontextfenster Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können `/compact` manuell ausführen.162* **Kontextindikator**: Das Eingabefeld zeigt, wie viel von Claudes Kontextfenster Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können `/compact` manuell ausführen.

181What's in @src/components/ (include a trailing slash for folders)185What's in @src/components/ (include a trailing slash for folders)

182```186```

183 187

184Bei großen PDFs können Sie Claude bitten, bestimmte Seiten statt der gesamten Datei zu lesen: eine einzelne Seite, einen Bereich wie Seiten 1-10 oder einen offenen Bereich wie Seite 3 und darüber hinaus.188Bei großen PDFs können Sie Claude bitten, bestimmte Seiten statt der gesamten Datei zu lesen: eine einzelne Seite, einen Bereich wie Seiten 1-10 oder einen offenen Bereich wie Seite 3 und darüber hinaus. Das Lesen bestimmter Seiten erfordert [poppler-utils](/docs/de/tools-reference#read-tool-behavior) auf dem Computer, auf dem Claude Code ausgeführt wird.

185 189

186Wenn Sie Text im Editor auswählen, kann Claude Ihren hervorgehobenen Code automatisch sehen. Die Fußzeile des Eingabefelds zeigt, wie viele Zeilen ausgewählt sind. Drücken Sie `Option+K` (Mac) / `Alt+K` (Windows/Linux), um eine @-Erwähnung mit dem Dateipfad und den Zeilennummern einzufügen (z. B. `@app.ts#5-10`). Klicken Sie auf das **X** auf dem Auswahlindikator, um ihn zu entfernen, damit Claude die Auswahl nicht erhält. Der Indikator erscheint wieder, wenn Sie anderen Text auswählen.190Wenn Sie Text im Editor auswählen, kann Claude Ihren hervorgehobenen Code automatisch sehen. Die Fußzeile des Eingabefelds zeigt, wie viele Zeilen ausgewählt sind. Drücken Sie `Option+K` (Mac) / `Alt+K` (Windows/Linux), um eine @-Erwähnung mit dem Dateipfad und den Zeilennummern einzufügen (z. B. `@app.ts#5-10`). Klicken Sie auf das **X** auf dem Auswahlindikator, um ihn zu entfernen, damit Claude die Auswahl nicht erhält. Der Indikator erscheint wieder, wenn Sie anderen Text auswählen.

187 191

233Wenn Sie [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) ausführen, können Sie sie direkt in VS Code fortsetzen. Dies erfordert die Anmeldung mit **Claude.ai Subscription**, nicht Anthropic Console.237Wenn Sie [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) ausführen, können Sie sie direkt in VS Code fortsetzen. Dies erfordert die Anmeldung mit **Claude.ai Subscription**, nicht Anthropic Console.

234 238

235<Steps>239<Steps>

236 <Step title="Open session history">240 <Step title="Sitzungsverlauf öffnen">

237 Click the **Session history** button at the top of the Claude Code panel.241 Klicken Sie auf die Schaltfläche **Session history** oben im Claude Code-Panel.

238 </Step>242 </Step>

239 243

240 <Step title="Select the Web tab">244 <Step title="Wählen Sie die Registerkarte „Web"">

241 The dialog shows two tabs: Local and Web. Click **Web** to see sessions from claude.ai.245 Der Dialog zeigt zwei Registerkarten: Local und Web. Klicken Sie auf **Web**, um Sitzungen von claude.ai anzuzeigen.

242 </Step>246 </Step>

243 247

244 <Step title="Select a session to resume">248 <Step title="Wählen Sie eine Sitzung zum Fortsetzen">

245 Browse or search your cloud sessions. Click any session to download it and continue the conversation locally.249 Durchsuchen oder suchen Sie die Sitzungen. Klicken Sie auf eine, um das Gespräch lokal fortzusetzen.

246 </Step>250 </Step>

247</Steps>251</Steps>

248 252

249<Note>253<Note>

250 Only cloud sessions started with a GitHub repository appear in the Web tab. Resuming loads the conversation history locally; changes are not synced back to claude.ai.254 Wenn der Ordner, den Sie geöffnet haben, ein GitHub-Repository ist, zeigt die Registerkarte „Web" nur Sitzungen aus diesem Repository.

255

256 Wenn Sie eine Cloud-Sitzung fortsetzen, lädt die Erweiterung eine Kopie des Gesprächsverlaufs herunter; Änderungen werden nicht mit claude.ai synchronisiert.

251</Note>257</Note>

252 258

259Die Registerkarte „Web" listet auch Ihre [Remote Control](/docs/de/remote-control)-Sitzungen auf. Wenn Sie auf eine klicken, die im Ordner ausgeführt wurde, den Sie geöffnet haben, öffnet die Erweiterung stattdessen dieses lokale Gespräch und konzentriert sich auf die Registerkarte, die es bereits anzeigt, falls vorhanden. Wenn die Erweiterung nicht ausschließen kann, dass ein anderer Claude-Prozess das Gespräch geöffnet hat, erhalten Sie stattdessen eine heruntergeladene Kopie.

260

261Wenn ein Teil eines Gesprächs nicht heruntergeladen werden kann, wird ein Fehler angezeigt und keine Kopie gespeichert. Wählen Sie die Sitzung erneut aus, um es erneut zu versuchen. Wenn Sie eine Sitzung auswählen, die noch kein Gespräch zum Herunterladen hat, teilt Ihnen ein Fehler mit, wo Sie es stattdessen fortsetzen können.

262

253<h3 id="check-account-and-usage">263<h3 id="check-account-and-usage">

254 Konto und Nutzung überprüfen264 Konto und Nutzung überprüfen

255</h3>265</h3>

269 Passen Sie Ihren Arbeitsablauf an279 Passen Sie Ihren Arbeitsablauf an

270</h2>280</h2>

271 281

272Sie können das Claude-Panel neu positionieren, mehrere Gespräche führen, die Sitzungsliste in Gruppen organisieren oder in den Terminalmodus wechseln.282Sie können das Claude-Panel neu positionieren, mehrere Gespräche führen, die Sitzungsliste in Gruppen organisieren oder filtern, oder in den Terminalmodus wechseln.

273 283

274<h3 id="choose-where-claude-lives">284<h3 id="choose-where-claude-lives">

275 Wählen Sie, wo Claude sich befindet285 Wählen Sie, wo Claude sich befindet

319 329

320Die Erweiterung speichert Gruppen pro Arbeitsbereichsordner, sodass sie Fenster-Neuladen überstehen und in jedem Fenster angezeigt werden, in dem Sie denselben Ordner öffnen. Wenn Sie die Liste durchsuchen, zeigt die Erweiterung Übereinstimmungen in einer flachen Liste über alle Gruppen hinweg an.330Die Erweiterung speichert Gruppen pro Arbeitsbereichsordner, sodass sie Fenster-Neuladen überstehen und in jedem Fenster angezeigt werden, in dem Sie denselben Ordner öffnen. Wenn Sie die Liste durchsuchen, zeigt die Erweiterung Übereinstimmungen in einer flachen Liste über alle Gruppen hinweg an.

321 331

332<h3 id="filter-the-sessions-list">

333 Filtern Sie die Sitzungsliste

334</h3>

335

336Um eine lange Sitzungsliste in der Aktivitätsleiste zu verkürzen, verwenden Sie die zwei Filtersteuerelemente oben in der Liste. Erfordert Claude Code v2.1.271 oder später. Archivierte Sitzungen werden nicht angezeigt, während einer der Filter aktiviert ist.

337

338* **Aktiv**: Aktivieren Sie diesen Schalter, um nur Sitzungen anzuzeigen, die Ihre Eingabe benötigen, arbeiten oder ungelesen sind, sowie die Sitzung in der Claude-Registerkarte, auf die Sie zuletzt fokussiert haben.

339* **Nach Status filtern**: Klicken Sie auf das Trichtersymbol, und aktivieren Sie dann **Eingabe erforderlich**, **Arbeitet** oder **Abgeschlossen**, um Sitzungen in einem dieser Zustände anzuzeigen. Aktivieren Sie **Offen** oder **Geschlossen**, um nach zu filtern, ob eine Sitzung offen ist. Eine Sitzung zählt als offen, wenn sie eine Registerkarte in diesem Fenster hat oder in einem anderen Claude Code-Prozess auf diesem Computer ausgeführt wird, z. B. in einem Terminal.

340

341Wenn **Aktiv** aktiviert ist und Sie einen Status, **Offen** oder **Geschlossen** aktivieren, zeigt die Liste auch jede Sitzung an, die Ihren Überprüfungen entspricht. Die von Ihnen festgelegten Filter bleiben über Fenster-Neuladen hinweg erhalten.

342

322<h3 id="switch-to-terminal-mode">343<h3 id="switch-to-terminal-mode">

323 Wechseln Sie zum Terminalmodus344 Wechseln Sie zum Terminalmodus

324</h3>345</h3>

506Die Erweiterung hat zwei Arten von Einstellungen:527Die Erweiterung hat zwei Arten von Einstellungen:

507 528

508* **Erweiterungseinstellungen** in VS Code: steuern das Verhalten der Erweiterung in VS Code. Öffnen Sie sie mit `Cmd+,` (Mac) oder `Strg+,` (Windows/Linux), gehen Sie dann zu Erweiterungen → Claude Code. Sie können auch `/` eingeben und **General config…** auswählen, um die Einstellungen zu öffnen.529* **Erweiterungseinstellungen** in VS Code: steuern das Verhalten der Erweiterung in VS Code. Öffnen Sie sie mit `Cmd+,` (Mac) oder `Strg+,` (Windows/Linux), gehen Sie dann zu Erweiterungen → Claude Code. Sie können auch `/` eingeben und **General config…** auswählen, um die Einstellungen zu öffnen.

509* **Claude Code-Einstellungen** in `~/.claude/settings.json`: werden zwischen der Erweiterung und der CLI gemeinsam genutzt. Verwenden Sie diese für zulässige Befehle, Umgebungsvariablen, Hooks und MCP-Server. In Pro-, Max- und Team-Plänen ist dies auch eine Eingabe für den Berechtigungsmodus, in dem Gespräche beginnen. [Berechtigungsmodi wechseln](/docs/de/permission-modes#switch-permission-modes) listet die Reihenfolge auf. Weitere Informationen finden Sie unter [Einstellungen](/docs/de/settings).530* **Claude Code-Einstellungen** in `~/.claude/settings.json`: werden zwischen der Erweiterung und der CLI gemeinsam genutzt. Verwenden Sie diese für zulässige Befehle, Umgebungsvariablen, Hooks und MCP-Server. Mit Claude Code v2.1.283 oder später ist dies auch eine Eingabe für den Berechtigungsmodus, in dem Gespräche beginnen, und in früheren Versionen nur in Pro-, Max- und Team-Plänen. [Berechtigungsmodi wechseln](/docs/de/permission-modes#switch-permission-modes) listet die Reihenfolge auf. Weitere Informationen finden Sie unter [Einstellungen](/docs/de/settings).

510 531

511<Tip>532<Tip>

512 Fügen Sie `"$schema": "https://json.schemastore.org/claude-code-settings.json"` zu Ihrer `settings.json` hinzu, um Autovervollständigung und Inline-Validierung für alle verfügbaren Einstellungen direkt in VS Code zu erhalten.533 Fügen Sie `"$schema": "https://json.schemastore.org/claude-code-settings.json"` zu Ihrer `settings.json` hinzu, um Autovervollständigung und Inline-Validierung für alle verfügbaren Einstellungen direkt in VS Code zu erhalten.

722 743

723**Auswahl und Kontext offener Dateien.** Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine `⧉ Selected N lines from <file>`-Zeile, wenn dies geschieht.744**Auswahl und Kontext offener Dateien.** Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine `⧉ Selected N lines from <file>`-Zeile, wenn dies geschieht.

724 745

746Wenn Sie [eine Nachricht in die Warteschlange einreihen, während Claude arbeitet](/docs/de/interactive-mode#queue-messages-while-claude-works), behält es die Auswahl, die Sie beim Drücken von `Enter` hatten, unabhängig davon, was Sie danach auswählen.

747

725Um eine vertrauliche Datei wie `.env` auszuschließen, fügen Sie eine [`Read`-Ablehnungsregel](/docs/de/permissions#read-and-edit) für ihren Pfad hinzu. Eine entsprechende Ablehnungsregel verhindert, dass sowohl der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.748Um eine vertrauliche Datei wie `.env` auszuschließen, fügen Sie eine [`Read`-Ablehnungsregel](/docs/de/permissions#read-and-edit) für ihren Pfad hinzu. Eine entsprechende Ablehnungsregel verhindert, dass sowohl der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.

726 749

727Wenn Sie die [Einstellung „Attach Open File"](#extension-settings) deaktivieren, erhält die CLI den Pfad der aktiven Datei nur, wenn Sie darin Text ausgewählt haben.750Wenn Sie die [Einstellung „Attach Open File"](#extension-settings) deaktivieren, erhält die CLI den Pfad der aktiven Datei nur, wenn Sie darin Text ausgewählt haben.

web-quickstart.md +3 −3

Details

231 231

232Cloud-Sitzungen erfordern ein verbundenes GitHub-Konto. Verbinden Sie sich über den oben beschriebenen Browser-Flow oder führen Sie `/web-setup` von Ihrem Terminal aus aus, wenn Sie die GitHub CLI verwenden. Wenn Sie GitHub lieber gar nicht verbinden möchten, siehe [Remote Control](/docs/de/remote-control), um Claude Code auf Ihrem eigenen Computer auszuführen und es vom Browser oder Telefon aus zu überwachen.232Cloud-Sitzungen erfordern ein verbundenes GitHub-Konto. Verbinden Sie sich über den oben beschriebenen Browser-Flow oder führen Sie `/web-setup` von Ihrem Terminal aus aus, wenn Sie die GitHub CLI verwenden. Wenn Sie GitHub lieber gar nicht verbinden möchten, siehe [Remote Control](/docs/de/remote-control), um Claude Code auf Ihrem eigenen Computer auszuführen und es vom Browser oder Telefon aus zu überwachen.

233 233

234<h3 id="not-available-for-the-selected-organization">234<h3 id="claude-code-isn’t-available-on-your-account">

235 „Nicht verfügbar für die ausgewählte Organisation"235 „Claude Code ist auf Ihrem Konto nicht verfügbar"

236</h3>236</h3>

237 237

238Enterprise-Organisationen müssen möglicherweise von einem Owner Cloud-Sitzungen aktivieren lassen. Kontaktieren Sie Ihr Anthropic-Account-Team.238Ihr Platz in der ausgewählten Organisation beinhaltet nicht Claude Code. Wenn Sie einer anderen Organisation angehören, klicken Sie auf dieser Seite auf **Organisation wechseln**. Andernfalls bitten Sie einen Owner der Organisation, Ihnen einen [Platz zuzuweisen, der Claude Code einschließt](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).

239 239

240<h3 id="/web-setup-says-not-signed-in-to-claude">240<h3 id="/web-setup-says-not-signed-in-to-claude">

241 `/web-setup` sagt „Nicht angemeldet bei Claude"241 `/web-setup` sagt „Nicht angemeldet bei Claude"

whats-new/2026-w29.md +1 −1

Details

59 <div>Neuer <code>claude auto-mode reset</code> stellt die Standard-Auto-Modus-Konfiguration wieder her, und `--yes` überspringt die Bestätigungsaufforderung</div>59 <div>Neuer <code>claude auto-mode reset</code> stellt die Standard-Auto-Modus-Konfiguration wieder her, und `--yes` überspringt die Bestätigungsaufforderung</div>

60 <div>Neue <a href="/docs/de/corporate-launcher">Corporate Launcher</a> Unterstützung: <code>CLAUDE\_CODE\_PROCESS\_WRAPPER</code> oder die Einstellung <code>processWrapper</code> führt die Prozesse, die Claude Code von seiner eigenen Binärdatei aus startet, wie den Hintergrund-Service und Agent-View-Sitzungen, durch eine erforderliche Wrapper-Ausführungsdatei aus</div>60 <div>Neue <a href="/docs/de/corporate-launcher">Corporate Launcher</a> Unterstützung: <code>CLAUDE\_CODE\_PROCESS\_WRAPPER</code> oder die Einstellung <code>processWrapper</code> führt die Prozesse, die Claude Code von seiner eigenen Binärdatei aus startet, wie den Hintergrund-Service und Agent-View-Sitzungen, durch eine erforderliche Wrapper-Ausführungsdatei aus</div>

61 <div><code>vimInsertModeRemaps</code> Einstellung ordnet zwei-Tasten-Insert-Modus-Sequenzen wie <code>jj</code> zu Escape im Vim-Modus zu</div>61 <div><code>vimInsertModeRemaps</code> Einstellung ordnet zwei-Tasten-Insert-Modus-Sequenzen wie <code>jj</code> zu Escape im Vim-Modus zu</div>

62 <div>`--forward-subagent-text` und <code>CLAUDE\_CODE\_FORWARD\_SUBAGENT\_TEXT</code> enthalten Subagent-Text und Thinking-Blöcke in <a href="/docs/de/headless#stream-json-output">stream-json-Ausgabe</a></div>62 <div>`--forward-subagent-text` und <code>CLAUDE\_CODE\_FORWARD\_SUBAGENT\_TEXT</code> enthalten Subagent-Text und Thinking-Blöcke in <a href="/docs/de/headless">stream-json-Ausgabe</a></div>

63 <div>Sitzungsweite Obergrenzen stoppen Endlosschleifen: WebSearch-Aufrufe und Subagent-Spawns haben jeweils einen Standard von 200, anpassbar mit <code>CLAUDE\_CODE\_MAX\_WEB\_SEARCHES\_PER\_SESSION</code> und <code>CLAUDE\_CODE\_MAX\_SUBAGENTS\_PER\_SESSION</code></div>63 <div>Sitzungsweite Obergrenzen stoppen Endlosschleifen: WebSearch-Aufrufe und Subagent-Spawns haben jeweils einen Standard von 200, anpassbar mit <code>CLAUDE\_CODE\_MAX\_WEB\_SEARCHES\_PER\_SESSION</code> und <code>CLAUDE\_CODE\_MAX\_SUBAGENTS\_PER\_SESSION</code></div>

64 <div>„Immer zulassen" Berechtigungsregeln werden im Repository-Root gespeichert, sodass Genehmigungen, die in einem Git-Worktree gewährt werden, über Sitzungen und Worktrees hinweg bestehen bleiben</div>64 <div>„Immer zulassen" Berechtigungsregeln werden im Repository-Root gespeichert, sodass Genehmigungen, die in einem Git-Worktree gewährt werden, über Sitzungen und Worktrees hinweg bestehen bleiben</div>

65 <div>Amazon Bedrock, Google Clouds Agent Platform und Claude Platform auf AWS verwenden jetzt standardmäßig Claude Opus 4.8</div>65 <div>Amazon Bedrock, Google Clouds Agent Platform und Claude Platform auf AWS verwenden jetzt standardmäßig Claude Opus 4.8</div>

workflows.md +14 −6

Details

161 Lassen Sie Claude mit Ultracode entscheiden161 Lassen Sie Claude mit Ultracode entscheiden

162</h3>162</h3>

163 163

164Ultracode ist eine Claude Code-Einstellung, die `xhigh` [Anstrengungsebene](/docs/de/model-config#adjust-effort-level) mit automatischer Workflow-Orchestrierung kombiniert. Wenn es aktiviert ist, plant Claude einen Workflow für jede wesentliche Aufgabe, anstatt auf Sie zu warten.164Ultracode ist eine Claude Code-Einstellung, die automatische Workflow-Orchestrierung für die Sitzung aktiviert, auf welcher [Anstrengungsebene](/docs/de/model-config#adjust-effort-level) auch immer die Sitzung läuft. Wenn es aktiviert ist, plant Claude einen Workflow für jede wesentliche Aufgabe, anstatt auf Sie zu warten. Aktivieren Sie es an der Claude Code-Eingabeaufforderung:

165 165

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

167/effort ultracode167/effort ultracode

168```168```

169 169

170Um eine Sitzung mit bereits aktiviertem Ultracode zu starten, starten Sie mit `claude --effort ultracode`. Erfordert Claude Code v2.1.203 oder später.170Um eine Sitzung mit bereits aktiviertem Ultracode zu starten, starten Sie mit `claude --effort ultracode`, was auch die Anstrengungsebene auf `xhigh` setzt. Erfordert Claude Code v2.1.203 oder später.

171 171

172Um es zu aktivieren, während Sie ein Modell auswählen, verschieben Sie den Anstrengungsregler des `/model`-Pickers mit den Pfeiltasten auf `ultracode`. [Anstrengungsebene anpassen](/docs/de/model-config#adjust-effort-level) listet die Routen auf, die Ultracode aktivieren.172Um es vom `/effort`-Schieberegler aus zu aktivieren, drücken Sie `Tab`, um den **Ultracode**-Schalter umzuschalten, und dann `Enter`, um es anzuwenden. [Anstrengungsebene anpassen](/docs/de/model-config#adjust-effort-level) listet die Routen auf, die Ultracode aktivieren.

173 173

174Mit Ultracode aktiviert entscheidet Claude, wann eine Aufgabe einen Workflow rechtfertigt. Eine einzelne Anfrage kann sich in mehrere Workflows hintereinander verwandeln: einen zum Verstehen des Codes, einen zum Vornehmen der Änderung und einen zum Überprüfen. Dies gilt für jede Aufgabe in der Sitzung, sodass jede Anfrage mehr Token verwendet und länger dauert als bei niedrigeren Anstrengungsebenen.174Mit aktiviertem Ultracode entscheidet Claude, wann eine Aufgabe einen Workflow rechtfertigt. Eine einzelne Anfrage kann sich in mehrere Workflows hintereinander verwandeln: einen zum Verstehen des Codes, einen zum Vornehmen der Änderung und einen zum Überprüfen. Dies gilt für jede Aufgabe in der Sitzung, sodass jede Anfrage mehr Token verwendet und länger dauert als die gleiche Anfrage ohne einen Workflow. Bei einem Abonnementplan werden diese Token auf Ihre Nutzungsgrenzen angerechnet, sodass eine Sitzung mit aktiviertem Ultracode eine Sitzungs- oder Wochengrenze schneller erreicht als die gleiche Arbeit mit deaktiviertem Ultracode.

175 175

176`/effort ultracode` dauert für die aktuelle Sitzung; um jede Sitzung damit zu starten, setzen Sie die [`ultracode`](/docs/de/settings-reference#ultracode)-Einstellung. Gehen Sie mit `/effort high` zurück, wenn Sie zur Routinearbeit zurückkehren. Das `/effort`-Menü bietet es nur [wenn Ultracode verfügbar ist](/docs/de/model-config#when-ultracode-is-available).176Das Aktivieren von Ultracode bedeutet bereits, dass Sie sich für große Ausführungen anmelden, daher gelten diese Prüfungen nicht, während es aktiviert ist:

177

178* Die [`Large workflow`-Warnung](#cost) wird bei einer Workflow-Ausführung nicht angezeigt

179* Das [gleichzeitige Subagenten-Limit](/docs/de/sub-agents#concurrent-subagent-limit) der Sitzung wird nicht für die Subagenten erzwungen, die Claude mit dem Agent-Tool spawnt

180* Im automatischen Berechtigungsmodus werden Sie nicht aufgefordert, [den ersten Workflow-Start zu genehmigen](#approve-the-plan-before-it-runs)

181

182`/effort ultracode` dauert für die aktuelle Sitzung; um jede Sitzung damit zu starten, setzen Sie die [`ultracode`](/docs/de/settings-reference#ultracode)-Einstellung. Gehen Sie mit `/effort ultracode off` zurück, wenn Sie zur Routinearbeit zurückkehren. Der `/effort`-Schieberegler bietet den Schalter nur [wenn Ultracode verfügbar ist](/docs/de/model-config#when-ultracode-is-available).

177 183

178<h3 id="approve-the-plan-before-it-runs">184<h3 id="approve-the-plan-before-it-runs">

179 Genehmigen Sie den Plan, bevor er ausgeführt wird185 Genehmigen Sie den Plan, bevor er ausgeführt wird

516 522

517Um Workflows für Ihre gesamte Organisation auszuschalten, setzen Sie `"disableWorkflows": true` in [verwalteten Einstellungen](/docs/de/server-managed-settings) oder verwenden Sie den Umschalter auf der Seite [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code).523Um Workflows für Ihre gesamte Organisation auszuschalten, setzen Sie `"disableWorkflows": true` in [verwalteten Einstellungen](/docs/de/server-managed-settings) oder verwenden Sie den Umschalter auf der Seite [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code).

518 524

519Wenn Workflows deaktiviert sind, sind die gebündelten Workflow-Befehle und die `/workflow-authoring`-Fähigkeit nicht verfügbar, das Schlüsselwort `ultracode` löst keine Ausführung mehr aus, und `ultracode` wird aus dem `/effort`-Menü entfernt.525Wenn Workflows deaktiviert sind, sind die gebündelten Workflow-Befehle und die `/workflow-authoring`-Fähigkeit nicht verfügbar, das Schlüsselwort `ultracode` löst keine Ausführung mehr aus, und die **Ultracode**-Umschaltfläche wird aus `/effort` entfernt. Eine Ausführung, die bereits in Bearbeitung ist, wird fortgesetzt.

526

527Das Ausschalten von Workflows macht auch [ultracode](#let-claude-decide-with-ultracode) nicht verfügbar. Keine verwaltete Einstellung schließt ultracode allein aus: Überall dort, wo es [verfügbar](/docs/de/model-config#when-ultracode-is-available) ist, können Benutzer es mit `/effort ultracode` aktivieren. Eine [Effort-Obergrenze](/docs/de/model-config#organization-effort-limits) senkt die Effort-Stufe, auf der eine Sitzung mit aktiviertem ultracode läuft, schaltet aber ultracode nicht aus.

520 528

521<h2 id="related-resources">529<h2 id="related-resources">

522 Verwandte Ressourcen530 Verwandte Ressourcen

worktrees.md +8 −8

Details

56</Note>56</Note>

57 57

58<h2 id="clean-up-worktrees">58<h2 id="clean-up-worktrees">

~~59 Bereinigen Sie Worktrees~~59 Worktrees bereinigen

60</h2>60</h2>

61 61

62Wenn Sie eine interaktive Worktree-Sitzung beenden, prüft Claude den Worktree auf Arbeit, die durch das Entfernen gelöscht würde: geänderte oder nicht verfolgte Dateien, nicht committete Arbeit in ausgecheckten Submodulen und neue Commits.62Wenn Sie eine interaktive Worktree-Sitzung beenden, prüft Claude den Worktree auf Arbeiten, deren Entfernung gelöscht würde: geänderte oder nicht verfolgte Dateien, nicht committete Arbeiten in ausgecheckten Submodulen und neue Commits. Diese Regeln gelten für Worktrees, die Claude mit git erstellt hat. Für einen Worktree, den Ihr [WorktreeCreate Hook](/docs/de/hooks#worktreecreate) erstellt hat, siehe stattdessen [WorktreeRemove](/docs/de/hooks#worktreeremove).

63 63

64* **Der Worktree ist sauber**: Für eine unbenannte Sitzung entfernt Claude den Worktree und seinen Branch automatisch. Eine [benannte](/docs/de/sessions#name-your-sessions) Sitzung fordert Sie zunächst auf, damit Sie den Worktree später behalten können64* **Der Worktree ist sauber**: Bei einer unbenannten Sitzung entfernt Claude den Worktree und seinen Branch automatisch. Eine [benannte](/docs/de/sessions#name-your-sessions) Sitzung fragt Sie zuerst, damit Sie den Worktree später behalten können

65* **Der Worktree enthält Arbeit**: Claude fordert Sie auf, den Worktree zu behalten oder zu entfernen. Das Behalten bewahrt das Verzeichnis und den Branch, sodass Sie später zurückkehren können. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch zusammen mit der gesamten Arbeit darin65* **Der Worktree enthält Arbeiten**: Claude fragt Sie, ob Sie den Worktree behalten oder entfernen möchten. Das Behalten bewahrt das Verzeichnis und den Branch. Um später zurückzukehren, führen Sie den Befehl `claude --worktree <name> --resume` aus, den Claude Code beim Beenden ausgibt. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch zusammen mit allen darin enthaltenen Arbeiten

66* **Der Zustand des Worktrees kann nicht überprüft werden**: Wenn Claude Code die Änderungen des Worktrees nicht zählen kann oder seine Submodul-Checkouts nicht überprüfen kann, fordert es Sie auf, anstatt den Worktree automatisch zu entfernen. Die Aufforderung benennt, was nicht überprüft werden konnte66* **Der Zustand des Worktree kann nicht überprüft werden**: Wenn Claude Code die Änderungen des Worktree nicht zählen kann oder seine Submodul-Checkouts nicht überprüfen kann, fragt es Sie, anstatt den Worktree automatisch zu entfernen. Die Eingabeaufforderung benennt, was nicht überprüft werden konnte

67 67

68Nicht-interaktive Ausführungen mit `-p` haben keine Exit-Aufforderung, sodass Claude ihre Worktrees nicht bereinigt, und Claude Code hinterlässt die Sperre, die es bei der Erstellung auf jedem genommen hat, bis eine spätere Sitzung [stale-lock sweep](#clean-up-subagent-and-background-session-worktrees) sie freigeben kann. Um einen zu entfernen, führen Sie `git worktree remove` aus; wenn Git sich weigert, weil der Worktree gesperrt ist, führen Sie zuerst `git worktree unlock` darauf aus.68Nicht-interaktive Ausführungen mit `-p` haben keine Exit-Eingabeaufforderung, daher bereinigt Claude ihre Worktrees nicht, und Claude Code behält die Sperre, die es bei der Erstellung auf jedem einzelnen genommen hat, bis eine spätere Sitzung's [stale-lock sweep](#clean-up-subagent-and-background-session-worktrees) sie freigegeben hat. Um einen zu entfernen, führen Sie `git worktree remove` aus; wenn git sich weigert, weil der Worktree gesperrt ist, führen Sie zuerst `git worktree unlock` darauf aus.

69 69

70Unter Windows löscht das Entfernen eines Worktrees keine Dateien außerhalb davon. Wenn ein Ordner im Worktree ein Link zu anderswo ist, wie eine NTFS-Junction oder ein Verzeichnis-Symlink, löscht Claude Code nur den Link und behält den Ordner, auf den er verweist. Vor v2.1.205 konnte das Entfernen eines Worktrees mit einem Link in einem Unterverzeichnis den Ordner löschen, auf den er verweist.70Unter Windows löscht das Entfernen eines Worktree keine Dateien außerhalb davon. Wenn ein Ordner im Worktree ein Link zu anderswo ist, z. B. eine NTFS-Verknüpfung oder ein Verzeichnis-Symlink, löscht Claude Code nur den Link und behält den Ordner, auf den er verweist. Vor v2.1.205 konnte das Entfernen eines Worktree mit einem Link in einem Unterverzeichnis den Ordner löschen, auf den er verwies.

71 71

72<h2 id="resume-a-worktree-session">72<h2 id="resume-a-worktree-session">

73 Setzen Sie eine Worktree-Sitzung fort73 Setzen Sie eine Worktree-Sitzung fort

74</h2>74</h2>

75 75

76Wenn Sie eine Sitzung fortsetzen, die sich in einem Worktree befand, kehrt Claude Code die Sitzung zu diesem Worktree zurück. Dies gilt für interaktive Fortsetzungen, für `--continue` und `--resume` im [nicht-interaktiven Modus](/docs/de/headless) mit `-p`, und für das Agent SDK. Zurück im Worktree kann Claude ihn immer noch mit dem [`ExitWorktree`](/docs/de/tools-reference)-Tool verlassen.76Wenn Sie eine Sitzung fortsetzen, die sich in einem Worktree befand, ohne [ihn zu beenden](#clean-up-worktrees), kehrt Claude Code die Sitzung zu diesem Worktree zurück. Dies gilt für interaktive Fortsetzungen, für `--continue` und `--resume` im [nicht-interaktiven Modus](/docs/de/headless) mit `-p`, und für das Agent SDK. `--continue` wählt die zuletzt aufgezeichnete Sitzung aus dem Verzeichnis aus, von dem Sie starten. Zurück im Worktree kann Claude ihn immer noch mit dem [`ExitWorktree`](/docs/de/tools-reference)-Tool verlassen.

77 77

78Bevor Claude Code die Sitzung zu ihrem Worktree zurückbringt, überprüft es, dass der Worktree immer noch ein separater Checkout vom Haupt-Checkout ist, und lehnt es ab, einen Worktree erneut zu betreten, der die Prüfung nicht besteht. Für einen Git-Worktree liest die Prüfung seine Git-Metadaten. Ein Worktree ohne Git-Metadaten, wie einer, den ein [`WorktreeCreate`-Hook](#non-git-version-control) erstellt hat, kann die Prüfung bestehen; die Fälle, die Claude Code immer noch ablehnt, sind unter [Claude Code weigert sich, einen Worktree zu verwenden](#claude-code-refuses-to-use-a-worktree) mit ihren Wiederherstellungen aufgelistet. Für die Meldungen und wie Sie sich von jedem erholen, siehe [Die Sitzung wird außerhalb ihres Worktrees fortgesetzt](#the-session-resumes-outside-its-worktree).78Bevor Claude Code die Sitzung zu ihrem Worktree zurückbringt, überprüft es, dass der Worktree immer noch ein separater Checkout vom Haupt-Checkout ist, und lehnt es ab, einen Worktree erneut zu betreten, der die Prüfung nicht besteht. Für einen Git-Worktree liest die Prüfung seine Git-Metadaten. Ein Worktree ohne Git-Metadaten, wie einer, den ein [`WorktreeCreate`-Hook](#non-git-version-control) erstellt hat, kann die Prüfung bestehen; die Fälle, die Claude Code immer noch ablehnt, sind unter [Claude Code weigert sich, einen Worktree zu verwenden](#claude-code-refuses-to-use-a-worktree) mit ihren Wiederherstellungen aufgelistet. Für die Meldungen und wie Sie sich von jedem erholen, siehe [Die Sitzung wird außerhalb ihres Worktrees fortgesetzt](#the-session-resumes-outside-its-worktree).

79 79

Documentation 2026-09-28 22:59 UTC to 2026-09-29 21:59 UTC